Proposed STL2026 release

.gitattributes

@@ -0,0 +1,2 @@
+# Binary test data files - prevent CRLF corruption
+src/unsup/test_data/cftest1.dat binary

.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

@@ -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)

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,23 @@ 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
+* Cross-platform portability fixes with expanded CTest regression coverage
 
-    - Bugs fixes and code improvements
-
-Recommendation ITU-T G.191 includes an electronic attachment containing STL2024 and manual.
+Recommendation ITU-T G.191 includes an electronic attachment containing STL2026 and manual.
 
 ## Keywords
 

doc/g191_Annex_A.md

@@ -40,6 +40,9 @@ The following programs are examples of the use of the modules:
 | `stereoop.c`         | on the use of stereo file operations.                                                                                                                                                                            |
 | `esdru.c`            | on the use of energy-based spatial distortion reference unit [ITU-T P.811].                                                                                                                                                          |
 | `wmc_tool.cpp`            | on the use of WMC tool for speech and audio codecs complexity and memory measurement.                                                                                                                                                          |
+| `dlyerr_2_errpat.c`  | on the use of the delay/error profile to frame-erasure pattern conversion tool for jitter buffer emulation. |
+| `eid-amr.c`          | on the use of the EID for 3GPP AMR codec frame erasure simulation using G.192 error patterns. |
+| `random.c`           | on the use of the pseudo-random selection tool for deterministic item selection or range drawing. |
 || 
 
 
@@ -85,6 +88,12 @@ The functions included are as follows:
 | `LP12_48kHz_init` | initialize a low-pass filter with a cut-off frequency of 12 kHz at (48-kHz sampling). |
 | `LP14_48kHz_init` | initialize a low-pass filter with a cut-off frequency of 14 kHz at 48-kHz sampling). |
 | `LP20_48kHz_init` | initialize a low-pass filter with a cut-off frequency of 20 kHz (48-kHz sampling). |
+| `shq_up_1_to_2_init` | initialize 1:2 SHQ half-band up-sampling filter. |
+| `shq_up_1_to_3_init` | initialize 1:3 SHQ up-sampling filter. |
+| `shq_down_2_to_1_init` | initialize 2:1 SHQ half-band down-sampling filter. |
+| `shq_down_3_to_1_init` | initialize 3:1 SHQ down-sampling filter. |
+| `hp50_32khz_init` | initialize 50-Hz high-pass filter (32-kHz sampling). |
+| `hp50_48khz_init` | initialize 50-Hz high-pass filter (48-kHz sampling). |
 | `hq_kernel` | FIR filtering function. |
 | `hq_reset` | clear state variables. |
 | `hq_free` | deallocate FIR-filter memory. |
@@ -710,4 +719,22 @@ The main program for WMC Tool. Depends on:
 `wmc_auto_c.txt`      Auto-generated C source file for inclusion in projects.
 ------------------------------------------------------------------------------------------
 
+## u) Delay/error profile to frame-erasure pattern conversion
+
+Name: `dlyerr_2_errpat.c`
+
+Converts a delay-and-error profile (one entry per packet with network delay in ms and a loss flag) into a frame-erasure error pattern suitable for use with the `eid-xor` tool. Supports fixed-delay and bounded-loss-rate jitter buffer emulation modes. Output formats include G.192 word, G.192 byte, and text.
+
+## v) EID for 3GPP AMR codec
+
+Name: `eid-amr.c`
+
+Applies G.192 frame erasure patterns to 3GPP AMR bitstreams. The standard `eid-xor` tool cannot be used directly with AMR because the AMR bitstream follows the ETSI/3GPP format rather than ITU-T G.192. Lost frames are signalled with frame type NO\_DATA and all data bits are forced to zero.
+
+## w) Pseudo-random selection tool
+
+Name: `random.c`
+
+Provides deterministic pseudo-random selection of items from a list or drawing of integers from a numeric range. Uses the EID linear congruential generator for cross-platform reproducibility. Supports configurable seed, dummy pre-runs, and multi-item selection.
+
 -=Pagebreak=-

doc/manual/Makefile

@@ -1,7 +1,7 @@
 BIBTEX = bibtex
 PDFLATEX = pdflatex
 
-PARTS = STLmanual.tex intro.tex g711.tex g711iplc.tex g726.tex g727.tex g728.tex g722.tex rpe.tex rate.tex eid.tex mnru.tex sv56.tex reverb.tex truncate.tex freqresp.tex stereoop.tex esdru.tex bs1770demo.tex basop.tex utl.tex wmc_tool.tex
+PARTS = STLmanual.tex intro.tex g711.tex g711iplc.tex g726.tex g727.tex g728.tex g722.tex rpe.tex rate.tex eid.tex mnru.tex sv56.tex reverb.tex truncate.tex freqresp.tex stereoop.tex esdru.tex bs1770demo.tex  gain_chk.tex basop.tex utl.tex wmc_tool.tex
 
 STLmanual.pdf : $(PARTS) bibliography.bib
 	$(PDFLATEX) $(PARTS)

