---
title: "surfaceNoise"
description: "Smooth signed noise at a 2D point, roughly −1 to 1, with features about one unit wide."
group: "light"
groupTitle: "Noise, light & materials"
categoryId: "materials"
categorySlug: "materials"
categoryTitle: "Materials & surfaces"
kind: "function"
sourceUrl: "https://github.com/shader-effects-inc/shaders/blob/main/packages/core/src/std/paint/materials.ts#L916"
---

# surfaceNoise

Smooth signed noise at a 2D point, roughly −1 to 1, with features about one unit wide.

```ts
surfaceNoise(x: Expr | number, y: Expr | number): Expr
```

Import `materials` from `shaders/std` and use `materials.surfaceNoise`.

The basis for grain, crumple and frost. Scale the inputs to set the feature size.

## Parameters

| Name | Type | Notes |
|---|---|---|
| `x` | `Expr \| number` |  |
| `y` | `Expr \| number` |  |

## Example

```ts
const grain = surfaceNoise(mul(pat.member('x'), 140), mul(pat.member('y'), 140))
```

## See also

- [`surfaceNoiseAt`](/docs/primitives/materials/surfacenoiseat) — `surfaceNoise` at a 2D point you already hold.
- [`valueNoise`](/docs/primitives/materials/valuenoise) — Smooth noise 0–1 at a 2D point, softer and blockier than `surfaceNoise`.
- [`hashNoise`](/docs/primitives/materials/hashnoise) — Random 0–1 per point, with no smoothness between neighbours.
- [`grainNoise`](/docs/primitives/materials/grainnoise) — One octave of smooth signed noise along and across a direction, for grain.

## Used by

[CarbonFiber](/docs/components/carbonfiber), [Frost](/docs/components/frost), [Hologram](/docs/components/hologram), [Holographic](/docs/components/holographic), [Plastic](/docs/components/plastic)