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

Ctrl Command get_transform
Comments • For backward transformation of position values see
• get_transform(Number,Ptr1,Ptr2,Ptr,Code) transfers to the PC the data pairs
recorded via
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
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
Number > 2
• If Ptr = NULL, then no backward transformation will be performed; the data recorded
via set_trigger
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
tionally be generated.
• If needed, the values recorded with
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
® ®
RTC 4 RTC 5 new command
Even in the RTC
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
®
RTC 5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
set_trigger by executing get_waveform(1,Number,Ptr1) and
whether a measurement session is currently running that was
return code RTC5_PARAM_ERROR). The same applies for Number = 0 or
20
.
will then be transferred untransformed to the PC, as with
get_last_error
set_trigger
® ®
5's RTC 4 compatibility mode, all values transferred to the PC (including
page 154.
return code of RTC5_PARAM_ERROR will addi-
and backward-transformed transferred
get_last_error return code RTC5_SEND_ERROR.
289