Scanlab RTC6 PCIe Board - Character Sets and Text Strings; Defining Indexed Character Sets

RTC6 boards
Doc. Rev. 1.0.21 en-US
6 Developing RTC6-User Programs
118
innovators for industry
6.5.2 Character Sets and Text Strings
For marking tasks, it is convenient to use the RTC6 List
Memory for storing command lists as separate
subroutines that define how the scan system should
mark the needed characters and/or text strings.
To simplify management of characters and text
strings, the RTC6 PCIe Board provides the possibility
of storing indexed character definitions and text
string definitions in its protected RTC6 List Memory
area “List 3” and calling them by simple commands.
Indexed character definitions and text string
definitions are essentially indexed subroutines, but
definable and callable by their own commands, and
managed by a dedicated internal RTC6 PCIe Board
management table – separately from indexed
subroutines.
The individual character and text string definitions
must specify the shape and orientation (for example,
parallel to the x or y axis) of the characters or text
strings. Both relative and absolute Vector Commands
can be used for this. The end position of a character
or a text string should be chosen to serve as the start
position of a subsequent character. Each character
definition or text string definition must be terminated
with list_return.
Defining Indexed Character Sets
A sequence of character-defining list commands can
be directly stored in the protected RTC6 List Memory
area “List 3” by load_char (the resultant
automatically-assigned memory address can be
queried by get_char_pointer). Alternatively, a non-
indexed subroutine can be subsequently indexed
with set_char_pointer and then copied by
save_disk/load_disk as an indexed character in the
protected RTC6 List Memory area “List 3”.
The RTC6 PCIe Board manages up to 4 character sets,
each with 256 indexed characters.
Other than that, the same rules as for indexed
subroutines are applicable, see Section ”Indexed
Subroutines”, page 113 and Section ”Subsequent
Protection and Conversion of Non-Indexed
Subroutines”, page 116.
Notes
• \0 (NUL) is a markable character, too.
\0 also serves as a text-output delimiter (for text
strings), in which case it is not marked.
• Indexed character set definitions cannot use
mark_text, mark_time, mark_date and
mark_serial. Otherwise, improper marking might
occur during execution of the indexed character.