User manual

Automation Protocol Easytext Commands

Miranda Technologies Ltd Page 218

Main Commands

Update Text Field Z0

This command updates the text in a specified text box. Formatting and style

of the text is unchanged.

CMD Param_1 Param_2 Param_3 Param_4

Z0 %01x

Layer No.

%02x

Text Box No.

%01x

Render

String

Example:

void UpdateTextBox(int Layer, int BoxNo,

int flags, char* String)

{

remote_send("Z0%01x%02x%01x%s", Layer, BoxNo,

flags, String);

}

The layer value specifies which Imagestore keying layer

is addressed. The

Box number ranges from 0x00 to 0xFF and relates to which Text Box is to be

updated.

The String is the new text to be written into text box specified. To enable

international character support, the string should be UTF-8 encoded before

transmission, see below.

Two bitwise flags are defined in the flags parameter:

• ET_RENDER (0x1)

• ET_APPEND (0x2)

If the ET_RENDER bit is set then the new text will appear on screen with all

changes to font, size, colour and position that have been specified since the

last call to Render Box (Z3) or Update Text Field (Z0). If ET_RENDER is

not set then changes will not appear on screen until the next call to Render

In Swap-Preview mode layers 0 and 1 represent preview and program