Python pyglet 自制3D引擎入门(一) -- 绘制几何体、创建3D场景

已于 2025-02-08 11:50:32 修改
阅读量1w 收藏 63
点赞数 12
分类专栏： Python 3D图形绘制 文章标签： python 3d OpenGL 游戏开发 图形渲染
于 2022-10-03 12:34:57 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qfcy_/article/details/127149986
版权

Python作为目前应用较广泛的编程语言, 用于制作3D游戏可谓得心应手。本文讲解应用pyglet库绘制3D场景的入门技能。

下篇：Python pyglet 自制3D引擎入门(二) – 绘制立体心形，动画和相机控制

目录

1.导入pyglet及相关模块

pyglet.window部分用于实现窗口操作, pyglet.gl以及pyglet.gl.glu模块包含了OpenGL的绘图函数, 也是创建3D场景的关键。
pyglet模块可通过pip安装: pip install pyglet。

import pyglet
from pyglet.gl import * # 为方便使用, 导入opengl函数时建议使用import * 形式
from pyglet.gl.glu import *
from pyglet.window import key # 按键常量

2.创建窗口

WIDTH=400;HEIGHT=400
window = pyglet.window.Window(height=HEIGHT, width=WIDTH)
pyglet.app.run()

运行结果是出现了一个宽为400, 高为400的空白窗口。

3.绘制正方体

现在开始调用OpenGL的绘图函数，绘制基本的几何体。

创建3D绘图环境部分

这是OpenGL中初始化3D绘图环境的一般套路。如果是初学者，可以暂时不知道具体细节，只需按照套路编写代码即可。
glMatrixMode(mode)：用于指定当前矩阵的类型，可以是模型视图矩阵(GL_MODELVIEW)或投影矩阵(GL_PROJECTION)等。
glLoadIdentity()：将当前矩阵重置为单位矩阵，用于将当前矩阵设置为初始状态。
glFrustum(left, right, bottom, top, near, far)：定义一个透视投影矩阵，指定了视景体的六个裁剪面。
gluPerspective(fovy, aspect, zNear, zFar)：设置透视投影矩阵，指定了视场的垂直视角、宽高比、近裁剪面和远裁剪面。
glViewport(x, y, width, height)：设置视口，定义了窗口中用于绘制的区域。
glClear(mask)：清空指定的缓冲区，可以清空颜色缓冲区、深度缓冲区、模板缓冲区等。
gluLookAt(eyeX, eyeY, eyeZ, centerX, centerY, centerZ, upX, upY, upZ)：定义一个观察矩阵，指定了相机的位置、观察点的位置和相机的朝向。
glFlush()：强制将缓冲区中的绘制命令立即执行，也就是将缓冲区的图像绘制到屏幕上。

绘图部分
绘图部分使用了多个绘图函数，以下是函数的讲解：

  • glVertex3f(x, y, z) : 指定点、线段和多边形的顶点。3个参数分别是x, y, z坐标。通过反复调用这个函数, 就可以绘制出任何几何图形。

  • glBegin(mode)和glEnd(): 指定一段多边形、线段的开始和结束。开始一个绘制时调用glBegin(), 结束绘制时调用glEnd()。其中参数mode可以设置形状等信息。
    mode的值有GL_POINTS，GL_LINES，GL_LINE_LOOP，GL_TRIANGLES，GL_QUADS和GL_POLYGON等。这里用GL_POLYGON来绘制正方体的各个面。

  • glColor3f(r, g, b)函数可以设置图形颜色, 其中r、g、b的范围是0-1。

  • 绘制完成后, 需调用glFlush()函数, 将绘制的图形显示在屏幕上。

