ITelescopeV3MoveAxis Method |
Move the telescope in one axis at the given rate.
Namespace: ASCOM.DeviceInterfaceAssembly: ASCOM.DeviceInterfaces (in ASCOM.DeviceInterfaces.dll) Version: 6.0.0.0 (6.2.0.2774)
Syntax void MoveAxis(
TelescopeAxes Axis,
double Rate
)
Sub MoveAxis (
Axis As TelescopeAxes,
Rate As Double
)
void MoveAxis(
TelescopeAxes Axis,
double Rate
)
Parameters
- Axis
- Type: ASCOM.DeviceInterfaceTelescopeAxes
The physical axis about which movement is desired - Rate
- Type: SystemDouble
The rate of motion (deg/sec) about the specified axis
Exceptions Exception | Condition |
---|
MethodNotImplementedException | If the method is not implemented. |
InvalidValueException | If an invalid axis or rate is given. |
Remarks
This method supports control of the mount about its mechanical axes.
The telescope will start moving at the specified rate about the specified axis and continue indefinitely.
This method can be called for each axis separately, and have them all operate concurrently at separate rates of motion.
Set the rate for an axis to zero to restore the motion about that axis to the rate set by the
Tracking property.
Tracking motion (if enabled, see note below) is suspended during this mode of operation.
Raises an error if AtPark is true.
This must be implemented for the if the CanMoveAxis(TelescopeAxes) property returns True for the given axis.
This is only available for telescope InterfaceVersions 2 and 3
NOTES:
- The movement rate must be within the value(s) obtained from a IRate object in the
the AxisRates(TelescopeAxes) collection. This is a signed value with negative rates moving in the oposite direction to positive rates.
- The values specified in AxisRates(TelescopeAxes) are absolute, unsigned values and apply to both directions, determined by the sign used in this command.
- The value of Slewing must be True if the telescope is moving about any of its axes as a result of this method being called.
This can be used to simulate a handbox by initiating motion with the MouseDown event and stopping the motion with the MouseUp event.
- When the motion is stopped by setting the rate to zero the scope will be set to the previous TrackingRate or to no movement, depending on the state of the Tracking property.
- It may be possible to implement satellite tracking by using the MoveAxis(TelescopeAxes, Double) method to move the scope in the required manner to track a satellite.
See Also