Skip to main content

An easy-to-use 3D rendering engine for Python

Project description

Glass Engine -- 相当易用的 Python 3D 渲染引擎

glass engine logo

Glass Engine 是一个相当易用的 Python 实时 3D 渲染引擎,完全免费开源。使用 Glass Engine 你可以轻松地在你的 Python 界面程序中嵌入可交互的 3D 画面。

首先,使用以下命令即可完成对 Glass Engine 的安装:

pip install glass-engine

如果你是中国区用户,则可以使用以下命令以加速安装过程:

pip install glass-engine -i https://pypi.tuna.tsinghua.edu.cn/simple

接下来,让我们通过一个简单例子来直观感受一下 Glass Engine 的使用过程:

from glass_engine import *
from glass_engine.Geometries import * # 导入所有的基本几何体

scene, camera, light, floor = SceneRoam() # 创建基本场景

sphere = Sphere() # 创建一个球体模型
sphere.position.z = 1 # 设置球体位置
scene.add(sphere) # 将球体添加到场景中

camera.screen.show() # 相机显示屏显示渲染结果

上述代码首先使用 SceneRoam 创建出一个基本场景,包括了相机、光源、地板,然后往场景中添加了一个球体模型,最后将相机观察到的视口显示出来。

可以看出,使用 Glass Engine 创建 3D 场景无需自定义任何类和任何函数,仅通过对象创建、方法调用的顺序程序结构就可完成场景的构建和显示,由此体现出 Glass Engine 高度的易用性,这也是 Glass Engine 相比于其他同类 3D 引擎的优势所在。

运行上述程序,你将得到下图所示结果:

glass engine simple scene

你可以通过鼠标右键拖动以旋转视角,还可通过键盘按键 W A S D E C 来在场景中漫游:

  • A 向左移动,D 向右移动
  • W 向前移动,S 向后移动
  • E 向上移动,C 向下移动

并可通过鼠标滚轮来缩放场景。

怎么样,是不是很简单、直观、易用?如果你感兴趣的话,就让我们开始接下来的 3D 渲染之旅吧!

说明

  • 若发生 PyOpenGL-accelerate 安装失败的情况,请到 githubgitee 手动下载 PyOpenGL-accelerate for Python 3.12 的 wheel 包并使用 pip install 安装;
  • 若发生 moderngl 安装失败的情况,请到 githubgitee 手动下载 moderngl for Python 3.12 的 wheel 包并使用 pip install 安装。

Release note

  • version 0.1.28:

    • 修改 pcpp 冲突 bug
  • version 0.1.27:

    • 禁用滚轮
    • 修改 Python 3.7 f-string bug
  • version 0.1.26:

    • 添加 treeshake 功能,自动删除 glsl 无用函数
    • 添加功能自动剪裁功能,没有用到的功能不参与 glsl 编译
  • version 0.1.25:

    • 添加 minifyc 进一步减小 glsl 代码体积,避免 OSError: 0x000000010 bug
  • version 0.1.24:

    • 修复 OSError: 0x000000010 bug
    • 解决 dynamic_env_map 开启再关闭失效 bug
    • 解决 cast_shadows 开启再关闭失效 bug
  • version 0.1.23:

    • 修复后处理 bug
    • 修复半透明 bug
  • version 0.1.22:

    • 支持了 Python 3.12

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

glass_engine-0.1.28.tar.gz (590.8 kB view hashes)

Uploaded Source

Built Distribution

glass_engine-0.1.28-py3-none-any.whl (720.8 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page