RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
268
Ctrl Command get_hi_pos
Function returns the Home-In positions, last determined (via auto_cal) of the scan system attached
to the specified scan head connector.
Call get_hi_pos( HeadNo, &X1, &X2, &Y1, &Y2 )
Parameter 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)
Returned para-
meter values
X1, X2,
Y1, Y2
coordinates of the currently stored (last determined) Home-In positions in
bits as a pointers to signed 32-bit values
Comments • For information on using this command, see page 201.
• It is up to the user to ensure, that the scan system currently attached to the specified
scan head connector is the same scan system which was used to determine the returned
Home-In positions. For determination of Home-In position values, this scan system
should be equipped with an internal sensor system for automatic self-calibration
(Home-In sensors).
• The returned values are 0 if no scan system equipped with automatic self-calibration
(Home-In sensors) is attached to the specified scan head connector or if an error has
occurred during determination of the Home-In values for such a system. For
HeadNo
=2,
the returned values are also 0, if the “second scan head control” option has not been
enabled.
• Directly after initialization (init_rtc5_dll), particularly prior to a first call of the
command auto_cal(
Command
= 0, 1 or 3), the returned values are the Home-In refer-
ence values stored in the im EEPROM of the RTC
®
5 board. If such reference values have
not been successfully determined at least once via auto_cal(
Command
= 0), get_hi_pos
returns 0.
•The command get_hi_pos is also available without explicit access rights to a specific
RTC
®
5 board.
• If parameter values are invalid, then all returned coordinates will be 0 (get_last_error
return code:
RTC5_PARAM_ERROR
).
RTC
®
4
RTC
®
5new command
References get_hi_data, auto_cal, set_hi
To Next Page
Loading...
