TAPsReadTAPs.cpp

Go to the documentation of this file.

/******************************************************************************
TAPsReadTAPs.cpp

Create an OpenGL Polygonal Model Object from a .TAPs file

SUKITTI PUNAK   (11/11/2004)
UPDATE          (11/21/2004)
******************************************************************************/
#include "TAPsReadTAPs.hpp"
// Using Inclusion Model (i.e. definitions are included in declarations)
//                       (this name.cpp is included in name.hpp)
// Each friend is defined directly inside its declaration.

BEGIN_NAMESPACE_TAPs
//=============================================================================
template <typename T> FILE * ReadTAPs<T>::fileIn = NULL;
//=============================================================================
//-----------------------------------------------------------------------------
// Read an input file
template <typename T>
bool ReadTAPs<T>::readFile( const char *fileName, OpenGL::PolygonalModel<T> * const prModel )
{
    // Open the input file
    fileIn = fopen( fileName, "r" );
    if ( !fileIn ) {
        std::perror( fileName );
        return false;
    }

    // Read in each line, check what its contents are, 
    // and pass it out to the relevant decoder function
    const char * const NodeFormat    = "Format";
    const char * const NodeHeader    = "Header";
    const char * const NodeMaterial  = "Material";
    const char * const NodeVertices  = "Vertices";
    const char * const NodeFaces     = "Faces";
    const char * const NodeTexCoords = "TextureCoordinates";
    const char * const NodeEnd       = "End";

    char line[128];
    while ( !feof(fileIn) ) {
        fgets( line, 128, fileIn );     // read a line
        if ( line[0] == '#' ) continue;
        if      ( !strncmp( line, NodeFormat, strlen(NodeFormat) ) ) {
            ProcessNodeFormat( line, prModel );
        }
        else if ( !strncmp( line, NodeMaterial, strlen(NodeVertices) ) ) {
            ProcessNodeMaterial( line, prModel );
        }
        else if ( !strncmp( line, NodeVertices, strlen(NodeVertices) ) ) {
            ProcessNodeVertices( line, prModel );
        }
        else if ( !strncmp( line, NodeFaces, strlen(NodeFaces) ) ) {
            ProcessNodeFaces( line, prModel );
        }
        else if ( !strncmp( line, NodeTexCoords, strlen(NodeTexCoords) ) ) {
            ProcessNodeTextureCoordinates( line, prModel );
        }
    }
    fclose(fileIn);
    prModel->GetMaterial()->ApplyMaterial();
    return true;
}
//-----------------------------------------------------------------------------
// Read an input file
template <typename T>
bool ReadTAPs<T>::readFile( const char *fileName, OpenGL::XPolygonalModel<T> * const prModel )
{
    // Open the input file
    fileIn = fopen( fileName, "r" );
    if ( !fileIn ) {
        std::perror( fileName );
        return false;
    }

    // Read in each line, check what its contents are, 
    // and pass it out to the relevant decoder function
    const char * const NodeFormat    = "Format";
    const char * const NodeHeader    = "Header";
    const char * const NodeMaterial  = "Material";
    const char * const NodeVertices  = "Vertices";
    const char * const NodeFaces     = "Faces";
    const char * const NodeTexCoords = "TextureCoordinates";
    const char * const NodeImageTexture = "ImageTexture";
    const char * const NodeEnd       = "End";

    char line[128];
    while ( !feof(fileIn) ) {
        fgets( line, 128, fileIn );     // read a line
        if ( line[0] == '#' ) continue;
        if      ( !strncmp( line, NodeFormat, strlen(NodeFormat) ) ) {
            ProcessNodeFormat( line, prModel );
        }
        else if ( !strncmp( line, NodeMaterial, strlen(NodeVertices) ) ) {
            ProcessNodeMaterial( line, prModel );
        }
        else if ( !strncmp( line, NodeVertices, strlen(NodeVertices) ) ) {
            ProcessNodeVertices( line, prModel );
        }
        else if ( !strncmp( line, NodeFaces, strlen(NodeFaces) ) ) {
            ProcessNodeFaces( line, prModel );
        }
        else if ( !strncmp( line, NodeTexCoords, strlen(NodeTexCoords) ) ) {
            ProcessNodeTextureCoordinates( line, prModel );
        }
        else if ( !strncmp( line, NodeImageTexture, strlen(NodeImageTexture) ) ) {
            ProcessNodeImageTexture( line, prModel );
        }
    }
    fclose(fileIn);
    prModel->GetMaterial()->ApplyMaterial();
    return true;
}
//=============================================================================
//-----------------------------------------------------------------------------
// Process Format Node
template <typename T>
void ReadTAPs<T>::ProcessNodeFormat( char *line, OpenGL::PolygonalModel<T> * const prModel )
{
    // Example:
    //   Format TAPs_OpenGL_Model
    char s1[64], s2[64];
    sscanf( line, "%s %s", s1, s2 );
    if ( strncmp( s2, "TAPs_OpenGL_Model", strlen("TAPs_OpenGL_Model") ) ) {
        // Not "TAPs_OpenGL_Model" Format
        std::cerr << "The Input File is Not \"TAPs_OpenGL_Model\" Format!" << std::endl;
        exit ( EXIT_FAILURE );
    }
}
//-----------------------------------------------------------------------------
// Process Format Node
template <typename T>
void ReadTAPs<T>::ProcessNodeFormat( char *line, OpenGL::XPolygonalModel<T> * const prModel )
{
    // Example:
    //   Format TAPs_OpenGL_Model
    char s1[64], s2[64];
    sscanf( line, "%s %s", s1, s2 );
    if ( strncmp( s2, "TAPs_OpenGL_Model", strlen("TAPs_OpenGL_Model") ) ) {
        // Not "TAPs_OpenGL_Model" Format
        std::cerr << "The Input File is Not \"TAPs_OpenGL_Model\" Format!" << std::endl;
        exit ( EXIT_FAILURE );
    }
}
//=============================================================================
//-----------------------------------------------------------------------------
// Process Material Node
template <typename T>
void ReadTAPs<T>::ProcessNodeMaterial( char *line, OpenGL::PolygonalModel<T> * const prModel )
{
    //Example:
    //  Material
    //  {
    //    ambient     0.1 0.2 0.3 1.0
    //    diffuse     0.2 0.4 0.6 0.5   # alpha is the transparency
    //    specular    0.81 0.82 0.83 1.0
    //    shininess   1
    //    emission    0 0 0 0
    //  }
    char type[128];
    char cr[32];
    char cg[32];
    char cb[32];
    char ca[32];
    char *end;
    double r = 0, g = 0, b = 0, a = 0;
    sscanf( line, "%s", type );
    while ( type[0] != '{' ) {
        fgets( line, 128, fileIn );
        sscanf( line, "%s", type );
    }
    while ( type[0] != '}' ) {
        fgets( line, 128, fileIn );
        sscanf( line, "%s %s %s %s %s", type, cr, cg, cb, ca );
        if ( type[0] == '#' ) continue;
        if      ( !strncmp( type, "ambient", strlen("ambient") ) ) {
            r = strtod( cr, &end );
            g = strtod( cg, &end );
            b = strtod( cb, &end );
            a = strtod( ca, &end );
            prModel->GetMaterial()->SetAmbient( r, g, b, a );
        }
        else if ( !strncmp( type, "diffuse", strlen("diffuse") ) ) {
            r = strtod( cr, &end );
            g = strtod( cg, &end );
            b = strtod( cb, &end );
            a = strtod( ca, &end );
            prModel->GetMaterial()->SetDiffuse( r, g, b, a );
        }
        else if ( !strncmp( type, "specular", strlen("specular") ) ) {
            r = strtod( cr, &end );
            g = strtod( cg, &end );
            b = strtod( cb, &end );
            a = strtod( ca, &end );
            prModel->GetMaterial()->SetSpecular( r, g, b, a );
        }
        else if ( !strncmp( type, "shininess", strlen("shininess") ) ) {
            r = strtod( cr, &end );
            prModel->GetMaterial()->SetShininess( r );
        }
        else if ( !strncmp( type, "emission", strlen("emission") ) ) {
            r = strtod( cr, &end );
            g = strtod( cg, &end );
            b = strtod( cb, &end );
            a = strtod( ca, &end );
            prModel->GetMaterial()->SetEmission( r, g, b, a );
        }
    }
}
//-----------------------------------------------------------------------------
// Process Material Node
template <typename T>
void ReadTAPs<T>::ProcessNodeMaterial( char *line, OpenGL::XPolygonalModel<T> * const prModel )
{
    //Example:
    //  Material
    //  {
    //    ambient     0.1 0.2 0.3 1.0
    //    diffuse     0.2 0.4 0.6 0.5   # alpha is the transparency
    //    specular    0.81 0.82 0.83 1.0
    //    shininess   1
    //    emission    0 0 0 0
    //  }
    char type[128];
    char cr[32];
    char cg[32];
    char cb[32];
    char ca[32];
    char *end;
    double r = 0, g = 0, b = 0, a = 0;
    sscanf( line, "%s", type );
    while ( type[0] != '{' ) {
        fgets( line, 128, fileIn );
        sscanf( line, "%s", type );
    }
    while ( type[0] != '}' ) {
        fgets( line, 128, fileIn );
        sscanf( line, "%s %s %s %s %s", type, cr, cg, cb, ca );
        if ( type[0] == '#' ) continue;
        if      ( !strncmp( type, "ambient", strlen("ambient") ) ) {
            r = strtod( cr, &end );
            g = strtod( cg, &end );
            b = strtod( cb, &end );
            a = strtod( ca, &end );
            prModel->GetMaterial()->SetAmbient( r, g, b, a );
        }
        else if ( !strncmp( type, "diffuse", strlen("diffuse") ) ) {
            r = strtod( cr, &end );
            g = strtod( cg, &end );
            b = strtod( cb, &end );
            a = strtod( ca, &end );
            prModel->GetMaterial()->SetDiffuse( r, g, b, a );
        }
        else if ( !strncmp( type, "specular", strlen("specular") ) ) {
            r = strtod( cr, &end );
            g = strtod( cg, &end );
            b = strtod( cb, &end );
            a = strtod( ca, &end );
            prModel->GetMaterial()->SetSpecular( r, g, b, a );
        }
        else if ( !strncmp( type, "shininess", strlen("shininess") ) ) {
            r = strtod( cr, &end );
            prModel->GetMaterial()->SetShininess( r );
        }
        else if ( !strncmp( type, "emission", strlen("emission") ) ) {
            r = strtod( cr, &end );
            g = strtod( cg, &end );
            b = strtod( cb, &end );
            a = strtod( ca, &end );
            prModel->GetMaterial()->SetEmission( r, g, b, a );
        }
    }
}
//=============================================================================
//-----------------------------------------------------------------------------
// Process Vertices Node
template <typename T>
void ReadTAPs<T>::ProcessNodeVertices( char *line, OpenGL::PolygonalModel<T> * const prModel )
{
    /*
    //Example
    // 12 556.629028 2647.669922 436.273010
    char *end;
    char *delimiters = "\t ";
    char *token = strtok( line, delimiters );   // token is "12"
    token  = strtok( '\0', delimiters );            // token is "556.629028"
    pObject1_c->m_pdVertex[n][0] = strtod( token, &end );
    token  = strtok( '\0', delimiters );            // token is "2647.669922"
    pObject1_c->m_pdVertex[n][1] = strtod( token, &end );
    token  = strtok( '\0', delimiters );            // token is "436.273010"
    pObject1_c->m_pdVertex[n][2] = strtod( token, &end );
    */

    //Example:
    //  Vertices 6
    //  {
    //    #  x  y  z
    //       1 -1  0
    //       1  1  0
    //      -1  1  0
    //      -1 -1  0
    //      -2 -1  0
    //  }
    char cx[128];
    char cy[32];
    char cz[32];
    char *end;

    // Set number of vertices
    sscanf( line, "%s %s", cx, cy );
    int n = strtod( cy, &end );
    prModel->SetNoVertices( n );
    prModel->NewVertexListByNoVertices();

    // Set each vertex
    n = 0;
    while ( cx[0] != '{' ) {
        fgets( line, 128, fileIn );
        sscanf( line, "%s", cx );
    }
    while ( cx[0] != '}' && n < prModel->GetNoVertices() ) {
        fgets( line, 128, fileIn );
        sscanf( line, "%s %s %s", cx, cy, cz );
        if ( cx[0] == '#' ) continue;
        prModel->GetVertexList()[n  ][0] = strtod( cx, &end );
        prModel->GetVertexList()[n  ][1] = strtod( cy, &end );
        prModel->GetVertexList()[n++][2] = strtod( cz, &end );
    }
    prModel->SetNoVertices( n );
}
//-----------------------------------------------------------------------------
// Process Vertices Node
template <typename T>
void ReadTAPs<T>::ProcessNodeVertices( char *line, OpenGL::XPolygonalModel<T> * const prModel )
{
    /*
    //Example
    // 12 556.629028 2647.669922 436.273010
    char *end;
    char *delimiters = "\t ";
    char *token = strtok( line, delimiters );   // token is "12"
    token  = strtok( '\0', delimiters );            // token is "556.629028"
    pObject1_c->m_pdVertex[n][0] = strtod( token, &end );
    token  = strtok( '\0', delimiters );            // token is "2647.669922"
    pObject1_c->m_pdVertex[n][1] = strtod( token, &end );
    token  = strtok( '\0', delimiters );            // token is "436.273010"
    pObject1_c->m_pdVertex[n][2] = strtod( token, &end );
    */

    //Example:
    //  Vertices 6
    //  {
    //    #  x  y  z
    //       1 -1  0
    //       1  1  0
    //      -1  1  0
    //      -1 -1  0
    //      -2 -1  0
    //  }
    char cx[128];
    char cy[32];
    char cz[32];
    char *end;

    // Set number of vertices
    sscanf( line, "%s %s", cx, cy );
    int n = strtod( cy, &end );
    prModel->SetNoVertices( n );
    prModel->NewVertexListByNoVertices();

    // Set each vertex
    n = 0;
    while ( cx[0] != '{' ) {
        fgets( line, 128, fileIn );
        sscanf( line, "%s", cx );
    }
    while ( cx[0] != '}' && n < prModel->GetNoVertices() ) {
        fgets( line, 128, fileIn );
        sscanf( line, "%s %s %s", cx, cy, cz );
        if ( cx[0] == '#' ) continue;
        prModel->GetVertexList()[n  ][0] = strtod( cx, &end );
        prModel->GetVertexList()[n  ][1] = strtod( cy, &end );
        prModel->GetVertexList()[n++][2] = strtod( cz, &end );
    }
    prModel->SetNoVertices( n );
}
//=============================================================================
//--------------------------------------------------------------------------
// Process Face Node
template <typename T>
void ReadTAPs<T>::ProcessNodeFaces( char *line, OpenGL::PolygonalModel<T> * const prModel )
{
    //Example:
    //  Faces 2
    //  {
    //    #nb_nodes   node_0 node_1 ... node_(nb_nodes-1)
    //       4        0 1 2 3
    //       3        2 3 4
    //  }

    // Set number of faces
    int n = 0;
    char str[128];
    sscanf( line, "%s%d", str, &n );
    prModel->SetNoFaces( n );
    prModel->NewFaceListByNoFaces();

    // Temp Variables
    char *delimiters = "\t ";
    char *token = NULL;
    char *end;
    int numberOfVertices;
    int vertexNo;

    // For vertex info
    //vertexAt = new std::vector<int>[n];

    // Set each Xface
    n = 0;
    while ( str[0] != '{' ) {
        fgets( line, 128, fileIn );
        sscanf( line, "%s", str );
    }
    while ( str[0] != '}' && n < prModel->GetNoFaces() ) {
        fgets( line, 128, fileIn );
        sscanf( line, "%s", str );
        if ( str[0] == '#' ) continue;

        // Get and set number of vertices
        token = strtok( line, delimiters );
        numberOfVertices = static_cast<int>( strtol( token, &end, 10 ) );
        prModel->GetFaceList()[n].SetNoVertices( numberOfVertices );

        // Set the Xface
        for ( int i = 0; i < numberOfVertices; ++i )
        {
            token = strtok( '\0', delimiters );
            vertexNo = static_cast<int>( strtol( token, &end, 10 ) );
            prModel->GetFaceList()[n].SetVertexNo( i, vertexNo );
            //vertexAt[vertexNo].push_back( i );
        }
        ++n;
    }
    prModel->SetNoFaces( n );
}
//--------------------------------------------------------------------------
// Process Face Node
template <typename T>
void ReadTAPs<T>::ProcessNodeFaces( char *line, OpenGL::XPolygonalModel<T> * const prModel )
{
    //Example:
    //  Faces 2
    //  {
    //    #nb_nodes   node_0 node_1 ... node_(nb_nodes-1)
    //       4        0 1 2 3
    //       3        2 3 4
    //  }

    // Set number of faces
    int n = 0;
    char str[128];
    sscanf( line, "%s%d", str, &n );
    prModel->SetNoFaces( n );
    prModel->NewFaceListByNoFaces();

    // Temp Variables
    char *delimiters = "\t ";
    char *token = NULL;
    char *end;
    int numberOfVertices;
    int vertexNo;

    // For vertex info
    //vertexAt = new std::vector<int>[n];

    // Set each Xface
    n = 0;
    while ( str[0] != '{' ) {
        fgets( line, 128, fileIn );
        sscanf( line, "%s", str );
    }
    while ( str[0] != '}' && n < prModel->GetNoFaces() ) {
        fgets( line, 128, fileIn );
        sscanf( line, "%s", str );
        if ( str[0] == '#' ) continue;

        // Get and set number of vertices
        token = strtok( line, delimiters );
        numberOfVertices = static_cast<int>( strtol( token, &end, 10 ) );
        prModel->GetFaceList()[n].SetNoVertices( numberOfVertices );

        // Set the Xface
        for ( int i = 0; i < numberOfVertices; ++i )
        {
            token = strtok( '\0', delimiters );
            vertexNo = static_cast<int>( strtol( token, &end, 10 ) );
            prModel->GetFaceList()[n].SetVertexNo( i, vertexNo );
            //vertexAt[vertexNo].push_back( i );
        }
        ++n;
    }
    prModel->SetNoFaces( n );
}
//=============================================================================
//-----------------------------------------------------------------------------
// Process TextureCoordinates Node
template <typename T>
void ReadTAPs<T>::ProcessNodeTextureCoordinates( char *line, OpenGL::PolygonalModel<T> * const prModel )
{
    //Example:
    //  TextureCoordinates 2
    //  {
    //    # Texture Coordinates assigned at face vertices
    //    # vertices    s_0    t_0    s_1    t_1    s_2    t_2    s_3    t_3
    //    0    4      0.3166 0.6316 0.3441 0.6337 0.3537 0.6127 0.3225 0.6008
    //    1    4      0.3015 0.8142 0.3624 0.8094 0.3548 0.7738 0.3012 0.7804
    //  }
    //Another Example:
    //  TextureCoordinates 1
    //  {
    //    # Texture Coordinates assigned at face vertices
    //    # vertices    s_0    t_0    s_1    t_1    s_2    t_2    s_3    t_3
    //    0    4        1      0      1      1      0      1      0      0
    //  }

    // Set number of (2-D) texture coordinates
    int n = 0;
    char str[128];
    sscanf( line, "%s%d", str, &n );
    prModel->SetNoTexCoords( n );

    // Temp Variables
    char *delimiters = "\t ";
    char *token = NULL;
    char *end;
    int numberOfTexCoords;
    Real s, t;  // texture coordinates
    int faceNo;

    // Set texture coordinates of each Xface
    n = 0;
    while ( str[0] != '{' ) {
        fgets( line, 128, fileIn );
        sscanf( line, "%s", str );
    }
    while ( str[0] != '}' && n < prModel->GetNoTexCoords() ) {
        fgets( line, 128, fileIn );
        sscanf( line, "%s", str );
        if ( str[0] == '#' ) continue;

        // Get number of face
        token = strtok( line, delimiters );
        faceNo = static_cast<int>( strtol( token, &end, 10 ) );
        // Get number of texture coordinates
        token = strtok( '\0', delimiters );
        numberOfTexCoords = static_cast<int>( strtol( token, &end, 10 ) );
        prModel->GetFaceList()[faceNo].SetNoTexCoords( numberOfTexCoords );

        // Set the texture coordinates
        for ( int i = 0; i < numberOfTexCoords; ++i )
        {
            token = strtok( '\0', delimiters );
            s = static_cast<Real>( strtod( token, &end ) );
            token = strtok( '\0', delimiters );
            t = static_cast<Real>( strtod( token, &end ) );
            prModel->GetFaceList()[faceNo].SetTexCoordNo( i, s, t );
        }
        ++n;
    }
    prModel->SetNoTexCoords( n );
}
//-----------------------------------------------------------------------------
// Process TextureCoordinates Node
template <typename T>
void ReadTAPs<T>::ProcessNodeTextureCoordinates( char *line, OpenGL::XPolygonalModel<T> * const prModel )
{
    //Example:
    //  Texture 2
    //  {
    //    # Texture Coordinates assigned at face vertices
    //    # virtices    s_0    t_0    s_1    t_1    s_2    t_2    s_3    t_3
    //    0    4      0.3166 0.6316 0.3441 0.6337 0.3537 0.6127 0.3225 0.6008
    //    1    4      0.3015 0.8142 0.3624 0.8094 0.3548 0.7738 0.3012 0.7804
    //  }
    //Another Example:
    //  Texture 1
    //  {
    //    # Texture Coordinates assigned at face vertices
    //    # vertices    s_0    t_0    s_1    t_1    s_2    t_2    s_3    t_3
    //    0    4        1      0      1      1      0      1      0      0
    //  }


    // Set number of (2-D) texture coordinates
    int n = 0;
    char str[128];
    sscanf( line, "%s%d", str, &n );
    prModel->SetNoTexCoords( n );

    // Temp Variables
    char *delimiters = "\t ";
    char *token = NULL;
    char *end;
    int numberOfTexCoords;
    Real s, t;  // texture coordinates
    int faceNo;

    // Set texture coordinates of each Xface
    n = 0;
    while ( str[0] != '{' ) {
        fgets( line, 128, fileIn );
        sscanf( line, "%s", str );
    }
    while ( str[0] != '}' && n < prModel->GetNoTexCoords() ) {
        fgets( line, 128, fileIn );
        sscanf( line, "%s", str );
        if ( str[0] == '#' ) continue;

        // Get number of face
        token = strtok( line, delimiters );
        faceNo = static_cast<int>( strtol( token, &end, 10 ) );
        // Get number of texture coordinates
        token = strtok( '\0', delimiters );
        numberOfTexCoords = static_cast<int>( strtol( token, &end, 10 ) );
        prModel->GetFaceList()[faceNo].SetNoTexCoords( numberOfTexCoords );

        // Set the texture coordinates
        for ( int i = 0; i < numberOfTexCoords; ++i )
        {
            token = strtok( '\0', delimiters );
            s = static_cast<Real>( strtod( token, &end ) );
            token = strtok( '\0', delimiters );
            t = static_cast<Real>( strtod( token, &end ) );
            prModel->GetFaceList()[faceNo].SetTexCoordNo( i, s, t );
        }
        ++n;
    }
    prModel->SetNoTexCoords( n );
}
//=============================================================================
//-----------------------------------------------------------------------------
// Process ImageTexture Node
template <typename T>
void ReadTAPs<T>::ProcessNodeImageTexture( char *line, OpenGL::XPolygonalModel<T> * const prModel )
{
    // ImageTexture
    // {
    //    fileName  "../Textures/dg_gallbladder.bmp"
    //    repeatS       false
    //    repeatT       false
    // }
    char type[128];
    char argument[128];
    //char *end;
    double r = 0, g = 0, b = 0, a = 0;
    sscanf( line, "%s", type );
    while ( type[0] != '{' ) {
        fgets( line, 128, fileIn );
        sscanf( line, "%s", type );
    }
    while ( type[0] != '}' ) {
        fgets( line, 128, fileIn );
        sscanf( line, "%s %s", type, argument );
        //std::cout << argument << std::endl;
        if ( type[0] == '#' ) continue;
        if ( !strncmp( type, "fileName", strlen("fileName") ) ) {
            prModel->SetImageFileName( argument );
            prModel->m_pcImg = new BitmapImage();
            if ( prModel->m_pcImg->LoadBitmapFile( argument ) ) {
                //prModel->EnableTexture();
            }
            else {
                //prModel->m_pcImg.~BitmapImage();
                std::cout << "ReadTAPs: Could not open the bitmap file!" << std::endl;
            }
        }
        else if ( !strncmp( type, "repeatS", strlen("repeatS") ) ) {
            //prModel->GetMaterial()->SetDiffuse( r, g, b, a );
        }
        else if ( !strncmp( type, "repeatT", strlen("repeatT") ) ) {
            //prModel->GetMaterial()->SetSpecular( r, g, b, a );
        }
    }
}
//-----------------------------------------------------------------------------
//=============================================================================
END_NAMESPACE_TAPs
//-----------------------------------------------------------------------------
//345678901234567890123456789012345678901234567890123456789012345678901234567890
//--+----1----+----2----+----3----+----4----+----5----+----6----+----7----+----8