<!--
{
  "availability" : [
    "visionOS: 2.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "TabletopKit",
  "identifier" : "/documentation/TabletopKit/TossableRepresentation/cube(height:in:restitution:)",
  "metadataVersion" : "0.1.0",
  "role" : "Type Method",
  "symbol" : {
    "kind" : "Type Method",
    "modules" : [
      "TabletopKit"
    ],
    "preciseIdentifier" : "s:11TabletopKit22TossableRepresentationV4cube6height2in11restitutionACSf_So12NSUnitLengthCSfSgtFZ"
  },
  "title" : "cube(height:in:restitution:)"
}
-->

# cube(height:in:restitution:)

Creates a cube that the player tosses during gameplay.

```
static func cube(height: Float, in unit: UnitLength = .meters, restitution: Float? = nil) -> TossableRepresentation
```

## Parameters

`height`

The height of the cube.

`unit`

The unit of measurement for the height.

`restitution`

The coefficient of restitution, in the range [0, 1].

## Discussion

The vertices for the simulated cube are oriented with faces axis aligned.
In this orientation, the height (h) is measured from face to opposing face,
and the vertices have the following coordinates, which all lie on a
circumscribed sphere of radius r = h/2 ⋅ sqrt(3):
{ ±1, ±1, ±1 } ⋅ h/2 = { ±sqrt(3)/3, ±sqrt(3)/3, ±sqrt(3)/3 } ⋅ r

Higher restitution values indicate materials that conserve kinetic energy during collisions,
causing objects to bounce off each other elastically.
Lower values suggest materials that absorb kinetic energy, resulting in less bounce
and more energy loss upon impact.

---

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)