mirror of
https://github.com/jkriege2/JKQtPlotter.git
synced 2024-12-24 17:41:39 +08:00
279 lines
15 KiB
C++
279 lines
15 KiB
C++
/*
|
|
Copyright (c) 2008-2022 Jan W. Krieger (<jan@jkrieger.de>)
|
|
with contributions from: Razi Alavizadeh
|
|
|
|
|
|
|
|
This software is free software: you can redistribute it and/or modify
|
|
it under the terms of the GNU Lesser General Public License (LGPL) as published by
|
|
the Free Software Foundation, either version 2.1 of the License, or
|
|
(at your option) any later version.
|
|
|
|
This program is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
GNU Lesser General Public License (LGPL) for more details.
|
|
|
|
You should have received a copy of the GNU Lesser General Public License (LGPL)
|
|
along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
|
|
|
|
|
|
#ifndef JKQTMATHTEXTINSTRUCTIONNODE_H
|
|
#define JKQTMATHTEXTINSTRUCTIONNODE_H
|
|
#include "jkqtmathtext/jkqtmathtext_imexport.h"
|
|
#include "jkqtmathtext/jkqtmathtexttools.h"
|
|
#include "jkqtmathtext/nodes/jkqtmathtextnode.h"
|
|
#include <QPainter>
|
|
#include <functional>
|
|
|
|
class JKQTMathText; // forward
|
|
// JKQTMATHTEXT_LIB_EXPORT
|
|
|
|
/** \brief subclass representing an instruction node with exactly one argument and possibly additional parameters in the syntax tree
|
|
* This is a base-class without concrete implementations ... Implementations can be found in derived classes!
|
|
* \ingroup jkqtmathtext_items
|
|
*
|
|
* The parameters are sinple strings (e.g. directly for instructions like \c \\textcolor{color}{coloredLatexText},
|
|
* but they might also be translated into numbers or other properties.
|
|
*
|
|
* Typically derived nodes will provide static methods to determine the number of instructions
|
|
* and whether an instruction name is supported.
|
|
*/
|
|
class JKQTMATHTEXT_LIB_EXPORT JKQTMathTextInstruction1Node: public JKQTMathTextSingleChildNode {
|
|
public:
|
|
explicit JKQTMathTextInstruction1Node(JKQTMathText* parent, const QString& name, JKQTMathTextNode* child, const QStringList& parameters=QStringList());
|
|
virtual ~JKQTMathTextInstruction1Node() override;
|
|
/** \copydoc instructionName */
|
|
const QString& getInstructionName() const;
|
|
/** \copydoc parameters */
|
|
const QStringList& getParameters() const;
|
|
protected:
|
|
/** \brief instruction name */
|
|
QString instructionName;
|
|
/** \brief additional string-parameters */
|
|
QStringList parameters;
|
|
};
|
|
|
|
|
|
|
|
/** \brief subclass representing a simple instruction node which only accepts string arguments, not LaTeX arguments
|
|
* i.e. it represents instructions like \c \\unicode{...}, ...
|
|
* \ingroup jkqtmathtext_items
|
|
*/
|
|
class JKQTMATHTEXT_LIB_EXPORT JKQTMathTextSimpleInstructionNode: public JKQTMathTextNode {
|
|
public:
|
|
explicit JKQTMathTextSimpleInstructionNode(JKQTMathText* parent, const QString& name, const QStringList& parameters=QStringList());
|
|
virtual ~JKQTMathTextSimpleInstructionNode() override;
|
|
/** \copydoc JKQTMathTextNode::getTypeName() */
|
|
virtual QString getTypeName() const override;
|
|
/** \copydoc JKQTMathTextNode::draw() */
|
|
virtual double draw(QPainter& painter, double x, double y, JKQTMathTextEnvironment currentEv, const JKQTMathTextNodeSize* prevNodeSize=nullptr) override;
|
|
/** \copydoc JKQTMathTextNode::toHtml() */
|
|
virtual bool toHtml(QString& html, JKQTMathTextEnvironment currentEv, JKQTMathTextEnvironment defaultEv) override;
|
|
/** \copydoc instructionName */
|
|
const QString& getInstructionName() const;
|
|
/** \copydoc parameters */
|
|
const QStringList& getParameters() const;
|
|
|
|
/** \brief returns true, if the given \a instructionName can be represented by this node
|
|
* \see instructions
|
|
*/
|
|
static bool supportsInstructionName(const QString& instructionName);
|
|
/** \brief returns the number of additional string parameters, required for the given \a instructionName
|
|
* \see instructions
|
|
*/
|
|
static size_t countParametersOfInstruction(const QString& instructionName);
|
|
|
|
protected:
|
|
/** \copydoc JKQTMathTextNode::getSizeInternal() */
|
|
virtual void getSizeInternal(QPainter& painter, JKQTMathTextEnvironment currentEv, double& width, double& baselineHeight, double& overallHeight, double& strikeoutPos, const JKQTMathTextNodeSize* prevNodeSize=nullptr) override;
|
|
/** \brief defines the implementation of an instruction represented by JKQTMathTextModifiedTextPropsInstructionNode */
|
|
struct InstructionProperties {
|
|
/** \brief this functor implements the instruction */
|
|
typedef std::function<QString(const QStringList& parameters)> EvaluateInstructionFunctor;
|
|
/** \brief default constructor, creates a NOP-instruction that does nothing */
|
|
InstructionProperties();
|
|
/** \brief constructor which gets a functor \a _modifier and a number of required parameters \a _NParams */
|
|
InstructionProperties(const EvaluateInstructionFunctor& _evaluator, size_t _NParams=0);
|
|
/** \brief number of parameters for this node */
|
|
size_t NParams;
|
|
/** \brief output of the instruction */
|
|
EvaluateInstructionFunctor evaluator;
|
|
};
|
|
|
|
/** \brief fills instructions
|
|
*
|
|
* \note this is the customization point for new instructions!
|
|
*/
|
|
static void fillInstructions();
|
|
/** \brief defines all implemented instructions in this node */
|
|
static QHash<QString, InstructionProperties> instructions;
|
|
/** \brief executes the instruction on \a ev */
|
|
QString executeInstruction() const;
|
|
/** \brief instruction name */
|
|
QString instructionName;
|
|
/** \brief additional string-parameters */
|
|
QStringList parameters;
|
|
};
|
|
|
|
|
|
/** \brief subclass representing an instruction node which modifies the current font (as defined in JKQTMathTextEnvironment),
|
|
* i.e. it represents instructions like \c \\textbf{...}, \c \\ul{underlinedText}, ...
|
|
* \ingroup jkqtmathtext_items
|
|
*/
|
|
class JKQTMATHTEXT_LIB_EXPORT JKQTMathTextModifiedTextPropsInstructionNode: public JKQTMathTextInstruction1Node {
|
|
public:
|
|
explicit JKQTMathTextModifiedTextPropsInstructionNode(JKQTMathText* parent, const QString& name, JKQTMathTextNode* child, const QStringList& parameters=QStringList());
|
|
virtual ~JKQTMathTextModifiedTextPropsInstructionNode() override;
|
|
/** \copydoc JKQTMathTextNode::getTypeName() */
|
|
virtual QString getTypeName() const override;
|
|
/** \copydoc JKQTMathTextNode::draw() */
|
|
virtual double draw(QPainter& painter, double x, double y, JKQTMathTextEnvironment currentEv, const JKQTMathTextNodeSize* prevNodeSize=nullptr) override;
|
|
/** \copydoc JKQTMathTextNode::toHtml() */
|
|
virtual bool toHtml(QString& html, JKQTMathTextEnvironment currentEv, JKQTMathTextEnvironment defaultEv) override;
|
|
|
|
/** \brief returns true, if the given \a instructionName can be represented by this node
|
|
* \see instructions
|
|
*/
|
|
static bool supportsInstructionName(const QString& instructionName);
|
|
/** \brief returns the number of additional string parameters, required for the given \a instructionName
|
|
* \see instructions
|
|
*/
|
|
static size_t countParametersOfInstruction(const QString& instructionName);
|
|
/** \brief sets \a insideMath to \c true if inside the node is to be parsed in math mode and \c false else
|
|
* \see instructions
|
|
*/
|
|
static void modifyInMathEnvironment(const QString& instructionName, bool& insideMath, const QStringList ¶ms=QStringList());
|
|
|
|
protected:
|
|
/** \copydoc JKQTMathTextNode::getSizeInternal() */
|
|
virtual void getSizeInternal(QPainter& painter, JKQTMathTextEnvironment currentEv, double& width, double& baselineHeight, double& overallHeight, double& strikeoutPos, const JKQTMathTextNodeSize* prevNodeSize=nullptr) override;
|
|
/** \brief defines the implementation of an instruction represented by JKQTMathTextModifiedTextPropsInstructionNode */
|
|
struct InstructionProperties {
|
|
/** \brief this functor implements the instruction */
|
|
typedef std::function<void(JKQTMathTextEnvironment& ev, const QStringList& parameters)> ModifyEnvironmentFunctor;
|
|
/** \brief default constructor, creates a NOP-instruction that does nothing */
|
|
InstructionProperties();
|
|
/** \brief constructor which gets a functor \a _modifier and a number of required parameters \a _NParams */
|
|
InstructionProperties(const ModifyEnvironmentFunctor& _modifier, size_t _NParams=0);
|
|
/** \brief number of parameters for this node */
|
|
size_t NParams;
|
|
/** \brief functor that modifies a JKQTMathTextEnvironment */
|
|
ModifyEnvironmentFunctor modifier;
|
|
};
|
|
|
|
/** \brief fills instructions
|
|
*
|
|
* \note this is the customization point for new instructions!
|
|
*/
|
|
static void fillInstructions();
|
|
/** \brief defines all implemented instructions in this node */
|
|
static QHash<QString, InstructionProperties> instructions;
|
|
/** \brief executes the instruction on \a ev */
|
|
void executeInstruction(JKQTMathTextEnvironment& ev) const;
|
|
};
|
|
|
|
|
|
/** \brief subclass representing an instruction node which draws a (possibly colored) box around it's contents
|
|
* i.e. it represents instructions like \c \\fbox{...}, \c \\colorbox{color}{...}, ...
|
|
* \ingroup jkqtmathtext_items
|
|
*/
|
|
class JKQTMATHTEXT_LIB_EXPORT JKQTMathTextBoxInstructionNode: public JKQTMathTextInstruction1Node {
|
|
public:
|
|
explicit JKQTMathTextBoxInstructionNode(JKQTMathText* parent, const QString& name, JKQTMathTextNode* child, const QStringList& parameters=QStringList());
|
|
virtual ~JKQTMathTextBoxInstructionNode() override;
|
|
/** \copydoc JKQTMathTextNode::getTypeName() */
|
|
virtual QString getTypeName() const override;
|
|
/** \copydoc JKQTMathTextNode::draw() */
|
|
virtual double draw(QPainter& painter, double x, double y, JKQTMathTextEnvironment currentEv, const JKQTMathTextNodeSize* prevNodeSize=nullptr) override;
|
|
/** \copydoc JKQTMathTextNode::toHtml() */
|
|
virtual bool toHtml(QString& html, JKQTMathTextEnvironment currentEv, JKQTMathTextEnvironment defaultEv) override;
|
|
|
|
/** \brief returns true, if the given \a instructionName can be represented by this node
|
|
* \see instructions
|
|
*/
|
|
static bool supportsInstructionName(const QString& instructionName);
|
|
/** \brief returns true, if the given \a instructionName can be represented by this node
|
|
* \see instructions
|
|
*/
|
|
static void modifyInMathEnvironment(const QString& instructionName, bool& insideMath);
|
|
/** \brief returns the number of additional string parameters, required for the given \a instructionName
|
|
* \see instructions
|
|
*/
|
|
static size_t countParametersOfInstruction(const QString& instructionName);
|
|
/** \brief sets \a insideMath to \c true if inside the node is to be parsed in math mode and \c false else
|
|
* \see instructions
|
|
*/
|
|
static void modifyInMathEnvironment(const QString& instructionName, bool& insideMath, const QStringList ¶ms=QStringList());
|
|
protected:
|
|
/** \copydoc JKQTMathTextNode::getSizeInternal() */
|
|
virtual void getSizeInternal(QPainter& painter, JKQTMathTextEnvironment currentEv, double& width, double& baselineHeight, double& overallHeight, double& strikeoutPos, const JKQTMathTextNodeSize* prevNodeSize=nullptr) override;
|
|
/** \brief set all properties in \a ev, as appropriate for the represented instruction */
|
|
bool setupMTenvironment(JKQTMathTextEnvironment &ev) const;
|
|
|
|
/** \brief defines the implementation of an instruction represented by JKQTMathTextModifiedTextPropsInstructionNode */
|
|
struct InstructionProperties {
|
|
/** \brief this functor implements the instruction */
|
|
typedef std::function<void(JKQTMathTextEnvironment& ev, const QStringList& parameters)> ModifyEnvironmentFunctor;
|
|
static ModifyEnvironmentFunctor NoModification;
|
|
/** \brief this functor returns the QPen to use for the box outline */
|
|
typedef std::function<QPen(JKQTMathTextEnvironment& ev, const QStringList& parameters, JKQTMathText* parent)> GetBoxPenFunctor;
|
|
/** \brief generates a QPen with the lineWidth associated with the QFont of the environment (using QFontMetricsF::lineWidth() ) */
|
|
static GetBoxPenFunctor DefaultPen;
|
|
/** \brief generates an invisible pen with 0 width */
|
|
static GetBoxPenFunctor NoPen;
|
|
/** \brief this functor returns the QBrush to use for the box fill */
|
|
typedef std::function<QBrush(JKQTMathTextEnvironment& ev, const QStringList& parameters, JKQTMathText* parent)> GetBoxBrushFunctor;
|
|
/** \brief generates an invisible QBrush */
|
|
static GetBoxBrushFunctor NoBrush;
|
|
/** \brief default padding factor 0.5 xWidth */
|
|
static double DefaultPadding;
|
|
/** \brief default constructor, creates a NOP-instruction that does nothing */
|
|
InstructionProperties();
|
|
/** \brief constructor */
|
|
InstructionProperties(const ModifyEnvironmentFunctor& _modifier, const GetBoxPenFunctor& _pen, const GetBoxBrushFunctor& _brush, double _paddingFactor=DefaultPadding, size_t _NParams=0);
|
|
/** \brief constructor */
|
|
InstructionProperties(const GetBoxPenFunctor& _pen, const GetBoxBrushFunctor& _brush, double _paddingFactor=DefaultPadding, size_t _NParams=0);
|
|
/** \brief number of parameters for this node */
|
|
size_t NParams;
|
|
/** \brief functor that modifies a JKQTMathTextEnvironment */
|
|
ModifyEnvironmentFunctor modifier;
|
|
/** \brief functor that creates a QPen for the box outline */
|
|
GetBoxPenFunctor pen;
|
|
/** \brief functor that creates a QBrush for the box fill */
|
|
GetBoxBrushFunctor brush;
|
|
/** \brief padding of the box, as a factor to xWidth of the current font */
|
|
double paddingFactor;
|
|
/** \brief draw a double-line */
|
|
bool doubleLine;
|
|
/** \brief rounding radius (rx=ry) of the box, as a factor to xWidth of the current font */
|
|
double roundingFactor;
|
|
};
|
|
|
|
/** \brief fills instructions
|
|
*
|
|
* \note this is the customization point for new instructions!
|
|
*/
|
|
static void fillInstructions();
|
|
/** \brief defines all implemented instructions in this node */
|
|
static QHash<QString, InstructionProperties> instructions;
|
|
};
|
|
|
|
|
|
|
|
|
|
|
|
#endif // JKQTMATHTEXTINSTRUCTIONNODE_H
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|