En esta página

QPixmapCache Class

La clase QPixmapCache proporciona una caché de mapas de píxeles para toda la aplicación. Más información...

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

Tipos públicos

class Key

Miembros públicos estáticos

int cacheLimit()
void clear()
bool find(const QPixmapCache::Key &key, QPixmap *pixmap)
bool find(const QString &key, QPixmap *pixmap)
QPixmapCache::Key insert(const QPixmap &pixmap)
bool insert(const QString &key, const QPixmap &pixmap)
void remove(const QPixmapCache::Key &key)
void remove(const QString &key)
void setCacheLimit(int n)

Descripción detallada

Esta clase es una herramienta para optimizar el dibujo con ` QPixmap`. Se puede utilizar para almacenar mapas de píxeles temporales cuya generación resulta costosa, sin utilizar más espacio de almacenamiento que ` cacheLimit()`. Utiliza ` insert()` para insertar mapas de píxeles, ` find()` para buscarlos y ` clear()` para vaciar la caché.

QPixmapCache no contiene datos de miembro, solo funciones estáticas para acceder a la caché global de mapas de píxeles. Crea un objeto interno QCache para almacenar en caché los mapas de píxeles.

La caché asocia un mapa de píxeles a una cadena proporcionada por el usuario como clave, o a un ` QPixmapCache::Key ` generado por la propia caché. El uso de ` QPixmapCache::Key ` como claves es más rápido que el de cadenas. La API de cadenas resulta muy práctica para claves complejas, pero la API de « QPixmapCache::Key » será muy eficiente y práctica para una correspondencia uno a uno entre objetos y mapas de píxeles; en este caso, puedes almacenar las claves como miembros de un objeto.

Si se insertan dos mapas de píxeles en la caché utilizando claves iguales, el último mapa de píxeles sustituirá al primero en la caché. Esto sigue el comportamiento de las clases QHash y QCache.

La caché se llena cuando el tamaño total de todos los mapas de píxeles de la caché supera el valor de ` cacheLimit()`. El límite inicial de la caché es de 10 240 KB (10 MB); puede modificarlo llamando a ` setCacheLimit()` con el valor deseado. Un mapa de píxeles ocupa aproximadamente (anchura * altura * profundidad)/8 bytes de memoria.

El artículo de Qt Quarterly «Optimización con QPixmapCache» explica cómo utilizar QPixmapCache para acelerar las aplicaciones almacenando en caché los resultados del dibujo.

Nota: QPixmapCache solo se puede utilizar desde el hilo principal de la aplicación. El acceso desde otros hilos se ignorará y devolverá un error.

Véase también QCache y QPixmap.

Documentación de las funciones de miembro

[static] int QPixmapCache::cacheLimit()

Devuelve el límite de la caché (en kilobytes).

El límite predeterminado de la caché es 10 240 KB.

Véase también setCacheLimit().

[static] void QPixmapCache::clear()

Elimina todos los mapas de píxeles de la caché.

[static] bool QPixmapCache::find(const QPixmapCache::Key &key, QPixmap *pixmap)

Busca en la caché un mapa de píxeles almacenado asociado al ` key ` indicado. Si se encuentra el mapa de píxeles, la función asigna ` pixmap ` a ese mapa y devuelve ` true`; en caso contrario, deja ` pixmap ` tal cual y devuelve ` false`. Si no se encuentra el mapa de píxeles, significa que el ` key ` ya no es válido, por lo que se liberará para la siguiente inserción.

[static] bool QPixmapCache::find(const QString &key, QPixmap *pixmap)

Busca en la caché un mapa de píxeles almacenado asociado al ` key ` indicado. Si se encuentra el mapa de píxeles, la función asigna ` pixmap ` a dicho mapa y devuelve ` true`; en caso contrario, deja ` pixmap ` sin modificar y devuelve ` false`.

Ejemplo:

QPixmap pm;
if (!QPixmapCache::find("my_big_image", &pm)) {
    pm.load("bigimage.png");
    QPixmapCache::insert("my_big_image", pm);
}
painter->drawPixmap(0, 0, pm);

[static] QPixmapCache::Key QPixmapCache::insert(const QPixmap &pixmap)

Inserta una copia del « pixmap » especificado en la caché y devuelve una clave que se puede utilizar para recuperarlo.

Cuando se inserta un mapa de píxeles y la caché está a punto de superar su límite, elimina mapas de píxeles hasta que haya espacio suficiente para insertar el nuevo.

Los pixmaps más antiguos (a los que se ha accedido hace más tiempo en la caché) se eliminan cuando se necesita más espacio.

Véase también setCacheLimit().

[static] bool QPixmapCache::insert(const QString &key, const QPixmap &pixmap)

Inserta en la caché una copia del mapa de píxeles pixmap asociado al key.

Todos los mapas de píxeles insertados por la biblioteca Qt tienen una clave que comienza por «$qt», por lo que tus propias claves de mapas de píxeles nunca deben comenzar por «$qt».

Cuando se inserta un mapa de píxeles y la caché está a punto de superar su límite, esta elimina mapas de píxeles hasta que haya espacio suficiente para insertar el nuevo.

Los pixmaps más antiguos (a los que se ha accedido más recientemente en la caché) se eliminan cuando se necesita más espacio.

La función devuelve « true » si el objeto se ha insertado en la caché; en caso contrario, devuelve « false ».

Véase también setCacheLimit().

[static] void QPixmapCache::remove(const QPixmapCache::Key &key)

Elimina de la caché el mapa de píxeles asociado a key y libera la clave para una futura inserción.

[static] void QPixmapCache::remove(const QString &key)

Elimina de la caché el mapa de píxeles asociado a key.

[static] void QPixmapCache::setCacheLimit(int n)

Establece el límite de la caché en n kilobytes.

El valor predeterminado es 10240 KB.

Véase también cacheLimit().

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