Package ilcd
Class Graphic
Public Method loadAnimatedGraphics
static void loadAnimatedGraphics(int animLoc, int animGraphicIndex)
Throws:
static void loadAnimatedGraphics(int animLoc, String animGraphicNameOrFilename)
Throws:
_INSERT_METHOD_SIGNATURE_HERE_
Description:
| Parameter |
Range |
Description |
| animLoc |
0 ... 7 |
index of the animation control |
| animGraphicIndex |
1 ... max. graphic index |
index of the animated graphic |
| Parameter |
Range |
Description |
| animLoc |
0 ... 7 |
index of the animation control |
| animGraphicNameOrFilename |
ASCII chars (0x01 .. 0xFF) or
DOS filename (8.3 format)
|
name of the graphic or
name and path of the graphics file |
Loads an animated graphic to the animation control.
Note
- 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 Control.setGraphicAlignment(int, int, int)).
- Positioning, alignment and cropping is done with respect to the currently selected viewport (refer to Control.selectViewport(int)). All re-positioning (refer to Graphic.setAnimationCoordinatesToCursorPosition(int) and Graphic.setAnimationCoordinatesToXY(int, int, int)) will be interpreted in this viewport too.
- The current background color (refer to Attribute.setBackgroundColor(int)) is stored in the animation control and subsequently used for frame removal if the disposal method Graphic.removeAnimationBackground(int) is used.
- When addressing by index, the graphic offset (see Extra.setGraphicOffset(int)) is taken into account.
- When addressing by name, the graphic prefix (refer to Extra.setGraphicNamePrefix(String)) and suffix (refer to Extra.setGraphicNameSuffix(String)) are taken into account.
- The animGraphicIndex 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 Graphic.setAnimationBackgroundColor(int, int), Graphic.setAnimationBackgroundFrame(int, int), Graphic.setAnimationBackgroundGraphic(int, int, int, int) or Graphic.setAnimationBackgroundScreen(int, int, int, int)).
- To convert an animated image to a Raw iLCD Graphics Image, use the "Save As" button on iLCD Manager XEJoC Manager'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 class Graphic.
Graphic.loadAnimatedGraphics(1, 4);
Graphic.loadAnimatedGraphics(2, "ANIMATION");
Graphic.loadAnimatedGraphics(3, "ANIM.RII");
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.
See also:
Copyright © demmel products gmbh. All rights reserved.