Condividi tramite

Enumerazione DitherType (gdipluspixelformats.h)

  • Articolo

L'enumerazione DitherType identifica gli algoritmi disponibili per il dithering quando viene convertita una bitmap.

La chiamata al metodo Bitmap::ConvertFormat di un oggetto Bitmap modifica il formato pixel di tale bitmap. Se la conversione comporta una riduzione della profondità di bit (un minor numero di bit per pixel), alcuni colori nella bitmap originale verranno simulati da un motivo dither (checkerboard) costituito da colori disponibili nel nuovo formato pixel. I membri dell'enumerazione DitherType identificano gli algoritmi disponibili per l'esecuzione di questo dithering.

Sintassi

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

Costanti

 
DitherTypeNone
Valore: 0
Non viene eseguita alcuna dithering. I pixel nella bitmap di origine vengono mappati al colore più vicino nella tavolozza specificata dal parametro palette del metodo Bitmap::ConvertFormat . Questo algoritmo può essere usato con qualsiasi tavolozza. Se la tavolozza specificata dal parametro palette non include uno dei formati fissi standard elencati nell'enumerazione PaletteType, passare PaletteTypeCustom al parametro palettetype.
DitherTypeSolid
Valore: 1
Non viene eseguita alcuna dithering. I pixel nella bitmap di origine vengono mappati al colore più vicino nella tavolozza specificata dal parametro palette del metodo Bitmap::ConvertFormat . Questo algoritmo può essere usato con qualsiasi tavolozza. Se la tavolozza specificata dal parametro palette non include uno dei formati fissi standard elencati nell'enumerazione PaletteType, passare PaletteTypeCustom al parametro palettetype.
DitherTypeOrdered4x4
Valore: 2
È possibile usare questo algoritmo per eseguire il dithering in base ai colori in una delle tavolozze fisse standard. È anche possibile usare questo algoritmo per convertire una bitmap in un formato a 16 bit per pixel senza tavolozza.
DitherTypeOrdered8x8
Valore: 3
La dithering viene eseguita utilizzando i colori in una delle tavolozze fisse standard.
DitherTypeOrdered16x16
Valore: 4
La dithering viene eseguita utilizzando i colori in una delle tavolozze fisse standard.
DitherTypeSpiral4x4
Valore: 5
La dithering viene eseguita utilizzando i colori in una delle tavolozze fisse standard.
DitherTypeSpiral8x8
Valore: 6
La dithering viene eseguita utilizzando i colori in una delle tavolozze fisse standard.
DitherTypeDualSpiral4x4
Valore: 7
La dithering viene eseguita utilizzando i colori in una delle tavolozze fisse standard.
DitherTypeDualSpiral8x8
Valore: 8
La dithering viene eseguita utilizzando i colori in una delle tavolozze fisse standard.
DitherTypeErrorDiffusion
Valore: 9
Il dithering viene eseguito in base alla tavolozza specificata dal parametro palette del metodo Bitmap::ConvertFormat . Questo algoritmo può essere usato con qualsiasi tavolozza. Se la tavolozza specificata dal parametro palette non include uno dei formati fissi standard elencati nell'enumerazione PaletteType, passare PaletteTypeCustom al parametro palettetype.
DitherTypeMax
Valore: 10
TBD

Commenti

Se si passa uno dei tipi dither ordinati o a spirale (ad eccezione di DitherTypeOrdered4x4) al parametro dithertype del metodo Bitmap::ConvertFormat , è necessario passare uno dei tipi di tavolozza fissi seguenti al parametro palettetype .

  • PaletteTypeFixedBW
  • PaletteTypeFixedHalftone8
  • PaletteTypeFixedHalftone27
  • PaletteTypeFixedHalftone64
  • PaletteTypeFixedHalftone125
  • PaletteTypeFixedHalftone216
  • PaletteTypeFixedHalftone252
  • PaletteTypeFixedHalftone256
L'algoritmo DitherTypeOrdered4x4 è un caso speciale. È possibile usarlo con i tipi di tavolozza fissi visualizzati nell'elenco precedente oppure è possibile usarlo per convertire una bitmap in un formato a 16 bit per pixel.

Requisiti

   
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Intestazione gdipluspixelformats.h (include Gdiplus.h)