QImageIOHandler Class

Dokumentation der Mitgliedsfunktionen

QImageIOHandler::QImageIOHandler()

Konstruiert ein QImageIOHandler-Objekt.

[virtual noexcept] QImageIOHandler::~QImageIOHandler()

Zerstört das Objekt QImageIOHandler.

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

Dies ist eine Komfortmethode für die Lesefunktion in Unterklassen. Bildformat-Handler müssen das Laden eines Bildes ablehnen, wenn die erforderliche Zuweisung die aktuelle Zuweisungsgrenze überschreiten würde. Diese Funktion prüft die Parameter und das Limit und führt die Zuweisung durch, wenn sie gültig und erforderlich ist. Bei erfolgreicher Rückkehr wird image ein gültiges, abgetrenntes QImage der angegebenen size und format sein.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch QImageReader::allocationLimit().

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

Gibt true zurück, wenn ein Bild vom Gerät gelesen werden kann (d. h., das Bildformat wird unterstützt, das Gerät kann gelesen werden und die anfänglichen Header-Informationen legen nahe, dass das Bild gelesen werden kann); andernfalls wird false zurückgegeben.

Stellen Sie bei der Neuimplementierung von canRead() sicher, dass das E/A-Gerät (device()) in seinem ursprünglichen Zustand belassen wird (z. B. durch Verwendung von peek() anstelle von read()).

Siehe auch read() und QIODevice::peek().

[virtual] int QImageIOHandler::currentImageNumber() const

Bei Bildformaten, die Animation unterstützen, gibt diese Funktion die Sequenznummer des aktuellen Bildes in der Animation zurück. Wenn diese Funktion aufgerufen wird, bevor ein Bild read() ist, wird -1 zurückgegeben. Die Nummer des ersten Bildes in der Sequenz ist 0.

Wenn das Bildformat keine Animation unterstützt, wird 0 zurückgegeben.

Siehe auch read().

[virtual] QRect QImageIOHandler::currentImageRect() const

Gibt das Rect des aktuellen Bildes zurück. Wenn kein Rect für das Bild definiert ist, wird ein leeres QRect() zurückgegeben.

Diese Funktion ist nützlich für Animationen, bei denen jeweils nur Teile des Bildes aktualisiert werden können.

QIODevice *QImageIOHandler::device() const

Gibt das Gerät zurück, das derzeit dem QImageIOHandler zugewiesen ist. Wenn kein Gerät zugewiesen wurde, wird nullptr zurückgegeben.

Siehe auch setDevice().

QByteArray QImageIOHandler::format() const

Gibt das Format zurück, das derzeit QImageIOHandler zugewiesen ist. Wurde kein Format zugewiesen, wird eine leere Zeichenkette zurückgegeben.

Siehe auch setFormat().

[virtual] int QImageIOHandler::imageCount() const

Bei Bildformaten, die Animation unterstützen, gibt diese Funktion die Anzahl der Bilder in der Animation zurück. Wenn das Bildformat keine Animation unterstützt oder wenn es nicht in der Lage ist, die Anzahl der Bilder zu bestimmen, wird 0 zurückgegeben.

Die Standardimplementierung gibt 1 zurück, wenn canRead() true zurückgibt; andernfalls wird 0 zurückgegeben.

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

Bei Bildformaten, die Animation unterstützen, springt diese Funktion zu dem Bild, dessen Sequenznummer imageNumber lautet. Beim nächsten Aufruf von read() wird versucht, dieses Bild zu lesen.

Die Standardimplementierung tut nichts und gibt false zurück.

[virtual] bool QImageIOHandler::jumpToNextImage()

Bei Bildformaten, die Animation unterstützen, springt diese Funktion zum nächsten Bild.

Die Standardimplementierung tut nichts und gibt false zurück.

[virtual] int QImageIOHandler::loopCount() const

Bei Bildformaten, die Animation unterstützen, gibt diese Funktion die Anzahl der Schleifen zurück, die die Animation durchlaufen soll. Unterstützt das Bildformat keine Animation, wird 0 zurückgegeben.

[virtual] int QImageIOHandler::nextImageDelay() const

Bei Bildformaten, die Animation unterstützen, gibt diese Funktion die Anzahl der Millisekunden zurück, die bis zum Lesen des nächsten Bildes gewartet werden muss. Wenn das Bildformat keine Animation unterstützt, wird 0 zurückgegeben.

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

Gibt den option zugewiesenen Wert als QVariant zurück. Der Typ des Wertes hängt von der Option ab. Zum Beispiel gibt option(Größe) eine QSize Variante zurück.

Siehe auch setOption() und supportsOption().

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

Liest ein Bild aus dem Gerät und speichert es in image. Gibt true zurück, wenn das Bild erfolgreich gelesen wurde; andernfalls wird false zurückgegeben.

Bei Bildformaten, die inkrementelles Laden unterstützen, und bei Animationsformaten kann der Image-Handler davon ausgehen, dass image auf das vorherige Bild zeigt.

Siehe auch canRead().

void QImageIOHandler::setDevice(QIODevice *device)

Setzt das Gerät von QImageIOHandler auf device. Der Image-Handler wird dieses Gerät beim Lesen und Schreiben von Bildern verwenden.

Das Gerät kann nur einmal gesetzt werden und muss vor dem Aufruf von canRead(), read(), write(), usw. gesetzt werden. Wenn Sie mehrere Dateien lesen müssen, erstellen Sie mehrere Instanzen der entsprechenden QImageIOHandler Unterklasse.

Siehe auch device().

void QImageIOHandler::setFormat(const QByteArray &format)

Setzt das Format von QImageIOHandler auf format. Das Format ist besonders nützlich für Handler, die mehrere Bildformate unterstützen.

Siehe auch format().

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

Setzt das Format von QImageIOHandler auf format. Das Format ist besonders nützlich für Handler, die mehrere Bildformate unterstützen.

Diese Funktion ist als const deklariert, damit sie von canRead() aufgerufen werden kann.

Siehe auch format().

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

Setzt die Option option auf den Wert value.

Siehe auch option() und ImageOption.

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

Gibt true zurück, wenn QImageIOHandler die Option option unterstützt; andernfalls gibt es false zurück. Wenn zum Beispiel QImageIOHandler die Option Size unterstützt, muss supportsOption(Size) true zurückgeben.

Siehe auch setOption() und option().

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

Schreibt das Bild image auf das zugewiesene Gerät. Gibt bei Erfolg true zurück, andernfalls false.

Die Standardimplementierung tut nichts und gibt einfach false zurück.