# OpenCutList to Shaper Origin

## Context

[Shaper Origin](https://www.shapertools.com/) is a handheld precision router that supports SVG file as input for tool paths.

Since [version 6.0.0](https://docs.opencutlist.org/whats-new/in-version-6.0), OpenCutList could be a good companion for this machine, offering the ability to quickly export a part's geometry to SVG.

## Getting Started

First of all you need to have [SketchUp Make 2017](https://www.lairdubois.fr/questions/reponses/27620) or [SketchUp Pro](https://www.sketchup.com/download/all) installed on your computer. Then read the [Installing](https://docs.opencutlist.org/getting-started/installing) page to find out how to install OpenCutList.

{% hint style="warning" %}
We assume that the reader is familiar with SketchUp.
{% endhint %}

If you want to learn more about OpenCutList and the context of this Open Source project, check [this page](https://docs.opencutlist.org/opencutlist).

## Exporting to SVG

OpenCutList offers multiples ways of exporting SketchUp drawings to SVG file. Each of these is fully customizable.

### From Part (Component) to SVG

First, draw your project in the 3D model and create one component per part.

{% hint style="info" %}
OpenCutList considers all component instances with a non-zero volume as a part. Therefore make sure that all parts of your project are components and not a group. [Learn more](https://docs.opencutlist.org/getting-started/components).
{% endhint %}

For the rest, we will use this toolbox as an example.

<figure><img src="https://2764382921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUSHuV5bThAGZxy7OHb-1972196547%2Fuploads%2FvaZgze45ubSCWfGg6iMO%2FTutorial%20-%20Shaper%20-%20Toolbox%200.png?alt=media&#x26;token=f517281c-cd6a-4c05-b799-3663e0bbb306" alt="" width="563"><figcaption></figcaption></figure>

The easiest way to export parts shape is to use the [Smart Export Tool](https://docs.opencutlist.org/features/smart-export-tool).

Activate the tool and select the **Export 2D part** action and **SVG** file format.

<figure><img src="https://2764382921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUSHuV5bThAGZxy7OHb-1972196547%2Fuploads%2FhPV0e0DT8QfJqvZqerLT%2FCapture%20d%E2%80%99e%CC%81cran%202024-02-21%20a%CC%80%2017.36.23.png?alt=media&#x26;token=279ea1f6-6d02-4642-8e97-043ae09d0285" alt="" width="563"><figcaption></figcaption></figure>

Click on the **More** button and configure colors according to the Origin [Cut Type encoding](https://support.shapertools.com/hc/en-us/articles/115002721473-Cut-Type-Encoding):

* *Parts* : Line color = none, Fill color = black
* *Drillings* : Line color = black, Fill color = white
* *Paths* : Line color = blue

<figure><img src="https://2764382921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUSHuV5bThAGZxy7OHb-1972196547%2Fuploads%2FcOiXsdnNQ7t0LU6kfc1S%2FTutorial%20-%20Shaper%20-%20Toolbox%202.png?alt=media&#x26;token=03c13eed-4dca-4440-86ea-e6c595c962ab" alt="" width="563"><figcaption></figcaption></figure>

You can now move the mouse over the face of each part you wish to export as a 2D SVG. As you can see below, a blue line wireframe preview of the part drawing projection is drawn in real time.

<figure><img src="https://2764382921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUSHuV5bThAGZxy7OHb-1972196547%2Fuploads%2FUwBcGSWhGZNoUt1EGqxc%2FEnregistrement%20de%20l%E2%80%99e%CC%81cran%202024-02-21%20a%CC%80%2017.42.03-GIF%20720x720%2015%20ips.gif?alt=media&#x26;token=a91e4584-a784-4d00-8846-cc21066d0e46" alt="" width="540"><figcaption></figcaption></figure>

This tool is more than just a face exporter. It offers several useful options:

* **Anchor point** : This option preserves the location of the coordinate axes of the SketchUp component of the part in the exported file (*Project the part's origin)*. Otherwise the smallest coordinate of the bounding box is used as location of the origin of the coordinate axes (*Default*). This option is fully compatible with [Origin custom anchor](https://support.shapertools.com/hc/en-us/articles/4402965445019-Custom-Anchors) (the little red triangle).
* **Smoothing** : Smooth circles and arcs ! [Learn more](https://docs.opencutlist.org/features/smart-export-tool#smoothing)*.*
* **Merging Mode** : [Learn more](https://docs.opencutlist.org/features/smart-export-tool#merging-mode)
  * *Default* : The part shape is exported with a single layer per depth.
  * *Outline + Drillings + Merge* : Activates the separation of the outer contour of parts from their holes, as well as the merging of depths for each cavity.
* **Paths** : Allow edges not associated with a face in the part to be exported as a path. [Learn more](https://docs.opencutlist.org/features/smart-export-tool#paths).

Each of these four options can be configured from the tool shortcut bar or from the full configuration panel. The selected configuration is stored and will be retained even if you close SketchUp. You can also create [Presets](https://docs.opencutlist.org/getting-started/installing/presets).

In this use case, we will set **Anchor point** to *Default*, **Smoothing** to *Smooth circles and arcs*, **Merge mode** to *Outline + Drilling + Merge* and **Paths** to *Use edges not associated with a face*.

To export a single part, simply point and click on the face that will be under the Origin during machining, select a folder and enter the file name, then click on the *Save button*. That's all there is to it! Your first SVG is ready.

<figure><img src="https://2764382921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUSHuV5bThAGZxy7OHb-1972196547%2Fuploads%2F6sPYbOhtzywWHSE4XYFb%2FTutorial%20-%20Shaper%20-%20Toolbox%203.png?alt=media&#x26;token=2901e868-07e0-482f-bdd1-c3bcc39d84ca" alt="" width="563"><figcaption><p>Example of exported handle</p></figcaption></figure>

If you take a look at the generated SVG you can see that the [encoded depth](https://support.shapertools.com/hc/en-us/articles/10400926390683-Encoded-depth) has been automatically extracted from the 3D model. In addition, you can see that the entire part drawing is encapsulated in a group called *OCL\_PART*. And each path is named according to its cutting depth. This naming is compatible with [Inkscape](https://inkscape.org/) and [Affinity Designer](https://affinity.serif.com/fr/designer/).

<figure><img src="https://2764382921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUSHuV5bThAGZxy7OHb-1972196547%2Fuploads%2FIdQ98PJug6vLtU40zuQt%2FTutorial%20-%20Shaper%20-%20Toolbox%209.png?alt=media&#x26;token=a859e1bd-92a0-4713-8fda-2c364fa39ea9" alt=""><figcaption></figcaption></figure>

Second example with "pocket" portions.

<div><figure><img src="https://2764382921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUSHuV5bThAGZxy7OHb-1972196547%2Fuploads%2FiTb2qgW0jK39DYKE1KUb%2FTutorial%20-%20Shaper%20-%20Toolbox%2010.png?alt=media&#x26;token=2f38c880-bd3f-4aa6-b525-df949e9a3243" alt="" width="563"><figcaption></figcaption></figure> <figure><img src="https://2764382921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUSHuV5bThAGZxy7OHb-1972196547%2Fuploads%2FX7M0N8YICroVia4RsrxT%2FTutorial%20-Shaper%20-%20Toolbox%2011.png?alt=media&#x26;token=176e2572-6394-4002-982b-b8878e985604" alt="" width="563"><figcaption></figcaption></figure></div>

#### More About Paths

Paths are a common terms for **edges** or **curves** that are drawn inside the part component and are not associated with a face.

Paths allows you to add extra geometry which will be exported with a color different from that of the solid geometry. &#x20;

For example, the front of the toolbox features a heart that we want to engrave. This heart is drawn with four curved welded arcs in a subgroup of the long side component.&#x20;

{% hint style="warning" %}
The face formed by the outer lines should be removed.
{% endhint %}

<figure><img src="https://2764382921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUSHuV5bThAGZxy7OHb-1972196547%2Fuploads%2FLq5qFlwPsWL8g8aHuEXj%2FTutorial%20-%20Shaper%20-%20Toolbox%204.png?alt=media&#x26;token=7d3bfe4c-5216-40e0-a4dc-099f0bcb6292" alt="" width="563"><figcaption></figcaption></figure>

If the **Paths** option is enabled, OpenCutList will detect it and preview it with light blue line.

<figure><img src="https://2764382921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUSHuV5bThAGZxy7OHb-1972196547%2Fuploads%2FeGdcZarnCYeJRkvZNShD%2FTutorial%20-%20Shaper%20-%20Toolbox%205.gif?alt=media&#x26;token=f587c652-2aad-40f1-a1b9-9351ccce05e2" alt="" width="540"><figcaption></figcaption></figure>

And export it as a simple SVG path.

<figure><img src="https://2764382921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUSHuV5bThAGZxy7OHb-1972196547%2Fuploads%2FHS7A0L3Kj9osQYdYk71B%2FTutorial%20-%20Shaper%20-Toolbox%206.png?alt=media&#x26;token=49e39aab-3cd0-4583-be55-b6e295bbd0c6" alt="" width="563"><figcaption></figcaption></figure>

A more advance example might be the engraving of lines that protrude from the shape of the part.

<figure><img src="https://2764382921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUSHuV5bThAGZxy7OHb-1972196547%2Fuploads%2FSrWyBXSf1wQ3tTfHduff%2FTutorial%20-%20Shaper%20-%20Toolbox%207-GIF%20720x720%2015%20ips.gif?alt=media&#x26;token=ce38a926-3080-48d0-ae6e-f5a535f80c41" alt="" width="540"><figcaption></figcaption></figure>

This does not alter the size of the part in the Parts List, as lines without faces are ignored by OpenCutList.

<figure><img src="https://2764382921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUSHuV5bThAGZxy7OHb-1972196547%2Fuploads%2FDJOA7EDbaN2N8ktqOKW9%2FTutorial%20-%20Shaper%20-%20Toolbox%208.png?alt=media&#x26;token=6091d433-1292-414e-80da-363b244a5236" alt="" width="563"><figcaption></figcaption></figure>

Paths can be useful for creating machining areas for [autopass](https://www.shapertools.com/autopass).

Imagine the following part where you want to use autopass at specific locations. Simply draw closed paths, weld them into a curve and export them.

{% hint style="warning" %}
Please note that, by default blue path lines are interpreted as guidelines by Shaper Origin. You therefore need to change the type of cut to *Interior cut* on the machine.
{% endhint %}

<div><figure><img src="https://2764382921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUSHuV5bThAGZxy7OHb-1972196547%2Fuploads%2F4olmMSA8fT8PhX1hiFNk%2FTutorial%20-%20Shaper%20-%20Toolbox%2012.gif?alt=media&#x26;token=1c6fab86-803c-4570-9fe0-80d7a104fbd2" alt="" width="540"><figcaption></figcaption></figure> <figure><img src="https://2764382921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUSHuV5bThAGZxy7OHb-1972196547%2Fuploads%2FD55xd766Kft12IwIctuC%2FTutorial%20-%20Shaper%20-%20Toolbox%2013.png?alt=media&#x26;token=a4e6a64d-893c-42c2-802c-0285ca90a6ee" alt="" width="563"><figcaption></figcaption></figure></div>

### From Face to SVG

If creating a solid component is too restrictive for your needs, you can also export the faces directly. In this case, however, only the pointed face will be exported.

Use the third Export Face action of the Smart Export Tool.

<figure><img src="https://2764382921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUSHuV5bThAGZxy7OHb-1972196547%2Fuploads%2Fsq1a1yZcKJQPIVPZYkyr%2FTutorial%20-%20Shaper%20-%20Toolbox%2014.gif?alt=media&#x26;token=8c9d511b-0c82-41cb-9d82-89e454981e22" alt="" width="540"><figcaption></figcaption></figure>

### Batch Export

{% hint style="info" %}
Read the complete documentation [here](https://docs.opencutlist.org/features/parts/export-part-drawing/2d-projection).
{% endhint %}

If your project contains several parts, you can export all the parts in a single operation. In this case, generate the Parts List, click on the three-dot button and select *Export 2D projection of parts in group*.

<div><figure><img src="https://2764382921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUSHuV5bThAGZxy7OHb-1972196547%2Fuploads%2F1SlH5iTwUto6v7Q6pwR4%2FTutorial%20-%20Shaper%20-%20Toolbox%2015.png?alt=media&#x26;token=51f4e8f0-71ea-407e-aa9c-b485a6bba01b" alt="" width="563"><figcaption></figcaption></figure> <figure><img src="https://2764382921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUSHuV5bThAGZxy7OHb-1972196547%2Fuploads%2FKeWHaAh1UxIAvUQO9vZc%2FTutorial%20-%20Shaper%20-%20Toolbox%2016.png?alt=media&#x26;token=d76f768f-6794-4954-9e6e-273d896eba29" alt="" width="563"><figcaption></figcaption></figure></div>

Then set the desired options and colors and click on the **Export** button.

In this example, 5 SVG files will be exported to the chosen folder, named by a combination of the part number and its name.

<figure><img src="https://2764382921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUSHuV5bThAGZxy7OHb-1972196547%2Fuploads%2FQzUN5d4P0Tqb8H422tBS%2FTutorial%20-%20Shaper%20-%20Toolbox%2017.png?alt=media&#x26;token=102c8f31-aacc-4b65-8631-47e6eab2e18a" alt="" width="563"><figcaption></figcaption></figure>

### Export As Cutting Diagram

{% hint style="info" %}
Read the complete documentation [here](https://docs.opencutlist.org/features/parts/parts-list/cutting-diagrams/export).
{% endhint %}

<figure><img src="https://2764382921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUSHuV5bThAGZxy7OHb-1972196547%2Fuploads%2FbzBYlwHDi79hskVFTy9g%2FTutorial%20-%20Shaper%20-%20Toolbox%2018.png?alt=media&#x26;token=e83f109d-8dbb-4d68-906c-a4b1ade63333" alt="" width="563"><figcaption></figcaption></figure>
