3 * This file is part of LyX, the document processor.
4 * Licence details can be found in the file COPYING.
9 * Full author contact details are available in file CREDITS.
14 #include "rowpainter.h"
18 #include "CoordCache.h"
20 #include "BufferParams.h"
21 #include "BufferView.h"
24 #include "support/gettext.h"
29 #include "MetricsInfo.h"
30 #include "Paragraph.h"
31 #include "ParagraphMetrics.h"
32 #include "paragraph_funcs.h"
33 #include "ParagraphParameters.h"
34 #include "TextMetrics.h"
37 #include "frontends/FontMetrics.h"
38 #include "frontends/Painter.h"
40 #include "insets/InsetText.h"
42 #include "support/debug.h"
43 #include "support/textutils.h"
45 #include <boost/assert.hpp>
46 #include <boost/crc.hpp>
54 using frontend::Painter;
55 using frontend::FontMetrics;
57 RowPainter::RowPainter(PainterInfo & pi,
58 Text const & text, pit_type pit, Row const & row, Bidi & bidi, int x, int y)
59 : pi_(pi), text_(text),
60 text_metrics_(pi_.base.bv->textMetrics(&text)),
61 pars_(text.paragraphs()),
62 row_(row), pit_(pit), par_(text.paragraphs()[pit]),
63 pm_(text_metrics_.parMetrics(pit)),
64 bidi_(bidi), erased_(pi_.erased_),
65 xo_(x), yo_(y), width_(text_metrics_.width())
67 bidi_.computeTables(par_, pi_.base.bv->buffer(), row_);
70 //lyxerr << "RowPainter: x: " << x_ << " xo: " << xo_ << " yo: " << yo_ << endl;
73 BOOST_ASSERT(pit >= 0);
74 BOOST_ASSERT(pit < int(text.paragraphs().size()));
78 FontInfo RowPainter::labelFont() const
80 return text_.labelFont(pi_.base.bv->buffer(), par_);
84 int RowPainter::leftMargin() const
86 return text_metrics_.leftMargin(text_metrics_.width(), pit_,
90 // If you want to debug inset metrics uncomment the following line:
91 //#define DEBUG_METRICS
92 // This draws green lines around each inset.
95 void RowPainter::paintInset(Inset const * inset, pos_type const pos)
97 Font const font = text_metrics_.displayFont(pit_, pos);
100 // Backup full_repaint status because some insets (InsetTabular)
101 // requires a full repaint
102 bool pi_full_repaint = pi_.full_repaint;
104 // FIXME: We should always use font, see documentation of
105 // noFontChange() in Inset.h.
106 pi_.base.font = inset->noFontChange() ?
107 pi_.base.bv->buffer().params().getFont().fontInfo() :
109 pi_.ltr_pos = (bidi_.level(pos) % 2 == 0);
110 pi_.erased_ = erased_ || par_.isDeleted(pos);
111 pi_.base.bv->coordCache().insets().add(inset, int(x_), yo_);
112 // insets are painted completely. Recursive
113 inset->drawSelection(pi_, int(x_), yo_);
114 inset->draw(pi_, int(x_), yo_);
116 Dimension const & dim = pm_.insetDimension(inset);
118 paintForeignMark(x_, font.language(), dim.descent());
122 // Restore full_repaint status.
123 pi_.full_repaint = pi_full_repaint;
126 int const x1 = int(x_ - dim.width());
128 BOOST_ASSERT(max_witdh_ > 0);
129 int right_margin = text_metrics_.rightMargin(pm_);
130 int const w = max_witdh_ - leftMargin() - right_margin;
131 MetricsInfo mi(pi_.base.bv, font.fontInfo(), w);
132 inset->metrics(mi, dim2);
133 if (dim.wid != dim2.wid)
134 lyxerr << "Error: inset " << to_ascii(inset->getInsetName())
135 << " draw width " << dim.width()
136 << "> metrics width " << dim2.wid << "." << endl;
137 if (dim->asc != dim2.asc)
138 lyxerr << "Error: inset " << to_ascii(inset->getInsetName())
139 << " draw ascent " << dim.ascent()
140 << "> metrics ascent " << dim2.asc << "." << endl;
141 if (dim2.descent() != dim.des)
142 lyxerr << "Error: inset " << to_ascii(inset->getInsetName())
143 << " draw ascent " << dim.descent()
144 << "> metrics descent " << dim2.des << "." << endl;
145 BOOST_ASSERT(dim2.wid == dim.wid);
146 BOOST_ASSERT(dim2.asc == dim.asc);
147 BOOST_ASSERT(dim2.des == dim.des);
148 int const x2 = x1 + dim.wid;
149 int const y1 = yo_ + dim.des;
150 int const y2 = yo_ - dim.asc;
151 pi_.pain.line(x1, y1, x1, y2, Color_green);
152 pi_.pain.line(x1, y1, x2, y1, Color_green);
153 pi_.pain.line(x2, y1, x2, y2, Color_green);
154 pi_.pain.line(x1, y2, x2, y2, Color_green);
159 void RowPainter::paintHebrewComposeChar(pos_type & vpos, FontInfo const & font)
161 pos_type pos = bidi_.vis2log(vpos);
166 char_type c = par_.getChar(pos);
170 int const width = theFontMetrics(font).width(c);
173 for (pos_type i = pos - 1; i >= 0; --i) {
175 if (!Encodings::isComposeChar_hebrew(c)) {
176 if (isPrintableNonspace(c)) {
177 int const width2 = pm_.singleWidth(i,
178 text_metrics_.displayFont(pit_, i));
179 dx = (c == 0x05e8 || // resh
180 c == 0x05d3) // dalet
182 : (width2 - width) / 2;
189 pi_.pain.text(int(x_) + dx, yo_, str, font);
193 void RowPainter::paintArabicComposeChar(pos_type & vpos, FontInfo const & font)
195 pos_type pos = bidi_.vis2log(vpos);
199 char_type c = par_.getChar(pos);
200 c = par_.transformChar(c, pos);
204 int const width = theFontMetrics(font).width(c);
207 for (pos_type i = pos - 1; i >= 0; --i) {
209 if (!Encodings::isComposeChar_arabic(c)) {
210 if (isPrintableNonspace(c)) {
211 int const width2 = pm_.singleWidth(i,
212 text_metrics_.displayFont(pit_, i));
213 dx = (width2 - width) / 2;
219 pi_.pain.text(int(x_) + dx, yo_, str, font);
223 void RowPainter::paintChars(pos_type & vpos, FontInfo const & font,
224 bool hebrew, bool arabic)
226 // This method takes up 70% of time when typing
227 pos_type pos = bidi_.vis2log(vpos);
228 pos_type const end = row_.endpos();
229 FontSpan const font_span = par_.fontSpan(pos);
230 Change::Type const prev_change = par_.lookupChange(pos).type;
233 vector<char_type> str;
235 str.push_back(par_.getChar(pos));
238 char_type c = str[0];
243 str[0] = par_.transformChar(c, pos);
246 // collect as much similar chars as we can
247 for (++vpos ; vpos < end ; ++vpos) {
248 pos = bidi_.vis2log(vpos);
249 if (pos < font_span.first || pos > font_span.last)
252 if (prev_change != par_.lookupChange(pos).type)
255 char_type c = par_.getChar(pos);
257 if (!isPrintableNonspace(c))
260 /* Because we do our own bidi, at this point the strings are
261 * already in visual order. However, Qt also applies its own
262 * bidi algorithm to strings that it paints to the screen.
263 * Therefore, if we were to paint Hebrew/Arabic words as a
264 * single string, the letters in the words would get reversed
265 * again. In order to avoid that, we don't collect Hebrew/
266 * Arabic characters, but rather paint them one at a time.
267 * See also http://thread.gmane.org/gmane.editors.lyx.devel/79740
272 /* FIXME: these checks are irrelevant, since 'arabic' and
273 * 'hebrew' alone are already going to trigger a break.
274 * However, this should not be removed completely, because
275 * if an alternative solution is found which allows grouping
276 * of arabic and hebrew characters, then these breaks may have
279 if (arabic && Encodings::isComposeChar_arabic(c))
282 if (hebrew && Encodings::isComposeChar_hebrew(c))
291 c = par_.transformChar(c, pos);
292 /* see comment in hebrew, explaining why we break */
299 docstring s(&str[0], str.size());
301 if (prev_change != Change::UNCHANGED) {
302 FontInfo copy = font;
303 if (prev_change == Change::DELETED) {
304 copy.setColor(Color_deletedtext);
305 } else if (prev_change == Change::INSERTED) {
306 copy.setColor(Color_addedtext);
308 x_ += pi_.pain.text(int(x_), yo_, s, copy);
310 x_ += pi_.pain.text(int(x_), yo_, s, font);
315 void RowPainter::paintForeignMark(double orig_x, Language const * lang,
318 if (!lyxrc.mark_foreign_language)
320 if (lang == latex_language)
322 if (lang == pi_.base.bv->buffer().params().language)
325 int const y = yo_ + 1 + desc;
326 pi_.pain.line(int(orig_x), y, int(x_), y, Color_language);
330 void RowPainter::paintFromPos(pos_type & vpos)
332 pos_type const pos = bidi_.vis2log(vpos);
333 Font const orig_font = text_metrics_.displayFont(pit_, pos);
334 double const orig_x = x_;
336 // usual characters, no insets
337 char_type const c = par_.getChar(pos);
339 // special case languages
340 string const & lang = orig_font.language()->lang();
341 bool const hebrew = lang == "hebrew";
342 bool const arabic = lang == "arabic_arabtex" || lang == "arabic_arabi" ||
345 // draw as many chars as we can
346 if ((!hebrew && !arabic)
347 || (hebrew && !Encodings::isComposeChar_hebrew(c))
348 || (arabic && !Encodings::isComposeChar_arabic(c))) {
349 paintChars(vpos, orig_font.fontInfo(), hebrew, arabic);
351 paintHebrewComposeChar(vpos, orig_font.fontInfo());
353 paintArabicComposeChar(vpos, orig_font.fontInfo());
356 paintForeignMark(orig_x, orig_font.language());
360 void RowPainter::paintChangeBar()
362 pos_type const start = row_.pos();
363 pos_type end = row_.endpos();
365 if (par_.size() == end) {
366 // this is the last row of the paragraph;
367 // thus, we must also consider the imaginary end-of-par character
371 if (start == end || !par_.isChanged(start, end))
374 int const height = text_metrics_.isLastRow(pit_, row_)
378 pi_.pain.fillRectangle(5, yo_ - row_.ascent(), 3, height, Color_changebar);
382 void RowPainter::paintAppendix()
384 // only draw the appendix frame once (for the main text)
385 if (!par_.params().appendix() || !text_.isMainText(pi_.base.bv->buffer()))
388 int y = yo_ - row_.ascent();
390 if (par_.params().startOfAppendix())
391 y += 2 * defaultRowHeight();
393 pi_.pain.line(1, y, 1, yo_ + row_.height(), Color_appendix);
394 pi_.pain.line(width_ - 2, y, width_ - 2, yo_ + row_.height(), Color_appendix);
398 void RowPainter::paintDepthBar()
400 depth_type const depth = par_.getDepth();
405 depth_type prev_depth = 0;
406 if (!text_metrics_.isFirstRow(pit_, row_)) {
407 pit_type pit2 = pit_;
410 prev_depth = pars_[pit2].getDepth();
413 depth_type next_depth = 0;
414 if (!text_metrics_.isLastRow(pit_, row_)) {
415 pit_type pit2 = pit_;
416 if (row_.endpos() >= pars_[pit2].size())
418 next_depth = pars_[pit2].getDepth();
421 for (depth_type i = 1; i <= depth; ++i) {
422 int const w = nestMargin() / 5;
423 int x = int(xo_) + w * i;
424 // only consider the changebar space if we're drawing outermost text
425 if (text_.isMainText(pi_.base.bv->buffer()))
426 x += changebarMargin();
428 int const starty = yo_ - row_.ascent();
429 int const h = row_.height() - 1 - (i - next_depth - 1) * 3;
431 pi_.pain.line(x, starty, x, starty + h, Color_depthbar);
434 pi_.pain.fillRectangle(x, starty, w, 2, Color_depthbar);
436 pi_.pain.fillRectangle(x, starty + h, w, 2, Color_depthbar);
441 int RowPainter::paintAppendixStart(int y)
443 FontInfo pb_font = sane_font;
444 pb_font.setColor(Color_appendix);
451 docstring const label = _("Appendix");
452 theFontMetrics(pb_font).rectText(label, w, a, d);
454 int const text_start = int(xo_ + (width_ - w) / 2);
455 int const text_end = text_start + w;
457 pi_.pain.rectText(text_start, y + d, label, pb_font, Color_none, Color_none);
459 pi_.pain.line(int(xo_ + 1), y, text_start, y, Color_appendix);
460 pi_.pain.line(text_end, y, int(xo_ + width_ - 2), y, Color_appendix);
462 return 3 * defaultRowHeight();
466 void RowPainter::paintFirst()
468 ParagraphParameters const & parparams = par_.params();
472 // start of appendix?
473 if (parparams.startOfAppendix())
474 y_top += paintAppendixStart(yo_ - row_.ascent() + 2 * defaultRowHeight());
476 Buffer const & buffer = pi_.base.bv->buffer();
477 Layout const & layout = par_.layout();
479 if (buffer.params().paragraph_separation == BufferParams::ParagraphSkipSeparation) {
481 if (layout.latextype == LATEX_PARAGRAPH
482 && !par_.getDepth()) {
483 y_top += buffer.params().getDefSkip().inPixels(*pi_.base.bv);
485 Layout const & playout = pars_[pit_ - 1].layout();
486 if (playout.latextype == LATEX_PARAGRAPH
487 && !pars_[pit_ - 1].getDepth()) {
488 // is it right to use defskip here, too? (AS)
489 y_top += buffer.params().getDefSkip().inPixels(*pi_.base.bv);
495 bool const is_rtl = text_.isRTL(buffer, par_);
496 bool const is_seq = isFirstInSequence(pit_, text_.paragraphs());
497 //lyxerr << "paintFirst: " << par_.id() << " is_seq: " << is_seq << endl;
499 // should we print a label?
500 if (layout.labeltype >= LABEL_STATIC
501 && (layout.labeltype != LABEL_STATIC
502 || layout.latextype != LATEX_ENVIRONMENT
505 FontInfo const font = labelFont();
506 FontMetrics const & fm = theFontMetrics(font);
508 docstring const str = par_.labelString();
512 // this is special code for the chapter layout. This is
513 // printed in an extra row and has a pagebreak at
515 if (layout.counter == "chapter") {
516 double spacing_val = 1.0;
517 if (!parparams.spacing().isDefault()) {
518 spacing_val = parparams.spacing().getValue();
520 spacing_val = buffer.params().spacing().getValue();
523 int const labeladdon = int(fm.maxHeight() * layout.spacing.getValue() * spacing_val);
525 int const maxdesc = int(fm.maxDescent() * layout.spacing.getValue() * spacing_val)
526 + int(layout.parsep) * defaultRowHeight();
529 x = width_ - leftMargin() -
533 pi_.pain.text(int(x), yo_ - maxdesc - labeladdon, str, font);
536 x = width_ - leftMargin()
537 + fm.width(layout.labelsep);
539 x = x_ - fm.width(layout.labelsep)
543 pi_.pain.text(int(x), yo_, str, font);
547 // the labels at the top of an environment.
548 // More or less for bibliography
550 (layout.labeltype == LABEL_TOP_ENVIRONMENT ||
551 layout.labeltype == LABEL_BIBLIO ||
552 layout.labeltype == LABEL_CENTERED_TOP_ENVIRONMENT)) {
553 FontInfo const font = labelFont();
554 docstring const str = par_.labelString();
556 double spacing_val = 1.0;
557 if (!parparams.spacing().isDefault())
558 spacing_val = parparams.spacing().getValue();
560 spacing_val = buffer.params().spacing().getValue();
562 FontMetrics const & fm = theFontMetrics(font);
564 int const labeladdon = int(fm.maxHeight()
565 * layout.spacing.getValue() * spacing_val);
568 int(fm.maxDescent() * layout.spacing.getValue() * spacing_val
569 + (layout.labelbottomsep * defaultRowHeight()));
572 if (layout.labeltype == LABEL_CENTERED_TOP_ENVIRONMENT) {
575 x += (width_ - text_metrics_.rightMargin(pm_) - leftMargin()) / 2;
576 x -= fm.width(str) / 2;
578 x = width_ - leftMargin() - fm.width(str);
580 pi_.pain.text(int(x), yo_ - maxdesc - labeladdon, str, font);
586 void RowPainter::paintLast()
588 bool const is_rtl = text_.isRTL(pi_.base.bv->buffer(), par_);
589 int const endlabel = getEndLabel(pit_, text_.paragraphs());
591 // paint imaginary end-of-paragraph character
593 if (par_.isInserted(par_.size()) || par_.isDeleted(par_.size())) {
594 FontMetrics const & fm = theFontMetrics(pi_.base.bv->buffer().params().getFont());
595 int const length = fm.maxAscent() / 2;
596 ColorCode col = par_.isInserted(par_.size()) ? Color_addedtext : Color_deletedtext;
598 pi_.pain.line(int(x_) + 1, yo_ + 2, int(x_) + 1, yo_ + 2 - length, col,
599 Painter::line_solid, Painter::line_thick);
600 pi_.pain.line(int(x_) + 1 - length, yo_ + 2, int(x_) + 1, yo_ + 2, col,
601 Painter::line_solid, Painter::line_thick);
608 case END_LABEL_FILLED_BOX: {
609 FontInfo const font = labelFont();
610 FontMetrics const & fm = theFontMetrics(font);
611 int const size = int(0.75 * fm.maxAscent());
612 int const y = yo_ - size;
613 int const max_row_width = width_ - size - Inset::TEXT_TO_INSET_OFFSET;
614 int x = is_rtl ? nestMargin() + changebarMargin()
615 : max_row_width - text_metrics_.rightMargin(pm_);
617 // If needed, move the box a bit to avoid overlapping with text.
618 int const rem = max_row_width - row_.width();
620 x += is_rtl ? rem : - rem;
622 if (endlabel == END_LABEL_BOX)
623 pi_.pain.rectangle(x, y, size, size, Color_eolmarker);
625 pi_.pain.fillRectangle(x, y, size, size, Color_eolmarker);
629 case END_LABEL_STATIC: {
630 FontInfo const font = labelFont();
631 FontMetrics const & fm = theFontMetrics(font);
632 docstring const & str = par_.layout().endlabelstring();
633 double const x = is_rtl ?
635 : - text_metrics_.rightMargin(pm_) - row_.width();
636 pi_.pain.text(int(x), yo_, str, font);
640 case END_LABEL_NO_LABEL:
646 void RowPainter::paintOnlyInsets()
648 pos_type const end = row_.endpos();
649 for (pos_type pos = row_.pos(); pos != end; ++pos) {
650 // If outer row has changed, nested insets are repaint completely.
651 Inset const * inset = par_.getInset(pos);
654 if (x_ > pi_.base.bv->workWidth())
656 x_ = pi_.base.bv->coordCache().getInsets().x(inset);
657 paintInset(inset, pos);
662 void RowPainter::paintText()
664 pos_type const end = row_.endpos();
665 // Spaces at logical line breaks in bidi text must be skipped during
666 // painting. However, they may appear visually in the middle
667 // of a row; they must be skipped, wherever they are...
668 // * logically "abc_[HEBREW_\nHEBREW]"
669 // * visually "abc_[_WERBEH\nWERBEH]"
670 pos_type skipped_sep_vpos = -1;
671 pos_type body_pos = par_.beginOfBody();
673 (body_pos > end || !par_.isLineSeparator(body_pos - 1))) {
677 Layout const & layout = par_.layout();
679 bool running_strikeout = false;
680 bool is_struckout = false;
681 int last_strikeout_x = 0;
683 // check for possible inline completion
684 DocIterator const & inlineCompletionPos = pi_.base.bv->inlineCompletionPos();
685 pos_type inlineCompletionVPos = -1;
686 if (inlineCompletionPos.inTexted()
687 && inlineCompletionPos.text() == &text_
688 && inlineCompletionPos.pit() == pit_
689 && inlineCompletionPos.pos() - 1 >= row_.pos()
690 && inlineCompletionPos.pos() - 1 < row_.endpos()) {
691 // draw logically behind the previous character
692 inlineCompletionVPos = bidi_.log2vis(inlineCompletionPos.pos() - 1);
695 // Use font span to speed things up, see below
699 // If the last logical character is a separator, don't paint it, unless
700 // it's in the last row of a paragraph; see skipped_sep_vpos declaration
701 if (end > 0 && end < par_.size() && par_.isSeparator(end - 1))
702 skipped_sep_vpos = bidi_.log2vis(end - 1);
704 for (pos_type vpos = row_.pos(); vpos < end; ) {
705 if (x_ > pi_.base.bv->workWidth())
708 // Skip the separator at the logical end of the row
709 if (vpos == skipped_sep_vpos) {
714 pos_type const pos = bidi_.vis2log(vpos);
716 if (pos >= par_.size()) {
721 // Use font span to speed things up, see above
722 if (vpos < font_span.first || vpos > font_span.last) {
723 font_span = par_.fontSpan(vpos);
724 font = text_metrics_.displayFont(pit_, vpos);
726 // split font span if inline completion is inside
727 if (font_span.first <= inlineCompletionVPos
728 && font_span.last > inlineCompletionVPos)
729 font_span.last = inlineCompletionVPos;
732 const int width_pos = pm_.singleWidth(pos, font);
734 if (x_ + width_pos < 0) {
740 is_struckout = par_.isDeleted(pos);
742 if (is_struckout && !running_strikeout) {
743 running_strikeout = true;
744 last_strikeout_x = int(x_);
747 Inset const * inset = par_.getInset(pos);
748 bool const highly_editable_inset = inset
749 && inset->editable() == Inset::HIGHLY_EDITABLE;
751 // If we reach the end of a struck out range, paint it.
752 // We also don't paint across things like tables
753 if (running_strikeout && (highly_editable_inset || !is_struckout)) {
754 // Calculate 1/3 height of the buffer's default font
755 FontMetrics const & fm
756 = theFontMetrics(pi_.base.bv->buffer().params().getFont());
757 int const middle = yo_ - fm.maxAscent() / 3;
758 pi_.pain.line(last_strikeout_x, middle, int(x_), middle,
759 Color_deletedtext, Painter::line_solid, Painter::line_thin);
760 running_strikeout = false;
763 if (body_pos > 0 && pos == body_pos - 1) {
764 int const lwidth = theFontMetrics(labelFont())
765 .width(layout.labelsep);
767 x_ += row_.label_hfill + lwidth - width_pos;
770 // Is the inline completion in front of character?
771 if (font.isRightToLeft() && vpos == inlineCompletionVPos)
772 paintInlineCompletion(font);
774 if (par_.isSeparator(pos)) {
775 Font const orig_font = text_metrics_.displayFont(pit_, pos);
776 double const orig_x = x_;
779 x_ += row_.separator;
780 paintForeignMark(orig_x, orig_font.language());
784 // If outer row has changed, nested insets are repaint completely.
785 pi_.base.bv->coordCache().insets().add(inset, int(x_), yo_);
786 paintInset(inset, pos);
790 // paint as many characters as possible.
794 // Is the inline completion after character?
795 if (!font.isRightToLeft() && vpos - 1 == inlineCompletionVPos)
796 paintInlineCompletion(font);
799 // if we reach the end of a struck out range, paint it
800 if (running_strikeout) {
801 // calculate 1/3 height of the buffer's default font
802 FontMetrics const & fm
803 = theFontMetrics(pi_.base.bv->buffer().params().getFont());
804 int const middle = yo_ - fm.maxAscent() / 3;
805 pi_.pain.line(last_strikeout_x, middle, int(x_), middle,
806 Color_deletedtext, Painter::line_solid, Painter::line_thin);
807 running_strikeout = false;
812 void RowPainter::paintInlineCompletion(Font const & font)
814 docstring completion = pi_.base.bv->inlineCompletion();
815 FontInfo f = font.fontInfo();
816 bool rtl = font.isRightToLeft();
818 // draw the unique and the non-unique completion part
819 // Note: this is not time-critical as it is
820 // only done once per screen.
821 size_t uniqueTo = pi_.base.bv->inlineCompletionUniqueChars();
822 docstring s1 = completion.substr(0, uniqueTo);
823 docstring s2 = completion.substr(uniqueTo);
824 ColorCode c1 = Color_inlinecompletion;
825 ColorCode c2 = Color_nonunique_inlinecompletion;
830 reverse(s1.begin(), s1.end());
831 reverse(s2.begin(), s2.end());
837 pi_.pain.text(int(x_), yo_, s1, f);
838 x_ += theFontMetrics(font).width(s1);
843 pi_.pain.text(int(x_), yo_, s2, f);
844 x_ += theFontMetrics(font).width(s2);