QBitmap 类

QBitmap 类提供单色 (1 位深度) 像素图。更多...

头：	#include <QBitmap>
CMake:	find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake:	QT += gui
继承：	QPixmap

公共函数

	QBitmap ()
	QBitmap (int width , int height )
	QBitmap (const QString & fileName , const char * format = nullptr)
void	clear ()
void	swap (QBitmap & other )
QBitmap	transformed (const QTransform & matrix ) const
QVariant	operator QVariant () const

静态公共成员

QBitmap	fromData (const QSize & size , const uchar * bits , QImage::Format monoFormat = QImage::Format_MonoLSB)
QBitmap	fromImage (const QImage & image , Qt::ImageConversionFlags flags = Qt::AutoColor)
QBitmap	fromImage (QImage && image , Qt::ImageConversionFlags flags = Qt::AutoColor)
`(从 6.0 起)` QBitmap	fromPixmap (const QPixmap & pixmap )

详细描述

QBitmap 类是单色离屏描绘设备，主要用于创建自定义 QCursor and QBrush 对象，构造 QRegion 对象，及为像素图和 Widget 设置遮罩。

QBitmap 是 QPixmap 子类确保 1 深度，除 0 深度的 null 对象外。若将深度大于 1 的像素图赋值给位图，位图会自动抖动。

使用 QColor 对象 Qt::color0 and Qt::color1 当在 QBitmap 对象上绘制时 (或 QPixmap 对象采用 1 深度)。

描绘采用 Qt::color0 将位图位设为 0，和描绘采用 Qt::color1 将位图位设为 1。对于位图而言，0 位指示背景 (或透明像素)，而 1 位指示前景 (或不透明像素)。使用 clear () 函数以将所有位设为 Qt::color0 。注意，使用 Qt::black and Qt::white 颜色没有意义，因为 QColor::pixel() 值并不一定是黑色为 0，而白色为 1。

QBitmap 类提供 transformed () 函数返回位图的变换拷贝；使用 QTransform 参数以平移、缩放、剪切及旋转位图。此外，QBitmap 提供静态 fromData () 函数，返回构造位图从给定 uchar 数据，而静态 fromImage () 函数返回转换拷贝为 QImage 对象。

就像 QPixmap 类，QBitmap 通过使用隐式数据共享进行优化。更多信息，见隐式数据共享文档编制。

另请参阅 QPixmap , QImage , QImageReader ，和 QImageWriter .

成员函数文档编制

QBitmap:: QBitmap ()

构造 null 位图。

另请参阅 QPixmap::isNull ().

QBitmap:: QBitmap ( int width , int height )

构造位图采用给定 width and height 。内部的像素未被初始化。

另请参阅 clear ().

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

构造位图从指定文件通过给定 fileName 。若文件不存在或格式未知，则位图变为 null 位图。

The fileName and format 参数被传递给 QPixmap::load () 函数。若文件格式使用 1 位以上每像素，则结果位图会自动抖动。

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

void QBitmap:: clear ()

清零位图，将其所有位设为 Qt::color0 .

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

构造位图采用给定 size ，并将内容设为 bits 供给。

位图数据必须按字节对齐，并按位次序提供指定通过 monoFormat 。单色格式必须是 QImage::Format_Mono or 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 ().

QVariant QBitmap:: operator QVariant () const

将位图返回为 QVariant .