/* ----------------------------------------------------------------------------- This source file is part of OGRE (Object-oriented Graphics Rendering Engine) For the latest info, see http://www.ogre3d.org Copyright (c) 2000-2014 Torus Knot Software Ltd Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ----------------------------------------------------------------------------- */ #ifndef __OutsideMarker_H__ #define __OutsideMarker_H__ #include "OgreLodPrerequisites.h" #include "OgreLodData.h" #include "OgreResourceGroupManager.h" #include "OgreHeaderPrefix.h" namespace Ogre { /** \addtogroup Optional * @{ */ /** \addtogroup MeshLodGenerator * @{ */ /// This class will mark vertices of a mesh, which are visible from far away (from outside). /// Triangle is visible if each vertex of it is visible. class _OgreLodExport LodOutsideMarker { public: /** * @param vertexList List of vertices. vertex.position is the input and vertex.isOuterWallVertex is the output of the algorithm. * @param boundingSphereRadius * @param walkAngle Walk angle in dot product values. Allowed range is from -1 to 1. Default = 0. Smaller value is bigger angle. * If you set it to 1 then you can disable walking and it will only mark the vertices on the convex hull. */ LodOutsideMarker(LodData::VertexList & vertexList, Real boundingSphereRadius, Real walkAngle); void markOutside(); /// Mark vertices, which are visible from outside. MeshPtr createConvexHullMesh(const String& meshName, const String& resourceGroupName = ResourceGroupManager::DEFAULT_RESOURCE_GROUP_NAME); /// Returns a mesh containing the Convex Hull shape. bool isVertexOutside(LodData::Vertex* v) { return getOutsideData(v)->isOuterWallVertex; } private: typedef LodData::Vertex CHVertex; struct CHTriangle { bool removed; // Whether the triangle is excluded from hull. CHVertex* vertex[3]; Vector3 normal; void computeNormal() { normal = Math::calculateBasicFaceNormal(vertex[0]->position, vertex[1]->position, vertex[2]->position); } }; struct OutsideData { bool isOuterWallVertex; bool isOuterWallVertexInPass; bool isInsideHull; }; typedef std::vector OutsideDataList; typedef std::vector CHTriangleList; typedef std::vector CHTrianglePList; typedef std::vector > CHEdgeList; const Real mEpsilon; /// Amount of allowed floating point error if 4 vertices are on the same plane. CHTriangleList mHull; /// Contains the current triangles of the convex hull. CHTrianglePList mVisibleTriangles; /// Temporary vector for addVisibleEdges function (prevent allocation every call). CHEdgeList mEdges; /// Temporary vector for the horizon edges, when inserting a new vertex into the hull. LodData::VertexList& mVertexListOrig; /// Source of input and output of the algorithm. OutsideDataList mOutsideData; Vector3 mCentroid; /// Centroid of the convex hull. Real mWalkAngle; /// Angle limit, when walking inside for marking vertices. LodData::Vertex* getVertex(OutsideData* d) { return &mVertexListOrig[LodData::getVectorIDFromPointer(mOutsideData, d)]; } OutsideData* getOutsideData(LodData::Vertex* v) { return &mOutsideData[LodData::getVectorIDFromPointer(mVertexListOrig, v)]; } void initHull(); /// Initializes the hull for expansion. void createTriangle(CHVertex* v1, CHVertex* v2, CHVertex* v3); /// Sets the vertices of a triangle (called from initHull only). Real getTetrahedronVolume(CHVertex* v0, CHVertex* v1, CHVertex* v2, CHVertex* v3); Real getPointToLineSqraredDistance(CHVertex* x1, CHVertex* x2, CHVertex* vertex); void generateHull(); /// Generates the hull. size_t addVertex(CHVertex* vertex); /// Adds vertex to hull. void addEdge(CHEdgeList& edges, CHVertex* a, CHVertex* b); /// Add edge to the list of removable edges. void cleanHull(); /// Removes Triangles, which are having CHTriangle::removed = true. bool isVisible(CHTriangle* triangle, Vector3& vertex); /// Whether face is visible from point. CHVertex* getFurthestVertex(CHTriangle* hull); /// Gets furthest vertex from face. void getVisibleTriangles(const CHVertex* target, CHTrianglePList& visibleTriangles); /// Adds visible edges to the list, when viewing from target point. void getHorizon(const CHTrianglePList& tri, CHEdgeList& ); /// Removes edges, which are not on the horizon. void fillHorizon(CHEdgeList& e, CHVertex* target); /// Caps the hole with faces connecting to target vertex. void markVertices(); /// if we have the convex hull, this will walk on the faces which have less then 90 degree difference. template void addHullTriangleVertices(std::vector& stack, T tri); /// Add triangle to stack (called from markVertices only). /// Determines whether ptarget is on the same side of the p0-p1 line as p2. Assuming each point is on the same plane. Real pointToLineDir(const Vector3& ptarget, const Vector3& p0, const Vector3& p1, const Vector3& p2, const Vector3& n); bool isInsideTriangle(const Vector3& ptarget, const CHTriangle& tri); /// Whether the vertex is inside the triangle. We assume that it is on the same plane bool isInsideLine(const Vector3& ptarget, const Vector3& p0, const Vector3& p1); /// Whether ptarget is between p0 and p1. Assuming they are on the same line. bool isSamePosition(const Vector3& p0, const Vector3& p1); /// Whether p0 = p1 with mEpsilon allowed float error. }; /** @} */ /** @} */ } #include "OgreHeaderSuffix.h" #endif /* ifndef __OutsideMarker_H__ */