-
Notifications
You must be signed in to change notification settings - Fork 38
Application Icon
This page describes how to set the application icons. These are icons in the window bar, for desktop files and are also used internally in several dialogs. If you wish to know how to change the icons used inside the program for buttons and the like please refer to this page.
Because the application icon must be available outside the program (for instance from desktop files) it needs to be defined at build time and if it exists will be installed during the make install phase.
In the build files the /images/application directory contains the images used for the Application Icon. There are two files, one a 24x24 fixed size PNG file, and another scalable SVG file. The /images/application/variations directory contains two subdirectories which hold user submitted icons for the program, one for the 24x24 PNG files and the other for scalable SVG files. For the application icon you may use any icon contained in these directories, or any other image file for that matter. What you need to do is remove the cmst.png and cmst.svg files then copy or symlink the images you want to use in their place. The replacement images should be called cmst.png for the 24x24 variation and cmst.svg for the scalable one. The 24x24 is required for desktop files and must be a PNG file, while the scalable version, which must be a SVG file, will be used internally by the program. If the 24x24 version is not supplied (see below) then the scalable version will be ignored should it exist. Once you've got the icons set the way you want run through the "qmake, make, make install" process and the images you've specified as cmst.png and cmst.svg will be used for the Application icon.
If you would prefer a Freedesktop.org named icon to be used for the program that is also possible. What you need to do is go into the /images/application directory and remove or rename the cmst.png file. The cmst.svg file may be removed as well, but is not necessary to do so. Once that is done go through the normal build process and the Application Icon should be the preferences-system-network from your current theme. If you change icon themes the icon will update to the image in the new theme.
If you decide to change the icon after you've installed one in addition to running "make clean" you want to go through and manually remove all Makefiles. Make clean does not do this and sometimes a remanant Makefile gives you a real hard problem to debug.