KDE Games/API cleanup: Difference between revisions

From KDE Community Wiki
 
(8 intermediate revisions by 3 users not shown)
Line 3: Line 3:
<small>The fine print: The SO version for libkdegames v5 is actually 6.</small>
<small>The fine print: The SO version for libkdegames v5 is actually 6.</small>


== List of components ==
== Components ==


libkdegames consists of multiple (possibly interdependent) components, as defined by this list. The "Dependencies" column records only dependencies to other libkdegames components. See the table below for which file belongs to which component.
libkdegames consists of multiple (possibly interdependent) components, as defined by this list. The "Dependencies" column records only dependencies to other libkdegames components. See the table below for which file belongs to which component.
=== Needing attention ===
This table lists the components which need attention.


{| class="sortable" border="1" cellpadding="5" cellspacing="0" style="border: gray solid 1px; border-collapse: collapse; text-align: left; width:100%;"
{| class="sortable" border="1" cellpadding="5" cellspacing="0" style="border: gray solid 1px; border-collapse: collapse; text-align: left; width:100%;"
Line 13: Line 17:
! Dependencies
! Dependencies
! Move target
! Move target
|- style="background-color:#EEFFEE"
| style="background-color:#ABFFAB" | base
| Macros and API-less behavior.
| -
|
|- style="background-color:#EEFFEE"
| style="background-color:#ABFFAB" | carddecks
| Carddeck theme loading and selection.
| -
|
|- style="background-color:#EEFFEE"
|- style="background-color:#EEFFEE"
| style="background-color:#ABFFAB" | highscore
| style="background-color:#ABFFAB" | highscore
Line 43: Line 37:
| kgamerenderer (integration)
| kgamerenderer (integration)
| libkgamecanvas_private
| libkgamecanvas_private
|- style="background-color:#EEFFEE"
| style="background-color:#ABFFAB" | kgamerenderer
| Rendering of theme graphics.
| theming
|
|- style="background-color:#EEFFEE"
| style="background-color:#ABFFAB" | misc/clock
| Game clock (second accuracy).
| -
|
|- style="background-color:#EEFFEE"
| style="background-color:#ABFFAB" | misc/difficulty
| Track difficulty level.
| -
|
|- style="background-color:#EEEEFF"
| style="background-color:#ABABFF" | misc/popupitem
| Message popup for QGraphicsView.
| -
|
|- style="background-color:#EEFFEE"
| style="background-color:#ABFFAB" | misc/standardactions
| Standard KActions for games.
| -
|
|- style="background-color:#FFFFCD"
|- style="background-color:#FFFFCD"
| style="background-color:#FFFFA0" | misc/svgdocument
| style="background-color:#FFFFA0" | misc/svgdocument
Line 73: Line 42:
| -
| -
| ksirk
| ksirk
|- style="background-color:#EEFFEE"
| style="background-color:#ABFFAB" | theming
| Management of SVG themes.
| -
|
|}
|}


Line 88: Line 52:
| style="background-color:#FFFFA0" | Make private
| style="background-color:#FFFFA0" | Make private
| style="background-color:#ABFFAB" | Keep
| style="background-color:#ABFFAB" | Keep
| style="background-color:#ABFFFF" width="100" | New
| style="background-color:#ABABFF" | Undecided
| style="background-color:#ABABFF" | Undecided
|-
|-
Line 94: Line 59:
| style="background-color:#FFFFCD" | Code is moved into the tree of the only application which uses it. Headers are not exported anymore.
| style="background-color:#FFFFCD" | Code is moved into the tree of the only application which uses it. Headers are not exported anymore.
| style="background-color:#EEFFEE" | Code stays in libkdegames. API and implementation changes may still be necessary.  
| style="background-color:#EEFFEE" | Code stays in libkdegames. API and implementation changes may still be necessary.  
| style="background-color:#EEFFFF" | New code and API (e.g. coming from Project Tagaro).
| style="background-color:#EEEEFF" | To be discussed on kde-games-devel mailinglist.  
| style="background-color:#EEEEFF" | To be discussed on kde-games-devel mailinglist.  
|}
|}


