]> git.lyx.org Git - lyx.git/blob - src/mathed/MathData.cpp
Routines for calculating numerical labels for BibTeX citations.
[lyx.git] / src / mathed / MathData.cpp
1 /**
2  * \file MathData.cpp
3  * This file is part of LyX, the document processor.
4  * Licence details can be found in the file COPYING.
5  *
6  * \author André Pönitz
7  * \author Stefan Schimanski
8  *
9  * Full author contact details are available in file CREDITS.
10  */
11
12 #include <config.h>
13
14 #include "MathData.h"
15
16 #include "InsetMathBrace.h"
17 #include "InsetMathFont.h"
18 #include "InsetMathScript.h"
19 #include "MacroTable.h"
20 #include "MathMacro.h"
21 #include "MathStream.h"
22 #include "MathSupport.h"
23 #include "MetricsInfo.h"
24 #include "ReplaceData.h"
25
26 #include "Buffer.h"
27 #include "BufferView.h"
28 #include "CoordCache.h"
29 #include "Cursor.h"
30
31 #include "mathed/InsetMathUnknown.h"
32
33 #include "support/debug.h"
34 #include "support/docstream.h"
35
36 #include "frontends/FontMetrics.h"
37 #include "frontends/Painter.h"
38
39 #include "support/lassert.h"
40 #include <boost/next_prior.hpp>
41
42 #include <cstdlib>
43
44 using namespace std;
45
46 namespace lyx {
47
48
49 MathData::MathData(Buffer * buf, const_iterator from, const_iterator to)
50         : base_type(from, to), buffer_(buf)
51 {}
52
53
54 MathAtom & MathData::operator[](pos_type pos)
55 {
56         LASSERT(pos < size(), /**/);
57         return base_type::operator[](pos);
58 }
59
60
61 MathAtom const & MathData::operator[](pos_type pos) const
62 {
63         LASSERT(pos < size(), /**/);
64         return base_type::operator[](pos);
65 }
66
67
68 void MathData::insert(size_type pos, MathAtom const & t)
69 {
70         base_type::insert(begin() + pos, t);
71 }
72
73
74 void MathData::insert(size_type pos, MathData const & ar)
75 {
76         LASSERT(pos <= size(), /**/);
77         base_type::insert(begin() + pos, ar.begin(), ar.end());
78 }
79
80
81 void MathData::append(MathData const & ar)
82 {
83         insert(size(), ar);
84 }
85
86
87 void MathData::erase(size_type pos)
88 {
89         if (pos < size())
90                 erase(pos, pos + 1);
91 }
92
93
94 void MathData::erase(iterator pos1, iterator pos2)
95 {
96         base_type::erase(pos1, pos2);
97 }
98
99
100 void MathData::erase(iterator pos)
101 {
102         base_type::erase(pos);
103 }
104
105
106 void MathData::erase(size_type pos1, size_type pos2)
107 {
108         base_type::erase(begin() + pos1, begin() + pos2);
109 }
110
111
112 void MathData::dump2() const
113 {
114         odocstringstream os;
115         NormalStream ns(os);
116         for (const_iterator it = begin(); it != end(); ++it)
117                 ns << *it << ' ';
118         lyxerr << to_utf8(os.str());
119 }
120
121
122 void MathData::dump() const
123 {
124         odocstringstream os;
125         NormalStream ns(os);
126         for (const_iterator it = begin(); it != end(); ++it)
127                 ns << '<' << *it << '>';
128         lyxerr << to_utf8(os.str());
129 }
130
131
132 void MathData::validate(LaTeXFeatures & features) const
133 {
134         for (const_iterator it = begin(); it != end(); ++it)
135                 (*it)->validate(features);
136 }
137
138
139 bool MathData::match(MathData const & ar) const
140 {
141         return size() == ar.size() && matchpart(ar, 0);
142 }
143
144
145 bool MathData::matchpart(MathData const & ar, pos_type pos) const
146 {
147         if (size() < ar.size() + pos)
148                 return false;
149         const_iterator it = begin() + pos;
150         for (const_iterator jt = ar.begin(); jt != ar.end(); ++jt, ++it)
151                 if (asString(*it) != asString(*jt))
152                         return false;
153         return true;
154 }
155
156
157 void MathData::replace(ReplaceData & rep)
158 {
159         for (size_type i = 0; i < size(); ++i) {
160                 if (find1(rep.from, i)) {
161                         // match found
162                         lyxerr << "match found!" << endl;
163                         erase(i, i + rep.from.size());
164                         insert(i, rep.to);
165                 }
166         }
167
168         // FIXME: temporarily disabled
169         // for (const_iterator it = begin(); it != end(); ++it)
170         //      it->nucleus()->replace(rep);
171 }
172
173
174 bool MathData::find1(MathData const & ar, size_type pos) const
175 {
176         lyxerr << "finding '" << ar << "' in '" << *this << "'" << endl;
177         for (size_type i = 0, n = ar.size(); i < n; ++i)
178                 if (asString(operator[](pos + i)) != asString(ar[i]))
179                         return false;
180         return true;
181 }
182
183
184 MathData::size_type MathData::find(MathData const & ar) const
185 {
186         for (int i = 0, last = size() - ar.size(); i < last; ++i)
187                 if (find1(ar, i))
188                         return i;
189         return size();
190 }
191
192
193 MathData::size_type MathData::find_last(MathData const & ar) const
194 {
195         for (int i = size() - ar.size(); i >= 0; --i)
196                 if (find1(ar, i))
197                         return i;
198         return size();
199 }
200
201
202 bool MathData::contains(MathData const & ar) const
203 {
204         if (find(ar) != size())
205                 return true;
206         for (const_iterator it = begin(); it != end(); ++it)
207                 if ((*it)->contains(ar))
208                         return true;
209         return false;
210 }
211
212
213 void MathData::touch() const
214 {
215 }
216
217
218 namespace {
219
220 bool isInside(DocIterator const & it, MathData const & ar,
221         pos_type p1, pos_type p2)
222 {
223         for (size_t i = 0; i != it.depth(); ++i) {
224                 CursorSlice const & sl = it[i];
225                 if (sl.inset().inMathed() && &sl.cell() == &ar)
226                         return p1 <= sl.pos() && sl.pos() < p2;
227         }
228         return false;
229 }
230
231 }
232
233
234
235 void MathData::metrics(MetricsInfo & mi, Dimension & dim) const
236 {
237         frontend::FontMetrics const & fm = theFontMetrics(mi.base.font);
238         dim = fm.dimension('I');
239         int xascent = fm.dimension('x').ascent();
240         if (xascent >= dim.asc)
241                 xascent = (2 * dim.asc) / 3;
242         minasc_ = xascent;
243         mindes_ = (3 * xascent) / 4;
244         slevel_ = (4 * xascent) / 5;
245         sshift_ = xascent / 4;
246         kerning_ = 0;
247
248         if (empty()) {
249                 // Cache the dimension.
250                 mi.base.bv->coordCache().arrays().add(this, dim);
251                 return;
252         }
253
254         Cursor & cur = mi.base.bv->cursor();
255         const_cast<MathData*>(this)->updateMacros(&cur, mi.macrocontext);
256
257         DocIterator const & inlineCompletionPos = mi.base.bv->inlineCompletionPos();
258         MathData const * inlineCompletionData = 0;
259         if (inlineCompletionPos.inMathed())
260                 inlineCompletionData = &inlineCompletionPos.cell();
261
262         dim.asc = 0;
263         dim.wid = 0;
264         Dimension d;
265         CoordCacheBase<Inset> & coords = mi.base.bv->coordCache().insets();
266         for (pos_type i = 0, n = size(); i != n; ++i) {
267                 MathAtom const & at = operator[](i);
268                 at->metrics(mi, d);
269                 coords.add(at.nucleus(), d);
270                 dim += d;
271                 if (i == n - 1)
272                         kerning_ = at->kerning(mi.base.bv);
273                 
274                 // HACK to draw completion suggestion inline
275                 if (inlineCompletionData != this
276                     || size_t(inlineCompletionPos.pos()) != i + 1)
277                         continue;
278                 
279                 docstring const & completion = mi.base.bv->inlineCompletion();
280                 if (completion.length() == 0)
281                         continue;
282                 
283                 dim.wid += mathed_string_width(mi.base.font, completion);
284         }
285         // Cache the dimension.
286         mi.base.bv->coordCache().arrays().add(this, dim);
287 }
288
289
290 void MathData::draw(PainterInfo & pi, int x, int y) const
291 {
292         //lyxerr << "MathData::draw: x: " << x << " y: " << y << endl;
293         BufferView & bv  = *pi.base.bv;
294         setXY(bv, x, y);
295
296         Dimension const & dim = bv.coordCache().getArrays().dim(this);
297
298         if (empty()) {
299                 pi.pain.rectangle(x, y - dim.ascent(), dim.width(), dim.height(), Color_mathline);
300                 return;
301         }
302
303         // don't draw outside the workarea
304         if (y + dim.descent() <= 0
305                 || y - dim.ascent() >= bv.workHeight()
306                 || x + dim.width() <= 0
307                 || x >= bv. workWidth())
308                 return;
309
310         DocIterator const & inlineCompletionPos = bv.inlineCompletionPos();
311         MathData const * inlineCompletionData = 0;
312         if (inlineCompletionPos.inMathed())
313                 inlineCompletionData = &inlineCompletionPos.cell();
314
315         CoordCacheBase<Inset> & coords = pi.base.bv->coordCache().insets();
316         for (size_t i = 0, n = size(); i != n; ++i) {
317                 MathAtom const & at = operator[](i);
318                 coords.add(at.nucleus(), x, y);
319                 at->drawSelection(pi, x, y);
320                 at->draw(pi, x, y);
321                 x += coords.dim(at.nucleus()).wid;
322                 
323                 // Is the inline completion here?
324                 if (inlineCompletionData != this
325                     || size_t(inlineCompletionPos.pos()) != i + 1)
326                         continue;
327                 docstring const & completion = bv.inlineCompletion();
328                 if (completion.length() == 0)
329                         continue;
330                 FontInfo f = pi.base.font;
331                 
332                 // draw the unique and the non-unique completion part
333                 // Note: this is not time-critical as it is
334                 // only done once per screen.
335                 size_t uniqueTo = bv.inlineCompletionUniqueChars();
336                 docstring s1 = completion.substr(0, uniqueTo);
337                 docstring s2 = completion.substr(uniqueTo);
338                 
339                 if (s1.size() > 0) {
340                         f.setColor(Color_inlinecompletion);
341                         pi.pain.text(x, y, s1, f);
342                         x += mathed_string_width(f, s1);
343                 }
344                 
345                 if (s2.size() > 0) {
346                         f.setColor(Color_nonunique_inlinecompletion);
347                         pi.pain.text(x, y, s2, f);
348                         x += mathed_string_width(f, s2);
349                 }
350         }
351 }
352
353
354 void MathData::metricsT(TextMetricsInfo const & mi, Dimension & dim) const
355 {
356         dim.clear();
357         Dimension d;
358         for (const_iterator it = begin(); it != end(); ++it) {
359                 (*it)->metricsT(mi, d);
360                 dim += d;
361         }
362 }
363
364
365 void MathData::drawT(TextPainter & pain, int x, int y) const
366 {
367         //lyxerr << "x: " << x << " y: " << y << ' ' << pain.workAreaHeight() << endl;
368
369         // FIXME: Abdel 16/10/2006
370         // This drawT() method is never used, this is dead code.
371
372         for (const_iterator it = begin(), et = end(); it != et; ++it) {
373                 (*it)->drawT(pain, x, y);
374                 //x += (*it)->width_;
375                 x += 2;
376         }
377 }
378
379
380 void MathData::updateMacros(Cursor * cur, MacroContext const & mc)
381 {
382         // If we are editing a macro, we cannot update it immediately,
383         // otherwise wrong undo steps will be recorded (bug 6208).
384         InsetMath const * inmath = cur ? cur->inset().asInsetMath() : 0;
385         MathMacro const * inmacro = inmath ? inmath->asMacro() : 0;
386         docstring const edited_name = inmacro ? inmacro->name() : docstring();
387
388         // go over the array and look for macros
389         for (size_t i = 0; i < size(); ++i) {
390                 MathMacro * macroInset = operator[](i).nucleus()->asMacro();
391                 if (!macroInset || macroInset->name_[0] == '^'
392                                 || macroInset->name_[0] == '_'
393                                 || macroInset->name() == edited_name)
394                         continue;
395
396                 // get macro
397                 macroInset->updateMacro(mc);
398                 size_t macroNumArgs = 0;
399                 size_t macroOptionals = 0;
400                 MacroData const * macro = macroInset->macro();
401                 if (macro) {
402                         macroNumArgs = macro->numargs();
403                         macroOptionals = macro->optionals();
404                 }
405
406                 // store old and compute new display mode
407                 MathMacro::DisplayMode newDisplayMode;
408                 MathMacro::DisplayMode oldDisplayMode = macroInset->displayMode();
409                 newDisplayMode = macroInset->computeDisplayMode();
410
411                 // arity changed or other reason to detach?
412                 if (oldDisplayMode == MathMacro::DISPLAY_NORMAL
413                     && (macroInset->arity() != macroNumArgs
414                         || macroInset->optionals() != macroOptionals
415                         || newDisplayMode == MathMacro::DISPLAY_UNFOLDED)) {
416
417                         detachMacroParameters(cur, i);
418                         // FIXME: proper anchor handling, this removes the selection
419                         if (cur)
420                                 cur->clearSelection();
421                 }
422
423                 // the macro could have been copied while resizing this
424                 macroInset = operator[](i).nucleus()->asMacro();
425
426                 // Cursor in \label?
427                 if (newDisplayMode != MathMacro::DISPLAY_UNFOLDED 
428                     && oldDisplayMode == MathMacro::DISPLAY_UNFOLDED) {
429                         // put cursor in front of macro
430                         if (cur) {
431                                 int macroSlice = cur->find(macroInset);
432                                 if (macroSlice != -1)
433                                         cur->cutOff(macroSlice - 1);
434                         }
435                 }
436
437                 // update the display mode
438                 size_t appetite = macroInset->appetite();
439                 macroInset->setDisplayMode(newDisplayMode);
440
441                 // arity changed?
442                 if (newDisplayMode == MathMacro::DISPLAY_NORMAL 
443                     && (macroInset->arity() != macroNumArgs
444                         || macroInset->optionals() != macroOptionals)) {
445                         // is it a virgin macro which was never attached to parameters?
446                         bool fromInitToNormalMode
447                         = (oldDisplayMode == MathMacro::DISPLAY_INIT 
448                            || oldDisplayMode == MathMacro::DISPLAY_INTERACTIVE_INIT)
449                           && newDisplayMode == MathMacro::DISPLAY_NORMAL;
450                         
451                         // if the macro was entered interactively (i.e. not by paste or during
452                         // loading), it should not be greedy, but the cursor should
453                         // automatically jump into the macro when behind
454                         bool interactive = (oldDisplayMode == MathMacro::DISPLAY_INTERACTIVE_INIT);
455                         
456                         // attach parameters
457                         attachMacroParameters(cur, i, macroNumArgs, macroOptionals,
458                                 fromInitToNormalMode, interactive, appetite);
459                         
460                         if (cur) {
461                                 // FIXME: proper anchor handling, this removes the selection
462                                 cur->updateInsets(&cur->bottom().inset());
463                                 cur->clearSelection();  
464                         }
465                 }
466
467                 // Give macro the chance to adapt to new situation.
468                 // The macroInset could be invalid now because it was put into a script 
469                 // inset and therefore "deep" copied. So get it again from the MathData.
470                 InsetMath * inset = operator[](i).nucleus();
471                 if (inset->asScriptInset())
472                         inset = inset->asScriptInset()->nuc()[0].nucleus();
473                 LASSERT(inset->asMacro(), /**/);
474                 inset->asMacro()->updateRepresentation();
475         }
476 }
477
478
479 void MathData::detachMacroParameters(DocIterator * cur, const size_type macroPos)
480 {
481         MathMacro * macroInset = operator[](macroPos).nucleus()->asMacro();
482         
483         // detach all arguments
484         vector<MathData> detachedArgs;
485         if (macroPos + 1 == size())
486                 // strip arguments if we are at the MathData end
487                 macroInset->detachArguments(detachedArgs, true);
488         else
489                 macroInset->detachArguments(detachedArgs, false);
490         
491         // find cursor slice
492         int curMacroSlice = -1;
493         if (cur)
494                 curMacroSlice = cur->find(macroInset);
495         idx_type curMacroIdx = -1;
496         pos_type curMacroPos = -1;
497         vector<CursorSlice> argSlices;
498         if (curMacroSlice != -1) {
499                 curMacroPos = (*cur)[curMacroSlice].pos();
500                 curMacroIdx = (*cur)[curMacroSlice].idx();
501                 cur->cutOff(curMacroSlice, argSlices);
502                 cur->pop_back();
503         }
504         
505         // only [] after the last non-empty argument can be dropped later 
506         size_t lastNonEmptyOptional = 0;
507         for (size_t l = 0; l < detachedArgs.size() && l < macroInset->optionals(); ++l) {
508                 if (!detachedArgs[l].empty())
509                         lastNonEmptyOptional = l;
510         }
511         
512         // optional arguments to be put back?
513         pos_type p = macroPos + 1;
514         size_t j = 0;
515         for (; j < detachedArgs.size() && j < macroInset->optionals(); ++j) {
516                 // another non-empty parameter follows?
517                 bool canDropEmptyOptional = j >= lastNonEmptyOptional;
518                 
519                 // then we can drop empty optional parameters
520                 if (detachedArgs[j].empty() && canDropEmptyOptional) {
521                         if (curMacroIdx == j)
522                                 (*cur)[curMacroSlice - 1].pos() = macroPos + 1;
523                         continue;
524                 }
525                 
526                 // Otherwise we don't drop an empty optional, put it back normally
527                 MathData optarg;
528                 asArray(from_ascii("[]"), optarg);
529                 MathData & arg = detachedArgs[j];
530                 
531                 // look for "]", i.e. put a brace around?
532                 InsetMathBrace * brace = 0;
533                 for (size_t q = 0; q < arg.size(); ++q) {
534                         if (arg[q]->getChar() == ']') {
535                                 // put brace
536                                 brace = new InsetMathBrace(buffer_);
537                                 break;
538                         }
539                 }
540                 
541                 // put arg between []
542                 if (brace) {
543                         brace->cell(0) = arg;
544                         optarg.insert(1, MathAtom(brace));
545                 } else
546                         optarg.insert(1, arg);
547                 
548                 // insert it into the array
549                 insert(p, optarg);
550                 p += optarg.size();
551                 
552                 // cursor in macro?
553                 if (curMacroSlice == -1)
554                         continue;
555                 
556                 // cursor in optional argument of macro?
557                 if (curMacroIdx == j) {
558                         if (brace) {
559                                 cur->append(0, curMacroPos);
560                                 (*cur)[curMacroSlice - 1].pos() = macroPos + 2;
561                         } else
562                                 (*cur)[curMacroSlice - 1].pos() = macroPos + 2 + curMacroPos;
563                         cur->append(argSlices);
564                 } else if ((*cur)[curMacroSlice - 1].pos() >= int(p))
565                         // cursor right of macro
566                         (*cur)[curMacroSlice - 1].pos() += optarg.size();
567         }
568         
569         // put them back into the MathData
570         for (; j < detachedArgs.size(); ++j, ++p) {
571                 MathData const & arg = detachedArgs[j];
572                 if (arg.size() == 1 
573                     && !arg[0]->asScriptInset()
574                     && !(arg[0]->asMacro() && arg[0]->asMacro()->arity() > 0))
575                         insert(p, arg[0]);
576                 else
577                         insert(p, MathAtom(new InsetMathBrace(arg)));
578                 
579                 // cursor in macro?
580                 if (curMacroSlice == -1)
581                         continue;
582                 
583                 // cursor in j-th argument of macro?
584                 if (curMacroIdx == j) {
585                         if (operator[](p).nucleus()->asBraceInset()) {
586                                 (*cur)[curMacroSlice - 1].pos() = p;
587                                 cur->append(0, curMacroPos);
588                                 cur->append(argSlices);
589                         } else {
590                                 (*cur)[curMacroSlice - 1].pos() = p; // + macroPos;
591                                 cur->append(argSlices);
592                         }
593                 } else if ((*cur)[curMacroSlice - 1].pos() >= int(p))
594                         ++(*cur)[curMacroSlice - 1].pos();
595         }
596         
597         if (cur)
598                 cur->updateInsets(&cur->bottom().inset());
599 }
600
601
602 void MathData::attachMacroParameters(Cursor * cur, 
603         const size_type macroPos, const size_type macroNumArgs,
604         const int macroOptionals, const bool fromInitToNormalMode,
605         const bool interactiveInit, const size_t appetite)
606 {
607         MathMacro * macroInset = operator[](macroPos).nucleus()->asMacro();
608
609         // start at atom behind the macro again, maybe with some new arguments 
610         // from the detach phase above, to add them back into the macro inset
611         size_t p = macroPos + 1;
612         vector<MathData> detachedArgs;
613         MathAtom scriptToPutAround;
614         
615         // find cursor slice again of this MathData
616         int thisSlice = -1;
617         if (cur)
618                 thisSlice = cur->find(*this);
619         int thisPos = -1;
620         if (thisSlice != -1)
621                 thisPos = (*cur)[thisSlice].pos();
622         
623         // find arguments behind the macro
624         if (!interactiveInit) {
625                 collectOptionalParameters(cur, macroOptionals, detachedArgs, p,
626                         scriptToPutAround, macroPos, thisPos, thisSlice);
627         }
628         collectParameters(cur, macroNumArgs, detachedArgs, p,
629                 scriptToPutAround, macroPos, thisPos, thisSlice, appetite);
630                 
631         // attach arguments back to macro inset
632         macroInset->attachArguments(detachedArgs, macroNumArgs, macroOptionals);
633         
634         // found tail script? E.g. \foo{a}b^x
635         if (scriptToPutAround.nucleus()) {
636                 // put macro into a script inset
637                 scriptToPutAround.nucleus()->asScriptInset()->nuc()[0] 
638                 = operator[](macroPos);
639                 operator[](macroPos) = scriptToPutAround;
640
641                 // go into the script inset nucleus
642                 if (cur && thisPos == int(macroPos))
643                         cur->append(0, 0);
644                 
645                 // get pointer to "deep" copied macro inset
646                 InsetMathScript * scriptInset 
647                 = operator[](macroPos).nucleus()->asScriptInset();
648                 macroInset = scriptInset->nuc()[0].nucleus()->asMacro();        
649         }
650         
651         // remove them from the MathData
652         erase(begin() + macroPos + 1, begin() + p);
653
654         // cursor outside this MathData?
655         if (thisSlice == -1)
656                 return;
657
658         // fix cursor if right of p
659         if (thisPos >= int(p))
660                 (*cur)[thisSlice].pos() -= p - (macroPos + 1);
661         
662         // was the macro inset just inserted interactively and was now folded
663         // and the cursor is just behind?
664         if ((*cur)[thisSlice].pos() == int(macroPos + 1)
665             && interactiveInit
666             && fromInitToNormalMode
667             && macroInset->arity() > 0
668             && thisSlice + 1 == int(cur->depth())) {
669                 // then enter it if the cursor was just behind
670                 (*cur)[thisSlice].pos() = macroPos;
671                 cur->push_back(CursorSlice(*macroInset));
672                 macroInset->idxFirst(*cur);
673         }
674 }
675
676
677 void MathData::collectOptionalParameters(Cursor * cur, 
678         const size_type numOptionalParams, vector<MathData> & params, 
679         size_t & pos, MathAtom & scriptToPutAround,
680         const pos_type macroPos, const int thisPos, const int thisSlice)
681 {
682         Buffer * buf = cur ? cur->buffer() : 0;
683         // insert optional arguments?
684         while (params.size() < numOptionalParams 
685                && pos < size()
686                && !scriptToPutAround.nucleus()) {
687                 // is a [] block following which could be an optional parameter?
688                 if (operator[](pos)->getChar() != '[')
689                         break;
690                 
691                 // found possible optional argument, look for "]"
692                 size_t right = pos + 1;
693                 for (; right < size(); ++right) {
694                         MathAtom & cell = operator[](right);
695
696                         if (cell->getChar() == ']')
697                                 // found right end
698                                 break;
699                         
700                         // maybe "]" with a script around?
701                         InsetMathScript * script = cell.nucleus()->asScriptInset();
702                         if (!script)
703                                 continue;
704                         if (script->nuc().size() != 1)
705                                 continue;
706                         if (script->nuc()[0]->getChar() == ']') {
707                                 // script will be put around the macro later
708                                 scriptToPutAround = cell;
709                                 break;
710                         }
711                 }
712                 
713                 // found?
714                 if (right >= size()) {
715                         // no ] found, so it's not an optional argument
716                         break;
717                 }
718                 
719                 // add everything between [ and ] as optional argument
720                 MathData optarg(buf, begin() + pos + 1, begin() + right);
721                 
722                 // a brace?
723                 bool brace = false;
724                 if (optarg.size() == 1 && optarg[0]->asBraceInset()) {
725                         brace = true;
726                         params.push_back(optarg[0]->asBraceInset()->cell(0));
727                 } else
728                         params.push_back(optarg);
729                 
730                 // place cursor in optional argument of macro
731                 if (thisSlice != -1
732                     && thisPos >= int(pos) && thisPos <= int(right)) {
733                         int paramPos = max(0, thisPos - int(pos) - 1);
734                         vector<CursorSlice> x;
735                         cur->cutOff(thisSlice, x);
736                         (*cur)[thisSlice].pos() = macroPos;
737                         if (brace) {
738                                 paramPos = x[0].pos();
739                                 x.erase(x.begin());
740                         }
741                         cur->append(0, paramPos);
742                         cur->append(x);
743                 }
744                 pos = right + 1;
745         }
746
747         // fill up empty optional parameters
748         while (params.size() < numOptionalParams)
749                 params.push_back(MathData());   
750 }
751
752
753 void MathData::collectParameters(Cursor * cur, 
754         const size_type numParams, vector<MathData> & params, 
755         size_t & pos, MathAtom & scriptToPutAround,
756         const pos_type macroPos, const int thisPos, const int thisSlice,
757         const size_t appetite) 
758 {
759         size_t startSize = params.size();
760         
761         // insert normal arguments
762         while (params.size() < numParams
763                && params.size() - startSize < appetite
764                && pos < size()
765                && !scriptToPutAround.nucleus()) {
766                 MathAtom & cell = operator[](pos);
767                 
768                 // fix cursor
769                 vector<CursorSlice> argSlices;
770                 int argPos = 0;
771                 if (thisSlice != -1 && thisPos == int(pos))
772                         cur->cutOff(thisSlice, argSlices);              
773                 
774                 // which kind of parameter is it? In {}? With index x^n?
775                 InsetMathBrace const * brace = cell->asBraceInset();
776                 if (brace) {
777                         // found brace, convert into argument
778                         params.push_back(brace->cell(0));
779                         
780                         // cursor inside of the brace or just in front of?
781                         if (thisPos == int(pos) && !argSlices.empty()) {
782                                 argPos = argSlices[0].pos();
783                                 argSlices.erase(argSlices.begin());
784                         }
785                 } else if (cell->asScriptInset() && params.size() + 1 == numParams) {
786                         // last inset with scripts without braces
787                         // -> they belong to the macro, not the argument
788                         InsetMathScript * script = cell.nucleus()->asScriptInset();
789                         if (script->nuc().size() == 1 && script->nuc()[0]->asBraceInset())
790                                 // nucleus in brace? Unpack!
791                                 params.push_back(script->nuc()[0]->asBraceInset()->cell(0));
792                         else
793                                 params.push_back(script->nuc());
794                         
795                         // script will be put around below
796                         scriptToPutAround = cell;
797                         
798                         // this should only happen after loading, so make cursor handling simple
799                         if (thisPos >= int(macroPos) && thisPos <= int(macroPos + numParams)) {
800                                 argSlices.clear();
801                                 if (cur)
802                                         cur->append(0, 0);
803                         }
804                 } else {
805                         // the simplest case: plain inset
806                         MathData array;
807                         array.insert(0, cell);
808                         params.push_back(array);
809                 }
810                 
811                 // put cursor in argument again
812                 if (thisSlice != - 1 && thisPos == int(pos)) {
813                         cur->append(params.size() - 1, argPos);
814                         cur->append(argSlices);
815                         (*cur)[thisSlice].pos() = macroPos;
816                 }
817                 
818                 ++pos;
819         }       
820 }
821
822
823 int MathData::pos2x(BufferView const * bv, size_type pos) const
824 {
825         return pos2x(bv, pos, 0);
826 }
827
828
829 int MathData::pos2x(BufferView const * bv, size_type pos, int glue) const
830 {
831         int x = 0;
832         size_type target = min(pos, size());
833         CoordCacheBase<Inset> const & coords = bv->coordCache().getInsets();
834         for (size_type i = 0; i < target; ++i) {
835                 const_iterator it = begin() + i;
836                 if ((*it)->getChar() == ' ')
837                         x += glue;
838                 //lyxerr << "char: " << (*it)->getChar()
839                 //      << "width: " << (*it)->width() << endl;
840                 x += coords.dim((*it).nucleus()).wid;
841         }
842         return x;
843 }
844
845
846 MathData::size_type MathData::x2pos(BufferView const * bv, int targetx) const
847 {
848         return x2pos(bv, targetx, 0);
849 }
850
851
852 MathData::size_type MathData::x2pos(BufferView const * bv, int targetx, int glue) const
853 {
854         const_iterator it = begin();
855         int lastx = 0;
856         int currx = 0;
857         CoordCacheBase<Inset> const & coords = bv->coordCache().getInsets();
858         // find first position after targetx
859         for (; currx < targetx && it < end(); ++it) {
860                 lastx = currx;
861                 if ((*it)->getChar() == ' ')
862                         currx += glue;
863                 currx += coords.dim((*it).nucleus()).wid;
864         }
865
866         /**
867          * If we are not at the beginning of the array, go to the left
868          * of the inset if one of the following two condition holds:
869          * - the current inset is editable (so that the cursor tip is
870          *   deeper than us): in this case, we want all intermediate
871          *   cursor slices to be before insets;
872          * - the mouse is closer to the left side of the inset than to
873          *   the right one.
874          * See bug 1918 for details.
875          **/
876         if (it != begin() && currx >= targetx
877             && ((*boost::prior(it))->asNestInset()
878                 || abs(lastx - targetx) < abs(currx - targetx))) {
879                 --it;
880         }
881
882         return it - begin();
883 }
884
885
886 int MathData::dist(BufferView const & bv, int x, int y) const
887 {
888         return bv.coordCache().getArrays().squareDistance(this, x, y);
889 }
890
891
892 void MathData::setXY(BufferView & bv, int x, int y) const
893 {
894         //lyxerr << "setting position cache for MathData " << this << endl;
895         bv.coordCache().arrays().add(this, x, y);
896 }
897
898
899 Dimension const & MathData::dimension(BufferView const & bv) const
900 {
901         return bv.coordCache().getArrays().dim(this);
902 }
903
904
905 int MathData::xm(BufferView const & bv) const
906 {
907         Geometry const & g = bv.coordCache().getArrays().geometry(this);
908
909         return g.pos.x_ + g.dim.wid / 2;
910 }
911
912
913 int MathData::ym(BufferView const & bv) const
914 {
915         Geometry const & g = bv.coordCache().getArrays().geometry(this);
916
917         return g.pos.y_ + (g.dim.des - g.dim.asc) / 2;
918 }
919
920
921 int MathData::xo(BufferView const & bv) const
922 {
923         return bv.coordCache().getArrays().x(this);
924 }
925
926
927 int MathData::yo(BufferView const & bv) const
928 {
929         return bv.coordCache().getArrays().y(this);
930 }
931
932
933 ostream & operator<<(ostream & os, MathData const & ar)
934 {
935         odocstringstream oss;
936         NormalStream ns(oss);
937         ns << ar;
938         return os << to_utf8(oss.str());
939 }
940
941
942 odocstream & operator<<(odocstream & os, MathData const & ar)
943 {
944         NormalStream ns(os);
945         ns << ar;
946         return os;
947 }
948
949
950 } // namespace lyx