babylon.quarks 0.26.0 → 0.27.0

package/src/shaders/chunks/soft.ts

@@ -0,0 +1,84 @@
+/**
+ * Soft particles for the particle shaders, in both shader languages.
+ *
+ * The fragment reads the scene depth behind it from `depthTexture`, turns it into view depth with
+ * the coefficients in `projParams` (see `softDepthParams`), and fades out over the distance in
+ * `softParams` as it nears the scene, as Unity's soft particles and Unreal's Depth Fade do. The
+ * fade runs last, after fog, so both languages produce the same colour.
+ *
+ * `SOFT_DEPTH_PACKED` reads a depth packed into four 8-bit channels, as a Babylon
+ * `DepthRenderer` of type `UNSIGNED_BYTE` writes it.
+ */
+
+/** Fragment-side declaration and depth decode, GLSL. */
+export const softFragmentDeclarationGLSL = /* glsl */ `
+#ifdef SOFT_PARTICLES
+uniform sampler2D depthTexture;
+uniform vec2 softParams;
+uniform vec4 projParams;
+varying vec4 projPosition;
+varying float linearDepth;
+
+float quarksSceneDepth(vec4 texel) {
+#ifdef SOFT_DEPTH_PACKED
+    float d = dot(texel, vec4(1.0 / (255.0 * 255.0 * 255.0), 1.0 / (255.0 * 255.0), 1.0 / 255.0, 1.0));
+#else
+    float d = texel.r;
+#endif
+    float denominator = projParams.z * d + projParams.w;
+    float depth = abs(denominator) > 1e-8 ? abs((projParams.x * d + projParams.y) / denominator) : 0.0;
+    // Nothing drawn there reads as infinitely far.
+    return depth > 0.0 ? depth : 1e30;
+}
+#endif
+`;
+
+/** Fades `target` as the fragment nears the scene behind it, GLSL. */
+export function softFragmentGLSL(target: string): string {
+    return /* glsl */ `
+#ifdef SOFT_PARTICLES
+    {
+        vec2 softUV = 0.5 * (projPosition.xy / projPosition.w) + 0.5;
+        float sceneDepth = quarksSceneDepth(texture2D(depthTexture, softUV));
+        ${target} *= clamp(softParams.y * ((sceneDepth - softParams.x) - linearDepth), 0.0, 1.0);
+    }
+#endif
+`;
+}
+
+/** Fragment-side declaration and depth decode, WGSL. */
+export const softFragmentDeclarationWGSL = /* wgsl */ `
+#ifdef SOFT_PARTICLES
+var depthTextureSampler: sampler;
+var depthTexture: texture_2d<f32>;
+uniform softParams: vec2f;
+uniform projParams: vec4f;
+varying projPosition: vec4f;
+varying linearDepth: f32;
+
+fn quarksSceneDepth(texel: vec4f) -> f32 {
+#ifdef SOFT_DEPTH_PACKED
+    let d = dot(texel, vec4f(1.0 / (255.0 * 255.0 * 255.0), 1.0 / (255.0 * 255.0), 1.0 / 255.0, 1.0));
+#else
+    let d = texel.r;
+#endif
+    let denominator = uniforms.projParams.z * d + uniforms.projParams.w;
+    let depth = select(0.0, abs((uniforms.projParams.x * d + uniforms.projParams.y) / denominator), abs(denominator) > 1e-8);
+    // Nothing drawn there reads as infinitely far.
+    return select(1e30, depth, depth > 0.0);
+}
+#endif
+`;
+
+/** Fades `target` as the fragment nears the scene behind it, WGSL. */
+export function softFragmentWGSL(target: string): string {
+    return /* wgsl */ `
+#ifdef SOFT_PARTICLES
+    {
+        let softUV = 0.5 * (fragmentInputs.projPosition.xy / fragmentInputs.projPosition.w) + 0.5;
+        let sceneDepth = quarksSceneDepth(textureSample(depthTexture, depthTextureSampler, softUV));
+        ${target} *= clamp(uniforms.softParams.y * ((sceneDepth - uniforms.softParams.x) - fragmentInputs.linearDepth), 0.0, 1.0);
+    }
+#endif
+`;
+}

package/src/shaders/chunks/surface.ts

