eVision .NET API
Loading...
Searching...
No Matches
eVision.EasyColor Class Reference

This class contains static properties and methods specific to the EasyColor library. More...

Static Public Member Functions

static void PseudoColor (eVision.EROIBW8 sourceImage, eVision.EROIC24 destinationImage, eVision.EPseudoColorLookup lookup)
 Applies the mapping defined by the pseudo-color lookup table to transform a gray-level image into a color image.
static void Dequantize (eVision.EC24 colorIn, out eVision.ERGB colorOut)
 Convert a quantized value to a unquantized value of a given color system.
static void Dequantize (eVision.EC24 colorIn, out eVision.EXYZ colorOut)
 Convert a quantized value to a unquantized value of a given color system.
static void Dequantize (eVision.EC24 colorIn, out eVision.EYUV colorOut)
 Convert a quantized value to a unquantized value of a given color system.
static void Dequantize (eVision.EC24 colorIn, out eVision.EYCbCr colorOut)
 Convert a quantized value to a unquantized value of a given color system.
static void Dequantize (eVision.EC24 colorIn, out eVision.EYIQ colorOut)
 Convert a quantized value to a unquantized value of a given color system.
static void Dequantize (eVision.EC24 colorIn, out eVision.ELSH colorOut)
 Convert a quantized value to a unquantized value of a given color system.
static void Dequantize (eVision.EC24 colorIn, out eVision.EVSH colorOut)
 Convert a quantized value to a unquantized value of a given color system.
static void Dequantize (eVision.EC24 colorIn, out eVision.EISH colorOut)
 Convert a quantized value to a unquantized value of a given color system.
static void Dequantize (eVision.EC24 colorIn, out eVision.EYSH colorOut)
 Convert a quantized value to a unquantized value of a given color system.
static void Dequantize (eVision.EC24 colorIn, out eVision.ELAB colorOut)
 Convert a quantized value to a unquantized value of a given color system.
static void Dequantize (eVision.EC24 colorIn, out eVision.ELCH colorOut)
 Convert a quantized value to a unquantized value of a given color system.
static void Dequantize (eVision.EC24 colorIn, out eVision.ELUV colorOut)
 Convert a quantized value to a unquantized value of a given color system.
static void Quantize (eVision.ERGB colorIn, out eVision.EC24 colorOut)
 Convert an unquantized color of a given color system to a quantized color.
static void Quantize (eVision.EXYZ colorIn, out eVision.EC24 colorOut)
 Convert an unquantized color of a given color system to a quantized color.
static void Quantize (eVision.EYUV colorIn, out eVision.EC24 colorOut)
 Convert an unquantized color of a given color system to a quantized color.
static void Quantize (eVision.EYCbCr colorIn, out eVision.EC24 colorOut)
 Convert an unquantized color of a given color system to a quantized color.
static void Quantize (eVision.EYIQ colorIn, out eVision.EC24 colorOut)
 Convert an unquantized color of a given color system to a quantized color.
static void Quantize (eVision.ELSH colorIn, out eVision.EC24 colorOut)
 Convert an unquantized color of a given color system to a quantized color.
static void Quantize (eVision.EVSH colorIn, out eVision.EC24 colorOut)
 Convert an unquantized color of a given color system to a quantized color.
static void Quantize (eVision.EISH colorIn, out eVision.EC24 colorOut)
 Convert an unquantized color of a given color system to a quantized color.
static void Quantize (eVision.EYSH colorIn, out eVision.EC24 colorOut)
 Convert an unquantized color of a given color system to a quantized color.
static void Quantize (eVision.ELAB colorIn, out eVision.EC24 colorOut)
 Convert an unquantized color of a given color system to a quantized color.
static void Quantize (eVision.ELCH colorIn, out eVision.EC24 colorOut)
 Convert an unquantized color of a given color system to a quantized color.
static void Quantize (eVision.ELUV colorIn, out eVision.EC24 colorOut)
 Convert an unquantized color of a given color system to a quantized color.
static void RgbToXyz (eVision.ERGB colorIn, out eVision.EXYZ colorOut)
 Convert a color from RGB to another system.
static void RgbToXyz (eVision.EC24 colorIn, out eVision.EC24 colorOut)
 Convert a color from RGB to another system.
static void XyzToRgb (eVision.EXYZ colorIn, out eVision.ERGB colorOut)
 Convert a color from any system to RGB.
static void XyzToRgb (eVision.EC24 colorIn, out eVision.EC24 colorOut)
 Convert a color from any system to RGB.
static void RgbToYuv (eVision.ERGB colorIn, out eVision.EYUV colorOut)
 Convert a color from RGB to another system.
static void RgbToYuv (eVision.EC24 colorIn, out eVision.EC24 colorOut)
 Convert a color from RGB to another system.
static void YuvToRgb (eVision.EYUV colorIn, out eVision.ERGB colorOut)
 Convert a color from any system to RGB.
static void YuvToRgb (eVision.EC24 colorIn, out eVision.EC24 colorOut)
 Convert a color from any system to RGB.
static void RgbToYCbCr (eVision.ERGB colorIn, out eVision.EYCbCr colorOut)
 Convert a color from RGB to another system.
static void RgbToYCbCr (eVision.EC24 colorIn, out eVision.EC24 colorOut)
 Convert a color from RGB to another system.
static void YCbCrToRgb (eVision.EYCbCr colorIn, out eVision.ERGB colorOut)
 Convert a color from any system to RGB.
static void YCbCrToRgb (eVision.EC24 colorIn, out eVision.EC24 colorOut)
 Convert a color from any system to RGB.
static void RgbToYiq (eVision.ERGB colorIn, out eVision.EYIQ colorOut)
 Convert a color from RGB to another system.
static void RgbToYiq (eVision.EC24 colorIn, out eVision.EC24 colorOut)
 Convert a color from RGB to another system.
static void YiqToRgb (eVision.EYIQ colorIn, out eVision.ERGB colorOut)
 Convert a color from any system to RGB.
static void YiqToRgb (eVision.EC24 colorIn, out eVision.EC24 colorOut)
 Convert a color from any system to RGB.
static void RgbToLsh (eVision.ERGB colorIn, out eVision.ELSH colorOut)
 Convert a color from RGB to another system.
static void RgbToLsh (eVision.EC24 colorIn, out eVision.EC24 colorOut)
 Convert a color from RGB to another system.
static void LshToRgb (eVision.ELSH colorIn, out eVision.ERGB colorOut)
 Convert a color from any system to RGB.
static void LshToRgb (eVision.EC24 colorIn, out eVision.EC24 colorOut)
 Convert a color from any system to RGB.
static void RgbToVsh (eVision.ERGB colorIn, out eVision.EVSH colorOut)
 Convert a color from RGB to another system.
static void RgbToVsh (eVision.EC24 colorIn, out eVision.EC24 colorOut)
 Convert a color from RGB to another system.
static void VshToRgb (eVision.EVSH colorIn, out eVision.ERGB colorOut)
 Convert a color from any system to RGB.
static void VshToRgb (eVision.EC24 colorIn, out eVision.EC24 colorOut)
 Convert a color from any system to RGB.
static void RgbToIsh (eVision.ERGB colorIn, out eVision.EISH colorOut)
 Convert a color from RGB to another system.
static void RgbToIsh (eVision.EC24 colorIn, out eVision.EC24 colorOut)
 Convert a color from RGB to another system.
static void IshToRgb (eVision.EISH colorIn, out eVision.ERGB colorOut)
 Convert a color from any system to RGB.
static void IshToRgb (eVision.EC24 colorIn, out eVision.EC24 colorOut)
 Convert a color from any system to RGB.
static void RgbToYsh (eVision.ERGB colorIn, out eVision.EYSH colorOut)
 Convert a color from RGB to another system.
static void RgbToYsh (eVision.EC24 colorIn, out eVision.EC24 colorOut)
 Convert a color from RGB to another system.
static void YshToRgb (eVision.EYSH colorIn, out eVision.ERGB colorOut)
 Convert a color from any system to RGB.
static void YshToRgb (eVision.EC24 colorIn, out eVision.EC24 colorOut)
 Convert a color from any system to RGB.
static void RgbToLab (eVision.ERGB colorIn, out eVision.ELAB colorOut)
 Convert a color from RGB to another system.
static void RgbToLab (eVision.EC24 colorIn, out eVision.EC24 colorOut)
 Convert a color from RGB to another system.
static void LabToRgb (eVision.ELAB colorIn, out eVision.ERGB colorOut)
 Convert a color from any system to RGB.
static void LabToRgb (eVision.EC24 colorIn, out eVision.EC24 colorOut)
 Convert a color from any system to RGB.
static void RgbToLch (eVision.ERGB colorIn, out eVision.ELCH colorOut)
 Convert a color from RGB to another system.
static void RgbToLch (eVision.EC24 colorIn, out eVision.EC24 colorOut)
 Convert a color from RGB to another system.
static void LchToRgb (eVision.ELCH colorIn, out eVision.ERGB colorOut)
 Convert a color from any system to RGB.
static void LchToRgb (eVision.EC24 colorIn, out eVision.EC24 colorOut)
 Convert a color from any system to RGB.
static void RgbToLuv (eVision.ERGB colorIn, out eVision.ELUV colorOut)
 Convert a color from RGB to another system.
static void RgbToLuv (eVision.EC24 colorIn, out eVision.EC24 colorOut)
 Convert a color from RGB to another system.
static void LuvToRgb (eVision.ELUV colorIn, out eVision.ERGB colorOut)
 Convert a color from any system to RGB.
static void LuvToRgb (eVision.EC24 colorIn, out eVision.EC24 colorOut)
 Convert a color from any system to RGB.
static void RgbToReducedXyz (eVision.ERGB colorIn, out eVision.EXYZ colorOut)
 Convert a color from one system to another.
static void RgbToReducedXyz (eVision.EC24 colorIn, out eVision.EC24 colorOut)
 Convert a color from one system to another.
static void XyzToLab (eVision.EXYZ colorIn, out eVision.ELAB colorOut)
 Convert a color from one system to another.
static void XyzToLab (eVision.EC24 colorIn, out eVision.EC24 colorOut)
 Convert a color from one system to another.
static void LabToXyz (eVision.ELAB colorIn, out eVision.EXYZ colorOut)
 Convert a color from one system to another.
static void LabToXyz (eVision.EC24 colorIn, out eVision.EC24 colorOut)
 Convert a color from one system to another.
static void XyzToLuv (eVision.EXYZ colorIn, out eVision.ELUV colorOut)
 Convert a color from one system to another.
static void XyzToLuv (eVision.EC24 colorIn, out eVision.EC24 colorOut)
 Convert a color from one system to another.
static void LuvToXyz (eVision.ELUV colorIn, out eVision.EXYZ colorOut)
 Convert a color from one system to another.
static void LuvToXyz (eVision.EC24 colorIn, out eVision.EC24 colorOut)
 Convert a color from one system to another.
static void ConvertRGBImageToBGR (eVision.EROIC24 source, eVision.EROIC24 destination)
 Converts a RGB image to BGR by swapping 1st and 3rd channels.
static void ConvertBGRImageToRGB (eVision.EROIC24 source, eVision.EROIC24 destination)
 Converts a BGR image to RGB by swapping 1st and 3rd channels.
static void ConvertRGBAImageToBGRA (eVision.EROIC24A source, eVision.EROIC24A destination)
 Converts a RGBA image to BGRA by swapping 1st and 3rd channels.
static void ConvertBGRAImageToRGBA (eVision.EROIC24A source, eVision.EROIC24A destination)
 Converts a BGRA image to RGBA by swapping 1st and 3rd channels.
static void Compose (eVision.EROIBW8 sourceImageOfColor0, eVision.EROIBW8 sourceImageOfColor1, eVision.EROIBW8 sourceImageOfColor2, eVision.EROIC24 colorDestinationImage, eVision.EColorLookup lookup)
 Combines three gray-level images, considered as three color planes, into a color image.
static void Compose (eVision.EROIBW8 sourceImageOfColor0, eVision.EROIBW8 sourceImageOfColor1, eVision.EROIBW8 sourceImageOfColor2, eVision.EROIC24 colorDestinationImage)
 Combines three gray-level images, considered as three color planes, into a color image.
static void Compose (eVision.EROIBW16 sourceImageOfColor0, eVision.EROIBW16 sourceImageOfColor1, eVision.EROIBW16 sourceImageOfColor2, eVision.EROIC48 colorDestinationImage)
 Combines three gray-level images, considered as three color planes, into a color image.
