AlphaComposite (Java Platform SE 7)

java.lang.Object
- java.awt.AlphaComposite

すべての実装されたインタフェース:: Composite

public final class AlphaComposite
extends Object
implements Composite

AlphaComposite クラスは、グラフィックスとイメージの混合や透明化の効果を実現するために、ソース色とデスティネーション色を組み合わせるための基本的なアルファ合成規則を実装します。このクラスで実装される特定の規則は、T. Porter および T. Duff 共著の『Compositing Digital Images』(SIGGRAPH 84, 253 - 259) に記述されている一連の基本的な 12 の規則です。このドキュメントでは、その著書で説明されている定義および概念について、ある程度の知識があることを前提としています。

このクラスは、Porter と Duff によって定義された標準の式を拡張し、係数を 1 つ追加しています。AlphaComposite クラスのインスタンスには、合成式で使用する前に、ソースのピクセルの透明度や範囲を変更できるアルファ値を格納できます。

Porter と Duff の著書で定義された式はすべて、対応するアルファ成分によってあらかじめ乗算された色成分を処理するように定義されています。ColorModel クラスおよび Raster クラスでは、ピクセルデータをあらかじめ乗算された形式でも、乗算されていない形式でも保存できるため、式を適用する前に、すべての入力データをあらかじめ乗算された形式に正規化する必要があり、ピクセル値を格納する前に、すべての結果をデスティネーションによって要求された形式に調整して戻さなければならない可能性があります。

このクラスで定義するのは、純粋な数学的観念における色とアルファ値の合成の式だけです。この式の正確な適用は、データをソースから取得し、デスティネーションに保存する方法によって異なります。詳細は「実装の注意」を参照してください。

Porter と Duff の著書では、合成式の説明で次の係数が使われています。

係数定義
A_s ソースピクセルのアルファ成分
C_s あらかじめ乗算された形式でのソースピクセルの色成分
A_d デスティネーションピクセルのアルファ成分
C_d あらかじめ乗算された形式でのデスティネーションピクセルの色成分
F_s ソースピクセルのうち、出力に関係する部分
F_d デスティネーションピクセルのうち、出力に関係する部分
A_r 結果として得られるアルファ成分
C_r あらかじめ乗算された形式での結果の色成分

係数	定義
A_s	ソースピクセルのアルファ成分
C_s	あらかじめ乗算された形式でのソースピクセルの色成分
A_d	デスティネーションピクセルのアルファ成分
C_d	あらかじめ乗算された形式でのデスティネーションピクセルの色成分
F_s	ソースピクセルのうち、出力に関係する部分
F_d	デスティネーションピクセルのうち、出力に関係する部分
A_r	結果として得られるアルファ成分
C_r	あらかじめ乗算された形式での結果の色成分

以上の係数を使用して、Porter と Duff は合成係数 F_s および F_d を選択して、12 種類の目的の視覚効果を生成する 12 とおりの方法を定義しています。F_s および F_d を決定する式は、視覚効果を指定する 12 の static フィールドの記述で指定します。たとえば、SRC_OVER の記述では、F_s = 1 および F_d = (1-A_s) を指定します。合成係数を決定する一連の式がわかったら、それらを各ピクセルに適用し、次の一連の式を使用して、結果を生成できます。

      F_s = f(A_d)
      F_d = f(A_s)
      A_r = A_s*F_s + A_d*F_d
      C_r = C_s*F_s + C_d*F_d

次の係数を使用して、Porter と Duff の著書の合成式の拡張を説明します。

係数定義
C_sr ソースピクセルの raw 色成分の 1 つ
C_dr デスティネーションピクセルの raw 色成分の 1 つ
A_ac AlphaComposite インスタンスの「特殊」アルファ成分
A_sr ソースピクセルの raw アルファ成分
A_dr デスティネーションピクセルの raw アルファ成分
A_df デスティネーションに保存される最終アルファ成分
C_df デスティネーションに保存される最終 raw 色成分

係数	定義
C_sr	ソースピクセルの raw 色成分の 1 つ
C_dr	デスティネーションピクセルの raw 色成分の 1 つ
A_ac	AlphaComposite インスタンスの「特殊」アルファ成分
A_sr	ソースピクセルの raw アルファ成分
A_dr	デスティネーションピクセルの raw アルファ成分
A_df	デスティネーションに保存される最終アルファ成分
C_df	デスティネーションに保存される最終 raw 色成分

