DXCONVFILTERTYPE enumeration

Identifies a filter type to use with the IDXTConvolution interface.

Syntax

typedef enum DXCONVFILTERTYPE { 
  DXCFILTER_SRCCOPY,
  DXCFILTER_BOX7X7,
  DXCFILTER_BLUR3X3,
  DXCFILTER_SHARPEN,
  DXCFILTER_EMBOSS,
  DXCFILTER_ENGRAVE,
  DXCFILTER_NUM_FILTERS,
  DXCFILTER_CUSTOM
} DXCONVFILTERTYPE;

Constants

  • DXCFILTER_SRCCOPY
    The convolution transform should use no filtering. For this option, the output is identical to the source. All custom properties set with the IDXTConvolution interface, such as IDXTConvolution::SetConvertToGray, are ignored for this option.

  • DXCFILTER_BOX7X7
    The convolution transform should use a 7x7 blur filter. Each element of the filter matrix has an equal weight of 1/49. Selecting this filter also sets the bias to zero and alpha exclusion to FALSE.

  • DXCFILTER_BLUR3X3
    The convolution transform should use a 3x3 blur filter. The elements of the filter are shown in the following illustration. Selecting this filter also sets the bias to zero and alpha exclusion to FALSE.

  • DXCFILTER_SHARPEN
    The convolution transform should use a standard, sharpen-image filter. The elements of the filter are shown in the following illustration. Selecting this filter also sets the bias to zero and alpha exclusion to TRUE.

  • DXCFILTER_EMBOSS
    The convolution transform should use a standard emboss image filter. Selecting this filter also sets the bias to 0.7 and alpha exclusion to TRUE. Color images are converted to gray scale by this filter.

  • DXCFILTER_ENGRAVE
    The convolution transform should use a standard engrave image filter. Selecting this filter also sets the bias to 0.7 and alpha exclusion to TRUE. Color images are converted to gray scale by this filter.

  • DXCFILTER_NUM_FILTERS
    An element used for parameter validation.

  • DXCFILTER_CUSTOM
    This filter type is selected when you call the IDXTConvolution::SetCustomFilter method. It cannot be set with the IDXTConvolution::SetFilterType method.

Remarks

Options such as bias, alpha exclusion, and gray scale are discussed in detail in the IDXTConvolution interface reference.

Requirements

Minimum supported client

Windows XP

Minimum supported server

Windows 2000 Server

Header

Dxtrans.h

IDL

Dxtrans.idl

See also

IDXSurfaceFactory::BitBlt