@window.event
def on_draw(): # 注意函数名, 须是on_draw才绑定绘制的事件
    # 这是创建3D绘图环境的代码
    glMatrixMode(GL_PROJECTION)  # 设置当前矩阵为投影矩阵
    glLoadIdentity()

    # 透视投影, 类似游戏中的FOV(视角大小)，2和1000分别为能看见的最近和最远距离
    glFrustum(-5, 5, -5, 5, 2, 1000)

    glMatrixMode(GL_MODELVIEW)  # 模型视图矩阵
    glLoadIdentity()

    glViewport(0, 0, WIDTH,HEIGHT)

    window.clear() # 或 glClear(GL_COLOR_BUFFER_BIT)
    glClear(GL_DEPTH_BUFFER_BIT) # 清除深度(z排序)缓冲区
 
    # 改变相机视角, 下文"相机控制"会介绍
    gluLookAt(cam_x,cam_y,cam_z,cam_x,cam_y,100000,0,1,0) # 相机始终朝着z轴正半轴方向看

    # 绘制正方体的顶、底面
    glColor3f(0.5,0.5,1)
    glBegin(GL_POLYGON)
    glVertex3f(10,10,10)
    glVertex3f(0,10,10)
    glVertex3f(0,0,10)
    glVertex3f(10,0,10)
    glEnd()

    glColor3f(0.5, 1, 0)
    glBegin(GL_POLYGON)
    glVertex3f(10, 10, 0)
    glVertex3f(0, 10, 0)
    glVertex3f(0, 0, 0)
    glVertex3f(10, 0, 0)
    glEnd()
    # 绘制4个侧面
    glColor3f(1, 0.5, 1)
    glBegin(GL_POLYGON)
    glVertex3f(10, 0, 10)
    glVertex3f(0, 0, 10)
    glVertex3f(0, 0, 0)
    glVertex3f(10, 0, 0)
    glEnd()

    glColor3f(0.5, 1, 1)
    glBegin(GL_POLYGON)
    glVertex3f(10, 10, 10)
    glVertex3f(0, 10, 10)
    glVertex3f(0, 10, 0)
    glVertex3f(10, 10, 0)
    glEnd()

    glColor3f(0.8, 0.5, 1)
    glBegin(GL_POLYGON)
    glVertex3f(10, 10, 10)
    glVertex3f(10, 10, 0)
    glVertex3f(10, 0, 0)
    glVertex3f(10, 0, 10)
    glEnd()

    glColor3f(1, 0.5, 0.5)
    glBegin(GL_POLYGON)
    glVertex3f(0, 10, 10)
    glVertex3f(0, 10, 0)
    glVertex3f(0, 0, 0)
    glVertex3f(0, 0, 10)
    glEnd()
    # 将绘制的图形显示在屏幕上
    glFlush()

运行效果:

4.相机控制、绑定事件

这里, 用户按方向键后, 程序就能改变相机的位置。

- gluLookAt(eyex, eyey, eyez, centerx, centery, centerz, upx, upy, upz)
第一组eyex, eyey,eyez 相机在世界坐标的位置
第二组centerx,centery,centerz 相机镜头对准的物体在世界坐标的位置
第三组upx,upy,upz 相机向上的方向在世界坐标中的方向

你把相机想象成为你自己的脑袋：
第一组数据就是脑袋的位置
第二组数据就是眼睛看的物体的位置
第三组就是头顶朝向的方向（因为你可以歪着头看同一个物体）

- pyglet.window模块中的key对象包含了许多按键常量, 可以在程序中使用。

cam_x=0;cam_y=0;cam_z=-5
@window.event
def on_key_press(k,m): # 函数名可表示绑定哪个事件，注意函数名必须是on_key_press
    global cam_x,cam_y,cam_z
    if k==key.DOWN: # 下
        cam_y-=1
    elif k==key.UP:# 上
        cam_y+=1
    elif k==key.LEFT: # 左
        cam_x-=1
    elif k==key.RIGHT: # 右
        cam_x+=1
    elif k==key.PAGEUP: # page up
        cam_z+=0.5
    elif k==key.PAGEDOWN: # page down
        cam_z-=0.5
    on_draw() # 重新绘制

# on_draw中相应的代码
gluLookAt(cam_x,cam_y,cam_z,cam_x,cam_y,100000,0,1,0)

运行后你会发现, 相机始终朝着z轴正半轴一个方向看, 这是程序的缺陷, 作者将在下篇中讲解更灵活的相机控制方法。

5.透明度和抗锯齿

