Renames test_opus to opus_demo and adds the test_opus_api, test_opus_encode, test_opus_decode test programs.

Making SILK bandwidth changes non-normative when there's no redundancy

Timothy B. Terriberry authored 13 years ago and Jean-Marc Valin committed 13 years ago

Some clean-up from JM's prior edits, as well as
* Additional clarificatino of TOC sequence restrictions (e.g., if
   you need to decode a length, there must be enough bytes in the
   packet for it, etc.).
* Added a summary of TOC sequence restrictions.
* Added a stereo unmixing section.
* Reworked Delay Compensation section into a general Resampling
   section.
* Further cleanups of switching/transitions, including new diagrams
   for all of the normative and recommended non-normative
   transitions.

Timothy B. Terriberry authored 13 years ago and Jean-Marc Valin committed 13 years ago

A number of fixes and additions, including
* Ensure all usage of the word "mode" refer only to the choice of
   SILK/hybrid/CELT, not audio bandwidth, frame size, channel count,
   or anything else.
  There's still a bunch of usage of "mode" in CELT to refer to
   things in the CELTMode struct (e.g., band layout, etc.).
* Document the LSF reordering for silk_NLSF2A_find_poly().
* Document the DC response check during LSF stabilization.
* Fix the excitation scaling to give decoded SILK output in the
   range -1.0...1.0.
* Rewrite the mode-switching section.
  Ironically the title of the section still implies "mode" means
   than just SILK/hybrid/CELT, but I couldn't come up with a
   better one.
* Minor clean-ups to the acknowledgements.

Timothy B. Terriberry authored 13 years ago and Jean-Marc Valin committed 13 years ago

This patch
 * expands sections on LPC and LTP synthesis into something that can
    actually be implemented
 * fixes an error in the excitation reconstruction
 * reverts an erroneous simplification of the subframe gain
    decoding, and
 * updates the LPC gain limiting description to reflect the new,
    more accurate approach for computing the reflection
    coefficients.
It also includes a number of general clean-ups, such as
 * correcting the description of the sample rates various pieces
    run at (e.g., we can decode directly to rates other than 48 kHz)
 * the usage of "sampling rate" vs. "sample rate"
 * capitalization consistency in TOC titles, and
 * better selection of which sections appear in the TOC.

Ben Schwartz authored 13 years ago and Jean-Marc Valin committed 13 years ago

The PLC section has been moved from under CELT to the top
level and expanded to cover both SILK and CELT.  The clock drift
text provides some advice and explanation of the new GET_PITCH API.

The base64 implementation included with MacOS 10.7 doesn't
support the -w option for wrapping lines. Using the fold
command is more portable.

Without the extra clean, 'make distcheck' fails because
the distclean target doesn't remove all generated files.

Doxygen is a tool for generating programming documentation
based on comments in header and source files. This commit
adds the necessary configuration file and associated support
in the autotools build.

Right now it doesn't generate much documentation because our
public header files aren't marked up. Warnings are printed
for undocumented members and arguments.

Timothy B. Terriberry authored 13 years ago and Jean-Marc Valin committed 13 years ago

Makes acronym definition/expansion more consistent and adds a few
 more explanations to SILK bitstream decoding.

Timothy B. Terriberry authored 13 years ago and Jean-Marc Valin committed 13 years ago

Clarifications/fixes for stereo and handling the mid-only flag.
Also updates the Acknowledgements section.

Timothy B. Terriberry authored 13 years ago and Jean-Marc Valin committed 13 years ago

This should now document the complete SILK bitstream, though not
 the full reconstruction process.