diff options
author | Erik Kundiman <erik@megapahit.org> | 2024-05-16 13:52:40 +0800 |
---|---|---|
committer | Erik Kundiman <erik@megapahit.org> | 2024-05-16 13:52:40 +0800 |
commit | 6d51e91895a7f2435c46a876410ccc6c63fe8c82 (patch) | |
tree | f2b48ebd99cb414227bf365f47665b8d4baa752b /indra/llmath/llcamera.h | |
parent | d1b5917bb9c92e4e47eba19b43781e4d1328b1ca (diff) | |
parent | 094dcc07f8c1d90ae723dbe60eddacb90a09eae8 (diff) |
Merge tag '7.1.7-release'
source for viewer 7.1.7.8974243247
Diffstat (limited to 'indra/llmath/llcamera.h')
-rw-r--r-- | indra/llmath/llcamera.h | 326 |
1 files changed, 163 insertions, 163 deletions
diff --git a/indra/llmath/llcamera.h b/indra/llmath/llcamera.h index c4d04f5d02..3b52810855 100644 --- a/indra/llmath/llcamera.h +++ b/indra/llmath/llcamera.h @@ -1,25 +1,25 @@ -/** +/** * @file llcamera.h * @brief Header file for the LLCamera class. * * $LicenseInfo:firstyear=2000&license=viewerlgpl$ * Second Life Viewer Source Code * Copyright (C) 2010, Linden Research, Inc. - * + * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; * version 2.1 of the License only. - * + * * This library is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * Lesser General Public License for more details. - * + * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, write to the Free Software * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA - * + * * Linden Research, Inc., 945 Battery Street, San Francisco, CA 94111 USA * $/LicenseInfo$ */ @@ -33,26 +33,26 @@ #include "llplane.h" #include "llvector4a.h" -const F32 DEFAULT_FIELD_OF_VIEW = 60.f * DEG_TO_RAD; -const F32 DEFAULT_ASPECT_RATIO = 640.f / 480.f; -const F32 DEFAULT_NEAR_PLANE = 0.25f; -const F32 DEFAULT_FAR_PLANE = 64.f; // far reaches across two horizontal, not diagonal, regions +const F32 DEFAULT_FIELD_OF_VIEW = 60.f * DEG_TO_RAD; +const F32 DEFAULT_ASPECT_RATIO = 640.f / 480.f; +const F32 DEFAULT_NEAR_PLANE = 0.25f; +const F32 DEFAULT_FAR_PLANE = 64.f; // far reaches across two horizontal, not diagonal, regions -const F32 MAX_ASPECT_RATIO = 50.0f; -const F32 MAX_NEAR_PLANE = 1023.9f; // Clamp the near plane just before the skybox ends -const F32 MAX_FAR_PLANE = 100000.0f; //1000000.0f; // Max allowed. Not good Z precision though. -const F32 MAX_FAR_CLIP = 512.0f; +const F32 MAX_ASPECT_RATIO = 50.0f; +const F32 MAX_NEAR_PLANE = 1023.9f; // Clamp the near plane just before the skybox ends +const F32 MAX_FAR_PLANE = 100000.0f; //1000000.0f; // Max allowed. Not good Z precision though. +const F32 MAX_FAR_CLIP = 512.0f; -const F32 MIN_ASPECT_RATIO = 0.02f; -const F32 MIN_NEAR_PLANE = 0.1f; -const F32 MIN_FAR_PLANE = 0.2f; +const F32 MIN_ASPECT_RATIO = 0.02f; +const F32 MIN_NEAR_PLANE = 0.1f; +const F32 MIN_FAR_PLANE = 0.2f; // Min/Max FOV values for square views. Call getMin/MaxView to get extremes based on current aspect ratio. static const F32 MIN_FIELD_OF_VIEW = 5.0f * DEG_TO_RAD; static const F32 MAX_FIELD_OF_VIEW = 175.f * DEG_TO_RAD; // An LLCamera is an LLCoorFrame with a view frustum. -// This means that it has several methods for moving it around +// This means that it has several methods for moving it around // that are inherited from the LLCoordFrame() class : // // setOrigin(), setAxes() @@ -62,163 +62,163 @@ static const F32 MAX_FIELD_OF_VIEW = 175.f * DEG_TO_RAD; LL_ALIGN_PREFIX(16) class LLCamera -: public LLCoordFrame +: public LLCoordFrame { public: - - LLCamera(const LLCamera& rhs) - { - *this = rhs; - } - - enum { - PLANE_LEFT = 0, - PLANE_RIGHT = 1, - PLANE_BOTTOM = 2, - PLANE_TOP = 3, - PLANE_NUM = 4, - PLANE_MASK_NONE = 0xff // Disable this plane - }; - enum { - PLANE_LEFT_MASK = (1<<PLANE_LEFT), - PLANE_RIGHT_MASK = (1<<PLANE_RIGHT), - PLANE_BOTTOM_MASK = (1<<PLANE_BOTTOM), - PLANE_TOP_MASK = (1<<PLANE_TOP), - PLANE_ALL_MASK = 0xf, - }; - - enum - { // Indexes to mAgentPlanes[] and mPlaneMask[] - AGENT_PLANE_LEFT = 0, - AGENT_PLANE_RIGHT = 1, - AGENT_PLANE_NEAR = 2, - AGENT_PLANE_BOTTOM = 3, - AGENT_PLANE_TOP = 4, - AGENT_PLANE_FAR = 5, - AGENT_PLANE_USER_CLIP = 6 - }; - enum - { // Sizes for mAgentPlanes[]. 7th entry is special case for user clip - AGENT_PLANE_NO_USER_CLIP_NUM = 6, - AGENT_PLANE_USER_CLIP_NUM = 7, - PLANE_MASK_NUM = 8 // 7 actually used, 8 is for alignment - }; - - enum - { - AGENT_FRUSTRUM_NUM = 8 - }; - - enum { - HORIZ_PLANE_LEFT = 0, - HORIZ_PLANE_RIGHT = 1, - HORIZ_PLANE_NUM = 2 - }; - enum { - HORIZ_PLANE_LEFT_MASK = (1<<HORIZ_PLANE_LEFT), - HORIZ_PLANE_RIGHT_MASK = (1<<HORIZ_PLANE_RIGHT), - HORIZ_PLANE_ALL_MASK = 0x3 - }; + + LLCamera(const LLCamera& rhs) + { + *this = rhs; + } + + enum { + PLANE_LEFT = 0, + PLANE_RIGHT = 1, + PLANE_BOTTOM = 2, + PLANE_TOP = 3, + PLANE_NUM = 4, + PLANE_MASK_NONE = 0xff // Disable this plane + }; + enum { + PLANE_LEFT_MASK = (1<<PLANE_LEFT), + PLANE_RIGHT_MASK = (1<<PLANE_RIGHT), + PLANE_BOTTOM_MASK = (1<<PLANE_BOTTOM), + PLANE_TOP_MASK = (1<<PLANE_TOP), + PLANE_ALL_MASK = 0xf, + }; + + enum + { // Indexes to mAgentPlanes[] and mPlaneMask[] + AGENT_PLANE_LEFT = 0, + AGENT_PLANE_RIGHT = 1, + AGENT_PLANE_NEAR = 2, + AGENT_PLANE_BOTTOM = 3, + AGENT_PLANE_TOP = 4, + AGENT_PLANE_FAR = 5, + AGENT_PLANE_USER_CLIP = 6 + }; + enum + { // Sizes for mAgentPlanes[]. 7th entry is special case for user clip + AGENT_PLANE_NO_USER_CLIP_NUM = 6, + AGENT_PLANE_USER_CLIP_NUM = 7, + PLANE_MASK_NUM = 8 // 7 actually used, 8 is for alignment + }; + + enum + { + AGENT_FRUSTRUM_NUM = 8 + }; + + enum { + HORIZ_PLANE_LEFT = 0, + HORIZ_PLANE_RIGHT = 1, + HORIZ_PLANE_NUM = 2 + }; + enum { + HORIZ_PLANE_LEFT_MASK = (1<<HORIZ_PLANE_LEFT), + HORIZ_PLANE_RIGHT_MASK = (1<<HORIZ_PLANE_RIGHT), + HORIZ_PLANE_ALL_MASK = 0x3 + }; private: - LL_ALIGN_16(LLPlane mAgentPlanes[AGENT_PLANE_USER_CLIP_NUM]); //frustum planes in agent space a la gluUnproject (I'm a bastard, I know) - DaveP - LL_ALIGN_16(LLPlane mRegionPlanes[AGENT_PLANE_USER_CLIP_NUM]); //frustum planes in a local region space, derived from mAgentPlanes - LL_ALIGN_16(LLPlane mLastAgentPlanes[AGENT_PLANE_USER_CLIP_NUM]); - U8 mPlaneMask[PLANE_MASK_NUM]; // 8 for alignment - - F32 mView; // angle between top and bottom frustum planes in radians. - F32 mAspect; // width/height - S32 mViewHeightInPixels; // for ViewHeightInPixels() only - F32 mNearPlane; - F32 mFarPlane; - F32 mFixedDistance; // Always return this distance, unless < 0 - LLVector3 mFrustCenter; // center of frustum and radius squared for ultra-quick exclusion test - F32 mFrustRadiusSquared; - - U32 mPlaneCount; //defaults to 6, if setUserClipPlane is called, uses user supplied clip plane in - - LLVector3 mWorldPlanePos; // Position of World Planes (may be offset from camera) + LL_ALIGN_16(LLPlane mAgentPlanes[AGENT_PLANE_USER_CLIP_NUM]); //frustum planes in agent space a la gluUnproject (I'm a bastard, I know) - DaveP + LL_ALIGN_16(LLPlane mRegionPlanes[AGENT_PLANE_USER_CLIP_NUM]); //frustum planes in a local region space, derived from mAgentPlanes + LL_ALIGN_16(LLPlane mLastAgentPlanes[AGENT_PLANE_USER_CLIP_NUM]); + U8 mPlaneMask[PLANE_MASK_NUM]; // 8 for alignment + + F32 mView; // angle between top and bottom frustum planes in radians. + F32 mAspect; // width/height + S32 mViewHeightInPixels; // for ViewHeightInPixels() only + F32 mNearPlane; + F32 mFarPlane; + F32 mFixedDistance; // Always return this distance, unless < 0 + LLVector3 mFrustCenter; // center of frustum and radius squared for ultra-quick exclusion test + F32 mFrustRadiusSquared; + + U32 mPlaneCount; //defaults to 6, if setUserClipPlane is called, uses user supplied clip plane in + + LLVector3 mWorldPlanePos; // Position of World Planes (may be offset from camera) public: - LLVector3 mAgentFrustum[AGENT_FRUSTRUM_NUM]; //8 corners of 6-plane frustum - F32 mFrustumCornerDist; //distance to corner of frustum against far clip plane - LLPlane& getAgentPlane(U32 idx) { return mAgentPlanes[idx]; } + LLVector3 mAgentFrustum[AGENT_FRUSTRUM_NUM]; //8 corners of 6-plane frustum + F32 mFrustumCornerDist; //distance to corner of frustum against far clip plane + LLPlane& getAgentPlane(U32 idx) { return mAgentPlanes[idx]; } public: - LLCamera(); - LLCamera(F32 vertical_fov_rads, F32 aspect_ratio, S32 view_height_in_pixels, F32 near_plane, F32 far_plane); - virtual ~LLCamera(); - - bool isChanged(); //check if mAgentPlanes changed since last frame. + LLCamera(); + LLCamera(F32 vertical_fov_rads, F32 aspect_ratio, S32 view_height_in_pixels, F32 near_plane, F32 far_plane); + virtual ~LLCamera(); + + bool isChanged(); //check if mAgentPlanes changed since last frame. LLPlane getUserClipPlane(); - void setUserClipPlane(LLPlane& plane); - void disableUserClipPlane(); - virtual void setView(F32 vertical_fov_rads); - void setViewHeightInPixels(S32 height); - void setAspect(F32 new_aspect); - void setNear(F32 new_near); - void setFar(F32 new_far); - - F32 getView() const { return mView; } // vertical FOV in radians - S32 getViewHeightInPixels() const { return mViewHeightInPixels; } - F32 getAspect() const { return mAspect; } // width / height - F32 getNear() const { return mNearPlane; } // meters - F32 getFar() const { return mFarPlane; } // meters - - // The values returned by the min/max view getters depend upon the aspect ratio - // at the time they are called and therefore should not be cached. - F32 getMinView() const; - F32 getMaxView() const; - - F32 getYaw() const - { - return atan2f(mXAxis[VY], mXAxis[VX]); - } - F32 getPitch() const - { - F32 xylen = sqrtf(mXAxis[VX]*mXAxis[VX] + mXAxis[VY]*mXAxis[VY]); - return atan2f(mXAxis[VZ], xylen); - } - - const LLVector3& getWorldPlanePos() const { return mWorldPlanePos; } - - // Copy mView, mAspect, mNearPlane, and mFarPlane to buffer. - // Return number of bytes copied. - size_t writeFrustumToBuffer(char *buffer) const; - - // Copy mView, mAspect, mNearPlane, and mFarPlane from buffer. - // Return number of bytes copied. - size_t readFrustumFromBuffer(const char *buffer); - void calcAgentFrustumPlanes(LLVector3* frust); - void calcRegionFrustumPlanes(const LLVector3& shift, F32 far_clip_distance); //calculate regional planes from mAgentPlanes. - void ignoreAgentFrustumPlane(S32 idx); - - // Returns 1 if partly in, 2 if fully in. - // NOTE: 'center' is in absolute frame. - S32 sphereInFrustum(const LLVector3 ¢er, const F32 radius) const; - S32 pointInFrustum(const LLVector3 &point) const { return sphereInFrustum(point, 0.0f); } - S32 sphereInFrustumFull(const LLVector3 ¢er, const F32 radius) const { return sphereInFrustum(center, radius); } - S32 AABBInFrustum(const LLVector4a& center, const LLVector4a& radius, const LLPlane* planes = NULL); - S32 AABBInRegionFrustum(const LLVector4a& center, const LLVector4a& radius); - S32 AABBInFrustumNoFarClip(const LLVector4a& center, const LLVector4a& radius, const LLPlane* planes = NULL); - S32 AABBInRegionFrustumNoFarClip(const LLVector4a& center, const LLVector4a& radius); - - //does a quick 'n dirty sphere-sphere check - S32 sphereInFrustumQuick(const LLVector3 &sphere_center, const F32 radius); - - // Returns height of object in pixels (must be height because field of view - // is based on window height). - F32 heightInPixels(const LLVector3 ¢er, F32 radius ) const; - - // return the distance from pos to camera if visible (-distance if not visible) - void setFixedDistance(F32 distance) { mFixedDistance = distance; } - - friend std::ostream& operator<<(std::ostream &s, const LLCamera &C); + void setUserClipPlane(LLPlane& plane); + void disableUserClipPlane(); + virtual void setView(F32 vertical_fov_rads); + void setViewHeightInPixels(S32 height); + void setAspect(F32 new_aspect); + void setNear(F32 new_near); + void setFar(F32 new_far); + + F32 getView() const { return mView; } // vertical FOV in radians + S32 getViewHeightInPixels() const { return mViewHeightInPixels; } + F32 getAspect() const { return mAspect; } // width / height + F32 getNear() const { return mNearPlane; } // meters + F32 getFar() const { return mFarPlane; } // meters + + // The values returned by the min/max view getters depend upon the aspect ratio + // at the time they are called and therefore should not be cached. + F32 getMinView() const; + F32 getMaxView() const; + + F32 getYaw() const + { + return atan2f(mXAxis[VY], mXAxis[VX]); + } + F32 getPitch() const + { + F32 xylen = sqrtf(mXAxis[VX]*mXAxis[VX] + mXAxis[VY]*mXAxis[VY]); + return atan2f(mXAxis[VZ], xylen); + } + + const LLVector3& getWorldPlanePos() const { return mWorldPlanePos; } + + // Copy mView, mAspect, mNearPlane, and mFarPlane to buffer. + // Return number of bytes copied. + size_t writeFrustumToBuffer(char *buffer) const; + + // Copy mView, mAspect, mNearPlane, and mFarPlane from buffer. + // Return number of bytes copied. + size_t readFrustumFromBuffer(const char *buffer); + void calcAgentFrustumPlanes(LLVector3* frust); + void calcRegionFrustumPlanes(const LLVector3& shift, F32 far_clip_distance); //calculate regional planes from mAgentPlanes. + void ignoreAgentFrustumPlane(S32 idx); + + // Returns 1 if partly in, 2 if fully in. + // NOTE: 'center' is in absolute frame. + S32 sphereInFrustum(const LLVector3 ¢er, const F32 radius) const; + S32 pointInFrustum(const LLVector3 &point) const { return sphereInFrustum(point, 0.0f); } + S32 sphereInFrustumFull(const LLVector3 ¢er, const F32 radius) const { return sphereInFrustum(center, radius); } + S32 AABBInFrustum(const LLVector4a& center, const LLVector4a& radius, const LLPlane* planes = NULL); + S32 AABBInRegionFrustum(const LLVector4a& center, const LLVector4a& radius); + S32 AABBInFrustumNoFarClip(const LLVector4a& center, const LLVector4a& radius, const LLPlane* planes = NULL); + S32 AABBInRegionFrustumNoFarClip(const LLVector4a& center, const LLVector4a& radius); + + //does a quick 'n dirty sphere-sphere check + S32 sphereInFrustumQuick(const LLVector3 &sphere_center, const F32 radius); + + // Returns height of object in pixels (must be height because field of view + // is based on window height). + F32 heightInPixels(const LLVector3 ¢er, F32 radius ) const; + + // return the distance from pos to camera if visible (-distance if not visible) + void setFixedDistance(F32 distance) { mFixedDistance = distance; } + + friend std::ostream& operator<<(std::ostream &s, const LLCamera &C); protected: - void calculateFrustumPlanes(); - void calculateFrustumPlanes(F32 left, F32 right, F32 top, F32 bottom); - void calculateFrustumPlanesFromWindow(F32 x1, F32 y1, F32 x2, F32 y2); + void calculateFrustumPlanes(); + void calculateFrustumPlanes(F32 left, F32 right, F32 top, F32 bottom); + void calculateFrustumPlanesFromWindow(F32 x1, F32 y1, F32 x2, F32 y2); } LL_ALIGN_POSTFIX(16); |