PyQt - QPixmap Class

QPixmap class provides an off-screen representation of an image. It can be used as a QPaintDevice object or can be loaded into another widget, typically a label or button.

Qt API has another similar class QImage, which is optimized for I/O and other pixel manipulations. Pixmap, on the other hand, is optimized for showing it on screen. Both formats are interconvertible.

The types of image files that can be read into a QPixmap object are as follows −

BMP	Windows Bitmap
GIF	Graphic Interchange Format (optional)
JPG	Joint Photographic Experts Group
JPEG	Joint Photographic Experts Group
PNG	Portable Network Graphics
PBM	Portable Bitmap
PGM	Portable Graymap
PPM	Portable Pixmap
XBM	X11 Bitmap
XPM	X11 Pixmap

Following methods are useful in handling QPixmap object −

Sr.No.	Methods & Description
1	copy() Copies pixmap data from a QRect object
2	fromImage() Converts QImage object into QPixmap
3	grabWidget() Creates a pixmap from the given widget
4	grabWindow() Create pixmap of data in a window
5	Load() Loads an image file as pixmap
6	save() Saves the QPixmap object as a file
7	toImage Converts a QPixmap to QImage

The most common use of QPixmap is to display image on a label/button.

Example

The following example shows an image displayed on a QLabel by using the setPixmap() method. The complete code is as follows −

import sys
from PyQt4.QtCore import *
from PyQt4.QtGui import *

def window():
   app = QApplication(sys.argv)
   win = QWidget()
   l1 = QLabel()
   l1.setPixmap(QPixmap("python.jpg"))
	
   vbox = QVBoxLayout()
   vbox.addWidget(l1)
   win.setLayout(vbox)
   win.setWindowTitle("QPixmap Demo")
   win.show()
   sys.exit(app.exec_())
	
if __name__ == '__main__':
   window()

The above code produces the following output −