RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
361
innovators for industry
Variable
List Command
mark_text
Function
marks a null-terminated string.
Call
mark_text( Text )
Parameter
Text
PC memory address of the first character (byte) of the to-be-marked text
string as a pointer to a null-terminated ANSI string
Comments
• The to-be-marked text (character sequence, byte array, null-terminated string) must be
terminated with a \0 character (0 byte, NULL). The 0\ character itself will not be marked.
• When a
mark_text
command is loaded, the to-be-marked text (if more than 12 charac-
ters in length, \0 not included) is split into blocks of 12 characters, with each block
receiving its own
mark_text
command in the list memory (keep this in mind to prevent
unintended overflow of the corresponding buffer area). During processing of the indi-
vidual
mark_text
commands, the corresponding
acters) will be executed in accordance with the selected character set.
• The desired character set can be selected prior to the
mark_text
command via the
command. For the default setting, character set 0 will be used. If the
command
is used within a called indexed character, then all subse-
quently called indexed characters will be marked using this character set.
• If the end of a list (“List 1” or “List 2”) is reached during loading of a
mark_text
command, then loading will continue at the start of the corresponding list. In contrast,
loading in the protected area (as part of an indexed subroutine) will be aborted
(
return code
RTC5_REJECTED
) and the indexed subroutine will not be
stored.
• Absolute vector and arc commands will execute absolutely after being called with
mark_text
. If the text string needs to execute at various locations within the image
field, then either the indexed character definitions can only contain relative mark, arc
or jump commands or
must be used instead.
• The
mark_text
command should not be used within an indexed character definition.
The corresponding text will
not
be marked and the indexed character will therefore not
be fully processed.
RTC
®
4
RTC
®
5 new command
References
