ActorAnimation

Search…
ActorAnimation
Accessing Properties of Animations
This is the manual for the old version of Rive (formerly Flare). Visit the Help Center for the new Rive here.
ActorAnimation & Properties
implements ActorAnimation Class
The ActorAnimation is the class that handles a specific animation of a Rive Actor.  You can access different properties of the specified animation to customize your Actor at runtime.
Duration allows you to obtain how long the animation will last, which is returned as a double:
1
getAnimation("name_of_Animation").duration
Copied!
Looping is returned as a boolean to check whether an animation loops:
1
getAnimation("name_of_Animation").isLooping
Copied!
FPS allows you to check an animation's frames per second, which is returned as an integer:
1
getAnimation("name_of_Animation").fps
Copied!
Controller
The Rive Controller is a general-purpose interface for customizing the behavior of an animation at runtime.  By extending the Controller class you can override functions to have more control of the Rive Actor.  This allows you access to things like being notified when an animation is complete, advancing through different states of an animation, etc.  There are three main methods used when setting up a custom controller: initialize, advance and setViewTransform.
Initialize
 The initialize method is called once when the controller is first created. Use it to fetch references to animation components that will be affected by the controller:
1
initialize(artboard)
Copied!
Set View Transform
The setViewTransform method relays the information regarding the global  viewTransform matrix of the Actor that this controller is attached to. This is also called every frame, and relays information regarding the current view matrix of the animation. 
1
setViewTransform(Mat2D viewTransform)
Copied!
Advance
The advance method will advance the animation of the current 'artboard' by elapsed.  It is called every frame.  Every time the artboard advances, it relays the elapsed time to the controller, which can thus perform custom actions. This method's elapsed parameter passes the time passed since the last frame. This must return a boolean.
1
bool advance(artboard, elapsed)
Copied!
Time and Mixing
Animation Time
The current time of an animation can be manipulated at runtime inside of a custom controller.  For example, in the advance method you can achieve different effects (like animating a character to aim its weapon based on a mouse pointer) by dividing the entire length of the animation by another parameter such as elapsed time. 
Flutter Sample
Swift Sample
React Sample
JS Sample
C++ Sample
1
import 'package:flare_flutter/flare_actor.dart';
2
import 'package:flare_flutter/flare_controller.dart';
3
import 'package:flare_flutter/flare.dart';
4
...
5
ActorAnimation _myAnimation;
6
​
7
//modify this to change the fill
8
double _animTime = 0.00;
9
double _currentAnimTime  = 0;
10
​
11
void initialize(FlutterActorArtboard artboard) {
12
    _myAnimation= artboard.getAnimation("animationString");
13
}
14
bool advance(FlutterActorArtboard artboard, double elapsed) {
15
    _currentAnimTime +=
16
          (_animTime - _currentAnimTime) * min(1, elapsed * 5);
17
​
18
      _myAnimation.apply(
19
          _currentAnimTime * _myAnimation.duration, artboard, 1);
20
}
21
...
Copied!
1
 open class CustomController: FlareSkViewController {
2
     open func onCompleted(name: String) {
3
        if(name == "AnimationName"){
4
            //Do Something
5
        }
6
     }
7
     override open func advanceControls(by elapsed: Double) -> Bool {
8
        
9
        guard
10
            let fView = view as? FlareSkView,
11
            let artboard = fView.artboard
12
        else { return false }
13
     
14
         return true;
15
     }
16
     
17
      override open func setViewTransform(viewTransform: Mat2D) {}
18
..
19
}
Copied!
1
 constructor()
2
  {
3
    super();
4
    
5
    this._ActorAnimator = null; 
6
    this._CanPlay = false;
7
    this._AnimTime = 0;
8
  }
9
  initialize(artboard)
10
  {
11
    this._ActorAnimator = this._Artboard.getAnimation("animationString");
12
  }
13
  advance(artboard, elapsed)
14
  {
15
    this._AnimTime += elapsed *1;
16
    
17
    if (this._CanPlay === true)
18
    {
19
       
20
      this._ActorAnimator.apply(this._AnimTime % this._ActorAnimator.duration, artboard, 1);
21
    }
22
  }
Copied!
1
function FlareExample(canvas, ready)
2
	{
3
		this._Graphics = new Flare.Graphics(canvas);
4
		this._Graphics.initialize("../build/", () =>
5
		{
6
			this._LastAdvanceTime = Date.now();
7
			this._ViewTransform = mat2d.create();
8
			 
9
			this._AnimationInstance= null;
10
​
11
			const _This = this;
12
			
13
			_ScheduleAdvance(_This);
14
			_Advance(_This);
15
			
16
			ready();
17
		});
18
	}
19
	function _Advance(_This)
20
	{
21
​
22
		_This.setSize(window.innerWidth, window.innerHeight);
23
​
24
		const now = Date.now();
25
		const elapsed = (now - _This._LastAdvanceTime)/1000.0;
26
		_This._LastAdvanceTime = now;
27
​
28
		const actor = _This._ActorInstance;
29
	    if (_This._AnimationInstance)
30
			{
31
				const ai = _This._AnimationInstance;
32
				ai.time = ai.time + elapsed;
33
​
34
				ai.apply(_This._ActorInstance, 1.0);
35
			}
36
				
37
			
38
		if(actor)
39
		{
40
			const graphics = _This._Graphics;
41
		
42
			const w = graphics.viewportWidth;
43
			const h = graphics.viewportHeight;
44
​
45
			const vt = _This._ViewTransform;
46
			vt[0] = _Scale;
47
			vt[3] = _Scale;
48
			vt[4] = (-_ViewCenter[0] * _Scale + w/2);
49
			vt[5] = (-_ViewCenter[1] * _Scale + h/2);
50
			/** Advance the actor to its new time. */
51
			actor.advance(elapsed);
52
		} 	 
53
		 
54
​
55
		_Draw(_This, _This._Graphics);
56
		/** Schedule a new frame. */
57
		_ScheduleAdvance(_This);
58
	}
Copied!
1
...
2
	flare::ActorAnimation* animation = artboard->animation(animationName);
3
...
4
	
5
	float animationTime = 0.0f;
6
	double time = glfwGetTime();
7
	float elapsed = (float)(time - lastTime);
8
	lastTime = time;
9
​
10
	if (animation != nullptr)
11
	{
12
		animationTime += elapsed;
13
		animation->apply(std::fmod(animationTime, animation->duration()), artboard, 1.0);
14
	}
15
	artboard->advance(elapsed);
16
...	
Copied!
Animation Mixing
This is a blending parameter to allow smoothing between concurrent animations. By setting the mix to 1, the current animation will fully replace the existing values. By ramping up mix with values between 0 and 1, the transition from one animation to the next will be more gradual as it gets mixed in, preventing popping effects.
Flutter Sample
Swift Sample
React Sample
JS Sample
C++ Sample
1
import 'package:flare_flutter/flare_controls.dart';
2
...
3
final FlareControls _flareControls = FlareControls();
4
...
5
{
6
    _flareControls.play("animationString", mix: 0.5, mixSeconds: 1.0);
7
}
Copied!
1
self.flareController!.play(name: "AnimationName", mix: 0.5, mixSeconds: 1.0)
Copied!
1
import FlareComponent from 'flare-react';
2
initialize(artboard)
3
{
4
   this._ActorAnimator = artboard.getAnimation("animation_String");
5
}
6
  
7
advance(artboard, elapsed)
8
{
9
   this._AnimTime += elapsed *1;
10
   this._ActorAnimator.apply(this._AnimTime % this._ActorAnimator.duration, artboard, 1);
11
}
Copied!
1
function FlareExample(canvas, ready)
2
	{
3
		this._Graphics = new Flare.Graphics(canvas);
4
		this._Graphics.initialize("../build/", () =>
5
		{
6
			this._LastAdvanceTime = Date.now();
7
			this._ViewTransform = mat2d.create();
8
			 
9
			this._AnimationInstance= null;
10
​
11
			const _This = this;
12
			
13
			_ScheduleAdvance(_This);
14
			_Advance(_This);
15
			
16
			ready();
17
		});
18
	}
19
	function _Advance(_This)
20
	{
21
​
22
		_This.setSize(window.innerWidth, window.innerHeight);
23
​
24
		const now = Date.now();
25
		const elapsed = (now - _This._LastAdvanceTime)/1000.0;
26
		_This._LastAdvanceTime = now;
27
​
28
		const actor = _This._ActorInstance;
29
	    if (_This._AnimationInstance)
30
			{
31
				const ai = _This._AnimationInstance;
32
				//Apply Mix Time here
33
				ai.time = ai.time + elapsed;
34
​
35
				ai.apply(_This._ActorInstance, 1.0);
36
			}
37
				
38
			
39
		if(actor)
40
		{
41
			const graphics = _This._Graphics;
42
		
43
			const w = graphics.viewportWidth;
44
			const h = graphics.viewportHeight;
45
​
46
			const vt = _This._ViewTransform;
47
			vt[0] = _Scale;
48
			vt[3] = _Scale;
49
			vt[4] = (-_ViewCenter[0] * _Scale + w/2);
50
			vt[5] = (-_ViewCenter[1] * _Scale + h/2);
51
			/** Advance the actor to its new time. */
52
			actor.advance(elapsed);
53
		} 	 
54
		 
55
​
56
		_Draw(_This, _This._Graphics);
57
		/** Schedule a new frame. */
58
		_ScheduleAdvance(_This);
59
	}
Copied!
1
coming soon
Copied!
FlareControls
By defining a Rive controller in the Flutter and Swift runtimes, you can use the play("animationString") method to give you more control over which animation is currently playing with out the need to create a custom controller class.
Flutter Sample
Swift Sample
C++ Sample
1
import 'package:flare_flutter/flare_controls.dart';
2
...
3
final FlareControls _flareControls = FlareControls();
4
...
5
{
6
    ...child: FlareActor("assets/FlareFile.flr",
7
          controller: _flareControls
8
          ),
9
    ...
10
}
11
...
12
{
13
      _flareControls.play("myAnimationName");
14
}
Copied!
1
 private var flareController: FlareSkControls? = nil
2
 ...
3
 override func viewDidLoad() {
4
        super.viewDidLoad()
5
      
6
        flareController = FlareSkControls(for: "FlareTest.flr", CGRect(x: 0, y: 0, width: frame.width, height: frame.height))
7
        flareController!.animationName = "Animation1"
8
        addChild(flareController!)
9
}
10
...        
11
        self.flareController!.play(name: "Animation2", mix: 0.5, mixSeconds: 1.0)
12
...
Copied!
1
...
2
flare::SkrActorArtboard* artboard = actor->artboard<flare::SkrActorArtboard>();
3
artboard->initializeGraphics();
4
​
5
flare::ActorAnimation* animation = artboard->animation("animationString");
6
...	
Copied!
Rive Runtimes - Previous
Rive Actor & Node
Next - Rive Runtimes
ActorComponent
Last modified 6mo ago
Copy link
Contents
ActorAnimation & Properties
Controller
Time and Mixing
FlareControls