Function
Creates an Array specifying the linear connections between points.
Syntax
#include <dx/dx.h>
PathArray DXNewPathArray(int count)
Functional Details
The type of a is implicitly set to integer, the rank to 1, and the shape to 2. The count parameter specifies the number of positions connected in the path defined by the Path Array.
Path Arrays are used to specify 1-dimensional regular axes of a regular or partially regular "connections" component representing count-1 segments along the axis. These are generally combined in Mesh Arrays to create 1-dimensional or higher regular-connection grids.
In the case of fully regular connections (e.g., when one or more path arrays are to be combined in a Mesh Array), it is often easier to use DXMakeGridConnections.
The Array created can be deleted with DXDelete. See 4.2 , "Memory Management".
Return Value
Returns the Path Array or returns NULL and sets an error code.
See Also
DXGetPathArrayInfo, DXGetPathOffset, DXMakeGridConnections, DXMakeGridConnectionsV, DXSetPathOffset