Method ilcd.Graphic.setAnimationBackgroundFrame

static void setAnimationBackgroundFrame(int animLoc, int frame)

Throws:

_INSERT_METHOD_SIGNATURE_HERE_

Parameter	Range	Description
animLoc	0 ... 7	index of the animation control
frame	0 ... number of frames - 1	background frame of the animation

Specifies the frame frame as background for the animation engine animLoc.

When a background frame is assigned to an animation control, every frame is restored to the underlying part of the background before the next one is drawn.
As soon as a background frame is assigned, this frame will be skipped in running animations. It can still be set manually though (refer to Graphic.stopAnimationAndSetFrameNumber(int, int)).
If the background frame doesn't cover the entire animation area, only the part where the areas of the background and the previous frame overlap will be restored.
If the animation was never drawn before, the whole animation area is filled with the background frame before the first frame is drawn.
Restoring frames to background allows an animation to run backwards (refer to Graphic.moveAnimationToFrame(int, int, int)), but slows it down a bit.
The background is restored to the assigned background frame when using the methods Graphic.eraseAnimationImageArea(int) or Graphic.eraseAnimationFrameArea(int) as well.
Find general information about animated graphics in class Graphic.

Example

Graphic.setAnimationBackgroundFrame(7, 12);

This will specify frame #12 as the background frame for animation control #5.