get_stage_next_free_path#

omni.fabric.commands.scripts.utils.get_stage_next_free_path(
stage: Stage,
path: str | Path,
prepend_default_prim: bool,
)#

Generates a unique path for a new prim on the given stage by incrementing a numerical suffix until a free path is found.

Parameters:

  • stage (usdrt.Usd.Stage) – The Fabric stage where the new prim path will be created.

  • path (Union[str, usdrt.Sdf.Path]) – The initial path for the new prim. If it’s a string, it should be a valid Fabric path.

  • prepend_default_prim (bool) – If True, the default prim’s path will be prepended to the generated path if the provided path is not already under the default prim.

Returns:

A unique string path that does not correspond to an existing prim on the stage.

Return type:

str

Raises:

ValueError – If the provided path is not a valid Fabric path string.

On this page