Класс QPainterPath

Класс QPainterPath предоставляет контейнер для операций рисования, позволяющий создавать и повторно использовать графические фигуры. Подробнее...

• Список всех членов, включая унаследованные
• Устаревшие члены

Открытые типы

Открытые функции

Связанные нечлены

Подробное описание

Путь рисования — это объект, состоящий из ряда графических строительных блоков, таких как прямоугольники, эллипсы, линии и кривые. Строительные блоки могут быть соединены в замкнутые подпути, например, как прямоугольник или эллипс. Замкнутый путь имеет совпадающие начальные и конечные точки. Или они могут существовать независимо как незамкнутые подпути, такие как линии и кривые.

Объект QPainterPath можно использовать для заполнения, контурирования и обрезки. Для генерации заполняемых контуров для заданного пути рисования используйте класс QPainterPathStroker. Главное преимущество путей рисования перед обычными операциями рисования заключается в том, что сложные фигуры нужно создавать только один раз; затем их можно рисовать многократно, используя только вызовы функции QPainter::drawPath().

QPainterPath предоставляет набор функций, которые можно использовать для получения информации о пути и его элементах. Кроме того, можно изменить порядок элементов, используя функцию обращённая(). Также есть несколько функций для преобразования этого объекта пути рисования в полигональное представление.

Составление QPainterPath

Объект QPainterPath можно создать как пустой путь, с заданной начальной точкой или как копию другого объекта QPainterPath. После создания линии и кривые можно добавить в путь, используя функции lineTo(), arcTo(), cubicTo() и quadTo(). Линии и кривые простираются от текущего положения() до позиции, переданной в качестве аргумента.

Текущее положение объекта QPainterPath всегда является конечной позицией последнего подпути, который был добавлен (или начальной начальной точкой). Используйте функцию moveTo(), чтобы переместить текущее положение без добавления компонента. Функция moveTo() неявным образом начинает новый подпуть и закрывает предыдущий. Другой способ начать новый подпуть — вызвать функцию closeSubpath(), которая закрывает текущий путь, добавив линию от текущего положения обратно к начальной позиции пути. Обратите внимание, что новый путь будет иметь (0, 0) в качестве начального текущего положения.

Класс QPainterPath также предоставляет несколько удобных функций для добавления замкнутых подпутей к пути рисования: addEllipse(), addPath(), addRect(), addRegion() и addText(). Функция addPolygon() добавляет незамкнутый подпуть. Фактически, все эти функции представляют собой наборы операций moveTo(), lineTo() и cubicTo().

Кроме того, путь можно добавить к текущему пути, используя функцию connectPath(). Но обратите внимание, что эта функция соединит последний элемент текущего пути с первым элементом заданного пути, добавив линию.

Ниже приведен фрагмент кода, показывающий, как можно использовать объект QPainterPath:

QPainterPath path; path.addRect(20, 20, 60, 60); path.moveTo(0, 0); path.cubicTo(99, 0, 50, 50, 99, 99); path.cubicTo(0, 99, 50, 50, 0, 0); QPainter painter(this); painter.fillRect(0, 0, 100, 100, Qt::white); painter.setPen(QPen(QColor(79, 106, 25), 1, Qt::SolidLine, Qt::FlatCap, Qt::MiterJoin)); painter.setBrush(QColor(122, 163, 39)); painter.drawPath(path);

Путь рисования изначально пуст при создании. Сначала мы добавляем прямоугольник, который является замкнутым подпутем. Затем мы добавляем две кривые Безье, которые вместе образуют замкнутый подпуть, даже если они не замкнуты индивидуально. Наконец, мы рисуем весь путь. Путь заполняется с использованием правила заполнения по умолчанию Qt::OddEvenFill. Qt предоставляет два метода для заполнения путей:

Qt::OddEvenFill	Qt::WindingFill

См. документацию Qt::FillRule для определения правил. Текущее правило заливки пути рисовальщика можно получить с помощью функции fillRule(), а изменить — с помощью функции setFillRule().

