Method ensure

src/renderer.rs:207–239

Ensure a font is loaded (no-op if already cached).

(asset: &'static FontAsset)

    /// Ensure a font is loaded (no-op if already cached).
    pub async fn ensure(asset: &'static FontAsset) {
        // Check if already loaded (quick lock)
        {
            let mut fm = FONT_MANAGER.lock().unwrap();
            // Already the default font?
            if fm.default_font.as_ref().map(|d| d.key) == Some(asset.key()) {
                return;
            }
            // Already in cache?
            if let Some(data) = fm.fonts.get_mut(asset.key()) {
                data.frames_not_used = 0;
                return;
            }
        }

        // Load outside the lock
        let font = match asset {
            FontAsset::Bytes { data, .. } => {
                macroquad::text::load_ttf_font_from_bytes(data)
                    .expect("Failed to load font from bytes")
            }
            FontAsset::Path(path) => {
                let resolved = resolve_asset_path(path);
                macroquad::text::load_ttf_font(resolved).await
                    .unwrap_or_else(|e| panic!("Failed to load font '{}': {:?}", path, e))
            }
        };

        // Insert with lock
        let mut fm = FONT_MANAGER.lock().unwrap();
        let key = asset.key();
        fm.fonts.entry(key).or_insert(FontData { frames_not_used: 0, font });
    }

    pub fn clean(&mut self) {
        self.fonts.retain(|_, data| data.frames_not_used <= self.max_frames_not_used);