FrameSnapSink

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;
ICImagingControl1.LiveStart();
// fetch a single image
IFrameQueueBuffer frame = sink.SnapSingle(TimeSpan.FromSeconds(5));
frame.SaveAsBitmap("test.bmp");
frame.SaveAsJpeg("test.jpg", 90);
frame.SaveAsTiff("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.

Information

Namespace: TIS.Imaging
Introduced in version 3.5

Inheritance

BaseSink
FrameSnapSink

Properties

	Property		Description
	OutputFrameType		Returns the FrameType of the IFrames used by this sink.

Methods

	Method		Description
	FrameSnapSink		Creates a new FrameSnapSink instance.
	SnapSequence		Waits for several images to arrive and then returns the result.
	SnapSingle		Waits for a single image to arrive and then returns the result

<< Classes