/////////////////////////////////////////////////////////////////////////////// // Copyright (C) 2002-2016, Open Design Alliance (the "Alliance"). // All rights reserved. // // This software and its documentation and related materials are owned by // the Alliance. The software may only be incorporated into application // programs owned by members of the Alliance, subject to a signed // Membership Agreement and Supplemental Software License Agreement with the // Alliance. The structure and organization of this software are the valuable // trade secrets of the Alliance and its suppliers. The software is also // protected by copyright law and international treaty provisions. Application // programs incorporating this software must include the following statement // with their copyright notices: // // This application incorporates Teigha(R) software pursuant to a license // agreement with Open Design Alliance. // Teigha(R) Copyright (C) 2002-2016 by Open Design Alliance. // All rights reserved. // // By use of this software, its documentation or related materials, you // acknowledge and accept the above terms. /////////////////////////////////////////////////////////////////////////////// #ifndef OD_GECINT3D_H #define OD_GECINT3D_H /*!DOM*/ #include "Ge/GeEntity3d.h" #include "Ge/GeInterval.h" #include "TD_PackPush.h" class OdGeCurve3d; class OdGeInterval; class OdGePointOnCurve3d; /** \details This class represents intersections of 3D curves. Currently not implemented. \remarks The intersection object links to 3D curve objects but does not contain them. Calculation of the intersection is performed by a calling function, which owns the intersection output. If one of the curve objects is deleted, the intersection must be recalculated. Library: TD_Ge */ class GE_TOOLKIT_EXPORT OdGeCurveCurveInt3d : public OdGeEntity3d { public: /** \param curve1 [in] First 3D curve. \param curve2 [in] Second 3D curve. \param planeNormal [in] Specifies the normal to the plane for getIntConfigs(). \param range1 [in] Range of first curve. \param range2 [in] Range of second curve. \param tol [in] Geometric tolerance. \param source [in] Object to be cloned. \remarks The planeNormal argument is used only with getIntConfigs(). You must supply this argument if and only if you are using getIntConfigs(). \note Currently not implemented. */ OdGeCurveCurveInt3d(); OdGeCurveCurveInt3d( const OdGeCurve3d& curve1, const OdGeCurve3d& curve2, const OdGeVector3d& planeNormal = OdGeVector3d::kIdentity, const OdGeTol& tol = OdGeContext::gTol); OdGeCurveCurveInt3d( const OdGeCurve3d& curve1, const OdGeCurve3d& curve2, const OdGeInterval& range1, const OdGeInterval& range2, const OdGeVector3d& planeNormal = OdGeVector3d::kIdentity, const OdGeTol& tol = OdGeContext::gTol); OdGeCurveCurveInt3d( const OdGeCurveCurveInt3d& source); /** \details Returns the first curve. \note Currently not implemented. */ const OdGeCurve3d *curve1() const; /** \details Returns the second curve. \note Currently not implemented. */ const OdGeCurve3d *curve2() const; /** \details Returns the ranges of the two curves. \param range1 [out] Receives the range of the first curve. \param range2 [out] Receives the range of the second curve. \note Currently not implemented. */ void getIntRanges( OdGeInterval& range1, OdGeInterval& range2) const; /** \details Returns the normal to the plane for getIntConfigs() \note Currently not implemented. */ OdGeVector3d planeNormal() const; /** \details Returns the tolerance for determining intersections. \note Currently not implemented. */ OdGeTol tolerance() const; /** \details Returns the number of intersections between the curves within the specified ranges. \note Currently not implemented. */ int numIntPoints() const; /** \details Returns the specified intersection point. \param intNum [in] The zero-based index of the intersection point to return. \note Currently not implemented. */ OdGePoint3d intPoint( int intNum) const; /** \details Returns the curve parameters at the specified intersection point. \param intNum [in] The zero-based index of the intersection point to return. \param param1 [out] Receives the parameter of the first curve at the intersection point. \param param2 [out] Receives the parameter of the second curve at the intersection point. \note Currently not implemented. */ void getIntParams( int intNum, double& param1, double& param2) const; /** \details Returns the specified intersection point as an OdGePointOnCurve3d on the first curve. \param intNum [in] The zero-based index of the intersection point to return. \param intPnt [out] Receives the specified intersection point on the first curve. \note Currently not implemented. */ void getPointOnCurve1( int intNum, OdGePointOnCurve3d& intPnt) const; /** \details Returns the specified intersection point as an OdGePointOnCurve3d on the second curve. \param intNum [in] The zero-based index of the intersection point to return. \param intPnt [out] Receives the specified intersection point on the second curve. \note Currently not implemented. */ void getPointOnCurve2( int intNum, OdGePointOnCurve3d& intPnt) const; /** \details Returns the configuration of the intersecion point of the first curve with respect to the second, and vice versa. \param intNum [in] The zero-based index of the intersection point to query. \param config1wrt2 [out] Receives the configuration of the first curve with respect to the second. \param config2wrt1 [out] Receives the configuration of the second curve with respect to the first. \remarks The curves must be coplanar, and are with respect to the planeNormal. The possible values for config1wrt2 and config2wrt1 are as follows: @untitled table kNotDefined kUnknown kLeftRight kRightLeft kLeftLeft kRightRight kPointLeft kPointRight kLeftOverlap kOverlapLeft kRightOverlap kOverlapRight kOverlapStart kOverlapEnd, kOverlapOverlap \note Currently not implemented. */ void getIntConfigs( int intNum, OdGe::OdGeXConfig& config1wrt2, OdGe::OdGeXConfig& config2wrt1) const; /** \details Returns true if and only if the curves are tangential at specified intersection point \param intNum [in] The zero-based index of the intersection point to query. \note Currently not implemented. */ bool isTangential( int intNum) const; /** \details Returns true if and only if the curves are transversal (cross) at specified intersection point \param intNum [in] The zero-based index of the intersection point to query. \note Currently not implemented. */ bool isTransversal( int intNum) const; /** \details Returns the tolerance used to compute the specified intersection point. \param intNum [in] The zero-based index of the intersection point to query. \note Currently not implemented. */ double intPointTol( int intNum) const; /** \details Returns the number of intervals of overlap for the two curves. \note Currently not implemented. */ int overlapCount() const; /** \details Returns true if and only if the curves are oriented in the same direction where they overlap. \remarks This value has meaning only if overlapCount() > 0 \note Currently not implemented. */ bool overlapDirection() const; /** \details Returns the ranges for each curve a the specified overlap. \param overlapNum [in] The zero-based index of the overlap range to query. \param range1 [out] Receives the range of the first curve for the specified overlap. \param range2 [out] Receives the range of the second curve for the specified overlap. \note Currently not implemented. */ void getOverlapRanges( int overlapNum, OdGeInterval& range1, OdGeInterval& range2) const; /** \details Swaps the first and the second curve. \note Currently not implemented. */ void changeCurveOrder(); /** \details Orders the intersection points so they correspond to increasing parameter values of the first curve. \note Currently not implemented. */ OdGeCurveCurveInt3d& orderWrt1(); /** \details Orders the intersection points so they correspond to increasing parameter values of the second curve. \note Currently not implemented. */ OdGeCurveCurveInt3d& orderWrt2(); /** \details Sets the curves, ranges, plane normals, and tolerance for which to determine intersections \param curve1 [in] First 3D curve. \param curve2 [in] Second 3D curve. \param planeNormal [in] Specifies the normal to the plane for getIntConfigs(). \param range1 [in] Range of first curve. \param range2 [in] Range of second curve. \param tol [in] Geometric tolerance. \remarks The planeNormal argument is used only with getIntConfigs(). You must supply this argument only if you are using getIntConfigs(). \note Currently not implemented. */ OdGeCurveCurveInt3d& set( const OdGeCurve3d& curve1, const OdGeCurve3d& curve2, const OdGeVector3d& planeNormal = OdGeVector3d::kIdentity, const OdGeTol& tol = OdGeContext::gTol); OdGeCurveCurveInt3d& set( const OdGeCurve3d& curve1, const OdGeCurve3d& curve2, const OdGeInterval& range1, const OdGeInterval& range2, const OdGeVector3d& planeNormal = OdGeVector3d::kIdentity, const OdGeTol& tol = OdGeContext::gTol); OdGeCurveCurveInt3d& operator =( const OdGeCurveCurveInt3d& crvCrvInt); ////////////////////////////////////////////////////////////////////////// }; #include "TD_PackPop.h" #endif // OD_GECINT3D_H