RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
288
Parameters
Number
Number [1…2
20
] of to-be-backward-transformed position values as an
unsigned 32-bit value; the measured values with indices 0 to (
Number
–1) will be
backward transformed.
Ptr1,
Ptr2
Pointers (in C and C++ data type ULONG_PTR, i.e. unsigned 32-bit or 64-bit
values) to the two areas of PC main memory to which the backward
transformed values should be transferred (also see
Code
).
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 upload_transform.
Code
This parameter (an unsigned 32-bit value) controls aspects of backward
transformation, particularly which partial transformations should be
performed: If a partial transformation should not be performed, then its
corresponding bit (#2…#5) must be set to 1. This parameter has the same
meaning as in transform (
Ptr1
corresponds to
Sig
1
and
Ptr2
to
Sig
2
).
For bit #0 = 0, the measurement value pairs recorded via set_trigger will be
backward transformed as XY coordinates:
Bit #1 = 0: Values recorded via measurement channel 1 (
Signal1
) will be transferred
to the PC using
Ptr1
and then backward transformed as X coordinates.
Values recorded via measurement channel 2 (
Signal2
) will be transferred
to the PC using
Ptr2
and then backward transformed as Y coordinates.
= 1: Values recorded via measurement channel 1 (
Signal1
) will be transferred
to the PC using
Ptr1
and then backward transformed as Y coordinates.
Values recorded via measurement channel 2 (
Signal2
) will be transferred
to the PC using
Ptr2
and then backward transformed as X coordinates.
Bit #2 = 0: 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 (only) the values recorded with set_trigger via one of the
two measurement channels (either channel 1 or 2) will be backward
transformed as Z coordinates:
Bit #1 = 0: Values recorded via measurement channel 1 (
Signal1
) will be transferred
to the PC using
Ptr1
and then backward transformed as Z coordinates.
Values recorded via measurement channel 2 (
Signal2
) will be transferred
untransformed to the PC using
Ptr2
.
= 1: Values recorded via measurement channel 2 (
Signal2
) will be transferred
to the PC using
Ptr1
and then backward transformed as Z coordinates.
Values recorded via measurement channel 1 (
Signal1
) will be transferred
untransformed to the PC using
Ptr2
.
Bit #2 = 0: The offset to the focal length defined via set_defocus or set_defocus_list
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 or
set_offset_xyz_list will be backward transformed.
Bits #5…#31 reserved
Ctrl Command get_transform