de.unihalle.informatik.MiToBo.color.conversion

Class HSIToRGBPixelConverter

java.lang.Object

de.unihalle.informatik.Alida.operator.ALDOperator

de.unihalle.informatik.MiToBo.core.operator.MTBOperator

de.unihalle.informatik.MiToBo.color.conversion.HSIToRGBPixelConverter

All Implemented Interfaces:

de.unihalle.informatik.Alida.datatypes.ALDConfigurationValidator, de.unihalle.informatik.Alida.operator.events.ALDOperatorExecutionProgressEventListener, EventListener

@ALDAOperator(genericExecutionMode=ALL,
              level=APPLICATION)
public class HSIToRGBPixelConverter
extends MTBOperator

Operator to convert a single HSI value to RGB.

In comparison to the HSV color space here in the HSI space hue, saturation and intensity are not completely decoupled, i.e. changes in one of the components may also influence others.
This operator expects all three value H, S and I to be normalized to a range of [0,1]. The returned values for R, G and B are also each normalized to a range of [0,1]. The implementation is based on

Gonzalez/Woods, "Digital Image Processing", pp. 235, Addison-Wesley, 1992

Note that if I = 0 the RGB color black is returned, and if I = 1 white. If S = 0 an RGB gray value corresponding to the given intensity is returned. And if the calculation results in RGB values larger than 1, i.e. in values out of range, the values are clipped to a maximum of 1.0.

Author:

moeller

Nested Class Summary

Nested classes/interfaces inherited from class de.unihalle.informatik.Alida.operator.ALDOperator

de.unihalle.informatik.Alida.operator.ALDOperator.HidingMode, de.unihalle.informatik.Alida.operator.ALDOperator.HistoryConstructionMode

Field Summary

Fields

Modifier and Type	Field and Description
protected double[]	hsiInput Input HSI values.
protected double[]	rgbOutput Output RGB values.

Fields inherited from class de.unihalle.informatik.Alida.operator.ALDOperator

completeDAG, name, operatorExecutionEventlistenerList, portHashAccess, verbose, versionProvider

Constructor Summary

Constructors

Constructor and Description
HSIToRGBPixelConverter() Default constructor.
HSIToRGBPixelConverter(double[] hsi) Constructor.

Method Summary

Modifier and Type	Method and Description
double[]	getResultRGB() Returns the result RGB color.
protected void	operate() This method does the actual work.
void	setHSIInput(double[] hsiVal) Specify HSI value to be converted.
void	validateCustom()

Methods inherited from class de.unihalle.informatik.MiToBo.core.operator.MTBOperator

readResolve

Methods inherited from class de.unihalle.informatik.Alida.operator.ALDOperator

addOperatorExecutionProgressEventListener, addParameter, addParameter, addParameterUnconditioned, fieldContained, fireOperatorExecutionProgressEvent, getALDPortHashAccessKey, getConstructionMode, getDocumentation, getHidingMode, getInactiveParameterNames, getInInoutNames, getInInoutNames, getInNames, getInOutNames, getMissingRequiredInputs, getName, getNumParameters, getOutInoutNames, getOutNames, getParameter, getParameterDescriptor, getParameterDescriptorUnconditioned, getParameterNames, getParameterUnconditioned, getSupplementalNames, getVerbose, getVersion, handleOperatorExecutionProgressEvent, hasInOutParameters, hasParameter, isAnnotatedParameter, isConfigured, print, print, print, printInterface, printInterface, readHistory, reinitializeParameterDescriptors, removeOperatorExecutionProgressEventListener, removeParameter, runOp, runOp, runOp, setConstructionMode, setConstructionMode, setConstructionMode, setHidingMode, setName, setParameter, setParameterUnconditioned, setVerbose, toStringVerbose, unconfiguredItems, validate, validateGeneric, writeHistory, writeHistory, writeHistory

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

hsiInput

@Parameter(label="HSI Input",
           required=true,
           dataIOOrder=-1,
           direction=IN,
           description="HSI input values.")
protected double[] hsiInput

Input HSI values.

rgbOutput

@Parameter(label="RGB Output",
           dataIOOrder=-1,
           direction=OUT,
           description="RGB output values.")
protected double[] rgbOutput

Output RGB values.

Constructor Detail

HSIToRGBPixelConverter

public HSIToRGBPixelConverter()
                       throws de.unihalle.informatik.Alida.exceptions.ALDOperatorException

Default constructor.

Throws:

de.unihalle.informatik.Alida.exceptions.ALDOperatorException - Thrown in case of failure.

HSIToRGBPixelConverter

public HSIToRGBPixelConverter(double[] hsi)
                       throws de.unihalle.informatik.Alida.exceptions.ALDOperatorException

Constructor.

Parameters:

hsi - HSI value to convert.

Throws:

de.unihalle.informatik.Alida.exceptions.ALDOperatorException - Thrown in case of failure.

Method Detail

validateCustom

public void validateCustom()
                    throws de.unihalle.informatik.Alida.exceptions.ALDOperatorException

Overrides:

validateCustom in class de.unihalle.informatik.Alida.operator.ALDOperator

Throws:

de.unihalle.informatik.Alida.exceptions.ALDOperatorException

setHSIInput

public void setHSIInput(double[] hsiVal)

Specify HSI value to be converted.

Parameters:

hsiVal - HSI value.

getResultRGB

public double[] getResultRGB()

Returns the result RGB color.

Returns:

Result array of RGB values.

operate

protected void operate()

This method does the actual work.

Specified by:

operate in class de.unihalle.informatik.Alida.operator.ALDOperator