removeAllLabels#

Fully qualified name: isaacsim::foundation::utils::removeAllLabels

void isaacsim::foundation::utils::removeAllLabels(
const std::string &path,
bool removeTaxonomies = false,
bool includeDescendants = false,
)#

Removes all semantic labels from a prim.

Iterates over every SemanticsLabelsAPI instance applied to the prim at path and either clears the label list or removes the schema entirely, depending on removeTaxonomies.

When removeTaxonomies is false the semantics:labels:taxonomy attribute is set to an empty list but the SemanticsLabelsAPI schema remains applied. When removeTaxonomies is true the schema itself is removed from the prim via removeApi.

The applied-schema list is snapshotted before any modification to avoid iterator invalidation during schema removal.

See also

addLabels(), removeLabels()

Parameters:
  • path – [in] USD path of the target prim on the default stage.

  • removeTaxonomies – [in] When true, also removes the SemanticsLabelsAPI schema for each taxonomy. When false, only clears the label values.

  • includeDescendants – [in] When true, the operation is applied to all prims in the subtree rooted at path.