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

Ctrl Command set_start_list_pos
Function opens the list buffer for writing of list commands and sets the input pointer to the
specified (relative) position in the desired list ("List 1" or "List 2"). The next list command
will be stored at this address and all further list commands at the subsequent addresses in
the selected list.
Call
set_start_list_pos( ListNo, Pos )
Parameters
ListNo
Pos
Comments • The selected list will be unconditionally opened for loading. There is no checking of
whether the list is currently being processed (also see
load_list).
• The input pointer cannot be set to the protected area ("List 3"). If the protected area is
to be written to (at the full risk of the user) with set_start_list_pos, then this area can
be temporarily allocated to "List 2" via ConfigList( Mem1, –1 ). After writing, configu-
ration of the area's protection should be restored: ConfigList( Mem1, Mem2 ).
• For uneven ListNo values, "List 1" is opened, otherwise "List 2". This facilitates contin-
uous automatic list changing though incrementing counts.
• If "List 2" has not been assigned memory (Mem2 = 0, see config_list) then "List 1" will
be opened.
• If Pos is specified as being larger than the memory area of the respective list (Pos > Mem1
or Pos > Mem2), then Pos will be set to 0.
• The status values of the selected list (also see read_status) will be set as follows: LOAD
set, READY reset, USED reset. The LOAD status of the other corresponding list will be
reset.
• The set_start_list_pos command triggers a flush of the list input buffer (see
• set_start_list_pos also covers the specialized variants set_start_list_1,
set_start_list_2,
• CAUTION: If the end of the respective list buffer area is reached, the list input pointer is
automatically reset to the start of the same list buffer area. Make sure not to overwrite
any commands still needed by your application.
® ®
RTC 4 RTC 5 new command
References execute_list_pos,
®
RTC 5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
Number of the list for which the input pointer should be set, as an unsigned
32-bit value
permissible values: [uneven: "List 1", even: "List 2"]
Position of the input pointer (offset relative to the start of the respective list)
as an unsigned 32-bit value; permissible range: [0 ... (2
set_start_list and set_input_pointer.
read_status
20
–1)]
"Loading Lists", page 71 and
page 71).
490