MRPolyline.h

Go to the documentation of this file.

#pragma once
 
#include <MRCMesh/MRBox.h>
#include <MRCMesh/MRId.h>
#include <MRCMesh/MRVector2.h>
#include <MRCMesh/MRVector3.h>
#include <MRCMisc/common.h>
#include <MRCMisc/exports.h>
 
#include <stdbool.h>
#include <stddef.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
typedef struct MR_AABBTreePolyline2 MR_AABBTreePolyline2; // Defined in `#include <MRCMesh/MRAABBTreePolyline.h>`.
typedef struct MR_AABBTreePolyline3 MR_AABBTreePolyline3; // Defined in `#include <MRCMesh/MRAABBTreePolyline.h>`.
typedef struct MR_AffineXf2f MR_AffineXf2f; // Defined in `#include <MRCMesh/MRAffineXf.h>`.
typedef struct MR_AffineXf3f MR_AffineXf3f; // Defined in `#include <MRCMesh/MRAffineXf.h>`.
typedef struct MR_EdgeMap MR_EdgeMap; // Defined in `#include <MRCMesh/MRVector.h>`.
typedef struct MR_EdgePoint MR_EdgePoint; // Defined in `#include <MRCMesh/MREdgePoint.h>`.
typedef struct MR_LineSegm2f MR_LineSegm2f; // Defined in `#include <MRCMesh/MRLineSegm.h>`.
typedef struct MR_LineSegm3f MR_LineSegm3f; // Defined in `#include <MRCMesh/MRLineSegm.h>`.
typedef struct MR_Mesh MR_Mesh; // Defined in `#include <MRCMesh/MRMesh.h>`.
typedef struct MR_MeshTriPoint MR_MeshTriPoint; // Defined in `#include <MRCMesh/MRMeshTriPoint.h>`.
typedef struct MR_PolylineTopology MR_PolylineTopology; // Defined in `#include <MRCMesh/MRPolylineTopology.h>`.
typedef struct MR_UndirectedEdgeBitSet MR_UndirectedEdgeBitSet; // Defined in `#include <MRCMesh/MRBitSet.h>`.
typedef struct MR_VertCoords MR_VertCoords; // Defined in `#include <MRCMesh/MRVector.h>`.
typedef struct MR_VertCoords2 MR_VertCoords2; // Defined in `#include <MRCMesh/MRVector.h>`.
typedef struct MR_VertMap MR_VertMap; // Defined in `#include <MRCMesh/MRVector.h>`.
typedef struct MR_WholeEdgeMap MR_WholeEdgeMap; // Defined in `#include <MRCMesh/MRVector.h>`.
typedef struct MR_std_vector_MR_EdgeId MR_std_vector_MR_EdgeId; // Defined in `#include <MRCMisc/std_vector_MR_EdgeId.h>`.
typedef struct MR_std_vector_MR_EdgePoint MR_std_vector_MR_EdgePoint; // Defined in `#include <MRCMisc/std_vector_MR_EdgePoint.h>`.
typedef struct MR_std_vector_MR_Vector2f MR_std_vector_MR_Vector2f; // Defined in `#include <MRCMisc/std_vector_MR_Vector2f.h>`.
typedef struct MR_std_vector_MR_Vector3f MR_std_vector_MR_Vector3f; // Defined in `#include <MRCMisc/std_vector_MR_Vector3f.h>`.
typedef struct MR_std_vector_MR_VertId MR_std_vector_MR_VertId; // Defined in `#include <MRCMisc/std_vector_MR_VertId.h>`.
typedef struct MR_std_vector_std_vector_MR_Vector2f MR_std_vector_std_vector_MR_Vector2f; // Defined in `#include <MRCMisc/std_vector_std_vector_MR_Vector2f.h>`.
typedef struct MR_std_vector_std_vector_MR_Vector3f MR_std_vector_std_vector_MR_Vector3f; // Defined in `#include <MRCMisc/std_vector_std_vector_MR_Vector3f.h>`.
typedef struct MR_std_vector_std_vector_MR_VertId MR_std_vector_std_vector_MR_VertId; // Defined in `#include <MRCMisc/std_vector_std_vector_MR_VertId.h>`.
 

typedef struct MR_Polyline2 MR_Polyline2;

typedef struct MR_Polyline3 MR_Polyline3;

MRC_API const MR_PolylineTopology *MR_Polyline2_Get_topology(const MR_Polyline2 *_this);

MRC_API void MR_Polyline2_Set_topology(MR_Polyline2 *_this, MR_PassBy value_pass_by, MR_PolylineTopology *value);

MRC_API MR_PolylineTopology *MR_Polyline2_GetMutable_topology(MR_Polyline2 *_this);

MRC_API const MR_VertCoords2 *MR_Polyline2_Get_points(const MR_Polyline2 *_this);

