本文将主要介绍Pygame的draw模块,主要内容翻译自pygame的官方文档 http://www.pygame.org/docs/ref/draw.html
pygame.draw 模块用于在Surface上绘制一些简单的图形,比如点、直线、矩形、圆、弧等。
pygame.draw中函数的第一个参数总是一个surface,然后是颜色,再后会是一系列的坐标等。稍有些计算机绘图经验的人就会知道,计算机里的坐标,(0,0)代表左上角。而返回值是一个Rect对象,包含了绘制的领域,这样你就可以很方便的更新那个部分了。
先从整体来看pygame.draw有哪些函数:
pygame.draw.rect: 绘制矩形
pygame.draw.polygon: 绘制任意边数的多边形
pygame.draw.circle: 绘制圆
pygame.draw.ellipse: 在矩形内绘制椭圆
pygame.draw.arc: 绘制圆弧(或者椭圆的一部分)pygame.draw.line: 绘制直线(线段)
pygame.draw.lines: 从一个点列表中连续绘制直线段pygame.draw.aaline: 绘制一根平滑的线(反锯齿)pygame.draw.aalines: 绘制一系列平滑的线
大多数函数接受一个width参数表示线条(画笔)的宽度,如果该值设置为0,则表示填充整个图形。
所有的绘制函数都会尊重指定的Surface编辑区,而且会限制在这个区域内。函数的返回值是一个Rect,表示的是受影响的Surface区域
(原文:All the drawing functions respect the clip area for the Surface, and will be constrained to that area. The functions return a rectangle representing the bounding area of changed pixels.)
颜色参数通常是一个RGB三元组(R, G, B)。也可以接受RGBA形式的颜色值。
这些绘制函数会临时锁定所操作的Surface对象。
pygame.draw.rect 原型:pygame.draw.rect(Surface, color, Rect, width=0): return Rect 用途:在Surface上绘制矩形,第二个参数是线条(或填充)的颜色,第三个参数Rect的形式是((x, y), (width, height)),表示的是所绘制矩形的区域,其中第一个元组(x, y)表示的是该矩形左上角的坐标,第二个元组 (width, height)表示的是矩形的宽度和高度。width表示线条的粗细,单位为像素;默认值为0,表示填充矩形内部。 此外,Surface.fill 同样可以用来绘制填充矩形。
pygame.draw.polygon 原型:pygame.draw.polygon(Surface, color, pointlist, width=0): return Rect 用途:polygon是多边形,这个函数和rect类似,除了第三个参数。顾名思义,pointlist是一个坐标点的列表,表示多边形的各个顶点。
pygame.draw.circle 原型:pygame.draw.circle(Surface, color, pos, radius, width=0): return Rect 用途:用于绘制圆形。第三个参数pos是圆心的位置坐标,radius指定了圆的半径。
pygame.draw.ellipse 原型:pygame.draw.ellipse(Surface, color, Rect, width=0): return Rect 用途:ellipse是椭圆形,这个函数在矩形 Rect 内部绘制一个内接椭圆。
pygame.draw.arc 原型:pygame.draw.arc(Surface, color, Rect, start_angle, stop_angle, width=1): return Rect 用途:绘制一段圆弧,或者其实是上面提到的椭圆的一部分。与ellipse函数相比,多了两个参数:start_angle是该段圆弧的起始角度,stop_angle是终止角度。这两个都是用弧度制来表示的,而原点就是矩形Rect的中心。在Rect平面上建立坐标系,原点是中心,简单示意图如下。0弧度的起点是右边的中点处。
pygame.draw.line 原型:pygame.draw.line(Surface, color, start_pos, end_pos, width=1): return Rect 用途:绘制直线段,start_pos 和 end_pos 分别表示起始点和终止点,用坐标表示。width为线条宽度,默认为1. 线条两端自然结束,没有明显的端点(如实心黑点)。
pygame.draw.lines 原型:pygame.draw.lines(Surface, color, closed, pointlist, width=1): return Rect 用途:用于绘制一系列直线段。closed是一个布尔变量,如果closed为真,那么表示需要把第一点和最后一点连接起来。这些点来自pointlist,一个包含坐标点的列表。这个函数不会绘制线条的端点,也没有斜角连接(miter joints),而且角度小和线条粗的连线看起来会有点奇怪( Lines with sharp corners and wide line widths can have improper looking corners.)。
pygame.draw.aaline 原型:pygame.draw.aaline(Surface, color, startpos, endpos, blend=1): return Rect 用途:绘制一条平滑的(消除锯齿)直线段。
pygame.draw.aalines 原型:pygame.draw.aalines(Surface, color, closed, pointlist, blend=1): return Rect 用途:绘制连续的抗锯齿线段。该函数还有上面的aaline的用法和前两个类似。