DrvAlphaBlend 関数 (winddi.h)

[アーティクル]
08/27/2023

DrvAlphaBlend 関数は、アルファブレンドを使用したビットブロック転送機能を提供します。

構文

BOOL DrvAlphaBlend(
  [in, out]      SURFOBJ  *psoDest,
  [in]           SURFOBJ  *psoSrc,
  [in]           CLIPOBJ  *pco,
  [in, optional] XLATEOBJ *pxlo,
  [in]           RECTL    *prclDest,
  [in]           RECTL    *prclSrc,
  [in]           BLENDOBJ *pBlendObj
);

パラメーター

[in, out] psoDest

描画するサーフェスを識別する SURFOBJ 構造体へのポインター。

[in] psoSrc

ソースサーフェスを識別する SURFOBJ 構造体へのポインター。

[in] pco

CLIPOBJ 構造体へのポインター。 CLIPOBJ_Xxx サービスルーチンは、クリップ領域を一連の四角形として列挙するために提供されます。この列挙は、変更される宛先の領域を制限します。可能な限り、GDI は関連するクリッピングを簡略化します。ただし、 DrvBitBlt とは異なり、出力のクリッピングで丸めエラーが発生しないように、 DrvAlphaBlend が 1 つの四角形で呼び出される場合があります。

[in, optional] pxlo

ソースサーフェスとターゲットサーフェスの間でカラーインデックスを変換する方法を指定する XLATEOBJ 構造体へのポインター。 pxlo が NULL の場合、変換は必要ありません。

ソースサーフェスがパレットで管理されている場合、その色は RGB カラー値の参照テーブルへのインデックスによって表されます。この場合、XLATEOBJ に対して変換ベクトルを照会できます。これにより、デバイスドライバーはソースインデックスを変換先のカラーインデックスにすばやく変換できます。

たとえば、ソースが RGB であるが、コピー先がパレットで管理されている場合など、状況はより複雑になります。この場合、各ソース RGB 値に最も近い一致がターゲットパレットで見つかる必要があります。ドライバーは、 XLATEOBJ_iXlate サービスルーチンを呼び出して、この一致操作を実行できます。

[in] prclDest

変更する四角形領域を定義する RECTL 構造体へのポインター。この四角形は、変換先サーフェスの座標系で指定され、左上と右下の 2 つの点で定義されます。四角形を定義する 2 つの点は、常に適切に並べ替えられます。四角形は右下の排他的です。つまり、その下端と右端はブレンドの一部ではありません。

指定した四角形がターゲットサーフェスに張り出す可能性があるため、ピクセルを書き込むときに適切なクリッピングを行うには、ドライバーが注意する必要があります。

DrvAlphaBlend は、空の変換先の四角形で呼び出されることはありません。

[in] prclSrc

コピーする領域を定義する RECTL 構造体へのポインター。この四角形は、ソースサーフェスの座標系で指定され、左上と右下の 2 つの点で定義されます。四角形を定義する 2 つの点は、常に適切に並べ替えられます。四角形は右下の排他的です。つまり、その下端と右端はブレンドの一部ではありません。

ソースの四角形がソースサーフェスの境界を超えることはなく、ソースサーフェスがオーバーハングすることはありません。

DrvAlphaBlend は、空のソース四角形で呼び出されることはありません。

マッピングは、 prclSrc と prclDest によって定義されます。 prclDest および prclSrc で指定された点は、ピクセルの中心に対応する整数座標にあります。このような 2 つの点で定義された四角形は、指定された点を座標とする 2 つの頂点を持つ幾何学的な四角形と見なされますが、各座標から 0.5 が減算されます。 (POINTL 構造体は、これらの小数座標頂点を指定するための短縮表記です)。

[in] pBlendObj

ソースサーフェスとターゲットサーフェスの間で実行するブレンド操作を記述する BLENDOBJ 構造体へのポインター。この構造体は BLENDFUNCTION 構造体のラッパーであり、XLATEOBJ で使用できない必要なソースと宛先の形式情報が含まれます。 BLENDFUNCTION 構造体は、Microsoft Windows SDKドキュメントで定義されています。そのメンバーは次のように定義されます。

BlendOp は、実行するブレンド操作を定義します。現在、この値はAC_SRC_OVERする必要があります。つまり、ソースビットマップは、ソースピクセルのアルファ値に基づいてコピー先ビットマップ上に配置されます。このブレンド操作で処理する必要があるケースは 3 つあります。これらは、「解説」セクションで説明されています。

BlendFlags は予約されており、現在は 0 に設定されています。

SourceConstantAlpha は、ソースサーフェス全体に適用する定数ブレンド係数を定義します。この値は [0,255] の範囲内で、0 は完全に透明で、255 は完全に不透明です。

AlphaFormat は、サーフェスにアルファチャネルがあると見なされるかどうかを定義します。このメンバーは、必要に応じて次の値に設定できます。

AC_SRC_ALPHA

ソースサーフェスは、事前乗算されたアルファ 32bpp "BGRA" 形式であると見なすことができます。つまり、サーフェスタイプはBMF_32BPPされ、パレットタイプはBI_RGB。アルファ成分は[0,255]の範囲の整数で、0は完全に透明で、255は完全に不透明です。

