cuju-render 0.1.0__py3-none-any.whl

cuju/render/web/js/world/vendor-sky.js

@@ -0,0 +1,367 @@
+// Sky.js from three.js r186, examples/jsm/objects/Sky.js, unchanged below this header.
+// https://github.com/mrdoob/three.js/blob/r186/examples/jsm/objects/Sky.js
+//
+// The MIT License
+//
+// Copyright © 2010-2026 three.js authors
+//
+// Permission is hereby granted, free of charge, to any person obtaining a copy
+// of this software and associated documentation files (the "Software"), to deal
+// in the Software without restriction, including without limitation the rights
+// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the Software is
+// furnished to do so, subject to the following conditions:
+//
+// The above copyright notice and this permission notice shall be included in
+// all copies or substantial portions of the Software.
+//
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+// THE SOFTWARE.
+
+import {
+	BackSide,
+	BoxGeometry,
+	Mesh,
+	ShaderMaterial,
+	UniformsUtils,
+	Vector3
+} from 'three';
+
+/**
+ * Represents a skydome for scene backgrounds. Based on [A Practical Analytic Model for Daylight](https://www.researchgate.net/publication/220720443_A_Practical_Analytic_Model_for_Daylight)
+ * aka The Preetham Model, the de facto standard for analytical skydomes.
+ *
+ * Note that this class can only be used with {@link WebGLRenderer}.
+ * When using {@link WebGPURenderer}, use {@link SkyMesh}.
+ *
+ * More references:
+ *
+ * - {@link http://simonwallner.at/project/atmospheric-scattering/}
+ * - {@link http://blenderartists.org/forum/showthread.php?245954-preethams-sky-impementation-HDR}
+ *
+ *
+ * ```js
+ * const sky = new Sky();
+ * sky.scale.setScalar( 10000 );
+ * scene.add( sky );
+ * ```
+ *
+ * It can be useful to hide the sun disc when generating an environment map to avoid artifacts
+ *
+ * ```js
+ * // disable before rendering environment map
+ * sky.material.uniforms.showSunDisc.value = false;
+ * // ...
+ * // re-enable before scene sky box rendering
+ * sky.material.uniforms.showSunDisc.value = true;
+ * ```
+ *
+ * @augments Mesh
+ * @three_import import { Sky } from 'three/addons/objects/Sky.js';
+ */
+class Sky extends Mesh {
+
+	/**
+	 * Constructs a new skydome.
+	 */
+	constructor() {
+
+		const shader = Sky.SkyShader;
+
+		const material = new ShaderMaterial( {
+			name: shader.name,
+			uniforms: UniformsUtils.clone( shader.uniforms ),
+			vertexShader: shader.vertexShader,
+			fragmentShader: shader.fragmentShader,
+			side: BackSide,
+			depthWrite: false
+		} );
+
+		super( new BoxGeometry( 1, 1, 1 ), material );
+
+		/**
+		 * This flag can be used for type testing.
+		 *
+		 * @type {boolean}
+		 * @readonly
+		 * @default true
+		 */
+		this.isSky = true;
+
+	}
+
+}
+
+Sky.SkyShader = {
+
+	name: 'SkyShader',
+
+	uniforms: {
+		'turbidity': { value: 2 },
+		'rayleigh': { value: 1 },
+		'mieCoefficient': { value: 0.005 },
+		'mieDirectionalG': { value: 0.8 },
+		'sunPosition': { value: new Vector3() },
+		'cloudScale': { value: 0.0002 },
+		'cloudSpeed': { value: 0.00002 },
+		'cloudCoverage': { value: 0.4 },
+		'cloudDensity': { value: 0.4 },
+		'cloudElevation': { value: 0.5 },
+		'showSunDisc': { value: 1 },
+		'time': { value: 0.0 }
+	},
+
+	vertexShader: /* glsl */`
+		uniform vec3 sunPosition;
+		uniform float rayleigh;
+		uniform float turbidity;
+		uniform float mieCoefficient;
+
+		varying vec3 vWorldPosition;
+		varying vec3 vSunDirection;
+		varying float vSunfade;
+		varying vec3 vBetaR;
+		varying vec3 vBetaM;
+		varying float vSunE;
+
+		// constants for atmospheric scattering
+		const float e = 2.71828182845904523536028747135266249775724709369995957;
+		const float pi = 3.141592653589793238462643383279502884197169;
+
+		// wavelength of used primaries, according to preetham
+		const vec3 lambda = vec3( 680E-9, 550E-9, 450E-9 );
+		// this pre-calculation replaces older TotalRayleigh(vec3 lambda) function:
+		// (8.0 * pow(pi, 3.0) * pow(pow(n, 2.0) - 1.0, 2.0) * (6.0 + 3.0 * pn)) / (3.0 * N * pow(lambda, vec3(4.0)) * (6.0 - 7.0 * pn))
+		const vec3 totalRayleigh = vec3( 5.804542996261093E-6, 1.3562911419845635E-5, 3.0265902468824876E-5 );
+
+		// mie stuff
+		// K coefficient for the primaries
+		const float v = 4.0;
+		const vec3 K = vec3( 0.686, 0.678, 0.666 );
+		// MieConst = pi * pow( ( 2.0 * pi ) / lambda, vec3( v - 2.0 ) ) * K
+		const vec3 MieConst = vec3( 1.8399918514433978E14, 2.7798023919660528E14, 4.0790479543861094E14 );
+
+		// earth shadow hack
+		// cutoffAngle = pi / 1.95;
+		const float cutoffAngle = 1.6110731556870734;
+		const float steepness = 1.5;
+		const float EE = 1000.0;
+
+		float sunIntensity( float zenithAngleCos ) {
+			zenithAngleCos = clamp( zenithAngleCos, -1.0, 1.0 );
+			return EE * max( 0.0, 1.0 - pow( e, -( ( cutoffAngle - acos( zenithAngleCos ) ) / steepness ) ) );
+		}
+
+		vec3 totalMie( float T ) {
+			float c = ( 0.2 * T ) * 10E-18;
+			return 0.434 * c * MieConst;
+		}
+
+		void main() {
+
+			vec4 worldPosition = modelMatrix * vec4( position, 1.0 );
+			vWorldPosition = worldPosition.xyz;
+
+			gl_Position = projectionMatrix * modelViewMatrix * vec4( position, 1.0 );
+			gl_Position.z = gl_Position.w; // set z to camera.far
+
+			vSunDirection = normalize( sunPosition );
+
+			vSunE = sunIntensity( vSunDirection.y );
+
+			vSunfade = 1.0 - clamp( 1.0 - exp( ( sunPosition.y / 450000.0 ) ), 0.0, 1.0 );
+
+			float rayleighCoefficient = rayleigh - ( 1.0 * ( 1.0 - vSunfade ) );
+
+			// extinction (absorption + out scattering)
+			// rayleigh coefficients
+			vBetaR = totalRayleigh * rayleighCoefficient;
+
+			// mie coefficients
+			vBetaM = totalMie( turbidity ) * mieCoefficient;
+
+		}`,
+
+	fragmentShader: /* glsl */`
+		varying vec3 vWorldPosition;
+		varying vec3 vSunDirection;
+		varying vec3 vBetaR;
+		varying vec3 vBetaM;
+		varying float vSunE;
+
+		uniform float mieDirectionalG;
+		uniform float cloudScale;
+		uniform float cloudSpeed;
+		uniform float cloudCoverage;
+		uniform float cloudDensity;
+		uniform float cloudElevation;
+		uniform float showSunDisc;
+		uniform float time;
+
+		// gradient at a lattice corner; sinless hash so every GPU produces the same clouds
+		vec2 gradient( vec2 i ) {
+			vec3 p = fract( i.xyx * vec3( 0.1031, 0.1030, 0.0973 ) );
+			p += dot( p, p.yzx + 33.33 );
+			return fract( ( p.xx + p.yz ) * p.zy ) * 2.0 - 1.0;
+		}
+
+		// 2D gradient noise: isotropic lobes like Perlin at value-noise cost
+		float noise( vec2 p ) {
+			vec2 i = floor( p );
+			vec2 f = fract( p );
+			vec2 u = f * f * f * ( f * ( f * 6.0 - 15.0 ) + 10.0 ); // quintic fade
+			float a = dot( gradient( i ), f );
+			float b = dot( gradient( i + vec2( 1.0, 0.0 ) ), f - vec2( 1.0, 0.0 ) );
+			float c = dot( gradient( i + vec2( 0.0, 1.0 ) ), f - vec2( 0.0, 1.0 ) );
+			float d = dot( gradient( i + vec2( 1.0, 1.0 ) ), f - vec2( 1.0, 1.0 ) );
+			return mix( mix( a, b, u.x ), mix( c, d, u.x ), u.y ) * 1.6; // ~[-1,1]
+		}
+
+		// fbm; per-octave drift makes clouds billow instead of scrolling as a rigid stamp
+		float fbm( vec2 p, float drift ) {
+			float result = 0.0;
+			float amplitude = 1.0;
+			for ( int i = 0; i < 4; i ++ ) {
+				result += amplitude * noise( p );
+				amplitude *= 0.5;
+				p = p * 2.0 + drift;
+			}
+			return result;
+		}
+
+		// constants for atmospheric scattering
+		const float pi = 3.141592653589793238462643383279502884197169;
+
+		const float n = 1.0003; // refractive index of air
+		const float N = 2.545E25; // number of molecules per unit volume for air at 288.15K and 1013mb (sea level -45 celsius)
+
+		// optical length at zenith for molecules
+		const float rayleighZenithLength = 8.4E3;
+		const float mieZenithLength = 1.25E3;
+		// 66 arc seconds -> degrees, and the cosine of that
+		const float sunAngularDiameterCos = 0.999956676946448443553574619906976478926848692873900859324;
+
+		// 3.0 / ( 16.0 * pi )
+		const float THREE_OVER_SIXTEENPI = 0.05968310365946075;
+		// 1.0 / ( 4.0 * pi )
+		const float ONE_OVER_FOURPI = 0.07957747154594767;
+
+		float rayleighPhase( float cosTheta ) {
+			return THREE_OVER_SIXTEENPI * ( 1.0 + pow( cosTheta, 2.0 ) );
+		}
+
+		float hgPhase( float cosTheta, float g ) {
+			float g2 = pow( g, 2.0 );
+			float inverse = 1.0 / pow( 1.0 - 2.0 * g * cosTheta + g2, 1.5 );
+			return ONE_OVER_FOURPI * ( ( 1.0 - g2 ) * inverse );
+		}
+
+		void main() {
+
+			vec3 direction = normalize( vWorldPosition - cameraPosition );
+
+			// optical length
+			// cutoff angle at 90 to avoid singularity in next formula.
+			float zenithAngle = acos( max( 0.0, direction.y ) );
+			float inverse = 1.0 / ( cos( zenithAngle ) + 0.15 * pow( 93.885 - ( ( zenithAngle * 180.0 ) / pi ), -1.253 ) );
+			float sR = rayleighZenithLength * inverse;
+			float sM = mieZenithLength * inverse;
+
+			// combined extinction factor
+			vec3 Fex = exp( -( vBetaR * sR + vBetaM * sM ) );
+
+			// in scattering
+			float cosTheta = dot( direction, vSunDirection );
+
+			float rPhase = rayleighPhase( cosTheta * 0.5 + 0.5 );
+			vec3 betaRTheta = vBetaR * rPhase;
+
+			float mPhase = hgPhase( cosTheta, mieDirectionalG );
+			vec3 betaMTheta = vBetaM * mPhase;
+
+			vec3 Lin = pow( vSunE * ( ( betaRTheta + betaMTheta ) / ( vBetaR + vBetaM ) ) * ( 1.0 - Fex ), vec3( 1.5 ) );
+			Lin *= mix( vec3( 1.0 ), pow( vSunE * ( ( betaRTheta + betaMTheta ) / ( vBetaR + vBetaM ) ) * Fex, vec3( 1.0 / 2.0 ) ), clamp( pow( 1.0 - vSunDirection.y, 5.0 ), 0.0, 1.0 ) );
+
+			// nightsky
+			float theta = acos( direction.y ); // elevation --> y-axis, [-pi/2, pi/2]
+			float phi = atan( direction.z, direction.x ); // azimuth --> x-axis [-pi/2, pi/2]
+			vec2 uv = vec2( phi, theta ) / vec2( 2.0 * pi, pi ) + vec2( 0.5, 0.0 );
+			vec3 L0 = vec3( 0.1 ) * Fex;
+
+			// composition + solar disc
+			float sundisc = clamp( ( cosTheta - sunAngularDiameterCos ) * 50000.0, 0.0, 1.0 ) * showSunDisc;
+			vec3 sundiscColor = ( 760.0 * sundisc ) * min( vSunE * Fex, 80.0 );
+
+			vec3 texColor = ( Lin + L0 ) * 0.04 + sundiscColor + vec3( 0.0, 0.0003, 0.00075 );
+
+			// Clouds
+			if ( direction.y > 0.0 && cloudCoverage > 0.0 ) {
+
+				// Project to cloud plane (higher elevation = clouds appear lower/closer)
+				float elevation = mix( 1.0, 0.1, cloudElevation );
+				vec2 cloudUV = direction.xz / ( direction.y * elevation );
+				cloudUV *= cloudScale;
+				cloudUV += time * cloudSpeed;
+
+				// Cloud density field
+				float evolve = time * cloudSpeed * 300.0;
+				float cloudNoise = clamp( fbm( cloudUV * 1000.0, evolve ) * 0.7 + 0.5, 0.0, 1.0 );
+
+				// Large-scale coverage variation: clear gaps next to dense banks
+				float region = noise( cloudUV * 300.0 ) * 0.37 + 0.5;
+				float cov = clamp( cloudCoverage + ( region - 0.5 ) * 0.6, 0.0, 1.0 );
+
+				// Carve clouds where noise rises above the coverage level
+				float threshold = 1.0 - cov;
+				float cloudMask = smoothstep( threshold, threshold + 0.3, cloudNoise );
+
+				// Fade clouds near horizon (adjusted by elevation)
+				float horizonFade = smoothstep( 0.0, 0.03 + 0.06 * cloudElevation, direction.y );
+				cloudMask *= horizonFade;
+
+				// Cloud lighting from the sky's own radiance
+				float dayFactor = smoothstep( -0.08, 0.3, vSunDirection.y );
+				vec3 sunColor = vSunE * Fex * 0.22 * 0.04; // 0.22 ~ albedo/pi, 0.04 = exposure; the aerial composite adds the eye-leg extinction
+				vec3 skyAmbient = Lin * 0.04 + vec3( 0.0, 0.0003, 0.00075 );
+
+				// Beer-powder self-shadow from the sampled density
+				float depth = max( 0.0, cloudNoise - threshold );
+				float beer = exp( depth * -4.0 );
+				float powder = 1.0 - beer * beer; // beer*beer == exp(-8*depth)
+				float shade = mix( 0.45, 1.0, clamp( beer * powder * 2.6, 0.0, 1.0 ) ); // 2.6 = 1/0.385, normalizes beer*powder peak to 1
+
+				// Henyey-Greenstein forward lobe ( g = 0.7 ): silver lining on rims toward the sun
+				float silver = clamp( 0.51 / pow( 1.49 - cosTheta * 1.4, 1.5 ), 0.0, 3.0 ); // 0.51=1-g^2, 1.49=1+g^2, 1.4=2g
+				float edge = cloudMask * ( 1.0 - cloudMask ) * 4.0;
+
+				vec3 cloudColor = skyAmbient + sunColor * shade;
+				cloudColor += sunColor * silver * edge * 0.6;
+				cloudColor *= max( dayFactor, 0.03 );
+
+				// Cloud opacity via Beer's law: density sets how solid the clouds get
+				float alpha = ( 1.0 - exp( depth * cloudDensity * -12.0 ) ) * horizonFade;
+
+				// Occlude the sun disc/glow behind opaque cloud
+				texColor -= L0 * 0.04 * alpha;
+
+				// Composite through the atmosphere so distant clouds dissolve into haze
+				vec3 cloudAerial = mix( texColor, cloudColor, Fex );
+				texColor = mix( texColor, cloudAerial, alpha );
+
+			}
+
+			gl_FragColor = vec4( texColor, 1.0 );
+
+			#include <tonemapping_fragment>
+			#include <colorspace_fragment>
+
+		}`
+
+};
+
+export { Sky };

