---
title: RetargetingConfiguration
framework: realitykit
role: symbol
role_heading: Class
path: realitykit/retargetingconfiguration
---

# RetargetingConfiguration

A configuration for retargeting skeletal animations between different skeletons.

## Declaration

```swift
@MainActor class RetargetingConfiguration
```

## Overview

Overview RetargetingConfiguration enables the transfer of animations from one skeleton to another, automatically mapping joints and adapting poses to accommodate different skeletal structures. This is particularly useful for applying animations across different character models or creatures. Usage Create configurations using the static factory methods for common skeleton types: automatchBiped(_:to:jointOffsets:) for humanoid/bipedal characters automatchQuadruped(_:sourceTransform:to:targetTransform:jointOffsets:) for four-legged creatures Example do {     // Basic biped retargeting     let config = try RetargetingConfiguration.automatchBiped(         sourceCharacterSkeleton,         to: targetCharacterSkeleton     )

// With joint offset adjustments applied during configuration creation     let jointOffsets: [String: simd_quatf] = [         "LeftShoulder": simd_quatf(angle: 0.1, axis: simd_float3(0, 1, 0)),         "RightShoulder": simd_quatf(angle: -0.1, axis: simd_float3(0, 1, 0))     ]     let configWithOffsets = try RetargetingConfiguration.automatchBiped(         sourceCharacterSkeleton,         to: targetCharacterSkeleton,         jointOffsets: jointOffsets     ) } catch {     print("Failed to create retargeting configuration: \(error.localizedDescription)") } Performance Considerations Configuration creation is computationally expensive and should be cached when possible. The automatic matching algorithm analyzes skeleton hierarchies to establish joint correspondences. Joint offsets are baked into the configuration during creation, not applied at runtime.

## Topics

### Creating a configuration

- [automatchBiped(_:sourceTransform:to:targetTransform:jointOffsets:)](realitykit/retargetingconfiguration/automatchbiped(_:sourcetransform:to:targettransform:jointoffsets:).md)
- [automatchBiped(_:to:jointOffsets:)](realitykit/retargetingconfiguration/automatchbiped(_:to:jointoffsets:).md)
- [automatchQuadruped(_:sourceTransform:to:targetTransform:jointOffsets:)](realitykit/retargetingconfiguration/automatchquadruped(_:sourcetransform:to:targettransform:jointoffsets:).md)

### Accessing the skeletons

- [sourceSkeleton](realitykit/retargetingconfiguration/sourceskeleton.md)
- [targetSkeleton](realitykit/retargetingconfiguration/targetskeleton.md)

## Relationships

### Conforms To

- [Sendable](swift/sendable.md)
- [SendableMetatype](swift/sendablemetatype.md)

## See Also

### Skeletons and retargeting

- [SkeletonResource](realitykit/skeletonresource.md)