CurveVector.h

Go to the documentation of this file.

/*--------------------------------------------------------------------------------------+
|
|   Supplied under applicable software license agreement.
|
|   Copyright (c) 2018 Bentley Systems, Incorporated. All rights reserved.
|
+---------------------------------------------------------------------------------------*/
#pragma once

// @addtogroup BentleyGeom_PolymorphicCurves ICurvePrimitive
    






#ifdef BENTLEY_WIN32
#pragma warning (push)
#pragma warning (default : 4266)        // NEEDS WORK -- warnings about missing virtuals?
#endif
BEGIN_BENTLEY_GEOMETRY_NAMESPACE


struct CurveVector : RefCountedBase, bvector<ICurvePrimitivePtr>
{
public:




enum BoundaryType
    {
    BOUNDARY_TYPE_None          = 0,
    BOUNDARY_TYPE_Open          = 1, 
    BOUNDARY_TYPE_Outer         = 2, 
    BOUNDARY_TYPE_Inner         = 3, 
    BOUNDARY_TYPE_ParityRegion  = 4, 
    BOUNDARY_TYPE_UnionRegion   = 5, 
    };

enum InOutClassification
    {
    INOUT_Unknown = 0,
    INOUT_In      = 1,
    INOUT_Out     = 2,
    INOUT_On      = 3
    };

friend struct CurvePrimitiveChildCurveVector;
private:
    virtual void MakeClassAbstract() = 0;
public:
public:

GEOMDLLIMPEXP ICurvePrimitive::CurvePrimitiveType HasSingleCurvePrimitive () const;
GEOMDLLIMPEXP BoundaryType GetBoundaryType () const;
GEOMDLLIMPEXP bool IsOpenPath () const;
GEOMDLLIMPEXP bool IsClosedPath () const;
GEOMDLLIMPEXP bool IsParityRegion () const;
GEOMDLLIMPEXP bool IsUnionRegion () const;
GEOMDLLIMPEXP bool IsAnyRegionType () const;

GEOMDLLIMPEXP bool AreStartEndAlmostEqual () const;

GEOMDLLIMPEXP bool IsEllipticDisk (DEllipse3dR ellipse) const;

GEOMDLLIMPEXP bool IsPhysicallyClosedPath () const;

GEOMDLLIMPEXP bool IsRectangle (TransformR localToWorld, TransformR worldToLocal) const;


GEOMDLLIMPEXP bool SwapAt (size_t index0, size_t index1);

GEOMDLLIMPEXP void SwapContents (CurveVectorR other);


GEOMDLLIMPEXP static CurveVectorPtr Create (BoundaryType boundaryType);

GEOMDLLIMPEXP static CurveVectorPtr Create (BoundaryType boundaryType, ICurvePrimitivePtr primitive);

GEOMDLLIMPEXP CurveVectorPtr Clone () const;

GEOMDLLIMPEXP CurveVectorPtr CloneDereferenced (bool allowExtrapolation = false, bool maximumDeref = true) const;

GEOMDLLIMPEXP CurveVectorPtr CloneWithFillets (double radius) const;

GEOMDLLIMPEXP CurveVectorPtr CloneWithGapsClosed (CurveGapOptionsCR options) const;

GEOMDLLIMPEXP size_t AddPrimitives (CurveVectorCR source);

GEOMDLLIMPEXP void Add (ICurvePrimitivePtr child);
GEOMDLLIMPEXP void Add (CurveVectorPtr child);


GEOMDLLIMPEXP CurveVectorPtr CloneWithBlends (BlendType, double radiusA, double radiusB) const;
GEOMDLLIMPEXP CurveVectorPtr CloneOffsetCurvesXY (CurveOffsetOptionsCR options);

GEOMDLLIMPEXP CurveVectorPtr AreaOffset (CurveOffsetOptionsCR options) const;

GEOMDLLIMPEXP size_t CountPrimitivesOfType (ICurvePrimitive::CurvePrimitiveType targetType) const;


GEOMDLLIMPEXP CurveVectorPtr CloneWithSplits (CurveVectorCR splitterCurves, bool primitivesOnly = false);

GEOMDLLIMPEXP void AppendSplitCurvesByRegion (CurveVectorCR region, CurveVectorP insideCollector, CurveVectorP outsideCollector, CurveVectorP onCollector);
GEOMDLLIMPEXP void AppendSplitCurvesByPlane (DPlane3dCR plane, CurveVectorP belowCollector, CurveVectorP aboveCollector, CurveVectorP onCollector);


GEOMDLLIMPEXP CurveVectorPtr CloneWithExplodedLinestrings () const;




GEOMDLLIMPEXP bool  WireCentroid (double &length, DPoint3dR centroid) const;

GEOMDLLIMPEXP bool CentroidNormalArea (DPoint3dR centroid, DVec3dR normal, double &area) const;

GEOMDLLIMPEXP bool ComputeSecondMomentAreaProducts (DMatrix4dR products) const;

GEOMDLLIMPEXP bool ComputeSecondMomentDifferentialAreaRotationProducts
                (
                DRay3dCR rotationAxis,
                TransformR rotationToWorld,
                DMatrix4dR products
                ) const;                               

GEOMDLLIMPEXP bool ComputeSecondMomentDifferentialWireRotationProducts
                (
                DRay3dCR rotationAxis,
                TransformR rotationToWorld,
                DMatrix4dR products
                ) const;                               

GEOMDLLIMPEXP bool ComputeSecondMomentWireProducts (DMatrix4dR products) const;

GEOMDLLIMPEXP bool  CentroidAreaXY (DPoint3dR centroid, double &area) const;

GEOMDLLIMPEXP DRange1d ProjectedParameterRange (DRay3dCR ray) const;




GEOMDLLIMPEXP CurveVectorPtr CloneInLocalCoordinates
(
LocalCoordinateSelect frameType,
TransformR localToWorld,
TransformR worldToLocal,
DRange3dR localRange
) const;


GEOMDLLIMPEXP bool GetAnyFrenetFrame (TransformR frame) const;

GEOMDLLIMPEXP bool GetAnyFrenetFrame (TransformR frame, int searchPreference) const;



GEOMDLLIMPEXP bool TryUVFractionToXYZ
    (
    double uFraction,
    double vFraction,
    DPoint3dR xyz,
    DVec3dR dXdu,
    DVec3dR dXdv
    ) const;




GEOMDLLIMPEXP static CurveVectorPtr CreateLinear (bvector<DPoint3d> const&points,
                    BoundaryType boundaryType = CurveVector::BOUNDARY_TYPE_Open,
                    bool forceXYOrientation = false);

GEOMDLLIMPEXP static CurveVectorPtr CreateLinear (
                    DPoint3dCP points,
                    size_t numPoints,
                    BoundaryType boundaryType = CurveVector::BOUNDARY_TYPE_Open,
                    bool forceXYOrientation = false);

GEOMDLLIMPEXP static CurveVectorPtr CreateLinear (
                    DPoint2dCP points,
                    size_t numPoints,
                    BoundaryType boundaryType = CurveVector::BOUNDARY_TYPE_Open,
                    bool forceXYOrientation = false);

GEOMDLLIMPEXP static CurveVectorPtr CreateRectangle(double x0, double y0, double x1, double y1, double z,
                    BoundaryType boundaryType = CurveVector::BOUNDARY_TYPE_Outer);

GEOMDLLIMPEXP static CurveVectorPtr Create (bvector<DSegment3d> const &segments);



GEOMDLLIMPEXP static CurveVectorPtr CreateDisk (DEllipse3dCR arc, BoundaryType boundaryType = CurveVector::BOUNDARY_TYPE_Outer, bool forceXYOrientation = false);

GEOMDLLIMPEXP static CurveVectorPtr Create (ICurvePrimitivePtr child, BoundaryType boundaryType = CurveVector::BOUNDARY_TYPE_Open);



GEOMDLLIMPEXP CurveVectorPtr CloneAsBsplines () const;


GEOMDLLIMPEXP CurveVectorPtr Stroke (IFacetOptionsR options) const;

GEOMDLLIMPEXP void AddStrokePoints (bvector <DPoint3d> &points, IFacetOptionsR options) const;

GEOMDLLIMPEXP bool CollectLinearGeometry (bvector <bvector<bvector<DPoint3d>>> &regionsPoints) const;


GEOMDLLIMPEXP bool AddSpacedPoints (bvector<double> const &distances, bvector<CurveLocationDetail> &locations) const;





GEOMDLLIMPEXP BentleyStatus ToBsplineCurve (MSBsplineCurveR curve) const;
GEOMDLLIMPEXP MSBsplineCurvePtr GetBsplineCurve () const;




GEOMDLLIMPEXP bool ClosestPointBounded (DPoint3dCR spacePoint, CurveLocationDetailR location) const;
GEOMDLLIMPEXP bool ClosestPointBounded (DPoint3dCR spacePoint, CurveLocationDetailR location, bool extend0, bool extend1) const;

GEOMDLLIMPEXP bool ClosestPointBoundedXY (DPoint3dCR spacePoint, DMatrix4dCP worldToLocal, CurveLocationDetailR location) const;

GEOMDLLIMPEXP bool ClosestPointBoundedXY (DPoint3dCR spacePoint, DMatrix4dCP worldToLocal, CurveLocationDetailR location, bool extend0, bool extend1) const;
GEOMDLLIMPEXP CurveVector::InOutClassification ClosestCurveOrRegionPoint (DPoint3dCR spacePoint, DPoint3dR curveOrRegionPoint) const;

GEOMDLLIMPEXP void AnnounceKeyPoints
(
DPoint3dCR spacePoint,                       
CurveKeyPointCollector &collector,           
bool extend0,                               
bool extend1                                
) const;

GEOMDLLIMPEXP bool GetStartEnd (DPoint3dR pointA, DPoint3dR pointB) const;

GEOMDLLIMPEXP bool GetStartEnd (DPoint3dR pointA, DPoint3dR pointB, DVec3dR unitTangentA, DVec3dR unitTangentB) const;

GEOMDLLIMPEXP bool GetStartPoint (DPoint3dR point) const;

GEOMDLLIMPEXP double Length () const;

GEOMDLLIMPEXP double Length (RotMatrixCP worldToLocal) const;

GEOMDLLIMPEXP double FastLength () const;

GEOMDLLIMPEXP double MaxGapWithinPath () const;


GEOMDLLIMPEXP double FastMaxAbs () const;

GEOMDLLIMPEXP bool IsSameStructure (CurveVectorCR other) const;

GEOMDLLIMPEXP bool IsSameStructureAndGeometry (CurveVectorCR other, double tolerance = 0.0) const;

GEOMDLLIMPEXP bool GetRange (DRange3dR range) const;
GEOMDLLIMPEXP bool GetRange (DRange3dR range, TransformCR transform) const;

GEOMDLLIMPEXP bool IsPlanar (TransformR localToWorld, TransformR worldToLocal, DRange3dR range) const;


GEOMDLLIMPEXP bool IsPlanarWithDefaultNormal (TransformR localToWorld, TransformR worldToLocal, DRange3dR range, DVec3dCP normal) const; 





GEOMDLLIMPEXP size_t CyclicIndex (int index) const;
GEOMDLLIMPEXP ICurvePrimitivePtr GetCyclic (ptrdiff_t index) const;

GEOMDLLIMPEXP size_t CurveLocationDetailIndex (CurveLocationDetail const& location) const;

GEOMDLLIMPEXP size_t FindIndexOfPrimitive (ICurvePrimitiveCP primitive) const;

GEOMDLLIMPEXP CurveVectorPtr FindParentOfPrimitive (ICurvePrimitiveCP primitive) const;

GEOMDLLIMPEXP int CurveLocationDetailCompare (CurveLocationDetail const& location0, CurveLocationDetail const& location1) const;

GEOMDLLIMPEXP double ResolveTolerance (double tolerance) const;

GEOMDLLIMPEXP void FindPrimitivesWithNearbyStartEnd (bvector<CurveLocationDetail> &data, DPoint3dCR xyz, double tolerance) const;




GEOMDLLIMPEXP CurveVectorPtr CloneBetweenCyclicIndexedFractions (int index0, double fraction0, int index1, double fraction1) const;

GEOMDLLIMPEXP CurveVectorPtr CloneBetweenDirectedFractions (int index0, double fraction0, int index1, double fraction1, bool allowExtrapolation) const;

GEOMDLLIMPEXP CurveVectorPtr CloneReversed () const;

GEOMDLLIMPEXP CurveVectorPtr GenerateAllParts (int indexA, double fractionA, int indexB, double fractionB) const;

GEOMDLLIMPEXP bool ContainsNonLinearPrimitive () const;


GEOMDLLIMPEXP void AppendCurvePlaneIntersections (DPlane3dCR plane, bvector<CurveLocationDetailPair> &intersections, double tolerance = 0.0) const;

GEOMDLLIMPEXP bool AppendClosedCurvePlaneIntersections (DPlane3dCR plane, bvector<CurveLocationDetailPair> &intersections, double tolerance = 0.0) const;

GEOMDLLIMPEXP ICurvePrimitivePtr PlaneSection (DPlane3dCR plane, double tolerance = 0.0) const;

GEOMDLLIMPEXP CurveVector::InOutClassification PointInOnOutXY (DPoint3dCR xyz) const;

GEOMDLLIMPEXP CurveVector::InOutClassification RayPierceInOnOut
(
DRay3dCR ray,                    
SolidLocationDetailR hitDetail   
) const;



GEOMDLLIMPEXP bool TransformInPlace (TransformCR transform);

GEOMDLLIMPEXP bool ReverseCurvesInPlace ();


GEOMDLLIMPEXP void ConsolidateAdjacentPrimitives ();

GEOMDLLIMPEXP void ConsolidateAdjacentPrimitives (bool doSimplifyLinestrings);

GEOMDLLIMPEXP void SimplifyLinestrings (double distanceTol, bool eliminateOverdraw, bool wrap);

GEOMDLLIMPEXP bool FixupXYOuterInner (bool fullGeometryCheck = false);

GEOMDLLIMPEXP double ReorderForSmallGaps ();

GEOMDLLIMPEXP CurveVectorPtr AssembleChains ();



GEOMDLLIMPEXP static CurveVectorPtr AreaUnion (CurveVectorCR regionA, CurveVectorCR regionB, CurvePrimitivePtrPairVector *newToOld = NULL);

GEOMDLLIMPEXP static CurveVectorPtr AreaDifference (CurveVectorCR regionA, CurveVectorCR regionB, CurvePrimitivePtrPairVector *newToOld = NULL);

GEOMDLLIMPEXP static CurveVectorPtr AreaIntersection (CurveVectorCR regionA, CurveVectorCR regionB, CurvePrimitivePtrPairVector *newToOld = NULL);

GEOMDLLIMPEXP static CurveVectorPtr AreaParity (CurveVectorCR regionA, CurveVectorCR regionB, CurvePrimitivePtrPairVector *newToOld = NULL);





GEOMDLLIMPEXP static CurveVectorPtr AreaAnalysis
        (CurveVectorCR region, AreaSelect select1, BoolSelect select2, bool reverse);

GEOMDLLIMPEXP static CurveVectorPtr ReduceToCCWAreas (CurveVectorCR regionA);


GEOMDLLIMPEXP static CurveVectorPtr CreateXYHatch (
CurveVectorCR        boundary,      
DPoint3dCR           startPoint,    
double               angleRadians,  
double               spacing,       
int                  selection = 0  
);

GEOMDLLIMPEXP static CurveVectorPtr CreateSpiralLineToLineShift
(
int transitionType,     
DPoint3dCR pointA,      
DPoint3dCR shoulderB,     
DPoint3dCR shoulderC,     
DPoint3dCR pointD     
);

GEOMDLLIMPEXP static CurveVectorPtr ConstructSpiralArcSpiralTransition
(
DPoint3dCR xyz0,    
DPoint3dCR xyz1,    
DPoint3dCR xyz2,    
double arcRadius,   
double spiralLength 
);

GEOMDLLIMPEXP static CurveVectorPtr ConstructSpiralArcSpiralTransitionPseudoOffset
(
DPoint3dCR primaryPoint0,   
DPoint3dCR primaryPoint1,   
DPoint3dCR primaryPoint2,   
double primaryRadius,       
double primarySpiralLength, 
double offsetDistance       
);


}; // CurveVector




