QCanvasPath Class

// m_path is QCanvasPath with lots of commands in it
const int pathGroup = 5;

// in every frame:
  painter->stroke(m_path, pathGroup);
  // ... other draw commands
  painter->translate(100, 0);
  painter->stroke(m_path, pathGroup);
  // ... other draw commands

// m_path is QCanvasPath with lots of commands in it
const int pathGroup = 5;

// in every frame:
  painter->setStrokeWidth(4);
  painter->stroke(m_path, pathGroup);
  // ... other draw commands
  painter->translate(100, 0);
  painter->setStrokeWidth(8);
  painter->stroke(m_path, pathGroup);
  // ... other draw commands

멤버 함수 문서

QCanvasPath::QCanvasPath()

빈 경로를 생성합니다.

[explicit] QCanvasPath::QCanvasPath(qsizetype commandsSize, qsizetype commandsDataSize = -1)

빈 경로를 생성하며, commandsSize 개수의 명령어와 선택적으로 commandsDataSize 개수의 데이터에 대한 공간을 할당합니다. commandsDataSize 매개변수가 지정되지 않으면, 2 * commandsSize 개수의 데이터에 대한 공간이 자동으로 예약되는데, 이는 경로 명령어가 직선(moveTo(), lineTo(), rect())일 때 최적의 양입니다.

적절한 공간을 확보하는 것은 경로 생성 및 메모리 사용에 대한 최적화입니다. 경로에 명령을 추가하는 동안 충분한 공간이 자동으로 확보되므로, 이는 필수 사항은 아닙니다.

reserve()도 참조하십시오 .

QCanvasPath::QCanvasPath(const QCanvasPath &path)

주어진 ` path`의 복사본인 경로를 생성합니다.

[noexcept] QCanvasPath::QCanvasPath(QCanvasPath &&other)

other 에서 새로운 QCanvasPath를 생성합니다.

[noexcept] QCanvasPath::~QCanvasPath()

경로를 삭제합니다.

[since 6.12] void QCanvasPath::addPath(QStringView svgPath, const QTransform &transform = QTransform())

이 경로에 ` svgPath `를 추가하며, 선택적으로 ` transform `를 사용하여 경로 지점을 수정할 수 있습니다. 경로의 예상 크기가 알려진 경우, 이 작업 전에 ` reserve()`를 호출하는 것을 고려해 보십시오.

이 형식에 대한 자세한 내용은 W3C SVG 경로 데이터를 참조하십시오.

이 함수는 Qt 6.12에서 도입되었습니다.

void QCanvasPath::addPath(const QCanvasPath &path, const QTransform &transform = QTransform())

이 경로에 ` path `을 추가하며, 선택적으로 ` transform `을 사용하여 경로 지점을 변경할 수 있습니다. ` transform `이 지정되지 않았거나(또는 단위 행렬인 경우), 이 연산은 경로 데이터를 재사용하므로 매우 빠르게 수행됩니다.

void QCanvasPath::addPath(const QCanvasPath &path, qsizetype start, qsizetype count, const QTransform &transform = QTransform())

start 에 있는 명령어부터 시작하여, count 만큼의 명령어를 포함하여 path 를 현재 경로에 추가합니다. 선택적으로 transform 를 사용하여 경로 지점을 변경할 수 있습니다. start 와 count 의 범위가 확인되므로, QCanvasPath::commandsSize()보다 더 많은 명령어에 접근하지 않습니다. 경로가 현재 경로 위치에서 이어지지 않아야 하는 경우, 먼저 path.positionAt(start - 1) 를 인수로 지정하여 moveTo()를 호출하십시오.

void QCanvasPath::arc(qreal centerX, qreal centerY, qreal radius, qreal a0, qreal a1, QCanvasPainter::PathWinding direction = QCanvasPainter::PathWinding::ClockWise, QCanvasPainter::PathConnection connection = QCanvasPainter::PathConnection::Connected)

