Export to STL or OBJ: Difference between revisions

From FreeCAD Documentation
mNo edit summary
(Wiki code.)
Line 19: Line 19:


<!--T:3-->
<!--T:3-->
You can use your own FreeCAD file, but you could also create a quick test file by
You can use your own FreeCAD file, but you can also create a quick test file:
* Opening FreeCAD
# Open FreeCAD.
* Create a new document
# Create a new document.
* Switch to [[Image:Workbench_Part.svg|24px]] [[Part_Workbench|Part Workbench]]
# Switch to [[Image:Workbench_Part.svg|24px]] [[Part_Workbench|Part Workbench]].
* Insert a cube by clicking on [[Image:Part_Box.svg|32px]] [[Part_Box|Part Box/Cube]]
# Insert a cube by clicking on [[Image:Part_Box.svg|32px]] [[Part_Box|Part Box/Cube]].
* Insert a cone by clicking on [[Image:Part_Cone.svg|32px]] [[Part_Cone|Part Cone]]
# Insert a cone by clicking on [[Image:Part_Cone.svg|32px]] [[Part_Cone|Part Cone]].
* Select both objects in the [[Tree_view|tree view]]
# Select both objects in the [[Tree_view|tree view]].
* Apply a fusion by clicking on [[Image:Part_Fuse.svg|32px]] [[Part_Fuse|Part Fuse]]
# Apply a fusion by clicking on [[Image:Part_Fuse.svg|32px]] [[Part_Fuse|Part Fuse]].
* Save your file
# Save your file.


== Export Method 1: Using "File → Export" == <!--T:12-->
== Export Method 1: Using "File → Export" == <!--T:12-->


# With the default settings, this method creates a mesh with noticeably jagged curves. To get a smoother finish when e.g. 3D printing, the mesh resolution should be configured:
<!--T:4-->
## Make sure the [[Image:Workbench_Mesh.svg|24px]] [[Mesh_Workbench|Mesh Workbench]] has been loaded (it is not loaded by default).
* Select the solid to be exported in the tree view.
## Go to {{MenuCommand|Edit → Preferences... → Import-Export → Mesh Formats}}.
* Choose {{KEY|File}} {{KEY|Export...}} and set file type to "STL mesh (*.stl *.ast)".
## Change {{MenuCommand|Maximum mesh deviation}}. A lower value will produce a mesh with a higher resolution.
* Enter your file name. The default extension is ".stl". You must include the extension ".ast" in the file name to produce a .ast file. Choose {{KEY|Save}}.
# Select the solid to be exported in the tree view.

# Choose {{MenuCommand|File → Export...}} and set the file type to {{MenuCommand|STL mesh (*.stl *.ast)}}.
* '''NOTE:''' With the default settings, this method creates a mesh with noticeably jagged curves. To get a smoother finish when e.g. 3d printing, the mesh-resolution of this export method can be configured:
# Enter your file name. The default extension is {{FileName|.stl}}. You must include the extension {{FileName|.ast}} to produce an {{FileName|.ast}} file.

# Choose {{Button|Save}}.
# Make sure the Mesh workbench has been loaded (it is not loaded by default).
# Go to {{KEY|Edit}}{{KEY|Preferences...}}{{KEY|Import-Export}}{{KEY|Mesh Formats}}
# Change "Maximum mesh deviation" - A lower value will produce a mesh with a higher resolution.


== Export Method 2: Using the Mesh Workbench in FreeCAD == <!--T:13-->
== Export Method 2: Using the Mesh Workbench in FreeCAD == <!--T:13-->


