j2k-native 0.7.2

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

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

//! Owned decomposed-or-packed coefficient sources.

use alloc::vec::Vec;

use super::{DwtBandView, DwtComponentSource, DwtLevelView};
use crate::j2c::encode::{DwtDecomposition, NativeEncodePipelineResult};
use crate::j2c::fdwt::{PackedDwtGeometry, PackedSubbandView};

pub(in crate::j2c::encode) enum OwnedDwtComponent {
    Decomposed(DwtDecomposition),
    Packed(PackedF32DwtComponent),
}

pub(in crate::j2c::encode) struct PackedF32DwtComponent {
    pub(in crate::j2c::encode) coefficients: Vec<f32>,
    pub(in crate::j2c::encode) geometry: PackedDwtGeometry,
}

impl DwtComponentSource for OwnedDwtComponent {
    fn ll(&self) -> NativeEncodePipelineResult<DwtBandView<'_>> {
        match self {
            Self::Decomposed(decomposition) => decomposition.ll(),
            Self::Packed(packed) => packed.ll(),
        }
    }

    fn level_count(&self) -> usize {
        match self {
            Self::Decomposed(decomposition) => decomposition.level_count(),
            Self::Packed(packed) => packed.level_count(),
        }
    }

    fn level(&self, index: usize) -> NativeEncodePipelineResult<Option<DwtLevelView<'_>>> {
        match self {
            Self::Decomposed(decomposition) => decomposition.level(index),
            Self::Packed(packed) => packed.level(index),
        }
    }
}

impl DwtComponentSource for PackedF32DwtComponent {
    fn ll(&self) -> NativeEncodePipelineResult<DwtBandView<'_>> {
        let rect = self.geometry.ll()?;
        Ok(DwtBandView::Packed(PackedSubbandView::try_new(
            &self.coefficients,
            rect,
        )?))
    }

    fn level_count(&self) -> usize {
        usize::from(self.geometry.num_levels())
    }

    fn level(&self, index: usize) -> NativeEncodePipelineResult<Option<DwtLevelView<'_>>> {
        let Ok(index) = u8::try_from(index) else {
            return Ok(None);
        };
        if index >= self.geometry.num_levels() {
            return Ok(None);
        }
        let level = self.geometry.level(index)?;
        Ok(Some(DwtLevelView {
            hl: DwtBandView::Packed(PackedSubbandView::try_new(&self.coefficients, level.hl)?),
            lh: DwtBandView::Packed(PackedSubbandView::try_new(&self.coefficients, level.lh)?),
            hh: DwtBandView::Packed(PackedSubbandView::try_new(&self.coefficients, level.hh)?),
        }))
    }
}