SamusAranX / USDConverter

A USDZ-to-OBJ converter powered by Model I/O
MIT License
51 stars 15 forks source link
3d-models command-line converter usdz wavefront-obj

USDConverter

A USDZ-to-OBJ converter powered by Model I/O

NOTE: This tool was developed out of a need to use static USDZ models in Blender. (see below for a matching import addon)\ Now that Blender directly supports importing USD* files, I'm stopping work on this.\ The last update, v1.7, fixes a crash bug. Beyond that, barring some unforeseen changes to either Model I/O or the USD specs, this tool should keep working forever.

Usage

  1. Download the latest source code archive and compile the project.
  2. Move the usdconv binary somewhere into your PATH or into the same directory as the USDZ files you want to convert.
  3. Execute it from the terminal like this:
usdconv model1.usdz

You can also convert multiple files in one go by simply specifying more files:

usdconv model1.usdz model2.usdz model3.usdz

Options

-v, --version           Show the version number and exit.
--png                   Convert all texture formats to PNG.
--force                 Try to force conversion, even if the input format is unsupported.
--include-garbage       Keep initial files generated by Model I/O.
-h, --help              Show help information.

With no options specified, running usdconv model.usdz will output these files and directories:

The --include-garbage and --force options are mainly for debugging:

Using Blender?

Check out my alternate OBJ importer with support for the additional PBR MTL directives added by this tool: io_scene_obj_modelio