Skip to content

command-line utility for converting glTF 2.0 models to USD

License

Notifications You must be signed in to change notification settings

kcoley/gltf2usd

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

74 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

gltf2usd

This tool is a command-line Python script which converts glTF 2.0 models to USD, with the goal being simple pipeline conversion from glTF to usd, usda, usdc, or usdz.

The tool is a proof-of-concept, to determine format conversion details, which could be useful for an actual C++ USD plugin. It has been developed and tested on both Windows 10 and Mac OS 10.14 Mojave Beta, using USD v18.09 and v18.11, and is built against the USD Python API.

This tool currently only works on glTF 2.0 files, based on the core glTF 2.0 specification (no extensions except PbrSpecularGlossiness and KHR_texture_transform).

Supported Features

  • glTF nodes are mapped to USD Xform
  • glTF PbrMetallicRoughnessMaterial is mapped to USDPreviewSurface
  • glTF KHR_materials_pbrSpecularGlossiness extension
  • glTF KHR_texture_transform extension (new textures are generated at the expense of a longer export time)
  • glTF Skeletal animation is mapped to UsdSkel
  • glTF node animations are supported
  • Currently supports .gltf conversion to .usd, .usda, .usdc, and .usdz

Currently not implemented:

  • .glb files
  • glTF extensions (except KHR_materials_pbrSpecularGlossiness and KHR_texture_transform)
  • Primitive modes (other than triangles)

Note:

  • The root node of the generated USD file is, by default, scaled by 100 to convert from glTF's meters to USD's centimeters. This scale is purely to be able to see the glTF models when using ARKit, or otherwise, they are too small.
  • There are several edge cases that have not been fully tested yet

Dependencies:

  • You will need to initially have USD v18.09 or v18.11 installed on your system and have the Python modules built
    • Linux users will need to build the tools themselves, or use AnimalLogic's USD Docker Container (recommended for non-CentOS users)
    • macOS users can use Apple's Prebuilt USD Toolkit. Make sure you add the USD dir to your PYTHONPATH (an easy way to do this is to run the path_to_usdpython/USD.command shell command included with the prebuilt USD Toolkit).

Python dependencies

You can install the following python dependencies using pip install -r requirements.txt:

  • Pillow (Python module for image manipulation)
  • enum34 (Python module for enums in Python 2.7)

Help Menu:

python gltf2usd.py -h
usage: gltf2usd.py [-h] --gltf GLTF_FILE [--fps FPS] --output USD_FILE
                   [--scale] [--verbose] [--arkit]

Convert glTF to USD

optional arguments:
  -h, --help            show this help message and exit
  --gltf GLTF_FILE, -g GLTF_FILE
                        glTF file (in .gltf format)
  --fps FPS             The frames per second for the animations (defaults to 24 fps)
  --output USD_FILE, -o USD_FILE
                        destination to store generated .usda file
  --scale SCALE, -s     Scale the resulting USDA model
  --verbose, -v         Enable verbose mode
  --arkit               Check USD with ARKit compatibility before making USDZ
                        file
  --use-euler-rotation  sets euler rotations for node animations instead of
                        quaternion rotations
  --optimize-textures   Specifies if image file size should be optimized and
                        reduced at the expense of longer export time
  --generate_texture_transform_texture
                        Enables texture transform texture generation
  --no-generate_texture_transform_texture
                        Disables texture transform texture generation

Sample usage:

Create a .usda file

python gltf2usd.py -g ../path_to_read_glTF_file/file.gltf -o path_to_write_usd_file/file.usda

Create a .usdz file

python gltf2usd.py -g ../path_to_read_glTF_file/file.gltf -o path_to_write_usd_file/file.usdz

About

command-line utility for converting glTF 2.0 models to USD

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages