RadialGradientPaint (Java Platform SE 7)

java.lang.Object
- java.awt.MultipleGradientPaint
- - java.awt.RadialGradientPaint

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

Paint, Transparency
```
public final class RadialGradientPaint
extends MultipleGradientPaint
```
RadialGradientPaint クラスは、形状を色の円放射状グラデーションパターンで塗りつぶす方法を提供します。ユーザーはグラデーションの色を 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 に設定することによって、円の半径の外側の領域を塗りつぶすときに RadialGradientPaint オブジェクトで実行される動作を選択することもできます。グラデーションの色の比率は、焦点から引かれたどの直線でも等しくなります。次の図は、距離 AB が距離 BC と等しく、距離 AD が距離 DE と等しいことを示しています。
グラデーションおよびグラフィックスレンダリング変換が均一にスケーリングされる場合、ユーザーが焦点を円の中心に一致するように設定すると、グラデーションの色の比率は、中心から引かれたどの直線でも等しくなります。次の図は、距離 AB、BC、AD、および DE を示しています。これらはすべて等しくなります。ピクセルの粒度でのサンプリングのために、間隔にわずかな変動がいくつか発生する可能性があることに注意してください。循環方法を指定しない場合は、デフォルトで NO_CYCLE が選択されます。つまり、残りの領域を塗りつぶすために最後のキーフレームの色が使用されます。
colorSpace パラメータでは、補間が実行されるカラースペース (デフォルトの sRGB または線形化された RGB) を指定できます。
次のコードは、中心点と焦点が同一の場合の RadialGradientPaint の一般的な使い方を示しています。
```
     Point2D center = new Point2D.Float(50, 50);
     float radius = 25;
     float[] dist = {0.0f, 0.2f, 1.0f};
     Color[] colors = {Color.RED, Color.WHITE, Color.BLUE};
     RadialGradientPaint p =
         new RadialGradientPaint(center, radius, dist, colors);
 
```
3 つの循環方法のそれぞれについて、焦点がデフォルトの (中心点に合わされた) ときの上記のコード例の結果は次のイメージのようになります。

次のコードのように、中心点に合わされていない焦点を指定することもできます。
```
     Point2D center = new Point2D.Float(50, 50);
     float radius = 25;
     Point2D focus = new Point2D.Float(40, 40);
     float[] dist = {0.0f, 0.2f, 1.0f};
     Color[] colors = {Color.RED, Color.WHITE, Color.BLUE};
     RadialGradientPaint p =
         new RadialGradientPaint(center, radius, focus,
                                 dist, colors,
                                 CycleMethod.NO_CYCLE);
 
```
3 つの循環方法のそれぞれについて、焦点が中心点に合わされていないときの上記のコード例の結果は次のイメージのようになります。
導入されたバージョン:

1.6

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

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

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

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

コンストラクタ
コンストラクタと説明
`RadialGradientPaint(float cx, float cy, float radius, float[] fractions, Color[] colors)` 中心を焦点として使用して、デフォルトの `NO_CYCLE` 繰り返しメソッドと `SRGB` カラースペースで `RadialGradientPaint` を構築します。
`RadialGradientPaint(float cx, float cy, float radius, float[] fractions, Color[] colors, MultipleGradientPaint.CycleMethod cycleMethod)` 中心を焦点として使用して、デフォルトの `SRGB` カラースペースで `RadialGradientPaint` を構築します。
`RadialGradientPaint(float cx, float cy, float radius, float fx, float fy, float[] fractions, Color[] colors, MultipleGradientPaint.CycleMethod cycleMethod)` デフォルトの `SRGB` カラースペースで `RadialGradientPaint` を構築します。
`RadialGradientPaint(Point2D center, float radius, float[] fractions, Color[] colors)` 中心を焦点として使用して、デフォルトの `NO_CYCLE` 繰り返しメソッドと `SRGB` カラースペースで `RadialGradientPaint` を構築します。
`RadialGradientPaint(Point2D center, float radius, float[] fractions, Color[] colors, MultipleGradientPaint.CycleMethod cycleMethod)` 中心を焦点として使用して、デフォルトの `SRGB` カラースペースで `RadialGradientPaint` を構築します。
`RadialGradientPaint(Point2D center, float radius, Point2D focus, float[] fractions, Color[] colors, MultipleGradientPaint.CycleMethod cycleMethod)` デフォルトの `SRGB` カラースペースで `RadialGradientPaint` を構築します。
`RadialGradientPaint(Point2D center, float radius, Point2D focus, float[] fractions, Color[] colors, MultipleGradientPaint.CycleMethod cycleMethod, MultipleGradientPaint.ColorSpaceType colorSpace, AffineTransform gradientTransform)` `RadialGradientPaint` を構築します。
`RadialGradientPaint(Rectangle2D gradientBounds, float[] fractions, Color[] colors, MultipleGradientPaint.CycleMethod cycleMethod)` デフォルトの `SRGB` カラースペースで `RadialGradientPaint` を構築します。

