Crate icon_loader

Crate to load and cache themed icons.

Examples

• Loading icons from the default icon theme set in KDE:

use icon_loader::{IconLoader, ThemeNameProvider};

let mut loader = IconLoader::new();
loader.set_theme_name_provider(ThemeNameProvider::KDE);
loader.update_theme_name();

if let Ok(icon) = loader.load_icon("audio-headphones") {
    let path = icon.file_for_size(64).path();
}

• Loading icons from a custom theme in a provided folder:

use icon_loader::IconLoader;

let mut loader = IconLoader::new();
loader.set_search_paths(&["path_to_your_icon_theme"]);
loader.set_theme_name_provider("name_of_your_icon_theme");
loader.update_theme_name();

if let Ok(icon) = loader.load_icon("icon_name") {
    let path = icon.file_for_size(32).path();
}

Structs

Icon

Struct containing information about a themed icon.

IconDir

Struct that holds information about a directory containing a set of icons with a particular size.

IconFile

Struct containing information about a single icon file on disk.

IconLoader

The central icon loader struct.

Enums

Error

Error type returned by this crate.

IconFileType

Enum representing the different file types an icon can be.

IconSizeType

The size type of icons contained in an IconDir.

ProviderError

Error type returned by ThemeNameProvider.

SearchPaths

Enum that provides a list of directories to IconLoader to search for icons in.

ThemeNameProvider

Enum that provides a theme name to IconLoader. It can either load the system theme name from the KDE or GTK config files or provide a fixed string or provide a theme name yielded by a completely customizable function. The last option allows users to load their own config files for example.

Type Definitions

Result

Type alias for std::result::Result<T, Error>