Sets or returns the current filter wheel position

Namespace: ASCOM.DriverAccess
Assembly: ASCOM.DriverAccess (in ASCOM.DriverAccess.dll) Version: 6.0.0.0 (6.1.1.2619)

Syntax

C#
public short Position { get; set; }
Visual Basic
Public Property Position As Short
	Get
	Set
Visual C++
public:
virtual property short Position {
	short get () sealed;
	void set (short value) sealed;
}

Implements

IFilterWheelV2..::..Position

Remarks

Write a position number between 0 and N-1, where N is the number of filter slots (see Names). Starts filter wheel rotation immediately when written. Reading the property gives current slot number (if wheel stationary) or -1 if wheel is moving.

Returning a position of -1 is mandatory while the filter wheel is in motion; valid slot numbers must not be reported back while the filter wheel is rotating past filter positions.

Note

Some filter wheels are built into the camera (one driver, two interfaces). Some cameras may not actually rotate the wheel until the exposure is triggered. In this case, the written value is available immediately as the read value, and -1 is never produced.

Exceptions

ExceptionCondition
ASCOM..::..InvalidValueExceptionMust throw an InvalidValueException if an invalid position is set
ASCOM..::..NotConnectedExceptionMust throw an exception if the Filter Wheel is not connected

See Also