Menge
Modular Pedestrian Simulation Framework for Research and Development
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Pages
NavMeshPoly.h
Go to the documentation of this file.
1 /*
2 
3 License
4 
5 Menge
6 Copyright © and trademark ™ 2012-14 University of North Carolina at Chapel Hill.
7 All rights reserved.
8 
9 Permission to use, copy, modify, and distribute this software and its documentation
10 for educational, research, and non-profit purposes, without fee, and without a
11 written agreement is hereby granted, provided that the above copyright notice,
12 this paragraph, and the following four paragraphs appear in all copies.
13 
14 This software program and documentation are copyrighted by the University of North
15 Carolina at Chapel Hill. The software program and documentation are supplied "as is,"
16 without any accompanying services from the University of North Carolina at Chapel
17 Hill or the authors. The University of North Carolina at Chapel Hill and the
18 authors do not warrant that the operation of the program will be uninterrupted
19 or error-free. The end-user understands that the program was developed for research
20 purposes and is advised not to rely exclusively on the program for any reason.
21 
22 IN NO EVENT SHALL THE UNIVERSITY OF NORTH CAROLINA AT CHAPEL HILL OR THE AUTHORS
23 BE LIABLE TO ANY PARTY FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL
24 DAMAGES, INCLUDING LOST PROFITS, ARISING OUT OF THE USE OF THIS SOFTWARE AND ITS
25 DOCUMENTATION, EVEN IF THE UNIVERSITY OF NORTH CAROLINA AT CHAPEL HILL OR THE
26 AUTHORS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27 
28 THE UNIVERSITY OF NORTH CAROLINA AT CHAPEL HILL AND THE AUTHORS SPECIFICALLY
29 DISCLAIM ANY WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
30 OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE AND ANY STATUTORY WARRANTY
31 OF NON-INFRINGEMENT. THE SOFTWARE PROVIDED HEREUNDER IS ON AN "AS IS" BASIS, AND
32 THE UNIVERSITY OF NORTH CAROLINA AT CHAPEL HILL AND THE AUTHORS HAVE NO OBLIGATIONS
33 TO PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
34 
35 Any questions or comments should be sent to the authors {menge,geom}@cs.unc.edu
36 
37 */
38 
45 #ifndef __NAV_MESH_POLY_H__
46 #define __NAV_MESH_POLY_H__
47 
48 #include "fsmCommon.h"
49 #include "string.h"
50 #include <fstream>
51 
52 namespace Menge {
53 
54  // FORWARD DECLARATIONS
55  class NavMeshNode;
56  class NavMesh;
57 
61  class NavMeshPoly {
62  public:
66  NavMeshPoly();
67 
71  ~NavMeshPoly();
72 
76  NavMeshPoly & operator=( const NavMeshPoly & n );
77 
87  bool containsPoint( const Vector2 & point ) const;
88 
98  float getElevation( const Vector2 & point ) const;
99 
106  Vector2 getGradient() const { return Vector2( _A, _B ); }
107 
116  bool loadFromAscii( std::ifstream & f );
117 
126  bool loadFromBinary( std::ifstream & f );
127 
141  void initialize( size_t vCount, unsigned int * ids, float A=0.f, float B=0.f, float C=0.f );
142 
143  friend class NavMeshNode;
144  friend class NavMesh;
145 
146  protected:
155  unsigned int *_vertIDs;
156 
160  size_t _vertCount;
161 
167 
168  // TODO: Replace the individual bounding box with a BVH outside of the
169  // polygon. And then change the "is inside" function assuming
170  // that BVH tests have already been done.
174  float _minX;
175 
179  float _maxX;
180 
184  float _minY;
185 
189  float _maxY;
190 
197  void setBB( const Vector2 * vertices );
198 
204  float _A;
205 
211  float _B;
212 
218  float _C;
219  };
220 } // namespace Menge
221 
222 #endif // __NAV_MESH_POLY_H__
unsigned int * _vertIDs
An array of indices into the vertex list defining the polygon. The indices must be ordered such that ...
Definition: NavMeshPoly.h:155
The core namespace. All elements of Menge are contained in this namespace.
Definition: AgentGenerator.cpp:43
float getElevation(const Vector2 &point) const
Computes the elevation of the polygon at the given point.
Definition: NavMeshPoly.cpp:161
float _A
The first coefficient of the planar equation: f( x, y ) = Ax + By + C Used to compute the elevation o...
Definition: NavMeshPoly.h:204
size_t _vertCount
The number of vertices in the polygon.
Definition: NavMeshPoly.h:160
The navigation mesh adjacency graph node. It corresponds to a convex polygon in the navigation mesh...
Definition: NavMeshNode.h:64
The polygon used in each node of a navigation mesh graph.
Definition: NavMeshPoly.h:61
float _maxX
Maximum extent on the x-axis of the polygon.
Definition: NavMeshPoly.h:179
NavMeshPoly & operator=(const NavMeshPoly &n)
Assignment operator.
Definition: NavMeshPoly.cpp:61
NavMeshPoly()
Constructor.
Definition: NavMeshPoly.cpp:48
float _minY
Minimum extent on the y-axis of the polygon.
Definition: NavMeshPoly.h:184
bool loadFromAscii(std::ifstream &f)
Sets the polygon properties from a polygon definition in the given ascii file stream.
Definition: NavMeshPoly.cpp:167
Vector2 getGradient() const
Reports the gradient of the polygon. Because it is a plane, the gradient is constant at all positions...
Definition: NavMeshPoly.h:106
const Vector2 * _vertices
A pointer to the mesh vertex information for performing geometric tests.
Definition: NavMeshPoly.h:166
float _C
The third coefficient of the planar equation: f( x, y ) = Ax + By + C Used to compute the elevation o...
Definition: NavMeshPoly.h:218
void setBB(const Vector2 *vertices)
Compute the bounding box for this polygon.
Definition: NavMeshPoly.cpp:236
bool loadFromBinary(std::ifstream &f)
Sets the polygon properties from a polygon definition in the given binary file stream.
Definition: NavMeshPoly.cpp:190
~NavMeshPoly()
Destructor.
Definition: NavMeshPoly.cpp:53
Collection of convenient pre-compiler information for fsm definitions.
The class for defining a navigation mesh. A decomposition of the free space into a connected mesh of ...
Definition: NavMesh.h:120
float _B
The second coefficient of the planar equation: f( x, y ) = Ax + By + C Used to compute the elevation ...
Definition: NavMeshPoly.h:211
void initialize(size_t vCount, unsigned int *ids, float A=0.f, float B=0.f, float C=0.f)
Initialize the polygon with vertices and equation of plane.
Definition: NavMeshPoly.cpp:222
bool containsPoint(const Vector2 &point) const
Reports if the point lies inside the polygon. NOTE: This is limited to 2D polygons.
Definition: NavMeshPoly.cpp:75
float _maxY
Maximum extent on the y-axis of the polygon.
Definition: NavMeshPoly.h:189
float _minX
Minimum extent on the x-axis of the polygon.
Definition: NavMeshPoly.h:174