Imported existing code

indra/newview/llworld.h

@@ -0,0 +1,208 @@
+/** 
+ * @file llworld.h
+ * @brief Collection of viewer regions in the vacinity of the user.
+ *
+ * Represents the whole world, so far as 3D functionality is conserned.
+ * Always contains the region that the user's avatar is in along with
+ * neighboring regions. As the user crosses region boundaries, new
+ * regions are added to the world and distant ones are rolled up.
+ *
+ * $LicenseInfo:firstyear=2001&license=viewergpl$
+ * 
+ * Copyright (c) 2001-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_LLWORLD_H
+#define LL_LLWORLD_H
+
+#include "llpatchvertexarray.h"
+
+#include "llmath.h"
+#include "v3math.h"
+#include "llmemory.h"
+#include "llstring.h"
+#include "llviewerpartsim.h"
+#include "llviewerimage.h"
+#include "llvowater.h"
+
+class LLViewerRegion;
+class LLVector3d;
+class LLMessageSystem;
+class LLNetMap;
+class LLHost;
+
+class LLViewerObject;
+class LLSurfacePatch;
+
+class LLCloudPuff;
+class LLCloudGroup;
+class LLVOAvatar;
+
+// LLWorld maintains a stack of unused viewer_regions and an array of pointers to viewer regions
+// as simulators are connected to, viewer_regions are popped off the stack and connected as required
+// as simulators are removed, they are pushed back onto the stack
+
+class LLWorld : public LLSingleton<LLWorld>
+{
+public:
+	LLWorld();
+	void destroyClass();
+
+	LLViewerRegion*	addRegion(const U64 &region_handle, const LLHost &host);
+		// safe to call if already present, does the "right thing" if
+		// hosts are same, or if hosts are different, etc...
+	void			removeRegion(const LLHost &host);
+
+	void	disconnectRegions(); // Send quit messages to all child regions
+
+	LLViewerRegion*			getRegion(const LLHost &host);
+	LLViewerRegion*			getRegionFromPosGlobal(const LLVector3d &pos);
+	LLViewerRegion*			getRegionFromPosAgent(const LLVector3 &pos);
+	LLViewerRegion*			getRegionFromHandle(const U64 &handle);
+	BOOL					positionRegionValidGlobal(const LLVector3d& pos);			// true if position is in valid region
+	LLVector3d				clipToVisibleRegions(const LLVector3d &start_pos, const LLVector3d &end_pos);
+
+	void					updateAgentOffset(const LLVector3d &offset);
+
+	// All of these should be in the agent coordinate frame
+	LLViewerRegion*			resolveRegionGlobal(LLVector3 &localpos, const LLVector3d &position);
+	LLViewerRegion*			resolveRegionAgent(LLVector3 &localpos, const LLVector3 &position);
+	F32						resolveLandHeightGlobal(const LLVector3d &position);
+	F32						resolveLandHeightAgent(const LLVector3 &position);
+
+	// Return the lowest allowed Z point to prevent objects from being moved
+	// underground.
+	F32 getMinAllowedZ(LLViewerObject* object);
+
+	// takes a line segment defined by point_a and point_b, then
+	// determines the closest (to point_a) point of intersection that is
+	// on the land surface or on an object of the world.
+	// Stores results in "intersection" and "intersection_normal" and
+	// returns a scalar value that is the normalized (by length of line segment) 
+	// distance along the line from "point_a" to "intersection".
+	//
+	// Currently assumes point_a and point_b only differ in z-direction,
+	// but it may eventually become more general.
+	F32 resolveStepHeightGlobal(const LLVOAvatar* avatarp, const LLVector3d &point_a, const LLVector3d &point_b,
+							LLVector3d &intersection, LLVector3 &intersection_normal,
+							LLViewerObject** viewerObjectPtr=NULL);
+
+	LLSurfacePatch *		resolveLandPatchGlobal(const LLVector3d &position);
+	LLVector3				resolveLandNormalGlobal(const LLVector3d &position);		// absolute frame
+
+	U32						getRegionWidthInPoints() const	{ return mWidth; }
+	F32						getRegionScale() const			{ return mScale; }
+
+	// region X and Y size in meters
+	F32						getRegionWidthInMeters() const	{ return mWidthInMeters; }
+	F32						getRegionMinHeight() const		{ return -mWidthInMeters; }
+	F32						getRegionMaxHeight() const		{ return MAX_OBJECT_Z; }
+
+	void					updateRegions(F32 max_update_time);
+	void					updateVisibilities();
+	void					updateParticles();
+	void					updateClouds(const F32 dt);
+	LLCloudGroup *			findCloudGroup(const LLCloudPuff &puff);
+
+	void					renderPropertyLines();
+
+	void resetStats();
+	void updateNetStats(); // Update network statistics for all the regions...
+
+	void printPacketsLost();
+	void requestCacheMisses();
+
+	// deal with map object updates in the world.
+	static void processCoarseUpdate(LLMessageSystem* msg, void** user_data);
+
+	F32 getLandFarClip() const;
+	void setLandFarClip(const F32 far_clip);
+
+	LLViewerImage *getDefaultWaterTexture();
+	void updateWaterObjects();
+	void waterHeightRegionInfo(std::string const& sim_name, F32 water_height);
+	void shiftRegions(const LLVector3& offset);
+
+	void setSpaceTimeUSec(const U64 space_time_usec);
+	U64 getSpaceTimeUSec() const;
+
+	void getInfo(LLSD& info);
+
+public:
+	typedef std::list<LLViewerRegion*> region_list_t;
+	const region_list_t& getRegionList() const { return mActiveRegionList; }
+
+	// Returns lists of avatar IDs and their world-space positions within a given distance of a point.
+	// All arguments are optional. Given containers will be emptied and then filled.
+	// Not supplying origin or radius input returns data on all avatars in the known regions.
+	void getAvatars(
+		std::vector<LLUUID>* avatar_ids = NULL,
+		std::vector<LLVector3d>* positions = NULL, 
+		const LLVector3d& relative_to = LLVector3d(), F32 radius = FLT_MAX) const;
+
+private:
+	region_list_t	mActiveRegionList;
+	region_list_t	mRegionList;
+	region_list_t	mVisibleRegionList;
+	region_list_t	mCulledRegionList;
+
+	// Number of points on edge
+	static const U32 mWidth;
+
+	// meters/point, therefore mWidth * mScale = meters per edge
+	static const F32 mScale;
+
+	static const F32 mWidthInMeters;
+
+	F32 mLandFarClip;					// Far clip distance for land.
+	LLPatchVertexArray		mLandPatch;
+	S32 mLastPacketsIn;
+	S32 mLastPacketsOut;
+	S32 mLastPacketsLost;
+
+	U64 mSpaceTimeUSec;
+
+	////////////////////////////
+	//
+	// Data for "Fake" objects
+	//
+
+	std::list<LLVOWater*> mHoleWaterObjects;
+	LLPointer<LLVOWater> mEdgeWaterObjects[8];
+
+	LLPointer<LLViewerImage> mDefaultWaterTexturep;
+};
+
+
+void process_enable_simulator(LLMessageSystem *mesgsys, void **user_data);
+void process_disable_simulator(LLMessageSystem *mesgsys, void **user_data);
+
+void process_region_handshake(LLMessageSystem* msg, void** user_data);
+
+void send_agent_pause();
+void send_agent_resume();
+
+#endif