EngTransparentBlt

EngTransparentBlt 関数は、透過付きビットブロック転送機能を提供する。

EngTransparentBlt psoDst, psoSrc, pco, pxlo, prclDst, prclSrc, TransColor, bCalledFromBitBlt

psoDst : [var] 描画先のターゲットサーフェスを識別する SURFOBJ 構造体へのポインタ。
psoSrc : [var] ビットブロック転送のソースサーフェスを識別する SURFOBJ 構造体へのポインタ。
pco : [var] CLIPOBJ 構造体へのポインタ。CLIPOBJ_Xxx サービスルーチンが、クリップ領域を矩形の集合として列挙するために提供される。この列挙は変更される宛先の領域を制限する。可能な限り GDI はクリッピングを単純化する。
pxlo : [var] ターゲットサーフェスへ書き込むためにソースカラーインデックスをどう変換するかを示す XLATEOBJ 構造体へのポインタ。
prclDst : [var] 変更する矩形領域を定義する RECTL 構造体へのポインタ。この矩形は宛先サーフェスの座標系で指定し、左上と右下の 2 点で定義される。矩形は右下を含まない。すなわち、その下辺と右辺はビットブロック転送の一部ではない。矩形を定義する 2 点は常に整列している。ドライバは決して空の宛先矩形で EngTransparentBlt を呼んではならない。
prclSrc : [var] コピーする矩形領域を定義する RECTL 構造体へのポインタ。この矩形はソースサーフェスの座標系で指定し、左上と右下の 2 点で定義される。矩形を定義する 2 点は常に整列している。ソース矩形はソースサーフェスの境界を超えてはならず、ソースサーフェスからはみ出してはならない。この矩形は prclDst で定義される宛先矩形にマップされる。ドライバは決して空のソース矩形で EngTransparentBlt を呼んではならない。
TransColor : [int] ソースサーフェスのフォーマットでの物理透過色を指定する。これはソースサーフェスのパレットに変換されたカラーインデックス値である。詳細は備考を参照。
bCalledFromBitBlt : [int] 予約。このパラメータはゼロに設定しなければならない。

(プラグイン / モジュール : gdi32.dll)

解説

EngTransparentBlt 関数は、透過付きビットブロック転送機能を提供する。

[戻り値]
EngTransparentBlt は成功時に TRUE を返す。それ以外の場合は FALSE を返す。

[備考]
ドライバが DrvTransparentBlt をフックしているがサポートしない処理を要求された場合、EngTransparentBlt
を呼ぶべきである。透過付きビットブロック転送は、2 つのデバイス管理サーフェス間、またはデバイス管理サーフェスと GDI
管理の標準フォーマットビットマップとの間でサポートされる。現在、GDI は BMF_4BPP と BMF_8BPP
のソースサーフェスのみをサポートする。iTransparentColor
で指定された透過色に一致するソースサーフェス上のピクセルはコピーされない。透過 blt の詳細は Copying Bitmaps を参照。

情報