ShapePath QML Type

스트로크 및 채우기를 위한 경로 및 관련 속성을 설명합니다. 더 보기...

Import Statement: import QtQuick.Shapes 1.8
Inherits:

Path

속성

상세 설명

Shape 에는 하나 이상의 ShapePath 요소가 포함되어 있습니다. 셰이프가 표시되는 모든 것을 출력하려면 하나 이상의 ShapePath가 필요합니다. ShapePath 자체는 획 너비 및 색상, 채우기 색상 또는 그라데이션, 조인 및 캡 스타일 등과 같은 획 및 채우기 매개 변수를 설명하는 추가 속성을 가진 Path 입니다. 일반적인 Path 객체와 마찬가지로 ShapePath에는 시작 위치와 함께 PathMove, PathLine, PathCubic, PathQuad, PathArc 와 같은 경로 요소 목록도 포함됩니다.

이러한 데이터 세트의 모든 속성 변경은 버블로 표시되어 셰이프의 출력을 변경합니다. 즉, 시작 및 종료 위치, 제어점, 스트로크 또는 채우기 매개변수, 또는 NumberAnimation 와 같은 일반적인 QML 바인딩 및 애니메이션 유형을 사용하여 간단하고 쉽게 변경하거나 애니메이션을 적용할 수도 있습니다.

다음 예제에서 선 조인 스타일은 joinStyleIndex의 값에 따라 자동으로 변경됩니다:

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 }
}

셰이프에 연결되면 joinStyleIndex가 2(ShapePath.RoundJoin)인 출력은 다음과 같습니다:

Qt Quick 예제 - 도형, 일기 예보 예제Shape참조하십시오 .

속성 문서

capStyle : enumeration

이 속성은 선의 끝점을 그리는 방법을 정의합니다. 기본값은 ShapePath.SquareCap 입니다.

Constant설명
ShapePath.FlatCap선의 끝점을 덮지 않는 정사각형 선 끝점입니다.
ShapePath.SquareCap선의 끝점을 덮고 그 너비의 절반만큼 연장되는 정사각형 선 끝입니다.
ShapePath.RoundCap둥근 선 끝.

dashOffset : real

이 속성은 대시 패턴의 시작점을 정의하며, 대시 패턴을 지정하는 데 사용되는 단위로 측정됩니다.

기본값은 0입니다.

QPen::setDashOffset()도 참조하십시오 .


dashPattern : list<real>

이 속성은 ShapePath.strokeStyleShapePath.DashLine으로 설정된 경우 대시 패턴을 정의합니다. 패턴은 1, 3, 5... 항목이 대시이고 2, 4, 6... 항목이 공백인 짝수의 양수 항목으로 지정해야 합니다. 패턴은 펜 너비 단위로 지정됩니다.

기본값은 (4, 2)로, 4 * ShapePath.strokeWidth 픽셀의 대시와 2 * ShapePath.strokeWidth 픽셀의 공백을 의미합니다.

QPen::setDashPattern()도 참조하세요 .


fillColor : color

이 속성은 채우기 색상을 보유합니다.

transparent 로 설정하면 채우기가 발생하지 않습니다.

기본값은 white 입니다.

참고: fillGradient 또는 fillItemnull 이 아닌 다른 값으로 설정된 경우 이 fillColor 보다 우선합니다. 이 경우 fillColor 은 무시됩니다.


fillGradient : ShapeGradient

이 속성은 채우기 그라데이션을 정의합니다. 기본적으로 그라데이션은 활성화되지 않으며 값은 null 입니다. 이 경우 채우기는 fillItem 속성이 설정되어 있으면 이를 기반으로 하고 그렇지 않으면 fillColor 속성이 사용됩니다.

참고: 여기에서는 그라데이션 유형을 사용할 수 없습니다. 대신 LinearGradient 와 같은 고급 하위 유형 중 하나를 사용하는 것이 좋습니다.

참고: null 이외의 다른 것으로 설정하면 fillGradientfillItemfillColor 보다 우선합니다.


fillItem : Item [since 6.8]

이 속성은 도형으로 채우기로 사용할 또 다른 Qt Quick 항목을 정의합니다. 이 항목은 텍스처 공급자(예: layered item, ShaderEffectSource 또는 Image)여야 합니다. 유효한 텍스처 공급자가 아닌 경우 이 속성은 무시됩니다.

fillItem 의 시각적 부모는 Qt Quick Item 여야 합니다. 특히 ShapePathItem 이 아니므로 그 자식은 채우기 항목으로 사용할 수 없습니다. ShapePath 의 자식으로 생성된 경우 fillItem 의 부모를 수동으로 설정해야 합니다.

예를 들어 fillItem 속성 할당에서 직접 Image 개체를 만들면 ShapePath 의 자식이 됩니다. 이 경우 부모를 수동으로 설정해야 합니다. 다음 예에서는 창의 contentItem 을 부모로 사용합니다.

fillItem: Image {
    visible: false
    source: "contents.png"
    parent: window.contentItem
}