doc/manual/STLmanual.tex

@@ -18,7 +18,7 @@
 \addtolength{\itemsep}{-20pt}
 
 % Define headers
-\def\ugst_title{ ITU-T Software Tool Library, release 2024}
+\def\ugst_title{ ITU-T Software Tool Library, release 2026}
 \def\us{$\mu$s}
 \markboth{  \hspace{1cm} \hfill \ugst_title }%
          { Version: \today \hfill \hspace{1cm} }
@@ -61,7 +61,7 @@
 \pagenumbering{roman}
 
 %==============================================================================
-\title{ITU-T Software Tool Library 2024 User's Manual}
+\title{ITU-T Software Tool Library 2026 User's Manual}
 \author{ITU-T Users' Group on Software Tools}
 
 %------------------------------------------------------------------------------
@@ -71,7 +71,7 @@
 
 \ruley{100mm}
 
- Copyright \copyright~ 2005, 2006, 2009, 2019, 2022, 2023 and 2024 by the International
+ Copyright \copyright~ 2005, 2006, 2009, 2019, 2022, 2023, 2024 and 2026 by the International
  Telecommunication Union (ITU)
 
 \ruley{15mm}
@@ -182,6 +182,11 @@
 %=============================================================================
 \include{freqresp}
 
+%=============================================================================
+% chapter gain_chk: Gain amplification verification tool
+%=============================================================================
+\include{gain_chk}
+
 %=============================================================================
 % chapter stereoop: Stereo processing tool
 %=============================================================================

doc/manual/basop.tex

@@ -1008,27 +1008,27 @@ \subsection{Variable definitions}
 \subsection{Operators with complexity weight of 1}
 
 %........................................................
-\NewOperator{CL\_shr(CL\_var1, var2)}
+\NewOperator{CL\_shr(CL\_var1, L\_var2)}
 
-Arithmetically shifts right the real and imaginary parts of the 32-bit complex number CL\_var1 by var2 positions.\\
-If var2 is negative, real and imaginary parts of CL\_var1 are shifted to the most significant bits by (-var2) positions with 32-bit saturation control.\\
-If var2 is positive, real and imaginary parts of CL\_var1 are shifted to the least significant bits by (var2) positions with sign extension.\\
+Arithmetically shifts right the real and imaginary parts of the 32-bit complex number CL\_var1 by L\_var2 positions.\\
+If L\_var2 is negative, real and imaginary parts of CL\_var1 are shifted to the most significant bits by (-L\_var2) positions with 32-bit saturation control.\\
+If L\_var2 is positive, real and imaginary parts of CL\_var1 are shifted to the least significant bits by (L\_var2) positions with sign extension.\\
 The following code snippet describes the operations performed on real \& imaginary part of a complex number:
 
-{\tt \rulex{5mm}CL\_result.re = L\_shr(CL\_var1.re, L\_shift\_val);\\
-\rulex{5mm}CL\_result.im = L\_shr(CL\_var1.im, L\_shift\_val);\\
+{\tt \rulex{5mm}CL\_result.re = L\_shr(CL\_var1.re, L\_var2);\\
+\rulex{5mm}CL\_result.im = L\_shr(CL\_var1.im, L\_var2);\\
 }
 
 %........................................................
-\NewOperator{CL\_shl(CL\_var1, var2)}
+\NewOperator{CL\_shl(CL\_var1, L\_var2)}
 
-Arithmetically shifts left the real and imaginary parts of the 32-bit complex number CL\_var1 by L\_shift\_val positions.\\
-If var2 is negative, real and imaginary parts of CL\_var1 are shifted to the least significant bits by ( -var2 ) positions with sign extension.\\
-If var2 is positive, real and imaginary parts of CL\_var1 are shifted to the most significant bits by (var2) positions with 32-bit saturation control.\\
+Arithmetically shifts left the real and imaginary parts of the 32-bit complex number CL\_var1 by L\_var2 positions.\\
+If L\_var2 is negative, real and imaginary parts of CL\_var1 are shifted to the least significant bits by ( -L\_var2 ) positions with sign extension.\\
+If L\_var2 is positive, real and imaginary parts of CL\_var1 are shifted to the most significant bits by (L\_var2) positions with 32-bit saturation control.\\
 The following code snippet describes the operations performed on real \& imaginary part of a complex number:
 
-{\tt \rulex{5mm} CL\_result.re = L\_shl(CL\_var1.re, L\_shift\_val);\\
-\rulex{5mm} CL\_result.im = L\_shl(CL\_var1.im, L\_shift\_val);
+{\tt \rulex{5mm} CL\_result.re = L\_shl(CL\_var1.re, L\_var2);\\
+\rulex{5mm} CL\_result.im = L\_shl(CL\_var1.im, L\_var2);
 }
 
 %........................................................
@@ -1503,7 +1503,7 @@ \subsection{Operators with complexity weight of 1}
 Multiplies 16-bit var1 by 16-bit var2, sign extends to 64 bits; subtracts this 64 bit value from the 64 bit W\_acc without saturation control, and returns a 64 bit result.
 
 %........................................................
-\NewOperator{W\_mult\_16\_16(W\_acc, var1, var2)}
+\NewOperator{W\_mult\_16\_16(var1, var2)}
 
 \textbf{ This operator is SIMD and VLIW friendly}
 
@@ -1542,29 +1542,29 @@ \subsection{Operators with complexity weight of 1}
 Deposits the 32-bit L\_var1 into the 32 MS bits of the 64-bit output. The 32 LS bits of the output are zeroed.
 
 %........................................................
-\NewOperator{W\_sat\_l(W\_v1)}
+\NewOperator{W\_sat\_l(W\_var1)}
 
-Saturates the 64-bit variable W\_v1 to 32-bit value and returns the lower 32 bits.\\
+Saturates the 64-bit variable W\_var1 to 32-bit value and returns the lower 32 bits.\\
 For example, a 64-bit wide accumulator is helpful in accumulating 16*16 multiplies without checking for saturation.
 However, at the end of the multiply-and-accumulate loop, we need to return only the 32-bit value after checking for saturation.\\
-If W\_v1 is in 33Q31 format, then the result returned will be saturated to 1Q31 format.
+If W\_var1 is in 33Q31 format, then the result returned will be saturated to 1Q31 format.
 
 %........................................................
-\NewOperator{W\_sat\_m(W\_v1)}
+\NewOperator{W\_sat\_m(W\_var1)}
 
-Arithmetically shifts right the 64-bit variable W\_v1 by 16 bits; saturates the 64-bit value to 32-bit value and returns the lower 32 bits.\\
+Arithmetically shifts right the 64-bit variable W\_var1 by 16 bits; saturates the 64-bit value to 32-bit value and returns the lower 32 bits.\\
 For example, a 64-bit wide accumulator is helpful in accumulating 32\*16 multiplies without checking for saturation.
 A 32\*16 multiply gives a 48-bit product; at the end of the multiply-and-accumulate loop, the result is in the lower 48 bits of the 64-bit accumulator.
 Now an arithmetic right shift by 16 bits will drop the LSB 16 bits.
 Now we should check for saturation and return the lower 32 bits.\\
-If W\_var is in 17Q47 format, then the result returned will be saturated to 1Q31 format.
+If W\_var1 is in 17Q47 format, then the result returned will be saturated to 1Q31 format.
 
 %........................................................
-\NewOperator{W\_shl\_sat\_l(W\_1, var1)}
+\NewOperator{W\_shl\_sat\_l(W\_var1, L\_var2)}
 
-Arithmetically shifts left the 64-bit W\_v1 by v1 positions with lower 32-bit saturation and returns the 32 LSB of 64-bit result.\\
-If v1 is negative, the result is shifted to right by (-var1) positions and sign extended.
-After shift operation, returns the 32 MSB of 64-bit result.
+Arithmetically shifts left the 64-bit W\_var1 by L\_var2 positions with lower 32-bit saturation and returns the 32 LSB of 64-bit result.\\
+If L\_var2 is negative, the result is shifted to right by (-L\_var2) positions and sign extended.
+After shift operation, returns the 32 LSB of 64-bit result.
 
 %........................................................
 \NewOperator{W\_extract\_l(W\_var1)}
@@ -1611,7 +1611,7 @@ \subsection{Operators with complexity weight of 1}
 %........................................................
 \NewOperator{W\_neg(W\_var1)}
 
-Negates a 64-bit variables W\_var1 with 64-bit saturation control.
+Negates the 64-bit variable W\_var1 with 64-bit saturation control.
 Set overflow flag. Returns 64-bit result.
 
 %........................................................
@@ -1713,7 +1713,7 @@ \subsection{Operators}
 Returns the 32 MSB of the 64-bit result after truncating of the lower 32 bits.
 The operation is performed in fractional mode.
 
-For example, if L\_var1 is in 1Q31 format and var2 is in 1Q31 format, then the product is produced in 1Q63 format which is then truncated, saturated, and returned in 1Q31 format.
+For example, if L\_var1 is in 1Q31 format and L\_var2 is in 1Q31 format, then the product is produced in 1Q63 format which is then truncated, saturated, and returned in 1Q31 format.
 
 The following code snippet describes the operations performed: