Imported existing code

indra/llmath/llvolumemgr.h

@@ -0,0 +1,117 @@
+/** 
+ * @file llvolumemgr.h
+ * @brief LLVolumeMgr class.
+ *
+ * $LicenseInfo:firstyear=2002&license=viewergpl$
+ * 
+ * Copyright (c) 2002-2009, Linden Research, Inc.
+ * 
+ * Second Life Viewer Source Code
+ * The source code in this file ("Source Code") is provided by Linden Lab
+ * to you under the terms of the GNU General Public License, version 2.0
+ * ("GPL"), unless you have obtained a separate licensing agreement
+ * ("Other License"), formally executed by you and Linden Lab.  Terms of
+ * the GPL can be found in doc/GPL-license.txt in this distribution, or
+ * online at http://secondlifegrid.net/programs/open_source/licensing/gplv2
+ * 
+ * There are special exceptions to the terms and conditions of the GPL as
+ * it is applied to this Source Code. View the full text of the exception
+ * in the file doc/FLOSS-exception.txt in this software distribution, or
+ * online at
+ * http://secondlifegrid.net/programs/open_source/licensing/flossexception
+ * 
+ * By copying, modifying or distributing this software, you acknowledge
+ * that you have read and understood your obligations described above,
+ * and agree to abide by those obligations.
+ * 
+ * ALL LINDEN LAB SOURCE CODE IS PROVIDED "AS IS." LINDEN LAB MAKES NO
+ * WARRANTIES, EXPRESS, IMPLIED OR OTHERWISE, REGARDING ITS ACCURACY,
+ * COMPLETENESS OR PERFORMANCE.
+ * $/LicenseInfo$
+ */
+
+#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* refLOD(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