DXDITHERDESC structure

Contains the information needed by the DXDitherArray helper function to dither an array of sample.

Syntax

typedef struct DXDITHERDESC {
  DXBASESAMPLE       *pSamples;
  unsigned long      cSamples;
  unsigned long      x;
  unsigned long      y;
  DXSAMPLEFORMATENUM DestSurfaceFmt;
} DXDITHERDESC;

Members

• pSamples
  Pointer to a structure of type DXBASESAMPLE that indicates the samples to dither onto the output surface.

• cSamples
  Value of type unsigned long that indicates the number of samples in the pSamples buffer to dither.

• x
  Value of type unsigned long that indicates the x-coordinate of the output surface.

• y
  Value of type unsigned long that indicates the y-coordinate of the output surface.

• DestSurfaceFmt
  Member of the DXSAMPLEFORMATENUM enumeration that indicates the pixel format of the destination surface.

Remarks

You can use dithering to produce the effect of 32-bit and 16-bit color with an 8-bit color palette. The dithering algorithm uses a 4 x 4 dither pattern to produce the output.

Requirements

See also

DXDitherArray