/usr/include/kgametheme.h is in libkdegames-dev 4:4.8.2-0ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 | /*
Copyright (C) 2007 Mauricio Piacentini <mauricio@tabuleiro.com>
Copyright (C) 2007 Matt Williams <matt@milliams.com>
This library is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
#ifndef KGAMETHEME_H
#define KGAMETHEME_H
#include <libkdegames_export.h>
#include <QtCore/QString>
class KGameThemePrivate;
class QPixmap;
/**
* \class KGameTheme kgametheme.h <KGameTheme>
*
* @short Class for loading theme files
*
* Essentially just a wrapper around a .desktop theme file. Load a file with
* load() and then access its properties.
*
* For more advanced feaures like dynamic themes or custom game rules, it
* will likely be necessary to derive from this class
*
* @author Mauricio Piacentini
**/
class KDEGAMES_EXPORT KGameTheme
{
public:
KGameTheme(const QString &themeGroup = QLatin1String("KGameTheme"));
virtual ~KGameTheme();
/**
* Load the default theme file. Called "default.desktop"
* @return true if the theme files and properties could be loaded
*/
virtual bool loadDefault();
/**
* Load a specific theme file.
* Note that although theme could be successfully loaded,
* no check on the validity of theme's SVG file contents is done.
* Application writers will need to perform this check manually
* e.g. by calling QSvgRenderer::isValid()
* @param file the name of the theme file relative to the share/apps/appname
* directory. e.g. "themes/classic.desktop"
* @return true if the theme files and properties could be loaded
*/
virtual bool load(const QString &file);
/// @return the full path of the .desktop file
QString path() const;
/// @return just the "*.desktop" part
QString fileName() const;
/// @return the full path of the svg file which is specified in "FileName" key
virtual QString graphics() const;
/// @return a property directly from the .desktop file
QString property(const QString &key) const;
/// @return a preview pixmap
QPixmap preview() const;
/**
* Possible keys:
* - Name
* - Author
* - Description
* - AuthorEmail
* @param key the key of the wanted property
* @return the data related to 'key'
*/
virtual QString themeProperty(const QString &key) const;
private:
friend class KGameThemePrivate;
KGameThemePrivate *const d;
};
#endif
|