Sdf Plugin

November 16, 2025 ยท View on GitHub

Sdf plugins allow OpenUSD to transparently read and write foreign file formats. guc comes with its own plugin, usdGlTF, which needs to be enabled with the GUC_BUILD_USDGLTF CMake option.

After building, the plugin has to be copied to the USD installation tree:

cmake --install . --component usdGlTF --config Release --prefix <USD_INSTALL_DIR>/plugin/usd

Following file format arguments are exposed:

NameTypeDefault Value
emitMtlxboolfalse
skipValidationboolfalse

Transparent file I/O

With the plugin installed, glTF files can be opened with USD tooling such as usdview and usdcat.

Arguments may be encoded into the path as follows: usdview Asset.gltf:SDF_FORMAT_ARGS:emitMtlx=true

Composition arcs

glTF files can further be referenced by USD layers, optionally with arguments, as documented in Dynamic File Formats.

#usda 1.0

def "Root" (
    references = </Params>
    payload = @./Asset.gltf@
)
{
}

def "Params" (
    emitMtlx = 1
)
{
}