Property Map

Represents the property interface of a component, usually a video capture device. More...

Data Structures

struct   IC4_PROPERTY_MAP

Represents the property interface of a component, usually a video capture device. More...

Typedefs

typedef void *(*  ic4_serialization_allocator) (size_t size)

Callback function called to allocate memory during the call of ic4_propmap_serialize_to_memory.

Functions

struct IC4_PROPERTY_MAP ic4_propmap_ref (struct IC4_PROPERTY_MAP *map)

Increases the property map's internal reference count by one.

void ic4_propmap_unref (struct IC4_PROPERTY_MAP *map)

Decreases the property map's internal reference count by one.

bool ic4_propmap_execute_command (struct IC4_PROPERTY_MAP *map, const char *prop_name)

Execute a command with a known name.

bool ic4_propmap_get_value_int64 (struct IC4_PROPERTY_MAP *map, const char *prop_name, int64_t *pValue)

Get the value of a property with a known name as an integer value.

bool ic4_propmap_get_value_double (struct IC4_PROPERTY_MAP *map, const char *prop_name, double *pValue)

Get the value of a property with a known name as a double value.

bool ic4_propmap_get_value_bool (struct IC4_PROPERTY_MAP *map, const char *prop_name, bool *pValue)

Get the value of a property with a known name as a bool value.

bool ic4_propmap_get_value_string (struct IC4_PROPERTY_MAP *map, const char *prop_name, char *buffer, size_t *buffer_size)

Get the value of a property with a known name as a string value.

bool ic4_propmap_set_value_int64 (struct IC4_PROPERTY_MAP *map, const char *prop_name, int64_t value)

Set the value of a property with a known name to the passed integer value.

bool ic4_propmap_set_value_double (struct IC4_PROPERTY_MAP *map, const char *prop_name, double value)

Set the value of a property with a known name to the passed double value.

bool ic4_propmap_set_value_bool (struct IC4_PROPERTY_MAP *map, const char *prop_name, bool value)

Set the value of a property with a known name to the passed bool value.

bool ic4_propmap_set_value_string (struct IC4_PROPERTY_MAP *map, const char *prop_name, const char *value)

Set the value of a property with a known name to the passed string value.

bool ic4_propmap_find (struct IC4_PROPERTY_MAP *map, const char *prop_name, struct IC4_PROPERTY **ppProperty)

Returns a property object representing the property with the passed name.

bool ic4_propmap_find_command (struct IC4_PROPERTY_MAP *map, const char *prop_name, struct IC4_PROPERTY **ppProperty)

Returns a property object representing the command property with the passed name.

bool ic4_propmap_find_integer (struct IC4_PROPERTY_MAP *map, const char *prop_name, struct IC4_PROPERTY **ppProperty)

Returns a property object representing the integer property with the passed name.

bool ic4_propmap_find_float (struct IC4_PROPERTY_MAP *map, const char *prop_name, struct IC4_PROPERTY **ppProperty)

Returns a property object representing the float property with the passed name.

bool ic4_propmap_find_boolean (struct IC4_PROPERTY_MAP *map, const char *prop_name, struct IC4_PROPERTY **ppProperty)

Returns a property object representing the boolean property with the passed name.

bool ic4_propmap_find_string (struct IC4_PROPERTY_MAP *map, const char *prop_name, struct IC4_PROPERTY **ppProperty)

Returns a property object representing the string property with the passed name.

bool ic4_propmap_find_enumeration (struct IC4_PROPERTY_MAP *map, const char *prop_name, struct IC4_PROPERTY **ppProperty)

Returns a property object representing the enumeration property with the passed name.

bool ic4_propmap_find_register (struct IC4_PROPERTY_MAP *map, const char *prop_name, struct IC4_PROPERTY **ppProperty)

Returns a property object representing the register property with the passed name.

