GU/GU_Measure.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:
 *      Mark Elendt
 *      Side Effects Software Inc
 *      477 Richmond Street West
 *      Toronto, Ontario
 *      Canada   M5V 3E7
 *      416-504-9876
 *
 * NAME:        GU_Measure.h ( GU Library, C++)
 *
 * COMMENTS:    Compute some measurements on geometry.
 */

#ifndef __GU_Measure__
#define __GU_Measure__

#include "GU_API.h"
#include <UT/UT_Vector3.h>
#include <SYS/SYS_Types.h>

class GU_Detail;
class GB_PointGroup;
class GB_PrimitiveGroup;
class GEO_AttributeHandle;

class GU_API GU_Measure {
public:
    //! Measure the perimeter of primitives
    /// The perimeter of each primitive will be computed and stored in the
    /// attribute handle passed in.  The attribute handle MUST point to a
    /// primitive attribute.
    static void computePerimeter(GU_Detail &gdp,
                                GEO_AttributeHandle &perimeter,
                                const GB_PrimitiveGroup *group);

    //! Measure the area of primitives
    /// The area of each primitive will be computed and stored in the
    /// attribute handle passed in.  The attribute handle MUST point to a
    /// primitive attribute.
    static void computeArea(GU_Detail &gdp,
                                GEO_AttributeHandle &area,
                                const GB_PrimitiveGroup *group);

    //! Measure the curvature of points
    /// The curvature of each point will be computed and stored in the
    /// attribute handle passed in.  The normal attribute handle should point
    /// to an attribute containing the normal for each point (which does not
    /// have to be normalized).  This is used in the curvature computations.
    /// The curvature computed is an approximation which is more accurate for
    /// polygon meshes.  No special code is used to compute curvature on higher
    /// order surfaces.
    static void computeCurvature(GU_Detail &gdp,
                                 GEO_AttributeHandle &curvature,
                                 GEO_AttributeHandle &normal,
                                 const GB_PointGroup *pgroup,
                                 fpreal min, fpreal max);

    static void computeVolume(GU_Detail &gdp,
                                UT_Vector3 &refpt,
                                GEO_AttributeHandle &volume,
                                const GB_PrimitiveGroup *group);
};

#endif

---