Set Animation Background Graphic

\i g b G byte::anim_loc word::offset_x word::offset_y word::graphic_index

Parameter	Type	Range	Description
anim_loc	byte	0 ... 7	index of the animation control
offset_x	word	0 ... graphic width - 1	horizontal offset in background graphic
offset_y	word	0 ... graphic height - 1	vertical offset in background graphic
graphic_index	word	0 ... max. graphic index	index of the background graphic

by name:

\i g b G byte::anim_loc word::offset_x word::offset_y by_name::graphic_name

Parameter	Type	Range	Description
anim_loc	byte	0 ... 7	index of the animation control
offset_x	word	0 ... graphic width - 1	horizontal offset in background graphic
offset_y	word	0 ... graphic height - 1	vertical offset in background graphic
graphic_name	by_name	ASCII chars (0x01 .. 0xFF)	0-terminated graphic name

by filename:

\i g b G byte::anim_loc word::offset_x word::offset_y by_file::graphic_filename

Parameter	Type	Range	Description
anim_loc	byte	0 ... 7	index of the animation control
offset_x	word	0 ... graphic width - 1	horizontal offset in background graphic
offset_y	word	0 ... graphic height - 1	vertical offset in background graphic
graphic_filename	by_file	DOS filename (8.3 format)	name and path of the graphics file

Assigns the background graphic specified by graphic_index, graphic_name or graphic_filename to the animation engine anim_loc.

When a background graphic is assigned to an animation control, every frame is restored to the underlying part of the background before the next one is drawn.
If the animation was never drawn before, the whole animation area is filled with the according part of background graphic before the first frame is drawn.
If no graphic with graphic_index, graphic_name or graphic_filename is available or the anim_loc has never been loaded with an animated graphic before, [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.
Background graphics can be larger than the animation area. In this case, offset_x and offset_y have to be set to the offset between the origin of the background graphic and the origin of the animation area.
Restoring frames to background allows an animation to run backwards (refer to Move Animation To Frame), but slows it down a bit. Even more so if animated or background graphic have to be loaded from SD card.
The background is restored to the assigned background graphic when using the commands Erase Animation Image Area or Erase Animation Frame Area as well.
Find general information about animated graphics in chapter LCD Graphics Commands.

Response:

[ACK]

Example

\igbG\1\D0\D0\D7
\igbG\2\D10\D20\mGRAPHIC\0
\igbG\3\D0\D0\fDIR/FILE.RII\0

These commands will assign:

graphic with index #7 without offset to the animation control #1
part of the graphic with name "GRAPHIC" starting from position 10/20 to the animation control #2
graphic with filename "FILE.RII" from the SD card's "DIR" folder without offset to the animation control #3

Not supported by: DPC3020, DPC2060, DPC10xx