Flags¶
Properties can have the following flags:
TCAM_PROPERTY_FLAG_DISABLED¶
Bit: 0x0001
This control is permanently disabled and should be ignored by the application. Any attempt to change the control will result in an EINVAL error code.
TCAM_PROPERTY_FLAG_GRABBED¶
Bit: 0x0002
This control is temporarily unchangeable, for example because another application took over control of the respective resource. Such controls may be displayed specially in a user interface. Attempts to change the control may result in an EBUSY error code.
TCAM_PROPERTY_FLAG_EXTERNAL¶
Bit: 0x0008
This control is realized through library code and is not available in the camera
TCAM_PROPERTY_FLAG_INACTIVE¶
Bit: 0x0010
This control is not applicable to the current configuration and should be displayed accordingly in a user interface. For example whitebalance may be disabled when retrieving a greyscale image stream.
TCAM_PROPERTY_FLAG_WRITE_ONLY¶
Bit: 0x0020
This control is permanently writable only. Any attempt to read the control will result in an EACCES error code error code. This flag is typically present for relative controls or action controls where writing a value will cause the device to carry out a given action (e. g. motor control) but no meaningful value can be returned.
TCAM_PROPERTY_FLAG_IS_LOGARITHMIC¶
Bit: 0x0040
This control should be displayed using a logarithmic scale as most actions will take place in a small part of the overall range.
TCAM_PROPERTY_FLAG_REQUIRES_RESTART¶
Bit: 0x0080
This control requires a restart of the stream to be applied.