From fed92566301ae01435a2fffe060a7e3d9e0870ca Mon Sep 17 00:00:00 2001 From: TMHSDigital <154358121+TMHSDigital@users.noreply.github.com> Date: Sat, 26 Sep 2026 09:59:55 -0400 Subject: [PATCH] feat(showcase): add bookshelf The bookshelf with leaning books was the first unclaimed candidate in the ROADMAP pool. What an envelope check cannot see on it is whether a leaning book rests on its neighbour: tipped too far its board cuts the neighbour's head edge, not far enough it stands in the air, and every seat, the bounding box and the book-overlap budget (which must exempt the designed contact) still pass. The piece reads the leaning board's outer-face plane off the mesh and asserts the neighbour's head edge sits 0.3-2.0 mm behind it; --air-lean and --deep-lean exit 22 on it. Also asserts both sides on the floor, housed cross members, page blocks glued into their boards, gilt bands seated on the spine, every book seated on its shelf or the book below, headroom, size spread, zero unplanned book overlaps and no right-angle wood edges, each with a falsifier proven on 4.5.11, 5.1.2 and 5.2.1. Co-Authored-By: Claude Opus 5.5 (1M context) Signed-off-by: TMHSDigital <154358121+TMHSDigital@users.noreply.github.com> --- .cursor-plugin/plugin.json | 3 +- CLAUDE.md | 2 +- README.md | 9 +- ROADMAP.md | 3 +- docs/gallery/asset-sheets/bookshelf.webp | Bin 0 -> 60296 bytes docs/gallery/assets/bookshelf-hero.webp | Bin 0 -> 32846 bytes docs/gallery/bookshelf/index.html | 2070 +++++++++++++++++ .../bookshelf-contact-sheet.webp | Bin 0 -> 44458 bytes docs/gallery/index.html | 15 +- scripts/asset_sheet.py | 1 + showcase/bookshelf/README.md | 293 +++ showcase/bookshelf/bookshelf.py | 1701 ++++++++++++++ showcase/bookshelf/preview.webp | Bin 0 -> 28620 bytes showcase/gallery.json | 13 + tests/smoke/catalog.json | 3 +- 15 files changed, 4104 insertions(+), 9 deletions(-) create mode 100644 docs/gallery/asset-sheets/bookshelf.webp create mode 100644 docs/gallery/assets/bookshelf-hero.webp create mode 100644 docs/gallery/bookshelf/index.html create mode 100644 docs/gallery/contact-sheets/bookshelf-contact-sheet.webp create mode 100644 showcase/bookshelf/README.md create mode 100644 showcase/bookshelf/bookshelf.py create mode 100644 showcase/bookshelf/preview.webp diff --git a/.cursor-plugin/plugin.json b/.cursor-plugin/plugin.json index 03c74ace..d0d240fe 100644 --- a/.cursor-plugin/plugin.json +++ b/.cursor-plugin/plugin.json @@ -171,6 +171,7 @@ "showcase/brazier", "showcase/apothecary-shelf", "showcase/wooden-yoke", - "showcase/butter-churn" + "showcase/butter-churn", + "showcase/bookshelf" ] } diff --git a/CLAUDE.md b/CLAUDE.md index 1327268b..e54101fa 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -22,7 +22,7 @@ rules/.mdc - Anti-pattern rules, 9 total templates// - Starter projects, 3 total snippets/.py - Standalone code patterns, 27 total examples// - Runnable smoke-gated examples, 59 total (+ gallery.json) -showcase// - Budget-conformance props, 34 pieces (sibling of examples/; see showcase/README.md) +showcase// - Budget-conformance props, 35 pieces (sibling of examples/; see showcase/README.md) scripts/build_gallery.py - Regenerates docs/gallery/ from examples/gallery.json + showcase/gallery.json scripts/site/ - Vendored landing-page build (Jinja2) docs/gallery/ - Committed generated gallery pages + hero renders diff --git a/README.md b/README.md index d0f5ba30..493155f9 100644 --- a/README.md +++ b/README.md @@ -18,7 +18,7 @@

- 16 skills  •  9 rules  •  3 templates  •  27 snippets  •  59 examples  •  34 showcase pieces + 16 skills  •  9 rules  •  3 templates  •  27 snippets  •  59 examples  •  35 showcase pieces

@@ -37,7 +37,7 @@ ## Overview -This repository ships **16 skills, 9 rules, 3 templates, 27 snippets, 59 examples, and 34 showcase pieces** for Blender Python development targeting Blender 5.2 LTS (current stable) with Blender 4.5 LTS fallback support. Blender 5.1 is prior stable. +This repository ships **16 skills, 9 rules, 3 templates, 27 snippets, 59 examples, and 35 showcase pieces** for Blender Python development targeting Blender 5.2 LTS (current stable) with Blender 4.5 LTS fallback support. Blender 5.1 is prior stable. The content is consumed by AI coding agents reading these files directly from a checkout — **there is no MCP server in this repository, and none is required**. Cursor applies `rules/*.mdc` automatically wherever their scope globs match and takes skills by name in chat; Claude Code reads `skills/` and `rules/` from the project workspace, or from this repo kept as a referenced checkout. Any agent that can read files in a workspace can use it the same way. There is no build step for the content — edit the Markdown and Python files directly. @@ -106,7 +106,7 @@ per-script exit-code model, are in Budget-conformance props. Not examples. Conventions: [`showcase/README.md`](showcase/README.md).

-34 showcase pieces — click to expand the preview grid +35 showcase pieces — click to expand the preview grid

