gzParametric.h

Go to the documentation of this file.

//*****************************************************************************
// File         : gzParametric.h
// Module       : 
// Description  : Class definition of parametric geometry classes
// Author       : Anders Modén      
// Product      : Gizmo3D 2.1.1
//      
// Copyright © 2003- Saab Training Systems AB, Sweden   
//          
// NOTE:    Gizmo3D is a high performance 3D Scene Graph and effect visualisation 
//          C++ toolkit for Linux, Mac OS X, Windows (Win32) and IRIX® for  
//          usage in Game or VisSim development.
//
//
// Revision History...                          
//                                  
// Who  Date    Description                     
//                                  
// AMO  981122  Created file    
//
//******************************************************************************
#ifndef __GZ_PARAMETRIC_H__
#define __GZ_PARAMETRIC_H__

// The gzParametricGeometry implements a general purpose LOD function named
// IRMA (Improved ROAM Algorithm (C) 1999 Anders Modén)

#include "gzGeometry.h"

class gzParametricGeometry;

// ------------ Special constants ----------------------------------------------

const gzFloat I_127 = GZ_FLOAT_ONE/127.0f;

const gzFloat I_127_2=I_127*I_127;

// Forward declarations
class gzLODContainerItem;
class gzLODContainer;
class gzParametricGeometry;

//******************************************************************************
// Class    : gzLODItem
//                                  
// Purpose  : Private structure for automatic LOD calcs
//                                  
// Notes    : - 
//                                  
// Revision History...                          
//                                  
// Who  Date    Description                     
//                                  
// AMO  991020  Created 
//                                  
//******************************************************************************
class gzLODItem 
{
private:
    friend class gzLODContainerItem;
    friend class gzLODContainer;
    friend class gzParametricGeometry;

    gzByte      n_x,n_y,n_z;
    gzBool      renderChildren;
    gzFloat     diff2;
    gzUShort    counter;

    gzBool GZ_FASTCALL isLODVisible(gzParametricGeometry *geom,gzLODContainerItem *item);

};


class gzLODSize 
{
public:
    gzFloat     diff2;
    gzByte      n_x,n_y,n_z;
};

//******************************************************************************
// Class    : gzLODContainerItem
//                                  
// Purpose  : Private structure for automatic LOD calcs
//                                  
// Notes    : - 
//                                  
// Revision History...                          
//                                  
// Who  Date    Description                     
//                                  
// AMO  000223  Created 
//                                  
//******************************************************************************
class gzLODContainerItem
{
private:

    friend class gzLODContainer;
    friend class gzParametricGeometry;
    friend class gzLODItem;

    gzLODContainerItem *leftChild,*rightChild;
    gzLODContainerItem * split;
    gzLODContainerItem * parent;
    
    gzULong     v0_s;
    gzULong     v0_t;
    gzULong     index_0;

    gzULong     v1_s;
    gzULong     v1_t;
    gzULong     index_1;

    gzULong     va_s;
    gzULong     va_t;
    gzULong     index_a;

    gzULong     vc_s;
    gzULong     vc_t;
    gzULong     index_c;

    gzULong     index;

    gzBool checkSplit(gzParametricGeometry *geom);

    gzVec3      calculateCenterDiff(gzParametricGeometry *geom);
    gzLODSize   completeUnifyDynamicLOD(gzParametricGeometry *geom);

    gzBool  updateIndex(gzParametricGeometry *geom);
    gzVoid  forceSplit(gzParametricGeometry *geom);
    gzVoid  updateSplit(gzParametricGeometry *geom);
    gzVoid  renderIndex(gzParametricGeometry *geom , gzUByte toggle=0);

    gzVoid  isectorIndex(gzParametricGeometry *geom,gzIntersectorAction *isector,gzContext *context);
};


//******************************************************************************
// Class    : gzLODContainer
//                                  
// Purpose  : Private structure for automatic LOD calcs
//                                  
// Notes    : - 
//                                  
// Revision History...                          
//                                  
// Who  Date    Description                     
//                                  
// AMO  000223  Created 
//                                  
//******************************************************************************
class gzLODContainer : public gzReference
{
public:
    
    gzLODContainer(gzULong s_index, gzULong t_index,gzULong max_t_index);
    virtual ~gzLODContainer();

private:

    friend class gzParametricGeometry;

    static gzLODContainer   *getLODContainer(gzULong s_index, gzULong t_index);

    gzLODContainerItem      *createLODItem(gzULong v0_s,gzULong v0_t,gzULong v1_s,gzULong v1_t,gzULong va_s,gzULong va_t,gzLODContainerItem *parent,gzULong max_t_index);

    gzVoid                  deleteLODItem(gzLODContainerItem *item);
    
    gzVoid                  createSplit(gzLODContainerItem *item);
    
    gzLODContainerItem      *findSplit(gzLODContainerItem *split,gzLODContainerItem *search);
    
    gzVoid                  updateMergeBoundary(gzParametricGeometry *geom);

    gzLODContainerItem                      *tree_a,*tree_b,*item;
    gzLODItem                               *lod_item;
    gzList<gzLODContainerItem>              boundaryTree;

    gzListIterator<gzLODContainerItem>      iterator;

    gzULong                     s_index_size;
    gzULong                     t_index_size;

    gzULong                     lod_index_size;
};


//******************************************************************************
// Class    : gzParametricGeometry
//                                  
// Purpose  : -
//                                  
// Notes    : Uses a improved ROAM algorithm for high performance LODs  
//                                  
// Revision History...                          
//                                  
// Who  Date    Description                     
//                                  
// AMO  990106  Created 
//                                  
//******************************************************************************
class gzParametricGeometry : public gzBaseGeometry
{
public:

    GZ_GRAPH_EXPORT gzParametricGeometry(const gzString & name=GZ_EMPTY_STRING);
    GZ_GRAPH_EXPORT virtual ~gzParametricGeometry(){};

    GZ_DECLARE_TYPE_INTERFACE_EXPORT(GZ_GRAPH_EXPORT);  // typed interface


    // ---------- Clone interface ---------------------------------------
    
    GZ_GRAPH_EXPORT virtual gzReference* clone() const=0;
    GZ_GRAPH_EXPORT virtual gzBool  useDeepCopy();
    
    // ---------- Geometry Interface ------------------------------------


    // ---------- Common graph functions --------------------------------

    GZ_GRAPH_EXPORT virtual gzVoid updateNode();

    // ---------- Action Interface --------------------------------------

    GZ_GRAPH_EXPORT virtual gzVoid preTraverseAction( gzTraverseAction *actionclass , gzContext *context);
    
    // ---------- gzParametricGeometry Interface ------------------------

    GZ_GRAPH_EXPORT gzVoid setStartParams(  gzDouble start_s ,  gzDouble start_t );

    GZ_GRAPH_EXPORT gzVoid setStopParams(   gzDouble stop_s ,   gzDouble stop_t );

    GZ_GRAPH_EXPORT gzVoid setStepParams(   gzDouble step_s ,   gzDouble step_t );

    GZ_GRAPH_EXPORT gzVoid setStepIndex( gzUShort count_s_index , gzUShort count_t_index );

    GZ_GRAPH_EXPORT gzVoid getStepIndex( gzUShort &count_s_index , gzUShort &count_t_index );

    GZ_GRAPH_EXPORT gzVoid setLODFactor( gzFloat factor );

    GZ_GRAPH_EXPORT gzVoid createDynamicLOD();

    GZ_GRAPH_EXPORT gzVoid deleteDynamicLOD();

    GZ_GRAPH_EXPORT gzVoid createPatch();

    GZ_GRAPH_EXPORT gzVoid useColor(gzBool on)          { m_useColor=on;}

    GZ_GRAPH_EXPORT gzVoid useTexture(gzBool on,gzULong unit=0)     { m_useTexture[unit]=on;}

    GZ_GRAPH_EXPORT gzVoid useNormal(gzBool on)         { m_useNormal=on;}

    GZ_GRAPH_EXPORT virtual gzVec3 getCoordinate(gzDouble s , gzDouble t);

