Difference between revisions of "Mesh Workbench/hr"

From FreeCAD Documentation
Jump to navigation Jump to search
(Updating to match new version of source page)
(Updating to match new version of source page)
(10 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
<languages/>
 
<languages/>
{{Page in progress}}
 
  
 
{{Docnav
 
{{Docnav
|[[Inspection Workbench|Inspection Workbench]]
+
|[[Inspection_Workbench|Inspection Workbench]]
|[[OpenSCAD Module|OpenSCAD Module]]
+
|[[OpenSCAD_Workbench|OpenSCAD Workbench]]
 
|IconL=Workbench_Inspection.svg
 
|IconL=Workbench_Inspection.svg
 
|IconR=Workbench_OpenSCAD.svg
 
|IconR=Workbench_OpenSCAD.svg
Line 15: Line 14:
 
==Introduction==
 
==Introduction==
  
The [[Image:Workbench_Mesh.svg|24px]] [[Mesh Workbench|Mesh Workbench]] handles [http://en.wikipedia.org/wiki/Triangle_mesh triangle meshes]. Meshes are a special type of 3D object, composed of triangular faces connected by their vertices and edges.
+
The [[Image:Workbench_Mesh.svg|24px]] [[Mesh_Workbench|Mesh Workbench]] handles [http://en.wikipedia.org/wiki/Triangle_mesh triangle meshes]. Meshes are a special type of 3D object, composed of triangular faces connected by their vertices and edges.
  
 
Many 3D applications, like [http://en.wikipedia.org/wiki/Sketchup Sketchup], [http://en.wikipedia.org/wiki/Blender_(software) Blender], [http://en.wikipedia.org/wiki/Maya_(software) Maya] and [http://en.wikipedia.org/wiki/3d_max 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.
 
Many 3D applications, like [http://en.wikipedia.org/wiki/Sketchup Sketchup], [http://en.wikipedia.org/wiki/Blender_(software) Blender], [http://en.wikipedia.org/wiki/Maya_(software) Maya] and [http://en.wikipedia.org/wiki/3d_max 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 [[Glossary#Solid|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 [[Image:Workbench_Part.svg|24px]] [[Part Workbench|Part Workbench]].
+
However, in the field of engineering meshes present a big limitation: they cannot accurately define curved surfaces. This is why FreeCAD relies on [[wikipedia:Boundary representation|Brep]] instead. The Mesh Workbench offers some commands to directly manipulate meshes, but it is most often used to import 3D mesh data and convert it to a solid for use with the [[Image:Workbench_Part.svg|24px]] [[Part_Workbench|Part Workbench]] or [[Image:Workbench_PartDesign.svg|24px]] [[PartDesign_Workbench|PartDesign Workbench]].
  
 
[[Image:Mesh_example.jpg|500px]]
 
[[Image:Mesh_example.jpg|500px]]
Line 25: Line 24:
 
==Tools==
 
==Tools==
  
All Mesh Workbench tools can be accessed from the '''Meshes''' menu. Some tools are also available in the '''Mesh tools''' toolbar.
+
All Mesh Workbench tools can be accessed from the '''Meshes''' menu. Almost all are also available in one of the Mesh toolbars.
  
* [[Image:Mesh_Import.svg|32px]] [[Mesh_Import|Import mesh...]]: Imports a mesh from file.
+
* [[Image:Mesh_Import.svg|32px]] [[Mesh_Import|Import mesh...]]: Imports a mesh object from a file.
  
* [[Image:Mesh_Export.svg|32px]] [[Mesh_Export|Export mesh...]]: Exports a mesh to file.
+
* [[Image:Mesh_Export.svg|32px]] [[Mesh_Export|Export mesh...]]: Exports a mesh object to a file.
  
* [[Image:Mesh_FromPartShape.svg|32px]] [[Mesh_FromPartShape|Create mesh from shape...]]: Creates meshes from [[Part Module|Part]] objects.
+
* [[Image:Mesh_FromPartShape.svg|32px]] [[Mesh_FromPartShape|Create mesh from shape...]]: Creates mesh objects from shape objects.
  
* [[Mesh_RemeshGmsh|Refinement...]]: Refines a mesh. {{Version|0.19}}
+
* [[Image:Mesh_RemeshGmsh.svg|32px]] [[Mesh_RemeshGmsh|Refinement...]]: Remeshes a mesh object. {{Version|0.19}}
  
 
* Analyze
 
* Analyze
** [[Mesh_Evaluation|Evaluate and repair mesh...]]: Opens a dialog to analyze and repair a mesh.
+
** [[Image:Mesh_Evaluation.svg|32px]] [[Mesh_Evaluation|Evaluate and repair mesh...]]: Evaluates and repairs a mesh object.
** [[Image:Mesh_EvaluateFacet.svg|32px]] [[Mesh_EvaluateFacet|Face info]]: Gives information on selected faces.
+
** [[Image:Mesh_EvaluateFacet.svg|32px]] [[Mesh_EvaluateFacet|Face info]]: Shows information about faces of mesh objects.
** [[Mesh_CurvatureInfo|Curvature info]]: Gives information on the curvature.
+
** [[Image:Mesh_CurvatureInfo.svg|32px]] [[Mesh_CurvatureInfo|Curvature info]]: Shows the absolute curvature of [[Mesh_VertexCurvature|curvature objects]] at selected points.
** [[Mesh_EvaluateSolid|Check solid mesh]]: Checks if a mesh is a solid.
+
** [[Image:Mesh_EvaluateSolid.svg|32px]] [[Mesh_EvaluateSolid|Check solid mesh]]: Checks if a mesh object is solid.
** [[Mesh_BoundingBox|Boundings info...]]: Shows the coordinates of the boundingbox of a mesh.
+
** [[Image:Mesh_BoundingBox.svg|32px]] [[Mesh_BoundingBox|Boundings info...]]: Shows the bounding box coordinates of a mesh object.
  
* [[Image:Mesh_VertexCurvature.svg|32px]] [[Mesh_VertexCurvature|Curvature plot]]: Calculates the curvature of the vertices of a mesh.
+
* [[Image:Mesh_VertexCurvature.svg|32px]] [[Mesh_VertexCurvature|Curvature plot]]: Creates Mesh Curvature objects for mesh objects.
  
* [[Image:Mesh_HarmonizeNormals.svg|32px]] [[Mesh_HarmonizeNormals|Harmonize normals]]: Harmonizes the normals of a mesh.
+
* [[Image:Mesh_HarmonizeNormals.svg|32px]] [[Mesh_HarmonizeNormals|Harmonize normals]]: Harmonizes the normals of mesh objects.
  
* [[Image:Mesh_FlipNormals.svg|32px]] [[Mesh_FlipNormals|Flip normals]]: Flips the normals of a mesh.
+
* [[Image:Mesh_FlipNormals.svg|32px]] [[Mesh_FlipNormals|Flip normals]]: Flips the normals of mesh objects.
  
* [[Mesh_FillupHoles|Fill holes...]]: Closes holes in a mesh.
+
* [[Image:Mesh_FillupHoles.svg|32px]] [[Mesh_FillupHoles|Fill holes...]]: Fills holes in mesh objects.
  
* [[Image:Mesh_FillInteractiveHole.svg|32px]] [[Mesh_FillInteractiveHole|Close hole]]: Interactively closes holes in a mesh.
+
* [[Image:Mesh_FillInteractiveHole.svg|32px]] [[Mesh_FillInteractiveHole|Close hole]]: Fills selected holes in mesh objects.
  
* [[Mesh_AddFacet|Add triangle]]: Adds a triangle to a mesh.
+
* [[Image:Mesh_AddFacet.svg|32px]] [[Mesh_AddFacet|Add triangle]]: Adds faces along a boundary of an open mesh object.
  
* [[Image:Mesh_RemoveComponents.svg|32px]] [[Mesh_RemoveComponents|Remove components...]]: Removes independent components from a mesh.
+
* [[Image:Mesh_RemoveComponents.svg|32px]] [[Mesh_RemoveComponents|Remove components...]]: Removes faces from mesh objects.
  
* [[Mesh_RemoveCompByHand|Remove components by hand...]]: Marks a component for removal from a mesh.
+
* [[Image:Mesh_RemoveCompByHand.svg|32px]] [[Mesh_RemoveCompByHand|Remove components by hand...]]: Removes components from mesh objects.
  
* [[Mesh_Segmentation|Create mesh segments...]]: Creates mesh segments.
+
* [[Image:Mesh_Segmentation.svg|32px]] [[Mesh_Segmentation|Create mesh segments...]]: Creates separate mesh segments for specified surface types of a mesh object.
  
* [[Mesh_SegmentationBestFit|Create mesh segments from best-fit surfaces...]]: Creates mesh segments from best-fit surfaces.
+
* [[Image:Mesh_SegmentationBestFit.svg|32px]] [[Mesh_SegmentationBestFit|Create mesh segments from best-fit surfaces...]]: Creates separate mesh segments for specified surface types of a mesh object, and can identify their parameters.
  
* [[Mesh_Smoothing|Smooth...]]: Smooths meshes.
+
* [[Image:Mesh_Smoothing.svg|32px]] [[Mesh_Smoothing|Smooth...]]: Smooths mesh objects.
  
* [[Mesh_Decimating|Decimation...]]: Decimates meshes. {{Version|0.19}}
+
* [[Image:Mesh_Decimating.svg|32px]] [[Mesh_Decimating|Decimation...]]: Reduces the number of faces in mesh objects. {{Version|0.19}}
  
* [[Mesh_Scale|Scale...]]: Scales meshes.
+
* [[Image:Mesh_Scale.svg|32px]] [[Mesh_Scale|Scale...]]: Scales mesh objects.
  
* [[Image:Mesh_BuildRegularSolid.svg|32px]] [[Mesh_BuildRegularSolid|Regular solid...]] Creates a regular solid mesh.
+
* [[Image:Mesh_BuildRegularSolid.svg|32px]] [[Mesh_BuildRegularSolid|Regular solid...]]: Creates a regular parametric solid mesh object.
  
 
* Boolean
 
* Boolean
** [[Mesh_Union|Union]]: Creates a union (fusion) from meshes.
+
** [[Image:Mesh_Union.svg|32px]] [[Mesh_Union|Union]]: Creates a mesh object that is the union of two mesh objects.
** [[Mesh_Intersection|Intersection]]: Creates an intersection (common) from meshes.
+
** [[Image:Mesh_Intersection.svg|32px]] [[Mesh_Intersection|Intersection]]: Creates a mesh object that is the intersection of two mesh objects.
** [[Mesh_Difference|Difference]]: Creates a difference (cut) from meshes.
+
** [[Image:Mesh_Difference.svg|32px]] [[Mesh_Difference|Difference]]: Creates a mesh object that is the difference of two mesh objects.
  
 
* Cutting
 
* Cutting
** [[Image:Mesh_PolyCut.svg|32px]] [[Mesh_PolyCut|Cut mesh]]: Cuts a mesh with a polygon
+
** [[Image:Mesh_PolyCut.svg|32px]] [[Mesh_PolyCut|Cut mesh]]: Cuts whole faces from mesh objects.
** [[Mesh_PolyTrim|Trim mesh]]: Trims a mesh with a polygon.
+
** [[Image:Mesh_PolyTrim.svg|32px]] [[Mesh_PolyTrim|Trim mesh]]: Trims faces and parts of faces from mesh objects.
** [[Mesh_TrimByPlane|Trim mesh with a plane]]: Trims a mesh with a plane.
+
** [[Image:Mesh_TrimByPlane.svg|32px]] [[Mesh_TrimByPlane|Trim mesh with a plane]]: Trims faces and parts of faces on one side of a plane from a mesh object.
** [[Mesh_SectionByPlane|Create section from mesh and plane]]: Creates a section from a mesh and a plane.
+
** [[Image:Mesh_SectionByPlane.svg|32px]] [[Mesh_SectionByPlane|Create section from mesh and plane]]: Creates a cross section across a mesh object.
** [[Mesh_CrossSections|Cross-sections...]]: ???. {{Version|0.19}}
+
** [[Image:Mesh_CrossSections.svg|32px]] [[Mesh_CrossSections|Cross-sections...]]: Creates multiple cross sections across mesh objects. {{Version|0.19}}
  
* [[Mesh_Merge|Merge]]: Merges meshes.
+
* [[Image:Mesh_Merge.svg|32px]] [[Mesh_Merge|Merge]]: Creates a mesh object by combining the meshes of two or more mesh objects.
  
* [[MeshPart_CreateFlatMesh|Unwrap Mesh]]: Creates a flat representation of a mesh. {{Version|0.19}}
+
* [[Image:Mesh_SplitComponents.svg|32px]] [[Mesh_SplitComponents|Split by components]]: Splits a mesh object into its components. {{Version|0.19}}
  
* [[MeshPart_CreateFlatFace|Unwrap Face]]: Creates a flat representation of a face of a mesh. {{Version|0.19}}
+
* [[Image:MeshPart_CreateFlatMesh.svg|32px]] [[MeshPart_CreateFlatMesh|Unwrap Mesh]]: Creates a flat representation of a mesh object. {{Version|0.19}}
 +
 
 +
* [[Image:MeshPart_CreateFlatFace.svg|32px]] [[MeshPart_CreateFlatFace|Unwrap Face]]: Creates a flat representation of a face of a shape object. {{Version|0.19}}
  
 
==Preferences==
 
==Preferences==
  
* [[Image:Preferences-import-export.svg|32px]] [[Import_Export_Preference|Preference]] Import-Export
+
There are some [[Import_Export_Preferences#Mesh_Formats|export preferences related to Mesh Formats]] but these are not used by commands belonging to this workbench. They are used by the [[Std_Export|Std Export]] command.
  
More mesh tools are available in the [[Image:Workbench_OpenSCAD.svg|24px]] [[OpenSCAD Workbench|OpenSCAD Workbench]].
+
Mesh Workbench preferences can be found in the following categories of the [[Preferences_Editor|Preferences Editor]]:
 +
* [[Image:Preferences-display.svg|32px]] [[Preferences_Editor#Display_settings|Display]]: On the [[Preferences_Editor#Mesh_view|Mesh view]] tab several preferences can be set.
 +
* [[Image:Preferences-openscad.svg|32px]] [[OpenSCAD_Preferences|OpenSCAD]]: The [[Mesh_Union|Mesh Union]], [[Mesh_Intersection|Mesh Intersection]] and [[Mesh_Difference|Mesh Difference]] commands require [http://www.openscad.org/ OpenSCAD] and use the '''OpenSCAD executable''' preference to find its executable.
  
Meshes can also be handled via [[Python]] using [[Mesh Scripting|Mesh Scripting]].
+
==Notes==
  
==Links==
+
* More mesh tools are available in the [[Image:Workbench_OpenSCAD.svg|24px]] [[OpenSCAD_Workbench|OpenSCAD Workbench]].
 +
* See [[Mesh_Scripting|Mesh Scripting]] to manipulate and create meshes using [[Python|Python]].
 +
* See also [[FreeCAD_and_Mesh_Import|FreeCAD and Mesh Import]]
 +
* See [[Asymptote|Asymptote]] to export meshes to the Asymptote format.
  
* [[FreeCAD and Mesh Import|FreeCAD and Mesh Import]]
 
  
 
{{Docnav
 
{{Docnav
|[[Inspection Workbench|Inspection Workbench]]
+
|[[Inspection_Workbench|Inspection Workbench]]
|[[OpenSCAD Module|OpenSCAD Module]]
+
|[[OpenSCAD_Workbench|OpenSCAD Workbench]]
 
|IconL=Workbench_Inspection.svg
 
|IconL=Workbench_Inspection.svg
 
|IconR=Workbench_OpenSCAD.svg
 
|IconR=Workbench_OpenSCAD.svg
 
}}
 
}}
 
 
  
 
{{Mesh Tools navi{{#translation:}}}}
 
{{Mesh Tools navi{{#translation:}}}}
 
 
{{Userdocnavi{{#translation:}}}}
 
{{Userdocnavi{{#translation:}}}}
 
 
[[Category:Workbenches{{#translation:}}]]
 
[[Category:Workbenches{{#translation:}}]]

Revision as of 09:10, 23 August 2021

Other languages:
Bahasa Indonesia • ‎Deutsch • ‎English • ‎Türkçe • ‎español • ‎français • ‎hrvatski • ‎italiano • ‎magyar • ‎polski • ‎português • ‎português do Brasil • ‎română • ‎svenska • ‎čeština • ‎български • ‎русский • ‎українська • ‎中文 • ‎中文(中国大陆)‎ • ‎中文(台灣)‎ • ‎日本語 • ‎한국어
Mesh workbench icon

Introduction

The Workbench Mesh.svg 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 a big limitation: they cannot accurately define curved surfaces. This is why FreeCAD relies on Brep instead. The Mesh Workbench offers some commands to directly manipulate meshes, but it is most often used to import 3D mesh data and convert it to a solid for use with the Workbench Part.svg Part Workbench or Workbench PartDesign.svg PartDesign Workbench.

Mesh example.jpg

Tools

All Mesh Workbench tools can be accessed from the Meshes menu. Almost all are also available in one of the Mesh toolbars.

  • Mesh FillInteractiveHole.svg Close hole: Fills selected holes in mesh objects.
  • Mesh AddFacet.svg Add triangle: Adds faces along a boundary of an open mesh object.
  • Boolean
    • Mesh Union.svg Union: Creates a mesh object that is the union of two mesh objects.
    • Mesh Intersection.svg Intersection: Creates a mesh object that is the intersection of two mesh objects.
    • Mesh Difference.svg Difference: Creates a mesh object that is the difference of two mesh objects.
  • Mesh Merge.svg Merge: Creates a mesh object by combining the meshes of two or more mesh objects.

Preferences

There are some export preferences related to Mesh Formats but these are not used by commands belonging to this workbench. They are used by the Std Export command.

Mesh Workbench preferences can be found in the following categories of the Preferences Editor:

Notes