Virtual-link attachments

Definition#

A Virtual-link attachment is a printable attachment instance hosted by a Virtual link. Use one when a part needs a stable frame-relative position and orientation but does not belong to a real tube, rod, or profile.

Typical examples include feet placed from floor datums, free-standing brackets, instrument mounts, reference-driven fittings, and other local geometry whose parent should be an axis rather than stock material.

Like a Physical-link attachment, it instantiates a reusable type from the frame's Attachments catalogue. The difference is the parent context and the implicit inputs available to that type.

Parent link and anchor node#

Every Virtual-link attachment belongs to one Virtual link and is anchored from a node on that link. Its offset moves the attachment centre along its current direction from that anchor.

The placement relationship is:

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

A dedicated helper link is often the cleanest parent when it encodes real design intent—for example, a short floor-to-corner link that defines both contact direction and attachment orientation.

Direction, rotation, and offset#

The parent Virtual link supplies an initial direction and normal. The attachment then owns its instance orientation:

Flip direction reverses its axial direction.
Rotate attachment changes its roll around that direction.
Offset moves its centre along the direction from the anchor node.

The frame default can orient a newly created attachment toward the nearest terminal or preserve the link's authored direction. Choose the mode that expresses the design rather than repairing an accidental orientation afterward.

Dimensions and implicit inputs#

A Virtual-link attachment has an absolute Length and Offset, both expressed in millimetres or Frame reactive-property expressions.

Unlike a Physical-link attachment, it has no parent-link radius or wall thickness and no relative-to-radius dimension mode. Its reusable type receives:

attachment length;
available Virtual-link distance in each axial direction;
its own explicit implementation parameters.

Other dimensions—foot radius, bracket width, fastener size, and similar type-specific values—belong to the selected attachment definition's parameters.

Choose a Physical-link attachment instead when geometry must adapt automatically to a real member's section.

End pinning#

Virtual-link attachments use the same Pinned to end position guard as Physical-link attachments.

With pinning off, offset remains the authored expression.
With pinning on, the editor derives the offset that keeps the attachment flush with the nearest terminal end.

Pinning is valid only from a terminal anchor. The offset control is disabled while the derived guard owns it, and a length change updates the derived offset.

For a 10 mm-long foot placed on a 20 mm floor-to-centreline guide, terminal pinning derives a 5 mm centre offset. The foot then spans from the floor to 10 mm above it without storing 5 mm as unexplained manual positioning.

Implementation type and parameters#

The Type field chooses a compatible Virtual attachment definition imported into the frame. The definition owns its CSG recipe, parameter schema, body parts, connection ports, and clearances.

The Frame Editor instance stores the selected type and explicit parameter values. It also stores materials and placement. Author or modify the reusable geometry in the Attachment Editor; use the Frame Editor to configure it in the context of a structure.

A Physical-context type cannot be substituted directly because it expects different implicit parent inputs.

Body parts, materials, and connections#

A Virtual-link attachment can resolve to one or several named body parts. Each body part can carry material and manufactured geometry. Separate connection ports identify the selectable regions used by connections and link each region to its owning body part.

Virtual attachment ports can participate in the same Attachment Connection as Physical attachment ports. This is how a floor foot, for example, can become part of the same printable corner joint as two tube sleeves.

Clearances authored by the Virtual attachment type propagate through its connected printable component just like clearances from a Physical attachment.

Propagation#

A Virtual-link attachment follows:

movement of its anchor node and parent Virtual link;
changes to its own length and offset expressions;
end pinning;
direction and rotation edits;
implementation type and parameters;
body-part materials;
connected Attachment Connections and shared clearances.

Changing a Physical link's radius or wall thickness does not provide new implicit inputs to a Virtual-link attachment, even when the two happen to occupy nearby space.

Creating and editing Virtual-link attachments#

Import the required Virtual attachment type into the frame's Attachments catalogue, select its parent Virtual link, and choose Add attachment. Select an eligible anchor node on the link, then inspect the instance orientation and dimensions.

The main editing actions are:

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

Virtual-attachment defaults seed new instances. They do not modify existing attachments.

Common mistakes#

Using a Virtual attachment when the part should adapt to tube radius or wall thickness. Use a Physical attachment for member-aware geometry.
Creating a helper link without design meaning. Its endpoints and orientation should encode the relationship the attachment actually needs.
Treating offset as relative to link length or radius. Virtual attachment length and offset are absolute millimetre expressions.
Leaving nearest-terminal direction enabled when the authored link direction matters. Choose one direction policy deliberately, then inspect the result.
Hard-coding a terminal half-length offset. Use Pinned to end when flush placement should survive length changes.
Assuming Virtual means non-printable. The parent link is non-material; the attachment itself produces printable geometry.

See Virtual-link attachments in Getting Started for a compact placement example and video before returning here for the complete rules.

Read Virtual links for parent orientation, Physical-link attachments for member-aware geometry, or Attachment Connections for combining connection ports and their owning bodies into printable joints.