Enumeración DitherType (gdipluspixelformats.h)

  • Artículo

La enumeración DitherType identifica los algoritmos disponibles para la dithering cuando se convierte un mapa de bits.

Al llamar al método Bitmap::ConvertFormat de un objeto Bitmap , se cambia el formato de píxel de ese mapa de bits. Si la conversión da como resultado una profundidad de bits reducida (menos bits por píxel), determinados colores del mapa de bits original se simularán mediante un patrón de dither (checkerboard) formado por colores que están disponibles en el nuevo formato de píxel. Los miembros de la enumeración DitherType identifican los algoritmos disponibles para realizar esta 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
Valor: 0
No se realiza ninguna dithering. Los píxeles del mapa de bits de origen se asignan al color más cercano de la paleta especificada por el parámetro de paleta del método Bitmap::ConvertFormat . Este algoritmo se puede usar con cualquier paleta. Si la paleta especificada por el parámetro palette no tiene uno de los formatos fijos estándar enumerados en la enumeración PaletteType , pase PaletteTypeCustom al parámetro palettetype .
DitherTypeSolid
Valor: 1
No se realiza ninguna dithering. Los píxeles del mapa de bits de origen se asignan al color más cercano de la paleta especificada por el parámetro de paleta del método Bitmap::ConvertFormat . Este algoritmo se puede usar con cualquier paleta. Si la paleta especificada por el parámetro palette no tiene uno de los formatos fijos estándar enumerados en la enumeración PaletteType , pase PaletteTypeCustom al parámetro palettetype .
DitherTypeOrdered4x4
Valor: 2
Puede usar este algoritmo para realizar dithering en función de los colores de una de las paletas fijas estándar. También puede usar este algoritmo para convertir un mapa de bits a un formato de 16 bits por píxel que no tenga paleta.
DitherTypeOrdered8x8
Valor: 3
La dithering se realiza mediante los colores de una de las paletas fijas estándar.
DitherTypeOrdered16x16
Valor: 4
La dithering se realiza mediante los colores de una de las paletas fijas estándar.
DitherTypeSpiral4x4
Valor: 5
La dithering se realiza mediante los colores de una de las paletas fijas estándar.
DitherTypeSpiral8x8
Valor: 6
La dithering se realiza mediante los colores de una de las paletas fijas estándar.
DitherTypeDualSpiral4x4
Valor: 7
La dithering se realiza mediante los colores de una de las paletas fijas estándar.
DitherTypeDualSpiral8x8
Valor: 8
La dithering se realiza mediante los colores de una de las paletas fijas estándar.
DitherTypeErrorDiffusion
Valor: 9
La dithering se realiza en función de la paleta especificada por el parámetro palette del método Bitmap::ConvertFormat . Este algoritmo se puede usar con cualquier paleta. Si la paleta especificada por el parámetro palette no tiene uno de los formatos fijos estándar enumerados en la enumeración PaletteType , pase PaletteTypeCustom al parámetro palettetype .
DitherTypeMax
Valor: 10
TBD

Comentarios

Si pasa cualquiera de los tipos de dither ordenados o espirales (excepto DitherTypeOrdered4x4) al parámetro dithertype del método Bitmap::ConvertFormat , debe pasar uno de los siguientes tipos fijos de paleta al parámetro palettetype .

  • PaletteTypeFixedBW
  • PaletteTypeFixedHalftone8
  • PaletteTypeFixedHalftone27
  • PaletteTypeFixedHalftone64
  • PaletteTypeFixedHalftone125
  • PaletteTypeFixedHalftone216
  • PaletteTypeFixedHalftone252
  • PaletteTypeFixedHalftone256
El algoritmo DitherTypeOrdered4x4 es un caso especial. Puede usarlo con los tipos fijos de paleta que se muestran en la lista anterior o puede usarlo para convertir un mapa de bits a un formato de 16 bits por píxel.

Requisitos

   
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado gdipluspixelformats.h (include Gdiplus.h)