bool ic4_propmap_find_category (struct IC4_PROPERTY_MAP *map, const char *prop_name, struct IC4_PROPERTY **ppProperty)

Returns a property object representing the category property with the passed name.

bool ic4_propmap_get_all (struct IC4_PROPERTY_MAP *map, struct IC4_PROPERTY_LIST **ppList)

Returns a list of all properties reachable from the property map's "Root" category.

bool ic4_propmap_connect_chunkdata (struct IC4_PROPERTY_MAP *map, struct IC4_IMAGE_BUFFER *image_buffer)

Enables the use of the chunk data in the passed IC4_IMAGE_BUFFER as a backend for chunk properties in the property map.

bool ic4_propmap_serialize_to_file (struct IC4_PROPERTY_MAP *map, const char *path)

Saves the state of the properties in this property map into a file.

bool ic4_propmap_serialize_to_memory (struct IC4_PROPERTY_MAP *map, ic4_serialization_allocator alloc, void **ppData, size_t *data_size)

Saves the state of the properties in this property map in a memory buffer.

bool ic4_propmap_deserialize_from_file (struct IC4_PROPERTY_MAP *map, const char *path)

Restores the state of the properties in this property map from a file that was previously written by ic4_propmap_serialize_to_file.

bool ic4_propmap_deserialize_from_memory (struct IC4_PROPERTY_MAP *map, const void *pData, size_t data_size)

Restores the state of the properties in this property map from a memory buffer containing data that was previously written by ic4_propmap_serialize_to_memory.

Detailed Description

Represents the property interface of a component, usually a video capture device.

Typedef Documentation

◆ ic4_serialization_allocator

typedef void *(* ic4_serialization_allocator) (size_t size)

Callback function called to allocate memory during the call of ic4_propmap_serialize_to_memory.

Parameters
[in]sizeSize of the memory buffer to be allocated.
Returns
The pointer to the allocated memory buffer, or NULL if the allocation was not possible.
Note
If this function returns NULL, the call to ic4_propmap_serialize_to_memory will fail.
See also
ic4_propmap_serialize_to_memory

Function Documentation

◆ ic4_propmap_connect_chunkdata()

bool ic4_propmap_connect_chunkdata ( struct IC4_PROPERTY_MAP map,
struct IC4_IMAGE_BUFFER image_buffer 
)

Enables the use of the chunk data in the passed IC4_IMAGE_BUFFER as a backend for chunk properties in the property map.

Parameters
[in]mapA property map
[in]image_bufferAn image buffer with chunk data.
This parameter may be NULL to disconnect the previously connected buffer.
Returns
true on success, otherwise false.
Use ic4_get_last_error() to query error information.
Remarks
The property map takes a reference to the passed image buffer, extending its lifetime and preventing automatic reuse. The reference is released when a new image buffer is connected to the property map, or NULL is passed in the image_buffer argument.

◆ ic4_propmap_deserialize_from_file()

bool ic4_propmap_deserialize_from_file ( struct IC4_PROPERTY_MAP map,
const char *  path 
)

Restores the state of the properties in this property map from a file that was previously written by ic4_propmap_serialize_to_file.

Parameters
[in]mapA property map
[in]pathPath to a file that was previously written by ic4_propmap_serialize_to_file
Returns
true on success, otherwise false.
Use ic4_get_last_error() to query error information.
Note
If the file contains settings for properties that could not be written, the function fails and the error value is set to IC4_ERROR_INCOMPLETE.
See also
ic4_propmap_serialize_to_file

◆ ic4_propmap_deserialize_from_memory()

bool ic4_propmap_deserialize_from_memory ( struct IC4_PROPERTY_MAP map,
const void *  pData,
size_t  data_size 
)

Restores the state of the properties in this property map from a memory buffer containing data that was previously written by ic4_propmap_serialize_to_memory.

Parameters
[in]mapA property map
[in]pDataPointer to a memory buffer containing data that was written by ic4_propmap_serialize_to_memory
[in]data_sizeSize of the memory buffer pointed to by pData
Returns
true on success, otherwise false.
Use ic4_get_last_error() to query error information.
Note
If the memory buffer contains settings for properties that could not be written, the function fails and the error value is set to IC4_ERROR_INCOMPLETE.
See also
ic4_propmap_serialize_to_memory

◆ ic4_propmap_execute_command()

bool ic4_propmap_execute_command ( struct IC4_PROPERTY_MAP map,
const char *  prop_name 
)

Execute a command with a known name.

Parameters
[in]mapA property map
[in]prop_nameName of a command property inside map
Returns
true on success, otherwise false.
Use ic4_get_last_error() to query error information.
Remarks
If there is no with the name prop_name in map, the function fails and the error value is set to IC4_ERROR_GENICAM_FEATURE_NOT_FOUND.
If there is a property with the name prop_name, but it is not a command property, the function fails and the error value is set to IC4_ERROR_GENICAM_TYPE_MISMATCH.

◆ ic4_propmap_find()

bool ic4_propmap_find ( struct IC4_PROPERTY_MAP map,
const char *  prop_name,
struct IC4_PROPERTY **  ppProperty 
)

Returns a property object representing the property with the passed name.

Parameters
[in]mapA property map
[in]prop_nameThe name of a property inside map
[out]ppPropertyPointer to a handle receiving the property object When the property is no longer required, release the object reference using ic4_prop_unref().
Returns
true on success, otherwise false.
Use ic4_get_last_error() to query error information.
Remarks
If there is no property with the name prop_name inside map, the function fails and the error value is set to IC4_ERROR_GENICAM_FEATURE_NOT_FOUND.

◆ ic4_propmap_find_boolean()

bool ic4_propmap_find_boolean ( struct IC4_PROPERTY_MAP map,
const char *  prop_name,
struct IC4_PROPERTY **  ppProperty 
)

Returns a property object representing the boolean property with the passed name.

Parameters
[in]mapA property map
[in]prop_nameThe name of a boolean property inside map
[out]ppPropertyPointer to a handle receiving the property object When the property is no longer required, release the object reference using ic4_prop_unref().
Returns
true on success, otherwise false.
Use ic4_get_last_error() to query error information.
Remarks
If there is no property with the name prop_name inside map, the function fails and the error value is set to IC4_ERROR_GENICAM_FEATURE_NOT_FOUND.
If there is a property with the name prop_name, but it is not a boolean property, the function fails and the error value is set to IC4_ERROR_GENICAM_TYPE_MISMATCH.

◆ ic4_propmap_find_category()

bool ic4_propmap_find_category ( struct IC4_PROPERTY_MAP map,
const char *  prop_name,
struct IC4_PROPERTY **  ppProperty 
)

Returns a property object representing the category property with the passed name.

Parameters
[in]mapA property map
[in]prop_nameThe name of a category property inside map
[out]ppPropertyPointer to a handle receiving the property object When the property is no longer required, release the object reference using ic4_prop_unref().
Returns
true on success, otherwise false.
Use ic4_get_last_error() to query error information.
Remarks
If there is no property with the name prop_name inside map, the function fails and the error value is set to IC4_ERROR_GENICAM_FEATURE_NOT_FOUND.
If there is a property with the name prop_name, but it is not a category property, the function fails and the error value is set to IC4_ERROR_GENICAM_TYPE_MISMATCH.

◆ ic4_propmap_find_command()

bool ic4_propmap_find_command ( struct IC4_PROPERTY_MAP map,
const char *  prop_name,
struct IC4_PROPERTY **  ppProperty 
)

Returns a property object representing the command property with the passed name.

