STL2026 Release - ITU-T Submission

.gitattributes

@@ -0,0 +1,5 @@
+# Binary test data files - prevent CRLF corruption
+src/unsup/test_data/cftest1.dat binary
+
+# Shell scripts must use LF
+*.sh text eol=lf

.github/workflows/ci.yml

@@ -4,7 +4,7 @@ on:
   push:
     branches: [dev, main, STL_2026_itu_submission]
   pull_request:
-    branches: [dev, main]
+    branches: [dev, main, STL_2026_itu_submission]
 
 jobs:
   build-and-test:
@@ -58,7 +58,7 @@ jobs:
         run: |
           # Exclude build directory from Windows Defender to avoid scan delays
           powershell -Command "Add-MpPreference -ExclusionPath '${{ github.workspace }}'"
-          cmake .
+          cmake . -DCMAKE_C_FLAGS="/we4700"
 
       - name: Build (Unix)
         if: runner.os != 'Windows'

.gitignore

@@ -8,7 +8,7 @@
 *.tmp
 [Bb]in/
 
-# Generated test files
+# Generated test output files
 *05g10.*
 *.[am]16
 *.[am]24
@@ -47,8 +47,6 @@ src/is54/test_data/voice.bec
 src/is54/test_data/voice.hbs
 !src/is54/test_data/voice.log
 src/is54/test_data/voice.rek
-src/sv56/test_data/voice.prc
-src/sv56/test_data/voice.rms
 src/unsup/test_data/astrip.blk
 src/unsup/test_data/undo.txt
 src/utl/test_data/voice.rnp
@@ -97,3 +95,8 @@ bld/
 .vs/
 *vcxproj*
 *.sln*
+.vscode/
+/build
+*.double
+stderr.txt
+stdout.txt

CMakeLists.txt

@@ -1,6 +1,7 @@
-cmake_minimum_required(VERSION 3.1)
-project(STL2023 VERSION 2023)
-add_definitions( -DVERSION_STL="${CMAKE_PROJECT_NAME}" )
+cmake_minimum_required(VERSION 3.10...3.31)
+project(STL2026 VERSION 2026)
+
+add_definitions( -DVERSION_STL="${CMAKE_PROJECT_NAME}" -DCMAKE_POLICY_VERSION_MINIMUM=3.5 )
 
 set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/bin)
 
@@ -24,6 +25,7 @@ add_subdirectory(src/eid)
 add_subdirectory(src/esdru)
 add_subdirectory(src/fir)
 add_subdirectory(src/freqresp)
+add_subdirectory(src/gain_chk)
 add_subdirectory(src/g711)
 add_subdirectory(src/g711iplc)
 add_subdirectory(src/g722)

README.md

@@ -1,7 +1,7 @@
 README for the _ITU-T Software Tool Library_ (STL)
 ===
 
