Struct FileTileCache 

pub struct FileTileCache { /* private fields */ }

Stores tiles in a slippy-map directory tree on disk ({root}/{z}/{x}/{y}.{ext}). Compatible with every common tile bundle layout (the OSM standard, MapTiler exports, Mapbox tile downloads). The bundled sample-tiles/ is one of these.

Implementations

impl FileTileCache

pub fn new(root: impl Into<PathBuf>) -> Self

pub fn with_extension(self, ext: impl Into<String>) -> Self

Override the tile file extension (default "png").

pub fn path_for(&self, key: TileKey) -> PathBuf

Absolute on-disk path for the given tile.

pub fn root(&self) -> &Path

Filesystem root this cache writes under.

Trait Implementations

impl TileCache for FileTileCache

fn get(&self, key: TileKey) -> Option<Image>

Look up the cached tile, decoded as a slint::Image. Returns None if the tile isn’t cached (or if its bytes failed to decode). Implementations should be cheap on the miss path.

fn put(&self, key: TileKey, bytes: &[u8]) -> Result<(), CacheError>

Store raw bytes (typically a PNG payload exactly as the source served it — the cache is encoding-agnostic). Errors here are returned but a fetching source will typically just log and keep going.

fn contains(&self, key: TileKey) -> bool

Quick existence check that avoids the decode cost of get. Default implementation falls back to get(key).is_some() — override on backends where existence is cheaper to test.

fn get_bytes(&self, key: TileKey) -> Option<Vec<u8>>

Read the raw bytes for a tile, if cached. Used by sources that want to do their own (off-UI-thread) decoding rather than the in-thread decode that get performs. Default returns None — backends that store raw bytes (FileTileCache) should override.