qquickshape.cpp

Go to the documentation of this file.

// Copyright (C) 2016 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only
// Qt-Security score:significant reason:default
 
#include "qquickshape_p.h"
#include "qquickshape_p_p.h"
#include "qquickshapegenericrenderer_p.h"
#include "qquickshapesoftwarerenderer_p.h"
#include "qquickshapecurverenderer_p.h"
#include <private/qsgcurvestrokenode_p.h>
#include <private/qsgplaintexture_p.h>
#include <QtGui/private/qdrawhelper_p.h>
#include <QOpenGLFunctions>
#include <QLoggingCategory>
#include <rhi/qrhi.h>
 
static void initResources()
{
#if defined(QT_STATIC)
    Q_INIT_RESOURCE(qtquickshapes_shaders);
#endif
}
 
QT_BEGIN_NAMESPACE
 
Q_STATIC_LOGGING_CATEGORY(QQSHAPE_LOG_TIME_DIRTY_SYNC, "qt.shape.time.sync")
Q_STATIC_LOGGING_CATEGORY(lcShapeSync, "qt.quick.shapes.shape.sync")
 
/*!
    \keyword Qt Quick Shapes
    \qmlmodule QtQuick.Shapes 1.\QtMinorVersion
    \title Qt Quick Shapes QML Types
    \ingroup qmlmodules
    \brief Provides QML types for drawing stroked and filled shapes.
 
    To use the types in this module, import the module with the following line:
 
    \qml
    import QtQuick.Shapes
    \endqml
 
    Qt Quick Shapes provides tools for drawing arbitrary shapes in a Qt Quick scene.
    \l{Shape}{Shapes} can be constructed from basic building blocks like \l{PathLine}{lines} and
    \l{PathCubic}{curves} that define sub-shapes. The sub-shapes can then be filled with solid
    colors or gradients, and an outline stroke can be defined.
 
    Qt Quick Shapes also supports higher level path element types, such as \l{PathText}{text} and
    \l{PathSvg}{SVG path descriptions}. The currently supported element types is: PathMove,
    PathLine, PathQuad, PathCubic, PathArc, PathText and PathSvg.
 
    Qt Quick Shapes triangulates the shapes and renders the corresponding triangles on the GPU.
    Therefore, altering the control points of elements will lead to re-triangulation of the
    affected paths, at some performance cost. In addition, curves are flattened before they are
    rendered, so applying a very high scale to the shape may show artifacts where it is visible
    that the curves are represented by a sequence of smaller, straight lines.
 
    \note By default, Qt Quick Shapes relies on multi-sampling for anti-aliasing. This can be
    enabled for the entire application or window using the corresponding settings in QSurfaceFormat.
    It can also be enabled for only the shape, by setting its \l{Item::}{layer.enabled}
    property to true and then adjusting the \l{Item::}{layer.samples} property. In the
    latter case, multi-sampling will not be applied to the entire scene, but the shape will be
    rendered via an intermediate off-screen buffer. Alternatively, the
    \l{QtQuick.Shapes.Shape::}{preferredRendererType} property can be set
    to \c{Shape.CurveRenderer}. This has anti-aliasing built in and generally renders the shapes
    at a higher quality, but at some additional performance cost.
 
    For further information, the \l{Qt Quick Examples - Shapes}{Shapes example} shows how to
    implement different types of shapes, fills and strokes, and the \l{Weather Forecast Example}
    shows examples of different ways shapes might be useful in a user interface.
*/
 
void QQuickShapes_initializeModule()
{
    QQuickShapesModule::defineModule();
}
 
Q_CONSTRUCTOR_FUNCTION(QQuickShapes_initializeModule)
 
void QQuickShapesModule::defineModule()
{
    initResources();
}
 
QQuickShapeStrokeFillParams::QQuickShapeStrokeFillParams()
    : strokeColor(Qt::white),
      strokeWidth(1),
      fillColor(Qt::white),
      fillRule(QQuickShapePath::OddEvenFill),
      joinStyle(QQuickShapePath::BevelJoin),
      miterLimit(2),
      capStyle(QQuickShapePath::SquareCap),
      strokeStyle(QQuickShapePath::SolidLine),
      dashOffset(0),
      fillGradient(nullptr),
      strokeGradient(nullptr),
      fillItem(nullptr),
      trim(nullptr)
{
    dashPattern << 4 << 2; // 4 * strokeWidth dash followed by 2 * strokeWidth space
}
 
/*!
    \qmltype ShapePath
    //! \nativetype QQuickShapePath
    \inqmlmodule QtQuick.Shapes
    \ingroup qtquick-paths
    \ingroup qtquick-views
    \inherits Path
    \brief Describes a Path and associated properties for stroking and filling.
    \since 5.10
 
    A \l Shape contains one or more ShapePath elements. At least one ShapePath is
    necessary in order to have a Shape output anything visible. A ShapePath
    itself is a \l Path with additional properties describing the stroking and
    filling parameters, such as the stroke width and color, the fill color or
    gradient, join and cap styles, and so on. As with ordinary \l Path objects,
    ShapePath also contains a list of path elements like \l PathMove, \l PathLine,
    \l PathCubic, \l PathQuad, \l PathArc, together with a starting position.
 
    Any property changes in these data sets will be bubble up and change the
    output of the Shape. This means that it is simple and easy to change, or
    even animate, the starting and ending position, control points, or any
    stroke or fill parameters using the usual QML bindings and animation types
    like NumberAnimation.
 
    In the following example the line join style changes automatically based on
    the value of joinStyleIndex:
 
    \qml
    ShapePath {
        strokeColor: "black"
        strokeWidth: 16
        fillColor: "transparent"
        capStyle: ShapePath.RoundCap
 
        property int joinStyleIndex: 0
 
        property variant styles: [
            ShapePath.BevelJoin,
            ShapePath.MiterJoin,
            ShapePath.RoundJoin
        ]
 
        joinStyle: styles[joinStyleIndex]
 
        startX: 30
        startY: 30
        PathLine { x: 100; y: 100 }
        PathLine { x: 30; y: 100 }
    }
    \endqml
 
    Once associated with a Shape, here is the output with a joinStyleIndex
    of 2 (ShapePath.RoundJoin):
 
    \image visualpath-code-example.png {Black angled line with rounded corner}
 
    \sa {Qt Quick Examples - Shapes}, {Weather Forecast Example}, Shape
 */
 
QQuickShapePathPrivate::QQuickShapePathPrivate()
    : dirty(DirtyAll)
{
    // Set this QQuickPath to be a ShapePath
    isShapePath = true;
}
 
QQuickShapePath::QQuickShapePath(QObject *parent)
    : QQuickPath(*(new QQuickShapePathPrivate), parent)
{
    // The inherited changed() and the shapePathChanged() signals remain
    // distinct, and this is intentional. Combining the two is not possible due
    // to the difference in semantics and the need to act (see dirty flag
    // below) differently on QQuickPath-related changes.
 
    connect(this, &QQuickPath::changed, this, [this]() {
        Q_D(QQuickShapePath);
        d->dirty |= QQuickShapePathPrivate::DirtyPath;
        emit shapePathChanged();
    });
}
 
QQuickShapePath::~QQuickShapePath()
{
}
 
/*!
    \qmlproperty color QtQuick.Shapes::ShapePath::strokeColor
 
    This property holds the stroking color.
 
    When set to \c transparent, no stroking occurs. If the \l{strokeGradient} property is set,
    it will take precedence over \c{strokeColor}.
 
    The default value is \c white.
 */
 
QColor QQuickShapePath::strokeColor() const
{
    Q_D(const QQuickShapePath);
    return d->sfp.strokeColor;
}
 
void QQuickShapePath::setStrokeColor(const QColor &color)
{
    Q_D(QQuickShapePath);
    if (d->sfp.strokeColor != color) {
        d->sfp.strokeColor = color;
        d->dirty |= QQuickShapePathPrivate::DirtyStrokeColor;
        emit strokeColorChanged();
        emit shapePathChanged();
    }
}
 
/*!
    \qmlproperty real QtQuick.Shapes::ShapePath::strokeWidth
 
    This property holds the stroke width.
 
    When set to a negative value, no stroking occurs.
 
    The default value is 1.
 
    \sa cosmeticStroke
 */
 
qreal QQuickShapePath::strokeWidth() const
{
    Q_D(const QQuickShapePath);
    return d->sfp.strokeWidth;
}
 
void QQuickShapePath::setStrokeWidth(qreal w)
{
    Q_D(QQuickShapePath);
    if (d->sfp.strokeWidth != w) {
        d->sfp.strokeWidth = w;
        d->dirty |= QQuickShapePathPrivate::DirtyStrokeWidth;
        emit strokeWidthChanged();
        emit shapePathChanged();
    }
}
 
