Part EditAttachment
Part EditAttachment |
Menu location |
---|
Part → Attachment... |
Workbenches |
Part, PartDesign |
Default shortcut |
None |
Introduced in version |
0.17 |
See also |
Placement, Basic Attachment Tutorial, Part Part2DObject |
Description
Part EditAttachment is a utility to attach an object to one or more other objects. The attached object is linked to the referenced object(s), which means that if the placement or geometry of the referenced object(s) is changed, the placement of the attached object will update accordingly.
Usage
- Select the object to be attached.
- Select the Part → Attachment... option from the menu.
- Note: when working in the PartDesign Workbench and creating datum geometry or primitives, steps 1 and 2 are skipped.
- The Attachment task panel opens.
- At the top of the task panel Not attached can be read. The first button labeled Selecting... is highlighted to indicate a selection in the 3D view is expected.
- Select a vertex, edge or face/plane belonging to another object.
- In the input field to the right of the button, the referenced object and subelement are shown. For example, if a face of a Part Box is selected, the field may show
Box:Face6
. - The available modes are filtered based on the selected references and their order. For example, for modes Align O-Z-X to Align O-Y-X the first reference must be a vertex. If the first reference is a subelement of a different type, they are removed from the list.
- Select an Attachment mode in the list.
- For information on the attachment modes, hover the mouse over one of them for a tooltip to appear.
- Attached with mode <description> is now displayed at the top of the task panel.
- Depending on the selected mode, add up to three more references by pressing the Reference2, Reference3, and Reference4 buttons and repeating step 5. It is also possible to specify all references before selecting an attachment mode.
- When selecting an additional reference the label of the previous button will change and display the type of subelement of that reference.
- Optionally set an Attachment Offset.
- Press OK.
- If applicable, optionally change the DataMap Path Parameter property in the Property editor.
Options
Attachment mode
Deactivated
Attachment is disabled. The object can be moved by editing its Placement property.
Translate origin
The origin is aligned to match a vertex. The orientation is still controlled by the Placement property of the attached object.
- Reference combinations
- Vertex.
Object's X Y Z
The Placement is made equal to the Placement of a linked object.
- Reference combinations
- Any
- Conic
Object's X Z Y
The X, Y and Z axes are matched with a linked object's local X, Z and -Y axes, respectively.
- Reference combinations
- Any
- Conic
Object's Y Z X
The X, Y and Z axes are matched with a linked object's local Y, Z and X axes, respectively.
- Reference combinations
- Any
- Conic
XY on plane
The XY plane is aligned to coincide with a planar face.
- Reference combinations
- Plane
XY tangent to surface
The XY plane is made tangent to a face at a vertex
- Reference combinations
- Face, Vertex
- Vertex, Face
Z tangent to edge
The Z axis is aligned to be tangent to an edge. An optional vertex defines where.
If no vertex is linked the DataMap Path Parameter property determines the point.
- Reference combinations
- Edge
- Edge, Vertex
- Vertex, Edge
Frenet NBT
The X and Y axes are aligned to the normal (N) and binormal (B) axes of the Frenet-Serret coordinate system at a point on a curved edge. An optional vertex defines where.
If no vertex is linked the DataMap Path Parameter property determines the point. The object's origin is translated to the vertex if the vertex is first, or kept at the curve if the edge is first.
Frenet NBT is similar to Z tangent to edge, except that the X axis is well-defined.
- Reference combinations
- Curve
- Curve, Vertex
- Vertex, Curve
Frenet TNB
The X and Y axes are aligned to the tangent (T) and normal (N) axes of the Frenet-Serret coordinate system at a point on a curved edge. An optional vertex defines where.
See Frenet NBT.
Frenet TBN
The X and Y axes are aligned to the tangent (T) and binormal (B) axes of the Frenet-Serret coordinate system at a point on a curved edge. An optional vertex defines where.
See Frenet NBT.
Concentric
The XY plane is aligned to the osculating circle at a point on an edge. An optional vertex defines where.
If no vertex is linked the DataMap Path Parameter property determines the point.
- Reference combinations
- Curve
- Circle
- Curve, Vertex
- Circle, Vertex
- Vertex, Curve
- Vertex, Circle
Revolution Section
The Y axis is aligned to match the axis of the osculating circle at a point on an edge. An optional vertex defines where.
See Concentric.
XY plane by 3 points
The XY plane is aligned to pass through three vertices. The X axis will pass through the first two vertices.
- Reference combinations
- Vertex, Vertex, Vertex
- Line, Vertex
- Vertex, Line
- Line, Line
XZ plane by 3 points
The XZ plane is aligned to pass through three vertices. The X axis will pass through the first two vertices.
See XY plane by 3 points.
Folding
This is a specialty mode for folding polyhedra. Select four lines in this order: contour line (1), fold line (2), other fold line (3), other contour line (4). To determine the XY plane the contour lines are made coincident by rotating line 1 around line 2, and line 4 around line 3. The X axis of the plane is matched with line 2, The Y axis is aligned with the direction of the coinciding contour lines at a right angle to the X axis.
- Reference combinations
- Line, Line, Line, Line
Inertia CS
The X, Y and Z axes are matched with those of an inertial coordinate system, constructed on principal axes of inertia and center of mass.
- Reference combinations
- Any
- Any, Any
- Any, Any, Any
- Any, Any, Any, Any
Align O-Z-X
The origin is matched with the first Vertex. The Z and X axes are aligned towards a vertex or along a line.
See Align O-X-Y Type Attachment Modes for more details.
- Reference combinations
- Vertex, Vertex, Vertex
- Vertex, Vertex, Line
- Vertex, Line, Vertex
- Vertex, Line, Line
- Vertex, Vertex
- Vertex, Line
Align O-Z-Y
The origin is matched with the first Vertex. The Z and Y axes are aligned towards a vertex or along a line.
See Align O-Z-X.
Align O-X-Y
The origin is matched with the first Vertex. The X and Y axes are aligned towards a vertex or along a line.
See Align O-Z-X.
Align O-X-Z
The origin is matched with the first Vertex. The X and Z axes are aligned towards a vertex or along a line.
See Align O-Z-X.
Align O-Y-Z
The origin is matched with the first Vertex. The Y and Z axes are aligned towards a vertex or along a line.
See Align O-Z-X.
Align O-Y-X
The origin is matched with the first Vertex. The Y and X axes are aligned towards a vertex or along a line.
See Align O-Z-X.
Attachment Offset
Attachment Offset becomes active when an attachment mode other than Deactivated has been selected. It is used to apply a linear or rotary offset within the attachment coordinate system (ACS), as defined by the attachment mode and the referenced object(s).
- In x-direction: sets an offset distance along the X axis of the ACS.
- In y-direction: sets an offset distance along the Y axis of the ACS.
- In z-direction: sets an offset distance along the Z axis of the ACS.
- Around x-axis: rotates the attached object around the X axis of the ACS.
- Around y-axis: rotates the attached object around the Y axis of the ACS.
- Around z-axis: rotates the attached object around the Z axis of the ACS.
- Flip sides: if checked, the attachment is reversed. This is equivalent to rotating the object 180° around the Y axis of the ACS.
Limitations
- If selecting two lines results in an error: "Points are collinear. Can't make a plane", try selecting three points instead [1].
- Primitives: Box, Cylinder, Sphere, Cone, Torus, Tube, Create primitives, Shape builder
- Creation and modification: Extrude, Revolve, Mirror, Scale, 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
- 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, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Surface, TechDraw, Test Framework
- Hubs: User hub, Power users hub, Developer hub