Import
Bring a GLB, an SVG, a picture, a LEGO model, a Paper layout or a portable Puni file into a scene, and what each one becomes.
A source file becomes an object like any other: it sits on the stage, takes a transform, and can carry motion. Puni keeps the bytes you gave it, so the picture and the saved scene always agree.
Open in Puni and choose a scene to add an object.
#From the library
Open the library’s + menu and pick a file. Puni opens a new scene with the source placed on the stage.
#From inside a scene
Press + in the objects rail and choose Import a source. The file lands as a new object, selected, ready to move.
#What each file becomes
| File | Becomes | Notes |
|---|---|---|
| GLB | A source object with its pieces addressable | Node transforms drive placement; materials are kept |
| MPD, LDR | A LEGO model with every part | Self-contained files only; parts referenced by name are not fetched |
| SVG | An outline with depth | Shapes with holes keep their openings |
| PNG, JPEG | A mark on a form, or a picture in an interface | Sizes come from the file's own header |
Paper .tsx | An interface object: a layout with text and layers | A bounded subset of Paper; the import lists what it could not keep |
.puni.json | A whole scene with its assets | The portable file the command line exports |
#Sculpt from a picture or a prompt
Puni can turn one picture, or a prompt, into a textured mesh and place it in a scene at its original size. It takes a minute or two, and a ready sculpt can be split into named parts. From the command line it is puni sculpt; agents call sculpt_object and get_sculpt.
With your own keys in Settings → Providers, generation spends no Puni credits; your provider bills its model calls. When Puni's keys are available, a sculpt from a supplied picture costs three credits. A prompt that also needs Puni to make the picture costs four. Borrowing only the picture step costs one.
The form shows the total before submission. Three welcome credits cover one picture-to-sculpt run. Settings → Credits shows your balance and activity, and offers packs when checkout is available. When a paid sculpt is recorded as failed, its credits are returned. Read Provider keys and Credits.
#Limits
| Limit | Value |
|---|---|
| One asset | 64 MiB |
| One scene document | 32 MiB |
| A portable file, decoded | 200 MiB |
A file that will not import says why in the dialog. The usual causes are a GLB with external buffers, a meshopt-compressed GLB (export it without mesh compression), a LEGO model that references parts it does not contain, or an SVG with a script in it.
#Assets travel with the scene
An imported file is stored once, by its checksum, and referenced by the scene. Sharing a link discloses the assets that link uses. Exporting a portable project embeds them, so the file stands on its own.
Read Portable projects for the file format, or Rendering for getting a picture back out.
Was this useful?