Selection

class omni.usd.Selection

Bases: pybind11_object

omni.usd.Selection manages all stage selections and provides APIs for querying/setting selections.

Methods

__init__(*args, **kwargs)

clear_selected_prim_paths(self, source)

Clears all selections.

get_selected_prim_paths(self, source)

Gets selected prim paths.

is_prim_path_selected(self, path, source)

Checks if a prim is selected or not.

select_all_prims(self[, type_names])

Selects all prims with specific prim types.

select_inverted_prims(self)

Selects all prims without the current selections.

set_prim_path_selected(self, path, selected, ...)

Selects/Unselects single prim.

set_selected_prim_paths(self, paths, ...)

Sets selected prim paths.

__init__(*args, **kwargs)
class SourceType

Bases: pybind11_object

Selection source stage.

Members:

USD : Selections from native USD stage.

FABRIC : “Selections from Fabric.

ALL : Selections from both native USD stage and Fabric.

property name
clear_selected_prim_paths(self: omni.usd._usd.Selection, source: omni.usd._usd.Selection.SourceType = <SourceType.USD: 1>) bool

Clears all selections.

Parameters

source (omni.usd.Selection.SourceType) – The source to be cleared. Selections are stored differently for Fabric. By default, it will check selections from native USD stage.

get_selected_prim_paths(self: omni.usd._usd.Selection, source: omni.usd._usd.Selection.SourceType = <SourceType.USD: 1>) List[str]

Gets selected prim paths.

Parameters

source (omni.usd.Selection.SourceType) – The source to get selections. Selections are stored differently for Fabric. By default, it will check selections from native USD stage.

Returns

List of selected prim paths.

is_prim_path_selected(self: omni.usd._usd.Selection, path: str, source: omni.usd._usd.Selection.SourceType = <SourceType.USD: 1>) bool

Checks if a prim is selected or not.

Parameters
  • path (str) – Prim path to be checked.

  • source (omni.usd.Selection.SourceType) – The source to be checked. Selections are stored differently for Fabric. By default, it will check selections from native USD stage.

select_all_prims(self: omni.usd._usd.Selection, type_names: object = None) None

Selects all prims with specific prim types.

select_inverted_prims(self: omni.usd._usd.Selection) None

Selects all prims without the current selections.

set_prim_path_selected(self: omni.usd._usd.Selection, path: str, selected: bool, forcePrim: bool, clearSelected: bool, expandInStage: bool = True, source: omni.usd._usd.Selection.SourceType = <SourceType.USD: 1>) bool

Selects/Unselects single prim.

Parameters
  • path (str) – Prim path to be selected.

  • selected (bool) – Selected or unselected.

  • forcePrim (bool) – Force it to be Prim Mode. When this option is false, it depends on the selection mode to decide the prim to be selected.

  • clearSelected (bool) – Clears existing selections or not before selection.

  • expandInStage (bool) – DEPRECATED.

  • source (omni.usd.Selection.SourceType) – The source to be set. Selections are stored differently for Fabric. By default, it will check selections from native USD stage.

set_selected_prim_paths(self: omni.usd._usd.Selection, paths: List[str], expandInStage: bool = True, source: omni.usd._usd.Selection.SourceType = <SourceType.USD: 1>) bool

Sets selected prim paths.

Parameters
  • paths (List[str]) – The list of prim paths to be selected.

  • expandInStage (bool) – DEPRECATED.

  • source (omni.usd.Selection.SourceType) – The source to be set. Selections are stored differently for Fabric. By default, it will check selections from native USD stage.