Part Primitives

Previous: Tube

Next: Builder

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

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.

Cylinder: Inserts a simple parametric cylinder, with position, angle, radius and height parameters in to he active document.

Cone: Inserts a parametric truncated Cone in to the active document.

Sphere: Inserts a parametric sphere, with position, angle1, angle2, angle3 and radius parameters.

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.

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

Previous: Tube

Next: Builder

Part

Part

• Primitives: Box, Cone, Cylinder, Sphere, Torus, CreatePrimitives, Shapebuilder

---

• 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