j2k-native 0.7.3

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

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

//! Validation and fallible materialization of component sampling metadata.

use alloc::vec::Vec;

use crate::j2c::encode::{
    EncodeOptions, NativeEncodePipelineError, NativeEncodePipelineResult, NativeEncodeSession,
};

use super::PlanConstruction;

pub(in crate::j2c::encode::single_tile::plan) fn validate_component_sampling(
    options: &EncodeOptions,
    num_components: u16,
) -> Result<(), &'static str> {
    let Some(component_sampling) = &options.component_sampling else {
        return Ok(());
    };
    if component_sampling.len() != usize::from(num_components) {
        return Err("component sampling count does not match component count");
    }
    if component_sampling
        .iter()
        .any(|&(x_rsiz, y_rsiz)| x_rsiz == 0 || y_rsiz == 0)
    {
        return Err("component sampling factors must be non-zero");
    }
    Ok(())
}

pub(in crate::j2c::encode::single_tile::plan) fn try_component_sampling(
    options: &EncodeOptions,
    num_components: u16,
    session: &NativeEncodeSession<'_>,
) -> NativeEncodePipelineResult<Vec<(u8, u8)>> {
    validate_component_sampling(options, num_components)
        .map_err(NativeEncodePipelineError::invalid_input)?;
    let mut construction = PlanConstruction::new(session, 0);
    let count = usize::from(num_components);
    let mut sampling = construction.try_vec(count, "single-tile component sampling")?;
    match &options.component_sampling {
        Some(source) => sampling.extend_from_slice(source),
        None => sampling.resize(count, (1, 1)),
    }
    Ok(sampling)
}