> For the complete documentation index, see [llms.txt](https://docs.opencutlist.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.opencutlist.org/features/smart-build-tool.md).

# Smart Build Tool

The Smart Build tool builds cabinet parts from the parts around them.

The Smart Build tool builds cabinet parts for you: it places ready-made modules, then fills the cavities of a carcass with dividers, fronts and backs, sized from the parts around them.

{% hint style="info" %}
Smart Build Tool was introduced in version 8.0.0.
{% endhint %}

## How cavities work

The Divider, Front and Back actions don't need any construction line. They look at the part under the mouse and at the other parts of the **same group or component** (the carcass), and detect the empty volumes they enclose: the **cavities**.

* A part alone in its group or component can't form a cavity. Group the parts of your carcass together first.
* While the tool detects the cavities, the status bar shows *Cavity detection...*. Very complex geometry may not be analyzed.
* The cavity under the mouse is highlighted, and the new part is previewed before you click.

## Actions

### Place a Module

This action places a module imported from an SKP file, stretched to the dimensions of the box you draw.

<figure><img src="broken://files/EPBioNu57GgNsvdAdihp" alt=""><figcaption></figcaption></figure>

Using this action is performed in 4 steps:

1. Select a module file in the library panel
2. Click to set the origin of the module
3. Click to set the width (<mark style="color:red;">X</mark> axis), then the depth (<mark style="color:green;">Y</mark> axis) or [enter measure](https://docs.opencutlist.org/features/smart-draw-tool.md#entering-measurement)\
   *↳ Hold `SHIFT` to lock the dimension to the one of the source file*\
   *↳ Hit →, ← or ↑ to lock along <mark style="color:red;">Red</mark>, <mark style="color:green;">Green</mark> or <mark style="color:blue;">Blue</mark> axis*
4. Click to set the height (<mark style="color:blue;">Z</mark> axis) or [enter measure](https://docs.opencutlist.org/features/smart-draw-tool.md#entering-measurement)\
   *↳ Hold `SHIFT` to lock the height to the one of the source file*

<figure><img src="broken://files/Ro5PqHVUTe6rb91UzzQ8" alt=""><figcaption></figcaption></figure>

At any step, hit `CTRL` (on Windows) or `OPTION` (on Mac) to flip the front and back, and `ALT` (on Windows) or `COMMAND` (on Mac) to flip top and bottom.

#### Library

The library panel browses two libraries:

* **OCL Library**: the example modules shipped with OpenCutList (read only)
* **My Library**: your own modules

To add a module of your model to **My Library**, click the **+** button of the panel (or hit `+`), then:

1. Click the instance you want to add
2. Click its **FRONT** side
3. Click its **TOP** side
4. Enter a file name

The module is stretched along its stretch planes: a module made with the Smart Reshape tool keeps its own planes, so that its parts are stretched the way you designed them. If a module can't be stretched along an axis (component behavior, or a stretch plane crossing a curve), a warning tells you so.

<figure><img src="broken://files/Ds7Ejlt23IbHXjaULD7j" alt=""><figcaption></figcaption></figure>

#### Options

* **Anchoring**:
  * Centered in X
  * Centered in Y
  * Centered in Z
  * Origin of the component
* **Options**:
  * **In front of the camera**: automatically turn the front of the module toward the camera
  * **Up towards Z+**: automatically turn the top of the module upward
  * **Part Naming**: enter the module name manually

### Build Divider

This action builds a divider (shelf or upright) in a cavity.

<figure><img src="https://2764382921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUSHuV5bThAGZxy7OHb-1972196547%2Fuploads%2Fq2SgIhWMI9LWCN1OwDGT%2Fsmart-build-04-divider-preview.png?alt=media&amp;token=1b38779d-ea42-4819-aa52-96db4f0337c3" alt=""><figcaption></figcaption></figure>

Using this action is performed in 2 steps:

1. Hover a wall of the cavity: the divider is previewed parallel to it, at the mouse position\
   *↳ Hit →, ← or ↑ to lock the divider normal along <mark style="color:red;">Red</mark>, <mark style="color:green;">Green</mark> or <mark style="color:blue;">Blue</mark> axis, ↓ to unlock*
2. Click to build the divider, or [enter measure](https://docs.opencutlist.org/features/smart-draw-tool.md#entering-measurement) to set its distance from the wall

To build several dividers equally spaced in the cavity:

* Type `*3` for 3 dividers or `/4` for 4 spaces, or hit `SHIFT` + `+` / `SHIFT` + `-`
* (optional) Type a list of spaces to set them instead of leaving them equal\
  *↳ Type `100;200` to set the first two spaces, `;100` to set only the last one*
* Click on a wall of the cavity to build the dividers

<figure><img src="https://2764382921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUSHuV5bThAGZxy7OHb-1972196547%2Fuploads%2FnusuWJfXjNP9kqA1EJxD%2Fsmart-build-05-divider-distribute.png?alt=media&amp;token=3c950c14-2576-427e-8299-32f7c307c4a4" alt=""><figcaption></figcaption></figure>

Type a length followed by `x` (e.g. `19x`) to change the thickness.

#### Options

* **Thickness**: the thickness of the divider
* **Measure**:
  * Position the thickness inside the target point
  * Center the thickness on the target point
  * Position the thickness outside the target point
* **Axes**:
  * Manipulate along active axes
  * Manipulate along the axes of the group or component containing the part
* **Options**:
  * **Inverted Measure**: measure from the opposite side (or quick press `CTRL` on Windows, `OPTION` on Mac)
  * **Recessed Parts**: take recessed parts into account when detecting cavities (or quick press `ALT` on Windows, `COMMAND` on Mac)
  * **Color picker**: apply the material of the hovered part to the created parts
  * **Reuse parts**: reuse an existing part of the same shape and neighborhood rather than creating a new one
  * **Part Naming**: enter part names manually

### Build Front

This action builds a front (door or drawer front) closing the opening of a cavity facing you.

<figure><img src="https://2764382921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUSHuV5bThAGZxy7OHb-1972196547%2Fuploads%2Fs1HO6Diy623iCIIAKNdN%2Fsmart-build-06-front-inset.png?alt=media&amp;token=76ef827b-2b44-425c-82d0-bb1fe6dbb04f" alt=""><figcaption></figcaption></figure>

Using this action is performed in 2 steps:

1. Hover inside a cavity: the front is previewed on its opening\
   *↳ Hold the mouse button and slide to the adjacent cavities to build a single shared front*
2. Click to build the front

<figure><img src="https://2764382921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUSHuV5bThAGZxy7OHb-1972196547%2Fuploads%2Fy0N58J7OCLVjrU7S8mtW%2Fsmart-build-07-front-overlay-merge.png?alt=media&amp;token=07360d6d-ffcb-44ff-b999-c0fa5be4bbdb" alt=""><figcaption></figcaption></figure>

To split the opening into several fronts:

* Type `*2` for 2 fronts, or hit `SHIFT` + `+` / `SHIFT` + `-`\
  *↳ Hit →, ← or ↑ to set the direction the fronts follow one another, ↓ to let the tool choose*
* (optional) Type a list of widths to set them instead of leaving them equal\
  *↳ Type `400;500` to set the first two widths, `;400` to set only the last one*

Type a length to change the thickness, or a length followed by `x` (e.g. `3x`) to change the clearance.

#### Options

* **Thickness**: the thickness of the front
* **Clearance**: the gap left on each edge of the front
* **Overlay**:
  * **Inset**: the front sits inside the opening, flush with the front face
  * **Full overlay**: the front sits in front of the carcass, covering the outer panels up to their outer face and the inner panels up to half their thickness
  * **Overlay against protrusions**: as full overlay, but fitted against the panels that stand proud of the opening
* **Axes**:
  * Manipulate along active axes
  * Manipulate along the axes of the group or component containing the part
* **Options**:
  * **Inverted Measure** (or quick press `CTRL` on Windows, `OPTION` on Mac)
  * **Recessed Parts** (or quick press `ALT` on Windows, `COMMAND` on Mac)
  * **Color picker**: apply the material of the hovered part to the created parts
  * **Reuse parts**: reuse an existing part of the same shape and neighborhood rather than creating a new one
  * **Mirror Layout**: place each even-numbered front as a mirror of its neighbor
  * **Part Naming**: enter part names manually

### Build Back

This action builds a back closing the opening of a cavity on the side **opposite the view**.

<figure><img src="https://2764382921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUSHuV5bThAGZxy7OHb-1972196547%2Fuploads%2FSwd6GwMwwquZKiBQYxwo%2Fsmart-build-08-back-groove.png?alt=media&amp;token=b9fdc47f-eb38-4326-b0f1-49aa1e7fb52e" alt=""><figcaption></figcaption></figure>

Using this action is performed in 2 steps:

1. Hover inside a cavity: the back is previewed on its rear opening\
   *↳ Hold the mouse button and slide to the adjacent cavities to build a single shared back*
2. Click to build the back

<figure><img src="https://2764382921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUSHuV5bThAGZxy7OHb-1972196547%2Fuploads%2FmkOml7ZOzyCNKr0xf6a5%2Fsmart-build-09-back-result.png?alt=media&amp;token=77955ee1-4e85-4644-9410-d184c7b45a0a" alt=""><figcaption></figcaption></figure>

As for fronts, type `*2`, hit `SHIFT` + `+` / `SHIFT` + `-` or type a list of widths to split the opening into several backs.

Type a length to change the thickness, a length followed by `x` (e.g. `8x`) to change the groove depth, or followed by `d` (e.g. `10d`) to change the setback.

#### Options

* **Thickness**: the thickness of the back
* **Groove**:
  * **Depth of groove**: how deep the back runs into the surrounding parts
  * **Setback**: how far the back stands back from the rear of the carcass, and so where the groove is cut
  * **Through groove**: extend the groove to the end of the parts that overlap their neighbor, when it comes out there without being visible
* **Overlay**:
  * **Grooved**: the back is fitted into a groove machined in the parts around the opening
  * **Full overlay**: the back is laid on the rear of the carcass, covering the outer panels up to their outer face and the inner panels up to half their thickness, without machining
  * **Overlay against protrusions**: as full overlay, but fitted between the panels that stand proud (e.g. overhanging sides), without machining
* **Axes**:
  * Manipulate along active axes
  * Manipulate along the axes of the group or component containing the part
* **Options**:
  * **Inverted Measure** (or quick press `CTRL` on Windows, `OPTION` on Mac)
  * **Recessed Parts** (or quick press `ALT` on Windows, `COMMAND` on Mac)
  * **Color picker**: apply the material of the hovered part to the created parts
  * **Reuse parts**: reuse an existing part of the same shape and neighborhood rather than creating a new one
  * **Part Naming**: enter part names manually

{% hint style="warning" %}
If the groove would cut through a part, the back is not built: reduce the groove depth.
{% endhint %}

### Shortcuts

* Use `TAB` or `SHIFT` + `TAB` to navigate forward or backward through actions, respectively.
