[ ] Organize icon files into a proper theme directory, with index file etc.
[ ] Update cpp files to use QIcon::fromTheme()
[ ] Update resources file
[ ] Update icon files in mapper-manual repository (subtree merge from mapper repository)
[ ] Update pages in mapper-manual repository (and subtree-merge to mapper repository)
[ ] Provide a setting for disabling the usage of system icons.
Notes:
"By default, only X11 will support themed icons. In order to use themed icons on Mac and Windows, you will have to bundle a compliant theme in one of your themeSearchPaths() and set the appropriate themeName()." (https://doc.qt.io/qt-5/qicon.html#fromTheme)
Since Qt 5.11, "If an icon can't be found in the current theme, then it will be searched in fallbackSearchPaths() as an unthemed icon." Until Qt 5.10, a fallback for a single icon can be provided only explicitly as second parameter to QIcon::fromTheme().
A simple way to disable the usage of system icons is to point the search path to a non-existing location:
QIcon::setThemeSearchPaths({QLatin1String(":/no-system-icons")});
For consistency with Desktop themes, the icon filenames shall follow the freedesktop.org's Icon Naming Specification. This also adds a way to handle high DPI icons.
QIcon::fromTheme()
Notes:
fallbackSearchPaths()
as an unthemed icon." Until Qt 5.10, a fallback for a single icon can be provided only explicitly as second parameter toQIcon::fromTheme()
.QIcon::setThemeSearchPaths({QLatin1String(":/no-system-icons")});