QCanvasPainter Class

QRectF rect(40, 70, 120, 60);
QRectF shadowRect = rect.translated(2, 4);
// Paint shadow
QCanvasBoxShadow shadow(shadowRect);
shadow.setRadius(30);
shadow.setBlur(15);
shadow.setColor("#60373F26");
p->drawBoxShadow(shadow);
// Paint rounded rect
p->beginPath();
p->roundRect(rect, 30);
p->setFillStyle("#DBEB00");
p->fill();
// Paint text
p->setTextAlign(QCanvasPainter::TextAlign::Center);
p->setTextBaseline(QCanvasPainter::TextBaseline::Middle);
QFont font("Titillium Web", 18);
p->setFont(font);
p->setFillStyle("#373F26");
p->fillText("CLICK!", rect);

// Paint grid
QCanvasGridPattern grid(0, 0, 10, 10);
grid.setLineColor("#404040");
grid.setBackgroundColor("#202020");
p->setFillStyle(grid);
p->fillRect(0, 0, width(), height());
// Paint axis
p->setFillStyle(QColorConstants::White);
p->fillRect(0, 0.5 * height() - 1, width(), 2);
p->fillRect(0.5 * width() - 1, 0, 2, height());
// Paint shadowed graph
p->beginPath();
p->moveTo(20, height() * 0.8);
p->bezierCurveTo(width() * 0.2, height() * 0.4,
                 width() * 0.5, height() * 0.8,
                 width() - 20, height() * 0.2);
p->setAntialias(10);
p->setLineWidth(12);
p->setStrokeStyle("#D0000000");
p->stroke();
p->setAntialias(1);
p->setLineWidth(6);
QCanvasLinearGradient lg(0, 0, 0, height());
lg.setStartColor(QColorConstants::Red);
lg.setEndColor(QColorConstants::Green);
p->setStrokeStyle(lg);
p->stroke();

p->setWindingEnforce(false);
p->beginPath();
// Outer shape, counterclockwise
p->moveTo(20, 20);
p->lineTo(100, 180);
p->lineTo(180, 20);
p->closePath();
// Inner shape, clockwise
p->moveTo(100, 40);
p->lineTo(125, 90);
p->lineTo(75, 90);
p->closePath();
p->fill();
p->stroke();

p->beginPath();
p->roundRect(20, 20, 160, 160, 30);
// Start painting holes
p->beginHoleSubPath();
p->roundRect(40, 40, 120, 120, 10);
// Start painting solid
p->beginSolidSubPath();
p->rect(60, 60, 80, 20);
p->circle(100, 120, 20);
p->fill();
p->stroke();

멤버 함수 문서

QCanvasPainter::QCanvasPainter()

페인터를 생성합니다.

[noexcept] QCanvasPainter::~QCanvasPainter()

화가에게 치명적인 타격을 입힌다.

qsizetype QCanvasPainter::activeImageCount() const

이 QCanvasPainter 에 등록된 활성 QCanvasImage 객체의 개수를 반환합니다. 여기에는 gradients 를 위해 내부적으로 생성된 이미지들도 포함됩니다.

QCanvasImage QCanvasOffscreenCanvas 인스턴스를 등록하여 생성된 객체나 외부에서 관리되는 텍스처는 이 함수에서 고려되지 않습니다.

activeImageMemoryUsage(), addImage(), removeImage()도 참조하십시오 .

qsizetype QCanvasPainter::activeImageMemoryUsage() const

QImage 을 인수로 받는 addImage() 오버로드에 의해 생성된, 이 페인터에 대한 모든 활성 QCanvasImage 인스턴스의 이미지(픽셀) 데이터가 사용하는 메모리 양을 킬로바이트 단위로 대략적으로 반환합니다. 또한 gradients 을 위해 내부적으로 생성된 이미지의 데이터도 포함됩니다.

QCanvasPainter addImage()가 반환된 후에는 CPU 측의 데이터 사본을 유지하지 않습니다. 따라서 이 함수의 결과는 텍스처에 사용되는 GPU 메모리의 근사치입니다. QImage

다른 addImage() 오버로드들을 통해 등록된 오프스크린 캔버스와 외부에서 관리되는 텍스처는 이 함수에서 고려되지 않습니다.

유효한 모든 QCanvasImage 에 대해, sizeInBytes()를 호출하여 개별 크기를 바이트 단위로 항상 조회할 수 있습니다. 이 함수는 QCanvasImage 가 QCanvasOffscreenCanvas 또는 QRhiTexture 에서 생성된 경우에도 유효한 결과를 반환하지만, 밉맵(mipmap)이나 멀티샘플(multisample) 데이터는 고려하지 않습니다.

