gltf2usd项目常见问题解决方案

gltf2usd项目常见问题解决方案

gltf2usd command-line utility for converting glTF 2.0 models to USD 项目地址: https://gitcode.com/gh_mirrors/gl/gltf2usd

项目基础介绍

gltf2usd 是一个开源项目，它是一个命令行的Python脚本，主要用于将glTF 2.0模型转换为USD格式。这个工具的目的是实现从glTF到USD的简单管道转换，输出的格式包括usd、usda、usdc和usdz。该工具是一个概念验证，用于确定格式转换的细节，可能对实际的C++ USD插件开发有所帮助。它已经在Windows 10和Mac OS 10.14 Mojave Beta上开发并测试，使用的是USD v18.09和v18.11版本，并且是基于USD Python API构建的。

主要编程语言

• Python

新手常见问题及解决步骤

问题一：依赖环境配置问题

问题描述： 新手在尝试运行项目时，可能会遇到依赖环境配置错误，导致项目无法正常运行。

解决步骤：

1. 确保系统中已安装USD库。对于Linux用户，需要自行编译工具或者使用AnimalLogic的USD Docker容器（推荐给非CentOS用户）。macOS用户可以使用Apple的预构建USD工具包。
2. 将USD目录添加到PYTHONPATH中。对于macOS用户，可以通过运行预构建USD工具包中包含的path_to_usdpython/USD命令行命令来实现。
3. 使用pip install -r requirements.txt安装所需的Python依赖，包括Pillow（用于图像操作）和enum34（Python 2.7中的枚举模块）。

问题二：glTF文件格式支持问题

问题描述： 新手可能会尝试将不支持格式的glTF文件转换为USD，导致转换失败。

解决步骤：

1. 确保glTF文件遵循glTF 2.0核心规范。
2. 检查文件中是否使用了除PbrSpecularGlossiness和KHR_texture_transform之外的glTF扩展。如果使用，需要移除或替换这些扩展，因为当前工具版本不支持其他扩展。
3. 如果glTF文件包含非三角形的基本模式，需要将其转换为三角形模式，因为当前工具只支持三角形模式。

问题三：USD文件根节点缩放问题

问题描述： 新手可能会注意到在USD视图中glTF模型显得过小。

解决步骤：

1. 了解工具默认会将glTF模型的根节点缩放100倍，这是为了在使用ARKit时能够看到模型。
2. 如果需要调整缩放比例，可以在转换脚本中修改对应的缩放代码或转换后手动调整USD文件中的根节点缩放值。

通过以上步骤，新手可以避免在使用gltf2usd项目时遇到的一些常见问题，并能够顺利地使用该工具进行模型转换。

gltf2usd command-line utility for converting glTF 2.0 models to USD 项目地址: https://gitcode.com/gh_mirrors/gl/gltf2usd