File indexing completed on 2025-10-19 03:37:52

 /*
     File                 : WelcomeScreenHelper.cpp
     Project              : LabPlot
     Description          : Helper class for the welcome screen
     --------------------------------------------------------------------
     SPDX-FileCopyrightText: 2019 Ferencz Kovacs <kferike98@gmail.com>
 
     SPDX-License-Identifier: GPL-2.0-or-later
 */
 #include "WelcomeScreenHelper.h"
 #include "backend/datasources/DatasetHandler.h"
 #include "kdefrontend/DatasetModel.h"
 #include "kdefrontend/datasources/ImportDatasetWidget.h"
 
 #include <QBuffer>
 #include <QDebug>
 #include <QFile>
 #include <QJsonArray>
 #include <QJsonDocument>
 #include <QJsonObject>
 #include <QStandardPaths>
 #include <QTimer>
 #include <QUrl>
 
 #include <KCompressionDevice>
 #include <KConfigGroup>
 #include <KFilterDev>
 #include <KSharedConfig>
 
 /*!
 \class WelcomeScreenHelper
 \brief Helper class for the welcome screen
 
 \ingroup kdefrontend
 */
 WelcomeScreenHelper::WelcomeScreenHelper()
     : m_datasetWidget(new ImportDatasetWidget(0)) {
     m_datasetWidget->hide();
 
     QIcon icon = QIcon::fromTheme("labplot-maximize");
     m_maxIcon = icon.pixmap(icon.availableSizes().constFirst());
 
     icon = QIcon::fromTheme("labplot-minimize");
     m_minIcon = icon.pixmap(icon.availableSizes().constFirst());
 
     m_datasetModel = new DatasetModel(m_datasetWidget->getDatasetsMap());
 
     loadConfig();
     processExampleProjects();
 }
 
 WelcomeScreenHelper::~WelcomeScreenHelper() {
     // save width&height ratio values
     KConfigGroup conf(KSharedConfig::openConfig(), "WelcomeScreenHelper");
 
     int widthCount = m_widthScale.size();
     conf.writeEntry("width_count", widthCount);
     int currentWidthIndex = 0;
 
     for (auto item = m_widthScale.begin(); item != m_widthScale.end() && currentWidthIndex < widthCount; ++item) {
         conf.writeEntry("widthName_" + QString::number(currentWidthIndex), item.key());
         conf.writeEntry("widthValue_" + QString::number(currentWidthIndex), QString::number(item.value()));
         currentWidthIndex++;
     }
 
     int heightCount = m_heightScale.size();
     conf.writeEntry("height_count", widthCount);
     int currentHeightIndex = 0;
 
     for (auto item = m_heightScale.begin(); item != m_heightScale.end() && currentHeightIndex < heightCount; ++item) {
         conf.writeEntry("heightName_" + QString::number(currentHeightIndex), item.key());
         conf.writeEntry("heightValue_" + QString::number(currentHeightIndex), QString::number(item.value()));
         currentHeightIndex++;
     }
 }
 
 /**
  * @brief Loads the saved configuration
  */
 void WelcomeScreenHelper::loadConfig() {
     KConfigGroup conf(KSharedConfig::openConfig(), "WelcomeScreenHelper");
 
     int widthCount = conf.readEntry("width_count", -1);
     for (int i = 0; i < widthCount; ++i) {
         QString id = conf.readEntry("widthName_" + QString::number(i), "");
         double value = QString(conf.readEntry("widthValue_" + QString::number(i), "-1")).toDouble();
 
         if (!id.isEmpty() && value != -1)
             m_widthScale[id] = value;
     }
 
     int heightCount = conf.readEntry("height_count", -1);
     for (int i = 0; i < heightCount; ++i) {
         QString id = conf.readEntry("heightName_" + QString::number(i), "");
         double value = QString(conf.readEntry("heightValue_" + QString::number(i), "-1")).toDouble();
 
         if (!id.isEmpty() && value != -1)
             m_heightScale[id] = value;
     }
 }
 
 /**
  * @brief Handles a dataset being clicked in the dataset section of the WelcomeScreen.
  * Initiates listing information about the dataset in the previously mentioned section.
  *
  * @param category the category the dataset belongs to
  * @param subcategory the subcategory the dataset belongs to
  * @param datasetName the name of the dataset
  */
 void WelcomeScreenHelper::datasetClicked(const QString& category, const QString& subcategory, const QString& datasetName) {
     m_datasetWidget->setCollection("All");
     m_datasetWidget->setCategory(category);
     m_datasetWidget->setSubcategory(subcategory);
     m_datasetWidget->setDataset(datasetName);
     m_spreadsheet.reset(new Spreadsheet(i18n("Dataset%1", 1)));
 
     if (m_datasetHandler)
         delete m_datasetHandler;
     m_datasetHandler = new DatasetHandler(m_spreadsheet.get());
 
     m_datasetWidget->import(m_datasetHandler);
 
     QTimer timer;
     timer.setSingleShot(true);
     QEventLoop loop;
     connect(m_datasetHandler, &DatasetHandler::downloadCompleted, &loop, &QEventLoop::quit);
     connect(&timer, &QTimer::timeout, &loop, &QEventLoop::quit);
     timer.start(1500);
     loop.exec();
 
     if (timer.isActive()) {
         timer.stop();
         Q_EMIT datasetFound();
     } else
         Q_EMIT datasetNotFound();
 }
 
 /**
  * @brief Returns the dataset's full name.
  */
 QVariant WelcomeScreenHelper::datasetName() {
     return QVariant(m_spreadsheet->name());
 }
 
 /**
  * @brief Returns the dataset's descripton.
  */
 QVariant WelcomeScreenHelper::datasetDescription() {
     return QVariant(m_spreadsheet->comment());
 }
 
 /**
  * @brief Returns the number of the dataset's columns.
  */
 QVariant WelcomeScreenHelper::datasetColumns() {
     return QVariant(m_spreadsheet->columnCount());
 }
 
 /**
  * @brief Returns the number of the dataset's rows.
  */
 QVariant WelcomeScreenHelper::datasetRows() {
     return QVariant(m_spreadsheet->rowCount());
 }
 
 /**
  * @brief Returns a pointer to the spreadsheet in which the data of the dataset was loaded.
  */
 Spreadsheet* WelcomeScreenHelper::releaseConfiguredSpreadsheet() {
     return m_spreadsheet.release();
 }
 
 /**
  * @brief Returns the thumbnail image saved with the project.
  * @param url the path to the saved project file.
  */
 QVariant WelcomeScreenHelper::getProjectThumbnail(const QUrl& url) {
     QString filename;
     if (url.isLocalFile()) // fix for Windows
         filename = url.toLocalFile();
     else
         filename = url.path();
 
     QIODevice* file;
     // first try gzip compression, because projects can be gzipped and end with .lml
     if (filename.endsWith(QLatin1String(".lml"), Qt::CaseInsensitive))
         file = new KCompressionDevice(filename, KFilterDev::compressionTypeForMimeType("application/x-gzip"));
     else // opens filename using file ending
         file = new KFilterDev(filename);
 
     if (!file)
         file = new QFile(filename);
 
     if (!file->open(QIODevice::ReadOnly)) {
         qDebug() << "Could not open file for reading.";
         return QVariant();
     }
 
     char c;
     bool rc = file->getChar(&c);
     if (!rc) {
         qDebug() << "The project file is empty.";
         file->close();
         delete file;
         return false;
     }
     file->seek(0);
 
     // parse XML
     XmlStreamReader reader(file);
     while (!(reader.isStartDocument() || reader.atEnd()))
         reader.readNext();
 
     if (!(reader.atEnd())) {
         if (!reader.skipToNextTag())
             return false;
 
         if (reader.name() == "project") {
             QString thumbnail = reader.attributes().value("thumbnail").toString();
 
             thumbnail.prepend("data:image/jpg;base64,");
             return QVariant(thumbnail);
         }
     }
     return QVariant();
 }
 
 /**
  * @brief Returns a pointer to the datasetModel of the class.
  */
 DatasetModel* WelcomeScreenHelper::getDatasetModel() {
     return m_datasetModel;
 }
 
 /**
  * @brief Processes metadata file containing example projects.
  */
 void WelcomeScreenHelper::processExampleProjects() {
     const QString filePath = QStandardPaths::locate(QStandardPaths::AppDataLocation, "example_projects/example_projects.json");
     QFile file(filePath);
 
     if (file.open(QIODevice::ReadOnly)) {
         QJsonDocument document = QJsonDocument::fromJson(file.readAll());
         QJsonArray exampleArray = document.array();
 
         // processing examples
         for (int i = 0; i < exampleArray.size(); ++i) {
             const QJsonObject currentExample = exampleArray[i].toObject();
 
             const QString exampleName = currentExample.value("name").toString();
             if (m_projectNameList.contains(exampleName)) {
                 qDebug() << "There is already an example file with this name";
             } else {
                 m_projectNameList.append(exampleName);
                 const QString exampleFile = currentExample.value("fileName").toString();
                 m_pathMap[exampleName] = exampleFile;
 
                 // processing tags
                 const QJsonArray tags = currentExample.value("tags").toArray();
                 for (int j = 0; j < tags.size(); ++j) {
                     QString tagName = tags[j].toString();
                     m_tagMap[tagName].append(exampleName);
                     m_datasetTag[exampleName].append(tagName);
                 }
             }
         }
 
         file.close();
     } else {
         qDebug("Couldn't open dataset category file");
     }
 }
 
 /**
  * @brief Returns in string format the thumbnail for the given example file
  */
 QVariant WelcomeScreenHelper::getExampleProjectThumbnail(const QString& exampleName) {
     const QString filePath = QStandardPaths::locate(QStandardPaths::AppDataLocation, "example_projects/" + m_pathMap[exampleName]);
     return getProjectThumbnail(filePath);
 }
 
 /**
  * @brief Returns the list of example projects.
  */
 QVariant WelcomeScreenHelper::getExampleProjects() {
     return QVariant(m_projectNameList);
 }
 
 /**
  * @brief Returns the tags of the given example project.
  */
 QVariant WelcomeScreenHelper::getExampleProjectTags(const QString& exampleName) {
     QString tags;
     const QStringList& tagList = m_datasetTag[exampleName];
 
     for (int i = 0; i < tagList.size(); i++) {
         tags.append(tagList[i]);
         if (i < tagList.size() - 1)
             tags.append(", ");
     }
 
     return QVariant(tags);
 }
 
 /**
  * @brief Handles an example project being clicked in the welcome screen.
  * @param exampleName the name of the clicked example project
  */
 void WelcomeScreenHelper::exampleProjectClicked(const QString& exampleName) {
     QString path = QStandardPaths::locate(QStandardPaths::AppDataLocation, "example_projects/" + m_pathMap[exampleName]);
     Q_EMIT openExampleProject(path);
 }
 
 /**
  * @brief Searches among the example projects based on the text introduce in the search bar of the welcome screen.
  * @param searchtext - the text based on which we'll have to search
  * @return Returns the results
  */
 QVariant WelcomeScreenHelper::searchExampleProjects(const QString& searchtext) {
     QStringList results;
 
     // search based on tags
     for (auto tag = m_tagMap.begin(); tag != m_tagMap.end(); ++tag) {
         if (tag.key().contains(searchtext)) {
             for (QString example : tag.value()) {
                 if (!results.contains(example))
                     results.append(example);
             }
         }
     }
 
     // search based on name
     for (QString example : m_projectNameList) {
         if (example.contains(searchtext) && !results.contains(example))
             results.append(example);
     }
 
     return QVariant(results);
 }
 
 /**
  * @brief Sets the width scale for the given section, which will be saved.
  */
 void WelcomeScreenHelper::setWidthScale(const QString& sectionID, double scale) {
     m_widthScale[sectionID] = scale;
 }
 
 /**
  * @brief Sets the height scale for the given section, which will be saved.
  */
 void WelcomeScreenHelper::setHeightScale(const QString& sectionID, double scale) {
     m_heightScale[sectionID] = scale;
 }
 
 /**
  * @brief Returns the width scale for the given section.
  */
 QVariant WelcomeScreenHelper::getWidthScale(const QString& sectionID) {
     if (m_widthScale.contains(sectionID))
         return QVariant(m_widthScale[sectionID]);
 
     return QVariant(-1);
 }
 
 /**
  * @brief Returns the height scale for the given section.
  */
 QVariant WelcomeScreenHelper::getHeightScale(const QString& sectionID) {
     if (m_heightScale.contains(sectionID))
         return QVariant(m_heightScale[sectionID]);
 
     return QVariant(-1);
 }
 
 /**
  * @brief Returns the maximize icon.
  */
 QVariant WelcomeScreenHelper::getMaxIcon() {
     QByteArray bArray;
     QBuffer buffer(&bArray);
     buffer.open(QIODevice::WriteOnly);
     m_maxIcon.save(&buffer, "PNG");
     QString image = QString::fromLatin1(bArray.toBase64().data());
     image.prepend("data:image/png;base64,");
     return QVariant(image);
 }
 
 /**
  * @brief Returns the minimize icon.
  */
 QVariant WelcomeScreenHelper::getMinIcon() {
     QByteArray bArray;
     QBuffer buffer(&bArray);
     buffer.open(QIODevice::WriteOnly);
     m_minIcon.save(&buffer, "PNG");
     QString image = QString::fromLatin1(bArray.toBase64().data());
     image.prepend("data:image/png;base64,");
     return QVariant(image);
 }
 
 /**
  * @brief Returns the go-back icon.
  */
 QVariant WelcomeScreenHelper::getBackIcon() {
     QIcon icon = QIcon::fromTheme("labplot-back");
     QPixmap pixmap = icon.pixmap(icon.availableSizes().constFirst());
     QByteArray bArray;
     QBuffer buffer(&bArray);
     buffer.open(QIODevice::WriteOnly);
     pixmap.save(&buffer, "PNG");
     QString image = QString::fromLatin1(bArray.toBase64().data());
     image.prepend("data:image/png;base64,");
     return QVariant(image);
 }
 
 /**
  * @brief Returns the go-forward icon.
  */
 QVariant WelcomeScreenHelper::getForwardIcon() {
     QIcon icon = QIcon::fromTheme("labplot-forward");
     QPixmap pixmap = icon.pixmap(icon.availableSizes().constFirst());
     QByteArray bArray;
     QBuffer buffer(&bArray);
     buffer.open(QIODevice::WriteOnly);
     pixmap.save(&buffer, "PNG");
     QString image = QString::fromLatin1(bArray.toBase64().data());
     image.prepend("data:image/png;base64,");
     return QVariant(image);
 }