TAPsXPolygonalModel.hpp

Go to the documentation of this file.

/******************************************************************************
XPolygonalModel.hpp

(X <==> Extra)
A (Generic) Polygonal Model contains:
    char *      m_pcObjectName;     // object name
    int         m_iNoVertices;  // # of vertices
    int         m_iNoFaces;     // # of faces
    int         m_iNoTexCoords; // # of texture coordinates
    Vertex<T> * m_prXVertex;        // Vertex pointers
    Face<T> *   m_prFace;           // Face pointers
    std::vector<int> *  m_pviVertexRing1List;   // neighbor vertices in ring 1

Each property should be set explicitly except the following:
  - m_pcObjectName (is for identification, not important)
  - m_iNoTexCoords (must be set if use with texture)
The normal of each m_prXVertex and m_prFace can be calculated by provided fns.
Each m_pviVertexRing1List can also be calculated by provided fns.

SUKITTI PUNAK   (11/01/2004)
UPDATE          (02/12/2006)
******************************************************************************/
#ifndef TAPs_XPOLYGONAL_MODEL_HPP
#define TAPs_XPOLYGONAL_MODEL_HPP

#include "TAPsOpenGLMeshModel.hpp"
#include "../GeometricDataStructure/TAPsXVertex.hpp"
#include "../GeometricDataStructure/TAPsFace.hpp"

BEGIN_NAMESPACE_TAPs__OpenGL
//=============================================================================
template <typename T>
class XPolygonalModel : public /*virtual*/ OpenGLMeshModel<T> {
    //-------------------------------------------------------------------------
    // (Friend Fn) put it through ostream
    friend std::ostream & operator<< ( std::ostream &output, XPolygonalModel<T> const &o )
    {
        output  << "\n======================\n"
                <<   "TAPs::XPolygonalModel<"
                << typeid(T).name() << "> Class:\n"
                <<   "======================\n";
        //----------------------------------------------------------------
        // Vertices Node
        output  << "\n\nVertices " << o.m_iNoVertices << "\n{";
        for ( int i = 0; i < o.m_iNoVertices; ++i ) {
            output << "\n  #" << i << "\t" << o.m_prXVertex[i];
        }
        output  << "\n}";
        //----------------------------------------------------------------
        // Neighbor vertex ring#1
        if ( o.m_pviVertexRing1List ) {
            std::vector<int>::const_iterator iterator;
            output  << "\n\nVertexRing1 " << o.m_iNoVertices << "\n{";
            for ( int i = 0; i < o.m_iNoVertices; ++i ) {
                output << "\n  #" << i;
                for (   iterator = o.m_pviVertexRing1List[i].begin(); 
                        iterator != o.m_pviVertexRing1List[i].end();
                        ++iterator )
                {
                    output << "\t" << *iterator;
                }
            }
            output  << "\n}";
        }
        //----------------------------------------------------------------
        // Faces Node
        output  << "\n\nFaces " << o.m_iNoFaces  << "\n{";
        for ( int i = 0; i < o.m_iNoFaces; ++i ) {
            output << "\n  #" << i << "\t" << o.m_prFace[i];
        }
        output  << "\n}";
        return output;
    }
//-----------------------------------------------------------------------------
// Member Functions ------------------------------------------------------------
public:
    //-------------------------------------------------------------------------
    // default constructor
    XPolygonalModel ();
    //-------------------------------------------------------------------------
    // destructor
    virtual ~XPolygonalModel ();
    //-------------------------------------------------------------------------
    // Virtual Fns from Model class
    virtual void Initialize ();
    virtual T GetMaxHalfLength () const;    // get half length
    virtual void ApplyAndResetTransform ();
    //-------------------------------------------------------------------------
    // Determine and sort the face ring of each vertex
    void DetermineAndSortRings();
    //-------------------------------------------------------------------------
    // 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
    virtual void CalBoundingAABB ();
    virtual void CalBoundingEllipsoid ();
    virtual void CalBoundingSphere ();
    //-------------------------------------------------------------------------
public:
    //-------------------------------------------------------------------------
    // Get/Set Fn(s)
    inline XVertex<T> * const GetVertexList() const { return m_prXVertex; }
    inline Face<T> * const GetFaceList() const { return m_prFace; }
    inline void SetVertexList( XVertex<T> *p )  { m_prXVertex = p; }
    inline void SetFaceList( Face<T> *p )       { m_prFace = p; }
    //-------------------------------------------------------------------------
    // New/Delete Fn(s)
    inline void NewVertexListByNoVertices ();
    inline void NewFaceListByNoFaces ();
//-----------------------------------------------------------------------------
// Data Members  ---------------------------------------------------------------
protected:
    XVertex<T> *    m_prXVertex;        // XVertex pointers
    Face<T> *       m_prFace;           // Face pointers
    std::vector<int> *  m_pviVertexRing1List;   // neighbor vertices in ring 1
    //std::vector<int> *    m_pviVertexRing2List;   // neighbor vertices in ring 2
}; // CLASS END: XPolygonalModel ***********************************************
//=============================================================================
END_NAMESPACE_TAPs__OpenGL
//-----------------------------------------------------------------------------
// Include definition if TAPs_USE_EXPORT is not defined
//#if !defined( TAPs_USE_EXPORT )
    #include "TAPsXPolygonalModel.cpp"
//#endif
//-----------------------------------------------------------------------------
#endif
//345678901234567890123456789012345678901234567890123456789012345678901234567890
//--+----1----+----2----+----3----+----4----+----5----+----6----+----7----+----8