RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
495
Result
(cont’d)
11 Access error: board reserved for another user program (get_last_error
return code
RTC6_ACCESS_DENIED
) or version check has detected an error (OUT
or RTC version not compatible to the current RTC6 DLL version, get_last_error
return code
RTC6_ACCESS_DENIED
|
RTC6_VERSION_MISMATCH
).
12 Warning: 3D correction table or Dim = 3 selected, but the Option “3D” is not
enabled. The system subsequently operates as an ordinary 2D system (this
warning is only returned, if no other error has occurred).
13 Busy error: no download, board is BUSY list execution status or
INTERNAL-BUSY list execution status (get_last_error return code
RTC6_BUSY
).
14 PCI upload error (RTC6 board driver error, only with download verification)
15 Verify error (only with download verification).
Comments On loading correction tables:
• The RTC6 can store 8 different correction tables at the same time, for example, for use
in a multiple scan head configuration.
• Before storing a correction file, load_correction_file performs a DSP memory check
that produces error code 4 in case of error.
• If the parameter
No
is out of range, then no correction table is loaded (return value 10).
Users can further restrict the permitted range by number_of_correction_tables.
• The name of the to-be-loaded correction file must be passed to load_correction_file
as a pointer to a \0-terminated ANSI string. If
Name
is passed as a NULL pointer, the
corresponding table is replaced by a 1-to-1 table (for
Dim
= 3 and enabled Option “3D”
with a 1-to-1 3D correction table, otherwise with a 1-to-1 2D table). An empty string
(““) for
Name
result in an error return code of 3.
• If the Option “3D” is not enabled (default), then 2D and 3D correction files are stored
as 2D correction tables – regardless of the value specified for
Dim
. The 3D data sections
of 3D correction files are then ignored.
• If, on the other hand, the Option “3D” is enabled, then both 2D and
3D correction tables can be loaded.
– For
Dim
= 2, a 2D table is always stored (the 3D data section of 3D correction files
are ignored) and, accordingly, only 2D corrections are calculated (the z axis thereby
remains unchanged, as if no Option “3D” has been enabled).
– For
Dim
= 3, if the Option “3D” is enabled then both 2D and 3D correction files are
stored as 3D correction tables. 2D correction tables are thereby automatically
expanded to incorporate a linear Z correction. The actually suitable Z correction can
subsequently be loaded by load_z_table or load_z_table_no, see Chapter 7.3.4
”3D Image Field”, page 170.
– All other values for
Dim
do not change the type of the correction file.
Ctrl Command load_correction_
file