---
title: "noiseTone"
description: "The standard contrast and balance controls of a noise texture, turning a 0–1 field into the ramp position."
group: "light"
groupTitle: "Noise, light & materials"
categoryId: "noise"
categorySlug: "noise"
categoryTitle: "Noise"
kind: "function"
sourceUrl: "https://github.com/shader-effects-inc/shaders/blob/main/packages/core/src/std/paint/noise.ts#L669"
---

# noiseTone

The standard contrast and balance controls of a noise texture, turning a 0–1 field into the ramp position.

```ts
noiseTone(field: Field, slots?: {contrast?: PropRef; balance?: PropRef}): Field
```

Import `noise` from `shaders/std` and use `noise.noiseTone`.

`contrast` steepens the field around mid-grey (0 = unchanged, positive = sharper, negative = flatter). `balance` shifts the whole range (positive = more of the first color). Leave the slots out for a texture without those controls. The result is flipped: where the field is high the ramp shows its first color. Expects a unit field, so put `unitized` around a signed basis first.

## Parameters

| Name | Type | Notes |
|---|---|---|
| `field` | `Field` |  |
| `slots` | `{contrast?: PropRef; balance?: PropRef}` | Optional. |

## Example

```ts
paint: rampOver(noiseTone(seededPlane(evolving(noiseField('perlin'), {rate: 0.3}), {scale: p('scale'), seed: p('seed')}), {contrast: p('contrast'), balance: p('balance')}), stops(p('colorSpace')))
```

> **Tip.** Contrast here is additive: 0 is the identity, not 1. Default the prop to 0.

## See also

- [`signedTone`](/docs/primitives/noise/signedtone) — Contrast and balance for a signed field (−1 to 1), applied before it is squashed to 0–1.
- [`gainTone`](/docs/primitives/noise/gaintone) — Contrast as a multiplier and balance as a shift over a 0–1 field, not flipped.
- [`unitized`](/docs/primitives/noise/unitized) — Turns a signed field (−1 to 1) into a unit field (0 to 1).

## Used by

[BlockNoise](/docs/components/blocknoise), [BlueNoise](/docs/components/bluenoise), [CurlNoise](/docs/components/curlnoise), [ErosionNoise](/docs/components/erosionnoise), [GaborNoise](/docs/components/gabornoise), [PerlinNoise](/docs/components/perlinnoise), [Scratches](/docs/components/scratches), [WaveletNoise](/docs/components/waveletnoise)