<!--
{
  "availability" : [
    "iOS: 27.0.0 -",
    "iPadOS: 27.0.0 -",
    "macCatalyst: 27.0.0 -",
    "macOS: 27.0.0 -",
    "tvOS: 27.0.0 -",
    "visionOS: 27.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "USDKit",
  "identifier" : "/documentation/USDKit/USDPlayer/FrameUpdate",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "USDKit",
      "RealityKit"
    ],
    "preciseIdentifier" : "s:18_USDKit_RealityKit9USDPlayerC11FrameUpdateV"
  },
  "title" : "USDPlayer.FrameUpdate"
}
-->

# USDPlayer.FrameUpdate

A snapshot of all mesh, material, texture, and deformation changes from the last update.

```
struct FrameUpdate
```

## Topics

### Instance Properties

[`let deformationAdditions: [USDPlayer.DeformationID]`](/documentation/USDKit/USDPlayer/FrameUpdate/deformationAdditions)

IDs of newly added deformation resources.

[`let deformationRemovals: [USDPlayer.DeformationID]`](/documentation/USDKit/USDPlayer/FrameUpdate/deformationRemovals)

IDs of deformation resources removed this frame.

[`let deformationUpdates: [USDPlayer.DeformationID]`](/documentation/USDKit/USDPlayer/FrameUpdate/deformationUpdates)

IDs of deformation resources with delta changes this frame.

[`let errors: [USDRenderError]`](/documentation/USDKit/USDPlayer/FrameUpdate/errors)

Errors encountered during this update.

[`let materialAdditions: [USDPlayer.MaterialID]`](/documentation/USDKit/USDPlayer/FrameUpdate/materialAdditions)

IDs of newly added materials.

[`let materialRemovals: [USDPlayer.MaterialID]`](/documentation/USDKit/USDPlayer/FrameUpdate/materialRemovals)

IDs of materials removed this frame.

[`let materialUpdates: [USDPlayer.MaterialID]`](/documentation/USDKit/USDPlayer/FrameUpdate/materialUpdates)

IDs of materials with delta changes this frame.

[`let meshAdditions: [USDPlayer.MeshID]`](/documentation/USDKit/USDPlayer/FrameUpdate/meshAdditions)

IDs of newly added meshes.

[`let meshRemovals: [USDPlayer.MeshID]`](/documentation/USDKit/USDPlayer/FrameUpdate/meshRemovals)

IDs of meshes removed this frame.

[`let meshUpdates: [USDPlayer.MeshID]`](/documentation/USDKit/USDPlayer/FrameUpdate/meshUpdates)

IDs of meshes with delta changes this frame.

[`let textureAdditions: [USDPlayer.TextureID]`](/documentation/USDKit/USDPlayer/FrameUpdate/textureAdditions)

IDs of newly added texture assets.

[`let textureRemovals: [USDPlayer.TextureID]`](/documentation/USDKit/USDPlayer/FrameUpdate/textureRemovals)

IDs of texture assets removed this frame.

[`let timeCode: USDStage.TimeCode`](/documentation/USDKit/USDPlayer/FrameUpdate/timeCode)

The USD time code this update corresponds to.

### Instance Methods

[`func takeDeformationAddition(id: USDPlayer.DeformationID) -> USDPlayer.DeformationData?`](/documentation/USDKit/USDPlayer/FrameUpdate/takeDeformationAddition(id:))

Consumes and returns the [`USDPlayer.DeformationData`](/documentation/USDKit/USDPlayer/DeformationData) for the given deformation addition.

[`func takeDeformationUpdate(id: USDPlayer.DeformationID) -> USDPlayer.DeformationData.Update?`](/documentation/USDKit/USDPlayer/FrameUpdate/takeDeformationUpdate(id:))

Consumes and returns the [`USDPlayer.DeformationData.Update`](/documentation/USDKit/USDPlayer/DeformationData/Update) for the given deformation delta update.

[`func takeMaterialAddition(id: USDPlayer.MaterialID) -> USDPlayer.MaterialData?`](/documentation/USDKit/USDPlayer/FrameUpdate/takeMaterialAddition(id:))

Consumes and returns the [`USDPlayer.MaterialData`](/documentation/USDKit/USDPlayer/MaterialData) for the given material addition.

[`func takeMaterialUpdate(id: USDPlayer.MaterialID) -> USDPlayer.MaterialData.Update?`](/documentation/USDKit/USDPlayer/FrameUpdate/takeMaterialUpdate(id:))

Consumes and returns the [`USDPlayer.MaterialData.Update`](/documentation/USDKit/USDPlayer/MaterialData/Update) for the given material delta update.

[`func takeMeshAddition(id: USDPlayer.MeshID) -> USDPlayer.MeshData?`](/documentation/USDKit/USDPlayer/FrameUpdate/takeMeshAddition(id:))

Consumes and returns the [`USDPlayer.MeshData`](/documentation/USDKit/USDPlayer/MeshData) for the given mesh addition.

[`func takeMeshUpdate(id: USDPlayer.MeshID) -> USDPlayer.MeshData.Update?`](/documentation/USDKit/USDPlayer/FrameUpdate/takeMeshUpdate(id:))

Consumes and returns the [`USDPlayer.MeshData.Update`](/documentation/USDKit/USDPlayer/MeshData/Update) for the given mesh delta update.

[`func takeTextureAddition(id: USDPlayer.TextureID) -> USDPlayer.TextureData?`](/documentation/USDKit/USDPlayer/FrameUpdate/takeTextureAddition(id:))

Consumes and returns the [`USDPlayer.TextureData`](/documentation/USDKit/USDPlayer/TextureData) for the given texture addition.

---

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)