Shipping crate: a wooden slat crate with iron corner brackets on a dark studio floor, warm wedge on the back wall @@ -143,6 +143,7 @@ Budget-conformance props. Not examples. Conventions: [`showcase/README.md`](show Apothecary shelf: a stained wooden shelf unit with an arched crest, gallery rails and three drawers, stocked with labelled glass bottles, flasks and glazed jars, on a dark studio floor Wooden yoke: a carved oak ox yoke with upturned ends standing on two bent hickory oxbows pinned above the beam, with an iron ring hung under its centre, on a dark studio floor Butter churn: a tall staved oak churn narrowing toward the top, bound by three iron hoops, with a two-board lid and a maple dasher handle rising through it, on a dark studio floor + Bookshelf: a stained wooden bookcase of cloth and leather hardbacks, some standing, some stacked flat and two leaning on their neighbours, on a dark studio floor

[`shipping-crate`](showcase/shipping-crate/) — procedural crate through UVs, bake, LOD, collider, and Unity glTF, asserting recomputed budgets. Falsifier `--skip-decimate` exits 9. @@ -209,6 +210,8 @@ Budget-conformance props. Not examples. Conventions: [`showcase/README.md`](show [`butter-churn`](showcase/butter-churn/) — procedural staved plunge churn whose dasher stroke is recomputed from the inner wall read off the staves and the plunger's reach, through the same pipeline. Falsifiers `--wide-dasher` exits 20, `--tight-hole` exits 18. +[`bookshelf`](showcase/bookshelf/) — procedural bookcase of thirty-eight rounded-spine hardbacks, standing, stacked and leaning, whose leaning books' contact with their neighbour's head edge is recomputed as a band, through the same pipeline. Falsifiers `--air-lean` and `--deep-lean` exit 22, `--crowd-books` exits 23. +
## Examples diff --git a/ROADMAP.md b/ROADMAP.md index bc6fb112..3f846024 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -139,7 +139,8 @@ Not committed; target list for the next content version. (v0.3.0 shipped the smo - ~~Apothecary shelf (shelf unit, bottles and jars of varied form) as a game-prop showcase piece~~ **SHIPPED** as `showcase/apothecary-shelf/` — housed shelves, gallery rails, lapped back boards, a drawer bank and an arched crest, stocked with fifteen lathed vessels in five forms, each corked or lidded and labelled on its own rings; per-vessel headroom under the member above is read off the mesh, `--tall-flask` exits 20 on it while every seat and the envelope still pass - ~~Wooden yoke (oxbow, iron rings) as a game-prop showcase piece~~ **SHIPPED** as `showcase/wooden-yoke/` — lofted oak beam with neck saddles and upturned ends, two bent-hickory bows through it and pinned above it, a staple and a threaded hung ring; each neck opening measured between the bow legs and up to the saddle, `--pinch-bows` exits 19 on it while the bows still ground and the envelope is unchanged - ~~Butter churn (staved tub, lid, dasher) as a game-prop showcase piece~~ **SHIPPED** as `showcase/butter-churn/` — sixteen tapered staves with canted ends, three hoops seated vertex-for-vertex on them, a three-board bottom in a croze, a two-board lid and a cross dasher; the plunge stroke is recomputed from the inner wall and the plunger's reach, `--wide-dasher` exits 20 on it while the plunger still clears the staves at rest -- Bookshelf with leaning books (upright and toppled volumes of varied size, one leaning on its neighbour) as a game-prop showcase piece — the lean needs a contact budget the apothecary shelf's upright vessels never exercised: each leaning book rests on its neighbour's spine edge and on the shelf, not in either +- ~~Bookshelf with leaning books (upright and toppled volumes of varied size, one leaning on its neighbour) as a game-prop showcase piece~~ **SHIPPED** as `showcase/bookshelf/` — housed shelves on a recessed plinth, lapped back boards and a stepped cornice, thirty-eight rounded-spine hardbacks with glued page blocks and gilt bands, standing, stacked and leaning; each leaning board's contact with its neighbour's head edge is read off the mesh as a plane depth, `--air-lean` and `--deep-lean` exit 22 on it while every seat and the envelope still pass +- Library ladder or book trolley with loose books as a game-prop showcase piece — books resting across two rails (a ledge, a trolley shelf) exercise a two-point support the bookshelf's flat shelves never do - Ox cart tongue or plough beam that hitches to the yoke's ring as a game-prop showcase piece — a hitch is a ring-on-hook contact the yoke's hung ring only tests against a fixed bar - ~~Small modular kit showcase on recognizable geometry (`modular-kit-snap` contract)~~ **SHIPPED** as `showcase/fence-kit/` — tiling post-and-rail section (AABB X is the tile width; does not re-witness the snap contract); `--skip-decimate` exits 9 on the LOD1 ratio band diff --git a/docs/gallery/asset-sheets/bookshelf.webp b/docs/gallery/asset-sheets/bookshelf.webp new file mode 100644 index 0000000000000000000000000000000000000000..779bdb1be018c46fcc5fccd81504fb81f56f44c4 GIT binary patch literal 60296 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�A4@j`{92Q@l@T|gy-(&ew4&8mdbtxWl~ z9p(K_ux`1l;icSaTa^(%#NaO8@qk|iHq!)UACiFrr|a_`bR=OoLlaLlXbER1%eyKvUJwusv~)SQw*1ui zS5kCW`!d5Zs;m|hIOlqQ7a@l|%CNvG2ctDG=>OKjwk^64mY+!HI;<_I2?1@cUYgHY z#?DRQ$J&nL3Y|*52@HAcI}1bElnrJ%EI-3M>^|jqjUDwOH^9s5-yQgGMVDdrs99Y6 zFy}p2lsuBJq`+X#ZiA3x5u&$dQ_g-PN*W>d+U4`#3?0gs_lU}pWkCf7ncE+fqI3h( zUqo2zD8uJa1d)+>V-zh7ZMze=q{ z@Tg$lL-sQqtYC>i0UrRWlA&Ux!b2JkWh`#0bma+S@(jmUo`S=rNd z2U~*U5;jud^oA_y6F)TAv3L1NOc|eXbfX{6xT-r~{55@+i}tSscUY>sAo9aF?l*@M zda>(N1&r=E4a1!PZ-sd<)$^y##-4?eD_qUuLe9pYc6=wSC8kLzyZQaT zqdbc(&M(Yu!0&V|%wC_}vwbI}s9q$tx^;#jV*;dA=;MpOYZ0eQCME@}pk zj@uM#TZoBYTcT*f6Y5CRRz-cml46TBJkNRy-#HV_#(i)@X{tYakyrzK^C}(?VFYT1 z6AX{xCm_)jz?+)8@zqr7N{Ol?vHj0e7=#WmU;uo-Vf(3`PGA63%Np6Yrmmah2l?4} zTE)SOP!}8^l6czGMldA;hpGhG7C8;b$}iNc8L9F7nUzWS>lMl-rI>%Em!3wqSg-o~9d5_`xY(>W|p#`v*5G*&edZ#0>p}J85dnpeY z;Z`ca@@B0IZ3*GSr4ig8T@e>JmdIh1BP6Pf2N+vUS%{S?oG9KMJYQ$G0rDN+_V1O_XU1RPh3?}+Jn1>2Gu5*FG0Pr8f(rehF8G&vwkujeai$+^2FW-6Q!Ok*DeZWDO=~%XUT-QhbjrF zODTttI$r!cAZ^h??vdLeoZhuFCJ5~~HwggJ4~0M{zhsP*K^|1G0Onrh{lp?FTjJNK z_iw)zywQ#2^sFV~@*tk_2N1dD7LQ0kRz2>UWlHoy{yBD#73p&~q8=i+RfLRwyXR_5 zve81Y@B00PMi7`sJ=X!pDmc}AE2MstkRwfq(}k`9?|Ji5Y+}O+FL>nr8+S-qDeH~$ z{$eYF&-hc+J}{6WtljZuJ6E|eB9!*|FY|K&YwE%oHKX@{yDcbmRQcM8yx3_^YbW-N z`gq;+WC3huw|qTw@+U>h@>yxYSh87)4_@J*I>NJk(zDaGQ{mJ%YPbYS=FAx|l-D1qCQ%`xH= z`1Prn&1eur3$8dGhPtE(GKGyREjgJ=*p%O&4yGH}d+{(Z@P%%qMj1YJW>Y~GTsG9Z zzI?zpz-{S?t-eqkUlio)q+??C1umnuBSJm|v=1|EZsdD2?sSt;k7XIbp+pYtOIB{T z+)&?R-pivu<kbSH;W$Zp`7DbH zvu`YovP%cM*IKiXVtmSZdWn|WHwozmOp5zOwEu%1bSzV_b9i#%2n=s78sU*i2opg! zqs1nt#CG7ky{tud+O*?JB;AqGoM}LR4_zis#(YPe8{^E=XMKO5yq?71P8$G&tN=j zVhC9;q`QWp<1eRwIJG=4;8&VtIT~11a2THCYu>Dx!S?-2Xg1L+*nkrtUO!BSK}(2a zWBZHYMG_`ixRUPgq6YB}VzU-t#giT(CB?y0QEFQV@P)be`QFw*;Dj5TQ8!pYc(?_M z&+`v7o-<{vOU9Z<;-#`rfys!AjWRrggBg3g-i*K~lyUQ%=*0861xDOH`<3+nZx&eW z+MW~LqS{2H5$UDhd&D_AfqyBSO!iWfuDFwtUY=@ajyCxrEt~{ke-?*-+*;^%;t4#6 zF@9zNlg&b!R ztQk5EB@I=n_~t!D)%m#(uQVRlGAD?vd-Ga8(dZKf^zqf)lrsbnwX_ik5H?#_oGG^5 z)JI5I4{4kS;IGCxhXfe}4XweUx&GOahGf&2%^C9;SJvX)2ov)b6yCXdFubk}Vgb*f+|7WZb{2pgGu*#RN#Gc?5*xY{Th|kw* zvZb8)dI=ekZhmSeTcv!7vK|~dzlV<~y!8?Kq@`XVZD02;Xu**pK!pIPeiNW>z|ig6 zJ%}y9j%=~N%o$8p2OvXMtdzZMu+bO%-h zmh(qA#Iw%&kZ_x2vv)(g?zVpvVvg7Fe)|}|J-@( zHkMNBMWZPIaa_)<7L94m&Yaj8pXk~RL6fat1N5p>{2Lfo-5uKleHe?d?tCSrtu99I znJJ7ewIqf>6^_eDxK=ETLOhC678=^e+{THQyOxSPyPa_gEXFK`1ZP3YU6AJ-Iw^K3 zuEQ0Dwg(1PcC_em3JiG6B#=SLyC1OD348$uP`8l=@mRdgd~9*0Ke1N26wZ&jArU{@ z|AlZBT*17X)oOnIvY;oZo=ZI2G;{3L$Avp6i$PMSLKO`7pHs!$rMfBCZF-r|<_QWr(5h5rWQQ(@ zTVYanr3F%+kHFOq2E+x|NsZFaIHG+&O>pO9Zi7}kTx3Q7we=xQE8Nfu;*(Zsrh3U^&Tq>WtPH&2BE28mzUoYmzIYstH5oF}%XUTq; z)skMLSM)SZhqk1RwYe8BeH>r(6p6bcoK6c^UKjcdkel||D?|NaWI?JDZ~?w7p3X#r_Q49&XllGb$&qS^l)CW6 zJWvdF&wZgWN#38TE1LZRoO>U~lcv1t+D(5F^-{4Mq(%7bvL9{jI80f~@gONzYOO3d z=qbH#BC?sfK(%p}V&>ZlXo34HJDD?~eO6?8k%V!BU<$lKiE8X#DmhKgTW_%iyf#Yf8nzr&yA%K5uzJN|jSlrlF%SEI-&O%!4HL79*TH^V`6xF8pE}pMbbuKcRPIcKYzs8#fKy8$fY>zlM~OZ3E=4qJsS3MmY;;W4HseGOqSl zw@!Ml^F|C%^$3!VFQ)Ze@4l5$yvkqA%;EXaFfhsdtF~Z*6&+uI=InE#wUdZoC<%5- zDTC^lnk0|Su|@0?dQ^m$*RQcTQo?B@om}y@ZfB5V+}U`$J);m2;;adhA~x_(8-MtiI}oy-U zJZNe!GS~Fnqzk?OZ7C;&n>tglo}u2MU()(U`1SA7z^f94S)MI#_ZyJ%SzIv?ltRt9eEbJ2-1Lj zd@S?}k<~zm60Cpd8j)=_)q8ahnb}jM=|`6+#U$`AO9-$rCN5Ob*VYhfD{ZVjN4Qr&MWh=SfDA%KMG|tP7xVnK8Sc^_ z4HxaUgHg7W@^>p@pXdGW&fdpq1DE;$UF9++=EH)8a?3x1uF-dSd20_{iWxKUb!iw= z70AMgoyQ1}pQET`jT(55f&pzuZY}^^ae%>-i!NUQQuz3NR}|~cEqSW{9pyW%^%yj$ zWuN8YRbtQJ#Q|i(%ixJrIZYT6v$o21bH(rmF?pQqExuwX%tkr-!y~q3jP3PX?$7QJzHFq0h6Npw+(%pxt&C2ERJ1c*hRbH zrr)GBF5t$&@ayMJvsl%%C^}6h9b*%ILU#o%XGb3QqU!y(JAq#z*^jkgX^tz~P>T{a zn<*IMZSoF z+#4ztnEz%iDg|oqZN&TC)_VMiAn9NP^GsZ<8k1?(Qq^bX9%BPWSTIYODp9ztZh&IQ z2kHA;nS}ZT^A{53=Dw11k^t)`Ns+?!n834jGMqb+>LXf|sbXcdO#7gs`JfXgxYN{w zk+f-XgfdulJyO(1egG<*M7>Y*m8_il3QD-1iu!kpeW{fl$*mPi!Sz@rS&UkH^vCJN$0raX430d#VC!H$`Mby(*U zl_Pc1^>cmz0QF?7y#_Wq^1&V?`GsJ}Ck@U}T0aZbKSPEdEyy?NLv;TE+Bfhn=3)OZf~d?^$8Hf(W*ydqePWcfavmuY+;%z1S)7@_9B zRQ8@{ZB;|>{yrB<^s)R5i#YzLWhIy_MBLQ6X^n5*pW|GA2gIde^ z|La1ncgA(v?!4i4EA#!jyEL$rMe<&bBA?hSon^-*LWC^}TOW|l^9o?KUTm{HhFJM` z8XP55XPir|Tww!*!-VG%xOvkohRdh6-V*Z^ti;&ppFbqvCj>3`DS*? zjoMIEl!ljo2@-o;FC^@@WV}wyxd4UzCANPpmot}U*Cs`O{mYxls$P0eRHvl8bUy5l zb`)>qEX^I@bl$3HwUH!>m@xJbqLb_YfRuvRnIs%m*-(p;&TQgH(XvTS@v~armIlU@rQ%a+RX&UT;7A{rCrKYVqTM8*81nB1ZuPk_b5oIF zKN`q@vU_X=Hlr<|y5XF6dBTlQ2ko3ZAFWS6RcAv(G|vk#01(;`n$}EvmDx8J0}Ky> zl<~ebCI7LVP6VtOUSfk{eI>|Fz{~h@zR8@uk_2`eDZHJ$U|K$sP;&3uH?1CN?Eiba ztKVU)vM3&L;bj1|ORd#}@znt=K{jyArPTCXQR30Ic1TG4#h(>klbU0y4M_NSP8f(- zgXxM6fKv@8<7d(+oVB@AbH^QnC!2Wn=4#C%`)LfCo8Wfm!iz<`6@MLy;f}?yn!d<> z(KloCcjZ#U$m0NjzQ7eiVB0F!r$GF^w)gMR4eYxEJDFI(kSMod7*Y)c!2mFDDZkv2 z4IF{r7^g97;?`k_Q8L?mg>T2+r+LC9dD#e)6FM%-!MH{gXakTQ;N~xd%%yu;qYx7# zR!RYk>z+c^aDV_f*exxQC`__DSTYFiKF){)6RnAT!)OdUn@X*sBR{|Nsr&Keb#7_K z;{Ojs^7`lKETC4Y06~oj*v&JA_!Ual%mv`7YVRG9iN#~1fWC9+v`+nW`?)6(Cfy|{ zNc8WV79ODrUX53b*gblhK_qRzqz8IbIF*;W zt+8+^pO*unPe||cCI(Ec#O&6svA^@M6;>gR8jbLx7gMJWpmf*TE0CjVfo_3+6@}w# z#L-IT}FkdxY%`(HXOU$1KO=t>nbPH=}5N|BaI=8uDINLT&lIWAdDJkb?OVwSJ6R`M2~?016Z z(@u7v06%z?ytQ^_;V!13Qr~IapFLQxm}gE;Z8_NiIpTRZf^mh%B&XLsOlPXbWwgBB zNYf|4k7w_VWNy@RM5up$g8sFmZW$QAQQ3t1;Kudm_}XfacMOyn@CD~+~PTnePo5GP5r{C_zkVC@;F+UIq?r1Y#!vVU5Og88ky zZGJPUnP(alY=om&2Bl>g1uny?k9X-)5m+$FF18KU!<>&TNT#|too z?zxRK$lpdj9!=1e;5)aEc4xwZcPoXg+y+M(Oa%W@v*!u`?;He2L~g%vu?m;97S1*I zCVhBtnkiHy@8$0aR}5KJgt1@4U7Pmr9pRSQDKK*C@4sWN#qwQwCwqbSgx&zY<;S7h z_*~%Y|3E8JAVYoJ-VdBQo)ttD-N>IJ8>&J32~g7NyU=X7e; zzq}7{o?UPqXIk;spY9!k@y3=8oo?Y73NiA(`9~Mm94O$6f7igI*;RRboV-(}p!jX9 z6pODF3FKw08dIxXODLe4C#=7>!mf~lO~FgZE54LdeqGlx`U}YTvQJ?G_9V^S>F_ z7!{Exs@OZYQX2@%7f(ch$HpB)`5DP zP(-X`zyW|d4_JakgGb67l6h(<>Y0S0Si>#}F6I5vf{HTDto>Uk?@T-IArHXh;qwB@ zuu~(7XB`B4*Q9myntTt#Pri8B$R>BLC)YSC)icG3)9TXK{|dpGb7wt6`rrc_t1kb( z#Tpj<{{1~u|El9!*z(=c=#B1%3-WIrPOo0P?C@wtviqh+snEC&5S^F0W=No9v?9D| zb#;zN6isPEl`V=_*t!?R*!}40R?rB&ap*9DIpi!dP#RN z)=ZDzy4+wuHK4^bpPhQ5G*h}GNFwi8gUPd&T&2uM#@M-6(}nn$YiDn+CsFgQ&E^_^ zSNb9fl$5sHQ!_BQ&7qAG)yWLX`Whkd zu>okIbiT64qR)c=2zZDSm0yw8Viov~V)#kl*w*zk&xiRbiI0MuG$UP&cn{eVih>`3 z-D){46_(h)gGC=PGajz7CxAo-4@jPKhV5qWvtQk}@RoSXhl(o$O2$x*ItsNBMM=0_ z#<&1LIqU*OF|0qC6JYK+x{(g3TQRv2e8ws!fF+wL)l;gjGn}E-rVHN9TI)^24@!k7r0QF-G`+0UJ?I2tK^qoUQ<_ zI;MO{kv93-ViTYqW<0b0FWHMGT9z7}6QFg@;E2ECtcW}!-z>QOn(LSkEDSZ72%7}01)I3l0WQ)D#4$(`%M#)Fo1Y#HXL0D>D#1@t}G#)O|~D#3R0 z7K!Z?{<}5ks?bu+hnOD=gUg@I3@^6DZj5ltOZ9$PVQ!wHI4S6t&4F!Gm=X+NjN*by zd;A=W{=b~fO@Z1Rv(s34lvFOGB(b)Cb>A|kKF|m52gft}0}+J}A7lYQpnZsMldk+$ zdZVoQ7ts?gRNMqhgL@VtE(%0045Ziz6dUu~%#i z9Nq_p8k^fm0?aAmT>A~RBv2GHtjwa)W6Ino;Pu%+Ovv%d9bUzjC(W=d59}lS55OY} z8Dx5hYy!pTSwyNu(ro`U)z>V3Zlh2SN8IeK`Lt5=>JfWF5d*vieADU;wlRddWk~f+ zP|<+Ew>=ga8jB^`>a-@Y@+Gn@)CgOPj_WNL;M;>p5oy${%0ogapTB?CG3N$cD(PI^iQ>ZlI_(ZF+WG zRpS=&1-y@L2Z@0{T*$Zlo5y40mw8^Y4;@L*?LpBMKIz zquFajmeomgwj`G*h|BpxUhIKPJQ!p4IFjX~Pww1;Ez}Vi2pHxXCdFuYhLwYrEn_8T zGk$>RMStuVEqK|!+k`mZ^T2Z z4;TWI3*aWN15E}dU;r9mTEWJqdkb1(XEDqM$G`~7TU+HTv++}O=ev}liT<=f@UGwR ziM{afmK4e@M!QYq^lq(UE;}<;*2V>f1h^1a)boYJPLVzYN{Z zX_z4@&x!Z~6CXZU;`y`Tn!q1&w|nZ+g!=PTC7t+W6D?8nGAK#{VlTk-P{0L&YmvTK zK7&oO3wJNf%08U13=E0+7$`OWHVs!Qn6)eR}hok|ao3s^0|61bPmXc~9- z)&!=!uF0kWpiweil+oLdX3WRxbK0ZhSIJ>ObM1%V;NsY0_MGs3Pmlfn635S(igHV9 z6vCyVR$SK1mD0R)sLs}6|K{6s89 zT4AQ8(3oX=Q^_OE29x4Y85hG9^DqDX-qb64cM<*unMmDe<4WT$X_nr9KD9jJ7U%FH z3;hp*P-rNQ1nCtTX!+P)@1OOAOE=Pg2_AE|4Z@WKaty2u#Sfw0FbHx2YrJ6 zxFSYr8!*VaCz-fzHg_uh)UGNrFyfcW=0=h@6I92F_R25GnZ*#*lfttitts$P2rU)3Pnz$y?bSjRIw8&m70Wc|MMi>5jMtUF!Y12 z`)?KF+yIyGO^k7|p(6l{gUfA(^=Arx;U1bXr2+jaU(KPqmp%A`cZm#CE6jZZDoqQhByz>($a~6<`7kr_TCbQw>Vy+M4i;|*zSUDRJI4#>e&o~ErTvNl( zBWXHLQK28P;mxS>;CAls((Or3x6v5IpLPwFyNkv`?Os5zDd2qbAncP`KUMwy+${|k z#7j&EY6Gi2zwzk;jnEIIF+SeYI#_@&8ZwYH&mXR?bwCVy8@jyem)pEbt?na_cPa7Y zCW@>5jr0|Tz9mc|)aYpGSN^XbrpHADdEJX$0yvWo0`^9 zPJO#{U9bcbRePR|KX{;PqPZ{9&yTjl;b3Zbi|3Z`s59#iY-7!o#=+Z0eM{AQ5Majp zMg6dDS|gCIz~u4=c?tB2jNl<#7Xh|k)#wgM?|OYHBJ&LHhAFwT_WR;o4Xz3kH5JL{NHh*ys;aaYLUQQLO zemhlu?PMQ`ME$u)@5(STJe^<;pJDi1XXs8=(B)(eWX^9bJo-gKGUpa^%PlfOO>*Ht zChVPZl12mL;}mVE%Aw<@cCctTc-4AmyI8gm28KE-F?;%~vQ@lrAxCu|Z!F9v|6}4j8s9`v>gz(g?5m#EJneI@$0`;6~F?+ABvsr~@y?^ez+a zGg#O?m{(BdVQUlkyj9}+DY1S5Te|a}=#Uq2#2ugleg=Q&l)>R-z#$etGw1yQut}wN zxnit7?zzHluIbLk9frP_?A$lYD8O{DSC}cmh~r2nR!>)cEy*Oq=gdg0T3Wbk-ekC! z_c!_lPRFznBS*^xZvwLTA>^vx+5YY;L0Oo6+5WLSB@n-6l5?gF(Nx^aB<# z+(+V0zZ}FPPYWwN?@R5KhTxyBjAMhmScQh`{BDBi0$3=1qM71IqY9;`{iDVmVymOn z8kY%G*$o`ZsD&3>&`75c{1LGxCeMmjga<7PEQg$;-lgF%70OQ35XSJm7lb7(|A3r; z`s`r5>OX6{R}uTlC~6VGd1Yat_w#Qzul+Uf1ZhH|#a82v*wg4wwpiE=rD6@Mm5QKu z?yy~XlIc<`H)IA3mia-=N{907tOa3xN=T?dIGuDxz(EL3V2Cg0s>d(5Dp*HSO`RLL zi*I>3&H+*39~FO057dty0yia?5GIw58RF@CWN1x-1xB*6tTW~b+nJOfxyU4CJR7?; z?Q18J#Ct!a@OYa>bwPC9I;WE$*=Bn+bR;czB(MmKH_o^AuSYTBgr@U!I}<@!D=Xf< z{5B4f4x&G;Nc%{_Z=ESZg-TSMevA%aT46jct3nktIb~|toW+~W4~8|Mp6Q3JZ$%=V zXLZuQL&@aBpkdjPLIarJ2UI+)VGkSzUVuK9m>+-2Wx;mqfx`Q%lW7w z$bj<+?e?f|>F{pgfd>aA0J|oqI6*b@as?W+ZF8dyB=H2@47dCxyl{3`p&0jJEN(;~ z98@8?(k$K4??CMy;V;Yt17R9WeaoS+L5L;qdH(gOELv)F57Sg@^2gfk+wu0gr>cxbrkqTwZnBwfrVd@Aw?#^JGwk9M z=a3n@6f#$*;(?F#?^;aKK#eOcKPqFTor9Yzbmx7*h&~B-H8-qWaFn5r%fxTngOC_< zcb4yO7c{TMany@1=zxtFB{w(za!~Q#LUnq+H>yAPa4XHXlgp_BkwUAb<9Z|8Z9hUfmTS3l!= zY|lK`i6!(e%l{+a{lxEo>1&u5Y2`oc-^YL1|0DT_^H=?k{?GKE06(n%Z2!6a&-ef6 zTlPEl1KnTzZ``kaKh;0(ep-AL{%8Ix_N(4s(YN_uP>=5a<3IoVXnM^5jQ`2(Py4m& zKmU*Sr{XXBPyHX;&uf4G{hd8E{%ilY&!5je>Ufv=|GCe(f82g$Fz@gF41L)CFZlm$ z-`)Pu`OEun@}KvA#QPS0U;O+0@7rgduY`u}{`2;C*lXIaum9cuA?uYoufDYe{{`r` zk1Yg0oByr#n*W#2Kka|={fIxI2br-B-djNKzQjAPs??sERmWFkHsnc7D&wqV&1u=} zZRK$^tB$dcu@39(HU#@p{!A((IJDd#3^z8WqW$noFXSsf>RzmWpjW0|=<5trjZ7G^ z4c-54XsVmH2d@;pu5vdD!!PhPHrE#5!_|$@of+?I4c&m@7s%6!<_x&4mF04ub+yH} z7H9;UXI2^XusHY8R^HMe>3YnUqGr83!QXDC9r+B5x>K$rI7SdgLdexW;Rl?CR07O(CgaaE=G5 zryckey@0BACY-ouJy*sBKbxE<_=l^g5H_MedFwgfK@HwhM{j#nwBJu-51iUn~|LwoZO^*$k3i25%by(qlS22bgc_6eOc@vLG59rdVzh+p!>-*)6`w=5xEN z2@0`eG+K14(t~6?K_7NX3aC;%pBz}?vg)rnHqyJbdwjwL)26tEGvLIkw_^YC;)r{Fk z=9HD|&%F*f%k4}%nlJun5b{wWMNTT%R}ei)xgXcJVDD?eH3p>A`PW}e45E4Ll=cy3 zVAP-)$tl4DovlN=4TP@&k#zii;T7x#+u^*n9f&^{O5#;HfDlLHQjz5Xl>Rn%PH-4{ zSu>q(qf^5cl>qnrTXgrVs-Pu7BagM<+7?8lP~1jvuj!e<6*v)FaTTn zC>?h3I({PGZ9CtA47C?l`KX@VaY5*_A$xxNR0#PMrarR>RjL&FR}q?S7sTreC4O!gCt?;RnE-Kl)DHzZ$bgefEQcn&Ap-MBq`{=p!J)?qke(j&8C zt+{O`WjQ*<41$;2KUP4bp0JOj9qi}uX6v|YFqOfIWSkbh`uOl$&rmRE7`n$JhRvmh z4lmjb!ZWVYCD+&*|NK?Sy6e8?+7JvlS@jpU7X@)9pY6A5(@vRHkM^(N+QTAsmPVm zFFyPI5V<;_Y;~bcqFw7z*pJtrIRd!}+`-15Iv3y4IxWx@tzpcjZv7BKu~;Ya4K^vp!W#y`QQ6YLP&*_B1`%g!V`$ksJ(o@z}Cy@n{7%} z@Jl}lWF||p_5az|b@xu^)D^%*;-te2o!ctU0MfQY_DQIQQ)q1QgGzwyW08*#+6py& zO-iOMJR?F;=dQDv4qd%H>#9h8yeU%jQTqk^c&<2&83`1Q?%F`yFa@V96R9eld6eK! zoVF8D@YRP??(TaM4RCw=NULlMq;Bx8F6xAasv)ct3`0PMgOz@F)bwjz8V|N`jnB=o zQmVrN3gJ$0d@1Gd`Vq=u*iQ=93tOc~JZ_;&wuKfiGb${S1+gRQX8j=QdsnarJbNP6TZ|&WYdU-z) z&$jF+buf6nSUim4-utqmkY+`5eQ;aXe+cpZw_gvV;ctpFX*6`P{v<$7s;y zq=i1VHygg;GlEzDdxH#LlJnaOdM={QMmbL@+K89}J8`m`e~`t&qA8iL|;fMH0ovfcB`fvPT=oB$?d- z+CUe_An=Xu1fn?at>O;njJhMiRaJsq_MVm_{8;1k8%!+ZF&IwVQ+5bgR@*e$<)d$1 z*iPPZ9@_r%;##_BYui`-i2cL;glZK*|Hb?7vrp)d@}3Yh(KMM!{k2lp}AxXX-> zhAUE0L%Mn3FGeN2cx@qB@<^%h>(3bjB?u+wPGOSuCM+qxo}+?>Ne1~YM1`#M!wgiQ z6fj>xh6`@b`qf&C^rdQU99~&&{ekgDP_}F!iFVU6ZDKecG9}js*vs5lZyq4sbb1AfH>m>XSxLM}xUK6) zr+CWZ&o)2OKo*A0=yTt`3q2smdSH_oclD>)HDsQVGZx)wF#5FWsoGHM;v*fRMbc=x zW*7-r>N+|NP@#-RHoMQWM2E*Cq*uozY#dekNx@-#Ck-*vlK(#yU!1%m_98F8fl@$U z3vrK%2X)?etM8MGEk*zOlyTlp?-G*B58QQBZdCSFzl{UKd?^tz@->bv4G!6+4SZhU zREa@E=ASts8`vC6Vb=0{Pu>qf@uL>3g6P37=F<5XLRnAg7;*FkTNrZ@s7~hupawI+ zb=r#M5L63h9{I$DuwT8a9kzy#1bOk*37STt(XoxN7%ccCii>30Xtc-1I4ze%CiR5a z4%SFNJHmk10Hf?}Y%a9DFzrIUuWLE5AB*sdq=uw>r{gD>#+Uthd9ytKSi_Iihxl10BxD|tPfISI=FF!yt?*h z5PXa!7oFPIJEFiZDV-W9e@E8xO0U^dkad$^1bS}*-MX=jSC_fvQB9^t#omv64breA zP@ce+Xl8}IQ)br)nx9QJZQv>S6-Seba26YsadWN@@T09AtRI&OS3S4Nw}H9D11{-^ z17RCAP}$KeMS8eIvl~`=&`s)+&RMm9c)Z+MiEz6mLbQYa!JzL|rUe9yonN;2Ss}*l zJvo05twpSSN(GX!g!`ZqGpKvxu*;4T^(q{iztR;XFesuHR>B3g4n04>y z!~-fbxH>vdB^9edeCTc3U(esK?PgABW+JE9w%4AjZVQu%A>_Pf^O-X*h5DjobwAC= za*S}%d8g-T?M)il3_&M6)sjpbDVH!)&EIRjebozu>F#N%UoQeQ4rdtgt|1k>%SLvrNGw z*XRQ1lBZI_o~ybEw$9*}=pRkQs%Mu}CJ}$9&N_ePQ$E6~IxdF-Z|hYretPXj+>AZAESTR?%;>Ui+6-}(vGTHX7j0d4v7ql|ILbGVl!%9#Dt zP~NA{I-yKNnRyf$FEq-I$F)yA5AH)zwcuwg@EitE$W+YSq|-oKDLUFV79=&U%xGMzzgu|W zHPW!E3j`t0T?jI2c3sF3ZOHy<2Ur`_Nu>Ahqm1%%?_F9v>5Q~oXn*`8FxF-yB; zf~D*4`7j4U=gS^hwPJGe62`q-b1_(p^~UU@j~09KsXs^CCGTkCHuG$~ewwYOlyd5&%wl+l-qFD#f}3nY1Nw@j)qq4e^HRj)rIcow)p_pOq8}w7KCaADRb>^~WJ?`=19K z=mU^E{^YgFW;3=1WSQ0s`AhyMT34ay%ZK_`qxx93cNo>9%GtmUv59UrfCf!iLYpd8@cWSiX>UcActD1DEGLCmnJ~nC z+|(-+#7qPCk`U@%*PuER2AX1}9dN^+-$ZDXW%KmnlO$??DtdOVe!_UHN*7G5RqQ+iX{cUkuUD*@%Jof!*9T$sFnc4bvw&a7#uW4WZ zhyoedprof;o8y#c+4QV$5FLXPP8mwG$waTl$_C+a+^{IEXPfC9fs?G8OacHHaDTi` zr~+{HCaRMJ2#Ix%g>>n0X_7cdYAu>5pc_Y)t?@$f9#Z6k91av)I{*L1l?w~euq}yG zmhi$D1;46Z_iSxlxH?JPUwIl#m1B`T@HK$y3s+!wH#VK@M4I*6VSz_%b{#ao|Jx&N z9>OkAphzg^77qv$@2YL7lbx%sUfC%y%D zoiqKpvhgPbMyu~CoyjE{fN5G&wWku-69p=-2ZukC@0GhcGC2=dZ&Q?2E(|@PI-g@O zFTky-N@6=`??mUv=CAWIgCjoGghponideR%!=f8FZdWv|NWTc zLJp|KdQENT`6Lt!tg^h;m%T<~)6T?nN3WG^8m?#p<=tmN-T8SerIz%kp9RoU`X}=8 zWlvVdRUeZ6^kahq5Y5*Gy&C}S>l90S)8iu?!ul4O)zM=;Fcm@#Rl9z{Gyjkeht|P;S`xq$6@ZfQixk{tH7$0fGfm>0ZrGhM;?LIv$85 zPzck231m06sFOYJ|3zuPU!!l&CIf_Y3+NtN)Ed+DQ76p6AQ_gdyX!RYcR933NI9;v5F}VN<|(309&7{$6pMK0jyG)KgOc9ZAW;pQzyt ztEe4om6w%Uv%$Zsm<)t`QP#MIjU(!x#20VYkQ@I2GJ$sMt*p~_zxe}s5}pEwIb!Cm zZ20>=p@zu@4%S}_viGyL50HdESd_#TdR?1B)^*WojJB(y+C|lqRU>>M$QYdIt$6wq zeS#$n1WGxsR!fGL7A+Zx^13@ESVwWbr|1?EDNHNizXtdIr@h+&-l-y-i5y%}r0h4y zdUlof^6iRh;Dyf?X27y-!Cw_EHQS}_j^gTO^_ShqdJ}hH^;X|ACc|olWNT?w`R>2C zYr!Ofa`DT5Yh`&gJ5Wc}1VP##f;W}X*f0h(PG_-o?39Lo=CJuXZ~MDs;Bu?{rYyI$ zP#9@YoBGsx-CQ;mN+ee;nFkV^o2}{sG3^gVd2A5k_83tr`;W6|5{M0+rfRtEnaulY zEAIH-=r08mcr>9+#I`gK47lDT4>7;ZZL?_EDhUN{-3pJ|EwL+`J6bLZ5clc13)XkL zIuv_4Ke#M+uW0L7LH>`s`D_OWa$+3xzUT4!9G`<|7sF?g{7u36rE1iY98phw;1n1l zYz7=*ve)4sw>_)vK+v-rvo91jFlo{e(64k#{klBo!I!uOEvJH}BfX8vs`}*d2_x5< z931{*D0}`FK%*dKeuPa0%n|mzEjdZUoX^Mzkybsq<;c*UPUH_waB(_&c6Ro`e^S{Y z#n4eIGBK3DtdbP9mDHz@Oh0vWZjt^5fhh82yaL$tdTUG(lipkVb51l;mRV!TNnJM6wd4$kaBKe1PMXAih^<^kTM6M*Wbz0ZhG z01@z@ul84W@^9qmy$KCEQflC2Ow@hE`Rn*p+0Xj)k7}qsqSD)PU(l&Kyg2`TepI)< z49FO|iVLA!5K&zHG1X7F^T=9iI5byaHs}XrAO#Q)1=b>;{Z`;K>qN_8932}A)2EcC zDsYPFTTS&1Y2Y_Tojnxp^4}m!IMm&~-`u66{W}8#%U~jfhjac*U^eKydpgy^ZdaUo zrW98>JX+u~`CKrLgI=m?0jCk+|LM1}p$f$#C8zQQvp7zGHQSNztjrEnLnvGIRDzTp zrC%iwfUq||X4^JD4r^5x(f!KX%=_6zrAWkd#kZxiJDmS}XmJ5`N~_U(Vh#e-uQ z4YZLSgPgY~bZn9IB$0>EvW*7KFNm-U(%gky<7x;zDdzqng3HtNo%nCqR~`unI5c)j z-njXrX}Xx?^?fYV8tX@2P^S{>u#{lJqrJ|lhM&GPHcjrGgqWq9iXiU#z)hRh(EZ9a z%_0Tw7HVx=VdWoO5LDn#Y}RS6>W>iB5-dxvxK*&?*W(ZXGZfA4+ChT7Ku*tq001iE zbQ9r1n&9Bv*I@EMpG-df+m`Q>S$$Q${54=YC!8#vPXbzTGP1MB~m#`;Z{A?3+p$r!jaUFxhF5Jd&?r>EAK^HEu;DcdjFtA#5_=&hS`T=B@HrEcB&FH>;TRYNMb7wD$#?Xtg1yR?i-}B{e$3PB18;5@V2$R zlR@TUx!c<)#y=%L^0)N5-!VnEUnsH`=T9M=0>-?M-6viHOL3Rox1D+(OC(XQY)5 z@(0N)2iW3A-8I{bBt0Yc|02CNL62)gOO)imGA;8Tl%KdY95U0BGn-Bd8Ev?Z#O%fK z`~~JH1U~3U@knCUbq3W+N|l-{D6zr`!Hn^sJ?^R0UpU3kWO5IHEBY#ijG+5nfH>im zS-BE+XS5YOzbu*r%+bJF3j5ud4;?q}k3e{AfH3x;85X#{Ja;g8aTfUc)pDja=$$N< z81kI$Q9vlK7mbXcee2gxN9U0(Zs9&F6_>nLhp?10V0NTceN^SUYaC_~BC=iHs&T~I zFiCn>Bl5B#*1m5Je-&!s9Rgvc~5NhG?VQvU&hZ|4Zz~i^U3Xb`&{Q^?^L7 z%IM%cQY!PUTV53LUvN){(-uy>t7-25Q`+;m@GT-)*JZTh<;MkTvQ&z!I)1(JhO%Ia zT+-f>QHH`y8ui&1$Ld7r3iU-UHh7zXBJ3AEkv2Nf@#f(rVMAk=aXfsEhv_^>6+Db) z1-G>QMI3__;TM&+dG9_O9dZZ9LG1=?;Fy^@a*dGL-V*h0txEzzlPpYNLpSYG36Nkuo_1*>+3yfTY6Jb!~ZIK zy^=H#vuP@z9e;Jd`J1qBkB=`fkgNM>pLCU*PXVlaGry;XKqOeHcBTSA0cUtR(m(f4 zQ)c+v$HRExmqRtl^0LmZ`gNU&_&ZxxY!kjF)%|huW94TTLVl(95!71ir@H%iqQ{Eln9srMiPvM4l6ZT)Z9Kg^_% z+9{o^nl_Gpmvl6Vfm)1}+yOD3*NzyHs6**h)?QTHPz+OV&wAX?dsyV$S`2&yjM5~YLLMLq8 zU#Pa-38V(_#Sp>9WN1|AeoX2aVQcm`Q`H*2N){5;l-L=rpmUuq=+yNBGZ^S}nFK|z z+W&84X8&DmGbkAv#uQHP=e5_m1F2-wA zqg+Ohsp4sS25=5PrMU>Hk&IYgl#Yo^Rzx!kIgaC!F+Uu6i@MspZ=%1FBu1Mk4HVWz zg=0AMIf^uo-6Wb!L%5-bbmG{Hm^)HE)(Qkq2uF?wy&%~UPxXCP#$GrG+;cpK=>~U2bPLNNI-Bt7Yr?!IGc`YYlF3fOW4I!uHCx zcCjZs^J$z6w*SrFCU)ba^Bi|KbkvFW{;Ld#94LGBh+3}3yLiNh+KCm{U*NbufS-v@ z@k}*e7(Bx|_8aUWo&()rdBu6Ueb@hOH4bIIc7rNiz*oWhPxLuO%=>;5zl%~DAn3{A zW)_EEa&}3%;}9CFY6j*gQ1vR|6X5FREi(6YU}QQ$oweARWMzM2DQV8u_1n$CoZa4{ zo@*2bYWp7SY!fWLI{4#HrfV(T9Iv+hg?^Z^e9W=d9Uec?kqBS!iJ!c-;{u#zBP5J zAr*`ecNdfVbaSk+SCpfmfGlFS*8@$YIpKQVIZZebWul+cC4^V+48@J~V&B%yExMB` z?ja%PNpS_fe&&`ZZ-%6DeF!Xo))(&ND&st{mSLQo6{*XmJ3+#$$6pn-8z}nH89j08 z)}G|EEs8v)Hf#5cf$>R_VMMPmy5$|0(G&RKmUf5A4eeRm#4+19yF1*5^rCa^*ja!s z$upVSr@K%QKW^AHwM0afUSZ-MN_PFVa53J(k;llG3@Dh{S-8bVpt;^qdg1!@2AXXGGImb_}=P{p8 zyy8Y?>$E=L024?8*dk(}1q;>;<7F9rri0SdRpQK$&GC;17xn+DmWONKm*;qn9P|Uk z-+LqO=ct5yi7uwE>@{(s*t#GsawT*5h+dWUltUE9OUz{K$LHyT=N z$lzKzc6XzD;B+eHgpUJ2(Qx*+=^@InJbLj(di^Gzt<{4>c7x#ma@$zVV{75kr184S zDto}+w<&Z%s;or<-nJE|*Xt=+ZNyZ*T5`rq(!WZ5+lPxl z1~#HX<kWZv_F2+mkrs~?bIlA zgxefy-kVd0ZJ0J&HmRt>Y1fO`RJ*5ja~mXBS`2$Tms~<>;Q;!?K9V+a^$J20aKvpj zuVdyVIf&ObRi3b>-!XP%QJ@x-=nJ7;J`PQURRE_bK}W!1`KTrE1!S^hFH}RN)-z{5 z$SR`;E27V;VN=MVYpck;eku>aClJssoaDe$HUF9ia(bn?2{xcJ?Yr)jX{+DI#uGHD zTLdzL0qcgqQzllva zB3n}j%D$V0&VVORhCYWT{7)Y17y%q8bD$m$R>ke02)cJ*2j{Wq$bvLP{QGm3jmmu; z%9`O^X+G573yc7!=-C=q-bzjOaZ%x^Cev0Sjj=>CMEzo5G4hmxdJs!g&X@e~7n@C7 zEopG%1y!C>2tTJ((wmRv?k@) zfTLaN%0TlJ`jl6wjO)>;M$;dT#AF#RQz3hegK4itxM~n=b=+n$+48CaJFBmZnInER9(UXi1;JoYDeObZS!0pa zAe5!YEpqq%y_yXQ{VD=)$JP1NZn0dcZWyNV_y7QE1OX2Q^v!OOFGAm6!G@c;EPQlE zdG~h{LgD!h$puozF$C5|hG(J5yh9T49IR$QKq;{xrEHYe#_EU76cW4S4E)(V)rSE= zv6V!qWlq79EV6c%Ni!*M+Durw4s0H>5^ZwsbfbzN=7QlPfkU92S3wa4CEg^1nOu`j zDS@WLi<}LdxG0}~;|}c9As;}c2qvUVn_(}_$v_I4&DVb+?BDAv=@kNbNt?c()~(NS zf-%M4M#yWpL0aT+n~<&A7&lOf=WNdT`#?L&&CI7nj1~pVcuuZe9g#;J4-3otqI{W; zQ)TBBcK|YTjV5bk1J6Tqwt8e93TVQX+!_cZWNzBg{t`zwf@I85IhPuSIMi%Zo*Z)^ z`DZ{(RQK0S<_{P`@q~=sONfYWr*!-an?4&W76-~qI!!h`s{Cfylj-P+Ta}I4el~Zi z851X5G3vHADjXI!UQphtp8`9qxS*U1so1MLxqL3rnKP9Djh7H1!NBL@G;0MBFW3jf zA!A%Gb#Ywlm|qVsN`!saP|IhqB@rr=m`N~@01riCJeGVc<;c>kq(k(A-an9dBba50=sUvp?2GRjLEd(ATQI& zM&<Z{9oSg{6#>VS63gS}2#~9DKt4I31VK}t zb~;<)@3n6~SK%+rv_Mw{#{opDfXVZo!-(Ydf46Z(j3y%n>#0>FlLHLt;eHtKOfi-* zo>R02Y(ve~RIj_yKQGRl=ty|LwOH zE%$&WfD?Fi^<(kN=iG3X9Xjrf{sr*74;JTZFCaobai9`XluVf1{lfsiIvpngtYS9E zfKOxo2J;sOo57M`6VA$8OAFZztGd}GO%pF}%v&iP@`fT0Ro`1Fy2^kQfPP|n53{W1 zZRp^K3P@<@qhjZ)^}u9M!vrrq-jqT>-N^v9R}~|?h=p%IW4tb_rQ#jbvG|pO3r$+Zcff2OO zPi1b)XiWSfm21j;4hGiepz%4V8i-38fV8B^^a=6X=mC7}0xukYblJs8tDGW2xpf0m zbOr<>Vk+e4eHnTs4;N4lPu9YNniTltvD5)ATcUOM$#k|IcHrJ7)4|V zTCzHiwI+pdC?%hyZ)3K^q;U7uSff#eSr&V#Lb;D#O<;c68~Y#jPbCtd!TeUsSP4wq z`N3*^9!#R$Q-{J3q;Ev`rP*|9mjg6GLdvm1$c&9Ou5CJR{fkC+XnQtMS8OP+QLLR^ z&Nlu0)r^UXWSOPL!Fj@L_{b(07U(7a5w|axocwlK!@uI7qgrG*yT=Q*?HYz?+nRYo z%;vGa^HXk^OCvy#Df73d9ghF^Tcwe`*Q~!^d6W&Ll)H)U|4A^a&SVgcczNqxEJcL~OuzPRl}Sm}Ex>TxPdR60XgDsrHq#n3Ot#@96Nl`@~y zGfp0(%VqzruUOm&KJf+@v8um556@=(9m`9E_!CGG95e0y4uk$v0yh$x`0f$?)(MPvB zsNngjWsBYn0KzIpP@6HIV|;^E5y~K>cPuX}-A%*3Uzq2Wt($tY`~cp-wh<4@FxaF+=z2 zdQt^p3qSb1wZSvSfeoEg^x_igz^+8C!W-pTQR4PlV_|41N;=|rlIsBaVj%y15p?yp zY2ri|>eSz^_gMSYiB7GMB;EWp9&~4sLftDGtIoLy z+5bn_&VHEHZjy$GDL$K2oNNY-b)A^FTYXlc4V~s*;R+@@TuC6sS|H+9eP3-2%k1Zg zVoGg)`x7&35B^AxuJsf)N)jvmU+$PCzFQO+O6ysoMr%ozfQ^a)7tdcI7(IE!dC?T{ zie1gwrj=*hG`DvpBq=91Zz!|6`wkBRJVQ;)kXFlO{Im2;mmopRmnn$~u=AYXu25lhr_Xzo;OOEN0?mBGE;=n!P(BX<-sPNfloIK4gy|xpO|9uzOYPf)9 znXj(*J6_DVN`zA{+XMIVa9{2hqa5Y*32*8VoQ*wh{mEc9sNDsYmZm;w$(K$&sLJ-j z(Z^-<3_*;~|KID#x}JJ`o@(T`r(FXh82207?acgapF28#vbiE}kF{7A1{q7Roj~w-FrFm>G<_!dZO}X3 z4vXT}gy8mrJOI(7#qW4m2HW6NyE<$#D!B99WqBkX--+e1mPZ0hfelxUf zL2G!W2DXo4y;5Yc|9=i41&xgF(AjAOo_yk7?$zbOkgvKe9gMY4-K9Cw)PGx~Sy1Q$ zdUzl^Db07ie{Lx!30?6&3L(I(@|t&{O+o#3vomxxCo155XfbB$U1w3?^?do2r2u}I zUn|$4Id1e~|6q3pa?H+JN5OQX2QG9Cb}ZXL;3xr1encQR{?L&&TpfyRtA4B`$28=p z7>KN!t*>d|eNMW3iuc9qzVic{ked;=$gJh~N)yc-#jGy&GyPrnX#=$lt)sV01_| zeGzTPJ7J9}Nh`k)SOB*HF)j%Eip)<{dSX+%>BC9A-Uce~dOJDW{~mp}#^x zSSDvHGu_x6xqh6ht4CGXyv2D*o9NCAlB05m2kd5eAO7~T55~SST=wl6BM=TN2mc}a{GDk z!f%p~+3!xC{m@I3C%xh<%M~46bhs5vhn-ruY`}f+5#|rC%@(h0y#MCS$`|tWdIA@7 z25H!*Pa~YxD8$HbsStB~s{s*-oB?p*y+l9fVQ>a{0Wt&WfNS=u|D2jIBaCn@T+r)T zppLMw2tL=ulaT{0nlWu2pOZOE(t(0Ne-Rs7jPn8;qrgG~{Ql%kOXeF4=Y|F>wOD%2 zvI~YP@GmFWJ}W2xa=ez(QoheO*ztEJF(FoDP$5%y0v987u5-;at)1$v6B~Z|N-%&W zKW1~CpHA=q6IKN)Y!A{NCpn=Gg*kcG$EZ~9(bfV7SV~=LH>W(0w4vM|52g?Yk8NOP zIR^-WIfl6#!1W(Dg(*RZiaSvdu-_giN~CGf3damzlAQV~H{tfg;RfKY@1L83qd`eF zPqSZuv3m|Y?X`@I(ZN|sqC52EdLpc4ynCv~o81};eLp?e_5AU&`YX@DYE%3x_xZ?i z-nPT_Uc;V`Z0$;756-eRsuvzhX9&0FsEB&B(7y3M4ObMiU?{Pl7$5cCN6(NzOQCG# zg?8;%<*!yY)-dhFv5+|3`Qm!<)?-8+^+HX`0^S<^)Top3|A1&W#xdUHU#NGFHBR;o zp39<*paM9A{{!_Do0D*1eap1Q`&fc{9*4GjcoD zMyiy+7Z^hUahDnXUmTdfMc3u3K8*r^l3eQOk(>cLjDziVXofC~{>eroWnxZ}!`*9k zpacQP7JZMlpMx2S*-w7{tVT}~DfQGj%NP+l$09LJ!Z&V}evadC8!NY?-7om4HXyp? z*~JGo`ivx-7Cm8fL$`@om)JtZ=-F`}v>U&|!Xg zv2_as&pNwoK_YYitgvrFR>u<*qosYvMv$c$-if^VePv!I8@u>r8x#Jyc z581BgY6ybVG`-I8d$=V7JCkR49G8FbZA%g5Mi&pm)3<;QwQ z+7?^#%pwAh*)$%kDT*V(piGWT%7AG*Y+9m>4vNc8&#bx#<%B%yTG{{FsLOXqj5Wc+ z(5UH#t7Cf4yg>VlBC4Ae{3|DB5#KSzj}$Og=AOU{FCCmGP~BBkxl+76xfwIA3wl+` zADT!)-F-v~)u}hy%N3KYlv0`H=%<~(%`8hMG zz(}VsX*>s%oK*ZObUzt> zyUqK#HZ>#4FBP427;u8hy;Ce!(MEYKrL%&sVUx8b_oeRQuL8$O(ue<>9r>qX{iTAnB~L2!qe*p|Th zhxs3319Bn}smX-)_K#l*{A6v`tA>$V_M6UpPe6eUzECldOwU%2w>C5D~|!3r^>flB`M-rViYE<;S9 z++>t$51EYRIVJ+)$@d9a1r}*nYrgjjk2a*@tR2L7tSFflHgM8#8=f z)9#GR-V|H4RLgX47Igo{C=_iI5R>BYnq(y=|7)gt##{=qxhv-oGZv{=8KSTyEp-h z-D%!Ha}4D|yDU*R|2Z}{;S8$ySuw2=1GLd4^5D^-G#D`MMW}twIk8lFydrNkI-*r; zRK}Fmi3t!#q`@SfUo?nv35(07b!-);lT-vbRK9(h8vg?t`2cX!av6qb8&7UA%=9Hc zQG@JXgPmT|dcD%J1IKevF#yEPe}E88Val;ePgddy1q_kcKBp)}03Sf$zt_fJ)_B!NogLG+nb3%|UB=hEh+nZW*my;z zi5NA;hTksXX{K;-?O$$%@U28e427&7Sw=_FMYIw#`sI(2Bc<8uEbMXcD7vUKGhYKg z-PO6_5W|j~*+SMM7zR=B(J5Q^gW%zguehJbBq{(GDad~7!rpv6E(M#u@;0a`*|eQQ zX)b2|qK`0v~h$c)AT&#xv8g>?pQhSo@PkPmw6zZ}epP$ZI82lBc% zNxlv|dbTF2UulD8V;D4)^2pe#!eaQ7>^urj%!N@gUI-^IK}tieY|Ljzn()kR~04sdWu#GQ_WAvpBzxk~0Q>X?H# zfwpM6&+MBL`c&ZPs3UK{E~Bc~ewX{ZFd>>1#U&Jx^bPj`al6CpVYyI=UOl-Hbi+afjLK z$gdHog+3S?6sL$yED#LsT2rp_R^eDpRv+Rt+m>W)d_uMn#>cVwX*HzZ1z@8wpy+I8 zg($cH@TVuFLWGObz$Tg;SNG?=&3Vachn_c|B1;C6mt|qU!OSAp1WnWzN?TJ1v60cx zA7AVI7lxteol)z|L8tKR%x0WVe8sQ0asC}WZlZ=&W(ngrA9(Ie$vSg+5d|HKx^;S6 zX+>^IpO|$)%2e%n#iK?irl5zBp`O8yiyZuR6h0jFbR+7DBj^UMH3S)Y6bs`B%3@;j z6>e^WxBX_WFQE#@NidiHF^kPj>+kKytUM+TBILxNNi=y~9G41mNA-!Ps&Gq=vM69d zUydLVPw`k3Tl!DIUFYr~(uoNJ3H=U;VK+k!tHcU56+bJwt~id99Gdp@4!%La<*fpa zj~e`F2aTDAZ(w;U3kITspidBImcHK*DQ>jwkE*m_$kpFwL8Q3(WapK+F3fw4J1r(^ z{r5dl^W`~|o)v7ORxN3@hDv}pG@-fBiu}%M3KprIuhzxHzxL znKWiGS4K{Jh))>vvAGi_^|uhQd2acHsN;)a18pwINgRm?aq<>Igd)-n1lnu&yPrzN z`mx1um}snnmZK9~g}OiDIgmDWf8S4WARTCPi(zsvDoJCLJnRJLs~DNZb`vOW)?Tir zpG{=f!~|UIHXB_Y<2Tkg<(x<*1eK~GT1^%NJgThFCh%I(Ht01oJNj*d#pUz7)fq8s zkzW!Sl;nyFCA0wPahizH@Qh$ZCD+z15AFh?2Hxq`0VjUq5KxCXqII2^;*&7BS7iN< zb)WboK|j8eUO-u*ckl8&7f8}<1XqiT@GSixH%HG@?pb$u;|fY+&Mo|reu3dCs}X&6 z!lLPW9RJOO5;1l^XJUP8N??=7GVaFJYXX^sD4T+Mg%eUbK>om& z6rfsd6eEz_wMA1|wnM?__jx=+FzV@1=efJ14(Jyht2TuyPyVQ-o)>-29uRjLj(%t> z%eXQ(m>BmsNr^S6aaQfSl_(!QrothjIC`4wlO@$PF%ztfbF)@(ve!&7q34AUk)^1| zAH$` zi^h3hg6t?*f(iWHyd)3d)_86#xQ-kpq`d3p3E)!=sevY(8F=*N2#^NLyKk~cz{JCl z_G3LA@@$m$@2@Qf-?`*p7?0-ug|B!t!{EN7fHVK4I9of_qkUhAx>4mTAm|~B3{ln1`c}`no5=epi@h^kXkF+=TAwtnSyX>te0z&r+)4aNqw+Z;>2_1}{Gu_kpu65N{hn%sdL&dPX z%CwX>KFP@ijwW706$Yt^RoqT8(Nx=V{lYP=|Bb2&?>`W7O`Ns|JV3+=ZJD45_=6k_ zmv=V1rQ%rTp|sPBt()C6_UT~0>o&JDM{CGwk@h;@|F+z`&~ww^O3?DIFsMbvascb= zz~hE8XJC{c(yhe^me-+%w0hxeWhG+-5IE|D}`ll#K57zQ52|CCsL=II_xi zQsPapezsj++qOS6L&^1=ZJBzNj`vu(O^L&fk-s_pjYPu98$7i)MV7peN*_>?plo#u zbqgy`Y;}r60vZhN$6PY?{^8-GkNKBl5Z8F%hTK4yW0^hf+u+ifkx7zVx>yWJ!_1^7 zVmapU3cA7)jzf0$vKB$3-#0Y0(#s1n=7RN#>VCIwGYOTLcyJ?SUqCZ0n2Gh@tLM~<oBue+UlnAUBb*tUF6}J1?~T3NT@Fl8W>u1@e?uw!|M=0RwS!WSs0i)2ruv6$ z+4-z;`N4U)#{}I#DBf&LYeLeG&7)r_{$p-OwYL=4V}kax3eP_deyei7Qx2#<{F}jA zX*fOW_@910mS_E;j_l|qUA~oq?f)U89`wDw)K4Mb*`CZ>>_XT#uXWVCtb?-~(OmJT zslMI2uVy*rB(qIpJx(r>Kv3@l@;Llof;T7v&0=^KKdt|t$%&%N%D^XNXx%&bv-<0e zimy`NAO7VaBDT@#V5a04_HYEM%U^cv*?gV4Mk~GqD6Yzzr;vVmzfsflMbVo$d87o& zHj*)&F?inl*d)|sZ|MVcV zAMjkC;{{Ic>>5@mc$++tRjJ9AxHDl4%PtT5*Z>d`0cAV&FzeQgTK-SA+o*`N28nU* z#ILt?IH7Ey-Rb1>wji)#6v+1On(>gnW_R5Lzu_)Cqh5j5^cSdyI2I3b=#gB$nM+<7 zhP+dPQj#m$K@U-=@zypV{=GT`%n;6Es|^Som_y!u|L^z84ST>s1;oTya7%QX&6H5a zk>7+d77KpBDi0=oId(8`C=mWfD47-P&MAY z3Wwnzz`=ugeUM@A?XG)k$qismG-L~KIAFeU06o+X(q4Aq$nw{-a?=m5Xa-9Mzq2VW zF7PM@8dyjIbeTZG&s;|cr4&|l)` zyPM;WRY=K)UvgS+I01!F^`DWW1{Cj-CLfq1>h@qULtX2nPPTdBmNZ-tjWUqtJpgu8 ziDJk;SK34FK@}eYP+xvkPsuTGDMfCxm6WU#De=FWV~#CCB(V*)Tuv9azZPY{8!RN_)E5J1%IVeh!Y^!f$cN11Ah^i`~i0)2NY zJ#@TBpi5}fYQ`P$;_zXIUCt@`d&w=}MqQ8Gswc!f$&Rqstq~}UXDB*62^L+JFri}b zd$TITKC(6}iM>=v8#2n~|AIL$PkVy9oMj|yi*Hik$nOwQA}RtAo*cwRmfT`yT~)ny z!dvFQ0@K9S3BGrK?FAm|Nn^OP--9)b*3wlB3}z>;bJLA0&l^70W2m0n~P3 z$tV{s#q)P5hWY;>Jzyb@^-wZ^Wc^5WyRb*-nJPx5t%XSUF->K=)q0q;P@_pp**^F9 zl) zgWJp+``b@N_+WnG#i*j5>G z{DpLSbgt1Z{iD0?>O}Pp4>OVex+Whg66IiuV#Fl8vT9PP>RMY~v90z>oB8?*z51 zqr0C~ZSZ#CT9-K#@pLM_eo`kp9!Py>eCjvMp!->p=3Zp#h|ZyfZS(*`>Wi|VNmukY zWi)>{1{Llfd*9iMskF_zf2`WMa#3G-(;0{%%wa1<39pKGfF@^QLMj(t5L^WBPYj2G zS~_J(Rf#Y9uc`w+skDEOHT@&ckfL!y=X{)<%E1oowz7}rEb-xdNP9cHfT+l`20MU` z%E74zyS#}A5YPue=h6=RHGu8PL9!_it}4nR_I&b}CaC3@fJx&~Oxbb6XVmb?c4uRZ zqB*zcBNRZaWu;zP4F)jw5!U0~V`3EBQl{7LuWy1$8*SuV*gPLD0_xq%Q8Fn%=x7C-j-aZRzEe7w5390kv3635w5+x~kOw_Z&Ed4!2 zy#`(~eClAyb9fVMLWr8sOlN@Re==T?Fna2R#3hT@;(nz&HGrU&^!#-gE3S0WD`M9h zJ*qd!{l^SO>Gcy#Is5uzy|r-$llb?hCP&CiN^AG!su|ikWoo+5-KWs`?T%iy(SMq% z+pt-4G^Q~r8`I;_* zBmFF4a!@6UkoQ~$Rh@(iU`||<1_Y)XDuFsJ>?4KnaPwm!w20Ms@Po0|ILMTUba;~8 z@!iwr=?9}G1Tu?8#@sVi>(fM7g=+Dy!||s5aN2~+%IO6k7R<9&y~WO z7eZ&%{{>g;H35{6x*)STr315p_IQI~hsr%Hqrp|l&XM6RX}M!ZZq?yGXH>OOG+sZr zwJ#IrP_g6{mtl)6uX%YK`>t}Afgp>~ zhqHTYn9fOgQ|*h$CNLYbVy%f5(41-ht6Jnf3&9*Nes*deckU-g(X3nl`s9KE&y<}uw( zRunuM@DsZoP(>|f-C1YAEdqNp48bccYEEDluonX=gL-=XSL0vKZe}vCB6e+54(!YN zsU%y_Nhqc6G3?@Mgi8;ThtNl|1~2t0D;7LF>@N|pd}Pr_W$l{&SV9jU`JQ^589)48 zEG8Nl@kUGG^L3%kyP}SV2FBD)@a1RzgZ|XThvX%gC3+(`7+h8DHE7-!y`;`F%-#(I@$1#e#m4 zzV_`=!ci3CpSzJ$h1tGCPa9L7(xnm}VuR|+OKbpM@q)3RrwQr$xNvNZGTVDYp-x%7 zJQ(jF7Hz;rn&6(IKZ|dN)z|+E5vb=1tw8xjZBdu^BDlXSH*|LCtmrQa&eMzPA;hPGr-fxY`z?S-*1m}Y!d_JO+Rr~bCm2h& zKue8X5I>8{@6UHTYqrI-wy)|@p`Ib#1qOvqt3I|kFtpbVD33a4=py9{{!W6?yBXo`6(me z-O&K36PGgH2AL}~?6x4~N+4 zHE^d+tCG~6nl+8T#5^Im7r4!=`rmDHJgG3{Z(t$#V9Z>CdVOVfnWMX~UAG(u{A~jm zM)AY32jYG4Wf_5+EL}6`xGV~YzKb9s#y@sWTe+9hK!Y2Ui8S~!n`_vkrX3gmJ;gH}ZzrUeE4q7Xxus&}(+t%%Ka%z0wqRa&P%$(4*yk~J6bZ-h%tkA|w zG#iORbktiAaxQoPwv=JD5O{|T-BlRR6}v_ozhHm5Q0y`PXZZvlWiSG zC65r(BW;05xwc8#tP~2J$l*E8HLy;T33-|{ClQ?L4~>C#%FqW)HStR(NyoWD=+$VB zk;Xz7RX^ZF@wR&m1De#BgibcvG*}mqbPdGJLwP;XfKLWFiIm>E;zUF8mG$5Dhm9%j zwU@@Uk^l2A02JQz-yV*p`JVVM73jS&%drG)Y`*=OuFu&8z~J1iD32Ot^aW-xDF&r7 z#}``DU2Q{pCPoa*hW!9UVvBbE;8BGkjzJzup6uXYN&q2Yv-6KviVbZ8hs}_`xSYBaM=O{&fAx4DjSzSQnr2JsP0vy?dj`mqKfrG|Le- zf1p0VEjy7c;$&$T%*0#jW1fHQcr(ghf$W)SJFi5>@~op|>#W?dkZI@#y7y~|LZE#l zSB|)4yVM#v?nDs9O z=+G^LgWY0$K&6vY(geVnw^pjrW(4W2W{n27@foT1xb^>lIjDV{nk?%nj9B=Ujaeg6QKz7)bQU!LBU-)`I z*_w2dLB=y0npSv16F*Zf;U60S3V@LS)SBeJJL$5YA^g<;k&TJ~A<{7Xpv%) zbWu~YDrEJ?skzi4BMTM8TU3gsk@1-`XqV0rZmS>qNj5H_+}*J6I2w}$XsfyY6sC$> zU{$b+3z^qaA)|9-*Bf3P(Vzzp2V#Pp{ z@QGNontA#pj9U zVZvuT+#P{CRR$2}utgJLcye*xCARW9Zcqh;>hMGm@f3IUh&41$T4|W6iE><#IQRc< z0JdZmLFP@2eqg;MAH#`8=yrA=hf*t5M6bz4iB37-;-3OUuM~t7E3uhXYGZZLZt&Ly#af6}rNu&FtalHW9DY9|qC+IF7hU$O4O~)gtlyvXqWhLpS zdk5NQIv8bMIfox84Qqs)lqJ~(4J}ndB*(-mQTU~P7{9-!s^^e;{Pt?^xxiW=A3ct7 zh4c&dWc9!i-coO8iHoiz?gz#hx^3g=$dyZA&dR@M;~v$S?e3)@iCqe)7ku*+eNche zeebAF@A0}``mwA5~~SBCD-%hGj?c26gRL>T(eTF?$`S+0xL?tjo{49{lIEW3d%Qh5zg0KXi-!i4@H7`sN1COw z!fOfUmdL|dFI>RRQo1 z+-tCt=B_(__PHjlvVhxuahH3{IX}c#FZ;sWvqWIxc z7Y&-pLrJTQOuul94quR&cI;w%ZZ5YJ>2!6D!ZKD1-Flz7F?(-650-~?bgT=GBO)jS_l=t3Mez4x3Gf&n2b86guQ zBFIj?TS!>p{K`1E1a8+<$y}^%S*mT^HB?i9X=Qa-4yIJ_Mj7gd2go9=<=p!%n4X-# zv&OaE_b6?~np$NKEQuZqPMvV|B-H46l~|6>Ge4=4^-Q?oQ0f5GdCnpO6DbM%1`=>N^j&Py1ZGPSEP#*dZf ze*Lpd*0m!Jvzz=_*yAwq#oZXlk;0f44Q={OP1S|5TlklKDO?Cs*!*N9${$5Pw){Cn ze->9(wP}t7bg{38r`NU`Y$IS(H_l$E$|KKdZ5W4fO!>B-$no?&oH27fdtd!aO9+Yo zcvAm4vvA}$dx3C}MQiWgn&EOWHhD!v1lS;U8lXJ$R;ng+0D!@g`$>7D{6vdv2dxgL zQ3a44Y~kT|?gSSiX-h04G{sU6{253f3HbMoR;YjvY(PvpKXOu-qc}t=Ckf`cb{tGsh920u%x#N5y1Pe-KlT$Lg>L zh(dsf2p4mx$$!32LZTRB)P0F6?c!tnB$2uJ$MCv-H!ALUndY$xi!XW;u*rb>t-Q;U zW{%S#RL%*YDK^Dz$VU!nR{FVRYbr>d$J~(dMSW0*q_uBjcqJ zHuDpM|3X0%Z%~)u$;ym9U=wK>3b6xLojKfeXO{ClE_B|J&ezoAxKQZA2_4Haza1jOsV@DV4`;>E5ZnP|743;stH;J$SP1_XH^}1r*biXKXeqc|-MEWypt=Hzj-{kw`x3WY_{{R! zLkf3b`Nt{iEoy+L=?q~f6Y0Gv)nO-(!_q*X^%JRCJEla$nC~`rkaif|$Iv+h8(_4Lte{$;MN|}+k`~*sUqk=Y|?Vo;%Qto-_HL~CUR zzSFO62-jXFGSMhn5A|0oU$;Vg?f+^~h?MzvTrkQAXn)v}F(9>+c-(_BFL8}n;yNqk z(GpG-C1lI;UcRowQOdkx z#vOL3)!+&Iulhz)vX4H6?(lcBgR=NP)o=433I40bO?Q=H!z~J?Yh9Uj-;;<`4q0IW zDg~x50q#0Z%m3YAOY;%}Pl&7amJFl9f#lx^BaG`z(TF*)k1y07)t!`_JMiPTD*mD% za!-Dqi-~QwS3tDPDk(B9SHJjW5ei2aux!M2E5G%RbcJx#IFd6L3Zqq*6MGYS|tJeApPpUm-eU$}>O$;7~-Y zTuRcr5~Y6OlpQUx+Gg{3Bk}@@X@AzLxOk0{(Rt3K zf59+J+ydb-C$u$_ArDc?&wO$ADc6#x9rdA>?@^3$dPbu2+yn`Ej8X8VH5r>tx*B4_ zZatlWU{?raozL3>VkbDqn&_Wv^1zBIQ4ujonU!_BFeELjX>?Xz zS{xZ= zoOULBF8{s}F)8!w+$|`h!?;*UWQ_kDEPut=tV8Rxmt&RSE0AEO{B8hy+g9mc^MwY9 zL3)YR{Y|*jieYveBwHZld!vcO<+-MjIL(`($-#4U?}j@@>VZ>l;|CU5GEqHDtXAK# zT+mG}il)Ogkh|h?U;qDLAs!`WxQM?~7(4 zLx|6!>bqukwTF%jV20{H9UA&*CvDYYnZlR!{eyZ?FMAi#wQnHYT;%6Ec<9&dL}`SA zYay_o=_u`DI3*CLaS#_LeBt!y^Q$tss|)(dVe*pNd=ONOmS+3~;_c|yM0mym_wJDe z_!=5TU(W^#Q&Jo&Jjv$72PXW0Di#0e7S+T6m#EtoF{DO_8?1Y%+vB3pa87TdI2|vpRcAyWCVQvt$S=2=hP0!G$2XI}?cX=4@4(<46>55>|S0gcB|!@C9Z9}NI;jwA&1k7WKsAx;p(DcX#1 zgl?I~hRfoJ<u%pE&HGF=8Yah{8v8X9n11(Zti6n^F;!ka5V8e`RT zdBaJDH8%_c!SYXmpum4x)y6rz+@DYBt(DX&&g!y4K|Q(_v}-^t;m|Xaa>2&K9Xxbnyw^q;tSbO^<;ZSUW4AFC zf`+xnLu_>3-OlM7T>2lT9;>}iq}iZ=J{geVGuuuu2put-n@%P!*~ZMv*6infNnqK8 z;aS<-&}?3(hl|g1@ZKA44$asTjMs!dK}u);JV9Y5OdS;O{A#vSMnv|Nhcyap4Cli4 z|L&mY?_8Nl1S)oLf}@&nl;*BJf`~d3UXEeZ9ff>{WKWL7GvJj|YWO084&O;1=Ty@B z>aG|*aaTJ_s%lN1-VHj09))qmGWB+S-J-JZQPHnj-O8sP@oM-| z+i(7lELc$)Cxj0<^HAEFtM1EaY~1!v4B4HrqEuvsZ)RNRR-m1P!q`%)2^MRw+6|gKm-U`;hWm# zJ|%|F%XSe-!m)fl)5Is=Q^rggEYl%=f^Pt_dt-t*Xz6cX2+HokP*~p8pPRO`vk&gD zlC$xvo@^`n`2aS?@I?QdwxrBU@StYgz^n^m;P#8+TAERTz~rZyM+c2|@3QYIH-OUP z^9De65u$U82`cY~@^8*m5yH};H$;)POF+)h=!q?=!*Co7`5E0#kRTW^f36C%b4nIWM zGkyp4l#kG+yp^C$?`y_3MTw7Y*%G<8A@9aK5X!MhKTme8>bJSIY5Ew>6LPk3UuGnC&T?V>9vo zF~x1PQ#UTA<>HgOefK$qprkb$0skUGoPOT!$?4umz=)*)Au&W@;?g?)^`c;f*tJ@& zD>cc7us?@W`16s7VU>oCIwd?&iB6pZJ+Kh>aPuWF*({~P8kt0B&Lb*2n&)LGW1EW& ze{JV$_RQ51CTSkgiKLn5ws{UTQ!1ze6)b5cO&42#h z09G@bAQMBwN+g=Z3vlMRh;(4530IMYYjYU1Yc9)F8QOVa|8Jg9lTSqdLUesf=!R>I zQI`9Z5H)yHn%T8z(40kLXhYE-&4T@i6NO4Y?}pp1-EB4Uxd)t=MWOzZXq&kuXi#Bx zIYGgs^Xh=AP})8EwpcRb%@V$8oQ^Rd!r^wK@N4&=ecor2ztmTkCsV4%bH|hHAZr2w zo~ke`hTrB}azSo$%Dz_Cs!9 zmV0LS-fH~3njO+$kq)$)S(P&^LkU%Bp8AVMhgFu8Dyk}Tr>TjMkP*9uNS5d7Gf9=nK0UFU2hIZ4uh5EngEt|Y`64t87;dh+K@ z*(c+KIhnR+5jOi&95X8=30tj^lY`($PwzFsHRE<><#5Pw-z9)?>T%>aQ!wLck^c9S z)0)&aJJaV-L0q?%=StEtla6$kL&d>UXE>OLg^e)5+iRWpWw@U&9_kmCaD~FD&J4cp zS{0W%DE%aNv#?cA88vccxs@TKITZKk7uAQcbf=lA$&z2lB?ogY2OV$_#S2D(d*;I~ zFI&cW+Z=N;USu1DA)xgU3*QCg}5w83fWfj7wpoau7P#0Esh$?=Z;MYZzMmJzS) zNNKui&JU$A=8rkbAksYoHEgwJR`$-n z*Kz>#QqQOT&@3ueAzh0ZoVJCE>&8C0;ogqz`-Li-V8TY?9wMR6RqB#bV_h%--BI^z zXfe`ZQiE6mTUlnrg963D;yYOBVHIg(_c#o2#dvR1)-&BG7KhDc#0D=(OR;~0 zAz4MwwkaB+b)rlbZBtxjdEj|T>$#jsX336Fad?^!{t(ne)Gm&^?Im6Ayz z*?^52B6|Zlfqq}25zMn0;>LXx!RaLnS_ATR<}K6t?D2rD)n57lbcVP|1y;+H9jUZe zfLbP#x=ol_Di#F5kcF#XmA(*1EgIyf|FBxBZkCV&c+SuYX&UB6`$edXEuCjI;VK~TqLRm zfFYB~6wd=oM4u59p}@n<717LFcecJwRxV#Y-%+CFe>% z494C!JSro~TNl>7!%OV{BurakCv6~Ou@oDiOd}u~f0an`K8Nt~qh`LA5%*u?MaRn1 zA281feMl+-*(~!GB8nFIZkm!-`ACcr<%ZB!aUk(sxbFD^0qZyR9SFu^3kZ)zh3i=e3))o1XH#`DP81!?aJfB4jrw zT9ho1f66LqXg z9mU@8NvIddyD^kk2%0~1&ggT@7_~(*P<^{aKAge5LVY0ijGcS@$yPIJgO%%N4~!1} zwe(qq#NqcT$+_ysL9rT&MTEW!us!=pcOE;4({&{dOU-#cY=%#AG_I?fOZl_Z;rRGp z1qc6UYGrKAHWZv;S3nZWG@Xjr-wPiFWFM{5Wpx9DrAI+dIK%p}ZKt$q z`b;9M6`S{Lzbuo02X-u*mXPar!sMvtuCtL)yAElz;<}l+$fPhNt>8hsOfxq|XOMKm z5nA6OxvWW~Wbhxk@1qstvWLqOUMEydV@LmoffKf+SK&Q7sa#SsAld2gjijySZn2H8 zN(S8nd^t&e$?iez_3`BJ2?S$N>MVS7FJHhv7``%+m5ht0l*>*8&r_v(Oa0aAXM`&_ zF#}@mm?I`NrR6qbvu-qP*Rm00B?1_NdiWrOh zZID-W!k5()F8rjvK_!Ey^CJ*;*N-yajJ0;fDX8F?Fi)4(0iSUU0vURzJagiL!Zfhw z)BJAxcV7k6s7)DuB5HyG3P&Y-1!w~`jv0OBs-ZD`tIxML_px()#4Z|dsZ1KmC!_TZ zmF-^_gIj?G!c(kXT_9S`u7)ASodLoa=?lho)z5!M@mv}|js7=rzFR&5w#lhnGN&&( z`PNiUkkoW0jd3KS_T+`!Y*XF;Xxl4gPkJnw0~H^+PPK-%{{Tyod8E;M*Q;kdI3uc5 zF9~fh0s#e8WjMKd@wpgXEx4`B-y!8m&HhC z+%isCo7=~=vllAa2+&$CfvzFxfEKYaSdN(^;&&;`x=|HVWKWC0K9TaInSE6Ix^7JZ z!sjctja0%KA=w><7?Ea*ZMH9zR^mma`BH?H#6WBznMKF+=zwPL%YR%eZgWoX$06V3&d9LV0IJO0{;RA}ls zXNuamU?vw5;N5EaZWB!QVcY}NCN-Y*djI6>lU?qO%ADU6@=Hy;q}j`;9iX>?9V0&T zxO$BJ%LiN5+>?sy<~xBTnTl6H2HO|+TKt6>wVBDdhiRYq(Rm(b<3w=9fg31)|7vyD zMV3bst%NSTD247;W-#i7%|1-X<-KR_qgh0khrF#gzA9rKBy)6y9F3t~`h0lN#PAQ2YH(xrU0Hp%tuytVhaK77!6$^RZI0F#+i;K}{ZWs)qblwb5EV>sk7qZWn^j^7*8QVEUg2|T2s7UJx@HkIN!ghvBC}i^ zvZPMZdGsT%e<1%MEb=oB;RY?jh7<7EO56#KCxcd4a=y92!telOp9aEgx>I_&ABr_t zuGSX^5Gp5hWbruxeMn+_Swmc;T}H3b<&S9l+VAP2PF3JDPqCXb-|nx>pjwpPlo<)L zx`QVR#mX2+kJR(*_lLwD3t&Ez&2z&)>7H=#rfo~YGCB`I0C?U8@L<-MR1ttSzfNQ7 zB%Yht5A{W}2B%SDr`x6gcKZZDghbeApOR*i>CUv)e@_4e2r0Ek#$85^wHUp_e|W<7 z>OU1JS4m|^kx-H*BE<1m9b; zVg!aG!xok%A`waYFlbbkvzZgG()~Hrs_W+P=hT%5%R+7hTO^tRh2XA6Lq}0{P8cC4 zfX-F=%vf^-8HlXc2b_?+GZ8?D6t~Q#_=;F;{$rJlF1Zx?RZ?B^gW)M{7S$CJ<~y@F z;k2!!oVhboJgOx5ex%8_Xgn#9GI{NV+$$pNy#{u}0<)0dOS2*lNJ#$w6iJV6{hXIx zFAKy_l*v`lt)SgaU(#O5zC#tkU;KT5I`@dMFcFCty}j98S!kjr#xaeLp6L9ol%wRT z2F71h($Q_-wxRsUI4xZZxk!XOUK01b2<3X`=Q4_+^!v88Ul@fx~A(b zq{?(0)8jkdkW4Dr!2*n+e@$@e*^~R5{l~p!#5?%N%WGg?xdt8&c9J<=m?5l{Zd&KT z-F#2e4>r#BI4VeR1dYI3|m=KM=s*!o8nsX3rS&oxYjULl@YrkS(W6F5y3WBX~OhZr=J{v8_>IIB;%ig!v?IqAY;|jy8q?7@BUh2_d=M&mQhp ze~QHU5|&~NHJHB&SIZyH2wXLwFa%ppJpt!4oK;)f(z>L5q47Jsu-lXA z_UaqZdyhpj1`X`l?25S8mG5N)ub;MX0C8NHbPl)yHKFJi|Bb(>h;U7*E4J%irMy+k zcN#(MV%lTaxpVrkZT zXzy&s=2D*jLn1?Etmlh1J!@Uv65&;6?7kAK``xw2KcO5kwe06yz#n;>UZ3B#2$q{cvU-%Vc z#GIQMWOt|XKH2#_b + + + + + bookshelf — Showcase — Blender Developer Tools + + + + + + + + + + + + + + + + + + + + + + + +
+ Examples and Showcase +
+ GitHub +
+
+
+

bookshelf

+

A procedural bookcase — two housed shelves, a base on a recessed plinth, lapped back boards and a stepped cornice, filled with thirty-eight rounded-spine hardbacks standing, stacked and leaning — carried through UVs, bake, LOD, convex collider, and Unity glTF, asserting recomputed budgets rather than an API contract.

+
+
+ +

Rendered headless by the showcase piece itself — click to zoom.

+
witnesses Recomputed: 10908 tris, five materials with 338 wood, 2050 cloth, 1066 leather, 228 paper and 1976 gilt faces, UVs in 0..1 with zero AABB overlap, outer AABB 0.972×0.332×1.176 m, zmin 0, hygiene 0 including zero coplanar cross-shell pairs, both sides on the floor, four cross members 8 mm into both sides, 38 books each with one page block 0.6 mm into its boards and two gilt bands 0.3 mm into the spine and 0.8 mm proud, every book seated 1.0–3.2 mm, 44 mm headroom, thickness and height spread 2.90 and 1.65, both leaning books 0.8 mm onto their neighbour's head edge, zero unplanned book overlaps, zero right-angle wood edges, convex collider 68 tris. --air-lean and --deep-lean exit 22 on the lean contact while every seat, the envelope and the overlap budget still pass; --crowd-books exits 23; --uniform-books 21; --tall-book 20.
+
+ 
blender --background --python showcase/bookshelf/bookshelf.py --
+ +
+
+

A bookcase: a stained carcass with two shelves housed in its sides, a base on a recessed plinth, lapped back boards and a stepped cornice, filled with thirty-eight hardbacks. Twenty-nine stand upright, seven lie in three stacks, and two lean on a neighbour. Every book is a rounded-spine cover in cloth or leather, a page block glued into it, and two gilt bands tooled round the spine. A showcase piece, not an example — it witnesses no API contract. It asserts that generated geometry meets declared asset budgets, recomputed from the finished mesh.

+

What it composes

+
Shipped contentUsed for
skills/mesh-editing-and-bmeshchamfered boards, U-section covers with rounded spines, page blocks and bands built on the spine's own chain, all in bmesh
skills/custom-propertiesface attributes (PlankTone, GrainDir, Tint) read by the shaders
skills/procedural-materials-and-shadersgrained stain, cloth, leather, ruled page edges, gilt
skills/bake-high-to-lowCycles tangent-space normal bake, high onto low
skills/engine-export-presetsUnity glTF (export_yup=True)
skills/depsgraph-and-evaluated-dataevaluated triangle counts for the LOD ratios
snippets/decimate_to_budget.pyLOD1 / LOD2 COLLAPSE chain
snippets/convex_hull_collider.pyone hull over the carcass
snippets/lod_chain.pyLOD naming and ratio pattern
examples/mesh-hygiene-audithygiene combinatorics (copied, not imported)
+

The budget that matters

+

A leaning book has to rest on its neighbour's head edge and on the shelf, not in either. Tip it a few degrees too far and its board cuts through the neighbour's corner; not far enough and it stands in the air against nothing. Neither is visible to any other budget:

+
  • the leaning book still stands on its shelf, so the seat budget passes;
  • it stays inside the carcass, so the bounding box does not move;
  • the triangle count is the same, because only a position changed;
  • the book-overlap budget has to exempt this very contact, so it cannot see how deep the contact goes.
+

The piece finds the leaning books on the finished mesh (a book whose largest face, a board, is tilted between 3° and 80°) and the upright neighbour on the side its top leans toward, on the same shelf. It takes the plane of the leaning board's outer face off the mesh and measures how far the neighbour's deepest vertex sits behind it, as a band of 0.3–2.0 mm. Both lean at 0.80 mm.

+

A plane, not the cover solid: the board is 2.8 mm thick, and a head edge driven right through it lies in the hollow of the book, outside the cover again, so a solid test reads a deep cut as no contact at all. That is how the first --deep-lean passed.

+

--air-lean and --deep-lean are the falsifiers built for exactly this. One stops each leaning book 3 mm short of its neighbour, the other drives it 4.5 mm in. Both exit 22 while every seat, the envelope and the book overlap budget still pass.

+

Budgets

+

Declared in the script as named constants, recomputed from the generated mesh. Measured values are from Blender 5.2.1; see the cross-version table below.

+
BudgetBandMeasured
Base triangles10400–1140010908
LOD1 ratio0.32–0.620.5000
LOD2 ratio0.10–0.350.2189 (0.2198 on 4.5 and 5.1)
Material slotsexactly 5, distinct5
Wood / cloth / leather faces≥ 300 / 1850 / 960338 / 2050 / 1066
Paper / gilt faces≥ 200 / 1780228 / 1976
UV boundsinside 0..1(0.0004, 0.0004)–(0.9996, 0.9996)
UV AABB overlap≤ 1e-50.000000
Outer AABB0.972 × 0.332 × 1.176 m ± 0.0200.9720 × 0.3320 × 1.1760
Collider triangles≤ 20068
Normal bake{'FINISHED'} with image data{'FINISHED'}, has_data=True
glTF exportfile written, non-empty~786 kB
Hygieneall zeroloose 0/0, non-manifold 0, zero-area 0, doubles 0, n-gons 0, coplanar cross-shell pairs 0
Grounded AABB\zmin\≤ 1e-40.00000
Named sides2 sides, each zmin ≤ 1e-42 at 0.00000
Dado4 cross members, each ≥ 5 mm into both sides and ≥ 6 mm clear of the far face8.00 mm in, 14.00 mm clear
Page block38 books, one block and two bands each; every block corner 0.3–1.2 mm inside its boards0.60 mm
Book seat38 books, each 0.5–3.6 mm into the shelf or the book it stands on1.00–3.16 mm
Band seatinner face 0.1–0.8 mm inside the spine, outer face ≥ 0.4 mm proud0.29 mm in, 0.80 mm proud
Headroomevery book ≥ 20 mm under the member above44.36 mm
Size spreadthickest / thinnest ≥ 2.5; tallest / shortest ≥ 1.52.900 / 1.645
Lean contact2 leaning and 7 lying books; each neighbour's head edge 0.3–2.0 mm behind the leaning board0.80 mm
Book overlaps0, book against book and against the carcass, designed contacts exempt0
Edge treatmentright-angle wood edges0
+

Real-world size: 0.97 m wide over the cornice, 1.18 m tall and 0.33 m deep. Each compartment is 318–348 mm clear, and the books run from a 186 mm octavo to a 305 mm folio.

+

Construction

+
  • Carcass. Two full-height sides carry everything and are the only named supports. The plinth, the base and the two shelves are each housed DADO (8 mm) into both sides and stop 14 mm short of the outer faces. The plinth stands 18 mm back from the base's front and 4 mm off the floor, so only the sides ground. The top is seated over the sides and the back boards; the cornice steps 10 mm out past it and is seated CORN_BITE into it, its back held 4 mm short of the top's back so the two do not share a plane. Every board is chamfered at 2.5 mm with material= pinned to wood, edges sorted by index.
  • Back boards. Five vertical boards, lapped 2 mm into one another and every other one stepped forward 1.5 mm, as on apothecary-shelf.
  • Covers. One shell per book: a U of front board, half-round spine and back board, extruded up the height (SPINE_ARC = 6 segments). The boards are tangent to the spine, so it reads round and the boards flat. Every edge over 40° is chamfered 0.8 mm; the spine facets (30°) are not, and shade smooth.
  • Page blocks. A block inside the U, SQUARE (4 mm) short of the cover at head, tail and fore-edge, biting PAGE_BITE (0.6 mm) into both boards. Its back stops 1.5 mm short of the line where boards meet spine, which is where the band ends lie.
  • Gilt bands. Two per book, built on the cover's own outer chain round the spine: every band vertex sits on a cover vertex's normal, inner face 0.3 mm inside the spine and outer face 0.8 mm proud.
  • Standing books. Set along each shelf with a 2.5–4.5 mm gap, spines a stepped 6–14 mm back from the shelf front, each seated a stepped 1.0–3.3 mm into the shelf. Each stands a degree or two off square, in a four-step cycle (−2.4°, −0.8°, 0.8°, 2.4°).
  • Stacks. Books laid on a board, spine out, yawed ±3° alternately and shifted a few millimetres. The bottom one seats into the shelf; each one above takes a 1.0–1.4 mm seat into the board below it.
  • Leaning books. Turned about Y by 18° (bottom shelf, onto the book on its left) and 22° (middle shelf, onto the book on its right), seated on the shelf by the lowest vertex of the chamfered cover. Then the leaning book (or, leaning right, its neighbour) is slid along the shelf until the neighbour's deepest vertex is LEAN_BITE (0.8 mm) behind the leaning board's outer face. Each leaning book is taller than its neighbour's head divided by the cosine of its lean, so the head edge meets the board and not its top corner.
+

Findings the budgets forced

+
  • Coplanar page blocks and shelves. The first page blocks sat 3 mm short of the cover's tail, and one book seated 2.98 mm into its shelf put its page block's underside 0.02 mm off the shelf top: a coplanar pair. The square is now 4 mm, clear of every seat.
  • Every spine has the same facet angles. A half-round spine of six facets has the same six facet normals on every book. Square to the shelf, two neighbours share a facet plane whenever their offsets happen to line up, and the uniform and crowded falsifiers did so (five and twelve coplanar pairs). Each upright now stands a degree or two off square in a four-step cycle. A half-degree cycle was not enough: on a 45° chamfer the normals differ by half the yaw, inside the 1e-4 parallel tolerance.
  • Planes facing the front. Spine lines, band ends and fore-edges face the shelf front, and two neighbours landed band ends on one plane. Each book is stepped back 0.9 mm at a time until none of its front-facing planes is within 0.4 mm of a neighbour's.
  • A stacked book on a page block's plane. A book stacked on another with the running seat (up to 3.3 mm) could land its underside on the plane of the lower book's page block, 2.2 mm inside its board. A stacked book now takes its own 1.0–1.4 mm seat.
  • Matching parts to books. Page blocks were first matched to the cover nearest their centroid. In a stack, the centroid of a thick book's page block is nearer the board of the book above than its own. Parts are now matched on the mean distance of all their vertices.
  • Deep lean through the board. Measured against the cover solid, a head edge driven 4.5 mm into a 2.8 mm board came out in the hollow of the leaning book and read as no contact, so --deep-lean exited 0. The contact is now measured against the plane of the board's outer face.
  • Black gilt. Fully metallic bands facing the camera mirrored the dark stage and read black except at their edges. The gilt is half metallic.
+

Conventions walked

+

Every convention in showcase/README.md, and whether it applies here.

+
ConventionAppliesHow
Deterministic, budgets declared, assertions recomputeyesno RNG; every value above is read off the mesh
Falsifier fails the budget it targetsyestable below, proven on all three binaries
Hygiene incl. cross-shell coplanaryesexit 15; square, yaw cycle, front-plane step and stack seat chosen to keep it at 0
Named supportsyesthe two sides (--float-side); the plinth stops 4 mm off the floor
Joint-fit budgetsyesdado bite and far-face clearance per cross member (--short-shelves)
A member is tenoned into its seatyestop over sides and back boards, cornice into the top, back boards into the base
A platform bears on somethingyesevery shelf housed in both sides and biting the back boards
Carried parts bite their bearersyesbooks into shelves and into the book below (--float-books)
A joint bites; touching is not joiningyespage blocks into their boards (--loose-pages); the lean contact as a band
Bands on a curved host are built on the host's arcyesgilt bands on the spine's own chain (--float-bands)
A leaning prop rests on somethingyesthe lean contact, exit 22 (--air-lean, --deep-lean)
Scattered parts do not interpenetrateyesexit 23 (--crowd-books), designed contacts exempt and counted
Scatter varies in sizeyesthickness and height spread, exit 21 (--uniform-books)
The subject hangs where it can be seen / headroomyesevery book under the member above, exit 20 (--tall-book)
Edge treatment: no right anglesyesexit 24 (--sharp-shelf), wood only; covers chamfered 0.8 mm by construction
Aim an edge falsifier at one memberyesone shelf left square: 12 edges
Sort bmesh operator inputsyesbevel edges sorted by index, carcass and covers
A plank wall is boardsyesfive lapped back boards
Identical boards read as CGyesper-board PlankTone and GrainDir; per-book Tint
Variation goes into surface, never into functionyessizes, tints, gaps and yaw vary; shelf pitch and seats are budgets
Shading is part of the modelyesspines smooth (round); every edge over 35° hard, so boards and chamfers read crisp
One substance, one slotyeswood, cloth, leather, paper, gilt
Iron is not chromen/ano iron; gilt is half metallic, roughness 0.45
Bake texels per UV cellmeasured, not a budget1024 px over a 76-cell grid, about 13 px per cell
The bake cage is narrower than the nearest neighbouryesCAGE_EXTRUSION 0.01 m
Level on the stage; stage 60 myesturned about Z only; 60 m floor and wall
Keep a falsifier's envelope stillyesevery falsifier leaves the AABB unchanged
Mirror symmetry, plumb, rope, masonry, roofs, rings, terrain, vesselsnothe piece has none of these
+

Falsifiers

+

Each breaks one pipeline stage so a named budget fails. All fifteen were run on 4.5.11, 5.1.2 and 5.2.1 and exited the same declared code on all three.

+
FlagTarget budgetBreaksExit
--skip-decimateLOD1 ratiodrops the DECIMATE modifiers, LOD1 ratio goes to 1.00009
--stray-vertmesh hygieneadds one loose vertex inside the carcass15
--lift-zgrounded zminlifts the whole mesh 50 mm16
--float-sidenamed sideslifts the left side 5 mm; the right side still grounds the AABB16
--short-shelvesdado bitestops the two shelves 4 mm short of the sides; −4.0 mm17
--loose-pagespage-block bitebuilds every page block 0.9 mm clear of its boards; −0.9 mm17
--float-booksbook seatlifts every book 6 mm; −5.0 mm18
--float-bandsband seatbuilds every band 1.1 mm off its spine; −1.1 mm18
--tall-bookheadroomstretches one middle-shelf folio 1.20 into the shelf above; −3.9 mm20
--uniform-bookssize spreadone height and depth, thickness within ±1.5 %; 1.030 / 1.00021
--air-leanlean contactstops each leaning book 3 mm short of its neighbour; −3.0 mm22
--deep-leanlean contactdrives each leaning book 4.5 mm into its neighbour; 4.5 mm22
--crowd-booksbook overlapscloses the top shelf's gaps to −4.1 mm; 11 overlaps23
--sharp-shelfedge treatmentleaves the top shelf unchamfered; 12 right-angle edges24
+

Exit codes

+

File-local and sequential. 9 is a valid check code. 1 is the FATAL wrapper — a crash, never a named check. 19 (plumb and real-world size) is reserved across pieces and unused here.

+
CodeMeaning
0Success
1Uncaught exception (FATAL wrapper)
2argparse / usage
3Mesh did not build, or has no UV layer
4Base triangle count outside band
5Material slots, or a material's face floor
6UVs outside 0..1
7UV AABB overlap above tolerance
8Outer AABB off declared size
9LOD1 or LOD2 ratio outside band (--skip-decimate)
10Framing gate (examples/gallery_framing.py, render path only)
11Collider triangles above ceiling
12Normal bake failed or produced no image data
13glTF export missing or empty
14--output produced no file
15Mesh hygiene (--stray-vert)
16Grounded zmin, or a side floating (--lift-z, --float-side)
17Dado or page-block bite, or a book without one block and two bands (--short-shelves, --loose-pages)
18Book or band seat (--float-books, --float-bands)
20Headroom under the member above (--tall-book)
21Size spread below floor (--uniform-books)
22Lean contact, or leaning / lying count (--air-lean, --deep-lean)
23Books overlap each other or the carcass (--crowd-books)
24Right-angle wood edges (--sharp-shelf)
+

Run it

+
# Budget check, no render.
+blender --background --python bookshelf.py --
+
+# Falsifier: each leaning book stops short of its neighbour. Must exit 22.
+blender --background --python bookshelf.py -- --air-lean
+
+# Falsifier: each leaning book cuts into its neighbour. Must exit 22.
+blender --background --python bookshelf.py -- --deep-lean
+
+# Render the gallery still (EEVEE; --engine cycles on a GPU-less host).
+blender --background --python bookshelf.py -- --output bookshelf.webp
+

Smoke runs the check-only path. It does not pass --output or any falsifier.

+

Cross-version measurements

+
Value4.5.115.1.25.2.1
Base triangles109081090810908
LOD1 / LOD2 tris5454 / 23985454 / 23985454 / 2388
Face counts (wood / cloth / leather / paper / gilt)338 / 2050 / 1066 / 228 / 1976samesame
Outer AABB0.9720 × 0.3320 × 1.1760samesame
Collider tris686868
Headroom / spread / lean44.36 mm / 2.900, 1.645 / 0.80 mmsamesame
glTF bytes785836785836785828
+

LOD2 differs by ten triangles on 5.2 (DECIMATE COLLAPSE, the known divergence; the gate is a ratio band) and the glTF size by 8 bytes (exporter metadata, not a budget). Every other value is identical.

+
+
+

Source

+
+ showcase/bookshelf/bookshelf.py + View on GitHub → +
+ 
"""Game-ready bookshelf with leaning books — a showcase piece, not an example.
+
+Asserts budget conformance of a procedural bookcase: a stained carcass
+with two housed shelves, a base on a recessed plinth, lapped back boards
+and a stepped cornice, filled with thirty-eight hardback books. Most
+stand upright; seven lie in three stacks; two lean on a neighbour. Every
+book is a rounded-spine cover in cloth or leather, a page block glued
+into it, and two gilt bands tooled round the spine. Carried through UVs,
+five materials (wood, cloth, leather, paper, gilt), a high-to-low normal
+bake, an LOD chain, a convex collider, and a Unity glTF export.
+
+The budget that matters is the one a leaning book fails invisibly: it has
+to rest on its neighbour's head edge and on the shelf, not in either. Tip
+it a few degrees too far and its board cuts through the neighbour's
+corner; not far enough and it stands in the air against nothing. Every
+seat, the bounding box, the triangle count and the book-overlap budget
+(which must exempt the designed contact) still pass either way. The piece
+finds each leaning book and its neighbour on the finished mesh and asserts
+how deep the neighbour's head edge sits in the leaning board, as a band.
+
+Budgets are declared below and recomputed from the generated result.
+They are not API-contract witnesses. Each falsifier violates one named
+budget: ``--skip-decimate`` the LOD-ratio band, ``--stray-vert`` mesh
+hygiene, ``--lift-z`` grounded zmin, ``--float-side`` the named sides,
+``--short-shelves`` the dado bite, ``--loose-pages`` the page-block bite,
+``--float-books`` the book seat, ``--float-bands`` the band seat,
+``--tall-book`` the headroom, ``--uniform-books`` the size spread,
+``--air-lean`` and ``--deep-lean`` the lean contact, ``--crowd-books``
+book interpenetration, ``--sharp-shelf`` edge treatment.
+
+No randomness: every book's size, tint, gap, setback and seat is a table
+entry or a closed-form term of its index. DECIMATE COLLAPSE triangle
+counts are not byte-identical across Blender versions — the LOD gate is a
+ratio band.
+
+    blender --background --python bookshelf.py --
+    blender --background --python bookshelf.py -- --air-lean
+    blender --background --python bookshelf.py -- --output bookshelf.png
+"""
+import argparse
+import math
+import os
+import sys
+import tempfile
+import traceback
+
+import bmesh
+import bpy
+from mathutils import Matrix, Vector
+from mathutils.bvhtree import BVHTree
+from mathutils.kdtree import KDTree
+
+_REPO = os.path.abspath(
+    os.path.join(os.path.dirname(os.path.abspath(__file__)), os.pardir, os.pardir)
+)
+sys.path.insert(0, os.path.join(_REPO, "examples"))
+sys.dont_write_bytecode = True
+import gallery_framing  # noqa: E402
+
+# The carcass. X across, Y front (-) to back (+), Z up. Two full-height
+# sides carry everything; every cross member is housed into both of them.
+W_OUT = 0.920
+SIDE_T = 0.022
+DEPTH = 0.300
+SIDE_H = 1.140
+DADO = 0.008
+TOP_T = 0.026
+TOP_SEAT = 0.006
+TOP_OVER = 0.016
+TOP_BACK_OVER = 0.006
+CORN_T = 0.020
+CORN_OVER = 0.010
+CORN_BITE = 0.004
+CORN_BACK_IN = 0.004
+BACK_T = 0.012
+BACK_INSET = 0.010
+BACK_BITE = 0.005
+N_BACK = 5
+BACK_LAP = 0.002
+BACK_STEP = 0.0015
+SHELF_T = 0.022
+SHELF_SETBACK = 0.004
+SHELF_TOPS = (0.460, 0.800)
+BASE_Z = 0.070
+BASE_T = 0.020
+BASE_SETBACK = 0.004
+PLINTH_Z0 = 0.004
+PLINTH_SET = 0.018
+PLINTH_T = 0.018
+PLINTH_BITE = 0.004
+CHAMFER = 0.0025
+
+# Books. Local frame: X across the thickness, Y from the spine (-) to the
+# fore-edge (+), Z up the height, bottom of the cover at 0. The cover is
+# one shell: a U of board, rounded spine and board, extruded up the
+# height. The page block sits inside it, SQUARE short of the cover at the
+# head, tail and fore-edge, and bites PAGE_BITE into both boards.
+COVER_B = 0.0028
+SQUARE = 0.004
+PAGE_BACK = 0.0015
+PAGE_BITE = 0.0006
+LOOSE_PAGES = 0.0009
+SPINE_ARC = 6
+COVER_CHAMFER = 0.0008
+BAND_OFF = 0.018
+BAND_H = 0.006
+BAND_BITE = 0.0003
+BAND_PROUD = 0.0008
+FLOAT_BAND = 0.0011
+SEAT_BASE = 0.0010
+SEAT_STEP = 0.00018
+FLOAT_BOOKS = 0.006
+FLOAT_SIDE = 0.005
+START_GAP = 0.006
+GAP_BASE = 0.0025
+GAP_SPAN = 0.0020
+CROWD_GAP = -0.0041
+SET_BASE = 0.006
+SET_STEP = 0.0013
+SET_CLEAR = 0.0004
+SET_NUDGE = 0.0009
+STACK_YAW = math.radians(3.0)
+STACK_SHIFT = 0.006
+LEAN_BITE = 0.0008
+AIR_LEAN = -0.003
+DEEP_LEAN = 0.0045
+TALL_BOOK = 1.20
+UNIFORM_BOOK = (0.034, 0.230, 0.170)
+UNIFORM_JIT = 0.03
+UPRIGHT_YAW = (-2.4, -0.8, 0.8, 2.4)
+
+# Per shelf, left to right. ("up", T, H, D, kind), ("lean", T, H, D, kind,
+# direction, degrees), ("stack", [(T, H, D, kind), ...] bottom first),
+# ("gap", width). kind: "c" cloth, "l" leather. A leaning book leans onto
+# the upright beside it: -1 onto the book on its left, +1 onto the right.
+LAYOUT = (
+    (
+        ("stack", [(0.046, 0.300, 0.228, "l"), (0.036, 0.285, 0.214, "c")]),
+        ("gap", 0.014),
+        ("up", 0.052, 0.305, 0.226, "l"),
+        ("up", 0.034, 0.282, 0.205, "c"),
+        ("up", 0.041, 0.291, 0.214, "c"),
+        ("up", 0.058, 0.268, 0.198, "l"),
+        ("up", 0.030, 0.296, 0.221, "c"),
+        ("up", 0.044, 0.262, 0.192, "c"),
+        ("up", 0.037, 0.276, 0.207, "l"),
+        ("up", 0.049, 0.255, 0.188, "c"),
+        ("lean", 0.036, 0.300, 0.218, "c", -1, 18.0),
+    ),
+    (
+        ("lean", 0.032, 0.268, 0.196, "l", 1, 22.0),
+        ("up", 0.040, 0.228, 0.170, "c"),
+        ("up", 0.026, 0.251, 0.183, "c"),
+        ("up", 0.047, 0.262, 0.194, "l"),
+        ("up", 0.022, 0.214, 0.158, "c"),
+        ("up", 0.035, 0.240, 0.176, "c"),
+        ("up", 0.055, 0.270, 0.201, "l"),
+        ("up", 0.029, 0.233, 0.172, "c"),
+        ("up", 0.038, 0.246, 0.180, "c"),
+        ("up", 0.024, 0.221, 0.163, "l"),
+        ("gap", 0.050),
+        ("stack", [(0.034, 0.232, 0.170, "c"), (0.028, 0.214, 0.160, "l"),
+                   (0.022, 0.196, 0.148, "c")]),
+    ),
+    (
+        ("up", 0.031, 0.236, 0.172, "c"),
+        ("up", 0.024, 0.212, 0.156, "c"),
+        ("up", 0.043, 0.254, 0.187, "l"),
+        ("up", 0.020, 0.198, 0.146, "c"),
+        ("up", 0.036, 0.226, 0.166, "c"),
+        ("up", 0.028, 0.243, 0.178, "l"),
+        ("up", 0.045, 0.265, 0.195, "c"),
+        ("up", 0.022, 0.205, 0.151, "c"),
+        ("up", 0.033, 0.219, 0.161, "l"),
+        ("up", 0.039, 0.248, 0.182, "c"),
+        ("up", 0.026, 0.186, 0.140, "c"),
+        ("up", 0.030, 0.231, 0.170, "c"),
+        ("gap", 0.080),
+        ("stack", [(0.030, 0.226, 0.166, "l"), (0.024, 0.200, 0.150, "c")]),
+    ),
+)
+TALL_TARGET = (1, 6)  # the 0.270 m leather volume on the middle shelf
+CLOTH_TINTS = ((0.22, 0.035, 0.030), (0.045, 0.095, 0.055), (0.035, 0.050, 0.115),
+               (0.33, 0.21, 0.075), (0.10, 0.105, 0.11), (0.12, 0.045, 0.085),
+               (0.30, 0.21, 0.13), (0.045, 0.095, 0.095))
+LEATHER_TINTS = ((0.17, 0.070, 0.030), (0.26, 0.12, 0.050), (0.085, 0.040, 0.020),
+                 (0.21, 0.055, 0.030))
+
+BBOX_TOL = 0.020
+OUTER_SIZE = (0.972, 0.332, 1.176)
+
+BASE_TRIS_MIN = 10400
+BASE_TRIS_MAX = 11400
+LOD1_RATIO_MIN = 0.32
+LOD1_RATIO_MAX = 0.62
+LOD2_RATIO_MIN = 0.10
+LOD2_RATIO_MAX = 0.35
+LOD1_TARGET = 0.50
+LOD2_TARGET = 0.22
+MATERIAL_COUNT = 5
+FACE_FLOORS = {0: 300, 1: 1850, 2: 960, 3: 200, 4: 1780}
+UV_EPS = 1e-4
+UV_OVERLAP_MAX = 1e-5
+COLLIDER_TRIS_MAX = 200
+BAKE_RES = 1024
+CAGE_EXTRUSION = 0.01
+ZMIN_EPS = 1e-4
+DOUBLES_EPS = 1e-5
+AREA_EPS = 1e-10
+COPLANAR_NORMAL_EPS = 1e-4
+COPLANAR_PLANE_EPS = 1e-4
+COPLANAR_CENTRE_MAX = 0.05
+LIFT_Z = 0.05
+SIDE_Z_MAX = 1e-4
+DADO_MIN = 0.005
+DADO_FAR_MIN = 0.006
+PAGE_BITE_MIN = 0.0003
+PAGE_BITE_MAX = 0.0012
+SEAT_MIN = 0.0005
+SEAT_MAX = 0.0036
+BAND_BITE_MIN = 0.0001
+BAND_BITE_MAX = 0.0008
+BAND_PROUD_MIN = 0.0004
+HEADROOM_MIN = 0.020
+THICK_SPREAD_MIN = 2.5
+HEIGHT_SPREAD_MIN = 1.5
+UPRIGHT_TILT_MAX = math.radians(3.0)
+LYING_TILT_MIN = math.radians(80.0)
+LEAN_BITE_MIN = 0.0003
+LEAN_BITE_MAX = 0.0020
+LEAN_SEARCH = 0.03
+RIGHT_ANGLE_TOL = math.radians(5.0)
+
+WOOD_IDX = 0
+CLOTH_IDX = 1
+LEATHER_IDX = 2
+PAPER_IDX = 3
+GILT_IDX = 4
+N_CROSS = len(SHELF_TOPS) + 2
+N_BOOKS = sum(len(it[1]) if it[0] == "stack" else (0 if it[0] == "gap" else 1)
+              for row in LAYOUT for it in row)
+N_LEAN = sum(1 for row in LAYOUT for it in row if it[0] == "lean")
+N_LYING = sum(len(it[1]) for row in LAYOUT for it in row if it[0] == "stack")
+
+
+def eevee_engine_id():
+    """EEVEE id: 'BLENDER_EEVEE' on 5.0+, 'BLENDER_EEVEE_NEXT' on 4.2-4.5."""
+    return "BLENDER_EEVEE" if bpy.app.version >= (5, 0, 0) else "BLENDER_EEVEE_NEXT"
+
+
+def fail(msg, code):
+    print(f"FAIL[{code}]: {msg}", file=sys.stderr)
+    return code
+
+
+def triangle_count(mesh):
+    mesh.calc_loop_triangles()
+    return len(mesh.loop_triangles)
+
+
+def evaluated_triangle_count(obj):
+    deps = bpy.context.evaluated_depsgraph_get()
+    ev = obj.evaluated_get(deps)
+    mesh = ev.to_mesh()
+    try:
+        mesh.calc_loop_triangles()
+        return len(mesh.loop_triangles)
+    finally:
+        ev.to_mesh_clear()
+
+
+def frac(x):
+    return x - math.floor(x)
+
+
+# --- one book, in its own frame ---------------------------------------------
+
+
+def spine_chain(t, d):
+    """Centre line of the cover's U and its outward normal at each point.
+
+    Front board from the fore-edge to the spine, a half-round spine of
+    SPINE_ARC segments, back board to the fore-edge. The boards are tangent
+    to the spine, so the spine reads round and the boards flat.
+    """
+    rc = t / 2.0 - COVER_B / 2.0
+    yc = -d / 2.0 + t / 2.0
+    pts = [(Vector((-rc, d / 2.0)), Vector((-1.0, 0.0)))]
+    for k in range(SPINE_ARC + 1):
+        phi = math.pi + math.pi * k / SPINE_ARC
+        n = Vector((math.cos(phi), math.sin(phi)))
+        pts.append((Vector((0.0, yc)) + n * rc, n))
+    pts.append((Vector((rc, d / 2.0)), Vector((1.0, 0.0))))
+    return pts, yc
+
+
+def book_local(t, h, d, loose_pages=False, float_bands=False):
+    """A hardback in its own frame: cover, page block and two gilt bands.
+
+    Returns (verts, faces) with each face as (vertex indices, kind), kind
+    0 cover, 1 pages, 2 band. The cover is chamfered here, in its own
+    bmesh, so the placement code sees the finished corners it will rest on.
+    """
+    chain, yc = spine_chain(t, d)
+    bm = bmesh.new()
+    try:
+        kind = bm.faces.layers.int.new("kind")
+        outer = [p + n * (COVER_B / 2.0) for p, n in chain]
+        inner = [p - n * (COVER_B / 2.0) for p, n in chain]
+
+        def ring(pts2, z):
+            return [bm.verts.new((p.x, p.y, z)) for p in pts2]
+
+        ob, ot = ring(outer, 0.0), ring(outer, h)
+        ib, it = ring(inner, 0.0), ring(inner, h)
+        m = len(chain)
+        for i in range(m - 1):
+            j = i + 1
+            bm.faces.new((ob[i], ob[j], ot[j], ot[i]))
+            bm.faces.new((ib[j], ib[i], it[i], it[j]))
+            bm.faces.new((ot[i], ot[j], it[j], it[i]))
+            bm.faces.new((ob[j], ob[i], ib[i], ib[j]))
+        bm.faces.new((ob[0], ot[0], it[0], ib[0]))
+        e = m - 1
+        bm.faces.new((ib[e], it[e], ot[e], ob[e]))
+        # The bevel picks edges by face angle, which needs consistent normals.
+        bmesh.ops.recalc_face_normals(bm, faces=list(bm.faces))
+        bm.edges.index_update()
+        edges = sorted((ed for ed in bm.edges if ed.calc_face_angle(0.0) > math.radians(40.0)),
+                       key=lambda ed: ed.index)
+        bmesh.ops.bevel(bm, geom=edges, offset=COVER_CHAMFER, segments=1, profile=0.5,
+                        affect="EDGES", clamp_overlap=True)
+        bmesh.ops.triangulate(bm, faces=[f for f in bm.faces if len(f.verts) > 4])
+
+        # Page block: inside the U, biting both boards, square short of the
+        # cover at head, tail and fore-edge. Its back stops PAGE_BACK short of
+        # the line where the boards meet the spine, where the band ends lie.
+        px = t / 2.0 - COVER_B + (-LOOSE_PAGES if loose_pages else PAGE_BITE)
+        lo = Vector((-px, yc + PAGE_BACK, SQUARE))
+        hi = Vector((px, d / 2.0 - SQUARE, h - SQUARE))
+        corner = {}
+        for a in (0, 1):
+            for b in (0, 1):
+                for c in (0, 1):
+                    corner[(a, b, c)] = bm.verts.new((hi.x if a else lo.x, hi.y if b else lo.y,
+                                                      hi.z if c else lo.z))
+        box = (((0, 0, 0), (0, 1, 0), (1, 1, 0), (1, 0, 0)),
+               ((0, 0, 1), (1, 0, 1), (1, 1, 1), (0, 1, 1)),
+               ((0, 0, 0), (1, 0, 0), (1, 0, 1), (0, 0, 1)),
+               ((0, 1, 0), (0, 1, 1), (1, 1, 1), (1, 1, 0)),
+               ((0, 0, 0), (0, 0, 1), (0, 1, 1), (0, 1, 0)),
+               ((1, 0, 0), (1, 1, 0), (1, 1, 1), (1, 0, 1)))
+        for quad in box:
+            f = bm.faces.new([corner[q] for q in quad])
+            f[kind] = 1
+
+        # Gilt bands round the spine, built on the cover's own outer chain:
+        # every band vertex sits on a cover vertex's normal, so the band
+        # follows the round of the spine exactly.
+        span = range(1, SPINE_ARC + 2)
+        inner_off = FLOAT_BAND if float_bands else -BAND_BITE
+        outer_off = inner_off + BAND_BITE + BAND_PROUD
+        for z0 in (BAND_OFF, h - BAND_OFF - BAND_H):
+            g = {}
+            for j in span:
+                p, n = chain[j]
+                for side, off in (("in", inner_off), ("out", outer_off)):
+                    q = p + n * (COVER_B / 2.0 + off)
+                    for zz, z in (("b", z0), ("t", z0 + BAND_H)):
+                        g[(j, side, zz)] = bm.verts.new((q.x, q.y, z))
+            quads = []
+            for j in list(span)[:-1]:
+                k = j + 1
+                quads.append((g[(j, "out", "b")], g[(k, "out", "b")], g[(k, "out", "t")],
+                              g[(j, "out", "t")]))
+                quads.append((g[(k, "in", "b")], g[(j, "in", "b")], g[(j, "in", "t")],
+                              g[(k, "in", "t")]))
+                quads.append((g[(j, "out", "t")], g[(k, "out", "t")], g[(k, "in", "t")],
+                              g[(j, "in", "t")]))
+                quads.append((g[(k, "out", "b")], g[(j, "out", "b")], g[(j, "in", "b")],
+                              g[(k, "in", "b")]))
+            a, z = span[0], span[-1]
+            quads.append((g[(a, "in", "b")], g[(a, "out", "b")], g[(a, "out", "t")],
+                          g[(a, "in", "t")]))
+            quads.append((g[(z, "out", "b")], g[(z, "in", "b")], g[(z, "in", "t")],
+                          g[(z, "out", "t")]))
+            for vs in quads:
+                f = bm.faces.new(vs)
+                f[kind] = 2
+        bm.verts.index_update()
+        verts = [v.co.copy() for v in bm.verts]
+        faces = [(tuple(v.index for v in f.verts), f[kind]) for f in bm.faces]
+    finally:
+        bm.free()
+    return verts, faces
+
+
+# --- the layout -------------------------------------------------------------
+
+
+def cover_points(book):
+    return [book["world"][i] for i in book["cover_ix"]]
+
+
+def bounds(pts):
+    return (Vector((min(p.x for p in pts), min(p.y for p in pts), min(p.z for p in pts))),
+            Vector((max(p.x for p in pts), max(p.y for p in pts), max(p.z for p in pts))))
+
+
+def move(book, delta):
+    book["M"] = Matrix.Translation(delta) @ book["M"]
+    book["world"] = [p + delta for p in book["world"]]
+
+
+def make_book(dims, rot, loose_pages, float_bands):
+    t, h, d, kind = dims
+    verts, faces = book_local(t, h, d, loose_pages=loose_pages, float_bands=float_bands)
+    cover_ix = sorted({i for vs, k in faces if k == 0 for i in vs})
+    return {"t": t, "h": h, "d": d, "kind": kind, "verts": verts, "faces": faces,
+            "cover_ix": cover_ix, "M": rot.copy(), "world": [rot @ v for v in verts]}
+
+
+def lean_face(book, side):
+    """Point and outward normal of a leaning book's board face on ``side``."""
+    rot = book["M"].to_3x3()
+    n = (rot @ Vector((float(side), 0.0, 0.0))).normalized()
+    return book["M"] @ Vector((side * book["t"] / 2.0, 0.0, 0.0)), n
+
+
+def penetration(pts, p0, n):
+    """How far the deepest of ``pts`` sits behind the plane (p0, n)."""
+    return max(-(p - p0).dot(n) for p in pts)
+
+
+def plan_books(loose_pages=False, float_books=False, float_bands=False, tall_book=False,
+               uniform_books=False, crowd_books=False, air_lean=False, deep_lean=False):
+    """Place every book. Closed-form: sizes from LAYOUT, the rest from the index.
+
+    Each book is built, turned, then set down: its lowest cover vertex a
+    stepped seat into whatever it stands on, its spine a stepped setback
+    from the shelf front, and along the shelf at the running cursor. A
+    leaning book is then slid (or its neighbour is) until the neighbour's
+    head edge sits the lean bite into the leaning board.
+    """
+    x_in = W_OUT / 2.0 - SIDE_T
+    y_front = -DEPTH / 2.0 + SHELF_SETBACK
+    tops = (BASE_Z + BASE_T,) + SHELF_TOPS
+    bite = LEAN_BITE + (AIR_LEAN - LEAN_BITE if air_lean else 0.0) + (
+        DEEP_LEAN - LEAN_BITE if deep_lean else 0.0)
+    lift = FLOAT_BOOKS if float_books else 0.0
+    books = []
+    for s, row in enumerate(LAYOUT):
+        cursor = -x_in + START_GAP
+        k = 0
+        placed = []
+        pending = None
+
+        def sized(dims, s=s, ii=None, j=0):
+            t, h, d, kind = dims
+            if uniform_books:
+                # One height and depth; thickness within +-1.5 %, so no two
+                # spines are the same solid set a hair apart.
+                n = s * 100 + (ii or 0) * 5 + j
+                ft = 1.0 + UNIFORM_JIT * (frac(n * 0.6180339887 + 0.1) - 0.5)
+                t, h, d = UNIFORM_BOOK[0] * ft, UNIFORM_BOOK[1], UNIFORM_BOOK[2]
+            if tall_book and (s, ii) == TALL_TARGET:
+                h *= TALL_BOOK
+            return (t, h, d, kind)
+
+        def gap_of(k, s=s):
+            if crowd_books and s == 2:
+                return CROWD_GAP
+            return GAP_BASE + GAP_SPAN * frac(k * 0.6180339887 + 0.3 + s * 0.17)
+
+        def y_keys(book):
+            lo, hi = bounds(cover_points(book))
+            yc = lo.y + book["t"] / 2.0
+            return (lo.x + hi.x) / 2.0, (lo.y, yc, yc + PAGE_BACK, hi.y - SQUARE, hi.y)
+
+        def set_down(book, k, x_left, support_top, seat_k=None):
+            lo, hi = bounds(cover_points(book))
+            seat = SEAT_BASE + SEAT_STEP * (k if seat_k is None else seat_k)
+            move(book, Vector((x_left - lo.x,
+                               y_front + SET_BASE + SET_STEP * (k % 7) - lo.y,
+                               support_top - seat - lo.z)))
+            # Spine fronts, spine lines and fore-edges are planes facing Y.
+            # Two neighbours landing one on the same plane z-fight, so step
+            # this book back until none of its planes meets a neighbour's.
+            for _ in range(8):
+                cx, keys = y_keys(book)
+                near = [y_keys(o)[1] for o in placed if abs(y_keys(o)[0] - cx) < 0.12]
+                if not any(abs(a - b) < SET_CLEAR for ks in near for a in keys for b in ks):
+                    break
+                move(book, Vector((0.0, SET_NUDGE, 0.0)))
+
+        for ii, item in enumerate(row):
+            tag = item[0]
+            if tag == "gap":
+                cursor += item[1]
+                continue
+            if tag == "up":
+                # Upright books stand a degree or so off square, in a
+                # four-step cycle. Every spine has the same facet angles, so
+                # square neighbours share planes by accident whenever their
+                # offsets line up; a degree apart, no two faces are parallel.
+                yaw = math.radians(UPRIGHT_YAW[k % len(UPRIGHT_YAW)])
+                b = make_book(sized(item[1:5], ii=ii), Matrix.Rotation(yaw, 4, "Z"),
+                              loose_pages, float_bands)
+                set_down(b, k, cursor + gap_of(k), tops[s] + lift)
+                if pending is not None:
+                    p0, n = lean_face(pending, 1)
+                    pen = penetration(cover_points(b), p0, n)
+                    move(b, Vector(((pen - bite) / n.x, 0.0, 0.0)))
+                    b["lean_on"] = pending
+                    pending = None
+            elif tag == "lean":
+                side, deg = item[5], item[6]
+                rot = Matrix.Rotation(side * math.radians(deg), 4, "Y")
+                b = make_book(sized(item[1:5], ii=ii), rot, loose_pages, float_bands)
+                set_down(b, k, cursor + gap_of(k), tops[s] + lift)
+                if side < 0:
+                    nb = placed[-1]
+                    p0, n = lean_face(b, -1)
+                    pen = penetration(cover_points(nb), p0, n)
+                    move(b, Vector(((bite - pen) / n.x, 0.0, 0.0)))
+                    b["lean_on"] = nb
+                else:
+                    pending = b
+            else:
+                stack_top = tops[s] + lift
+                centre = None
+                stack = []
+                for j, dims in enumerate(item[1]):
+                    yaw = STACK_YAW * (1.0 if j % 2 else -1.0)
+                    rot = Matrix.Rotation(yaw, 4, "Z") @ Matrix.Rotation(-math.pi / 2.0, 4, "Y")
+                    b = make_book(sized(dims, ii=ii, j=j), rot, loose_pages, float_bands)
+                    lo, hi = bounds(cover_points(b))
+                    if centre is None:
+                        centre = cursor + gap_of(k) + (hi.x - lo.x) / 2.0
+                    shift = STACK_SHIFT * (0.5 - frac(j * 0.7548776662 + 0.2)) * 2.0
+                    # A book stacked on a book takes a small seat of its own
+                    # (1.0-1.4 mm), so its underside never lands on the plane
+                    # of the page block 2.2 mm inside the board below it.
+                    set_down(b, k, centre + shift - (hi.x - lo.x) / 2.0, stack_top,
+                             seat_k=(j if j else None))
+                    stack_top = bounds(cover_points(b))[1].z
+                    b.update({"shelf": s, "i": len(books)})
+                    books.append(b)
+                    stack.append(b)
+                    placed.append(b)
+                    k += 1
+                cursor = max(bounds(cover_points(x))[1].x for x in stack)
+                continue
+            b.update({"shelf": s, "i": len(books)})
+            books.append(b)
+            placed.append(b)
+            cursor = bounds(cover_points(b))[1].x
+            k += 1
+    return books
+
+
+# --- construction -----------------------------------------------------------
+
+
+def add_board(bm, lo, hi, boards, sharp=False):
+    """Axis-aligned board from corner ``lo`` to ``hi``; its verts go in ``boards``."""
+    geo = bmesh.ops.create_cube(bm, size=1.0)
+    c = [(lo[k] + hi[k]) * 0.5 for k in range(3)]
+    s = [hi[k] - lo[k] for k in range(3)]
+    for v in geo["verts"]:
+        v.co = Vector((c[0] + v.co.x * s[0], c[1] + v.co.y * s[1], c[2] + v.co.z * s[2]))
+    for f in {f for v in geo["verts"] for f in v.link_faces}:
+        f.material_index = WOOD_IDX
+    if not sharp:
+        boards.extend(geo["verts"])
+    return geo["verts"]
+
+
+def build_bookshelf_mesh(
+    name,
+    stray_vert=False,
+    float_side=False,
+    short_shelves=False,
+    sharp_shelf=False,
+    **book_flags,
+):
+    x_out = W_OUT / 2.0
+    x_in = x_out - SIDE_T
+    y0, y1 = -DEPTH / 2.0, DEPTH / 2.0
+    top_z0 = SIDE_H - TOP_SEAT
+    top_z1 = top_z0 + TOP_T
+    back_y1 = y1 - BACK_INSET
+    back_y0 = back_y1 - BACK_T
+    bm = bmesh.new()
+    try:
+        uv = bm.loops.layers.uv.new("UVMap")
+        piece = bm.faces.layers.int.new("Piece")
+        boards = []
+        # Sides: the two named supports.
+        for sx in (-1.0, 1.0):
+            lift = FLOAT_SIDE if (float_side and sx < 0) else 0.0
+            add_board(bm, (min(sx * x_out, sx * x_in), y0, lift),
+                      (max(sx * x_out, sx * x_in), y1, SIDE_H + lift), boards)
+        add_board(bm, (-x_out - TOP_OVER, y0 - TOP_OVER, top_z0),
+                  (x_out + TOP_OVER, y1 + TOP_BACK_OVER, top_z1), boards)
+        # Cornice: a wider board seated on the top, stepping out past it.
+        # Its back stops short of the top's back, or the two share a plane.
+        add_board(bm, (-x_out - TOP_OVER - CORN_OVER, y0 - TOP_OVER - CORN_OVER,
+                       top_z1 - CORN_BITE),
+                  (x_out + TOP_OVER + CORN_OVER, y1 + TOP_BACK_OVER - CORN_BACK_IN,
+                   top_z1 - CORN_BITE + CORN_T), boards)
+        # Back boards, housed into the sides and the top, standing in the
+        # base; lapped, every other one stepped forward so no lap is a plane.
+        span0, span1 = -x_in - BACK_BITE, x_in + BACK_BITE
+        bw = (span1 - span0 + BACK_LAP * (N_BACK - 1)) / N_BACK
+        for k in range(N_BACK):
+            bx = span0 + k * (bw - BACK_LAP)
+            step = BACK_STEP if k % 2 else 0.0
+            add_board(bm, (bx, back_y0 - step, BASE_Z + BASE_T - BACK_BITE),
+                      (bx + bw, back_y1 - step, top_z0 + BACK_BITE), boards)
+        # Cross members: plinth, base and shelves, each in a dado in both sides.
+        add_board(bm, (-(x_in + DADO), y0 + PLINTH_SET, PLINTH_Z0),
+                  (x_in + DADO, y0 + PLINTH_SET + PLINTH_T, BASE_Z + PLINTH_BITE), boards)
+        add_board(bm, (-(x_in + DADO), y0 + BASE_SETBACK, BASE_Z),
+                  (x_in + DADO, back_y0 + BACK_BITE, BASE_Z + BASE_T), boards)
+        reach = x_in - 0.004 if short_shelves else x_in + DADO
+        for s, zt in enumerate(SHELF_TOPS):
+            add_board(bm, (-reach, y0 + SHELF_SETBACK, zt - SHELF_T),
+                      (reach, back_y0 + BACK_BITE, zt), boards,
+                      sharp=(sharp_shelf and s == len(SHELF_TOPS) - 1))
+        # A set of BMEdges iterates in address order: sort by index so the
+        # bevel emits its faces in the same order on every run.
+        bm.edges.index_update()
+        edges = sorted({e for v in boards for e in v.link_edges
+                        if e.calc_face_angle(0.0) > math.radians(20.0)}, key=lambda e: e.index)
+        bmesh.ops.bevel(bm, geom=edges, offset=CHAMFER, segments=1, profile=0.5,
+                        affect="EDGES", clamp_overlap=True, material=WOOD_IDX)
+        bmesh.ops.triangulate(bm, faces=[f for f in bm.faces if len(f.verts) > 4])
+
+        books = plan_books(**book_flags)
+        for b in books:
+            vs = [bm.verts.new(p) for p in b["world"]]
+            cover = LEATHER_IDX if b["kind"] == "l" else CLOTH_IDX
+            for idx, kind in b["faces"]:
+                f = bm.faces.new([vs[i] for i in idx])
+                f.material_index = (cover, PAPER_IDX, GILT_IDX)[kind]
+                f[piece] = b["i"] + 1
+        if stray_vert:
+            bm.verts.new((0.0, 0.0, 0.62))
+        bmesh.ops.recalc_face_normals(bm, faces=list(bm.faces))
+        for f in bm.faces:
+            f.smooth = True
+        for e in bm.edges:
+            if len(e.link_faces) == 2 and e.calc_face_angle(0.0) > math.radians(35.0):
+                e.smooth = False
+        pack_uvs(bm, uv)
+        me = bpy.data.meshes.new(name)
+        bm.to_mesh(me)
+        me.update()
+    finally:
+        bm.free()
+    paint_pieces(me, books)
+    obj = bpy.data.objects.new(name, me)
+    bpy.context.collection.objects.link(obj)
+    return obj
+
+
+def pack_uvs(bm, uv, margin=0.06):
+    """One grid cell per face, projected on its dominant axis."""
+    faces = list(bm.faces)
+    cols = max(1, math.ceil(math.sqrt(len(faces))))
+    rows = max(1, math.ceil(len(faces) / cols))
+    cw, ch = 1.0 / cols, 1.0 / rows
+    pu, pv = margin * cw * 0.5, margin * ch * 0.5
+    for idx, face in enumerate(faces):
+        nrm = face.normal
+        ax, ay, az = abs(nrm.x), abs(nrm.y), abs(nrm.z)
+        pts = []
+        for loop in face.loops:
+            co = loop.vert.co
+            if az >= ax and az >= ay:
+                pts.append((co.x, co.y))
+            elif ax >= ay:
+                pts.append((co.y, co.z))
+            else:
+                pts.append((co.x, co.z))
+        minx, maxx = min(c[0] for c in pts), max(c[0] for c in pts)
+        miny, maxy = min(c[1] for c in pts), max(c[1] for c in pts)
+        dx, dy = max(maxx - minx, 1e-8), max(maxy - miny, 1e-8)
+        ou, ov = (idx % cols) * cw + pu, (idx // cols) * ch + pv
+        for loop, (x, y) in zip(face.loops, pts):
+            loop[uv].uv = (ou + (x - minx) / dx * (cw - 2 * pu),
+                           ov + (y - miny) / dy * (ch - 2 * pv))
+
+
+def paint_pieces(me, books):
+    """Face attributes the shaders read: per-board tone and grain, per-book tint.
+
+    Every carcass board gets a closed-form tone and its long axis as grain.
+    Every book gets a cloth or leather tint from its index, and its page
+    block the book's own thickness axis, so the page lines run parallel to
+    the boards however the book is turned. The ``Piece`` tag is then dropped.
+    """
+    npoly = len(me.polygons)
+    piece = [0] * npoly
+    me.attributes["Piece"].data.foreach_get("value", piece)
+    mats = [0] * npoly
+    me.polygons.foreach_get("material_index", mats)
+    tone = [0.5] * npoly
+    grain = [(1.0, 0.0, 0.0)] * npoly
+    tint = [(0.5, 0.5, 0.5, 1.0)] * npoly
+    vf = [[] for _ in range(len(me.vertices))]
+    for p in me.polygons:
+        for i in p.vertices:
+            vf[i].append(p.index)
+    for k, g in enumerate(shells(me)):
+        faces = {fi for i in g for fi in vf[i]}
+        if not faces or mats[next(iter(faces))] != WOOD_IDX:
+            continue
+        pts = [me.vertices[i].co for i in g]
+        ext = [max(p[a] for p in pts) - min(p[a] for p in pts) for a in range(3)]
+        axis = ext.index(max(ext))
+        d = tuple(1.0 if a == axis else 0.0 for a in range(3))
+        t = 0.5 + 0.30 * (frac(k * 0.6180339887 + 0.3) - 0.5)
+        for fi in faces:
+            tone[fi] = t
+            grain[fi] = d
+    for fi in range(npoly):
+        v = piece[fi] - 1
+        if v < 0:
+            continue
+        b = books[v]
+        if mats[fi] == LEATHER_IDX:
+            c = LEATHER_TINTS[int(frac(v * 0.6180339887 + 0.1) * len(LEATHER_TINTS))]
+        else:
+            c = CLOTH_TINTS[int(frac(v * 0.6180339887 + 0.4) * len(CLOTH_TINTS))]
+        tint[fi] = (c[0], c[1], c[2], 1.0)
+        tone[fi] = 0.5 + 0.3 * (frac(v * 0.4142135624) - 0.5)
+        ax = b["M"].to_3x3() @ Vector((1.0, 0.0, 0.0))
+        grain[fi] = tuple(ax.normalized())
+    me.attributes.remove(me.attributes["Piece"])
+    a = me.attributes.new("PlankTone", "FLOAT", "FACE")
+    a.data.foreach_set("value", tone)
+    b = me.attributes.new("GrainDir", "FLOAT_VECTOR", "FACE")
+    b.data.foreach_set("vector", [c for v in grain for c in v])
+    c = me.attributes.new("Tint", "FLOAT_COLOR", "FACE")
+    c.data.foreach_set("color", [x for v in tint for x in v])
+
+
+# --- surface ----------------------------------------------------------------
+
+
+def _sock(sockets, identifier):
+    return next(sk for sk in sockets if sk.identifier == identifier)
+
+
+def wood_material(name):
+    """Stained timber: grain along each board, tone per board (copied from crate-stack)."""
+    mat = bpy.data.materials.new(name)
+    mat.use_nodes = True
+    nt = mat.node_tree
+    bsdf = nt.nodes["Principled BSDF"]
+    coord = nt.nodes.new("ShaderNodeTexCoord")
+    gdir = nt.nodes.new("ShaderNodeAttribute")
+    gdir.attribute_name = "GrainDir"
+    tone = nt.nodes.new("ShaderNodeAttribute")
+    tone.attribute_name = "PlankTone"
+    dot = nt.nodes.new("ShaderNodeVectorMath")
+    dot.operation = "DOT_PRODUCT"
+    nt.links.new(coord.outputs["Object"], dot.inputs[0])
+    nt.links.new(gdir.outputs["Vector"], dot.inputs[1])
+    squash = nt.nodes.new("ShaderNodeMath")
+    squash.operation = "MULTIPLY"
+    squash.inputs[1].default_value = 0.94
+    nt.links.new(dot.outputs["Value"], squash.inputs[0])
+    along = nt.nodes.new("ShaderNodeVectorMath")
+    along.operation = "SCALE"
+    nt.links.new(gdir.outputs["Vector"], along.inputs[0])
+    nt.links.new(squash.outputs["Value"], along.inputs["Scale"])
+    grain_co = nt.nodes.new("ShaderNodeVectorMath")
+    grain_co.operation = "SUBTRACT"
+    nt.links.new(coord.outputs["Object"], grain_co.inputs[0])
+    nt.links.new(along.outputs["Vector"], grain_co.inputs[1])
+    shift = nt.nodes.new("ShaderNodeVectorMath")
+    shift.operation = "ADD"
+    nt.links.new(grain_co.outputs["Vector"], shift.inputs[0])
+    nt.links.new(tone.outputs["Fac"], shift.inputs[1])
+    noise = nt.nodes.new("ShaderNodeTexNoise")
+    noise.inputs["Scale"].default_value = 34.0
+    noise.inputs["Detail"].default_value = 6.0
+    noise.inputs["Roughness"].default_value = 0.62
+    nt.links.new(shift.outputs["Vector"], noise.inputs["Vector"])
+    ramp = nt.nodes.new("ShaderNodeValToRGB")
+    ramp.color_ramp.elements[0].position = 0.30
+    ramp.color_ramp.elements[0].color = (0.070, 0.031, 0.013, 1.0)
+    ramp.color_ramp.elements[1].position = 0.72
+    ramp.color_ramp.elements[1].color = (0.21, 0.10, 0.042, 1.0)
+    nt.links.new(noise.outputs["Fac"], ramp.inputs["Fac"])
+    gain = nt.nodes.new("ShaderNodeMath")
+    gain.operation = "MULTIPLY_ADD"
+    gain.inputs[1].default_value = 1.2
+    gain.inputs[2].default_value = 0.40
+    nt.links.new(tone.outputs["Fac"], gain.inputs[0])
+    mix = nt.nodes.new("ShaderNodeMix")
+    mix.data_type = "RGBA"
+    mix.blend_type = "MULTIPLY"
+    _sock(mix.inputs, "Factor_Float").default_value = 1.0
+    nt.links.new(ramp.outputs["Color"], _sock(mix.inputs, "A_Color"))
+    nt.links.new(gain.outputs["Value"], _sock(mix.inputs, "B_Color"))
+    nt.links.new(_sock(mix.outputs, "Result_Color"), bsdf.inputs["Base Color"])
+    rough = nt.nodes.new("ShaderNodeMapRange")
+    rough.inputs["To Min"].default_value = 0.66
+    rough.inputs["To Max"].default_value = 0.48
+    nt.links.new(noise.outputs["Fac"], rough.inputs["Value"])
+    nt.links.new(rough.outputs["Result"], bsdf.inputs["Roughness"])
+    return mat
+
+
+def cover_material(name, scale, low, roughness):
+    """A book cover: the per-book ``Tint``, broken up by a fine noise."""
+    mat = bpy.data.materials.new(name)
+    mat.use_nodes = True
+    nt = mat.node_tree
+    bsdf = nt.nodes["Principled BSDF"]
+    attr = nt.nodes.new("ShaderNodeAttribute")
+    attr.attribute_name = "Tint"
+    tc = nt.nodes.new("ShaderNodeTexCoord")
+    noise = nt.nodes.new("ShaderNodeTexNoise")
+    noise.inputs["Scale"].default_value = scale
+    noise.inputs["Detail"].default_value = 8.0
+    nt.links.new(tc.outputs["Object"], noise.inputs["Vector"])
+    shade = nt.nodes.new("ShaderNodeMapRange")
+    shade.inputs["To Min"].default_value = low
+    shade.inputs["To Max"].default_value = 1.1
+    nt.links.new(noise.outputs["Fac"], shade.inputs["Value"])
+    mul = nt.nodes.new("ShaderNodeVectorMath")
+    mul.operation = "SCALE"
+    nt.links.new(attr.outputs["Color"], mul.inputs[0])
+    nt.links.new(shade.outputs["Result"], mul.inputs["Scale"])
+    nt.links.new(mul.outputs["Vector"], bsdf.inputs["Base Color"])
+    rough = nt.nodes.new("ShaderNodeMapRange")
+    rough.inputs["To Min"].default_value = roughness + 0.08
+    rough.inputs["To Max"].default_value = roughness - 0.08
+    nt.links.new(noise.outputs["Fac"], rough.inputs["Value"])
+    nt.links.new(rough.outputs["Result"], bsdf.inputs["Roughness"])
+    return mat
+
+
+def paper_material(name):
+    """Page edges: warm off-white with fine lines parallel to the boards."""
+    mat = bpy.data.materials.new(name)
+    mat.use_nodes = True
+    nt = mat.node_tree
+    bsdf = nt.nodes["Principled BSDF"]
+    tc = nt.nodes.new("ShaderNodeTexCoord")
+    gdir = nt.nodes.new("ShaderNodeAttribute")
+    gdir.attribute_name = "GrainDir"
+    dot = nt.nodes.new("ShaderNodeVectorMath")
+    dot.operation = "DOT_PRODUCT"
+    nt.links.new(tc.outputs["Object"], dot.inputs[0])
+    nt.links.new(gdir.outputs["Vector"], dot.inputs[1])
+    across = nt.nodes.new("ShaderNodeCombineXYZ")
+    nt.links.new(dot.outputs["Value"], across.inputs["X"])
+    lines = nt.nodes.new("ShaderNodeTexNoise")
+    lines.inputs["Scale"].default_value = 900.0
+    lines.inputs["Detail"].default_value = 2.0
+    nt.links.new(across.outputs["Vector"], lines.inputs["Vector"])
+    ramp = nt.nodes.new("ShaderNodeValToRGB")
+    ramp.color_ramp.elements[0].position = 0.30
+    ramp.color_ramp.elements[0].color = (0.40, 0.34, 0.24, 1.0)
+    ramp.color_ramp.elements[1].position = 0.70
+    ramp.color_ramp.elements[1].color = (0.68, 0.61, 0.47, 1.0)
+    nt.links.new(lines.outputs["Fac"], ramp.inputs["Fac"])
+    nt.links.new(ramp.outputs["Color"], bsdf.inputs["Base Color"])
+    bsdf.inputs["Roughness"].default_value = 0.88
+    return mat
+
+
+def gilt_material(name):
+    """Gold leaf tooling: warm, metallic, a little worn by the noise."""
+    mat = bpy.data.materials.new(name)
+    mat.use_nodes = True
+    nt = mat.node_tree
+    bsdf = nt.nodes["Principled BSDF"]
+    tc = nt.nodes.new("ShaderNodeTexCoord")
+    noise = nt.nodes.new("ShaderNodeTexNoise")
+    noise.inputs["Scale"].default_value = 300.0
+    noise.inputs["Detail"].default_value = 4.0
+    nt.links.new(tc.outputs["Object"], noise.inputs["Vector"])
+    ramp = nt.nodes.new("ShaderNodeValToRGB")
+    ramp.color_ramp.elements[0].position = 0.35
+    ramp.color_ramp.elements[0].color = (0.36, 0.23, 0.07, 1.0)
+    ramp.color_ramp.elements[1].position = 0.65
+    ramp.color_ramp.elements[1].color = (0.80, 0.56, 0.20, 1.0)
+    nt.links.new(noise.outputs["Fac"], ramp.inputs["Fac"])
+    nt.links.new(ramp.outputs["Color"], bsdf.inputs["Base Color"])
+    # Half metallic and fairly rough: a fully metallic band on a spine facing
+    # the camera mirrors the dark stage and reads black.
+    bsdf.inputs["Metallic"].default_value = 0.55
+    bsdf.inputs["Roughness"].default_value = 0.45
+    return mat
+
+
+def bookshelf_materials():
+    return (
+        wood_material("BookshelfWood"),
+        cover_material("BookCloth", 420.0, 0.78, 0.86),
+        cover_material("BookLeather", 70.0, 0.62, 0.48),
+        paper_material("BookPages"),
+        gilt_material("BookGilt"),
+    )
+
+
+def assign_slots(obj, mats):
+    slots = obj.data.materials
+    for i, mat in enumerate(mats):
+        if i < len(slots):
+            slots[i] = mat
+        else:
+            slots.append(mat)
+
+
+# --- measurement ------------------------------------------------------------
+
+
+def world_bbox(obj):
+    corners = [obj.matrix_world @ Vector(c) for c in obj.bound_box]
+    xs, ys, zs = [c.x for c in corners], [c.y for c in corners], [c.z for c in corners]
+    return (min(xs), min(ys), min(zs), max(xs), max(ys), max(zs))
+
+
+def uv_stats(mesh):
+    uv = mesh.uv_layers.active
+    if uv is None:
+        return 0.0, 0.0, 1.0, 1.0, 0.0, 0
+    data = uv.data
+    us = [loop.uv[0] for loop in data]
+    vs = [loop.uv[1] for loop in data]
+    aabbs = []
+    for poly in mesh.polygons:
+        pu = [data[i].uv[0] for i in poly.loop_indices]
+        pv = [data[i].uv[1] for i in poly.loop_indices]
+        aabbs.append((min(pu), min(pv), max(pu), max(pv)))
+    span = max(1e-6, max(a[2] - a[0] for a in aabbs), max(a[3] - a[1] for a in aabbs))
+    buckets = {}
+    for i, a in enumerate(aabbs):
+        for c in range(int(a[0] // span), int(a[2] // span) + 1):
+            for r in range(int(a[1] // span), int(a[3] // span) + 1):
+                buckets.setdefault((c, r), []).append(i)
+    overlap = 0.0
+    seen = set()
+    for members in buckets.values():
+        for ii in range(len(members)):
+            for jj in range(ii + 1, len(members)):
+                i, j = members[ii], members[jj]
+                key = (i, j) if i < j else (j, i)
+                if key in seen:
+                    continue
+                seen.add(key)
+                a, b = aabbs[i], aabbs[j]
+                overlap += max(0.0, min(a[2], b[2]) - max(a[0], b[0])) * max(
+                    0.0, min(a[3], b[3]) - max(a[1], b[1]))
+    return min(us), min(vs), max(us), max(vs), overlap, len(aabbs)
+
+
+def face_area(me, poly):
+    idxs = poly.vertices
+    v0 = me.vertices[idxs[0]].co
+    area = 0.0
+    for i in range(1, len(idxs) - 1):
+        area += (me.vertices[idxs[i]].co - v0).cross(me.vertices[idxs[i + 1]].co - v0).length * 0.5
+    return area
+
+
+def hygiene_audit(me):
+    ngons = sum(1 for p in me.polygons if len(p.vertices) > 4)
+    zero_area = sum(1 for p in me.polygons if face_area(me, p) <= AREA_EPS)
+    bm = bmesh.new()
+    try:
+        bm.from_mesh(me)
+        loose_v = sum(1 for v in bm.verts if len(v.link_edges) == 0)
+        loose_e = sum(1 for e in bm.edges if len(e.link_faces) == 0)
+        nonman = sum(1 for e in bm.edges if not e.is_manifold)
+        ret = bmesh.ops.find_doubles(bm, verts=list(bm.verts), dist=DOUBLES_EPS)
+        doubles = len(ret.get("targetmap") or {})
+    finally:
+        bm.free()
+    return {"ngons": ngons, "loose_v": loose_v, "loose_e": loose_e,
+            "nonman": nonman, "zero_area": zero_area, "doubles": doubles}
+
+
+def shells(me):
+    neighbors = [[] for _ in range(len(me.vertices))]
+    for edge in me.edges:
+        a, b = edge.vertices
+        neighbors[a].append(b)
+        neighbors[b].append(a)
+    seen = [False] * len(me.vertices)
+    groups = []
+    for start in range(len(me.vertices)):
+        if seen[start]:
+            continue
+        seen[start] = True
+        stack = [start]
+        group = []
+        while stack:
+            cur = stack.pop()
+            group.append(cur)
+            for nxt in neighbors[cur]:
+                if not seen[nxt]:
+                    seen[nxt] = True
+                    stack.append(nxt)
+        groups.append(group)
+    return groups
+
+
+def zfight_pairs(me):
+    """Coplanar face pairs from *different shells* (copied from showcase/grindstone)."""
+    owner = {}
+    for si, g in enumerate(shells(me)):
+        for vi in g:
+            owner[vi] = si
+    faces = [(p.normal.copy(), p.center.copy(), owner.get(p.vertices[0], -1))
+             for p in me.polygons]
+    kd = KDTree(len(faces))
+    for i, (_n, c, _s) in enumerate(faces):
+        kd.insert(c, i)
+    kd.balance()
+    hits = 0
+    for i, (ni, ci, si) in enumerate(faces):
+        for _co, j, _d in kd.find_range(ci, COPLANAR_CENTRE_MAX):
+            if j <= i:
+                continue
+            nj, cj, sj = faces[j]
+            if si == sj:
+                continue
+            if abs(abs(ni.dot(nj)) - 1.0) > COPLANAR_NORMAL_EPS:
+                continue
+            if abs(ni.dot(cj - ci)) > COPLANAR_PLANE_EPS:
+                continue
+            hits += 1
+    return hits
+
+
+def right_angle_edges(me):
+    """Manifold edges between two wood faces that meet within 5 degrees of 90."""
+    count = 0
+    bm = bmesh.new()
+    try:
+        bm.from_mesh(me)
+        for e in bm.edges:
+            if len(e.link_faces) != 2:
+                continue
+            if any(f.material_index != WOOD_IDX for f in e.link_faces):
+                continue
+            if abs(e.calc_face_angle(0.0) - math.pi / 2.0) <= RIGHT_ANGLE_TOL:
+                count += 1
+    finally:
+        bm.free()
+    return count
+
+
+def shell_tree(me, groups):
+    member = set(i for g in groups for i in g)
+    order = sorted(member)
+    remap = {v: k for k, v in enumerate(order)}
+    polys = [[remap[i] for i in p.vertices] for p in me.polygons if p.vertices[0] in member]
+    return BVHTree.FromPolygons([me.vertices[i].co.copy() for i in order], polys)
+
+
+def depth_in(tree, p, reach=1.0):
+    """Signed depth of ``p`` inside the shell ``tree``: positive inside, negative outside."""
+    hit = tree.find_nearest(p, reach)
+    if hit[0] is None:
+        return -reach
+    loc, nrm, _i, dist = hit
+    return dist if (p - loc).dot(nrm) < 0.0 else -dist
+
+
+def classify(me):
+    """Split the finished mesh into named parts by material and shape."""
+    mats = {}
+    for p in me.polygons:
+        for i in p.vertices:
+            mats.setdefault(i, p.material_index)
+    groups = shells(me)
+    owner = {}
+    for si, g in enumerate(groups):
+        for i in g:
+            owner[i] = si
+    big, polys = {}, {}
+    for p in me.polygons:
+        si = owner[p.vertices[0]]
+        polys.setdefault(si, []).append(p)
+        if si not in big or p.area > big[si].area:
+            big[si] = p
+    out = {k: [] for k in ("side", "top", "cornice", "back", "cross", "cover", "pages",
+                           "band", "other")}
+    for si, g in enumerate(groups):
+        pts = [me.vertices[i].co.copy() for i in g]
+        lo = Vector((min(p.x for p in pts), min(p.y for p in pts), min(p.z for p in pts)))
+        hi = Vector((max(p.x for p in pts), max(p.y for p in pts), max(p.z for p in pts)))
+        ext = hi - lo
+        rec = {"g": g, "pts": pts, "lo": lo, "hi": hi, "ext": ext,
+               "c": sum(pts, Vector()) / len(pts)}
+        m = mats.get(g[0], -1)
+        if m == WOOD_IDX:
+            if ext.x < 0.05 and ext.z > 0.9:
+                out["side"].append(rec)
+            elif ext.y < 0.03 and ext.z > 0.9:
+                out["back"].append(rec)
+            elif lo.z > SIDE_H:
+                out["cornice"].append(rec)
+            elif hi.z > SIDE_H:
+                out["top"].append(rec)
+            elif ext.x > 0.7:
+                out["cross"].append(rec)
+            else:
+                out["other"].append(rec)
+        elif m in (CLOTH_IDX, LEATHER_IDX):
+            face = big[si]
+            rec["n"] = face.normal.copy()
+            # The two boards' outer faces: the largest faces, one per side.
+            ranked = sorted(polys[si], key=lambda p: -p.area)[:4]
+            rec["boards"] = [(p.center.copy(), p.normal.copy()) for p in ranked
+                             if abs(abs(p.normal.dot(face.normal)) - 1.0) < 1e-3]
+            rec["face_len"] = max((me.vertices[face.vertices[k]].co
+                                   - me.vertices[face.vertices[k - 1]].co).length
+                                  for k in range(len(face.vertices)))
+            out["cover"].append(rec)
+        elif m == PAPER_IDX:
+            out["pages"].append(rec)
+        elif m == GILT_IDX:
+            out["band"].append(rec)
+        else:
+            out["other"].append(rec)
+    return out
+
+
+def overlaps_xy(a, b, pad=0.0):
+    return (a["lo"].x - pad < b["hi"].x and b["lo"].x - pad < a["hi"].x
+            and a["lo"].y - pad < b["hi"].y and b["lo"].y - pad < a["hi"].y)
+
+
+def bookshelf_audit(me):
+    parts = classify(me)
+    out = {k: len(v) for k, v in parts.items()}
+    sides = sorted(parts["side"], key=lambda r: r["c"].x)
+    out["side_z"] = max((r["lo"].z for r in sides), default=99.0)
+
+    # Every cross member is housed in both sides: bite past the inner face,
+    # and clear of the far face.
+    bite, far = 99.0, 99.0
+    if len(sides) == 2:
+        left_in, left_out = sides[0]["hi"].x, sides[0]["lo"].x
+        right_in, right_out = sides[1]["lo"].x, sides[1]["hi"].x
+        for r in parts["cross"]:
+            bite = min(bite, left_in - r["lo"].x, r["hi"].x - right_in)
+            far = min(far, r["lo"].x - left_out, right_out - r["hi"].x)
+    out["dado"], out["dado_far"] = bite, far
+
+    # Books: each cover with the page block and bands nearest it.
+    covers = parts["cover"]
+    trees = [shell_tree(me, [c["g"]]) for c in covers]
+    units = [{"cover": c, "tree": t, "pages": [], "band": []} for c, t in zip(covers, trees)]
+    for kind in ("pages", "band"):
+        for r in parts[kind]:
+            # The cover every vertex of the part sits closest to, on average:
+            # a page block's corners are in its own boards, a band on its own
+            # spine. A centroid alone is nearer a neighbour's board in a stack.
+            if units:
+                u = min(units, key=lambda u: sum(u["tree"].find_nearest(p)[3]
+                                                 for p in r["pts"]) / len(r["pts"]))
+                u[kind].append(r)
+    out["units"] = len(units)
+    out["unmatched"] = sum(1 for u in units if len(u["pages"]) != 1 or len(u["band"]) != 2)
+
+    # Pages glued in: every page-block corner inside the cover's boards.
+    page_d = [depth_in(u["tree"], p) for u in units for r in u["pages"] for p in r["pts"]]
+    out["page_bite"] = (min(page_d, default=-99.0), max(page_d, default=99.0))
+
+    # Bands on the spine: inner face inside the cover, outer face proud.
+    b_in, b_out = [], []
+    for u in units:
+        for r in u["band"]:
+            ds = sorted(depth_in(u["tree"], p) for p in r["pts"])
+            half = len(ds) // 2
+            b_in.extend(ds[half:])
+            b_out.append(-max(ds[:half]))
+    out["band_bite"] = (min(b_in, default=-99.0), max(b_in, default=99.0))
+    out["band_proud"] = min(b_out, default=-99.0)
+
+    # Pose of each book from its largest face, a board: upright, lying or leaning.
+    for u in units:
+        c = u["cover"]
+        n = c["n"]
+        tilt = math.asin(min(1.0, abs(n.z)))
+        c["pose"] = ("up" if tilt <= UPRIGHT_TILT_MAX else
+                     "lying" if tilt >= LYING_TILT_MIN else "lean")
+        c["tilt"] = tilt
+        ds = [p.dot(n) for p in c["pts"]]
+        c["thick"] = max(ds) - min(ds)
+    out["n_lean"] = sum(1 for u in units if u["cover"]["pose"] == "lean")
+    out["n_lying"] = sum(1 for u in units if u["cover"]["pose"] == "lying")
+
+    # Seat: what each book stands on is the highest shelf or cover under its
+    # footprint whose top is within reach of its lowest point.
+    shelves = [r for r in parts["cross"] if r["ext"].y > 0.15]
+    horizontals = shelves + parts["top"]
+    seats = []
+    for u in units:
+        c = u["cover"]
+        cands = [r for r in shelves + covers if r is not c and overlaps_xy(r, c)
+                 and c["lo"].z - 0.02 <= r["hi"].z <= c["lo"].z + 0.01]
+        if cands:
+            u["support"] = max(cands, key=lambda r: r["hi"].z)
+            seats.append(u["support"]["hi"].z - c["lo"].z)
+    out["seat"] = (min(seats, default=-99.0), max(seats, default=99.0))
+    out["n_seated"] = len(seats)
+
+    # Headroom: the top of each book (bands included) under the member above.
+    heads = []
+    for u in units:
+        c = u["cover"]
+        top = max([c["hi"].z] + [r["hi"].z for r in u["band"]])
+        above = [h for h in horizontals if h["lo"].z > c["lo"].z + 0.05]
+        if above:
+            heads.append(min(h["lo"].z for h in above) - top)
+    out["headroom"] = min(heads, default=-99.0)
+
+    # Size spread: thickness across the boards, height along the board face.
+    th = [u["cover"]["thick"] for u in units]
+    hs = [u["cover"]["face_len"] for u in units]
+    out["thick_spread"] = max(th) / min(th) if th else 0.0
+    out["height_spread"] = max(hs) / min(hs) if hs else 0.0
+
+    # Lean contact: the neighbour's head edge in the leaning board, as a band.
+    leans = []
+    for u in units:
+        c = u["cover"]
+        if c["pose"] != "lean":
+            continue
+        n = c["n"] if c["n"].x > 0 else -c["n"]
+        up_x = -n.z  # the board's up direction, in the XZ plane, has this x
+        side = 1.0 if up_x > 0 else -1.0
+        sup = u.get("support")
+        mates = [v for v in units if v["cover"]["pose"] == "up" and v.get("support") is sup
+                 and (v["cover"]["c"].x - c["c"].x) * side > 0]
+        if not mates:
+            leans.append(-99.0)
+            continue
+        mate = min(mates, key=lambda v: abs(v["cover"]["c"].x - c["c"].x))
+        u["lean_on"] = mate
+        # Depth past the plane of the leaning board's outer face, read off the
+        # mesh, over the neighbour's vertices near that board. A plane, not
+        # the cover solid: the board is 2.8 mm thick, and a head edge driven
+        # right through it is in the hollow, outside the cover again.
+        to_mate = mate["cover"]["c"] - c["c"]
+        facing = [b for b in c["boards"] if b[1].dot(to_mate) > 0.0]
+        if not facing:
+            leans.append(-99.0)
+            continue
+        p0, n = max(facing, key=lambda b: b[0].dot(b[1]))
+        ds = [-(p - p0).dot(n) for p in mate["cover"]["pts"]
+              if u["tree"].find_nearest(p, LEAN_SEARCH)[0] is not None]
+        leans.append(max(ds, default=-99.0))
+    out["lean"] = (min(leans, default=-99.0), max(leans, default=99.0))
+
+    # Books do not run into one another, nor into the carcass, except where
+    # they are meant to: a book on the one it is stacked on, a leaning book
+    # on its neighbour, a book in the shelf it stands on.
+    utrees = [shell_tree(me, [u["cover"]["g"]] + [r["g"] for r in u["pages"] + u["band"]])
+              for u in units]
+    carcass = [r for k in ("side", "back", "cross", "top", "cornice") for r in parts[k]]
+    ctrees = [shell_tree(me, [r["g"]]) for r in carcass]
+    designed = set()
+    for i, u in enumerate(units):
+        for j, v in enumerate(units):
+            if u.get("support") is v["cover"] or u.get("lean_on") is v:
+                designed.add((min(i, j), max(i, j)))
+    hits, where = 0, []
+    for i in range(len(units)):
+        for j in range(i + 1, len(units)):
+            if (i, j) in designed:
+                continue
+            if utrees[i].overlap(utrees[j]):
+                hits += 1
+                where.append((units[i]["cover"]["c"], units[j]["cover"]["c"]))
+        for r, ct in zip(carcass, ctrees):
+            if r is units[i].get("support"):
+                continue
+            if utrees[i].overlap(ct):
+                hits += 1
+                where.append((units[i]["cover"]["c"], r["c"]))
+    out["book_hits"] = hits
+    out["hit_at"] = where
+    return out
+
+
+def make_lod(obj, name, ratio, skip_decimate):
+    mesh = obj.data.copy()
+    lod = bpy.data.objects.new(name, mesh)
+    lod.matrix_world = obj.matrix_world.copy()
+    bpy.context.scene.collection.objects.link(lod)
+    if not skip_decimate and 0.0 < ratio < 1.0:
+        mod = lod.modifiers.new("DecimateBudget", "DECIMATE")
+        mod.decimate_type = "COLLAPSE"
+        mod.ratio = ratio
+    return lod
+
+
+def hull_collider(obj, name):
+    """One convex hull over the carcass; the books sit inside it."""
+    me = obj.data
+    mats = {}
+    for p in me.polygons:
+        for i in p.vertices:
+            mats.setdefault(i, p.material_index)
+    pts = [me.vertices[i].co.copy() for i in range(len(me.vertices)) if mats.get(i) == WOOD_IDX]
+    mesh = bpy.data.meshes.new(name)
+    bm = bmesh.new()
+    try:
+        vs = [bm.verts.new(p) for p in pts]
+        ret = bmesh.ops.convex_hull(bm, input=vs)
+        drop = []
+        for v in ret["geom_interior"] + ret["geom_unused"]:
+            if isinstance(v, bmesh.types.BMVert) and v not in drop:
+                drop.append(v)
+        bmesh.ops.delete(bm, geom=drop, context="VERTS")
+        bmesh.ops.dissolve_limit(bm, angle_limit=math.radians(1.0),
+                                 verts=list(bm.verts), edges=list(bm.edges))
+        bmesh.ops.triangulate(bm, faces=list(bm.faces))
+        bm.to_mesh(mesh)
+        mesh.update()
+    finally:
+        bm.free()
+    col = bpy.data.objects.new(name, mesh)
+    bpy.context.collection.objects.link(col)
+    return col
+
+
+def setup_bake_image(obj, target_mat, size):
+    img = bpy.data.images.new("BookshelfNrm", size, size, alpha=True, float_buffer=False)
+    img.colorspace_settings.name = "Non-Color"
+    nodes = target_mat.node_tree.nodes
+    tex = nodes.new("ShaderNodeTexImage")
+    tex.image = img
+    nodes.active = tex
+    tex.select = True
+    obj.active_material_index = WOOD_IDX
+    return img, tex
+
+
+def bake_normal(high, low):
+    scene = bpy.context.scene
+    scene.render.engine = "CYCLES"
+    scene.cycles.device = "CPU"
+    scene.cycles.samples = 1
+    scene.cycles.use_denoising = False
+    for ob in bpy.context.view_layer.objects:
+        ob.select_set(False)
+    high.select_set(True)
+    low.select_set(True)
+    bpy.context.view_layer.objects.active = low
+    return bpy.ops.object.bake(
+        type="NORMAL", use_selected_to_active=True, cage_extrusion=CAGE_EXTRUSION,
+        use_cage=False, normal_space="TANGENT", margin=4,
+        margin_type="ADJACENT_FACES", use_clear=True, target="IMAGE_TEXTURES",
+    )
+
+
+def export_unity(path, objects):
+    for ob in bpy.context.view_layer.objects:
+        ob.select_set(False)
+    for ob in objects:
+        ob.select_set(True)
+    bpy.context.view_layer.objects.active = objects[0]
+    bpy.ops.export_scene.gltf(
+        filepath=path, use_selection=True, export_yup=True, export_apply=True,
+        export_draco_mesh_compression_enable=False, export_animations=False,
+    )
+
+
+def check(skip_decimate, lift_z=False, **flags):
+    bpy.ops.wm.read_factory_settings(use_empty=True)
+    nothing = (None,) * 5
+    low = build_bookshelf_mesh("BookshelfLow", **flags)
+    hi_flags = {k: v for k, v in flags.items() if k != "stray_vert"}
+    high = build_bookshelf_mesh("BookshelfHigh", **hi_flags)
+    mats = bookshelf_materials()
+    assign_slots(low, mats)
+    assign_slots(high, mats)
+    if lift_z:
+        for v in low.data.vertices:
+            v.co.z += LIFT_Z
+        low.data.update()
+        bpy.context.view_layer.update()
+    if len(low.data.polygons) < 6 or not low.data.uv_layers:
+        return (fail("bookshelf mesh did not build, or has no UV layer", 3),) + nothing
+
+    base_tris = triangle_count(low.data)
+    slots = [s for s in low.data.materials if s is not None]
+    nmat, distinct = len(slots), len({id(s) for s in slots})
+    idx_counts = {}
+    for poly in low.data.polygons:
+        idx_counts[poly.material_index] = idx_counts.get(poly.material_index, 0) + 1
+    u0, v0, u1, v1, overlap, nfaces = uv_stats(low.data)
+    bb = world_bbox(low)
+    size_x, size_y, size_z = bb[3] - bb[0], bb[4] - bb[1], bb[5] - bb[2]
+
+    img, tex = setup_bake_image(low, mats[WOOD_IDX], BAKE_RES)
+    bake_result = bake_normal(high, low)
+
+    lod1 = make_lod(low, "BookshelfLOD1", LOD1_TARGET, skip_decimate)
+    lod2 = make_lod(low, "BookshelfLOD2", LOD2_TARGET, skip_decimate)
+    bpy.context.view_layer.update()
+    lod1_tris = evaluated_triangle_count(lod1)
+    lod2_tris = evaluated_triangle_count(lod2)
+    r1 = lod1_tris / base_tris if base_tris else 0.0
+    r2 = lod2_tris / base_tris if base_tris else 0.0
+
+    collider = hull_collider(high, "BookshelfCollider")
+    col_tris = triangle_count(collider.data)
+
+    export_path = os.path.join(tempfile.gettempdir(), f"bdt_bookshelf_{os.getpid()}.glb")
+    if os.path.exists(export_path):
+        os.remove(export_path)
+    export_unity(export_path, [low, collider])
+    export_size = os.path.getsize(export_path) if os.path.isfile(export_path) else 0
+    # Blender points TMPDIR at its own temp preference, which on a portable
+    # build is the working directory, so the export must not outlive this.
+    if os.path.isfile(export_path):
+        os.remove(export_path)
+
+    hyg = hygiene_audit(low.data)
+    zf = zfight_pairs(low.data)
+    sa = bookshelf_audit(low.data)
+    right = right_angle_edges(low.data)
+
+    print(f"blender={tuple(bpy.app.version)} skip_decimate={skip_decimate}")
+    print(f"measured mat_index_counts={dict(sorted(idx_counts.items()))}")
+    print(f"measured base_tris={base_tris} lod1_tris={lod1_tris} "
+          f"lod2_tris={lod2_tris} r1={r1:.4f} r2={r2:.4f}")
+    print(f"measured nmat={nmat} uv=({u0:.4f},{v0:.4f})-({u1:.4f},{v1:.4f}) "
+          f"overlap={overlap:.6f} nfaces={nfaces}")
+    print(f"measured bbox=({size_x:.4f},{size_y:.4f},{size_z:.4f}) "
+          f"outer={OUTER_SIZE} zmin={bb[2]:.5f}")
+    print(f"measured collider_tris={col_tris} bake={bake_result} "
+          f"bake_has_data={img.has_data} export_bytes={export_size}")
+    print(f"measured hygiene loose_v={hyg['loose_v']} loose_e={hyg['loose_e']} "
+          f"nonman={hyg['nonman']} zero_area={hyg['zero_area']} "
+          f"doubles={hyg['doubles']} ngons={hyg['ngons']} zfight={zf}")
+    print(f"measured parts sides={sa['side']} top={sa['top']} cornice={sa['cornice']} "
+          f"back={sa['back']} cross={sa['cross']} covers={sa['cover']} pages={sa['pages']} "
+          f"bands={sa['band']} other={sa['other']} unmatched={sa['unmatched']} "
+          f"lean={sa['n_lean']} lying={sa['n_lying']} side_z={sa['side_z']:.5f}")
+    print(f"measured joints dado={sa['dado']:.5f} dado_far={sa['dado_far']:.5f} "
+          f"page_bite=({sa['page_bite'][0]:.5f},{sa['page_bite'][1]:.5f})")
+    print(f"measured seats book=({sa['seat'][0]:.5f},{sa['seat'][1]:.5f}) n={sa['n_seated']} "
+          f"band_bite=({sa['band_bite'][0]:.5f},{sa['band_bite'][1]:.5f}) "
+          f"band_proud={sa['band_proud']:.5f}")
+    print(f"measured headroom={sa['headroom']:.5f} thick_spread={sa['thick_spread']:.3f} "
+          f"height_spread={sa['height_spread']:.3f} "
+          f"lean=({sa['lean'][0]:.5f},{sa['lean'][1]:.5f}) book_hits={sa['book_hits']} "
+          f"right_angle_wood={right}")
+
+    if not (BASE_TRIS_MIN <= base_tris <= BASE_TRIS_MAX):
+        return (fail(f"base tris {base_tris} not in [{BASE_TRIS_MIN}, {BASE_TRIS_MAX}]", 4),) + nothing
+    if nmat != MATERIAL_COUNT or distinct != MATERIAL_COUNT:
+        return (fail(f"material slots {nmat} distinct {distinct} != {MATERIAL_COUNT}", 5),) + nothing
+    for idx, floor in FACE_FLOORS.items():
+        if idx_counts.get(idx, 0) < floor:
+            return (fail(f"material {idx} faces {idx_counts.get(idx, 0)} < {floor}", 5),) + nothing
+    if u0 < -UV_EPS or v0 < -UV_EPS or u1 > 1.0 + UV_EPS or v1 > 1.0 + UV_EPS:
+        return (fail(f"UVs outside 0..1: ({u0:.4f},{v0:.4f})-({u1:.4f},{v1:.4f})", 6),) + nothing
+    if overlap > UV_OVERLAP_MAX:
+        return (fail(f"UV AABB overlap {overlap:.6f} > {UV_OVERLAP_MAX}", 7),) + nothing
+    if (abs(size_x - OUTER_SIZE[0]) > BBOX_TOL or abs(size_y - OUTER_SIZE[1]) > BBOX_TOL
+            or abs(size_z - OUTER_SIZE[2]) > BBOX_TOL):
+        return (fail(f"bbox ({size_x:.4f},{size_y:.4f},{size_z:.4f}) off outer {OUTER_SIZE}", 8),) + nothing
+    if not (LOD1_RATIO_MIN <= r1 <= LOD1_RATIO_MAX):
+        return (fail(f"LOD1 ratio {r1:.4f} not in [{LOD1_RATIO_MIN}, {LOD1_RATIO_MAX}] "
+                     "(--skip-decimate is the designed fail)", 9),) + nothing
+    if not (LOD2_RATIO_MIN <= r2 <= LOD2_RATIO_MAX):
+        return (fail(f"LOD2 ratio {r2:.4f} not in [{LOD2_RATIO_MIN}, {LOD2_RATIO_MAX}]", 9),) + nothing
+    if col_tris > COLLIDER_TRIS_MAX:
+        return (fail(f"collider tris {col_tris} > {COLLIDER_TRIS_MAX}", 11),) + nothing
+    if bake_result != {"FINISHED"} or not img.has_data:
+        return (fail(f"bake failed result={bake_result} has_data={img.has_data}", 12),) + nothing
+    if export_size <= 0:
+        return (fail("export file missing or empty", 13),) + nothing
+    if (hyg["loose_v"] or hyg["loose_e"] or hyg["nonman"] or hyg["zero_area"]
+            or hyg["doubles"] or hyg["ngons"] or zf):
+        return (fail(f"hygiene {hyg} zfight={zf} (--stray-vert is the designed fail)", 15),) + nothing
+    if abs(bb[2]) > ZMIN_EPS:
+        return (fail(f"zmin {bb[2]:.6f} not within {ZMIN_EPS} of 0 "
+                     "(--lift-z is the designed fail)", 16),) + nothing
+    if sa["side"] != 2 or sa["side_z"] > SIDE_Z_MAX:
+        return (fail(f"sides: {sa['side']} of 2, worst side z={sa['side_z']:.5f} > {SIDE_Z_MAX} "
+                     "(--float-side is the designed fail)", 16),) + nothing
+    if sa["cross"] != N_CROSS or sa["dado"] < DADO_MIN or sa["dado_far"] < DADO_FAR_MIN:
+        return (fail(f"{sa['cross']} of {N_CROSS} cross members, dado bite {sa['dado']:.5f} "
+                     f"(min {DADO_MIN}), far face {sa['dado_far']:.5f} (min {DADO_FAR_MIN}) "
+                     "(--short-shelves is the designed fail)", 17),) + nothing
+    if (sa["units"] != N_BOOKS or sa["unmatched"] or sa["page_bite"][0] < PAGE_BITE_MIN
+            or sa["page_bite"][1] > PAGE_BITE_MAX):
+        return (fail(f"{sa['units']} of {N_BOOKS} books, {sa['unmatched']} without one page "
+                     f"block and two bands, page bite {sa['page_bite']} outside "
+                     f"[{PAGE_BITE_MIN}, {PAGE_BITE_MAX}] (--loose-pages is the designed fail)",
+                     17),) + nothing
+    if sa["n_seated"] != N_BOOKS or sa["seat"][0] < SEAT_MIN or sa["seat"][1] > SEAT_MAX:
+        return (fail(f"{sa['n_seated']} of {N_BOOKS} books seated, seat {sa['seat']} outside "
+                     f"[{SEAT_MIN}, {SEAT_MAX}] (--float-books is the designed fail)", 18),) + nothing
+    if (sa["band_bite"][0] < BAND_BITE_MIN or sa["band_bite"][1] > BAND_BITE_MAX
+            or sa["band_proud"] < BAND_PROUD_MIN):
+        return (fail(f"band bite {sa['band_bite']} outside [{BAND_BITE_MIN}, {BAND_BITE_MAX}] "
+                     f"or proud {sa['band_proud']:.5f} < {BAND_PROUD_MIN} "
+                     "(--float-bands is the designed fail)", 18),) + nothing
+    if sa["headroom"] < HEADROOM_MIN:
+        return (fail(f"headroom {sa['headroom']:.5f} < {HEADROOM_MIN} "
+                     "(--tall-book is the designed fail)", 20),) + nothing
+    if sa["thick_spread"] < THICK_SPREAD_MIN or sa["height_spread"] < HEIGHT_SPREAD_MIN:
+        return (fail(f"book spread thickness {sa['thick_spread']:.3f} (min {THICK_SPREAD_MIN}), "
+                     f"height {sa['height_spread']:.3f} (min {HEIGHT_SPREAD_MIN}) "
+                     "(--uniform-books is the designed fail)", 21),) + nothing
+    if (sa["n_lean"] != N_LEAN or sa["n_lying"] != N_LYING
+            or sa["lean"][0] < LEAN_BITE_MIN or sa["lean"][1] > LEAN_BITE_MAX):
+        return (fail(f"{sa['n_lean']} of {N_LEAN} leaning and {sa['n_lying']} of {N_LYING} lying "
+                     f"books, lean contact {sa['lean']} outside [{LEAN_BITE_MIN}, {LEAN_BITE_MAX}] "
+                     "(--air-lean and --deep-lean are the designed fails)", 22),) + nothing
+    if sa["book_hits"]:
+        return (fail(f"{sa['book_hits']} book overlaps, need 0 "
+                     "(--crowd-books is the designed fail)", 23),) + nothing
+    if right:
+        return (fail(f"{right} right-angle wood edges, need 0 "
+                     "(--sharp-shelf is the designed fail)", 24),) + nothing
+    return 0, low, high, mats, tex, collider
+
+
+def wire_normal(mat, tex):
+    nt = mat.node_tree
+    nrm = nt.nodes.new("ShaderNodeNormalMap")
+    nt.links.new(tex.outputs["Color"], nrm.inputs["Color"])
+    nt.links.new(nrm.outputs["Normal"], nt.nodes["Principled BSDF"].inputs["Normal"])
+
+
+def render_still(low, mats, tex, path, engine):
+    scene = bpy.context.scene
+    wire_normal(mats[WOOD_IDX], tex)
+    for ob in list(scene.objects):
+        if ob.type == "MESH" and ob != low:
+            ob.hide_render = True
+            ob.hide_viewport = True
+    # Level on the floor: turned about Z only.
+    low.rotation_euler.z = math.radians(-14.0)
+
+    floor_me = bpy.data.meshes.new("Floor")
+    bm = bmesh.new()
+    try:
+        bmesh.ops.create_grid(bm, x_segments=1, y_segments=1, size=60.0)
+        bm.to_mesh(floor_me)
+    finally:
+        bm.free()
+    fmat = bpy.data.materials.new("Floor")
+    fmat.use_nodes = True
+    fb = fmat.node_tree.nodes["Principled BSDF"]
+    fb.inputs["Base Color"].default_value = (0.03, 0.032, 0.037, 1.0)
+    fb.inputs["Roughness"].default_value = 0.7
+    floor_me.materials.append(fmat)
+    floor = bpy.data.objects.new("Floor", floor_me)
+    scene.collection.objects.link(floor)
+    wall = bpy.data.objects.new("Wall", floor_me.copy())
+    wall.location = (0.0, 8.5, 0.0)
+    wall.rotation_euler = (math.radians(90), 0.0, 0.0)
+    scene.collection.objects.link(wall)
+
+    world = bpy.data.worlds.new("World")
+    world.use_nodes = True
+    world.node_tree.nodes["Background"].inputs["Color"].default_value = (0.02, 0.021, 0.025, 1.0)
+    scene.world = world
+
+    def light(name, kind, loc, energy, size, col, rot=(0, 0, 0)):
+        ld = bpy.data.lights.new(name, kind)
+        ld.energy = energy
+        if kind == "AREA":
+            ld.size = size
+        else:
+            ld.shadow_soft_size = size
+        ld.color = col
+        ob = bpy.data.objects.new(name, ld)
+        ob.location = loc
+        ob.rotation_euler = tuple(math.radians(a) for a in rot)
+        scene.collection.objects.link(ob)
+
+    light("Key", "AREA", (-2.4, -3.4, 3.2), 480.0, 3.0, (1.0, 0.95, 0.88), (50, 0, -35))
+    light("Fill", "AREA", (3.2, -2.8, 1.6), 80.0, 5.0, (0.74, 0.84, 1.0), (68, 0, 48))
+    light("Rim", "AREA", (-1.8, 2.6, 2.6), 220.0, 3.0, (0.62, 0.78, 1.0), (-55, 0, 200))
+    ld = bpy.data.lights.new("Wedge", "SPOT")
+    ld.energy, ld.color = 260.0, (1.0, 0.66, 0.34)
+    ld.spot_size, ld.spot_blend, ld.shadow_soft_size = math.radians(50.0), 1.0, 0.3
+    wedge = bpy.data.objects.new("Wedge", ld)
+    wedge.location = (0.6, 1.8, 2.2)
+    wedge.rotation_euler = (Vector((0.2, 0.6, 0.0)) - wedge.location).to_track_quat(
+        "-Z", "Y").to_euler()
+    scene.collection.objects.link(wedge)
+
+    cam_data = bpy.data.cameras.new("Cam")
+    cam_data.lens = 50.0
+    cam = bpy.data.objects.new("Cam", cam_data)
+    cam.location = (1.27, -3.74, 1.175)
+    scene.collection.objects.link(cam)
+    aim = bpy.data.objects.new("Aim", None)
+    aim.location = (0.0, 0.0, 0.565)
+    scene.collection.objects.link(aim)
+    con = cam.constraints.new("TRACK_TO")
+    con.target = aim
+    con.track_axis = "TRACK_NEGATIVE_Z"
+    con.up_axis = "UP_Y"
+    scene.camera = cam
+
+    scene.render.engine = "CYCLES" if engine == "cycles" else eevee_engine_id()
+    if engine == "cycles":
+        scene.cycles.samples = 32
+        scene.cycles.device = "CPU"
+    else:
+        try:
+            scene.eevee.taa_render_samples = 64
+        except AttributeError:
+            pass
+    scene.render.resolution_x = 1280
+    scene.render.resolution_y = 720
+    scene.render.image_settings.file_format = "WEBP" if path.lower().endswith(".webp") else "PNG"
+    if path.lower().endswith(".webp"):
+        scene.render.image_settings.quality = 90
+    scene.render.filepath = path
+    scene.view_settings.view_transform = "Standard"
+
+    fcode = gallery_framing.check_framing(scene, cam, hero=[low], elements=[low], stage=[floor, wall])
+    if fcode:
+        return fcode
+    bpy.ops.render.render(write_still=True)
+    if not (os.path.exists(path) and os.path.getsize(path) > 0):
+        return fail("render produced no file", 14)
+    return 0
+
+
+def main():
+    argv = sys.argv[sys.argv.index("--") + 1:] if "--" in sys.argv else []
+    p = argparse.ArgumentParser()
+    p.add_argument("--output", default=None)
+    p.add_argument("--engine", default="eevee", choices=("eevee", "cycles"))
+    p.add_argument("--skip-decimate", action="store_true")
+    p.add_argument("--stray-vert", action="store_true")
+    p.add_argument("--lift-z", action="store_true")
+    p.add_argument("--float-side", action="store_true")
+    p.add_argument("--short-shelves", action="store_true")
+    p.add_argument("--loose-pages", action="store_true")
+    p.add_argument("--float-books", action="store_true")
+    p.add_argument("--float-bands", action="store_true")
+    p.add_argument("--tall-book", action="store_true")
+    p.add_argument("--uniform-books", action="store_true")
+    p.add_argument("--air-lean", action="store_true")
+    p.add_argument("--deep-lean", action="store_true")
+    p.add_argument("--crowd-books", action="store_true")
+    p.add_argument("--sharp-shelf", action="store_true")
+    args = p.parse_args(argv)
+
+    code, low, _high, mats, tex, _col = check(
+        args.skip_decimate,
+        lift_z=args.lift_z,
+        stray_vert=args.stray_vert,
+        float_side=args.float_side,
+        short_shelves=args.short_shelves,
+        sharp_shelf=args.sharp_shelf,
+        loose_pages=args.loose_pages,
+        float_books=args.float_books,
+        float_bands=args.float_bands,
+        tall_book=args.tall_book,
+        uniform_books=args.uniform_books,
+        crowd_books=args.crowd_books,
+        air_lean=args.air_lean,
+        deep_lean=args.deep_lean,
+    )
+    if code:
+        return code
+    if args.output:
+        rcode = render_still(low, mats, tex, os.path.abspath(args.output), args.engine)
+        if rcode:
+            return rcode
+        print(f"rendered still {args.output}")
+    print("bookshelf OK")
+    return 0
+
+
+if __name__ == "__main__":
+    try:
+        sys.exit(main())
+    except Exception as e:
+        traceback.print_exc()
+        print(f"FATAL: {e}", file=sys.stderr)
+        sys.exit(1)
+
+
+
+ + + A stained wooden bookcase with three shelves of cloth and leather hardbacks with gilt spine bands, some standing, some stacked flat, and two leaning against their neighbours. + +
+
+ generated from showcase/gallery.json + CC-BY-NC-ND-4.0 + exit 0 +
+
+ + + diff --git a/docs/gallery/contact-sheets/bookshelf-contact-sheet.webp b/docs/gallery/contact-sheets/bookshelf-contact-sheet.webp new file mode 100644 index 0000000000000000000000000000000000000000..8a927c27e2a14965d303cba753a5b8ba468638ac GIT binary patch literal 44458 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 and Showcase autocomplete="off" spellcheck="false" aria-label="Search examples and showcase pieces" /> - 51 examples, 34 showcase pieces + 51 examples, 35 showcase pieces
@@ -1276,6 +1276,17 @@

butter-churn

View showcase piece butter-churn
+
+ +
+

bookshelf

+

A procedural bookcase — two housed shelves, a base on a recessed plinth, lapped back boards and a stepped cornice, filled with thirty-eight rounded-spine hardbacks standing, stacked and leaning — carried through UVs, bake, LOD, convex collider, and Unity glTF, asserting recomputed budgets rather than an API contract.

+

witnesses Recomputed: 10908 tris, five materials with 338 wood, 2050 cloth, 1066 leather, 228 paper and 1976 gilt faces, UVs in 0..1 with zero AABB overlap, outer AABB 0.972×0.332×1.176 m, zmin 0, hygiene 0 including zero coplanar cross-shell pairs, both sides on the floor, four cross members 8 mm into both sides, 38 books each with one page block 0.6 mm into its boards and two gilt bands 0.3 mm into the spine and 0.8 mm proud, every book seated 1.0–3.2 mm, 44 mm headroom, thickness and height spread 2.90 and 1.65, both leaning books 0.8 mm onto their neighbour's head edge, zero unplanned book overlaps, zero right-angle wood edges, convex collider 68 tris. --air-lean and --deep-lean exit 22 on the lean contact while every seat, the envelope and the overlap budget still pass; --crowd-books exits 23; --uniform-books 21; --tall-book 20.

+ View showcase piece bookshelf +
+
@@ -1305,7 +1316,7 @@

butter-churn

var tagsToggle = document.getElementById('tagsToggle'); var toTop = document.getElementById('toTop'); var total = cards.length; - var COUNT_LABEL = '51 examples, 34 showcase pieces'; + var COUNT_LABEL = '51 examples, 35 showcase pieces'; var LS_KEY = 'bdt-gallery-density'; var reduced = window.matchMedia && window.matchMedia('(prefers-reduced-motion: reduce)').matches; diff --git a/scripts/asset_sheet.py b/scripts/asset_sheet.py index 265a9d43..18e10f67 100644 --- a/scripts/asset_sheet.py +++ b/scripts/asset_sheet.py @@ -61,6 +61,7 @@ "vertex-color-ao": (r"^Well\.Stone\.", None), "wooden-yoke": (r"^YokeLow$", None), "apothecary-shelf": (r"^ShelfLow$", None), + "bookshelf": (r"^BookshelfLow$", None), "brazier": (r"^BrazierLow$", None), "grain-sacks": (r"^SacksLow$", None), "rope-bridge": (r"^BridgeLow$", None), diff --git a/showcase/bookshelf/README.md b/showcase/bookshelf/README.md new file mode 100644 index 00000000..6492f443 --- /dev/null +++ b/showcase/bookshelf/README.md @@ -0,0 +1,293 @@ +# bookshelf + +![A stained wooden bookcase with three shelves of cloth and leather hardbacks with gilt spine bands, some standing, some stacked flat, and two leaning against their neighbours](preview.webp) + +A bookcase: a stained carcass with two shelves housed in its sides, a base +on a recessed plinth, lapped back boards and a stepped cornice, filled +with thirty-eight hardbacks. Twenty-nine stand upright, seven lie in +three stacks, and two lean on a neighbour. Every book is a rounded-spine +cover in cloth or leather, a page block glued into it, and two gilt bands +tooled round the spine. **A showcase piece, not an example** — it +witnesses no API contract. It asserts that generated geometry meets +declared asset budgets, recomputed from the finished mesh. + +## What it composes + +| Shipped content | Used for | +| --- | --- | +| `skills/mesh-editing-and-bmesh` | chamfered boards, U-section covers with rounded spines, page blocks and bands built on the spine's own chain, all in `bmesh` | +| `skills/custom-properties` | face attributes (`PlankTone`, `GrainDir`, `Tint`) read by the shaders | +| `skills/procedural-materials-and-shaders` | grained stain, cloth, leather, ruled page edges, gilt | +| `skills/bake-high-to-low` | Cycles tangent-space normal bake, high onto low | +| `skills/engine-export-presets` | Unity glTF (`export_yup=True`) | +| `skills/depsgraph-and-evaluated-data` | evaluated triangle counts for the LOD ratios | +| `snippets/decimate_to_budget.py` | LOD1 / LOD2 COLLAPSE chain | +| `snippets/convex_hull_collider.py` | one hull over the carcass | +| `snippets/lod_chain.py` | LOD naming and ratio pattern | +| `examples/mesh-hygiene-audit` | hygiene combinatorics (copied, not imported) | + +## The budget that matters + +A leaning book has to rest on its neighbour's head edge and on the shelf, +not in either. Tip it a few degrees too far and its board cuts through the +neighbour's corner; not far enough and it stands in the air against +nothing. Neither is visible to any other budget: + +- the leaning book still stands on its shelf, so the seat budget passes; +- it stays inside the carcass, so the bounding box does not move; +- the triangle count is the same, because only a position changed; +- the book-overlap budget has to exempt this very contact, so it cannot + see how deep the contact goes. + +The piece finds the leaning books on the finished mesh (a book whose +largest face, a board, is tilted between 3° and 80°) and the upright +neighbour on the side its top leans toward, on the same shelf. It takes +the plane of the leaning board's outer face off the mesh and measures how +far the neighbour's deepest vertex sits behind it, as a band of +0.3–2.0 mm. Both lean at 0.80 mm. + +A plane, not the cover solid: the board is 2.8 mm thick, and a head edge +driven right through it lies in the hollow of the book, outside the cover +again, so a solid test reads a deep cut as no contact at all. That is how +the first `--deep-lean` passed. + +`--air-lean` and `--deep-lean` are the falsifiers built for exactly this. +One stops each leaning book 3 mm short of its neighbour, the other drives +it 4.5 mm in. Both exit 22 while every seat, the envelope and the book +overlap budget still pass. + +## Budgets + +Declared in the script as named constants, recomputed from the generated +mesh. Measured values are from Blender 5.2.1; see the cross-version table +below. + +| Budget | Band | Measured | +| --- | --- | --- | +| Base triangles | 10400–11400 | 10908 | +| LOD1 ratio | 0.32–0.62 | 0.5000 | +| LOD2 ratio | 0.10–0.35 | 0.2189 (0.2198 on 4.5 and 5.1) | +| Material slots | exactly 5, distinct | 5 | +| Wood / cloth / leather faces | ≥ 300 / 1850 / 960 | 338 / 2050 / 1066 | +| Paper / gilt faces | ≥ 200 / 1780 | 228 / 1976 | +| UV bounds | inside 0..1 | (0.0004, 0.0004)–(0.9996, 0.9996) | +| UV AABB overlap | ≤ 1e-5 | 0.000000 | +| Outer AABB | 0.972 × 0.332 × 1.176 m ± 0.020 | 0.9720 × 0.3320 × 1.1760 | +| Collider triangles | ≤ 200 | 68 | +| Normal bake | `{'FINISHED'}` with image data | `{'FINISHED'}`, `has_data=True` | +| glTF export | file written, non-empty | ~786 kB | +| Hygiene | all zero | loose 0/0, non-manifold 0, zero-area 0, doubles 0, n-gons 0, coplanar cross-shell pairs 0 | +| Grounded AABB | \|zmin\| ≤ 1e-4 | 0.00000 | +| Named sides | 2 sides, each zmin ≤ 1e-4 | 2 at 0.00000 | +| Dado | 4 cross members, each ≥ 5 mm into both sides and ≥ 6 mm clear of the far face | 8.00 mm in, 14.00 mm clear | +| Page block | 38 books, one block and two bands each; every block corner 0.3–1.2 mm inside its boards | 0.60 mm | +| Book seat | 38 books, each 0.5–3.6 mm into the shelf or the book it stands on | 1.00–3.16 mm | +| Band seat | inner face 0.1–0.8 mm inside the spine, outer face ≥ 0.4 mm proud | 0.29 mm in, 0.80 mm proud | +| Headroom | every book ≥ 20 mm under the member above | 44.36 mm | +| Size spread | thickest / thinnest ≥ 2.5; tallest / shortest ≥ 1.5 | 2.900 / 1.645 | +| Lean contact | 2 leaning and 7 lying books; each neighbour's head edge 0.3–2.0 mm behind the leaning board | 0.80 mm | +| Book overlaps | 0, book against book and against the carcass, designed contacts exempt | 0 | +| Edge treatment | right-angle wood edges | 0 | + +Real-world size: 0.97 m wide over the cornice, 1.18 m tall and 0.33 m +deep. Each compartment is 318–348 mm clear, and the books run from a +186 mm octavo to a 305 mm folio. + +## Construction + +- **Carcass.** Two full-height sides carry everything and are the only + named supports. The plinth, the base and the two shelves are each housed + `DADO` (8 mm) into both sides and stop 14 mm short of the outer faces. + The plinth stands 18 mm back from the base's front and 4 mm off the + floor, so only the sides ground. The top is seated over the sides and + the back boards; the cornice steps 10 mm out past it and is seated + `CORN_BITE` into it, its back held 4 mm short of the top's back so the + two do not share a plane. Every board is chamfered at 2.5 mm with + `material=` pinned to wood, edges sorted by index. +- **Back boards.** Five vertical boards, lapped 2 mm into one another and + every other one stepped forward 1.5 mm, as on `apothecary-shelf`. +- **Covers.** One shell per book: a U of front board, half-round spine and + back board, extruded up the height (`SPINE_ARC` = 6 segments). The + boards are tangent to the spine, so it reads round and the boards flat. + Every edge over 40° is chamfered 0.8 mm; the spine facets (30°) are not, + and shade smooth. +- **Page blocks.** A block inside the U, `SQUARE` (4 mm) short of the + cover at head, tail and fore-edge, biting `PAGE_BITE` (0.6 mm) into both + boards. Its back stops 1.5 mm short of the line where boards meet spine, + which is where the band ends lie. +- **Gilt bands.** Two per book, built on the cover's own outer chain round + the spine: every band vertex sits on a cover vertex's normal, inner face + 0.3 mm inside the spine and outer face 0.8 mm proud. +- **Standing books.** Set along each shelf with a 2.5–4.5 mm gap, spines a + stepped 6–14 mm back from the shelf front, each seated a stepped + 1.0–3.3 mm into the shelf. Each stands a degree or two off square, in a + four-step cycle (−2.4°, −0.8°, 0.8°, 2.4°). +- **Stacks.** Books laid on a board, spine out, yawed ±3° alternately and + shifted a few millimetres. The bottom one seats into the shelf; each one + above takes a 1.0–1.4 mm seat into the board below it. +- **Leaning books.** Turned about Y by 18° (bottom shelf, onto the book on + its left) and 22° (middle shelf, onto the book on its right), seated on + the shelf by the lowest vertex of the chamfered cover. Then the leaning + book (or, leaning right, its neighbour) is slid along the shelf until + the neighbour's deepest vertex is `LEAN_BITE` (0.8 mm) behind the + leaning board's outer face. Each leaning book is taller than its + neighbour's head divided by the cosine of its lean, so the head edge + meets the board and not its top corner. + +## Findings the budgets forced + +- **Coplanar page blocks and shelves.** The first page blocks sat 3 mm + short of the cover's tail, and one book seated 2.98 mm into its shelf put + its page block's underside 0.02 mm off the shelf top: a coplanar pair. + The square is now 4 mm, clear of every seat. +- **Every spine has the same facet angles.** A half-round spine of six + facets has the same six facet normals on every book. Square to the + shelf, two neighbours share a facet plane whenever their offsets happen + to line up, and the uniform and crowded falsifiers did so (five and + twelve coplanar pairs). Each upright now stands a degree or two off + square in a four-step cycle. A half-degree cycle was not enough: on a + 45° chamfer the normals differ by half the yaw, inside the 1e-4 + parallel tolerance. +- **Planes facing the front.** Spine lines, band ends and fore-edges face + the shelf front, and two neighbours landed band ends on one plane. Each + book is stepped back 0.9 mm at a time until none of its front-facing + planes is within 0.4 mm of a neighbour's. +- **A stacked book on a page block's plane.** A book stacked on another + with the running seat (up to 3.3 mm) could land its underside on the + plane of the lower book's page block, 2.2 mm inside its board. A stacked + book now takes its own 1.0–1.4 mm seat. +- **Matching parts to books.** Page blocks were first matched to the cover + nearest their centroid. In a stack, the centroid of a thick book's page + block is nearer the board of the book above than its own. Parts are now + matched on the mean distance of all their vertices. +- **Deep lean through the board.** Measured against the cover solid, a + head edge driven 4.5 mm into a 2.8 mm board came out in the hollow of + the leaning book and read as no contact, so `--deep-lean` exited 0. The + contact is now measured against the plane of the board's outer face. +- **Black gilt.** Fully metallic bands facing the camera mirrored the dark + stage and read black except at their edges. The gilt is half metallic. + +## Conventions walked + +Every convention in `showcase/README.md`, and whether it applies here. + +| Convention | Applies | How | +| --- | --- | --- | +| Deterministic, budgets declared, assertions recompute | yes | no RNG; every value above is read off the mesh | +| Falsifier fails the budget it targets | yes | table below, proven on all three binaries | +| Hygiene incl. cross-shell coplanar | yes | exit 15; square, yaw cycle, front-plane step and stack seat chosen to keep it at 0 | +| Named supports | yes | the two sides (`--float-side`); the plinth stops 4 mm off the floor | +| Joint-fit budgets | yes | dado bite and far-face clearance per cross member (`--short-shelves`) | +| A member is tenoned into its seat | yes | top over sides and back boards, cornice into the top, back boards into the base | +| A platform bears on something | yes | every shelf housed in both sides and biting the back boards | +| Carried parts bite their bearers | yes | books into shelves and into the book below (`--float-books`) | +| A joint bites; touching is not joining | yes | page blocks into their boards (`--loose-pages`); the lean contact as a band | +| Bands on a curved host are built on the host's arc | yes | gilt bands on the spine's own chain (`--float-bands`) | +| A leaning prop rests on something | yes | the lean contact, exit 22 (`--air-lean`, `--deep-lean`) | +| Scattered parts do not interpenetrate | yes | exit 23 (`--crowd-books`), designed contacts exempt and counted | +| Scatter varies in size | yes | thickness and height spread, exit 21 (`--uniform-books`) | +| The subject hangs where it can be seen / headroom | yes | every book under the member above, exit 20 (`--tall-book`) | +| Edge treatment: no right angles | yes | exit 24 (`--sharp-shelf`), wood only; covers chamfered 0.8 mm by construction | +| Aim an edge falsifier at one member | yes | one shelf left square: 12 edges | +| Sort bmesh operator inputs | yes | bevel edges sorted by index, carcass and covers | +| A plank wall is boards | yes | five lapped back boards | +| Identical boards read as CG | yes | per-board `PlankTone` and `GrainDir`; per-book `Tint` | +| Variation goes into surface, never into function | yes | sizes, tints, gaps and yaw vary; shelf pitch and seats are budgets | +| Shading is part of the model | yes | spines smooth (round); every edge over 35° hard, so boards and chamfers read crisp | +| One substance, one slot | yes | wood, cloth, leather, paper, gilt | +| Iron is not chrome | n/a | no iron; gilt is half metallic, roughness 0.45 | +| Bake texels per UV cell | measured, not a budget | 1024 px over a 76-cell grid, about 13 px per cell | +| The bake cage is narrower than the nearest neighbour | yes | `CAGE_EXTRUSION` 0.01 m | +| Level on the stage; stage 60 m | yes | turned about Z only; 60 m floor and wall | +| Keep a falsifier's envelope still | yes | every falsifier leaves the AABB unchanged | +| Mirror symmetry, plumb, rope, masonry, roofs, rings, terrain, vessels | no | the piece has none of these | + +## Falsifiers + +Each breaks one pipeline stage so a **named** budget fails. All fifteen +were run on 4.5.11, 5.1.2 and 5.2.1 and exited the same declared code on +all three. + +| Flag | Target budget | Breaks | Exit | +| --- | --- | --- | --- | +| `--skip-decimate` | LOD1 ratio | drops the DECIMATE modifiers, LOD1 ratio goes to 1.0000 | 9 | +| `--stray-vert` | mesh hygiene | adds one loose vertex inside the carcass | 15 | +| `--lift-z` | grounded zmin | lifts the whole mesh 50 mm | 16 | +| `--float-side` | named sides | lifts the left side 5 mm; the right side still grounds the AABB | 16 | +| `--short-shelves` | dado bite | stops the two shelves 4 mm short of the sides; −4.0 mm | 17 | +| `--loose-pages` | page-block bite | builds every page block 0.9 mm clear of its boards; −0.9 mm | 17 | +| `--float-books` | book seat | lifts every book 6 mm; −5.0 mm | 18 | +| `--float-bands` | band seat | builds every band 1.1 mm off its spine; −1.1 mm | 18 | +| `--tall-book` | headroom | stretches one middle-shelf folio 1.20 into the shelf above; −3.9 mm | 20 | +| `--uniform-books` | size spread | one height and depth, thickness within ±1.5 %; 1.030 / 1.000 | 21 | +| `--air-lean` | lean contact | stops each leaning book 3 mm short of its neighbour; −3.0 mm | 22 | +| `--deep-lean` | lean contact | drives each leaning book 4.5 mm into its neighbour; 4.5 mm | 22 | +| `--crowd-books` | book overlaps | closes the top shelf's gaps to −4.1 mm; 11 overlaps | 23 | +| `--sharp-shelf` | edge treatment | leaves the top shelf unchamfered; 12 right-angle edges | 24 | + +## Exit codes + +File-local and sequential. `9` is a valid check code. `1` is the FATAL +wrapper — a crash, never a named check. `19` (plumb and real-world size) +is reserved across pieces and unused here. + +| Code | Meaning | +| --- | --- | +| 0 | Success | +| 1 | Uncaught exception (FATAL wrapper) | +| 2 | argparse / usage | +| 3 | Mesh did not build, or has no UV layer | +| 4 | Base triangle count outside band | +| 5 | Material slots, or a material's face floor | +| 6 | UVs outside 0..1 | +| 7 | UV AABB overlap above tolerance | +| 8 | Outer AABB off declared size | +| 9 | LOD1 or LOD2 ratio outside band (`--skip-decimate`) | +| 10 | Framing gate (`examples/gallery_framing.py`, render path only) | +| 11 | Collider triangles above ceiling | +| 12 | Normal bake failed or produced no image data | +| 13 | glTF export missing or empty | +| 14 | `--output` produced no file | +| 15 | Mesh hygiene (`--stray-vert`) | +| 16 | Grounded zmin, or a side floating (`--lift-z`, `--float-side`) | +| 17 | Dado or page-block bite, or a book without one block and two bands (`--short-shelves`, `--loose-pages`) | +| 18 | Book or band seat (`--float-books`, `--float-bands`) | +| 20 | Headroom under the member above (`--tall-book`) | +| 21 | Size spread below floor (`--uniform-books`) | +| 22 | Lean contact, or leaning / lying count (`--air-lean`, `--deep-lean`) | +| 23 | Books overlap each other or the carcass (`--crowd-books`) | +| 24 | Right-angle wood edges (`--sharp-shelf`) | + +## Run it + +```bash +# Budget check, no render. +blender --background --python bookshelf.py -- + +# Falsifier: each leaning book stops short of its neighbour. Must exit 22. +blender --background --python bookshelf.py -- --air-lean + +# Falsifier: each leaning book cuts into its neighbour. Must exit 22. +blender --background --python bookshelf.py -- --deep-lean + +# Render the gallery still (EEVEE; --engine cycles on a GPU-less host). +blender --background --python bookshelf.py -- --output bookshelf.webp +``` + +Smoke runs the check-only path. It does not pass `--output` or any falsifier. + +## Cross-version measurements + +| Value | 4.5.11 | 5.1.2 | 5.2.1 | +| --- | --- | --- | --- | +| Base triangles | 10908 | 10908 | 10908 | +| LOD1 / LOD2 tris | 5454 / 2398 | 5454 / 2398 | 5454 / 2388 | +| Face counts (wood / cloth / leather / paper / gilt) | 338 / 2050 / 1066 / 228 / 1976 | same | same | +| Outer AABB | 0.9720 × 0.3320 × 1.1760 | same | same | +| Collider tris | 68 | 68 | 68 | +| Headroom / spread / lean | 44.36 mm / 2.900, 1.645 / 0.80 mm | same | same | +| glTF bytes | 785836 | 785836 | 785828 | + +LOD2 differs by ten triangles on 5.2 (DECIMATE COLLAPSE, the known +divergence; the gate is a ratio band) and the glTF size by 8 bytes +(exporter metadata, not a budget). Every other value is identical. diff --git a/showcase/bookshelf/bookshelf.py b/showcase/bookshelf/bookshelf.py new file mode 100644 index 00000000..9d212312 --- /dev/null +++ b/showcase/bookshelf/bookshelf.py @@ -0,0 +1,1701 @@ +"""Game-ready bookshelf with leaning books — a showcase piece, not an example. + +Asserts budget conformance of a procedural bookcase: a stained carcass +with two housed shelves, a base on a recessed plinth, lapped back boards +and a stepped cornice, filled with thirty-eight hardback books. Most +stand upright; seven lie in three stacks; two lean on a neighbour. Every +book is a rounded-spine cover in cloth or leather, a page block glued +into it, and two gilt bands tooled round the spine. Carried through UVs, +five materials (wood, cloth, leather, paper, gilt), a high-to-low normal +bake, an LOD chain, a convex collider, and a Unity glTF export. + +The budget that matters is the one a leaning book fails invisibly: it has +to rest on its neighbour's head edge and on the shelf, not in either. Tip +it a few degrees too far and its board cuts through the neighbour's +corner; not far enough and it stands in the air against nothing. Every +seat, the bounding box, the triangle count and the book-overlap budget +(which must exempt the designed contact) still pass either way. The piece +finds each leaning book and its neighbour on the finished mesh and asserts +how deep the neighbour's head edge sits in the leaning board, as a band. + +Budgets are declared below and recomputed from the generated result. +They are not API-contract witnesses. Each falsifier violates one named +budget: ``--skip-decimate`` the LOD-ratio band, ``--stray-vert`` mesh +hygiene, ``--lift-z`` grounded zmin, ``--float-side`` the named sides, +``--short-shelves`` the dado bite, ``--loose-pages`` the page-block bite, +``--float-books`` the book seat, ``--float-bands`` the band seat, +``--tall-book`` the headroom, ``--uniform-books`` the size spread, +``--air-lean`` and ``--deep-lean`` the lean contact, ``--crowd-books`` +book interpenetration, ``--sharp-shelf`` edge treatment. + +No randomness: every book's size, tint, gap, setback and seat is a table +entry or a closed-form term of its index. DECIMATE COLLAPSE triangle +counts are not byte-identical across Blender versions — the LOD gate is a +ratio band. + + blender --background --python bookshelf.py -- + blender --background --python bookshelf.py -- --air-lean + blender --background --python bookshelf.py -- --output bookshelf.png +""" +import argparse +import math +import os +import sys +import tempfile +import traceback + +import bmesh +import bpy +from mathutils import Matrix, Vector +from mathutils.bvhtree import BVHTree +from mathutils.kdtree import KDTree + +_REPO = os.path.abspath( + os.path.join(os.path.dirname(os.path.abspath(__file__)), os.pardir, os.pardir) +) +sys.path.insert(0, os.path.join(_REPO, "examples")) +sys.dont_write_bytecode = True +import gallery_framing # noqa: E402 + +# The carcass. X across, Y front (-) to back (+), Z up. Two full-height +# sides carry everything; every cross member is housed into both of them. +W_OUT = 0.920 +SIDE_T = 0.022 +DEPTH = 0.300 +SIDE_H = 1.140 +DADO = 0.008 +TOP_T = 0.026 +TOP_SEAT = 0.006 +TOP_OVER = 0.016 +TOP_BACK_OVER = 0.006 +CORN_T = 0.020 +CORN_OVER = 0.010 +CORN_BITE = 0.004 +CORN_BACK_IN = 0.004 +BACK_T = 0.012 +BACK_INSET = 0.010 +BACK_BITE = 0.005 +N_BACK = 5 +BACK_LAP = 0.002 +BACK_STEP = 0.0015 +SHELF_T = 0.022 +SHELF_SETBACK = 0.004 +SHELF_TOPS = (0.460, 0.800) +BASE_Z = 0.070 +BASE_T = 0.020 +BASE_SETBACK = 0.004 +PLINTH_Z0 = 0.004 +PLINTH_SET = 0.018 +PLINTH_T = 0.018 +PLINTH_BITE = 0.004 +CHAMFER = 0.0025 + +# Books. Local frame: X across the thickness, Y from the spine (-) to the +# fore-edge (+), Z up the height, bottom of the cover at 0. The cover is +# one shell: a U of board, rounded spine and board, extruded up the +# height. The page block sits inside it, SQUARE short of the cover at the +# head, tail and fore-edge, and bites PAGE_BITE into both boards. +COVER_B = 0.0028 +SQUARE = 0.004 +PAGE_BACK = 0.0015 +PAGE_BITE = 0.0006 +LOOSE_PAGES = 0.0009 +SPINE_ARC = 6 +COVER_CHAMFER = 0.0008 +BAND_OFF = 0.018 +BAND_H = 0.006 +BAND_BITE = 0.0003 +BAND_PROUD = 0.0008 +FLOAT_BAND = 0.0011 +SEAT_BASE = 0.0010 +SEAT_STEP = 0.00018 +FLOAT_BOOKS = 0.006 +FLOAT_SIDE = 0.005 +START_GAP = 0.006 +GAP_BASE = 0.0025 +GAP_SPAN = 0.0020 +CROWD_GAP = -0.0041 +SET_BASE = 0.006 +SET_STEP = 0.0013 +SET_CLEAR = 0.0004 +SET_NUDGE = 0.0009 +STACK_YAW = math.radians(3.0) +STACK_SHIFT = 0.006 +LEAN_BITE = 0.0008 +AIR_LEAN = -0.003 +DEEP_LEAN = 0.0045 +TALL_BOOK = 1.20 +UNIFORM_BOOK = (0.034, 0.230, 0.170) +UNIFORM_JIT = 0.03 +UPRIGHT_YAW = (-2.4, -0.8, 0.8, 2.4) + +# Per shelf, left to right. ("up", T, H, D, kind), ("lean", T, H, D, kind, +# direction, degrees), ("stack", [(T, H, D, kind), ...] bottom first), +# ("gap", width). kind: "c" cloth, "l" leather. A leaning book leans onto +# the upright beside it: -1 onto the book on its left, +1 onto the right. +LAYOUT = ( + ( + ("stack", [(0.046, 0.300, 0.228, "l"), (0.036, 0.285, 0.214, "c")]), + ("gap", 0.014), + ("up", 0.052, 0.305, 0.226, "l"), + ("up", 0.034, 0.282, 0.205, "c"), + ("up", 0.041, 0.291, 0.214, "c"), + ("up", 0.058, 0.268, 0.198, "l"), + ("up", 0.030, 0.296, 0.221, "c"), + ("up", 0.044, 0.262, 0.192, "c"), + ("up", 0.037, 0.276, 0.207, "l"), + ("up", 0.049, 0.255, 0.188, "c"), + ("lean", 0.036, 0.300, 0.218, "c", -1, 18.0), + ), + ( + ("lean", 0.032, 0.268, 0.196, "l", 1, 22.0), + ("up", 0.040, 0.228, 0.170, "c"), + ("up", 0.026, 0.251, 0.183, "c"), + ("up", 0.047, 0.262, 0.194, "l"), + ("up", 0.022, 0.214, 0.158, "c"), + ("up", 0.035, 0.240, 0.176, "c"), + ("up", 0.055, 0.270, 0.201, "l"), + ("up", 0.029, 0.233, 0.172, "c"), + ("up", 0.038, 0.246, 0.180, "c"), + ("up", 0.024, 0.221, 0.163, "l"), + ("gap", 0.050), + ("stack", [(0.034, 0.232, 0.170, "c"), (0.028, 0.214, 0.160, "l"), + (0.022, 0.196, 0.148, "c")]), + ), + ( + ("up", 0.031, 0.236, 0.172, "c"), + ("up", 0.024, 0.212, 0.156, "c"), + ("up", 0.043, 0.254, 0.187, "l"), + ("up", 0.020, 0.198, 0.146, "c"), + ("up", 0.036, 0.226, 0.166, "c"), + ("up", 0.028, 0.243, 0.178, "l"), + ("up", 0.045, 0.265, 0.195, "c"), + ("up", 0.022, 0.205, 0.151, "c"), + ("up", 0.033, 0.219, 0.161, "l"), + ("up", 0.039, 0.248, 0.182, "c"), + ("up", 0.026, 0.186, 0.140, "c"), + ("up", 0.030, 0.231, 0.170, "c"), + ("gap", 0.080), + ("stack", [(0.030, 0.226, 0.166, "l"), (0.024, 0.200, 0.150, "c")]), + ), +) +TALL_TARGET = (1, 6) # the 0.270 m leather volume on the middle shelf +CLOTH_TINTS = ((0.22, 0.035, 0.030), (0.045, 0.095, 0.055), (0.035, 0.050, 0.115), + (0.33, 0.21, 0.075), (0.10, 0.105, 0.11), (0.12, 0.045, 0.085), + (0.30, 0.21, 0.13), (0.045, 0.095, 0.095)) +LEATHER_TINTS = ((0.17, 0.070, 0.030), (0.26, 0.12, 0.050), (0.085, 0.040, 0.020), + (0.21, 0.055, 0.030)) + +BBOX_TOL = 0.020 +OUTER_SIZE = (0.972, 0.332, 1.176) + +BASE_TRIS_MIN = 10400 +BASE_TRIS_MAX = 11400 +LOD1_RATIO_MIN = 0.32 +LOD1_RATIO_MAX = 0.62 +LOD2_RATIO_MIN = 0.10 +LOD2_RATIO_MAX = 0.35 +LOD1_TARGET = 0.50 +LOD2_TARGET = 0.22 +MATERIAL_COUNT = 5 +FACE_FLOORS = {0: 300, 1: 1850, 2: 960, 3: 200, 4: 1780} +UV_EPS = 1e-4 +UV_OVERLAP_MAX = 1e-5 +COLLIDER_TRIS_MAX = 200 +BAKE_RES = 1024 +CAGE_EXTRUSION = 0.01 +ZMIN_EPS = 1e-4 +DOUBLES_EPS = 1e-5 +AREA_EPS = 1e-10 +COPLANAR_NORMAL_EPS = 1e-4 +COPLANAR_PLANE_EPS = 1e-4 +COPLANAR_CENTRE_MAX = 0.05 +LIFT_Z = 0.05 +SIDE_Z_MAX = 1e-4 +DADO_MIN = 0.005 +DADO_FAR_MIN = 0.006 +PAGE_BITE_MIN = 0.0003 +PAGE_BITE_MAX = 0.0012 +SEAT_MIN = 0.0005 +SEAT_MAX = 0.0036 +BAND_BITE_MIN = 0.0001 +BAND_BITE_MAX = 0.0008 +BAND_PROUD_MIN = 0.0004 +HEADROOM_MIN = 0.020 +THICK_SPREAD_MIN = 2.5 +HEIGHT_SPREAD_MIN = 1.5 +UPRIGHT_TILT_MAX = math.radians(3.0) +LYING_TILT_MIN = math.radians(80.0) +LEAN_BITE_MIN = 0.0003 +LEAN_BITE_MAX = 0.0020 +LEAN_SEARCH = 0.03 +RIGHT_ANGLE_TOL = math.radians(5.0) + +WOOD_IDX = 0 +CLOTH_IDX = 1 +LEATHER_IDX = 2 +PAPER_IDX = 3 +GILT_IDX = 4 +N_CROSS = len(SHELF_TOPS) + 2 +N_BOOKS = sum(len(it[1]) if it[0] == "stack" else (0 if it[0] == "gap" else 1) + for row in LAYOUT for it in row) +N_LEAN = sum(1 for row in LAYOUT for it in row if it[0] == "lean") +N_LYING = sum(len(it[1]) for row in LAYOUT for it in row if it[0] == "stack") + + +def eevee_engine_id(): + """EEVEE id: 'BLENDER_EEVEE' on 5.0+, 'BLENDER_EEVEE_NEXT' on 4.2-4.5.""" + return "BLENDER_EEVEE" if bpy.app.version >= (5, 0, 0) else "BLENDER_EEVEE_NEXT" + + +def fail(msg, code): + print(f"FAIL[{code}]: {msg}", file=sys.stderr) + return code + + +def triangle_count(mesh): + mesh.calc_loop_triangles() + return len(mesh.loop_triangles) + + +def evaluated_triangle_count(obj): + deps = bpy.context.evaluated_depsgraph_get() + ev = obj.evaluated_get(deps) + mesh = ev.to_mesh() + try: + mesh.calc_loop_triangles() + return len(mesh.loop_triangles) + finally: + ev.to_mesh_clear() + + +def frac(x): + return x - math.floor(x) + + +# --- one book, in its own frame --------------------------------------------- + + +def spine_chain(t, d): + """Centre line of the cover's U and its outward normal at each point. + + Front board from the fore-edge to the spine, a half-round spine of + SPINE_ARC segments, back board to the fore-edge. The boards are tangent + to the spine, so the spine reads round and the boards flat. + """ + rc = t / 2.0 - COVER_B / 2.0 + yc = -d / 2.0 + t / 2.0 + pts = [(Vector((-rc, d / 2.0)), Vector((-1.0, 0.0)))] + for k in range(SPINE_ARC + 1): + phi = math.pi + math.pi * k / SPINE_ARC + n = Vector((math.cos(phi), math.sin(phi))) + pts.append((Vector((0.0, yc)) + n * rc, n)) + pts.append((Vector((rc, d / 2.0)), Vector((1.0, 0.0)))) + return pts, yc + + +def book_local(t, h, d, loose_pages=False, float_bands=False): + """A hardback in its own frame: cover, page block and two gilt bands. + + Returns (verts, faces) with each face as (vertex indices, kind), kind + 0 cover, 1 pages, 2 band. The cover is chamfered here, in its own + bmesh, so the placement code sees the finished corners it will rest on. + """ + chain, yc = spine_chain(t, d) + bm = bmesh.new() + try: + kind = bm.faces.layers.int.new("kind") + outer = [p + n * (COVER_B / 2.0) for p, n in chain] + inner = [p - n * (COVER_B / 2.0) for p, n in chain] + + def ring(pts2, z): + return [bm.verts.new((p.x, p.y, z)) for p in pts2] + + ob, ot = ring(outer, 0.0), ring(outer, h) + ib, it = ring(inner, 0.0), ring(inner, h) + m = len(chain) + for i in range(m - 1): + j = i + 1 + bm.faces.new((ob[i], ob[j], ot[j], ot[i])) + bm.faces.new((ib[j], ib[i], it[i], it[j])) + bm.faces.new((ot[i], ot[j], it[j], it[i])) + bm.faces.new((ob[j], ob[i], ib[i], ib[j])) + bm.faces.new((ob[0], ot[0], it[0], ib[0])) + e = m - 1 + bm.faces.new((ib[e], it[e], ot[e], ob[e])) + # The bevel picks edges by face angle, which needs consistent normals. + bmesh.ops.recalc_face_normals(bm, faces=list(bm.faces)) + bm.edges.index_update() + edges = sorted((ed for ed in bm.edges if ed.calc_face_angle(0.0) > math.radians(40.0)), + key=lambda ed: ed.index) + bmesh.ops.bevel(bm, geom=edges, offset=COVER_CHAMFER, segments=1, profile=0.5, + affect="EDGES", clamp_overlap=True) + bmesh.ops.triangulate(bm, faces=[f for f in bm.faces if len(f.verts) > 4]) + + # Page block: inside the U, biting both boards, square short of the + # cover at head, tail and fore-edge. Its back stops PAGE_BACK short of + # the line where the boards meet the spine, where the band ends lie. + px = t / 2.0 - COVER_B + (-LOOSE_PAGES if loose_pages else PAGE_BITE) + lo = Vector((-px, yc + PAGE_BACK, SQUARE)) + hi = Vector((px, d / 2.0 - SQUARE, h - SQUARE)) + corner = {} + for a in (0, 1): + for b in (0, 1): + for c in (0, 1): + corner[(a, b, c)] = bm.verts.new((hi.x if a else lo.x, hi.y if b else lo.y, + hi.z if c else lo.z)) + box = (((0, 0, 0), (0, 1, 0), (1, 1, 0), (1, 0, 0)), + ((0, 0, 1), (1, 0, 1), (1, 1, 1), (0, 1, 1)), + ((0, 0, 0), (1, 0, 0), (1, 0, 1), (0, 0, 1)), + ((0, 1, 0), (0, 1, 1), (1, 1, 1), (1, 1, 0)), + ((0, 0, 0), (0, 0, 1), (0, 1, 1), (0, 1, 0)), + ((1, 0, 0), (1, 1, 0), (1, 1, 1), (1, 0, 1))) + for quad in box: + f = bm.faces.new([corner[q] for q in quad]) + f[kind] = 1 + + # Gilt bands round the spine, built on the cover's own outer chain: + # every band vertex sits on a cover vertex's normal, so the band + # follows the round of the spine exactly. + span = range(1, SPINE_ARC + 2) + inner_off = FLOAT_BAND if float_bands else -BAND_BITE + outer_off = inner_off + BAND_BITE + BAND_PROUD + for z0 in (BAND_OFF, h - BAND_OFF - BAND_H): + g = {} + for j in span: + p, n = chain[j] + for side, off in (("in", inner_off), ("out", outer_off)): + q = p + n * (COVER_B / 2.0 + off) + for zz, z in (("b", z0), ("t", z0 + BAND_H)): + g[(j, side, zz)] = bm.verts.new((q.x, q.y, z)) + quads = [] + for j in list(span)[:-1]: + k = j + 1 + quads.append((g[(j, "out", "b")], g[(k, "out", "b")], g[(k, "out", "t")], + g[(j, "out", "t")])) + quads.append((g[(k, "in", "b")], g[(j, "in", "b")], g[(j, "in", "t")], + g[(k, "in", "t")])) + quads.append((g[(j, "out", "t")], g[(k, "out", "t")], g[(k, "in", "t")], + g[(j, "in", "t")])) + quads.append((g[(k, "out", "b")], g[(j, "out", "b")], g[(j, "in", "b")], + g[(k, "in", "b")])) + a, z = span[0], span[-1] + quads.append((g[(a, "in", "b")], g[(a, "out", "b")], g[(a, "out", "t")], + g[(a, "in", "t")])) + quads.append((g[(z, "out", "b")], g[(z, "in", "b")], g[(z, "in", "t")], + g[(z, "out", "t")])) + for vs in quads: + f = bm.faces.new(vs) + f[kind] = 2 + bm.verts.index_update() + verts = [v.co.copy() for v in bm.verts] + faces = [(tuple(v.index for v in f.verts), f[kind]) for f in bm.faces] + finally: + bm.free() + return verts, faces + + +# --- the layout ------------------------------------------------------------- + + +def cover_points(book): + return [book["world"][i] for i in book["cover_ix"]] + + +def bounds(pts): + return (Vector((min(p.x for p in pts), min(p.y for p in pts), min(p.z for p in pts))), + Vector((max(p.x for p in pts), max(p.y for p in pts), max(p.z for p in pts)))) + + +def move(book, delta): + book["M"] = Matrix.Translation(delta) @ book["M"] + book["world"] = [p + delta for p in book["world"]] + + +def make_book(dims, rot, loose_pages, float_bands): + t, h, d, kind = dims + verts, faces = book_local(t, h, d, loose_pages=loose_pages, float_bands=float_bands) + cover_ix = sorted({i for vs, k in faces if k == 0 for i in vs}) + return {"t": t, "h": h, "d": d, "kind": kind, "verts": verts, "faces": faces, + "cover_ix": cover_ix, "M": rot.copy(), "world": [rot @ v for v in verts]} + + +def lean_face(book, side): + """Point and outward normal of a leaning book's board face on ``side``.""" + rot = book["M"].to_3x3() + n = (rot @ Vector((float(side), 0.0, 0.0))).normalized() + return book["M"] @ Vector((side * book["t"] / 2.0, 0.0, 0.0)), n + + +def penetration(pts, p0, n): + """How far the deepest of ``pts`` sits behind the plane (p0, n).""" + return max(-(p - p0).dot(n) for p in pts) + + +def plan_books(loose_pages=False, float_books=False, float_bands=False, tall_book=False, + uniform_books=False, crowd_books=False, air_lean=False, deep_lean=False): + """Place every book. Closed-form: sizes from LAYOUT, the rest from the index. + + Each book is built, turned, then set down: its lowest cover vertex a + stepped seat into whatever it stands on, its spine a stepped setback + from the shelf front, and along the shelf at the running cursor. A + leaning book is then slid (or its neighbour is) until the neighbour's + head edge sits the lean bite into the leaning board. + """ + x_in = W_OUT / 2.0 - SIDE_T + y_front = -DEPTH / 2.0 + SHELF_SETBACK + tops = (BASE_Z + BASE_T,) + SHELF_TOPS + bite = LEAN_BITE + (AIR_LEAN - LEAN_BITE if air_lean else 0.0) + ( + DEEP_LEAN - LEAN_BITE if deep_lean else 0.0) + lift = FLOAT_BOOKS if float_books else 0.0 + books = [] + for s, row in enumerate(LAYOUT): + cursor = -x_in + START_GAP + k = 0 + placed = [] + pending = None + + def sized(dims, s=s, ii=None, j=0): + t, h, d, kind = dims + if uniform_books: + # One height and depth; thickness within +-1.5 %, so no two + # spines are the same solid set a hair apart. + n = s * 100 + (ii or 0) * 5 + j + ft = 1.0 + UNIFORM_JIT * (frac(n * 0.6180339887 + 0.1) - 0.5) + t, h, d = UNIFORM_BOOK[0] * ft, UNIFORM_BOOK[1], UNIFORM_BOOK[2] + if tall_book and (s, ii) == TALL_TARGET: + h *= TALL_BOOK + return (t, h, d, kind) + + def gap_of(k, s=s): + if crowd_books and s == 2: + return CROWD_GAP + return GAP_BASE + GAP_SPAN * frac(k * 0.6180339887 + 0.3 + s * 0.17) + + def y_keys(book): + lo, hi = bounds(cover_points(book)) + yc = lo.y + book["t"] / 2.0 + return (lo.x + hi.x) / 2.0, (lo.y, yc, yc + PAGE_BACK, hi.y - SQUARE, hi.y) + + def set_down(book, k, x_left, support_top, seat_k=None): + lo, hi = bounds(cover_points(book)) + seat = SEAT_BASE + SEAT_STEP * (k if seat_k is None else seat_k) + move(book, Vector((x_left - lo.x, + y_front + SET_BASE + SET_STEP * (k % 7) - lo.y, + support_top - seat - lo.z))) + # Spine fronts, spine lines and fore-edges are planes facing Y. + # Two neighbours landing one on the same plane z-fight, so step + # this book back until none of its planes meets a neighbour's. + for _ in range(8): + cx, keys = y_keys(book) + near = [y_keys(o)[1] for o in placed if abs(y_keys(o)[0] - cx) < 0.12] + if not any(abs(a - b) < SET_CLEAR for ks in near for a in keys for b in ks): + break + move(book, Vector((0.0, SET_NUDGE, 0.0))) + + for ii, item in enumerate(row): + tag = item[0] + if tag == "gap": + cursor += item[1] + continue + if tag == "up": + # Upright books stand a degree or so off square, in a + # four-step cycle. Every spine has the same facet angles, so + # square neighbours share planes by accident whenever their + # offsets line up; a degree apart, no two faces are parallel. + yaw = math.radians(UPRIGHT_YAW[k % len(UPRIGHT_YAW)]) + b = make_book(sized(item[1:5], ii=ii), Matrix.Rotation(yaw, 4, "Z"), + loose_pages, float_bands) + set_down(b, k, cursor + gap_of(k), tops[s] + lift) + if pending is not None: + p0, n = lean_face(pending, 1) + pen = penetration(cover_points(b), p0, n) + move(b, Vector(((pen - bite) / n.x, 0.0, 0.0))) + b["lean_on"] = pending + pending = None + elif tag == "lean": + side, deg = item[5], item[6] + rot = Matrix.Rotation(side * math.radians(deg), 4, "Y") + b = make_book(sized(item[1:5], ii=ii), rot, loose_pages, float_bands) + set_down(b, k, cursor + gap_of(k), tops[s] + lift) + if side < 0: + nb = placed[-1] + p0, n = lean_face(b, -1) + pen = penetration(cover_points(nb), p0, n) + move(b, Vector(((bite - pen) / n.x, 0.0, 0.0))) + b["lean_on"] = nb + else: + pending = b + else: + stack_top = tops[s] + lift + centre = None + stack = [] + for j, dims in enumerate(item[1]): + yaw = STACK_YAW * (1.0 if j % 2 else -1.0) + rot = Matrix.Rotation(yaw, 4, "Z") @ Matrix.Rotation(-math.pi / 2.0, 4, "Y") + b = make_book(sized(dims, ii=ii, j=j), rot, loose_pages, float_bands) + lo, hi = bounds(cover_points(b)) + if centre is None: + centre = cursor + gap_of(k) + (hi.x - lo.x) / 2.0 + shift = STACK_SHIFT * (0.5 - frac(j * 0.7548776662 + 0.2)) * 2.0 + # A book stacked on a book takes a small seat of its own + # (1.0-1.4 mm), so its underside never lands on the plane + # of the page block 2.2 mm inside the board below it. + set_down(b, k, centre + shift - (hi.x - lo.x) / 2.0, stack_top, + seat_k=(j if j else None)) + stack_top = bounds(cover_points(b))[1].z + b.update({"shelf": s, "i": len(books)}) + books.append(b) + stack.append(b) + placed.append(b) + k += 1 + cursor = max(bounds(cover_points(x))[1].x for x in stack) + continue + b.update({"shelf": s, "i": len(books)}) + books.append(b) + placed.append(b) + cursor = bounds(cover_points(b))[1].x + k += 1 + return books + + +# --- construction ----------------------------------------------------------- + + +def add_board(bm, lo, hi, boards, sharp=False): + """Axis-aligned board from corner ``lo`` to ``hi``; its verts go in ``boards``.""" + geo = bmesh.ops.create_cube(bm, size=1.0) + c = [(lo[k] + hi[k]) * 0.5 for k in range(3)] + s = [hi[k] - lo[k] for k in range(3)] + for v in geo["verts"]: + v.co = Vector((c[0] + v.co.x * s[0], c[1] + v.co.y * s[1], c[2] + v.co.z * s[2])) + for f in {f for v in geo["verts"] for f in v.link_faces}: + f.material_index = WOOD_IDX + if not sharp: + boards.extend(geo["verts"]) + return geo["verts"] + + +def build_bookshelf_mesh( + name, + stray_vert=False, + float_side=False, + short_shelves=False, + sharp_shelf=False, + **book_flags, +): + x_out = W_OUT / 2.0 + x_in = x_out - SIDE_T + y0, y1 = -DEPTH / 2.0, DEPTH / 2.0 + top_z0 = SIDE_H - TOP_SEAT + top_z1 = top_z0 + TOP_T + back_y1 = y1 - BACK_INSET + back_y0 = back_y1 - BACK_T + bm = bmesh.new() + try: + uv = bm.loops.layers.uv.new("UVMap") + piece = bm.faces.layers.int.new("Piece") + boards = [] + # Sides: the two named supports. + for sx in (-1.0, 1.0): + lift = FLOAT_SIDE if (float_side and sx < 0) else 0.0 + add_board(bm, (min(sx * x_out, sx * x_in), y0, lift), + (max(sx * x_out, sx * x_in), y1, SIDE_H + lift), boards) + add_board(bm, (-x_out - TOP_OVER, y0 - TOP_OVER, top_z0), + (x_out + TOP_OVER, y1 + TOP_BACK_OVER, top_z1), boards) + # Cornice: a wider board seated on the top, stepping out past it. + # Its back stops short of the top's back, or the two share a plane. + add_board(bm, (-x_out - TOP_OVER - CORN_OVER, y0 - TOP_OVER - CORN_OVER, + top_z1 - CORN_BITE), + (x_out + TOP_OVER + CORN_OVER, y1 + TOP_BACK_OVER - CORN_BACK_IN, + top_z1 - CORN_BITE + CORN_T), boards) + # Back boards, housed into the sides and the top, standing in the + # base; lapped, every other one stepped forward so no lap is a plane. + span0, span1 = -x_in - BACK_BITE, x_in + BACK_BITE + bw = (span1 - span0 + BACK_LAP * (N_BACK - 1)) / N_BACK + for k in range(N_BACK): + bx = span0 + k * (bw - BACK_LAP) + step = BACK_STEP if k % 2 else 0.0 + add_board(bm, (bx, back_y0 - step, BASE_Z + BASE_T - BACK_BITE), + (bx + bw, back_y1 - step, top_z0 + BACK_BITE), boards) + # Cross members: plinth, base and shelves, each in a dado in both sides. + add_board(bm, (-(x_in + DADO), y0 + PLINTH_SET, PLINTH_Z0), + (x_in + DADO, y0 + PLINTH_SET + PLINTH_T, BASE_Z + PLINTH_BITE), boards) + add_board(bm, (-(x_in + DADO), y0 + BASE_SETBACK, BASE_Z), + (x_in + DADO, back_y0 + BACK_BITE, BASE_Z + BASE_T), boards) + reach = x_in - 0.004 if short_shelves else x_in + DADO + for s, zt in enumerate(SHELF_TOPS): + add_board(bm, (-reach, y0 + SHELF_SETBACK, zt - SHELF_T), + (reach, back_y0 + BACK_BITE, zt), boards, + sharp=(sharp_shelf and s == len(SHELF_TOPS) - 1)) + # A set of BMEdges iterates in address order: sort by index so the + # bevel emits its faces in the same order on every run. + bm.edges.index_update() + edges = sorted({e for v in boards for e in v.link_edges + if e.calc_face_angle(0.0) > math.radians(20.0)}, key=lambda e: e.index) + bmesh.ops.bevel(bm, geom=edges, offset=CHAMFER, segments=1, profile=0.5, + affect="EDGES", clamp_overlap=True, material=WOOD_IDX) + bmesh.ops.triangulate(bm, faces=[f for f in bm.faces if len(f.verts) > 4]) + + books = plan_books(**book_flags) + for b in books: + vs = [bm.verts.new(p) for p in b["world"]] + cover = LEATHER_IDX if b["kind"] == "l" else CLOTH_IDX + for idx, kind in b["faces"]: + f = bm.faces.new([vs[i] for i in idx]) + f.material_index = (cover, PAPER_IDX, GILT_IDX)[kind] + f[piece] = b["i"] + 1 + if stray_vert: + bm.verts.new((0.0, 0.0, 0.62)) + bmesh.ops.recalc_face_normals(bm, faces=list(bm.faces)) + for f in bm.faces: + f.smooth = True + for e in bm.edges: + if len(e.link_faces) == 2 and e.calc_face_angle(0.0) > math.radians(35.0): + e.smooth = False + pack_uvs(bm, uv) + me = bpy.data.meshes.new(name) + bm.to_mesh(me) + me.update() + finally: + bm.free() + paint_pieces(me, books) + obj = bpy.data.objects.new(name, me) + bpy.context.collection.objects.link(obj) + return obj + + +def pack_uvs(bm, uv, margin=0.06): + """One grid cell per face, projected on its dominant axis.""" + faces = list(bm.faces) + cols = max(1, math.ceil(math.sqrt(len(faces)))) + rows = max(1, math.ceil(len(faces) / cols)) + cw, ch = 1.0 / cols, 1.0 / rows + pu, pv = margin * cw * 0.5, margin * ch * 0.5 + for idx, face in enumerate(faces): + nrm = face.normal + ax, ay, az = abs(nrm.x), abs(nrm.y), abs(nrm.z) + pts = [] + for loop in face.loops: + co = loop.vert.co + if az >= ax and az >= ay: + pts.append((co.x, co.y)) + elif ax >= ay: + pts.append((co.y, co.z)) + else: + pts.append((co.x, co.z)) + minx, maxx = min(c[0] for c in pts), max(c[0] for c in pts) + miny, maxy = min(c[1] for c in pts), max(c[1] for c in pts) + dx, dy = max(maxx - minx, 1e-8), max(maxy - miny, 1e-8) + ou, ov = (idx % cols) * cw + pu, (idx // cols) * ch + pv + for loop, (x, y) in zip(face.loops, pts): + loop[uv].uv = (ou + (x - minx) / dx * (cw - 2 * pu), + ov + (y - miny) / dy * (ch - 2 * pv)) + + +def paint_pieces(me, books): + """Face attributes the shaders read: per-board tone and grain, per-book tint. + + Every carcass board gets a closed-form tone and its long axis as grain. + Every book gets a cloth or leather tint from its index, and its page + block the book's own thickness axis, so the page lines run parallel to + the boards however the book is turned. The ``Piece`` tag is then dropped. + """ + npoly = len(me.polygons) + piece = [0] * npoly + me.attributes["Piece"].data.foreach_get("value", piece) + mats = [0] * npoly + me.polygons.foreach_get("material_index", mats) + tone = [0.5] * npoly + grain = [(1.0, 0.0, 0.0)] * npoly + tint = [(0.5, 0.5, 0.5, 1.0)] * npoly + vf = [[] for _ in range(len(me.vertices))] + for p in me.polygons: + for i in p.vertices: + vf[i].append(p.index) + for k, g in enumerate(shells(me)): + faces = {fi for i in g for fi in vf[i]} + if not faces or mats[next(iter(faces))] != WOOD_IDX: + continue + pts = [me.vertices[i].co for i in g] + ext = [max(p[a] for p in pts) - min(p[a] for p in pts) for a in range(3)] + axis = ext.index(max(ext)) + d = tuple(1.0 if a == axis else 0.0 for a in range(3)) + t = 0.5 + 0.30 * (frac(k * 0.6180339887 + 0.3) - 0.5) + for fi in faces: + tone[fi] = t + grain[fi] = d + for fi in range(npoly): + v = piece[fi] - 1 + if v < 0: + continue + b = books[v] + if mats[fi] == LEATHER_IDX: + c = LEATHER_TINTS[int(frac(v * 0.6180339887 + 0.1) * len(LEATHER_TINTS))] + else: + c = CLOTH_TINTS[int(frac(v * 0.6180339887 + 0.4) * len(CLOTH_TINTS))] + tint[fi] = (c[0], c[1], c[2], 1.0) + tone[fi] = 0.5 + 0.3 * (frac(v * 0.4142135624) - 0.5) + ax = b["M"].to_3x3() @ Vector((1.0, 0.0, 0.0)) + grain[fi] = tuple(ax.normalized()) + me.attributes.remove(me.attributes["Piece"]) + a = me.attributes.new("PlankTone", "FLOAT", "FACE") + a.data.foreach_set("value", tone) + b = me.attributes.new("GrainDir", "FLOAT_VECTOR", "FACE") + b.data.foreach_set("vector", [c for v in grain for c in v]) + c = me.attributes.new("Tint", "FLOAT_COLOR", "FACE") + c.data.foreach_set("color", [x for v in tint for x in v]) + + +# --- surface ---------------------------------------------------------------- + + +def _sock(sockets, identifier): + return next(sk for sk in sockets if sk.identifier == identifier) + + +def wood_material(name): + """Stained timber: grain along each board, tone per board (copied from crate-stack).""" + mat = bpy.data.materials.new(name) + mat.use_nodes = True + nt = mat.node_tree + bsdf = nt.nodes["Principled BSDF"] + coord = nt.nodes.new("ShaderNodeTexCoord") + gdir = nt.nodes.new("ShaderNodeAttribute") + gdir.attribute_name = "GrainDir" + tone = nt.nodes.new("ShaderNodeAttribute") + tone.attribute_name = "PlankTone" + dot = nt.nodes.new("ShaderNodeVectorMath") + dot.operation = "DOT_PRODUCT" + nt.links.new(coord.outputs["Object"], dot.inputs[0]) + nt.links.new(gdir.outputs["Vector"], dot.inputs[1]) + squash = nt.nodes.new("ShaderNodeMath") + squash.operation = "MULTIPLY" + squash.inputs[1].default_value = 0.94 + nt.links.new(dot.outputs["Value"], squash.inputs[0]) + along = nt.nodes.new("ShaderNodeVectorMath") + along.operation = "SCALE" + nt.links.new(gdir.outputs["Vector"], along.inputs[0]) + nt.links.new(squash.outputs["Value"], along.inputs["Scale"]) + grain_co = nt.nodes.new("ShaderNodeVectorMath") + grain_co.operation = "SUBTRACT" + nt.links.new(coord.outputs["Object"], grain_co.inputs[0]) + nt.links.new(along.outputs["Vector"], grain_co.inputs[1]) + shift = nt.nodes.new("ShaderNodeVectorMath") + shift.operation = "ADD" + nt.links.new(grain_co.outputs["Vector"], shift.inputs[0]) + nt.links.new(tone.outputs["Fac"], shift.inputs[1]) + noise = nt.nodes.new("ShaderNodeTexNoise") + noise.inputs["Scale"].default_value = 34.0 + noise.inputs["Detail"].default_value = 6.0 + noise.inputs["Roughness"].default_value = 0.62 + nt.links.new(shift.outputs["Vector"], noise.inputs["Vector"]) + ramp = nt.nodes.new("ShaderNodeValToRGB") + ramp.color_ramp.elements[0].position = 0.30 + ramp.color_ramp.elements[0].color = (0.070, 0.031, 0.013, 1.0) + ramp.color_ramp.elements[1].position = 0.72 + ramp.color_ramp.elements[1].color = (0.21, 0.10, 0.042, 1.0) + nt.links.new(noise.outputs["Fac"], ramp.inputs["Fac"]) + gain = nt.nodes.new("ShaderNodeMath") + gain.operation = "MULTIPLY_ADD" + gain.inputs[1].default_value = 1.2 + gain.inputs[2].default_value = 0.40 + nt.links.new(tone.outputs["Fac"], gain.inputs[0]) + mix = nt.nodes.new("ShaderNodeMix") + mix.data_type = "RGBA" + mix.blend_type = "MULTIPLY" + _sock(mix.inputs, "Factor_Float").default_value = 1.0 + nt.links.new(ramp.outputs["Color"], _sock(mix.inputs, "A_Color")) + nt.links.new(gain.outputs["Value"], _sock(mix.inputs, "B_Color")) + nt.links.new(_sock(mix.outputs, "Result_Color"), bsdf.inputs["Base Color"]) + rough = nt.nodes.new("ShaderNodeMapRange") + rough.inputs["To Min"].default_value = 0.66 + rough.inputs["To Max"].default_value = 0.48 + nt.links.new(noise.outputs["Fac"], rough.inputs["Value"]) + nt.links.new(rough.outputs["Result"], bsdf.inputs["Roughness"]) + return mat + + +def cover_material(name, scale, low, roughness): + """A book cover: the per-book ``Tint``, broken up by a fine noise.""" + mat = bpy.data.materials.new(name) + mat.use_nodes = True + nt = mat.node_tree + bsdf = nt.nodes["Principled BSDF"] + attr = nt.nodes.new("ShaderNodeAttribute") + attr.attribute_name = "Tint" + tc = nt.nodes.new("ShaderNodeTexCoord") + noise = nt.nodes.new("ShaderNodeTexNoise") + noise.inputs["Scale"].default_value = scale + noise.inputs["Detail"].default_value = 8.0 + nt.links.new(tc.outputs["Object"], noise.inputs["Vector"]) + shade = nt.nodes.new("ShaderNodeMapRange") + shade.inputs["To Min"].default_value = low + shade.inputs["To Max"].default_value = 1.1 + nt.links.new(noise.outputs["Fac"], shade.inputs["Value"]) + mul = nt.nodes.new("ShaderNodeVectorMath") + mul.operation = "SCALE" + nt.links.new(attr.outputs["Color"], mul.inputs[0]) + nt.links.new(shade.outputs["Result"], mul.inputs["Scale"]) + nt.links.new(mul.outputs["Vector"], bsdf.inputs["Base Color"]) + rough = nt.nodes.new("ShaderNodeMapRange") + rough.inputs["To Min"].default_value = roughness + 0.08 + rough.inputs["To Max"].default_value = roughness - 0.08 + nt.links.new(noise.outputs["Fac"], rough.inputs["Value"]) + nt.links.new(rough.outputs["Result"], bsdf.inputs["Roughness"]) + return mat + + +def paper_material(name): + """Page edges: warm off-white with fine lines parallel to the boards.""" + mat = bpy.data.materials.new(name) + mat.use_nodes = True + nt = mat.node_tree + bsdf = nt.nodes["Principled BSDF"] + tc = nt.nodes.new("ShaderNodeTexCoord") + gdir = nt.nodes.new("ShaderNodeAttribute") + gdir.attribute_name = "GrainDir" + dot = nt.nodes.new("ShaderNodeVectorMath") + dot.operation = "DOT_PRODUCT" + nt.links.new(tc.outputs["Object"], dot.inputs[0]) + nt.links.new(gdir.outputs["Vector"], dot.inputs[1]) + across = nt.nodes.new("ShaderNodeCombineXYZ") + nt.links.new(dot.outputs["Value"], across.inputs["X"]) + lines = nt.nodes.new("ShaderNodeTexNoise") + lines.inputs["Scale"].default_value = 900.0 + lines.inputs["Detail"].default_value = 2.0 + nt.links.new(across.outputs["Vector"], lines.inputs["Vector"]) + ramp = nt.nodes.new("ShaderNodeValToRGB") + ramp.color_ramp.elements[0].position = 0.30 + ramp.color_ramp.elements[0].color = (0.40, 0.34, 0.24, 1.0) + ramp.color_ramp.elements[1].position = 0.70 + ramp.color_ramp.elements[1].color = (0.68, 0.61, 0.47, 1.0) + nt.links.new(lines.outputs["Fac"], ramp.inputs["Fac"]) + nt.links.new(ramp.outputs["Color"], bsdf.inputs["Base Color"]) + bsdf.inputs["Roughness"].default_value = 0.88 + return mat + + +def gilt_material(name): + """Gold leaf tooling: warm, metallic, a little worn by the noise.""" + mat = bpy.data.materials.new(name) + mat.use_nodes = True + nt = mat.node_tree + bsdf = nt.nodes["Principled BSDF"] + tc = nt.nodes.new("ShaderNodeTexCoord") + noise = nt.nodes.new("ShaderNodeTexNoise") + noise.inputs["Scale"].default_value = 300.0 + noise.inputs["Detail"].default_value = 4.0 + nt.links.new(tc.outputs["Object"], noise.inputs["Vector"]) + ramp = nt.nodes.new("ShaderNodeValToRGB") + ramp.color_ramp.elements[0].position = 0.35 + ramp.color_ramp.elements[0].color = (0.36, 0.23, 0.07, 1.0) + ramp.color_ramp.elements[1].position = 0.65 + ramp.color_ramp.elements[1].color = (0.80, 0.56, 0.20, 1.0) + nt.links.new(noise.outputs["Fac"], ramp.inputs["Fac"]) + nt.links.new(ramp.outputs["Color"], bsdf.inputs["Base Color"]) + # Half metallic and fairly rough: a fully metallic band on a spine facing + # the camera mirrors the dark stage and reads black. + bsdf.inputs["Metallic"].default_value = 0.55 + bsdf.inputs["Roughness"].default_value = 0.45 + return mat + + +def bookshelf_materials(): + return ( + wood_material("BookshelfWood"), + cover_material("BookCloth", 420.0, 0.78, 0.86), + cover_material("BookLeather", 70.0, 0.62, 0.48), + paper_material("BookPages"), + gilt_material("BookGilt"), + ) + + +def assign_slots(obj, mats): + slots = obj.data.materials + for i, mat in enumerate(mats): + if i < len(slots): + slots[i] = mat + else: + slots.append(mat) + + +# --- measurement ------------------------------------------------------------ + + +def world_bbox(obj): + corners = [obj.matrix_world @ Vector(c) for c in obj.bound_box] + xs, ys, zs = [c.x for c in corners], [c.y for c in corners], [c.z for c in corners] + return (min(xs), min(ys), min(zs), max(xs), max(ys), max(zs)) + + +def uv_stats(mesh): + uv = mesh.uv_layers.active + if uv is None: + return 0.0, 0.0, 1.0, 1.0, 0.0, 0 + data = uv.data + us = [loop.uv[0] for loop in data] + vs = [loop.uv[1] for loop in data] + aabbs = [] + for poly in mesh.polygons: + pu = [data[i].uv[0] for i in poly.loop_indices] + pv = [data[i].uv[1] for i in poly.loop_indices] + aabbs.append((min(pu), min(pv), max(pu), max(pv))) + span = max(1e-6, max(a[2] - a[0] for a in aabbs), max(a[3] - a[1] for a in aabbs)) + buckets = {} + for i, a in enumerate(aabbs): + for c in range(int(a[0] // span), int(a[2] // span) + 1): + for r in range(int(a[1] // span), int(a[3] // span) + 1): + buckets.setdefault((c, r), []).append(i) + overlap = 0.0 + seen = set() + for members in buckets.values(): + for ii in range(len(members)): + for jj in range(ii + 1, len(members)): + i, j = members[ii], members[jj] + key = (i, j) if i < j else (j, i) + if key in seen: + continue + seen.add(key) + a, b = aabbs[i], aabbs[j] + overlap += max(0.0, min(a[2], b[2]) - max(a[0], b[0])) * max( + 0.0, min(a[3], b[3]) - max(a[1], b[1])) + return min(us), min(vs), max(us), max(vs), overlap, len(aabbs) + + +def face_area(me, poly): + idxs = poly.vertices + v0 = me.vertices[idxs[0]].co + area = 0.0 + for i in range(1, len(idxs) - 1): + area += (me.vertices[idxs[i]].co - v0).cross(me.vertices[idxs[i + 1]].co - v0).length * 0.5 + return area + + +def hygiene_audit(me): + ngons = sum(1 for p in me.polygons if len(p.vertices) > 4) + zero_area = sum(1 for p in me.polygons if face_area(me, p) <= AREA_EPS) + bm = bmesh.new() + try: + bm.from_mesh(me) + loose_v = sum(1 for v in bm.verts if len(v.link_edges) == 0) + loose_e = sum(1 for e in bm.edges if len(e.link_faces) == 0) + nonman = sum(1 for e in bm.edges if not e.is_manifold) + ret = bmesh.ops.find_doubles(bm, verts=list(bm.verts), dist=DOUBLES_EPS) + doubles = len(ret.get("targetmap") or {}) + finally: + bm.free() + return {"ngons": ngons, "loose_v": loose_v, "loose_e": loose_e, + "nonman": nonman, "zero_area": zero_area, "doubles": doubles} + + +def shells(me): + neighbors = [[] for _ in range(len(me.vertices))] + for edge in me.edges: + a, b = edge.vertices + neighbors[a].append(b) + neighbors[b].append(a) + seen = [False] * len(me.vertices) + groups = [] + for start in range(len(me.vertices)): + if seen[start]: + continue + seen[start] = True + stack = [start] + group = [] + while stack: + cur = stack.pop() + group.append(cur) + for nxt in neighbors[cur]: + if not seen[nxt]: + seen[nxt] = True + stack.append(nxt) + groups.append(group) + return groups + + +def zfight_pairs(me): + """Coplanar face pairs from *different shells* (copied from showcase/grindstone).""" + owner = {} + for si, g in enumerate(shells(me)): + for vi in g: + owner[vi] = si + faces = [(p.normal.copy(), p.center.copy(), owner.get(p.vertices[0], -1)) + for p in me.polygons] + kd = KDTree(len(faces)) + for i, (_n, c, _s) in enumerate(faces): + kd.insert(c, i) + kd.balance() + hits = 0 + for i, (ni, ci, si) in enumerate(faces): + for _co, j, _d in kd.find_range(ci, COPLANAR_CENTRE_MAX): + if j <= i: + continue + nj, cj, sj = faces[j] + if si == sj: + continue + if abs(abs(ni.dot(nj)) - 1.0) > COPLANAR_NORMAL_EPS: + continue + if abs(ni.dot(cj - ci)) > COPLANAR_PLANE_EPS: + continue + hits += 1 + return hits + + +def right_angle_edges(me): + """Manifold edges between two wood faces that meet within 5 degrees of 90.""" + count = 0 + bm = bmesh.new() + try: + bm.from_mesh(me) + for e in bm.edges: + if len(e.link_faces) != 2: + continue + if any(f.material_index != WOOD_IDX for f in e.link_faces): + continue + if abs(e.calc_face_angle(0.0) - math.pi / 2.0) <= RIGHT_ANGLE_TOL: + count += 1 + finally: + bm.free() + return count + + +def shell_tree(me, groups): + member = set(i for g in groups for i in g) + order = sorted(member) + remap = {v: k for k, v in enumerate(order)} + polys = [[remap[i] for i in p.vertices] for p in me.polygons if p.vertices[0] in member] + return BVHTree.FromPolygons([me.vertices[i].co.copy() for i in order], polys) + + +def depth_in(tree, p, reach=1.0): + """Signed depth of ``p`` inside the shell ``tree``: positive inside, negative outside.""" + hit = tree.find_nearest(p, reach) + if hit[0] is None: + return -reach + loc, nrm, _i, dist = hit + return dist if (p - loc).dot(nrm) < 0.0 else -dist + + +def classify(me): + """Split the finished mesh into named parts by material and shape.""" + mats = {} + for p in me.polygons: + for i in p.vertices: + mats.setdefault(i, p.material_index) + groups = shells(me) + owner = {} + for si, g in enumerate(groups): + for i in g: + owner[i] = si + big, polys = {}, {} + for p in me.polygons: + si = owner[p.vertices[0]] + polys.setdefault(si, []).append(p) + if si not in big or p.area > big[si].area: + big[si] = p + out = {k: [] for k in ("side", "top", "cornice", "back", "cross", "cover", "pages", + "band", "other")} + for si, g in enumerate(groups): + pts = [me.vertices[i].co.copy() for i in g] + lo = Vector((min(p.x for p in pts), min(p.y for p in pts), min(p.z for p in pts))) + hi = Vector((max(p.x for p in pts), max(p.y for p in pts), max(p.z for p in pts))) + ext = hi - lo + rec = {"g": g, "pts": pts, "lo": lo, "hi": hi, "ext": ext, + "c": sum(pts, Vector()) / len(pts)} + m = mats.get(g[0], -1) + if m == WOOD_IDX: + if ext.x < 0.05 and ext.z > 0.9: + out["side"].append(rec) + elif ext.y < 0.03 and ext.z > 0.9: + out["back"].append(rec) + elif lo.z > SIDE_H: + out["cornice"].append(rec) + elif hi.z > SIDE_H: + out["top"].append(rec) + elif ext.x > 0.7: + out["cross"].append(rec) + else: + out["other"].append(rec) + elif m in (CLOTH_IDX, LEATHER_IDX): + face = big[si] + rec["n"] = face.normal.copy() + # The two boards' outer faces: the largest faces, one per side. + ranked = sorted(polys[si], key=lambda p: -p.area)[:4] + rec["boards"] = [(p.center.copy(), p.normal.copy()) for p in ranked + if abs(abs(p.normal.dot(face.normal)) - 1.0) < 1e-3] + rec["face_len"] = max((me.vertices[face.vertices[k]].co + - me.vertices[face.vertices[k - 1]].co).length + for k in range(len(face.vertices))) + out["cover"].append(rec) + elif m == PAPER_IDX: + out["pages"].append(rec) + elif m == GILT_IDX: + out["band"].append(rec) + else: + out["other"].append(rec) + return out + + +def overlaps_xy(a, b, pad=0.0): + return (a["lo"].x - pad < b["hi"].x and b["lo"].x - pad < a["hi"].x + and a["lo"].y - pad < b["hi"].y and b["lo"].y - pad < a["hi"].y) + + +def bookshelf_audit(me): + parts = classify(me) + out = {k: len(v) for k, v in parts.items()} + sides = sorted(parts["side"], key=lambda r: r["c"].x) + out["side_z"] = max((r["lo"].z for r in sides), default=99.0) + + # Every cross member is housed in both sides: bite past the inner face, + # and clear of the far face. + bite, far = 99.0, 99.0 + if len(sides) == 2: + left_in, left_out = sides[0]["hi"].x, sides[0]["lo"].x + right_in, right_out = sides[1]["lo"].x, sides[1]["hi"].x + for r in parts["cross"]: + bite = min(bite, left_in - r["lo"].x, r["hi"].x - right_in) + far = min(far, r["lo"].x - left_out, right_out - r["hi"].x) + out["dado"], out["dado_far"] = bite, far + + # Books: each cover with the page block and bands nearest it. + covers = parts["cover"] + trees = [shell_tree(me, [c["g"]]) for c in covers] + units = [{"cover": c, "tree": t, "pages": [], "band": []} for c, t in zip(covers, trees)] + for kind in ("pages", "band"): + for r in parts[kind]: + # The cover every vertex of the part sits closest to, on average: + # a page block's corners are in its own boards, a band on its own + # spine. A centroid alone is nearer a neighbour's board in a stack. + if units: + u = min(units, key=lambda u: sum(u["tree"].find_nearest(p)[3] + for p in r["pts"]) / len(r["pts"])) + u[kind].append(r) + out["units"] = len(units) + out["unmatched"] = sum(1 for u in units if len(u["pages"]) != 1 or len(u["band"]) != 2) + + # Pages glued in: every page-block corner inside the cover's boards. + page_d = [depth_in(u["tree"], p) for u in units for r in u["pages"] for p in r["pts"]] + out["page_bite"] = (min(page_d, default=-99.0), max(page_d, default=99.0)) + + # Bands on the spine: inner face inside the cover, outer face proud. + b_in, b_out = [], [] + for u in units: + for r in u["band"]: + ds = sorted(depth_in(u["tree"], p) for p in r["pts"]) + half = len(ds) // 2 + b_in.extend(ds[half:]) + b_out.append(-max(ds[:half])) + out["band_bite"] = (min(b_in, default=-99.0), max(b_in, default=99.0)) + out["band_proud"] = min(b_out, default=-99.0) + + # Pose of each book from its largest face, a board: upright, lying or leaning. + for u in units: + c = u["cover"] + n = c["n"] + tilt = math.asin(min(1.0, abs(n.z))) + c["pose"] = ("up" if tilt <= UPRIGHT_TILT_MAX else + "lying" if tilt >= LYING_TILT_MIN else "lean") + c["tilt"] = tilt + ds = [p.dot(n) for p in c["pts"]] + c["thick"] = max(ds) - min(ds) + out["n_lean"] = sum(1 for u in units if u["cover"]["pose"] == "lean") + out["n_lying"] = sum(1 for u in units if u["cover"]["pose"] == "lying") + + # Seat: what each book stands on is the highest shelf or cover under its + # footprint whose top is within reach of its lowest point. + shelves = [r for r in parts["cross"] if r["ext"].y > 0.15] + horizontals = shelves + parts["top"] + seats = [] + for u in units: + c = u["cover"] + cands = [r for r in shelves + covers if r is not c and overlaps_xy(r, c) + and c["lo"].z - 0.02 <= r["hi"].z <= c["lo"].z + 0.01] + if cands: + u["support"] = max(cands, key=lambda r: r["hi"].z) + seats.append(u["support"]["hi"].z - c["lo"].z) + out["seat"] = (min(seats, default=-99.0), max(seats, default=99.0)) + out["n_seated"] = len(seats) + + # Headroom: the top of each book (bands included) under the member above. + heads = [] + for u in units: + c = u["cover"] + top = max([c["hi"].z] + [r["hi"].z for r in u["band"]]) + above = [h for h in horizontals if h["lo"].z > c["lo"].z + 0.05] + if above: + heads.append(min(h["lo"].z for h in above) - top) + out["headroom"] = min(heads, default=-99.0) + + # Size spread: thickness across the boards, height along the board face. + th = [u["cover"]["thick"] for u in units] + hs = [u["cover"]["face_len"] for u in units] + out["thick_spread"] = max(th) / min(th) if th else 0.0 + out["height_spread"] = max(hs) / min(hs) if hs else 0.0 + + # Lean contact: the neighbour's head edge in the leaning board, as a band. + leans = [] + for u in units: + c = u["cover"] + if c["pose"] != "lean": + continue + n = c["n"] if c["n"].x > 0 else -c["n"] + up_x = -n.z # the board's up direction, in the XZ plane, has this x + side = 1.0 if up_x > 0 else -1.0 + sup = u.get("support") + mates = [v for v in units if v["cover"]["pose"] == "up" and v.get("support") is sup + and (v["cover"]["c"].x - c["c"].x) * side > 0] + if not mates: + leans.append(-99.0) + continue + mate = min(mates, key=lambda v: abs(v["cover"]["c"].x - c["c"].x)) + u["lean_on"] = mate + # Depth past the plane of the leaning board's outer face, read off the + # mesh, over the neighbour's vertices near that board. A plane, not + # the cover solid: the board is 2.8 mm thick, and a head edge driven + # right through it is in the hollow, outside the cover again. + to_mate = mate["cover"]["c"] - c["c"] + facing = [b for b in c["boards"] if b[1].dot(to_mate) > 0.0] + if not facing: + leans.append(-99.0) + continue + p0, n = max(facing, key=lambda b: b[0].dot(b[1])) + ds = [-(p - p0).dot(n) for p in mate["cover"]["pts"] + if u["tree"].find_nearest(p, LEAN_SEARCH)[0] is not None] + leans.append(max(ds, default=-99.0)) + out["lean"] = (min(leans, default=-99.0), max(leans, default=99.0)) + + # Books do not run into one another, nor into the carcass, except where + # they are meant to: a book on the one it is stacked on, a leaning book + # on its neighbour, a book in the shelf it stands on. + utrees = [shell_tree(me, [u["cover"]["g"]] + [r["g"] for r in u["pages"] + u["band"]]) + for u in units] + carcass = [r for k in ("side", "back", "cross", "top", "cornice") for r in parts[k]] + ctrees = [shell_tree(me, [r["g"]]) for r in carcass] + designed = set() + for i, u in enumerate(units): + for j, v in enumerate(units): + if u.get("support") is v["cover"] or u.get("lean_on") is v: + designed.add((min(i, j), max(i, j))) + hits, where = 0, [] + for i in range(len(units)): + for j in range(i + 1, len(units)): + if (i, j) in designed: + continue + if utrees[i].overlap(utrees[j]): + hits += 1 + where.append((units[i]["cover"]["c"], units[j]["cover"]["c"])) + for r, ct in zip(carcass, ctrees): + if r is units[i].get("support"): + continue + if utrees[i].overlap(ct): + hits += 1 + where.append((units[i]["cover"]["c"], r["c"])) + out["book_hits"] = hits + out["hit_at"] = where + return out + + +def make_lod(obj, name, ratio, skip_decimate): + mesh = obj.data.copy() + lod = bpy.data.objects.new(name, mesh) + lod.matrix_world = obj.matrix_world.copy() + bpy.context.scene.collection.objects.link(lod) + if not skip_decimate and 0.0 < ratio < 1.0: + mod = lod.modifiers.new("DecimateBudget", "DECIMATE") + mod.decimate_type = "COLLAPSE" + mod.ratio = ratio + return lod + + +def hull_collider(obj, name): + """One convex hull over the carcass; the books sit inside it.""" + me = obj.data + mats = {} + for p in me.polygons: + for i in p.vertices: + mats.setdefault(i, p.material_index) + pts = [me.vertices[i].co.copy() for i in range(len(me.vertices)) if mats.get(i) == WOOD_IDX] + mesh = bpy.data.meshes.new(name) + bm = bmesh.new() + try: + vs = [bm.verts.new(p) for p in pts] + ret = bmesh.ops.convex_hull(bm, input=vs) + drop = [] + for v in ret["geom_interior"] + ret["geom_unused"]: + if isinstance(v, bmesh.types.BMVert) and v not in drop: + drop.append(v) + bmesh.ops.delete(bm, geom=drop, context="VERTS") + bmesh.ops.dissolve_limit(bm, angle_limit=math.radians(1.0), + verts=list(bm.verts), edges=list(bm.edges)) + bmesh.ops.triangulate(bm, faces=list(bm.faces)) + bm.to_mesh(mesh) + mesh.update() + finally: + bm.free() + col = bpy.data.objects.new(name, mesh) + bpy.context.collection.objects.link(col) + return col + + +def setup_bake_image(obj, target_mat, size): + img = bpy.data.images.new("BookshelfNrm", size, size, alpha=True, float_buffer=False) + img.colorspace_settings.name = "Non-Color" + nodes = target_mat.node_tree.nodes + tex = nodes.new("ShaderNodeTexImage") + tex.image = img + nodes.active = tex + tex.select = True + obj.active_material_index = WOOD_IDX + return img, tex + + +def bake_normal(high, low): + scene = bpy.context.scene + scene.render.engine = "CYCLES" + scene.cycles.device = "CPU" + scene.cycles.samples = 1 + scene.cycles.use_denoising = False + for ob in bpy.context.view_layer.objects: + ob.select_set(False) + high.select_set(True) + low.select_set(True) + bpy.context.view_layer.objects.active = low + return bpy.ops.object.bake( + type="NORMAL", use_selected_to_active=True, cage_extrusion=CAGE_EXTRUSION, + use_cage=False, normal_space="TANGENT", margin=4, + margin_type="ADJACENT_FACES", use_clear=True, target="IMAGE_TEXTURES", + ) + + +def export_unity(path, objects): + for ob in bpy.context.view_layer.objects: + ob.select_set(False) + for ob in objects: + ob.select_set(True) + bpy.context.view_layer.objects.active = objects[0] + bpy.ops.export_scene.gltf( + filepath=path, use_selection=True, export_yup=True, export_apply=True, + export_draco_mesh_compression_enable=False, export_animations=False, + ) + + +def check(skip_decimate, lift_z=False, **flags): + bpy.ops.wm.read_factory_settings(use_empty=True) + nothing = (None,) * 5 + low = build_bookshelf_mesh("BookshelfLow", **flags) + hi_flags = {k: v for k, v in flags.items() if k != "stray_vert"} + high = build_bookshelf_mesh("BookshelfHigh", **hi_flags) + mats = bookshelf_materials() + assign_slots(low, mats) + assign_slots(high, mats) + if lift_z: + for v in low.data.vertices: + v.co.z += LIFT_Z + low.data.update() + bpy.context.view_layer.update() + if len(low.data.polygons) < 6 or not low.data.uv_layers: + return (fail("bookshelf mesh did not build, or has no UV layer", 3),) + nothing + + base_tris = triangle_count(low.data) + slots = [s for s in low.data.materials if s is not None] + nmat, distinct = len(slots), len({id(s) for s in slots}) + idx_counts = {} + for poly in low.data.polygons: + idx_counts[poly.material_index] = idx_counts.get(poly.material_index, 0) + 1 + u0, v0, u1, v1, overlap, nfaces = uv_stats(low.data) + bb = world_bbox(low) + size_x, size_y, size_z = bb[3] - bb[0], bb[4] - bb[1], bb[5] - bb[2] + + img, tex = setup_bake_image(low, mats[WOOD_IDX], BAKE_RES) + bake_result = bake_normal(high, low) + + lod1 = make_lod(low, "BookshelfLOD1", LOD1_TARGET, skip_decimate) + lod2 = make_lod(low, "BookshelfLOD2", LOD2_TARGET, skip_decimate) + bpy.context.view_layer.update() + lod1_tris = evaluated_triangle_count(lod1) + lod2_tris = evaluated_triangle_count(lod2) + r1 = lod1_tris / base_tris if base_tris else 0.0 + r2 = lod2_tris / base_tris if base_tris else 0.0 + + collider = hull_collider(high, "BookshelfCollider") + col_tris = triangle_count(collider.data) + + export_path = os.path.join(tempfile.gettempdir(), f"bdt_bookshelf_{os.getpid()}.glb") + if os.path.exists(export_path): + os.remove(export_path) + export_unity(export_path, [low, collider]) + export_size = os.path.getsize(export_path) if os.path.isfile(export_path) else 0 + # Blender points TMPDIR at its own temp preference, which on a portable + # build is the working directory, so the export must not outlive this. + if os.path.isfile(export_path): + os.remove(export_path) + + hyg = hygiene_audit(low.data) + zf = zfight_pairs(low.data) + sa = bookshelf_audit(low.data) + right = right_angle_edges(low.data) + + print(f"blender={tuple(bpy.app.version)} skip_decimate={skip_decimate}") + print(f"measured mat_index_counts={dict(sorted(idx_counts.items()))}") + print(f"measured base_tris={base_tris} lod1_tris={lod1_tris} " + f"lod2_tris={lod2_tris} r1={r1:.4f} r2={r2:.4f}") + print(f"measured nmat={nmat} uv=({u0:.4f},{v0:.4f})-({u1:.4f},{v1:.4f}) " + f"overlap={overlap:.6f} nfaces={nfaces}") + print(f"measured bbox=({size_x:.4f},{size_y:.4f},{size_z:.4f}) " + f"outer={OUTER_SIZE} zmin={bb[2]:.5f}") + print(f"measured collider_tris={col_tris} bake={bake_result} " + f"bake_has_data={img.has_data} export_bytes={export_size}") + print(f"measured hygiene loose_v={hyg['loose_v']} loose_e={hyg['loose_e']} " + f"nonman={hyg['nonman']} zero_area={hyg['zero_area']} " + f"doubles={hyg['doubles']} ngons={hyg['ngons']} zfight={zf}") + print(f"measured parts sides={sa['side']} top={sa['top']} cornice={sa['cornice']} " + f"back={sa['back']} cross={sa['cross']} covers={sa['cover']} pages={sa['pages']} " + f"bands={sa['band']} other={sa['other']} unmatched={sa['unmatched']} " + f"lean={sa['n_lean']} lying={sa['n_lying']} side_z={sa['side_z']:.5f}") + print(f"measured joints dado={sa['dado']:.5f} dado_far={sa['dado_far']:.5f} " + f"page_bite=({sa['page_bite'][0]:.5f},{sa['page_bite'][1]:.5f})") + print(f"measured seats book=({sa['seat'][0]:.5f},{sa['seat'][1]:.5f}) n={sa['n_seated']} " + f"band_bite=({sa['band_bite'][0]:.5f},{sa['band_bite'][1]:.5f}) " + f"band_proud={sa['band_proud']:.5f}") + print(f"measured headroom={sa['headroom']:.5f} thick_spread={sa['thick_spread']:.3f} " + f"height_spread={sa['height_spread']:.3f} " + f"lean=({sa['lean'][0]:.5f},{sa['lean'][1]:.5f}) book_hits={sa['book_hits']} " + f"right_angle_wood={right}") + + if not (BASE_TRIS_MIN <= base_tris <= BASE_TRIS_MAX): + return (fail(f"base tris {base_tris} not in [{BASE_TRIS_MIN}, {BASE_TRIS_MAX}]", 4),) + nothing + if nmat != MATERIAL_COUNT or distinct != MATERIAL_COUNT: + return (fail(f"material slots {nmat} distinct {distinct} != {MATERIAL_COUNT}", 5),) + nothing + for idx, floor in FACE_FLOORS.items(): + if idx_counts.get(idx, 0) < floor: + return (fail(f"material {idx} faces {idx_counts.get(idx, 0)} < {floor}", 5),) + nothing + if u0 < -UV_EPS or v0 < -UV_EPS or u1 > 1.0 + UV_EPS or v1 > 1.0 + UV_EPS: + return (fail(f"UVs outside 0..1: ({u0:.4f},{v0:.4f})-({u1:.4f},{v1:.4f})", 6),) + nothing + if overlap > UV_OVERLAP_MAX: + return (fail(f"UV AABB overlap {overlap:.6f} > {UV_OVERLAP_MAX}", 7),) + nothing + if (abs(size_x - OUTER_SIZE[0]) > BBOX_TOL or abs(size_y - OUTER_SIZE[1]) > BBOX_TOL + or abs(size_z - OUTER_SIZE[2]) > BBOX_TOL): + return (fail(f"bbox ({size_x:.4f},{size_y:.4f},{size_z:.4f}) off outer {OUTER_SIZE}", 8),) + nothing + if not (LOD1_RATIO_MIN <= r1 <= LOD1_RATIO_MAX): + return (fail(f"LOD1 ratio {r1:.4f} not in [{LOD1_RATIO_MIN}, {LOD1_RATIO_MAX}] " + "(--skip-decimate is the designed fail)", 9),) + nothing + if not (LOD2_RATIO_MIN <= r2 <= LOD2_RATIO_MAX): + return (fail(f"LOD2 ratio {r2:.4f} not in [{LOD2_RATIO_MIN}, {LOD2_RATIO_MAX}]", 9),) + nothing + if col_tris > COLLIDER_TRIS_MAX: + return (fail(f"collider tris {col_tris} > {COLLIDER_TRIS_MAX}", 11),) + nothing + if bake_result != {"FINISHED"} or not img.has_data: + return (fail(f"bake failed result={bake_result} has_data={img.has_data}", 12),) + nothing + if export_size <= 0: + return (fail("export file missing or empty", 13),) + nothing + if (hyg["loose_v"] or hyg["loose_e"] or hyg["nonman"] or hyg["zero_area"] + or hyg["doubles"] or hyg["ngons"] or zf): + return (fail(f"hygiene {hyg} zfight={zf} (--stray-vert is the designed fail)", 15),) + nothing + if abs(bb[2]) > ZMIN_EPS: + return (fail(f"zmin {bb[2]:.6f} not within {ZMIN_EPS} of 0 " + "(--lift-z is the designed fail)", 16),) + nothing + if sa["side"] != 2 or sa["side_z"] > SIDE_Z_MAX: + return (fail(f"sides: {sa['side']} of 2, worst side z={sa['side_z']:.5f} > {SIDE_Z_MAX} " + "(--float-side is the designed fail)", 16),) + nothing + if sa["cross"] != N_CROSS or sa["dado"] < DADO_MIN or sa["dado_far"] < DADO_FAR_MIN: + return (fail(f"{sa['cross']} of {N_CROSS} cross members, dado bite {sa['dado']:.5f} " + f"(min {DADO_MIN}), far face {sa['dado_far']:.5f} (min {DADO_FAR_MIN}) " + "(--short-shelves is the designed fail)", 17),) + nothing + if (sa["units"] != N_BOOKS or sa["unmatched"] or sa["page_bite"][0] < PAGE_BITE_MIN + or sa["page_bite"][1] > PAGE_BITE_MAX): + return (fail(f"{sa['units']} of {N_BOOKS} books, {sa['unmatched']} without one page " + f"block and two bands, page bite {sa['page_bite']} outside " + f"[{PAGE_BITE_MIN}, {PAGE_BITE_MAX}] (--loose-pages is the designed fail)", + 17),) + nothing + if sa["n_seated"] != N_BOOKS or sa["seat"][0] < SEAT_MIN or sa["seat"][1] > SEAT_MAX: + return (fail(f"{sa['n_seated']} of {N_BOOKS} books seated, seat {sa['seat']} outside " + f"[{SEAT_MIN}, {SEAT_MAX}] (--float-books is the designed fail)", 18),) + nothing + if (sa["band_bite"][0] < BAND_BITE_MIN or sa["band_bite"][1] > BAND_BITE_MAX + or sa["band_proud"] < BAND_PROUD_MIN): + return (fail(f"band bite {sa['band_bite']} outside [{BAND_BITE_MIN}, {BAND_BITE_MAX}] " + f"or proud {sa['band_proud']:.5f} < {BAND_PROUD_MIN} " + "(--float-bands is the designed fail)", 18),) + nothing + if sa["headroom"] < HEADROOM_MIN: + return (fail(f"headroom {sa['headroom']:.5f} < {HEADROOM_MIN} " + "(--tall-book is the designed fail)", 20),) + nothing + if sa["thick_spread"] < THICK_SPREAD_MIN or sa["height_spread"] < HEIGHT_SPREAD_MIN: + return (fail(f"book spread thickness {sa['thick_spread']:.3f} (min {THICK_SPREAD_MIN}), " + f"height {sa['height_spread']:.3f} (min {HEIGHT_SPREAD_MIN}) " + "(--uniform-books is the designed fail)", 21),) + nothing + if (sa["n_lean"] != N_LEAN or sa["n_lying"] != N_LYING + or sa["lean"][0] < LEAN_BITE_MIN or sa["lean"][1] > LEAN_BITE_MAX): + return (fail(f"{sa['n_lean']} of {N_LEAN} leaning and {sa['n_lying']} of {N_LYING} lying " + f"books, lean contact {sa['lean']} outside [{LEAN_BITE_MIN}, {LEAN_BITE_MAX}] " + "(--air-lean and --deep-lean are the designed fails)", 22),) + nothing + if sa["book_hits"]: + return (fail(f"{sa['book_hits']} book overlaps, need 0 " + "(--crowd-books is the designed fail)", 23),) + nothing + if right: + return (fail(f"{right} right-angle wood edges, need 0 " + "(--sharp-shelf is the designed fail)", 24),) + nothing + return 0, low, high, mats, tex, collider + + +def wire_normal(mat, tex): + nt = mat.node_tree + nrm = nt.nodes.new("ShaderNodeNormalMap") + nt.links.new(tex.outputs["Color"], nrm.inputs["Color"]) + nt.links.new(nrm.outputs["Normal"], nt.nodes["Principled BSDF"].inputs["Normal"]) + + +def render_still(low, mats, tex, path, engine): + scene = bpy.context.scene + wire_normal(mats[WOOD_IDX], tex) + for ob in list(scene.objects): + if ob.type == "MESH" and ob != low: + ob.hide_render = True + ob.hide_viewport = True + # Level on the floor: turned about Z only. + low.rotation_euler.z = math.radians(-14.0) + + floor_me = bpy.data.meshes.new("Floor") + bm = bmesh.new() + try: + bmesh.ops.create_grid(bm, x_segments=1, y_segments=1, size=60.0) + bm.to_mesh(floor_me) + finally: + bm.free() + fmat = bpy.data.materials.new("Floor") + fmat.use_nodes = True + fb = fmat.node_tree.nodes["Principled BSDF"] + fb.inputs["Base Color"].default_value = (0.03, 0.032, 0.037, 1.0) + fb.inputs["Roughness"].default_value = 0.7 + floor_me.materials.append(fmat) + floor = bpy.data.objects.new("Floor", floor_me) + scene.collection.objects.link(floor) + wall = bpy.data.objects.new("Wall", floor_me.copy()) + wall.location = (0.0, 8.5, 0.0) + wall.rotation_euler = (math.radians(90), 0.0, 0.0) + scene.collection.objects.link(wall) + + world = bpy.data.worlds.new("World") + world.use_nodes = True + world.node_tree.nodes["Background"].inputs["Color"].default_value = (0.02, 0.021, 0.025, 1.0) + scene.world = world + + def light(name, kind, loc, energy, size, col, rot=(0, 0, 0)): + ld = bpy.data.lights.new(name, kind) + ld.energy = energy + if kind == "AREA": + ld.size = size + else: + ld.shadow_soft_size = size + ld.color = col + ob = bpy.data.objects.new(name, ld) + ob.location = loc + ob.rotation_euler = tuple(math.radians(a) for a in rot) + scene.collection.objects.link(ob) + + light("Key", "AREA", (-2.4, -3.4, 3.2), 480.0, 3.0, (1.0, 0.95, 0.88), (50, 0, -35)) + light("Fill", "AREA", (3.2, -2.8, 1.6), 80.0, 5.0, (0.74, 0.84, 1.0), (68, 0, 48)) + light("Rim", "AREA", (-1.8, 2.6, 2.6), 220.0, 3.0, (0.62, 0.78, 1.0), (-55, 0, 200)) + ld = bpy.data.lights.new("Wedge", "SPOT") + ld.energy, ld.color = 260.0, (1.0, 0.66, 0.34) + ld.spot_size, ld.spot_blend, ld.shadow_soft_size = math.radians(50.0), 1.0, 0.3 + wedge = bpy.data.objects.new("Wedge", ld) + wedge.location = (0.6, 1.8, 2.2) + wedge.rotation_euler = (Vector((0.2, 0.6, 0.0)) - wedge.location).to_track_quat( + "-Z", "Y").to_euler() + scene.collection.objects.link(wedge) + + cam_data = bpy.data.cameras.new("Cam") + cam_data.lens = 50.0 + cam = bpy.data.objects.new("Cam", cam_data) + cam.location = (1.27, -3.74, 1.175) + scene.collection.objects.link(cam) + aim = bpy.data.objects.new("Aim", None) + aim.location = (0.0, 0.0, 0.565) + scene.collection.objects.link(aim) + con = cam.constraints.new("TRACK_TO") + con.target = aim + con.track_axis = "TRACK_NEGATIVE_Z" + con.up_axis = "UP_Y" + scene.camera = cam + + scene.render.engine = "CYCLES" if engine == "cycles" else eevee_engine_id() + if engine == "cycles": + scene.cycles.samples = 32 + scene.cycles.device = "CPU" + else: + try: + scene.eevee.taa_render_samples = 64 + except AttributeError: + pass + scene.render.resolution_x = 1280 + scene.render.resolution_y = 720 + scene.render.image_settings.file_format = "WEBP" if path.lower().endswith(".webp") else "PNG" + if path.lower().endswith(".webp"): + scene.render.image_settings.quality = 90 + scene.render.filepath = path + scene.view_settings.view_transform = "Standard" + + fcode = gallery_framing.check_framing(scene, cam, hero=[low], elements=[low], stage=[floor, wall]) + if fcode: + return fcode + bpy.ops.render.render(write_still=True) + if not (os.path.exists(path) and os.path.getsize(path) > 0): + return fail("render produced no file", 14) + return 0 + + +def main(): + argv = sys.argv[sys.argv.index("--") + 1:] if "--" in sys.argv else [] + p = argparse.ArgumentParser() + p.add_argument("--output", default=None) + p.add_argument("--engine", default="eevee", choices=("eevee", "cycles")) + p.add_argument("--skip-decimate", action="store_true") + p.add_argument("--stray-vert", action="store_true") + p.add_argument("--lift-z", action="store_true") + p.add_argument("--float-side", action="store_true") + p.add_argument("--short-shelves", action="store_true") + p.add_argument("--loose-pages", action="store_true") + p.add_argument("--float-books", action="store_true") + p.add_argument("--float-bands", action="store_true") + p.add_argument("--tall-book", action="store_true") + p.add_argument("--uniform-books", action="store_true") + p.add_argument("--air-lean", action="store_true") + p.add_argument("--deep-lean", action="store_true") + p.add_argument("--crowd-books", action="store_true") + p.add_argument("--sharp-shelf", action="store_true") + args = p.parse_args(argv) + + code, low, _high, mats, tex, _col = check( + args.skip_decimate, + lift_z=args.lift_z, + stray_vert=args.stray_vert, + float_side=args.float_side, + short_shelves=args.short_shelves, + sharp_shelf=args.sharp_shelf, + loose_pages=args.loose_pages, + float_books=args.float_books, + float_bands=args.float_bands, + tall_book=args.tall_book, + uniform_books=args.uniform_books, + crowd_books=args.crowd_books, + air_lean=args.air_lean, + deep_lean=args.deep_lean, + ) + if code: + return code + if args.output: + rcode = render_still(low, mats, tex, os.path.abspath(args.output), args.engine) + if rcode: + return rcode + print(f"rendered still {args.output}") + print("bookshelf OK") + return 0 + + +if __name__ == "__main__": + try: + sys.exit(main()) + except Exception as e: + traceback.print_exc() + print(f"FATAL: {e}", file=sys.stderr) + sys.exit(1) diff --git a/showcase/bookshelf/preview.webp b/showcase/bookshelf/preview.webp new file mode 100644 index 0000000000000000000000000000000000000000..e12eb7cae984b2c4d48492257d30687e220d2068 GIT binary patch literal 28620 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 literal 0 HcmV?d00001 diff --git a/showcase/gallery.json b/showcase/gallery.json index c31232bb..766b4e44 100644 --- a/showcase/gallery.json +++ b/showcase/gallery.json @@ -452,6 +452,19 @@ "mesh", "export" ] + }, + { + "name": "bookshelf", + "dir": "showcase/bookshelf", + "teaches": "A procedural bookcase — two housed shelves, a base on a recessed plinth, lapped back boards and a stepped cornice, filled with thirty-eight rounded-spine hardbacks standing, stacked and leaning — carried through UVs, bake, LOD, convex collider, and Unity glTF, asserting recomputed budgets rather than an API contract.", + "alt": "A stained wooden bookcase with three shelves of cloth and leather hardbacks with gilt spine bands, some standing, some stacked flat, and two leaning against their neighbours.", + "witnessesFix": "Recomputed: 10908 tris, five materials with 338 wood, 2050 cloth, 1066 leather, 228 paper and 1976 gilt faces, UVs in 0..1 with zero AABB overlap, outer AABB 0.972×0.332×1.176 m, zmin 0, hygiene 0 including zero coplanar cross-shell pairs, both sides on the floor, four cross members 8 mm into both sides, 38 books each with one page block 0.6 mm into its boards and two gilt bands 0.3 mm into the spine and 0.8 mm proud, every book seated 1.0–3.2 mm, 44 mm headroom, thickness and height spread 2.90 and 1.65, both leaning books 0.8 mm onto their neighbour's head edge, zero unplanned book overlaps, zero right-angle wood edges, convex collider 68 tris. --air-lean and --deep-lean exit 22 on the lean contact while every seat, the envelope and the overlap budget still pass; --crowd-books exits 23; --uniform-books 21; --tall-book 20.", + "hero": "docs/gallery/assets/bookshelf-hero.webp", + "preview": "showcase/bookshelf/preview.webp", + "tags": [ + "mesh", + "export" + ] } ] } diff --git a/tests/smoke/catalog.json b/tests/smoke/catalog.json index de48bb2d..393f8f01 100644 --- a/tests/smoke/catalog.json +++ b/tests/smoke/catalog.json @@ -107,5 +107,6 @@ {"name": "brazier", "script": "showcase/brazier/brazier.py"}, {"name": "apothecary-shelf", "script": "showcase/apothecary-shelf/apothecary_shelf.py"}, {"name": "wooden-yoke", "script": "showcase/wooden-yoke/wooden_yoke.py"}, - {"name": "butter-churn", "script": "showcase/butter-churn/butter_churn.py"} + {"name": "butter-churn", "script": "showcase/butter-churn/butter_churn.py"}, + {"name": "bookshelf", "script": "showcase/bookshelf/bookshelf.py"} ]