///////////////////////////////////////////////////////////////////////////////
|
// 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_GE_CURVE_CURVE_INT_2D_H
|
#define OD_GE_CURVE_CURVE_INT_2D_H /*!DOM*/
|
|
#include "Ge/GeEntity2d.h"
|
#include "Ge/GeInterval.h"
|
#include "Ge/GeCurve2d.h"
|
#include "Ge/GePointOnCurve2d.h"
|
|
#include "TD_PackPush.h"
|
|
/** \details
|
This class represents intersections of 2D curves.
|
Currently not implemented.
|
|
\remarks
|
The intersection object links to 2D 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
|
|
<group OdGe_Classes>
|
*/
|
class GE_TOOLKIT_EXPORT OdGeCurveCurveInt2d : public OdGeEntity2d
|
{
|
public:
|
|
|
/** \details
|
Constructors.
|
|
\param curve1 [in] First 2D curve.
|
\param curve2 [in] Second 2D curve.
|
\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.
|
|
\note
|
Currently not implemented.
|
*/
|
OdGeCurveCurveInt2d();
|
OdGeCurveCurveInt2d(
|
const OdGeCurve2d& curve1,
|
const OdGeCurve2d& curve2,
|
const OdGeTol& tol = OdGeContext::gTol);
|
OdGeCurveCurveInt2d(
|
const OdGeCurve2d& curve1,
|
const OdGeCurve2d& curve2,
|
const OdGeInterval& range1,
|
const OdGeInterval& range2,
|
const OdGeTol& tol = OdGeContext::gTol);
|
OdGeCurveCurveInt2d(
|
const OdGeCurveCurveInt2d& source);
|
|
// General query functions.
|
//
|
|
/** \details
|
Returns the first curve.
|
|
\note
|
Currently not implemented.
|
*/
|
const OdGeCurve2d *curve1() const;
|
|
/** \details
|
Returns the second curve.
|
|
\note
|
Currently not implemented.
|
*/
|
const OdGeCurve2d *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 tolerance for determining intersections.
|
|
\note
|
Currently not implemented.
|
*/
|
OdGeTol tolerance() const;
|
|
// Intersection query methods.
|
//
|
|
/** \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.
|
*/
|
OdGePoint2d 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 OdGePointOnCurve2d 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,
|
OdGePointOnCurve2d& intPnt) const;
|
|
/** \details
|
Returns the specified intersection point as an OdGePointOnCurve2d 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,
|
OdGePointOnCurve2d& 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 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
|
Makes the first curve the second, and vice versa.
|
|
\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.
|
*/
|
OdGeCurveCurveInt2d& orderWrt1();
|
|
/** \details
|
Orders the intersection points so they correspond to
|
increasing parameter values of the second curve.
|
|
\note
|
Currently not implemented.
|
*/
|
OdGeCurveCurveInt2d& orderWrt2();
|
|
/** \details
|
Sets the curves, ranges and tolerance for which to
|
determine intersections
|
|
\param curve1 [in] First 2D curve.
|
\param curve2 [in] Second 2D curve.
|
\param range1 [in] Range of first curve.
|
\param range2 [in] Range of second curve.
|
\param tol [in] Geometric tolerance.
|
|
\note
|
Currently not implemented.
|
*/
|
OdGeCurveCurveInt2d& set(
|
const OdGeCurve2d& curve1,
|
const OdGeCurve2d& curve2,
|
const OdGeTol& tol = OdGeContext::gTol);
|
OdGeCurveCurveInt2d& set(
|
const OdGeCurve2d& curve1,
|
const OdGeCurve2d& curve2,
|
const OdGeInterval& range1,
|
const OdGeInterval& range2,
|
const OdGeTol& tol = OdGeContext::gTol);
|
|
/** \note
|
This function is not implemented, and will generate a link error if you reference it.
|
It will be implemented in a future release.
|
|
\note
|
Currently not implemented.
|
*/
|
OdGeCurveCurveInt2d& operator =(
|
const OdGeCurveCurveInt2d& crvCrvInt);
|
|
//////////////////////////////////////////////////////////////////////////
|
};
|
|
#include "TD_PackPop.h"
|
|
#endif // OD_GE_CURVE_CURVE_INT_2D_H
|
