<!--
{
  "availability" : [
    "visionOS: 2.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "TabletopKit",
  "identifier" : "/documentation/TabletopKit/TabletopInteraction/toss(equipmentID:as:linearVelocity:angularVelocity:)",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "TabletopKit"
    ],
    "preciseIdentifier" : "s:11TabletopKit0A11InteractionC4toss11equipmentID2as14linearVelocity07angularI0yAA19EquipmentIdentifierV_AA22TossableRepresentationVSo10SPVector3DaSgAOtF"
  },
  "title" : "toss(equipmentID:as:linearVelocity:angularVelocity:)"
}
-->

# toss(equipmentID:as:linearVelocity:angularVelocity:)

Begins a simulation of a toss of the equipment with the specificied parameters. Equipment that begins a toss in the same TabletopInteraction may interact with each other as well as the game’s boundary.

```
func toss(equipmentID: EquipmentIdentifier, as representation: TossableRepresentation, linearVelocity: Vector3D? = nil, angularVelocity: Vector3D? = nil)
```

## Parameters

`equipmentID`

the equipment ID to use in the toss simulation.

`representation`

the representation that the toss simulation will treat the equipment as.

`linearVelocity`

The linear velocity the toss begins with. If nil, the simulation will use the interaction’s current linear velocity.

`angularVelocity`

The angular velocity the toss begins with. If nil, the simulation will use the interaction’s current angular velocity.

---

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)