ilog.views.util.java2d

Class IlvRadialGradientPaint

java.lang.Object

ilog.views.util.java2d.IlvMultipleGradientPaint

ilog.views.util.java2d.IlvRadialGradientPaint

All Implemented Interfaces:

IlvAdaptablePaint, IlvMultipleGradientPaintConstants, Paint, Transparency, Serializable

Direct Known Subclasses:

IlvRadialGradientPaint

public class IlvRadialGradientPaint
extends IlvMultipleGradientPaint

This class defines a multiple radial color gradient paint that will be used to fill Java 2 Shape objects.

You can, for example, set it on an IlvGeneralPath to fill it.

The user must provide an array of floats in an increasing order specifying how to distribute the colors along the gradient. These values should range from 0.0 to 1.0 and act like keyframes along the gradient (they mark where the gradient should be exactly a particular color).

In the event that the user does not set the first keyframe value equal to 0 and the last keyframe value equal to 1, keyframes will be created at these positions, and the first and last colors will be replicated there.

This paint will map the first color of the gradient to a focal point within the circle and the last color to the perimeter of the circle, interpolating smoothly for any in-between colors specified by the user. Any line drawn from the focal point to the circumference will span all the gradient colors. By default, the focus is set to be the center of the circle.

Specifying a focal point outside of the circle's radius will result in the focus being set to the intersection point of the focus-center line and the perimeter of the circle.

The user may also select what action the IlvRadialGradientPaint should take when filling color outside the start and end points. If no spread method is specified, SPREAD_PAD will be chosen by default, so the endpoint colors will be used to fill the remaining area.

Here is a sample drawing produced by a radial gradient:

Since:

JViews 5.5

See Also:

Serialized Form

Field Summary

Fields inherited from interface ilog.views.util.java2d.IlvAdaptablePaint

KEY_USER_BOUNDS

Fields inherited from interface java.awt.Transparency

BITMASK, OPAQUE, TRANSLUCENT

Fields inherited from interface ilog.views.util.java2d.IlvMultipleGradientPaintConstants

LINEAR_RGB, SPREAD_PAD, SPREAD_REFLECT, SPREAD_REPEAT, SRGB

Constructor Summary

Constructors

Constructor and Description
IlvRadialGradientPaint(double cx, double cy, double radius, float[] stops, Color[] colors, boolean adapting) Builds a circular IlvRadialGradientPaint instance.
IlvRadialGradientPaint(double cx, double cy, double radius, float[] stops, Color[] colors, double fx, double fy, boolean adapting) Builds a circular IlvRadialGradientPaint instance.
IlvRadialGradientPaint(double cx, double cy, double radius, float[] stops, Color[] colors, double fx, double fy, short spreadMethod, boolean adapting) Builds a circular IlvRadialGradientPaint instance.
IlvRadialGradientPaint(double cx, double cy, double radius, float[] stops, Color[] colors, short spreadMethod, boolean adapting) Builds a circular IlvRadialGradientPaint instance.
IlvRadialGradientPaint(IlvRadialGradientPaint source) Creates a radial gradient paint by copying an existing one.
IlvRadialGradientPaint(Point2D center, double radius, float[] stops, Color[] colors, boolean adapting) Builds a circular IlvRadialGradientPaint instance.
IlvRadialGradientPaint(Point2D center, double radius, float[] stops, Color[] colors, Point2D focal, boolean adapting) Builds a circular IlvRadialGradientPaint instance.
IlvRadialGradientPaint(Point2D center, double radius, float[] stops, Color[] colors, Point2D focal, short spreadMethod, boolean adapting) Builds a circular IlvRadialGradientPaint instance.
IlvRadialGradientPaint(Point2D center, double radius, float[] stops, Color[] colors, Point2D focal, short spreadMethod, short colorSpace, AffineTransform transform, boolean adapting) Builds a circular IlvRadialGradientPaint instance.
IlvRadialGradientPaint(Point2D center, double radius, float[] stops, Color[] colors, short spreadMethod, boolean adapting) Builds a circular IlvRadialGradientPaint instance.

