IWICPalette::InitializeFromBitmap-Methode (wincodec.h)

Artikel
03/06/2024

Initialisiert eine Palette mithilfe eines berechneten optimierten Wertes basierend auf der Referenzbitbit.

Syntax

HRESULT InitializeFromBitmap(
  [in] IWICBitmapSource *pISurface,
  [in] UINT             cCount,
  [in] BOOL             fAddTransparentColor
);

Parameter

[in] pISurface

Typ: IWICBitmapSource*

Zeiger auf die Quell-Bitmap.

[in] cCount

Typ: UINT

Die Anzahl der Farben, mit denen die Palette initialisiert werden soll.

[in] fAddTransparentColor

Typ: BOOL

Ein Wert, der angibt, ob eine transparente Farbe hinzugefügt werden soll.

Rückgabewert

Typ: HRESULT

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

Hinweise

Die resultierende Palette enthält die angegebene Anzahl von Farben, die die in der Bitmap vorhandenen Farben am besten darstellen. Der Algorithmus arbeitet mit dem undurchsichtigen RGB-Farbwert jedes Pixels in der Referenz-Bitmap und ignoriert daher alle Alphawerte. Wenn eine transparente Farbe erforderlich ist, legen Sie den fAddTransparentColor-Parameter auf TRUE fest, und eine optimierte Farbe weniger wird berechnet, wodurch der colorCount reduziert wird, und es wird ein vollständig transparenter Farbeintrag hinzugefügt.

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