入力の準備

AlphaComposite クラスは、ソースのアルファに適用する追加のアルファ値を定義します。この値は、AlphaComposite のアルファによって raw ソースアルファと raw ソース色の両方を乗算して指定されたアルファを持つピクセルに対して、最初に暗黙的な SRC_IN 規則をソースピクセルに適用しているかのように適用します。これは、Porter と Duff の合成式で使用されるアルファを生成する次のような式になります。

      A_s = A_sr * A_ac

ソース raw 色成分はすべて AlphaCompositeインスタンスのアルファで乗算する必要があります。さらに、ソースがあらかじめ乗算された形式でない場合に、色成分をソースアルファで乗算する必要があります。そのため Porter と Duff 式のソース色成分を生成する式は、ソースピクセルがあらかじめ乗算されているかどうかによって異なります。

      C_s = C_sr * A_sr * A_ac     (ソースがあらかじめ乗算されていない場合)
      C_s = C_sr * A_ac           (ソースがあらかじめ乗算されている場合)

デスティネーションアルファを調整する必要はありません。

      A_d = A_dr

デスティネーションの色成分はあらかじめ乗算された形式でない場合にのみ調整する必要があります。

      C_d = C_dr * A_d    (デスティネーションがあらかじめ乗算されていない場合)
      C_d = C_dr         (デスティネーションがあらかじめ乗算されている場合)

合成式の適用

調整済みの A_s、A_d、C_s、および C_d を標準 Porter と Duff 式で使用して、合成係数 F_s および F_d を計算し、次に結果のあらかじめ乗算されている成分 A_r および C_r を計算します。

結果の準備

結果は、あらかじめ乗算されていないデータを格納するデスティネーションバッファーに戻す場合にのみ、次の式を使用して調整する必要があります。

      A_df = A_r
      C_df = C_r                 (デスティネーションがあらかじめ乗算されている場合)
      C_df = C_r / A_r            (デスティネーションがあらかじめ乗算されていない場合)

結果として得られるアルファがゼロの場合の除算は定義されていないため、その場合の除算は無視して「ゼロで除算」を避け、色成分はすべてゼロのままにしておきます。

パフォーマンス上の制約

パフォーマンス上の理由のため、AlphaComposite クラスによって作成される CompositeContext オブジェクトの compose メソッドに渡す Raster オブジェクトにはあらかじめ乗算されたデータを使用することをお勧めします。ソース Raster またはデスティネーション Raster のどちらかがあらかじめ乗算されていない場合、合成処理の前後に適切な変換を行います。

実装の注意

