eVision.EColorLookup Class Reference

Describes a color lookup table, that is used to speed-up complex conversions between color systems. More...

Public Member Functions
None	__init__ (self)
	Creates a eVision.EColorLookup.
None	__init__ (self, eVision.EColorLookup other)
	Creates a eVision.EColorLookup.
None	WhiteBalance (self, float gain, float gamma, float balanceRed, float balanceGreen, float balanceBlue)
	Initializes a color lookup table that can be used for color adjustment, including a global gain, gamma pre-compensation [cancellation] and white balancing.
None	WhiteBalance (self, float gain, float gamma, float balanceRed, float balanceGreen)
	Initializes a color lookup table that can be used for color adjustment, including a global gain, gamma pre-compensation [cancellation] and white balancing.
None	WhiteBalance (self, float gain, float gamma, float balanceRed)
	Initializes a color lookup table that can be used for color adjustment, including a global gain, gamma pre-compensation [cancellation] and white balancing.
None	WhiteBalance (self, float gain, float gamma)
	Initializes a color lookup table that can be used for color adjustment, including a global gain, gamma pre-compensation [cancellation] and white balancing.
None	WhiteBalance (self, float gain)
	Initializes a color lookup table that can be used for color adjustment, including a global gain, gamma pre-compensation [cancellation] and white balancing.
None	WhiteBalance (self)
	Initializes a color lookup table that can be used for color adjustment, including a global gain, gamma pre-compensation [cancellation] and white balancing.
None	AdjustGainOffset (self, eVision.EColorSystem colorSystem, float gain0, float offset0, float gain1, float offset1, float gain2, float offset2)
	Sets a color transformation such that a gain and offset is applied separately to each color component of a target color system.
None	AdjustGainOffset (self, eVision.EColorSystem colorSystem, float gain0, float offset0, float gain1, float offset1, float gain2)
	Sets a color transformation such that a gain and offset is applied separately to each color component of a target color system.
None	AdjustGainOffset (self, eVision.EColorSystem colorSystem, float gain0, float offset0, float gain1, float offset1)
	Sets a color transformation such that a gain and offset is applied separately to each color component of a target color system.
None	AdjustGainOffset (self, eVision.EColorSystem colorSystem, float gain0, float offset0, float gain1)
	Sets a color transformation such that a gain and offset is applied separately to each color component of a target color system.
None	AdjustGainOffset (self, eVision.EColorSystem colorSystem, float gain0, float offset0)
	Sets a color transformation such that a gain and offset is applied separately to each color component of a target color system.
None	AdjustGainOffset (self, eVision.EColorSystem colorSystem, float gain0)
	Sets a color transformation such that a gain and offset is applied separately to each color component of a target color system.
None	AdjustGainOffset (self, eVision.EColorSystem colorSystem)
	Sets a color transformation such that a gain and offset is applied separately to each color component of a target color system.
None	ConvertToRgb (self, eVision.EColorSystem colorSystem)
	Sets a color transformation from any color system, as defined by eVision.EColorSystem, to the eVision.EColorSystem.Rgb representation.
None	ConvertFromRgb (self, eVision.EColorSystem colorSystem)
	Sets a color transformation from the eVision.EColorSystem.Rgb representation to another system, as defined by eVision.EColorSystem.
None	Calibrate (self, eVision.EC24 Color0, float x0, float y0, float z0, eVision.EC24 Color1, float x1, float y1, float z1, eVision.EC24 Color2, float x2, float y2, float z2)
	Sets a color transformation to recalibrate.
None	Calibrate (self, eVision.EC24 Color0, float x0, float y0, float z0, eVision.EC24 Color1, float x1, float y1, float z1, eVision.EC24 Color2, float x2, float y2, float z2, eVision.EC24 Color3, float x3, float y3, float z3)
	Sets a color transformation to recalibrate.
