# IN-S42ATR: coloured-lens pass (2026-09-30)

Published on the wiki. Each later pass has its own section below; where they differ, the later section wins.

## Files

Changed:

- `IN-S42ATR.glb`
- `IN-S42ATR.insertion.glb`
- `IN-S42ATR.step`
- `README.md`
- `page.json`
- `screenshots/hero.png`

Added:

- `IN-S42ATR-uncoloured.step`
- `in-s42atr-hero.glb`
- `provenance/` (provenance JSON, colour report, hero pin map, the scripts used)

`IN-S42ATR-uncoloured.step` is the STEP the page shipped before this pass, byte for byte (renamed only). `IN-S42ATR.step` is now the coloured model, so anything that fetches the page STEP by its usual name gets colour by default.

## Colour

- Datasheet: IN-S42AT series V1.1 p.3, lambda_D typ: dominant wavelength (typical) 631 nm.
- Lens colour: sRGB #C34235 (0.7657, 0.2589, 0.2074), OKLCh L 0.56 C 0.1674 h 29.2 deg.
- Why: red: lambda_d 631 nm is beyond the sRGB red primary; hue = red primary 29.2 deg (lambda_d-exact edge colour would be 19.4 deg, rose).
- Method (all LEDs): hue from the datasheet dominant wavelength, chroma 65 % of the most saturated sRGB colour at that hue, lightness chosen so the lens reads as tinted epoxy rather than paint (John, 2026-09-30: less saturated, match the nm). Details in `provenance/tools/led_colour.py`.

## What was coloured

STEP family `template`, 50 faces: lens 5, substrate 7, terminal 34, cathode_mark 4; 50 faces recoloured (XCAF ColorSurf and ColorGen).
This page's STEP is the KiCad 0402 LED model scaled to 0.45 mm in Z and re-exported without any colours. Face classes were copied from the KiCad 0402 model by face index (every face's X/Y extent checked), so the lens gets the LED colour and the substrate, terminals and cathode mark get the KiCad library colours they were missing.
Geometry, face count, volume, centroid and the product name are unchanged (checked with `verify_geom.py`); the KiCad licence comment block is carried into the new file header.

## GLBs

| File | Triangles before | after | Bytes before | after |
|---|---|---|---|---|
| `IN-S42ATR.glb` | 3010 | 1137 | 263160 | 87316 |
| `IN-S42ATR.insertion.glb` | 3034 | 1161 | 264668 | 87184 |
| `in-s42atr-hero.glb` (new) | | 319 | | 30220 |

The composites are the page's own LED scenes (board, pads, silk, solder fillets, LED, glow skin, FOV cone, point light); `.insertion.glb` is the one the README viewer loads and animates as the pick-and-place insertion. Only the LED mesh and its four materials were replaced, with geometry from `step2glb convert` of the coloured STEP (same frame and units: metres, Z-up, seated on z = 0) and the node's existing Z scale kept so the rendered height stays at the datasheet package height. The triangle drop is the LED alone: the old LED mesh was a finer tessellation of the same KiCad solid; step2glb tessellates the planar faces with fewer triangles. The lens material is now roughness 0.35 with a clear coat.

## Hero

- `in-s42atr-hero.glb`: built like john/eee-fk1v470p's hero: the coloured LED (Z scale 1.0) plus nonphysical footprint reference art from the page's current `IN-S42ATR.kicad_mod` (Colby's cathode bracket): teal dashed pad outlines 50 %, silkscreen 30 %, K / A pad labels 50 %, each a declared viewer layer. No laser etch. `page.json` `component.parts.model_3d` now points at it (the composite `IN-S42ATR.glb` stays as `model_3d_plain`).
- `screenshots/hero.png`: Ray layout from the shared basic-part hero template (COMPONENT kicker, page title, MPN, brief, manufacturer and package, ADOM BASIC PART pill), the coloured LED rendered iso on the right, no footprint art. Old hero kept at `../before/in-s42atr/before-hero.png`.

## page.json and README

- `page.json` `component.parts`: `step` / `model_3d_step` = `IN-S42ATR.step` (coloured, default), `model_3d_step_plain` = `IN-S42ATR-uncoloured.step` (optional), `model_3d` = `in-s42atr-hero.glb`, `model_3d_plain` = `IN-S42ATR.glb`, plus `viewer_3d.tooltips: authored`.
- `README.md` Downloads table: the STEP row now says coloured/default, plus a row for the optional uncoloured STEP and one for the hero GLB.
- Not changed: `README.html` (generated; it has no STEP link, and its inline viewer loads `IN-S42ATR.insertion.glb`, which was rebuilt under the same name), `IN-S42ATR.html` (its "3D Model (.step)" button points at a legacy static host by the unchanged file name), `.kicad_mod`, `.kicad_sym`, `.lbr`, `.adom-lbr.json`, the fpview/symview HTML (none of them reference a 3D model).

## Side MPN laser etch (pass 3)

John: laser-etch the MPN on every component we put on the wiki; on LEDs on the side, so it does not ruin the LED window.

- `IN-S42ATR.step` carries a flat virtual `IN-S42ATR` mark (separate part `laser_etch`, near-black, linear RGB 0.012) on the **-Y side face, inside the lens/body band** (above the PCB substrate, clear of the seam and of the top window). Text runs along the long axis and reads upright from the -Y side; text height 0.102 mm (service frac 0.55), sized to fill the band minus 10 % / 18 % margins. Made with adom-aiflow `etch_part.py --face side` on the adom-chip-laser service; details in `provenance/in-s42atr-led-pass.provenance.json` (`laser_etch`) and `provenance/IN-S42ATR-etch.report.json`.
- `IN-S42ATR-uncoloured.step` gets no mark (plain model).
- `IN-S42ATR.glb`, `IN-S42ATR.insertion.glb` and `in-s42atr-hero.glb` rebuilt from the etched STEP; the mark is its own node `Adom.LaserEtch.MPN` (a child of the LED node; in the hero it is the finalize.py etch node, toggleable in the viewer).
- `screenshots/hero.png` re-rendered at the same angle, which faces the -Y side, so the mark is visible and legible.

## GLB animation fix

`IN-S42ATR.glb` and `IN-S42ATR.insertion.glb` re-written with their "insert" animation intact: the rebuilds in the earlier passes dropped the animation keyframe accessors, so the insertion animation pointed at geometry data. The keyframes now match the original files exactly (checked on every rebuild since).

## 0402 pad size fix (pass 4)

The datasheet's recommended solder pattern (IN-S42AT series V1.1 p.1, Figure 1: pads 0.4 mm wide x 0.6 mm tall, 0.6 mm gap, pad centres at +-0.5 mm) matches `IN-S42ATR.kicad_mod` exactly. `IN-S42ATR.lbr` still had 0.6 x 0.5 mm pads; their pad geometry is corrected to 0.4 x 0.6 mm and nothing else in those files changed (`adom-lbr validate` passes).

## Open issues seen (not fixed here, other owners)

- The KiCad chip-LED STEP height differs from the datasheet: matches (0.45 mm). The page GLBs and the hero scale it in Z (as the composites already did); the STEP itself is left unchanged.
- Fixed in pass 4: pad size in the .adom-lbr.json / .lbr / viewers (0.4 x 0.6 mm, the datasheet land pattern). Their silkscreen still differs from the bracket in the .kicad_mod.

# IN-S42ATR: footprint, hover and README pass (2026-10-03)

John: footprints follow the manufacturer's land pattern; README.md replaces README.html; the assembly animation moves to a sub-readme.

- Footprint: kept. Land pattern from Inolux IN-S42AT series datasheet, p.1 (Recommended Solder Pattern). Pads 0.4 x 0.6 mm, centre to centre 1 mm, corner radius 0.1 mm.
- Rebuilt from the footprint: `IN-S42ATR-fpview.html` (and the lbr-hover bus on both viewers), `IN-S42ATR.lbr`, `IN-S42ATR.adom-lbr.json`, the hero GLB, and the pads / solder / silk in `IN-S42ATR.insertion.glb`.
- Etched STEP: kept.
- README.html removed (it repeated the native Symbol & Footprint viewers); README.md rewritten; `docs/assembly.md` + `docs/assembly.html` carry the pick-and-place animation; `docs/datasheet.md` the datasheet pages.
- New: `IN-S42ATR-outline.kicad_sym`, `artwork/IN-S42ATR-3d-outline-blueprint-named.svg`, `artwork/IN-S42ATR-3d-outline-dark-named.svg`, `artwork/IN-S42ATR-3d-outline-ink-heavy-named.svg`, `artwork/IN-S42ATR-3d-outline-teal-named.svg`, `artwork/IN-S42ATR-thumbs.json`, `docs/assembly.html`, `docs/assembly.md`, `docs/datasheet.md`, `footprint-variants/IN-S42ATR-RR25.kicad_mod`, `footprint-variants/IN-S42ATR-SQ.kicad_mod`, `footprint-variants/IN-S42ATR.kicad_mod`, `footprint-variants/IN-S42ATR.variants.json`, `in-s42atr-hero.overlay.json`
- Removed: `README.html`