eng_import.hh

Go to the documentation of this file.

/*
 * LEGAL:   COPYRIGHT (C) JIM E. BROOKS 2005
 *          THIS SOURCE CODE IS RELEASED UNDER THE TERMS
 *          OF THE GNU GENERAL PUBLIC LICENSE VERSION 2 (GPL 2).
 *****************************************************************************/

#ifndef ENG_IMPORT_HH
#define ENG_IMPORT_HH 1

#include "eng_node.hh"
#include "eng_graph.hh"
#include "eng_graph_maker.hh"

namespace eng {

// Interface to import is a friend function:
SharedPtr<Graph>
ImportGraph( const string& fnameModel,
             const Vector3 vertexScale = Vector3(1,1,1),
             const Vector3 vertexOffset = Vector3(0,0,0) );

class GraphImporter
{


// Client interface is a friend function:
    friend SharedPtr<Graph>
    ImportGraph( const string& fnameModel,
                 const Vector3 vertexScale,    // default: (1,1,1)
                 const Vector3 vertexOffset )  // default: (0,0,0)
    {
        GraphImporter importer( fnameModel, vertexScale, vertexOffset );
        return importer.GetGraph();
    }

private:
    // Constructor imports the 3D model as a Graph object
    // which can be obtained by GetGraph().
                    GraphImporter( const string& fnameModel,
                                   const Vector3& vectorScale,
                                   const Vector3& vectorOffset );
                    ~GraphImporter();
    SharedPtr<Graph>    GetGraph( void );
    SharedPtr<Graph>    Import( void );
    void            ImportBeginPartition( const bool parsedRootPartition );
    void            ImportEndPartition( void );
    void            ImportVertexs( void );
    void            ImportPolygonBegin( void );
    void            ImportPolygonEnd( void );
    void            ImportPolygonColor( void );
    void            ImportPolygonTexture( void );
    void            ImportPolygonVixs( void );
    void            CheckStream( void );
    void            Error( void );
    // To scale a model.
    LocalVertex     TransformVertex( LocalVertex v )
    {
        v *= mVertexScale;  // apply scale first
        v += mVertexOffset;
        return v;
    }

private:
    class Polygon
    {
    public:
        Polygon( void )
        {
            mNum = 0;
            Reset();
            mNum = 0;  // twice
        }

        void Reset( void )
        {
            Reset( mNum );  // continue num by default
        }

        void Reset( uint num )
        {
            mNum = num;

            // Clear other members.
            mNodePredecessors.Clear();
            mVixs.clear();
            mNix = mNum;  // assign, don't zero
            mTexCoords.clear();
            mModes = ModesNode::Modes::MODE_DEFAULT;
        #if DEBUG
            mDebugImportedColor = false;
            mDebugImportedVixs = false;
        #endif

            // Increment polygon number.  Determines polygon's index into normal vectors.
            ++mNum;
            ASSERT( mNum < MAX_POLYGONS );
        }

        bool IfTextured( void ) const { return not mTexCoords.empty(); }

    private:
        uint                            mNum;
    public:
        GraphMaker::NodePredecessors    mNodePredecessors;
        Vixs                            mVixs;  
        Nix                             mNix;   
        vector<TexCoord>                mTexCoords;
        ModesNode::Modes                mModes;
        #if DEBUG
        bool                            mDebugImportedColor;
        bool                            mDebugImportedVixs;
        #endif
    };

// Persistent/const data members:
private:
    typedef map<string,SharedPtr<Graph> > GraphMap;
    CLASS_VAR GraphMap  mGraphMap;      

    // The magic RGB (0.42,0.42,0.42) in a Blender model means translucency.
    CLASS_CONST uint MODEL_COLOR_TRANSLUCENT = 107;  // 107 = 0.42 * 256
    CLASS_CONST uint COLOR_TRANSLUCENT_R     = uint(0.40 * 256.0);
    CLASS_CONST uint COLOR_TRANSLUCENT_G     = uint(0.40 * 256.0);
    CLASS_CONST uint COLOR_TRANSLUCENT_B     = uint(0.45 * 256.0);
    CLASS_CONST uint COLOR_TRANSLUCENT_A     = uint(0.45 * 256.0);

// Instance data members:
private:
    const string                 mFnameModel;       
    const Vector3                mVertexScale;
    const Vector3                mVertexOffset;
    string                       mFileBuf;
    istringstream                mIstream;          
    GraphMaker                   mGraphMaker;       
    shptr<GraphMaker::Partition> mGraphPartition;   
    Stack<SharedPtr<GraphMaker::Partition> > mGraphPartitionStack;
    Polygon                      mPolygon;          
#if DEBUG
    uint                         mDebugVertexsCnt;
    bool                         mDebugImportedPolygon;
    bool                         mDebugReturnedGraph;
    uint                         mDebugBeginPartition;  
    uint                         mDebugEndPartition;
#endif
};

} // namespace eng

#endif // ENG_IMPORT_HH

Palomino 3D Engine documents generated by doxygen 1.5.3 on Fri Nov 23 11:26:08 2007