j2k-jpeg 0.7.0

JPEG inspect/decode and fallback encode support 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

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

use alloc::sync::Arc;

use super::{SharedJpegInput, SharedJpegInputInner, SharedJpegInputStorage};
use crate::adapter::fast_packet::cache::shared_allocation::{
    shared_owner_bytes, shared_slice_owner_bytes,
};
use crate::adapter::fast_packet::JpegPlanCacheError;

impl SharedJpegInput {
    /// Retained payload capacity of the copied vector or fixed Arc slice.
    #[must_use]
    pub fn data_capacity(&self) -> usize {
        match &self.0 {
            SharedJpegInputStorage::Copied(input) => input.bytes.capacity(),
            SharedJpegInputStorage::ArcSlice(input) => input.len(),
        }
    }

    /// Whether two handles share the same input allocation.
    #[must_use]
    pub fn ptr_eq(left: &Self, right: &Self) -> bool {
        match (&left.0, &right.0) {
            (SharedJpegInputStorage::Copied(left), SharedJpegInputStorage::Copied(right)) => {
                Arc::ptr_eq(left, right)
            }
            (SharedJpegInputStorage::ArcSlice(left), SharedJpegInputStorage::ArcSlice(right)) => {
                Arc::ptr_eq(left, right)
            }
            (SharedJpegInputStorage::Copied(_), SharedJpegInputStorage::ArcSlice(_))
            | (SharedJpegInputStorage::ArcSlice(_), SharedJpegInputStorage::Copied(_)) => false,
        }
    }

    /// Retained bytes charged to a cache entry for this shared input.
    ///
    /// Byte-vector capacity or fixed Arc-slice length is exact. See the type
    /// documentation for the Arc control-block limitation.
    ///
    /// # Errors
    ///
    /// Returns an invariant error if retained-byte arithmetic overflows.
    pub fn retained_cache_bytes(&self) -> Result<usize, JpegPlanCacheError> {
        match &self.0 {
            SharedJpegInputStorage::Copied(input) => {
                shared_owner_bytes::<SharedJpegInputInner>(input.bytes.capacity())
            }
            SharedJpegInputStorage::ArcSlice(input) => shared_slice_owner_bytes(input.len()),
        }
    }
}