None	Calibrate (self, eVision.EC24 color, float x, float y, float z)
None	Transform (self, eVision.EC24 sourceImageColor, eVision.EC24 destinationImageColor)
	Transforms a quantized color image/pixel to another quantized color image/pixel, using the previously initialized color lookup table.
None	Transform (self, eVision.EROIC24|None sourceImage, eVision.EROIC24|None destinationImage)
	Transforms a quantized color image/pixel to another quantized color image/pixel, using the previously initialized color lookup table.
bool	Interpolation (self)
	Interpolation mode.
	Interpolation (self, bool value)
	Interpolation mode.
int	IndexBits (self)
	Number of bits used for indexing the lookup table.
	IndexBits (self, int value)
	Number of bits used for indexing the lookup table.
eVision.EColorSystem	ColorSystemIn (self)
	Input color system.
eVision.EColorSystem	ColorSystemOut (self)
	Output color system.

Detailed Description

Describes a color lookup table, that is used to speed-up complex conversions between color systems.

Remarks:

License(s): EasyColor

Constructor & Destructor Documentation

__init__() [1/2]

None eVision.EColorLookup.__init__

(

self

)

Creates a eVision.EColorLookup.

__init__() [2/2]

None eVision.EColorLookup.__init__	(		self,
		eVision.EColorLookup	other )

Creates a eVision.EColorLookup.

Parameters

other

Another eVision.EColorLookup to be copied in the new eVision.EColorLookup.

Member Function Documentation

AdjustGainOffset() [1/7]

None eVision.EColorLookup.AdjustGainOffset	(		self,
		eVision.EColorSystem	colorSystem )

Sets a color transformation such that a gain and offset is applied separately to each color component of a target color system.

Remarks:

The input and output color systems are both eVision.EColorSystem.Rgb. To apply some transform to a color image, you initialize a color lookup once for all and use it at will in a transformation operation such as eVision.EColorLookup.Transform.

Note

The offsets are specified as unquantized values.

Parameters

colorSystem

Target color system, as defined by eVision.EColorSystem.

AdjustGainOffset() [2/7]

None eVision.EColorLookup.AdjustGainOffset	(		self,
		eVision.EColorSystem	colorSystem,
		float	gain0 )

Sets a color transformation such that a gain and offset is applied separately to each color component of a target color system.

Remarks:

The input and output color systems are both eVision.EColorSystem.Rgb. To apply some transform to a color image, you initialize a color lookup once for all and use it at will in a transformation operation such as eVision.EColorLookup.Transform.

Note

The offsets are specified as unquantized values.

Parameters

colorSystem	Target color system, as defined by eVision.EColorSystem.
gain0	Gain to be applied to color component 0.

AdjustGainOffset() [3/7]

None eVision.EColorLookup.AdjustGainOffset	(		self,
		eVision.EColorSystem	colorSystem,
		float	gain0,
		float	offset0 )

Sets a color transformation such that a gain and offset is applied separately to each color component of a target color system.

Remarks:

The input and output color systems are both eVision.EColorSystem.Rgb. To apply some transform to a color image, you initialize a color lookup once for all and use it at will in a transformation operation such as eVision.EColorLookup.Transform.

Note

The offsets are specified as unquantized values.

Parameters

colorSystem	Target color system, as defined by eVision.EColorSystem.
gain0	Gain to be applied to color component 0.
offset0	Offset to be applied to color component 0.

AdjustGainOffset() [4/7]

None eVision.EColorLookup.AdjustGainOffset	(		self,
		eVision.EColorSystem	colorSystem,
		float	gain0,
		float	offset0,
		float	gain1 )

Sets a color transformation such that a gain and offset is applied separately to each color component of a target color system.

Remarks:

The input and output color systems are both eVision.EColorSystem.Rgb. To apply some transform to a color image, you initialize a color lookup once for all and use it at will in a transformation operation such as eVision.EColorLookup.Transform.

Note

The offsets are specified as unquantized values.

Parameters

