IC Imaging Control C++

Grabber::startLive Method

Grabber::startLive Method

Puts the grabber in live mode.
Syntax:
bool startLive( bool show = true );
Parameter Description
show

Specifies whether the image stream is displayed while the grabber is in live mode.

Return value:

true, if the live mode was started successfully, false otherwise.

Remarks:

This method starts the image stream and has to be called before you can grab images. The bool parameter of this method specifies whether a live image is displayed or not. If the active sink type is set to an AviSink, this method will start writing the image stream to an avi file on disk. If the active sink type is set to FrameGrabberSink, images can be grabbed. Please refer to FrameGrabberSink for details on grabbing images.

In order to display a live image in a window, you have to set a handle to this window first, using the Grabber::setHWND method. If no window handle is set, a new window called "Active Movie" will be opened and the live image will be displayed there.

The live mode can be stopped with the Grabber::stopLive method. If the grabber becomes invalid (e.g. it gets unplugged) while in live mode, the live mode will be stopped internally.

Note: a valid video format has to be set after a call to Grabber::openDev before startLive may be called. Please refer to Grabber::setVideoFormat for details on setting a valid video format.

See also: Grabber, Grabber::isLive, Grabber::openDev, Grabber::setVideoFormat, Grabber::snapImages, Grabber::stopLive

<< Grabber

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