Transformations¶
Conversion Table¶
This table contains the input/output format combinations tcamdutils supports.
Input format | Output format | 1 | 2 | 3 | 4 | 5 | 6 | 7 |
---|---|---|---|---|---|---|---|---|
x-raw,format=GRAY16_LE | x-raw,format=GRAY16_LE x-raw,format=BGRx |
[ ] | [ ] | [x] | [x] | [x] | [x] | [ ] |
x-raw,format=GRAY8 | x-raw,format=GRAY8 x-raw,format=BGR x-raw,format=BGRx |
[ ] | [ ] | [x] | [x] | [x] | [x] | [ ] |
x-raw,format=GRAY10 x-raw,format=GRAY10p x-raw,format=GRAY10m x-raw,format=GRAY12 x-raw,format=GRAY12p x-raw,format=GRAY12m x-raw,format=GRAY12sp |
x-raw,format=GRAY16_LE x-raw,format=GRAY8 x-raw,format=BGRx |
[ ] | [ ] | [x] | [x] | [x] | [x] | [ ] |
x-bayer,format=bggr x-bayer,format=gbrg x-bayer,format=grbg x-bayer,format=rggb |
x-raw,format=BGRx x-raw,format=BGR |
[x] | [x] | [x] | [x] | [x] | [x] | [ ] |
x-bayer,format=bggr | x-bayer,format=bggr | [x] | [ ] | [ ] | [ ] | [ ] | [ ] | [ ] |
x-bayer,format=gbrg | x-bayer,format=gbrg | [x] | [ ] | [ ] | [ ] | [ ] | [ ] | [ ] |
x-bayer,format=grbg | x-bayer,format=grbg | [x] | [ ] | [ ] | [ ] | [ ] | [ ] | [ ] |
x-bayer,format=rggb | x-bayer,format=rggb | [x] | [ ] | [ ] | [ ] | [ ] | [ ] | [ ] |
x-bayer,format=bggr16 x-bayer,format=gbrg16 x-bayer,format=grbg16 x-bayer,format=rggb16 x-bayer,format=bggr10 x-bayer,format=gbrg10 x-bayer,format=grbg10 x-bayer,format=rggb10 x-bayer,format=bggr10m x-bayer,format=gbrg10m x-bayer,format=grbg10m x-bayer,format=rggb10m x-bayer,format=bggr12 x-bayer,format=gbrg12 x-bayer,format=grbg12 x-bayer,format=rggb12 x-bayer,format=bggr12sp x-bayer,format=gbrg12sp x-bayer,format=grbg12sp x-bayer,format=rggb12sp x-bayer,format=bggr12p x-bayer,format=gbrg12p x-bayer,format=grbg12p x-bayer,format=rggb12p x-bayer,format=bggr12m x-bayer,format=gbrg12m x-bayer,format=grbg12m x-bayer,format=rggb12m |
x-raw,format=RGBx64 x-raw,format=BGRx |
[x] | [x] | [x] | [x] | [x] | [x] | [ ] |
x-bayer,format=bggr16 | x-bayer,format=bggr16 | [x] | [ ] | [ ] | [ ] | [ ] | [ ] | [ ] |
x-bayer,format=gbrg16 | x-bayer,format=gbrg16 | [x] | [ ] | [ ] | [ ] | [ ] | [ ] | [ ] |
x-bayer,format=grbg16 | x-bayer,format=grbg16 | [x] | [ ] | [ ] | [ ] | [ ] | [ ] | [ ] |
x-bayer,format=rggb16 | x-bayer,format=rggb16 | [x] | [ ] | [ ] | [ ] | [ ] | [ ] | [ ] |
x-bayer,format=bggr10 x-bayer,format=bggr10m x-bayer,format=bggr12 x-bayer,format=bggr12sp x-bayer,format=bggr12p x-bayer,format=bggr12m |
x-bayer,format=bggr16 x-bayer,format=bggr |
[x] | [ ] | [ ] | [ ] | [ ] | [ ] | [ ] |
x-bayer,format=gbrg10 x-bayer,format=gbrg10m x-bayer,format=gbrg12 x-bayer,format=gbrg12sp x-bayer,format=gbrg12p x-bayer,format=gbrg12m |
x-bayer,format=gbrg16 x-bayer,format=gbrg |
[x] | [ ] | [ ] | [ ] | [ ] | [ ] | [ ] |
x-bayer,format=grbg10 x-bayer,format=grbg10m x-bayer,format=grbg12 x-bayer,format=grbg12sp x-bayer,format=grbg12p x-bayer,format=grbg12m |
x-bayer,format=grbg16 x-bayer,format=grbg |
[x] | [ ] | [ ] | [ ] | [ ] | [ ] | [ ] |
x-bayer,format=rggb10 x-bayer,format=rggb10m x-bayer,format=rggb12 x-bayer,format=rggb12sp x-bayer,format=rggb12p x-bayer,format=rggb12m |
x-bayer,format=rggb16 x-bayer,format=rggb |
[x] | [ ] | [ ] | [ ] | [ ] | [ ] | [ ] |
x-raw,format=YUY2 | x-raw,format=YUY2 | [ ] | [x] | [x] | [x] | [ ] | [ ] | [ ] |
x-raw,format=IYU1 | x-raw,format=IYU1 | [ ] | [x] | [x] | [x] | [ ] | [ ] | [ ] |
x-bayer,format=pwl-rggb12m x-bayer,format=pwl-rggb12 x-bayer,format=pwl-rggb16H12 |
x-bayer,format=rggbf | [x] | [ ] | [ ] | [ ] | [ ] | [ ] | [ ] |
x-bayer,format=pwl-rggb12m x-bayer,format=pwl-rggb12 x-bayer,format=pwl-rggb16H12 |
x-raw,format=BGRx | [x] | [x] | [x] | [x] | [x] | [x] | [x] |
Table headers:
Number | Property type |
---|---|
1 | White balance |
2 | Saturation Hue |
3 | Brightness Contrast |
4 | Sharpness Denoise |
5 | Gamma |
6 | Tonemapping |
7 | PWL |
Note: The actual format string must be formatted like “video/x-raw,format=(string)bggr”
Properties¶
The properties that tcamdutils will offer depend on the currently used transformat 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. ‘Exposure Auto’, 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 |
---|---|
Exposure Auto | Automatic Adjustments of Exposure |
Exposure Min | Minimum Value Exposure Auto may set |
Exposure Max | Maximum Value Exposure Auto may set |
Exposure Auto Reference | Average Brightness the image should have |
ExposureAutoUpperLimitAuto | If enabled, the framerate controls the Maximum value Exposure Auto controls instead of Exposure Max |
Highlight Reduction | Reduces Exposure Auto Reference when the image has an abundance of white pixels. |
Gain Auto¶
If the camera does not have Gain Auto but has a Gain property, tcamdutils creates the following properties:
Name | Description |
---|---|
Gain Auto | Automatic Adjustments of Gain |
GainAutoLowerLimit | Minimum Value Gain Auto may set |
GainAutoUpperLimit | Maximum Value Gain Auto may set |
WhiteBalance 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 |
---|---|
Whitebalance | Enable/Disable application of whitebalance values |
Whitebalance Auto | Automatically and continually determine correct whitebalance values |
Whitebalance One Push | Determine whitebalance values once |
Whitebalance Red | Whitebalance value for the red channel |
Whitebalance Green | Whitebalance value for the green channel |
Whitebalance Blue | Whitebalance value for the blue channel |
Additional Auto Properties¶
The property Iris Auto will be generated when the device has an Iris property, but no Iris Auto.
The property Focus Auto will be generated when the device has an Focus property, but no Focus Auto.
Name | Description |
---|---|
Iris Auto | Automatic Adjustments of Iris |
Focus Auto | Adjust focus property until image is considered focused |
Additional Properties¶
These will be generated when supported transform caps are selected
Name | Description |
---|---|
Denosie | Reduces noise in the image |
Sharpness | Change edge contrast |
Tonemapping | Enable HDR |
Tonemapping Global Brightness | Controls the Tonemapping algorithm in how much the local environment of a pixel has influence on the resulting pixel brightness |
Tonemapping Intensity | Controls the intensitiy of the Tonemapping algorithm |
Brightness | Controls the brightness of the image |
Contrast | Controls the contrast of the image |
Saturation | Change color intensity |
Hue | Change the Hue of the image |
Gamma | Change the Gamma of the image |