Load_Stretch_Table - Scanlab RTC6 PCIe Board Installation And Operation Manual

Ctrl Command load_stretch_table
Function Loads a table with data pairs from an ASCII text file for enhanced 3D correction, see
"Enhanced 3D Correction", page
NoOfDataPairs = load_stretch_table( Name, No, TableNo )
Call
Name
Parameters
No
TableNo
Result A positive error code in case of an error. The negative number of found data pairs in case
of success. As a signed 32-bit value.
Value
< 0
0
2
3
4
5
6
11
13
15
Comments • For details about enhanced 3D correction, see
page
• The enhanced 3D correction is also switched when
• A successfully loaded table activates the new enhanced 3D correction. Here,
load_stretch_table overwrites a previously loaded table of the same TableNo.
• If Name is not NULL, but no table has been successfully read, then load_stretch_table
returns an error code, but otherwise has no effect (that is, any previous successfully
downloaded table remains valid).
RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
240.
Name of the text file or NULL. The text file may contain one or more tables.
As a pointer to a \0-terminated ANSI string.
As a signed 32-bit value.
• For No  0, this parameter specifies which table in the text file is to be
loaded. The parameter corresponds to the extension <No> of
[StretchTable<No>]
• No < 0: Reserved.
The already loaded 3D correction table to which the extended correction is
assigned. As a signed 32-bit value.
Allowed value range: 1...8. See also number_of_correction_tables.
Description
Success. The absolute value of the return value is equal to the number of valid
data pairs found in the table.
Reserved.
Out of Memory (not enough Windows memory).
File not found.
DSP memory error.
BUSY list execution status
INTERNAL-BUSY list execution
return code RTC6_BUSY).
Data error: data pairs missing.
PCI download error (get_last_error
The specified table number could not been found in the file.
Verify error (get_last_error
active download verification, see set_verify).
240.
at the beginning of the desired table.
error, board is BUSY list execution status
status, no download
return code RTC6_SEND_ERROR).
return code RTC6_VERIFY_ERROR, only possible with
Section "Enhanced 3D Correction",
select_cor_table
Section
or
(get_last_error
is called.
512