Scanlab RTC6 PCIe Board - Mark_Text

RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
538
innovators for industry
Variable
List Command
mark_text
Function Marks a \0-terminated string.
Call mark_text( Text )
Parameters Text PC memory address of the first character (byte) of the to-be-marked text
string. As a pointer to a \0-terminated string.
Comments • The to-be-marked text (character sequence, byte array, \0-terminated string) must be
terminated with a \0 character (0 byte, NULL). The 0\ character itself is not marked.
• When a mark_text is loaded, the to-be-marked text (if more than 12 characters in
length, \0 not included) is split into blocks of 12 characters, with each block receiving
its own mark_text command in the RTC6 List Memory (make sure that no undesired
memory overflow of the respective RTC6 List Memory area occurs). During processing
of the individual mark_text commands, the corresponding mark_char commands
(indexed characters) are executed in accordance with the selected character set.
• The desired character set can be selected prior to mark_text by select_char_set. For
the default setting, character set 0 is used. If the select_char_set is used within a called
indexed character, then all subsequently called indexed characters are marked using
this character set.
• If the end of a list (“List 1” or “List 2”) is reached during loading of a mark_text, then
loading continues at the start of the corresponding list. In contrast, loading in the
protected area (as part of an indexed subroutine) is aborted (get_last_error
return code RTC6_REJECTED ) and the indexed subroutine is not stored.
• Absolute Vector Commands and “Arc” Commands execute absolutely after being
called by 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[*] Commands, “Arc” Commands or Jump Commands or mark_text_abs must
be used instead.
• mark_text should not be used within an indexed character definition. The
corresponding text is not marked and the indexed character is therefore not fully
processed.
RTC4RTC6 New command.
RTC5RTC6 Unchanged functionality.
Version info Available as of DLL 600, OUT 600, RBF 600.
References mark_text_abs