/*! \since 6.11
    \qmlproperty bool QtQuick.Shapes::ShapePath::cosmeticStroke
 
    This property holds whether the stroke width remains constant despite rendering scale.
 
    When this property is set to \c true, the outline of the shape
    is drawn with constant width in \l {High DPI}{device-independent pixels},
    as specified by \l strokeWidth, regardless of any transformations applied
    to the shape, such as \l QtQuick::Item::scale.
 
    The default value is \c false.
 
    \sa strokeWidth
*/
bool QQuickShapePath::cosmeticStroke() const
{
    Q_D(const QQuickShapePath);
    return d->sfp.cosmeticStroke;
}
 
void QQuickShapePath::setCosmeticStroke(bool c)
{
    Q_D(QQuickShapePath);
    if (d->sfp.cosmeticStroke != c) {
        d->sfp.cosmeticStroke = c;
        d->dirty |= QQuickShapePathPrivate::DirtyStrokeWidth;
        emit cosmeticStrokeChanged();
        emit shapePathChanged();
    }
}
 
/*!
    \qmlproperty bool QtQuick.Shapes::ShapePath::visible
    \since 6.13
 
    This property holds whether the ShapePath is visible.
 
    When set to \c false, neither the fill nor the stroke of this ShapePath is
    rendered, and the ShapePath is ignored by \l {QQuickItem::contains()}{contains()}.
    The ShapePath remains part of the \l Shape and keeps its position in the paint
    order, so it is drawn at the same depth when made visible again, without having
    to be re-created.
 
    In contrast to a transparent ShapePath, a hidden ShapePath does not contribute
    to \l {Shape::boundingRect}{Shape.boundingRect}, or to the implicit size of the
    Shape. This means that changing the visibility of a ShapePath may cause the
    Shape to change scale or position if a non-default fill mode or alignment is set.
 
    The default value is \c true.
*/
bool QQuickShapePath::isVisible() const
{
    Q_D(const QQuickShapePath);
    return d->sfp.visible;
}
 
void QQuickShapePath::setVisible(bool visible)
{
    Q_D(QQuickShapePath);
    if (d->sfp.visible != visible) {
        d->sfp.visible = visible;
        d->dirty |= QQuickShapePathPrivate::DirtyVisible;
        emit visibleChanged();
        emit shapePathChanged();
    }
}
 
/*!
    \qmlproperty color QtQuick.Shapes::ShapePath::fillColor
 
    This property holds the fill color.
 
    When set to \c transparent, no filling occurs.
 
    The default value is \c white.
 
    \note If either \l fillGradient or \l fillItem are set to something other than \c null, these
    will take precedence over \c fillColor. The \c fillColor will be ignored in this case.
 */
 
QColor QQuickShapePath::fillColor() const
{
    Q_D(const QQuickShapePath);
    return d->sfp.fillColor;
}
 
void QQuickShapePath::setFillColor(const QColor &color)
{
    Q_D(QQuickShapePath);
    if (d->sfp.fillColor != color) {
        d->sfp.fillColor = color;
        d->dirty |= QQuickShapePathPrivate::DirtyFillColor;
        emit fillColorChanged();
        emit shapePathChanged();
    }
}
 
/*!
    \include shapepath.qdocinc {fillRule-property} {QtQuick.Shapes::ShapePath}
*/
 
QQuickShapePath::FillRule QQuickShapePath::fillRule() const
{
    Q_D(const QQuickShapePath);
    return d->sfp.fillRule;
}
 
void QQuickShapePath::setFillRule(FillRule fillRule)
{
    Q_D(QQuickShapePath);
    if (d->sfp.fillRule != fillRule) {
        d->sfp.fillRule = fillRule;
        d->dirty |= QQuickShapePathPrivate::DirtyFillRule;
        emit fillRuleChanged();
        emit shapePathChanged();
    }
}
 
/*!
    \include shapepath.qdocinc {joinStyle-property} {QtQuick.Shapes::ShapePath}
*/
 
QQuickShapePath::JoinStyle QQuickShapePath::joinStyle() const
{
    Q_D(const QQuickShapePath);
    return d->sfp.joinStyle;
}
 
void QQuickShapePath::setJoinStyle(JoinStyle style)
{
    Q_D(QQuickShapePath);
    if (d->sfp.joinStyle != style) {
        d->sfp.joinStyle = style;
        d->dirty |= QQuickShapePathPrivate::DirtyStyle;
        emit joinStyleChanged();
        emit shapePathChanged();
    }
}
 
/*!
    \qmlproperty int QtQuick.Shapes::ShapePath::miterLimit
 
    When joinStyle is set to \c ShapePath.MiterJoin, this property
    specifies how far the miter join can extend from the join point.
 
    The default value is 2.
 */
 
int QQuickShapePath::miterLimit() const
{
    Q_D(const QQuickShapePath);
    return d->sfp.miterLimit;
}
 
void QQuickShapePath::setMiterLimit(int limit)
{
    Q_D(QQuickShapePath);
    if (d->sfp.miterLimit != limit) {
        d->sfp.miterLimit = limit;
        d->dirty |= QQuickShapePathPrivate::DirtyStyle;
        emit miterLimitChanged();
        emit shapePathChanged();
    }
}
 
/*!
    \include shapepath.qdocinc {capStyle-property} {QtQuick.Shapes::ShapePath}
*/
 
QQuickShapePath::CapStyle QQuickShapePath::capStyle() const
{
    Q_D(const QQuickShapePath);
    return d->sfp.capStyle;
}
 
void QQuickShapePath::setCapStyle(CapStyle style)
{
    Q_D(QQuickShapePath);
    if (d->sfp.capStyle != style) {
        d->sfp.capStyle = style;
        d->dirty |= QQuickShapePathPrivate::DirtyStyle;
        emit capStyleChanged();
        emit shapePathChanged();
    }
}
 
/*!
    \include shapepath.qdocinc {strokeStyle-property} {QtQuick.Shapes::ShapePath}
*/
 
QQuickShapePath::StrokeStyle QQuickShapePath::strokeStyle() const
{
    Q_D(const QQuickShapePath);
    return d->sfp.strokeStyle;
}
 
void QQuickShapePath::setStrokeStyle(StrokeStyle style)
{
    Q_D(QQuickShapePath);
    if (d->sfp.strokeStyle != style) {
        d->sfp.strokeStyle = style;
        d->dirty |= QQuickShapePathPrivate::DirtyDash;
        emit strokeStyleChanged();
        emit shapePathChanged();
    }
}
 
/*!
    \include shapepath.qdocinc {dashOffset-property} {QtQuick.Shapes::ShapePath}
*/
 
qreal QQuickShapePath::dashOffset() const
{
    Q_D(const QQuickShapePath);
    return d->sfp.dashOffset;
}
 
void QQuickShapePath::setDashOffset(qreal offset)
{
    Q_D(QQuickShapePath);
    if (d->sfp.dashOffset != offset) {
        d->sfp.dashOffset = offset;
        d->dirty |= QQuickShapePathPrivate::DirtyDash;
        emit dashOffsetChanged();
        emit shapePathChanged();
    }
}
 
/*!
    \include shapepath.qdocinc {dashPattern-property} {QtQuick.Shapes::ShapePath}
*/
 
QList<qreal> QQuickShapePath::dashPattern() const
{
    Q_D(const QQuickShapePath);
    return d->sfp.dashPattern;
}
 
void QQuickShapePath::setDashPattern(const QList<qreal> &array)
{
    Q_D(QQuickShapePath);
    if (d->sfp.dashPattern != array) {
        d->sfp.dashPattern = array;
        d->dirty |= QQuickShapePathPrivate::DirtyDash;
        emit dashPatternChanged();
        emit shapePathChanged();
    }
}
 
/*!
    \qmlproperty ShapeGradient QtQuick.Shapes::ShapePath::strokeGradient
    \since 6.12
 
    This property defines the stroke gradient. By default no gradient is enabled
    and the value is \c null. In this case the stroke will be based \l{strokeColor} property.
 
    \note The Gradient type cannot be used here. Rather, prefer using one of
    the advanced subtypes, like LinearGradient.
 
    \note If set to something other than \c{null}, the \c strokeGradient will take precedence over
    \l strokeColor.
 
    By default, up to 256 different gradients may be displayed simultaneously. This limit may be
    customized with the \c QT_QUICKSHAPES_MAX_GRADIENTS environment variable.
 */
QQuickShapeGradient *QQuickShapePath::strokeGradient() const
{
    Q_D(const QQuickShapePath);
    return d->sfp.strokeGradient;
}
 
void QQuickShapePath::setStrokeGradient(QQuickShapeGradient *gradient)
{
    Q_D(QQuickShapePath);
    if (d->sfp.strokeGradient != gradient) {
        if (d->sfp.strokeGradient)
            qmlobject_disconnect(d->sfp.strokeGradient, QQuickShapeGradient, SIGNAL(updated()),
                                 this, QQuickShapePath, SLOT(_q_strokeGradientChanged()));
        d->sfp.strokeGradient = gradient;
        if (d->sfp.strokeGradient)
            qmlobject_connect(d->sfp.strokeGradient, QQuickShapeGradient, SIGNAL(updated()),
                              this, QQuickShapePath, SLOT(_q_strokeGradientChanged()));
        emit strokeGradientChanged();
        d->dirty |= QQuickShapePathPrivate::DirtyStrokeGradient;
        emit shapePathChanged();
    }
}
 
