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 "Font.h"
  18 #include "InsetList.h"
  19 #include "ParagraphMetrics.h"
  20
  21 #include "support/types.h"
  22
  23 namespace lyx {
  24
  25 class BufferView;
  26 class Cursor;
  27 class CursorSlice;
  28 class DocIterator;
  29 class MetricsInfo;
  30 class Text;
  31
  32 /// A map from a Text to the map of paragraphs metrics
  33 class TextMetrics
  34 {
  35 public:
  36         /// Default constructor (only here for STL containers).
  37         TextMetrics() : text_(0) {}
  38         /// The only useful constructor.
  39         TextMetrics(BufferView *, Text *);
  40
  41         ///
  42         bool contains(pit_type pit) const;
  43         ///
  44         ParagraphMetrics const & parMetrics(pit_type) const;
  45         ///
  46         std::pair<pit_type, ParagraphMetrics const *> first() const;
  47         ///
  48         std::pair<pit_type, ParagraphMetrics const *> last() const;
  49
  50         ///
  51         Dimension const & dimension() const { return dim_; }
  52         ///
  53         Point const & origin() const { return origin_; }
  54
  55
  56         /// compute text metrics.
  57         bool metrics(MetricsInfo & mi, Dimension & dim, int min_width = 0);
  58
  59         ///
  60         void newParMetricsDown();
  61         ///
  62         void newParMetricsUp();
  63
  64         /// Gets the fully instantiated font at a given position in a paragraph
  65         /// Basically the same routine as Paragraph::getFont() in Paragraph.cpp.
  66         /// The difference is that this one is used for displaying, and thus we
  67         /// are allowed to make cosmetic improvements. For instance make footnotes
  68         /// smaller. (Asger)
  69         Font displayFont(pit_type pit, pos_type pos) const;
  70
  71         /// There are currently two font mechanisms in LyX:
  72         /// 1. The font attributes in a lyxtext, and
  73         /// 2. The inset-specific font properties, defined in an inset's
  74         /// metrics() and draw() methods and handed down the inset chain through
  75         /// the pi/mi parameters, and stored locally in a lyxtext in font_.
  76         /// This is where the two are integrated in the final fully realized
  77         /// font.
  78         void applyOuterFont(Font &) const;
  79
  80         /// is this position in the paragraph right-to-left?
  81         bool isRTL(CursorSlice const & sl, bool boundary) const;
  82         /// is between pos-1 and pos an RTL<->LTR boundary?
  83         bool isRTLBoundary(pit_type pit,
  84           pos_type pos) const;
  85         /// would be a RTL<->LTR boundary between pos and the given font?
  86         bool isRTLBoundary(pit_type pit,
  87           pos_type pos, Font const & font) const;
  88
  89
  90         /// Rebreaks the given paragraph.
  91         /// \retval true if a full screen redraw is needed.
  92         /// \retval false if a single paragraph redraw is enough.
  93         bool redoParagraph(pit_type const pit);
  94         /// Clear cache of paragraph metrics
  95         void clear() { par_metrics_.clear(); }
  96
  97         ///
  98         int ascent() const { return dim_.asc; }
  99         ///
 100         int descent() const { return dim_.des; }
 101         /// current text width.
 102         int width() const { return dim_.wid; }
 103         /// current text height.
 104         int height() const { return dim_.height(); }
 105
 106         ///
 107         int maxWidth() const { return max_width_; }
 108         ///
 109         int singleWidth(pit_type const pit,     pos_type pos) const;
 110
 111         ///
 112         int rightMargin(ParagraphMetrics const & pm) const;
 113         int rightMargin(pit_type const pit) const;
 114
 115         ///
 116         void draw(PainterInfo & pi, int x, int y) const;
 117
 118         void drawParagraph(PainterInfo & pi, pit_type pit, int x, int y) const;
 119
 120         /// Returns the height of the row (width member is set to 0).
 121         /// If \c topBottomSpace is true, extra space is added for the
 122         /// top and bottom row.
 123         void setRowHeight(Row & row, pit_type const pit,
 124                           bool topBottomSpace = true) const;
 125
 126 private:
 127         ///
 128         ParagraphMetrics & parMetrics(pit_type, bool redo_paragraph);
 129
 130         /// the minimum space a manual label needs on the screen in pixels
 131         int labelFill(pit_type const pit, Row const & row) const;
 132
 133         /// FIXME??
 134         int labelEnd(pit_type const pit) const;
 135
 136         /// sets row.end to the pos value *after* which a row should break.
 137         /// for example, the pos after which isNewLine(pos) == true
 138         void breakRow(Row & row, int right_margin, pit_type const pit) const;
 139
 140         // Expand the alignment of paragraph \param par at position \param pos
 141         int getAlign(Paragraph const & par, pos_type pos) const;
 142         /** this calculates the specified parameters. needed when setting
 143          * the cursor and when creating a visible row */
 144         void computeRowMetrics(pit_type pit, Row & row, int width) const;
 145
 146         // Helper function for the other checkInsetHit method.
 147         InsetList::InsetTable * checkInsetHit(pit_type pit, int x, int y);
 148
 149
 150 // Temporary public:
 151 public:
 152         /// returns the position near the specified x-coordinate of the row.
 153         /// x is an absolute screen coord, it is set to the real beginning
 154         /// of this column.
 155         pos_type getPosNearX(pit_type pit, Row const & row, int & x,
 156                 bool & boundary) const;
 157
 158         /// returns pos in given par at given x coord.
 159         pos_type x2pos(pit_type pit, int row, int x) const;
 160
 161         // FIXME: is there a need for this?
 162         //int pos2x(pit_type pit, pos_type pos) const;
 163
 164         /// returns the row near the specified y-coordinate in a given paragraph
 165         /// (relative to the screen). If assert_in_view is true, it is made sure
 166         /// that the row is on screen completely; this might change the given pit.
 167         Row const & getPitAndRowNearY(int & y, pit_type & pit,
 168                 bool assert_in_view, bool up);
 169
 170         /// returns the paragraph number closest to screen y-coordinate.
 171         /// This method uses the BufferView CoordCache to locate the
 172         /// paragraph. The y-coodinate is allowed to be off-screen and
 173         /// the CoordCache will be automatically updated if needed. This is
 174         /// the reason why we need a non const BufferView.
 175         pit_type getPitNearY(int y);
 176
 177         /// sets cursor recursively descending into nested editable insets
 178         /**
 179         \return the inset pointer if x,y is covering that inset
 180         \param x,y are absolute screen coordinates.
 181         \param assert_in_view if true the cursor will be set on a row
 182            that is completely visible
 183     \param up whether we are going up or down (only used when
 184            assert_in_view is true
 185         \retval inset is non-null if the cursor is positionned inside
 186         */
 187         /// FIXME: cleanup to use BufferView::getCoveringInset() and
 188         /// setCursorFromCoordinates() instead of checkInsetHit().
 189         Inset * editXY(Cursor & cur, int x, int y,
 190                 bool assert_in_view = false, bool up = true);
 191
 192         /// sets cursor only within this Text.
 193         /// x,y are screen coordinates
 194         void setCursorFromCoordinates(Cursor & cur, int x, int y);
 195
 196         ///
 197         int cursorX(CursorSlice const & cursor,
 198                 bool boundary) const;
 199         ///
 200         int cursorY(CursorSlice const & cursor,
 201                 bool boundary) const;
 202
 203         ///
 204         bool cursorHome(Cursor & cur);
 205         ///
 206         bool cursorEnd(Cursor & cur);
 207         ///
 208         void deleteLineForward(Cursor & cur);
 209
 210         /// is this row the last in the text?
 211         bool isLastRow(pit_type pit, Row const & row) const;
 212         /// is this row the first in the text?
 213         bool isFirstRow(pit_type pit, Row const & row) const;
 214
 215         /// Returns an inset if inset was hit, or 0 if not.
 216         /// \warning This method is not recursive! It will return the
 217         /// outermost inset within this Text.
 218         /// \sa BufferView::getCoveringInset() to get the innermost inset.
 219         Inset * checkInsetHit(int x, int y);
 220
 221         /**
 222          * Returns the left beginning of the text.
 223          * This information cannot be taken from the layout object, because
 224          * in LaTeX the beginning of the text fits in some cases
 225          * (for example sections) exactly the label-width.
 226          */
 227         int leftMargin(int max_width, pit_type pit, pos_type pos) const;
 228         int leftMargin(int max_width, pit_type pit) const;
 229
 230         /// calculates the position of a completion popup
 231         void completionPosAndDim(Cursor const & cur, int & x, int & y,
 232                 Dimension & dim) const;
 233
 234 private:
 235         friend class BufferView;
 236
 237         /// The BufferView owner.
 238         BufferView * bv_;
 239
 240         /// The text contents (the model).
 241         /// \todo FIXME: this should be const.
 242         Text * text_;
 243
 244         bool main_text_;
 245         /// A map from paragraph index number to paragraph metrics
 246         typedef std::map<pit_type, ParagraphMetrics> ParMetricsCache;
 247         ///
 248         mutable ParMetricsCache par_metrics_;
 249         Dimension dim_;
 250         int max_width_;
 251         mutable Point origin_;
 252
 253 // temporary public:
 254 public:
 255         /// our 'outermost' font.
 256         /// This is handed down from the surrounding
 257         /// inset through the pi/mi parameter (pi.base.font)
 258         /// It is used in applyOuterFont() and setCharFont() for reasons
 259         /// that are not clear... to hand hand the outermost language and
 260         /// also for char style apparently.
 261         Font font_;
 262 };
 263
 264 /// return the default height of a row in pixels, considering font zoom
 265 int defaultRowHeight();
 266
 267 } // namespace lyx
 268
 269 #endif // TEXT_METRICS_H