RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
361
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 mark_char commands (indexed char-
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
select_char_set command. For the default setting, character set 0 will be used. If the
command select_char_set 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
(get_last_error 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 mark_text_abs 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 mark_text_abs
To Next Page
Loading...
