CameraReadoutModes Property |
Namespace: ASCOM.DriverAccess
Exception | Condition |
---|---|
PropertyNotImplementedException | Must throw an exception if CanFastReadout is . |
NotConnectedException | If the device is not connected. |
DriverException | An error occurred that is not described by one of the more specific ASCOM exceptions. The device did not successfully complete the request. |
To select a mode, the application will set ReadoutMode to the index of the desired mode. The index is zero-based.
This property should only be read while a connection to the camera is actually established. Drivers often support multiple cameras with different capabilities, which are not known until the connection is made. If the available readout modes are not known because no connection has been established, this property shall throw an exception.
Please note that the default ReadoutMode setting is 0. It is strongly recommended, but not required, that driver authors use the 0-index mode for standard imaging operations, since it is the default.
This feature may be used in parallel with FastReadout; however, care should be taken to ensure that the two features work together consistently. If there are modes that are inconsistent having a separate fast/normal switch, then it may be better to simply list Fast as one of the ReadoutModes.
It is recommended that this function be called only after a connection is established with the camera hardware, to ensure that the driver is aware of the capabilities of the specific camera model.
This is only available for the Camera Interface Version 2