QImageIOHandler Class

Dokumentation der Mitgliedsfunktionen

QImageIOHandler::QImageIOHandler()

Erstellt ein QImageIOHandler-Objekt.

[virtual noexcept] QImageIOHandler::~QImageIOHandler()

Löst das Objekt „ QImageIOHandler “ auf.

[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 Speicherzuweisung das aktuelle Zuweisungslimit überschreiten würde. Diese Funktion überprüft die Parameter und das Limit und führt die Speicherzuweisung durch, sofern diese gültig und erforderlich ist. Bei erfolgreicher Rückgabe ist ` image ` ein gültiges, losgelöstes ` QImage ` der angegebenen ` size ` und ` format`.

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 ist lesbar und die anfänglichen Header-Informationen deuten darauf hin, dass das Bild gelesen werden kann); andernfalls wird ` false` zurückgegeben.

Achten Sie bei der Neuimplementierung von `canRead()` darauf, 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 Animationen unterstützen, gibt diese Funktion die Sequenznummer des aktuellen Bildes in der Animation zurück. Wird diese Funktion aufgerufen, bevor ein Bild mit ` read()` geladen wurde, wird -1 zurückgegeben. Die Nummer des ersten Bildes in der Sequenz ist 0.

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

Siehe auch ` read()`.

[virtual] QRect QImageIOHandler::currentImageRect() const

Gibt den Bildausschnitt des aktuellen Bildes zurück. Ist für das Bild kein Bildausschnitt definiert, 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. Wenn kein Format zugewiesen wurde, wird eine leere Zeichenkette zurückgegeben.

Siehe auch „ setFormat()“.

[virtual] int QImageIOHandler::imageCount() const

Bei Bildformaten, die Animationen unterstützen, gibt diese Funktion die Anzahl der Bilder in der Animation zurück. Wenn das Bildformat keine Animationen unterstützt oder die Anzahl der Bilder nicht ermittelt werden kann, wird 0 zurückgegeben.

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

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

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

Die Standardimplementierung führt keine Aktion aus und gibt false zurück.

[virtual] bool QImageIOHandler::jumpToNextImage()

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

Die Standardimplementierung führt keine Aktion aus und gibt „ false “ zurück.

[virtual] int QImageIOHandler::loopCount() const

Bei Bildformaten, die Animationen unterstützen, gibt diese Funktion die Anzahl der Wiederholungen der Animation zurück. Wenn das Bildformat keine Animationen unterstützt, wird 0 zurückgegeben.

[virtual] int QImageIOHandler::nextImageDelay() const

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

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

Gibt den Wert zurück, der „ option “ zugewiesen wurde, als „ QVariant “. Der Typ des Werts hängt von der Option ab. Beispielsweise gibt „option(Size)“ eine „ QSize “-Variante zurück.

Siehe auch „ setOption()“ und „ supportsOption()“.

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

Liest ein Bild vom Gerät ein und speichert es unter image. Gibt true zurück, wenn das Bild erfolgreich eingelesen wurde; andernfalls wird false zurückgegeben.

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

Siehe auch ` canRead()`.

void QImageIOHandler::setDevice(QIODevice *device)

Legt das Gerät des „ QImageIOHandler “ auf „ device “ fest. Der Bild-Handler verwendet dieses Gerät beim Lesen und Schreiben von Bildern.

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

Siehe auch device().

void QImageIOHandler::setFormat(const QByteArray &format)

Legt das Format von „ QImageIOHandler “ auf „ format “ fest. Dieses Format eignet sich besonders für Handler, die mehrere Bildformate unterstützen.

Siehe auch format().

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

Legt das Format von ` QImageIOHandler ` auf ` format` fest. Dieses 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 die Option „ QImageIOHandler “ die Option „ option “ unterstützt; andernfalls wird „ false “ zurückgegeben. Wenn beispielsweise die Option „ QImageIOHandler “ die Option „ Size “ unterstützt, muss „supportsOption(Size)“ den Wert „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 wird „ false “ zurückgegeben.

Die Standardimplementierung führt keine Aktion aus und gibt einfach „ false “ zurück.