img2threejs
重建參考影像中的物件,成為純程式碼、程序化、品質控管、動畫就緒的 Three.js 模型。Token 高效的影像轉 3D。
img2threejs 是什麼?
重建參考影像中的物件,成為純程式碼、程序化、品質控管、動畫就緒的 Three.js 模型。Token 高效的影像轉 3D。
img2threejs 概覽
這是什麼
將參考影像中的物體重建為純程式碼、程序化的 Three.js 模型。經過品質門控、可動畫化,並刻意追求 token 效率——透過程式碼重建,而非攝影測量、網格提取或下載美術素材包。
主要功能
- 產生以 TypeScript 撰寫的
THREE.Group工廠,從基本幾何體、程序化著色器和生成的幾何形狀重建物體,並包含執行時期層級結構(樞紐、插座、碰撞體)以支援動畫。 - 可在 Hermes、Claude Code、Codex 或 OpenCode 上執行;與代理無關。
- 物體分類為
object、character或hybrid;角色使用解剖感知的追蹤流程。 - 細節優先分析:在程式碼生成前列舉
detailInventory中定義身份的小細節;嚴格的品質門控會阻止生成,直到清單完整。 - 可選的投影優先路徑,用於最大化特定人物或角色的相似度。
- 可選的多視圖輪廓雕刻,使用至少兩個確定的正交二值輪廓。
- CS2 武器審查門控,用於 Knife 和 Glock-18 路線。
使用情境
從單張參考影像重建物體和角色,成為可動畫化的 Three.js 模型,支援硬表面物體和解剖感知的角色骨架。生成的程式碼在瀏覽器中即時執行,無需網格檔案或下載。
快速開始
npx --yes img2threejs@latest install
npx --yes img2threejs@latest doctor
若需外掛:
npx --yes @img2threejs/img2@latest install --yes
npx --yes @img2threejs/img2@latest plugins
完整細節請參閱儲存庫 README。
授權與價格
採用 Apache-2.0 授權。開放原始碼。
內容整理自該專案公開的 README 與儲存庫資訊。