RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
551
Comments • For backward transformation of position values see page 154.
• The execution of transform must be preceded by a call to upload_transform. Addi-
tionally, position values should have been requested via get_values.
• If execution of transform results in an error (returned error code > 0), then no trans-
formation will occur (
Sig1
and
Sig2
then remain unchanged). Errors also include
Ptr
=
NULL (error code = 1) or errors resulting from prior, erroneous execution of
upload_transform (error code = 3).
• If backward transformation of Z 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 and C will be initialized with 0, 1, 0 (1-to-1 backward
transformation).
• For backward transformation of XY position values (
Code
bit #0 = 0), only the Z = 0
plane will be transformed. XY stretching and Z defocus resulting from Z deviations
(particularly with non-F-Theta systems) aren’t taken into account.
• Because the command transform doesn’t access any RTC
®
5 boards, calling it does not
require explicit access rights to a specific board. If both the upload_transform data
and the queried data recorded via get_values or get_waveform have been binarily
stored on the PC, then offline operation of transform is also possible (then transform
doesn’t require the presence of an RTC
®
5 board on the PCI bus).
• transform is not available as a multi-board command.
• The board-specific error variables
LastError
and
AccError
(see "Error Handling", page
87) are neither generated nor altered by transform.
RTC
®
4
RTC
®
5new command
Even in the RTC
®
5’s RTC
®
4 compatibility mode, all back transformed values (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
References upload_transform, get_transform, get_values
Ctrl Command transform
To Next Page
Loading...
