Interface IBezierCurve

Namespace
ESRI.ArcGIS.Geometry
Assembly
ESRI.Server.Geometry.dll

Provides access to members that identify third degree bezier curve segments and defines their properties.

[Guid("19B8936C-B159-11D1-A2D3-0000F8775FBF")]
[InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
public interface IBezierCurve : ICurve, IGeometry

Remarks

 

IBezierCurve Example

Properties

Degree

The degree of the Bezier curve. For third degree Beziers, this is always 3.

int Degree { get; }

Property Value

int

Dimension

esriGeometryDimension Dimension { get; }

Property Value

esriGeometryDimension

Envelope

IEnvelope Envelope { get; }

Property Value

IEnvelope

FromPoint

IPoint FromPoint { get; set; }

Property Value

IPoint

GeometryType

esriGeometryType GeometryType { get; }

Property Value

esriGeometryType

IsClosed

bool IsClosed { get; }

Property Value

bool

IsEmpty

bool IsEmpty { get; }

Property Value

bool

Length

double Length { get; }

Property Value

double

SpatialReference

ISpatialReference SpatialReference { get; set; }

Property Value

ISpatialReference

ToPoint

IPoint ToPoint { get; set; }

Property Value

IPoint

Methods

GeoNormalize()

void GeoNormalize()

GeoNormalizeFromLongitude(double)

void GeoNormalizeFromLongitude(double Longitude)

Parameters

Longitude double

GetSubcurve(double, double, bool, out ICurve)

void GetSubcurve(double fromDistance, double toDistance, bool asRatio, out ICurve outSubcurve)

Parameters

fromDistance double
toDistance double
asRatio bool
outSubcurve ICurve

Project(ISpatialReference)

void Project(ISpatialReference newReferenceSystem)

Parameters

newReferenceSystem ISpatialReference

PutCoord(int, IPoint)

Sets the specified (0 <= index < 4) control point of this Bezier curve.

void PutCoord(int Index, IPoint controlPoint)

Parameters

Index int
controlPoint IPoint

Remarks

Use PutCoords to set all control points simultaneously. PutCoord should not be use to create a new BezierCurve, use PutCoords instead. PutCoord should only be use to modify an existing and well define BezierCurve.

 

BezierCurve PutCoord Example

PutCoords(int, ref IPoint)

Sets this Bezier curve's control points from an array of between 1 to 4 input points.

void PutCoords(int numPoints, ref IPoint controlPoints)

Parameters

numPoints int
controlPoints IPoint

Remarks

Use PutCoord to set a single control point.

 

BezierCurve PutCoords Example

PutWKSCoords(ref WKSPoint)

Sets this Bezier curve's control points from the array of 4 input point structures.

void PutWKSCoords(ref WKSPoint controlPoints)

Parameters

controlPoints WKSPoint

QueryChordLengthTangentAtFrom(IPoint, ref bool)

Returns tangent vector at 'from' point, based on chord length parametrization; and whether it has been set by user or by smoothing process.

void QueryChordLengthTangentAtFrom(IPoint tangent, ref bool setByUser)

Parameters

tangent IPoint
setByUser bool

QueryChordLengthTangentAtTo(IPoint, ref bool)

Returns tangent vector at 'to' point, based on chord length parametrization; and whether it has been set by user or by smoothing process.

void QueryChordLengthTangentAtTo(IPoint tangent, ref bool setByUser)

Parameters

tangent IPoint
setByUser bool

QueryCoord(int, IPoint)

Copies the specified control point of this Bezier curve into the input point.

void QueryCoord(int Index, IPoint controlPoint)

Parameters

Index int
controlPoint IPoint

Remarks

Use QueryCoords to get all of the control points.

 

BezierCurve QueryCoord Example

QueryCoords(ref IPoint)

Copies this Bezier curve's control points into the array of 4 existing points.

void QueryCoords(ref IPoint controlPoints)

Parameters

controlPoints IPoint

Remarks

Use QueryCoord to get a specific control point.

 

BezierCurve QueryCoords Example

QueryEnvelope(IEnvelope)

void QueryEnvelope(IEnvelope outEnvelope)

Parameters

outEnvelope IEnvelope

QueryFromPoint(IPoint)

void QueryFromPoint(IPoint from)

Parameters

from IPoint

QueryInflectionPoint(IPoint)

Finds inflection point; sets it empty if none exists.

void QueryInflectionPoint(IPoint inflectionPoint)

Parameters

inflectionPoint IPoint

Remarks

Most Bezier Curves have 0 or 1 Inflection Points, but a few constructions result in Bezier Curves with 2 Inflection Points.  For these Bezier Curve, the only way to find both Inflection Points is to Reverse the Orientation of the Bezier Curve and call QueryInflectionPoint a second time.  If the Inflection Points are not equal, the Bezier Curve has two Inflection Points, otherwise, it only has a single Inflection Point.

BezierCurve QueryInflectionPoint Example

[C#]

    private void QueryInflectionPoint()
    {
        //Control points
        IPoint[] controlPoints = new IPoint[4];
        //Bezier FromPoint / From Tangent FromPoint
        controlPoints[0] = new ESRI.ArcGIS.Geometry.Point();
        //From Tangent ToPoint
        controlPoints[1] = new ESRI.ArcGIS.Geometry.Point();
        //To Tangent FromPoint
        controlPoints[2] = new ESRI.ArcGIS.Geometry.Point();
        //Bezier To Point / To Tangent ToPoint
        controlPoints[3] = new ESRI.ArcGIS.Geometry.Point();
        //Define the Bezier Control Points.  This is a simple S-Curve.
        controlPoints[0].PutCoords(100, 100);
        controlPoints[1].PutCoords(150, 200);
        controlPoints[2].PutCoords(250, 0);
        controlPoints[3].PutCoords(400, 100);
        IBezierCurveGEN bezierCurve = new BezierCurve();
        bezierCurve.PutCoords(ref controlPoints);
        //Report control Point
        IPoint[] outControlPoints = new IPoint[4];
        for (int i = 0; i < controlPoints.Length; i++)
        {
            outControlPoints[i] = new ESRI.ArcGIS.Geometry.Point();
        }
        bezierCurve.QueryCoords(ref outControlPoints);
        String report = "Control Points \n";
        for (int i = 0; i < outControlPoints.Length; i++)
        {
            report = report + outControlPoints[i].X + " , " + outControlPoints[i].Y + " \n";
        }
        IPoint infelctionPoint = new ESRI.ArcGIS.Geometry.Point(); ;
        bezierCurve.QueryInflectionPoint(infelctionPoint);
        report = report + "Inflection Point : " + infelctionPoint.X + " , " + infelctionPoint.Y;
































        System.Windows.Forms.MessageBox.Show(report);
    }

QueryNormal(esriSegmentExtension, double, bool, double, ILine)

void QueryNormal(esriSegmentExtension extension, double DistanceAlongCurve, bool asRatio, double Length, ILine normal)

Parameters

extension esriSegmentExtension
DistanceAlongCurve double
asRatio bool
Length double
normal ILine

QueryPoint(esriSegmentExtension, double, bool, IPoint)

void QueryPoint(esriSegmentExtension extension, double DistanceAlongCurve, bool asRatio, IPoint outPoint)

Parameters

extension esriSegmentExtension
DistanceAlongCurve double
asRatio bool
outPoint IPoint

QueryPointAndDistance(esriSegmentExtension, IPoint, bool, IPoint, ref double, ref double, ref bool)

void QueryPointAndDistance(esriSegmentExtension extension, IPoint inPoint, bool asRatio, IPoint outPoint, ref double DistanceAlongCurve, ref double distanceFromCurve, ref bool bRightSide)

Parameters

extension esriSegmentExtension
inPoint IPoint
asRatio bool
outPoint IPoint
DistanceAlongCurve double
distanceFromCurve double
bRightSide bool

QueryTangent(esriSegmentExtension, double, bool, double, ILine)

void QueryTangent(esriSegmentExtension extension, double DistanceAlongCurve, bool asRatio, double Length, ILine tangent)

Parameters

extension esriSegmentExtension
DistanceAlongCurve double
asRatio bool
Length double
tangent ILine

QueryToPoint(IPoint)

void QueryToPoint(IPoint to)

Parameters

to IPoint

QueryWKSCoords(out WKSPoint)

Copies this Bezier curve's control points into the array of 4 existing point structures.

void QueryWKSCoords(out WKSPoint controlPoints)

Parameters

controlPoints WKSPoint

ReverseOrientation()

void ReverseOrientation()

SetChordLengthTangentAtFrom(IPoint, bool)

Establishes tangent vector at 'from' point, based on chord length parametrization; and sets flag whether it has been set by user or by smoothing process.

void SetChordLengthTangentAtFrom(IPoint tangent, bool setByUser)

Parameters

tangent IPoint
setByUser bool

SetChordLengthTangentAtTo(IPoint, bool)

Establishes tangent vector at 'to' point, based on chord length parametrization; and sets flag whether it has been set by user or by smoothing process.

void SetChordLengthTangentAtTo(IPoint tangent, bool setByUser)

Parameters

tangent IPoint
setByUser bool

SetEmpty()

void SetEmpty()

SnapToSpatialReference()

void SnapToSpatialReference()