TAPsHalfEdgeTrigonalModel.hpp

Go to the documentation of this file.

/******************************************************************************
TAPsHalfEdgeTrigonalModel.hpp

--------------------------------------------------------------------------
From HalfEdgeModel class:
=========================
A Polygonal Model based on half-edge data structure contains:
    HEVertexList<T> *m_listVertex;      // HEVertex in a list
    HEFaceList<T>   *m_listFace;        // HEFace in a list
    HEFaceList<T>   *m_listHoleFace;    // Hole HEFace in a list

    A hole face represents a hole in the surface.
--------------------------------------------------------------------------

HalfEdgeTrigonalModel, a subclass of HalfEdgeModel, is for a triangular mesh.

SUKITTI PUNAK   (06/15/2006)
UPDATE          (06/15/2006)
******************************************************************************/
#ifndef TAPs_HALF_EDGE_TRIGONAL_MODEL_HPP
#define TAPs_HALF_EDGE_TRIGONAL_MODEL_HPP

#include "TAPsHalfEdgeModel.hpp"

/*==============================================================================
Half-Edge Data Structure:
=========================
HEVertex class is a class for 3D half-edge vertex.
  - position
  - normal
  - incident half-edge
HEFace class is a class for 3D half-edge Face.
  - normal
  - vertex loop (in CCW order)
  - texture coordinates for the vertex loop
  - incident half-edge
HEHalfEdge class is a class for 3D half-edge.
  - originating vertex
  - incident face
  - pair of this half-edge
  - next half-edge (CCW)
  - previous half-edge (CW)
                                                      *
                                                      *
                          E2                          *
             V3 <--------------------- V2             *
              \                        /\             *
               \                      /               *
             E3 \         F0      E1 /                *
                 \                  /                 *
                  \                /                  *
                  _\/     E0      /                   *
                    V0 --------> V1                   *
                                                      *
                                                      *
                         |                            *
                   \_    |    _/                      *
                     \_  |  _/                        *
                       \ | /                          *
                -------- V --------                   *
                      _/ | \_                         *
                    _/   |   \_                       *
                   /     |     \                      *
                         |                            *
                                                      *
                                                      *
==============================================================================*/


