java.lang.Object
- java.awt.MultipleGradientPaint
- - java.awt.LinearGradientPaint

实现的所有接口

Paint ， Transparency
```
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％。

此图像演示了上述三种循环方法中的每一种的示例代码：
从以下版本开始：

1.6

另请参见：

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

嵌套类汇总
- 嵌套类/接口声明在类 java.awt.MultipleGradientPaint
  MultipleGradientPaint.ColorSpaceType, MultipleGradientPaint.CycleMethod

字段汇总
- Fields declared in interface java.awt.Transparency
  BITMASK, OPAQUE, TRANSLUCENT

构造方法摘要

构造方法
构造器	描述
`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)`	使用默认的 `SRGB`颜色空间构造 `LinearGradientPaint` 。
`LinearGradientPaint(Point2D start, Point2D end, float[] fractions, Color[] colors)`	使用默认的 `NO_CYCLE`重复方法和 `SRGB`颜色空间构造一个 `LinearGradientPaint` 。
`LinearGradientPaint(Point2D start, Point2D end, float[] fractions, Color[] colors, MultipleGradientPaint.CycleMethod cycleMethod)`	使用默认的 `SRGB`颜色空间构造 `LinearGradientPaint` 。
`LinearGradientPaint(Point2D start, Point2D end, float[] fractions, Color[] colors, MultipleGradientPaint.CycleMethod cycleMethod, MultipleGradientPaint.ColorSpaceType colorSpace, AffineTransform gradientTransform)`	构造一个 `LinearGradientPaint` 。

方法摘要

所有方法实例方法具体的方法
变量和类型	方法	描述
`PaintContext`	`createContext(ColorModel cm, Rectangle deviceBounds, Rectangle2D userBounds, AffineTransform transform, RenderingHints hints)`	创建并返回用于生成线性颜色渐变图案的`PaintContext` 。
`Point2D`	`getEndPoint()`	返回渐变轴终点的副本。
`Point2D`	`getStartPoint()`	返回渐变轴起点的副本。

声明方法的类 java.awt.MultipleGradientPaint
getColors, getColorSpace, getCycleMethod, getFractions, getTransform, getTransparency

声明方法的类 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造方法详细信息
  - LinearGradientPaint
```
public LinearGradientPaint(float startX,
                           float startY,
                           float endX,
                           float endY,
                           float[] fractions,
                           Color[] colors)
```
    使用默认的 NO_CYCLE重复方法和 SRGB颜色空间构造一个 LinearGradientPaint 。
    
    参数
    
    startX - 用户空间中渐变轴起点的X坐标
    
    startY - 用户空间中渐变轴起点的Y坐标
    
    endX - 用户空间中渐变轴终点的X坐标
    
    endY - 用户空间中渐变轴终点的Y坐标
    
    fractions - 数字范围从0.0到1.0，指定沿渐变的颜色分布
    
    colors - 对应于每个小数值的颜色数组
    
    异常
    
    NullPointerException - 如果 fractions数组为null，或者 colors数组为null，
    
    IllegalArgumentException - 如果起点和终点是相同的点，或者 fractions.length != colors.length或 colors大小小于2，或者 fractions值小于0.0或大于1.0，或者 fractions严格增加的顺序提供
  - LinearGradientPaint
```
public LinearGradientPaint(float startX,
                           float startY,
                           float endX,
                           float endY,
                           float[] fractions,
                           Color[] colors,
                           MultipleGradientPaint.CycleMethod cycleMethod)
```
    使用默认的 SRGB颜色空间构造 LinearGradientPaint 。
    
    参数
    
    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严格增加的顺序提供
  - LinearGradientPaint
```
public LinearGradientPaint(Point2D start,
                           Point2D end,
                           float[] fractions,
                           Color[] colors)
```
    使用默认的 NO_CYCLE重复方法和 SRGB颜色空间构造一个 LinearGradientPaint 。
    
    参数
    
    start - 梯度轴在用户空间中启动 Point2D
    
    end - 用户空间中的渐变轴结束 Point2D
    
    fractions - 数字范围从0.0到1.0，指定沿渐变的颜色分布
    
    colors - 对应于每个小数值的颜色数组
    
    异常
    
    NullPointerException - 如果其中一个点为null，或者 fractions数组为null，或者 colors数组为null
    
    IllegalArgumentException - 如果起点和终点是相同的点，或者 fractions.length != colors.length或 colors大小小于2，或者 fractions值小于0.0或大于1.0，或者 fractions严格增加的顺序提供
  - LinearGradientPaint
```
public LinearGradientPaint(Point2D start,
                           Point2D end,
                           float[] fractions,
                           Color[] colors,
                           MultipleGradientPaint.CycleMethod cycleMethod)
```
    使用默认的 SRGB颜色空间构造一个 LinearGradientPaint 。
    
    参数
    
    start - 用户空间中的渐变轴启动 Point2D
    
    end - 用户空间中的渐变轴结束 Point2D
    
    fractions - 数字范围从0.0到1.0，指定沿渐变的颜色分布
    
    colors - 对应于每个小数值的颜色数组
    
    cycleMethod -无论是 NO_CYCLE ， REFLECT ，或 REPEAT
    
    异常
    
    NullPointerException - 如果其中一个点为null，或者 fractions数组为null，或者 colors数组为null，或者 cycleMethod为null
    
    IllegalArgumentException - 如果起点和终点是相同的点，或者 fractions.length != colors.length或 colors大小小于2，或者 fractions值小于0.0或大于1.0，或者 fractions严格增加的顺序提供
  - LinearGradientPaint
```
@ConstructorProperties({"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严格增加的顺序提供
- 方法详细信息
  - createContext
```
public PaintContext createContext(ColorModel cm,
                                  Rectangle deviceBounds,
                                  Rectangle2D userBounds,
                                  AffineTransform transform,
                                  RenderingHints hints)
```
    创建并返回用于生成线性颜色渐变图案的PaintContext 。见specification方法在Paint界面上的空参数处理信息。
    
    参数
    
    cm - 首选ColorModel ，表示调用者接收像素数据的最方便格式，如果没有首选项， null 。
    
    deviceBounds - 正在呈现的图形基元的设备空间边界框。
    
    userBounds - 正在呈现的图形基元的用户空间边界框。
    
    transform - 从用户空间到设备空间的AffineTransform 。
    
    hints - 上下文对象可用于在呈现替代项之间进行选择的提示集。
    
    结果
    
    PaintContext用于生成颜色模式。
    
    另请参见：
    
    Paint ， PaintContext ， ColorModel ， Rectangle ， Rectangle2D ， AffineTransform ， RenderingHints
  - getStartPoint
```
public Point2D getStartPoint()
```
    返回渐变轴起点的副本。
    
    结果
    
    一个 Point2D对象，它是锚点此 LinearGradientPaint的第一种颜色的点的副本
  - getEndPoint
```
public Point2D getEndPoint()
```
    返回渐变轴终点的副本。
    
    结果
    
    一个 Point2D对象，它是锚点此 LinearGradientPaint最后一种颜色的点的副本

Class LinearGradientPaint

嵌套类汇总

嵌套类/接口声明在类 java.awt.MultipleGradientPaint

字段汇总

Fields declared in interface java.awt.Transparency

构造方法摘要

方法摘要

声明方法的类 java.awt.MultipleGradientPaint

声明方法的类 java.lang.Object

构造方法详细信息

LinearGradientPaint

LinearGradientPaint

LinearGradientPaint

LinearGradientPaint

LinearGradientPaint

方法详细信息

createContext

getStartPoint

getEndPoint