Scanlab RTC6 PCIe Board - Mark_Char

RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
526
innovators for industry
Undelayed
Short List
Command
mark_char
Function Marks an indexed character.
Call mark_char( Char )
Parameters Char 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).
Comments • mark_char reads the indexed character’s starting address from the internal
management table based on the supplied index and then calls list_call (see also the
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, load_disk or copy_dst_src) as well as indexed subroutines
in the unprotected RTC6 List Memory area (that were referenced as characters by
set_char_pointer or copy_dst_src).
• 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 list_continue might be executed, see Section ”Normal, Short,
Variable and Multiple List Commands”, page 302.
• 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,
get_char_pointer returns the value “–1” (that is, 2
32
–1).
• If Char > 1023, then mark_char is, already during loading, replaced by a list_nop
(get_last_error return code RTC6_PARAM_ERROR ).
• Absolute Vector Commands and “Arc” Commands 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[*] Commands, “Arc” Commands 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 is not marked. The called character itself then might not be
complete.
• See also Chapter 6.5.2 ”Character Sets and Text Strings”, page 118.
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, get_char_pointer