// SPDX-License-Identifier: GPL-2.0-or-later /* * Authors: * Martin Owens * * Copyright (C) 2022 Authors * * Released under GNU GPL v2+, read the file 'COPYING' for more information. */ #ifndef INKSCAPE_EXTENSION_TEMPLATE_H__ #define INKSCAPE_EXTENSION_TEMPLATE_H__ #include #include #include #include #include #include #include "extension/db.h" #include "extension/extension.h" #include "util/units.h" class SPDocument; class SPPage; namespace Inkscape { namespace Extension { using TemplateShow = int; enum TemplateVisibility : TemplateShow { TEMPLATE_ANY = -1, // Any visibility TEMPLATE_HIDDEN = 0, TEMPLATE_NEW_FROM = 1, TEMPLATE_NEW_WELCOME = 2, TEMPLATE_NEW_ICON = 3, TEMPLATE_SIZE_LIST = 4, TEMPLATE_SIZE_SEARCH = 8, TEMPLATE_ALL = 255 // Set as visible everywhere }; class Template; class TemplatePreset; typedef std::map TemplatePrefs; typedef std::vector> TemplatePresets; class TemplatePreset { public: TemplatePreset(Template *mod, const Inkscape::XML::Node *repr, TemplatePrefs prefs = {}, int priority = 0); ~TemplatePreset() {}; std::string get_key() const { return _key; } std::string get_icon() const { return _icon; } std::string get_name() const; std::string get_label() const; int get_sort_priority() const { return _priority; } int get_visibility() const { return _visibility; } bool is_visible(TemplateShow mode) { // Not hidden and contains the requested mode. return _visibility && (mode == TEMPLATE_ANY || ((_visibility & (int)mode) == (int)mode)); } SPDocument *new_from_template(const TemplatePrefs &others = {}); void resize_to_template(SPDocument *doc, SPPage *page, const TemplatePrefs &others = {}); bool match_size(double width, double height, const TemplatePrefs &others = {}); Glib::ustring get_icon_path() const; private: Template *_mod; protected: std::string _key; std::string _icon; std::string _name; std::string _label; int _priority; int _visibility; // This is a set of preferences given to the extension TemplatePrefs _prefs; Glib::ustring _get_icon_path(const std::string &name) const; bool setup_prefs(const TemplatePrefs &others = {}); void _add_prefs(const TemplatePrefs &prefs); }; class Template : public Extension { public: struct create_cancelled : public std::exception { ~create_cancelled() noexcept override = default; const char *what() const noexcept override { return "Create was cancelled"; } }; Template(Inkscape::XML::Node *in_repr, Implementation::Implementation *in_imp, std::string *base_directory); ~Template() override = default; bool check() override; SPDocument *new_from_template(); void resize_to_template(SPDocument *doc, SPPage *page); std::string get_icon() const { return _icon; } std::string get_description() const { return _desc; } std::string get_category() const { return _category; } bool can_resize() const { return _can_resize; } int get_visibility() const { return _visibility; } TemplatePresets get_presets(TemplateShow visibility = TEMPLATE_ANY) const; std::shared_ptr get_preset(const std::string &key); std::shared_ptr get_preset(double width, double height); static std::shared_ptr get_any_preset(const std::string &key); static std::shared_ptr get_any_preset(double width, double height); Glib::RefPtr get_template_filename() const; SPDocument *get_template_document() const; protected: friend class TemplatePreset; static int parse_visibility(const std::string &value); private: std::string _source; std::string _icon; std::string _desc; std::string _category; bool _can_resize = false; // Can this be used to resize existing pages? int _visibility = TEMPLATE_SIZE_SEARCH; TemplatePresets _presets; }; } // namespace Extension } // namespace Inkscape #endif /* INKSCAPE_EXTENSION_TEMPLATE_H__ */ /* Local Variables: mode:c++ c-file-style:"stroustrup" c-file-offsets:((innamespace . 0)(inline-open . 0)(case-label . +)) indent-tabs-mode:nil fill-column:99 End: */ // vim: filetype=cpp:expandtab:shiftwidth=4:tabstop=8:softtabstop=4 :