README.md

Quick Reference

Auto-Add Stages To Cache

C++

auto cache = pxr::UsdStageCache {};

{
    pxr::UsdStageCacheContext context(cache);
    auto stage = pxr::UsdStage::CreateInMemory();
}

Python

cache = Usd.StageCache()

with Usd.StageCacheContext(cache):
    stage = Usd.Stage.CreateInMemory()

Explicitly-Add Stages To Cache

C++

auto stage = pxr::UsdStage::CreateInMemory();
auto cache = pxr::UsdStageCache {};
cache.Insert(stage);

Python

stage = Usd.Stage.CreateInMemory()
cache = Usd.StageCache()
cache.Insert(stage)

Get Stage From Singleton Cache

Python

def get_stage_from_id(stage_id):
    """Refer to the singleton UsdUtils cache to find a stage by-ID."""
    cache = UsdUtils.StageCache.Get()
    print('Found stage', cache.Find(stage_id))

See Also

https://graphics.pixar.com/usd/docs/api/class_usd_stage_cache.html

https://graphics.pixar.com/usd/docs/api/class_usd_stage_cache_context.html

https://graphics.pixar.com/usd/docs/api/class_usd_utils_stage_cache.html