Mark_Text - Scanlab RTC6 PCIe Board Installation And Operation Manual

Variable

mark_text

List Command
Function Marks a \0-terminated string.
mark_text( Text )
Call
Text
Parameters
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
memory overflow of the respective
of the individual mark_text commands, the corresponding
(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
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
return code RTC6_REJECTED) and the indexed subroutine is not stored.
• Absolute
called by mark_text. If the text string needs to execute at various locations within the
Image
[*]mark[*]
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.
mark_text_abs
References
RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
PC memory address of the first character (byte) of the to-be-marked text
string. As a pointer to a \0-terminated string.
Vector Commands and
Field, then either the indexed character definitions can only contain relative
Commands, "Arc" Commands or
RTC6 List Memory (make sure that no undesired
RTC6 List Memory area occurs). During processing
select_char_set
"Arc" Commands execute absolutely after being
Jump Commands or
mark_char commands
is used within a called
(get_last_error
mark_text_abs must
538