Implement and validate foliage blocker masks across document systems

src/document/scene-document-validation.ts

@@ -3010,6 +3010,64 @@ function validateTerrain(
       }
     }
   }
+
+  const blockerMask = terrain.foliageBlockerMask;
+  const blockerMaskPath = `${path}.foliageBlockerMask`;
+
+  if (blockerMask.resolutionX !== terrain.sampleCountX) {
+    diagnostics.push(
+      createDiagnostic(
+        "error",
+        "invalid-terrain-foliage-blocker-mask-resolution-x",
+        "Terrain foliage blocker mask resolutionX must match terrain sampleCountX.",
+        `${blockerMaskPath}.resolutionX`
+      )
+    );
+  }
+
+  if (blockerMask.resolutionZ !== terrain.sampleCountZ) {
+    diagnostics.push(
+      createDiagnostic(
+        "error",
+        "invalid-terrain-foliage-blocker-mask-resolution-z",
+        "Terrain foliage blocker mask resolutionZ must match terrain sampleCountZ.",
+        `${blockerMaskPath}.resolutionZ`
+      )
+    );
+  }
+
+  const expectedBlockerMaskValueCount =
+    blockerMask.resolutionX * blockerMask.resolutionZ;
+
+  if (blockerMask.values.length !== expectedBlockerMaskValueCount) {
+    diagnostics.push(
+      createDiagnostic(
+        "error",
+        "invalid-terrain-foliage-blocker-mask-value-count",
+        `Terrain foliage blocker mask values must contain exactly ${expectedBlockerMaskValueCount} samples.`,
+        `${blockerMaskPath}.values`
+      )
+    );
+  }
+
+  if (options.terrainSampleValues !== "skip") {
+    for (let index = 0; index < blockerMask.values.length; index += 1) {
+      const maskValue = blockerMask.values[index];
+
+      if (isFiniteNumber(maskValue) && maskValue >= 0 && maskValue <= 1) {
+        continue;
+      }
+
+      diagnostics.push(
+        createDiagnostic(
+          "error",
+          "invalid-terrain-foliage-blocker-mask-value",
+          "Terrain foliage blocker mask values must remain finite values between 0 and 1.",
+          `${blockerMaskPath}.values.${index}`
+        )
+      );
+    }
+  }
 }
 
 function validateFoliagePrototype(

src/document/terrains.ts

@@ -956,7 +956,10 @@ function getStoredTerrainPaintWeightAtSample(
 }
 
 export function getTerrainFoliageMaskSampleIndex(
-  mask: Pick<TerrainFoliageMask | TerrainFoliageBlockerMask, "resolutionX" | "resolutionZ">,
+  mask: Pick<
+    TerrainFoliageMask | TerrainFoliageBlockerMask,
+    "resolutionX" | "resolutionZ"
+  >,
   sampleX: number,
   sampleZ: number
 ): number {
@@ -1096,26 +1099,12 @@ function sampleTerrainFoliageMaskAtGridCoordinate(
   const maxSampleZ = Math.min(mask.resolutionZ - 1, minSampleZ + 1);
   const blendX = clampedSampleX - minSampleX;
   const blendZ = clampedSampleZ - minSampleZ;
-  const value00 = getTerrainFoliageMaskValueAtSample(
-    mask as TerrainFoliageMask,
-    minSampleX,
-    minSampleZ
-  );
-  const value10 = getTerrainFoliageMaskValueAtSample(
-    mask as TerrainFoliageMask,
-    maxSampleX,
-    minSampleZ
-  );
-  const value01 = getTerrainFoliageMaskValueAtSample(
-    mask as TerrainFoliageMask,
-    minSampleX,
-    maxSampleZ
-  );
-  const value11 = getTerrainFoliageMaskValueAtSample(
-    mask as TerrainFoliageMask,
-    maxSampleX,
-    maxSampleZ
-  );
+  const readMaskValue = (x: number, z: number) =>
+    mask.values[getTerrainFoliageMaskSampleIndex(mask, x, z)] ?? 0;
+  const value00 = readMaskValue(minSampleX, minSampleZ);
+  const value10 = readMaskValue(maxSampleX, minSampleZ);
+  const value01 = readMaskValue(minSampleX, maxSampleZ);
+  const value11 = readMaskValue(maxSampleX, maxSampleZ);
 
   return lerp(
     lerp(value00, value10, blendX),