]> git.lyx.org Git - lyx.git/blobdiff - src/lyxtext.h
Optimize drawing.
[lyx.git] / src / lyxtext.h
index e463e46a3f56ed29ceed4502e7f9aad4f038ab1b..5bf93d8278def4cd6aa4c2fee3d53d6eeb340f40 100644 (file)
 #include "bufferview_funcs.h"
 #include "Bidi.h"
 #include "dispatchresult.h"
+#include "dimension.h"
 #include "lyxfont.h"
 #include "layout.h"
 #include "lyxlayout_ptr_fwd.h"
-#include "ParagraphList_fwd.h"
-#include "RowList_fwd.h"
+#include "ParagraphList.h"
 
 #include <iosfwd>
 
+
+namespace lyx {
+
 class Buffer;
 class BufferParams;
 class BufferView;
 class CursorSlice;
 class Dimension;
+class ErrorList;
 class InsetBase;
-class InsetOld_code;
+class InsetBase_code;
 class FuncRequest;
 class FuncStatus;
 class LColor_color;
@@ -39,123 +43,110 @@ class LCursor;
 class LyXTextClass;
 class MetricsInfo;
 class PainterInfo;
-class Paragraph;
 class Row;
 class RowMetrics;
 class Spacing;
-class UpdatableInset;
-class VSpace;
+
 
 /// This class encapsulates the main text data and operations in LyX
 class LyXText {
 public:
-       ///
-       typedef lyx::pos_type pos_type;
-       ///
-       typedef lyx::paroffset_type par_type;
-       
        /// constructor
-       explicit LyXText(BufferView *);
+       explicit LyXText(BufferView * bv = 0);
        ///
        void init(BufferView *);
 
-       /// update y coordinate cache of all paragraphs
-       void updateParPositions();
        ///
-       LyXFont getFont(ParagraphList::iterator pit, pos_type pos) const;
+       LyXFont getFont(Buffer const & buffer, Paragraph const & par,
+               pos_type pos) const;
+       ///
+       void applyOuterFont(Buffer const & buffer, LyXFont &) const;
+       ///
+       LyXFont getLayoutFont(Buffer const & buffer, pit_type pit) const;
        ///
-       LyXFont getLayoutFont(ParagraphList::iterator pit) const;
+       LyXFont getLabelFont(Buffer const & buffer,
+               Paragraph const & par) const;
        ///
-       LyXFont getLabelFont(ParagraphList::iterator pit) const;
+       void setCharFont(Buffer const & buffer, pit_type pit, pos_type pos,
+               LyXFont const & font);
        ///
-       void setCharFont(ParagraphList::iterator pit,
-                        pos_type pos, LyXFont const & font);
-       void setCharFont(ParagraphList::iterator pit,
-                        pos_type pos, LyXFont const & font, bool toggleall);
+       void setCharFont(Buffer const & buffer, pit_type pit, pos_type pos,
+               LyXFont const & font, bool toggleall);
 
        /// what you expect when pressing <enter> at cursor position
-       void breakParagraph(LCursor & cur, char keep_layout = 0);
+       void breakParagraph(LCursor & cur, bool keep_layout = false);
 
-       /** set layout over selection and make a total rebreak of
-         those paragraphs
-         */
-       ParagraphList::iterator
-       setLayout(ParagraphList::iterator start,
-                 ParagraphList::iterator end,
-                 std::string const & layout);
+       /// set layout over selection
+       void setLayout(Buffer const & buffer, pit_type start, pit_type end,
+               std::string const & layout);
        ///
        void setLayout(LCursor & cur, std::string const & layout);
 
+       /// what type of depth change to make
+       enum DEPTH_CHANGE {
+               INC_DEPTH,
+               DEC_DEPTH
+       };
        /// Increase or decrease the nesting depth of the selected paragraph(s)
-       void changeDepth(LCursor & cur, bv_funcs::DEPTH_CHANGE type);
+       void changeDepth(LCursor & cur, DEPTH_CHANGE type);
 
        /// Returns whether something would be changed by changeDepth
-       bool changeDepthAllowed(LCursor & cur, bv_funcs::DEPTH_CHANGE type);
+       bool changeDepthAllowed(LCursor & cur, DEPTH_CHANGE type) const;
 
        /// Set font over selection paragraphs and rebreak.
        void setFont(LCursor & cur, LyXFont const &, bool toggleall = false);
 
-       /// rebreaks all paragaphs between the given pars.
-       void redoParagraphs(ParagraphList::iterator begin,
-                           ParagraphList::iterator end);
-       /// rebreaks the given par
-       void redoParagraph(ParagraphList::iterator pit);
-       /// rebreaks the cursor par
-       void redoParagraph(LCursor & cur);
+       /// Rebreaks the given paragraph.
+       /// \retval true if a full screen redraw is needed.
+       /// \retval false if a single paragraph redraw is enough.
+       bool redoParagraph(BufferView &, pit_type pit);
+
+       /// returns pos in given par at given x coord
+       pos_type x2pos(BufferView const &, pit_type pit, int row, int x) const;
+       int pos2x(pit_type pit, pos_type pos) const;
 
        ///
        void toggleFree(LCursor & cur, LyXFont const &, bool toggleall = false);
 
        ///
-       std::string getStringToIndex(LCursor & cur);
+       docstring getStringToIndex(LCursor const & cur);
 
        /// insert a character at cursor position
-       void insertChar(LCursor & cur, char c);
+       void insertChar(LCursor & cur, char_type c);
        /// insert an inset at cursor position
        void insertInset(LCursor & cur, InsetBase * inset);
 
-       /// a full rebreak of the whole text
-       void fullRebreak();
        /// compute text metrics
        void metrics(MetricsInfo & mi, Dimension & dim);
        /// draw text (only used for insets)
        void draw(PainterInfo & pi, int x, int y) const;
        /// draw textselection
        void drawSelection(PainterInfo & pi, int x, int y) const;
-       /// returns distance of this cell to the point given by x and y
-       // assumes valid position and size cache
-       int dist(int x, int y) const;
 
        /// try to handle that request
        void dispatch(LCursor & cur, FuncRequest & cmd);
        /// do we want to handle this event?
-       bool getStatus(LCursor & cur, FuncRequest const & cmd, FuncStatus & status);
-
-       /// access to out BufferView. This should go...
-       BufferView * bv();
-       /// access to out BufferView. This should go...
-       BufferView * bv() const;
+       bool getStatus(LCursor & cur, FuncRequest const & cmd,
+               FuncStatus & status) const;
 
-       /// returns an iterator pointing to a cursor paragraph
-       ParagraphList::iterator getPar(CursorSlice const & cursor) const;
-       ///
-       ParagraphList::iterator getPar(par_type par) const;
-       ///
-       int parOffset(ParagraphList::iterator pit) const;
+       /// read-only access to individual paragraph
+       Paragraph const & getPar(pit_type pit) const { return pars_[pit]; }
+       /// read-write access to individual paragraph
+       Paragraph & getPar(pit_type pit) { return pars_[pit]; }
        // Returns the current font and depth as a message.
-       std::string LyXText::currentState(LCursor & cur);
+       std::string currentState(LCursor & cur);
 
-       /** returns an iterator pointing to the row near the specified
-         * y-coordinate (relative to the whole text). y is set to the
-         * real beginning of this row
+       /** returns row near the specified
+         * y-coordinate in given paragraph (relative to the screen).
          */
-       RowList::iterator getRowNearY(int y,
-               ParagraphList::iterator & pit) const;
+       Row const & getRowNearY(BufferView const & bv, int y,
+               pit_type pit) const;
+       pit_type getPitNearY(BufferView const & bv, int y) const;
 
        /** returns the column near the specified x-coordinate of the row
         x is set to the real beginning of this column
         */
-       pos_type getColumnNearX(ParagraphList::iterator pit,
+       pos_type getColumnNearX(BufferView const & bv, pit_type pit,
                Row const & row, int & x, bool & boundary) const;
 
        /** Find the word under \c from in the relative location
@@ -163,9 +154,9 @@ public:
         *  @param from return here the start of the word
         *  @param to return here the end of the word
         */
-       void getWord(CursorSlice & from, CursorSlice & to, lyx::word_location const);
+       void getWord(CursorSlice & from, CursorSlice & to, word_location const);
        /// just selects the word the cursor is in
-       void selectWord(LCursor & cur, lyx::word_location loc);
+       void selectWord(LCursor & cur, word_location loc);
 
        /// accept selected change
        void acceptChange(LCursor & cur);
@@ -173,59 +164,84 @@ public:
        void rejectChange(LCursor & cur);
 
        /// returns true if par was empty and was removed
-       bool setCursor(LCursor & cur, par_type par, pos_type pos,
+       bool setCursor(LCursor & cur, pit_type par, pos_type pos,
                       bool setfont = true, bool boundary = false);
        ///
-       void setCursor(CursorSlice &, par_type par,
-                      pos_type pos, bool boundary = false);
+       void setCursor(CursorSlice &, pit_type par, pos_type pos);
        ///
-       void setCursorIntern(LCursor & cur, par_type par,
-                pos_type pos, bool setfont = true, bool boundary = false);
+       void setCursorIntern(LCursor & cur, pit_type par,
+                pos_type pos, bool setfont = true, bool boundary = false);
        ///
        void setCurrentFont(LCursor & cur);
 
        ///
-       void recUndo(par_type first, par_type last) const;
-       ///
-       void recUndo(par_type first) const;
-       ///
-       void setCursorFromCoordinates(LCursor & cur, int x, int y);
+       void recUndo(LCursor & cur, pit_type first, pit_type last) const;
        ///
+       void recUndo(LCursor & cur, pit_type first) const;
+       /// returns true if par was empty and was removed
+       bool setCursorFromCoordinates(LCursor & cur, int x, int y);
+
+       /// sets cursor recursively descending into nested editable insets
+       /**
+       \return the inset pointer if x,y is covering that inset
+       \param x,y are absolute screen coordinates.
+       \retval inset is non-null if the cursor is positionned inside
+       */
        InsetBase * editXY(LCursor & cur, int x, int y);
+       
+       /// Move cursor one line up.
+       /**
+        * Returns true if an update is needed after the move.
+        */
+       bool cursorUp(LCursor & cur);
+       /// Move cursor one line down.
+       /**
+        * Returns true if an update is needed after the move.
+        */
+       bool cursorDown(LCursor & cur);
+       /// Move cursor one position left
+       /**
+        * Returns true if an update is needed after the move.
+        */
+       bool cursorLeft(LCursor & cur);
+       /// Move cursor one position right
+       /**
+        * Returns true if an update is needed after the move.
+        */
+       bool cursorRight(LCursor & cur);
        ///
-       void cursorUp(LCursor & cur);
-       ///
-       void cursorDown(LCursor & cur);
-       ///
-       void cursorLeft(LCursor & cur);
-       ///
-       void cursorRight(LCursor & cur);
-       ///
-       void cursorLeftOneWord(LCursor & cur);
-       ///
-       void cursorRightOneWord(LCursor & cur);
-       ///
-       void cursorUpParagraph(LCursor & cur);
+       bool cursorLeftOneWord(LCursor & cur);
        ///
-       void cursorDownParagraph(LCursor & cur);
+       bool cursorRightOneWord(LCursor & cur);
        ///
-       void cursorHome(LCursor & cur);
+       bool cursorUpParagraph(LCursor & cur);
        ///
-       void cursorEnd(LCursor & cur);
+       bool cursorDownParagraph(LCursor & cur);
        ///
-       void cursorPrevious(LCursor & cur);
+       bool cursorHome(LCursor & cur);
        ///
-       void cursorNext(LCursor & cur);
+       bool cursorEnd(LCursor & cur);
        ///
-       void cursorTop(LCursor & cur);
+       bool cursorPrevious(LCursor & cur);
        ///
-       void cursorBottom(LCursor & cur);
+       bool cursorNext(LCursor & cur);
        ///
-       void Delete(LCursor & cur);
+       bool cursorTop(LCursor & cur);
        ///
-       void backspace(LCursor & cur);
+       bool cursorBottom(LCursor & cur);
+       /// Erase character at cursor. Honour change tracking
+       bool erase(LCursor & cur);
+       /** At cursor position 0, merge paragraph with the one before it.
+        * Ignore CT (this is used in \c acceptChange, \c rejectChange for
+        * physical deletion of paragraph break)
+        */
+       bool backspacePos0(LCursor & cur);
+       /// Delete character before cursor. Honour CT
+       bool backspace(LCursor & cur);
+       // Dissolve the inset under cursor
+       bool dissolveInset(LCursor & cur);
        ///
-       bool selectWordWhenUnderCursor(LCursor & cur, lyx::word_location);
+       bool selectWordWhenUnderCursor(LCursor & cur, word_location);
        ///
        enum TextCase {
                ///
@@ -237,15 +253,8 @@ public:
        };
        /// Change the case of the word at cursor position.
        void changeCase(LCursor & cur, TextCase action);
-
-       /// returns success
-       bool toggleInset(LCursor & cur);
-       ///
-       void cutSelection(LCursor & cur, bool doclear = true, bool realcut = true);
-       ///
-       void copySelection(LCursor & cur);
-       ///
-       void pasteSelection(LCursor & cur, size_t sel_index = 0);
+       /// Transposes the character at the cursor with the one before it
+       void charsTranspose(LCursor & cur);
 
        /** the DTP switches for paragraphs. LyX will store the top settings
         always in the first physical paragraph, the bottom settings in the
@@ -255,52 +264,31 @@ public:
        void setParagraph(LCursor & cur,
                          Spacing const & spacing,
                          LyXAlignment align,
-                         std::string const & labelwidthstring,
+                         docstring const & labelwidthstring,
                          bool noindent);
 
        /* these things are for search and replace */
 
-       /**
-        * Sets the selection from the current cursor position to length
-        * characters to the right. No safety checks.
-        */
-       void setSelectionRange(LCursor & cur, pos_type length);
-       /// simply replace using the font of the first selected character
-       void replaceSelectionWithString(LCursor & cur, std::string const & str);
-       /// replace selection helper
-       void replaceSelection(LCursor & cur);
-
        /// needed to insert the selection
-       void insertStringAsLines(LCursor & cur, std::string const & str);
+       void insertStringAsLines(LCursor & cur, docstring const & str);
        /// needed to insert the selection
-       void insertStringAsParagraphs(LCursor & cur, std::string const & str);
-
-       /// Find next inset of some specified type.
-       bool gotoNextInset(LCursor & cur,
-               std::vector<InsetOld_code> const & codes,
-               std::string const & contents = std::string());
-       ///
-       void gotoInset(LCursor & cur,
-               std::vector<InsetOld_code> const & codes, bool same_content);
-       ///
-       void gotoInset(LCursor & cur, InsetOld_code code, bool same_content);
+       void insertStringAsParagraphs(LCursor & cur, docstring const & str);
 
        /// current text width
        int width() const;
 
        /// current text heigth
        int height() const;
-       
-       /// updates all counters
-       void updateCounters();
+
        /// Returns an inset if inset was hit, or 0 if not.
-       InsetBase * checkInsetHit(int x, int y);
+       InsetBase * checkInsetHit(BufferView const &, int x, int y) const;
 
        ///
-       int singleWidth(ParagraphList::iterator pit, pos_type pos) const;
+       int singleWidth(Buffer const &, Paragraph const & par,
+               pos_type pos) const;
        ///
-       int singleWidth(ParagraphList::iterator pit,
-               pos_type pos, char c, LyXFont const & Font) const;
+       int singleWidth(Paragraph const & par, pos_type pos, char_type c,
+               LyXFont const & Font) const;
 
        /// return the color of the canvas
        LColor_color backgroundColor() const;
@@ -311,128 +299,92 @@ public:
         * in LaTeX the beginning of the text fits in some cases
         * (for example sections) exactly the label-width.
         */
-       int leftMargin(ParagraphList::iterator pit, pos_type pos) const;
-       int leftMargin(ParagraphList::iterator pit) const;
+       int leftMargin(Buffer const &, pit_type pit, pos_type pos) const;
+       int leftMargin(Buffer const &, pit_type pit) const;
        ///
-       int rightMargin(Paragraph const & par) const;
+       int rightMargin(Buffer const &, Paragraph const & par) const;
 
        /** this calculates the specified parameters. needed when setting
         * the cursor and when creating a visible row */
-       RowMetrics
-       computeRowMetrics(ParagraphList::iterator pit, Row const & row) const;
+       RowMetrics computeRowMetrics(Buffer const &, pit_type pit,
+               Row const & row) const;
 
        /// access to our paragraphs
-       ParagraphList & paragraphs() const;
+       ParagraphList const & paragraphs() const { return pars_; }
+       ParagraphList & paragraphs() { return pars_; }
        /// return true if this is the main text
-       bool isMainText() const;
-       
+       bool isMainText(Buffer const &) const;
+
        /// return first row of text
-       RowList::iterator firstRow() const;
-       /// return last row of text
-       RowList::iterator lastRow() const;
-       /// return row "behind" last row of text
-       RowList::iterator endRow() const;
-       /// return next row crossing paragraph boundaries
-       void nextRow(ParagraphList::iterator & pit,
-               RowList::iterator & rit) const;
-       /// return previous row crossing paragraph boundaries
-       void previousRow(ParagraphList::iterator & pit,
-               RowList::iterator & rit) const;
+       Row const & firstRow() const;
 
        /// is this row the last in the text?
-       bool isLastRow(ParagraphList::iterator pit, Row const & row) const;
+       bool isLastRow(pit_type pit, Row const & row) const;
        /// is this row the first in the text?
-       bool isFirstRow(ParagraphList::iterator pit, Row const & row) const;
+       bool isFirstRow(pit_type pit, Row const & row) const;
 
        ///
-       double spacing(Paragraph const & par) const;
+       double spacing(Buffer const & buffer, Paragraph const & par) const;
        /// make a suggestion for a label
-       std::string getPossibleLabel(LCursor & cur) const;
+       docstring getPossibleLabel(LCursor & cur) const;
        /// is this paragraph right-to-left?
-       bool isRTL(Paragraph const & par) const;
+       bool isRTL(Buffer const &, Paragraph const & par) const;
        ///
        bool checkAndActivateInset(LCursor & cur, bool front);
 
        ///
        void write(Buffer const & buf, std::ostream & os) const;
        /// returns whether we've seen our usual 'end' marker
-       bool read(Buffer const & buf, LyXLex & lex);
+       bool read(Buffer const & buf, LyXLex & lex, ErrorList & errorList);
 
        ///
        int ascent() const;
        ///
        int descent() const;
        ///
-       int cursorX(CursorSlice const & cursor) const;
+       int cursorX(Buffer const &, CursorSlice const & cursor,
+               bool boundary) const;
        ///
-       int cursorY(CursorSlice const & cursor) const;
+       int cursorY(CursorSlice const & cursor, bool boundary) const;
 
-       ///
-       friend class LyXScreen;
+       /// delete double space or empty paragraphs around old cursor
+       bool deleteEmptyParagraphMechanism(LCursor & cur, LCursor & old);
 
+public:
        ///
-       unsigned int width_;
+       Dimension dim_;
        ///
        int maxwidth_;
-       ///
-       int height_;
-public:
        /// the current font settings
        LyXFont current_font;
        /// the current font
        LyXFont real_current_font;
-       /// our buffer's default layout font
-       LyXFont defaultfont_;
        ///
        int background_color_;
 
-       /// only the top-level LyXText has this non-zero
-       BufferView * bv_owner;
-
        ///
        mutable Bidi bidi;
        ///
-       ParagraphList paragraphs_;
+       ParagraphList pars_;
 
-       /// absolute document pixel coordinates of this LyXText
-       mutable int xo_;
-       mutable int yo_;
-
-       /// our 'outermost' Font
+       /// our 'outermost' font. This is handed down from the surrounding
+       // inset through the pi/mi parameter (pi.base.font)
        LyXFont font_;
 
        ///
-       double fill_separator(Row const & row) const;
-       ///
-       double fill_hfill(Row const & row) const;
-       ///
-       double
-       fill_label_hfill(ParagraphList::iterator pit, Row const & row) const;
-
+       bool autoBreakRows_;
 private:
        /// return past-the-last paragraph influenced by a layout
        /// change on pit
-       ParagraphList::iterator undoSpan(ParagraphList::iterator pit);
-       
-       /// rebreaks the given par
-       void redoParagraphInternal(ParagraphList::iterator pit);
-       /// used in setlayout
-       void makeFontEntriesLayoutSpecific(BufferParams const &, Paragraph & par);
+       pit_type undoSpan(pit_type pit);
 
        /// Calculate and set the height of the row
-       void setHeightOfRow(ParagraphList::iterator, Row & row);
+       void setHeightOfRow(BufferView const &, pit_type, Row & row);
 
        // fix the cursor `cur' after a characters has been deleted at `where'
        // position. Called by deleteEmptyParagraphMechanism
        void fixCursorAfterDelete(CursorSlice & cur, CursorSlice const & where);
 
-       /// delete double space (false) or empty paragraphs (true) around old_cursor
-       bool deleteEmptyParagraphMechanism(
-               CursorSlice & cur,
-               CursorSlice const & old_cursor);
-
-       ///
-       void setCounter(Buffer const &, ParagraphList::iterator pit);
        ///
        void deleteWordForward(LCursor & cur);
        ///
@@ -442,13 +394,14 @@ private:
 
        /// sets row.end to the pos value *after* which a row should break.
        /// for example, the pos after which isNewLine(pos) == true
-       void rowBreakPoint(ParagraphList::iterator pit, Row & row) const;
+       void rowBreakPoint(Buffer const &, int right_margin, pit_type pit,
+               Row & row) const;
        /// sets row.width to the minimum space a row needs on the screen in pixel
-       void setRowWidth(ParagraphList::iterator pit, Row & row) const;
+       void setRowWidth(Buffer const &, pit_type pit, Row & row) const;
        /// the minimum space a manual label needs on the screen in pixels
-       int labelFill(ParagraphList::iterator pit, Row const & row) const;
+       int labelFill(Buffer const &, Paragraph const & par, Row const & row) const;
        /// FIXME
-       int labelEnd(ParagraphList::iterator pit) const;
+       int labelEnd(Buffer const &, pit_type pit) const;
 
        ///
        void charInserted();
@@ -459,9 +412,7 @@ private:
 /// return the default height of a row in pixels, considering font zoom
 int defaultRowHeight();
 
-///
-std::string expandLabel(LyXTextClass const & textclass,
-               LyXLayout_ptr const & layout, bool appendix);
 
+} // namespace lyx
 
 #endif // LYXTEXT_H