GMOperatorsInterfaces Global Function CATCGMCreateTopNewSplitShell

Constructs an operator that splits a CATShell domain by a CATShell or a CATWire domain.
The body to split and the cutting body must only contain one shell domain and one (shell or wire) domain respectively. The cutting body does not have to be necessarily laid down on the support. The split operation completes as long as the distance to the support is smaller than the tolerance which is specified in the creation function. For example, if the maximum distance between the wire and the support is 0.09, the split operation completes if the specified tolerance is greater than 0.09.
Orientation: The orientation of the resulting body is the orientation of the body to cut.
Journal:

• The faces that are kept and not cut are written as CATCGMJournal::Keep
• The faces that are cut are written as CATCGMJournal::Subdivision
• The new edges are written as CATCGMJournal::Creation
• The faces that are neither cut, nor kept, are written as CATCGMJournal::Deletion

Parameters:

iFactory

A pointer to the factory of the resulting body.

iData

A pointer to the topological data.

iBodyToCut

A pointer to the body to cut. It must only contain one shell domain.

iCuttingBody

A pointer to the cutting body. It must only contain one (wire or shell) domain

iSelectMode

The selection of the resulting parts. Do not use BOTH_SIDES for a split operation.

• Shell cut by a shell:

  POSITIVE_POSITIVE_SIDE or POSITIVE_NEGATIVE_SIDE

  The partitions to keep are pointed to by the orientation of the splitting shell.

  NEGATIVE_POSITIVE_SIDE or NEGATIVE_NEGATIVE_SIDE

  The partitions to remove are pointed to by the orientation of the splitting shell.

  BOTH_SIDES

  Do not use this value.

• Shell cut by a wire:

  POSITIVE_POSITIVE_SIDE or POSITIVE_NEGATIVE_SIDE

  When standing along the shell orientation and watching in the direction of the wire leads to have the kept partitions to the left.

  NEGATIVE_POSITIVE_SIDE or NEGATIVE_NEGATIVE_SIDE

  When standing along the shell orientation and watching in the direction of the wire leads to have the kept partitions to the right.

  BOTH_SIDES

  Do not use this value.

iExtrapolMode

The way of extrapolation if the cutting body does not cut right along the body to cut.

• NO_EXTRAPOLATION: No extrapolation is performed. The operator cannot find a solution if the cutting body does not cut right along the body to cut.
• TANGENT_DIRECTION: If the cutting body does not cut right along the body to cut, the extrapolation is made tangentially to the scar at the last computed point.

iTol

Defines the tolerance of the geometrically coincident elements. The split operation completes if iTol is greater than the maximum distance between the cutting body and the support. The maximum value of iTol is 0.1 mm.

Returns:

[out, IUnknown#Release] The pointer to the created operator. To be released with the Release method afer use.

Copyright © 1999-2015, Dassault Systèmes. All rights reserved.