<!--T:5-->
<!--T:5-->
* Switch to the [[Image:Workbench_Mesh.svg|24px]] [[Mesh_Workbench|Mesh Workbench]]
* Switch to the [[Image:Workbench_Mesh.svg|24px]] [[Mesh_Workbench|Mesh Workbench]].
* Select the solid to be meshed in the tree view.
* Select the solid to be meshed in the tree view.
* Choose {{KEY|Meshes}}{{KEY|[[Image:Mesh_FromPartShape.svg|32px]] Create Mesh from shape...}} from the main (top) menu.
* Choose {{MenuCommand|Meshes → [[Image:Mesh_FromPartShape.svg|32px]] Create Mesh from shape...}} from the main (top) menu.
* Select one of the available meshers and specify the available options. For more information refer to [[Mesh_FromPartShape|Mesh from Shape]].
* Select one of the available meshers and specify the available options. For more information refer to [[Mesh_FromPartShape|Mesh from Shape]].
* Choose {{KEY|OK}}. The mesh object will be created in the tree view (with green mesh icon [[Image:Workbench_Mesh.svg|16px]]).
* Choose {{Button|OK}}. The mesh object will be created in the tree view (with green mesh icon [[Image:Workbench_Mesh.svg|16px]]).
* Right click the mesh object in the tree view and choose {{KEY|[[Image:Mesh_Export.svg|32px]] Export mesh...}}.
* Right click the mesh object in the tree view and choose {{MenuCommand|[[Image:Mesh_Export.svg|32px]] Export mesh...}}.
* Fill in the file name; the extension is not necessary. The extension will be set based on the file type. If you include an extension which does not match the selected file type, an extension for the selected type will be added when the file is saved. If you include an extension which matches the file type, no additional extension will be added.
* Fill in the file name, the extension is not necessary. The extension will be set based on the file type. If you include an extension which does not match the selected file type, an extension for the selected type will be added when the file is saved. If you include an extension which matches the file type, no additional extension will be added.
* The default file type is "Binary STL (*.stl)". Change the type if you wish.
* The default file type is {{MenuCommand|Binary STL (*.stl)}}. Change the type if you wish.
* Choose {{KEY|Save}}.
* Choose {{Button|Save}}.


== Which Method to choose ? == <!--T:14-->
== Which Method to choose ? == <!--T:14-->


<!--T:7-->
<!--T:7-->
* After configuring the "Maximum mesh deviation" to a low enough value, method 1 can be used for most situations where a mesh file is needed.
* Method 1 can be used for most situations where a mesh file is needed.
* With method 2, if you have more than one Body to convert you can use Tools from [[Image:Workbench_Mesh.svg|24px]] [[Mesh_Workbench|Mesh Workbench]]. For example, you can fuse meshes before exporting.
* With method 2, if you have more than one solid to convert you can use Tools from the [[Image:Workbench_Mesh.svg|24px]] [[Mesh_Workbench|Mesh Workbench]]. For example, you can fuse meshes before exporting.


== Links == <!--T:15-->
== Links == <!--T:15-->

Revision as of 09:57, 1 December 2023

Tutorial
Topic
Export to STL or OBJ
Level
Beginner
Time to complete
20 minutes
Authors
r-frank
FreeCAD version
0.16.6703
Example files
None
See also
None

Introduction

In this tutorial we will cover how to export STL/OBJ-files from FreeCAD. The mesh-format STL/OBJ is dimensionless; FreeCAD will assume on export that the units used in the model are in mm. If this is not the case you have to scale your model. One way to do this is using Draft Scale.

Sample part

You can use your own FreeCAD file, but you can also create a quick test file:

  1. Open FreeCAD.
  2. Create a new document.
  3. Switch to Part Workbench.
  4. Insert a cube by clicking on Part Box/Cube.
  5. Insert a cone by clicking on Part Cone.
  6. Select both objects in the tree view.
  7. Apply a fusion by clicking on Part Fuse.
  8. Save your file.

Export Method 1: Using "File → Export"

  1. With the default settings, this method creates a mesh with noticeably jagged curves. To get a smoother finish when e.g. 3D printing, the mesh resolution should be configured:
    1. Make sure the Mesh Workbench has been loaded (it is not loaded by default).
    2. Go to Edit → Preferences... → Import-Export → Mesh Formats.
    3. Change Maximum mesh deviation. A lower value will produce a mesh with a higher resolution.
  2. Select the solid to be exported in the tree view.
  3. Choose File → Export... and set the file type to STL mesh (*.stl *.ast).
  4. Enter your file name. The default extension is .stl. You must include the extension .ast to produce an .ast file.
  5. Choose Save.

Export Method 2: Using the Mesh Workbench in FreeCAD

  • Switch to the Mesh Workbench.
  • Select the solid to be meshed in the tree view.
  • Choose Meshes → Create Mesh from shape... from the main (top) menu.
  • Select one of the available meshers and specify the available options. For more information refer to Mesh from Shape.
  • Choose OK. The mesh object will be created in the tree view (with green mesh icon ).
  • Right click the mesh object in the tree view and choose Export mesh....
  • Fill in the file name, the extension is not necessary. The extension will be set based on the file type. If you include an extension which does not match the selected file type, an extension for the selected type will be added when the file is saved. If you include an extension which matches the file type, no additional extension will be added.
  • The default file type is Binary STL (*.stl). Change the type if you wish.
  • Choose Save.

Which Method to choose ?

  • Method 1 can be used for most situations where a mesh file is needed.
  • With method 2, if you have more than one solid to convert you can use Tools from the Mesh Workbench. For example, you can fuse meshes before exporting.

Links