ICameraV3BayerOffsetX Property |
Namespace: ASCOM.DeviceInterface
Exception | Condition |
---|---|
PropertyNotImplementedException | Monochrome cameras must throw this exception, colour cameras must not. |
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 by colour cameras, monochrome cameras must throw a PropertyNotImplementedException
Since monochrome cameras don't have a Bayer colour matrix by definition, such cameras should throw a PropertyNotImplementedException. Colour cameras should always return a value and must not throw a PropertyNotImplementedException
The value returned must be in the range 0 to M-1 where M is the width of the Bayer matrix. The offset is relative to the 0,0 pixel in the sensor array, and does not change to reflect subframe settings.
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 and later.