Need help with Fusion360Image2Surface?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

190 Stars 27 Forks Other 39 Commits 1 Opened issues


Image2Surface Script for Autodesk Fusion 360

Services available


Need anything else?

Contributors list

Fusion 360 Image 2 Surface Add-In

This is an Autodesk Fusion 360 add-in that's used for generating surfaces from images.


Moon - Height map Moon Surface Example

This surface was created from a small height map of a crater on Earth's moon. The first image is the mesh created from the script. The second is the T-Spline surface created from the mesh.

Moon - Mesh generated from Image2Surface

Moon - T-Spline created from mesh

Penny - Height map Milled Penny Example

This is a penny that was milled out of a 4"x4" block of 6061 Aluminum. The surface was created from a height map of a penny. The mesh was then converted to a T-Spline then merged onto a cube. That model was brought into the CAM environment where the various milling operations were defined. Finally, it was milled on a Haas CNC vertical milling machine.

Penny - Milled from 4"x4" block of 6061 Aluminum

Penny - Adaptive clearing of surface

Penny - Morphed spiral milling

How to install a Fusion 360 Add-In

Please see the most recent add-in install instructions here:

Download the archive file (ZIP) from Github by clicking on the "Clone or download" button and then selecting "Download ZIP":

Github Download ZIP

Unarchive this file into the Addins folder and once created, rename the folder created from the Zip archive name "" to "Image2Surface":

Fusion 360 Addins Folder

You will then be able to use the Fusion 360 Scripts and Addins Manager to add this folder, and thus the addin, to Fusion. Note, select the "Run on Startup" checkbox if you would like the add-in automatically started when Fusion 360 starts up. This is useful if you will be using the add-in often.

The first time you run the Image2Surface add-in, it will add itself to the Add-ins panel dropdown of the Model environment. It should appear as an entry with the label "Show Image 2 Surface".


Important: This add-in requires the document to be in parametric modeling mode (i.e. Capturing design history).

  1. Enter the Model environment
  2. Run the Image2Surface add-in from the Scripts and Add-Ins Manager. Note, select the "Run on Startup" checkbox if you would like the add-in automatically started when Fusion 360 starts up and avoid having to manually run each time.

Run Add-In

  1. Display the Image 2 Surface Palette.

Display Image 2 Surface Palette

  • Click on the ADD-INS dropdown and then click on the "Image 2 Surface" menu item. This should display the palette.
    • If the menu item isn't there then there might have been a problem running the add-in. Go back to step 2 and try again.

Image 2 Surface Palette

  • This palette window contains a preview of the surface mesh that will be generated as well as controls for adjusting the mesh.
    1. Select an image file
  • Drag and Drop an image file onto the palette window. It should be displaying the text "Drop Image Here". If not, click the "Clear Image" button.
  • TODO: Alternatively, click the "Open Image File" button and then select the file in the fial dialog.
  • WARNING: overly large images may cause problems (even crash the app). Please work with images under 1000x1000 at first. If you would like to try larger images, please save your work first in case loading the large image causes a crash.
    1. Preview the surface mesh
  • If the image is loaded correctly, it we be converted to a prelimary mesh and displayed in the view.
  • Adjust View
    • Left mouse button to rotate the view
    • Middle mouse button to pan the view
    • Mousewheel to zoom in/out
    • Adjust the mesh parameters

Image of Parameters

  • In the upper right of the view is small dialog containing parameters that control the mesh:
    • Pixels to Skip:
      • This is the number of pixels to skip over for each row and column on the source image
    • Stepover (mm):
      • This is the distance in millimeters between each mesh grid line.
    • Max Height (mm):
      • This is the max height in millimeters of each grid node. Each node's height is based on the color of the associate image pixel. Black maps to zero (0) and pure white to the "Max Height" value. Or the inverse if Invert checked.
    • Invert Heights:
      • If checked then black maps to "Max Height" and pure white to zero (0).
    • Smooth:
      • Apply a smoothing to the values to help reduce sharp ridges.
    • Absolute (B&W):
      • If checked then the height is based on the average of the pixel RGB value. Otherwise, it takes into account the human perceptual bias of the RGB individual values.
    • Generate a surface/mesh
  • When ready to generate a mesh within the active document, click the "Generate Surface" button.

Once the mesh generated it will be added to the active drawing. You might have to "fit" the view to see it.

If you have created a mesh then it's useful to convert it to a T-Spline or BREP for further modification. Note, Fusion has a limitation on the size of the mesh that can be converted to a BREP (around 10K faces). With a T-Spline or BREP surface it's possible to CNC or 3D print.

  • Convert the Mesh to a T-Spline
  1. Click on the "Create Form" button on the toolbar to enter the "Sculpt" environment
  2. Click on the "Utilities" button and then the "Convert" item to display the dialog:

    Convert Mesh Dialog

  3. In the dialog, select the "Quad Mesh to T-Spline" type

  4. For the "Selection", select the mesh in the drawing then click OK

  • Convert the Mesh to a BREP
  1. Enter the Model environment
  2. Select the Create->Create a Base Feature item from the toolbar
  3. Right-click/Ctrl-click on the mesh and in the context menu, select Mesh to BRep.
  4. In the dialog displayed, the mesh should already be selected. Click OK.

Here's the heightmap image of the moon's surface that was used to generate the mesh and t-spline shown at the top of the page.

Moon Heightmap

And here's the t-spline in the CAM environment being used to create toolpaths for milling:

Moon CAM Toolpaths

More examples posted on my Fusion 360 project gallery.

Trouble Shooting

  • Add-in fails to load. Verify that the add-in has been placed in its own folder within the Addins folder. If the files are not placed in their own folder then Fusion 360 will tend to fail loadin the add-in.
  • Large images can create large meshes which can cause Fusion 360 to take a very long time to process. Or the app may just fail. Try using a smaller resolution image.


  • 2016.02 : Fusion 360 has a 10K limitation on mesh size when converting to a BREP. Any larger and it fails.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.