include/svx/EnhancedCustomShapeFunctionParser.hxx

   1 /* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
   2 /*
   3  * This file is part of the LibreOffice project.
   4  *
   5  * This Source Code Form is subject to the terms of the Mozilla Public
   6  * License, v. 2.0. If a copy of the MPL was not distributed with this
   7  * file, You can obtain one at http://mozilla.org/MPL/2.0/.
   8  *
   9  * This file incorporates work covered by the following license notice:
  10  *
  11  *   Licensed to the Apache Software Foundation (ASF) under one or more
  12  *   contributor license agreements. See the NOTICE file distributed
  13  *   with this work for additional information regarding copyright
  14  *   ownership. The ASF licenses this file to you under the Apache
  15  *   License, Version 2.0 (the "License"); you may not use this file
  16  *   except in compliance with the License. You may obtain a copy of
  17  *   the License at http://www.apache.org/licenses/LICENSE-2.0 .
  18  */
  19
  20 #ifndef INCLUDED_SVX_ENHANCEDCUSTOMSHAPEFUNCTIONPARSER_HXX
  21 #define INCLUDED_SVX_ENHANCEDCUSTOMSHAPEFUNCTIONPARSER_HXX
  22
  23 #include <sal/config.h>
  24 #include <com/sun/star/drawing/EnhancedCustomShapeParameter.hpp>
  25 #include <memory>
  26 #include <ostream>
  27 #include <vector>
  28
  29 #include <svx/svxdllapi.h>
  30
  31 struct EnhancedCustomShapeEquation
  32 {
  33     sal_Int32   nOperation;
  34     sal_Int32   nPara[ 3 ];
  35
  36     EnhancedCustomShapeEquation() :
  37         nOperation  ( 0 )
  38         {
  39             nPara[ 0 ] = nPara[ 1 ] = nPara[ 2 ] = 0;
  40         }
  41 };
  42
  43 class EnhancedCustomShape2d;
  44
  45 namespace EnhancedCustomShape {
  46
  47 enum class ExpressionFunct
  48 {
  49     Const,
  50
  51     EnumPi,
  52     EnumLeft,
  53     EnumTop,
  54     EnumRight,
  55     EnumBottom,
  56     EnumXStretch,
  57     EnumYStretch,
  58     EnumHasStroke,
  59     EnumHasFill,
  60     EnumWidth,
  61     EnumHeight,
  62     EnumLogWidth,
  63     EnumLogHeight,
  64     EnumAdjustment,
  65     EnumEquation,
  66
  67     UnaryAbs,
  68     UnarySqrt,
  69     UnarySin,
  70     UnaryCos,
  71     UnaryTan,
  72     UnaryAtan,
  73     UnaryNeg,
  74
  75     BinaryPlus,
  76     BinaryMinus,
  77     BinaryMul,
  78     BinaryDiv,
  79     BinaryMin,
  80     BinaryMax,
  81     BinaryAtan2,
  82
  83     TernaryIf
  84 };
  85
  86 template< typename charT, typename traits >
  87 inline std::basic_ostream<charT, traits> & operator <<(
  88     std::basic_ostream<charT, traits> & stream, const ExpressionFunct& eFunc )
  89 {
  90     switch (eFunc)
  91     {
  92     case ExpressionFunct::Const : return stream << "const";
  93
  94     case ExpressionFunct::EnumPi : return stream << "pi";
  95     case ExpressionFunct::EnumLeft : return stream << "left";
  96     case ExpressionFunct::EnumTop : return stream << "top";
  97     case ExpressionFunct::EnumRight : return stream << "right";
  98     case ExpressionFunct::EnumBottom : return stream << "bottom";
  99     case ExpressionFunct::EnumXStretch : return stream << "xstretch";
 100     case ExpressionFunct::EnumYStretch : return stream << "ystretch";
 101     case ExpressionFunct::EnumHasStroke : return stream << "hasstroke";
 102     case ExpressionFunct::EnumHasFill : return stream << "hasfill";
 103     case ExpressionFunct::EnumWidth : return stream << "width";
 104     case ExpressionFunct::EnumHeight : return stream << "height";
 105     case ExpressionFunct::EnumLogWidth : return stream << "logwidth";
 106     case ExpressionFunct::EnumLogHeight : return stream << "logheight";
 107     case ExpressionFunct::EnumAdjustment : return stream << "adjustment";
 108     case ExpressionFunct::EnumEquation : return stream << "equation";
 109
 110     case ExpressionFunct::UnaryAbs : return stream << "abs";
 111     case ExpressionFunct::UnarySqrt : return stream << "sqrt";
 112     case ExpressionFunct::UnarySin : return stream << "sin";
 113     case ExpressionFunct::UnaryCos : return stream << "cos";
 114     case ExpressionFunct::UnaryTan : return stream << "tan";
 115     case ExpressionFunct::UnaryAtan : return stream << "atan";
 116     case ExpressionFunct::UnaryNeg : return stream << "neg";
 117
 118     case ExpressionFunct::BinaryPlus : return stream << "plus";
 119     case ExpressionFunct::BinaryMinus : return stream << "minus";
 120     case ExpressionFunct::BinaryMul : return stream << "mul";
 121     case ExpressionFunct::BinaryDiv : return stream << "div";
 122     case ExpressionFunct::BinaryMin : return stream << "min";
 123     case ExpressionFunct::BinaryMax : return stream << "max";
 124     case ExpressionFunct::BinaryAtan2 : return stream << "atan2";
 125
 126     case ExpressionFunct::TernaryIf : return stream << "if";
 127
 128     default: return stream << "?(" << static_cast<int>(eFunc) << ")";
 129     }
 130 }
 131
 132 #define EXPRESSION_FLAG_SUMANGLE_MODE 1
 133
 134 SVX_DLLPUBLIC void FillEquationParameter( const css::drawing::EnhancedCustomShapeParameter&, const sal_Int32, EnhancedCustomShapeEquation& );
 135
 136 class SAL_DLLPUBLIC_RTTI ExpressionNode
 137 {
 138 public:
 139     virtual ~ExpressionNode();
 140
 141     /** Predicate whether this node is constant.
 142
 143         This predicate returns true, if this node is
 144         neither time- nor ViewInfo dependent. This allows
 145         for certain obtimizations, i.e. not the full
 146         expression tree needs be represented by
 147         ExpressionNodes.
 148
 149         @returns true, if the note is constant
 150     */
 151     virtual bool isConstant() const = 0;
 152
 153     /** Operator to calculate function value.
 154
 155         This method calculates the function value.
 156     */
 157     virtual double operator()() const = 0;
 158
 159     /** Operator to retrieve the type of expression node
 160     */
 161     virtual ExpressionFunct getType() const = 0;
 162
 163     /** Operator to retrieve the ms version of expression
 164     */
 165     virtual css::drawing::EnhancedCustomShapeParameter fillNode(
 166         std::vector< EnhancedCustomShapeEquation >& rEquations, ExpressionNode* pOptionalArg, sal_uInt32 nFlags ) = 0;
 167 };
 168
 169 /** This exception is thrown, when the arithmetic expression
 170     parser failed to parse a string.
 171     */
 172 struct ParseError
 173 {
 174     ParseError( const char* ) {}
 175 };
 176
 177 class FunctionParser
 178 {
 179 public:
 180
 181     /** Parse a string
 182
 183         The following grammar is accepted by this method:
 184         <code>
 185
 186         number_digit = '0'|'1'|'2'|'3'|'4'|'5'|'6'|'7'|'8'|'9'
 187
 188         number = number number_digit | number_digit
 189
 190         identifier = 'pi'|'left'|'top'|'right'|'bottom'|'xstretch'|'ystretch'|
 191                  'hasstroke'|'hasfill'|'width'|'height'|'logwidth'|'logheight'
 192
 193         unary_function = 'abs'|'sqrt'|'sin'|'cos'|'tan'|'atan'
 194         binary_function = 'min'|'max'|'atan2'
 195         ternary_function = 'if'
 196
 197         function_reference = '?' 'a-z,A-Z,0-9' ' '
 198         modifier_reference = '$' '0-9' ' '
 199
 200         basic_expression =
 201             number |
 202             identifier |
 203             function_reference |
 204             unary_function '(' additive_expression ')' |
 205             binary_function '(' additive_expression ',' additive_expression ')' |
 206             ternary_function '(' additive_expression ',' additive_expression ',
 207                                ' additive_expression ')' | '(' additive_expression ')'
 208
 209         unary_expression = '-' basic_expression
 210
 211         multiplicative_expression =
 212                           basic_expression |
 213                           multiplicative_expression '*' basic_expression |
 214                           multiplicative_expression '/' basic_expression
 215
 216         additive_expression =
 217                         multiplicative_expression |
 218                         additive_expression '+' multiplicative_expression |
 219                         additive_expression '-' multiplicative_expression
 220
 221         </code>
 222
 223         @param rFunction
 224         The string to parse
 225
 226         @param rCustoShape
 227         The CustomShape is required for calculation of dynamic values such
 228         "hasstroke", function references and or modifier references ...
 229
 230         @throws ParseError if an invalid expression is given.
 231
 232         @return the generated function object.
 233        */
 234
 235     SVX_DLLPUBLIC static std::shared_ptr<ExpressionNode> const & parseFunction( const OUString& rFunction, const EnhancedCustomShape2d& rCustoShape );
 236
 237     // this is a singleton
 238     FunctionParser() = delete;
 239     FunctionParser(const FunctionParser&) = delete;
 240     FunctionParser& operator=( const FunctionParser& ) = delete;
 241 };
 242
 243 }
 244
 245 #endif // INCLUDED_SVX_ENHANCEDCUSTOMSHAPEFUNCTIONPARSER_HXX
 246
 247 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */