j2k-native 0.7.5

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
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95

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

use super::super::{
    bitplane, ht_block_decode, DirectAllocationBudget, DirectComponentBandScratch,
    DirectComponentPlane, DirectCpuBand, DirectWorkspaceBudget, J2kDirectCpuScratch, Result,
};
use super::view::{
    referenced_band_target, referenced_component_band_count, referenced_component_plane_len,
    referenced_temporary_workspace_bytes, validate_referenced_shape, ReferencedPlanView,
};

pub(super) fn validate_referenced_aggregate_plan(
    plan: ReferencedPlanView<'_>,
    retained_plan_bytes: usize,
    compressed_payload_bytes: usize,
    retained_classic_workspace_dimensions: Option<(u32, u32)>,
    retained_ht_workspace_dimensions: Option<(u32, u32)>,
    scratch: &J2kDirectCpuScratch,
) -> Result<DirectWorkspaceBudget> {
    validate_referenced_shape(plan)?;
    let mut budget = DirectAllocationBudget::default();
    budget.include_bytes(retained_plan_bytes)?;
    let temporary_workspace_bytes = referenced_temporary_workspace_bytes(plan)?;
    include_referenced_scratch_allocations(
        &mut budget,
        plan,
        compressed_payload_bytes,
        retained_classic_workspace_dimensions,
        retained_ht_workspace_dimensions,
        scratch,
    )?;
    let base_bytes = budget.bytes;
    budget.include_bytes(temporary_workspace_bytes)?;
    Ok(DirectWorkspaceBudget {
        base_bytes,
        peak_bytes: budget.bytes,
    })
}

fn include_referenced_scratch_allocations(
    budget: &mut DirectAllocationBudget,
    plan: ReferencedPlanView<'_>,
    compressed_payload_bytes: usize,
    retained_classic_workspace_dimensions: Option<(u32, u32)>,
    retained_ht_workspace_dimensions: Option<(u32, u32)>,
    scratch: &J2kDirectCpuScratch,
) -> Result<()> {
    let component_count = plan.component_count();
    budget.include_capacity::<DirectComponentBandScratch>(
        scratch.component_band_sets.capacity().max(component_count),
    )?;
    budget.include_capacity::<DirectComponentPlane>(
        scratch.component_planes.capacity().max(component_count),
    )?;
    for component_index in 0..component_count {
        let band_count = referenced_component_band_count(plan, component_index)?;
        let component = scratch.component_band_sets.get(component_index);
        budget.include_capacity::<DirectCpuBand>(
            component
                .map_or(0, |component| component.bands.capacity())
                .max(band_count),
        )?;
        for band_index in 0..band_count {
            let target_len = referenced_band_target(plan, component_index, band_index)?;
            let retained_capacity = component
                .and_then(|component| component.bands.get(band_index))
                .map_or(0, |band| band.coefficients.capacity());
            budget.include_capacity::<f32>(retained_capacity.max(target_len))?;
        }
        let plane_len = referenced_component_plane_len(plan, component_index)?;
        let retained_capacity = scratch
            .component_planes
            .get(component_index)
            .map_or(0, |plane| plane.samples.capacity());
        budget.include_capacity::<f32>(retained_capacity.max(plane_len))?;
    }
    budget.include_capacity::<u8>(
        scratch
            .compressed_payload
            .capacity()
            .max(compressed_payload_bytes),
    )?;
    let retained_classic_workspace_bytes = scratch.classic_workspace.allocated_bytes()?;
    let target_classic_workspace_bytes = retained_classic_workspace_dimensions
        .map_or(Ok(0), |(width, height)| {
            bitplane::classic_decode_workspace_bytes(width, height)
        })?;
    budget.include_bytes(retained_classic_workspace_bytes.max(target_classic_workspace_bytes))?;
    let retained_ht_workspace_bytes = scratch.ht_workspace.allocated_bytes()?;
    let target_ht_workspace_bytes = retained_ht_workspace_dimensions
        .map_or(Ok(0), |(width, height)| {
            ht_block_decode::ht_decode_workspace_bytes(width, height)
        })?;
    budget.include_bytes(retained_ht_workspace_bytes.max(target_ht_workspace_bytes))
}