struct CurveCurve
{
private: CurveCurve (); // static class, no instances allowed.
public:
static GEOMDLLIMPEXP void IntersectionsXY
(
CurveVectorR intersectionA,
CurveVectorR intersectionB,
CurveVectorR curveA, 
CurveVectorR curveB,
DMatrix4dCP    pWorldToLocal
);
static GEOMDLLIMPEXP void IntersectionsXY
(
CurveVectorR intersectionA,     
CurveVectorR intersectionB,     
ICurvePrimitiveP curveA,       
ICurvePrimitiveP curveB,       
DMatrix4dCP    pWorldToLocal,   
bool         extend = false     
);

static GEOMDLLIMPEXP void IntersectionsXY
(
CurveVectorR intersectionA,     
CurveVectorR intersectionB,     
ICurvePrimitiveR curveA,       
CurveVectorR     curveB,       
DMatrix4dCP    pWorldToLocal   
);

static GEOMDLLIMPEXP void IntersectionRotatedRay
(
bvector<CurveLocationDetail>&intersectionA, 
bvector<CurveLocationDetail>&intersectionB, 
ICurvePrimitiveCP curveA,       
TransformCR  worldToLocal,      
DRay3dCR            rayB        
);

static GEOMDLLIMPEXP void CloseApproach
(
CurveVectorR pointsOnA,
CurveVectorR pointsOnB,
ICurvePrimitiveP curveA, 
ICurvePrimitiveP curveB,
double maxDist = DBL_MAX
);

static GEOMDLLIMPEXP bool ClosestApproachNewton (
    ICurvePrimitiveCR curveA,   
    ICurvePrimitiveCR curveB,   
    double &fractionA,          
    double &fractionB,          
    DPoint3dR xyzA,              
    DPoint3dR xyzB               
    );
    
void CloseApproach
(
CurveVectorR pointsOnA,
CurveVectorR pointsOnB,
CurveVectorCR chainA, 
CurveVectorCR chainB,
double maxDist
);

static GEOMDLLIMPEXP bool ClosestApproach
(
CurveLocationDetailR pointOnA,
CurveLocationDetailR pointOnB,
ICurvePrimitiveP curveA, 
ICurvePrimitiveP curveB
);

static GEOMDLLIMPEXP bool ClosestApproach
(
CurveLocationDetailR pointOnA,
CurveLocationDetailR pointOnB,
CurveVectorCR chainA, 
CurveVectorCR chainB
);



static GEOMDLLIMPEXP bool IsSinglePointPair
(
CurveVectorR intersectionA,
CurveVectorR intersectionB,
size_t i,
double &fractionA,
DPoint3dR pointA,
double &fractionB,
DPoint3dR pointB
);

static GEOMDLLIMPEXP bool IsSinglePointPair
(
CurveVectorR intersectionA,
CurveVectorR intersectionB,
size_t i,
CurveLocationDetailR detailA,
CurveLocationDetailR detailB
);

static GEOMDLLIMPEXP bool IsContained
(
CurveVectorR intersectionA, 
CurveVectorR intersectionB, 
size_t i,                   
size_t j,                   
bool considerSinglePoints,    
bool considerIntervals        
);



static GEOMDLLIMPEXP bool GetPartialCurveDetailPair
(
CurveVectorR intersectionA,
CurveVectorR intersectionB,
size_t i,
PartialCurveDetailR detailA,
PartialCurveDetailR detailB
);


struct FilletDetail
{
CurveLocationDetail detailA, detailB;
DEllipse3d arc;
};

static GEOMDLLIMPEXP void CollectFilletArcs
(
ICurvePrimitiveR curveA, 
ICurvePrimitiveR curveB,
double radius,
bool extend,
bvector<FilletDetail> &arcs
);

static GEOMDLLIMPEXP void CollectFilletArcs
(
CurveVectorCR chainA, 
CurveVectorCR chainB,
double radius,
bool extend,
bvector<FilletDetail> &arcs
);

static GEOMDLLIMPEXP void CollectBlends
(
ICurvePrimitiveR curveA,    
ICurvePrimitiveR curveB,    
BlendType blendType,        
double distanceA,           
double distanceB,           
bool extend,                
bvector<BlendDetail> &blendCurves  
);

static GEOMDLLIMPEXP void CollectBlends
(
CurveVectorCR chainA,       
CurveVectorCR chainB,       
BlendType blendType,        
double distanceA,           
double distanceB,           
bool extend,                
bvector<BlendDetail> &blendCurves  
);

static GEOMDLLIMPEXP bool TransverseRegionIntersectionSegments
(
CurveVectorCR regionA,     
CurveVectorCR regionB,     
bvector<DSegment3d> &segments  
);

static GEOMDLLIMPEXP void IntersectRotatedCurveSpaceCurve
(
TransformCR worldToLocal,               
CurveVectorCR rotatedCurve,             
ICurvePrimitiveCR spaceCurve,           
bvector<CurveLocationDetail> &detailA,   
bvector<CurveLocationDetail> &detailB    
);
};



