Crate freedesktop_icons_greedy

source ·
Expand description

freedesktop-icons

This crate provides a freedesktop icon lookup implementation.

It exposes a single lookup function to find icons based on their name, theme, size and scale.

Example

Simple lookup:

The following snippet get an icon from the default ‘hicolor’ theme with the default scale (1) and the default size (24).

use freedesktop_icons_greedy::lookup;

let icon = lookup("firefox").find();

Complex lookup:

If you have specific requirements for your lookup you can use the provided builder functions:

use freedesktop_icons_greedy::lookup;

let icon = lookup("firefox")
    .with_size(48)
    .with_scale(2)
    .with_theme("Arc")
    .find();

Cache:

If your application is going to repeat the same icon lookups multiple times you can use the internal cache to improve performance.

use freedesktop_icons_greedy::lookup;

let icon = lookup("firefox")
    .with_size(48)
    .with_scale(2)
    .with_theme("Arc")
    .with_cache()
    .find();

Structs

  • LookupBuilder
    The lookup builder struct, holding all the lookup query parameters.

Functions

  • list_themes
    Return the list of installed themes on the system
  • lookup
    Build an icon lookup for the given icon name.