Repolode
제출하기
Supra-3D

Supra-3D/SUPRA-Tex

단일 이미지에서 기본 색상, 금속도, 거칠기 맵을 포함한 텍스처 적용 및 조명 변경이 가능한 3D 에셋(GLB)을 생성하고, 기존 메시에도 텍스처를 입힙니다.

GitHub에서 보기웹사이트
스타
699
포크
35
열린 이슈
4
마지막 커밋
10일 전

어떤 프로젝트인가요?

SUPRA-Tex는 단일 이미지에서 물리 기반 렌더링(PBR) 머티리얼이 적용된 3D 에셋을 만듭니다. 참조 뷰에서 머티리얼을 예측한 뒤 표면에 정렬된 3D 관측값으로 인코딩하고, Interleaved Flow Transformer를 사용해 카메라에 보이지 않는 영역을 채웁니다. 입력 이미지의 글자, 패턴, 머티리얼 경계 같은 세부 요소를 보이는 표면에 유지하는 것이 목표입니다.

출력은 기본 색상, 금속도, 거칠기 텍스처가 포함된 GLB 파일이므로 새로운 조명 환경에서 렌더링할 수 있습니다. 이미지에서 3D를 생성하는 기능 외에도, 카메라, 전경 이미지, 참조 뷰 머티리얼 맵을 제공하면 같은 파이프라인으로 기존 메시에도 텍스처를 입힐 수 있습니다. 듀얼 뷰 모드에서는 생성된 뒷면 뷰를 추가해 보이지 않던 면에도 이미지의 특징을 반영합니다.

이 프로젝트를 실행하려면 Linux, NVIDIA GPU, CUDA 12.4가 필요합니다. 로컬 Gradio 웹 앱과 명령줄 스크립트가 포함되어 있습니다. DINOv3, RMBG-2 등 일부 파이프라인 모델은 Hugging Face에서 별도로 접근 승인을 받아야 합니다.

핵심 기능

  • 01기본 색상, 금속도, 거칠기 텍스처가 포함된 GLB 에셋을 생성합니다.
  • 02입력 이미지의 글자, 패턴, 머티리얼 경계를 보이는 표면에 유지합니다.
  • 03Interleaved Flow Transformer로 보이지 않는 영역의 텍스처를 완성합니다.
  • 04카메라, 전경 이미지, 머티리얼 맵을 제공하면 기존 메시에도 텍스처를 입힙니다.
  • 05로컬 Gradio 웹 앱과 명령줄 스크립트를 제공합니다.
  • 06선택적으로 텍스처를 다듬고 가림 경계를 위한 깊이 사전 필터를 적용할 수 있습니다.

활용 사례

  • 제품 사진이나 참조 사진에서 텍스처가 적용된 3D 소품 또는 에셋을 만듭니다.
  • 기하 구조와 카메라 데이터가 이미 있는 기존 메시에도 텍스처를 입힙니다.
  • 3D 엔진이나 렌더러에서 조명을 바꿔 렌더링할 PBR 에셋을 제작합니다.
  • 단일 NVIDIA GPU에서 이미지 기반 3D 생성을 실험합니다.

빠른 시작

  1. 1

    저장소를 클론합니다

    git clone https://github.com/Supra-3D/SUPRA-Tex.git
  2. 2

    활성화된 Conda 환경에 런타임을 설치합니다(Python 3.10, CUDA 12.4 및 nvcc 필요)

    python scripts/install_runtime.py --conda
  3. 3

    Hugging Face에 로그인하고 DINOv3 액세스 승인을 받은 다음 모델을 다운로드합니다

    python scripts/prepare_models.py
  4. 4

    함께 제공된 예제를 실행해 텍스처가 적용된 GLB를 생성합니다

    python scripts/run_example.py --output outputs/spiny_whelk_shell.glb

사용 전 알아둘 점

  • NVIDIA GPU와 CUDA 12.4 툴킷이 설치된 Linux가 필요합니다.
  • 이미지에서 3D를 생성하는 파이프라인은 DINOv3에 의존하며, Hugging Face에서 제한된 액세스 승인을 받아야 합니다.
  • 알파 채널이 없는 RGB 입력에는 RMBG-2 또는 BiRefNet도 필요합니다.

토픽

#3d-generation#pbr#texture-generation#mesh#image-to-3d#diffusion#cuda#3d#3dgeneration

자주 묻는 질문

SUPRA-Tex은(는) 무엇인가요?
단일 이미지에서 기본 색상, 금속도, 거칠기 맵을 포함한 텍스처 적용 및 조명 변경이 가능한 3D 에셋(GLB)을 생성하고, 기존 메시에도 텍스처를 입힙니다. SUPRA-Tex는 단일 이미지에서 물리 기반 렌더링(PBR) 머티리얼이 적용된 3D 에셋을 만듭니다. 참조 뷰에서 머티리얼을 예측한 뒤 표면에 정렬된 3D 관측값으로 인코딩하고, Interleaved Flow Transformer를 사용해 카메라에 보이지 않는 영역을 채웁니다. 입력 이미지의 글자, 패턴, 머티리얼 경계 같은 세부 요소를 보이는 표면에 유지하는 것이 목표입니다.
SUPRA-Tex은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
SUPRA-Tex은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
SUPRA-Tex은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. SUPRA-Tex의 마지막 커밋은 2026년 10월 29일입니다.
SUPRA-Tex은(는) 어디에 사용할 수 있나요?
제품 사진이나 참조 사진에서 텍스처가 적용된 3D 소품 또는 에셋을 만듭니다. 기하 구조와 카메라 데이터가 이미 있는 기존 메시에도 텍스처를 입힙니다. 3D 엔진이나 렌더러에서 조명을 바꿔 렌더링할 PBR 에셋을 제작합니다. 단일 NVIDIA GPU에서 이미지 기반 3D 생성을 실험합니다.
SUPRA-Tex는 어떻게 설치하나요?
저장소를 클론합니다: git clone https://github.com/Supra-3D/SUPRA-Tex.git 활성화된 Conda 환경에 런타임을 설치합니다(Python 3.10, CUDA 12.4 및 nvcc 필요): python scripts/install_runtime.py --conda Hugging Face에 로그인하고 DINOv3 액세스 승인을 받은 다음 모델을 다운로드합니다: python scripts/prepare_models.py 함께 제공된 예제를 실행해 텍스처가 적용된 GLB를 생성합니다: python scripts/run_example.py --output outputs/spiny_whelk_shell.glb
SUPRA-Tex은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/Supra-3D/SUPRA-Tex

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트