RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
521
Ctrl Command load_z_table_no_20b
Function Loads coefficients A, B and C and then assigns them to the 3D correction table
No
.
For a focus length value l in the RTC6 20-bit range [–524,288…+524,287].
Restriction If the Option “3D” has not been enabled or a 3D correction table has not been assigned
(see select_cor_table), then load_z_table_no_20b returns the error code 12 or 13 and
otherwise has no effect.
Call
ErrorNo = load_z_table_no_20b( A, B, C, No )
Parameters
A
Coefficient A 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 a 64-bit IEEE floating point value.
Allowed value range: [–1,073,741,824.0…+1,073,741,824.0].
Out-of-range values are clipped to the boundary values.
B
Like
A
(analogously).
Allowed value range: [–2,048.0…+2,048.0].
C
Like
A
(analogously).
Allowed value range: [–1.0…+1.0].
No
Number of the 3D correction table to which the three coefficients
A, B, C
are
to be assigned. See also number_of_correction_tables.
Result Error code.
As an unsigned 32-bit value.
Error bits with values 1…64 can also occur combined, but not in conjunction with
error code 11…15, which only occur separately. Warnings 12 and 13 are only returned if
no other errors exist.
0 No error.
1
A
exceeded the maximum allowed value.
2
A
undercut the minimum allowed value.
4
B
exceeded the maximum allowed value.
8
B
undercut the minimum allowed value.
16
C
exceeded the maximum allowed value.
32
C
undercut the minimum allowed value.
64 Execution denied (possibly a BUSY list execution status or
INTERNAL-BUSY list execution status error; for exact reason see
get_last_error).
11 Access denied.
12 Option “3D” is not enabled.
13 No 3D correction table is currently assigned.
14 RTC6 board driver not found.
15 Invalid table number (> number_of_correction_tables).