colorSystem	Target color system, as defined by eVision.EColorSystem.
gain0	Gain to be applied to color component 0.
offset0	Offset to be applied to color component 0.
gain1	Gain to be applied to color component 1.

AdjustGainOffset() [5/7]

None eVision.EColorLookup.AdjustGainOffset	(		self,
		eVision.EColorSystem	colorSystem,
		float	gain0,
		float	offset0,
		float	gain1,
		float	offset1 )

Sets a color transformation such that a gain and offset is applied separately to each color component of a target color system.

Remarks:

The input and output color systems are both eVision.EColorSystem.Rgb. To apply some transform to a color image, you initialize a color lookup once for all and use it at will in a transformation operation such as eVision.EColorLookup.Transform.

Note

The offsets are specified as unquantized values.

Parameters

colorSystem	Target color system, as defined by eVision.EColorSystem.
gain0	Gain to be applied to color component 0.
offset0	Offset to be applied to color component 0.
gain1	Gain to be applied to color component 1.
offset1	Offset to be applied to color component 1.

AdjustGainOffset() [6/7]

None eVision.EColorLookup.AdjustGainOffset	(		self,
		eVision.EColorSystem	colorSystem,
		float	gain0,
		float	offset0,
		float	gain1,
		float	offset1,
		float	gain2 )

Sets a color transformation such that a gain and offset is applied separately to each color component of a target color system.

Remarks:

The input and output color systems are both eVision.EColorSystem.Rgb. To apply some transform to a color image, you initialize a color lookup once for all and use it at will in a transformation operation such as eVision.EColorLookup.Transform.

Note

The offsets are specified as unquantized values.

Parameters

colorSystem	Target color system, as defined by eVision.EColorSystem.
gain0	Gain to be applied to color component 0.
offset0	Offset to be applied to color component 0.
gain1	Gain to be applied to color component 1.
offset1	Offset to be applied to color component 1.
gain2	Gain to be applied to color component 2.

AdjustGainOffset() [7/7]

None eVision.EColorLookup.AdjustGainOffset	(		self,
		eVision.EColorSystem	colorSystem,
		float	gain0,
		float	offset0,
		float	gain1,
		float	offset1,
		float	gain2,
		float	offset2 )

Sets a color transformation such that a gain and offset is applied separately to each color component of a target color system.

Remarks:

The input and output color systems are both eVision.EColorSystem.Rgb. To apply some transform to a color image, you initialize a color lookup once for all and use it at will in a transformation operation such as eVision.EColorLookup.Transform.

Note

The offsets are specified as unquantized values.

Parameters

colorSystem	Target color system, as defined by eVision.EColorSystem.
gain0	Gain to be applied to color component 0.
offset0	Offset to be applied to color component 0.
gain1	Gain to be applied to color component 1.
offset1	Offset to be applied to color component 1.
gain2	Gain to be applied to color component 2.
offset2	Offset to be applied to color component 2.

Calibrate() [1/3]

None eVision.EColorLookup.Calibrate	(		self,
		eVision.EC24	color,
		float	x,
		float	y,
		float	z )

Calibrate() [2/3]

None eVision.EColorLookup.Calibrate	(		self,
		eVision.EC24	Color0,
		float	x0,
		float	y0,
		float	z0,
		eVision.EC24	Color1,
		float	x1,
		float	y1,
		float	z1,
		eVision.EC24	Color2,
		float	x2,
		float	y2,
		float	z2 )

Sets a color transformation to recalibrate.

Remarks:

The first prototype uses 3 reference colors. The second uses 4 reference colors. To apply some transform to a color image, you initialize a color lookup once for all and use it at will in a transformation operation such as eVision.EColorLookup.Transform.

Parameters