Parameters
[in]mapA property map
[in]prop_nameThe name of a command property inside map
[out]ppPropertyPointer to a handle receiving the property object When the property is no longer required, release the object reference using ic4_prop_unref().
Returns
true on success, otherwise false.
Use ic4_get_last_error() to query error information.
Remarks
If there is no property with the name prop_name inside map, the function fails and the error value is set to IC4_ERROR_GENICAM_FEATURE_NOT_FOUND.
If there is a property with the name prop_name, but it is not a command property, the function fails and the error value is set to IC4_ERROR_GENICAM_TYPE_MISMATCH.

◆ ic4_propmap_find_enumeration()

bool ic4_propmap_find_enumeration ( struct IC4_PROPERTY_MAP map,
const char *  prop_name,
struct IC4_PROPERTY **  ppProperty 
)

Returns a property object representing the enumeration property with the passed name.

Parameters
[in]mapA property map
[in]prop_nameThe name of an enumeration property inside map
[out]ppPropertyPointer to a handle receiving the property object When the property is no longer required, release the object reference using ic4_prop_unref().
Returns
true on success, otherwise false.
Use ic4_get_last_error() to query error information.
Remarks
If there is no property with the name prop_name inside map, the function fails and the error value is set to IC4_ERROR_GENICAM_FEATURE_NOT_FOUND.
If there is a property with the name prop_name, but it is not an enumeration property, the function fails and the error value is set to IC4_ERROR_GENICAM_TYPE_MISMATCH.

◆ ic4_propmap_find_float()

bool ic4_propmap_find_float ( struct IC4_PROPERTY_MAP map,
const char *  prop_name,
struct IC4_PROPERTY **  ppProperty 
)

Returns a property object representing the float property with the passed name.

Parameters
[in]mapA property map
[in]prop_nameThe name of a float property inside map
[out]ppPropertyPointer to a handle receiving the property object When the property is no longer required, release the object reference using ic4_prop_unref().
Returns
true on success, otherwise false.
Use ic4_get_last_error() to query error information.
Remarks
If there is no property with the name prop_name inside map, the function fails and the error value is set to IC4_ERROR_GENICAM_FEATURE_NOT_FOUND.
If there is a property with the name prop_name, but it is not a float property, the function fails and the error value is set to IC4_ERROR_GENICAM_TYPE_MISMATCH.

◆ ic4_propmap_find_integer()

bool ic4_propmap_find_integer ( struct IC4_PROPERTY_MAP map,
const char *  prop_name,
struct IC4_PROPERTY **  ppProperty 
)

Returns a property object representing the integer property with the passed name.

Parameters
[in]mapA property map
[in]prop_nameThe name of an integer property inside map
[out]ppPropertyPointer to a handle receiving the property object When the property is no longer required, release the object reference using ic4_prop_unref().
Returns
true on success, otherwise false.
Use ic4_get_last_error() to query error information.
Remarks
If there is no property with the name prop_name inside map, the function fails and the error value is set to IC4_ERROR_GENICAM_FEATURE_NOT_FOUND.
If there is a property with the name prop_name, but it is not an integer property, the function fails and the error value is set to IC4_ERROR_GENICAM_TYPE_MISMATCH.

◆ ic4_propmap_find_register()

bool ic4_propmap_find_register ( struct IC4_PROPERTY_MAP map,
const char *  prop_name,
struct IC4_PROPERTY **  ppProperty 
)

Returns a property object representing the register property with the passed name.

Parameters
[in]mapA property map
[in]prop_nameThe name of a register property inside map
[out]ppPropertyPointer to a handle receiving the property object When the property is no longer required, release the object reference using ic4_prop_unref().
Returns
true on success, otherwise false.
Use ic4_get_last_error() to query error information.
Remarks
If there is no property with the name prop_name inside map, the function fails and the error value is set to IC4_ERROR_GENICAM_FEATURE_NOT_FOUND.
If there is a property with the name prop_name, but it is not a register property, the function fails and the error value is set to IC4_ERROR_GENICAM_TYPE_MISMATCH.

