Класс 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().