Pygame详解（二十三）：gfxdraw 模块

Bertha 。 2022-03-27 01:30 688阅读 0赞

# **pygame.gfxdraw** #

Pygame 中绘制图形的模块。

## **函数** ##

*  pygame.gfxdraw.pixel()  ——  绘制一个像素点
 *  pygame.gfxdraw.hline() ——  绘制一条水平线
 *  pygame.gfxdraw.vline()  ——  绘制一条垂直线
 *  pygame.gfxdraw.rectangle()  ——  绘制一个矩形边框
 *  pygame.gfxdraw.box()  ——  绘制一个填充的矩形
 *  pygame.gfxdraw.line()  ——  绘制一条直线
 *  pygame.gfxdraw.circle()  ——  绘制一个圆形边框
 *  pygame.gfxdraw.arc()  ——  绘制一条弧线
 *  pygame.gfxdraw.aacircle()  ——  绘制一个平滑（抗锯齿）的圆形
 *  pygame.gfxdraw.filled\_circle()  ——  绘制一个填充的圆形
 *  pygame.gfxdraw.ellipse()  ——  绘制一个椭圆形边框
 *  pygame.gfxdraw.aaellipse()  ——  绘制一个平滑（抗锯齿）的椭圆形
 *  pygame.gfxdraw.filled\_ellipse()  ——  绘制一个填充的椭圆形
 *  pygame.gfxdraw.pie()  ——  绘制一个扇形边框
 *  pygame.gfxdraw.trigon()  ——  绘制一个三角形边框
 *  pygame.gfxdraw.aatrigon()  ——  绘制一个平滑（抗锯齿）的三角形
 *  pygame.gfxdraw.filled\_trigon()  ——  绘制一个填充的三角形
 *  pygame.gfxdraw.polygon()  ——  绘制一个多边形边框
 *  pygame.gfxdraw.aapolygon()   ——  绘制一个平滑（抗锯齿）的多边形
 *  pygame.gfxdraw.filled\_polygon()  ——  绘制一个填充的多边形
 *  pygame.gfxdraw.textured\_polygon()  ——  绘制一个纹理填充的多边形
 *  pygame.gfxdraw.bezier()  ——  绘制一条贝塞尔曲线

**注意：当前版本 API 函数可能会在下一个版本发生改变或者取消。如果你要使用这个实验性的模块，你的代码将可能会与之后的 Pygame 版本不兼容。**

在一个 Surface 上绘制出几种图形。

大多数函数中有一个表示 RGB 色彩的三元组参数，有时也接收一个表示 RGBA 色彩的四元组参数，色彩参数也可以是已经映射到 Surface 对象内的像素格式下的一个整数值。

所有函数的参数都使用固定坐标，坐标和圆的半径仅支持整数描述。

对于类似绘制矩形函数，尽管传入一个 [pygame.Rect][] 对象才是首选，但也可以接收一个用于描述 rect 的参数，像 (x, y, w, h) 序列。注意，对于一个 [pygame.Rect][] 对象来说，矩形将不包含右边和底边。因此，对于 Rect 的 right 和 bottom 属性的值其实是不再矩形上的。

绘制平滑和填充的图形，首先使用抗锯齿版本的函数（"aa" 开头的那些），然后使用填充版本的函数。

例如：

col = (255, 0, 0)
    surf.fill((255, 255, 255))
    pygame.gfxdraw.aacircle(surf, x, y, 30, col)
    pygame.gfxdraw.filled_circle(surf, x, y, 30, col)

注意：pygame 不会自动导入 pygame.gfxdraw 模块（因为目前来说，这还是一个实验性的模块），所以你需要在使用之前自己导入。

线程提示：在调用 C 语言函数部分，都会释放 GIL（Global Interpreter Lock，全局解释器锁）。

pygame.gfxdraw 模块不同于 [draw][] 模块的 API 函数使用，并且绘制的图形也不一样。因为它打包了 SDL\_gfx 库的原函数，而非使用修订后的版本。

## **函数详解** ##

### **pygame.gfxdraw.pixel()** ###

绘制一个像素点。

pixel(surface, x, y, color) -> None

在 Surface 对象上绘制一个像素点。

### **pygame.gfxdraw.hline()** ###

绘制一条水平线。

hline(surface, x1, x2, y, color) -> None

在 Surface 对象上的 y 坐标处，绘制一条从 x1 到 x2 的直线。

### **pygame.gfxdraw.vline()** ###

绘制一条垂直线。

vline(surface, x, y1, y2, color) -> None

在 Surface 对象上的 x 坐标处，绘制一条从 y1 到 y2 的直线。

### **pygame.gfxdraw.rectangle()** ###

绘制一个矩形边框。

rectangle(surface, rect, color) -> None

在 Surface 对象上绘制一个矩形边框，rect 参数指定矩形的区域。

