En esta página

Dibujo y relleno

Dibujo

QPainter QPoint QLine QRect QRegion QPolygon QPainterPath QPainterPath XML-Qt GUI

Logotipo de Qt

QPainterPath

Un trazado de pintura es un objeto compuesto por líneas y curvas. Por ejemplo, un rectángulo está compuesto por líneas y una elipse, por curvas.

La principal ventaja de las rutas de dibujo frente a las operaciones de dibujo normales es que las formas complejas solo tienen que crearse una vez; después, pueden dibujarse muchas veces utilizando únicamente llamadas a la función QPainter::drawPath().

Un objeto ` QPainterPath ` se puede utilizar para rellenar, trazar contornos y recortar. Para generar contornos rellenables para una ruta de dibujo determinada, utiliza la clase ` QPainterPathStroker `.

Las líneas y los contornos se dibujan utilizando la clase ` QPen `. Un lápiz se define por su estilo (es decir, su tipo de línea), su grosor, su pincel, cómo se dibujan los extremos (estilo de remate) y cómo se dibujan las uniones entre dos líneas conectadas (estilo de unión). El pincel del lápiz es un objeto ` QBrush ` que se utiliza para rellenar los trazos generados con el lápiz; es decir, la clase ` QBrush ` define el patrón de relleno.

QPainter También puede dibujar texto alineado y mapas de píxeles.

Al dibujar texto, la fuente se especifica mediante la clase ` QFont `. Qt utilizará la fuente con los atributos especificados o, si no existe ninguna fuente que coincida, utilizará la fuente instalada más parecida. Los atributos de la fuente que se utiliza realmente pueden recuperarse mediante la clase ` QFontInfo `. Además, la clase ` QFontMetrics ` proporciona las medidas de la fuente, y la clase ` QFontDatabase ` ofrece información sobre las fuentes disponibles en el sistema de ventanas subyacente.

Normalmente, QPainter dibuja en un sistema de coordenadas «natural», pero es capaz de realizar transformaciones de vista y del mundo mediante la clase QTransform. Para obtener más información, consulta «Sistema de coordenadas», donde también se describe el proceso de renderizado, es decir, la relación entre la representación lógica y los píxeles renderizados, así como las ventajas del dibujo con suavizado.

Dibujo con suavizado

Al dibujar, el renderizado de píxeles se controla mediante la indicación de renderizado « QPainter::Antialiasing ». La enumeración ` QPainter::RenderHint ` se utiliza para especificar indicadores para « QPainter » que pueden ser respetados o no por cualquier motor dado.

El valor « QPainter::Antialiasing » indica que el motor debe aplicar suavizado a los bordes de las primitivas si es posible, es decir, suavizar los bordes utilizando diferentes intensidades de color.

Captura de pantalla en la que se muestra un dibujo renderizado con suavizado de bordes

Relleno

Las formas se rellenan utilizando la clase ` QBrush `. Un pincel se define por su color y su estilo (es decir, su patrón de relleno).

Cualquier color en Qt se representa mediante la clase ` QColor `, que admite los modelos de color RGB, HSV y CMYK. ` QColor ` también admite contornos y rellenos con mezcla alfa (especificando el efecto de transparencia), y la clase es independiente de la plataforma y del dispositivo. Para obtener más información, consulta la documentación de la clase ` QColor `.

Los patrones de relleno disponibles se describen mediante la enumeración Qt::BrushStyle. Entre ellos se incluyen patrones básicos que van desde un color uniforme hasta un patrón muy disperso, diversas combinaciones de líneas, rellenos degradados y texturas. Qt proporciona la clase QGradient para definir rellenos degradados personalizados, mientras que los patrones de textura se especifican mediante la clase QPixmap.

Captura de pantalla del ejemplo de degradado

QGradient

La clase ` QGradient ` se utiliza junto con ` QBrush ` para especificar rellenos degradados.

Ilustración que muestra tres formas diferentes en las que se pueden utilizar los degradados

Actualmente, Qt admite tres tipos de rellenos degradados: los degradados lineales interpolan los colores entre los puntos inicial y final; los degradados radiales interpolan los colores entre un punto focal y los puntos finales situados en un círculo que lo rodea; y los degradados cónicos interpolan los colores alrededor de un punto central.

© 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.