次の方法で共有

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

こちらもご覧ください