Part Primitives/en: Difference between revisions
(Updating to match new version of source page) |
(Updating to match new version of source page) |
||
Line 1: | Line 1: | ||
<languages/> |
<languages/> |
||
{{Docnav |
{{Docnav |
||
|[[Part_Tube|Tube]] |
|[[Part_Tube|Tube]] |
||
|[[ |
|[[Part_Plane|Plane]] |
||
|[[Part_Module|Part]] |
|[[Part_Module|Part]] |
||
|IconL=Part_Tube.svg |
|IconL=Part_Tube.svg |
||
|IconR= |
|IconR=Part_Plane.svg |
||
|IconC=Workbench_Part.svg |
|IconC=Workbench_Part.svg |
||
}} |
}} |
||
Line 16: | Line 17: | ||
}} |
}} |
||
==Description== |
== Description == |
||
[[Part_Primitives|Part Primitives]] opens a dialog to create any of the parametric geometric primitives defined in the [[Image:Workbench_Part.svg|24px|link=Part_Workbench]] [[Part_Workbench|Part Workbench]]. |
[[Part_Primitives|Part Primitives]] opens a dialog to create any of the parametric geometric primitives defined in the [[Image:Workbench_Part.svg|24px|link=Part_Workbench]] [[Part_Workbench|Part Workbench]]. |
||
Line 23: | Line 24: | ||
{{Caption|Primitive shapes that can be created with the [[Part_Workbench|Part Workbench]].}} |
{{Caption|Primitive shapes that can be created with the [[Part_Workbench|Part Workbench]].}} |
||
==Usage== |
== Usage == |
||
To create a primitive, either |
To create a primitive, either |
||
Line 42: | Line 43: | ||
# Edits its properties in the Properties table. |
# Edits its properties in the Properties table. |
||
==Geometric Primitives== |
== Geometric Primitives == |
||
Some of the available (parametric) geometric primitives that are possible: |
|||
⚫ | |||
:[[Image:Tree_Part_Box_Parametric.svg|32px]] [[Part_Box|Box/Cube]]: inserts a parametric, [http://en.wikipedia.org/wiki/Cuboid#Rectangular_cuboid rectangular cuboid], geometric primitive into the active document. |
|||
⚫ | |||
⚫ | |||
:[[Image:Tree_Part_Sphere_Parametric.svg|32px]] [[Part_Sphere|Sphere]]: Inserts a parametric sphere, with position, angle1, angle2, angle3 and radius parameters. |
|||
⚫ | |||
:[[Image:Tree_Part_Torus_Parametric.svg|32px]] [[Part_Torus|Torus]]: Inserts a simple parametric torus, with position, angle1, angle2, angle3, radius1 and radius2 as parameters in to the active document. |
|||
:[[Image:Part_Prism.svg|32px]] [[Part_Prism|Prism]]: Inserts a solid defined by a regular polygon cross section and a height in to the active document. {{Version|0.14}} |
|||
⚫ | |||
:[[Image:Part_Helix.svg|32px]] [[Part_Helix|Helix]]: Inserts a Helix geometric primitive in to the active document. Common usage for Helix is creating [[Thread_for_Screw_Tutorial|threads]]. |
|||
⚫ | |||
⚫ | |||
⚫ | |||
⚫ | |||
⚫ | |||
⚫ | |||
== Inheritance == |
|||
All part primitives are objects which derive from the {{incode|Part::Primitive}} class. This class in turn derives from the basic [[Part_Feature|Part Feature]] object ({{incode|Part::Feature}} class). |
|||
[[File:FreeCAD_core_objects.svg|800px]] |
|||
The following primitives can be created: |
|||
{{Caption|Simplified diagram of the relationships between the core objects in the program. The {{incode|Part::Primitive}} class is derived from the {{incode|Part::Feature}} object. It includes an extension that allows it to be attached to faces and planes.}} |
|||
⚫ | |||
*[[Image:Tree_Part_Box_Parametric.svg|32px]] [[Part_Box|Box]]: Creates a box. This object can also be created with the [[Image:Part_Box.svg|32px]] [[Part_Box|Box]] tool. |
|||
⚫ | |||
⚫ | |||
*[[Image:Tree_Part_Sphere_Parametric.svg|32px]] [[Part_Sphere|Sphere]]: Creates a sphere. This object can also be created with the [[Image:Part_Sphere.svg|32px]] [[Part_Sphere|Sphere]] tool. |
|||
⚫ | |||
*[[Image:Tree_Part_Torus_Parametric.svg|32px]] [[Part_Torus|Torus]]: Creates a torus. This object can also be created with the [[Image:Part_Torus.svg|32px]] [[Part_Torus|Torus]] tool. |
|||
*[[Image:Part_Prism.svg|32px]] [[Part_Prism|Prism]]: Creates a prism. |
|||
⚫ | |||
*[[Image:Part_Helix.svg|32px]] [[Part_Helix|Helix]]: Creates a helix. |
|||
⚫ | |||
⚫ | |||
⚫ | |||
⚫ | |||
⚫ | |||
⚫ | |||
== Scripting == |
== Scripting == |
||
Line 95: | Line 88: | ||
{{Docnav |
{{Docnav |
||
|[[Part_Tube|Tube]] |
|[[Part_Tube|Tube]] |
||
|[[ |
|[[Part_Plane|Plane]] |
||
|[[Part_Module|Part]] |
|[[Part_Module|Part]] |
||
|IconL=Part_Tube.svg |
|IconL=Part_Tube.svg |
||
|IconR= |
|IconR=Part_Plane.svg |
||
|IconC=Workbench_Part.svg |
|IconC=Workbench_Part.svg |
||
}} |
}} |
Revision as of 16:03, 25 February 2021
Part Primitives |
Menu location |
---|
Part → Create primitives... |
Workbenches |
Part |
Default shortcut |
None |
Introduced in version |
- |
See also |
Part Shapebuilder |
Description
Part Primitives opens a dialog to create any of the parametric geometric primitives defined in the Part Workbench.
Primitive shapes that can be created with the Part Workbench.
Usage
To create a primitive, either
- In the appearing dialog select primitive type, set its parameters and location, finally press Create
The dialog keeps open so that you can subsequently create further primitives.
To edit a primitives there are 2 ways:
Using the dialog: introduced in version 0.19
- Select the primitive in the tree and double-click on it.
- The same dialog will open that was also used to create the primitive. Change there the parameters and you get a live preview of the changed primitive.
- To finish the editing press OK.
Using the property editor:
- Select the primitive in the tree.
- Edits its properties in the Properties table.
Geometric Primitives
The following primitives can be created:
- Plane: Creates a plane.
- Box: Creates a box. This object can also be created with the Box tool.
- Cylinder: Creates a cylinder. This object can also be created with the Cylinder tool.
- Cone: Creates a cone. This object can also be created with the Cone tool.
- Sphere: Creates a sphere. This object can also be created with the Sphere tool.
- Ellipsoid: Creates a ellipsoid.
- Torus: Creates a torus. This object can also be created with the Torus tool.
- Prism: Creates a prism.
- Wedge: Creates a wedge.
- Helix: Creates a helix.
- Spiral: Creates a spiral.
- Circle: Creates a circular edge.
- Ellipse: Creates an elliptical edge.
- Point: Creates a point (vertex).
- Line: Creates a line (edge).
- Regular Polygon: Creates a regular polygon.
Scripting
See also: Part scripting
Test the creation of the primitives with a script. introduced in version 0.19
This can be run from the Python console.
import parttests.part_test_objects as pto
pto.create_test_file("example_file")
This script is located in the installation directory of the program, and can be examined to see how the basic primitives are built.
$INSTALL_DIR/Mod/Part/parttests/part_test_objects.py
It can be used as input to the program as well.
freecad $INSTALL_DIR/Mod/Part/parttests/part_test_objects.py
- Primitives: Box, Cylinder, Sphere, Cone, Torus, Tube, Create primitives, Shape builder
- Creation and modification: Extrude, Revolve, Mirror, Fillet, Chamfer, Make face from wires, Ruled Surface, Loft, Sweep, Section, Cross sections, 3D Offset, 2D Offset, Thickness, Projection on surface, Attachment
- Boolean: Make compound, Explode Compound, Compound Filter, Boolean, Cut, Fuse, Common, Connect, Embed, Cutout, Boolean fragments, Slice apart, Slice, XOR
- Measure: Measure Linear, Measure Angular, Measure Refresh, Clear All, Toggle All, Toggle 3D, Toggle Delta
- Getting started
- Installation: Download, Windows, Linux, Mac, Additional components, Docker, AppImage, Ubuntu Snap
- Basics: About FreeCAD, Interface, Mouse navigation, Selection methods, Object name, Preferences, Workbenches, Document structure, Properties, Help FreeCAD, Donate
- Help: Tutorials, Video tutorials
- Workbenches: Std Base, Arch, Assembly, CAM, Draft, FEM, Inspection, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Surface, TechDraw, Test Framework
- Hubs: User hub, Power users hub, Developer hub