Информация о QPainterPath

Класс QPainterPath предоставляет набор функций, которые возвращают информацию о пути и его элементах.

Функция currentPosition() возвращает конечную точку последнего добавленного подпути (или начальную точку начала). Функция elementAt() может быть использована для получения различных элементов подпути, количество элементов можно получить с помощью функции elementCount(), а функция isEmpty() указывает, содержит ли этот объект QPainterPath вообще какие-либо элементы.

Функция controlPointRect() возвращает прямоугольник, содержащий все точки и точки управления в этом пути. Эта функция значительно быстрее для вычисления, чем точная функция boundingRect(), которая возвращает прямоугольник, охватывающий этот путь рисовальщика с плавающей точкой точности.

Наконец, QPainterPath предоставляет функцию contains(), которая используется для определения, находится ли заданная точка или прямоугольник внутри пути, и функцию intersects(), которая определяет, находятся ли какие-либо точки внутри заданного прямоугольника также внутри этого пути.

Преобразование QPainterPath

По соображениям совместимости может потребоваться упростить представление пути рисовальщика: QPainterPath предоставляет функции toFillPolygon(), toFillPolygons() и toSubpathPolygons(), которые преобразуют путь рисовальщика в многоугольник. Функция toFillPolygon() возвращает путь рисовальщика как один единственный многоугольник, а две последние функции возвращают список многоугольников.

Функции toFillPolygons() и toSubpathPolygons() предоставляются, потому что обычно быстрее рисовать несколько маленьких многоугольников, чем один большой, даже если общее количество нарисованных точек одинаково. Разница между ними заключается в количестве возвращаемых многоугольников: функция toSubpathPolygons() создает один многоугольник для каждого подпути независимо от пересекающихся подпутей (т.е. перекрывающихся прямоугольников), а функция toFillPolygons() создает только один многоугольник для перекрывающихся подпутей.

Функции toFillPolygon() и toFillPolygons() сначала преобразуют все подпути в многоугольники, затем используют метод пересчёта для обеспечения корректного заполнения перекрывающихся подпутей с использованием правил заполнения. Обратите внимание, что пересчёт вставляет дополнительные линии в многоугольник, поэтому контур заполненного многоугольника не соответствует контуру пути.

Примеры

Qt предоставляет Пример использования путей отрисовки и Пример деформации векторов, которые находятся в каталоге примеров Qt.

Пример использования путей отрисовки демонстрирует, как можно использовать пути отрисовки для построения сложных фигур для рендеринга и позволяет пользователю экспериментировать с заполнением и обводкой. Пример деформации векторов показывает, как использовать QPainterPath для рисования текста.

См. также QPainterPathStroker, QPainter, QRegion и Пример Painter Paths.

Документация по типу элементов

enum QPainterPath::ElementType

Этот перечисление описывает типы элементов, используемых для соединения вершин в подпутях.

Обратите внимание, что элементы, добавленные как замкнутые подпути с помощью удобных функций addEllipse(), addPath(), addPolygon(), addRect(), addRegion() и addText(), фактически добавляются в путь как набор отдельных элементов с помощью функций moveTo(), lineTo() и cubicTo().

См. также elementAt() и elementCount().

Документация по членам-функциям

QPainterPath::QPainterPath(const QPainterPath &path)

Создаёт объект QPainterPath, являющийся копией заданного path.

См. также operator=().

QPainterPath::QPainterPath(const QPointF &startPoint)

Создаёт объект QPainterPath с заданной startPoint в качестве текущей позиции.

QPainterPath::QPainterPath()

Конструирует пустой объект QPainterPath.

QPainterPath &QPainterPath::operator=(QPainterPath &&other)

Перемещающее присваивание other экземпляру QPainterPath.

Эта функция была добавлена в Qt 5.2.

QPainterPath &QPainterPath::operator=(const QPainterPath &path)

Присваивает заданный path этому объекту пути.

См. также QPainterPath().

QPainterPath::~QPainterPath()

Уничтожает этот объект QPainterPath.

