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

Ctrl Command load_position_control
Function loads a table with data points from an ASCII text file and determines – via linear
interpolation – the scaling function for position-dependent laser control (radial correction,
see page
Call
NoOfDataPoints = load_position_control( 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 points in case of success):
Value
– 1 to – 50
–256
1
3
4
5
8
11
13
Comments • The format requirements for the text file's table entries with data points for position-
dependent laser control are described in
page
range of control values.
• The command load_position_control overwrites any previously loaded scaling func-
tion for position-dependent laser control.
• For Name = 0 (as during initialization via 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 or arc
commands if it was initialized via set_auto_laser_control. Position-dependent laser
control is deactivated via
Scale(Position)=1.0. Also see
• The load_position_control command will not be executed
code: RTC5_BUSY) if the 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
status set).
• During execution of load_position_control, external starts will be suppressed.
• Before loading a table, load_position_control performs a DSP memory check. In case
of an error, error code 4 is returned.
® ®
RTC 4 RTC 5 new command
®
RTC 5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
141).
name of the text file as a pointer to a null-terminated ANSI string
(the text file may contain one or more tables).
This parameter (an unsigned 32-bit value) specifies which table in the text file
shall be loaded (the parameter corresponds to the extension <No> of the
instruction [PositionCtrlTable<No>] at the beginning of the desired table).
Description
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 (also see
for Name = 0 (also see comments)
No valid data points found (though Table
File not found.
DSP memory error
BUSY error, board was BUSY or INTERNAL-BUSY, no download
RTC5_BUSY
).
Board is locked by another application
PCI error (get_last_error return code
verify error (get_last_error return code
The specified table number was not found in the file.
143. When loading the table, the RTC
set_auto_laser_control
"Position-Dependent Laser Control", page
page 143).
No
found).
(get_last_error
(get_last_error return code RTC5_ACCESS_DENIED
RTC5_SEND_ERROR
),
RTC5_VERIFY_ERROR
)
"Notes on Loading a Scaling Function" on
®
5 determines suitable values for the entire
(Ctrl = 0) or by loading
(get_last_error
return code
).
141.
return
set_wait (PAUSED
338