RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
512
Ctrl Command load_stretch_table
Function Loads a table with data pairs from an ASCII text file for enhanced 3D correction, see Section
”Enhanced 3D Correction”, page 240.
Call
NoOfDataPairs = load_stretch_table( Name, No, TableNo )
Parameters
Name
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.
No
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>]
at the beginning of the desired table.
•
No
< 0: Reserved.
TableNo
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.
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 Description
< 0 Success. The absolute value of the return value is equal to the number of valid
data pairs found in the table.
0 Reserved.
2 Out of Memory (not enough Windows memory).
3 File not found.
4 DSP memory error.
5 BUSY list execution status error, board is BUSY list execution status or
INTERNAL-BUSY list execution status, no download (get_last_error
return code
RTC6_BUSY
).
6 Data error: data pairs missing.
11 PCI download error (get_last_error return code
RTC6_SEND_ERROR
).
13 The specified table number could not been found in the file.
15 Verify error (get_last_error return code
RTC6_VERIFY_ERROR
, only possible with
active download verification, see set_verify).
Comments • For details about enhanced 3D correction, see Section ”Enhanced 3D Correction”,
page 240.
• The enhanced 3D correction is also switched when select_cor_table is called.
• 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).
To Next Page
Loading...