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

Ctrl Command set_offset_xyz
Function defines an offset for all subsequent coordinate transformations (see
Transformations", page
Call
set_offset_xyz( HeadNo, XOffset, YOffset, ZOffset, at_once )
Parameters
HeadNo
XOffset,
YOffset
ZOffset
at_once
Comments • See "Coordinate Transformations", page
• ZOffset is stored only once, applying jointly for both scan head connectors (HeadNo is
therefore ignored).
• ZOffset <> 0 shifts the working plane (in the direction opposite to the laser beam); for
a hypothetical control value of(0|0|0), this would be by d = Shift / K
z = d in the direction of the Z coordinate axis (and in the direction opposite to the focus
shift specified by set_defocus). Here, K
see "3D Marking Commands", page
• The coordinate transformation defined by HeadNo = 4 is only in effect during a
Processing-on-the-fly application initiated via
Transformations in the Virtual Image Field" on page
is ignored. If HeadNo = 4, then ZOffset will be ignored.
®
RTC 5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
161).
Number of the scan head connector as an unsigned 32-bit value:
= 1: The definition only affects the primary scan head connector.
= 2: The definition only affects the secondary scan head connector
(activation required)
= 0, 3: The definition affects both scan head connectors.
= 4: The definition affects the virtual image field (also see comments)
Only the three least significant bits are evaluated.
Offsets for the X and Y directions (coordinate translation relative to the origin
of the cartesian coordinate system) in bits (as a signed 32-bit value); allowed
range: [–524288 ... +524287];
excessive values will be clipped.
Offset for the Z directions (coordinate translation relative to the origin of the
cartesian coordinate system) in bits (as a signed 32-bit value); allowed range:
[–32768 ... +32767];
excessive values will be clipped.
This parameter (unsigned 32-bit value) determines when the defined
transformation becomes effective:
= 0: The new total transformation (total matrix and offset) is only
calculated and applied to the current position when the next list
command is executed.
= 1: The new total transformation is calculated immediately (or before the
next list command if a list is currently BUSY or the board is INTERNAL-
BUSY) and applied to the current position. The "laser active"
laser control signals will first be switched off if necessary.
= 2: The new total transformation (total matrix and offset) is only
calculated and applied to the current position when the next
jump_abs, jump_rel,
= 3: As with at_once = 1, but the laser control signals remain unaffected.
> 3: See at_once = 2
172).
goto_xy or goto_xyz command is executed.
161.
is the calibration factor for the Z direction (also
z
set_fly_2d (see the
185). Here, the at_once parameter
"Coordinate
to the plane
z
section "Coordinate
464