---

MRModel.h

Go to the documentation of this file.

/*
    File:       MRModel.h

    Function:   Implements edge-contraction multires polygonal model

    Author:     Andrew Willmott

    Copyright:  (c) 1997-2000, Andrew Willmott
*/

#ifndef __MRModel__
#define __MRModel__

#include "gcl/MRVertex.h"
#include "gcl/MRFaceCluster.h"
#include "gcl/Renderer.h"

typedef Array<Byte> ActList;

enum MRM_Flags
{
    MRM_MemMapped   = 0x0001,
    MRM_Ordered     = 0x0002,
    MRM_End
};

class MRModel
{
public:
    MRModel();
    ~MRModel();
    
    // Adaption routines
    Void            SimplestModel();
    Void            MostComplexModel();

    Void            AdaptFaces(Int targetFaces);
    Void            AdaptClusters(Int targetClusters);
    Void            AdaptComplexity(GCLReal complexity);

    Void            AdaptLength(
                        GCLReal             threshold,  
                        const Transform     &M,         
                        const Transform     &P,         
                        Float               timeLimit = vl_inf  
                    );
                    
    // Parsing
    Bool            Parse(StrConst filename);
    Bool            ParseBinary();
    Bool            ParseText();
    Void            WriteBinary();

    // Drawing
    Void            Draw(Renderer &r);
    
    // Internal utility routines
    Void            PrepareModel();
    Void            AdjustLeafFaces();
    
    Void            PrepareClusters();
    Void            PrepareVertices();

    Void            DrawClusterFaces(Int i, Renderer &r);
    Void            DrawClusters(Renderer &r);
    Void            DrawVertices(Renderer &r);

    Vector          FaceAreaNormal(Int faceIdx);
    Int             ReorderLeafClusters(Int ic, FaceIdxArray &newFaces);
    Void            CropClusters(Int numClusters);
    Void            CreateClusterColours();
    Void            DumpFCH(StrConst filename);
    Void            UpdateBounds(Point &min, Point &max,
                               const Transform &t);
    
    Void            AddContraction(
                            Int         child0,
                            Int         child1,
                            Int         face1,
                            Int         face2,
                            GCLReal     error,
                            const Point &p,
                            Int         delta
                        );
                        
    Void            AddCluster(
                            Int         child0,
                            Int         child1,
                            Point       &centre,
                            VecTrans    &axis,
                            Vector      &fitNormal,
                            GCLReal     d,
                            Point       &clusMin,
                            Point       &clusMax,
                            Int         clusID
                        );

// basic model
    PointList       *points;        
    ColourList      *colours;       
    Colour          colour;         
    FaceIdxArray    faces;          

// vertex-contraction stuff
    Int             currentFaces;   
    IndexList       rootVertices;   
    MRVertexes      vertices;       
    MRCodesList     vtxCodes;       
    MRFlagsList     vtxFlags;       
    FaceIdxArray    vtxFaces;       
    Bool            verticesPrepped;

// face cluster stuff
    Int             currentClusters;
    Bool            clustersPrepped;
    IndexList       rootClusters;   
    FaceClusList    clusters;       
    ActList         clustersActive; 
    ColourList      clusterColours; 
    NormalList      faceNormals;    
    Int             firstClusterID; 
    Int             lastClusterID;  
    
    Bool            IsFace(Int i)
                    { return(i < faces.NumItems()); };
    FaceCluster     &Cluster(Int i)
                    { return(clusters[firstClusterID - i]); };

    Bool            showMeta;       
    Bool            showFaces;      
    Bool            colourFaces;    

    FileName        modelFile;      

    Flags32         flags;          
    GCLReal         lastComplexity; 
    static Bool     sAvgClusColours;
};


// --- Integration into GCL scenes ---------------------------------------------

#include "gcl/SceneObjects.h"

class scMRModel : public scPrimitive
{
public:

    scMRModel();

    Void            Draw(Renderer &r, SLContext *context);
    StrConst        Label() const
                    { return "MR Model"; };

    Object          *Clone() const
                    { return new scMRModel(*this); };

    Void            DecimateSelf(Decimator &dec);
    Void            UpdateBounds(Point &min, Point &max,
                               const Transform &t);

    MRModel         model;

    static Void     SetComplexity(GCLReal comp);
    static GCLReal  GetComplexity();
    
protected:
    static GCLReal  complexity;
    GCLReal         currentComplexity;
};

class MRModelsFinder : public scSceneAction
{
public:
    Void                Start();
    Void                Primitive(scPrimitive *sp);

    PtrArray<MRModel>   models;

    Int                 NumModels() const
                        { return(models.NumItems()); }
    MRModel             *Model(Int i) const
                        { return(models[i]); }
};

// MRB stuff

enum MRB_Flags
{
    MRB_HasVH       = 0x0001,
    MRB_HasFH       = 0x0002,
    MRB_Float       = 0x0004,
    MRB_Ordered     = 0x0008,
    MRB_End
};

struct MRB_Header
{
    Int         version;
    Flags32     flags;
};

#endif

---