Development/Tutorials/Icons - Revision history

Sassman: found a better way

2012-11-25T17:54:55Z

found a better way

Sassman: fix last typo

2012-11-25T12:10:58Z

fix last typo

Sassman: add more explaination for paths etc

2012-11-25T12:10:14Z

add more explaination for paths etc

Sassman: minor change for convenience

2012-11-25T11:34:43Z

minor change for convenience

Sassman: rewrite the section to simplify the way of testing that

2012-11-25T11:32:15Z

rewrite the section to simplify the way of testing that

Sassman: fixing typo in png icon name and path

2012-11-25T11:01:53Z

fixing typo in png icon name and path

Sassman: small improvement using env variable $USER

2012-11-25T10:57:54Z

small improvement using env variable $USER

Sassman: fixing typos

2012-11-24T23:14:05Z

fixing typos

Icwiener: improve markup

2011-09-28T20:23:03Z

improve markup

Icwiener: /* files */ Fix code tags.

2011-09-28T20:09:28Z

‎files: Fix code tags.

@@ Line 71: / Line 71: @@
 </syntaxhighlight>
-finally create a symlink from $HOME/playground/share/icons to $HOME/.kde/share/icons. Then kde is able to find your project icons.
+finally you have to extend the search path for kde
 <syntaxhighlight lang="bash">
-ln -s $HOME/playground/share/icons $HOME/.kde/share/icons
+export KDEDIRS=$KDEDIRS:$HOME/playground
 </syntaxhighlight>
 }}

@@ Line 68: / Line 68: @@
 Find out if this is supported with the command
 <syntaxhighlight lang="bash">
-kde4-config -it -path icon
+kde4-config -path icon
 </syntaxhighlight>

← Older revision		Revision as of 12:10, 25 November 2012
Line 62:		Line 62:

	With this method you can easy see what you will get.		With this method you can easy see what you will get.
		+
		+	{{Note\| You can still not see the icon in your application because $HOME/playground is not a know path by kde.
		+	Normaly kde support a user defined space under $HOME/.kde.
		+
		+	Find out if this is supported with the command
		+	<syntaxhighlight lang="bash">
		+	kde4-config -it -path icon
		+	</syntaxhighlight>
		+
		+	finally create a symlink from $HOME/playground/share/icons to $HOME/.kde/share/icons. Then kde is able to find your project icons.
		+	<syntaxhighlight lang="bash">
		+	ln -s $HOME/playground/share/icons $HOME/.kde/share/icons
		+	</syntaxhighlight>
		+	}}

	= The icon naming scheme =		= The icon naming scheme =

@@ Line 96: / Line 96: @@
 To compile, link and install the example application, do a
 <syntaxhighlight lang="bash">
-cmake . && make && make install
+mkdir build && cd build
 </syntaxhighlight>
 To run it, call

@@ Line 45: / Line 45: @@
 = How to test it =
-* delete a file
+The easy way is to define a custom cmake install prefix where you can simply insall the project without touching your system.
 <syntaxhighlight lang="bash">
- rm /usr/local/share/icons/hicolor/22x22/apps/krep.png
+cd build
 </syntaxhighlight>
-{{Note| We are assuming your icon path is /usr/local/share/icons.
-Find it out with the command
+now the files should be deployed under
-<syntaxhighlight lang="bash">
-kde4-config --path icon
-</syntaxhighlight>
-}}
-* delete your cache
 <syntaxhighlight lang="bash">
-rm -rf /var/tmp/kdecache-$USER/icon-cache.kcache
+$HOME/playground/bin/krep
 </syntaxhighlight>
