All Frameworks Class Hierarchy This Framework Indexes Previous Next

GMOperatorsInterfaces Interface CATICGMPowerFill

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

interface CATICGMPowerFill

Class defining the topological operator that fills a space defined by a set of wires.

The wires must define a closed area and be connected. Continuity criteria can be specified: G0, G1, or G2 if the supporting surfaces of the wire are given, G0 otherwise. The supporting surfaces must be coherent to allow the operator to compute a G1 or G2 continuity. If the given continuity constraints are not compatible, the fill result will not satisfy the continuity contraints. If the given continuity constraints define a too scattered set of normals, the shape of the fill result may not be correct. It is also possible to have no result.
The CATICGMPowerFill operator creates the resulting filling skin body separately from the inputs: the wires of the input bodies are not used to define the topology of the resulting fill body.

A CATICGMPowerFill operator is created with the CATCGMCreatePowerFill global function. It must be directly released with the Release method. It is is not streamable.
Options can be specified with the SetXxx methods, before asking for the computation with the Run method
The result is accessed with the GetResult method. If you do not want to keep the resulting body, use the method to remove it from the geometric factory.
The journal corresponding to the fill operation is not yet implemented.

Method Index

o AddInnerWires(CATLISTP(CATBody) const&,CATLISTP(CATBody) const&,CATListOfInt&): Sets one inner wire.
o GetG0MaxAccuracy(): Returns the maximum admissible continuity gap in the result.
o GetG0MaxDeviation(): Returns the maximum continuity gap in the result.
o GetG0MaxDeviation(CATEdge*,CATMathPoint*): Returns the maximum continuity gap with regard to a particular edge.
o GetG1MaxAccuracy(): Returns the maximum admissible tangency gap (in radians) in the result.
o GetG1MaxDeviation(): Returns the maximum tangency gap (in radians) in the result.
o GetG1MaxDeviation(CATEdge*,CATMathPoint*): Returns the maximum tangency gap (in radians) with regard to a particular edge.
o GetG2MaxDeviation(): Returns the maximum curvature gap in the result.
o GetG2MaxDeviation(CATEdge*,CATMathPoint*): Returns the maximum curvature gap with regard to a particular edge.
o OrientationByFirstEdge(): Defines the orientation of the fill face.
o SetCanonicalDetection(): Enables the replacement of the fill surface by a canonical surface when it is detected that this is valid.
o SetFlatFaceMode(CATLONG32): Activates the flat face mode.
o SetLayDownRequest(double): Asks for a lay down of each input wire on the corresponding support.
o SetPassingCurves(CATLISTP(CATBody) const&): Sets a list of passing curves.
o SetPassingPoints(CATLISTP(CATBody) const&): Sets a list of passing points.
o SetTransitionContinuity(CATLONG32,CATLONG32): Defines the continuity criterion to use for a given wire.

Methods

o AddInnerWires

public virtual AddInnerWires(		`iListOfWires`,
		`iListOfSupports`,
		`iListOfInnerTransitionContinuity`)

Sets one inner wire. An inner wire is an inner boundary of the fill result. To set N inner wires, the method AddInnerWires must be called N times.

Parameters:

iListOfWires: The list of pointers to wire bodies representing the inner wire.
iListOfSupports: The list of pointers to shell bodies representing the supports associated with the wire bodies. If a wire body has no support, the corresponding element of iListOfSupports must be set to NULL.
iListOfInnerTransitionContinuity: The list of the continuity criteria associated with the wire bodies. The continuity criteria
Legal values: 0 for G0 continuity (default mode), 1 for G1 continuity, or 2 for G2 continuity.

o GetG0MaxAccuracy

public virtual GetG0MaxAccuracy(

)

Returns the maximum admissible continuity gap in the result. This value is computed by taking into account some incompatibilities in the input model. Hence, it can be larger than the factory resolution.

o GetG0MaxDeviation

public virtual GetG0MaxDeviation(

)

Returns the maximum continuity gap in the result.

o GetG0MaxDeviation

public virtual GetG0MaxDeviation(	const	`iEdge`,
		`ioMaxPoint`	`= NULL`)

Returns the maximum continuity gap with regard to a particular edge. If ioMaxPoint is not null, then it will be filled with the coordinates where the maximum has been reached.

o GetG1MaxAccuracy

public virtual GetG1MaxAccuracy(

)

Returns the maximum admissible tangency gap (in radians) in the result. This value is computed by taking into account some incompatibilities in the model.

o GetG1MaxDeviation

public virtual GetG1MaxDeviation(

)

Returns the maximum tangency gap (in radians) in the result.

o GetG1MaxDeviation

public virtual GetG1MaxDeviation(	const	`iEdge`,
		`ioMaxPoint`	`= NULL`)

Returns the maximum tangency gap (in radians) with regard to a particular edge. If ioMaxPoint is not null, then it will be filled with the coordinates where the maximum has been reached.

o GetG2MaxDeviation

public virtual GetG2MaxDeviation(

)

Returns the maximum curvature gap in the result.

o GetG2MaxDeviation

public virtual GetG2MaxDeviation(	const	`iEdge`,
		`ioMaxPoint`	`= NULL`)

Returns the maximum curvature gap with regard to a particular edge. If ioMaxPoint is not null, then it will be filled with the coordinates where the maximum has been reached.

o OrientationByFirstEdge

public virtual OrientationByFirstEdge(

)

Defines the orientation of the fill face. The fill face is oriented according to the orientation of the first edge in the first wire.

o SetCanonicalDetection

public virtual SetCanonicalDetection(

)

Enables the replacement of the fill surface by a canonical surface when it is detected that this is valid. This method is effective only over rectangular regions, and supports replacement by cylinders, spheres, and cones only.

o SetFlatFaceMode

public virtual SetFlatFaceMode( const iMode = 1)

Activates the flat face mode. In this mode, a planar face is created if the hole being filled is flat.

Parameters:

iMode

The flat mode.
Legal values:

1: to activate the flat face mode.
0: to deactivate the flat face mode.

o SetLayDownRequest

public virtual SetLayDownRequest( const iLayDownTolerance)

Asks for a lay down of each input wire on the corresponding support. If this method is not called, the wire is presumed to be already laid down on its support.

Parameters:

iLayDownTolerance: The pointer to the lay down tolerance (maximum distance between wire to be laid down and its support surface).

o SetPassingCurves

public virtual SetPassingCurves( iListOfWires)

Sets a list of passing curves. The resulting fill surface must pass by the passing curves, but the passing curves do not belong to the resulting topology. In particular, a passing curve is not a boundary of the fill surface.

Parameters:

iListOfWires: The list of bodies (wires) representing the passing curves.

o SetPassingPoints

public virtual SetPassingPoints( iListOfVertices)

Sets a list of passing points. The fill result must pass through these points.

Parameters:

iListOfVertices: The list of pointers to vertex bodies representing the passing points.

o SetTransitionContinuity

public virtual SetTransitionContinuity(	const	`iWhichWire`,
	const	`iTransitionContinuity`)

Defines the continuity criterion to use for a given wire.

Parameters:

iWhichWire: The index (beginning at 1) of the input wire.
iTransitionContinuity: The continuity criterion.
Legal values: 0 for G0 continuity (default mode), 1 for G1 continuity, or 2 for G2 continuity.

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