cuju/render/web/js/world/weather.js

@@ -0,0 +1,264 @@
+// Copyright 2026 The cuju Authors
+// SPDX-License-Identifier: Apache-2.0
+
+// Rain, snow and splashes. Every particle is one instance of a small quad whose place comes from
+// its seed and the time in the vertex shader, so the processor only sets a few uniforms a frame.
+// The drops are anchored to the world and wrap around a box that follows the camera, so they
+// never swim with it. Quality sets how many there are, the low quality draws none.
+
+import * as THREE from 'three';
+import { FULL_HALF_H, FULL_HALF_W } from './pitch.js';
+
+const COUNTS = {
+    low: { rain: 0, snow: 0, splash: 0 },
+    medium: { rain: 6000, snow: 4000, splash: 900 },
+    high: { rain: 16000, snow: 9000, splash: 2400 },
+};
+// The box of drops around the camera, its half size in meters.
+const RAIN_HALF = new THREE.Vector3(36, 22, 36);
+const SNOW_HALF = new THREE.Vector3(30, 18, 30);
+
+const COMMON = `
+uniform float uTime;
+uniform vec3 uCenter;
+uniform vec3 uHalf;
+uniform vec3 uVel;
+attribute vec4 seed;
+varying vec2 vUv;
+varying float vFade;
+vec3 cjWrap(vec3 p) {
+    vec3 rel = mod(p - uCenter + uHalf, uHalf * 2.0) - uHalf;
+    vFade = 1.0 - smoothstep(0.75, 1.0, length(rel.xz) / uHalf.x);
+    vFade *= 1.0 - smoothstep(0.8, 1.0, abs(rel.y) / uHalf.y);
+    return uCenter + rel;
+}
+`;
+
+const RAIN_VERTEX = `${COMMON}
+uniform float uLen;
+uniform float uWidth;
+void main() {
+    float speed = 0.85 + 0.3 * seed.w;
+    vec3 head = cjWrap(seed.xyz * uHalf * 2.0 + uVel * speed * uTime);
+    vec3 dir = normalize(uVel);
+    vec3 p = head - dir * uLen * speed * position.y;
+    vec3 toCam = cameraPosition - p;
+    float dist = length(toCam);
+    // Far drops widen to about a pixel and fade to match, so they shimmer rather than flicker.
+    float width = max(uWidth, dist * 0.0022);
+    vFade *= uWidth / width * 0.5 + 0.5;
+    vFade *= step(0.0, p.y) * smoothstep(0.6, 3.0, dist);
+    p += normalize(cross(dir, toCam)) * width * position.x;
+    vUv = position.xy;
+    gl_Position = projectionMatrix * viewMatrix * vec4(p, 1.0);
+}`;
+
+const SNOW_VERTEX = `${COMMON}
+uniform float uSize;
+void main() {
+    float t = uTime * (0.7 + 0.6 * seed.w);
+    vec3 sway = vec3(sin(t * 1.3 + seed.x * 40.0), 0.0, cos(t * 1.1 + seed.z * 40.0)) * 0.5;
+    vec3 head = cjWrap(seed.xyz * uHalf * 2.0 + uVel * t + sway);
+    vec3 right = vec3(viewMatrix[0][0], viewMatrix[1][0], viewMatrix[2][0]);
+    vec3 up = vec3(viewMatrix[0][1], viewMatrix[1][1], viewMatrix[2][1]);
+    float dist = length(cameraPosition - head);
+    float size = max(uSize * (0.6 + 0.8 * seed.w), dist * 0.0016);
+    vFade *= step(0.0, head.y) * smoothstep(0.4, 2.0, dist) * min(1.0, uSize * 1.5 / size + 0.25);
+    vec3 p = head + (right * position.x + up * (position.y * 2.0 - 1.0)) * size;
+    vUv = vec2(position.x, position.y * 2.0 - 1.0);
+    gl_Position = projectionMatrix * viewMatrix * vec4(p, 1.0);
+}`;
+
+// Rings spreading on the ground where drops land, each at a new place every cycle.
+const SPLASH_VERTEX = `
+uniform float uTime;
+uniform vec2 uArea;
+attribute vec4 seed;
+varying vec2 vUv;
+varying float vFade;
+float cjHash(vec2 p) {
+    p = fract(p * vec2(0.1031, 0.1030));
+    p += dot(p, p.yx + 33.33);
+    return fract((p.x + p.y) * p.x);
+}
+void main() {
+    float period = 0.45 + 0.35 * seed.w;
+    float c = uTime / period + seed.z * 7.0;
+    float cycle = floor(c);
+    float phase = fract(c);
+    vec2 at = (vec2(cjHash(seed.xy * 91.0 + cycle), cjHash(seed.yx * 57.0 + cycle * 1.7)) * 2.0 - 1.0) * uArea;
+    float r = 0.05 + 0.22 * phase;
+    vec3 p = vec3(at.x + position.x * r, 0.03, at.y + position.y * r);
+    vUv = position.xy;
+    vFade = 1.0 - phase;
+    gl_Position = projectionMatrix * viewMatrix * vec4(p, 1.0);
+}`;
+
+const FRAGMENT_HEAD = `
+uniform vec3 uColor;
+uniform float uOpacity;
+varying vec2 vUv;
+varying float vFade;
+`;
+const FRAGMENT_TAIL = `
+    if (a < 0.004) {
+        discard;
+    }
+    gl_FragColor = vec4(uColor, a);
+    #include <tonemapping_fragment>
+    #include <colorspace_fragment>
+}`;
+
+const RAIN_FRAGMENT = `${FRAGMENT_HEAD}
+void main() {
+    float a = (1.0 - abs(vUv.x)) * (1.0 - 0.7 * vUv.y) * vFade * uOpacity;
+${FRAGMENT_TAIL}`;
+
+const SNOW_FRAGMENT = `${FRAGMENT_HEAD}
+void main() {
+    float a = smoothstep(1.0, 0.3, length(vUv)) * vFade * uOpacity;
+${FRAGMENT_TAIL}`;
+
+const SPLASH_FRAGMENT = `${FRAGMENT_HEAD}
+void main() {
+    float d = length(vUv);
+    float a = smoothstep(0.65, 0.85, d) * smoothstep(1.0, 0.88, d) * vFade * uOpacity;
+${FRAGMENT_TAIL}`;
+
+function rand(seed) {
+    let s = seed >>> 0;
+    return () => {
+        s = (s + 0x6d2b79f5) >>> 0;
+        let t = s;
+        t = Math.imul(t ^ (t >>> 15), t | 1);
+        t ^= t + Math.imul(t ^ (t >>> 7), t | 61);
+        return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
+    };
+}
+
+function particles(count, quad, vertexShader, fragmentShader, uniforms, seedValue) {
+    const geometry = new THREE.InstancedBufferGeometry();
+    geometry.setAttribute('position', new THREE.Float32BufferAttribute(quad, 3));
+    geometry.setIndex([0, 1, 2, 0, 2, 3]);
+    const seeds = new Float32Array(count * 4);
+    const r = rand(seedValue);
+    for (let i = 0; i < seeds.length; i++) {
+        seeds[i] = r();
+    }
+    geometry.setAttribute('seed', new THREE.InstancedBufferAttribute(seeds, 4));
+    geometry.instanceCount = 0;
+    const material = new THREE.ShaderMaterial({
+        uniforms, vertexShader, fragmentShader, transparent: true, depthWrite: false, side: THREE.DoubleSide,
+    });
+    const mesh = new THREE.Mesh(geometry, material);
+    mesh.frustumCulled = false;
+    mesh.visible = false;
+    mesh.renderOrder = 5;
+    return mesh;
+}
+
+export class Weather {
+    constructor(scene) {
+        this.group = new THREE.Group();
+        scene.add(this.group);
+        this.quality = 'medium';
+        this.state = { rain: 0, snow: 0, wind: 0 };
+        this.rainU = {
+            uTime: { value: 0 }, uCenter: { value: new THREE.Vector3() }, uHalf: { value: RAIN_HALF.clone() },
+            uVel: { value: new THREE.Vector3(0, -11, 0) }, uLen: { value: 0.9 }, uWidth: { value: 0.012 },
+            uColor: { value: new THREE.Color(0xc8d2dc) }, uOpacity: { value: 0.35 },
+        };
+        this.snowU = {
+            uTime: { value: 0 }, uCenter: { value: new THREE.Vector3() }, uHalf: { value: SNOW_HALF.clone() },
+            uVel: { value: new THREE.Vector3(0, -1.2, 0) }, uSize: { value: 0.035 },
+            uColor: { value: new THREE.Color(0xffffff) }, uOpacity: { value: 0.85 },
+        };
+        this.splashU = {
+            uTime: { value: 0 }, uArea: { value: new THREE.Vector2(FULL_HALF_W + 2, FULL_HALF_H + 2) },
+            uColor: { value: new THREE.Color(0xdfe6ee) }, uOpacity: { value: 0.5 },
+        };
+        this.build();
+    }
+
+    build() {
+        this.disposeMeshes();
+        const c = COUNTS[this.quality] || COUNTS.medium;
+        this.max = c;
+        this.rain = particles(c.rain, [-1, 0, 0, 1, 0, 0, 1, 1, 0, -1, 1, 0], RAIN_VERTEX, RAIN_FRAGMENT, this.rainU, 7);
+        this.snow = particles(c.snow, [-1, 0, 0, 1, 0, 0, 1, 1, 0, -1, 1, 0], SNOW_VERTEX, SNOW_FRAGMENT, this.snowU, 11);
+        this.splash = particles(c.splash, [-1, -1, 0, 1, -1, 0, 1, 1, 0, -1, 1, 0], SPLASH_VERTEX, SPLASH_FRAGMENT, this.splashU, 13);
+        this.group.add(this.rain, this.snow, this.splash);
+        this.applyCounts();
+    }
+
+    setQuality(quality) {
+        if (quality === this.quality && this.rain) {
+            return;
+        }
+        this.quality = quality;
+        this.build();
+    }
+
+    // Takes the lighting of the hour and weather, see lightingAt.
+    set(L) {
+        this.state = { rain: L.rain, snow: L.snow, wind: L.wind };
+        const wind = L.wind;
+        // Wind blows along the pitch from the right end, and a little towards the camera.
+        const gust = new THREE.Vector3(-1, 0, 0.35).normalize();
+        this.rainU.uVel.value.set(0, -11 - 3 * L.rain, 0).addScaledVector(gust, 9 * wind);
+        this.snowU.uVel.value.set(0, -1.1, 0).addScaledVector(gust, 3.5 * wind);
+        // Drops catch the light around them, the floodlights at night.
+        const light = Math.min(1.2, 0.25 + 0.45 * L.hemiIntensity + 0.15 * L.lightIntensity + 0.8 * L.flood);
+        this.rainU.uColor.value.setRGB(0.78, 0.82, 0.88).multiplyScalar(light);
+        this.rainU.uOpacity.value = 0.3 + 0.25 * L.rain;
+        this.snowU.uColor.value.setRGB(0.95, 0.96, 1.0).multiplyScalar(Math.min(1.1, 0.35 + 0.5 * L.hemiIntensity + 0.15 * L.lightIntensity + 0.7 * L.flood));
+        this.splashU.uColor.value.copy(this.rainU.uColor.value);
+        this.applyCounts();
+    }
+
+    applyCounts() {
+        const c = this.max;
+        const s = this.state;
+        this.rain.geometry.instanceCount = Math.round(c.rain * Math.min(1, s.rain));
+        this.snow.geometry.instanceCount = Math.round(c.snow * Math.min(1, s.snow));
+        this.splash.geometry.instanceCount = Math.round(c.splash * Math.min(1, s.rain));
+        this.rain.visible = this.rain.geometry.instanceCount > 0;
+        this.snow.visible = this.snow.geometry.instanceCount > 0;
+        this.splash.visible = this.splash.geometry.instanceCount > 0;
+    }
+
+    // The boxes sit a little ahead of the camera, where most of what it sees is.
+    update(seconds, camera) {
+        const t = seconds % 3600;
+        this.rainU.uTime.value = t;
+        this.snowU.uTime.value = t;
+        this.splashU.uTime.value = t;
+        if (!this.rain.visible && !this.snow.visible) {
+            return;
+        }
+        const ahead = camera.getWorldDirection(this.ahead || (this.ahead = new THREE.Vector3()));
+        ahead.y = 0;
+        if (ahead.lengthSq() > 1e-6) {
+            ahead.normalize();
+        }
+        this.rainU.uCenter.value.copy(camera.position).addScaledVector(ahead, RAIN_HALF.x * 0.55);
+        this.rainU.uCenter.value.y = Math.max(RAIN_HALF.y - 2, camera.position.y - 4);
+        this.snowU.uCenter.value.copy(camera.position).addScaledVector(ahead, SNOW_HALF.x * 0.55);
+        this.snowU.uCenter.value.y = Math.max(SNOW_HALF.y - 2, camera.position.y - 4);
+    }
+
+    disposeMeshes() {
+        for (const mesh of [this.rain, this.snow, this.splash]) {
+            if (mesh) {
+                mesh.removeFromParent();
+                mesh.geometry.dispose();
+                mesh.material.dispose();
+            }
+        }
+    }
+
+    dispose() {
+        this.disposeMeshes();
+        this.group.removeFromParent();
+    }
+}