メソッドのサマリー

メソッド
修飾子と型	メソッドと説明
`PaintContext`	`createContext(ColorModel cm, Rectangle deviceBounds, Rectangle2D userBounds, AffineTransform transform, RenderingHints hints)` 色の円放射状グラデーションパターンを生成するために使用される `PaintContext` を作成して返します。
`Point2D`	`getCenterPoint()` 放射状グラデーションの中心点のコピーを返します。
`Point2D`	`getFocusPoint()` 放射状グラデーションの焦点のコピーを返します。
`float`	`getRadius()` 放射状グラデーションを定義する円の半径を返します。

クラス java.awt.MultipleGradientPaint から継承されたメソッド
getColors, getColorSpace, getCycleMethod, getFractions, getTransform, getTransparency

クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- コンストラクタの詳細
  - RadialGradientPaint
```
public RadialGradientPaint(float cx,
                   float cy,
                   float radius,
                   float[] fractions,
                   Color[] colors)
```
    中心を焦点として使用して、デフォルトの NO_CYCLE 繰り返しメソッドと SRGB カラースペースで RadialGradientPaint を構築します。
    
    パラメータ:
    cx - グラデーションを定義する円の中心点のユーザー空間内の X 座標。グラデーションの最後の色は、この円の円周にマップされる
    cy - グラデーションを定義する円の中心点のユーザー空間内の Y 座標。グラデーションの最後の色は、この円の円周にマップされる
    radius - 色のグラデーションの広がりを定義する円の半径
    fractions - グラデーションに沿った色の分布を指定する、0.0 から 1.0 までの範囲の数値
    colors - グラデーションで使用する色の配列。最初の色は焦点で使用され、最後の色は円周で使用される
    
    例外:
    
    NullPointerException - fractions 配列が null であるか colors 配列が null である場合
    
    IllegalArgumentException - radius が正でない場合、fractions.length != colors.length である場合、colors のサイズが 2 がより小さい場合、fractions 値が 0.0 より小さいか 1.0 より大きい場合、または fractions が厳密に昇順で指定されていない場合
  - RadialGradientPaint
```
public RadialGradientPaint(Point2D center,
                   float radius,
                   float[] fractions,
                   Color[] colors)
```
    中心を焦点として使用して、デフォルトの NO_CYCLE 繰り返しメソッドと SRGB カラースペースで RadialGradientPaint を構築します。
    
    パラメータ:
    center - グラデーションを定義する円のユーザー空間内の中心点
    radius - 色のグラデーションの広がりを定義する円の半径
    fractions - グラデーションに沿った色の分布を指定する、0.0 から 1.0 までの範囲の数値
    colors - グラデーションで使用する色の配列。最初の色は焦点で使用され、最後の色は円周で使用される
    
    例外:
    
    NullPointerException - center 点が null の場合、fractions 配列が null の場合、または colors 配列が null の場合
    
    IllegalArgumentException - radius が正でない場合、fractions.length != colors.length である場合、colors のサイズが 2 がより小さい場合、fractions 値が 0.0 より小さいか 1.0 より大きい場合、または fractions が厳密に昇順で指定されていない場合
  - RadialGradientPaint
```
public RadialGradientPaint(float cx,
                   float cy,
                   float radius,
                   float[] fractions,
                   Color[] colors,
                   MultipleGradientPaint.CycleMethod cycleMethod)
```
    中心を焦点として使用して、デフォルトの SRGB カラースペースで RadialGradientPaint を構築します。
    
    パラメータ:
    cx - グラデーションを定義する円の中心点のユーザー空間内の X 座標。グラデーションの最後の色は、この円の円周にマップされる
    cy - グラデーションを定義する円の中心点のユーザー空間内の Y 座標。グラデーションの最後の色は、この円の円周にマップされる
    radius - 色のグラデーションの広がりを定義する円の半径
    fractions - グラデーションに沿った色の分布を指定する、0.0 から 1.0 までの範囲の数値
    colors - グラデーションで使用する色の配列。最初の色は焦点で使用され、最後の色は円周で使用される
    cycleMethod - NO_CYCLE、REFLECT、REPEAT のいずれか
    
    例外:
    
    NullPointerException - fractions 配列が null であるか、colors 配列が null であるか、または cycleMethod が null である場合
    
    IllegalArgumentException - radius が正でない場合、fractions.length != colors.length である場合、colors のサイズが 2 がより小さい場合、fractions 値が 0.0 より小さいか 1.0 より大きい場合、または fractions が厳密に昇順で指定されていない場合
  - RadialGradientPaint
