QImageIOPlugin Class
La clase QImageIOPlugin define una interfaz para crear un complemento de formato de imagen. Más información...
| Encabezado: | #include <QImageIOPlugin> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| Heredado de: | QObject |
- Lista de todos los miembros, incluidos los heredados
- QImageIOPlugin forma parte de las clases de complementos.
Nota: Todas las funciones de esta clase son reentrantes.
Tipos públicos
| flags | Capabilities |
| enum | Capability { CanRead, CanWrite, CanReadIncremental } |
Funciones públicas
| QImageIOPlugin(QObject *parent = nullptr) | |
| virtual | ~QImageIOPlugin() |
| virtual QImageIOPlugin::Capabilities | capabilities(QIODevice *device, const QByteArray &format) const = 0 |
| virtual QImageIOHandler * | create(QIODevice *device, const QByteArray &format = QByteArray()) const = 0 |
Descripción detallada
QImageIOPlugin es una fábrica para crear objetos ` QImageIOHandler `, que utilizan internamente ` QImageReader ` y ` QImageWriter ` para añadir compatibilidad con diferentes formatos de imagen a Qt.
Para escribir un complemento de E/S de imágenes, hay que crear una subclase de esta clase base, reimplementar las funciones virtuales puras capabilities() y create(), y exportar la clase con la macro Q_PLUGIN_METADATA(). Consulta «Cómo crear complementos de Qt XML» para obtener más detalles.
Un complemento de formato de imagen puede admitir tres capacidades: lectura (CanRead), escritura (CanWrite) y lectura incremental (CanReadIncremental). Reimplementa capabilities() en tu subclase para exponer las capacidades de tu formato de imagen.
create() debe crear una instancia de tu subclase de QImageIOHandler, con el dispositivo y el formato proporcionados correctamente configurados, y devolver este controlador.
El archivo de metadatos JSON del complemento debe contener información sobre los formatos de imagen que admite, junto con los tipos MIME correspondientes (uno por cada formato). Para un complemento JPEG, esto podría tener, por ejemplo, el siguiente aspecto:
{
"Keys": [ "jpg", "jpeg" ],
"MimeTypes": [ "image/jpeg", "image/jpeg" ]
}Los distintos complementos pueden admitir diferentes capacidades. Por ejemplo, puede tener un complemento que admita la lectura del formato GIF y otro que admita la escritura. Qt seleccionará el complemento adecuado para la tarea, en función del valor de retorno de ` capabilities()` (). Si varios complementos admiten la misma capacidad, Qt seleccionará uno de forma arbitraria.
Véase también ` QImageIOHandler ` y «Cómo crear complementos de Qt».
Documentación sobre tipos de miembros
enum QImageIOPlugin::Capability
flags QImageIOPlugin::Capabilities
Esta enumeración describe las capacidades de un ` QImageIOPlugin`.
| Constante | Valor | Descripción |
|---|---|---|
QImageIOPlugin::CanRead | 0x1 | El complemento puede leer imágenes. |
QImageIOPlugin::CanWrite | 0x2 | El complemento puede escribir imágenes. |
QImageIOPlugin::CanReadIncremental | 0x4 | El complemento puede leer imágenes de forma incremental. |
El tipo Capabilities es un typedef para QFlags<Capability>. Almacena una combinación OR de valores de Capability.
Documentación de las funciones miembro
[explicit] QImageIOPlugin::QImageIOPlugin(QObject *parent = nullptr)
Crea un complemento de imagen con el parent especificado. El código generado por moc que exporta el complemento lo invoca automáticamente.
[virtual noexcept] QImageIOPlugin::~QImageIOPlugin()
Elimina el complemento de formato de imagen.
No es necesario llamar a esta función de forma explícita. Qt elimina un complemento automáticamente cuando ya no se utiliza.
[pure virtual] QImageIOPlugin::Capabilities QImageIOPlugin::capabilities(QIODevice *device, const QByteArray &format) const
Devuelve las capacidades del complemento, basándose en los datos de device y el formato format. Si device es 0, simplemente debe indicar si el formato se puede leer o escribir. De lo contrario, debe intentar determinar si el formato dado (o cualquier formato compatible con el complemento si format está vacío) se puede leer o escribir en device. Debe hacerlo sin modificar el estado de device (normalmente utilizando QIODevice::peek()).
Por ejemplo, si el QImageIOPlugin admite el formato BMP, format está vacío o es "bmp", y los datos del dispositivo comienzan con los caracteres "BM", esta función debería devolver CanRead. Si format es "bmp", device es 0 y el controlador admite tanto la lectura como la escritura, esta función debería devolver CanRead | CanWrite.
Los nombres de los formatos siempre se escriben en minúsculas.
[pure virtual] QImageIOHandler *QImageIOPlugin::create(QIODevice *device, const QByteArray &format = QByteArray()) const
Crea y devuelve una subclase de ` QImageIOHandler `, con los campos ` device ` y ` format ` ya establecidos. El campo ` format ` debe proceder de los valores que figuran en la entrada ` "Keys" ` de los metadatos del complemento, o bien estar vacío. Si está vacío, los datos del campo ` device ` deben haber sido reconocidos por el método ` capabilities()` (con un formato igualmente vacío).
Los nombres de los formatos siempre se escriben en minúsculas.
© 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.