---
title: "settle"
description: "Find the closest anchor, taking into account the [velocityThreshold] and [positionalThreshold], and settle at it with an animation."
type: "function"
lastmod: "2026-08-27"
---
## API Reference

### settle

> Source set: Common

```kotlin
suspend fun settle(velocity: Float)
```

Find the closest anchor, taking into account the `velocityThreshold` and
`positionalThreshold`, and settle at it with an animation.

If the `velocity` is lower than the `velocityThreshold`, the closest anchor by distance and
`positionalThreshold` will be the target. If the `velocity` is higher than the
`velocityThreshold`, the `positionalThreshold` will <b>not</b> be considered and the next
anchor in the direction indicated by the sign of the `velocity` will be the target.