remix [-a|-m|-p] <out-spec>
      out-spec = in-spec{,in-spec} | 0
      in-spec = [in-chan][-[in-chan2]][vol-spec]
      vol-spec = p|i|v[volume]

An out-spec contains comma-separated input channel-numbers and hyphen-delimited channel-number ranges; alternatively, 0 may be given to create a silent output channel. For example,

remix 6 7 8 0

creates an output sample with four channels, where channels 1, 2, and 3 are copies of channels 6, 7, and 8 in the input sample, and channel 4 is silent. Whereas

remix 1-3,7 3

creates a (somewhat bizarre) stereo output sample where the left channel is a mix-down of input channels 1, 2, 3, and 7, and the right channel is a copy of input channel 3.

Where a range of channels is specified, the channel numbers to the left and right of the hyphen are optional and default to 1 and to the number of input channels respectively. Thus

remix

performs a mix-down of all input channels to mono.

By default, where an output channel is mixed from multiple (n) input channels, each input channel will be scaled by a factor of 1/n. Custom mixing volumes can be set by following a given input channel or range of input channels with a vol-spec (volume specification). This is one of the letters p, i, or v, followed by a volume number, the meaning of which depends on the given letter and is defined as follows:

p

Power adjust in dB. 0 = no change.

i

Power adjust in dB. As p, but invert the audio

v

Voltage multiplier. 1 = no change, 0.5 around 6dB attenuation, 2 around 6dB gain, -1 = invert.

If an out-spec includes at least one vol-spec then, by default, -1/n scaling is not applied to any other channels in the same out-spec (though may be in other out-specs). The -a (automatic) option however, can be given to retain the automatic scaling in this case. For example,

remix 1,2 3,4v0.8

results in channel level multipliers of 0.5,0.5 1,0.8, whereas

remix -a 1,2 3,4v0.8

results in channel level multipliers of 0.5,0.5 0.5,0.8.

The -m (manual) option disables all automatic volume adjustments, so

remix -m 1,2 3,4v0.8

results in channel level multipliers of 1,1 1,0.8.

The volume number is optional and omitting it corresponds to no volume change; however, the only case in which this is useful is in conjunction with i. For example, if the input sample is stereo, then

remix 1,2i

is a mono equivalent of the oops effect.

If the -p option is given, then any automatic -1/n scaling is replaced by -1/sqrt(n) ("power") scaling; this gives a louder mix but one that might occasionally clip.

One use of the remix effect is to split a Hollywood sample into a set of samples, each containing one of the constituent channels (in order to perform subsequent processing on individual audio channels).

See also the swap effect.