static void Decompose (eVision.EROIC24 colorSourceImage, eVision.EROIBW8 destinationImageOfColor0, eVision.EROIBW8 destinationImageOfColor1, eVision.EROIBW8 destinationImageOfColor2, eVision.EColorLookup lookup)
 Extracts the three color planes, considered as gray-level images, from a color image.
static void Decompose (eVision.EROIC24 colorSourceImage, eVision.EROIBW8 destinationImageOfColor0, eVision.EROIBW8 destinationImageOfColor1, eVision.EROIBW8 destinationImageOfColor2)
 Extracts the three color planes, considered as gray-level images, from a color image.
static void Decompose (eVision.EROIC48 colorSourceImage, eVision.EROIBW16 destinationImageOfColor0, eVision.EROIBW16 destinationImageOfColor1, eVision.EROIBW16 destinationImageOfColor2)
 Extracts the three color planes, considered as gray-level images, from a color image.
static void GetComponent (eVision.EROIC24 colorSourceImage, eVision.EROIBW8 bWDestinationImage, uint component, eVision.EColorLookup lookup)
 Extracts one color plane, considered as a gray-level image, from a color image.
static void GetComponent (eVision.EROIC24 colorSourceImage, eVision.EROIBW8 bWDestinationImage, uint component)
 Extracts one color plane, considered as a gray-level image, from a color image.
static void GetComponent (eVision.EROIC48 colorSourceImage, eVision.EROIBW16 bWDestinationImage, uint component)
 Extracts one color plane, considered as a gray-level image, from a color image.
static void SetComponent (eVision.EROIBW8 bWSourceImage, eVision.EROIC24 colorDestinationImage, uint component)
 Sets a color plane of a color image by using a gray-level image as component.
static void SetComponent (eVision.EROIBW16 bWSourceImage, eVision.EROIC48 colorDestinationImage, uint component)
 Sets a color plane of a color image by using a gray-level image as component.
static void Transform (eVision.EROIC24 sourceImage, eVision.EROIC24 destinationImage, eVision.EColorLookup lookup)
 Applies a color transformation to a specified image.
static void AlphaBlend (eVision.EROIC24 source, eVision.EROIC24 destination, double opacity)
 Draws an image over an other.
static void AssignNearestClassCenter (eVision.EROIC24 sourceImage, eVision.EROIC24 destinationImage, eVision.EC24Vector classCenters)
 Assigns to every pixel of the source image the nearest class center and stores its value in the destination image.
static void AssignNearestClass (eVision.EROIC24 sourceImage, eVision.EROIBW8 destinationImage, eVision.EC24Vector classCenters)
 Assigns to every pixel of the source image the nearest class index plus one and stores its value in the destination image.
static void ImproveClassCenters (eVision.EROIC24 sourceImage, eVision.EC24Vector classCenters)
 Redefines the class centers by computing the average color value of the pixels assigned to each class in the source image.
static void ClassAverages (eVision.EROIC24 sourceImage, eVision.EC24Vector classCenters, eVision.EColorVector averages)
 Computes the average source pixel colors for every class separately.
static void ClassVariances (eVision.EROIC24 sourceImage, eVision.EC24Vector classCenters, eVision.EColorVector averages, eVision.EColorVector variances)
 Computes the averages and variances of the image pixel colors for every class separately.
static void Format422To444 (eVision.EROIBW16 sourceImage, eVision.EROIC24 destinationImage, bool yFirst)
 Converts a YUV 4:2:2 image to a YUV 4:4:4 image using interpolation.
static void Format444To422 (eVision.EROIC24 sourceImage, eVision.EROIBW16 destinationImage, bool yFirst)
 Converts a YUV 4:4:4 image to a YUV 4:2:2 image using filtering.
static void BayerToC24 (eVision.EROIBW8 sourceImage, eVision.EROIC24 destinationImage, bool evenCol, bool evenRow, bool interpolate, bool improved)
 Converts a Bayer pattern encoded image into a color image.
static void BayerToC24 (eVision.EROIBW8 sourceImage, eVision.EROIC24 destinationImage, bool evenCol, bool evenRow, bool interpolate)
 Converts a Bayer pattern encoded image into a color image.
static void BayerToC24 (eVision.EROIBW8 sourceImage, eVision.EROIC24 destinationImage, bool evenCol, bool evenRow)
 Converts a Bayer pattern encoded image into a color image.
static void BayerToC24 (eVision.EROIBW8 sourceImage, eVision.EROIC24 destinationImage, bool evenCol)
 Converts a Bayer pattern encoded image into a color image.
static void BayerToC24 (eVision.EROIBW8 sourceImage, eVision.EROIC24 destinationImage)
 Converts a Bayer pattern encoded image into a color image.
static void BayerToC24 (eVision.EROIBW8 sourceImage, eVision.EROIC24 destinationImage, eVision.EBayerConfiguration bayerConfiguration, int mode)
 Converts a Bayer pattern encoded image into a color image.
static void BayerToC24 (eVision.EROIBW8 sourceImage, eVision.EROIC24 destinationImage, eVision.EBayerConfiguration bayerConfiguration)
 Converts a Bayer pattern encoded image into a color image.
static void C24ToBayer (eVision.EROIC24 sourceImage, eVision.EROIBW8 destinationImage, eVision.EBayerConfiguration bayerConfiguration)
 Converts a color image into a Bayer pattern encoded image.
static void C24ToBayer (eVision.EROIC24 sourceImage, eVision.EROIBW8 destinationImage, bool evenCol, bool evenRow)
 Converts a color image into a Bayer pattern encoded image.
static void C24ToBayer (eVision.EROIC24 sourceImage, eVision.EROIBW8 destinationImage, bool evenCol)
 Converts a color image into a Bayer pattern encoded image.
static void C24ToBayer (eVision.EROIC24 sourceImage, eVision.EROIBW8 destinationImage)
 Converts a color image into a Bayer pattern encoded image.
static void TransformBayer (eVision.EROIBW8 sourceImage, eVision.EROIBW8 destinationImage, eVision.EColorLookup lookup, eVision.EBayerConfiguration bayerConfiguration)
 Converts an image, using the transformation defined by a color lookup.
static void TransformBayer (eVision.EROIBW8 sourceImage, eVision.EROIBW8 destinationImage, eVision.EColorLookup lookup, bool evenCol, bool evenRow)
 Converts an image, using the transformation defined by a color lookup.
static void TransformBayer (eVision.EROIBW8 sourceImage, eVision.EROIBW8 destinationImage, eVision.EColorLookup lookup, bool evenCol)
 Converts an image, using the transformation defined by a color lookup.
static void TransformBayer (eVision.EROIBW8 sourceImage, eVision.EROIBW8 destinationImage, eVision.EColorLookup lookup)
 Converts an image, using the transformation defined by a color lookup.
static void RegisterPlanes (eVision.EROIC24 sourceImage, eVision.EROIC24 destinationImage, int rShiftX, int gShiftX, int bShiftX, int rShiftY, int gShiftY, int bShiftY)
 Sets a color plane of a color image by using a gray-level image as component.
static void RegisterPlanes (eVision.EROIC24 sourceImage, eVision.EROIC24 destinationImage, int rShiftX, int gShiftX, int bShiftX, int rShiftY, int gShiftY)
 Sets a color plane of a color image by using a gray-level image as component.
static void RegisterPlanes (eVision.EROIC24 sourceImage, eVision.EROIC24 destinationImage, int rShiftX, int gShiftX, int bShiftX, int rShiftY)
 Sets a color plane of a color image by using a gray-level image as component.
static void RegisterPlanes (eVision.EROIC24 sourceImage, eVision.EROIC24 destinationImage, int rShiftX, int gShiftX, int bShiftX)
 Sets a color plane of a color image by using a gray-level image as component.
static void RegisterPlanes (eVision.EROIC24 sourceImage, eVision.EROIC24 destinationImage, int rShiftX, int gShiftX)
 Sets a color plane of a color image by using a gray-level image as component.
static void RegisterPlanes (eVision.EROIC24 sourceImage, eVision.EROIC24 destinationImage, int rShiftX)
 Sets a color plane of a color image by using a gray-level image as component.
static void RegisterPlanes (eVision.EROIC24 sourceImage, eVision.EROIC24 destinationImage)
 Sets a color plane of a color image by using a gray-level image as component.

Properties

static eVision.ERgbStandard RgbStandard [get, set]
 RGB definition to be used when converting between RGB and other color systems.
static eVision.EColorQuantization SrcQuantization [get, set]
 Quantization mode for input values.
static eVision.EColorQuantization DstQuantization [get, set]
 Quantization mode for output values.
static float NtscGamma [get]
 NTSC gamma exponent.
static float PalGamma [get]
 PAL gamma exponent.
static float SmpteGamma [get]
 SMPTE gamma exponent.
static float CompensateNtscGamma [get]
 NTSC inverse gamma exponent.
static float CompensatePalGamma [get]
 PAL inverse gamma exponent.
static float CompensateSmpteGamma [get]
 NTSC inverse gamma exponent.
static float CieAR [get]
 CIE AR white illuminant.
static float CieAG [get]
 CIE AG white illuminant.
static float CieAB [get]
 CIE AB white illuminant.
static float CieD50R [get]
 CIE D50R white illuminant.
static float CieD50G [get]
 CIE D50G white illuminant.
static float CieD50B [get]
 CIE D50B white illuminant.
static float CieD55R [get]
 CIE D55R white illuminant.
static float CieD55G [get]
 CIE D55G white illuminant.
static float CieD55B [get]
 CIE D55B white illuminant.
static float CieD65R [get]
 CIE D65R white illuminant.
static float CieD65G [get]
 CIE D65G white illuminant.
static float CieD65B [get]
 CIE D65B white illuminant.
static float CieFR [get]
 CIE FR white illuminant.
static float CieFG [get]
 CIE FG white illuminant.
static float CieFB [get]
 CIE FB white illuminant.

Detailed Description

This class contains static properties and methods specific to the EasyColor library.

License(s): EasyColor

Member Function Documentation

◆ AlphaBlend()

void eVision.EasyColor.AlphaBlend ( eVision.EROIC24 source,
eVision.EROIC24 destination,
double opacity )
static

Draws an image over an other.

Parameters
sourceForeground image.
destinationBackground image.
opacityOpacity of the foreground image.

◆ AssignNearestClass()

void eVision.EasyColor.AssignNearestClass ( eVision.EROIC24 sourceImage,
eVision.EROIBW8 destinationImage,
eVision.EC24Vector classCenters )
static

Assigns to every pixel of the source image the nearest class index plus one and stores its value in the destination image.

Parameters
sourceImagePointer to the source image/ROI.
destinationImagePointer to the destination gray-level image/ROI.
classCentersPointer to the vector of the class centers.

This generates a labeled gray-level image for use with EasyObject (see EImageEncoder and ELabeledImageSegmenter).

Note
The class index plus one is stored instead of the class index because EasyObject will never code class 0 objects.

Color image segmentation allows you to decompose a color image in different regions by assigning a "class" (integer index) to every pixel. The nearest neighbor method is used, i.e. for each class a representative center is specified, and a given pixel is associated to the class with the closest center.

Color image segmentation can be used in conjunction with EasyObject to perform blob analysis on the segmented regions.

To use the color segmentation functions, the set of class centers must be specified as a vector of EC24 elements. In this sense, the method is termed supervised clustering. A good way to obtain these values is to compute the average color in an ROI.

Unsupervised clustering is also made available by implementing the so called K-means method that automatically improves an initial choice of class centers.

◆ AssignNearestClassCenter()

void eVision.EasyColor.AssignNearestClassCenter ( eVision.EROIC24 sourceImage,
eVision.EROIC24 destinationImage,
eVision.EC24Vector classCenters )
static

Assigns to every pixel of the source image the nearest class center and stores its value in the destination image.

Parameters
sourceImagePointer to the source image/ROI.
destinationImagePointer to the destination image/ROI.
classCentersPointer to the vector of the class centers.

This generates a labeled color image.

Color image segmentation allows you to decompose a color image in different regions by assigning a "class" (integer index) to every pixel. The nearest neighbor method is used, i.e. for each class a representative center is specified, and a given pixel is associated to the class with the closest center.

Color image segmentation can be used in conjunction with EasyObject to perform blob analysis on the segmented regions.

To use the color segmentation functions, the set of class centers must be specified as a vector of EC24 elements. In this sense, the method is termed supervised clustering. A good way to obtain these values is to compute the average color in an ROI.