=== Removed components ===
=== Done ===
 
This table lists those components which have already been taken care of.


{| class="sortable" border="1" cellpadding="5" cellspacing="0" style="border: gray solid 1px; border-collapse: collapse; text-align: left; width:100%;"
{| class="sortable" border="1" cellpadding="5" cellspacing="0" style="border: gray solid 1px; border-collapse: collapse; text-align: left; width:100%;"
Line 105: Line 73:
! Dependencies
! Dependencies
! Move target
! Move target
|- style="background-color:#EEFFFF"
| style="background-color:#ABFFFF" | audio
| Simple sound playback.
| -
|
|- style="background-color:#EEFFEE"
| style="background-color:#ABFFAB" | base
| Macros and API-less behavior.
| -
|
|- style="background-color:#EEFFEE"
| style="background-color:#ABFFAB" | carddecks
| SVG card deck files used by KPat and LSkat.
| -
|
|- style="background-color:#FFFFCD"
| style="background-color:#FFFFA0" | cardloading
| Carddeck theme loading and selection.
| -
| lskat
|- style="background-color:#EEFFEE"
| style="background-color:#ABFFAB" | kgamerenderer
| Rendering of theme graphics.
| theming
|
|- style="background-color:#FFEEEE"
|- style="background-color:#FFEEEE"
| style="background-color:#FFABAB" | kggz
| style="background-color:#FFABAB" | kggz
Line 110: Line 103:
| -
| -
|  
|  
|- style="background-color:#FFEEEE"
|- style="background-color:#EEFFEE"
| style="background-color:#FFABAB" | misc/grid2d
| style="background-color:#ABFFAB" | misc/clock
| Game clock (second accuracy).
| -
|
|- style="background-color:#EEFFEE"
| style="background-color:#ABFFAB" | misc/difficulty
| Track difficulty level.
| -
|
|- style="background-color:#FFFFCD"
| style="background-color:#FFFFA0" | misc/grid2d
| Coordinate calculations on 2D grids.
| Coordinate calculations on 2D grids.
| -
| -
|  
| krosswordpuzzle (playground)
|- style="background-color:#FFEEEE"
|- style="background-color:#FFEEEE"
| style="background-color:#FFABAB" | misc/lcd
| style="background-color:#FFABAB" | misc/lcd
| Enhanced QLCDNumber.
| Enhanced QLCDNumber.
| -
|
|- style="background-color:#EEFFEE"
| style="background-color:#ABFFAB" | misc/popupitem
| Message popup for QGraphicsView.
| -
| -
|  
|  
Line 128: Line 136:
| style="background-color:#FFABAB" | misc/randomname
| style="background-color:#FFABAB" | misc/randomname
| Function to generate a random name.
| Function to generate a random name.
| -
|
|- style="background-color:#EEFFEE"
| style="background-color:#ABFFAB" | misc/standardactions
| Standard KActions for games.
| -
| -
|  
|  
Line 135: Line 148:
| -
| -
|  
|  
|- style="background-color:#EEFFEE"
| style="background-color:#ABFFAB" | theming
| Management of SVG themes.
| -
|
|}
&nbsp;
{| border="1" cellpadding="5" cellspacing="0" style="border: gray solid 1px; border-collapse: collapse; text-align: left; width:100%;"
|- style="white-space:nowrap;"
! Color key
| style="background-color:#FFABAB" | Deleted
| style="background-color:#FFFFA0" | Moved out
| style="background-color:#ABFFAB" | Kept
| style="background-color:#ABFFFF" width="100" | New
|-
! Description
| style="background-color:#FFEEEE" | Has been deleted from libkdegames.
| style="background-color:#FFFFCD" | Has been moved into the source tree of the mentioned move target.
| style="background-color:#EEFFEE" | Has been kept in libkdegames. Where appropriate, API and implementation have been updated.
| style="background-color:#EEFFFF" | Has been merged into libkdegames.
|}
|}


