llvolumemgr.h

Go to the documentation of this file.

#ifndef LL_LLVOLUMEMGR_H
#define LL_LLVOLUMEMGR_H

#include <map>

#include "llvolume.h"
#include "llmemory.h"
#include "llthread.h"

class LLVolumeParams;
class LLVolumeLODGroup;

class LLVolumeLODGroup
{
        LOG_CLASS(LLVolumeLODGroup);
        
public:
        enum
        {
                NUM_LODS = 4
        };

        LLVolumeLODGroup(const LLVolumeParams &params);
        ~LLVolumeLODGroup();
        bool cleanupRefs();

        static S32 getDetailFromTan(const F32 tan_angle);
        static void getDetailProximity(const F32 tan_angle, F32 &to_lower, F32& to_higher);
        static F32 getVolumeScaleFromDetail(const S32 detail);

        LLVolume* getLODVolume(const S32 detail);
        BOOL derefLOD(LLVolume *volumep);
        S32 getNumRefs() const { return mRefs; }
        
        const LLVolumeParams* getVolumeParams() const { return &mVolumeParams; };

        F32     dump();
        friend std::ostream& operator<<(std::ostream& s, const LLVolumeLODGroup& volgroup);

protected:
        LLVolumeParams mVolumeParams;

        S32 mRefs;
        S32 mLODRefs[NUM_LODS];
        LLPointer<LLVolume> mVolumeLODs[NUM_LODS];
        static F32 mDetailThresholds[NUM_LODS];
        static F32 mDetailScales[NUM_LODS];
        S32             mAccessCount[NUM_LODS];
};

class LLVolumeMgr
{
public:
        LLVolumeMgr();
        virtual ~LLVolumeMgr();
        BOOL cleanup();                 // Cleanup all volumes being managed, returns TRUE if no dangling references

        virtual LLVolumeLODGroup* getGroup( const LLVolumeParams& volume_params ) const;

        // whatever calls getVolume() never owns the LLVolume* and
        // cannot keep references for long since it may be deleted
        // later.  For best results hold it in an LLPointer<LLVolume>.
        LLVolume *refVolume(const LLVolumeParams &volume_params, const S32 detail);
        void unrefVolume(LLVolume *volumep);

        void dump();

        // manually call this for mutex magic
        void useMutex();

        friend std::ostream& operator<<(std::ostream& s, const LLVolumeMgr& volume_mgr);

protected:
        void insertGroup(LLVolumeLODGroup* volgroup);
        // Overridden in llphysics/abstract/utils/llphysicsvolumemanager.h
        virtual LLVolumeLODGroup* createNewGroup(const LLVolumeParams& volume_params);

protected:
        typedef std::map<const LLVolumeParams*, LLVolumeLODGroup*, LLVolumeParams::compare> volume_lod_group_map_t;
        volume_lod_group_map_t mVolumeLODGroups;

        LLMutex* mDataMutex;
};

#endif // LL_LLVOLUMEMGR_H

---