Shapes Transform

This transform takes two optional image inputs and produces a three-dimensional (3-D) shape with the images textured onto the shape. If no images are specified, the resulting shape does not have a textured surface, and instead is a uniform color. The shape still has texture coordinates, however, so that a user can add a texture to the shape after the transform constructs it.

If two inputs are specified, the first is textured onto the front and the second is textured onto the back. If a single input is specified, it is textured onto both the front and back of the shape. The KeepAspectRatio property indicates whether the texturing preserves the aspect ratio of the specified images. Setting this property to TRUE will avoid any artificial distortion of the textured image.

The supported shapes include sheet, disc, cylinder, cone, sphere and hemisphere. The cylinder, cone, sphere, and hemisphere are surfaces of revolution, produced by revolving a line segment around the y-axis. Their texturing coordinates start at the x-y plane of intersection with the surface, and move to positive values in a clockwise fashion. If such shapes are created at this starting y-line and flattened in a counterclockwise fashion into the x-y plane, you obtain a similar layout to the original image.

The following list contains details specific to each of the shapes.

Sheet: This shape is generated in the x-y plane, centered at the origin. If inputs are provided and the aspect ratio is preserved, each side of the sheet attains the same aspect ratio as the corresponding image, with the longer extent mapped to [-1,1]. If the aspect ratio is not preserved, the images are potentially stretched in one dimension to fill the [-1,1] square sheet. If no inputs are specified, the transform generates a solid-colored square sheet of [-1,1] extent.
Disc: This shape is generated in the x-y plane, centered at the origin with a radius of 1. If inputs are provided and the aspect ratio is preserved, the transform uses a disc shaped portion of the images for texturing, such that the disc's diameter is the smaller of the x-extent or y-extent of the corresponding image. Therefore, portions of the images are not used in the textures. If the aspect ratio is not preserved, the image is shrunken into a square in order to use the maximum portion in texturing the disc.
Cylinder: This shape is generated around the y-axis, with a radius of 1. If inputs are provided and the aspect ratio is preserved, the height of the cylinder equals 2*Pi*YDim/XDim, where XDim and YDim are the x- and y-dimensions of the first input image. Note that the height of the outside of the cylinder will differ from the height of the inside in the case of the two inputs with different aspect ratios. If the aspect ratio is not preserved, the images are mapped to a cylinder with a fixed height of [-1,1]. If no inputs are specified, the transform generates a solid-colored cylinder of height [-1,1].
Cone: This shape is generated around the y-axis, with a height of [-1,1] and base (in the y = –1 plane) of radius 1. If inputs are provided, they are textured on the front and back of the cone. The KeepAspectRatio property has no relevance for this shape, because the cone inherently distorts the texture.
Sphere: This shape is centered at the origin, with a radius of 1 and the equator in the y = 0 plane. If inputs are provided, the y-dimension of textures is mapped to longitudinal lines from pole to pole at (0,1,0), and the x-dimension of textures is mapped to latitudinal lines. The KeepAspectRatio property has no relevance for this shape, because the sphere inherently distorts the texture.
Hemisphere: This shape is centered at the origin, with a radius of 1 and the equator in the y = 0 plane. If inputs are provided, the y-dimension of textures is mapped to longitudinal lines starting from the equator to the pole at (0,1,0), and the x-dimension of textures is mapped to latitudinal lines. The KeepAspectRatio property has no relevance for this shape, because the hemisphere inherently distorts the texture.

The cylinder and cone do not have the top or bottom enclosing disks, allowing the user to construct either a disk or a hemisphere as bottom or top. Constructing a composite shape in this manner also gives better flexibility for texturing the different parts with different images. The same is true for constructing a cube from six sheets, specifying a different texture for each sheet.

Note To use this transform, you need to have 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_Shapes
Globally unique identifier (GUID)	8241F015-84D3-11d2-97E6-0000F803FF7A
Programmatic identifier (ProgId)	DX3DTransform.Microsoft.Shapes
Category identifier (CATID)	CATID_DX3DTransform
Custom interfaces	IDXTShapes
Supported interfaces	None
Inputs	One or two optional image inputs of type IDXSurface.
Output	Direct3DRMMeshBuilder3

Custom Properties

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

Property	Type	Default	Description
XMinRes	integer	10	Minimum number of mesh subdivisions in the x-direction.
XMaxRes	integer	20	Maximum number of mesh subdivisions in the x-direction.
YMinRes	integer	10	Minimum number of mesh subdivisions in the y-direction.
YMaxRes	integer	20	Maximum number of mesh subdivisions in the y-direction.
KeepAspectRatio	Boolean	TRUE	Specifies whether to preserve the aspect ratio of images while texturing. If TRUE, the aspect ratio is preserved. This property is only relevant for sheet, disc, and cylinder shapes.
DoubleSided	Boolean	TRUE	Specifies whether to create both an inside and outside face. If FALSE, only an outside face is created.
Color	BSTR	#FFFFFFFF	A string that selects color of the shape's surface if no texture is specified. The color is specified in #AARRGGBB hexadecimal format, where AA is the hexadecimal alpha value, RR is the hexadecimal value for red, GG is the hexadecimal value for green, and BB is the hexadecimal value for blue. The color can also be specified with standard HTML color strings such as red, blue, and yellow.
Shape	BSTR	SHEET	The shape to create. Possible values are SHEET, DISC, CYLINDER, CONE, SPHERE, and HEMISPHERE. See above for details on each shape.

Remarks

This transform supports the Quality property on the IDXTransform interface. It linearly maps this property value to obtain two values within the ranges of XMinRes to XMaxRes and YMinRes to YMaxRes, respectively. The transform uses these values as the number of mesh subdivisions in the x-direction and y-direction of the generated shapes.