IWICBitmapFrameEncode::SetColorContexts メソッド (wincodec.h)

指定した数 の IWICColorContext プロファイルをフレームに設定します。

構文

HRESULT SetColorContexts(
  [in] UINT             cCount,
  [in] IWICColorContext **ppIColorContext
);

パラメーター

[in] cCount

型: UINT

設定する IWICColorContext プロファイルの数。

[in] ppIColorContext

種類: IWICColorContext**

フレームに設定するカラー コンテキスト プロファイルを含む IWICColorContext ポインターへのポインター。

戻り値

型: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

注釈

• Bmp色コンテキストの設定はサポートされていません。 この関数は 、WINCODEC_ERR_UNSUPPORTEDOPERATIONを返します。
• Png最大 1 つの色コンテキストの設定がサポートされており、追加の色コンテキストは無視されます。 このコンテキストは WICColorContextProfile である必要があり、PNG ファイル内の iCCP、gAMA、および cHRM チャンクをエンコードするために使用されます。
• JPEG、TIFF、JPEG-XRWICColorContextProfile と WICColorContextExifColorSpace を 1 つまで設定できます。 各型の最後のコンテキスト以外はすべて無視されるため、ユーザーは色コンテキストの種類ごとに複数の情報を提供することはできません。 JPEG では、 WICColorContextProfile は JPEG APP2 ICC メタデータ ブロックにエンコードされます。

  TIFF および JPEG-XR では、 WICColorContextProfile は IFD ICC プロファイル メタデータ ブロック (IFD タグ 0x8773) にエンコードされます。 3 つの形式すべてで、 WICColorContextExifColorSpace は EXIF カラースペース メタデータ ブロック (EXIF タグ 0xA001) にエンコードされます。

要件