Scanlab RTC 5 PC Interface Board, Installation And Operation Manual

Page: 363 / 622

RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
363
innovators for industry
Normal
List Command mark_time
Function marks a part of the time previously stored via time_fix , time_fix_f or time_fix_f_off in the
specified format at the current position.
Call
mark_time( Part, Mode )
Parameters
Part
this parameter (unsigned 32-bit value, allowed range: [0 … 4]) specifies
which part of the time to mark:
= 0:
hours (24-h time, no a.m./p.m.)
= 1: minutes
= 2: seconds
= 3: hours (12-h time, no a.m./p.m.)
= 4: a.m./p.m. (automatically switched in accordance with 24-h time)
Mode
Format choice as an unsigned 32-bit value (allowed range: [0 … 3], only
affects
Part
= 0 … 3):
a) Number of leading zeros:
Bit#0 = 0: Leading zeros are suppressed.
Bit#0 = 1: always two digits
b) Character set choice for marking of digits:
Bit#1 = 0: The indexed text strings for digits [0…9], as defined via
load_text_table or set_text_table_pointer , will be marked.
Bit#1 = 1: The indexed characters for digits [0…9], as defined via load_char
or set_char_pointer , will be marked. The desired character set can be
specified with select_char_set .
a.m./p.m. (Part = 4) can only be marked in accordance with the indexed text strings (Index = 40, 41)
defined via
load_text_table or set_text_table_pointer . Here, the Parameter Mode is ignored.
Comments • Before marking times (after every boot-up), the RTC
®
5 and PC times should be synchro-
nized (see time_update ) and the current (to be marked) time should be stored with
time_fix , time_fix_f or time_fix_f_off (see "Marking Dates, Times and Serial Numbers",
page 150 ).
• The complete time can be marked via multiple calls of the mark_time command.
• The mark_time command reads (according to the stored time and according to the
selected time part) the starting address of the corresponding indexed text string (or –
for
Part
= 0… 3 and
Mode
= 2 or 3 – of the corresponding 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 starts the corresponding
command list. The command lists must contain marking instructions for digits 0…9 and
for a.m./p.m. (see
page 80 ). Non-defined text strings or characters 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 with
mark_time ), via select_char_set (also see "Character Sets and Text Strings", page 80 ).
• If
Part
> 4 and/or
Mode
> 3, then mark_time 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_time . If time markings need to execute at various locations within the image
field, then the corresponding indexed text strings (or characters) can only contain rela-
tive mark, arc or jump commands or
mark_time_abs must be used instead.