FreeCalypso > hg > gsmhr-codec-ref

annotate README @ 5:59fc7fc126d0

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
mv utils.c reid.c In the original GSM 06.06 code drop, reid.c resides in the "utilities" collection (Dir_UTIL.zip), but there is also a copy of reid.c named utils.c in the "C" collection (Dir_C.zip), even though it is never compiled or linked as such. When I originally created the present Hg repository, I did not intend to include REID, only the main body of the codec - but I overlooked that utils.c copy, so it got imported. In the present time, however, it has become useful to have REID code in Hg for easier public study and discussion - so let's have it under its proper name.
author Mychaela Falconia <falcon@freecalypso.org>
date Mon, 22 Jul 2024 18:43:12 +0000
parents a2529fec5442
children 9cbb19619a9f
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
4
a2529fec5442 add README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
1 This Hg repository contains a mostly-raw import of GSM-HR speech codec
a2529fec5442 add README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
2 implementation from the original GSM 06.06 publication. The only modification
a2529fec5442 add README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
3 that has been made is a minimally-invasive surgical change to gsm_hr.c (the
a2529fec5442 add README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
4 main module) that allows the default noisy output to be suppressed at run time,
a2529fec5442 add README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
5 rather than at compile time, and suppresses all of this noisy output rather
a2529fec5442 add README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
6 than just one part of it. Also a Makefile has been added, for straightforward
a2529fec5442 add README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
7 compilation on "semi-modern" systems such as Slackware Linux.
a2529fec5442 add README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
8
a2529fec5442 add README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
9 This work has been produced for two purposes:
a2529fec5442 add README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
10
a2529fec5442 add README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
11 1) To make it possible to actually run this original GSM-HR code, before the
a2529fec5442 add README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
12 laborious effort of librifying it and incorporating it into gsm-codec-lib,
a2529fec5442 add README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
13 and for verification. testing and comparison after that planned work.
a2529fec5442 add README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
14
a2529fec5442 add README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
15 2) To have the code readily available in a public Hg repository, allowing
a2529fec5442 add README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
16 direct links to individual files or even to line numbers. Such easy linking
a2529fec5442 add README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
17 ability is needed to facilitate analysis and discussion of various aspects
a2529fec5442 add README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
18 of this reference code.