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

Ctrl Command load_correction_file
Comments Other notes:
®
• RTC 5 correction tables contain parameters that formerly (with an
®
RTC 4/RTC
ReadMe file. To directly integrate these parameters into the user program, the RTC
can load them via
table or read them via
• During execution of load_correction_file, no other control commands can be
executed; external starts will be disabled.
• The load_correction_file command will be ignored
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
But for older versions (prior to DLL 521, OUT 521), you should absolutely call
select_cor_table
jump_speed from the old galvanometer positions to the new ones. Otherwise, hard
jumps can occur (also see notes on
• If an RTC5_VERSION_MISMATCH error occurs (return value 11), a DLL version appropriate
for the program file must be chosen and the board must be made currentless (to unload
the program software) or alternatively program files appropriate for the DLL version
must be reloaded via the multi-board command n_load_program_file (after
RTC5_ACCESS_DENIED, the single-board command
access rights for the board). Only afterward (and after the board has been accessed via
acquire_rtc
load_correction_file can be normally executed again.
® ®
RTC 4 RTC 5 Other than its primary purpose and its first two parameters (loading of correction files),
the command's functionality has substantially changed:
• The command now uses the new parameter Dim. This allows, for instance, storage of
3D correction files as 2D correction tables and storage of 2D correction files as 3D
correction tables.
• Now, two 3D correction tables can be stored in RTC
version). However, two 3D correction tables can not be simultaneously assigned to the
scan head control ports (see
• The parameters k, Phi and Offset no longer exist. Therefore, table transformations
(scaling, rotation, translation) are no longer possible during loading of the correction
file. Such coordinate transformations can now be specified via
set_angle (page 405)
• As of version DLL 521, OUT 521,
comments above and notes on
• As of version DLL 527, OUT 529, the command only returns after the correction motion
has completed (see comments above).
• As of version DLL 533, OUT 534 up to four correction files can be loaded (see comments
above)
Version info Last change with version DLL 533, OUT 534 (see above)
®
RTC 5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
® ®
3/RTC 2) had to be manually copied into an application from a supplied
get_table_para (page 285)
get_head_para (page 265)
before restarting a list. This ensures a smooth transition via
page
or select_rtc and possibly specified as default board via select_rtc)
select_cor_table, page
and set_offset (page 463)
select_cor_table
page 123).
from the currently loaded correction
from the assigned correction table.
(get_last_error
set_wait (PAUSED status set).
123).
load_program_file
®
5 memory (in the 3D-enabled
400).
set_scale (page
in addition to set_matrix (page
is automatically called (see
®
5
return code:
does not get
474),
449).
330