Color Transformation Control

Prev Next

Color Transformation Selector

Name

ColorTransformationSelector

Standard

Description

Selects which Color Transformation module is controlled by the various color transformation features.

Interface

Enumeration

Access mode

Read/Write

Adjustable

while grabbing

Yes

Value range

See enum entries table below.

Default value

ColortoColor

Availability

ALL (Not available for mono Cameras)

Notes

The transformations are defined as follows:


Color to Color

In case of RGB pixel format the fourth entry  has no meaning. A could contain

color component for some camera variants.

Color to Grey

Attention: For current implementation color to grey is supported only for RGB. So the formula reduces to Gain0-2 and RGB!

Use Color Transformation Value Selector and Color Transformation Value to set the coefficients.

Error behavior

See the device error code documentation.

Color Transformation Selector Enum Entries:

Name

Description

ColortoColor

Color to color

ColortoGrey

Color to grey

Color Transformation Enable

Name

ColorTransformationEnable[ColorTransformationSelector]

Standard

Description

Activates the selected Color Transformation module.

Interface

Boolean

Access mode

Read/Write

Adjustable

while grabbing

No

Value range

True – Enables the selected color transformation module

False – Disables the selected color transformation module

Default value

False

Availability

ALL (Not available for mono cameras)

Notes

If the ColortoGrey module is disabled, the pixel format internally is changed to RGB8.

Error behavior

See the device error code documentation.

Color Transformation Value Selector

Name

ColorTransformationValueSelector

Standard

Description

Selects the Gain factor or Offset of the transformation matrix to access in the selected color transformation module.

Interface

Enumeration

Access mode

Read/Write

Adjustable

while grabbing

Yes

Value range

See enum entries table below.

Default value

Gain00 – For ColortoColor module

Gain0 – For ColortoGrey module

Availability

ALL (Not available for mono Cameras)

Notes

-

Error behavior

See the device error code documentation.

Color Transformation Value Selector Enum Entries:

Color to Color

Name

Description

Gain00

Gain 0, 0 of the transformation matrix.

Gain01

Gain 0, 1 of the transformation matrix.

Gain02

Gain 0, 2 of the transformation matrix.

Gain03

Gain 0, 3 of the transformation matrix.

Gain10

Gain 1, 0 of the transformation matrix.

Gain11

Gain 1, 1 of the transformation matrix.

Gain12

Gain 1, 2 of the transformation matrix.

Gain13

Gain 1, 3 of the transformation matrix.

Gain20

Gain 2, 0 of the transformation matrix.

Gain21

Gain 2, 1 of the transformation matrix.

Gain22

Gain 2, 2 of the transformation matrix.

Gain23

Gain 2, 3 of the transformation matrix.

Gain30

Gain 3, 0 of the transformation matrix.

Gain31

Gain 3, 1 of the transformation matrix.

Gain32

Gain 3, 2 of the transformation matrix.

Gain33

Gain 3, 3 of the transformation matrix.

Offset0

Offset 0 of the transformation matrix.

Offset1

Offset 1 of the transformation matrix.

Offset2

Offset 2 of the transformation matrix.

Offset3

Offset 3 of the transformation matrix.

Color to Grey

Name

Description

Gain0

Gain 1, 0 of the transformation matrix.

Gain1

Gain 1, 1 of the transformation matrix

Gain2

Gain 1, 2 of the transformation matrix

Gain3

Gain 1, 2 of the transformation matrix.

Color Transformation Value

Name

ColorTransformationValue[ColorTransformationValueSelector]

Standard

Description

Represents the value of the selected Gain factor or Offset inside the transformation matrix.

Interface

Float

Access mode

Read/Write

Adjustable

while grabbing

No

Value range

[-2.0 , 2.0] – For Gain selector

[-0.5, 0.5] – For Offset selector

Default value

-

Availability

ALL (Not available for mono cameras)

Notes

-

Error behavior

See the device error code documentation.