== List of files ==
== List of files (as of 4.8 release) ==




Line 144: Line 179:
! Source file
! Source file
! Belongs to component
! Belongs to component
|-
| cardcache.<span style="color:green">cpp</span>/<span style="color:red">h</span>/<span style="color:blue">ph</span>
| carddecks
|-
| carddeckinfo.<span style="color:green">cpp</span>/<span style="color:red">h</span>/<span style="color:blue">ph</span>
| carddecks
|-
|-
| chooserastergraphicssystem.<span style="color:green">cpp</span>
| chooserastergraphicssystem.<span style="color:green">cpp</span>
Line 177: Line 206:
| highscore/kscoredialog.<span style="color:green">cpp</span>/<span style="color:red">h</span>
| highscore/kscoredialog.<span style="color:green">cpp</span>/<span style="color:red">h</span>
| highscore
| highscore
|-
| kcarddialog.<span style="color:green">cpp</span>/<span style="color:red">h</span>
| carddecks
|-
|-
| kchatbase.<span style="color:green">cpp</span>/<span style="color:red">h</span>
| kchatbase.<span style="color:green">cpp</span>/<span style="color:red">h</span>
Line 303: Line 329:
| tests/kgamepropertytest.<span style="color:green">cpp</span>/<span style="color:red">h</span>
| tests/kgamepropertytest.<span style="color:green">cpp</span>/<span style="color:red">h</span>
| kgame
| kgame
|-
| includes/KCardCache
| carddecks
|-
| includes/KCardDeckInfo
| carddecks
|-
| includes/KCardDialog
| carddecks
|-
|-
| includes/KChat
| includes/KChat
Line 440: Line 457:
! Source file
! Source file
! Belongs to component
! Belongs to component
|-
| cardcache.<span style="color:green">cpp</span>/<span style="color:red">h</span>/<span style="color:blue">ph</span>
| cardloading
|-
| carddeckinfo.<span style="color:green">cpp</span>/<span style="color:red">h</span>/<span style="color:blue">ph</span>
| cardloading
|-
|-
| digits/kgamesvgdigits.<span style="color:green">cpp</span>/<span style="color:red">h</span>
| digits/kgamesvgdigits.<span style="color:green">cpp</span>/<span style="color:red">h</span>
| misc/svgdigits  
| misc/svgdigits  
|-
| kcarddialog.<span style="color:green">cpp</span>/<span style="color:red">h</span>
| cardloading
|-
|-
| kgamelcd.<span style="color:green">cpp</span>/<span style="color:red">h</span>
| kgamelcd.<span style="color:green">cpp</span>/<span style="color:red">h</span>
Line 500: Line 526:
| tests/kgamesvgdocumenttest.<span style="color:green">cpp</span>/<span style="color:red">h</span>
| tests/kgamesvgdocumenttest.<span style="color:green">cpp</span>/<span style="color:red">h</span>
| misc/svgdocument
| misc/svgdocument
|-
| includes/KCardCache
| cardloading
|-
| includes/KCardDeckInfo
| cardloading
|-
| includes/KCardDialog
| cardloading
|-
|-
| includes/KGameLCD
| includes/KGameLCD

Latest revision as of 00:43, 15 April 2012

libkdegames v5 is the new iteration of libkdegames which is intended to ship with KDE Development Platform 4.9. The aim for this new iteration of the library is to remove most of the API that is obsolete, unused or in a state of bad quality, in order to improve maintainability and relevance of the remaining API. Also, QtWidgets-specific parts need to be separated to prepare for QML-based games.

The fine print: The SO version for libkdegames v5 is actually 6.

Components

libkdegames consists of multiple (possibly interdependent) components, as defined by this list. The "Dependencies" column records only dependencies to other libkdegames components. See the table below for which file belongs to which component.

