Set Animation Background Screen

\i g b S byte::anim_loc word::pos_x word::pos_y byte::screen

Parameter	Type	Range	Description
anim_loc	byte	0 ... 7	index of the animation control
pos_x	word	0 ... display width - 1	horizontal position on background screen
pos_y	word	0 ... display height - 1	vertical position on background screen
screen	byte	M, 0 ... number of screens - 1	index of the background screen (M = main screen)

Assigns the background screen screen to the animation engine anim_loc.

When a background screen 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 content of the background screen before the first frame is drawn.
If the animation was never drawn before, the whole animation area is filled with the content of the background screen before the first frame is drawn.
The background can be located anywhere on the background screen. pos_x and pos_y can be used to specify the position of the background on the screen.
Restoring frames to background allows an animation to run backwards (refer to Move Animation To Frame), but slows it down a bit.
The background is restored to the assigned screen content when using the commands Erase Animation Image Area or Erase Animation Frame Area as well.
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

\igbS\1\D20\D30\2

This will specify the content of screen #2 starting from cursor position 20/30 as background for the animation control #1.