透明度
要绘制透明的图形，只需要将glColor3f()函数更换为glColor4f()函数即可。

  • glColor4f(r, g, b, alpha)函数的alpha参数指定了透明度，alpha的范围是0-1。

此外，还要在初始化时调用glEnable和glBlendFunc函数，启用透明度功能。

glEnable(GL_BLEND) # 开启透明支持
glBlendFunc(GL_SRC_ALPHA,GL_ONE_MINUS_SRC_ALPHA)

抗锯齿
要实现抗锯齿效果，需要在创建窗口这一步中设置对应的选项。这里是多重采样(MSAA)抗锯齿。
将前面创建窗口的代码改成下面这样：

# sample_buffers为是否抗锯齿，depth_size为是否启用z排序
conf = pyglet.gl.Config(sample_buffers=1, samples=4, depth_size=1)
window = pyglet.window.Window(height=HEIGHT, width=WIDTH,
                              config=conf)

6.完整代码

import pyglet
from pyglet.gl import *
from pyglet.gl.glu import *
from pyglet.window import key

WIDTH=400;HEIGHT=400
cam_x=0;cam_y=0;cam_z=-5
# sample_buffers为抗锯齿，depth_size为启用z排序
conf = pyglet.gl.Config(sample_buffers=1, samples=4,depth_size=1)
window = pyglet.window.Window(height=HEIGHT, width=WIDTH,
                              config=conf)

@window.event
def on_draw(): # 注意函数名
    glMatrixMode(GL_PROJECTION)  # 设置当前矩阵为投影矩阵
    glLoadIdentity()
    # glEnable(GL_DEPTH_TEST)

    # 透视投影, 类似游戏中的FOV(视角大小)
    glFrustum(-5, 5, -5, 5, 2, 1000)

    glMatrixMode(GL_MODELVIEW)  # 模型视图矩阵
    glLoadIdentity()

    glViewport(0, 0, WIDTH,HEIGHT)

    window.clear() # 或 glClear(GL_COLOR_BUFFER_BIT)
    glClear(GL_DEPTH_BUFFER_BIT) # 清除深度(z排序)缓冲区
 
    # 改变相机位置和角度
    gluLookAt(cam_x,cam_y,cam_z,cam_x,cam_y,100000,0,1,0)

    # 顶、底面
    glColor4f(0.5, 0.5, 1, 0.5)
    glBegin(GL_POLYGON)
    glVertex3f(10,10,10)
    glVertex3f(0,10,10)
    glVertex3f(0,0,10)
    glVertex3f(10,0,10)
    glEnd()

    glColor4f(0.5, 1, 0, 0.5)
    glBegin(GL_POLYGON)
    glVertex3f(10, 10, 0)
    glVertex3f(0, 10, 0)
    glVertex3f(0, 0, 0)
    glVertex3f(10, 0, 0)
    glEnd()
    # 4个侧面
    glColor4f(1, 0.5, 1, 0.5)
    glBegin(GL_POLYGON)
    glVertex3f(10, 0, 10)
    glVertex3f(0, 0, 10)
    glVertex3f(0, 0, 0)
    glVertex3f(10, 0, 0)
    glEnd()

    glColor4f(0.5, 1, 1, 0.5)
    glBegin(GL_POLYGON)
    glVertex3f(10, 10, 10)
    glVertex3f(0, 10, 10)
    glVertex3f(0, 10, 0)
    glVertex3f(10, 10, 0)
    glEnd()

    glColor4f(0.8, 0.5, 1, 0.5)
    glBegin(GL_POLYGON)
    glVertex3f(10, 10, 10)
    glVertex3f(10, 10, 0)
    glVertex3f(10, 0, 0)
    glVertex3f(10, 0, 10)
    glEnd()

    glColor4f(1, 0.5, 0.5, 0.5)
    glBegin(GL_POLYGON)
    glVertex3f(0, 10, 10)
    glVertex3f(0, 10, 0)
    glVertex3f(0, 0, 0)
    glVertex3f(0, 0, 10)
    glEnd()

    glFlush()

