Struct TileLayer 

pub struct TileLayer { /* private fields */ }

A raster tile layer that fetches slippy-map tiles from a source.

Implementations

impl TileLayer

pub fn new( name: impl Into<String>, source: Box<dyn TileSource>, cache_capacity: usize, ) -> Self

Create a new tile layer.

pub fn new_with_selection_config( name: impl Into<String>, source: Box<dyn TileSource>, cache_capacity: usize, selection_config: TileSelectionConfig, ) -> Self

Create a new tile layer with an explicit tile-selection policy.

pub fn update( &mut self, viewport_bounds: &WorldBounds, zoom: u8, camera_world: (f64, f64), camera_distance: f64, )

Update tile fetching for the current frame.

pub fn update_with_view( &mut self, viewport_bounds: &WorldBounds, zoom: u8, camera_world: (f64, f64), camera_distance: f64, flat_view: Option<&FlatTileView>, )

Update tile fetching for the current frame with optional footprint-aware flat-view selection parameters.

pub fn update_with_frustum( &mut self, frustum: &Frustum, zoom: u8, camera_world: (f64, f64), )

Update tile fetching for the current frame using frustum-based quadtree traversal (MapLibre-equivalent coveringTiles path).

pub fn update_with_covering( &mut self, frustum: &Frustum, cam: &CoveringCamera, opts: &CoveringTilesOptions, camera_world: (f64, f64), )

Update tile fetching using MapLibre-equivalent covering-tiles traversal with per-tile variable zoom heuristics.

This is the preferred path for steep-pitch terrain views where distant tiles should use lower zoom levels than near tiles.

pub fn visible_tiles(&self) -> &VisibleTileSet

The set of tiles visible in the last update.

pub fn desired_tiles(&self) -> &HashSet<TileId>

The set of source tiles the manager last considered the desired view.

pub fn last_selection_stats(&self) -> &TileSelectionStats

Read-only access to the most recent tile-selection/update stats.

pub fn counters(&self) -> &TileManagerCounters

Read-only access to cumulative tile-manager counters.

pub fn cache_stats(&self) -> TileCacheStats

Snapshot counts of the current tile-cache state.

pub fn source_diagnostics(&self) -> Option<TileSourceDiagnostics>

Optional runtime diagnostics from the underlying tile source.

pub fn lifecycle_diagnostics(&self) -> TileLifecycleDiagnostics

Snapshot of recent tile lifecycle diagnostics.

pub fn selection_config(&self) -> &TileSelectionConfig

Read-only access to the tile-selection policy.

pub fn set_selection_config(&mut self, config: TileSelectionConfig)

Replace the tile-selection policy.

pub fn manager(&self) -> &TileManager

Access the underlying tile manager.

pub fn promote_decoded(&mut self, decoded: Vec<(TileId, TileResponse)>)

Promote externally decoded tiles into the tile manager’s cache.

See TileManager::promote_decoded for details.

pub fn prefetch_with_view( &mut self, viewport_bounds: &WorldBounds, zoom: u8, camera_world: (f64, f64), flat_view: Option<&FlatTileView>, max_requests: usize, ) -> usize

Speculatively prefetch tiles for a predicted viewport without changing the current visible tile set.

pub fn prefetch_zoom_direction( &mut self, camera_world: (f64, f64), direction: ZoomPrefetchDirection, max_requests: usize, ) -> usize

Speculatively prefetch tiles implied by the current desired set and a zoom direction.

pub fn prefetch_route( &mut self, route: &[GeoCoord], zoom: u8, camera_world: (f64, f64), max_requests: usize, ) -> usize

Speculatively prefetch tiles along a geographic route polyline.

See TileManager::prefetch_route for details.

Trait Implementations

impl Layer for TileLayer

fn id(&self) -> LayerId

A process-unique identifier for this layer.

fn kind(&self) -> LayerKind

The concrete layer type for enum-based dispatch.

fn name(&self) -> &str

Human-readable name for UI and debug output.

fn visible(&self) -> bool

Whether this layer participates in the current frame.

fn set_visible(&mut self, visible: bool)

Toggle visibility on or off.

fn opacity(&self) -> f32

Layer opacity in the range [0.0, 1.0].

fn set_opacity(&mut self, opacity: f32)

Set the layer opacity.

fn as_any(&self) -> &dyn Any

Borrow the layer as &dyn Any for concrete type access.

fn as_any_mut(&mut self) -> &mut dyn Any

Borrow the layer as &mut dyn Any for mutable concrete type access.

fn z_index(&self) -> i32

Hint for render ordering within the layer stack.