Struct ArchiveReader 

pub struct ArchiveReader { /* private fields */ }

Reader for an STT archive.

The archive file is memory-mapped on open; tile payload reads serve slices directly out of the mapping rather than allocating + pread-ing a fresh Vec<u8> per call. For warm caches this is allocation-free.

Implementations

impl ArchiveReader

pub fn open<P: AsRef<Path>>(path: P) -> Result<Self>

Open an archive for reading.

pub fn metadata(&self) -> &Metadata

Archive metadata.

pub fn header(&self) -> &ArchiveHeader

Parsed header.

pub fn dictionary(&self) -> Option<&[u8]>

Shared zstd dictionary, if the archive ships one.

pub fn entries(&self) -> &[TileEntry]

All directory entries (sorted by zoom then Hilbert index).

pub fn tiles_at_time(&self, t: i64) -> Vec<&TileEntry>

Directory entries of every tile whose interval contains time t.

pub fn find_tile(&self, zoom: u8, x: u32, y: u32, t: i64) -> Option<&TileEntry>

Look up one tile by exact (zoom, x, y, time).

pub fn read_payload(&self, entry: &TileEntry) -> Result<Vec<u8>>

Read and decompress a tile’s raw payload bytes, verifying its CRC32C.

pub fn read_layers(&self, entry: &TileEntry) -> Result<Vec<DecodedLayer>>

Read and decode a tile into its Arrow layers.