记住，[Surface.fill()][Surface.fill] 方法也可以用于绘制填充矩形。事实上，[Surface.fill()][Surface.fill] 可以在一些平台上可以使用硬件加速，无论是软件还是硬件显示模式。

### **pygame.gfxdraw.box()** ###

绘制一个填充的矩形。

box(surface, rect, color) -> None

在 Surface 对象上绘制一个填充的矩形。

### **pygame.gfxdraw.line()** ###

绘制一条直线。

line(surface, x1, y1, x2, y2, color) -> None

在 Surface 对象上绘制一条直线，没有 endcaps。

### **pygame.gfxdraw.circle()** ###

绘制一个圆形。

circle(surface, x, y, r, color) -> None

在 Surface 对象上绘制一个圆形边框。坐标参数 (x,y) 决定圆心的位置，r 参数决定半径长度。没有用颜色进行填充。

### **pygame.gfxdraw.arc()** ###

绘制一条弧线。

arc(surface, x, y, r, start, end, color) -> None

在 Surface 对象上绘制一条弧线。

### **pygame.gfxdraw.aacircle()** ###

绘制一个平滑（抗锯齿）的圆形。

aacircle(surface, x, y, r, color) -> None

在 Surface 对象上绘制一个平滑（抗锯齿）的圆形。

### **pygame.gfxdraw.filled\_circle()** ###

绘制一个填充的圆形。

filled\_circle(surface, x, y, r, color) -> None

在 Surface 对象上绘制一个填充的原型，填充的颜色由 color 参数指定。

### **pygame.gfxdraw.ellipse()** ###

绘制一个椭圆形边框。

ellipse(surface, x, y, rx, ry, color) -> None

在 Surface 对象上绘制一个椭圆形边框。

### **pygame.gfxdraw.aaellipse()** ###

绘制一个平滑（抗锯齿）的椭圆形。

aaellipse(surface, x, y, rx, ry, color) -> None

在 Surface 对象上绘制一个平滑（抗锯齿）的椭圆形。

### **pygame.gfxdraw.filled\_ellipse()** ###

绘制一个填充的椭圆形。

filled\_ellipse(surface, x, y, rx, ry, color) -> None

在 Surface 对象上绘制一个填充的椭圆形，填充的颜色由 color 参数指定。

### **pygame.gfxdraw.pie()** ###

绘制一个扇形边框。

pie(surface, x, y, r, start, end, color) -> None

在 Surface 对象上绘制一个扇形边框。

### **pygame.gfxdraw.trigon()** ###

绘制一个三角形边框。

trigon(surface, x1, y1, x2, y2, x3, y3, color) -> None

在 Surface 对象上绘制一个三角形边框。

### **pygame.gfxdraw.aatrigon()** ###

绘制一个平滑（抗锯齿）的三角形。

aatrigon(surface, x1, y1, x2, y2, x3, y3, color) -> None

在 Surface 对象上绘制一个平滑（抗锯齿）的三角形。

### **pygame.gfxdraw.filled\_trigon()** ###

绘制一个填充的三角形。

filled\_trigon(surface, x1, y1, x2, y2, x3, y3, color) -> None

在 Surface 对象上绘制一个填充的三角形，填充的颜色由 color 参数指定。

### **pygame.gfxdraw.polygon()** ###

绘制一个多边形边框。

polygon(surface, points, color) -> None

在 Surface 对象上绘制一个多边形边框。

### **pygame.gfxdraw.aapolygon()** ###

绘制一个平滑（抗锯齿）的多边形。

aapolygon(surface, points, color) -> None

在 Surface 对象上绘制一个平滑（抗锯齿）的多边形

### **pygame.gfxdraw.filled\_polygon()** ###

绘制一个填充的多边形。

filled\_polygon(surface, points, color) -> None

在 Surface 对象上绘制一个填充的多边形，填充的颜色由 color 参数指定。

### **pygame.gfxdraw.textured\_polygon()** ###

绘制一个纹理填充的多边形。

textured\_polygon(surface, points, texture, tx, ty) -> None

在 Surface 对象上绘制一个纹理填充的多边形。

一个带 alpha 通道的纹理绘制到另一个带 alpha 通道的 Surface 对象上，将不同于使用 Surface.blit() 绘制。

带 alpha 通道的纹理不能被用于一个 8 位单像素的目标。

### **pygame.gfxdraw.bezier()** ###

绘制一条贝塞尔曲线。

bezier(surface, points, steps, color) -> None

在 Surface 对象上绘制一条贝塞尔曲线。

[pygame.Rect]: https://blog.csdn.net/qq_41556318/article/details/86304872
[draw]: https://blog.csdn.net/qq_41556318/article/details/86302600
[Surface.fill]: https://blog.csdn.net/qq_41556318/article/details/86304940