mlt-core 0.12.4

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
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

use crate::TileLayer;
use crate::encoder::model::ColumnKind;
use crate::encoder::{ExplicitEncoder, IntEncoder, SortStrategy, StagedLayer, VertexBufferType};

impl ExplicitEncoder {
    /// Use `enc` for all integer streams, plain string encoding, and `Vec2` vertex layout.
    #[must_use]
    pub fn all(enc: IntEncoder) -> Self {
        Self {
            vertex_buffer_type: VertexBufferType::Vec2,
            force_stream: Box::new(|_| false),
            get_int_encoder: Box::new(move |_| enc),
            get_str_encoding: Box::new(|_| crate::encoder::StrEncoding::Plain),
        }
    }

    /// Like [`Self::all`] but use `str_enc` for string property columns.
    #[must_use]
    pub fn all_with_str(enc: IntEncoder, str_enc: crate::encoder::StrEncoding) -> Self {
        Self {
            get_str_encoding: Box::new(move |_| str_enc),
            ..Self::all(enc)
        }
    }

    /// Use `id_enc` for the ID stream; `varint` for all other streams.
    ///
    /// Useful for tests that need to pin the exact ID encoding without caring about
    /// geometry or property streams.
    #[must_use]
    pub fn for_id(id_enc: IntEncoder) -> Self {
        Self {
            get_int_encoder: Box::new(move |ctx| {
                if ctx.kind == ColumnKind::Id {
                    id_enc
                } else {
                    IntEncoder::varint()
                }
            }),
            ..Self::all(IntEncoder::varint())
        }
    }
}

#[must_use]
pub fn stage_tile(
    tile: TileLayer,
    sort: SortStrategy,
    allow_shared_dict: bool,
    tessellate: bool,
) -> StagedLayer {
    let analysis = tile.analyze(allow_shared_dict).expect("analyze tile");
    let curve_params = tile.curve_params();
    StagedLayer::from_tile(tile, sort, &analysis, tessellate, curve_params)
}

#[cfg(test)]
mod invariant_tests {
    use crate::decoder::GeometryValues;
    use crate::encoder::{StagedId, StagedLayer, StagedProperty};
    use crate::{MltError, TileLayer};

    #[test]
    fn tile_layer_constructor_rejects_empty_name() {
        assert!(matches!(
            TileLayer::new("", 4096),
            Err(MltError::MissingLayerName)
        ));
    }

    #[test]
    fn staged_layer_constructor_rejects_empty_name() {
        assert!(matches!(
            StagedLayer::new("", 4096, StagedId::None, GeometryValues::default(), vec![]),
            Err(MltError::MissingLayerName)
        ));
    }

    #[test]
    fn staged_layer_constructor_rejects_zero_extent() {
        assert!(matches!(
            StagedLayer::new(
                "layer",
                0,
                StagedId::None,
                GeometryValues::default(),
                vec![]
            ),
            Err(MltError::InvalidExtent(0))
        ));
    }

    #[test]
    fn staged_layer_constructor_rejects_duplicate_property_names() {
        let props = vec![
            StagedProperty::opt_u32("dup", Vec::<Option<u32>>::new()),
            StagedProperty::opt_u32("dup", Vec::<Option<u32>>::new()),
        ];
        assert!(matches!(
            StagedLayer::new("layer", 4096, StagedId::None, GeometryValues::default(), props),
            Err(MltError::DuplicatePropertyName(name)) if name == "dup"
        ));
    }
}