Qt Quick Shapes QML Types
このモジュールの型を使用するには、次の行でモジュールをインポートしてください。
import QtQuick.ShapesQt Quick Shapesは、Qt Quick のシーン内で任意の図形を描画するためのツールを提供します。Shapes は、サブ図形を定義するlines やcurves といった基本的な構成要素から構築できます。サブ図形には単色やグラデーションで塗りつぶしを適用したり、輪郭線のストロークを定義したりすることができます。
Qt Quick Shapesは、text やSVG path descriptions といった、より高レベルのパス要素タイプもサポートしています。現在サポートされている要素タイプは、PathMove 、PathLine 、PathQuad 、PathCubic 、PathArc 、PathText 、およびPathSvg です。
Qt Quick 「Shapes」は形状を三角形分割し、対応する三角形をGPU上でレンダリングします。そのため、要素の制御点を変更すると、影響を受けるパスが再三角形分割され、それによりある程度のパフォーマンスの低下が生じます。 さらに、曲線はレンダリング前に平坦化されるため、シェイプに非常に高いスケールを適用すると、曲線が一連の小さな直線によって表現されていることが目立つようなアーティファクトが発生する可能性があります。
注:デフォルトでは 、Qt Quick のShapesはアンチエイリアシングのためにマルチサンプリングに依存しています。これは、QSurfaceFormat 内の対応する設定を使用して、アプリケーション全体またはウィンドウ全体に対して有効にできます。また、シェイプのlayer.enabled プロパティをtrueに設定し、layer.samples プロパティを調整することで、シェイプに対してのみ有効にすることも可能です。 後者の場合、マルチサンプリングはシーン全体には適用されませんが、図形は中間的なオフスクリーンバッファを介してレンダリングされます。あるいは、preferredRendererType プロパティをShape.CurveRenderer に設定することもできます。これにはアンチエイリアシング機能が組み込まれており、一般的に図形をより高品質にレンダリングしますが、パフォーマンスに多少のオーバーヘッドが生じます。
詳細については、「Shapes」サンプルでさまざまな種類の図形、塗りつぶし、ストロークの実装方法を紹介しており、「Weather Forecast」サンプルでは、ユーザーインターフェースにおいて図形がどのように活用されるかについての例を示しています。
円錐グラデーション | |
線形グラデーション | |
放射状グラデーション | |
パスの描画 | |
シェイプの塗りつぶしグラデーションの基本タイプ | |
パスおよびストロークと塗りつぶしに関連するプロパティを記述します |
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.