Type of colour information returned by the the camera sensor, Interface Version 2 only

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

Syntax

C#
public SensorType SensorType { get; }
Visual Basic
Public ReadOnly Property SensorType As SensorType
	Get
Visual C++
public:
virtual property SensorType SensorType {
	SensorType get () sealed;
}

Field Value

Return Value

The SensorType enum value of the camera sensor

Implements

ICameraV2..::..SensorType

Remarks

This is only available for the Camera Interface Version 2

SensorType returns a value indicating whether the sensor is monochrome, or what Bayer matrix it encodes. The following values are defined:

ValueEnumerationMeaning
0 Monochrome Camera produces monochrome array with no Bayer encoding
1 Colour Camera produces color image directly, requiring not Bayer decoding
2 RGGB Camera produces RGGB encoded Bayer array images
3 CMYG Camera produces CMYG encoded Bayer array images
4 CMYG2 Camera produces CMYG2 encoded Bayer array images
5 LRGB Camera produces Kodak TRUESENSE Bayer LRGB array images

Please note that additional values may be defined in future updates of the standard, as new Bayer matrices may be created by sensor manufacturers in the future. If this occurs, then a new enumeration value shall be defined. The pre-existing enumeration values shall not change.

SensorType can possibly change between exposures, for example if Camera.ReadoutMode is changed, and should always be checked after each exposure.

In the following definitions, R = red, G = green, B = blue, C = cyan, M = magenta, Y = yellow. The Bayer matrix is defined with X increasing from left to right, and Y increasing from top to bottom. The pattern repeats every N x M pixels for the entire pixel array, where N is the height of the Bayer matrix, and M is the width.

RGGB indicates the following matrix:

X = 0X = 1
Y = 0 R G
Y = 1 G B

CMYG indicates the following matrix:

X = 0X = 1
Y = 0 Y C
Y = 1 G M

CMYG2 indicates the following matrix:

X = 0X = 1
Y = 0 C Y
Y = 1 M G
Y = 2 C Y
Y = 3 G M

LRGB indicates the following matrix (Kodak TRUESENSE):

X = 0X = 1X = 2X = 3
Y = 0 L R L G
Y = 1 R L G L
Y = 2 L G L B
Y = 3 G L B L

The alignment of the array may be modified by BayerOffsetX and BayerOffsetY. The offset is measured from the 0,0 position in the sensor array to the upper left corner of the Bayer matrix table. Please note that the Bayer offset values are not affected by subframe settings.

For example, if a CMYG2 sensor has a Bayer matrix offset as shown below, BayerOffsetX is 0 and BayerOffsetY is 1:

X = 0X = 1
Y = 0 G M
Y = 1 C Y
Y = 2 M G
Y = 3 C Y

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.

Exceptions

ExceptionCondition
ASCOM..::..NotConnectedExceptionMust throw an exception if the information is not available. (Some drivers may require an active connection in order to retrieve necessary information from the camera.)

See Also