@3driseai/3drise-viewer 0.1.7 → 0.1.8

package/dist/presets/volumetricCloudPresets.js

@@ -0,0 +1,480 @@
+// =============================================================================
+// Cumulus
+// =============================================================================
+const cumulusPresets = [
+    {
+        name: 'Humilis',
+        deckType: 'cumulus',
+        description: 'Flat little fair-weather puffs, wider apart than they are tall. More sky than cloud.',
+        tags: ['fair weather', 'sparse', 'shallow', 'summer', 'calm'],
+        settings: {
+            coverage: 0.3,
+            density: 2.4,
+            profile: 0.44,
+            baseAltitude: 1300,
+            topAltitude: 2100,
+            featureSize: 1700,
+            detailSize: 320,
+            detailStrength: 0.44,
+            curlStrength: 0.4,
+            weatherCellSize: 16000,
+            shear: 0.04,
+            windSpeed: 4,
+            rise: 0.9,
+            churn: 3,
+            evolution: 0.35,
+        },
+    },
+    {
+        name: 'Mediocris',
+        deckType: 'cumulus',
+        description: 'The classic cumulus: flat base, cauliflower top, as tall as it is wide.',
+        tags: ['fair weather', 'classic', 'balanced', 'daytime'],
+        settings: {
+            coverage: 0.5,
+            density: 2.8,
+            profile: 0.52,
+            baseAltitude: 1500,
+            topAltitude: 3400,
+            featureSize: 2600,
+            detailSize: 400,
+            detailStrength: 0.5,
+            curlStrength: 0.55,
+            weatherCellSize: 24000,
+            shear: 0.08,
+            windSpeed: 6,
+            rise: 1.4,
+            churn: 4.5,
+            evolution: 0.45,
+        },
+    },
+    {
+        name: 'Congestus',
+        deckType: 'cumulus',
+        description: 'Towering cumulus, growing hard. Taller than wide, hard cauliflower crowns, one step short of a storm.',
+        tags: ['towering', 'tall', 'building', 'unstable', 'afternoon'],
+        settings: {
+            coverage: 0.42,
+            density: 3.4,
+            profile: 0.74,
+            baseAltitude: 1200,
+            topAltitude: 5600,
+            featureSize: 3400,
+            detailSize: 560,
+            detailStrength: 0.55,
+            curlStrength: 0.7,
+            weatherCellSize: 32000,
+            shear: 0.16,
+            windSpeed: 8,
+            rise: 3.4,
+            churn: 7,
+            evolution: 0.6,
+        },
+    },
+    {
+        name: 'Fractus',
+        deckType: 'cumulus',
+        description: 'Torn, ragged shreds with no clean base. Heavy erosion and curl, dragged out by wind.',
+        tags: ['ragged', 'windy', 'broken', 'scud', 'stormy'],
+        settings: {
+            coverage: 0.56,
+            density: 1.7,
+            profile: 0.38,
+            baseAltitude: 900,
+            topAltitude: 2400,
+            featureSize: 1900,
+            detailSize: 240,
+            detailStrength: 0.78,
+            curlStrength: 1.5,
+            weatherCellSize: 14000,
+            shear: 0.34,
+            windSpeed: 16,
+            rise: 2.2,
+            churn: 11,
+            evolution: 0.75,
+        },
+    },
+    {
+        name: 'Crowded',
+        deckType: 'cumulus',
+        description: 'Cells grown into each other until the gaps close. Cumulus turning into a broken sheet.',
+        tags: ['dense', 'crowded', 'overcast', 'humid', 'merging'],
+        settings: {
+            coverage: 0.8,
+            density: 3.2,
+            profile: 0.4,
+            baseAltitude: 1300,
+            topAltitude: 3000,
+            featureSize: 3000,
+            detailSize: 460,
+            detailStrength: 0.42,
+            curlStrength: 0.5,
+            weatherCellSize: 30000,
+            shear: 0.12,
+            windSpeed: 7,
+            rise: 1.2,
+            churn: 4,
+            evolution: 0.4,
+        },
+    },
+];
+// =============================================================================
+// Stratocumulus
+// =============================================================================
+const stratocumulusPresets = [
+    {
+        name: 'Overcast',
+        deckType: 'stratocumulus',
+        description: 'Closed deck, no gaps. Flat grey lid with only the faintest lumps in the underside.',
+        tags: ['overcast', 'grey', 'closed', 'dull', 'winter'],
+        settings: {
+            coverage: 0.96,
+            density: 5,
+            profile: 0.12,
+            baseAltitude: 800,
+            topAltitude: 1500,
+            featureSize: 2600,
+            detailSize: 520,
+            detailStrength: 0.28,
+            curlStrength: 0.3,
+            weatherCellSize: 22000,
+            shear: 0.12,
+            windSpeed: 8,
+            rise: 0.4,
+            churn: 1.8,
+            evolution: 0.25,
+        },
+    },
+    {
+        name: 'Perlucidus',
+        deckType: 'stratocumulus',
+        description: 'Broken deck with blue showing through the gaps. The most common real sky.',
+        tags: ['broken', 'gaps', 'blue', 'everyday'],
+        settings: {
+            coverage: 0.66,
+            density: 4.2,
+            profile: 0.26,
+            baseAltitude: 900,
+            topAltitude: 1800,
+            featureSize: 2000,
+            detailSize: 420,
+            detailStrength: 0.42,
+            curlStrength: 0.5,
+            weatherCellSize: 15000,
+            shear: 0.18,
+            windSpeed: 9,
+            rise: 0.7,
+            churn: 2.6,
+            evolution: 0.4,
+        },
+    },
+    {
+        name: 'Undulatus',
+        deckType: 'stratocumulus',
+        description: 'Organised into rolls by shear. Bands lie across the wind and the whole deck leans downwind.',
+        tags: ['rolls', 'bands', 'shear', 'organised', 'coastal'],
+        settings: {
+            coverage: 0.84,
+            density: 4.6,
+            profile: 0.2,
+            baseAltitude: 950,
+            topAltitude: 1900,
+            featureSize: 1600,
+            detailSize: 380,
+            detailStrength: 0.4,
+            curlStrength: 0.62,
+            weatherCellSize: 12000,
+            shear: 0.62,
+            windSpeed: 15,
+            rise: 0.5,
+            churn: 2.2,
+            evolution: 0.3,
+        },
+    },
+    {
+        name: 'Marine layer',
+        deckType: 'stratocumulus',
+        description: 'Low, thick and slow — the lid that sits on a cold coast all morning. Almost no vertical motion.',
+        tags: ['marine', 'low', 'coastal', 'fog', 'morning', 'slow'],
+        settings: {
+            coverage: 0.94,
+            density: 5.6,
+            profile: 0.06,
+            baseAltitude: 380,
+            topAltitude: 950,
+            featureSize: 3200,
+            detailSize: 640,
+            detailStrength: 0.22,
+            curlStrength: 0.24,
+            weatherCellSize: 34000,
+            shear: 0.06,
+            windSpeed: 4,
+            rise: 0.2,
+            churn: 1,
+            evolution: 0.15,
+        },
+    },
+    {
+        name: 'Nebulosus veil',
+        deckType: 'stratocumulus',
+        description: 'A featureless thin sheet — sun visible through it as a disc. Barely a cloud, mostly a filter.',
+        tags: ['thin', 'veil', 'translucent', 'featureless', 'soft light'],
+        settings: {
+            coverage: 0.98,
+            density: 1.9,
+            profile: 0.02,
+            baseAltitude: 1100,
+            topAltitude: 1600,
+            featureSize: 4200,
+            detailSize: 900,
+            detailStrength: 0.16,
+            curlStrength: 0.18,
+            weatherCellSize: 46000,
+            shear: 0.08,
+            windSpeed: 6,
+            rise: 0.2,
+            churn: 0.8,
+            evolution: 0.12,
+            extinction: 0.011,
+            ambient: 1.35,
+        },
+    },
+];
+// =============================================================================
+// Cumulonimbus
+// =============================================================================
+const cumulonimbusPresets = [
+    {
+        name: 'Supercell',
+        deckType: 'cumulonimbus',
+        description: 'One rotating monster. Hard shear leans the tower, the anvil streams a long way downwind, the base is black.',
+        tags: ['supercell', 'severe', 'anvil', 'shear', 'dramatic'],
+        settings: {
+            coverage: 0.36,
+            density: 3.6,
+            profile: 1,
+            baseAltitude: 900,
+            topAltitude: 11000,
+            featureSize: 6200,
+            detailSize: 1300,
+            detailStrength: 0.52,
+            curlStrength: 0.95,
+            weatherCellSize: 62000,
+            shear: 0.66,
+            anvil: 1,
+            precipitation: 0.9,
+            windSpeed: 14,
+            rise: 4.2,
+            churn: 8,
+            evolution: 0.5,
+            silverLining: 1.5,
+        },
+    },
+    {
+        name: 'Mature cell',
+        deckType: 'cumulonimbus',
+        description: 'A single storm at full height, spreading at the top. Bright sunward flank, charcoal rain base.',
+        tags: ['storm', 'classic', 'anvil', 'rain', 'isolated'],
+        settings: {
+            coverage: 0.5,
+            density: 3.2,
+            profile: 0.96,
+            baseAltitude: 1100,
+            topAltitude: 9500,
+            featureSize: 5200,
+            detailSize: 1200,
+            detailStrength: 0.5,
+            curlStrength: 0.85,
+            weatherCellSize: 46000,
+            shear: 0.42,
+            anvil: 0.95,
+            precipitation: 0.75,
+            windSpeed: 11,
+            rise: 3.2,
+            churn: 7,
+            evolution: 0.55,
+        },
+    },
+    {
+        name: 'Distant thunderhead',
+        deckType: 'cumulonimbus',
+        description: 'One tower on the horizon and clear sky around it. Big features, low coverage — read it from far away.',
+        tags: ['distant', 'isolated', 'horizon', 'tall', 'sparse'],
+        settings: {
+            coverage: 0.24,
+            density: 3,
+            profile: 0.98,
+            baseAltitude: 1400,
+            topAltitude: 10500,
+            featureSize: 7600,
+            detailSize: 1600,
+            detailStrength: 0.46,
+            curlStrength: 0.7,
+            weatherCellSize: 78000,
+            shear: 0.36,
+            anvil: 0.9,
+            precipitation: 0.6,
+            windSpeed: 9,
+            rise: 2.6,
+            churn: 5.5,
+            evolution: 0.4,
+            aerialPerspective: 0.000016,
+        },
+    },
+    {
+        name: 'Squall line',
+        deckType: 'cumulonimbus',
+        description: 'Not one storm but a wall of them, sheared into a continuous front. Very little sky left.',
+        tags: ['squall', 'front', 'wall', 'severe', 'overcast'],
+        settings: {
+            coverage: 0.82,
+            density: 3.8,
+            profile: 0.9,
+            baseAltitude: 800,
+            topAltitude: 9000,
+            featureSize: 4400,
+            detailSize: 1000,
+            detailStrength: 0.56,
+            curlStrength: 1,
+            weatherCellSize: 38000,
+            shear: 0.58,
+            anvil: 0.7,
+            precipitation: 0.95,
+            windSpeed: 18,
+            rise: 3.8,
+            churn: 9,
+            evolution: 0.6,
+            ambient: 0.7,
+        },
+    },
+    {
+        name: 'Under the anvil',
+        deckType: 'cumulonimbus',
+        description: 'You are beneath the spreading top. Dark lid overhead, light leaking in only at the far edges.',
+        tags: ['anvil', 'overhead', 'dark', 'oppressive', 'close'],
+        settings: {
+            coverage: 0.9,
+            density: 4.2,
+            profile: 0.86,
+            baseAltitude: 700,
+            topAltitude: 8000,
+            featureSize: 5800,
+            detailSize: 1400,
+            detailStrength: 0.4,
+            curlStrength: 0.6,
+            weatherCellSize: 54000,
+            shear: 0.5,
+            anvil: 1,
+            precipitation: 1,
+            windSpeed: 12,
+            rise: 2.4,
+            churn: 6,
+            evolution: 0.35,
+            ambient: 0.6,
+            powder: 1.2,
+        },
+    },
+];
+export const volumetricCloudPresets = [
+    ...cumulusPresets,
+    ...stratocumulusPresets,
+    ...cumulonimbusPresets,
+];
+// =============================================================================
+// Cirrus
+// =============================================================================
+export const cirrusPresets = [
+    {
+        name: 'Fibratus',
+        description: 'Long parallel filaments combed out by the jet. The textbook cirrus.',
+        tags: ['streaks', 'filaments', 'classic', 'high'],
+        settings: {
+            altitude: 8200,
+            thickness: 700,
+            coverage: 0.62,
+            opticalDepth: 0.95,
+            featureSize: 44000,
+            anisotropy: 0.11,
+            windSpeed: 16,
+            halo: 1.1,
+        },
+    },
+    {
+        name: 'Uncinus',
+        description: "Mare's tails — a denser head with a filament trailing behind it where ice falls into slower air.",
+        tags: ['hooks', 'tails', 'falling ice', 'wispy'],
+        settings: {
+            altitude: 7600,
+            thickness: 1100,
+            coverage: 0.48,
+            opticalDepth: 1.25,
+            featureSize: 30000,
+            anisotropy: 0.2,
+            windSpeed: 22,
+            halo: 0.9,
+        },
+    },
+    {
+        name: 'Spissatus',
+        description: 'Thick enough to grey the sun. Dense patches rather than filaments — often the last of an old anvil.',
+        tags: ['dense', 'thick', 'patchy', 'anvil remains'],
+        settings: {
+            altitude: 9000,
+            thickness: 1800,
+            coverage: 0.55,
+            opticalDepth: 1.75,
+            featureSize: 26000,
+            anisotropy: 0.42,
+            windSpeed: 12,
+            halo: 0.45,
+            ambient: 1.2,
+        },
+    },
+    {
+        name: 'Cirrostratus halo',
+        description: 'A near-invisible veil over the whole sky. You notice it only because of the 22-degree ring around the sun.',
+        tags: ['veil', 'halo', 'thin', 'whole sky', 'ice ring'],
+        settings: {
+            altitude: 8800,
+            thickness: 900,
+            coverage: 0.95,
+            opticalDepth: 0.45,
+            featureSize: 70000,
+            anisotropy: 0.7,
+            windSpeed: 9,
+            halo: 2,
+        },
+    },
+    {
+        name: 'Jet streaks',
+        description: 'Extreme anisotropy — thin hard-drawn lines racing across the sky, almost contrail-like.',
+        tags: ['jet', 'fast', 'linear', 'sparse', 'sharp'],
+        settings: {
+            altitude: 10500,
+            thickness: 500,
+            coverage: 0.34,
+            opticalDepth: 1.1,
+            featureSize: 90000,
+            anisotropy: 0.045,
+            windSpeed: 42,
+            halo: 0.7,
+        },
+    },
+];
+// =============================================================================
+// Lookup
+// =============================================================================
+/** The five presets for one deck type, in the order they should appear. */
+export function getCloudPresetsForType(deckType) {
+    return volumetricCloudPresets.filter((p) => p.deckType === deckType);
+}
+export function getCloudPresetByName(name) {
+    return volumetricCloudPresets.find((p) => p.name === name);
+}
+export function getCirrusPresetByName(name) {
+    return cirrusPresets.find((p) => p.name === name);
+}
+export function searchCloudPresetsByTags(tags) {
+    const wanted = tags.map((t) => t.toLowerCase());
+    return volumetricCloudPresets.filter((p) => p.tags.some((t) => wanted.includes(t.toLowerCase())));
+}

