RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
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
Index of the indexed character as an unsigned 32-bit value,
permissible range [0 … 1023]
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 (get_last_error return
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 list_return command. This is
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 page 71). Otherwise (the input pointer will
be altered without a preceding list_return command) the character definition with this
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 is the next command after load_char, then the corresponding character
definition will be deleted from the internal management table.
• Observe all notes in the section "Character Sets and Text Strings", page 80.
RTC
®
4
RTC
®
5new command
References list_return, load_sub, load_text_table
To Next Page
Loading...
