Donate

BooleanFragments

Slice

Part

Description

The Part SliceApart command splits shapes by intersection with other shapes. For example, for a box and a plane, two solids are created.

Above: the pieces were moved apart manually afterwards, to reveal the slicing.

Slice apart is the same as Part Slice followed by Part Explode Compound. While "Slice to compound" is fully-parametric, and causes no trouble as the number of pieces changes, "Slice apart" will not update the number of objects as the number of pieces changes. They both create Slice parametric feature, that puts the sliced pieces into a compound, but "Slice apart" explodes the resulting compound into separate objects.

The output shape occupies the same space as the original, but it is split where it intersects with other shapes. The split pieces are individual pieces.

Please visit Part Slice page for more info.

Usage

1. Select the object to be sliced apart, first, and then some objects to slice with. The order of selection is important.
2. There are several ways to invoke the command:
   • Press the Slice Apart button.
   • Select the Part → Split → Slice Apart option from the menu.

Tree structure of Slice Apart

The Slice Apart command creates more than only the sliced object. In the following example a cube is sliced by a face.

The slice is created and for each piece of it a Part CompoundFilter is created, thus the same slice occurs multiple times below each CompoundFilter. All these CompoundFilters are united in a Group.

Example

• Making a puzzle: see Part Slice example Steps 1 to 6

Scripting

The command can be used in macros and from the Python Console by using the following function:

BOPTools.SplitFeatures.makeSlice(name)

Set mode to split for slice apart.

• Creates an empty Slice feature. The 'Base' and 'Tools' properties must be assigned explicitly, afterwards.
• Returns the newly created object.

Slice can also be applied to plain shapes, without the need to have a document object, via:

BOPTools.SplitAPI.slice(base_shape, tool_shapes, mode, tolerance = 0.0)

This can be useful for making custom Python scripted features.

Example:

import BOPTools.SplitFeatures
j = BOPTools.SplitFeatures.makeSlice(name= 'Slice')
j.Base = FreeCADGui.Selection.getSelection()[0]
j.Tools = FreeCADGui.Selection.getSelection()[1:]

The command itself is implemented in Python, see /Mod/Part/BOPTools/SplitFeatures.py (GitHub link) within the FreeCAD installation directory.

Video-Tutorials

• https://www.youtube.com/watch?v=tzHkQaHgrfQ : FreeCad 0.18 PART WB using SLICE and SLICE APART (English language), author: Ha Gei

• https://www.youtube.com/watch?v=JJAL5JmqqKQ : FreeCAD Slice und Slice Apart und andere Tricks (German lanuage), author: Ha Gei

BooleanFragments

Slice

Part