Metodo Bitmap::ConvertFormat (gdiplusheaders.h)

Articolo
08/24/2023

Il metodo Bitmap::ConvertFormat converte una bitmap in un formato pixel specificato. I dati pixel originali nella bitmap vengono sostituiti dai nuovi dati pixel.

Sintassi

Status ConvertFormat(
  [in] PixelFormat  format,
  [in] DitherType   dithertype,
  [in] PaletteType  palettetype,
  [in] ColorPalette *palette,
  [in] REAL         alphaThresholdPercent
);

Parametri

[in] format

Tipo: PixelFormat

Costante di formato pixel che specifica il nuovo formato pixel.

[in] dithertype

Tipo: DitherType

Elemento dell'enumerazione DitherType che specifica l'algoritmo dithering. Nei casi in cui la conversione non riduce la profondità di bit dei dati pixel, passare DitherTypeNone.

[in] palettetype

Tipo: PaletteType

Elemento dell'enumerazione PaletteType che specifica una tavolozza standard da utilizzare per il dithering. Se si esegue la conversione in un formato non indicizzato, questo parametro viene ignorato. In tal caso, passare qualsiasi elemento dell'enumerazione PaletteType , ad esempio PaletteTypeCustom.

[in] palette

Tipo: ColorPalette*

Puntatore a una struttura ColorPalette che specifica la tavolozza i cui indici vengono archiviati nei dati pixel della bitmap convertita. Questa tavolozza (denominata tavolozza effettiva) non deve avere il tipo specificato dal parametro palettetype . Il parametro palettetype specifica una tavolozza standard che può essere utilizzata da uno degli algoritmi di dithering ordinati o a spirale. Se la tavolozza effettiva ha un tipo diverso da quello specificato dal parametro palettetype , il metodo Bitmap::ConvertFormat esegue una conversione dei colori più vicina dalla tavolozza standard alla tavolozza effettiva.

[in] alphaThresholdPercent

Tipo: REAL

Numero reale nell'intervallo da 0 a 100 che specifica quali pixel nella bitmap di origine eseguiranno il mapping al colore trasparente nella bitmap convertita. Il valore 0 specifica che nessuno dei pixel di origine viene mappato al colore trasparente. Il valore 100 specifica che qualsiasi pixel non completamente opaco verrà mappato al colore trasparente. Il valore t specifica che qualsiasi pixel di origine inferiore al t% di completamente opaco verrà mappato al colore trasparente. Si noti che per rendere effettiva la soglia alfa, la tavolozza deve avere un colore trasparente. Se la tavolozza non ha un colore trasparente, i pixel con valori alfa inferiori alla soglia verranno mappati al colore che corrisponde più strettamente (0, 0, 0, 0), in genere nero.

Valore restituito

Tipo: Stato

Se il metodo ha esito positivo, restituisce Ok, che è un elemento dell'enumerazione Status .

Se il metodo ha esito negativo, restituisce uno degli altri elementi dell'enumerazione Status .

Requisiti


Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	gdiplusheaders.h (include Gdiplus.h)
Libreria	Gdiplus.lib
DLL	Gdiplus.dll

Vedi anche

Bitmap

Bitmap::InitializePalette

Condividi tramite