QBitmap

The QBitmap class provides monochrome (1-bit depth) pixmaps. More

Inheritance diagram of PySide2.QtGui.QBitmap

Synopsis

Functions

Static functions

  • def fromData (size, bits[, monoFormat=QImage.Format_MonoLSB])

Detailed Description

The QBitmap class is a monochrome off-screen paint device used mainly for creating custom QCursor and QBrush objects, constructing QRegion objects, and for setting masks for pixmaps and widgets.

QBitmap is a QPixmap subclass ensuring a depth of 1, except for null objects which have a depth of 0. If a pixmap with a depth greater than 1 is assigned to a bitmap, the bitmap will be dithered automatically.

Use the QColor objects color0 and color1 when drawing on a QBitmap object (or a QPixmap object with depth 1).

Painting with color0 sets the bitmap bits to 0, and painting with color1 sets the bits to 1. For a bitmap, 0-bits indicate background (or transparent pixels) and 1-bits indicate foreground (or opaque pixels). Use the clear() function to set all the bits to color0 . Note that using the black and white colors make no sense because the QColor::pixel() value is not necessarily 0 for black and 1 for white.

The QBitmap class provides the transformed() function returning a transformed copy of the bitmap; use the QTransform argument to translate, scale, shear, and rotate the bitmap. In addition, QBitmap provides the static fromData() function which returns a bitmap constructed from the given uchar data, and the static fromImage() function returning a converted copy of a QImage object.

Just like the QPixmap class, QBitmap is optimized by the use of implicit data sharing. For more information, see the Implicit Data Sharing documentation.

class QBitmap

QBitmap(other)

QBitmap(arg__1)

QBitmap(arg__1)

QBitmap(fileName[, format=None])

QBitmap(w, h)

param w

int

param h

int

param format

str

param arg__1

QPixmap

param other

QBitmap

param fileName

unicode

Constructs a null bitmap.

See also

isNull()

Constructs a bitmap with the given width and height . The pixels inside are uninitialized.

See also

clear()

PySide2.QtGui.QBitmap.clear()

Clears the bitmap, setting all its bits to color0 .

static PySide2.QtGui.QBitmap.fromData(size, bits[, monoFormat=QImage.Format_MonoLSB])
Parameters
  • sizeQSize

  • bitsuchar

  • monoFormatFormat

Return type

QBitmap

Constructs a bitmap with the given size , and sets the contents to the bits supplied.

The bitmap data has to be byte aligned and provided in in the bit order specified by monoFormat . The mono format must be either Format_Mono or Format_MonoLSB . Use Format_Mono to specify data on the XBM format.

See also

fromImage()

PySide2.QtGui.QBitmap.swap(other)
Parameters

otherQBitmap

Swaps bitmap other with this bitmap. This operation is very fast and never fails.

PySide2.QtGui.QBitmap.transformed(arg__1)
Parameters

arg__1QMatrix

Return type

QBitmap

Note

This function is deprecated.

PySide2.QtGui.QBitmap.transformed(matrix)
Parameters

matrixQTransform

Return type

QBitmap