Scene Composition & Spatial Tools
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#
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.
| Control / State | Action | Behavior |
|---|---|---|
| Search Bar | Type part name | Filters the tree while keeping drag-and-drop reparenting active. |
| Drag onto Node | Reparent part | Moves part under the target group while keeping world position intact. |
| Drag to Empty Space | Move to root | Detaches the selected part from its parent group back to root level. |
| Eye Icon (Visible / Hidden) | Toggle visibility | Hides or shows a part and cascades visibility down to child parts. |
| Isolate Toggle | Solo selection | Temporarily hides all other scene parts so you can inspect internal geometry. |
Property Inspector & Material Controls | Aircada Docs#
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.
| Control Type | Used For | Interaction |
|---|---|---|
| Numeric Slider & Input | Roughness, metalness, IOR, opacity | Drag slider or type exact decimal values. |
| Vector3 Row (X / Y / Z) | Position, rotation, scale, pivot offset, bounds | Scrub or enter coordinates in the active display unit. |
| Color & Texture Slot | Albedo, emissive, normal, ORM maps | Pick hex/alpha colors or assign project textures. |
| Scene Unit Toggles | Cast/receive shadows, raycast hitboxes, colliders | Enable or disable per-unit rendering and interaction flags. |
| Inspector Search | Quick property lookup | Filters visible sections and fields by label in real time. |
Snapping Grid, Measurement Units & Color Picker | Aircada Docs#
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).
| Tool | Shortcut / Control | Behavior |
|---|---|---|
| Placement Snapping Grid | Viewport grid toggle | Snaps objects to grid increments and rotated OBB part bounds. |
| Bypass Snap | Hold Shift while dragging | Suspends magnetic snapping for smooth micro-positioning. |
| Unit Selector | mm / cm / m / in / ft dropdown | Converts inspector dimension fields while keeping internal scale in meters. |
| Color Picker | Click any color property swatch | Edits hex/alpha colors with Chromium screen eyedropper support. |
3D Spatial Sockets & Visual Wire Connections | Aircada Docs#
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.
| Feature | How It Works | Guardrail |
|---|---|---|
| 3D Socket Anchor | Attaches an input or output port to a 3D part | Moves with the part's world transform in real time. |
| Bezier Wire Drag | Drag from an output socket to a target input socket | Snaps within configurable pixel distance when types match. |
| Type & Cycle Validation | Checks port compatibility before connecting | Blocks self-connections and circular data loops. |
| Camera Clipping Guard | Hides wires behind the active camera plane | Prevents inverted 2D wire projections during close-up orbits. |
3D Primitive Shapes & Procedural Geometry | Aircada Studio#
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.
| Primitive | Procedural Parameters | Common Use Cases |
|---|---|---|
| Box / Cube | Width, height, depth, and width/height/depth segments | Structural panels, shelving, pedestals, and bounding volumes. |
| Sphere | Radius, width/height segments, phi/theta start and length | Domes, ball joints, lighting probes, and curved accents. |
| Cylinder & Cone | Top/bottom radius, height, radial/height segments, open-ended toggle | Tubes, legs, rods, poles, and tapered hardware. |
| Torus & Capsule | Radius, tube thickness, radial/tubular segments, cap segments | Rings, handles, gaskets, and rounded pill geometries. |
| Plane, Circle & Ring | Width/height or inner/outer radius and segment divisions | Floor shadow catchers, decals, wall backdrops, and flat UI surfaces. |
| Icosahedron | Radius and subdivision detail level | Faceted low-poly meshes and geodesic structures. |