App.Animations 2.0.5

1.App.Animations

• A simple C# easing animation lib with fluent API.
• Base on net-stardard 2.0 and netframework 4.6.1 whihout other dependences.
• Support 30+ well-defined easing animations.
• Support custom easing animation.
• Support infinity loop animation.
• Support auto back animation.
• Author: https://www.github.com/surfsky/
• License: MIT

2.Install

nuget-insall App.Animations

3.Usage

3.1 Use extend functions

MoveTo animation:

this.block.MoveTo(new Point(70, 100), new Point(150, 50), 1000, EasingType.Linear);     // use moveto extension function to apply animation.

Color animation using callback:

var startColor = new List<double> { 255, 0, 0 };
var endColor = new List<double> { 0, 255, 255 };
this.block.Animate(startColor, endColor, 1000, (t, vs) => t.BackColor = ToColor(vs));   // use callback to modify property.

Property animation:

this.picBall.Animate(500, -50, 1000, t => t.Left); 

Custom easing function

Func<double, double> func = (v) => Math.Sin(v*Math.PI*2);   // define a sin easing function
anim1 = this.picBall.Animate(600, -50, 5000, (t,v) => t.Left = (int)v, EasingType.Linear, infinity:true);  // X linear animation
anim2 = this.picBall.Animate(100, 200, 5000, (t,v) => t.Top = (int)v, easingFunc: func, infinity: true);   // Y custom animation

3.2 Use basic fluent api

One value animation example:

var ani = new Animator()
    .AddPath(EasingType.ExponentialEaseOut, 100, 300, 1000)
    .AddPath(EasingType.Linear, 300, 100, 500)
    .SetFrameEvent((values) =>
    {
        Action action = () => {label1.Left = (int)values[0];};
        this.Invoke(action);
    })
    .Start()
    ;

Two values animation example:

var start = new List<double> { 100, 10 };  // x, y
var end   = new List<double> { 300, 100 };
var ani = new Animator()
    .AddPath(AnimationType.ExponentialEaseOut, start, end, 1000)
    .AddPath(AnimationType.Linear, end, start, 500)
    .SetFrameEvent((values) => 
    {
        Action action = () => {
            label1.Left = (int)values[0];
            label1.Top = (int)values[1];
        };
        this.Invoke(action);
    })
    .SetEndEvent((_) => Trace.WriteLine("Animaion end."))
    .Start()
    ;

Three values animation example:

var start = new List<double> { 255, 0, 0 };        // r, g, b
var end   = new List<double> { 0, 255, 255 };
var ani = new Animator()
    .AddPath(AnimationType.ExponentialEaseOut, start, end, 100)
    .AddPath(AnimationType.Linear, end, start, 500)
    .SetFrameEvent((values) =>
    {
        Action action = () => {
            label1.ForeColor = Color.FromArgb((int)values[0], (int)values[1], (int)values[2]);
        };
        this.Invoke(action);
    })
    .SetEndEvent((_)=> Trace.WriteLine("Animation end."))
    .Start()
    ;

3.3 Other functions

Infinity loop animation:

ani.SetInfinity(true);

Change interval to make animation more fluent:

ani.SetInterval(5);

Add autoback paths:

ani.AddReversePaths();

Stop animation:

ani.Stop();

4.Supported animation types