void QPainterPath::addEllipse(const QRectF &boundingRectangle)

Создаёт эллипс внутри указанного boundingRectangle и добавляет его в путь рисования как замкнутый подпуть.

Эллипс состоит из кривой по часовой стрелке, начинающейся и заканчивающейся в нуле градусов (в 3 часа).

QLinearGradient myGradient; QPen myPen; QRectF boundingRectangle; QPainterPath myPath; myPath.addEllipse(boundingRectangle); QPainter painter(this); painter.setBrush(myGradient); painter.setPen(myPen); painter.drawPath(myPath);

См. также arcTo(), QPainter::drawEllipse() и Создание QPainterPath.

void QPainterPath::addEllipse(qreal x, qreal y, qreal width, qreal height)

Это перегруженная функция.

Создаёт эллипс в прямоугольнике, определяемом его верхним левым углом в координатах (x, y), шириной width и высотой height, и добавляет его в путь рисования как замкнутый подпуть.

void QPainterPath::addEllipse(const QPointF &center, qreal rx, qreal ry)

Это перегруженная функция.

Создаёт эллипс, расположенный в точке center с радиусами rx и ry, и добавляет его в путь рисования как замкнутый подпуть.

Эта функция была добавлена в Qt 4.4.

void QPainterPath::addPath(const QPainterPath &path)

Добавляет заданный path в this путь как замкнутый подпуть.

См. также connectPath() и Создание QPainterPath.

void QPainterPath::addPolygon(const QPolygonF &polygon)

Добавляет заданный polygon в путь как (незамкнутый) подпуть.

Обратите внимание, что текущая позиция после добавления многоугольника — это последняя точка в polygon. Чтобы нарисовать линию обратно к первой точке, используйте функцию closeSubpath().

QLinearGradient myGradient; QPen myPen; QPolygonF myPolygon; QPainterPath myPath; myPath.addPolygon(myPolygon); QPainter painter(this); painter.setBrush(myGradient); painter.setPen(myPen); painter.drawPath(myPath);

См. также lineTo() и Создание QPainterPath.

void QPainterPath::addRect(const QRectF &rectangle)

Добавляет указанный прямоугольник rectangle в этот путь в качестве замкнутой подпути.

Прямоугольник rectangle добавляется как набор отрезков по часовой стрелке. Текущее положение пути после добавления прямоугольника будет в левом верхнем углу прямоугольника.

QLinearGradient myGradient; QPen myPen; QRectF myRectangle; QPainterPath myPath; myPath.addRect(myRectangle); QPainter painter(this); painter.setBrush(myGradient); painter.setPen(myPen); painter.drawPath(myPath);

См. также addRegion(), lineTo(), и Создание QPainterPath.

void QPainterPath::addRect(qreal x, qreal y, qreal width, qreal height)

Это перегруженный метод.

Добавляет прямоугольник в позиции (x, y) с заданной width и height в качестве замкнутой подпути.

void QPainterPath::addRegion(const QRegion &region)

Добавляет указанную region в путь, добавив каждый прямоугольник в region в качестве отдельной замкнутой подпути.

См. также addRect() и Создание QPainterPath.

void QPainterPath::addRoundedRect(const QRectF &rect, qreal xRadius, qreal yRadius, Qt::SizeMode mode = Qt::AbsoluteSize)

Добавляет указанный прямоугольник rect с закруглёнными углами в путь.

Аргументы xRadius и yRadius задают радиусы эллипсов, определяющих углы закруглённого прямоугольника. Если mode равен Qt::RelativeSize, xRadius и yRadius указываются в процентах от половины ширины и высоты прямоугольника соответственно и должны быть в диапазоне от 0.0 до 100.0.

Эта функция была добавлена в Qt 4.4.

См. также addRect().

void QPainterPath::addRoundedRect(qreal x, qreal y, qreal w, qreal h, qreal xRadius, qreal yRadius, Qt::SizeMode mode = ...)

Это перегруженный метод.

Добавляет указанный прямоугольник x, y, w, h с закруглёнными углами в путь.

