QCanvasImage Class
QCanvasImage es la clase de imagen de QCanvasPainter. Más información...
| Encabezado: | #include <QCanvasImage> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS CanvasPainter) target_link_libraries(mytarget PRIVATE Qt6::CanvasPainter) |
| Desde: | Qt 6.11 |
Funciones públicas
| QCanvasImage() | |
| QCanvasImage(const QCanvasImage &image) | |
| QCanvasImage(QCanvasImage &&other) | |
| ~QCanvasImage() | |
| qreal | devicePixelRatio() const |
| int | height() const |
| int | id() const |
| bool | isNull() const |
| void | setTintColor(QColor color) |
| QSize | size() const |
| qsizetype | sizeInBytes() const |
| void | swap(QCanvasImage &other) |
| QColor | tintColor() const |
| int | width() const |
| operator QVariant() const | |
| QCanvasImage & | operator=(QCanvasImage &&other) |
| QCanvasImage & | operator=(const QCanvasImage &image) |
Elementos no miembros relacionados
| bool | operator!=(const QCanvasImage &lhs, const QCanvasImage &rhs) |
| bool | operator==(const QCanvasImage &lhs, const QCanvasImage &rhs) |
Descripción detallada
QCanvasImage es la clase de imagen utilizada por QCanvasPainter. Para poder dibujar imágenes, primero deben estar disponibles, por ejemplo, mediante QCanvasPainter::addImage(). A continuación, las imágenes se pueden dibujar tal cual utilizando QCanvasPainter::drawImage() o utilizarse con QCanvasImagePattern pincel para rellenar o trazar.
He aquí un ejemplo sencillo:
static QImage logoImage(":/qtlogo.png");
// Paint an image pattern.
QCanvasImage bg = painter.addImage(logoImage,
QCanvasPainter::ImageFlag::Repeat |
QCanvasPainter::ImageFlag::GenerateMipmaps);
QCanvasImagePattern ip(bg, 0, 0, 44, 32);
painter.setFillStyle(ip);
painter.fillRect(50, 50, 320, 230);
// Paint a single image, with tint color.
QCanvasImage logo = painter.addImage(logoImage);
logo.setTintColor("#2cde85");
painter.drawImage(logo, 100, 80);
En el ejemplo anterior, ` QImage ` es una variable estática y se llama a `addImage()` en cada repintado. Esto no supone ningún problema, ya que, cuando la imagen y los indicadores (flags) siguen siendo los mismos, `addImage()` recupera la imagen de la caché en lugar de volver a cargarla como textura. Sin embargo, un enfoque más habitual consiste en tener variables `QCanvasImage` como miembros de la clase y llamar a ` QCanvasPainter::addImage()` (por ejemplo, en ` QCanvasPainterItemRenderer::initializeResources()`).
Al igual que en QCanvasBrush y QCanvasOffscreenCanvas, QCanvasImage se comparte explícitamente. Consulta «Compartición implícita de datos » y « QSharedDataPointer » para obtener más detalles.
Nota: Un objeto QCanvasImage contiene únicamente un identificador de un recurso gráfico, como una textura. Incluso cuando se produce una desconexión, el recurso real —es decir, la textura subyacente y los datos de imagen que contiene— nunca se copia ni se duplica realmente. El propietario real del recurso gráfico (p. ej., un ` QRhiTexture`) es el ` QCanvasPainter ` que proporcionó el `QCanvasImage` mediante ` addImage()` ().
Un QCanvasImage siempre pertenece al QCanvasPainter que lo creó. Para eliminar imágenes manualmente, se debe llamar a removeImage(). Sin embargo, en la mayoría de los casos esto no será necesario, ya que el pintor destruirá automáticamente cualquier imagen durante su propia destrucción.
Documentación de las funciones de miembro
QCanvasImage::QCanvasImage()
Crea una imagen predeterminada.
QCanvasImage::QCanvasImage(const QCanvasImage &image)
Crea una imagen que es una copia de la imagen « image » indicada.
[constexpr noexcept default] QCanvasImage::QCanvasImage(QCanvasImage &&other)
Crea un nuevo objeto `QCanvasImage` a partir de ` other`.
[noexcept] QCanvasImage::~QCanvasImage()
Destruye la imagen.
qreal QCanvasImage::devicePixelRatio() const
Devuelve la relación de píxeles del dispositivo para la imagen. Se trata de la relación entre los píxeles del dispositivo y los píxeles independientes del dispositivo.
Un « QCanvasImage » con una relación de píxeles del dispositivo superior a 1 aplica ese factor de escala al utilizar la imagen. Por ejemplo, drawImage(image, 0, 0) es entonces equivalente a drawImage(image, 0, 0, image.width() / image.devicePixelRatio(), image.height() / image.devicePixelRatio()).
El valor por defecto es 1,0.
El valor se hereda del ` QImage ` a partir del cual se crea el ` QCanvasImage `. Un ` QCanvasImage ` creado a partir de una textura o de ` offscreen canvas ` siempre tiene una relación de píxeles del dispositivo de 1.
Véase también « QImage ».
int QCanvasImage::height() const
Devuelve la altura de esta imagen en píxeles;
int QCanvasImage::id() const
Devuelve el identificador de textura de esta imagen. Si aún no se ha asignado la imagen, devuelve 0.
Véase también isNull().
bool QCanvasImage::isNull() const
Devuelve «true» si la imagen aún no se ha asignado. Consulta QCanvasPainter::addImage() para obtener más información.
void QCanvasImage::setTintColor(QColor color)
Establece el tono color de la imagen. Este color se multiplicará por el color de la imagen para darle color. Esto se puede utilizar, por ejemplo, para resaltar iconos o para ajustar las imágenes según el tema.
Véase también tintColor().
QSize QCanvasImage::size() const
Devuelve el tamaño (anchura y altura) de esta imagen en píxeles.
qsizetype QCanvasImage::sizeInBytes() const
Devuelve el tamaño de esta imagen en bytes.
QCanvasPainter No conserva copias de los datos de la CPU ( QImage ) una vez que addImage() ha devuelto un valor. Si la fuente es un offscreen canvas, entonces, para empezar, no hay datos de imagen en la CPU. Por lo tanto, el resultado de esta función es una aproximación de la memoria de la GPU que se utiliza para la textura subyacente.
Nota: El valor es solo una estimación basada en el formato y las dimensiones de la imagen. Qt desconoce cómo se almacenan y distribuyen en la memoria de la GPU los datos de las texturas.
Nota: Esta función no tiene en cuenta los datos de mipmap ni de multimuestreo.
[noexcept] void QCanvasImage::swap(QCanvasImage &other)
Cambia esta imagen por other. Esta operación es muy rápida y nunca falla.
QColor QCanvasImage::tintColor() const
Devuelve el color de tinte de la imagen. El valor por defecto es Qt::white.
Véase también setTintColor().
int QCanvasImage::width() const
Devuelve el ancho de esta imagen en píxeles.
QCanvasImage::operator QVariant() const
Devuelve la imagen como un objeto ` QVariant`.
[noexcept] QCanvasImage &QCanvasImage::operator=(QCanvasImage &&other)
Asigna « other » a esta instancia de « QCanvasImage ».
QCanvasImage &QCanvasImage::operator=(const QCanvasImage &image)
Asigna el « image » indicado a esta imagen y devuelve una referencia a la misma.
Elementos relacionados no miembros
[noexcept] bool operator!=(const QCanvasImage &lhs, const QCanvasImage &rhs)
Devuelve ` true ` si el identificador de la imagen ` lhs ` es distinto de ` rhs`; en caso contrario, devuelve ` false `.
Véase también operator==().
[noexcept] bool operator==(const QCanvasImage &lhs, const QCanvasImage &rhs)
Devuelve ` true ` si el identificador de imagen ` lhs ` es igual a ` rhs`; en caso contrario, devuelve ` false `.
Nota: La igualdad significa que los dos objetos de imagen hacen referencia a los mismos recursos gráficos y que los colores de matiz son los mismos. No se compara el contenido (datos de píxeles).
Véase también operator!=().
© 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.