IC Imaging Control C++

Grabber::startLive Method

Grabber::startLive Method

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

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.


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 MediaStreamSink, this method will start writing the image stream to an avi file on disk. If the active sink type is set to a frame sink, images can be grabbed.

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::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, video converters and embedded vision components for factory automation, quality assurance, medicine, science, security and a variety of other markets.

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

ISO 9001:2015 certified MVTEC | Edge AI + Vision Alliance | EMVA

Contact us