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を持つ。

バージョン:

1997年2月10日

関連項目:

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