# WAM Sample Effect

Commands ▸ Effects ▸ WAM effect… in the sample editor runs part of a sample
through a chain of WAM effect plugins and writes the result back into the
sample. It works on the range that was marked when the window opened, or on
the whole sample when none was; the line above the buttons says which. The
sample does not change until **Apply**.

## Add plugin

Adds the chosen plugin to the end of the chain. The list holds the effect
plugins installed with **Install…** in Song ▸ Plugins…
([Plugins](plugins.md#install)). The built-in plugins are not offered here,
and nor are instrument plugins, which have no audio input to process.

## The chain

The plugins run from the top of the list down; drag a row to move it. On
each row, **BYP** bypasses the plugin — the sound passes through it
untouched, and the button reads **OFF** — **GUI** opens the plugin's own
controls in the window, and **×** removes it. What you set in a plugin's
controls is what the next preview renders.

Only the last plugin in the chain renders a tail (see
[Effect tail](#effect-tail)): the ones before it stop at the end of the range,
so a reverb or a delay belongs last.

## Processing rate and Resample

The rate the plugins run at. **Instrument default** is the rate the sample
plays at its default pitch. With **Resample** on, the range is converted to
the processing rate (windowed sinc) before the chain and back to its own rate
after it. Off, it is handed over unconverted, as if it had been recorded at
that rate, so a delay time or a filter frequency lands on a different part of
the sound. The line under the row says which is happening.

## Channels and Bit depth

**Force mono** averages the two channels; **Force stereo** puts a mono sample
in both. **Bit depth** is what Apply stores. Either conversion applies to the
whole sample, not just the range, and the line under the row says what Apply
will do. The result is also kept at full precision, so a later edit starts
from it rather than from the stored bits.

In an Amiga module an 8-bit sample stays 8-bit, whatever Bit depth says,
unless the sample editor's Commands menu is set to return 16-bit (its
*Edits keep 8-bit in this Amiga module* row).

## Effect tail

What happens when an effect rings on past the end of the range. These are
the four choices the Echo's *Past the selection* offers
([Sample editor](sample-editor.md#echo)):

| Choice | The tail |
|---|---|
| Truncate to selected region | is cut off, and the range keeps its length |
| Extend and insert | goes in after the range, and the rest of the sample moves along |
| Extend and overwrite | is written over what follows |
| Overlay (mix in place) | is added to what follows, and the processed range is added to the original rather than replacing it |

A tail that runs past the end of the sample makes the sample longer. **Room**
is how long a tail may run, 1 to 10 seconds: it is rendered for that long and
then trimmed back to where it actually falls silent, never shorter than the
range. With Truncate, Room does nothing.

## Dry and Wet

How much of the untreated range (**Dry**) and of the processed sound
(**Wet**) go into the result. The defaults, 0 % and 100 %, give the processed
sound alone.

## Preview, Audition and Apply

**Preview** renders the result and draws it. A second Preview runs the chain
over the first one's result, so the effect builds up; **UNDO PREVIEW** and
**REDO PREVIEW** step back and forth through them. **Audition** plays the
preview. **Apply** writes the latest preview into the sample, rendering one
first if there is none, as one step of undo. **Cancel** closes the window.

When Extend and insert changes the range's length, the loop moves with the
audio: a loop after the range slides along, one that takes in the whole range
grows or shrinks with it, one inside the range is cut to fit, and one that
straddles an edge of the range is dropped.