Color0	Measured quantized values of a pixel of color 0.
x0	CIE XYZ tri-stimulus unquantized values corresponding to color 0.
y0	CIE XYZ tri-stimulus unquantized values corresponding to color 0.
z0	CIE XYZ tri-stimulus unquantized values corresponding to color 0.
Color1	Measured quantized values of a pixel of color 1.
x1	CIE XYZ tri-stimulus unquantized values corresponding to color 1.
y1	CIE XYZ tri-stimulus unquantized values corresponding to color 1.
z1	CIE XYZ tri-stimulus unquantized values corresponding to color 1.
Color2	Measured quantized values of a pixel of color 2.
x2	CIE XYZ tri-stimulus unquantized values corresponding to color 2.
y2	CIE XYZ tri-stimulus unquantized values corresponding to color 2.
z2	CIE XYZ tri-stimulus unquantized values corresponding to color 2.

Calibrate() [3/3]

None eVision.EColorLookup.Calibrate	(		self,
		eVision.EC24	Color0,
		float	x0,
		float	y0,
		float	z0,
		eVision.EC24	Color1,
		float	x1,
		float	y1,
		float	z1,
		eVision.EC24	Color2,
		float	x2,
		float	y2,
		float	z2,
		eVision.EC24	Color3,
		float	x3,
		float	y3,
		float	z3 )

Sets a color transformation to recalibrate.

Remarks:

The first prototype uses 3 reference colors. The second uses 4 reference colors. To apply some transform to a color image, you initialize a color lookup once for all and use it at will in a transformation operation such as eVision.EColorLookup.Transform.

Parameters

Color0	Measured quantized values of a pixel of color 0.
x0	CIE XYZ tri-stimulus unquantized values corresponding to color 0.
y0	CIE XYZ tri-stimulus unquantized values corresponding to color 0.
z0	CIE XYZ tri-stimulus unquantized values corresponding to color 0.
Color1	Measured quantized values of a pixel of color 1.
x1	CIE XYZ tri-stimulus unquantized values corresponding to color 1.
y1	CIE XYZ tri-stimulus unquantized values corresponding to color 1.
z1	CIE XYZ tri-stimulus unquantized values corresponding to color 1.
Color2	Measured quantized values of a pixel of color 2.
x2	CIE XYZ tri-stimulus unquantized values corresponding to color 2.
y2	CIE XYZ tri-stimulus unquantized values corresponding to color 2.
z2	CIE XYZ tri-stimulus unquantized values corresponding to color 2.
Color3	Measured quantized values of a pixel of color 3.
x3	CIE XYZ tri-stimulus unquantized values corresponding to color 3.
y3	CIE XYZ tri-stimulus unquantized values corresponding to color 3.
z3	CIE XYZ tri-stimulus unquantized values corresponding to color 3.

ColorSystemIn()

eVision.EColorSystem eVision.EColorLookup.ColorSystemIn

(

self

)

Input color system.

Remarks:

The EColorLookup objects keep track of the color system transformation, for consistency. When applying a transformation, the source image color system (usually eVision.EColorSystem.Rgb) must match the input color system; the destination image will be automatically be typed with the output color system. In case of a mismatch, an error message is issued. These two values are set by the lookup table initialization functions. An uninitialized lookup table has both color systems set to eVision.EColorSystem.NoColor.

ColorSystemOut()

eVision.EColorSystem eVision.EColorLookup.ColorSystemOut

(

self

)

Output color system.

Remarks:

The EColorLookup objects keep track of the color system transformation, for consistency. When applying a transformation, the source image color system (usually eVision.EColorSystem.Rgb) must match the input color system; the destination image will be automatically be typed with the output color system. In case of a mismatch, an error message is issued. These two values are set by the lookup table initialization functions. An uninitialized lookup table has both color systems set to eVision.EColorSystem.NoColor.

ConvertFromRgb()

None eVision.EColorLookup.ConvertFromRgb	(		self,
		eVision.EColorSystem	colorSystem )

Sets a color transformation from the eVision.EColorSystem.Rgb representation to another system, as defined by eVision.EColorSystem.

Remarks:

The input and output color systems are respectively eVision.EColorSystem.Rgb and colorSystem. To apply some transform to a color image, you initialize a color lookup once for all and use it at will in a transformation operation such as eVision.EColorLookup.Transform.

