Scanlab RTC 5 PC Interface Board - set_jump_mode

RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
436
innovators for industry
Control
Command
set_jump_mode
Function enables and activates or disables and deactivates jump mode for 2D jumps and sets the
related parameters (before activation, a check might be performed, also see page 157).
Requirements Enabling is only possible if a jump-tuning-equipped intelliSCAN
®
, intellicube
®
,
intelliWELD
®
or intelliDRILL
®
scan system (with software version 2078 or higher) is
attached to at least one of the two scan head connectors. Otherwise, the command has no
effect.
Call
ErrorCode = set_jump_mode(Flag, Length, VA1, VA2, VB1, VB2, JA1, JA2, JB1, JB2)
Parameters Flag Switching flag as a signed 32-bit number, allowed values:
= –1: Jump mode will be disabled. Afterward, switching the
Flag via
set_jump_mode_list will no longer be possible.
= 0: Jump mode will be enabled (possibly only after successfully passing a
check, see below), but deactivated. Afterward, switching the
Flag via
set_jump_mode_list is still possible.
= 1: Jump mode will be enabled and activated (possibly only after
successfully passing a check, see below). Afterward, switching the
Flag via set_jump_mode_list is still possible.
Length Jump length limit (per axis) under which 2D jumps – even with activated jump
mode – are performed in vector mode.
VA1, VA2,
VB1, VB2,
JA1, JA2,
JB1, JB2
Numbers (as unsigned 32-bit values) of the tunings that should be used for
jump execution in jump mode:
V: Vector tuning that will be set at the end of a 2D jump
J: Jump tuning that will be set at the beginning of a 2D jump
A primary scan head connector
B secondary scan head connector
1: X axis (STATUS channel, galvanometer scanner 2)
2: Y axis (STATUS1 channel, galvanometer scanner 1)
allowed values:
= – 1: Tuning will neither be checked nor used
= 0…3: After passing a check, tuning will be used for jump mode
(the allowed value range also depends on the number
of tunings with which the attached scan system is equipped).
Return Error code as unsigned 32-bit value:
0 no error: Flag successfully switched to 0 (jump mode deactivated, vector mode activated)
1 no error: Flag successfully switched to 1 (jump mode activated, vector mode deactivated)
–1 Flag successfully (as requested) switched to –1 (jump mode deactivated and disabled)
–2 Busy error: board BUSY or INTERNAL BUSY (get_last_error return code: RTC5_BUSY)
–3 Board not responding: possibly no program loaded or PCI error (get_last_error return code:
RTC5_TIMEOUT)
–4 Access error: board reserved for another application (get_last_error return code:
RTC5_ACCESS_DENIED)