Frame Editor Reference

Physical-link attachments

Physical-link attachments turn a member-aware attachment type into a positioned printable instance that follows its parent stock member.

Definition#

A Physical-link attachment is a printable attachment instance hosted by one Physical link. Sleeves, clamps, sockets, end caps, tube-mounted brackets, and member-specific mounts belong in this category.

The attachment is not an imported static mesh. It combines:

  • a reusable attachment type from the frame's Attachments catalogue;
  • a parent Physical link and anchor node;
  • authored dimensions, orientation, implementation parameters, and materials;
  • implicit values resolved from the parent member.

The reusable type is authored in the separate Attachment Editor. This page describes how an instance behaves inside the Frame Editor.

Parent link and anchor node#

Every Physical-link attachment belongs to one Physical link and names one node on that link as its anchor. The anchor establishes the local start position; the attachment's offset then moves its centre along the member axis.

The complete placement relationship is:

``text parent Physical link + anchor node + direction + offset = attachment placement ``

The anchor may be a terminal node or another valid node on the link. End pinning is available only when the anchor is one of the Physical link's terminals.

Direction, rotation, and offset#

The attachment has a direction along the parent axis and a normal that records its rotation around that axis.

  • Flip direction reverses which way the attachment points along the link.
  • Rotate attachment changes its roll around that direction.
  • Offset moves its centre away from the anchor along the current direction.

These operations solve different problems. Flipping is not equivalent to rotating 180 degrees around the axis.

The creation default can orient a new attachment using the nearest terminal or preserve the parent link's direction. Once created, the instance keeps its authored orientation as its parent geometry changes.

Absolute and relative dimensions#

Length, thickness, and offset can each be authored in one of two modes:

  • Absolute: an expression resolved in millimetres.
  • Relative: an expression used as a multiplier of the parent Physical link's radius.

For example, a relative thickness of 0.2 on a 10 mm-radius tube resolves to 2 mm. Relative values are useful when one attachment type should scale with several member diameters; absolute values are useful when a manufacturing constraint must remain fixed in millimetres.

The attachment also receives the parent link's resolved radius, wall thickness, and available link length in both directions. Attachment geometry and clearances may use those implicit inputs even though they are read-only in the Frame Editor.

End pinning#

Pinned to end is a position guard for terminal attachments.

  • With pinning off, the authored offset remains authoritative.
  • With pinning on, the editor derives the offset that places the attachment flush with the nearest end of the Physical link.

The offset control is disabled while it is derived. Changing attachment length or parent-link length recomputes the pinned offset automatically. A Physical-link attachment longer than its parent member cannot be pinned to that member's end.

If the chosen anchor is not a terminal node, the editor leaves the attachment unpinned even when the default requests end pinning.

Implementation type and parameters#

The Type field chooses one compatible Physical attachment definition imported into the frame's Attachments catalogue. That definition owns the CSG recipe, parameter schema, body parts, connection ports, and clearances.

The selected instance stores explicit parameter values for that type. Changing a parameter regenerates the attachment with the same parent placement. Changing the type may change its available parameters, body parts, connection eligibility, and geometry.

Use the Attachment Editor when the required type does not exist. Frame Editor instances configure and place reusable types; they do not author primitives or boolean operations.

Body parts, materials, and clearances#

An attachment type may resolve to one or several named body parts. Body parts are the units used for material assignment, manufactured geometry, and printable-component grouping.

A simple attachment may expose one material for its whole body. Multi-part types can expose per-body-part material controls. Separate connection ports identify the selectable regions that may participate in Attachment Connections; each port names the body part that supplies its material and manufactured geometry.

Clearances are subtractive geometry authored by the attachment type. The Frame Editor carries them into the connected printable component so neighboring bodies leave room for the tube, fastener, insert, or other required interface.

Propagation#

A Physical-link attachment follows changes to:

  • its anchor node and parent member placement;
  • parent radius and wall thickness;
  • its own length, thickness, offset, orientation, type, and parameters;
  • end pinning;
  • connected body-part materials and Attachment Connections;
  • Frame reactive properties referenced by its expressions.

The editor updates the attachment, affected connection geometry, shared clearances, and material continuity in the same reversible transaction.

Creating and editing Physical-link attachments#

Import the required Physical attachment type into the frame's Attachments catalogue, then select a Physical link and choose Add attachment. Select the anchor node on that member and inspect the created instance.

The main editing actions are:

  • rename the attachment;
  • follow its node or parent-link references;
  • edit length, thickness, and offset modes and expressions;
  • toggle Pinned to end;
  • change type and implementation parameters;
  • choose whole-attachment or body-part materials;
  • flip direction or rotate around the member axis;
  • start an Attachment Connection from a connection port;
  • hide, show, or delete it.

Add missing attachments is a bulk convenience for filling eligible member locations from defaults. Use explicit placement when terminal choice, orientation, or teaching intent must remain visible.

Common mistakes#

  • Anchoring from a nearby logical node that is not on the parent member. The anchor must belong to that Physical link's reference span.
  • Assuming “relative” means a percentage of member length. Physical attachment length, thickness, and offset are relative to parent radius.
  • Editing a disabled offset. Turn off Pinned to end when manual offset ownership is intended.
  • Using rotation to reverse direction. Use Flip direction for the axial reversal, then rotate only for roll.
  • Expecting a type change to preserve incompatible port connections. A new type must still expose compatible port keys for existing connections.
  • Treating hidden geometry as deleted. Visibility changes only the scene presentation.

Watch the Triangle Frame narrated build add Tube Sleeves to reconciled member ends and carry them through a later geometry change.

Read Physical links for parent-member properties, Virtual-link attachments for the non-member alternative, or Attachment Connections for combining connection ports.