Scanlab RTC 5 PC Interface Board Installation And Operation Manual page 327

Ctrl Command load_char
Function assigns a desired index to a character defined via subsequent list commands, and loads the
character into the protected buffer area ("List 3")
Call
load_char( Char )
Parameter
Char
Comments • Up to 1024 indexed characters, hence 4 character sets with 256 indexed characters per
set, can be stored. For defining character sets, the following applies:
Char = character set number * 256 + ASCII number of the character
(character sets are numbered 0 to 3).
If Char > 1023 then the load_char command will be ignored
code RTC5_PARAM_ERROR).
• The addresses in the protected buffer area where the character definitions are to be
stored are automatically determined and internally managed. This management is inde-
pendent of that for indexed subroutines (see load_sub) and text string definitions (see
load_text_table).
• Indexed character definitions must be terminated with a
a prerequisite for actual storage of the commands, entry of the start address and other
information (e.g., the number of commands) into the internal management table, and
initiating a flush of the list input buffer (see
be altered without a preceding
index will not be available.
• An indexed character definition will not be stored if the protected buffer area ("List 3")
was not previously configured for a sufficient size beyond "List 1" and "List 2".
• If list_return
definition will be deleted from the internal management table.
• Observe all notes in the section
® ®
RTC 4 RTC 5 new command
References list_return, load_sub,
®
RTC 5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
Index of the indexed character as an unsigned 32-bit value,
permissible range [0 ... 1023]
list_return
is the next command after load_char, then the corresponding character
"Character Sets and Text Strings", page
load_text_table
(get_last_error
list_return command. This is
page 71). Otherwise (the input pointer will
command) the character definition with this
return
80.
327