---
title: "toss(equipmentID:as:linearVelocity:angularVelocity:)"
framework: tabletopkit
role: symbol
role_heading: Instance Method
path: "tabletopkit/tabletopinteraction/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.

## Declaration

```swift
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.

## See Also

### Performing actions

- [TabletopInteraction.Delegate](tabletopkit/tabletopinteraction/delegate.md)
- [TabletopInteraction.TossOutcome](tabletopkit/tabletopinteraction/tossoutcome.md)
- [addAction(_:)](tabletopkit/tabletopinteraction/addaction(_:)-1cety.md)
- [addAction(_:)](tabletopkit/tabletopinteraction/addaction(_:)-4rx16.md)
- [addActions(_:)](tabletopkit/tabletopinteraction/addactions(_:).md)
- [end()](tabletopkit/tabletopinteraction/end().md)
- [cancel()](tabletopkit/tabletopinteraction/cancel().md)