AlphaComposite (Java Platform SE 8)

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     (if source is not premultiplied)
      C_s = C_sr * A_ac           (if source is premultiplied)

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

      A_d = A_dr

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

      C_d = C_dr * A_d    (if destination is not premultiplied)
      C_d = C_dr         (if destination is premultiplied)

合成式の適用

調整済みの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                 (if dest is premultiplied)
      C_df = C_r / A_r            (if dest is not premultiplied)

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

パフォーマンス上の制約

パフォーマンス上の理由のため、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ルール)。

メソッドのサマリー

すべてのメソッド staticメソッドインスタンス・メソッド具象メソッド
修飾子と型	メソッド	説明
`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
```
@Native
public static final int CLEAR
```
    デスティネーションの色およびアルファの両方がクリアされます(Porter-Duff Clearルール)。ソースとデスティネーションのどちらも入力として使用されません。
    F_s = 0およびF_d = 0の場合、次のようになります。
```
  A_r = 0
  C_r = 0
```
    関連項目:
    
    定数フィールド値
  - SRC
```
@Native
public static final int SRC
```
    ソースがデスティネーションにコピーされます(Porter-Duff Sourceルール)。デスティネーションは入力として使用されません。
    F_s = 1およびF_d = 0の場合、次のようになります。
```
  A_r = A_s
  C_r = C_s
```
    関連項目:
    
    定数フィールド値
  - DST
```
@Native
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
```
@Native
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
```
@Native
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
```
@Native
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
```
@Native
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
```
@Native
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
```
@Native
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
```
@Native
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
```
@Native
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
```
@Native
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, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。

クラス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