Erase Animation Frame Area

\i g e byte::anim_loc

Parameter	Type	Range	Description
anim_loc	byte	0 ... 7	index of the animation control

Erases the area covered by the current frame of the animated image.

By default, the frame area is filled with the current background color. If any background was assigned to the animation control however, the frame area is restored to the assigned background (refer to Set Animation Background Color, Set Animation Background Frame, Set Animation Background Graphic or Set Animation Background Screen).
The area may be smaller than the area of the complete image and the upper left corner of the area to be erased is given by the X/Y offset of the frame.
If anim_loc has never been loaded with an animated graphic before, a [NACK] is returned.

Response:

[ACK]

Example

\ige\2

Erases the area on the screen covered by the current frame of animation 2 referenced by the animation control.