Scanlab RTC 5 PC Interface Board Installation And Operation Manual page 363

Normal mark_time
List Command
Function marks a part of the time previously stored via time_fix,
specified format at the current position.
Call
mark_time( Part, Mode )
Parameters
Part
Mode
Comments • Before marking times (after every boot-up), the RTC
nized (see time_update) and the current (to be marked) time should be stored with
time_fix,
page
• 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
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
marked). The called indexed text strings can also contain calls to indexed characters
(mark_char
the latter case, the character set can be switched, if needed (before marking with
mark_time), via
• If Part > 4 and/or Mode > 3, then mark_time will, already during loading, be replaced
by a list_nop (get_last_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
®
RTC 5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
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)
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
Bit#1 = 1: The indexed characters for digits [0...9], as defined via
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.
time_fix_f or time_fix_f_off
150).
page 80). Non-defined text strings or characters are ignored (i.e. not
or mark_char_abs) and complete texts
select_char_set
return code RTC5_PARAM_ERROR).
time_fix_f
or set_text_table_pointer, will be marked.
®
5 and PC times should be synchro-
(see "Marking Dates, Times and Serial Numbers",
list_call
(mark_text
(also see "Character Sets and Text Strings", page
mark_time_abs must be used instead.
or time_fix_f_off in the
load_char
(also see the
or mark_text_abs). In
80).
363