Partager via

Énumération DitherType (gdipluspixelformats.h)

  • Article

L’énumération DitherType identifie les algorithmes disponibles pour le dithering lorsqu’une bitmap est convertie.

L’appel de la méthode Bitmap::ConvertFormat d’un objet Bitmap modifie le format de pixel de cette bitmap. Si la conversion entraîne une profondeur de bits réduite (moins de bits par pixel), certaines couleurs de la bitmap d’origine sont simulées par un modèle de trame (damier) composé de couleurs disponibles dans le nouveau format de pixel. Les membres de l’énumération DitherType identifient les algorithmes disponibles pour effectuer ce dithering.

Syntax

typedef enum DitherType {
  DitherTypeNone = 0,
  DitherTypeSolid = 1,
  DitherTypeOrdered4x4 = 2,
  DitherTypeOrdered8x8 = 3,
  DitherTypeOrdered16x16 = 4,
  DitherTypeSpiral4x4 = 5,
  DitherTypeSpiral8x8 = 6,
  DitherTypeDualSpiral4x4 = 7,
  DitherTypeDualSpiral8x8 = 8,
  DitherTypeErrorDiffusion = 9,
  DitherTypeMax = 10
} ;

Constantes

 
DitherTypeNone
Valeur : 0
Aucun tramage n’est effectué. Les pixels de la bitmap source sont mappés à la couleur la plus proche dans la palette spécifiée par le paramètre de palette de la méthode Bitmap::ConvertFormat . Cet algorithme peut être utilisé avec n’importe quelle palette. Si la palette spécifiée par le paramètre palette n’a pas l’un des formats fixes standard répertoriés dans l’énumération PaletteType , transmettez PaletteTypeCustom au paramètre palettetype .
DitherTypeSolid
Valeur : 1
Aucun tramage n’est effectué. Les pixels de la bitmap source sont mappés à la couleur la plus proche dans la palette spécifiée par le paramètre de palette de la méthode Bitmap::ConvertFormat . Cet algorithme peut être utilisé avec n’importe quelle palette. Si la palette spécifiée par le paramètre palette n’a pas l’un des formats fixes standard répertoriés dans l’énumération PaletteType , transmettez PaletteTypeCustom au paramètre palettetype .
DitherTypeOrdered4x4
Valeur : 2
Vous pouvez utiliser cet algorithme pour effectuer un tramage en fonction des couleurs de l’une des palettes fixes standard. Vous pouvez également utiliser cet algorithme pour convertir une bitmap au format 16 bits par pixel qui n’a pas de palette.
DitherTypeOrdered8x8
Valeur : 3
Le tramage est effectué à l’aide des couleurs de l’une des palettes fixes standard.
DitherTypeOrdered16x16
Valeur : 4
Le tramage est effectué à l’aide des couleurs de l’une des palettes fixes standard.
DitherTypeSpiral4x4
Valeur : 5
Le tramage est effectué à l’aide des couleurs de l’une des palettes fixes standard.
DitherTypeSpiral8x8
Valeur : 6
Le tramage est effectué à l’aide des couleurs de l’une des palettes fixes standard.
DitherTypeDualSpiral4x4
Valeur : 7
Le tramage est effectué à l’aide des couleurs de l’une des palettes fixes standard.
DitherTypeDualSpiral8x8
Valeur : 8
Le tramage est effectué à l’aide des couleurs de l’une des palettes fixes standard.
DitherTypeErrorDiffusion
Valeur : 9
Le tramage est effectué en fonction de la palette spécifiée par le paramètre de palette de la méthode Bitmap::ConvertFormat . Cet algorithme peut être utilisé avec n’importe quelle palette. Si la palette spécifiée par le paramètre palette n’a pas l’un des formats fixes standard répertoriés dans l’énumération PaletteType , transmettez PaletteTypeCustom au paramètre palettetype .
DitherTypeMax
Valeur : 10
TBD

Notes

Si vous passez l’un des types de dither ordonnés ou en spirale (à l’exception de DitherTypeOrdered4x4) au paramètre dithertype de la méthode Bitmap::ConvertFormat , vous devez passer l’un des types de palette fixes suivants au paramètre palettetype .

  • PaletteTypeFixedBW
  • PaletteTypeFixedHalftone8
  • PaletteTypeFixedHalftone27
  • PaletteTypeFixedHalftone64
  • PaletteTypeFixedHalftone125
  • PaletteTypeFixedHalftone216
  • PaletteTypeFixedHalftone252
  • PaletteTypeFixedHalftone256
L’algorithme DitherTypeOrdered4x4 est un cas spécial. Vous pouvez l’utiliser avec les types de palette fixes indiqués dans la liste précédente ou vous pouvez l’utiliser pour convertir une bitmap au format 16 bits par pixel.

Configuration requise

   
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
En-tête gdipluspixelformats.h (include Gdiplus.h)