Класс QPainterPathStroker

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

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

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

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

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

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

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

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

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

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

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

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

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

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

QPainterPathStroker::QPainterPathStroker()

Создаёт новый строкер.

QPainterPathStroker::QPainterPathStroker(const QPen &pen)

Создаёт новый строкер, базирующийся на pen.

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

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().

QVector<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 QVector<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)

Устанавливает ширину генерируемой контурной области в painter path в width.

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

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

qreal QPainterPathStroker::width() const

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

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