void QQuickShapePath::resetStrokeGradient()
{
    setStrokeGradient(nullptr);
}
 
void QQuickShapePathPrivate::_q_strokeGradientChanged()
{
    Q_Q(QQuickShapePath);
    dirty |= DirtyStrokeGradient;
    emit q->shapePathChanged();
}
 
/*!
    \qmlproperty ShapeGradient QtQuick.Shapes::ShapePath::fillGradient
 
    This property defines the fill gradient. By default no gradient is enabled
    and the value is \c null. In this case the fill will either be based on the \l fillItem
    property if it is set, and otherwise the \l{fillColor} property will be used.
 
    \note The Gradient type cannot be used here. Rather, prefer using one of
    the advanced subtypes, like LinearGradient.
 
    \note If set to something other than \c{null}, the \c fillGradient will take precedence over
    both \l fillItem and \l fillColor.
 
    By default, up to 256 different gradients may be displayed simultaneously. This limit may be
    customized with the \c QT_QUICKSHAPES_MAX_GRADIENTS environment variable.
 */
 
QQuickShapeGradient *QQuickShapePath::fillGradient() const
{
    Q_D(const QQuickShapePath);
    return d->sfp.fillGradient;
}
 
void QQuickShapePath::setFillGradient(QQuickShapeGradient *gradient)
{
    Q_D(QQuickShapePath);
    if (d->sfp.fillGradient != gradient) {
        if (d->sfp.fillGradient)
            qmlobject_disconnect(d->sfp.fillGradient, QQuickShapeGradient, SIGNAL(updated()),
                                 this, QQuickShapePath, SLOT(_q_fillGradientChanged()));
        d->sfp.fillGradient = gradient;
        if (d->sfp.fillGradient)
            qmlobject_connect(d->sfp.fillGradient, QQuickShapeGradient, SIGNAL(updated()),
                              this, QQuickShapePath, SLOT(_q_fillGradientChanged()));
        emit fillGradientChanged();
        d->dirty |= QQuickShapePathPrivate::DirtyFillGradient;
        emit shapePathChanged();
    }
}
 
void QQuickShapePath::resetFillGradient()
{
    setFillGradient(nullptr);
}
 
void QQuickShapePathPrivate::_q_fillGradientChanged()
{
    Q_Q(QQuickShapePath);
    dirty |= DirtyFillGradient;
    emit q->shapePathChanged();
}
 
/*!
    \qmlproperty Item QtQuick.Shapes::ShapePath::fillItem
    \since 6.8
 
    This property defines another Qt Quick Item to use as fill by the shape. The item must be
    texture provider (such as a \l {Item Layers} {layered item}, a \l{ShaderEffectSource} or an
    \l{Image}). If it is not a valid texture provider, this property will be ignored.
 
    The visual parent of \c fillItem must be a Qt Quick \l{Item}. In particular, since \c{ShapePath}
    is not an \l{Item}, its children cannot be used as fill items. Manually setting the
    \c{fillItem}'s parent is needed when it is created as a child of the \c{ShapePath}.
 
    For instance, creating an \l{Image} object directly in the \c{fillItem} property assignment will
    make it a child of the \c{ShapePath}. In this case, its parent must be set manually. In the
    following example we use the window's \l{Window::contentItem}{contentItem} as the parent.
 
    \code
        fillItem: Image {
            visible: false
            source: "contents.png"
            parent: window.contentItem
        }
    \endcode
 
    \note When using a layered item as a \c fillItem, you may see pixelation effects when
    transforming the fill. Setting the \l {QtQuick::Item::}{layer.smooth} property to true will
    give better visual results in this case.
 
    By default no fill item is set and the value is \c null.
 
    \note If set to something other than \c null, the \c fillItem property takes precedence over
    \l fillColor. The \l fillGradient property in turn takes precedence over both \c fillItem and
    \l{fillColor}.
 */
 
QQuickItem *QQuickShapePath::fillItem() const
{
    Q_D(const QQuickShapePath);
    return d->sfp.fillItem;
}
 
void QQuickShapePath::setFillItem(QQuickItem *fillItem)
{
    Q_D(QQuickShapePath);
    if (d->sfp.fillItem != fillItem) {
        if (d->sfp.fillItem != nullptr) {
            qmlobject_disconnect(d->sfp.fillItem, QQuickItem, SIGNAL(destroyed()),
                                 this, QQuickShapePath, SLOT(_q_fillItemDestroyed()));
        }
        d->sfp.fillItem = fillItem;
        if (d->sfp.fillItem != nullptr) {
            qmlobject_connect(d->sfp.fillItem, QQuickItem, SIGNAL(destroyed()),
                              this, QQuickShapePath, SLOT(_q_fillItemDestroyed()));
        }
        emit fillItemChanged();
 
        d->dirty |= QQuickShapePathPrivate::DirtyFillItem;
        emit shapePathChanged();
    }
}
 
/*!
    \qmlpropertygroup QtQuick.Shapes::ShapePath::trim
    \qmlproperty real QtQuick.Shapes::ShapePath::trim.start
    \qmlproperty real QtQuick.Shapes::ShapePath::trim.end
    \qmlproperty real QtQuick.Shapes::ShapePath::trim.offset
    \since 6.10
 
    Specifies the section of this path that will be displayed.
 
    The section is defined by the path length fractions \c start and \c end. By default, \c start
    is 0 (denoting the start of the path) and \c end is 1 (denoting the end of the path), so the
    entire path is displayed.
 
    The value of \c offset is added to \c start and \c end. If that causes over- or underrun of the
    [0, 1] range, the values will be wrapped around, as will the resulting path section. The
    effective range of \c offset is between -1 and 1. The default value is 0.
*/
 
QQuickShapeTrim *QQuickShapePath::trim()
{
    Q_D(QQuickShapePath);
    if (!d->sfp.trim) {
        d->sfp.trim = new QQuickShapeTrim;
        QQml_setParent_noEvent(d->sfp.trim, this);
    }
    return d->sfp.trim;
}
 
bool QQuickShapePath::hasTrim() const
{
    Q_D(const QQuickShapePath);
    return d->sfp.trim != nullptr;
}
 
void QQuickShapePathPrivate::_q_fillItemDestroyed()
{
    Q_Q(QQuickShapePath);
    sfp.fillItem = nullptr;
    dirty |= DirtyFillItem;
    emit q->fillItemChanged();
    emit q->shapePathChanged();
}
 
#ifndef QT_NO_DEBUG_STREAM
void QQuickShapePathPrivate::writeToDebugStream(QDebug &debug) const
{
    debug.nospace() << "QQuickShapePath(" << (const void *)this
        << " startX=" << startX
        << " startY=" << startY
        << " _pathElements=" << _pathElements
        << ')';
}
#endif
 
/*!
    \qmlproperty PathHints QtQuick.Shapes::ShapePath::pathHints
    \since 6.7
 
    This property describes characteristics of the shape. If set, these hints may allow
    optimized rendering. By default, no hints are set. It can be a combination of the following
    values:
 
    \value ShapePath.PathLinear
        The path only has straight lines, no curves.
    \value ShapePath.PathQuadratic
        The path does not have any cubic curves: only lines and quadratic Bezier curves.
    \value ShapePath.PathConvex
        The path does not have any dents or holes. All straight lines between two points
        inside the shape will be completely inside the shape.
    \value ShapePath.PathFillOnRight
        The path follows the TrueType convention where outlines around solid fill have their
        control points ordered clockwise, and outlines around holes in the shape have their
        control points ordered counter-clockwise.
    \value ShapePath.PathSolid
        The path has no holes, or mathematically speaking it is \e{simply connected}.
    \value ShapePath.PathNonIntersecting
        The path outline does not cross itself.
    \value ShapePath.PathNonOverlappingControlPointTriangles
        The triangles defined by the curve control points do not overlap with each other,
        or with any of the line segments. Also, no line segments intersect.
        This implies \c PathNonIntersecting.
 
    Not all hints are logically independent, but the dependencies are not enforced.
    For example, \c PathLinear implies \c PathQuadratic, but it is valid to have \c PathLinear
    without \c PathQuadratic.
 
    The pathHints property describes a set of statements known to be true; the absence of a hint
    does not necessarily mean that the corresponding statement is false.
*/
 
QQuickShapePath::PathHints QQuickShapePath::pathHints() const
{
    Q_D(const QQuickShapePath);
    return d->pathHints;
}
 
void QQuickShapePath::setPathHints(PathHints newPathHints)
{
     Q_D(QQuickShapePath);
    if (d->pathHints == newPathHints)
        return;
    d->pathHints = newPathHints;
    emit pathHintsChanged();
}
 