BufferedImage クラスに挙げられた不透明イメージの一部の種類など、ソースでピクセルのアルファ値を格納していない場合が多くあります。そうしたソースにはすべてのピクセルに 1.0 のアルファを指定します。
さらに、デスティネーションに、このクラスによって実行された合成計算の結果として得られるアルファ値を格納する場所がない場合も多くあります。そのため、そうしたデスティネーションではこのクラスで生成される結果として得られるアルファ値が暗黙的に破棄されます。そうしたデスティネーションでは、格納された色値をあらかじめ乗算されていないものとして扱い、色値を格納してアルファ値を破棄する前に、結果として得られるアルファ値によって結果の色値を除算する必要があります。
結果の精度は、デスティネーションのピクセルの保存方法によって異なります。2、3 から十数の一連の合成処理には少なくとも、デスティネーションとして、色およびアルファ成分あたり最低 8 ビットの領域を提供するイメージ形式が適切です。成分あたりの領域が 8 ビット未満のイメージ形式では、結果の丸め誤差が目立たない 1 つまたは 2 つの合成処理にしか使用できません。色成分を別に格納しないイメージ形式は、すべての種類の半透明合成に適していません。たとえば、BufferedImage.TYPE_BYTE_INDEXED は合成処理のデスティネーションとして使用すべきではありません。限定されたパレットからピクセルを選択して、合成式の結果に合わせる必要があるため、すべての処理で大きな誤差が生じる可能性があるからです。
ほぼすべての形式で、ピクセルは上記の参照式で使われている浮動小数点値ではなく、離散的な整数として格納されます。実装では、整数ピクセル値を 0.0 から 1.0 の範囲の浮動小数点値にスケーリングするか、整数の範囲ですべてを処理する少し変更した式を使用し、参照式に似た結果を生成することもできます。
一般に、整数 0 は浮動小数点値 0.0 と同等とみなされ、整数 2^n-1 (n は表現のビット数) は 1.0 と同等とみなされるように、整数値が浮動小数点値と関連付けられます。8 ビット表現では、0x00 は 0.0 を表し、0xff は 1.0 を表します。
内部実装では一部の式を概算することも、一部の手順を省略して不要な処理を避けることもできます。たとえば、成分あたり 8 ビットの領域を使用するあらかじめ乗算されていないアルファ値を持つ離散整数イメージがあるとします。ほぼ透明な濃い赤の格納される値は次のようになります。
```
    (A, R, G, B) = (0x01, 0xb0, 0x00, 0x00)
```
整数値演算を使用し、この値が SRC モードで、特殊アルファを使用せずに結合されている場合、数値演算の結果は (整数形式で) 次のようになります。
```
    (A, R, G, B) = (0x01, 0x01, 0x00, 0x00)
```
中間値は常にあらかじめ乗算された形式であり、整数値の赤の成分は 0x00 または 0x01 のどちらかのみになります。この結果をあらかじめ乗算されていないデスティネーションに戻そうとする場合、アルファを除算すると、あらかじめ乗算されていない赤の値の選択肢はほとんどありません。この場合、ショートカットなしで、整数スペースで数値演算を実行する実装の最終的なピクセル値は次のようになります。
```
    (A, R, G, B) = (0x01, 0xff, 0x00, 0x00)
```
(0x01 を 0x01 で除算すると 1.0 になり、これは 8 ビット格納形式での値 0xff に等しくなります。)
または、浮動小数点演算を使用する実装では、より正確な結果が生成され、ほとんど丸め誤差のない元のピクセル値に戻ります。あるいは、整数値演算を使用する実装では、浮動小数点スペースで実行した場合に、式は色値の仮想 NOP になるため、無修正のピクセルをデスティネーションに転送でき、すべての数値演算を避けることができます。
これらの実装はすべて同じ式に従おうとしますが、整数と小数点数値演算、および短縮した式と完全な式のさまざまなトレードオフが必要です。そうした違いを相殺するため、あらかじめ乗算された結果の形式が実装とイメージ形式で一致していることのみを期待することがもっとも望ましいと考えられます。この場合、あらかじめ乗算された形式で表された両方の答えが次に等しくなります。
```
    (A, R, G, B) = (0x01, 0x01, 0x00, 0x00)
```
したがって、それらはすべて一致します。
式を単純化する技法によって計算の効率を上げるため、実装によっては、あらかじめ乗算されていないデスティネーションで、0.0 の結果アルファ値が発見された場合に、実行方法を変更することがあります。SRC 規則では、アルファによる除算を取り除くという単純化は、分母 (アルファ) が 0 の場合に有効ではありません。しかし、結果はあらかじめ乗算されている形式で見た場合にのみ正確であることを期待すべきであるため、結果として得られるアルファが 0 の場合は必然的に結果の色成分は関係なく、この場合の正確な動作は期待できません。

関連項目:: Composite, CompositeContext

フィールドのサマリー

