java.awt

クラス GradientPaint

java.lang.Object

java.awt.GradientPaint

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

Paint, Transparency

public class GradientPaint
extends Object
implements Paint

GradientPaint クラスは、Shape をカラーの線形グラデーションパターンで塗りつぶす方法を提供します。 Color C1 を持つ Point P1、および Color C2 を持つ Point P2 がユーザー空間で指定されると、P1 と P2 を結ぶ線上の Color が C1 から C2 へと徐々に変化します。P1 と P2 を結ぶ線の延長線上にない点 P は、P1 と P2 を結ぶ線の延長線上にある P の垂直の投影である点 P' の色を持ちます。P1、P2 セグメントの外側にある延長線上の点は、次の 2 つの方法のいずれかで色を付けることができます。

• グラデーションが循環式の場合、P1 と P2 を結ぶ線の延長線上にある点は、C1 と C2 の色を循環する。
• グラデーションが非循環式の場合、セグメントの P1 側の点は一定の Color C1 を持ち、セグメントの P2 側の点は一定の Color C2 を持つ。

関連項目:

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

フィールドのサマリー

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

BITMASK, OPAQUE, TRANSLUCENT

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

コンストラクタ

コンストラクタと説明
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) boolean パラメータに応じて、循環式または非循環式のどちらかの GradientPaint オブジェクトを構築します。
GradientPaint(Point2D pt1, Color color1, Point2D pt2, Color color2) 単純な非循環式の GradientPaint オブジェクトを構築します。
GradientPaint(Point2D pt1, Color color1, Point2D pt2, Color color2, boolean cyclic) boolean パラメータに応じて、循環式または非循環式のどちらかの GradientPaint オブジェクトを構築します。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
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() 2 番目の色を固定する点 P2 のコピーを返します。
int	getTransparency() この GradientPaint の透明度モードを返します。
boolean	isCyclic() グラデーションが C1 と C2 の 2 色を繰り返し循環する場合は true を返します。

クラス 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 - 最初に指定された Point の Color

x2 - ユーザー空間内の 2 番目に指定された Point の x 座標

y2 - ユーザー空間内の 2 番目に指定された Point の y 座標

color2 - 2 番目に指定された Point の Color

例外:

NullPointerException - いずれか 1 つのカラーが null の場合

GradientPaint

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

単純な非循環式の GradientPaint オブジェクトを構築します。

パラメータ:

pt1 - ユーザー空間内の最初に指定された Point

color1 - 最初に指定された Point の Color

pt2 - ユーザー空間内の 2 番目に指定された Point

color2 - 2 番目に指定された Point の Color

例外:

NullPointerException - いずれか 1 つの色または点が null である場合

GradientPaint

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

boolean パラメータに応じて、循環式または非循環式のどちらかの GradientPaint オブジェクトを構築します。

パラメータ:

x1 - ユーザー空間内の最初に指定された Point の x 座標

y1 - ユーザー空間内の最初に指定された Point の y 座標

color1 - 最初に指定された Point の Color

x2 - ユーザー空間内の 2 番目に指定された Point の x 座標

y2 - ユーザー空間内の 2 番目に指定された Point の y 座標

color2 - 2 番目に指定された Point の Color

cyclic - グラデーションパターンが 2 色を繰り返し循環する場合は true、それ以外の場合は false

GradientPaint

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

boolean パラメータに応じて、循環式または非循環式のどちらかの GradientPaint オブジェクトを構築します。

パラメータ:

pt1 - ユーザー空間内の最初に指定された Point

color1 - 最初に指定された Point の Color

pt2 - ユーザー空間内の 2 番目に指定された Point

color2 - 2 番目に指定された Point の Color

cyclic - グラデーションパターンが 2 色を繰り返し循環する場合は true、それ以外の場合は false

例外:

NullPointerException - いずれか 1 つの色または点が null である場合

メソッドの詳細

getPoint1

public Point2D getPoint1()

最初の色を固定する点 P1 のコピーを返します。

戻り値:

この GradientPaint の最初の色を固定する点のコピーを表す Point2D オブジェクト。

getColor1

public Color getColor1()

点 P1 によって固定された色 C1 を返します。

戻り値:

P1 によって固定された色を表す Color オブジェクト。

getPoint2

public Point2D getPoint2()

2 番目の色を固定する点 P2 のコピーを返します。

戻り値:

この GradientPaint の 2 番目の色を固定する点のコピーを表す Point2D オブジェクト。

getColor2

public Color getColor2()

点 P2 によって固定された色 C2 を返します。

戻り値:

P2 によって固定された色を表す Color オブジェクト。

isCyclic

public boolean isCyclic()

グラデーションが C1 と C2 の 2 色を繰り返し循環する場合は true を返します。

戻り値:

グラデーションが 2 色を繰り返し循環する場合は true、そうでない場合は false。

createContext

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

カラーの線形グラデーションパターンを生成するために使用される PaintContext を作成して返します。null パラメータの処理については、Paint インタフェース内のメソッドの specification を参照してください。

定義:

createContext、インタフェース: Paint

パラメータ:

cm - 呼び出し元がピクセルデータを受信するためのもっとも便利な形式を表す推奨される ColorModel、または推奨値がない場合は null。

deviceBounds - 描画されるグラフィックスプリミティブのデバイス空間でのバウンディングボックス。

userBounds - 描画されるグラフィックスプリミティブのユーザー空間でのバウンディングボックス。

xform - ユーザー空間からデバイス空間への AffineTransform。

hints - コンテキストオブジェクトが描画の選択肢の中から選択するために使用できるヒントのセット。

戻り値:

カラーパターンを生成するための PaintContext。

関連項目:

Paint, PaintContext, ColorModel, Rectangle, Rectangle2D, AffineTransform, RenderingHints

getTransparency

public int getTransparency()

この GradientPaint の透明度モードを返します。

定義:

getTransparency、インタフェース: Transparency

戻り値:

この GradientPaint オブジェクトの透明度モードを表す整数値。

関連項目:

Transparency