Эта функция была добавлена в Qt 4.4.

void QPainterPath::addText(const QPointF &point, const QFont &font, const QString &text)

Добавляет указанный text в этот путь в виде набора замкнутых подпутей, созданных на основе заданного font. Подпути размещаются таким образом, что левый конец базовой линии текста лежит в указанной точке point.

QLinearGradient myGradient; QPen myPen; QFont myFont; QPointF baseline(x, y); QPainterPath myPath; myPath.addText(baseline, myFont, tr("Qt")); QPainter painter(this); painter.setBrush(myGradient); painter.setPen(myPen); painter.drawPath(myPath);

См. также QPainter::drawText() и Составление QPainterPath.

void QPainterPath::addText(qreal x, qreal y, const QFont &font, const QString &text)

Это перегруженный метод.

Добавляет заданный текст text в этот путь в виде набора замкнутых подпутей, созданных из заданного шрифта font. Подпути размещаются так, что левый конец базовой линии текста находится в точке, заданной (x, y).

qreal QPainterPath::angleAtPercent(qreal t) const

Возвращает угол касательной к пути в процентах t. Аргумент t должен быть в диапазоне от 0 до 1.

Положительные значения углов означают против часовой стрелки, а отрицательные — по часовой стрелке. Ноль градусов соответствует положению 3 часа.

Обратите внимание, что, аналогично другим методам с процентами, измерение в процентах не является линейным относительно длины, если в пути присутствуют кривые. При наличии кривых аргумент процентов сопоставляется с параметром t уравнений Безье.

void QPainterPath::arcMoveTo(const QRectF &rectangle, qreal angle)

Создаёт перемещение, которое расположено на дуге, занимающей заданный прямоугольник rectangle в angle.

Углы задаются в градусах. Дуги по часовой стрелке можно задать с помощью отрицательных углов.

Этот метод был добавлен в Qt 4.2.

См. также moveTo() и arcTo().

void QPainterPath::arcMoveTo(qreal x, qreal y, qreal width, qreal height, qreal angle)

Это перегруженный метод.

Создаёт перемещение, которое расположено на дуге, занимающей QRectF(x, y, width, height) в angle.

Этот метод был добавлен в Qt 4.2.

void QPainterPath::arcTo(const QRectF &rectangle, qreal startAngle, qreal sweepLength)

Создаёт дугу, которая занимает заданный прямоугольник rectangle, начиная с заданного startAngle и охватывая sweepLength градусов против часовой стрелки.

Углы задаются в градусах. Дуги по часовой стрелке можно задать с помощью отрицательных углов.

Обратите внимание, что эта функция соединяет начальную точку дуги с текущей позицией, если они ещё не соединены. После добавления дуги текущая позиция — последняя точка на дуге. Чтобы нарисовать линию обратно к первой точке, используйте функцию closeSubpath().

QLinearGradient myGradient; QPen myPen; QPointF center, startPoint; QPainterPath myPath; myPath.moveTo(center); myPath.arcTo(boundingRect, startAngle, sweepLength); QPainter painter(this); painter.setBrush(myGradient); painter.setPen(myPen); painter.drawPath(myPath);

См. также arcMoveTo(), addEllipse(), QPainter::drawArc(), QPainter::drawPie(), и Составление QPainterPath.

void QPainterPath::arcTo(qreal x, qreal y, qreal width, qreal height, qreal startAngle, qreal sweepLength)

Это перегруженный метод.

Создаёт дугу, которая занимает прямоугольник QRectF(x, y, width, height), начиная с указанного startAngle и продолжаясь на sweepLength градусов против часовой стрелки.

QRectF QPainterPath::boundingRect() const

Возвращает прямоугольник, охватывающий эту траекторию рисования, как прямоугольник с плавающей точкой.

См. также controlPointRect().

int QPainterPath::capacity() const

Возвращает количество элементов, выделенных для QPainterPath.

Эта функция была добавлена в Qt 5.13.

См. также clear() и reserve().

void QPainterPath::clear()

Очищает сохранённые элементы траектории.

Это позволяет траектории повторно использовать предыдущие выделенные ресурсы памяти.

Эта функция была добавлена в Qt 5.13.

См. также reserve() и capacity().

void QPainterPath::closeSubpath()

Закрывает текущую подтраекторию, нарисовав линию к началу подтраектории, автоматически начав новую траекторию. Текущая точка новой траектории равна (0, 0).

Если подтраектория не содержит элементов, эта функция ничего не делает.

См. также moveTo() и Составление QPainterPath.

void QPainterPath::connectPath(const QPainterPath &path)

Подключает заданную path к текущей траектории, добавив линию от последнего элемента этой траектории к первому элементу заданной траектории.

См. также addPath() и Составление QPainterPath.

bool QPainterPath::contains(const QPointF &point) const

Возвращает true если заданная point находится внутри траектории, в противном случае возвращает false.

См. также intersects().

bool QPainterPath::contains(const QRectF &rectangle) const

Возвращает true если заданный rectangle находится внутри траектории, в противном случае возвращает false.

bool QPainterPath::contains(const QPainterPath &p) const

Возвращает true если заданная траектория p содержится внутри текущей траектории. Возвращает false если какие-либо грани текущей траектории и p пересекаются.

Операции над траекториями будут обрабатывать траектории как области. Незакрытые траектории будут обрабатываться как неявные закрытые траектории.

Эта функция была добавлена в Qt 4.3.

См. также intersects().

QRectF QPainterPath::controlPointRect() const

Возвращает прямоугольник, содержащий все точки и точки управления в этой траектории.

Эта функция значительно быстрее вычисляется, чем точный boundingRect(), и возвращаемый прямоугольник всегда является супермножеством прямоугольника, возвращаемого boundingRect().

См. также boundingRect().

void QPainterPath::cubicTo(const QPointF &c1, const QPointF &c2, const QPointF &endPoint)

Добавляет кубическую кривую Безье между текущей позицией и заданной endPoint, используя точки управления, указанные c1 и c2.

После добавления кривой текущая позиция обновляется до конечной точки кривой.

QLinearGradient myGradient; QPen myPen; QPainterPath myPath; myPath.cubicTo(c1, c2, endPoint); QPainter painter(this); painter.setBrush(myGradient); painter.setPen(myPen); painter.drawPath(myPath);

См. также quadTo() и Создание QPainterPath.

void QPainterPath::cubicTo(qreal c1X, qreal c1Y, qreal c2X, qreal c2Y, qreal endPointX, qreal endPointY)

Это перегруженный метод.

Добавляет кубическую кривую Безье между текущей позицией и конечной точкой (endPointX, endPointY) с контрольными точками, заданными (c1X, c1Y) и (c2X, c2Y).

QPointF QPainterPath::currentPosition() const

Возвращает текущую позицию пути.

QPainterPath::Element QPainterPath::elementAt(int index) const

Возвращает элемент по заданному индексу в пути рисования.

См. также Тип элемента, elementCount() и isEmpty().

int QPainterPath::elementCount() const

Возвращает количество элементов пути в пути рисования.

См. также Тип элемента, elementAt() и isEmpty().

Qt::FillRule QPainterPath::fillRule() const

Возвращает текущее правило заполнения пути.

См. также setFillRule().

QPainterPath QPainterPath::intersected(const QPainterPath &p) const

Возвращает путь, представляющий пересечение области заполнения этого пути и области заполнения пути p. Кривые Безье могут быть сглажены до отрезков прямых из-за числовой неустойчивости при пересечении кривых Безье.

Этот метод был добавлен в Qt 4.3.

bool QPainterPath::intersects(const QRectF &rectangle) const

Возвращает true если какая-либо точка в заданном прямоугольнике пересекается с путем; в противном случае возвращает false.

Пересечение существует, если любая из линий, составляющих прямоугольник, пересекает часть пути или если любая часть прямоугольника перекрывает любую область, заключённую путём. Этот метод учитывает текущее правило заполнения fillRule для определения того, что считается внутри пути.