フィールド
修飾子と型	フィールドと説明
`static AlphaComposite`	`Clear` 1.0f のアルファによる不透明の CLEAR 規則を実装する `AlphaComposite` オブジェクト。
`static int`	`CLEAR` デスティネーションの色およびアルファの両方がクリアされます (Porter-Duff Clear 規則)。
`static AlphaComposite`	`Dst` 1.0f のアルファによる不透明の DST 規則を実装する `AlphaComposite` オブジェクト。
`static int`	`DST` デスティネーションは変更されません (Porter-Duff Destination 規則)。
`static int`	`DST_ATOP` デスティネーションのソース内部にある部分が、ソースに重ね合わせられ、この結果生成された色でデスティネーションが置き換えられます (Porter-Duff Destination Atop Source 規則)。
`static int`	`DST_IN` デスティネーションのソース内部にある部分でデスティネーションが置き換えられます (Porter-Duff Destination In Source 規則)。
`static int`	`DST_OUT` デスティネーションのソース外部にある部分でデスティネーションが置き換えられます (Porter-Duff Destination Held Out By Source 規則)。
`static int`	`DST_OVER` デスティネーションはソースの上に重ね合わせられ、この結果生成された色でデスティネーションが置き換えられます (Porter-Duff Destination Over Source 規則)。
`static AlphaComposite`	`DstAtop` 1.0f のアルファによる不透明の DST_ATOP 規則を実装する `AlphaComposite` オブジェクト。
`static AlphaComposite`	`DstIn` 1.0f のアルファによる不透明の DST_IN 規則を実装する `AlphaComposite` オブジェクト。
`static AlphaComposite`	`DstOut` 1.0f のアルファによる不透明の DST_OUT 規則を実装する `AlphaComposite` オブジェクト。
`static AlphaComposite`	`DstOver` 1.0f のアルファによる不透明の DST_OVER 規則を実装する `AlphaComposite` オブジェクト。
`static AlphaComposite`	`Src` 1.0f のアルファによる不透明の SRC 規則を実装する `AlphaComposite` オブジェクト。
`static int`	`SRC` ソースがデスティネーションにコピーされます (Porter-Duff Source 規則)。
`static int`	`SRC_ATOP` ソースのデスティネーション内部にある部分が、デスティネーションに重ね合わせられます(Porter-Duff Source Atop Destination 規則)。
`static int`	`SRC_IN` ソースのデスティネーション内部にある部分でデスティネーションが置き換えられます (Porter-Duff Source In Destination 規則)。
`static int`	`SRC_OUT` ソースのデスティネーション外部にある部分でデスティネーションが置き換えられます (Porter-Duff Source Held Out By Destination 規則)。
`static int`	`SRC_OVER` ソースはデスティネーションの上に重ね合わせられます (Porter-Duff Source Over Destination 規則)。
`static AlphaComposite`	`SrcAtop` 1.0f のアルファによる不透明の SRC_ATOP 規則を実装する `AlphaComposite` オブジェクト。
`static AlphaComposite`	`SrcIn` 1.0f のアルファによる不透明の SRC_IN 規則を実装する `AlphaComposite` オブジェクト。
`static AlphaComposite`	`SrcOut` 1.0f のアルファによる不透明の SRC_OUT 規則を実装する `AlphaComposite` オブジェクト。
`static AlphaComposite`	`SrcOver` 1.0f のアルファによる不透明の SRC_OVER 規則を実装する `AlphaComposite` オブジェクト。
`static AlphaComposite`	`Xor` 1.0f のアルファによる不透明の XOR 規則を実装する `AlphaComposite` オブジェクト。
`static int`	`XOR` ソースのデスティネーション外部にある部分が、デスティネーションのソース外部にある部分と混合されます (Porter-Duff Source Xor Destination 規則)。

メソッドのサマリー

メソッド
修飾子と型	メソッドと説明
`CompositeContext`	`createContext(ColorModel srcColorModel, ColorModel dstColorModel, RenderingHints hints)` 合成操作のコンテキストを作成します。
`AlphaComposite`	`derive(float alpha)` 指定されたアルファ値を使用する類似の `AlphaComposite` オブジェクトを返します。
`AlphaComposite`	`derive(int rule)` 指定された合成規則を使用する類似の `AlphaComposite` オブジェクトを返します。
`boolean`	`equals(Object obj)` 指定されたオブジェクトがこの `AlphaComposite` に等しいかどうかを判定します。
`float`	`getAlpha()` この `AlphaComposite` のアルファ値を返します。
`static AlphaComposite`	`getInstance(int rule)` 指定された規則を使用して `AlphaComposite` オブジェクトを作成します。
`static AlphaComposite`	`getInstance(int rule, float alpha)` 指定された規則と、ソースのアルファに掛ける定数アルファを使用して `AlphaComposite` オブジェクトを作成します。
`int`	`getRule()` この `AlphaComposite` の合成規則を返します。
`int`	`hashCode()` この合成のハッシュコードを返します。

クラス java.lang.Object から継承されたメソッド
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

- フィールドの詳細
  - CLEAR
```
public static final int CLEAR
```
    デスティネーションの色およびアルファの両方がクリアされます (Porter-Duff Clear 規則)。ソースとデスティネーションのどちらも入力として使用されません。
    F_s = 0 および F_d = 0 の場合、次のようになります。
