GeoCOM Reference Manual
Theodolite Measurement and Calculation – TMC
Leica TPS1200 – Version 1.50
177
17.7
INFORMATION FUNCTIONS
17.7.1
TMC_GetFace - getting the face information of the current telescope position
TMC_GetFace ............................................................................................................................................................................................................................................................................
2026 ................................................................................................................................................................................................................................................................TMC_GetFace
C-Declaration
........................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................ 2026
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
TMC_GetFace
call, see example). Note that the instrument automatically turns into an inactive measurement
state after a predefined timeout.
Parameters
Face Out
Face position.
Return-Code Names and Return-Code Values
GRC_OK
0 Execution
successful.
See Also
AUT_ChangeFace
Example
GRC_TYPE
rc;
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,
AUT_POSITION,
FALSE);
if (rc == GRC_OK)
{
// face successfuly turned
}
else
{
// change face problem: see AUT_ChangeFace
}
}
// clear distance
rc = TMC_DoMeasure(TMC_CLEAR, TMC_AUTO_INC);