MRC_API void MR_Polyline2_Set_points(MR_Polyline2 *_this, MR_PassBy value_pass_by, MR_VertCoords2 *value);

MRC_API MR_VertCoords2 *MR_Polyline2_GetMutable_points(MR_Polyline2 *_this);

MRC_API MR_Polyline2 *MR_Polyline2_DefaultConstruct(void);

MRC_API MR_Polyline2 *MR_Polyline2_DefaultConstructArray(size_t num_elems);

MRC_API const MR_Polyline2 *MR_Polyline2_OffsetPtr(const MR_Polyline2 *ptr, ptrdiff_t i);

MRC_API MR_Polyline2 *MR_Polyline2_OffsetMutablePtr(MR_Polyline2 *ptr, ptrdiff_t i);

MRC_API MR_Polyline2 *MR_Polyline2_ConstructFromAnother(MR_PassBy _other_pass_by, MR_Polyline2 *_other);

MRC_API MR_Polyline2 *MR_Polyline2_Construct_1_std_vector_MR_Vector2f(const MR_std_vector_MR_Vector2f *contour);

MRC_API MR_Polyline2 *MR_Polyline2_Construct_1_std_vector_std_vector_MR_Vector2f(const MR_std_vector_std_vector_MR_Vector2f *contours);

MRC_API MR_Polyline2 *MR_Polyline2_Construct_2(const MR_std_vector_MR_VertId *comp2firstVert, MR_PassBy ps_pass_by, MR_VertCoords2 *ps);

MRC_API void MR_Polyline2_Destroy(const MR_Polyline2 *_this);

MRC_API void MR_Polyline2_DestroyArray(const MR_Polyline2 *_this);

MRC_API MR_Polyline2 *MR_Polyline2_AssignFromAnother(MR_Polyline2 *_this, MR_PassBy _other_pass_by, MR_Polyline2 *_other);

MRC_API MR_EdgeId MR_Polyline2_addFromPoints_3(MR_Polyline2 *_this, const MR_Vector2f *vs, size_t num, bool closed);

MRC_API MR_EdgeId MR_Polyline2_addFromPoints_2(MR_Polyline2 *_this, const MR_Vector2f *vs, size_t num);

MRC_API void MR_Polyline2_addPart(MR_Polyline2 *_this, const MR_Polyline2 *from, MR_VertMap *outVmap, MR_WholeEdgeMap *outEmap);

MRC_API void MR_Polyline2_addPartByMask(MR_Polyline2 *_this, const MR_Polyline2 *from, const MR_UndirectedEdgeBitSet *mask, MR_VertMap *outVmap, MR_EdgeMap *outEmap);

MRC_API void MR_Polyline2_pack(MR_Polyline2 *_this, MR_VertMap *outVmap, MR_WholeEdgeMap *outEmap);

MRC_API MR_Vector2f MR_Polyline2_orgPnt(const MR_Polyline2 *_this, MR_EdgeId e);

MRC_API MR_Vector2f MR_Polyline2_destPnt(const MR_Polyline2 *_this, MR_EdgeId e);

MRC_API MR_Vector2f MR_Polyline2_edgePoint_2(const MR_Polyline2 *_this, MR_EdgeId e, float f);

MRC_API MR_Vector2f MR_Polyline2_edgePoint_1(const MR_Polyline2 *_this, const MR_EdgePoint *ep);

MRC_API MR_Vector2f MR_Polyline2_edgeCenter(const MR_Polyline2 *_this, MR_EdgeId e);

MRC_API MR_Vector2f MR_Polyline2_edgeVector(const MR_Polyline2 *_this, MR_EdgeId e);

MRC_API MR_LineSegm2f *MR_Polyline2_edgeSegment(const MR_Polyline2 *_this, MR_EdgeId e);

MRC_API MR_EdgePoint *MR_Polyline2_toEdgePoint_1(const MR_Polyline2 *_this, MR_VertId v);

MRC_API MR_EdgePoint *MR_Polyline2_toEdgePoint_2(const MR_Polyline2 *_this, MR_EdgeId e, const MR_Vector2f *p);

MRC_API float MR_Polyline2_edgeLength(const MR_Polyline2 *_this, MR_EdgeId e);

MRC_API float MR_Polyline2_edgeLengthSq(const MR_Polyline2 *_this, MR_EdgeId e);

MRC_API MR_Vector3f MR_Polyline2_loopDirArea(const MR_Polyline2 *_this, MR_EdgeId e);

MRC_API float MR_Polyline2_totalLength(const MR_Polyline2 *_this);

MRC_API float MR_Polyline2_averageEdgeLength(const MR_Polyline2 *_this);

MRC_API const MR_AABBTreePolyline2 *MR_Polyline2_getAABBTree(const MR_Polyline2 *_this);

