Documentation and slides: iconem.github.io/blender_ogc3dtiles · Releases
- Content: cesium-native brings for free all supported flavors of
3D Tiles
(1.0 /
1.1) and tile content:
- Tiled meshes: b3dm, glb, Draco, meshopt, KTX2
- Tiled point clouds:
pnts, glTF points - Tiled 3DGS splats:
KHR_gaussian_splatting, SPZ or uncompressed, as native Blender 5.3 splats - Sources: Google Photorealistic 3D Tiles, Cesium ion assets, a WGS84 globe
- Shared node groups: material shader, geometry, metadata (colour by class or number, class opacity) and compositor. One graph applies to every tile, whether already loaded or streamed later
- Rendering: EEVEE and Cycles, plus a "converged animation" render that waits for the tiles of each frame to finish loading before rendering it
- Raster overlays draped on tiles: URL template, TMS, WMTS, WMS, ion, Bing, Google, Azure, again feature-parity with all formats cesium maintains support for.
- Clipping: cut a tileset with Blender objects, either as clip-polygons or as 3D boxes, useful to combine overlapping tilesets like focus high-res drone scan into a coarser, larger extent, city-wide scan. It works on meshes, point clouds and splats, follows live as you move the objects, and can be keyframed for renders. Geometry-level clipping in cesium-native is requested in #1486.
- Several tilesets at once, placed around a scene origin usually auto-set at tileset centroid, or that you can set by searching for a place name; local and network-share tilesets, shared libraries of tilesets, and copying a tileset into the project, cropped to an area
- Libraries and local files: tileset libraries, the disk cache, copying a tileset into the project
cesium-native does the tile selection, loading and decoding through the cesium-native-python bindings + some niceties like raster overlays or clips. Tiles load and unload around the viewport camera, or around the render camera for animations. Different approach than the pure-Python CesiumForBlender (forum post) although I keep a python native fallback.
The add-on is a Blender extension, for Blender 4.2 or newer (Gaussian splats need 5.3).
- Download
ogc_3dtiles_streaming-<version>.zipfrom the Releases page. - In Blender: Preferences, Get Extensions, the drop-down arrow, Install from Disk.
- For the cesium-native backend (faster; raster overlays, point clouds, splats, voxels, Cesium ion, the globe and terrain need it): open the add-on preferences and press Install wheel from GitHub Release, then restart Blender. No compiler is needed. Without it, the pure Python backend streams mesh tilesets.
The documentation's Installation page has more: installing from a terminal, building the zip from a checkout, where the wheels come from.
- Open the sidebar of the 3D viewport (N), tab 3D Tiles.
- Add a tileset entry (+) and paste a
tileset.jsonURL: a Cesium ion asset, Google Photorealistic 3D Tiles, a local file, a share link. - For Cesium ion, paste your access token.
- Leave the origin mode on Auto: the first tileset centres the scene.
- Press Start and navigate: tiles load as the camera moves.
PYTHONPATH=src python -m pytest -q
ruff check --select E9,F src/blender_ogc3dtiles tests scripts
blender --command extension build --source-dir src/blender_ogc3dtiles --output-dir dist
Setup, tests and releasing, the architecture, the cesium-native wheel and versions, and the roadmap
are in the documentation, under Development. Its pages live in site/, the slide deck in
slides/; both are built and deployed by
.github/workflows/docs.yml.
MIT.