IC Imaging Control C++

Grabber::saveDeviceState Method

Grabber::saveDeviceState Method

Saves the state of the opened device. A saved state can be restored using loadDeviceState.
Syntax:
std::string saveDeviceState( bool bDevice = true, bool bGrabberDeviceSetup = true, bool bVCDProperties = true ) const;
std::wstring    saveDeviceStateW( bool bDevice = true, bool bGrabberDeviceSetup = true, bool bVCDProperties = true ) const;

Parameter Description
bDevice

When this parameter is set to true, the currently opened device's name and serial number are saved.

bGrabberDeviceSetup

When this parameter is set to true, the currently selected Video Norm, Video Format, Input Channel, FPS, FlipH and FlipV are saved.

bVCDProperties

When this parameter is set to true, the VCDProperties of the currently opened device are saved.

Return value:

Returns a string that contains the device settings. The string is formatted in XML. On error, an empty string is returned. Use Grabber::getLastError to verify whether or not an error occurred.

Information:

Introduced in version 2.0

Sample:
// Retrieve the device state.
std::wstring deviceState = m_Grabber.saveDeviceStateW();
MessageBox( deviceState.c_str(), L"Saved device state" );
// Close the device.
m_Grabber.closeDev();
// The device is now closed. Open the saved device.
m_Grabber.loadDeviceState( deviceState );
// Show live video again.
m_Grabber.startLive();

See also: loadDeviceState

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