Carregando e instalando ícones no KDE
Os ícones são um importante elemento de interface do usuário em qualquer ambiente de trabalho. Devido a diferentes preferências do usuário e de hardware de vídeo, um ícone pode vir em diferentes tamanhos e profundidades de exibição. Para que isso seja gerenciável, uma forma padrão de armazenamento e acesso a ícones foi desenvolvido.
Ícones são carregados usando a classe KIconLoader. Todo appliation do KDE tem um objeto iconloader global. Você pode acessar esse objeto com:
#include <kglobal.h>
#include <kiconloader.h>
KIconLoader *loader = KGlobal::iconLoader();
O iconloader carrega ícones, faz o cache deles e aplica efeitos. Para carregar um ícone, use o método loadIcon(), que é definido assim:
QPixmap loadIcon( QString name, int group, int size=0,
int state=KIcon::DefaultState,
QString *path_store=0L, bool canReturnNull=false);
Como você vê, existem muitos parâmetros. Os dois primeiros são os mais importantes:
A ideia de um grupo de ícone é um conceito importante no esquema de ícone do KDE. O grupo de ícone indica onde na tela o ícone vai ser usado. Isso é relevante, pois o usuário pode vincular os tamanhos dos ícones e efeitos visuais do KDE para cada grupo. Ao passar o grupo de ícone para o carregador de ícone, você está na verdade dizendo-lhe que encarnação do ícone deve carregar. E, exigindo o argumento do grupo, o iconloader fornece os meios para ter um consistente e configurável exame de ícone sobre toda a área de trabalho do KDE.
Por exemplo: o usuário pode configurar que ele deseja ícones de 32 pixels com 0.2 de dessaturação para as barras de ferramentas principais.
Os grupos de ícones disponíveis são apresentados abaixo. Todos estão definidos na classe KIcon, assim prefixe-os com KIcon::.
Assim, para carregar o ícone "kfind" para usar no grupo Desktop, você usaria:
QPixmap icon;
icon = loader->loadIcon("kfind", KIcon::Desktop);
Agora vamos discutir os outros parâmetros de loadIcon.
Ícones podem vir em diferentes tamanhos e profundidades de exibição. Vou me referir a esses ícones como ícones temáticos. Ícones que vêm em apenas uma forma são chamados de ícones não temáticos.
Ícones temáticos vêm em diferentes tamanhos e profundidades de exibição. Os tamanhos normais são os seguintes:
Por favor, consulte KDE icon factory para informações quais tamanhos de ícones são obrigatórios e mais. Lembre-se que cada uma destas dimensões pode ser ligada a um grupo de ícones.
Ícones temáticos são armazenados em uma hierarquia de diretório de acordo aos seus 1. profundidade, 2. tamanho and 3. contexto. O termo contexto é um novo conceito introduzido pelo esquema de ícone do KDE. O contexto de um ícone é o que o ícone significa. Os contextos padrões são apresentados abaixo:
Contexts are important in one case: selecting an icon. When an application wants the user to select an icon for, say, a toolbar, it would be very user unfriendly to show every single icon installed in KDE. Instead, it is much better to let the user select an icon from the "action" icons only. These all represent some action and therefore are suitable for in toolbars.
The directory hierarchy in which themed icons are stored follows. The directory names are self explanatory.
hicolor/ 22x22/ actions/ apps/ devices/ filesystems/ mimetypes/ 32x32/ ... 48x48/ ... locolor/ 16x16/ ... 22x22/ ... 32x32/ ...
Themed icons can be installed either globally with respect to KDE, or in application specific place. In the global case, the icon theme hierarchy resides under $KDEDIR/share/icons while in the application specific case, it is under $KDEDIR/share/apps/$APPNAME/icons.
The KDE source configuration system (specifically, am_edit) has support for installing themed icons. First, you have to name your icons in a way that it is clear where it must be installed. The naming convention is explained in the table below:
depth | size | - | context | - | name | .png |
---|---|---|---|---|---|---|
hi | 16 | action | ||||
lo | 22 | app | ||||
32 | device | |||||
48 | filesys | |||||
mime |
Examples:
lo22-action-open.png hi48-app-kfind.png
To install these icons globally, add this line to your Makefile.am.
KDE_ICON = open kfind
and to install them in an application specific directory, use this:
icondir = $(kde_datadir)/myapp/icons icon_ICON = open kfind
Themed icons are loaded with the iconloader, using the standard icon groups. For example:
QPixmap pm;
pm = loader->loadIcon("kfind", KIcon::Desktop);
This will load the "kfind" icon, of depth and size specified for the Desktop group.
Unthemed icons are installed in $KDEDIR/share/apps/$APPNAME/pics. To install them, use this in you Makefile.am.
icondir = $(kde_datadir)/myapp/pics icon_DATA = open kfind
You must not give the icons special names. Also, no further processing is done on them: no effects and size,depth selection is done.
Unthemed icons can be loaded with the iconloader using the User group. This will load a user icon:
QPixmap pm;
pm = loader->loadIcon("myicon", KIcon::User);
There are 3 ways to install icons: global themed, application specific themed and unthemed. All types of icons can be loaded with the iconloader. You should choose a specific installation depending on your needs.
Initial Author: Geert Jansen <jansen@kde.org>