@spec advance(t(), pos_integer()) :: {binary(), t()}

The next frames frames of mono PCM, and the voice advanced past them.

Short at the end: a voice with 100 frames left asked for 512 gives 100. A voice already finished gives an empty binary.

@spec advance(t(), pos_integer(), pos_integer()) :: {binary(), t()}

The next frames frames panned for channels channels, and the voice advanced past them. The pan is read once per block.

@spec control(t(), keyword() | map()) :: t()

Change the voice from the next block on.

changes are TuningFork.Voice's fields, as a keyword list or a map; an unknown key raises KeyError. Phase, filter state, noise seed and the note's length are untouched.

@spec done?(t()) :: boolean()

Whether the voice has finished sounding.

@spec release(t(), float()) :: t()

Stop a voice early, falling to silence over seconds from the level it has reached.

The returned voice has a length of seconds and starts at frame zero; its curves are held at the values they had reached and :sweep is 1.0.

@spec remaining(t()) :: non_neg_integer()

How many frames are left before it finishes.

@spec start(TuningFork.Voice.t(), pos_integer()) :: t()

Begin sounding a voice at rate samples per second.

The note's length is fixed here from the voice's envelope; only release/2 changes it afterwards.