QCanvasImage Class

static QImage logoImage(":/qtlogo.png");
// Paint an image pattern.
QCanvasImage bg = painter.addImage(logoImage,
             QCanvasPainter::ImageFlag::Repeat |
             QCanvasPainter::ImageFlag::GenerateMipmaps);
QCanvasImagePattern ip(bg, 0, 0, 44, 32);
painter.setFillStyle(ip);
painter.fillRect(50, 50, 320, 230);
// Paint a single image, with tint color.
QCanvasImage logo = painter.addImage(logoImage);
logo.setTintColor("#2cde85");
painter.drawImage(logo, 100, 80);

成员函数文档

QCanvasImage::QCanvasImage()

构建一张默认图像。

QCanvasImage::QCanvasImage(const QCanvasImage &image)

构建一个图像，该图像为给定的image 的副本。

[constexpr noexcept default] QCanvasImage::QCanvasImage(QCanvasImage &&other)

从other 创建一个新的 QCanvasImage 对象。

[noexcept] QCanvasImage::~QCanvasImage()

破坏了图像。

qreal QCanvasImage::devicePixelRatio() const

返回图像的设备像素比。这是设备像素与设备独立像素之间的比率。

当QCanvasImage 的设备像素比大于1时，使用该图像时会应用该缩放因子。例如，drawImage(image, 0, 0) 此时等同于drawImage(image, 0, 0, image.width() / image.devicePixelRatio(), image.height() / image.devicePixelRatio()) 。

默认值为 1.0。

该值由创建QCanvasImage 所依据的QImage 继承而来。由纹理或offscreen canvas 创建的QCanvasImage ，其设备像素比始终为1。

另请参阅 QImage 。

int QCanvasImage::height() const

返回该图像以像素为单位的高度；

int QCanvasImage::id() const

返回该图像的纹理 ID。如果该图像尚未被分配，则返回 0。

另请参阅 isNull()。

bool QCanvasImage::isNull() const

如果图像尚未被分配，则返回 true。详情请参阅QCanvasPainter::addImage()。

void QCanvasImage::setTintColor(QColor color)

设置图像的色调color 。该颜色将与图像颜色相乘，从而为图像着色。例如，这可用于突出显示图标，或根据主题调整图像。

另请参阅 tintColor()。

QSize QCanvasImage::size() const

返回该图像的大小（宽度和高度），单位为像素。

qsizetype QCanvasImage::sizeInBytes() const

返回该图像的大小（以字节为单位）。

QCanvasPainter 在addImage()返回后，不会保留CPU端QImage 数据的副本。如果源是offscreen canvas ，那么CPU端原本就不存在图像数据。因此，该函数的结果是对底层纹理所占用的GPU内存大小的近似值。

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

将此图片与other 互换。此操作非常快，且从未失败。

QColor QCanvasImage::tintColor() const

返回图像的色调颜色。默认值为Qt::white 。

另请参阅 setTintColor()。

int QCanvasImage::width() const

返回该图像的宽度（以像素为单位）。

QCanvasImage::operator QVariant() const

将图像作为QVariant 返回。

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

将other 通过move-assign操作赋值给此QCanvasImage 实例。

QCanvasImage &QCanvasImage::operator=(const QCanvasImage &image)

将给定的image 分配给该图像，并返回对该图像的引用。