Skip to content
Peter Shinners edited this page Apr 13, 2021 · 7 revisions
void  getAssetIdForScope(const std::string& assetId, const std::string& scope,
        std::string& ret)
  • @param assetId Input asset id.
  • @param scope String specifying scope for result asset id, such as "name" or "version".
  • @param ret Set to result asset id.

Truncates an asset id to the given scope type.

Should return a more general asset reference to the given asset id. For instance, if scope is "name", returns an asset id that doesn't include a specific version number. This may not make sense in some asset systems, in which case, return the input asset id.

The scope string string specifies a scope for result asset id, such as "name" or "version".

This should return the full nid up to the requested scope.

For example:

getAssetIdForScope("mock://myShow/myShot/myName/myVersion", "shot")

Produces:

mock://myShow/myShot

The returned Asset ID no longer contains the name and version components. This is used by the assetAttr() built-in function that Python expressions have access to, and by Katana internally.

This is used by the "recent files" menu to collapse different version from the same element into a single entry. This string is then used for the load, so that the latest version is actually loaded. This will always use scope="name"

It is also used by look manager? This will always use scope="version".

Args: assetId (str) : String to evaluate scope (str) : scope for asset id

Returns: (str)