Imaging Control 4 C Library 1.2.0
Loading...
Searching...
No Matches
Properties

Functions used to query, read or change properties of a component, usually the video capture device. More...

Modules

 Property Map
 Represents the property interface of a component, usually a video capture device.
 
 Property Objects
 Represents a property of a component, usually of a video capture device.
 
 Property Lists
 Property lists represent groups of properties.
 
 Property Identifiers
 A lot of common property identifiers are described here.
 

Detailed Description

Functions used to query, read or change properties of a component, usually the video capture device.

Properties are accessed through a IC4_PROPERTY_MAP. For example, to get the property map for the device properties of the video capture device opened by a grabber, call ic4_grabber_device_get_property_map().

Each property is identified by a string identifier, for example ExposureTime or Gain. Many property identifiers are defined by the GenICam Standard Feature Naming Convention (SFNC), but devices can also have additional device-specific properties.

Each property has a display name, a description, a type, and visibility and availability information. The display name can be used in user interfaces to show a friendly name for the property, while the description can contain additional information about the property's meaning and/or usage.

There are functions to directly interact with properties, such as ic4_propmap_set_value_int64() or ic4_propmap_set_value_double() that can be used to quickly configure the value of a property with a known type and value.

Detailed property information and configuration is achieved through an object-oriented interface. To get create a property object (IC4_PROPERTY), call ic4_propmap_find(), passing the property's known identifier.

A property object can be interogated for generic property attributes, for example

Each type has different methods of interaction and can provide additional type-dependent information: