Path QML Type

PathView 및 Shape 에서 사용할 경로를 정의합니다. 더 보기...

• 상속된 멤버를 포함한 모든 멤버 목록

속성

• 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

방법

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

자세한 설명

경로는 하나 이상의 경로 세그먼트( PathLine, PathPolyline, PathQuad, PathCubic, PathArc, PathAngleArc, PathCurve, PathSvg)로 구성됩니다.

Path를 따라 항목 간의 간격은 PathPercent 객체를 통해 조정할 수 있습니다.

PathAttribute 이를 통해 경로를 따라 값이 지정된 명명된 속성을 정의할 수 있습니다.

Path 및 경로 요소를 지정하기 위한 다른 유형들은 PathView 와 Shape 간에 공유됩니다. 다음 표는 다양한 경로 요소의 적용 범위에 대한 개요를 제공합니다:

PathView, Shape, PathAttribute, PathPercent, PathLine, PathPolyline, PathMove, PathQuad, PathCubic, PathArc, PathAngleArc, PathCurve, PathSvg 및 PathRectangle도 참조하십시오 .

속성 설명서

asynchronous : bool [since 6.9]

true로 설정하면 경로가 비동기적으로 처리됩니다. 이는 경로에 영향을 줄 수 있는 모든 메서드가 실행된 후에 경로를 한 번만 처리하도록 하는 최적화 기능입니다. 즉, true 로 설정된 경우, 예를 들어 startX, scale 를 조정하거나 요소를 추가한 직후에는 업데이트된 경로를 즉시 사용할 수 없으며, Qt 이벤트 루프 처리가 완료된 후에야 사용할 수 있습니다. 기본값은 ` false`입니다.

이 속성은 Qt 6.9에서 도입되었습니다.

closed : bool [read-only]

이 속성은 경로의 시작점과 끝점이 동일한지 여부와 관계없이 성립합니다.

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

이 속성은 경로를 구성하는 객체들을 포함합니다.

경로에는 다음과 같은 경로 객체가 포함될 수 있습니다:

• PathLine - 지정된 위치로 이어지는 직선.
• PathPolyline - 좌표 목록으로 지정된 폴리라인.
• PathMultiline - 좌표 목록의 목록으로 지정된 폴리라인 목록.
• PathQuad - 제어점을 가진, 지정된 위치까지 이어지는 2차 베지어 곡선.
• PathCubic - 두 개의 제어점을 갖는, 지정된 위치까지 이어지는 3차 베지어 곡선.
• PathArc - 반지름이 지정된, 주어진 위치까지 이어지는 호.
• PathAngleArc - 중심점, 반지름 및 각도로 지정된 호.
• PathSvg - SVG 경로 데이터 문자열로 지정된 경로.
• PathRectangle - 지정된 위치와 크기를 갖는 직사각형
• PathCurve - 캣뮬-롬(Catmull-Rom) 곡선상의 점.
• PathAttribute - 경로 내 지정된 위치에 있는 속성.
• PathPercent - 경로의 다양한 세그먼트에 따라 항목을 분산시키는 방법.

    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]

이 속성은 경로의 배율 계수를 지정합니다. 이방성 배율을 구현하기 위해 scale 의 너비와 높이를 다르게 설정할 수 있습니다.

이 속성은 QtQuick 2.14에서 도입되었습니다.

simplify : bool [since 6.6]

true로 설정하면 경로가 단순화됩니다. 이는 교차하는 모든 하위 경로를 병합하여 자기 교차가 없는 경로를 생성함을 의미합니다. 연속된 평행선도 병합됩니다. 단순화된 경로는 ` ShapePath.OddEvenFill`과 함께 사용하도록 설계되었습니다. 베지어 곡선의 교차 처리에 따른 수치적 불안정성으로 인해 베지어 곡선이 선분으로 평탄화될 수 있습니다.

이 속성은 Qt 6.6에서 도입되었습니다.

이 속성들은 경로의 시작 위치를 나타냅니다.

메서드 설명

[since QtQuick 2.14] point pointAtPercent(real t)

현재 경로의 t 지점에 해당하는 점을 반환합니다. 인자 t 는 0과 1 사이여야 합니다.

이 메서드는 QtQuick 2.14에서 도입되었습니다.

QPainterPath::pointAtPercent()도 참조하십시오 .