Scanlab RTC6 PCIe Board - Load_Position_Control

RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
507
innovators for industry
Ctrl Command load_position_control
Function Loads a table with data points from an ASCII text file and determines – by linear
interpolation – the scaling function for position-dependent laser control
(radial correction, see Section ”Position-Dependent Laser Control”, page 199).
Call NoOfDataPoints = load_position_control( Name, No )
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 Determines which table in the text file is to be loaded. The parameter
corresponds to the extension <No> of [PositionCtrlTable<No>] at the
beginning of the desired table.
As an unsigned 32-bit value.
Result A positive error code in case of an error. The negative number of found data points in case
of success. As a signed 32-bit value.
Value Description
–1…– 50 Success. The absolute value of the return value is equal to the number of valid
data points found in the table. Invalid entries are ignored, see also Section
”Notes on Loading a Scaling Function”, page 199.
–256 For Name = NULL (see also comments).
1 No valid data points found (though Table No found).
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 ).
8 Board is locked by another user program (get_last_error return code
RTC6_ACCESS_DENIED ).
11 PCI error (get_last_error return code RTC6_SEND_ERROR ),
verify error (get_last_error return code RTC6_VERIFY_ERROR ).
13 The specified table number could not been found in the file.
Comments • The format requirements for the text file’s table entries with data points for
position-dependent laser control are described in Section ”Notes on Loading a Scaling
Function”, page 199. When loading the table, the RTC6 determines suitable values
for the entire range of control values.
• load_position_control overwrites any previously loaded scaling
function for position-dependent laser control.
• For Name = NULL (as during initialization by load_program_file), the scaling function
Scale(Position)=1.0 is loaded for the complete position range so that no position-
dependent correction takes place.
• Position-dependent laser control only takes effect during subsequent
[*]mark[*] Commands or Arc Commands if it has been initialized by
set_auto_laser_control.
Position-dependent laser control is deactivated by set_auto_laser_control ( Ctrl = 0)
or by loading Scale(Position)=1.0. See also Section ”Position-Dependent Laser
Control”, page 199.