Libraries and Assets

Mapping Matter splits content into per-project libraries (private to your project) and a platform demo library (read-only, available to everyone). Meshes, textures, projectors and layouts all share the same browser overlay pattern, with grid/list display and search.

Scenes are managed from the Disguise Cloud launcher, not from inside Mapping Matter — see Open or create a scene.

3D asset library

The 3D asset library holds imported meshes. Click Import in the toolbar add cluster to open the library overlay.

Supported formats: .fbx (binary), .obj, .dae, .stl, .gltf/.glb. Maximum saved size is 100 MB; larger files can still be loaded locally for the current session.

Import Settings

When you pick a file the Import Settings overlay opens. Set the file unit, the scale, and the rotation before confirming. The Bounds block shows two rows so you can sanity-check both the scene scaling and the picker:

• Bounds — the mesh extent expressed in the scene’s current dimension unit. Switch the scene’s dimension unit and this row’s magnitude rescales.
• In Source — the raw bounding-box value in the unit you picked under Original File Units. Switch the picker and this row’s unit label changes but the numbers stay the same.

A Scale Reference dropdown drops a translucent fixed-size helper next to the mesh while the overlay is open so you can eyeball its size before committing:

• Yellow Human — a 1.8 m figure (default).
• 1 m³ Cube — a one-metre wireframe cube.
• None — no helper.

The helper renders at 50% opacity (so scene geometry remains visible through it) and sits a sensible distance from the import — small mm-scale imports get a 500 mm gap so the figure isn’t on top of the origin, larger imports scale proportionally. The helper disappears on confirm or cancel.

Optimisation tips

For best performance:

• Reduce unused geometry — delete loose vertices and hidden meshes.
• Merge meshes by material where possible.
• Export as .fbx binary or .glb (compact, fast to load).
• Avoid embedded textures over 4096 × 4096; assign textures separately from the texture library.

Texture library

Textures cover stills (.jpg, .png, .webp, .gif, .bmp) and short clips (.mp4, .webm, .ogg). Maximum size 50 MB.

Textures are assigned to projectors (as the projector image) or to meshes (as base map or projection map) via the Properties panel.

Projector library

The projector library lives in the same overlay pattern. Catalogue models are read-only; your project can also contain custom projectors that appear alongside catalogue entries.

Each card has a small flag icon — click it to report wrong specifications (incorrect throw ratio, missing lens, wrong lumens). The pre-filled dialog routes to the Disguise team via the same pipeline as the toolbar Feedback button.

LED library

The LED library opens from the toolbar LED button. It uses the same overlay pattern as projectors — filter by brand, sort by name or pixel pitch, switch between catalogue tiles and your project’s own entries. If a tile model isn’t in the catalogue, use + Create custom to add it to the project.

Truss library

The truss library opens from the toolbar Mounting popover’s Truss library… entry, and covers both truss profiles and mounting bases. Filter by cross-section or by the TRUSS / BASE toggle, then double-click an entry to add it to the scene. Custom trusses and bases are project-scoped and appear alongside the catalogue.

AId3n in the libraries

The Mapping Matter libraries are wired into AId3n, the Disguise AI assistant, so you can ask it to research a piece of kit and produce a custom entry rather than typing every field by hand.

• Each library overlay has an Ask AId3n to research call-to-action and a persistent Research button in the projector and LED library toolbars.

• Give AId3n a model name or paste a datasheet; it’ll suggest spec values, propose a mesh, and surface them as an “AId3n suggests” banner you can accept, tweak, or discard.
• For meshes, a phase indicator shows progress (research → mesh search → preview).
• AId3n suggestions never overwrite catalogue entries — they create or update custom entries in your project, so the platform-wide catalogue stays trustworthy.

AId3n usage is metered against your organisation’s credits — see your Disguise Cloud dashboard for the running total.

Layouts

A layout is a reusable PDF template — title block, table of projector specs, page size, and viewport pose. Save the current PDF layout from the toolbar Export dropdown to add it to the layout library, then reuse it on other scenes.

See Export & PDF layouts.