En esta página

QPainterPathStroker Class

La clase `QPainterPathStroker` se utiliza para generar contornos que se pueden rellenar a partir de una ruta de dibujo determinada. Más información...

Encabezado: #include <QPainterPathStroker>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui

Funciones públicas

QPainterPathStroker()
QPainterPathStroker(const QPen &pen)
~QPainterPathStroker()
Qt::PenCapStyle capStyle() const
QPainterPath createStroke(const QPainterPath &path) const
qreal curveThreshold() const
qreal dashOffset() const
QList<qreal> dashPattern() const
Qt::PenJoinStyle joinStyle() const
qreal miterLimit() const
void setCapStyle(Qt::PenCapStyle style)
void setCurveThreshold(qreal threshold)
void setDashOffset(qreal offset)
void setDashPattern(Qt::PenStyle style)
void setDashPattern(const QList<qreal> &dashPattern)
void setJoinStyle(Qt::PenJoinStyle style)
void setMiterLimit(qreal limit)
void setWidth(qreal width)
qreal width() const

Descripción detallada

Al llamar a la función ` createStroke()` y pasarle como argumento una ruta de pintura dada ` QPainterPath `, se crea una nueva ruta de pintura que representa el contorno de la ruta dada. A continuación, la ruta de pintura recién creada puede rellenarse para dibujar el contorno de la ruta de pintura original.

Se pueden controlar los distintos aspectos de diseño (anchura, estilos de remate, estilos de unión y patrón de trazo) del contorno mediante las siguientes funciones:

La función ` setDashPattern()` admite como argumento tanto un objeto ` Qt::PenStyle ` como una representación en forma de lista del patrón.

Además, puedes especificar el umbral de una curva, controlando así la granularidad con la que se dibuja, mediante la función setCurveThreshold(). El umbral predeterminado es un valor bien ajustado (0,25) y, normalmente, no deberías necesitar modificarlo. Sin embargo, puedes suavizar el aspecto de la curva reduciendo su valor.

También puede controlar el límite de inglete del contorno generado mediante la función ` setMiterLimit()`. El límite de inglete describe hasta qué distancia de cada unión puede extenderse la unión en inglete. El límite se especifica en unidades de anchura, por lo que el límite de inglete por píxel será ` miterlimit * width`. Este valor solo se utiliza si el estilo de unión es ` Qt::MiterJoin`.

La ruta de pintura generada por la función createStroke() solo debe utilizarse para trazar el contorno de la ruta de pintura dada. De lo contrario, podría provocar un comportamiento inesperado. Los contornos generados también requieren la regla Qt::WindingFill, que está establecida por defecto.

Véase también QPen y QBrush.

Documentación de las funciones de miembro

QPainterPathStroker::QPainterPathStroker()

Crea un nuevo «stroker».

[explicit] QPainterPathStroker::QPainterPathStroker(const QPen &pen)

Crea un nuevo «stroker» basado en pen.

[noexcept] QPainterPathStroker::~QPainterPathStroker()

Destruye el «stroker».

Qt::PenCapStyle QPainterPathStroker::capStyle() const

Devuelve el estilo de contorno de las siluetas generadas.

Véase también setCapStyle().

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

Genera una nueva ruta que es un área que se puede rellenar y que representa el contorno del elemento dado path.

Los distintos aspectos de diseño del contorno se basan en las propiedades del trazador: width(), capStyle(), joinStyle(), dashPattern(), curveThreshold() y miterLimit().

La ruta generada solo debe utilizarse para perfilar la ruta de pintado dada. De lo contrario, podría provocar un comportamiento inesperado. Los contornos generados también requieren la regla « Qt::WindingFill », que está activada por defecto.

qreal QPainterPathStroker::curveThreshold() const

Devuelve el umbral de aplanamiento de la curva para los contornos generados.

Véase también setCurveThreshold().

qreal QPainterPathStroker::dashOffset() const

Devuelve el desplazamiento del guion para los contornos generados.

Véase también setDashOffset().

QList<qreal> QPainterPathStroker::dashPattern() const

Devuelve el patrón de guiones para los contornos generados.

Véase también setDashPattern().

Qt::PenJoinStyle QPainterPathStroker::joinStyle() const

Devuelve el estilo de unión de los contornos generados.

Véase también setJoinStyle().

qreal QPainterPathStroker::miterLimit() const

Devuelve el límite de inglete de los contornos generados.

Véase también setMiterLimit().

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

Establece el estilo de remate de los contornos generados en « style ». Si se establece un patrón de trazos, cada segmento del patrón se ajusta al remate « style ».

Véase también capStyle().

void QPainterPathStroker::setCurveThreshold(qreal threshold)

Especifica el «aplanamiento de la curva» ( threshold), que controla el nivel de detalle con el que se dibuja la curva de los contornos generados.

El umbral predeterminado es un valor bien ajustado (0,25) y, normalmente, no debería ser necesario modificarlo. No obstante, puede suavizar el aspecto de la curva reduciendo su valor.

Véase también curveThreshold().

void QPainterPathStroker::setDashOffset(qreal offset)

Establece el desplazamiento del guion para los contornos generados en offset.

Consulta la documentación de QPen::setDashOffset() para obtener una descripción del desplazamiento de los trazos.

Véase también ` dashOffset()`.

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

Establece el patrón de guiones de los contornos generados en « style ».

Véase también dashPattern().

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

Establece el patrón de trazos de los contornos generados en « dashPattern ». Esta función permite especificar patrones de trazos personalizados.

Cada elemento de la lista contiene las longitudes de los trazos y los espacios del trazo, comenzando por el primer trazo en el primer elemento, el primer espacio en el segundo elemento y alternando entre trazos y espacios en cada par de elementos siguientes.

La lista puede contener un número impar de elementos; en ese caso, el último elemento se ampliará en la longitud del primer elemento cuando se repita el patrón.

Esta es una función sobrecargada.

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

Establece el estilo de unión de los contornos generados en « style ».

Véase también ` joinStyle()`.

void QPainterPathStroker::setMiterLimit(qreal limit)

Establece el límite de inglete de los contornos generados en ` limit`.

El límite de inglete describe hasta qué distancia de cada unión puede extenderse la unión en inglete. El límite se especifica en unidades del ancho establecido actualmente. Por lo tanto, el límite de inglete en píxeles será miterlimit * width.

Este valor solo se utiliza si el estilo de unión es « Qt::MiterJoin ».

Véase también miterLimit().

void QPainterPathStroker::setWidth(qreal width)

Establece el ancho del trazado generado por la herramienta «Outline Painter» en width.

Los contornos generados se extenderán aproximadamente un 50 % de width a cada lado del contorno original de la ruta de entrada dada.

Véase también ` width()`.

qreal QPainterPathStroker::width() const

Devuelve el ancho de los contornos generados.

Véase también setWidth().

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.