Unsupervised clustering is also made available by implementing the so called K-means method that automatically improves an initial choice of class centers.

◆ BayerToC24() [1/7]

void eVision.EasyColor.BayerToC24 ( eVision.EROIBW8 sourceImage,
eVision.EROIC24 destinationImage )
static

Converts a Bayer pattern encoded image into a color image.

Prefer the function EasyColor.BayerToC24 with EBayerConfiguration and mode parameters.

Parameters
sourceImagePointer to the Bayer pattern input image/ROI, stored using the 8 bits per pixel format.
destinationImagePointer to the color output image/ROI.

The pattern can be shifted by one pixel horizontally and vertically as needed to deal with a non standard pattern origin.

See also Bayer Filter.

◆ BayerToC24() [2/7]

void eVision.EasyColor.BayerToC24 ( eVision.EROIBW8 sourceImage,
eVision.EROIC24 destinationImage,
bool evenCol )
static

Converts a Bayer pattern encoded image into a color image.

Prefer the function EasyColor.BayerToC24 with EBayerConfiguration and mode parameters.

Parameters
sourceImagePointer to the Bayer pattern input image/ROI, stored using the 8 bits per pixel format.
destinationImagePointer to the color output image/ROI.
evenColtrue if the leftmost image column contains no blue pixels.

The pattern can be shifted by one pixel horizontally and vertically as needed to deal with a non standard pattern origin.

See also Bayer Filter.

◆ BayerToC24() [3/7]

void eVision.EasyColor.BayerToC24 ( eVision.EROIBW8 sourceImage,
eVision.EROIC24 destinationImage,
bool evenCol,
bool evenRow )
static

Converts a Bayer pattern encoded image into a color image.

Prefer the function EasyColor.BayerToC24 with EBayerConfiguration and mode parameters.

Parameters
sourceImagePointer to the Bayer pattern input image/ROI, stored using the 8 bits per pixel format.
destinationImagePointer to the color output image/ROI.
evenColtrue if the leftmost image column contains no blue pixels.
evenRowtrue if the topmost image row contains no red pixels.

The pattern can be shifted by one pixel horizontally and vertically as needed to deal with a non standard pattern origin.

See also Bayer Filter.

◆ BayerToC24() [4/7]

void eVision.EasyColor.BayerToC24 ( eVision.EROIBW8 sourceImage,
eVision.EROIC24 destinationImage,
bool evenCol,
bool evenRow,
bool interpolate )
static

Converts a Bayer pattern encoded image into a color image.

Prefer the function EasyColor.BayerToC24 with EBayerConfiguration and mode parameters.

Parameters
sourceImagePointer to the Bayer pattern input image/ROI, stored using the 8 bits per pixel format.
destinationImagePointer to the color output image/ROI.
evenColtrue if the leftmost image column contains no blue pixels.
evenRowtrue if the topmost image row contains no red pixels.
interpolateInterpolation mode to be used for pixel reconstruction. When false, the missing color components are merely copied from northern/western pixels; when true, they are computed by averaging from relevant neighbors. By default, interpolation is used.

The pattern can be shifted by one pixel horizontally and vertically as needed to deal with a non standard pattern origin.

See also Bayer Filter.

◆ BayerToC24() [5/7]

void eVision.EasyColor.BayerToC24 ( eVision.EROIBW8 sourceImage,
eVision.EROIC24 destinationImage,
bool evenCol,
bool evenRow,
bool interpolate,
bool improved )
static

Converts a Bayer pattern encoded image into a color image.

Prefer the function EasyColor.BayerToC24 with EBayerConfiguration and mode parameters.

Parameters
sourceImagePointer to the Bayer pattern input image/ROI, stored using the 8 bits per pixel format.
destinationImagePointer to the color output image/ROI.
evenColtrue if the leftmost image column contains no blue pixels.
evenRowtrue if the topmost image row contains no red pixels.
interpolateInterpolation mode to be used for pixel reconstruction. When false, the missing color components are merely copied from northern/western pixels; when true, they are computed by averaging from relevant neighbors. By default, interpolation is used.
improvedProvides an access to an improved interpolation mode that reduces visible artifacts along object edges. The running time of the improved method is longer. By default, it is not used.

The pattern can be shifted by one pixel horizontally and vertically as needed to deal with a non standard pattern origin.

See also Bayer Filter.

◆ BayerToC24() [6/7]

void eVision.EasyColor.BayerToC24 ( eVision.EROIBW8 sourceImage,
eVision.EROIC24 destinationImage,
eVision.EBayerConfiguration bayerConfiguration )
static

Converts a Bayer pattern encoded image into a color image.

Parameters
sourceImagePointer to the Bayer pattern input image/ROI, stored using the 8 bits per pixel format.
destinationImagePointer to the color output image/ROI.
bayerConfigurationThe color configuration of the bayer image. The color configuration is defined by the component of the first 2 pixels of the image, see EBayerConfiguration.

◆ BayerToC24() [7/7]

void eVision.EasyColor.BayerToC24 ( eVision.EROIBW8 sourceImage,
eVision.EROIC24 destinationImage,
eVision.EBayerConfiguration bayerConfiguration,
int mode )
static

Converts a Bayer pattern encoded image into a color image.

Parameters
sourceImagePointer to the Bayer pattern input image/ROI, stored using the 8 bits per pixel format.
destinationImagePointer to the color output image/ROI.
bayerConfigurationThe color configuration of the bayer image. The color configuration is defined by the component of the first 2 pixels of the image, see EBayerConfiguration.
modeInterpolation mode to be used for RGB pixel reconstruction, from 0 to 4 (increasing quality).
  • mode 0: No interpolation (fastest)
  • mode 1: Linear interpolation on 3x3 kernel
  • mode 2: Advanced interpolation on 3x3 kernel
  • mode 3: Interpolation on 5x5 kernel
  • mode 4: Interpolation on 9x9 kernel (slowest)
  • mode 5: Linear interpolation on 2x2 kernel

By default, interpolation mode 1 is used.

◆ C24ToBayer() [1/4]

void eVision.EasyColor.C24ToBayer ( eVision.EROIC24 sourceImage,
eVision.EROIBW8 destinationImage )
static

Converts a color image into a Bayer pattern encoded image.

Parameters
sourceImagePointer to the color input image/ROI.
destinationImagePointer to the Bayer pattern output image/ROI, stored using the 8 bits per pixel format.

The pattern can be shifted by one pixel horizontally and vertically as needed to deal with a non standard pattern origin.

See also Bayer Filter.

Deprecated

Use the overload taking an EBayerConfiguration instead.

Deprecated in version 23.12. Scheduled to be removed in version 27.6.

◆ C24ToBayer() [2/4]

void eVision.EasyColor.C24ToBayer ( eVision.EROIC24 sourceImage,
eVision.EROIBW8 destinationImage,
bool evenCol )
static

Converts a color image into a Bayer pattern encoded image.

Parameters
sourceImagePointer to the color input image/ROI.
destinationImagePointer to the Bayer pattern output image/ROI, stored using the 8 bits per pixel format.
evenColtrue if the leftmost destination image column can't contain blue pixels.

The pattern can be shifted by one pixel horizontally and vertically as needed to deal with a non standard pattern origin.

See also Bayer Filter.

Deprecated

Use the overload taking an EBayerConfiguration instead.

Deprecated in version 23.12. Scheduled to be removed in version 27.6.

◆ C24ToBayer() [3/4]

void eVision.EasyColor.C24ToBayer ( eVision.EROIC24 sourceImage,
eVision.EROIBW8 destinationImage,
bool evenCol,
bool evenRow )
static

Converts a color image into a Bayer pattern encoded image.

Parameters
sourceImagePointer to the color input image/ROI.
destinationImagePointer to the Bayer pattern output image/ROI, stored using the 8 bits per pixel format.
evenColtrue if the leftmost destination image column can't contain blue pixels.
evenRowtrue if the topmost destination image row can't contain red pixels.

The pattern can be shifted by one pixel horizontally and vertically as needed to deal with a non standard pattern origin.

See also Bayer Filter.

Deprecated

Use the overload taking an EBayerConfiguration instead.

Deprecated in version 23.12. Scheduled to be removed in version 27.6.

◆ C24ToBayer() [4/4]

void eVision.EasyColor.C24ToBayer ( eVision.EROIC24 sourceImage,
eVision.EROIBW8 destinationImage,
eVision.EBayerConfiguration bayerConfiguration )
static

Converts a color image into a Bayer pattern encoded image.

Parameters
sourceImagePointer to the color input image/ROI.
destinationImagePointer to the Bayer pattern output image/ROI, stored using the 8 bits per pixel format.
bayerConfigurationThe color configuration of the bayer image. The color configuration is defined by the component of the first 2 pixels of the image, see EBayerConfiguration.

The pattern can be shifted by one pixel horizontally and vertically as needed to deal with a non standard pattern origin.

See also Bayer Filter.

◆ ClassAverages()

void eVision.EasyColor.ClassAverages ( eVision.EROIC24 sourceImage,
eVision.EC24Vector classCenters,
eVision.EColorVector averages )
static

Computes the average source pixel colors for every class separately.

Parameters
sourceImagePointer to the source image/ROI.
classCentersPointer to the vector of the class centers.
averagesPointer to the vector of the average color values.

This allows measuring the actual average color of the segmented regions.

Color image segmentation allows you to decompose a color image in different regions by assigning a "class" (integer index) to every pixel. The nearest neighbor method is used, i.e. for each class a representative center is specified, and a given pixel is associated to the class with the closest center.

Color image segmentation can be used in conjunction with EasyObject to perform blob analysis on the segmented regions.

To the color segmentation functions, the set of class centers must be specified as a vector of EC24 elements. In this sense, the method is termed supervised clustering. A good way to obtain these values is to compute the average color in an ROI.

Unsupervised clustering is also made available by implementing the so called K-means method that automatically improves an initial choice of class centers.

◆ ClassVariances()

void eVision.EasyColor.ClassVariances ( eVision.EROIC24 sourceImage,
eVision.EC24Vector classCenters,
eVision.EColorVector averages,
eVision.EColorVector variances )
static

Computes the averages and variances of the image pixel colors for every class separately.

Parameters
sourceImagePointer to the source image/ROI.
classCentersPointer to the vector of the class centers.
averagesPointer to the vector of the average color values.
variancesPointer to the vector of the variance color values.

This allows quantifying the homogeneity of the segmented regions.

Color image segmentation allows you to decompose a color image in different regions by assigning a "class" (integer index) to every pixel. The nearest neighbor method is used, i.e. for each class a representative center is specified, and a given pixel is associated to the class with the closest center.

Color image segmentation can be used in conjunction with EasyObject to perform blob analysis on the segmented regions.

To the color segmentation functions, the set of class centers must be specified as a vector of EC24 elements. In this sense, the method is termed supervised clustering. A good way to obtain these values is to compute the average color in an ROI.

Unsupervised clustering is also made available by implementing the so called K-means method that automatically improves an initial choice of class centers.

◆ Compose() [1/3]

void eVision.EasyColor.Compose ( eVision.EROIBW16 sourceImageOfColor0,
eVision.EROIBW16 sourceImageOfColor1,
eVision.EROIBW16 sourceImageOfColor2,
eVision.EROIC48 colorDestinationImage )
static

Combines three gray-level images, considered as three color planes, into a color image.

Parameters
sourceImageOfColor0Pointers to the three input gray-level component images/ROIs.
sourceImageOfColor1Pointers to the three input gray-level component images/ROIs.
sourceImageOfColor2Pointers to the three input gray-level component images/ROIs.
colorDestinationImagePointer to the output color image/ROI.

If a color lookup is used, the resulting image undergoes the corresponding color transform. This way, it is possible to build an RGB image from the color planes of another system, or conversely.

A color image can be seen as a set of three color planes, each corresponding to a color component. The color planes are themselves continuous tone images. An EImageC24 contains three EImageBW8.

◆ Compose() [2/3]

void eVision.EasyColor.Compose ( eVision.EROIBW8 sourceImageOfColor0,
eVision.EROIBW8 sourceImageOfColor1,
eVision.EROIBW8 sourceImageOfColor2,
eVision.EROIC24 colorDestinationImage )
static

Combines three gray-level images, considered as three color planes, into a color image.

Parameters
sourceImageOfColor0Pointers to the three input gray-level component images/ROIs.
sourceImageOfColor1Pointers to the three input gray-level component images/ROIs.
sourceImageOfColor2Pointers to the three input gray-level component images/ROIs.
colorDestinationImagePointer to the output color image/ROI.

