long *cxPyrActiveList(cxPyramid *pyr, long dstLayer, long *numActive)
integer function cxPyrActiveList( pyr, dstLayer, numActive ) integer pyr integer dstLayer integer numActive
- Input pyramid structure for which computations are to be performed.
- Input layer of next active elements (1-based value).
- Output number of active elements in returned array at layer dstLayer.
cxPyrActiveList is useful in circumstances where only the active elements at a given level are to be manipulated. This is the approved way of determining the pyramid elements which should be manipulated or displayed in any pyramid-based module (the alternative method of displaying all elements available at a given level is not correct).
The returned index array is considered to be owned by the caller of cxPyrActiveList and should be freed (with free(3C)) after use.
Other routines exist to flag elements at a specified layer as active/inactive and to return a variable-length array of the indices of active elements subordinate to the current layer.cxPyramid(3E), cxPyrActiveNext(3E), cxPyrActive(3E).
Last modified: Mon Nov 6 16:33:41 GMT 2000
[ Documentation Home ] © The Numerical Algorithms Group Ltd, Oxford UK. 1999