IWICDevelopRaw::SetWhitePointKelvin-Methode (wincodec.h)

Artikel
03/03/2024

Legt den Kelvin-Wert des Weißpunkts fest.

Syntax

HRESULT SetWhitePointKelvin(
  [in] UINT WhitePointKelvin
);

Parameter

[in] WhitePointKelvin

Typ: UINT

Der Kelvin-Wert des Weißpunkts. Zulässige Kelvinwerte sind 1.500 bis 30.000.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Codecimplementierer sollten die Farbtemperatur innerhalb des bereichsgetreu anpassen, der vom Rohbild nativ unterstützt wird. Für Werte außerhalb des nativen Unterstützungsbereichs sollte der Codecimplementierer eine bestmögliche Darstellung des Bilds bei dieser Farbtemperatur bereitstellen.

Codecimplementierer sollten WINCODEC_ERR_VALUEOUTOFRANGE zurückgeben, wenn der Wert außerhalb des definierten zulässigen Bereichs liegt.

Codecimplementierer müssen eine ordnungsgemäße Interoperabilität mit anderen Whitepoint-Einstellungsmethoden wie SetWhitePointRGB sicherstellen. Wenn der Aufrufer beispielsweise den Weißpunkt über SetNamedWhitePoint festlegt, möchte der Codec-Implementierer möglicherweise das Zurücklesen der entsprechenden Kelvintemperatur deaktivieren. In bestimmten Fällen, in denen der Codecimplementierer eine bestimmte Aktion aufgrund früherer Aufrufe ablehnen möchte, sollte WINCODEC_ERR_WRONGSTATE zurückgegeben werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP mit SP2, Windows Vista [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	wincodec.h
Bibliothek	Windowscodecs.lib
DLL	Windowscodecs.dll

Freigeben über