/*!
    \qmlproperty matrix4x4 QtQuick.Shapes::ShapePath::fillTransform
    \since 6.8
 
    This property defines a transform to be applied to the path's fill pattern (\l fillGradient or
    \l fillItem). It has no effect if the fill is a solid color or transparent. By default no fill
    transform is enabled and the value of this property is the \c identity matrix.
 
    This example displays a rectangle filled with the contents of \c myImageItem rotated 45 degrees
    around the center point of \c myShape:
 
    \qml
    ShapePath {
        fillItem: myImageItem
        fillTransform: PlanarTransform.fromRotate(45, myShape.width / 2, myShape.height / 2)
        PathRectangle { x: 10; y: 10; width: myShape.width - 20; height: myShape.height - 20 }
    }
    \endqml
*/
 
QMatrix4x4 QQuickShapePath::fillTransform() const
{
    Q_D(const QQuickShapePath);
    return d->sfp.fillTransform.matrix();
}
 
void QQuickShapePath::setFillTransform(const QMatrix4x4 &matrix)
{
    Q_D(QQuickShapePath);
    if (d->sfp.fillTransform != matrix) {
        d->sfp.fillTransform.setMatrix(matrix);
        d->dirty |= QQuickShapePathPrivate::DirtyFillTransform;
        emit fillTransformChanged();
        emit shapePathChanged();
    }
}
 
 
QQuickShapeTrim::QQuickShapeTrim(QObject *parent)
    : QObject(parent)
{
}
 
qreal QQuickShapeTrim::start() const
{
    return m_start;
}
 
void QQuickShapeTrim::setStart(qreal t)
{
    if (t == m_start)
        return;
    m_start = t;
    QQuickShapePath *shapePath = qobject_cast<QQuickShapePath *>(parent());
    if (shapePath) {
        QQuickShapePathPrivate *d = QQuickShapePathPrivate::get(shapePath);
        d->dirty |= QQuickShapePathPrivate::DirtyTrim;
        emit startChanged();
        emit shapePath->shapePathChanged();
    }
}
 
qreal QQuickShapeTrim::end() const
{
    return m_end;
}
 
void QQuickShapeTrim::setEnd(qreal t)
{
    if (t == m_end)
        return;
    m_end = t;
    QQuickShapePath *shapePath = qobject_cast<QQuickShapePath *>(parent());
    if (shapePath) {
        QQuickShapePathPrivate *d = QQuickShapePathPrivate::get(shapePath);
        d->dirty |= QQuickShapePathPrivate::DirtyTrim;
        emit endChanged();
        emit shapePath->shapePathChanged();
    }
}
 
qreal QQuickShapeTrim::offset() const
{
    return m_offset;
}
 
void QQuickShapeTrim::setOffset(qreal t)
{
    if (t == m_offset)
        return;
    m_offset = t;
    QQuickShapePath *shapePath = qobject_cast<QQuickShapePath *>(parent());
    if (shapePath) {
        QQuickShapePathPrivate *d = QQuickShapePathPrivate::get(shapePath);
        d->dirty |= QQuickShapePathPrivate::DirtyTrim;
        emit offsetChanged();
        emit shapePath->shapePathChanged();
    }
}
 
/*!
    \qmltype Shape
    //! \nativetype QQuickShape
    \inqmlmodule QtQuick.Shapes
    \ingroup qtquick-paths
    \ingroup qtquick-views
    \inherits Item
    \brief Renders a path.
    \since 5.10
 
    Renders a path by triangulating geometry from a QPainterPath.
 
    This approach is different from rendering shapes via QQuickPaintedItem or
    the 2D Canvas because the path never gets rasterized in software.
    Therefore Shape is suitable for creating shapes spreading over larger
    areas of the screen, avoiding the performance penalty for texture uploads
    or framebuffer blits. In addition, the declarative API allows manipulating,
    binding to, and even animating the path element properties like starting
    and ending position, the control points, and so on.
 
    The types for specifying path elements are shared between \l PathView and
    Shape. However, not all Shape implementations support all path
    element types, while some may not make sense for PathView. Shape's
    currently supported subset is: PathMove, PathLine, PathQuad, PathCubic,
    PathArc, PathText and PathSvg.
 
    See \l Path for a detailed overview of the supported path elements.
 
    \qml
    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 }
        }
    }
    \endqml
 
    \image pathitem-code-example.png
           {Triangle with rainbow gradient fill and red dashed stroke}
 
    Like \l Item, Shape also allows any visual or non-visual objects to be
    declared as children. ShapePath objects are handled specially. This is
    useful since it allows adding visual items, like \l Rectangle or \l Image,
    and non-visual objects, like \l Timer directly as children of Shape.
 
    The following list summarizes the available Shape rendering approaches:
 
    \list
 
    \li When Qt Quick is running with the default, hardware-accelerated backend (RHI),
    the generic shape renderer will be used. This converts the shapes into triangles
    which are passed to the renderer.
 
    \li The \c software backend is fully supported. The path is rendered via
    QPainter::strokePath() and QPainter::fillPath() in this case.
 
    \li The OpenVG backend is not currently supported.
 
    \endlist
 
    When using Shape, it is important to be aware of potential performance
    implications:
 
    \list
 
    \li When the application is running with the generic, triangulation-based
    Shape implementation, the geometry generation happens entirely on the
    CPU. This is potentially expensive. Changing the set of path elements,
    changing the properties of these elements, or changing certain properties
    of the Shape itself all lead to retriangulation of the affected paths on
    every change. Therefore, applying animation to such properties can affect
    performance on less powerful systems.
 
    \li However, the data-driven, declarative nature of the Shape API often
    means better cacheability for the underlying CPU and GPU resources. A
    property change in one ShapePath will only lead to reprocessing the
    affected ShapePath, leaving other parts of the Shape unchanged. Therefore,
    a frequently changing property can still result in a lower overall system
    load than with imperative painting approaches (for example, QPainter).
 
    \li At the same time, attention must be paid to the number of Shape
    elements in the scene. The way such a Shape item is represented in
    the scene graph is different from an ordinary geometry-based item,
    and incurs a certain cost when it comes to OpenGL state changes.
 
    \li As a general rule, scenes should avoid using separate Shape items when
    it is not absolutely necessary. Prefer using one Shape item with multiple
    ShapePath elements over multiple Shape items.
 
    \endlist
 
    \sa {Qt Quick Examples - Shapes}, {Weather Forecast Example}, Path, PathMove, PathLine, PathQuad, PathCubic, PathArc, PathSvg
*/
 
QQuickShapePrivate::QQuickShapePrivate()
      : effectRefCount(0)
{
}
 
QQuickShapePrivate::~QQuickShapePrivate()
{
    delete renderer;
}
 
void QQuickShapePrivate::init()
{
    Q_Q(QQuickShape);
    q->setFlag(QQuickItem::ItemHasContents);
}
 
void QQuickShapePrivate::_q_shapePathChanged()
{
    Q_Q(QQuickShape);
    spChanged = true;
    q->polish();
    emit q->boundingRectChanged();
    auto br = q->boundingRect();
    q->setImplicitSize(br.right(), br.bottom());
}
 
void QQuickShapePrivate::handleSceneChange(QQuickWindow *w)
{
    if (renderer != nullptr)
        renderer->handleSceneChange(w);
}
 
void QQuickShapePrivate::setStatus(QQuickShape::Status newStatus)
{
    Q_Q(QQuickShape);
    if (status != newStatus) {
        status = newStatus;
        emit q->statusChanged();
    }
}
 
qreal QQuickShapePrivate::getImplicitWidth() const
{
    Q_Q(const QQuickShape);
    return q->boundingRect().right();
}
 
qreal QQuickShapePrivate::getImplicitHeight() const
{
    Q_Q(const QQuickShape);
    return q->boundingRect().bottom();
}
 
QQuickShape::QQuickShape(QQuickItem *parent)
  : QQuickItem(*(new QQuickShapePrivate), parent)
{
    Q_D(QQuickShape);
    d->init();
}
 
QQuickShape::QQuickShape(QQuickShapePrivate &dd, QQuickItem *parent)
    : QQuickItem(dd, parent)
{
    Q_D(QQuickShape);
    d->init();
}
 
QQuickShape::~QQuickShape()
{
}
 
