MCPcopy Index your code
hub / github.com/WilkoV/Fusion360_ExportIt

github.com/WilkoV/Fusion360_ExportIt @1.2.0

Chat with this repo
repository ↗ · DeepWiki ↗ · release 1.2.0 ↗ · + Follow
6,724 symbols 11,063 edges 28 files 5,049 documented · 75%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

ExportIt

Table of content

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 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

  • Depending on the configuration a summary report is shown that might contain information, warnings or errors.

Basic summary

  • 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.

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. 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 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

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

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

  • Medium

Refinement Medium

  • High

Refinement High

  • Ultra

Refinement Ultra

  • Size

Refinement Ultra

One to many structures or refinements can be selected.

3MF Options

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 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.

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

More visual examples could be found here: Refinement Examples

STEP Options

The granularity of STEP exports is configured in this section.

STEP Options

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

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

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/ExportItTes

Core symbols most depended-on inside this repo

get
called by 194
apper/docs/source/modules/adsk/core.py
getConfiguration
called by 135
commands/ConfigurationHelper.py
info
called by 50
apper/docs/source/modules/adsk/cam.py
messageBox
called by 45
apper/docs/source/modules/adsk/core.py
add
called by 42
apper/docs/source/modules/adsk/core.py
cast
called by 38
apper/docs/source/modules/adsk/cam.py
error
called by 26
apper/docs/source/modules/adsk/cam.py
hide
called by 23
apper/docs/source/modules/adsk/core.py

Shape

Method 5,756
Class 833
Function 117
Route 18

Languages

Python100%

Modules by API surface

apper/docs/source/modules/adsk/fusion.py4,041 symbols
apper/docs/source/modules/adsk/core.py2,044 symbols
apper/docs/source/modules/adsk/cam.py287 symbols
apper/apper/Fusion360AppEvents.py57 symbols
commands/ExportItExportDesignCommand.py46 symbols
apper/apper/Fusion360Utilities.py42 symbols
apper/apper/Fusion360CommandBase.py39 symbols
apper/docs/source/modules/adsk/paramesh.py28 symbols
apper/docs/source/modules/adsk/drawing.py26 symbols
apper/apper/FusionApp.py22 symbols
apper/apper/PaletteCommandBase.py19 symbols
commands/UiHelper.py17 symbols

For agents

$ claude mcp add Fusion360_ExportIt \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact