Set Text Alignment

\i C T bits::mode word::width word::height

Parameter	Type	Range	Description
mode	bits	Bit 0 ... 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

This powerful command helps you to align text on the screen automatically. The next invocation of command Write Text, Write Text Message or Get Text Extent will align, word-wrap and crop text corresponding to the mode set by this command in the specified area. A maximum of 1024 characters and 48 text lines can be aligned. The mode consists of the following bits, which can be binary ORed together:

Bit	Description
0	center text horizontally
1	center text vertically
2	right justify text
3	bottom justify text
4	do not word wrap text
5	add horizontal space for border
6	add vertical space for border
7	turn alignment on

• After executing an output-command like for example Write Text Message, the alignment is automatically cleared. For consecutive aligning of text strings, the set text alignment command has to be repeated!
• Bit 7 must always be set to enable the alignment settings. Clearing this bit allows an accidentally set alignment to be disabled before the text output.
• If alignment is turned on and none of the bits 0~3 are set, following text will be top/left justified (just as without any alignment), but also wrapped and cropped in the specified alignment area.
• Some bits do not make sense when used together, so there are some logical precedent rules (centering always overrules justifying).
• If the text does not fit into the given area, it will be truncated. If word wrap cannot be done due to words, which are longer than the available space, or word wrapping is switched off, the rest of the word will be continued on the next line.
• If the width and/or height parameter would exceed the resulting right/bottom margin when the actual output-command (for example Write Text) is executed, the controller automatically adjusts the width and/or height accordingly to the margins.
• 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 an actual output-command is issued).
• Even ANSI sequences (such as setting the font, etc.) can be used within the text to be aligned, although using cursor control ANSI commands within text alignments does not make sense and may produce unwanted results.
• Carriage returns and linefeeds can be used to force a new line regardless of the actual horizontal space already used for the current line. Entering a CR/LF pair causes one new line, entering e.g. two consecutive CRs causes two new lines.
• 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

\iCT\x83\D200\D100

This will set text alignment to center subsequently outputted text horizontally and vertically in an area of 200 pixels width and 100 pixels height.

Write Text
Write Text Message
Get Text Extent
Set Line Style
Set Fonts Scaling
ANSI Support