# extractRootMotion(jointName:options:lockPosition:) Extracts root motion from the specified joint. ``` static func extractRootMotion(jointName: String, options: SampledAnimation.SkeletalAnimationOperation.RootMotionOptions = .translationXZ, lockPosition: Transform? = nil) -> SampledAnimation.SkeletalAnimationOperation ``` ## Parameters `jointName` Name of the joint to extract root motion from. `options` Transform components to extract. `lockPosition` Position to lock the root joint to after extraction. ## Return Value A [`SampledAnimation.SkeletalAnimationOperation`](/documentation/RealityKit/SampledAnimation/SkeletalAnimationOperation) that, when processed, produces an [`AnimationGroup`](/documentation/RealityKit/AnimationGroup) containing both the modified skeletal animation and the extracted transform sampled animation used for root motion. ## Discussion Removes the specified transform components from the joint and returns them as a separate `SampledAnimation` in the resulting [`AnimationGroup`](/documentation/RealityKit/AnimationGroup). The skeletal animation will have the extracted motion removed. The returned `SampledAnimation` has [`bindTarget`](/documentation/RealityKit/SampledAnimation/bindTarget) set to [`BindTarget.rootMotion`](/documentation/RealityKit/BindTarget/rootMotion) automatically — playing the group drives the entity’s root motion and emits [`AnimationEvents.RootMotionDidUpdate`](/documentation/RealityKit/AnimationEvents/RootMotionDidUpdate) events. When you extract root motion, the function returns an [`AnimationGroup`](/documentation/RealityKit/AnimationGroup) containing both the skeletal animation and the root motion animation. Playing back this group triggers root motion events in sync with the skeletal animation. The event callback receives the delta transform moved between the last frame and the current frame. If no event handler subscribes to the root motion on the target entity, the system automatically applies the delta to the entity’s transform. --- Copyright © 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)