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

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

//! Nested session derivation for parent-owned encode phases.

use super::{NativeEncodeRetainedInput, NativeEncodeSession};
use crate::EncodeResult;

impl NativeEncodeSession<'_> {
    /// Derive a nested encode session whose baseline includes owners retained
    /// by the current phase.
    ///
    /// The returned session borrows this session, preserving the lifetime of
    /// the original caller-owned graph while a child tile or other nested
    /// encode runs. `phase_owners` must contain borrows of every owner counted
    /// by `additional_bytes`; the original retained input is included exactly
    /// once.
    pub(crate) fn checked_child_session<'session, O: ?Sized>(
        &'session self,
        phase_owners: &'session O,
        additional_bytes: usize,
        what: &'static str,
    ) -> EncodeResult<NativeEncodeSession<'session>> {
        let retained_bytes = self.checked_phase(additional_bytes, what)?.retained_bytes();
        Ok(NativeEncodeSession {
            retained_input: NativeEncodeRetainedInput::from_owner_bytes(
                phase_owners,
                retained_bytes,
            ),
            cap: self.cap,
        })
    }
}