IC Imaging Control .NET

FrameNotificationSink

FrameNotificationSink

The FrameNotificationSink is the most direct way to get images from a video capture device. This means that no copy will be done from driver memory to application memory.

This sink is most useful when the application needs to copy the image data into buffers of a third-party image processing library, because it is possible to avoid a copy operation.

A simple example is shown here:

class Listener : IFrameNotificationSinkListener
{
    public void SinkConnected(FrameType frameType) { }
    public void SinkDisconnected() { }
    public void FrameReceived(IFrame frame)
    {
        // do something with frame
    }
}

var listener = new Listener();
var sink = new FrameNotificationSink(listener);
ICImagingControl1.Sink = sink;

The sink constructor FrameNotificationSink is passed an instance of a class implementing the IFrameNotificationSinkListener interface. When images are received from the device, the listener's FrameReceived method is called.

It is imperative for the code inside the callback function to return quickly, because there is no buffering in the sink. There is no guarantee for the callback to be called for every frame if the system load is high, or the function takes a long time to complete compared to the frame interval.

Information

Namespace: TIS.Imaging
Introduced in version 3.5

Inheritance

BaseSink
FrameNotificationSink

Properties

Property Description
OutputFrameType

Returns the FrameType of the IFrames used by this sink.

Methods

Method Description
FrameNotificationSink

Creates a new FrameNotificationSink.

<< Classes

Get in touch with us


About The Imaging Source

Established in 1990, The Imaging Source is one of the leading manufacturers of industrial cameras, frame grabbers and video converters for production automation, quality assurance, logistics, medicine, science and security.

Our comprehensive range of cameras with USB 3.1, USB 3.0, USB 2.0, GigE interfaces and other innovative machine vision products are renowned for their high quality and ability to meet the performance requirements of demanding applications.

Automated Imaging Association ISO 9001:2015 certified

Contact us