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-
3D model: laser-etched part number via service-occt, page.json keys, iso-front hero pose #1
Section 4 (the 3D model) gains the laser-etched part number as it is actually produced now, and the hero pose that goes with it.
What changed (2026-09-17): every factory component page ships <stem>-etched.step / <stem>-etched.glb — the MPN laser-etched on the die by service-occt /laser-etch (Ray's container, toggleable Adom.LaserEtch group, ~6 s, no model tokens) — and page.json names the etched files as model_3d / model_3d_step with the bare body kept as *_plain. The 14k existing pages are being backfilled.
The section's only marking guidance was a local cadquery side-emboss. This adds the service call (the die marking), the page.json keys, and the iso-front hero pose (service-occt 1.3.8): iso/iso2 look from behind, so a 0-degree mark reads upside-down in a hero while it is upright in the wiki viewer — found on the first 0603 of the backfill. The side-emboss note stays for side faces.
🤖 Generated with Claude Code
Diff Skip to comments (1)
@@ -1,1279 +1,1293 @@⋯ 474 unchanged lines ⋯ (~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).⋯ 794 unchanged lines ⋯ Hit a new wiki issue, a viewer quirk, or a better hero recipe? Add it to the right section (usually §8 gotchas, §3 hero, or §4 composite), bump the version, and open a PR against `adom/adom-hardware-component-publish`. Keep findings **specific and cited**.+
Comments
Log in to comment.