IBM Visualization Data Explorer Programmer's Reference

[ Bottom of Page | Previous Page | Next Page | Table of Contents | Partial Table of Contents | Index ]

DXApplyTransform

Function Creates a new Object by recursively applying a transform to a specified Object.

Syntax


#include <dx/dx.h>
Object DXApplyTransform(Object o, Matrix *m)

.

Functional Details The routine descends Object o, applying transform m to the components of the Fields encountered. Any transforms present in the Object are accumulated to form a composite transform before being applied to subObjects. (The Object created can be deleted with DXDelete. See 4.2 , "Memory Management".)

DXApplyTransform returns a new Object (i.e., a copy of o with transforms applied). This routine can be applied directly to Array objects. It also removes the "box" component from transformed Fields.

Positional Components,

Are transformed by the composite matrix. (Positional components are "positions" and components with the "geometric" attribute "positional".)

Vector Components,

Are transformed by the adjoint transpose of the composite matrix. (Vector components are "normals," "binormals," "tangents," "gradient," and components with the "geometric" attribute "vector.")

Return Value Returns o or returns NULL and sets an error code.

See Also DXConcatenate, DXInvert, DXTranspose, DXAdjointTranspose, DXDeterminant, DXApply, DXRotateX, DXRotateY, DXRotateZ, DXScale, DXTranslate, DXMat,

16.1 , "Transformation".


[ Top of Page | Previous Page | Next Page | Table of Contents | Partial Table of Contents | Index ]
[Data Explorer Documentation | QuickStart Guide | User's Guide | User's Reference | Programmer's Reference | Installation and Configuration Guide ]

[Data Explorer Home Page | Contact Data Explorer | Same document on Data Explorer Home Page ]


[IBM Home Page | Order | Search | Contact IBM | Legal ]