viewlodlist.h

Go to the documentation of this file.

#ifndef VIEWLODLIST_H
#define VIEWLODLIST_H
 
#include "assert.h"
#include "compat.h"
#include "mxstl/stlcompat.h"
#include "realtime/lodlist.h"
 
#include <string.h>
 
#pragma warning(disable : 4237)
#pragma warning(disable : 4786)
 
class ViewLOD;
class ViewLODListManager;
 
// ViewLODList
//
// An ViewLODList is an LODList that is shared among instances of the "same ROI".
//
// ViewLODLists are managed (created and destroyed) by ViewLODListManager.
//
 
class ViewLODList : public LODList<ViewLOD> {
    friend ViewLODListManager;
 
protected:
    ViewLODList(size_t capacity, ViewLODListManager* owner);
 
    ~ViewLODList() override;
 
public:
    inline int AddRef();
 
    inline int Release();
 
#ifdef _DEBUG
    void Dump(void (*pTracer)(const char*, ...)) const;
#endif
 
private:
    int m_refCount;              
    ViewLODListManager* m_owner; 
};
 
//
 
typedef const char* ROIName;
 
struct ROINameComparator {
    unsigned char operator()(const ROIName& rName1, const ROIName& rName2) const
    {
        return strcmp((const char*) rName1, (const char*) rName2) > 0;
    }
};
 
//
// ViewLODListManager
//
// ViewLODListManager manages creation and sharing of ViewLODLists.
// It stores ViewLODLists under a name, the name of the ROI where
// the ViewLODList belongs.
 
class ViewLODListManager {
 
    typedef map<ROIName, ViewLODList*, ROINameComparator> ViewLODListMap;
 
public:
    ViewLODListManager();
 
    virtual ~ViewLODListManager();
 
    ViewLODList* Create(const ROIName& rROIName, int lodCount);
 
    ViewLODList* Lookup(const ROIName&) const;
 
    unsigned char Destroy(ViewLODList* lodList);
 
#ifdef _DEBUG
    void Dump(void (*pTracer)(const char*, ...)) const;
#endif
 
private:
    static int g_ROINameUID;        
 
    ViewLODListMap m_map;           
};
 
//
// Implementation notes:
//
// - ViewLODList instances are reference counted and deleted when their count reaches zero.
// - Each list is associated with a string key (the ROI type's name) in ViewLODListManager.
// - New lists are created with unique names in case of collisions, using g_ROINameUID for disambiguation.
//
// [AI] The overall pattern supports resource sharing among many ROI instances of the same type while maintaining
// correct resource lifetime, suitable for geometry sharing in a 3D engine.
//
 
#endif // VIEWLODLIST_H