RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
289
Comments • For backward transformation of position values see page 154.
• get_transform(
Number,Ptr1,Ptr2,Ptr,Code
) transfers to the PC the data pairs
recorded via set_trigger by executing get_waveform(1,
Number,Ptr1
) and
get_waveform(2,
Number,Ptr2
) and overwrites the data pairwise by using
transform(
Sig1,Sig2,Ptr,Code
).
• Prior to calling get_transform, you must call upload_transform. Additionally, position
values should have been recorded via set_trigger.
• Before calling get_transform (as with get_waveform), you can check via
measurement_status whether a measurement session is currently running that was
started with set_trigger. We recommend not to read any data when data recording is
currently active. The number
Pos
for the last (or current) data pair of the measurement
session can be queried via measurement_status. No more than
Pos
+1 data elements
should be read. Any further elements are from earlier recordings or the initialization.
• The PC main memory areas pointed to by
Ptr1
and
Ptr2
must have been sufficiently allo-
cated by the user (
Number
· 4 bytes per channel).
• If only Z position values are to be backward transformed (
Code
bit #0 = 1), then you
can set the pointer (
Ptr1
or
Ptr2
) for the unused return channel to NULL. This channel
will then not transfer and backward transform data to the PC. Ensure here that
Code
bit
#1 is appropriately set.
• If the command call is made with
Ptr1
= NULL and
Ptr2
= NULL, then neither channel
will transfer data to the PC and likewise no backward transformations will be performed
(get_last_error return code
RTC5_PARAM_ERROR
). The same applies for
Number
= 0 or
Number
> 2
20
.
•If
Ptr
= NULL, then no backward transformation will be performed; the data recorded
via set_trigger will then be transferred untransformed to the PC, as with
get_waveform(1,
Number
,
Ptr1
) and get_waveform(2,
Number
,
Ptr2
).
The same applies for
Ptr
NULL if an error occurred during execution of get_transform
(e.g. when data referenced by
Ptr
are invalid or erroneous or when Z-axis inversion isn’t
possible). Here, however, a get_last_error return code of
RTC5_PARAM_ERROR
will addi-
tionally be generated.
• If needed, the values recorded with set_trigger and backward-transformed transferred
to the PC via get_transform can additionally be untransformed transferred to the PC
via get_waveform.
• If backward transformation of Z position values is requested (
Code
bit #0 = 1), but only
a 2D correction table was assigned at the timepoint of the prior successful call to
upload_transform, then the offsets to the focal length and Z coordinates will be initial-
ized with 0 and the values A, B, C with will be initialized 0, 1, 0 (1-to-1 backward trans-
formation).
• For backward transformation of XY position values (
Code
bit #0 = 0), only the Z = 0
plane will be transformed. XY stretching and Z defocus due to Z deviations (particularly
with non-F-Theta systems) aren’t taken into account.
• PCI transmission errors will generate the get_last_error return code
RTC5_SEND_ERROR
.
RTC
®
4
RTC
®
5new command
Even in the RTC
®
5’s RTC
®
4 compatibility mode, all values transferred to the PC (including
Z values) are in the 20-bit range and must, when necessary, be converted (by dividing by
16) by the user.
Version info • Available beginning with version DLL 516, OUT 515, RBF 512
• Change with version DLL 517: parameter
Code
changed
Ctrl Command get_transform
To Next Page
Loading...
