GU/GU_PrimMesh.h

Go to the documentation of this file.

/*
 * PROPRIETARY INFORMATION.  This software is proprietary to
 * Side Effects Software Inc., and is not to be reproduced,
 * transmitted, or disclosed in any way without written permission.
 *
 * Produced by:
 *      Dale Ducharme
 *      Side Effects Software Inc.
 *      20 Maud St.
 *      Toronto, Ontario,  M5V 2M5
 *      Canada
 *      416-366-4607
 *
 * NAME:        GU_PrimMesh.h (C++)
 *
 * COMMENTS:
 *      Header file for GU_PrimMesh.h class...
 * 
 */

#ifndef __GU_PrimMesh_h__
#define __GU_PrimMesh_h__

#include "GU_API.h"
#include <GEO/GEO_PrimMesh.h>
#include "GU_Detail.h"
#include "GU_Prim.h"

class GB_EdgeGroup;

/////////////////////////////////////////////////////////////
//                                                         //
// Class:     GU_PrimMesh                                  //
// Descr:     This class is responsible for operations     //
//       done on mesh primitives.  As we need to access    //
//       the GU_Detail, the pointer is passed in the       //
//       constructor.  The second constructor creates a    //
//       mesh with the given parameters.                   //
//                                                         //
/////////////////////////////////////////////////////////////

class GU_API GU_PrimMesh : public GEO_PrimMesh, public GU_Primitive
{
public:
    // This constructor creates a new GU_PrimMesh but does
    // not append it to the detail
     GU_PrimMesh(GU_Detail *gdp) : GEO_PrimMesh(gdp), GU_Primitive() 
     { }

    ~GU_PrimMesh();

    // Conversion Method 

     GEO_Primitive      *convert(GU_ConvertParms &parms, 
                                GB_PointGroup *usedpts = 0);
     GEO_Primitive      *convertNew(GU_ConvertParms &parms);

    // Cut a wedge of the primitive given a domain range
    // ind1 and ind2 are indices to the refined values
    // They are updated if negative on input, else used as is.
    // If keep is zero the curve is only refined and the indices
    // updated.

    GU_PrimMesh         *cutU(float u1, float u2, 
                              int &ind1, int &ind2, int keep);
    GU_PrimMesh         *cutV(float v1, float v2, 
                              int &ind1, int &ind2, int keep);

    // Open the primitive at the given domain value
    void                 openAtU(float u);
    void                 openAtV(float v);

     // remove a single curve in the domain of the hull
    GEO_PrimPoly        *extractU(float unitu, GU_Detail *parent = 0);
    GEO_PrimPoly        *extractV(float unitV, GU_Detail *parent = 0);

     // This is more powerful than convertNew. It always returns a NEW
     // object, so free it when you're done with it. It may return a mesh,
     // a NURB surface or a Bezier surface depending on the type.
     GEO_Hull           *reconfigure(unsigned type, int orderu, int orderv,
                                     int openu, int openv) const;

     void              *castTo() const;

     virtual void       normal(int noff) const;
     virtual void       normal(UT_Vector3Array &output) const;
     virtual int        intersectRay(const UT_Vector3 &o, const UT_Vector3 &d,
                                     float tmax = 1E17F, float tol = 1E-12F,
                                     float *distance = 0, UT_Vector3 *pos = 0,
                                     UT_Vector3 *nml = 0, int accurate = 0,
                                     float *u = 0, float *v = 0,
                                     int ignoretrim = 1) const;


    // NOTE:  For static member functions please call in the following
    //        manner.  <ptrvalue> = GU_PrimMesh::<functname>
    //        i.e.        meshptr = GU_PrimMesh::build(params...);

    // Optional Build Method 

     static GU_PrimMesh *build( GU_Detail *gudp, 
                                int rows, int cols,
                                GEO_SurfaceType type = GEO_PATCH_QUADS,
                                int wrapu = 0, int wrapv = 0,
                                int appendPoints=1);

    // Remove as many of the given edges of possible from this poly.
    // If edge #a is removed, bit a in the bit array is set to a & 1.
    // returns 0 if successful, -1 if the poly becomes degenerate, and
    // -2 if the poly should be removed.
    int          removeEdges(const GB_EdgeGroup &edges,
                             UT_BitArray *remove_edges=0);
    // Persistent is true if the returned cache is not to be deleted by
    // the caller.
    virtual GU_RayIntersect     *createRayCache(int &persistent);

    virtual const GEO_Primitive *castToGeo(void) const;

    virtual GU_DisplayMesh      *getDisplayMesh(int noff, float lod);

protected:
    virtual GEO_Hull    *getSubHull(int top, int left, int bottom, int right,
                                    GEO_SubHullFlags break_flags);

private:
    // Recursively break the mesh using the edge-deletion matricies.
    // used by removeEdges

    int                  create(int rows, int cols,
                                GEO_SurfaceType type = GEO_PATCH_QUADS, 
                                int wrapu = 0, int wrapv = 0,
                                int appendPoints = 1);

    void                 computeVertices(GEO_Hull &hull, int, int) const;

    GEO_Primitive       *doConversion(GU_ConvertParms &parms, int reusePoints);

};

#endif

---