#icon #theme #loader

icon-loader

Crate to load and cache themed icons in 100% safe rust

8 releases

0.3.3 Nov 19, 2020
0.3.2 Oct 29, 2020
0.3.1 Jul 27, 2020
0.2.2 Jun 30, 2020
0.1.0 Jun 17, 2020

#27 in Caching

25 downloads per month

MIT license

40KB
852 lines

unsafe forbidden License

Rust Icon Loader

A crate that loads and caches themed icons in 100% safe rust.

Usage

Just add it to your cargo.toml file like this:

[dependencies]
icon-loader = "0.3"

Cargo-Features

Standard Features

  • kde: Feature that lets you read the default system theme name from '~/.config/kdeglobals'.
  • gtk: Feature that lets you read the default system theme name from '~/.config/gtk-3.0/settings.ini'.

Additional Features

  • theme_error_log: Feature that uses the log crate to log errors that occur while parsing icon themes.

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().unwrap();

let icon = loader.load_icon("audio-headphones").unwrap();
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().unwrap();

let icon = loader.load_icon("icon_name").unwrap();
let path = icon.file_for_size(32).path();

License

This project is licensed under the MIT License - see the LICENSE.md file for details

Dependencies

~1.5MB
~25K SLoC