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 stitchHoles( Mesh& mesh, EdgeId a, EdgeId b, const StitchHolesParams& params = {} );
[[deprecated( "Use stitchHoles( mesh, a, b, params )" )]]
MRMESH_API void buildCylinderBetweenTwoHoles( Mesh & mesh, EdgeId a, EdgeId b, const StitchHolesParams& params = {} );

MRMESH_API bool stitchHoles( Mesh& mesh, const StitchHolesParams& params = {} );
[[deprecated( "Use stitchHoles( mesh, 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
{
    int edgeCode1, edgeCode2;
};

struct HoleFillPlan
{
    std::vector<FillHoleItem> items;
    int numTris = 0; 
};

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 );

 
}