跳转到内容
Jason's Study

Panda3D — Disney/CMU 出品的开源 3D 游戏引擎

是什么

Panda3D 是一个用 Python 或 C++ 就能写出 3D 游戏和交互场景的开源游戏引擎，由迪士尼研究院与卡内基梅隆大学（CMU）联合开发。日常类比：把它想成”3D 版的 pygame”——pygame 让你能在 Python 里画二维图形、响应键盘；Panda3D 则把这一切搬到三维世界，同时让你保留对底层渲染细节的完整控制权。

区别于 Unity/Unreal 这类”工具优先”引擎，Panda3D 的核心理念是不强制规定工作流。你不需要打开一个 GUI 编辑器，只需要写代码，引擎给你什么你就用什么。最小 Hello-World 只需要 5 行 Python：

from direct.showbase.ShowBase import ShowBase


class MyApp(ShowBase):
    def __init__(self):
        ShowBase.__init__(self)
        self.environ = self.loader.loadModel("models/environment")
        self.environ.reparentTo(self.render)


app = MyApp()
app.run()

这 5 行就能打开一个可旋转的 3D 场景窗口——没有样板代码，没有复杂初始化。

为什么重要

不了解 Panda3D 或类似引擎，下面这些事情都没法解释：

  • 为什么”把一个模型显示出来”需要场景图（SceneGraph）而不是直接调 OpenGL，以及场景图如何让父子变换自动传播
  • 为什么同样用 Python 写游戏，Panda3D 能驱动商业级 MMORPG（迪士尼的 Toontown Online），而不仅是 demo
  • 为什么 3D 程序的性能瓶颈往往不在 GPU，而在 CPU 侧的 draw call 批量化（batching）
  • 为什么一个 3D 引擎需要内置网络层和分布式任务调度器

核心要点

Panda3D 的架构可以拆成三个核心概念：

  1. 场景图（Scene Graph）：所有 3D 对象都挂在一棵树上，父节点的变换（位置/旋转/缩放）自动传递给所有子节点。类比：把台灯夹在书桌上，搬桌子时台灯跟着移动——你只需要移动桌子这个”父节点”。Panda3D 里这棵树的根叫 render，所有想被渲染的东西都要 reparentTo(render)。

  2. 任务管理器（taskMgr）：游戏逻辑用任务（Task）驱动，而不是裸 while 循环。每帧引擎自动调用所有注册的任务函数，函数返回 Task.cont 表示继续，返回 Task.done 表示结束。类比：像 JavaScript 的 requestAnimationFrame，但你把所有逻辑都注册进去，引擎保证每帧按顺序调。

  3. 可编程着色器接口：Panda3D 暴露底层图形原语，你可以直接加载 GLSL 着色器替换默认光照模型。类比：Unity 给你一个”调参面板”；Panda3D 给你一个”焊锡台”——后者需要你知道自己在做什么，但没有任何隐藏限制。

实践案例

案例 1：Hello World — 加载模型并让相机围绕旋转

from direct.showbase.ShowBase import ShowBase
from panda3d.core import AmbientLight
from direct.task import Task
import math


class RotatingScene(ShowBase):
    def __init__(self):
        ShowBase.__init__(self)


        # 加载内置地形模型
        self.env = self.loader.loadModel("models/environment")
        self.env.reparentTo(self.render)
        self.env.setScale(0.25)
        self.env.setPos(-8, 42, 0)


        # 添加环境光（否则场景全黑）
        alight = AmbientLight("alight")
        alight.setColor((0.5, 0.5, 0.5, 1))
        alnp = self.render.attachNewNode(alight)
        self.render.setLight(alnp)


        # 注册每帧旋转任务
        self.taskMgr.add(self.spinCameraTask, "SpinCameraTask")


    def spinCameraTask(self, task):
        angle = task.time * 6.0  # 每秒旋转 6 度
        self.camera.setPos(
            20 * math.sin(math.radians(angle)),
            -20 * math.cos(math.radians(angle)),
            3
        )
        self.camera.lookAt(self.env)
        return Task.cont  # 继续下一帧


app = RotatingScene()
app.run()

