MRPolylineProject.h

Go to the documentation of this file.

#pragma once
#include "MRId.h"
#include "MRVector3.h"
#include <cfloat>
#include <functional>
 
namespace MR
{
 
 
template<typename V>
struct PolylineProjectionResult
{
    UndirectedEdgeId line;
 
    V point;
 
    float distSq = 0;
 
    [[nodiscard]] bool valid() const { return line.valid(); }
    [[nodiscard]] explicit operator bool() const { return line.valid(); }
};
 
MRMESH_API PolylineProjectionResult2 findProjectionOnPolyline2( const Vector2f& pt, const Polyline2& polyline,
    float upDistLimitSq = FLT_MAX, AffineXf2f* xf = nullptr, float loDistLimitSq = 0 );
 
MRMESH_API PolylineProjectionResult3 findProjectionOnPolyline( const Vector3f& pt, const Polyline3& polyline,
    float upDistLimitSq = FLT_MAX, AffineXf3f* xf = nullptr, float loDistLimitSq = 0 );
 
struct PolylineProjectionResult3Arg : PolylineProjectionResult3
{
    VertId pointId; // id of source point from which closest point was searched
};
 
MRMESH_API PolylineProjectionResult3Arg findMaxProjectionOnPolyline( const VertCoords& points, const Polyline3& polyline,
    const VertBitSet* pointsRegion = nullptr, AffineXf3f* xf = nullptr, float loDistLimitSq = 0 );
 
 
MRMESH_API PolylineProjectionResult3 findProjectionOnPolyline( const Line3f& ln, const Polyline3& polyline,
    float upDistLimitSq = FLT_MAX, AffineXf3f* xf = nullptr, float loDistLimitSq = 0 );
 
template<typename V>
struct PolylineProjectionWithOffsetResult
{
    UndirectedEdgeId line;
    V point;
    float dist = 0;
};
 
MRMESH_API Polyline2ProjectionWithOffsetResult findProjectionOnPolyline2WithOffset( const Vector2f& pt, const Polyline2& polyline,
    const Vector<float, UndirectedEdgeId>& offsetPerEdge, float upDistLimit = FLT_MAX, AffineXf2f* xf = nullptr, float loDistLimit = 0 );
 
MRMESH_API PolylineProjectionWithOffsetResult3 findProjectionOnPolylineWithOffset( const Vector3f& pt, const Polyline3& polyline,
    const Vector<float, UndirectedEdgeId>& offsetPerEdge, float upDistLimit = FLT_MAX, AffineXf3f* xf = nullptr, float loDistLimit = 0 );
 
template<typename V>
using FoundEdgeCallback = std::function<void( UndirectedEdgeId, const V& closestPt, float distSq )>;
using FoundEdgeCallback2 = FoundEdgeCallback<Vector2f>;
using FoundEdgeCallback3 = FoundEdgeCallback<Vector3f>;
 
MRMESH_API void findEdgesInBall( const Polyline2& polyline, const Vector2f& center, float radius, const FoundEdgeCallback2& foundCallback, AffineXf2f* xf = nullptr );
 
MRMESH_API void findEdgesInBall( const Polyline3& polyline, const Vector3f& center, float radius, const FoundEdgeCallback3& foundCallback, AffineXf3f* xf = nullptr );
 
MRMESH_API void findMeshEdgesInBall( const Mesh& mesh, const AABBTreePolyline3& tree, const Vector3f& center, float radius, const FoundEdgeCallback3& foundCallback, AffineXf3f* xf = nullptr );
 
MRMESH_API PolylineProjectionResult3 findProjectionOnMeshEdges( const Vector3f& pt, const Mesh& mesh, const AABBTreePolyline3& tree,
    float upDistLimitSq = FLT_MAX, AffineXf3f* xf = nullptr, float loDistLimitSq = 0 );
 
MRMESH_API PolylineProjectionResult3 findProjectionOnMeshEdges( const Line3f& ln, const Mesh& mesh, const AABBTreePolyline3& tree,
    float upDistLimitSq = FLT_MAX, AffineXf3f* xf = nullptr, float loDistLimitSq = 0 );
 
 
} // namespace MR