◆ ic4_propmap_find_string()

bool ic4_propmap_find_string ( struct IC4_PROPERTY_MAP map,
const char *  prop_name,
struct IC4_PROPERTY **  ppProperty 
)

Returns a property object representing the string property with the passed name.

Parameters
[in]mapA property map
[in]prop_nameThe name of a string property inside map
[out]ppPropertyPointer to a handle receiving the property object When the property is no longer required, release the object reference using ic4_prop_unref().
Returns
true on success, otherwise false.
Use ic4_get_last_error() to query error information.
Remarks
If there is no property with the name prop_name inside map, the function fails and the error value is set to IC4_ERROR_GENICAM_FEATURE_NOT_FOUND.
If there is a property with the name prop_name, but it is not a string property, the function fails and the error value is set to IC4_ERROR_GENICAM_TYPE_MISMATCH.

◆ ic4_propmap_get_all()

bool ic4_propmap_get_all ( struct IC4_PROPERTY_MAP map,
struct IC4_PROPERTY_LIST **  ppList 
)

Returns a list of all properties reachable from the property map's "Root" category.

Parameters
[in]mapA property map
[out]ppListA pointer to a property list receiving the list of properties.
When the property list is no longer required, release the object reference using ic4_proplist_unref().
Note
This generated list does not include category properties.
Returns
true on success, otherwise false.
Use ic4_get_last_error() to query error information.

◆ ic4_propmap_get_value_bool()

bool ic4_propmap_get_value_bool ( struct IC4_PROPERTY_MAP map,
const char *  prop_name,
bool *  pValue 
)

Get the value of a property with a known name as a bool value.

The behavior depends on the type of the property:

  • For boolean properties, the value is returned directly.
  • For enumeration properties, a value is returned if the name of the currently selected entry unambiguously suggests to represent true or false.
  • For all other property types, the call results in an error (IC4_ERROR_GENICAM_TYPE_MISMATCH).
Parameters
[in]mapA property map
[in]prop_nameName of a property inside map
[out]pValuePointer to a double to receive the value of the property
Returns
true on success, otherwise false.
Use ic4_get_last_error() to query error information.
Remarks
If there is no property with the name prop_name in map, the function fails and the error value is set to IC4_ERROR_GENICAM_FEATURE_NOT_FOUND.

◆ ic4_propmap_get_value_double()

bool ic4_propmap_get_value_double ( struct IC4_PROPERTY_MAP map,
const char *  prop_name,
double *  pValue 
)

Get the value of a property with a known name as a double value.

The behavior depends on the type of the property:

  • For integer properties, the value is converted to double.
  • For float properties, the value is returned directly.
  • For all other property types, the call results in an error (IC4_ERROR_GENICAM_TYPE_MISMATCH).
Parameters
[in]mapA property map
[in]prop_nameName of a property inside map
[out]pValuePointer to a double to receive the value of the property
Returns
true on success, otherwise false.
Use ic4_get_last_error() to query error information.
Remarks
If there is no property with the name prop_name in map, the function fails and the error value is set to IC4_ERROR_GENICAM_FEATURE_NOT_FOUND.

◆ ic4_propmap_get_value_int64()

bool ic4_propmap_get_value_int64 ( struct IC4_PROPERTY_MAP map,
const char *  prop_name,
int64_t *  pValue 
)

Get the value of a property with a known name as an integer value.

The behavior depends on the type of the property:

  • For integer properties, the value is returned directly.
  • For boolean properties, the value returned is 1 or 0.
  • For all other property types, the call results in an error (IC4_ERROR_GENICAM_TYPE_MISMATCH).
Parameters
[in]mapA property map
[in]prop_nameName of a property inside map
[out]pValuePointer to an integer to receive the value of the property
Returns
true on success, otherwise false.
Use ic4_get_last_error() to query error information.
Remarks
If there is no property with the name prop_name in map, the function fails and the error value is set to IC4_ERROR_GENICAM_FEATURE_NOT_FOUND.

