← All Pull Requests

3D model: laser-etched part number via service-occt, page.json keys, iso-front hero pose #1

Merged not released yet opened by Ray

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)

--- a/SKILL.md+++ b/SKILL.md@@ -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

Ray ·

Heads-up on merge order: #2 (visibility default: match the board) is built on top of this file, so it is a superset. Merge #1 then #2, or #2 alone. Merging #2 first and then #1 would revert the visibility change.

Log in to comment.