IC Imaging Control C++

Grabber::setProperty Method

Grabber::setProperty Method

This method sets the value for a device property of the current video capture device to a specific value or activates/deactivates the "automatic mode" for this property.
Syntax:
bool setProperty( tCameraPropertyEnum CameraPropType, bool autom );
bool setProperty( tVideoPropertyEnum VideoPropType, bool autom );
bool setProperty( tCameraPropertyEnum CameraPropType, long val );
bool setProperty( tVideoPropertyEnum VideoPropType, long val );
Parameter Description
CameraPropType

Specifies the camera property to be set. The possible properties are specified by Grabber::tCameraPropertyEnum.

VideoPropType

Specifies the video property to be set. The possible properties are specified by Grabber::tVideoPropertyEnum.

autom

Specifies whether "automatic mode" will be enabled. true means: enable "automatic mode" and ignore the val parameter false means: disable "automatic mode" and use the val parameter

val

Set the property to the value val. The value should be in the range returned by Grabber::getPropertyRange for this property or an error occurs. The setting of a value will only work, if "automatic mode" is not specified and the property is supported by the currently active device.

Return value:

true, if the property was changed successfully, false otherwise.

Remarks:

A specific device supports only a subset of all defined properties. You can check whether a property is supported by the currently active device by calling Grabber::isPropertyAvailableWithCurDev.

"Automatic mode" is available only for a subset of the supported properties. To determine whether "automatic mode" is available for a certain property, call Grabber::isPropertyAutomationAvailableWithCurDev

To determine whether a property is set to "automatic mode" you have to call Grabber::isPropertyAutomationEnabled.

The default value for a property may be queried by calling Grabber::getPropertyDefault.

See also: Grabber, Grabber::getProperty, Grabber::getPropertyDefault, Grabber::getPropertyRange, Grabber::isPropertyAutomationEnabled, Grabber::isPropertyAvailableWithCurDev, Grabber::isPropertyAutomationAvailableWithCurDev, Grabber::tCameraPropertyEnum, Grabber::tVideoPropertyEnum

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