#include "math_diminset.h"
-/** Abstract base class for all math objects that conatin nested items.
+/** Abstract base class for all math objects that contain nested items.
+ This is basically everything that is not a single character or a
+ single symbol
*/
class MathNestInset : public MathDimInset {
public:
- ///
+ /// nestinsets have a fixed size to start with
explicit MathNestInset(idx_type ncells);
- ///
+ /// the size is usuall some sort of convex hull of the cells
void metrics(MathMetricsInfo const & st) const;
/// draw the object, sets xo_ and yo_ cached values
void draw(Painter &, int x, int y) const;
/// identifies NestInsets
MathNestInset * asNestInset() { return this; }
- /// The left key
+ /// order of movement through the cells when pressing the left key
bool idxLeft(idx_type & idx, pos_type & pos) const;
- /// The right key
+ /// order of movement through the cells when pressing the right key
bool idxRight(idx_type & idx, pos_type & pos) const;
- /// Move one physical cell up
+ /// move one physical cell up
bool idxNext(idx_type & idx, pos_type & pos) const;
- /// Move one physical cell down
+ /// move one physical cell down
bool idxPrev(idx_type & idx, pos_type & pos) const;
- /// Target pos when we enter the inset from the left by pressing "Right"
+ /// target pos when we enter the inset from the left by pressing "Right"
bool idxFirst(idx_type & idx, pos_type & pos) const;
- /// Target pos when we enter the inset from the right by pressing "Left"
+ /// target pos when we enter the inset from the right by pressing "Left"
bool idxLast(idx_type & idx, pos_type & pos) const;
- /// Where should we go if we press home?
+ /// where should we go if we press home?
bool idxHome(idx_type & idx, pos_type & pos) const;
- /// Where should we go if we press end?
+ /// where should we go if we press end?
bool idxEnd(idx_type & idx, pos_type & pos) const;
- ///
+ /// number of cells currently governed by us
idx_type nargs() const;
- ///
+ /// direct access to the cell
MathArray & cell(idx_type);
- ///
+ /// direct access to the cell
MathArray const & cell(idx_type) const;
- ///
+ /// direct access to the cell including the drawing cache
MathXArray & xcell(idx_type);
- ///
+ /// direct access to the cell including the drawing cache
MathXArray const & xcell(idx_type) const;
- ///
+ /// can we move into this cell (see macroarg.h)
bool isActive() const { return nargs() > 0; }
- ///
- void push_back(MathAtom const &);
- ///
- void dump() const;
- ///
+ /// request "external features"
+ void validate(LaTeXFeatures & features) const;
+ /// do we cover the point (x,y)?
+ bool covers(int x, int y) const;
+
+ /// match in all cells
bool match(MathInset *) const;
- ///
+ /// replace in all cells
void replace(ReplaceData &);
- ///
- void validate(LaTeXFeatures & features) const;
- ///
- bool covers(int x, int y) const;
+ /// debug helper
+ void dump() const;
protected:
- ///
+ /// we store the cells in a vector
typedef std::vector<MathXArray> cells_type;
- /// The nested contents of the inset are contained here.
+ /// thusly:
cells_type cells_;
};
class MathScriptInset : public MathNestInset {
public:
- ///
+ /// create inset without scripts
MathScriptInset();
- ///
+ /// create inset with single script
explicit MathScriptInset(bool up);
///
MathInset * clone() const;
///
bool idxLastDown(idx_type &, pos_type &) const;
- ///
+ /// identifies scriptinsets
MathScriptInset const * asScriptInset() const;
///
MathScriptInset * asScriptInset();
/// set limits
void limits(int lim) { limits_ = lim; }
- ///
+ /// get limits
int limits() const { return limits_; }
- ///
- bool hasLimits(MathInset const * nuc) const;
/// true if we have an "inner" position
MathXArray const & up() const;
/// returns subscript
void removeScript(bool up);
/// remove script
void removeEmptyScripts();
- ///
+ /// make sure a script is accessible
void ensure(bool up);
+ /// only true if we are _in_ sub- or superscript, not in the convex hull
+ bool covers(int x, int y) const;
// call these methods ...2 to make compaq cxx in anal mode happy...
/// suppresses empty braces if necessary
virtual void write2(MathInset const * nuc, WriteStream & os) const;
- ///
virtual void normalize2(MathInset const * nuc, NormalStream & os) const;
- ///
virtual void octavize2(MathInset const * nuc, OctaveStream & os) const;
- ///
virtual void maplize2(MathInset const * nuc, MapleStream & os) const;
- ///
virtual void mathmlize2(MathInset const * nuc, MathMLStream & os) const;
public:
int nasc(MathInset const * nuc) const;
/// returns descent of nucleus if any
int ndes(MathInset const * nuc) const;
+ /// where do we have to draw the scripts?
+ bool hasLimits(MathInset const * nuc) const;
/// possible subscript (index 0) and superscript (index 1)
bool script_[2];
- ///
+ /// 1 - "limits", -1 - "nolimits", 0 - "default"
int limits_;
- ///
+ /// cached MathMetricsInfo
mutable MathMetricsInfo mi_;
};