IMesh.h

Go to the documentation of this file.

/********************************************************************
*
*   Project     Artec 3D Scanning SDK
*
*   Purpose:    3D mesh interface implementation - geometry only.
*
*   Copyright:  Artec Group
*
********************************************************************/

#ifndef _IMESH_H_
#define _IMESH_H_

#include <artec/sdk/base/IBlob.h>
#include <artec/sdk/base/IArray.h>
#include <artec/sdk/base/IRevision.h>
#include <artec/sdk/base/MeshFlags.h>

namespace artec { namespace sdk { namespace base
{
    
class IImage;

class IMesh : public IRevision
{
public: 
    /// Data access functions
    virtual IArrayPoint3F* getPoints() const = 0;
    virtual void setPoints(IArrayPoint3F* points) = 0;

    virtual IArrayIndexTriplet* getTriangles() const = 0;
    virtual void setTriangles(IArrayIndexTriplet* triangles) = 0;

    virtual IArrayPoint3F* getPointsNormals() const = 0;
    virtual void setPointsNormals(IArrayPoint3F* normals) = 0;

    virtual IArrayPoint3F* getTrianglesNormals() const = 0;
    virtual void setTrianglesNormals(IArrayPoint3F* normals) = 0;

    /// Return points coordinates for i'th triangle
    virtual Triangle getTriangle(int i) const = 0;

    /// Create calculated data
    virtual unsigned int calculate(unsigned int requested_mode, unsigned int recreate_mode = CM_None) = 0;
    virtual unsigned int getCalculated() = 0;

    /**
    *   Clear unneeded data from mesh. Will not cause dependent data to be cleared.
    *   @param requested_mode - request to clear information. Modes can be combined
    */
    virtual void clear(int requested_mode = CM_ClearEverything) = 0;

    /// Full transformation (motion - scale)
    virtual void transform(const Matrix4x4D& matrix) = 0;

    /// Translation
    virtual void translate(const Point3F & direction) = 0;

    /// Rotation
    virtual void rotate(const Matrix4x4D& matrix) = 0;

    /// Scale
    virtual void scale(float factor) = 0;
    virtual void scale(float factor, const Point3F & center) = 0;

    /// Calculated data access functions
    virtual const IArrayPoint3F* getTrianglesCenters() const = 0;
    virtual const IArrayPoint3F* getTrianglesAngles() const = 0;
    virtual const IArrayFloat*   getTrianglesAreas() const = 0;
    virtual const IArrayPoint3F* getEdgeLengths() const = 0;

    /// Check if mesh empty
    virtual bool isEmpty() const = 0;

    /// @name Check calculated data existence
    ///@{
    virtual bool hasNormals() const = 0;
    virtual bool hasPointsNormals() const = 0;
    virtual bool hasTrianglesNormals() const = 0;

    virtual bool hasTrianglesCenters() const = 0;
    virtual bool hasTrianglesAngles() const = 0;
    virtual bool hasTrianglesAreas() const = 0;
    virtual bool hasEdgeLengths() const = 0;
    ///@}

    /// set/get some internal data for compatibility with existing code
    virtual void  setInternalData(void* p) = 0;
    virtual void* getInternalData() const = 0;
};

} } } // namespace artec::sdk::base

#endif // _IMESH_H_