Module xdgkit::icon_finder

Icon finder

This is the rustification of the example psuedo code for finding icons a.k.a “the algorithm described in the Icon Theme Specification”

Structs

DirList

A simple structure to hold directory and theme list.

Functions

directory_matches_size

Check to see if the sub directory size is in range

directory_size_distance

You guessed it more pseudo code that turned into rust

find_best_icon

In some cases you don’t always want to fall back to an icon in an inherited theme. For instance, sometimes you look for a set of icons, preferring any of them before using an icon from an inherited theme. To support such operations implementations can contain a function that finds the first of a list of icon names in the inheritance hierarchy. This is that function!

find_best_icon_helper

This can be very useful, for example, when handling mime type icons, where there are more and less “specific” versions of icons.

find_by_name

Get a DirList struct when we look for a theme name in the Vec<DirList> we send in, and return our Vector when we are done looking in it.

find_icon

Icon Lookup

find_icon_helper

the “helper” function from the free desktop example pseudo code

generate_dir_list

Make the list of DirList structures by reading the $XDG_DATA_DIRS/icons

lookup_fallback_icon

Look in the basic icon directories (like /us/share/pixmaps, /usr/share/icons) for anything that matches the icon name!

lookup_icon

One of the “following helper functions”

user_theme

This function looks in the ini files of KDE and GTK to find the icon theme!