Load Animated Graphics

\i g L byte::anim_loc word::anim_graph_index

Parameter	Type	Range	Description
anim_loc	byte	0 ... 7	index of the animation control
anim_graph_index	word	1 ... max. graphic index	index of the animated graphic

by name:

\i g L byte::anim_loc by_name::anim_graph_name

Parameter	Type	Range	Description
anim_loc	byte	0 ... 7	index of the animation control
anim_graph_name	by_name	ASCII chars (0x01 .. 0xFF)	0-terminated graphic name

by filename:

\i g L byte::anim_loc by_file::anim_graph_filename

Parameter	Type	Range	Description
anim_loc	byte	0 ... 7	index of the animation control
anim_graph_filename	by_file	DOS filename (8.3 format)	name and path of the graphics file

Loads an animated graphic to the animation control.

• This command does not draw the animation, it just loads it to the animation control.
• The animation is placed at the current cursor position, graphic alignment is taken into account (refer to Set Graphic Alignment). If the alignment area is smaller than the specified animated graphic, a [NACK] is returned.
• Positioning, alignment and cropping is done with respect to the currently selected viewport (refer to Select Viewport). All re-positioning (refer to Set Animation Coordinates to Cursor Position and Set Animation Coordinates to X/Y) will be interpreted in this viewport too.
• The current background color (refer to Set Background Color) is stored in the animation control and subsequently used for frame removal if the disposal method Remove Animation Background is used.
• If no graphic with anim_graph_index, anim_graph_name or anim_graph_filename is available, [NACK] is returned.
• When addressing by index, the graphic offset (see Set Graphic Offset) is taken into account.
• When addressing by name, the graphic prefix (refer to Set Graphic Name Prefix) and suffix (refer to Set Graphic Name Suffix) are taken into account.
• Additional to the by_name and by_file indices, the anim_graph_index range from 0xFFE0 to 0xFFFF is reserved for internal use!
• If the animation is intended to be run in both directions (e.g. for a gauge), a background has to 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).
• To convert an animated image to a Raw iLCD Graphics Image, use the "Save As" button on iLCD Manager XE's "Graphics" page and select the *.rii filetype.
• Animated graphics stored manually on the MicroSD card can be loaded by their filenames, but not by their graphic names.
• Find general information about animated graphics in chapter LCD Graphics Commands.

Response:

[ACK]

Example

\igL\1\D4
\igL\2\mANIMATION\0
\igL\3\f/ANIM.RII\0

Loads the animated graphic with index 4 into animation control #1, graphic "ANIMATION" into control #2 and graphic "ANIM.RII" from the SD card's root folder into control #3.

Get Graphic Info
Set Graphic Alignment
Set Graphic Offset
Set Graphic Name Suffix
Set Graphic Name Prefix
Display Local Graphic
Start or Restart Animation
Move Animation To Frame