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

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()

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

第 8 行 with self.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()

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

第 3 行 from kivy.graphics import Color, 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 行 def on_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-实现绘图功能/