Part EditAttachment: Difference between revisions

From FreeCAD Documentation
(Marked this version for translation)
No edit summary
(13 intermediate revisions by 6 users not shown)
Line 1: Line 1:
⚫
<languages/>
<translate>
<translate>
⚫
<!--T:90-->
{{Docnav|[[Part_Measure_Toggle_Delta|Toggle Delta]]||[[Part_Module|Part]]|IconL=Part_Measure_Toggle_Delta.svg|IconC=Workbench_Part.svg|IconR=}}

<!--T:1-->
<!--T:1-->
{{GuiCommand
{{GuiCommandNoIcon|Name=Part Attachment|Workbenches=[[Part Module|Part]], [[PartDesign Workbench|PartDesign]]|MenuLocation=Part → Attachment…|Shortcut=None|SeeAlso=[[Placement]]}}
|Name=Part Attachment
|MenuLocation=Part → Attachment...
|Workbenches=[[Part Module|Part]], [[PartDesign Workbench|PartDesign]]
|SeeAlso=[[Placement|Placement]]
|Version=0.17
}}


==Description== <!--T:2-->
== Description== <!--T:2-->


<!--T:3-->
<!--T:3-->
'''Attachment''' is a utility to attach an object to another one. The attached object is linked to the other object, which means that if the latter's placement is changed afterwards, the attached object will follow to its new position.
'''Attachment''' is a utility to attach an object to another one. The attached object is linked to the other object, which means that if the latter's placement is changed afterwards, the attached object will update to its new position.


<!--T:4-->
<!--T:4-->
{{Version|0.17}}
{{Version |0.17}}


==How to use== <!--T:5-->
== How to use== <!--T:5-->


<!--T:6-->
<!--T:6-->
# Select the object to be attached.
# Select the object to be attached.
# Go to the '''Part → Attachment…''' menu.
# Go to the '''Part → Attachment...''' menu.
#: '''Note''': when working in [[PartDesign Workbench|PartDesign]] and creating sketches, datum geometry or primitives, steps 1 and 2 are unnecessary: the Attachment dialogue is brought up automatically.
#: '''Note''': when working in [[PartDesign Workbench|PartDesign]] and creating sketches, datum geometry or primitives, steps 1 and 2 are unnecessary: the Attachment dialogue is brought up automatically.
# Under '''Attachment''' parameters, ''Not attached'' can be read. The first button below is labeled {{KEY|Selecting…}} to indicate it is expecting a selection in the 3D view.
# Under '''Attachment''' parameters, ''Not attached'' can be read. The first button below is labeled {{KEY|Selecting…}} to indicate it is expecting a selection in the 3D view.
Line 22: Line 32:
# Select an [[#Attachment mode|Attachment mode]] in the list. The available modes are filtered by the selected references. ''Attached with mode <mode description>'' will be displayed under the '''Attachment''' header.
# Select an [[#Attachment mode|Attachment mode]] in the list. The available modes are filtered by the selected references. ''Attached with mode <mode description>'' will be displayed under the '''Attachment''' header.
#: For live information on the attachment modes, hover the mouse on top of one of the modes in the list for a tooltip to appear.
#: For live information on the attachment modes, hover the mouse on top of one of the modes in the list for a tooltip to appear.
# Optionally, add up to 3 more references by pressing the {{KEY|Reference2}}, {{KEY|Reference3}}, and {{KEY|Reference3}} buttons and repeating step 4.
# Optionally, add up to 3 more references by pressing the {{KEY|Reference2}}, {{KEY|Reference3}}, and {{KEY|Reference4}} buttons and repeating step 4.
# Optionally set an [[#Attachment Offset|Attachment Offset]].
# Optionally set an [[#Attachment Offset|Attachment Offset]].
# Press {{KEY|OK}}.
# Press {{KEY|OK}}.


==Options== <!--T:7-->
== Options== <!--T:7-->


<!--T:8-->
<!--T:8-->
[[File:Part Offset Tasks.png|right]]
[[File:Part Offset Tasks.png | right]]


===Attachment mode=== <!--T:9-->
=== Attachment mode=== <!--T:9-->


====Deactivated==== <!--T:10-->
==== Deactivated==== <!--T:10-->


<!--T:11-->
<!--T:11-->
Default, no reference selected.
Default, no reference selected .


====Normal to edge==== <!--T:12-->
==== Normal to edge==== <!--T:12-->


<!--T:13-->
<!--T:13-->
Object is made perpendicular to edge. Optional vertex reference defines location.
Object is made perpendicular to edge. Optional vertex reference defines location .


<!--T:14-->
<!--T:14-->
:; Reference combinations
:; Reference combinations:
: Edge
: Edge
: Edge, Vertex
: Edge, Vertex
: Vertex, Edge
: Vertex, Edge


====Align O-N-X==== <!--T:15-->
==== Align O-N-X==== <!--T:15-->


<!--T:16-->
<!--T:16-->
Matches object's origin with first referenced vertex, then aligns its normal and horizontal plane axis toward vertex/along line.
Matches object's origin with first referenced vertex, then aligns its normal and horizontal plane axis toward vertex/along line .


<!--T:17-->
<!--T:17-->
:; Reference combinations
:; Reference combinations:
: Vertex, Vertex, Vertex
: Vertex, Vertex, Vertex
: Vertex, Vertex, Edge
: Vertex, Vertex, Edge
Line 63: Line 73:
: Vertex, Edge
: Vertex, Edge


====Align O-N-Y==== <!--T:18-->
==== Align O-N-Y==== <!--T:18-->


<!--T:19-->
<!--T:19-->
Matches object's origin with first referenced vertex and aligns its normal and vertical plane axis toward vertex/along line.
Matches object's origin with first referenced vertex and aligns its normal and vertical plane axis toward vertex/along line .


<!--T:20-->
<!--T:20-->
:; Reference combinations
:; Reference combinations:
: Vertex, Vertex, Vertex
: Vertex, Vertex, Vertex
: Vertex, Vertex, Edge
: Vertex, Vertex, Edge
Line 77: Line 87:
: Vertex, Edge
: Vertex, Edge


====Align O-X-Y==== <!--T:21-->
==== Align O-X-Y==== <!--T:21-->


<!--T:22-->
<!--T:22-->
Matches object's origin with first referenced vertex and aligns its horizontal and vertical plane axes toward vertex/along line.
Matches object's origin with first referenced vertex and aligns its horizontal and vertical plane axes toward vertex/along line .


<!--T:23-->
<!--T:23-->
:; Reference combinations
:; Reference combinations:
: Vertex, Vertex, Vertex
: Vertex, Vertex, Vertex
: Vertex, Vertex, Edge
: Vertex, Vertex, Edge
Line 91: Line 101:
:Vertex, Edge
:Vertex, Edge


====Align O-X-N==== <!--T:24-->
==== Align O-X-N==== <!--T:24-->


<!--T:25-->
<!--T:25-->
Matches object's origin with first referenced vertex and aligns its horizontal plane axis and normal toward vertex/along line.
Matches object's origin with first referenced vertex and aligns its horizontal plane axis and normal toward vertex/along line .


<!--T:26-->
<!--T:26-->
:; Reference combinations
:; Reference combinations:
: Vertex, Vertex, Vertex
: Vertex, Vertex, Vertex
: Vertex, Vertex, Edge
: Vertex, Vertex, Edge
Line 105: Line 115:
: Vertex, Edge
: Vertex, Edge


====Align O-Y-N==== <!--T:27-->
==== Align O-Y-N==== <!--T:27-->


<!--T:28-->
<!--T:28-->
Matches object's origin with first referenced vertex and aligns its vertical plane axis and normal toward vertex/along line.
Matches object's origin with first referenced vertex and aligns its vertical plane axis and normal toward vertex/along line .


<!--T:29-->
<!--T:29-->
:; Reference combinations
:; Reference combinations:
: Vertex, Vertex, Vertex
: Vertex, Vertex, Vertex
: Vertex, Vertex, Edge
: Vertex, Vertex, Edge
Line 119: Line 129:
: Vertex, Edge
: Vertex, Edge


====Align O-Y-X==== <!--T:30-->
==== Align O-Y-X==== <!--T:30-->


