<!--
{
  "availability" : [
    "iOS: 15.0.0 -",
    "iPadOS: 15.0.0 -",
    "macCatalyst: 15.0.0 -",
    "macOS: 12.0.0 -",
    "tvOS: 26.0.0 -",
    "visionOS: -"
  ],
  "documentType" : "symbol",
  "framework" : "RealityKit",
  "identifier" : "/documentation/RealityKit/BlendTreeBlendNode",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "RealityKit"
    ],
    "preciseIdentifier" : "s:17RealityFoundation09BlendTreeC4NodeV"
  },
  "title" : "BlendTreeBlendNode"
}
-->

# BlendTreeBlendNode

A source node for an animation that mixes several animations to form a
single animation.

```
struct BlendTreeBlendNode
```

## Overview

A *blend tree animation* mixes multiple animations to form a single
animation. The [`BlendTreeBlendNode`](/documentation/RealityKit/BlendTreeBlendNode) structure adopts the [`BlendTreeNode`](/documentation/RealityKit/BlendTreeNode)
protocol, which specifies the behavior of animations that make up a blend
tree animation. This structure adds the ability to branch a blend tree at
any point. Each member of this property’s [`sources`](/documentation/RealityKit/BlendTreeBlendNode/sources)
array represents a branch in the tree. For more information about blend
trees, see [`BlendTreeAnimation`](/documentation/RealityKit/BlendTreeAnimation).

## Topics

### Creating a blend-tree blend node

[`init(sources: [any BlendTreeNode], name: String, weight: BlendWeight, isAdditive: Bool)`](/documentation/RealityKit/BlendTreeBlendNode/init(sources:name:weight:isAdditive:))

Creates a tree node made up of multiple branches.

### Configuring the node

[`var name: String`](/documentation/RealityKit/BlendTreeBlendNode/name)

A textual name for the blend node.

[`var weight: BlendWeight`](/documentation/RealityKit/BlendTreeBlendNode/weight)

A normalized percentage that designates how much effect this node has
compared to peer nodes.

[`var isAdditive: Bool`](/documentation/RealityKit/BlendTreeBlendNode/isAdditive)

A Boolean value that indicates whether the animation builds on the
current state of the target entity or resets the state before running.

### Configuring child nodes

[`var sources: [any BlendTreeNode]`](/documentation/RealityKit/BlendTreeBlendNode/sources)

The nodes that branch from a node to form part of a blend tree.

## Relationships

### Conforms To

[`BlendTreeNode`](/documentation/RealityKit/BlendTreeNode)

---

Copyright &copy; 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)