Shape QML Type

Rendert einen Pfad. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• asynchronous : bool
• boundingRect : rect (since 6.6)
• containsMode : enumeration (since QtQuick.Shapes 1.11)
• data : list<Object>
• fillMode : enumeration (since QtQuick.Shapes 6.7)
• horizontalAlignment : enumeration (since 6.7)
• preferredRendererType : enumeration (since 6.6)
• rendererType : enumeration
• status : enumeration
• vendorExtensionsEnabled : bool
• verticalAlignment : enumeration (since 6.7)

Detaillierte Beschreibung

Rendert einen Pfad durch Triangulierung von Geometrie aus einem QPainterPath.

Dieser Ansatz unterscheidet sich vom Rendern von Formen über QQuickPaintedItem oder den 2D-Canvas, da der Pfad in der Software nie gerastert wird. Daher eignet sich Shape für die Erstellung von Formen, die sich über größere Bereiche des Bildschirms erstrecken, wodurch Leistungseinbußen bei Textur-Uploads oder Framebuffer-Blits vermieden werden. Darüber hinaus ermöglicht die deklarative API die Manipulation, Bindung und sogar Animation der Pfadelement-Eigenschaften wie Start- und Endposition, die Kontrollpunkte usw.

Die Typen zur Angabe von Pfadelementen werden von PathView und Shape gemeinsam genutzt. Allerdings unterstützen nicht alle Shape-Implementierungen alle Pfadelementtypen, während einige für PathView möglicherweise nicht sinnvoll sind. Die derzeit von Shape unterstützte Teilmenge ist: PathMove, PathLine, PathQuad, PathCubic, PathArc, PathText und PathSvg.

Unter Path finden Sie eine detaillierte Übersicht über die unterstützten Pfadelemente.

Shape {
    width: 200
    height: 150
    anchors.centerIn: parent
    ShapePath {
        strokeWidth: 4
        strokeColor: "red"
        fillGradient: LinearGradient {
            x1: 20; y1: 20
            x2: 180; y2: 130
            GradientStop { position: 0; color: "blue" }
            GradientStop { position: 0.2; color: "green" }
            GradientStop { position: 0.4; color: "red" }
            GradientStop { position: 0.6; color: "yellow" }
            GradientStop { position: 1; color: "cyan" }
        }
        strokeStyle: ShapePath.DashLine
        dashPattern: [ 1, 4 ]
        startX: 20; startY: 20
        PathLine { x: 180; y: 130 }
        PathLine { x: 20; y: 130 }
        PathLine { x: 20; y: 20 }
    }
}

Wie Item erlaubt auch Shape die Deklaration beliebiger visueller oder nicht-visueller Objekte als Kinder. ShapePath Objekte werden besonders behandelt. Dies ist nützlich, da es das Hinzufügen von visuellen Elementen, wie Rectangle oder Image, und nicht-visuellen Objekten, wie Timer, direkt als Kinder von Shape ermöglicht.

Die folgende Liste fasst die verfügbaren Rendering-Ansätze von Shape zusammen:

• Wenn Qt Quick mit dem standardmäßigen, hardwarebeschleunigten Backend (RHI) ausgeführt wird, wird der generische Shape-Renderer verwendet. Dieser wandelt die Formen in Dreiecke um, die an den Renderer übergeben werden.
• Das software Backend wird vollständig unterstützt. Der Pfad wird in diesem Fall über QPainter::strokePath() und QPainter::fillPath() gerendert.
• Das OpenVG-Backend wird derzeit nicht unterstützt.

Bei der Verwendung von Shape ist es wichtig, sich über mögliche Auswirkungen auf die Leistung im Klaren zu sein:

• Wenn die Anwendung mit der generischen, auf Triangulation basierenden Shape-Implementierung ausgeführt wird, erfolgt die Geometrieerzeugung vollständig auf der CPU. Dies ist potenziell teuer. Das Ändern des Satzes von Pfadelementen, das Ändern der Eigenschaften dieser Elemente oder das Ändern bestimmter Eigenschaften des Shapes selbst führt bei jeder Änderung zu einer erneuten Triangulation der betroffenen Pfade. Daher kann die Anwendung der Animation auf solche Eigenschaften die Leistung auf weniger leistungsfähigen Systemen beeinträchtigen.
• Die datengesteuerte, deklarative Natur der Shape-API bedeutet jedoch oft eine bessere Cachefähigkeit für die zugrunde liegenden CPU- und GPU-Ressourcen. Eine Eigenschaftsänderung in einem ShapePath führt nur zu einer erneuten Verarbeitung der betroffenen ShapePath, wobei andere Teile des Shapes unverändert bleiben. Daher kann eine sich häufig ändernde Eigenschaft immer noch zu einer geringeren Gesamtsystemlast führen als bei imperativen Malansätzen (z. B. QPainter).
• Gleichzeitig muss auf die Anzahl der Shape-Elemente in der Szene geachtet werden. Die Art und Weise, wie ein solches Shape-Element im Szenegraphen dargestellt wird, unterscheidet sich von einem gewöhnlichen geometriebasierten Element und verursacht gewisse Kosten, wenn es um OpenGL-Zustandsänderungen geht.
• Generell sollten Szenen keine separaten Shape-Elemente verwenden, wenn dies nicht unbedingt notwendig ist. Verwenden Sie lieber ein Shape-Element mit mehreren ShapePath Elementen als mehrere Shape-Elemente.

Siehe auch Qt Quick Beispiele - Shapes, Wettervorhersage Beispiel, Path, PathMove, PathLine, PathQuad, PathCubic, PathArc und PathSvg.

Dokumentation der Eigenschaft