java.awt

Class GradientPaint

java.lang.Object

java.awt.GradientPaint

All Implemented Interfaces:

Paint ， Transparency

public class GradientPaint
extends Object
implements Paint

GradientPaint课程提供了一种以线性颜色渐变模式填充Shape的方法。 如果Point P1与Color C1和Point P2与Color C2在用户空间中Color ，则P1，P2连接线上的Color按比例从C1更改为C2。 扩展P1，P2连接线上的任何点P都不具有在扩展P1，P2连接线上的P的垂直投影点P'的颜色。 P1，P2段外的扩展线上的点可以以两种方式之一进行着色。

• 如果梯度是循环的，则扩展的P1，P2连接线上的点在颜色C1和C2之间来回循环。
• 如果梯度是非循环的，那么该段的P1侧上的点具有常数Color C1，而P2侧的点具有常数Color C2。

Version:

1997年2月10日

另请参见：

Paint ， Graphics2D.setPaint(java.awt.Paint)

Field Summary

Fields inherited from interface java.awt.Transparency

BITMASK, OPAQUE, TRANSLUCENT

构造方法摘要

构造方法

Constructor and Description
GradientPaint(float x1, float y1, Color color1, float x2, float y2, Color color2) 构造一个简单的无环 GradientPaint对象。
GradientPaint(float x1, float y1, Color color1, float x2, float y2, Color color2, boolean cyclic) 环状的或者无环的构造 GradientPaint对象取决于 boolean参数。
GradientPaint(Point2D pt1, Color color1, Point2D pt2, Color color2) 构造一个简单的无环 GradientPaint对象。
GradientPaint(Point2D pt1, Color color1, Point2D pt2, Color color2, boolean cyclic) 环状的或者无环的构造 GradientPaint对象取决于 boolean参数。

方法摘要

Modifier and Type	Method and Description
PaintContext	createContext(ColorModel cm, Rectangle deviceBounds, Rectangle2D userBounds, AffineTransform xform, RenderingHints hints) 创建并返回一个PaintContext，用于生成线性颜色渐变模式。
Color	getColor1() 返回由点P1锚定的颜色C1。
Color	getColor2() 返回由点P2锚定的颜色C2。
Point2D	getPoint1() 返回锚点第一个颜色的点P1的副本。
Point2D	getPoint2() 返回固定第二种颜色的点P2的副本。
int	getTransparency() 返回此透明度模式 GradientPaint 。
boolean	isCyclic() 如果梯度在两种颜色C1和C2之间 true循环，则返回 true 。

Methods inherited from class java.lang.Object

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

构造方法详细信息

GradientPaint

public GradientPaint(float x1,
                     float y1,
                     Color color1,
                     float x2,
                     float y2,
                     Color color2)

构造一个简单的无环 GradientPaint对象。

参数

x1 - 用户空间中第一个指定的 Point x坐标

y1 - 用户空间中第一个指定的 Point y坐标

color1 - Color在第一个指定的 Point

x2 - 用户空间中第二个指定的 Point坐标

y2 - 用户空间中第二个指定的 Point y坐标

color2 - Color在第二个指定的 Point

异常

NullPointerException - 如果任何一种颜色为空

GradientPaint

public GradientPaint(Point2D pt1,
                     Color color1,
                     Point2D pt2,
                     Color color2)

构造一个简单的无环 GradientPaint对象。

参数

pt1 - 用户空间中第一个指定的 Point

color1 - Color在第一个指定的 Point

pt2 - 第二个用户空间中指定的 Point

color2 - Color在第二个指定的 Point

异常

NullPointerException - 如果颜色或点中的任一个为空

GradientPaint

public GradientPaint(float x1,
                     float y1,
                     Color color1,
                     float x2,
                     float y2,
                     Color color2,
                     boolean cyclic)

环状的或者无环的构造 GradientPaint对象取决于 boolean参数。

参数

x1 - 用户空间中第一个指定的 Point x坐标

y1 - 用户空间中第一个指定的 Point y坐标

color1 - Color在第一个指定的 Point

x2 -第二的x坐标指定 Point在用户空间

y2 - 用户空间中第二个指定的 Point y坐标

color2 - Color在第二个指定的 Point

cyclic - true如果渐变图案应该在两种颜色之间重复循环; false否则

GradientPaint

@ConstructorProperties(value={"point1","color1","point2","color2","cyclic"})
public GradientPaint(Point2D pt1,
                                                                                                  Color color1,
                                                                                                  Point2D pt2,
                                                                                                  Color color2,
                                                                                                  boolean cyclic)

环状的或者无环的构造 GradientPaint对象取决于 boolean参数。

参数

pt1 - 用户空间中第一个指定的 Point

color1 - Color在第一个指定的 Point

pt2 - 第二个用户空间中指定的 Point

color2 - Color在第二个指定的 Point

cyclic - true如果梯度图案应该在两种颜色之间重复循环; false否则

异常

NullPointerException - 如果颜色或点中的任一个为空

方法详细信息

getPoint1

public Point2D getPoint1()

返回锚点第一个颜色的点P1的副本。

结果

一个Point2D对象，是锚定此GradientPaint的第一个颜色的点的副本。

getColor1

public Color getColor1()

返回由点P1锚定的颜色C1。

结果

一个 Color对象，是由P1锚定的颜色。

getPoint2

public Point2D getPoint2()

返回固定第二种颜色的点P2的副本。

结果

一个Point2D对象，它是锚定此GradientPaint的第二个颜色的点的副本。

getColor2

public Color getColor2()

返回由点P2锚定的颜色C2。

结果

一个 Color对象，是由P2锚定的颜色。

isCyclic

public boolean isCyclic()

如果梯度在两个颜色C1和C2之间 true循环，则返回 true 。

结果

true如果梯度在两种颜色之间true循环; false否则。

createContext

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

创建并返回一个用于生成线性颜色渐变模式的PaintContext 。 有关空参数处理的信息，请参阅Paint接口中的specification方法。

Specified by:

createContext在界面 Paint

参数

cm -优选ColorModel表示用于呼叫者接收的像素数据，或最方便的格式null如果没有偏好。

deviceBounds - 要呈现的图形基元的设备空间边界框。

userBounds - 呈现的图形基元的用户空间边界框。

xform - 从用户空间到设备空间的AffineTransform 。

hints - 上下文对象可用于在呈现替代方案之间进行选择的一组提示。

结果

用于生成颜色图案的 PaintContext 。

另请参见：

Paint ， PaintContext ， ColorModel ， Rectangle ， Rectangle2D ， AffineTransform ， RenderingHints

getTransparency

public int getTransparency()

返回此透明度模式 GradientPaint 。

Specified by:

getTransparency在界面 Transparency

结果

一个整数值代表这个 GradientPaint对象的透明度模式。

另请参见：

Transparency