Open, save and export
Open a file
Section titled “Open a file”Choose File → Open… (Ctrl+O) to open a Modlumi project (.modl) or a
SketchUp file (.skp). When it finishes loading, Modlumi shows the view saved
with the project, or the first scene of a SketchUp file. Without one, it frames
the whole model in the clear canvas, as
Zoom Extents does.
You can also drag one .skp or .modl file onto the workspace in the desktop
or browser app. Dropping opens the file as a document; if your current model
has unsaved changes, Modlumi asks whether to save them first. Browser limits
are 10 MiB for .skp and 128 MiB for .modl files.
On the desktop, you can also open a file at startup:
modlumi path/to/model.skpSketchUp files
Section titled “SketchUp files”Modlumi reads SketchUp files with their geometry, groups, components, materials, scenes and tags, which become layers with the same names, colors and visibility. Scenes keep their names and camera views; their other settings, such as the tags they hide, aren’t imported.
To add a SketchUp model to the model you already have open, choose File → Import…. The imported model follows the pointer like a paste; click to place it.
When you save a model that came from a SketchUp file, Modlumi asks where to
save it as a .modl project. Your original .skp file is never changed.
Modlumi opens SketchUp files but doesn’t save or export them, and there are no plans to add this. To share a model with someone who uses SketchUp, export it in a format SketchUp imports, such as STL.
Other 3D formats
Section titled “Other 3D formats”File → Import… also reads models from other 3D tools, or drop one on the window:
| Format | Extensions | Units and up axis |
|---|---|---|
| STL | .stl |
You choose; millimeters and Z up by default |
| OBJ | .obj |
You choose; meters and Y up by default |
| PLY | .ply |
You choose; meters and Z up by default |
| 3DS | .3ds |
You choose the units; inches by default |
| glTF | .gltf, .glb |
From the file |
| FBX | .fbx |
From the file |
| COLLADA | .dae |
From the file |
STL, OBJ, PLY and 3DS files don’t say which units they use, so Modlumi asks before importing them. It remembers your choices for each format until you close Modlumi. Merge coplanar faces joins the triangles of flat surfaces into single faces, which helps with STL files from CAD tools. Soften edges under hides the edges between faces that meet at less than the angle you choose, 25° unless you change it, so curved surfaces look smooth instead of showing every triangle. Real corners keep their edges. It applies to STL files, and to OBJ and PLY files that don’t say how their faces are shaded; set it to 0° to keep every edge. Faces smaller than about a micrometer across are left out, and Modlumi says how many; if a model arrives with holes, import it again in a larger unit.
Modlumi doesn’t read FBX files older than FBX 2011, or glTF files compressed with Draco or meshopt.
The imported model arrives as one component named after the file. Inside it, each object in the file becomes a group with the object’s name, and objects the file repeats become components. Materials keep their names and colors, and glTF materials their metallic and roughness values; textures and maps aren’t imported yet. Edges between faces the file shades smoothly are softened, so curved surfaces look smooth.
Plugins can add more formats; see Writing a plugin. The browser preview imports SketchUp files only.
Choose File → Save (Ctrl+S) to save your project, or File → Save
As… (Ctrl+Shift+S) to save a copy under another name. Projects use the
.modl format. Saving also stores the current view.
An asterisk (*) in the title bar means you have unsaved changes. If you open
another file or close Modlumi with unsaved changes, it asks whether to save
them.
In the browser preview, Save downloads the project instead.
Recover unsaved changes
Section titled “Recover unsaved changes”While you have unsaved changes, the desktop app keeps a copy of them every two minutes. If Modlumi closes unexpectedly, for example because it crashed or the computer lost power, it offers that copy the next time it starts:
- Restore opens the model with your changes. Save it to keep them. A restored model starts without undo history.
- Discard deletes the copy.
- Keep for Later closes the dialog and offers the copy again next time.
The copy is deleted when you save, when you discard your changes, and when you close Modlumi normally. To stop keeping copies, turn off File → Save Recovery Files.
Copy and paste
Section titled “Copy and paste”Use Edit → Cut, Copy, Paste and Paste in Place:
| Command | Shortcut |
|---|---|
| Cut | Ctrl+X |
| Copy | Ctrl+C |
| Paste | Ctrl+V |
| Paste in Place | Ctrl+Shift+V |
Paste attaches a preview to the pointer; click to place it, or press Escape to cancel. Paste in Place puts it back at exactly the same position, even inside a different group or component.
The clipboard keeps its contents when you open another file, so you can copy geometry from one model to another. It doesn’t copy geometry to other programs.
Save an image
Section titled “Save an image”Choose File → Save to Image… to save the 3D view as a PNG or JPEG image.
The dialog asks for the image size, which starts at the size of the 3D view
that the panels leave uncovered: pick a preset such as Full HD or 4K, or type a
width and height. Keep aspect ratio adjusts the other side as you type one,
so the picture frames the same view as you see. The image shows only the model: no selection highlight, tool
previews or editing marks. Tick Include guides to keep guide lines and
points, and Transparent background to leave the sky or studio out, for
placing the model on a page or in another image. Choose JPEG under
Format for a smaller file, such as one to email or post; its Quality
slider trades file size for detail, and a JPEG always has a background. The
desktop app then asks where to save the file, and a name ending in .png,
.jpg or .jpeg decides the format; the browser downloads it.
You can also save images from the command line, which is useful for scripts and automation:
modlumi model.skp --snapshot-viewport view.png--snapshot-viewport saves just the 3D view; --snapshot-ui saves the whole
window. Modlumi closes after saving the images.
Export an animation
Section titled “Export an animation”Choose File → Export Animation… to save the model’s scenes as a looping GIF, for a presentation, a web page or a message. It needs at least two scenes. The animation starts at the first scene and plays through the others and back, with the glide and pause times set in Window → Model Settings. The dialog asks for the width, the height following the window’s shape, and the frames per second. Fewer, smaller frames make a smaller file. The desktop app asks where to save the file; the browser downloads it.
Recording takes a moment while Modlumi draws each frame. Orbiting, panning or zooming while it records stops the export.
Export to glTF
Section titled “Export to glTF”Choose File → Export glTF… to export the model as a glTF 2.0 file, which Blender, Unreal, Unity, Godot, three.js and most other 3D tools open.
The dialog offers two kinds of file:
- glTF binary (
.glb), the default: one compact file. - glTF embedded (
.gltf): one JSON text file, about a third larger.
The export keeps:
- Groups and components, as objects named after them. Copies of one component share their mesh, so the file stays small.
- Materials, with their colors, transparency, textures and surfaces: metallic and roughness, their maps, normal maps, and opacity maps in the base color’s alpha, since glTF has no opacity map of its own. Faces without a material take their group’s or component’s material, as they do in Modlumi; unpainted faces export white. Materials are double-sided, so faces facing the wrong way still show.
- Smooth edges, as smooth shading.
- Real size: glTF files are in meters with Y up, and Blender turns them back to Z up.
Edges, guides and hidden geometry are left out. In the
browser preview, the export
downloads a .glb file.
Open your model in Blender
Section titled “Open your model in Blender”To render your model, animate it or keep modeling it in Blender:
- In Modlumi, choose File → Export glTF…, keep glTF binary and save
the
.glbfile. - In Blender, choose File → Import → glTF 2.0 (.glb/.gltf) and open that file.
- To see the colors and textures, switch the 3D viewport to Material Preview with the shading buttons at its top right, or press Z and choose it.
The model arrives at its real size and in the same place as in Modlumi. Each group and component is an object in Blender’s Outliner, named as it was in Modlumi and nested the same way, so you can select, hide or move each part. Copies of a component are linked duplicates in Blender, so editing one mesh changes all of them. Each material arrives as a Principled BSDF material you can adjust in Blender’s Shading workspace.