Skip to content
Scapiera
User Guide
User Guide

Structure Edit Workspace

The Structure Edit workspace opens a dedicated 3D editor for a selected parametric structure. You can click individual components (posts, beams, slats, panels) and non-destructively adjust their position, size, visibility, or material.

Structure Edit WorkspaceStructure Edit Workspace

The Structure Edit workspace opens a full-screen 3D editor focused on one placed parametric structure — pergola, fence, gazebo, deck, carport, and similar. You click individual components such as posts, beams, slats, and panels, then move, scale, rotate, hide, or duplicate them using interactive gizmos. Every change is stored as a non-destructive override on top of the generated geometry, so you can re-run the wizard later without losing your adjustments. The workspace has its own undo/redo stack of up to 50 steps, separate from the main editor history.

1

Selecting components

Click any visible component in the 3D viewport to select it. The selected component is highlighted. Hold Shift and click to add more components to the selection (multi-selection).

2

Moving and resizing

With a component selected, drag to move it. Use the transform handles to resize. The structure snaps to 3D grid points. Position changes are stored as offsets from the parametric default position.

3

Hiding components

Right-click a component or use the sidebar visibility toggle to hide individual components. Hidden components are still present parametrically but not rendered.

4

Saving and exiting

Click Apply to save the overrides and return to the main canvas. Click Cancel to discard any unsaved changes from this session.

5

Hide or duplicate a component

To hide a component, select it and press Delete (or use the Hide toggle in the right sidebar). Hidden components remain in the parametric object and can be revealed again at any time. To duplicate a selected component, press D — a copy is added as an added override and can be repositioned independently.

6

Override the material

With one or more components selected, click the Material swatch in the right sidebar to open the surface picker. The picker shows materials appropriate for the structure type — wood, composite, and metal options for timber-frame structures; masonry options for wall systems. The override applies only to the selected components and does not affect the base wizard settings.

7

Reset a component to its default

Select the component and click Reset in the sidebar to remove all overrides and restore it to the parametric default position, size, rotation, and material. This does not affect other components that have overrides.

8

Apply or cancel

Click Apply at the top of the workspace to save all pending overrides back to the parametric object and return to the main canvas. Click Cancel to discard every change made in this session and close the workspace with the structure unchanged.

INFO

Component overrides are stored non-destructively. Re-running the structure wizard through the Inspector updates the base geometry but keeps your per-component position, material, and visibility overrides intact — unless you click Reset on a specific component.

WARNING

Clicking Cancel discards ALL changes made since you opened the workspace — including moves, hides, material overrides, and duplicated components. There is no way to recover them after cancellation. Use the workspace's own undo (up to 50 steps) to step back before closing.

TIP

Use multi-select (Shift+click) to apply the same material override to all posts or all beams at once. This is much faster than assigning materials component by component when you want a consistent look across the structure.

Frequently Asked Questions

I don't see the Edit Components button. Why?

The button appears only for structures that have named components — pergola, fence, gazebo, deck, carport, pavilion, arbor, trellis, louvered pergola, covered patio, cabana, and similar. Plain surface fills such as a patio or walkway do not have individually selectable components, so the button is hidden for those object types.

Will re-running the wizard wipe out my component edits?

No. Overrides are stored per component key and survive wizard re-runs. The wizard regenerates the base geometry, but any component you have moved, scaled, rotated, hidden, duplicated, or re-materialed keeps those overrides. The only way to remove an override is to select the component and click Reset.

How do I undo a change made inside the workspace?

The Structure Edit workspace keeps its own undo and redo stack of up to 50 steps, separate from the main editor history. Use the standard undo shortcut (Ctrl/Cmd+Z) while the workspace is open. Once you close with Apply, the combined result appears as a single undo step in the main editor.

I moved a component to a new position, but it snapped somewhere unexpected. Why?

The workspace uses 3D snapping based on the current snap configuration. Components snap to other structure parts, the ground plane, and user-defined workplanes. If the snap is pulling the component to the wrong point, check the snap HUD at the bottom of the viewport and toggle off unwanted snap targets.

Can I add a completely new component that was not part of the original wizard output?

Yes. Press A or click Add in the toolbar to open the Component Library panel, then drag a part type into the viewport. The added component is stored as an added override alongside any moved or hidden components, and is preserved across wizard re-runs.