```
  A_r = 0
  C_r = 0
```
    関連項目:
    定数フィールド値
  - SRC
```
public static final int SRC
```
    ソースがデスティネーションにコピーされます (Porter-Duff Source 規則)。デスティネーションは入力として使用されません。
    F_s = 1 および F_d = 0 の場合、次のようになります。
```
  A_r = A_s
  C_r = C_s
```
    関連項目:
    定数フィールド値
  - DST
```
public static final int DST
```
    デスティネーションは変更されません (Porter-Duff Destination 規則)。
    F_s = 0 および F_d = 1 の場合、次のようになります。
```
  A_r = A_d
  C_r = C_d
```
    導入されたバージョン:
    
    1.4
    
    関連項目:
    定数フィールド値
  - SRC_OVER
```
public static final int SRC_OVER
```
    ソースはデスティネーションの上に重ね合わせられます (Porter-Duff Source Over Destination 規則)。
    F_s = 1 および F_d = (1-A_s) の場合、次のようになります。
```
  A_r = A_s + A_d*(1-A_s)
  C_r = C_s + C_d*(1-A_s)
```
    関連項目:
    定数フィールド値
  - DST_OVER
```
public static final int DST_OVER
```
    デスティネーションはソースの上に重ね合わせられ、この結果生成された色でデスティネーションが置き換えられます (Porter-Duff Destination Over Source 規則)。
    F_s = (1-A_d) および F_d = 1 の場合、次のようになります。
```
  A_r = A_s*(1-A_d) + A_d
  C_r = C_s*(1-A_d) + C_d
```
    関連項目:
    定数フィールド値
  - SRC_IN
```
public static final int SRC_IN
```
    ソースのデスティネーション内部にある部分でデスティネーションが置き換えられます (Porter-Duff Source In Destination 規則)。
    F_s = A_d、F_d = 0 の場合、次のようになります。
```
  A_r = A_s*A_d
  C_r = C_s*A_d
```
    関連項目:
    定数フィールド値
  - DST_IN
```
public static final int DST_IN
```
    デスティネーションのソース内部にある部分でデスティネーションが置き換えられます (Porter-Duff Destination In Source 規則)。
    F_s = 0、F_d = A_s の場合、次のようになります。
```
  A_r = A_d*A_s
  C_r = C_d*A_s
```
    関連項目:
    定数フィールド値
  - SRC_OUT
```
public static final int SRC_OUT
```
    ソースのデスティネーション外部にある部分でデスティネーションが置き換えられます (Porter-Duff Source Held Out By Destination 規則)。
    F_s = (1-A_d) および F_d = 0 の場合、次のようになります。
```
  A_r = A_s*(1-A_d)
  C_r = C_s*(1-A_d)
```
    関連項目:
    定数フィールド値
  - DST_OUT
```
public static final int DST_OUT
```
    デスティネーションのソース外部にある部分でデスティネーションが置き換えられます (Porter-Duff Destination Held Out By Source 規則)。
    F_s = 0 および F_d = (1-A_s) の場合、次のようになります。
```
  A_r = A_d*(1-A_s)
  C_r = C_d*(1-A_s)
```
    関連項目:
    定数フィールド値
  - SRC_ATOP
```
public static final int SRC_ATOP
```
    ソースのデスティネーション内部にある部分が、デスティネーションに重ね合わせられます(Porter-Duff Source Atop Destination 規則)。
    F_s = A_d、F_d = (1-A_s) の場合、次のようになります。
```
  A_r = A_s*A_d + A_d*(1-A_s) = A_d
  C_r = C_s*A_d + C_d*(1-A_s)
```
    導入されたバージョン:
    
    1.4
    
    関連項目:
    定数フィールド値
  - DST_ATOP
```
public static final int DST_ATOP
```
    デスティネーションのソース内部にある部分が、ソースに重ね合わせられ、この結果生成された色でデスティネーションが置き換えられます (Porter-Duff Destination Atop Source 規則)。
    F_s = (1-A_d)、F_d = A_s の場合、次のようになります。
```
  A_r = A_s*(1-A_d) + A_d*A_s = A_s
  C_r = C_s*(1-A_d) + C_d*A_s
```
    導入されたバージョン:
    
    1.4
    
    関連項目:
    定数フィールド値
  - XOR
```
public static final int XOR
```
    ソースのデスティネーション外部にある部分が、デスティネーションのソース外部にある部分と混合されます (Porter-Duff Source Xor Destination 規則)。
    F_s = (1-A_d)、F_d = (1-A_s) の場合、次のようになります。
```
  A_r = A_s*(1-A_d) + A_d*(1-A_s)
  C_r = C_s*(1-A_d) + C_d*(1-A_s)
```
    導入されたバージョン:
    
    1.4
    
    関連項目:
    定数フィールド値
  - Clear
```
public static final AlphaComposite Clear
```
    1.0f のアルファによる不透明の CLEAR 規則を実装する AlphaComposite オブジェクト。
    
    関連項目:
    CLEAR
  - Src
```
public static final AlphaComposite Src
```
    1.0f のアルファによる不透明の SRC 規則を実装する AlphaComposite オブジェクト。
    
    関連項目:
    SRC
  - Dst
```
public static final AlphaComposite Dst
```
    1.0f のアルファによる不透明の DST 規則を実装する AlphaComposite オブジェクト。
    
    導入されたバージョン:
    
    1.4
    
    関連項目:
    DST
  - SrcOver
```
public static final AlphaComposite SrcOver
```
    1.0f のアルファによる不透明の SRC_OVER 規則を実装する AlphaComposite オブジェクト。
    
    関連項目:
    SRC_OVER
  - DstOver
```
public static final AlphaComposite DstOver
```
    1.0f のアルファによる不透明の DST_OVER 規則を実装する AlphaComposite オブジェクト。
    
    関連項目:
    DST_OVER
  - SrcIn
```
public static final AlphaComposite SrcIn
```
    1.0f のアルファによる不透明の SRC_IN 規則を実装する AlphaComposite オブジェクト。
    
    関連項目:
    SRC_IN
  - DstIn
```
public static final AlphaComposite DstIn
```
    1.0f のアルファによる不透明の DST_IN 規則を実装する AlphaComposite オブジェクト。
    
    関連項目:
    DST_IN
  - SrcOut
```
public static final AlphaComposite SrcOut
```
    1.0f のアルファによる不透明の SRC_OUT 規則を実装する AlphaComposite オブジェクト。
    
    関連項目:
    SRC_OUT
  - DstOut
```
public static final AlphaComposite DstOut
```
    1.0f のアルファによる不透明の DST_OUT 規則を実装する AlphaComposite オブジェクト。
    
    関連項目:
    DST_OUT
  - SrcAtop
```
public static final AlphaComposite SrcAtop
```
    1.0f のアルファによる不透明の SRC_ATOP 規則を実装する AlphaComposite オブジェクト。
    
    導入されたバージョン:
    
    1.4
    
    関連項目:
    SRC_ATOP
  - DstAtop
```
public static final AlphaComposite DstAtop
```
    1.0f のアルファによる不透明の DST_ATOP 規則を実装する AlphaComposite オブジェクト。
    
    導入されたバージョン:
    
    1.4
    
    関連項目:
    DST_ATOP
  - Xor
```
public static final AlphaComposite Xor
```
    1.0f のアルファによる不透明の XOR 規則を実装する AlphaComposite オブジェクト。
    
    導入されたバージョン:
    
    1.4
    
    関連項目:
    XOR
- メソッドの詳細
  - getInstance
```
public static AlphaComposite getInstance(int rule)
```
    指定された規則を使用して AlphaComposite オブジェクトを作成します。
    
    パラメータ:
    rule - 合成規則
    
    例外:
    
    IllegalArgumentException - rule が CLEAR、SRC、DST、SRC_OVER、DST_OVER、SRC_IN、DST_IN、SRC_OUT、DST_OUT、SRC_ATOP、DST_ATOP、XOR のいずれでもない場合
  - getInstance
```
public static AlphaComposite getInstance(int rule,
                         float alpha)
```
    指定された規則と、ソースのアルファに掛ける定数アルファを使用して AlphaComposite オブジェクトを作成します。デスティネーションと合成される前に、ソースは指定されたアルファで乗算されます。
    
    パラメータ:
    rule - 合成規則
    alpha - ソースのアルファに掛ける定数アルファ。alpha は、[0.0, 1.0] の範囲 (両端を含む) の浮動小数点数値である必要があります。
    
    例外:
    
    IllegalArgumentException - alpha が 0.0 未満または 1.0 より大きいか、または rule が次のどれでもない場合。CLEAR、SRC、DST、SRC_OVER、DST_OVER、SRC_IN、DST_IN、SRC_OUT、DST_OUT、SRC_ATOP、DST_ATOP、XOR
  - createContext