@@ -108,6 +108,7 @@ export function surfaceColorGLSL(tileBlend: boolean): string {
     baseColor.a = 1.0;
     float erosionMaskValue = 1.0;
 #endif
+#if defined(USE_MAP) || defined(GRADIENT_MAP)
 #ifdef USE_MAP
     vec4 texColor = texture2D(map, mapUV);
     ${
@@ -130,6 +131,10 @@ export function surfaceColorGLSL(tileBlend: boolean): string {
     #endif`
             : ''
     }
+#else
+    // No map: the ramp is looked up at white, its far end.
+    vec4 texColor = vec4(1.0);
+#endif
     #ifdef GRADIENT_MAP
         float rampAt = clamp(dot(texColor, gradientMapChannel), 0.0, 1.0);
         vec4 ramp = texture2D(gradientMap, vec2(mix(gradientMapRange.x, gradientMapRange.y, rampAt), 0.5));
@@ -221,6 +226,7 @@ export function surfaceColorWGSL(tileBlend: boolean): string {
     baseColor.a = 1.0;
     var erosionMaskValue = 1.0;
 #endif
+#if defined(USE_MAP) || defined(GRADIENT_MAP)
 #ifdef USE_MAP
     var texColor = textureSample(map, mapSampler, mapUV);
     ${
@@ -243,6 +249,10 @@ export function surfaceColorWGSL(tileBlend: boolean): string {
     #endif`
             : ''
     }
+#else
+    // No map: the ramp is looked up at white, its far end.
+    var texColor = vec4f(1.0);
+#endif
     #ifdef GRADIENT_MAP
         let rampAt = clamp(dot(texColor, uniforms.gradientMapChannel), 0.0, 1.0);
         let ramp = textureSample(gradientMap, gradientMapSampler, vec2f(mix(uniforms.gradientMapRange.x, uniforms.gradientMapRange.y, rampAt), 0.5));

package/src/shaders/local_particle_physics_vert.glsl.ts

@@ -1,4 +1,5 @@
 import {fogVertexDeclarationGLSL, fogVertexGLSL} from './chunks/fog';
+import {sheetVertexDeclarationGLSL, sheetVertexGLSL} from './chunks/sheet';
 
 export default /* glsl */ `
 attribute vec3 position;
@@ -13,11 +14,7 @@ attribute float uvTile;
 uniform mat4 world;
 uniform mat4 view;
 uniform mat4 projection;
-
-#ifdef UV_TILE
-uniform float tileCountX;
-uniform float tileCountY;
-#endif
+${sheetVertexDeclarationGLSL}
 
 varying vec2 vUV;
 varying vec4 vColor;
@@ -32,11 +29,6 @@ varying vec2 vUV1;
 varying vec3 vNormal;
 varying vec3 vWorldPos;
 
-#ifdef TILE_BLEND
-varying vec2 vUV2;
-varying float vTileBlend;
-#endif
-
 #ifdef SOFT_PARTICLES
 varying vec4 projPosition;
 varying float linearDepth;
@@ -53,7 +45,15 @@ ${fogVertexDeclarationGLSL}
 void main() {
     vec3 scaledPosition = position * size;
     vec3 rotatedPosition = applyQuaternion(scaledPosition, rotation);
-    vec3 rotatedNormal = normalize(applyQuaternion(normal, rotation));
+    // A normal scales by the inverse of the size, so a stretched mesh keeps its normals
+    // perpendicular; a flat size counts as a sliver rather than dividing by zero.
+    vec3 safeSize = vec3(
+        abs(size.x) > 1e-6 ? size.x : 1e-6,
+        abs(size.y) > 1e-6 ? size.y : 1e-6,
+        abs(size.z) > 1e-6 ? size.z : 1e-6);
+    // A mirrored size (an odd number of negative components) turns the winding inside out, so the
+    // normal is turned with it and the fragment's front-face test agrees with the geometry.
+    vec3 rotatedNormal = normalize(applyQuaternion(normal / safeSize, rotation)) * sign(safeSize.x * safeSize.y * safeSize.z);
     vec3 localPos = rotatedPosition + offset;
 
     vec4 worldPos = world * vec4(localPos, 1.0);
@@ -66,25 +66,11 @@ ${fogVertexGLSL('viewPos.xyz')}
 
 #ifdef SOFT_PARTICLES
     projPosition = gl_Position;
-    linearDepth = -viewPos.z;
+    // View depth is +z ahead of a left-handed camera and -z ahead of a right-handed one.
+    linearDepth = abs(viewPos.z);
 #endif
 
-#ifdef UV_TILE
-    vec2 tc = vec2(tileCountX, tileCountY);
-    float baseTile = floor(uvTile);
-    float tileU = mod(baseTile, tc.x) / tc.x;
-    float tileV = 1.0 - floor(baseTile / tc.x) / tc.y - 1.0 / tc.y;
-    vUV = uv / tc + vec2(tileU, tileV);
-    #ifdef TILE_BLEND
-        float nextTile = ceil(uvTile);
-        float nextU = mod(nextTile, tc.x) / tc.x;
-        float nextV = 1.0 - floor(nextTile / tc.x) / tc.y - 1.0 / tc.y;
-        vUV2 = uv / tc + vec2(nextU, nextV);
-        vTileBlend = fract(uvTile);
-    #endif
-#else
-    vUV = uv;
-#endif
+${sheetVertexGLSL('uv')}
 
 #ifdef UV1
 #ifdef MESH_UV2

package/src/shaders/local_particle_physics_vert.wgsl.ts

@@ -1,4 +1,5 @@
 import {fogVertexDeclarationWGSL, fogVertexWGSL} from './chunks/fog';
+import {sheetVertexDeclarationWGSL, sheetVertexWGSL} from './chunks/sheet';
 
 export default /* wgsl */ `
 attribute position: vec3f;
@@ -13,11 +14,7 @@ attribute uvTile: f32;
 uniform world: mat4x4f;
 uniform view: mat4x4f;
 uniform projection: mat4x4f;
-
-#ifdef UV_TILE
-uniform tileCountX: f32;
-uniform tileCountY: f32;
-#endif
+${sheetVertexDeclarationWGSL}
 
 varying vUV: vec2f;
 varying vColor: vec4f;
@@ -32,11 +29,6 @@ varying vUV1: vec2f;
 varying vNormal: vec3f;
 varying vWorldPos: vec3f;
 
-#ifdef TILE_BLEND
-varying vUV2: vec2f;
-varying vTileBlend: f32;
-#endif
-
 #ifdef SOFT_PARTICLES
 varying projPosition: vec4f;
 varying linearDepth: f32;
@@ -52,9 +44,18 @@ fn applyQuaternion(v: vec3f, q: vec4f) -> vec3f {
 ${fogVertexDeclarationWGSL}
 @vertex
 fn main(input: VertexInputs) -> FragmentInputs {
-    let scaledPosition = vertexInputs.position * vertexInputs.size;
+    let size = vertexInputs.size;
+    let scaledPosition = vertexInputs.position * size;
     let rotatedPosition = applyQuaternion(scaledPosition, vertexInputs.rotation);
-    let rotatedNormal = normalize(applyQuaternion(vertexInputs.normal, vertexInputs.rotation));
+    // A normal scales by the inverse of the size, so a stretched mesh keeps its normals
+    // perpendicular; a flat size counts as a sliver rather than dividing by zero.
+    let safeSize = vec3f(
+        select(1e-6, size.x, abs(size.x) > 1e-6),
+        select(1e-6, size.y, abs(size.y) > 1e-6),
+        select(1e-6, size.z, abs(size.z) > 1e-6));
+    // A mirrored size (an odd number of negative components) turns the winding inside out, so the
+    // normal is turned with it and the fragment's front-face test agrees with the geometry.
+    let rotatedNormal = normalize(applyQuaternion(vertexInputs.normal / safeSize, vertexInputs.rotation)) * sign(safeSize.x * safeSize.y * safeSize.z);
     let localPos = rotatedPosition + vertexInputs.offset;
 
     let worldPos = uniforms.world * vec4f(localPos, 1.0);
@@ -68,25 +69,11 @@ ${fogVertexWGSL('viewPos.xyz')}
 
 #ifdef SOFT_PARTICLES
     vertexOutputs.projPosition = clipPosition;
-    vertexOutputs.linearDepth = -viewPos.z;
+    // View depth is +z ahead of a left-handed camera and -z ahead of a right-handed one.
+    vertexOutputs.linearDepth = abs(viewPos.z);
 #endif
 
-#ifdef UV_TILE
-    let tc = vec2f(uniforms.tileCountX, uniforms.tileCountY);
-    let baseTile = floor(vertexInputs.uvTile);
-    let tileU = (baseTile % tc.x) / tc.x;
-    let tileV = 1.0 - floor(baseTile / tc.x) / tc.y - 1.0 / tc.y;
-    vertexOutputs.vUV = vertexInputs.uv / tc + vec2f(tileU, tileV);
-    #ifdef TILE_BLEND
-        let nextTile = ceil(vertexInputs.uvTile);
-        let nextU = (nextTile % tc.x) / tc.x;
-        let nextV = 1.0 - floor(nextTile / tc.x) / tc.y - 1.0 / tc.y;
-        vertexOutputs.vUV2 = vertexInputs.uv / tc + vec2f(nextU, nextV);
-        vertexOutputs.vTileBlend = fract(vertexInputs.uvTile);
-    #endif
-#else
-    vertexOutputs.vUV = vertexInputs.uv;
-#endif
+${sheetVertexWGSL('vertexInputs.uv')}
 
 #ifdef UV1
 #ifdef MESH_UV2

package/src/shaders/particle_frag.glsl.ts

@@ -1,4 +1,5 @@
 import {fogFragmentDeclarationGLSL, fogFragmentGLSL} from './chunks/fog';
+import {softFragmentDeclarationGLSL, softFragmentGLSL} from './chunks/soft';
 import {surfaceColorGLSL, surfaceFragmentDeclarationGLSL} from './chunks/surface';
 
 export default /* glsl */ `
@@ -17,26 +18,16 @@ varying float vTileBlend;
 uniform sampler2D map;
 #endif
 
-#ifdef SOFT_PARTICLES
-uniform sampler2D depthTexture;
-uniform vec2 softParams;
-uniform vec4 projParams;
-varying vec4 projPosition;
-varying float linearDepth;
-#endif
 
 #ifdef USE_ALPHATEST
 uniform float alphaTest;
 #endif
 
 ${fogFragmentDeclarationGLSL}
+${softFragmentDeclarationGLSL}
 ${surfaceFragmentDeclarationGLSL}
 void main() {
 ${surfaceColorGLSL(true)}
-#ifdef USE_COLOR_AS_ALPHA
-    baseColor.a *= (baseColor.r + baseColor.g + baseColor.b) / 3.0;
-#endif
-
 #ifdef USE_ALPHATEST
     if (baseColor.a < alphaTest) discard;
 #else
@@ -45,16 +36,6 @@ ${surfaceColorGLSL(true)}
 
 ${fogFragmentGLSL('baseColor.rgb')}
     gl_FragColor = baseColor;
-
-#ifdef SOFT_PARTICLES
-    vec2 p2 = projPosition.xy / projPosition.w;
-    p2 = 0.5 * p2 + 0.5;
-    float readDepth = texture2D(depthTexture, p2.xy).r;
-    float zNear = projParams.x;
-    float zFar = projParams.y;
-    float viewDepth = (zFar * zNear) / (zFar - readDepth * (zFar - zNear));
-    float fade = clamp(softParams.y * ((viewDepth - softParams.x) - linearDepth), 0.0, 1.0);
-    gl_FragColor *= fade;
-#endif
+${softFragmentGLSL('gl_FragColor')}
 }
 `;

package/src/shaders/particle_frag.wgsl.ts

@@ -1,4 +1,5 @@
 import {fogFragmentDeclarationWGSL, fogFragmentWGSL} from './chunks/fog';
+import {softFragmentDeclarationWGSL, softFragmentWGSL} from './chunks/soft';
 import {surfaceColorWGSL, surfaceFragmentDeclarationWGSL} from './chunks/surface';
 
 export default /* wgsl */ `
@@ -18,46 +19,25 @@ var mapSampler: sampler;
 var map: texture_2d<f32>;
 #endif
 
-#ifdef SOFT_PARTICLES
-var depthTextureSampler: sampler;
-var depthTexture: texture_2d<f32>;
-uniform softParams: vec2f;
-uniform projParams: vec4f;
-varying projPosition: vec4f;
-varying linearDepth: f32;
-#endif
 
 #ifdef USE_ALPHATEST
 uniform alphaTest: f32;
 #endif
 
 ${fogFragmentDeclarationWGSL}
+${softFragmentDeclarationWGSL}
 ${surfaceFragmentDeclarationWGSL}
 @fragment
 fn main(input: FragmentInputs) -> FragmentOutputs {
 ${surfaceColorWGSL(true)}
-#ifdef USE_COLOR_AS_ALPHA
-    baseColor.a *= (baseColor.r + baseColor.g + baseColor.b) / 3.0;
-#endif
-
 #ifdef USE_ALPHATEST
     if (baseColor.a < uniforms.alphaTest) { discard; }
 #else
     if (baseColor.a < 0.01) { discard; }
 #endif
 
-#ifdef SOFT_PARTICLES
-    var p2 = fragmentInputs.projPosition.xy / fragmentInputs.projPosition.w;
-    p2 = 0.5 * p2 + 0.5;
-    let readDepth = textureSample(depthTexture, depthTextureSampler, p2).r;
-    let zNear = uniforms.projParams.x;
-    let zFar = uniforms.projParams.y;
-    let viewDepth = (zFar * zNear) / (zFar - readDepth * (zFar - zNear));
-    let fade = clamp(uniforms.softParams.y * ((viewDepth - uniforms.softParams.x) - fragmentInputs.linearDepth), 0.0, 1.0);
-    baseColor *= fade;
-#endif
-
 ${fogFragmentWGSL('baseColor')}
+${softFragmentWGSL('baseColor')}
     fragmentOutputs.color = baseColor;
 }
 `;

package/src/shaders/particle_physics_frag.glsl.ts

@@ -1,4 +1,5 @@
 import {fogFragmentDeclarationGLSL, fogFragmentGLSL} from './chunks/fog';
+import {softFragmentDeclarationGLSL, softFragmentGLSL} from './chunks/soft';
 import {surfaceColorGLSL, surfaceFragmentDeclarationGLSL} from './chunks/surface';
 
 export default /* glsl */ `
@@ -79,29 +80,18 @@ vec3 sampleEnvAtlas(vec3 r) {
 }
 #endif
 
-#ifdef SOFT_PARTICLES
-uniform sampler2D depthTexture;
-uniform vec2 softParams;
-uniform vec4 projParams;
-varying vec4 projPosition;
-varying float linearDepth;
-#endif
 
 #ifdef USE_ALPHATEST
 uniform float alphaTest;
 #endif
 
 ${fogFragmentDeclarationGLSL}
+${softFragmentDeclarationGLSL}
 ${surfaceFragmentDeclarationGLSL}
 void main() {
 ${surfaceColorGLSL(true)}
-#ifdef USE_ALPHATEST
-    if (baseColor.a < alphaTest) discard;
-#else
-    if (baseColor.a < 0.01) discard;
-#endif
-
-    vec3 N = normalize(vNormal);
+    // A back face lights, reflects and rims as the face the camera sees.
+    vec3 N = normalize(vNormal) * (gl_FrontFacing ? 1.0 : -1.0);
 #ifdef MESH_UNLIT
     vec3 color = baseColor.rgb;
 #else
@@ -132,18 +122,15 @@ ${surfaceColorGLSL(true)}
     #endif
 #endif
 
+    // After the rim, so a fade that empties a face can discard it.
+#ifdef USE_ALPHATEST
+    if (baseColor.a < alphaTest) discard;
+#else
+    if (baseColor.a < 0.01) discard;
+#endif
+
 ${fogFragmentGLSL('color')}
     gl_FragColor = vec4(color, baseColor.a);
-
-#ifdef SOFT_PARTICLES
-    vec2 p2 = projPosition.xy / projPosition.w;
-    p2 = 0.5 * p2 + 0.5;
-    float readDepth = texture2D(depthTexture, p2.xy).r;
-    float zNear = projParams.x;
-    float zFar = projParams.y;
-    float viewDepth = (zFar * zNear) / (zFar - readDepth * (zFar - zNear));
-    float fade = clamp(softParams.y * ((viewDepth - softParams.x) - linearDepth), 0.0, 1.0);
-    gl_FragColor *= fade;
-#endif
+${softFragmentGLSL('gl_FragColor')}
 }
 `;

package/src/shaders/particle_physics_frag.wgsl.ts

@@ -1,4 +1,5 @@
 import {fogFragmentDeclarationWGSL, fogFragmentWGSL} from './chunks/fog';
+import {softFragmentDeclarationWGSL, softFragmentWGSL} from './chunks/soft';
 import {surfaceColorWGSL, surfaceFragmentDeclarationWGSL} from './chunks/surface';
 
 export default /* wgsl */ `
@@ -78,31 +79,19 @@ fn sampleEnvAtlas(r: vec3f) -> vec3f {
 }
 #endif
 
-#ifdef SOFT_PARTICLES
-var depthTextureSampler: sampler;
-var depthTexture: texture_2d<f32>;
-uniform softParams: vec2f;
-uniform projParams: vec4f;
-varying projPosition: vec4f;
-varying linearDepth: f32;
-#endif
 
 #ifdef USE_ALPHATEST
 uniform alphaTest: f32;
 #endif
 
 ${fogFragmentDeclarationWGSL}
+${softFragmentDeclarationWGSL}
 ${surfaceFragmentDeclarationWGSL}
 @fragment
 fn main(input: FragmentInputs) -> FragmentOutputs {
 ${surfaceColorWGSL(true)}
-#ifdef USE_ALPHATEST
-    if (baseColor.a < uniforms.alphaTest) { discard; }
-#else
-    if (baseColor.a < 0.01) { discard; }
-#endif
-
-    let N = normalize(fragmentInputs.vNormal);
+    // A back face lights, reflects and rims as the face the camera sees.
+    let N = normalize(fragmentInputs.vNormal) * select(-1.0, 1.0, fragmentInputs.frontFacing);
 #ifdef MESH_UNLIT
     var color = baseColor.rgb;
 #else
@@ -133,20 +122,17 @@ ${surfaceColorWGSL(true)}
     #endif
 #endif
 
-    var finalColor = vec4f(color, baseColor.a);
-
-#ifdef SOFT_PARTICLES
-    var p2 = fragmentInputs.projPosition.xy / fragmentInputs.projPosition.w;
-    p2 = 0.5 * p2 + 0.5;
-    let readDepth = textureSample(depthTexture, depthTextureSampler, p2).r;
-    let zNear = uniforms.projParams.x;
-    let zFar = uniforms.projParams.y;
-    let viewDepth = (zFar * zNear) / (zFar - readDepth * (zFar - zNear));
-    let fade = clamp(uniforms.softParams.y * ((viewDepth - uniforms.softParams.x) - fragmentInputs.linearDepth), 0.0, 1.0);
-    finalColor *= fade;
+    // After the rim, so a fade that empties a face can discard it.
+#ifdef USE_ALPHATEST
+    if (baseColor.a < uniforms.alphaTest) { discard; }
+#else
+    if (baseColor.a < 0.01) { discard; }
 #endif
 
+    var finalColor = vec4f(color, baseColor.a);
+
 ${fogFragmentWGSL('finalColor')}
+${softFragmentWGSL('finalColor')}
     fragmentOutputs.color = finalColor;
 }
 `;

package/src/shaders/particle_vert.glsl.ts

@@ -1,4 +1,5 @@
 import {fogVertexDeclarationGLSL, fogVertexGLSL} from './chunks/fog';
+import {sheetVertexDeclarationGLSL, sheetVertexGLSL} from './chunks/sheet';
 
 export default /* glsl */ `
 // Per-vertex attributes
@@ -16,12 +17,7 @@ attribute float uvTile;
 uniform mat4 world;
 uniform mat4 view;
 uniform mat4 projection;
-uniform mat4 worldViewProjection;
-
-#ifdef UV_TILE
-uniform float tileCountX;
-uniform float tileCountY;
-#endif
+${sheetVertexDeclarationGLSL}
 
 #ifdef PIVOT
 // Quad offset in particle-size units: xy in the quad's plane, z toward the camera.
@@ -35,10 +31,6 @@ varying vec4 vColor;
 // The particle's own UV, never moved by the sheet (UV channel 1).
 varying vec2 vUV1;
 #endif
-#ifdef TILE_BLEND
-varying vec2 vUV2;
-varying float vTileBlend;
-#endif
 #ifdef SOFT_PARTICLES
 varying vec4 projPosition;
 varying float linearDepth;
@@ -103,25 +95,11 @@ void main() {
 ${fogVertexGLSL('mvPosition.xyz')}
 #ifdef SOFT_PARTICLES
     projPosition = gl_Position;
-    linearDepth = -mvPosition.z;
+    // View depth is +z ahead of a left-handed camera and -z ahead of a right-handed one.
+    linearDepth = abs(mvPosition.z);
 #endif
 
-    #ifdef UV_TILE
-        vec2 tc = vec2(tileCountX, tileCountY);
-        float baseTile = floor(uvTile);
-        float tileU = mod(baseTile, tc.x) / tc.x;
-        float tileV = 1.0 - floor(baseTile / tc.x) / tc.y - 1.0 / tc.y;
-        vUV = uv / tc + vec2(tileU, tileV);
-        #ifdef TILE_BLEND
-            float nextTile = ceil(uvTile);
-            float nextU = mod(nextTile, tc.x) / tc.x;
-            float nextV = 1.0 - floor(nextTile / tc.x) / tc.y - 1.0 / tc.y;
-            vUV2 = uv / tc + vec2(nextU, nextV);
-            vTileBlend = fract(uvTile);
-        #endif
-    #else
-        vUV = uv;
-    #endif
+${sheetVertexGLSL('uv')}
 
 #ifdef UV1
     vUV1 = uv;

package/src/shaders/particle_vert.wgsl.ts

@@ -1,4 +1,5 @@
 import {fogVertexDeclarationWGSL, fogVertexWGSL} from './chunks/fog';
+import {sheetVertexDeclarationWGSL, sheetVertexWGSL} from './chunks/sheet';
 
 export default /* wgsl */ `
 // Per-vertex attributes
@@ -16,11 +17,7 @@ attribute uvTile: f32;
 uniform world: mat4x4f;
 uniform view: mat4x4f;
 uniform projection: mat4x4f;
-
-#ifdef UV_TILE
-uniform tileCountX: f32;
-uniform tileCountY: f32;
-#endif
+${sheetVertexDeclarationWGSL}
 
 #ifdef PIVOT
 // Quad offset in particle-size units: xy in the quad's plane, z toward the camera.
@@ -34,10 +31,6 @@ varying vColor: vec4f;
 // The particle's own UV, never moved by the sheet (UV channel 1).
 varying vUV1: vec2f;
 #endif
-#ifdef TILE_BLEND
-varying vUV2: vec2f;
-varying vTileBlend: f32;
-#endif
 #ifdef SOFT_PARTICLES
 varying projPosition: vec4f;
 varying linearDepth: f32;
@@ -105,25 +98,11 @@ fn main(input: VertexInputs) -> FragmentInputs {
 ${fogVertexWGSL('mvPosition.xyz')}
 #ifdef SOFT_PARTICLES
     vertexOutputs.projPosition = clipPosition;
-    vertexOutputs.linearDepth = -mvPosition.z;
+    // View depth is +z ahead of a left-handed camera and -z ahead of a right-handed one.
+    vertexOutputs.linearDepth = abs(mvPosition.z);
 #endif
 
-    #ifdef UV_TILE
-        let tc = vec2f(uniforms.tileCountX, uniforms.tileCountY);
-        let baseTile = floor(vertexInputs.uvTile);
-        let tileU = (baseTile % tc.x) / tc.x;
-        let tileV = 1.0 - floor(baseTile / tc.x) / tc.y - 1.0 / tc.y;
-        vertexOutputs.vUV = vertexInputs.uv / tc + vec2f(tileU, tileV);
-        #ifdef TILE_BLEND
-            let nextTile = ceil(vertexInputs.uvTile);
-            let nextU = (nextTile % tc.x) / tc.x;
-            let nextV = 1.0 - floor(nextTile / tc.x) / tc.y - 1.0 / tc.y;
-            vertexOutputs.vUV2 = vertexInputs.uv / tc + vec2f(nextU, nextV);
-            vertexOutputs.vTileBlend = fract(vertexInputs.uvTile);
-        #endif
-    #else
-        vertexOutputs.vUV = vertexInputs.uv;
-    #endif
+${sheetVertexWGSL('vertexInputs.uv')}
 
 #ifdef UV1
     vertexOutputs.vUV1 = vertexInputs.uv;