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 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