Public Method setGraphicAlignment

static void setGraphicAlignment(int mode, int width, int height)

Throws:

• ILCDException

_INSERT_METHOD_SIGNATURE_HERE_

Parameter	Range	Description
mode	Bits 0 ... 3 and 7	alignment properties
width	0 ... display width (0 = full display)	width of the alignment area
height	0 ... display height (0 = full display)	height of the alignment area

Define an area in which the next graphic will be aligned when subsequently sending the method Graphic.displayLocalGraphic(int) or Graphic.displayGraphicArea(int, int, int, int, int) as well as Graphic.loadAnimatedGraphics(int, int), Graphic.setAnimationCoordinatesToXY(int, int, int) or Graphic.setAnimationCoordinatesToCursorPosition(int).

mode
GRAPHIC_CENTER_HORIZONTALLY
GRAPHIC_CENTER_VERTICALLY
GRAPHIC_RIGHT_JUSTIFY
GRAPHIC_BOTTOM_JUSTIFY
GRAPHIC_TURN_ALIGNMENT_ON

• After executing an drawing method, the alignment is automatically cleared. For consecutive aligning of graphics, this method has to be repeated!
• If a static graphic does not fit into the specified area, it will be cropped accordingly.
• GRAPHIC_TURN_ALIGNMENT_ON of mode must always be set to enable the alignment settings. If only this bit is set, the next graphic is top/left justified and cropped in the specified area.
• If the width and/or height parameter is set to 0, the controller automatically uses the maximum area available (starting from the current cursor position when the drawing method is called).
• If the width and/or height parameter would exceed the resulting right/bottom margin when the actual drawing method is executed, the controller automatically adjusts the width and/or height accordingly to the margins.
• Some bits of mode do not make sense when used together, so there are some logical precedent rules (centering always overrules justifying).
• The default value for mode is 0. It will be automatically set to default on startup and by the methods General.resetAll() or General.rebootPanelController().

Example

Control.setGraphicAlignment(Control.GRAPHIC_CENTER_HORIZONTALLY |
                           Control.GRAPHIC_CENTER_VERTICALLY |
                           Control.GRAPHIC_TURN_ALIGNMENT_ON,
                           100, 200);

This will set graphic alignment to center the next drawn graphic or loaded animation horizontally and vertically in an area of 100 pixels width and 200 pixels height. To place a graphic into the centre of the display use the following command:

Control.setGraphicAlignment(Control.GRAPHIC_CENTER_HORIZONTALLY |
                           Control.GRAPHIC_CENTER_VERTICALLY |
                           Control.GRAPHIC_TURN_ALIGNMENT_ON,
                           Control.getDisplaySize().getWidth(),
                           Control.getDisplaySize().getHeight());

Graphic.displayLocalGraphic(int)
Graphic.loadAnimatedGraphics(int, int)
Graphic.displayGraphicArea(int, int, int, int, int)
Graphic.setAnimationCoordinatesToXY(int, int, int)
Graphic.setAnimationCoordinatesToCursorPosition(int)