참고: 레이어된 항목을 fillItem 로 사용하는 경우 채우기를 변형할 때 픽셀화 효과가 나타날 수 있습니다. 이 경우 layer.smooth 속성을 true로 설정하면 더 나은 시각적 결과를 얻을 수 있습니다.

기본적으로 채우기 항목은 설정되어 있지 않으며 값은 null 입니다.

참고: null 이외의 다른 값으로 설정하면 fillItem 속성이 fillColor 속성보다 우선합니다. fillGradient 속성은 차례로 fillItemfillColor 보다 우선합니다.

이 프로퍼티는 Qt 6.8에 도입되었습니다.


fillRule : enumeration

이 프로퍼티는 채우기 규칙을 보유합니다. 기본값은 ShapePath.OddEvenFill 입니다. 채우기 규칙에 대한 설명은 QPainterPath::setFillRule()를 참조하십시오.

Constant설명
ShapePath.OddEvenFill홀수 짝수 채우기 규칙.
ShapePath.WindingFill0이 아닌 와인딩 채우기 규칙입니다.

fillTransform : matrix4x4 [since 6.8]

이 속성은 경로의 채우기 패턴에 적용할 변환을 정의합니다(fillGradient 또는 fillItem). 채우기가 단색이거나 투명한 경우 효과가 없습니다. 기본적으로 채우기 변환은 활성화되지 않으며 이 속성의 값은 identity 행렬입니다.

이 예제에서는 myShape 의 중심점을 중심으로 45도 회전한 myImageItem 의 내용으로 채워진 직사각형을 표시합니다:

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 }
}

이 프로퍼티는 Qt 6.8에 도입되었습니다.


joinStyle : enumeration

이 프로퍼티는 연결된 두 선 사이의 조인 방법을 정의합니다. 기본값은 ShapePath.BevelJoin 입니다.

Constant설명
ShapePath.MiterJoin선의 바깥쪽 가장자리가 비스듬히 만나도록 확장되고 이 영역이 채워집니다.
ShapePath.BevelJoin두 선 사이의 삼각형 노치가 채워집니다.
ShapePath.RoundJoin두 선 사이의 원형 호가 채워집니다.

miterLimit : int

joinStyleShapePath.MiterJoin 로 설정된 경우 이 속성은 마이터 조인이 조인 지점에서 얼마나 멀리 확장될 수 있는지 지정합니다.

기본값은 2입니다.


pathHints : PathHints [since 6.7]

이 속성은 도형의 특성을 설명합니다. 설정하면 이러한 힌트를 통해 렌더링을 최적화할 수 있습니다. 기본적으로 힌트는 설정되지 않습니다. 다음 값의 조합일 수 있습니다:

상수설명
ShapePath.PathLinear경로에 직선만 있고 곡선은 없습니다.
ShapePath.PathQuadratic경로에 직선과 이차 베지어 곡선만 있고 큐빅 곡선은 없습니다.
ShapePath.PathConvex경로에 움푹 들어간 곳이나 구멍이 없습니다. 도형 내부의 두 점 사이의 모든 직선은 도형 내부에 완전히 들어갑니다.
ShapePath.PathFillOnRight경로는 솔리드 채우기 주변의 윤곽선은 제어점이 시계 방향으로 정렬되고 도형의 구멍 주변의 윤곽선은 제어점이 반시계 방향으로 정렬되는 트루타입 규칙을 따릅니다.
ShapePath.PathSolid경로에는 구멍이 없거나 수학적으로 말하면 단순히 연결되어 있습니다.
ShapePath.PathNonIntersecting경로 윤곽선은 자체적으로 교차하지 않습니다.
ShapePath.PathNonOverlappingControlPointTriangles커브 제어점으로 정의된 삼각형은 서로 또는 어떤 선분과도 겹치지 않습니다. 또한 선분도 교차하지 않습니다. 이는 PathNonIntersecting 을 의미합니다.

모든 힌트가 논리적으로 독립적이지는 않지만 종속성은 강제되지 않습니다. 예를 들어 PathLinearPathQuadratic 을 의미하지만 PathLinearPathQuadratic 없이도 유효합니다.

경로 힌트 속성은 참으로 알려진 문 집합을 설명하며, 힌트가 없다고 해서 해당 문이 반드시 거짓이라는 의미는 아닙니다.

이 프로퍼티는 Qt 6.7에 도입되었습니다.


strokeColor : color

이 속성은 스트로킹 색을 보유합니다.

transparent 로 설정하면 스트로킹이 발생하지 않습니다.

기본값은 white 입니다.


strokeStyle : enumeration

이 속성은 스트로킹 스타일을 정의합니다. 기본값은 ShapePath.SolidLine입니다.

Constant설명
ShapePath.SolidLine일반 선입니다.
ShapePath.DashLine몇 픽셀로 구분된 대시.

strokeWidth : real

이 속성은 획 너비를 보유합니다.

음수 값으로 설정하면 스트로크가 발생하지 않습니다.

기본값은 1입니다.


© 2025 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.