If a color lookup is used, the resulting image undergoes the corresponding color transform. This way, it is possible to build an RGB image from the color planes of another system, or conversely.

A color image can be seen as a set of three color planes, each corresponding to a color component. The color planes are themselves continuous tone images. An EImageC24 contains three EImageBW8.

◆ Compose() [3/3]

void eVision.EasyColor.Compose ( eVision.EROIBW8 sourceImageOfColor0,
eVision.EROIBW8 sourceImageOfColor1,
eVision.EROIBW8 sourceImageOfColor2,
eVision.EROIC24 colorDestinationImage,
eVision.EColorLookup lookup )
static

Combines three gray-level images, considered as three color planes, into a color image.

Parameters
sourceImageOfColor0Pointers to the three input gray-level component images/ROIs.
sourceImageOfColor1Pointers to the three input gray-level component images/ROIs.
sourceImageOfColor2Pointers to the three input gray-level component images/ROIs.
colorDestinationImagePointer to the output color image/ROI.
lookupPointer to the color lookup table, or NULL.

If a color lookup is used, the resulting image undergoes the corresponding color transform. This way, it is possible to build an RGB image from the color planes of another system, or conversely.

A color image can be seen as a set of three color planes, each corresponding to a color component. The color planes are themselves continuous tone images. An EImageC24 contains three EImageBW8.

◆ ConvertBGRAImageToRGBA()

void eVision.EasyColor.ConvertBGRAImageToRGBA ( eVision.EROIC24A source,
eVision.EROIC24A destination )
static

Converts a BGRA image to RGBA by swapping 1st and 3rd channels.

Parameters
sourceThe source roi.
destinationThe destination roi. Can be the same as source and must have the same size if that's not the case.

By default, eVision uses EROIC24A in BGRA format. This method is provided for conversion to/from other libraries.

See also EasyColor.ConvertRGBAImageToBGRA.

License(s): BasicTypes

◆ ConvertBGRImageToRGB()

void eVision.EasyColor.ConvertBGRImageToRGB ( eVision.EROIC24 source,
eVision.EROIC24 destination )
static

Converts a BGR image to RGB by swapping 1st and 3rd channels.

Parameters
sourceThe source roi.
destinationThe destination roi. Can be the same as source and must have the same size if that's not the case.

By default, eVision uses EROIC24 in BGR format. This method is provided for conversion to/from other libraries.

See also EasyColor.ConvertRGBImageToBGR.

License(s): BasicTypes

◆ ConvertRGBAImageToBGRA()

void eVision.EasyColor.ConvertRGBAImageToBGRA ( eVision.EROIC24A source,
eVision.EROIC24A destination )
static

Converts a RGBA image to BGRA by swapping 1st and 3rd channels.

Parameters
sourceThe source roi.
destinationThe destination roi. Can be the same as source and must have the same size if that's not the case.

By default, eVision uses EROIC24A in BGRA format. This method is provided for conversion to/from other libraries.

See also EasyColor.ConvertBGRAImageToRGBA.

License(s): BasicTypes

◆ ConvertRGBImageToBGR()

void eVision.EasyColor.ConvertRGBImageToBGR ( eVision.EROIC24 source,
eVision.EROIC24 destination )
static

Converts a RGB image to BGR by swapping 1st and 3rd channels.

Parameters
sourceThe source roi.
destinationThe destination roi. Can be the same as source and must have the same size if that's not the case.

By default, eVision uses EROIC24 in BGR format. This method is provided for conversion to/from other libraries.

See also EasyColor.ConvertBGRImageToRGB.

License(s): BasicTypes

◆ Decompose() [1/3]

void eVision.EasyColor.Decompose ( eVision.EROIC24 colorSourceImage,
eVision.EROIBW8 destinationImageOfColor0,
eVision.EROIBW8 destinationImageOfColor1,
eVision.EROIBW8 destinationImageOfColor2 )
static

Extracts the three color planes, considered as gray-level images, from a color image.

Parameters
colorSourceImagePointer to the input color image/ROI.
destinationImageOfColor0Pointers to the three output gray level component images/ROIs.
destinationImageOfColor1Pointers to the three output gray level component images/ROIs.
destinationImageOfColor2Pointers to the three output gray level component images/ROIs.

If a color lookup is used, the source image undergoes the corresponding color transform. This way, it is possible to get the RGB components from an image of another system, of conversely.

A color image can be seen as a set of three color planes, each corresponding to a color component. The color planes are themselves continuous tone images. An EImageC24 contains three EImageBW8.

◆ Decompose() [2/3]

void eVision.EasyColor.Decompose ( eVision.EROIC24 colorSourceImage,
eVision.EROIBW8 destinationImageOfColor0,
eVision.EROIBW8 destinationImageOfColor1,
eVision.EROIBW8 destinationImageOfColor2,
eVision.EColorLookup lookup )
static

Extracts the three color planes, considered as gray-level images, from a color image.

Parameters
colorSourceImagePointer to the input color image/ROI.
destinationImageOfColor0Pointers to the three output gray level component images/ROIs.
destinationImageOfColor1Pointers to the three output gray level component images/ROIs.
destinationImageOfColor2Pointers to the three output gray level component images/ROIs.
lookupPointer to the color lookup table, or NULL.

If a color lookup is used, the source image undergoes the corresponding color transform. This way, it is possible to get the RGB components from an image of another system, of conversely.

A color image can be seen as a set of three color planes, each corresponding to a color component. The color planes are themselves continuous tone images. An EImageC24 contains three EImageBW8.

◆ Decompose() [3/3]

void eVision.EasyColor.Decompose ( eVision.EROIC48 colorSourceImage,
eVision.EROIBW16 destinationImageOfColor0,
eVision.EROIBW16 destinationImageOfColor1,
eVision.EROIBW16 destinationImageOfColor2 )
static

Extracts the three color planes, considered as gray-level images, from a color image.

Parameters
colorSourceImagePointer to the input color image/ROI.
destinationImageOfColor0Pointers to the three output gray level component images/ROIs.
destinationImageOfColor1Pointers to the three output gray level component images/ROIs.
destinationImageOfColor2Pointers to the three output gray level component images/ROIs.

If a color lookup is used, the source image undergoes the corresponding color transform. This way, it is possible to get the RGB components from an image of another system, of conversely.

A color image can be seen as a set of three color planes, each corresponding to a color component. The color planes are themselves continuous tone images. An EImageC24 contains three EImageBW8.

◆ Dequantize() [1/12]

void eVision.EasyColor.Dequantize ( eVision.EC24 colorIn,
out eVision.EISH colorOut )
static

Convert a quantized value to a unquantized value of a given color system.

Parameters
colorInInput quantized color.
colorOutOutput unquantized color, as defined by the corresponding structure.

Quantization is the process that transforms a continuous value, usually represented as a floating-point value in the [0..1] interval, into a discrete one, usually represented as an integer in the [0..255] interval. Dequantization is the reverse process. For RGB color system, it undoes the gamma-correction corresponding to the current ERgbStandard.

◆ Dequantize() [2/12]

void eVision.EasyColor.Dequantize ( eVision.EC24 colorIn,
out eVision.ELAB colorOut )
static

Convert a quantized value to a unquantized value of a given color system.

Parameters
colorInInput quantized color.
colorOutOutput unquantized color, as defined by the corresponding structure.

Quantization is the process that transforms a continuous value, usually represented as a floating-point value in the [0..1] interval, into a discrete one, usually represented as an integer in the [0..255] interval. Dequantization is the reverse process. For RGB color system, it undoes the gamma-correction corresponding to the current ERgbStandard.

◆ Dequantize() [3/12]

void eVision.EasyColor.Dequantize ( eVision.EC24 colorIn,
out eVision.ELCH colorOut )
static

Convert a quantized value to a unquantized value of a given color system.

Parameters
colorInInput quantized color.
colorOutOutput unquantized color, as defined by the corresponding structure.

Quantization is the process that transforms a continuous value, usually represented as a floating-point value in the [0..1] interval, into a discrete one, usually represented as an integer in the [0..255] interval. Dequantization is the reverse process. For RGB color system, it undoes the gamma-correction corresponding to the current ERgbStandard.

◆ Dequantize() [4/12]

void eVision.EasyColor.Dequantize ( eVision.EC24 colorIn,
out eVision.ELSH colorOut )
static

Convert a quantized value to a unquantized value of a given color system.

Parameters
colorInInput quantized color.
colorOutOutput unquantized color, as defined by the corresponding structure.

Quantization is the process that transforms a continuous value, usually represented as a floating-point value in the [0..1] interval, into a discrete one, usually represented as an integer in the [0..255] interval. Dequantization is the reverse process. For RGB color system, it undoes the gamma-correction corresponding to the current ERgbStandard.

◆ Dequantize() [5/12]

void eVision.EasyColor.Dequantize ( eVision.EC24 colorIn,
out eVision.ELUV colorOut )
static

Convert a quantized value to a unquantized value of a given color system.

Parameters
colorInInput quantized color.
colorOutOutput unquantized color, as defined by the corresponding structure.

Quantization is the process that transforms a continuous value, usually represented as a floating-point value in the [0..1] interval, into a discrete one, usually represented as an integer in the [0..255] interval. Dequantization is the reverse process. For RGB color system, it undoes the gamma-correction corresponding to the current ERgbStandard.

◆ Dequantize() [6/12]

void eVision.EasyColor.Dequantize ( eVision.EC24 colorIn,
out eVision.ERGB colorOut )
static

Convert a quantized value to a unquantized value of a given color system.

Parameters
colorInInput quantized color.
colorOutOutput unquantized color, as defined by the corresponding structure.

Quantization is the process that transforms a continuous value, usually represented as a floating-point value in the [0..1] interval, into a discrete one, usually represented as an integer in the [0..255] interval. Dequantization is the reverse process. For RGB color system, it undoes the gamma-correction corresponding to the current ERgbStandard.

◆ Dequantize() [7/12]

void eVision.EasyColor.Dequantize ( eVision.EC24 colorIn,
out eVision.EVSH colorOut )
static

Convert a quantized value to a unquantized value of a given color system.

Parameters
colorInInput quantized color.
colorOutOutput unquantized color, as defined by the corresponding structure.

Quantization is the process that transforms a continuous value, usually represented as a floating-point value in the [0..1] interval, into a discrete one, usually represented as an integer in the [0..255] interval. Dequantization is the reverse process. For RGB color system, it undoes the gamma-correction corresponding to the current ERgbStandard.

◆ Dequantize() [8/12]

void eVision.EasyColor.Dequantize ( eVision.EC24 colorIn,
out eVision.EXYZ colorOut )
static

Convert a quantized value to a unquantized value of a given color system.

Parameters
colorInInput quantized color.
colorOutOutput unquantized color, as defined by the corresponding structure.

Quantization is the process that transforms a continuous value, usually represented as a floating-point value in the [0..1] interval, into a discrete one, usually represented as an integer in the [0..255] interval. Dequantization is the reverse process. For RGB color system, it undoes the gamma-correction corresponding to the current ERgbStandard.

◆ Dequantize() [9/12]

void eVision.EasyColor.Dequantize ( eVision.EC24 colorIn,
out eVision.EYCbCr colorOut )
static

Convert a quantized value to a unquantized value of a given color system.

Parameters
colorInInput quantized color.
colorOutOutput unquantized color, as defined by the corresponding structure.

Quantization is the process that transforms a continuous value, usually represented as a floating-point value in the [0..1] interval, into a discrete one, usually represented as an integer in the [0..255] interval. Dequantization is the reverse process. For RGB color system, it undoes the gamma-correction corresponding to the current ERgbStandard.

◆ Dequantize() [10/12]

void eVision.EasyColor.Dequantize ( eVision.EC24 colorIn,
out eVision.EYIQ colorOut )
static

Convert a quantized value to a unquantized value of a given color system.

Parameters
colorInInput quantized color.
colorOutOutput unquantized color, as defined by the corresponding structure.

Quantization is the process that transforms a continuous value, usually represented as a floating-point value in the [0..1] interval, into a discrete one, usually represented as an integer in the [0..255] interval. Dequantization is the reverse process. For RGB color system, it undoes the gamma-correction corresponding to the current ERgbStandard.

◆ Dequantize() [11/12]

void eVision.EasyColor.Dequantize ( eVision.EC24 colorIn,
out eVision.EYSH colorOut )
static

