DXTMISCFLAGS enumeration

Describes flags that specify transform capabilities and rendering options.

Syntax

typedef enum DXTMISCFLAGS { 
  DXTMF_BLEND_WITH_OUTPUT    = ( 1L << 0 ),
  DXTMF_DITHER_OUTPUT        = ( 1L << 1 ),
  DXTMF_OPTION_MASK          = ( 0x0000 FFFF ),
  DXTMF_VALID_OPTIONS        = ( DXTMF_BLEND_WITH_OUTPUT | DXTMF_DITHER_OUTPUT ),
  DXTMF_BLEND_SUPPORTED      = ( 1L << 16 ),
  DXTMF_DITHER_SUPPORTED     = ( 1L << 17 ),
  DXTMF_INPLACE_OPERATION    = ( 1L << 24 ),
  DXTMF_BOUNDS_SUPPORTED     = ( 1L << 25 ),
  DXTMF_PLACEMENT_SUPPORTED  = ( 1L << 26 ),
  DXTMF_QUALITY_SUPPORTED    = ( 1L << 27 ),
  DXTMF_OPAQUE_RESULT        = ( 1L << 28 ),
  DXTMF_DPI_AWARE            = ( 1L << 29 )
} DXTMISCFLAGS;

Constants

  • DXTMF_BLEND_WITH_OUTPUT
    Transform will perform a composite over the output surface when writing the result.

  • DXTMF_DITHER_OUTPUT
    Transform dithering the result as it is written on the output surface. This flag can only be set if the DXTMF_DITHER_SUPPORTED flag is set for the transform.

  • DXTMF_OPTION_MASK
    Bitmask that defines valid transform-specific flags.

  • DXTMF_VALID_OPTIONS
    Bitmask that defines valid, user-selectable option flags.

  • DXTMF_BLEND_SUPPORTED
    Transform supports alpha blending.

  • DXTMF_DITHER_SUPPORTED
    Transform supports image dithering.

  • DXTMF_INPLACE_OPERATION
    Transform reads data from the output surface to compute the result.

  • DXTMF_BOUNDS_SUPPORTED
    Transform supports use of the DXBNDS structure.

  • DXTMF_PLACEMENT_SUPPORTED
    Transform supports use of the DXVEC structure.

  • DXTMF_QUALITY_SUPPORTED
    Transform supports the Quality property with a value from 0 to 1 to specify how well to render the result.

  • DXTMF_OPAQUE_RESULT
    Transform produces all output with an alpha value of 255, making all samples opaque.

  • DXTMF_DPI_AWARE
    Internet Explorer 8. Transform supports higher dpi resolutions. Used to determine whether a filter can be measured and rendered at display resolution, or if it must use document resolution for compatibility.

Remarks

Transform capabilities are determined by using the IDXTransform::GetMiscFlags method, and certain rendering options can be selected with the IDXTransform::SetMiscFlags method.

The constructor of the transform determines which of the _SUPPORTED flags are set for a transform. You need to use the IDXTransform::GetMiscFlags method to find out which of these transform flags are set. Transform users can only read the _SUPPORTED flags.

For example, if a call to IDXTransform::GetMiscFlags returns a value with the DXTMF_QUALITY_SUPPORTED flag set, you can use the IDXTransform::SetQuality and IDXTransform::GetQuality methods to adjust the rendering quality of the output.

Use the IDXTransform::SetMiscFlags method to change the DXTMF_BLEND_WITH_OUTPUT and DXTMF_DITHER_OUTPUT flags.

Requirements

Minimum supported client

Windows XP

Minimum supported server

Windows 2000 Server

Header

Dxtrans.h

IDL

Dxtrans.idl

See also

IDXTransform::Execute