Rebuild the object in a reference image as a code-only, procedural, quality-gated, animation-ready Three.js model. Token-efficient image-to-3D.
Python 3dai-agentsclaude-codecomputer-graphicsgenerativeimage-to-3dprocedural-generationthreejstypescriptwebgl
chore: update readme (#31)
TamL.9614f1ac830b
diff --git a/README.md b/README.mdindex 82e203f..5ecbed6 100644--- a/README.md+++ b/README.md@@ -9,20 +9,18 @@Quality-gated, animation-ready, and deliberately token-efficient — reconstruction-by-code, not photogrammetry, mesh extraction, or downloaded art packs.[](LICENSE)-[](SKILL.md)+[](CHANGELOG.md)[](CONTRIBUTING.md)[](https://threejs.org)[](scripts)<a href="https://trendshift.io/repositories/83608?utm_source=trendshift-badge&utm_medium=badge&utm_campaign=badge-trendshift-83608" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/trendshift/repositories/83608/daily?language=Python" alt="hoainho%2Fimg2threejs | Trendshift" width="250" height="55"/></a>--</div>-*A single reference image reconstructed in code — correct proportions, colours, bevels, gold trim, and an emissive emblem — running live in the browser.*+*Reference images reconstructed in code as animation-ready Three.js models, running live in the browser.*-### [→ Open the Live Demo Gallery](https://img2threejs-showcase.pages.dev/)+### [→ Open the Live Demo Gallery](https://img2threejs.github.io/img2threejs-showcase/)Every model in the gallery is generated code, running in your browser. No mesh files, no downloads.@@ -30,16 +28,20 @@ Every model in the gallery is generated code, running in your browser. No mesh f## Live demos-Reconstructions built entirely from primitives, procedural shaders, and generated geometry. The clips below are the live models running in-browser — open each one to orbit it and read the generated source.--| Demo | Preview | Subject | View | Source |-| --- | --- | --- | --- | --- |-| Sony WF-1000XM3 Earbuds + Case | <img src="assets/sony-wf1000xm3.gif" width="260" alt="Sony WF-1000XM3 live demo" /> | hard-surface object | [Live](https://img2threejs-showcase.pages.dev/#/demo/sony-wf1000xm3) | [code](https://github.com/img2threejs/img2threejs-showcase/blob/main/src/demos/sony-wf1000xm3/createSonyWf1000xm3Model.ts) |-| ISSACA 12 Gauge Shotgun | <img src="assets/issaca-shotgun.gif" width="260" alt="ISSACA 12 Gauge Shotgun live demo" /> | hard-surface object | [Live](https://img2threejs-showcase.pages.dev/#/demo/issaca-shotgun) | [code](https://github.com/img2threejs/img2threejs-showcase/blob/main/src/demos/issaca-shotgun/createIssacaShotgunModel.ts) |-| Gerber Paracord Knife | <img src="assets/gerber-knife.gif" width="260" alt="Gerber Paracord Knife live demo" /> | hard-surface object | [Live](https://img2threejs-showcase.pages.dev/#/demo/gerber-knife) | [code](https://github.com/img2threejs/img2threejs-showcase/blob/main/src/demos/gerber-knife/createGerberKnifeModel.ts) |-| Doraemon House (isometric diorama) | <img src="assets/doraemon-house.gif" width="260" alt="Doraemon House live demo" /> | hard-surface object | [Live](https://img2threejs-showcase.pages.dev/#/demo/doraemon-house) | [code](https://github.com/img2threejs/img2threejs-showcase/blob/main/src/demos/doraemon-house/createDoraemonHouseModel.ts) |-| War-Hauler "SECTOR 07" | <img src="assets/warhauler.gif" width="260" alt="War-Hauler SECTOR 07 live demo" /> | hard-surface object | [Live](https://img2threejs-showcase.pages.dev/#/demo/warhauler) | [code](https://github.com/img2threejs/img2threejs-showcase/blob/main/src/demos/warhauler/createWarHaulerModel.ts) |-| Crowned Loot Chest | <img src="assets/crown-chest.gif" width="260" alt="Crowned Loot Chest live demo" /> | hard-surface object | [Live](https://img2threejs-showcase.pages.dev/#/demo/crown-chest) | [code](https://github.com/img2threejs/img2threejs-showcase/blob/main/src/demos/crown-chest/createCrownChestModel.ts) |+Reconstructions built entirely from primitives, procedural shaders, and generated geometry. Open any model to orbit it, inspect its reference, and read the generated source.++| Demo | Subject | View | Source |+| --- | --- | --- | --- |+| Glock-18 · Ghost Protocol (Well-Worn) | CS2 weapon | [Live](https://img2threejs.github.io/img2threejs-showcase/#/demo/glock-ghost-protocol) | [code](https://github.com/img2threejs/img2threejs-showcase/blob/main/src/demos/glock-ghost-protocol/createGlockGhostProtocolModel.ts) |+| Classic Knife · Fade (Minimal Wear) | CS2 weapon | [Live](https://img2threejs.github.io/img2threejs-showcase/#/demo/classic-fade) | [code](https://github.com/img2threejs/img2threejs-showcase/blob/main/src/demos/classic-fade/createClassicFadeModel.ts) |+| BMX Endurance Bike | hard-surface object | [Live](https://img2threejs.github.io/img2threejs-showcase/#/demo/bmx-endurance) | [code](https://github.com/img2threejs/img2threejs-showcase/blob/main/src/demos/bmx-endurance/createBmxEnduranceBikeModel.ts) |+| M9 Bayonet · Doppler Phase 2 | CS2 weapon | [Live](https://img2threejs.github.io/img2threejs-showcase/#/demo/m9-doppler) | [code](https://github.com/img2threejs/img2threejs-showcase/blob/main/src/demos/m9-doppler/createM9DopplerModel.ts) |+| Sony WF-1000XM3 Earbuds + Case | hard-surface object | [Live](https://img2threejs.github.io/img2threejs-showcase/#/demo/sony-wf1000xm3) | [code](https://github.com/img2threejs/img2threejs-showcase/blob/main/src/demos/sony-wf1000xm3/createSonyWf1000xm3Model.ts) |+| ISSACA 12 Gauge Shotgun | hard-surface object | [Live](https://img2threejs.github.io/img2threejs-showcase/#/demo/issaca-shotgun) | [code](https://github.com/img2threejs/img2threejs-showcase/blob/main/src/demos/issaca-shotgun/createIssacaShotgunModel.ts) |+| Gerber Paracord Knife | hard-surface object | [Live](https://img2threejs.github.io/img2threejs-showcase/#/demo/gerber-knife) | [code](https://github.com/img2threejs/img2threejs-showcase/blob/main/src/demos/gerber-knife/createGerberKnifeModel.ts) |+| Doraemon House (isometric diorama) | diorama | [Live](https://img2threejs.github.io/img2threejs-showcase/#/demo/doraemon-house) | [code](https://github.com/img2threejs/img2threejs-showcase/blob/main/src/demos/doraemon-house/createDoraemonHouseModel.ts) |+| War-Hauler "SECTOR 07" | hard-surface object | [Live](https://img2threejs.github.io/img2threejs-showcase/#/demo/warhauler) | [code](https://github.com/img2threejs/img2threejs-showcase/blob/main/src/demos/warhauler/createWarHaulerModel.ts) |+| Crowned Loot Chest | hard-surface object | [Live](https://img2threejs.github.io/img2threejs-showcase/#/demo/crown-chest) | [code](https://github.com/img2threejs/img2threejs-showcase/blob/main/src/demos/crown-chest/createCrownChestModel.ts) |The gallery source lives in [img2threejs/img2threejs-showcase](https://github.com/img2threejs/img2threejs-showcase). If this project is useful, a star on this repo helps others find it.@@ -56,7 +58,7 @@ It runs under Claude Code, Codex, or OpenCode. It is agent-agnostic: wherever th- **Objects and characters.** Each subject is classified `object`, `character`, or `hybrid`. Objects follow the hard-surface pipeline; characters route through an anatomy-aware track (head-unit proportions, facial landmarks, pose) documented in `grimoire/character/reconstruction.md`.- **Detail-first analysis.** Before code generation the pipeline enumerates a `detailInventory` of identity-defining small details (gloss, bevel/rounding, screws/rivets, engraved or painted linework, contours, stains and wear). Every detail must map to a real component or material entry, and a strict-quality gate blocks generation until the inventory is complete. Taxonomy: `grimoire/intake/detail_inventory.md`.- **Maximum likeness for a specific person or character.** An opt-in projection-first path fits a parametric template to image landmarks, de-lights the photo, camera-matches the render, and projects the reference onto the mesh. A single image cannot guarantee 100 percent likeness, so the pipeline reports per-region confidence and asks for more views when it matters. Details: `grimoire/character/likeness_maximization.md`.-- **CS2 knife review gates.** The manifest-driven knife path records exactness tier, family identity, painted-region and projection coverage, per-region confidence, approximation notes, and versioned review-scene metadata. See [`docs/cs2/review-gates.md`](docs/cs2/review-gates.md).+- **CS2 weapon review gates.** Knife and Glock-18 routes use family-specific component contracts. The review records exactness tier, family identity, painted-region and projection coverage, per-region confidence, approximation notes, and versioned review-scene metadata; component-coverage and map-stripped blockout gates prevent a convincing texture from standing in for real structure. See [`docs/cs2/review-gates.md`](docs/cs2/review-gates.md).---@@ -218,11 +220,12 @@ The `grimoire/` folder holds the detailed rubrics each gate applies (validation,- **v1.1** — detail-first analysis: required detail inventory, strict-quality gate.- **v1.2** — humanoid character generator: anatomy track, proportion-lock and feature-placement passes.- **v1.3** — quality & efficiency: the Divine Eye deterministic review harness, input-integrity and geometry-truth gates, reference-grounded texture and gradient analysis, CIEDE2000 colour math.+- **v1.4 — The Weapon Update** — CS2 image-matched reconstruction: provenance-aware intake, projection-first finishes, family-specific weapon adapters, and structural review gates.+- **v1.4.1** — CS2 hardening: explicit component coverage, a dedicated Glock-18 assembly contract, map-stripped blockout evidence, and stricter geometry-integrity checks.- **creature generator** — 4 body plans (quadruped / avian / winged-dragon / serpentine), `animalAnatomy` spec, spine-loft geometry, ΔE00 colour gates.**Next — one theme per release:**-- **v1.4 — The Weapon Update** *(shipping soon)*: a 1:1 photorealistic, non-stylized pipeline for CS2-class hard-surface assets — strict PBR standards and texture projection, mechanical reasoning about the assembly, and true metal / polymer / wood response.- **v1.5 — The Character Update** *(in progress)*: character reconstruction, facial features, rigging-ready topology, blendshape preparation, hair and clothing.- **v1.6 — The Environment Update**: buildings, rooms, streets, vegetation, terrain-aware and multi-object reconstruction.- **v1.7 — The Game Pipeline Update**: Unity and Unreal exporters, a Blender bridge, LOD and collision-mesh generation.diff --git a/assets/crown-chest.gif b/assets/crown-chest.gifdeleted file mode 100644index a3d66fe..0000000Binary files a/assets/crown-chest.gif and /dev/null differdiff --git a/assets/demo.gif b/assets/demo.gifdeleted file mode 100644index 280acca..0000000Binary files a/assets/demo.gif and /dev/null differdiff --git a/assets/doraemon-house.gif b/assets/doraemon-house.gifdeleted file mode 100644index cba7ea8..0000000Binary files a/assets/doraemon-house.gif and /dev/null differdiff --git a/assets/gerber-knife.gif b/assets/gerber-knife.gifdeleted file mode 100644index d2b61da..0000000Binary files a/assets/gerber-knife.gif and /dev/null differdiff --git a/assets/issaca-shotgun.gif b/assets/issaca-shotgun.gifdeleted file mode 100644index fc38aa1..0000000Binary files a/assets/issaca-shotgun.gif and /dev/null differdiff --git a/assets/logo.svg b/assets/logo.svgdeleted file mode 100644index cac8af5..0000000--- a/assets/logo.svg+++ /dev/null@@ -1,33 +0,0 @@-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="128" height="128" role="img" aria-label="img2threejs logo">- <defs>- <linearGradient id="top" x1="0" y1="0" x2="1" y2="1">- <stop offset="0" stop-color="#8b5cff"/>- <stop offset="1" stop-color="#38e8ff"/>- </linearGradient>- <linearGradient id="left" x1="0" y1="0" x2="0" y2="1">- <stop offset="0" stop-color="#2bd4c8"/>- <stop offset="1" stop-color="#118a9c"/>- </linearGradient>- <linearGradient id="right" x1="0" y1="0" x2="0" y2="1">- <stop offset="0" stop-color="#6a3cf0"/>- <stop offset="1" stop-color="#2a1a7a"/>- </linearGradient>- <linearGradient id="pix" x1="0" y1="0" x2="1" y2="1">- <stop offset="0" stop-color="#ffd76a"/>- <stop offset="1" stop-color="#ff8bd0"/>- </linearGradient>- </defs>-- <!-- source pixels dissolving into the cube (image -> 3D) -->- <rect x="6" y="40" width="6" height="6" rx="1.4" fill="url(#pix)" opacity="0.35"/>- <rect x="6" y="48" width="6" height="6" rx="1.4" fill="url(#pix)" opacity="0.6"/>- <rect x="14" y="48" width="6" height="6" rx="1.4" fill="url(#pix)" opacity="0.85"/>-- <!-- isometric cube -->- <polygon points="32,9 53,21 32,33 11,21" fill="url(#top)"/>- <polygon points="11,21 32,33 32,56 11,44" fill="url(#left)"/>- <polygon points="53,21 32,33 32,56 53,44" fill="url(#right)"/>-- <!-- specular glint on the top face -->- <path d="M30 15 l1.6 3.2 3.2 1.6 -3.2 1.6 -1.6 3.2 -1.6 -3.2 -3.2 -1.6 3.2 -1.6 z" fill="#f4faff" opacity="0.92"/>-</svg>diff --git a/assets/sony-wf1000xm3.gif b/assets/sony-wf1000xm3.gifdeleted file mode 100644index 0e80d64..0000000Binary files a/assets/sony-wf1000xm3.gif and /dev/null differdiff --git a/assets/warhauler.gif b/assets/warhauler.gifdeleted file mode 100644index 7f13b9e..0000000Binary files a/assets/warhauler.gif and /dev/null differ