Updating osxbuild to work with OS X 10.7+/XCode 4.x.
[sox.git] / FEATURES.in
blobc2d7351875786bca634f1abcd92644a3842ebbca
1 The current release handles the following audio file formats:
2 (:table border=0:)
3 (:cellnr:)
4 * Raw files in various binary formats
5 * Raw textual data
6 * Amiga 8svx files
7 * Apple/SGI AIFF files
8 * SUN .au files
9 ** PCM, u-law, A-law
10 ** G7xx ADPCM files (read only)
11 ** mutant DEC .au files
12 ** NeXT .snd files
13 * AVR files
14 * CDDA (Compact Disc Digital Audio format)
15 * CVS and VMS files (continuous variable slope)
16 * Grandstream ring-tone files
17 * GSM files
18 * HTK files
19 * LPC-10 files
20 * Macintosh HCOM files
21 * Amiga MAUD files
22 * AMR-WB & AMR-NB (with optional libamrwb & libamrnb libraries)
23 * MP2/MP3 (with optional libmad, libtwolame and libmp3lame libraries)
24 * MP4, AAC, AC3, WAVPACK, AMR-NB files (with optional ffmpeg library)
25 * AVI, WMV, Ogg Theora, MPEG video files (with optional ffmpeg library)
26 (:cell:)
27 * Ogg Vorbis files (with optional Ogg Vorbis libraries)
28 * FLAC files (with optional libFLAC)
29 * IRCAM SoundFile files
30 * NIST SPHERE files
31 * Turtle beach SampleVision files
32 * Sounder & Soundtool (DOS) files
33 * Yamaha TX-16W sampler files
34 * SoundBlaster .VOC files
35 * Dialogic/OKI ADPCM files (.VOX)
36 * Microsoft .WAV files
37 ** PCM, floating point
38 ** u-law, A-law, MS ADPCM, IMA (DMI) ADPCM
39 ** GSM
40 ** RIFX (big endian)
41 * WavPack files (with optional libwavpack library)
42 * Psion (palmtop) A-law WVE files and Record voice notes
43 * Maxis XA Audio files
44 ** EA ADPCM (read support only, for now)
45 * Pseudo formats that allow direct playing/recording from most audio devices
46 * The "null" pseudo-file that reads and writes from/to nowhere
47 (:tableend:)
49 The audio effects/tools included in this release are as follows:
51 * Tone/filter effects
52 ** allpass: RBJ all-pass biquad IIR filter
53 ** bandpass: RBJ band-pass biquad IIR filter
54 ** bandreject: RBJ band-reject biquad IIR filter
55 ** band: SPKit resonator band-pass IIR filter
56 ** bass: Tone control: RBJ shelving biquad IIR filter
57 ** equalizer: RBJ peaking equalisation biquad IIR filter
58 ** firfit+: FFT convolution FIR filter using given freq. response (W.I.P.)
59 ** highpass: High-pass filter: Single pole or RBJ biquad IIR
60 ** hilbert: Hilbert transform filter (90 degrees phase shift)
61 ** lowpass: Low-pass filter: single pole or RBJ biquad IIR
62 ** sinc: Sinc-windowed low/high-pass/band-pass/reject FIR
63 ** treble: Tone control: RBJ shelving biquad IIR filter
65 * Production effects
66 ** chorus: Make a single instrument sound like many
67 ** delay: Delay one or more channels
68 ** echo: Add an echo
69 ** echos: Add a sequence of echos
70 ** flanger: Stereo flanger
71 ** overdrive: Non-linear distortion
72 ** phaser: Phase shifter
73 ** repeat: Loop the audio a number of times
74 ** reverb: Add reverberation
75 ** reverse: Reverse the audio (to search for Satanic messages ;-)
76 ** tremolo: Sinusoidal volume modulation
78 * Volume/level effects
79 ** compand: Signal level compression/expansion/limiting
80 ** contrast: Phase contrast volume enhancement
81 ** dcshift: Apply or remove DC offset
82 ** fade: Apply a fade-in and/or fade-out to the audio
83 ** gain: Apply gain or attenuation; normalise/equalise/balance/headroom
84 ** loudness: Gain control with ISO 226 loudness compensation
85 ** mcompand: Multi-band compression/expansion/limiting
86 ** norm: Normalise to 0dB (or other)
87 ** vol: Adjust audio volume
89 * Editing effects
90 ** pad: Pad (usually) the ends of the audio with silence
91 ** silence: Remove portions of silence from the audio
92 ** splice: Perform the equivalent of a cross-faded tape splice
93 ** trim: Cuts portions out of the audio
94 ** vad: Voice activity detector
96 * Mixing effects
97 ** channels: Auto mix or duplicate to change number of channels
98 ** divide+: Divide sample values by those in the 1st channel (W.I.P.)
99 ** remix: Produce arbitrarily mixed output channels
100 ** swap: Swap stereo channels
102 * Pitch/tempo effects
103 ** bend: Bend pitch at given times without changing tempo
104 ** pitch: Adjust pitch (= key) without changing tempo
105 ** speed: Adjust pitch & tempo together
106 ** stretch: Adjust tempo without changing pitch (simple alg.)
107 ** tempo: Adjust tempo without changing pitch (WSOLA alg.)
109 * Mastering effects
110 ** dither: Add dither noise to increase quantisation SNR
111 ** rate: Change audio sampling rate
113 * Specialised filters/mixers
114 ** deemph: ISO 908 CD de-emphasis (shelving) IIR filter
115 ** earwax: Process CD audio to best effect for headphone use
116 ** noisered: Filter out noise from the audio
117 ** oops: Out Of Phase Stereo (or `Karaoke') effect
118 ** riaa: RIAA vinyl playback equalisation
120 * Analysis `effects'
121 ** noiseprof: Produce a DFT profile of the audio (use with noisered)
122 ** spectrogram: graph signal level vs. frequency & time (needs `libpng')
123 ** stat: Enumerate audio peak & RMS levels, approx. freq., etc.
124 ** stats: Multichannel aware `stat'
126 * Miscellaneous effects
127 ** ladspa: Apply LADSPA plug-in effects e.g. CMT (Computer Music Toolkit)
128 ** synth: Synthesise/modulate audio tones or noise signals
129 ** newfile: Create a new output file when an effects chain ends.
130 ** restart: Restart 1st effects chain when multiple chains exist.
132 * Low-level signal processing effects
133 ** biquad: 2nd-order IIR filter using externally provided coefficients
134 ** downsample: Reduce sample rate by discarding samples
135 ** fir: FFT convolution FIR filter using externally provided coefficients
136 ** upsample: Increase sample rate by zero stuffing
138   + Experimental or incomplete effect; may change in future.
140 Multiple audio files can be combined (and then further processed with
141 effects) using any one of the following combiner methods:
143 * concatenate
144 * mix
145 * merge: E.g. two mono files to one stereo file
146 * sequence: For playing multiple audio files/streams