戻り値

DrvAlphaBlend は成功すると TRUE を 返します。それ以外の場合は、エラーを報告し、 FALSE を返します。

注釈

ドライバーは、次のサーフェス間のアルファブレンドを使用してビットブロック転送をサポートできます。

1 つのデバイス管理サーフェスから別のデバイス管理サーフェスへ。
1 つの GDI マネージド標準形式ビットマップから、別の GDI マネージド標準形式ビットマップへ。
1 つのデバイスで管理されたサーフェスから GDI で管理されるサーフェスへ、またはその逆も同様です。

ドライバーは、EngAlphaBlend への呼び出しをパントできます。

ドライバーは、同じサーフェス上に重複するソースと宛先の四角形で呼び出されることはありません。

AC_SRC_OVER ブレンド関数で考えられる 3 つのケースは次のとおりです。

ソースビットマップにはピクセルごとのアルファ (AC_SRC_ALPHAは設定されていません) がないため、次のように SourceConstantAlpha で指定された一定のソースアルファ値に基づいて、ブレンドがピクセルのカラーチャネルに適用されます。

Dst.Red = Round(((Src.Red * SourceConstantAlpha) + 
    ((255 − SourceConstantAlpha) * Dst.Red)) / 255);
Dst.Green = Round(((Src.Green * SourceConstantAlpha) + 
    ((255 − SourceConstantAlpha) * Dst.Green)) / 255);
Dst.Blue = Round(((Src.Blue * SourceConstantAlpha) + 
    ((255 − SourceConstantAlpha) * Dst.Blue)) / 255);
/* Do the next computation only if the destination bitmap 
    has an alpha channel. */
Dst.Alpha = Round(((Src.Alpha * SourceConstantAlpha) + 
    ((255 − SourceConstantAlpha) * Dst.Alpha)) / 255);

ソースビットマップにはピクセル単位のアルファ値があります (AC_SRC_ALPHAが設定されています)、 SourceConstantAlpha は使用されません (255 に設定されています)。ブレンドは次のように計算されます。

Dst.Red = Src.Red + 
    Round(((255 − Src.Alpha) * Dst.Red) / 255);
Dst.Green = Src.Green + 
    Round(((255 − Src.Alpha) * Dst.Green) / 255);
Dst.Blue = Src.Blue + 
    Round(((255 − Src.Alpha) * Dst.Blue) / 255);
/* Do the next computation only if the destination bitmap 
    has an alpha channel. */
Dst.Alpha = Src.Alpha + 
    Round(((255 − Src.Alpha) * Dst.Alpha) / 255);

ソースビットマップにはピクセル単位のアルファ値があります (AC_SRC_ALPHAが設定されています)、 SourceConstantAlpha が使用されます (255 に設定されていません)。ブレンドは次のように計算されます。

Temp.Red = Round((Src.Red * SourceConstantAlpha) / 255);
Temp.Green = Round((Src.Green * SourceConstantAlpha) / 255);
Temp.Blue = Round((Src.Blue * SourceConstantAlpha) / 255);
/* The next computation must be done even if the 
    destination bitmap does not have an alpha channel. */
Temp.Alpha = Round((Src.Alpha * SourceConstantAlpha) / 255);
 
/* Note that the following equations use the just-computed 
   Temp.Alpha value: */
Dst.Red = Temp.Red + 
    Round(((255 − Temp.Alpha) * Dst.Red) / 255);
Dst.Green = Temp.Green + 
    Round(((255 − Temp.Alpha) * Dst.Green) / 255);
Dst.Blue = Temp.Blue + 
    Round(((255 − Temp.Alpha) * Dst.Blue) / 255);
/* Do the next computation only if the destination bitmap 
    has an alpha channel.  */
Dst.Alpha = Temp.Alpha + 
    Round(((255 − Temp.Alpha) * Dst.Alpha) / 255);

Round(x) 関数は、次のように計算された最も近い整数に丸められます。

Trunc(x + 0.5);

DrvAlphaBlend は、必要に応じてグラフィックスドライバーに実装できます。ソースサーフェスとターゲットサーフェスが同じ形式でアルファチャネルが含まれていないブレンドなど、いくつかの種類のアルファブレンドを処理するために提供できます。

ハードウェア実装では、ブレンド操作で浮動小数点または固定ポイントを使用できます。互換性テストでは、結果の数値エラーが考慮されます。最大許容エラーの詳細については、「ディスプレイドライバーの特殊効果」を参照してください。固定小数点を使用する場合、 x/255 という用語に許容される近似値は (x*257)/65536 です。丸め処理を組み込む式:

((255 - Src.Alpha) * Dst.Red) / 255

その後、次のように近似できます。

temp = ((255 - Src.Alpha) * Dst.Red) + 128;
result = (temp + (temp >> 8)) >> 8;

ドライバーは、EngAssociateSurface を呼び出すときに HOOK_ALPHABLEND フラグを設定して DrvAlphaBlend をフックします。ドライバーが DrvAlphaBlend をフックし、サポートされていない操作を実行するために呼び出された場合、ドライバーは EngAlphaBlend の呼び出しでデータをパントすることによって GDI で操作を処理する必要があります。