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.

docs: add v1.2.0 CHANGELOG; add Trendshift badge + star-history chart to README

hoainhoc0e676d99f96
diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..7cad833
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,77 @@
+# Changelog
+
+All notable changes to **img2threejs** are documented here.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.2.0] - 2026-07-21
+
+**Theme: Humanoid character generator.** Characters and hybrid subjects become
+first-class citizens of the reconstruction pipeline, alongside a round of engine
+and harness improvements to the underlying code generator.
+
+### Added
+
+- **Character / hybrid domain detection.** Assessment now recognizes character-like
+ form language and routes the reconstruction through an anatomy-aware track instead
+ of the hard-surface object path.
+- **Humanoid component template.** A flattened humanoid template with measured
+ head-unit proportions, facial landmark placement, and pose alignment is emitted
+ from the assessment stage.
+- **Proportion-lock build pass.** New gated pass that enforces anatomical proportion
+ correctness before form/material work proceeds.
+- **Feature-placement build pass.** New gated pass that places and validates facial
+ and body landmarks against the reference.
+- **Per-part character materials.** Skin, hair, cloth, and accessory materials
+ integrate with the Track A detail machinery for stylized human figures with
+ recognizable likeness.
+- **Surface topology classification.** Parts are classified by surface topology to
+ drive more accurate geometry choices.
+- **Per-part color / RGBA recipes.** Explicit per-part color and RGBA material
+ recipes for tighter reference matching.
+- **Tier-1 diagnostics.** Diagnostic reporting layer for the generation harness.
+- **Hash caching.** Content-hash caching to avoid redundant recompute across passes.
+- **Real extrude / lathe / tube geometry.** Genuine extrude, lathe, and tube geometry
+ generation replaces prior approximations.
+
+### Changed
+
+- Restructured the project layout ahead of the full harness rebuild, including
+ stage-prefixed script names for clearer pipeline ordering.
+
+### Docs
+
+- Published a public ROADMAP (v1.0 → v1.5) and a token-cost document.
+- README remake: 3D showcase, live-demo links, new logo, and animated GIF previews
+ (shotgun, knife, war-hauler, Sony, Doraemon House, Crowned Loot Chest).
+- Added LICENSE, CONTRIBUTING, and a community-outreach promotion playbook.
+- Funding pointed to the VN donate page (MoMo / VietQR).
+
+## [1.1.0] - 2026-07-15
+
+**Theme: Detail-first analysis.**
+
+### Added
+
+- Required `detailInventory` artifact enumerating identity-defining micro-details
+ (gloss zones, bevels, fasteners, engraved/painted linework, contours, stains, wear).
+- Strict-quality gate that blocks code generation until every detail maps to a real
+ component or material entry, preventing shallow specs from reaching the renderer.
+
+## [1.0.0] - 2026-07-15
+
+**Theme: Object pipeline.** Initial release.
+
+### Added
+
+- Staged sculpt pipeline: blockout → structure → form → material → lighting →
+ interaction → optimization, with a visual gate on each pass.
+- Image suitability validation and `ObjectSculptSpec` authoring (components + materials).
+- Render-vs-reference review loop using side-by-side comparison sheets.
+- Action-ready runtime hierarchy exposing pivots, sockets, and colliders.
+- Token-efficient, code-only output (diffable TypeScript + JSON spec, no binaries).
+
+[1.2.0]: https://github.com/hoainho/img2threejs/releases/tag/v1.2.0
+[1.1.0]: https://github.com/hoainho/img2threejs/releases/tag/v1.1.0
+[1.0.0]: https://github.com/hoainho/img2threejs/releases/tag/v1.0.0
diff --git a/README.md b/README.md
index 6037f86..5801263 100644
--- a/README.md
+++ b/README.md
@@ -14,6 +14,8 @@ Quality-gated, animation-ready, and deliberately token-efficient — reconstruct
[![Runtime](https://img.shields.io/badge/runtime-Three.js-000000.svg)](https://threejs.org)
[![Tooling](https://img.shields.io/badge/tooling-Python%203.10%2B%20stdlib-3776ab.svg)](scripts)
+<a href="https://trendshift.io/repositories/83608?utm_source=trendshift-badge&amp;utm_medium=badge&amp;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>
+
![img2threejs demo — a reference loot-chest image reconstructed as a procedural Three.js model](assets/demo.gif)
</div>
@@ -196,6 +198,20 @@ A single image cannot reveal hidden sides or guarantee exact geometry. The skill
---
+## Star history
+
+If img2threejs is useful to you, a star helps others find it.
+
+<a href="https://star-history.com/#hoainho/img2threejs&Date">
+ <picture>
+ <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=hoainho/img2threejs&type=Date&theme=dark" />
+ <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=hoainho/img2threejs&type=Date" />
+ <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=hoainho/img2threejs&type=Date" width="600" />
+ </picture>
+</a>
+
+---
+
## Contributing
Contributions are welcome — procedural material recipes, new gates, host coverage, and demos especially. See [CONTRIBUTING.md](CONTRIBUTING.md) and the [roadmap](ROADMAP.md) for where the project is headed.