Development/Tutorials/Games/Palapeli Slicers - Revision history

Neverendingo: Text replace - "" to ""

2011-06-29T20:50:05Z

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

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


2011-06-29T20:44:52Z
Text replace - "<code>" to "<syntaxhighlight lang="text">"

				
				
				
				
			
			← Older revision
			Revision as of 20:44, 29 June 2011
			
Line 129:
Line 129:
  == Integrate into Palapeli: myslicer.desktop ==   == Integrate into Palapeli: myslicer.desktop ==
    
− <code> + <syntaxhighlight lang="text">
  [Desktop Entry]   [Desktop Entry]
  Name=My very first slicer   Name=My very first slicer
Line 154:
Line 154:
  == Build everything: CMakeLists.txt ==   == Build everything: CMakeLists.txt ==
    
− <code> + <syntaxhighlight lang="text">
  project(myslicer)   project(myslicer)
  find_package(KDE4 REQUIRED)   find_package(KDE4 REQUIRED)



Neverendingo: Text replace - "" to ""

2011-06-29T20:31:55Z
Text replace - "<code cppqt n>" to "<syntaxhighlight lang="cpp-qt" line>"

				
				
				
				
			
			← Older revision
			Revision as of 20:31, 29 June 2011
			
Line 22:
Line 22:
  == The code: myslicer.h ==   == The code: myslicer.h ==
    
− <code cppqt n> + <syntaxhighlight lang="cpp-qt" line>
  #ifndef MYSLICER_H   #ifndef MYSLICER_H
  #define MYSLICER_H   #define MYSLICER_H
Line 47:
Line 47:
  == The code: myslicer.cpp ==   == The code: myslicer.cpp ==
    
− <code cppqt n> + <syntaxhighlight lang="cpp-qt" line>
  #include "myslicer.h"   #include "myslicer.h"
    





Majewsky: adjust link to libpala apidox
2009-12-21T16:42:00Z
adjust link to libpala apidox

				
				
				
				
			
			← Older revision
			Revision as of 16:42, 21 December 2009
			
Line 3:
Line 3:
  |name=Creating a slicer plugin for Palapeli   |name=Creating a slicer plugin for Palapeli
  |pre=[[Development/Tutorials/Programming_Tutorial_KDE_4|Introduction to KDE4 programming]]   |pre=[[Development/Tutorials/Programming_Tutorial_KDE_4|Introduction to KDE4 programming]]
− |reading=API reference for [http://api.kde.org/playground-api/games-apidocs/palapeli/libpala/html/index.html libpala] + |reading=API reference for [http://api.kde.org/4.x-api/kdegames-apidocs/palapeli/libpala/html/index.html libpala]
  }}   }}
    



Majewsky at 20:36, 11 November 2009
2009-11-11T20:36:25Z


				
				
				
				
			
			← Older revision
			Revision as of 20:36, 11 November 2009
			
Line 172:
Line 172:
    
  [[Image:Palapeli Pattern Tutorial1.png]]   [[Image:Palapeli Pattern Tutorial1.png]]
−  
− == Distribute everything ==  
−  
− If you want to release your code, please add the FindLibPala.cmake script to your source tarball. This ensures that people trying to build your code without having libpala development files installed will get meaningful errors.  



Majewsky: /* Build everything: CMakeLists.txt */
2009-11-11T20:35:06Z
‎Build everything: CMakeLists.txt

				
				
				
				
			
			← Older revision
			Revision as of 20:35, 11 November 2009
			
Line 159:
Line 159:
  find_package(LibPala REQUIRED)   find_package(LibPala REQUIRED)
    
− add_definitions(${LIBPALA_DEFINITIONS}) + include(KDE4Defaults)
− include_directories(${LIBPALA_INCLUDES}) + include_directories(${KDE4_INCLUDES} ${pala_INCLUDE_DIRS})
    
  kde4_add_plugin(myslicer myslicer.cpp)   kde4_add_plugin(myslicer myslicer.cpp)
− target_link_libraries(myslicer ${LIBPALA_LIBRARIES}) + target_link_libraries(myslicer pala ${QT_QTGUI_LIBRARY} ${KDE4_KDECORE_LIBS})
    
  install(TARGETS myslicer DESTINATION ${PLUGIN_INSTALL_DIR})   install(TARGETS myslicer DESTINATION ${PLUGIN_INSTALL_DIR})
Line 169:
Line 169:
  </code>   </code>
    
− Everything of this is pretty straightforward if you have previous experience with CMake (and this is what I assume). Make sure you compile everything as a plugin, and install it into the plugin directory. The find script for libpala sets some convenience variables that shorten the code in lines 5, 6 and 9. After having installed the plugin, run <tt>kbuildsycoca4</tt>. This will locate your plugin, and enable Palapeli to use it. Here is how it should look like then: + Everything of this is pretty straightforward if you have previous experience with CMake (and this is what I assume). Make sure you compile everything as a plugin, and install it into the plugin directory. Do not forget to link against the "pala" target (which corresponds to libpala). After having installed the plugin, run <tt>kbuildsycoca4</tt>. This will locate your plugin, and enable Palapeli to use it. Here is how it should look like then:
−   + 
− {{Box|Warning|This image is outdated. It will be replaced by a current image, when the new version of Palapeli gains an interface for creating new puzzles.}} + 
    
  [[Image:Palapeli Pattern Tutorial1.png]]   [[Image:Palapeli Pattern Tutorial1.png]]



Majewsky: new section /* Distribute everything */
2009-11-10T00:05:58Z
new section - ‎Distribute everything

				
				
				
				
			
			← Older revision
			Revision as of 00:05, 10 November 2009
			
Line 174:
Line 174:
    
  [[Image:Palapeli Pattern Tutorial1.png]]   [[Image:Palapeli Pattern Tutorial1.png]]
  + 
  + == Distribute everything ==
  + 
  + If you want to release your code, please add the FindLibPala.cmake script to your source tarball. This ensures that people trying to build your code without having libpala development files installed will get meaningful errors.



Majewsky: replace tabs by spaces in code examples; MediaWiki seems to mess up tabs
2009-09-27T14:52:30Z
replace tabs by spaces in code examples; MediaWiki seems to mess up tabs

				
				
				
				
			
			← Older revision
			Revision as of 14:52, 27 September 2009
			
Line 32:
Line 32:
  class MySlicer : public Pala::Slicer   class MySlicer : public Pala::Slicer
  {   {
− 	Q_OBJECT +     Q_OBJECT
− 	public: +     public:
− 		MySlicer(QObject* parent = 0, const QVariantList& args = QVariantList()); +         MySlicer(QObject* parent = 0, const QVariantList& args = QVariantList());
− 		virtual bool run(Pala::SlicerJob* job); +         virtual bool run(Pala::SlicerJob* job);
  };   };
    
Line 58:
Line 58:
    
  MySlicer::MySlicer(QObject* parent, const QVariantList& args)   MySlicer::MySlicer(QObject* parent, const QVariantList& args)
− 	: Pala::Slicer(parent, args) +     : Pala::Slicer(parent, args)
  {   {
− 	Pala::SlicerProperty* prop; +     Pala::SlicerProperty* prop;
− 	prop = new Pala::SlicerProperty(Pala::SlicerProperty::Integer, i18n("Piece count in horizontal direction")); +     prop = new Pala::SlicerProperty(Pala::SlicerProperty::Integer, i18n("Piece count in horizontal direction"));
− 	prop->setRange(3, 100); +     prop->setRange(3, 100);
− 	prop->setDefaultValue(10); +     prop->setDefaultValue(10);
− 	addProperty("XCount", prop); +     addProperty("XCount", prop);
− 	prop = new Pala::SlicerProperty(Pala::SlicerProperty::Integer, i18n("Piece count in vertical direction")); +     prop = new Pala::SlicerProperty(Pala::SlicerProperty::Integer, i18n("Piece count in vertical direction"));
− 	prop->setRange(3, 100); +     prop->setRange(3, 100);
− 	prop->setDefaultValue(10); +     prop->setDefaultValue(10);
− 	addProperty("YCount", prop); +     addProperty("YCount", prop);
  }   }
    
  bool MySlicer::run(Pala::SlicerJob* job)   bool MySlicer::run(Pala::SlicerJob* job)
  {   {
− 	//read job +     //read job
− 	const int xCount = job->argument("XCount").toInt(); +     const int xCount = job->argument("XCount").toInt();
− 	const int yCount = job->argument("YCount").toInt(); +     const int yCount = job->argument("YCount").toInt();
− 	const QImage image = job->image(); +     const QImage image = job->image();
− 	//calculate some metrics +     //calculate some metrics
− 	const int pieceWidth = image.width() / xCount; +     const int pieceWidth = image.width() / xCount;
− 	const int pieceHeight = image.height() / yCount; +     const int pieceHeight = image.height() / yCount;
− 	const QSize pieceSize(pieceWidth, pieceHeight); +     const QSize pieceSize(pieceWidth, pieceHeight);
− 	//create pieces +     //create pieces
− 	for (int x = 0; x < xCount; ++x) +     for (int x = 0; x < xCount; ++x)
− 	{ +     {
− 		for (int y = 0; y < yCount; ++y) +         for (int y = 0; y < yCount; ++y)
− 		{ +         {
− 			//calculate more metrics +             //calculate more metrics
− 			const QPoint offset(x * pieceWidth, y * pieceHeight); +             const QPoint offset(x * pieceWidth, y * pieceHeight);
− 			const QRect pieceBounds(offset, pieceSize); +             const QRect pieceBounds(offset, pieceSize);
− 			//copy image part to piece +             //copy image part to piece
− 			const QImage pieceImage = image.copy(pieceBounds); +             const QImage pieceImage = image.copy(pieceBounds);
− 			job->addPiece(x + y * xCount, pieceImage, offset); +             job->addPiece(x + y * xCount, pieceImage, offset);
− 		} +         }
− 	} +     }
− 	//create relations +     //create relations
− 	for (int x = 0; x < xCount; ++x) +     for (int x = 0; x < xCount; ++x)
− 	{ +     {
− 		for (int y = 0; y < yCount; ++y) +         for (int y = 0; y < yCount; ++y)
− 		{ +         {
− 			//along X axis (pointing left) +             //along X axis (pointing left)
− 			if (x != 0) +             if (x != 0)
− 				job->addRelation(x + y * xCount, (x - 1) + y * xCount); +                 job->addRelation(x + y * xCount, (x - 1) + y * xCount);
− 			//along Y axis (pointing up) +             //along Y axis (pointing up)
− 			if (y != 0) +             if (y != 0)
− 				job->addRelation(x + y * xCount, x + (y - 1) * xCount); +                 job->addRelation(x + y * xCount, x + (y - 1) * xCount);
− 		} +         }
− 	} +     }
− 	return true; +     return true;
  }   }
    



Majewsky: new version for libpala is ready
2009-09-27T14:50:22Z
new version for libpala is ready
Show changes


Majewsky: moved Development/Tutorials/Games/Palapeli Patterns to Development/Tutorials/Games/Palapeli Slicers: Name change in libpala
2009-09-27T14:18:42Z
moved Development/Tutorials/Games/Palapeli Patterns to Development/Tutorials/Games/Palapeli Slicers: Name change in libpala

			
			← Older revision
			Revision as of 14:18, 27 September 2009

@@ Line 39: / Line 39: @@
 #endif // MYSLICER_H
-</code>
+</syntaxhighlight>
 As described above, we need to create a subclass of <tt>Pala::Slicer</tt>. (We also include the other two classes from libpala, <tt>Pala::SlicerJob</tt> and <tt>Pala::SlicerProperty</tt>, which we'll be using in the code.) For this example, we only need to implement the minimum of two functions:
@@ Line 111: / Line 111: @@
 #include "myslicer.moc"
-</code>
+</syntaxhighlight>
 The two <tt>KPlugin</tt> headers are necessary for the plugin integration, which happens in line 7 and 8. Note that the string constant in line 8 (<tt>"myslicer"</tt>) needs to match your library name.
@@ Line 148: / Line 148: @@
 X-KDE-PluginInfo-License=GPL
 X-KDE-PluginInfo-EnabledByDefault=true
-</code>
+</syntaxhighlight>
 We need to tell the Palapeli library that there is a new plugin out there. We need a desktop entry file like shown here. You can mostly copy everything you see here; the most important thing is to keep the fields <tt>X-KDE-Library</tt> and <tt>X-KDE-PluginInfo-Name</tt> in sync with the library name (see next section). Note that the name is used in the "New puzzle" dialog to identify this pattern. (It can be translated; for example, a German translation has been added in the above example.)
@@ Line 167: / Line 167: @@
 install(TARGETS myslicer DESTINATION ${PLUGIN_INSTALL_DIR})
 install(FILES myslicer.desktop DESTINATION ${SERVICES_INSTALL_DIR})
-</code>
+</syntaxhighlight>
 Everything of this is pretty straightforward if you have previous experience with CMake (and this is what I assume). Make sure you compile everything as a plugin, and install it into the plugin directory. Do not forget to link against the "pala" target (which corresponds to libpala). After having installed the plugin, run <tt>kbuildsycoca4</tt>. This will locate your plugin, and enable Palapeli to use it. Here is how it should look like then:
 [[Image:Palapeli Pattern Tutorial1.png]]

← Older revision		Revision as of 20:36, 11 November 2009
Line 172:		Line 172:

	[[Image:Palapeli Pattern Tutorial1.png]]		[[Image:Palapeli Pattern Tutorial1.png]]
−
−	~~== Distribute everything ==~~
−
−	If you want to release your code, please add the FindLibPala.cmake script to your source tarball. This ensures that people trying to build your code without having libpala development files installed will get meaningful errors.

← Older revision		Revision as of 00:05, 10 November 2009
Line 174:		Line 174:

	[[Image:Palapeli Pattern Tutorial1.png]]		[[Image:Palapeli Pattern Tutorial1.png]]
		+
		+	== Distribute everything ==
		+
		+	If you want to release your code, please add the FindLibPala.cmake script to your source tarball. This ensures that people trying to build your code without having libpala development files installed will get meaningful errors.