RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
550
innovators for industry
Ctrl Command transform
Function
performs a backward transformation of individual position values.
Call
TransformErrorCode = transform( &Sig1, &Sig2, Ptr, Code )
Parameters
+
Returned para-
meter values
Sig1,
Sig2
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).
Parameters
Ptr
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
Code
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
Sig1
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
Sig1
will be backward transformed as the X
coordinate and the value supplied via
Sig2
as the Y coordinate.
= 1:
The value supplied via
Sig1
will be backward transformed as the Y
coordinate and the value supplied via
Sig2
as the X coordinate.
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
Sig1
will be backward transformed as the Z
coordinate (
Sig2
remains unchanged).
= 1:
The value supplied via
Sig2
will be backward transformed as the Z
coordinate (
Sig1
remains unchanged).
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
will be backward transformed.
Bits #5..#31
reserved
Result
error code as an unsigned 32-bit value:
Value
Description
0
Success.
1
Ptr
= NULL (no memory area specified)
2
No valid data at
Ptr
3
Erroneous data at
Ptr
(a corresponding error indication has been stored via
)
4
Z-axis inversion not possible
