diff doc/Codec-utils @ 144:30c7bc064218

doc/Codec-utils: add note about PCM file format issue
author Mychaela Falconia <falcon@freecalypso.org>
date Wed, 14 Dec 2022 07:25:46 +0000
parents 8eb0e7a39409
children 04936af99fc8
line wrap: on
line diff
--- a/doc/Codec-utils	Wed Dec 14 07:04:59 2022 +0000
+++ b/doc/Codec-utils	Wed Dec 14 07:25:46 2022 +0000
@@ -37,3 +37,12 @@
 
 WAV reading and writing functions used by the above utilities have been lifted
 out of opencore-amrnb test code.
+
+Now that we are starting to encounter use cases that involve more than feeding
+a PC microphone recording to test encoders and playing decoder output on PC
+speakers, many of those other use cases call for using raw format instead of WAV
+for 16-bit linear PCM.  While it would be philosophically most proper to add an
+option to gsm[e]fr-encode and gsm[e]fr-decode utilities to read/write raw PCM
+files instead of WAV, doing so would complicate the code too much.  As a
+compromise between code simplicity and functionality, we provide lossless
+conversion utilities - see PCM-file-formats article.