モジュール java.desktop
パッケージ 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({"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