com.sun.prism.j2d.paint

Class MultipleGradientPaint

java.lang.Object

com.sun.prism.j2d.paint.MultipleGradientPaint

All Implemented Interfaces:

java.awt.Paint, java.awt.Transparency

Direct Known Subclasses:

RadialGradientPaint

public abstract class MultipleGradientPaint
extends java.lang.Object
implements java.awt.Paint

This is the superclass for Paints which use a multiple color gradient to fill in their raster. It provides storage for variables and enumerated values common to LinearGradientPaint and RadialGradientPaint.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	MultipleGradientPaint.ColorSpaceType The color space in which to perform the gradient interpolation.
static class	MultipleGradientPaint.CycleMethod The method to use when painting outside the gradient bounds.

Field Summary

Fields

Modifier and Type	Field and Description
(package private) java.awt.Color[]	colors Gradient colors.
(package private) MultipleGradientPaint.ColorSpaceType	colorSpace The color space in which to perform the gradient interpolation.
(package private) MultipleGradientPaint.CycleMethod	cycleMethod The method to use when painting outside the gradient bounds.
(package private) int	fastGradientArraySize
(package private) float[]	fractions Gradient keyframe values in the range 0 to 1.
(package private) java.lang.ref.SoftReference<int[]>	gradient
(package private) java.lang.ref.SoftReference<int[][]>	gradients
(package private) java.awt.geom.AffineTransform	gradientTransform Transform to apply to gradient.
(package private) boolean	isSimpleLookup
(package private) java.awt.image.ColorModel	model The following fields are used only by MultipleGradientPaintContext to cache certain values that remain constant and do not need to be recalculated for each context created from this paint instance.
(package private) float[]	normalizedIntervals
(package private) int	transparency The transparency of this paint object.

Fields inherited from interface java.awt.Transparency

BITMASK, OPAQUE, TRANSLUCENT

Constructor Summary

Constructors

Constructor and Description
MultipleGradientPaint(float[] fractions, java.awt.Color[] colors, MultipleGradientPaint.CycleMethod cycleMethod, MultipleGradientPaint.ColorSpaceType colorSpace, java.awt.geom.AffineTransform gradientTransform) Package-private constructor.

Method Summary

Modifier and Type	Method and Description
java.awt.Color[]	getColors() Returns a copy of the array of colors used by this gradient.
MultipleGradientPaint.ColorSpaceType	getColorSpace() Returns the enumerated type which specifies color space for interpolation.
MultipleGradientPaint.CycleMethod	getCycleMethod() Returns the enumerated type which specifies cycling behavior.
float[]	getFractions() Returns a copy of the array of floats used by this gradient to calculate color distribution.
java.awt.geom.AffineTransform	getTransform() Returns a copy of the transform applied to the gradient.
int	getTransparency() Returns the transparency mode for this Paint object.

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.awt.Paint

createContext

Field Detail

transparency

final int transparency

The transparency of this paint object.

fractions

final float[] fractions

Gradient keyframe values in the range 0 to 1.

colors

final java.awt.Color[] colors

Gradient colors.

gradientTransform

final java.awt.geom.AffineTransform gradientTransform

Transform to apply to gradient.

cycleMethod

final MultipleGradientPaint.CycleMethod cycleMethod

The method to use when painting outside the gradient bounds.

colorSpace

final MultipleGradientPaint.ColorSpaceType colorSpace

The color space in which to perform the gradient interpolation.

model

java.awt.image.ColorModel model

The following fields are used only by MultipleGradientPaintContext to cache certain values that remain constant and do not need to be recalculated for each context created from this paint instance.

normalizedIntervals

float[] normalizedIntervals

isSimpleLookup

boolean isSimpleLookup

gradients

java.lang.ref.SoftReference<int[][]> gradients

gradient

java.lang.ref.SoftReference<int[]> gradient

fastGradientArraySize

int fastGradientArraySize

Constructor Detail

MultipleGradientPaint

MultipleGradientPaint(float[] fractions,
                      java.awt.Color[] colors,
                      MultipleGradientPaint.CycleMethod cycleMethod,
                      MultipleGradientPaint.ColorSpaceType colorSpace,
                      java.awt.geom.AffineTransform gradientTransform)

Package-private constructor.

Parameters:

fractions - numbers ranging from 0.0 to 1.0 specifying the distribution of colors along the gradient

colors - array of colors corresponding to each fractional value

cycleMethod - either NO_CYCLE, REFLECT, or REPEAT

colorSpace - which color space to use for interpolation, either SRGB or LINEAR_RGB

gradientTransform - transform to apply to the gradient

Throws:

java.lang.NullPointerException - if fractions array is null, or colors array is null, or gradientTransform is null, or cycleMethod is null, or colorSpace is null

java.lang.IllegalArgumentException - if fractions.length != colors.length, or colors is less than 2 in size, or a fractions value is less than 0.0 or greater than 1.0, or the fractions are not provided in strictly increasing order

Method Detail

getFractions

public final float[] getFractions()

Returns a copy of the array of floats used by this gradient to calculate color distribution. The returned array always has 0 as its first value and 1 as its last value, with increasing values in between.

Returns:

a copy of the array of floats used by this gradient to calculate color distribution

getColors

public final java.awt.Color[] getColors()

Returns a copy of the array of colors used by this gradient. The first color maps to the first value in the fractions array, and the last color maps to the last value in the fractions array.

Returns:

a copy of the array of colors used by this gradient

getCycleMethod

public final MultipleGradientPaint.CycleMethod getCycleMethod()

Returns the enumerated type which specifies cycling behavior.

Returns:

the enumerated type which specifies cycling behavior

getColorSpace

public final MultipleGradientPaint.ColorSpaceType getColorSpace()

Returns the enumerated type which specifies color space for interpolation.

Returns:

the enumerated type which specifies color space for interpolation

getTransform

public final java.awt.geom.AffineTransform getTransform()

Returns a copy of the transform applied to the gradient.

Returns:

a copy of the transform applied to the gradient

getTransparency

public final int getTransparency()

Returns the transparency mode for this Paint object.

Specified by:

getTransparency in interface java.awt.Transparency

Returns:

an integer value representing the transparency mode for this Paint object

See Also:

Transparency