public final class LinearGradientPaint extends MultipleGradientPaint
LinearGradientPaint
类提供了一种填充Shape
与线性颜色渐变模式的方式。
用户可以指定两种或多种渐变颜色,并且这种颜色将在每种颜色之间提供插值。
用户还指定了起点和终点,这些点定义了用户空间中颜色渐变应该开始和结束的位置。
用户必须提供一个浮动数组,指定如何沿渐变分布颜色。 这些值应该在0.0到1.0之间,并且像沿梯度的关键帧一样起作用(它们标记渐变应该是一个特定的颜色)。
在用户没有将第一关键帧值设置为等于0和/或最后一个关键帧值等于1的情况下,将在这些位置创建关键帧,并且将在那里复制第一个和最后一个颜色。 因此,如果用户指定了以下数组来构造渐变:
{Color.BLUE, Color.RED}, {.3f, .7f}
这将被转换为具有以下关键帧的渐变:
{Color.BLUE, Color.BLUE, Color.RED, Color.RED}, {0f, .3f, .7f, 1f}
用户还可以通过将CycleMethod
设置为REFLECTION
或REPEAT
来选择LinearGradientPaint
对象在开始和结束点之外填充空间时所采取的操作。 渐变的任何反射或重复副本中的任何两种颜色之间的距离与起点和终点之间相同的两种颜色之间的距离相同。 请注意,由于以像素的粒度进行采样,可能会发生距离的一些微小变化。 如果没有指定循环方式,默认情况下会选择NO_CYCLE
,这意味着端点颜色将用于填充剩余的区域。
colorSpace参数允许用户指定应在哪个颜色空间执行插值,默认sRGB或线性化RGB。
下面的代码演示的典型用法LinearGradientPaint
:
Point2D start = new Point2D.Float(0, 0);
Point2D end = new Point2D.Float(50, 50);
float[] dist = {0.0f, 0.2f, 1.0f};
Color[] colors = {Color.RED, Color.WHITE, Color.BLUE};
LinearGradientPaint p =
new LinearGradientPaint(start, end, dist, colors);
该代码将创建一个LinearGradientPaint
,其在渐变的前20%和白色和蓝色之间在剩余的80%之间在红色和白色之间插值。
该图像演示了上述三个循环方法中的每个示例代码:
Paint
, Graphics2D.setPaint(java.awt.Paint)
MultipleGradientPaint.ColorSpaceType, MultipleGradientPaint.CycleMethod
BITMASK, OPAQUE, TRANSLUCENT
Constructor and Description |
---|
LinearGradientPaint(float startX, float startY, float endX, float endY, float[] fractions, Color[] colors)
构造一个
LinearGradientPaint 与默认
NO_CYCLE 重复方法和
SRGB 颜色空间。
|
LinearGradientPaint(float startX, float startY, float endX, float endY, float[] fractions, Color[] colors, MultipleGradientPaint.CycleMethod cycleMethod)
构造一个
LinearGradientPaint ,默认的颜色空间为
SRGB 。
|
LinearGradientPaint(Point2D start, Point2D end, float[] fractions, Color[] colors)
构造一个
LinearGradientPaint 与默认
NO_CYCLE 重复方法和
SRGB 颜色空间。
|
LinearGradientPaint(Point2D start, Point2D end, float[] fractions, Color[] colors, MultipleGradientPaint.CycleMethod cycleMethod)
构造一个
LinearGradientPaint ,默认的颜色空间为
SRGB 。
|
LinearGradientPaint(Point2D start, Point2D end, float[] fractions, Color[] colors, MultipleGradientPaint.CycleMethod cycleMethod, MultipleGradientPaint.ColorSpaceType colorSpace, AffineTransform gradientTransform)
构造一个
LinearGradientPaint 。
|
Modifier and Type | Method and Description |
---|---|
PaintContext |
createContext(ColorModel cm, Rectangle deviceBounds, Rectangle2D userBounds, AffineTransform transform, RenderingHints hints)
创建并返回一个用于生成线性颜色渐变模式的 PaintContext 。
|
Point2D |
getEndPoint()
返回渐变轴终点的副本。
|
Point2D |
getStartPoint()
返回渐变轴起始点的副本。
|
getColors, getColorSpace, getCycleMethod, getFractions, getTransform, getTransparency
public LinearGradientPaint(float startX, float startY, float endX, float endY, float[] fractions, Color[] colors)
LinearGradientPaint
,具有默认的
NO_CYCLE
重复方法和
SRGB
颜色空间。
startX
- 用户空间中渐变轴起始点的X坐标
startY
- 用户空间中梯度轴起始点的Y坐标
endX
- 用户空间中渐变轴终点的X坐标
endY
- 用户空间中梯度轴终点的Y坐标
fractions
- 范围从0.0到1.0的数字,指定渐变颜色的分布
colors
- 对应于每个小数值的颜色数组
NullPointerException
- 如果
fractions
数组为空,或
colors
数组为空,
IllegalArgumentException
- 如果起点和终点相同,或
fractions.length != colors.length
或
colors
小于2,或
fractions
值小于0.0或大于1.0,或
fractions
不提供严格的增加顺序
public LinearGradientPaint(float startX, float startY, float endX, float endY, float[] fractions, Color[] colors, MultipleGradientPaint.CycleMethod cycleMethod)
LinearGradientPaint
与默认的
SRGB
颜色空间。
startX
- 用户空间中渐变轴起始点的X坐标
startY
- 用户空间中梯度轴起始点的Y坐标
endX
- 用户空间中渐变轴终点的X坐标
endY
- 用户空间中渐变轴终点的Y坐标
fractions
- 范围从0.0到1.0的数字,指定沿梯度的颜色分布
colors
- 对应于每个分数值的颜色数组
cycleMethod
-无论是
NO_CYCLE
,
REFLECT
,或
REPEAT
NullPointerException
- 如果
fractions
数组为空,或
colors
数组为空,或
cycleMethod
为空
IllegalArgumentException
- 如果起点和终点相同点,或
fractions.length != colors.length
或
colors
小于2,或
fractions
值小于0.0或大于1.0,或
fractions
未提供严格增加的顺序
public LinearGradientPaint(Point2D start, Point2D end, float[] fractions, Color[] colors)
LinearGradientPaint
与默认
NO_CYCLE
重复方法和
SRGB
颜色空间。
start
- 用户空间中的梯度轴启动
Point2D
end
- 用户空间中的渐变轴端
Point2D
fractions
- 范围从0.0到1.0的数字,指定渐变颜色的分布
colors
- 对应于每个小数值的颜色数组
NullPointerException
- 如果其中一个点为空,或
fractions
数组为空,或
colors
数组为空
IllegalArgumentException
- 如果开始点和结束点是相同的点,或
fractions.length != colors.length
或
colors
小于2,或
fractions
值小于0.0或大于1.0,或
fractions
不以严格增加的顺序提供
public LinearGradientPaint(Point2D start, Point2D end, float[] fractions, Color[] colors, MultipleGradientPaint.CycleMethod cycleMethod)
LinearGradientPaint
与默认的
SRGB
颜色空间。
start
- 用户空间中的渐变轴启动
Point2D
end
- 用户空间中的渐变轴端
Point2D
fractions
- 范围从0.0到1.0的数字,指定渐变颜色的分布
colors
- 对应于每个分数值的颜色数组
cycleMethod
-无论是
NO_CYCLE
,
REFLECT
,或
REPEAT
NullPointerException
-如果有一个点是空值,或
fractions
阵列为空,或
colors
阵列为空,或
cycleMethod
为空
IllegalArgumentException
- 如果起点和终点相同点,或
fractions.length != colors.length
或
colors
小于2,或
fractions
值小于0.0或大于1.0,或
fractions
不以严格增加的顺序提供
@ConstructorProperties(value={"startPoint","endPoint","fractions","colors","cycleMethod","colorSpace","transform"}) public LinearGradientPaint(Point2D start, Point2D end, float[] fractions, Color[] colors, MultipleGradientPaint.CycleMethod cycleMethod, MultipleGradientPaint.ColorSpaceType colorSpace, AffineTransform gradientTransform)
LinearGradientPaint
。
start
- 用户空间中的渐变轴启动
Point2D
end
- 用户空间中的渐变轴端
Point2D
fractions
- 范围从0.0到1.0的数字,指定渐变颜色的分布
colors
- 对应于每个分数值的颜色数组
cycleMethod
-无论是
NO_CYCLE
,
REFLECT
,或
REPEAT
colorSpace
- 用于插值的颜色空间,
SRGB
或
LINEAR_RGB
gradientTransform
- 转换为应用于渐变
NullPointerException
- 如果其中一个点为空,或
fractions
数组为空,或
colors
数组为空,或
cycleMethod
为空,或
colorSpace
为空,或
gradientTransform
为空
IllegalArgumentException
- 如果起点和终点是相同的点,或者
fractions.length != colors.length
或
colors
的大小小于2,或者
fractions
值小于0.0或大于1.0,或
fractions
没有以严格的增加顺序提供
public PaintContext createContext(ColorModel cm, Rectangle deviceBounds, Rectangle2D userBounds, AffineTransform transform, RenderingHints hints)
PaintContext
。
有关空参数处理的信息,请参阅Paint
接口中的specification
方法。
cm
-优选ColorModel
表示用于呼叫者接收的像素数据,或最方便的格式null
如果没有偏好。
deviceBounds
- 正在呈现的图形基元的设备空间边界框。
userBounds
- 正在呈现的图形基元的用户空间边界框。
transform
- 从用户空间到设备空间的AffineTransform
。
hints
- 上下文对象可用于在渲染替代方案之间进行选择的一组提示。
PaintContext
。
Paint
, PaintContext
, ColorModel
, Rectangle
, Rectangle2D
, AffineTransform
, RenderingHints
public Point2D getStartPoint()
Point2D
对象,这是一个点的一个副本,锚定这个
LinearGradientPaint
的第一个颜色
public Point2D getEndPoint()
Point2D
对象,这是一个点的副本,锚定这个
LinearGradientPaint
的最后一个颜色
Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.