Scene Composition & Spatial Tools

Published Updated
Organize the 3D scene tree, edit object properties and materials, place spatial annotations and sockets, and author parametric shapes.

Authoring and Inspecting the 3D Scene Graph

The Scene Composition tools in Aircada Studio control how 3D meshes, parametric shapes, materials, and spatial attachment points behave in the viewport. Manage parent-child grouping and visibility in Hierarchy Panel, Scene Tree Grouping & Visibility, tune transforms and PBR materials in Property Inspector, Material Controls & Search Filtering, place 3D callouts and environment lighting with Snapping Grid, Measurement Units & Color Picker, wire modular assembly snap points in 3D Spatial Sockets & Visual Wire Connections, and generate procedural primitives in 3D Primitive Shapes.

Hierarchy Panel, Scene Tree Grouping & Visibility | Aircada Docs#

Organize 3D assemblies in the Hierarchy Panel with drag-and-drop grouping, search, and visibility controls.

Searching & Filtering Large Assemblies

The Hierarchy Panel displays every 3D model, sub-mesh, light, and camera in a virtualized scene tree built to stay fast even on 500-part CAD assemblies. You can filter the tree by part name using the search bar and drag matching items directly into new parent groups while the filter is still active.

Drag-and-Drop Reparenting

Drag any part onto another node to group them into a parent-child hierarchy. Reparenting preserves the part's world-space position, rotation, and scale so parts never jump in the 3D viewport when grouped, and built-in cycle checks prevent dragging a parent assembly into one of its own children. Dragging an item outside any group moves it back to the scene root.

Visibility States & Custom Layers

Each row in the tree includes visibility and isolation toggles alongside custom organizational layers. Hiding a parent group hides all of its descendants in the viewport while preserving each child part's individual visibility setting when the parent group is turned back on.

Hierarchy Panel Controls & States
Control / StateActionBehavior
Search BarType part nameFilters the tree while keeping drag-and-drop reparenting active.
Drag onto NodeReparent partMoves part under the target group while keeping world position intact.
Drag to Empty SpaceMove to rootDetaches the selected part from its parent group back to root level.
Eye Icon (Visible / Hidden)Toggle visibilityHides or shows a part and cascades visibility down to child parts.
Isolate ToggleSolo selectionTemporarily hides all other scene parts so you can inspect internal geometry.

Property Inspector & Material Controls | Aircada Docs#

Edit 3D transforms, PBR material channels, and operator parameters in the right-hand Property Inspector.

Context-Aware Property Sections

Selecting any 3D mesh, light, camera, or operator populates the right-hand Property Inspector with controls matching that item's schema. Numeric ranges, colors, 3D vectors, booleans, and option lists render as sliders, color pickers, X/Y/Z coordinate inputs, toggles, and dropdown menus.

Compact Row Bundles & Advanced Popovers

Related values such as minimum/maximum limits or 3-axis coordinates are grouped into single-row inputs to keep the sidebar compact. Advanced sub-settings (such as texture tiling offsets, normal map strength, or shadow bias) open inside nested popovers when enabled.

Universal 3D Scene Unit Controls

Every 3D scene unit in Studio (whether an imported GLB model, an isolated submesh, a 3D text object, or a primitive shape) shares a core set of spatial and physical controls in the inspector: Transform (world/local X, Y, Z position, Euler rotation, and scale), Pivot & Bounding Box (non-destructive origin offsets for hinge rotation and camera framing), Shadows (per-object cast and receive shadow toggles), Colliders & Raycasting (click/tap raycast targets and box/capsule physics bounds), and Materials (PBR surface channels and shared material linking; see 3D Materials & Facades (MaterialFacade) for the full material property reference).

Filtering Properties by Name

Use the search input at the top of the Property Inspector to filter long material or operator panels by keyword, jumping straight to specific roughness, IOR, or boundary settings without scrolling through collapsed sections.

Inspector Control Types
Control TypeUsed ForInteraction
Numeric Slider & InputRoughness, metalness, IOR, opacityDrag slider or type exact decimal values.
Vector3 Row (X / Y / Z)Position, rotation, scale, pivot offset, boundsScrub or enter coordinates in the active display unit.
Color & Texture SlotAlbedo, emissive, normal, ORM mapsPick hex/alpha colors or assign project textures.
Scene Unit TogglesCast/receive shadows, raycast hitboxes, collidersEnable or disable per-unit rendering and interaction flags.
Inspector SearchQuick property lookupFilters visible sections and fields by label in real time.

Snapping Grid, Measurement Units & Color Picker | Aircada Docs#

