RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
835
Ctrl Command upload_transform
Function Transfers from the RTC6 board to the PC all correction and transformation settings
currently assigned to the scan system.
Call
UploadErrorCode = upload_transform( HeadNo, Ptr )
Parameters
HeadNo
Number of the scan head connector whose settings should be queried.
As an unsigned 32-bit value.
Allowed values:
= 1: First scan head connector.
= 2: Second scan head connector.
Ptr
Pointer (in C and C++ data type ULONG_PTR, an unsigned 32-bit value or
unsigned 64-bit value) to the PC’s area of memory that should receive the
queried settings.
Result Error code.
As an unsigned 32-bit value.
Bit #0 =1: X gain = 0 (gain of automatic self-calibration for
Galvanometer scanner 2).
Bit #1 =1: Y gain = 0 (gain of automatic self-calibration for
Galvanometer scanner 1).
Bit #2 =1: The total matrix of the defined coordinate transformation is
noninvertable.
Bit #3 =1: No correction table assigned.
Bit #4 =1: The ABC values (z axis) are noninvertable.
Bit #5 =1: Error querying correction table.
Bit #6 =1: Parameter error: invalid
HeadNo
or
Ptr
= 0.
Bit #7 =1: Busy error, board has BUSY list execution status or
INTERNAL-BUSY list execution status
(get_last_error return code
RTC6_BUSY
).
Bit #8
…
Bit #31
Reserved.
…
Reserved.
Comments • The queried and transferred data can be used for backward transforming
actual position values, see also Chapter 8.1.3 ”Monitoring the Positioning”, page 214
by:
– transform
– get_transform/get_transform_offset
• To save a read data set, the user program must provide a memory area of size
528,520 bytes on the PC in each case (at an address specified by
Ptr
).