UT/UT_Cache.h

Go to the documentation of this file.

/*
 * PROPRIETARY INFORMATION.  This software is proprietary to
 * Side Effects Software Inc., and is not to be reproduced,
 * transmitted, or disclosed in any way without written permission.
 *
 * Produced by:
 *      Mark Alexander
 *      Side Effects Software Inc
 *      477 Richmond Street West
 *      Toronto, Ontario
 *      Canada   M5V 3E7
 *      416-504-9876
 *
 * NAME:        UT_Cache.h ( UT Library, C++)
 *
 * COMMENTS:
 *      An interface to a cache within Houdini. This is used so that the cache
 *    manager can monitor and manage the caches.
 *
 */
#ifndef UT_CACHE_H
#define UT_CACHE_H

#include "UT_API.h"
#include "UT_PtrArray.h"


class UT_API UT_Cache
{
public:
                 UT_Cache();
    virtual     ~UT_Cache();

    // clear this cache. May not entirely clear the cache if some items are in
    // use.
    void        utClearCache();

    // required - return the english name for this cache.
    virtual const char *utGetCacheName() const = 0;
    
    // required - return the current cache size, in bytes
    virtual int64       utGetCurrentSize() = 0;

    // required - reduce the current cache size by amount bytes. Returns the
    // amount of bytes actually freed.
    virtual int64       utReduceCacheSizeBy(int64 amount) = 0;

    
    // optional - override if the cache has a well defined maximum size
    virtual bool        utHasMaxSize() const { return false; }
    virtual int64       utGetMaxSize() { return 0; }
    virtual void        utSetMaxSize(int64) { }

    // optional - override if the cache has a well defined minimum size (this
    // doesn't include a current min size imposed by items locked in the cache)
    virtual bool        utHasMinSize() const { return false; }
    virtual int64       utGetMinSize() { return 0; }
    virtual void        utSetMinSize(int64) { }

    // override in case a method needs to be run to get the most up-to-date
    // cache information. Return true if it has changed.
    virtual bool        utUpdateCacheInfo() { return false; } 

    // get the list of caches
    static const UT_PtrArray<UT_Cache *> &utGetCacheList();

    // callback to be called when a cache is added or deleted.
    static void  setCacheAddRemoveCB(void (*callback)(void *), void *data);

    // this method attempts to free up 'amount' bytes from all the caches.
    static int64 utClearSpaceFromCaches(int64 amount);
};

#endif

---