Freigeben über


DitherType-Enumeration (gdipluspixelformats.h)

Die DitherType-Enumeration identifiziert die verfügbaren Algorithmen für dithering, wenn eine Bitmap konvertiert wird.

Durch Aufrufen der Bitmap::ConvertFormat-Methode eines Bitmap-Objekts wird das Pixelformat dieser Bitmap geändert. Wenn die Konvertierung zu einer geringeren Bittiefe (weniger Bits pro Pixel) führt, werden bestimmte Farben in der ursprünglichen Bitmap durch ein Dithermuster (Checkerboard) simuliert, das aus Farben besteht, die im neuen Pixelformat verfügbar sind. Die Member der DitherType-Enumeration identifizieren die Algorithmen, die zum Ausführen dieses Ditherings verfügbar sind.

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
} ;

Konstanten

 
DitherTypeNone
Wert: 0
Es wird kein Dithering durchgeführt. Pixel in der Quell-Bitmap werden der nächsten Farbe in der Palette zugeordnet, die durch den Palettenparameter der Bitmap::ConvertFormat-Methode angegeben wird. Dieser Algorithmus kann mit jeder Palette verwendet werden. Wenn die vom palette-Parameter angegebene Palette nicht über eines der in der PaletteType-Enumeration aufgeführten festen Standardformate verfügt, übergeben Sie PaletteTypeCustom an den parameter palettetype .
DitherTypeSolid
Wert: 1
Es wird kein Dithering durchgeführt. Pixel in der Quell-Bitmap werden der nächsten Farbe in der Palette zugeordnet, die durch den Palettenparameter der Bitmap::ConvertFormat-Methode angegeben wird. Dieser Algorithmus kann mit jeder Palette verwendet werden. Wenn die vom palette-Parameter angegebene Palette nicht über eines der in der PaletteType-Enumeration aufgeführten festen Standardformate verfügt, übergeben Sie PaletteTypeCustom an den parameter palettetype .
DitherTypeOrdered4x4
Wert: 2
Sie können diesen Algorithmus verwenden, um dithering basierend auf den Farben in einer der standardmäßigen festen Paletten durchzuführen. Sie können diesen Algorithmus auch verwenden, um eine Bitmap in ein 16-Bits-pro-Pixel-Format ohne Palette zu konvertieren.
DitherTypeOrdered8x8
Wert: 3
Das Dithering wird mithilfe der Farben in einer der standardmäßigen festen Paletten durchgeführt.
DitherTypeOrdered16x16
Wert: 4
Das Dithering wird mithilfe der Farben in einer der standardmäßigen festen Paletten durchgeführt.
DitherTypeSpiral4x4
Wert: 5
Das Dithering wird mithilfe der Farben in einer der standardmäßigen festen Paletten durchgeführt.
DitherTypeSpiral8x8
Wert: 6
Das Dithering wird mithilfe der Farben in einer der standardmäßigen festen Paletten durchgeführt.
DitherTypeDualSpiral4x4
Wert: 7
Das Dithering wird mithilfe der Farben in einer der standardmäßigen festen Paletten durchgeführt.
DitherTypeDualSpiral8x8
Wert: 8
Das Dithering wird mithilfe der Farben in einer der standardmäßigen festen Paletten durchgeführt.
DitherTypeErrorDiffusion
Wert: 9
Das Dithering wird basierend auf der Palette ausgeführt, die durch den Palettenparameter der Bitmap::ConvertFormat-Methode angegeben wird. Dieser Algorithmus kann mit jeder Palette verwendet werden. Wenn die vom palette-Parameter angegebene Palette nicht über eines der in der PaletteType-Enumeration aufgeführten festen Standardformate verfügt, übergeben Sie PaletteTypeCustom an den parameter palettetype .
DitherTypeMax
Wert: 10
TBD

Hinweise

Wenn Sie einen der geordneten oder spiralförmigen Dithertypen (außer DitherTypeOrdered4x4) an den dithertype-Parameter der Bitmap::ConvertFormat-Methode übergeben, müssen Sie einen der folgenden festen Palettentypen an den palettetype-Parameter übergeben.

  • PaletteTypeFixedBW
  • PaletteTypeFixedHalftone8
  • PaletteTypeFixedHalftone27
  • PaletteTypeFixedHalftone64
  • PaletteTypeFixedHalftone125
  • PaletteTypeFixedHalftone216
  • PaletteTypeFixedHalftone252
  • PaletteTypeFixedHalftone256
Der DitherTypeOrdered4x4-Algorithmus ist ein Sonderfall. Sie können es mit den festen Palettentypen verwenden, die in der vorherigen Liste angezeigt werden, oder Sie können es verwenden, um eine Bitmap in ein 16-Bits-pro-Pixel-Format zu konvertieren.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Kopfzeile gdipluspixelformats.h (include Gdiplus.h)