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

Ctrl Command load_correction_file
Comments Notes on loading correction tables:
• The RTC
multiple scan head configuration.
• Correction tables number 3 and 4 must always be loaded only after
load_program_file. These tables occupy the upper half of the memory area reserved
for data recording via
commands).
already loaded correction tables number 3 and 4 will be lost.
• Before storing a correction file, load_correction_file performs a DSP memory check. In
case of an error, error code 4 is returned.
• If the parameter No is out of range, then no correction table will be loaded (return value
10).
• The name of the to-be-loaded correction file must be passed to load_correction_file
as a pointer to a null-terminated ANSI string. If Name is passed as a null pointer (0), the
corresponding table will be replaced by a 1-to-1 table (for Dim = 3 and enabled 3D
option with a 1-to-1 3D table, otherwise with a 1-to-1 2D table). Most of the above-
mentioned parameters will then be set to 0. An empty string ("") for Name will result in
an error return code of 3.
• If the 3D option is not enabled (default), then 2D and 3D correction files will be stored
as 2D correction tables – regardless of the value specified for Dim (3D correction files
also include 2D correction tables). The 3D data sections of 3D correction files will then
be ignored.
• If, on the other hand, the 3D option is enabled, then both 2D and 3D tables can be
loaded.
– For Dim = 2, a 2D table will always be stored (the 3D data section of 3D correction
files will be ignored) and, accordingly, only 2D corrections will be calculated (the Z
axis thereby remains unchanged, as if no 3D option was enabled).
– For Dim = 3, if the 3D option is enabled then both 2D and 3D correction files will be
stored as 3D correction tables. 2D correction tables will be thereby automatically
expanded to incorporate a linear Z correction. The actually suitable Z correction can
subsequently be loaded via the
– All other values for Dim will not change the type of the correction file.
Notes on assigning correction tables via select_cor_table:
• Use the
correction table(s) stored on the RTC
tors).
• As of Version DLL 521, OUT 521, the command load_correction_file will automatically
call select_cor_table
load_correction_file before loading the program file (via load_program_file), then
the automatic call of
load_correction_file after load_program_file, then the
the parameter values (HeadA = 1, HeadB = 0) or the values most recently used (after
load_program_file) when having called select_cor_table. As of version DLL 527,
OUT 529, the command only returns to the application, after the select_cor_table-
induced jump to the corrected galvanometer position has completed.
• With older versions (prior to DLL 521, OUT 521), you must absolutely call
select_cor_table
load_program_file.
• For further information on this subject, see notes on
®
RTC 5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
®
5 can store four different correction files at the same time, e.g. for use in a
set_trigger or
load_program_file automatically initializes this memory area and any
load_z_table
select_cor_table select_cor_table_list
or
after loading of a correction table. However, if you call
select_cor_table
or select_cor_table_list
set_trigger4 (see comments for those
command (see
command to assign one (or two)
®
5 to the scan head (or to both scan head connec-
will have no effect. If you call
select_cor_table
after load_correction_file or
page 123.
page 174).
call will use
329