com.day.image

Class MultitoneOp

java.lang.Object

com.day.image.AbstractBufferedImageOp

com.day.image.MultitoneOp

All Implemented Interfaces:

java.awt.image.BufferedImageOp

public class MultitoneOp
extends AbstractBufferedImageOp

The MultitoneOp class implements similar functionality as the Photoshop Duplex function. It allows to specify one or more colors and tonality curves for each color.

The filter(java.awt.image.BufferedImage, java.awt.image.BufferedImage) method expects to get a grayscale image to which the colorization operation is applied.

Since:

echidna

Constructor Summary

Constructors

Constructor and Description
MultitoneOp(java.awt.Color[] colors, java.awt.RenderingHints hints) Creates a MultitoneOp containing a standard color curve with more than one color.
MultitoneOp(ColorCurve[] colorCurves, java.awt.RenderingHints hints) Creates a MultitoneOp from the given ColorCurve objects.
MultitoneOp(java.awt.Color color, java.awt.RenderingHints hints) Creates a MultitoneOp containing a standard color curve with the single color.

Method Summary

Modifier and Type	Method and Description
java.awt.image.BufferedImage	filter(java.awt.image.BufferedImage src, java.awt.image.BufferedImage dst) Performs the multi tone operation.

Methods inherited from class com.day.image.AbstractBufferedImageOp

createCompatibleDestImage, getBounds2D, getPoint2D, getRenderingHints

Methods inherited from class java.lang.Object

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

Constructor Detail

MultitoneOp

public MultitoneOp(java.awt.Color color,
                   java.awt.RenderingHints hints)

Creates a MultitoneOp containing a standard color curve with the single color. This creates a monotone result. This is a convenience constructor which is the same as calling MultitoneOp(Color[], RenderingHints) with an array containing the single color directly.

Parameters:

color - The color to use in the operation

hints - the specified RenderingHints, or null

MultitoneOp

public MultitoneOp(java.awt.Color[] colors,
                   java.awt.RenderingHints hints)

Creates a MultitoneOp containing a standard color curve with more than one color. This creates a monotone result, where the color is a mixture of the input colors.

Parameters:

colors - The colors to use in the operation

hints - the specified RenderingHints, or null

Throws:

java.lang.NullPointerException - if the colors array is null or if any of the color values is null.

MultitoneOp

public MultitoneOp(ColorCurve[] colorCurves,
                   java.awt.RenderingHints hints)

Creates a MultitoneOp from the given ColorCurve objects.

Parameters:

colorCurves - The ColorCurve objects from which to create this MultitoneOp

hints - the specified RenderingHints, or null

Throws:

java.lang.NullPointerException - if the colorCurves parameter or any of the entries is null.

Method Detail

filter

public java.awt.image.BufferedImage filter(java.awt.image.BufferedImage src,
                                           java.awt.image.BufferedImage dst)

Performs the multi tone operation. Note that the source image is expected to be a gray scale image and the destination image must support color images.

Note: This class supports filtering within an image, that is, calling this method with src == dst is legal.

Specified by:

filter in interface java.awt.image.BufferedImageOp

Overrides:

filter in class AbstractBufferedImageOp

Parameters:

src - The src image to be filtered.

dst - The dest image into which to place the resized image. This may be null in which case a new image with the correct size will be created.

Returns:

The newly created image (if dest was null) or dest into which the resized src image has been drawn.

Throws:

java.lang.NullPointerException - if the src image is null.