Skip to content

Rebuild the object in a reference image as a code-only, procedural, quality-gated, animation-ready Three.js model. Token-efficient image-to-3D.

README: new logo + animated GIF previews for shotgun, knife, war-hauler demos

hoainhocc7fdd09f25d
diff --git a/README.md b/README.md
index 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: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
[![Version](https://img.shields.io/badge/version-1.2.0-green.svg)](SKILL.md)
@@ -17,6 +16,8 @@
![img2threejs demo — a reference loot-chest image reconstructed as a procedural Three.js model](assets/demo.gif)
+</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.gif
new file mode 100644
index 0000000..d2b61da
Binary files /dev/null and b/assets/gerber-knife.gif differ
diff --git a/assets/issaca-shotgun.gif b/assets/issaca-shotgun.gif
new file mode 100644
index 0000000..fc38aa1
Binary files /dev/null and b/assets/issaca-shotgun.gif differ
diff --git a/assets/logo.svg b/assets/logo.svg
new file mode 100644
index 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.gif
new file mode 100644
index 0000000..7f13b9e
Binary files /dev/null and b/assets/warhauler.gif differ