activeImageCount(), addImage(), removeImage()도 참조하십시오 .

QCanvasImage QCanvasPainter::addImage(const QImage &image, QCanvasPainter::ImageFlags flags = {})

image 를 추가하며, flags 를 페인터가 텍스처로 사용할 수 있게 합니다. 텍스처 ID 및 이미지에 대한 기타 정보가 포함된 QCanvasImage 를 반환합니다. 반환된 QCanvasImage 는 drawImage 및 QCanvasImagePattern 와 함께 사용할 수 있습니다. 이 메서드를 호출한 후에는 image QImage 를 메모리에 계속 보관할 필요가 없습니다.

동일한 image 를 사용하여 호출하는 것은 캐시 히트가 예상되므로 부하가 적은 작업입니다.

최적화 시 addImage()를 한 번만 호출하도록 주의해야 합니다. 애플리케이션 설계에 따라 이 방법만으로는 충분하지 않을 수 있습니다. 예를 들어, 위젯을 새로운 최상위 레벨로 이동하여 페인터가 내부적으로 새로운 QRhi 와 연결되는 등, 기본 그래픽 리소스가 손실된 경우, image 의 네이티브 그래픽 텍스처를 재 생성하기 위해서는 이 함수를 호출하는 것이 필수적입니다.

drawImage() 및 removeImage()도 참조하십시오 .

QCanvasImage QCanvasPainter::addImage(QRhiTexture *texture, QCanvasPainter::ImageFlags flags = {})

texture 를 추가하며, flags 를 페인터가 텍스처로 사용할 수 있도록 제공합니다. 반환된 QCanvasImage 는 drawImage 및 QCanvasImagePattern 와 함께 사용할 수 있습니다.

drawImage() 및 removeImage()도 참조하십시오 .

QCanvasImage QCanvasPainter::addImage(const QCanvasOffscreenCanvas &canvas, QCanvasPainter::ImageFlags flags = {})

canvas 를 flags 로 페인터에 등록하여 이미지 형태로 사용할 수 있도록 합니다. 반환된 QCanvasImage 는 drawImage 및 QCanvasImagePattern 와 함께 사용할 수 있습니다.

drawImage() 및 removeImage()도 참조하십시오 .

void QCanvasPainter::addPath(const QPainterPath &path)

현재 경로에 path 를 추가합니다.

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

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

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

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

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

새로운 원호 모양의 하위 경로를 생성합니다. 원호의 중심은 centerX, centerY 에 위치하며, 반지름은 radius 입니다. 원호는 각도 a0 에서 a1 까지 그려지며, direction (ClockWise 또는 CounterClockWise) 방향으로 스윕됩니다. connection 가 NotConnected 일 경우, 원호는 이전 경로 위치에서 원호의 시작점까지 선을 추가하지 않습니다. 각도는 라디안 단위로 지정됩니다.

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

새로운 원호 모양의 하위 경로를 생성합니다. 원호의 중심은 centerPoint 에 위치하며, 반지름은 radius 입니다. 원호는 각도 a0 에서 a1 까지 그려지며, direction (ClockWise 또는 CounterClockWise) 방향으로 스윕됩니다. connection 가 NotConnected 인 경우, 원호는 이전 경로 위치에서 원호의 시작점까지 선을 추가하지 않습니다. 각도는 라디안 단위로 지정됩니다.

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

마지막 경로 점과 지정된 두 점(x1, y1 및 x2, y2)을 연결하여 radius 의 각도로 모서리에 호 세그먼트를 추가합니다. 필요한 경우, 이 호는 경로의 가장 최근 점과 직선으로 자동 연결됩니다.

void QCanvasPainter::arcTo(QPointF controlPoint1, QPointF controlPoint2, qreal radius)

마지막 경로 점과 지정된 두 점(controlPoint1, controlPoint2)을 기준으로 radius 각도로 호 세그먼트를 모서리에 추가합니다. 필요한 경우, 이 호는 경로의 가장 최근 점과 직선으로 자동 연결됩니다.

void QCanvasPainter::beginHoleSubPath()

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

beginSolidSubPath()도 참조하십시오 .

void QCanvasPainter::beginPath()

현재 경로를 지우면서 새로운 경로를 그리기 시작합니다.

void QCanvasPainter::beginSolidSubPath()

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

beginHoleSubPath()도 참조하십시오 .

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

경로의 마지막 점에서 두 개의 제어점(cp1X, cp1Y 및 cp2X, cp2Y)을 거쳐 지정된 점(x, y)까지 3차 베지어 세그먼트를 추가합니다.

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

경로의 마지막 점에서 두 제어점(controlPoint1 및 controlPoint2)을 거쳐 지정된 점 endPoint 까지 3차 베지어 세그먼트를 추가합니다.

void QCanvasPainter::circle(qreal centerX, qreal centerY, qreal radius)

( centerX, centerY)을 중심으로, 반지름 radius 인 새로운 원형 서브 경로를 생성합니다.

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

centerPoint 를 중심으로, radius 을 사용하여 새로운 원형 서브 경로를 생성합니다.

void QCanvasPainter::cleanupResources()

캐시에서 사용되지 않는 텍스처를 제거하는 스케줄러입니다.

또한, 메모리 사용량을 최소화하기 위해 이 함수를 호출할 때 다른 캐시 및 풀의 크기가 축소될 수 있습니다. 이로 인해 이후의 드로잉 호출에 더 많은 비용이 발생할 수 있습니다.

void QCanvasPainter::clearRect(qreal x, qreal y, qreal width, qreal height)

x, y, width, height 로 지정된 직사각형 영역을 투명한 검은색으로 채워 해당 영역의 픽셀을 지웁니다. 지우기 작업에는 블렌딩이 필요하지 않으므로, fillRect()보다 더 빠를 수 있습니다.

void QCanvasPainter::clearRect(const QRectF &rect)

rect 로 지정된 직사각형을 투명한 검은색으로 채워, 해당 영역 내의 픽셀을 지웁니다. 이는 QRectF 를 사용하는 오버로드된 메서드입니다.

void QCanvasPainter::closePath()

현재 하위 경로를 선분으로 닫습니다. 이는 마지막 경로 요소로 lineTo([시작점])을 지정하는 것과 동일합니다.

QCanvasOffscreenCanvas QCanvasPainter::createCanvas(QSize pixelSize, int sampleCount = 1, QCanvasOffscreenCanvas::Flags flags = {})

지정된 pixelSize, sampleCount 및 flags 값을 가진 새로운 오프스크린 캔버스를 반환합니다.

캔버스의 크기는 픽셀 단위로 지정됩니다. pixelSize, sampleCount 및 flags 속성은 이후 변경할 수 없습니다. 다른 크기, 샘플 수 또는 플래그를 가진 캔버스를 얻으려면 새 캔버스를 생성하십시오.

드로잉 명령을 사용하여 오프스크린 캔버스를 대상으로 하려면, 저수준 API를 사용할 때는 적절한 QCanvasRhiPaintDriver::beginPaint() 오버로드를 호출하고, 편의 위젯이나 Qt Quick 항목 클래스를 사용할 때는 QCanvasPainterWidget::beginCanvasPainting() 또는 QCanvasPainterItemRenderer::beginCanvasPainting()을 호출하십시오.

일반적으로 캔버스에 그리기를 수행하면 캔버스의 내용이 지워집니다. 이 동작을 비활성화하려면 flags 에서 PreserveContents 를 전달하십시오.

캔버스에 멀티샘플 렌더링(멀티샘플 앤티앨리어싱, MSAA)을 요청하려면 샘플 수를 1보다 큰 값(예: 4 또는 8)으로 설정하십시오. 그러나 멀티샘플링이 활성화된 경우 렌더링 패스 간에 캔버스 내용을 보존하는 기능은 지원되지 않으며, 이 경우 PreserveContents 플래그는 작동하지 않습니다.

void QCanvasPainter::destroyCanvas(QCanvasOffscreenCanvas &canvas)

canvas 를 뒷받침하는 리소스를 해제합니다. 이때 canvas 는 null canvas 가 됩니다.

페인터는 소멸될 때 자동으로 이 작업을 수행합니다. 따라서 이 함수를 호출해야 하는 경우는 관련 리소스를 즉시 해제하고자 할 때뿐입니다.

void QCanvasPainter::drawBoxShadow(const QCanvasBoxShadow &shadow)

shadow 에 상자를 그립니다. 그림자는 shadow 에서 정의된 위치, 크기, 색상, 블러 등의 속성을 적용하여 그려집니다. 이 메서드를 호출하기 전에 beginPath()를 호출할 필요는 없습니다.

QCanvasBoxShadow도 참조하십시오 .

void QCanvasPainter::drawImage(const QCanvasImage &image, qreal x, qreal y)

image 를 x, y 에 기본 크기로 그려 넣습니다.

addImage()도 참조하십시오 .

void QCanvasPainter::drawImage(const QCanvasImage &image, const QRectF &destinationRect)

image 를 destinationRect 의 위치와 크기에 맞게 그립니다.

addImage()도 참조하십시오 .

void QCanvasPainter::drawImage(const QCanvasImage &image, const QRectF &sourceRect, const QRectF &destinationRect)

이미지의 sourceRect 영역에서 image 를 destinationRect 의 위치와 크기로 그려 넣습니다.

addImage()도 참조하십시오 .

void QCanvasPainter::drawImage(const QCanvasImage &image, qreal x, qreal y, qreal width, qreal height)

image 를 x, y 에, 주어진 width 및 height 에서 그립니다.

addImage()도 참조하십시오 .

void QCanvasPainter::ellipse(qreal centerX, qreal centerY, qreal radiusX, qreal radiusY)

( centerX, centerY)을 중심으로, radiusX 및 radiusY 을 가진 새로운 타원형 하위 경로를 생성합니다.

void QCanvasPainter::ellipse(const QRectF &rect)

rect 내에 새로운 타원 모양의 하위 경로를 생성합니다. 이 타원은 rect 영역을 덮게 됩니다.

void QCanvasPainter::ellipse(QPointF centerPoint, qreal radiusX, qreal radiusY)

centerPoint 를 중심으로, radiusX 및 radiusY 를 갖는 새로운 타원형 하위 경로를 생성합니다.

void QCanvasPainter::fill()

현재 경로를 현재 채우기 스타일과 현재 채우기 규칙으로 채웁니다.

setFillStyle() 및 setFillRule()도 참조하십시오 .

[since 6.12] void QCanvasPainter::fill(QCanvasPainter::FillRule fillRule)

현재 경로를 현재 채우기 스타일과 채우기 규칙 fillRule 으로 채웁니다.

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

setFillStyle() 및 setFillRule()도 참조하십시오 .

void QCanvasPainter::fill(const QCanvasPath &path, int pathGroup = -1)

path 를 현재 채우기 스타일과 채우기 규칙으로 채우며, 이는 pathGroup 에 속합니다. 경로에 명령어가 더 많이 포함되어 있고 대부분 정적일 때는 QCanvasPath 를 통한 그리기가 가장 적합합니다.

pathGroup 가 -1 인 경우, 경로는 GPU 측에 캐시되지 않습니다. 이것이 기본값입니다. 경로 데이터의 캐싱을 요청하려면 0 보다 크거나 같은 값을 전달하십시오. 경로 캐시 그룹 사용에 대한 자세한 내용은 QCanvasPath 문서를 참조하십시오.

이 메서드를 호출하기 전에 beginPath()를 호출할 필요는 없습니다.

setFillStyle(), setFillRule(), removePathGroup()도 참조하십시오 .

[since 6.12] void QCanvasPainter::fill(const QCanvasPath &path, QCanvasPainter::FillRule fillRule, int pathGroup = -1)

path 에 현재 채우기 스타일과 채우기 규칙을 적용합니다. fillRule

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

void QCanvasPainter::fillRect(qreal x, qreal y, qreal width, qreal height)

지정된 위치( x, y)에 크기 width, height 의 채워진 사각형을 그립니다.

void QCanvasPainter::fillRect(const QRectF &rect)

rect 에 채움이 적용된 사각형을 그립니다. 이 메서드는 QRectF 를 사용하는 오버로드된 메서드입니다.

void QCanvasPainter::fillText(const QString &text, qreal x, qreal y, qreal maxWidth = 0)

지정된 위치( x, y)에 현재 textAlign 및 textBaseline 설정을 적용하여 “ text ” 문자열을 그립니다. 텍스트를 여러 줄로 줄바꿈하려면 setTextWrapMode()를 사용하여 줄바꿈 모드를 기본값인 NoWrap 이외의 값으로 설정하십시오. 선택적 매개변수 maxWidth 의 기본값은 0 입니다. 즉, 예를 들어 WordWrap 가 설정된 경우, 텍스트는 단어 단위로 줄바꿈됩니다. maxWidth 매개변수를 원하는 행 너비(픽셀 단위)로 설정하십시오.

setTextAlign(), setTextBaseline(), setTextWrapMode()도 참조하십시오 .

void QCanvasPainter::fillText(const QString &text, const QRectF &rect)

현재 textAlign 및 textBaseline 설정을 사용하여 rect 내부에 text 문자열을 그립니다. rect 매개변수의 너비가 maxWidth로 사용됩니다.

이 메서드는 ` QRectF`을 사용하는 오버로드된 메서드입니다. 이 메서드를 사용하여 텍스트를 그릴 때 텍스트 기준선을 ` TextBaseline::Top ` 또는 ` TextBaseline::Middle `로 설정하는 것이 종종 유용합니다.

setTextAlign(), setTextBaseline(), setTextWrapMode()도 참조하십시오 .

