edgefirst-codec 0.23.0

Image codec for decoding JPEG/PNG into pre-allocated EdgeFirst tensors
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

// SPDX-FileCopyrightText: Copyright 2026 Au-Zone Technologies
// SPDX-License-Identifier: Apache-2.0

//! Zero-allocation validation for the codec hot path.
//!
//! Run under `strace` to verify no `brk`/`mmap` syscalls occur after warmup:
//!
//! ```bash
//! cargo build --release -p edgefirst-codec --example zero_alloc_check
//! strace -e brk,mmap -f ./target/release/examples/zero_alloc_check 2>&1 \
//!     | grep -A9999 'HOT LOOP START'
//! ```
//!
//! Expected: zero `brk` or `mmap` lines between "HOT LOOP START" and
//! "HOT LOOP END".

use edgefirst_codec::{DecodeOptions, ImageDecoder, ImageLoad};
use edgefirst_tensor::{PixelFormat, Tensor, TensorMemory};

fn main() {
    let testdata = std::env::var("EDGEFIRST_TESTDATA_DIR")
        .map(std::path::PathBuf::from)
        .unwrap_or_else(|_| std::path::PathBuf::from("testdata"));
    let jpeg = std::fs::read(testdata.join("zidane.jpg")).expect("testdata/zidane.jpg");

    let mut tensor =
        Tensor::<u8>::image(1920, 1080, PixelFormat::Rgb, Some(TensorMemory::Mem)).unwrap();
    let mut decoder = ImageDecoder::new();
    let opts = DecodeOptions::default()
        .with_format(PixelFormat::Rgb)
        .with_exif(false);

    // Warmup: scratch buffer grows to required size
    tensor.load_image(&mut decoder, &jpeg, &opts).unwrap();
    eprintln!("=== HOT LOOP START ===");

    for _ in 0..100 {
        tensor.load_image(&mut decoder, &jpeg, &opts).unwrap();
    }

    eprintln!("=== HOT LOOP END ===");
    eprintln!("100 decode iterations completed");
}