<!--
{
  "availability" : [
    "visionOS: 2.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "TabletopKit",
  "identifier" : "/documentation/TabletopKit/TossableRepresentation",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "TabletopKit"
    ],
    "preciseIdentifier" : "s:11TabletopKit22TossableRepresentationV"
  },
  "title" : "TossableRepresentation"
}
-->

# TossableRepresentation

An object that represents geometric shapes that the player can throw
during gameplay, such as dice.

```
struct TossableRepresentation
```

## Topics

### Creating geometric shapes

[`static func cube(height: Float, in: UnitLength, restitution: Float?) -> TossableRepresentation`](/documentation/TabletopKit/TossableRepresentation/cube(height:in:restitution:))

Creates a cube that the player tosses during gameplay.

[`static func decahedron(height: Float, in: UnitLength, restitution: Float?) -> TossableRepresentation`](/documentation/TabletopKit/TossableRepresentation/decahedron(height:in:restitution:))

Creates a decahedron, a symmetrical, ten-faced polyhedron with kite-shaped faces,
that the player tosses during gameplay.

[`static func dodecahedron(height: Float, in: UnitLength, restitution: Float?) -> TossableRepresentation`](/documentation/TabletopKit/TossableRepresentation/dodecahedron(height:in:restitution:))

Creates a regular dodecahedron, a shape with 12 pentagonal faces,
that the player tosses during gameplay.

[`static func icosahedron(height: Float, in: UnitLength, restitution: Float?) -> TossableRepresentation`](/documentation/TabletopKit/TossableRepresentation/icosahedron(height:in:restitution:))

Creates a regular icosahedron, a shape with 20 triangular faces,
that the player tosses during gameplay.

[`static func octahedron(height: Float, in: UnitLength, restitution: Float?) -> TossableRepresentation`](/documentation/TabletopKit/TossableRepresentation/octahedron(height:in:restitution:))

Creates a regular octahedron, a shape with 8 triangular faces,
that the player tosses during gameplay.

[`static func sphere(radius: Float, in: UnitLength, restitution: Float?) -> TossableRepresentation`](/documentation/TabletopKit/TossableRepresentation/sphere(radius:in:restitution:))

Creates a sphere with the specified radius that the player tosses during gameplay.

[`static func tetrahedron(height: Float, in: UnitLength, restitution: Float?) -> TossableRepresentation`](/documentation/TabletopKit/TossableRepresentation/tetrahedron(height:in:restitution:))

Creates a regular tetrahedron, a pyramid with four triangular faces,
that the player tosses during gameplay.

### Getting the face

[`func face(for: Rotation3D) -> any TossableRepresentation.TossableFace`](/documentation/TabletopKit/TossableRepresentation/face(for:))

For the shape corresponding to this tossable representation, constructs the face in contact with the table when the equipment
has the given resting orientation.

[`protocol TossableFace`](/documentation/TabletopKit/TossableRepresentation/TossableFace)

A protocol that represents a face of a tossable shape.

[`struct SphereFace`](/documentation/TabletopKit/TossableRepresentation/SphereFace)

An object that represents an infinitely small area on the surface of a sphere (effectively a point).

[`enum CubeFace`](/documentation/TabletopKit/TossableRepresentation/CubeFace)

One of the faces of a cube

[`enum DecahedronFace`](/documentation/TabletopKit/TossableRepresentation/DecahedronFace)

One of the faces of an decahedron

[`enum DodecahedronFace`](/documentation/TabletopKit/TossableRepresentation/DodecahedronFace)

One of the faces of an dodecahedron

[`enum IcosahedronFace`](/documentation/TabletopKit/TossableRepresentation/IcosahedronFace)

One of the faces of an icosahedron

[`enum OctahedronFace`](/documentation/TabletopKit/TossableRepresentation/OctahedronFace)

One of the faces of an octahedron

[`enum TetrahedronFace`](/documentation/TabletopKit/TossableRepresentation/TetrahedronFace)

One of the faces of a tetrahedron

## Relationships

### Conforms To

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

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

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

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

---

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)