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 |
- Lista de todos los miembros, incluidos los heredados
- QPainterPathStroker forma parte de las clases de pintura.
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.
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.