モジュール java.desktop
パッケージ java.awt

インタフェースComposite

  • 既知のすべての実装クラス:
    AlphaComposite
    public interface Composite
    Compositeインタフェースは、CompositeContextとともに、基本となるグラフィックス領域に描画プリミティブを構成するためのメソッドを定義します。 Compositeは、Graphics2Dコンテキストで設定されたあと、事前定義されているルールに従って、すでに描画されている色と現在描画中の形状、テキスト、またはイメージを結合します。 このインタフェースを実装するクラスは、そのルールと、特定の操作のコンテキストを作成するためのメソッドを提供します。 CompositeContextは、合成操作によって使用される環境であり、合成操作の開始前にGraphics2Dによって作成されます。 CompositeContextには、合成操作で必要なプライベート情報とリソースが含まれます。 CompositeContextが必要なくなったら、合成操作に割り当てられているリソースを再生するためにGraphics2Dオブジェクトによって破棄されます。

    Compositeを実装するクラスのインスタンスは不変である必要があります。その理由は、setCompositeメソッドを使って属性として設定されたとき、あるいはGraphics2Dオブジェクトが複製されたときには、Graphics2Dはこれらのオブジェクトを複製しないからです。 これは、Graphics2Dのコンテキストで設定されたあとでCompositeオブジェクトが変更されると、Graphics2Dの描画の動作が不安定になることがあり、これを防ぐためです。

    このインタフェースを使用すると、ターゲット・デバイスまたはイメージ上のピクセルの内容が不特定のコードに対してオープンになります。このため、スクリーン・デバイスに直接描画する場合、このインタフェースを実装するカスタム・オブジェクトの使用は、readDisplayPixels AWTPermissionによって制御されます。 Componentから取得されたGraphics2DのsetCompositeメソッドにそのようなカスタム・オブジェクトが渡されるときは、アクセス権がチェックされます。

    関連項目:
    AlphaComposite, CompositeContext, Graphics2D.setComposite(java.awt.Composite)

    • メソッドの詳細

      • createContext

        CompositeContext createContext​(ColorModel srcColorModel,
                               ColorModel dstColorModel,
                               RenderingHints hints)
        合成操作を実行するのに使用される状態を格納するコンテキストを作成します。 マルチ・スレッド環境では、1つのCompositeオブジェクトに対して同時に複数のコンテキストが存在することがあります。
        パラメータ:
        srcColorModel - ソースのColorModel
        dstColorModel - デスティネーションのColorModel
        hints - コンテキスト・オブジェクトが描画の選択肢の中から選択するために使用するヒント
        戻り値:
        合成操作を実行するために使用されるCompositeContextオブジェクト