summaryrefslogtreecommitdiffstats
path: root/src/gui/text/qglyphs.cpp
diff options
context:
space:
mode:
authorEskil Abrahamsen Blomfeldt <eskil.abrahamsen-blomfeldt@nokia.com>2011-05-10 09:43:00 +0200
committerEskil Abrahamsen Blomfeldt <eskil.abrahamsen-blomfeldt@nokia.com>2011-05-10 12:20:13 +0200
commit051ef6f294e8cbfa1e30e99e7fd4cf5fb38393f4 (patch)
tree19207e0507896bd06e6c63a09ecf0c7eb9ac77e7 /src/gui/text/qglyphs.cpp
parenta35b2d58d921ee944d48dadbebe871df0c5c6986 (diff)
Rename QGlyphs -> QGlyphRun
API clean-up for QGlyphRun: 1. QGlyphs -> QGlyphRun 2. QGlyphRun's font()/setFont() -> rawFont()/setRawFont() 3. QPainter::drawGlyphs() -> drawGlyphRun() 4. QTextLayout and QTextFragment's glyphs() -> glyphRuns() Reviewed-by: Jiang Jiang (cherry picked from commit 84ef364302728b68d2d29ea9c4ccbec32c7bb115)
Diffstat (limited to 'src/gui/text/qglyphs.cpp')
-rw-r--r--src/gui/text/qglyphs.cpp323
1 files changed, 0 insertions, 323 deletions
diff --git a/src/gui/text/qglyphs.cpp b/src/gui/text/qglyphs.cpp
deleted file mode 100644
index cfea6ece93..0000000000
--- a/src/gui/text/qglyphs.cpp
+++ /dev/null
@@ -1,323 +0,0 @@
-/****************************************************************************
-**
-** Copyright (C) 2011 Nokia Corporation and/or its subsidiary(-ies).
-** All rights reserved.
-** Contact: Nokia Corporation (qt-info@nokia.com)
-**
-** This file is part of the QtGui module of the Qt Toolkit.
-**
-** $QT_BEGIN_LICENSE:LGPL$
-** No Commercial Usage
-** This file contains pre-release code and may not be distributed.
-** You may use this file in accordance with the terms and conditions
-** contained in the Technology Preview License Agreement accompanying
-** this package.
-**
-** GNU Lesser General Public License Usage
-** Alternatively, this file may be used under the terms of the GNU Lesser
-** General Public License version 2.1 as published by the Free Software
-** Foundation and appearing in the file LICENSE.LGPL included in the
-** packaging of this file. Please review the following information to
-** ensure the GNU Lesser General Public License version 2.1 requirements
-** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
-**
-** In addition, as a special exception, Nokia gives you certain additional
-** rights. These rights are described in the Nokia Qt LGPL Exception
-** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
-**
-** If you have questions regarding the use of this file, please contact
-** Nokia at qt-info@nokia.com.
-**
-**
-**
-**
-**
-**
-**
-**
-** $QT_END_LICENSE$
-**
-****************************************************************************/
-
-#include "qglobal.h"
-
-#if !defined(QT_NO_RAWFONT)
-
-#include "qglyphs.h"
-#include "qglyphs_p.h"
-
-QT_BEGIN_NAMESPACE
-
-/*!
- \class QGlyphs
- \brief The QGlyphs class provides direct access to the internal glyphs in a font.
- \since 4.8
-
- \ingroup text
- \mainclass
-
- When Qt displays a string of text encoded in Unicode, it will first convert the Unicode points
- into a list of glyph indexes and a list of positions based on one or more fonts. The Unicode
- representation of the text and the QFont object will in this case serve as a convenient
- abstraction that hides the details of what actually takes place when displaying the text
- on-screen. For instance, by the time the text actually reaches the screen, it may be represented
- by a set of fonts in addition to the one specified by the user, e.g. in case the originally
- selected font did not support all the writing systems contained in the text.
-
- Under certain circumstances, it can be useful as an application developer to have more low-level
- control over which glyphs in a specific font are drawn to the screen. This could for instance
- be the case in applications that use an external font engine and text shaper together with Qt.
- QGlyphs provides an interface to the raw data needed to get text on the screen. It
- contains a list of glyph indexes, a position for each glyph and a font.
-
- It is the user's responsibility to ensure that the selected font actually contains the
- provided glyph indexes.
-
- QTextLayout::glyphs() or QTextFragment::glyphs() can be used to convert unicode encoded text
- into a list of QGlyphs objects, and QPainter::drawGlyphs() can be used to draw the glyphs.
-
- \note Please note that QRawFont is considered local to the thread in which it is constructed.
- This in turn means that a new QRawFont will have to be created and set on the QGlyphs if it is
- moved to a different thread. If the QGlyphs contains a reference to a QRawFont from a different
- thread than the current, it will not be possible to draw the glyphs using a QPainter, as the
- QRawFont is considered invalid and inaccessible in this case.
-*/
-
-
-/*!
- Constructs an empty QGlyphs object.
-*/
-QGlyphs::QGlyphs() : d(new QGlyphsPrivate)
-{
-}
-
-/*!
- Constructs a QGlyphs object which is a copy of \a other.
-*/
-QGlyphs::QGlyphs(const QGlyphs &other)
-{
- d = other.d;
-}
-
-/*!
- Destroys the QGlyphs.
-*/
-QGlyphs::~QGlyphs()
-{
- // Required for QExplicitlySharedDataPointer
-}
-
-/*!
- \internal
-*/
-void QGlyphs::detach()
-{
- if (d->ref != 1)
- d.detach();
-}
-
-/*!
- Assigns \a other to this QGlyphs object.
-*/
-QGlyphs &QGlyphs::operator=(const QGlyphs &other)
-{
- d = other.d;
- return *this;
-}
-
-/*!
- Compares \a other to this QGlyphs object. Returns true if the list of glyph indexes,
- the list of positions and the font are all equal, otherwise returns false.
-*/
-bool QGlyphs::operator==(const QGlyphs &other) const
-{
- return ((d == other.d)
- || (d->glyphIndexes == other.d->glyphIndexes
- && d->glyphPositions == other.d->glyphPositions
- && d->overline == other.d->overline
- && d->underline == other.d->underline
- && d->strikeOut == other.d->strikeOut
- && d->font == other.d->font));
-}
-
-/*!
- Compares \a other to this QGlyphs object. Returns true if any of the list of glyph
- indexes, the list of positions or the font are different, otherwise returns false.
-*/
-bool QGlyphs::operator!=(const QGlyphs &other) const
-{
- return !(*this == other);
-}
-
-/*!
- \internal
-
- Adds together the lists of glyph indexes and positions in \a other and this QGlyphs
- object and returns the result. The font in the returned QGlyphs will be the same as in
- this QGlyphs object.
-*/
-QGlyphs QGlyphs::operator+(const QGlyphs &other) const
-{
- QGlyphs ret(*this);
- ret += other;
- return ret;
-}
-
-/*!
- \internal
-
- Appends the glyph indexes and positions in \a other to this QGlyphs object and returns
- a reference to the current object.
-*/
-QGlyphs &QGlyphs::operator+=(const QGlyphs &other)
-{
- detach();
-
- d->glyphIndexes += other.d->glyphIndexes;
- d->glyphPositions += other.d->glyphPositions;
-
- return *this;
-}
-
-/*!
- Returns the font selected for this QGlyphs object.
-
- \sa setFont()
-*/
-QRawFont QGlyphs::font() const
-{
- return d->font;
-}
-
-/*!
- Sets the font in which to look up the glyph indexes to \a font.
-
- \sa font(), setGlyphIndexes()
-*/
-void QGlyphs::setFont(const QRawFont &font)
-{
- detach();
- d->font = font;
-}
-
-/*!
- Returns the glyph indexes for this QGlyphs object.
-
- \sa setGlyphIndexes(), setPositions()
-*/
-QVector<quint32> QGlyphs::glyphIndexes() const
-{
- return d->glyphIndexes;
-}
-
-/*!
- Set the glyph indexes for this QGlyphs object to \a glyphIndexes. The glyph indexes must
- be valid for the selected font.
-*/
-void QGlyphs::setGlyphIndexes(const QVector<quint32> &glyphIndexes)
-{
- detach();
- d->glyphIndexes = glyphIndexes;
-}
-
-/*!
- Returns the position of the edge of the baseline for each glyph in this set of glyph indexes.
-*/
-QVector<QPointF> QGlyphs::positions() const
-{
- return d->glyphPositions;
-}
-
-/*!
- Sets the positions of the edge of the baseline for each glyph in this set of glyph indexes to
- \a positions.
-*/
-void QGlyphs::setPositions(const QVector<QPointF> &positions)
-{
- detach();
- d->glyphPositions = positions;
-}
-
-/*!
- Clears all data in the QGlyphs object.
-*/
-void QGlyphs::clear()
-{
- detach();
- d->glyphPositions = QVector<QPointF>();
- d->glyphIndexes = QVector<quint32>();
- d->font = QRawFont();
- d->strikeOut = false;
- d->overline = false;
- d->underline = false;
-}
-
-/*!
- Returns true if this QGlyphs should be painted with an overline decoration.
-
- \sa setOverline()
-*/
-bool QGlyphs::overline() const
-{
- return d->overline;
-}
-
-/*!
- Indicates that this QGlyphs should be painted with an overline decoration if \a overline is true.
- Otherwise the QGlyphs should be painted with no overline decoration.
-
- \sa overline()
-*/
-void QGlyphs::setOverline(bool overline)
-{
- detach();
- d->overline = overline;
-}
-
-/*!
- Returns true if this QGlyphs should be painted with an underline decoration.
-
- \sa setUnderline()
-*/
-bool QGlyphs::underline() const
-{
- return d->underline;
-}
-
-/*!
- Indicates that this QGlyphs should be painted with an underline decoration if \a underline is
- true. Otherwise the QGlyphs should be painted with no underline decoration.
-
- \sa underline()
-*/
-void QGlyphs::setUnderline(bool underline)
-{
- detach();
- d->underline = underline;
-}
-
-/*!
- Returns true if this QGlyphs should be painted with a strike out decoration.
-
- \sa setStrikeOut()
-*/
-bool QGlyphs::strikeOut() const
-{
- return d->strikeOut;
-}
-
-/*!
- Indicates that this QGlyphs should be painted with an strike out decoration if \a strikeOut is
- true. Otherwise the QGlyphs should be painted with no strike out decoration.
-
- \sa strikeOut()
-*/
-void QGlyphs::setStrikeOut(bool strikeOut)
-{
- detach();
- d->strikeOut = strikeOut;
-}
-
-QT_END_NAMESPACE
-
-#endif // QT_NO_RAWFONT