This documentation is not finished. Please help and contribute documentation.
GuiCommand model explains how commands should be documented. Browse Category:UnfinishedDocu to see more incomplete pages like this one. See Category:Command Reference for all commands.
See WikiPages to learn about editing the wiki pages, and go to Help FreeCAD to learn about other ways in which you can contribute.
This page has to distinguish between FreeCAD objects and real world items that are created by an operation called extrusion.
On this page extrusion/extruded object will be used for FreeCAD's document objects or tree objects such as Part Extrude objects, and Part Design Pad objects while extrusion/extruded item represents real world items that, if modeled in assembled condition, usually are sweep objects
Profile based design builds on the principle of tracing the movement of a profile through 3D space to create 3D shapes, either along a 3D curve, or via several supporting 2D curves. This page tries to name and describe several types of shapes properly according to descriptive geometry terminology together with the FreeCAD tools that can be used to create a certain geometry. Bear in mind that descriptive geometry terminology and FreeCAD tool names do not always match with each other (See the preface above about extrusion).
Feel invited to improve poorly chosen terms if found.
Several tools distinguish between profile and section for an open or closed 2D contour (line, arc, circle, or polyline), if more than one contours are used. The first one is always called profile, optional or required additional ones are called sections. Wiki pages often use cross-section for the latter to avoid confusion with section meaning section view, and so does this page.
Generally there are two principle ways to create 3D shapes from 2D contours: Tracing a profile along a spine and distributing a face between two or more supporting 2D contours (3D curves may be accepted by some tools but using 2D curves are tried and trusted since the days of manual drafting).
Traced or distributed shapes are usually hollow pipe-like shells. If both their base profile and final cross-section enclose a face they result in a closed shell, sometimes called a volume. Volumes are considered hollow, if they are filled they are called solids. Closed volumes created with Part tools are automatically considered solid shapes.
Shapes built with PartDesign features are always solids, and since open profiles usually result in surface shapes they currently cannot be used to create PartDesign features.
Prismatic shapes have invariable cross-sections traced along a straight line/vector, and we have to decide if we need a surface shape or a solid shape.
Prismatic surface shapes can be created with Part Extrude. The elements of the profile have an influence on the resulting shape:
Profiles (green), extrusion vector (yellow), and resulting shapes
Prismatic solid shapes (also called prismoids) can be created with Part Extrude, too if the option Create solid is checked, or with
PartDesign Pad.
Closed profiles from above and resulting Part shapes with option Create solid enabled
See PartDesign Examples for more prismatic solids.
Another tool to to create prismatic solid shapes is provided by the external SheetMetal workbench:
Make Base Wall creates planar objects (blanks) from closed contours and unfoldable bend objects from open contours.
/
Right: Closed profiles (nested included) result in blanks having a thickness / Left: Open profiles result in profile objects having a thickness and a length
Rotated shapes have invariable cross-sections traced around an axis (which is the same as along a circular line) and we have again to decide if we need a surface shape or a solid shape.
Rotated surface shapes can be created with Part Revolve. The elements of the profile have an influence on the resulting shape:
Profiles (green), rotation axis (yellow), and resulting shapes
Rotatated solid shapes (also called toroids) can be created with Part Revolve, too if the option Create solid is checked, or with
PartDesign Revolution.
Closed profiles from above and resulting Part shapes with option Create solid enabled
See PartDesign Examples for rotated solids. (They show profiles distributed along a circular spine, but the resulting shapes are the same as if the profiles were rotated)
Sweep shapes have invariable cross-sections distributed and traced along a spine (the spine is a 2D or 3D backbone curve that controlls the location and normal direction of cross-sections). We have in this case as well to decide if we need a surface shape or a solid shape.
Sweep surface shapes can be created with Part Sweep.
Profiles (green), spine (yellow), and resulting shapes)
Sweep solid shapes can be created with Part Sweep, too if the option Create solid is checked, or with
PartDesign AdditivePipe.
Closed profiles from above and resulting Part shapes with option Create solid enabled
Real world items that are produced by a manufacturing process called extrusion, i.e. by pushing material through a die, are usually modeled in their assembled condition and in their manufacturing condition. This also applies to items produced by rolling.
In relation with CAD to extrude usually means to distribute a profile along a straight line or vector. Even open profiles with no thickness can be extruded, which is impossible in the real world.
An L-shaped roll-formed and bent frame modelled with Part Sweep, with a mounted sealing profile (a sweep object with a nested contour) made with
PartDesign AdditivePipe, both based on the same spine
Prismatic and rotated shapes can be created with the sweep tools as well if lines, and arcs or circles are used as spines. See PartDesign Examples.
What does a CAD application do in the background? As stated above, we supply the profile and some kind of spine and the sweep tools do the uncomfortable work:
To visualize the steps we use a profile similar to the "Hamburger Zipfel" that has taught generations of automotive students how to distribute and trace sealing profiles manually.
Profile (green), spine (yellow), normal planes on start/end points of segments (light blue), cross-sections (light green), connecting curves (grey), and faces (blue) in order of appearance
FreeCAD's sweep tools allow to use profiles that do not lie on planes that are normal to the spine, but they are still controlled by the virtual working planes. This should be avoided as this leads to kinks in the object surfaces:
Profile tilted out of the normal plane (purple) and the resulting shape in comparison with the previous example (grey profile and dashed lines); the kinks are clearly visible
This example uses a straight spine (yellow) and a guide curve (orange) that is a quarter turn of a helix around the spine to demonstrate the principle how a guide curve twists a profile around the spine
A too small radius: If the radius of the spine is too small the cross-sections will intersect resulting in non-manifold geometry, but to a certain degree the sweep tools are able to render a shape anyway:
Profile and intersecting cross-sections resulting in an impossible shape
View from a different angle and bottom view. If the spine's radius is further decreased so that the yellow face would completely lie inside the shape, the sweep tools can no longer render or update the shape
Loft shapes usually connect a profile and a cross-section with a different shape without a spine so that they in general have varying cross-sections. They are rather used to create a transition shape between profile and cross-Section. FreeCAD's loft tools Part Loft and
PartDesign AdditiveLoft use straight lines as connecting curves for a profile and a single cross-section, or 3D splines in case of several cross-sections. The latter can be switched to straight lines, too by activating the Ruled Surface option.
All cross-sections have to be placed in 3D space manually.
Loft surface shapes can be created with Part Loft
Loft solid shapes can be created with Part Loft, too if the Create solid option is checked, or with
PartDesign AdditiveLoft.
Loft shapes from identical profiles usually don't make much sense, but they are included here for a rough comparison with sweep shapes.
Profile and cross-sections of the sweep distribution example used as loft profiles (dashed lines represent the sweep shape). Right: default settings. Left: Ruled surface option activated
Some tools allow to select a point (or a sketch containing only a single point) for either the profile or the last cross-section to grow or respectively shrink a profile from the profile to the cross-section. This is a way to model pyramids, cones (both regular and tilted), or horns
Truncated pyramids, cones, or horns require to copy and scale the profile to create one or more cross-sections, with subshape binders for instance.