/* $NoKeywords: $ */ /* // // Copyright (c) 1993-2012 Robert McNeel & Associates. All rights reserved. // OpenNURBS, Rhinoceros, and Rhino3D are registered trademarks of Robert // McNeel & Associates. // // THIS SOFTWARE IS PROVIDED "AS IS" WITHOUT EXPRESS OR IMPLIED WARRANTY. // ALL IMPLIED WARRANTIES OF FITNESS FOR ANY PARTICULAR PURPOSE AND OF // MERCHANTABILITY ARE HEREBY DISCLAIMED. // // For complete openNURBS copyright information see . // //////////////////////////////////////////////////////////////// */ //////////////////////////////////////////////////////////////// // // Definition of b-rep and its parts // //////////////////////////////////////////////////////////////// #if !defined(OPENNURBS_BREP_INC_) #define OPENNURBS_BREP_INC_ class ON_BrepTrim; class ON_BrepEdge; class ON_BrepLoop; class ON_BrepFace; // TEMPORARY DEFINES SO I DON'T BREAK THE BUILD //#define m_vertex_user_i m_vertex_user.i //#define m_trim_user_i m_trim_user.i //#define m_edge_user_i m_edge_user.i //#define m_loop_user_i m_loop_user.i //#define m_face_user_i m_face_user.i // Description: // Brep vertex information is stored in ON_BrepVertex classes. // ON_Brep.m_V[] is an array of all the vertices in the brep. // // If a vertex is a point on a face, then brep.m_E[m_ei] // will be an edge with no 3d curve. This edge will have // a single trim with type ON_BrepTrim::ptonsrf. There // will be a loop containing this single trim. // Use ON_Brep::NewPointOnFace() to create vertices that are // points on faces. class ON_CLASS ON_BrepVertex : public ON_Point { ON_OBJECT_DECLARE(ON_BrepVertex); public: // Union available for application use. // The constructor zeros m_vertex_user. // The value is of m_vertex_user is not saved in 3DM // archives and may be changed by some computations. mutable ON_U m_vertex_user; public: mutable ON_ComponentStatus m_status = ON_ComponentStatus::NoneSet; private: ON__UINT16 m_reserved1 = 0U; public: // index of the vertex in the ON_Brep.m_V[] array int m_vertex_index = -1; ///////////////////////////////////////////////////////////////// // Construction // // In general, you should not directly create ON_BrepVertex classes. // Use ON_Brep::NewVertex instead. ON_BrepVertex(); ON_BrepVertex( int // vertex index ); ON_BrepVertex& operator=(const ON_BrepVertex&); // virtual ON_Object::SizeOf override unsigned int SizeOf() const override; // virtual ON_Object::DataCRC override ON__UINT32 DataCRC(ON__UINT32 current_remainder) const override; bool IsValid( class ON_TextLog* text_log = nullptr ) const override; // virtual ON_Object::Dump() override void Dump( ON_TextLog& ) const override; // for debugging // virtual ON_Object::Write() override bool Write( ON_BinaryArchive& ) const override; // virtual ON_Object::Read() override bool Read( ON_BinaryArchive& ) override; // virtual ON_Geometry::ComponentIndex() override ON_COMPONENT_INDEX ComponentIndex() const override; ///////////////////////////////////////////////////////////////// // Interface // Description: // Set vertex location. // Parameters: // point - [in] 3d vertex location bool SetPoint( const ON_3dPoint& // point ); // Returns: // Vertex location. ON_3dPoint Point() const; // Returns: // value of ON_BrepVertex::m_tolerance // Remarks: // Use ON_Brep::SetVertexTolerance( ON_BrepVertex& ) to set tolerances. double Tolerance() const; // Returns: // number of edges that begin or end at this vertex. int EdgeCount() const; ///////////////////////////////////////////////////////////////// // Implementation // indices of edges starting/ending at this vertex // // For closed edges, edge.m_vi[0] = edge.m_vi[1] and // edge.m_edge_index appears twice in the m_ei[] array. // The first occurrence of edge.m_edge_index in m_ei[] // is for the closed edge starting the vertex. // The second occurrence of edge,m_edge_index in m_ei[] // is for the closed edge ending at the vertex. // C.f. ON_Brep::Next/PrevEdge(). ON_SimpleArray m_ei; // accuracy of vertex point (>=0.0 or ON_UNSET_VALUE) // // A value of ON_UNSET_VALUE indicates that the // tolerance should be computed. // // A value of 0.0 indicates that the distance // from the vertex to any applicable edge or trim // end is <= ON_ZERO_TOLERANCE // // If an edge begins or ends at this vertex, // then the distance from the vertex's // 3d point to the appropriate end of the // edge's 3d curve must be <= this tolerance. // // If a trim begins or ends at this vertex, // then the distance from the vertex's 3d point // to the 3d point on the surface obtained by // evaluating the surface at the appropriate // end of the trimming curve must be <= this // tolerance. double m_tolerance = ON_UNSET_VALUE; private: ON_BrepVertex( const ON_BrepVertex& ) = delete; }; /* Description: Brep edge information is stored in ON_BrepEdge classes. ON_Brep.m_E[] is an array of all the edges in the brep. An ON_BrepEdge is derived from ON_CurveProxy so the the edge can supply easy to use evaluation tools via the ON_Curve virtual member functions. Note well that the domains and orientations of the curve m_C3[edge.m_c3i] and the edge as a curve may not agree. */ // April 24, 2017 Dale Lear // ON_Curve::Trim(const ON_Interval&) is a virtual function and ON_BrepEdge derives // from ON_CurveProxy which derives from ON_Curve. The ON_Brep::Trim(int) function was // added and mistakenly named "Trim". This all happened about twenty years ago. // // Both the virtual ON_Curve::Trim(const ON_Interval&) and ON_BrepEdge::Trim(int) functions // are widely used. At some point the functionON_Brep::Trim() will be deprecated and the 4263 // warning ON_Brep::Trim(int) generates will be disabled for the definition of class ON_BrepEdge. // In version 7, ON_Brep::Trim(int) will be deleted and the warning will no longer be disabled. #pragma ON_PRAGMA_WARNING_PUSH #pragma ON_PRAGMA_WARNING_DISABLE_MSC(4263) #pragma ON_PRAGMA_WARNING_DISABLE_MSC(4264) class ON_CLASS ON_BrepEdge : public ON_CurveProxy { ON_OBJECT_DECLARE(ON_BrepEdge); public: // Union available for application use. // The constructor zeros m_edge_user. // The value is of m_edge_user is not saved in 3DM // archives and may be changed by some computations. mutable ON_U m_edge_user; public: mutable ON_ComponentStatus m_status = ON_ComponentStatus::NoneSet; private: ON__UINT16 m_reserved1 = 0U; public: // index of edge in ON_Brep.m_E[] array int m_edge_index = -1; // virtual ON_Curve::IsClosed override bool IsClosed() const override; ///////////////////////////////////////////////////////////////// // Construction // // In general, you should not directly create ON_BrepEdge classes. // Use ON_Brep::NewVertex instead. ON_BrepEdge(); ON_BrepEdge(int); // edge index ON_BrepEdge& operator=(const ON_BrepEdge&); // virtual ON_Object function // The ON_BrepEdge override returns ON::curve_object. ON::object_type ObjectType() const override; /* Returns: Brep this edge belongs to. */ ON_Brep* Brep() const; /* Parameters: eti - [in] index into the edge's m_ti[] array. Returns: The trim brep.m_T[edge.m_ti[eti]]; Remarks: This version of "Trim" hides the virtual function ON_CurveProxy::Trim(const ON_Interval&), which is a good thing. Special care must be taken when changing the geometry of a brep edge to insure vertex, trim, and edge information remains valid. */ ON_BrepTrim* Trim( int eti ) const; /* Returns: Number of trims attached to this edge. */ int TrimCount() const; /* Parameters: evi - [in] 0 or 1 Returns: Brep vertex at specified end of the edge. */ ON_BrepVertex* Vertex(int evi) const; // virtual ON_Object::SizeOf override unsigned int SizeOf() const override; // virtual ON_Object::DataCRC override ON__UINT32 DataCRC(ON__UINT32 current_remainder) const override; bool IsValid( class ON_TextLog* text_log = nullptr ) const override; // virtual ON_Object::Dump() override void Dump( ON_TextLog& ) const override; // for debugging // virtual ON_Object::Write() override bool Write( ON_BinaryArchive& ) const override; // virtual ON_Object::Read() override bool Read( ON_BinaryArchive& ) override; // virtual ON_Geometry::ComponentIndex() override ON_COMPONENT_INDEX ComponentIndex() const override; // virtual ON_Curve::Reverse override bool Reverse() override; /* Not necessary. Base class does the right thing. ON_CurveProxy does not have an override. // virtual ON_Curve::SetStartPoint override bool SetStartPoint( ON_3dPoint start_point ); // virtual ON_Curve::SetEndPoint override bool SetEndPoint( ON_3dPoint end_point ); */ ///////////////////////////////////////////////////////////////// // Implementation /* Returns: brep.m_C3[] index of the 3d curve geometry used by this edge or -1. */ int EdgeCurveIndexOf() const; /* Returns: 3d curve geometry used by this edge or nullptr. */ const ON_Curve* EdgeCurveOf() const; /* Description: Expert user tool that replaces the 3d curve geometry of an edge Parameters; c3i - [in] brep 3d curve index of new curve Returns: True if successful. Example: ON_Curve* pCurve = ...; int c3i = brep.AddEdgeCurve(pCurve); edge.ChangeEdgeCurve(c3i); Remarks: Sets m_c3i, calls SetProxyCurve, cleans runtime caches. */ bool ChangeEdgeCurve( int c3i ); /* Description: When an edge is modified, the m_pline[].e values need to be set to ON_UNSET_VALUE by calling UnsetPlineEdgeParameters(). */ void UnsetPlineEdgeParameters(); // index of 3d curve in m_C3[] array // (edge.m_curve also points to m_C3[m_c3i]) int m_c3i = -1; // indices of starting/ending vertex // // For closed edges, m_vi[0] = m_vi[1] and m_edge_index // appears twice in the m_V[m_vi[0]].m_ei[] array. // The first occurrence of m_edge_index in m_V[m_vi[0]].m_ei[] // is for the closed edge starting the vertex. The second // occurrence of m_edge_index in m_V[m_vi[0]].m_ei[] // is for the closed edge edge ending at the vertex. // C.f. ON_Brep::Next/PrevEdge(). int m_vi[2]; // indices of Trims that use this edge ON_SimpleArray m_ti; // accuracy of edge curve (>=0.0 or ON_UNSET_VALUE) // // A value of ON_UNSET_VALUE indicates that the // tolerance should be computed. // // The maximum distance from the edge's 3d curve // to any surface of a face that has this edge as // a portion of its boundary must be <= this // tolerance. double m_tolerance = ON_UNSET_VALUE; private: friend class ON_Brep; ON_Brep* m_brep = nullptr; // so isolated edge class edge can get at it's 3d curve ON_BrepEdge( const ON_BrepEdge& ) = delete; }; #pragma ON_PRAGMA_WARNING_POP struct ON_BrepTrimPoint { ON_2dPoint p; // 2d surface parameter space point double t; // corresponding trim curve parameter double e; // corresponding edge curve parameter (ON_UNSET_VALUE if unknown) }; #if defined(ON_DLL_TEMPLATE) ON_DLL_TEMPLATE template class ON_CLASS ON_SimpleArray; #endif /* Description: Brep trim information is stored in ON_BrepTrim classes. ON_Brep.m_T[] is an array of all the trim in the brep. An ON_BrepTrim is derived from ON_CurveProxy so the the trim can supply easy to use evaluation tools via the ON_Curve virtual member functions. Note well that the domains and orientations of the curve m_C2[trim.m_c2i] and the trim as a curve may not agree. */ class ON_CLASS ON_BrepTrim : public ON_CurveProxy { ON_OBJECT_DECLARE(ON_BrepTrim); public: void DestroyRuntimeCache( bool bDelete = true ) override; // virtual ON_Object::SizeOf override unsigned int SizeOf() const override; // Union available for application use. // The constructor zeros m_trim_user. // The value is of m_trim_user is not saved in 3DM // archives and may be changed by some computations. mutable ON_U m_trim_user; public: mutable ON_ComponentStatus m_status = ON_ComponentStatus::NoneSet; private: ON__UINT16 m_reserved1 = 0U; public: int m_trim_index = -1; // index of trim in ON_Brep.m_T[] array // types of trim - access through m_type member. Also see m_iso and ON_Surface::ISO enum TYPE { unknown = 0, boundary = 1, // trim is connected to an edge, is part of an outer, // inner or slit loop, and is the only trim connected // to the edge. mated = 2, // trim is connected to an edge, is part of an outer, // inner or slit loop, no other trim from the same // loop is connected to the edge, and at least one // trim from a different loop is connected to the edge. seam = 3, // trim is connected to an edge, is part of an outer, // inner or slit loop, and one other trim from the // same loop is connected to the edge. // (There can be other mated trims that are also // connected to the edge. For example, the non-manifold // edge that results when a surface edge lies in the // middle of another surface.) Non-manifold "cuts" // have seam trims too. singular = 4, // trim is part of an outer loop, the trim's 2d curve // runs along the singular side of a surface, and the // trim is NOT connected to an edge. (There is no 3d // edge because the surface side is singular.) crvonsrf = 5, // trim is connected to an edge, is the only trim in // a crfonsrf loop, and is the only trim connected to // the edge. ptonsrf = 6, // trim is a point on a surface, trim.m_pbox is records // surface parameters, and is the only trim // in a ptonsrf loop. This trim is not connected // to an edge and has no 2d curve. slit = 7, // 17 Nov 2006 - reserved for future use // currently an invalid value trim_type_count = 8, force_32_bit_trim_type = 0xFFFFFFFF }; ///////////////////////////////////////////////////////////////// // Construction // // In general, you should not directly create ON_BrepTrim classes. // Use ON_Brep::NewTrim instead. ON_BrepTrim(); ON_BrepTrim(int); // trim index ON_BrepTrim& operator=(const ON_BrepTrim&); /* Returns: Brep that this trim belongs to. */ ON_Brep* Brep() const; /* Returns: Brep loop that this trim belongs to. */ ON_BrepLoop* Loop() const; /* Returns: Brep face this trim belongs to. */ ON_BrepFace* Face() const; /* Returns: Brep edge this trim uses or belongs to. This will be nullptr for singular trims. */ ON_BrepEdge* Edge() const; /* Parameters: tvi - [in] 0 or 1 Returns: Brep vertex at specified end of the trim. */ ON_BrepVertex* Vertex(int tvi) const; ///////////////////////////////////////////////////////////////// // ON_Object overrides // // (Trims are purely topological - geometry queries should be // directed at the trim's 2d curve or the trim's edge's 3d curve.) bool IsValid( class ON_TextLog* text_log = nullptr ) const override; void Dump( ON_TextLog& ) const override; // for debugging bool Write( ON_BinaryArchive& ) const override; bool Read( ON_BinaryArchive& ) override; // virtual ON_Geometry::ComponentIndex() override ON_COMPONENT_INDEX ComponentIndex() const override; // virtual ON_Curve::Reverse override // Reverses curve - caller must make sure trim's m_bRev3d // flags are properly updated. Use // ON_Brep::FlipTrim to reverse and trim and update all // m_bRev3d information. bool Reverse() override; /* Not necessary Base class does the same. // virtual ON_Curve::SetStartPoint override bool SetStartPoint( ON_3dPoint start_point ) override; // virtual ON_Curve::SetEndPoint override bool SetEndPoint( ON_3dPoint end_point ) override; */ ///////////////////////////////////////////////////////////////// // Interface /* Description: Expert user tool that replaces the 2d curve geometry of a trim Parameters; c2i - [in] brep 2d curve index of new curve Returns: True if successful. Example: ON_Curve* pCurve = ...; int c2i = brep.AddTrimCurve(pCurve); trim.ChangeTrimCurve(c2i); Remarks: Sets m_c2i, calls SetProxyCurve, cleans runtime caches, and updates m_pbox. */ bool ChangeTrimCurve( int c2i ); /* Description: Destroy parameter space information. Currently, this involves destroying m_pline and m_pbox. Parameter space information should be destroyed when the location of a trim curve is changed. */ void DestroyPspaceInformation(); /* Description: Expert user function. Removes a trim from an edge. Parameters: bRemoveFromStartVertex - [in] if true, the trim is removed from its start vertex by setting m_vi[0] to -1. bRemoveFromEndVertex - [in] if true, the trim is removed from its start vertex by setting m_vi[1] to -1. Remarks: If the trim is attached to an edge (m_ei>=0), then the trim is removed from the edge and the edge's m_ti[] list. The trim's m_bRev3d and tolerance values are not changed. */ bool RemoveFromEdge( bool bRemoveFromStartVertex, bool bRemoveFromEndVertex ); /* Description: Expert user function. Attaches a trim to an edge. Parameters: edge_index - [in] index of an edge. bRev3d - [in] value for trim's m_bRev3d field. Remarks: If the trim is attached to an edge (m_ei>=0), then the trim is removed from the edge and the edge's m_ti[] list. The trim's tolerance values are not changed. */ bool AttachToEdge( int edge_index, bool bRev3d ); /* Returns: 2d curve geometry used by this trim or nullptr */ const ON_Curve* TrimCurveOf() const; /* Returns: 3d curve geometry used by this trim or nullptr. */ const ON_Curve* EdgeCurveOf() const; /* Returns: 3d surface geometry used by this trim or nullptr */ const ON_Surface* SurfaceOf() const; /* Returns: brep.m_C2[] 2d curve index of the 2d curve geometry used by this trim or -1. */ int TrimCurveIndexOf() const; /* Returns: brep.m_C3[] 3d curve index of the 3d curve geometry used by this trim or -1. */ int EdgeCurveIndexOf() const; /* Returns: brep.m_S[] surface index of the 3d surface geometry used by this trim or -1. */ int SurfaceIndexOf() const; /* Returns: brep.m_F[] face index of the face used by this trim or -1. */ int FaceIndexOf() const; /* Returns: True if the trim satisfies these four criteria. 1) is part of a loop 2) is connected to a 3d edge 3) one other trim from the same loop is connected to the edge 4) The 2d trim curve for the other trim is the reverse of the 2d trim curve for this trim. Remarks: In order for IsSlit() to work correctly, the m_type and m_iso fields must be set correctly. In V4 SR1, this function will be removed and ON_BrepTrim::slit will be added as a type. */ bool IsSlit() const; /* Returns: True if the trim satisfies these four criteria. 1) is part of a loop 2) is connected to a 3d edge 3) one other trim from the same loop is connected to the edge 4) the 2d trim curve for this trim lies along the side of the face's parameter space and the 2d curve for the other trim lies on the opposite side of the face's parameter space. Remarks: In order for IsSeam() to work correctly, the m_type and m_iso fields must be set correctly. In V4 SR1, this function will be removed and ON_BrepTrim::slit will be added as a type. */ bool IsSeam() const; /* Description: Expert user tool that transforms all the parameter space (2d) trimming curves in this loop. Only 2d curve geometry is changed. The caller is responsible for reversing loops, toggle m_bRev, flags, etc. Parameters: xform - [in] Transformation applied to 2d curve geometry. Returns True if successful. If false is returned, the brep may be invalid. */ bool TransformTrim( const ON_Xform& xform ); // index of the 2d parameter space trimming curve int m_c2i = -1; // index of 3d edge (-1 if ON_BrepTrim is singular) int m_ei = -1; // Indices of start/end vertices. Trims along singular // sides and trims that correspond to closed 3d edges // have m_vi[0] = m_vi[1]. Note that singular trims // and trims on the closed edge of a closed surface can // have an open 2d trimming curve and still have // m_vi[0] = m_vi[1]. int m_vi[2]; // true if the 2d trim and 3d edge have opposite orientations. bool m_bRev3d = false; TYPE m_type = ON_BrepTrim::unknown; ON_Surface::ISO m_iso = ON_Surface::not_iso; // index of loop that uses this trim int m_li = -1; // The values in m_tolerance[] record the accuracy of // the parameter space trimming curves. // // Remarks: // m_tolerance[0] = accuracy of parameter space curve // in first ( "u" ) parameter // // m_tolerance[1] = accuracy of parameter space curve // in second ( "v" ) parameter // // A value of ON_UNSET_VALUE indicates that the // tolerance should be computed. If the value >= 0.0, // then the tolerance is set. If the value is // ON_UNSET_VALUE, then the tolerance needs to be // computed. // // If the trim is not singular, then the trim must // have an edge. If P is a 3d point on the edge's // curve and surface(u,v) = Q is the point on the // surface that is closest to P, then there must // be a parameter t in the interval [m_t[0], m_t[1]] // such that // // |u - curve2d(t)[0]| <= m_tolerance[0] // // and // // |v - curve2d(t)[1]| <= m_tolerance[1] // // If P is the 3d point for the vertex brep.m_V[m_vi[k]] // and (uk,vk) is the corresponding end of the trim's // parameter space curve, then there must be a surface // parameter (u,v) such that: // // * the distance from the 3d point surface(u,v) to P // is <= brep.m_V[m_vi[k]].m_tolerance, // * |u-uk| <= m_tolerance[0]. // * |v-vk| <= m_tolerance[1]. double m_tolerance[2]; // Runtime polyline approximation of trimming curve. // This information is not saved in 3DM archives. ON_SimpleArray m_pline; /* Description: When an edge is modified, the m_pline[].e values need to be set to ON_UNSET_VALUE by calling UnsetPlineEdgeParameters(). */ void UnsetPlineEdgeParameters(); // Runtime parameter space trimming curve bounding box. // This information is not saved in 3DM archives. ON_BoundingBox m_pbox; public: // values stored in legacy file formats - ignore void m__legacy_flags_Set(int,int); // used internally - ignore bool m__legacy_flags_Get(int*,int*) const; // used internally - ignore double m__legacy_2d_tol = ON_UNSET_VALUE; // used internally - ignore double m__legacy_3d_tol = ON_UNSET_VALUE; // used internally - ignore int m__legacy_flags = 0; // used internally - ignore private: friend class ON_Brep; ON_Brep* m_brep = nullptr; // so isolated edge class edge can get at it's 3d curve ON_BrepTrim( const ON_BrepTrim& ) = delete; }; class ON_CLASS ON_BrepLoop : public ON_Geometry { ON_OBJECT_DECLARE(ON_BrepLoop); public: void DestroyRuntimeCache( bool bDelete = true ) override; // virtual ON_Geometry overrides // A loop is derived from ON_Geometry so that is can // be passed around to things that expect ON_Geometry // pointers. It is not a very useful stand-alone object. /* Description: virtual ON_Geometry::Dimension() override. Returns: 2 */ int Dimension() const override; // virtual ON_Geometry GetBBox override bool GetBBox( double* boxmin, double* boxmax, bool bGrowBox = false ) const override; // virtual ON_Geometry::Transform() override. bool Transform( const ON_Xform& xform ) override; public: /* Returns: Brep that the loop belongs to. */ ON_Brep* Brep() const; /* Returns: Brep face this loop belongs to. */ ON_BrepFace* Face() const; /* Parameters: lti - [in] index into the loop's m_ti[] array. Returns: The trim brep.m_T[loop.m_ti[lti]]; */ ON_BrepTrim* Trim( int lti ) const; /* Returns: Number of trims in this loop. */ int TrimCount() const; // Union available for application use. // The constructor zeros m_loop_user. // The value is of m_loop_user is not saved in 3DM // archives and may be changed by some computations. mutable ON_U m_loop_user; public: mutable ON_ComponentStatus m_status = ON_ComponentStatus::NoneSet; private: ON__UINT16 m_reserved1 = 0U; public: int m_loop_index = -1; // index of loop in ON_Brep.m_L[] array enum TYPE { unknown = 0, outer = 1, // 2d loop curves form a simple closed curve with a counterclockwise orientation inner = 2, // 2d loop curves form a simple closed curve with a clockwise orientation slit = 3, // always closed - used internally during splitting operations crvonsrf = 4, // "loop" is a curveonsrf made from a single // (open or closed) trim that is has type ON_BrepTrim::crvonsrf. ptonsrf = 5, // "loop" is a ptonsrf made from a single // trim that is has type ON_BrepTrim::ptonsrf. type_count = 6 }; ON_BrepLoop(); ON_BrepLoop(int); // loop index ON_BrepLoop& operator=(const ON_BrepLoop&); ///////////////////////////////////////////////////////////////// // ON_Object overrides // // (Loops and trims are purely topological - geometry queries should be // directed at the trim's 2d curve or the trim's edge's 3d curve.) // virtual ON_Object::SizeOf override unsigned int SizeOf() const override; bool IsValid( class ON_TextLog* text_log = nullptr ) const override; void Dump( ON_TextLog& ) const override; // for debugging bool Write( ON_BinaryArchive& ) const override; bool Read( ON_BinaryArchive& ) override; // virtual ON_Geometry::ComponentIndex() override ON_COMPONENT_INDEX ComponentIndex() const override; ///////////////////////////////////////////////////////////////// // Interface ////////// // Returns the index i such that loop.m_ti[i] = trim.m_trim_index. // Returns -1 if the trim is not in this loop int IndexOfTrim( const ON_BrepTrim& ) const; /* Returns: brep.m_S[] surface index of the 3d surface geometry used by this loop or -1. */ int SurfaceIndexOf() const; /* Returns: Pointer to the surface geometry used by the loop. */ const ON_Surface* SurfaceOf() const; /* Description: Expert user tool that transforms all the parameter space (2d) trimming curves in this loop. Only 2d curve geometry is changed. The caller is responsible for reversing loops, toggle m_bRev, flags, etc. Parameters: xform - [in] Transformation applied to 2d curve geometry. Returns True if successful. If false is returned, the brep may be invalid. */ bool TransformTrim( const ON_Xform& xform ); ON_SimpleArray m_ti; // trim indices TYPE m_type = ON_BrepLoop::unknown; int m_fi = -1; // index of face that uses this loop ////////// // parameter space trimming loop bounding box // runtime information - not saved ON_BoundingBox m_pbox; private: friend class ON_Brep; ON_Brep* m_brep = nullptr; ON_BrepLoop(const ON_BrepLoop&) = delete; }; class ON_CLASS ON_BrepFace : public ON_SurfaceProxy { ON_OBJECT_DECLARE(ON_BrepFace); public: void DestroyRuntimeCache( bool bDelete = true ) override; // Union available for application use. // The constructor zeros m_face_user. // The value is of m_face_user is not saved in 3DM // archives and may be changed by some computations. mutable ON_U m_face_user; public: mutable ON_ComponentStatus m_status = ON_ComponentStatus::NoneSet; private: // the 4 byte pack id is stored as 2 ON__UINT16 values to prevent breaking the C++ SDK. ON__UINT16 m_pack_id_low = 0; // PackId() = 0x10000*m_pack_id_high + m_pack_id_low; public: int m_face_index = -1; // index of face in ON_Brep.m_F[] array ON_BrepFace(); ~ON_BrepFace(); ON_BrepFace(int); ON_BrepFace& operator=(const ON_BrepFace&); /* Returns: Brep that the face belongs to. */ ON_Brep* Brep() const; /* Parameters: fli - [in] index into the face's m_li[] array. Returns: The loop brep.m_L[face.m_li[fli]]; */ ON_BrepLoop* Loop( int fli ) const; /* Returns: Number of loops in this face. */ int LoopCount() const; /* Returns: Outer boundary loop for this face. */ ON_BrepLoop* OuterLoop() const; /* Parameters: dir 1: side with underlying surface normal pointing into the topology region -1: side with underlying surface normal pointing out of the topology region Returns: Brep region topology face side. If the region topology has not be created by calling ON_Brep::RegionToplogy(), then nullptr is returned. */ class ON_BrepFaceSide* FaceSide(int dir) const; ///////////////////////////////////////////////////////////////// // ON_Object overrides // // (Faces are purely topological - geometry queries should be // directed at the face's 3d surface.) // virtual ON_Object::SizeOf override unsigned int SizeOf() const override; // virtual ON_Object::DataCRC override ON__UINT32 DataCRC(ON__UINT32 current_remainder) const override; bool IsValid( class ON_TextLog* text_log = nullptr ) const override; void Dump( ON_TextLog& ) const override; // for debugging bool Write( ON_BinaryArchive& ) const override; bool Read( ON_BinaryArchive& ) override; // virtual ON_Geometry::ComponentIndex() override ON_COMPONENT_INDEX ComponentIndex() const override; // virtual ON_Geometry::ClearBoundingBox() override void ClearBoundingBox() override; // virtual ON_Geometry GetBBox override bool GetBBox( double* boxmin, double* boxmax, bool bGrowBox = false ) const override; /* Description: This is an override of the virtual ON_Surface::Reverse function. It toggles the face's m_bRev flag so the abstract orientation of the face does not change. Parameters: dir - [in] 0 = reverse "s" parameter, 1 = reverse "t" parameter The domain changes from [a,b] to [-a,-b] Returns: True if successful. Remarks: The range of the face's trimming curves and the orientation direction of then loops are changed so that the resulting face is still valid. */ bool Reverse( int dir ) override; /* Description: This is an override of the virtual ON_Surface::Transpose function. It toggles the face's m_bRev flag so the abstract orientation of the face does not change. Returns: True if successful. Remarks: The range of the face's trimming curves and the orientation direction of then loops are changed so that the resulting face is still valid. */ bool Transpose() override; /* Description: This is an override of the virtual ON_Surface::SetDomain function. Parameters: dir - [in] 0 = set "u" domain, 1 = set "v" domain. t0 - [in] t1 - [in] t0 < t1 The new domain is the interval (t0,t1) Returns: True if successful. */ bool SetDomain( int dir, double t0, double t1 ) override; /* ////////// // Change the domain of a face // This changes the parameterization of the face's surface and transforms // the "u" and "v" coordinates of all the face's parameter space trimming // curves. The locus of the face is not changed. */ bool SetDomain( ON_Interval udom, ON_Interval vdom ); ///////////////////////////////////////////////////////////////// // Rendering Interface //int MaterialIndex() const; // if -1, use parent's material definition //void SetMaterialIndex(int); // If true is returned, then ~ON_BrepFace will delete mesh. bool SetMesh( ON::mesh_type, ON_Mesh* mesh ); const ON_Mesh* Mesh( ON::mesh_type mesh_type ) const; /* Description: Destroy meshes used to render and analyze surface and polysurface objects. Parameters: mesh_type - [in] type of mesh to destroy bDeleteMesh - [in] if true, cached mesh is deleted. If false, pointer to cached mesh is just set to nullptr. See Also: CRhinoObject::GetMeshes CRhinoObject::MeshCount CRhinoObject::IsMeshable */ void DestroyMesh( ON::mesh_type mesh_type, bool bDeleteMesh = true ); ///////////////////////////////////////////////////////////////// // "Expert" Interface /* Description: Expert user tool that transforms all the parameter space (2d) trimming curves on this face. Only 2d curve geometry is changed. The caller is responsible for reversing loops, toggle m_bRev, flags, etc. Parameters: xform - [in] Transformation applied to 2d curve geometry. Returns True if successful. If false is returned, the brep may be invalid. */ bool TransformTrim( const ON_Xform& xform ); /* Returns: brep.m_S[] surface index of the 3d surface geometry used by this face or -1. */ int SurfaceIndexOf() const; /* Returns: Pointer to the surface geometry used by the face. */ const ON_Surface* SurfaceOf() const; ON_SimpleArray m_li; // loop indices (outer loop is m_li[0]) int m_si = -1; // index of surface in b-rep m_S[] array bool m_bRev = false; // true if face orientation is opposite // of natural surface orientation /* Returns: 0: unset pack id. > 0: set pack id. Remarks: PackId values assigned to brep faces are inheritied from the PackId values assigned to subd faces when a subd is converted into a brep. These faces are "trivially trimmed" which means the boundary of the face is identical to the boundary of the underlying surface. There are two types of face packs in a subd, quad grid packs and singleton packs. A subd quad grid pack is a set of subd quads that form a rectangular grid. A subd singleton pack is a single face, quad or n-gon, that is not part of a quad grid pack. There are three types of face packs in a brep created from a subd, grid packs, star packs and singleton packs. A brep "grid pack" comes from a rectangular grid of subd quads. A grid pack of brep faces can be converted into a single larger trivially trimmed brep face. A brep "star pack" of brep faces comes from a singel subd n-gon (n = 3, 5 or more). The star pack will have n faces with a star center vertex and shared edges radiating from the star center. A brep "singleton" pack comes from a single subd quad that could not be grouped into a larger subd quad grid pack. */ unsigned int PackId() const; /* Description: Sets PackId() to zero. */ void ClearPackId(); /* Description: Used by ON_SubD functions that create breps to transmit the subd face ON_SubDFace.PackId() value to the brep face or faces generated from the subd face. Unless you are an expert and doing something very carefully and very fancy, to not call this function. Remarks: PackId values assigned to brep faces are inheritied from the PackId values assigned to subd faces when a subd is converted into a brep. These faces are "trivially trimmed" which means the boundary of the face is identical to the boundary of the underlying surface. There are two types of face packs in a subd, quad grid packs and singleton packs. A subd quad grid pack is a set of subd quads that form a rectangular grid. A subd singleton pack is a single face, quad or n-gon, that is not part of a quad grid pack. There are three types of face packs in a brep created from a subd, grid packs, star packs and singleton packs. A brep "grid pack" comes from a rectangular grid of subd quads. A grid pack of brep faces can be converted into a single larger trivially trimmed brep face. A brep "star pack" of brep faces comes from a singel subd n-gon (n = 3, 5 or more). The star pack will have n faces with a star center vertex and shared edges radiating from the star center. A brep "singleton" pack comes from a single subd quad that could not be grouped into a larger subd quad grid pack. */ void SetPackIdForExperts( unsigned int pack_id ); private: ON__UINT8 m_reserved2 = 0; private: // the 4 byte pack id is stored as 2 ON__UINT16 values to prevent breaking the C++ SDK. ON__UINT16 m_pack_id_high = 0; // PackId() = 0x10000*m_pack_id_high + m_pack_id_low; public: // The application specifies a base ON_Material used to render the brep this face belongs to. // If m_material_channel_index > 0 AND face_material_id = base.MaterialChannelIdFromIndex(m_material_channel_index) // is not nil, then face_material_id identifies an override rendering material for this face. // Otherwise base will be used to render this face. int m_face_material_channel = 0; public: /* Description: Set this face's rendering material channel index. Parameters: material_channel_index - [in] A value between 0 and ON_Material::MaximumMaterialChannelIndex, inclusive. This value is typically 0 or the value returned from ON_Material::MaterialChannelIndexFromId(). Remarks: If base_material is the ON_Material assigned to render this brep and ON_UUID face_material_id = base_material.MaterialChannelIdFromIndex( material_channel_index ) is not nil, then face_material_id identifies an override rendering material for this face. Otherwise base_material is used to render this face. */ void SetMaterialChannelIndex(int material_channel_index) const; /* Description: Remove per face rendering material channel index setting. The face will use the material assigned to the brep object. */ void ClearMaterialChannelIndex() const; /* Returns: This face's rendering material channel index. Remarks: If base_material is the ON_Material assigned to render this subd, MaterialChannelIndex() > 0, and ON_UUID face_material_id = base_material.MaterialChannelIdFromIndex( face.MaterialChannelIndex() ) is not nil, then face_material_id identifies an override rendering material for this face. Otherwise base_material is used to render this face. */ int MaterialChannelIndex() const; /* Description: Set per face color. Parameters: color - [in] */ void SetPerFaceColor( ON_Color color ) const; /* Description: Remove per face color setting. The face will use the color assigned to the brep object. */ void ClearPerFaceColor() const; /* Returns: Per face color. A value of ON_Color::UnsetColor indicates the face uses the color assigned to the brep object. */ const ON_Color PerFaceColor() const; public: // Persistent id for this face. Default is ON_nil_uuid. ON_UUID m_face_uuid = ON_nil_uuid; private: // RH-37306 // 30 Mar 2020: Space reserved for future implementation. mutable ON_Color m_per_face_color = ON_Color::UnsetColor; private: ON_BoundingBox m_bbox; // 3d bounding box (should be declared mutable and const_cast<> is used to make it fake mutable) ON_Interval m_domain[2]; // rectangular bounds of 2d curves ON_Mesh* m_render_mesh = nullptr; ON_Mesh* m_analysis_mesh = nullptr; ON_Mesh* m_preview_mesh = nullptr; //int m_material_index; // if 0 (default), ON_Brep's object attributes // // determine material. private: friend class ON_Brep; ON_Brep* m_brep = nullptr; ON_BrepFace( const ON_BrepFace& ) = delete; private: /* Parameters: bLazy - [in] If true and if ON_BrepFace.m_bbox is not empty, then ON_BrepFace.m_bbox is returned. In all other cases the bbox is calculated from scratch. bUpdateCachedBBox - [in] If true and the bounding box is calculated, then the value is saved in ON_BrepFace.m_bbox so future lazy evaluations can use the value. */ const ON_BoundingBox InternalFaceBoundingBox(bool bLazy, bool bUpdateCachedBBox) const; }; class ON_CLASS ON_BrepFaceSide : public ON_Object { ON_OBJECT_DECLARE(ON_BrepFaceSide); public: bool IsValid( class ON_TextLog* text_log = nullptr ) const override; // Union available for application use. // The constructor zeros m_faceside_user. // The value is of m_faceside_user is not saved in 3DM // archives and may be changed by some computations. mutable ON_U m_faceside_user; // index of face side in ON_BrepRegionTopology.m_FS[] array int m_faceside_index; ON_BrepFaceSide(); ~ON_BrepFaceSide(); ON_BrepFaceSide& operator=(const ON_BrepFaceSide&); bool Write(ON_BinaryArchive& binary_archive) const override; bool Read(ON_BinaryArchive& binary_archive) override; /* Returns: Brep this face side belongs to. */ const class ON_Brep* Brep() const; /* Returns: Region topology this face side belongs to. */ const class ON_BrepRegionTopology* RegionTopology() const; /* Returns: Region the face side belongs to. */ const class ON_BrepRegion* Region() const; /* Returns: Face this side belongs to. */ const class ON_BrepFace* Face() const; /* Returns: +1: underlying geometric surface normal points into region. -1: underlying geometric surface normal points out of region. */ int SurfaceNormalDirection() const; public: int m_ri; // region index // m_ri = -1 indicates this face side overlaps // another face side. Generally this is a flaw // in an ON_Brep. int m_fi; // face index int m_srf_dir; // 1 ON_BrepFace's surface normal points into region // -1 ON_BrepFace's surface normal points out of region private: friend class ON_Brep; friend class ON_BrepRegionTopology; ON_BrepRegionTopology* m_rtop; ON_BrepFaceSide( const ON_BrepFaceSide& ); }; class ON_CLASS ON_BrepRegion : public ON_Object { ON_OBJECT_DECLARE(ON_BrepRegion); public: bool IsValid( class ON_TextLog* text_log = nullptr ) const override; // Union available for application use. // The constructor zeros m_region_user. // The value is of m_region_user is not saved in 3DM // archives and may be changed by some computations. mutable ON_U m_region_user; // index of region in ON_BrepRegionTopology.m_R[] array int m_region_index; ON_BrepRegion(); ~ON_BrepRegion(); ON_BrepRegion& operator=(const ON_BrepRegion&); bool Write(ON_BinaryArchive& binary_archive) const override; bool Read(ON_BinaryArchive& binary_archive) override; /* Returns: Brep this region belongs to. */ const ON_Brep* Brep() const; /* Returns: Region topology this region belongs to. */ class ON_BrepRegionTopology* RegionTopology() const; /* Parameter: rfsi - [in] index into the region's m_fsi[] array. Returns: The face side in rtop.m_FS[m_fsi[rsi]], where rtop is the ON_BrepRegionTopology class this region belongs to. */ ON_BrepFaceSide* FaceSide(int rfsi) const; /* Returns: True if the region is finite. */ bool IsFinite() const; /* Returns: Region bounding box. */ const ON_BoundingBox& BoundingBox() const; ON_SimpleArray m_fsi; // indices of face sides int m_type; // 0 = infinite, 1 = bounded ON_BoundingBox m_bbox; /* Description: Get the boundary of a region as a brep object. If the region is finite, the boundary will be a closed manifold brep. The boundary may have more than one connected component. Parameters: brep - [in] if not nullptr, the brep form is put into this brep. Returns: the region boundary as a brep or nullptr if the calculation fails. */ ON_Brep* RegionBoundaryBrep( ON_Brep* brep = nullptr ) const; private: friend class ON_Brep; friend class ON_BrepRegionTopology; ON_BrepRegionTopology* m_rtop; ON_BrepRegion( const ON_BrepRegion& ); }; #if defined(ON_DLL_TEMPLATE) ON_DLL_TEMPLATE template class ON_CLASS ON_ClassArray; ON_DLL_TEMPLATE template class ON_CLASS ON_ObjectArray; ON_DLL_TEMPLATE template class ON_CLASS ON_ClassArray; ON_DLL_TEMPLATE template class ON_CLASS ON_ObjectArray; ON_DLL_TEMPLATE template class ON_CLASS ON_ClassArray; ON_DLL_TEMPLATE template class ON_CLASS ON_ObjectArray; ON_DLL_TEMPLATE template class ON_CLASS ON_ClassArray; ON_DLL_TEMPLATE template class ON_CLASS ON_ObjectArray; ON_DLL_TEMPLATE template class ON_CLASS ON_ClassArray; ON_DLL_TEMPLATE template class ON_CLASS ON_ObjectArray; ON_DLL_TEMPLATE template class ON_CLASS ON_ObjectArray; ON_DLL_TEMPLATE template class ON_CLASS ON_ObjectArray; #endif class ON_CLASS ON_BrepVertexArray : public ON_ObjectArray { public: ON_BrepVertexArray(); ~ON_BrepVertexArray(); bool Read( ON_BinaryArchive& ); bool Write( ON_BinaryArchive& ) const; unsigned int SizeOf() const; }; class ON_CLASS ON_BrepEdgeArray : public ON_ObjectArray { public: ON_BrepEdgeArray(); ~ON_BrepEdgeArray(); bool Read( ON_BinaryArchive& ); bool Write( ON_BinaryArchive& ) const; unsigned int SizeOf() const; }; class ON_CLASS ON_BrepTrimArray : public ON_ObjectArray { public: ON_BrepTrimArray(); ~ON_BrepTrimArray(); bool Read( ON_BinaryArchive& ); bool Write( ON_BinaryArchive& ) const; unsigned int SizeOf() const; }; class ON_CLASS ON_BrepLoopArray : public ON_ObjectArray { public: ON_BrepLoopArray(); ~ON_BrepLoopArray(); bool Read( ON_BinaryArchive& ); bool Write( ON_BinaryArchive& ) const; unsigned int SizeOf() const; }; class ON_CLASS ON_BrepFaceArray : public ON_ObjectArray { public: ON_BrepFaceArray(); ~ON_BrepFaceArray(); bool Read( ON_BinaryArchive& ); bool Write( ON_BinaryArchive& ) const; unsigned int SizeOf() const; }; class ON_CLASS ON_BrepFaceSideArray : public ON_ObjectArray { public: ON_BrepFaceSideArray(); ~ON_BrepFaceSideArray(); bool Read( ON_BinaryArchive& ); bool Write( ON_BinaryArchive& ) const; unsigned int SizeOf() const; private: bool Internal_ReadV5( ON_BinaryArchive& ); bool Internal_ReadV6( ON_BinaryArchive& ); bool Internal_WriteV5( ON_BinaryArchive& ) const; bool Internal_WriteV6( ON_BinaryArchive& ) const; }; class ON_CLASS ON_BrepRegionArray : public ON_ObjectArray { public: ON_BrepRegionArray(); ~ON_BrepRegionArray(); bool Read( ON_BinaryArchive& ); bool Write( ON_BinaryArchive& ) const; unsigned int SizeOf() const; private: bool Internal_ReadV5( ON_BinaryArchive& ); bool Internal_ReadV6( ON_BinaryArchive& ); bool Internal_WriteV5( ON_BinaryArchive& ) const; bool Internal_WriteV6( ON_BinaryArchive& ) const; }; class ON_CLASS ON_BrepRegionTopology { public: ON_BrepRegionTopology(); ON_BrepRegionTopology(const ON_BrepRegionTopology& src); ~ON_BrepRegionTopology(); ON_BrepRegionTopology& operator=(const ON_BrepRegionTopology&); ON_BrepFaceSideArray m_FS; ON_BrepRegionArray m_R; const ON_Brep* Brep() const; bool IsValid( ON_TextLog* text_log = 0 ) const; bool Read( ON_BinaryArchive& ); bool Write( ON_BinaryArchive& ) const; unsigned int SizeOf() const; bool Transform( const ON_Xform& xform ); private: friend class ON_V5_BrepRegionTopologyUserData; friend class ON_Brep; const ON_Brep* m_brep = nullptr; }; class ON_CLASS ON_Brep : public ON_Geometry { ON_OBJECT_DECLARE(ON_Brep); public: ///////////////////////////////////////////////////////////////// // // Component status interface // // //virtual unsigned int ClearComponentStates( ON_ComponentStatus states_to_clear ) const override; //virtual unsigned int GetComponentsWithSetStates( ON_ComponentStatus states_filter, bool bAllEqualStates, ON_SimpleArray< ON_COMPONENT_INDEX >& components ) const override; //virtual unsigned int SetComponentStates( ON_COMPONENT_INDEX component_index, ON_ComponentStatus states_to_set ) const override; //virtual unsigned int ClearComponentStates( ON_COMPONENT_INDEX component_index, ON_ComponentStatus states_to_clear ) const override; //virtual unsigned int SetComponentStatus( ON_COMPONENT_INDEX component_index, ON_ComponentStatus status_to_copy ) const override; //virtual ON_AggregateComponentStatus AggregateComponentStatus() const override; //virtual void MarkAggregateComponentStatusAsNotCurrent() const override; // virtual ON_Object::DestroyRuntimeCache override void DestroyRuntimeCache( bool bDelete = true ) override; // virtual ON_Object::SizeOf override unsigned int SizeOf() const override; // virtual ON_Object::DataCRC override ON__UINT32 DataCRC(ON__UINT32 current_remainder) const override; // virtual ON_Geometry override bool EvaluatePoint( const class ON_ObjRef& objref, ON_3dPoint& P ) const override; public: /* Description: Use ON_Brep::New() instead of new ON_Brep() when writing Rhino plug-ins (or when openNURBS is used as a Microsoft DLL and you need to create a new ON_Brep in a different .EXE or .DLL). Example: // bad - ON_Brep* pBrep = new ON_Brep(); ON_Brep* pBrep = ON_Brep::New(); // good ... delete pBrep; pBrep = nullptr; Returns: Pointer to an ON_Brep. Destroy by calling delete. Remarks: When openNURBS is used as a Microsoft DLL, the CL.EXE compiler uses local vtables for classes that are new-ed in other executables but uses the ordinary vtable for for classes that are allocated in functions like ON_BrepCylinder(), ON_NurbsSurfaceQuadrilateral(), ON_Cylinder::RevSurfaceForm(nullptr), etc. Using static New() functions like ON_Brep::New() insures that identical classes has the same vtable and makes all code run identically. */ static ON_Brep* New(); /* Description: Use ON_Brep::New(const ON_Brep& src) instead of new ON_Brep(const ON_Brep& src). Returns: Pointer to an ON_Brep. Destroy by calling delete. Remarks: See static ON_Brep* ON_Brep::New() for details. */ static ON_Brep* New(const ON_Brep&); // Construction ON_Brep(); ~ON_Brep(); ON_Brep(const ON_Brep&); ON_Brep& operator=(const ON_Brep&); // Override of virtual ON_Object::MemoryRelocate void MemoryRelocate() override; /* Description: Does nothing. Will be deleted in next version. */ ON_DEPRECATED_MSG("Does nothing. Delete call.") bool IsDuplicate( const ON_Brep& other, double tolerance = ON_ZERO_TOLERANCE ) const; ///////////////////////////////////////////////////////////////// // construction/destruction helpers // returns Brep to state it has after default construction void Destroy(); // call if memory pool used by b-rep members becomes invalid void EmergencyDestroy(); /* Description: Calculates polygon mesh approximation of the brep and appends one mesh for each face to the mesh_list[] array. Parameters: mp - [in] meshing parameters mesh_list - [out] meshes are appended to this array. Returns: Number of meshes appended to mesh_list[] array. */ int CreateMesh( const ON_MeshParameters& mp, ON_SimpleArray& mesh_list ) const; /* Description: Destroy meshes used to render and analyze brep. Parameters: mesh_type - [in] type of mesh to destroy bDeleteMesh - [in] if true, cached meshes are deleted. If false, pointers to cached meshes are just set to nullptr. See Also: ON_Brep::GetMesh ON_BrepFace::DestroyMesh ON_BrepFace::Mesh ON_BrepFace::SetMesh */ void DestroyMesh( ON::mesh_type mesh_type, bool bDeleteMesh = true ); /* Description: Get cached meshes used to render and analyze brep. Parameters: mesh_type - [in] type of mesh to get meshes - [out] meshes are appended to this array. The ON_Brep owns these meshes so they cannot be modified. Returns: Number of meshes added to array. (Same as m_F.Count()) See Also: ON_Brep::DestroyMesh ON_BrepFace::DestroyMesh ON_BrepFace::Mesh ON_BrepFace::SetMesh */ int GetMesh( ON::mesh_type mesh_type, ON_SimpleArray< const ON_Mesh* >& meshes ) const; /* Description: Create a brep from a surface. The resulting surface has an outer boundary made from four trims. The trims are ordered so that they run along the south, east, north, and then west side of the surface's parameter space. Parameters: pSurface - [in] pointer to a surface. The brep will manage this pointer and delete it in ~ON_Brep. Returns: @untitled table true successful When true is returned, the pSurface pointer is added to the brep's m_S[] array and it will be deleted by the brep's destructor. false brep cannot be created from this surface. When false is returned, then the caller is responsible for deleting pSurface unless it was previously added to the brep's m_S[] array. Remarks: The surface class must be created with new so that the delete in ~ON_Brep will not cause a crash. */ bool Create( ON_Surface*& pSurface ); bool Create( ON_NurbsSurface*& pNurbsSurface ); bool Create( ON_PlaneSurface*& pPlaneSurface ); bool Create( ON_RevSurface*& pRevSurface ); bool Create( ON_SumSurface*& pSumSurface ); /* Description: Check for corrupt data values that are likely to cause crashes. Parameters: bRepair - [in] If true, const_cast<> will be used to change the corrupt data so that crashes are less likely. bSilentError - [in] If true, ON_ERROR will not be called when corruption is detected. text_log - [out] If text_log is not null, then a description of corruption is printed using text_log. Remarks: Ideally, IsCorrupt() would be a virtual function on ON_Object, but doing that at this point would break the public SDK. */ bool IsCorrupt( bool bRepair, bool bSilentError, class ON_TextLog* text_log ) const; bool IsValid( class ON_TextLog* text_log = nullptr ) const override; /* Description: Tests the brep to see if its topology information is valid. Parameters: text_log - [in] if the brep topology is not valid and text_log is not nullptr, then a brief English description of the problem is appended to the log. The information appended to text_log is suitable for low-level debugging purposes by programmers and is not intended to be useful as a high level user interface tool. Returns: @untitled table true brep topology is valid false brep topology is not valid Remarks: ON_Brep::IsValidTopology can be called at any time. See Also: ON_Brep::IsValid ON_Brep::IsValidGeometry ON_Brep::IsValidTolerancesAndFlags */ bool IsValidTopology( ON_TextLog* text_log = nullptr ) const; /* Description: Expert user function that tests the brep to see if its geometry information is valid. The value of brep.IsValidTopology() must be true before brep.IsValidGeometry() can be safely called. Parameters: text_log - [in] if the brep geometry is not valid and text_log is not nullptr, then a brief English description of the problem is appended to the log. The information appended to text_log is suitable for low-level debugging purposes by programmers and is not intended to be useful as a high level user interface tool. Returns: @untitled table true brep geometry is valid false brep geometry is not valid Remarks: ON_Brep::IsValidTopology must be true before you can safely call ON_Brep::IsValidGeometry. See Also: ON_Brep::IsValid ON_Brep::IsValidTopology ON_Brep::IsValidTolerancesAndFlags */ bool IsValidGeometry( ON_TextLog* text_log = nullptr ) const; /* Description: Expert user function that tests the brep to see if its tolerances and flags are valid. The values of brep.IsValidTopology() and brep.IsValidGeometry() must be true before brep.IsValidTolerancesAndFlags() can be safely called. Parameters: text_log - [in] if the brep tolerance or flags are not valid and text_log is not nullptr, then a brief English description of the problem is appended to the log. The information appended to text_log is suitable for low-level debugging purposes by programmers and is not intended to be useful as a high level user interface tool. Returns: @untitled table true brep tolerance and flags are valid false brep tolerance and flags are not valid Remarks: ON_Brep::IsValidTopology and ON_Brep::IsValidGeometry must be true before you can safely call ON_Brep::IsValidTolerancesAndFlags. See Also: ON_Brep::IsValid ON_Brep::IsValidTopology ON_Brep::IsValidGeometry */ bool IsValidTolerancesAndFlags( ON_TextLog* text_log = nullptr ) const; // Description: // Tests brep to see if it is valid for // saving in V2 3DM archives. // Returns: // true if brep is valid for V2 3DM archives. // Remarks: // V2 breps could not have dangling curves. bool IsValidForV2() const; bool IsValidForV2( const ON_BrepTrim& ) const; bool IsValidForV2( const ON_BrepEdge& ) const; // virtual ON_Objet::Dump() override void Dump( ON_TextLog& ) const override; // for debugging // virtual ON_Objet::Write() override bool Write( ON_BinaryArchive& ) const override; // virtual ON_Objet::Read() override bool Read( ON_BinaryArchive& ) override; // virtual ON_Objet::ObjectType() override ON::object_type ObjectType() const override; // virtual ON_Geometry::Dimension() override int Dimension() const override; // virtual ON_Geometry::ClearBoundingBox() override void ClearBoundingBox() override; // virtual ON_Geometry GetTightBoundingBox override bool GetTightBoundingBox( class ON_BoundingBox& tight_bbox, bool bGrowBox = false, const class ON_Xform* xform = nullptr ) const override; // virtual ON_Geometry GetBBox override bool GetBBox( double* boxmin, double* boxmax, bool bGrowBox = false ) const override; // virtual ON_Geometry::Transform() override bool Transform( const ON_Xform& ) override; // virtual ON_Geometry::SwapCoordinates() override bool SwapCoordinates( int, int // indices of coordinates to swap ) override; // virtual ON_Geometry::HasBrepForm() override bool HasBrepForm() const override; // returns true /* Description: If possible, BrepForm() creates a brep form of the ON_Geometry. Parameters: brep - [in] if not nullptr, brep is used to store the brep form of the geometry. Result: If brep is not nullptr, then brep = this, otherwise a duplicate of this is returned. Remarks: Override of virtual ON_Geometry::BrepForm */ ON_Brep* BrepForm( ON_Brep* brep = nullptr ) const override; ///////////////////////////////////////////////////////////////// // Creation Interface // These add a new geometry piece to the b-rep and return the // index that should be used to reference the geometry. // -1 is returned if the input is not acceptable. // ~ON_Brep() will delete the geometry. int AddTrimCurve( ON_Curve* ); // 2d curve used by ON_BrepTrim int AddEdgeCurve( ON_Curve* ); // 3d curve used by ON_BrepEdge int AddSurface( ON_Surface* ); // 3d surface used by ON_BrepFace // Description: // Set 3d curve geometry used by a b-rep edge. // Parameters: // edge - [in] // c3_index - [in] index of 3d curve in m_C3[] array // sub_domain - [in] if not nullptr, sub_domain is an increasing // sub interval of m_C3[c3_index]->Domain(). // Returns: // true if successful. bool SetEdgeCurve( ON_BrepEdge& edge, int c3_index, const ON_Interval* sub_domain = nullptr ); // Description: // Set 2d curve geometry used by a b-rep trim. // Parameters: // trim - [in] // c2_index - [in] index of 2d curve in m_C2[] array // sub_domain - [in] if not nullptr, sub_domain is an increasing // sub interval of m_C2[c2_index]->Domain(). // Returns: // true if successful. bool SetTrimCurve( ON_BrepTrim& trim, int c2_index, const ON_Interval* sub_domain = nullptr ); // These add a new topology piece to the b-rep and return a // reference that is intended to be used for initialization. ON_BrepVertex& NewVertex(); ON_BrepVertex& NewVertex( ON_3dPoint vertex_point, double vertex_tolerance = ON_UNSET_VALUE ); ON_BrepEdge& NewEdge( int = -1 // 3d curve index ); ON_BrepEdge& NewEdge( ON_BrepVertex&, // start vertex ON_BrepVertex&, // end vertex int = -1, // 3d curve index const ON_Interval* = nullptr, // sub_domain double edge_tolerance = ON_UNSET_VALUE ); /* Description: Add a new face to a brep. An incomplete face is added. The caller must create and fill in the loops used by the face. Parameters: si - [in] index of surface in brep's m_S[] array Returns: Reference to new face. Remarks: Adding a new face may grow the dynamic m_F array. When this happens pointers and references to memory in the previous m_F[] array may become invalid. Use face indices if this is an issue. Example: See ON_BrepBox and ON_BrepSphere source code. See Also: ON_Brep::AddSurface */ ON_BrepFace& NewFace( int si = -1 ); /* Description: Add a new face to a brep. This creates a complete face with new vertices at the surface corners, new edges along the surface boundary, etc. The loop of the returned face has four trims that correspond to the south, east, north, and west side of the surface in that order. If you use this version of NewFace to add an exiting brep, then you are responsible for using a tool like ON_Brep::JoinEdges() to hook the new face to its neighbors. Parameters: surface - [in] surface is copied. Returns: Pointer to new face. Remarks: Adding a new face may grow the dynamic arrays used to store vertices, edges, faces, loops, and trims. When these dynamic arrays are grown, any pointers and references to memory in the previous arrays may become invalid. Use indices if this is an issue. See Also: ON_Brep::JoinEdges ON_Brep::AddSurface */ ON_BrepFace* NewFace( const ON_Surface& surface ); /* Description: Add a new face to brep. This version is for expert users. Parameters: pSurface - [in] the returned face will have an outer loop that goes around the edges of the surface. vid - [in/out] four vertex indices that specify the vertices at the (sw,se,nw,ne) corners. If the input value of a vertex index is -1, then the vertex will be created. eid - [in/out] four edge indices that specify the edges for the (south,east,north,west) sides. If the input value of an edge index is -1, then the edge will be created. bRev3d - [in/out] four values of the trim m_bRev3d flags of the (south,east,north,west) sides. Returns: Pointer to the new face or nullptr if input is not valid. If null is returned, then the caller must delete pSurace unless it was previously added to the brep's m_S[] array. Remarks: Adding a new face may grow the dynamic m_F array. When this happens pointers and references to memory in the previous m_F[] array may become invalid. Use face indices if this is an issue. Example: See ON_BrepBox and ON_BrepSphere source code. See Also: ON_Brep::AddSurface ON_Brep::AddFace( int si ) ON_Brep::Create( ON_Surface*& ) */ ON_BrepFace* NewFace( ON_Surface* pSurface, int vid[4], int eid[4], bool bRev3d[4] ); /* Description: Add a new face to the brep whose surface geometry is a ruled surface between two edges. Parameters: edgeA - [in] The south side of the face's surface will run along edgeA. bRevEdgeA - [in] true if the new face's outer boundary orientation along edgeA is opposite the orientation of edgeA. edgeB - [in] The north side of the face's surface will run along edgeA. bRevEdgeB - [in] true if the new face's outer boundary orientation along edgeB is opposite the orientation of edgeB. Returns: A pointer to the new face or a nullptr if the new face could not be created. */ ON_BrepFace* NewRuledFace( const ON_BrepEdge& edgeA, bool bRevEdgeA, const ON_BrepEdge& edgeB, bool bRevEdgeB ); /* Description: Add a new face to the brep whose surface geometry is a ruled cone with the edge as the base and the vertex as the apex point. Parameters: vertex - [in] The apex of the cone will be at this vertex. The north side of the surface's parameter space will be a singular point at the vertex. edge - [in] The south side of the face's surface will run along this edge. bRevEdge - [in] true if the new face's outer boundary orientation along the edge is opposite the orientation of edge. Returns: A pointer to the new face or a nullptr if the new face could not be created. */ ON_BrepFace* NewConeFace( const ON_BrepVertex& vertex, const ON_BrepEdge& edge, bool bRevEdge ); /* Description: Create a new empty boundary loop. The new loop will not be part of a face and will not include any trim curves. Returns: New boundary loop. */ ON_BrepLoop& NewLoop( ON_BrepLoop::TYPE ); /* Description: Create a new boundary loop on a face. After you get this ON_BrepLoop, you still need to create the vertices, edges, and trims that define the loop. Returns: New loop that needs to be filled in. */ ON_BrepLoop& NewLoop( ON_BrepLoop::TYPE loop_type, ON_BrepFace& face ); /* Description: Create a new outer boundary loop that runs along the sides of the face's surface. All the necessary trims, edges, and vertices are created and added to the brep. Parameters: face_index - [in] index of face that needs an outer boundary that runs along the sides of its surface. Returns: New outer boundary loop that is complete. */ ON_BrepLoop* NewOuterLoop( int face_index ); /* Description: Add a new face to brep. This version is for expert users. Parameters: face_index - [in] index of face that will get a new outer loop running around the sides of the face's underlying surface. vid - [in/out] four vertex indices that specify the vertices at the (sw,se,nw,ne) corners. If the input value of a vertex index is -1, then the vertex will be created. eid - [in/out] four edge indices that specify the edges for the (south,east,north,west) sides. If the input value of an edge index is -1, then the edge will be created. bRev3d - [in/out] four values of the trim m_bRev3d flags of the (south,east,north,west) sides. Returns: Pointer to the new loop or nullptr if input is not valid. Remarks: Adding a new loop may grow the dynamic m_L array. When this happens pointers and references to memory in the previous m_L[] array may become invalid. Use face indices if this is an issue. See Also: ON_Brep::NewFace */ ON_BrepLoop* NewOuterLoop( int face_index, int vid[4], int eid[4], bool bRev3d[4] ); /* Description: Add a planar trimming loop to a planar face. Parameters: face_index - [in] index of planar face. The underlying surface must be an ON_PlaneSurface. loop_type - [in] type of loop to add. If loop_type is ON_BrepLoop::unknown, then the loop direction is tested and the the new loops type will be set to ON_BrepLoop::outer or ON_BrepLoop::inner. If the loop_type is ON_BrepLoop::outer, then the direction of the new loop is tested and flipped if it is clockwise. If the loop_type is ON_BrepLoop::inner, then the direction of the new loop is tested and flipped if it is counter-clockwise. boundary - [in] a list of 3d curves that form a simple (no self intersections) closed curve. These curves define the 3d edge geometry and should be near the planar surface. bDuplicateCurves - [in] If true, then duplicates of the curves in the boundary array are added to the brep. If false, the curves in the boundary array are added to the brep and will be deleted by ON_Brep::~ON_Brep. Returns: true if successful. The new loop will be brep.m_L.Last(). */ bool NewPlanarFaceLoop( int face_index, ON_BrepLoop::TYPE loop_type, ON_SimpleArray& boundary, bool bDuplicateCurves = true ); /* Description: Add a new trim that will be part of an inner, outer, or slit loop to the brep. Parameters: c2i - [in] index of 2d trimming curve Returns: new trim Example: int c2i = brep->AddTrimCurve( p2dCurve ); ON_BrepTrim& trim = NewTrim( edge, bRev3d, loop, c2i ); trim.m_ei = ...; trim.m_li = ...; trim.m_tolerance[0] = ...; trim.m_tolerance[1] = ...; trim.m_type = ...; trim.m_iso = ...; Remarks: You should set the trim's ON_BrepTrim::m_tolerance, ON_BrepTrim::m_type, ON_BrepTrim::m_iso, ON_BrepTrim::m_li, and ON_BrepTrim::m_ei values. In general, you should try to use the ON_BrepTrim::NewTrim( edge, bRev3d, loop, c2i ) version of NewTrim. If you want to add a singular trim, use ON_Brep::NewSingularTrim. If you want to add a crvonsrf trim, use ON_Brep::NewCurveOnFace. If you want to add a ptonsrf trim, use ON_Brep::NewPointOnFace. See Also: ON_Brep::SetTrimTypeFlags ON_Brep::SetTrimIsoFlags ON_Brep::NewSingularTrim ON_Brep::NewPointOnFace ON_Brep::NewCurveOnFace */ ON_BrepTrim& NewTrim( int c2i = -1 ); /* Description: Add a new trim that will be part of an inner, outer, or slit loop to the brep. Parameters: bRev3d - [in] ON_BrepTrim::m_bRev3d value. true if the edge and trim have opposite directions. loop - [in] trim is appended to this loop c2i - [in] index of 2d trimming curve Returns: new trim Example: int c2i = brep->AddTrimCurve( p2dCurve ); ON_BrepTrim& trim = NewTrim( edge, bRev3d, loop, c2i ); trim.m_ei = ...; trim.m_tolerance[0] = ...; trim.m_tolerance[1] = ...; trim.m_type = ...; trim.m_iso = ...; Remarks: You should set the trim's ON_BrepTrim::m_tolerance, ON_BrepTrim::m_type, ON_BrepTrim::m_iso, and ON_BrepTrim::m_ei values. In general, you should try to use the ON_BrepTrim::NewTrim( edge, bRev3d, loop, c2i ) version of NewTrim. If you want to add a singular trim, use ON_Brep::NewSingularTrim. If you want to add a crvonsrf trim, use ON_Brep::NewCurveOnFace. If you want to add a ptonsrf trim, use ON_Brep::NewPointOnFace. See Also: ON_Brep::SetTrimTypeFlags ON_Brep::SetTrimIsoFlags ON_Brep::NewSingularTrim ON_Brep::NewPointOnFace ON_Brep::NewCurveOnFace */ ON_BrepTrim& NewTrim( bool bRev3d, ON_BrepLoop& loop, int c2i = -1 ); /* Description: Add a new trim that will be part of an inner, outer, or slit loop to the brep. Parameters: edge - [in] 3d edge associated with this trim bRev3d - [in] ON_BrepTrim::m_bRev3d value. true if the edge and trim have opposite directions. c2i - [in] index of 2d trimming curve Returns: new trim Example: int c2i = brep->AddTrimCurve( p2dCurve ); ON_BrepTrim& trim = NewTrim( edge, bRev3d, c2i ); trim.m_li = ...; trim.m_tolerance[0] = ...; trim.m_tolerance[1] = ...; trim.m_type = ...; trim.m_iso = ...; Remarks: You should set the trim's ON_BrepTrim::m_tolerance, ON_BrepTrim::m_type, ON_BrepTrim::m_iso, and ON_BrepTrim::m_li values. In general, you should try to use the ON_BrepTrim::NewTrim( edge, bRev3d, loop, c2i ) version of NewTrim. If you want to add a singular trim, use ON_Brep::NewSingularTrim. If you want to add a crvonsrf trim, use ON_Brep::NewCurveOnFace. If you want to add a ptonsrf trim, use ON_Brep::NewPointOnFace. See Also: ON_Brep::SetTrimTypeFlags ON_Brep::SetTrimIsoFlags ON_Brep::NewSingularTrim ON_Brep::NewPointOnFace ON_Brep::NewCurveOnFace */ ON_BrepTrim& NewTrim( ON_BrepEdge& edge, bool bRev3d, int c2i = -1 ); /* Description: Add a new trim that will be part of an inner, outer, or slit loop to the brep. Parameters: edge - [in] 3d edge associated with this trim bRev3d - [in] ON_BrepTrim::m_bRev3d value. true if the edge and trim have opposite directions. loop - [in] trim is appended to this loop c2i - [in] index of 2d trimming curve Returns: new trim Example: int c2i = brep->AddTrimCurve( p2dCurve ); ON_BrepTrim& trim = brep->NewTrim( edge, bRev3d, loop, c2i ); trim.m_tolerance[0] = ...; trim.m_tolerance[1] = ...; Remarks: You should set the trim's ON_BrepTrim::m_tolerance values. If c2i is -1, you must set the trim's ON_BrepTrim::m_iso values. This version of NewTrim sets the trim.m_type value. If the input edge or loop are not currently valid, then you may need to adjust the trim.m_type value. If you want to add a singular trim, use ON_Brep::NewSingularTrim. If you want to add a crvonsrf trim, use ON_Brep::NewCurveOnFace. If you want to add a ptonsrf trim, use ON_Brep::NewPointOnFace. See Also: ON_Brep::SetTrimTypeFlags ON_Brep::SetTrimIsoFlags ON_Brep::NewSingularTrim ON_Brep::NewPointOnFace ON_Brep::NewCurveOnFace */ ON_BrepTrim& NewTrim( ON_BrepEdge& edge, bool bRev3d, ON_BrepLoop& loop, int c2i = -1 ); /* Description: Add a new singular trim to the brep. Parameters: vertex - [in] vertex along collapsed surface edge loop - [in] trim is appended to this loop iso - [in] one of ON_Surface::S_iso, ON_Surface::E_iso, ON_Surface::N_iso, or ON_Surface::W_iso. c2i - [in] index of 2d trimming curve Returns: new trim See Also: ON_Brep::NewTrim */ ON_BrepTrim& NewSingularTrim( const ON_BrepVertex& vertex, ON_BrepLoop& loop, ON_Surface::ISO iso, int c2i = -1 ); /* Description: Adds a new point on face to the brep. Parameters: face - [in] face that vertex lies on s,t - [in] surface parameters Returns: new vertex that represents the point on face. Remarks: If a vertex is a point on a face, then brep.m_E[m_ei] will be an edge with no 3d curve. This edge will have a single trim with type ON_BrepTrim::ptonsrf. There will be a loop containing this single trim. */ ON_BrepVertex& NewPointOnFace( ON_BrepFace& face, double s, double t ); /* Description: Add a new curve on face to the brep. Parameters: face - [in] face that curve lies on edge - [in] 3d edge associated with this curve on surface bRev3d - [in] true if the 3d edge and the 2d parameter space curve have opposite directions. c2i - [in] index of 2d curve in face's parameter space Returns: new trim that represents the curve on surface Remarks: You should set the trim's ON_BrepTrim::m_tolerance and ON_BrepTrim::m_iso values. */ ON_BrepTrim& NewCurveOnFace( ON_BrepFace& face, ON_BrepEdge& edge, bool bRev3d = false, int c2i = -1 ); // appends a copy of brep to this and updates // indices of appended brep parts. Duplicates are not removed. void Append( const ON_Brep& // brep ); // This function can be used to compute vertex information for a // b-rep when everything but the m_V array is properly filled in. // It is intended to be used when creating a ON_Brep from a // definition that does not include explicit vertex information. void SetVertices(void); // This function can be used to set the ON_BrepTrim::m_iso // flag. It is intended to be used when creating a ON_Brep from // a definition that does not include compatible parameter space // type information. // See Also: ON_BrepSetFlagsAndTolerances bool SetTrimIsoFlags(); // sets all trim iso flags bool SetTrimIsoFlags( ON_BrepFace& ); bool SetTrimIsoFlags( ON_BrepLoop& ); bool SetTrimIsoFlags( ON_BrepTrim& ); /* Description: Calculate the type (singular, mated, boundary, etc.) of an ON_BrepTrim object. Parameters: trim - [in] bLazy - [in] if true and trim.m_type is set to something other than ON_BrepTrim::unknown, then no calculation is performed and the value of trim.m_type is returned. If false, the value of trim.m_type is ignored and is calculated. Returns: Type of trim. Remarks: The trim must be connected to a valid loop. See Also: ON_Brep::SetTrimTypeFlags */ ON_BrepTrim::TYPE TrimType( const ON_BrepTrim& trim, bool bLazy = true ) const; // This function can be used to set the ON_BrepTrim::m_type // flag. If the optional bLazy argument is true, then only // trims with m_type = unknown are set. // See Also: ON_BrepSetFlagsAndTolerances bool SetTrimTypeFlags( bool bLazy = false ); // sets all trim iso flags bool SetTrimTypeFlags( ON_BrepFace&, bool bLazy = false ); bool SetTrimTypeFlags( ON_BrepLoop&, bool bLazy = false ); bool SetTrimTypeFlags( ON_BrepTrim&, bool bLazy = false ); // GetTrim2dStart() evaluates the start of the // parameter space (2d) trim curve. bool GetTrim2dStart( int trim_index, // index of ON_BrepTrim in m_T[] array ON_2dPoint& ) const; // GetTrim2dEnd() evaluates end of the // parameter space (2d) trim curve. bool GetTrim2dEnd( int, // index of ON_BrepTrim in m_T[] array ON_2dPoint& ) const; // GetTrim3dStart() evaluates the 3d surface at the start of the // parameter space (2d) trim curve. bool GetTrim3dStart( int, // index of ON_BrepTrim in m_T[] array ON_3dPoint& ) const; // GetTrim3dEnd() evaluates the 3d surface at the end of the // parameter space (2d) trim curve. bool GetTrim3dEnd( int, // index of ON_BrepTrim in m_T[] array ON_3dPoint& ) const; // This function examines the 2d parameter space curves and returns // the loop's type based on their orientation. Use this function for // debugging loop orientation problems. ON_BrepLoop::TYPE ComputeLoopType( const ON_BrepLoop& ) const; // These set the various tolerances. The optional bool argument // is called bLazy. If bLazy is false, the tolerance is recomputed // from its definition. If bLazy is true, the tolerance is computed // only if its current value is negative. bool SetVertexTolerance( ON_BrepVertex& vertex, bool bLazy = false ) const; virtual bool SetTrimTolerance( ON_BrepTrim& trim, bool bLazy = false ) const; virtual bool SetEdgeTolerance( ON_BrepEdge& edge, bool bLazy = false ) const; /* Description: Set the brep's vertex tolerances. Parameters: bLazy - [in] if true, only vertex tolerances with the value ON_UNSET_VALUE will be set. If false, the vertex tolerance is recomputed from the geometry in the brep. Returns: true if successful. See Also: ON_Brep::SetVertexTolerance ON_Brep::SetTrimTolerance ON_Brep::SetEdgeTolerance ON_Brep::SetVertexTolerances ON_Brep::SetTrimTolerances ON_Brep::SetEdgeTolerances ON_Brep::SetTolerancesAndFlags */ bool SetVertexTolerances( bool bLazy = false ); /* Description: Set the brep's trim tolerances. Parameters: bLazy - [in] if true, only trim tolerances with the value ON_UNSET_VALUE will be set. If false, the trim tolerance is recomputed from the geometry in the brep. Returns: true if successful. See Also: ON_Brep::SetVertexTolerance ON_Brep::SetTrimTolerance ON_Brep::SetEdgeTolerance ON_Brep::SetVertexTolerances ON_Brep::SetTrimTolerances ON_Brep::SetEdgeTolerances ON_Brep::SetTolerancesAndFlags */ bool SetTrimTolerances( bool bLazy = false ); /* Description: Set the brep's edge tolerances. Parameters: bLazy - [in] if true, only edge tolerances with the value ON_UNSET_VALUE will be set. If false, the edge tolerance is recomputed from the geometry in the brep. Returns: true if successful. See Also: ON_Brep::SetVertexTolerance ON_Brep::SetTrimTolerance ON_Brep::SetEdgeTolerance ON_Brep::SetVertexTolerances ON_Brep::SetTrimTolerances ON_Brep::SetEdgeTolerances ON_Brep::SetTolerancesAndFlags */ bool SetEdgeTolerances( bool bLazy = false ); /* Description: Set the trim parameter space bounding box (trim.m_pbox). Parameters: trim - [in] bLazy - [in] if true and trim.m_pbox is valid, then the box is not set. Returns: true if trim ends up with a valid bounding box. */ virtual bool SetTrimBoundingBox( ON_BrepTrim& trim, bool bLazy=false ); /* Description: Set the loop parameter space bounding box (loop.m_pbox). Parameters: loop - [in] bLazy - [in] if true and loop trim trim.m_pbox is valid, then that trim.m_pbox is not recalculated. Returns: true if loop ends up with a valid bounding box. */ virtual bool SetTrimBoundingBoxes( ON_BrepLoop& loop, bool bLazy=false ); /* Description: Set the loop and trim parameter space bounding boxes for every loop and trim in the face Parameters: face - [in] bLazy - [in] if true and trim trim.m_pbox is valid, then that trim.m_pbox is not recalculated. Returns: true if all the face's loop and trim parameter space bounding boxes are valid. */ virtual bool SetTrimBoundingBoxes( ON_BrepFace& face, bool bLazy=false ); /* Description: Set the loop and trim parameter space bounding boxes for every loop and trim in the brep. Parameters: bLazy - [in] if true and trim trim.m_pbox is valid, then that trim.m_pbox is not recalculated. Returns: true if all the loop and trim parameter space bounding boxes are valid. */ virtual bool SetTrimBoundingBoxes( bool bLazy=false ); /* Description: Set tolerances and flags in a brep Parameters: bLazy - [in] if true, only flags and tolerances that are not set will be calculated. bSetVertexTolerances - [in] true to compute vertex.m_tolerance values bSetEdgeTolerances - [in] true to compute edge.m_tolerance values bSetTrimTolerances - [in] true to compute trim.m_tolerance[0,1] values bSetTrimIsoFlags - [in] true to compute trim.m_iso values bSetTrimTypeFlags - [in] true to compute trim.m_type values bSetLoopTypeFlags - [in] true to compute loop.m_type values bSetTrimBoxes - [in] true to compute trim.m_pbox values See Also: ON_Brep::SetVertexTolerance ON_Brep::SetEdgeTolerance ON_Brep::SetTrimTolerance ON_Brep::SetTrimTypeFlags ON_Brep::SetTrimIsoFlags ON_Brep::ComputeLoopType ON_Brep::SetTrimBoundingBox ON_Brep::SetTrimBoundingBoxes */ void SetTolerancesBoxesAndFlags( bool bLazy = false, bool bSetVertexTolerances = true, bool bSetEdgeTolerances = true, bool bSetTrimTolerances = true, bool bSetTrimIsoFlags = true, bool bSetTrimTypeFlags = true, bool bSetLoopTypeFlags = true, bool bSetTrimBoxes = true ); ///////////////////////////////////////////////////////////////// // Query Interface /* Description: Determine how many brep faces reference m_S[surface_index]. Parameters: surface_index - [in] index of the surface in m_S[] array max_count - [in] counting stops if max_count > 0 and at least max_count faces use the surface. Returns: Number of brep faces that reference the surface. */ int SurfaceUseCount( int surface_index, int max_count=0 ) const; /* Description: Determine how many brep edges reference m_C3[c3_index]. Parameters: c3_index - [in] index of the 3d curve in m_C3[] array max_count - [in] counting stops if max_count > 0 and at least max_count edges use the 3d curve. Returns: Number of brep edges that reference the 3d curve. */ int EdgeCurveUseCount( int c3_index, int max_count=0 ) const; /* Description: Determine how many brep trims reference m_C2[c2_index]. Parameters: c2_index - [in] index of the 2d curve in m_C2[] array max_count - [in] counting stops if max_count > 0 and at least max_count trims use the 2d curve. Returns: Number of brep trims that reference the 2d curve. */ int TrimCurveUseCount( int c2_index, int max_count=0 ) const; /* Description: Get a single 3d curve that traces the entire loop Parameters: loop - [in] loop whose 3d curve should be duplicated bRevCurveIfFaceRevIsTrue - [in] If false, the returned 3d curve has an orientation compatible with the 2d curve returned by Loop2dCurve(). If true and the m_bRev flag of the loop's face is true, then the returned curve is reversed. Returns: A pointer to a 3d ON_Curve. The caller must delete this curve. */ ON_Curve* Loop3dCurve( const ON_BrepLoop& loop, bool bRevCurveIfFaceRevIsTrue = false ) const; /* Description: Get a list of 3d curves that trace the non-seam edge portions of an entire loop Parameters: loop - [in] loop whose 3d curve should be duplicated curve_list - [out] 3d curves are appended to this list bRevCurveIfFaceRevIsTrue - [in] If false, the returned 3d curves have an orientation compatible with the 2d curve returned by Loop2dCurve(). If true and the m_bRev flag of the loop's face is true, then the returned curves are reversed. Returns: Number of curves appended to curve_list. */ int Loop3dCurve( const ON_BrepLoop& loop, ON_SimpleArray& curve_list, bool bRevCurveIfFaceRevIsTrue = false ) const; /* Description: Get a 3d curve that traces the entire loop Parameters: loop - [in] loop whose 2d curve should be duplicated Returns: A pointer to a 2d ON_Curve. The caller must delete this curve. */ ON_Curve* Loop2dCurve( const ON_BrepLoop& loop ) const; /* Description: Determine orientation of a brep. Returns: @untitle table +2 brep is a solid but orientation cannot be computed +1 brep is a solid with outward facing normals -1 brep is a solid with inward facing normals 0 brep is not a solid Remarks: The base class implementation returns 2 or 0. This function is overridden in the Rhino SDK and returns +1, -1, or 0. See Also: ON_Brep::IsSolid */ virtual int SolidOrientation() const; /* Description: Test brep to see if it is a solid. (A "solid" is a closed oriented manifold.) Returns: If the brep is a solid, true is returned. Otherwise false is returned. See Also: ON_Brep::SolidOrientation ON_Brep::IsManifold */ bool IsSolid() const; /* Description: Test brep to see if it is an oriented manifold. Parameters: pbIsOriented - [in] if not null, *pbIsOriented is set to true if b-rep is an oriented manifold and false if brep is not an oriented manifold. pbHasBoundary - [in] if not null, *pbHasBoundary is set to true if b-rep has a boundary edge and false if brep does not have a boundary edge. Returns: If the brep is a manifold, true is returned. Otherwise false is returned. See Also: ON_Brep::IsSolid */ bool IsManifold( // returns true if b-rep is an oriented manifold bool* pbIsOriented = nullptr, bool* pbHasBoundary = nullptr ) const; /* Description: When an expert is 100% certain of a brep's solid orientation, this function can be used to set the SolidOrientation() property. Parameters: solid_orientation - [in] 0: not solid, 1: oriented manifold solid (no boundary) with outward facing normals. -1: oriented manifold solid (no boundary) with inward facing normals. */ void SetSolidOrientationForExperts( int solid_orientation ); /* Description: Determine if P is inside Brep. This question only makes sense when the brep is a closed manifold. This function does not not check for closed or manifold, so result is not valid in those cases. Intersects a line through P with brep, finds the intersection point Q closest to P, and looks at face normal at Q. If the point Q is on an edge or the intersection is not transverse at Q, then another line is used. Parameters: P - [in] 3d point tolerance - [in] 3d distance tolerance used for intersection and determining strict inclusion. bStrictlInside - [in] If bStrictlInside is true, then this function will return false if the distance from P is within tolerance of a brep face. Returns: True if P is in, false if not. See parameter bStrictlyIn. */ bool IsPointInside( ON_3dPoint P, double tolerance, bool bStrictlyInside ) const; bool IsSurface() const; // returns true if the b-rep has a single face // and that face is geometrically the same // as the underlying surface. I.e., the face // has trivial trimming. In this case, the // surface is m_S[0]. // The flag m_F[0].m_bRev records // the correspondence between the surface's // natural parametric orientation and the // orientation of the b-rep. bool FaceIsSurface( // returns true if the face has a single int // index of face // outer boundary and that boundary runs ) const; // along the edges of the underlying surface. // In this case the geometry of the surface // is the same as the geometry of the face. // If FaceIsSurface() is true, then // m_S[m_F[face_index].m_si] is the surface. // The flag m_F[face_index].m_bRev records // the correspondence between the surface's // natural parametric orientation and the // orientation of face in the b-rep. bool LoopIsSurfaceBoundary( // returns true if the loop's trims all run int // index of loop // along the edge's of the underlying surface's ) const; // parameter space. ///////////////////////////////////////////////////////////////// // Modification Interface ////////// // Clears all ON_BrepFace.m_bRev flags by ON_BrepFace::Transpose // on each face with a true m_bRev. bool FlipReversedSurfaces(); ////////// // Change the domain of a trim's 2d curve. This changes only the // parameterization of the 2d trimming curve; the locus of the // 2d trimming curve is not changed. bool SetTrimDomain( int, // index of trim in m_T[] array const ON_Interval& ); ////////// // Change the domain of an edge. This changes only the // parameterization of the 3d edge curve; the locus of the // 3d edge curve is not changed. bool SetEdgeDomain( int, // index of edge in m_E[] array const ON_Interval& ); // Reverses entire brep orientation of all faces by toggling // value of all face's ON_BrepFace::m_bRev flag. void Flip(); // reverses orientation of a face by toggling ON_BrepFace::m_bRev void FlipFace(ON_BrepFace&); // Reverses orientation of trimming loop. // This function is intended to be used by brep experts and does // does NOT modify ON_BrepLoop::m_type. You should make sure // ON_BrepLoop::m_type jibes with the loop's direction. (Outer loops // should be counter-clockwise and inner loops should be clockwise.) // You can use ON_Brep::LoopDirection() to determine the direction of // a loop. void FlipLoop(ON_BrepLoop&); // reverses orientation of trimming loop // LoopDirection() examines the 2d trimming curve geometry that defines // the loop and returns // // @untitled table // +1 the loop is a counter-clockwise loop. // -1 the loop is a clockwise loop. // 0 the loop is not a continuous closed loop. // // Since LoopDirection() calculates its result based on the 2d trimming // curve geometry, it can be use to set ON_BrepLoop::m_type to outer/inner // when translating from data definition where this distinction is murky. int LoopDirection( const ON_BrepLoop& ) const; /* Description: Sort the face.m_li[] array by loop type (outer, inner, slit, crvonsrf, ptonsrf) Parameters: face - [in/out] face whose m_li[] array should be sorted. Returns: @untitled table true success false failure - no loops or loops with unset loop.m_type See Also: ON_Brep::ComputeLoopType ON_Brep::LoopDirection */ bool SortFaceLoops( ON_BrepFace& face ) const; /* Description: Expert user function. Turn an edge into a series of naked or seam edges. One for each trim at the original edge that comes from a unique face. These edges will share the 3d curve of the original edge. The original edge will still be valid and will have m_ti[0] unchanged. */ bool DisconnectEdgeFaces(int eid); /* Description: Expert user function. See Also: ON_Brep::JoinEdges */ bool CombineCoincidentVertices(ON_BrepVertex&, ON_BrepVertex&); // moves information to first vertex and deletes second /* Description: Expert user function. See Also: ON_Brep::JoinEdges */ bool CombineCoincidentEdges(ON_BrepEdge&, ON_BrepEdge&); // moves information to first edge and deletes second /* Description: Expert user function. Combines contiguous edges into a single edge. The edges must share a common vertex, then angle between the edge tangents are the common vertex must be less than or equal to angle_tolerance_radians, and any associated trims must be contiguous in there respective boundaries. Parameters; edge_index0 - [in] edge_index1 - [in] angle_tolerance_radians - [in] Returns: Pointer to the new edge or nullptr if the edges cannot be combined into a single edge. Remarks: The input edges are deleted but are still in the brep's m_E[] arrays. Use ON_Brep::Compact to remove the unused edges. */ ON_BrepEdge* CombineContiguousEdges( int edge_index0, int edge_iindex1, double angle_tolerance_radians = ON_PI/180.0 ); // These remove a topology piece from a b-rep but do not // rearrange the arrays that hold the brep objects. The // deleted objects have their indices set to -1. Deleting // an object that is connected to other objects will // modify those objects. void DeleteVertex(ON_BrepVertex& vertex); void DeleteEdge(ON_BrepEdge& edge, bool bDeleteEdgeVertices); // pass true to delete vertices used only by edge void DeleteTrim(ON_BrepTrim& trim, bool bDeleteTrimEdges); // pass true to delete edges and vertices used only by trim void DeleteLoop(ON_BrepLoop& loop, bool bDeleteLoopEdges); // pass true to delete edges and vertices used only by trim void DeleteFace(ON_BrepFace& face, bool bDeleteFaceEdges); // pass true to delete edges and vertices used only by face void DeleteSurface(int s_index); void Delete2dCurve(int c2_index); void Delete3dCurve(int c3_index); // Description: // Set m_vertex_user.i, m_edge_user.i, m_face_user.i, m_loop_user.i, // and m_trim_user.i values of faces of component including // m_F[face_index] to label. Numbering starts at 1. // Parameters: // face_index - [in] index of face in component // label - [in] value for m_*_user.i // Returns: // Remarks: // Chases through trim lists of face edges to find adjacent faces. // Does NOT check for vertex-vertex connections void LabelConnectedComponent( int face_index, int label ) const; /* Description: Set m_vertex_user.i, m_edge_user.i, m_face_user.i, m_loop_user.i, and m_trim_user.i values values to distinguish connected components. Parameters: Returns: number of connected components Remarks: For each face in the i-th component, sets m_face_user.i to i>0. Chases through trim lists of face edges to find adjacent faces. Numbering starts at 1. Does NOT check for vertex-vertex connections. See Also: ON_Brep::GetConnectedComponents */ int LabelConnectedComponents() const; /* Description: If this brep has two or more connected components, then duplicates of the connected components are appended to the components[] array. Parameters: components - [out] connected components are appended to this array. bDuplicateMeshes - [in] if true, any meshes on this brep are copied to the output breps. Returns: Number of connected components appended to components[] or zero if this brep has only one connected component. See Also: ON_Brep::GetConnectedComponents */ int GetConnectedComponents( ON_SimpleArray< ON_Brep* >& components, bool bDuplicateMeshes ) const; /* Description: Copy a subset of this brep. Parameters: subfi_count - [in] length of sub_fi[] array. sub_fi - [in] array of face indices in this brep to copy. (If any values inf sub_fi[] are out of range or if sub_fi[] contains duplicates, this function will return null.) sub_brep - [in] if this pointer is not null, then the sub-brep will be created in this class. Returns: If the input is valid, a pointer to the sub-brep is returned. If the input is not valid, null is returned. The faces in in the sub-brep's m_F array are in the same order as they were specified in sub_fi[]. */ ON_Brep* SubBrep( int subfi_count, const int* sub_fi, ON_Brep* sub_brep = 0 ) const; /////////////////////////////////////////////////////////////////////// // // region topology // bool HasRegionTopology() const; /* Description: Get region topology information: In order to keep the ON_Brep class efficient, rarely used region topology information is not maintained. If you require this information, call RegionTopology(). */ const ON_BrepRegionTopology& RegionTopology() const; /* Description: Destroy region topology information. */ void DestroyRegionTopology(); // Description: // Duplicate a single brep face. // Parameters: // face_index - [in] index of face to duplicate // bDuplicateMeshes - [in] if true, any attached meshes are duplicated // Returns: // Single face brep. // Remarks: // The m_vertex_user.i, m_edge_user.i, m_face_user.i, m_loop_user.i, // and m_trim_user.i values of the returned brep are are set to the // indices of the objects they duplicate. // See Also: // ON_Brep::DeleteFace, ON_Brep::ExtractFace ON_Brep* DuplicateFace( int face_index, bool bDuplicateMeshes ) const; // Description: // Duplicate a a subset of a brep // Parameters: // face_count - [in] length of face_index[] array // face_index - [in] array of face indices // bDuplicateMeshes - [in] if true, any attached meshes are duplicated // Returns: // A brep made by duplicating the faces listed in the face_index[] array. // Remarks: // The m_vertex_user.i, m_edge_user.i, m_face_user.i, m_loop_user.i, // and m_trim_user.i values of the returned brep are are set to the // indices of the objects they duplicate. // See Also: // ON_Brep::DuplicateFace ON_Brep* DuplicateFaces( int face_count, const int* face_index, bool bDuplicateMeshes ) const; // Description: // Extract a face from a brep. // Parameters: // face_index - [in] index of face to extract // Returns: // Single face brep. // See Also: // ON_Brep::DeleteFace, ON_Brep::DuplicateFace ON_Brep* ExtractFace( int face_index ); /* Description: Standardizes the relationship between an ON_BrepEdge and the 3d curve it uses. When done, the edge will be the only edge that references its 3d curve, the domains of the edge and 3d curve will be the same, and the edge will use the entire locus of the 3d curve. Parameters: edge_index - [in] index of edge to standardize. bAdjustEnds - [in] if true, move edge curve endpoints to vertices See Also: ON_Brep::StandardizeEdgeCurves ON_Brep::Standardize */ bool StandardizeEdgeCurve( int edge_index, bool bAdjustEnds ); /* Description: Expert user only. Same as above, but to be used when the edge curve use count is known for the edge. Standardizes the relationship between an ON_BrepEdge and the 3d curve it uses. When done, the edge will be the only edge that references its 3d curve, the domains of the edge and 3d curve will be the same, and the edge will use the entire locus of the 3d curve. Parameters: edge_index - [in] index of edge to standardize. bAdjustEnds - [in] if true, move edge curve endpoints to vertices EdgeCurveUse - [in] if > 1, then the edge curve for this edge is used by more than one edge. if 1, then the edge curve is used only for this edge. If <= 0, then use count is unknown. See Also: ON_Brep::StandardizeEdgeCurves ON_Brep::Standardize */ bool StandardizeEdgeCurve( int edge_index, bool bAdjustEnds, int EdgeCurveUse ); /* Description: Standardize all edges in the brep. Parameters: bAdjustEnds - [in] if true, move edge curve endpoints to vertices See Also: ON_Brep::StandardizeEdgeCurve ON_Brep::Standardize */ void StandardizeEdgeCurves( bool bAdjustEnds ); /* Description: Standardizes the relationship between an ON_BrepTrim and the 2d curve it uses. When done, the trim will be the only trim that references its 2d curve, the domains of the trim and 2d curve will be the same, and the trim will use the entire locus of the 2d curve. Parameters: trim_index - [in] index of trim to standardize. See Also: ON_Brep::StandardizeTrimCurves ON_Brep::Standardize */ bool StandardizeTrimCurve( int trim_index ); /* Description: Standardize all trims in the brep. See Also: ON_Brep::StandardizeTrimCurve ON_Brep::Standardize */ void StandardizeTrimCurves(); /* Description: Standardizes the relationship between an ON_BrepFace and the 3d surface it uses. When done, the face will be the only face that references its 3d surface, and the orientations of the face and 3d surface will be the same. Parameters: face_index - [in] index of face to standardize. See Also: ON_Brep::StardardizeFaceSurfaces ON_Brep::Standardize */ bool StandardizeFaceSurface( int face_index ); /* Description: Standardize all faces in the brep. See Also: ON_Brep::StandardizeFaceSurface ON_Brep::Standardize */ void StandardizeFaceSurfaces(); /* Description: Standardize all trims, edges, and faces in the brep. Remarks: After standardizing, there may be unused curves and surfaces in the brep. Call ON_Brep::Compact to remove these unused curves and surfaces. See Also: ON_Brep::StandardizeTrimCurves ON_Brep::StandardizeEdgeCurves ON_Brep::StandardizeFaceSurface ON_Brep::Compact */ void Standardize(); /* Description: Sometimes the ON_Surface used by a face extends far beyond the face's outer boundary. ShrinkSurface uses ON_Surface::Trim to remove portions of the surface that extend beyond the face's outer boundary loop. Parameters: face - [in] face to test and whose surface should be shrunk. DisableSide - [in] This is a bit field. A set bit indicates not to shrink the surface on a given side. The default of 0 enables shrinking on all four sides. @table value meaning 0x0001 Don't shrink on the west side of domain. 0x0002 Don't shrink on the south side of domain. 0x0004 Don't shrink on the east side of domain. 0x0008 Don't shrink on the north side of domain. Returns: @untitled table true successful false failure Remarks: If a surface needs to be shrunk it is copied. After shrinking, you may want to call ON_Brep::CullUnusedSurfaces to remove any unused surfaces. See Also: ON_Brep::ShrinkSurfaces ON_Brep::CullUnusedSurfaces */ bool ShrinkSurface( ON_BrepFace& face, int DisableSide=0 ); /* Description: Sometimes the ON_Surface used by a face extends far beyond the face's outer boundary. ShrinkSurfaces calls ON_Shrink::ShrinkSurface on each face to remove portions of surfaces that extend beyond their face's outer boundary loop. Returns: @untitled table true successful false failure Remarks: If a surface needs to be shrunk it is copied. After shrinking, you may want to call ON_Brep::CullUnusedSurfaces to remove any unused surfaces. See Also: ON_Brep::ShrinkSurface ON_Brep::CullUnusedSurfaces */ bool ShrinkSurfaces(); /* Description: Uses the CullUnused*() members to delete any unreferenced objects from arrays, reindexes as needed, and shrinks arrays to minimum required size. See Also: ON_Brep::CullUnusedFaces ON_Brep::CullUnusedLoops ON_Brep::CullUnusedTrims ON_Brep::CullUnusedEdges ON_Brep::CullUnusedVertices ON_Brep::CullUnused3dCurves ON_Brep::CullUnused2dCurves ON_Brep::CullUnusedSurfaces */ bool Compact(); bool CullUnusedFaces(); // culls faces with m_face_index == -1 bool CullUnusedLoops(); // culls loops with m_loop_index == -1 bool CullUnusedTrims(); // culls trims with m_trim_index == -1 bool CullUnusedEdges(); // culls edges with m_edge_index == -1 bool CullUnusedVertices(); // culls vertices with m_vertex_index == -1 bool CullUnused3dCurves(); // culls 2d curves not referenced by a trim bool CullUnused2dCurves(); // culls 3d curves not referenced by an edge bool CullUnusedSurfaces(); // culls surfaces not referenced by a face ///////////////////////////////////////////////////////////////// // Navigation Interface // for moving around loops - returns trim index of previous/next trim in loop int PrevTrim( int // index of current trim (m_trim_index) ) const; int NextTrim( int // index of current trim (m_trim_index) ) const; //Same as NextTrim and PrevTrim, but skips over trims with type singular int PrevNonsingularTrim( int // index of current trim (m_trim_index) ) const; int NextNonsingularTrim( int // index of current trim (m_trim_index) ) const; /* Description: This is a simple tool for getting running through the edges that begin and end at a vertex. Parameters: current_edge_index - [in] endi - [in] 0 = use the edge start vertex, 1 = use the edge end vertex prev_endi - [out] 0 if previous edge begins at the vertex, 1 if previous edge ends at the vertex Returns: edge index of the previous edge or -1 if there is only one edge that begins or ends at the vertex. Remarks: This is a tool that simplifies searching through the ON_BrepVertex.m_ei[] array. The edges are in no particular order. See Also: ON_Brep::NextEdge */ int PrevEdge( int current_edge_index, int endi, int* prev_endi = nullptr ) const; /* Description: This is a simple tool for getting running through the edges that begin and end at a vertex. Parameters: current_edge_index - [in] endi - [in] 0 = use the edge start vertex, 1 = use the edge end vertex next_endi - [out] 0 if next edge begins at the vertex, 1 if next edge ends at the vertex Returns: edge index of the next edge or -1 if there is only one edge that begins or ends at the vertex. Remarks: This is a tool that simplifies searching through the ON_BrepVertex.m_ei[] array. The edges are in no particular order. See Also: ON_Brep::NextEdge */ int NextEdge( int current_edge_index, int endi, int* next_endi = nullptr ) const; /* Description: Get a brep component from its index. Parameters: component_index - [in] Returns: A const pointer to the component. Do not delete the returned object. It points to an object managed by this brep. See Also: ON_Brep::Face ON_Brep::Edge ON_Brep::Loop ON_Brep::Trim ON_Brep::Vertex */ const ON_Geometry* BrepComponent( ON_COMPONENT_INDEX ci ) const; /* Description: Get vertex from trim index or component index. Parameters: vertex_index - [in] either an index into m_V[] or a component index of type brep_vertex. Returns: If the index is a valid vertex index or a valid vertex component index, then a pointer to the ON_BrepVertex is returned. Otherwise nullptr is returned. See Also ON_Brep::Component( const ON_BrepVertex& ) */ ON_BrepVertex* Vertex( int vertex_index ) const; ON_BrepVertex* Vertex( ON_COMPONENT_INDEX vertex_index ) const; /* Description: Get edge from edge index or component index. Parameters: edge_index - [in] either an index into m_E[] or a component index of type brep_edge. Returns: If the index is a valid edge index or a valid edge component index, then a pointer to the ON_BrepEdge is returned. Otherwise nullptr is returned. See Also ON_Brep::Component( const ON_BrepEdge& ) */ ON_BrepEdge* Edge( int edge_index ) const; ON_BrepEdge* Edge( ON_COMPONENT_INDEX edge_index ) const; /* Description: Get trim from trim index or component index. Parameters: trim_index - [in] either an index into m_T[] or a component index of type brep_trim. Returns: If the index is a valid trim index or a valid trim component index, then a pointer to the ON_BrepTrim is returned. Otherwise nullptr is returned. See Also ON_Brep::Component( const ON_BrepTrim& ) */ ON_BrepTrim* Trim( int trim_index ) const; ON_BrepTrim* Trim( ON_COMPONENT_INDEX trim_index ) const; /* Description: Get loop from loop index or component index. Parameters: loop_index - [in] either an index into m_L[] or a component index of type brep_loop. Returns: If the index is a valid loop index or a valid loop component index, then a pointer to the ON_BrepLoop is returned. Otherwise nullptr is returned. See Also ON_Brep::Component( const ON_BrepLoop& ) */ ON_BrepLoop* Loop( int loop_index ) const; ON_BrepLoop* Loop( ON_COMPONENT_INDEX loop_index ) const; /* Description: Get face from face index or component index. Parameters: face_index - [in] either an index into m_F[] or a component index of type brep_face. Returns: If the index is a valid face index or a valid face component index, then a pointer to the ON_BrepFace is returned. Otherwise nullptr is returned. See Also ON_Brep::Component( const ON_BrepFace& ) */ ON_BrepFace* Face( int face_index ) const; ON_BrepFace* Face( ON_COMPONENT_INDEX face_index ) const; //Match endpoints of adjacent trims. If a trim needs to be adjusted, copy the 2d curve if necessary, //convert to NURBS form, yank cvs. Compact() should be called afterwards. Returns false if error in //computation, Trims must be from same face and meet at a common vertex. //These are expert user functions. When in doubt use MatchTrimEnds() on the entire Brep. /* Description: Match the end of a trim to the start of the next trim. Parameters: T0 - [in] brep trim T1 - [in] brep trim that comes immediately after T0 in the same loop Returns: true if either trim's 2d curve is changed */ bool MatchTrimEnds(ON_BrepTrim& T0, ON_BrepTrim& T1 ); /* Description: Match the endpoints of a trim to the next and previous trim Parameters: trim_index - [in] index into m_T Returns: true if any trim's 2d curve is changed */ bool MatchTrimEnds(int trim_index); /* Description: Match the endpoints of all trims in a loop Parameters: Loop - [in] brep loop Returns: true if any trim's 2d curve is changed */ bool MatchTrimEnds(ON_BrepLoop& Loop); /* Description: Match the endpoints of all trims in a brep Parameters: Returns: true if any trim's 2d curve is changed */ bool MatchTrimEnds(); /* Description: Convert the 2d curve of a trim to an ON_NurbsCurve Parameters: T - [in] brep trim Returns: Pointer to m_C2[T.m_c2i] NOTE: After calling this, m_C2[T.m_c2i] will be a NURBS curve only referenced by T, with domain = T.m_t. Caller should not delete the returned curve since its memory is owned by the brep (this). */ ON_NurbsCurve* MakeTrimCurveNurb(ON_BrepTrim& T); /* Description: Check for slit trims and slit boundaries in each face. Returns: true if any slits were found */ bool HasSlits() const; /* Description: Check for slit trims and slit boundaries in a face. Returns: true if any slits were found */ bool HasSlits(const ON_BrepFace& F) const; /* Description: Check for slit trims in a loop. Returns: true if any slits were found */ bool HasSlits(const ON_BrepLoop& L) const; /* Description: remove slit trims and slit boundaries from each face. Returns: true if any slits were removed Remarks: Caller should call Compact() afterwards. */ bool RemoveSlits(); /* Description: remove slit trims and slit boundaries from a face. Parameters: F - [in] brep face Returns: true if any slits were removed Remarks: Caller should call Compact() when done. */ bool RemoveSlits(ON_BrepFace& F); /* Description: remove slit trims from a loop. Parameters: L - [in] brep loop Returns: true if any slits were removed Remarks: Caller should call Compact() when done. If all trims are removed, the loop will be marked as deleted. */ bool RemoveSlits(ON_BrepLoop& L); /* Description: If fid0 != fid1 and m_F[fid0] and m_F[fid1] have the same surface (m_si is identical), and they are joined along a set of edges that do not have any other faces, then this will combine the two faces into one. Parameters: fid0, fid1 - [in] indices into m_F of faces to be merged. Returns: id of merged face if faces were successfully merged. -1 if not merged. Remarks: Caller should call Compact() when done. */ int MergeFaces(int fid0, int fid1); /* Description: Merge all possible faces that have the same m_si Returns: true if any faces were successfully merged. Remarks: Caller should call Compact() when done. */ bool MergeFaces(); /* Description: Removes nested polycurves from the m_C2[] and m_C3[] arrays. Parameters: bExtractSingleSegments - [in] if true, polycurves with a single segment are replaced with the segment curve. bEdges - [in] if true, the m_C3[] array is processed bTrimCurves - [in] if true, the m_C2[] array is processed. Returns: True if any nesting was removed and false if no nesting was removed. */ bool RemoveNesting( bool bExtractSingleSegments, bool bEdges = true, bool bTrimCurves = true ); /* Description: Expert user tool to collapse a "short" edge to a vertex. The edge is removed and the topology is repaired so that everything that used to connect to the edge connects the specified vertex. Parameters: edge_index - [in] index of edge to remove bCloseTrimGap - [in] if true and the removal of the edge creates a gap in the parameter space trimming loop, then the 2d trim curves will be adjusted to close the gap. vertex_index - [in] if >= 0, this the edge is collapsed to this vertex. Otherwise a vertex is automatically selected or created. Returns: True if edge was successfully collapsed. Remarks: After you finish cleaning up the brep, you need to call ON_Brep::Compact() to remove unused edge, trim, and vertex information from the brep's m_E[], m_V[], m_T[], m_C2[], and m_C3[] arrays. */ bool CollapseEdge( int edge_index, bool bCloseTrimGap = true, int vertex_index = -1 ); /* Description: Expert user tool to move trims and edges from one vertex to another. Parameters: old_vi - [in] index of old vertex new_vi - [in] index of new vertex bClearTolerances - [in] if true, then tolerances of edges and trims that are connected to the old vertex are set to ON_UNSET_VALUE. vertex_index - [in] if >= 0, this the edge is collapsed to this vertex. Otherwise a vertex is automatically selected or created. Returns: True if successful. Remarks: After you finish cleaning up the brep, you need to call ON_Brep::Compact() to remove unused edge, trim, and vertex information from the brep's m_E[], m_V[], m_T[], m_C2[], and m_C3[] arrays. */ bool ChangeVertex( int old_vi, int new_vi, bool bClearTolerances ); /* Description: Expert user tool to remove any gap between adjacent trims. Parameters: trim0 - [in] trim1 - [in] Returns: True if successful. Remarks: The trims must be in the same trimming loop. The vertex at the end of trim0 must be the same as the vertex at the start of trim1. The trim's m_iso and m_type flags need to be correctly set. */ bool CloseTrimGap( ON_BrepTrim& trim0, ON_BrepTrim& trim1 ); /* Description: Remove edges that are not connected to a face. Parameters: bDeleteVertices - [in] if true, then the vertices at the ends of the wire edges are deleted if they are not connected to face trimming edges. Returns: Number of edges that were removed. Remarks: After you finish cleaning up the brep, you need to call ON_Brep::Compact() to remove unused edge, trim, and vertex information from the brep's m_E[], m_V[], m_T[], m_C2[], and m_C3[] arrays. After you finish cleaning up the brep, you need to call ON_Brep::Compact() to remove deleted vertices from the m_V[] array. See Also: ON_Brep::RemoveWireVertices */ int RemoveWireEdges( bool bDeleteVertices = true ); /* Description: Remove vertices that are not connected to an edge. Returns: Number of vertices that were deleted. Remarks: After you finish cleaning up the brep, you need to call ON_Brep::Compact() to remove deleted vertices from the m_V[] array. See Also: ON_Brep::RemoveWireEdges */ int RemoveWireVertices(); public: /* Description: Removes all per face material channel index overrides. Returns: Number of changed faces. Remarks: Per face material channel indices are a mutable property on ON_BrepFace and are set with ON_BrepFace.SetMaterialChannelIndex(). */ unsigned int ClearPerFaceMaterialChannelIndices(); /* Returns: True if one or more faces have per face material channel index overrides. Remarks: Per face material channel indices are a mutable property on ON_BrepFace and are set with ON_BrepFace.SetMaterialChannelIndex(). */ bool HasPerFaceMaterialChannelIndices() const; /* Description: Removes all per face color overrides. Returns: Number of changed faces. Remarks: Per face colors are a mutable property on ON_BrepFace and are set with ON_BrepFace.SetPerFaceColor(). */ unsigned int ClearPerFaceColors() const; /* Returns: True if one or more faces have per face color overrides. Remarks: Per face colors are a mutable property on ON_BrepFace and are set with ON_BrepFace.SetPerFaceColor(). */ bool HasPerFaceColors() const; ///////////////////////////////////////////////////////////////// // "Expert" Interface void Set_user(ON_U u) const; // set every brep m_*_user value to u void Clear_vertex_user_i() const; // zero all brep's m_vertex_user values void Clear_edge_user_i(int) const; // zero all brep's m_edge_user values void Clear_edge_user_i() const; // zero all brep's m_edge_user values void Clear_trim_user_i() const; // zero all brep's m_trim_user values void Clear_loop_user_i() const; // zero all brep's m_loop_user values void Clear_face_user_i() const; // zero all brep's m_face_user values void Clear_user_i() const; // zero all brep's m_*_user values // Union available for application use. // The constructor zeros m_brep_user. // The value is of m_brep_user is not saved in 3DM // archives and may be changed by some computations. mutable ON_U m_brep_user; // geometry // (all geometry is deleted by ~ON_Brep(). Pointers can be nullptr // or not referenced. Use Compact() to remove unreferenced geometry. ON_CurveArray m_C2; // Pointers to parameter space trimming curves // (used by trims). ON_CurveArray m_C3; // Pointers to 3d curves (used by edges). ON_SurfaceArray m_S; // Pointers to parametric surfaces (used by faces) // topology // (all topology is deleted by ~ON_Brep(). Objects can be unreferenced. // Use Compact() to to remove unreferenced geometry. ON_BrepVertexArray m_V; // vertices ON_BrepEdgeArray m_E; // edges ON_BrepTrimArray m_T; // trims ON_BrepLoopArray m_L; // loops ON_BrepFaceArray m_F; // faces protected: friend class ON_BrepFace; friend class ON_BrepRegion; friend class ON_BrepFaceSide; friend class ON_V5_BrepRegionTopologyUserData; ON_BoundingBox m_bbox; mutable class ON_BrepRegionTopology* m_region_topology = nullptr; static class ON_BrepRegionTopology* Internal_RegionTopologyPointer( const ON_Brep* brep, bool bValidateFaceCount ); void Internal_AttachV5RegionTopologyAsUserData( ON_BinaryArchive& archive ) const; // m_aggregate_status "should" be an ON_AggregateComponentStatusEx, // but that change requires breaking the C++ SDK. mutable ON_AggregateComponentStatus m_aggregate_status; // Never directly set m_is_solid, use calls to IsSolid() and/or // SolidOrientation() when you need to know the answer to this // question. // 0 = unset // 1 = solid with normals pointing out // 2 = solid with normals pointing in // 3 = not solid int m_is_solid = 0; public: // Not ideal - used in debugging and testing //bool GetLock(); //bool GetLockOrReturnFalse(); //bool ReturnLock(); private: // In calculations where multiple threads are using a brep and calling functions // that may modify content, the calling code can use use ON_SleepLockGuard guard(Mutex) // or similar techniques to make the calculations thread safe. // Because Mutex is a public resource, it must be used with great care to // prevent lock contention. friend class ON_SleepLockGuard; mutable ON_SleepLock m_sleep_lock; protected: // These are friends so legacy tol values stored in v1 3dm files // can be used to set brep edge and trimming tolerances with a call // to ON_Brep::SetTolsFromLegacyValues(). friend bool ON_BinaryArchive::ReadV1_TCODE_LEGACY_FAC(ON_Object**,ON_3dmObjectAttributes*); friend bool ON_BinaryArchive::ReadV1_TCODE_LEGACY_SHL(ON_Object**,ON_3dmObjectAttributes*); void Initialize(); // helpers to set ON_BrepTrim::m_iso flag void SetTrimIsoFlag(int,double[6]); void SetTrimIsoFlag(int); // helpers to create and set vertices bool SetEdgeVertex(const int, const int, const int ); bool HopAcrossEdge( int&, int& ) const; bool SetTrimStartVertex( const int, const int); void SetLoopVertices(const int); void ClearTrimVertices(); void ClearEdgeVertices(); // helpers for SwapFaceParameters() bool SwapLoopParameters( int // index of loop ); bool SwapTrimParameters( int // index of trim ); // helpers for validation checking bool IsValidTrim(int trim_index,ON_TextLog* text_log) const; bool IsValidTrimTopology(int trim_index,ON_TextLog* text_log) const; bool IsValidTrimGeometry(int trim_index,ON_TextLog* text_log) const; bool IsValidTrimTolerancesAndFlags(int trim_index,ON_TextLog* text_log) const; bool IsValidLoop(int loop_index,ON_TextLog* text_log) const; bool IsValidLoopTopology(int loop_index,ON_TextLog* text_log) const; bool IsValidLoopGeometry(int loop_index,ON_TextLog* text_log) const; bool IsValidLoopTolerancesAndFlags(int loop_index,ON_TextLog* text_log) const; bool IsValidFace(int face_index,ON_TextLog* text_log) const; bool IsValidFaceTopology(int face_index,ON_TextLog* text_log) const; bool IsValidFaceGeometry(int face_index,ON_TextLog* text_log) const; bool IsValidFaceTolerancesAndFlags(int face_index,ON_TextLog* text_log) const; bool IsValidEdge(int edge_index,ON_TextLog* text_log) const; bool IsValidEdgeTopology(int edge_index,ON_TextLog* text_log) const; bool IsValidEdgeGeometry(int edge_index,ON_TextLog* text_log) const; bool IsValidEdgeTolerancesAndFlags(int edge_index,ON_TextLog* text_log) const; bool IsValidVertex(int vertex_index,ON_TextLog* text_log) const; bool IsValidVertexTopology(int vertex_index,ON_TextLog* text_log) const; bool IsValidVertexGeometry(int vertex_index,ON_TextLog* text_log) const; bool IsValidVertexTolerancesAndFlags(int vertex_index,ON_TextLog* text_log) const; void SetTolsFromLegacyValues(); // read helpers to support various versions bool ReadOld100( ON_BinaryArchive& ); // reads legacy old RhinoIO toolkit b-rep bool ReadOld101( ON_BinaryArchive& ); // reads legacy Rhino 1.1 b-rep bool ReadOld200( ON_BinaryArchive&, int ); // reads legacy trimmed surface ON_Curve* Read100_BrepCurve( ON_BinaryArchive& ) const; ON_Surface* Read100_BrepSurface( ON_BinaryArchive& ) const; // helpers for reading legacy v1 trimmed surfaces and breps bool ReadV1_LegacyTrimStuff( ON_BinaryArchive&, ON_BrepFace&, ON_BrepLoop& ); bool ReadV1_LegacyTrim( ON_BinaryArchive&, ON_BrepFace&, ON_BrepLoop& ); bool ReadV1_LegacyLoopStuff( ON_BinaryArchive&, ON_BrepFace& ); bool ReadV1_LegacyLoop( ON_BinaryArchive&, ON_BrepFace& ); bool ReadV1_LegacyFaceStuff( ON_BinaryArchive& ); bool ReadV1_LegacyShellStuff( ON_BinaryArchive& ); public: // The ON_Brep code increments ON_Brep::ErrorCount everytime something // unexpected happens. This is useful for debugging. static unsigned int ErrorCount; private: /* Parameters: bLazy - [in] If true and if ON_BrepFace.m_bbox is not empty, then ON_BrepFace.m_bbox is returned. In all other cases the bbox is calculated from scratch. bUpdateCachedBBox - [in] If true and the bounding box is calculated, then the value is saved in ON_BrepFace.m_bbox so future lazy evaluations can use the value. */ const ON_BoundingBox InternalBrepBoundingBox(bool bLazy, bool bUpdateCachedBBox) const; }; /////////////////////////////////////////////////////////////////////////////// // // brep construction tools // /* Description: Create a brep representation of a mesh. Parameters: mesh_topology - [in] bTrimmedTriangles - [in] if true, triangles in the mesh will be represented by trimmed planes in the brep. If false, triangles in the mesh will be represented by untrimmed singular bilinear NURBS surfaces in the brep. pBrep - [in] If not nullptr, this the mesh representation will be put into this brep. Example: ON_Mesh mesh = ...; ON_Brep* pBrep = ON_BrepFromMesh( mesh.Topology() ); ... delete pBrep; See Also ON_BrepFromMesh( const ON_Mesh& mesh, ... ); */ ON_DECL ON_Brep* ON_BrepFromMesh( const ON_MeshTopology& mesh_topology, bool bTrimmedTriangles = true, ON_Brep* pBrep = nullptr ); /* Description: Get an ON_Brep definition of a box. Parameters: box_corners - [in] 8 points defining the box corners arranged as the vN labels indicate. v7_______e6_____v6 |\ |\ | e7 | e5 | \ ______e4_____\ e11 v4 | v5 | | e10 | | | | | v3---|---e2----v2 e9 \ e8 \ | e3 | e1 | \ | \ | \v0_____e0_____\v1 pBrep - [in] if not nullptr, this brep will be used and returned. Returns: An ON_Brep representation of the box with topology edge vertices m_E[ 0] m_V[0], m_V[1] m_E[ 1] m_V[1], m_V[2] m_E[ 2] m_V[2], m_V[3] m_E[ 3] m_V[3], m_V[0] m_E[ 4] m_V[4], m_V[5] m_E[ 5] m_V[5], m_V[6] m_E[ 6] m_V[6], m_V[7] m_E[ 7] m_V[7], m_V[4] m_E[ 8] m_V[0], m_V[4] m_E[ 9] m_V[1], m_V[5] m_E[10] m_V[2], m_V[6] m_E[11] m_V[3], m_V[7] face boundary edges m_F[0] +m_E[0] +m_E[9] -m_E[4] -m_E[8] m_F[1] +m_E[1] +m_E[10] -m_E[5] -m_E[9] m_F[2] +m_E[2] +m_E[11] -m_E[6] -m_E[10] m_F[3] +m_E[3] +m_E[8] -m_E[7] -m_E[11] m_F[4] -m_E[3] -m_E[2] -m_E[1] -m_E[0] // m_F[5] +m_E[4] +m_E[5] +m_E[6] +m_E[7] */ ON_DECL ON_Brep* ON_BrepBox( const ON_3dPoint* box_corners, ON_Brep* pBrep = nullptr ); /* Description: Get an ON_Brep definition of a wedge. Parameters: corners - [in] 6 points defining the box corners arranged as the vN labels indicate. /v5 /|\ / | \ e5 | e4 / e8 \ /__e3_____\ v3| | |v4 | | | | /v2 | e6 / \ e7 | / \ | | e2 e1| |/ \| /____e0___\ v0 v1 pBrep - [in] if not nullptr, this brep will be used and returned. Returns: An ON_Brep representation of the wedge with topology edge vertices m_E[ 0] m_V[0], m_V[1] m_E[ 1] m_V[1], m_V[2] m_E[ 2] m_V[2], m_V[0] m_E[ 3] m_V[3], m_V[4] m_E[ 4] m_V[4], m_V[5] m_E[ 5] m_V[5], m_V[0] m_E[ 6] m_V[0], m_V[3] m_E[ 7] m_V[1], m_V[4] m_E[ 8] m_V[2], m_V[5] face boundary edges m_F[0] +m_E[0] +m_E[7] -m_E[3] -m_E[6] m_F[1] +m_E[1] +m_E[8] -m_E[4] -m_E[7] m_F[2] +m_E[2] +m_E[6] -m_E[5] -m_E[8] m_F[3] +m_E[3] +m_E[8] -m_E[7] -m_E[11] m_F[4] -m_E[2] -m_E[1] -m_E[0] m_F[5] +m_E[3] +m_E[4] +m_E[5] */ ON_DECL ON_Brep* ON_BrepWedge( const ON_3dPoint* corners, ON_Brep* pBrep = nullptr ); /* Description: Get an ON_Brep definition of a sphere. Parameters: sphere - [in] pBrep - [in] if not nullptr, this brep will be used and returned. Returns: An ON_Brep representation of the sphere with a single face, a single edge along the seam, and vertices at the north and south poles. */ ON_DECL ON_Brep* ON_BrepSphere( const ON_Sphere& sphere, ON_Brep* pBrep = nullptr ); /* Description: Get an ON_Brep definition of a sphere. Parameters: Center - [in] Center of sphere radius - [int] Radius of sphere pBrep - [in] if not nullptr, this brep will be used and returned. Returns: An ON_Brep representation of the sphere with six similar faces, each an untrimmed rational quadratic surface */ ON_DECL ON_Brep* ON_BrepQuadSphere( const ON_3dPoint& Center, double radius, ON_Brep* pBrep = nullptr ); /* Description: Get an ON_Brep definition of a torus. Parameters: torus - [in] pBrep - [in] if not nullptr, this brep will be used and returned. Returns: An ON_Brep representation of the torus with a single face a two edges along the seams. */ ON_DECL ON_Brep* ON_BrepTorus( const ON_Torus& torus, ON_Brep* pBrep = nullptr ); /* Description: Get an ON_Brep definition of a cylinder. Parameters: cylinder - [in] cylinder.IsFinite() must be true bCapBottom - [in] if true end at cylinder.m_height[0] should be capped bCapTop - [in] if true end at cylinder.m_height[1] should be capped pBrep - [in] if not nullptr, this brep will be used and returned. Returns: An ON_Brep representation of the cylinder with a single face for the cylinder, an edge along the cylinder seam, and vertices at the bottom and top ends of this seam edge. The optional bottom/top caps are single faces with one circular edge starting and ending at the bottom/top vertex. */ ON_DECL ON_Brep* ON_BrepCylinder( const ON_Cylinder& cylinder, bool bCapBottom, bool bCapTop, ON_Brep* pBrep = nullptr ); /* Description: Get an ON_Brep definition of a cone. Parameters: cylinder - [in] cylinder.IsFinite() must be true bCapBase - [in] if true the base of the cone should be capped. pBrep - [in] if not nullptr, this brep will be used and returned. Returns: An ON_Brep representation of the cone with a single face for the cone, an edge along the cone seam, and vertices at the base and apex ends of this seam edge. The optional cap is a single face with one circular edge starting and ending at the base vertex. */ ON_DECL ON_Brep* ON_BrepCone( const ON_Cone& cone, bool bCapBottom, ON_Brep* pBrep = nullptr ); /* Description: Get an ON_Brep form of a surface of revolution. Parameters: pRevSurface - [in] pointer to a surface of revolution. The brep will manage this pointer and delete it in ~ON_Brep. bCapStart - [in] if true, the start of the revolute is not on the axis of revolution, and the surface of revolution is closed, then a circular cap will be added to close of the hole at the start of the revolute. bCapEnd - [in] if true, the end of the revolute is not on the axis of revolution, and the surface of revolution is closed, then a circular cap will be added to close of the hole at the end of the revolute. pBrep - [in] if not nullptr, this brep will be used and returned. Returns: @untitled table true successful false brep cannot be created from this surface. Remarks: The surface class must be created with new because it will be destroyed with the delete operator in ~ON_Brep. */ ON_DECL ON_Brep* ON_BrepRevSurface( ON_RevSurface*& pRevSurface, bool bCapStart, bool bCapEnd, ON_Brep* pBrep = nullptr ); /* Description: Create an ON_Brep trimmed plane. Parameters: plane - [in] plane that will be trimmed. boundary - [in] a simple (no self intersections) closed curve that defines the outer boundary of the trimmed plane. This curve is copied for use in the brep. pBrep - [in] if not nullptr, this brep will be used and returned. Returns: An ON_Brep representation of the trimmed plane with a single face. See Also: ON_Brep::NewPlanarFaceLoop() */ ON_DECL ON_Brep* ON_BrepTrimmedPlane( const ON_Plane& plane, const ON_Curve& boundary, ON_Brep* pBrep = nullptr ); /* Description: Get an ON_Brep definition of a trimmed plane. Parameters: plane - [in] plane that will be trimmed. boundary - [in] a list of 3d curves that form a simple (no self intersections) closed curve that defines the outer boundary of the trimmed plane. bDuplicateCurves - [in] if true, duplicates of the curves in the boundary array are used in the brep. If false the curves in the boundary array are used in the brep and the brep's destructor will delete the curves. pBrep - [in] if not nullptr, this brep will be used and returned. Returns: An ON_Brep representation of the trimmed plane with a singe face. See Also: ON_Brep::NewPlanarFaceLoop() */ ON_DECL ON_Brep* ON_BrepTrimmedPlane( const ON_Plane& plane, ON_SimpleArray& boundary, bool bDuplicateCurves = true, ON_Brep* pBrep = nullptr ); /* Description: Extrude a brep Parameters: brep - [in/out] path_curve - [in] path to extrude along. bCap - [in] if true, the extrusion is capped with a translation of the input brep. Returns: True if successful. See Also: ON_BrepExtrudeFace ON_BrepExtrudeLoop ON_BrepExtrudeEdge ON_BrepExtrudeVertex ON_BrepConeFace ON_BrepConeLoop ON_BrepConeEdge Remarks: The new faces are appended to brep.m_F[]. It is the caller's responsibility to insure the result does not self intersect. */ ON_DECL bool ON_BrepExtrude( ON_Brep& brep, const ON_Curve& path_curve, bool bCap = true ); /* Description: Extrude a face in a brep. Parameters: brep - [in/out] face_index - [in] index of face to extrude. path_curve - [in] path to extrude along. bCap - [in] if true, the extrusion is capped with a translation of the face being extruded. Example: Extrude a face along a vector. ON_Brep brep = ...; int face_index = ...; ON_3dVector v = ...; ON_LineCurve line_curve( ON_Line( ON_3dPoint::Origin, vector ) ); ON_BrepExtrudeFace( brep, face_index, line_curve, true ); Returns: @untitled table 0 failure 1 successful - no cap added 2 successful - cap added as last face See Also: ON_BrepExtrude ON_BrepExtrudeLoop ON_BrepExtrudeEdge ON_BrepExtrudeVertex ON_BrepConeFace ON_BrepConeLoop ON_BrepConeEdge Remarks: The new faces are appended to brep.m_F[]. If a cap is requested it is the last face in the returned brep.m_F[] */ ON_DECL int ON_BrepExtrudeFace( ON_Brep& brep, int face_index, const ON_Curve& path_curve, bool bCap = true ); /* Description: Extrude a loop in a brep. Parameters: brep - [in/out] loop_index - [in] index of face to extrude. path_curve - [in] path to extrude along. bCap - [in] if true and the loop is closed, the extrusion is capped. Returns: @untitled table 0 failure 1 successful - no cap added 2 successful - cap added as last face See Also: ON_BrepExtrude ON_BrepExtrudeFace ON_BrepExtrudeEdge ON_BrepExtrudeVertex ON_BrepConeFace ON_BrepConeLoop ON_BrepConeEdge Remarks: The new faces are appended to brep.m_F[]. If a cap is requested it is the last face in the returned brep.m_F[] */ ON_DECL int ON_BrepExtrudeLoop( ON_Brep& brep, int loop_index, const ON_Curve& path_curve, bool bCap = true ); /* Description: Extrude an edge in a brep. Parameters: brep - [in/out] edge_index - [in] index of face to extrude. path_curve - [in] path to extrude along. Returns: @untitled table 0 failure 1 successful See Also: ON_BrepExtrude ON_BrepExtrudeFace ON_BrepExtrudeLoop ON_BrepExtrudeVertex ON_BrepConeFace ON_BrepConeLoop ON_BrepConeEdge Remarks: The new face is appended to brep.m_F[]. */ ON_DECL int ON_BrepExtrudeEdge( ON_Brep& brep, int edge_index, const ON_Curve& path_curve ); /* Description: Extrude a vertex in a brep. Parameters: brep - [in/out] vertex_index - [in] index of vertex to extrude. path_curve - [in] path to extrude along. Returns: @untitled table 0 failure 1 successful See Also: ON_BrepExtrude ON_BrepExtrudeFace ON_BrepExtrudeLoop ON_BrepExtrudeEdge ON_BrepConeFace ON_BrepConeLoop ON_BrepConeEdge Remarks: The new vertex is appended to brep.m_V[] and the new edge is appended to brep.m_E[]. */ ON_DECL int ON_BrepExtrudeVertex( ON_Brep& brep, int vertex_index, const ON_Curve& path_curve ); /* Description: Cone a face in a brep. Parameters: brep - [in/out] face_index - [in] index of face to extrude. apex_point - [in] apex of cone. Returns: @untitled table 0 failure 1 successful See Also: ON_BrepExtrudeFace ON_BrepExtrudeLoop ON_BrepExtrudeEdge ON_BrepExtrudeVertex ON_BrepConeFace ON_BrepConeLoop ON_BrepConeEdge Remarks: The new faces are appended to brep.m_F[]. */ ON_DECL int ON_BrepConeFace( ON_Brep& brep, int face_index, ON_3dPoint apex_point ); /* Description: Cone a loop in a brep. Parameters: brep - [in/out] loop_index - [in] index of face to extrude. apex_point - [in] apex of cone. Returns: @untitled table 0 failure 1 successful See Also: ON_BrepExtrudeFace ON_BrepExtrudeLoop ON_BrepExtrudeEdge ON_BrepExtrudeVertex ON_BrepConeFace ON_BrepConeLoop ON_BrepConeEdge Remarks: The new faces are appended to brep.m_F[]. */ ON_DECL bool ON_BrepConeLoop( ON_Brep& brep, int loop_index, ON_3dPoint apex_point ); /* Description: Cone an edge in a brep. Parameters: brep - [in/out] edge_index - [in] index of face to extrude. apex_point - [in] apex of cone. Returns: @untitled table 0 failure 1 successful See Also: ON_BrepExtrudeFace ON_BrepExtrudeLoop ON_BrepExtrudeEdge ON_BrepExtrudeVertex ON_BrepConeFace ON_BrepConeLoop ON_BrepConeEdge Remarks: The new face is appended to brep.m_F[]. */ ON_DECL int ON_BrepConeEdge( ON_Brep& brep, int edge_index, ON_3dPoint apex_point ); //These merge adjacent faces that have the same underlying surface. ON_DECL int ON_BrepMergeFaces(ON_Brep& B, int fid0, int fid1); ON_DECL bool ON_BrepMergeFaces(ON_Brep& B); //This removes all slit trims from F that are not joined to another face. //Unlike ON_Brep::RemoveSlits(), this will remove slit pairs from a loop in cases //that will result in the creation of more loops. Caller is responsible for calling //ON_Brep::Compact() to get rid of deleted trims and loops. ON_DECL bool ON_BrepRemoveSlits(ON_BrepFace& F); //Merges all possible edges ON_DECL void ON_BrepMergeAllEdges(ON_Brep& B); /* Description: Merges two breps into a single brep. The result may be non-manifold or have multiple connected components. Parameters: brep0 - [in] brep1 - [in] tolerance - [in] Returns: Merged brep or nullptr if calculation failed. */ ON_DECL ON_Brep* ON_MergeBreps( const ON_Brep& brep0, const ON_Brep& brep1, double tolerance ); /* Description: Very low level utility. Order edges around a vertex. Parameters: B - [in] vid - [in] trim_ends - [out] trim_ends[a].i is a trim index, trim_ends[a].j is 0 for start or 1 for end. The nth is B.m_T[trim_ends[n].i].Edge(). If bClosed is false, then the first and last edges will be naked. bClosed - [out] If true, then all edges at the vertex have exactly two trims Returns: True if the order can be found. If any edge at the vertex is non-manifold, or if more than two are naked, then false. */ ON_DECL bool ON_OrderEdgesAroundVertex(const ON_Brep& B, int vid, ON_SimpleArray& trim_ends, bool& bClosed); /* Description: Very low level utility. Order edges around a vertex. Parameters: B - [in] vid - [in] trim_ends - [out] trim_ends[a].i is a trim index, trim_ends[a].j is 0 for start or 1 for end. The nth is B.m_T[trim_ends[n].i].Edge(). If bClosed is false, then the first and last edges will be naked. Must have at least as many ON2dex as the vertex has edges. bClosed - [out] If true, then all edges at the vertex have exactly two trims Returns: True if the order can be found. If any edge at the vertex is non-manifold, or if more than two are naked, then false. NOTE: If you don't know how many edges are at the vertex, call the version that takes an ON_SimpleArray. */ ON_DECL bool ON_OrderEdgesAroundVertex(const ON_Brep& B, int vid, ON_2dex* trim_ends,//Must be at as big as the edge count at the vertex bool& bClosed); #if defined(ON_COMPILING_OPENNURBS) ////////////////////////////////////////////////////////////////////////// // // ON_BrepIncrementErrorCount() // // Appears in places where the code traps error conditions. // Putting a breakpoint on the line indicated below is an easy way // to have the debugger break on all error conditions and inspect // the first place something goes wrong in a complex calculation. // void ON_BrepIncrementErrorCount(); // defined in opennurbs_error.cpp #define ON_BREP_ERROR(msg) (ON_BrepIncrementErrorCount(), ON_ERROR(msg)) #define ON_BREP_RETURN_ERROR(rc) (ON_BrepIncrementErrorCount(), rc) #define ON_BREP_RETURN_ERROR_MSG(msg, rc) \ (ON_BrepIncrementErrorCount(), ON_ERROR(msg), rc) #endif #endif