1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
|
/*
* Copyright © 2016 Canonical Ltd.
*
* This program is free software: you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 3, as published
* by the Free Software Foundation.
*
* This program is distributed in the hope that it will be useful, but
* WITHOUT ANY WARRANTY; without even the implied warranties of
* MERCHANTABILITY, SATISFACTORY QUALITY, or FITNESS FOR A PARTICULAR
* PURPOSE. See the GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License along
* with this program. If not, see <http://www.gnu.org/licenses/>.
*
* Authors:
* Larry Price <larry.price@canonical.com>
*/
#pragma once
#include "application-info-desktop.h"
#include <glib.h>
#include <list>
#include <map>
#include <memory>
namespace ubuntu
{
namespace app_launch
{
/** \brief Class to search for available application icons and select the best option.
This object attempts to find the highest resolution icon based on the freedesktop icon
theme specification found at:
https://standards.freedesktop.org/icon-theme-spec/icon-theme-spec-latest.html
It parses the theme file for the hicolor theme and identifies all possible directories
in the global scope and the local scope.
*/
class IconFinder
{
public:
/** Create an IconFinder
\param basePath the root directory to begin searching for themes
*/
explicit IconFinder(std::string basePath);
virtual ~IconFinder() = default;
/** Find the optimal icon for the given icon name.
\param iconName name of or path to application icon
*/
virtual Application::Info::IconPath find(const std::string& iconName);
private:
/** \private */
struct ThemeSubdirectory
{
std::string path;
int size;
};
/** \private */
std::list<ThemeSubdirectory> _searchPaths;
/** \private */
std::string _basePath;
/** \private */
static bool hasImageExtension(const char* filename);
/** \private */
static std::string findExistingIcon(const std::string& path, const std::string& iconName);
/** \private */
static std::list<ThemeSubdirectory> validDirectories(const std::string& themePath, gchar* directory, int size);
/** \private */
static std::list<ThemeSubdirectory> addSubdirectoryByType(std::shared_ptr<GKeyFile> themefile,
gchar* directory,
const std::string& themePath);
/** \private */
static std::list<ThemeSubdirectory> searchIconPaths(std::shared_ptr<GKeyFile> themefile,
gchar** directories,
const std::string& themePath);
static std::list<ThemeSubdirectory> themeFileSearchPaths(const std::string& themePath);
static std::list<ThemeSubdirectory> themeDirSearchPaths(const std::string& basePath);
static std::list<IconFinder::ThemeSubdirectory> iconsFromThemePath(const gchar* themeDir);
static std::list<ThemeSubdirectory> getSearchPaths(const std::string& basePath);
};
} // namespace app_launch
} // namesapce ubuntu
|