Pixar has a tutorial for Generating New Schema Classes. The tutorial goes into great detail about the formatting and specifics about the schema.usda but the tutorial fails to mention 2 important points:
- Its instructions assume that you are building into the USD source tree. Pipelines rarely do this. The tutorial probably did this for simplicity but it leaves a lot to be desired.
- The tutorial doesn't cover how Python bindings are created (spoiler: You need to manually write a couple files that usdGenSchema doesn't create for you!)
This project implements a "real-world setup" using Pixar's tutorial as its base.
First, compile the plugin with the compiling_the_schema. compiling_the_schema creates the SimplePrim, ComplexPrim, and ParamsAPI schemas. Technically this is all you really need to do but it's a good idea to run your compiled code against a C++ / Python project to make sure everything is working okay.
The other folders, testing_the_compiled_schema_cpp and testing_the_compiled_schema_python , are test projects that include the custom schemas that you would have just built. These can be used to show how to include the schemas and also check to make sure nothing broke in the process.
RodeoFX's Replace Resolver Plugin
USD's Custom Schema Class Tutorial
A helpful hint that usdGenSchema doesn't make every required file (module.cpp / moduleDeps.cpp)
USDResearch Repository. It's written in Japanese but was still useful