@window.event
def on_key_press(k,m): # 注意函数名称
    global cam_x,cam_y,cam_z
    if k==key.DOWN: # 下
        cam_y-=1
    elif k==key.UP:# 上
        cam_y+=1
    elif k==key.LEFT: # 左
        cam_x-=1
    elif k==key.RIGHT: # 右
        cam_x+=1
    elif k==key.PAGEUP: # page up
        cam_z+=0.5
    elif k==key.PAGEDOWN: # page down
        cam_z-=0.5
    on_draw()

glClearColor(1, 1, 1, 1)
glEnable(GL_DEPTH_TEST) # 开启深度(z排序), 使程序支持近的物体遮挡远的物体
glEnable(GL_BLEND) # 开启透明支持
glBlendFunc(GL_SRC_ALPHA,GL_ONE_MINUS_SRC_ALPHA)
pyglet.app.run()

运行效果：

7.拓展: 绘制球体

绘制球体比绘制正方体还要简单, 因为OpenGL已经内置了画球体功能。不过需要单独安装PyOpenGL这个模块。
(Windows下如果安装报错, 可以下载这个文件pan.baidu.com/s/1MRewIxe2FcLO-IWgG-5fuA?pwd=1ga2,
然后解压到Python解释器目录\Lib\site-packages\OpenGL这个目录下即可。如果仍报错，换成64位的python再试。)

pyopengl中的绝大多数函数和pyglet的是一样的, 一般情况下可以互相替换使用。

导入及初始化pyopengl的glut模块:

from OpenGL.GLUT import *
glutInit()

下面的代码用于绘制球体。其中的x, y, z是球心坐标, r是球半径。两个40是绘制球的精度, 精度越高球的表面越光滑。

glPushMatrix()
glTranslatef(x+r, y+r, z+r)
glutSolidSphere(r,40,40)
glPopMatrix()

完整程序:

import pyglet
from pyglet.gl import *
from pyglet.gl.glu import *
from pyglet.window import key
from OpenGL.GLUT import *

WIDTH=400;HEIGHT=400
cam_x=0;cam_y=0;cam_z=-5

window = pyglet.window.Window(height=HEIGHT, width=WIDTH)

@window.event
def on_draw():

    glMatrixMode(GL_PROJECTION)  # 设置当前矩阵为投影矩阵
    glLoadIdentity()
    # glEnable(GL_DEPTH_TEST)

    # 透视投影, 类似游戏中的FOV(视角大小)
    glFrustum(-5, 5, -5, 5, 2, 1000)

    glMatrixMode(GL_MODELVIEW)  # 模型视图矩阵
    glLoadIdentity()

    glViewport(0, 0, WIDTH,HEIGHT)

    window.clear() # 或 glClear(GL_COLOR_BUFFER_BIT)
    glClear(GL_DEPTH_BUFFER_BIT) # 清除深度(z排序)缓冲区
 
    # 改变相机位置和角度
    gluLookAt(cam_x,cam_y,cam_z,cam_x,cam_y,100000,0,1,0)

    # 绘制球体
    x=0;y=0;z=10;r=3
    glColor3f(0,0.2,0.5) # 设为蓝色
    glPushMatrix()
    glTranslatef(x+r, y+r, z+r)
    glutSolidSphere(r,40,40)
    glPopMatrix()

    glFlush()

@window.event
def on_key_press(k,m):
    global cam_x,cam_y,cam_z
    if k==key.DOWN: # 下
        cam_y-=1
    elif k==key.UP:# 上
        cam_y+=1
    elif k==key.LEFT: # 左
        cam_x-=1
    elif k==key.RIGHT: # 右
        cam_x+=1
    elif k==key.PAGEUP: # page up
        cam_z+=0.5
    elif k==key.PAGEDOWN: # page down
        cam_z-=0.5
    on_draw()

glutInit()
glClearColor(1, 1, 1, 1)
glEnable(GL_DEPTH_TEST) # 开启深度(z排序)
pyglet.app.run()

运行效果:

8.总结

