Repolode
投稿する
Supra-3D

Supra-3D/SUPRA-Tex

1枚の画像からベースカラー、メタリック、ラフネスのマップを備えた、再ライティング可能なテクスチャ付き3Dアセット（GLB）を生成し、既存メッシュへのテクスチャ適用にも対応します。

GitHub で見る公式サイト
スター
699
フォーク
35
未解決の Issue
4
最終コミット
9 日前

これは何？

SUPRA-Texは、1枚の画像から物理ベースレンダリング（PBR）マテリアルを持つ3Dアセットを生成します。参照画像の視点でマテリアルを推定し、表面に沿った3D観測データとしてエンコードしたうえで、Interleaved Flow Transformerを使ってカメラから見えない領域を補完します。文字や模様、マテリアルの境界といった入力画像の細かなディテールを、見える表面に保つことを目指しています。

出力はベースカラー、メタリック、ラフネスのテクスチャを含むGLBファイルで、新しいライティング環境でレンダリングできます。画像からの3D生成に加え、カメラ、前景画像、参照視点のマテリアルマップを指定すれば、同じパイプラインで既存メッシュにもテクスチャを適用できます。デュアルビュー モードでは生成した背面画像を追加し、見えない側も画像に沿って仕上げられます。

利用にはLinux、NVIDIA GPU、CUDA 12.4が必要です。ローカルで動作するGradio Webアプリとコマンドラインスクリプトが含まれています。DINOv3やRMBG-2など、一部のパイプラインモデルを使うには、Hugging Faceで別途アクセス承認が必要です。

主な機能

  • 01ベースカラー、メタリック、ラフネスのテクスチャを備えたGLBアセットを生成します。
  • 02入力画像に含まれる文字、模様、マテリアルの境界を、見える表面に保ちます。
  • 03Interleaved Flow Transformerで、見えない領域のテクスチャを補完します。
  • 04カメラ、前景画像、マテリアルマップを指定して、既存メッシュにテクスチャを適用します。
  • 05ローカルで動作するGradio Webアプリとコマンドラインスクリプトを備えています。
  • 06任意で使えるテクスチャのリファイン機能と、オクルージョン境界向けの深度プリフィルターを提供します。

ユースケース

  • 製品写真や参考画像から、テクスチャ付きの3D小物やアセットを作成する。
  • 形状とカメラデータがすでにある既存メッシュにテクスチャを適用する。
  • 3Dエンジンやレンダラーで再ライティングするPBRアセットを作成する。
  • NVIDIA GPU 1台で画像からの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 Toolkitを備えたLinuxが必要です。
  • 画像から3Dを生成するパイプラインはDINOv3に依存しており、Hugging Faceで制限付きアクセスの承認が必要です。
  • アルファチャンネルのないRGB入力には、RMBG-2またはBiRefNetも必要です。

トピック

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

よくある質問

SUPRA-Tex とは？
1枚の画像からベースカラー、メタリック、ラフネスのマップを備えた、再ライティング可能なテクスチャ付き3Dアセット（GLB）を生成し、既存メッシュへのテクスチャ適用にも対応します。 SUPRA-Texは、1枚の画像から物理ベースレンダリング（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 1台で画像からの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 の数値は毎日更新されます。

関連プロジェクト