Development/Tutorials/Plasma/WallpaperHelloWorld - Revision history

StijnRuts: /* Running the Wallpaper */ Made reference to next tutorial a clickable link

2012-04-09T11:31:31Z

‎Running the Wallpaper: Made reference to next tutorial a clickable link

StijnRuts: /* Code */ Fixed typo

2012-04-03T18:13:59Z

‎Code: Fixed typo

Neverendingo: Text replace - "" to ""

2011-06-30T10:20:12Z

Text replace - "<syntaxhighlight lang="make">" to "<syntaxhighlight lang="cmake">"

Neverendingo: Text replace - "`" to ""`


2011-06-29T19:50:45Z
Text replace - "<code ini>" to "<syntaxhighlight lang="ini">"

				
				
				
				
			
			← Older revision
			Revision as of 19:50, 29 June 2011
			
Line 25:
Line 25:
  Before we get coding we need to set up some files for our wallpaper. Create a directory called plasma-wallpaper-tutorial. Inside it create a file called plasma-wallpaper-tutorial.desktop. A .desktop file contains information about the wallpaper such as its name, author, etc. Copy the following into the file:   Before we get coding we need to set up some files for our wallpaper. Create a directory called plasma-wallpaper-tutorial. Inside it create a file called plasma-wallpaper-tutorial.desktop. A .desktop file contains information about the wallpaper such as its name, author, etc. Copy the following into the file:
    
− <code ini> + <syntaxhighlight lang="ini">
  [Desktop Entry]   [Desktop Entry]
  Name=Tutorial   Name=Tutorial



Neverendingo: Text replace - "" to ""

2011-06-29T19:48:47Z
Text replace - "<code bash>" to "<syntaxhighlight lang="bash">"

				
				
				
				
			
			← Older revision
			Revision as of 19:48, 29 June 2011
			
Line 12:
Line 12:
    
  On ubuntu/debian systems you can type in the terminal:   On ubuntu/debian systems you can type in the terminal:
− <code bash> + <syntaxhighlight lang="bash">
  sudo apt-get install kdebase-workspace-dev   sudo apt-get install kdebase-workspace-dev
  </syntaxhighlight>   </syntaxhighlight>
  openSUSE:   openSUSE:
− <code bash> + <syntaxhighlight lang="bash">
  sudo zypper install kdebase4-workspace-devel   sudo zypper install kdebase4-workspace-devel
  </syntaxhighlight>   </syntaxhighlight>
Line 134:
Line 134:
  We will compile our wallpaper inside a directory called build. Type the following inside the terminal:   We will compile our wallpaper inside a directory called build. Type the following inside the terminal:
    
− <code bash> + <syntaxhighlight lang="bash">
  mkdir -p build   mkdir -p build
  cd build   cd build
Line 149:
Line 149:
  To see our wallpaper we can use a tool called plasmawallpaperviwer. To run our wallpaper type the following inside the terminal:   To see our wallpaper we can use a tool called plasmawallpaperviwer. To run our wallpaper type the following inside the terminal:
    
− <code bash> + <syntaxhighlight lang="bash">
  plasmawallpaperviewer -p tutorial   plasmawallpaperviewer -p tutorial
  </syntaxhighlight>   </syntaxhighlight>
Line 155:
Line 155:
  Alternatively you can run the wallpaper inside your actual desktop. You may need to restart plasma first by logging out or running the following command:   Alternatively you can run the wallpaper inside your actual desktop. You may need to restart plasma first by logging out or running the following command:
    
− <code bash> + <syntaxhighlight lang="bash">
  kquitapp plasma-desktop; sleep 1; plasma-desktop   kquitapp plasma-desktop; sleep 1; plasma-desktop
  </syntaxhighlight>   </syntaxhighlight>





Neverendingo: Text replace - "" to ""

2011-06-29T19:44:33Z
Text replace - "<code cmake>" to "<syntaxhighlight lang="make">"

				
				
				
				
			
			← Older revision
			Revision as of 19:44, 29 June 2011
			
Line 45:
Line 45:
  Next we will make a CMakeLists.txt file that contains information about how to compile this project. Copy the following into your CMakeLists.txt file:   Next we will make a CMakeLists.txt file that contains information about how to compile this project. Copy the following into your CMakeLists.txt file:
    
− <code cmake> + <syntaxhighlight lang="make">
  project(plasma-wallpaper-tutorial)   project(plasma-wallpaper-tutorial)
    



Neverendingo: Text replace - "" to ""
2011-06-29T19:42:22Z
Text replace - "</code>" to "</syntaxhighlight>"

				
				
				
				
			
			← Older revision
			Revision as of 19:42, 29 June 2011
			
Line 14:
Line 14:
  <code bash>   <code bash>
  sudo apt-get install kdebase-workspace-dev   sudo apt-get install kdebase-workspace-dev
− </code> + </syntaxhighlight>
  openSUSE:   openSUSE:
  <code bash>   <code bash>
  sudo zypper install kdebase4-workspace-devel   sudo zypper install kdebase4-workspace-devel
− </code> + </syntaxhighlight>
    
  This tutorial assumes that you are using KDE 4.3 or newer. Some parts of this tutorial may not work with older versions.   This tutorial assumes that you are using KDE 4.3 or newer. Some parts of this tutorial may not work with older versions.
Line 41:
Line 41:
  X-KDE-PluginInfo-License=GPL   X-KDE-PluginInfo-License=GPL
  X-KDE-PluginInfo-EnabledByDefault=true     X-KDE-PluginInfo-EnabledByDefault=true  
− </code> + </syntaxhighlight>
    
  Next we will make a CMakeLists.txt file that contains information about how to compile this project. Copy the following into your CMakeLists.txt file:   Next we will make a CMakeLists.txt file that contains information about how to compile this project. Copy the following into your CMakeLists.txt file:
Line 64:
Line 64:
  install(TARGETS plasma_wallpaper_tutorial DESTINATION ${PLUGIN_INSTALL_DIR})   install(TARGETS plasma_wallpaper_tutorial DESTINATION ${PLUGIN_INSTALL_DIR})
  install(FILES plasma-wallpaper-tutorial.desktop DESTINATION ${SERVICES_INSTALL_DIR})   install(FILES plasma-wallpaper-tutorial.desktop DESTINATION ${SERVICES_INSTALL_DIR})
− </code> + </syntaxhighlight>
    
  The CMakeLists.txt file tells us what packages are required to compile this project, what source files we have, what libraries we need to link to and what files to install.   The CMakeLists.txt file tells us what packages are required to compile this project, what source files we have, what libraries we need to link to and what files to install.
Line 91:
Line 91:
    
  #endif   #endif
− </code> + </syntaxhighlight>
    
  Every plasma wallpaper has to inherit from Plasma::Wallpaper. We have to add a Q_OBJECT since it inherits a QObject. The constructor will be used to intialize our wallpaper. The paint function is where we will draw our wallpaper. Finally the K_EXPORT_PLASMA_WALLPAPER macro tells us that the class 'Tutorial' will make a wallpaper plugin called 'tutorial'.   Every plasma wallpaper has to inherit from Plasma::Wallpaper. We have to add a Q_OBJECT since it inherits a QObject. The constructor will be used to intialize our wallpaper. The paint function is where we will draw our wallpaper. Finally the K_EXPORT_PLASMA_WALLPAPER macro tells us that the class 'Tutorial' will make a wallpaper plugin called 'tutorial'.
Line 119:
Line 119:
    
  #include "tutorial.moc"   #include "tutorial.moc"
− </code> + </syntaxhighlight>
    
  We leave the constructor blank for now and just pass the arguments to the Plasma::Walllpaper.   We leave the constructor blank for now and just pass the arguments to the Plasma::Walllpaper.
Line 140:
Line 140:
  make   make
  sudo make install   sudo make install
− </code> + </syntaxhighlight>
    
  The cmake command will generate Makefiles by using the information in our CMakeLists.txt file. We set the install directory to the output of `kde4-config --prefix` which is usually something like /usr.   The cmake command will generate Makefiles by using the information in our CMakeLists.txt file. We set the install directory to the output of `kde4-config --prefix` which is usually something like /usr.
Line 151:
Line 151:
  <code bash>   <code bash>
  plasmawallpaperviewer -p tutorial   plasmawallpaperviewer -p tutorial
− </code> + </syntaxhighlight>
    
  Alternatively you can run the wallpaper inside your actual desktop. You may need to restart plasma first by logging out or running the following command:   Alternatively you can run the wallpaper inside your actual desktop. You may need to restart plasma first by logging out or running the following command:
Line 157:
Line 157:
  <code bash>   <code bash>
  kquitapp plasma-desktop; sleep 1; plasma-desktop   kquitapp plasma-desktop; sleep 1; plasma-desktop
− </code> + </syntaxhighlight>
    
  Now right click on your desktop, go to Desktop Settings>Wallpaper>Type and select 'Tutorial'.   Now right click on your desktop, go to Desktop Settings>Wallpaper>Type and select 'Tutorial'.



Neverendingo: Text replace - "" to ""

2011-06-29T19:38:54Z
Text replace - "<code cpp>" to "<syntaxhighlight lang="cpp">"

				
				
				
				
			
			← Older revision
			Revision as of 19:38, 29 June 2011
			
Line 73:
Line 73:
  First make a file called tutorial.h. Copy the following into the file:   First make a file called tutorial.h. Copy the following into the file:
    
− <code cpp> + <syntaxhighlight lang="cpp">
  #ifndef PLASMA_WALLPAPER_TUTORIAL   #ifndef PLASMA_WALLPAPER_TUTORIAL
  #define PLASMA_WALLPAPER_TUTORIAL   #define PLASMA_WALLPAPER_TUTORIAL
Line 97:
Line 97:
  Now make another file called tutorial.cpp. Put the following code inside it:   Now make another file called tutorial.cpp. Put the following code inside it:
    
− <code cpp> + <syntaxhighlight lang="cpp">
  #include <QPainter>   #include <QPainter>
    



Augustin: /* Setting Up */ typo: its != it's, tsk, tsk, tsk!
2010-12-04T13:35:37Z
‎Setting Up:  typo: its != it's, tsk, tsk, tsk!

				
				
				
				
			
			← Older revision
			Revision as of 13:35, 4 December 2010
			
Line 23:
Line 23:
    
  == Setting Up ==   == Setting Up ==
− Before we get coding we need to set up some files for our wallpaper. Create a directory called plasma-wallpaper-tutorial. Inside it create a file called plasma-wallpaper-tutorial.desktop. A .desktop file contains information about the wallpaper such as it's name, author, etc. Copy the following into the file: + Before we get coding we need to set up some files for our wallpaper. Create a directory called plasma-wallpaper-tutorial. Inside it create a file called plasma-wallpaper-tutorial.desktop. A .desktop file contains information about the wallpaper such as its name, author, etc. Copy the following into the file:
    
  <code ini>   <code ini>





Priomsrb at 21:12, 14 November 2010
2010-11-14T21:12:14Z


				
				
				
				
			
			← Older revision
			Revision as of 21:12, 14 November 2010
			
Line 109:
Line 109:
  void Tutorial::paint(QPainter *painter, const QRectF& exposedRect)   void Tutorial::paint(QPainter *painter, const QRectF& exposedRect)
  {   {
  +     painter->setPen(Qt::white);
       painter->setBrush(Qt::white);        painter->setBrush(Qt::white);
       painter->drawRect(boundingRect());        painter->drawRect(boundingRect());

← Older revision		Revision as of 11:31, 9 April 2012
Line 165:		Line 165:
	You can try changing the code inside the paint function to whatever you want. The QPainter class has many functions that allow you to draw draw images, text and shapes.		You can try changing the code inside the paint function to whatever you want. The QPainter class has many functions that allow you to draw draw images, text and shapes.

−	In the next tutorial we will add some configuration options to our wallpaper.	+	In the [[Development/Tutorials/Plasma/WallpaperConfiguration\|next tutorial]] we will add some configuration options to our wallpaper.

@@ Line 121: / Line 121: @@
 </syntaxhighlight>
-We leave the constructor blank for now and just pass the arguments to the Plasma::Walllpaper.
+We leave the constructor blank for now and just pass the arguments to the Plasma::Wallpaper.
 The paint function is where we draw our wallpaper. It has two arguments: the first is a QPainter which to draw with, and the second is a QRectF telling us which part of the wallpaper needs to be repainted. For now we will ignore exposedRect.