dsegment3d.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

BEGIN_BENTLEY_GEOMETRY_NAMESPACE

struct GEOMDLLIMPEXP DSegment3d
{
DPoint3d point[2];

#ifdef __cplusplus

//BEGIN_FROM_METHODS

static DSegment3d FromOriginAndDirection
(
DPoint3dCR      point0,
DPoint3dCR      tangent
);

static DSegment3d FromZero ();

void InitZero ();
void InitProduct (TransformCR transform, DSegment3dCR other);
static DSegment3d From (DRay3dCR ray);

static DSegment3d From
(
double          x0,
double          y0,
double          z0,
double          x1,
double          y1,
double          z1
);

static DSegment3d FromFractionInterval
(
DSegment3dCR parent,
double startFraction,
double endFraction
);

static DSegment3d FromFractionInterval
(
DSegment3dCR parent,
DSegment1dCR interval
);

static DSegment3d From
(
DPoint3dCR      point0,
DPoint3dCR      point1
);

static DSegment3d From (DPoint2dCR point0, DPoint2dCR point1);
//END_FROM_METHODS

void Init
(
double          x0,
double          y0,
double          z0,
double          x1,
double          y1,
double          z1
);

bool Init (DSegment4dCR source);

void Init
(
DPoint3dCR      point0,
DPoint3dCR      point1
);

void Init
(
DPoint2dCR      point0,
DPoint2dCR      point1
);

void InitFromOriginAndDirection
(
DPoint3dCR      point0,
DPoint3dCR      tangent
);

void InitFrom (DRay3dCR ray);

void GetEndPoints
(
DPoint3dR       point0,
DPoint3dR       point1
) const;

double LengthSquared () const;


bool IsAlmostEqual (DSegment3d other, double tolerance) const;

bool IsSinglePoint () const;

bool IsAlmostSinglePoint () const;

bool GetRange (DRange3dR range) const;

DRange1d ProjectedParameterRange (DRay3dCR ray) const;

bool ProjectPoint
(
DPoint3dR       closestPoint,
double          &closestParam,
DPoint3dCR      point
) const;

bool ProjectPointXY
(
DPoint3dR       closestPoint,
double          &closestParam,
DPoint3dCR      point
) const;

bool ProjectPointBounded
(
DPoint3dR       closestPoint,
double          &closestParam,
DPoint3dCR      point,
bool extend0,
bool extend1
) const;


bool ProjectPointBounded
(
DPoint3dR       closestPoint,
double          &closestParam,
DPoint3dCR      point
) const;

bool Intersect
(
DPoint3dR       intPoint,
double          &intParam,
DPlane3dCR      plane
) const;



int IntersectCircleXY
(
DPoint3dP       intPoint,
double          *pIntParam,
DPoint3dCR      center,
double          radius
) const;

void GetStartPoint (DPoint3dR pt) const;

void GetEndPoint (DPoint3dR pt) const;

void SetStartPoint (DPoint3dCR point);

void SetEndPoint (DPoint3dCR point);

bool FractionParameterToPoint
(
DPoint3dR       point,
double          param
) const;

DPoint3d FractionToPoint (double fraction) const;

bool PointToFractionParameter
(
double          &param,
DPoint3dCR      point
) const;

bool FractionParameterToTangent
(
DPoint3dR       point,
DVec3dR       tangent,
double          param
) const;

bool GetPoint
(
DPoint3dR       pt,
int             index
) const;

bool SetPoint
(
DPoint3dCR      pt,
int             index
);

void InterpolateUniformArray
(
bvector<DPoint3d>&points,
size_t          numPoints
) const;

double Length () const;

bool FractionToLength
(
double          &arcLength,
double          fraction0,
double          fraction1
) const;

bool LengthToFraction
(
double          &fraction1,
double          fraction0,
double          arcStep
) const;

bool ClosestPointBoundedXY
(
DPoint3dR   closePoint,
double&     closeParam,
double&     distanceXY,
DPoint3dCR  spacePoint,
DMatrix4dCP worldToLocal
) const;

bool ClosestPointBoundedXY
(
DPoint3dR   closePoint,
double&     closeParam,
double&     distanceXY,
DPoint3dCR  spacePoint,
DMatrix4dCP worldToLocal,
bool extend0,
bool extend1
) const;


void WireCentroid
(
double     &length,
DPoint3dR   centroid,
double      fraction0 = 0.0,
double      fraction1 = 1.0
) const;

static
void   ClosestApproachBounded
(
double      &fraction0,
double      &fraction1,
DPoint3dR    point0,
DPoint3dR    point1,
DSegment3dCR segment0,
DSegment3dCR segment1
);

static
bool ClosestApproachUnbounded
(
double      &fraction0,
double      &fraction1,
DPoint3dR    point0,
DPoint3dR    point1,
DSegment3dCR segment0,
DSegment3dCR segment1
);


static
void   ClosestApproachBoundedXY
(
double      &fraction0,
double      &fraction1,
DPoint3dR    point0,
DPoint3dR    point1,
DSegment3dCR segment0,
DSegment3dCR segment1
);

static bool IntersectXY
(
double          &fractionA,
double          &fractionB,
DPoint3dR       pointA,
DPoint3dR       pointB,
DSegment3dCR    segmentA,
DSegment3dCR    segmentB
);




#endif
};

END_BENTLEY_GEOMETRY_NAMESPACE