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() 来查询以字节为单位的单独大小。如果QCanvasImage 是由QCanvasOffscreenCanvas 或QRhiTexture 创建的，该函数也会返回有效结果，但它不考虑 mipmap 或多采样数据。

另请参见 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 添加为绘画者可用的纹理。标志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 未提供（或为同位矩阵）时，该操作会非常快，因为它会重复使用路径数据。

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

将path 添加到当前路径，从start 的命令开始，包括count 的命令量。可选择使用transform 更改路径点。会检查start 和count 的范围，以确保命令的访问量不会超过QCanvasPath::commandsSize()。如果路径不应该从当前路径位置继续，则首先调用moveTo() ，例如path.positionAt(start - 1) 。

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 时，arc 不会从之前的路径位置添加一条线到弧的起点。角度的单位是弧度。

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)

在 (centerX,centerY) 与radius 之间创建新的圆形子路径。

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

在centerPoint 中创建新的圆形子路径，radius 。

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() 重载；在使用方便的 widget 或Qt Quick item 类时，请调用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 图像区域，将image 绘制到destinationRect 的位置和大小。

另请参见 addImage().

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

将image 绘制到x,y, 给定的width 和height 中。

另请参见 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) 以当前 textAlign 和 textBaseline 绘制text 字符串。要将文本换行成多行，可将maxWidth 参数设置为首选行宽（以像素为单位）。行首的空白会被去掉，文本会在单词边界或遇到换行符时被分割。长度超过最大宽度的单词将在最近的字符处分割（即不使用连字符）。

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

使用当前 textAlign 和 textBaseline 在rect 内绘制text 字符串。矩形参数的宽度用作最大宽度。

这是一个使用QRectF 的重载方法。使用该方法绘制文本时，将文本基线设置为TextBaseline::Top 或TextBaseline::Middle 通常非常有用。

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

以当前 textAlign 和 textBaseline 在指定的point 处绘制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 转换为像素的静态辅助方法。这样就可以进行与分辨率无关的绘图。例如，要将线宽设置为 2 毫米，请使用

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() 或pathGroup 的stroke() 会将路径重新生成到组缓存中。

另请参见 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)

在rect 上创建新的圆角矩形子路径，radius 角。这是一个使用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 render hint。

另请参见 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（透明度）值设置为alpha 。此 alpha 值将应用于所有渲染的图形。已经透明的路径也会按比例变得更加透明。Alpha 值应介于 0.0（完全透明）和 1.0（完全不透明）之间。默认情况下，alpha 值为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)

将 stoke 的行尾设置为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 为 true，则在绘制器上设置给定的呈现hint ；否则清除呈现提示。

另请参阅 setRenderHints() 和renderHints()。

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

如果on 为 true，则在绘制器上设置给定的呈现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)

在 (x,y) 处测量text 字符串的边框。若要测量多行文本，可将maxWidth 参数设置为首选行宽（以像素为单位）。返回QRectF ，值为 [xmin、ymin、width、height]。测量值以本地坐标空间返回。

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

在rect 处测量text 字符串的边界框。返回QRectF ，值为 [xmin、ymin、width、height]。测量值以本地坐标空间返回。

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

在point 处测量text 字符串的边框。要测量多行文本，可将maxWidth 参数设置为首选行宽（以像素为单位）。返回QRectF ，值为 [xmin、ymin、width、height]。测量值以本地坐标空间返回。

void QCanvasPainter::transform(const QTransform &transform)

将当前坐标系与指定的transform 相乘。

另请参见 setTransform() 。

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

通过x 和y 对当前坐标系进行平移。

void QCanvasPainter::translate(QPointF point)

通过point 转换当前坐标系。