Shape QML Type

パスを描画します。詳細...

• 継承されたメンバーを含む全メンバーのリスト

プロパティ

• 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)

詳細説明

QPainterPath からジオメトリを三角形分割してパスをレンダリングします。

このアプローチは、QQuickPaintedItem や 2D Canvas を介して形状をレンダリングするのとは異なります。なぜなら、パスはソフトウェアでラスタライズされることがないからです。そのためShapeは、テクスチャのアップロードやフレームバッファのブライトによるパフォーマンスの低下を避け、画面の広い範囲に広がる形状を作成するのに適しています。さらに、宣言型APIでは、開始位置や終了位置、制御点などのパス要素のプロパティを操作したり、バインドしたり、アニメートしたりすることもできます。

パス要素を指定する型は、PathView と Shape で共有されています。しかし、すべての Shape 実装がすべてのパス要素タイプに対応しているわけではなく、PathView では意味をなさないものもあります。Shapeが現在サポートしているサブセットは以下の通りです：PathMove PathLine,PathQuad,PathCubic,PathArc,PathText,PathSvg です。

対応するパス要素の詳細についてはPath を参照してください。

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 }
    }
}

Item ShapePath オブジェクトは特別に扱われます。これは、 や のような視覚的アイテムや、 のような非視覚的オブジェクトを Shape の子として直接追加できるので便利です。Rectangle Image Timer

利用可能な Shape レンダリングアプローチを以下にまとめます：

• Qt Quick がデフォルトのハードウェアアクセラレーションバックエンド（RHI）で実行されている場合、汎用シェイプレンダラが使用される。これはシェイプを三角形に変換し、レンダラーに渡します。
• software バックエンドは完全にサポートされています。この場合、パスはQPainter::strokePath() とQPainter::fillPath() を介してレンダリングされます。
• OpenVG バックエンドは現在サポートされていません。

Shapeを使用する場合、潜在的なパフォーマンスへの影響に注意することが重要です：

• 一般的な三角測量ベースの Shape 実装でアプリケーションを実行する場合、ジオメトリの生成はすべて CPU で行われます。これはコストがかかる可能性があります。パス要素のセットを変更したり、これらの要素のプロパティを変更したり、Shape自体の特定のプロパティを変更したりすると、変更のたびに影響を受けるパスの再三角形化が必要になります。したがって、このようなプロパティにアニメーションを適用すると、性能の低いシステムではパフォーマンスに影響が出る可能性があります。
• しかし、Shape APIのデータ駆動型で宣言的な性質は、多くの場合、基礎となるCPUやGPUリソースのキャッシュ可能性を向上させます。ShapePath のプロパティを変更しても、影響を受けるShapePath の再処理が行われるだけで、Shape の他の部分は変更されません。そのため、頻繁に変更されるプロパティは、命令型ペインティング・アプローチ（例えば、QPainter ）に比べて、システム全体の負荷を低く抑えることができます。
• 同時に、シーン内の Shape 要素の数にも注意が必要です。このようなShapeアイテムがシーングラフで表現される方法は、通常のジオメトリベースのアイテムとは異なり、OpenGLのステート変更に関して一定のコストが発生します。
• 一般的なルールとして、シーンは、絶対に必要でない場合は、別々のShapeアイテムの使用を避けるべきです。複数の Shape アイテムよりも、複数のShapePath エレメントを持つ 1 つの Shape アイテムを使用することをお勧めします。

Qt Quick Examples - Shapes,Weather Forecast Example,Path,PathMove,PathLine,PathQuad,PathCubic,PathArc, andPathSvgも参照して ください。

プロパティ・ドキュメンテーション