QBitmap Class

成员函数文档

QBitmap::QBitmap()

构建一个空位图。

另请参阅 QPixmap::isNull()。

[explicit] QBitmap::QBitmap(const QSize &size)

根据给定的size 构建一个位图。位图中的像素未初始化。

另请参阅 clear()。

[explicit] QBitmap::QBitmap(const QString &fileName, const char *format = nullptr)

根据给定的fileName 构建一个位图。如果文件不存在，或者格式未知，则该位图将为空位图。

fileName 和format 参数将传递给QPixmap::load()函数。如果文件格式中每个像素使用超过1位，生成的位图将自动进行抖动处理。

另请参阅 QPixmap::isNull() 和QImageReader::imageFormat()。

QBitmap::QBitmap(int width, int height)

根据给定的width 和height 构建一个位图。位图内部的像素未初始化。

另请参阅 clear()。

void QBitmap::clear()

清除位图，将所有位设置为Qt::color0 。

[static] QBitmap QBitmap::fromData(const QSize &size, const uchar *bits, QImage::Format monoFormat = QImage::Format_MonoLSB)

根据给定的size 构建一个位图，并将内容设置为提供的bits 。

位图数据必须按字节对齐，并采用monoFormat 指定的位序。mono格式必须为QImage::Format_Mono 或QImage::Format_MonoLSB 。使用QImage::Format_Mono 来指定XBM格式的数据。

另请参阅 fromImage()。

[static] QBitmap QBitmap::fromImage(const QImage &image, Qt::ImageConversionFlags flags = Qt::AutoColor)

返回指定image 的副本，该副本已使用指定的图像转换flags 转换为位图。

另请参阅 fromData()。

[static] QBitmap QBitmap::fromImage(QImage &&image, Qt::ImageConversionFlags flags = Qt::AutoColor)

返回所给image 的副本，该副本已使用指定的图像转换flags 转换为位图。

另请参阅 fromData()。

[static, since 6.0] QBitmap QBitmap::fromPixmap(const QPixmap &pixmap)

返回将给定的pixmap 转换为位图后的副本。

如果像素图的深度大于 1，生成的位图将自动进行抖动处理。

该函数在 Qt 6.0 中引入。

另请参阅 QPixmap::depth()。

void QBitmap::swap(QBitmap &other)

将此位图与other 互换。此操作速度极快，且绝不会失败。

QBitmap QBitmap::transformed(const QTransform &matrix) const

返回该位图的副本，并根据给定的matrix 进行变换。

另请参阅 QPixmap::transformed()。

QBitmap::operator QVariant() const

将位图作为QVariant 返回。