4 * This file is part of LyX, the document processor.
5 * Licence details can be found in the file COPYING.
7 * \author Lars Gullik Bjønnes
9 * \author Abdelrazak Younes
11 * Full author contact details are available in file CREDITS.
14 #ifndef TEXT_METRICS_H
15 #define TEXT_METRICS_H
17 #include "ParagraphMetrics.h"
19 #include "support/types.h"
30 /// A map from a Text to the map of paragraphs metrics
34 /// Default constructor (only here for STL containers).
35 TextMetrics(): text_(0) {}
36 /// The only useful constructor.
37 TextMetrics(BufferView *, Text *);
39 ParagraphMetrics const & parMetrics(pit_type) const;
41 Dimension const & dimension() const;
42 Dimension const & dimension();
44 /// compute text metrics.
45 bool metrics(MetricsInfo & mi, Dimension & dim);
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(); }
55 int ascent() const { return dim_.asc; }
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(); }
64 int maxWidth() const { return max_width_; }
66 int singleWidth(pit_type const pit, pos_type pos) const;
69 int rightMargin(ParagraphMetrics const & pm) const;
70 int rightMargin(pit_type const pit) const;
72 /** this calculates the specified parameters. needed when setting
73 * the cursor and when creating a visible row */
74 RowMetrics computeRowMetrics(pit_type pit, Row const & row) const;
76 void draw(PainterInfo & pi, int x, int y) const;
80 ParagraphMetrics & parMetrics(pit_type, bool redo_paragraph);
82 /// the minimum space a manual label needs on the screen in pixels
83 int labelFill(pit_type const pit, Row const & row) const;
86 int labelEnd(pit_type const pit) const;
88 /// sets row.end to the pos value *after* which a row should break.
89 /// for example, the pos after which isNewLine(pos) == true
90 void rowBreakPoint(int width, pit_type const pit, Row & row) const;
92 /// sets row.width to the minimum space a row needs on the screen in pixel
93 void setRowWidth(int right_margin, pit_type const pit, Row & row) const;
95 /// Calculate and set the height of the row
96 void setHeightOfRow(pit_type, Row & row);
100 /// returns the column near the specified x-coordinate of the row.
101 /// x is an absolute screen coord, it is set to the real beginning
103 pos_type getColumnNearX(pit_type pit, Row const & row, int & x,
104 bool & boundary) const;
106 /// returns pos in given par at given x coord.
107 pos_type x2pos(pit_type pit, int row, int x) const;
109 // FIXME: is there a need for this?
110 //int pos2x(pit_type pit, pos_type pos) const;
114 /// The BufferView owner.
117 /// The text contents (the model).
118 /// \todo FIXME: this should be const.
122 /// A map from paragraph index number to paragraph metrics
123 typedef std::map<pit_type, ParagraphMetrics> ParMetricsCache;
125 mutable ParMetricsCache par_metrics_;
129 /// FIXME: transfer this code in CoordCache here.
131 /// A map from paragraph index number to screen point
132 typedef std::map<pit_type, Point> InnerParPosCache;
133 /// A map from a Text to the map of paragraphs to screen points
134 typedef std::map<Text const *, InnerParPosCache> ParPosCache;
135 /// Paragraph grouped by owning text
140 /// return the default height of a row in pixels, considering font zoom
141 int defaultRowHeight();
145 #endif // TEXT_METRICS_H