struct PathLocationDetail
{
friend struct CurveVectorWithDistanceIndex;
private:
CurveLocationDetail m_curveDetail;
int32_t m_pathIndex;    // index to the parent path.
double m_pathDistance;  // distance along path.
public:
GEOMDLLIMPEXP PathLocationDetail ();

GEOMDLLIMPEXP PathLocationDetail (PathLocationDetail const &other);

GEOMDLLIMPEXP PathLocationDetail (CurveLocationDetailCR curveDetail, int pathIndex = -1, double distance = DBL_MAX);
GEOMDLLIMPEXP PathLocationDetail (CurveLocationDetailCR curveDetail, size_t pathIndex, double distance = DBL_MAX);

GEOMDLLIMPEXP PathLocationDetail (double distance);

GEOMDLLIMPEXP PathLocationDetail FractionToPositionLocationDetail (double f, bool evaluateDistance = true) const;
GEOMDLLIMPEXP DPoint3d Point () const;
GEOMDLLIMPEXP DPoint3d PointAndUnitTangent (DVec3dR unitTangent) const;
GEOMDLLIMPEXP CurveLocationDetail GetCurveLocationDetail () const;


GEOMDLLIMPEXP bool HasCurve () const;
GEOMDLLIMPEXP double DistanceToPoint (PathLocationDetail const &other) const;
GEOMDLLIMPEXP double DistanceToPoint (DPoint3dCR xyz) const;
GEOMDLLIMPEXP double DistanceSquaredToPoint (DPoint3dCR xyz) const;
GEOMDLLIMPEXP double DistanceFromPathStart () const;
static GEOMDLLIMPEXP bool IsLessThan_ByPathDistance   (PathLocationDetail const &dataA, PathLocationDetail const &dataB);

};

