Scanlab RTC 5 PC Interface Board, Инструкция по установке и эксплуатации, Страница: 449 / 622

RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
449
innovators for industry
Ctrl Command set_matrix
Function sets the coefficients of the general transformation matrix M
T
for all subsequent coordinate
transformations (see "Coordinate Transformations", page 161 ).
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 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.
M11, M12,
M21, M22
Matrix coefficients of the general transformation matrix M
T
as 64-bit IEEE floating point values; allowed range: [–50 … +50];
if the parameter is set to an invalid value, the command will be ignored.
at_once
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 , goto_xy or goto_xyz command is executed.
= 3: As with
at_once
= 1, but the laser control signals remain unaffected.
> 3: See
at_once
= 2
Comments • See "Coordinate Transformations", page 161 .
• The coordinate transformation defined by
HeadNo
= 4 is only in effect during a
Processing-on-the-fly application initiated via set_fly_2d (see the section "Coordinate
Transformations in the Virtual Image Field" on page 185 ). Here, the
at_once
parameter
is ignored.
RTC
®
4

RTC
®
5 unchanged primary functionality (matrix definition), however:
• The parameters
HeadNo
and
at_once
are new.
• Reduced value range for coefficients.
• Also see "Notes for RTC
®
4 Users:", page 164 .
Version info Last changes:
• With version DLL 525, OUT 527: behavior for
at_once
= 3
• With Version DLL 536, OUT 536:
HeadNo
= 4
References set_matrix_list , set_angle , set_offset , set_scale