javafx.scene.paint

Class Stop

java.lang.Object

javafx.scene.paint.Stop

public final class Stop
extends java.lang.Object

Defines one element of the ramp of colors to use on a gradient. For more information see javafx.scene.paint.LinearGradient and javafx.scene.paint.RadialGradient.

Example:

 // object bounding box relative (proportional:true, default)
 Stop[] stops = { new Stop(0, Color.WHITE), new Stop(1, Color.BLACK)};
 LinearGradient lg = new LinearGradient(0, 0, 1, 0, true, CycleMethod.No_CYCLE, stops);
 Rectangle r = new Rectangle();
 r.setFill(lg);

Since:

JavaFX 2.0

Field Summary

Fields

Modifier and Type	Field and Description
private Color	color The color of the gradient at this offset.
private int	hash The cached hash code, used to improve performance in situations where we cache gradients, such as in the CSS routines.
(package private) static java.util.List<Stop>	NO_STOPS
private double	offset The offset variable is a number ranging from 0 to 1 that indicates where this gradient stop is placed.

Constructor Summary

Constructors

Constructor and Description
Stop(double offset, Color color) Creates a new instance of Stop.

Method Summary

Modifier and Type	Method and Description
boolean	equals(java.lang.Object obj) Indicates whether some other object is "equal to" this one.
Color	getColor() Gets the color of the gradient at this offset.
double	getOffset() Gets a number ranging from 0 to 1 that indicates where this gradient stop is placed.
int	hashCode() Returns a hash code for this Stop object.
(package private) static java.util.List<Stop>	normalize(java.util.List<Stop> stops)
(package private) static java.util.List<Stop>	normalize(Stop[] stops)
java.lang.String	toString() Returns a string representation of this Stop object.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

NO_STOPS

static final java.util.List<Stop> NO_STOPS

offset

private double offset

The offset variable is a number ranging from 0 to 1 that indicates where this gradient stop is placed. For linear gradients, the offset variable represents a location along the gradient vector. For radial gradients, it represents a percentage distance from the focus point to the edge of the outermost/largest circle.

color

private Color color

The color of the gradient at this offset.

hash

private int hash

The cached hash code, used to improve performance in situations where we cache gradients, such as in the CSS routines.

Constructor Detail

Stop

public Stop(double offset,
            Color color)

Creates a new instance of Stop.

Parameters:

offset - Stop's position (ranging from 0 to 1

color - Stop's color

Method Detail

normalize

static java.util.List<Stop> normalize(Stop[] stops)

normalize

static java.util.List<Stop> normalize(java.util.List<Stop> stops)

getOffset

public final double getOffset()

Gets a number ranging from 0 to 1 that indicates where this gradient stop is placed. For linear gradients, the offset variable represents a location along the gradient vector. For radial gradients, it represents a percentage distance from the focus point to the edge of the outermost/largest circle.

Returns:

position of the Stop within the gradient (ranging from 0 to 1)

getColor

public final Color getColor()

Gets the color of the gradient at this offset.

Returns:

the color of the gradient at this offset

equals

public boolean equals(java.lang.Object obj)

Indicates whether some other object is "equal to" this one.

Overrides:

equals in class java.lang.Object

Parameters:

obj - the reference object with which to compare.

Returns:

true if this object is equal to the obj argument; false otherwise.

hashCode

public int hashCode()

Returns a hash code for this Stop object.

Overrides:

hashCode in class java.lang.Object

Returns:

a hash code for this Stop object.

toString

public java.lang.String toString()

Returns a string representation of this Stop object.

Overrides:

toString in class java.lang.Object

Returns:

a string representation of this Stop object.