Method Summary

Modifier and Type	Method and Description
PaintContext	createContext(ColorModel cm, Rectangle deviceBounds, Rectangle2D userBounds, AffineTransform transform, RenderingHints hints) Creates and returns a context used to generate the gradient.
Point2D	getCenter() Returns the gradient center.
Point2D	getFocal() Returns the gradient focus.
double	getRadius() Returns the gradient radius.

Methods inherited from class ilog.views.util.java2d.IlvMultipleGradientPaint

getColors, getColorSpace, getSpreadMethod, getStops, getTransform, getTransparency, initTransparency, isAdapting

Methods inherited from class java.lang.Object

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

Constructor Detail

IlvRadialGradientPaint

public IlvRadialGradientPaint(Point2D center,
                              double radius,
                              float[] stops,
                              Color[] colors,
                              boolean adapting)

Builds a circular IlvRadialGradientPaint instance.

Parameters:

center - The center of the circle.

radius - The radius of the circle.

stops - Array of stops of the gradient.

colors - Array of colors of the gradient.

adapting - true if the gradient should be adapted to the shape on which it is drawn.

IlvRadialGradientPaint

public IlvRadialGradientPaint(Point2D center,
                              double radius,
                              float[] stops,
                              Color[] colors,
                              short spreadMethod,
                              boolean adapting)

Builds a circular IlvRadialGradientPaint instance.

Parameters:

center - The center of the circle.

radius - The radius of the circle.

stops - Array of stops of the gradient.

colors - Array of colors of the gradient.

spreadMethod - How to fill the remainder region.

adapting - true if the gradient should be adapted to the shape on which it is drawn.

Since:

JViews 5.0

See Also:

IlvMultipleGradientPaintConstants.SPREAD_PAD, IlvMultipleGradientPaintConstants.SPREAD_REPEAT, IlvMultipleGradientPaintConstants.SPREAD_REFLECT

IlvRadialGradientPaint

public IlvRadialGradientPaint(double cx,
                              double cy,
                              double radius,
                              float[] stops,
                              Color[] colors,
                              boolean adapting)

Builds a circular IlvRadialGradientPaint instance.

Parameters:

cx - The x coordinate of the circle center.

cy - The y coordinate of the circle center.

radius - The radius of the circle.

stops - Array of stops of the gradient.

colors - Array of colors of the gradient.

adapting - true if the gradient should be adapted to the shape on which it is drawn.

IlvRadialGradientPaint

public IlvRadialGradientPaint(double cx,
                              double cy,
                              double radius,
                              float[] stops,
                              Color[] colors,
                              short spreadMethod,
                              boolean adapting)

Builds a circular IlvRadialGradientPaint instance.

Parameters:

cx - The x coordinate of the circle center.

cy - The y coordinate of the circle center.

radius - The radius of the circle.

stops - Array of stops of the gradient.

colors - Array of colors of the gradient.

spreadMethod - How to fill the remainder region.

adapting - true if the gradient should be adapted to the shape on which it is drawn.

Since:

JViews 5.0

See Also:

IlvMultipleGradientPaintConstants.SPREAD_PAD, IlvMultipleGradientPaintConstants.SPREAD_REPEAT, IlvMultipleGradientPaintConstants.SPREAD_REFLECT

IlvRadialGradientPaint

public IlvRadialGradientPaint(double cx,
                              double cy,
                              double radius,
                              float[] stops,
                              Color[] colors,
                              double fx,
                              double fy,
                              boolean adapting)

Builds a circular IlvRadialGradientPaint instance.

Parameters:

cx - The x coordinate of the circle center.

cy - The y coordinate of the circle center.

radius - The radius of the circle.

stops - Array of stops of the gradient.

colors - Array of colors of the gradient.

fx - The x coordinate of the focal point.

fy - The y coordinate of the focal point.

adapting - true if the gradient should be adapted to the shape on which it is drawn.

IlvRadialGradientPaint

public IlvRadialGradientPaint(double cx,
                              double cy,
                              double radius,
                              float[] stops,
                              Color[] colors,
                              double fx,
                              double fy,
                              short spreadMethod,
                              boolean adapting)

