Scanlab RTC6 PCIe Board - Page 831

RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
831
innovators for industry
Ctrl Command transform
Function Performs a backward transformation of individual position values.
Call TransformErrorCode = transform( &Sig1, &Sig2, Ptr, Code )
Parameters
and
Returned
parameter
values
Sig1 Parameter: to-be-transformed position value.
As a pointer to a signed 32-bit value.
Returned parameter value: transformed position value.
As a signed 32-bit value.
The input values are overwritten.
Sig2 Like Sig1 (analogously).
Parameters Ptr Pointer (in C and C++ data type ULONG_PTR, an unsigned 32-bit value or
unsigned 64-bit value) to the area of PC main memory to which the correction
and transformation settings for backward transformation were previously
transferred by upload_transform.
Code Controls aspects of the backward transformation, particularly which partial
transformations to perform: If a partial transformation is not to be performed,
then its corresponding bit (#2…#5) should be set to 1.
As an unsigned 32-bit value.
Code has the same meaning as get_transform/get_transform_offset
( Sig1 corresponds to Ptr1 , Sig2 corresponds to Ptr2 ).
If Bit #0 = 0, then both supplied position values ( Sig1 and Sig2 ) are backward
transformed as xy coordinates:
Bit #1 = 0: The value specified with Sig1 is backward transformed as
x coordinate.
The value specified with Sig2 is backward transformed as
y coordinate.
= 1: The value specified with Sig1 is backward transformed as
y coordinate.
The value specified with Sig2 is backward transformed as
x coordinate.
Bit #2 = 0: Gain/offset correction of automatic self-calibration is
backward transformed.
Bit #3 = 0: Image Field correction is backward transformed.
Bit #4 = 0: Offset of the defined coordinate transformation is
backward transformed.
Bit #5 = 0: Total matrix of the defined coordinate transformation is
backward transformed.
Bit #6
…
Bit #31
Reserved.
…
Reserved.