PySide6.QtGui.QBitmap¶

class QBitmap¶

QBitmap 类提供了单色（1位深度）的位图。更多…

概要¶

方法¶

def __init__()
def clear()
def swap()
def transformed()

静态函数¶

def fromData()
def fromPixmap()

注意

本文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译问题，您也可以通过在我们的https:/bugreports.qt.io/projects/PYSIDE上创建工单来告知我们。

详细描述¶

QBitmap 类是一个单色的离屏绘图设备，主要用于创建自定义的 QCursor 和 QBrush 对象，构建 QRegion 对象，以及为像素图和窗口部件设置遮罩。

QBitmap 是 QPixmap 的一个子类，确保深度为1，除了深度为0的空对象。如果将深度大于1的像素图分配给位图，位图将自动进行抖动处理。

在绘制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通过使用隐式数据共享进行了优化。有关更多信息，请参阅隐式数据共享文档。

另请参阅

QPixmap QImage QImageReader QImageWriter

__init__()¶

构建一个空位图。

另请参阅

isNull()

__init__(pixmap)

Parameters:: pixmap – QPixmap

注意

此函数已弃用。

请使用 fromPixmap 代替。构造一个位图，该位图是给定 pixmap 的副本。

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

另请参阅

depth() fromImage() fromData()

__init__(size)

Parameters:: 大小 – QSize

请使用 fromPixmap 代替。

使用给定的size构造一个位图。位图中的像素未初始化。

另请参阅

clear()

__init__(fileName[, format=None])

Parameters:

fileName – str
format – str

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

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

另请参阅

isNull() imageFormat()

__init__(w, h)

Parameters:

w – 整数
h – 整数

使用给定的width和height构造一个位图。内部的像素未初始化。

另请参阅

clear()

clear()¶

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

static fromData(size, bits[, monoFormat=QImage.Format_MonoLSB])¶

Parameters:

size – QSize
bits – 字符串
monoFormat – Format

Return type:

QBitmap

使用给定的size构造一个位图，并将内容设置为提供的bits。

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

另请参阅

fromImage()

static fromPixmap(pixmap)¶

Parameters:: pixmap – QPixmap
Return type:: QBitmap

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

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

另请参阅

depth()

swap(other)¶

Parameters:: 其他 – QBitmap

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

transformed(matrix)¶

Parameters:: 矩阵 – QTransform
Return type:: QBitmap

返回此位图的副本，根据给定的matrix进行转换。

另请参阅

transformed()