Класс QPainterPathStroker

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

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

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

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

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

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

• setWidth()
• setCapStyle()
• setJoinStyle()
• setDashPattern()

Функция setDashPattern() принимает как объект Qt::PenStyle, так и представление шаблона в виде списка в качестве аргумента.

Кроме того, вы можете указать порог кривой, контролируя точность, с которой рисуется кривая, используя функцию setCurveThreshold(). Значение по умолчанию — хорошо подобранное значение (0.25), и обычно его изменять не нужно. Тем не менее, можно сделать кривую более плавной, уменьшив ее значение.

Вы также можете контролировать предел схождения для сгенерированного контура, используя функцию setMiterLimit(). Предел схождения описывает, насколько далеко от каждого соединения может простираться соединение типа схождения. Предел задается в единицах ширины, поэтому пиксельный предел схождения будет miterlimit * width. Это значение используется только в том случае, если стиль соединения — Qt::MiterJoin.

Траектория рисования, сгенерированная функцией createStroke(), должна использоваться только для обводки заданной траектории рисования. В противном случае это может привести к неожиданному поведению. Сгенерированные контуры также требуют правила Qt::WindingFill, которое установлено по умолчанию.

См. также QPen и QBrush.

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

[since 5.3] QPainterPathStroker::QPainterPathStroker(const QPen &pen)

Создает новый обводчик на основе pen.

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

QPainterPathStroker::QPainterPathStroker()

Создает новый обводчик.

QPainterPathStroker::~QPainterPathStroker()

Удаляет обводчик.

Qt::PenCapStyle QPainterPathStroker::capStyle() const

Возвращает стиль закругления сгенерированных контуров.

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

QPainterPath QPainterPathStroker::createStroke(const QPainterPath &path) const

Генерирует новую траекторию, которая представляет собой заполненную область, являющуюся контуром заданной path.

Различные аспекты дизайна контура основаны на свойствах обводчика: width(), capStyle(), joinStyle(), dashPattern(), curveThreshold() и miterLimit().

Сгенерированная траектория должна использоваться только для обводки заданной траектории рисования. В противном случае это может привести к неожиданному поведению. Сгенерированные контуры также требуют правила Qt::WindingFill, которое установлено по умолчанию.

qreal QPainterPathStroker::curveThreshold() const

Возвращает порог сглаживания кривой для сгенерированных контуров.

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

qreal QPainterPathStroker::dashOffset() const

Возвращает смещение штриховки для сгенерированных контуров.

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

QList<qreal> QPainterPathStroker::dashPattern() const

Возвращает шаблон штриховки для сгенерированных контуров.

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

Qt::PenJoinStyle QPainterPathStroker::joinStyle() const

Возвращает стиль соединения для сгенерированных контуров.

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

qreal QPainterPathStroker::miterLimit() const

Возвращает предел схождения для сгенерированных контуров.

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

void QPainterPathStroker::setCapStyle(Qt::PenCapStyle style)

Устанавливает стиль закругления сгенерированных контуров на style. Если установлен шаблон штриховки, каждый сегмент шаблона подчиняется стилю закругления style.

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

void QPainterPathStroker::setCurveThreshold(qreal threshold)

Задает порог сглаживания кривой, контролируя точность, с которой рисуется кривая сгенерированных контуров.

Значение по умолчанию — хорошо подобранное значение (0.25), и обычно его изменять не нужно. Тем не менее, можно сделать кривую более плавной, уменьшив ее значение.

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

void QPainterPathStroker::setDashOffset(qreal offset)

Устанавливает смещение пунктирной линии для сгенерированных контуров в offset.

См. документацию для QPen::setDashOffset() для описания смещения пунктирной линии.

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

void QPainterPathStroker::setDashPattern(Qt::PenStyle style)

Устанавливает шаблон пунктирной линии для сгенерированных контуров в style.

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

void QPainterPathStroker::setDashPattern(const QList<qreal> &dashPattern)

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

Устанавливает шаблон пунктирной линии для сгенерированных контуров в dashPattern. Эта функция позволяет задавать пользовательские шаблоны пунктирной линии.

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

Список может содержать нечётное число элементов, в этом случае последний элемент будет расширен на длину первого элемента при повторении шаблона.

void QPainterPathStroker::setJoinStyle(Qt::PenJoinStyle style)

Устанавливает стиль соединения сгенерированных контуров в style.

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

void QPainterPathStroker::setMiterLimit(qreal limit)

Устанавливает предел среза для сгенерированных контуров в limit.

Предел среза определяет расстояние от каждого соединения, на которое может распространяться соединение среза. Предел задаётся в единицах текущей ширины. Таким образом, пиксельный предел среза будет miterlimit * width.

Это значение используется только в том случае, если стиль соединения — Qt::MiterJoin.

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

void QPainterPathStroker::setWidth(qreal width)

Устанавливает ширину сгенерированной обводки пути рисования в width.

Сгенерированные контуры будут примерно на 50% от width с каждой стороны от исходного контура заданного входного пути.

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

qreal QPainterPathStroker::width() const

Возвращает ширину сгенерированных контуров.

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