逐部分解释：

  • loadModel 从 .egg 或 .bam 格式加载 3D 网格，返回一个场景图节点
  • reparentTo(self.render) 把节点挂进渲染树，不挂就不显示
  • taskMgr.add(...) 注册每帧回调，task.time 给出从启动到现在的秒数

案例 2：Bullet 物理——让箱子有重力

Panda3D 内置 Bullet 物理引擎绑定，无需额外安装。以下代码在 ShowBase 子类的 __init__ 中调用（self.render / self.taskMgr 来自 ShowBase）：

from direct.showbase.ShowBase import ShowBase
from direct.task import Task
from panda3d.bullet import BulletWorld, BulletBoxShape, BulletRigidBodyNode
from panda3d.core import Vec3


class PhysicsApp(ShowBase):
    def __init__(self):
        ShowBase.__init__(self)


        # 初始化物理世界
        self.world = BulletWorld()
        self.world.setGravity(Vec3(0, 0, -9.81))


        # 创建地面（静态刚体，质量=0 代表不受力）
        ground_shape = BulletBoxShape(Vec3(50, 50, 0.1))
        ground_node = BulletRigidBodyNode("Ground")
        ground_node.addShape(ground_shape)
        self.render.attachNewNode(ground_node)
        self.world.attachRigidBody(ground_node)


        # 创建会掉落的箱子（动态刚体，质量=1kg）
        box_shape = BulletBoxShape(Vec3(0.5, 0.5, 0.5))
        box_node = BulletRigidBodyNode("Box")
        box_node.setMass(1.0)
        box_node.addShape(box_shape)
        box_np = self.render.attachNewNode(box_node)
        box_np.setPos(0, 0, 10)  # 从高处落下
        self.world.attachRigidBody(box_node)


        self.taskMgr.add(self.update_physics, "UpdatePhysics")


    def update_physics(self, task):
        dt = globalClock.getDt()
        self.world.doPhysics(dt)
        return Task.cont

关键点：doPhysics(dt) 必须每帧调用，dt 是上一帧耗时（秒）。用固定步长（如 1/60）而非 dt 可以让物理行为更确定。

案例 3：自定义 GLSL 着色器实现卡通渲染

着色器是什么：着色器（Shader）是运行在 GPU 上的小程序。顶点着色器（vertex shader）决定每个点的屏幕坐标，片段着色器（fragment shader）决定每个像素最终显示什么颜色。Panda3D 允许在运行时替换任意节点的着色器，完全自定义光照效果。

from direct.showbase.ShowBase import ShowBase
from panda3d.core import Shader, Vec3


class ToonApp(ShowBase):
    def __init__(self):
        ShowBase.__init__(self)
        model = self.loader.loadModel("models/smiley")
        model.reparentTo(self.render)


        # 加载自定义顶点/片段着色器
        toon_shader = Shader.load(
            Shader.SL_GLSL,
            vertex="shaders/toon.vert",
            fragment="shaders/toon.frag"
        )


        # 应用到节点（及其所有子节点）
        light_dir = Vec3(1, -1, -1)
        light_dir.normalize()  # 原地归一化：Vec3 没有 normalized() 方法
        model.setShader(toon_shader)
        model.setShaderInput("light_dir", light_dir)

在 toon.frag 里：

uniform vec3 light_dir;
in vec3 v_normal;


void main() {
    float intensity = dot(normalize(v_normal), -light_dir);
    // 把连续光照离散为 3 档
    if (intensity > 0.95)      gl_FragColor = vec4(1.0, 1.0, 1.0, 1.0);
    else if (intensity > 0.5)  gl_FragColor = vec4(0.7, 0.7, 0.7, 1.0);
    else                       gl_FragColor = vec4(0.3, 0.3, 0.3, 1.0);
}

这是”卡通渲染（Toon/Cell Shading）“的最简实现：把光照值量化为几档，产生动画风格的平面感。

