Properties¶
These properties are available via the ‘TcamPropertyProvider’ interface, specified in the tiscamera-tcamprop library.
The properties that tcamdutils will offer depend on the currently used transformation and the properties the camera provides. Changing the input/output formats will potentially change the available properties. Many will only be available once the state is set to PLAYING.
If your camera has an internal implementation of a property, e.g. ‘ExposureTimeAuto’, then tcamdutils will not offer the property and disable the internal algorithms for said property.
Exposure Auto¶
If the camera does not have Exposure Auto property but one of Exposure Time (us), ExposureTime or Exposure, tcamdutils creates the following properties:
The property Highlight Reduction will be generated when tcamdutils generates Exposure Auto.
| Name | Description |
|---|---|
| ExposureAuto | Sets the automatic exposure control mode. |
| ExposureAutoLowerLimit | Lower limit of the ExposureAuto function. |
| ExposureAutoUpperLimit | Upper limit of the ExposureAuto function. |
| ExposureAutoUpperLimitAuto | Automatically sets the upper limit to match the Acquisition Frame Rate. |
| ExposureAutoReference | Configures the target image brightness of the ExposureAuto/GainAuto algorithm. |
| ExposureAutoHighlightReduction | Lets the ExposureAuto/GainAuto algorithm try to avoid over-exposures. |
Gain Auto¶
If the camera does not have Gain Auto but has a Gain property, tcamdutils creates the following properties:
| Name | Description |
|---|---|
| GainAuto | Sets the automatic gain control (AGC) mode.” |
| GainAutoLowerLimit | Lower limit of the GainAuto function. |
| GainAutoUpperLimit | Upper limit of the GainAuto function. |
BalanceWhite Auto¶
If the camera does not have WhtieBalance Auto and the caps selected can have WhiteBalance applied (see Conversion Table), tcamdutils creates the following properties:
| Name | Description |
|---|---|
| BalanceWhiteAuto | Controls the mode for automatic white balancing between the color channels. The white balancing ratios are automatically adjusted. |
| BalanceWhiteRed | Adjusts the White Balance for the Red color channel. |
| BalanceWhiteGreen | Adjusts the White Balance for the Green color channel. |
| BalanceWhiteBlue | Adjusts the White Balance for the Blue color channel. |
Additional Auto Properties¶
The property IrisAuto will be generated when the device has an Iris property, but no IrisAuto.
The property FocusAuto will be generated when the device has an Focus property, but no FocusAuto.
| Name | Description |
|---|---|
| IrisAuto | Enables the automatic Iris setting selection. |
| FocusAuto | Enables the automatic Focus setting selection. |
Additional Properties¶
These will be generated when supported transform caps are selected
| Name | Description |
|---|---|
| Denoise | Controls the strength of the denoise algorithm. |
| Sharpness | Controls the strength of the sharpness algorithm. |
| TonemappingEnable | Enables the tonemapping algorithm. |
| TonemappingGlobalBrightness | Changes the brightness reference used for a individual pixel, which is interpolated between local and global. |
| TonemappingIntensity | Adjusts the intensity of the tonemapping algorithm. |
| SoftwareBrightness | Controls the value which gets added to the digital brightness. |
| Contrast | Controls the strength of the contrast algorithm. |
| Saturation | Controls the saturation of the image. |
| Hue | Controls the hue of the image. |
| Gamma | Controls the gamma correction of pixel intensity. This is typically used to compensate for non-linearity of the display system (such as CRT). |
| ColorTransformationEnable | Activates the selected Color Transformation module. |
| ColorTransformation_Value_Gain?? (with ? ^= [0;2] e.g. ColorTransformation_Value_Gain12) | Changes the color transformation for one factor on a pixel. |