zaxis 0.0.5

An event-driven immediate mode GUI for desktop tools
Documentation
//! Paint descriptions to cached meshes and this pass's elements.
//!
//! One paint call goes through the same stages every time: routing (`route`), visual
//! materialization (`visual`), identity (a repeated id draws under an alias), resource
//! requests, reuse of the cached mesh (`cache`) or tessellation (`tessellate`), and
//! emission of the element. The data lives in [`PaintState`] (`state`).

mod cache;
mod data;
mod route;
mod state;
mod tessellate;
mod visual;

use super::{Context, Id};
use crate::Rect;
use cache::Reuse;

pub use data::{MaterialImage, Paint};
pub use state::CachedElement;
pub(crate) use state::PaintState;
pub use visual::VisualMesh;

impl Context {
    pub(crate) fn paint(&mut self, id: Id, layer: Id, clip: Rect, paint: Vec<Paint>) {
        let Some(paint) = self.route_paint(id, layer, clip, paint) else {
            return;
        };
        let paint = match visual::flatten(paint) {
            Ok(visual) => return self.paint_visual(id, layer, clip, visual),
            Err(paint) => paint,
        };
        self.paint_state.drop_visual(id);
        let id = self.claim_paint_id(id);
        let paint_scale = self.request_painted_images(&paint, clip);
        // Shape once in layout units; rasterize glyphs and curves at displayed resolution.
        // Quarter-step buckets bound the sizes generated by continuous visual zoom.
        let raster_scale = if self.paint_state.image_visual_scale() == 1.0 {
            self.scale
        } else {
            (self.scale * self.paint_state.image_visual_scale() * 4.0)
                .ceil()
                .clamp(1.0, 128.0)
                / 4.0
        };
        // Image contours use actual display resolution; text/curves use the raster
        // bucket. Either kind changing invalidates a mixed description's mesh.
        let cache_scale = if paint_scale == self.scale {
            raster_scale
        } else {
            paint_scale
        };
        let frame = self.frame;
        let reuse =
            self.paint_state
                .reuse(id, &paint, clip, cache_scale, raster_scale, &mut self.text);
        match reuse {
            Reuse::Hidden => self.paint_state.touch(id, frame),
            Reuse::Translated(delta) => {
                self.paint_state.translate(id, delta, paint, frame);
                self.stats.reused_elements += 1;
                self.paint_state.emit(id, layer, clip, false);
            }
            Reuse::Unchanged => {
                self.stats.reused_elements += 1;
                self.paint_state.touch(id, frame);
                self.paint_state.emit(id, layer, clip, true);
            }
            Reuse::Rebuild => {
                let mesh = tessellate::mesh(&mut self.text, &paint, raster_scale, paint_scale);
                self.paint_state.store(id, paint, cache_scale, mesh, frame);
                self.stats.tessellated_elements += 1;
                self.paint_state.emit(id, layer, clip, true);
            }
        }
    }

    /// The id this paint is drawn under: its own, or an alias when it was already painted
    /// in this pass, which is reported.
    fn claim_paint_id(&mut self, id: Id) -> Id {
        match self.paint_state.claim(id) {
            Ok(id) => id,
            Err(alias) => {
                self.report_paint_collision(id);
                alias
            }
        }
    }
}