Class AnimationView

Definition

Namespace:

ElmSharp

Assembly:

ElmSharp.dll

The AnimationView is designed to show and play animation of vector graphics based content. Currently ElmSharp AnimationView is supporting only json format (known for Lottie file as well).

[Obsolete("This has been deprecated in API12")]
public class AnimationView : EvasObject

Inheritance

object

EvasObject

AnimationView

Constructors

AnimationView(EvasObject)

Creates and initializes a new instance of the AnimationView class.

Declaration

[Obsolete("This has been deprecated in API12")]
public AnimationView(EvasObject parent)

Parameters

Type	Name	Description
EvasObject	parent	The parent is a given container, which will be attached by AnimationView as a child. It's EvasObject type.

Properties

AutoPlay

Sets or gets whether to play animation automatically. If AutoPlay is true, animation will be started when it's readied. The condition of AutoPlay is when AnimationView opened file successfully, yet to play it plus when the object is visible. If AnimationView is disabled, invisible, it turns to pause state then resume animation when it's visible again. This AutoPlay will be only affected to the next animation source. So must be called before SetAnimation()

Declaration

[Obsolete("This has been deprecated in API12")]
public bool AutoPlay { get; set; }

Property Value

Type	Description
bool

AutoRepeat

Sets or gets whether to turn on/off animation looping. If AutoRepeat is true, it repeats animation when animation frame is reached to end. This AutoRepeat mode is valid to both Play and ReversePlay cases.

Declaration

[Obsolete("This has been deprecated in API12")]
public bool AutoRepeat { get; set; }

Property Value

Type	Description
bool

DefaultSize

Get the default view size that specified from vector resource.

Declaration

[Obsolete("This has been deprecated in API12")]
public Size DefaultSize { get; }

Property Value

Type	Description
Size

DurationTime

Get the duration of animation in seconds.

Declaration

[Obsolete("This has been deprecated in API12")]
public double DurationTime { get; }

Property Value

Type	Description
double

Remarks

Returns total duration time of current animation in the seconds. If current animation source isn't animatable, it returns zero.

Frame

Sets or gets current frame position of animation view. The range of frame is from 0 to FrameCount - 1

Declaration

[Obsolete("This has been deprecated in API12")]
public int Frame { get; set; }

Property Value

Type	Description
int

FrameCount

Get the index of end frame of the AnimationView, if it's animated.

Declaration

[Obsolete("This has been deprecated in API12")]
public int FrameCount { get; }

Property Value

Type	Description
int

Remarks

Frame number starts with 0.

IsReversedPlaying

Get the status whether current animation is on playing forward or backward.

Declaration

[Obsolete("This has been deprecated in API12")]
public bool IsReversedPlaying { get; }

Property Value

Type	Description
bool

Remarks

If AnimationView is not on playing, it will return False.

MaxFrame

Sets or Gets the last frame of the play

Declaration

[Obsolete("This has been deprecated in API12")]
public int MaxFrame { get; set; }

Property Value

Type	Description
int

Remarks

Default value is FrameCount -1.

MaxProgress

Sets or Gets the last progress of the play

Declaration

[Obsolete("This has been deprecated in API12")]
public double MaxProgress { get; set; }

Property Value

Type	Description
double

Remarks

Default value is 1.

MinFrame

Sets or Gets the start frame of the play

Declaration

[Obsolete("This has been deprecated in API12")]
public int MinFrame { get; set; }

Property Value

Type	Description
int

Remarks

Default value is 0.

MinProgress

Sets or Gets the start progress of the play

Declaration

[Obsolete("This has been deprecated in API12")]
public double MinProgress { get; set; }

Property Value

Type	Description
double

Remarks

Default value is 0.

Progress

Sets or gets current progress position of animation view. When you required to jump on a certain progress instantly, you can change current position by using this property The range of progress is 0 ~ 1.

Declaration

[Obsolete("This has been deprecated in API12")]
public double Progress { get; set; }

Property Value

Type	Description
double

Speed

