Rib Memory Functions

Quick Reference List to Rib Memory Handling Functions

Basic Memory Functions

• RibMalloc() -- Allocate a memory block.
• RibRealloc() -- Resize or replace a given block of memory to provide a block of a different size.
• RibFree() -- Deallocate a memory block.
• RibFreeBasisMatrix() -- Deallocate a memory block that represents a basis matrix. A check is done to see if the memory is one of the RI_ constants which can not be freed. If an RI_ constant such RiPowerBasis is given, RibFreeBasisMatrix() simply returns without error.

RI Subclassing Memory Functions

• RibQueryKeepData() -- Returns nonzero value if pointers given in present Ri call point to memory areas that should not be freed.
• RibShouldFreeData() -- Same as RibQueryKeepData() except that it resets the status flag called kRIB_STATUS_KEEP_DATA.

Parameter List Memory Functions

• RibFreeVectorData() -- Deallocate data in the parameter list of token/param pairs.
• RibVectorCacheInit() -- Sets up a set of arrays referred to as the vector cache.
• RibCacheVector() -- RibCacheVector() increases the size of four arrays associated with each RIB handle. Most tools should not need to call this function directly.
• RibCopyVectorCache() -- Makes a copy of n items from the start of a RIB statement's token/parameter pairs based on the vector cache.
• RibFreeVectorCache() -- Frees the token and parameters data given in vector form to the present Ri call.
• RibGetVectorCache() -- Returns the last read parameter list using vector form.
• RibGetVectorCacheInfo() -- Returns information about the last read parameter list read.

Memory Test Functions for Finding Memory Leaks

• RibMemoryTestInit() -- Sets up counters and lists used by memory testing functions.
• RibMemoryTestMalloc() -- Internal call used by the test version of RibMalloc().
• RibMemoryTestFree() -- Internal call used by the test version of RibFree().
• RibMemoryTestResults() -- Prints results so far accumulated by the memory testing functions.
• RibMemoryTestStepOverAllowed() -- Function used only by the Affine libraries to reduce some of the data collected by the memory testing functions.