Image QML Type

Diese Eigenschaften geben die Größe des Bildes an, das tatsächlich gezeichnet wird. In den meisten Fällen entspricht sie width und height, aber bei Verwendung von Image.PreserveAspectFit oder Image.PreserveAspectCrop können paintedWidth oder paintedHeight kleiner oder größer sein als width und height des Elements Bild.

Legt die horizontale und vertikale Ausrichtung des Bildes fest. Standardmäßig ist das Bild mittig ausgerichtet.

Die gültigen Werte für horizontalAlignment sind Image.AlignLeft, Image.AlignRight und Image.AlignHCenter. Die gültigen Werte für verticalAlignment sind Image.AlignTop, Image.AlignBottom und Image.AlignVCenter.

currentFrame ist der aktuell sichtbare Frame. Die Standardeinstellung ist 0. Sie können den Wert auf eine Zahl zwischen 0 und frameCount - 1 setzen, um einen anderen Rahmen anzuzeigen, wenn das Bild mehrere Rahmen enthält.

frameCount ist die Anzahl der Bilder im Bild. Die meisten Bilder haben nur ein Bild.

Gibt an, dass Bilder auf dem lokalen Dateisystem asynchron in einem separaten Thread geladen werden sollen. Der Standardwert ist false, wodurch der Thread der Benutzeroberfläche blockiert wird, während das Bild geladen wird. Die Einstellung asynchronous auf true ist nützlich, wenn die Aufrechterhaltung einer reaktionsfähigen Benutzeroberfläche wünschenswerter ist als die sofortige Sichtbarkeit von Bildern.

Beachten Sie, dass diese Eigenschaft nur für Bilder gilt, die aus dem lokalen Dateisystem gelesen werden. Bilder, die über eine Netzwerkressource (z. B. HTTP) geladen werden, werden immer asynchron geladen.

Diese Eigenschaft legt fest, ob das Bild automatisch Bildtransformations-Metadaten wie die EXIF-Ausrichtung anwenden soll.

Standardmäßig ist diese Eigenschaft auf false gesetzt.

Gibt an, ob das Bild zwischengespeichert werden soll. Der Standardwert ist true. Die Einstellung cache auf false ist nützlich, wenn es sich um große Bilder handelt, um sicherzustellen, dass diese nicht auf Kosten von kleinen "UI-Element"-Bildern zwischengespeichert werden.

Setzen Sie diese Eigenschaft, um festzulegen, was passiert, wenn das Quellbild eine andere Größe als das Element hat.

Image {
    width: 130; height: 100
    source: "qtlogo.png"
}

Image {
    width: 130; height: 100
    fillMode: Image.PreserveAspectFit
    source: "qtlogo.png"
}

Image {
    width: 130; height: 100
    fillMode: Image.PreserveAspectCrop
    source: "qtlogo.png"
    clip: true
}

Image {
    width: 120; height: 120
    fillMode: Image.Tile
    horizontalAlignment: Image.AlignLeft
    verticalAlignment: Image.AlignTop
    source: "qtlogo.png"
}

Image {
    width: 120; height: 120
    fillMode: Image.TileVertically
    verticalAlignment: Image.AlignTop
    source: "qtlogo.png"
}

Image {
    width: 120; height: 120
    fillMode: Image.TileHorizontally
    verticalAlignment: Image.AlignLeft
    source: "qtlogo.png"
}

Beachten Sie, dass clip standardmäßig false ist, was bedeutet, dass das Element möglicherweise außerhalb seines begrenzenden Rechtecks gemalt wird, selbst wenn der Füllmodus auf PreserveAspectCrop eingestellt ist.

Siehe auch Qt Quick Beispiele - Bildelemente.

Diese Eigenschaft gibt an, ob das Bild beim Skalieren oder Transformieren Mipmap-Filterung verwendet.

Die Mipmap-Filterung bietet eine bessere visuelle Qualität bei der Verkleinerung im Vergleich zur Glättung, kann aber zu Leistungseinbußen führen (sowohl beim Initialisieren des Bildes als auch beim Rendern).

Standardmäßig ist diese Eigenschaft auf false gesetzt.

Siehe auch smooth.

Diese Eigenschaft legt fest, ob das Bild horizontal invertiert werden soll (wodurch ein gespiegeltes Bild angezeigt wird).

Der Standardwert ist false.

Diese Eigenschaft legt fest, ob das Bild vertikal invertiert werden soll (d. h., ob ein gespiegeltes Bild angezeigt werden soll).

Der Standardwert ist false.

Diese Eigenschaft wurde in Qt 6.2 eingeführt.

Diese Eigenschaft zeigt den Fortschritt beim Laden des Bildes an, von 0.0 (nichts geladen) bis 1.0 (fertig).

Siehe auch status.

Diese Eigenschaft definiert das Verhalten, wenn die source Eigenschaft geändert wird und das Laden asynchron erfolgt. Dies ist der Fall, wenn die Eigenschaft asynchronous auf true gesetzt ist oder wenn sich das Bild nicht im lokalen Dateisystem befindet.

Wenn retainWhileLoading auf false gesetzt ist (Standardeinstellung), wird das alte Bild sofort verworfen und die Komponente wird gelöscht, während das neue Bild geladen wird. Wenn true eingestellt ist, wird das alte Bild beibehalten und bleibt sichtbar, bis das neue Bild fertig ist.

Die Aktivierung dieser Eigenschaft kann ein Flackern vermeiden, wenn das Laden des neuen Bildes lange dauert. Der Preis dafür ist ein gewisser zusätzlicher Speicherbedarf für die doppelte Pufferung, während das neue Bild geladen wird.