Convert a quantized value to a unquantized value of a given color system.

Parameters
colorInInput quantized color.
colorOutOutput unquantized color, as defined by the corresponding structure.

Quantization is the process that transforms a continuous value, usually represented as a floating-point value in the [0..1] interval, into a discrete one, usually represented as an integer in the [0..255] interval. Dequantization is the reverse process. For RGB color system, it undoes the gamma-correction corresponding to the current ERgbStandard.

◆ Dequantize() [12/12]

void eVision.EasyColor.Dequantize ( eVision.EC24 colorIn,
out eVision.EYUV colorOut )
static

Convert a quantized value to a unquantized value of a given color system.

Parameters
colorInInput quantized color.
colorOutOutput unquantized color, as defined by the corresponding structure.

Quantization is the process that transforms a continuous value, usually represented as a floating-point value in the [0..1] interval, into a discrete one, usually represented as an integer in the [0..255] interval. Dequantization is the reverse process. For RGB color system, it undoes the gamma-correction corresponding to the current ERgbStandard.

◆ Format422To444()

void eVision.EasyColor.Format422To444 ( eVision.EROIBW16 sourceImage,
eVision.EROIC24 destinationImage,
bool yFirst )
static

Converts a YUV 4:2:2 image to a YUV 4:4:4 image using interpolation.

Parameters
sourceImagePointer to the input image/ROI, stored using the 16 bits per pixel format.
destinationImagePointer to the output image/ROI.
yFirstFlag indicating if the format is YUYVYUYV (true) or UYVYUYVY (false).

In the YUV system, it has been established that sub-sampling the chroma components does not degrade the visual image quality. The 4:4:4 format uses three bytes of information by pixel. The 4:2:2 format is such that only the U and V chroma of the even pixels are kept and they are stored with the even and odd luma, as follows: Thus, only two bytes per pixel are required. Y~[even]~ U~[even]~ Y~[odd]~ V~[even]~

◆ Format444To422()

void eVision.EasyColor.Format444To422 ( eVision.EROIC24 sourceImage,
eVision.EROIBW16 destinationImage,
bool yFirst )
static

Converts a YUV 4:4:4 image to a YUV 4:2:2 image using filtering.

Parameters
sourceImagePointer to the input image/ROI.
destinationImagePointer to the output image/ROI, stored using the 16 bits per pixel format.
yFirstFlag indicating if the format is YUYVYUYV (true) or UYVYUYVY (false).

In the YUV system, it has been established that sub-sampling the chroma components does not degrade the visual image quality. The 4:4:4 format uses three bytes of information by pixel. The 4:2:2 format is such that only the U and V chroma of the even pixels are kept and they are stored with the even and odd luma, as follows: Thus, only two bytes per pixel are required. Y~[even]~ U~[even]~ Y~[odd]~ V~[even]~

◆ GetComponent() [1/3]

void eVision.EasyColor.GetComponent ( eVision.EROIC24 colorSourceImage,
eVision.EROIBW8 bWDestinationImage,
uint component )
static

Extracts one color plane, considered as a gray-level image, from a color image.

Parameters
colorSourceImagePointer to the input color image/ROI.
bWDestinationImagePointers to the output gray-level component image/ROI.
componentColor component index (0, 1, or 2).

◆ GetComponent() [2/3]

void eVision.EasyColor.GetComponent ( eVision.EROIC24 colorSourceImage,
eVision.EROIBW8 bWDestinationImage,
uint component,
eVision.EColorLookup lookup )
static

Extracts one color plane, considered as a gray-level image, from a color image.

Parameters
colorSourceImagePointer to the input color image/ROI.
bWDestinationImagePointers to the output gray-level component image/ROI.
componentColor component index (0, 1, or 2).
lookupPointer to the color lookup table, or NULL.

◆ GetComponent() [3/3]

void eVision.EasyColor.GetComponent ( eVision.EROIC48 colorSourceImage,
eVision.EROIBW16 bWDestinationImage,
uint component )
static

Extracts one color plane, considered as a gray-level image, from a color image.

Parameters
colorSourceImagePointer to the input color image/ROI.
bWDestinationImagePointers to the output gray-level component image/ROI.
componentColor component index (0, 1, or 2).

◆ ImproveClassCenters()

void eVision.EasyColor.ImproveClassCenters ( eVision.EROIC24 sourceImage,
eVision.EC24Vector classCenters )
static

Redefines the class centers by computing the average color value of the pixels assigned to each class in the source image.

Parameters
sourceImagePointer to the source image/ROI.
classCentersPointer to the vector of the class centers.

This implements a step of the K-means method for unsupervised clustering.

Color image segmentation allows you to decompose a color image in different regions by assigning a "class" (integer index) to every pixel. The nearest neighbor method is used, i.e. for each class a representative center is specified, and a given pixel is associated to the class with the closest center.

Color image segmentation can be used in conjunction with EasyObject to perform blob analysis on the segmented regions.

◆ IshToRgb() [1/2]

void eVision.EasyColor.IshToRgb ( eVision.EC24 colorIn,
out eVision.EC24 colorOut )
static

Convert a color from any system to RGB.

Parameters
colorInInput color.
colorOutOutput color.

These functions transform the color components (of a pixel) expressed in some color system to the corresponding components in another system. These functions take into account the current ERgbStandard and the associated white point if necessary.

◆ IshToRgb() [2/2]

void eVision.EasyColor.IshToRgb ( eVision.EISH colorIn,
out eVision.ERGB colorOut )
static

Convert a color from any system to RGB.

Parameters
colorInInput color.
colorOutOutput color.

These functions transform the color components (of a pixel) expressed in some color system to the corresponding components in another system. These functions take into account the current ERgbStandard and the associated white point if necessary.

◆ LabToRgb() [1/2]

void eVision.EasyColor.LabToRgb ( eVision.EC24 colorIn,
out eVision.EC24 colorOut )
static

Convert a color from any system to RGB.

Parameters
colorInInput color.
colorOutOutput color.

These functions transform the color components (of a pixel) expressed in some color system to the corresponding components in another system. These functions take into account the current ERgbStandard and the associated white point if necessary.

◆ LabToRgb() [2/2]

void eVision.EasyColor.LabToRgb ( eVision.ELAB colorIn,
out eVision.ERGB colorOut )
static

Convert a color from any system to RGB.

Parameters
colorInInput color.
colorOutOutput color.

These functions transform the color components (of a pixel) expressed in some color system to the corresponding components in another system. These functions take into account the current ERgbStandard and the associated white point if necessary.

◆ LabToXyz() [1/2]

void eVision.EasyColor.LabToXyz ( eVision.EC24 colorIn,
out eVision.EC24 colorOut )
static

Convert a color from one system to another.

Parameters
colorInInput color.
colorOutOutput color.

These functions transform the color components (of a pixel) expressed in some color system to the corresponding components in another system. These functions take into account the current ERgbStandard and the associated white point if necessary.

◆ LabToXyz() [2/2]

void eVision.EasyColor.LabToXyz ( eVision.ELAB colorIn,
out eVision.EXYZ colorOut )
static

Convert a color from one system to another.

Parameters
colorInInput color.
colorOutOutput color.

These functions transform the color components (of a pixel) expressed in some color system to the corresponding components in another system. These functions take into account the current ERgbStandard and the associated white point if necessary.

◆ LchToRgb() [1/2]

void eVision.EasyColor.LchToRgb ( eVision.EC24 colorIn,
out eVision.EC24 colorOut )
static

Convert a color from any system to RGB.

Parameters
colorInInput color.
colorOutOutput color.

These functions transform the color components (of a pixel) expressed in some color system to the corresponding components in another system. These functions take into account the current ERgbStandard and the associated white point if necessary.

◆ LchToRgb() [2/2]

void eVision.EasyColor.LchToRgb ( eVision.ELCH colorIn,
out eVision.ERGB colorOut )
static

Convert a color from any system to RGB.

Parameters
colorInInput color.
colorOutOutput color.

These functions transform the color components (of a pixel) expressed in some color system to the corresponding components in another system. These functions take into account the current ERgbStandard and the associated white point if necessary.

◆ LshToRgb() [1/2]

void eVision.EasyColor.LshToRgb ( eVision.EC24 colorIn,
out eVision.EC24 colorOut )
static

Convert a color from any system to RGB.

Parameters
colorInInput color.
colorOutOutput color.

These functions transform the color components (of a pixel) expressed in some color system to the corresponding components in another system. These functions take into account the current ERgbStandard and the associated white point if necessary.

◆ LshToRgb() [2/2]

void eVision.EasyColor.LshToRgb ( eVision.ELSH colorIn,
out eVision.ERGB colorOut )
static

Convert a color from any system to RGB.

Parameters
colorInInput color.
colorOutOutput color.

These functions transform the color components (of a pixel) expressed in some color system to the corresponding components in another system. These functions take into account the current ERgbStandard and the associated white point if necessary.

◆ LuvToRgb() [1/2]

void eVision.EasyColor.LuvToRgb ( eVision.EC24 colorIn,
out eVision.EC24 colorOut )
static

Convert a color from any system to RGB.

Parameters
colorInInput color.
colorOutOutput color.

These functions transform the color components (of a pixel) expressed in some color system to the corresponding components in another system. These functions take into account the current ERgbStandard and the associated white point if necessary.

◆ LuvToRgb() [2/2]

void eVision.EasyColor.LuvToRgb ( eVision.ELUV colorIn,
out eVision.ERGB colorOut )
static

Convert a color from any system to RGB.

Parameters
colorInInput color.
colorOutOutput color.

These functions transform the color components (of a pixel) expressed in some color system to the corresponding components in another system. These functions take into account the current ERgbStandard and the associated white point if necessary.

◆ LuvToXyz() [1/2]

void eVision.EasyColor.LuvToXyz ( eVision.EC24 colorIn,
out eVision.EC24 colorOut )
static

Convert a color from one system to another.

Parameters
colorInInput color.
colorOutOutput color.

These functions transform the color components (of a pixel) expressed in some color system to the corresponding components in another system. These functions take into account the current ERgbStandard and the associated white point if necessary.

◆ LuvToXyz() [2/2]

void eVision.EasyColor.LuvToXyz ( eVision.ELUV colorIn,
out eVision.EXYZ colorOut )
static

Convert a color from one system to another.

Parameters
colorInInput color.
colorOutOutput color.

These functions transform the color components (of a pixel) expressed in some color system to the corresponding components in another system. These functions take into account the current ERgbStandard and the associated white point if necessary.

◆ PseudoColor()

void eVision.EasyColor.PseudoColor ( eVision.EROIBW8 sourceImage,
eVision.EROIC24 destinationImage,
eVision.EPseudoColorLookup lookup )
static

Applies the mapping defined by the pseudo-color lookup table to transform a gray-level image into a color image.

Parameters
sourceImagePointer to the source gray-level image.
destinationImagePointer to the destination color image.
lookupPointer to the pseudo-color lookup table.

Pseudo-coloring is a convenient way to display gray-level images with enhanced contrast: a shade of colors is associated to the shade of gray-level values. A simple way to define the shade of colors is to specify a path in color space.

In order to use pseudo-coloring, a special lookup table is used: EPseudoColorLookup. It handles the mapping between the gray-level and color values.

◆ Quantize() [1/12]

void eVision.EasyColor.Quantize ( eVision.EISH colorIn,
out eVision.EC24 colorOut )
static

Convert an unquantized color of a given color system to a quantized color.

Parameters
colorInInput unquantized color, as defined by the corresponding structure.
colorOutOutput quantized color.

Quantization is the process that transforms a continuous value, usually represented as a floating-point value in the [0..1] interval, into a discrete one, usually represented as an integer in the [0..255] interval. Dequantization is the reverse process. For RGB color system, it applies gamma-correction corresponding to the current ERgbStandard.

◆ Quantize() [2/12]

void eVision.EasyColor.Quantize ( eVision.ELAB colorIn,
out eVision.EC24 colorOut )
static

Convert an unquantized color of a given color system to a quantized color.

Parameters
colorInInput unquantized color, as defined by the corresponding structure.
colorOutOutput quantized color.

Quantization is the process that transforms a continuous value, usually represented as a floating-point value in the [0..1] interval, into a discrete one, usually represented as an integer in the [0..255] interval. Dequantization is the reverse process. For RGB color system, it applies gamma-correction corresponding to the current ERgbStandard.

◆ Quantize() [3/12]

void eVision.EasyColor.Quantize ( eVision.ELCH colorIn,
out eVision.EC24 colorOut )
static

