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
72
73
74
75
76
77
78
79
80
81
82
83
84
85

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

use super::*;
use crate::{EncodeError, J2kForwardDwt53Output, PrecomputedHtj2k53Component};
use alloc::vec;

fn image() -> PrecomputedHtj2k53Image {
    PrecomputedHtj2k53Image {
        width: 1,
        height: 1,
        bit_depth: 8,
        signed: false,
        components: vec![PrecomputedHtj2k53Component {
            x_rsiz: 1,
            y_rsiz: 1,
            dwt: J2kForwardDwt53Output {
                ll: vec![1.0],
                ll_width: 1,
                ll_height: 1,
                levels: Vec::new(),
            },
        }],
    }
}

fn options() -> EncodeOptions {
    EncodeOptions {
        num_decomposition_levels: 0,
        reversible: true,
        use_ht_block_coding: true,
        code_block_width_exp: 2,
        code_block_height_exp: 2,
        ..EncodeOptions::default()
    }
}

struct FailingHtBatchAccelerator;

impl J2kEncodeStageAccelerator for FailingHtBatchAccelerator {
    fn encode_ht_code_blocks(
        &mut self,
        _jobs: &[crate::J2kHtCodeBlockEncodeJob<'_>],
    ) -> crate::J2kEncodeStageResult<Option<Vec<crate::EncodedHtJ2kCodeBlock>>> {
        Err(crate::J2kEncodeStageError::internal_invariant(
            "injected precomputed 5/3 Tier-1 failure",
        ))
    }
}

#[test]
fn public_precomputed_53_keeps_invalid_input_and_accelerator_categories() {
    let mut invalid = image();
    invalid.width = 0;
    assert_eq!(
        encode_precomputed_htj2k_53(&invalid, &options()),
        Err(EncodeError::InvalidInput {
            what: "invalid dimensions",
        })
    );

    let error = encode_precomputed_htj2k_53_with_accelerator(
        &image(),
        &options(),
        &mut FailingHtBatchAccelerator,
    )
    .expect_err("accelerator failure must remain typed");
    assert_eq!(
        error,
        EncodeError::Accelerator {
            operation: "HT Tier-1 code-block batch encode",
            source: crate::J2kEncodeStageError::internal_invariant(
                "injected precomputed 5/3 Tier-1 failure",
            ),
        }
    );

    let mut invalid_dwt = image();
    invalid_dwt.components[0].dwt.ll.clear();
    assert_eq!(
        encode_precomputed_htj2k_53(&invalid_dwt, &options()),
        Err(EncodeError::InvalidInput {
            what: "accelerated DWT output length mismatch",
        })
    );
}