◆ ic4_propmap_get_value_string()

bool ic4_propmap_get_value_string ( struct IC4_PROPERTY_MAP map,
const char *  prop_name,
char *  buffer,
size_t *  buffer_size 
)

Get the value of a property with a known name as a string value.

The behavior depends on the type of the property:

  • For integer properties, the value is converted to a string
  • For float properties, the value is converted to a string
  • For boolean properties, the value is converted to the string "true" or "false".
  • For enumeration properties, the name of the currently selected entry is returned.
  • For string properties, the value is returned directly.
  • For all other property types, the call results in an error (IC4_ERROR_GENICAM_TYPE_MISMATCH).
Parameters
[in]mapA property map
[in]prop_nameName of a property inside map
[out]bufferPointer to a character array to receive the string value.
This parameter can be NULL to find out the required space without allocating an initial array.
[in,out]buffer_sizePointer to a size_t describing the length of the array pointed to by buffer.
The function always writes the actual number of characters required to store the string representation.
Returns
true on success, otherwise false.
Use ic4_get_last_error() to query error information.
Remarks
If there is no property with the name prop_name in map, the function fails and the error value is set to IC4_ERROR_GENICAM_FEATURE_NOT_FOUND.

◆ ic4_propmap_ref()

struct IC4_PROPERTY_MAP * ic4_propmap_ref ( struct IC4_PROPERTY_MAP map)

Increases the property map's internal reference count by one.

Parameters
[in]mapA property map
Returns
The pointer passed via map
Remarks
If map is NULL, the function returns NULL. An error value is not set.
See also
ic4_propmap_unref

◆ ic4_propmap_serialize_to_file()

bool ic4_propmap_serialize_to_file ( struct IC4_PROPERTY_MAP map,
const char *  path 
)

Saves the state of the properties in this property map into a file.

Parameters
[in]mapA property map
[in]pathA path to a file that the property state is written to
Returns
true on success, otherwise false.
Use ic4_get_last_error() to query error information.
Note
The actual set of properties that is stored by this function is controlled by the object the property map belongs to.
To restore the properties at a later time, use ic4_propmap_deserialize_from_file.
See also
ic4_propmap_deserialize_from_file
ic4_propmap_serialize_to_memory

◆ ic4_propmap_serialize_to_memory()

bool ic4_propmap_serialize_to_memory ( struct IC4_PROPERTY_MAP map,
ic4_serialization_allocator  alloc,
void **  ppData,
size_t *  data_size 
)

Saves the state of the properties in this property map in a memory buffer.

Parameters
[in]mapA property map
[in]allocPointer to a function that allocates the memory buffer.
For example, malloc can be passed here.
[out]ppDataPointer to a pointer to receive the newly-allocated memory buffer containing the properties.
The caller is responsible for releasing the memory, using a function that can free memory returned by alloc.
[out]data_sizePointer to size_t to receive the size of the memory buffer allocated by the call
Returns
true on success, otherwise false.
Use ic4_get_last_error() to query error information.
Note
The actual set of properties that is stored by this function is controlled by the object the property map belongs to.
To restore the properties at a later time, use ic4_propmap_deserialize_from_memory.
See also
ic4_propmap_deserialize_from_memory
ic4_propmap_serialize_to_file

◆ ic4_propmap_set_value_bool()

bool ic4_propmap_set_value_bool ( struct IC4_PROPERTY_MAP map,
const char *  prop_name,
bool  value 
)

Set the value of a property with a known name to the passed bool value.

The behavior depends on the type of the property:

  • For boolean properties, the value is set directly.
  • For enumeration properties, it selects the entry with a name that unambiguously suggests to represent true or false, if available.
  • For command properties, the command is executed if value is true.
  • For all other property types, the call results in an error (IC4_ERROR_GENICAM_TYPE_MISMATCH).