前面介绍了pyglet的入门知识, 以及绘制3D场景的基础知识。重点函数如下:

  • glVertex3f(x, y, z): 指定点、线段和多边形的顶点。多次调用就可以绘制出几何图形。
  • glBegin(mode)和glEnd(): 绘制一段图形的开始和结束。glBegin的mode参数可设置填充等样式。
  • glColor3f(r, g, b): 设置图形颜色, r、g、b的范围是0-1。
  • glFlush(): 刷新绘图缓存, 将绘制的图形显示在屏幕上。
  • gluLookAt(): 改变相机位置和视角。

下篇：Python pyglet 自制3D引擎入门(二) – 绘制立体心形，动画和相机控制

作者的其他3D渲染程序示例, 见作者的gitcode：github.com/qfcy/python/tree/main/opengl。

Python Pyglet 3D模块（1）
qq_42716068的博客
12-27 1281
Python Pyglet教程第一课
Python-Blender的3D游戏引擎
08-10
Blender的3D游戏引擎
用Python Pygame做3D引擎
iamapro的博客
08-05 485
可以上下左右移动，但没有物理，也没有碰撞箱，会穿模。类似功能、问题请求指导！
pyglet 和 pygame 对比
最新发布
scoone的博客
03-26 411
选择pyglet还是pygame如果您需要更现代的图形处理能力，或者正在开发需要高性能图形渲染的应用，pyglet可能是更好的选择。如果您是游戏开发初学者，或者需要一个功能丰富且易于上手的库来快速开发2D游戏，pygame可能更适合您。无论选择哪个库，都应该根据项目的具体需求和您的个人偏好来决定。
Python 3.x 下的 3D 游戏引擎
weixin_44617651的博客
07-04 3019
在 Python 3.x 中，有几个比较流行的用于开发 3D 游戏的引擎和库。虽然 Python 自身不是一个主流的游戏开发语言，但是可以通过这些库和引擎结合其它语言或者底层渲染引擎来实现复杂的游戏开发。
Python 3D建模指南【numpy-stl | pymesh | pytorch3d | solidpython | pyvista】
热门推荐
新缸中之脑
11-10 1万+
不幸的是，Pymesh 库无法通过 PIP 包管理器安装，尽管文档中描述了这种方法，也无法通过 Anaconda 安装。有两种安装方法。按照说明，从源代码进行编译。使用docker容器。我选择这个选项是因为更有趣。容器使用参数启动。使用启动参数，将脚本文件夹装载到容器中。让我们为脚本提供必要的参数。脚本执行完成后，容器将被删除。如果Docker已经按照文章开头的说明安装，则无需再安装。如果 Docker 不适合你，请按照文档中的说明编译 Pymesh。这个选项也经过我的测试。
Python 用3D引擎写一个Pong游戏
leleprogrammer的博客
07-17 3533
我们创建一个桌子，它是一个长方体，所以model为cube，颜色是橙色，然后进行缩放操作，并设置位置，还有它的材质（普通材质）进行板子和球的碰撞检测，先用intersects获取触碰到的实体列表，然后对碰到实体为两个板子的时候进行反弹、加速或减速的操作。这样运行程序，我们只看到了桌子的侧面，调整视角，改变ursina自带的camera的属性即可，设置它的倾斜度和位置。ursina自带window参数，代表窗口，它还自带color参数，代表各种颜色，我们直接修改窗口的颜色。接下来，绘制桌子中间的分割线和球。.
pyEngine3D:香草python3中的3D图形引擎
05-09
PyEngine3D 简单风景的例子 山地景观的例子 我的medium.com帖子介绍了此处的代码 PyEngine3D是一个简单的模块，仅使用python标准库来显示3D设计并与之交互。 主模块可以在“图形”目录中找到，其他文件是不同功能的演示。 第一步是创建一个Engine对象，该对象需要一组点和一组将它们链接在一起的三角形。 test = Engine3D ([[ 1 , 1 , 1 ], [ 0 , 0 , 0 ], [ 2 , 2 , 2 ]], [[ 0 , 1 , 2 ]]) # this will create a single triangle between these points test = Engine3D ([[ 1 , 1 , 1 ], [ 0 , 0 , 0 ], [ 2 , 2 , 2 ]], [[ 0 , 1 , 2 , "green" ]]
Python与3D模型入门：glTF到glb格式全面解析（0基础必备）
随着3D技术在计算机图形学中的广泛应用，Python作为一种高效的编程语言，在处理3D模型尤其是glTF和glb格式文件方面扮演了重要角色。本文首先介绍了Python与3D模型的基础知识，深入解析了glTF格式的起源、发展、文件...
【Pyglet与OpenGL的桥梁】：3D图形编程入门到精通
在本章中，我们将探究3D图形编程的基本概念，并介绍Python社区中一个杰出的跨平台窗口ing工具库Pyglet。对于3D图形编程，我们将从基本的三维坐标系统和图形渲染流程开始，逐渐深入了解渲染管线、光照模型和纹理映射...
python3d粒子爱心代码
09-23
在Python中创建3D粒子爱心形状通常会涉及到图形库如PyOpenGL、Pygame或Pyglet等。以下是一个简单的示例，展示如何使用Pygame库创建一个基本的粒子系统，并模拟爱心形状： ```python import pygame from pygame....
Engendro3D：Python 3D游戏引擎
02-04
Engendro 3D:trade_mark: 适用于Python的OpenGL 3D游戏引擎。 版本0.7 MIT许可证。 工作正在进行中。 渲染示例 视频 要求： 2.7或3.4+ pip install pysdl2 pip install git+https://github.com/jr-garcia/Glaze.git pip install numpy pip install git+https://github.com/jr-garcia/cyCGkit_minimal.git pip install pillow pip install freetype-py pip install
3dpy:Python中的基本3D引擎，用于倾斜
03-14
3dpy Python中的基本3D引擎，用于倾斜 此存储库中包含的Suzanne模型属于 ，可在GPLv2 +许可下使用。
3D图的demo与详细解析（Python实现）
10-08
前些日子学习Python可视化分析的时候，参考的是网上的文档和代码，不少细节文档都没明说，对新手不是很友好，我学习之后对不少代码以个人理解做了详细的注解，希望对大家有所帮助！
3D_Graphics:处理三维操作和渲染的代码片段的集合
03-11
在IT领域，3D图形是计算机图形学的一个重要分支，它涉及到如何在屏幕上创建和操纵三维对象，使得...Python提供了丰富的库支持3D图形编程，如Pygame、PyOpenGL、Pyglet、Vispy等，使得非专业图形程序员也能轻松入门。
用Python绘制三维立体图形，从易到难（附完整代码）
biancheng_syz的博客
08-16 7142
假设已经安装了matplotlib工具包。互联网企业Python面试真题集。本文仅仅梳理最基本的绘图方法。超百节Python精品视频课程。Python全领域学习路线图。华为独家Python漫画教程。
Python pyglet 自制3D引擎入门
weixin_40738405的博客
07-07 156
Python,入门相关视频讲解：python的or运算赋值用法用python编程Excel有没有用处？011_编程到底好玩在哪？查看python文件_输出py文件_cat_运行python文件_shelPython pyglet 自制3D引擎入门 在现代计算机图形学中，3D引擎是至关重要的工具，它可以帮助我们创建各种...
Python pyglet 自制3D引擎入门(二) -- 绘制立体心形，动画和相机控制
qfcy的博客
08-02 5332
Python用于制作3D游戏可谓得心应手。本文讲解使用Python pyglet库，绘制立体心形、使用计时器实现动画、绑定窗口事件进行相机控制，自制简单3D引擎的方法技巧。
python实现3d建模工具_3D One 2.5引爆新思维，用趣味编程来实现3D建模！
weixin_39736606的博客
11-23 804
3D One2.5正式版终于和大家见面啦！新版本全新推出趣味编程，让3D模型也能通过编程逻辑来完成，丰富你的创新想象力。这给有计划开展编程和3D设计课的学校提供了支持，在2018年高中新课标提出的加强编程教育大环境下，能运用2.5版同时学习3D设计和编程内容以快速完成创新教育的教学任务。趣味编程还具备录制动态编程的GIF图以及切换多种编程方式等，帮助老师在课堂上更直观地向学生展示3D模型的编程过程...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

qfcy_

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值