Enumeração DitherType (gdipluspixelformats.h)

  • Artigo

A enumeração DitherType identifica os algoritmos disponíveis para dithering quando um bitmap é convertido.

Chamar o método Bitmap::ConvertFormat de um objeto Bitmap altera o formato de pixel desse Bitmap. Se a conversão resultar em uma profundidade de bit reduzida (menos bits por pixel), determinadas cores no bitmap original serão simuladas por um padrão dither (checkerboard) composto por cores que estão disponíveis no novo formato de pixel. Os membros da enumeração DitherType identificam os algoritmos disponíveis para executar esse 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
Nenhum dithering é executado. Os pixels no bitmap de origem são mapeados para a cor mais próxima na paleta especificada pelo parâmetro de paleta do método Bitmap::ConvertFormat . Esse algoritmo pode ser usado com qualquer paleta. Se a paleta especificada pelo parâmetro palette não tiver um dos formatos fixos padrão listados na enumeração PaletteType , passe PaletteTypeCustom para o parâmetro palettetype .
DitherTypeSolid
Valor: 1
Nenhum dithering é executado. Os pixels no bitmap de origem são mapeados para a cor mais próxima na paleta especificada pelo parâmetro de paleta do método Bitmap::ConvertFormat . Esse algoritmo pode ser usado com qualquer paleta. Se a paleta especificada pelo parâmetro palette não tiver um dos formatos fixos padrão listados na enumeração PaletteType , passe PaletteTypeCustom para o parâmetro palettetype .
DitherTypeOrdered4x4
Valor: 2
Você pode usar esse algoritmo para executar dithering com base nas cores em uma das paletas fixas padrão. Você também pode usar esse algoritmo para converter um bitmap em um formato de 16 bits por pixel que não tem paleta.
DitherTypeOrdered8x8
Valor: 3
O dithering é executado usando as cores em uma das paletas fixas padrão.
DitherTypeOrdered16x16
Valor: 4
O dithering é executado usando as cores em uma das paletas fixas padrão.
DitherTypeSpiral4x4
Valor: 5
O dithering é executado usando as cores em uma das paletas fixas padrão.
DitherTypeSpiral8x8
Valor: 6
O dithering é executado usando as cores em uma das paletas fixas padrão.
DitherTypeDualSpiral4x4
Valor: 7
O dithering é executado usando as cores em uma das paletas fixas padrão.
DitherTypeDualSpiral8x8
Valor: 8
O dithering é executado usando as cores em uma das paletas fixas padrão.
DitherTypeErrorDiffusion
Valor: 9
O dithering é executado com base na paleta especificada pelo parâmetro de paleta do método Bitmap::ConvertFormat . Esse algoritmo pode ser usado com qualquer paleta. Se a paleta especificada pelo parâmetro palette não tiver um dos formatos fixos padrão listados na enumeração PaletteType , passe PaletteTypeCustom para o parâmetro palettetype .
DitherTypeMax
Valor: 10
TBD

Comentários

Se você passar qualquer um dos tipos de dither ordenados ou espiral (exceto DitherTypeOrdered4x4) para o parâmetro dithertype do método Bitmap::ConvertFormat , deverá passar um dos seguintes tipos de paleta fixa para o parâmetro palettetype .

  • PaletteTypeFixedBW
  • PaletteTypeFixedHalftone8
  • PaletteTypeFixedHalftone27
  • PaletteTypeFixedHalftone64
  • PaletteTypeFixedHalftone125
  • PaletteTypeFixedHalftone216
  • PaletteTypeFixedHalftone252
  • PaletteTypeFixedHalftone256
O algoritmo DitherTypeOrdered4x4 é um caso especial. Você pode usá-lo com os tipos de paleta fixos mostrados na lista anterior ou pode usá-lo para converter um bitmap em um formato de 16 bits por pixel.

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho gdipluspixelformats.h (inclua Gdiplus.h)