Information Functions - Leica TPS1200 Series Reference Manual

GeoCOM Reference Manual

17.7 INFORMATION FUNCTIONS

17.7.1 TMC_GetFace - getting the face information of the current telescope position
TMC_GetFace ............................................................................................................................................................................................................................................................................ ........................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................ 2026
2026 ................................................................................................................................................................................................................................................................TMC_GetFace
C-Declaration
TMC_GetFace(TMC_FACE &Face)
VB-Declaration
VB_TMC_GetFace(Face As Long)
ASCII-Request
%R1Q,2026:
ASCII-Response
%R1P,0,0:RC,Face[long]
Remarks
This function returns the face information of the current telescope position. The face information is only valid, if
the instrument is in an active measurement state (that means a measurement function was called before the
call, see example). Note that the instrument automatically turns into an inactive measurement
TMC_GetFace
state after a predefined timeout.
Parameters
Face
Return-Code Names and Return-Code Values
GRC_OK
See Also
AUT_ChangeFace
Example
GRC_TYPE
TMC_FACE Face;
// turn the face if not in normal position
// set active measurement state
rc = TMC_DoMeasure(TMC_DEF_DIST, TMC_AUTO_INC);
rc = TMC_GetFace(Face);
if (Face == TMC_FACE_TURN)
{
rc = AUT_ChangeFace(AUT_NORMAL,
if (rc == GRC_OK)
{
// face successfuly turned
}
else
{
// change face problem: see AUT_ChangeFace
}
}
// clear distance
rc = TMC_DoMeasure(TMC_CLEAR, TMC_AUTO_INC);
Leica TPS1200 – Version 1.50
Out
0
rc;
AUT_POSITION,
FALSE);
Theodolite Measurement and Calculation – TMC
Face position.
Execution successful.
177