Struct MapSettings 

pub struct MapSettings {
    pub max_zoom: f32,
    pub min_zoom: f32,
    pub line_visible_zoom: f32,
    pub label_visible_zoom: f32,
    pub node_text_visibility: VisibilitySetting,
    pub marker_animation: SteadyAnimation,
    pub node_text_size: f32,
    pub label_text_size: f32,
    pub styles: Vec<Style>,
}

Configuration of a Map widget.

MapSettings::default() provides sensible zoom limits plus a light and a dark theme; the widget picks the style to apply based on egui::Visuals::dark_mode, using styles[0] in light mode and styles[1] in dark mode.

Fields

max_zoom: f32

Maximum zoom factor.

min_zoom: f32

Minimum zoom factor.

line_visible_zoom: f32

Zoom threshold above which connection lines become visible.

label_visible_zoom: f32

Zoom threshold above which node names become visible when node_text_visibility is VisibilitySetting::Always.

node_text_visibility: VisibilitySetting

Controls when node names are displayed.

marker_animation: SteadyAnimation

Effect drawn on nodes registered with Map::update_marker.

Persistent, so it keeps the app repainting for as long as a marker exists. Ignored when a NodeTemplate is installed.

Node state set through NodeHandle picks its own effect per node and does not read this field.

node_text_size: f32

Font size, in screen pixels, of the node names.

This is a screen-space size: it deliberately does not scale with the zoom factor, so a name stays exactly as readable when the map is zoomed all the way out as when it is zoomed in. Because the nodes pack closer together as you zoom out while the names keep their size, names take up proportionally more of the view down there — use label_visible_zoom or node_text_visibility to control when they are worth showing at all.

label_text_size: f32

Font size, in screen pixels, of the free-floating MapLabels.

Screen-space, exactly like node_text_size.

styles: Vec<Style>

Per-mode styles; index 0 is used in light mode, index 1 in dark mode. Their colors are kept in sync with the active MapTheme – see Map::set_theme – rather than set here.

Implementations

impl MapSettings

pub fn new() -> Self

Creates settings with all zoom thresholds set to 0.0 and a single transparent style.

Prefer MapSettings::default() unless you really need to build the configuration from scratch.

Trait Implementations

impl Clone for MapSettings

fn clone(&self) -> MapSettings

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MapSettings

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

Formats the value using the given formatter.

impl Default for MapSettings

fn default() -> Self

Returns the default configuration: zoom from 0.1 to 2.0, connection lines visible above 0.2, node names above 0.58, and built-in light and dark themes.