File indexing completed on 2025-01-05 03:51:40

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 add texture
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 "texturetoolplugin.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 "texturetool.h"
0029 
0030 namespace DigikamEditorTextureToolPlugin
0031 {
0032 
0033 TextureToolPlugin::TextureToolPlugin(QObject* const parent)
0034     : DPluginEditor(parent)
0035 {
0036 }
0037 
0038 TextureToolPlugin::~TextureToolPlugin()
0039 {
0040 }
0041 
0042 QString TextureToolPlugin::name() const
0043 {
0044     return i18nc("@title", "Texture");
0045 }
0046 
0047 QString TextureToolPlugin::iid() const
0048 {
0049     return QLatin1String(DPLUGIN_IID);
0050 }
0051 
0052 QIcon TextureToolPlugin::icon() const
0053 {
0054     return QIcon::fromTheme(QLatin1String("texture"));
0055 }
0056 
0057 QString TextureToolPlugin::description() const
0058 {
0059     return i18nc("@info", "A tool to apply a texture over an image");
0060 }
0061 
0062 QString TextureToolPlugin::details() const
0063 {
0064     return i18nc("@info", "This Image Editor tool can apply a texture over an image.");
0065 }
0066 
0067 QString TextureToolPlugin::handbookSection() const
0068 {
0069     return QLatin1String("image_editor");
0070 }
0071 
0072 QString TextureToolPlugin::handbookChapter() const
0073 {
0074     return QLatin1String("decorate_tools");
0075 }
0076 
0077 QString TextureToolPlugin::handbookReference() const
0078 {
0079     return QLatin1String("decorate-texture");
0080 }
0081 
0082 QList<DPluginAuthor> TextureToolPlugin::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-2010"))
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 TextureToolPlugin::setup(QObject* const parent)
0095 {
0096     DPluginAction* const ac = new DPluginAction(parent);
0097     ac->setIcon(icon());
0098     ac->setText(i18nc("@action", "Apply Texture..."));
0099     ac->setObjectName(QLatin1String("editorwindow_decorate_texture"));
0100     ac->setActionCategory(DPluginAction::EditorDecorate);
0101 
0102     connect(ac, SIGNAL(triggered(bool)),
0103             this, SLOT(slotTexture()));
0104 
0105     addAction(ac);
0106 }
0107 
0108 void TextureToolPlugin::slotTexture()
0109 {
0110     EditorWindow* const editor = dynamic_cast<EditorWindow*>(sender()->parent());
0111 
0112     if (editor)
0113     {
0114         TextureTool* const tool = new TextureTool(editor);
0115         tool->setPlugin(this);
0116         editor->loadTool(tool);
0117     }
0118 }
0119 
0120 } // namespace DigikamEditorTextureToolPlugin
0121 
0122 #include "moc_texturetoolplugin.cpp"