Scanlab RTC 5 PC Interface Board - get_free_variable; get_head_para

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 set_free_variable, set_free_variable_list
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 page 124)
Result Parameter value as a 64-bit IEEE floating point value (see page 124)
Comments • The parameter values can be read out via get_table_para 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 page 124).
• If the parameters
HeadNo and ParaNo are out of range, then the return value will be 0
(get_last_error return code:
RTC5_PARAM_ERROR ). The return value will also be 0 (no
get_last_error 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