img2threejs: 코드 전용 기하학을 사용해 참조 이미지에서 객체를 재구성하는 절차적 Three.js 모델 생성기

해결하는 문제

img2threejs는 객체, 캐릭터 또는 생물의 단일 참조 이미지를 절차적 Three.js 모델로 변환합니다. 포토그래메트리나 메시 추출과 달리, 프리미티브와 셰이더를 사용해 코드 전용 모델을 생성하여 결과가 가볍고, 애니메이션 준비가 되어 있으며, 외부 메쉬 파일이나 아트 팩 없이 브라우저에서 직접 실행됩니다.

작동 방식

이 프로젝트는 이미지를 기술 사양으로 변환하는 단계별 스컬프팅 파이프라인을 사용하며, 이후 블록아웃, 구조, 형태, 재질, 표면, 조명, 인터랙션, 최적화의 여러 단계로 모델을 반복적으로 구축합니다.

이는 Claude Code, Codex, OpenCode와 같은 AI 코딩 에이전트 내에서 실행될 수 있도록 에이전트에 구애받지 않도록 설계되었습니다. 파이프라인은 검증 및 품질 게이팅을 위해 결정론적 Python 스크립트를 사용하고, AI 에이전트는 시각적 판단과 코드 생성을 담당합니다. 캐릭터의 경우, 해부학을 고려한 트랙을 사용해 파라메트릭 템플릿과 랜드마크 피팅을 통해 유사성을 극대화합니다.

대상

이미지에서 브라우저 기반 3D 자산을 빠르게 생성해야 하는 개발자와 3D 아티스트, 특히 정적 메쉬가 아닌 절차적이고 코드 기반 기하학을 원하는 사람들을 위한 도구입니다.

주요 특징

  • 코드 전용 재구성: 프리미티브와 절차적 셰이더를 사용해 모델을 생성하는 TypeScript 팩토리를 생성합니다.
  • Animation-Ready: 즉시 애니메이션이 가능한 피벗, 소켓, 콜라이더가 포함된 런타임 계층 구조를 생성합니다.
  • Detail-First Analysis: 생성이 시작되기 전에 베벨, 리벳, 마모 등 정체성을 정의하는 세부 요소의 전체 목록을 요구하는 엄격한 품질 게이트를 사용합니다.
  • Subject-Specific Pipelines: 하드 서피스 객체, 인간형 캐릭터, 생물(네발동물, 조류 등)을 위한 전용 트랙을 포함합니다.
  • Detailed Review Gates: CS2 전용 무기 계약 및 정확성을 위한 CIEDE2000 색상 수학 등 엄격한 검사를 구현합니다.

Sources