src/gui/text/qtextlayout.cpp

   1 /****************************************************************************
   2 **
   3 ** Copyright (C) 2011 Nokia Corporation and/or its subsidiary(-ies).
   4 ** All rights reserved.
   5 ** Contact: Nokia Corporation (qt-info@nokia.com)
   6 **
   7 ** This file is part of the QtGui module of the Qt Toolkit.
   8 **
   9 ** $QT_BEGIN_LICENSE:LGPL$
  10 ** No Commercial Usage
  11 ** This file contains pre-release code and may not be distributed.
  12 ** You may use this file in accordance with the terms and conditions
  13 ** contained in the Technology Preview License Agreement accompanying
  14 ** this package.
  15 **
  16 ** GNU Lesser General Public License Usage
  17 ** Alternatively, this file may be used under the terms of the GNU Lesser
  18 ** General Public License version 2.1 as published by the Free Software
  19 ** Foundation and appearing in the file LICENSE.LGPL included in the
  20 ** packaging of this file.  Please review the following information to
  21 ** ensure the GNU Lesser General Public License version 2.1 requirements
  22 ** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
  23 **
  24 ** In addition, as a special exception, Nokia gives you certain additional
  25 ** rights.  These rights are described in the Nokia Qt LGPL Exception
  26 ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
  27 **
  28 ** If you have questions regarding the use of this file, please contact
  29 ** Nokia at qt-info@nokia.com.
  30 **
  31 **
  32 **
  33 **
  34 **
  35 **
  36 **
  37 **
  38 ** $QT_END_LICENSE$
  39 **
  40 ****************************************************************************/
  41
  42 #include "qtextlayout.h"
  43 #include "qtextengine_p.h"
  44
  45 #include <qfont.h>
  46 #include <qapplication.h>
  47 #include <qpainter.h>
  48 #include <qvarlengtharray.h>
  49 #include <qtextformat.h>
  50 #include <qabstracttextdocumentlayout.h>
  51 #include "qtextdocument_p.h"
  52 #include "qtextformat_p.h"
  53 #include "qstyleoption.h"
  54 #include "qpainterpath.h"
  55 #include "qglyphrun.h"
  56 #include "qglyphrun_p.h"
  57 #include "qrawfont.h"
  58 #include "qrawfont_p.h"
  59 #include <limits.h>
  60
  61 #include <qdebug.h>
  62
  63 #include "qfontengine_p.h"
  64
  65 #if !defined(QT_NO_FREETYPE)
  66 #  include "qfontengine_ft_p.h"
  67 #endif
  68
  69 QT_BEGIN_NAMESPACE
  70
  71 #define ObjectSelectionBrush (QTextFormat::ForegroundBrush + 1)
  72 #define SuppressText 0x5012
  73 #define SuppressBackground 0x513
  74
  75 /*!
  76     \class QTextLayout::FormatRange
  77     \reentrant
  78
  79     \brief The QTextLayout::FormatRange structure is used to apply extra formatting information
  80     for a specified area in the text layout's content.
  81
  82     \sa QTextLayout::setAdditionalFormats(), QTextLayout::draw()
  83 */
  84
  85 /*!
  86     \variable QTextLayout::FormatRange::start
  87     Specifies the beginning of the format range within the text layout's text.
  88 */
  89
  90 /*!
  91     \variable QTextLayout::FormatRange::length
  92     Specifies the numer of characters the format range spans.
  93 */
  94
  95 /*!
  96     \variable QTextLayout::FormatRange::format
  97     Specifies the format to apply.
  98 */
  99
 100 /*!
 101     \class QTextInlineObject
 102     \reentrant
 103
 104     \brief The QTextInlineObject class represents an inline object in
 105     a QTextLayout.
 106
 107     \ingroup richtext-processing
 108
 109     This class is only used if the text layout is used to lay out
 110     parts of a QTextDocument.
 111
 112     The inline object has various attributes that can be set, for
 113     example using, setWidth(), setAscent(), and setDescent(). The
 114     rectangle it occupies is given by rect(), and its direction by
 115     isRightToLeft(). Its position in the text layout is given by at(),
 116     and its format is given by format().
 117 */
 118
 119 /*!
 120     \fn QTextInlineObject::QTextInlineObject(int i, QTextEngine *e)
 121
 122     Creates a new inline object for the item at position \a i in the
 123     text engine \a e.
 124 */
 125
 126 /*!
 127     \fn QTextInlineObject::QTextInlineObject()
 128
 129     \internal
 130 */
 131
 132 /*!
 133     \fn bool QTextInlineObject::isValid() const
 134
 135     Returns true if this inline object is valid; otherwise returns
 136     false.
 137 */
 138
 139 /*!
 140     Returns the inline object's rectangle.
 141
 142     \sa ascent(), descent(), width()
 143 */
 144 QRectF QTextInlineObject::rect() const
 145 {
 146     QScriptItem& si = eng->layoutData->items[itm];
 147     return QRectF(0, -si.ascent.toReal(), si.width.toReal(), si.height().toReal());
 148 }
 149
 150 /*!
 151     Returns the inline object's width.
 152
 153     \sa ascent(), descent(), rect()
 154 */
 155 qreal QTextInlineObject::width() const
 156 {
 157     return eng->layoutData->items[itm].width.toReal();
 158 }
 159
 160 /*!
 161     Returns the inline object's ascent.
 162
 163     \sa descent(), width(), rect()
 164 */
 165 qreal QTextInlineObject::ascent() const
 166 {
 167     return eng->layoutData->items[itm].ascent.toReal();
 168 }
 169
 170 /*!
 171     Returns the inline object's descent.
 172
 173     \sa ascent(), width(), rect()
 174 */
 175 qreal QTextInlineObject::descent() const
 176 {
 177     return eng->layoutData->items[itm].descent.toReal();
 178 }
 179
 180 /*!
 181     Returns the inline object's total height. This is equal to
 182     ascent() + descent() + 1.
 183
 184     \sa ascent(), descent(), width(), rect()
 185 */
 186 qreal QTextInlineObject::height() const
 187 {
 188     return eng->layoutData->items[itm].height().toReal();
 189 }
 190
 191 /*!
 192     Sets the inline object's width to \a w.
 193
 194     \sa width(), ascent(), descent(), rect()
 195 */
 196 void QTextInlineObject::setWidth(qreal w)
 197 {
 198     eng->layoutData->items[itm].width = QFixed::fromReal(w);
 199 }
 200
 201 /*!
 202     Sets the inline object's ascent to \a a.
 203
 204     \sa ascent(), setDescent(), width(), rect()
 205 */
 206 void QTextInlineObject::setAscent(qreal a)
 207 {
 208     eng->layoutData->items[itm].ascent = QFixed::fromReal(a);
 209 }
 210
 211 /*!
 212     Sets the inline object's decent to \a d.
 213
 214     \sa descent(), setAscent(), width(), rect()
 215 */
 216 void QTextInlineObject::setDescent(qreal d)
 217 {
 218     eng->layoutData->items[itm].descent = QFixed::fromReal(d);
 219 }
 220
 221 /*!
 222     The position of the inline object within the text layout.
 223 */
 224 int QTextInlineObject::textPosition() const
 225 {
 226     return eng->layoutData->items[itm].position;
 227 }
 228
 229 /*!
 230     Returns an integer describing the format of the inline object
 231     within the text layout.
 232 */
 233 int QTextInlineObject::formatIndex() const
 234 {
 235     return eng->formatIndex(&eng->layoutData->items[itm]);
 236 }
 237
 238 /*!
 239     Returns format of the inline object within the text layout.
 240 */
 241 QTextFormat QTextInlineObject::format() const
 242 {
 243     if (!eng->block.docHandle())
 244         return QTextFormat();
 245     return eng->formats()->format(eng->formatIndex(&eng->layoutData->items[itm]));
 246 }
 247
 248 /*!
 249     Returns if the object should be laid out right-to-left or left-to-right.
 250 */
 251 Qt::LayoutDirection QTextInlineObject::textDirection() const
 252 {
 253     return (eng->layoutData->items[itm].analysis.bidiLevel % 2 ? Qt::RightToLeft : Qt::LeftToRight);
 254 }
 255
 256 /*!
 257     \class QTextLayout
 258     \reentrant
 259
 260     \brief The QTextLayout class is used to lay out and render text.
 261
 262     \ingroup richtext-processing
 263
 264     It offers many features expected from a modern text layout
 265     engine, including Unicode compliant rendering, line breaking and
 266     handling of cursor positioning. It can also produce and render
 267     device independent layout, something that is important for WYSIWYG
 268     applications.
 269
 270     The class has a rather low level API and unless you intend to
 271     implement your own text rendering for some specialized widget, you
 272     probably won't need to use it directly.
 273
 274     QTextLayout can be used with both plain and rich text.
 275
 276     QTextLayout can be used to create a sequence of QTextLine
 277     instances with given widths and can position them independently
 278     on the screen. Once the layout is done, these lines can be drawn
 279     on a paint device.
 280
 281     The text to be laid out can be provided in the constructor or set with
 282     setText().
 283
 284     The layout can be seen as a sequence of QTextLine objects; use createLine()
 285     to create a QTextLine instance, and lineAt() or lineForTextPosition() to retrieve
 286     created lines.
 287
 288     Here is a code snippet that demonstrates the layout phase:
 289     \snippet doc/src/snippets/code/src_gui_text_qtextlayout.cpp 0
 290
 291     The text can then be rendered by calling the layout's draw() function:
 292     \snippet doc/src/snippets/code/src_gui_text_qtextlayout.cpp 1
 293
 294     For a given position in the text you can find a valid cursor position with
 295     isValidCursorPosition(), nextCursorPosition(), and previousCursorPosition().
 296
 297     The QTextLayout itself can be positioned with setPosition(); it has a
 298     boundingRect(), and a minimumWidth() and a maximumWidth().
 299
 300     \sa QStaticText
 301 */
 302
 303 /*!
 304     \enum QTextLayout::CursorMode
 305
 306     \value SkipCharacters
 307     \value SkipWords
 308 */
 309
 310 /*!
 311     \fn QTextEngine *QTextLayout::engine() const
 312     \internal
 313
 314     Returns the text engine used to render the text layout.
 315 */
 316
 317 /*!
 318     Constructs an empty text layout.
 319
 320     \sa setText()
 321 */
 322 QTextLayout::QTextLayout()
 323 { d = new QTextEngine(); }
 324
 325 /*!
 326     Constructs a text layout to lay out the given \a text.
 327 */
 328 QTextLayout::QTextLayout(const QString& text)
 329 {
 330     d = new QTextEngine();
 331     d->text = text;
 332 }
 333
 334 /*!
 335     Constructs a text layout to lay out the given \a text with the specified
 336     \a font.
 337
 338     All the metric and layout calculations will be done in terms of
 339     the paint device, \a paintdevice. If \a paintdevice is 0 the
 340     calculations will be done in screen metrics.
 341 */
 342 QTextLayout::QTextLayout(const QString& text, const QFont &font, QPaintDevice *paintdevice)
 343 {
 344     QFont f(font);
 345     if (paintdevice)
 346         f = QFont(font, paintdevice);
 347     d = new QTextEngine((text.isNull() ? (const QString&)QString::fromLatin1("") : text), f.d.data());
 348 }
 349
 350 /*!
 351     \internal
 352     Constructs a text layout to lay out the given \a block.
 353 */
 354 QTextLayout::QTextLayout(const QTextBlock &block)
 355 {
 356     d = new QTextEngine();
 357     d->block = block;
 358 }
 359
 360 /*!
 361     Destructs the layout.
 362 */
 363 QTextLayout::~QTextLayout()
 364 {
 365     if (!d->stackEngine)
 366         delete d;
 367 }
 368
 369 /*!
 370     Sets the layout's font to the given \a font. The layout is
 371     invalidated and must be laid out again.
 372
 373     \sa font()
 374 */
 375 void QTextLayout::setFont(const QFont &font)
 376 {
 377     d->fnt = font;
 378     d->feCache.reset();
 379 }
 380
 381 /*!
 382     Returns the current font that is used for the layout, or a default
 383     font if none is set.
 384
 385     \sa setFont()
 386 */
 387 QFont QTextLayout::font() const
 388 {
 389     return d->font();
 390 }
 391
 392 /*!
 393     Sets the layout's text to the given \a string. The layout is
 394     invalidated and must be laid out again.
 395
 396     Notice that when using this QTextLayout as part of a QTextDocument this
 397     method will have no effect.
 398
 399     \sa text()
 400 */
 401 void QTextLayout::setText(const QString& string)
 402 {
 403     d->invalidate();
 404     d->clearLineData();
 405     d->text = string;
 406 }
 407
 408 /*!
 409     Returns the layout's text.
 410
 411     \sa setText()
 412 */
 413 QString QTextLayout::text() const
 414 {
 415     return d->text;
 416 }
 417
 418 /*!
 419     Sets the text option structure that controls the layout process to the
 420     given \a option.
 421
 422     \sa textOption()
 423 */
 424 void QTextLayout::setTextOption(const QTextOption &option)
 425 {
 426     d->option = option;
 427 }
 428
 429 /*!
 430     Returns the current text option used to control the layout process.
 431
 432     \sa setTextOption()
 433 */
 434 QTextOption QTextLayout::textOption() const
 435 {
 436     return d->option;
 437 }
 438
 439 /*!
 440     Sets the \a position and \a text of the area in the layout that is
 441     processed before editing occurs.
 442
 443     \sa preeditAreaPosition(), preeditAreaText()
 444 */
 445 void QTextLayout::setPreeditArea(int position, const QString &text)
 446 {
 447     if (text.isEmpty()) {
 448         if (!d->specialData)
 449             return;
 450         if (d->specialData->addFormats.isEmpty()) {
 451             delete d->specialData;
 452             d->specialData = 0;
 453         } else {
 454             d->specialData->preeditText = QString();
 455             d->specialData->preeditPosition = -1;
 456         }
 457     } else {
 458         if (!d->specialData)
 459             d->specialData = new QTextEngine::SpecialData;
 460         d->specialData->preeditPosition = position;
 461         d->specialData->preeditText = text;
 462     }
 463     d->invalidate();
 464     d->clearLineData();
 465     if (d->block.docHandle())
 466         d->block.docHandle()->documentChange(d->block.position(), d->block.length());
 467 }
 468
 469 /*!
 470     Returns the position of the area in the text layout that will be
 471     processed before editing occurs.
 472
 473     \sa preeditAreaText()
 474 */
 475 int QTextLayout::preeditAreaPosition() const
 476 {
 477     return d->specialData ? d->specialData->preeditPosition : -1;
 478 }
 479
 480 /*!
 481     Returns the text that is inserted in the layout before editing occurs.
 482
 483     \sa preeditAreaPosition()
 484 */
 485 QString QTextLayout::preeditAreaText() const
 486 {
 487     return d->specialData ? d->specialData->preeditText : QString();
 488 }
 489
 490
 491 /*!
 492     Sets the additional formats supported by the text layout to \a formatList.
 493
 494     \sa additionalFormats(), clearAdditionalFormats()
 495 */
 496 void QTextLayout::setAdditionalFormats(const QList<FormatRange> &formatList)
 497 {
 498     if (formatList.isEmpty()) {
 499         if (!d->specialData)
 500             return;
 501         if (d->specialData->preeditText.isEmpty()) {
 502             delete d->specialData;
 503             d->specialData = 0;
 504         } else {
 505             d->specialData->addFormats = formatList;
 506             d->specialData->addFormatIndices.clear();
 507         }
 508     } else {
 509         if (!d->specialData) {
 510             d->specialData = new QTextEngine::SpecialData;
 511             d->specialData->preeditPosition = -1;
 512         }
 513         d->specialData->addFormats = formatList;
 514         d->indexAdditionalFormats();
 515     }
 516     if (d->block.docHandle())
 517         d->block.docHandle()->documentChange(d->block.position(), d->block.length());
 518     d->feCache.reset();
 519 }
 520
 521 /*!
 522     Returns the list of additional formats supported by the text layout.
 523
 524     \sa setAdditionalFormats(), clearAdditionalFormats()
 525 */
 526 QList<QTextLayout::FormatRange> QTextLayout::additionalFormats() const
 527 {
 528     QList<FormatRange> formats;
 529     if (!d->specialData)
 530         return formats;
 531
 532     formats = d->specialData->addFormats;
 533
 534     if (d->specialData->addFormatIndices.isEmpty())
 535         return formats;
 536
 537     const QTextFormatCollection *collection = d->formats();
 538
 539     for (int i = 0; i < d->specialData->addFormatIndices.count(); ++i)
 540         formats[i].format = collection->charFormat(d->specialData->addFormatIndices.at(i));
 541
 542     return formats;
 543 }
 544
 545 /*!
 546     Clears the list of additional formats supported by the text layout.
 547
 548     \sa additionalFormats(), setAdditionalFormats()
 549 */
 550 void QTextLayout::clearAdditionalFormats()
 551 {
 552     setAdditionalFormats(QList<FormatRange>());
 553 }
 554
 555 /*!
 556     Enables caching of the complete layout information if \a enable is
 557     true; otherwise disables layout caching. Usually
 558     QTextLayout throws most of the layouting information away after a
 559     call to endLayout() to reduce memory consumption. If you however
 560     want to draw the laid out text directly afterwards enabling caching
 561     might speed up drawing significantly.
 562
 563     \sa cacheEnabled()
 564 */
 565 void QTextLayout::setCacheEnabled(bool enable)
 566 {
 567     d->cacheGlyphs = enable;
 568 }
 569
 570 /*!
 571     Returns true if the complete layout information is cached; otherwise
 572     returns false.
 573
 574     \sa setCacheEnabled()
 575 */
 576 bool QTextLayout::cacheEnabled() const
 577 {
 578     return d->cacheGlyphs;
 579 }
 580
 581 /*!
 582     Set the cursor movement style. If the QTextLayout is backed by
 583     a document, you can ignore this and use the option in QTextDocument,
 584     this option is for widgets like QLineEdit or custom widgets without
 585     a QTextDocument. Default value is Qt::LogicalMoveStyle.
 586
 587     \sa setCursorMoveStyle()
 588 */
 589 void QTextLayout::setCursorMoveStyle(Qt::CursorMoveStyle style)
 590 {
 591     d->visualMovement = style == Qt::VisualMoveStyle ? true : false;
 592 }
 593
 594 /*!
 595     The cursor movement style of this QTextLayout. The default is
 596     Qt::LogicalMoveStyle.
 597
 598     \sa setCursorMoveStyle()
 599 */
 600 Qt::CursorMoveStyle QTextLayout::cursorMoveStyle() const
 601 {
 602     return d->visualMovement ? Qt::VisualMoveStyle : Qt::LogicalMoveStyle;
 603 }
 604
 605 /*!
 606     Begins the layout process.
 607
 608     \sa endLayout()
 609 */
 610 void QTextLayout::beginLayout()
 611 {
 612 #ifndef QT_NO_DEBUG
 613     if (d->layoutData && d->layoutData->layoutState == QTextEngine::InLayout) {
 614         qWarning("QTextLayout::beginLayout: Called while already doing layout");
 615         return;
 616     }
 617 #endif
 618     d->invalidate();
 619     d->clearLineData();
 620     d->itemize();
 621     d->layoutData->layoutState = QTextEngine::InLayout;
 622 }
 623
 624 /*!
 625     Ends the layout process.
 626
 627     \sa beginLayout()
 628 */
 629 void QTextLayout::endLayout()
 630 {
 631 #ifndef QT_NO_DEBUG
 632     if (!d->layoutData || d->layoutData->layoutState == QTextEngine::LayoutEmpty) {
 633         qWarning("QTextLayout::endLayout: Called without beginLayout()");
 634         return;
 635     }
 636 #endif
 637     int l = d->lines.size();
 638     if (l && d->lines.at(l-1).length < 0) {
 639         QTextLine(l-1, d).setNumColumns(INT_MAX);
 640     }
 641     d->layoutData->layoutState = QTextEngine::LayoutEmpty;
 642     if (!d->cacheGlyphs)
 643         d->freeMemory();
 644 }
 645
 646 /*!
 647     \since 4.4
 648
 649     Clears the line information in the layout. After having called
 650     this function, lineCount() returns 0.
 651 */
 652 void QTextLayout::clearLayout()
 653 {
 654     d->clearLineData();
 655 }
 656
 657 /*!
 658     Returns the next valid cursor position after \a oldPos that
 659     respects the given cursor \a mode.
 660     Returns value of \a oldPos, if \a oldPos is not a valid cursor position.
 661
 662     \sa isValidCursorPosition(), previousCursorPosition()
 663 */
 664 int QTextLayout::nextCursorPosition(int oldPos, CursorMode mode) const
 665 {
 666     const HB_CharAttributes *attributes = d->attributes();
 667     int len = d->block.isValid() ? d->block.length() - 1
 668                                  : d->layoutData->string.length();
 669     Q_ASSERT(len <= d->layoutData->string.length());
 670     if (!attributes || oldPos < 0 || oldPos >= len)
 671         return oldPos;
 672
 673     if (mode == SkipCharacters) {
 674         oldPos++;
 675         while (oldPos < len && !attributes[oldPos].charStop)
 676             oldPos++;
 677     } else {
 678         if (oldPos < len && d->atWordSeparator(oldPos)) {
 679             oldPos++;
 680             while (oldPos < len && d->atWordSeparator(oldPos))
 681                 oldPos++;
 682         } else {
 683             while (oldPos < len && !d->atSpace(oldPos) && !d->atWordSeparator(oldPos))
 684                 oldPos++;
 685         }
 686         while (oldPos < len && d->atSpace(oldPos))
 687             oldPos++;
 688     }
 689
 690     return oldPos;
 691 }
 692
 693 /*!
 694     Returns the first valid cursor position before \a oldPos that
 695     respects the given cursor \a mode.
 696     Returns value of \a oldPos, if \a oldPos is not a valid cursor position.
 697
 698     \sa isValidCursorPosition(), nextCursorPosition()
 699 */
 700 int QTextLayout::previousCursorPosition(int oldPos, CursorMode mode) const
 701 {
 702     const HB_CharAttributes *attributes = d->attributes();
 703     if (!attributes || oldPos <= 0 || oldPos > d->layoutData->string.length())
 704         return oldPos;
 705
 706     if (mode == SkipCharacters) {
 707         oldPos--;
 708         while (oldPos && !attributes[oldPos].charStop)
 709             oldPos--;
 710     } else {
 711         while (oldPos && d->atSpace(oldPos-1))
 712             oldPos--;
 713
 714         if (oldPos && d->atWordSeparator(oldPos-1)) {
 715             oldPos--;
 716             while (oldPos && d->atWordSeparator(oldPos-1))
 717                 oldPos--;
 718         } else {
 719             while (oldPos && !d->atSpace(oldPos-1) && !d->atWordSeparator(oldPos-1))
 720                 oldPos--;
 721         }
 722     }
 723
 724     return oldPos;
 725 }
 726
 727 /*!
 728     Returns the cursor position to the right of \a oldPos, next to it.
 729     It's dependent on the visual position of characters, after bi-directional
 730     reordering.
 731
 732     \sa leftCursorPosition(), nextCursorPosition()
 733 */
 734 int QTextLayout::rightCursorPosition(int oldPos) const
 735 {
 736     int newPos = d->positionAfterVisualMovement(oldPos, QTextCursor::Right);
 737 //    qDebug("%d -> %d", oldPos, newPos);
 738     return newPos;
 739 }
 740
 741 /*!
 742     Returns the cursor position to the left of \a oldPos, next to it.
 743     It's dependent on the visual position of characters, after bi-directional
 744     reordering.
 745
 746     \sa rightCursorPosition(), previousCursorPosition()
 747 */
 748 int QTextLayout::leftCursorPosition(int oldPos) const
 749 {
 750     int newPos = d->positionAfterVisualMovement(oldPos, QTextCursor::Left);
 751 //    qDebug("%d -> %d", oldPos, newPos);
 752     return newPos;
 753 }
 754
 755 /*!/
 756     Returns true if position \a pos is a valid cursor position.
 757
 758     In a Unicode context some positions in the text are not valid
 759     cursor positions, because the position is inside a Unicode
 760     surrogate or a grapheme cluster.
 761
 762     A grapheme cluster is a sequence of two or more Unicode characters
 763     that form one indivisible entity on the screen. For example the
 764     latin character `\Auml' can be represented in Unicode by two
 765     characters, `A' (0x41), and the combining diaresis (0x308). A text
 766     cursor can only validly be positioned before or after these two
 767     characters, never between them since that wouldn't make sense. In
 768     indic languages every syllable forms a grapheme cluster.
 769 */
 770 bool QTextLayout::isValidCursorPosition(int pos) const
 771 {
 772     const HB_CharAttributes *attributes = d->attributes();
 773     if (!attributes || pos < 0 || pos > (int)d->layoutData->string.length())
 774         return false;
 775     return attributes[pos].charStop;
 776 }
 777
 778 /*!
 779     Returns a new text line to be laid out if there is text to be
 780     inserted into the layout; otherwise returns an invalid text line.
 781
 782     The text layout creates a new line object that starts after the
 783     last line in the layout, or at the beginning if the layout is empty.
 784     The layout maintains an internal cursor, and each line is filled
 785     with text from the cursor position onwards when the
 786     QTextLine::setLineWidth() function is called.
 787
 788     Once QTextLine::setLineWidth() is called, a new line can be created and
 789     filled with text. Repeating this process will lay out the whole block
 790     of text contained in the QTextLayout. If there is no text left to be
 791     inserted into the layout, the QTextLine returned will not be valid
 792     (isValid() will return false).
 793 */
 794 QTextLine QTextLayout::createLine()
 795 {
 796 #ifndef QT_NO_DEBUG
 797     if (!d->layoutData || d->layoutData->layoutState == QTextEngine::LayoutEmpty) {
 798         qWarning("QTextLayout::createLine: Called without layouting");
 799         return QTextLine();
 800     }
 801 #endif
 802     if (d->layoutData->layoutState == QTextEngine::LayoutFailed)
 803         return QTextLine();
 804
 805     int l = d->lines.size();
 806     if (l && d->lines.at(l-1).length < 0) {
 807         QTextLine(l-1, d).setNumColumns(INT_MAX);
 808     }
 809     int from = l > 0 ? d->lines.at(l-1).from + d->lines.at(l-1).length : 0;
 810     int strlen = d->layoutData->string.length();
 811     if (l && from >= strlen) {
 812         if (!d->lines.at(l-1).length || d->layoutData->string.at(strlen - 1) != QChar::LineSeparator)
 813             return QTextLine();
 814     }
 815
 816     QScriptLine line;
 817     line.from = from;
 818     line.length = -1;
 819     line.justified = false;
 820     line.gridfitted = false;
 821
 822     d->lines.append(line);
 823     return QTextLine(l, d);
 824 }
 825
 826 /*!
 827     Returns the number of lines in this text layout.
 828
 829     \sa lineAt()
 830 */
 831 int QTextLayout::lineCount() const
 832 {
 833     return d->lines.size();
 834 }
 835
 836 /*!
 837     Returns the \a{i}-th line of text in this text layout.
 838
 839     \sa lineCount(), lineForTextPosition()
 840 */
 841 QTextLine QTextLayout::lineAt(int i) const
 842 {
 843     return QTextLine(i, d);
 844 }
 845
 846 /*!
 847     Returns the line that contains the cursor position specified by \a pos.
 848
 849     \sa isValidCursorPosition(), lineAt()
 850 */
 851 QTextLine QTextLayout::lineForTextPosition(int pos) const
 852 {
 853     int lineNum = d->lineNumberForTextPosition(pos);
 854     return lineNum >= 0 ? lineAt(lineNum) : QTextLine();
 855 }
 856
 857 /*!
 858     \since 4.2
 859
 860     The global position of the layout. This is independent of the
 861     bounding rectangle and of the layout process.
 862
 863     \sa setPosition()
 864 */
 865 QPointF QTextLayout::position() const
 866 {
 867     return d->position;
 868 }
 869
 870 /*!
 871     Moves the text layout to point \a p.
 872
 873     \sa position()
 874 */
 875 void QTextLayout::setPosition(const QPointF &p)
 876 {
 877     d->position = p;
 878 }
 879
 880 /*!
 881     The smallest rectangle that contains all the lines in the layout.
 882 */
 883 QRectF QTextLayout::boundingRect() const
 884 {
 885     if (d->lines.isEmpty())
 886         return QRectF();
 887
 888     QFixed xmax, ymax;
 889     QFixed xmin = d->lines.at(0).x;
 890     QFixed ymin = d->lines.at(0).y;
 891
 892     for (int i = 0; i < d->lines.size(); ++i) {
 893         const QScriptLine &si = d->lines[i];
 894         xmin = qMin(xmin, si.x);
 895         ymin = qMin(ymin, si.y);
 896         QFixed lineWidth = si.width < QFIXED_MAX ? qMax(si.width, si.textWidth) : si.textWidth;
 897         xmax = qMax(xmax, si.x+lineWidth);
 898         // ### shouldn't the ascent be used in ymin???
 899         ymax = qMax(ymax, si.y+si.height());
 900     }
 901     return QRectF(xmin.toReal(), ymin.toReal(), (xmax-xmin).toReal(), (ymax-ymin).toReal());
 902 }
 903
 904 /*!
 905     The minimum width the layout needs. This is the width of the
 906     layout's smallest non-breakable substring.
 907
 908     \warning This function only returns a valid value after the layout
 909     has been done.
 910
 911     \sa maximumWidth()
 912 */
 913 qreal QTextLayout::minimumWidth() const
 914 {
 915     return d->minWidth.toReal();
 916 }
 917
 918 /*!
 919     The maximum width the layout could expand to; this is essentially
 920     the width of the entire text.
 921
 922     \warning This function only returns a valid value after the layout
 923     has been done.
 924
 925     \sa minimumWidth()
 926 */
 927 qreal QTextLayout::maximumWidth() const
 928 {
 929     return d->maxWidth.toReal();
 930 }
 931
 932
 933 /*!
 934     \internal
 935 */
 936 void QTextLayout::setFlags(int flags)
 937 {
 938     if (flags & Qt::TextJustificationForced) {
 939         d->option.setAlignment(Qt::AlignJustify);
 940         d->forceJustification = true;
 941     }
 942
 943     if (flags & (Qt::TextForceLeftToRight|Qt::TextForceRightToLeft)) {
 944         d->ignoreBidi = true;
 945         d->option.setTextDirection((flags & Qt::TextForceLeftToRight) ? Qt::LeftToRight : Qt::RightToLeft);
 946     }
 947 }
 948
 949 static void addSelectedRegionsToPath(QTextEngine *eng, int lineNumber, const QPointF &pos, QTextLayout::FormatRange *selection,
 950                                      QPainterPath *region, QRectF boundingRect)
 951 {
 952     const QScriptLine &line = eng->lines[lineNumber];
 953
 954     QTextLineItemIterator iterator(eng, lineNumber, pos, selection);
 955
 956
 957
 958     const qreal selectionY = pos.y() + line.y.toReal();
 959     const qreal lineHeight = line.height().toReal();
 960
 961     QFixed lastSelectionX = iterator.x;
 962     QFixed lastSelectionWidth;
 963
 964     while (!iterator.atEnd()) {
 965         iterator.next();
 966
 967         QFixed selectionX, selectionWidth;
 968         if (iterator.getSelectionBounds(&selectionX, &selectionWidth)) {
 969             if (selectionX == lastSelectionX + lastSelectionWidth) {
 970                 lastSelectionWidth += selectionWidth;
 971                 continue;
 972             }
 973
 974             if (lastSelectionWidth > 0)
 975                 region->addRect(boundingRect & QRectF(lastSelectionX.toReal(), selectionY, lastSelectionWidth.toReal(), lineHeight));
 976
 977             lastSelectionX = selectionX;
 978             lastSelectionWidth = selectionWidth;
 979         }
 980     }
 981     if (lastSelectionWidth > 0)
 982         region->addRect(boundingRect & QRectF(lastSelectionX.toReal(), selectionY, lastSelectionWidth.toReal(), lineHeight));
 983 }
 984
 985 static inline QRectF clipIfValid(const QRectF &rect, const QRectF &clip)
 986 {
 987     return clip.isValid() ? (rect & clip) : rect;
 988 }
 989
 990
 991 /*!
 992     Returns the glyph indexes and positions for all glyphs in this QTextLayout. This is an
 993     expensive function, and should not be called in a time sensitive context.
 994
 995     \since 4.8
 996
 997     \sa draw(), QPainter::drawGlyphRun()
 998 */
 999 #if !defined(QT_NO_RAWFONT)
