bevy_elements 0.5.0

Living environments for Bevy: sun, moon and stars, climate-driven weather, GPU wind, volumetric clouds, rain, snow and fog, lightning, terrain with hydraulic and thermal erosion, flooding, snow cover, wetness and dust — simulated in compute shaders.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77

// The cloud shadow map: direct transmittance toward the light through the clouds for the plane
// y = 0, 1024² texels over an 8 km square centred on the camera. See docs/research/clouds.md
// ("Cloud shadow map and the sun's illuminance").
//
//   cloud_shadow          R transmittance, G optical depth (≤ 60), B precipitation darkening
//   cloud_shadow_camera   mean transmittance of the 9×9 texels around the camera → buffer

import bevy_pbr::render::utils::interleaved_gradient_noise;
import bevy_elements::clouds::common::{CloudParams, cloud_medium};

@group(0) @binding(0) var<uniform> params: CloudParams;
@group(0) @binding(1) var weather_tex: texture_2d<f32>;
@group(0) @binding(2) var base_tex: texture_3d<f32>;
@group(0) @binding(3) var smp: sampler;
@group(0) @binding(4) var shadow_out: texture_storage_2d<rgba16float, write>;
@group(0) @binding(5) var<storage, read_write> camera_t: array<f32, 4>;

const TEXELS: u32 = 1024u;
const STEPS: u32 = 8u;
/// Lowest sine of the light's elevation the map is generated for (the layer would otherwise
/// lie beyond the weather map): arcsin 0.1 = 5.74°.
const MIN_LIGHT_SINE: f32 = 0.1;

/// (T, τ, g) toward the light at a shadow-map texel position (texel units, centre at +0.5).
fn shadow_at(texel: vec2<f32>) -> vec3<f32> {
    let q = params.shadow.xy + texel * (params.shadow.z / f32(TEXELS));
    var l = params.light.xyz;
    if l.y < MIN_LIGHT_SINE {
        let flat_len = length(l.xz);
        let flat_dir = select(vec2<f32>(1.0, 0.0), l.xz / max(flat_len, 1e-6), flat_len > 1e-4);
        let c = sqrt(1.0 - MIN_LIGHT_SINE * MIN_LIGHT_SINE);
        l = vec3<f32>(flat_dir.x * c, MIN_LIGHT_SINE, flat_dir.y * c);
    }
    // The pattern is fixed in space (frame 0): grain that does not shimmer.
    let jitter = interleaved_gradient_noise(floor(texel), 0u);
    let h_b = params.layer.x;
    let thickness = params.layer.y - h_b;
    let dh = thickness / f32(STEPS);
    let ds = dh / l.y;
    var tau = 0.0;
    var g_sum = 0.0;
    var s_sum = 0.0;
    for (var i = 0u; i < STEPS; i += 1u) {
        let h = h_b + (f32(i) + jitter) * dh;
        let m = cloud_medium(h, q + l.xz * (h / l.y), false, params, base_tex, base_tex, weather_tex, smp);
        tau += (1.0 + m.g) * m.sigma * ds;
        g_sum += m.g * m.sigma;
        s_sum += m.sigma;
    }
    return vec3<f32>(exp(-tau), min(tau, 60.0), g_sum / max(s_sum, 1e-6));
}

@compute @workgroup_size(8, 8, 1)
fn cloud_shadow(@builtin(global_invocation_id) id: vec3<u32>) {
    if any(id.xy >= vec2<u32>(TEXELS)) {
        return;
    }
    let s = shadow_at(vec2<f32>(id.xy) + 0.5);
    textureStore(shadow_out, vec2<i32>(id.xy), vec4<f32>(s.x, s.y, s.z, 0.0));
}

var<workgroup> column: array<f32, 81>;

@compute @workgroup_size(9, 9, 1)
fn cloud_shadow_camera(@builtin(local_invocation_id) lid: vec3<u32>, @builtin(local_invocation_index) lane: u32) {
    let centre = floor((params.camera.xz - params.shadow.xy) / (params.shadow.z / f32(TEXELS)));
    let texel = centre + vec2<f32>(lid.xy) - 4.0;
    column[lane] = shadow_at(texel + 0.5).x;
    workgroupBarrier();
    if lane == 0u {
        var sum = 0.0;
        for (var i = 0u; i < 81u; i += 1u) {
            sum += column[i];
        }
        camera_t[0] = sum / 81.0;
    }
}