IWICDevelopRaw::SetWhitePointKelvin メソッド (wincodec.h)

白いポイントの Kelvin 値を設定します。

構文

HRESULT SetWhitePointKelvin(
  [in] UINT WhitePointKelvin
);

パラメーター

[in] WhitePointKelvin

型: UINT

白いポイントのケルビン値。 許容されるケルビン値は 1,500 ~ 30,000 です。

戻り値

型: HRESULT

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

注釈

コーデックの実装者は、生の画像でネイティブにサポートされている範囲内の色温度を忠実に調整する必要があります。 ネイティブ サポート範囲外の値の場合、コーデック実装者は、その色温度でのイメージのベスト エフォート表現を提供する必要があります。

コーデックの実装者は、値が定義された許容範囲外の場合は、 WINCODEC_ERR_VALUEOUTOFRANGE を返す必要があります。

コーデックの実装者は 、SetWhitePointRGB などの他のホワイト ポイント設定メソッドとの適切な相互運用性を確保する必要があります。 たとえば、呼び出し元が SetNamedWhitePoint を使用してホワイト ポイントを設定した場合、コーデックの実装者は、対応する Kelvin 温度の読み戻しを無効にすることができます。 コーデックの実装者が以前の呼び出しのために特定のアクションを拒否する場合は、 WINCODEC_ERR_WRONGSTATE を返す必要があります。

要件