DGKC Control Documentation


Skip Navigation Links.
Start page
Quick Start
Search Page
Installation
What is new
Licensing
Expand ModelsModels
Expand DG Kernel ControlDG Kernel Control
Collapse API ReferenceAPI Reference
Interface List
Vector Space
Collapse General GeometryGeneral Geometry
Expand ModelModel
Expand ViewView
Expand General ComputingGeneral Computing
Expand ViewsViews
Expand Samples and TutorialsSamples and Tutorials
Expand GraphicsGraphics
Expand Math ObjectsMath Objects
Expand DeprecatedDeprecated
Redistribution
Model Viewer
Support
Skip Navigation LinksHome Page > API Reference > General Geometry > Curves > 2D > ICurve2d_DG Go to ActiveX docs Search Documentation


ICurve2d_DG Interface

If this curve defines an edge or otherwise is part of a model, after any modification IGeometry_DG.SetModified() has to be called for the change to appear in 3D view.

Implements also: IObject_DG.

Properties

RangeDg ParameterRange

Methods

GetParameterRange
SetParameterRange
IsFiniteParameterRange
IsClosed
IsPeriodic
GetPeriod
GetPoint
GetPointAtRatio
GetTangent
GetEndPoint
SlideEndPoint
GetNearestPoint
GetPointLocation
GetLength
GetLengthAt
GetParameterAtLength
GetParameterAtRatio
GetRatioAt
GetIntersection
GetIntersection1

void GetParameterRange(double *min, double *max)


void SetParameterRange(double min, double max)

Modifies parameter range of the curve. The values are expected to be geometrically feasible for the curve


bool IsFiniteParameterRange()

Returns true if length of the range returned by GetParameterRange is not greater than 1.0e+90. The return is false for a straight line, for an example.


bool IsClosed()

Returns true if end points coinside


bool IsPeriodic()

Returns true if GetPoint(u) is same as GetPoint(u+T) for all u, where T = GetPeriod();


double GetPeriod()

Returns period for periodic curves or 1.0e+307 otherwise


T2DDg GetPoint(double u)


T2DDg GetTangent(double u)


T2DDg GetEndPoint(int end)

end is expected to be 0 or 1


bool SlideEndPoint(int end, T2DDg point)

Assuming point is geometrically close to the curve, range of the curve is modified so that (projection of) point becomes an end of this curve.


double GetNearestPoint(T2DDg point, out T2DDg pointNearest)

Returns parameter of the nearest point.
Distance between point and pointNearest is the distance of point to this curve.
This method is often used for obtaining parameter of a 3D point lying on the curve.


PointVs2dCurveLocation_DG GetPointLocation(T2DDg point, double tolerance)

Identifies relative position of the point.


double GetLength()


double GetLengthAt(double u)

Returns length of the curve from the first end to the point specified by the parameter u.


double GetParameterAtLength(double length)

Returns parameter of the curve at the point specified by the distance along the curve from the first end to length.


double GetParameterAtRatio(double ratio)

Returns parameter obtained by linear mapping of the parameter range to range [0,1].


double GetRatioAt(double u)

Returns ratio obtained by linear mapping of the parameter range to range [0,1].


int GetIntersection(ICurve2d_DG curve, double tolerance, IArrayDouble_DG paramsThis, IArrayDouble_DG paramsCurve, out bool haveTangentialIntersection)

A simplified version of the generic GetIntersection1() method below. Returns an array of non-tangential intersections of the curves. Returns number of intersections, which coinsides with the sizes of both paramsThis and paramsCurve.

The paramsThis and paramsCurve arrays are synchronised: i-th element in each is the parameter value related to i-th intersection point.

haveTangentialIntersection indicates whether the curves have tangential intersection points, where tangents are collinear. If the returned haveTangentialIntersection is true, the GetIntersection1() method below can be used to obtain the full intersection.


bool GetIntersection1(ICurve2d_DG curve, double tolerance, ISetR1_DG paramsThis, ISetR1_DG paramsCurve, IArrayBool_DG flagsTangential)

Intersection of two 2D curves. Returns false if the intersection is empty.

The paramsThis, paramsCurve and flagsTangential are synchronised: i-th range in each, are the parameter values related to i-th intersection.

Isolated intersection points are returned as singleton (min = max) ranges.

flagsTangential[i] is true if the intersection is tangential (tangents are collinear) on the i-th range. flagsTangential can be false only for isolated intersection points.