SchemeDT:Bool Options

From DocR21

Action

Bool_Options is a Scheme data type that holds options for the boolean Scheme extensions.

This data type is created by the bool:options Scheme extension.

Refer to the bool:options Scheme extension or the BoolOptions class for more details. The options are related to coincident geometry and merging after a Boolean operation.

Derivation

Bool_Options : scheme-object

C++

BoolOptions

External Rep

#[Bool_Options "near_coi_fuzz" %g "merge_type" { bool_merge_on | bool_merge_off | bool_merge_delayed | bool_merge_unset } ]

where the double is the value of the near_coi_fuzz parameter.

• "near_coi_fuzz" affects how nearly coincident geometry is processed during Boolean operations.

The "near_coi_fuzz" parameter is a real number representing the accuracy of edge-face and face-face coincidences. It has a value greater than or equal to 0; the default is 0. The parameter enables the application to tell ACIS that edge-face near coincidences or face-face near coincidences are intended to be coincident. ACIS uses the information to create tolerant entities during the Boolean operation where this is necessary to enforce coincidence of the entities. If the value of the "near_coi_fuzz" parameter is SPAresabs or smaller, then SPAresabs is used to determine when two entities are coincident.

• "merge_type" specifies what merging is required at the end of a Boolean operation. This option is of type string having the following values:
  • on - merging is performed after the Boolean operation
  • off - merging is not performed
  • delayed - the Boolean operation does not perform the merge but makes available a list of entities to be considered as candidates for merge
  • unset - merging is controlled by the global option "merge", which is the same behavior as in previous versions of ACIS. This is the default.

• When the value delayed is given for the merge_type, the return value of the Boolean operation is a list consisting of the result body and a list of merge candidates. Non-regularized Booleans ignore the value of this option. This behavior remains the same when the Boolean is non-regularized even though the value of this option has no effect on the result; the list of merge candidates is always empty.