モジュール 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メソッドにそのようなカスタム・オブジェクトが渡されるときは、アクセス権がチェックされます。

関連項目: