---
title: "fractalNoise"
description: "A complete fractal-noise paint: layered simplex noise that morphs over time, read through the color ramp."
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#L760"
---

# fractalNoise

A complete fractal-noise paint: layered simplex noise that morphs over time, read through the color ramp.

```ts
fractalNoise(slots: {
    angle: PropRef
    detail: PropRef
    contrast: PropRef
    octaves: PropRef
    seed: PropRef
    space: PropRef
}): Paint
```

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

`angle` rotates the pattern (degrees). `octaves` is how many layers stack (1 to 8, changed live without a recompile), `detail` how much finer each layer is (1 to 4) and `contrast` how much weaker (0.1 to 1). `seed` re-mixes the layers. `space` is the color-space prop. Reads the definition's `colorA`, `colorB` and, when present, `stops` props.

## Parameters

| Name | Type | Notes |
|---|---|---|
| `slots` | `{
    angle: PropRef
    detail: PropRef
    contrast: PropRef
    octaves: PropRef
    seed: PropRef
    space: PropRef
}` |  |

## Example

```ts
paint: fractalNoise({angle: p('angle'), detail: p('detail'), contrast: p('contrast'), octaves: p('octaves'), seed: p('seed'), space: p('colorSpace')})
```

> **Tip.** Declare `animatedTime: {speed: 'speed'}` on the definition. The morphing runs on the layer's clock.

## See also

- [`worleyNoise`](/docs/primitives/noise/worleynoise) — A complete cellular-noise paint: distances to drifting cell points, read through the color ramp.
- [`noiseField`](/docs/primitives/paint/noisefield) — A field of smooth noise in the chosen flavor.

## Used by

[FractalNoise](/docs/components/fractalnoise)