Align 3D parts with magnetic grid snapping, switch metric/imperial units, and pick PBR colors.

Magnetic Grid & Bounding-Box Snapping

Enable the placement grid in the viewport to snap parts to floor increments or align edges against neighboring 3D objects. Snapping uses Oriented Bounding Boxes (OBB) so even rotated parts align flush against angled surfaces without gaps. Hold Shift while dragging a gizmo to temporarily bypass magnetic snapping for fine manual adjustments.

Switching Metric & Imperial Display Units

Use the Unit Selector (mm, cm, m, in, ft) to view and enter dimensions in your shop's preferred measurement system. Studio converts input values automatically (rounding imperial display values to 2–3 decimal places) while storing scene coordinates in meters internally so physics and AR scale stay consistent.

PBR Spectrum Color Picker & Eyedropper

The Studio color picker supports 6-digit hex and 8-digit hex-with-alpha strings, gamma-correct PBR previews, and a screen eyedropper tool on Chromium browsers (hidden automatically on browsers that do not support the native EyeDropper API).

Spatial Authoring Tools
ToolShortcut / ControlBehavior
Placement Snapping GridViewport grid toggleSnaps objects to grid increments and rotated OBB part bounds.
Bypass SnapHold Shift while draggingSuspends magnetic snapping for smooth micro-positioning.
Unit Selectormm / cm / m / in / ft dropdownConverts inspector dimension fields while keeping internal scale in meters.
Color PickerClick any color property swatchEdits hex/alpha colors with Chromium screen eyedropper support.

3D Spatial Sockets & Visual Wire Connections | Aircada Docs#

Attach 3D sockets to modular parts and wire compatible ports together in the viewport.

Placing & Wiring 3D Sockets

Spatial sockets let you define physical attachment points and data ports directly on 3D parts for modular assemblies. Drag a curved wire between two sockets in the viewport to link compatible ports together; Studio checks port data types on drop and blocks self-connections or invalid circular loops.

Viewport Wire Projection & Camera Clipping

As you orbit the camera around a wired assembly, Studio projects 3D socket positions onto the 2D screen overlay and hides or clamps wires when a socket moves behind the camera plane so cables never flip or stretch across the viewport.

Spatial Socket Controls
FeatureHow It WorksGuardrail
3D Socket AnchorAttaches an input or output port to a 3D partMoves with the part's world transform in real time.
Bezier Wire DragDrag from an output socket to a target input socketSnaps within configurable pixel distance when types match.
Type & Cycle ValidationChecks port compatibility before connectingBlocks self-connections and circular data loops.
Camera Clipping GuardHides wires behind the active camera planePrevents inverted 2D wire projections during close-up orbits.

3D Primitive Shapes & Procedural Geometry | Aircada Studio#

Spawn built-in 3D geometry primitives (boxes, spheres, cylinders, planes, toruses) and adjust their procedural dimensions and segment resolution.

Spawning Built-In 3D Primitives

In addition to imported CAD and GLB models, Aircada Studio includes ten procedural 3D geometry primitives modeled after standard Three.js geometries. Open the ELEMENTS Panel and select a primitive to spawn it at the world origin for proxy geometry, floor planes, custom panels, or reference bounds. Once added to the scene, primitive shapes behave like any other 3D scene unit and share the same transform, material, shadow, pivot, and collider controls in Property Inspector, Material Controls & Search Filtering.

Tuning Procedural Geometry Parameters

Unlike static imported meshes, primitive shapes expose parametric geometry inputs in the GEO Panel. Adjusting radii, cap thickness, inner/outer ring dimensions, or radial and height segment counts rebuilds the WebGL geometry buffer in real time so you can balance smooth curvature against triangle count.

Available 3D Geometry Primitives
PrimitiveProcedural ParametersCommon Use Cases
Box / CubeWidth, height, depth, and width/height/depth segmentsStructural panels, shelving, pedestals, and bounding volumes.
SphereRadius, width/height segments, phi/theta start and lengthDomes, ball joints, lighting probes, and curved accents.
Cylinder & ConeTop/bottom radius, height, radial/height segments, open-ended toggleTubes, legs, rods, poles, and tapered hardware.
Torus & CapsuleRadius, tube thickness, radial/tubular segments, cap segmentsRings, handles, gaskets, and rounded pill geometries.
Plane, Circle & RingWidth/height or inner/outer radius and segment divisionsFloor shadow catchers, decals, wall backdrops, and flat UI surfaces.
IcosahedronRadius and subdivision detail levelFaceted low-poly meshes and geodesic structures.