GeoCOM Reference Manual
Alt User - AUS
Leica TPS1200 / TS30 / TM30 – Version 1.50
41
6.3.3
AUS_GetUserLockState - getting the status of the LOCK mode
AUS_GetUserLockState............................................................................................................................................................................................................................................................................
ckState
........................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................ 18008
18008...............................................................................................................................................................................................................................................................AUS_GetUserLo
C-Declaration
AUS_GetUserLockState(ON_OFF_TYPE &OnOff)
VB-Declaration
VB_AUS_GetUserLockState(OnOff As Long)
ASCII-Request
%R1Q,18008:
ASCII-Response
%R1P,0,0:
RC, OnOff[long]
Remarks
This command gets the current status of the LOCK mode. This command is valid for automated instruments
only. TheGetUserLockState command does not indicate if the instrument is currently locked to a prism. For this
function the MotReadLockStatus has to be used.
Parameters
OnOff Out
State of the LOCK mode
Return-Code Names and Return-Code Values
GRC_OK
0 Execution
successful.
GRC_NOT_IMPL
5
ATR not available; no automated instrument.
See Also
AUS_SetUserLockState
MOT_ReadLockStatus
Example
GRC_TYPE rc;
ON_OFF_TYPE OnOff, OldAtrStatus;
rc = AUS_GetUserAtrState(OldAtrStatus); // save old mode
rc = AUS_GetUserLockState(OnOff);
if (OnOff == OFF)
{// ------ enable target tracking ------------------
rc = AUS_SetUserLockState(ON); //set the ATR mode
//automatically also!
if (rc == GRC_OK)
{// set of Lock state successful
rc = AUT_LockIn();// activate the real target
// tracking
if(rc != GRC_OK)
{
// error handling
}
}
else
{
// no automated instrument
}
}
else
{// ------ disable target tracking ---------------
rc = AUS_SetUserLockState(OFF);// reset the ATR
// mode not
// automatically
if(rc == GRC_OK)
{// reset of Lock state successful
if(OldAtrStatus==OFF)
{// set old ATR mode
rc == AUS_SetUserAtrState(OFF);
}
}
}
