DXTMISCFLAGS Enumeration

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

Syntax

typedef enum DXTMISCFLAGS
{
    DXTMF_BLEND_WITH_OUTPUT   = ( 1L << 0 ),
    DXTMF_DITHER_OUTPUT   = ( 1L << 1 ),
    DXTMF_OPTION_MASK         = (0x0000FFFF),
    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 )

} DXTMISCFLAGS;

Elements

DXTMF_BLEND_WITH_OUTPUT

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

DXTMF_DITHER_OUTPUT

Transform will dither 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 will read 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 will produce all output with an alpha value of 255, making all samples opaque.

Remarks

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.