File indexing completed on 2024-04-21 04:55:26

 /*
     This file is part of Choqok, the KDE micro-blogging client
 
     SPDX-FileCopyrightText: 2008-2012 Mehrdad Momeny <mehrdad.momeny@gmail.com>
 
     SPDX-License-Identifier: GPL-2.0-only OR GPL-3.0-only OR LicenseRef-KDE-Accepted-GPL
 */
 
 #ifndef MEDIAMANAGER_H
 #define MEDIAMANAGER_H
 
 #include <QObject>
 #include <QMap>
 #include <QPixmap>
 #include <QUrl>
 
 #include "choqok_export.h"
 
 namespace KIO
 {
 class Job;
 }
 class KJob;
 namespace Choqok
 {
 /**
     @brief Media files manager!
     A simple and global way to fetch and cache images
 
     @author Mehrdad Momeny \<mehrdad.momeny@gmail.com\>
 */
 class CHOQOK_EXPORT MediaManager : public QObject
 {
     Q_OBJECT
 public:
     enum ReturnMode {
         Sync = 0, Async
     };
     ~MediaManager();
 
     static MediaManager *self();
 
     /**
      * @brief Fetch an Image and cache it for later use.
      *
      * @param remoteUrl The URL of image to fetch
      * @param mode Return mode, if set to Sync and the image is not available in the cache the null pixmap will be returned.
      * if mode set to @ref Async and image is not available in the cache, the null pixmap will be returned
      * and then @ref MediaManager will fetch the image and emit @ref imageFetched() on success or
      * emit @ref fetchError() on error.
      * And if mode set to @ref Sync and image is not in the cache @ref MediaManager will not fetch it.
      *
      * @return return @ref QPixmap of requested image if exists in cache, otherwise null pixmap
      */
     QPixmap fetchImage(const QUrl &remoteUrl, ReturnMode mode = Sync);
 
     /**
      * @return KDE Default image
      */
     QPixmap &defaultImage();
 
     /**
      * @brief Parse a text for EmotIcons with kde default theme.
      */
     QString parseEmoticons(const QString &text);
 
     static QPixmap convertToGrayScale(const QPixmap &pic);
 
     /**
     Upload medium at @p localUrl to @p pluginId service or to last used service when @p pluginId is empty.
 
     @see mediumUploaded()
     @see mediumUploadFailed()
     */
     void uploadMedium(const QUrl &localUrl, const QString &pluginId = QString());
 
     /**
     Create and return a byte array containing a multipart/form-data to send with HTTP POST request
 
     Boundary is AaB03x
 
     @param formdata are the "form-data" parts of data.
                     This map knows as a list of name/value pairs
     @param mediaFiles are media files attached to form, each file stored in one QMap in list
 
     @note media file maps should contain these keys:
         name: The name of entry
         filename: the file name on server
         medium: contain the medium data loaded from disk!
         mediumType: type of medium file
     */
     static QByteArray createMultipartFormData(const QMap<QString, QByteArray> &formdata,
             const QList< QMap<QString, QByteArray> > &mediaFiles);
 
 public Q_SLOTS:
     /**
      * @brief Clear image cache
      */
     void clearImageCache();
 
 Q_SIGNALS:
     void fetchError(const QUrl &remoteUrl, const QString &errMsg);
     void imageFetched(const QUrl &remoteUrl, const QPixmap &pixmap);
 
     void mediumUploaded(const QUrl &localUrl, const QString &remoteUrl);
     void mediumUploadFailed(const QUrl &localUrl, const QString &errorMessage);
 
 protected Q_SLOTS:
     void slotImageFetched(KJob *job);
 
 protected:
     MediaManager();
 
 private:
     class Private;
     Private *const d;
     static MediaManager *mSelf;
 };
 
 }
 #endif