Diese Eigenschaft wurde in Qt 6.8 eingeführt.

Diese Eigenschaft legt fest, ob das Bild beim Skalieren oder Transformieren weich gefiltert wird. Glattes Filtern ergibt eine bessere visuelle Qualität, kann aber auf mancher Hardware langsamer sein. Wenn das Bild in seiner natürlichen Größe angezeigt wird, hat diese Eigenschaft keinen Einfluss auf die Darstellung oder die Leistung.

Standardmäßig ist diese Eigenschaft auf true gesetzt.

Siehe auch mipmap.

Image kann jedes von Qt unterstützte Bildformat verarbeiten, das von jedem von Qt unterstützten URL-Schema geladen wird.

Die URL kann absolut oder relativ zur URL der Komponente sein.

Siehe auch QQuickImageProvider, Compressed Texture Files, und Automatic Detection of File Extension.

Diese Eigenschaft enthält, wenn sie gesetzt ist, den rechteckigen Bereich des zu ladenden Quellbildes.

Die Eigenschaft sourceClipRect arbeitet mit der Eigenschaft sourceSize zusammen, um Systemressourcen zu schonen, wenn nur ein Teil eines Bildes geladen werden muss.

Rectangle {
    width: ...
    height: ...

    Image {
       anchors.fill: parent
       source: "reallyBigImage.svg"
       sourceSize.width: 1024
       sourceSize.height: 1024
       sourceClipRect: Qt.rect(100, 100, 512, 512)
    }
}

Im obigen Beispiel wird die SVG-Grafik zunächst konzeptionell auf 1024x1024 skaliert und dann ein Bereich von Interesse mit 512x512 Pixeln an einer Stelle 100 Pixel vom oberen und linken Rand entfernt ausgeschnitten. So bestimmt sourceSize die Skalierung, aber das tatsächliche Ausgabebild ist 512x512 Pixel groß.

Einige Bildformate sind in der Lage, CPU-Zeit zu sparen, indem sie nur den angegebenen Bereich rendern. Andere müssen zuerst das gesamte Bild laden und es dann auf den angegebenen Bereich beschneiden.

Diese Eigenschaft kann deaktiviert werden, um das gesamte Bild neu zu laden, indem sourceClipRect auf undefined gesetzt wird.

Diese Eigenschaft enthält die skalierte Breite und Höhe des Vollbildes.

Im Gegensatz zu den Eigenschaften width und height, die das Bild skalieren, legt diese Eigenschaft die maximale Anzahl von Pixeln fest, die für das geladene Bild gespeichert werden, damit große Bilder nicht mehr Speicher als nötig verbrauchen. So wird beispielsweise sichergestellt, dass das Bild im Speicher nicht größer als 1024x1024 Pixel ist, unabhängig von den Werten width und height des Bildes:

Rectangle {
    width: ...
    height: ...

    Image {
       anchors.fill: parent
       source: "reallyBigImage.jpg"
       sourceSize.width: 1024
       sourceSize.height: 1024
    }
}

Wenn die tatsächliche Größe des Bildes größer ist als die sourceSize, wird das Bild verkleinert. Wenn nur eine Dimension der Größe größer als 0 ist, wird die andere Dimension proportional gesetzt, um das Seitenverhältnis des Quellbildes zu erhalten. (Die fillMode ist davon unabhängig.)

Wenn sowohl sourceSize.width als auch sourceSize.height gesetzt sind, wird das Bild so verkleinert, dass es in die angegebene Größe passt (es sei denn, PreserveAspectCrop oder PreserveAspectFit werden verwendet, dann wird es so skaliert, dass es der optimalen Größe für das Zuschneiden/Einpassen entspricht), wobei das Seitenverhältnis des Bildes erhalten bleibt. Die tatsächliche Größe des Bildes nach der Skalierung ist über Item::implicitWidth und Item::implicitHeight verfügbar.

Handelt es sich bei der Quelle um ein intrinsisch skalierbares Bild (z. B. SVG), bestimmt diese Eigenschaft die Größe des geladenen Bildes unabhängig von der intrinsischen Größe. Vermeiden Sie es, diese Eigenschaft dynamisch zu ändern; das Rendern eines SVG ist im Vergleich zu einem Bild langsam.

Handelt es sich bei der Quelle um ein nicht skalierbares Bild (z. B. JPEG), wird das geladene Bild nicht größer sein, als diese Eigenschaft angibt. Bei einigen Formaten (derzeit nur JPEG) wird nie das gesamte Bild in den Speicher geladen.

Wenn die Eigenschaft sourceClipRect ebenfalls gesetzt ist, bestimmt sourceSize die Skalierung, aber das Bild wird auf die Größe des Clip-Rechtecks beschnitten.

sourceSize kann auf die natürliche Größe des Bildes zurückgesetzt werden, indem sourceSize auf undefined gesetzt wird.

Siehe auch Qt Quick Beispiele - Pointer Handler.

Diese Eigenschaft enthält den Status des Bildladens. Sie kann eine der folgenden sein:

Verwenden Sie diesen Status, um eine Aktualisierung vorzunehmen oder auf die Statusänderung in irgendeiner Weise zu reagieren. Zum Beispiel könnten Sie:

• Eine Statusänderung auslösen:

  State { name: 'loaded'; when: image.status == Image.Ready }

• Implementieren Sie einen onStatusChanged Signalhandler:

  Image {
      id: image
      onStatusChanged: if (image.status == Image.Ready) console.log('Loaded')
  }

• Bindung an den Statuswert:

  Text { text: image.status == Image.Ready ? 'Loaded' : 'Not loaded' }

Siehe auch progress.