2 * \file MathMacroTemplate.cpp
3 * This file is part of LyX, the document processor.
4 * Licence details can be found in the file COPYING.
7 * \author Stefan Schimanski
9 * Full author contact details are available in file CREDITS.
14 #include "MathMacroTemplate.h"
16 #include "InsetMathBrace.h"
17 #include "InsetMathChar.h"
18 #include "InsetMathHull.h"
19 #include "InsetMathSqrt.h"
20 #include "MathMacro.h"
21 #include "MathMacroArgument.h"
22 #include "MathStream.h"
23 #include "MathParser.h"
24 #include "MathSupport.h"
25 #include "MathMacroArgument.h"
28 #include "BufferView.h"
31 #include "DispatchResult.h"
32 #include "DocIterator.h"
33 #include "FuncRequest.h"
34 #include "FuncStatus.h"
35 #include "LaTeXFeatures.h"
37 #include "MetricsInfo.h"
38 #include "TocBackend.h"
40 #include "frontends/Painter.h"
42 #include "insets/RenderPreview.h"
44 #include "support/lassert.h"
45 #include "support/convert.h"
46 #include "support/debug.h"
47 #include "support/gettext.h"
48 #include "support/docstream.h"
49 #include "support/lstrings.h"
58 using support::bformat;
60 //////////////////////////////////////////////////////////////////////
62 class InsetLabelBox : public InsetMathNest {
65 InsetLabelBox(Buffer * buf, MathAtom const & atom, docstring label,
66 MathMacroTemplate const & parent, bool frame = false);
67 InsetLabelBox(Buffer * buf, docstring label, MathMacroTemplate const & parent,
70 void metrics(MetricsInfo & mi, Dimension & dim) const;
72 void draw(PainterInfo &, int x, int y) const;
76 MathMacroTemplate const & parent_;
78 Inset * clone() const;
80 docstring const label_;
86 InsetLabelBox::InsetLabelBox(Buffer * buf, MathAtom const & atom, docstring label,
87 MathMacroTemplate const & parent, bool frame)
88 : InsetMathNest(buf, 1), parent_(parent), label_(label), frame_(frame)
90 cell(0).insert(0, atom);
94 InsetLabelBox::InsetLabelBox(Buffer * buf, docstring label,
95 MathMacroTemplate const & parent, bool frame)
96 : InsetMathNest(buf, 1), parent_(parent), label_(label), frame_(frame)
101 Inset * InsetLabelBox::clone() const
103 return new InsetLabelBox(*this);
107 void InsetLabelBox::metrics(MetricsInfo & mi, Dimension & dim) const
110 cell(0).metrics(mi, dim);
119 // adjust to common height in main metrics phase
120 if (!parent_.premetrics()) {
121 dim.asc = max(dim.asc, parent_.commonLabelBoxAscent());
122 dim.des = max(dim.des, parent_.commonLabelBoxDescent());
126 if (parent_.editing(mi.base.bv) && label_.length() > 0) {
128 FontInfo font = sane_font;
129 font.setSize(FONT_SIZE_TINY);
130 font.setColor(Color_mathmacrolabel);
132 // make space for label and box
133 int lwid = mathed_string_width(font, label_);
136 math_font_max_dim(font, maxasc, maxdes);
138 dim.wid = max(dim.wid, lwid + 2);
140 // space for the label
141 if (!parent_.premetrics())
142 dim.des += maxasc + maxdes + 1;
147 void InsetLabelBox::draw(PainterInfo & pi, int x, int y) const
149 Dimension const dim = dimension(*pi.base.bv);
150 Dimension const cdim = cell(0).dimension(*pi.base.bv);
153 cell(0).draw(pi, x + (dim.wid - cdim.wid) / 2, y);
156 if (parent_.editing(pi.base.bv) && label_.length() > 0) {
158 FontInfo font = sane_font;
159 font.setSize(FONT_SIZE_TINY);
160 font.setColor(Color_mathmacrolabel);
162 // make space for label and box
163 int lwid = mathed_string_width(font, label_);
166 math_font_max_dim(font, maxasc, maxdes);
169 pi.pain.text(x + (dim.wid - lwid) / 2, y + dim.des - maxdes, label_, font);
171 pi.pain.text(x, y + dim.des - maxdes, label_, font);
175 int boxHeight = parent_.commonLabelBoxAscent() + parent_.commonLabelBoxDescent();
177 pi.pain.rectangle(x + 1, y - dim.ascent() + 1,
178 dim.wid - 2, boxHeight - 2,
184 //////////////////////////////////////////////////////////////////////
186 class DisplayLabelBox : public InsetLabelBox {
189 DisplayLabelBox(Buffer * buf, MathAtom const & atom, docstring label,
190 MathMacroTemplate const & parent);
193 void metrics(MetricsInfo & mi, Dimension & dim) const;
195 void draw(PainterInfo &, int x, int y) const;
199 Inset * clone() const;
203 DisplayLabelBox::DisplayLabelBox(Buffer * buf, MathAtom const & atom,
205 MathMacroTemplate const & parent)
206 : InsetLabelBox(buf, atom, label, parent, true)
212 Inset * DisplayLabelBox::clone() const
214 return new DisplayLabelBox(*this);
218 void DisplayLabelBox::metrics(MetricsInfo & mi, Dimension & dim) const
220 InsetLabelBox::metrics(mi, dim);
221 if (!parent_.editing(mi.base.bv)
222 && parent_.cell(parent_.displayIdx()).empty()) {
230 void DisplayLabelBox::draw(PainterInfo & pi, int x, int y) const
232 if (parent_.editing(pi.base.bv)
233 || !parent_.cell(parent_.displayIdx()).empty()) {
234 InsetLabelBox::draw(pi, x, y);
236 bool enabled = pi.pain.isDrawingEnabled();
237 pi.pain.setDrawingEnabled(false);
238 InsetLabelBox::draw(pi, x, y);
239 pi.pain.setDrawingEnabled(enabled);
244 //////////////////////////////////////////////////////////////////////
246 class InsetMathWrapper : public InsetMath {
249 InsetMathWrapper(MathData const * value) : value_(value) {}
251 void metrics(MetricsInfo & mi, Dimension & dim) const;
253 void draw(PainterInfo &, int x, int y) const;
257 Inset * clone() const;
259 MathData const * value_;
263 Inset * InsetMathWrapper::clone() const
265 return new InsetMathWrapper(*this);
269 void InsetMathWrapper::metrics(MetricsInfo & mi, Dimension & dim) const
271 value_->metrics(mi, dim);
272 //metricsMarkers2(dim);
276 void InsetMathWrapper::draw(PainterInfo & pi, int x, int y) const
278 value_->draw(pi, x, y);
279 //drawMarkers(pi, x, y);
283 ///////////////////////////////////////////////////////////////////////
284 class InsetColoredCell : public InsetMathNest {
287 InsetColoredCell(Buffer * buf, ColorCode min, ColorCode max);
289 InsetColoredCell(Buffer * buf, ColorCode min, ColorCode max, MathAtom const & atom);
291 void draw(PainterInfo &, int x, int y) const;
293 void metrics(MetricsInfo & mi, Dimension & dim) const;
297 Inset * clone() const;
305 InsetColoredCell::InsetColoredCell(Buffer * buf, ColorCode min, ColorCode max)
306 : InsetMathNest(buf, 1), min_(min), max_(max)
311 InsetColoredCell::InsetColoredCell(Buffer * buf, ColorCode min, ColorCode max, MathAtom const & atom)
312 : InsetMathNest(buf, 1), min_(min), max_(max)
314 cell(0).insert(0, atom);
318 Inset * InsetColoredCell::clone() const
320 return new InsetColoredCell(*this);
324 void InsetColoredCell::metrics(MetricsInfo & mi, Dimension & dim) const
326 cell(0).metrics(mi, dim);
330 void InsetColoredCell::draw(PainterInfo & pi, int x, int y) const
332 pi.pain.enterMonochromeMode(min_, max_);
333 cell(0).draw(pi, x, y);
334 pi.pain.leaveMonochromeMode();
338 ///////////////////////////////////////////////////////////////////////
340 class InsetNameWrapper : public InsetMathWrapper {
343 InsetNameWrapper(MathData const * value, MathMacroTemplate const & parent);
345 void metrics(MetricsInfo & mi, Dimension & dim) const;
347 void draw(PainterInfo &, int x, int y) const;
351 MathMacroTemplate const & parent_;
353 Inset * clone() const;
357 InsetNameWrapper::InsetNameWrapper(MathData const * value,
358 MathMacroTemplate const & parent)
359 : InsetMathWrapper(value), parent_(parent)
364 Inset * InsetNameWrapper::clone() const
366 return new InsetNameWrapper(*this);
370 void InsetNameWrapper::metrics(MetricsInfo & mi, Dimension & dim) const
372 InsetMathWrapper::metrics(mi, dim);
373 dim.wid += mathed_string_width(mi.base.font, from_ascii("\\"));
377 void InsetNameWrapper::draw(PainterInfo & pi, int x, int y) const
380 PainterInfo namepi = pi;
381 if (parent_.validMacro())
382 namepi.base.font.setColor(Color_latex);
384 namepi.base.font.setColor(Color_error);
387 pi.pain.text(x, y, from_ascii("\\"), namepi.base.font);
388 x += mathed_string_width(namepi.base.font, from_ascii("\\"));
391 InsetMathWrapper::draw(namepi, x, y);
395 ///////////////////////////////////////////////////////////////////////
398 MathMacroTemplate::MathMacroTemplate(Buffer * buf)
399 : InsetMathNest(buf, 3), numargs_(0), argsInLook_(0), optionals_(0),
400 type_(MacroTypeNewcommand), redefinition_(false), lookOutdated_(true),
401 premetrics_(false), labelBoxAscent_(0), labelBoxDescent_(0)
407 MathMacroTemplate::MathMacroTemplate(Buffer * buf, docstring const & name, int numargs,
408 int optionals, MacroType type, vector<MathData> const & optionalValues,
409 MathData const & def, MathData const & display)
410 : InsetMathNest(buf, optionals + 3), numargs_(numargs), argsInLook_(numargs),
411 optionals_(optionals), optionalValues_(optionalValues),
412 type_(type), redefinition_(false), lookOutdated_(true),
413 premetrics_(false), labelBoxAscent_(0), labelBoxDescent_(0)
418 lyxerr << "MathMacroTemplate::MathMacroTemplate: wrong # of arguments: "
421 asArray(name, cell(0));
422 optionalValues_.resize(9);
423 for (int i = 0; i < optionals_; ++i)
424 cell(optIdx(i)) = optionalValues_[i];
425 cell(defIdx()) = def;
426 cell(displayIdx()) = display;
432 bool MathMacroTemplate::fromString(docstring const & str)
434 MathData ar(buffer_);
435 mathed_parse_cell(ar, str, Parse::NORMAL);
436 if (ar.size() != 1 || !ar[0]->asMacroTemplate()) {
437 lyxerr << "Cannot read macro from '" << ar << "'" << endl;
438 asArray(from_ascii("invalidmacro"), cell(0));
439 // The macro template does not make sense after this.
442 operator=( *(ar[0]->asMacroTemplate()) );
449 Inset * MathMacroTemplate::clone() const
451 MathMacroTemplate * inset = new MathMacroTemplate(*this);
452 // the parent pointers of the proxy insets above will point to
453 // to the old template. Hence, the look must be updated.
459 docstring MathMacroTemplate::name() const
461 return asString(cell(0));
465 void MathMacroTemplate::updateToContext(MacroContext const & mc)
467 redefinition_ = mc.get(name()) != 0;
471 void MathMacroTemplate::updateLook() const
473 lookOutdated_ = true;
477 void MathMacroTemplate::createLook(int args) const
483 look_.push_back(MathAtom(
484 new InsetLabelBox(buffer_, _("Name"), *this, false)));
485 MathData & nameData = look_[look_.size() - 1].nucleus()->cell(0);
486 nameData.push_back(MathAtom(new InsetNameWrapper(&cell(0), *this)));
490 if (optionals_ > 0) {
491 look_.push_back(MathAtom(
492 new InsetLabelBox(buffer_, _("optional"), *this, false)));
494 MathData * optData = &look_[look_.size() - 1].nucleus()->cell(0);
495 for (; i < optionals_; ++i) {
496 // color it light grey, if it is to be removed when the cursor leaves
497 if (i == argsInLook_) {
498 optData->push_back(MathAtom(
499 new InsetColoredCell(buffer_, Color_mathbg, Color_mathmacrooldarg)));
500 optData = &(*optData)[optData->size() - 1].nucleus()->cell(0);
503 optData->push_back(MathAtom(new InsetMathChar('[')));
504 optData->push_back(MathAtom(new InsetMathWrapper(&cell(1 + i))));
505 optData->push_back(MathAtom(new InsetMathChar(']')));
510 for (; i < numargs_; ++i) {
512 arg.push_back(MathAtom(new MathMacroArgument(i + 1)));
513 if (i >= argsInLook_) {
514 look_.push_back(MathAtom(new InsetColoredCell(buffer_,
515 Color_mathbg, Color_mathmacrooldarg,
516 MathAtom(new InsetMathBrace(arg)))));
518 look_.push_back(MathAtom(new InsetMathBrace(arg)));
520 for (; i < argsInLook_; ++i) {
522 arg.push_back(MathAtom(new MathMacroArgument(i + 1)));
523 look_.push_back(MathAtom(new InsetColoredCell(buffer_,
524 Color_mathbg, Color_mathmacronewarg,
525 MathAtom(new InsetMathBrace(arg)))));
529 look_.push_back(MathAtom(new InsetMathChar(':')));
530 look_.push_back(MathAtom(new InsetMathChar('=')));
533 look_.push_back(MathAtom(
534 new InsetLabelBox(buffer_, MathAtom(
535 new InsetMathWrapper(&cell(defIdx()))), _("TeX"), *this, true)));
538 look_.push_back(MathAtom(
539 new DisplayLabelBox(buffer_, MathAtom(
540 new InsetMathWrapper(&cell(displayIdx()))), _("LyX"), *this)));
544 void MathMacroTemplate::metrics(MetricsInfo & mi, Dimension & dim) const
546 Changer dummy1 = mi.base.changeFontSet("mathnormal");
547 Changer dummy2 = mi.base.changeStyle(LM_ST_TEXT);
550 MacroData const * macro = 0;
552 macro = mi.macrocontext.get(name());
555 int argsInDef = maxArgumentInDefinition();
556 if (lookOutdated_ || argsInDef != argsInLook_) {
557 lookOutdated_ = false;
558 createLook(argsInDef);
561 /// metrics for inset contents
565 // first phase, premetric:
567 look_.metrics(mi, dim);
568 labelBoxAscent_ = dim.asc;
569 labelBoxDescent_ = dim.des;
571 // second phase, main metric:
573 look_.metrics(mi, dim);
582 setDimCache(mi, dim);
586 void MathMacroTemplate::drawBackground(PainterInfo & pi, int x, int y) const
590 Dimension const dim = dimension(*pi.base.bv);
591 pi.pain.fillRectangle(x, y - dim.asc, dim.wid, dim.asc + dim.des,
592 pi.backgroundColor(this));
597 void MathMacroTemplate::draw(PainterInfo & pi, int x, int y) const
599 // FIXME: Calling Changer on the same object repeatedly is inefficient.
600 Changer dummy0 = pi.base.font.changeColor(Color_math);
601 Changer dummy1 = pi.base.changeFontSet("mathnormal");
602 Changer dummy2 = pi.base.changeStyle(LM_ST_TEXT);
604 setPosCache(pi, x, y);
605 Dimension const dim = dimension(*pi.base.bv);
608 int const a = y - dim.asc + 1;
609 int const w = dim.wid - 2;
610 int const h = dim.height() - 2;
611 pi.pain.rectangle(x, a, w, h, Color_mathframe);
613 // just to be sure: set some dummy values for coord cache
614 for (idx_type i = 0; i < nargs(); ++i)
615 cell(i).setXY(*pi.base.bv, x, y);
618 look_.draw(pi, x + 3, y);
622 void MathMacroTemplate::edit(Cursor & cur, bool front, EntryDirection entry_from)
625 cur.screenUpdateFlags(Update::SinglePar);
626 InsetMathNest::edit(cur, front, entry_from);
630 bool MathMacroTemplate::notifyCursorLeaves(Cursor const & old, Cursor & cur)
632 unsigned int const nargs_before = nargs();
633 commitEditChanges(cur, old);
635 cur.screenUpdateFlags(Update::Force);
636 // If we have removed a cell, we might have invalidated the cursor
637 return InsetMathNest::notifyCursorLeaves(old, cur)
638 || nargs() < nargs_before;
642 void MathMacroTemplate::removeArguments(Cursor & cur,
643 DocIterator const & /*inset_pos*/, int from, int to)
645 DocIterator it = doc_iterator_begin(&buffer(), this);
646 for (; it; it.forwardChar()) {
649 if (it.nextInset()->lyxCode() != MATH_MACROARG_CODE)
651 MathMacroArgument * arg = static_cast<MathMacroArgument*>(it.nextInset());
652 int n = arg->number() - 1;
653 if (from <= n && n <= to) {
654 int cellSlice = cur.find(it.cell());
655 if (cellSlice != -1 && cur[cellSlice].pos() > it.pos())
656 --cur[cellSlice].pos();
658 it.cell().erase(it.pos());
666 void MathMacroTemplate::shiftArguments(size_t from, int by)
668 for (DocIterator it = doc_iterator_begin(&buffer(), this); it; it.forwardChar()) {
671 if (it.nextInset()->lyxCode() != MATH_MACROARG_CODE)
673 MathMacroArgument * arg = static_cast<MathMacroArgument*>(it.nextInset());
674 if (arg->number() >= int(from) + 1)
675 arg->setNumber(arg->number() + by);
682 int MathMacroTemplate::maxArgumentInDefinition() const
684 // We don't have a buffer when pasting from the clipboard (bug 6014).
685 Buffer const * macro_buffer = isBufferLoaded() ? &buffer() : 0;
687 DocIterator it = doc_iterator_begin(macro_buffer, this);
689 for (; it; it.forwardChar()) {
692 if (it.nextInset()->lyxCode() != MATH_MACROARG_CODE)
694 MathMacroArgument * arg = static_cast<MathMacroArgument*>(it.nextInset());
695 maxArg = std::max(int(arg->number()), maxArg);
701 void MathMacroTemplate::insertMissingArguments(int maxArg)
703 bool found[9] = { false, false, false, false, false, false, false, false, false };
704 idx_type idx = cell(displayIdx()).empty() ? defIdx() : displayIdx();
706 // search for #n macros arguments
707 DocIterator it = doc_iterator_begin(&buffer(), this);
709 for (; it && it[0].idx() == idx; it.forwardChar()) {
712 if (it.nextInset()->lyxCode() != MATH_MACROARG_CODE)
714 MathMacroArgument * arg = static_cast<MathMacroArgument*>(it.nextInset());
715 found[arg->number() - 1] = true;
719 for (int i = 0; i < maxArg; ++i) {
723 cell(idx).push_back(MathAtom(new MathMacroArgument(i + 1)));
728 void MathMacroTemplate::changeArity(Cursor & cur,
729 DocIterator const & inset_pos, int newNumArg)
731 // remove parameter which do not appear anymore in the definition
732 for (int i = numargs_; i > newNumArg; --i)
733 removeParameter(cur, inset_pos, numargs_ - 1, true);
735 // add missing parameter
736 for (int i = numargs_; i < newNumArg; ++i)
737 insertParameter(cur, inset_pos, numargs_, true, false);
742 class AddRemoveMacroInstanceFix
746 AddRemoveMacroInstanceFix(int n, bool insert) : n_(n), insert_(insert) {}
748 void operator()(MathMacro * macro)
750 if (macro->folded()) {
752 macro->insertArgument(n_);
754 macro->removeArgument(n_);
767 class OptionalsMacroInstanceFix
771 OptionalsMacroInstanceFix(int optionals) : optionals_(optionals) {}
773 void operator()(MathMacro * macro)
775 macro->setOptionals(optionals_);
785 class NullMacroInstanceFix
789 void operator()(MathMacro * ) {}
794 void fixMacroInstances(Cursor & cur, DocIterator const & inset_pos,
795 docstring const & name, F & fix)
797 // goto position behind macro template
798 DocIterator dit = inset_pos;
800 dit.top().forwardPos();
802 // remember hull to trigger preview reload
803 DocIterator hull(dit.buffer());
804 bool preview_reload_needed = false;
805 set<DocIterator> preview_hulls;
807 // iterate over all positions until macro is redefined
808 for (; dit; dit.forwardPos()) {
809 // left the outer hull?
810 if (!hull.empty() && dit.depth() == hull.depth()) {
811 // schedule reload of the preview if necessary
812 if (preview_reload_needed) {
813 preview_hulls.insert(hull);
814 preview_reload_needed = false;
819 // only until a macro is redefined
820 if (dit.inset().lyxCode() == MATHMACRO_CODE) {
821 MathMacroTemplate const & macroTemplate
822 = static_cast<MathMacroTemplate const &>(dit.inset());
823 if (macroTemplate.name() == name)
827 // in front of macro instance?
828 Inset * inset = dit.nextInset();
831 InsetMath * insetMath = inset->asInsetMath();
835 // in front of outer hull?
836 InsetMathHull * inset_hull = insetMath->asHullInset();
837 if (inset_hull && hull.empty()) {
838 // remember this for later preview reload
842 MathMacro * macro = insetMath->asMacro();
843 if (macro && macro->name() == name && macro->folded()) {
845 if (RenderPreview::previewMath())
846 preview_reload_needed = true;
850 if (!preview_hulls.empty()) {
851 // reload the scheduled previews
852 set<DocIterator>::const_iterator sit = preview_hulls.begin();
853 set<DocIterator>::const_iterator end = preview_hulls.end();
854 for (; sit != end; ++sit) {
855 InsetMathHull * inset_hull =
856 sit->nextInset()->asInsetMath()->asHullInset();
858 inset_hull->reloadPreview(*sit);
860 cur.screenUpdateFlags(Update::Force);
865 void MathMacroTemplate::commitEditChanges(Cursor & cur,
866 DocIterator const & inset_pos)
868 int args_in_def = maxArgumentInDefinition();
869 if (args_in_def != numargs_) {
870 // FIXME: implement precise undo handling (only a few places
872 cur.recordUndoFullBuffer();
873 changeArity(cur, inset_pos, args_in_def);
875 insertMissingArguments(args_in_def);
877 // make sure the preview are up to date
878 NullMacroInstanceFix fix;
879 fixMacroInstances(cur, inset_pos, name(), fix);
883 void MathMacroTemplate::insertParameter(Cursor & cur,
884 DocIterator const & inset_pos, int pos, bool greedy, bool addarg)
886 if (pos <= numargs_ && pos >= optionals_ && numargs_ < 9) {
891 shiftArguments(pos, 1);
893 cell(defIdx()).push_back(MathAtom(new MathMacroArgument(pos + 1)));
894 if (!cell(displayIdx()).empty())
895 cell(displayIdx()).push_back(MathAtom(new MathMacroArgument(pos + 1)));
899 // fix macro instances
900 AddRemoveMacroInstanceFix fix(pos, true);
901 fixMacroInstances(cur, inset_pos, name(), fix);
909 void MathMacroTemplate::removeParameter(Cursor & cur,
910 DocIterator const & inset_pos, int pos, bool greedy)
912 if (pos < numargs_ && pos >= 0) {
914 removeArguments(cur, inset_pos, pos, pos);
915 shiftArguments(pos + 1, -1);
917 // removed optional parameter?
918 if (pos < optionals_) {
920 optionalValues_[pos] = cell(optIdx(pos));
921 cells_.erase(cells_.begin() + optIdx(pos));
924 int macroSlice = cur.find(this);
925 if (macroSlice != -1) {
926 if (cur[macroSlice].idx() == optIdx(pos)) {
927 cur.cutOff(macroSlice);
928 cur[macroSlice].idx() = 1;
929 cur[macroSlice].pos() = 0;
930 } else if (cur[macroSlice].idx() > optIdx(pos))
931 --cur[macroSlice].idx();
936 // fix macro instances
937 AddRemoveMacroInstanceFix fix(pos, false);
938 fixMacroInstances(cur, inset_pos, name(), fix);
946 void MathMacroTemplate::makeOptional(Cursor & cur,
947 DocIterator const & inset_pos)
949 if (numargs_ > 0 && optionals_ < numargs_) {
951 cells_.insert(cells_.begin() + optIdx(optionals_ - 1), optionalValues_[optionals_ - 1]);
953 int macroSlice = cur.find(this);
954 if (macroSlice != -1 && cur[macroSlice].idx() >= optIdx(optionals_ - 1))
955 ++cur[macroSlice].idx();
957 // fix macro instances
958 OptionalsMacroInstanceFix fix(optionals_);
959 fixMacroInstances(cur, inset_pos, name(), fix);
966 void MathMacroTemplate::makeNonOptional(Cursor & cur,
967 DocIterator const & inset_pos)
969 if (numargs_ > 0 && optionals_ > 0) {
972 // store default value for later if the user changes his mind
973 optionalValues_[optionals_] = cell(optIdx(optionals_));
974 cells_.erase(cells_.begin() + optIdx(optionals_));
977 int macroSlice = cur.find(this);
978 if (macroSlice != -1) {
979 if (cur[macroSlice].idx() > optIdx(optionals_))
980 --cur[macroSlice].idx();
981 else if (cur[macroSlice].idx() == optIdx(optionals_)) {
982 cur.cutOff(macroSlice);
983 cur[macroSlice].idx() = optIdx(optionals_);
984 cur[macroSlice].pos() = 0;
988 // fix macro instances
989 OptionalsMacroInstanceFix fix(optionals_);
990 fixMacroInstances(cur, inset_pos, name(), fix);
997 void MathMacroTemplate::doDispatch(Cursor & cur, FuncRequest & cmd)
999 string const arg = to_utf8(cmd.argument());
1000 switch (cmd.action()) {
1002 case LFUN_MATH_MACRO_ADD_PARAM:
1004 commitEditChanges(cur, cur);
1005 // FIXME: implement precise undo handling (only a few places
1007 cur.recordUndoFullBuffer();
1008 size_t pos = numargs_;
1010 pos = (size_t)convert<int>(arg) - 1; // it is checked for >=0 in getStatus
1011 insertParameter(cur, cur, pos);
1016 case LFUN_MATH_MACRO_REMOVE_PARAM:
1018 commitEditChanges(cur, cur);
1019 // FIXME: implement precise undo handling (only a few places
1021 cur.recordUndoFullBuffer();
1022 size_t pos = numargs_ - 1;
1024 pos = (size_t)convert<int>(arg) - 1; // it is checked for >=0 in getStatus
1025 removeParameter(cur, cur, pos);
1029 case LFUN_MATH_MACRO_APPEND_GREEDY_PARAM:
1031 commitEditChanges(cur, cur);
1032 // FIXME: implement precise undo handling (only a few places
1034 cur.recordUndoFullBuffer();
1035 insertParameter(cur, cur, numargs_, true);
1039 case LFUN_MATH_MACRO_REMOVE_GREEDY_PARAM:
1041 commitEditChanges(cur, cur);
1042 // FIXME: implement precise undo handling (only a few places
1044 cur.recordUndoFullBuffer();
1045 removeParameter(cur, cur, numargs_ - 1, true);
1049 case LFUN_MATH_MACRO_MAKE_OPTIONAL:
1050 commitEditChanges(cur, cur);
1051 // FIXME: implement precise undo handling (only a few places
1053 cur.recordUndoFullBuffer();
1054 makeOptional(cur, cur);
1057 case LFUN_MATH_MACRO_MAKE_NONOPTIONAL:
1058 commitEditChanges(cur, cur);
1059 // FIXME: implement precise undo handling (only a few places
1061 cur.recordUndoFullBuffer();
1062 makeNonOptional(cur, cur);
1065 case LFUN_MATH_MACRO_ADD_OPTIONAL_PARAM:
1067 commitEditChanges(cur, cur);
1068 // FIXME: implement precise undo handling (only a few places
1070 cur.recordUndoFullBuffer();
1071 insertParameter(cur, cur, optionals_);
1072 makeOptional(cur, cur);
1076 case LFUN_MATH_MACRO_REMOVE_OPTIONAL_PARAM:
1077 if (optionals_ > 0) {
1078 commitEditChanges(cur, cur);
1079 // FIXME: implement precise undo handling (only a few places
1081 cur.recordUndoFullBuffer();
1082 removeParameter(cur, cur, optionals_ - 1);
1085 case LFUN_MATH_MACRO_ADD_GREEDY_OPTIONAL_PARAM:
1086 if (numargs_ == optionals_) {
1087 commitEditChanges(cur, cur);
1088 // FIXME: implement precise undo handling (only a few places
1090 cur.recordUndoFullBuffer();
1091 insertParameter(cur, cur, 0, true);
1092 makeOptional(cur, cur);
1097 InsetMathNest::doDispatch(cur, cmd);
1103 bool MathMacroTemplate::getStatus(Cursor & cur, FuncRequest const & cmd,
1104 FuncStatus & flag) const
1107 string const arg = to_utf8(cmd.argument());
1108 switch (cmd.action()) {
1109 case LFUN_MATH_MACRO_ADD_PARAM: {
1110 int num = numargs_ + 1;
1112 num = convert<int>(arg);
1113 bool on = (num >= optionals_
1114 && numargs_ < 9 && num <= numargs_ + 1);
1115 flag.setEnabled(on);
1119 case LFUN_MATH_MACRO_APPEND_GREEDY_PARAM:
1120 flag.setEnabled(numargs_ < 9);
1123 case LFUN_MATH_MACRO_REMOVE_GREEDY_PARAM:
1124 case LFUN_MATH_MACRO_REMOVE_PARAM: {
1127 num = convert<int>(arg);
1128 flag.setEnabled(num >= 1 && num <= numargs_);
1132 case LFUN_MATH_MACRO_MAKE_OPTIONAL:
1133 flag.setEnabled(numargs_ > 0
1134 && optionals_ < numargs_
1135 && type_ != MacroTypeDef);
1138 case LFUN_MATH_MACRO_MAKE_NONOPTIONAL:
1139 flag.setEnabled(optionals_ > 0
1140 && type_ != MacroTypeDef);
1143 case LFUN_MATH_MACRO_ADD_OPTIONAL_PARAM:
1144 flag.setEnabled(numargs_ < 9);
1147 case LFUN_MATH_MACRO_REMOVE_OPTIONAL_PARAM:
1148 flag.setEnabled(optionals_ > 0);
1151 case LFUN_MATH_MACRO_ADD_GREEDY_OPTIONAL_PARAM:
1152 flag.setEnabled(numargs_ == 0
1153 && type_ != MacroTypeDef);
1156 case LFUN_IN_MATHMACROTEMPLATE:
1157 flag.setEnabled(true);
1161 ret = InsetMathNest::getStatus(cur, cmd, flag);
1168 void MathMacroTemplate::read(Lexer & lex)
1170 MathData ar(buffer_);
1171 mathed_parse_cell(ar, lex.getStream(), Parse::TRACKMACRO);
1172 if (ar.size() != 1 || !ar[0]->asMacroTemplate()) {
1173 lyxerr << "Cannot read macro from '" << ar << "'" << endl;
1174 lyxerr << "Read: " << to_utf8(asString(ar)) << endl;
1177 operator=( *(ar[0]->asMacroTemplate()) );
1183 void MathMacroTemplate::write(ostream & os) const
1185 odocstringstream oss;
1186 otexrowstream ots(oss, false);
1187 WriteStream wi(ots, false, false, WriteStream::wsDefault);
1188 oss << "FormulaMacro\n";
1190 os << to_utf8(oss.str());
1194 void MathMacroTemplate::write(WriteStream & os) const
1200 int MathMacroTemplate::write(WriteStream & os, bool overwriteRedefinition) const
1205 if (optionals_ > 0) {
1206 // macros with optionals use the xargs package, e.g.:
1207 // \newcommandx{\foo}[2][usedefault, addprefix=\global,1=default]{#1,#2}
1208 // \long is implicit by xargs
1209 if (redefinition_ && !overwriteRedefinition)
1210 os << "\\renewcommandx";
1212 os << "\\newcommandx";
1214 os << "\\" << name()
1215 << "[" << numargs_ << "]"
1216 << "[usedefault, addprefix=\\global";
1217 for (int i = 0; i < optionals_; ++i) {
1218 docstring optValue = asString(cell(optIdx(i)));
1219 if (optValue.find(']') != docstring::npos
1220 || optValue.find(',') != docstring::npos)
1221 os << ", " << i + 1 << "="
1222 << "{" << cell(optIdx(i)) << "}";
1224 os << ", " << i + 1 << "="
1229 // Macros without optionals use standard _global_ \def macros:
1230 // \global\def\long\foo#1#2{#1,#2}
1231 // We use the \long prefix as this is the equivalent to \newcommand.
1232 // We cannot use \newcommand directly because \global does not work with it.
1233 os << "\\global\\long\\def\\" << name();
1234 docstring param = from_ascii("#0");
1235 for (int i = 1; i <= numargs_; ++i) {
1241 // in LyX output we use some pseudo syntax which is implementation
1242 // independent, e.g.
1243 // \newcommand{\foo}[2][default]{#1,#2}
1244 if (redefinition_ && !overwriteRedefinition)
1245 os << "\\renewcommand";
1247 os << "\\newcommand";
1248 os << "{\\" << name() << '}';
1250 os << '[' << numargs_ << ']';
1252 for (int i = 0; i < optionals_; ++i) {
1253 docstring optValue = asString(cell(optIdx(i)));
1254 if (optValue.find(']') != docstring::npos)
1255 os << "[{" << cell(optIdx(i)) << "}]";
1257 os << "[" << cell(optIdx(i)) << "]";
1261 os << "{" << cell(defIdx()) << "}";
1264 // writing .tex. done.
1268 // writing .lyx, write special .tex export only if necessary
1269 if (!cell(displayIdx()).empty()) {
1270 os << "\n{" << cell(displayIdx()) << '}';
1279 docstring MathMacroTemplate::xhtml(XHTMLStream &, OutputParams const &) const
1284 int MathMacroTemplate::plaintext(odocstringstream & os,
1285 OutputParams const &, size_t) const
1287 docstring const str = '[' + buffer().B_("math macro") + ']';
1294 bool MathMacroTemplate::validName() const
1296 docstring n = name();
1301 // converting back and force doesn't swallow anything?
1304 if (asString(ma) != n)
1307 // valid characters?
1308 for (size_t i = 0; i < n.size(); ++i) {
1309 if (!(n[i] >= 'a' && n[i] <= 'z')
1310 && !(n[i] >= 'A' && n[i] <= 'Z')
1319 bool MathMacroTemplate::validMacro() const
1325 bool MathMacroTemplate::fixNameAndCheckIfValid()
1327 // check all the characters/insets in the name cell
1329 MathData & data = cell(0);
1330 while (i < data.size()) {
1331 InsetMathChar const * cinset = data[i]->asCharInset();
1333 // valid character in [a-zA-Z]?
1334 char_type c = cinset->getChar();
1335 if ((c >= 'a' && c <= 'z')
1336 || (c >= 'A' && c <= 'Z')) {
1346 // now it should be valid if anything in the name survived
1347 return !data.empty();
1351 void MathMacroTemplate::validate(LaTeXFeatures & features) const
1353 // we need global optional macro arguments. They are not available
1354 // with \def, and \newcommand does not support global macros. So we
1355 // are bound to xargs also for the single-optional-parameter case.
1357 features.require("xargs");
1360 void MathMacroTemplate::getDefaults(vector<docstring> & defaults) const
1362 defaults.resize(numargs_);
1363 for (int i = 0; i < optionals_; ++i)
1364 defaults[i] = asString(cell(optIdx(i)));
1368 docstring MathMacroTemplate::definition() const
1370 return asString(cell(defIdx()));
1374 docstring MathMacroTemplate::displayDefinition() const
1376 return asString(cell(displayIdx()));
1380 size_t MathMacroTemplate::numArgs() const
1386 size_t MathMacroTemplate::numOptionals() const
1392 void MathMacroTemplate::infoize(odocstream & os) const
1394 os << bformat(_("Math Macro: \\%1$s"), name());
1398 string MathMacroTemplate::contextMenuName() const
1400 return "context-math-macro-definition";
1403 void MathMacroTemplate::addToToc(DocIterator const & pit, bool output_active,
1406 shared_ptr<Toc> toc = buffer().tocBackend().toc("math-macro");
1409 str = bformat(_("Invalid macro! \\%1$s"), name());
1411 str = "\\" + name();
1412 toc->push_back(TocItem(pit, 0, str, output_active));