ctextrendering.h

Go to the documentation of this file.

/*********
*
* In the name of the Father, and of the Son, and of the Holy Spirit.
*
* This file is part of BibleTime's source code, https://bibletime.info/
*
* Copyright 1999-2025 by the BibleTime developers.
* The BibleTime source code is licensed under the GNU General Public License
* version 2.0.
*
**********/
 
#pragma once
 
#include <list>
#include <QString>
#include "../btglobal.h"
#include "../drivers/btmodulelist.h"
 
 
class CSwordKey;
class CSwordVerseKey;
 
namespace Rendering {
 
/**
 * CTextRendering is BibleTime's place where the actual rendering takes place.
 * It provides several methods to convert an abstract tree of items
 * into a string of html.
 *
 * @short Text rendering based on trees
 * @author The BibleTime team
*/
class CTextRendering {
 
    public: // types:
 
        class KeyTreeItem;
 
        using KeyTree = std::list<KeyTreeItem>;
 
        class KeyTreeItem {
 
            public: // types:
 
                struct Settings {
 
                    enum KeyRenderingFace {
                        NoKey,         ///< means no key shown at all
                        SimpleKey,     ///< means only versenumber or only lexicon entry name
                        CompleteShort, ///< means key like "Gen 1:1"
                        CompleteLong,  ///< means "Genesis 1:1"
                        ExpandedShort, /// means "KJV:Gen 1:1"
                        ExpandedLong   /// means "Genesis 1:1 (KJV)"
                    };
                    enum KeyRenderingFace {…};
 
                    bool highlight;
                    KeyRenderingFace keyRenderingFace;
 
                }; /* struct Settings */
                struct Settings {…};
 
            public: // methods:
 
                KeyTreeItem(KeyTreeItem &&) = delete;
                KeyTreeItem(KeyTreeItem const &&) = delete;
 
                KeyTreeItem(const QString &key,
                            const CSwordModuleInfo *module,
                            const Settings &settings);
 
                KeyTreeItem(const QString &key,
                            const BtConstModuleList &modules,
                            const Settings &settings);
 
                KeyTreeItem(const QString &startKey,
                            const QString &stopKey,
                            const CSwordModuleInfo *module,
                            const Settings &settings);
 
                KeyTreeItem(const QString &content, const Settings &settings);
 
                KeyTreeItem & operator=(KeyTreeItem &&) = delete;
                KeyTreeItem & operator=(KeyTreeItem const &&) = delete;
 
                QString const & getAlternativeContent() const
                { return m_alternativeContent; }
                QString const & getAlternativeContent() const {…}
 
                bool hasAlternativeContent() const
                { return !m_alternativeContent.isNull(); }
                bool hasAlternativeContent() const {…}
 
                BtConstModuleList const & modules() const
                { return m_moduleList; }
                BtConstModuleList const & modules() const {…}
 
                QString const & key() const { return m_key; }
 
                Settings const & settings() const { return m_settings; }
 
                KeyTree & childList() const noexcept { return m_childList; }
 
                void setMappedKey(CSwordKey const * key) const
                { m_mappedKey = key; }
                void setMappedKey(CSwordKey const * key) const {…}
 
                CSwordKey const * mappedKey() const { return m_mappedKey; }
 
            private: // fields:
 
                Settings m_settings;
                BtConstModuleList m_moduleList;
                QString m_key;
                mutable CSwordKey const * m_mappedKey = nullptr;
                mutable KeyTree m_childList;
 
                QString m_alternativeContent;
 
        }; /* class KeyTreeItem */
        class KeyTreeItem {…};
 
    public: // methods:
 
        CTextRendering(bool addText);
        CTextRendering(bool addText,
                       DisplayOptions const & displayOptions,
                       FilterOptions const & filterOptions);
 
        virtual ~CTextRendering();
 
        FilterOptions const & filterOptions() const noexcept
        { return m_filterOptions; }
        FilterOptions const & filterOptions() const noexcept {…}
 
        void setFilterOptions(FilterOptions const & filterOptions) noexcept {
            static_assert(noexcept(m_filterOptions = filterOptions));
            m_filterOptions = filterOptions;
        }
        void setFilterOptions(FilterOptions const & filterOptions) noexcept {…}
 
        DisplayOptions const & displayOptions() const noexcept
        { return m_displayOptions; }
        DisplayOptions const & displayOptions() const noexcept {…}
 
        void setDisplayOptions(DisplayOptions const & displayOptions) noexcept {
            static_assert(noexcept(m_displayOptions = displayOptions));
            m_displayOptions = displayOptions;
        }
        void setDisplayOptions(DisplayOptions const & displayOptions) noexcept {…}
 
        QString renderKeyTree(KeyTree const & tree) const;
 
        QString renderKeyRange(
                CSwordVerseKey const & lowerBound,
                CSwordVerseKey const & upperBound,
                const BtConstModuleList &modules,
                const QString &hightlightKey = QString(),
                const KeyTreeItem::Settings &settings = KeyTreeItem::Settings());
 
        QString renderSingleKey(
                const QString &key,
                const BtConstModuleList &modules,
                const KeyTreeItem::Settings &settings = KeyTreeItem::Settings());
 
    protected: // methods:
 
        static BtConstModuleList collectModules(KeyTree const & tree);
        virtual QString renderEntry(KeyTreeItem const & item,
                                    CSwordKey * key = nullptr) const;
        virtual QString finishText(QString const & text,
                                   KeyTree const & tree) const;
        virtual QString entryLink(KeyTreeItem const & item,
                                  CSwordModuleInfo const & module) const;
 
    protected: // fields:
 
        DisplayOptions m_displayOptions;
        FilterOptions m_filterOptions;
        bool const m_addText;
 
}; /* class CTextRendering */
class CTextRendering {…};
 
} /* namespace Rendering */