@3driseai/3drise-viewer 0.1.7 → 0.1.8

package/dist/presets/terrainPresets.js

@@ -0,0 +1,293 @@
+// =============================================================================
+// Mountains
+// =============================================================================
+const mountainPresets = [
+    {
+        name: 'Alpine range',
+        terrainType: 'mountains',
+        description: 'Sharp granite ridges above a snow line, glaciated valleys between them. The default mountain.',
+        tags: ['snow', 'sharp', 'high', 'granite'],
+        settings: {
+            elevation: 1700, featureSize: 3800, octaves: 9, gain: 0.5,
+            ridgeSharpness: 0.68, warpStrength: 0.3, erosion: 0.75,
+            peakLevel: 0.7, peakBlend: 0.1, peakSlopeFalloff: 1.6,
+            lowColor: '#3c4a33', midColor: '#5b5a44', rockColor: '#6d6659', peakColor: '#f2f5fa',
+            slopeRockStart: 0.3, slopeRockEnd: 0.55,
+            aerialPerspective: 0.00005,
+        },
+    },
+    {
+        name: 'Foothills',
+        terrainType: 'mountains',
+        description: 'The approach rather than the summit: broad shoulders, forest colours, no snow.',
+        tags: ['low', 'green', 'gentle', 'approach'],
+        settings: {
+            elevation: 520, featureSize: 2400, octaves: 8, gain: 0.47,
+            ridgeSharpness: 0.4, warpStrength: 0.38, erosion: 0.6,
+            peakLevel: 0.92, peakBlend: 0.15,
+            lowColor: '#37461f', midColor: '#4c5730', rockColor: '#75695a', peakColor: '#8b9166',
+            slopeRockStart: 0.42, slopeRockEnd: 0.7,
+            aerialPerspective: 0.00009,
+        },
+    },
+    {
+        name: 'Volcanic',
+        terrainType: 'mountains',
+        description: 'Steep, dark and young. Little erosion, so the flanks stay smooth and the ridges stay raw.',
+        tags: ['dark', 'basalt', 'steep', 'ash'],
+        settings: {
+            elevation: 1300, featureSize: 3000, octaves: 8, gain: 0.54,
+            ridgeSharpness: 0.5, warpStrength: 0.16, erosion: 0.25,
+            peakLevel: 0.86, peakBlend: 0.06, peakSlopeFalloff: 2.2,
+            lowColor: '#2a2622', midColor: '#3a342e', rockColor: '#4a423a', peakColor: '#d8d4cc',
+            slopeRockStart: 0.22, slopeRockEnd: 0.45,
+            macroVariation: 0.34, roughness: 0.94, specular: 0.02,
+        },
+    },
+    {
+        name: 'Dolomite towers',
+        terrainType: 'mountains',
+        description: 'Pale limestone spires with banded walls. Strata on, sharpened hard.',
+        tags: ['limestone', 'towers', 'strata', 'pale'],
+        settings: {
+            elevation: 1250, featureSize: 2600, octaves: 9, gain: 0.55,
+            ridgeSharpness: 0.82, warpStrength: 0.22, erosion: 0.5,
+            terraces: 22, terraceSharpness: 0.85,
+            peakLevel: 0.74, peakBlend: 0.08,
+            lowColor: '#4a5238', midColor: '#7d7867', rockColor: '#b3ab9a', peakColor: '#eef0f4',
+            slopeRockStart: 0.22, slopeRockEnd: 0.42,
+        },
+    },
+    {
+        name: 'Eroded highlands',
+        terrainType: 'mountains',
+        description: 'Old, worn and wide. Erosion near maximum flattens the floors and leaves the ridges as fins.',
+        tags: ['old', 'worn', 'moorland', 'wide'],
+        settings: {
+            elevation: 800, featureSize: 5000, octaves: 10, gain: 0.44,
+            ridgeSharpness: 0.55, warpStrength: 0.46, erosion: 0.95,
+            peakLevel: 0.88, peakBlend: 0.22,
+            lowColor: '#454a2e', midColor: '#5e5a3d', rockColor: '#726a5c', peakColor: '#9aa07c',
+            slopeRockStart: 0.4, slopeRockEnd: 0.68,
+            macroVariation: 0.34, aerialPerspective: 0.00007,
+        },
+    },
+];
+// =============================================================================
+// Dunes
+// =============================================================================
+const dunePresets = [
+    {
+        name: 'Erg',
+        terrainType: 'dunes',
+        description: 'A full sand sea: tall transverse dunes, crest after crest to the horizon.',
+        tags: ['sahara', 'tall', 'transverse', 'sand sea'],
+        settings: {
+            elevation: 180, featureSize: 5200, duneWavelength: 420, duneAsymmetry: 0.7,
+            octaves: 6, gain: 0.44, warpStrength: 0.22,
+            lowColor: '#b08a53', midColor: '#dcb87e', peakColor: '#f4e2bc',
+            specular: 0.18, bounce: 0.6,
+        },
+    },
+    {
+        name: 'Barchan field',
+        terrainType: 'dunes',
+        description: 'Isolated crescent dunes on a hard desert floor. Low, widely spaced, strong slip faces.',
+        tags: ['crescent', 'sparse', 'low', 'hardpan'],
+        settings: {
+            elevation: 70, featureSize: 2800, duneWavelength: 260, duneAsymmetry: 0.88,
+            octaves: 6, gain: 0.38, warpStrength: 0.3,
+            lowColor: '#9c8360', midColor: '#c8a878', peakColor: '#e8d2a8',
+            macroVariation: 0.2, specular: 0.14,
+        },
+    },
+    {
+        name: 'Coastal dunes',
+        terrainType: 'dunes',
+        description: 'Low marram-held ridges behind a beach. Damp sand, so more sheen and cooler colour.',
+        tags: ['coast', 'low', 'damp', 'beach'],
+        settings: {
+            elevation: 34, featureSize: 1600, duneWavelength: 120, duneAsymmetry: 0.5,
+            octaves: 7, gain: 0.46, warpStrength: 0.4, ridgeSharpness: 0.1,
+            lowColor: '#a99b7c', midColor: '#cfc3a3', peakColor: '#e6dcc4',
+            roughness: 0.42, specular: 0.3, detailSize: 2.2, detailStrength: 0.4,
+            aerialPerspective: 0.00011,
+        },
+    },
+    {
+        name: 'Red desert',
+        terrainType: 'dunes',
+        description: 'Iron-stained linear dunes: long parallel ridges rather than a crescent field.',
+        tags: ['red', 'linear', 'outback', 'iron'],
+        settings: {
+            elevation: 120, featureSize: 8000, duneWavelength: 520, duneAsymmetry: 0.4,
+            octaves: 5, gain: 0.4, warpStrength: 0.1,
+            lowColor: '#8c3f22', midColor: '#c06334', rockColor: '#9c5029', peakColor: '#e09a5c',
+            macroVariation: 0.24, specular: 0.1,
+        },
+    },
+    {
+        name: 'Salt flat',
+        terrainType: 'dunes',
+        description: 'Almost nothing: a bright pan with the faintest relief. The reference for a flat, huge horizon.',
+        tags: ['flat', 'bright', 'playa', 'minimal'],
+        settings: {
+            elevation: 6, featureSize: 12000, duneWavelength: 900, duneAsymmetry: 0.1,
+            octaves: 5, gain: 0.42, warpStrength: 0.5, ridgeSharpness: 0,
+            lowColor: '#cfc9bc', midColor: '#e8e4da', peakColor: '#f8f6f1',
+            slopeRockStart: 0.8, slopeRockEnd: 0.95,
+            macroVariation: 0.16, roughness: 0.4, specular: 0.22,
+            aerialPerspective: 0.00013,
+        },
+    },
+];
+// =============================================================================
+// Hills
+// =============================================================================
+const hillPresets = [
+    {
+        name: 'Downland',
+        terrainType: 'hills',
+        description: 'Soft chalk hills under grass. Wide, rounded and calm — the friendly default.',
+        tags: ['grass', 'rounded', 'calm', 'pastoral'],
+        settings: {
+            elevation: 160, featureSize: 3000, octaves: 8, gain: 0.45,
+            ridgeSharpness: 0.02, warpStrength: 0.34, erosion: 0.4,
+            lowColor: '#3f5326', midColor: '#5b6b3c', peakColor: '#93a06a',
+        },
+    },
+    {
+        name: 'Steppe',
+        terrainType: 'hills',
+        description: 'Almost flat, very wide. Dry grass to the horizon with barely a fold in it.',
+        tags: ['flat', 'dry', 'wide', 'grassland'],
+        settings: {
+            elevation: 55, featureSize: 9000, octaves: 7, gain: 0.42,
+            ridgeSharpness: 0, warpStrength: 0.45, erosion: 0.35,
+            lowColor: '#6b6836', midColor: '#8a8047', peakColor: '#a89a63',
+            macroVariation: 0.36, aerialPerspective: 0.0001,
+        },
+    },
+    {
+        name: 'Moorland',
+        terrainType: 'hills',
+        description: 'Peat and heather over rough ground: darker, coarser and more broken than downland.',
+        tags: ['heather', 'peat', 'rough', 'dark'],
+        settings: {
+            elevation: 280, featureSize: 3400, octaves: 9, gain: 0.5,
+            ridgeSharpness: 0.18, warpStrength: 0.28, erosion: 0.62,
+            lowColor: '#3a3626', midColor: '#4f4630', rockColor: '#6b6455', peakColor: '#6e6444',
+            slopeRockStart: 0.42, slopeRockEnd: 0.68,
+            macroVariation: 0.4, detailStrength: 0.65,
+        },
+    },
+    {
+        name: 'Meadow valley',
+        terrainType: 'hills',
+        description: 'A single broad valley with soft shoulders. Heavy erosion gives it a real floor to stand on.',
+        tags: ['valley', 'green', 'floor', 'soft'],
+        settings: {
+            elevation: 220, featureSize: 5200, octaves: 8, gain: 0.43,
+            ridgeSharpness: 0.08, warpStrength: 0.5, erosion: 0.88,
+            lowColor: '#445a24', midColor: '#5d6f36', peakColor: '#8fa15f',
+            macroVariation: 0.3,
+        },
+    },
+    {
+        name: 'Tundra',
+        terrainType: 'hills',
+        description: 'Low frozen ground with snow settling in the hollows rather than on the tops.',
+        tags: ['cold', 'snow', 'low', 'arctic'],
+        settings: {
+            elevation: 130, featureSize: 4200, octaves: 8, gain: 0.44,
+            ridgeSharpness: 0.05, warpStrength: 0.36, erosion: 0.5,
+            lowColor: '#8e9299', midColor: '#6d6f66', rockColor: '#5f5d58', peakColor: '#eaf0f6',
+            peakLevel: 0.5, peakBlend: 0.28, peakSlopeFalloff: 0.8,
+            roughness: 0.6, specular: 0.12, ambient: 1.2,
+        },
+    },
+];
+// =============================================================================
+// Canyon
+// =============================================================================
+const canyonPresets = [
+    {
+        name: 'Red canyon',
+        terrainType: 'canyon',
+        description: 'Banded sandstone walls above a branching network of washes. The default canyon.',
+        tags: ['sandstone', 'red', 'strata', 'network'],
+        settings: {
+            elevation: 700, featureSize: 2800, plateau: 0.55, valleyDepth: 0.8, valleyWidth: 0.22,
+            terraces: 14, terraceSharpness: 0.72, erosion: 0.85,
+            lowColor: '#7a4a30', midColor: '#a4643c', rockColor: '#c07a4a', peakColor: '#d9a877',
+        },
+    },
+    {
+        name: 'Slot canyon',
+        terrainType: 'canyon',
+        description: 'A narrow deep cut in an almost flat plateau. Incision at its narrowest and deepest.',
+        tags: ['narrow', 'deep', 'slot', 'antelope'],
+        settings: {
+            elevation: 420, featureSize: 3200, plateau: 0.85, valleyDepth: 1.25, valleyWidth: 0.07,
+            terraces: 20, terraceSharpness: 0.9, erosion: 0.7, octaves: 9,
+            lowColor: '#6b3a22', midColor: '#a35a2c', rockColor: '#cf8348', peakColor: '#c9a06a',
+            shadowSoftness: 5,
+        },
+    },
+    {
+        name: 'Mesa country',
+        terrainType: 'canyon',
+        description: 'Flat-topped tables standing above a wide desert floor, cut well apart from each other.',
+        tags: ['mesa', 'butte', 'flat top', 'monument'],
+        settings: {
+            elevation: 620, featureSize: 4200, plateau: 0.95, valleyDepth: 1.1, valleyWidth: 0.55,
+            terraces: 10, terraceSharpness: 0.95, erosion: 0.9, ridgeSharpness: 0.2,
+            lowColor: '#8a5a3a', midColor: '#b0703f', rockColor: '#c9834c', peakColor: '#e0b184',
+            slopeRockStart: 0.2, slopeRockEnd: 0.38,
+            aerialPerspective: 0.00007,
+        },
+    },
+    {
+        name: 'Badlands',
+        terrainType: 'canyon',
+        description: 'Densely dissected, chaotic and low. Almost all wall and almost no floor.',
+        tags: ['dissected', 'chaotic', 'low', 'clay'],
+        settings: {
+            elevation: 240, featureSize: 1800, plateau: 0.4, valleyDepth: 0.9, valleyWidth: 0.42,
+            terraces: 26, terraceSharpness: 0.6, erosion: 0.55, octaves: 10, ridgeSharpness: 0.45,
+            lowColor: '#6e6252', midColor: '#94836a', rockColor: '#ab9a80', peakColor: '#c9bda4',
+            macroVariation: 0.34,
+        },
+    },
+    {
+        name: 'Grand gorge',
+        terrainType: 'canyon',
+        description: 'One enormous incision across a high plateau, layered from rim to river. Built for the horizon.',
+        tags: ['huge', 'layered', 'rim', 'grand'],
+        settings: {
+            elevation: 1600, featureSize: 9000, plateau: 0.75, valleyDepth: 1.35, valleyWidth: 0.3,
+            terraces: 30, terraceSharpness: 0.8, erosion: 0.92, octaves: 10,
+            lowColor: '#6a4130', midColor: '#9a5f3c', rockColor: '#bd7c4e', peakColor: '#d4ab80',
+            aerialPerspective: 0.00007,
+        },
+    },
+];
+// =============================================================================
+// Registry
+// =============================================================================
+export const terrainPresets = [
+    ...mountainPresets,
+    ...dunePresets,
+    ...hillPresets,
+    ...canyonPresets,
+];
+export function getTerrainPresetsForType(type) {
+    return terrainPresets.filter((p) => p.terrainType === type);
+}
+export function getTerrainPresetByName(name) {
+    return terrainPresets.find((p) => p.name === name);
+}
+export function searchTerrainPresetsByTags(tags) {
+    const wanted = tags.map((t) => t.toLowerCase());
+    return terrainPresets.filter((p) => p.tags.some((t) => wanted.includes(t.toLowerCase())));
+}

