Universe

maquette-gltf logo

Typst Universe Live demo License: MIT

maquette-gltf is a Typst plugin that renders glTF 2.0 assets (.gltf / .glb) as raster images directly inside your documents — no screenshots, no external tools.

It reads the model, applies physically based (PBR) shading with optional image-based lighting, shadows, SSAO and tone mapping, and drops the result into your PDF at compile time. It is a companion to maquette (STL / OBJ / PLY) and maquette-scad (OpenSCAD), and shares the same rendering core.

Everything runs as a single WASM plugin.

Try it live in your browser → drag to orbit, tweak every setting, and copy the generated Typst code.

See the documentation for examples of every feature.

Example

#import "@preview/maquette-gltf:0.1.0": render-gltf

// A self-contained .glb: pass its bytes directly.
#render-gltf(read("assets/helmet.glb", encoding: none),
  azimuth: 30,
  elevation: 15,
  ibl: (intensity: 1.2),
  tone-mapping: "aces",
  ssao: true)

For a split .gltf (with external .bin / textures), give the path plus a read: lambda and the wrapper discovers and reads the sidecars for you:

#render-gltf("assets/scene.gltf", read: p => read(p, encoding: none), azimuth: 40)

Functions

render-gltf

#render-gltf(model, read: none, ..config, width: auto, height: auto)

Renders a glTF/GLB asset to a raster image. model is either the bytes of a self-contained .glb (read("m.glb", encoding: none)) or a path to a .gltf, in which case you must also pass read: p => read(p, encoding: none) so the wrapper can read the external .bin and image sidecars. Configuration is passed as named arguments or a positional dictionary. Recognised keys include camera, azimuth, elevation, zoom, light_dir, ibl, shadows, ground, ssao, antialias, tone_mapping, background, material_variant, and animation_index / time for animated models. Named width / height set the image’s size on the page; inside the dictionary they set its resolution in pixels.

get-gltf-info

#let info = get-gltf-info(model, read: none)

Returns scene metadata (triangle count, bounding box, center, radius, max_animation_time) as a dictionary — handy for computing camera framing or driving an animation slider.

Output

Raster PNG only: glTF’s PBR materials and textures are sampled per pixel. Set width / height in the configuration dictionary for resolution and antialias for antialiasing, with the same levels as maquette: 0 off, 1 FXAA, 2/3 2×/4× supersampling, 4 (default) and 5 FXAA on top of 2×/4× supersampling.