voice_engine/media/codecs/
g722.rs

1use super::{Decoder, Encoder};
2use crate::{media::PcmBuf, media::Sample};
3pub enum Bitrate {
4    Mode1_64000,
5    Mode2_56000,
6    Mode3_48000,
7}
8
9// Quantization decision thresholds used in the encoder
10const QUANT_DECISION_LEVEL: [i32; 32] = [
11    0, 35, 72, 110, 150, 190, 233, 276, 323, 370, 422, 473, 530, 587, 650, 714, 786, 858, 940,
12    1023, 1121, 1219, 1339, 1458, 1612, 1765, 1980, 2195, 2557, 2919, 0, 0,
13];
14
15// Negative quantization interval indices
16const QUANT_INDEX_NEG: [i32; 32] = [
17    0, 63, 62, 31, 30, 29, 28, 27, 26, 25, 24, 23, 22, 21, 20, 19, 18, 17, 16, 15, 14, 13, 12, 11,
18    10, 9, 8, 7, 6, 5, 4, 0,
19];
20
21// Positive quantization interval indices
22const QUANT_INDEX_POS: [i32; 32] = [
23    0, 61, 60, 59, 58, 57, 56, 55, 54, 53, 52, 51, 50, 49, 48, 47, 46, 45, 44, 43, 42, 41, 40, 39,
24    38, 37, 36, 35, 34, 33, 32, 0,
25];
26
27// Scale factor adaptation table for low band
28const SCALE_FACTOR_ADJUST_LOW: [i32; 8] = [-60, -30, 58, 172, 334, 538, 1198, 3042];
29
30// Mapping from 4 bits of low band code to 3 bits of logarithmic scale factor
31const LOG_SCALE_FACTOR_MAP: [i32; 16] = [0, 7, 6, 5, 4, 3, 2, 1, 7, 6, 5, 4, 3, 2, 1, 0];
32
33// Inverse logarithmic base for computing the scale factor
34const INV_LOG_BASE: [i32; 32] = [
35    2048, 2093, 2139, 2186, 2233, 2282, 2332, 2383, 2435, 2489, 2543, 2599, 2656, 2714, 2774, 2834,
36    2896, 2960, 3025, 3091, 3158, 3228, 3298, 3371, 3444, 3520, 3597, 3676, 3756, 3838, 3922, 4008,
37];
38
39// Quantizer multipliers for 4-bit low band
40const QUANT_MULT_LOW_4BIT: [i32; 16] = [
41    0, -20456, -12896, -8968, -6288, -4240, -2584, -1200, 20456, 12896, 8968, 6288, 4240, 2584,
42    1200, 0,
43];
44
45// Quantizer multipliers for 2-bit high band
46const QUANT_MULT_HIGH_2BIT: [i32; 4] = [-7408, -1616, 7408, 1616];
47
48// QMF filter coefficients for band splitting and reconstruction
49const QMF_FILTER_COEFS: [i32; 12] = [3, -11, 12, 32, -210, 951, 3876, -805, 362, -156, 53, -11];
50
51// Negative high band quantization indices
52const HIGH_QUANT_INDEX_NEG: [i32; 3] = [0, 1, 0];
53
54// Positive high band quantization indices
55const HIGH_QUANT_INDEX_POS: [i32; 3] = [0, 3, 2];
56
57// Scale factor adaptation table for high band
58const SCALE_FACTOR_ADJUST_HIGH: [i32; 3] = [0, -214, 798];
59
60// Mapping from 2 bits of high band code to 2 bits of logarithmic scale factor
61const HIGH_LOG_SCALE_MAP: [i32; 4] = [2, 1, 2, 1];
62
63// Quantizer multipliers for 5-bit quantization (56kbps mode)
64const QUANT_MULT_56K: [i32; 32] = [
65    -280, -280, -23352, -17560, -14120, -11664, -9752, -8184, -6864, -5712, -4696, -3784, -2960,
66    -2208, -1520, -880, 23352, 17560, 14120, 11664, 9752, 8184, 6864, 5712, 4696, 3784, 2960, 2208,
67    1520, 880, 280, -280,
68];
69
70// Quantizer multipliers for 6-bit quantization (64kbps mode)
71const QUANT_MULT_64K: [i32; 64] = [
72    -136, -136, -136, -136, -24808, -21904, -19008, -16704, -14984, -13512, -12280, -11192, -10232,
73    -9360, -8576, -7856, -7192, -6576, -6000, -5456, -4944, -4464, -4008, -3576, -3168, -2776,
74    -2400, -2032, -1688, -1360, -1040, -728, 24808, 21904, 19008, 16704, 14984, 13512, 12280,
75    11192, 10232, 9360, 8576, 7856, 7192, 6576, 6000, 5456, 4944, 4464, 4008, 3576, 3168, 2776,
76    2400, 2032, 1688, 1360, 1040, 728, 432, 136, -432, -136,
77];
78
79impl Bitrate {
80    fn bits_per_sample(&self) -> i32 {
81        match self {
82            Bitrate::Mode1_64000 => 8,
83            Bitrate::Mode2_56000 => 7,
84            Bitrate::Mode3_48000 => 6,
85        }
86    }
87}
88
89/// G.722 ADPCM band state structure used in the codec
90/// Each band (lower and upper) uses an independent state structure
91#[derive(Default)]
92struct G722Band {
93    /// Current signal prediction value (signal estimate)
94    signal_estimate: i32,
95    /// Pole filter output (result from IIR filter part)
96    pole_filter_output: i32,
97    /// Zero filter output (result from FIR filter part)
98    zero_filter_output: i32,
99    /// Reconstructed signal history [current, previous, previous-1]
100    reconstructed_signal: [i32; 3],
101    /// Pole filter coefficients [unused(0), a1, a2]
102    pole_coefficients: [i32; 3],
103    /// Temporary pole filter coefficients [unused(0), a1', a2']
104    pole_coefficients_temp: [i32; 3],
105    /// Partially reconstructed signal history [current, previous, previous-1]
106    partial_reconstructed: [i32; 3],
107    /// Difference signal history [current, previous, ..., previous-5]
108    difference_signal: [i32; 7],
109    /// Zero filter coefficients [unused(0), b1, b2, ..., b6]
110    zero_coefficients: [i32; 7],
111    /// Temporary zero filter coefficients [unused(0), b1', b2', ..., b6']
112    zero_coefficients_temp: [i32; 7],
113    /// Sign bits storage [current signal, previous, ..., previous-5]
114    sign_bits: [i32; 7],
115    /// Log scale factor (used for quantization and dequantization)
116    log_scale_factor: i32,
117    /// Quantizer step size (used for adaptive quantization)
118    quantizer_step_size: i32,
119}
120
121fn saturate(amp: i32) -> i32 {
122    amp.clamp(i16::MIN as i32, i16::MAX as i32)
123}
124
125/// Process Block 4 operations for G.722 ADPCM algorithm
126/// This function performs the predictor adaptation and reconstruction steps
127/// as defined in the G.722 standard
128fn block4(band: &mut G722Band, d: i32) {
129    // Block 4, RECONS - Reconstruct the signal
130    // Set current prediction difference
131    band.difference_signal[0] = d;
132    // Reconstruct signal by adding signal estimate to difference signal
133    band.reconstructed_signal[0] = saturate(band.signal_estimate + d);
134
135    // Block 4, PARREC - Partial reconstruction
136    // Used for predictor adaptation
137    band.partial_reconstructed[0] = saturate(band.zero_filter_output + d);
138
139    // Block 4, UPPOL2 - Update second predictor coefficient
140    // Extract sign bits for adaptation logic
141    band.sign_bits[0] = band.partial_reconstructed[0] >> 15;
142    band.sign_bits[1] = band.partial_reconstructed[1] >> 15;
143    band.sign_bits[2] = band.partial_reconstructed[2] >> 15;
144
145    // Scale first predictor coefficient
146    let a1_scaled = saturate(band.pole_coefficients[1] << 2);
147
148    // Apply sign correlation logic for adaptation direction
149    let mut a2_update = if band.sign_bits[0] == band.sign_bits[1] {
150        -a1_scaled
151    } else {
152        a1_scaled
153    };
154    a2_update = a2_update.min(32767);
155
156    // Apply second level of adaptation based on older samples
157    let mut a2_adj = a2_update >> 7;
158    if band.sign_bits[0] == band.sign_bits[2] {
159        a2_adj += 128;
160    } else {
161        a2_adj -= 128;
162    }
163
164    // Complete second coefficient update with leakage factor
165    a2_adj += (band.pole_coefficients[2] * 32512) >> 15;
166
167    // Limit the coefficient range to prevent instability
168    band.pole_coefficients_temp[2] = a2_adj.clamp(-12288, 12288);
169
170    // Block 4, UPPOL1 - Update first predictor coefficient
171    band.sign_bits[0] = band.partial_reconstructed[0] >> 15; // Current sign
172    band.sign_bits[1] = band.partial_reconstructed[1] >> 15; // Previous sign
173
174    // Apply sign correlation logic for first coefficient
175    let sign_factor = if band.sign_bits[0] == band.sign_bits[1] {
176        192
177    } else {
178        -192
179    };
180    let leakage = (band.pole_coefficients[1] * 32640) >> 15;
181
182    // Calculate new coefficient with both sign and leakage factors
183    band.pole_coefficients_temp[1] = saturate(sign_factor + leakage);
184
185    // Calculate adjustment limit based on second coefficient
186    let limit = saturate(15360 - band.pole_coefficients_temp[2]);
187
188    // Constrain first coefficient based on second coefficient
189    // This prevents instability in the filter
190    if band.pole_coefficients_temp[1] > limit {
191        band.pole_coefficients_temp[1] = limit;
192    } else if band.pole_coefficients_temp[1] < -limit {
193        band.pole_coefficients_temp[1] = -limit;
194    }
195
196    // Block 4, UPZERO - Update zero section (FIR) coefficients
197    let step_size = if d == 0 { 0 } else { 128 };
198    band.sign_bits[0] = d >> 15; // Sign of current difference
199
200    // Update each zero filter coefficient
201    for i in 1..7 {
202        band.sign_bits[i] = band.difference_signal[i] >> 15; // Extract sign
203        // Apply sign correlation logic for adaptation direction
204        let adj = if band.sign_bits[i] == band.sign_bits[0] {
205            step_size
206        } else {
207            -step_size
208        };
209        // Apply leakage factor
210        let leakage = (band.zero_coefficients[i] * 32640) >> 15;
211        // Calculate new coefficient
212        band.zero_coefficients_temp[i] = saturate(adj + leakage);
213    }
214
215    // Block 4, DELAYA - Delay updates for filter memory
216    // Shift the difference signal memory
217    band.difference_signal.copy_within(0..6, 1);
218
219    // Update filter coefficients
220    band.zero_coefficients
221        .copy_from_slice(&band.zero_coefficients_temp);
222
223    // Shift pole filter memory
224    band.reconstructed_signal.copy_within(0..2, 1);
225    band.partial_reconstructed.copy_within(0..2, 1);
226    band.pole_coefficients[1] = band.pole_coefficients_temp[1];
227    band.pole_coefficients[2] = band.pole_coefficients_temp[2];
228
229    // Block 4, FILTEP - Pole section (IIR) filtering
230    // Calculate contribution of the pole section to the signal estimate
231    let r1_adj = saturate(band.reconstructed_signal[1] << 1); // Scale by 2
232    let pole1 = (band.pole_coefficients[1] * r1_adj) >> 15;
233
234    let r2_adj = saturate(band.reconstructed_signal[2] << 1); // Scale by 2
235    let pole2 = (band.pole_coefficients[2] * r2_adj) >> 15;
236
237    // Combined pole section output
238    band.pole_filter_output = saturate(pole1 + pole2);
239
240    // Block 4, FILTEZ - Zero section (FIR) filtering
241    // Calculate contribution of the zero section to the signal estimate
242    band.zero_filter_output = 0;
243    for i in 1..7 {
244        let d_adj = saturate(band.difference_signal[i] << 1); // Scale by 2
245        band.zero_filter_output += (band.zero_coefficients[i] * d_adj) >> 15;
246    }
247    band.zero_filter_output = saturate(band.zero_filter_output);
248
249    // Block 4, PREDIC - Prediction
250    // Final signal estimate is sum of pole and zero section outputs
251    band.signal_estimate = saturate(band.pole_filter_output + band.zero_filter_output);
252}
253
254pub struct G722Encoder {
255    packed: bool,
256    eight_k: bool,
257    bits_per_sample: i32,
258    x: [i32; 24],
259    band: [G722Band; 2],
260    out_buffer: u32,
261    out_bits: i32,
262}
263
264pub struct G722Decoder {
265    packed: bool,
266    eight_k: bool,
267    bits_per_sample: i32,
268    x: [i32; 24],
269    band: [G722Band; 2],
270    in_buffer: u32,
271    in_bits: i32,
272}
273
274impl G722Encoder {
275    pub fn new() -> Self {
276        Self::with_options(Bitrate::Mode1_64000, false, false)
277    }
278
279    /// Creates an encoder with specified bitrate and options
280    pub fn with_options(rate: Bitrate, eight_k: bool, packed: bool) -> Self {
281        let mut encoder = Self {
282            packed,
283            eight_k,
284            bits_per_sample: rate.bits_per_sample(),
285            x: [0; 24],
286            band: [G722Band::default(), G722Band::default()],
287            out_buffer: 0,
288            out_bits: 0,
289        };
290
291        // Initialize band states with correct starting values
292        encoder.band[0].log_scale_factor = 32 << 2; // Initial det value for lower band
293        encoder.band[1].log_scale_factor = 8 << 2; // Initial det value for upper band
294
295        encoder
296    }
297
298    /// Encode 16-bit PCM samples into G.722 format
299    /// This function follows the G.722 standard algorithm exactly
300    fn g722_encode(&mut self, amp: &[i16]) -> Vec<u8> {
301        // Pre-allocate output buffer with appropriate capacity
302        let mut output = Vec::with_capacity(amp.len() / 2 + 1);
303
304        // Initialize processing variables for low and high bands
305        let mut xlow: i32;
306        let mut xhigh: i32 = 0;
307        let mut input_idx = 0;
308
309        // Process all input samples
310        while input_idx < amp.len() {
311            // Split input into low and high bands based on mode
312            if self.eight_k {
313                // 8kHz mode - Just use input directly with scaling
314                xlow = amp[input_idx] as i32 >> 1;
315                input_idx += 1;
316            } else {
317                // 16kHz mode - Apply QMF analysis filter to split bands
318                // Shuffle buffer down to make room for new samples
319                self.x.copy_within(2..24, 0);
320
321                // Add new samples to buffer
322                self.x[22] = amp[input_idx] as i32;
323                input_idx += 1;
324                self.x[23] = if input_idx < amp.len() {
325                    amp[input_idx] as i32
326                } else {
327                    0 // Handle edge case at end of buffer
328                };
329                input_idx += 1;
330
331                // Apply QMF filter to split input into bands
332                let mut sumeven = 0;
333                let mut sumodd = 0;
334                for i in 0..12 {
335                    sumodd += self.x[2 * i] * QMF_FILTER_COEFS[i];
336                    sumeven += self.x[2 * i + 1] * QMF_FILTER_COEFS[11 - i];
337                }
338
339                // Scale filter outputs to get low and high bands
340                xlow = (sumeven + sumodd) >> 14;
341                xhigh = (sumeven - sumodd) >> 14;
342            }
343
344            // Process low band (always performed)
345            let code = if self.eight_k {
346                // 8kHz mode - only low band matters
347                self.encode_low_band(xlow, true)
348            } else {
349                // 16kHz mode - encode both bands
350                let ilow = self.encode_low_band(xlow, false);
351                let ihigh = self.encode_high_band(xhigh);
352                (ihigh << 6 | ilow) >> (8 - self.bits_per_sample)
353            };
354
355            // Output the encoded code
356            self.output_code(code, &mut output);
357        }
358
359        // Handle any remaining bits in the output buffer
360        if self.packed && self.out_bits > 0 {
361            output.push((self.out_buffer & 0xFF) as u8);
362        }
363
364        output
365    }
366
367    /// Encode low band sample and update state
368    /// Returns the encoded low band bits
369    fn encode_low_band(&mut self, xlow: i32, is_eight_k: bool) -> i32 {
370        // Block 1L, SUBTRA - Calculate difference signal
371        let el = saturate(xlow - self.band[0].signal_estimate);
372
373        // Block 1L, QUANTL - Quantize difference signal
374        let wd = if el >= 0 { el } else { -(el + 1) };
375
376        // Find quantization interval
377        let mut quantization_idx = 1;
378        while quantization_idx < 30 {
379            let decision_level =
380                (QUANT_DECISION_LEVEL[quantization_idx] * self.band[0].log_scale_factor) >> 12;
381            if wd < decision_level {
382                break;
383            }
384            quantization_idx += 1;
385        }
386
387        // Select output bits based on sign
388        let ilow = if el < 0 {
389            QUANT_INDEX_NEG[quantization_idx]
390        } else {
391            QUANT_INDEX_POS[quantization_idx]
392        };
393
394        // Block 2L, INVQAL - Inverse quantize for prediction
395        let ril = ilow >> 2;
396        let wd2 = QUANT_MULT_LOW_4BIT[ril as usize];
397        let dlow = (self.band[0].log_scale_factor * wd2) >> 15;
398
399        // Block 3L, LOGSCL - Update scale factor
400        let il4 = LOG_SCALE_FACTOR_MAP[ril as usize];
401        let mut nb = (self.band[0].quantizer_step_size * 127) >> 7;
402        nb += SCALE_FACTOR_ADJUST_LOW[il4 as usize];
403        self.band[0].quantizer_step_size = nb.clamp(0, 18432);
404
405        // Block 3L, SCALEL - Compute new quantizer scale factor
406        let wd1 = self.band[0].quantizer_step_size >> 6 & 31;
407        let wd2 = 8 - (self.band[0].quantizer_step_size >> 11);
408        let wd3 = if wd2 < 0 {
409            INV_LOG_BASE[wd1 as usize] << -wd2
410        } else {
411            INV_LOG_BASE[wd1 as usize] >> wd2
412        };
413        self.band[0].log_scale_factor = wd3 << 2;
414
415        // Apply predictor adaptation (ADPCM core algorithm)
416        block4(&mut self.band[0], dlow);
417
418        // Return appropriate value based on mode
419        if is_eight_k {
420            ((0xc0 | ilow) >> 8) - self.bits_per_sample
421        } else {
422            ilow
423        }
424    }
425
426    /// Encode high band sample and update state
427    /// Returns the encoded high band bits
428    fn encode_high_band(&mut self, xhigh: i32) -> i32 {
429        // Block 1H, SUBTRA - Calculate difference signal
430        let eh = saturate(xhigh - self.band[1].signal_estimate);
431
432        // Block 1H, QUANTH - Quantize difference signal
433        let wd = if eh >= 0 { eh } else { -(eh + 1) };
434        let decision_level = (564 * self.band[1].log_scale_factor) >> 12;
435
436        // Determine quantization level for high band (2-bit)
437        let mih = if wd >= decision_level { 2 } else { 1 };
438        let ihigh = if eh < 0 {
439            HIGH_QUANT_INDEX_NEG[mih as usize]
440        } else {
441            HIGH_QUANT_INDEX_POS[mih as usize]
442        };
443
444        // Block 2H, INVQAH - Inverse quantize for prediction
445        let wd2 = QUANT_MULT_HIGH_2BIT[ihigh as usize];
446        let dhigh = (self.band[1].log_scale_factor * wd2) >> 15;
447
448        // Block 3H, LOGSCH - Update scale factor
449        let ih2 = HIGH_LOG_SCALE_MAP[ihigh as usize];
450        let mut nb = (self.band[1].quantizer_step_size * 127) >> 7;
451        nb += SCALE_FACTOR_ADJUST_HIGH[ih2 as usize];
452        self.band[1].quantizer_step_size = nb.clamp(0, 22528);
453
454        // Block 3H, SCALEH - Compute quantizer scale factor
455        let wd1 = self.band[1].quantizer_step_size >> 6 & 31;
456        let wd2 = 10 - (self.band[1].quantizer_step_size >> 11);
457        let wd3 = if wd2 < 0 {
458            INV_LOG_BASE[wd1 as usize] << -wd2
459        } else {
460            INV_LOG_BASE[wd1 as usize] >> wd2
461        };
462        self.band[1].log_scale_factor = wd3 << 2;
463
464        // Apply predictor adaptation (ADPCM core algorithm)
465        block4(&mut self.band[1], dhigh);
466
467        ihigh
468    }
469
470    /// Add encoded bits to the output buffer
471    fn output_code(&mut self, code: i32, output: &mut Vec<u8>) {
472        if self.packed {
473            // Pack the code bits across byte boundaries
474            self.out_buffer |= (code as u32) << self.out_bits;
475            self.out_bits += self.bits_per_sample;
476
477            // When we have at least 8 bits, output a byte
478            if self.out_bits >= 8 {
479                output.push((self.out_buffer & 0xFF) as u8);
480                self.out_bits -= 8;
481                self.out_buffer >>= 8;
482            }
483        } else {
484            // Direct byte-aligned output
485            output.push(code as u8);
486        }
487    }
488}
489
490impl G722Decoder {
491    pub fn new() -> Self {
492        Self::with_options(Bitrate::Mode1_64000, false, false)
493    }
494
495    pub fn with_options(rate: Bitrate, packed: bool, eight_k: bool) -> Self {
496        Self {
497            packed,
498            eight_k,
499            bits_per_sample: rate.bits_per_sample(),
500            x: Default::default(),
501            band: Default::default(),
502            in_buffer: 0,
503            in_bits: 0,
504        }
505    }
506
507    /// Extracts the next G.722 code from the input data stream
508    fn extract_code(&mut self, data: &[u8], idx: &mut usize) -> i32 {
509        if self.packed {
510            // When packed, bits are combined across bytes
511            if self.in_bits < self.bits_per_sample {
512                self.in_buffer |= (data[*idx] as u32) << self.in_bits;
513                *idx += 1;
514                self.in_bits += 8;
515            }
516            let code = (self.in_buffer & ((1 << self.bits_per_sample) - 1) as u32) as i32;
517            self.in_buffer >>= self.bits_per_sample;
518            self.in_bits -= self.bits_per_sample;
519            code
520        } else {
521            // Direct byte-based access when not packed
522            let code = data[*idx] as i32;
523            *idx += 1;
524            code
525        }
526    }
527
528    /// Parses the G.722 code into low-band word and high-band index based on bit rate
529    fn parse_code(&self, code: i32) -> (i32, i32, i32) {
530        // Returns (wd1, ihigh, wd2) tuple: low-band word, high-band index, and scaled value
531        match self.bits_per_sample {
532            7 => {
533                // 56 kbit/s mode
534                let wd1 = code & 0x1f;
535                let ihigh = (code >> 5) & 0x3;
536                let wd2 = QUANT_MULT_56K[wd1 as usize];
537                (wd1 >> 1, ihigh, wd2)
538            }
539            6 => {
540                // 48 kbit/s mode
541                let wd1 = code & 0xf;
542                let ihigh = (code >> 4) & 0x3;
543                let wd2 = QUANT_MULT_LOW_4BIT[wd1 as usize];
544                (wd1, ihigh, wd2)
545            }
546            _ => {
547                // 64 kbit/s mode (default)
548                let wd1 = code & 0x3f;
549                let ihigh = (code >> 6) & 0x3;
550                let wd2 = QUANT_MULT_64K[wd1 as usize];
551                (wd1 >> 2, ihigh, wd2)
552            }
553        }
554    }
555
556    /// Process the low band component of the G.722 stream
557    fn process_low_band(&mut self, wd1: i32, wd2: i32) -> i32 {
558        // Block 5L, LOW BAND INVQBL - Inverse quantization for low band
559        let dequant = (self.band[0].log_scale_factor * wd2) >> 15;
560
561        // Block 5L, RECONS - Reconstruction of low band signal
562        let rlow = self.band[0].signal_estimate + dequant;
563
564        // Block 6L, LIMIT - Limiting to valid range
565        let rlow = rlow.clamp(-16384, 16383);
566
567        // Block 2L, INVQAL - Inverse adaptive quantizer for prediction
568        let wd2 = QUANT_MULT_LOW_4BIT[wd1 as usize];
569        let dlowt = (self.band[0].log_scale_factor * wd2) >> 15;
570
571        // Block 3L, LOGSCL - Compute log scale factor
572        let wd2 = LOG_SCALE_FACTOR_MAP[wd1 as usize];
573        let mut wd1 = (self.band[0].quantizer_step_size * 127) >> 7;
574        wd1 += SCALE_FACTOR_ADJUST_LOW[wd2 as usize];
575        self.band[0].quantizer_step_size = wd1.clamp(0, 18432);
576
577        // Block 3L, SCALEL - Compute quantizer scale factor
578        let wd1 = (self.band[0].quantizer_step_size >> 6) & 31;
579        let wd2 = 8 - (self.band[0].quantizer_step_size >> 11);
580        let wd3 = if wd2 < 0 {
581            INV_LOG_BASE[wd1 as usize] << -wd2
582        } else {
583            INV_LOG_BASE[wd1 as usize] >> wd2
584        };
585        self.band[0].log_scale_factor = wd3 << 2;
586
587        // Apply predictor adaptation
588        block4(&mut self.band[0], dlowt);
589
590        rlow
591    }
592
593    /// Process the high band component of the G.722 stream
594    fn process_high_band(&mut self, ihigh: i32) -> i32 {
595        // Block 2H, INVQAH - Inverse quantizer for high band
596        let wd2 = QUANT_MULT_HIGH_2BIT[ihigh as usize];
597        let dhigh = (self.band[1].log_scale_factor * wd2) >> 15;
598
599        // Block 5H, RECONS - Reconstruction of high band signal
600        let rhigh = dhigh + self.band[1].signal_estimate;
601
602        // Block 6H, LIMIT - Limiting to valid range
603        let rhigh = rhigh.clamp(-16384, 16383);
604
605        // Block 2H, INVQAH - Adaptation logic
606        let wd2 = HIGH_LOG_SCALE_MAP[ihigh as usize];
607        let mut wd1 = (self.band[1].quantizer_step_size * 127) >> 7;
608        wd1 += SCALE_FACTOR_ADJUST_HIGH[wd2 as usize];
609        self.band[1].quantizer_step_size = wd1.clamp(0, 22528);
610
611        // Block 3H, SCALEH - Compute quantizer scale factor
612        let wd1 = (self.band[1].quantizer_step_size >> 6) & 31;
613        let wd2 = 10 - (self.band[1].quantizer_step_size >> 11);
614        let wd3 = if wd2 < 0 {
615            INV_LOG_BASE[wd1 as usize] << -wd2
616        } else {
617            INV_LOG_BASE[wd1 as usize] >> wd2
618        };
619        self.band[1].log_scale_factor = wd3 << 2;
620
621        // Apply predictor adaptation
622        block4(&mut self.band[1], dhigh);
623
624        rhigh
625    }
626
627    /// Apply QMF synthesis filter to combine low and high band signals
628    fn apply_qmf_synthesis(&mut self, rlow: i32, rhigh: i32) -> [i16; 2] {
629        // Shift filter state
630        self.x.copy_within(2..24, 0);
631
632        // Set new filter state values
633        self.x[22] = rlow + rhigh;
634        self.x[23] = rlow - rhigh;
635
636        // Apply QMF synthesis filter
637        let mut xout1 = 0;
638        let mut xout2 = 0;
639
640        for i in 0..12 {
641            xout2 += self.x[2 * i] * QMF_FILTER_COEFS[i];
642            xout1 += self.x[2 * i + 1] * QMF_FILTER_COEFS[11 - i];
643        }
644
645        // Return reconstructed samples with proper scaling
646        [saturate(xout1 >> 11) as i16, saturate(xout2 >> 11) as i16]
647    }
648
649    /// Decodes a G.722 frame and returns PCM samples
650    /// This is the main decoding function that processes G.722 encoded data
651    pub fn decode_frame(&mut self, data: &[u8]) -> PcmBuf {
652        let mut output = Vec::with_capacity(data.len() * 2);
653        let mut idx = 0;
654
655        while idx < data.len() {
656            // Extract the next code from input data
657            let code = self.extract_code(data, &mut idx);
658
659            // Parse the code into components based on bit rate mode
660            let (wd1, ihigh, wd2) = self.parse_code(code);
661
662            // Process the low band component
663            let rlow = self.process_low_band(wd1, wd2);
664
665            if self.eight_k {
666                // 8kHz mode - use only low band with scaling
667                output.push((rlow << 1) as i16);
668            } else {
669                // 16kHz mode - process high band and combine with QMF synthesis
670                let rhigh = self.process_high_band(ihigh);
671
672                // Apply QMF synthesis filter to get reconstructed samples
673                let samples = self.apply_qmf_synthesis(rlow, rhigh);
674                output.extend_from_slice(&samples);
675            }
676        }
677
678        output
679    }
680}
681
682impl Encoder for G722Encoder {
683    fn encode(&mut self, samples: &[Sample]) -> Vec<u8> {
684        self.g722_encode(samples)
685    }
686
687    fn sample_rate(&self) -> u32 {
688        16000 // G.722 encoding sample rate is 16kHz
689    }
690
691    fn channels(&self) -> u16 {
692        1 // G.722 is mono encoding
693    }
694}
695
696impl Decoder for G722Decoder {
697    fn decode(&mut self, data: &[u8]) -> PcmBuf {
698        self.decode_frame(data)
699    }
700
701    fn sample_rate(&self) -> u32 {
702        16000
703    }
704
705    fn channels(&self) -> u16 {
706        1
707    }
708}