当前位置：首页 > news >正文

cesium源码学习-02packages/engine/Source 目录与文件说明

news 2026/5/11 22:52:17

packages/engine/Source 目录与文件说明

本文档用于介绍 packages/engine/Source 下每个文件夹、子文件夹与文件的大致作用。

packages/engine/Source 可以按“基础能力 -> 渲染抽象 -> 场景系统 -> 数据驱动 -> 着色器 -> 异步任务”的顺序理解：

Core 是整个引擎的基础层，其他大多数模块都直接或间接依赖它。

路径	作用
Source/Core	基础能力集合，包含数学运算、几何对象、坐标系、时间系统、错误处理、资源访问与通用工具。
代表文件	Cartesian2.js、Cartesian3.js、Matrix4.js、Quaternion.js、JulianDate.js、Rectangle.js、Resource.js、Ellipsoid.js、Geometry.js。
适合关注的问题	坐标如何表示、矩阵如何变换、时间如何管理、底层资源如何请求、几何数据如何封装。

Renderer 是对底层 GPU 能力的抽象层，负责把上层场景需求转成可执行的绘制命令。

路径	作用
Source/Renderer	封装 Buffer、Texture、Framebuffer、RenderState、ShaderProgram、DrawCommand 等底层渲染对象。
代表文件	Buffer.js、Context.js、DrawCommand.js、Framebuffer.js、Pass.js、RenderState.js、ShaderProgram.js、Texture.js、VertexArray.js。
适合关注的问题	GPU 资源如何创建、渲染状态如何配置、一次 draw call 如何组织、着色器如何绑定。

Scene 是引擎最核心的一层，负责把地球、影像、模型、3D Tiles、相机和各种特效组织成完整场景。

路径	作用
Source/Scene	场景主模块，涵盖 Camera、Globe、ImageryLayer、Primitive、Cesium3DTileset、PostProcessStage 等。
Source/Scene/GltfPipeline	glTF 数据预处理流水线，处理模型 JSON、buffer、纹理、压缩扩展与兼容转换。
Source/Scene/Model	模型系统实现，负责 glTF/Model 的加载、节点、动画、材质和渲染资源拼装。
Source/Scene/Model/Extensions	模型扩展处理目录，封装不同 glTF 扩展的解析与运行时接入。
Source/Scene/Model/Extensions/Gpm	模型中 GPM 相关扩展的实现目录。
代表文件	Scene.js、Camera.js、Globe.js、ImageryLayer.js、Primitive.js、Cesium3DTileset.js、ModelComponents.js、PostProcessStage.js。
适合关注的问题	一帧场景如何更新、瓦片如何调度、模型如何加载、Primitive 如何进入渲染队列。

DataSources 是面向 Entity 的数据驱动层，主要服务于更高层的声明式可视化 API。

路径	作用
Source/DataSources	把 CZML、GeoJSON、KML 或运行时 Entity 数据转换成场景中的可渲染对象。
代表文件	Entity.js、EntityCollection.js、DataSource.js、DataSourceCollection.js、CzmlDataSource.js、GeoJsonDataSource.js、KmlDataSource.js。
适合关注的问题	Entity 如何建模、属性如何随时间变化、DataSource 如何驱动 Primitive/Visualizer。

Shaders 保存 GPU 侧着色器源码，和 Scene、Renderer 配合完成实际绘制。

路径	作用
Source/Shaders	着色器根目录，按渲染用途拆分。
Source/Shaders/Appearances	各类 Appearance 对应着色器。
Source/Shaders/Builtin	内置 GLSL 片段库，包含常量、函数和结构体。
Source/Shaders/Materials	材质系统着色器。
Source/Shaders/Model	模型渲染专用着色器。
Source/Shaders/PostProcessStages	后处理阶段着色器。
Source/Shaders/Voxels	体素渲染着色器。
代表文件	GlobeFS.glsl、GlobeVS.glsl、SkyBoxFS.glsl、PolylineFS.glsl、Materials/Color.glsl、PostProcessStages/FXAA.glsl。
适合关注的问题	顶点/片元着色器如何配合、材质参数如何进 shader、后处理链路如何实现。

Workers 负责把耗时计算放到后台线程，避免阻塞主线程渲染。

路径	作用
Source/Workers	Worker 入口与任务模块，如几何生成、地形/矢量数据处理、模型或瓦片相关异步计算。
代表文件	createVerticesFromHeightmap.js、createGeometry.js、decodeDraco.js、transcodeKTX2.js、upsampleQuantizedTerrainMesh.js。
适合关注的问题	主线程如何派发任务、Worker 如何序列化数据、几何和纹理如何在后台预处理。

这几个目录不是主业务逻辑入口，但在运行时与兼容层上很重要。

路径	作用
Source/Assets	静态资源目录，包括天文参数、默认纹理、图标、天空盒和地球纹理。
Source/ThirdParty	引擎直接使用的第三方实现或适配代码。
Source/ThirdParty/Workers	第三方 Worker 相关实现。
Source/Widget	历史兼容层代码，用于兼容旧的命名方式或导出方式。