The FrameSnapSink is a sink type used to grab a number frames from the video stream on demand.

This sink is useful in situations where the application only needs access to the image data of some of the images, for example as part of a snapshot operation or at regular intervals. Live video can still be displayed as it is received by the device. If the application needs to process all images, the FrameQueueSink is the preferred option.

A simple example is shown here:

FrameSnapSink sink = new FrameSnapSink(MediaSubtypes.RGB32);
ICImagingControl1.Sink = sink;
// fetch a single image
IFrameQueueBuffer frame = sink.SnapSingle(TimeSpan.FromSeconds(5));
FrameExtensions.SaveAsBitmap( frame, "test.bmp");
FrameExtensions.SaveAsJpeg( frame, "test.jpg", 90);
FrameExtensions.SaveAsTiff( frame, "test.tiff");

The sink constructor FrameSnapSink is passed MediaSubtypes.RGB32 to specify that the sink wants to capture RGB32 color images.

The call to SnapSingle blocks until a new image is received from the video capture device, and returns that image in a newly allocated IFrameQueueBuffer.


    Namespace: TIS.Imaging
    Introduced in version 3.5




Property Description

Returns the FrameType of the IFrames used by this sink.


Method Description

Creates a new FrameSnapSink instance.


Waits for several images to arrive and then returns the result.


Waits for a single image to arrive and then returns the result

<< Classes