- returns a pointer to the base lattice and the number of layers from a pyramid
cxErrorCode cxPyrGet(cxPyramid *src, cxLattice **baseLat,
integer function cxPyrGet(src, baselat, count)
- Input pyramid data structure.
- On output, the lowest level lattice in the pyramid.
- On output, the number of layers in the pyramid.
The return value for this function is an integer error code enumeration.
extracts two pieces of information from a pyramid data structure, a pointer to the base lattice and the number of lattice-connection layers in the pyramid. The base lattice resides at the lowest level in the pyramid. Each lattice-connection layer stores higher-dimensional data and its relation to data of dimension one lower. Given the number of layers in a pyramid, another routine cxPyrLayerGet
can be used to access the individual lattices and connection list structures within the source pyramid. A return value of cx_err_none indicates success, while another value indicates a NULL input pyramid.
The user can tell the function not to get information on a particular field by passing a NULL pointer value. You need not create dummy variables in the calling routine which calls cxPyrGet, because the request is simply ignored when the pointer comes in NULL.
Last modified: Mon Nov 6 16:33:45 GMT 2000
[ Documentation Home ]
© The Numerical Algorithms Group Ltd, Oxford UK. 1996