Part Primitives: Difference between revisions
No edit summary |
No edit summary |
||
Line 58: | Line 58: | ||
Some of the available (parametric) geometric primitives that are possible: |
Some of the available (parametric) geometric primitives that are possible: |
||
:[[Image:Part_Plane.svg|32px]] [[Part_Plane|Plane]]: inserts a simple parametric plane 10 x 10 mm, with the parameters of position, length, and width. |
:[[Image:Part_Plane.svg|32px]] [[Part_Plane|Plane]]: inserts a simple parametric plane 10 x 10 mm, with the parameters of position, length, and width. |
||
:[[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_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. The same tool as [[Image:Part_Box.svg|32px]] [[Part_Box|Box]]. |
||
:[[Image:Tree_Part_Cylinder_Parametric.svg|32px]] [[Part_Cylinder|Cylinder]]: Inserts a simple parametric cylinder, with position, angle, radius and height parameters in to |
:[[Image:Tree_Part_Cylinder_Parametric.svg|32px]] [[Part_Cylinder|Cylinder]]: Inserts a simple parametric cylinder, with position, angle, radius and height parameters in to the active document. The same tool as [[Image:Part_Cylinder.svg|32px]] [[Part_Cylinder|Cylinder]]. |
||
:[[Image:Tree_Part_Cone_Parametric.svg|32px]] [[Part_Cone|Cone]]: Inserts a parametric truncated Cone in to the active document. |
:[[Image:Tree_Part_Cone_Parametric.svg|32px]] [[Part_Cone|Cone]]: Inserts a parametric truncated Cone in to the active document. The same tool as [[Image:Part_Cone.svg|32px]] [[Part_Cone|Cone]]. |
||
:[[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_Sphere_Parametric.svg|32px]] [[Part_Sphere|Sphere]]: Inserts a parametric sphere, with position, angle1, angle2, angle3 and radius parameters. The same tool as [[Image:Part_Sphere.svg|32px]] [[Part_Sphere|Sphere]]. |
||
:[[Image:Part_Ellipsoid.svg|32px]] [[Part_Ellipsoid|Ellipsoid]]: Inserts a parametric Ellipsoid solid in to the active document. |
:[[Image:Part_Ellipsoid.svg|32px]] [[Part_Ellipsoid|Ellipsoid]]: Inserts a parametric Ellipsoid solid in to the active document. |
||
:[[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: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. The same tool as [[Image:Part_Torus.svg|32px]] [[Part_Torus|Torus]]. |
||
:[[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_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_Wedge.svg|32px]] [[Part_Wedge|Wedge]]: Inserts a parametric Wedge object in to the active document. |
:[[Image:Part_Wedge.svg|32px]] [[Part_Wedge|Wedge]]: Inserts a parametric Wedge object in to the active document. |
Revision as of 20:42, 8 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
Some of the available (parametric) geometric primitives that are possible:
- Plane: inserts a simple parametric plane 10 x 10 mm, with the parameters of position, length, and width.
- Box/Cube: inserts a parametric, rectangular cuboid, geometric primitive into the active document. The same tool as Box.
- Cylinder: Inserts a simple parametric cylinder, with position, angle, radius and height parameters in to the active document. The same tool as Cylinder.
- Cone: Inserts a parametric truncated Cone in to the active document. The same tool as Cone.
- Sphere: Inserts a parametric sphere, with position, angle1, angle2, angle3 and radius parameters. The same tool as Sphere.
- Ellipsoid: Inserts a parametric Ellipsoid solid in to the active document.
- Torus: Inserts a simple parametric torus, with position, angle1, angle2, angle3, radius1 and radius2 as parameters in to the active document. The same tool as Torus.
- Prism: Inserts a solid defined by a regular polygon cross section and a height in to the active document. introduced in version 0.14
- Wedge: Inserts a parametric Wedge object in to the active document.
- Helix: Inserts a Helix geometric primitive in to the active document. Common usage for Helix is creating threads.
- Spiral: Inserts a Spiral geometric primitive in to the active workbench. introduced in version 0.14
- Circle: Inserts a circular curved edge in to the active document.
- Ellipse: Inserts an elliptical curved edge in to the active document.
- Point (Vertex): Inserts a Point (vertex) geometric primitive in to the active document.
- Line (Edge): creates a simple line segment delimited by two vertices.
- Regular Polygon: Inserts a RegularPolygon geometric primitive in to the active document. introduced in version 0.14
Inheritance
All part primitives are objects which derive from the Part::Primitive
class. This class in turn derives from the basic Part Feature object (Part::Feature
class).
Simplified diagram of the relationships between the core objects in the program. The Part::Primitive
class is derived from the Part::Feature
object. It includes an extension that allows it to be attached to faces and planes.
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, Start, Surface, TechDraw, Test Framework, Web
- Hubs: User hub, Power users hub, Developer hub