Sets or gets the animation speed. Control animation speed by multiplying Speed value. If you want to play animation double-time faster, you can give Speed 2. If you want to play animation double-time slower, you can give Speed 0.5. Speed must be greater than zero.

Declaration

[Obsolete("This has been deprecated in API12")]
public double Speed { get; set; }

Property Value

Type	Description
double

State

Get current animation view state.

Declaration

[Obsolete("This has been deprecated in API12")]
public AnimationViewState State { get; }

Property Value

Type	Description
AnimationViewState

Methods

CreateHandle(EvasObject)

Creates a AnimationView handle.

Declaration

[Obsolete("This has been deprecated in API12")]
protected override IntPtr CreateHandle(EvasObject parent)

Parameters

Type	Name	Description
EvasObject	parent	Parent EvasObject.

Returns

Type	Description
System.IntPtr	Handle IntPtr.

Overrides

EvasObject.CreateHandle(EvasObject)

Pause()

Pause current animation instantly. Once animation is paused, animation view must get resume to play continue again. Animation must be on playing or playing back status.

Declaration

[Obsolete("This has been deprecated in API12")]
public void Pause()

Play()

Play animation one time instantly when it's available. If current keyframe is on a certain position by playing reverse, this will play forward from there. Play request will be ignored if animation source is not set yet or animation is paused state or it's already on playing.

Declaration

[Obsolete("This has been deprecated in API12")]
public void Play()

Play(bool)

Play animation one time instantly when it's available. If current keyframe is on a certain position by playing reverse and isReverse is ture, this will play forward from there. And if current keyframe is on a certain position by playing and isReverse is false, this will play backward from there. Play request will be ignored if animation source is not set yet or animation is paused state or it's already on playing.

Declaration

[Obsolete("This has been deprecated in API12")]
public void Play(bool isReverse)

Parameters

Type	Name	Description
bool	isReverse	Whether the animation play or reverse play.

Resume()

Resume paused animation to continue animation.

Declaration

[Obsolete("This has been deprecated in API12")]
public void Resume()

Remarks

This resume must be called on animation paused status.

SetAnimation(string)

Sets the animation source file.

Declaration

[Obsolete("This has been deprecated in API12")]
public void SetAnimation(string file)

Parameters

Type	Name	Description
string	file	The animation file path.

Stop()

Stop playing animation. Stop animation instatly regardless of it's status and reset to show first frame of animation.Even though current animation is paused, the animation status will be stopped.

Declaration

[Obsolete("This has been deprecated in API12")]
public void Stop()

Events

Finished

It occurs when the animation is just finished.

Declaration

[Obsolete("This has been deprecated in API12")]
public event EventHandler Finished

Event Type

Type	Description
System.EventHandler

Paused

It occurs when the animation is just paused.

Declaration

[Obsolete("This has been deprecated in API12")]
public event EventHandler Paused

Event Type

Type	Description
System.EventHandler

Repeated

It occurs when the animation is just repeated.

Declaration

[Obsolete("This has been deprecated in API12")]
public event EventHandler Repeated

Event Type

Type	Description
System.EventHandler

Resumed

It occurs when the animation is just resumed.

Declaration

[Obsolete("This has been deprecated in API12")]
public event EventHandler Resumed

Event Type

Type	Description
System.EventHandler

Started

It occurs when the animation is just started.

Declaration

[Obsolete("This has been deprecated in API12")]
public event EventHandler Started

Event Type

Type	Description
System.EventHandler

Stopped

It occurs when the animation is just stopped.

Declaration

[Obsolete("This has been deprecated in API12")]
public event EventHandler Stopped

Event Type

Type	Description
System.EventHandler

Updated

It occurs when the animation is updated to the next frame.

Declaration

[Obsolete("This has been deprecated in API12")]
public event EventHandler Updated

Event Type

Type	Description
System.EventHandler

Extension Methods

RotaryEventExtensions.Activate(EvasObject)

RotaryEventExtensions.AddRotaryEventHandler(EvasObject, RotaryEventHandler)

RotaryEventExtensions.Deactivate(EvasObject)

RotaryEventExtensions.RemoveRotaryEventHandler(EvasObject, RotaryEventHandler)