Command Line 6.2.9

You are reading an old version of this user guide. The information contained here has been archived and is presented for reference reasons, but it may not be up to date.

3.15. booleanSplit command

Description: This command introduces the cuts that an object produces in another one.

Remark: If the object that this command is called on is a surface, the surface itself will be split into several surfaces. However, if it is an object, this command will only create a cutting loop on the object. In the latter situation, the user may want to explode the object so it is possible to manipulate the surfaces delimited by the cutting loop individually.

Inline mode usage:

  • booleanSplit -h: Displays the help file that summarizes the parameters for this command.
  • booleanSplit –s –objectA <list of names A> -objectB <list of names B>: Split mutually the selected objects.

Interactive mode usage:

  • Invocation: booleanSplit
  • Parameters:
    • Surfaces of the 'objectA': selection of surfaces and objects of the first object.
    • Surfaces of the 'objectB': selection of surfaces and objects of the second object.

Example:

Let's assume we have the following geometry, consisting on a sphere and a surface:

Initial state of the geometry for the booleanSplit command

Initial state of the geometry for the booleanSplit command

 

This geometry was created using the following commands:

command> sphere
Select center [x y z]: 0 0 0
Radius [double]: 2
command> surface
Points in u direction [integer](default=3): 3
Points in v direction [integer](default=3): 2
Point [0][0] [x y z w]: -3 -3 0 1
Point [0][1] [x y z w]: -3 3 0 1
Point [1][0] [x y z w]: 0 -3 0.5 1
Point [1][1] [x y z w]: 0 3 0.6 1
Point [2][0] [x y z w]: 3 -3 2 1
Point [2][1] [x y z w]: 3 3 2.1 1
command>

Now we will use the booleanSplit command on these two objects to create a cutting loop on the sphere at the intersection between it and the surface. To do this, we run the command in the following way:

command> booleanSplit
Select the surfaces of the 'objectA' on screen (Press enter when done): (Select one of the objects)
Select the surfaces of the 'objectB' on screen (Press enter when done): (Select the other object)
Please Wait...
command>

This will create cutting loops on both the sphere and the surface. The surface will be split into two surfaces: the part that is outside of the sphere, and the part that is inside of the sphere. However, the sphere will not be split because it is considered a 3D object. Nevertheless, it is possible to explode the sphere (so it is divided into individual surfaces) and, because the cutting loop was created, we can select the surfaces of both parts of the sphere (above and below the cutting loop) independently, as shown in the next figure:

Selecting the part of the surface above the cutting loop

Selecting the part of the surface above the cutting loop

 

We use cookies on this website to improve your navigation experience on this site. By using this site, you agree to our cookie policy.

I agree