Adom Machine Pins, Fusion Library + Sample Board

⋯ 1 unchanged line ⋯

⋯ 1 unchanged line ⋯

@@ -142,6 +142,53 @@ These are non-negotiable lessons from building this exact library. Every one was    and mis-hit the tiny rows. (Arrow keys sent to the canvas also zoom it out.) 7. **No em-dashes anywhere on the wiki page.** They read as AI-slop; use commas, colons, or hyphens. 8. **Only ship silkscreen board shots.** A 3D board with no silkscreen is not worth showing.+9. **Keep the insertion float TINY (2 to 3mm), never a launch.** A big lift (the first build used 17mm)+   floats the pins high above their holes, so the wide contact barrel reads as "the pin is way bigger+   than the hole" even though the geometry is a correct press-fit. Lift the pin just enough to clearly+   pop out of and reseat in its OWN hole. The barrel is meant to be wider than the drill (it seats on+   the pad); only the thin tail passes through, so the pin must stay visually attached to its hole.+10. **VERIFY THE GLB BY RENDERING IT before you push, every time.** Do not ship a GLB you have not+   looked at. See the verification recipe below.++## Verify the GLB offline (the step that was skipped, causing repeated rejects)++The real Fusion board GLB (via `step2glb`) is **Draco-compressed** (`KHR_draco_mesh_compression`).+`trimesh` cannot decode Draco, so it reads ALL vertices as coincident (area 0, bounds 0) and any+render is black. That is why offline checks silently "passed" while the board looked wrong to the user.+To actually SEE it:++```+pip install --break-system-packages DracoPy pyrender+# render headless with EGL:+import os; os.environ["PYOPENGL_PLATFORM"]="egl"+import DracoPy, pygltflib, numpy as np, pyrender, trimesh+g=pygltflib.GLTF2().load(glb); blob=g.binary_blob()+for mesh in g.meshes:            # decode each primitive+  for p in mesh.primitives:+    ext=p.extensions["KHR_draco_mesh_compression"]; bv=g.bufferViews[ext["bufferView"]]+    dm=DracoPy.decode(blob[(bv.byteOffset or 0):(bv.byteOffset or 0)+bv.byteLength])+    v=np.array(dm.points).reshape(-1,3); f=np.array(dm.faces).reshape(-1,3)   # apply node world transform+# pyrender: PerspectiveCamera(znear=size*0.02) (default 0.05m near-plane clips a 0.05m board -> black),+# render with RenderFlags.SKIP_CULL_FACES (CAD normals are often inverted).+```++Render at rest AND at the animation peak (lift the PIN_* nodes) and LOOK at both. Only push once the+pins visibly seat in their own holes and the solder balls ring each pad.++## The reliable lead-GLB recipe that shipped (use the real Fusion board, do not hand-build the slab)++The user explicitly wanted the REAL Fusion board, not a hand-modeled slab. So: export the Fusion 3D+PCB to STEP, `step2glb` it (real holes, pads, pins, colors), then Draco-DECODE it and rebuild an+uncompressed GLB with `trimesh` so you can add what STEP drops and can render-verify it:+  - board/soldermask meshes -> `alphaMode=BLEND` alpha ~0.45 (transparent FR4, see the tails through it);+  - merge each pin's many sub-meshes (nodes named `MpinContact*` / `=>[0:1:1:*]`) into ONE node per pin+    (`PIN_0..PIN_3`) so it animates as a unit;+  - 300um solder-paste balls: a ring of small metallic spheres just outside each barrel base, on the+    board top surface (auto-size the ring from each pin's detected barrel radius: ~9 balls medium, ~16 large);+  - add a gentle 2 to 3mm insertion animation on the PIN_* nodes (see requirement 9);+  - keep balls STATIC (paste stays on the pad; only the pin moves).+Scripts that shipped this: `/tmp/build_board_glb.py` (decode + rebuild + balls) and+`/tmp/add_anim_board.py` (4-pin animation).  ## Recreate the lead GLB animation (all 4 pins, real holes, silk, solder balls) 

⋯ 1 unchanged line ⋯

@@ -0,0 +1,35 @@+#!/usr/bin/env python3+"""Add a gentle looping insertion animation to the 4 PIN_* nodes of the board GLB."""+import sys, numpy as np, pygltflib+from pygltflib import GLTF2, Animation, AnimationSampler, AnimationChannel, AnimationChannelTarget, Accessor, BufferView+IN, OUT = sys.argv[1], sys.argv[2]+LIFT = float(sys.argv[3])/1000.0   # mm -> meters (scene is meters)++g = GLTF2().load(IN)+pin_nodes = [i for i,n in enumerate(g.nodes) if n.name and n.name.startswith("PIN_")]+print("animating nodes:", [g.nodes[i].name for i in pin_nodes])++times = np.array([0.0,1.4,3.0,4.4,6.0], dtype=np.float32)+trans = np.array([[0,0,0],[0,0,0],[0,0,LIFT],[0,0,LIFT],[0,0,0]], dtype=np.float32)++blob = bytearray(g.binary_blob())+while len(blob)%4: blob.append(0)+def add_view(b):+    while len(blob)%4: blob.append(0)+    off=len(blob); blob.extend(b)+    g.bufferViews.append(BufferView(buffer=0, byteOffset=off, byteLength=len(b)))+    return len(g.bufferViews)-1+tv=add_view(times.tobytes())+g.accessors.append(Accessor(bufferView=tv,componentType=pygltflib.FLOAT,count=len(times),type="SCALAR",+                            min=[float(times.min())],max=[float(times.max())])); in_idx=len(g.accessors)-1+ov=add_view(trans.tobytes())+g.accessors.append(Accessor(bufferView=ov,componentType=pygltflib.FLOAT,count=len(trans),type="VEC3")); out_idx=len(g.accessors)-1++samplers=[]; channels=[]+for pn in pin_nodes:+    samplers.append(AnimationSampler(input=in_idx, output=out_idx, interpolation="LINEAR"))+    channels.append(AnimationChannel(sampler=len(samplers)-1, target=AnimationChannelTarget(node=pn, path="translation")))+g.animations=[Animation(name="insert", samplers=samplers, channels=channels)]+g.buffers[0].byteLength=len(blob); g.set_binary_blob(bytes(blob))+g.save(OUT)+print("added insertion animation, lift",LIFT*1000,"mm ->",OUT)