img2threejs/img2threejs

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

해결하는 문제

img2threejs는 객체 또는 캐릭터의 단일 참조 이미지를 프로시저럴한 Three.js 모델로 변환합니다. 포토그래메트리 또는 메쉬 추출과 달리, 코드 전용 지오메트리, 프리미티브 및 프로시저럴 셰이더를 사용하여 객체를 재구축하므로 결과물이 애니메이션에 즉시 사용 가능하며 AI 에이전트에게 토큰 효율적입니다.

작동 방식

이 프로젝트는 AI 에이전트(Claude Code 등)와 결정론적 Python 스크립트를 통합한 단계별 스컬프팅 파이프라인을 사용합니다. 프로세스는 엄격한 빌드 패스 시퀀스를 따릅니다:

  1. Analysis: 시스템이 대상(객체, 캐릭터 또는 하이브리드)을 분류하고 정체성을 정의하는 특징(베벨, 나사, 광택 등)의 detailInventory를 생성합니다.
  2. Specification: 컴포넌트 트리와 재질을 정의하는 ObjectSculptSpec JSON을 작성합니다.
  3. Iterative Sculpting: 모델은 여러 패스(blockout $ ightarrow$ structural $ ightarrow$ form refinement $ ightarrow$ material $ ightarrow$ surface $ ightarrow$ lighting $ ightarrow$ interaction $ ightarrow$ optimization)를 통해 구축됩니다.
  4. Review Loop: 각 패스 후 Python 스크립트가 나란히 비교 시트(참조 vs 렌더링)를 생성합니다. AI 에이전트가 렌더링을 검토하고 비전 점수에 따라 continue, refine-spec 또는 refine-code를 결정합니다.
  5. Output: 최종 결과물은 애니메이션을 위한 런타임 계층 구조(피벗, 소켓 및 콜라이더)를 가진 THREE.Group을 반환하는 TypeScript 팩토리 함수입니다.

대상 사용자

무거운 메쉬 파일이나 수동 모델링에 의존하지 않고 이미지에서 3D 에셋을 생성하고자 하는 개발자 및 테크니컬 아티스트, 특히 AI 에이전트를 사용하여 3D 제작 워크플로우를 자동화하려는 분들에게 적합합니다.

주요 특징

  • Code-only Reconstruction: 바이너리 메쉬 파일 대신 TypeScript 코드를 생성하여 에셋의 diff 및 버전 관리가 가능합니다.
  • Agent-Agnostic: 비전 및 브라우저 도구를 가진 모든 에이전트(예: Claude Code, Codex)와 함께 작동합니다.
  • Token-Efficient: 기계적인 작업(검증, PBR 추출, 비교 패키징)을 Python 스크립트로 오프로드하여 모델 토큰을 절약합니다.
  • Animation-Ready: 정적 메쉬를 생성하는 대신 피벗과 소켓이 포함된 런타임 계층 구조를 포함합니다.
  • Strict Quality Gates: 사양이 객체의 복잡성에 맞을 만큼 충분히 상세해질 때까지 코드 생성을 방지합니다.