void QCanvasPainter::fillText(const QString &text, QPointF point, qreal maxWidth = 0)

지정된 point 위치에 현재 textAlign 및 textBaseline 설정을 적용하여 text 문자열을 그립니다. 텍스트를 여러 줄로 나누려면 setTextWrapMode()를 사용하여 텍스트 줄바꿈 모드를 기본값인 NoWrap 이외의 값으로 설정하십시오. 선택적 maxWidth 매개변수의 기본값은 0 입니다. 즉, 예를 들어 WordWrap 로 설정된 경우, 텍스트는 단어 단위로 줄바꿈됩니다. maxWidth 매개변수를 원하는 행 너비(픽셀 단위)로 설정합니다.

이 메서드는 QPointF 를 사용하는 오버로드된 메서드입니다.

setTextAlign(), setTextBaseline() 및 setTextWrapMode()도 참조하십시오 .

QTransform QCanvasPainter::getTransform() const

현재 변환을 반환합니다.

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

경로의 마지막 점에서 ( x, y) 지점까지의 선분을 추가합니다.

void QCanvasPainter::lineTo(QPointF point)

경로의 마지막 점에서 point 까지의 선분을 추가합니다.

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

( x, y)을 첫 번째 점으로 하는 새로운 하위 경로를 시작합니다.

void QCanvasPainter::moveTo(QPointF point)

point 를 첫 번째 점으로 하는 새로운 하위 경로를 시작합니다.

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

경로의 마지막 점에서 제어점을 경유하여(cpX, cpY) 지정된 점(x, y)까지 이차 베지어 세그먼트를 추가합니다.

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

경로의 마지막 점에서 controlPoint 를 거쳐 지정된 endPoint 까지 이차 베지어 세그먼트를 추가합니다.

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

x, y 위치에, 크기 width, height 인 새로운 직사각형 모양의 하위 경로를 생성합니다.

void QCanvasPainter::rect(const QRectF &rect)

rect 에 새로운 직사각형 모양의 하위 경로를 생성합니다. 이는 QRectF 를 사용하는 오버로드된 메서드입니다.

void QCanvasPainter::removeImage(const QCanvasImage &image)

image 와 관련된 리소스를 해제하고 페인터에서 이미지를 제거합니다.

addImage()도 참조하십시오 .

void QCanvasPainter::removePathGroup(int pathGroup)

페인터 캐시에서 ` pathGroup `을 제거합니다. 이후 ` pathGroup `에 대해 ` fill()` 또는 ` stroke()`를 호출하면 그룹 캐시에 경로가 다시 생성됩니다.

fill() 및 stroke()도 참조하십시오 .

void QCanvasPainter::reset()

현재 페인터 상태를 기본값으로 재설정합니다.

여기에는 획 및 채우기 스타일과 관련 속성, 변환 행렬, 클리핑 영역, 텍스트 관련 설정, 합성 속성, 그리기 상태 스택, 앤티앨리어싱 설정이 포함됩니다.

save() 및 restore()도 참조하십시오 .

void QCanvasPainter::resetClipping()

클리핑을 초기화하고 비활성화합니다.

setClipRect()도 참조하십시오 .

void QCanvasPainter::resetTransform()

현재 변환을 단위 행렬로 초기화합니다.

void QCanvasPainter::restore()

현재 렌더링 상태를 팝하고 복원합니다. 따라서 이전에 저장된 상태가 복원됩니다. save()이 호출되지 않았고 상태 스택이 비어 있는 경우, 이 메서드를 호출해도 아무 일도 일어나지 않습니다.

save()도 참조하십시오 .

void QCanvasPainter::rotate(qreal angle)

현재 좌표계를 angle 만큼 시계 방향으로 회전합니다.

각도는 라디안 단위로 지정됩니다. 도에서 라디안으로 변환하려면 ` qDegreesToRadians()`를 사용하십시오.

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

x, y 위치에, width, height 크기의 새로운 둥근 사각형 모양의 하위 경로를 생성합니다. 모서리 둥글림 반경은 radius 입니다.

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

rect 에 모서리가 radius 인 새로운 둥근 직사각형 모양의 하위 경로를 생성합니다. 이는 QRectF 을 사용하는 오버로드된 메서드입니다.

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

rect 에서 둥근 직사각형 모양의 새로운 하위 경로를 생성합니다. 모서리 둥글림 정도는 모서리마다 다르게 설정할 수 있으며, radiusTopLeft, radiusTopRight, radiusBottomRight, radiusBottomLeft 을 사용할 수 있습니다.

void QCanvasPainter::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 값을 사용할 수 있습니다.

void QCanvasPainter::save()

현재 렌더링 상태를 상태 스택에 푸시하고 저장합니다. 상태를 복원하려면 이에 대응하는 ` restore()`를 사용해야 합니다.

restore()도 참조하십시오 .

void QCanvasPainter::scale(qreal scale)

현재 좌표계를 scale 로 확대/축소합니다. x 및 y 좌표가 모두 균등하게 확대/축소됩니다.

void QCanvasPainter::scale(qreal scaleX, qreal scaleY)

현재 좌표계를 scaleX 및 scaleY 값으로 확대/축소합니다.

void QCanvasPainter::setAntialias(qreal antialias)

현재 앤티앨리어싱 수준을 픽셀 단위로 antialias 로 설정합니다. 앤티앨리어싱을 높이면 더 매끄럽게 그려집니다. 이 설정은 채우기 및 선 그리기 작업에만 영향을 미치며, 이미지나 텍스트에는 적용되지 않습니다. 기본값은 1.0 이며, 최대값은 10.0 입니다.

앤티앨리어싱은 경로별로 수정할 수 있으므로 각 획/채우기 전에 설정할 수 있습니다. 앤티앨리어싱을 비활성화하고 렌더링 비용을 줄이려면 앤티앨리어싱을 0 로 설정하십시오.

setTextAntialias()도 참조하십시오 .

void QCanvasPainter::setClipRect(qreal x, qreal y, qreal width, qreal height)

현재 시저 사각형을 (x, y, width, height)로 설정합니다. 시저 사각형은 현재 변환에 따라 변환됩니다.

resetClipping()도 참조하십시오 .

void QCanvasPainter::setClipRect(const QRectF &rect)

현재 시저 사각형을 rect 로 설정합니다. 시저 사각형은 현재 변환에 따라 변환됩니다.

resetClipping()도 참조하십시오 .

[since 6.12] void QCanvasPainter::setFillRule(QCanvasPainter::FillRule fillRule)

경로 채우기 규칙을 ` fillRule`로 설정합니다. 이 값은 규칙이 설정된 후 이루어지는 모든 ` fill()` 호출에 적용됩니다. 기본 채우기 규칙은 QCanvasPainter::FillRule::NonZero

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

void QCanvasPainter::setFillStyle(QColor color)

채우기 스타일을 단색 color 으로 설정합니다. 기본 채우기 스타일은 검은색 단색(0, 0, 0, 1)입니다.

void QCanvasPainter::setFillStyle(const QCanvasBrush &brush)

채우기 스타일을 ‘ brush ’로 설정합니다. 기본 채우기 스타일은 검은색 단색(0, 0, 0, 1)입니다.

void QCanvasPainter::setFont(const QFont &font)

font 를 현재 활성화된 글꼴로 설정합니다.

void QCanvasPainter::setGlobalAlpha(qreal alpha)

전역 알파(투명도) 값을 alpha 로 설정합니다. 이 알파 값은 렌더링되는 모든 도형에 적용됩니다. 이미 투명한 경로의 경우, 비례에 따라 투명도가 더욱 높아집니다. 알파 값은 0.0(완전 투명)에서 1.0(완전 불투명) 사이여야 합니다. 기본적으로 알파 값은 1.0 입니다.

void QCanvasPainter::setGlobalBrightness(qreal value)

전역 밝기를 value 로 설정합니다. 이 밝기는 렌더링되는 모든 도형에 적용됩니다. 값을 0으로 설정하면 도형이 완전히 검은색으로 표시됩니다. 밝기를 높이려면 값을 1.0보다 크게 설정할 수도 있습니다. 기본적으로 밝기는 1.0 입니다.

void QCanvasPainter::setGlobalCompositeOperation(QCanvasPainter::CompositeOperation operation)

전역 합성 작업 모드를 ‘ operation ’로 설정합니다. 이 모드는 모든 그리기 작업에 적용됩니다. 기본 모드는 ‘ QCanvasPainter::CompositeOperation::SourceOver ’입니다.

void QCanvasPainter::setGlobalContrast(qreal value)

전역 대비를 value 로 설정합니다. 이 대비는 렌더링되는 모든 도형에 적용됩니다. 값을 0으로 설정하면 도형이 완전히 회색(0.5, 0.5, 0.5)으로 표시됩니다. 대비를 높이려면 값을 1.0보다 크게 설정할 수도 있습니다. 기본적으로 대비는 1.0 입니다.

void QCanvasPainter::setGlobalSaturation(qreal value)

전역 채도 값을 value 로 설정합니다. 이 채도 값은 렌더링되는 모든 도형에 적용됩니다. 값을 0으로 설정하면 채도가 비활성화되어 그리기가 완전히 그레이스케일로 처리됩니다. 채도를 높이려면 값을 1.0보다 크게 설정할 수도 있습니다. 기본적으로 채도 값은 1.0 입니다.

