@zephyr3d/scene 0.9.25 → 0.9.27

package/dist/utility/serialization/scene/water.js

@@ -1,6 +1,6 @@
-import { Vector2 } from '@zephyr3d/base';
+import { Vector2, Vector3 } from '@zephyr3d/base';
 import '../../../scene/scene.js';
-import '../../../values.js';
+import { MAX_GERSTNER_WAVE_COUNT } from '../../../values.js';
 import '../../../render/render_queue.js';
 import '../../../render/primitive.js';
 import '@zephyr3d/device';
@@ -11,7 +11,10 @@ import '../../../material/unlit.js';
 import '../../../material/particle.js';
 import '../../../material/subsurfaceprofile.js';
 import '../../../material/skin.js';
+import '../../../material/eye.js';
 import '../../../material/meshmaterial.js';
+import '../../../material/hair.js';
+import '../../../material/hairstrand.js';
 import '../../../material/grassmaterial.js';
 import '../../../material/terrain-cm.js';
 import '../../../material/pbrmr.js';
@@ -29,6 +32,7 @@ import '../../../render/clipmap.js';
 import '../../../render/envlight.js';
 import '../../../render/dualdepthpeeling_oit.js';
 import { FFTWaveGenerator } from '../../../render/fft_wavegenerator.js';
+import { GerstnerWaveGenerator } from '../../../render/gerstner_wavegenerator.js';
 import { FBMWaveGenerator } from '../../../render/fbm_wavegenerator.js';
 import '../../../render/rendergraph/scene_render_context.js';
 import { GraphNode } from '../../../scene/graph_node.js';
@@ -38,12 +42,14 @@ import '../../../scene/meshdrawable.js';
 import '../../../scene/basesprite.js';
 import '../../../material/msdf_text.js';
 import { Water } from '../../../scene/water.js';
+import '../../../scene/hair.js';
 import '../../../scene/scene_node.js';
 import '../../../scene/particlesys.js';
 import '../../../scene/batchgroup.js';
 import '../../../scene/terrain-cm/terrain-cm.js';
 import '../../../scene/terrain-cm/grass.js';
 import '../../../scene/raycast_visitor.js';
+import { WATER_DEBUG_OUTPUTS, DEFAULT_SCATTER_ANISOTROPY } from '../../../material/water.js';
 
 /** @internal */ function getFBMWaveGeneratorClass() {
     return {
@@ -274,6 +280,345 @@ import '../../../scene/raycast_visitor.js';
         }
     };
 }