    GZ_GRAPH_EXPORT virtual gzVec3 getNormal(gzDouble s , gzDouble t);

    GZ_GRAPH_EXPORT virtual gzVec4 getColor(gzDouble s , gzDouble t);

    GZ_GRAPH_EXPORT virtual gzVec2 getTexCoordinate(gzDouble s , gzDouble t , gzULong unit);

    GZ_GRAPH_EXPORT gzBool unifyDynamicLOD(gzParametricGeometry *geometry);

    GZ_GRAPH_EXPORT gzVoid  setTextureUnits( gzULong size=1 );
    GZ_GRAPH_EXPORT gzULong getTextureUnits();


    GZ_GRAPH_EXPORT gzArray<gzVec3> & getCoordinateArray();


    GZ_GRAPH_EXPORT gzFloat getPointSize();
    GZ_GRAPH_EXPORT gzVoid  setPointSize(gzFloat size);

    GZ_GRAPH_EXPORT gzFloat getLineWidth();
    GZ_GRAPH_EXPORT gzVoid  setLineWidth(gzFloat size);

    GZ_GRAPH_EXPORT gzVoid  setViewParams(gzFloat midTVal, gzFloat smallTVal );


protected:

    // common protected methods for IRMA (Improved ROAM Algorithm (C) 1999 Anders Modén)

    friend class gzLODContainerItem;
    friend class gzLODContainer;
    friend class gzLODItem;

    GZ_GRAPH_EXPORT gzVoid  outputIndex(gzULong index);
    GZ_GRAPH_EXPORT gzVoid  outputIndexSplit(gzLODContainerItem *item);
    GZ_GRAPH_EXPORT gzVoid  outputIndex(gzLODContainerItem *item);

    GZ_GRAPH_EXPORT gzVoid  isectorIndexSplit(gzLODContainerItem *item,gzIntersectorAction *isector,gzContext *context);
    GZ_GRAPH_EXPORT gzVoid  isectorIndex(gzLODContainerItem *item,gzIntersectorAction *isector,gzContext *context);

    GZ_GRAPH_EXPORT gzVoid  calculateMaxIndex();

    GZ_GRAPH_EXPORT gzVoid virtual calculateIntersections(gzIntersectorAction *isector , gzContext *context);

    // common data

    gzDouble    m_start_s       ,   m_start_t;
    gzDouble    m_stop_s        ,   m_stop_t;
    gzDouble    m_step_s        ,   m_step_t;
    gzUShort    m_max_index_s   ,   m_max_index_t;

    gzVec3      m_eye,m_geneye;
    
    gzArray<gzBool>             m_useTexture;
    gzBool                      m_useColor:1,m_useNormal:1;
    gzFloat                     m_pointSize;
    gzFloat                     m_lineWidth;

    // Geometry

    gzArray<gzVec3>             m_coordinates;
    gzArray<gzVec3>             m_normals;
    gzArray<gzVec4>             m_colors;
    gzArray< gzArray<gzVec2> >  m_tex_coordinates;

    // IRMA data

    gzFloat             m_LODfactor;
    gzArray<gzLODItem>  m_lodArray;
    gzLODItem           *m_lodAddress;
    gzVec3              *m_coordAddress;
    gzUShort            m_counter,m_lastCounter;

    gzFloat             m_midTVal,m_smallTVal;

    gzArray<gzULong>    m_indexArray;
    gzULong             *m_indexAdress;
    gzULong             m_indexCounter;

    gzRefPointer<gzLODContainer>    m_lodContainer;

};

//******************************************************************************
// Function : gzUnifyDynamicLOD
//                                  
// Purpose  : Unifies the LOD matrix contents so no cracks appears  
//                                  
// Params   : gzMatrix<gzParametricGeometry *> &matrix - matrix of pointers 
//                                      
// Result   : -
//                                      
// Notes    : -
//                              
// Revision History...                          
//                                  
// Who  Date    Description                     
//                                  
// AMO  010329  Created release 
//                                  
//******************************************************************************
gzVoid GZ_GRAPH_EXPORT gzUnifyDynamicLOD(gzMatrix<gzParametricGeometry *> &matrix);


#endif

---