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

 

 

Show: