From 2a3094736318376576b2a24e401e3fb2d1a0486c Mon Sep 17 00:00:00 2001 From: fOuttaMyPaint Date: Fri, 19 Jun 2026 22:44:39 -0400 Subject: [PATCH] docs: add Examples showcase to README with swatch-grid preview Adds an Examples section (a table built to hold multiple examples) seeded with swatch-grid: an optimized WebP preview (1200x450, ~6 KB, sourced from the Stage-2 HDRI hero render), relative-linked with descriptive alt text, plus the example name linking to examples/swatch-grid/ and one line on what it demonstrates. README content-count line unchanged. No Pages/gallery exists in this repo, so none was created (flagged as a separate decision). Signed-off-by: fOuttaMyPaint --- README.md | 23 +++++++++++++++++++++++ examples/swatch-grid/preview.webp | Bin 0 -> 6272 bytes 2 files changed, 23 insertions(+) create mode 100644 examples/swatch-grid/preview.webp diff --git a/README.md b/README.md index 6bb7f28..6ab9ea6 100644 --- a/README.md +++ b/README.md @@ -43,6 +43,29 @@ The content is consumed by AI coding agents (Cursor, Claude Code, any MCP-capabl | Blender 4.5 LTS | Fallback supported (skills show both code paths where 4.x and 5.x APIs diverge) | | Blender 5.2 LTS | Sweep planned for July 2026 (see [ROADMAP.md](ROADMAP.md)) | +## Examples + +Runnable, smoke-gated demos live in [`examples/`](examples/) — each is executed headless on +both Blender 4.5 LTS and 5.1 by the `blender-smoke` workflow, so the screenshots reflect code +that actually runs. + + + + + + +
+Swatch grid: a row of six shaded spheres - gold and copper metals, red and blue plastics, an emissive orange, and a matte white - on a reflective studio floor, rendered with EEVEE + + +### [swatch-grid](examples/swatch-grid/) + +A procedural-materials swatch grid — Principled metal and dielectric, the emission pattern, +and the cross-version `set_specular` shim. Doubles as a live proof of the EEVEE engine-id +mapping (`BLENDER_EEVEE` on 5.x, `BLENDER_EEVEE_NEXT` on 4.2-4.5). + +
+ ## How content is organized ``` diff --git a/examples/swatch-grid/preview.webp b/examples/swatch-grid/preview.webp new file mode 100644 index 0000000000000000000000000000000000000000..c3514092fb7d4cbed58f894249f199bffb6bc3c9 GIT binary patch literal 6272 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 E1Db2{i2wiq literal 0 HcmV?d00001