Tổng quan
TRELLIS.2 uses structured 3D latent representations to generate textured shapes. The repository includes the TRELLIS.2-4B checkpoint, an image-to-3D example and a separate path for texturing existing shapes. It can turn a concept image into an initial asset for inspection in a 3D editor. Game prototypes, product visualizations and research workflows should evaluate the exported geometry and materials against the target renderer’s requirements.
Tính năng chính
- Generates a 3D shape from a reference image.
- Uses a compact structured 3D representation.
- Targets objects with complex topology.
- Generates PBR materials and exports GLB assets.
- Includes a texturing example for existing shapes.
- Includes local web demos and training code.
Yêu cầu, cài đặt và bắt đầu nhanh
2. Run git clone -b main https://github.com/microsoft/TRELLIS.2.git --recursive.
3. Use setup.sh as documented to install the environment and required extensions.
4. Load Trellis2ImageTo3DPipeline from microsoft/TRELLIS.2-4B.
5. Follow example.py to generate a mesh from an image and export it as GLB.
6. Run python app.py for the image-to-3D interface; use example_texturing.py or app_texturing.py for texture workflows.
Cách sử dụng
Implementation notes
A single image does not reveal every surface, so inspect occluded geometry. Exported GLB files default to OPAQUE mode; assets containing alpha data may require material adjustments in the destination software.
Khả năng tương thích của mô hình và trường hợp sử dụng
Upstream currently documents testing on Linux and recommends CUDA 12.4. Some extensions need compilation. The stated 24GB hardware requirement does not eliminate memory differences between resolutions and tasks.
Ghi chú về giấy phép và rủi ro
The model and code use MIT. Dependencies including nvdiffrast and nvdiffrec have separate license terms.