LinearGradientPaint (Java Platform SE 7)

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

すべての実装されたインタフェース:

Paint, Transparency
```
public final class LinearGradientPaint
extends MultipleGradientPaint
```
LinearGradientPaint クラスは、Shape をカラーの線形グラデーションパターンで塗りつぶす方法を提供します。ユーザーはグラデーションの色を 2 色以上指定でき、この場合の描画では、各色の間の補間が行われます。また、ユーザー空間内で色のグラデーションの開始位置と終了位置を定義する始点と終点を指定することもできます。
ユーザーは、グラデーションでの色の分布方法を指定する float 配列を指定する必要があります。これらの値は 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 オブジェクトで実行される動作を選択することもできます。反射グラデーションまたは繰り返しグラデーションでは、1 つのグラデーションの中にある任意の 2 色の間の距離は、始点と終点の間のそれら 2 色の距離と同じになります。ピクセルの粒度でのサンプリングのために、間隔にわずかな変動がいくつか発生する可能性があります。循環方法を指定しない場合は、デフォルトで 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% は白と青の間で補間されます。
3 つの循環方法のそれぞれについて、上記のコード例の結果は次のイメージのようになります。
導入されたバージョン:

1.6

関連項目:
Paint, Graphics2D.setPaint(java.awt.Paint)

ネストされたクラスのサマリー
- クラス java.awt.MultipleGradientPaint から継承されたネストされたクラス/インタフェース
  MultipleGradientPaint.ColorSpaceType, MultipleGradientPaint.CycleMethod

フィールドのサマリー
- インタフェース java.awt.Transparency から継承されたフィールド
  BITMASK, OPAQUE, TRANSLUCENT

コンストラクタのサマリー

コンストラクタ
コンストラクタと説明
`LinearGradientPaint(float startX, float startY, float endX, float endY, float[] fractions, Color[] colors)` デフォルトの `NO_CYCLE` 繰り返しメソッドと `SRGB` カラースペースで `LinearGradientPaint` を構築します。
`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 配列が null であるか、colors 配列が null であるか、または cycleMethod が 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)
```
    デフォルトの 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(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 - いずれかの点が null であるか、fractions 配列が null であるか、colors 配列が null であるか、cycleMethod が null であるか、colorSpace が null であるか、または gradientTransform が null である場合
    
    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 を作成して返します。null パラメータの処理については、Paint インタフェース内のメソッドの specification を参照してください。
    
    パラメータ:
    cm - 呼び出し元がピクセルデータを受信するためのもっとも便利な形式を表す推奨される ColorModel、または推奨値がない場合は null。
    deviceBounds - 描画されるグラフィックスプリミティブのデバイス空間でのバウンディングボックス。
    userBounds - 描画されるグラフィックスプリミティブのユーザー空間でのバウンディングボックス。
    transform - ユーザー空間からデバイス空間への AffineTransform。
    hints - コンテキストオブジェクトが描画の選択肢の中から選択するために使用できるヒントのセット。
    
    戻り値:
    カラーパターンを生成するための PaintContext。
    関連項目:
    Paint, PaintContext, ColorModel, Rectangle, Rectangle2D, AffineTransform, RenderingHints
  - getStartPoint
```
public Point2D getStartPoint()
```
    グラデーション軸の始点のコピーを返します。
    
    戻り値:
    この LinearGradientPaint の最初の色を固定する点のコピーを表す Point2D オブジェクト
  - getEndPoint
```
public Point2D getEndPoint()
```
    放射状グラデーションの焦点のコピーを返します。
    
    戻り値:
    この LinearGradientPaint の最後の色を固定する点のコピーを表す Point2D オブジェクト

バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.

クラス LinearGradientPaint

ネストされたクラスのサマリー

クラス java.awt.MultipleGradientPaint から継承されたネストされたクラス/インタフェース

フィールドのサマリー

インタフェース java.awt.Transparency から継承されたフィールド

コンストラクタのサマリー

メソッドのサマリー

クラス java.awt.MultipleGradientPaint から継承されたメソッド

クラス java.lang.Object から継承されたメソッド

コンストラクタの詳細

LinearGradientPaint

LinearGradientPaint

LinearGradientPaint

LinearGradientPaint

LinearGradientPaint

メソッドの詳細

createContext

getStartPoint

getEndPoint