6 text – Matrix Orbital GTT70A User Manual
Page 25

21
Command Summary
2.6 Text
6.1 Create
a Label
Dec
Hex
ASCII
254 16
FE 10
þ [DLE]
Index X Y Width Height Rot VJst HJst Font R G B
Index X Y Width Height Rot VJst HJst Font R G B
Index X Y Width Height Rot VJst HJst Font R G B
2.1
Designate a portion of the screen that can easily be updated with one line of text; useful when displaying variables.
Index
Byte
Index used to identify the label. Specific to labels.
X
Signed Short
Leftmost coordinate of the label region.
Y
Signed Short
Topmost coordinate of the label region.
Width
Signed Short
Width of the label region in pixels.
Height
Signed Short
Height of the label region in pixels.
Rot
Signed Short
Rotation of the text within the label.
VJst
Byte
Vertical justification of text within the label, as per eFontAlignVertical values.
HJst
Byte
Horizontal justification of text within the label, as per eFontAlignHorizontal values.
Font
Byte
Font index of a previously loaded font to be used for the label.
R
Byte
Intensity of red, 0 to 255, used for label font colour.
G
Byte
Intensity of green, 0 to 255, used for label font colour.
B
Byte
Intensity of blue, 0 to 255, used for label font colour.
Table 17: eFontAlignVertical values
Value Description
0
Top
1
Bottom
2
Center
Table 18: eFontAlignHorizontal values
Value Description
0
Left
1
Right
2
Center
6.2 Update a
Label
Dec
Hex
ASCII
254 17
FE 11
þ
Index Format Value
Index Format Value
Index Format Value
2.1
Update a previously defined label with new text. Send a null character (empty string) to clear a label.
Index
Byte
Index previously assigned to a defined label.
Format
Byte
Format of the string, as per eLabelFormat values.
Value
String
New string to display within the label. The string must match the format
specified and should be capitalized and one line in height.
Table 19: eLabelFormat values
Value Description
0
ASCII
1
Unicode
2
UTF-8