IC Imaging Control C++

Grabber::setVideoNorm Method

Grabber::setVideoNorm Method

This method sets the video of the currently active video capture device. A list of available video norms may be retrieved by calling Grabber::getAvailableVideoNorms.
Syntax:
bool setVideoNorm( const VideoNormItem& videonorm );
bool    setVideoNorm( const std::string& videonormstring );
bool    setVideoNorm( const std::wstring& videonormstring );
Parameter Description
videonorm

Specifies the new video norm to be used by the current video capture device.

videonormstring

Specifies the name of the new video norm to be used by the current video capture device.

Return value:

true, if the video norm was set successfully, false otherwise.

Remarks:

After changing the video norm, the current video format will become invalid. A new video format has to be set with Grabber::setVideoFormat before Grabber::startLive may be called. A list of available video formats may be retrieved by calling Grabber::getAvailableVideoFormats.

Note that the active MemBufferCollection will become invalid after a call to this method and there is no MemBufferCollection set. You have to create a new collection with Grabber::newMemBufferCollection and make it the active one by calling Grabber::setActiveMemBufferCollection.

See also: Grabber, VideoNormItem, Grabber::getAvailableVideoNorms, Grabber::isVideoNormAvailableWithCurDev

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