---
title: "Reveals & wipes"
description: "Words that make the layer inside disappear in a chosen order: a straight edge, a growing circle, a clock sweep, a grid of blocks, a noise dissolve."
group: "effects"
groupTitle: "Filters & effects"
categoryId: "effects.reveal"
categorySlug: "effects-reveal"
wordCount: 10
curated: true
sourceUrl: "https://github.com/shader-effects-inc/shaders/blob/main/packages/core/src/std/effects/reveal.ts"
editUrl: "https://github.com/shader-effects-inc/shaders/edit/main/packages/core/docs/std/effects.reveal.md"
---

# Reveals & wipes

Words that make the layer inside disappear in a chosen order: a straight edge, a growing
circle, a clock sweep, a grid of blocks, a noise dissolve. Every wipe is the same effect,
[`reveal`](/docs/primitives/effects-reveal/reveal), fed a different **coverage**: a number per pixel from 0 to 1 that says when that
pixel goes (0 first, 1 last). As the `progress` prop climbs from 0 to 1, pixels whose
coverage falls below it fade out across a soft front `feather` wide.

The [`coverage`](/docs/primitives/effects-reveal/coverage) words produce the ordering. Their modifiers reshape it: `.folded()` turns one
edge into two opening outward, `.tiled(n)` repeats it into strips, `.bands(n)` cuts it into
bands that vanish whole, and `.shuffled()` randomizes the band or cell order. Read a wipe from
the inside out: the coverage, its modifiers, then [`reveal`](/docs/primitives/effects-reveal/reveal) with the three timing props.

Only the child's alpha changes, so a wipe composes over anything behind it and costs one
pointwise pass. `progress` has no clock of its own; drive it from a prop.

```ts
import {effects} from 'shaders/std'
```

## Reach for it when

| When you need | Use |
|---|---|
| a straight edge sweeping across | [`coverage.directional`](/docs/primitives/effects-reveal/coverage-directional) |
| two doors opening from the middle | [`coverage.directional`](/docs/primitives/effects-reveal/coverage-directional) with `.folded()` |
| venetian blinds or random bars | [`coverage.directional`](/docs/primitives/effects-reveal/coverage-directional) with `.tiled(n)`, or `.bands(n).shuffled()` |
| a circle growing from a point | [`coverage.radial`](/docs/primitives/effects-reveal/coverage-radial) |
| rings popping outward | [`coverage.radial`](/docs/primitives/effects-reveal/coverage-radial) with `.bands(n)` |
| a clock hand sweeping around a point | [`coverage.angular`](/docs/primitives/effects-reveal/coverage-angular) |
| blocks dissolving, a checkerboard, or a lattice of diamonds | [`coverage.cells`](/docs/primitives/effects-reveal/coverage-cells) with `.shuffled()`, `.checker()` or `.diamond()` |
| a soft film dissolve | [`coverage.noise`](/docs/primitives/effects-reveal/coverage-noise) |
| the timing props every wipe shares | [`reveal`](/docs/primitives/effects-reveal/reveal) |

## Example

```ts
import {defineShader, p, effects, transformBoolean} from 'shaders/std'

const {reveal, coverage} = effects.reveal

// Random bars: a directional wipe cut into bars that vanish in a fixed shuffled order.
export const RandomBars = defineShader({
  name: 'RandomBars',
  props: {
    progress: {default: 0.5, ui: {type: 'range', min: 0, max: 1, step: 0.01}},
    angle: {default: 90, ui: {type: 'range', min: 0, max: 360, step: 1}},
    barCount: {default: 24, ui: {type: 'range', min: 2, max: 100, step: 1}},
    softness: {default: 0.1, ui: {type: 'range', min: 0, max: 1, step: 0.01}},
    invert: {default: false, transform: transformBoolean, ui: {type: 'checkbox'}},
  },
  effect: reveal({
    coverage: coverage.directional(p('angle')).bands(p('barCount')).shuffled(),
    progress: p('progress'),
    feather: p('softness'),
    invert: p('invert'),
  }),
  missingChildMessage: 'RandomBars needs a child to wipe.',
})
```

## Types

| Type | What it is |
|---|---|
| `AngularDirection` | Which way an angular sweep turns. |
| `RevealSlots` | What `reveal` needs: the order pixels go in, and the three timing props every wipe shares. |

## Words

- [`reveal`](/docs/primitives/effects-reveal/reveal) — Fade the child away in coverage order as `progress` goes from 0 to 1.
- [`coverage`](/docs/primitives/effects-reveal/coverage) — The orders a wipe can follow.
- [`coverage.directional`](/docs/primitives/effects-reveal/coverage-directional) — A straight edge sweeping across the canvas.
- [`coverage.radial`](/docs/primitives/effects-reveal/coverage-radial) — A circle growing out from `center`, an iris wipe.
- [`coverage.angular`](/docs/primitives/effects-reveal/coverage-angular) — A clock hand sweeping around `center`.
- [`coverage.cells`](/docs/primitives/effects-reveal/coverage-cells) — A grid of square cells `size` wide.
- [`coverage.noise`](/docs/primitives/effects-reveal/coverage-noise) — Soft blobs eating the image away, the classic film dissolve.
- [`Coverage`](/docs/primitives/effects-reveal/coverage-class) — The order pixels disappear in: a number per pixel from 0 (goes first) to 1 (goes last).
- [`BandedCoverage`](/docs/primitives/effects-reveal/bandedcoverage) — A coverage cut into bands.
- [`CellCoverage`](/docs/primitives/effects-reveal/cellcoverage) — The canvas cut into a grid of square cells, waiting for you to pick the order the cells go in.