de.unihalle.informatik.MiToBo.morphology

Class ImgDilate

java.lang.Object

de.unihalle.informatik.Alida.operator.ALDOperator

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

de.unihalle.informatik.MiToBo.morphology.ImgDilate

All Implemented Interfaces:

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

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

This class implements morphological dilation on 2D binary/grayscale images.

If the given image only contains two pixel values it is interpreted as binary image. In the resulting image the background pixels will be set to the smaller value, while the foreground pixels will be set to the larger ones.

The structuring element is a square matrix of size 'masksize' x 'masksize', with reference pixel in the center of the matrix. Attention: if masksize is even, errors may result due to lack of operator symmetry

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
private MTBImage	inImg
private int	masksize
private MTBImage	resultImg

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

completeDAG, name, operatorExecutionEventlistenerList, portHashAccess, verbose, versionProvider

Constructor Summary

Constructors

Constructor and Description
ImgDilate() Default constructor.
ImgDilate(MTBImage inimg, int ms) Constructor.

Method Summary

Modifier and Type	Method and Description
private MTBImage	applyMask(MTBImage mImg, int msize) Invokes dilation.
private MTBImage	applyMaskBinary(MTBImage img, int msize, int minVal, int maxVal) Applies a dilation mask to the given binary image.
private MTBImage	applyMaskGray(MTBImage mImg, int msize) Applies a dilation mask to the given intensity image.
MTBImage	getInputImage() Get value of inImg.
int	getMasksize() Get value of masksize.
MTBImage	getResultImage() Get value of resultImg.
protected void	operate() This method does the actual work.
void	setResultImage(MTBImage value) Set value of resultImg.

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, validateCustom, validateGeneric, writeHistory, writeHistory, writeHistory

Methods inherited from class java.lang.Object

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

Field Detail

masksize

@Parameter(label="Masksize",
           required=true,
           dataIOOrder=1,
           direction=IN,
           description="Masksize")
private int masksize

inImg

@Parameter(label="Input Image",
           required=true,
           dataIOOrder=0,
           direction=IN,
           description="Input image")
private transient MTBImage inImg

resultImg

@Parameter(label="Result Image",
           required=true,
           direction=OUT,
           description="Result image")
private transient MTBImage resultImg

Constructor Detail

ImgDilate

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

Default constructor.

Throws:

de.unihalle.informatik.Alida.exceptions.ALDOperatorException

ImgDilate

public ImgDilate(MTBImage inimg,
                 int ms)
          throws de.unihalle.informatik.Alida.exceptions.ALDOperatorException

Constructor.

Parameters:

inimg - Input image.

ms - Size of square mask.

Throws:

de.unihalle.informatik.Alida.exceptions.ALDOperatorException

Method Detail

getMasksize

public int getMasksize()

Get value of masksize. Explanation: Masksize.

Returns:

value of masksize

getInputImage

public MTBImage getInputImage()

Get value of inImg. Explanation: Input image.

Returns:

value of inImg

getResultImage

public MTBImage getResultImage()

Get value of resultImg. Explanation: Result image.

Returns:

value of resultImg

setResultImage

public void setResultImage(MTBImage value)

Set value of resultImg. Explanation: Result image.

Parameters:

value - New value of resultImg

operate

protected void operate()

This method does the actual work.

Specified by:

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

applyMask

private MTBImage applyMask(MTBImage mImg,
                           int msize)

Invokes dilation.

The method first checks if image is binary or not. Subsequently the corresponding dilation function is called.

Parameters:

mImg - Input image.

msize - Size of square mask.

Returns:

Dilated image.

applyMaskBinary

private MTBImage applyMaskBinary(MTBImage img,
                                 int msize,
                                 int minVal,
                                 int maxVal)

Applies a dilation mask to the given binary image. Pixels with larger gray value are assumed to belong to the foreground while pixels with smaller intensities are handled as background pixels.

Parameters:

ip - Input image for dilation.

msize - Size of squared dilation mask.

minVal - Minimal intensity in image.

maxVal - Maximal intensity in image.

Returns:

Dilated result image.

applyMaskGray

private MTBImage applyMaskGray(MTBImage mImg,
                               int msize)

Applies a dilation mask to the given intensity image.

Parameters:

ip - Input image for dilation.

msize - Size of squared dilation mask.

Returns:

Dilated result image.