Arch MeshToShape: Difference between revisions

From FreeCAD Documentation
mNo edit summary
(Undo revision 1124009 by David69 (talk)This is not correct.)
Tag: Undo
 
(9 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
<translate>
<translate>

<!--T:11-->
<!--T:11-->
{{docnav
{{Docnav
|[[Arch_SplitMesh|Split Mesh]]
|[[Arch_SplitMesh|SplitMesh]]
|[[Arch_SelectNonSolidMeshes|Select non-solid meshes]]
|[[Arch_SelectNonSolidMeshes|SelectNonSolidMeshes]]
|[[Arch_Module|Arch]]
|[[Arch_Workbench|Arch]]
|IconL=Arch_SplitMesh.svg
|IconL=Arch_SplitMesh.svg
|IconR=Arch_SelectNonSolidMeshes.svg
|IconC=Workbench_Arch.svg
|IconC=Workbench_Arch.svg
|IconR=Arch SelectNonManifold.svg
}}
}}


Line 15: Line 16:
|Name=Arch MeshToShape
|Name=Arch MeshToShape
|MenuLocation=Arch → Utilities → Mesh to Shape
|MenuLocation=Arch → Utilities → Mesh to Shape
|Workbenches=[[Arch Module|Arch]]
|Workbenches=[[Arch_Workbench|Arch]]
|SeeAlso=[[Arch SplitMesh|Arch SplitMesh]], [[Arch RemoveShape|Arch RemoveShape]]
|SeeAlso=[[Arch_SplitMesh|Arch SplitMesh]], [[Arch_RemoveShape|Arch RemoveShape]]
}}
}}


Line 25: Line 26:


<!--T:17-->
<!--T:17-->
This tool is optimized for objects with flat faces (no curves). The corresponding tool {{Button|[[File:Part_ShapeFromMesh.svg|16px]] [[Part_ShapeFromMesh|Part ShapeFromMesh]]}} from the [[Image:Workbench_Part.svg|16px]] [[Part_Module|Part Workbench]] might be more suited for objects that contain curved surfaces.
This tool is optimized for objects with flat faces (no curves). The corresponding tool {{Button|[[File:Part_ShapeFromMesh.svg|16px]] [[Part_ShapeFromMesh|Part ShapeFromMesh]]}} from the [[Image:Workbench_Part.svg|16px]] [[Part_Workbench|Part Workbench]] might be more suited for objects that contain curved surfaces.


==Usage== <!--T:4-->
==Usage== <!--T:4-->
Line 31: Line 32:
<!--T:5-->
<!--T:5-->
# Select a mesh object.
# Select a mesh object.
# Press the {{Button|[[Image:Arch MeshToShape.svg|16px]] [[Arch MeshToShape|Mesh to Shape]]}} entry in {{MenuCommand|Arch → Utilities → Mesh to Shape}}.
# Press the {{Button|[[Image:Arch MeshToShape.svg|16px]] [[Arch_MeshToShape|Mesh to Shape]]}} entry in {{MenuCommand|Arch → Utilities → Mesh to Shape}}.


==Properties== <!--T:15-->
==Properties== <!--T:15-->
Line 37: Line 38:
==Limitations== <!--T:16-->
==Limitations== <!--T:16-->


==Scripting== <!--T:6-->
==Scripting== <!--T:19-->

{{Emphasis|See also:}} [[Arch API|Arch API]] and [[FreeCAD Scripting Basics|FreeCAD Scripting Basics]].
<!--T:6-->
{{Emphasis|See also:}} [[Arch_API|Arch API]] and [[FreeCAD_Scripting_Basics|FreeCAD Scripting Basics]].


<!--T:7-->
<!--T:7-->
This tool can be used in [[macros|macros]] and from the [[Python|Python]] console by using the following function:
This tool can be used in [[Macros|macros]] and from the [[Python|Python]] console by using the following function:
</translate>
</translate>
{{Code|code=
{{Code|code=
Line 56: Line 59:
* If {{incode|cut}} is {{incode|True}}, holes in faces are made by subtraction.
* If {{incode|cut}} is {{incode|True}}, holes in faces are made by subtraction.


<!--T:18-->
Example:
Example:
</translate>
</translate>
Line 70: Line 74:
}}
}}
<translate>
<translate>



<!--T:12-->
<!--T:12-->
{{docnav
{{Docnav
|[[Arch_SplitMesh|Split Mesh]]
|[[Arch_SplitMesh|SplitMesh]]
|[[Arch_SelectNonSolidMeshes|Select non-solid meshes]]
|[[Arch_SelectNonSolidMeshes|SelectNonSolidMeshes]]
|[[Arch_Module|Arch]]|IconL=Arch_SplitMesh.svg
|[[Arch_Workbench|Arch]]
|IconL=Arch_SplitMesh.svg
|IconR=Arch_SelectNonSolidMeshes.svg
|IconC=Workbench_Arch.svg
|IconC=Workbench_Arch.svg
|IconR=Arch SelectNonManifold.svg
}}
}}



Latest revision as of 13:47, 3 April 2022

Arch MeshToShape

Menu location
Arch → Utilities → Mesh to Shape
Workbenches
Arch
Default shortcut
None
Introduced in version
-
See also
Arch SplitMesh, Arch RemoveShape

Description

Arch MeshToShape converts a selected Mesh (Mesh Feature) object into a Shape (Part Feature) object.

This tool is optimized for objects with flat faces (no curves). The corresponding tool Part ShapeFromMesh from the Part Workbench might be more suited for objects that contain curved surfaces.

Usage

  1. Select a mesh object.
  2. Press the Mesh to Shape entry in Arch → Utilities → Mesh to Shape.

Properties

Limitations

Scripting

See also: Arch API and FreeCAD Scripting Basics.

This tool can be used in macros and from the Python console by using the following function:

new_obj = meshToShape(obj, mark=True, fast=True, tol=0.001, flat=False, cut=True)

The above code snippet converts the given obj (a mesh), into a shape, joining coplanar facets.

  • If mark is True, non-solid objects will be marked in red.
  • If fast is True, it uses a faster algorithm by building a shell from the facets then removing splitter.
  • tol is the tolerance used when converting mesh segments to wires.
  • If flat is True, it will force the wires to be perfectly planar to be sure they can be converted into faces, but this might leave gaps in the final shell.
  • If cut is True, holes in faces are made by subtraction.

Example:

import Arch, Mesh, BuildRegularGeoms

Box = FreeCAD.ActiveDocument.addObject("Mesh::Cube", "Cube")
Box.Length = 1000
Box.Width = 2000
Box.Height = 1000
FreeCAD.ActiveDocument.recompute()

new_obj = Arch.meshToShape(Box)