ID3D10Device::OMSetBlendState
出力結合ステージのブレンディング ステートを設定します。
void
OMSetBlendState(
ID3D10BlendState *pBlendState,
const FLOAT BlendFactor[4],
UINT SampleMask
);
パラメータ
- pBlendState
ブレンディング ステート インターフェイスへのポインターです (「ID3D10BlendState」を参照してください)。NULL を渡すと、デフォルトのブレンディング ステートが暗黙的に指定されます。詳細については、「解説」を参照してください。 - BlendFactor
ブレンディング係数の配列です。RGBA の成分ごとに 1 つずつあります。これには、D3D10_BLEND_BLEND_FACTOR オプションを指定したブレンディング ステート オブジェクトが必要です。 - SampleMask
32 ビットのサンプル カバレッジです。既定値は 0xffffffff です。「解説」を参照してください。
戻り値
返されるものはありません。
解説
ブレンディング ステートは、出力結合ステージで 2 つのピクセル値のブレンド方法の決定に使用されます。一般にこの 2 つの値は、現在のピクセル値と既に出力レンダー ターゲットにあるピクセル値です。ブレンディング処理を使用して、2 つのピクセル値の取得元と数学的な結合方法を制御します。
ブレンドステート インターフェイスを作成するには、ID3D10Device::CreateBlendState を呼び出します。
ブレンディング ステート インターフェイスに NULL を渡すと、ランタイムに対してデフォルトのブレンディング ステートを設定するように指定します。次の表は、デフォルトのブレンディング パラメーターを示しています。
| ステート | デフォルト値 |
|---|---|
| AlphaToCoverageEnable | FALSE |
| BlendEnable | FALSE[8] |
| SrcBlend | D3D10_BLEND_ONE |
| DstBlend | D3D10_BLEND_ZERO |
| BlendOp | D3D10_BLEND_OP_ADD |
| SrcBlendAlpha | D3D10_BLEND_ONE |
| DstBlendAlpha | D3D10_BLEND_ZERO |
| BlendOpAlpha | D3D10_BLEND_OP_ADD |
| RenderTargetWriteMask[8] | D3D10_COLOR_WRITE_ENABLE_ALL[8] |
サンプル マスクによって、すべてのアクティブなレンダー ターゲットでどのサンプルが更新されるかが判別されます。サンプル マスクからマルチサンプル レンダー ターゲットへのビットのマッピングは、個々のアプリケーションで行う必要があります。サンプル マスクは、マルチサンプリングが有効かどうかに関わることなく常に適用され、アプリケーションでマルチサンプル レンダー ターゲットを使用するかどうかには依存しません。
このメソッドは、渡されたインターフェイスの参照数を保持しません。そのため、現在デバイスで使用中のインターフェイスが解放されないようにアプリケーションで配慮する必要があります。
要件
ヘッダー: D3D10.h 宣言
ライブラリ: D3D10.lib 内容