AnimationControl
-
class
HPS.AnimationControl: HPS.SprocketControl The AnimationControl class is a smart pointer that is tied to a database object. This control allows you to conduct playback for animations on the associated view.
Public Functions
-
AnimationControl(HPS.AnimationControl in_that) Initializes a control tied to the same object as in_that.
-
AnimationControl(HPS.View in_view) Initializes a control tied to the view in_view.
-
override void
Dispose()
-
UInt32
GetCurrentTick() Gets the current tick of the playback range.
Return: The current tick.
-
UInt32
GetEndTick() Gets the end tick of the playback range.
Return: The end tick.
-
double
GetMillisecondsPerTick() Gets the duration of time in milliseconds between each tick described by the keyframes of the attached animations.
Return: The duration in milliseconds.
-
UInt32
GetStartTick() Gets the start tick of the playback range.
Return: The start tick.
-
override HPS.Type
ObjectType() This function returns the type the object, as declared (if the object is derived, this does not give the true type of the derived object).
Return: The declared type of the object in question, which may differ from the true, underlying type.
-
HPS.AnimationControl
Play() Starts playback of the attached animation(s) executing from tick 0 up to the last tick specified by the attached animation(s). Any playback currently stopped on this AnimationControl cannot be resumed after this call.
Warning
If SetAnimations hasn’t been called on this AnimationControl this function will throw an InvalidOperationException.
Warning
If animation playback is already occuring this will throw an InvalidOperationException.
Return: A reference to this AnimationControl.
-
HPS.AnimationControl
Play(UInt32 in_start_tick) Starts playback of the attached animation(s) executing from tick 0 up to the last tick specified by the attached animation(s). Any playback currently stopped on this AnimationControl cannot be resumed after this call.
Warning
If SetAnimations hasn’t been called on this AnimationControl this function will throw an InvalidOperationException.
Warning
If animation playback is already occuring this will throw an InvalidOperationException.
Param in_start_tick: Optional tick to start playback from default. Return: A reference to this AnimationControl.
-
HPS.AnimationControl
Play(UInt32 in_start_tick, UInt32 in_end_tick) Asynchronously starts playback of the attached animation(s) executing from in_start_tick up to in_end_tick. If in_end_tick is lesser than in_start_tick playback will occur in reverse. Any playback currently stopped on this AnimationControl cannot be resumed after this call.
Warning
If SetAnimations hasn’t been called on this AnimationControl this function will throw an InvalidOperationException.
Warning
If animation playback is already occuring this will throw an InvalidOperationException.
Param in_start_tick: The tick to start playback from. Param in_end_tick: The tick to stop playback at. Return: A reference to this AnimationControl.
-
HPS.AnimationControl
Resume() Resumes playback that was previously halted with Stop().
Return: A reference to this AnimationControl.
-
HPS.AnimationControl
SetAnimation(HPS.Animation in_animation) Sets the animation to apply during playback on the view associated with this AnimationControl. This will override any previous animation(s) set on this AnimationControl.
Warning
If animation playback is already occuring this will throw an InvalidOperationException
Param in_animation: The animation to use for playback. Return: A reference to this AnimationControl.
-
HPS.AnimationControl
SetAnimations(HPS.Animation[] in_animations) Sets the animations to apply during playback on the view associated with this AnimationControl. Playback of multiple animations will occur simultaneously. This will override any previous animation(s) set on this AnimationControl.
Warning
If animation playback is already occuring this will throw an InvalidOperationException.
Param in_animations: The animations to use for playback. Return: A reference to this AnimationControl.
-
HPS.AnimationControl
SetAnimations(ulong in_count, HPS.Animation in_animations) Sets the animations to apply during playback on the view associated with this AnimationControl. Playback of multiple animations will occur simultaneously. This will override any previous animation(s) set on this AnimationControl.
Warning
If animation playback is already occuring this will throw an InvalidOperationException.
Param in_count: The number of animations that will be associated with this AnimationControl. Param in_animations: The animations to use for playback. Return: A reference to this AnimationControl.
-
HPS.AnimationControl
SetMillisecondsPerTick(double in_duration) Sets the duration of time in milliseconds between each tick described by the keyframes of the attached animations.
Warning
If animation playback is already occuring this will throw an InvalidOperationException.
Param in_duration: The duration in milliseconds. Return: A reference to this AnimationControl.
-
bool
ShowAnimations(out HPS.Animation[] out_animations) Shows the animations that are set on this AnimationControl.
Param out_animations: The animations that are currently set on this animation control.
-
HPS.AnimationControl
Stop() Stops playback. The playback can be resumed later by calling Resume().
Warning
If SetAnimations hasn’t been called on this AnimationControl this function will throw an InvalidOperationException.
Return: A reference to this AnimationControl.
-
HPS.AnimationControl
Undo() Reverts any changes made to the scene by playing animations.
Warning
If animation playback is already occuring this will throw an InvalidOperationException.
Return: A reference to this AnimationControl.
-
HPS.AnimationControl
Wait() Blocks until playback is complete.
Return: A reference to this AnimationControl.
-