TranslateBitmapBits 関数 (icm.h)
定義された形式のビットマップの色を変換して、要求された形式で別のビットマップを生成します。
構文
BOOL TranslateBitmapBits(
HTRANSFORM hColorTransform,
PVOID pSrcBits,
BMFORMAT bmInput,
DWORD dwWidth,
DWORD dwHeight,
DWORD dwInputStride,
PVOID pDestBits,
BMFORMAT bmOutput,
DWORD dwOutputStride,
PBMCALLBACKFN pfnCallBack,
LPARAM ulCallbackData
);
パラメーター
hColorTransform
使用する色変換を識別します。
pSrcBits
変換するビットマップへのポインター。
bmInput
入力ビットマップの形式を指定します。 BMFORMAT 列挙型のいずれかの値に設定する必要があります。
注意
この関数は、入力として BM_XYZTRIPLETS または BM_YxyTRIPLETS をサポートしていません。
dwWidth
入力ビットマップ内のスキャン行あたりのピクセル数を指定します。
dwHeight
入力ビットマップ内のスキャン行の数を指定します。
dwInputStride
1 つのスキャン行の先頭から入力ビットマップ内の次のスキャン行の先頭までのバイト数を指定します。0 に設定されている場合、この関数は、スキャン行が DWORD アラインされるように埋め込まれていると見なします。
pDestBits
翻訳されたビットマップを配置するバッファーへのポインター。
bmOutput
出力ビットマップの形式を指定します。 BMFORMAT 列挙型のいずれかの値に設定する必要があります。
dwOutputStride
1 つのスキャン行の先頭から出力ビットマップ内の次のスキャン行の先頭までのバイト数を指定します。0 に設定した場合、この関数は、スキャン行を DWORD アラインするように埋め込む必要があると想定します。
pfnCallBack
TranslateBitmapBits によって定期的に呼び出されるコールバック関数へのポインター。 ( ICMProgressProcCallback を参照)
ulCallbackData
たとえば、進行状況を報告している翻訳を識別するために、コールバック関数に返されるデータ。
戻り値
この関数が成功した場合、戻り値は TRUE になります。
この関数が失敗した場合、戻り値は FALSE になります。 拡張エラー情報については、 GetLastError を呼び出します。
注釈
入力形式と出力形式がカラー変換と互換性がない場合、この関数は失敗します。
浮動小数点 BMFORMAT、BM_32b_scARGB、またはBM_32b_scRGBのいずれかを使用する場合、変換されるカラー データに NaN または無限大を含めないようにする必要があります。 NaN と無限大は、正当な色成分値を表すものとは見なされず、NaN または無限大を含むピクセルを翻訳した結果は、色の観点からは意味がありません。 処理される色データの NaN または無限大の値は、サイレントモードで処理され、エラーは返されません。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| Header | icm.h |
| Library | Mscms.lib |
| [DLL] | Mscms.dll |