USD Viewer安装与配置指南

USD Viewer安装与配置指南

1. 项目基础介绍

USD Viewer是一个基于Web的USD（Universal Scene Description）文件查看器。它允许用户在网页浏览器中查看USDZ文件和文件夹。该项目主要用于展示和查看3D场景数据，主要编程语言为JavaScript。

2. 关键技术和框架

• USD WASM Bindings：由Autodesk提供，将USD的功能通过WebAssembly（WASM）暴露给Web应用。
• Three.js：一个基于WebGL的JavaScript库，用于在浏览器中创建和显示3D图形。
• Hydra：Autodesk的一种渲染技术，用于将USD场景渲染到Web浏览器中。

3. 安装和配置

准备工作

在开始安装之前，确保您的系统中已经安装以下工具：

• Node.js：用于运行npm（Node包管理器）。
• Git：用于克隆和更新项目代码。
• CMake：用于构建USD的本地构建系统。
• Emscripten：用于将C++代码编译为WebAssembly。

安装步骤

1. 克隆项目到本地目录：

   git clone https://github.com/needle-tools/usd-viewer.git
   cd usd-viewer
   

2. 安装项目依赖：

   npm install
   

3. 设置Emscripten环境：

   根据您的操作系统，下载并安装Emscripten SDK。然后，激活SDK：

   • MacOS：

     ./emsdk install 3.1.55
     ./emsdk activate 3.1.55
     source ./emsdk_env.sh
     

   • Windows：

     emsdk install 3.1.55
     emsdk activate 3.1.55
     

4. 下载和构建USD：

   • 从Autodesk的USD仓库克隆代码：

     git clone --recursive https://git.autodesk.com/autodesk-forks/usd/tree/adsk/feature/webgpu
     cd usd_repo
     

   • 构建USD：

     python3 ./build_scripts/build_usd.py --build-target wasm ../build_dir
     

   构建完成后，会在../build_dir/bin目录下生成相关文件。

5. 优化WebAssembly文件：

   wasm-opt -Oz -o "../build_dir/bin/emHdBindings.wasm" "../build_dir/bin/emHdBindings.wasm" --enable-bulk-memory --enable-threads
   

6. 应用补丁：

   根据项目指南，对emHdBindings.js应用必要的补丁。

7. 运行USD Viewer：

   npm run start
   

   在浏览器中打开http://localhost:<port>，即可查看USD Viewer。

按照以上步骤操作，您应该能够成功安装和配置USD Viewer。如果在安装过程中遇到任何问题，请查看项目文档或向社区寻求帮助。