Scanlab RTC6 PCIe Board - Set_Offset_Xyz

RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
707
innovators for industry
Ctrl Command set_offset_xyz
Function Defines:
• The offset for coordinate transformations, see Chapter 8.2 ”Coordinate
Transformations”, page 224.
• The global offset in virtual Image Field, see Section ”Coordinate Transformations in the
Virtual Image Field”, page 169
Call set_offset_xyz( HeadNo, XOffset, YOffset, ZOffset, at_once )
Parameters HeadNo Number of the scan head connector.
As an unsigned 32-bit value.
= 1: The definition only affects the first scan head connector.
= 2: The definition only affects the second scan head connector.
= 0, 3: The definition affects both scan head connectors.
= 4: The definition affects the virtual Image Field.
Only the three least significant bits are evaluated.
XOffset Offsets for the x direction (coordinate translation relative to the origin of the
Cartesian coordinate system). In bits.
As a signed 32-bit value.
Allowed value range: [–268,435,456…+268,435,455].
Out-of-range values are clipped to the boundary values.
YOffset Like XOffset (analogously).
ZOffset Offset for the z direction (coordinate translation relative to the origin of the
Cartesian coordinate system). In bits.
As a signed 32-bit value.
Allowed value range: [–524,288…+524,287].
Out-of-range values are clipped to the boundary values.
at_once Like set_matrix.
Comments • ZOffset is stored only once, applying jointly for both scan head connectors ( HeadNo is
therefore ignored).
• ZOffset  0 causes a shift of the working plane (opposite to the direction of the laser
beam). A positive value increases the z coordinate. For a hypothetical control value
of(0|0|0), this would be by d = ZOffset / K
to the plane z = +d.
On the calibration factor K, see Chapter 7.3.2 ”Image Field Size and Image Field
Calibration”, page 167; furthermore, also 3 and 6 in Chapter 7.3.6 ”Output Values to
the Scan System”, page 181.
• If HeadNo = 4, then ZOffset is ignored.
• For at_once , see set_matrix.
RTC4RTC6 New command.
In RTC4 Compatibility Mode,the RTC6 multiplies the specified values for
XOffset , YOffset , ZOffset by 16. The allowed value ranges decrease accordingly.
RTC5RTC6 Unchanged functionality.
In RTC4 Compatibility Mode,the RTC6 multiplies the specified value for ZOffset by 16.
The allowed value range decreases accordingly.
Version info Available as of DLL 600, OUT 600, RBF 600.
References set_offset_xyz_list, set_offset, set_angle, set_matrix, set_scale, set_defocus