HeightField Transform

Generates a height field mesh from an input surface object. Each color in the surface, depending on its intensity, is mapped to a corresponding height in forming a three-dimensional (3-D) mesh.

Note To use this transform, you need to have Microsoft® DirectX® Media 6, 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_HeightField
Globally unique identifier (GUID)	04921709-B159-11d1-9207-0000F8758E66
Programmatic identifier (ProgId)	DX3DTransform.Microsoft.HeightField
Category identifier (CATID)	CATID_DX3DTransform
Custom interfaces	IHeightField
Supported interfaces	IDXEffect
Inputs	Single input required of type IDXSurface.
Output	IDirect3DRMMeshBuilder3

Custom Properties

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

Property	Type	Default	Description
Depth	float	1.0	Maximum depth in the surface. Positive values produce mountainous surfaces, while negative values produce valleys.
Samples	long	65	Number of vertices to create along the horizontal and vertical axes of the mesh. Larger numbers produce more detailed terrain, but take longer to render.
Width	float	2.0	Width of the 3-D surface to create.
Height	float	2.0	Height of the 3-D surface to create.