/*!
    \qmlproperty enumeration QtQuick.Shapes::Shape::rendererType
    \readonly
 
    This property determines which path rendering backend is active.
 
    \value Shape.UnknownRenderer
           The renderer is unknown.
 
    \value Shape.GeometryRenderer
           The generic, driver independent solution for GPU rendering. Uses the same
           CPU-based triangulation approach as QPainter's OpenGL 2 paint
           engine. This is the default when the RHI-based Qt Quick scenegraph
           backend is in use.
 
    \value Shape.SoftwareRenderer
           Pure QPainter drawing using the raster paint engine. This is the
           default, and only, option when the Qt Quick scenegraph is running
           with the \c software backend.
 
    \value Shape.CurveRenderer
           GPU-based renderer that aims to preserve curvature at any scale.
           In contrast to \c Shape.GeometryRenderer, curves are not approximated by short straight
           lines. Instead, curves are rendered using a specialized fragment shader. This improves
           visual quality and avoids re-tesselation performance hit when zooming. Also,
           \c Shape.CurveRenderer provides native, high-quality anti-aliasing, without the
           performance cost of multi- or supersampling.
 
    By default, \c Shape.GeometryRenderer will be selected unless the Qt Quick scenegraph is running
    with the \c software backend. In that case, \c Shape.SoftwareRenderer will be used.
    \c Shape.CurveRenderer may be requested using the \l preferredRendererType property.
 
    \note The \c Shape.CurveRenderer will approximate cubic curves with quadratic ones and may
    therefore diverge slightly from the mathematically correct visualization of the shape. In
    addition, if the shape is being rendered into a Qt Quick 3D scene and the OpenGL backend for
    RHI is active, the \c GL_OES_standard_derivatives extension to OpenGL is required (this is
    available by default on OpenGL ES 3 and later, but optional in OpenGL ES 2.)
*/
 
QQuickShape::RendererType QQuickShape::rendererType() const
{
    Q_D(const QQuickShape);
    return d->rendererType;
}
 
/*!
    \qmlproperty enumeration QtQuick.Shapes::Shape::preferredRendererType
    \since 6.6
 
    Requests a specific backend to use for rendering the shape. The possible values are the same as
    for \l rendererType. The default is \c Shape.UnknownRenderer, indicating no particular preference.
 
    If the requested renderer type is not supported for the current Qt Quick backend, the default
    renderer for that backend will be used instead. This will be reflected in the \l rendererType
    when the backend is initialized.
 
    \c Shape.SoftwareRenderer can currently not be selected without running the scenegraph with
    the \c software backend, in which case it will be selected regardless of the
    \c preferredRendererType.
 
    See \l rendererType for more information on the implications.
*/
 
QQuickShape::RendererType QQuickShape::preferredRendererType() const
{
    Q_D(const QQuickShape);
    return d->preferredType;
}
 
void QQuickShape::setPreferredRendererType(QQuickShape::RendererType preferredType)
{
    Q_D(QQuickShape);
    if (d->preferredType == preferredType)
        return;
 
    d->preferredType = preferredType;
    // (could bail out here if selectRenderType shows no change?)
 
    for (int i = 0; i < d->sp.size(); ++i) {
        QQuickShapePath *p = d->sp[i];
        QQuickShapePathPrivate *pp = QQuickShapePathPrivate::get(p);
        pp->dirty |= QQuickShapePathPrivate::DirtyAll;
    }
    d->spChanged = true;
    d->_q_shapePathChanged();
    polish();
    update();
 
    emit preferredRendererTypeChanged();
}
 
/*!
    \qmlproperty bool QtQuick.Shapes::Shape::asynchronous
 
    When rendererType is \c Shape.GeometryRenderer or \c Shape.CurveRenderer, a certain amount of
    preprocessing of the input path is performed on the CPU during the polishing phase of the
    Shape. This is potentially expensive. To offload this work to separate worker threads, set this
    property to \c true.
 
    When enabled, making a Shape visible will not wait for the content to
    become available. Instead, the GUI/main thread is not blocked and the
    results of the path rendering are shown only when all the asynchronous
    work has been finished.
 
    The default value is \c false.
 */
 
bool QQuickShape::asynchronous() const
{
    Q_D(const QQuickShape);
    return d->async;
}
 
void QQuickShape::setAsynchronous(bool async)
{
    Q_D(QQuickShape);
    if (d->async != async) {
        d->async = async;
        emit asynchronousChanged();
        if (d->componentComplete)
            d->_q_shapePathChanged();
    }
}
 
/*!
    \qmlproperty rect QtQuick.Shapes::Shape::boundingRect
    \readonly
    \since 6.6
 
    Contains the united bounding rect of all visible sub paths in the shape.
 
    A \l ShapePath whose \l {ShapePath::visible}{visible} property is \c false
    does not contribute.
 */
QRectF QQuickShape::boundingRect() const
{
    Q_D(const QQuickShape);
    QRectF brect;
    for (QQuickShapePath *path : d->sp) {
        if (!path->isVisible())
            continue;
        qreal pw = path->strokeColor().alpha() ? path->strokeWidth() : 0;
        qreal d = path->capStyle() == QQuickShapePath::SquareCap ? pw * M_SQRT1_2 : pw / 2;
        brect = brect.united(path->path().boundingRect().adjusted(-d, -d, d, d));
    }
 
    return brect;
}
 
/*!
    \qmlproperty bool QtQuick.Shapes::Shape::vendorExtensionsEnabled
 
    This property controls the usage of non-standard OpenGL extensions.
 
    The default value is \c false.
 
    As of Qt 6.0 there are no vendor-specific rendering paths implemented.
 */
 
bool QQuickShape::vendorExtensionsEnabled() const
{
    Q_D(const QQuickShape);
    return d->enableVendorExts;
}
 
void QQuickShape::setVendorExtensionsEnabled(bool enable)
{
    Q_D(QQuickShape);
    if (d->enableVendorExts != enable) {
        d->enableVendorExts = enable;
        emit vendorExtensionsEnabledChanged();
    }
}
 
/*!
    \qmlproperty enumeration QtQuick.Shapes::Shape::status
    \readonly
 
    This property determines the status of the Shape and is relevant when
    Shape.asynchronous is set to \c true.
 
    \value Shape.Null
           Not yet initialized.
 
    \value Shape.Ready
           The Shape has finished processing.
 
    \value Shape.Processing
           The path is being processed.
 */
 
QQuickShape::Status QQuickShape::status() const
{
    Q_D(const QQuickShape);
    return d->status;
}
 
/*!
    \qmlproperty enumeration QtQuick.Shapes::Shape::containsMode
    \since QtQuick.Shapes 1.11
 
    This property determines the definition of \l {QQuickItem::contains()}{contains()}
    for the Shape. It is useful in case you add \l {Qt Quick Input Handlers} and you want to
    react only when the mouse or touchpoint is fully inside the Shape.
 
    \value Shape.BoundingRectContains
        The default implementation of \l QQuickItem::contains() checks only
        whether the given point is inside the rectangular bounding box. This is
        the most efficient implementation, which is why it's the default.
 
    \value Shape.FillContains
        Check whether the interior (the part that would be filled if you are
        rendering it with fill) of any visible \l ShapePath that makes up this
        Shape contains the given point. The more complex and numerous ShapePaths you
        add, the less efficient this is to check, which can potentially slow
        down event delivery in your application. So it should be used with care.
 
    One way to speed up the \c FillContains check is to generate an approximate
    outline with as few points as possible, place that in a transparent Shape
    on top, and add your Pointer Handlers to that, so that the containment
    check is cheaper during event delivery.
*/
QQuickShape::ContainsMode QQuickShape::containsMode() const
{
    Q_D(const QQuickShape);
    return d->containsMode;
}
 
void QQuickShape::setContainsMode(QQuickShape::ContainsMode containsMode)
{
    Q_D(QQuickShape);
    if (d->containsMode == containsMode)
        return;
 
    d->containsMode = containsMode;
    emit containsModeChanged();
}
 
bool QQuickShape::contains(const QPointF &point) const
{
    Q_D(const QQuickShape);
    switch (d->containsMode) {
    case BoundingRectContains:
        return QQuickItem::contains(point);
    case FillContains:
        for (QQuickShapePath *path : d->sp) {
            if (path->isVisible() && path->path().contains(point))
                return true;
        }
    }
    return false;
}
 
/*!
    \qmlproperty enumeration QtQuick.Shapes::Shape::fillMode
    \since QtQuick.Shapes 6.7
 
     Set this property to define what happens when the path has a different size
     than the item.
 
    \value Shape.NoResize           the shape is rendered at its native size, independent of the size of the item. This is the default
    \value Shape.Stretch            the shape is scaled to fit the item, changing the aspect ratio if necessary.
                                    Note that non-uniform scaling may cause reduced quality of anti-aliasing when using the curve renderer
    \value Shape.PreserveAspectFit  the shape is scaled uniformly to fit inside the item
    \value Shape.PreserveAspectCrop the shape is scaled uniformly to fill the item fully, extending outside the item if necessary.
                                    Note that this only actually crops the content if \l clip is true
*/
 
QQuickShape::FillMode QQuickShape::fillMode() const
{
    Q_D(const QQuickShape);
    return d->fillMode;
}
 
void QQuickShape::setFillMode(FillMode newFillMode)
{
    Q_D(QQuickShape);
    if (d->fillMode == newFillMode)
        return;
    d->fillMode = newFillMode;
    emit fillModeChanged();
}
 