-The STL provides software for speech- and audio-related speech processing, including narrowband (telephony), wideband ans super-wideband applications. 
+The STL provides software for speech- and audio-related speech processing, including narrowband (telephony), wideband and super-wideband applications. 
 This includes codecs, noise generators, filter, etc.
 
 The STL is standardized by ITU-T in [Recommendation ITU-T G.191 "Software tools for speech and audio coding standardization"](http://itu.int/ITU-T/G.191).
@@ -18,6 +18,8 @@ To build the STL tools, you need:
 
 Not so recent C compilers might also work (not tested).
 
+## Linux / macOS
+
 ```shell
 #Download source code
 git clone https://github.com/openitu/STL
@@ -26,16 +28,40 @@ git clone https://github.com/openitu/STL
 cd STL
 
 #Generate platform dependent build scripts using CMake
-#For using a specific generator see CMake parameter "-G"
 cmake .
 
-##Build STL tools
+#Build STL tools
 cmake --build .
 
-##Run tests (optional)
+#Run tests (optional)
 ctest
 ```
 
+## Windows
+
+Prerequisites:
+* Visual Studio with the **"Desktop development with C++"** workload installed
+* CMake (included with Visual Studio, or install separately)
+
+```powershell
+#Download source code
+git clone https://github.com/openitu/STL
+
+#Enter directory
+cd STL
+
+#Generate Visual Studio project files (adjust version as needed)
+cmake -G "Visual Studio 18 2026" .
+
+#Build STL tools
+cmake --build . --config Release
+
+#Run tests (optional)
+ctest -C Release
+```
+
+> **Note:** On Windows, you must specify a configuration (`Release` or `Debug`) for both the build and test steps.
+
 # Licenses
 The STL, and all of its derivations, is subject to the "ITU-T General Public License", which is a modified version of the GPL1.
 Please read the file `LICENSE.md` for the terms and conditions.
@@ -57,13 +83,12 @@ The primary audience using, maintaining and extending the STL is primarily const
 We distinguish between (1) the STL code development in the open source environment, and (2) the maintenance and update of Recommendation ITU-T G.191 in the standardization environment.
 
 ## Open source environment (GitHub):
-*   It follows the best practices for open source code development
+*   It follows the best practices for open source code development.
 *   Participation is open and encouraged to anyone interested in the development of the STL, independent of ITU membership.
-*   The open source environment will have three branches of the STL:
-    1.   Master branch — the latest ITU-T approved version of the STL (starting with STL2009);
-    2.   Development branch — to advance the STL code and add new features; and
-    3.   Submission branch — to submit new stable code to SG12.
-*   Proposals submitted to the development branch document motivation and intended merits.
+*   The repository uses a single long-lived branch:
+    *   **`main`** — the latest version of the STL, updated upon ITU-T approval.
+    *   **Feature/fix branches** — short-lived branches for new tools or changes, merged via pull requests.
+*   Approved versions are marked with git tags (e.g., `STL2024`, `STL2026`).
 *   Any tools in the library should satisfy the principles outlined in clauses 2.3 and 2.4 of the G.191: ITU-T Software Tool Library 2009 User's manual, in particular with respect to testing of portability and compliance.
 *   New tools: 
     *   should not overlap in functionality provided by other tools already in the library, unless there is community consensus on the benefits of such approach;
@@ -73,11 +98,10 @@ We distinguish between (1) the STL code development in the open source environme
 *   Changes to existing tools: 
     *   should provide sufficient evidence that the changes do not break existing code (in particular, backward compatibility), unless there is community consensus that this is the best approach;
     *   should respect the license of the tool.
-    *   The development branch is used for discussion and consensus building on a stable version, for inclusion in the submission branch.
 
 ## Standardization environment ([ITU-T Study Group 12](https://itu.int/go/tsg12)):
 *   Participation is limited to those who can participate in the standardization work in ITU-T SG12.
 *   The Editor of ITU-T G.191 monitors the change process in the open source environment. 
-*   Upon availability of sufficient stable material in the submission branch, the Editor of ITU-T G.191 submits a TD to Q2/12 summarizing the proposed changes and related discussion, and provides a snapshot of the submission branch as basis for a revised version of ITU-T G.191.
+*   Upon availability of sufficient stable material, the Editor of ITU-T G.191 opens a pull request against `main`, submits a TD to Q2/12 summarizing the proposed changes, and provides the PR as basis for a revised version of ITU-T G.191.
 *   The TD is considered by Q2/12, and action is taken following the alternative approval procedure (AAP) for ITU-T Recommendations.
-*   The Editor of ITU-T G.191 provides feedback on the actions taken to the developers in the open source environment, and, upon approval of a revised version of G.191, updates the master branch of the open source environment.
+*   The Editor of ITU-T G.191 provides feedback on the actions taken to the developers in the open source environment, and, upon approval of a revised version of G.191, merges the PR into `main` and tags the release.

cmake/CompareTextFiles.cmake

@@ -0,0 +1,25 @@
+# cmake/CompareTextFiles.cmake
+# Compare two text files, ignoring line-ending differences (CRLF vs LF).
+#
+# Usage (from a -P script):
+#   include(/path/to/CompareTextFiles.cmake)
+#   compare_text_files(GOT <file> EXPECTED <file> [LABEL <name>])
+
+function(compare_text_files)
+    cmake_parse_arguments(_CTF "" "GOT;EXPECTED;LABEL" "" ${ARGN})
+
+    file(READ "${_CTF_GOT}" _got)
+    string(REPLACE "\r\n" "\n" _got "${_got}")
+
+    file(READ "${_CTF_EXPECTED}" _want)
+    string(REPLACE "\r\n" "\n" _want "${_want}")
+
+    if(NOT _got STREQUAL _want)
+        message(FATAL_ERROR "Text file mismatch: ${_CTF_LABEL}\n--- got ---\n${_got}\n--- expected ---\n${_want}")
+    endif()
+endfunction()
+
+# Auto-invoke when called via cmake -P with -D variables
+if(DEFINED GOT AND DEFINED EXPECTED)
+    compare_text_files(GOT "${GOT}" EXPECTED "${EXPECTED}" LABEL "${LABEL}")
+endif()

doc/g191.md

@@ -12,27 +12,27 @@ Please refer to the official Recommendation ITU-T G.191 for the complete text: [
 
 Recommendation ITU-T G.191 provides source code for speech and audio processing modules for narrowband, wideband and super-wideband telephony applications. The set includes codecs, filters, noise generators.
 
-This edition introduces changes to Annex A, which describes the ITU-T Software Tools (STL) containing a high-quality, portable C code library for speech processing applications. This release of the STL, also known as STL2024, incorporates:
+This edition introduces changes to Annex A, which describes the ITU-T Software Tools (STL) containing a high-quality, portable C code library for speech processing applications. This release of the STL, also known as STL2026, incorporates:
 
-* BS1770demo improvements:
+* WAV file I/O support with multi-bit-depth (16/24/32-bit) processing for all tools
 
-    - a new RMS option disabling the gating function for background noise measurement, 
+* Extensions to the speech voltmeter (sv56) for arbitrary bit-depth processing
 
-    - the handling of the edge case where all gating blacks are below -70 LKFS,
+* A delay-and-error profile to frame-erasure pattern conversion tool (dlyerr\_2\_errpat) for jitter buffer emulation (3GPP S4-121077)
 
-    - improved reporting with scaling factor being reported in the linear and log domains.
+* An EID for 3GPP AMR bitstreams (eid-amr)
 
-* WMC Tool updates:
+* A pseudo-random selection tool (random) for EVS processing scripts (3GPP S4-121078)
 
-    - New command line parameter to allow control on the number of frames per second (default still 50)
+* SHQ2/SHQ3 half-band and HP50 high-pass FIR filters
 
-    - Export information on all memory allocations occurring during runtime
-
-    - Example script for graphical analysis and profiling of dymanic memory allocation
+* P.863/P.863.2 resampling FIR filters for rate-change factors 2, 3, 4 and 6 (as published in ETSI TR 103 138)
 
-    - Bugs fixes and code improvements
+* A per-band gain verification tool (gain\_chk) for codec and speech-processing validation
 
-Recommendation ITU-T G.191 includes an electronic attachment containing STL2024 and manual.
+* Cross-platform portability fixes with expanded CTest regression coverage
+
+Recommendation ITU-T G.191 includes an electronic attachment containing STL2026 and manual.
 
 ## Keywords