Scanlab RTC 5 PC Interface Board Installation And Operation Manual page 328

Ctrl Command load_correction_file
Function loads the specified image field correction file into RTC
and automatically calls
the default parameter values).
Call
ErrorNo = load_correction_file( Name, No, Dim )
Parameters
Name
No
Dim
Result error code as an unsigned 32-bit value:
Value
0
1
2
3
4
5
8
10
11
12
13
14
15
®
RTC 5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
select_cor_table
name of the correction file as a pointer to a null-terminated ANSI string
this number (unsigned 32-bit value) determines whether the file shall be
stored as correction table #1, 2, 3 or 4
Allowed values: [1...4]
This parameter (an unsigned 32-bit value) determines whether the file should
be stored as a 2D correction table or (if possible) as a 3D correction table (also
see comments):
= 2: 2D and 3D correction files will be stored as a 2D correction table
(downgraded when necessary)
= 3: if the 3D option is enabled, 2D and 3D correction files will be stored
as a 3D correction table (upgraded if necessary);
If the 3D option is not enabled (default),
then the command executes with Dim = 2.
otherwise, the parameter has no effect:
a 2D correction file will be stored as a 2D correction table;
a 3D correction file will be stored as a 3D correction table if the 3D
option is enabled and as a 2D correction table (downgraded) if the 3D
option is not enabled.
Description
Success.
File error (file corrupt or incomplete).
Memory error (DLL-internal, WINDOWS system memory).
File-open error (empty string submitted for
DSP memory error
PCI download error (driver error).
System driver not found (get_last_error
No
Parameter error (incorrect ).
Access error: board reserved for another application
RTC5_ACCESS_DENIED) or version check has detected an error (OUT or RTC version not compatible
to the current DLL version, get_last_error
RTC5_VERSION_MISMATCH).
Warning: 3D table or Dim = 3 selected, but the 3D option is not enabled. The system will
subsequently operate as an ordinary 2D system (this warning is only returned, if no other error has
occurred).
Busy error: no download, board is BUSY or INTERNAL-BUSY
PCI upload error (driver error, only applicable for download verification)
Verify error (only applicable for download verification)
®
5 memory (as table #1, 2,3 or 4)
with the most recently used parameter values (or
Name
parameter, file not found, etc.).
return code: RTC5_ACCESS_DENIED)
(get_last_error return code:
return code: RTC5_ACCESS_DENIED |
(get_last_error return code: RTC5_BUSY)
328