Struct PlaceholderStyle 

pub struct PlaceholderStyle {
    pub background_color: [f32; 4],
    pub skeleton_line_color: [f32; 4],
    pub animate: bool,
    pub shimmer_speed: f32,
    pub shimmer_amplitude: f32,
}

Visual configuration for loading-placeholder tiles.

A single instance is stored on MapState and applies to all sources. All colours use linear RGBA [f32; 4].

Fields

background_color: [f32; 4]

Background fill colour for the placeholder quad.

Default: light grey [0.90, 0.90, 0.90, 1.0].

skeleton_line_color: [f32; 4]

Colour of optional skeleton-chrome lines drawn inside the placeholder to hint at future geometry (roads, blocks, etc.).

Set the alpha to 0 to disable skeleton lines entirely.

Default: slightly darker grey [0.82, 0.82, 0.82, 1.0].

animate: bool

Whether the pulsing shimmer animation is enabled.

When true, renderers modulate the placeholder opacity using LoadingPlaceholder::animation_phase.

Default: true.

shimmer_speed: f32

Speed of the shimmer animation in cycles per second.

Higher values produce a faster pulse. Ignored when animate is false.

Default: 1.2 Hz.

shimmer_amplitude: f32

Peak-to-trough opacity amplitude of the shimmer effect.

A value of 0.15 means the opacity oscillates between 1.0 - 0.15 = 0.85 and 1.0.

Default: 0.15.

Implementations

impl PlaceholderStyle

pub fn new() -> Self

Create a placeholder style with the default settings.

pub fn with_background_color(self, color: [f32; 4]) -> Self

Builder: set the background fill colour.

pub fn with_skeleton_line_color(self, color: [f32; 4]) -> Self

Builder: set the skeleton line colour.

pub fn with_animate(self, animate: bool) -> Self

Builder: enable or disable shimmer animation.

pub fn with_shimmer_speed(self, speed: f32) -> Self

Builder: set the shimmer animation speed in Hz.

pub fn with_shimmer_amplitude(self, amplitude: f32) -> Self

Builder: set the shimmer amplitude.

pub fn shimmer_opacity(&self, phase: f32) -> f32

Compute the shimmer opacity multiplier for a given animation phase.

Returns a value in [1.0 - amplitude, 1.0] when animate is true, or 1.0 when disabled.

Trait Implementations

impl Clone for PlaceholderStyle

fn clone(&self) -> PlaceholderStyle

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PlaceholderStyle

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

Formats the value using the given formatter.

impl Default for PlaceholderStyle

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for PlaceholderStyle

fn eq(&self, other: &PlaceholderStyle) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for PlaceholderStyle