# Smart Export Tool

{% hint style="info" %}
The Smart Axes Tool was introduced in version 6.0.0.
{% endhint %}

It is accessible from the export icon in the toolbox or the *OpenCutList → Export* *Parts* menu.

<figure><img src="https://2764382921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUSHuV5bThAGZxy7OHb-1972196547%2Fuploads%2Fhaall4IB0Tu9hqKyd4tt%2FCapture%20d%E2%80%99e%CC%81cran%202024-02-10%20a%CC%80%2007.34.15.png?alt=media&#x26;token=40c95897-4369-4850-8bae-755c498eaf84" alt="" width="563"><figcaption></figcaption></figure>

This tool is a concentrate of magical things. We have developed it with the aim of covering a maximum  of needs with a minimum of user actions, while at the same time providing a real-time preview in the 3D model of what will be exported.

To achieve this, this tool focuses on exporting the 3D or 2D geometry of a single element through 3 types of action.

## Actions

Smart Export Tool supports these actions: Export 3D part, Export 2D part, and Export face. Each action has several options. All possible actions are visible at the top of the screen.

### Export 3D Part

The **Export 3D part** action allows you to export the 3D [polygon mesh](https://en.wikipedia.org/wiki/Polygon_mesh) geometry of a single part as an **STL** or **OBJ** file.

<figure><img src="https://2764382921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUSHuV5bThAGZxy7OHb-1972196547%2Fuploads%2Fvntfqn3FxZJ5EOXfjDlN%2FSmart%20Export%20Tool%20-%20Export%203D%20Part.png?alt=media&#x26;token=fdb027f8-6882-48cd-9e01-0cdff5a812c6" alt="" width="563"><figcaption></figcaption></figure>

Once this action is activated, just point and click on a part in the model to export it.

{% hint style="info" %}
A part is a SketchUp **component** instance with a <mark style="color:red;">**non-zero volume**</mark>.
{% endhint %}

#### Supported Formats

The 3D geometry can be exported to files with the following formats:

* **STL** : [Stereolitography](https://en.wikipedia.org/wiki/STL_\(file_format\))&#x20;
* **OBJ** : [Wavefront OBJ](https://en.wikipedia.org/wiki/Wavefront_.obj_file)

#### Export Options

* **Unit** : Defines the unit used in the exported file.
* **Anchor Point** : This options preserves the location of the origin of the coordinate axes of the SketchUp component of this 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).

{% hint style="success" %}
Click on the *More* button at the top of the screen to access all options and use presets.
{% endhint %}

<figure><img src="https://2764382921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUSHuV5bThAGZxy7OHb-1972196547%2Fuploads%2FhrQKrBn72QCFfJRUolTO%2FSmart%20Export%20Tool%20-%20Export%203D%20Part%20-%20Modal.png?alt=media&#x26;token=85091242-43ac-4a24-8084-91a3be5e4893" alt="" width="563"><figcaption></figcaption></figure>

### Export 2D Part

The **Export 2D part** action allows you to export a 2D projection of a part as an **SVG** or **DXF** file. Note that it is more powerful than just a face exporter.

<figure><img src="https://2764382921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUSHuV5bThAGZxy7OHb-1972196547%2Fuploads%2Fl05Y2qyv8ldV5X3B3b5S%2FSmart%20Export%20Tool%20-%20Export%202D%20Part.png?alt=media&#x26;token=47cb7a0e-fb74-45fb-b762-bf7570db05dd" alt="" width="563"><figcaption></figcaption></figure>

Once this action is activated, just point and click on a drawing face of a part in the model to export the **2D projection** along the plane of this face. This allows you to quickly choose the projection plane according to which you wish to export the part. You can also point at an edge to align the <mark style="color:red;">red</mark> axis (x).

<figure><img src="https://2764382921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUSHuV5bThAGZxy7OHb-1972196547%2Fuploads%2Fp8SwldPkbt4Qs4z1f1gH%2FSmart%20Export%20Tool%20-%20Export%202D%20Part%20-%20Animation.gif?alt=media&#x26;token=7bc3c10b-6040-463c-b248-b6e016de281b" alt=""><figcaption></figcaption></figure>

The projection algorithm slices the 3D geometry in several coplanar layers.&#x20;

Along the projection direction, the top most face determines the depth zero layer. All other layers are calculated in relation to this one.

If a face is curved (a smooth surface) or not coplanar to the projection plane, the projection of the face will  flatten up that face to its top most point. In the Figure below, two such faces are shown as horizontal blue rectangles. Coplanar faces will be merged.

<figure><img src="https://2764382921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUSHuV5bThAGZxy7OHb-1972196547%2Fuploads%2F7eEfia8VuBf5kR9cAr0u%2FSmart%20Export%20Tool%20-%20Export%202D%20Part%20-%20Top%20most.png?alt=media&#x26;token=38ecceca-a2e7-453a-9724-12bbeb8b047f" alt="" width="375"><figcaption></figcaption></figure>

The tool displays a preview of the exported layer in the 3D model.&#x20;

The projection plane is shown as a black dashed rectangle, and each layer is represented by a blue line. The dark blue lines correspond to the zero depth layer, and the light blue lines correspond to the other layers.

Hidden faces or hidden portions of faces are ignored.

<figure><img src="https://2764382921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUSHuV5bThAGZxy7OHb-1972196547%2Fuploads%2FmeoPMp1F41Nw4iOovTOy%2FCapture%20d%E2%80%99e%CC%81cran%202024-02-11%20a%CC%80%2012.42.41.png?alt=media&#x26;token=63e7646c-5e08-4510-900a-dfafcb8ab818" alt="" width="375"><figcaption></figcaption></figure>

#### Supported Formats

The 2D projection can be exported to files in the following formats:

* **SVG** : [Scalable Vector Graphics](https://en.wikipedia.org/wiki/SVG)
* **DXF** : [AutoCAD DXF](https://en.wikipedia.org/wiki/AutoCAD_DXF)

#### Face Projections

This option determines which faces should be included in the export. The target face is the face that gets the click.

* **1** : Use only the target face.
* **∞** : Use all parallel faces of the part.

#### Export Options

* **Unit** : Defines the unit used in the exported file.
* **Anchor point** : This options preserves the location of the coordinate axes of the SketchUp component of this 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).
* **Smoothing** : Smooth circles and arcs. [*Learn more*](#smoothing)*.*
* **Merging Mode** : [Learn more](#merging-mode)
  * *Default* : The part shape is exported with one 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** : Enables the use of edges, which are not associated with a face contained in the part, to export them as a path. [Learn mode](#paths).
* **Parts colors** : Customize the line and fill *(SVG only)* colors of exported parts.
* **Drillings colors** : Customize the line and fill *(SVG only)* colors of exported part's drillings.
* **Paths colors** : Customize the line color of exported paths.

{% hint style="success" %}
Click on the *More* button at the top of the screen to have access to all options and to be able to use presets.
{% endhint %}

<figure><img src="https://2764382921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUSHuV5bThAGZxy7OHb-1972196547%2Fuploads%2Fk5NGd4nktgeCWLS73rde%2FCapture%20d%E2%80%99e%CC%81cran%202024-02-11%20a%CC%80%2011.15.29.png?alt=media&#x26;token=cb708ba3-0955-4ed9-bdd3-a8e43de5517e" alt="" width="563"><figcaption></figcaption></figure>

### Export Face

The **Export face** action allows you to export a 2D projection of a drawing face to a **SVG** or **DXF** file.

<figure><img src="https://2764382921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUSHuV5bThAGZxy7OHb-1972196547%2Fuploads%2FI0sLL1fYKhj18h2L303X%2FSmart%20Export%20Tool%20-%20Export%20face.png?alt=media&#x26;token=44104255-464e-43d6-bb3c-0cc909140612" alt="" width="563"><figcaption></figcaption></figure>

Once this action is activated, simply point and click on a face drawn in the model to export it.

{% hint style="success" %}
This face can be drawn outside of a group or component, but there are less options than with Export 2D part.
{% endhint %}

#### Supported Formats

* **SVG** : [Scalable Vector Graphics](https://en.wikipedia.org/wiki/SVG)
* **DXF** : [AutoCAD DXF](https://en.wikipedia.org/wiki/AutoCAD_DXF)

#### Export Options

* **Unit** : Defines the unit used in the exported file.
* **Smoothing** : Smooth circles and arcs. [*Learn more*](#smoothing).
* **Parts colors** : Customize the line and fill *(SVG only)* colors of exported faces.

{% hint style="success" %}
Click on the *More* button at the top of the screen to have access to all options and to be able to use presets.
{% endhint %}

<figure><img src="https://2764382921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUSHuV5bThAGZxy7OHb-1972196547%2Fuploads%2FPSWZcmLYqa8hCytlLScf%2FSmart%20Export%20Tool%20-%20Export%20Face%20-%20Modal.png?alt=media&#x26;token=54818003-dfc6-410f-9937-7387dc882033" alt="" width="563"><figcaption></figcaption></figure>

### Shortcuts

* use `TAB` (left to right) or `SHIFT` + `TAB` (right to left) to navigate through actions.
* use `CTRL` + `TAB` (Windows) or `OPTION` + `TAB` (Mac) to navigate through action's modifier.

## Advanced Options

### Smoothing

To overcome SketchUp's technical limitations in terms of circles and arcs, we have developed a curve detection algorithm.

This algorithm is able to detect **circles**, **ellipses** and **arcs** from the contour of a face or a curve. Circles need not to be known to SketchUp.&#x20;

Once this option is activated, the detected portions are emphasized with a **bolder line**.

<figure><img src="https://2764382921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUSHuV5bThAGZxy7OHb-1972196547%2Fuploads%2FL1oV7lKOFmtdC7jceM2p%2FSmart%20Export%20Tool%20-%20Smoothing.png?alt=media&#x26;token=be53690f-6902-497c-8b35-8d72dd5e83a8" alt="" width="563"><figcaption><p>Part with 2 Detected Circles/Arcs</p></figcaption></figure>

{% hint style="warning" %}

### Limitations

* Only **circle**, **ellipse** and **arcs** of circle or ellipse are detected.
* Arc portions with less than **6 edges** cannot be detected.
* The minimum angle formed by the two ends of an edge is **45 degrees**.
  {% endhint %}

### Merging Mode

By default the 2D projection algorithm slices the 3D geometry in layers that contain only projected faces that correspond to their depth.

By enabling *Outline + Drillings + Merge,* the algorithm will go further :&#x20;

* **Through holes** will be detected. They are drawn with a purple line in preview.
* Depth zero layer now contains the full merged **outline** of the part, without any holes.
* Sub layers are merged by cavity.

<div><figure><img src="https://2764382921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUSHuV5bThAGZxy7OHb-1972196547%2Fuploads%2F8tsMjVzJsO81z1riTHH7%2FSmart%20Export%20Tool%20-%20Merging%20Mode%20No.png?alt=media&#x26;token=5846c4de-ad00-416f-b5ad-da9e8218eb37" alt="" width="563"><figcaption><p>Merging Mode = Default</p></figcaption></figure> <figure><img src="https://2764382921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUSHuV5bThAGZxy7OHb-1972196547%2Fuploads%2FY4yuTQTQ2Jx35cLo7iuU%2FSmart%20Export%20Tool%20-%20Merging%20Mode%20Yes.png?alt=media&#x26;token=81be1fce-b26e-4bbd-beec-0bb3fb71c45e" alt="" width="563"><figcaption><p>Merging Mode = Outline + Drillings + Merge</p></figcaption></figure></div>

Let us consider a more advanced example:

<figure><img src="https://2764382921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUSHuV5bThAGZxy7OHb-1972196547%2Fuploads%2FQvzw9EzrIyoZka1aPzce%2FSmart%20Export%20Tool%20-%20Merging%20Mode%20Yes%202.png?alt=media&#x26;token=ed26fd72-982d-4f51-9cfb-a4e1b31bb0c2" alt="" width="563"><figcaption><p>Merging Mode = Outline + Drillings + Merge</p></figcaption></figure>

### Paths

In addition to exporting faces, you can now export **open** or **closed paths**. These paths could be useful for exporting non-geometric elements integrated into the part without altering its dimensions.

A **path** is a curve or a single edge that is not associated with a face.&#x20;

{% hint style="warning" %}
The path must be drawn **inside** a part component.
{% endhint %}

<div><figure><img src="https://2764382921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUSHuV5bThAGZxy7OHb-1972196547%2Fuploads%2F7exCqVcJe1vKPxAfKki9%2FSmart%20Export%20Tool%20-%20Paths.png?alt=media&#x26;token=eaf5829c-5041-48c2-9ab4-073058d08426" alt="" width="563"><figcaption><p>Preview</p></figcaption></figure> <figure><img src="https://2764382921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUSHuV5bThAGZxy7OHb-1972196547%2Fuploads%2Fi1VUIT8bNggb0ovSQuXy%2FSmart%20Export%20Tool%20-%20Paths%20Export.png?alt=media&#x26;token=59fc6d58-a6bd-4862-9f45-83ed62abf8dc" alt="" width="563"><figcaption><p>Exported result</p></figcaption></figure></div>

The best option to embed paths into a part geometry is to draw them in subgroups.

<figure><img src="https://2764382921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUSHuV5bThAGZxy7OHb-1972196547%2Fuploads%2FxEdkaRTXN5EgqhqOv5JZ%2FSmart%20Export%20Tool%20-%20Paths%20Groups.png?alt=media&#x26;token=415bc25d-f262-43a4-82d7-64bf50c35342" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="warning" %}
To ensure that continuous paths are not split into multiple edges, weld the edges together to convert them into SketchUp curves.
{% endhint %}
