Sistema de coordenadas
El sistema de coordenadas está controlado por la clase ` QPainter `. Junto con las clases ` QPaintDevice ` y ` QPaintEngine `, ` QPainter ` constituyen la base del sistema de dibujo de Qt, Arthur. ` QPainter ` se utiliza para realizar operaciones de dibujo, ` QPaintDevice ` es una abstracción de un espacio bidimensional sobre el que se puede dibujar utilizando un ` QPainter`, y ` QPaintEngine ` proporciona la interfaz que utiliza el dibujante para dibujar en diferentes tipos de dispositivos.
La clase ` QPaintDevice ` es la clase base de los objetos sobre los que se puede dibujar: sus capacidades de dibujo son heredadas por las clases ` QWidget`, ` QImage`, ` QPixmap`, ` QPicture` y ` QOpenGLPaintDevice `. El sistema de coordenadas predeterminado de un dispositivo de pintura tiene su origen en la esquina superior izquierda. Los valores x aumentan hacia la derecha y los valores y aumentan hacia abajo. La unidad por defecto es un píxel en dispositivos basados en píxeles y un punto (1/72 de pulgada) en impresoras.
La correspondencia entre las coordenadas lógicas QPainter y las coordenadas físicas QPaintDevice se gestiona mediante la matriz de transformación, la ventana de visualización y la «ventana» de QPainter. Los sistemas de coordenadas lógicas y físicas coinciden por defecto. QPainter también admite transformaciones de coordenadas (por ejemplo, rotación y escalado).
Renderizado
Representación lógica
El tamaño (anchura y altura) de una primitiva gráfica siempre se corresponde con su modelo matemático, independientemente de la anchura del trazo con el que se represente:
| QRect(QPoint(1, 2), QPoint(7, 6)) | QLine(QPoint(2, 7), QPoint(6, 1)) |
| QLine(2, 7, 6, 1) | |
| QRect(QPoint(1, 2), QSize(6, 4)) | |
| QRect(1, 2, 6, 4) |
Pintura con alias
Al dibujar, la representación de los píxeles se controla mediante la indicación de renderizado « QPainter::Antialiasing ».
La enumeración « RenderHint » se utiliza para especificar indicadores a « 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.
Sin embargo, por defecto, el trazo presenta alias y se aplican otras reglas: al renderizar con un trazo de un píxel de ancho, los píxeles se renderizarán a la derecha y por debajo de los puntos definidos matemáticamente. Por ejemplo:
Al dibujar con un trazo de número par de píxeles, estos se representarán simétricamente alrededor de los puntos definidos matemáticamente; mientras que al dibujar con un trazo de número impar de píxeles, el píxel sobrante se representará a la derecha y por debajo del punto matemático, al igual que en el caso de un píxel. Consulte los diagramas de QRectF que aparecen a continuación para ver ejemplos concretos.
| QRectF | |
|---|---|
![]() | ![]() |
| Representación lógica | Lápiz de un píxel de ancho |
![]() | ![]() |
| Lápiz de dos píxeles de ancho | Lápiz de tres píxeles de ancho |
Tenga en cuenta que, por razones históricas, el valor devuelto por las funciones ` QRect::right()` y ` QRect::bottom()` se desvía de la verdadera esquina inferior derecha del rectángulo.
QRectLa función ` right()` devuelve ` left()` + ` width()` - 1, y la función ` bottom()` devuelve ` top()` + ` height()` - 1. El punto verde de la esquina inferior derecha de los diagramas muestra las coordenadas devueltas por estas funciones.
Te recomendamos que utilices simplemente QRectF en su lugar: la clase QRectF define un rectángulo en el plano utilizando coordenadas de punto flotante para mayor precisión (QRect utiliza coordenadas enteras), y las funciones QRectF::right() y QRectF::bottom() sí devuelven la verdadera esquina inferior derecha.
Como alternativa, utilizando QRect, aplica x() + width() y y() + height() para hallar la esquina inferior derecha, y evita las funciones right() y bottom().
Pintura con suavizado
Si se establece la sugerencia de renderizado « anti-aliasing » de QPainter, los píxeles se renderizarán simétricamente a ambos lados de los puntos definidos matemáticamente:
Transformaciones
Por defecto, el QPainter opera en el propio sistema de coordenadas del dispositivo asociado, pero también es totalmente compatible con transformaciones afines de coordenadas.
Puedes escalar el sistema de coordenadas en un desplazamiento determinado utilizando la función QPainter::scale(), puedes girarlo en el sentido de las agujas del reloj con la función QPainter::rotate() y puedes trasladarlo (es decir, añadir un desplazamiento determinado a los puntos) mediante la función QPainter::translate().
También puedes girar el sistema de coordenadas alrededor del origen utilizando la función QPainter::shear(). Todas las operaciones de transformación se aplican a la matriz de transformación de QPainter, que puedes obtener mediante la función QPainter::worldTransform(). Una matriz transforma un punto del plano en otro punto.
Si necesitas aplicar las mismas transformaciones una y otra vez, también puedes utilizar objetos de « QTransform » y las funciones « QPainter::worldTransform » () y « QPainter::setWorldTransform » (). En cualquier momento puedes guardar la matriz de transformación de « QPainter » llamando a la función « QPainter::save » (), que guarda la matriz en una pila interna. La función « QPainter::restore » () la recupera de la pila.
Una necesidad frecuente de la matriz de transformación surge al reutilizar el mismo código de dibujo en diversos dispositivos de visualización. Sin transformaciones, los resultados quedan estrictamente ligados a la resolución del dispositivo de visualización. Las impresoras tienen una alta resolución, por ejemplo, 600 puntos por pulgada, mientras que las pantallas suelen tener entre 72 y 100 puntos por pulgada.
| Ejemplo de reloj analógico | |
|---|---|
![]() | El ejemplo del reloj analógico muestra cómo dibujar el contenido de un widget personalizado utilizando la matriz de transformación de QPainter. Recomendamos compilar y ejecutar este ejemplo antes de seguir leyendo. En concreto, prueba a cambiar el tamaño de la ventana a diferentes dimensiones. |
Trasladamos el sistema de coordenadas para que el punto (0, 0) se encuentre en el centro del widget, en lugar de en la esquina superior izquierda. También escalamos el sistema por Esto nos dará un área cuadrada de 200 x 200, con el origen (0, 0) en el centro, sobre la que podremos dibujar. Lo que dibujemos aparecerá en el cuadrado más grande posible que quepa en el widget. Véase también la sección «Conversión de ventana a ventana de visualización ». Dibujamos la manecilla de las horas del reloj girando el sistema de coordenadas y llamando a ` QPainter::drawConvexPolygon()`. Gracias a la rotación, se dibuja apuntando en la dirección correcta. El polígono se especifica como una matriz de valores x e y alternados, almacenados en la variable estática ` Las llamadas a ` QPainter::save()` y ` QPainter::restore()` que enmarcan el código garantizan que el código que sigue no se vea afectado por las transformaciones que hemos utilizado. A continuación, dibujamos los marcadores horarios de la esfera del reloj, que consisten en doce líneas cortas separadas por intervalos de 30 grados. Cuando finaliza ese bucle, el «painter» ha girado un círculo completo hasta volver a su estado original, por lo que no es necesario guardar ni restaurar el estado. Hacemos lo mismo con la manecilla de los minutos del reloj, que viene definida por los tres puntos (7, 8), (-7, 8) y (0, -70). Estas coordenadas especifican una manecilla más fina y más larga que la de los minutos. Por último, dibujamos los marcadores de los minutos de la esfera del reloj, que consta de sesenta líneas cortas a intervalos de 6 grados. Omitimos cada quinto marcador de minutos porque no queremos dibujar sobre los marcadores de horas. Al final de este proceso, el «painter» gira de una forma que no resulta muy útil, pero ya hemos terminado de dibujar, así que eso no importa. | |
Para obtener más información sobre la matriz de transformación, consulta la documentación de QTransform.
Conversión de ventana a ventana de visualización
Al dibujar con QPainter, especificamos los puntos utilizando coordenadas lógicas que luego se convierten en las coordenadas físicas del dispositivo de dibujo.
La correspondencia entre las coordenadas lógicas y las físicas se gestiona mediante la función de transformación global de QPainter, ` worldTransform()` (descrita en la sección «Transformaciones» ), y las funciones de QPainter, ` viewport()` y ` window()`. La ventana de visualización representa las coordenadas físicas especificando un rectángulo arbitrario. La «ventana» describe el mismo rectángulo en coordenadas lógicas. Por defecto, los sistemas de coordenadas lógicas y físicas coinciden y son equivalentes al rectángulo del dispositivo de dibujo.
Mediante la conversión entre ventana y ventana de visualización, puedes adaptar el sistema de coordenadas lógicas a tus preferencias. Este mecanismo también puede utilizarse para que el código de dibujo sea independiente del dispositivo de dibujo. Por ejemplo, puedes hacer que las coordenadas lógicas se extiendan desde (-50, -50) hasta (50, 50), con (0, 0) en el centro, llamando a la función ` QPainter::setWindow()`:
Ahora, las coordenadas lógicas (-50, -50) se corresponden con las coordenadas físicas (0, 0) del dispositivo de dibujo. Independientemente del dispositivo de dibujo, el código de dibujo siempre operará sobre las coordenadas lógicas especificadas.
Al definir la «ventana» o el rectángulo de la ventana de visualización, se realiza una transformación lineal de las coordenadas. Ten en cuenta que cada esquina de la «ventana» se corresponde con la esquina correspondiente de la ventana de visualización, y viceversa. Por ese motivo, suele ser recomendable que la ventana de visualización y la «ventana» mantengan la misma relación de aspecto para evitar deformaciones:
int side = qMin(width(), height());
int x = (width() - side / 2);
int y = (height() - side / 2);
painter.setViewport(x, y, side, side);Si hacemos que el sistema de coordenadas lógicas sea un cuadrado, también deberíamos hacer que el área de visualización sea un cuadrado utilizando la función QPainter::setViewport(). En el ejemplo anterior lo hacemos equivalente al cuadrado más grande que cabe en el rectángulo del dispositivo de dibujo. Al tener en cuenta el tamaño del dispositivo de dibujo al configurar la ventana o la ventana de visualización, es posible mantener el código de dibujo independiente del dispositivo de dibujo.
Ten en cuenta que la conversión de ventana a ventana de visualización es solo una transformación lineal, es decir, no realiza recorte. Esto significa que, si dibujas fuera de la «ventana» establecida actualmente, tu dibujo seguirá transformándose a la ventana de visualización utilizando el mismo enfoque algebraico lineal.
La ventana gráfica, la «ventana» y la matriz de transformación determinan cómo se asignan las coordenadas lógicas QPainter a las coordenadas físicas del dispositivo de dibujo. Por defecto, la matriz de transformación del mundo es la matriz identidad, y la configuración de la «ventana» y del área de visualización son equivalentes a la configuración del dispositivo de dibujo; es decir, los sistemas de coordenadas del mundo, de la «ventana» y del dispositivo son equivalentes, pero, como hemos visto, los sistemas pueden manipularse mediante operaciones de transformación y la conversión de ventana a área de visualización. La ilustración anterior describe el proceso.
Véase también «Reloj analógico».
© 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.








