shithub: sox

--- a/TODO

+++ b/TODO

@@ -2,6 +2,17 @@

 patches to cbagwell@users.sourceforge.net, or post them on the patches

 tracker at http://sf.net/projects/sox/.

+SOX includes skeleton format files to assist you in supporting new

+formats, sound effect loops, and special-purpose programs.

+The full skeleton format, skel.c, helps you write a driver

+for a new format which has data structures.  skeleff.c is

+a starting point for writing a sound effect loop.  Sox.c is

+a good starting point for new programs.  (Someone finally

+did this and told me what was wrong...)

+In handlers.c, note that many formats set up the header and then

+use the raw driver for reading and writing.

   o Update all read routines to be like WAV handler and only

     return data in multiples of sample_size*channels.  This

     will prevent corrupt files from causing sox to go into

@@ -97,13 +108,10 @@

     they should return error codes for users to handle.  Initial support

     for this has been added.  Needs to be completed.

-SOX includes skeleton format files to assist you in supporting new

-formats, sound effect loops, and special-purpose programs.

-The full skeleton format, skel.c, helps you write a driver

-for a new format which has data structures.  skeleff.c is

-a starting point for writing a sound effect loop.  Sox.c is

-a good starting point for new programs.  (Someone finally

-did this and told me what was wrong...)

-In handlers.c, note that many formats set up the header and then

-use the raw driver for reading and writing.

+  o SJB: [11/25/99] (Re. resample effect): Note that upsampling

+    usually doesn't require interpolation, therefore is faster and

+    more accurate than downsampling. Downsampling by an integer factor

+    is also simple, since it just involves decimation if the input is

+    already lowpass-filtered to the output Nyquist freqency. Get the

+    idea? :) Also, the original algorithm has apparently been updated,

+    and might usefully be updated in SoX too.