kirra-docs

3D Mesh Import (OBJ / PLY / GLTF / GLB)

Kirra imports 3D mesh files for surface visualisation, including textured models from aerial surveys, photogrammetry, and CAD exports.

Screenshot coming soon

Supported Formats

Format Extensions Features
Wavefront OBJ .obj Vertices, faces, UVs, normals, materials (via MTL file), texture images
PLY .ply ASCII and binary, vertices, faces, normals, per-vertex RGB colours
GLTF .gltf JSON-based GL Transmission Format with indexed geometry and scene hierarchy
GLB .glb Binary variant of GLTF (single file, no external references)

How to Import

  1. Click File > Import
  2. Select your mesh file (.obj, .ply, .gltf, or .glb)
  3. For OBJ files with textures, Kirra prompts for the MTL file and texture images
  4. The mesh appears in the TreeView and 3D view

OBJ with Textures

To import a textured OBJ mesh (e.g., from drone photogrammetry):

  1. Select the .obj file
  2. Kirra prompts for the .mtl material file
  3. Kirra prompts for texture images (JPG/PNG) referenced by the MTL
  4. The mesh loads with textures applied

What gets stored:

All data is saved to IndexedDB and the textured mesh is rebuilt when you reload the page.

PLY Files

PLY (Stanford Polygon Format) supports both ASCII and binary encoding. Kirra imports vertices, faces, normals, and per-vertex RGB colours. Common source: 3D scanners and photogrammetry software.

GLTF / GLB Files

GLTF (GL Transmission Format) is the Khronos standard for 3D asset exchange. Kirra imports both the JSON-based .gltf and the binary .glb variants.

Import features:

GLB is also used internally by Kirra to persist blast analysis results (Blair Heavy CPU model) to IndexedDB for safe reload.

Viewing Imported Meshes

After import, you can: