KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #developer-tools #cli #codex #claude-code #react #dsh-plugin #mcp #open-source #dsh #deepseek-harness

Fusion360_ExportIt

★ 34 Open GitHub ↗

This Fusion 360 add-in exports designs in various resolutions, structures and formats within one run.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# ExportIt

## Table of content

- [Table of content](#table-of-content)
- [Summary](#summary)
- [Export Design Command](#export-design-command)
  - [Basic workflow](#basic-workflow)
  - [Summary Report](#summary-report)
  - [Common Terms and Mechanics](#common-terms-and-mechanics)
  - [Configuration](#configuration)
- [Default Configuration Command](#default-configuration-command)
  - [Export](#export)
  - [Export Options](#export-options)
    - [STL Options](#stl-options)
      - [Examples](#examples)
    - [3MF Options](#3mf-options)
    - [STEP Options](#step-options)
    - [F3D Options](#f3d-options)
  - [Location](#location)
    - [Export Directory Options](#export-directory-options)
    - [Filename Options](#filename-options)
  - [Misc](#misc)
    - [Common](#common)
      - [Show Summary](#show-summary)
      - [Auto Save](#auto-save)
    - [Version Info](#version-info)
- [Elements Of The Export Name](#elements-of-the-export-name)
  - [STL Export Name](#stl-export-name)
  - [3MF Export Name](#3mf-export-name)
  - [STEP Export Name](#step-export-name)
  - [F3D Export Name](#f3d-export-name)
- [Installation](#installation)
- [Compatibility](#compatibility)
- [What's New](#whats-new)
- [Known Issus](#known-issus)
- [Wishlist](#wishlist)

## Summary

This add-in exports designs in various resolutions, structures and formats within one run. The advantages compared to the built-in command includes:

- More meaningful and configurable export names.
- The export configuration can be saved within the design, which makes it possible to export updated designs again and again at the push of a button.
- Create stl exports with different refinements and structures within one run.
- Avoid export of different occurrences of one component (optional).

## Export Design Command

This command exports the active design (or parts of it) into several formats, structures and refinements in one run. When the command starts, the user interface displays the [preconfigured default](Default-Configuration-Command) values. These can be adjusted and the changed values (deltas) can be saved in the design.

### Basic workflow

- Open design that should be exported.
- Adjust configuration (if defaults are chosen carefully very minor things have to be adjusted for the every day project).
- Start the export by hitting the *OK* button.
- If the configuration has been changed, the following message appears after the export has been completed:

![Save Configuration Reminder](https://raw.githubusercontent.com/WilkoV/Fusion360_ExportIt/main/doc/saveConfigurationReminder.png)

- Depending on the configuration a [summary report](#summary-report) is shown that might contain information, warnings or errors.

![Basic summary](https://raw.githubusercontent.com/WilkoV/Fusion360_ExportIt/main/doc/basicSummaryReport.png)

- In the case of _One File Per Body In Occurrence_ or _One File Top Level Occurrence_ STL exports, a temporary document must be closed.

### Summary Report

The summary report is grouped into the the sections _Info_, _Warning_ and _Error_. What categories are shown can be configured in the _Default Editor_ [Show Summary](#show-summary).

Category | Syntax | Description | Example
---------|----------|----------|---------
 Info | FileType: + FullFileName | Successfully exported object| f3d: D:/Download.../Blocks.Block.f3d
 Warning | FileType: + (Type) + FullFileName  | Successfully exported component, but meshes are missing | step: (Mesh) D:/Download.../Blocks.Block.step
 Warning | FileType: + (Type) + OccurrenceName  | Bodies should be exported but this component contains meshes that are not exported | stl: (Link) MixedBlock:1
 Error | FileType: + (Type) + FullFileName  | File couldn't be created because of external links | f3d: (Link) D:/Download.../Blocks.f3d

### Common Terms and Mechanics

- The term components is synonymously used with the term component in Fusion 360 but with the restriction that's restricted to the first occurrence.
- The term occurrences is borrowed from the API and is used to describe all occurrences of a component.
- This add-in is based on the provided API and therefore Fusion 360 exports cannot contain any linked components. Creation of .f3z files is not possible.

### Configuration

Most parameters correspond to those from the [Default Configuration Command](#default-configuration-command). The one exception is the field _Export Bodies_ that is used to select bodies to limit the exported to a subset of the design. Export formats like STEP or F3D don't support exports of single bodies and will interpret this selection as a selection of a component / occurrence and may contain more than one body.
Not all fields shown in the [Default Configuration Command](#default-configuration-command) are also used in this command.

## Default Configuration Command

This command allows the definition of the default configuration that is used in the *Export Design* dialog. The commands is located in the workspace *EXPORTIT*. Some of the fields in this section are only shown in the _Export Design Command_.

The user interface is divided into the following sections:

### Export

This tab provides all functions to configure what export formats are created and how they're structured.

### Export Options

Export options are top level filters that are applied to STL, STEP or F3D exports.

![Export Options](https://raw.githubusercontent.com/WilkoV/Fusion360_ExportIt/main/doc/exportOptions.png)

Label | Option | Description
---------|----------|---------
Export Types | stl | Enables or disables the export of STL files
Export Types | step | Enables or disables the export of STEP files
Export Types | f3d | Enables or disables the export of F3D files
Exclude Components | List of components with bodies | Checked components and including sub-components are not exported. This option will not effect exports with the structure _One File_
Exclude Links | | If checked references to external designs (links) are not exported. This option will not effect exports with the structure _One File_

#### STL Options

The behavior of STL export is configured in this section. Following options are available:

![Stl Options](https://raw.githubusercontent.com/WilkoV/Fusion360_ExportIt/main/doc/stlOptions.png)

Structures are used to define the granularity of exports.

Option |Description
---------|---------
One File | This structure corresponds to the built-in one and creates one file containing all visible BRep bodies.
One File Per Body In Component | A component can have many occurrences in one design. This option will export each component only once regardless of the number of occurrences. It creates one file per body (or per selected body) in a component. Due to this filter, it will not keep the original position in the 3d space. This structure is e.g useful if a design reuses components and wants to keep the number of exported files small.
One File Per Body In Occurrence | This option corresponds to the integrated *One File Per Body*, but does not create double exports of the same body and works with selected bodies, too. It maintains the positions of the bodies at different occurrences. This structure is useful if the stl files are reassembled at a later point - e.g. in a slicer for multi color / multi material 3d prints.
One File Top Level Occurrence | This option creates one file for each top level occurrence. It's useful if the occurrences are used treated as logical groups like colors or materials and the stl files are reassembled at a later point. In comparison to _One File Per Body In Occurrence_ this option creates less files but needs a special workflow / structure during the design process.

Refinements can roughly be described as the mesh density of an export. Following refinements are pre-configured.

Option |Description
---------|---------
Low | This option corresponds to the built-in one.
Medium | This option corresponds to the built-in one.
High | This option corresponds to the built-in one.
Ultra | This one is based on the built-in *High* settings, but sets surface deviation to 0.000508mm and normal deviation to 15. This results in a much finer mesh and is great for very detailed geometry or large, roundish objects.
Custom | This option enables the definition of surface deviation, normal deviation, maximum edge length and the aspect ratio

##### Examples

- Low

![Refinement Low](https://raw.githubusercontent.com/WilkoV/Fusion360_ExportIt/main/doc/refinementLow.png)

- Medium

![Refinement Medium](https://raw.githubusercontent.com/WilkoV/Fusion360_ExportIt/main/doc/refinementMedium.png)

- High

![Refinement High](https://raw.githubusercontent.com/WilkoV/Fusion360_ExportIt/main/doc/refinementHigh.png)

- Ultra

![Refinement Ultra](https://raw.githubusercontent.com/WilkoV/Fusion360_ExportIt/main/doc/refinementUltra.png)

- Size

![Refinement Ultra](https://raw.githubusercontent.com/WilkoV/Fusion360_ExportIt/main/doc/refinementFileSizes.png)

One to many structures or refinements can be selected.

![3MF Options](https://raw.githubusercontent.com/WilkoV/Fusion360_ExportIt/main/doc/stlOptions.png)

#### 3MF Options

The behavior of 3MF export is configured in this section. The export of of 3MF files behaves the same as the STL exports. Following options are available:

![3mf Options](https://raw.githubusercontent.com/WilkoV/Fusion360_ExportIt/main/doc/3mfOptions.png)
Structures are used to define the granularity of exports.

Option |Description
---------|---------
One File | This structure corresponds to the built-in one and creates one file containing all visible BRep bodies.
One File Per Body In Component | A component can have many occurrences in one design. This option will export each component only once regardless of the number of occurrences. It creates one file per body (or per selected body) in a component. Due to this filter, it will not keep the original position in the 3d space. This structure is e.g useful if a design reuses components and wants to keep the number of exported files small.
One File Per Body In Occurrence | This option corresponds to the integrated *One File Per Body*, but does not create double exports of the same body and works with selected bodies, too. It maintains the positions of the bodies at different occurrences. This structure is useful if the 3mf files are reassembled at a later point - e.g. in a slicer for multi color / multi material 3d prints.
One File Top Level Occurrence | This option creates one file for each top level occurrence. It's useful if the occurrences are used treated as logical groups like colors or materials and the 3mf files are reassembled at a later point. In comparison to _One File Per Body In Occurrence_ this option creates less files but needs a special workflow / structure during the design process.

Refinements can roughly be described as the mesh density of an export. Following refinements are pre-configured.

More visual examples could be found here: [Refinement Examples](#Examples)

#### STEP Options

The granularity of STEP exports is configured in this section.

![STEP Options](https://raw.githubusercontent.com/WilkoV/Fusion360_ExportIt/main/doc/stepOptions.png)

Structures are used to define the granularity of exports.

Option |Description
---------|---------
One File | This structure corresponds to exporting the root component with the built-in function and creates one file containing all visible BRep bodies.
One File Per Component | This function corresponds to exporting a selected component but will create one file per component or selected component.

One to many structures can be selected.

#### F3D Options

The granularity of F3D exports is configured in this section.

![F3D Options](https://raw.githubusercontent.com/WilkoV/Fusion360_ExportIt/main/doc/f3dOptions.png)

The granularity of STEP exports is configured in this section.

Option |Description
---------|---------
One File | This structure corresponds to exporting the root component with the built-in function and creates one file containing all visible BRep bodies. This add-in is based on the provided API and therefore Fusion 360 exports cannot contain any linked components. Creation of .f3z files is not possible.
One File Per Component | This function corresponds to exporting a selected component but will create one file per component or selected component.

One to many structures can be selected.

### Location

This tab provides all functions to configure the export directory and the filename.

#### Export Directory Options

This section allows the definition of the components of the export directory and when the directory is selected.

![Export Directory](https://raw.githubusercontent.com/WilkoV/Fusion360_ExportIt/main/doc/exportDirectory.png)

The full path can be composed out of the export directory, the project name, the design name and the export type (stl, stp, f3d).

Label | Option | Description | Example
---------|-------|-----------|--------
Configure Export Directory | As Base Directory| This option is useful if all exports (cross-project) normally use a common base directory and the individual projects are separated from each other by the generated directory.| D:/Google Drive/3d Printing/Fusion 360
Configure Export Directory | When Exporting A New Design | This option is useful if cross-project exports do not have a common base directory, but the exports of a design are always saved in the same export directory. | C:/Temp/MySpecialDesign
Configure Export Directory | For Each Export | This option forces the selection of an export directory on each export. | C:/Temp
Reset Export Directory | Checked / Unchecked | If activated, the dialog for selecting a base / export directory is displayed after the _Default Configuration_ command has been closed by pressing _OK_ or by starting an export in the _Export Design_ command. |
Export Directory | Checked / Unchecked| Target directory of the export or base directory of all exports | D:/Google Drive/3d Printing/Fusion 360
Add Project Name | Checked / Unchecked| If checked the project name will be added to the export path | D:/Google Drive/3d Printing/Fusion 360/ExportItTest
Add Design Name |Checked / Unchecked | If checked the design name will be added to the export path | D:/Google Drive/3d Printing/Fusion 360/ExportItTest/01-Default
Add Export Type |Checked / Unchecked | If checked the name of the export type (stl, step) to the export path | D:/Google Drive/3d Printing/Fusion 360/ExportItTest/01-Default/step
Add Refinement Name |Checked / Unchecked | If checked and the export type is STL the refinement name will be added to the export path | D:/Google Drive/3d Printing/Fusion 360/ExportItTest/01-Default/stl - low/

#### Filename Options

The elements of a filename and how they're connected are configured in this section.

![Filename Options](https://raw.githubusercontent.com/WilkoV/Fusion360_ExportIt/main/doc/filenameOptions.png)

Following options are used for better grouping of exports.

Label | Options | Description
---------|----------|---------
Add Project Name |  | Adds the project name as a prefix to the filename.
Add Design Name |  | Adds the design name as a prefix to the filename. This is useful if a project contains several designs and the design name is not part of the export directory (more [here](#export-directory-options))

Filters are used to make filenames more (stable e.g. for external versioning), more readable or to remove characters that are not supported by the filesystem.

Label | Options | Description | Example
---------|----------|----------|---------
Remove Version Tags |  | Removes the version tags from the design name and linked components. | 01-Default v5 -> 01-Default
Element Separator Tags | . | This options uses a "." (dot) as the separator. | 01-Default.Component.Component.BodyName
Element Separator Tags | - | This options uses a "-" (dash) as the separator. | 01-Default-Component-Component-BodyName
Element Separator Tags | \_ | This options uses a "_" (underscore) as the separator. | 01-Default\_Component\_Component\_BodyName
Occurrence ID Separator | . | This options uses a "." (dot) as the separator. | 01-Default.Component.1.Component.2.BodyName
Occurrence ID Separator | - | This options uses a "-" (dash) as the separator. | 01-Default-Component-1.Component-2.BodyName
Occurrence ID Separator | \_ | This options uses a "_" (underscore) as the separator. | 01-Default\_Component\_1.Component\_2.BodyName
Replace Spaces | True / False | This option enables the replacement of spaces in the filename. | 08-ReplaceSpaces.just-a-block_1.Body1.low.stl
Replace Spaces With | . | This options uses a "." (dot) as a replacement. | 08-ReplaceSpaces.just.a.block_1.Body1.low.stl
Replace Spaces With | - | This options uses a "-" (dash) as a replacement. |  08-ReplaceSpaces.just-a-block_1.Body1.low.stl
Replace Spaces With | | Uses the part id of a component instead of the component name |  08-ReplaceSpaces.just\_a\_block_1.Body1.low.stl
Replace Component Name With Part Number | \_ | This options uses a "_" (underscore) as a replacement. |  09-component-partNumber.123

More details about the components of the export name can be found [here](#elements-of-the-export-name).

### Misc

This tab provides various functions to configure the general behavior of the add-in or the UI

#### Common

This section provides functions to configure the behavior of the UI and the add-in

##### Show Summary

Like for logging levels, this parameter controls what level of messages are shown in the summary message at the end of an export.

![Show Summary](https://raw.githubusercontent.com/WilkoV/Fusion360_ExportIt/main/doc/showSummary.png)

Level | Description
---------|---------
Info | Information are created for successfully created exports. If this level is activated warnings and errors are also shown.
Warning | Warning are created if a f3d export contains references (links) to external designs. If this level is activated errors are shown, tool.
Error | Errors are created if an export fails.

##### Auto Save

If _Auto Save_ is enabled and the configuration is changed, the active document will be saved to store the embedded _ExportIt project configuration_. The _Auto Save Message_ will be applied as a version description.

![Auto Save](https://raw.githubusercontent.com/WilkoV/Fusion360_ExportIt/main/doc/autoSave.png)

#### Version Info

This section allows the configuration of the check interval and shows the download URL if an update is available.

![Version Info](https://raw.githubusercontent.com/WilkoV/Fusion360_ExportIt/main/doc/versionInfo.png)

Label | Description
---------|---------
Version Check Interval | Defines the polling interval in days. Minimal value = 1, maximal value = 30.
Download URL | This field is only available if a new release can be downloaded.

## Elements Of The Export Name

The export name is composed out of the prefix, the name and the suffix.

Group | Element | Configurable | Description
---------|----------|----------|---------
Prefix | Project name | Yes | Name of the project.
Prefix | Design name | Yes | Name of the design.
Name | Occurrence path | No | Bodies are stored in a component. A component is internally wrapped by an occurrence object. Occurrences can be nested and projects can be organized this way. Depending on the chosen export structure and export format, the export logic can add the occurrence path to a body to the export name.
Name | Body name | No | Depending on the chosen export structure and the export format, the export logic can add the name of the body to the export format.
Suffix | Refinement name | No | If more than one refinement is configured for a STL export, the export logic adds the refinement name to the export name to ensure a unique export name.
Suffix | Export type | No | The system adds always the export type to the export name.

What elements are used depends on the user driven configuration, the export format and the chosen structure. The export logic always tries to make the filename as unique as possible. Even if a filename might be unique in the export directory, it might not be unique anymore in unstructured uploads to e.g. [Thingiverse](https://www.thingiverse.com/), [Cults3d](https://cults3d.com/en) or [PrusaPrinters](https://www.prusaprinters.org/). The logic tries to avoid such conflicts.

Following combinations are defined (elementSeparator = '.', occurrenceSeparator = '\_', projectName = False, removeVersionTag = True):

### STL Export Name

Structure | Elements | Example
---------|----------|---------
One File | [projectName] + elementSeparator + designName + refinementName + "." + suffix| 01-Default.low.stl
One File Per Body In Component | [projectName] + elementSeparator + [designName] + elementSeparator + occurrencePathWithoutOccurrenceIDs + elementSeparator + bodyName + elementSeparator + refinementName + "." + suffix | 01-Default.blocks.mixed.bodyInComponentWithSubComponents.low.stl
One File Per Body In Occurrence | [projectName] + elementSeparator + [designName] + elementSeparator + occurrencePathWithOccurrenceIDs + elementSeparator + bodyName + elementSeparator + refinementName + "." + suffix | 01-Default.blocks_1.deep_1.deeper_1.deepest_1.block_5.Body1.low.stl
One File Per Top Level Occurrence | [projectName] + elementSeparator + [designName] + elementSeparator + topLevelOccurrenceWithOccurrenceIDs + elementSeparator + refinementName + "." + suffix | 08-TopLevelComponentsAsOneFile.green_2.low.stl

### 3MF Export Name

Structure | Elements | Example
---------|----------|---------
One File | [projectName] + elementSeparator + designName + refinementName + "." + suffix| 01-Default.low.3mf
One File Per Body In Component | [projectName] + elementSeparator + [designName] + elementSeparator + occurrencePathWithoutOccurrenceIDs + elementSeparator + bodyName + elementSeparator + refinementName + "." + suffix | 01-Default.blocks.mixed.bodyInComponentWithSubComponents.low.3mf
One File Per Body In Occurrence | [projectName] + elementSeparator + [designName] + elementSeparator + occurrencePathWithOccurrenceIDs + elementSeparator + bodyName + elementSeparator + refinementName + "." + suffix | 01-Default.blocks_1.deep_1.deeper_1.deepest_1.block_5.Body1.low.3mf
One File Per Top Level Occurrence | [projectName] + elementSeparator + [designName] + elementSeparator + topLevelOccurrenceWithOccurrenceIDs + elementSeparator + refinementName + "." + suffix | 08-TopLevelComponentsAsOneFile.green_2.low.3mf

### STEP Export Name

Structure | Elements | Example
---------|----------|---------
One File | [projectName] + elementSeparator + designName + suffix| 01-Default.step
One File Per Component | [projectName] + elementSeparator + [designName] + elementSeparator + occurrencePathWithoutOccurrenceIDs + suffix | 01-Default.blocks.mixed.step

### F3D Export Name

Structure | Elements | Example
---------|----------|---------
One File | [projectName] + elementSeparator + designName + suffix| 01-Default.f3d
One File Per Component | [projectName] + elementSeparator + [designName] + elementSeparator + occurrencePathWithoutOccurrenceIDs + suffix | 01-Default.blocks.mixed.f3d

## Installation

- Navigate to the add-in directory. Depending on the operating system, they can be found at *%appdata%\Autodesk\Autodesk Fusion 360\API\AddIns* (Microsoft® Windows® 10) or *~/Library/Application Support/Autodesk/Autodesk Fusion 360/API/AddIns* *Apple® macOS™*.
- Download the software from [here](https://github.com/WilkoV/Fusion360_ExportIt/releases) and unpack the downloaded archive.
- Alternatively clone the repository with *git clone --progress -v "https://github.com/WilkoV/Fusion360_ExportIt.git" "ExportIt"*.
- Finish the installation in Fusion 360 by navigating to *Tools->Add-ins->Scripts and Add-ins->Add-ins*, select ExportIt, check *Run on Startup* and press *Run*

![Run Addin On Startup](https://raw.githubusercontent.com/WilkoV/Fusion360_ExportIt/main/doc/runAddinOnStartup.gif)

## Compatibility

This add-in is developed and tested on a Microsoft® Windows® 10 system but should run on Apple® macOS™ just fine.

## What's New

Version | Date | Description
---------|----------|---------
0.1.0 | 09.07.2020 | Initial version that includes a defaults editor and stl exports that supports different structures and refinements.
0.2.0 | 15.07.2020 | Main enhancement is the addition of STEP exports. Additionally basic configuration validation is added.
0.3.0 | 21.07.2020 | Main enhancement is the addition of F3D exports. Additionally a progress dialog is shown on larger exports and a summary message is shown at the end of an export.
0.4.0 | 22.07.2020 | UI cleaned up by adding _Export_, _Location_ and _Misc_ tabs. Filename filter added to remove spaces from filenames. Export filter added that prevents linked components to be exported.
0.5.0 | 04.08.2020 | A checkbox is added that allows to reset the base directory / export directory after closing the _Default Configuration_ command with the _OK_ button or by starting an export in the _Export Design_ command. The new workflow closes the issue #1 and the new checkbox closes the enhancement #8. In addition, the concept of the export directory is no longer based only on the idea of a standard / base directory. It can now be better adapted to different workflows by enabling the configuration of a base directory or the configuration of the export directory when exporting a new design for the first time, or by having to configure the export directory every time an export is triggered. The new options close the enhancement #7.
0.6.0 | 15.08.2020 | Some artists use top-level components to group bodies or sub-components by color or material. These groups are then also used for the final STL export. The new STL option _One File Top Level Occurrence_ complies with these exports. Documentation slightly enhanced.
0.7.0 | 31.08.2020 | _Custom_ STL refinements added in case the predefined refinements _Low_, _Medium_, _High_ and _Ultra_ do not match the use case. _Exclude Components_ filter added to the _Export Options_. In contrast to the selection filter _Export Bodies_, this filter is saved in the project configuration and used for every export of the design. Useful for imported subassemblies that don't maintain the link (broken) anymore. This closes the enhancement #13. Referenced sub-assemblies are now handled correctly, if "Exclude Links" is activated. This fixes issue #12. Framework configuration config.py renamed to avoid conflicts with other add-ins that are using the [apper framework](https://github.com/tapnair/apper). This fixes #14.
0.7.1 | 03.09.2020 | 0.7.0 did not correctly raise the version flag and therefore did not initialize the new functions
0.8.1 | 20.10.2020 | fixes #21, documentation and summary report enhancement based on #20 added. Empty components removed from components filter based on #20. API behavior changed with Fusion 360 (2.0.9142) and this change makes it compatible with the new behavior and closes #24
0.8.2 | 26.10.2020 | With 2.0.9144 the STL export of occurrences wasn't working anymore. #27 fixes this issue.
0.8.3 | 20.03.2020 | Apper framework updated
0.8.4 | 20.03.2020 | Apper framework updated
0.9.0 | 21.09.2021 | 3mf exports added
1.0.0 | 22.10.2021 | Name issue for some 3mf exports fixed. Apper framework updated
1.1.0 | 09.07.2021 | Refinement names can now be added to the export path. This also fixes #40.
1.2.0 | 25.11.2023 | Components can now be exported by using the name or the part id in filenames.

## Known Issus

- [STL exports with the structure "One File Per Body In Occurrence" does not close the temporary document.](https://github.com/WilkoV/Fusion360_ExportIt/issues/2)

## Wishlist

- [ ] Export of selected occurrences.
- [ ] Special refinement for selected bodies that is stored in the project configuration.
- [ ] Export of projects.
- [ ] Selection of stl format (text / binary).

Fusion360_ExportIt

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README