Camera Attributes

Camera attributes allow control and monitoring of various camera and driver parameters. This section details attribute types and associated functions that enable developers to interact with specific settings and features of the camera.

Attribute types and related functions

The camera supports multiple attribute types, each with designated functions for reading and writing values. Here’s a breakdown of the attribute types and the relevant functions:

• Enumeration (Enum) attributes: Represent a list of selectable values as strings.
  • Get function: EVT_CameraGetEnumParam
  • Set function: EVT_CameraSetEnumParam
  • Range function: EVT_CameraGetEnumParamRange
• UInt32 attributes: Provide a 32-bit unsigned integer value.
  • Get function: EVT_CameraGetUInt32Param
  • Set function: EVT_CameraSetUInt32Param
  • Additional functions:
    • Minimum value: EVT_CameraGetUInt32ParamMin
    • Maximum value: EVT_CameraGetUInt32ParamMax
    • Increment step: EVT_CameraGetUInt32ParamInc
• Int32 attributes: Provide a 32-bit signed integer value.
  • Get function: EVT_CameraGetInt32Param
  • Set function: EVT_CameraSetInt32Param
  • Additional functions:
    • Minimum value: EVT_CameraGetInt32ParamMin
    • Maximum value: EVT_CameraGetInt32ParamMax
    • Increment step: EVT_CameraGetInt32ParamInc‍
• Float attributes: Provide a float value.
  • Get function: EVT_CameraGetFloatParam‍
  • Set function: EVT_CameraSetFloatParam‍
  • Additional functions:
    • Minimum value: EVT_CameraGetFloatParamMin‍
    • Maximum value: EVT_CameraGetFloatParamMax‍
    • Value unit: EVT_CameraGetFloatParamUnit‍
• String attributes: Text-based attribute values, useful for descriptive or configurable text parameters.
  • Get function: EVT_CameraGetStringParam‍
  • Set function: EVT_CameraSetStringParam‍
• Boolean attributes: Represent a simple true or false setting.
  • Get function: EVT_CameraGetBoolParam‍
  • Set function: EVT_CameraSetBoolParam‍
• Command: Executes a command attribute. Unlike other types, this is valueless and only triggers an action.
  • Execute function: EVT_CameraExecuteCommand

Using attribute functions

Each attribute type’s functions facilitate smooth camera configuration, such as setting exposure or triggering specific commands. For example, to adjust exposure time:

EVT_CameraSetUInt32Param(Camera, "Exposure", 1000); // Sets exposure time to 1000 µs

‍

Range and increment retrieval: For UInt32 and Int32 attributes, functions are available to retrieve minimum and maximum values and increment steps. This capability allows developers to validate input values programmatically, ensuring compatibility with the camera’s supported parameters.