Struct AssetImageSource 

pub struct AssetImageSource { /* private fields */ }

The default image source: GPUI’s image loader (Window::use_asset::<ImgResourceLoader>), which reads and decodes in the background, renders an SVG in its own colours, and repaints the grid when an image is ready. An animated GIF shows its first frame.

The id says where the image is:

Id	Image	In a browser
http://…, https://…	A URI, fetched by the application’s HTTP client (App::set_http_client); without one, missing	With gpui_web’s FetchHttpClient installed (and the server allowing the page’s origin); without it, missing
An absolute path	A file	Missing: no file system
Anything else	An asset of the application’s AssetSource	Works

A missing image is never an error of the frame: the cell is empty and its text stays in the tooltip and for a screen reader.

Every image loaded is kept, as GPUI keeps its assets: memory grows with the number of different images shown. Self::with_capacity keeps the most recently used ones only. A clone shares the cache, so an application can keep one to read Self::asset_requests.

Implementations

impl AssetImageSource

pub fn with_capacity(self, capacity: usize) -> Self

Keeps at most capacity images (at least one), dropping the least recently used one, and GPUI’s copy of it, when another one comes. The images of one frame are never dropped for one another: while more different images than capacity are on screen, it keeps them all.

pub fn asset_requests(&self) -> u64

How many times this source asked GPUI’s asset cache for an image: an image asks once a frame while it loads, and never once it is ready or missing. For benchmarks and tests.

pub fn len(&self) -> usize

The images kept now, loaded or not.

pub fn is_empty(&self) -> bool

Returns true if no image is kept.

Trait Implementations

impl CellImageSource for AssetImageSource

fn image(&self, id: &str, window: &mut Window, cx: &mut App) -> CellImage

The image for id now.

impl Clone for AssetImageSource

fn clone(&self) -> AssetImageSource

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for AssetImageSource

fn default() -> AssetImageSource

Returns the “default value” for a type.

impl From<AssetImageSource> for CellImages

fn from(source: AssetImageSource) -> Self

Converts to this type from the input type.