path2d QML Value Type
QCanvasPath 에 부합하는 페인터 경로 컨테이너인 path2d 유형을 제공합니다. 더 보기...
| Import Statement: | import QtCanvas2D |
| Since: | Qt 6.12 |
| Status: | Technology preview |
이 타입은 기술 미리보기 단계에 있으며 변경될 수 있습니다.
메서드
- void addPath(path2d path, transform2d transform)
- void addPath(string svgPath, transform2d transform)
- void addPath(path2d path, int start, int count, transform2d transform)
- void arc(real x, real y, real radius, real startAngle, real endAngle, bool counterClockWise)
- void arcTo(real x1, real y1, real x2, real y2, real radius)
- void beginHoleSubPath()
- void beginSolidSubPath()
- void bezierCurveTo(real cp1x, real cp1y, real cp2x, real cp2y, real x, real y)
- void circle(real x, real y, real radius)
- void clear()
- void closePath()
- void ellipse(real x, real y, real radiusX, real radiusY)
- void ellipseRect(real x, real y, real width, real height)
- bool isEmpty()
- void lineTo(real x, real y)
- void moveTo(real x, real y)
- void quadraticCurveTo(real cpx, real cpy, real x, real y)
- void rect(real x, real y, real width, real height)
- void roundRect(real x, real y, real width, real height, real radius)
- void roundRect(real x, real y, real width, real height, real radiusTopLeft, real radiusTopRight, real radiusBottomRight, real radiusBottomLeft)
- void setPathWinding(const QString &winding)
상세 설명
이 값 유형은 ` QtCanvas2D ` 임포트에서 제공됩니다.
QCanvasPath도 참조하십시오 .
메서드 문서
void addPath(path2d path, transform2d transform)
transform 를 변환 행렬로 사용하여 이 경로에 path 를 추가합니다. transform 매개변수의 지정은 선택 사항입니다.
void addPath(string svgPath, transform2d transform)
transform 를 변환 행렬로 사용하여 이 경로에 svgPath 를 추가합니다. transform 매개변수를 지정하는 것은 선택 사항입니다.
![]() | |
void addPath(path2d path, int start, int count, transform2d transform)
start 에 있는 명령어부터 시작하여 count 개 분량의 명령어를 포함하도록, 현재 경로에 path 를 추가합니다. 선택적으로 transform 를 사용하여 경로 지점을 변경할 수 있습니다. start 와 count 의 범위를 확인하여, 경로에 포함된 명령어 수보다 더 많은 명령어에 접근하지 않도록 합니다. 경로가 현재 위치에서 이어지지 않아야 하는 경우, 먼저 moveTo()를 호출하십시오.
void arc(real x, real y, real radius, real startAngle, real endAngle, bool counterClockWise)
현재 서브 경로에, 중심이 점 (x, y)에 있고 반지름이 radius 인 원의 원주 위에 놓이는 호를 추가합니다.
startAngle 와 endAngle 는 모두 x축을 기준으로 라디안 단위로 측정됩니다.
기본 곡선 방향은 시계 방향입니다. 방향을 반대 방향으로 변경하려면 counterClockWise 를 true로 설정하십시오.
void arcTo(real x1, real y1, real x2, real y2, real radius)
시작점(x1, y1), 끝점(x2, y2) 및 radius 을 가진 호를 현재 하위 경로에 추가하고, 이를 직선으로 이전 하위 경로와 연결합니다.
void beginHoleSubPath()
구멍 하위 경로를 시작합니다.
void beginSolidSubPath()
견고한 하위 경로를 시작하세요.
void bezierCurveTo(real cp1x, real cp1y, real cp2x, real cp2y, real x, real y)
(cp1x, cp1y) 및 (cp2x, cp2y)로 지정된 제어점을 사용하여 현재 위치와 주어진 끝점 사이에 3차 베지어 곡선을 추가합니다. 곡선이 추가된 후, 현재 위치는 곡선의 끝점(x, y)으로 업데이트됩니다.
void circle(real x, real y, real radius)
중심(x, y)과 반지름 radius 으로 정의된 원을 생성하고, 이를 닫힌 부분 경로로 경로에 추가합니다.
참고: arc()와달리 , 이 메서드는 하위 경로의 마지막 점에서 원의 시작점까지 이어지는 직선을 추가하지 않습니다.
void clear()
모든 그리기 명령을 모두 지웁니다.
isEmpty()도 참조하십시오 .
void closePath()
현재 하위 경로의 시작점으로 선을 그려 해당 하위 경로를 종료하고, 자동으로 새로운 경로를 시작합니다. 새로운 경로의 현재 점은 이전 하위 경로의 첫 번째 점이 됩니다.
void ellipse(real x, real y, real radiusX, real radiusY)
radiusX 와 radiusY 를 사용하여 중심( x, y)을 기준으로 새로운 타원형 하위 경로를 생성합니다.
이 타원은 0도(3시 방향)에서 시작하여 0도에서 끝나는 시계 방향 곡선으로 구성됩니다.
void ellipseRect(real x, real y, real width, real height)
(x, y)를 좌상단 모서리로, 너비 width, 높이 height 로 정의된 경계 사각형 내에 타원을 생성하고, 이를 닫힌 하위 경로로 경로에 추가합니다.
이 타원은 0도(3시 방향)에서 시작하여 0도로 끝나는 시계 방향 곡선으로 구성됩니다.
참고: 이 메서드는 ` QtQuick::Context2D::ellipse()`와 동일합니다.
bool isEmpty()
경로에 그리기 명령이 하나도 포함되어 있지 않을 때 true를 반환합니다.
clear()도 참조하십시오 .
void lineTo(real x, real y)
현재 위치에서 (x, y)에 있는 점까지 선을 그립니다.
void moveTo(real x, real y)
(x, y) 지점을 갖는 새로운 하위 경로를 생성합니다.
void quadraticCurveTo(real cpx, real cpy, real x, real y)
현재 점과 끝점(x, y) 사이에, (cpx, cpy)로 지정된 제어점을 갖는 2차 베지어 곡선을 추가합니다.
void rect(real x, real y, real width, real height)
(x, y) 위치에, 지정된 너비 width 와 높이 height 를 가진 사각형을 닫힌 부분 경로로 추가합니다.
void roundRect(real x, real y, real width, real height, real radius)
(x, y, width, height)로 지정된 모서리가 둥근 사각형을 경로에 추가합니다. radius 인수는 모서리가 둥근 사각형의 모서리를 정의하는 타원의 반지름을 지정합니다.
void roundRect(real x, real y, real width, real height, real radiusTopLeft, real radiusTopRight, real radiusBottomRight, real radiusBottomLeft)
(x, y, width, height)로 지정된 둥근 모서리 사각형을 경로에 추가합니다. radiusTopLeft, radiusTopRight, radiusBottomRight 및 radiusBottomLeft 인수는 둥근 사각형의 모서리를 정의하는 타원의 반지름을 지정합니다.
void setPathWinding(const QString &winding)
현재 하위 경로 winding 를 "counterclockwise" (기본값) 또는 "clockwise" 중 하나로 설정합니다. “counterclockwise”는 실선 하위 경로를 그리는 반면, “clockwise”는 구멍을 그립니다.
beginSolidSubPath() 및 beginHoleSubPath()도 참조하십시오 .
© 2026 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.