void QCanvasPainter::setHighQualityStroking(bool enabled)

고품질 스트로크를 ` enabled`로 설정합니다. 이 값을 ` true `로 설정하면, 스트로크가 겹치거나 불투명도가 100%가 아닌 드문 경우에서 더 정확한 렌더링이 이루어집니다. 이 기능을 활성화하면 렌더링 비용이 증가합니다. 기본값은 ` false`입니다.

void QCanvasPainter::setLineCap(QCanvasPainter::LineCap cap)

스트로크의 선 끝을 ` cap`로 설정합니다. 기본 선 끝 모양은 ` QCanvasPainter::LineCap::Butt`입니다.

void QCanvasPainter::setLineJoin(QCanvasPainter::LineJoin join)

스트로크의 선 연결 방식을 ‘ join ’로 설정합니다. 기본 선 연결 방식은 ‘ QCanvasPainter::LineJoin::Miter ’입니다.

setMiterLimit()도 참조하십시오 .

void QCanvasPainter::setLineWidth(qreal width)

스트로크의 선 너비를 픽셀 단위로 width 로 설정합니다. 기본 선 너비는 1.0 입니다. 앤티앨리어싱이 활성화된 경우, 1픽셀보다 얇은 너비는 불투명도가 자동으로 점차적으로 줄어들어 부드러운 출력 결과를 만들어 냅니다.

stroke()도 참조하십시오 .

void QCanvasPainter::setMiterLimit(qreal limit)

마이터 제한값을 limit 로 설정합니다. 마이터 제한값은 날카로운 모서리가 베벨 처리되는 시점을 제어합니다. 모서리 길이가 이 제한값을 초과하게 되면, 대신 선들 사이에 QCanvasPainter::LineJoin::Bevel 가 적용됩니다. 이 설정은 QCanvasPainter::LineJoin::Miter 선 연결 방식에서만 적용됩니다. 기본 제한값은 10.0 입니다.

setLineJoin()도 참조하십시오 .

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

현재 서브 경로 winding 를 CounterClockWise (기본값) 또는 ClockWise 중 하나로 설정합니다. CounterClockWise 는 채워진 서브 경로를 그리는 반면, ClockWise 는 구멍이 뚫린 서브 경로를 그립니다.

beginHoleSubPath() 및 beginSolidSubPath()도 참조하십시오 .

void QCanvasPainter::setStrokeStyle(QColor color)

선 스타일을 실선 color 으로 설정합니다. 기본 선 스타일은 검은색 실선(0, 0, 0, 1)입니다.

void QCanvasPainter::setStrokeStyle(const QCanvasBrush &brush)

스트로크 스타일을 ‘ brush ’로 설정합니다. 기본 스트로크 스타일은 검은색 실선(0, 0, 0, 1)입니다.

void QCanvasPainter::setTextAlign(QCanvasPainter::TextAlign align)

텍스트의 가로 정렬을 ‘ align ’로 설정합니다. 기본 정렬은 ‘ QCanvasPainter::TextAlign::Start ’입니다.

setTextBaseline()도 참조하십시오 .

void QCanvasPainter::setTextAntialias(qreal antialias)

현재 텍스트 앤티앨리어싱 강도를 설정합니다. 값 antialias 은 일반 앤티앨리어싱에 적용되는 배율로, 0.0 는 앤티앨리어싱을 비활성화하고 2.0은 앤티앨리어싱 강도를 두 배로 높입니다. 기본값은 1.0입니다.

void QCanvasPainter::setTextBaseline(QCanvasPainter::TextBaseline baseline)

텍스트의 수직 정렬(기준선)을 ‘ baseline ’로 설정합니다. 기본 정렬은 ‘ QCanvasPainter::TextBaseline::Alphabetic ’입니다.

setTextAlign()도 참조하십시오 .

void QCanvasPainter::setTextDirection(QCanvasPainter::TextDirection direction)

텍스트의 방향을 direction 로 설정합니다. 기본 방향은 QCanvasPainter::TextDirection::Inherit 입니다.

void QCanvasPainter::setTextLineHeight(qreal height)

줄 바꿈된 텍스트에 대해 줄 높이 조정 값을 픽셀 단위로 height 로 설정합니다. 기본 줄 높이는 0 입니다.

void QCanvasPainter::setTextWrapMode(QCanvasPainter::WrapMode wrapMode)

텍스트 줄바꿈 모드를 ` wrapMode`로 설정합니다. 기본 줄바꿈 모드는 ` QCanvasPainter::WrapMode::NoWrap`입니다.

