AudioTools
ToMono
convert a multi-channel audio recording to monophonic
ToStereo
convert an audio record to stereophonic (or more channels)
Calling Sequence
Parameters
Description
Examples
ToMono(audArray)
ToStereo(audArray, optNumChannels)
audArray
-
Array, Vector, or Matrix containing the audio data to convert
optNumChannels
(optional) integer representing the number of input channels
The ToMono command takes multi-channel audio data and produces a single-channel monophonic audio object.
The ToStereo command takes single channel monophonic audio data and produces two-channel stereo audio (with corresponding samples in both channels having the same values). This is useful if a monophonic recording is to be combined in some way with a stereo recording.
The optional optNumChannels parameter of ToStereo can be used to specify that more than two channels are to be created. The number of channels must be a multiple of the number of input channels, and each input channel is repeated an appropriate number of times in the output.
The audArray parameter specifies the data to convert, and must be a dense, rectangular, one or two dimensional Array, Vector, or Matrix with datatype=float[8].
If either command is passed audio data that is already of the correct type, the audio data is returned. Otherwise, a new object of the appropriate type is created.
audiofile≔cat⁡kernelopts⁡datadir,/audio/stereo.wav:
with⁡AudioTools:
aud≔Read⁡audiofile
aud≔Sample Rate22050File FormatPCM File Bit Depth8Channels2Samples/Channel19962Duration0.90531⁢s
aud2000
−0.3125000000000000.771653543307087
mono≔ToMono⁡aud
mono≔Sample Rate22050File FormatPCM File Bit Depth8Channels1Samples/Channel19962Duration0.90531⁢s
mono2000
0.229576771653543
stereo_mono≔ToStereo⁡mono
stereo_mono≔Sample Rate22050File FormatPCM File Bit Depth8Channels2Samples/Channel19962Duration0.90531⁢s
stereo_mono2000
0.2295767716535430.229576771653543
quad_stereo≔ToStereo⁡aud,4
quad_stereo≔Sample Rate22050File FormatPCM File Bit Depth8Channels4Samples/Channel19962Duration0.90531⁢s
quad_stereo2000
−0.312500000000000−0.3125000000000000.7716535433070870.771653543307087
See Also
Array
Matrix
Vector
Download Help Document