QCanvasPainter Class

QRectF rect(40, 70, 120, 60);
QRectF shadowRect = rect.translated(2, 4);
// Paint shadow
QCanvasBoxShadow shadow(shadowRect, 30, 15, "#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, "#404040", "#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->setRenderHint(QCanvasPainter::RenderHint::DisableWindingEnforce);
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

addImage() 오버로드로 인해 생성된 이 페인터의 모든 활성 QCanvasImage 인스턴스에 대해 이미지(픽셀) 데이터에 사용된 메모리 근사치(킬로바이트)를 반환합니다. QImage. 또한 gradients 에 대해 내부적으로 생성된 이미지의 데이터도 포함됩니다.

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

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

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

activeImageCount(), addImage() 및 removeImage()도 참조하세요 .

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

image 을 추가하고 flags 을 텍스처로 사용할 수 있도록 합니다. 텍스처 ID 및 이미지에 대한 기타 정보와 함께 QCanvasImage 을 반환합니다. 반환된 QCanvasImage 은 drawImage 및 QCanvasImagePattern 과 함께 사용할 수 있습니다. 이 메서드를 호출한 후에는 image QImage 을 메모리에 보관할 필요가 없습니다.

동일한 image 으로 호출하는 것은 캐시 히트가 예상되므로 저렴한 작업입니다.

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

drawImage() 및 removeImage()도 참조하세요 .

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

페인터가 텍스처로 사용할 수 있는 texture 와 flags 을 추가합니다. NativeTexture 플래그는 암시적으로 설정됩니다. 반환된 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 이 제공되지 않거나 ID 행렬인 경우 이 작업은 경로 데이터를 재사용하므로 매우 빠릅니다.

void QCanvasPainter::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 QCanvasPainter::arc(float centerX, float centerY, float radius, float a0, float 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, float radius, float a0, float a1, QCanvasPainter::PathWinding direction = PathWinding::ClockWise, QCanvasPainter::PathConnection connection = PathConnection::Connected)

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

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

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

void QCanvasPainter::arcTo(QPointF controlPoint1, QPointF controlPoint2, float 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(float cp1X, float cp1Y, float cp2X, float cp2Y, float x, float y)

두 개의 제어점(cp1X, cp1Y 및 cp2X, cp2Y)을 통해 경로의 마지막 지점부터 지정된 지점(x, y)까지 큐빅 베지어 세그먼트를 추가합니다.

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

두 개의 제어점(controlPoint1 및 controlPoint2)을 통해 경로의 마지막 지점부터 지정된 지점 endPoint 까지 큐빅 베지어 세그먼트를 추가합니다.

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

radius 를 사용하여 ( centerX, centerY)에 원 모양의 하위 경로를 새로 만듭니다.

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

radius 을 사용하여 centerPoint 에 원 모양의 하위 경로를 새로 만듭니다.

void QCanvasPainter::cleanupResources()

캐시에서 사용하지 않는 텍스처를 삭제하도록 스케줄링합니다.

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

void QCanvasPainter::clearRect(float x, float y, float width, float 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 이 됩니다.

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

float QCanvasPainter::devicePixelRatio() const

물리적 픽셀과 디바이스 독립 픽셀 간의 비율을 반환합니다. 기본값은 1.0 입니다.

void QCanvasPainter::drawBoxShadow(const QCanvasBoxShadow &shadow)

상자를 그립니다 shadow. 그림자는 shadow 에서 설정한 위치, 크기, 색상, 흐림 등으로 그려집니다. 이 메서드 전에 beginPath()를 호출할 필요는 없습니다.

QCanvasBoxShadow 를참조하세요 .

void QCanvasPainter::drawImage(const QCanvasImage &image, float x, float 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 영역에서 destinationRect 의 위치와 크기에 image 를 그립니다.

addImage()도 참조하세요 .

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

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

addImage()도 참조하세요 .

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

radiusX 및 radiusY 을 사용하여 ( centerX, centerY)에 새 타원 모양의 하위 경로를 만듭니다.

void QCanvasPainter::ellipse(const QRectF &rect)

rect 에 타원 모양의 하위 경로를 새로 만듭니다. 이 타원은 rect 영역을 포함합니다.

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

radiusX 및 radiusY 를 사용하여 centerPoint 에 타원 모양의 하위 경로를 새로 만듭니다.

void QCanvasPainter::fill()

현재 경로를 현재 채우기 스타일로 채웁니다.

setFillStyle()도 참조하세요 .

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

path 을 현재 채우기 스타일로 채우고 pathGroup 에 속합니다. 경로에 더 많은 명령이 포함되어 있고 대부분 정적인 경우 QCanvasPath 을 통해 채우는 것이 최적입니다. 기본적으로 pathGroup 은 0 이므로 첫 번째 그룹을 사용합니다. pathGroup 가 -1 인 경우 경로가 GPU 측에 캐시되지 않습니다. 경로 캐시 그룹 사용에 대한 자세한 내용은 QCanvasPath 문서를 참조하세요. 이 메서드 앞에 beginPath()를 호출할 필요는 없습니다.

setFillStyle()도 참조하세요 .

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

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

void QCanvasPainter::fillRect(const QRectF &rect)

채워진 직사각형을 rect 에 그립니다. 이것은 QRectF 을 사용하는 오버로드된 메서드입니다.

void QCanvasPainter::fillText(const QString &text, float x, float y, float maxWidth = -1)

지정된 위치( x, y)에 text 문자열을 현재 textAlign 및 textBaseline을 사용하여 그립니다. 텍스트를 여러 줄로 줄 바꿈하려면 maxWidth 매개변수를 원하는 행 너비(픽셀)로 설정합니다. 행의 시작 부분에서 공백이 제거되고, 단어 경계에서 또는 새 줄 문자를 만나면 텍스트가 분할됩니다. 최대 너비보다 긴 단어는 가장 가까운 문자에서 분할됩니다(즉, 하이픈 없이).

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

rect 안에 text 문자열을 현재 textAlign 및 textBaseline과 함께 그립니다. rect 매개변수의 너비는 maxWidth로 사용됩니다.

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

void QCanvasPainter::fillText(const QString &text, QPointF point, float maxWidth = -1)

지정된 point 에 현재 textAlign 및 textBaseline을 사용하여 text 문자열을 그립니다. 텍스트를 여러 줄로 줄 바꿈하려면 maxWidth 매개변수를 원하는 행 너비(픽셀)로 설정합니다. 행의 시작 부분에서 공백이 제거되고, 단어 경계에서 또는 새 줄 문자를 만나면 텍스트가 분할됩니다. 최대 너비보다 긴 단어는 가장 가까운 문자에서 분할됩니다(즉, 하이픈 없이).

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

QTransform QCanvasPainter::getTransform() const

현재 트랜스폼을 반환합니다.

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

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

void QCanvasPainter::lineTo(QPointF point)

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

[static] float QCanvasPainter::mmToPx(float mm)

밀리미터 mm 를 픽셀로 변환하는 정적 도우미 메서드입니다. 이를 통해 해상도 독립적인 그리기를 할 수 있습니다. 예를 들어 선 너비를 2mm로 설정하려면 다음을 사용합니다:

painter->setLineWidth(QCanvasPainter::mmToPx(2));

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

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

void QCanvasPainter::moveTo(QPointF point)

point 을 첫 번째 지점으로 하여 새 하위 경로를 시작합니다.

[static] float QCanvasPainter::ptToPx(float pt)

포인트 pt 를 픽셀로 변환하는 정적 헬퍼 메서드입니다.

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

제어점(cpX, cpY)을 통해 경로의 마지막 지점부터 지정된 지점(x, y)까지 이차 베지어 세그먼트를 추가합니다.

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

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

void QCanvasPainter::rect(float x, float y, float width, float 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 을 제거합니다. 이 후 fill() 또는 stroke()를 호출하여 pathGroup 경로를 그룹 캐시에 다시 생성합니다.

fill() 및 stroke()도 참조하세요 .

QCanvasPainter::RenderHints QCanvasPainter::renderHints() const

이 페인터에 설정된 렌더링 힌트를 지정하는 플래그를 반환합니다.

setRenderHints() 및 setRenderHint()도 참조하세요 .

void QCanvasPainter::reset()

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

save() 및 restore()도 참조하세요 .

void QCanvasPainter::resetClipping()

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

setClipRect()도 참조하세요 .

void QCanvasPainter::resetTransform()

현재 변환을 아이덴티티 행렬로 재설정합니다.

void QCanvasPainter::restore()

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

save()도 참조하세요 .

void QCanvasPainter::rotate(float angle)

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

각도는 라디안 단위로 지정됩니다. qDegreesToRadians ()를 사용하여 도에서 라디안으로 변환합니다.

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

위치에 둥근 직사각형 모양의 하위 경로를 새로 만듭니다 x, y 크기 width, height. 모서리 반올림은 radius 입니다.

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

radius 모서리가 있는 rect 에 둥근 직사각형 모양의 하위 경로를 새로 만듭니다. 이것은 QRectF 을 사용하는 오버로드된 메서드입니다.

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

rect 에 둥근 직사각형 모양의 하위 경로를 새로 만듭니다. 모서리 반올림은 radiusTopLeft, radiusTopRight, radiusBottomRight, radiusBottomLeft 을 사용하여 모서리마다 다를 수 있습니다.

void QCanvasPainter::roundRect(float x, float y, float width, float height, float radiusTopLeft, float radiusTopRight, float radiusBottomRight, float radiusBottomLeft)

x, y 위치에 크기가 width, height 인 둥근 직사각형 모양의 하위 경로를 새로 만듭니다. 모서리 반올림은 radiusTopLeft, radiusTopRight, radiusBottomRight, radiusBottomLeft 과 같이 모서리마다 다를 수 있습니다.

void QCanvasPainter::save()

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

restore()도 참조하세요 .

void QCanvasPainter::scale(float scale)

현재 좌표계의 배율을 scale 으로 조정합니다. x 및 y 좌표 모두 균등하게 배율이 조정됩니다.

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

현재 좌표계의 배율을 scaleX 및 scaleY 으로 조정합니다.

void QCanvasPainter::setAntialias(float antialias)

현재 앤티앨리어싱 양을 픽셀 단위로 antialias 로 설정합니다. 앤티앨리어싱이 많을수록 페인팅이 더 부드러워집니다. 이미지나 텍스트가 아닌 채우기 및 획 페인팅에만 영향을 줍니다. 기본값은 1.0 이며 최대값은 10.0 입니다.

앤티앨리어싱은 경로별로 수정할 수 있으므로 각 획/채우기 전에 설정할 수 있습니다. 전체 캔버스 페인터에서 앤티앨리어싱을 비활성화하려면 QCanvasPainter::RenderHint::Antialiasing 렌더링 힌트를 사용하세요.

setRenderHints() 및 setTextAntialias()도 참조하세요 .

void QCanvasPainter::setBrushTransform(const QTransform &transform)

현재 브러시 변환을 transform 으로 설정합니다. 이 변환은 획 및 채우기 브러시 모두에 적용됩니다.

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

현재 가위 직사각형을 (x, y, width, height)로 설정합니다. 가위 사각형은 현재 변형에 의해 변형됩니다.

resetClipping()도 참조하세요 .

void QCanvasPainter::setClipRect(const QRectF &rect)

현재 가위 직사각형을 rect 로 설정합니다. 가위 직사각형은 현재 변형에 의해 변형됩니다.

resetClipping()도 참조하세요 .

void QCanvasPainter::setFillStyle(const 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(float alpha)

글로벌 알파(투명도) 값을 alpha 로 설정합니다. 이 알파 값은 렌더링된 모든 도형에 적용됩니다. 이미 투명한 경로도 비례적으로 더 투명해집니다. 알파는 0.0(완전 투명)에서 1.0(완전 불투명) 사이여야 합니다. 기본 알파는 1.0 입니다.

void QCanvasPainter::setGlobalBrightness(float value)

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

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

글로벌 합성 작업 모드를 operation 으로 설정합니다. 이 모드는 모든 페인팅 작업에 적용됩니다. 기본 모드는 QCanvasPainter::CompositeOperation::SourceOver 입니다.

void QCanvasPainter::setGlobalContrast(float value)

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

void QCanvasPainter::setGlobalSaturate(float value)

글로벌 채도를 value 로 설정합니다. 이 채도는 렌더링된 모든 도형에 적용됩니다. 값이 0이면 채도가 비활성화되고 페인팅이 완전히 회색조로 표시됩니다. 채도를 높이려면 값을 1.0보다 크게 설정할 수도 있습니다. 기본적으로 채도는 1.0 입니다.

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

스토크 줄 끝을 cap 으로 설정합니다. 기본 줄 캡은 QCanvasPainter::LineCap::Butt 입니다.

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

획의 줄 결합을 join 으로 설정합니다. 기본 줄 결합은 QCanvasPainter::LineJoin::Miter 입니다.

setMiterLimit()도 참조하세요 .

void QCanvasPainter::setLineWidth(float width)

획의 선 너비를 width (픽셀)로 설정합니다. 기본 선 너비는 1.0 입니다. 앤티앨리어싱을 활성화하면 단일 픽셀 아래의 선 너비가 자동으로 불투명도를 희미하게 하여 부드러운 출력을 만듭니다.

stroke()도 참조하세요 .

void QCanvasPainter::setMiterLimit(float 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::setRenderHint(QCanvasPainter::RenderHint hint, bool on = true)

on 이 참이면 페인터에 주어진 렌더링 hint 을 설정하고, 그렇지 않으면 렌더링 힌트를 지웁니다.

setRenderHints() 및 renderHints()도 참조하세요 .

void QCanvasPainter::setRenderHints(QCanvasPainter::RenderHints hints, bool on = true)

on 이 참이면 페인터에 주어진 렌더링 hints 을 설정하고, 그렇지 않으면 렌더링 힌트를 지웁니다.

setRenderHint() 및 renderHints()도 참조하세요 .

void QCanvasPainter::setStrokeStyle(const 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(float 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(float height)

줄 높이 조정을 픽셀 단위로 설정하여 줄 바꿈 텍스트의 경우 height 로 설정합니다. 기본 줄 높이는 0 입니다.

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

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

void QCanvasPainter::setTransform(const QTransform &transform)

현재 트랜스폼을 재설정하고 transform 대신 사용합니다.

transform()도 참조하세요 .

void QCanvasPainter::skew(float angleX, float angleY = 0.0f)

현재 좌표계를 X축을 따라 angleX 으로, Y축을 따라 angleY 으로 기울입니다. 각도는 라디안 단위로 지정됩니다.

void QCanvasPainter::stroke()

현재 획 스타일로 현재 경로를 획합니다.

setStrokeStyle()도 참조하세요 .

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

현재 획 스타일로 path 을 pathGroup 에 속하도록 획을 긋습니다. 경로에 더 많은 명령이 포함되어 있고 대부분 정적인 경우 QCanvasPath 을 통해 그리는 것이 가장 좋습니다. 기본적으로 pathGroup 은 0 이므로 첫 번째 그룹을 사용합니다. pathGroup 가 -1 인 경우 경로가 GPU 측에 캐시되지 않습니다. 경로 캐시 그룹 사용에 대한 자세한 내용은 QCanvasPath 문서를 참조하세요. 이 메서드 앞에 beginPath()를 호출할 필요는 없습니다.

setStrokeStyle()도 참조하세요 .

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

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

void QCanvasPainter::strokeRect(const QRectF &rect)

rect 에 스토킹된 사각형을 그립니다. 이것은 QRectF 을 사용하는 오버로드된 메서드입니다.

QRectF QCanvasPainter::textBoundingBox(const QString &text, float x, float y, float maxWidth = -1)

text 문자열의 바운딩 박스를 (x, y)에서 측정합니다. 여러 줄 텍스트를 측정하려면 선택 사항인 maxWidth 매개변수를 원하는 행 너비(픽셀)로 설정합니다. [xmin, ymin, 너비, 높이] 값과 함께 QRectF 를 반환합니다. 측정값은 로컬 좌표 공간에서 반환됩니다.

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

rect 에서 text 문자열의 바운딩 박스를 측정합니다. QRectF 를 [xmin, ymin, 너비, 높이] 값과 함께 반환합니다. 측정값은 로컬 좌표 공간에서 반환됩니다.

QRectF QCanvasPainter::textBoundingBox(const QString &text, QPointF point, float maxWidth = -1)

point 에서 text 문자열의 바운딩 박스를 측정합니다. 여러 줄 텍스트를 측정하려면 선택 사항인 maxWidth 매개변수를 원하는 행 너비(픽셀)로 설정합니다. [xmin, ymin, 너비, 높이] 값과 함께 QRectF 를 반환합니다. 측정된 값은 로컬 좌표 공간에서 반환됩니다.

void QCanvasPainter::transform(const QTransform &transform)

현재 좌표계에 지정된 transform 을 곱합니다.

setTransform()도 참조하세요 .

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

현재 좌표계를 x 및 y 으로 변환합니다.

void QCanvasPainter::translate(QPointF point)

현재 좌표계를 point 으로 변환합니다.