Importing Models & Media Assets
Model Ingestion, Mesh Splitting, and Asset Hosting
Aircada Studio converts raw CAD assemblies, polygonal 3D models, and 2D texture maps into web-ready configurator assets. Configure mesh compression and unit scaling during upload in 3D Model Upload Settings, Part Splitting & Material Cleanup, isolate or split ungrouped submeshes in Splitting 3D Meshes & Using the Viewport Toolkit, review supported 3D file formats in 3D Model Importing & Formats, and manage cloud-hosted textures in Image Assets.
3D Model Upload Settings & Material Cleanup | Aircada Docs#
Choosing a Mesh Split Mode on Upload
When you drag a 3D or CAD file into Studio, the upload dialog lets you choose how parts are structured: Smart Merge by Material groups parts that share the same material for fast mobile rendering, All Meshes keeps every sub-part separate, and Single combines the model into one mesh. If an assembly contains more than 150 parts, Studio automatically uses Smart Merge by Material to prevent mobile frame-rate drops.
Material Deduplication & Geometry Compression
CAD exports from SolidWorks, Rhino, or KeyShot often create dozens of duplicate material slots with nearly identical colors. The upload pipeline merges duplicate materials within a configurable color tolerance (0.22 default) and applies Draco geometry compression so large models download quickly on mobile networks.
Cloud Processing Progress
During upload, the status tracker displays live progress across each cloud conversion stage: geometry cleanup, automated UV preparation, KTX2 texture compression, and final placement into your active Studio workspace scene.
| Option | Default | When to Use |
|---|---|---|
| Smart Merge by Material | Default (auto > 150 parts) | Best balance of customizable material zones and fast mobile draw calls. |
| All Meshes | Optional | Use when individual parts sharing the same material must move or hide separately. |
| Single Mesh | Optional | Use for static props or single-piece products that do not need part-level rules. |
| Color Tolerance | 0.22 | Merges redundant CAD materials whose base colors are nearly identical. |
| Draco Compression | Enabled (Level 10) | Compresses vertex and index buffers for fast browser loading. |
Splitting 3D Meshes & Viewport Toolkit | Aircada Docs#
Separating a Fused 3D Model into Parts
When a 3D model is imported as a single combined mesh, enter Split Mesh mode from the viewport toolbar to break it into individually selectable parts. You can split all disconnected geometry islands at once or extract specific selected faces (copy or cut) so hardware, panels, or stitching zones can receive separate materials and option rules.
Working with High-Polygon & Internal Parts
Splitting dense CAD models with over 500,000 vertices runs in background workers with an on-screen progress indicator so the editor never freezes. To select internal parts hidden inside an outer housing, toggle wireframe mode or temporarily hide the outer shell in the Hierarchy Panel before clicking the interior geometry.
Floating Viewport Toolkit
The floating viewport toolbar lets you switch the active transform gizmo between Move (Translate), Rotate, and Scale, enter or exit Split Mesh mode, and clear multi-part selections with one click during scene setup.
| Action | Where to Find | What It Does |
|---|---|---|
| Split All | Split Mesh toolbar | Separates all disconnected geometry islands into individual parts. |
| Split Cut | Split Mesh toolbar | Extracts selected sub-meshes into a new part and removes them from the original. |
| Split Copy | Split Mesh toolbar | Duplicates selected sub-meshes as a new part while keeping the original intact. |
| Move / Rotate / Scale | Floating viewport toolbar | Switches the 3D transform gizmo mode on the selected object. |
| Clear Selection | Floating viewport toolbar | Deselects all currently highlighted parts in the viewport. |
3D Model Importing & File Formats in Studio#
To deliver smooth spatial configurator experiences, Aircada automatically optimizes high-fidelity 3D assets for the web GPU pipeline:
Supported 3D Formats
Aircada utilizes GLB/glTF as its native runtime format, offering an excellent balance of animation, material features, and compact file size. Other popular formats (like FBX and OBJ) are automatically converted into highly optimized GLB files during import.
Optimization Pipeline Tasks
Upon importing a model, the Studio applies the following standard optimization tasks to maintain mobile performance boundaries:
- Mesh Compression: Compresses dense geometry using Draco or Meshopt algorithms to decrease network payloads.
- Texture Downscaling: Dynamically resizes high-resolution textures to fit within standard mobile GPU memory budgets.
- Material Normalization: Standardizes non-web materials into physically-based rendering (PBR) assets compatible with the Aircada engine.
Studio Assets Panel Media & 3D Model Manager#
The Assets Panel provides a unified interface for uploading and managing your project's content.
You can organize your files into folders and perform bulk optimizations directly within the panel.
Studio Asset Hosting Security & Sandboxed Media#
Aircada provides secure, automatic hosting for all uploaded media assets. Once uploaded via the ASSETS Panel panel, assets are stored in a private development sandbox.
Uploaded media remains private and inaccessible to the public during the drafting phase. The assets are only deployed to public production endpoints when you publish the project.
For instructions on making projects public and managing deployments, refer to the Project Publishing & Deployment guide.
Image Asset Management & Texture Optimization#
Images imported into the Assets Panel can be used as textures, UI icons, or background elements.
Supported formats include PNG, JPEG, and SVG. We recommend using WebP for the best performance in the browser.
Return to the Assets Panel overview.