Path QML Type

Define una ruta para su uso por PathView y Shape. Más...

• Lista de todos los miembros, incluidos los heredados

Propiedades

• asynchronous : bool (since 6.9)
• closed : bool
• pathElements : list<PathElement>
• scale : size (since QtQuick 2.14)
• simplify : bool (since 6.6)
• startX : real
• startY : real

Métodos

• point pointAtPercent(real t) (since QtQuick 2.14)

Descripción detallada

Una Ruta se compone de uno o más segmentos de ruta - PathLine, PathPolyline, PathQuad, PathCubic, PathArc, PathAngleArc, PathCurve, PathSvg.

El espaciado de los elementos a lo largo de la Ruta puede ajustarse mediante un objeto PathPercent.

PathAttribute permite definir atributos con nombre y valores a lo largo de la ruta.

La ruta y los demás tipos para especificar elementos de ruta se comparten entre PathView y Shape. La siguiente tabla ofrece una visión general de la aplicabilidad de los distintos elementos de ruta:

Véase también PathView, Shape, PathAttribute, PathPercent, PathLine, PathPolyline, PathMove, PathQuad, PathCubic, PathArc, PathAngleArc, PathCurve, PathSvg, y PathRectangle.

Documentación de propiedades

asynchronous : bool [since 6.9]

Cuando se establece en true, la ruta se procesará de forma asíncrona. Esto es una optimización para procesar la ruta sólo una vez, después de todos los métodos que posiblemente afecten a la ruta. Esto significa que cuando se establece a true, la ruta actualizada no está disponible inmediatamente después de, por ejemplo, ajustar startX, scale o añadir un elemento, sólo después de que el bucle de eventos Qt haya sido procesado. El valor por defecto es false.

Esta propiedad se introdujo en Qt 6.9.

closed : bool [read-only]

Esta propiedad determina si el inicio y el final de la ruta son idénticos.

pathElements : list<PathElement> [default read-only]

Esta propiedad contiene los objetos que componen la ruta.

Una trayectoria puede contener los siguientes objetos

• PathLine - una línea recta hasta una posición dada.
• PathPolyline - una polilínea especificada como una lista de coordenadas.
• PathMultiline - una lista de polilíneas especificadas como una lista de listas de coordenadas.
• PathQuad - una curva de Bézier cuadrática a una posición dada con un punto de control.
• PathCubic - una curva de Bézier cúbica a una posición dada con dos puntos de control.
• PathArc - un arco a una posición dada con un radio.
• PathAngleArc - un arco especificado por punto central, radios y ángulos.
• PathSvg - Una trayectoria especificada como cadena de datos de trayectoria SVG.
• PathRectangle - un rectángulo con una posición y un tamaño dados
• PathCurve - un punto en una curva Catmull-Rom.
• PathAttribute - un atributo en una posición determinada del trazado.
• PathPercent - una forma de distribuir elementos a lo largo de varios segmentos del trazado.

    PathView {
        anchors.fill: parent
        model: ContactModel {}
        delegate: delegate
        path: Path {
            startX: 120; startY: 100
            PathAttribute { name: "iconScale"; value: 1.0 }
            PathAttribute { name: "iconOpacity"; value: 1.0 }
            PathQuad { x: 120; y: 25; controlX: 260; controlY: 75 }
            PathAttribute { name: "iconScale"; value: 0.3 }
            PathAttribute { name: "iconOpacity"; value: 0.5 }
            PathQuad { x: 120; y: 100; controlX: -20; controlY: 75 }
        }
    }

scale : size [since QtQuick 2.14]

Esta propiedad contiene el factor de escala de la ruta. La anchura y la altura de scale pueden ser diferentes, para conseguir un escalado anisotrópico.

Esta propiedad se introdujo en QtQuick 2.14.

simplify : bool [since 6.6]

Cuando se establece en true, el camino se simplificará. Esto implica fusionar todos los subcaminos que se cruzan, creando un camino en el que no hay auto-intersecciones. Las líneas paralelas consecutivas también se fusionarán. El trazado simplificado está pensado para ser utilizado con ShapePath.OddEvenFill. Las curvas Bézier pueden ser aplanadas a segmentos de línea debido a la inestabilidad numérica de hacer intersecciones de curvas Bézier.

Esta propiedad se introdujo en Qt 6.6.

Estas propiedades contienen la posición inicial de la ruta.

Documentación del método

[since QtQuick 2.14] point pointAtPercent(real t)

Devuelve el punto en el porcentaje t de la ruta actual. El argumento t tiene que estar entre 0 y 1.

Este método se introdujo en QtQuick 2.14.

Véase también QPainterPath::pointAtPercent().