# IBM Visualization Data Explorer Programmer's Reference

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

### DXAddLine, ...Triangle, ...Quad, ...Tetrahedron, ...Lines, ...Triangles, ...Quads, ...Tetrahedra

Function Adds interpolation element(s) to a Field.

Syntax

    #include <dx/dx.h>
    Field DXAddLine(Field f, int id, Line l)
    Field DXAddTriangle(Field f, int id, Triangle t)
    Field DXAddQuad(Field f, int id, Quadrilateral q)
    Field DXAddTetrahedron(Field f, int id, Tetrahedron t)
    Field DXAddLines(Field f, int start, int n, Line *l)
    Field DXAddTriangles(Field f, int start, int n, Triangle *t)
    Field DXAddQuads(Field f, int start, int n, Quadrilateral *q)
    Field DXAddTetrahedra(Field f, int start, int n, Tetrahedron *t)

.

Functional Details The interpolation elements generated by these routines are stored in the "connections" component.

`DXAddLine , DXAddTriangle , DXAddQuad , DXAddTetrahedron` | Add a single line, triangle, quad, or tetrahedron to `f` with the specified zero-based `id`. If necessary, a routine creates the "connections" component.
`DXAddLines , DXAddTriangles , DXAddQuads , DXAddTetrahedra` | Add `n` lines, triangles, quads, or tetrahedra to `f`. Identifiers begin with `start`. If necessary, a routine creates the "connections" component.

`Lines , Triangles , Quadrilaterals , and Tetrahedra.` are defined as follows:

    typedef struct line {
        PointId p, q;
    } Line;
    typedef struct triangle {
        PointId p, q, r;
    } Triangle;
    typedef struct quadrilateral {
        PointId p, q, r, s;
    } Quadrilateral;
    typedef struct tetrahedron {
        PointId p, q, r, s;
    } Tetrahedron;

Note: It is an error to attempt adding one kind of interpolation element to a "connections" component that already contains a different kind.

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

See Also `DXSetConnections, DXGetConnections`

"Connections".

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