MRMeshTrimWithPlane.h

Go to the documentation of this file.

#pragma once
 
#include "MRMeshFwd.h"
#include "MRPlane3.h"
#include <functional>
namespace MR
{
 
MRMESH_API FaceBitSet subdivideWithPlane( Mesh & mesh, const Plane3f & plane, FaceHashMap * new2Old = nullptr, float eps = 0, std::function<void(EdgeId, EdgeId, float )> onEdgeSplitCallback = nullptr );
 
[[deprecated]] MRMESH_API void trimWithPlane( Mesh& mesh, const Plane3f & plane,
    UndirectedEdgeBitSet * outCutEdges = nullptr, FaceHashMap * new2Old = nullptr, float eps = 0, std::function<void( EdgeId, EdgeId, float )> onEdgeSplitCallback = nullptr );
 
[[deprecated]] MRMESH_API void trimWithPlane( Mesh& mesh, const Plane3f & plane,
    std::vector<EdgeLoop> * outCutContours, FaceHashMap * new2Old = nullptr, float eps = 0, std::function<void( EdgeId, EdgeId, float )> onEdgeSplitCallback = nullptr );
 
// stores basic params for trimWithPlane function
struct TrimWithPlaneParams
{
    //Input plane to cut mesh with
    Plane3f plane;
    // if existing vertex is within eps distance from the plane, then move the vertex not introducing new ones
    float eps = 0;
    // is invoked each time when an edge is split. Receives edge ID before split, edge ID after split, and weight of the origin vertex
    std::function<void( EdgeId, EdgeId, float )> onEdgeSplitCallback;
};
 
// stores optional output params for trimWithPlane function
struct TrimOptionalOutput
{
    // newly appeared hole boundary edges
    UndirectedEdgeBitSet* outCutEdges = nullptr;
    // newly appeared hole contours where each edge does not have right face
    std::vector<EdgeLoop>* outCutContours = nullptr;
    // mapping from newly appeared triangle to its original triangle (part to full)
    FaceHashMap* new2Old = nullptr;
    // left part of the trimmed mesh
    Mesh* otherPart = nullptr;
    // mapping from newly appeared triangle to its original triangle (part to full) in otherPart
    FaceHashMap* otherNew2Old = nullptr;
    // newly appeared hole contours where each edge does not have right face in otherPart
    std::vector<EdgeLoop>* otherOutCutContours = nullptr;
};
 
MRMESH_API void trimWithPlane( Mesh& mesh, const TrimWithPlaneParams& params, const TrimOptionalOutput& optOut = {} );
 
} //namespace MR