Needing attention

This table lists the components which need attention.

Component Short desc. Dependencies Move target
highscore Highscore recording and GUI. -
kchat Chat widget. -
kgame General game framework. kchat ksirk
kgamecanvas Alternative to QGraphicsView. kgamerenderer (integration) libkgamecanvas_private
misc/svgdocument Transform SVG elements. - ksirk

 

Color key Delete Make private Keep New Undecided
Description Code and headers are removed from the source tree. Code is moved into the tree of the only application which uses it. Headers are not exported anymore. Code stays in libkdegames. API and implementation changes may still be necessary. New code and API (e.g. coming from Project Tagaro). To be discussed on kde-games-devel mailinglist.

Done

This table lists those components which have already been taken care of.

Component Short desc. Dependencies Move target
audio Simple sound playback. -
base Macros and API-less behavior. -
carddecks SVG card deck files used by KPat and LSkat. -
cardloading Carddeck theme loading and selection. - lskat
kgamerenderer Rendering of theme graphics. theming
kggz Network-enabled multiplayer. -
misc/clock Game clock (second accuracy). -
misc/difficulty Track difficulty level. -
misc/grid2d Coordinate calculations on 2D grids. - krosswordpuzzle (playground)
misc/lcd Enhanced QLCDNumber. -
misc/popupitem Message popup for QGraphicsView. -
misc/progress A very old progress bar. -
misc/randomname Function to generate a random name. -
misc/standardactions Standard KActions for games. -
misc/svgdigits Digits rendered from SVG. -
theming Management of SVG themes. -

 

Color key Deleted Moved out Kept New
Description Has been deleted from libkdegames. Has been moved into the source tree of the mentioned move target. Has been kept in libkdegames. Where appropriate, API and implementation have been updated. Has been merged into libkdegames.

List of files (as of 4.8 release)

