Scanlab RTC6 PCIe Board - Read_Abc_From_File_20 B

RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
578
innovators for industry
Ctrl Command read_abc_from_file_20b
Function Reads the ABC values directly from a specified correction file on the PC.
For a focus length value l in the RTC6 20-bit range [–524,288…+524,287].
Call ErrorNo = read_abc_from_file_20b( Name, &A, &B, &C )
Result ErrorNo Error code.
As an unsigned 32-bit value.
0 No error.
1 File error (corrupt or incomplete).
2 Memory error (RTC6 DLL-internal, Windows working memory).
3 File-open error (empty string, file not found etc.).
Parameters Name Name of the correction file.
As a pointer to a \0-terminated ANSI string.
Returned
parameter
values
A
B
C
Coefficients of the parabolic function z
out
= A + Bl +Cl
2
which is used for
calculating the Z output values
(focus length value l in the RTC6 20-bit range [–524,288…+524,287]).
As 64-bit IEEE floating point values.
Comments • read_abc_from_file_20b is available even without explicit access rights to a specific
RTC6 board.
• read_abc_from_file_20b is not available as a multi-board command.
• The board-specific error variables LastError and AccError , see Chapter 6.8 ”Error
Handling”, page 130, are neither generated nor altered by read_abc_from_file_20b.
• read_abc_from_file_20b( &A, &B, &C ) is synonymous with
read_abc_from_file( &A × 16, &B, &C × 1/16 ) .
RTC4RTC6 New command.
RTC5RTC6 New command.
Version info Available as of DLL 631, OUT 632.
References write_abc_to_file_20b