Builds a circular IlvRadialGradientPaint instance.

Parameters:

cx - The x coordinate of the circle center.

cy - The y coordinate of the circle center.

radius - The radius of the circle.

stops - Array of stops of the gradient.

colors - Array of colors of the gradient.

fx - The x coordinate of the focal point.

fy - The y coordinate of the focal point.

spreadMethod - How to fill the remainder region.

adapting - true if the gradient should be adapted to the shape on which it is drawn.

Since:

JViews 5.0

See Also:

IlvMultipleGradientPaintConstants.SPREAD_PAD, IlvMultipleGradientPaintConstants.SPREAD_REPEAT, IlvMultipleGradientPaintConstants.SPREAD_REFLECT

IlvRadialGradientPaint

public IlvRadialGradientPaint(Point2D center,
                              double radius,
                              float[] stops,
                              Color[] colors,
                              Point2D focal,
                              boolean adapting)

Builds a circular IlvRadialGradientPaint instance.

Parameters:

center - The center of the circle.

radius - The radius of the circle.

colors - Array of colors of the gradient.

stops - Array of stops of the gradient.

focal - The focal point.

adapting - true if the gradient should be adapted to the shape on which it is drawn.

IlvRadialGradientPaint

public IlvRadialGradientPaint(Point2D center,
                              double radius,
                              float[] stops,
                              Color[] colors,
                              Point2D focal,
                              short spreadMethod,
                              boolean adapting)

Builds a circular IlvRadialGradientPaint instance.

Parameters:

center - The center of the circle.

radius - The radius of the circle.

colors - Array of colors of the gradient.

stops - Array of stops of the gradient.

focal - The focal point.

spreadMethod - How to fill the remainder region.

adapting - true if the gradient should be adapted to the shape on which it is drawn.

Since:

JViews 5.0

See Also:

IlvMultipleGradientPaintConstants.SPREAD_PAD, IlvMultipleGradientPaintConstants.SPREAD_REPEAT, IlvMultipleGradientPaintConstants.SPREAD_REFLECT

IlvRadialGradientPaint

public IlvRadialGradientPaint(Point2D center,
                              double radius,
                              float[] stops,
                              Color[] colors,
                              Point2D focal,
                              short spreadMethod,
                              short colorSpace,
                              AffineTransform transform,
                              boolean adapting)

Builds a circular IlvRadialGradientPaint instance.

Parameters:

center - The center of the circle.

radius - The radius of the circle.

colors - Array of colors of the gradient.

stops - Array of stops of the gradient.

focal - The focal point.

spreadMethod - How to fill the remainder region.

colorSpace - The color space where the color interpolation should take place.

transform - An additional transformer to apply when drawing the gradient.

adapting - true if the gradient should be adapted to the shape on which it is drawn.

Since:

JViews 5.0

See Also:

IlvMultipleGradientPaintConstants.SPREAD_PAD, IlvMultipleGradientPaintConstants.SPREAD_REPEAT, IlvMultipleGradientPaintConstants.SPREAD_REFLECT, IlvMultipleGradientPaintConstants.SRGB, IlvMultipleGradientPaintConstants.LINEAR_RGB

IlvRadialGradientPaint

public IlvRadialGradientPaint(IlvRadialGradientPaint source)

Creates a radial gradient paint by copying an existing one.

Parameters:

source - The radial gradient paint to be copied.

Since:

JViews 8.5

Method Detail

createContext

public PaintContext createContext(ColorModel cm,
                                  Rectangle deviceBounds,
                                  Rectangle2D userBounds,
                                  AffineTransform transform,
                                  RenderingHints hints)

Creates and returns a context used to generate the gradient.

getCenter

public Point2D getCenter()

Returns the gradient center.

Returns:

The gradient center.

getRadius

public double getRadius()

Returns the gradient radius.

Returns:

The gradient radius.

getFocal

public Point2D getFocal()

Returns the gradient focus.

Returns:

The gradient focus.