UsdUtils::DuplicatePrims

Navigation

API > API/Plugins > API/Plugins/USDUtilities

References

namespace UsdUtils  
{  
    TArray< UE::FSdfPath > UsdUtils&58;&58;DuplicatePrims  
    &40;  
        const TArray< UE::FUsdPrim > & Prims,  
        EUsdDuplicateType DuplicateType,  
        const UE::FSdfLayer & TargetLayer  
    &41;  
}  
Copy full snippet

namespace UsdUtils {     TArray< UE::FSdfPath > UsdUtils&58;&58;DuplicatePrims     &40;         const TArray< UE::FUsdPrim > & Prims,         EUsdDuplicateType DuplicateType,         const UE::FSdfLayer & TargetLayer     &41; }

Remarks

Duplicates all provided Prims one-by-one, performing the requested DuplicateType. See the documentation on EUsdDuplicateType for the different operation types.

The duplicated prims may be renamed in order to have valid names for the target location, which is why this function returns the pasted prim paths. This function returns just paths instead of actual prims because USD needs to respond to the notices about the created prim specs before the prims are fully created, which means we wouldn't be able to return the created prims yet, in case this function was called from within an SdfChangeBlock. Paths to the duplicated prim specs, after they were added as children of ParentPrim.

Parameters