BasicImage Transform

Performs several basic image transforms, including: rotating by 90 degree increments, mirroring, color inverting, X-ray effects, grayscale effects, and modifying the opacity. These effects apply additively and in the specified order.

Note To use this transform, you need to have Microsoft® DirectX® Media 6, Microsoft Internet Explorer 5, Microsoft Windows® 98 Second Edition, or Windows 2000 installed.

Transform Specifications

The following table contains the information you need in order to use this transform in C++ and script.

Class identifier (CLSID)	CLSID_BasicImageEffects
Globally unique identifier (GUID)	16B280C8-EE70-11D1-9066-00C04FD9189D
Programmatic identifier (ProgId)	DXImageTransform.Microsoft.BasicImage
Category identifier (CATID)	CATID_DXImageTransform
Custom interfaces	IDXBasicImage
Supported interfaces	None
Inputs	One is required of type IDXSurface.
Output	IDXSurface

Custom Properties

The following table lists the custom properties that control the transform output.

Property	Type	Default	Description
Rotation	integer	0	Multiple of 90 degrees that the surface is rotated clockwise by. The valid range for this attribute is 0 to 3.
Mirror	Boolean	FALSE	If TRUE, the transform mirrors the image along the y-axis.
Invert	Boolean	FALSE	If TRUE, the transform maps to the RGB inverse of the color.
XRay	Boolean	FALSE	If TRUE, the complement of the red and green average is used as the grayscale.
Grayscale	Boolean	FALSE	If TRUE, the transform maps the saturation of the color as a grayscale.
Opacity	float	1.0	Sets the opacity of the image. The value ranges from 0.0 (transparent) to 1.0 (opaque).
Mask	Boolean	FALSE	If TRUE, the output image is a masked version of the input. The mask is created by making all transparent samples opaque and all other samples transparent.
MaskColor	int	0x00000000	The color of the mask in 32-bit ARGB format.