RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
351
Undelayed
Short
List Command
mark_char
Function marks an indexed character.
Call
mark_char( Char )
Parameter
Char
Index of the indexed character to be marked (as an unsigned 32-bit value,
allowed range: [0 … 1023]). The following applies:
Char
= character set number * 256 + ASCII number of the character
(character sets are numbered 0 to 3).
Comments • The mark_char command reads the indexed character’s starting address from the
internal management table based on the supplied index and then calls the command
list_call (also see the comments there), which then starts the corresponding command
list.
•The mark_char command starts indexed characters in protected memory (that were
loaded and/or referenced via load_char, load_disk or copy_dst_src) as well as indexed
subroutines in the unprotected list area (that were referenced as characters via
set_char_pointer or copy_dst_src).
• If no character is referenced for the supplied index, then the jump will be suppressed
and execution will continue at the command located after the calling position. In some
circumstances, a list_nop might be executed (siehe page 217).
get_char_pointer (
Char
) can be used to determine whether a character has been
referenced for a particular index. If no character has been referenced, this command
returns the value “–1” (d.h. 2
32
–1).
•If
Char
> 1023, then mark_char will, already during loading, be replaced by a list_nop
(get_last_error return code
RTC5_PARAM_ERROR
).
• Absolute vector and arc commands will execute absolutely after being called with
mark_char. If the character needs to execute at various locations within the image field,
then either the command list can only contain relative mark, arc or jump commands or
mark_char_abs must be used instead.
• The called character should not contain mark_text commands that also contain this
character. Such text will not be marked. The called character itself then might not be
complete.
• Also see "Character Sets and Text Strings", page 80.
RTC
®
4
RTC
®
5 new command
References mark_char_abs, mark_text, set_char_pointer, get_char_pointer
To Next Page
Loading...
