GU/GU_PrimPasteDAG.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:
 *      Cristin Barghiel
 *      Side Effects Software Inc.
 *      477 Richmond Street West
 *      Toronto, Ontario  
 *      Canada   M5V 3E7
 *      416-504-9876      
 *
 * NAME:        GU_PrimPasteDAG.h (C++)
 *
 * COMMENTS:    Pasted surface class.
 * 
 */

#ifndef __GU_PrimPasteDAG_h__
#define __GU_PrimPasteDAG_h__

#include "GU_API.h"
#include <GEO/GEO_PrimPasteDAG.h>
#include "GU_Prim.h"

class GU_ConvertMethod;
class UT_Vector4Array;


class GU_API GU_PasteParms
{
public:
    GU_PasteParms()
    {
        method     = 0;
        up         = 0;
        trim       = 0; trimscale = 1;
        height     = 0;
        ubeltwidth = vbeltwidth = 0;
        keepshape  = 0;
    }

    int                 method;    // 0 = min distance projection
                                   // 1 = vector projection
                                   // 2 = parametric mapping
                                   // 3 = as is

    int                 up;        // paste up or down
    int                 trim;      // trim underlying base
    float               trimscale; // scale amount for trim curve
    float               height;    // paste at this elevation
    UT_Vector3          axis;      // proj. axis if projecting along vector     
    float               rtol;      // ray intersection tolerance
    int                 keepshape; // don't deform feature when pasting it

    float               umin;      // 0 <= umin <= 1
    float               umax;      // 0 <= umax <= 1
    float               vmin;      // 0 <= vmin <= 1
    float               vmax;      // 0 <= vmax <= 1

    float               ubeltwidth;
    float               vbeltwidth;
    int                 ubeltdivs;
    int                 vbeltdivs;
};

class GU_API GU_PrimPasteDAG : public GEO_PrimPasteDAG, public GU_Primitive 
{
public:
                 GU_PrimPasteDAG(GU_Detail *d);
    virtual     ~GU_PrimPasteDAG();

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

    // Optional Build Method. Returns 0 if it fails. 
    static GU_PrimPasteDAG      *build(GU_Detail *gudp, GEO_TPSurf &root,
                                       int chkpaste = 0);
    static GU_PrimPasteDAG      *build(GU_Detail *gudp, GEO_PasteSurf &root,
                                       int chkpaste = 0);

    // Conversion methods
    virtual GEO_Primitive       *convert(GU_ConvertParms &parms,
                                         GB_PointGroup *usedpts = 0);
    virtual GEO_Primitive       *convertNew(GU_ConvertParms &parms);

    virtual void                *castTo   (void) const;
    virtual const GEO_Primitive *castToGeo(void) const;

    virtual void         normal(int noff) const;
    virtual void         normal(UT_Vector3Array &output) const;

    // Intersect us with a ray and return 1 if we have a hit, else 0:
    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;

    // Find minimum distance to a point and return 1 if found. 0 otherwise:
    virtual int          minimum(const UT_Vector3 &p, float distmax = 1E17F,
                                 float *distance = 0, float *u = 0,
                                 float *v = 0, int accurate = 1);

    // Find minimum distance between two primitives and return 1 if found,
    // 0 otherwise. (u1,v1) is on us, (u2,v2) is on prim.
    virtual int          minimum(GU_Primitive &prim, float distmax = 1E17F,
                                 float *distance = 0, float *u1 = 0,
                                 float *v1 = 0, float *u2 = 0, float *v2 = 0,
                                 int accurate = 1);

    virtual GU_RayIntersect     *createRayCache(int &persistent);

    // Various pasting methods:
    GEO_PasteSurf       *paste  (GU_PrimPasteDAG &dag, const GU_PasteParms &);
    GEO_PasteSurf       *overlay(GEO_PasteSurf &child, GU_PrimPasteDAG &dag,
                                 const GU_PasteParms &parms, int at = 1);
    GEO_PasteSurf       *replace(GEO_PasteSurf &child, GU_PrimPasteDAG &dag,
                                 int at = 1, int up = 1, float height = 0.0f);
    GEO_PasteSurf       *spawn  (GEO_PasteSurf &child, const GU_PasteParms &);

                                 
protected:
    // Virtual (shallow) c-tor that can be used by classes derived
    // from us to instantiate themselves at this level:
    virtual GEO_PasteSurfDAG    *newDAGSpecies(void) const;

private:
    // Return 0 if OK, else -1.
    int                  evaluateSurface(GU_ConvertMethod &method,
                                         int featurecoord,
                                         UT_Vector4Array &pos,
                                         int &nu, int &nv) const;
    int                  evaluateSurface(GU_ConvertMethod &method,
                                         int featurecoord, int featureattrib,
                                         UT_Vector4Array &pos,
                                         GB_AttributeData *&adata, 
                                         int &vtxattr, int &nu, int &nv) const;
    // Return 0 if OK, else -1.
    int                  getUVInterval (const GEO_PasteSurf &surf,
                                        float &umin, float &vmin,
                                        float &umax, float &vmax) const;

    // Return 0 if OK, else -1.
    int                  getProjectionUV(const UT_Vector3 &axis, float tol,
                                         int vecproj, GU_PrimPasteDAG &dag,
                                         GP_Point &b1, GP_Point &b2,
                                         GP_Point &b3, GP_Point &b4);

    // b1..b4 are in the local frame the surface, but we need
    // them in world space:
    void                 toWorld(const GEO_PasteSurf &surf,
                                 GP_Point &b1, GP_Point &b2,
                                 GP_Point &b3, GP_Point &b4) const;
};

#endif

---