NAME

cxPyrNew - allocates a pyramid structure

C SPECIFICATION

#include <cx/DataAccess.h>

cxPyramid *cxPyrNew(long count)

FORTRAN SPECIFICATION

integer function cxPyrNew(count)
integer count

PARAMETERS

count
The number of layers in the pyramid.

FUNCTION RETURN VALUE

The return value for this function is a pointer to a newly allocated pyramid structure.

DESCRIPTION

cxPyrNew allocates a pyramid with a base lattice and count layers, where each layer consists of a lattice and a connection list, and returns a pointer to the structure. The newly allocated pyramid has NULL pointers for all lattice and connection list components. Routines cxPyrSet and cxPyrLayerSet set the base lattice and layer contents of the pyramid. The allocated pyramid is a shared memory object with reference counting. The reference count is set to one upon allocation and need not be incremented for use. See the IRIS Explorer Module Writer's Guide for more information on reference counted, shared memory objects.

SEE ALSO

cxPyrSet(3E), cxPyrLayerSet(3E), cxDataRefDec(3E)
Last modified: Mon Nov 18 13:52:53 GMT 1996
[ Documentation Home ]
© The Numerical Algorithms Group Ltd, Oxford UK. 1996