Scanlab RTC6 PCIe Board - Calling Indexed Characters; Defining Indexed Text Strings for Time, Date and Serial Number

RTC6 boards
Doc. Rev. 1.0.21 en-US
6 Developing RTC6-User Programs
119
innovators for industry
Calling Indexed Characters
Marking of an individual character is started by
calling mark_char (or the “AbsCall” command
mark_char_abs) along with the index of the
corresponding indexed character definition.
To label serial numbers, indexed characters (digits)
can also be called up with mark_serial, see
Chapter 7.5 ”Marking Dates, Times and Serial
Numbers”, page 210.
The marking of entire text passages can be started by
mark_text (or the “AbsCall” command
mark_text_abs). The desired character set can be
selected in advance by select_char_set.
When a mark_text is loaded, the to-be-marked text
(if more than 12 characters in length) is split into
blocks of 12 characters, with each block receiving its
own mark_text in the RTC6 List Memory. Make sure
that no unwanted memory overflow of the respective
RTC6 List Memory area occurs.
Defining Indexed Text Strings for Time, Date
and Serial Number
For the marking of times, dates and serial numbers,
it can be useful to define text strings such as months
(“January”…“December”, “Jan.”…“Dec.”,
“/01/”…“/12/” etc.) and days of the week
(“Sunday”…“Saturday” or “Sun.”…“Sat.” etc.).
Here, you can likewise use previously-defined
character sets with the mark_char and mark_text.
With load_text_table, a sequence of list commands
defining a text string can be loaded directly into the
protected RTC6 List Memory area “List 3” as an
indexed text string (the resultant automatically-
assigned memory address can be queried by
get_text_table_pointer).
Alternatively, a non-indexed subroutine can be
subsequently indexed with set_text_table_pointer
and then copied by save_disk/load_disk as an
indexed text string in the protected RTC6 List
Memory area “List 3”.
The RTC6 PCIe Board manages up to 42 indexed text
strings.
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
• set_char_table is synonymous with
set_text_table_poi
nter.