User manual

Automation Protocol Easytext Commands
Miranda Technologies Ltd Page 217
More Sophisticated Control of Easytext
Additional commands allow automation systems to override parameters set in
the template – changing font sizes and colours, and even altering text box
positions on screen.
Note: In order for one or more updated parameter, such as the text or
an image for a particular box, to be rendered the “Render Box”
command Z3 has to be sent.
Due to the large number of parameters which can be altered on any one text
box, the process of setting up these parameters is typically separate from the
process of ‘rendering’ the text using the parameters. Because most
commands will not automatically cause the text to be rendered, a separate
‘Render Box’ command is provided. This allows multiple parameters to be
set for a variety of boxes, and then the individual box (or complete template)
can be re-rendered.
Example
// Change box number 1 on layer 2 to Image.oxt
Z4201Image.oxt
// Render the box so the above change take effect
Z3201
Sending Colours via Automation
Various commands require colours to be sent to Easytext: All colours are sent
as 6 bytes in RRGGBB format, with a range of 0 to 255 (0x00 to 0xFF) for
each colour.
Examples:
Black 000000
White FFFFFF
Red FF0000
Green 00FF00
Blue 0000FF
Mid-grey 808080