GdiAlphaBlend 関数 (wingdi.h)
GdiAlphaBlend 関数は、透明または半透明のピクセルを持つビットマップを表示します。
構文
BOOL GdiAlphaBlend(
[in] HDC hdcDest,
[in] int xoriginDest,
[in] int yoriginDest,
[in] int wDest,
[in] int hDest,
[in] HDC hdcSrc,
[in] int xoriginSrc,
[in] int yoriginSrc,
[in] int wSrc,
[in] int hSrc,
[in] BLENDFUNCTION ftn
);
パラメーター
[in] hdcDest
ターゲット デバイス コンテキストのハンドル。
[in] xoriginDest
コピー先の四角形の左上隅の x 座標を論理単位で指定します。
[in] yoriginDest
コピー先の四角形の左上隅の y 座標を論理単位で指定します。
[in] wDest
ターゲットの四角形の幅 (論理単位)。
[in] hDest
ターゲットの四角形の高さ (論理単位)。
[in] hdcSrc
ソース デバイス コンテキストへのハンドル。
[in] xoriginSrc
ソース四角形の左上隅の x 座標 (論理単位)。
[in] yoriginSrc
ソース四角形の左上隅の y 座標 (論理単位)。
[in] wSrc
ソースの四角形の幅 (論理単位)。
[in] hSrc
ソースの四角形の高さ (論理単位)。
[in] ftn
ソースとターゲットのビットマップのアルファ ブレンド関数、ソース ビットマップ全体に適用されるグローバル アルファ値、およびソース ビットマップの形式情報。 ソースとターゲットのブレンド関数は現在、AC_SRC_OVERに制限されています。 BLENDFUNCTION および EMRALPHABLEND 構造体を参照してください。
戻り値
関数が成功した場合、戻り値は TRUE になります。
関数が失敗した場合、戻り値は FALSE になります。
この関数は、次の値を返すことができます。
| リターン コード | 説明 |
|---|---|
|
1 つ以上の入力パラメーターが無効です。 |
注釈
変換先の座標は、ターゲット デバイス コンテキストに対して現在指定されている変換を使用して変換されます。 ソース座標は、ソース デバイス コンテキストに対して現在指定されている変換を使用して変換されます。
ソース デバイス コンテキストが拡張メタファイル デバイス コンテキストを識別すると、エラーが発生 (および関数は FALSE を返します)。
変換先ビットマップとソース ビットマップの色形式が同じでない場合、 GdiAlphaBlend はソース ビットマップを変換先ビットマップと一致するように変換します。
GdiAlphaBlend はミラーリングをサポートしていません。 ソースまたは宛先の幅または高さが負の場合、この呼び出しは失敗します。
プリンターにレンダリングするときは、まず GETDeviceCaps と SHADEBLENDCAPS を呼び出して、プリンターが GdiAlphaBlend とのブレンドをサポートしているかどうかを判断します。 ディスプレイ DC では、すべてのブレンド操作がサポートされ、これらのフラグは操作が高速化されるかどうかを表します。
ソースとコピー先が同じサーフェスである場合、つまり、画面または同じメモリ ビットマップの両方であり、ソース四角形とコピー先の四角形が重複している場合は、エラーが発生し、関数は FALSE を返します。
ソースの四角形は、ソースサーフェイス内に完全に配置する必要があります。それ以外の場合はエラーが発生し、関数は FALSE を返します。
GdiAlphaBlend は、ソースまたは変換先の幅または高さが負の場合に失敗します。
BLENDFUNCTIONの SourceConstantAlpha メンバーは、ソース ビットマップ全体で使用されるアルファ透明度の値を指定します。 SourceConstantAlpha 値は、ピクセル単位のアルファ値と組み合わされます。 SourceConstantAlpha が 0 の場合、イメージは透明であると見なされます。 ピクセルごとのアルファ値のみを使用する場合は、 SourceConstantAlpha 値を 255 (イメージが不透明であることを示します) に設定します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | wingdi.h (Windows.h を含む) |
| Library | Gdi32.lib |
| [DLL] | Gdi32.dll |