editortool.h

Go to the documentation of this file.

/* ============================================================
 *
 * This file is a part of digiKam project
 * https://www.digikam.org
 *
 * Date        : 2008-08-20
 * Description : editor tool template class.
 *
 * Copyright (C) 2008-2022 by Gilles Caulier <caulier dot gilles at gmail dot com>
 *
 * 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_IMAGE_EDITOR_TOOL_H
#define DIGIKAM_IMAGE_EDITOR_TOOL_H
 
// Qt includes
 
#include <QObject>
#include <QString>
#include <QPixmap>
#include <QPoint>
 
// Local includes
 
#include "digikam_export.h"
#include "dcolor.h"
#include "previewtoolbar.h"
#include "filteraction.h"
#include "dplugineditor.h"
 
namespace Digikam
{
 
class DImgThreadedFilter;
class DImgThreadedAnalyser;
class EditorToolSettings;
 
class DIGIKAM_EXPORT EditorTool : public QObject
{
    Q_OBJECT
 
public:
 
    explicit EditorTool(QObject* const parent);
    ~EditorTool()                               override;
 
    void setPlugin(DPlugin* const plugin);
    DPlugin* plugin()                     const;
 
    void init();
 
    void setInitPreview(bool b);
 
    QString                toolHelp()     const;
    QString                toolName()     const;
    int                    toolVersion()  const;
    QIcon                  toolIcon()     const;
    QWidget*               toolView()     const;
    EditorToolSettings*    toolSettings() const;
    FilterAction::Category toolCategory() const;
 
    virtual void setBackgroundColor(const QColor& bg);
    virtual void ICCSettingsChanged();
    virtual void exposureSettingsChanged();
 
public Q_SLOTS:
 
    void slotUpdateSpotInfo(const Digikam::DColor& col, const QPoint& point);
    void slotPreviewModeChanged();
 
    virtual void slotCloseTool();
    virtual void slotApplyTool();
 
Q_SIGNALS:
 
    void okClicked();
    void cancelClicked();
 
protected:
 
    void setToolInfoMessage(const QString& txt);
    void setToolHelp(const QString& anchor);
    void setToolName(const QString& name);
    void setToolVersion(const int version);
    void setToolIcon(const QIcon& icon);
    void setPreviewModeMask(int mask);
    void setToolCategory(const FilterAction::Category category);
 
    virtual void setToolView(QWidget* const view);
    virtual void setToolSettings(EditorToolSettings* const settings);
    virtual void setBusy(bool);
    virtual void readSettings();
    virtual void writeSettings();
    virtual void finalRendering()     {};
 
protected Q_SLOTS:
 
    void slotTimer();
 
    virtual void slotOk();
    virtual void slotCancel();
    virtual void slotInit();
    virtual void slotResetSettings();
    virtual void slotLoadSettings()   {};
    virtual void slotSaveAsSettings() {};
    virtual void slotPreview()        {};
    virtual void slotChannelChanged() {};
    virtual void slotScaleChanged()   {};
 
private:
 
    class Private;
    Private* const d;
};
 
// -----------------------------------------------------------------
 
class DIGIKAM_EXPORT EditorToolThreaded : public EditorTool
{
    Q_OBJECT
 
public:
 
    enum RenderingMode
    {
        NoneRendering = 0,
        PreviewRendering,
        FinalRendering
    };
 
public:
 
    explicit EditorToolThreaded(QObject* const parent);
    ~EditorToolThreaded()                                     override;
 
    void setProgressMessage(const QString& mess);
 
    RenderingMode renderingMode()                       const;
 
public Q_SLOTS:
 
    virtual void slotAbort();
 
protected:
 
    DImgThreadedFilter* filter()                        const;
    void setFilter(DImgThreadedFilter* const filter);
 
    DImgThreadedAnalyser* analyser()                    const;
    void setAnalyser(DImgThreadedAnalyser* const analyser);
 
    void deleteFilterInstance(bool b = true);
 
    virtual void preparePreview()    {};
    virtual void prepareFinal()      {};
    virtual void setPreviewImage()   {};
    virtual void setFinalImage()     {};
    virtual void renderingFinished() {};
    virtual void analyserCompleted() {};
 
protected Q_SLOTS:
 
    void slotFilterStarted();
    void slotFilterFinished(bool success);
 
    void slotAnalyserStarted();
    void slotAnalyserFinished(bool success);
 
    void slotProgress(int progress);
 
    void slotInit()                                           override;
    void slotOk()                                             override;
    void slotCancel()                                         override;
    void slotPreview()                                        override;
 
private Q_SLOTS:
 
    void slotResized();
 
private:
 
    class Private;
    Private* const d;
};
 
} // namespace Digikam
 
#endif // DIGIKAM_IMAGE_EDITOR_TOOL_H