```
public RadialGradientPaint(Point2D center,
                   float radius,
                   float[] fractions,
                   Color[] colors,
                   MultipleGradientPaint.CycleMethod cycleMethod)
```
    中心を焦点として使用して、デフォルトの SRGB カラースペースで RadialGradientPaint を構築します。
    
    パラメータ:
    center - グラデーションを定義する円のユーザー空間内の中心点
    radius - 色のグラデーションの広がりを定義する円の半径
    fractions - グラデーションに沿った色の分布を指定する、0.0 から 1.0 までの範囲の数値
    colors - グラデーションで使用する色の配列。最初の色は焦点で使用され、最後の色は円周で使用される
    cycleMethod - NO_CYCLE、REFLECT、REPEAT のいずれか
    
    例外:
    
    NullPointerException - center 点が null の場合、fractions 配列が null の場合、colors 配列が null の場合、または cycleMethod が null の場合
    
    IllegalArgumentException - radius が正でない場合、fractions.length != colors.length である場合、colors のサイズが 2 がより小さい場合、fractions 値が 0.0 より小さいか 1.0 より大きい場合、または fractions が厳密に昇順で指定されていない場合
  - RadialGradientPaint
```
public RadialGradientPaint(float cx,
                   float cy,
                   float radius,
                   float fx,
                   float fy,
                   float[] fractions,
                   Color[] colors,
                   MultipleGradientPaint.CycleMethod cycleMethod)
```
    デフォルトの SRGB カラースペースで RadialGradientPaint を構築します。
    
    パラメータ:
    cx - グラデーションを定義する円の中心点のユーザー空間内の X 座標。グラデーションの最後の色は、この円の円周にマップされる
    cy - グラデーションを定義する円の中心点のユーザー空間内の Y 座標。グラデーションの最後の色は、この円の円周にマップされる
    radius - 色のグラデーションの広がりを定義する円の半径
    fx - 最初の色がマップされる、ユーザー空間内の点の X 座標
    fy - 最初の色がマップされる、ユーザー空間内の点の Y 座標
    fractions - グラデーションに沿った色の分布を指定する、0.0 から 1.0 までの範囲の数値
    colors - グラデーションで使用する色の配列。最初の色は焦点で使用され、最後の色は円周で使用される
    cycleMethod - NO_CYCLE、REFLECT、REPEAT のいずれか
    
    例外:
    
    NullPointerException - fractions 配列が null であるか、colors 配列が null であるか、または cycleMethod が null である場合
    
    IllegalArgumentException - radius が正でない場合、fractions.length != colors.length である場合、colors のサイズが 2 がより小さい場合、fractions 値が 0.0 より小さいか 1.0 より大きい場合、または fractions が厳密に昇順で指定されていない場合
  - RadialGradientPaint
```
public RadialGradientPaint(Point2D center,
                   float radius,
                   Point2D focus,
                   float[] fractions,
                   Color[] colors,
                   MultipleGradientPaint.CycleMethod cycleMethod)
```
    デフォルトの SRGB カラースペースで RadialGradientPaint を構築します。
    
    パラメータ:
    center - グラデーションを定義する円のユーザー空間内の中心点。グラデーションの最後の色は、この円の円周にマップされる
    radius - 色のグラデーションの広がりを定義する円の半径
    focus - 最初の色がマップされる先のユーザー空間内の点
    fractions - グラデーションに沿った色の分布を指定する、0.0 から 1.0 までの範囲の数値
    colors - グラデーションで使用する色の配列。最初の色は焦点で使用され、最後の色は円周で使用される
    cycleMethod - NO_CYCLE、REFLECT、REPEAT のいずれか
    
    例外:
    
    NullPointerException - いずれかの点が null であるか、fractions 配列が null であるか、colors 配列が null であるか、または cycleMethod が null である場合
    
    IllegalArgumentException - radius が正でない場合、fractions.length != colors.length である場合、colors のサイズが 2 がより小さい場合、fractions 値が 0.0 より小さいか 1.0 より大きい場合、または fractions が厳密に昇順で指定されていない場合
  - RadialGradientPaint