踩过的坑

  1. 节点不清理导致内存泄漏：调用 loadModel 后如果不再需要节点，必须手动调 node.removeNode()；Panda3D 不会替你回收未挂载的节点，长期不清理会导致内存持续增长。

  2. 物理更新忘记传 dt：world.doPhysics() 忘记传时间步长时默认步长为 0，物体会完全静止，很难排查。

  3. 资源路径使用绝对路径：跨平台发布时硬编码绝对路径会在其他机器报找不到文件。应改用 loader.loadModel("models/xxx") 相对路径配合 Panda3D 的虚拟文件系统（VFS），或用 Filename.fromOsSpecific() 转换。

  4. 忽视 pstats 分析器：渲染掉帧时新手往往怀疑 GPU，但 Panda3D 大多数情况下瓶颈是 CPU 侧的 draw call 数量——draw call 是 CPU 通知 GPU “画这个物体” 的一次指令，每帧 draw call 越多 CPU 越忙。连接内置 pstats 工具（运行时按 ~ 键）后立刻可以看到哪个节点贡献了多少 draw call；flattenStrong() 合并静态子树可以将 draw call 数量减少 10 倍以上。

适用 vs 不适用场景

适用：

  • Python 原型快速验证：需要在 Python 中渲染 3D 场景、做交互演示、科学可视化
  • 教学用途：想学 3D 渲染管线基础（场景图、变换矩阵、着色器）而不被 Unity 的 GUI 挡住
  • 研究项目：需要深度定制渲染管线，不想被引擎”黑盒”约束
  • 中小规模 3D 应用：休闲游戏、模拟训练、数字孪生 demo

不适用：

  • AAA 级商业游戏：缺少 Unity/Unreal 的资产商店、视觉效果插件生态和美术工具链
  • 移动端优先开发：iOS/Android 支持不成熟，Godot/Unity 是更好选择
  • 团队中没有人懂 Python/C++ 的项目：Panda3D 的核心优势是代码驱动，蓝图/可视化脚本支持很少
  • 需要大规模开放世界地形系统：内置地形工具有限，需要大量自定义

历史小故事（可跳过）

  • 1990 年代末：迪士尼研究院内部开始开发一套 3D 引擎用于主题公园虚拟现实项目。
  • 2002 年：迪士尼与 CMU 娱乐技术中心合作，将引擎重构并以 BSD 协议开源，正式命名为 Panda3D。开源的动机之一是希望 CMU 学生用它做游戏开发教学。
  • 2003 年：迪士尼用 Panda3D 驱动了 Toontown Online，这是互联网历史上最早的面向儿童的大型多人在线游戏之一，高峰期有数十万同时在线用户。
  • 2007 年：Pirates of the Caribbean Online（加勒比海盗在线）上线，同样基于 Panda3D，证明引擎可以支撑大规模商业产品。
  • 2010 年至今：迪士尼停止维护，项目由社区驱动延续至今，支持 Vulkan 渲染器、现代 Python 3、WebGL 输出等新特性。

学到什么

  1. 场景图是 3D 引擎的灵魂：把变换管理委托给树结构，比手动管理每个对象的全局矩阵省去大量错误——这个设计模式（Composite + 变换继承）值得迁移到其他领域
  2. 任务驱动 vs 裸循环：显式把逻辑切成注册的任务，让引擎掌握调度权，是”控制反转”在游戏循环里的体现
  3. “给你焊锡台”的设计哲学：暴露底层原语而非封装黑盒，牺牲了易用性，换来了无限的可定制空间——这种取舍在引擎、框架、OS 等工具领域反复出现
  4. 性能瓶颈常不在你以为的地方：3D 渲染新人总怀疑 GPU，但 draw call 数量（CPU 端）才是最常见的性能杀手

延伸阅读

关联

反向链接

  • 3d-gaussian-splatting —— 3D Gaussian Splatting — 用一堆 3D 模糊光斑重建场景
  • debevec-1998-rendering-with-natural-light —— Debevec 1998 — 用真实世界的光照亮 CG 物体
  • filament —— Filament — Google 跨平台 PBR 渲染引擎
  • kajiya-1986-rendering-equation —— Kajiya 渲染方程 — 把所有渲染算法统一成一个积分方程
  • magic3d-2023 —— Magic3D — 把 DreamFusion 的 NeRF 拆成”先粗后精”两阶段
  • minetest —— Luanti / Minetest — 给自己造一个开源体素游戏引擎
  • ogre —— OGRE — 老牌 C++ 3D 渲染引擎，把 GPU API 差异藏进场景图
  • openrct2 —— OpenRCT2 — 把一款 x86 汇编游戏彻底用 C++ 重写
  • threejs —— three.js — Web 3D 事实标准