Struct DynamicImageOverlayLayer 

pub struct DynamicImageOverlayLayer { /* private fields */ }

A georeferenced overlay with dynamic frame content.

This is the Rustial equivalent of MapLibre / Mapbox video and canvas source types. A FrameProvider supplies RGBA8 frames which are rendered as a textured quad at the specified geographic coordinates.

The layer caches the most recent frame and tracks a generation counter for change detection. Renderers see this layer through the same ImageOverlayData path as ImageOverlayLayer, so no renderer changes are required.

Implementations

impl DynamicImageOverlayLayer

pub fn new( name: impl Into<String>, coordinates: [GeoCoord; 4], provider: Box<dyn FrameProvider>, ) -> Self

Create a new dynamic image overlay layer.

coordinates must be in TL → TR → BR → BL order.

pub fn coordinates(&self) -> &[GeoCoord; 4]

Geographic corners (TL, TR, BR, BL).

pub fn set_coordinates(&mut self, coordinates: [GeoCoord; 4])

Update the geographic corners.

pub fn generation(&self) -> u64

Monotonic generation counter, bumped on coordinate or frame changes.

pub fn dimensions(&self) -> (u32, u32)

Cached frame dimensions (width, height).

pub fn has_frame(&self) -> bool

Whether at least one frame has been received.

pub fn poll_frame(&mut self) -> bool

Poll the frame provider for new data.

Returns true if a new frame was received and the cached data was updated.

pub fn to_overlay_data( &self, projection: CameraProjection, ) -> Option<ImageOverlayData>

Produce renderer-ready overlay data by projecting geographic corners into the active world-space coordinate system.

Returns None if no frame has been received yet.

pub fn provider(&self) -> &dyn FrameProvider

Access the underlying frame provider.

pub fn provider_mut(&mut self) -> &mut dyn FrameProvider

Access the underlying frame provider mutably.

Trait Implementations

impl Debug for DynamicImageOverlayLayer

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Layer for DynamicImageOverlayLayer

fn id(&self) -> LayerId

A process-unique identifier for this layer.

fn name(&self) -> &str

Human-readable name for UI and debug output.

fn kind(&self) -> LayerKind

The concrete layer type for enum-based dispatch.

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.