游戏开发图形学【免费下载链接】turbulenz_engineTurbulenz is a modular 3D and 2D game framework for making HTML5 powered games for browsers, desktops and mobile devices.项目地址https://gitcode.com/gh_mirrors/tu/turbulenz_engine点击查看免费下载本指南基于 Turbulenz 开源仓库中的官方发布说明docs/source/release_notes/release_notes_0.17.0.rst展开系统梳理 0.17.0 版本在 2D 渲染、输入系统、系统信息 API 三个方向上的重大演进并结合仓库源码tslib与samples目录给出实现级佐证。读完本文你将掌握该版本新增的Canvas、FontManager、InputManager等 API 的用途与调用方式理解 InputDevice 中KeyCodes/MouseCodes/PadCodes物理键映射机制与convertToUnicode本地化方案并了解 0.17.0 的开发环境要求与已知兼容性问题。一、版本概览SDK 0.17.0 的定位与组成Turbulenz SDK 0.17.0 是面向Turbulenz Engine Installer 与 SDK 组件的一次同步更新。从本版本起Turbulenz Engine Installer 已随 SDK 一同发布开发者需要到安装目录下的**SDKINSTALLDIR**/engines/0.17.0/安装对应引擎才能开展开发工作。需要特别注意的是0.17.0 随包附带的 Turbulenz Engine 属于面向开发者的预发布版本pre-release仅用于配合 SDK 进行开发如果要访问 http://www.turbulenz.com 上的正式游戏官方要求前往其下载页面确认安装的是最新兼容版本。官方同时预告未来的引擎版本管理将改为自动处理。从仓库源码结构看本版本对应的 JavaScript 库jslib源码集中在tslib目录其中 tslib/webgl/turbulenzengine.ts 是 WebGL 平台下引擎入口对象WebGLTurbulenzEngine的实现0.17.0 发布说明中提到的新 API 大多可以在这里找到对应的存根或完整实现。二、安装要求与环境配置RequirementsWindows XP/Vista/7Windows 版 Turbulenz SDK 以可下载安装包的形式发布内含开发所需的工具、样例samples与引擎组件。安装 SDK 之前需要先安装以下软件必备EssentialPython 2.6.5用于驱动 SDK 附带的构建与部署工具链推荐RecommendedMicrosoft Visual Studio 2008——用于在平台上可用时为 Python 环境编译速度优化模块speed-upsPDF 阅读器——用于阅读 PDF 格式文档。官方提示若无法编译 speed-upsPython 模块的运行性能可能下降因此建议先安装 Visual Studio再安装 Turbulenz SDK以便构建环境时正确配置 speed-ups。若使用64 位 Python则必须安装 64 位版本的 Visual Studio 编译器。Mac OS X 10.5/10.6/10.7BETAMac 版 SDK 以自解压 shell 脚本的形式向开发者提供 Beta 版本。安装完必备软件后在 SDK 安装包所在目录打开终端依次执行chmod ax TurbulenzSDK-X.X.X.run./TurbulenzSDK-X.X.X.run按提示完成安装Mac 平台的必备软件包括必备EssentialPython 2.6.5Xcode 3.2.6 或更高版本必须在运行脚本前安装以便 Python 编译部分模块推荐RecommendedCg Toolkit——使用cgfx2json工具编译着色器shader时所必需对应工具源码位于 tools/cgfx2json。三、官方推荐的开发环境Recommendations0.17.0 官方对第三方工具与服务的版本推荐遵循最稳定、最可靠、最能代表最终产品形态的原则并随技术与工具迭代持续更新。Turbulenz 游戏的开发、调试与性能分析均在Web 浏览器中完成因此浏览器与配套调试工具是开发环境的核心。浏览器与调试器各浏览器在 release 模式下的性能相对一致而development开发模式的体验取决于浏览器本身及其可用调试工具。绝大多数 JavaScript 调试器内置于浏览器或以其插件形式存在支持暂停执行、单步调试、变量检查以及通过控制台执行函数。官方对开发模式调试的推荐组合Firefox 3.6.X Firebug 1.7.3支持 Windows XP/Vista/7 与 Mac 10.5/10.6/10.7备选方案WindowsFirefox 6.0 Firebug 1.8.1使用 in-process 模式详见 docs/source/known_issues/running_in_process.rstMacSafari 5.0/5.1 内置 Web Inspector。代码验证JSLint在运行前确保 JavaScript 代码准确无误是 JS 开发中的关键一步。官方推荐使用JSLint版本 2010-01-04检查 JavaScript 语法与用法。JSLint 可通过网站直接运行、借助 Node.js 在命令行运行也已集成到多款 IDE 与编辑器中如 Komodo Edit 的 KJSLint 扩展。压缩与优化UglifyJS对于发布阶段的 JavaScript 代码优化官方推荐UglifyJS取最新版本它兼顾压缩速度与优化准确性能确保代码在 Turbulenz JavaScript 引擎上按预期运行。UglifyJS 需要 Node.js 环境从命令行运行。仓库external/uglifyjs目录中保留了与之对应的压缩工具组件tools/scripts/strip-debug与tools/scripts/aesdecrypt等脚本也体现了 SDK 发布流程中对脚本处理的工程化实践。编辑器/IDEKomodo EditTurbulenz 对编辑器选择几乎没有限制但官方建议至少具备JavaScript 语法高亮、代码验证选项与外部命令执行能力三项特性。入门可选用Komodo Edit 6.1。四、新特性详解New Features1. Canvas 类HTML5 Canvas 规范的引擎级实现0.17.0 在 jslib 中新增了Canvas类实现了 HTML5 canvas 规范WHATWG中的 2D 上下文 API。这在仓库源码中有完整对应tslib/canvas.ts 定义了Canvas、CanvasContext、CanvasLinearGradient与CanvasRadialGradient四个公开类。从源码看CanvasLinearGradient线性渐变与CanvasRadialGradient径向渐变均实现了标准的addColorStop(offset, color)接口而颜色解析逻辑覆盖了命名颜色如aliceblue、#RGB/#RRGGBB十六进制、rgb()/rgba()、hsl()/hsla()等多种 CSS 颜色书写形式tslib/canvas.ts 第 24–322 行。这意味着游戏可以直接复用浏览器中熟悉的 Canvas 2D 绘图习惯在 Turbulenz 引擎内部完成相同的 2D 绘制。为演示该 API0.17.0 新增了两个样例2dcanvas演示 2D Canvas API 的大部分能力。对应源码 samples/tsscripts/templates/2dcanvas.ts 及页面模板 samples/templates/2dcanvas.html。从其源码注释可见它使用 Canvas 2D API 渲染线条、矩形、圆形、圆弧、多边形、纹理贴图以及线性/径向渐变并在侧栏通过#fpscounter输出帧率用于评估 API 性能svg演示如何加载、解析并渲染 SVG 文件不支持动画。对应源码 samples/tsscripts/templates/svg.ts它基于canvas与svg两个 jslib 模块实现——tslib/svg.ts 中提供了SVGPathNode、SVGPolygonNode、SVGRectNode、SVGCircleNode、SVGTextNode等一整套 SVG 节点解析与变换类SVGNodeTransform。2. FontManager位图字体渲染jslib 新增FontManager类用于渲染位图字体bitmap fonts。仓库实现位于 tslib/fontmanager.ts其中定义了Font与FontManager两个公开类以及FontDimensions字体宽高、字形数与行宽、FontGlyph字形宽度、偏移、所在页与FontKerning字距映射等数据结构。配套的字体资源位于 assets/fonts包括 OpenSans 系列8/16/32/64/128 像素多尺寸、AozoraMincho 与 Hero 字体的.fnt位图字体描述文件及其.png纹理页。位图字体方案将字形预渲染到纹理页中渲染时按FontGlyph信息从对应page采样避免了运行时矢量轮廓的解析开销适合 UI 与 HUD 文本的高效绘制。svg 样例中即通过FontManager.create(graphicsDevice, requestHandler, null, errorCallback)创建字体管理器samples/tsscripts/templates/svg.ts 第 37 行。3. getObjectStatsJavaScript 引擎对象统计Turbulenz Engine 新增getObjectStats函数让开发者获取JavaScript 引擎中当前活跃对象的统计信息用于诊断对象泄漏与内存使用异常。详细的返回值格式与用法记录在 docs/source/jslibrary_api/engine_api.rstgetObjectStats一节函数返回一个以对象类型名为键的字典每项包含统计字段totalCount该类型在单个引擎实例中记录的对象总数额外提供名为Total的汇总条目包含所有已记录值——既包括已识别对象也包括未识别名称不可用对象如字符串、数字、标识符与临时对象等数学关系ObjectTypeName1 ObjectTypeName2 Unidentified Total。典型调试用法官方文档示例// Expected v3s created var v3CreatedCount 10; // Only for DEBUGGING TurbulenzEngine.flush(); if (TurbulenzEngine.getObjectStats) { // getObjectStats is available for this engine var objectStats TurbulenzEngine.getObjectStats(); var v3ObjectCount objectStats[Vector3]; if (v3ObjectCount) { if (v3ObjectCount v3CreatedCount) { if (console) { console.warn(Vector3 count is higher than expected: v3CreatedCount , actual: v3ObjectCount); } } } }从源码结构看tslib/webgl/turbulenzengine.ts 第 260–263 行中 WebGL 平台的getObjectStats()目前返回null——这是正常的官方文档明确指出该函数行为因浏览器而异在development 模式下统计的是浏览器 JavaScript 引擎的对象只有在plugin 模式下统计的才是Turbulenz JavaScript Engine本身。同时官方给出了两条重要警告统计值受 JS 引擎 GC 策略影响调用时不一定 100% 精确仅应作为参考当对象数量很大时该函数可能耗时较长只应用于调试部分浏览器中先调用TurbulenzEngine.flush()可能有助于获得较新的数据此行为无法保证。4. getSystemInfo系统信息与玩家 localegetSystemInfo方法在本版本中新增了玩家 locale区域/语言设置的获取能力对游戏内容本地化非常有用。完整字段说明见 docs/source/jslibrary_api/engine_api.rst 的getSystemInfo一节返回对象包含字段含义cpuDescriptionCPU 的字符串描述cpuVendorCPU 厂商名称numPhysicalCores物理核心数部分平台无法准确获取时返回逻辑核心数numLogicalCores逻辑核心数ramInMegabytes物理内存大小MBfrequencyInMegaHZCPU 频率MHzarchitecture运行架构字符串通常为x86或x86_64不一定与浏览器/操作系统架构相同osName操作系统名称Mac OS X 返回字符串DarwinosVersionMajor/osVersionMinor/osVersionBuild操作系统主/次/构建版本号platformProfile平台能力概览desktop、tablet、smartphone之一仅作粗略参考userLocale用户当前 locale 设置native若存在且为 true表示运行在 Turbulenz 引擎的原生实现上plugin若存在且为 true表示运行在插件中若为 false 且native为 true则运行于应用内开发者客户端或打包应用官方语法示例var systemInfo TurbulenzEngine.getSystemInfo(); var numThreads systemInfo.numLogicalCores; var useLowResAssets (systemInfo.ramInMegabytes 1024);仓库源码 tslib/webgl/turbulenzengine.ts 第 842–857 行展示了 WebGL 平台systemInfo对象的构建过程numPhysicalCores/numLogicalCores取navigator.hardwareConcurrency || 1userLocale取(navigator.language || navigator.userLanguage).replace(-, _)将en-US风格转为en_US风格随后通过解析navigator.userAgent识别 Windows含Win64→x86_64、Win32→x86及 NT 版本号、Mac OS X返回Darwin并解析 10.x 版本、Tizen、Fire OS、Linux、Android 等平台并依据屏幕尺寸looksLikeNetbook判断最小边 900或 UA 中的Mobile标记设定platformProfile为tablet/smartphone。在服务层tslib/services/mappingtable.ts 第 134 行还会读取TurbulenzEngine.getSystemInfo().platformProfile说明该字段已被 jslib 内部服务用于平台相关的资源映射决策。五、重要变更Changes1. InputDevice 重构KeyCodes / MouseCodes / PadCodes 物理映射0.17.0 对InputDevice做了显著重构核心变化集中在事件发送给游戏之前的键位与按键映射方式。完整的控制码设计说明见 docs/source/jslibrary_api/inputdevice_api.rstControl Codes 一节要点如下键盘被视为游戏控制器而非文本输入设备每个KeyCode对应键盘上的一个物理按键control而不是该键产生的文本字符。例如美式键盘按 Q 与法式键盘按 A两者位于同一物理位置产生相同的KeyCode其名称以美式键盘键名命名此处生成的是Q。KeyCodes命名与美式键盘一一对应因此一套游戏代码即可适配多种键盘与键盘布局无需为每种布局编写输入代码减少本地化工作量MouseCodes鼠标按键映射同样跨平台标准化PadCodes手柄按键映射命名源自 Xbox 360 手柄按键鼠标滚轮事件现在具有最小滚动量 ±1并在所有平台行为一致Escape 键被保留用于从游戏中释放鼠标指针按下/释放均不向游戏发送事件总体而言未纳入映射方案的按键不产生事件游戏无法使用各平台输入行为一致性全面提升。输入设备文档还强调KeyCodes/MouseCodes/PadCodes的具体数值不应在游戏代码中直接使用应始终通过inputDevice.keyCodes、inputDevice.mouseCodes、inputDevice.padCodes属性需缓存以获最佳性能引用枚举。仓库源码 tslib/webgl/inputdevice.ts 第 1960 行起定义了完整的keyCodes映射表如A: 0、B: 1、NUMBER_0: 100等。由于键盘存在大量差异键官方建议默认操作方案只使用最通用的按键标准键列表见 API 文档的 KeyCode 表。2. convertToUnicode物理键到 Unicode 字符的转换为解决内部统一用 KeyCode、界面显示本地化字符的需求InputDevice 新增convertToUnicode方法将 KeyCode 数组转换为按下该物理键在当前用户键盘布局下所得到的 Unicode 字符对象形式为{ keycode : unicode, ... }。若参数不是数组则返回null对于没有对应 Unicode 字符的 KeyCode如 Alt 键返回对象中该键值为空字符串。var keyCodes inputDevice.keyCodes; var keyCodeArray [keyCodes.Q, keyCodes.B]; var unicodeCharacterObject convertToUnicode(keyCodeArray); // On a US keyboard unicodeCharacterObject[keyCodes.Q] will be equal to q, // while on a French keyboard, unicodeCharacterObject[keyCodes.Q] will be equal to a;该方案让游戏内部只处理 KeyCodes对外则向玩家展示本地化操作提示。仓库实现见 tslib/webgl/inputdevice.ts 第 273–288 行其注释说明纯 JavaScript 环境无法自行完成键盘码到 Unicode 的转换因此 WebGL 版本基于内部keyCodeToUnicode映射表返回结果无法映射的 KeyCode 返回空字符串完整、准确的转换能力由原生/插件版引擎提供。3. oninputcapture / oninputrelease输入焦点回调InputDevice 新增oninputcapture与oninputrelease回调用于在玩家聚焦focus或离开unfocus游戏时及时通知游戏。这使游戏可以在玩家切换窗口/标签页时暂停逻辑、保存状态或暂停音频避免后台继续消耗资源。配合文档中提到的inputDevice.isFocused()docs/source/jslibrary_api/inputdevice_api.rst 的isFocused一节可以主动查询焦点状态。4. InputManager输入事件自动化管理jslib 新增InputManager类用于自动化接收事件并管理设备状态。它封装了从多个输入设备收集事件、维护按键/指针状态、按帧分发输入结果的过程显著减少样板代码——开发者无需在每个帧循环中手动遍历设备事件而是由 InputManager 汇总并呈现一致的状态视图是 0.17.0 输入系统重构的配套组件。5. Transient VertexBuffers瞬时顶点缓冲0.17.0 开始支持Transient VertexBuffer——一种为动态、单次使用single use几何体优化的顶点缓冲。使用方式极其简单创建 VertexBuffer 时把参数transient设为true即可。仓库实现 tslib/webgl/graphicsdevice.ts 揭示了其底层原理第 2758–2762 行IndexBuffer与第 3629–3634 行VertexBuffer中ib[transient] (params[transient] || false); ib.dynamic (params.dynamic || ib[transient]); ib._usage (ib[transient] ? gl.STREAM_DRAW : (ib.dynamic ? gl.DYNAMIC_DRAW : gl.STATIC_DRAW));即transient为 true 时缓冲的 OpenGL 使用方式usage hint被设置为gl.STREAM_DRAW——这正是 WebGL 面向数据仅使用一次或至多几次场景的优化提示驱动会据此选择更合适的内存放置与更新策略。对于需要每帧重建的动态几何如粒子、调试线框transient: true是比默认STATIC_DRAW更贴合数据生命周期的选择。6. 渲染与着色器相关变更ATI 显卡着色器编译速度改进0.17.0 优化了 ATI 显卡上的 shader 编译性能间接改善 ATI 平台游戏的启动与换装耗时fullscreen 样例更名为 postfx原 fullscreen 样例改名为postfx对应源码 samples/tsscripts/templates/postfx.ts。该样例演示了如何使用渲染目标render targets对动态渲染图像施加后处理效果可在 simple copy、颜色反转inverted colors与光晕light bloom三种后处理间切换对应 assets/shaders/posteffects.cgfx 等后处理着色器实验性 WebGL 样例更名为 canvas原 WebGL 实验样例统一改名canvas同时涵盖2D canvas 渲染与 3D canvas 渲染两类场景渲染 3D canvas 上下文仍要求 WebGL 兼容浏览器。六、Bug 修复Fixed0.17.0 修复了两个明确列出的问题SoundDevice 音源耗尽时的异常行为此前当设备运行到音源sound sources耗尽时会表现异常本版本修复。相关实现位于 tslib/webgl/sounddevice.tsWebGLSoundDevice音源管理涉及WebGLSoundSource、WebGLSoundGlobalSource等类Sound.length缺失补上了Sound对象缺失的length属性使开发者能够查询音频资源的时长。七、已知问题与兼容性注意事项Known Issues0.17.0 发布说明列出了数量可观的已知问题按主题归纳如下完整清单以原文档为准WebGL 实验状态与浏览器兼容性WebGL 样例仍属实验性质并非全部受支持Sample App与Worm App已完全兼容 WebGL除deferred_rendering、loading、physics、physics_collisionmesh、physics_constraints、sound之外的样例均已完全兼容 WebGLFirefox 4/5/6/7 的 WebGL 性能受浏览器实现限制建议改用 Chrome 以获得更接近真实水平的 WebGL 性能表现SVG 样例在 Internet Explorer 8 的所有模式下均无法工作原因是 IE8 无法正确解析 SVG 文件开发模式下IE 6/7/8/9 与 Opera 10/11 引擎不兼容发布模式下IE 6 样式不兼容、Opera 10/11 不受支持Chrome 与开启 out-of-process 插件的 Firefox 4/5/6/7 在开发模式下存在性能受限Firefox 的该问题已被 Mozilla 修复并将在未来版本推送相关文档见 docs/source/known_issues/running_in_process.rst用 Chrome 调试时可能反复提示插件无响应。nVidia 多渲染目标驱动 BugnVidia 驱动版本 8.17.12.7061 – 8.17.12.7533存在缺陷会导致多个渲染目标MRT将第一个目标的输出渲染到所有目标纹理上。对cgfx2json生成的着色器当前规避方案是将对gl_FragData的写入按顺序重新排列。nVidia 已通过 Windows Update 或官网最新驱动修复此问题无法更新的环境请按 docs/source/known_issues/nVidia_driver_MRT_bug.rst 中的步骤处理。输入与指针锁定的已知问题Safari 5.0Mac OS X在输入与开发模式应用上存在异常建议使用 Safari 5.1使用 InputDevice 时某些浏览器在按 ESC 释放鼠标指针时耗时较长可尝试长按 ESC或Windows 上用 alt-tab 切换窗口浏览器无响应时则需结束进程引擎要求 CPU 支持SSE2着色器支持要求 GPU 支持GLSLOpenGL 着色语言。平台与工具相关问题Mac OS X Beta 版引擎在部分浏览器下运行特定游戏/样例时性能较低Mac 10.6 及以上Chrome、Firefox 4.0、Mac 10.5ChromeMac 上在 Firefox 3.6 运行时切换到全屏浏览可能导致渲染暂停运行密集型 JS 应用如 multiple animations 样例可能导致界面锁死建议使用可承受满负荷 JS 的浏览器并逐步加大负载官方推荐 Firefox 3.6Windows 7 下 UAC 开启时SDK 安装器可能无法自动为 Local Server 打开 Windows 防火墙需手动更新防火墙规则以便局域网访问SDK HTML 帮助的搜索功能在 Chrome 上不可用同时运行 Turbulenz 工具与 Local Server 偶尔会在simplejson_speedups.pyd中触发访问错误建议先关闭 Local Server 再运行工具刷新页面时若 Turbulenz 应用正在请求数据可能使浏览器进入不一致状态加载期间请避免刷新其他通用限制对原生引擎对象属性调用delete不受部分浏览器支持如delete techniqueParameters.diffuse无效应改用techniqueParameters.diffuse undefinedCPU 100% 负载时可能听到声音卡顿hasOwnProperty调用原生 JS 对象会抛错MathDevice忽略作为目标参数的 JavaScript 数组视为未指定目标Intel 部分芯片组如 G41上tex2DProj行为不符合预期需传入w1.0的 float4 而非 float3样例着色器使用tex2DProjFix规避。八、支持渠道Support遇到 Turbulenz Engine 与 SDK 相关问题时官方提供以下三级支持资源文档Documentation提交支持请求前先查看发布说明中的已知问题以及 docs/source/known_issues/known_issues.rst 知识库中的解决方案详情Issue TrackerGithub在 Turbulenz SDK 项目的 issue 跟踪器中提交问题与功能请求该站点信息仅对 Turbulenz 开发者开放支持请求Support Request若其他途径无法解决可发送邮件至 supportturbulenz.com 寻求官方团队协助。总结Turbulenz SDK 0.17.0 是一个承前启后的版本Canvas类将 HTML5 Canvas 2D API 纳入引擎体系FontManager补齐了位图字体渲染能力getSystemInfo/getObjectStats为系统信息与对象统计提供了统一入口而 InputDevice 的物理键映射重构KeyCodes/MouseCodes/PadCodesconvertToUnicode则奠定了跨键盘布局、跨平台的输入本地化基础transient顶点缓冲为动态几何提供了贴合 WebGL 使用提示的优化路径。开发者在升级到 0.17.0 时应结合本文梳理的安装要求、推荐工具链与已知问题清单重点验证输入映射、WebGL 样例兼容性与 nVidia MRT 规避方案确保既有项目平稳迁移。赞分享游戏开发图形学【免费下载链接】turbulenz_engineTurbulenz is a modular 3D and 2D game framework for making HTML5 powered games for browsers, desktops and mobile devices.项目地址https://gitcode.com/gh_mirrors/tu/turbulenz_engine点击查看免费下载相关推荐完整指南如何在Windows Vista/Server 2008上运行最新Python版本完整指南如何在Windows Vista/Server 2008上运行最新Python版本 PythonVista项目为Windows Vista SP2和W操作系统Area51跨平台字体渲染文本显示与本地化支持Area51跨平台字体渲染文本显示与本地化支持 字体渲染核心架构 Area51的字体渲染系统通过模块化设计实现跨平台文本显示核心逻辑封装在 Support/Turbulenz Engine Canvas 2D API 深度指南高性能 HTML5 游戏 Canvas 实现与浏览器差异全解析Turbulenz Engine Canvas 2D API 深度指南高性能 HTML5 游戏 Canvas 实现与浏览器差异全解析 导读 本文基于 Turb游戏开发图形学上一篇Describe your changes下一篇Jest 集成 DynamoDB 实战使用 jest-dynamodb 预设编写数据库测试创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考