-According to [[Development/CMake/Addons_for_KDE#Macros]] you need to provide a 128x128 pixels icon.
+With this method you can easy see what you will get.
 = The icon naming scheme =

@@ Line 65: / Line 65: @@
 Example for icon names:
 * hisc-apps-bla.svgz will be installed e.g. to /usr/local/share/icons/hicolor/scalable/apps/bla.svgz. <tt>hi</tt> stands for "hicolor", <tt>sc</tt> for "scalable", <tt>apps</tt> for "applications", <tt>bla</tt> for the application's name and <tt>.svgz</tt> is the suffix for gzipped scalable vector graphic files.
-* hi128-app-ktimetracker.png will be installed e.g. to /usr/share/icons/hicolor/128x128/apps/ktimetracker.png. <tt>hi</tt> stands for "hicolor", <tt>128</tt> for a resolution of 128x128 pixels, <tt>app</tt> for "applications", <tt>ktimetracker</tt> for the application's name and <tt>.png</tt> is the suffix for portable network graphic files.
+* hi128-apps-ktimetracker.png will be installed e.g. to /usr/share/icons/hicolor/128x128/apps/ktimetracker.png. <tt>hi</tt> stands for "hicolor", <tt>128</tt> for a resolution of 128x128 pixels, <tt>apps</tt> for "applications", <tt>ktimetracker</tt> for the application's name and <tt>.png</tt> is the suffix for portable network graphic files.
 = example application =

@@ Line 30: / Line 30: @@
 kde4_add_ui_files( krepSources krepui.ui )
-kde4_add_app_icon]]( krepSources "hi*-app-krep.png" )
+kde4_add_app_icon( krepSources "hi*-app-krep.png" )
 KDE4_ADD_EXECUTABLE( krep ${krepSources} )
@@ Line 38: / Line 38: @@
 install( TARGETS krep ${INSTALL_TARGETS_DEFAULT_ARGS} )
-'''kde4_install_icons( ${ICON_INSTALL_DIR]]} )
+kde4_install_icons( ${ICON_INSTALL_DIR} )
 </syntaxhighlight>
 Weitere Informationen:

@@ Line 80: / Line 80: @@
 : just taken from the [[Development/Tutorials/Using_KActions|KAction example]]
 * [http://quickgit.kde.org/?p=kdeexamples.git&a=blob&f=kicons/mainwindow.cpp mainwindow.cpp]
-: Note the command <code> clearAction->setIcon(KIcon("tutorial-kicon"));</code> that sets the icon
+: Note the command <syntaxhighlight lang="bash">clearAction->setIcon(KIcon("tutorial-kicon"));</syntaxhighlight> that sets the icon
 * [http://quickgit.kde.org/?p=kdeexamples.git&a=blob&f=kicons/mainwindow.h mainwindow.h]
 : just taken from the [[Development/Tutorials/Using_KActions|KAction example]]
@@ Line 88: / Line 88: @@
 : just taken from the [[Development/Tutorials/Using_KActions|KAction example]]
 * [http://quickgit.kde.org/?p=kdeexamples.git&a=blob&f=kicons/hisc-apps-tutorial-kicon.svgz hisc-apps-tutorial-kicon.svgz]
-: sorry for the name, but there are [[#The_icon_naming_scheme|naming conventions]]. Create this file with the ''convert'' command from the ''ImageMagick'' package
+: sorry for the name, but there are [[#The_icon_naming_scheme|naming conventions]]. Create this file with the ''convert'' command from the ''ImageMagick'' package <syntaxhighlight lang="bash">convert world.svg hisc-apps-tutorial-kicon.svgz</syntaxhighlight>
 <syntaxhighlight lang="bash">
 convert world.svg hisc-apps-tutorial-kicon.svgz
 </syntaxhighlight>
 * [http://quickgit.kde.org/?p=kdeexamples.git&a=blob&f=kicons/CMakeLists.txt CMakeLists.txt]
-: Note the commands
+: Note the commands <syntaxhighlight lang="bash">kde4_install_icons(${ICON_INSTALL_DIR})</syntaxhighlight> and <syntaxhighlight lang="bash">kde4_update_iconcache()</syntaxhighlight> which integrate the icons.
 <syntaxhighlight lang="bash">
 kde4_install_icons(${ICON_INSTALL_DIR})
 </syntaxhighlight>
 and
 <syntaxhighlight lang="bash">
 kde4_update_iconcache()
 </syntaxhighlight>
 which integrate the icons.
 == build it ==