RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
329
Comments Notes on loading correction tables:
• The RTC
®
5 can store four different correction files at the same time, e.g. for use in a
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 set_trigger or set_trigger4 (see comments for those
commands). load_program_file automatically initializes this memory area and any
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 load_z_table command (see page 174).
– 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 select_cor_table or select_cor_table_list command to assign one (or two)
correction table(s) stored on the RTC
®
5 to the scan head (or to both scan head connec-
tors).
• As of Version DLL 521, OUT 521, the command load_correction_file will automatically
call select_cor_table after loading of a correction table. However, if you call
load_correction_file before loading the program file (via load_program_file), then
the automatic call of select_cor_table will have no effect. If you call
load_correction_file after load_program_file, then the select_cor_table call will use
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 or select_cor_table_list after load_correction_file or
load_program_file.
• For further information on this subject, see notes on page 123.
Ctrl Command load_correction_file