RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
498
Undelayed
Short
List Command
set_vector_control
Function initializes or deactivates vector-defined laser control (see page 147).
Call
set_vector_control( Ctrl, Value)
Parameters
Ctrl
Control parameter (unsigned 32-bit value) for initializing or deactivating vector-
defined laser control (for
Ctrl
= 1…6: identical with set_auto_laser_control):
= 1…7: defines which signal parameter is to be varied via vector-defined laser
control:
= 1: 12-bit output value at the ANALOG OUT1 output port
= 2: 12-bit output value at the ANALOG OUT2 output port
= 3: output value at the 8-bit digital output port
= 4: pulse length (
PulseLength
) of the laser signals LASER1 and LASER2
= 5: output period (
HalfPeriod
) of the laser signals LASER1 and LASER2
= 6: output value at the 16-bit digital output
= 7: focus shift
= 0 or > 7: deactivates vector-defined laser control (for
Ctrl
> 7: get_last_error
return code
RTC5_PARAM_ERROR
)
Value
defines the starting value for the parameter selected via
Ctrl
(unsigned 32-bit value);
allowed values:
for
Ctrl
= 1/2: 12-bit values [0 … 4095]
for
Ctrl
= 3: 8-bit values [0 … 255]
for
Ctrl
=4: [0…(2
32
–1)], 1 bit equals 1/64 µs
for
Ctrl
=5: [0…(2
32
–1)], 1 bit equals 1/64 µs
for
Ctrl
= 6: 16-bit values [0 … (2
16
–1)]
for
Ctrl
= 7: [0 … 65535],
Value
= focus shift + 32768
Comments • If
Ctrl
is an invalid value, then vector-defined laser control will be deactivated (
Ctrl
= 0,
initialization state). Otherwise,
Value
will be applied as the starting value of the next para-
command. If
Value
is invalid, then it will be clipped to the maximum allowed value.
• The command only affects para-mark and para-jump commands.
• If position- and/or speed-dependent or encoder-speed-dependent laser control has been acti-
vated for the same control parameter (
Ctrl
= 1…6), then set_vector_control will set the
100% value of the position- and/or speed-dependent or encoder-speed-dependent laser
control to
Value
.
•If
Ctrl
= 7, then the focus shift for subsequent parameterized 2D and 3D mark and jump
commands is linearly varied (as with set_defocus and set_defocus_list, see comments there)
up to the specified end value (this requires enabling the 3D option as well as loading and
assigning a 3D correction file). If, for the first parameterized mark or jump command, the
currently set focus shift doesn’t match the initial value (
Value)
specified via
set_vector_control, then the parameterized command will begin with a hard (z coordinate)
jump to
Value
. Any settings made via set_defocus or set_defocus_list will be lost.
Unlike signed values in the range [–32768 … 32767] for set_defocus and set_defocus_list,
the focus shift (
Value
) specified for set_vector_control must be an unsigned number shifted
upward by 32768:
Value
= focus shift + 32768.
• Automatic laser control shouldn’t be combined with the variable laser power of
set_multi_mcbsp_in or the “freely definable wobbel shape”.