---
title: "stops"
description: "The standard multi-stop palette, read from the `stops`, `colorA` and `colorB` props."
group: "paint"
groupTitle: "Painting"
categoryId: "paint"
categorySlug: "paint"
categoryTitle: "Fields, palettes & ramps"
kind: "function"
sourceUrl: "https://github.com/shader-effects-inc/shaders/blob/main/packages/core/src/std/paint/fields.ts#L169"
---

# stops

The standard multi-stop palette, read from the `stops`, `colorA` and `colorB` props.

```ts
stops(space: PropRef): Palette
```

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

Declare `stops: colorStopsPropConfig()` plus `colorA` and `colorB` on the definition. When the user has set two or more stops the ramp uses them, otherwise it mixes `colorA` to `colorB`. Both mix in the color space named by the `space` prop (mark it `compileTime`).

## Parameters

| Name | Type | Notes |
|---|---|---|
| `space` | `PropRef` |  |

## Example

```ts
paint: rampOver(dist.linear({from: p('start'), to: p('end'), angle: p('angle')}), stops(p('colorSpace')), {edges: p('edges')})
```

> **Tip.** The prop names are fixed: `stops`, `colorA`, `colorB`. Use `pair` when yours differ.

## See also

- [`pair`](/docs/primitives/paint/pair) — A palette of two color props, mixed in the color space named by the `space` prop.
- [`standardPalette`](/docs/primitives/paint/standardpalette) — The color for a 0–1 value from the standard palette props: `colorA`, `colorB`, `stops`, `colorSpace`.

## Used by

[Blob](/docs/components/blob), [BlockNoise](/docs/components/blocknoise), [BlueNoise](/docs/components/bluenoise), [ConicGradient](/docs/components/conicgradient), [CurlNoise](/docs/components/curlnoise), [DiamondGradient](/docs/components/diamondgradient), [ErosionNoise](/docs/components/erosionnoise), [GaborNoise](/docs/components/gabornoise), [LinearGradient](/docs/components/lineargradient), [Obsidian](/docs/components/obsidian), [PerlinNoise](/docs/components/perlinnoise), [Plasma](/docs/components/plasma), [RadialGradient](/docs/components/radialgradient), [SimplexNoise](/docs/components/simplexnoise), [Swirl](/docs/components/swirl), [Voronoi](/docs/components/voronoi), [Waveform](/docs/components/waveform), [WaveletNoise](/docs/components/waveletnoise)