class QBitmap#

QBitmap 提供单色(1位深度)的位图。 更多

Inheritance diagram of PySide6.QtGui.QBitmap

概述#

方法#

静态函数#

注解

此文档可能包含自动从C++转换为Python的代码片段。我们始终欢迎对代码片段进行翻译的贡献。如果您发现翻译有问题,您也可以通过在https:/bugreports.qt.io/projects/PYSIDE上创建ticket来通知我们

详细信息#

QBitmap是一个用于创建自定义QCursorQBrush对象、构建QRegion对象以及设置位图和部件遮罩的单色离屏绘制设备。

QBitmap 是一个确保深度为 1 的 QPixmap 子类,除了空对象外,其深度为 0。如果将具有大于 1 的深度的 pixmap 分配给位图,位图将被自动抖动。

QBitmap 对象(或深度为 1 的 QPixmap 对象)上绘图时使用 QColor 的 Qt::color0 和 Qt::color1 对象。

使用 Qt::color0 绘制会将位图位设置为 0,而使用 Qt::color1 绘制会将位设置为 1。对于位图,0 位表示背景(或透明像素),而 1 位表示前景(或不透明像素)。使用 clear() 函数将所有位设置为 Qt::color0。请注意,使用 Qt::black 和 Qt::white 颜色没有意义,因为 QColor::pixel() 值对于黑色和白色未必分别是 0 和 1。

QBitmap 类提供了返回位图变换副本的 transformed() 函数;使用 QTransform 参数平移、缩放、倾斜和旋转位图。此外,QBitmap 还提供了静态的 fromData() 函数,该函数返回从给定 uchar 数据构建的位图,以及静态的 fromImage() 函数,返回 QImage 对象的转换副本。

QPixmap 类一样,QBitmap 通过隐式数据共享进行优化。有关更多信息,请参阅隐式数据共享文档。

__init__()#

构造一个空位图。

参阅 also

isNull()

__init__(arg__1)
参数:

arg__1QPixmap

注解

此函数已被废弃。

建议使用 fromPixmap。从指定的 pixmap 构建一个位图。

如果位图的深度大于1,结果位图将被自动抖动。

参阅 also

depth() fromImage() fromData()

__init__(arg__1)
参数:

arg__1QSize

建议使用 fromPixmap

构建一个具有给定 size 的位图。位图中的像素没有被初始化。

参阅 also

clear()

__init__(fileName[, format=None])
参数:
  • fileName – str

  • format – str

从指定的 fileName 文件中构造一个位图。如果文件不存在,或格式未知,则位图将变为空位图。

fileNameformat 参数将被传递给 load() 函数。如果文件格式使用每像素多于1位,则结果位图将被自动抖动。

参阅 also

isNull() imageFormat()

__init__(w, h)
参数:
  • w – int

  • h – int

构建一个具有给定 widthheight 的位图。内部像素未被初始化。

参阅 also

clear()

clear()#

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

static fromData(size, bits[, monoFormat=QImage.Format_MonoLSB])#
参数:
  • 大小QSize

  • 比特 – 字符串

  • 单色格式Format

返回类型:

QBitmap

使用给定的 size 构建位图,并将内容设置为提供的 bits

位图数据必须是字节对齐的,并以 monoFormat 指定的位序提供。单色格式必须是 Format_MonoFormat_MonoLSB 。使用 Format_Mono 来指定 XBM 格式的数据。

参阅 also

fromImage()

静态 fromPixmap(pixmap)#
参数:

pixmapQPixmap

返回类型:

QBitmap

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

如果位图的深度大于1,结果位图将被自动抖动。

参阅 also

深度()

swap(other)#
参数:

otherQBitmap

与位图 other 交换。此操作非常快,永远不会失败。

transformed(matrix)#
参数:

矩阵QTransform

返回类型:

QBitmap

返回一个副本位图,根据给定的 matrix 转换。

参阅 also

transformed()