BorderImageMesh QML Type

Definiert ein Netz, dessen Eckpunkte wie bei einem „ BorderImage “ angeordnet sind. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• border
  • border.bottom : int
  • border.left : int
  • border.right : int
  • border.top : int
• horizontalTileMode : enumeration
• size : size
• verticalTileMode : enumeration

Ausführliche Beschreibung

BorderImageMesh bietet Funktionen ähnlich wie bei „ BorderImage “ für eine „ ShaderEffect “, ohne dass ein potenziell kostspieliges „ ShaderEffectSource “ erforderlich ist.

Die folgenden Funktionen sind funktional gleichwertig:

BorderImage {
    id: borderImage
    border {
        left: 10
        right: 10
        top: 10
        bottom: 10
    }
    source: "myImage.png"
    visible: false
}
ShaderEffectSource {
    id: effectSource
    sourceItem: borderImage
    visible: false
}
ShaderEffect {
    property var source: effectSource
    ...
}

Image {
    id: image
    source: "myImage.png"
    visible: false
}
ShaderEffect {
    property var source: image
    mesh: BorderImageMesh {
        border {
            left: 10
            right: 10
            top: 10
            bottom: 10
        }
        size: image.sourceSize
    }
    ...
}

Die BorderImageMesh-Version lässt sich jedoch in der Regel besser optimieren.

Dokumentation der Eigenschaften

border group

Die 4 Randlinien (2 horizontale und 2 vertikale) unterteilen das Bild in 9 Abschnitte, wie unten dargestellt:

Jede Begrenzungslinie (links, rechts, oben und unten) gibt einen Versatz in Pixeln vom jeweiligen Rand des Gitters an. Standardmäßig hat jede Begrenzungslinie den Wert 0.

Die folgende Definition legt beispielsweise fest, dass die untere Linie 10 Pixel vom unteren Rand des Gitters entfernt verläuft:

BorderImageMesh {
    border.bottom: 10
    // ...
}

Diese Eigenschaft legt fest, wie die mittleren Bereiche eines Bildes wiederholt oder gestreckt werden sollen.

• BorderImage.Stretch – Skaliert das Bild so, dass es in den verfügbaren Bereich passt.
• BorderImage.Wiederholen – Das Bild wird so lange gekachelt, bis kein Platz mehr vorhanden ist. Das letzte Bild wird möglicherweise beschnitten.
• BorderImage.Round – Wie „Repeat“, skaliert die Bilder jedoch nach unten, um sicherzustellen, dass das letzte Bild nicht beschnitten wird.

Der Standard-Kachelmodus für jede Eigenschaft ist „ BorderImage.Stretch“.

size : size

Die Grundgröße des Rasters. Diese entspricht in der Regel der Bild sourceSize, die von der Funktion „ ShaderEffect “ verwendet wird.