<!--
{
  "availability" : [
    "iOS: 7.0.0 - 13.0.0",
    "iPadOS: 7.0.0 - 13.0.0",
    "macCatalyst: 13.1.0 - 13.1.0",
    "macOS: 10.9.0 - 10.15.0",
    "tvOS: 9.0.0 - 13.0.0",
    "visionOS: 1.0.0 - 1.0.0"
  ],
  "documentType" : "symbol",
  "framework" : "GameController",
  "identifier" : "/documentation/GameController/GCGamepadSnapshot",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "Game Controller"
    ],
    "preciseIdentifier" : "c:objc(cs)GCGamepadSnapshot"
  },
  "title" : "GCGamepadSnapshot"
}
-->

# GCGamepadSnapshot

A recording of all of the values provided by a [`GCGamepad`](/documentation/GameController/GCGamepad) object.

```
class GCGamepadSnapshot
```

## Overview

To create a gamepad snapshot, call the [`saveSnapshot()`](/documentation/GameController/GCGamepad/saveSnapshot()) method on a [`GCGamepad`](/documentation/GameController/GCGamepad) object. The [`GCGamepadSnapshot`](/documentation/GameController/GCGamepadSnapshot) class is a subclass of the [`GCGamepad`](/documentation/GameController/GCGamepad) class, so you use the parent class’s properties to read the individual element values. The snapshot is stored in a device independent format. To get the flattened data representation of the snapshot data, read the [`snapshotData`](/documentation/GameController/GCGamepadSnapshot/snapshotData) property.

## Topics

### Converting Between Snapshots and Data Objects

[`-  initWithSnapshotData:`](/documentation/GameController/GCGamepadSnapshot/init(snapshotData:))

Initializes a snapshot object with the flattened data representation obtained from another snapshot.

[`-  initWithController:snapshotData:`](/documentation/GameController/GCGamepadSnapshot/init(controller:snapshotData:))

Initializes a snapshot object associated with a specific controller using a flattened data representation obtained from another snapshot.

[`snapshotData`](/documentation/GameController/GCGamepadSnapshot/snapshotData)

The flattened control input values for the snapshot.

### Flattening a Snapshot to Memory

[`GCGamepadSnapShotDataV100`](/documentation/GameController/GCGamepadSnapShotDataV100)

A structure that holds a snapshot of a gamepad controller’s input data.

[`NSDataFromGCGamepadSnapShotDataV100`](/documentation/GameController/NSDataFromGCGamepadSnapShotDataV100(_:))

Encapsulates the controller data from a gamepad structure into a data object.

[`GCGamepadSnapShotDataV100FromNSData`](/documentation/GameController/GCGamepadSnapShotDataV100FromNSData(_:_:))

Copies the recorded data from a gamepad snapshot into a readable structure.

## Relationships

### Conforms To

[`CustomDebugStringConvertible`](/documentation/Swift/CustomDebugStringConvertible)

[`Equatable`](/documentation/Swift/Equatable)

[`NSObjectProtocol`](/documentation/ObjectiveC/NSObjectProtocol)

[`Hashable`](/documentation/Swift/Hashable)

[`CustomStringConvertible`](/documentation/Swift/CustomStringConvertible)

[`CVarArg`](/documentation/Swift/CVarArg)

### Inherits From

[`GCGamepad`](/documentation/GameController/GCGamepad)

---

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)