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

Ctrl Command transform
Function performs a backward transformation of individual position values.
Call
TransformErrorCode = transform( &Sig1, &Sig2, Ptr, Code )
Parameters
Sig1,
+
Sig2
Returned para-
meter values
Parameters
Ptr
Code
Result error code as an unsigned 32-bit value:
Value
0
1
2
3
4
®
RTC 5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
Parameters: to-be-transformed position values as pointers to signed 32-bit
values.
Returned parameter values: transformed position values as signed 32-bit
values (the input values will be overwritten).
Pointer (in C and C++ data type ULONG_PTR, i.e. an unsigned 32-bit or 64-bit
value) to the area of PC main memory to which the correction and
transformation settings for backward transformation were previously
transferred via upload_transform.
This parameter (an unsigned 32-bit value) 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.
The parameter's meaning is similar to that of
corresponds to Ptr1 and Sig2 to Ptr2).
If bit #0 = 0, then both supplied position values (Sig1 and Sig2) will be
backward transformed as XY coordinates:
Bit #1 = 0: The value supplied via
coordinate and the value supplied via
= 1: The value supplied via
coordinate and the value supplied via
Bit #2 = 0: The gain/offset correction of automatic self-calibration will be backward
transformed.
Bit #3 = 0: The image field correction will be backward transformed.
Bit #4 = 0: The offset of the defined coordinate transformation will be backward
transformed.
Bit #5 = 0: The total matrix of the defined coordinate transformation will be backward
transformed.
Bits #6..#31 reserved
If bit #0 = 1, then one of the two supplied position values (specifiable as Sig1
or Sig2) will be backward transformed as the Z coordinate:
Bit #1 = 0: The value supplied via
coordinate (
= 1: The value supplied via
coordinate (
Bit #2 = 0: The offset to the focal length defined via
will be backward transformed.
Bit #3 = 0: The ABC correction will be backward transformed.
Bit #4 = 0: The offset to the Z coordinate defined via
set_offset_xyz_list
Bits #5..#31 reserved
Description
Success.
Ptr = NULL (no memory area specified)
Ptr
No valid data at (upload_transform
Ptr
Erroneous data at (a corresponding error indication has been stored via upload_transform)
Z-axis inversion not possible
get_transform
Sig1
will be backward transformed as the X
Sig2
as the Y coordinate.
Sig1 will be backward transformed as the Y
Sig2 as the X coordinate.
Sig1
will be backward transformed as the Z
Sig2
remains unchanged).
Sig2
will be backward transformed as the Z
Sig1
remains unchanged).
set_defocus
set_offset_xyz
will be backward transformed.
did not execute)
(Sig1
or set_defocus_list
or
550