```
public CompositeContext createContext(ColorModel srcColorModel,
                             ColorModel dstColorModel,
                             RenderingHints hints)
```
    合成操作のコンテキストを作成します。コンテキストには、合成操作を実行する場合の状態が設定されます。
    
    定義:
    
    createContext、インタフェース: Composite
    
    パラメータ:
    srcColorModel - ソースの ColorModel
    dstColorModel - デスティネーションの ColorModel
    hints - コンテキストオブジェクトが描画の選択肢の中から選択するために使用するヒント
    
    戻り値:
    合成操作を実行するために使用される CompositeContext オブジェクト
  - getAlpha
```
public float getAlpha()
```
    この AlphaComposite のアルファ値を返します。この AlphaComposite がアルファ値を持たない場合は、1.0 が返されます。
    
    戻り値:
    この AlphaComposite のアルファ値
  - getRule
```
public int getRule()
```
    この AlphaComposite の合成規則を返します。
    
    戻り値:
    この AlphaComposite の合成規則
  - derive
```
public AlphaComposite derive(int rule)
```
    指定された合成規則を使用する類似の AlphaComposite オブジェクトを返します。指定された合成規則がこのオブジェクトですでに使用されている場合は、このオブジェクトが返されます。
    
    パラメータ:
    rule - 合成規則
    
    戻り値:
    指定された合成規則を使用する、このオブジェクトから派生した AlphaComposite オブジェクト
    
    例外:
    
    IllegalArgumentException - rule が CLEAR、SRC、DST、SRC_OVER、DST_OVER、SRC_IN、DST_IN、SRC_OUT、DST_OUT、SRC_ATOP、DST_ATOP、XOR のいずれでもない場合
    導入されたバージョン:
    
    1.6
  - derive
```
public AlphaComposite derive(float alpha)
```
    指定されたアルファ値を使用する類似の AlphaComposite オブジェクトを返します。指定されたアルファ値がこのオブジェクトですでに使用されている場合は、このオブジェクトが返されます。
    
    パラメータ:
    alpha - ソースのアルファに掛ける定数アルファ。alpha は、[0.0, 1.0] の範囲 (両端を含む) の浮動小数点数値である必要があります。
    
    戻り値:
    指定されたアルファ値を使用する、このオブジェクトから派生した AlphaComposite オブジェクト
    
    例外:
    
    IllegalArgumentException - alpha が 0.0 未満か 1.0 より大きい場合
    導入されたバージョン:
    
    1.6
  - hashCode
```
public int hashCode()
```
    この合成のハッシュコードを返します。
    
    オーバーライド:
    
    hashCode、クラス: Object
    
    戻り値:
    この合成のハッシュコード
    関連項目:
    Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)
  - equals
```
public boolean equals(Object obj)
```
    指定されたオブジェクトがこの AlphaComposite に等しいかどうかを判定します。
    引数が null でなく、このオブジェクトと同じ合成規則およびアルファ値を使用する AlphaComposite オブジェクトである場合のみ、結果が true になります。
    
    オーバーライド:
    
    equals、クラス: Object
    
    パラメータ:
    obj - 等しいかどうかが判定される Object
    
    戻り値:
    obj がこの AlphaComposite と等しい場合は true、そうでない場合は false
    関連項目:
    Object.hashCode(), HashMap

バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.

クラス AlphaComposite

入力の準備

合成式の適用

結果の準備

パフォーマンス上の制約

実装の注意

フィールドのサマリー

メソッドのサマリー

クラス java.lang.Object から継承されたメソッド

フィールドの詳細

CLEAR

SRC

DST

SRC_OVER

DST_OVER

SRC_IN

DST_IN

SRC_OUT

DST_OUT

SRC_ATOP

DST_ATOP

XOR

Clear

Src

Dst

SrcOver

DstOver

SrcIn

DstIn

SrcOut

DstOut

SrcAtop

DstAtop

Xor

メソッドの詳細

getInstance

getInstance

createContext

getAlpha

getRule

derive

derive

hashCode

equals