BOOLEAN Process

To access this process:

View the Find Command screen, select BOOLEAN and click Run.
Enter "BOOLEAN" into the Command Line and press <ENTER>.

See this process in the Command Table.

Process Overview

The BOOLEAN process is used to apply boolean operations to one or more wireframe data file pairs. As a process, data is processed according to physical file contents, not objects in memory. This differs from the boolean command that work on objects.

BOOLEAN is used to apply one of the following boolean operations on input wireframe(s).

Union - Takes two wireframes and creates a single wireframe with the same surface appearance and volume of both wireframes. Also, see the help file for the wireframe-union interactive command screen. *OUTTR and *OUTPT will be generated with this method.
Difference - Takes the difference of the second from the first wireframe by removing the first volume that is common to the second. The results will differ if the first and second wireframe are swapped. Also, see the help file for the wireframe-difference interactive command screen. *OUTTR and *OUTPT will be generated with this method.
Intersection - Takes two wireframes and creates a single wireframe output of their overlapping (common) volume. Also, see the help file for the wireframe-intersection interactive command screen. *OUTTR and *OUTPT will be generated with this method.
Extract Separate - Takes two wireframes and creates discrete pieces of a two wireframe intersection. The parameters WIRE1IN, WIRE1ON, WIRE1OUT, WIRE2IN, WIRE2ON, WIRE2OUT indicate which outputs are created. Also, see the help file for the wireframe-extract-separate interactive command dialog. *OUTTR and *OUTPT will be generated with this method.
Strings from Intersection - Takes two wireframes and creates a string outlines where the surfaces intercept. Also, see the help file for the wf-intersections interactive command screen. *OUTSTR will be generated with this method.
Solid Hull - Creates a single shell around multiple overlapping surfaces. The option only uses the first wireframe input (*WIRE1TR, *WIRE1PT). Also, see the help file for the convert-wf-hull interactive command screen. *OUTTR and *OUTPT will be generated with this method.

Methods 1,2,3,4 and 5 require two independent wireframe pair files to be specified. Method 6 only requires the first wireframe pair to be specified.

Methods 1,2,3,4 and 6 will output a single wireframe data file. Method 5 will output a string file.

You can optionally control which elements of an output wireframe are generated as a result of the operations above. By default, the full collection of data resulting from the boolean calculation will be generated with methods 1,2,3,4 and 6 (5 will always output a complete string file representing the intersection of two wireframes). The Parameters tab contains parameters, in addition to @METHOD to allow various elements of the output data to be enabled or disabled using 0 or 1.

Example

For example, if you wanted to display the intersection of two overlapping wireframe volumes, but you only wanted to produce the intersecting data originally belonging ,to *WIRE1IN (and not *WIRE2IN), and not any coincident data, you would set @METHOD=4 and the following remaining parameters:

@WIRE1IN=1
@WIRE1ON=0
@WIRE1OUT=1 (not relevant to the intersection method)
@WIRE2IN=0
@WIRE2ON=0
@WIRE2OUT=1 (not relevant to the intersection method)

The ...IN/ON/OUT parameters are only applicable where @METHOD=4. The Strings from Intersection method (@METHOD=5), by comparison, ignores all parameters other than @METHOD.

Note: This process supports retrieval criteria.

Example

!START M1

# - Use !LOCDBOFF to look for files outside the local folder

# - Use local files by deleting the next line or use !LOCDBON

!LOCDBOFF

!BOOLEAN &WIRE1TR(green_pyr_tr),

&WIRE1PT(green_pyr_pt),

&WIRE2TR(red_cube_tr),

&WIRE2PT(red_cube_pt),

&OUTTR(BooleanTR),

&OUTPT(BooleanPT),

&OUTSTR(BooleanSTR),@METHOD=1.0,@WIRE1IN=1.0,@WIRE1ON=1.0,

@WIRE1OUT=1.0,@WIRE2IN=1.0,@WIRE2ON=1.0,@WIRE2OUT=1.0

!END