ITelescopeV4PulseGuide Method

Moves the scope in the given direction for the given interval or time at the rate given by the corresponding guide rate property

Namespace: ASCOM.DeviceInterface
Assembly: ASCOM.DeviceInterfaces (in ASCOM.DeviceInterfaces.dll) Version: 7.0.0-rc.0+0

Syntax

C++

Copy

void PulseGuide(
	GuideDirections Direction,
	int Duration
)

Sub PulseGuide ( 
	Direction As GuideDirections,
	Duration As Integer
)

void PulseGuide(
	GuideDirections Direction, 
	int Duration
)

Parameters

Direction GuideDirections: The direction in which the guide-rate motion is to be made
Duration Int32: The duration of the guide-rate motion (milliseconds)

Exceptions

Exception	Condition
PropertyNotImplementedException	If the method is not implemented and CanPulseGuide is False
InvalidValueException	If an invalid direction or duration is given.
InvalidOperationException	If the pulse guide cannot be effected e.g. if the telescope is slewing or is not tracking or a pulse guide is already in progress and a second cannot be started asynchronously.
NotConnectedException	When Connected is False.
DriverException	An error occurred that is not described by one of the more specific ASCOM exceptions. Include sufficient detail in the message text to enable the issue to be accurately diagnosed by someone other than yourself.

Remarks

ITelescopeV4 clarification - This method must act asynchronously using IsPulseGuiding as the completion variable.

If the device cannot have simultaneous PulseGuide operations in both RightAscension and Declination, it must throw InvalidOperationException when the overlapping operation is attempted.

Further explanation is available in this link: Master Interface Document.

Revision History

Date	Version	Description
ITelescope	Platform 3.0	Member added.
ITelescopeV4	Platform 7.0	Formally defined as operating asynchronously, see note above.

Reference

ITelescopeV4 Interface

ASCOM.DeviceInterface Namespace