ICogGeneralContourEllipticalArcSegmentIterator.SetStartMidpointEndEllipseFraction Method

ICogGeneralContourEllipticalArcSegmentIterator SetStartMidpointEndEllipseFraction Method

Cognex VisionPro 9.5

Sets StartX, StartY, MidpointX, MidpointY, EndX, EndY, and EllipseFraction of this elliptical arc segment. Note that this method will also change the geometry of any connected segments because it changes the Start and End of this segment.

Namespace: Cognex.VisionPro
Assembly: Cognex.VisionPro.Core (in Cognex.VisionPro.Core.dll) Version: 69.0.0.0

Syntax

C++

Copy to Clipboard Print

void SetStartMidpointEndEllipseFraction(
	double startX,
	double startY,
	double midX,
	double midY,
	double endX,
	double endY,
	double ellipseFraction
)

void SetStartMidpointEndEllipseFraction(
	double startX,
	double startY,
	double midX,
	double midY,
	double endX,
	double endY,
	double ellipseFraction
)

Sub SetStartMidpointEndEllipseFraction ( 
	startX As Double,
	startY As Double,
	midX As Double,
	midY As Double,
	endX As Double,
	endY As Double,
	ellipseFraction As Double
)

Sub SetStartMidpointEndEllipseFraction ( 
	startX As Double,
	startY As Double,
	midX As Double,
	midY As Double,
	endX As Double,
	endY As Double,
	ellipseFraction As Double
)

void SetStartMidpointEndEllipseFraction(
	double startX, 
	double startY, 
	double midX, 
	double midY, 
	double endX, 
	double endY, 
	double ellipseFraction
)

void SetStartMidpointEndEllipseFraction(
	double startX, 
	double startY, 
	double midX, 
	double midY, 
	double endX, 
	double endY, 
	double ellipseFraction
)

Parameters

startX: Type: System Double
X-coordinate of the start point of the arc.

startY: Type: System Double
Y-coordinate of the start point of the arc.

midX: Type: System Double
X-coordinate of the midpoint of the arc.

midY: Type: System Double
Y-coordinate of the midpoint of the arc.

endX: Type: System Double
X-coordinate of the end point of the arc.

endY: Type: System Double
Y-coordinate of the end point of the arc.

ellipseFraction: Type: System Double
The fraction of the ellipse that passes through the start, mid-, and end points. This value must be > 0 and < 1.

Events

Event Type	Reason
CogGeneralContourSegmentIteratorChanged	Fires when the segment changes. The following state flags may be affected:

Event Type

Reason

CogGeneralContourSegmentIteratorChanged

Fires when the segment changes.

The following state flags may be affected:

Exceptions

Exception	Condition
CogShapeBadContourSegTypeException	The SegmentType is not EllipticalArc
CogIteratorInvalidIteratorException	This iterator is not valid.
ArgumentException	The ellipse fraction is <= 0 or >= 1.
CogShapeDegenerateEllipticalArcSegException	Points on the elliptical arc segment are colinear.

Remarks

Sets the start point, midpoint, end point, and ellipse fraction of this elliptical arc.

Note: This method also changes the geometry of any connected segments because it changes the start and end of this segment.