Click or drag to resize

TelescopeMoveAxis Method

Move the telescope in one axis at the given rate.

Namespace:  ASCOM.DriverAccess
Assembly:  ASCOM.DriverAccess (in ASCOM.DriverAccess.dll) Version: 3351c4f3fa64146a7efd5b51ed4591e32a0a5484
Syntax
Copy
public 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

Implements

ITelescopeV3MoveAxis(TelescopeAxes, Double)
Exceptions
ExceptionCondition
MethodNotImplementedExceptionIf the method is not implemented.
InvalidValueExceptionIf an invalid axis or rate is given.
NotConnectedExceptionIf the device is not connected
DriverExceptionAn error occurred that is not described by one of the more specific ASCOM exceptions. The device did not successfully complete the request.
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 later.

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 opposite 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.
  • An out of range exception is raised the rate is out of range.
  • 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 hand-box 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