См. также contains().

bool QPainterPath::intersects(const QPainterPath &p) const

Возвращает true если текущий путь пересекается в любой точке с данным путем p. Также возвращает true если текущий путь содержит или содержится в любой части p.

Операции над путями будут рассматривать пути как области. Незамкнутые пути будут обрабатываться как неявно замкнутые.

Этот метод был добавлен в Qt 4.3.

См. также contains().

bool QPainterPath::isEmpty() const

Возвращает true если в этом пути нет элементов или если единственным элементом является MoveToElement; в противном случае возвращает false.

См. также elementCount().

qreal QPainterPath::length() const

Возвращает длину текущего пути.

void QPainterPath::lineTo(const QPointF &endPoint)

Добавляет прямую линию от текущей позиции до заданной конечной точки endPoint. После рисования линии текущая позиция обновляется до конечной точки линии.

См. также addPolygon(), addRect() и Создание QPainterPath.

void QPainterPath::lineTo(qreal x, qreal y)

Это перегруженный метод.

Рисует линию от текущей позиции до точки (x, y).

void QPainterPath::moveTo(const QPointF &point)

Перемещает текущую точку в заданную точку point, неявно начав новый подпуть и закрыв предыдущий.

См. также closeSubpath() и Создание QPainterPath.

void QPainterPath::moveTo(qreal x, qreal y)

Это перегруженный метод.

Перемещает текущую позицию в (x, y) и начинает новый подпуть, неявно закрывая предыдущий путь.

qreal QPainterPath::percentAtLength(qreal len) const

Возвращает процентную величину всего пути по заданной длине len.

Обратите внимание, что, подобно другим методам с процентами, измерение процента не является линейным относительно длины, если в пути присутствуют кривые. При наличии кривых аргумент процента сопоставляется с параметром t уравнений Безье.

QPointF QPainterPath::pointAtPercent(qreal t) const

Возвращает точку по проценту t текущего пути. Аргумент t должен быть от 0 до 1.

Обратите внимание, что, подобно другим методам процентов, измерение процентов нелинейно по отношению к длине, если в пути присутствуют кривые. При наличии кривых аргумент процента сопоставляется с параметром t уравнений Безье.

void QPainterPath::quadTo(const QPointF &c, const QPointF &endPoint)

Добавляет квадратичную кривую Безье между текущей позицией и заданным endPoint с контрольной точкой, указанной c.

После добавления кривой текущая точка обновляется и становится в конечной точке кривой.

См. также cubicTo() и Создание QPainterPath.

void QPainterPath::quadTo(qreal cx, qreal cy, qreal endPointX, qreal endPointY)

Это перегруженный метод.

Добавляет квадратичную кривую Безье между текущей точкой и конечной точкой (endPointX, endPointY) с контрольной точкой, указанной (cx, cy).

void QPainterPath::reserve(int size)

Зарезервирует заданное количество элементов во внутренней памяти QPainterPath.

Попытка выделить память для по крайней мере size элементов.

Этот метод был добавлен в Qt 5.13.

См. также clear(), capacity() и QVector::reserve().

void QPainterPath::setElementPositionAt(int index, qreal x, qreal y)

Устанавливает координаты x и y элемента с индексом index на x и y.

Этот метод был добавлен в Qt 4.2.

void QPainterPath::setFillRule(Qt::FillRule fillRule)

Устанавливает правило заливки пути рисования на заданное fillRule. Qt предоставляет два метода заливки путей:

Qt::OddEvenFill (по умолчанию)	Qt::WindingFill

См. также fillRule().

QPainterPath QPainterPath::simplified() const

Возвращает упрощённую версию этого пути. Это подразумевает объединение всех подпутей, которые пересекаются, и возвращение пути без пересекающихся отрезков. Последовательные параллельные линии также будут объединены. Упрощённый путь всегда использует стандартное правило заливки Qt::OddEvenFill. Кривые Безье могут быть упрощены до отрезков прямых линий из-за числовой неустойчивости при пересечении кривых Безье.

Эта функция была добавлена в Qt 4.4.

qreal QPainterPath::slopeAtPercent(qreal t) const

Возвращает наклон пути в процентах t. Аргумент t должен находиться в диапазоне от 0 до 1.

Обратите внимание, что, подобно другим методам процентов, измерение в процентах не является линейным по отношению к длине, если в пути присутствуют кривые. При наличии кривых аргумент процента отображается на параметр t уравнений Безье.

QPainterPath QPainterPath::subtracted(const QPainterPath &p) const

Возвращает путь, где область заливки p вычитается из области заливки этого пути.

Операции над путями будут рассматривать пути как области. Незамкнутые пути будут рассматриваться как неявные замкнутые. Кривые Безье могут быть упрощены до отрезков прямых линий из-за числовой неустойчивости при пересечении кривых Безье.

Эта функция была добавлена в Qt 4.3.

void QPainterPath::swap(QPainterPath &other)

Меняет местами пути рисования other и этого пути рисования. Эта операция очень быстрая и никогда не терпит неудачу.

Эта функция была добавлена в Qt 4.8.

QPolygonF QPainterPath::toFillPolygon(const QTransform &matrix) const

Преобразует путь в многоугольник, используя матрицу преобразования QTransform matrix, и возвращает многоугольник.

Многоугольник создаётся путём преобразования всех подпутей в многоугольники, а затем с помощью техники перестановки, чтобы убедиться, что перекрывающиеся подпути могут быть заполнены с использованием правильного правила заливки.

Обратите внимание, что перестановка вставляет дополнительные линии в многоугольник, поэтому контур заполненного многоугольника не соответствует контуру пути.

См. также toSubpathPolygons(), toFillPolygons(), и Преобразование QPainterPath.

QPolygonF QPainterPath::toFillPolygon(const QMatrix &matrix = QMatrix()) const

Это перегруженная функция.

QList<QPolygonF> QPainterPath::toFillPolygons(const QTransform &matrix) const

Преобразует путь в список многоугольников, используя матрицу преобразования QTransform matrix, и возвращает список.

Функция отличается от функции toFillPolygon() тем, что создаёт несколько многоугольников. Она предоставляется, потому что обычно быстрее рисовать несколько маленьких многоугольников, чем один большой, даже если общее количество нарисованных точек одинаково.

Функция toFillPolygons() отличается от функции toSubpathPolygons() тем, что создаёт только многоугольник для подпутей, имеющих перекрывающиеся ограничивающие прямоугольники.

Как и функция toFillPolygon(), эта функция использует технику перестановки, чтобы убедиться, что перекрывающиеся подпути могут быть заполнены с использованием правильного правила заливки. Обратите внимание, что перестановка вставляет дополнительные линии в многоугольники, поэтому контур заполненного многоугольника не соответствует контуру пути.

См. также toSubpathPolygons(), toFillPolygon(), и Преобразование QPainterPath.

QList<QPolygonF> QPainterPath::toFillPolygons(const QMatrix &matrix = QMatrix()) const

Это перегруженная функция.

QPainterPath QPainterPath::toReversed() const

Создаёт и возвращает обращённую копию пути.

Обращается порядок элементов: Если QPainterPath составлен путём вызова функций moveTo(), lineTo() и cubicTo() в указанном порядке, то обращённая копия составляется путём вызова функций cubicTo(), lineTo() и moveTo().

QList<QPolygonF> QPainterPath::toSubpathPolygons(const QTransform &matrix) const

Преобразует путь в список многоугольников, используя матрицу преобразования QTransform matrix, и возвращает список.

Эта функция создаёт по одному многоугольнику для каждого подпути, независимо от пересекающихся подпутей (т. е. перекрывающихся ограничивающих прямоугольников). Чтобы убедиться, что такие перекрывающиеся подпути заполняются корректно, используйте функцию toFillPolygons() вместо неё.

См. также toFillPolygons(), toFillPolygon(), и Преобразование QPainterPath.

QList<QPolygonF> QPainterPath::toSubpathPolygons(const QMatrix &matrix = QMatrix()) const

Это перегруженная функция.

void QPainterPath::translate(qreal dx, qreal dy)

Перемещает все элементы пути на (dx, dy).

Эта функция была добавлена в Qt 4.6.

См. также translated().

void QPainterPath::translate(const QPointF &offset)

Это перегруженная функция.

Перемещает все элементы пути на заданное смещение offset.

Эта функция была добавлена в Qt 4.6.

См. также translated().

QPainterPath QPainterPath::translated(qreal dx, qreal dy) const

Возвращает копию пути, перемещённую на (dx, dy).

Эта функция была добавлена в Qt 4.6.

См. также translate().

QPainterPath QPainterPath::translated(const QPointF &offset) const

Это перегруженная функция.

Возвращает копию пути, перемещённую на заданное смещение offset.

Эта функция была добавлена в Qt 4.6.

См. также translate().

QPainterPath QPainterPath::united(const QPainterPath &p) const

Возвращает путь, который является объединением области заливки этого пути и области заливки p.

Операции над путями будут рассматривать пути как области. Незамкнутые пути будут рассматриваться как неявные замкнутые. Кривые Безье могут быть упрощены до отрезков прямых линий из-за числовой неустойчивости при пересечении кривых Безье.

Эта функция была добавлена в Qt 4.3.

См. также intersected() и subtracted().

bool QPainterPath::operator!=(const QPainterPath &path) const

Возвращает true, если этот путь рисования отличается от заданного пути path.

Обратите внимание, что сравнение путей может включать сравнение по каждому элементу, что может быть медленным для сложных путей.

См. также operator==().

QPainterPath QPainterPath::operator&(const QPainterPath &other) const

Возвращает пересечение этого пути и пути other.

Эта функция была добавлена в Qt 4.5.

См. также intersected(), operator&=(), united(), и operator|().

QPainterPath &QPainterPath::operator&=(const QPainterPath &other)

Пересекает этот путь с other и возвращает ссылку на этот путь.

Эта функция была добавлена в Qt 4.5.

См. также intersected(), operator&(), и operator|=().

QPainterPath QPainterPath::operator+(const QPainterPath &other) const

Возвращает объединение текущей траектории и траектории other. Эта функция эквивалентна operator|().

Данная функция была добавлена в Qt 4.5.

См. также united(), operator+=(), и operator-().

QPainterPath &QPainterPath::operator+=(const QPainterPath &other)

Объединяет текущую траекторию с траекторией other и возвращает ссылку на текущую траекторию. Эквивалентно operator|=().

Данная функция была добавлена в Qt 4.5.

См. также united(), operator+(), и operator-=().

QPainterPath QPainterPath::operator-(const QPainterPath &other) const

Вычитает траекторию other из копии текущей траектории и возвращает копию.

Данная функция была добавлена в Qt 4.5.

См. также subtracted(), operator-=(), и operator+().

QPainterPath &QPainterPath::operator-=(const QPainterPath &other)

Вычитает other из текущей траектории и возвращает ссылку на текущую траекторию.

Данная функция была добавлена в Qt 4.5.

См. также subtracted(), operator-(), и operator+=().

bool QPainterPath::operator==(const QPainterPath &path) const

Возвращает true, если текущая траектория равна заданной траектории path.

Обратите внимание, что сравнение траекторий может включать сравнение по элементам, что может быть медленным для сложных траекторий.

См. также operator!=().

QPainterPath QPainterPath::operator|(const QPainterPath &other) const

Возвращает объединение текущей траектории и траектории other.

Данная функция была добавлена в Qt 4.5.

См. также united(), operator|=(), intersected(), и operator&().

QPainterPath &QPainterPath::operator|=(const QPainterPath &other)

Объединяет текущую траекторию с other и возвращает ссылку на текущую траекторию.

Данная функция была добавлена в Qt 4.5.

См. также united(), operator|(), и operator&=().