package/dist/shaders/clouds/CirrusMaterial.d.ts

@@ -0,0 +1,84 @@
+import * as THREE from 'three';
+import { type ThreeElement } from '@react-three/fiber';
+export declare const cirrusDefaults: {
+    u_weather: any;
+    u_depth: any;
+    u_hasDepth: number;
+    u_time: number;
+    u_sunDir: THREE.Vector3;
+    u_sunColor: THREE.Color;
+    u_sunIntensity: number;
+    u_turbidity: number;
+    u_rayleigh: number;
+    u_mieCoefficient: number;
+    u_mieG: number;
+    u_skyAmbient: THREE.Color;
+    u_ambient: number;
+    u_sunIntensityScale: number;
+    u_altitude: number;
+    u_thickness: number;
+    u_coverage: number;
+    u_opticalDepth: number;
+    u_featureScale: number;
+    u_anisotropy: number;
+    u_windDir: THREE.Vector2;
+    u_windSpeed: number;
+    u_halo: number;
+    u_g1: number;
+    u_g2: number;
+    u_curvature: number;
+    u_fogDensity: number;
+    u_camPos: THREE.Vector3;
+    u_camFwd: THREE.Vector3;
+    u_invProj: THREE.Matrix4;
+    u_camWorld: THREE.Matrix4;
+    u_near: number;
+    u_far: number;
+    u_resolution: THREE.Vector2;
+    u_screenSpace: number;
+};
+export declare const CirrusMaterial: import("@react-three/fiber").ConstructorRepresentation<THREE.ShaderMaterial & {
+    u_weather: any;
+    u_depth: any;
+    u_hasDepth: number;
+    u_time: number;
+    u_sunDir: THREE.Vector3;
+    u_sunColor: THREE.Color;
+    u_sunIntensity: number;
+    u_turbidity: number;
+    u_rayleigh: number;
+    u_mieCoefficient: number;
+    u_mieG: number;
+    u_skyAmbient: THREE.Color;
+    u_ambient: number;
+    u_sunIntensityScale: number;
+    u_altitude: number;
+    u_thickness: number;
+    u_coverage: number;
+    u_opticalDepth: number;
+    u_featureScale: number;
+    u_anisotropy: number;
+    u_windDir: THREE.Vector2;
+    u_windSpeed: number;
+    u_halo: number;
+    u_g1: number;
+    u_g2: number;
+    u_curvature: number;
+    u_fogDensity: number;
+    u_camPos: THREE.Vector3;
+    u_camFwd: THREE.Vector3;
+    u_invProj: THREE.Matrix4;
+    u_camWorld: THREE.Matrix4;
+    u_near: number;
+    u_far: number;
+    u_resolution: THREE.Vector2;
+    u_screenSpace: number;
+}> & {
+    key: string;
+};
+declare module '@react-three/fiber' {
+    interface ThreeElements {
+        cirrusMaterial: ThreeElement<typeof CirrusMaterial>;
+    }
+}
+//# sourceMappingURL=CirrusMaterial.d.ts.map

package/dist/shaders/clouds/CirrusMaterial.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CirrusMaterial.d.ts","sourceRoot":"","sources":["../../../src/shaders/clouds/CirrusMaterial.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,OAAO,EAAU,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAkI9D,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwC1B,CAAA;AAED,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAmD,CAAA;AAI9E,OAAO,QAAQ,oBAAoB,CAAC;IAClC,UAAU,aAAa;QACrB,cAAc,EAAE,YAAY,CAAC,OAAO,cAAc,CAAC,CAAA;KACpD;CACF"}