Moka gmapkernel: src/lib-gmapkernel/tools/geometry/geometry.hh Source File

00001 /*
00002  * lib-gmapkernel : Un noyau de 3-G-cartes et des opérations.
00003  * Copyright (C) 2004, Moka Team, Université de Poitiers, Laboratoire SIC
00004  *               http://www.sic.sp2mi.univ-poitiers.fr/
00005  * Copyright (C) 2009, Guillaume Damiand, CNRS, LIRIS,
00006  *               guillaume.damiand@liris.cnrs.fr, http://liris.cnrs.fr/
00007  *
00008  * This file is part of lib-gmapkernel
00009  *
00010  * This program is free software: you can redistribute it and/or modify
00011  * it under the terms of the GNU Lesser General Public License as published by
00012  * the Free Software Foundation, either version 3 of the License, or
00013  * (at your option) any later version.
00014  *
00015  * This program is distributed in the hope that it will be useful,
00016  * but WITHOUT ANY WARRANTY; without even the implied warranty of
00017  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
00018  * GNU Lesser General Public License for more details.
00019  *
00020  * You should have received a copy of the GNU Lesser General Public License
00021  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
00022  */
00023 
00024 //******************************************************************************
00025 #ifndef GEOMETRY_HH
00026 #define GEOMETRY_HH
00027 //******************************************************************************
00028 #include "inline-macro.hh"
00029 #include "math-extension.hh"
00030 #include "vertex.hh"
00031 //******************************************************************************
00032 
00047 class CGeometry
00048 {
00049 public:
00050   // @name Projections
00051   // @{
00052 
00064   static CVertex orthoProjectVertexOnLine(const CVertex& AVertex,
00065                                           const CVertex& ALineVertex,
00066                                           const CVertex& ALineDirection);
00067 
00076   static CVertex
00077   orthoProjectVertexOnPlane(const CVertex& AVertex,
00078                             const TCoordinate& AA, const TCoordinate& AB,
00079                             const TCoordinate& AC, const TCoordinate& AD);
00080 
00092   static CVertex orthoProjectVertexOnPlane(const CVertex& AVertex,
00093                                            const CVertex& APlaneVertex,
00094                                            const CVertex& APlaneNormal);
00095 
00096   // @}
00097   // @name Homothéties
00098   // @{
00099 
00109   static CVertex centralHomothety(const CVertex& AVertex,
00110                                   const CVertex& ACenter,
00111                                   const TCoordinate& ACoef);
00112 
00122   static CVertex centralHomothety(const CVertex& AVertex,
00123                                   const CVertex& ACenter,
00124                                   const CVertex& ACoef);
00125 
00139   static CVertex axialHomothety(const CVertex& AVertex,
00140                                 const CVertex& ALineVertex,
00141                                 const CVertex& ALineDirection,
00142                                 const TCoordinate& ACoef);
00143 
00157   static CVertex planarHomothety(const CVertex& AVertex,
00158                                  const CVertex& APlaneVertex,
00159                                  const CVertex& APlaneNormal,
00160                                  const TCoordinate& ACoef);
00161 
00162   // @}
00163   // @name Calcul de la distance d'un sommet à un autre objet
00164   // @{
00165 
00173   static TCoordinate distanceToVertex(const CVertex& AVertex,
00174                                       const CVertex& AOtherVertex);
00175 
00188   static TCoordinate distanceToLine(const CVertex& AVertex,
00189                                     const CVertex& ALineVertex,
00190                                     const CVertex& ALineDirection);
00191 
00204   static TCoordinate distanceToPlane(const CVertex& AVertex,
00205                                      const CVertex& APlaneVertex,
00206                                      const CVertex& APlaneNormal);
00207 
00208   // @}
00209   // @name Fonctions géométriques diverses
00210   // @{
00211 
00223   static CVertex getBissectrix(const CVertex& AVector1,
00224                                const CVertex& AVector2,
00225                                const CVertex& ANormal = ORIGIN);
00226 
00234   static CVertex getNormalVector(const CVertex& AVector);
00235 
00249   static CVertex getNormalVector(const CVertex& AVector1,
00250                                  const CVertex& AVector2);
00251 
00256   static CVertex getNormalVector(const CVertex& AVertex1,
00257                                  const CVertex& AVertex2,
00258                                  const CVertex& AVertex3);
00259 
00274   static CVertex getLinesIntersection(const CVertex& ALine1Vertex1,
00275                                       const CVertex& ALine1Vertex2,
00276                                       const CVertex& ALine2Vertex1,
00277                                       const CVertex& ALine2Vertex2);
00278 
00286   static bool areColinear(const CVertex& AVertex1, const CVertex& AVertex2);
00287 
00299   static TCoordinate getAngle(const CVertex& AVector1,
00300                               const CVertex& AVector2,
00301                               const CVertex& ANormal = ORIGIN);
00302 
00317   static CVertex getAngles(const CVertex& AVx, const CVertex& AVz);
00318 
00319   // @}
00320   // @name Méthodes auxiliaires pour le coraffinement 2D
00321   // @{
00322 
00343   static int localiseVertexComparedToLine(const CVertex& AVertex,
00344                                           const CVertex& ALineVertex,
00345                                           const CVertex& ALineDirection,
00346                                           const CVertex& APlaneNormal);
00347 
00384   static void getSegmentsIntersection(const CVertex& AVertexA,
00385                                       const CVertex& AVertexB,
00386                                       const CVertex& AVertexC,
00387                                       const CVertex& AVertexD,
00388                                       const CVertex& APlaneNormal,
00389                                       int& AIntersection1On,
00390                                       CVertex& AIntersection1,
00391                                       int& AIntersection2On,
00392                                       CVertex& AIntersection2);
00393 
00398   static void getSegmentsIntersection2d(const CVertex& AVertexA,
00399                                         const CVertex& AVertexB,
00400                                         const CVertex& AVertexC,
00401                                         const CVertex& AVertexD,
00402                                         int& AIntersection1On,
00403                                         CVertex& AIntersection1,
00404                                         int& AIntersection2On,
00405                                         CVertex& AIntersection2);
00406 
00407   // @}
00408   // @name Méthodes pour le chanfreinage :
00409   // @{
00410 
00416   static CVertex getRoundingNormalVector(const CVertex& AVertex1, 
00417                                          const CVertex& AVertex2,
00418                                          const CVertex& AVertex3);
00419 
00420   // @}
00421 };
00422 //******************************************************************************
00423 #include INCLUDE_INLINE("geometry.icc")
00424 //******************************************************************************
00425 #endif // GEOMETRY_HH
00426 //******************************************************************************