RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
354
Comments • Before marking dates (after every boot-up), the RTC
®
5 and PC times should be synchro-
nized (see time_update) and the current (to be marked) date value 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 date can be marked via multiple calls of the mark_date command.
•The mark_date command reads (according to the stored date and according to the
selected date part) the starting address of the corresponding indexed text string or
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 and for the month and day-of-the-week designations (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 when needed (before marking via mark_date) with select_char_set (also
see "Character Sets and Text Strings", page 80).
•If
Part
> 7 and/or
Mode
> 3, then mark_date 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_date. If date 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_date_abs must be used instead.
• When marking Gregorian dates or Julian days, the transition to the next day occurs at
24:00 o’clock. Leap years are represented in both date styles.
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 time_fix, time_fix_f, time_fix_f_off, load_text_table, set_text_table_pointer,
mark_date_abs
Normal
List Command
mark_date_abs
Function marks a part of the date previously stored via time_fix, time_fix_f or time_fix_f_off in the
selected format at the current position. In the called indexed text strings or characters (see
below), any absolute vector and arc commands will receive an offset (based on the current
coordinates at the time of the call).
Call
mark_date_abs( Part, Mode )
Parameters
Part
See mark_date.
Mode
See mark_date.
Comments • The mark_date_abs command works like mark_date; however, internal calling of the
indexed text strings (or characters) is via list_call_abs instead of list_call. If the
command lists of the called indexed text strings (or characters) contain no absolute
commands, then there is no difference between mark_date_abs and mark_date.
RTC
®
4
RTC
®
5 new command
References mark_date
Normal
List Command
mark_date
To Next Page
Loading...
