Expose QQuickPath::pointAtPercent as Q_INVOKABLE

So it can be used in QML. Useful in combination with ShapePath,
in order to add graphics along a Shape.

[ChangeLog][QtQuick][Shapes] Exposed QQuickPath::pointAtPercent
as invokable in QML.

Change-Id: Ia8aeb2b74003410ce16d9d2a0c62d79a021530af
Reviewed-by: Shawn Rutledge <shawn.rutledge@qt.io>
 

1 files changed, 21 insertions, 2 deletions

diff --git a/src/quick/util/qquickpath.cpp b/src/quick/util/qquickpath.cpp
index f0705d19bd..840a8c6a2c 100644
--- a/src/quick/util/qquickpath.cpp
+++ b/src/quick/util/qquickpath.cpp
@@ -900,9 +900,28 @@ QPointF QQuickPath::backwardsPointAt(const QPainterPath &path, const qreal &path
     return QPointF(0,0);
 }
 
-QPointF QQuickPath::pointAt(qreal p) const
+/*!
+   \qmlmethod point Path::pointAtPercent(real t)
+
+    Returns the point at the percentage \a t of the current path.
+    The argument \a t has to be between 0 and 1.
+
+    \note Similarly to other percent methods in \l QPainterPath,
+    the percentage measurement is not linear with regards to the length,
+    if curves are present in the path.
+    When curves are present, the percentage argument is mapped to the \c t
+    parameter of the Bezier equations.
+
+   \sa QPainterPath::pointAt
+
+   \since QtQuick 2.14
+*/
+QPointF QQuickPath::pointAtPercent(qreal t) const
 {
     Q_D(const QQuickPath);
+    if (d->isShapePath)                     // this since ShapePath does not calculate the length at all,
+        return d->_path.pointAtPercent(t);  // in order to be faster.
+
     if (d->_pointCache.isEmpty()) {
         createPointCache();
         if (d->_pointCache.isEmpty())
@@ -910,7 +929,7 @@ QPointF QQuickPath::pointAt(qreal p) const
     }
 
     const int segmentCount = d->_pointCache.size() - 1;
-    qreal idxf = p*segmentCount;
+    qreal idxf = t*segmentCount;
     int idx1 = qFloor(idxf);
     qreal delta = idxf - idx1;
     if (idx1 > segmentCount)