File indexing completed on 2025-01-19 03:59:30

 /* ============================================================
  *
  * This file is a part of digiKam project
  * https://www.digikam.org
  *
  * Date        : 2013-08-19
  * Description : Thread actions task for image quality sorter.
  *
  * SPDX-FileCopyrightText: 2013-2024 by Gilles Caulier <caulier dot gilles at gmail dot com>
  * SPDX-FileCopyrightText: 2013-2014 by Gowtham Ashok <gwty93 at gmail dot com>
  * SPDX-FileCopyrightText: 2021-2022 by Phuoc Khanh Le <phuockhanhnk94 at gmail dot com>
  *
  * SPDX-License-Identifier: GPL-2.0-or-later
  *
  * ============================================================ */
 
 #include "imagequalitytask.h"
 
 // Local includes
 
 #include "digikam_debug.h"
 #include "dimg.h"
 #include "previewloadthread.h"
 #include "imagequalitycontainer.h"
 #include "imagequalityparser.h"
 #include "iteminfo.h"
 #include "maintenancedata.h"
 
 namespace Digikam
 {
 
 class Q_DECL_HIDDEN ImageQualityTask::Private
 {
 public:
 
     explicit Private()
         : imgqsort(nullptr),
           data    (nullptr)
     {
     }
 
     ImageQualityContainer quality;
     ImageQualityParser*   imgqsort;
 
     MaintenanceData*      data;
 };
 
 // -------------------------------------------------------
 
 ImageQualityTask::ImageQualityTask()
     : ActionJob(),
       d        (new Private)
 {
 }
 
 ImageQualityTask::~ImageQualityTask()
 {
     slotCancel();
     cancel();
 
     delete d;
 }
 
 void ImageQualityTask::setQuality(const ImageQualityContainer& quality)
 {
     d->quality = quality;
 }
 
 void ImageQualityTask::setMaintenanceData(MaintenanceData* const data)
 {
     d->data = data;
 }
 
 void ImageQualityTask::slotCancel()
 {
     if (d->imgqsort)
     {
         d->imgqsort->cancelAnalyse();
     }
 }
 
 void ImageQualityTask::run()
 {
     // While we have data (using this as check for non-null)
 
     while (d->data)
     {
         if (m_cancel)
         {
             return;
         }
 
         QString path = d->data->getImagePath();
 
         if (path.isEmpty())
         {
             break;
         }
 
         // Get item preview to perform quality analysis. No need to load whole image, this will be slower.
         // 1024 pixels size image must be enough to get suitable Quality results.
 
         DImg dimg = PreviewLoadThread::loadFastSynchronously(path, 1024);
 
         if (!dimg.isNull() && !m_cancel)
         {
             // Run Quality analysis backend and store Pick Label result to database.
             // Backend Input : d->quality as Quality analysis settings,
             //                 dimg       as reduced size image data to parse,
             //                 path       as file path to patch database properties.
             // Result        : Backend must scan Quality of image depending of settings and compute a Quality estimation accordingly.
             //                 Finally, using file path, database Pick Label properties is assigned through ItemInfo interface.
             // Warning       : All code here will run in a separated thread and must be re-entrant/thread-safe. Only pure computation
             //                 must be processed. GUI calls are prohibited. ItemInfo and DImg can be used safety in thread.
 
             PickLabel pick;
             d->imgqsort = new ImageQualityParser(dimg, d->quality, &pick);
             d->imgqsort->startAnalyse();
 
             ItemInfo info = ItemInfo::fromLocalFile(path);
             info.setPickLabel(pick);
 
             // delete image data after to set label
 
             delete d->imgqsort;
             d->imgqsort = nullptr;
         }
 
         // Dispatch progress to Progress Manager
 
         QImage qimg = dimg.smoothScale(22, 22, Qt::KeepAspectRatio).copyQImage();
 
         Q_EMIT signalFinished(qimg);
     }
 
     Q_EMIT signalDone();
 }
 
 } // namespace Digikam
 
 #include "moc_imagequalitytask.cpp"