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
SemanticsLabelsAPIinstance applied to the prim atpathand either clears the label list or removes the schema entirely, depending onremoveTaxonomies.When
removeTaxonomiesisfalsethesemantics:labels:taxonomyattribute is set to an empty list but theSemanticsLabelsAPIschema remains applied. WhenremoveTaxonomiesistruethe schema itself is removed from the prim viaremoveApi.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 theSemanticsLabelsAPIschema for each taxonomy. Whenfalse, only clears the label values.includeDescendants – [in] When
true, the operation is applied to all prims in the subtree rooted atpath.