CogEllipticalAnnulusSection.CreateEllipticalArc Method

CogEllipticalAnnulusSection CreateEllipticalArc Method

Cognex VisionPro 9.7

Create a new elliptical arc (copying the specified parameters) from this annulus section. The arc is specified as a radial fraction between the start and end arcs. For example, specify 0 for the start arc, 0.5 for the center arc, and 1 for the end arc.

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

Syntax

C++

Copy to Clipboard Print

public CogEllipticalArc CreateEllipticalArc(
	double radialFraction,
	CogCopyShapeConstants copyFlags
)

public CogEllipticalArc CreateEllipticalArc(
	double radialFraction,
	CogCopyShapeConstants copyFlags
)

Public Function CreateEllipticalArc ( 
	radialFraction As Double,
	copyFlags As CogCopyShapeConstants
) As CogEllipticalArc

Public Function CreateEllipticalArc ( 
	radialFraction As Double,
	copyFlags As CogCopyShapeConstants
) As CogEllipticalArc

public:
CogEllipticalArc^ CreateEllipticalArc(
	double radialFraction, 
	CogCopyShapeConstants copyFlags
)

public:
CogEllipticalArc^ CreateEllipticalArc(
	double radialFraction, 
	CogCopyShapeConstants copyFlags
)

Parameters

radialFraction: Type: System Double
Specifies the arc in relation to the section. Specify zero for the start arc, 0.5 for the center arc, and 1.0 for the end arc, or other values for intermediate arcs.

copyFlags: Type: Cognex.VisionPro CogCopyShapeConstants
Specify which attributes of the shape to copy to the new shape.

Return Value

Type: CogEllipticalArc

The new elliptical arc.

Exceptions

Exception	Condition
ArgumentException	(1 + radialFraction * (RadialScale − 1)) <= 0

Remarks

Creates a new CogEllipticalArc based on this elliptical annulus section as defined by the radial fraction between the start and end arcs. Specify zero for the start arc, 0.5 for the center arc, and 1.0 for the end arc. copyFlags specifies which aspects of the arc are copied to the new shape.

Although you can specify radialFraction values less than zero or greater than 1, this function will return an error if the resulting radii would be less than or equal to zero.