README
1Sun Jul 7 15:35:44 CDT 1996
2Andy Fingerhut (jaf@arl.wustl.edu)
3
4Before you can make any of the programs in this directory, you must
5change to the lpc10 directory and make the LPC-10 library. See the
6README file there, and be especially sure to read the notes there
7about possible modifications you will need to make to the file lpc10.h
8in this directory.
9
10I've made up a Unix makefile for the programs nuke and unnuke, called
11makefile.unx. I don't know how to create a makefile for Microsoft C.
12Feel free to send me one if you create one that works.
13
14The files in this directory are just some simple main programs that
15call the routines create_lpc10_encoder_state(), lpc10_encode(),
16create_lpc10_decoder_state(), and lpc10_decode(). Those four routines
17are defined in source files within the subdirectory lpc10, and are all
18that any application ever needs to use to compress and decompress
19speech with the LPC-10 coder. The main programs in this directory are
20just intended as examples of how to use these routines.
21
22Optionally, an application could also use the routines
23init_lpc10_encoder_state() or init_lpc10_decoder_state() to
24reinitialize a state struct that was created by one of the create
25functions mentioned above. This could be useful between talk spurts,
26for example, to flush out any possible remaining garbage state that
27could occur because some data was lost. This shouldn't be necessary,
28since any old bad state should be flushed out or decay within a few
29frame times anyway (frame time = 22.5 ms). I have heard lost packets
30(or maybe they were garbled?) produce interesting audio artifacts in
31the application Nautilus.
32
33
34Tue Aug 20 15:49:04 CDT 1996
35Andy Fingerhut (jaf@arl.wustl.edu)
36
37I have just completed making many changes to the C source code that
38allow multiple audio streams to be compressed or decompressed in an
39interleaved fashion. This is useful, for example, for some Internet
40MBONE audio tools that can receive compressed audio from multiple
41sources simultaneously. See one or more of the following
42demonstration programs for examples of the calling sequence:
43
44nuke - compressing one audio stream
45nuke2 - compressing two audio streams, alternating one frame from each
46unnuke - decompressing one audio stream
47unnuke2 - decompressing two audio streams, alternating one frame from each
48