@d5techs/3dgs-lib 1.4.54 → 1.4.56

package/dist/3dgs-lib.cjs

@@ -2198,7 +2198,7 @@ function float32ToFloat16(val) {
 const CUBE_WGSL = (
   /* wgsl */
   `
-struct Uniforms { col0: vec4<f32>, col1: vec4<f32>, col2: vec4<f32> };
+struct Uniforms { col0: vec4<f32>, col1: vec4<f32>, col2: vec4<f32>, extra: vec4<f32> };
 @group(0) @binding(0) var<uniform> u: Uniforms;
 @group(0) @binding(1) var cubeSampler: sampler;
 @group(0) @binding(2) var cubeTexture: texture_cube<f32>;
@@ -2217,12 +2217,17 @@ struct V { @builtin(position) pos: vec4<f32>, @location(0) dir: vec3<f32> };
 const EQUIRECT_WGSL = (
   /* wgsl */
   `
-struct Uniforms { col0: vec4<f32>, col1: vec4<f32>, col2: vec4<f32> };
+struct Uniforms { col0: vec4<f32>, col1: vec4<f32>, col2: vec4<f32>, extra: vec4<f32> };
 @group(0) @binding(0) var<uniform> u: Uniforms;
 @group(0) @binding(1) var envSampler: sampler;
 @group(0) @binding(2) var envTexture: texture_2d<f32>;
 struct V { @builtin(position) pos: vec4<f32>, @location(0) dir: vec3<f32> };
 const PI: f32 = 3.14159265358979;
+
+fn dirToUv(d: vec3<f32>) -> vec2<f32> {
+    return vec2(atan2(d.z, d.x) / (2.*PI) + .5, 1. - (asin(clamp(d.y,-1.,1.)) / PI + .5));
+}
+
 @vertex fn vs(@builtin(vertex_index) vi: u32) -> V {
     let ps = array<vec2<f32>,3>(vec2(-1.,-1.),vec2(3.,-1.),vec2(-1.,3.));
     var o: V; let p = ps[vi]; o.pos = vec4(p, 0., 1.);
@@ -2230,10 +2235,46 @@ const PI: f32 = 3.14159265358979;
     o.dir = vec3(dot(u.col0.xyz,e), dot(u.col1.xyz,e), dot(u.col2.xyz,e));
     return o;
 }
+
 @fragment fn fs(i: V) -> @location(0) vec4<f32> {
     let d = normalize(i.dir);
-    let uv = vec2(atan2(d.z, d.x) / (2.*PI) + .5, asin(clamp(d.y,-1.,1.)) / PI + .5);
-    let c = textureSample(envTexture, envSampler, vec2(uv.x, 1. - uv.y)).rgb;
+    let camY = u.extra.x;
+    let sphereR = u.extra.y;
+
+    // --- sky UV (always computed) ---
+    let skyUv = dirToUv(d);
+
+    // --- ground projection (always computed for uniform control flow) ---
+    // Ray from camera (0, camY, 0) in direction d hits plane y=0 at t
+    let dyClamped = min(d.y, -0.0001);
+    let t = -camY / dyClamped;
+    let hitX = t * d.x;
+    let hitZ = t * d.z;
+    let hitDist = sqrt(hitX * hitX + hitZ * hitZ);
+
+    // Project the ground hit point back onto a sphere of radius R
+    // centered at the camera projection on y=0 (i.e. center = origin).
+    // For points beyond R, fade to horizon sampling.
+    let ratio = min(hitDist, sphereR) / max(hitDist, 0.001);
+    let pX = hitX * ratio;
+    let pZ = hitZ * ratio;
+    let pY = -sqrt(max(sphereR * sphereR - pX * pX - pZ * pZ, 0.0));
+    let groundDir = normalize(vec3(pX, pY, pZ));
+    let groundUv = dirToUv(groundDir);
+
+    // --- sample both (unconditional = uniform control flow) ---
+    let skyColor = textureSample(envTexture, envSampler, skyUv).rgb;
+    let groundColor = textureSample(envTexture, envSampler, groundUv).rgb;
+
+    // Blend: smooth transition near horizon
+    // step(0.01, camY) disables ground projection when camera is at/below ground
+    let groundFactor = smoothstep(0.01, -0.15, d.y) * step(0.01, camY);
+    // Fade out ground color at the sphere edge to avoid hard seam
+    let edgeFade = 1.0 - smoothstep(sphereR * 0.7, sphereR * 0.99, hitDist);
+    let finalBlend = groundFactor * edgeFade;
+    let c = mix(skyColor, groundColor, finalBlend);
+
+    // Reinhard tone mapping + gamma
     let mapped = c / (c + vec3(1.));
     let gamma = pow(mapped, vec3(1./2.2));
     return vec4(gamma, 1.);
@@ -2244,7 +2285,7 @@ class SkyboxRenderer {
     __publicField(this, "device");
     __publicField(this, "uniformBuffer");
     __publicField(this, "sampler");
-    __publicField(this, "uniformData", new Float32Array(12));
+    __publicField(this, "uniformData", new Float32Array(16));
     __publicField(this, "cubePipeline");
     __publicField(this, "cubeBindGroupLayout");
     __publicField(this, "equirectPipeline");
@@ -2253,6 +2294,8 @@ class SkyboxRenderer {
     __publicField(this, "bindGroup", null);
     __publicField(this, "frameReady", false);
     __publicField(this, "mode", "none");
+    /** Ground projection sphere radius (world units). Larger = ground extends further, flatter. */
+    __publicField(this, "groundRadius", 500);
     this.device = device;
     const depthStencil = {
       format: depthFormat,
@@ -2261,7 +2304,7 @@ class SkyboxRenderer {
     };
     this.cubeBindGroupLayout = device.createBindGroupLayout({
       entries: [
-        { binding: 0, visibility: GPUShaderStage.VERTEX, buffer: { type: "uniform" } },
+        { binding: 0, visibility: GPUShaderStage.VERTEX | GPUShaderStage.FRAGMENT, buffer: { type: "uniform" } },
         { binding: 1, visibility: GPUShaderStage.FRAGMENT, sampler: { type: "filtering" } },
         { binding: 2, visibility: GPUShaderStage.FRAGMENT, texture: { sampleType: "float", viewDimension: "cube" } }
       ]
@@ -2275,7 +2318,7 @@ class SkyboxRenderer {
     });
     this.equirectBindGroupLayout = device.createBindGroupLayout({
       entries: [
-        { binding: 0, visibility: GPUShaderStage.VERTEX, buffer: { type: "uniform" } },
+        { binding: 0, visibility: GPUShaderStage.VERTEX | GPUShaderStage.FRAGMENT, buffer: { type: "uniform" } },
         { binding: 1, visibility: GPUShaderStage.FRAGMENT, sampler: { type: "filtering" } },
         { binding: 2, visibility: GPUShaderStage.FRAGMENT, texture: { sampleType: "float", viewDimension: "2d" } }
       ]
@@ -2288,7 +2331,7 @@ class SkyboxRenderer {
       depthStencil
     });
     this.uniformBuffer = device.createBuffer({
-      size: 48,
+      size: 64,
       usage: GPUBufferUsage.UNIFORM | GPUBufferUsage.COPY_DST
     });
     this.sampler = device.createSampler({ magFilter: "linear", minFilter: "linear" });
@@ -2371,7 +2414,7 @@ class SkyboxRenderer {
     this.mode = "equirect";
   }
   // ---- common ----
-  prepareFrame(viewMatrix, projectionMatrix) {
+  prepareFrame(viewMatrix, projectionMatrix, cameraPosition) {
     if (!this.isActive) {
       this.frameReady = false;
       return;
@@ -2389,6 +2432,10 @@ class SkyboxRenderer {
     ud[9] = viewMatrix[9];
     ud[10] = viewMatrix[10];
     ud[11] = 0;
+    ud[12] = cameraPosition ? cameraPosition[1] : 0;
+    ud[13] = this.groundRadius;
+    ud[14] = 0;
+    ud[15] = 0;
     this.device.queue.writeBuffer(this.uniformBuffer, 0, ud);
     this.frameReady = true;
   }
@@ -19025,9 +19072,11 @@ class App {
     this.updateAdaptivePerformance();
     this.hotspotManager.updateBillboards();
     if ((_a2 = this.skyboxRenderer) == null ? void 0 : _a2.isActive) {
+      const cam = this.camera.position;
       this.skyboxRenderer.prepareFrame(
         this.camera.viewMatrix,
-        this.camera.projectionMatrix
+        this.camera.projectionMatrix,
+        [cam[0], cam[1], cam[2]]
       );
     }
     const pass = this.renderer.beginFrame();
@@ -19222,6 +19271,11 @@ class App {
     }
     await this.skyboxRenderer.loadEquirectangular(url);
   }
+  setHdrGroundRadius(radius) {
+    if (this.skyboxRenderer) {
+      this.skyboxRenderer.groundRadius = radius;
+    }
+  }
   clearSkybox() {
     var _a2;
     (_a2 = this.skyboxRenderer) == null ? void 0 : _a2.clear();