IVideoFramePreviewBitmap Property

Returns a preview bitmap for the last video frame as an array of byte.

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

Syntax

C++

Copy

byte[] PreviewBitmap { get; }

ReadOnly Property PreviewBitmap As Byte()
	Get

property array<unsigned char>^ PreviewBitmap {
	array<unsigned char>^ get ();
}

Property Value

Byte
The preview bitmap image.

Exceptions

Exception	Condition
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.

Remarks

Must be implemented, must not throw an ASCOM.PropertyNotImplementedException.

The application can use this bitmap to show a preview image of the last video frame when required. This is a convenience property for those applications that don't require to process the ImageArray but usually only adjust the video camera settings and then record a video file.

When a 24bit RGB image can be returned by the driver this should be the preferred format.

Example

The following code can be used to create a Bitmap from the returned byte array

C++

Copy

using (var memStr = new MemoryStream(frame.PreviewBitmap))
{
bmp = (Bitmap)Image.FromStream(memStr);
}

Using memStr = New MemoryStream(frame.PreviewBitmap)
bmp = DirectCast(Image.FromStream(memStr), Bitmap)
End Using

Reference

IVideoFrame Interface

ASCOM.DeviceInterface Namespace