PySide6.QtGui.QBitmap¶
- class QBitmap¶
-
概要¶
方法¶
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通过使用隐式数据共享进行了优化。有关更多信息，请参阅隐式数据共享文档。- __init__()¶
构建一个空位图。
另请参阅
- __init__(pixmap)
- Parameters:
pixmap –
QPixmap
注意
此函数已弃用。
请使用
fromPixmap代替。构造一个位图，该位图是给定pixmap的副本。如果 pixmap 的深度大于 1，生成的位图将自动进行抖动处理。
另请参阅
depth()fromImage()fromData()- __init__(size)
- Parameters:
大小 –
QSize
请使用
fromPixmap代替。使用给定的
size构造一个位图。位图中的像素未初始化。另请参阅
- __init__(fileName[, format=None])
- Parameters:
fileName – str
format – str
从指定的
fileName文件中构造一个位图。如果文件不存在，或者格式未知，位图将变为空位图。fileName和format参数被传递给load()函数。如果文件格式每像素使用超过1位，生成的位图将自动进行抖动处理。另请参阅
- __init__(w, h)
- Parameters:
w – 整数
h – 整数
使用给定的
width和height构造一个位图。内部的像素未初始化。另请参阅
- clear()¶
清除位图，将其所有位设置为Qt::color0。
- static fromData(size, bits[, monoFormat=QImage.Format_MonoLSB])¶
使用给定的
size构造一个位图，并将内容设置为提供的bits。位图数据必须按字节对齐，并以
monoFormat指定的位顺序提供。单色格式必须是Format_Mono或Format_MonoLSB。使用Format_Mono来指定XBM格式的数据。另请参阅
fromImage()返回将给定的
pixmap转换为位图的副本。如果 pixmap 的深度大于 1，生成的位图将自动进行抖动处理。
另请参阅
depth()将此位图与
other位图交换。此操作非常快速且永远不会失败。- transformed(matrix)¶
- Parameters:
矩阵 –
QTransform- Return type:
返回此位图的副本，根据给定的
matrix进行转换。另请参阅