by adom
The one-stop-shop for publishing a hardware component (or molecule/board) to the Adom Wiki. The whole lifecycle: page anatomy, the clone→edit→preview→push loop and its hard rules, making a great hero image (Hero Component Studio — 16:10, overlay-safe, datasheet-backed), the animated 3D composite, the interactive 3D viewer, ct thumbnails, the datasheet-accuracy audit, and every wiki push/pull gotcha we've hit. Now includes the worked Path B (board) pipeline: STEP-to-GLB, refdes tagging, layer de-
← Commit history
Merge PR #153: 3D model: laser-etched part number via service-occt, page.json keys, iso-front hero pose
1 file changed
+15−2
SKILL.md+15−2@@ -475,8 +475,21 @@ and `scripts/build_composite_cap.py` (cap, 2 materials) for full worked builders (~4e-5) — inverse-square blows the board white at 0.3. Parent the light to `<MPN>` so it rides the animation. Red light on a green FR4 board reads warm/orange (green absorbs red — physics). - **Emissive brightness:** boost with `KHR_materials_emissive_strength`.-- **Side embossing (part number/value):** cadquery boolean-cut the text into the STEP; auto-fit the- font to the measured width×height taper so the whole string fits off the terminations.+- **Part number on the die — use the service, not a local cadquery cut.** `service-occt`+ `/laser-etch?name=<MPN>&mode=flat` (Ray's container `occt-fbnsqrdkehdj.adom.cloud`, 1.3.8+; POST+ the STEP, 202 + job, poll `/jobs/<id>`, download `/result`) fits the text to the largest usable+ upper face, avoids the pin-1 keep-out, compares 0/90 degrees and keeps the marking in a toggleable+ `Adom.LaserEtch` group, so the etched STEP is a superset of the plain body. ~6 s, no model tokens.+ Every factory component page ships `<stem>-etched.step` / `<stem>-etched.glb` as `model_3d` /+ `model_3d_step` with the bare body kept as `*_plain` (the wiki's `/viewer/3d` renders whatever+ `parts.model_3d` names). Since 2026-09-17; the 14k older pages are being backfilled the same way.+- **Hero pose for an etched part:** render with `pose=iso-front` (+X,−Y,+Z, the wiki viewer's own+ camera). `iso` and `iso2` look from behind (+Y), so a 0-degree mark (every 2-terminal passive)+ reads upside-down in the hero while it is upright in the viewer. The `step2glb` CLI predates the+ pose; call `/thumbnail?pose=iso-front&width=&height=` on the service directly.+- **Side embossing (part number/value), when you need it on a side face:** cadquery boolean-cut the+ text into the STEP; auto-fit the font to the measured width×height taper so the whole string fits+ off the terminations. - **Colouring a re-tessellated (embossed) mesh:** transfer material per-triangle by **densified nearest-neighbour** from the original colour GLB (a plane split only works for a clean 2-material boundary; 3-material parts need densified NN or you get zigzag artifacts).