/*!
    \qmlproperty enumeration QtQuick.Shapes::Shape::horizontalAlignment
    \qmlproperty enumeration QtQuick.Shapes::Shape::verticalAlignment
    \since 6.7
 
    Sets the horizontal and vertical alignment of the shape within the item.
    By default, the shape is aligned with \c{(0,0)} on the top left corner.
 
    The valid values for \c horizontalAlignment are \c Shape.AlignLeft,
    \c Shape.AlignRight and \c Shape.AlignHCenter. The valid values for
    \c verticalAlignment are \c Shape.AlignTop, \c Shape.AlignBottom and
    \c Shape.AlignVCenter.
*/
 
QQuickShape::HAlignment QQuickShape::horizontalAlignment() const
{
    Q_D(const QQuickShape);
    return d->horizontalAlignment;
}
 
void QQuickShape::setHorizontalAlignment(HAlignment newHorizontalAlignment)
{
    Q_D(QQuickShape);
    if (d->horizontalAlignment == newHorizontalAlignment)
        return;
    d->horizontalAlignment = newHorizontalAlignment;
    emit horizontalAlignmentChanged();
}
 
QQuickShape::VAlignment QQuickShape::verticalAlignment() const
{
    Q_D(const QQuickShape);
    return d->verticalAlignment;
}
 
void QQuickShape::setVerticalAlignment(VAlignment newVerticalAlignment)
{
    Q_D(QQuickShape);
    if (d->verticalAlignment == newVerticalAlignment)
        return;
    d->verticalAlignment = newVerticalAlignment;
    emit verticalAlignmentChanged();
}
 
static void vpe_append(QQmlListProperty<QObject> *property, QObject *obj)
{
    QQuickShape *item = static_cast<QQuickShape *>(property->object);
    QQuickShapePrivate *d = QQuickShapePrivate::get(item);
    QQuickShapePath *path = qobject_cast<QQuickShapePath *>(obj);
    if (path) {
        QQuickShapePathPrivate::get(path)->dirty = QQuickShapePathPrivate::DirtyAll;
        d->sp.append(path);
    }
 
    QQuickItemPrivate::data_append(property, obj);
 
    if (path && d->componentComplete) {
        QObject::connect(path, SIGNAL(shapePathChanged()), item, SLOT(_q_shapePathChanged()));
        d->_q_shapePathChanged();
    }
}
 
static void vpe_clear(QQmlListProperty<QObject> *property)
{
    QQuickShape *item = static_cast<QQuickShape *>(property->object);
    QQuickShapePrivate *d = QQuickShapePrivate::get(item);
 
    for (QQuickShapePath *p : d->sp)
        QObject::disconnect(p, SIGNAL(shapePathChanged()), item, SLOT(_q_shapePathChanged()));
 
    d->sp.clear();
 
    QQuickItemPrivate::data_clear(property);
 
    if (d->componentComplete)
        d->_q_shapePathChanged();
}
 
/*!
    \qmlproperty list<Object> QtQuick.Shapes::Shape::data
 
    This property holds the ShapePath objects that define the contents of the
    Shape. It can also contain any other type of objects, since Shape, like
    Item, allows adding any visual or non-visual objects as children.
 
    \qmldefault
 */
 
QQmlListProperty<QObject> QQuickShape::data()
{
    return QQmlListProperty<QObject>(this,
                                     nullptr,
                                     vpe_append,
                                     QQuickItemPrivate::data_count,
                                     QQuickItemPrivate::data_at,
                                     vpe_clear);
}
 
void QQuickShape::classBegin()
{
    QQuickItem::classBegin();
}
 
void QQuickShape::componentComplete()
{
    Q_D(QQuickShape);
 
    QQuickItem::componentComplete();
 
    for (QQuickShapePath *p : d->sp)
        connect(p, SIGNAL(shapePathChanged()), this, SLOT(_q_shapePathChanged()));
 
    d->_q_shapePathChanged();
}
 
void QQuickShape::updatePolish()
{
    Q_D(QQuickShape);
 
    const int currentEffectRefCount = d->extra.isAllocated() ? d->extra->recursiveEffectRefCount : 0;
    if (!d->spChanged && currentEffectRefCount <= d->effectRefCount)
        return;
 
    d->spChanged = false;
    d->effectRefCount = currentEffectRefCount;
 
    QQuickShape::RendererType expectedRenderer = d->selectRendererType();
    if (d->rendererType != expectedRenderer) {
        delete d->renderer;
        d->renderer = nullptr;
    }
 
    if (!d->renderer) {
        d->createRenderer();
        if (!d->renderer)
            return;
        emit rendererChanged();
    }
 
    // endSync() is where expensive calculations may happen (or get kicked off
    // on worker threads), depending on the backend. Therefore do this only
    // when the item is visible.
    if (isVisible() || d->effectRefCount > 0)
        d->sync();
}
 
void QQuickShape::itemChange(ItemChange change, const ItemChangeData &data)
{
    Q_D(QQuickShape);
 
    // sync may have been deferred; do it now if the item became visible
    if (change == ItemVisibleHasChanged && data.boolValue)
        d->_q_shapePathChanged();
    else if (change == QQuickItem::ItemSceneChange) {
        for (int i = 0; i < d->sp.size(); ++i)
            QQuickShapePathPrivate::get(d->sp[i])->dirty = QQuickShapePathPrivate::DirtyAll;
        d->_q_shapePathChanged();
        d->handleSceneChange(data.window);
    } else if (change == ItemTransformHasChanged && d->rendererType == QQuickShape::GeometryRenderer) {
        bool cosmeticStrokeFound = false;
        for (int i = 0; i < d->sp.size(); ++i) {
            if (d->sp[i]->cosmeticStroke()) {
                QQuickShapePathPrivate::get(d->sp[i])->dirty = QQuickShapePathPrivate::DirtyStrokeWidth;
                cosmeticStrokeFound = true;
            }
        }
        if (cosmeticStrokeFound)
            d->_q_shapePathChanged();
    }
 
    QQuickItem::itemChange(change, data);
}
 
QSGNode *QQuickShape::updatePaintNode(QSGNode *node, UpdatePaintNodeData *)
{
    // Called on the render thread, with the gui thread blocked. We can now
    // safely access gui thread data.
    Q_D(QQuickShape);
 
    if (d->renderer || d->rendererChanged) {
        if (!node || d->rendererChanged) {
            d->rendererChanged = false;
            delete node;
            node = d->createNode();
        }
        if (d->renderer)
            d->renderer->updateNode();
 
        // TODO: only add transform node when needed (and then make sure static_cast is safe)
        QMatrix4x4 fillModeTransform;
        qreal xScale = 1.0;
        qreal yScale = 1.0;
 
        if (d->fillMode != NoResize) {
            xScale = width() / implicitWidth();
            yScale = height() / implicitHeight();
 
            if (d->fillMode == PreserveAspectFit)
                xScale = yScale = qMin(xScale, yScale);
            else if (d->fillMode == PreserveAspectCrop)
                xScale = yScale = qMax(xScale, yScale);
            fillModeTransform.scale(xScale, yScale);
        }
        if (d->horizontalAlignment != AlignLeft || d->verticalAlignment != AlignTop) {
            qreal tx = 0;
            qreal ty = 0;
            qreal w = xScale * implicitWidth();
            qreal h = yScale * implicitHeight();
            if (d->horizontalAlignment == AlignRight)
                tx = width() - w;
            else if (d->horizontalAlignment == AlignHCenter)
                tx = (width() - w) / 2;
            if (d->verticalAlignment == AlignBottom)
                ty = height() - h;
            else if (d->verticalAlignment == AlignVCenter)
                ty = (height() - h) / 2;
            fillModeTransform.translate(tx / xScale, ty / yScale);
        }
 
        QSGTransformNode *transformNode = static_cast<QSGTransformNode *>(node);
        if (fillModeTransform != transformNode->matrix())
            transformNode->setMatrix(fillModeTransform);
    }
    return node;
}
 
QQuickShape::RendererType QQuickShapePrivate::selectRendererType()
{
    QQuickShape::RendererType res = QQuickShape::UnknownRenderer;
    Q_Q(QQuickShape);
    QSGRendererInterface *ri = q->window()->rendererInterface();
    if (!ri)
        return res;
 
    static const bool environmentPreferCurve =
        qEnvironmentVariable("QT_QUICKSHAPES_BACKEND").toLower() == QLatin1String("curverenderer");
 
    switch (ri->graphicsApi()) {
    case QSGRendererInterface::Software:
        res = QQuickShape::SoftwareRenderer;
        break;
    default:
        if (QSGRendererInterface::isApiRhiBased(ri->graphicsApi())) {
            if (preferredType == QQuickShape::CurveRenderer || environmentPreferCurve) {
                res = QQuickShape::CurveRenderer;
            } else {
                res = QQuickShape::GeometryRenderer;
            }
        } else {
            qWarning("No path backend for this graphics API yet");
        }
        break;
    }
 
    return res;
}
 
// the renderer object lives on the gui thread
void QQuickShapePrivate::createRenderer()
{
    Q_Q(QQuickShape);
    QQuickShape::RendererType selectedType = selectRendererType();
    if (selectedType == QQuickShape::UnknownRenderer)
        return;
 
    rendererType = selectedType;
    rendererChanged = true;
 
    // If cosmetic stroking is used with GeometryRenderer, we need to be notified when the transform changes
    q->setFlag(QQuickItem::ItemObservesViewport, rendererType == QQuickShape::GeometryRenderer);
 
    switch (selectedType) {
    case QQuickShape::SoftwareRenderer:
        renderer = new QQuickShapeSoftwareRenderer;
        break;
    case QQuickShape::GeometryRenderer:
        renderer = new QQuickShapeGenericRenderer(q);
        break;
    case QQuickShape::CurveRenderer:
        renderer = new QQuickShapeCurveRenderer(q);
        break;
    default:
        Q_UNREACHABLE();
        break;
    }
}
 
// the node lives on the render thread
QSGNode *QQuickShapePrivate::createNode()
{
    Q_Q(QQuickShape);
    QSGNode *node = nullptr;
    if (!q->window() || !renderer)
        return node;
    QSGRendererInterface *ri = q->window()->rendererInterface();
    if (!ri)
        return node;
 
    QSGNode *pathNode = nullptr;
    switch (ri->graphicsApi()) {
    case QSGRendererInterface::Software:
        pathNode = new QQuickShapeSoftwareRenderNode(q);
        static_cast<QQuickShapeSoftwareRenderer *>(renderer)->setNode(
                    static_cast<QQuickShapeSoftwareRenderNode *>(pathNode));
        break;
    default:
        if (QSGRendererInterface::isApiRhiBased(ri->graphicsApi())) {
            if (rendererType == QQuickShape::CurveRenderer) {
                pathNode = new QSGNode;
                static_cast<QQuickShapeCurveRenderer *>(renderer)->setRootNode(pathNode);
            } else {
                pathNode = new QQuickShapeGenericNode;
                static_cast<QQuickShapeGenericRenderer *>(renderer)->setRootNode(
                    static_cast<QQuickShapeGenericNode *>(pathNode));
            }
        } else {
            qWarning("No path backend for this graphics API yet");
        }
        break;
    }
 
    // TODO: only create transform node when needed
    node = new QSGTransformNode;
    node->appendChildNode(pathNode);
 
    return node;
}
 
void QQuickShapePrivate::asyncShapeReady(void *data)
{
    QQuickShapePrivate *self = static_cast<QQuickShapePrivate *>(data);
    self->setStatus(QQuickShape::Ready);
    if (self->syncTimingActive)
        qDebug("[Shape %p] [%d] [dirty=0x%x] async update took %lld ms",
               self->q_func(), self->syncTimeCounter, self->syncTimingTotalDirty, self->syncTimer.elapsed());
}
 
void QQuickShapePrivate::sync()
{
    int totalDirty = 0;
    syncTimingActive = QQSHAPE_LOG_TIME_DIRTY_SYNC().isDebugEnabled();
    if (syncTimingActive)
        syncTimer.start();
 
    const bool useAsync = async && renderer->flags().testFlag(QQuickAbstractPathRenderer::SupportsAsync);
    if (useAsync) {
        setStatus(QQuickShape::Processing);
        renderer->setAsyncCallback(asyncShapeReady, this);
    }
 
    const int count = sp.size();
    bool countChanged = false;
    const qreal det = windowToItemTransform().determinant();
    const qreal adjTriangulationScale = triangulationScale /
            (qIsNaN(det) || qIsNull(det) ? qreal(1) : qSqrt(qAbs(det)));
    renderer->beginSync(count, &countChanged);
 
    qCDebug(lcShapeSync) << "syncing" << count << "path(s)";
    for (int i = 0; i < count; ++i) {
        QQuickShapePath *p = sp[i];
        qCDebug(lcShapeSync) << "- syncing path:" << p;
        int &dirty(QQuickShapePathPrivate::get(p)->dirty);
        totalDirty |= dirty;
 
        if (dirty & (QQuickShapePathPrivate::DirtyPath | QQuickShapePathPrivate::DirtyTrim)) {
            qCDebug(lcShapeSync) << "  - DirtyPath";
            renderer->setPath(i, p);
        }
        if (dirty & QQuickShapePathPrivate::DirtyStrokeColor) {
            qCDebug(lcShapeSync) << "  - DirtyStrokeColor:" << p->strokeColor();
            renderer->setStrokeColor(i, p->strokeColor());
        }
        if (dirty & QQuickShapePathPrivate::DirtyStrokeWidth) {
            // TODO adjust triangulationScale regardless of the env var, after we're satisfied that there are no significant regressions
            if (p->cosmeticStroke() || QSGCurveStrokeNode::expandingStrokeEnabled()) {
                renderer->setTriangulationScale(i, adjTriangulationScale);
                qCDebug(lcShapeSync) << "  - DirtyStrokeWidth:" << p->strokeWidth()
                                     << "cosmetic:" << p->cosmeticStroke() << "triangulationScale"
                                     << triangulationScale << "adjusted to" << adjTriangulationScale;
            } else {
                renderer->setTriangulationScale(i, triangulationScale);
                qCDebug(lcShapeSync) << "  - DirtyStrokeWidth:" << p->strokeWidth()
                                     << "cosmetic:" << p->cosmeticStroke() << "triangulationScale" << triangulationScale;
            }
            renderer->setStrokeWidth(i, p->strokeWidth());
            renderer->setCosmeticStroke(i, p->cosmeticStroke());
        }
        if (dirty & QQuickShapePathPrivate::DirtyFillColor)
            renderer->setFillColor(i, p->fillColor());
        if (dirty & QQuickShapePathPrivate::DirtyFillRule)
            renderer->setFillRule(i, p->fillRule());
        if (dirty & QQuickShapePathPrivate::DirtyStyle) {
            renderer->setJoinStyle(i, p->joinStyle(), p->miterLimit());
            renderer->setCapStyle(i, p->capStyle());
        }
        if (dirty & QQuickShapePathPrivate::DirtyDash)
            renderer->setStrokeStyle(i, p->strokeStyle(), p->dashOffset(), p->dashPattern());
        if (dirty & QQuickShapePathPrivate::DirtyFillGradient)
            renderer->setFillGradient(i, p->fillGradient());
        if (dirty & QQuickShapePathPrivate::DirtyStrokeGradient)
            renderer->setStrokeGradient(i, p->strokeGradient());
        if (dirty & QQuickShapePathPrivate::DirtyFillTransform)
            renderer->setFillTransform(i, QQuickShapePathPrivate::get(p)->sfp.fillTransform);
        if (dirty & QQuickShapePathPrivate::DirtyVisible)
            renderer->setVisible(i, p->isVisible());
        if (dirty & QQuickShapePathPrivate::DirtyFillItem) {
            if (p->fillItem() == nullptr) {
                renderer->setFillTextureProvider(i, nullptr);
            } else if (p->fillItem()->isTextureProvider()) {
                renderer->setFillTextureProvider(i, p->fillItem());
            } else {
                renderer->setFillTextureProvider(i, nullptr);
                qWarning() << "QQuickShape: Fill item is not texture provider";
            }
        }
 
        dirty = 0;
    }
 
    syncTimingTotalDirty = totalDirty;
    if (syncTimingTotalDirty)
        ++syncTimeCounter;
    else
        syncTimingActive = false;
 
    renderer->endSync(useAsync);
 
    if (!useAsync) {
        setStatus(QQuickShape::Ready);
        if (syncTimingActive)
            qDebug("[Shape %p] [%d] [dirty=0x%x] update took %lld ms",
                   q_func(), syncTimeCounter, syncTimingTotalDirty, syncTimer.elapsed());
    }
 
    // Must dirty the QQuickItem if something got changed, nothing
    // else does this for us.
    Q_Q(QQuickShape);
    if (totalDirty || countChanged)
        q->update();
}
 
// ***** gradient support *****
 
/*!
    \qmltype ShapeGradient
    //! \nativetype QQuickShapeGradient
    \inqmlmodule QtQuick.Shapes
    \ingroup qtquick-paths
    \ingroup qtquick-views
    \inherits Gradient
    \brief Base type of Shape fill gradients.
    \since 5.10
 
    This is an abstract base class for gradients like LinearGradient and
    cannot be created directly. It extends \l Gradient with properties like the
    spread mode.
 */
 
QQuickShapeGradient::QQuickShapeGradient(QObject *parent)
    : QQuickGradient(parent),
      m_spread(PadSpread)
{
}
 
/*!
    \qmlproperty enumeration QtQuick.Shapes::ShapeGradient::spread
 
    Specifies how the area outside the gradient area should be filled. The
    default value is \c ShapeGradient.PadSpread.
 
    \value ShapeGradient.PadSpread
           The area is filled with the closest stop color.
 
    \value ShapeGradient.RepeatSpread
           The gradient is repeated outside the gradient area.
 
    \value ShapeGradient.ReflectSpread
           The gradient is reflected outside the gradient area.
 */
 
