Set Graphic Alignment

\i C G A bits::mode word::width word::height

Parameter	Type	Range	Description
mode	bits	Bits 0 ... 3 and 7	alignment properties
width	word	0 ... display width (0 = full display)	width of the alignment area
height	word	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 command Display Local Graphic or Display Graphic Area as well as Load Animated Graphics, Set Animation Coordinates to X/Y or Set Animation Coordinates to Cursor Position.

Bit	Description
0	center graphic horizontally
1	center graphic vertically
2	right justify graphic
3	bottom justify graphic
7	turn alignment on

• After executing an drawing command, the alignment is automatically cleared. For consecutive aligning of graphics, this command has to be repeated!
• If a static graphic does not fit into the specified area, it will be cropped accordingly. When trying to align an animated graphic which doesn't fit into the area, the drawing command will return a [NACK]. Alignment will still be cleared in this case.
• Bit 7 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 command is issued).
• If the width and/or height parameter would exceed the resulting right/bottom margin when the actual drawing command 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 commands Reset All or Reboot Panel Controller.

Response:

[ACK]

Example

\iCGA\x83\D100\D200

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.

Not supported by: DPC3020, DPC2060, DPC10xx

Display Local Graphic
Load Animated Graphics
Display Graphic Area
Set Animation Coordinates to X/Y
Set Animation Coordinates to Cursor Position