Skip to content

About

Stream OGC 3D Tiles into Blender with cesium-native: meshes, point clouds, Gaussian splats and voxels, raster overlays, clipping

Resources

Stars

22 stars

Watchers

0 watching

Forks

 
 

Repository files navigation

OGC 3D Tiles Streaming — Blender Plugin

Documentation and slides: iconem.github.io/blender_ogc3dtiles · Releases

Features

  • Content: cesium-native brings for free all supported flavors of 3D Tiles (1.0 / 1.1) and tile content:
  • 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.

Google Photorealistic 3D Tiles over the Colosseum in Blender: viewport with the add-on sidebar, then EEVEE, Cycles with a 10 kW lamp, and EEVEE through the beauty compositor (EDL 16)

Sidebar in three columns: main panel with raster overlays, clipping and viewport-region clip - Scene Origin, LOD / Streaming, Nodes: Material, Nodes: Geometry, Coordinate Info - Nodes: Compositing, Nodes: Metadata, Render

Installation

The add-on is a Blender extension, for Blender 4.2 or newer (Gaussian splats need 5.3).

  1. Download ogc_3dtiles_streaming-<version>.zip from the Releases page.
  2. In Blender: Preferences, Get Extensions, the drop-down arrow, Install from Disk.
  3. 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.

Quick start

  1. Open the sidebar of the 3D viewport (N), tab 3D Tiles.
  2. Add a tileset entry (+) and paste a tileset.json URL: a Cesium ion asset, Google Photorealistic 3D Tiles, a local file, a share link.
  3. For Cesium ion, paste your access token.
  4. Leave the origin mode on Auto: the first tileset centres the scene.
  5. Press Start and navigate: tiles load as the camera moves.

Development

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.

License

MIT.

About

Stream OGC 3D Tiles into Blender with cesium-native: meshes, point clouds, Gaussian splats and voxels, raster overlays, clipping

Resources

Stars

22 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages