Shape QML Type

경로를 렌더링합니다. 더 보기...

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

속성

• asynchronous : bool
• boundingRect : rect (since 6.6)
• containsMode : enumeration (since QtQuick.Shapes 1.11)
• data : list<Object>
• fillMode : enumeration (since QtQuick.Shapes 6.7)
• horizontalAlignment : enumeration (since 6.7)
• preferredRendererType : enumeration (since 6.6)
• rendererType : enumeration
• status : enumeration
• vendorExtensionsEnabled : bool
• verticalAlignment : enumeration (since 6.7)

상세 설명

QPainterPath 에서 지오메트리를 삼각 측량하여 경로를 렌더링합니다.

이 접근 방식은 소프트웨어에서 경로가 래스터화되지 않기 때문에 QQuickPaintedItem 또는 2D 캔버스를 통해 셰이프를 렌더링하는 것과 다릅니다. 따라서 셰이프는 텍스처 업로드 또는 프레임 버퍼 블릿으로 인한 성능 저하를 피하면서 화면의 넓은 영역에 퍼지는 셰이프를 만드는 데 적합합니다. 또한 선언적 API를 사용하면 시작 및 종료 위치, 제어점 등과 같은 경로 요소 속성을 조작하고, 바인딩하고, 애니메이션을 적용할 수도 있습니다.

경로 요소를 지정하는 유형은 PathView 와 Shape 간에 공유됩니다. 그러나 모든 셰이프 구현이 모든 경로 요소 유형을 지원하는 것은 아니며, 일부는 PathView 에 적합하지 않을 수 있습니다. Shape의 현재 지원되는 하위 집합은 PathMove, PathLine, PathQuad, PathCubic, PathArc, PathText 및 PathSvg 입니다.

지원되는 경로 요소에 대한 자세한 개요는 Path 을 참조하세요.

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

Item 와 마찬가지로 셰이프는 모든 시각적 또는 비시각적 객체를 자식으로 선언할 수 있습니다. ShapePath 객체는 특별히 처리됩니다. 이는 Rectangle 또는 Image 과 같은 시각적 항목과 Timer 과 같은 비시각적 객체를 Shape의 자식으로 직접 추가할 수 있으므로 유용합니다.

다음 목록에는 사용 가능한 셰이프 렌더링 접근 방식이 요약되어 있습니다:

• Qt Quick 가 기본 하드웨어 가속 백엔드(RHI)로 실행되는 경우 일반 셰이프 렌더러가 사용됩니다. 이렇게 하면 도형이 삼각형으로 변환되어 렌더러에 전달됩니다.
• software 백엔드가 완벽하게 지원됩니다. 이 경우 경로는 QPainter::strokePath() 및 QPainter::fillPath()을 통해 렌더링됩니다.
• OpenVG 백엔드는 현재 지원되지 않습니다.

셰이프를 사용할 때는 성능에 영향을 미칠 수 있는 잠재적인 사항을 인지하는 것이 중요합니다:

• 애플리케이션이 일반적인 삼각 측량 기반 셰이프 구현으로 실행되는 경우, 지오메트리 생성은 전적으로 CPU에서 이루어집니다. 이는 잠재적으로 비용이 많이 들 수 있습니다. 경로 요소 집합을 변경하거나 이러한 요소의 속성을 변경하거나 셰이프 자체의 특정 속성을 변경하면 변경할 때마다 영향을 받는 경로를 다시 삼각 측량해야 합니다. 따라서 이러한 속성에 애니메이션을 적용하면 성능이 낮은 시스템에서는 성능에 영향을 미칠 수 있습니다.
• 그러나 셰이프 API의 데이터 중심적이고 선언적인 특성으로 인해 기본 CPU 및 GPU 리소스에 대한 캐시 성능이 향상되는 경우가 많습니다. ShapePath 의 프로퍼티를 변경하면 영향을 받는 ShapePath 만 재처리되고 셰이프의 다른 부분은 변경되지 않습니다. 따라서 프로퍼티를 자주 변경해도 필수 페인팅 접근 방식(예: QPainter)보다 전체 시스템 부하가 낮아질 수 있습니다.
• 동시에 씬에 있는 셰이프 요소의 수에도 주의를 기울여야 합니다. 이러한 셰이프 항목이 씬 그래프에 표시되는 방식은 일반적인 지오메트리 기반 항목과 다르며 OpenGL 상태 변경과 관련하여 특정 비용이 발생합니다.
• 일반적으로 씬에서는 꼭 필요한 경우가 아니라면 별도의 셰이프 항목을 사용하지 않는 것이 좋습니다. 여러 개의 셰이프 항목보다는 여러 개의 ShapePath 요소와 함께 하나의 셰이프 항목을 사용하는 것이 좋습니다.

Qt Quick 예제 - 도형, 일기 예보 예제, Path, PathMove, PathLine, PathQuad, PathCubic, PathArc, PathSvg 를참조하세요 .

속성 문서