Starts an exposure. Use ImageReady to check when the exposure is complete.

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

Syntax

C#
void StartExposure(
	double Duration,
	bool Light
)
Visual Basic
Sub StartExposure ( _
	Duration As Double, _
	Light As Boolean _
)
Visual C++
void StartExposure(
	double Duration, 
	bool Light
)

Parameters

Duration
Type: System..::..Double
Duration of exposure in seconds, can be zero if Light is false
Light
Type: System..::..Boolean
true for light frame, false for dark frame (ignored if no shutter)

Remarks

Must be implemented, must not throw a MethodNotImplementedException.

A dark frame or bias exposure may be shorter than the V2 ExposureMin value and for a bias frame can be zero. Check the value of Light and allow exposures down to 0 seconds if Light is false. If the hardware will not support an exposure duration of zero then, for dark and bias frames, set it to the minimum that is possible.

Some applications will set an exposure time of zero for bias frames so it's important that the driver allows this.

Exceptions

ExceptionCondition
ASCOM..::..InvalidValueExceptionNumX, NumY, BinX, BinY, StartX, StartY, or Duration parameters are invalid.
ASCOM..::..InvalidOperationExceptionCanAsymmetricBin is false and BinX != BinY
ASCOM..::..NotConnectedExceptionthe exposure cannot be started for any reason, such as a hardware or communications error

See Also