Parameters

colorSystem

Color system, as defined by eVision.EColorSystem.

ConvertToRgb()

None eVision.EColorLookup.ConvertToRgb	(		self,
		eVision.EColorSystem	colorSystem )

Sets a color transformation from any color system, as defined by eVision.EColorSystem, to the eVision.EColorSystem.Rgb representation.

Remarks:

The input and output color systems are respectively colorSystem and eVision.EColorSystem.Rgb. To apply some transform to a color image, you initialize a color lookup once for all and use it at will in a transformation operation such as eVision.EColorLookup.Transform.

Parameters

colorSystem

Color system, as defined by eVision.EColorSystem.

IndexBits() [1/2]

int eVision.EColorLookup.IndexBits

(

self

)

Number of bits used for indexing the lookup table.

Remarks:

Before filling in a lookup table, it is necessary to decide how many table entries it requires. This property indicates how many (high-order) bits of the input components are used. The relation between this property, the number of table entries and the corresponding table size are given below:

IndexBits	Number of entries	Table size (bytes)
4	\(2^{3\times4}=4096\)	14739
5	\(2^{3\times5}=32768\)	107811
6	\(2^{3\times6}=262144\)	823875

The larger the number of entries, the more accuracy is obtained. After this property has been changed, the lookup table needs to be recomputed.

Note

Be aware that each time a color lookup table is filled, all the entries are recomputed. When this property equals 6, this may take a very long time. Such large lookup tables should be computed once only. Different combinations of this property and Interpolation provide a trade-off between accuracy and speed for the table pre-computation and table use.

IndexBits() [2/2]

eVision.EColorLookup.IndexBits	(		self,
		int	value )

Number of bits used for indexing the lookup table.

Remarks:

Before filling in a lookup table, it is necessary to decide how many table entries it requires. This property indicates how many (high-order) bits of the input components are used. The relation between this property, the number of table entries and the corresponding table size are given below:

IndexBits	Number of entries	Table size (bytes)
4	\(2^{3\times4}=4096\)	14739
5	\(2^{3\times5}=32768\)	107811
6	\(2^{3\times6}=262144\)	823875

The larger the number of entries, the more accuracy is obtained. After this property has been changed, the lookup table needs to be recomputed.

Note

Be aware that each time a color lookup table is filled, all the entries are recomputed. When this property equals 6, this may take a very long time. Such large lookup tables should be computed once only. Different combinations of this property and Interpolation provide a trade-off between accuracy and speed for the table pre-computation and table use.

Interpolation() [1/2]

bool eVision.EColorLookup.Interpolation

(

self

)

Interpolation mode.

Remarks:

When applying a lookup table to transform pixel values, tri-linear interpolation can be used:

• when interpolation is not used, the table is looked up at the entry closest to the pixel value. This gives an accuracy equal to the value of the IndexBits property. On the other hand, table lookup is very fast;
• when interpolation is used, the table is looked up at eight neighboring entries and an adequate average is computed. This gives full accuracy (8 bits) if the transformation is smooth enough. On the other hand, table lookup is slower.

Note

The interpolation mode may be modified at any time without the need to reinitialize the lookup table.

Interpolation() [2/2]

eVision.EColorLookup.Interpolation	(		self,
		bool	value )

Interpolation mode.

Remarks:

When applying a lookup table to transform pixel values, tri-linear interpolation can be used:

• when interpolation is not used, the table is looked up at the entry closest to the pixel value. This gives an accuracy equal to the value of the IndexBits property. On the other hand, table lookup is very fast;
• when interpolation is used, the table is looked up at eight neighboring entries and an adequate average is computed. This gives full accuracy (8 bits) if the transformation is smooth enough. On the other hand, table lookup is slower.

Note

The interpolation mode may be modified at any time without the need to reinitialize the lookup table.

Transform() [1/2]

