Click or drag to resize

IRotatorV3Position Property

Current instantaneous Rotator position, allowing for any sync offset, in degrees.

Namespace:  ASCOM.DeviceInterface
Assembly:  ASCOM.DeviceInterfaces (in ASCOM.DeviceInterfaces.dll) Version: 3351c4f3fa64146a7efd5b51ed4591e32a0a5484
Syntax
float Position { get; }

Property Value

Type: Single
Exceptions
ExceptionCondition
InvalidValueExceptionIf Position is invalid.
NotConnectedExceptionIf the device is not connected
DriverExceptionAn 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

Must be implemented.

SPECIFICATION REVISION - IRotatorV3 - Platform 6.5

Position reports the synced position rather than the mechanical position. The synced position is defined as the mechanical position plus an offset. The offset is determined when the Sync(Single) method is called and must be persisted across driver starts and device reboots.

The position is expressed as an angle from 0 up to but not including 360 degrees, counter-clockwise against the sky. This is the standard definition of Position Angle. However, the rotator does not need to (and in general will not) report the true Equatorial Position Angle, as the attached imager may not be precisely aligned with the rotator's indexing. It is up to the client to determine any offset between mechanical rotator position angle and the true Equatorial Position Angle of the imager, and compensate for any difference.

The Reverse property is provided in order to manage rotators being used on optics with odd or even number of reflections. With the Reverse switch in the correct position for the optics, the reported position angle must be counter-clockwise against the sky.

NOTE

IRotatorV3, released in Platform 6.5, requires this method to be implemented, in previous interface versions implementation was optional.

See Also