IVideoFrameImageArray Property |
Namespace: ASCOM.DeviceInterface
Must be implemented, must not throw an ASCOM.PropertyNotImplementedException.
The application must inspect the Safearray parameters to determine the dimensions and also the SensorType to determine if the image is Color or not. The following table should be used to determine the format of the data:
Dimensions | SensorType | Array Format |
1; int[] | Monochrome, RGGB, CMYG, CMYG2, LRGB | A row major ImageArray[Pixels] of Height * Width elements. The pixels in the array start from the top left part of the image and are listed by horizontal lines/rows. The second pixel in the array is the second pixel from the first horizontal row and the second last pixel in the array is the second last pixels from the last horizontal row. |
1; int[] | Color | Invalid configuration. |
2; int[,] | Monochrome, RGGB, CMYG, CMYG2, LRGB | ImageArray[Height, Width] of Height x Width elements. |
2; int[,] | Color | ImageArray[NumPlane, Pixels] of NumPlanes x Height * Width elements. The order of the three colour planes is first is R, the second is G and third is B. The pixels in second dimension of the array start from the top left part of the image and are listed by horizontal lines/rows. The second pixel is the second pixel from the first horizontal row and the second last pixel is the second last pixels from the last horizontal row. |
3; int[,,] | Monochrome, RGGB, CMYG, CMYG2, LRGB | Invalid configuration. |
3; int[,,] | Color | ImageArray[NumPlane, Height, Width] of NumPlanes x Height x Width elements. The order of the three colour planes is first is R, the second is G and third is B. |
In Color SensorType mode, if the application cannot handle multispectral images, it should use just the first plane.