base on Universal Scene Description Universal Scene Description =========================== Universal Scene Description (USD) is an efficient, scalable system for authoring, reading, and streaming time-sampled scene description for interchange between graphics applications. For more details, please visit the web site [here](http://openusd.org). Build Status ------------ | | Status | |:-------:|:---------:| | dev | [![BuildUSD](https://github.com/PixarAnimationStudios/OpenUSD/actions/workflows/buildusd.yml/badge.svg?branch=dev)](https://github.com/PixarAnimationStudios/OpenUSD/actions/workflows/buildusd.yml) | | release | [![BuildUSD](https://github.com/PixarAnimationStudios/OpenUSD/actions/workflows/buildusd.yml/badge.svg?branch=release)](https://github.com/PixarAnimationStudios/OpenUSD/actions/workflows/buildusd.yml) | Additional Documentation ------------------------ * [User Documentation and Tutorials](http://openusd.org/docs/index.html) * [API Documentation](http://openusd.org/docs/api/index.html) * [Advanced Build Configuration](BUILDING.md) Getting Help ------------ Need help understanding certain concepts in USD? See [Getting Help with USD](http://openusd.org/docs/Getting-Help-with-USD.html) or visit our [forum](https://groups.google.com/forum/#!forum/usd-interest). If you are experiencing undocumented problems with the software, please [file a bug](https://github.com/PixarAnimationStudios/OpenUSD/issues/new). If you need to report a security issue with the software, please review the [Security Policy](SECURITY.md). Supported Platforms ------------------- USD is primarily developed on Linux platforms (CentOS 7), but is built, tested and supported on macOS and Windows. It is also possible to build USD libraries that can be embedded in iOS and visionOS apps. Please see [VERSIONS.md](VERSIONS.md) for explicitly tested versions. Dependencies ------------ Required: - C/C++ compiler - [CMake](https://cmake.org/documentation/) - [Intel TBB](https://www.threadingbuildingblocks.org/) See [3rd Party Library and Application Versions](VERSIONS.md) for version information. Additional dependencies are required for the following components. These components may be disabled at build-time. For further details see [Advanced Build Configuration](BUILDING.md). **Imaging and USD Imaging** Required: - [OpenSubdiv](https://github.com/PixarAnimationStudios/OpenSubdiv) Optional: - [OpenEXR](http://www.openexr.com) - [OpenImageIO](https://sites.google.com/site/openimageio/home) - [OpenColorIO](http://opencolorio.org/) - [OSL (OpenShadingLanguage)](https://github.com/imageworks/OpenShadingLanguage) - [Ptex](http://ptex.us/) **Python Bindings** Required: - [Python](https://python.org) **usdview** Required: - Python bindings - [PySide6](http://wiki.qt.io/PySide6) or [PySide2](http://wiki.qt.io/PySide2) - [PyOpenGL](https://pypi.python.org/pypi/PyOpenGL/) Getting and Building the Code ----------------------------- The simplest way to build USD is to run the supplied `build_usd.py` script. This script will download required dependencies and build and install them along with USD in a given directory. Follow the instructions below to run the script with its default behavior, which will build the USD core libraries, Imaging, and USD Imaging components. For more options and documentation, run the script with the `--help` parameter. See [Advanced Build Configuration](BUILDING.md) for examples and additional documentation for running cmake directly. #### 1. Install prerequisites (see [Dependencies](#dependencies) for required versions) - Required: - C++ compiler: - gcc - Xcode - Microsoft Visual Studio - CMake - Optional (Can be ignored by passing `--no-python` as an argument to `build_usd.py`) - Python (required for [bindings and tests](BUILDING.md#python)) - PyOpenGL (required for [usdview](BUILDING.md#usd-imaging)) - PySide6 or PySide2 (required for [usdview](BUILDING.md#usd-imaging)) #### 2. Download the USD source code You can download source code archives from [GitHub](https://www.github.com/PixarAnimationStudios/OpenUSD) or use `git` to clone the repository. ``` > git clone https://github.com/PixarAnimationStudios/OpenUSD Cloning into 'OpenUSD'... ``` #### 3. Run the script Run the build_usd.py script to build and install USD. Note that the build script is structured with an out-of-source build in mind -- installing a build into the directory where the repository was cloned is untested. ##### Linux: For example, the following will download, build, and install USD's dependencies, then build and install USD into `/path/to/my_usd_install_dir`. ``` > python OpenUSD/build_scripts/build_usd.py /path/to/my_usd_install_dir ``` ##### macOS: In a terminal, run `xcode-select` to ensure command line developer tools are installed. Then run the script. For example, the following will download, build, and install USD's dependencies, then build and install USD into `/path/to/my_usd_install_dir`. ``` > python OpenUSD/build_scripts/build_usd.py /path/to/my_usd_install_dir ``` ##### iOS and visionOS: When building from a macOS system, you can cross compile for iOS based platforms. Cross compilation builds are restricted to building libraries that can be embedded in applications built for the target platform. It can be helpful to use a monolithic build when embedding USD (see [Advanced Build Configuration](BUILDING.md)). These builds do not support Python bindings or command line tools. For example, the following will download, build, and install USD's dependencies, then build and install USD for iOS into `/path/to/my_usd_install_dir`. ``` > python OpenUSD/build_scripts/build_usd.py --build-target iOS --build-monolithic /path/to/my_usd_install_dir ``` Or for visionOS: ``` > python OpenUSD/build_scripts/build_usd.py --build-target visionOS --build-monolithic /path/to/my_usd_install_dir ``` ##### Windows: On Windows, it is possible to compile for either x64, or ARM64. **Note**: ARM64EC is not compatible at this time. **Note 2**: usdview is not supported on ARM64 at present, due to lack of PySide Launch the "x64 Native Tools Command Prompt" (or "ARM64 Native Tools Command Prompt" where appropriate) for your version of Visual Studio, and run the script in the opened shell. Make sure to use the appropriate version of the command prompt (e.g. on x64, use the x64 version, not the x86 version). See https://docs.microsoft.com/en-us/cpp/build/how-to-enable-a-64-bit-visual-cpp-toolset-on-the-command-line for more details. For example, the following will download, build, and install USD's dependencies, then build and install USD into `C:\path\to\my_usd_install_dir`. ``` C:\> python OpenUSD\build_scripts\build_usd.py "C:\path\to\my_usd_install_dir" ``` #### 4. Try it out Set the environment variables specified by the script when it finishes and launch `usdview` with a sample asset. ``` > usdview OpenUSD/extras/usd/tutorials/convertingLayerFormats/Sphere.usda ``` Contributing ------------ If you'd like to contribute to USD (and we appreciate the help!), please see the [Contributing](http://openusd.org/docs/Contributing-to-USD.html) page in the documentation for more information. ", Assign "at most 3 tags" to the expected json: {"id":"460","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"