src/TextMetrics.h

   1 // -*- C++ -*-
   2 /**
   3  * \file TextMetrics.h
   4  * This file is part of LyX, the document processor.
   5  * Licence details can be found in the file COPYING.
   6  *
   7  * \author Lars Gullik Bjønnes
   8  * \author John Levon
   9  * \author Abdelrazak Younes
  10  *
  11  * Full author contact details are available in file CREDITS.
  12  */
  13
  14 #ifndef TEXT_METRICS_H
  15 #define TEXT_METRICS_H
  16
  17 #include "ParagraphMetrics.h"
  18
  19 #include "support/types.h"
  20
  21 #include <map>
  22
  23
  24 namespace lyx {
  25
  26 class BufferView;
  27 class Text;
  28 class MetricsInfo;
  29
  30 /// A map from a Text to the map of paragraphs metrics
  31 class TextMetrics
  32 {
  33 public:
  34         /// Default constructor (only here for STL containers).
  35         TextMetrics(): text_(0) {}
  36         /// The only useful constructor.
  37         TextMetrics(BufferView *, Text *);
  38         ///
  39         ParagraphMetrics const & parMetrics(pit_type) const;
  40         ///
  41         Dimension const & dimension() const;
  42         Dimension const & dimension();
  43
  44         /// compute text metrics.
  45         bool metrics(MetricsInfo & mi, Dimension & dim);
  46
  47         /// Rebreaks the given paragraph.
  48         /// \retval true if a full screen redraw is needed.
  49         /// \retval false if a single paragraph redraw is enough.
  50         bool redoParagraph(pit_type const pit);
  51         /// Clear cache of paragraph metrics
  52         void clear() { par_metrics_.clear(); }
  53
  54         ///
  55         int ascent() const { return dim_.asc; }
  56         ///
  57         int descent() const { return dim_.des; }
  58         /// current text width.
  59         int width() const { return dim_.wid; }
  60         /// current text heigth.
  61         int height() const { return dim_.height(); }
  62
  63         ///
  64         int maxWidth() const { return max_width_; }
  65         ///
  66         int singleWidth(pit_type const pit,     pos_type pos) const;
  67
  68         ///
  69         int rightMargin(ParagraphMetrics const & pm) const;
  70         int rightMargin(pit_type const pit) const;
  71
  72         /** this calculates the specified parameters. needed when setting
  73          * the cursor and when creating a visible row */
  74         void computeRowMetrics(pit_type pit, Row & row) const;
  75
  76         ///
  77         void draw(PainterInfo & pi, int x, int y) const;
  78
  79         void drawParagraph(PainterInfo & pi, pit_type pit, int x, int y,
  80                 bool repaintAll) const;
  81
  82 private:
  83         ///
  84         ParagraphMetrics & parMetrics(pit_type, bool redo_paragraph);
  85
  86         /// the minimum space a manual label needs on the screen in pixels
  87         int labelFill(pit_type const pit, Row const & row) const;
  88
  89         /// FIXME??
  90         int labelEnd(pit_type const pit) const;
  91
  92         /// sets row.end to the pos value *after* which a row should break.
  93         /// for example, the pos after which isNewLine(pos) == true
  94         void rowBreakPoint(int width, pit_type const pit, Row & row) const;
  95
  96         /// sets row.width to the minimum space a row needs on the screen in pixel
  97         void setRowWidth(int right_margin, pit_type const pit, Row & row) const;
  98
  99         /// Calculate and set the height of the row
 100         void setHeightOfRow(pit_type, Row & row);
 101
 102 // Temporary public:
 103 public:
 104         /// returns the column near the specified x-coordinate of the row.
 105         /// x is an absolute screen coord, it is set to the real beginning
 106         /// of this column.
 107         pos_type getColumnNearX(pit_type pit, Row const & row, int & x,
 108                 bool & boundary) const;
 109
 110         /// returns pos in given par at given x coord.
 111         pos_type x2pos(pit_type pit, int row, int x) const;
 112
 113         // FIXME: is there a need for this?
 114         //int pos2x(pit_type pit, pos_type pos) const;
 115
 116 private:
 117
 118         /// The BufferView owner.
 119         BufferView * bv_;
 120
 121         /// The text contents (the model).
 122         /// \todo FIXME: this should be const.
 123         Text * text_;
 124
 125         bool main_text_;
 126         /// A map from paragraph index number to paragraph metrics
 127         typedef std::map<pit_type, ParagraphMetrics> ParMetricsCache;
 128         ///
 129         mutable ParMetricsCache par_metrics_;
 130         Dimension dim_;
 131         int max_width_;
 132
 133         /// FIXME: transfer this code in CoordCache here.
 134         /*
 135         /// A map from paragraph index number to screen point
 136         typedef std::map<pit_type, Point> InnerParPosCache;
 137         /// A map from a Text to the map of paragraphs to screen points
 138         typedef std::map<Text const *, InnerParPosCache> ParPosCache;
 139         /// Paragraph grouped by owning text
 140         ParPosCache pars_;
 141         */
 142 };
 143
 144 /// return the default height of a row in pixels, considering font zoom
 145 int defaultRowHeight();
 146
 147 } // namespace lyx
 148
 149 #endif // TEXT_METRICS_H