Std Part
Std Part |
Menu location |
---|
None |
Workbenches |
All |
Default shortcut |
None |
Introduced in version |
0.17 |
See also |
Std Group, PartDesign Body |
Description
Std Part is a general purpose container that keeps together a group of objects so that they can be moved together as a unit in the 3D view.
A Std Part was developed to be used in assemblies, as one of its principal characteristics is that it has an Origin object which includes local X, Y, and Z axes, and standard planes. This Origin can serve as the reference to position and attach other objects inside the Std Part. The Std Part is principally envisioned to contain objects with a solid Part TopoShape, like Part Primitives and PartDesign Bodies, and other Std Parts in order to create complex arrangements of sub-assemblies. Nevertheless, it can also contain other objects like Mesh objects and Sketches.
The Std Part tool is not defined by a particular workbench, but by the base system. It is found in the structure toolbar.
Left: elements inside a Std Part in the tree view. Right: objects arranged in space, referred to the Origin defined by a Part.
Example uses
- As an assembly container that groups objects to be manufactured separately then glued or screwed together, like a wooden table.
- When importing a STEP assembly in FreeCAD, the main assembly and its sub-assemblies are Part containers.
- A part that is composed of multiple non-fused components, like a ball bearing.
Active Status
A FreeCAD document can contain multiple Parts. Only one Part can be active at a time. An active Part will be displayed in the tree with a light blue background color.
Origin
The Origin consists of the three standard axes (X, Y, Z) and three standard planes (XY, XZ and YZ). Sketches can be attached to these planes. All elements inside the Part are referenced to the Part's Origin; which means that the Part can be moved and rotated in reference to the global coordinate system without affecting the placement of elements inside it.
Visibility Management
The Part's visibility supersedes the visibility of any object it contains. If the Part is hidden, the objects it contains will be hidden as well, even if their visibility is set to true. Multiple objects inside a Part can be visible at a time.
How to use
- Press the Std Part button. An empty Part is created and automatically becomes active.
- To add objects to a Part, drag and drop them over the Part in the tree view.
- To remove objects from a Part, drag them out of the Part, and onto the document label at the top of the tree view.
Notes
- As of v0.19, a given object can only belong to a single Part.
- Double-click the Part in the tree view or open the context menu (right-click) and select Toggle active part to activate or deactivate the Part. If another Part is active, it will be deactivated. See active status for more information.
Properties
- DataId: ID (Part number) of the item. This field is optional.
- DataLicense: the license under which the part is released.
- DataLicense URL: the Web address where the terms license can be found.
- DataPlacement: specifies the orientation and position of the Part in the 3D space. See Placement.
- DataLabel: the Label is the name given to the operation. This name can be changed at your convenience.
- DataGroup: lists the referenced objects.
Limitations
- Even when a Part is active, newly created objects are not placed inside the Part, but at the bottom of the tree. Simply drag and drop them over the Part.
- A Part has no shape. It is therefore not possible to apply most 3D operations on a Part, such as Part Booleans.
- At this time, Draft Snaps do not work on selected Part containers or on objects inside a Part container.
- Redactor's note: at this time, it is unclear whether the Part's active status serves a purpose.
Inheritance
A Std Part is formally an instance of the class App::Part
, whose parent is the basic App GeoFeature (App::GeoFeature
class).
Simplified diagram of the relationships between the core objects in the program. The App::Part
class is a simple group that has a position in 3D space, and controls the placement of other objects it contains.
Scripting
Following command adds new group to the active document:
App.ActiveDocument.addObject("App::Part", "Part")
- File: New, Open, Close, Close All, Save, Save As, Save a Copy, Save All, Revert, Import, Export,Merge project, Project information, Print, Print preview, Export PDF, Recent files, Exit
- Edit: Undo, Redo, Cut, Copy, Paste, Duplicate selection, Refresh, Box selection, Box element selection, Select All, Delete, Send to Python Console, Placement, Transform, Alignment, Toggle Edit mode, Edit mode, Preferences
- View:
- Miscellaneous: Create new view, Orthographic view, Perspective view, Fullscreen, Bounding box, Toggle axis cross, Clipping plane, Texture mapping, Toggle navigation/Edit mode, Appearance, Random color, Workbench, Status bar
- Standard views: Fit all, Fit selection, Isometric, Dimetric, Trimetric, Home, Front, Top, Right, Rear, Bottom, Left, Rotate Left, Rotate Right
- Freeze display: Save views, Load views, Freeze view, Clear views
- Draw style: As is, Points, Wireframe, Hidden line, No shading, Shaded, Flat lines
- Stereo: Stereo red/cyan, Stereo quad buffer, Stereo Interleaved Rows, Stereo Interleaved Columns, Stereo Off, Issue camera position
- Zoom: Zoom In, Zoom Out, Box zoom
- Document window: Docked, Undocked, Fullscreen
- Visibility: Toggle visibility, Show selection, Hide selection, Select visible objects, Toggle all objects, Show all objects, Hide all objects, Toggle selectability
- Toolbars: File, Edit, Clipboard, Workbench, Macro, View, Structure, Help
- Panels: Tree view, Property view, Selection view, Tasks, Python console, DAG view, Model, Report view
- Link navigation: Go to linked object, Go to the deepest linked object, Select all links
- Tree view actions: Sync view, Sync selection, Sync placement, Pre-selection, Record selection, Single document, Multi document, Collapse/Expand, Initiate dragging, Go to selection, Selection Back, Selection Forward
- Tools: Edit parameters, Save image, Load image, Scene inspector, Dependency graph, Document utility, Measure, Add text document, View turntable, Units calculator, Customize, Addon manager
- Macro: Macro recording, Macros, Recent macros, Execute macro, Attach to remote debugger, Debug macro, Stop debugging, Step over, Step into, Toggle breakpoint
- Help: Help, FreeCAD Website, Donate, Users documentation, Python scripting documentation, Automatic Python modules documentation, FreeCAD Forum, FreeCAD FAQ, Report a bug, About FreeCAD, What's This
- Structure tools: Part, Group
- Helper tools: Create body, Create sketch, Attach sketch, Edit sketch, Validate sketch, Check geometry, Create a sub-object(s) shape binder, Create a clone, Create a datum plane, Create a datum line, Create a datum point, Create a local coordinate system
- Modeling tools:
- Additive tools: Pad, Revolution, Additive loft, Additive pipe, Additive helix, Additive box, Additive cylinder, Additive sphere, Additive cone, Additive ellipsoid, Additive torus, Additive prism, Additive wedge
- Subtractive tools: Pocket, Hole, Groove, Subtractive loft, Subtractive pipe, Subtractive helix, Subtractive box, Subtractive cylinder, Subtractive sphere, Subtractive cone, Subtractive ellipsoid, Subtractive torus, Subtractive prism, Subtractive wedge
- Boolean: Boolean operation
- Dress-up tools: Fillet, Chamfer, Draft, Thickness
- Transformation tools: Mirrored, Linear Pattern, Polar Pattern, Create MultiTransform, Scaled
- Extras: Migrate, Sprocket, Involute gear, Shaft design wizard
- Context menu: Set tip, Move object to other body, Move object after other object, Appearance, Color per face
- Preferences: Preferences, Fine tuning
- 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, Assembly, BIM, CAM, Draft, FEM, Inspection, Material, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Surface, TechDraw, Test Framework
- Hubs: User hub, Power users hub, Developer hub