Metodo IWICDevelopRaw::SetWhitePointKelvin (wincodec.h)

Imposta il valore Kelvin del punto bianco.

Sintassi

HRESULT SetWhitePointKelvin(
  [in] UINT WhitePointKelvin
);

Parametri

[in] WhitePointKelvin

Tipo: UINT

Valore Kelvin del punto bianco. I valori Kelvin accettabili sono compresi tra 1.500 e 30.000.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Gli implementatori di codec devono regolare fedelmente la temperatura del colore all'interno dell'intervallo supportato in modo nativo dall'immagine non elaborata. Per i valori esterni all'intervallo di supporto nativo, l'implementatore codec deve fornire una rappresentazione ottimale dell'immagine a tale temperatura di colore.

Gli implementatori di codec devono restituire WINCODEC_ERR_VALUEOUTOFRANGE se il valore non è compreso nell'intervallo accettabile definito.

Gli implementatori di codec devono garantire l'interoperabilità appropriata con altri metodi di impostazione dei punti bianchi, ad esempio SetWhitePointRGB. Ad esempio, se il chiamante imposta il punto bianco tramite SetNamedWhitePoint , l'implementatore del codec potrebbe voler disabilitare la lettura della temperatura Kelvin corrispondente. In casi specifici in cui l'implementatore codec vuole negare una determinata azione a causa delle chiamate precedenti, WINCODEC_ERR_WRONGSTATE deve essere restituito.

Requisiti