package/dist/presets/volumetricCloudPresets.d.ts

@@ -0,0 +1,38 @@
+import type { CirrusLayerConfig, CloudDeckSurfaceConfig, CloudDeckType } from '../types/cloudConfigs';
+/**
+ * Presets for the volumetric cloud system.
+ *
+ * They live here rather than in core/src/presets because they are partial
+ * CloudDeckConfig / CirrusLayerConfig, and those types are declared in this
+ * package alongside the shader that consumes them.
+ *
+ * Each entry is a *patch* over the type's defaults, not a full config, so a knob
+ * added to the renderer inherits its default everywhere instead of silently
+ * reverting to whatever a preset happened to be authored with.
+ *
+ * The names are the meteorological species, because they are the fastest way to
+ * describe a silhouette to someone who has looked at a sky: humilis really is a
+ * flat little puff, congestus really is a tower, fractus really is a torn shred.
+ */
+export interface VolumetricCloudPreset {
+    name: string;
+    /** Which deck type the preset belongs to. */
+    deckType: CloudDeckType;
+    description: string;
+    tags: string[];
+    settings: Partial<CloudDeckSurfaceConfig>;
+}
+export interface CirrusPreset {
+    name: string;
+    description: string;
+    tags: string[];
+    settings: Partial<CirrusLayerConfig>;
+}
+export declare const volumetricCloudPresets: VolumetricCloudPreset[];
+export declare const cirrusPresets: CirrusPreset[];
+/** The five presets for one deck type, in the order they should appear. */
+export declare function getCloudPresetsForType(deckType: CloudDeckType): VolumetricCloudPreset[];
+export declare function getCloudPresetByName(name: string): VolumetricCloudPreset | undefined;
+export declare function getCirrusPresetByName(name: string): CirrusPreset | undefined;
+export declare function searchCloudPresetsByTags(tags: string[]): VolumetricCloudPreset[];
+//# sourceMappingURL=volumetricCloudPresets.d.ts.map

package/dist/presets/volumetricCloudPresets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"volumetricCloudPresets.d.ts","sourceRoot":"","sources":["../../src/presets/volumetricCloudPresets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,iBAAiB,EACjB,sBAAsB,EACtB,aAAa,EAChB,MAAM,uBAAuB,CAAC;AAE/B;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,qBAAqB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,QAAQ,EAAE,aAAa,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC,sBAAsB,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,YAAY;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACxC;AAiYD,eAAO,MAAM,sBAAsB,EAAE,qBAAqB,EAIzD,CAAC;AAMF,eAAO,MAAM,aAAa,EAAE,YAAY,EA6EvC,CAAC;AAMF,2EAA2E;AAC3E,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,aAAa,GAAG,qBAAqB,EAAE,CAEvF;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS,CAEpF;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAE5E;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,qBAAqB,EAAE,CAKhF"}