None eVision.EColorLookup.Transform	(		self,
		eVision.EC24	sourceImageColor,
		eVision.EC24	destinationImageColor )

Transforms a quantized color image/pixel to another quantized color image/pixel, using the previously initialized color lookup table.

Parameters

sourceImageColor	Input color image.
destinationImageColor	Output color image.

Transform() [2/2]

None eVision.EColorLookup.Transform	(		self,
		eVision.EROIC24 | None	sourceImage,
		eVision.EROIC24 | None	destinationImage )

Transforms a quantized color image/pixel to another quantized color image/pixel, using the previously initialized color lookup table.

Parameters

sourceImage	Input color image.
destinationImage	Output color image.

WhiteBalance() [1/6]

None eVision.EColorLookup.WhiteBalance

(

self

)

Initializes a color lookup table that can be used for color adjustment, including a global gain, gamma pre-compensation [cancellation] and white balancing.

Remarks:

To apply some transform to a color image, you initialize the color lookup once for all and use it at will with eVision.EColorLookup.Transform or eVision.EasyColor.TransformBayer operation.

WhiteBalance() [2/6]

None eVision.EColorLookup.WhiteBalance	(		self,
		float	gain )

Initializes a color lookup table that can be used for color adjustment, including a global gain, gamma pre-compensation [cancellation] and white balancing.

Remarks:

To apply some transform to a color image, you initialize the color lookup once for all and use it at will with eVision.EColorLookup.Transform or eVision.EasyColor.TransformBayer operation.

Parameters

gain	Global gain to be applied to all three color components. By default, the image intensity remains unchanged.

WhiteBalance() [3/6]

None eVision.EColorLookup.WhiteBalance	(		self,
		float	gain,
		float	gamma )

Initializes a color lookup table that can be used for color adjustment, including a global gain, gamma pre-compensation [cancellation] and white balancing.

Remarks:

To apply some transform to a color image, you initialize the color lookup once for all and use it at will with eVision.EColorLookup.Transform or eVision.EasyColor.TransformBayer operation.

Parameters

gain

Global gain to be applied to all three color components. By default, the image intensity remains unchanged.

gamma

Gamma exponent. Setting this parameter will cancel the gamma pre-compensation feature of the camera, or apply it. By default, the no gamma pre-compensation is assumed (linear response). The gamma exponent can be chosen among the predefined values eVision.EasyColor.GetCompensateNtscGamma/eVision.EasyColor.GetCompensatePalGamma/eVision.EasyColor.GetCompensateSmpteGamma (pre-compensation) or eVision.EasyColor.GetNtscGamma/eVision.EasyColor.GetPalGamma/eVision.EasyColor.GetSmpteGamma (pre-compensation cancellation), or be user-defined.

WhiteBalance() [4/6]

None eVision.EColorLookup.WhiteBalance	(		self,
		float	gain,
		float	gamma,
		float	balanceRed )

Initializes a color lookup table that can be used for color adjustment, including a global gain, gamma pre-compensation [cancellation] and white balancing.

Remarks:

To apply some transform to a color image, you initialize the color lookup once for all and use it at will with eVision.EColorLookup.Transform or eVision.EasyColor.TransformBayer operation.

Parameters

gain	Global gain to be applied to all three color components. By default, the image intensity remains unchanged.
gamma	Gamma exponent. Setting this parameter will cancel the gamma pre-compensation feature of the camera, or apply it. By default, the no gamma pre-compensation is assumed (linear response). The gamma exponent can be chosen among the predefined values eVision.EasyColor.GetCompensateNtscGamma/eVision.EasyColor.GetCompensatePalGamma/eVision.EasyColor.GetCompensateSmpteGamma (pre-compensation) or eVision.EasyColor.GetNtscGamma/eVision.EasyColor.GetPalGamma/eVision.EasyColor.GetSmpteGamma (pre-compensation cancellation), or be user-defined.
balanceRed	Color values to be used for white balance. These parameters should be set to the measured average values of a white (or gray) pixels area, allowing the white balance to adjust pre-component gains appropriately. Use function eVision.EImageStatisticsBW8.PixelAverage to obtain them. By default, no white balancing is performed.

WhiteBalance() [5/6]

None eVision.EColorLookup.WhiteBalance	(		self,
		float	gain,
		float	gamma,
		float	balanceRed,
		float	balanceGreen )

Initializes a color lookup table that can be used for color adjustment, including a global gain, gamma pre-compensation [cancellation] and white balancing.

Remarks:

To apply some transform to a color image, you initialize the color lookup once for all and use it at will with eVision.EColorLookup.Transform or eVision.EasyColor.TransformBayer operation.

Parameters

gain	Global gain to be applied to all three color components. By default, the image intensity remains unchanged.
gamma	Gamma exponent. Setting this parameter will cancel the gamma pre-compensation feature of the camera, or apply it. By default, the no gamma pre-compensation is assumed (linear response). The gamma exponent can be chosen among the predefined values eVision.EasyColor.GetCompensateNtscGamma/eVision.EasyColor.GetCompensatePalGamma/eVision.EasyColor.GetCompensateSmpteGamma (pre-compensation) or eVision.EasyColor.GetNtscGamma/eVision.EasyColor.GetPalGamma/eVision.EasyColor.GetSmpteGamma (pre-compensation cancellation), or be user-defined.
balanceRed	Color values to be used for white balance. These parameters should be set to the measured average values of a white (or gray) pixels area, allowing the white balance to adjust pre-component gains appropriately. Use function eVision.EImageStatisticsBW8.PixelAverage to obtain them. By default, no white balancing is performed.
balanceGreen	Color values to be used for white balance. These parameters should be set to the measured average values of a white (or gray) pixels area, allowing the white balance to adjust pre-component gains appropriately. Use function eVision.EImageStatisticsBW8.PixelAverage to obtain them. By default, no white balancing is performed.

WhiteBalance() [6/6]

None eVision.EColorLookup.WhiteBalance	(		self,
		float	gain,
		float	gamma,
		float	balanceRed,
		float	balanceGreen,
		float	balanceBlue )

Initializes a color lookup table that can be used for color adjustment, including a global gain, gamma pre-compensation [cancellation] and white balancing.

Remarks:

To apply some transform to a color image, you initialize the color lookup once for all and use it at will with eVision.EColorLookup.Transform or eVision.EasyColor.TransformBayer operation.

Parameters

gain	Global gain to be applied to all three color components. By default, the image intensity remains unchanged.
gamma	Gamma exponent. Setting this parameter will cancel the gamma pre-compensation feature of the camera, or apply it. By default, the no gamma pre-compensation is assumed (linear response). The gamma exponent can be chosen among the predefined values eVision.EasyColor.GetCompensateNtscGamma/eVision.EasyColor.GetCompensatePalGamma/eVision.EasyColor.GetCompensateSmpteGamma (pre-compensation) or eVision.EasyColor.GetNtscGamma/eVision.EasyColor.GetPalGamma/eVision.EasyColor.GetSmpteGamma (pre-compensation cancellation), or be user-defined.
balanceRed	Color values to be used for white balance. These parameters should be set to the measured average values of a white (or gray) pixels area, allowing the white balance to adjust pre-component gains appropriately. Use function eVision.EImageStatisticsBW8.PixelAverage to obtain them. By default, no white balancing is performed.
balanceGreen	Color values to be used for white balance. These parameters should be set to the measured average values of a white (or gray) pixels area, allowing the white balance to adjust pre-component gains appropriately. Use function eVision.EImageStatisticsBW8.PixelAverage to obtain them. By default, no white balancing is performed.
balanceBlue	Color values to be used for white balance. These parameters should be set to the measured average values of a white (or gray) pixels area, allowing the white balance to adjust pre-component gains appropriately. Use function eVision.EImageStatisticsBW8.PixelAverage to obtain them. By default, no white balancing is performed.