Swatchbook: Material Library, Picker and Calibration Kit
README.md
materialChecks
Checks for material-library materials, the tool face of
materialLibraryKit.Checks: render passes, tiling seams, distance shimmer,
texture memory and the web texture budget. Every tool takes a library id
(grey18) or a material identity (@builtin::materials.water). Probes are
temporary and removed before a tool returns. Images land in /tmp/materialChecks/.
| Tool | What it does |
|---|---|
materialChecks.views | Sphere, tile and shader ball in final/albedo/roughness/metallic/normal; saves a collage and returns per-cell luma |
materialChecks.seams | Tiles 4 × 4, renders top-down in albedo and measures boundary vs interior jumps; checks each texture's opposite edges |
materialChecks.shimmer | Near (1.5 m) and far (30 m, grazing) views; a half-pixel shift measures shimmer |
materialChecks.textureMemory | Per-slot GPU texture bytes, estimated and actually resident |
materialChecks.budget | Web-budget warnings for one material, or for the whole library with no id |
materialChecks.run | Everything above in one report, with ok and readable failures |
From the shell: zero materialChecks seams grey18. From Luau:
tools.use("materialChecks", "run", "chromeBall"). Thresholds, limits and their
sources are in the Checks module README.