Projects/Games/Porting to libkdegames v5

This document describes the changes introduced with libkdegames v5, which first appeared in the KDE 4.9 release.

New components

• KgSound provides a simple API for playback of short event sounds. Low latency is achieved through the use of OpenAL, with a Phonon fallback if the required libraries are not available.

Also, multiple new components have been added which replace existing components. These can be identified by the common class name prefix "Kg". See [[#Reworked components|]] for details.

Removed components

• The KGGZ framework has been removed completely.
• KGameLCD — Use QLCDNumber instead.
• KGameMisc — Instead of a random name, we advise to use generic names where appropriate.
• KGameProgress — Use QProgressBar instead.
• KGameSvgDigits — If you need SVG digits, include them in your own SVG theme.
• KGrid2D — You'll need to do the math yourself.

Reworked components

Difficulty

KGameDifficulty has been replaced by the KgDifficulty and KgDifficultyLevel classes. KgDifficulty stores the current level by itself, and allows for multiple KgDifficulty instances at the same time, although a singleton is provided by the Kg::difficulty() function. The following table shows how to port KGameDifficulty functions:

Replace this...	...by this	Comment
KGameDifficulty::standardLevel	KgDifficultyLevel::StandardLevel
KGameDifficulty::Medium etc.	KgDifficultyLevel::Medium etc.
KGameDifficulty::addStandardLevel	Kg::difficulty()->addStandardLevel	As a convenience, consider to use the new addStandardLevelRange method.

TODO: finish table, commit the functions in namespace Kg