Kivy 中文教程实例入门简易画板 (Simple Paint App)：2. 实现绘图功能

小咪咪 2022-06-05 06:45 176阅读 0赞

**1. 理解 kivy 坐标系统**

上一节中，咪博士带大家实现了画板程序的基础框架，以及一个基本的自定义窗口部件（widget）。在上一节的末尾，咪博士留了一道关于 kivy 坐标系统的思考题给大家。通过点击窗口的 4 个角落，观察相应的控制台输出，我们可以推断出 kivy 的坐标原点位于窗口的左下角，x 轴正方向为水平向右，y 轴正方向为竖直向上。这和我们中学数学中常见的平面直角坐标系是一模一样的。

**2. 绘制圆点**

了解了 kivy 的坐标系统，本节咪博士将教大家实现简易画板的核心功能：绘图。

重点需要修改的是 MyPaintWidget 的 on\_touch\_down 方法，同时还要在程序开头（第 3 行）添加导入颜色和画图的函数。修改后的代码如下：

from kivy.app import App from kivy.uix.widget import Widget from kivy.graphics import Color, Ellipse class MyPaintWidget(Widget): def on_touch_down(self, touch): with self.canvas: Color(1, 1, 0) d = 30. Ellipse(pos=(touch.x - d / 2, touch.y - d / 2), size=(d, d)) class MyPaintApp(App): def build(self): return MyPaintWidget() if __name__ == '__main__': MyPaintApp().run()

运行程序，当用鼠标左键在窗口上点击的时候，程序会在鼠标点击的位置绘制出一个黄色的圆点。

![kivy_simple_paint_app_paint_dot.png][]

第 8 行 withself.canvas: ，使用 with 语句进入自定义窗口部件 (MyPaintWidget) 的画布 (canvas) 上下文。窗口部件 (widget) 的画布 (canvas) 对应窗口部件在屏幕上的显示区域，我们可以在上面绘制各种图形。执行第 8 行代码之后，后续的绘图语句就会在这个画布上绘制出各种图形了。with 语句还能确保当我们退出画布上下文的时候，程序自动清理与画布有关的内部状态并释放相应的资源。

第 9 行 Color(1,1,0) 将画笔的颜色设置为黄色。Color 采用 RGB（红、绿、蓝）三原色来表示颜色，每个颜色分量的取值为 \[0, 1\] 之间。这里我们混合红色和绿色（第 1, 2 个参数为 1），剔除蓝色（第 3 个参数为 0），根据三原色的原理，我们将得到黄色。设置好颜色之后，后续的绘图都将采用这个颜色，直到你用 Color 函数再次改变颜色。这就好像你用画笔蘸上黄色的颜料（调用 Color 函数），你随后画出的图案就都是黄色的，一直到你再蘸其他的颜料（再次调用 Color 函数），改变画笔的颜色。

第 10 行 d=30.设置圆的直径，后续的代码将根据变量 d 的值来画圆。如果，我们想改变圆的大小，只要修改变量 d 的值就可以了，这也是将圆的直径保存到变量中，给程序带来的灵活性。

第 11 行 Ellipse(pos=(touch.x\-d/2,touch.y\-d/2),size=(d,d)) 调用Ellipse 函数在鼠标点击的位置，按照指定的直径画圆。Ellipse 函数中，圆的位置用圆的外切正方形来表示。其中，第 1 个参数 pos 表示外切正方形左下角的坐标（x, y），第 2 个参数 size 表示外切正方形的大小（宽、高）。我们想要让圆心落在鼠标点击的位置，因此，对应的外切正方形左下角坐标为 (touch.x\-d/2,touch.y\-d/2)

**3. 绘制线条**

接着，我们要实现拖拽鼠标绘制线条的功能。代码如下：

from kivy.app import App from kivy.uix.widget import Widget from kivy.graphics import Color, Ellipse, Line class MyPaintWidget(Widget): def on_touch_down(self, touch): with self.canvas: Color(1, 1, 0) d = 30. Ellipse(pos=(touch.x - d / 2, touch.y - d / 2), size=(d, d)) touch.ud['line'] = Line(points=(touch.x, touch.y)) def on_touch_move(self, touch): touch.ud['line'].points += [touch.x, touch.y] class MyPaintApp(App): def build(self): return MyPaintWidget() if __name__ == '__main__': MyPaintApp().run()

程序运行后的效果像下面这样

![kivy_simple_paint_app_paint_lines.png][]

第 3 行 fromkivy.graphicsimportColor,Ellipse,Line我们导入函数 Line 用于绘制线条。函数 Line 接受一个由一系列点的坐标所构成的列表，然后依次在相邻 2 点之间绘制线条。

第 12 行中的 touch.ud 是一个 Python 字典 (dict)，我们可以用它来存储与 touch 事件相关的数据。整个第 12 行 touch.ud\['line'\]=Line(points=(touch.x,touch.y)) 表示的意思是，当鼠标按下时（触发 on\_touch\_down 事件），以鼠标点击的位置 (touch.x, touch.y) 为起点绘制线条（调用 Line 函数），然后将该线条保存到 touch.ud 字典中（对应的 key 值为 ‘line’）。由于，鼠标点击只能产生 1 个点，而 1 个点是没有办法绘制线条的，所以单纯的鼠标点击是无法在屏幕上看到任何线条的。但是，这里确实产生了一个线条，并且我们将它保存到 touch.ud\[‘line’\] 中，随后的代码将继续往这个线条中添加坐标点，而一系列点的连线就可以显示出来了。

第 14 行 defon\_touch\_move(self,touch):  添加了一个新的方法 on\_touch\_move。当用户拖拽鼠标时，将触发该函数（执行该函数中的代码）。一次鼠标拖拽通常会连续多次触发 on\_touch\_move 方法，相当于将一次移动拆解成很多个微小的移动，而每一次移动的位置则通过 touch 参数传递给 on\_touch\_move 方法。

第 15 行 touch.ud\['line'\].points\+=\[touch.x,touch.y\] 将鼠标拖拽产生的坐标点，添加到保存在 touch.ud\[‘line’\] 中的线条中。

原文链接：[http://www.ipaomi.com/2017/11/16/kivy-中文教程-实例入门-简易画板-simple-paint-app：2-实现绘图功能/][http_www.ipaomi.com_2017_11_16_kivy-_-_-_-simple-paint-app_2-]

[kivy_simple_paint_app_paint_dot.png]: http://www.ipaomi.com/wp-content/uploads/2017/11/kivy_simple_paint_app_paint_dot.png
[kivy_simple_paint_app_paint_lines.png]: http://www.ipaomi.com/wp-content/uploads/2017/11/kivy_simple_paint_app_paint_lines.png
[http_www.ipaomi.com_2017_11_16_kivy-_-_-_-simple-paint-app_2-]: http://www.ipaomi.com/2017/11/16/kivy-%e4%b8%ad%e6%96%87%e6%95%99%e7%a8%8b-%e5%ae%9e%e4%be%8b%e5%85%a5%e9%97%a8-%e7%ae%80%e6%98%93%e7%94%bb%e6%9d%bf-simple-paint-app%ef%bc%9a2-%e5%ae%9e%e7%8e%b0%e7%bb%98%e5%9b%be%e5%8a%9f%e8%83%bd/