```
@ConstructorProperties(value={"centerPoint","radius","focusPoint","fractions","colors","cycleMethod","colorSpace","transform"})
public RadialGradientPaint(Point2D center,
                                              float radius,
                                              Point2D focus,
                                              float[] fractions,
                                              Color[] colors,
                                              MultipleGradientPaint.CycleMethod cycleMethod,
                                              MultipleGradientPaint.ColorSpaceType colorSpace,
                                              AffineTransform gradientTransform)
```
    RadialGradientPaint を構築します。
    
    パラメータ:
    center - グラデーションを定義する円のユーザー空間内の中心点。グラデーションの最後の色は、この円の円周にマップされる
    radius - 色のグラデーションの広がりを定義する円の半径
    focus - 最初の色がマップされる先のユーザー空間内の点
    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 - radius が正でない場合、fractions.length != colors.length である場合、colors のサイズが 2 がより小さい場合、fractions 値が 0.0 より小さいか 1.0 より大きい場合、または fractions が厳密に昇順で指定されていない場合
  - RadialGradientPaint
```
public RadialGradientPaint(Rectangle2D gradientBounds,
                   float[] fractions,
                   Color[] colors,
                   MultipleGradientPaint.CycleMethod cycleMethod)
```
    デフォルトの SRGB カラースペースで RadialGradientPaint を構築します。RadialGradientPaint のグラデーションの円は、指定されたバウンディングボックスで定義されます。
    このコンストラクタを使用すると、次のコードまたはそれと同等のコードをより簡単に表現できます。
```
     double gw = gradientBounds.getWidth();
     double gh = gradientBounds.getHeight();
     double cx = gradientBounds.getCenterX();
     double cy = gradientBounds.getCenterY();
     Point2D center = new Point2D.Double(cx, cy);

     AffineTransform gradientTransform = new AffineTransform();
     gradientTransform.translate(cx, cy);
     gradientTransform.scale(gw / 2, gh / 2);
     gradientTransform.translate(-cx, -cy);

     RadialGradientPaint gp =
         new RadialGradientPaint(center, 1.0f, center,
                                 fractions, colors,
                                 cycleMethod,
                                 ColorSpaceType.SRGB,
                                 gradientTransform);
 
```
    パラメータ:
    gradientBounds - ユーザー空間で、グラデーションのもっとも外側の広がりを定義する円のバウンディングボックス
    fractions - グラデーションに沿った色の分布を指定する、0.0 から 1.0 までの範囲の数値
    colors - グラデーションで使用する色の配列。最初の色は焦点で使用され、最後の色は円周で使用される
    cycleMethod - NO_CYCLE、REFLECT、REPEAT のいずれか
    
    例外:
    
    NullPointerException - gradientBounds が null の場合、fractions 配列が null の場合、colors 配列が null の場合、または cycleMethod が null の場合
    
    IllegalArgumentException - gradientBounds が空の場合、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 パラメータの処理については、createContext メソッドを参照してください。
    
    パラメータ:
    cm - 呼び出し元がピクセルデータを受信するためのもっとも便利な形式を表す推奨される ColorModel、または推奨値がない場合は null。
    deviceBounds - 描画されるグラフィックスプリミティブのデバイス空間でのバウンディングボックス。
    userBounds - 描画されるグラフィックスプリミティブのユーザー空間でのバウンディングボックス。
    transform - ユーザー空間からデバイス空間への AffineTransform。
    hints - コンテキストオブジェクトが描画の選択肢の中から選択するために使用できるヒントのセット。
    
    戻り値:
    カラーパターンを生成するための PaintContext。
    関連項目:
    Paint, PaintContext, ColorModel, Rectangle, Rectangle2D, AffineTransform, RenderingHints
  - getCenterPoint
```
public Point2D getCenterPoint()
```
    放射状グラデーションの中心点のコピーを返します。
    
    戻り値:
    中心点のコピーである Point2D オブジェクト
  - getFocusPoint
```
public Point2D getFocusPoint()
```
    放射状グラデーションの焦点のコピーを返します。放射状グラデーションの作成時に円の半径の外側に焦点が指定された場合、描画では半径内の別の点に色の輪の中心が配置されることがありますが、このメソッドは元の焦点を返します。
    
    戻り値:
    焦点のコピーである Point2D オブジェクト
  - getRadius
```
public float getRadius()
```
    放射状グラデーションを定義する円の半径を返します。
    
    戻り値:
    放射状グラデーションを定義する円の半径

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

クラス RadialGradientPaint

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

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

フィールドのサマリー

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

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

メソッドのサマリー

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

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

コンストラクタの詳細

RadialGradientPaint

RadialGradientPaint

RadialGradientPaint

RadialGradientPaint

RadialGradientPaint

RadialGradientPaint

RadialGradientPaint

RadialGradientPaint

メソッドの詳細

createContext

getCenterPoint

getFocusPoint

getRadius