From 0e221b59bdfc529c436f30a69c1eb8fb932b6adc Mon Sep 17 00:00:00 2001
From: "Aaron J. Seigo" <aseigo@kde.org>
Date: Fri, 3 Aug 2007 12:38:57 +0000
Subject: [PATCH] add the ability to include a screenshot with packages

svn path=/trunk/KDE/kdebase/workspace/libs/plasma/; revision=695963
---
 packagemetadata.cpp | 17 +++++++++++++++++
 packagemetadata.h   | 12 ++++++++++++
 2 files changed, 29 insertions(+)

diff --git a/packagemetadata.cpp b/packagemetadata.cpp
index 707c8c2cf..e9adfe333 100644
--- a/packagemetadata.cpp
+++ b/packagemetadata.cpp
@@ -30,6 +30,10 @@ namespace Plasma
 class PackageMetadata::Private
 {
     public:
+        Private()
+            : screenshot("screenshot.png")
+        {}
+
         QString name;
         QString description;
         QString author;
@@ -42,6 +46,7 @@ class PackageMetadata::Private
         QString requiredVersion;
         QString releaseNotes;
         QString icon;
+        QString screenshot;
         QString preview;
         QString type;
         QString serviceType;
@@ -83,6 +88,7 @@ void PackageMetadata::write(const QString& filename) const
     config.writeEntry("Name", d->name);
     config.writeEntry("Description", d->description);
     config.writeEntry("Icon", d->icon);
+    config.writeEntry("X-KDE-Screenshot", d->screenshot);
     config.writeEntry("ServiceTypes", d->serviceType);
     config.writeEntry("X-KDE-PluginInfo-Name", d->name);
     config.writeEntry("X-KDE-PluginInfo-Author", d->author);
@@ -105,6 +111,7 @@ void PackageMetadata::read(const QString& filename)
     d->name = config.readEntry("X-KDE-PluginInfo-Name", d->name);
     d->description = config.readEntry("Description", d->description);
     d->icon = config.readEntry("Icon", d->icon);
+    d->screenshot= config.readEntry("X-KDE-Screenshot", d->screenshot);
     d->serviceType = config.readEntry("ServiceTypes", d->serviceType);
     d->author = config.readEntry("X-KDE-PluginInfo-Author", d->author);
     d->email = config.readEntry("X-KDE-PluginInfo-Email", d->email);
@@ -182,6 +189,11 @@ QString PackageMetadata::icon() const
     return d->icon;
 }
 
+QString PackageMetadata::screenshot() const
+{
+    return d->screenshot;
+}
+
 QString PackageMetadata::preview() const
 {
     return d->preview;
@@ -256,6 +268,11 @@ void PackageMetadata::setIcon(const QString &icon)
     d->icon = icon;
 }
 
+void PackageMetadata::setScreenshot(const QString & screenshot)
+{
+    d->screenshot = screenshot;
+}
+
 void PackageMetadata::setPreview(const QString& path)
 {
     d->preview = path;
diff --git a/packagemetadata.h b/packagemetadata.h
index b7a7e5f79..32631eba4 100644
--- a/packagemetadata.h
+++ b/packagemetadata.h
@@ -81,6 +81,11 @@ public:
     // filename
     QString icon() const;
 
+    /**
+     * @return the name of the screenshot file, screenshot.png by default
+     */
+    QString screenshot() const;
+
     /**
      * Path to a PNG file containing a preview image.
      * This might be a screenshot, for instance.
@@ -108,6 +113,13 @@ public:
     // filename
     void setIcon(const QString &);
 
+    /**
+     * Sets the name of the screenshot file.
+     *
+     * @param file the name of the file
+     */
+    void setScreenshot(const QString &file);
+
     /**
      * Sets the path for the file containing a preview image.
      * This might be a screenshot, for instance.