通过

DitherType 枚举 (gdipluspixelformats.h)

  • 项目

DitherType 枚举标识转换位图时用于抖变的可用算法。

调用 Bitmap 对象的 Bitmap：：ConvertFormat 方法会更改该位图的像素格式。 如果转换导致位深度减小 () 每像素的位数减少，则原始位图中的某些颜色将由 (棋盘) 由新像素格式中可用的颜色组成的图案模拟。 DitherType 枚举的成员标识可用于执行此抖振的算法。

语法

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

常量

 
DitherTypeNone
值： 0
未执行抖振。 源位图中的像素映射到由 Bitmap：：ConvertFormat 方法的调色板参数指定的调色板中最近的颜色。 此算法可以与任何调色板一起使用。 如果 调色板参数指定的调色板 没有 PaletteType 枚举中列出的标准固定格式之一，请将 PaletteTypeCustom 传递给 palettetype 参数。
DitherTypeSolid
值：1
未执行抖振。 源位图中的像素映射到由 Bitmap：：ConvertFormat 方法的调色板参数指定的调色板中最近的颜色。 此算法可以与任何调色板一起使用。 如果 调色板参数指定的调色板 没有 PaletteType 枚举中列出的标准固定格式之一，请将 PaletteTypeCustom 传递给 palettetype 参数。
DitherTypeOrdered4x4
值： 2
可以使用此算法根据其中一个标准固定调色板中的颜色执行抖动。 还可以使用此算法将位图转换为没有调色板的每像素 16 位格式。
DitherTypeOrdered8x8
值： 3
使用其中一个标准固定调色板中的颜色执行抖动。
DitherTypeOrdered16x16
值： 4
使用其中一个标准固定调色板中的颜色执行抖动。
DitherTypeSpiral4x4
值： 5
使用其中一个标准固定调色板中的颜色执行抖动。
DitherTypeSpiral8x8
值： 6
使用其中一个标准固定调色板中的颜色执行抖动。
DitherTypeDualSpiral4x4
值： 7
使用其中一个标准固定调色板中的颜色执行抖动。
DitherTypeDualSpiral8x8
值： 8
使用其中一个标准固定调色板中的颜色执行抖动。
DitherTypeErrorDiffusion
值： 9
抖动是基于 Bitmap：：ConvertFormat 方法的调色板参数指定的调色板执行的。 此算法可以与任何调色板一起使用。 如果 调色板参数指定的调色板 没有 PaletteType 枚举中列出的标准固定格式之一，请将 PaletteTypeCustom 传递给 palettetype 参数。
DitherTypeMax
值： 10
TBD

注解

如果将除 DitherTypeOrdered4) (的任何有序或螺旋抖动类型传递给 Bitmap：：ConvertFormat 方法的 dithertype 参数，则必须将以下固定调色板类型之一传递给 palettetype 参数。

  • PaletteTypeFixedBW
  • PaletteTypeFixedHalftone8
  • PaletteTypeFixedHalftone27
  • PaletteTypeFixedHalftone64
  • PaletteTypeFixedHalftone125
  • PaletteTypeFixedHalftone216
  • PaletteTypeFixedHalftone252
  • PaletteTypeFixedHalftone256
DitherTypeOrdered4x4 算法是一种特殊情况。 可以将它与前面列表中所示的固定调色板类型一起使用，也可以使用它将位图转换为每像素 16 位格式。

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
标头 gdipluspixelformats.h (包括 Gdiplus.h)