<!--T:31-->
<!--T:31-->
Matches object's origin with first referenced vertex and aligns its vertical and horizontal plane axes toward vertex/along line.
Matches object's origin with first referenced vertex and aligns its vertical and horizontal plane axes toward vertex/along line .


<!--T:32-->
<!--T:32-->
:; Reference combinations
:; Reference combinations:
: Vertex, Vertex, Vertex
: Vertex, Vertex, Vertex
: Vertex, Vertex, Edge
: Vertex, Vertex, Edge
Line 133: Line 143:
:Vertex, Edge
:Vertex, Edge


====Translate origin==== <!--T:33-->
==== Translate origin==== <!--T:33-->


<!--T:34-->
<!--T:34-->
Object's origin is aligned to matched vertex. Orientation is controlled by Placement property.
Object's origin is aligned to matched vertex. Orientation is controlled by [[Placement|Placement]] property.


<!--T:35-->
<!--T:35-->
:; Reference combinations
:; Reference combinations:
: Vertex.
: Vertex.


====Object's XY==== <!--T:36-->
==== Object's XY==== <!--T:36-->


<!--T:37-->
<!--T:37-->
Plane is aligned to XY local plane of linked object.
Plane is aligned to XY local plane of linked object .


<!--T:38-->
<!--T:38-->
:; Reference combinations
:; Reference combinations:
: Any, Conic.
: Any, Conic.


====Object's XZ==== <!--T:39-->
==== Object's XZ==== <!--T:39-->


<!--T:40-->
<!--T:40-->
Plane is aligned to XZ local plane of linked object.
Plane is aligned to XZ local plane of linked object .


<!--T:41-->
<!--T:41-->
:; Reference combinations
:; Reference combinations:
: Any, Conic.
: Any, Conic.


====Object's YZ==== <!--T:42-->
==== Object's YZ==== <!--T:42-->


<!--T:43-->
<!--T:43-->
Plane is aligned to YZ local plane of linked object.
Plane is aligned to YZ local plane of linked object .


<!--T:44-->
<!--T:44-->
:; Reference combinations
:; Reference combinations:
: Any, Conic
: Any, Conic


====Plane face==== <!--T:45-->
==== Plane face==== <!--T:45-->


<!--T:46-->
<!--T:46-->
Plane is aligned to coincide to planar face.
Plane is aligned to coincide to planar face .


<!--T:47-->
<!--T:47-->
:; Reference combinations
:; Reference combinations:
: Plane
: Plane


====Tangent to surface==== <!--T:48-->
==== Tangent to surface==== <!--T:48-->


<!--T:49-->
<!--T:49-->
Plane is made tangent to surface at vertex.
Plane is made tangent to surface at vertex .


<!--T:50-->
<!--T:50-->
:; Reference combinations
:; Reference combinations:
: Face, Vertex
: Face, Vertex
: Vertex, Face
: Vertex, Face


====Frenet NB==== <!--T:51-->
==== Frenet NB==== <!--T:51-->


