ugly-game 0.5.12 → 0.5.13

package/dist/gpuShadow.d.ts

@@ -107,7 +107,7 @@ export declare class GpuShadowRenderer {
         depth: GPUTextureView;
         w: number;
         h: number;
-    }, tint?: [number, number, number, number], extraShadow?: (sp: GPURenderPassEncoder, lightVP: Float32Array) => void): void;
+    }, tint?: [number, number, number, number], extraShadow?: (sp: GPURenderPassEncoder, lightVP: Float32Array) => void, up?: [number, number, number]): void;
     /** Read back the last frame's GPU cull result (camera-visible, light-visible). Does its OWN copy+submit so it's
      *  safe to call from a live render loop (no per-frame readback cost, no race with the ongoing frames). IR/tests. */
     readCullStats(): Promise<{

package/dist/gpuShadow.js

@@ -51,6 +51,7 @@ struct Cam {
   sunCol: vec4<f32>,   // xyz = sun colour, w = shadow map size (texels)
   tint: vec4<f32>,     // rgb = per-planet tint · w = tint strength (0 = none)
   atlas: vec4<f32>,    // x = useAtlas (1/0)
+  up: vec4<f32>,       // xyz = local gravity up (for hemisphere face-shading readability); w unused
 };
 struct Inst { pos: vec4<f32>, scl: vec4<f32>, rot: vec4<f32>, aux: vec4<f32> };  // pos.w = hue (<0 ⇒ ground) · scl.w = emissive/alpha · rot = quaternion · aux.x = atlas tile (<0 ⇒ hue) · aux.y = up-face code
 @group(0) @binding(0) var<uniform> cam: Cam;
@@ -269,7 +270,12 @@ fn blockShade(fx: f32, fz: f32) -> f32 {
   // per-block edge AO makes each voxel visible on FLAT-hue cubes, but reads as a hard GRID over textures — so the
   // atlas path drops it entirely (the texture already supplies surface detail).
   let ao = select(blockShade(fx, fz), 1.0, cam.atlas.x > 0.5 && i.tile >= 0.0);
-  let lit = base * (cam.sun.w + cam.sunCol.xyz * ndl * sh) * ao;
+  // HEMISPHERE FACE-SHADING: brighten faces pointing toward the local up (sky), darken side/down faces — so every
+  // block's orientation reads at a glance (edges/corners legible) WITHOUT a per-block grid. Modulates the ambient
+  // sky term (not the direct sun), so sunlit faces keep full key light while shaded areas still show 3D form.
+  let hemi = dot(N, cam.up.xyz) * 0.5 + 0.5;      // 0 = down-facing, 0.5 = side, 1 = up-facing
+  let amb = cam.sun.w * mix(0.55, 1.15, hemi);
+  let lit = base * (amb + cam.sunCol.xyz * ndl * sh) * ao;
   return vec4(pow(clamp(lit, vec3(0.0), vec3(1.0)), vec3(0.4545)), 1.0);  // gamma
 }
 `;
@@ -304,7 +310,7 @@ export class GpuShadowRenderer {
     mainBGL;
     shadowSampler;
     count = 0;
-    cam = new Float32Array(48); // 2×mat4 + sun + sunCol + tint + atlas
+    cam = new Float32Array(52); // 2×mat4 + sun + sunCol + tint + atlas + up
     atlasView;
     atlasSampler;
     tileRectBuf;
@@ -585,7 +591,7 @@ export class GpuShadowRenderer {
     /** camVP/lightVP: column-major Float32Array(16). sunDir: travel direction. Pass `occlusion` (the depth target +
      *  its size) to enable Hi-Z occlusion culling on the camera pass — the renderer rebuilds a coarse Hi-Z from that
      *  depth each frame and the NEXT frame's cull uses it (hole-free: the first frame + any resize skip occlusion). */
-    frame(enc, colorView, sceneDepth, camVP, lightVP, sunDir, sunCol, ambient, load = false, occlusion, tint = [1, 1, 1, 0], extraShadow) {
+    frame(enc, colorView, sceneDepth, camVP, lightVP, sunDir, sunCol, ambient, load = false, occlusion, tint = [1, 1, 1, 0], extraShadow, up = [0, 1, 0]) {
         this.cam.set(camVP, 0);
         this.cam.set(lightVP, 16);
         this.cam[32] = sunDir[0];
@@ -601,6 +607,9 @@ export class GpuShadowRenderer {
         this.cam[42] = tint[2];
         this.cam[43] = tint[3];
         this.cam[44] = this.useAtlas;
+        this.cam[48] = up[0];
+        this.cam[49] = up[1];
+        this.cam[50] = up[2];
         this.device.queue.writeBuffer(this.camBuf, 0, this.cam);
         if (occlusion)
             this.ensureHiZ(occlusion.w, occlusion.h);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ugly-game",
-  "version": "0.5.12",
+  "version": "0.5.13",
   "type": "module",
   "exports": {
     ".": {