Scanlab RTC6 PCIe Board - Set_Text_Table_Pointer

RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
749
innovators for industry
Ctrl Command set_text_table_pointer
Function Stores the absolute start address of a command list in the internal management table for
indexed text strings.
Call set_text_table_pointer( Index, Pos )
Parameters Index Index of the indexed text string whose starting address Pos should be entered
in the management table.
As an unsigned 32-bit value.
Allowed value range: [0…41].
The same assignment applies as for load_text_table:
= 0…9: Digits for marking the time and date [0…9].
= 10…21: Months [January…December].
= 22…28: Days-of-the-week [Sunday…Saturday].
= 29: Blank character for marking serial numbers.
= 30…39: Digits for marking serial numbers [0…9].
= 40: Text for “a.m.”.
= 41: Text for “p.m.”.
Pos Absolute start address.
As an unsigned 32-bit value.
Allowed value range: [0…(2
23
–1)].
Comments • Indexed text strings can be used for marking time, date or serial numbers, see Section
”Calling Indexed Text Strings”, page 120.
• If Index > 41 and/or Pos > (2
23
–1), then set_text_table_pointer is not executed
(get_last_error return code RTC6_PARAM_ERROR ).
• set_text_table_pointer can be used for referencing a nonindexed subroutine, which
thereby becomes an indexed text string that is protectable by save_disk/load_disk
and/or callable by the index.
• set_text_table_pointer can also be used to reference anew an indexed subroutine,
character or text string so that it can also be called by a second index. Here, it is
preferable to use the copy_dst_src command for index management.
• The start addresses of command lists that are to be referenced with
set_text_table_pointer can be queried by get_input_pointer before loading the
command lists.
• set_text_table_pointer only stores starting addresses in the internal management
table. An indexed text string only gains protection by a subsequent
save_disk/load_disk command.
• Pos should not be an arbitrary address within a list. Instead, it should be the starting
address of an actually existing subroutine that has been finalized by list_retur
n and
doe
s not contain set_end_of_list.
RTC4RTC6 New command.
set_text_table_pointer is synonymous with set_char_table, which is available for the
RTC4 SCANalone Board (standalone version of the RTC4 board).
RTC5RTC6 Unchanged functionality.
Version info Available as of DLL 600, OUT 600, RBF 600.
References load_text_table, mark_date, mark_serial, mark_time