MRC_API const MR_AABBTreePolyline2 *MR_Polyline2_getAABBTreeNotCreate(const MR_Polyline2 *_this);

MRC_API MR_Box2f MR_Polyline2_getBoundingBox(const MR_Polyline2 *_this);

MRC_API MR_Box2f MR_Polyline2_computeBoundingBox(const MR_Polyline2 *_this, const MR_AffineXf2f *toWorld);
 
// computes average position of all valid polyline vertices
MRC_API MR_Vector2f MR_Polyline2_findCenterFromPoints(const MR_Polyline2 *_this);

MRC_API void MR_Polyline2_transform(MR_Polyline2 *_this, const MR_AffineXf2f *xf);

MRC_API MR_EdgeId MR_Polyline2_splitEdge_2(MR_Polyline2 *_this, MR_EdgeId e, const MR_Vector2f *newVertPos);
 
// same, but split given edge on two equal parts
MRC_API MR_EdgeId MR_Polyline2_splitEdge_1(MR_Polyline2 *_this, MR_EdgeId e);

MRC_API void MR_Polyline2_invalidateCaches(MR_Polyline2 *_this);

MRC_API MR_std_vector_std_vector_MR_Vector2f *MR_Polyline2_contours(const MR_Polyline2 *_this, MR_std_vector_std_vector_MR_VertId *vertMap);

MRC_API MR_EdgeId MR_Polyline2_addFromEdgePath(MR_Polyline2 *_this, const MR_Mesh *mesh, const MR_std_vector_MR_EdgeId *path);

MRC_API MR_EdgeId MR_Polyline2_addFromSurfacePath(MR_Polyline2 *_this, const MR_Mesh *mesh, const MR_std_vector_MR_EdgePoint *path);

MRC_API MR_EdgeId MR_Polyline2_addFromGeneralSurfacePath(MR_Polyline2 *_this, const MR_Mesh *mesh, const MR_MeshTriPoint *start, const MR_std_vector_MR_EdgePoint *path, const MR_MeshTriPoint *end);

MRC_API size_t MR_Polyline2_heapBytes(const MR_Polyline2 *_this);

MRC_API const MR_PolylineTopology *MR_Polyline3_Get_topology(const MR_Polyline3 *_this);

MRC_API void MR_Polyline3_Set_topology(MR_Polyline3 *_this, MR_PassBy value_pass_by, MR_PolylineTopology *value);

MRC_API MR_PolylineTopology *MR_Polyline3_GetMutable_topology(MR_Polyline3 *_this);

MRC_API const MR_VertCoords *MR_Polyline3_Get_points(const MR_Polyline3 *_this);

MRC_API void MR_Polyline3_Set_points(MR_Polyline3 *_this, MR_PassBy value_pass_by, MR_VertCoords *value);

MRC_API MR_VertCoords *MR_Polyline3_GetMutable_points(MR_Polyline3 *_this);

MRC_API MR_Polyline3 *MR_Polyline3_DefaultConstruct(void);

MRC_API MR_Polyline3 *MR_Polyline3_DefaultConstructArray(size_t num_elems);

MRC_API const MR_Polyline3 *MR_Polyline3_OffsetPtr(const MR_Polyline3 *ptr, ptrdiff_t i);

MRC_API MR_Polyline3 *MR_Polyline3_OffsetMutablePtr(MR_Polyline3 *ptr, ptrdiff_t i);

MRC_API MR_Polyline3 *MR_Polyline3_ConstructFromAnother(MR_PassBy _other_pass_by, MR_Polyline3 *_other);

MRC_API MR_Polyline3 *MR_Polyline3_Construct_1_std_vector_MR_Vector3f(const MR_std_vector_MR_Vector3f *contour);

MRC_API MR_Polyline3 *MR_Polyline3_Construct_1_std_vector_std_vector_MR_Vector3f(const MR_std_vector_std_vector_MR_Vector3f *contours);

MRC_API MR_Polyline3 *MR_Polyline3_Construct_2(const MR_std_vector_MR_VertId *comp2firstVert, MR_PassBy ps_pass_by, MR_VertCoords *ps);

MRC_API void MR_Polyline3_Destroy(const MR_Polyline3 *_this);

MRC_API void MR_Polyline3_DestroyArray(const MR_Polyline3 *_this);

MRC_API MR_Polyline3 *MR_Polyline3_AssignFromAnother(MR_Polyline3 *_this, MR_PassBy _other_pass_by, MR_Polyline3 *_other);

MRC_API MR_EdgeId MR_Polyline3_addFromPoints_3(MR_Polyline3 *_this, const MR_Vector3f *vs, size_t num, bool closed);

MRC_API MR_EdgeId MR_Polyline3_addFromPoints_2(MR_Polyline3 *_this, const MR_Vector3f *vs, size_t num);

