FreeCalypso > hg > gsm-codec-lib

annotate doc/PCM-file-formats @ 144:30c7bc064218

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
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 195911f2211c
children a217a6eacbad
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
143
195911f2211c document PCM format conversion utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
1 What file format should be used for 16-bit PCM sample recordings? The first
195911f2211c document PCM format conversion utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
2 (in the order of development) group of utilities in the present package that
195911f2211c document PCM format conversion utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
3 need to read and write such files are gsm[e]fr-encode and gsm[e]fr-decode,
195911f2211c document PCM format conversion utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
4 designed to mirror amrnb-enc and amrnb-dec from opencore-amr FOSS package;
195911f2211c document PCM format conversion utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
5 these utilities read and write WAV files and even use WAV reading and writing
195911f2211c document PCM format conversion utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
6 functions copied from opencore-amrnb test code.
195911f2211c document PCM format conversion utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
7
195911f2211c document PCM format conversion utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
8 However, as I (Mother Mychaela) keep developing more tools, my use cases become
195911f2211c document PCM format conversion utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
9 more diverse: in some use cases WAV is most convenient (e.g., when playing or
195911f2211c document PCM format conversion utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
10 recording with SoX tools), but in other use cases a raw sample file without any
195911f2211c document PCM format conversion utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
11 header is much more convenient. To address this diversity of use cases, a pair
195911f2211c document PCM format conversion utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
12 of conversion utilities have been written:
195911f2211c document PCM format conversion utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
13
195911f2211c document PCM format conversion utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
14 pcm16-raw2wav converts from raw format to WAV
195911f2211c document PCM format conversion utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
15 pcm16-wav2raw converts from WAV to raw format
195911f2211c document PCM format conversion utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
16
195911f2211c document PCM format conversion utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
17 Both utilities take a mandatory command line argument specifying the endian
195911f2211c document PCM format conversion utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
18 order for the raw format - there is no default.