GMModelInterfaces Interface CATICGMConvertCurveToCanonic

Usage: an implementation of this interface is supplied and you must use it as is. You should not reimplement it.

interface CATICGMConvertCurveToCanonic

Operator to compute the canonical representation of a line or a circle.

The CATICGMConvertCurveToCanonic operator is created with the CATCGMCreateConvertCurveToCanonic global function and directly released with the Release method. It is is not streamable.
In case of BASIC mode, the operation is automatically performed at the operator creation. In case of ADVANCED mode, options can be precised with the SetXxx methods, before asking for the computation with the Run method.
In both cases, the result is accessed with the GetResult method, that can return NULL, if no approaching canonical representation can be computed.

Method Index

o GetPResult(CATLONG32&,CATCrvLimits&): Returns the pointer to the created canonical curve, as a CATPCurve.
o GetResult(CATCrvLimits&): Returns the pointer to the created canonical curve.
o Run(): Runs this operator.
o SetRecognitionMode(CATBoolean): Defines the recognition mode.
o SetTolerance(double): Defines the tolerance to fit the input curve, in case of approximated recognition mode.

Methods

o GetPResult

public virtual GetPResult(		`ioOrientation`,
		`ioLimits`)

Returns the pointer to the created canonical curve, as a CATPCurve. To use when the input curve is a CATEdgeCurve. In this case, a CATSurface must be set at the operator creation.

Parameters:

ioOrientation: The orientation of the created curve, with regards to the input CATEdgeCurve.
ioLimits: The limits of the created curve.

Returns:

The pointer to the created canonical CATPCurve, or NULL if no result was found. If you do not want to keep it, you must remove it with the method.

o GetResult

public virtual GetResult( ioLimits)

Returns the pointer to the created canonical curve.

Parameters:

ioLimits: The limits of the created curve.

Returns:

The pointer to the created canonical curve, or NULL if no result was found. If you do not want to keep it, you must remove it with the method.

o Run

public virtual Run(

)

Runs this operator.

o SetRecognitionMode

public virtual SetRecognitionMode( iMode = TRUE)

Defines the recognition mode.

Parameters:

iMode

The recognition mode.
Legal values:

TRUE: Exact recognition: the input curve must exactly fit a canonical curve.
FALSE: Approximated recognition.

o SetTolerance

public virtual SetTolerance( iTolerance)

Defines the tolerance to fit the input curve, in case of approximated recognition mode.

Parameters:

iTolerance: The tolerance used in case of an approximated recognition.

This object is included in the file: CATICGMConvertCurveToCanonic.h
If needed, your Imakefile.mk should include the module: CATGMModelInterfaces