JavaTM Platform
Standard Ed. 6

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 つの方法のいずれかで色を付けることができます。

関連項目:
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)
          カラーパターンを生成するために使用されるコンテキストを作成して返します。
 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 - 最初に指定された PointColor
x2 - ユーザー空間で 2 番目に指定された Point の x 座標
y2 - ユーザー空間で 2 番目に指定された Point の y 座標
color2 - 2 番目に指定された PointColor
例外:
NullPointerException - いずれか 1 つのカラーが null の場合

GradientPaint

public GradientPaint(Point2D pt1,
                     Color color1,
                     Point2D pt2,
                     Color color2)
シンプルな非循環式の GradientPaint オブジェクトを構築します。

パラメータ:
pt1 - ユーザー空間で最初に指定された Point
color1 - 最初に指定された PointColor
pt2 - ユーザー空間で 2 番目に指定された Point
color2 - 2 番目に指定された PointColor
例外:
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 - 最初に指定された PointColor
x2 - ユーザー空間で 2 番目に指定された Point の x 座標
y2 - ユーザー空間で 2 番目に指定された Point の y 座標
color2 - 2 番目に指定された PointColor
cyclic - グラデーションパターンが 2 色を繰り返し循環する場合は true、そうでない場合は false

GradientPaint

public GradientPaint(Point2D pt1,
                     Color color1,
                     Point2D pt2,
                     Color color2,
                     boolean cyclic)
boolean パラメータに応じて、循環式または非循環式の GradientPaint オブジェクトを構築します。

パラメータ:
pt1 - ユーザー空間で最初に指定された Point
color1 - 最初に指定された PointColor
pt2 - ユーザー空間で 2 番目に指定された Point
color2 - 2 番目に指定された PointColor
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)
カラーパターンを生成するために使用されるコンテキストを作成して返します。

定義:
インタフェース Paint 内の createContext
パラメータ:
cm - Paint データを受け取る ColorModel。これは単にヒントとして使用される
deviceBounds - 描画されるグラフィックスプリミティブの デバイス空間でのバウンディングボックス
userBounds - 描画されるグラフィックスプリミティブの ユーザー空間でのバウンディングボックス
xform - ユーザー空間からデバイス空間への AffineTransform
hints - コンテキストオブジェクトが描画の選択肢を 選択するときに使用するヒント
戻り値:
カラーパターンを生成する PaintContext
関連項目:
PaintContext

getTransparency

public int getTransparency()
この GradientPaint の透明度モードを返します。

定義:
インタフェース Transparency 内の getTransparency
戻り値:
この GradientPaint オブジェクトの 透明度モードを表す整数値
関連項目:
Transparency

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。