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 的安装教程 进行解决。

接下来,让我们通过一个简单例子来直观感受一下 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 渲染之旅吧!

Release notes

version 0.1.57

  • 兼容 Python 3.13

version 0.1.54

  • 修复 bug #4: "view_pos.y" is used before being initialized
  • 修复 bug #5: ShaderToy 动态纹理文件不存在
  • 修复 bug #6: ImportError: cannot import name 'Self' from 'typing'
  • 修复 bug #7: #version directive error

temp version 0.1.52

  • 添加深度树摇尝试修复 bug #3
  • 临时版本,代码结构有待优化

version 0.1.51

  • 修复相机挂载到有缩放的节点位置不对的 bug
  • 将所有屏幕四边形绘制取消依赖顶点和索引
  • 去除不必要的 FBO

version 0.1.39

  • 兼容 Linux
  • 支持 PyInstaller 无配置打包

version 0.1.36

  • 修复纹理数超过硬件限制问题

version 0.1.35

  • 修改 PyPI 主页文档

version 0.1.34

  • 删除对 OpenEXR 的依赖,使用 opencv 读取 exr

version 0.1.33

  • 修复打包错误

version 0.1.31

  • 将 OpenGL 封装模块分离出来并单独打包为 python-glass
  • 将模型加载模块分离出来并单独打包为 assimpy
  • 模型加载支持内置纹理
  • 添加对 metallic-roughness map 的支持

version 0.1.30

  • 兼容了 AMD 显卡
  • 修复仅有天空盒不显示 bug
  • 优化 shader 逻辑
  • 改进 Qt API 选择逻辑

version 0.1.29

  • 修改动态加载新功能代码 bug

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
  • 修复 16bits 灰度图像加载错误 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.57.tar.gz (289.7 kB view details)

Uploaded Source

Built Distribution

glass_engine-0.1.57-py3-none-any.whl (249.8 kB view details)

Uploaded Python 3

File details

Details for the file glass_engine-0.1.57.tar.gz.

File metadata

  • Download URL: glass_engine-0.1.57.tar.gz
  • Upload date:
  • Size: 289.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.13.0

File hashes

Hashes for glass_engine-0.1.57.tar.gz
Algorithm Hash digest
SHA256 86f800caded08a525a0e56edb1373890ed7f4a8c1e7b765ad27d82e0e9f828a3
MD5 ab9cd019fb424cf0c89a2b2b38ed5a49
BLAKE2b-256 5394a98a2bd883ec6b7402721b9f91604a0b93b3d7203829bc88c006301f5201

See more details on using hashes here.

File details

Details for the file glass_engine-0.1.57-py3-none-any.whl.

File metadata

File hashes

Hashes for glass_engine-0.1.57-py3-none-any.whl
Algorithm Hash digest
SHA256 0b36d82fe02399468948f275f72a4b59ce5b90e2f166b5edc276e2146e172455
MD5 8f1e211a0a592115c3a9190596ea4c9a
BLAKE2b-256 84cac226013ba28aa92c7a29a4efe82ef6393e2fd869654bcf958ae6ea86d383

See more details on using hashes here.

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