使用 PyQt5 实现图片查看器

 一、前言

  在学习 PyQt5 的过程中我会不断地做一些小的 Demo,用于让自己能够更好地理解和学习,这次要做的就是一个图片查看器,主要功能包括打开图片、拖动图片、放大和缩小图片。

  最终实现的图片查看器你效果如下:

  

 

二、主要步骤  

1.显示图片

  PyQt5 绘图系统能渲染矢量图像、位图图像和轮廓字体文本。一般会使用在修改或者提高现有组件的功能,或者创建自己的组件,使用 PyQt5 的绘图 API 进行操作。在 Qt 中有 QPainter 类用于执行绘制的操作,绘图由 paintEvent() 来完成,绘图的代码要放在 QPainter 对象的 start() 和 end() 方法之间。

  要将图片显示出来,首先是继承 QWidget,然后实现 paintEvent() 方法,主要是使用 drawPixmap() 方法,需要传入 QPixmap 对象并将其绘制出来,绘图的代码如下:

 1 def paintEvent(self, e):
 2     """
 3     receive paint events
 4     :param e: QPaintEvent
 5     :return:
 6     """
 7     if self.scaled_img:
 8         painter = QPainter()
 9         painter.begin(self)
10         painter.drawPixmap(self.point, self.scaled_img)
11         painter.end()

2.拖动图片

  在图片成功显示出来之后,需要能够去拖动图片,以便于查看图片的每个角落,主要得实现三个方法:mouseMoveEvent、mousePressEvent 和 mouseReleaseEvent,分别对应移动鼠标、点击鼠标和松开鼠标三个事件。

  思路是获取鼠标点击时的位置,然后根据鼠标位置的变化来计算图片需要移动的距离,再移动图片就行了。具体代码如下:

 1 def mouseMoveEvent(self, e):
 2     """
 3     mouse move events for the widget
 4     :param e: QMouseEvent
 5     :return:
 6     """
 7     if self.left_click:
 8         self.end_pos = e.pos() - self.start_pos
 9         self.point = self.point + self.end_pos
10         self.start_pos = e.pos()
11         self.repaint()
12 
13 def mousePressEvent(self, e):
14     """
15     mouse press events for the widget
16     :param e: QMouseEvent
17     :return:
18     """
19     if e.button() == Qt.LeftButton:
20         self.left_click = True
21         self.start_pos = e.pos()
22 
23 def mouseReleaseEvent(self, e):
24     """
25     mouse release events for the widget
26     :param e: QMouseEvent
27     :return:
28     """
29     if e.button() == Qt.LeftButton:
30         self.left_click = False

3.打开文件

  有时候我们会想打开本地的文件进行查看,所以还要实现一个打开文件的功能。而要实现这一功能,可以用 QFileDialog 类来实现,该类里有一个 getOpenFileName() 方法,使用该方法能够打开本地路径并选择符合文件要求格式的文件,例如使用“*.png”就支持打开所有 png 格式的图片文件,而不支持其他格式的文件。

  getOpenFileName() 方法有两个返回值,第一个返回值是所选择的文件的路径,第二个返回值是文件类型,得到文件路径后就能创建一个 QPixmap 对象,再使用前面显示图片的方法进行显示,具体代码如下:

1 def open_image(self):
2     """
3     select image file and open it
4     :return:
5     """
6     img_name, _ = QFileDialog.getOpenFileName(self, "Open Image File", "*.jpg;;*.png;;*.jpeg")
7     self.box.set_image(img_name)

4.放大缩小图片

  在查看图片的时候,有时候会需要放大了观看图片的某些细节部分,因而需要实现放大和缩小图片的功能,所以做了两个按钮分别用于放大图片和缩小图片。

  在 QPainter 中,可以根据 QPainter 的坐标系进行各种变换,例如平移(translate)和变化(scale),这里就可以通过使用 scale() 方法实现放大和缩小图片。下面是两个按钮点击时触发的方法的具体代码:

 1 def large_click(self):
 2     """
 3     used to enlarge image
 4     :return:
 5     """
 6     if self.box.scale < 2:
 7         self.box.scale += 0.1
 8         self.box.adjustSize()
 9         self.update()
10 
11 def small_click(self):
12     """
13     used to reduce image
14     :return:
15     """
16     if self.box.scale > 0.1:
17         self.box.scale -= 0.2
18         self.box.adjustSize()
19         self.update()

  

完整代码已上传到 GitHub

posted @ 2020-04-20 20:50  onionono  阅读(9870)  评论(0编辑  收藏  举报