RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
327
innovators for industry
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
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
) and text string definitions (see
).
• Indexed character definitions must be terminated with a
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
). Otherwise (the input pointer will
be altered without a preceding
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
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
®
5 new command
References
