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

See also

IDXTransform::Execute