{"id":23089724,"url":"https://github.com/mgthetrain/usd-experiments","last_synced_at":"2025-08-16T08:32:07.533Z","repository":{"id":267037083,"uuid":"900091977","full_name":"MGTheTrain/usd-experiments","owner":"MGTheTrain","description":"Experimenting with C++ libraries capable of parsing USD files","archived":false,"fork":false,"pushed_at":"2024-12-07T21:26:11.000Z","size":0,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-12-07T21:29:34.242Z","etag":null,"topics":["cpp","universal-scene-description","usda","usdc","usdz"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MGTheTrain.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-12-07T20:54:12.000Z","updated_at":"2024-12-07T21:26:15.000Z","dependencies_parsed_at":"2024-12-07T21:29:44.552Z","dependency_job_id":"07e27920-88b6-485b-9815-ae6f4508a7f5","html_url":"https://github.com/MGTheTrain/usd-experiments","commit_stats":null,"previous_names":["mgthetrain/usd-experiments"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MGTheTrain%2Fusd-experiments","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MGTheTrain%2Fusd-experiments/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MGTheTrain%2Fusd-experiments/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MGTheTrain%2Fusd-experiments/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MGTheTrain","download_url":"https://codeload.github.com/MGTheTrain/usd-experiments/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":230024262,"owners_count":18161290,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cpp","universal-scene-description","usda","usdc","usdz"],"created_at":"2024-12-16T20:39:39.455Z","updated_at":"2024-12-16T20:39:40.316Z","avatar_url":"https://github.com/MGTheTrain.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# usd-experiments\n\n## Table of Contents\n\n- [Summary](#summary)\n- [References](#references)\n- [Getting started](#getting-started)\n\n## Summary\n\nExperimenting with C++ libraries capable of parsing USD files\n\n## References\n\n- [USD file format](https://docs.fileformat.com/3d/usd/)\n- [OpenUSD Github repository](https://github.com/PixarAnimationStudios/OpenUSD)\n- [tinyusdz Github repository](https://github.com/lighttransport/tinyusdz/tree/dev)\n- [OpenUSD - Converting Between Layer Formats](https://openusd.org/docs/Converting-Between-Layer-Formats.html#ConvertingBetweenLayerFormats-Convertingbetween.usdaand.usdcFiles)\n- [Download Pre-Built OpenUSD Libraries and Tools](https://developer.nvidia.com/usd#section-getting-started)\n- [A really small getting-started project for USD based projects](https://github.com/meshula/tinyusd)\n- [OpenUSD sample files for download](https://openusd.org/release/dl_downloads.html)\n- [vcpkg issue](https://github.com/microsoft/vcpkg/issues/37947)\n\n## Getting started\n\n### Preconditions\n\n- Download and install [CMake from the official website](https://cmake.org/download/)  or trough a package manager\n- Install a C++ compiler on your operating system. For example, on Ubuntu Linux use `sudo apt install -y build-essential` to install the `gcc` and `g++` compilers; on Windows, the `cl.exe` compiler is included with the [Visual Studio IDE](https://visualstudio.microsoft.com/vs/); and on macOS, `clang` and `clang++` compilers are system binaries\n- Add git submodules: `git subdmodule update --init`\n\n### Generating USDA or USDC files from glTF files\n\nTo generate USD files from glTF files, you can either [download the pre-built OpenUSD libraries and tools](https://developer.nvidia.com/usd#section-getting-started) to use the `usdcat` CLI tool or build the project from GitHub. On macOS 12.0 (Monterey) and later, the pre-built OpenUSD CLI tools, including `usdcat`, should already be installed. The [data folder](data) can be utilized for storing USDA or USDC files. Example usage os `usdcat`:\n\n```sh\nusdcat \u003cpath to gltf file\u003e -o \u003cpath to usd file\u003e\n# e.g. usdcat third-party/glTF-Sample-Models/2.0/BrainStem/glTF/BrainStem.gltf -o data/BrainStem.usda\n# e.g. usdcat third-party/glTF-Sample-Models/2.0/BrainStem/glTF/BrainStem.gltf -o data/BrainStem.usdc\n```\n\n### Building application binaries\n\n#### Mac OS\n\nRun: \n\n```sh\n# INFO: Tested on macOS 15\n./third-party/vcpkg/bootstrap-vcpkg.sh\n./third-party/vcpkg/vcpkg install --allow-unsupported # Initially building USD can be time-consuming and resource-intensive. Packages persist in the vcpkg git submodule\n# Unable to use the `-DCMAKE_TOOLCHAIN_FILE` option because of build errors as the `--allow-unsupported` flag is not available in the subsequent `cmake` command\ncmake -B build -DCMAKE_BUILD_TYPE=Release .\ncmake --build build --parallel --config Release\n./build/apps/openusd-parser/openusd-parser \u003cpath to USDC or USDA file\u003e \u003cpath to output text file\u003e\n# e.g. ./build/apps/openusd-parser/openusd-parser data/BrainStem.usdc data/BrainStem.txt\n```\n\n#### Windows OS\n\nRun: \n\n```sh\n# INFO: Tested on Windows 10\n.\\third-party\\vcpkg\\bootstrap-vcpkg.bat\n.\\third-party\\vcpkg\\vcpkg install # Initially building USD can be time-consuming and resource-intensive. Packages persist in the vcpkg git submodule\ncmake -B build -DCMAKE_BUILD_TYPE=Release . \ncmake --build build --parallel --config Release\n.\\build\\apps\\openusd-parser\\Release\\openusd-parser \u003cpath to USDC or USDA file\u003e \u003cpath to output text file\u003e\n```\n\n#### Linux Ubuntu OS\n\nRun: \n\n```sh\n# INFO: Tested on Linux Ubuntu 20.04\n./third-party/vcpkg/bootstrap-vcpkg.sh\n./third-party/vcpkg/vcpkg install # Initially building USD can be time-consuming and resource-intensive. Packages persist in the vcpkg git submodule\ncmake -B build -DCMAKE_BUILD_TYPE=Release .\ncmake --build build --parallel --config Release\n./build/apps/openusd-parser/openusd-parser \u003cpath to USDC or USDA file\u003e \u003cpath to output text file\u003e\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmgthetrain%2Fusd-experiments","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmgthetrain%2Fusd-experiments","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmgthetrain%2Fusd-experiments/lists"}