GdiAlphaBlend

GdiAlphaBlend 関数は、透明または半透明ピクセルを持つビットマップを表示する。

GdiAlphaBlend hdcDest, xoriginDest, yoriginDest, wDest, hDest, hdcSrc, xoriginSrc, yoriginSrc, wSrc, hSrc, ftn

hdcDest : [intptr] デスティネーションデバイスコンテキストのハンドル。
xoriginDest : [int] デスティネーション矩形の左上隅の x 座標(論理単位)。
yoriginDest : [int] デスティネーション矩形の左上隅の y 座標(論理単位)。
wDest : [int] デスティネーション矩形の幅(論理単位)。
hDest : [int] デスティネーション矩形の高さ(論理単位)。
hdcSrc : [intptr] ソースデバイスコンテキストのハンドル。
xoriginSrc : [int] ソース矩形の左上隅の x 座標(論理単位)。
yoriginSrc : [int] ソース矩形の左上隅の y 座標(論理単位)。
wSrc : [int] ソース矩形の幅(論理単位)。
hSrc : [int] ソース矩形の高さ(論理単位)。
ftn : [var] ソースおよびデスティネーションビットマップのアルファブレンド関数、ソースビットマップ全体に適用されるグローバルアルファ値、ソースビットマップのフォーマット情報。ソースとデスティネーションのブレンド関数は現在 AC_SRC_OVER に限定される。BLENDFUNCTION および EMRALPHABLEND 構造体を参照。

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

解説

GdiAlphaBlend 関数は、透明または半透明ピクセルを持つビットマップを表示する。

[戻り値]
関数が成功した場合、戻り値は TRUE である。失敗した場合は FALSE を返す。この関数は次の値を返すことがある。
（以下省略)

[備考]
注意 この関数は AlphaBlend
と同じである。ソース矩形とデスティネーション矩形のサイズが異なる場合、ソースビットマップはデスティネーション矩形に合うように伸縮される。SetStretchBltMode
関数が使用された場合、iStretchMode の値はこの関数では自動的に COLORONCOLOR
に変換される(BLACKONWHITE、WHITEONBLACK、HALFTONE は COLORONCOLOR
に変更される)。デスティネーションの座標は、デスティネーションデバイスコンテキストに現在設定されている変換で変換される。ソースの座標は、ソースデバイスコンテキストに現在設定されている変換で変換される。ソースデバイスコンテキストが拡張メタファイルデバイスコンテキストを示している場合、エラーが発生し(関数は
FALSE を返す)。デスティネーションとソースのビットマップのカラーフォーマットが異なる場合、GdiAlphaBlend
はソースビットマップをデスティネーションに合わせて変換する。GdiAlphaBlend
はミラーリングをサポートしない。ソースまたはデスティネーションの幅あるいは高さが負の場合、この呼び出しは失敗する。プリンタへの描画時には、まず
GetDeviceCaps に SHADEBLENDCAPS を指定して呼び出し、プリンタが GdiAlphaBlend
でのブレンドをサポートしているかを確認すること。ディスプレイ DC
ではすべてのブレンド操作がサポートされており、これらのフラグは操作がハードウェアで高速化されているかを示す。ソースとデスティネーションが同じサーフェス(つまり両方とも画面または同じメモリビットマップ)で、かつソース矩形とデスティネーション矩形が重なっている場合、エラーが発生し関数は
FALSE を返す。ソース矩形はソースサーフェス内に完全に収まっていなければならず、そうでなければエラーとなり FALSE
を返す。GdiAlphaBlend はソースまたはデスティネーションの幅または高さが負の場合に失敗する。BLENDFUNCTION の
SourceConstantAlpha
メンバは、ソースビットマップ全体に適用するアルファ透明度値を指定する。SourceConstantAlpha
値はピクセル毎のアルファ値と組み合わされる。SourceConstantAlpha が 0
の場合、画像は透明と見なされる。ピクセル毎のアルファ値のみを使用したい場合は SourceConstantAlpha に 255
(不透明を示す) を指定する。

情報