IRotatorV3Position Property |
Namespace: ASCOM.DeviceInterface
| Exception | Condition |
|---|---|
| InvalidValueException | If Position is invalid. |
| NotConnectedException | If the device is not connected |
| 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. |
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.