Importing Models & Media Assets

Published Updated
Import 3D models, configure CAD upload optimization, split fused meshes into configurable parts, and manage hosted textures and images.

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#

Configure mesh splitting, material deduplication, and Draco compression when uploading 3D models.

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.

3D Upload Dialog Options
OptionDefaultWhen to Use
Smart Merge by MaterialDefault (auto > 150 parts)Best balance of customizable material zones and fast mobile draw calls.
All MeshesOptionalUse when individual parts sharing the same material must move or hide separately.
Single MeshOptionalUse for static props or single-piece products that do not need part-level rules.
Color Tolerance0.22Merges redundant CAD materials whose base colors are nearly identical.
Draco CompressionEnabled (Level 10)Compresses vertex and index buffers for fast browser loading.

Splitting 3D Meshes & Viewport Toolkit | Aircada Docs#

Separate fused 3D models into customizable sub-parts and switch transform gizmos in the viewport.

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.

Split Mesh & Viewport Toolkit Actions
ActionWhere to FindWhat It Does
Split AllSplit Mesh toolbarSeparates all disconnected geometry islands into individual parts.
Split CutSplit Mesh toolbarExtracts selected sub-meshes into a new part and removes them from the original.
Split CopySplit Mesh toolbarDuplicates selected sub-meshes as a new part while keeping the original intact.
Move / Rotate / ScaleFloating viewport toolbarSwitches the 3D transform gizmo mode on the selected object.
Clear SelectionFloating viewport toolbarDeselects all currently highlighted parts in the viewport.

3D Model Importing & File Formats in Studio#

Best practices, supported file formats, and structural pipelines for 3D model optimization.

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 central hub for managing media, 3D models, and other project files.

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#

Learn how Aircada hosts uploaded media assets privately and secures them before project publication.

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#

Instructions for importing and managing 2D assets like textures and UI sprites.

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.