Leica TM30 Series, Reference Manual

Page: 157 / 207

GeoCOM Reference Manual Theodolite Measurement and Calculation – TMC
Leica TPS1200 – Version 1.50 157
17.5 MEASUREMENT CONTROL FUNCTIONS
17.5.1 TMC_DoMeasure - carrying out a distance measurement
TMC_DoMeasure.......................................................................................................................................................................................................................................................................
2008 ................................................................................................................................................................................................................................................................TMC_DoMeasu
C-Declaration
........
re ................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................ 2008
TMC_DoMeasure(TMC_MEASURE_PRG Command,
TMC_INCLINE_PRG Mode)
VB-Declaration
VB_TMC_DoMeasure(ByVal Command As Long,
ByVal Mode As Long)
ASCII-Request
%R1Q,2008: Command[long],Mode[long]
ASCII-Response
%R1P,0,0:
RC
Remarks
This function carries out a distance measurement according to the TMC measurement mode like single distance,
tracking,... . Please note that this command does not output any values (distances). In order to get the values you
have to use other measurement functions such as
TMC_GetCoordinate
,
TMC_GetSimpleMea,
TMC_GetFullMeas
or else
TMC_GetAngle
.
The result of the distance measurement is kept in the instrument and is valid to the next
TMC_DoMeasure
command where a new distance is requested or the distance is clear by the measurement program
TMC_CLEAR
.
Note: If you perform a distance measurement with the measure program TMC_DEF_DIST, the distance sensor
will work with the set EDM mode, see TMC_SetEdmMode.
Parameters
Command in
TMC measurement mode.
Mode in Inclination sensor measurement mode.
Return-Code Names and Return-Code Values
GRC_OK 0 Execution successful.
See Also
TMC_SetEdmMode
TMC_GetCoordinate
TMC_GetSimpleMea
TMC_GetAngle1
TMC_GetAngle5
Example
GRC_TYPE Result;
short nCnt;
// set average mode
Result=TMC_SetEdmMode(EDM_CONT_EXACT);
// perform a single distance measurement
Result=TMC_DoMeasure(TMC_DEF_DIST);
nCnt=0;
while(nCnt<100)
{// wait on the distance data max. 100x100ms
Result=TMC_GetCoordinate(100,Coordinate,
TMC_AUTO_INC);
nCnt++;
}
// to complete the measurement, and clear data
TMC_DoMeasure(TMC_CLEAR);
// set standard mode
TMC_SetEdmMode(EMD_SINGLE_STANDARD);