maintenancethread.h

Go to the documentation of this file.

/* ============================================================
 *
 * This file is a part of digiKam project
 * https://www.digikam.org
 *
 * Date        : 2013-08-09
 * Description : Thread actions manager for maintenance tools.
 *
 * Copyright (C) 2013-2022 by Gilles Caulier <caulier dot gilles at gmail dot com>
 * Copyright (C) 2017-2018 by Mario Frank <mario dot frank at uni minus potsdam dot de>
 *
 * This program 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, 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.
 *
 * ============================================================ */
 
#ifndef DIGIKAM_MAINTENANCE_THREAD_H
#define DIGIKAM_MAINTENANCE_THREAD_H
 
// Qt includes
 
#include <QList>
 
// Local includes
 
#include "actionthreadbase.h"
#include "metadatasynchronizer.h"
#include "iteminfo.h"
#include "identity.h"
 
class QImage;
 
namespace Digikam
{
 
class ImageQualityContainer;
class MaintenanceData;
 
class MaintenanceThread : public ActionThreadBase
{
    Q_OBJECT
 
public:
 
    explicit MaintenanceThread(QObject* const parent);
    ~MaintenanceThread() override;
 
    void setUseMultiCore(const bool b);
 
    void syncMetadata(const ItemInfoList& items, MetadataSynchronizer::SyncDirection dir, bool tagsOnly);
    void generateThumbs(const QStringList& paths);
    void generateFingerprints(const QList<qlonglong>& itemIds, bool rebuildAll);
    void sortByImageQuality(const QStringList& paths, const ImageQualityContainer& quality);
 
    void computeDatabaseJunk(bool thumbsDb = false, bool facesDb = false, bool similarityDb = false);
    void cleanCoreDb(const QList<qlonglong>& imageIds);
    void cleanThumbsDb(const QList<int>& thumbnailIds);
    void cleanFacesDb(const QList<Identity>& staleIdentities);
    void cleanSimilarityDb(const QList<qlonglong>& imageIds);
    void shrinkDatabases();
 
    void cancel();
 
    QString getThumbFingerprintPath();
 
Q_SIGNALS:
 
    void signalStarted();
 
    void signalAdvance(const QImage&);
 
    void signalAdvance();
 
    void signalCompleted();
 
    void signalCanceled();
 
    void signalData(const QList<qlonglong>& staleImageIds,
                    const QList<int>& staleThumbIds,
                    const QList<Identity>& staleIdentities,
                    const QList<qlonglong>& staleSimilarityImageIds);
 
    void signalAddItemsToProcess(int count);
 
    void signalFinished(bool done, bool errorFree);
 
private Q_SLOTS:
 
    void slotThreadFinished();
 
private:
 
/*
    template<typename T>
    QList<QList<T>> chunkList(const QList<T>& toChunk, int chunkSize=0)
    {
        QList<QList<T>> chunks;
 
        // Chunk size 0 means all
 
        if (chunkSize == 0)
        {
            chunks << toChunk;
            return chunks;
        }
 
        // Buffer the input list
        QList<T> toChunkList = toChunk;
        QList<T> currentChunk;
 
        while (!toChunkList.isEmpty())
        {
            // Set the current chunk to the first n elements
            currentChunk = toChunkList.mid(0,chunkSize);
            // Set the buffer list to the rest, i.e.
            // start at position n and take all from this position
            // If n is bigger than the size, an empty list is returned.
            // see qarraydata.cpp in Qt implementation.
            toChunkList  = toChunkList.mid(chunkSize);
            chunks << currentChunk;
        }
 
        return chunks;
    }
 
    int getChunkSize(int elementCount);
*/
 
    MaintenanceData* const data;
};
 
} // namespace Digikam
 
#endif // DIGIKAM_MAINTENANCE_THREAD_H