---
title: "applyLinearImpulse(_:relativeTo:)"
framework: realitykit
role: symbol
role_heading: Instance Method
path: "realitykit/hasphysicsbody/applylinearimpulse(_:relativeto:)"
---

# applyLinearImpulse(_:relativeTo:)

Applies an impulse to the physics body at its center of mass.

## Declaration

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

## Parameters

- `impulse`: An impulse in newton seconds.
- `referenceEntity`: The reference entity that defines the coordinate space in which impulse is defined.

## See Also

### Applying impulses

- [applyAngularImpulse(_:relativeTo:)](realitykit/hasphysicsbody/applyangularimpulse(_:relativeto:).md)
- [applyImpulse(_:at:relativeTo:)](realitykit/hasphysicsbody/applyimpulse(_:at:relativeto:).md)