mlt-core 0.9.2

MapLibre Tile library code
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

use std::ops::Deref;

use crate::decoder::{RawPresence, RawStream};
use crate::utils::Presence;
use crate::utils::analyze::AnalyzeViaDeref;
use crate::{DecodeState, Lazy};

/// ID column representation, parameterized by decode state.
///
/// - `Id<'a>` / `Id<'a, Lazy>` — either raw bytes or decoded, in a [`crate::LazyParsed`] enum.
/// - `Id<'a, Parsed>` — decoded [`ParsedId`] directly (no enum wrapper).
pub type Id<'a, S = Lazy> = <S as DecodeState>::LazyOrParsed<RawId<'a>, ParsedId<'a>>;

/// Unparsed ID data as read directly from the tile (borrows from input bytes)
#[derive(Debug, PartialEq, Clone)]
pub struct RawId<'a> {
    pub(crate) presence: RawPresence<'a>,
    pub(crate) value: RawIdValue<'a>,
}

/// A sequence of raw ID values, either 32-bit or 64-bit unsigned integers
#[derive(Debug, PartialEq, Clone)]
pub enum RawIdValue<'a> {
    Id32(RawStream<'a>),
    Id64(RawStream<'a>),
}

/// Decoded ID column.
///
/// A transparent type over [`Presence<'a, u64>`]. All feature-access methods
/// (`get`, `feature_count`, `dense_values`, `materialize`, `is_present`) are
/// available via auto-deref.
///
/// The lifetime `'a` allows zero-copy decoding when the inner bitvector borrows
/// from the source bytes. When the presence stream is RLE-decompressed, the inner
/// `Cow` becomes owned and no longer borrows from the input.
// TODO: consider converting ParsedId to an enum with u32 vs u64 for performance
#[derive(Clone, Debug, PartialEq)]
pub struct ParsedId<'a>(pub(crate) Presence<'a, u64>);

impl<'a> Deref for ParsedId<'a> {
    type Target = Presence<'a, u64>;

    #[inline]
    fn deref(&self) -> &Self::Target {
        &self.0
    }
}

impl AnalyzeViaDeref for ParsedId<'_> {}