Scanlab RTC6 PCIe Board - Load_Text_Table

RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
515
innovators for industry
Ctrl Command load_text_table
Function Assigns the specified index to a text string defined by subsequent list commands and loads
the text string into the protected RTC6 List Memory area “List 3”.
Call load_text_table( Index )
Parameters Index Index of the indexed text string.
As an unsigned 32-bit value.
Allowed value range: [0…41].
Comments • Up to 42 indexed text strings can be stored (for marking times, dates and serial
numbers by other commands). The following ordering applies:
– Index = 0…9: digits for marking the time and date [0…9]
– Index = 10…21: months [January…December]
– Index = 22…28: days-of-the-week [Sunday…Saturday]
– Index = 29: blank character for marking serial numbers
– Index = 30…39: digits for marking serial numbers [0…9]
– Index = 40: text for “a.m.”
– Index = 41: text for “p.m.”
If Index > 41 then load_text_table is ignored (get_last_error return code
RTC6_PARAM_ERROR ).
• Even if digits are defined by mark_text instead of as individual characters with
mark_char, the character set can still be subsequently switched for this purpose (see
select_char_set).
• The addresses in the protected RTC6 List Memory area “List 3” where the text string
definitions are stored are automatically determined and internally managed.
Management is independent of that for indexed subroutines (see load_sub) and
character definitions (see load_char).
• Indexed text string definitions must be terminated with a list_return call. This is a
prerequisite for actual storage of the commands, entry of the start address into the
internal management table, and initiating a flush of the buffered list input, see
Chapter 6.4.1 ”Loading Lists”, page 105. Otherwise (the input pointer is altered
without a preceding list_return), the text string with this index is not available.
• An indexed text string definition is not stored if the protected RTC6 List Memory area
“List 3” has not been previously configured for a sufficient size beyond “List 1” and
“List 2”.
• If list_return is the next command after load_text_table, then the corresponding text
string definition is deleted from the internal management table.
• Also observe all notes in the Chapter 6.5.2 ”Character Sets and Text Strings”, page 118.
RTC4RTC6 New command.
RTC5RTC6 Unchanged functionality.
Version info Available as of DLL 600, OUT 600, RBF 600.
References list_return, load_sub, load_char