# IBM Visualization Data Explorer Programmer's Reference

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

### DXEndField

Function

Creates the standard components "box" and "neighbors" that other modules expect Field `f` to contain.

Syntax
`
#include <dx/dx.h>
`

Field DXEndField(Field f)

Functional Details

The "box" component defines the corners of an n-dimensional box that contains all of the positions described by the Field's "positions" The "neighbors" component contains information that provides a mechanism for quick access to neighboring interpolation elements.

Note: | A "neighbors" component is not created for a Field with regular connections.

In addition, `DXEndField` sets the "dep" and "ref" attributes, if not already set, on the components listed in Table 4.

Table 4. Set Attributes

Component | Attribute | Value
--- | --- | ---
"positions" | "dep" | "positions"
"connections" | "ref" | "positions"
"data" | "dep" | "positions"
"colors" | "dep" | "positions"
"front colors" | "dep" | "positions"
"back colors" | "dep" | "positions"
"opacities" | "dep" | "positions"
"tangents" | "dep" | "positions"
"normals" | "dep" | "positions"
"binormals" | "dep" | "positions"

During this phase, `DXEndField` also checks to make sure that the number of elements in a component being set to depend on the "positions" component does actually match the number of positions in the Field.

`DXEndField` also trims all of a Field's component Arrays to use the amount of space actually containing data as specified by `DXAddArrayData`. Thus, for optimal performance, `DXEndField` should be called just prior to returning a Field. Further, after a call to `DXEndField`, pointers obtained by calls to `DXGetArrayData` to data contained in Arrays that are components of a Field cannot be assumed valid.

If you are creating a Group that contains several Fields, then `DXEndObject` may be called instead on the Group structure. This will parallelize the application of the `DXEndField` calls to the member Fields on architectures that support parallelism.

For a more complete examination of a Field, including checks to ensure that indices contained in components that refer to other components are correct, see additional details of the `Verify` module in Chapter 1. "Data Explorer Tools" in IBM Visualization Data Explorer User's Reference.

Return Value

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

See Also

`DXBoundingBox, DXChangedComponentValues, DXChangedComponentStructure, DXEmptyField, DXEndObject, DXNeighbors, DXStatistics, Verify`

"Standard Components".

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