RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
265
innovators for industry
Ctrl Command get_free_variable
Function
returns the current value of a free variable.
Call
VariableValue = get_free_variable( No )
Parameter
No
Number of the free variable to be queried as an unsigned 32-bit value.
Allowed range: [0 … 3]
Only the two least significant bits are evaluated.
Result
the value currently stored in the free variable (as an unsigned 32-bit value)
Comments
• See
chapter 6.9.1 "Free Variables", page 92
RTC
®
4
RTC
®
5 new command
Version info
Available beginning with version DLL 531, OUT 532
References
Ctrl Command get_head_para
Function
returns the value of the requested parameter in the correction table assigned to the
specified scan head
Call
HeadPara = get_head_para( HeadNo, ParaNo )
Parameters
HeadNo
Number of the scan head connector as an unsigned 32-bit value,
valid values:
= 1:
primary scan head connector
= 2:
secondary scan head connector (activation required)
ParaNo
Number of the parameter as an unsigned 32-bit value,
valid values: 0-15 (meaning: see
)
Result
Parameter value as a 64-bit IEEE floating point value (see
)
Comments
• The parameter values can be read out via
from a currently loaded
correction table and via
get_head_para
from an assigned correction table and thus
directly incorporated into a user program (see
).
• If the parameters
HeadNo
and
ParaNo
are out of range, then the return value will be 0
(
return code:
RTC5_PARAM_ERROR
). The return value will also be 0 (no
return code) if no correction table has been assigned to the specified
head (e.g. for
HeadNo
= 2 if the “second scan head control” option has not been
enabled) and no 3D table has been assigned to the other head.
• If a 3D table has been assigned to a head, then this 3D table’s parameter will be
returned regardless of
HeadNo
(two 3D tables cannot be simultaneously assigned).
HeadNo
must nevertheless be 1 or 2 (see preceding comment).
RTC
®
4
RTC
®
5 new command
Version info
Last change with version DLL 516, OUT 514