Scanlab RTC6 PCIe Board - Set_Matrix

RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
682
innovators for industry
Ctrl Command set_matrix
Function Defines the coefficients of the
• General transformation matrix M
T
for coordinate transformations, see Chapter 8.2
”Coordinate Transformations”, page 224
• Global transformation matrix in virtual Image Field, see Section ”Coordinate
Transformations in the Virtual Image Field”, page 169
Call set_matrix( HeadNo, M11, M12, M21, M22, 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 (see also comments).
Only the three least significant bits are evaluated.
M11 Matrix coefficient of the general transformation matrix M
T
.
As a 64-bit IEEE floating point value.
Allowed value range: [–50…+50] in the real Image Field and [–2.0…+2.0] in
the virtual Image Field. With invalid value, set_matrix is ignored.
M12 Like M11 (analogously).
M21 Like M11 (analogously).
M22 Like M11 (analogously).
at_once Defines when the defined transformation becomes effective.
As an unsigned 32-bit value.
For HeadNo = 0…3, the following applies:
= 0: The new total transformation (total matrix and offset) is only
calculated when the next list command is executed and applied to the
position which is current at that time.
= 1: The new total transformation is calculated immediately
(or prior the next list command, if currently the
BUSY list execution status or INTERNAL-BUSY list execution status
is set) and applied to the current position.
Signals for “Laser Active” Operation are switched off in advance.
= 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, goto_xy or goto_xyz is executed.
= 3: Like at_once = 1, but the Laser Control Signals remain unchanged.
> 3: Like at_once = 2.
For HeadNo = 4, the following applies:
= 0: Only saved. Is applied at the next Processing-on-the-fly Session start
to the current position.
= 1: Is applied immediately to the current position if currently no list is
BUSY list execution status or no board is
INTERNAL-BUSY list execution status. Otherwise, like 0.
= 2, 3: Like 0.