---
title: "applyImpulse(_:at:relativeTo:)"
framework: realitykit
role: symbol
role_heading: Instance Method
path: "realitykit/hasphysicsbody/applyimpulse(_:at:relativeto:)"
---

# applyImpulse(_:at:relativeTo:)

Applies an impulse to the physics body at the specified position.

## Declaration

```swift
@MainActor @preconcurrency func applyImpulse(_ impulse: SIMD3<Float>, at position: SIMD3<Float>, relativeTo referenceEntity: Entity?)
```

## Parameters

- `impulse`: An impulse in newton seconds.
- `position`: The position at which to apply the impulse.
- `referenceEntity`: The reference entity that defines the coordinate space in which position and impulse are defined.

## See Also

### Applying impulses

- [applyLinearImpulse(_:relativeTo:)](realitykit/hasphysicsbody/applylinearimpulse(_:relativeto:).md)
- [applyAngularImpulse(_:relativeTo:)](realitykit/hasphysicsbody/applyangularimpulse(_:relativeto:).md)