j2k-native 0.7.0

Pure-Rust JPEG 2000 and HTJ2K codec engine for j2k
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74

// SPDX-License-Identifier: MIT OR Apache-2.0

// Per-segment distortion reduction used by PCRD allocation.

use super::super::coefficient_view::{CoefficientBlockView, SignedCoefficient};

#[cfg(test)]
pub(super) fn segment_distortion_delta(
    coefficients: &[i64],
    start_coding_pass: u8,
    end_coding_pass: u8,
    num_bitplanes: u8,
) -> f64 {
    let view = CoefficientBlockView::try_contiguous(coefficients, coefficients.len(), 1)
        .expect("test distortion coefficients are contiguous");
    segment_distortion_delta_view(view, start_coding_pass, end_coding_pass, num_bitplanes)
}

pub(super) fn segment_distortion_delta_view<T: SignedCoefficient>(
    coefficients: CoefficientBlockView<'_, T>,
    start_coding_pass: u8,
    end_coding_pass: u8,
    num_bitplanes: u8,
) -> f64 {
    let before =
        coefficient_distortion_after_passes(coefficients, start_coding_pass, num_bitplanes);
    let after = coefficient_distortion_after_passes(coefficients, end_coding_pass, num_bitplanes);
    (before - after).max(f64::EPSILON)
}

#[expect(
    clippy::cast_precision_loss,
    reason = "PCRD distortion is intentionally accumulated in f64 after integer reconstruction"
)]
fn coefficient_distortion_after_passes<T: SignedCoefficient>(
    coefficients: CoefficientBlockView<'_, T>,
    completed_passes: u8,
    num_bitplanes: u8,
) -> f64 {
    coefficients
        .rows()
        .flatten()
        .map(|&coefficient| {
            let magnitude = coefficient.unsigned_magnitude();
            let reconstructed =
                reconstructed_magnitude_after_passes(magnitude, completed_passes, num_bitplanes);
            let error = magnitude.saturating_sub(reconstructed) as f64;
            error * error
        })
        .sum()
}

fn reconstructed_magnitude_after_passes(
    magnitude: u64,
    completed_passes: u8,
    num_bitplanes: u8,
) -> u64 {
    if magnitude == 0 || completed_passes == 0 || num_bitplanes == 0 {
        return 0;
    }

    let deepest_coded_bitplane = completed_passes
        .saturating_sub(1)
        .div_ceil(3)
        .min(num_bitplanes.saturating_sub(1));
    let retained_bitplanes = deepest_coded_bitplane.saturating_add(1);
    if retained_bitplanes >= num_bitplanes {
        return magnitude;
    }

    let lower_bits = u32::from(num_bitplanes - retained_bitplanes);
    let mask = !((1u64 << lower_bits) - 1);
    magnitude & mask
}