BEGIN_NAMESPACE_TAPs__OpenGL
//=============================================================================
template <typename T>
class HalfEdgeTrigonalModel : public /*virtual*/ HalfEdgeModel<T> {
    //-------------------------------------------------------------------------
    // (Friend Fn) put it through ostream
    friend std::ostream & operator<< ( std::ostream &output, HalfEdgeTrigonalModel<T> const &o )
    {
        output  << "\n===========================\n"
                <<   "TAPs::HalfEdgeTrigonalModel<"
                << typeid(T).name() << "> Class:\n"
                <<   "===========================\n";
        //----------------------------------------------------------------
        if ( o.GetName() != NULL ) {
            output << "Name: " << o.GetName() << "\n";
        }
        //----------------------------------------------------------------
        // Vertex Nodes
        output  << "Vertices " << o.m_listVertex->Size() << "\n";
        /*
        int i;
        i = 0;
        HEVertex<T> *vertex = o.m_listVertex->Head();
        output << "\n{";
        while ( vertex ) {
            output << "\n  #" << ++i << "\t" << *vertex;
            vertex = vertex->Next();
        }
        output  << "\n}";
        //*/
        //----------------------------------------------------------------
        // Face Nodes
        output  << "Faces " << o.m_listFace->Size() << "\n";
        /*
        i = 0;
        HEFace<T> *face = o.m_listFace->Head();
        output << "\n{";
        while ( face ) {
            output << "\n  #" << ++i << "\t" << *face;
            face = face->Next();
        }
        output  << "\n}";
        //*/
        //----------------------------------------------------------------
        // Hole Face Nodes
        output  << "Hole Faces " << o.m_listHoleFace->Size() << "\n";
        /*
        i = 0;
        face = o.m_listHoleFace->Head();
        output << "\n{";
        while ( face ) {
            output << "\n  #" << ++i << "\t" << *face;
            face = face->Next();
        }
        output  << "\n}";
        //*/
        //----------------------------------------------------------------
        return output;
    }
//-----------------------------------------------------------------------------
// Member Functions ------------------------------------------------------------
public:
    //-------------------------------------------------------------------------
    // default constructor
    HalfEdgeTrigonalModel ();
    //-------------------------------------------------------------------------
    // destructor
    virtual ~HalfEdgeTrigonalModel ();
    //-------------------------------------------------------------------------
    // Virtual Fns from Model class
    virtual void Initialize ();
//  virtual T GetMaxHalfLength () const;    // get half length
//  virtual void TransformByTranslationRatationAndScale ();
    //-------------------------------------------------------------------------
    // Calculate and set the normals
    virtual void CalAndSetNormals();
protected:
    //-------------------------------------------------------------------------
    // Helper Fn(s)
    virtual inline void CalAndSetFaceNormalsNotNormalized ();
    virtual inline void NormalizeFaceNormals ();
    //virtual inline void DetermineFaceRings ();
    virtual inline void CalAndSetVertexNormals ();
    //-------------------------------------------------------------------------
    // Virtual Fns from Collision Detection from ColDetSupport class <-----
    // OpenGLModel class
//  virtual void CalBoundingAABB ();        // AABB for the whole object
//  virtual void CalBoundingEllipsoid ();   // Ellipsoid for the whole object
//  virtual void CalBoundingSphere ();      // Sphere for the whole object
public:
    virtual void BuildBVHTree ( TAPs::Enum::CD treeType ); // Create BVHTree
    //-------------------------------------------------------------------------
public:
    //-------------------------------------------------------------------------
    // Get/Set Fn(s)
//  inline HEVertexList<T> * const GetVertexList() const { return m_listVertex; }
//  inline HEFaceList<T>   * const GetFaceList()   const { return m_listFace; }
//  inline HEFaceList<T>   * const GetHoleFaceList()   const { return m_listHoleFace; }
//  inline void SetVertexList( HEVertexList<T> *p ) { m_listVertex = p; }
//  inline void SetFaceList  ( HEFaceList<T>   *p ) { m_listFace   = p; }
//  inline void SetHoleFaceList  ( HEFaceList<T>   *p ) { m_listHoleFace   = p; }
    //-------------------------------------------------------------------------
    // Get/Set Vertex
//  void AddVertex ();
    //void DelVertex ();
    //-------------------------------------------------------------------------
    // Get/Set Face
//  void AddFace ();
    //void DelFace ();
    //-------------------------------------------------------------------------
    // Get/Set HalfEdge
//  void AddHalfEdge ();
    //void DelHalfEdge ();
    //-------------------------------------------------------------------------
//-----------------------------------------------------------------------------
// Data Members  ---------------------------------------------------------------
protected:
    //----------------------------------------------------------------
    // Geometric Surface Data
//  HEVertexList<T> * m_listVertex;     // HEVertex in a list
//  HEFaceList<T>   * m_listFace;       // HEFace in a list
//  HEFaceList<T>   * m_listHoleFace;   // Hole HEFace in a list
    //----------------------------------------------------------------
    // For Fast Access (e.g. for OpenGL Drawing)
//  std::vector< Vector3<T> * > m_vListOfVertexPositions;
//  std::vector< Vector3<T> * > m_vListOfVertexNormals;
public:
//  std::vector< Vector3<T> * > &   GetListOfVertexPositions ()
//      { return m_vListOfVertexPositions; }
//  std::vector< Vector3<T> * > &   GetListOfVertexNormals () 
//      { return m_vListOfVertexNormals; }
//  void SetListOfVertexPositionsAndNormals ();
//-----------------------------------------------------------------------------
}; // CLASS END: HalfEdgeTrigonalModel *****************************************
//=============================================================================
END_NAMESPACE_TAPs__OpenGL
//-----------------------------------------------------------------------------
// Include definition if TAPs_USE_EXPORT is not defined
//#if !defined( TAPs_USE_EXPORT )
    #include "TAPsHalfEdgeTrigonalModel.cpp"
//#endif
//-----------------------------------------------------------------------------
#endif
//345678901234567890123456789012345678901234567890123456789012345678901234567890
//--+----1----+----2----+----3----+----4----+----5----+----6----+----7----+----8