Part Primitives

Previous: Tube

Next: Plane

Part

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

1. • press the Create primitives button in the toolbar.
   • select the Part → Create primitives... from the menu bar.
2. 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

1. Select the primitive in the tree and double-click on it.
2. 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.
3. To finish the editing press OK.

Using the property editor:

1. Select the primitive in the tree.
2. 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

Previous: Tube

Next: Plane

Part

Part

• Primitives: Box, Cone, Cylinder, Sphere, Torus, Create primitives, Shape builder

---

• Modifying objects: Boolean, Union, Common, Cut, Join features, Connect, Embed, Cutout
• Splitting tools: Boolean fragments, Slice a part, Slice, XOR, Part Defeaturing
• Compound: Make compound, Explode Compound, Compound Filter; Extrude, Fillet, Revolve, Section, Cross sections, Chamfer, Mirror, Ruled Surface, Sweep, Loft
• Offset tools: 3D Offset, 2D Offset, Thickness, Projection on surface

---

• Other tools: Import CAD, Export CAD, Shape from Mesh, Convert to solid, Reverse shapes, Create simple copy, Create transformed copy, Create shape element copy, Refine shape, Check geometry, Measure, Attachment

User documentation

• 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, Draft, FEM, Image, Inspection, Mesh, OpenSCAD, Part, PartDesign, Path, Points, Raytracing, Reverse Engineering, Sketcher, Spreadsheet, Start, Surface, TechDraw, Test Framework, Web
• Deprecated or unmaintained workbenches: Complete, Drawing, Robot

---

• Addons: Addon Manager, External workbenches, Scripting and macros

---

• Hubs: User hub, Power users hub, Developer hub