unisim.backend.isaacsim.raw_usd_cache.RoleUSDCache

class unisim.backend.isaacsim.raw_usd_cache.RoleUSDCache[source]

Bases: RawUSDCache

Publish immutable role-derived USD using the complete-entry protocol.

A role request’s identity already includes its raw artifact identity and fingerprint plus collision/visual/mirror/bake parameters. A miss copies and bakes the raw artifact inside staging; a hit is inventory-validated and must never be mutated by native materialization or role inspection.

Parameters:

root (Path)

Methods

__init__(root)

copy_artifact(record, destination)

Copy one validated immutable artifact for mutable downstream baking.

load(identity)

Return one validated entry, or None for any miss/corruption.

materialize(request, convert)

Return a validated entry, converting and publishing only on a miss.
__init__(root)
Parameters:

root (Path)

copy_artifact(record, destination)

Copy one validated immutable artifact for mutable downstream baking.

Parameters:
Return type:

Path

load(identity)

Return one validated entry, or None for any miss/corruption.

Parameters:

identity (str)

Return type:

RawUSDCacheRecord | None

materialize(request, convert)

Return a validated entry, converting and publishing only on a miss.

Parameters:
Return type:

RawUSDCacheResult