RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
359
Comments • The first serial number to be marked must have been previously specified via set_serial,
set_serial_step or set_serial_step_list; otherwise, the starting serial number will be 0.
The starting serial number can have a maximum length of 10 digits.
• With every call of mark_serial, the serial number will be formatted in accordance with
M
3
and when M
2
= 0 it will be automatically incremented before the actual marking.
Here, the increment size is 1 unless otherwise specified via set_serial_step or
set_serial_step_list.
• The current serial number can be queried with get_list_serial, e.g. after an aborted list
to determine if the current number was incremented or not.
• If the incremented serial number exceeds 10
digits
, then marking begins again at 0. The
control command set_max_counts allows specification of the maximum number of
external list starts and thus the maximum number of markings. Here, all markings of all
serial-number-sets contribute jointly to the count.
•If
digits
= 0, then a “markless” marking is executed. If M
2
= 0, then the serial number
will be incremented by 1 (any increment size defined by set_serial_step or
set_serial_step_list will not be used in this case!). This is useful if a single serial number
should be omitted and can also be used (as with the RTC
®
4) for indirectly defining the
increment size (or with the RTC
®
5 an additional increment size) for incrementing serial
numbers.
• For each to-be-marked serial number digit, the mark_serial command reads the
starting address of the corresponding indexed text string (or – for M
1
= 1 – of the corre-
sponding indexed character) from the internal management table and then calls the
command list_call (also see the comments there) an appropriate number of times,
which then starts the corresponding command list. The command lists must contain
marking instructions for digits 0…9 (see page 80). Non-defined text strings or charac-
ters are ignored (i.e. not marked). The called indexed text strings can also contain calls
to indexed characters (mark_char or mark_char_abs) and complete texts (mark_text
or mark_text_abs). In the latter case, the character set can be switched if needed
(before marking via mark_serial) with select_char_set (also see "Character Sets and
Text Strings", page 80).
• For invalid
Mode
values, the mark_serial 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_serial. If serial number markings need to execute at various locations within the
image field, then the corresponding indexed text strings (or characters) can only
contain relative mark, arc or jump commands or mark_serial_abs must be used
instead.
RTC
®
4
RTC
®
5 unchanged functionality (except for the extended range of values)
(the command was previously only available for the RTC
®
SCANalone Board, i.e. the
standalone version of the RTC
®
4 board)
References set_serial, set_serial_step, set_serial_step_list, get_list_serial, set_max_counts,
get_counts, load_text_table, set_text_table_pointer, mark_serial_abs
Normal
List Command
mark_serial
To Next Page
Loading...
