Mark_Char - Scanlab RTC6 PCIe Board Installation And Operation Manual

Undelayed

mark_char

Short List
Command
Function Marks an indexed character.
mark_char( Char )
Call
Char
Parameters
Comments • mark_char reads the indexed character's starting address from the internal
management table based on the supplied index and then calls
comments there), which then starts the corresponding command list.
• mark_char starts indexed characters in protected memory (that were loaded and/or
referenced by load_char,
in the unprotected
set_char_pointer
• If no character is referenced for the supplied index, then the jump is suppressed and
execution continues at the command located after the calling position. In some
circumstances, a
Variable and Multiple List Commands", page
• get_char_pointer
referenced for a particular index. If no character has been referenced,
get_char_pointer
• If Char > 1023, then mark_char is, already during loading, replaced by a
(get_last_error
• Absolute
called with mark_char. If the character needs to execute at various locations within the
Image
[*]mark[*]
be used instead.
• The called character should not contain
character. Such text is not marked. The called character itself then might not be
complete.
• See also
RTC4RTC6 New command.
RTC5RTC6 Unchanged functionality.
Version info Available as of DLL 600, OUT 600, RBF 600.
References mark_char_abs, mark_text, set_char_pointer,
RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
Index of the indexed character to be marked.
As an unsigned 32-bit value.
Allowed value range: [0...1023]).
The following applies: Char = character set number × 256 + ASCII number of
the character (character sets are numbered 0...3).
load_disk
RTC6 List Memory
or copy_dst_src).
list_continue might be executed, see
( Char ) can be used to determine whether a character has been
returns the value "–1" (that is, 2
return code RTC6_PARAM_ERROR).
Vector Commands and
Field, then either the command list can only contain relative
Commands, "Arc" Commands or
Chapter 6.5.2 "Character Sets and Text Strings", page
or copy_dst_src) as well as indexed subroutines
area (that were referenced as characters by
Section "Normal, Short,
302.
32
–1).
"Arc" Commands execute absolutely after being
Jump Commands or
mark_text commands that also contain this
get_char_pointer
list_call (see also the
list_nop
mark_char_abs must
118.
526