MRC_API void MR_Polyline3_addPart(MR_Polyline3 *_this, const MR_Polyline3 *from, MR_VertMap *outVmap, MR_WholeEdgeMap *outEmap);

MRC_API void MR_Polyline3_addPartByMask(MR_Polyline3 *_this, const MR_Polyline3 *from, const MR_UndirectedEdgeBitSet *mask, MR_VertMap *outVmap, MR_EdgeMap *outEmap);

MRC_API void MR_Polyline3_pack(MR_Polyline3 *_this, MR_VertMap *outVmap, MR_WholeEdgeMap *outEmap);

MRC_API MR_Vector3f MR_Polyline3_orgPnt(const MR_Polyline3 *_this, MR_EdgeId e);

MRC_API MR_Vector3f MR_Polyline3_destPnt(const MR_Polyline3 *_this, MR_EdgeId e);

MRC_API MR_Vector3f MR_Polyline3_edgePoint_2(const MR_Polyline3 *_this, MR_EdgeId e, float f);

MRC_API MR_Vector3f MR_Polyline3_edgePoint_1(const MR_Polyline3 *_this, const MR_EdgePoint *ep);

MRC_API MR_Vector3f MR_Polyline3_edgeCenter(const MR_Polyline3 *_this, MR_EdgeId e);

MRC_API MR_Vector3f MR_Polyline3_edgeVector(const MR_Polyline3 *_this, MR_EdgeId e);

MRC_API MR_LineSegm3f *MR_Polyline3_edgeSegment(const MR_Polyline3 *_this, MR_EdgeId e);

MRC_API MR_EdgePoint *MR_Polyline3_toEdgePoint_1(const MR_Polyline3 *_this, MR_VertId v);

MRC_API MR_EdgePoint *MR_Polyline3_toEdgePoint_2(const MR_Polyline3 *_this, MR_EdgeId e, const MR_Vector3f *p);

MRC_API float MR_Polyline3_edgeLength(const MR_Polyline3 *_this, MR_EdgeId e);

MRC_API float MR_Polyline3_edgeLengthSq(const MR_Polyline3 *_this, MR_EdgeId e);

MRC_API MR_Vector3f MR_Polyline3_loopDirArea(const MR_Polyline3 *_this, MR_EdgeId e);

MRC_API float MR_Polyline3_totalLength(const MR_Polyline3 *_this);

MRC_API float MR_Polyline3_averageEdgeLength(const MR_Polyline3 *_this);

MRC_API const MR_AABBTreePolyline3 *MR_Polyline3_getAABBTree(const MR_Polyline3 *_this);

MRC_API const MR_AABBTreePolyline3 *MR_Polyline3_getAABBTreeNotCreate(const MR_Polyline3 *_this);

MRC_API MR_Box3f MR_Polyline3_getBoundingBox(const MR_Polyline3 *_this);

MRC_API MR_Box3f MR_Polyline3_computeBoundingBox(const MR_Polyline3 *_this, const MR_AffineXf3f *toWorld);
 
// computes average position of all valid polyline vertices
MRC_API MR_Vector3f MR_Polyline3_findCenterFromPoints(const MR_Polyline3 *_this);

MRC_API void MR_Polyline3_transform(MR_Polyline3 *_this, const MR_AffineXf3f *xf);

MRC_API MR_EdgeId MR_Polyline3_splitEdge_2(MR_Polyline3 *_this, MR_EdgeId e, const MR_Vector3f *newVertPos);
 
// same, but split given edge on two equal parts
MRC_API MR_EdgeId MR_Polyline3_splitEdge_1(MR_Polyline3 *_this, MR_EdgeId e);

MRC_API void MR_Polyline3_invalidateCaches(MR_Polyline3 *_this);

MRC_API MR_std_vector_std_vector_MR_Vector3f *MR_Polyline3_contours(const MR_Polyline3 *_this, MR_std_vector_std_vector_MR_VertId *vertMap);

MRC_API MR_EdgeId MR_Polyline3_addFromEdgePath(MR_Polyline3 *_this, const MR_Mesh *mesh, const MR_std_vector_MR_EdgeId *path);

MRC_API MR_EdgeId MR_Polyline3_addFromSurfacePath(MR_Polyline3 *_this, const MR_Mesh *mesh, const MR_std_vector_MR_EdgePoint *path);

MRC_API MR_EdgeId MR_Polyline3_addFromGeneralSurfacePath(MR_Polyline3 *_this, const MR_Mesh *mesh, const MR_MeshTriPoint *start, const MR_std_vector_MR_EdgePoint *path, const MR_MeshTriPoint *end);

MRC_API size_t MR_Polyline3_heapBytes(const MR_Polyline3 *_this);
 
#ifdef __cplusplus
} // extern "C"
#endif