RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
329
innovators for industry
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
. These tables occupy the upper half of the memory area reserved
for data recording via
(see comments for those
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
).
– All other values for
Dim
will not change the type of the correction file.
Notes on assigning correction tables via
:
• Use the
or
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
after loading of a correction table. However, if you call
load_correction_file
before
loading the program file (via
), then
the automatic call of
will have no effect. If you call
load_correction_file
after
, then the
call will use
the parameter values (
HeadA
= 1,
HeadB
= 0) or the values most recently used (after
. As of version DLL 527,
OUT 529, the command only returns to the application, after the
-
induced jump to the corrected galvanometer position has completed.
• With older versions (prior to DLL 521, OUT 521), you must absolutely call
after
load_correction_file
or
• For further information on this subject, see notes on
.
Ctrl Command load_correction_file