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.

Exposure Auto properties
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:

Gain Auto 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:

WhiteBalance Auto 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.

Additional Auto Properties
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

Additional Properties
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

PWL Properties

These will be generated when supported transform caps are selected.

PWL Properties
Name Description
HDRGain Controls how the PWL image is mapped to 8-bit
HDRGainAuto Enables the automatic selection of the HDRGain value
HDRGainAutoReference Influences the HDRGainAuto algorithm