Development/Tutorials/Plasma/WallpaperConfiguration - Revision history

StijnRuts: /* Conclusion */ Made reference to next tutorial a clickable link

2012-04-09T11:32:19Z

‎Conclusion: Made reference to next tutorial a clickable link

StijnRuts: /* Conclusion */ Updated reference to next tutorial

2012-04-09T11:30:00Z

‎Conclusion: Updated reference to next tutorial

StijnRuts: Removed Postscript as it is now unrelevant

2012-04-02T19:22:45Z

Removed Postscript as it is now unrelevant

StijnRuts: /* Step 4: Add code to show the configuration interface */ Fixed the compiler error pointed out in the Postscript

2012-04-02T19:19:34Z

‎Step 4: Add code to show the configuration interface: Fixed the compiler error pointed out in the Postscript

Djbarney at 12:14, 5 August 2011

2011-08-05T12:14:28Z

Neverendingo: Text replace - "" to ""

2011-06-30T10:20:11Z

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

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


2011-06-29T21:06:42Z
Text replace - "<code cmake>" to "<syntaxhighlight lang="make">"

				
				
				
				
			
			← Older revision
			Revision as of 21:06, 29 June 2011
			
Line 140:
Line 140:
  We also need to add our config file to our CMakeLists.txt. Add the following line to CMakeLists.txt:   We also need to add our config file to our CMakeLists.txt. Add the following line to CMakeLists.txt:
    
− <code cmake> + <syntaxhighlight lang="make">
  project(plasma-wallpaper-tutorial)   project(plasma-wallpaper-tutorial)

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

2011-06-29T20:54:34Z

Text replace - "</code>" to "</syntaxhighlight>"

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


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

				
				
				
				
			
			← Older revision
			Revision as of 20:39, 29 June 2011
			
Line 258:
Line 258:
  To compile we follow the same steps as last time:   To compile we follow the same steps as last time:
    
− <code bash> + <syntaxhighlight lang="bash">
  mkdir -p build   mkdir -p build
  cd build   cd build
Line 270:
Line 270:
  Again we can test using the Plasma wallpaper viewer:   Again we can test using the Plasma wallpaper viewer:
    
− <code bash> + <syntaxhighlight lang="bash">
  plasmawallpaperviewer -p tutorial   plasmawallpaperviewer -p tutorial
  </code>   </code>
Line 276:
Line 276:
  Or we can test it directly on our desktop. Restart plasma using:   Or we can test it directly on our desktop. Restart plasma using:
    
− <code bash> + <syntaxhighlight lang="bash">
  kquitapp plasma-desktop; sleep 1; plasma-desktop   kquitapp plasma-desktop; sleep 1; plasma-desktop
  </code>   </code>



Neverendingo: Text replace - "" to ""

2011-06-29T20:30:18Z
Text replace - "<code cppqt>" to "<syntaxhighlight lang="cpp-qt">"

				
				
				
				
			
			← Older revision
			Revision as of 20:30, 29 June 2011
			
Line 25:
Line 25:
  So we will need to add variables to our Tutorial class to keep track of these. So change tutorial.h to look like the following:   So we will need to add variables to our Tutorial class to keep track of these. So change tutorial.h to look like the following:
    
− <code cppqt> + <syntaxhighlight lang="cpp-qt">
  #ifndef PLASMA_WALLPAPER_TUTORIAL   #ifndef PLASMA_WALLPAPER_TUTORIAL
  #define PLASMA_WALLPAPER_TUTORIAL   #define PLASMA_WALLPAPER_TUTORIAL
Line 54:
Line 54:
  We will also need to change our paint() function in tutorial.cpp so that it uses these variables now:   We will also need to change our paint() function in tutorial.cpp so that it uses these variables now:
    
− <code cppqt> + <syntaxhighlight lang="cpp-qt">
    
  void Tutorial::paint(QPainter *painter, const QRectF& exposedRect)   void Tutorial::paint(QPainter *painter, const QRectF& exposedRect)
Line 73:
Line 73:
  To load and save our configurations we need 2 functions called init() and save(). Add the following lines to our tutorial.h:   To load and save our configurations we need 2 functions called init() and save(). Add the following lines to our tutorial.h:
    