QQuickShapeGradient::SpreadMode QQuickShapeGradient::spread() const
{
    return m_spread;
}
 
void QQuickShapeGradient::setSpread(SpreadMode mode)
{
    if (m_spread != mode) {
        m_spread = mode;
        emit spreadChanged();
        emit updated();
    }
}
 
/*!
    \qmltype LinearGradient
    //! \nativetype QQuickShapeLinearGradient
    \inqmlmodule QtQuick.Shapes
    \ingroup qtquick-paths
    \ingroup qtquick-views
    \inherits ShapeGradient
    \brief Linear gradient.
    \since 5.10
 
    Linear gradients interpolate colors between start and end points in Shape
    items. Outside these points the gradient is either padded, reflected or
    repeated depending on the spread type.
 
    \note LinearGradient is only supported in combination with Shape items. It
    is not compatible with \l Rectangle, as that only supports \l Gradient.
 
    \sa QLinearGradient
 */
 
QQuickShapeLinearGradient::QQuickShapeLinearGradient(QObject *parent)
    : QQuickShapeGradient(parent)
{
}
 
/*!
    \qmlproperty real QtQuick.Shapes::LinearGradient::x1
    \qmlproperty real QtQuick.Shapes::LinearGradient::y1
    \qmlproperty real QtQuick.Shapes::LinearGradient::x2
    \qmlproperty real QtQuick.Shapes::LinearGradient::y2
 
    These properties define the start and end points between which color
    interpolation occurs. By default both points are set to (0, 0).
 */
 
qreal QQuickShapeLinearGradient::x1() const
{
    return m_start.x();
}
 
void QQuickShapeLinearGradient::setX1(qreal v)
{
    if (m_start.x() != v) {
        m_start.setX(v);
        emit x1Changed();
        emit updated();
    }
}
 
qreal QQuickShapeLinearGradient::y1() const
{
    return m_start.y();
}
 
void QQuickShapeLinearGradient::setY1(qreal v)
{
    if (m_start.y() != v) {
        m_start.setY(v);
        emit y1Changed();
        emit updated();
    }
}
 
qreal QQuickShapeLinearGradient::x2() const
{
    return m_end.x();
}
 
void QQuickShapeLinearGradient::setX2(qreal v)
{
    if (m_end.x() != v) {
        m_end.setX(v);
        emit x2Changed();
        emit updated();
    }
}
 
qreal QQuickShapeLinearGradient::y2() const
{
    return m_end.y();
}
 
void QQuickShapeLinearGradient::setY2(qreal v)
{
    if (m_end.y() != v) {
        m_end.setY(v);
        emit y2Changed();
        emit updated();
    }
}
 
/*!
    \qmltype RadialGradient
    //! \nativetype QQuickShapeRadialGradient
    \inqmlmodule QtQuick.Shapes
    \ingroup qtquick-paths
    \ingroup qtquick-views
    \inherits ShapeGradient
    \brief Radial gradient.
    \since 5.10
 
    Radial gradients interpolate colors between a focal circle and a center
    circle in Shape items. Points outside the cone defined by the two circles
    will be transparent.
 
    Outside the end points the gradient is either padded, reflected or repeated
    depending on the spread type.
 
    Below is an example of a simple radial gradient. Here the colors are
    interpolated between the specified point and the end points on a circle
    specified by the radius:
 
    \code
        fillGradient: RadialGradient {
            centerX: 50; centerY: 50
            centerRadius: 100
            focalX: centerX; focalY: centerY
            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" }
        }
    \endcode
 
    \image shape-radial-gradient.png
           {Ellipse with radial gradient from white center to cyan edge}
 
    Extended radial gradients, where a separate focal circle is specified, are
    also supported.
 
    \note RadialGradient is only supported in combination with Shape items. It
    is not compatible with \l Rectangle, as that only supports \l Gradient.
 
    \sa QRadialGradient
 */
 
QQuickShapeRadialGradient::QQuickShapeRadialGradient(QObject *parent)
    : QQuickShapeGradient(parent)
{
}
 
/*!
    \qmlproperty real QtQuick.Shapes::RadialGradient::centerX
    \qmlproperty real QtQuick.Shapes::RadialGradient::centerY
    \qmlproperty real QtQuick.Shapes::RadialGradient::focalX
    \qmlproperty real QtQuick.Shapes::RadialGradient::focalY
 
    These properties define the center and focal points. To specify a simple
    radial gradient, set focalX and focalY to the value of centerX and
    centerY, respectively.
 */
 
qreal QQuickShapeRadialGradient::centerX() const
{
    return m_centerPoint.x();
}
 
void QQuickShapeRadialGradient::setCenterX(qreal v)
{
    if (m_centerPoint.x() != v) {
        m_centerPoint.setX(v);
        emit centerXChanged();
        emit updated();
    }
}
 
qreal QQuickShapeRadialGradient::centerY() const
{
    return m_centerPoint.y();
}
 
void QQuickShapeRadialGradient::setCenterY(qreal v)
{
    if (m_centerPoint.y() != v) {
        m_centerPoint.setY(v);
        emit centerYChanged();
        emit updated();
    }
}
 
/*!
    \qmlproperty real QtQuick.Shapes::RadialGradient::centerRadius
    \qmlproperty real QtQuick.Shapes::RadialGradient::focalRadius
 
    These properties define the center and focal radius. For simple radial
    gradients, focalRadius should be set to \c 0 (the default value).
 */
 
qreal QQuickShapeRadialGradient::centerRadius() const
{
    return m_centerRadius;
}
 
void QQuickShapeRadialGradient::setCenterRadius(qreal v)
{
    if (m_centerRadius != v) {
        m_centerRadius = v;
        emit centerRadiusChanged();
        emit updated();
    }
}
 
qreal QQuickShapeRadialGradient::focalX() const
{
    return m_focalPoint.x();
}
 
void QQuickShapeRadialGradient::setFocalX(qreal v)
{
    if (m_focalPoint.x() != v) {
        m_focalPoint.setX(v);
        emit focalXChanged();
        emit updated();
    }
}
 
qreal QQuickShapeRadialGradient::focalY() const
{
    return m_focalPoint.y();
}
 
void QQuickShapeRadialGradient::setFocalY(qreal v)
{
    if (m_focalPoint.y() != v) {
        m_focalPoint.setY(v);
        emit focalYChanged();
        emit updated();
    }
}
 
qreal QQuickShapeRadialGradient::focalRadius() const
{
    return m_focalRadius;
}
 
void QQuickShapeRadialGradient::setFocalRadius(qreal v)
{
    if (m_focalRadius != v) {
        m_focalRadius = v;
        emit focalRadiusChanged();
        emit updated();
    }
}
 
/*!
    \qmltype ConicalGradient
    //! \nativetype QQuickShapeConicalGradient
    \inqmlmodule QtQuick.Shapes
    \ingroup qtquick-paths
    \ingroup qtquick-views
    \inherits ShapeGradient
    \brief Conical gradient.
    \since 5.10
 
    Conical gradients interpolate colors counter-clockwise around a center
    point in Shape items.
 
    \note The \l{ShapeGradient::spread}{spread mode} setting has no effect for
    conical gradients.
 
    \note ConicalGradient is only supported in combination with Shape items. It
    is not compatible with \l Rectangle, as that only supports \l Gradient.
 
    \sa QConicalGradient
 */
 
QQuickShapeConicalGradient::QQuickShapeConicalGradient(QObject *parent)
    : QQuickShapeGradient(parent)
{
}
 
/*!
    \qmlproperty real QtQuick.Shapes::ConicalGradient::centerX
    \qmlproperty real QtQuick.Shapes::ConicalGradient::centerY
 
    These properties define the center point of the conical gradient.
 */
 
qreal QQuickShapeConicalGradient::centerX() const
{
    return m_centerPoint.x();
}
 
void QQuickShapeConicalGradient::setCenterX(qreal v)
{
    if (m_centerPoint.x() != v) {
        m_centerPoint.setX(v);
        emit centerXChanged();
        emit updated();
    }
}
 
qreal QQuickShapeConicalGradient::centerY() const
{
    return m_centerPoint.y();
}
 
void QQuickShapeConicalGradient::setCenterY(qreal v)
{
    if (m_centerPoint.y() != v) {
        m_centerPoint.setY(v);
        emit centerYChanged();
        emit updated();
    }
}
 
/*!
    \qmlproperty real QtQuick.Shapes::ConicalGradient::angle
 
    This property defines the start angle for the conical gradient. The value
    is in degrees (0-360).
 */
 
qreal QQuickShapeConicalGradient::angle() const
{
    return m_angle;
}
 
void QQuickShapeConicalGradient::setAngle(qreal v)
{
    if (m_angle != v) {
        m_angle = v;
        emit angleChanged();
        emit updated();
    }
}
 
QT_END_NAMESPACE
 
#include "moc_qquickshape_p.cpp"