<!--T:52-->
<!--T:52-->
Plane is set to normal-binormal (NB) axes of [https://en.wikipedia.org/wiki/Frenet%E2%80%93Serret_formulas Frenet-Serret coordinates] at the point of the edge's curve that is closest to the vertex (or defined by MapPathParameter property, if vertex is not linked). The object's origin is translated to the vertex if the vertex is first, or kept at the curve if edge is first. This mode is similar to ''Normal to edge'', except that X axis is well-defined.
Plane is set to normal-binormal (NB) axes of [https://en.wikipedia.org/wiki/Frenet%E2%80%93Serret_formulas Frenet-Serret coordinates ] at the point of the edge's curve that is closest to the vertex (or defined by MapPathParameter property, if vertex is not linked). The object's origin is translated to the vertex if the vertex is first, or kept at the curve if edge is first. This mode is similar to ''Normal to edge'', except that X axis is well-defined.


<!--T:53-->
<!--T:53-->
:;Reference combinations
:;Reference combinations:
: Curve
: Curve
: Curve, Vertex
: Curve, Vertex
Line 200: Line 210:
: [[File:Attacher mode FrenetNB.png|250px]]
: [[File:Attacher mode FrenetNB.png|250px]]


====Frenet TN==== <!--T:54-->
==== Frenet TN==== <!--T:54-->


<!--T:55-->
<!--T:55-->
Plane is set to tangent-normal (TN) axes of [https://en.wikipedia.org/wiki/Frenet%E2%80%93Serret_formulas Frenet-Serret coordinates] at the point of the edge's curve that is closest to the vertex (or defined by MapPathParameter property, if vertex is not linked). The origin of sketch is translated to the vertex if the vertex is first, or kept at the curve if edge is first. Effectively, if the curve is planar, the sketching plane is the plane of the curve.
Plane is set to tangent-normal (TN) axes of [https://en.wikipedia.org/wiki/Frenet%E2%80%93Serret_formulas Frenet-Serret coordinates ] at the point of the edge's curve that is closest to the vertex (or defined by MapPathParameter property, if vertex is not linked). The origin of sketch is translated to the vertex if the vertex is first, or kept at the curve if edge is first. Effectively, if the curve is planar, the sketching plane is the plane of the curve.


<!--T:56-->
<!--T:56-->
:;Reference combinations
:;Reference combinations:
: Curve
: Curve
: Curve, Vertex
: Curve, Vertex
Line 212: Line 222:
: [[File:Attacher_mode_FrenetTN.png|250px]]
: [[File:Attacher_mode_FrenetTN.png|250px]]


====Frenet TB==== <!--T:57-->
==== Frenet TB==== <!--T:57-->


<!--T:58-->
<!--T:58-->
Plane is set tangent-binormal (TB) axes of Frenet-Serret coordinates at the point of the edge's curve that is closest to the vertex (or defined by MapPathParameter property, if vertex is not linked). The origin of sketch is translated to the vertex if the vertex is first, or kept at the curve if edge is first.
Plane is set tangent-binormal (TB) axes of [https://en.wikipedia.org/wiki/Frenet%E2%80%93Serret_formulas Frenet-Serret coordinates] at the point of the edge's curve that is closest to the vertex (or defined by MapPathParameter property, if vertex is not linked). The origin of sketch is translated to the vertex if the vertex is first, or kept at the curve if edge is first.


<!--T:59-->
<!--T:59-->
:;Reference combinations
:;Reference combinations:
: Curve
: Curve
: Curve, Vertex
: Curve, Vertex
Line 224: Line 234:
: [[File:Attacher_mode_FrenetTB.png|250px]]
: [[File:Attacher_mode_FrenetTB.png|250px]]


====Concentric==== <!--T:60-->
==== Concentric==== <!--T:60-->


<!--T:61-->
<!--T:61-->
Aligns to plane to osculating circle of an edge. Optional Vertex link defines where.
Aligns to plane to osculating circle of an edge. Optional Vertex link defines where .


<!--T:62-->
<!--T:62-->
:; Reference combinations
:; Reference combinations:
: Curve
: Curve
: Circle
: Circle
Line 238: Line 248:
: Vertex, Circle
: Vertex, Circle


====Revolution Section==== <!--T:63-->
==== Revolution Section==== <!--T:63-->


<!--T:64-->
<!--T:64-->
Plane is perpendicular to edge, and Y axis is matched with axis of osculating circle. Optional Vertex link defines where.
Plane is perpendicular to edge, and Y axis is matched with axis of osculating circle. Optional Vertex link defines where .


<!--T:65-->
<!--T:65-->
:; Reference combinations
:; Reference combinations:
: Curve
: Curve
: Circle
: Circle
Line 252: Line 262:
: Vertex, Circle
: Vertex, Circle


====Plane by 3 points==== <!--T:66-->
==== Plane by 3 points==== <!--T:66-->


<!--T:67-->
<!--T:67-->
Aligns XY plane to pass through three vertices.
Aligns XY plane to pass through three vertices .


<!--T:68-->
<!--T:68-->
:; Reference combinations
:; Reference combinations:
: Vertex, Vertex, Vertex
: Vertex, Vertex, Vertex
: Line, Vertex
: Line, Vertex
Line 264: Line 274:
: Line, Line
: Line, Line


====Normal to 3 points==== <!--T:69-->
==== Normal to 3 points==== <!--T:69-->


<!--T:70-->
<!--T:70-->
Aligns plane to pass through first two vertices, and perpendicular to plane that passes through 3 vertices.
Aligns plane to pass through first two vertices, and perpendicular to plane that passes through 3 vertices .


<!--T:71-->
<!--T:71-->
:; Reference combinations
:; Reference combinations:
: Vertex, Vertex, Vertex
: Vertex, Vertex, Vertex
: Line, Vertex
: Line, Vertex
Line 276: Line 286:
: Line, Line
: Line, Line


====Folding==== <!--T:72-->
==== Folding==== <!--T:72-->


<!--T:73-->
<!--T:73-->
Specialty mode for folding polyhedra. Select 4 edge in order: foldable edge, fold line, other fold line, other foldable edge. Plane will be aligned to folding the first edge. In the picture below, it is not required that both leafs to fold together be the same.
Specialty mode for folding polyhedra. Select 4 edge in order: foldable edge, fold line, other fold line, other foldable edge. Plane will be aligned to folding the first edge. In the picture below, it is not required that both leafs to fold together be the same .


<!--T:74-->
<!--T:74-->
:; Reference combinations
:; Reference combinations
: Line, Line, Line, Line
: Line, Line, Line, Line
: [[File:Attacher_mode_Folding.png|250px]]
: [[File:Attacher_mode_Folding.png| 250px]]




====Inertia 2-3==== <!--T:75-->
==== Inertia 2-3==== <!--T:75-->


<!--T:76-->
<!--T:76-->
Object will be attached to a plane passing through second and third principal axes of inertia (passes through center of mass).
Object will be attached to a plane passing through second and third principal axes of inertia (passes through center of mass) .


<!--T:77-->
<!--T:77-->
:; Reference combinations
:; Reference combinations:
: Any
: Any
: Any, Any
: Any, Any
Line 299: Line 309:
: Any, Any, Any, Any
: Any, Any, Any, Any


===Attachment Offset=== <!--T:78-->
=== Attachment Offset=== <!--T:78-->


<!--T:79-->
<!--T:79-->
Attachment Offset is used to apply a linear or rotary offset from the referenced object. It becomes active when an attachment mode other than ''Deactivated'' has been selected.
Attachment Offset is used to apply a linear or rotary offset from the referenced object. That means the offsets are relative to the ''local'' coordinate system, not to the global. It becomes active when an attachment mode other than ''Deactivated'' has been selected .


<!--T:80-->
<!--T:80-->
* '''X''': sets an offset distance in the X axis of the reference object.
* '''X''': sets an offset distance in the X axis of the reference object .


<!--T:81-->
<!--T:81-->
* '''Y''': sets an offset distance in the Y axis of the reference object.
* '''Y''': sets an offset distance in the Y axis of the reference object .


<!--T:82-->
<!--T:82-->
* '''Z''': sets an offset distance in the Z axis of the reference object.
* '''Z''': sets an offset distance in the Z axis of the reference object. This coordinate is to be used for the frequent use case that you want to offset a sketch perpendicular to the plane.


<!--T:83-->
<!--T:83-->
* '''Yaw''': rotates the attached object along the reference object's Z axis.
* '''Yaw''': rotates the attached object along the reference object's Z axis .


<!--T:84-->
<!--T:84-->
* '''Pitch''': rotates the attached object along the reference object's Y axis.
* '''Pitch''': rotates the attached object along the reference object's Y axis .


<!--T:85-->
<!--T:85-->
* '''Roll''': rotates the attached object along the reference object's X axis.
* '''Roll''': rotates the attached object along the reference object's X axis .


<!--T:86-->
<!--T:86-->
* '''Flip sides''': if checked, the attached object is reversed from its XY plane.
* '''Flip sides''': if checked, the attached object is reversed from its XY plane .


===Limitations=== <!--T:87-->
=== Limitations=== <!--T:87-->


<!--T:88-->
<!--T:88-->
* [[Std Part|Part]] and [[PartDesign Body|Body]] containers are not supported. While it's possible to use Attachment to align them, the attachment won't be parametrically linked.
* [[Std Part|Part]] and [[PartDesign Body|Body]] containers are not supported. While it's possible to use Attachment to align them, the attachment won't be parametrically linked .


<!--T:91-->
{{Docnav|[[Part_Measure_Toggle_Delta|Toggle Delta]]||[[Part_Module|Part]]|IconL=Part_Measure_Toggle_Delta.svg|IconC=Workbench_Part.svg|IconR=}}

<!--T:92-->
{{Part Tools navi}}

<!--T:93-->
{{Userdocnavi}}


⚫
<!--T:89-->
[[Category:User Documentation]]
</translate>
</translate>
⚫
<languages/>

Revision as of 08:46, 14 March 2019

Other languages:

Part Attachment

Menu location
Part → Attachment...
Workbenches
Part, PartDesign
Default shortcut
None
Introduced in version
0.17
See also
Placement

Description

Attachment is a utility to attach an object to another one. The attached object is linked to the other object, which means that if the latter's placement is changed afterwards, the attached object will update to its new position.

introduced in version 0.17

How to use

  1. Select the object to be attached.
  2. Go to the Part → Attachment... menu.
    Note: when working in PartDesign and creating sketches, datum geometry or primitives, steps 1 and 2 are unnecessary: the Attachment dialogue is brought up automatically.
  3. Under Attachment parameters, Not attached can be read. The first button below is labeled Selecting… to indicate it is expecting a selection in the 3D view.
  4. Select a topology element on the object to attach to: vertex, edge or face/plane. Datum geometry from Part containers are also selectable.
  5. The first button's label now adopts the type of topology selected. In the white field to its right, the referenced object and its element is added. For example, if a face on a primitive cube is selected, the field will show Box:Face6.
  6. Select an Attachment mode in the list. The available modes are filtered by the selected references. Attached with mode <mode description> will be displayed under the Attachment header.
    For live information on the attachment modes, hover the mouse on top of one of the modes in the list for a tooltip to appear.
  7. Optionally, add up to 3 more references by pressing the Reference2, Reference3, and Reference4 buttons and repeating step 4.
  8. Optionally set an Attachment Offset.
  9. Press OK.

Options

Attachment mode

Deactivated

Default, no reference selected .

Normal to edge

Object is made perpendicular to edge. Optional vertex reference defines location .

Reference combinations
Edge
Edge, Vertex
Vertex, Edge

Align O-N-X

Matches object's origin with first referenced vertex, then aligns its normal and horizontal plane axis toward vertex/along line .

Reference combinations
Vertex, Vertex, Vertex
Vertex, Vertex, Edge
Vertex, Edge, Vertex
Vertex, Edge, Edge
Vertex, Vertex
Vertex, Edge

Align O-N-Y

Matches object's origin with first referenced vertex and aligns its normal and vertical plane axis toward vertex/along line .

Reference combinations
Vertex, Vertex, Vertex
Vertex, Vertex, Edge
Vertex, Edge, Vertex
Vertex, Edge, Edge
Vertex, Vertex
Vertex, Edge

Align O-X-Y

Matches object's origin with first referenced vertex and aligns its horizontal and vertical plane axes toward vertex/along line .

Reference combinations
Vertex, Vertex, Vertex
Vertex, Vertex, Edge
Vertex, Edge, Vertex
Vertex, Edge, Edge
Vertex, Vertex
Vertex, Edge

Align O-X-N

Matches object's origin with first referenced vertex and aligns its horizontal plane axis and normal toward vertex/along line .

Reference combinations
Vertex, Vertex, Vertex
Vertex, Vertex, Edge
Vertex, Edge, Vertex
Vertex, Edge, Edge
Vertex, Vertex
Vertex, Edge

Align O-Y-N

Matches object's origin with first referenced vertex and aligns its vertical plane axis and normal toward vertex/along line .

Reference combinations
Vertex, Vertex, Vertex
Vertex, Vertex, Edge
Vertex, Edge, Vertex
Vertex, Edge, Edge
Vertex, Vertex
Vertex, Edge

Align O-Y-X

Matches object's origin with first referenced vertex and aligns its vertical and horizontal plane axes toward vertex/along line .

Reference combinations
Vertex, Vertex, Vertex
Vertex, Vertex, Edge
Vertex, Edge, Vertex
Vertex, Edge, Edge
Vertex, Vertex
Vertex, Edge

Translate origin

Object's origin is aligned to matched vertex. Orientation is controlled by Placement property.

Reference combinations
Vertex.

Object's XY

Plane is aligned to XY local plane of linked object .

Reference combinations
Any, Conic.

Object's XZ

Plane is aligned to XZ local plane of linked object .

Reference combinations
Any, Conic.

Object's YZ

Plane is aligned to YZ local plane of linked object .

Reference combinations
Any, Conic

Plane face

Plane is aligned to coincide to planar face .

Reference combinations
Plane

Tangent to surface

Plane is made tangent to surface at vertex .

Reference combinations
Face, Vertex
Vertex, Face

Frenet NB

Plane is set to normal-binormal (NB) axes of Frenet-Serret coordinates at the point of the edge's curve that is closest to the vertex (or defined by MapPathParameter property, if vertex is not linked). The object's origin is translated to the vertex if the vertex is first, or kept at the curve if edge is first. This mode is similar to Normal to edge, except that X axis is well-defined.

Reference combinations
Curve
Curve, Vertex
Vertex, Curve

Frenet TN

Plane is set to tangent-normal (TN) axes of Frenet-Serret coordinates at the point of the edge's curve that is closest to the vertex (or defined by MapPathParameter property, if vertex is not linked). The origin of sketch is translated to the vertex if the vertex is first, or kept at the curve if edge is first. Effectively, if the curve is planar, the sketching plane is the plane of the curve.

Reference combinations
Curve
Curve, Vertex
Vertex, Curve

Frenet TB

Plane is set tangent-binormal (TB) axes of Frenet-Serret coordinates at the point of the edge's curve that is closest to the vertex (or defined by MapPathParameter property, if vertex is not linked). The origin of sketch is translated to the vertex if the vertex is first, or kept at the curve if edge is first.

Reference combinations
Curve
Curve, Vertex
Vertex, Curve

Concentric

Aligns to plane to osculating circle of an edge. Optional Vertex link defines where .

Reference combinations
Curve
Circle
Curve, Vertex
Circle, Vertex
Vertex, Curve
Vertex, Circle

Revolution Section

Plane is perpendicular to edge, and Y axis is matched with axis of osculating circle. Optional Vertex link defines where .

Reference combinations
Curve
Circle
Curve, Vertex
Circle, Vertex
Vertex, Curve
Vertex, Circle

Plane by 3 points

Aligns XY plane to pass through three vertices .

Reference combinations
Vertex, Vertex, Vertex
Line, Vertex
Vertex, Line
Line, Line

Normal to 3 points

Aligns plane to pass through first two vertices, and perpendicular to plane that passes through 3 vertices .

Reference combinations
Vertex, Vertex, Vertex
Line, Vertex
Vertex, Line
Line, Line

Folding

Specialty mode for folding polyhedra. Select 4 edge in order: foldable edge, fold line, other fold line, other foldable edge. Plane will be aligned to folding the first edge. In the picture below, it is not required that both leafs to fold together be the same .

Reference combinations
Line, Line, Line, Line


Inertia 2-3

Object will be attached to a plane passing through second and third principal axes of inertia (passes through center of mass) .

Reference combinations
Any
Any, Any
Any, Any, Any
Any, Any, Any, Any

Attachment Offset

Attachment Offset is used to apply a linear or rotary offset from the referenced object. That means the offsets are relative to the local coordinate system, not to the global. It becomes active when an attachment mode other than Deactivated has been selected .

  • X: sets an offset distance in the X axis of the reference object .
  • Y: sets an offset distance in the Y axis of the reference object .
  • Z: sets an offset distance in the Z axis of the reference object. This coordinate is to be used for the frequent use case that you want to offset a sketch perpendicular to the plane.
  • Yaw: rotates the attached object along the reference object's Z axis .
  • Pitch: rotates the attached object along the reference object's Y axis .
  • Roll: rotates the attached object along the reference object's X axis .
  • Flip sides: if checked, the attached object is reversed from its XY plane .

Limitations

  • Part and Body containers are not supported. While it's possible to use Attachment to align them, the attachment won't be parametrically linked .
Part
User documentation
Retrieved from "http://wiki.freecad.org/index.php?title=Part_EditAttachment&oldid=441943"