MRMesh/MRMeshFillHole.h

Go to the documentation of this file.

#pragma once
 
#include "MRMeshFwd.h"
#include "MRMeshMetrics.h"
#include "MRId.h"
#include <functional>
#include <memory>
 
namespace MR
{
 
struct FillHoleParams
{
    FillHoleMetric metric;
 
    bool smoothBd{ true };
 
    FaceBitSet* outNewFaces{ nullptr };
 
    enum class MultipleEdgesResolveMode
    {
        None,
        Simple,
        Strong
    } multipleEdgesResolveMode{ MultipleEdgesResolveMode::Simple };
 
    bool makeDegenerateBand{ false };
 
    int maxPolygonSubdivisions{ 20 };
 
    bool* stopBeforeBadTriangulation{ nullptr };
};
 
struct StitchHolesParams
{
    FillHoleMetric metric;
    FaceBitSet* outNewFaces{ nullptr };
};
 
MRMESH_API void buildCylinderBetweenTwoHoles( Mesh & mesh, EdgeId a, EdgeId b, const StitchHolesParams& params = {} );
 
MRMESH_API bool buildCylinderBetweenTwoHoles( Mesh & mesh, const StitchHolesParams& params = {} );
 
 
MRMESH_API void fillHole( Mesh& mesh, EdgeId a, const FillHoleParams& params = {} );
 
MRMESH_API void fillHoles( Mesh& mesh, const std::vector<EdgeId> & as, const FillHoleParams& params = {} );
 
[[nodiscard]] MRMESH_API bool isHoleBd( const MeshTopology & topology, const EdgeLoop & loop );
 
struct FillHoleItem
{
    // if not-negative number then it is edgeid;
    // otherwise it refers to the edge created recently
    int edgeCode1, edgeCode2;
};
 
struct HoleFillPlan
{
    std::vector<FillHoleItem> items;
    int numTris = 0; // the number of triangles in the filling
};
 
MRMESH_API HoleFillPlan getHoleFillPlan( const Mesh& mesh, EdgeId e, const FillHoleParams& params = {} );
 
MRMESH_API std::vector<HoleFillPlan> getHoleFillPlans( const Mesh& mesh, const std::vector<EdgeId>& holeRepresentativeEdges, const FillHoleParams& params = {} );
 
MRMESH_API HoleFillPlan getPlanarHoleFillPlan( const Mesh& mesh, EdgeId e );
 
MRMESH_API std::vector<HoleFillPlan> getPlanarHoleFillPlans( const Mesh& mesh, const std::vector<EdgeId>& holeRepresentativeEdges );
 
MRMESH_API void executeHoleFillPlan( Mesh & mesh, EdgeId a0, HoleFillPlan & plan, FaceBitSet * outNewFaces = nullptr );
 
MRMESH_API VertId fillHoleTrivially( Mesh& mesh, EdgeId a, FaceBitSet * outNewFaces = nullptr );
 
MRMESH_API EdgeId extendHole( Mesh& mesh, EdgeId a, const Plane3f & plane, FaceBitSet * outNewFaces = nullptr );
 
MRMESH_API std::vector<EdgeId> extendAllHoles( Mesh& mesh, const Plane3f & plane, FaceBitSet * outNewFaces = nullptr );
 
MRMESH_API EdgeId extendHole( Mesh& mesh, EdgeId a, std::function<Vector3f(const Vector3f &)> getVertPos, FaceBitSet * outNewFaces = nullptr );
 
MRMESH_API EdgeId buildBottom( Mesh& mesh, EdgeId a, Vector3f dir, float holeExtension, FaceBitSet* outNewFaces = nullptr );
 
MRMESH_API EdgeId makeDegenerateBandAroundHole( Mesh& mesh, EdgeId a, FaceBitSet * outNewFaces = nullptr );
 
struct MakeBridgeResult
{
    int newFaces = 0;
 
    EdgeId na, nb;
 
    explicit operator bool() const { return newFaces > 0; }
};
 
MRMESH_API MakeBridgeResult makeQuadBridge( MeshTopology & topology, EdgeId a, EdgeId b, FaceBitSet * outNewFaces = nullptr );
 
MRMESH_API MakeBridgeResult makeBridge( MeshTopology & topology, EdgeId a, EdgeId b, FaceBitSet * outNewFaces = nullptr );
 
MRMESH_API MakeBridgeResult makeSmoothBridge( Mesh & mesh, EdgeId a, EdgeId b, float samplingStep, FaceBitSet * outNewFaces = nullptr );
 
MRMESH_API EdgeId makeBridgeEdge( MeshTopology & topology, EdgeId a, EdgeId b );
 
MRMESH_API void splitQuad( MeshTopology & topology, EdgeId a, FaceBitSet * outNewFaces = nullptr );
 
 
} // namespace MR