CreateColorTransformW 関数 (icm.h)
アプリケーションでカラー管理を実行するために使用できる色変換を作成します。
構文
HTRANSFORM CreateColorTransformW(
LPLOGCOLORSPACEW pLogColorSpace,
HPROFILE hDestProfile,
HPROFILE hTargetProfile,
DWORD dwFlags
);
パラメーター
pLogColorSpace
入力 LOGCOLORSPACEA へのポインター。
hDestProfile
宛先デバイスのプロファイルを処理します。 関数は、HPROFILE に国際色コンソーシアム (ICC) または Windows カラー システム (WCS) プロファイル情報が含まれているかどうかを決定します。
hTargetProfile
ターゲット デバイスのプロファイルを処理します。 この関数は、HPROFILE に ICC プロファイル情報と WCS プロファイル情報のどちらを含めるかを判別します。
dwFlags
変換のコントロール作成に使用するフラグを指定します。 「解説」を参照してください。
戻り値
この関数が成功した場合、戻り値はカラー変換のハンドルになります。
この関数が失敗した場合、戻り値は NULL です。 拡張エラー情報については、 GetLastError を呼び出します。
注釈
ターゲット プロファイルが NULL の場合、変換はソース論理色空間から宛先プロファイルに変換されます。 ターゲット プロファイルが指定されている場合、変換はソース論理色空間からターゲット プロファイルに変換され、変換先プロファイルに変換されます。 これにより、ターゲット デバイス上のターゲット デバイス用の出力をプレビューできます。
dwFlags の値は、ヒントのみを目的としています。 色管理モジュールは、それらを使用する最適な方法を決定する必要があります。
Windows Vista: dwFlags で使用できる 3 つの新しいフラグが追加されました。
| フラグ | 説明 |
|---|---|
| PRESERVEBLACK | このビットが設定されている場合、変換エンジンは、変換シーケンスの最後の GMMP として適切なブラック生成 GMMP を挿入します。 このフラグは、純粋な WCS 変換でのみ機能します。 |
| SEQUENTIAL_TRANSFORM | このビットが設定されている場合、WCS 処理パイプラインの各ステップはイメージ内のすべてのピクセルに対して実行され、最適化された色変換は作成されません。 このフラグは、純粋な WCS 変換でのみ機能します。制限事項: SEQUENTIAL_TRANSFORM フラグを設定して作成された変換は、作成されたスレッドでのみ使用でき、一度に 1 つの色変換呼び出しに対してのみ使用できます。 COM はシーケンシャル変換を作成する前に初期化する必要があり、変換オブジェクトの有効期間は初期化されたままにする必要があります。 |
| WCS_ALWAYS | このビットが設定されている場合、すべての ICC 変換でも WCS コード パスが使用されます。 |
注意
SEQUENTIAL_TRANSFORM は、Windows Vista SDK の icm.h ヘッダーから誤って省略されました。 SEQUENTIAL_TRANSFORM フラグを使用する場合は、アプリケーションで次のように定義します:#define SEQUENTIAL_TRANSFORM 0x80800000
詳細については、「 CMM 変換作成フラグ」を参照してください。 そこに記載されているすべてのフラグは、純粋なICC-to-ICC変換でのみ機能するFAST_TRANSLATEを除き、すべての種類の変換でサポートされています。
CreateColorTransform 関数は、デバイス コンテキストの外部で使用されます。 カラー プロファイルから同じカラー プロファイルに変換すると、色がシフトすることがあります。 これは、精度エラーが原因です。 そのため、このような状況では色変換を実行しないでください。
変換のターゲットであるプロファイルには、B2Ax タグが必要です。
ICC ColorSpace プロファイルの WCS 変換のサポートは、RGB カラースペース プロファイルに限定されます。 以下の ICC プロファイル・タイプは、CITE 処理変換 (混合 WCS/ICC 変換、または WCS_ALWAYS が設定された all-ICC 変換) では使用できません。
- RGB 以外の ColorSpace プロファイル
- NamedColor プロファイル
- n チャネル プロファイル (ここで n > 8)
- DeviceLink プロファイル
- 抽象プロファイル
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| Header | icm.h |
| Library | Mscms.lib |
| [DLL] | Mscms.dll |