]> git.lyx.org Git - lyx.git/blobdiff - src/paragraph.h
* filetools.[Ch]: Make functions that start with a capital
[lyx.git] / src / paragraph.h
index 839cc54da48dc80975086a0782259e733a11a10f..f3c3700025dbd9abfca3ba99f5ace62cedcc1cfe 100644 (file)
 #define PARAGRAPH_H
 
 #include "changes.h"
+#include "dimension.h"
 #include "InsetList.h"
 #include "lyxlayout_ptr_fwd.h"
 #include "RowList_fwd.h"
 
+#include "insets/insetbase.h" // only for InsetBase::Code
+
 #include "support/types.h"
 
 #include <string>
@@ -29,22 +32,38 @@ class Buffer;
 class BufferParams;
 class BufferView;
 class Counters;
+class InsetBase;
 class InsetBibitem;
-class InsetOld_code;
-class Language;
 class LaTeXFeatures;
-class LatexRunParams;
+class InsetBase_code;
+class Language;
 class LyXFont;
 class LyXFont_size;
+class MetricsInfo;
+class OutputParams;
+class PainterInfo;
 class ParagraphParameters;
 class TexRow;
-class UpdatableInset;
+
+
+class FontSpan {
+public:
+       /// Invalid font span containing no character
+       FontSpan() : first(0), last(-1) {}
+       /// Span including first and last
+       FontSpan(lyx::pos_type f, lyx::pos_type l) : first(f), last(l) {}
+
+public:
+       /// Range including first and last.
+       lyx::pos_type first, last;
+};
+
 
 /// A Paragraph holds all text, attributes and insets in a text paragraph
 class Paragraph  {
 public:
        ///
-       enum META_KIND {
+       enum {
                /// Note that this is 1 right now to avoid
                /// crashes where getChar() is called wrongly
                /// (returning 0) - if this was 0, then we'd
@@ -61,18 +80,15 @@ public:
 
        ///
        Paragraph();
-
        ///
        Paragraph(Paragraph const &);
        ///
-       void operator=(Paragraph const &);
-       /// the destructor removes the new paragraph from the list
+       Paragraph & operator=(Paragraph const &);
+       ///
        ~Paragraph();
-
        ///
        int id() const;
-       ///
-       void id(int i);
+
 
        ///
        Language const * getParLanguage(BufferParams const &) const;
@@ -82,13 +98,25 @@ public:
        void changeLanguage(BufferParams const & bparams,
                            Language const * from, Language const * to);
        ///
-       bool isMultiLingual(BufferParams const &);
+       bool isMultiLingual(BufferParams const &) const;
 
+       ///
+       std::string const asString(Buffer const &,
+                                  OutputParams const & runparams,
+                                  bool label) const;
        ///
        std::string const asString(Buffer const &, bool label) const;
        ///
-       std::string const asString(Buffer const &, lyx::pos_type beg, lyx::pos_type end,
-                             bool label) const;
+       std::string const asString(Buffer const & buffer,
+                                  lyx::pos_type beg,
+                                  lyx::pos_type end,
+                                  bool label) const;
+       ///
+       std::string const asString(Buffer const &,
+                                  OutputParams const & runparams,
+                                  lyx::pos_type beg,
+                                  lyx::pos_type end,
+                                  bool label) const;
 
        ///
        void write(Buffer const &, std::ostream &, BufferParams const &,
@@ -106,7 +134,37 @@ public:
        ///
        bool simpleTeXOnePar(Buffer const &, BufferParams const &,
                             LyXFont const & outerfont, std::ostream &,
-                            TexRow & texrow, LatexRunParams const &);
+                            TexRow & texrow, OutputParams const &) const;
+
+       /// Writes to stream the content of the paragraph for linuxdoc
+       void simpleLinuxDocOnePar(Buffer const & buf,
+                                 std::ostream & os,
+                                 LyXFont const & outerfont,
+                                 OutputParams const & runparams,
+                                 lyx::depth_type depth) const;
+
+       /// Can we drop the standard paragraph wrapper?
+       bool emptyTag() const;
+
+       /// Get the id of the paragraph, usefull for docbook and linuxdoc
+       std::string getID(Buffer const & buf,
+                         OutputParams const & runparams) const;
+
+       // Get the first word of a paragraph, return the position where it left
+       lyx::pos_type getFirstWord(Buffer const & buf,
+                                  std::ostream & os,
+                                  OutputParams const & runparams) const;
+
+       /// Checks if the paragraph contains only text and no inset or font change.
+       bool onlyText(Buffer const & buf, LyXFont const & outerfont,
+                     lyx::pos_type initial) const;
+
+       /// Writes to stream the docbook representation
+       void simpleDocBookOnePar(Buffer const & buf,
+                                std::ostream &,
+                                OutputParams const & runparams,
+                                LyXFont const & outerfont,
+                                lyx::pos_type initial = 0) const;
 
        ///
        bool hasSameLayout(Paragraph const & par) const;
@@ -115,11 +173,13 @@ public:
        void makeSameLayout(Paragraph const & par);
 
        ///
-       UpdatableInset * inInset() const;
+       void setInsetOwner(InsetBase * inset);
+       ///
+       InsetBase * inInset() const;
        ///
-       void setInsetOwner(UpdatableInset * inset);
+       InsetBase::Code ownerCode() const;
        ///
-       void deleteInsetsLyXText(BufferView *);
+       bool forceDefaultParagraphs() const;
 
        ///
        lyx::pos_type size() const { return text_.size(); }
@@ -165,21 +225,26 @@ public:
        /// set change at pos
        void setChange(lyx::pos_type pos, Change::Type type);
 
+       /// set full change at pos
+       void setChangeFull(lyx::pos_type pos, Change change);
+
        /// accept change
        void acceptChange(lyx::pos_type start, lyx::pos_type end);
 
        /// reject change
        void rejectChange(lyx::pos_type start, lyx::pos_type end);
 
-       /// mark whole par as erased
-       void markErased();
+       /// mark whole par as erased or not
+       void markErased(bool erased);
 
        /// Paragraphs can contain "manual labels", for example, Description
        /// environment. The text for this user-editable label is stored in
        /// the paragraph alongside the text of the rest of the paragraph
        /// (the body). This function returns the starting position of the
        /// body of the text in the paragraph.
-       int beginningOfBody() const;
+       lyx::pos_type beginOfBody() const;
+       /// recompute this value
+       void setBeginOfBody();
 
        ///
        std::string const & getLabelstring() const;
@@ -211,7 +276,7 @@ public:
        LyXFont const
        getFontSettings(BufferParams const &, lyx::pos_type pos) const;
        ///
-       LyXFont const getFirstFontSettings() const;
+       LyXFont const getFirstFontSettings(BufferParams const &) const;
 
        /** Get fully instantiated font. If pos == -1, use the layout
            font attached to this paragraph.
@@ -228,14 +293,16 @@ public:
                                   LyXFont const & outerfont) const;
        /**
         * The font returned by the above functions is the same in a
-        * span of characters. This method will return the last position
-        * in the paragraph for which that font is the same.
-        * This can be used to avoid unnecessary calls to getFont.
+        * span of characters. This method will return the first and
+        * the last positions in the paragraph for which that font is
+        * the same. This can be used to avoid unnecessary calls to
+   * getFont.
         */
-       lyx::pos_type getEndPosOfFontSpan(lyx::pos_type pos) const;
-       ///
-       value_type getChar(lyx::pos_type pos) const;
+       FontSpan fontSpan(lyx::pos_type pos) const;
        ///
+       /// this is a bottleneck.
+       value_type getChar(lyx::pos_type pos) const { return text_[pos]; }
+       /// Get the char, but mirror all bracket characters if it is right-to-left
        value_type getUChar(BufferParams const &, lyx::pos_type pos) const;
        /// The position must already exist.
        void setChar(lyx::pos_type pos, value_type c);
@@ -246,43 +313,54 @@ public:
                                        lyx::pos_type endpos,
                                        LyXFont_size def_size) const;
        ///
-       void insertChar(lyx::pos_type pos, value_type c);
+       void insert(lyx::pos_type pos, std::string const & str,
+                   LyXFont const & font);
        ///
-       void insertChar(lyx::pos_type pos, value_type c, LyXFont const &, Change change = Change(Change::INSERTED));
+       void insertChar(lyx::pos_type pos, value_type c,
+                       Change change = Change::INSERTED);
        ///
-       bool checkInsertChar(LyXFont &);
+       void insertChar(lyx::pos_type pos, value_type c,
+               LyXFont const &, Change change = Change::INSERTED);
        ///
-       void insertInset(lyx::pos_type pos, InsetOld * inset);
+       void insertInset(lyx::pos_type pos, InsetBase * inset,
+                        Change change = Change::INSERTED);
        ///
-       void insertInset(lyx::pos_type pos, InsetOld * inset, LyXFont const &, Change change = Change(Change::INSERTED));
+       void insertInset(lyx::pos_type pos, InsetBase * inset,
+               LyXFont const &, Change change = Change::INSERTED);
        ///
-       bool insetAllowed(InsetOld_code code);
+       bool insetAllowed(InsetBase_code code);
        ///
-       InsetOld * getInset(lyx::pos_type pos);
+       InsetBase * getInset(lyx::pos_type pos) {
+               return insetlist.get(pos);
+       }
        ///
-       InsetOld const * getInset(lyx::pos_type pos) const;
+       InsetBase const * getInset(lyx::pos_type pos) const {
+               return insetlist.get(pos);
+       }
 
        ///
-       bool isHfill(lyx::pos_type pos) const;
-       ///
-       bool isInset(lyx::pos_type pos) const;
+       bool isHfill(lyx::pos_type pos) const {
+       return isInset(pos)
+               && getInset(pos)->lyxCode() == InsetBase::HFILL_CODE;
+       }
+       /// hinted by profiler
+       bool isInset(lyx::pos_type pos) const {
+               return getChar(pos) == static_cast<value_type>(META_INSET);
+       }
        ///
        bool isNewline(lyx::pos_type pos) const;
-       ///
-       bool isSeparator(lyx::pos_type pos) const;
+       /// return true if the char is a word separator
+       bool isSeparator(lyx::pos_type pos) const { return getChar(pos) == ' '; }
        ///
        bool isLineSeparator(lyx::pos_type pos) const;
-       ///
-       bool isKomma(lyx::pos_type pos) const;
-       /// Used by the spellchecker
+       /// True if the character/inset at this point can be part of a word
+       // Note that digits in particular are considered as letters
        bool isLetter(lyx::pos_type pos) const;
-       ///
-       bool isWord(lyx::pos_type pos) const;
 
        /// returns -1 if inset not found
-       int getPositionOfInset(InsetOld const * inset) const;
+       int getPositionOfInset(InsetBase const * inset) const;
 
-       ///
+       /// Returns the number of line breaks and white-space stripped at the start
        int stripLeadingSpaces();
 
        /// return true if we allow multiple spaces
@@ -290,32 +368,70 @@ public:
 
        /// return true if we allow this par to stay empty
        bool allowEmpty() const;
-
+       ///
+       unsigned char transformChar(unsigned char c, lyx::pos_type pos) const;
        ///
        ParagraphParameters & params();
        ///
        ParagraphParameters const & params() const;
+
        ///
-       InsetList insetlist;
+       Row & getRow(lyx::pos_type pos, bool boundary);
+       ///
+       Row const & getRow(lyx::pos_type pos, bool boundary) const;
+       ///
+       size_t pos2row(lyx::pos_type pos) const;
 
+       /// total height of paragraph
+       unsigned int height() const { return dim_.height(); }
+       /// total width of paragraph, may differ from workwidth
+       unsigned int width() const { return dim_.width(); }
+       /// ascend of paragraph above baseline
+       unsigned int ascent() const { return dim_.ascent(); }
+       /// descend of paragraph below baseline
+       unsigned int descent() const { return dim_.descent(); }
+       /// LyXText updates the rows using this access point
+       RowList & rows() { return rows_; }
+       /// The painter and others use this
+       RowList const & rows() const { return rows_; }
        ///
-       mutable RowList rows;
-       /// last draw y position (baseline of top row)
-       int y;
+       RowSignature & rowSignature() const { return rowSignature_; }
+
+       /// LyXText::redoParagraph updates this
+       Dimension & dim() { return dim_; }
+
+       /// dump some information to lyxerr
+       void dump() const;
+
+public:
+       ///
+       InsetList insetlist;
 
 private:
+       /// cached dimensions of paragraph
+       Dimension dim_;
+
+       ///
+       mutable RowList rows_;
+       ///
+       mutable RowSignature rowSignature_;
+
        ///
        LyXLayout_ptr layout_;
-       /// keeping this here instead of in the pimpl makes LyX >10% faster
-       // for average tasks as buffer loading/switching etc.
+       /**
+        * Keeping this here instead of in the pimpl makes LyX >10% faster
+        * for average tasks as buffer loading/switching etc.
+        */
        TextContainer text_;
+       /// end of label
+       lyx::pos_type begin_of_body_;
 
-       struct Pimpl;
+       /// Pimpl away stuff
+       class Pimpl;
        ///
-       friend struct Paragraph::Pimpl;
+       friend class Paragraph::Pimpl;
        ///
        Pimpl * pimpl_;
-
 };