Skip to content

Latest commit

 

History

History

SynthesisFusionAddin

README.md

Synthesis Exporter

This is a Addin for Autodesk Fusion 360 that will export a Mirabuf usable by the Synthesis simulator.

Features

  • Materials
  • Apperances
  • Instances
  • Joints
  • Static and Dynamic components
  • Mesh Quality
  • Thumbnail Capture
  • Local Save
  • Simple Motors
  • GZip compression
  • Motion Links
  • Complex Motors
  • Sending compressed file
  • File Diffs

Pre-requisites

Protobuf

You can download Protobuf v23.3 here.

Dev Tools

We use VSCode Primarily, download it to interact with our code or use your own at your own risk.

How to Build + Run

  1. See root README on how to run init script
  2. Open Autodesk Fusion 360
  3. Select UTILITIES from the top bar
  4. Click ADD-INS Button
  5. Click Add-Ins tab at the top of Scripts and Add-Ins dialog
  6. Press + Button under My Add-Ins
  7. Navigate to the containing folder for this Addin and click open at bottom - clone-directory/synthesis/exporters/SynthesisFusionAddin
  8. Synthesis should be an option - select it and click run at the bottom of the dialog
  9. There should now be a button that says Synthesis in your utilities menu

How to Debug

Debug Non Start

Most of the runtime for the addin is saved under the logs directory in this folder

  • Open logs/synthesis.log
    • If nothing appears something went very wrong (make a issue on this github)
    • If something appears and you cannot solve it feel free to make an issue anyway and include the file

General Debugging

  1. Open Autodesk Fusion 360
  2. Select UTILITIES from the top bar
  3. Click ADD-INS Button
  4. Click Add-Ins tab at the top of Scripts and Add-Ins dialog
  5. Press + Button under My Add-Ins
  6. Navigate to the containing folder for this Addin and click open at bottom - clone-directory/synthesis/exporters/SynthesisFusionAddin
  7. Synthesis should be an option - select it and click Debug at the bottom of the dialog
    • This is in a dropdown with the Run Button
  8. This should open VSCode - Now run with FN+5
    • Now you may add break points or debug at will

How to Package

Packaging is mainly for compressing the files into a smaller footprint

Contact us for information on how to use the packaging script to obfuscate all of the files using pyminifier.

How to Format

We format using a Python formatter called black Code style: black

  • install by pip3 install black or pip install black
  • use black ./src, Formats all files in src directory

Note: black will always ignore files in the proto/proto_out folder since google formats those