# 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]

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