Mesh BuildRegularSolid: Difference between revisions

From FreeCAD Documentation
No edit summary
(Undo revision 861145 by David69 (talk))
Tag: Undo
(8 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages/>
<languages/>

{{Page in progress}}

<translate>
<translate>


<!--T:6-->
<!--T:6-->
{{Docnav
{{Docnav
|[[Mesh_Scale|Mesh Scale]]
|[[Mesh_Scale|Scale]]
|[[Mesh_Union|Mesh Union]]
|[[Mesh_Union|Union]]
|[[Mesh_Workbench|Mesh]]
|[[Mesh_Workbench|Mesh]]
|IconL=
|IconL=Mesh_Scale.svg
|IconR=
|IconR=Mesh_Union.svg
|IconC=Workbench_Mesh.svg
|IconC=Workbench_Mesh.svg
}}
}}
Line 30: Line 27:


<!--T:3-->
<!--T:3-->
# There are several ways to invoke the command:
# Select the {{MenuCommand|Meshes → [[Image:Mesh_BuildRegularSolid.svg|16px]] Regular solid...}} option from the menu.
#* Press the {{Button|[[Image:Mesh_BuildRegularSolid.svg|16px]] [[Mesh_BuildRegularSolid|Mesh BuildRegularSolid]]}} button.
#* Select the {{MenuCommand|Meshes → [[Image:Mesh_BuildRegularSolid.svg|16px]] Regular solid...}} option from the menu.
# The {{MenuCommand|Regular Solid}} dialog box opens.
# The {{MenuCommand|Regular Solid}} dialog box opens.
# First select a mesh object type from the dropdown list:
# First select a mesh object type from the dropdown list:
Line 48: Line 47:


<!--T:5-->
<!--T:5-->
* Mesh objects created with this command are parametric. Whenever they are recomputed, for example after a change to one of their parameters, their mesh is reconstructed. This means that manipulating them with commands such as [[Mesh_RemeshGmsh|Mesh RemeshGmsh]], [[Mesh_Scale|Mesh Scale]] etc. usually does not make sense.
* Mesh objects created with this command are parametric. Whenever they are recomputed, for example after changing one of their parameters, their mesh is reconstructed. This means that manipulating them with commands such as [[Mesh_RemeshGmsh|Mesh RemeshGmsh]], [[Mesh_Scale|Mesh Scale]] etc. usually does not make sense.


==Properties==
==Properties== <!--T:14-->


<!--T:15-->
Mesh objects created with this command inherit all [[Mesh_Feature|Mesh Feature]] properties. In addition each mesh object type has a number of properties to control its parametric behavior:
Mesh objects created with this command inherit all [[Mesh_Feature|Mesh Feature]] properties. In addition each mesh object type has a number of properties to control its parametric behavior:


===[[Image:Mesh_Cube.svg|32px]] Cube===
===[[Image:Mesh_Cube.svg|32px]] Cube=== <!--T:16-->


====Data====
====Data==== <!--T:17-->


<!--T:18-->
{{TitleProperty|Cube}}
{{TitleProperty|Cube}}


<!--T:19-->
* {{PropertyData|Height|FloatConstraint}}: the height of the cube.
* {{PropertyData|Height|FloatConstraint}}: the height of the cube.
* {{PropertyData|Length|FloatConstraint}}: the length of the cube.
* {{PropertyData|Length|FloatConstraint}}: the length of the cube.
* {{PropertyData|Width|FloatConstraint}}: the width of the cube.
* {{PropertyData|Width|FloatConstraint}}: the width of the cube.


===[[Image:Mesh_Cylinder.svg|32px]] Cylinder===
===[[Image:Mesh_Cylinder.svg|32px]] Cylinder=== <!--T:20-->


====Data====
====Data==== <!--T:21-->


<!--T:22-->
{{TitleProperty|Base}}
{{TitleProperty|Base}}


<!--T:23-->
* {{PropertyData|Closed|Bool}}: if set to {{FALSE}}, the planar ends of the cylinder are left open.
* {{PropertyData|Closed|Bool}}: if set to {{FALSE}}, the planar ends of the cylinder are left open.
* {{PropertyData|Edge Length|FloatConstraint}}: the edge length of the faces in the mesh.
* {{PropertyData|Edge Length|FloatConstraint}}: the edge length of the faces in the mesh.
Line 76: Line 80:
* {{PropertyData|Sampling|IntegerConstraint}}: the number of faces along the curved surface.
* {{PropertyData|Sampling|IntegerConstraint}}: the number of faces along the curved surface.


===[[Image:Mesh_Cone.svg|32px]] Cone===
===[[Image:Mesh_Cone.svg|32px]] Cone=== <!--T:24-->


====Data====
====Data==== <!--T:25-->


<!--T:26-->
{{TitleProperty|Base}}
{{TitleProperty|Base}}


<!--T:27-->
* {{PropertyData|Closed|Bool}}: if set to {{FALSE}}, the planar end(s) of the cone are left open.
* {{PropertyData|Closed|Bool}}: if set to {{FALSE}}, the planar end(s) of the cone are left open.
* {{PropertyData|Edge Length|FloatConstraint}}: the edge length of the faces in the mesh.
* {{PropertyData|Edge Length|FloatConstraint}}: the edge length of the faces in the mesh.
Line 89: Line 95:
* {{PropertyData|Sampling|IntegerConstraint}}: the number of faces along the curved surface.
* {{PropertyData|Sampling|IntegerConstraint}}: the number of faces along the curved surface.


===[[Image:Mesh_Sphere.svg|32px]] Sphere===
===[[Image:Mesh_Sphere.svg|32px]] Sphere=== <!--T:28-->


====Data====
====Data==== <!--T:29-->


<!--T:30-->
{{TitleProperty|Base}}
{{TitleProperty|Base}}


<!--T:31-->
* {{PropertyData|Radius|FloatConstraint}}: the radius of the sphere.
* {{PropertyData|Radius|FloatConstraint}}: the radius of the sphere.
* {{PropertyData|Sampling|IntegerConstraint}}: the number of faces along both directions of the curved surface.
* {{PropertyData|Sampling|IntegerConstraint}}: the number of faces along both directions of the curved surface.


===[[Image:Mesh_Ellipsoid.svg|32px]] Ellipsoid===
===[[Image:Mesh_Ellipsoid.svg|32px]] Ellipsoid=== <!--T:32-->


====Data====
====Data==== <!--T:33-->


<!--T:34-->
{{TitleProperty|Base}}
{{TitleProperty|Base}}


<!--T:35-->
* {{PropertyData|Radius 1|FloatConstraint}}: the first radius of the ellipsoid.
* {{PropertyData|Radius 1|FloatConstraint}}: the first radius of the ellipsoid.
* {{PropertyData|Radius 2|FloatConstraint}}: the second radius of the ellipsoid.
* {{PropertyData|Radius 2|FloatConstraint}}: the second radius of the ellipsoid.
* {{PropertyData|Sampling|IntegerConstraint}}: the number of faces along both directions of the curved surface.
* {{PropertyData|Sampling|IntegerConstraint}}: the number of faces along both directions of the curved surface.


===[[Image:Mesh_Torus.svg|32px]] Torus===
===[[Image:Mesh_Torus.svg|32px]] Torus=== <!--T:36-->


====Data====
====Data==== <!--T:37-->


<!--T:38-->
{{TitleProperty|Base}}
{{TitleProperty|Base}}


<!--T:39-->
* {{PropertyData|Radius 1|FloatConstraint}}: the first (main) radius the torus.
* {{PropertyData|Radius 1|FloatConstraint}}: the first (main) radius the torus.
* {{PropertyData|Radius 2|FloatConstraint}}: the second radius of the torus.
* {{PropertyData|Radius 2|FloatConstraint}}: the second radius of the torus.
Line 121: Line 133:
<!--T:7-->
<!--T:7-->
{{Docnav
{{Docnav
|[[Mesh_Scale|Mesh Scale]]
|[[Mesh_Scale|Scale]]
|[[Mesh_Union|Mesh Union]]
|[[Mesh_Union|Union]]
|[[Mesh_Workbench|Mesh]]
|[[Mesh_Workbench|Mesh]]
|IconL=
|IconL=Mesh_Scale.svg
|IconR=
|IconR=Mesh_Union.svg
|IconC=Workbench_Mesh.svg
|IconC=Workbench_Mesh.svg
}}
}}

Revision as of 13:41, 10 March 2021

Mesh BuildRegularSolid

Menu location
Meshes → Regular solid...
Workbenches
Mesh
Default shortcut
None
Introduced in version
-
See also
None

Description

The Mesh BuildRegularSolid command creates a regular parametric solid mesh object.

Usage

  1. There are several ways to invoke the command:
  2. The Regular Solid dialog box opens.
  3. First select a mesh object type from the dropdown list:
    • Cube
    • Cylinder
    • Cone
    • Sphere
    • Ellipsoid
    • Torus
  4. Specify the required settings. The available settings depend on the mesh object type. See Properties.
  5. For meshes with curved surfaces: a higher Sampling value results in a finer mesh.
  6. Press the Create button to create the mesh object.
  7. Optionally create more mesh objects.
  8. Press the Close button to close the dialog box and finish the command.

Notes

  • Mesh objects created with this command are parametric. Whenever they are recomputed, for example after changing one of their parameters, their mesh is reconstructed. This means that manipulating them with commands such as Mesh RemeshGmsh, Mesh Scale etc. usually does not make sense.

Properties

Mesh objects created with this command inherit all Mesh Feature properties. In addition each mesh object type has a number of properties to control its parametric behavior:

Cube

Data

Cube

  • DataHeight (FloatConstraint): the height of the cube.
  • DataLength (FloatConstraint): the length of the cube.
  • DataWidth (FloatConstraint): the width of the cube.

Cylinder

Data

Base

  • DataClosed (Bool): if set to false, the planar ends of the cylinder are left open.
  • DataEdge Length (FloatConstraint): the edge length of the faces in the mesh.
  • DataLength (FloatConstraint): the length of the cylinder.
  • DataRadius (FloatConstraint): the radius of the cylinder.
  • DataSampling (IntegerConstraint): the number of faces along the curved surface.

Cone

Data

Base

  • DataClosed (Bool): if set to false, the planar end(s) of the cone are left open.
  • DataEdge Length (FloatConstraint): the edge length of the faces in the mesh.
  • DataLength (FloatConstraint): the length of the cone.
  • DataRadius 1 (FloatConstraint): the first radius of the cone. Can be 0.
  • DataRadius 2 (FloatConstraint): the second radius of the cone. Can be 0.
  • DataSampling (IntegerConstraint): the number of faces along the curved surface.

Sphere

Data

Base

  • DataRadius (FloatConstraint): the radius of the sphere.
  • DataSampling (IntegerConstraint): the number of faces along both directions of the curved surface.

Ellipsoid

Data

Base

  • DataRadius 1 (FloatConstraint): the first radius of the ellipsoid.
  • DataRadius 2 (FloatConstraint): the second radius of the ellipsoid.
  • DataSampling (IntegerConstraint): the number of faces along both directions of the curved surface.

Torus

Data

Base

  • DataRadius 1 (FloatConstraint): the first (main) radius the torus.
  • DataRadius 2 (FloatConstraint): the second radius of the torus.
  • DataSampling (IntegerConstraint): the number of faces along both directions of the curved surface.