1000 QList<QGlyphRun> QTextLayout::glyphRuns(int from, int length) const
1001 {
1002     if (from < 0)
1003         from = 0;
1004     if (length < 0)
1005         length = text().length();
1006
1007     QList<QGlyphRun> glyphs;
1008     for (int i=0; i<d->lines.size(); ++i) {
1009         if (d->lines[i].from > from + length)
1010             break;
1011         else if (d->lines[i].from + d->lines[i].length >= from)
1012             glyphs += QTextLine(i, d).glyphRuns(from, length);
1013     }
1014
1015     return glyphs;
1016 }
1017 #endif // QT_NO_RAWFONT
1018
1019 /*!
1020     Draws the whole layout on the painter \a p at the position specified by \a pos.
1021     The rendered layout includes the given \a selections and is clipped within
1022     the rectangle specified by \a clip.
1023 */
1024 void QTextLayout::draw(QPainter *p, const QPointF &pos, const QVector<FormatRange> &selections, const QRectF &clip) const
1025 {
1026     if (d->lines.isEmpty())
1027         return;
1028
1029     if (!d->layoutData)
1030         d->itemize();
1031
1032     QPointF position = pos + d->position;
1033
1034     QFixed clipy = (INT_MIN/256);
1035     QFixed clipe = (INT_MAX/256);
1036     if (clip.isValid()) {
1037         clipy = QFixed::fromReal(clip.y() - position.y());
1038         clipe = clipy + QFixed::fromReal(clip.height());
1039     }
1040
1041     int firstLine = 0;
1042     int lastLine = d->lines.size();
1043     for (int i = 0; i < d->lines.size(); ++i) {
1044         QTextLine l(i, d);
1045         const QScriptLine &sl = d->lines[i];
1046
1047         if (sl.y > clipe) {
1048             lastLine = i;
1049             break;
1050         }
1051         if ((sl.y + sl.height()) < clipy) {
1052             firstLine = i;
1053             continue;
1054         }
1055     }
1056
1057     QPainterPath excludedRegion;
1058     QPainterPath textDoneRegion;
1059     for (int i = 0; i < selections.size(); ++i) {
1060         FormatRange selection = selections.at(i);
1061         const QBrush bg = selection.format.background();
1062
1063         QPainterPath region;
1064         region.setFillRule(Qt::WindingFill);
1065
1066         for (int line = firstLine; line < lastLine; ++line) {
1067             const QScriptLine &sl = d->lines[line];
1068             QTextLine tl(line, d);
1069
1070             QRectF lineRect(tl.naturalTextRect());
1071             lineRect.translate(position);
1072             lineRect.adjust(0, 0, d->leadingSpaceWidth(sl).toReal(), 0);
1073
1074             bool isLastLineInBlock = (line == d->lines.size()-1);
1075             int sl_length = sl.length + (isLastLineInBlock? 1 : 0); // the infamous newline
1076
1077
1078             if (sl.from > selection.start + selection.length || sl.from + sl_length <= selection.start)
1079                 continue; // no actual intersection
1080
1081             const bool selectionStartInLine = sl.from <= selection.start;
1082             const bool selectionEndInLine = selection.start + selection.length < sl.from + sl_length;
1083
1084             if (sl.length && (selectionStartInLine || selectionEndInLine)) {
1085                 addSelectedRegionsToPath(d, line, position, &selection, &region, clipIfValid(lineRect, clip));
1086             } else {
1087                 region.addRect(clipIfValid(lineRect, clip));
1088             }
1089
1090             if (selection.format.boolProperty(QTextFormat::FullWidthSelection)) {
1091                 QRectF fullLineRect(tl.rect());
1092                 fullLineRect.translate(position);
1093                 fullLineRect.setRight(QFIXED_MAX);
1094                 if (!selectionEndInLine)
1095                     region.addRect(clipIfValid(QRectF(lineRect.topRight(), fullLineRect.bottomRight()), clip));
1096                 if (!selectionStartInLine)
1097                     region.addRect(clipIfValid(QRectF(fullLineRect.topLeft(), lineRect.bottomLeft()), clip));
1098             } else if (!selectionEndInLine
1099                 && isLastLineInBlock
1100                 &&!(d->option.flags() & QTextOption::ShowLineAndParagraphSeparators)) {
1101                 region.addRect(clipIfValid(QRectF(lineRect.right(), lineRect.top(),
1102                                                   lineRect.height()/4, lineRect.height()), clip));
1103             }
1104
1105         }
1106         {
1107             const QPen oldPen = p->pen();
1108             const QBrush oldBrush = p->brush();
1109
1110             p->setPen(selection.format.penProperty(QTextFormat::OutlinePen));
1111             p->setBrush(selection.format.brushProperty(QTextFormat::BackgroundBrush));
1112             p->drawPath(region);
1113
1114             p->setPen(oldPen);
1115             p->setBrush(oldBrush);
1116         }
1117
1118
1119
1120         bool hasText = (selection.format.foreground().style() != Qt::NoBrush);
1121         bool hasBackground= (selection.format.background().style() != Qt::NoBrush);
1122
1123         if (hasBackground) {
1124             selection.format.setProperty(ObjectSelectionBrush, selection.format.property(QTextFormat::BackgroundBrush));
1125             // don't just clear the property, set an empty brush that overrides a potential
1126             // background brush specified in the text
1127             selection.format.setProperty(QTextFormat::BackgroundBrush, QBrush());
1128             selection.format.clearProperty(QTextFormat::OutlinePen);
1129         }
1130
1131         selection.format.setProperty(SuppressText, !hasText);
1132
1133         if (hasText && !hasBackground && !(textDoneRegion & region).isEmpty())
1134             continue;
1135
1136         p->save();
1137         p->setClipPath(region, Qt::IntersectClip);
1138
1139         for (int line = firstLine; line < lastLine; ++line) {
1140             QTextLine l(line, d);
1141             l.draw(p, position, &selection);
1142         }
1143         p->restore();
1144
1145         if (hasText) {
1146             textDoneRegion += region;
1147         } else {
1148             if (hasBackground)
1149                 textDoneRegion -= region;
1150         }
1151
1152         excludedRegion += region;
1153     }
1154
1155     QPainterPath needsTextButNoBackground = excludedRegion - textDoneRegion;
1156     if (!needsTextButNoBackground.isEmpty()){
1157         p->save();
1158         p->setClipPath(needsTextButNoBackground, Qt::IntersectClip);
1159         FormatRange selection;
1160         selection.start = 0;
1161         selection.length = INT_MAX;
1162         selection.format.setProperty(SuppressBackground, true);
1163         for (int line = firstLine; line < lastLine; ++line) {
1164             QTextLine l(line, d);
1165             l.draw(p, position, &selection);
1166         }
1167         p->restore();
1168     }
1169
1170     if (!excludedRegion.isEmpty()) {
1171         p->save();
1172         QPainterPath path;
1173         QRectF br = boundingRect().translated(position);
1174         br.setRight(QFIXED_MAX);
1175         if (!clip.isNull())
1176             br = br.intersected(clip);
1177         path.addRect(br);
1178         path -= excludedRegion;
1179         p->setClipPath(path, Qt::IntersectClip);
1180     }
1181
1182     for (int i = firstLine; i < lastLine; ++i) {
1183         QTextLine l(i, d);
1184         l.draw(p, position);
1185     }
1186     if (!excludedRegion.isEmpty())
1187         p->restore();
1188
1189
1190     if (!d->cacheGlyphs)
1191         d->freeMemory();
1192 }
1193
1194 /*!
1195     \fn void QTextLayout::drawCursor(QPainter *painter, const QPointF &position, int cursorPosition) const
1196     \overload
1197
1198     Draws a text cursor with the current pen at the given \a position using the
1199     \a painter specified.
1200     The corresponding position within the text is specified by \a cursorPosition.
1201 */
1202 void QTextLayout::drawCursor(QPainter *p, const QPointF &pos, int cursorPosition) const
1203 {
1204     drawCursor(p, pos, cursorPosition, 1);
1205 }
1206
1207 /*!
1208     \fn void QTextLayout::drawCursor(QPainter *painter, const QPointF &position, int cursorPosition, int width) const
1209
1210     Draws a text cursor with the current pen and the specified \a width at the given \a position using the
1211     \a painter specified.
1212     The corresponding position within the text is specified by \a cursorPosition.
1213 */
1214 void QTextLayout::drawCursor(QPainter *p, const QPointF &pos, int cursorPosition, int width) const
1215 {
1216     if (d->lines.isEmpty())
1217         return;
1218
1219     if (!d->layoutData)
1220         d->itemize();
1221
1222     QPointF position = pos + d->position;
1223
1224     cursorPosition = qBound(0, cursorPosition, d->layoutData->string.length());
1225     int line = d->lineNumberForTextPosition(cursorPosition);
1226     if (line < 0)
1227         line = 0;
1228     if (line >= d->lines.size())
1229         return;
1230
1231     QTextLine l(line, d);
1232     const QScriptLine &sl = d->lines[line];
1233
1234     qreal x = position.x() + l.cursorToX(cursorPosition);
1235
1236     int itm;
1237
1238     if (d->visualCursorMovement()) {
1239         if (cursorPosition == sl.from + sl.length)
1240             cursorPosition--;
1241         itm = d->findItem(cursorPosition);
1242     } else
1243         itm = d->findItem(cursorPosition - 1);
1244
1245     QFixed base = sl.base();
1246     QFixed descent = sl.descent;
1247     bool rightToLeft = d->isRightToLeft();
1248     if (itm >= 0) {
1249         const QScriptItem &si = d->layoutData->items.at(itm);
1250         if (si.ascent > 0)
1251             base = si.ascent;
1252         if (si.descent > 0)
1253             descent = si.descent;
1254         rightToLeft = si.analysis.bidiLevel % 2;
1255     }
1256     qreal y = position.y() + (sl.y + sl.base() - base).toReal();
1257     bool toggleAntialiasing = !(p->renderHints() & QPainter::Antialiasing)
1258                               && (p->transform().type() > QTransform::TxTranslate);
1259     if (toggleAntialiasing)
1260         p->setRenderHint(QPainter::Antialiasing);
1261 #if defined(QT_MAC_USE_COCOA)
1262     // Always draw the cursor aligned to pixel boundary.
1263     x = qRound(x);
1264 #endif
1265     p->fillRect(QRectF(x, y, qreal(width), (base + descent + 1).toReal()), p->pen().brush());
1266     if (toggleAntialiasing)
1267         p->setRenderHint(QPainter::Antialiasing, false);
1268     if (d->layoutData->hasBidi) {
1269         const int arrow_extent = 4;
1270         int sign = rightToLeft ? -1 : 1;
1271         p->drawLine(QLineF(x, y, x + (sign * arrow_extent/2), y + arrow_extent/2));
1272         p->drawLine(QLineF(x, y+arrow_extent, x + (sign * arrow_extent/2), y + arrow_extent/2));
1273     }
1274     return;
1275 }
1276
1277 /*!
1278     \class QTextLine
1279     \reentrant
1280
1281     \brief The QTextLine class represents a line of text inside a QTextLayout.
1282
1283     \ingroup richtext-processing
1284
1285     A text line is usually created by QTextLayout::createLine().
1286
1287     After being created, the line can be filled using the setLineWidth()
1288     or setNumColumns() functions. A line has a number of attributes including the
1289     rectangle it occupies, rect(), its coordinates, x() and y(), its
1290     textLength(), width() and naturalTextWidth(), and its ascent() and decent()
1291     relative to the text. The position of the cursor in terms of the
1292     line is available from cursorToX() and its inverse from
1293     xToCursor(). A line can be moved with setPosition().
1294 */
1295
1296 /*!
1297     \enum QTextLine::Edge
1298
1299     \value Leading
1300     \value Trailing
1301 */
1302
1303 /*!
1304     \enum QTextLine::CursorPosition
1305
1306     \value CursorBetweenCharacters
1307     \value CursorOnCharacter
1308 */
1309
1310 /*!
1311     \fn QTextLine::QTextLine(int line, QTextEngine *e)
1312     \internal
1313
1314     Constructs a new text line using the line at position \a line in
1315     the text engine \a e.
1316 */
1317
1318 /*!
1319     \fn QTextLine::QTextLine()
1320
1321     Creates an invalid line.
1322 */
1323
1324 /*!
1325     \fn bool QTextLine::isValid() const
1326
1327     Returns true if this text line is valid; otherwise returns false.
1328 */
1329
1330 /*!
1331     \fn int QTextLine::lineNumber() const
1332
1333     Returns the position of the line in the text engine.
1334 */
1335
1336
1337 /*!
1338     Returns the line's bounding rectangle.
1339
1340     \sa x(), y(), textLength(), width()
1341 */
1342 QRectF QTextLine::rect() const
1343 {
1344     const QScriptLine& sl = eng->lines[i];
1345     return QRectF(sl.x.toReal(), sl.y.toReal(), sl.width.toReal(), sl.height().toReal());
1346 }
1347
1348 /*!
1349     Returns the rectangle covered by the line.
1350 */
1351 QRectF QTextLine::naturalTextRect() const
1352 {
1353     const QScriptLine& sl = eng->lines[i];
1354     QFixed x = sl.x + eng->alignLine(sl);
1355
1356     QFixed width = sl.textWidth;
1357     if (sl.justified)
1358         width = sl.width;
1359
1360     return QRectF(x.toReal(), sl.y.toReal(), width.toReal(), sl.height().toReal());
1361 }
1362
1363 /*!
1364     Returns the line's x position.
1365
1366     \sa rect(), y(), textLength(), width()
1367 */
1368 qreal QTextLine::x() const
1369 {
1370     return eng->lines[i].x.toReal();
1371 }
1372
1373 /*!
1374     Returns the line's y position.
1375
1376     \sa x(), rect(), textLength(), width()
1377 */
1378 qreal QTextLine::y() const
1379 {
1380     return eng->lines[i].y.toReal();
1381 }
1382
1383 /*!
1384     Returns the line's width as specified by the layout() function.
1385
1386     \sa naturalTextWidth(), x(), y(), textLength(), rect()
1387 */
1388 qreal QTextLine::width() const
1389 {
1390     return eng->lines[i].width.toReal();
1391 }
1392
1393
1394 /*!
1395     Returns the line's ascent.
1396
1397     \sa descent(), height()
1398 */
1399 qreal QTextLine::ascent() const
1400 {
1401     return eng->lines[i].ascent.toReal();
1402 }
1403
1404 /*!
1405     Returns the line's descent.
1406
1407     \sa ascent(), height()
1408 */
1409 qreal QTextLine::descent() const
1410 {
1411     return eng->lines[i].descent.toReal();
1412 }
1413
1414 /*!
1415     Returns the line's height. This is equal to ascent() + descent() + 1
1416     if leading is not included. If leading is included, this equals to
1417     ascent() + descent() + leading() + 1.
1418
1419     \sa ascent(), descent(), leading(), setLeadingIncluded()
1420 */
1421 qreal QTextLine::height() const
1422 {
1423     return eng->lines[i].height().toReal();
1424 }
1425
1426 /*!
1427     \since 4.6
1428
1429     Returns the line's leading.
1430
1431     \sa ascent(), descent(), height()
1432 */
1433 qreal QTextLine::leading() const
1434 {
1435     return eng->lines[i].leading.toReal();
1436 }
1437
1438 /*!
1439     \since 4.6
1440
1441     Includes positive leading into the line's height if \a included is true;
1442     otherwise does not include leading.
1443
1444     By default, leading is not included.
1445
1446     Note that negative leading is ignored, it must be handled
1447     in the code using the text lines by letting the lines overlap.
1448
1449     \sa leadingIncluded()
1450
1451 */
1452 void QTextLine::setLeadingIncluded(bool included)
1453 {
1454     eng->lines[i].leadingIncluded= included;
1455
1456 }
1457
1458 /*!
1459     \since 4.6
1460
1461     Returns true if positive leading is included into the line's height;
1462     otherwise returns false.
1463
1464     By default, leading is not included.
1465
1466     \sa setLeadingIncluded()
1467 */
1468 bool QTextLine::leadingIncluded() const
1469 {
1470     return eng->lines[i].leadingIncluded;
1471 }
1472
1473 /*!
1474     Returns the width of the line that is occupied by text. This is
1475     always \<= to width(), and is the minimum width that could be used
1476     by layout() without changing the line break position.
1477 */
1478 qreal QTextLine::naturalTextWidth() const
1479 {
1480     return eng->lines[i].textWidth.toReal();
1481 }
1482
1483 /*!
1484     \since 4.7
1485     Returns the horizontal advance of the text. The advance of the text
1486     is the distance from its position to the next position at which
1487     text would naturally be drawn.
1488
1489     By adding the advance to the position of the text line and using this
1490     as the position of a second text line, you will be able to position
1491     the two lines side-by-side without gaps in-between.
1492 */
1493 qreal QTextLine::horizontalAdvance() const
1494 {
1495     return eng->lines[i].textAdvance.toReal();
1496 }
1497
1498 /*!
1499     Lays out the line with the given \a width. The line is filled from
1500     its starting position with as many characters as will fit into
1501     the line. In case the text cannot be split at the end of the line,
1502     it will be filled with additional characters to the next whitespace
1503     or end of the text.
1504 */
1505 void QTextLine::setLineWidth(qreal width)
1506 {
1507     QScriptLine &line = eng->lines[i];
1508     if (!eng->layoutData) {
1509         qWarning("QTextLine: Can't set a line width while not layouting.");
1510         return;
1511     }
1512
1513     if (width > QFIXED_MAX)
1514         width = QFIXED_MAX;
1515
1516     line.width = QFixed::fromReal(width);
1517     if (line.length
1518         && line.textWidth <= line.width
1519         && line.from + line.length == eng->layoutData->string.length())
1520         // no need to do anything if the line is already layouted and the last one. This optimization helps
1521         // when using things in a single line layout.
1522         return;
1523     line.length = 0;
1524     line.textWidth = 0;
1525
1526     layout_helper(INT_MAX);
1527 }
1528
1529 /*!
1530     Lays out the line. The line is filled from its starting position
1531     with as many characters as are specified by \a numColumns. In case
1532     the text cannot be split until \a numColumns characters, the line
1533     will be filled with as many characters to the next whitespace or
1534     end of the text.
1535 */
1536 void QTextLine::setNumColumns(int numColumns)
1537 {
1538     QScriptLine &line = eng->lines[i];
1539     line.width = QFIXED_MAX;
1540     line.length = 0;
1541     line.textWidth = 0;
1542     layout_helper(numColumns);
1543 }
1544
1545 /*!
1546     Lays out the line. The line is filled from its starting position
1547     with as many characters as are specified by \a numColumns. In case
1548     the text cannot be split until \a numColumns characters, the line
1549     will be filled with as many characters to the next whitespace or
1550     end of the text. The provided \a alignmentWidth is used as reference
1551     width for alignment.
1552 */
1553 void QTextLine::setNumColumns(int numColumns, qreal alignmentWidth)
1554 {
1555     QScriptLine &line = eng->lines[i];
1556     line.width = QFixed::fromReal(alignmentWidth);
1557     line.length = 0;
1558     line.textWidth = 0;
1559     layout_helper(numColumns);
1560 }
1561
1562 #if 0
1563 #define LB_DEBUG qDebug
1564 #else
1565 #define LB_DEBUG if (0) qDebug
1566 #endif
1567
1568 namespace {
1569
1570     struct LineBreakHelper
1571     {
1572         LineBreakHelper()
1573             : glyphCount(0), maxGlyphs(0), currentPosition(0), fontEngine(0), logClusters(0),
1574               manualWrap(false), whiteSpaceOrObject(true)
1575         {
1576         }
1577
1578
1579         QScriptLine tmpData;
1580         QScriptLine spaceData;
1581
1582         QGlyphLayout glyphs;
1583
1584         int glyphCount;
1585         int maxGlyphs;
1586         int currentPosition;
1587         glyph_t previousGlyph;
1588
1589         QFixed minw;
1590         QFixed softHyphenWidth;
1591         QFixed rightBearing;
1592         QFixed minimumRightBearing;
1593
1594         QFontEngine *fontEngine;
1595         const unsigned short *logClusters;
1596
1597         bool manualWrap;
1598         bool whiteSpaceOrObject;
1599
1600         bool checkFullOtherwiseExtend(QScriptLine &line);
1601
1602         QFixed calculateNewWidth(const QScriptLine &line) const {
1603             return line.textWidth + tmpData.textWidth + spaceData.textWidth + softHyphenWidth
1604                     - qMin(rightBearing, QFixed());
1605         }
1606
1607         inline glyph_t currentGlyph() const
1608         {
1609             Q_ASSERT(currentPosition > 0);
1610             Q_ASSERT(logClusters[currentPosition - 1] < glyphs.numGlyphs);
1611
1612             return glyphs.glyphs[logClusters[currentPosition - 1]];
1613         }
1614
1615         inline void saveCurrentGlyph()
1616         {
1617             previousGlyph = 0;
1618             if (currentPosition > 0 &&
1619                 logClusters[currentPosition - 1] < glyphs.numGlyphs) {
1620                 previousGlyph = currentGlyph(); // needed to calculate right bearing later
1621             }
1622         }
1623
1624         inline void adjustRightBearing(glyph_t glyph)
1625         {
1626             qreal rb;
1627             fontEngine->getGlyphBearings(glyph, 0, &rb);
1628             rightBearing = qMin(QFixed(), QFixed::fromReal(rb));
1629         }
1630
1631         inline void adjustRightBearing()
1632         {
1633             if (currentPosition <= 0)
1634                 return;
1635             adjustRightBearing(currentGlyph());
1636         }
1637
1638         inline void adjustPreviousRightBearing()
1639         {
1640             if (previousGlyph > 0)
1641                 adjustRightBearing(previousGlyph);
1642         }
1643
1644         inline void resetRightBearing()
1645         {
1646             rightBearing = QFixed(1); // Any positive number is defined as invalid since only
1647                                       // negative right bearings are interesting to us.
1648         }
1649     };
1650
1651 inline bool LineBreakHelper::checkFullOtherwiseExtend(QScriptLine &line)
1652 {
1653     LB_DEBUG("possible break width %f, spacew=%f", tmpData.textWidth.toReal(), spaceData.textWidth.toReal());
1654
1655     QFixed newWidth = calculateNewWidth(line);
1656     if (line.length && !manualWrap && (newWidth > line.width || glyphCount > maxGlyphs))
1657         return true;
1658
1659     minw = qMax(minw, tmpData.textWidth);
1660     line += tmpData;
1661     line.textWidth += spaceData.textWidth;
1662
1663     line.length += spaceData.length;
1664     tmpData.textWidth = 0;
1665     tmpData.length = 0;
1666     spaceData.textWidth = 0;
1667     spaceData.length = 0;
1668
1669     return false;
1670 }
1671
1672 } // anonymous namespace
1673
1674
1675 static inline void addNextCluster(int &pos, int end, QScriptLine &line, int &glyphCount,
1676                                   const QScriptItem &current, const unsigned short *logClusters,
1677                                   const QGlyphLayout &glyphs)
1678 {
1679     int glyphPosition = logClusters[pos];
1680     do { // got to the first next cluster
1681         ++pos;
1682         ++line.length;
1683     } while (pos < end && logClusters[pos] == glyphPosition);
1684     do { // calculate the textWidth for the rest of the current cluster.
1685         if (!glyphs.attributes[glyphPosition].dontPrint)
1686             line.textWidth += glyphs.advances_x[glyphPosition];
1687         ++glyphPosition;
1688     } while (glyphPosition < current.num_glyphs && !glyphs.attributes[glyphPosition].clusterStart);
1689
1690     Q_ASSERT((pos == end && glyphPosition == current.num_glyphs) || logClusters[pos] == glyphPosition);
1691
1692     ++glyphCount;
1693 }
1694
1695
1696 // fill QScriptLine
1697 void QTextLine::layout_helper(int maxGlyphs)
1698 {
1699     QScriptLine &line = eng->lines[i];
1700     line.length = 0;
1701     line.textWidth = 0;
1702     line.hasTrailingSpaces = false;
1703
1704     if (!eng->layoutData->items.size() || line.from >= eng->layoutData->string.length()) {
1705         line.setDefaultHeight(eng);
1706         return;
1707     }
1708
1709     Q_ASSERT(line.from < eng->layoutData->string.length());
1710
1711     LineBreakHelper lbh;
1712
1713     lbh.maxGlyphs = maxGlyphs;
1714
1715     QTextOption::WrapMode wrapMode = eng->option.wrapMode();
1716     bool breakany = (wrapMode == QTextOption::WrapAnywhere);
1717     lbh.manualWrap = (wrapMode == QTextOption::ManualWrap || wrapMode == QTextOption::NoWrap);
1718
1719     int item = -1;
1720     int newItem = eng->findItem(line.from);
1721
1722     LB_DEBUG("from: %d: item=%d, total %d, width available %f", line.from, newItem, eng->layoutData->items.size(), line.width.toReal());
1723
1724     Qt::Alignment alignment = eng->option.alignment();
1725
1726     const HB_CharAttributes *attributes = eng->attributes();
1727     if (!attributes)
1728         return;
1729     lbh.currentPosition = line.from;
1730     int end = 0;
1731     lbh.logClusters = eng->layoutData->logClustersPtr;
1732     lbh.previousGlyph = 0;
1733
1734     while (newItem < eng->layoutData->items.size()) {
1735         lbh.resetRightBearing();
1736         lbh.softHyphenWidth = 0;
1737         if (newItem != item) {
1738             item = newItem;
1739             const QScriptItem &current = eng->layoutData->items[item];
1740             if (!current.num_glyphs) {
1741                 eng->shape(item);
1742                 attributes = eng->attributes();
1743                 if (!attributes)
1744                     return;
1745                 lbh.logClusters = eng->layoutData->logClustersPtr;
1746             }
1747             lbh.currentPosition = qMax(line.from, current.position);
1748             end = current.position + eng->length(item);
1749             lbh.glyphs = eng->shapedGlyphs(&current);
1750             QFontEngine *fontEngine = eng->fontEngine(current);
1751             if (lbh.fontEngine != fontEngine) {
1752                 lbh.fontEngine = fontEngine;
1753                 lbh.minimumRightBearing = qMin(QFixed(),
1754                                                QFixed::fromReal(fontEngine->minRightBearing()));
1755             }
1756         }
1757         const QScriptItem &current = eng->layoutData->items[item];
1758
1759         lbh.tmpData.leading = qMax(lbh.tmpData.leading + lbh.tmpData.ascent,
1760                                    current.leading + current.ascent) - qMax(lbh.tmpData.ascent,
1761                                                                             current.ascent);
1762         lbh.tmpData.ascent = qMax(lbh.tmpData.ascent, current.ascent);
1763         lbh.tmpData.descent = qMax(lbh.tmpData.descent, current.descent);
1764
1765         if (current.analysis.flags == QScriptAnalysis::Tab && (alignment & (Qt::AlignLeft | Qt::AlignRight | Qt::AlignCenter | Qt::AlignJustify))) {
1766             lbh.whiteSpaceOrObject = true;
1767             if (lbh.checkFullOtherwiseExtend(line))
1768                 goto found;
1769
1770             QFixed x = line.x + line.textWidth + lbh.tmpData.textWidth + lbh.spaceData.textWidth;
1771             QFixed tabWidth = eng->calculateTabWidth(item, x);
1772
1773             lbh.spaceData.textWidth += tabWidth;
1774             lbh.spaceData.length++;
1775             newItem = item + 1;
1776
1777             QFixed averageCharWidth = eng->fontEngine(current)->averageCharWidth();
1778             lbh.glyphCount += qRound(tabWidth / averageCharWidth);
1779
1780             if (lbh.checkFullOtherwiseExtend(line))
1781                 goto found;
1782         } else if (current.analysis.flags == QScriptAnalysis::LineOrParagraphSeparator) {
1783             lbh.whiteSpaceOrObject = true;
1784             // if the line consists only of the line separator make sure
1785             // we have a sane height
1786             if (!line.length && !lbh.tmpData.length)
1787                 line.setDefaultHeight(eng);
1788             if (eng->option.flags() & QTextOption::ShowLineAndParagraphSeparators) {
1789                 addNextCluster(lbh.currentPosition, end, lbh.tmpData, lbh.glyphCount,
1790                                current, lbh.logClusters, lbh.glyphs);
1791             } else {
1792                 lbh.tmpData.length++;
1793                 lbh.adjustPreviousRightBearing();
1794             }
1795             line += lbh.tmpData;
1796             goto found;
1797         } else if (current.analysis.flags == QScriptAnalysis::Object) {
1798             lbh.whiteSpaceOrObject = true;
1799             lbh.tmpData.length++;
1800
1801             QTextFormat format = eng->formats()->format(eng->formatIndex(&eng->layoutData->items[item]));
1802             if (eng->block.docHandle())
1803                 eng->docLayout()->positionInlineObject(QTextInlineObject(item, eng), eng->block.position() + current.position, format);
1804
1805             lbh.tmpData.textWidth += current.width;
1806
1807             newItem = item + 1;
1808             ++lbh.glyphCount;
1809             if (lbh.checkFullOtherwiseExtend(line))
1810                 goto found;
1811         } else if (attributes[lbh.currentPosition].whiteSpace) {
1812             lbh.whiteSpaceOrObject = true;
1813             while (lbh.currentPosition < end && attributes[lbh.currentPosition].whiteSpace)
1814                 addNextCluster(lbh.currentPosition, end, lbh.spaceData, lbh.glyphCount,
1815                                current, lbh.logClusters, lbh.glyphs);
1816
1817             if (!lbh.manualWrap && lbh.spaceData.textWidth > line.width) {
1818                 lbh.spaceData.textWidth = line.width; // ignore spaces that fall out of the line.
1819                 goto found;
1820             }
1821         } else {
1822             lbh.whiteSpaceOrObject = false;
1823             bool sb_or_ws = false;
1824             lbh.saveCurrentGlyph();
1825             do {
1826                 addNextCluster(lbh.currentPosition, end, lbh.tmpData, lbh.glyphCount,
1827                                current, lbh.logClusters, lbh.glyphs);
1828
1829                 if (attributes[lbh.currentPosition].whiteSpace || attributes[lbh.currentPosition-1].lineBreakType != HB_NoBreak) {
1830                     sb_or_ws = true;
1831                     break;
1832                 } else if (breakany && attributes[lbh.currentPosition].charStop) {
1833                     break;
1834                 }
1835             } while (lbh.currentPosition < end);
1836             lbh.minw = qMax(lbh.tmpData.textWidth, lbh.minw);
1837
1838             if (lbh.currentPosition && attributes[lbh.currentPosition - 1].lineBreakType == HB_SoftHyphen) {
1839                 // if we are splitting up a word because of
1840                 // a soft hyphen then we ...
1841                 //
1842                 //  a) have to take the width of the soft hyphen into
1843                 //     account to see if the first syllable(s) /and/
1844                 //     the soft hyphen fit into the line
1845                 //
1846                 //  b) if we are so short of available width that the
1847                 //     soft hyphen is the first breakable position, then
1848                 //     we don't want to show it. However we initially
1849                 //     have to take the width for it into account so that
1850                 //     the text document layout sees the overflow and
1851                 //     switch to break-anywhere mode, in which we
1852                 //     want the soft-hyphen to slip into the next line
1853                 //     and thus become invisible again.
1854                 //
1855                 if (line.length)
1856                     lbh.softHyphenWidth = lbh.glyphs.advances_x[lbh.logClusters[lbh.currentPosition - 1]];
1857                 else if (breakany)
1858                     lbh.tmpData.textWidth += lbh.glyphs.advances_x[lbh.logClusters[lbh.currentPosition - 1]];
1859             }
1860
1861             // The actual width of the text needs to take the right bearing into account. The
1862             // right bearing is left-ward, which means that if the rightmost pixel is to the right
1863             // of the advance of the glyph, the bearing will be negative. We flip the sign
1864             // for the code to be more readable. Logic borrowed from qfontmetrics.cpp.
1865             // We ignore the right bearing if the minimum negative bearing is too little to
1866             // expand the text beyond the edge.
1867             if (sb_or_ws|breakany) {
1868                 QFixed rightBearing = lbh.rightBearing; // store previous right bearing
1869 #if !defined(Q_WS_MAC)
1870                 if (lbh.calculateNewWidth(line) - lbh.minimumRightBearing > line.width)
1871 #endif
1872                     lbh.adjustRightBearing();
1873                 if (lbh.checkFullOtherwiseExtend(line)) {
1874                     // we are too wide, fix right bearing
1875                     if (rightBearing <= 0)
1876                         lbh.rightBearing = rightBearing; // take from cache
1877                     else
1878                         lbh.adjustPreviousRightBearing();
1879
1880                     if (!breakany) {
1881                         line.textWidth += lbh.softHyphenWidth;
1882                     }
1883
1884                     goto found;
1885                 }
1886             }
1887             lbh.saveCurrentGlyph();
1888         }
1889         if (lbh.currentPosition == end)
1890             newItem = item + 1;
1891     }
1892     LB_DEBUG("reached end of line");
1893     lbh.checkFullOtherwiseExtend(line);
1894 found:
1895     if (lbh.rightBearing > 0 && !lbh.whiteSpaceOrObject) // If right bearing has not yet been adjusted
1896         lbh.adjustRightBearing();
1897     line.textAdvance = line.textWidth;
1898     line.textWidth -= qMin(QFixed(), lbh.rightBearing);
1899
1900     if (line.length == 0) {
1901         LB_DEBUG("no break available in line, adding temp: length %d, width %f, space: length %d, width %f",
1902                lbh.tmpData.length, lbh.tmpData.textWidth.toReal(),
1903                lbh.spaceData.length, lbh.spaceData.textWidth.toReal());
1904         line += lbh.tmpData;
1905     }
1906
1907     LB_DEBUG("line length = %d, ascent=%f, descent=%f, textWidth=%f (spacew=%f)", line.length, line.ascent.toReal(),
1908            line.descent.toReal(), line.textWidth.toReal(), lbh.spaceData.width.toReal());
1909     LB_DEBUG("        : '%s'", eng->layoutData->string.mid(line.from, line.length).toUtf8().data());
1910
1911     if (lbh.manualWrap) {
1912         eng->minWidth = qMax(eng->minWidth, line.textWidth);
1913         eng->maxWidth = qMax(eng->maxWidth, line.textWidth);
1914     } else {
1915         eng->minWidth = qMax(eng->minWidth, lbh.minw);
1916         eng->maxWidth += line.textWidth;
1917     }
1918
1919     if (line.textWidth > 0 && item < eng->layoutData->items.size())
1920         eng->maxWidth += lbh.spaceData.textWidth;
1921     if (eng->option.flags() & QTextOption::IncludeTrailingSpaces)
1922         line.textWidth += lbh.spaceData.textWidth;
1923     if (lbh.spaceData.length) {
1924         line.length += lbh.spaceData.length;
1925         line.hasTrailingSpaces = true;
1926     }
1927
1928     line.justified = false;
1929     line.gridfitted = false;
1930
1931     if (eng->option.wrapMode() == QTextOption::WrapAtWordBoundaryOrAnywhere) {
1932         if ((lbh.maxGlyphs != INT_MAX && lbh.glyphCount > lbh.maxGlyphs)
1933             || (lbh.maxGlyphs == INT_MAX && line.textWidth > line.width)) {
1934
1935             eng->option.setWrapMode(QTextOption::WrapAnywhere);
1936             line.length = 0;
1937             line.textWidth = 0;
1938             layout_helper(lbh.maxGlyphs);
1939             eng->option.setWrapMode(QTextOption::WrapAtWordBoundaryOrAnywhere);
1940         }
1941     }
1942 }
1943
1944 /*!
1945     Moves the line to position \a pos.
1946 */
1947 void QTextLine::setPosition(const QPointF &pos)
1948 {
1949     eng->lines[i].x = QFixed::fromReal(pos.x());
1950     eng->lines[i].y = QFixed::fromReal(pos.y());
1951 }
1952
1953 /*!
1954     Returns the line's position relative to the text layout's position.
1955 */
1956 QPointF QTextLine::position() const
1957 {
1958     return QPointF(eng->lines[i].x.toReal(), eng->lines[i].y.toReal());
1959 }
1960
1961 // ### DOC: I have no idea what this means/does.
1962 // You create a text layout with a string of text. Once you laid
1963 // it out, it contains a number of QTextLines. from() returns the position
1964 // inside the text string where this line starts. If you e.g. has a
1965 // text of "This is a string", laid out into two lines (the second
1966 // starting at the word 'a'), layout.lineAt(0).from() == 0 and
1967 // layout.lineAt(1).from() == 8.
1968 /*!
1969     Returns the start of the line from the beginning of the string
1970     passed to the QTextLayout.
1971 */
1972 int QTextLine::textStart() const
1973 {
1974     return eng->lines[i].from;
1975 }
1976
1977 /*!
1978     Returns the length of the text in the line.
1979
1980     \sa naturalTextWidth()
1981 */
1982 int QTextLine::textLength() const
1983 {
1984     if (eng->option.flags() & QTextOption::ShowLineAndParagraphSeparators
1985         && eng->block.isValid() && i == eng->lines.count()-1) {
1986         return eng->lines[i].length - 1;
1987     }
1988     return eng->lines[i].length;
1989 }
1990
1991 static void drawMenuText(QPainter *p, QFixed x, QFixed y, const QScriptItem &si, QTextItemInt &gf, QTextEngine *eng,
1992                          int start, int glyph_start)
1993 {
1994     int ge = glyph_start + gf.glyphs.numGlyphs;
1995     int gs = glyph_start;
1996     int end = start + gf.num_chars;
1997     unsigned short *logClusters = eng->logClusters(&si);
1998     QGlyphLayout glyphs = eng->shapedGlyphs(&si);
1999     QFixed orig_width = gf.width;
2000
2001     int *ul = eng->underlinePositions;
2002     if (ul)
2003         while (*ul != -1 && *ul < start)
2004             ++ul;
2005     bool rtl = si.analysis.bidiLevel % 2;
2006     if (rtl)
2007         x += si.width;
2008
2009     do {
2010         int gtmp = ge;
2011         int stmp = end;
2012         if (ul && *ul != -1 && *ul < end) {
2013             stmp = *ul;
2014             gtmp = logClusters[*ul-si.position];
2015         }
2016
2017         gf.glyphs = glyphs.mid(gs, gtmp - gs);
2018         gf.num_chars = stmp - start;
2019         gf.chars = eng->layoutData->string.unicode() + start;
2020         QFixed w = 0;
2021         while (gs < gtmp) {
2022             w += glyphs.effectiveAdvance(gs);
2023             ++gs;
2024         }
2025         start = stmp;
2026         gf.width = w;
2027         if (rtl)
2028             x -= w;
2029         if (gf.num_chars)
2030             p->drawTextItem(QPointF(x.toReal(), y.toReal()), gf);
2031         if (!rtl)
2032             x += w;
2033         if (ul && *ul != -1 && *ul < end) {
2034             // draw underline
2035             gtmp = (*ul == end-1) ? ge : logClusters[*ul+1-si.position];
2036             ++stmp;
2037             gf.glyphs = glyphs.mid(gs, gtmp - gs);
2038             gf.num_chars = stmp - start;
2039             gf.chars = eng->layoutData->string.unicode() + start;
2040             gf.logClusters = logClusters + start - si.position;
2041             w = 0;
2042             while (gs < gtmp) {
2043                 w += glyphs.effectiveAdvance(gs);
2044                 ++gs;
2045             }
2046             ++start;
2047             gf.width = w;
2048             gf.underlineStyle = QTextCharFormat::SingleUnderline;
2049             if (rtl)
2050                 x -= w;
2051             p->drawTextItem(QPointF(x.toReal(), y.toReal()), gf);
2052             if (!rtl)
2053                 x += w;
2054             gf.underlineStyle = QTextCharFormat::NoUnderline;
2055             ++gf.chars;
2056             ++ul;
2057         }
2058     } while (gs < ge);
2059
2060     gf.width = orig_width;
2061 }
2062
2063
2064 static void setPenAndDrawBackground(QPainter *p, const QPen &defaultPen, const QTextCharFormat &chf, const QRectF &r)
2065 {
2066     QBrush c = chf.foreground();
2067     if (c.style() == Qt::NoBrush) {
2068         p->setPen(defaultPen);
2069     }
2070
2071     QBrush bg = chf.background();
2072     if (bg.style() != Qt::NoBrush && !chf.property(SuppressBackground).toBool())
2073         p->fillRect(r, bg);
2074     if (c.style() != Qt::NoBrush) {
2075         p->setPen(QPen(c, 0));
2076     }
2077
2078 }
2079
2080 namespace {
2081     struct GlyphInfo
2082     {
2083         GlyphInfo(const QGlyphLayout &layout, const QPointF &position,
2084                   const QTextItemInt::RenderFlags &renderFlags)
2085             : glyphLayout(layout), itemPosition(position), flags(renderFlags)
2086         {
2087         }
2088
2089         QGlyphLayout glyphLayout;
2090         QPointF itemPosition;
2091         QTextItem::RenderFlags flags;
2092     };
2093 }
2094
2095 /*!
2096     Returns the glyph indexes and positions for all glyphs in this QTextLine for characters
2097     in the range defined by \a from and \a length. The \a from index is relative to the beginning
2098     of the text in the containing QTextLayout, and the range must be within the range of QTextLine
2099     as given by functions textStart() and textLength().
2100
2101     If \a from is negative, it will default to textStart(), and if \a length is negative it will
2102     default to the return value of textLength().
2103
2104     \since 5.0
2105
2106     \sa QTextLayout::glyphRuns()
2107 */
2108 #if !defined(QT_NO_RAWFONT)
2109 QList<QGlyphRun> QTextLine::glyphRuns(int from, int length) const
2110 {
2111     const QScriptLine &line = eng->lines[i];
2112
2113     if (line.length == 0)
2114         return QList<QGlyphRun>();
2115
2116     if (from < 0)
2117         from = textStart();
2118
2119     if (length < 0)
2120         length = textLength();
2121
2122     QHash<QFontEngine *, GlyphInfo> glyphLayoutHash;
2123
2124     QTextLineItemIterator iterator(eng, i);
2125     qreal y = line.y.toReal() + line.base().toReal();
2126     while (!iterator.atEnd()) {
2127         QScriptItem &si = iterator.next();
2128         if (si.analysis.flags >= QScriptAnalysis::TabOrObject)
2129             continue;
2130
2131         QPointF pos(iterator.x.toReal(), y);
2132         if (from >= 0 && length >= 0 &&
2133             (from >= si.position + eng->length(&si) || from + length <= si.position)) {
2134             continue;
2135         }
2136
2137         QFont font = eng->font(si);
2138
2139         QTextItem::RenderFlags flags;
2140         if (font.overline())
2141             flags |= QTextItem::Overline;
2142         if (font.underline())
2143             flags |= QTextItem::Underline;
2144         if (font.strikeOut())
2145             flags |= QTextItem::StrikeOut;
2146
2147         bool rtl = false;
2148         if (si.analysis.bidiLevel % 2) {
2149             flags |= QTextItem::RightToLeft;
2150             rtl = true;
2151         }
2152
2153         int relativeFrom = qMax(iterator.itemStart, from) - si.position;
2154         int relativeTo = qMin(iterator.itemEnd, from + length - 1) - si.position;
2155
2156         unsigned short *logClusters = eng->logClusters(&si);
2157         int glyphsStart = logClusters[relativeFrom];
2158         int glyphsEnd = (relativeTo == eng->length(&si))
2159                          ? si.num_glyphs - 1
2160                          : logClusters[relativeTo];
2161
2162         QGlyphLayout glyphLayout = eng->shapedGlyphs(&si);
2163
2164         // Calculate new x position of glyph layout for a subset. This becomes somewhat complex
2165         // when we're breaking a RTL script item, since the expected position passed into
2166         // getGlyphPositions() is the left-most edge of the left-most glyph in an RTL run.
2167         if (relativeFrom != (iterator.itemStart - si.position) && !rtl) {
2168             for (int i=0; i<glyphsStart; ++i) {
2169                 QFixed justification = QFixed::fromFixed(glyphLayout.justifications[i].space_18d6);
2170                 pos += QPointF((glyphLayout.advances_x[i] + justification).toReal(),
2171                                glyphLayout.advances_y[i].toReal());
2172             }
2173         } else if (relativeTo != (iterator.itemEnd - si.position) && rtl) {
2174             for (int i=glyphLayout.numGlyphs - 1; i>glyphsEnd; --i) {
2175                 QFixed justification = QFixed::fromFixed(glyphLayout.justifications[i].space_18d6);
2176                 pos += QPointF((glyphLayout.advances_x[i] + justification).toReal(),
2177                                glyphLayout.advances_y[i].toReal());
2178             }
2179         }
2180
2181         glyphLayout = glyphLayout.mid(glyphsStart, glyphsEnd - glyphsStart + 1);
2182
2183         if (glyphLayout.numGlyphs > 0) {
2184             QFontEngine *mainFontEngine = font.d->engineForScript(si.analysis.script);
2185             if (mainFontEngine->type() == QFontEngine::Multi) {
2186                 QFontEngineMulti *multiFontEngine = static_cast<QFontEngineMulti *>(mainFontEngine);
2187                 int start = 0;
2188                 int end;
2189                 int which = glyphLayout.glyphs[0] >> 24;
2190                 for (end = 0; end < glyphLayout.numGlyphs; ++end) {
2191                     const int e = glyphLayout.glyphs[end] >> 24;
2192                     if (e == which)
2193                         continue;
2194
2195                     QGlyphLayout subLayout = glyphLayout.mid(start, end - start);
2196                     glyphLayoutHash.insertMulti(multiFontEngine->engine(which),
2197                                                 GlyphInfo(subLayout, pos, flags));
2198                     for (int i = 0; i < subLayout.numGlyphs; i++) {
2199                         pos += QPointF(subLayout.advances_x[i].toReal(),
2200                                        subLayout.advances_y[i].toReal());
2201                     }
2202
2203                     start = end;
2204                     which = e;
2205                 }
2206
2207                 QGlyphLayout subLayout = glyphLayout.mid(start, end - start);
2208                 glyphLayoutHash.insertMulti(multiFontEngine->engine(which),
2209                                             GlyphInfo(subLayout, pos, flags));
2210
2211             } else {
2212                 glyphLayoutHash.insertMulti(mainFontEngine,
2213                                             GlyphInfo(glyphLayout, pos, flags));
2214             }
2215         }
2216     }
2217
2218     QHash<QPair<QFontEngine *, int>, QGlyphRun> glyphsHash;
2219
2220     QList<QFontEngine *> keys = glyphLayoutHash.uniqueKeys();
2221     for (int i=0; i<keys.size(); ++i) {
2222         QFontEngine *fontEngine = keys.at(i);
2223
2224         // Make a font for this particular engine
2225         QRawFont font;
2226         QRawFontPrivate *fontD = QRawFontPrivate::get(font);
2227         fontD->fontEngine = fontEngine;
2228         fontD->fontEngine->ref.ref();
2229
2230 #if defined(Q_WS_WIN)
2231         if (fontEngine->supportsSubPixelPositions())
2232             fontD->hintingPreference = QFont::PreferVerticalHinting;
2233         else
2234             fontD->hintingPreference = QFont::PreferFullHinting;
2235 #elif defined(Q_WS_MAC)
2236         fontD->hintingPreference = QFont::PreferNoHinting;
2237 #elif !defined(QT_NO_FREETYPE)
2238         if (fontEngine->type() == QFontEngine::Freetype) {
2239             QFontEngineFT *freeTypeEngine = static_cast<QFontEngineFT *>(fontEngine);
2240             switch (freeTypeEngine->defaultHintStyle()) {
2241             case QFontEngineFT::HintNone:
2242                 fontD->hintingPreference = QFont::PreferNoHinting;
2243                 break;
2244             case QFontEngineFT::HintLight:
2245                 fontD->hintingPreference = QFont::PreferVerticalHinting;
2246                 break;
2247             case QFontEngineFT::HintMedium:
2248             case QFontEngineFT::HintFull:
2249                 fontD->hintingPreference = QFont::PreferFullHinting;
2250                 break;
2251             };
2252         }
2253 #endif
2254
2255         QList<GlyphInfo> glyphLayouts = glyphLayoutHash.values(fontEngine);
2256         for (int j=0; j<glyphLayouts.size(); ++j) {
2257             const QPointF &pos = glyphLayouts.at(j).itemPosition;
2258             const QGlyphLayout &glyphLayout = glyphLayouts.at(j).glyphLayout;
2259             const QTextItem::RenderFlags &flags = glyphLayouts.at(j).flags;
2260
2261             QVarLengthArray<glyph_t> glyphsArray;
2262             QVarLengthArray<QFixedPoint> positionsArray;
2263
2264             fontEngine->getGlyphPositions(glyphLayout, QTransform(), flags, glyphsArray,
2265                                           positionsArray);
2266             Q_ASSERT(glyphsArray.size() == positionsArray.size());
2267
2268             QVector<quint32> glyphs;
2269             QVector<QPointF> positions;
2270             for (int i=0; i<glyphsArray.size(); ++i) {
2271                 glyphs.append(glyphsArray.at(i) & 0xffffff);
2272                 positions.append(positionsArray.at(i).toPointF() + pos);
2273             }
2274
2275             QGlyphRun glyphIndexes;
2276             glyphIndexes.setGlyphIndexes(glyphs);
2277             glyphIndexes.setPositions(positions);
2278
2279             glyphIndexes.setOverline(flags.testFlag(QTextItem::Overline));
2280             glyphIndexes.setUnderline(flags.testFlag(QTextItem::Underline));
2281             glyphIndexes.setStrikeOut(flags.testFlag(QTextItem::StrikeOut));
2282             glyphIndexes.setRawFont(font);
2283
2284             QPair<QFontEngine *, int> key(fontEngine, int(flags));
2285             if (!glyphsHash.contains(key))
2286                 glyphsHash.insert(key, glyphIndexes);
2287             else
2288                 glyphsHash[key] += glyphIndexes;
2289         }
2290     }
2291
2292     return glyphsHash.values();
2293 }
2294 #endif // QT_NO_RAWFONT
2295
2296 /*!
2297     \fn void QTextLine::draw(QPainter *painter, const QPointF &position, const QTextLayout::FormatRange *selection) const
2298
2299     Draws a line on the given \a painter at the specified \a position.
2300     The \a selection is reserved for internal use.
2301 */
2302 void QTextLine::draw(QPainter *p, const QPointF &pos, const QTextLayout::FormatRange *selection) const
2303 {
2304     const QScriptLine &line = eng->lines[i];
2305     QPen pen = p->pen();
2306
2307     bool noText = (selection && selection->format.property(SuppressText).toBool());
2308
2309     if (!line.length) {
2310         if (selection
2311             && selection->start <= line.from
2312             && selection->start + selection->length > line.from) {
2313
2314             const qreal lineHeight = line.height().toReal();
2315             QRectF r(pos.x() + line.x.toReal(), pos.y() + line.y.toReal(),
2316                      lineHeight / 2, QFontMetrics(eng->font()).width(QLatin1Char(' ')));
2317             setPenAndDrawBackground(p, QPen(), selection->format, r);
2318             p->setPen(pen);
2319         }
2320         return;
2321     }
2322
2323
2324     QTextLineItemIterator iterator(eng, i, pos, selection);
2325     QFixed lineBase = line.base();
2326
2327     const QFixed y = QFixed::fromReal(pos.y()) + line.y + lineBase;
2328
2329     bool suppressColors = (eng->option.flags() & QTextOption::SuppressColors);
2330     while (!iterator.atEnd()) {
2331         QScriptItem &si = iterator.next();
2332
2333         if (selection && selection->start >= 0 && iterator.isOutsideSelection())
2334             continue;
2335
2336         if (si.analysis.flags == QScriptAnalysis::LineOrParagraphSeparator
2337             && !(eng->option.flags() & QTextOption::ShowLineAndParagraphSeparators))
2338             continue;
2339
2340         QFixed itemBaseLine = y;
2341         QFont f = eng->font(si);
2342         QTextCharFormat format;
2343
2344         if (eng->hasFormats() || selection) {
2345             format = eng->format(&si);
2346             if (suppressColors) {
2347                 format.clearForeground();
2348                 format.clearBackground();
2349                 format.clearProperty(QTextFormat::TextUnderlineColor);
2350             }
2351             if (selection)
2352                 format.merge(selection->format);
2353
2354             setPenAndDrawBackground(p, pen, format, QRectF(iterator.x.toReal(), (y - lineBase).toReal(),
2355                                                            iterator.itemWidth.toReal(), line.height().toReal()));
2356
2357             QTextCharFormat::VerticalAlignment valign = format.verticalAlignment();
2358             if (valign == QTextCharFormat::AlignSuperScript || valign == QTextCharFormat::AlignSubScript) {
2359                 QFontEngine *fe = f.d->engineForScript(si.analysis.script);
2360                 QFixed height = fe->ascent() + fe->descent();
2361                 if (valign == QTextCharFormat::AlignSubScript)
2362                     itemBaseLine += height / 6;
2363                 else if (valign == QTextCharFormat::AlignSuperScript)
2364                     itemBaseLine -= height / 2;
2365             }
2366         }
2367
2368         if (si.analysis.flags >= QScriptAnalysis::TabOrObject) {
2369
2370             if (eng->hasFormats()) {
2371                 p->save();
2372                 if (si.analysis.flags == QScriptAnalysis::Object && eng->block.docHandle()) {
2373                     QFixed itemY = y - si.ascent;
2374                     if (format.verticalAlignment() == QTextCharFormat::AlignTop) {
2375                         itemY = y - lineBase;
2376                     }
2377
2378                     QRectF itemRect(iterator.x.toReal(), itemY.toReal(), iterator.itemWidth.toReal(), si.height().toReal());
2379
2380                     eng->docLayout()->drawInlineObject(p, itemRect,
2381                                                        QTextInlineObject(iterator.item, eng),
2382                                                        si.position + eng->block.position(),
2383                                                        format);
2384                     if (selection) {
2385                         QBrush bg = format.brushProperty(ObjectSelectionBrush);
2386                         if (bg.style() != Qt::NoBrush) {
2387                             QColor c = bg.color();
2388                             c.setAlpha(128);
2389                             p->fillRect(itemRect, c);
2390                         }
2391                     }
2392                 } else { // si.isTab
2393                     QFont f = eng->font(si);
2394                     QTextItemInt gf(si, &f, format);
2395                     gf.chars = 0;
2396                     gf.num_chars = 0;
2397                     gf.width = iterator.itemWidth;
2398                     p->drawTextItem(QPointF(iterator.x.toReal(), y.toReal()), gf);
2399                     if (eng->option.flags() & QTextOption::ShowTabsAndSpaces) {
2400                         QChar visualTab(0x2192);
2401                         int w = QFontMetrics(f).width(visualTab);
2402                         qreal x = iterator.itemWidth.toReal() - w; // Right-aligned
2403                         if (x < 0)
2404                              p->setClipRect(QRectF(iterator.x.toReal(), line.y.toReal(),
2405                                                    iterator.itemWidth.toReal(), line.height().toReal()),
2406                                             Qt::IntersectClip);
2407                         else
2408                              x /= 2; // Centered
2409                         p->drawText(QPointF(iterator.x.toReal() + x,
2410                                             y.toReal()), visualTab);
2411                     }
2412
2413                 }
2414                 p->restore();
2415             }
2416
2417             continue;
2418         }
2419
2420         unsigned short *logClusters = eng->logClusters(&si);
2421         QGlyphLayout glyphs = eng->shapedGlyphs(&si);
2422
2423         QTextItemInt gf(si, &f, format);
2424         gf.glyphs = glyphs.mid(iterator.glyphsStart, iterator.glyphsEnd - iterator.glyphsStart);
2425         gf.chars = eng->layoutData->string.unicode() + iterator.itemStart;
2426         gf.logClusters = logClusters + iterator.itemStart - si.position;
2427         gf.num_chars = iterator.itemEnd - iterator.itemStart;
2428         gf.width = iterator.itemWidth;
2429         gf.justified = line.justified;
2430
2431         Q_ASSERT(gf.fontEngine);
2432
2433         if (eng->underlinePositions) {
2434             // can't have selections in this case
2435             drawMenuText(p, iterator.x, itemBaseLine, si, gf, eng, iterator.itemStart, iterator.glyphsStart);
2436         } else {
2437             QPointF pos(iterator.x.toReal(), itemBaseLine.toReal());
2438             if (format.penProperty(QTextFormat::TextOutline).style() != Qt::NoPen) {
2439                 QPainterPath path;
2440                 path.setFillRule(Qt::WindingFill);
2441
2442                 if (gf.glyphs.numGlyphs)
2443                     gf.fontEngine->addOutlineToPath(pos.x(), pos.y(), gf.glyphs, &path, gf.flags);
2444                 if (gf.flags) {
2445                     const QFontEngine *fe = gf.fontEngine;
2446                     const qreal lw = fe->lineThickness().toReal();
2447                     if (gf.flags & QTextItem::Underline) {
2448                         qreal offs = fe->underlinePosition().toReal();
2449                         path.addRect(pos.x(), pos.y() + offs, gf.width.toReal(), lw);
2450                     }
2451                     if (gf.flags & QTextItem::Overline) {
2452                         qreal offs = fe->ascent().toReal() + 1;
2453                         path.addRect(pos.x(), pos.y() - offs, gf.width.toReal(), lw);
2454                     }
2455                     if (gf.flags & QTextItem::StrikeOut) {
2456                         qreal offs = fe->ascent().toReal() / 3;
2457                         path.addRect(pos.x(), pos.y() - offs, gf.width.toReal(), lw);
2458                     }
2459                 }
2460
2461                 p->save();
2462                 p->setRenderHint(QPainter::Antialiasing);
2463                 //Currently QPen with a Qt::NoPen style still returns a default
2464                 //QBrush which != Qt::NoBrush so we need this specialcase to reset it
2465                 if (p->pen().style() == Qt::NoPen)
2466                     p->setBrush(Qt::NoBrush);
2467                 else
2468                     p->setBrush(p->pen().brush());
2469
2470                 p->setPen(format.textOutline());
2471                 p->drawPath(path);
2472                 p->restore();
2473             } else {
2474                 if (noText)
2475                     gf.glyphs.numGlyphs = 0; // slightly less elegant than it should be
2476                 p->drawTextItem(pos, gf);
2477             }
2478         }
2479         if (si.analysis.flags == QScriptAnalysis::Space
2480             && (eng->option.flags() & QTextOption::ShowTabsAndSpaces)) {
2481             QBrush c = format.foreground();
2482             if (c.style() != Qt::NoBrush)
2483                 p->setPen(c.color());
2484             QChar visualSpace((ushort)0xb7);
2485             p->drawText(QPointF(iterator.x.toReal(), itemBaseLine.toReal()), visualSpace);
2486             p->setPen(pen);
2487         }
2488     }
2489
2490
2491     if (eng->hasFormats())
2492         p->setPen(pen);
2493 }
2494
2495 /*!
2496     \fn int QTextLine::cursorToX(int cursorPos, Edge edge) const
2497
2498     \overload
2499 */
2500
2501 /*!
2502     Converts the cursor position \a cursorPos to the corresponding x position
2503     inside the line, taking account of the \a edge.
2504
2505     If \a cursorPos is not a valid cursor position, the nearest valid
2506     cursor position will be used instead, and cpos will be modified to
2507     point to this valid cursor position.
2508
2509     \sa xToCursor()
2510 */
2511 qreal QTextLine::cursorToX(int *cursorPos, Edge edge) const
2512 {
2513     if (!eng->layoutData)
2514         eng->itemize();
2515
2516     const QScriptLine &line = eng->lines[i];
2517     bool lastLine = i >= eng->lines.size() - 1;
2518
2519     QFixed x = line.x;
2520     x += eng->alignLine(line);
2521
2522     if (!i && !eng->layoutData->items.size()) {
2523         *cursorPos = 0;
2524         return x.toReal();
2525     }
2526
2527     int pos = *cursorPos;
2528     int itm;
2529     if (pos == line.from + (int)line.length) {
2530         // end of line ensure we have the last item on the line
2531         itm = eng->findItem(pos-1);
2532     }
2533     else
2534         itm = eng->findItem(pos);
2535     eng->shapeLine(line);
2536
2537     const QScriptItem *si = &eng->layoutData->items[itm];
2538     if (!si->num_glyphs)
2539         eng->shape(itm);
2540     pos -= si->position;
2541
2542     QGlyphLayout glyphs = eng->shapedGlyphs(si);
2543     unsigned short *logClusters = eng->logClusters(si);
2544     Q_ASSERT(logClusters);
2545
2546     int l = eng->length(itm);
2547     if (pos > l)
2548         pos = l;
2549     if (pos < 0)
2550         pos = 0;
2551
2552     int glyph_pos = pos == l ? si->num_glyphs : logClusters[pos];
2553     if (edge == Trailing && glyph_pos < si->num_glyphs) {
2554         // trailing edge is leading edge of next cluster
2555         glyph_pos++;
2556         while (glyph_pos < si->num_glyphs && !glyphs.attributes[glyph_pos].clusterStart)
2557             glyph_pos++;
2558     }
2559
2560     bool reverse = eng->layoutData->items[itm].analysis.bidiLevel % 2;
2561
2562     int lineEnd = line.from + line.length;
2563
2564     // add the items left of the cursor
2565
2566     int firstItem = eng->findItem(line.from);
2567     int lastItem = eng->findItem(lineEnd - 1);
2568     int nItems = (firstItem >= 0 && lastItem >= firstItem)? (lastItem-firstItem+1) : 0;
2569
2570     QVarLengthArray<int> visualOrder(nItems);
2571     QVarLengthArray<uchar> levels(nItems);
2572     for (int i = 0; i < nItems; ++i)
2573         levels[i] = eng->layoutData->items[i+firstItem].analysis.bidiLevel;
2574     QTextEngine::bidiReorder(nItems, levels.data(), visualOrder.data());
2575
2576     for (int i = 0; i < nItems; ++i) {
2577         int item = visualOrder[i]+firstItem;
2578         if (item == itm)
2579             break;
2580         QScriptItem &si = eng->layoutData->items[item];
2581         if (!si.num_glyphs)
2582             eng->shape(item);
2583
2584         if (si.analysis.flags >= QScriptAnalysis::TabOrObject) {
2585             x += si.width;
2586             continue;
2587         }
2588         int start = qMax(line.from, si.position);
2589         int end = qMin(lineEnd, si.position + eng->length(item));
2590
2591         logClusters = eng->logClusters(&si);
2592
2593         int gs = logClusters[start-si.position];
2594         int ge = (end == si.position + eng->length(item)) ? si.num_glyphs-1 : logClusters[end-si.position-1];
2595
2596         QGlyphLayout glyphs = eng->shapedGlyphs(&si);
2597
2598         while (gs <= ge) {
2599             x += glyphs.effectiveAdvance(gs);
2600             ++gs;
2601         }
2602     }
2603
2604     logClusters = eng->logClusters(si);
2605     glyphs = eng->shapedGlyphs(si);
2606     if (si->analysis.flags >= QScriptAnalysis::TabOrObject) {
2607         if (pos == (reverse ? 0 : l))
2608             x += si->width;
2609     } else {
2610         bool rtl = eng->isRightToLeft();
2611         bool visual = eng->visualCursorMovement();
2612         if (reverse) {
2613             int end = qMin(lineEnd, si->position + l) - si->position;
2614             int glyph_end = end == l ? si->num_glyphs : logClusters[end];
2615             int glyph_start = glyph_pos;
2616             if (visual && !rtl && !(lastLine && itm == (visualOrder[nItems - 1] + firstItem)))
2617                 glyph_start++;
2618             for (int i = glyph_end - 1; i >= glyph_start; i--)
2619                 x += glyphs.effectiveAdvance(i);
2620         } else {
2621             int start = qMax(line.from - si->position, 0);
2622             int glyph_start = logClusters[start];
2623             int glyph_end = glyph_pos;
2624             if (!visual || !rtl || (lastLine && itm == visualOrder[0] + firstItem))
2625                 glyph_end--;
2626             for (int i = glyph_start; i <= glyph_end; i++)
2627                 x += glyphs.effectiveAdvance(i);
2628         }
2629         x += eng->offsetInLigature(si, pos, line.length, glyph_pos);
2630     }
2631
2632     *cursorPos = pos + si->position;
2633     return x.toReal();
2634 }
2635
2636 /*!
2637     \fn int QTextLine::xToCursor(qreal x, CursorPosition cpos) const
2638
2639     Converts the x-coordinate \a x, to the nearest matching cursor
2640     position, depending on the cursor position type, \a cpos.
2641
2642     \sa cursorToX()
2643 */
2644 int QTextLine::xToCursor(qreal _x, CursorPosition cpos) const
2645 {
2646     QFixed x = QFixed::fromReal(_x);
2647     const QScriptLine &line = eng->lines[i];
2648     bool lastLine = i >= eng->lines.size() - 1;
2649     int lineNum = i;
2650
2651     if (!eng->layoutData)
2652         eng->itemize();
2653
2654     int line_length = textLength();
2655
2656     if (!line_length)
2657         return line.from;
2658
2659     int firstItem = eng->findItem(line.from);
2660     int lastItem = eng->findItem(line.from + line_length - 1);
2661     int nItems = (firstItem >= 0 && lastItem >= firstItem)? (lastItem-firstItem+1) : 0;
2662
2663     if (!nItems)
2664         return 0;
2665
2666     x -= line.x;
2667     x -= eng->alignLine(line);
2668 //     qDebug("xToCursor: x=%f, cpos=%d", x.toReal(), cpos);
2669
2670     QVarLengthArray<int> visualOrder(nItems);
2671     QVarLengthArray<unsigned char> levels(nItems);
2672     for (int i = 0; i < nItems; ++i)
2673         levels[i] = eng->layoutData->items[i+firstItem].analysis.bidiLevel;
2674     QTextEngine::bidiReorder(nItems, levels.data(), visualOrder.data());
2675
2676     bool visual = eng->visualCursorMovement();
2677     if (x <= 0) {
2678         // left of first item
2679         int item = visualOrder[0]+firstItem;
2680         QScriptItem &si = eng->layoutData->items[item];
2681         if (!si.num_glyphs)
2682             eng->shape(item);
2683         int pos = si.position;
2684         if (si.analysis.bidiLevel % 2)
2685             pos += eng->length(item);
2686         pos = qMax(line.from, pos);
2687         pos = qMin(line.from + line_length, pos);
2688         return pos;
2689     } else if (x < line.textWidth
2690                || (line.justified && x < line.width)) {
2691         // has to be in one of the runs
2692         QFixed pos;
2693         bool rtl = eng->isRightToLeft();
2694
2695         eng->shapeLine(line);
2696         QVector<int> insertionPoints;
2697         if (visual && rtl)
2698             eng->insertionPointsForLine(lineNum, insertionPoints);
2699         int nchars = 0;
2700         for (int i = 0; i < nItems; ++i) {
2701             int item = visualOrder[i]+firstItem;
2702             QScriptItem &si = eng->layoutData->items[item];
2703             int item_length = eng->length(item);
2704 //             qDebug("    item %d, visual %d x_remain=%f", i, item, x.toReal());
2705
2706             int start = qMax(line.from - si.position, 0);
2707             int end = qMin(line.from + line_length - si.position, item_length);
2708
2709             unsigned short *logClusters = eng->logClusters(&si);
2710
2711             int gs = logClusters[start];
2712             int ge = (end == item_length ? si.num_glyphs : logClusters[end]) - 1;
2713             QGlyphLayout glyphs = eng->shapedGlyphs(&si);
2714
2715             QFixed item_width = 0;
2716             if (si.analysis.flags >= QScriptAnalysis::TabOrObject) {
2717                 item_width = si.width;
2718             } else {
2719                 int g = gs;
2720                 while (g <= ge) {
2721                     item_width += glyphs.effectiveAdvance(g);
2722                     ++g;
2723                 }
2724             }
2725 //             qDebug("      start=%d, end=%d, gs=%d, ge=%d item_width=%f", start, end, gs, ge, item_width.toReal());
2726
2727             if (pos + item_width < x) {
2728                 pos += item_width;
2729                 nchars += end;
2730                 continue;
2731             }
2732 //             qDebug("      inside run");
2733             if (si.analysis.flags >= QScriptAnalysis::TabOrObject) {
2734                 if (cpos == QTextLine::CursorOnCharacter)
2735                     return si.position;
2736                 bool left_half = (x - pos) < item_width/2;
2737
2738                 if (bool(si.analysis.bidiLevel % 2) != left_half)
2739                     return si.position;
2740                 return si.position + 1;
2741             }
2742
2743             int glyph_pos = -1;
2744             // has to be inside run
2745             if (cpos == QTextLine::CursorOnCharacter) {
2746                 if (si.analysis.bidiLevel % 2) {
2747                     pos += item_width;
2748                     glyph_pos = gs;
2749                     while (gs <= ge) {
2750                         if (glyphs.attributes[gs].clusterStart) {
2751                             if (pos < x)
2752                                 break;
2753                             glyph_pos = gs;
2754                             break;
2755                         }
2756                         pos -= glyphs.effectiveAdvance(gs);
2757                         ++gs;
2758                     }
2759                 } else {
2760                     glyph_pos = gs;
2761                     while (gs <= ge) {
2762                         if (glyphs.attributes[gs].clusterStart) {
2763                             if (pos > x)
2764                                 break;
2765                             glyph_pos = gs;
2766                         }
2767                         pos += glyphs.effectiveAdvance(gs);
2768                         ++gs;
2769                     }
2770                 }
2771             } else {
2772                 QFixed dist = INT_MAX/256;
2773                 if (si.analysis.bidiLevel % 2) {
2774                     if (!visual || rtl || (lastLine && i == nItems - 1)) {
2775                         pos += item_width;
2776                         while (gs <= ge) {
2777                             if (glyphs.attributes[gs].clusterStart && qAbs(x-pos) < dist) {
2778                                 glyph_pos = gs;
2779                                 dist = qAbs(x-pos);
2780                             }
2781                             pos -= glyphs.effectiveAdvance(gs);
2782                             ++gs;
2783                         }
2784                     } else {
2785                         while (ge >= gs) {
2786                             if (glyphs.attributes[ge].clusterStart && qAbs(x-pos) < dist) {
2787                                 glyph_pos = ge;
2788                                 dist = qAbs(x-pos);
2789                             }
2790                             pos += glyphs.effectiveAdvance(ge);
2791                             --ge;
2792                         }
2793                     }
2794                 } else {
2795                     if (!visual || !rtl || (lastLine && i == 0)) {
2796                         while (gs <= ge) {
2797                             if (glyphs.attributes[gs].clusterStart && qAbs(x-pos) < dist) {
2798                                 glyph_pos = gs;
2799                                 dist = qAbs(x-pos);
2800                             }
2801                             pos += glyphs.effectiveAdvance(gs);
2802                             ++gs;
2803                         }
2804                     } else {
2805                         QFixed oldPos = pos;
2806                         while (gs <= ge) {
2807                             pos += glyphs.effectiveAdvance(gs);
2808                             if (glyphs.attributes[gs].clusterStart && qAbs(x-pos) < dist) {
2809                                 glyph_pos = gs;
2810                                 dist = qAbs(x-pos);
2811                             }
2812                             ++gs;
2813                         }
2814                         pos = oldPos;
2815                     }
2816                 }
2817                 if (qAbs(x-pos) < dist) {
2818                     if (visual) {
2819                         if (!rtl && i < nItems - 1) {
2820                             nchars += end;
2821                             continue;
2822                         }
2823                         if (rtl && nchars > 0)
2824                             return insertionPoints[lastLine ? nchars : nchars - 1];
2825                     }
2826                     return si.position + end;
2827                 }
2828             }
2829             Q_ASSERT(glyph_pos != -1);
2830             int j;
2831             for (j = 0; j < eng->length(item); ++j)
2832                 if (logClusters[j] == glyph_pos)
2833                     break;
2834 //             qDebug("at pos %d (in run: %d)", si.position + j, j);
2835             return si.position + j;
2836         }
2837     }
2838     // right of last item
2839 //     qDebug() << "right of last";
2840     int item = visualOrder[nItems-1]+firstItem;
2841     QScriptItem &si = eng->layoutData->items[item];
2842     if (!si.num_glyphs)
2843         eng->shape(item);
2844     int pos = si.position;
2845     if (!(si.analysis.bidiLevel % 2))
2846         pos += eng->length(item);
2847     pos = qMax(line.from, pos);
2848
2849     int maxPos = line.from + line_length;
2850
2851     // except for the last line we assume that the
2852     // character between lines is a space and we want
2853     // to position the cursor to the left of that
2854     // character.
2855     // ###### breaks with japanese for example
2856     if (this->i < eng->lines.count() - 1)
2857         --maxPos;
2858
2859     pos = qMin(pos, maxPos);
2860     return pos;
2861 }
2862
2863 QT_END_NAMESPACE