GeoCOM Reference Manual
Theodolite Measurement and Calculation – TMC
Leica TPS1200 – Version 1.50
164
17.6.5
TMC_SetOrientation - orientating the instrument in hz-direction
TMC_SetOrientation..............................................................................................................................................................................................................................................................................
ation
............................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................ 2113
2113 ................................................................................................................................................................................................................................................................TMC_SetOrient
C-Declaration
TMC_SetOrientation(double HzOrientation)
VB-Declaration
VB_TMC_SetOrientation(ByVal HzOrientation As Double)
ASCII-Request
%R1Q,2113:
HzOrientation[double]
ASCII-Response
%R1P,0,0:
RC
Remarks
This function is used to orientate the instrument in Hz direction. It is a combination of an angle measurement to
get the Hz offset and afterwards setting the angle Hz offset in order to orientates onto a target. Before the new
orientation can be set an existing distance must be cleared (use
TMC_DoMeasure
with the
command =
TMC_CLEAR
).
Parameters
HzOrientation In
Hz Orientation [rad]
Return-Code Names and Return-Code Values
GRC_OK
0 Execution
successful.
GRC_TMC_ACCURACY_GUARANTEE
1284
Accuracy is not guaranteed, because the result are consist of
measuring data which accuracy could not be verified by the
system. Co-ordinates are available.
GRC_TMC_NO_FULL_CORRECTION
1283
The results are not corrected by all active sensors. Co-
ordinates are available.
In order to secure which correction is missing use the both
functions
TMC_IfDataAzeCorrError
and
TMC_IfDataIncCorrError
GRC_TMC_ANGLE_OK
1285
Angle values okay, but no valid distance. Co-ordinates are
not available.
GRC_TMC_ANGLE_NO_ACC_
GUARANTY
1289
Only the angle measurement is valid but its accuracy cannot
be guaranteed (the tilt measurement is not available).
GRC_TMC_ANGLE_NO_FULL_
CORRECTION
1288
No distance data available but angle data are valid. The return
code is equivalent to the
GRC_TMC_NO_FULL_CORRECTION
and relates to the angle data. Co-ordinates are not available.
Perform a distance measurement first before you call this
function.
GRC_TMC_DIST_ERROR
1292
No measuring, because of missing target point, co-ordinates
are not available.
Aim target point and try it again
GRC_TMC_DIST_PPM
1291
No distance measurement respectively no distance data
because of wrong EDM settings. Co-ordinates are not
available.
GRC_TMC_ANGLE_ERROR
1290
Angle or inclination measurement error. Check inclination
modes in commands.
GRC_TMC_BUSY
1293
TMC resource is locked respectively TMC task is busy.
Repeat measurement.
GRC_ABORT
8
Measurement through customer aborted.
GRC_SHUT_DOWN
12
System power off through customer.
See Also
TMC_IfDataAzeCorrError
TMC_IfDataIncCorrError
TMC_DoMeasure