Bitmap::ConvertFormat, méthode (gdiplusheaders.h)

Article
08/24/2023

La méthode Bitmap::ConvertFormat convertit une image bitmap au format de pixel spécifié. Les données de pixel d’origine dans la bitmap sont remplacées par les nouvelles données de pixel.

Syntaxe

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

Paramètres

[in] format

Type : PixelFormat

Constante de format de pixel qui spécifie le nouveau format de pixel.

[in] dithertype

Type : DitherType

Élément de l’énumération DitherType qui spécifie l’algorithme de dithering. Dans les cas où la conversion ne réduit pas la profondeur de bits des données de pixels, passez DitherTypeNone.

[in] palettetype

Type : PaletteType

Élément de l’énumération PaletteType qui spécifie une palette standard à utiliser pour le dithering. Si vous effectuez une conversion vers un format non indexé, ce paramètre est ignoré. Dans ce cas, transmettez n’importe quel élément de l’énumération PaletteType , par exemple PaletteTypeCustom.

[in] palette

Type : ColorPalette*

Pointeur vers une structure ColorPalette qui spécifie la palette dont les index sont stockés dans les données de pixels de la bitmap convertie. Cette palette (appelée palette réelle) n’a pas besoin d’avoir le type spécifié par le paramètre palettetype . Le paramètre palettetype spécifie une palette standard qui peut être utilisée par n’importe quel algorithme de tramage ordonné ou en spirale. Si la palette réelle a un type autre que celui spécifié par le paramètre palettetype , la méthode Bitmap::ConvertFormat effectue une conversion de couleur la plus proche de la palette standard vers la palette réelle.

[in] alphaThresholdPercent

Type : REAL

Nombre réel dans la plage 0 à 100 qui spécifie quels pixels de la bitmap source seront mappés à la couleur transparente dans la bitmap convertie. La valeur 0 spécifie qu’aucun des pixels sources ne correspond à la couleur transparente. La valeur 100 spécifie que tout pixel qui n’est pas entièrement opaque est mappé à la couleur transparente. La valeur t spécifie que tout pixel source inférieur à t % de totalement opaque est mappé à la couleur transparente. Notez que pour que le seuil alpha soit efficace, la palette doit avoir une couleur transparente. Si la palette n’a pas de couleur transparente, les pixels dont les valeurs alpha sont inférieures au seuil seront mappés à la couleur qui correspond le plus à (0, 0, 0, 0, 0), généralement noire.

Valeur retournée

Type : État

Si la méthode réussit, elle retourne Ok, qui est un élément de l’énumération Status .

Si la méthode échoue, elle retourne l’un des autres éléments de l’énumération Status .

Spécifications


Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	gdiplusheaders.h (inclure Gdiplus.h)
Bibliothèque	Gdiplus.lib
DLL	Gdiplus.dll

Voir aussi

Bitmap

Bitmap::InitializePalette

Share via