+/** @internal */ function getGerstnerWaveGeneratorClass() {
+    return {
+        ctor: GerstnerWaveGenerator,
+        name: 'GerstnerWaveGenerator',
+        getProps () {
+            return defineProps([
+                {
+                    name: 'NumWaves',
+                    description: 'Number of independent Gerstner waves summed to form the surface',
+                    type: 'int',
+                    options: {
+                        minValue: 1,
+                        maxValue: MAX_GERSTNER_WAVE_COUNT
+                    },
+                    get (value) {
+                        value.num[0] = this.numWaves;
+                    },
+                    set (value) {
+                        this.numWaves = value.num[0];
+                    }
+                },
+                {
+                    name: 'Waves',
+                    description: 'Per-wave parameters, one entry per wave in NumWaves order',
+                    type: 'object_array',
+                    options: {
+                        objectTypes: [
+                            GerstnerWave
+                        ]
+                    },
+                    get (value) {
+                        value.object = [];
+                        for(let i = 0; i < this.numWaves; i++){
+                            const wave = new GerstnerWave();
+                            wave.bind(this, i);
+                            value.object.push(wave);
+                        }
+                    },
+                    set (value) {
+                        const waves = value.object;
+                        // The wave count is ground truth for how many slots the shader
+                        // reads. NumWaves and Waves are applied concurrently during
+                        // deserialization, so this setter must leave the generator in the
+                        // state this array implies regardless of which one runs first.
+                        this.numWaves = waves.length;
+                        for(let i = 0; i < waves.length; i++){
+                            waves[i].applyTo(this, i);
+                        }
+                    },
+                    add (value, index) {
+                        const wave = value?.object?.[0];
+                        const insertAt = index ?? this.numWaves;
+                        this.insertWave(insertAt);
+                        wave?.applyTo(this, insertAt);
+                    },
+                    delete (index) {
+                        this.deleteWave(index);
+                    }
+                },
+                {
+                    name: 'FoamWidth',
+                    description: 'Width of foam bands generated on the wave crests',
+                    type: 'float',
+                    default: 1.2,
+                    options: {
+                        animatable: true,
+                        minValue: 0,
+                        maxValue: 10
+                    },
+                    get (value) {
+                        value.num[0] = this.foamWidth;
+                    },
+                    set (value) {
+                        this.foamWidth = value.num[0];
+                    }
+                },
+                {
+                    name: 'FoamContrast',
+                    description: 'Contrast of the foam pattern on Gerstner waves',
+                    type: 'float',
+                    default: 7.2,
+                    options: {
+                        animatable: true,
+                        minValue: 0,
+                        maxValue: 10
+                    },
+                    get (value) {
+                        value.num[0] = this.foamContrast;
+                    },
+                    set (value) {
+                        this.foamContrast = value.num[0];
+                    }
+                }
+            ]);
+        }
+    };
+}
+/**
+ * A single Gerstner wave, as the editor sees one entry of the
+ * `Waves` object array on a {@link GerstnerWaveGenerator}.
+ *
+ * It behaves as a live view while it is bound: the field setters write the new
+ * value straight through to the generator's wave buffer, which is what makes an
+ * edit in the property panel take effect on the water immediately. Without that
+ * the editor would only touch this object's own fields and the surface would
+ * keep the previous wave until something else bumped the generator's version.
+ *
+ * The binding is transient and scoped to one editor session: `_owner` and
+ * `_index` are set when the `Waves` getter builds the entry, and the editor
+ * rebuilds the whole array from that getter after every add/delete. A copy that
+ * survives a list mutation is never reused, so the cached index cannot drift
+ * onto a different wave - the same reason it is safe to write through with it.
+ */ class GerstnerWave {
+    _owner;
+    _index;
+    _direction;
+    _steepness;
+    _amplitude;
+    _length;
+    _omni;
+    _originX;
+    _originZ;
+    constructor(){
+        this._owner = null;
+        this._index = -1;
+        this._direction = 0;
+        this._steepness = 0;
+        this._amplitude = 0;
+        this._length = 1;
+        this._omni = false;
+        this._originX = 0;
+        this._originZ = 0;
+    }
+    /**
+   * Binds this entry to a slot of `owner`, so the field setters write through
+   * to the generator. Called by the `Waves` getter and by `add`; the index is
+   * the slot the entry currently represents.
+   * @internal
+   */ bind(owner, index) {
+        this._owner = owner;
+        this._index = index;
+        this.loadFromOwner(owner, index);
+    }
+    /**
+   * Copies the values in slot `index` of `owner` into this object, refreshing
+   * the cached fields without writing back.
+   * @internal
+   */ loadFromOwner(owner, index) {
+        this._direction = owner.getWaveDirection(index);
+        this._steepness = owner.getWaveSteepness(index);
+        this._amplitude = owner.getWaveAmplitude(index);
+        this._length = owner.getWaveLength(index);
+        this._omni = owner.isOmniWave(index);
+        this._originX = owner.getOriginX(index);
+        this._originZ = owner.getOriginZ(index);
+    }
+    /**
+   * Writes this object's values into slot `index` of `owner`, unconditionally.
+   *
+   * Used by the `Waves` setter for a serialised-in array, whose entries were
+   * constructed without an owner, and by `add` for a freshly created one. It is
+   * distinct from the write-through in the field setters, which fire on each
+   * individual edit.
+   * @internal
+   */ applyTo(owner, index) {
+        owner.setWaveDirection(index, this._direction);
+        owner.setWaveSteepness(index, this._steepness);
+        owner.setWaveAmplitude(index, this._amplitude);
+        owner.setWaveLength(index, this._length);
+        owner.setOmniWave(index, this._omni);
+        owner.setOrigin(index, this._originX, this._originZ);
+        this._owner = owner;
+        this._index = index;
+    }
+    /** @internal */ writethrough(setter, val) {
+        const owner = this._owner;
+        if (owner) {
+            setter(owner, this._index, val);
+        }
+    }
+    /** Gets the wave direction angle in radians. */ get direction() {
+        return this._direction;
+    }
+    set direction(val) {
+        this._direction = val;
+        this.writethrough((o, i, v)=>o.setWaveDirection(i, v), val);
+    }
+    /** Gets the wave steepness. */ get steepness() {
+        return this._steepness;
+    }
+    set steepness(val) {
+        this._steepness = val;
+        this.writethrough((o, i, v)=>o.setWaveSteepness(i, v), val);
+    }
+    /** Gets the wave amplitude. */ get amplitude() {
+        return this._amplitude;
+    }
+    set amplitude(val) {
+        this._amplitude = val;
+        this.writethrough((o, i, v)=>o.setWaveAmplitude(i, v), val);
+    }
+    /** Gets the wave length in meters. */ get length() {
+        return this._length;
+    }
+    set length(val) {
+        this._length = val;
+        this.writethrough((o, i, v)=>o.setWaveLength(i, v), val);
+    }
+    /** Gets whether the wave is omni-directional. */ get omni() {
+        return this._omni;
+    }
+    set omni(val) {
+        this._omni = val;
+        if (this._owner) {
+            this._owner.setOmniWave(this._index, val);
+        }
+    }
+    /** Gets the origin X of an omni-directional wave. */ get originX() {
+        return this._originX;
+    }
+    set originX(val) {
+        this._originX = val;
+        if (this._owner) {
+            this._owner.setOrigin(this._index, val, this._originZ);
+        }
+    }
+    /** Gets the origin Z of an omni-directional wave. */ get originZ() {
+        return this._originZ;
+    }
+    set originZ(val) {
+        this._originZ = val;
+        if (this._owner) {
+            this._owner.setOrigin(this._index, this._originX, val);
+        }
+    }
+}
+/** @internal */ function getGerstnerWaveClass() {
+    return {
+        ctor: GerstnerWave,
+        name: 'GerstnerWave',
+        getProps () {
+            return defineProps([
+                {
+                    name: 'Direction',
+                    description: 'Wave direction angle in radians',
+                    type: 'float',
+                    options: {
+                        animatable: true,
+                        minValue: -3.14,
+                        maxValue: 3.14
+                    },
+                    get (value) {
+                        value.num[0] = this.direction;
+                    },
+                    set (value) {
+                        this.direction = value.num[0];
+                    }
+                },
+                {
+                    name: 'Steepness',
+                    description: 'Wave steepness. The sum of steepness across waves sets how sharply crests fold',
+                    type: 'float',
+                    options: {
+                        animatable: true,
+                        minValue: 0,
+                        maxValue: 2
+                    },
+                    get (value) {
+                        value.num[0] = this.steepness;
+                    },
+                    set (value) {
+                        this.steepness = value.num[0];
+                    }
+                },
+                {
+                    name: 'Amplitude',
+                    description: 'Wave height amplitude',
+                    type: 'float',
+                    options: {
+                        animatable: true,
+                        minValue: 0,
+                        maxValue: 5
+                    },
+                    get (value) {
+                        value.num[0] = this.amplitude;
+                    },
+                    set (value) {
+                        this.amplitude = value.num[0];
+                    }
+                },
+                {
+                    name: 'Length',
+                    description: 'Wave length in meters',
+                    type: 'float',
+                    options: {
+                        animatable: true,
+                        minValue: 0,
+                        maxValue: 100
+                    },
+                    get (value) {
+                        value.num[0] = this.length;
+                    },
+                    set (value) {
+                        this.length = value.num[0];
+                    }
+                },
+                {
+                    name: 'Omni',
+                    description: 'If true, radiates outward from an origin rather than travelling in one direction',
+                    type: 'bool',
+                    get (value) {
+                        value.bool[0] = this.omni;
+                    },
+                    set (value) {
+                        this.omni = value.bool[0];
+                    }
+                },
+                {
+                    name: 'Origin',
+                    description: 'Origin of an omni-directional wave, ignored by directional waves',
+                    type: 'vec2',
+                    options: {
+                        animatable: true,
+                        minValue: -1e3,
+                        maxValue: 1000
+                    },
+                    get (value) {
+                        value.num[0] = this.originX;
+                        value.num[1] = this.originZ;
+                    },
+                    set (value) {
+                        this.originX = value.num[0];
+                        this.originZ = value.num[1];
+                    }
+                }
+            ]);
+        }
+    };
+}
 /** @internal */ function getWaterClass(manager) {
     return {
         ctor: Water,
@@ -296,7 +641,8 @@ import '../../../scene/raycast_visitor.js';
                     options: {
                         objectTypes: [
                             FFTWaveGenerator,
-                            FBMWaveGenerator
+                            FBMWaveGenerator,
+                            GerstnerWaveGenerator
                         ]
                     },
                     isNullable () {
@@ -359,53 +705,791 @@ import '../../../scene/raycast_visitor.js';
                     }
                 },
                 {
-                    name: 'DepthScale',
-                    description: 'Depth attenuation scale for the water material',
+                    name: 'Infinite',
+                    description: 'Draw the surface as an unbounded ocean reaching the horizon instead of a body of water ending at the node extent. Reaches the horizon without enlarging the camera far plane, so near-scene depth precision is unaffected. Leave off for ponds, lakes and pools, which have an edge.',
+                    type: 'bool',
+                    default: false,
+                    get (value) {
+                        value.bool[0] = this.infinite;
+                    },
+                    set (value) {
+                        this.infinite = value.bool[0];
+                    }
+                },
+                {
+                    name: 'ViewDistance',
+                    description: 'How far the surface is built out from the camera, in meters, or 0 to derive it from the true horizon distance for the camera height. Keep the sky AerialPerspectiveDistance at least this large, or the far water stops converging towards the sky colour and the hard band comes back.',
                     type: 'float',
-                    default: 10,
+                    default: 0,
+                    options: {
+                        minValue: 0,
+                        maxValue: 100000
+                    },
+                    isHidden () {
+                        return !this.infinite;
+                    },
+                    get (value) {
+                        value.num[0] = this.viewDistance;
+                    },
+                    set (value) {
+                        this.viewDistance = value.num[0];
+                    }
+                },
+                {
+                    name: 'CausticsEnabled',
+                    description: 'Whether the water projects caustics onto the geometry below it',
+                    type: 'bool',
+                    default: true,
+                    get (value) {
+                        value.bool[0] = this.causticsEnabled;
+                    },
+                    set (value) {
+                        this.causticsEnabled = value.bool[0];
+                    }
+                },
+                {
+                    name: 'CausticsIntensity',
+                    description: 'Strength of the caustic contrast',
+                    type: 'float',
+                    default: 1,
                     options: {
                         animatable: true,
                         minValue: 0,
+                        maxValue: 5
+                    },
+                    isHidden () {
+                        return !this.causticsEnabled;
+                    },
+                    get (value) {
+                        value.num[0] = this.causticsIntensity;
+                    },
+                    set (value) {
+                        this.causticsIntensity = value.num[0];
+                    }
+                },
+                {
+                    name: 'CausticsDepth',
+                    description: 'Depth in meters below the surface where the caustics are in focus',
+                    type: 'float',
+                    default: 4,
+                    options: {
+                        animatable: true,
+                        minValue: 0.01,
                         maxValue: 100
                     },
+                    isHidden () {
+                        return !this.causticsEnabled;
+                    },
                     get (value) {
-                        value.num[0] = this.material.depthMulti;
+                        value.num[0] = this.causticsDepth;
                     },
                     set (value) {
-                        this.material.depthMulti = value.num[0];
+                        this.causticsDepth = value.num[0];
+                    }
+                },
+                {
+                    name: 'CausticsRange',
+                    description: 'Furthest distance in meters from the camera the caustic map reaches',
+                    type: 'float',
+                    default: 4,
+                    options: {
+                        minValue: 1,
+                        maxValue: 1000
+                    },
+                    isHidden () {
+                        return !this.causticsEnabled;
+                    },
+                    get (value) {
+                        value.num[0] = this.causticsRange;
+                    },
+                    set (value) {
+                        this.causticsRange = value.num[0];
                     }
                 },
                 {
-                    name: 'RefractionStrength',
-                    description: 'Strength of underwater refraction',
+                    name: 'CausticsFadeDistance',
+                    description: 'Width in meters the caustics fade out over at the edge of the map, or 0 to derive it from the range',
                     type: 'float',
                     default: 0,
+                    options: {
+                        minValue: 0,
+                        maxValue: 100
+                    },
+                    isHidden () {
+                        return !this.causticsEnabled;
+                    },
+                    get (value) {
+                        value.num[0] = this.causticsFadeDistance;
+                    },
+                    set (value) {
+                        this.causticsFadeDistance = value.num[0];
+                    }
+                },
+                {
+                    name: 'CausticsSceneDepth',
+                    description: 'Land caustics on the scene instead of on a plane at CausticsDepth. Reuses the sun shadow cascade, so it costs no extra geometry pass; WebGL2 keeps the plane, which its shadow map format cannot avoid.',
+                    type: 'bool',
+                    default: true,
+                    get (value) {
+                        value.bool[0] = this.causticsSceneDepth;
+                    },
+                    set (value) {
+                        this.causticsSceneDepth = value.bool[0];
+                    }
+                },
+                {
+                    name: 'CausticsWarp',
+                    description: 'How strongly caustic map texels are concentrated near the camera; ignored while the map already fits the water within range',
+                    type: 'float',
+                    default: 1.5,
+                    options: {
+                        minValue: 0,
+                        maxValue: 8
+                    },
+                    isHidden () {
+                        return !this.causticsEnabled;
+                    },
+                    get (value) {
+                        value.num[0] = this.causticsWarp;
+                    },
+                    set (value) {
+                        this.causticsWarp = value.num[0];
+                    }
+                },
+                {
+                    name: 'UnderwaterEnabled',
+                    description: 'Whether a camera inside this water sees it from the inside: the medium over the whole scene, the sky replaced by water, and the surface read from below with its Snell window. Atmospheric fog is suppressed while submerged.',
+                    type: 'bool',
+                    default: true,
+                    get (value) {
+                        value.bool[0] = this.underwaterEnabled;
+                    },
+                    set (value) {
+                        this.underwaterEnabled = value.bool[0];
+                    }
+                },
+                {
+                    name: 'UnderwaterAmbientIntensity',
+                    description: 'Scale on the downwelling sky light filling the water column. This is what the water fades to in the distance, so it sets how bright the underwater haze reads.',
+                    type: 'float',
+                    default: 1,
                     options: {
                         animatable: true,
                         minValue: 0,
-                        maxValue: 1
+                        maxValue: 5
+                    },
+                    isHidden () {
+                        return !this.underwaterEnabled;
+                    },
+                    get (value) {
+                        value.num[0] = this.underwaterAmbientIntensity;
+                    },
+                    set (value) {
+                        this.underwaterAmbientIntensity = value.num[0];
+                    }
+                },
+                {
+                    name: 'UnderwaterGodRays',
+                    description: 'Whether shafts of sunlight are marched through the water column. Reads the caustic map as the surface transmittance, so the shafts carry the pattern that lands on the sea bed; needs CausticsEnabled.',
+                    type: 'bool',
+                    default: true,
+                    isHidden () {
+                        return !this.underwaterEnabled;
                     },
                     get (value) {
-                        value.num[0] = this.material.refractionStrength;
+                        value.bool[0] = this.underwaterGodRays;
                     },
                     set (value) {
-                        this.material.refractionStrength = value.num[0];
+                        this.underwaterGodRays = value.bool[0];
                     }
                 },
                 {
-                    name: 'Displace',
-                    description: 'Vertex displacement scale for water waves',
+                    name: 'UnderwaterGodRayIntensity',
+                    description: 'Strength of the light shafts, 1 for the value the medium implies',
                     type: 'float',
-                    default: 16,
+                    default: 1,
                     options: {
-                        minValue: 1,
-                        maxValue: 256
+                        animatable: true,
+                        minValue: 0,
+                        maxValue: 5
+                    },
+                    isHidden () {
+                        return !this.underwaterEnabled || !this.underwaterGodRays;
+                    },
+                    get (value) {
+                        value.num[0] = this.underwaterGodRayIntensity;
+                    },
+                    set (value) {
+                        this.underwaterGodRayIntensity = value.num[0];
+                    }
+                },
+                {
+                    name: 'UnderwaterGodRaySteps',
+                    description: 'Samples taken along each view ray for the light shafts. Raise it when the shafts read as grain rather than as beams.',
+                    type: 'int',
+                    default: 24,
+                    options: {
+                        minValue: 4,
+                        maxValue: 96
+                    },
+                    isHidden () {
+                        return !this.underwaterEnabled || !this.underwaterGodRays;
+                    },
+                    get (value) {
+                        value.num[0] = this.underwaterGodRaySteps;
+                    },
+                    set (value) {
+                        this.underwaterGodRaySteps = value.num[0];
+                    }
+                },
+                {
+                    name: 'UnderwaterGodRayShadow',
+                    description: 'Whether geometry standing in the water breaks the light shafts. The shafts come from the caustic map, which knows only what the surface did to the sunlight, so without this a shaft runs straight through a piling. Costs a shadow map lookup per march step.',
+                    type: 'bool',
+                    default: false,
+                    isHidden () {
+                        return !this.underwaterEnabled || !this.underwaterGodRays;
+                    },
+                    get (value) {
+                        value.bool[0] = this.underwaterGodRayShadow;
+                    },
+                    set (value) {
+                        this.underwaterGodRayShadow = value.bool[0];
+                    }
+                },
+                {
+                    name: 'UnderwaterHysteresis',
+                    description: 'Half-width in meters of the dead band around the surface the submerged test uses, so a camera at water level does not flip state every frame',
+                    type: 'float',
+                    default: 0.05,
+                    options: {
+                        minValue: 0,
+                        maxValue: 2
+                    },
+                    isHidden () {
+                        return !this.underwaterEnabled;
+                    },
+                    get (value) {
+                        value.num[0] = this.underwaterHysteresis;
+                    },
+                    set (value) {
+                        this.underwaterHysteresis = value.num[0];
+                    }
+                },
+                {
+                    name: 'MediumMode',
+                    description: 'How the water medium attenuates light: physical coefficients, or the legacy ramp textures',
+                    type: 'string',
+                    default: 'physical',
+                    options: {
+                        enum: {
+                            labels: [
+                                'Physical',
+                                'Ramp'
+                            ],
+                            values: [
+                                'physical',
+                                'ramp'
+                            ]
+                        }
+                    },
+                    get (value) {
+                        value.str[0] = this.material.mediumMode;
+                    },
+                    set (value) {
+                        this.material.mediumMode = value.str[0];
+                    }
+                },
+                {
+                    name: 'RefractionMode',
+                    description: 'How the refracted view sample is located. March walks the refracted ray against the scene depth and samples where it lands, which keeps the sample on the object behind the water; Offset skips the search and displaces the screen UV by the wave normal, which costs no depth fetches but samples the wrong point. Use Offset on hardware that cannot afford the search.',
+                    type: 'string',
+                    default: 'march',
+                    options: {
+                        enum: {
+                            labels: [
+                                'March (accurate)',
+                                'Offset (cheap)'
+                            ],
+                            values: [
+                                'march',
+                                'offset'
+                            ]
+                        }
+                    },
+                    get (value) {
+                        value.str[0] = this.material.refractionMode;
+                    },
+                    set (value) {
+                        this.material.refractionMode = value.str[0];
+                    }
+                },
+                {
+                    name: 'DebugOutput',
+                    description: 'Debugging aid: replaces the water colour with one of the shading terms it is built from, so a broken term can be identified by eye',
+                    type: 'string',
+                    default: 'none',
+                    options: {
+                        enum: {
+                            labels: WATER_DEBUG_OUTPUTS.map((e)=>e.label),
+                            values: WATER_DEBUG_OUTPUTS.map((e)=>e.value)
+                        }
+                    },
+                    get (value) {
+                        value.str[0] = this.debugOutput;
+                    },
+                    set (value) {
+                        this.debugOutput = value.str[0];
+                    }
+                },
+                {
+                    name: 'Absorption',
+                    description: 'Absorption coefficient sigma_a of the water medium, per meter, per channel',
+                    type: 'rgb',
+                    default: [
+                        1.0,
+                        0.25,
+                        0.15
+                    ],
+                    options: {
+                        animatable: true,
+                        minValue: 0,
+                        maxValue: 10
+                    },
+                    isHidden () {
+                        return this.material.mediumMode !== 'physical';
+                    },
+                    get (value) {
+                        value.num[0] = this.material.absorption.x;
+                        value.num[1] = this.material.absorption.y;
+                        value.num[2] = this.material.absorption.z;
+                    },
+                    set (value) {
+                        this.material.absorption = new Vector3(value.num[0], value.num[1], value.num[2]);
+                    }
+                },
+                {
+                    name: 'AbsorptionScale',
+                    description: 'Scale for the absorption coefficient',
+                    type: 'float',
+                    default: 1,
+                    options: {
+                        animatable: true,
+                        minValue: 0,
+                        maxValue: 10
+                    },
+                    isHidden () {
+                        return this.material.mediumMode !== 'physical';
+                    },
+                    get (value) {
+                        value.num[0] = this.material.absorptionScale;
+                    },
+                    set (value) {
+                        this.material.absorptionScale = value.num[0];
+                    }
+                },
+                {
+                    name: 'Scattering',
+                    description: 'Scattering coefficient sigma_s of the water medium, per meter, per channel',
+                    type: 'rgb',
+                    default: [
+                        0.05,
+                        0.12,
+                        0.18
+                    ],
+                    options: {
+                        animatable: true,
+                        minValue: 0,
+                        maxValue: 10
+                    },
+                    isHidden () {
+                        return this.material.mediumMode !== 'physical';
+                    },
+                    get (value) {
+                        value.num[0] = this.material.scattering.x;
+                        value.num[1] = this.material.scattering.y;
+                        value.num[2] = this.material.scattering.z;
+                    },
+                    set (value) {
+                        this.material.scattering = new Vector3(value.num[0], value.num[1], value.num[2]);
+                    }
+                },
+                {
+                    name: 'ScatteringScale',
+                    description: 'Scale for the scattering coefficient',
+                    type: 'float',
+                    default: 1,
+                    options: {
+                        animatable: true,
+                        minValue: 0,
+                        maxValue: 10
+                    },
+                    isHidden () {
+                        return this.material.mediumMode !== 'physical';
+                    },
+                    get (value) {
+                        value.num[0] = this.material.scatteringScale;
+                    },
+                    set (value) {
+                        this.material.scatteringScale = value.num[0];
+                    }
+                },
+                {
+                    name: 'DepthScale',
+                    description: 'Depth attenuation scale for the water material (ramp medium only)',
+                    type: 'float',
+                    default: 10,
+                    options: {
+                        animatable: true,
+                        minValue: 0,
+                        maxValue: 100
+                    },
+                    isHidden () {
+                        return this.material.mediumMode !== 'ramp';
+                    },
+                    get (value) {
+                        value.num[0] = this.material.depthMulti;
+                    },
+                    set (value) {
+                        this.material.depthMulti = value.num[0];
+                    }
+                },
+                {
+                    name: 'ReflectionStrength',
+                    description: 'Scale on the Fresnel reflectance, 1 for the physical value. Lower it to trade the reflection away and show more of what is beneath the surface.',
+                    type: 'float',
+                    default: 1,
+                    options: {
+                        animatable: true,
+                        minValue: 0,
+                        maxValue: 1
+                    },
+                    get (value) {
+                        value.num[0] = this.material.reflectionStrength;
+                    },
+                    set (value) {
+                        this.material.reflectionStrength = value.num[0];
+                    }
+                },
+                {
+                    name: 'SubsurfaceIntensity',
+                    description: 'Strength of the sunlight scattered forward through a wave crest, which is what makes a backlit crest glow. Grazing views of a low sun show it; looking down at the water does not.',
+                    type: 'float',
+                    default: 1.5,
+                    options: {
+                        animatable: true,
+                        minValue: 0,
+                        maxValue: 10
+                    },
+                    get (value) {
+                        value.num[0] = this.material.subsurfaceIntensity;
+                    },
+                    set (value) {
+                        this.material.subsurfaceIntensity = value.num[0];
+                    }
+                },
+                {
+                    name: 'SubsurfaceSteepness',
+                    description: 'How sharply surface tilt gates the subsurface glow. Higher makes gentle swell glow too; lower restricts it to steep wave flanks.',
+                    type: 'float',
+                    default: 60,
+                    options: {
+                        animatable: true,
+                        minValue: 0,
+                        maxValue: 100
+                    },
+                    get (value) {
+                        value.num[0] = this.material.subsurfaceSteepness;
+                    },
+                    set (value) {
+                        this.material.subsurfaceSteepness = value.num[0];
+                    }
+                },
+                {
+                    name: 'SunScatteringIntensity',
+                    description: 'Strength of the sunlight scattered out of the water column towards the eye, 1 for the value the medium coefficients imply. This is what makes a shadow on the water darken the water itself and a low sun tint it; 0 leaves the body lit by the environment alone.',
+                    type: 'float',
+                    default: 1,
+                    options: {
+                        animatable: true,
+                        minValue: 0,
+                        maxValue: 4
+                    },
+                    get (value) {
+                        value.num[0] = this.material.sunScatteringIntensity;
+                    },
+                    set (value) {
+                        this.material.sunScatteringIntensity = value.num[0];
+                    }
+                },
+                {
+                    name: 'FoamAmount',
+                    description: 'Coverage of the foam on breaking wave crests, mapped from the folding the wave generator reports. 0 disables crest foam. Independent of ShoreFoamAmount.',
+                    type: 'float',
+                    default: 1,
+                    options: {
+                        animatable: true,
+                        minValue: 0,
+                        maxValue: 4
+                    },
+                    get (value) {
+                        value.num[0] = this.material.foamAmount;
+                    },
+                    set (value) {
+                        this.material.foamAmount = value.num[0];
+                    }
+                },
+                {
+                    name: 'FoamFalloff',
+                    description: 'Falloff applied to crest foam coverage. Above 1 pushes light folding towards no foam at all, so only a genuinely broken crest shows - which is what keeps a windy sea from turning uniformly white.',
+                    type: 'float',
+                    default: 1.5,
+                    options: {
+                        animatable: true,
+                        minValue: 0.01,
+                        maxValue: 8
+                    },
+                    isHidden () {
+                        return this.material.foamAmount <= 0;
+                    },
+                    get (value) {
+                        value.num[0] = this.material.foamFalloff;
+                    },
+                    set (value) {
+                        this.material.foamFalloff = value.num[0];
+                    }
+                },
+                {
+                    name: 'FoamColor',
+                    description: 'Diffuse albedo of the foam, shared by the crest foam and the shoreline foam. Slightly off-white and slightly blue - sea foam is water and air, and a pure white one reads as snow.',
+                    type: 'rgb',
+                    default: [
+                        0.92,
+                        0.95,
+                        0.97
+                    ],
+                    options: {
+                        animatable: true,
+                        minValue: 0,
+                        maxValue: 1
+                    },
+                    get (value) {
+                        value.num[0] = this.material.foamColor.x;
+                        value.num[1] = this.material.foamColor.y;
+                        value.num[2] = this.material.foamColor.z;
+                    },
+                    set (value) {
+                        this.material.foamColor = new Vector3(value.num[0], value.num[1], value.num[2]);
+                    }
+                },
+                {
+                    name: 'ShoreFoamAmount',
+                    description: 'Coverage of the foam that collects where the water meets a surface - the waterline on a shelving bed, and the collar around a piling or a hull. 0 disables it, which also removes its cost. Independent of the crest foam the wave generator produces. Requires WebGL2 or WebGPU.',
+                    type: 'float',
+                    default: 0,
+                    // Deliberately not animatable: crossing zero switches the whole
+                    // feature in and out of the shader, so an animation curve driving this
+                    // through zero rebuilds the program on the way past.
+                    options: {
+                        minValue: 0,
+                        maxValue: 4
+                    },
+                    get (value) {
+                        value.num[0] = this.shoreFoamAmount;
+                    },
+                    set (value) {
+                        this.shoreFoamAmount = value.num[0];
+                    }
+                },
+                {
+                    name: 'ShoreFoamDepth',
+                    description: 'How far the foam band reaches from the surface behind it, in meters. Over a bed this is a depth of water; against something vertical it is the horizontal distance to its side, and one value serves both. How wide that is on screen depends on the geometry: a thin line on a steep drop-off, a broad stretch on a flat shelf.',
+                    type: 'float',
+                    default: 0.5,
+                    options: {
+                        animatable: true,
+                        minValue: 0.001,
+                        maxValue: 20
+                    },
+                    isHidden () {
+                        return this.shoreFoamAmount <= 0;
+                    },
+                    get (value) {
+                        value.num[0] = this.shoreFoamDepth;
+                    },
+                    set (value) {
+                        this.shoreFoamDepth = value.num[0];
+                    }
+                },
+                {
+                    name: 'ShoreFoamFalloff',
+                    description: 'Falloff across the foam band. Above 1 pushes the coverage towards the contact line and keeps the outer edge thin and broken.',
+                    type: 'float',
+                    default: 1.5,
+                    options: {
+                        animatable: true,
+                        minValue: 0.01,
+                        maxValue: 8
+                    },
+                    isHidden () {
+                        return this.shoreFoamAmount <= 0;
+                    },
+                    get (value) {
+                        value.num[0] = this.shoreFoamFalloff;
+                    },
+                    set (value) {
+                        this.shoreFoamFalloff = value.num[0];
+                    }
+                },
+                {
+                    name: 'ShoreFoamScale',
+                    description: 'Size of the clumps the band breaks into, as cycles across the band rather than cycles per meter. Being relative to the band width, one value reads the same on a shoreline metres across and on a collar a handspan wide.',
+                    type: 'float',
+                    default: 2.5,
+                    options: {
+                        animatable: true,
+                        minValue: 0,
+                        maxValue: 20
+                    },
+                    isHidden () {
+                        return this.shoreFoamAmount <= 0;
+                    },
+                    get (value) {
+                        value.num[0] = this.shoreFoamScale;
+                    },
+                    set (value) {
+                        this.shoreFoamScale = value.num[0];
+                    }
+                },
+                {
+                    name: 'ShoreFoamWashAmount',
+                    description: 'How far the waterline runs up and back, as a fraction of ShoreFoamDepth. This is what makes the band read as surf rather than as a painted rim; 0 leaves it static. Above 1 the band closes completely at the bottom of the cycle, which looks like the foam blinking out.',
+                    type: 'float',
+                    default: 0.5,
+                    options: {
+                        animatable: true,
+                        minValue: 0,
+                        maxValue: 2
+                    },
+                    isHidden () {
+                        return this.shoreFoamAmount <= 0;
+                    },
+                    get (value) {
+                        value.num[0] = this.shoreFoamWashAmount;
+                    },
+                    set (value) {
+                        this.shoreFoamWashAmount = value.num[0];
+                    }
+                },
+                {
+                    name: 'ShoreFoamWashSpeed',
+                    description: 'Run-up cycles per second. Swell rather than wind waves, so well under 1.',
+                    type: 'float',
+                    default: 0.12,
+                    options: {
+                        animatable: true,
+                        minValue: 0,
+                        maxValue: 2
+                    },
+                    isHidden () {
+                        return this.shoreFoamAmount <= 0;
+                    },
+                    get (value) {
+                        value.num[0] = this.shoreFoamWashSpeed;
+                    },
+                    set (value) {
+                        this.shoreFoamWashSpeed = value.num[0];
+                    }
+                },
+                {
+                    name: 'ShoreFoamWashScale',
+                    description: 'Spatial frequency of the run-up phase, in cycles per meter. At 0 the whole waterline rises and falls in lockstep, which reads as the water level itself changing; a cycle every few tens of meters breaks a long shoreline into sections that run out of step with one another.',
+                    type: 'float',
+                    default: 0.03,
+                    options: {
+                        animatable: true,
+                        minValue: 0,
+                        maxValue: 1
+                    },
+                    isHidden () {
+                        return this.shoreFoamAmount <= 0;
+                    },
+                    get (value) {
+                        value.num[0] = this.shoreFoamWashScale;
+                    },
+                    set (value) {
+                        this.shoreFoamWashScale = value.num[0];
+                    }
+                },
+                {
+                    name: 'CheapRefractionDepth',
+                    description: 'Depth in meters the cheap refraction mode assumes the water is. Sets how strong the distortion looks when RefractionMode is Offset; ignored by March. A constant rather than the measured distance to the bottom, because an offset scaled by that distance paints a second copy of any object breaking the surface.',
+                    type: 'float',
+                    default: 1,
+                    options: {
+                        animatable: true,
+                        minValue: 0,
+                        maxValue: 20
+                    },
+                    isHidden () {
+                        return this.material.refractionMode !== 'offset';
+                    },
+                    get (value) {
+                        value.num[0] = this.material.cheapRefractionDepth;
+                    },
+                    set (value) {
+                        this.material.cheapRefractionDepth = value.num[0];
+                    }
+                },
+                {
+                    name: 'RefractionBlur',
+                    description: 'Scale on how much the medium blurs what is seen through it, 1 for the width the scattering coefficient and the path length imply. Turbid or deep water smudges the bottom; 0 keeps it sharp at any depth.',
+                    type: 'float',
+                    default: 1,
+                    options: {
+                        animatable: true,
+                        minValue: 0,
+                        maxValue: 4
+                    },
+                    get (value) {
+                        value.num[0] = this.material.refractionBlur;
+                    },
+                    set (value) {
+                        this.material.refractionBlur = value.num[0];
+                    }
+                },
+                {
+                    name: 'ScatterAnisotropy',
+                    description: 'Mean cosine of a single scattering event. 0 scatters equally in all directions; higher brightens the water when looking towards the sun through it. Sea water measures near 0.9, but a turbid column blends towards isotropic on its own.',
+                    type: 'float',
+                    default: DEFAULT_SCATTER_ANISOTROPY,
+                    options: {
+                        animatable: true,
+                        minValue: 0,
+                        maxValue: 0.95
+                    },
+                    get (value) {
+                        value.num[0] = this.material.scatterAnisotropy;
+                    },
+                    set (value) {
+                        this.material.scatterAnisotropy = value.num[0];
+                    }
+                },
+                {
+                    name: 'RefractionScale',
+                    description: 'Artistic scale on the refracted view offset. 1 is physical: the view ray is bent by Snell’s law and followed to whatever is behind the water, so the incidence angle, the depth and the perspective are already accounted for. 0 disables refraction.',
+                    type: 'float',
+                    default: 1,
+                    options: {
+                        animatable: true,
+                        minValue: 0,
+                        maxValue: 4
                     },
                     get (value) {
-                        value.num[0] = this.material.displace;
+                        value.num[0] = this.material.refractionScale;
                     },
                     set (value) {
-                        this.material.displace = value.num[0];
+                        this.material.refractionScale = value.num[0];
                     }
                 },
                 {
@@ -495,5 +1579,5 @@ import '../../../scene/raycast_visitor.js';
     };
 }
 
-export { getFBMWaveGeneratorClass, getFFTWaveGeneratorClass, getWaterClass };
+export { getFBMWaveGeneratorClass, getFFTWaveGeneratorClass, getGerstnerWaveClass, getGerstnerWaveGeneratorClass, getWaterClass };
 //# sourceMappingURL=water.js.map