RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
363
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.
To Next Page
Loading...
