Scanlab RTC6 PCIe Board - Load_Correction_File

RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
494
innovators for industry
Ctrl Command load_correction_file
Function Loads the specified correction file into RTC6 memory. Then calls automatically
select_cor_table with the most recently used parameter values (or the default parameter
values).
Call ErrorNo = load_correction_file( Name, No, Dim )
Parameters Name Name of the correction file.
As a pointer to a \0-terminated ANSI string.
No Number of the correction table.
Allowed values: [1…8].
As an unsigned 32-bit value.
See also number_of_correction_tables.
Dim Determines whether the correction file content is stored as a
2D correction table or (if possible) as a 3D correction table (see also
comments).
As an unsigned 32-bit value.
= 2: 2D and 3D correction files are stored as a 2D correction table
(downgrade, if necessary).
= 3: If the Option “3D” is enabled, 2D and 3D correction files are stored
as a 3D correction table (upgrade, if necessary).
If the Option “3D” is not enabled, like Dim = 2.
Others: Dim has no effect.
A 2D correction file is stored as a 2D correction table.
A 3D correction file is stored as a 3D correction table,
if the Option “3D” is enabled, otherwise as a
2D correction table (downgrade).
Result Error code.
As an unsigned 32-bit value.
0 Success.
1 File error (file corrupt or incomplete).
2 Memory error (RTC6 DLL-internal, Windows system memory).
3 File-open error (empty string submitted for Name parameter, file not found,
etc.).
4 DSP memory error.
5 PCI download error (RTC6 board driver error), Ethernet download error.
8 RTC6 board driver not found (get_last_error return code
RTC6_ACCESS_DENIED ).
10 Parameter error (incorrect No ).