Source file Belongs to component
chooserastergraphicssystem.cpp base
colorproxy_p.cpp/h kgamerenderer
highscore/kexthighscore.cpp/h highscore
highscore/kexthighscore_gui.cpp/h highscore
highscore/kexthighscore_internal.cpp/h highscore
highscore/kexthighscore_item.cpp/h highscore
highscore/kexthighscore_tab.cpp/h highscore
highscore/khighscore.cpp/h highscore
highscore/kscoredialog.cpp/h highscore
kchatbase.cpp/h kchat
kchatbaseitemdelegate.cpp/h kchat
kchatbasemodel.cpp/h kchat
kchat.cpp/h kchat
kchatdialog.cpp/h kchat
kgamecanvas.cpp/h kgamecanvas
kgameclock.cpp/h misc/clock
kgame/dialogs/kgameconnectdialog.cpp/h kgame
kgame/dialogs/kgamedebugdialog.cpp/h kgame
kgame/dialogs/kgamedialogconfig.cpp/h kgame
kgame/dialogs/kgamedialog.cpp/h kgame
kgame/dialogs/kgameerrordialog.cpp/h kgame
kgamedifficulty.cpp/h misc/difficulty
kgame/kgamechat.cpp/h kgame
kgame/kgame.cpp/h kgame
kgame/kgameerror.cpp/h kgame
kgame/kgameio.cpp/h kgame
kgame/kgamemessage.cpp/h kgame
kgame/kgamenetwork.cpp/h kgame
kgame/kgameprocess.cpp/h kgame
kgame/kgamepropertyarray.h kgame
kgame/kgameproperty.cpp/h kgame
kgame/kgamepropertyhandler.cpp/h kgame
kgame/kgamesequence.cpp/h kgame
kgame/kgameversion.h kgame
kgame/kmessageclient.cpp/h kgame
kgame/kmessageio.cpp/h kgame
kgame/kmessageserver.cpp/h/ph kgame
kgame/kplayer.cpp/h kgame
kgamepopupitem.cpp/h misc/popupitem
kgamerendereditem.cpp/h kgamerenderer
kgamerenderedobjectitem.cpp/h kgamerenderer
kgamerendererclient.cpp/h kgamerenderer
kgamerenderer.cpp/h/ph kgamerenderer
kgamesvgdocument.cpp/h/ph misc/svgdocument
kgametheme.cpp/h theming
kgamethemeselector.cpp/h theming
kstandardgameaction.cpp/h misc/standardactions
libkdegames_export.h base
tests/kgamepopupitemtest.cpp/h misc/popupitem
tests/kgamepropertytest.cpp/h kgame
includes/KChat kchat
includes/KChatBase kchat
includes/KChatBaseItemDelegate kchat
includes/KChatDialog kchat
includes/KExtHighscore highscore
includes/KGameCanvas kgamecanvas
includes/KGameClock misc/clock
includes/KGameDifficulty misc/difficulty
includes/KGame/KGame kgame
includes/KGame/KGameChat kgame
includes/KGame/KGameConnectDialog kgame
includes/KGame/KGameDebugDialog kgame
includes/KGame/KGameDialog kgame
includes/KGame/KGameDialogConfig kgame
includes/KGame/KGameError kgame
includes/KGame/KGameErrorDialog kgame
includes/KGame/KGameIO kgame
includes/KGame/KGameMessage kgame
includes/KGame/KGameNetwork kgame
includes/KGame/KGameProcess kgame
includes/KGame/KGameProperty kgame
includes/KGame/KGamePropertyArray kgame
includes/KGame/KGamePropertyHandler kgame
includes/KGame/KGameSequence kgame
includes/KGame/KGameVersion kgame
includes/KGame/KMessageClient kgame
includes/KGame/KMessageIO kgame
includes/KGame/KMessageServer kgame
includes/KGame/KPlayer kgame
includes/KGamePopupItem misc/popupitem
includes/KGameRenderedItem kgamerenderer
includes/KGameRenderedObjectItem kgamerenderer
includes/KGameRenderer kgamerenderer
includes/KGameRendererClient kgamerenderer
includes/KGameSvgDocument misc/svgdocument
includes/KGameTheme theming
includes/KGameThemeSelector theming
includes/KHighscore highscore
includes/KScoreDialog highscore
includes/KStandardGameAction misc/standardactions

Removed files

Source file Belongs to component
cardcache.cpp/h/ph cardloading
carddeckinfo.cpp/h/ph cardloading
digits/kgamesvgdigits.cpp/h misc/svgdigits
kcarddialog.cpp/h cardloading
kgamelcd.cpp/h misc/lcd
kgamemisc.cpp/h misc/randomname
kgameprogress.cpp/h misc/progress
kggzgames/kggzgames_export.h kggz
kggzgames/kggzrankingsdialog.cpp/h kggz
kggzgames/kggzseatsdialog.cpp/h kggz
kggzmod/event.cpp/h kggz
kggzmod/kggzmod_export.h kggz
kggzmod/misc_private.h kggz
kggzmod/module.cpp/h/ph kggz
kggzmod/player.cpp/h/ph kggz
kggzmod/request.cpp/h kggz
kggzmod/statistics.cpp/h/ph kggz
kggznet/kggznet_export.h kggz
kggznet/kggzpacket.cpp/h kggz
kggznet/kggzraw.cpp/h kggz
kgrid2d.h misc/grid2d
tests/kgamesvgdigitstest.cpp/h misc/svgdigits
tests/kgamesvgdocumenttest.cpp/h misc/svgdocument
includes/KCardCache cardloading
includes/KCardDeckInfo cardloading
includes/KCardDialog cardloading
includes/KGameLCD misc/lcd
includes/KGameMisc misc/randomname
includes/KGameProgress misc/progress
includes/KGameSvgDigits misc/svgdigits
includes/KGGZRankingsDialog kggz
includes/KGGZSeatsDialog kggz
includes/KGrid2D misc/grid2d