j2k-transcode 0.6.1

JPEG to J2K and HTJ2K transcode primitives 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
96
97
98
99
100
101
102
103
104
105
106

// SPDX-License-Identifier: Apache-2.0

use j2k_test_support::{
    JPEG_BASELINE_420_16X16, JPEG_BASELINE_422_16X8, JPEG_BASELINE_444_8X8, JPEG_GRAYSCALE_8X8,
};
use j2k_transcode::corpus_validation::{
    load_external_wsi_fixtures, validate_transcode_corpus, CorpusFixture, CorpusValidationError,
    CorpusValidationOptions,
};
use j2k_transcode::TranscodeValidationClassification;
use std::{fs, path::PathBuf};

#[test]
fn committed_conformance_fixtures_produce_error_report() {
    let fixtures = conformance_fixtures();

    let report = validate_transcode_corpus(&fixtures, &CorpusValidationOptions::default())
        .expect("validate committed transcode corpus");

    assert_eq!(report.fixture_count, fixtures.len());
    assert!(report.sample_count >= 64);
    assert_eq!(report.exact_match_count, report.sample_count);
    assert_eq!(report.max_abs_error, 0);
    assert_eq!(
        report.classification,
        TranscodeValidationClassification::Exact
    );
    assert_eq!(
        report.histogram_buckets.get(&0).copied(),
        Some(report.sample_count)
    );
    assert!(report
        .fixtures
        .iter()
        .all(|fixture| fixture.classification == TranscodeValidationClassification::Exact));
}

#[test]
fn external_wsi_loader_discovers_limited_jpeg_inputs() {
    let root = unique_temp_dir("j2k-transcode-corpus");
    let nested = root.join("nested");
    fs::create_dir_all(&nested).expect("create temp corpus");
    fs::write(root.join("ignore.txt"), b"not a jpeg").expect("write ignored file");
    fs::write(root.join("a.jpg"), conformance_fixtures()[0].bytes).expect("write first jpeg");
    fs::write(nested.join("b.jpeg"), conformance_fixtures()[1].bytes).expect("write nested jpeg");

    let options = CorpusValidationOptions {
        external_wsi_roots: vec![root.clone()],
        external_tile_limit: 1,
        ..CorpusValidationOptions::default()
    };

    let fixtures = load_external_wsi_fixtures(&options).expect("load external WSI fixtures");

    assert_eq!(fixtures.len(), 1);
    assert!(fixtures[0].name.ends_with("a.jpg"));
    let report = validate_transcode_corpus(&[fixtures[0].as_fixture()], &options)
        .expect("validate loaded external fixture");
    assert_eq!(report.fixture_count, 1);

    let _ = fs::remove_dir_all(root);
}

#[test]
fn external_wsi_loader_can_require_configured_roots() {
    let options = CorpusValidationOptions {
        require_external_wsi: true,
        ..CorpusValidationOptions::default()
    };

    let err = load_external_wsi_fixtures(&options).expect_err("missing roots should fail");

    assert!(matches!(
        err,
        CorpusValidationError::MissingRequiredExternalCorpus(_)
    ));
}

fn conformance_fixtures() -> Vec<CorpusFixture<'static>> {
    vec![
        CorpusFixture {
            name: "grayscale_8x8",
            bytes: JPEG_GRAYSCALE_8X8,
        },
        CorpusFixture {
            name: "baseline_444_8x8",
            bytes: JPEG_BASELINE_444_8X8,
        },
        CorpusFixture {
            name: "baseline_422_16x8",
            bytes: JPEG_BASELINE_422_16X8,
        },
        CorpusFixture {
            name: "baseline_420_16x16",
            bytes: JPEG_BASELINE_420_16X16,
        },
    ]
}

fn unique_temp_dir(prefix: &str) -> PathBuf {
    let unique = std::time::SystemTime::now()
        .duration_since(std::time::UNIX_EPOCH)
        .expect("system time after epoch")
        .as_nanos();
    std::env::temp_dir().join(format!("{prefix}-{}-{unique}", std::process::id()))
}