File indexing completed on 2025-03-09 03:50:36

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 crop an image with ratio.
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 "ratiocroptoolplugin.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 "ratiocroptool.h"
0029 
0030 namespace DigikamEditorRatioCropToolPlugin
0031 {
0032 
0033 RatioCropToolPlugin::RatioCropToolPlugin(QObject* const parent)
0034     : DPluginEditor(parent)
0035 {
0036 }
0037 
0038 RatioCropToolPlugin::~RatioCropToolPlugin()
0039 {
0040 }
0041 
0042 QString RatioCropToolPlugin::name() const
0043 {
0044     return i18nc("@title", "Aspect Ratio Crop");
0045 }
0046 
0047 QString RatioCropToolPlugin::iid() const
0048 {
0049     return QLatin1String(DPLUGIN_IID);
0050 }
0051 
0052 QIcon RatioCropToolPlugin::icon() const
0053 {
0054     return QIcon::fromTheme(QLatin1String("transform-crop"));
0055 }
0056 
0057 QString RatioCropToolPlugin::description() const
0058 {
0059     return i18nc("@info", "A tool to crop an image with ratio");
0060 }
0061 
0062 QString RatioCropToolPlugin::details() const
0063 {
0064     return i18nc("@info", "This Image Editor tool can crop an image with ratio.");
0065 }
0066 
0067 QString RatioCropToolPlugin::handbookSection() const
0068 {
0069     return QLatin1String("image_editor");
0070 }
0071 
0072 QString RatioCropToolPlugin::handbookChapter() const
0073 {
0074     return QLatin1String("transform_tools");
0075 }
0076 
0077 QString RatioCropToolPlugin::handbookReference() const
0078 {
0079     return QLatin1String("transform-proportionalcrop");
0080 }
0081 
0082 QList<DPluginAuthor> RatioCropToolPlugin::authors() const
0083 {
0084     return QList<DPluginAuthor>()
0085             << DPluginAuthor(QString::fromUtf8("Jaromir Malenko"),
0086                              QString::fromUtf8("malenko at email dot cz"),
0087                              QString::fromUtf8("(C) 2007"))
0088             << DPluginAuthor(QString::fromUtf8("Roberto Castagnola"),
0089                              QString::fromUtf8("roberto dot castagnola at gmail dot com"),
0090                              QString::fromUtf8("(C) 2008"))
0091             << DPluginAuthor(QString::fromUtf8("Gilles Caulier"),
0092                              QString::fromUtf8("caulier dot gilles at gmail dot com"),
0093                              QString::fromUtf8("(C) 2004-2021"))
0094             ;
0095 }
0096 
0097 void RatioCropToolPlugin::setup(QObject* const parent)
0098 {
0099     DPluginAction* const ac = new DPluginAction(parent);
0100     ac->setIcon(icon());
0101     ac->setText(i18nc("@action", "Aspect Ratio Crop..."));
0102     ac->setObjectName(QLatin1String("editorwindow_transform_ratiocrop"));
0103     ac->setActionCategory(DPluginAction::EditorTransform);
0104 
0105     connect(ac, SIGNAL(triggered(bool)),
0106             this, SLOT(slotRatioCrop()));
0107 
0108     addAction(ac);
0109 }
0110 
0111 void RatioCropToolPlugin::slotRatioCrop()
0112 {
0113     EditorWindow* const editor = dynamic_cast<EditorWindow*>(sender()->parent());
0114 
0115     if (editor)
0116     {
0117         RatioCropTool* const tool = new RatioCropTool(editor);
0118         tool->setPlugin(this);
0119         editor->loadTool(tool);
0120     }
0121 }
0122 
0123 } // namespace DigikamEditorRatioCropToolPlugin
0124 
0125 #include "moc_ratiocroptoolplugin.cpp"