Metodo IWICBitmapFrameEncode::SetPalette (wincodec.h)

Imposta IWICPalette per i formati pixel indicizzati.

Sintassi

HRESULT SetPalette(
  [in] IWICPalette *pIPalette
);

Parametri

[in] pIPalette

Tipo: IWICPalette*

IWICPalette da usare per i formati pixel indicizzati.

Il codificatore può modificare la tavolozza in modo da riflettere i formati pixel supportati dal codificatore.

Valore restituito

Tipo: HRESULT

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

Commenti

Questo metodo non riesce se viene chiamato su un frame il cui formato pixel è impostato su un formato pixel non indicizzato. Se il formato pixel di destinazione è un formato non indicizzato, la tavolozza verrà ignorata.

Se hai già chiamato IWICBitmapEncoder::SetPalette per impostare una tavolozza globale, questo metodo esegue l'override di tale tavolozza per il frame corrente.

La tavolozza deve essere specificata prima della prima chiamata a WritePixels/WriteSource. In questo modo WriteSource userà la tavolozza specificata durante la conversione dell'immagine di origine nel formato pixel del codificatore. Se non viene specificata alcuna tavolozza, nella prima chiamata a WriteSource verrà generata una tavolozza.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP con SP2, Windows Vista [app desktop | App UWP]
Server minimo supportato	Windows Server 2008 [app desktop | App UWP]
Piattaforma di destinazione	Windows
Intestazione	wincodec.h
Libreria	Windowscodecs.lib
DLL	Windowscodecs.dll