IBM Visualization Data Explorer Programmer's Reference

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".

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