gmGeometryUtils.h

Go to the documentation of this file.

/************************************************************************
**
** Copyright (C) 2014 by Carlos Augusto Teixera Mendes
** All rights reserved.
**
** This file is part of the "GeMA" software. It's use should respect
** the terms in the license agreement that can be found together
** with this source code.
** It is provided AS IS, with NO WARRANTY OF ANY KIND,
** INCLUDING THE WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR
** A PARTICULAR PURPOSE.
**
************************************************************************/

#ifndef _GEMA_GEOMETRY_UTILS_H_
#define _GEMA_GEOMETRY_UTILS_H_

#include "gmVector.h"
#include "gmMatrix.h"

class GmCellGeometry;

namespace GmGeometryUtils
{
  GMC_API_EXPORT double edgeLength  (const GmVector& p1, const GmVector& p2);
  GMC_API_EXPORT double triangleArea(const GmVector& p1, const GmVector& p2, const GmVector& p3);
  GMC_API_EXPORT double quadArea    (const GmVector& p1, const GmVector& p2, const GmVector& p3, const GmVector& p4);
  GMC_API_EXPORT double hexahedronVolume(const GmVector& p1, const GmVector& p2, const GmVector& p3, const GmVector& p4,
                                         const GmVector& p5, const GmVector& p6, const GmVector& p7, const GmVector& p8);
  GMC_API_EXPORT double tetrahedronVolume(const GmVector& p1, const GmVector& p2, const GmVector& p3, const GmVector& p4);
  GMC_API_EXPORT double wedgeVolume(const GmVector& p1, const GmVector& p2, const GmVector& p3, const GmVector& p4,
                                    const GmVector& p5, const GmVector& p6);

  GMC_API_EXPORT double pyramidVolume(const GmVector& p1, const GmVector& p2, const GmVector& p3, const GmVector& p4,
                                      const GmVector& p5);

  GMC_API_EXPORT void edgeCentroid    (const GmVector& p1, const GmVector& p2, GmVector& coord);
  GMC_API_EXPORT void triangleCentroid(const GmVector& p1, const GmVector& p2, const GmVector& p3, GmVector& coord);
  GMC_API_EXPORT void quadCentroid    (const GmVector& p1, const GmVector& p2, const GmVector& p3, const GmVector& p4, GmVector& coord);
  GMC_API_EXPORT void hexahedronCentroid(const GmVector& p1, const GmVector& p2, const GmVector& p3, const GmVector& p4,
                                         const GmVector& p5, const GmVector& p6, const GmVector& p7, const GmVector& p8, GmVector& coord);
  GMC_API_EXPORT void tetrahedronCentroid(const GmVector& p1, const GmVector& p2, const GmVector& p3, const GmVector& p4, GmVector& coord);
  GMC_API_EXPORT void wedgeCentroid(const GmVector& p1, const GmVector& p2, const GmVector& p3, const GmVector& p4,
                                    const GmVector& p5, const GmVector& p6, GmVector& coord);
  GMC_API_EXPORT void pyramidCentroid(const GmVector& p1, const GmVector& p2, const GmVector& p3, const GmVector& p4,
                                      const GmVector& p5, GmVector& coord);

  GMC_API_EXPORT bool   tri3DIsColinear(const GmMatrix& X, double eps = 1e-3);
  GMC_API_EXPORT bool   polygon3DIsPlanar(const GmMatrix& X, double tol);
  GMC_API_EXPORT bool   polygon2DIsCCW(const GmMatrix& X);
  GMC_API_EXPORT bool   polygon2DIsSelfIntersecting  (const GmMatrix& X);
  GMC_API_EXPORT bool   polygonIsConvex            (const GmMatrix& X);
  GMC_API_EXPORT bool   pointInConvexPolygon       (const GmMatrix& X, const GmVector& p);
  GMC_API_EXPORT bool   pointInTesselatedPolygon_T6(const GmMatrix& X, const GmVector& p);
  GMC_API_EXPORT bool   pointInTesselatedPolygon_Q8(const GmMatrix& X, const GmVector& p);
  GMC_API_EXPORT bool   pointInPolygon             (const GmMatrix& X, const GmCellGeometry& g, const GmVector& p);
  GMC_API_EXPORT bool   pointInTetrahedron         (const GmMatrix& X, const GmVector& p);
  GMC_API_EXPORT bool   pointInHexahedron          (const GmMatrix& X, const GmVector& p);
  GMC_API_EXPORT double pointToConvexPolygon       (const GmMatrix& X, const GmVector& p, GmVector& proj);
  GMC_API_EXPORT double pointToTetrahedron         (const GmMatrix& X, const GmVector& p, GmVector& proj);

  GMC_API_EXPORT GmMatrix shuffle(const GmMatrix& X, const int order[], int size);

  GMC_API_EXPORT bool   hex27ValidFacesCenter(const GmMatrix& X, double tol);
  GMC_API_EXPORT bool   hex20ValidEdges(const GmMatrix& X, double proportion_max = 0.5);
  GMC_API_EXPORT bool   hex8PlanarFaces(const GmMatrix& X, double tol);
  GMC_API_EXPORT bool   hex8IsWellDefined(const GmMatrix& X);
  GMC_API_EXPORT bool   tet10ValidEdges(const GmMatrix& X, double proportion_max = 0.5);
  GMC_API_EXPORT bool   tet4IsWellDefined(const GmVector& p1, const GmVector& p2, const GmVector& p3, const GmVector& p4);
  GMC_API_EXPORT bool   pyra5IsWellDefined(const GmMatrix& X, double tol);
  GMC_API_EXPORT bool   pyra13ValidEdges(const GmMatrix& X, double proportion_max = 0.5);
  GMC_API_EXPORT bool   wedge6IsWellDefined(const GmMatrix& X, double tol);
  GMC_API_EXPORT bool   wedge15ValidEdges(const GmMatrix& X, double proportion_max = 0.5);

  GMC_API_EXPORT bool   isCoplanar3D(const GmVector& a, const GmVector& b, const GmVector& c, const GmVector& d, double tol);
  GMC_API_EXPORT GmMatrix get2DProjectionMatRow(const GmMatrix& X);
  GMC_API_EXPORT GmMatrix get2DProjectionMatCol(const GmMatrix& X);
  GMC_API_EXPORT QVector<QVector<int>> edgeFaceList(const QVector<QVector<int>>& faceEdgeList, int edgeCount);
}

#endif