Move Animation To Frame

\i g M byte::anim_loc word::frame_idx bool::backwards

Parameter	Type	Range	Description
anim_loc	byte	0 ... 7	index of the animation control
frame	word	0 ... number of frames - 1	frame of the animation
backwards	bool	0 ... 1	determines wether the animation runs forwards (0) or backwards (1)

Start the animated graphic loaded to the animation control referred by anim_loc and stop again when the specified frame is reached. This can be done in both directions, dependet on the value of backwards.

• Given correct usage, this command returns an [ACK] immediately. Be aware that this acknowledgement means that the animation has begun moving to the desired frame, not that the frame has already been reached.
• Generally, animated gifs are not able to run in both directions. To run an animation backwards, a background must be assigned to the animation engine (refer to Set Animation Background Color, Set Animation Background Frame, Set Animation Background Graphic or Set Animation Background Screen).
• Specifying a frame of 0xFFFF will let the animation run indefinitely (same as Start or Restart Animation) in forward or backward direction.
• If the frame frame is currently showing, an [ACK] is returned but the animation stays as it is.
• If the animation engine has never been drawn before it will start from the first (running forward) or last frame (running backwards).
• If anim_loc has never been loaded with an animated graphic before, a [NACK] is returned.
• Find general information about animated graphics in chapter LCD Graphics Commands.

Response:

[ACK]

Example

\igM\3\D5\1

Starts the animation loaded into animation control #3 in backwards direction and stops at frame #5.

Not supported by: DPC3020, DPC2060, DPC10xx

LCD Graphics Commands
Load Animated Graphics
Start or Restart Animation
Get Graphic Info