void QCanvasPainter::setTransform(const QTransform &transform)

현재 변환을 초기화하고 대신 transform 를 사용합니다.

transform()도 참조하십시오 .

void QCanvasPainter::setWindingEnforce(bool enabled)

와인딩 강제 적용을 ` enabled`로 설정합니다. 이 값을 ` false `로 설정하면 ` setPathWinding()`에 설정된 내용과 일치하도록 경로 와인딩을 강제 적용하는 기능이 비활성화됩니다. 이 기능을 비활성화하면, 예를 들어 시계 방향 순서로 점을 추가하여 경로에 구멍을 만들 수 있습니다. 또한 비활성화하면 성능이 향상될 수 있습니다. 기본값은 ` true`입니다.

void QCanvasPainter::skew(qreal angleX, qreal angleY = 0.0)

현재 좌표계를 X축 방향으로 angleX, Y축 방향으로 angleY 만큼 비스듬히 변환(전단)합니다. 각도는 라디안 단위로 지정됩니다.

void QCanvasPainter::stroke()

현재 획 스타일을 사용하여 경로를 그립니다.

setStrokeStyle()도 참조하십시오 .

void QCanvasPainter::stroke(const QCanvasPath &path, int pathGroup = -1)

path 에 현재 획 스타일을 적용하여 pathGroup 에 속하는 경로를 그립니다. 경로에 명령어가 많고 대체로 정적인 경우, QCanvasPath 을 통한 그리기가 가장 적합합니다.

pathGroup 가 -1 인 경우, 경로의 렌더링 관련 데이터는 캐시되지 않습니다. 이것이 기본값입니다. 경로 데이터의 캐싱을 요청하려면 0 보다 크거나 같은 값을 전달하십시오. 경로 캐시 그룹 사용에 대한 자세한 내용은 QCanvasPath 문서를 참조하십시오.

이 메서드를 호출하기 전에 ` beginPath()`를 호출할 필요는 없습니다.

setStrokeStyle() 및 removePathGroup()도 참조하십시오 .

void QCanvasPainter::strokeRect(qreal x, qreal y, qreal width, qreal height)

지정된 위치( x, y)에 크기 width, height 인 테두리가 그려진 사각형을 그립니다.

void QCanvasPainter::strokeRect(const QRectF &rect)

rect 에 테두리가 있는 사각형을 그립니다. 이 메서드는 QRectF 를 사용하는 오버로드된 메서드입니다.

QRectF QCanvasPainter::textBoundingBox(const QString &text, qreal x, qreal y, qreal maxWidth = 0) const

(x, y)에서 text 문자열의 바운딩 박스 크기를 측정합니다.

여러 줄로 된 텍스트의 크기를 측정하려면, ` setTextWrapMode()`를 사용하여 텍스트 줄바꿈 모드를 기본값인 ` NoWrap` 이외의 값으로 설정하십시오. 또한 선택적 매개변수 ` maxWidth `을 픽셀 단위의 선호하는 행 너비로 설정하십시오.

QRectF 함수를 호출하여 [xmin, ymin, width, height] 값을 반환합니다. 측정된 값은 로컬 좌표계에서 반환됩니다.

QRectF QCanvasPainter::textBoundingBox(const QString &text, const QRectF &rect) const

rect 에서 ‘ text ’ 문자열의 바운딩 박스를 측정합니다. [xmin, ymin, width, height] 값을 가진 QRectF 객체를 반환합니다. 측정된 값은 로컬 좌표계에서 반환됩니다.

QRectF QCanvasPainter::textBoundingBox(const QString &text, QPointF point, qreal maxWidth = 0) const

point 에서 text 문자열의 바운딩 박스 크기를 측정합니다.

여러 줄로 된 텍스트의 크기를 측정하려면, ` setTextWrapMode()`를 사용하여 텍스트 줄바꿈 모드를 기본값인 ` NoWrap` 이외의 값으로 설정하십시오. 또한 선택적 매개변수 ` maxWidth `를 원하는 행 너비(픽셀 단위)로 설정하십시오.

QRectF 를 반환하며, 값은 [xmin, ymin, width, height]입니다. 측정된 값은 로컬 좌표계에서 반환됩니다.

void QCanvasPainter::transform(const QTransform &transform)

현재 좌표계에 지정된 변환 매트릭스 transform 를 곱합니다.

setTransform()도 참조하십시오 .

void QCanvasPainter::translate(qreal x, qreal y)

현재 좌표계를 x 및 y 에 따라 변환합니다.

void QCanvasPainter::translate(QPointF point)

현재 좌표계를 point 만큼 변환합니다.