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

Ctrl Command load_stretch_table
Function loads a table with data pairs from an ASCII text file for enhanced 3D correction (see
page 176).
Call
NoOfDataPairs = load_stretch_table( Name, No )
Parameters
Name
No
Result signed 32-bit value (a positive error code in case of an error, the negative number of found
data pairs in case of success):
Value
< 0
0
2
3
4
5
6
11
13
15
Comments • Details about enhanced 3D correction (e.g. format requirements for the text file's table
entries) are described on
• A successfully loaded table will activate the new enhanced 3D correction. Here,
load_stretch_table will overwrite any previously loaded table.
• If Name is not NULL, but no table was successfully read, then load_stretch_table will
return an error code (e.g. code 13 if a No value is specified for which no
[StretchTable<No>] entry is included in the text file), but otherwise will have no effect
(i.e. any previous successfully downloaded table will stay enabled).
• If Name is NULL, then load_stretch_table disables any enhanced 3D correction enabled
by a previous load_stretch_table command.
• The command will not be executed
board's BUSY status is currently set (list is being processed or has been halted via
pause_list) or the board's INTERNAL-BUSY status is currently set. In contrast, the
command is executed when a list has been paused via
• During execution of load_stretch_table, external starts will be suppressed.
• Before loading a table, load_stretch_table performs a DSP memory check. In case of
an error, error code 4 is returned.
® ®
RTC 4 RTC 5 new command
Version info Available beginning with version DLL 536, OUT 536
®
RTC 5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
name of the text file as a pointer to a null-terminated ANSI string
(the text file may contain one or more tables)
or NULL
signed 32-bit value
• For No  0, this parameter specifies which table in the text file shall be
loaded (the parameter corresponds to the extension <No> of the instruction
[StretchTable<No>] at the beginning of the desired table).
• No < 0: reserved for future use
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 error, board is BUSY or INTERNAL-BUSY, no download
RTC5_BUSY
).
Data error: data pairs missing
PCI download error (get_last_error
The specified table number was not found in the file.
Verify error (get_last_error return code
option set)
page 176.
(get_last_error
(get_last_error
RTC5_SEND_ERROR
return code
RTC5_VERIFY_ERROR
, only possible with
return code: RTC5_BUSY) if the
set_wait
return code
)
set_verify
(PAUSED status set).
343