Scanlab RTC 5 PC Interface Board, Installation And Operation Manual

Page: 410 / 622

RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
410
innovators for industry
Ctrl Command set_char_pointer
Function stores the absolute start address of a command list in the internal management table for
indexed characters.
Call
set_char_pointer( Char, Pos )
Parameters
Char
Index of the indexed character whose starting address
Pos
should be entered
in the management table (as an unsigned 32-bit value, allowed range:
[0 … 1023]). The same applies as for the
load_char command:
Char
= character set number * 256 + ASCII number of the character
(character sets are numbered 0 to 3).
Pos
Absolute start address as an unsigned 32-bit value;
allowed range: [0 … (2
20
–1)]
Comments • If
Char
> 1023 and/or
Pos
> (2
20
–1), then the command will not be executed
( get_last_error return code
RTC5_PARAM_ERROR
).
• The set_char_pointer command can be used for referencing an indexed character. It
thereby becomes an indexed character that is protectable via save_disk / load_disk
and/or callable via the index.
• set_char_pointer can also be used to reference anew an indexed subroutine, character
or text string so that it can also be called via 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_char_pointer
can be queried via get_input_pointer before loading the command lists.
• set_char_pointer only stores starting addresses in the internal management table. An
indexed character only gains protection via 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 was finalized via list_return and does
not contain set_end_of_list .
RTC
®
4

RTC
®
5 new command
References load_char