Options

 

 

Technical Article


Options may be set to modify the behavior of ACIS. An option's value may be a flag (indicating an on/off state), a number (integer or real number), or a string. Options may be set in a Scheme application (such as Scheme AIDE) using the Scheme extension option:set; in the ACIS Test Harness using the command option; or in a C++ application using one of several API functions.

rem_use_rbi

Action
Controls the method used to remove faces.

Name String
rem_use_rbi

Scheme
Type Values Default
boolean #t,#f #f

C++
Type Values Default
logical TRUE,FALSE FALSE

When set to TRUE this option will make api_remove_faces call api_remove_and_repair_body to remove the specified faces, rather than using its own algorithm. Its own algorithm does not utilize remote faces, whereas api_remove_and_repair_body does.

rem_use_rbi
; Control method used to remove faces.
(define b1 (solid:block
    (position -25 -25 -25) (position 25 25 25)))
(define b2 (solid:cylinder
    (position 0 0 0 ) (position 0 0 35) 5))
(solid:subtract b1 b2)
; option off - remove fails
(option:set "rem_use_rbi" #f)
(define f1 (pick:face
    (ray (position 0 0 0) (gvector 0 0 -1)) 1))
; expect Error rem:remove-faces:
; gap cannot be filled
(rem:remove-faces f1)
; option on, remove succeeds
(roll)
(option:set "rem_use_rbi" #t)
(define f1 (pick:face
    (ray (position 0 0 0) (gvector 0 0 -1)) 1 ))
(rem:remove-faces f1)

[Top]