LLM Wiki

img2threejs: 이미지 한 장을 코드로 재구성하는 Three.js 3D 모델 생성 도구

Properties2
descriptionPyTorchKR 9bow 게시글의 핵심 내용과 실무적 의미를 원문에 근거해 정리한다.
tagsai-models, open-source, research

5 min read

출처

개요

img2threejs는 이미지 한 장을 바탕으로 객체를 코드로 재구성해, 브라우저에서 사용할 수 있는 Three.js 3D 모델을 생성하는 에이전트 스킬입니다. 사진측량이나 메시 파일 대신 기본 도형, 절차적 셰이더, 생성 지오메트리를 조합한 TypeScript THREE.Group 팩토리를 출력합니다. 블록아웃부터 최적화까지 여러 빌드 패스를 거치며, 각 단계는 실제 렌더와 참조 이미지 비교 및 에이전트 비전 평가를 통과해야 진행됩니다. 결과물에는 모델 사양 JSON, TypeScript 팩토리, 렌더·비교 시트가 포함되며 피벗·소켓·콜라이더 등 런타임 계층도 노출합니다. 다만 단일 이미지로 보이지 않는 면이나 정확한 지오메트리를 알 수 없으므로 결과는 근사적이거나 양식화될 수 있습니다.

핵심 포인트

  • 이미지에서 객체를 분석해 ObjectSculptSpec JSON과 TypeScript 기반 THREE.Group 팩토리를 생성합니다.
  • 모델 생성 과정은 블록아웃 → 구조 → 형태 → 재질 → 표면 → 조명 → 상호작용 → 최적화 순서의 패스로 나뉩니다.
  • 각 패스는 이전 단계의 검토가 끝나야 진행되며, 기준 미달 시 refine-spec 또는 refine-code로 수정합니다.
  • 검증, 게이트 처리, 사양 작성, PBR 추출, 비교 시트 생성 등 반복 작업은 결정적 Python 스크립트가 담당합니다.
  • 스크립트는 Python 3.10 이상과 표준 라이브러리만 사용하며, 별도의 pip·PIL·NumPy·Playwright 의존성이 없습니다.
  • 대용량 메시 파일 대신 diff 가능한 TypeScript와 JSON을 생성하므로 코드 검토와 버전 관리에 적합합니다.
  • 하드서피스 객체에는 비교적 적합하지만, 캐릭터를 사진처럼 동일하게 재현하는 도구는 아니며 양식화된 결과가 될 수 있습니다.

왜 중요한가

이미지 기반 3D 생성 결과를 거대한 메시 파일이 아닌 코드와 사양으로 관리할 수 있어, 생성물의 수정·검토·버전 관리가 쉬워집니다. 또한 단계별 품질 게이트를 통해 에이전트가 전체 모델을 매번 다시 생성하기보다 현재 필요한 패스만 수정하도록 하여 토큰 사용을 줄이는 구조를 제시합니다. 생성된 모델에 소켓과 콜라이더 같은 런타임 정보가 포함되므로 단순한 시각적 모델을 넘어 애니메이션이나 상호작용이 필요한 Three.js 프로젝트에 활용할 수 있습니다. 다만 단일 참조 이미지의 정보 한계 때문에 정확한 3D 복원보다는 절차적·양식화된 재구성 도구로 이해해야 합니다.

설치 및 사용

git clone https://github.com/hoainho/img2threejs.git ~/.claude/skills/img2threejs

Claude Code에서 이미지를 첨부한 뒤 다음과 같이 호출합니다.

/img2threejs Rebuild this object as a Three.js model, keep the proportions, angles, and colours.

라이선스

Apache 2.0 라이선스로 공개되어 개인 및 상업적 용도로 사용할 수 있습니다.

원문 및 후속 링크

관련 위키

원문 보존 위치

원문 전체는 raw source: 2026-07-26-pytorchkr-topic-11410-img2threejs-three-js-3d에 source_url 및 HTML 원문과 함께 저장되어 있습니다.

백링크