omni::connect::core::removeOrDeactivatePrim

Defined in omni/connect/core/StageAlgo.h

bool omni::connect::core::removeOrDeactivatePrim(pxr::UsdPrim prim)

Removes the given UsdPrim if it can be removed safely, otherwise deactivates it.

Multi-layer editing and Omniverse Live editing present challenges when trying to remove prims. We cannot always safely delete prims, sometimes they must must be deactivated instead. Use removeOrDeactivatePrim to attempt a full removal. If this is not possible, the prim will be deactivated, using an override on the current UsdEditTarget.

Parameters

prim – The prim to be removed.

Returns

A bool indicating if the process was successful.