Mesh Workbench: Difference between revisions

From FreeCAD Documentation
(Marked this version for translation)
(Updated the tools to match the V0.19 menu. 'In progress' for now.)
Line 1: Line 1:
<languages/>
<languages/>
{{Page in progress}}
<translate>
<translate>

<!--T:25-->
<!--T:25-->
{{Docnav
{{Docnav
Line 11: Line 13:
<!--T:26-->
<!--T:26-->
[[Image:Workbench_Mesh.svg|thumb|128px|Mesh workbench icon]]
[[Image:Workbench_Mesh.svg|thumb|128px|Mesh workbench icon]]

</translate>
</translate>
{{TOCright}}
{{TOCright}}
<translate>
<translate>

== Introduction == <!--T:27-->
==Introduction== <!--T:27-->


<!--T:1-->
<!--T:1-->
Line 29: Line 33:
<translate>
<translate>


== Tools == <!--T:7-->
==Tools== <!--T:7-->


<!--T:8-->
<!--T:8-->
The Mesh Workbench has a simple interface; all its functions are grouped in the {{MenuCommand|Mesh}} menu.
All Mesh Workbench tools can be accessed from the '''Meshes''' menu. Some tools are also available in the '''Mesh tools''' toolbar.

* [[Image:Mesh_Import.svg|32px]] [[Mesh_Import|Import mesh...]]: Import meshes in several file formats.

* [[Image:Mesh_Export.svg|32px]] [[Mesh_Export|Export mesh...]]: Export meshes in several file formats.

* [[Image:Mesh_FromPartShape.svg|32px]] [[Mesh_FromPartShape|Create mesh from shape...]]: Convert [[Part Module|Part]] objects into meshes.

* [[Mesh_RemeshGmsh|Refinement...]]: ???.

* Analyze <!--T:12-->
** [[Mesh_Evaluation|Evaluate and repair mesh...]]: Evaluates and repairs meshes.
** [[Image:Mesh_EvaluateFacet.svg|32px]] [[Mesh_EvaluateFacet|Face info]]: Gives info on faces.
** [[Mesh_CurvatureInfo|Curvature info]]: Gives info on curvature.
** [[Mesh_EvaluateSolid|Check solid mesh]]: Checks the solid if it can be converted to a mesh.
** [[Mesh_BoundingBox|Boundings info...]]: Evaluates the bounding box of a mesh.

* [[Image:Mesh_VertexCurvature.svg|32px]] [[Mesh_VertexCurvature|Curvature plot]]: Creates a curvature plot.

* [[Image:Mesh_HarmonizeNormals.svg|32px]] [[Mesh_HarmonizeNormals|Harmonize normals]]: Harmonizes normals.

* [[Image:Mesh_FlipNormals.svg|32px]] [[Mesh_FlipNormals|Flip normals]]: Flips normals.

* [[Mesh_FillupHoles|Fill holes...]]: Fills up holes.

* [[Image:Mesh_FillInteractiveHole.svg|32px]] [[Mesh_FillInteractiveHole|Close hole]]: Closes holes in meshes.

* [[Mesh_AddFacet|Add triangle]]: Adds a triangle.

* [[Image:Mesh_RemoveComponents.svg|32px]] [[Mesh_RemoveComponents|Remove components...]]: Removes components of meshes.

* [[Mesh_RemoveCompByHand|Remove components by hand...]]: Removes components of meshes by hand.

* [[Mesh_Segmentation|Create mesh segments...]]: Creates mesh segments.

* [[Mesh_SegmentationBestFit|Create mesh segments from best-fit surfaces...]]: ???.

* [[Mesh_Smoothing|Smooth...]]: Smooths a mesh.

* [[Mesh_Decimating|Decimation...]]: Decimates a mesh.

* [[Mesh_Scale|Scale...]]: Scales a mesh.


* [[Image:Mesh_BuildRegularSolid.svg|32px]] [[Mesh_BuildRegularSolid|Regular solid...]] Creates a mesh primitive.
=== General tools === <!--T:19-->
* [[Image:Mesh_Import.svg|32px]] [[Mesh Import|Import Mesh]]: Import meshes in several file formats
* [[Image:Mesh_Export.svg|32px]] [[Mesh Export|Export Mesh]]: Export meshes in several file formats
* [[Image:Mesh_FromPartShape.svg|32px]] [[Mesh FromPartShape|Create Mesh from shape]]: Convert [[Part Module|Part]] objects into meshes
* [[Image:Mesh_CurvaturePlot.png|32px]] [[Mesh CurvaturePlot|Curvature Plot]]: Creates a curvature plot
* [[Image:Mesh_HarmonizeNormals.svg|32px]] [[Mesh HarmonizeNormals|Harmonize Normals]]: Harmonize normals
* [[Image:Mesh_FlipNormals.svg|32px]] [[Mesh FlipNormals|Flip Normals]]: Flip [http://en.wikipedia.org/wiki/Surface_normal normals]
* [[Mesh FillHoles|Fill Holes...]]: Fill up holes
* [[Image:Mesh_FillInteractiveHole.svg|32px]] [[Mesh FillInteractiveHole|Close hole]]: Close holes in meshes
* [[Mesh AddTriangle|Add triangle]]: Add triangle
* [[Image:Mesh_RemoveComponents.svg|32px]] [[Mesh RemoveComponents|Remove components...]]: Remove components of meshes
* [[Mesh RemoveCompByHand|Remove components by hand...]]: Remove components of meshes by hand
* [[Mesh CreateMeshSegment|Create mesh segments...]]: Creates mesh segments
* [[Mesh Smooth|Smooth...]]: Smooth mesh
* [[Mesh Scale|Scale]]


=== Analyze === <!--T:12-->
* Boolean <!--T:14-->
** [[Mesh_Union|Union]]: Does a union (fusion) on meshes.
Analysis of curvature, faces, and check if a mesh can be safely converted into a solid
** [[Mesh_Intersection|Intersection]]: Does an intersection (common) on meshes.
* [[Mesh EvaluateRepair|Evaluate & Repair mesh...]]: Evaluates and repairs meshes
** [[Mesh_Difference|Difference]]: Does a difference (cut) on meshes.
* [[Image:Mesh_EvaluateFacet.svg|32px]] [[Mesh EvaluateFacet|Face Info]]: Gives info on faces
* [[Mesh EvaluateCurvature|Curvature Info]]: Gives info on curvature
* [[Mesh EvaluateSolid|Check solid mesh]]: Checks the solid if it can be converted to a mesh
* [[Mesh BoundingBox|Boundings info...]]: Evaluates the bounding box of a mesh


=== Regular solid === <!--T:13-->
* Cutting <!--T:20-->
[[Image:Mesh_RegularSolid.svg|32px]] [[Mesh BuildRegularSolid|Regular solid...]] Create mesh primitives, like cubes, cylinders, cones, or spheres:
** [[Image:Mesh_PolyCut.svg|32px]] [[Mesh_PolyCut|Cut mesh]]: Cuts meshes along a line.
** [[Mesh_PolyTrim|Trim mesh]]: Trims meshes.
* [[Image:Mesh_Cube.svg|32px]] [[Mesh_Cube|Mesh Cube]] Create a mesh cube
** [[Mesh_TrimByPlane|Trim mesh with a plane]]: Trims meshes with a plane.
* [[Image:Mesh_Cylinder.svg|32px]] [[Mesh_Cylinder|Mesh Cylinder]] Create a mesh cylinder
** [[Mesh_SectionByPlane|Create section from mesh and plane]]: ???.
* [[Image:Mesh_Cone.svg|32px]] [[Mesh_Cone|Mesh Cone]] Create a mesh cone
** [[Mesh_CrossSections|Cross-sections...]]: ???.
* [[Image:Mesh_Sphere.svg|32px]] [[Mesh_Sphere|Mesh Sphere]] Create a mesh sphere
* [[Image:Mesh_Ellipsoid.svg|32px]] [[Mesh_Ellipsoid|Mesh Ellipsoid]] Create a mesh ellipsoid
* [[Image:Mesh_Torus.svg|32px]] [[Mesh_Torus|Mesh Torus]] Create a mesh torus


* [[Mesh_Merge|Merge]]: Merges meshes.
=== Boolean === <!--T:14-->
* [[Mesh Union|Union]]: Does a union (fusion) on meshes
* [[Mesh Intersection|Intersection]]: Does an intersection (common) on meshes
* [[Mesh Difference|Difference]]: Does a difference (cut) on meshes


* [[MeshPart_CreateFlatMesh|Unwrap Mesh]]: ???.
=== Cutting === <!--T:20-->
* [[Image:Mesh_PolyCut.svg|32px]] [[Mesh_PolyCut|Mesh PolyCut]]: Cut meshes along a line
* [[Mesh TrimMesh|Trim mesh]]: Trims meshes
* [[Mesh TrimMeshWithPlane|Trim mesh with a plane]]: Trims meshes with a plane
* Create section from mesh and plane


* [[MeshPart_CreateFlatFace|Unwrap Face]]: ???.
=== Other === <!--T:15-->
* [[Mesh Merge|Merge]]: Merges meshes
* [[Mesh SelectMesh|Select Mesh]]: Selects meshes
* [[Mesh SplitMesh|Split Mesh]]: Splits meshes
* [[Image:Mesh MakeSegment.png|32px]] [[Mesh MakeSegment|Make segment]]: Makes a segment


== Preferences == <!--T:18-->
==Preferences== <!--T:18-->
* [[Image:Preferences-import-export.svg|32px]] [[Import_Export_Preference|Preference]] Import-Export
* [[Image:Preferences-import-export.svg|32px]] [[Import_Export_Preference|Preference]] Import-Export



Revision as of 20:20, 25 June 2020

This documentation is a work in progress. Please don't mark it as translatable since it will change in the next hours and days.
Mesh workbench icon

Introduction

The Mesh Workbench handles triangle meshes. Meshes are a special type of 3D object, composed of triangular faces connected by their vertices and edges.

Many 3D applications, like Sketchup, Blender, Maya and 3D Studio Max, use meshes as their primary type of 3D object. Since meshes are very simple objects, containing only vertices (points), edges and triangular faces, they are very easy to create, modify, subdivide, stretch, and can easily be passed from one application to another without any loss of details. In addition, since meshes contain very simple data, 3D applications can usually manage very large quantities of them without using a lot of resources. For these reasons, meshes are often the 3D object type of choice for applications dealing with movies, animation, and image creation.

However, in the field of engineering meshes present one big limitation: they are only made of surfaces, and have no mass information, so they don't behave as solids. This means that all solid-based operations, such as addition or subtraction, are difficult to perform on meshes. The Mesh Workbench is useful to import 3D data in mesh format, to analyse it, detect errors, and finally convert it to a solid, for use with the Part Workbench.

Tools

All Mesh Workbench tools can be accessed from the Meshes menu. Some tools are also available in the Mesh tools toolbar.

  • Boolean
    • Union: Does a union (fusion) on meshes.
    • Intersection: Does an intersection (common) on meshes.
    • Difference: Does a difference (cut) on meshes.

Preferences

More mesh tools are available in the OpenSCAD Workbench.

Meshes can also be handled via Python using Mesh Scripting.

Links