− <code cppqt> + <syntaxhighlight lang="cpp-qt">
  class Tutorial : public Plasma::Wallpaper   class Tutorial : public Plasma::Wallpaper
  {   {
Line 96:
Line 96:
  Now we need to implement these functions in tutorial.cpp:   Now we need to implement these functions in tutorial.cpp:
    
− <code cppqt> + <syntaxhighlight lang="cpp-qt">
    
  void Tutorial::init(const KConfigGroup &config)   void Tutorial::init(const KConfigGroup &config)
Line 175:
Line 175:
  So add these lines to our tutorial.h:   So add these lines to our tutorial.h:
    
− <code cppqt> + <syntaxhighlight lang="cpp-qt">
  #ifndef PLASMA_WALLPAPER_TUTORIAL   #ifndef PLASMA_WALLPAPER_TUTORIAL
  #define PLASMA_WALLPAPER_TUTORIAL   #define PLASMA_WALLPAPER_TUTORIAL
Line 215:
Line 215:
  Now we will implement createConfigurationInterface() and settingsModified() in our tutorial.cpp:   Now we will implement createConfigurationInterface() and settingsModified() in our tutorial.cpp:
    
− <code cppqt> + <syntaxhighlight lang="cpp-qt">
    
  QWidget* Tutorial::createConfigurationInterface(QWidget* parent)   QWidget* Tutorial::createConfigurationInterface(QWidget* parent)

← Older revision		Revision as of 11:32, 9 April 2012
Line 289:		Line 289:
	If you want more practice, you can try adding a configurable background image to our wallpaper.		If you want more practice, you can try adding a configurable background image to our wallpaper.

−	In the next tutorial we will look at how to make our wallpaper more efficient.	+	In the [[Development/Tutorials/Plasma/WallpaperDoubleBuffer\|next tutorial]] we will look at how to make our wallpaper more efficient.

← Older revision		Revision as of 11:30, 9 April 2012
Line 289:		Line 289:
	If you want more practice, you can try adding a configurable background image to our wallpaper.		If you want more practice, you can try adding a configurable background image to our wallpaper.

−	In the next tutorial we will look at how ~~we can use mouse input~~ to ~~interact with~~ our wallpaper.	+	In the next tutorial we will look at how to make our wallpaper more efficient.

← Older revision		Revision as of 19:22, 2 April 2012
Line 290:		Line 290:

	In the next tutorial we will look at how we can use mouse input to interact with our wallpaper.		In the next tutorial we will look at how we can use mouse input to interact with our wallpaper.
−
−	~~== Postscript ==~~
−
−	~~If you are getting confusing compiler errors then see [http://forum.kde.org/viewtopic.php?f=64&t=96183 this thread at the KDE Community Forums].~~

@@ Line 202: / Line 202: @@
      private:
          QColor backgroundColor;
          QColor textColor;
@@ Line 220: / Line 221: @@
+{
      QWidget *widget = new QWidget(parent);
-     config.setupUi(widget);
+     configWidget.setupUi(widget);
-     config.textString->setText(textString);
+     configWidget.textString->setText(textString);
-     config.textFont->setFont(textFont);
+     configWidget.textFont->setFont(textFont);
-     config.textColor->setColor(textColor);
+     configWidget.textColor->setColor(textColor);
-     config.backgroundColor->setColor(backgroundColor);
+     configWidget.backgroundColor->setColor(backgroundColor);
-     connect(config.textString, SIGNAL(textChanged(QString)), this, SLOT(settingsModified()));
+     connect(configWidget.textString, SIGNAL(textChanged(QString)), this, SLOT(settingsModified()));
-     connect(config.textFont, SIGNAL(fontSelected(QFont)), this, SLOT(settingsModified()));
+     connect(configWidget.textFont, SIGNAL(fontSelected(QFont)), this, SLOT(settingsModified()));
-     connect(config.textColor, SIGNAL(changed(const QColor&)), this, SLOT(settingsModified()));
+     connect(configWidget.textColor, SIGNAL(changed(const QColor&)), this, SLOT(settingsModified()));
-     connect(config.backgroundColor, SIGNAL(changed(const QColor&)), this, SLOT(settingsModified()));
+     connect(configWidget.backgroundColor, SIGNAL(changed(const QColor&)), this, SLOT(settingsModified()));
      connect(this, SIGNAL(settingsChanged(bool)), parent, SLOT(settingsChanged(bool)));
@@ Line 239: / Line 240: @@
 void Tutorial::settingsModified()
+{
-     textString = config.textString->text();
+     textString = configWidget.textString->text();
-     textFont = config.textFont->font();
+     textFont = configWidget.textFont->font();
-     textColor = config.textColor->color();
+     textColor = configWidget.textColor->color();
-     backgroundColor = config.backgroundColor->color();
+     backgroundColor = configWidget.backgroundColor->color();
      emit settingsChanged(true);

← Older revision		Revision as of 12:14, 5 August 2011
Line 289:		Line 289:

	In the next tutorial we will look at how we can use mouse input to interact with our wallpaper.		In the next tutorial we will look at how we can use mouse input to interact with our wallpaper.
		+
		+	== Postscript ==
		+
		+	If you are getting confusing compiler errors then see [http://forum.kde.org/viewtopic.php?f=64&t=96183 this thread at the KDE Community Forums].

@@ Line 50: / Line 50: @@
 #endif
-</code>
+</syntaxhighlight>
 We will also need to change our paint() function in tutorial.cpp so that it uses these variables now:
@@ Line 67: / Line 67: @@
+}
-</code>
+</syntaxhighlight>
 === Step 2: Add code to load and save configurations ===
@@ Line 92: / Line 92: @@
          QString textString;
 };
-</code>
+</syntaxhighlight>
 Now we need to implement these functions in tutorial.cpp:
@@ Line 116: / Line 116: @@
+}
-</code>
+</syntaxhighlight>
 Tutorial::init(), gets called whenever the wallpaper needs to reload it's configurations. In there we use config.readEntry() to read each entry from our configuration file. The first argument of config.readEntry() is the name of the configuration entry. The second argument is the initial value for when we do not have that entry. config.readEntry() will try to read the value for the entry in our config file, if it can't it will use the initial value, and return it.
@@ Line 161: / Line 161: @@
 install(TARGETS plasma_wallpaper_tutorial DESTINATION ${PLUGIN_INSTALL_DIR})
 install(FILES plasma-wallpaper-tutorial.desktop DESTINATION ${SERVICES_INSTALL_DIR})
-</code>
+</syntaxhighlight>
 === Step 4: Add code to show the configuration interface ===
@@ Line 211: / Line 211: @@
 #endif
-</code>
+</syntaxhighlight>
 Now we will implement createConfigurationInterface() and settingsModified() in our tutorial.cpp:
@@ Line 248: / Line 248: @@
+}
-</code>
+</syntaxhighlight>
 In createConfigurationInterface() we put our configuration interface on a new QWidget. Then we set each of the widgets in the interface to their appropriate values. Then we connect each widget's change signal to our settingsModified() slot. This will cause settingsModified() to be called whenever any widget's value is changed in our interface. Next we connect our settingsChanged(bool) signal to our parents settingsChanged(bool) so that the dialog containing our interface can react to the change (by enabling it's 'Apply' button for example). Finally we return the widget so that it can be displayed in the dialog.
@@ Line 264: / Line 264: @@
 make
 sudo make install
-</code>
+</syntaxhighlight>
 == Testing ==
@@ Line 272: / Line 272: @@
 <syntaxhighlight lang="bash">
 plasmawallpaperviewer -p tutorial
-</code>
+</syntaxhighlight>
 Or we can test it directly on our desktop. Restart plasma using:
@@ Line 278: / Line 278: @@
 <syntaxhighlight lang="bash">
 kquitapp plasma-desktop; sleep 1; plasma-desktop
-</code>
+</syntaxhighlight>
 Then right click on your desktop, go to Desktop Settings>Wallpaper>Type and select 'Tutorial'.