All Frameworks Class Hierarchy This Framework Indexes Previous Next

GMOperatorsInterfaces Interface CATICGMAdvancedRemoveFaceOpe

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

interface CATICGMAdvancedRemoveFaceOpe

Class defining a topological operator which removes a set of faces from a volume or a skin.

This operator does not change the dimension of the body: a volume remains a volume, a skin remains a skin.
Note that the specified faces to be removed are not propagated, you need to provide a consistent set of faces. The operation completes when the body can be closed by extrapolation of the faces which were adjacent to the ones removed. Neighbouring faces extrapolations should not generate any tangency configuration.
Unlike CATIPGMRemoveFace operator, CATIPGMPersistentOperator is able to apply special treatments when it is judged necessary for the operation to succeed. For instance, local regularization can be applied in order to avoid twisting of extrapolated geometries.
To use this operator, you must:

Create it with the CATPGMCreateAdvancedRemoveFaceOpe global function
Tune it with appropriate options, using the SetXxx or Append methods.
Run it
Get the result with the GetResult method. If you do not want to keep the resulting body, use the method to remove it from the geometric factory, after the operator deletion.
Release the operator with the Release method after use.

Method Index

o Append(CATLISTP(CATFace)&): Appends a list of faces to be removed.
o AppendLimiting(CATFace*,CATBody*,CATOrientation): Appends a limiting body related to a face to be partially removed.
o GetAllTrickyFaces(CATLISTP(CATFace)&,CATListOfInt&): Returns the complete list of faces when the operation cannot fully complete .
o SetAllowLocalRegularization(short): Allow a local smoothing of a tricky faces
o SetDeviationAllowed(CATLength): Sets the deviation allowed by the user.

Methods

o Append

public virtual Append( const iFacesToRemove)

Appends a list of faces to be removed.

Parameters:

iFacesToRemove: The list of pointers to faces to remove.

o AppendLimiting

public virtual AppendLimiting(		`iFaceToRelimit`,
		`iLimitingBody`,
		`iOri`)

Appends a limiting body related to a face to be partially removed. The limiting body must be mono-shell mono-face.

Parameters:

iFaceToRemove: The face to relimit.
iLimitingBody: The limiting body.
iOri: The orientation related to the shell indicating the side to remove.

o GetAllTrickyFaces

public virtual GetAllTrickyFaces(		`oAllTrickyFaces`,
		`oAllDiags`)

Returns the complete list of faces when the operation cannot fully complete . The list can include faces that could not be removed but also pathological closing faces.

Parameters:

oAllTrickyFaces: The list of tricky faces
oAllDiags: The list of diagnoses.

o SetAllowLocalRegularization

public virtual SetAllowLocalRegularization( iAllowLocalRegularization)

Allow a local smoothing of a tricky faces

Parameters:

iAllowLocalRegul: 0 - Regularization is disabled 1 - Allow the operator to apply a regularization on the input body to avoid surfaces to twist when extrapolated. This mode is used by default at the creation of the operator.

o SetDeviationAllowed

public virtual SetDeviationAllowed( iDeviation)

Sets the deviation allowed by the user.

Parameters:

iDeviation: Represents the maximum value of the deviation. This value must be positive. Default value is 100 * factory resolution

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