KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #cli #open-source #ai #claude-code #codex #developer-tools #react #windows #deepseek-harness #ai-agent

atmosphere

★ 57 Open GitHub ↗

A tool to precompute atmospheric scattering tables for real-time dynamic atmosphere rendering.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Atmospheric Rendering

### [Web Demo](https://danielshervheim.com/atmosphere/)

[![cover](https://raw.githubusercontent.com/danielshervheim/atmosphere/main/images/all.png)](https://danielshervheim.com/atmosphere/)

## About

Rendering realistic and dynamic skies is a challenging problem in real-time computer graphics. The math behind light scattering is too complex to solve directly in real-time, but it can be done offline.

This program solves the atmospheric scattering equations for every possible view and sun direction, and stores the results in look-up tables. The tables can then be sampled in a fragment shader to reconstruct an accurate rendering of the sky at any time of day.

This branch contains the code that precomputes the scattering tables. For an example of using the precomputed data in a renderer, please look at this repository's `gh-pages` branch.

## Background

Before light reaches your eye, there is a probability a portion of it will be absorbed by aerosols (Mie theory) or scattered into a different direction by molecules (Rayleigh theory).

The amount of light reaching your eye after undergoing either Rayleigh or Mie scattering within the atmosphere is described by the following equation:

![img](https://raw.githubusercontent.com/danielshervheim/atmosphere/main/images/equation.png)

For a complete explanation of the math behind atmospheric scattering, I recommend Gustav Bodare and Edvard Sandberg's excellent [thesis](http://publications.lib.chalmers.se/records/fulltext/203057/203057.pdf) on atmospheric scattering.

## How To Use

This program precomputes the above integral for:

- 2 scattering events (Rayleigh and Mie).
- 3 wavelengths (which roughly correspond to red, green, and blue).
- 64 view-zenith angles (from 0 to π).
- 64 sun-zenith angles (from 0 to π).

To use it:

1. Clone this repository.
2. `cd` into `atmosphere/`
3. Run `make`.
4. Run `./build/atmosphere`.

You can specify a number of runtime flags to control the pre-computation:

- `-o <output_dir>` puts the results into the specified directory. (The directory must exist).
- `-n` normalizes the pre-computed results into the [0, 1] range. This helps preserve precision in the double to float conversion process.
- `-exr` outputs to `.exr` files rather than binary float arrays. (This requires the OpenEXR library. You might have to set the path correctly in the makefile).

This program outputs three files:

1. `rayleigh` contains the precomputed Rayleigh scattering table as either a binary-encoded float array (`.bin`) or an HDR image (`.exr`).
2. `mie` contains the precomputed Mie scattering table as either a binary-encoded float array (`.bin`) or an HDR image (`.exr`).
3. `results.txt` contains the necessary constants to correctly render the atmosphere in your renderer of choice.

I excluded the spectral intensity `Ii(λ)` and phase function `F(θ)` terms from the pre-computed results. They are constant anyway, and in deferring them to a fragment shader we can avoid some visual artifacts around the sun.

I also provide the option to normalize the table values in the [0, 1] range to preserve as much precision as possible when converting from doubles to floats. After you sample the tables in a fragment shader, you must un-normalize the values with the following formula: `val = val * (max - min) + min`. The max and min values are written into `results.txt` as part of the pre-computation process.

## Rendering

For a complete example of using the precomputed data in a renderer, please see this repository's `gh-pages` branch. The basic process is outlined below:

1. Load each table as a float array.
2. Create 64x64 RGB floating point textures from each array.
3. Upload the Rayleigh and Mie textures to the GPU.
4. In the fragment shader, convert the current view-zenith and sun-zenith angle into texture coordinates with the following formula:
   1. `u = 0.5 * (1.0 + sign(cosViewZenith)*pow(abs(cosViewZenith), 1.0/3.0));`
   2. `v = 0.5 * (1.0 + sign(cosSunZenith)*pow(abs(cosSunZenith), 1.0/3.0));`
5. Sample the Rayleigh and Mie textures with the texture coordinate `(u, v)`.
6. Remap the Rayleigh and Mie values with the `min` and `max` constants from `results.txt`.
7. Multiply the Rayleigh and Mie values with their respective phase functions.
8. Add the Rayleigh and Mie values to get the total scattering.
9. Multiply the total scattering by the spectral irradiance constants from `results.txt` to compute the radiance.
10. Multiply the radiance by the spectral-to-rgb conversion constants from `results.txt` to compute the rgb color.
11. If you are working in a low dynamic range renderer, you must tone-map the rgb color via `rgb = pow(1.0 - exp(-rgb), 1.0/2.2)`.
12. If you are working in an HDR environment, you should let your post processing filter handle the HDR color grading and tone-mapping.

atmosphere

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README