IWICBitmapFrameEncode::SetPalette-Methode (wincodec.h)

Legt die IWICPalette für indizierte Pixelformate fest.

Syntax

HRESULT SetPalette(
  [in] IWICPalette *pIPalette
);

Parameter

[in] pIPalette

Typ: IWICPalette*

Die IWICPalette , die für indizierte Pixelformate verwendet werden soll.

Der Encoder kann die Palette ändern, um die vom Encoder unterstützten Pixelformate widerzuspiegeln.

Rückgabewert

Typ: HRESULT

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

Hinweise

Diese Methode schlägt nicht fehl, wenn für einen Frame aufgerufen wird, dessen Pixelformat auf ein nicht indiziertes Pixelformat festgelegt ist. Wenn das Zielpixelformat ein nicht indiziertes Format ist, wird die Palette ignoriert.

Wenn Sie bereits IWICBitmapEncoder::SetPalette aufgerufen haben, um eine globale Palette festzulegen, setzt diese Methode diese Palette für den aktuellen Frame außer Kraft.

Die Palette muss vor dem ersten Aufruf von WritePixels/WriteSource angegeben werden. Dies führt dazu, dass WriteSource beim Konvertieren des Quellbilds in das Encoderpixelformat die angegebene Palette verwendet. Wenn keine Palette angegeben ist, wird beim ersten Aufruf von WriteSource eine Palette generiert.

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