Part Primitives
|
Menu location |
---|
Part → Create primitives... |
Workbenches |
Part, OpenSCAD |
Default shortcut |
None |
Introduced in version |
- |
See also |
Part Builder |
Description
The Part Primitives command opens a dialog to create one or more parametric primitives. 16 primitive types are available.
The primitives that can be created with the command
Usage
Create
- There are several ways to invoke the command:
- Press the
Part Primitives button.
- Select the Part →
Create Primitives... option from the menu.
- Press the
- The Geometric Primitives task panel opens.
- Select a primitive type from the dropdown list.
- Specify the properties.
- Press the Create button.
- The primitive object is created.
- Note that the task panel stays open.
- Optionally create additional primitives.
- Press the Close button to close the task panel and finish the command.
Edit
- Double-click the primitive object in the Tree view.
- The Geometric Primitives task panel opens.
- Change one or more properties.
- The object is dynamically updated in the 3D view.
- Press the OK button.
The properties of a Part Primitive can also be changed in the Property editor, and its DataPlacement can also be changed with the Std TransformManip command.
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 arc.
Ellipse: Creates an elliptical arc.
Point: Creates a point.
Line: Creates a line.
Regular polygon: Creates a regular polygon.
Notes
- The Part Primitives command cannot create a
Part Tube.
Scripting
See also: Autogenerated API documentation, Part scripting and FreeCAD Scripting Basics.
There is a Python script to test the creation of the primitives. It 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 for 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, Draft, FEM, Inspection, Mesh, OpenSCAD, Part, PartDesign, Path, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Start, Surface, TechDraw, Test Framework, Web
- Hubs: User hub, Power users hub, Developer hub