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
README: new logo + animated GIF previews for shotgun, knife, war-hauler demos
hoainhocc7fdd09f25d
diff --git a/README.md b/README.mdindex 5bc312d..3739504 100644--- a/README.md+++ b/README.md@@ -1,13 +1,12 @@-```- ___ ____ _ _ _- (_)_ __ ___ __ |___ \| |_| |__ _ __ ___ ___ (_)___- | | '_ ` _ \ / _` | __) | __| '_ \| '__/ _ \/ _ \| / __|- | | | | | | | (_| |/ __/| |_| | | | | | __/ __/ | \__ \- |_|_| |_| |_|\__, |_____|\__|_| |_|_| \___|\___|/ |___/- |___/ |__/-```+<div align="center">++<img src="assets/logo.svg" width="112" height="112" alt="img2threejs logo" />-**Rebuild the object in a reference image as a code-only, procedural Three.js model.** Quality-gated, animation-ready, and deliberately token-efficient. Reconstruction-by-code — not photogrammetry, mesh extraction, or downloaded art packs.+# img2threejs++**Rebuild the object in a reference image as a code-only, procedural Three.js model.**++Quality-gated, animation-ready, and deliberately token-efficient — reconstruction-by-code, not photogrammetry, mesh extraction, or downloaded art packs.[](LICENSE)[](SKILL.md)@@ -17,6 +16,8 @@+</div>+*A single reference image reconstructed in code — correct proportions, colours, bevels, gold trim, and an emissive emblem — running live in the browser.*### [→ Open the Live Demo Gallery](https://hoainho.github.io/img2threejs-showcase/)@@ -27,13 +28,15 @@ Every model in the gallery is generated code, running in your browser. No mesh f## Live demos-Three reconstructions built entirely from primitives, procedural shaders, and generated geometry. Open each one, orbit it, and read the generated source.+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 | Subject | View | Source |-| --- | --- | --- | --- |-| Crowned Loot Chest | hard-surface object | [Live](https://hoainho.github.io/img2threejs-showcase/#/demo/crown-chest) | [code](https://github.com/hoainho/img2threejs-showcase/blob/main/src/demos/crown-chest/createCrownChestModel.ts) |-| Beach Character | stylized character | [Live](https://hoainho.github.io/img2threejs-showcase/#/demo/character) | [code](https://github.com/hoainho/img2threejs-showcase/blob/main/src/demos/character/createCharacterModel.ts) |-| Portrait Bust | stylized likeness | [Live](https://hoainho.github.io/img2threejs-showcase/#/demo/portrait) | [code](https://github.com/hoainho/img2threejs-showcase/blob/main/src/demos/portrait/createPortraitModel.ts) |+| Demo | Preview | Subject | View | Source |+| --- | --- | --- | --- | --- |+| ISSACA 12 Gauge Shotgun | <img src="assets/issaca-shotgun.gif" width="260" alt="ISSACA 12 Gauge Shotgun live demo" /> | hard-surface object | [Live](https://hoainho.github.io/img2threejs-showcase/#/demo/issaca-shotgun) | [code](https://github.com/hoainho/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://hoainho.github.io/img2threejs-showcase/#/demo/gerber-knife) | [code](https://github.com/hoainho/img2threejs-showcase/blob/main/src/demos/gerber-knife/createGerberKnifeModel.ts) |+| War-Hauler "SECTOR 07" | <img src="assets/warhauler.gif" width="260" alt="War-Hauler SECTOR 07 live demo" /> | hard-surface object | [Live](https://hoainho.github.io/img2threejs-showcase/#/demo/warhauler) | [code](https://github.com/hoainho/img2threejs-showcase/blob/main/src/demos/warhauler/createWarHaulerModel.ts) |+| Doraemon House (isometric diorama) | — | hard-surface object | [Live](https://hoainho.github.io/img2threejs-showcase/#/demo/doraemon-house) | [code](https://github.com/hoainho/img2threejs-showcase/blob/main/src/demos/doraemon-house/createDoraemonHouseModel.ts) |+| Crowned Loot Chest | — | hard-surface object | [Live](https://hoainho.github.io/img2threejs-showcase/#/demo/crown-chest) | [code](https://github.com/hoainho/img2threejs-showcase/blob/main/src/demos/crown-chest/createCrownChestModel.ts) |The gallery source lives in [hoainho/img2threejs-showcase](https://github.com/hoainho/img2threejs-showcase). If this project is useful, a star on this repo helps others find it.diff --git a/assets/gerber-knife.gif b/assets/gerber-knife.gifnew file mode 100644index 0000000..d2b61daBinary files /dev/null and b/assets/gerber-knife.gif differdiff --git a/assets/issaca-shotgun.gif b/assets/issaca-shotgun.gifnew file mode 100644index 0000000..fc38aa1Binary files /dev/null and b/assets/issaca-shotgun.gif differdiff --git a/assets/logo.svg b/assets/logo.svgnew file mode 100644index 0000000..cac8af5--- /dev/null+++ b/assets/logo.svg@@ -0,0 +1,33 @@+<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/warhauler.gif b/assets/warhauler.gifnew file mode 100644index 0000000..7f13b9eBinary files /dev/null and b/assets/warhauler.gif differ