QPointF(centerX, centerY)를 중심으로, 주어진 radius 를 사용하여 a0 라디안의 각도에서 시작하여 a1 라디안의 각도에서 끝나는 호를 생성합니다. 이 호는 주어진 direction 를 가로지릅니다. connection 가 NotConnected 일 경우, 이전 경로는 닫히고 새로운 하위 경로가 시작됩니다.

void QCanvasPath::arc(QPointF centerPoint, qreal radius, qreal a0, qreal a1, QCanvasPainter::PathWinding direction = QCanvasPainter::PathWinding::ClockWise, QCanvasPainter::PathConnection connection = QCanvasPainter::PathConnection::Connected)

centerPoint 를 중심으로, 주어진 radius 를 사용하여 a0 라디안의 각도에서 시작하여 a1 라디안에서 끝나는 호를 생성합니다. 이 호는 주어진 direction 를 가로지릅니다. connection 가 NotConnected 일 때, 이전 경로는 닫히고 새로운 하위 경로가 시작됩니다.

void QCanvasPath::arcTo(qreal x1, qreal y1, qreal x2, qreal y2, qreal radius)

QPointF(x1, y1) 및 QPointF(x2, y2) 지점을 사용하여, 주어진 radius 값으로 호를 생성합니다.

void QCanvasPath::arcTo(QPointF point1, QPointF point2, qreal radius)

point1 및 point2 좌표를 사용하여, 주어진 radius 값으로 호를 생성합니다.

void QCanvasPath::beginHoleSubPath()

홀 서브 경로를 시작합니다. 이는 ` setPathWinding(QCanvasPainter::PathWinding::ClockWise))`과 동일합니다.

beginSolidSubPath()도 참조하십시오 .

void QCanvasPath::beginSolidSubPath()

고체 서브패스를 시작합니다. 이는 setPathWinding(QCanvasPainter::PathWinding::CounterClockWise))와 동일합니다.

beginHoleSubPath()도 참조하십시오 .

void QCanvasPath::bezierCurveTo(qreal cp1X, qreal cp1Y, qreal cp2X, qreal cp2Y, qreal x, qreal y)

cp1X, cp1Y, cp2X, cp2Y 로 지정된 제어점을 사용하여, 현재 위치와 x 및 y 로 지정된 종점 사이에 3차 베지어 곡선을 추가합니다.

곡선이 추가된 후, 현재 위치는 곡선의 끝점에 오도록 업데이트됩니다.

void QCanvasPath::bezierCurveTo(QPointF controlPoint1, QPointF controlPoint2, QPointF endPoint)

controlPoint1 와 controlPoint2 에서 지정한 제어점을 사용하여, 현재 위치와 지정된 endPoint 사이에 3차 베지어 곡선을 추가합니다.

곡선이 추가된 후, 현재 위치는 곡선의 끝점에 오도록 업데이트됩니다.

void QCanvasPath::circle(qreal x, qreal y, qreal radius)

QPointF(x, y)를 중심으로 하고, 지정된 radius 를 가진 원을 경로에 추가합니다.

void QCanvasPath::circle(QPointF centerPoint, qreal radius)

centerPoint 를 중심으로 하고, 지정된 radius 를 반지름으로 하는 원을 경로에 추가합니다.

void QCanvasPath::clear()

경로 명령어와 데이터를 지웁니다.

경로 명령어가 변경되어 경로를 다시 생성해야 할 때 이 함수를 호출하십시오. 이 함수는 메모리 사용량에 영향을 미치지 않으므로, 메모리 사용량 관리를 위해서는 reserve() 및 squeeze()를 사용하십시오.

reserve() 및 squeeze()도 참조하십시오 .

void QCanvasPath::closePath()

현재 하위 경로의 시작 지점까지 선을 그려 해당 하위 경로를 닫고, 자동으로 새로운 경로를 시작합니다.

qsizetype QCanvasPath::commandsCapacity() const

경로에 있는 명령어의 용량을 반환합니다.

commandsDataCapacity() 및 reserve()도 참조하십시오 .

qsizetype QCanvasPath::commandsDataCapacity() const

지정된 경로에 있는 commands 데이터의 용량을 반환합니다.

commandsCapacity() 및 reserve()도 참조하십시오 .

qsizetype QCanvasPath::commandsDataSize() const

경로에 포함된 명령 데이터의 양을 반환합니다.

명령 데이터란 기본적으로 명령을 실행하는 데 필요한 포인트를 의미합니다.

qsizetype QCanvasPath::commandsSize() const

경로에 포함된 명령어의 수를 반환합니다.

QPointF QCanvasPath::currentPosition() const

경로의 현재 위치를 반환합니다. 이는 이전 경로 명령어(moveTo, lineTo, bezierCurveTo 등)가 종료된 위치를 의미합니다. 경로가 비어 있을 경우 (0.0, 0.0)을 반환합니다.

void QCanvasPath::ellipse(qreal x, qreal y, qreal radiusX, qreal radiusY)

(x, y)를 중심으로, 반지름이 radiusX, radiusY 로 정의된 타원을 생성하고, 이를 닫힌 하위 경로로 경로에 추가합니다.

void QCanvasPath::ellipse(const QRectF &rect)

rect 사각형 내에 타원을 생성하고, 이를 닫힌 하위 경로로 경로에 추가합니다.

bool QCanvasPath::isEmpty() const

경로가 비어 있을 때 true를 반환합니다.

clear도 참조하십시오 .

void QCanvasPath::lineTo(QPointF point)

현재 위치에서 지정된 좌표 point 까지 직선을 그립니다. 선이 그려진 후, 현재 위치는 선의 끝점 위치로 업데이트됩니다.

void QCanvasPath::lineTo(qreal x, qreal y)

현재 위치에서 점 (x, y)까지 선을 그립니다.

void QCanvasPath::moveTo(QPointF point)

현재 지점을 지정된 point 로 이동하며, 암시적으로 새로운 하위 경로를 시작하고 이전 경로를 닫습니다.

void QCanvasPath::moveTo(qreal x, qreal y)

현재 위치를 (x, y)로 이동하고 새로운 하위 경로를 시작하며, 이전 경로는 암시적으로 닫습니다.

QPointF QCanvasPath::positionAt(qsizetype index) const

index 에서 경로의 위치를 반환합니다. 이는 index 에서 path 명령어(moveTo, lineTo, bezierCurveTo 등)가 위치한 위치를 의미합니다. 인덱스는 0 과 commandsSize() - 1 사이여야 합니다. 경로가 비어 있을 경우 (0.0, 0.0)을 반환합니다.

void QCanvasPath::quadraticCurveTo(qreal cpX, qreal cpY, qreal x, qreal y)

현재 점과 끝점(x, y) 사이에, (cpX, cpY)로 지정된 제어점을 갖는 2차 베지어 곡선을 추가합니다.

void QCanvasPath::quadraticCurveTo(QPointF controlPoint, QPointF endPoint)

현재 위치와 지정된 endPoint 사이에, controlPoint 로 지정된 제어점을 사용하여 2차 베지어 곡선을 추가합니다.

void QCanvasPath::rect(qreal x, qreal y, qreal width, qreal height)

QPointF(x, y) 위치에, 지정된 width 및 height 값을 가진 사각형을 생성합니다.

void QCanvasPath::rect(const QRectF &rect)

다음으로 지정된 사각형을 생성합니다. rect

void QCanvasPath::reserve(qsizetype commandsSize, qsizetype commandsDataSize = -1)

QCanvasPath 의 내부 메모리에서 지정된 양의 공간을 할당합니다.

최소 commandsSize 개의 명령어와 commandsDataSize 개의 데이터 포인트에 대한 메모리를 할당하려고 시도합니다. 일부 경로 요소는 여러 개의 명령어를 필요로 하므로, commandsSize() 및 commandsDataSize()를 참조하십시오.

commandsDataSize 가 지정되지 않은 경우, 2 * commandsSize 의 데이터 양에 대한 공간이 자동으로 예약되며, 이는 경로 명령어가 직선일 때(moveTo(), lineTo(), rect())의 최적 양입니다.

적절한 공간을 확보하는 것은 경로 생성 및 메모리 사용량을 최적화하기 위한 조치입니다. 경로에 명령을 추가하는 과정에서 충분한 공간이 자동으로 확보되므로, 반드시 지정해야 하는 것은 아닙니다.

squeeze(), commandsCapacity() 및 commandsDataCapacity()도 참조하십시오 .

void QCanvasPath::roundRect(qreal x, qreal y, qreal width, qreal height, qreal radius)

지정된 직사각형 x, y, width, height 을 모서리가 둥근 형태로 경로에 추가합니다. 모서리는 지정된 radius 값을 가진 1/4 원으로 처리됩니다.

void QCanvasPath::roundRect(qreal x, qreal y, qreal width, qreal height, qreal radiusTopLeft, qreal radiusTopRight, qreal radiusBottomRight, qreal radiusBottomLeft)

모서리가 둥근 사각형 x, y, width, height 을 경로에 추가합니다. 모서리는 각각 반지름 radiusTopLeft, radiusTopRight, radiusBottomRight, radiusBottomLeft 인 1/4원입니다.

void QCanvasPath::roundRect(const QRectF &rect, qreal radius)

지정된 직사각형 rect 의 모서리를 둥글게 처리하여 경로에 추가합니다. 모서리는 지정된 반지름 radius 을 가진 1/4원 모양입니다.

void QCanvasPath::roundRect(const QRectF &rect, qreal radiusTopLeft, qreal radiusTopRight, qreal radiusBottomRight, qreal radiusBottomLeft)

모서리가 둥근 사각형 rect 을 경로에 추가합니다. 모서리는 각각 반지름 radiusTopLeft, radiusTopRight, radiusBottomRight, radiusBottomLeft 인 1/4 원으로 구성됩니다.

void QCanvasPath::setPathWinding(QCanvasPainter::PathWinding winding)

현재 서브 경로 winding 를 QCanvasPainter::CounterClockWise (기본값) 또는 QCanvasPainter::ClockWise 중 하나로 설정합니다. CounterClockWise는 채워진 서브 경로를 그리고, ClockWise는 구멍을 그립니다.

QCanvasPath QCanvasPath::sliced(qsizetype start, qsizetype count, const QTransform &transform = QTransform()) const

이 경로의 명령어를 포함하는 새로운 경로를 반환하며, start 에 있는 명령어부터 시작하여 count 개수의 명령어를 포함하고, 선택적으로 transform 를 사용하여 경로 지점을 변경할 수 있습니다.

start 과 count 의 범위가 확인되어, commandsSize()보다 더 많은 명령에 접근하지 않도록 합니다. start 에 있는 명령이 MoveTo 가 아닌 경우, 이 슬라이스가 독립적인 경로가 되도록 첫 번째 명령이 MoveTo 로 대체됩니다.

void QCanvasPath::squeeze()

경로 명령어와 데이터를 저장하는 데 필요하지 않은 메모리를 해제합니다. 이 함수는 reserve()를 호출한 후 메모리 사용량을 줄이는 데 사용할 수 있습니다.

일반적으로 이 함수를 사용할 필요는 없지만, 많은 요소를 예약하거나 추가(lineTo, bezierCurveTo 등)하여 경로 크기가 커진 경우, 향후 크기가 훨씬 작아질 것으로 예상된다면 먼저 reserve() 를 호출한 다음 squeeze() 를 호출하여 일부 메모리를 해제할 수 있습니다.

reserve()도 참조하십시오 .

[noexcept] void QCanvasPath::swap(QCanvasPath &other)

이 경로를 ` other`로 바꿉니다. 이 작업은 매우 빠르며 절대 실패하지 않습니다.

QCanvasPath::operator QVariant() const

경로를 ` QVariant` 형식으로 반환합니다.

[noexcept] QCanvasPath &QCanvasPath::operator=(QCanvasPath &&other)

other 를 이 QCanvasPath 인스턴스에 할당합니다.

QCanvasPath &QCanvasPath::operator=(const QCanvasPath &path)

지정된 path 를 이 경로에 할당하고, 이 경로에 대한 참조를 반환합니다.