- makes an uncompressed copy of an element in a pyramid structure
cxPyramid *cxPyrEleDupExpand(cxPyramid *src, long layer, long elem)
integer function cxPyrEleDupExpand(src, layer, elem)
Input pyramid data structure.
Input layer from which to duplicate and expand.
Input element index from which to duplicate and expand.
FUNCTION RETURN VALUE
The returned value for this function is a pointer to the newly created
cxPyrEleDupExpand makes a copy of an element in its input
pyramid for return to the caller. The element to be copied is
specified by the layer and elem inputs, which give the
pyramid layer number and element index, respectively.
The value of layer is one-based, so that a layer of two
corresponds to the two-dimensional contents of the pyramid. The
element index is zero-based, so that the first element is
The duplication extends to all pyramid contents subordinate to the
chosen element, so that parts of constituent cxLattice and
cxConnection structures are duplicated as well. The output may not be
an exact copy of the input, in that any compression of the input
pyramid is expanded in place in creating the output.
cxPyrEleDupExpand can be used to handle compressed pyramids
without fully expanding them, by expanding each compressed element,
manipulating and then freeing the expanded version.
cxPyrEleDupExpand returns a NULL if its input is malformed or if an
allocation error occurs. The returned pyramid is a reference counted
structure owned by the caller.
Last modified: Mon Nov 6 16:33:45 GMT 2000
[ Documentation Home ]
© The Numerical Algorithms Group Ltd, Oxford UK. 1996