struct CurveVectorWithDistanceIndex : RefCountedBase
{
private:

struct PathEntry : PathLocationDetail
{
double             m_projectedDistance;
DRange3d           m_range;
PathEntry (PathLocationDetail const &pathDetail, double projectedDistance, DRange3dCR range)
    : PathLocationDetail (pathDetail),
    m_projectedDistance (projectedDistance),
    m_range(range)
    {
    }
PathEntry (double distance) : PathLocationDetail (distance), m_projectedDistance (distance) {}
// @param projected true for m_projectedDistance, false for m_pathDistance;    
double GetDistance (bool projected) const;    
static GEOMDLLIMPEXP bool IsLessThan_ByPathDistanceXY (PathEntry const &dataA, PathEntry const &dataB);
static GEOMDLLIMPEXP bool IsLessThan_ByPathDistance   (PathEntry const &dataA, PathEntry const &dataB);

};

CurveVectorPtr m_curveVector; // must be referenced to be sure curvePrimitiveCP in detail data is valid.
bvector<PathEntry> m_locations;
CurveVectorPtr m_savedPrimitives; // Ptr's to extension primitives.

RotMatrix m_worldToViewRotMatrix;
RotMatrix m_viewToWorldRotMatrix;
RotMatrix m_flattenToView;          // Scale (1,0,0) * m_worldToViewRotMatrix;
DMatrix4d m_worldToView;


bool AppendPrimitive (ICurvePrimitivePtr const &source);

void AppendPrimitives (CurveVectorCR source);

void ClearCurves ();

void Init (RotMatrixCR worldToView);
explicit CurveVectorWithDistanceIndex (RotMatrix worldToView);
CurveVectorWithDistanceIndex ();

bool SearchByDistanceFromPathStart
(
RotMatrixCP flatten,
double targetDistance,
PathLocationDetail &detail
) const;




public:

static GEOMDLLIMPEXP CurveVectorWithDistanceIndexPtr Create (RotMatrix worldToView);
static GEOMDLLIMPEXP CurveVectorWithDistanceIndexPtr Create ();

GEOMDLLIMPEXP bool IsEmpty () const;


GEOMDLLIMPEXP void SetPath (CurveVectorPtr &path);

GEOMDLLIMPEXP bool SetExtendedPath
(
CurveVectorPtr &path,       
double extensionDistance,   
PathLocationDetail &boundedStart, 
PathLocationDetail &boundedEnd,    
bool measureExtensionInView = false,
double maxExtensionFactor = 4.0     
);
GEOMDLLIMPEXP double TotalPathLength () const;

GEOMDLLIMPEXP double TotalPathLengthXY () const;

GEOMDLLIMPEXP PathLocationDetail AtStart () const;
GEOMDLLIMPEXP PathLocationDetail AtEnd () const;

GEOMDLLIMPEXP double DistanceBetweenPointsXY (DPoint3dCR xyzA, DPoint3dCR xyzB) const;


GEOMDLLIMPEXP bool SearchByDistanceFromPathStart
(
double targetDistance,
PathLocationDetail &detail
) const;

GEOMDLLIMPEXP bool SearchByDistanceFromPathStartXY
(
double targetDistanceXY,
PathLocationDetail &detail
) const;

GEOMDLLIMPEXP PathLocationDetail SearchClosestPointBounded
(
DPoint3dCR spacePoint,
bool computeDistanceAlong
) const;

GEOMDLLIMPEXP bool SearchFirstIntersectionWithCircleXY
(
PathLocationDetail const &startLocation,
double signedRadius,
PathLocationDetail &intersectionLocation
) const;

GEOMDLLIMPEXP bool DistanceXYFromPathStart
(
PathLocationDetail const &detail,   
double &distance                    
) const;



};






END_BENTLEY_GEOMETRY_NAMESPACE

#ifdef BENTLEY_WIN32
#pragma warning (pop)
#endif