Function
Returns information about a positions grid.
Syntax
#include <dx/dx.h>
Array DXQueryGridPositions(Array a, int *n, int *counts,
float *origin, float *deltas)
Functional Details
Returns NULL if a is not a regular grid of the sort constructed by DXMakeGridPositions (i.e. a Product Array containing n terms, each term being a TYPE_FLOAT, n-dimensional Regular Array). If n is not NULL, it returns the number of dimensions in the grid in *n. If counts is not NULL, it returns the number of points along each delta vector in the Array pointed to by counts. If origin is not NULL, it returns the n-dimensional origin in the Array pointed to by origin. If deltas is not NULL, it returns the n n-dimensional delta vectors in the Array pointed to by deltas.
This routine is commonly used to determine whether the "positions" components are fully regular and to provide an easy mechanism for accessing information that describes the regular-positions grid. The information returned by DXQueryGridPositions often makes it possible to process regular positions Arrays without explicit expansion.
Array handles provide a simple mechanism for accessing individual elements of a regular grid without expansion.
Return Value
Returns a (if a is a regular grid ) or NULL (if it is not) without setting an error code.
See Also
DXCreateArrayHandle, DXMakeGridConnections, DXMakeGridConnectionsV, DXMakeGridPositions, DXMakeGridPositionsV, DXQueryGridConnections
"Creating Positions and Connections Grids".