Parameters
[in]mapA property map
[in]prop_nameName of a property inside map
[in]valueNew value to be set for the property identified by prop_name
Returns
true on success, otherwise false.
Use ic4_get_last_error() to query error information.
Remarks
If there is no property with the name prop_name in map, the function fails and the error value is set to IC4_ERROR_GENICAM_FEATURE_NOT_FOUND.

◆ ic4_propmap_set_value_double()

bool ic4_propmap_set_value_double ( struct IC4_PROPERTY_MAP map,
const char *  prop_name,
double  value 
)

Set the value of a property with a known name to the passed double value.

The behavior depends on the type of the property:

  • For integer properties, the value is rounded to the nearest integer.
  • For float properties, the value is set directly.
  • For all other property types, the call results in an error (IC4_ERROR_GENICAM_TYPE_MISMATCH).
Parameters
[in]mapA property map
[in]prop_nameName of a property inside map
[in]valueNew value to be set for the property identified by prop_name
Returns
true on success, otherwise false.
Use ic4_get_last_error() to query error information.
Remarks
If there is no property with the name prop_name in map, the function fails and the error value is set to IC4_ERROR_GENICAM_FEATURE_NOT_FOUND.

◆ ic4_propmap_set_value_int64()

bool ic4_propmap_set_value_int64 ( struct IC4_PROPERTY_MAP map,
const char *  prop_name,
int64_t  value 
)

Set the value of a property with a known name to the passed integer value.

The behavior depends on the type of the property:

  • For integer properties, the value is set directly.
  • For float properties, the value is set directly.
  • For boolean properties, if the value is 1 or 0, it is set to true or false respectively. Other values result in an error.
  • For enumeration properties, the numeric value is set if the property is PixelFormat. Other properties result in an error.
  • For command properties, the command is executed if value is 1.
  • For all other property types, the call results in an error (IC4_ERROR_GENICAM_TYPE_MISMATCH).
Parameters
[in]mapA property map
[in]prop_nameName of a property inside map
[in]valueNew value to be set for the property identified by prop_name
Returns
true on success, otherwise false.
Use ic4_get_last_error() to query error information.
Remarks
If there is no property with the name prop_name in map, the function fails and the error value is set to IC4_ERROR_GENICAM_FEATURE_NOT_FOUND.

◆ ic4_propmap_set_value_string()

bool ic4_propmap_set_value_string ( struct IC4_PROPERTY_MAP map,
const char *  prop_name,
const char *  value 
)

Set the value of a property with a known name to the passed string value.

The behavior depends on the type of the property:

  • For integer properties, the string is parsed, and the found integer value is set
  • For float properties, the string is parsed, and the found floating-point value is set
  • For boolean properties, a value is set if the string can be unambiguously identified to represent true or false.
  • For enumeration properties, the entry with a name or display name matching the value is set.
  • For string properties, the value is set directly.
  • For command properties, the command is executed if value is "1", "true" or "execute".
  • For all other property types, the call results in an error (IC4_ERROR_GENICAM_TYPE_MISMATCH).
Parameters
[in]mapA property map
[in]prop_nameName of a property inside map
[in]valueNew value to be set for the property identified by prop_name
Returns
true on success, otherwise false.
Use ic4_get_last_error() to query error information.
Remarks
If there is no property with the name prop_name in map, the function fails and the error value is set to IC4_ERROR_GENICAM_FEATURE_NOT_FOUND.

◆ ic4_propmap_unref()

void ic4_propmap_unref ( struct IC4_PROPERTY_MAP map)

Decreases the property map's internal reference count by one.

If the reference count reaches zero, the object is destroyed.

Parameters
[in]mapA property map
Remarks
If map is NULL, the function does nothing. An error value is not set.
IC4_PROPERTY objects retrieved from this property map will stay valid after the property map has been destroyed.
See also
ic4_propmap_ref