https://github.com/jsoulier/sdl_earth_viewer
Earth Viewer using SDL3 GPU and Cesium Native
https://github.com/jsoulier/sdl_earth_viewer
cesium cpp example examples gpu hlsl sdl sdl3 shader shaders
Last synced: about 4 hours ago
JSON representation
Earth Viewer using SDL3 GPU and Cesium Native
- Host: GitHub
- URL: https://github.com/jsoulier/sdl_earth_viewer
- Owner: jsoulier
- License: unlicense
- Created: 2026-05-25T05:21:48.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-05-26T06:24:28.000Z (about 1 month ago)
- Last Synced: 2026-05-26T06:29:37.405Z (about 1 month ago)
- Topics: cesium, cpp, example, examples, gpu, hlsl, sdl, sdl3, shader, shaders
- Language: C++
- Homepage:
- Size: 1010 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# SDL Earth Viewer
Earth Viewer using SDL3 GPU and Cesium Native
### Features
- Cesium Ion integration
- 3D, terrain, and imagery tiles
- Planetary scale rendering
- Fun shaders
### Limitations
- Only 1 imagery layer is supported
### Cesium Ion
#### Authentication
The project pulls maps from https://api.cesium.com/.
To authenticate with the endpoint:
1. Create an account with [Cesium Ion](https://ion.cesium.com/)
2. Go to [Access Tokens](https://ion.cesium.com/tokens)
3. Copy "Default Token" to your clipboard
4. Create a file called `cesium_ion_token.txt` in your home directory
5. Paste the token in the file
#### Assets
Cesium Ion comes with free assets. To reference the assets:
1. Go to [My Assets](https://ion.cesium.com/assets)
2. Specify the maps you'd like to load in ImGui and click "Recreate"
3. For terrain/imagery, use the terrain ID for "Ion Asset ID" and the imagery ID for "Ion Imagery ID"
4. For 3D tiles, use ID for "Ion Asset ID" and `-1` for "Ion Imagery ID"
5. You can grab more maps from the [Asset Depot](https://ion.cesium.com/assetdepot) but I haven't tested it much
### Building
Follow the vcpkg instructions from [Cesium](https://cesium.com/learn/cesium-native/ref-doc/developer-setup.html#vcpkg)
#### Windows
```bash
git clone https://github.com/jsoulier/sdl_earth_viewer --recurse-submodules
cd sdl_earth_viewer
mkdir build
cd build
cmake ..
cmake --build . --parallel 8 --config Release
cd bin
./sdl_earth_viewer.exe
```
#### Linux
```bash
git clone https://github.com/jsoulier/sdl_earth_viewer --recurse-submodules
cd sdl_earth_viewer
mkdir build
cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
cmake --build . --parallel 8
cd bin
./sdl_earth_viewer
```
#### Shaders
Shaders are precompiled.
To build locally, add [SDL_shadercross](https://github.com/libsdl-org/SDL_shadercross) to your path