QImageIOHandler Class

Documentación de las funciones miembro

QImageIOHandler::QImageIOHandler()

Construye un objeto QImageIOHandler.

[virtual noexcept] QImageIOHandler::~QImageIOHandler()

Destruye el objeto QImageIOHandler.

[static, since 6.0] bool QImageIOHandler::allocateImage(QSize size, QImage::Format format, QImage *image)

Este es un método conveniente para la función de lectura en subclases. Los manejadores de formato de imagen deben rechazar la carga de una imagen si la asignación requerida excede el límite de asignación actual. Esta función comprueba los parámetros y el límite, y realiza la asignación si es válida y necesaria. Si se devuelve correctamente, image será un QImage válido y separado de los size y format dados.

Esta función se introdujo en Qt 6.0.

Véase también QImageReader::allocationLimit().

[pure virtual] bool QImageIOHandler::canRead() const

Devuelve true si se puede leer una imagen del dispositivo (es decir, el formato de imagen es compatible, se puede leer del dispositivo y la información de cabecera inicial sugiere que se puede leer la imagen); en caso contrario devuelve false.

Cuando reimplemente canRead(), asegúrese de que el dispositivo de E/S (device()) se deja en su estado original (por ejemplo, utilizando peek() en lugar de read()).

Véase también read() y QIODevice::peek().

[virtual] int QImageIOHandler::currentImageNumber() const

Para los formatos de imagen que admiten animación, esta función devuelve el número de secuencia de la imagen actual en la animación. Si se llama a esta función antes de que cualquier imagen sea read(), se devuelve -1. El número de la primera imagen de la secuencia es 0.

Si el formato de la imagen no admite animación, se devuelve 0.

Véase también read().

[virtual] QRect QImageIOHandler::currentImageRect() const

Devuelve el rectángulo de la imagen actual. Si no se define un rect para la imagen, se devuelve un QRect() vacío.

Esta función es útil para animaciones, en las que sólo se pueden actualizar partes del fotograma a la vez.

QIODevice *QImageIOHandler::device() const

Devuelve el dispositivo asignado actualmente a QImageIOHandler. Si no se ha asignado ningún dispositivo, se devuelve nullptr.

Véase también setDevice().

QByteArray QImageIOHandler::format() const

Devuelve el formato asignado actualmente a QImageIOHandler. Si no se ha asignado ningún formato, se devuelve una cadena vacía.

Véase también setFormat().

[virtual] int QImageIOHandler::imageCount() const

Para formatos de imagen que soportan animación, esta función devuelve el número de imágenes de la animación. Si el formato de imagen no soporta animación, o si es incapaz de determinar el número de imágenes, se devuelve 0.

La implementación por defecto devuelve 1 si canRead() devuelve true; en caso contrario se devuelve 0.

[virtual] bool QImageIOHandler::jumpToImage(int imageNumber)

Para los formatos de imagen que admiten animación, esta función salta a la imagen cuyo número de secuencia es imageNumber. La siguiente llamada a read() intentará leer esta imagen.

La implementación por defecto no hace nada y devuelve false.

[virtual] bool QImageIOHandler::jumpToNextImage()

Para formatos de imagen que soportan animación, esta función salta a la siguiente imagen.

La implementación por defecto no hace nada y devuelve false.

[virtual] int QImageIOHandler::loopCount() const

Para formatos de imagen que soportan animación, esta función devuelve el número de veces que la animación debe repetirse. Si el formato de imagen no admite animación, se devuelve 0.

[virtual] int QImageIOHandler::nextImageDelay() const

Para formatos de imagen que soportan animación, esta función devuelve el número de milisegundos a esperar hasta leer la siguiente imagen. Si el formato de imagen no admite animación, se devuelve 0.

[virtual] QVariant QImageIOHandler::option(QImageIOHandler::ImageOption option) const

Devuelve el valor asignado a option como QVariant. El tipo del valor depende de la opción. Por ejemplo, option(Size) devuelve una variante de QSize.

Véase también setOption() y supportsOption().

[pure virtual] bool QImageIOHandler::read(QImage *image)

Lee una imagen del dispositivo y la almacena en image. Devuelve true si la imagen se ha leído correctamente; en caso contrario, devuelve false.

Para formatos de imagen que soportan carga incremental, y para formatos de animación, el manejador de la imagen puede asumir que image apunta al fotograma anterior.

Véase también canRead().

void QImageIOHandler::setDevice(QIODevice *device)

Establece el dispositivo de QImageIOHandler en device. El gestor de imágenes utilizará este dispositivo cuando lea y escriba imágenes.

El dispositivo sólo puede establecerse una vez y debe hacerse antes de llamar a canRead(), read(), write(), etc. Si necesita leer múltiples archivos, construya múltiples instancias de la subclase QImageIOHandler apropiada.

Véase también device().

void QImageIOHandler::setFormat(const QByteArray &format)

Establece el formato de QImageIOHandler a format. El formato es más útil para los manejadores que admiten varios formatos de imagen.

Véase también format().

void QImageIOHandler::setFormat(const QByteArray &format) const

Establece el formato de QImageIOHandler a format. El formato es más útil para los manejadores que soportan múltiples formatos de imagen.

Esta función se declara const para que pueda ser llamada desde canRead().

Véase también format().

[virtual] void QImageIOHandler::setOption(QImageIOHandler::ImageOption option, const QVariant &value)

Establece la opción option con el valor value.

Véase también option() y ImageOption.

[virtual] bool QImageIOHandler::supportsOption(QImageIOHandler::ImageOption option) const

Devuelve true si QImageIOHandler admite la opción option; en caso contrario devuelve false. Por ejemplo, si QImageIOHandler admite la opción Size, supportsOption(Size) debe devolver true.

Véase también setOption() y option().

[virtual] bool QImageIOHandler::write(const QImage &image)

Escribe la imagen image en el dispositivo asignado. Devuelve true en caso de éxito; en caso contrario devuelve false.

La implementación por defecto no hace nada, y simplemente devuelve false.