CogDisplay.StartLiveDisplay Method

CogDisplay StartLiveDisplay Method

Cognex VisionPro 9.20

Starts live image display using the specified acquisition FIFO.

Namespace: Cognex.VisionPro.Display
Assembly: Cognex.VisionPro.Display.Controls (in Cognex.VisionPro.Display.Controls.dll) Version: 80.0.0.0 (80.0.0.0)

Syntax

C++

Copy to Clipboard Print

public virtual void StartLiveDisplay(
	Object acqFifo,
	[OptionalAttribute] bool own
)

public virtual void StartLiveDisplay(
	Object acqFifo,
	[OptionalAttribute] bool own
)

Public Overridable Sub StartLiveDisplay ( 
	acqFifo As Object,
	<OptionalAttribute> own As Boolean
)

Public Overridable Sub StartLiveDisplay ( 
	acqFifo As Object,
	<OptionalAttribute> own As Boolean
)

public:
virtual void StartLiveDisplay(
	Object^ acqFifo, 
	[OptionalAttribute] bool own
)

public:
virtual void StartLiveDisplay(
	Object^ acqFifo, 
	[OptionalAttribute] bool own
)

Parameters

acqFifo: Type: System Object
The image source. Must implement ICogAcqFifo.

own (Optional): Type: System Boolean
If true, this method optimizes display performance, but there are some resitrctions on how you can use the FIFO.

Exceptions

Exception	Condition
AxHost InvalidActiveXStateException	Thrown when the display control is invalid.

Remarks

If own is true, StartLiveDisplay(Object, Boolean) optimizes display performance, but you should not attempt to use acqFifo to acquire images while live video is running.

If acqFifo's TriggerModel is Auto, own must be true.

See Acquiring from a Live Display to learn how to acquire images while displaying live video.

Examples

C++

Copy to Clipboard Print

using Cognex.VisionPro;

private CogFrameGrabbers myFrameGrabbers;
private ICogFrameGrabber myFrameGrabber;
private ICogAcqFifo myAcqFifo;

private void AcquireDisplay () {
    const string VIDEO_FORMAT = "Sony XC75 640x480";
    int    tNum;

    myFrameGrabbers = new CogFrameGrabbers();
    myFrameGrabber = myFrameGrabbers[0];
    myAcqFifo = myFrameGrabber.CreateAcqFifo(VIDEO_FORMAT, Cognex.VisionPro.CogAcqFifoPixelFormatConstants.Format8Grey, 0, false);

    cogDisplay1.StartLiveDisplay(myAcqFifo, false);
}

using Cognex.VisionPro;

private CogFrameGrabbers myFrameGrabbers;
private ICogFrameGrabber myFrameGrabber;
private ICogAcqFifo myAcqFifo;

private void AcquireDisplay () {
    const string VIDEO_FORMAT = "Sony XC75 640x480";
    int    tNum;

    myFrameGrabbers = new CogFrameGrabbers();
    myFrameGrabber = myFrameGrabbers[0];
    myAcqFifo = myFrameGrabber.CreateAcqFifo(VIDEO_FORMAT, Cognex.VisionPro.CogAcqFifoPixelFormatConstants.Format8Grey, 0, false);

    cogDisplay1.StartLiveDisplay(myAcqFifo, false);
}

Copy to Clipboard Print

Imports Cognex.VisionPro

Private myFrameGrabbers As CogFrameGrabbers
Private myFrameGrabber As Cognex.VisionPro.ICogFrameGrabber
Private myAcqFifo As Cognex.VisionPro.ICogAcqFifo

Private Sub AcquireDisplay()
    Const VIDEO_FORMAT = "Sony XC75 640x480"
    Dim tNum As Integer

    myFrameGrabbers = New CogFrameGrabbers
    myFrameGrabber = myFrameGrabbers.Item(0)
    myAcqFifo = myFrameGrabber.CreateAcqFifo(VIDEO_FORMAT, CogAcqFifoPixelFormatConstants.Format8Grey, 0, False)

        cogDisplay1.StartLiveDisplay(myAcqFifo, False);
End Sub

Imports Cognex.VisionPro

Private myFrameGrabbers As CogFrameGrabbers
Private myFrameGrabber As Cognex.VisionPro.ICogFrameGrabber
Private myAcqFifo As Cognex.VisionPro.ICogAcqFifo

Private Sub AcquireDisplay()
    Const VIDEO_FORMAT = "Sony XC75 640x480"
    Dim tNum As Integer

    myFrameGrabbers = New CogFrameGrabbers
    myFrameGrabber = myFrameGrabbers.Item(0)
    myAcqFifo = myFrameGrabber.CreateAcqFifo(VIDEO_FORMAT, CogAcqFifoPixelFormatConstants.Format8Grey, 0, False)

        cogDisplay1.StartLiveDisplay(myAcqFifo, False);
End Sub