File indexing completed on 2025-01-19 03:51:13

0001 /* ============================================================
0002  *
0003  * This file is a part of digiKam project
0004  * https://www.digikam.org
0005  *
0006  * Date        : 2018-07-30
0007  * Description : image editor plugin to adjust perspective.
0008  *
0009  * SPDX-FileCopyrightText: 2018-2024 by Gilles Caulier <caulier dot gilles at gmail dot com>
0010  *
0011  * SPDX-License-Identifier: GPL-2.0-or-later
0012  *
0013  * ============================================================ */
0014 
0015 #include "perspectivetoolplugin.h"
0016 
0017 // Qt includes
0018 
0019 #include <QPointer>
0020 
0021 // KDE includes
0022 
0023 #include <klocalizedstring.h>
0024 
0025 // Local includes
0026 
0027 #include "editorwindow.h"
0028 #include "perspectivetool.h"
0029 
0030 namespace DigikamEditorPerspectiveToolPlugin
0031 {
0032 
0033 PerspectiveToolPlugin::PerspectiveToolPlugin(QObject* const parent)
0034     : DPluginEditor(parent)
0035 {
0036 }
0037 
0038 PerspectiveToolPlugin::~PerspectiveToolPlugin()
0039 {
0040 }
0041 
0042 QString PerspectiveToolPlugin::name() const
0043 {
0044     return i18nc("@title", "Perspective");
0045 }
0046 
0047 QString PerspectiveToolPlugin::iid() const
0048 {
0049     return QLatin1String(DPLUGIN_IID);
0050 }
0051 
0052 QIcon PerspectiveToolPlugin::icon() const
0053 {
0054     return QIcon::fromTheme(QLatin1String("perspective"));
0055 }
0056 
0057 QString PerspectiveToolPlugin::description() const
0058 {
0059     return i18nc("@info", "A tool to adjust perspective");
0060 }
0061 
0062 QString PerspectiveToolPlugin::details() const
0063 {
0064     return i18nc("@info", "This Image Editor tool can adjust perspective from an image.");
0065 }
0066 
0067 QString PerspectiveToolPlugin::handbookSection() const
0068 {
0069     return QLatin1String("image_editor");
0070 }
0071 
0072 QString PerspectiveToolPlugin::handbookChapter() const
0073 {
0074     return QLatin1String("transform_tools");
0075 }
0076 
0077 QString PerspectiveToolPlugin::handbookReference() const
0078 {
0079     return QLatin1String("transform-perspective");
0080 }
0081 
0082 QList<DPluginAuthor> PerspectiveToolPlugin::authors() const
0083 {
0084     return QList<DPluginAuthor>()
0085             << DPluginAuthor(QString::fromUtf8("Marcel Wiesweg"),
0086                              QString::fromUtf8("marcel dot wiesweg at gmx dot de"),
0087                              QString::fromUtf8("(C) 2006-2012"))
0088             << DPluginAuthor(QString::fromUtf8("Gilles Caulier"),
0089                              QString::fromUtf8("caulier dot gilles at gmail dot com"),
0090                              QString::fromUtf8("(C) 2005-2021"))
0091             ;
0092 }
0093 
0094 void PerspectiveToolPlugin::setup(QObject* const parent)
0095 {
0096     DPluginAction* const ac = new DPluginAction(parent);
0097     ac->setIcon(icon());
0098     ac->setText(i18nc("@action", "Perspective Adjustment..."));
0099     ac->setObjectName(QLatin1String("editorwindow_transform_perspective"));
0100     ac->setActionCategory(DPluginAction::EditorTransform);
0101 
0102     connect(ac, SIGNAL(triggered(bool)),
0103             this, SLOT(slotPerspective()));
0104 
0105     addAction(ac);
0106 }
0107 
0108 void PerspectiveToolPlugin::slotPerspective()
0109 {
0110     EditorWindow* const editor = dynamic_cast<EditorWindow*>(sender()->parent());
0111 
0112     if (editor)
0113     {
0114         PerspectiveTool* const tool = new PerspectiveTool(editor);
0115         tool->setPlugin(this);
0116         editor->loadTool(tool);
0117     }
0118 }
0119 
0120 } // namespace DigikamEditorPerspectiveToolPlugin
0121 
0122 #include "moc_perspectivetoolplugin.cpp"