SoColorSpaceConversionProcessing Class Reference
[Color Transforms]

SoColorSpaceConversionProcessing engine More...

#include <ImageViz/Engines/ImageFiltering/ColorTransforms/SoColorSpaceConversionProcessing.h>

Inheritance diagram for SoColorSpaceConversionProcessing:

Public Types
enum	BaseMode { RGB = 0, HLS = 1 }
Public Member Functions
	SoColorSpaceConversionProcessing ()
Public Attributes
SoSFEnum	computeMode
SoSFImageDataAdapter	inColorImage
SoSFEnum	baseMode
SoImageVizEngineOutput < SoSFImageDataAdapter, SoImageDataAdapter * >	outColorImage

Detailed Description

SoColorSpaceConversionProcessing engine

For an introduction to color transforms, see section Color Transforms.

The SoColorSpaceConversionProcessing engine performs conversion between two color image formats or bases. You may choose between RGB and HLS.

RGB to HLS Conversion

$C_1=\frac{\sqrt{3}}{2}\times (R-G) ~\mbox{and}~ C_2=B-\frac{1}{2}\times (R+G)$

the HLS components are:

Intensity component:
$L=\frac{R+G+B}{3}$
Chromatic components:
$S=\sqrt{C_1^2+C_2^2}$
S is equal to 0 for grey level images (R = G = B) and is maximum for a fully saturated color.
$H=\left\{\begin{array}{2l} acos \frac{C_1}{S} & \mbox {if $C_2\geq0$} \\ & \\ 2\pi-acos \frac{C_1}{S} & \mbox{if $C_2<0$} \end{array}\right.$

The H value varies from 0 to $2\pi$ as it goes from red ( $H = 0$ ) through green ( $H = 2\pi/3$ ) and blue ( $H = 4\pi/3$ ) and back to red.

Hue is converted from radians to a value between 0-255 and is not defined if the saturation is equal to 0.

Please note that an image cannot be transformed into a color space which it already belongs to. By default ImageViz considers color images belonging to RGB color space. Thus converting a color image to the RGB space without having performed a conversion to HLS before will raise an exception "Input image type must be different from output type !" .

FILE FORMAT/DEFAULT

computeMode	MODE_AUTO
inColorImage	NULL
baseMode	HLS

Library references: colorbase

Member Enumeration Documentation

enum SoColorSpaceConversionProcessing::BaseMode

Enumerator:

RGB
HLS

Constructor & Destructor Documentation

SoColorSpaceConversionProcessing::SoColorSpaceConversionProcessing ( )

Constructor.

Member Data Documentation

SoSFEnum SoColorSpaceConversionProcessing::baseMode

Select the output color space.

Use enum BaseMode. Default is HLS

SoSFEnum SoColorSpaceConversionProcessing::computeMode

Select the compute Mode (2D or 3D or AUTO) Use enum ComputeMode.

Default is MODE_AUTO

SoSFImageDataAdapter SoColorSpaceConversionProcessing::inColorImage

The input color image.

Default value is NULL. Supported types include: color image.

SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter*> SoColorSpaceConversionProcessing::outColorImage

The output color image.

Default value is NULL. Supported types include: grayscale binary label color image.

The documentation for this class was generated from the following file:

ImageViz/Engines/ImageFiltering/ColorTransforms/SoColorSpaceConversionProcessing.h

SoColorSpaceConversionProcessing Class Reference [Color Transforms]

Public Types

Public Member Functions