src/mathed/MathData.h

   1 // -*- C++ -*-
   2 /**
   3  * \file MathData.h
   4  * This file is part of LyX, the document processor.
   5  * Licence details can be found in the file COPYING.
   6  *
   7  * \author Alejandro Aguilar Sierra
   8  * \author André Pönitz
   9  * \author Lars Gullik Bjønnes
  10  * \author Stefan Schimanski
  11  *
  12  * Full author contact details are available in file CREDITS.
  13  */
  14
  15 #ifndef MATH_DATA_H
  16 #define MATH_DATA_H
  17
  18 #include "Dimension.h"
  19
  20 #include "MathAtom.h"
  21 #include "MathRow.h"
  22
  23 #include "OutputEnums.h"
  24
  25 #include "support/strfwd.h"
  26
  27 #include <cstddef>
  28 #include <vector>
  29 #include <map>
  30
  31
  32 namespace lyx {
  33
  34 class Buffer;
  35 class BufferView;
  36 class Cursor;
  37 class DocIterator;
  38 class LaTeXFeatures;
  39 class ReplaceData;
  40 class MacroContext;
  41 class InsetMathMacro;
  42 class MetricsInfo;
  43 class PainterInfo;
  44 class ParIterator;
  45 class TextMetricsInfo;
  46 class TextPainter;
  47
  48
  49 class MathData : private std::vector<MathAtom> {
  50 public:
  51         /// re-use inhertited stuff
  52         typedef std::vector<MathAtom> base_type;
  53         using base_type::const_iterator;
  54         using base_type::iterator;
  55         using base_type::size_type;
  56         using base_type::difference_type;
  57         using base_type::size;
  58         using base_type::empty;
  59         using base_type::clear;
  60         using base_type::begin;
  61         using base_type::end;
  62         using base_type::push_back;
  63         using base_type::pop_back;
  64         using base_type::back;
  65         using base_type::front;
  66         ///
  67         typedef size_type idx_type;
  68         typedef size_type pos_type;
  69
  70 public:
  71         ///
  72         MathData(Buffer * buf = 0) : minasc_(0), mindes_(0), slevel_(0),
  73                                      sshift_(0), kerning_(0), buffer_(buf) {}
  74         ///
  75         MathData(Buffer * buf, const_iterator from, const_iterator to);
  76         ///
  77         Buffer * buffer() { return buffer_; }
  78         ///
  79         Buffer const * buffer() const { return buffer_; }
  80         ///
  81         void append(MathData const & ar);
  82
  83         /// inserts single atom at position pos
  84         void insert(size_type pos, MathAtom const & at);
  85         /// inserts multiple atoms at position pos
  86         void insert(size_type pos, MathData const & ar);
  87
  88         /// erase range from pos1 to pos2
  89         void erase(iterator pos1, iterator pos2);
  90         /// erase single atom
  91         void erase(iterator pos);
  92         /// erase range from pos1 to pos2
  93         void erase(size_type pos1, size_type pos2);
  94         /// erase single atom
  95         void erase(size_type pos);
  96
  97         ///
  98         void dump() const;
  99         ///
 100         void dump2() const;
 101         ///
 102         void replace(ReplaceData &);
 103         ///
 104         void substitute(MathData const & m);
 105
 106         /// looks for exact match
 107         bool match(MathData const & ar) const;
 108         /// looks for inclusion match starting at pos
 109         bool matchpart(MathData const & ar, pos_type pos) const;
 110         /// looks for containment, return == size mean not found
 111         size_type find(MathData const & ar) const;
 112         /// looks for containment, return == size mean not found
 113         size_type find_last(MathData const & ar) const;
 114         ///
 115         bool contains(MathData const & ar) const;
 116         ///
 117         void validate(LaTeXFeatures &) const;
 118
 119         /// checked write access
 120         MathAtom & operator[](pos_type);
 121         /// checked read access
 122         MathAtom const & operator[](pos_type) const;
 123
 124         /// Add this array to a math row. Return true if contents got added
 125         bool addToMathRow(MathRow &, MetricsInfo & mi) const;
 126
 127         // return true if caret is in this cell in this buffer view
 128         bool hasCaret(BufferView * bv) const;
 129
 130         /// rebuild cached metrics information
 131         /** When \c tight is true, the height of the cell will be at least
 132          *  that of 'x'. Otherwise, it will be the max height of the font.
 133          */
 134         void metrics(MetricsInfo & mi, Dimension & dim, bool tight = true) const;
 135         ///
 136         Dimension const & dimension(BufferView const &) const;
 137
 138         /// draw the selection over the cell
 139         void drawSelection(PainterInfo & pi, int x, int y) const;
 140         /// redraw cell using cache metrics information
 141         void draw(PainterInfo & pi, int x, int y) const;
 142         /// rebuild cached metrics information
 143         void metricsT(TextMetricsInfo const & mi, Dimension & dim) const;
 144         /// redraw cell using cache metrics information
 145         void drawT(TextPainter & pi, int x, int y) const;
 146         /// approximate the math class of the data
 147         MathClass mathClass() const;
 148
 149         /// access to cached x coordinate of last drawing
 150         int xo(BufferView const & bv) const;
 151         /// access to cached y coordinate of last drawing
 152         int yo(BufferView const & bv) const;
 153         /// access to cached x coordinate of mid point of last drawing
 154         int xm(BufferView const & bv) const;
 155         /// access to cached y coordinate of mid point of last drawing
 156         int ym(BufferView const & bv) const;
 157         /// write access to coordinate;
 158         void setXY(BufferView & bv, int x, int y) const;
 159         /// returns x coordinate of given position in the array
 160         int pos2x(BufferView const * bv, size_type pos) const;
 161         /// returns position of given x coordinate
 162         size_type x2pos(BufferView const * bv, int targetx) const;
 163         /// returns distance of this cell to the point given by x and y
 164         // assumes valid position and size cache
 165         int dist(BufferView const & bv, int x, int y) const;
 166
 167         /// minimum ascent offset for superscript
 168         int minasc() const { return minasc_; }
 169         /// minimum descent offset for subscript
 170         int mindes() const { return mindes_; }
 171         /// level above/below which super/subscript should extend
 172         int slevel() const { return slevel_; }
 173         /// additional super/subscript shift
 174         int sshift() const { return sshift_; }
 175         /// Italic correction as described in InsetMathScript.h
 176         int kerning(BufferView const *) const { return kerning_; }
 177         ///
 178         void swap(MathData & ar) { base_type::swap(ar); }
 179
 180         /// attach/detach arguments to macros, updating the cur to
 181         /// stay visually at the same position (cur==0 is allowed)
 182         void updateMacros(Cursor * cur, MacroContext const & mc, UpdateType, int nesting);
 183         ///
 184         void updateBuffer(ParIterator const &, UpdateType);
 185         ///
 186         void setBuffer(Buffer & b) { buffer_ = &b; }
 187
 188 protected:
 189         /// cached values for super/subscript placement
 190         mutable int minasc_;
 191         mutable int mindes_;
 192         mutable int slevel_;
 193         mutable int sshift_;
 194         mutable int kerning_;
 195         Buffer * buffer_;
 196
 197         /// cached object that describes typeset data
 198         mutable std::map<BufferView*, MathRow> mrow_cache_;
 199
 200 private:
 201         /// is this an exact match at this position?
 202         bool find1(MathData const & ar, size_type pos) const;
 203
 204         ///
 205         void detachMacroParameters(DocIterator * dit, const size_type macroPos);
 206         ///
 207         void attachMacroParameters(Cursor * cur, const size_type macroPos,
 208                 const size_type macroNumArgs, const int macroOptionals,
 209                 const bool fromInitToNormalMode, const bool interactiveInit,
 210                 const size_t appetite);
 211         ///
 212         void collectOptionalParameters(Cursor * cur,
 213                 const size_type numOptionalParams, std::vector<MathData> & params,
 214                 size_t & pos, MathAtom & scriptToPutAround,
 215                 const pos_type macroPos, const int thisPos, const int thisSlice);
 216         ///
 217         void collectParameters(Cursor * cur,
 218                 const size_type numParams, std::vector<MathData> & params,
 219                 size_t & pos, MathAtom & scriptToPutAround,
 220                 const pos_type macroPos, const int thisPos, const int thisSlice,
 221                 const size_t appetite);
 222 };
 223
 224 ///
 225 std::ostream & operator<<(std::ostream & os, MathData const & ar);
 226 ///
 227 odocstream & operator<<(odocstream & os, MathData const & ar);
 228
 229
 230 } // namespace lyx
 231
 232 #endif