Convert an unquantized color of a given color system to a quantized color.

Parameters
colorInInput unquantized color, as defined by the corresponding structure.
colorOutOutput quantized color.

Quantization is the process that transforms a continuous value, usually represented as a floating-point value in the [0..1] interval, into a discrete one, usually represented as an integer in the [0..255] interval. Dequantization is the reverse process. For RGB color system, it applies gamma-correction corresponding to the current ERgbStandard.

◆ Quantize() [4/12]

void eVision.EasyColor.Quantize ( eVision.ELSH colorIn,
out eVision.EC24 colorOut )
static

Convert an unquantized color of a given color system to a quantized color.

Parameters
colorInInput unquantized color, as defined by the corresponding structure.
colorOutOutput quantized color.

Quantization is the process that transforms a continuous value, usually represented as a floating-point value in the [0..1] interval, into a discrete one, usually represented as an integer in the [0..255] interval. Dequantization is the reverse process. For RGB color system, it applies gamma-correction corresponding to the current ERgbStandard.

◆ Quantize() [5/12]

void eVision.EasyColor.Quantize ( eVision.ELUV colorIn,
out eVision.EC24 colorOut )
static

Convert an unquantized color of a given color system to a quantized color.

Parameters
colorInInput unquantized color, as defined by the corresponding structure.
colorOutOutput quantized color.

Quantization is the process that transforms a continuous value, usually represented as a floating-point value in the [0..1] interval, into a discrete one, usually represented as an integer in the [0..255] interval. Dequantization is the reverse process. For RGB color system, it applies gamma-correction corresponding to the current ERgbStandard.

◆ Quantize() [6/12]

void eVision.EasyColor.Quantize ( eVision.ERGB colorIn,
out eVision.EC24 colorOut )
static

Convert an unquantized color of a given color system to a quantized color.

Parameters
colorInInput unquantized color, as defined by the corresponding structure.
colorOutOutput quantized color.

Quantization is the process that transforms a continuous value, usually represented as a floating-point value in the [0..1] interval, into a discrete one, usually represented as an integer in the [0..255] interval. Dequantization is the reverse process. For RGB color system, it applies gamma-correction corresponding to the current ERgbStandard.

◆ Quantize() [7/12]

void eVision.EasyColor.Quantize ( eVision.EVSH colorIn,
out eVision.EC24 colorOut )
static

Convert an unquantized color of a given color system to a quantized color.

Parameters
colorInInput unquantized color, as defined by the corresponding structure.
colorOutOutput quantized color.

Quantization is the process that transforms a continuous value, usually represented as a floating-point value in the [0..1] interval, into a discrete one, usually represented as an integer in the [0..255] interval. Dequantization is the reverse process. For RGB color system, it applies gamma-correction corresponding to the current ERgbStandard.

◆ Quantize() [8/12]

void eVision.EasyColor.Quantize ( eVision.EXYZ colorIn,
out eVision.EC24 colorOut )
static

Convert an unquantized color of a given color system to a quantized color.

Parameters
colorInInput unquantized color, as defined by the corresponding structure.
colorOutOutput quantized color.

Quantization is the process that transforms a continuous value, usually represented as a floating-point value in the [0..1] interval, into a discrete one, usually represented as an integer in the [0..255] interval. Dequantization is the reverse process. For RGB color system, it applies gamma-correction corresponding to the current ERgbStandard.

◆ Quantize() [9/12]

void eVision.EasyColor.Quantize ( eVision.EYCbCr colorIn,
out eVision.EC24 colorOut )
static

Convert an unquantized color of a given color system to a quantized color.

Parameters
colorInInput unquantized color, as defined by the corresponding structure.
colorOutOutput quantized color.

Quantization is the process that transforms a continuous value, usually represented as a floating-point value in the [0..1] interval, into a discrete one, usually represented as an integer in the [0..255] interval. Dequantization is the reverse process. For RGB color system, it applies gamma-correction corresponding to the current ERgbStandard.

◆ Quantize() [10/12]

void eVision.EasyColor.Quantize ( eVision.EYIQ colorIn,
out eVision.EC24 colorOut )
static

Convert an unquantized color of a given color system to a quantized color.

Parameters
colorInInput unquantized color, as defined by the corresponding structure.
colorOutOutput quantized color.

Quantization is the process that transforms a continuous value, usually represented as a floating-point value in the [0..1] interval, into a discrete one, usually represented as an integer in the [0..255] interval. Dequantization is the reverse process. For RGB color system, it applies gamma-correction corresponding to the current ERgbStandard.

◆ Quantize() [11/12]

void eVision.EasyColor.Quantize ( eVision.EYSH colorIn,
out eVision.EC24 colorOut )
static

Convert an unquantized color of a given color system to a quantized color.

Parameters
colorInInput unquantized color, as defined by the corresponding structure.
colorOutOutput quantized color.

Quantization is the process that transforms a continuous value, usually represented as a floating-point value in the [0..1] interval, into a discrete one, usually represented as an integer in the [0..255] interval. Dequantization is the reverse process. For RGB color system, it applies gamma-correction corresponding to the current ERgbStandard.

◆ Quantize() [12/12]

void eVision.EasyColor.Quantize ( eVision.EYUV colorIn,
out eVision.EC24 colorOut )
static

Convert an unquantized color of a given color system to a quantized color.

Parameters
colorInInput unquantized color, as defined by the corresponding structure.
colorOutOutput quantized color.

Quantization is the process that transforms a continuous value, usually represented as a floating-point value in the [0..1] interval, into a discrete one, usually represented as an integer in the [0..255] interval. Dequantization is the reverse process. For RGB color system, it applies gamma-correction corresponding to the current ERgbStandard.

◆ RegisterPlanes() [1/7]

void eVision.EasyColor.RegisterPlanes ( eVision.EROIC24 sourceImage,
eVision.EROIC24 destinationImage )
static

Sets a color plane of a color image by using a gray-level image as component.

Parameters
sourceImagePointers to the input image/ROI.
destinationImagePointer to the output image/ROI.

A color image can be seen as a set of three color planes, each corresponding to a color component. The color planes are themselves continuous tone images. An EImageC24 contains three EImageBW8.

◆ RegisterPlanes() [2/7]

void eVision.EasyColor.RegisterPlanes ( eVision.EROIC24 sourceImage,
eVision.EROIC24 destinationImage,
int rShiftX )
static

Sets a color plane of a color image by using a gray-level image as component.

Parameters
sourceImagePointers to the input image/ROI.
destinationImagePointer to the output image/ROI.
rShiftXHorizontal shifting of the first plane (the red one in case of an RGB image), expressed in pixels.

A color image can be seen as a set of three color planes, each corresponding to a color component. The color planes are themselves continuous tone images. An EImageC24 contains three EImageBW8.

◆ RegisterPlanes() [3/7]

void eVision.EasyColor.RegisterPlanes ( eVision.EROIC24 sourceImage,
eVision.EROIC24 destinationImage,
int rShiftX,
int gShiftX )
static

Sets a color plane of a color image by using a gray-level image as component.

Parameters
sourceImagePointers to the input image/ROI.
destinationImagePointer to the output image/ROI.
rShiftXHorizontal shifting of the first plane (the red one in case of an RGB image), expressed in pixels.
gShiftXHorizontal shifting of the second plane (the green one in case of an RGB image), expressed in pixels.

A color image can be seen as a set of three color planes, each corresponding to a color component. The color planes are themselves continuous tone images. An EImageC24 contains three EImageBW8.

◆ RegisterPlanes() [4/7]

void eVision.EasyColor.RegisterPlanes ( eVision.EROIC24 sourceImage,
eVision.EROIC24 destinationImage,
int rShiftX,
int gShiftX,
int bShiftX )
static

Sets a color plane of a color image by using a gray-level image as component.

Parameters
sourceImagePointers to the input image/ROI.
destinationImagePointer to the output image/ROI.
rShiftXHorizontal shifting of the first plane (the red one in case of an RGB image), expressed in pixels.
gShiftXHorizontal shifting of the second plane (the green one in case of an RGB image), expressed in pixels.
bShiftXHorizontal shifting of the third plane (the blue one in case of an RGB image), expressed in pixels.

A color image can be seen as a set of three color planes, each corresponding to a color component. The color planes are themselves continuous tone images. An EImageC24 contains three EImageBW8.

◆ RegisterPlanes() [5/7]

void eVision.EasyColor.RegisterPlanes ( eVision.EROIC24 sourceImage,
eVision.EROIC24 destinationImage,
int rShiftX,
int gShiftX,
int bShiftX,
int rShiftY )
static

Sets a color plane of a color image by using a gray-level image as component.

Parameters
sourceImagePointers to the input image/ROI.
destinationImagePointer to the output image/ROI.
rShiftXHorizontal shifting of the first plane (the red one in case of an RGB image), expressed in pixels.
gShiftXHorizontal shifting of the second plane (the green one in case of an RGB image), expressed in pixels.
bShiftXHorizontal shifting of the third plane (the blue one in case of an RGB image), expressed in pixels.
rShiftYVertical shifting of the first plane (the red one in case of an RGB image), expressed in pixels.

A color image can be seen as a set of three color planes, each corresponding to a color component. The color planes are themselves continuous tone images. An EImageC24 contains three EImageBW8.

◆ RegisterPlanes() [6/7]

void eVision.EasyColor.RegisterPlanes ( eVision.EROIC24 sourceImage,
eVision.EROIC24 destinationImage,
int rShiftX,
int gShiftX,
int bShiftX,
int rShiftY,
int gShiftY )
static

Sets a color plane of a color image by using a gray-level image as component.

Parameters
sourceImagePointers to the input image/ROI.
destinationImagePointer to the output image/ROI.
rShiftXHorizontal shifting of the first plane (the red one in case of an RGB image), expressed in pixels.
gShiftXHorizontal shifting of the second plane (the green one in case of an RGB image), expressed in pixels.
bShiftXHorizontal shifting of the third plane (the blue one in case of an RGB image), expressed in pixels.
rShiftYVertical shifting of the first plane (the red one in case of an RGB image), expressed in pixels.
gShiftYVertical shifting of the second plane (the green one in case of an RGB image), expressed in pixels.

A color image can be seen as a set of three color planes, each corresponding to a color component. The color planes are themselves continuous tone images. An EImageC24 contains three EImageBW8.

◆ RegisterPlanes() [7/7]

void eVision.EasyColor.RegisterPlanes ( eVision.EROIC24 sourceImage,
eVision.EROIC24 destinationImage,
int rShiftX,
int gShiftX,
int bShiftX,
int rShiftY,
int gShiftY,
int bShiftY )
static

Sets a color plane of a color image by using a gray-level image as component.

Parameters
sourceImagePointers to the input image/ROI.
destinationImagePointer to the output image/ROI.
rShiftXHorizontal shifting of the first plane (the red one in case of an RGB image), expressed in pixels.
gShiftXHorizontal shifting of the second plane (the green one in case of an RGB image), expressed in pixels.
bShiftXHorizontal shifting of the third plane (the blue one in case of an RGB image), expressed in pixels.
rShiftYVertical shifting of the first plane (the red one in case of an RGB image), expressed in pixels.
gShiftYVertical shifting of the second plane (the green one in case of an RGB image), expressed in pixels.
bShiftYVertical shifting of the third plane (the blue one in case of an RGB image), expressed in pixels.

A color image can be seen as a set of three color planes, each corresponding to a color component. The color planes are themselves continuous tone images. An EImageC24 contains three EImageBW8.

◆ RgbToIsh() [1/2]

void eVision.EasyColor.RgbToIsh ( eVision.EC24 colorIn,
out eVision.EC24 colorOut )
static

Convert a color from RGB to another system.

Parameters
colorInInput color.
colorOutOutput color, as defined by the corresponding structure.

These functions transform the color components (of a pixel) expressed in some color system to the corresponding components in another system. These functions take into account the current ERgbStandard and the associated white point if necessary.

◆ RgbToIsh() [2/2]

void eVision.EasyColor.RgbToIsh ( eVision.ERGB colorIn,
out eVision.EISH colorOut )
static

Convert a color from RGB to another system.

Parameters
colorInInput color.
colorOutOutput color, as defined by the corresponding structure.

These functions transform the color components (of a pixel) expressed in some color system to the corresponding components in another system. These functions take into account the current ERgbStandard and the associated white point if necessary.

◆ RgbToLab() [1/2]

void eVision.EasyColor.RgbToLab ( eVision.EC24 colorIn,
out eVision.EC24 colorOut )
static

Convert a color from RGB to another system.

Parameters
colorInInput color.
colorOutOutput color, as defined by the corresponding structure.

These functions transform the color components (of a pixel) expressed in some color system to the corresponding components in another system. These functions take into account the current ERgbStandard and the associated white point if necessary.

◆ RgbToLab() [2/2]

void eVision.EasyColor.RgbToLab ( eVision.ERGB colorIn,
out eVision.ELAB colorOut )
static

Convert a color from RGB to another system.

Parameters
colorInInput color.
colorOutOutput color, as defined by the corresponding structure.

These functions transform the color components (of a pixel) expressed in some color system to the corresponding components in another system. These functions take into account the current ERgbStandard and the associated white point if necessary.

◆ RgbToLch() [1/2]

void eVision.EasyColor.RgbToLch ( eVision.EC24 colorIn,
out eVision.EC24 colorOut )
static

Convert a color from RGB to another system.

Parameters
colorInInput color.
colorOutOutput color, as defined by the corresponding structure.

These functions transform the color components (of a pixel) expressed in some color system to the corresponding components in another system. These functions take into account the current ERgbStandard and the associated white point if necessary.

◆ RgbToLch() [2/2]

void eVision.EasyColor.RgbToLch ( eVision.ERGB colorIn,
out eVision.ELCH colorOut )
static

Convert a color from RGB to another system.

Parameters
colorInInput color.
colorOutOutput color, as defined by the corresponding structure.

These functions transform the color components (of a pixel) expressed in some color system to the corresponding components in another system. These functions take into account the current ERgbStandard and the associated white point if necessary.

◆ RgbToLsh() [1/2]

void eVision.EasyColor.RgbToLsh ( eVision.EC24 colorIn,
out eVision.EC24 colorOut )
static

Convert a color from RGB to another system.

Parameters
colorInInput color.
colorOutOutput color, as defined by the corresponding structure.

These functions transform the color components (of a pixel) expressed in some color system to the corresponding components in another system. These functions take into account the current ERgbStandard and the associated white point if necessary.

◆ RgbToLsh() [2/2]

void eVision.EasyColor.RgbToLsh ( eVision.ERGB colorIn,
out eVision.ELSH colorOut )
static

Convert a color from RGB to another system.

Parameters
colorInInput color.
colorOutOutput color, as defined by the corresponding structure.

These functions transform the color components (of a pixel) expressed in some color system to the corresponding components in another system. These functions take into account the current ERgbStandard and the associated white point if necessary.

◆ RgbToLuv() [1/2]

void eVision.EasyColor.RgbToLuv ( eVision.EC24 colorIn,
out eVision.EC24 colorOut )
static

Convert a color from RGB to another system.

Parameters
colorInInput color.
colorOutOutput color, as defined by the corresponding structure.

These functions transform the color components (of a pixel) expressed in some color system to the corresponding components in another system. These functions take into account the current ERgbStandard and the associated white point if necessary.

◆ RgbToLuv() [2/2]

void eVision.EasyColor.RgbToLuv ( eVision.ERGB colorIn,
out eVision.ELUV colorOut )
static

Convert a color from RGB to another system.

Parameters
colorInInput color.
colorOutOutput color, as defined by the corresponding structure.

These functions transform the color components (of a pixel) expressed in some color system to the corresponding components in another system. These functions take into account the current ERgbStandard and the associated white point if necessary.

◆ RgbToReducedXyz() [1/2]

void eVision.EasyColor.RgbToReducedXyz ( eVision.EC24 colorIn,
out eVision.EC24 colorOut )
static

Convert a color from one system to another.

Parameters
colorInInput color.
colorOutOutput color.

These functions transform the color components (of a pixel) expressed in some color system to the corresponding components in another system. These functions take into account the current ERgbStandard and the associated white point if necessary.

◆ RgbToReducedXyz() [2/2]

void eVision.EasyColor.RgbToReducedXyz ( eVision.ERGB colorIn,
out eVision.EXYZ colorOut )
static

Convert a color from one system to another.

Parameters
colorInInput color.
colorOutOutput color.

These functions transform the color components (of a pixel) expressed in some color system to the corresponding components in another system. These functions take into account the current ERgbStandard and the associated white point if necessary.

◆ RgbToVsh() [1/2]

void eVision.EasyColor.RgbToVsh ( eVision.EC24 colorIn,
out eVision.EC24 colorOut )
static

Convert a color from RGB to another system.

Parameters
colorInInput color.
colorOutOutput color, as defined by the corresponding structure.

These functions transform the color components (of a pixel) expressed in some color system to the corresponding components in another system. These functions take into account the current ERgbStandard and the associated white point if necessary.

◆ RgbToVsh() [2/2]

void eVision.EasyColor.RgbToVsh ( eVision.ERGB colorIn,
out eVision.EVSH colorOut )
static

Convert a color from RGB to another system.

Parameters
colorInInput color.
colorOutOutput color, as defined by the corresponding structure.

These functions transform the color components (of a pixel) expressed in some color system to the corresponding components in another system. These functions take into account the current ERgbStandard and the associated white point if necessary.

◆ RgbToXyz() [1/2]

void eVision.EasyColor.RgbToXyz ( eVision.EC24 colorIn,
out eVision.EC24 colorOut )
static

Convert a color from RGB to another system.

Parameters
colorInInput color.
colorOutOutput color, as defined by the corresponding structure.

These functions transform the color components (of a pixel) expressed in some color system to the corresponding components in another system. These functions take into account the current ERgbStandard and the associated white point if necessary.

◆ RgbToXyz() [2/2]

void eVision.EasyColor.RgbToXyz ( eVision.ERGB colorIn,
out eVision.EXYZ colorOut )
static

Convert a color from RGB to another system.

Parameters
colorInInput color.
colorOutOutput color, as defined by the corresponding structure.

These functions transform the color components (of a pixel) expressed in some color system to the corresponding components in another system. These functions take into account the current ERgbStandard and the associated white point if necessary.

◆ RgbToYCbCr() [1/2]

void eVision.EasyColor.RgbToYCbCr ( eVision.EC24 colorIn,
out eVision.EC24 colorOut )
static

Convert a color from RGB to another system.

Parameters
colorInInput color.
colorOutOutput color, as defined by the corresponding structure.

These functions transform the color components (of a pixel) expressed in some color system to the corresponding components in another system. These functions take into account the current ERgbStandard and the associated white point if necessary.

◆ RgbToYCbCr() [2/2]

void eVision.EasyColor.RgbToYCbCr ( eVision.ERGB colorIn,
out eVision.EYCbCr colorOut )
static

Convert a color from RGB to another system.

Parameters
colorInInput color.
colorOutOutput color, as defined by the corresponding structure.

These functions transform the color components (of a pixel) expressed in some color system to the corresponding components in another system. These functions take into account the current ERgbStandard and the associated white point if necessary.

◆ RgbToYiq() [1/2]

void eVision.EasyColor.RgbToYiq ( eVision.EC24 colorIn,
out eVision.EC24 colorOut )
static

Convert a color from RGB to another system.

Parameters
colorInInput color.
colorOutOutput color, as defined by the corresponding structure.

These functions transform the color components (of a pixel) expressed in some color system to the corresponding components in another system. These functions take into account the current ERgbStandard and the associated white point if necessary.

◆ RgbToYiq() [2/2]

void eVision.EasyColor.RgbToYiq ( eVision.ERGB colorIn,
out eVision.EYIQ colorOut )
static

Convert a color from RGB to another system.

Parameters
colorInInput color.
colorOutOutput color, as defined by the corresponding structure.

These functions transform the color components (of a pixel) expressed in some color system to the corresponding components in another system. These functions take into account the current ERgbStandard and the associated white point if necessary.

◆ RgbToYsh() [1/2]

void eVision.EasyColor.RgbToYsh ( eVision.EC24 colorIn,
out eVision.EC24 colorOut )
static

Convert a color from RGB to another system.

Parameters
colorInInput color.
colorOutOutput color, as defined by the corresponding structure.

These functions transform the color components (of a pixel) expressed in some color system to the corresponding components in another system. These functions take into account the current ERgbStandard and the associated white point if necessary.

◆ RgbToYsh() [2/2]

void eVision.EasyColor.RgbToYsh ( eVision.ERGB colorIn,
out eVision.EYSH colorOut )
static

Convert a color from RGB to another system.

Parameters
colorInInput color.
colorOutOutput color, as defined by the corresponding structure.

These functions transform the color components (of a pixel) expressed in some color system to the corresponding components in another system. These functions take into account the current ERgbStandard and the associated white point if necessary.

◆ RgbToYuv() [1/2]

void eVision.EasyColor.RgbToYuv ( eVision.EC24 colorIn,
out eVision.EC24 colorOut )
static

Convert a color from RGB to another system.

Parameters
colorInInput color.
colorOutOutput color, as defined by the corresponding structure.

These functions transform the color components (of a pixel) expressed in some color system to the corresponding components in another system. These functions take into account the current ERgbStandard and the associated white point if necessary.

◆ RgbToYuv() [2/2]

void eVision.EasyColor.RgbToYuv ( eVision.ERGB colorIn,
out eVision.EYUV colorOut )
static

Convert a color from RGB to another system.

Parameters
colorInInput color.
colorOutOutput color, as defined by the corresponding structure.

These functions transform the color components (of a pixel) expressed in some color system to the corresponding components in another system. These functions take into account the current ERgbStandard and the associated white point if necessary.

◆ SetComponent() [1/2]

void eVision.EasyColor.SetComponent ( eVision.EROIBW16 bWSourceImage,
eVision.EROIC48 colorDestinationImage,
uint component )
static

Sets a color plane of a color image by using a gray-level image as component.

Parameters
bWSourceImagePointers to the input gray level component image/ROI.
colorDestinationImagePointer to the output color image/ROI.
componentColor component index (0, 1, or 2).

A color image can be seen as a set of three color planes, each corresponding to a color component. The color planes are themselves continuous tone images. An EImageC24 contains three EImageBW8.

◆ SetComponent() [2/2]

void eVision.EasyColor.SetComponent ( eVision.EROIBW8 bWSourceImage,
eVision.EROIC24 colorDestinationImage,
uint component )
static

Sets a color plane of a color image by using a gray-level image as component.

Parameters
bWSourceImagePointers to the input gray level component image/ROI.
colorDestinationImagePointer to the output color image/ROI.
componentColor component index (0, 1, or 2).

A color image can be seen as a set of three color planes, each corresponding to a color component. The color planes are themselves continuous tone images. An EImageC24 contains three EImageBW8.

◆ Transform()

void eVision.EasyColor.Transform ( eVision.EROIC24 sourceImage,
eVision.EROIC24 destinationImage,
eVision.EColorLookup lookup )
static

Applies a color transformation to a specified image.

Parameters
sourceImagePointer to the source image/ROI.
destinationImagePointer to the destination image/ROI.
lookupPointer to the color lookup.

In the first case, the transformation is defined by a color lookup. See Initialization (EColorLookup). In the two other cases, the user defines a quantized or unquantized color transformation. No intermediate color lookup table is used.

A color image can be seen as a set of three color planes, each corresponding to a color component. The color planes are themselves continuous tone images. An EImageC24 contains three EImageBW8.

◆ TransformBayer() [1/4]

void eVision.EasyColor.TransformBayer ( eVision.EROIBW8 sourceImage,
eVision.EROIBW8 destinationImage,
eVision.EColorLookup lookup )
static

Converts an image, using the transformation defined by a color lookup.

Parameters
sourceImagePointer to the source image/ROI. This image must be encoded using the Bayer color pattern.
destinationImagePointer to the destination image/ROI. This image must be encoded using the Bayer color pattern.
lookupPointer to the color lookup table holding the color adjustment transform. The lookup table must be previously set up by EColorLookup.WhiteBalance method (no other transforms are supported).

By contrast with EasyColor.Transform, the transformation is applied directly to Bayer-encoded data. This allows efficient processing to take place before conversion to the C24 format.

Deprecated

Use the overload taking an EBayerConfiguration instead.

Deprecated in version 23.12. Scheduled to be removed in version 27.6.

◆ TransformBayer() [2/4]

void eVision.EasyColor.TransformBayer ( eVision.EROIBW8 sourceImage,
eVision.EROIBW8 destinationImage,
eVision.EColorLookup lookup,
bool evenCol )
static

Converts an image, using the transformation defined by a color lookup.

Parameters
sourceImagePointer to the source image/ROI. This image must be encoded using the Bayer color pattern.
destinationImagePointer to the destination image/ROI. This image must be encoded using the Bayer color pattern.
lookupPointer to the color lookup table holding the color adjustment transform. The lookup table must be previously set up by EColorLookup.WhiteBalance method (no other transforms are supported).
evenColtrue if the leftmost destination image column can't contain blue pixels.

By contrast with EasyColor.Transform, the transformation is applied directly to Bayer-encoded data. This allows efficient processing to take place before conversion to the C24 format.

Deprecated

Use the overload taking an EBayerConfiguration instead.

Deprecated in version 23.12. Scheduled to be removed in version 27.6.

◆ TransformBayer() [3/4]

void eVision.EasyColor.TransformBayer ( eVision.EROIBW8 sourceImage,
eVision.EROIBW8 destinationImage,
eVision.EColorLookup lookup,
bool evenCol,
bool evenRow )
static

Converts an image, using the transformation defined by a color lookup.

Parameters
sourceImagePointer to the source image/ROI. This image must be encoded using the Bayer color pattern.
destinationImagePointer to the destination image/ROI. This image must be encoded using the Bayer color pattern.
lookupPointer to the color lookup table holding the color adjustment transform. The lookup table must be previously set up by EColorLookup.WhiteBalance method (no other transforms are supported).
evenColtrue if the leftmost destination image column can't contain blue pixels.
evenRowtrue if the topmost destination image row can't contain red pixels.

By contrast with EasyColor.Transform, the transformation is applied directly to Bayer-encoded data. This allows efficient processing to take place before conversion to the C24 format.

Deprecated

Use the overload taking an EBayerConfiguration instead.

Deprecated in version 23.12. Scheduled to be removed in version 27.6.

◆ TransformBayer() [4/4]

void eVision.EasyColor.TransformBayer ( eVision.EROIBW8 sourceImage,
eVision.EROIBW8 destinationImage,
eVision.EColorLookup lookup,
eVision.EBayerConfiguration bayerConfiguration )
static

Converts an image, using the transformation defined by a color lookup.

Parameters
sourceImagePointer to the source image/ROI. This image must be encoded using the Bayer color pattern.
destinationImagePointer to the destination image/ROI. This image must be encoded using the Bayer color pattern.
lookupPointer to the color lookup table holding the color adjustment transform. The lookup table must be previously set up by EColorLookup.WhiteBalance method (no other transforms are supported).
bayerConfigurationThe color configuration of the bayer image. The color configuration is defined by the component of the first 2 pixels of the image, see EBayerConfiguration.

By contrast with EasyColor.Transform, the transformation is applied directly to Bayer-encoded data. This allows efficient processing to take place before conversion to the C24 format.

◆ VshToRgb() [1/2]

void eVision.EasyColor.VshToRgb ( eVision.EC24 colorIn,
out eVision.EC24 colorOut )
static

Convert a color from any system to RGB.

Parameters
colorInInput color.
colorOutOutput color.

These functions transform the color components (of a pixel) expressed in some color system to the corresponding components in another system. These functions take into account the current ERgbStandard and the associated white point if necessary.

◆ VshToRgb() [2/2]

void eVision.EasyColor.VshToRgb ( eVision.EVSH colorIn,
out eVision.ERGB colorOut )
static

Convert a color from any system to RGB.

Parameters
colorInInput color.
colorOutOutput color.

These functions transform the color components (of a pixel) expressed in some color system to the corresponding components in another system. These functions take into account the current ERgbStandard and the associated white point if necessary.

◆ XyzToLab() [1/2]

void eVision.EasyColor.XyzToLab ( eVision.EC24 colorIn,
out eVision.EC24 colorOut )
static

Convert a color from one system to another.

Parameters
colorInInput color.
colorOutOutput color.

These functions transform the color components (of a pixel) expressed in some color system to the corresponding components in another system. These functions take into account the current ERgbStandard and the associated white point if necessary.

◆ XyzToLab() [2/2]

void eVision.EasyColor.XyzToLab ( eVision.EXYZ colorIn,
out eVision.ELAB colorOut )
static

Convert a color from one system to another.

Parameters
colorInInput color.
colorOutOutput color.

These functions transform the color components (of a pixel) expressed in some color system to the corresponding components in another system. These functions take into account the current ERgbStandard and the associated white point if necessary.

◆ XyzToLuv() [1/2]

void eVision.EasyColor.XyzToLuv ( eVision.EC24 colorIn,
out eVision.EC24 colorOut )
static

Convert a color from one system to another.

Parameters
colorInInput color.
colorOutOutput color.

These functions transform the color components (of a pixel) expressed in some color system to the corresponding components in another system. These functions take into account the current ERgbStandard and the associated white point if necessary.

◆ XyzToLuv() [2/2]

void eVision.EasyColor.XyzToLuv ( eVision.EXYZ colorIn,
out eVision.ELUV colorOut )
static

Convert a color from one system to another.

Parameters
colorInInput color.
colorOutOutput color.

These functions transform the color components (of a pixel) expressed in some color system to the corresponding components in another system. These functions take into account the current ERgbStandard and the associated white point if necessary.

◆ XyzToRgb() [1/2]

void eVision.EasyColor.XyzToRgb ( eVision.EC24 colorIn,
out eVision.EC24 colorOut )
static

Convert a color from any system to RGB.

Parameters
colorInInput color.
colorOutOutput color.

These functions transform the color components (of a pixel) expressed in some color system to the corresponding components in another system. These functions take into account the current ERgbStandard and the associated white point if necessary.

◆ XyzToRgb() [2/2]

void eVision.EasyColor.XyzToRgb ( eVision.EXYZ colorIn,
out eVision.ERGB colorOut )
static

Convert a color from any system to RGB.

Parameters
colorInInput color.
colorOutOutput color.

These functions transform the color components (of a pixel) expressed in some color system to the corresponding components in another system. These functions take into account the current ERgbStandard and the associated white point if necessary.

◆ YCbCrToRgb() [1/2]

void eVision.EasyColor.YCbCrToRgb ( eVision.EC24 colorIn,
out eVision.EC24 colorOut )
static

Convert a color from any system to RGB.

Parameters
colorInInput color.
colorOutOutput color.

These functions transform the color components (of a pixel) expressed in some color system to the corresponding components in another system. These functions take into account the current ERgbStandard and the associated white point if necessary.

◆ YCbCrToRgb() [2/2]

void eVision.EasyColor.YCbCrToRgb ( eVision.EYCbCr colorIn,
out eVision.ERGB colorOut )
static

Convert a color from any system to RGB.

Parameters
colorInInput color.
colorOutOutput color.

These functions transform the color components (of a pixel) expressed in some color system to the corresponding components in another system. These functions take into account the current ERgbStandard and the associated white point if necessary.

◆ YiqToRgb() [1/2]

void eVision.EasyColor.YiqToRgb ( eVision.EC24 colorIn,
out eVision.EC24 colorOut )
static

Convert a color from any system to RGB.

Parameters
colorInInput color.
colorOutOutput color.

These functions transform the color components (of a pixel) expressed in some color system to the corresponding components in another system. These functions take into account the current ERgbStandard and the associated white point if necessary.

◆ YiqToRgb() [2/2]

void eVision.EasyColor.YiqToRgb ( eVision.EYIQ colorIn,
out eVision.ERGB colorOut )
static

Convert a color from any system to RGB.

Parameters
colorInInput color.
colorOutOutput color.

These functions transform the color components (of a pixel) expressed in some color system to the corresponding components in another system. These functions take into account the current ERgbStandard and the associated white point if necessary.

◆ YshToRgb() [1/2]

void eVision.EasyColor.YshToRgb ( eVision.EC24 colorIn,
out eVision.EC24 colorOut )
static

Convert a color from any system to RGB.

Parameters
colorInInput color.
colorOutOutput color.

These functions transform the color components (of a pixel) expressed in some color system to the corresponding components in another system. These functions take into account the current ERgbStandard and the associated white point if necessary.

◆ YshToRgb() [2/2]

void eVision.EasyColor.YshToRgb ( eVision.EYSH colorIn,
out eVision.ERGB colorOut )
static

Convert a color from any system to RGB.

Parameters
colorInInput color.
colorOutOutput color.

These functions transform the color components (of a pixel) expressed in some color system to the corresponding components in another system. These functions take into account the current ERgbStandard and the associated white point if necessary.

◆ YuvToRgb() [1/2]

void eVision.EasyColor.YuvToRgb ( eVision.EC24 colorIn,
out eVision.EC24 colorOut )
static

Convert a color from any system to RGB.

Parameters
colorInInput color.
colorOutOutput color.

These functions transform the color components (of a pixel) expressed in some color system to the corresponding components in another system. These functions take into account the current ERgbStandard and the associated white point if necessary.

◆ YuvToRgb() [2/2]

void eVision.EasyColor.YuvToRgb ( eVision.EYUV colorIn,
out eVision.ERGB colorOut )
static

Convert a color from any system to RGB.

Parameters
colorInInput color.
colorOutOutput color.

These functions transform the color components (of a pixel) expressed in some color system to the corresponding components in another system. These functions take into account the current ERgbStandard and the associated white point if necessary.

Property Documentation

◆ CieAB

float eVision.EasyColor.CieAB
staticget

CIE AB white illuminant.

◆ CieAG

float eVision.EasyColor.CieAG
staticget

CIE AG white illuminant.

◆ CieAR

float eVision.EasyColor.CieAR
staticget

CIE AR white illuminant.

◆ CieD50B

float eVision.EasyColor.CieD50B
staticget

CIE D50B white illuminant.

◆ CieD50G

float eVision.EasyColor.CieD50G
staticget

CIE D50G white illuminant.

◆ CieD50R

float eVision.EasyColor.CieD50R
staticget

CIE D50R white illuminant.

◆ CieD55B

float eVision.EasyColor.CieD55B
staticget

CIE D55B white illuminant.

◆ CieD55G

float eVision.EasyColor.CieD55G
staticget

CIE D55G white illuminant.

◆ CieD55R

float eVision.EasyColor.CieD55R
staticget

CIE D55R white illuminant.

◆ CieD65B

float eVision.EasyColor.CieD65B
staticget

CIE D65B white illuminant.

◆ CieD65G

float eVision.EasyColor.CieD65G
staticget

CIE D65G white illuminant.

◆ CieD65R

float eVision.EasyColor.CieD65R
staticget

CIE D65R white illuminant.

◆ CieFB

float eVision.EasyColor.CieFB
staticget

CIE FB white illuminant.

◆ CieFG

float eVision.EasyColor.CieFG
staticget

CIE FG white illuminant.

◆ CieFR

float eVision.EasyColor.CieFR
staticget

CIE FR white illuminant.

◆ CompensateNtscGamma

float eVision.EasyColor.CompensateNtscGamma
staticget

NTSC inverse gamma exponent.

◆ CompensatePalGamma

float eVision.EasyColor.CompensatePalGamma
staticget

PAL inverse gamma exponent.

◆ CompensateSmpteGamma

float eVision.EasyColor.CompensateSmpteGamma
staticget

NTSC inverse gamma exponent.

◆ DstQuantization

eVision.EColorQuantization eVision.EasyColor.DstQuantization
staticgetset

Quantization mode for output values.

These settings remain permanent and influence the relevant quantized and unquantized color conversions (during lookup table initialization or image color transformation). Quantization modes are set for the current thread.

◆ NtscGamma

float eVision.EasyColor.NtscGamma
staticget

NTSC gamma exponent.

◆ PalGamma

float eVision.EasyColor.PalGamma
staticget

PAL gamma exponent.

◆ RgbStandard

eVision.ERgbStandard eVision.EasyColor.RgbStandard
staticgetset

RGB definition to be used when converting between RGB and other color systems.

Some variant of the color systems can be used. The EasyColor.SrcQuantization and EasyColor.DstQuantization functions are used to activate them.

These settings remain permanent and influence the relevant quantized and unquantized color conversions (during lookup table initialization or image color transformation). RgbStandard is set for the current thread.

◆ SmpteGamma

float eVision.EasyColor.SmpteGamma
staticget

SMPTE gamma exponent.

◆ SrcQuantization

eVision.EColorQuantization eVision.EasyColor.SrcQuantization
staticgetset

Quantization mode for input values.

These settings remain permanent and influence the relevant quantized and unquantized color conversions (during lookup table initialization or image color transformation). Quantization modes are set for the current thread.