---
title: "dist"
description: "Distance fields: the shape of a gradient, as a number that grows away from a line or point."
group: "paint"
groupTitle: "Painting"
categoryId: "paint"
categorySlug: "paint"
categoryTitle: "Fields, palettes & ramps"
kind: "object"
sourceUrl: "https://github.com/shader-effects-inc/shaders/blob/main/packages/core/src/std/paint/fields.ts#L251"
---

# dist

Distance fields: the shape of a gradient, as a number that grows away from a line or point.

```ts
dist: { linear, radial, conic, diamond, spiral }
```

Import `paint` from `shaders/std` and use `paint.dist`.

Each takes position props made with `transformPosition` and returns 0 at the start and 1 at the end, unbounded beyond. Feed one to `rampOver`.

## Members

- [`dist.linear`](/docs/primitives/paint/dist-linear) — A straight gradient from one point to another.
- [`dist.radial`](/docs/primitives/paint/dist-radial) — A round or elliptical gradient spreading out from a center.
- [`dist.conic`](/docs/primitives/paint/dist-conic) — A sweep around a center, like a clock hand: 0 to 1 once around.
- [`dist.diamond`](/docs/primitives/paint/dist-diamond) — A diamond-shaped gradient spreading out from a center.
- [`dist.spiral`](/docs/primitives/paint/dist-spiral) — A turning spiral stripe: 0 on the background, 1 on the stroke.

## See also

- [`rampOver`](/docs/primitives/paint/rampover) — A paint that colors each pixel by looking its field value up in a palette.
- [`rings`](/docs/primitives/paint/rings) — Repeats a field as concentric bands.
- [`tiles`](/docs/primitives/paint/tiles) — Repeats a field `count` times, always wrapping.

## Used by

[ConicGradient](/docs/components/conicgradient), [DiamondGradient](/docs/components/diamondgradient), [LinearGradient](/docs/components/lineargradient), [RadialGradient](/docs/components/radialgradient), [Spiral](/docs/components/spiral)