IBM Visualization Data Explorer Programmer's Reference

DXValidPositionsBoundaryBox

Function

Computes the boundary box of the valid positions of an Object o.

Syntax

#include <dx/dx.h>

DXValidPositionsBoundaryBox(Object o, Point *box)

Functional Details

If o contains any invalid positions, this routine adds (to o or to any of its descendents that are Fields) a "valid box" component consisting of an Array of 2^d points that are the corners of a boundary box (where d is the dimensionality of the data).

Point is defined as follows:

typedef struct point {
    float x,y,z;
} Point, Vector;

Notes:

1. For data of dimensionality three or less, the routine returns (in the Array pointed to by box) the eight corner points. For dimensionalities less than three, the extra dimensions of the box returned by the routine are treated as zero.

2. The boundary box returned by the routine is determined by combining the boundary boxes of all Fields contained in o.

3. Transformations are considered in computing the boundary box, but clipping objects are not. And the boundary box is not guaranteed to be the tightest possible.

Return Value

Returns o or returns NULL and might or might not set an error code, depending on the input. For example, it does not set an error code if a boundary box cannot be defined for the given input.

See Also

DXBoundingBox, DXChangedComponentValues, DXChangedComponentStructure, DXEmptyField, DXEndField, DXEndObject, DXNeighbors, DXStatistics

13.1 , "Error Handling and Messages".

[Data Explorer Home Page]