TAPsFace.hpp

Go to the documentation of this file.

/******************************************************************************
TAPsFace.hpp

Face class is a class for 3D Face with normal direction (a plane normal), 
and texture coordinates.
It should contain a set of pointers to its vertices in CCW order.
Example:
          2-------1
           \       \
            \       \
             \       0
              \     /
               \   /
                \ /
                 3

SUKITTI PUNAK   (10/29/2004)
UPDATE          (04/04/2005)
******************************************************************************/
#ifndef TAPs_FACE_HPP
#define TAPs_FACE_HPP

#include "../Core/TAPsVector3.hpp"

BEGIN_NAMESPACE_TAPs
//=============================================================================
template <typename T>
class Face {
//=============================================================================
protected:
    int *       m_iVertexList;      
    int         m_iNoVertices;      
    Vector3<T>  m_v3N;              
    T *         m_pt2DTexCoords;    
    int         m_iNo2DTexCoords;   

#ifdef  TAPs_SUPPORT_ASE_FORMAT
    unsigned char   m_iSubmatID;    
#endif//TAPs_SUPPORT_ASE_FORMAT

#ifdef  TAPs_ENABLE_FACE_VERTEX_COLOR
    int *   m_iVertexColorList;     
#endif//TAPs_ENABLE_FACE_VERTEX_COLOR

#ifdef  TAPs_ENABLE_FACE_VERTEX_TEXTURE_COORDINATES
    int *   m_iVertexTextureList;   
#endif//TAPs_ENABLE_FACE_VERTEX_TEXTURE_COORDINATES

//=============================================================================
public:
    // DEBUG
    int     ID;
    //-------------------------------------------------------------------------
    // Output Operator <<
    friend std::ostream & operator<< ( std::ostream &output, Face<T> const &f )
    {
        output  << "Face<" << typeid(T).name() << "> has "
                << f.m_iNoVertices << " vertices:";
        //------------------------------------------------------------
        // Output vertex list
        for ( int i = 0; i < f.m_iNoVertices; ++i )
        {
            output << "  " << f.m_iVertexList[i];

            #ifdef  TAPs_ENABLE_FACE_VERTEX_COLOR
            output << " (vcolor: " << f.m_iVertexColorList[i] << ")";
            #endif//TAPs_ENABLE_FACE_VERTEX_COLOR

            #ifdef  TAPs_ENABLE_FACE_VERTEX_TEXTURE_COORDINATES
            output << " (vtexture: " << f.m_iVertexTextureList[i] << ")";
            #endif//TAPs_ENABLE_FACE_VERTEX_TEXTURE_COORDINATES
        }
        //------------------------------------------------------------
        // Output normal
        output << "  with Normal:" << f.m_v3N;
        //------------------------------------------------------------
        // Output texture coordinates
        output << "\n  and 2-D Texture Coordinates (" << f.m_iNo2DTexCoords << "):";
        for ( int i = 0; i < f.m_iNo2DTexCoords*2; ++i )
        {
            output << "  " << f.m_pt2DTexCoords[i];
        }
        return output;
    }
    //-------------------------------------------------------------------------
    // Constructors and destructor
    Face ( Vector3<T> normal = Vector3<T>() );  // default constructor
    Face ( int *vList, int n, 
            Vector3<T> normal = Vector3<T>() ); // construct from vertex list
    Face ( Face<T> const &f );                  // copy ctor
    virtual ~Face ();
    //-------------------------------------------------------------------------
    // Fn(s) for Normal
    inline void SetNormal( Vector3<T> normal )  { m_v3N = normal; }
    inline void SetNormal( T x, T y, T z )  { m_v3N.SetXYZ( x, y, z ); }
    inline Vector3<T> const & GetNormal() const { return m_v3N; }
    //-------------------------------------------------------------------------
    // Member Access for Vertex List
    inline int  GetNoVertices() const;
    inline void SetNoVertices( int n );
    inline int  GetNumVertices() const      { return GetNoVertices(); }
    inline void SetNumVertices( int n )     { SetNoVertices( n ); }
    inline int  GetVertexNo( int i ) const;
    inline void SetVertexNo( int i, int vNo );

#ifdef  TAPs_ENABLE_FACE_VERTEX_COLOR
    inline int  GetVertexColorNo( int i ) const;
    inline void SetVertexColorNo( int i, int vNo );
#endif//TAPs_ENABLE_FACE_VERTEX_COLOR

#ifdef  TAPs_ENABLE_FACE_VERTEX_TEXTURE_COORDINATES
    inline int  GetVertexTextureNo( int i ) const;
    inline void SetVertexTextureNo( int i, int vNo );
#endif//TAPs_ENABLE_FACE_VERTEX_TEXTURE_COORDINATES

    //-------------------------------------------------------------------------
    // Member Access for Texture Coordinates
    inline int  GetNoTexCoords() const;
    inline int  GetNumTexCoords() const     { return GetNoTexCoords(); }
    inline void SetNoTexCoords( int n );
    inline void SetNumTexCoords( int n )    { SetNoTexCoords( n ); }
    inline T    GetTexCoordNoS( int i ) const;
    inline T    GetTexCoordNoT( int i ) const;
    inline void GetTexCoordNoS( int i, T &s ) const;
    inline void GetTexCoordNoT( int i, T &t ) const;
    inline void SetTexCoordNoS( int i, T s );
    inline void SetTexCoordNoT( int i, T t );
    inline void GetTexCoordNo( int i, T &s, T &t ) const;
    inline void SetTexCoordNo( int i, T s, T t );
    inline T    GetTexCoordHalfNo( int i ) const;
    inline void GetTexCoordHalfNo( int i, T &v ) const;
    inline void SetTexCoordHalfNo( int i, T v );
    //inline void RemoveTexCoordNo( int i );
    //inline void InsertTexCoordNo( int i, T s, T t );
    //inline void AppendTexCoord( T s, T t );
    //-------------------------------------------------------------------------
#ifdef  TAPs_SUPPORT_ASE_FORMAT

    inline void          SetMaterialID ( unsigned char id ) { m_iSubmatID = id; }
    inline unsigned char GetMaterialID () const             { return m_iSubmatID; }
#endif//TAPs_SUPPORT_ASE_FORMAT
    //-------------------------------------------------------------------------
    // Assignment Operator
    inline Face<T> & operator= ( Face<T> const &f );
    //-------------------------------------------------------------------------
}; // END CLASS Face
//=============================================================================
END_NAMESPACE_TAPs
//-----------------------------------------------------------------------------
// Include definition if TAPs_USE_EXPORT is not defined
//#if !defined( TAPs_USE_EXPORT )
    #include "TAPsFace.cpp"
//#endif
//-----------------------------------------------------------------------------
#endif
//345678901234567890123456789012345678901234567890123456789012345678901234567890
//--+----1----+----2----+----3----+----4----+----5----+----6----+----7----+----8


/*
// Test Face class
#include "../GeometricDataStructure/TAPsVertex.hpp"
#include "../GeometricDataStructure/TAPsFace.hpp"
using namespace TAPs;
using namespace std;
int main()
{
    Vertexd dVertex = new Vertexd[4];
    dVertex[0] = new Vertexd( 4, 0, 0 );
    dVertex[1] = new Vertexd( 6, 2, 3 );
    dVertex[2] = new Vertexd( 3, 4, 3 );
    dVertex[3] = new Vertexd( 0, 1, 0 );
    cout << "dVertex[0] = " << dVertex[0] << endl;
    cout << "dVertex[1] = " << dVertex[1] << endl;
    cout << "dVertex[2] = " << dVertex[2] << endl;
    cout << "dVertex[3] = " << dVertex[3] << endl;
    int vList = new int[4];
    vList[0] = 0;
    vList[1] = 1;
    vList[2] = 2;
    vList[3] = 3;
    Face  F( vList, 4 );
    cout << Face << endl;
    return 0;
}
*/