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)

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
CompositeContext	createContext(ColorModel srcColorModel, ColorModel dstColorModel, RenderingHints hints) 合成操作を実行するのに使用される状態を格納するコンテキストを作成します。

メソッドの詳細

createContext

CompositeContext createContext(ColorModel srcColorModel,
                             ColorModel dstColorModel,
                             RenderingHints hints)

合成操作を実行するのに使用される状態を格納するコンテキストを作成します。マルチスレッド環境では、1 つの Composite オブジェクトに対して同時に複数のコンテキストが存在することがあります。

パラメータ:

srcColorModel - ソースの ColorModel

dstColorModel - デスティネーションの ColorModel

hints - コンテキストオブジェクトが描画の選択肢の中から選択するために使用するヒント

戻り値:

合成操作を実行するために使用される CompositeContext オブジェクト