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

Minimum supported client

Windows XP

Minimum supported server

Windows 2000 Server

Header

Dxhelper.h

See also

DXDitherArray