User:DeepSOIC

Mapping modes of the new Attacher

Mode Deactivated
references: any action: sketch remains where it was. Attachment is disabled.

Mode Translate
references: vertex action: sketch origin is translated to coincide with the vertex. Sketch orientation doesn't change, and can be modified by changing Placement property.

Mode ObjectXY
references: object action: sketching plane is XY plane of object's local coordinate system (according to its Placement property).

Mode ObjectXZ
references: object action: like ObjectXY.

Mode ObjectYZ
references: object action: like ObjectXY.

Mode FlatFace
references: face or plane action: legacy. Sketching on a flat face.

Mode TangentPlane
references: face+vertex or vertex+face action: sketching plane is tangent to surface of face at the point on the surface that is closest to the vertex. If vertex is linked in first, the plane is translated to go through the vertex. If face is first, the plane touches the surface. X axis of sketch is chosen to go along internal face's parametrization.

Mode NormalToEdge
references: edge or edge+vertex or vertex+edge action: sketching plane is normal to the edge 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 virtex is first, or kept at where the curve pierces the sketch plane if edge is first. X axis of sketch is chosen automatically.

Mode FrenetNB
references: curved edge OR curved edge+vertex OR vertex+curved edge action: sketching plane is 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 origin of sketch is translated to the vertex if the vertex is first, or kept at the curve if edge is first. This mode is similar to NormalToEdge, except that X axis is well-defined.

Mode TrenetTN
references: curved edge OR curved edge+vertex OR vertex+curved edge action: sketching plane is 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.

Mode FrenetTB
references: curved edge OR curved edge+vertex OR vertex+curved edge action: sketching plane is 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.

Mode Concentric
references: curved edge OR curved edge+vertex OR vertex+curved edge action: same as FrenetTN, but sketch origin is placed at the center of curvature of the edge.

Mode SectionOfRevolution
references: curved edge OR curved edge+vertex OR vertex+curved edge action: same as FrenetNB, but sketch origin is placed at the center of curvature of the edge, and Y axis is the axis of osculating circle. Useful to make grooves on bodies of revolution.

Mode ThreePointsPlane
references: vertex+vertex+vertex or line+vertex or vertex+line or line+line action: sketching plane goes through three vertices defined by references. Line is treated as if it is two vertices.

Mode ThreePointsNormal
references: vertex+vertex+vertex or line+vertex or vertex+line or line+line action: sketching plane contains first two vertices, and is normal to the plane defined by three vertices.

Mode Folding
references: line+line+line+line action: specialty mode to fold polyhedra. See picture. It is required that all four lines share an endpoint. It is not required that both leafs to fold together are the same, like on the picture.