Struct IconCache

pub struct IconCache { /* private fields */ }

In-memory cache of rasterized Lucide / Devicon / SVG icons.

Entries live for the lifetime of the cache; there is no eviction. SVG parse failure is cached as a transparent square, and unsupported Devicons use the framework’s generic-file glyph.

Examples

use ailloli_ui_render_wgpu::icons::IconCache;
let cache = IconCache::new();
let _ = cache;

Implementations

impl IconCache

pub fn new() -> Self

Loads the bundled Lucide and Devicon fonts and creates an empty cache.

Panics

Panics only if a bundled, build-time font asset is invalid.

Examples

use ailloli_ui_render_wgpu::icons::IconCache;
let cache = IconCache::new();
let _ = cache;

pub fn get_or_create( &mut self, device: &Device, queue: &Queue, bind_group_layout: &BindGroupLayout, key: &IconKey, ) -> &IconGpu

Returns the cached GPU icon or rasterizes and uploads it once.

key.px_size is clamped upward to eight for allocation and rasterization, while the original key is retained. The returned reference remains valid until the cache is mutably borrowed again.

Panics

Panics on impossible cache inconsistency or GPU allocation validation failure. Invalid SVG itself produces a transparent texture instead.

Examples

use ailloli_ui_render_wgpu::{icons::IconCache, IconKey};
fn upload<'a>(cache: &'a mut IconCache, device: &wgpu::Device,
    queue: &wgpu::Queue, layout: &wgpu::BindGroupLayout,
    key: &IconKey) -> &'a ailloli_ui_render_wgpu::icons::IconGpu {
    cache.get_or_create(device, queue, layout, key)
}

pub fn get(&self, key: &IconKey) -> Option<&IconGpu>

Looks up a previously uploaded icon without mutating the cache.

Returns None before Self::get_or_create has inserted the exact key.

Examples

use ailloli_ui_core::IconId;
use ailloli_ui_render_wgpu::{icons::IconCache, IconKey};
let cache = IconCache::new();
let key = IconKey { icon: IconId::Plus, px_size: 16, scale_100: 100 };
assert!(cache.get(&key).is_none());

Trait Implementations

impl Default for IconCache

fn default() -> Self

Returns the “default value” for a type.