图形学游戏开发3D渲染【免费下载链接】Babylon.jsBabylon.js is a powerful, beautiful, simple, and open game and rendering engine packed into a friendly JavaScript framework.项目地址https://gitcode.com/gh_mirrors/ba/Babylon.js点击查看免费下载本篇以 Babylon.js 仓库当前 .build/release-notes.md 中的发布说明为骨架逐条拆解其中的 AddonsAtmosphere、CoreStandardMaterial 深度预通道、Cube 纹理加载契约、RootMotionClip 根运动、Gaussian Splatting与 LoadersOBJFileLoader等八项真实变更并对照仓库源码验证其实现原理。读完你将理解每项变更解决了什么问题、在哪个文件落地、关键参数与调用链如何工作以及在自己的场景中如何应用。一、AddonsAtmosphere 材质插件只挂载到本场景的材质上发布说明首条修复的是大气系统Atmosphere与 PBR 材质插件之间的场景归属问题PR #18934Atmosphere: only attach the PBR material plugin to materials in the atmospheres scene问题背景Atmosphere 通过注册一个全局材质插件来让场景中的 PBR 材质采样天空环境贴图sky view LUT 用于镜面反射、diffuse sky irradiance LUT 用于辐照度并负责在未提供深度纹理时应用空中透视aerial perspective。但材质插件的注册工厂是全局的——所有在此之后创建的材质都会被送到工厂函数面前。修复前工厂可能把插件挂到其他场景的 PBR 材质上造成跨场景污染。源码证据在 atmosphere.ts 中构造器通过RegisterMaterialPlugin注册工厂修复后的工厂做了三重过滤RegisterMaterialPlugin(this._materialPluginName, (material) { if ( material.getClassName() PBRMaterial material.getScene() this.scene // 只挂载到本 Atmosphere 所在的场景 !material.pluginManager?.getPlugin(AtmospherePBRMaterialPlugin) ) { return new AtmospherePBRMaterialPlugin(material, this, this.depthTexture null); } return null; });关键点material.getScene() this.scene插件只服务于创建该 Atmosphere 实例的场景每个实例使用带唯一 ID 的插件名${MaterialPlugin}-${this.uniqueId}见 atmosphere.ts因此多个场景各自持有 Atmosphere 时彼此的工厂互不干扰dispose()时调用UnregisterMaterialPlugin只移除本实例的工厂见 atmosphere.ts。使用提示Atmosphere 目前只支持一个方向光作为太阳构造时lights.length ! 1会直接抛错并在 WebGL1 上不可用Atmosphere.IsSupported要求 WebGPU 或 WebGL2见 atmosphere.ts。涉及的主要可调参数包括exposure、multiScatteringIntensity、groundAlbedo、aerialPerspectiveIntensity、isSkyViewLutEnabled、isAerialPerspectiveLutEnabled等均可通过IAtmosphereOptions在构造时传入。二、CoreStandardMaterial 深度预通道与 alpha 源、alphaCutOff 修正StandardMaterial: depth pre-pass honours every alpha source, and alphaCutOff is bound for all alpha-tested materials两个修复点深度预通道depth pre-pass现在尊重所有 alpha 来源此前深度预通道对 alpha 的判断可能只覆盖某一种 alpha 输入如纹理 alpha修复后纹理、顶点色等所有 alpha 源都被纳入考虑从而让深度预写入与最终渲染的透明度测试行为一致。alphaCutOff 对所有执行 alpha 测试的材质统一绑定保证深度预通道阶段与主渲染阶段使用同一个裁剪阈值。源码证据在 standardMaterial.pure.ts 中alphaCutOff的默认值是0.4public alphaCutOff 0.4;Uniform 声明与逐帧更新分别位于 standardMaterial.pure.tsubo.addUniform(alphaCutOff, 1)与 standardMaterial.pure.ts// The alpha test compares against alphaCutOff whatever supplies the alpha: // a texture, vertex or ... ubo.updateFloat(alphaCutOff, this.alphaCutOff);从源码注释可以看到alpha 测试discard与alphaCutOff的比较无论 alpha 来自纹理、顶点色还是其他来源都成立——这正是honours every alpha source的实现落点。深度渲染链深度预通道由 depthRenderer.pure.ts 驱动其渲染流程会对 alpha 测试子网格单独设置混合模式Constants.ALPHA_COMBINE/ALPHA_DISABLE见该文件第 305-307、394-396 行并在渲染后恢复之前的 alpha 模式第 414-443 行的alphaTestSubMeshes循环。结合alphaCutOff的绑定修复深度预通道与主通道的裁剪结果不再出现偏差可有效避免半透明/镂空材质的深度排序错误。三、Core补全 Cube 纹理与预过滤纹理的加载契约Complete cube / prefiltered texture load contract - [Bug Fix]变更含义Babylon.js 的BaseTexture/InternalTexture通过一系列加载器loader完成不同容器格式DDS、KTX、EXR、HDR、ENV、Basis 等的 cube 数据读取加载器接口定义了loadCubeData等契约方法。此项修复补全了 cube 纹理与预过滤prefiltered纹理在加载契约上的空缺使支持 cube 的格式在加载器层面具备一致的行为。源码证据在 packages/dev/core/src/Materials/Textures/Loaders/ 目录下可以看到各格式加载器统一实现loadCubeData契约例如ddsTextureLoader.tsloadCubeData(imgs, texture, createPolynomials, onLoad)ktxTextureLoader.ts、basisTextureLoader.ts、exrTextureLoader.ts 等均实现同一签名接口定义位于 internalTextureLoader.ts。预过滤prefiltered状态由hdrFiltering.ts在滤波完成后置位texture._prefiltered true见 hdrFiltering.ts并提示当贴图尚未被第三方软件预过滤时需先执行该步骤第 213 行。加载契约补齐后从 HDR/EXR 等源生成 cube 与预过滤贴图的路径更加完整一致避免第三方预过滤标记与实际纹理数据不匹配导致的错误采样。四、Core动画组根运动Root Motion——RootMotionClip 与 RootMotionController本次发布说明中最具功能性的新增项Add root motion for animation groups: RootMotionClip and RootMotionController是什么RootMotionClip从动画组中提取根运动角色在一整个循环内被动画带动的位移与转向RootMotionController负责把这些运动逐帧应用到角色节点上。最终效果是角色真正向前走而脚步不再打滑skating。完整实现位于 rootMotion.ts。核心用法来自源码文档注释const walk new RootMotionClip(walkGroup); const controller new RootMotionController(walk.characterNode, [walk]); walk.animationGroup.start(true);多个 clip 同时播放时根运动会按照动画混合器的权重一起混合const controller new RootMotionController(character, [walk, run]); walk.animationGroup.start(true); run.animationGroup.start(true); walk.animationGroup.weight 0.3; run.animationGroup.weight 0.7;根运动来源RootMotionSourceRootMotionClip在构造时对动画组做一次性分析不播放、不修改源动画组来源由 rootMotion.ts 中的RootMotionSource枚举描述Root根节点自身的位移动画是ground truth其位移必要时连转向从 in-place 动画组中抽出改由角色节点承担FootContact对原地in-place循环从接触节点通常是脚推导位移——植地的接触点在世界上不动那么在角色空间里它就反向移动角色因此获得位移None未发现任何运动。默认先尝试Root失败再回退FootContact可用IRootMotionClipOptions.source强制指定。关键选项参数IRootMotionClipOptions见 rootMotion.ts包含参数默认值作用rootNode组内带动画后代最多的位置动画节点根节点通常是髋部或专用根骨骼传入 Bone 会解析为其绑定的 TransformNodecharacterNode根节点的最顶层祖先glTF 的__root__接收运动、以其局部空间度量运动的节点该节点本身不能被组动画化contactNodes根下最接近地面的叶节点用于 FootContact 推导的接触节点samplesPerSecond60分析时的采样密度每秒采样数minimumTravel0.1×角色高度循环内位移低于该比例视为原地晃动而非根运动minimumTurn10 度循环内转向低于该角度视为扭转而非转向extractRotation条件开启是否抽取根绕上轴的转向并应用到角色extractLateralMotionfalse是否抽取全部水平运动用于 strafe 类动画upAxisY角色空间的上轴cloneAnimationsfalse是否克隆全部动画而非仅克隆被改写的根通道运行时行为与源码佐证RootMotionClip.animationGroup是源组的克隆默认命名原名 (in place)其中已把根的位移/转向抽走播放它即可原地循环源组从不被修改见sourceAnimationGroupgetter 与_buildInPlaceGrouprootMotion.ts。RootMotionController通过场景的onAfterAnimationsObservable挂接见SceneRootMotionrootMotion.ts在动画求值后、世界矩阵计算前统一应用运动并通过_animationWrites记录精确还原混合器对根通道的写入权重从而让多个 clip 混合、additive 动画、blend in 等场景下角色位移与姿势严格一致。供外部使用的数据接口deltaPosition本帧位移世界空间、deltaRotation本帧绕上轴转向、cycleDistance单循环沿行进方向的距离、averageSpeed速度、onRootMotionObservable每帧运动产生时通知。将applyToCharacter设为false后可自行消费deltaPosition/deltaRotation例如驱动物理角色控制器。使用注意源动画组不能是 additive构造会抛错正确做法是先由源组构建 clip再对clip.animationGroup调用AnimationGroup.MakeAnimationAdditive(..., { referenceFrame: 0 })并配合cloneAnimations: true保护源组关键帧见 rootMotion.ts 文档注释。clip 的 in-place 组属于场景而非源资产的 asset container用完后需显式dispose()。五、CoreGaussian Splatting 两项修复Use nearest sampling for Gaussian Splatting data texturesPR #18933 Fix WGSL vPartIndex redefinition when combining Gaussian Splatting material pluginsPR #18931最近邻采样Gaussian Splatting高斯泼溅的核心数据——位置、协方差、颜色、透明度——存放在若干数据纹理中这些纹理存储的是离散的高斯属性而非需要插值的图像。此前若数据纹理使用线性/双线性采样会在相邻高斯之间产生错误的插值结果。修复后数据纹理统一采用最近邻采样nearest sampling保证每个纹素对应一个高斯的原始属性。对应实现位于 packages/dev/core/src/Materials/GaussianSplatting/核心材质类gaussianSplattingMaterial及配套着色器 gaussianSplatting.fragment.fx、gaussianSplatting.vertex.fxWGSL 版本位于 ShadersWGSL。WGSL vPartIndex 重定义将多个 Gaussian Splatting 材质插件如拾取、调试、纯色等见 Materials/GaussianSplatting 下的gaussianSplattingGpuPickingMaterialPlugin、gaussianSplattingDebugMaterialPlugin、gaussianSplattingSolidColorMaterialPlugin组合使用时WGSL 着色器中会出现vPartIndex被重复声明的冲突。此项修复调整了声明位置/守卫条件使多个插件组合时 WGSL 编译不再报错同时保持 GLSL 路径行为不变。六、LoadersOBJFileLoader 的 AssetContainer 处理与纹理加载等待OBJFileLoader: Fix AssetContainer handling and add opt-in texture loading waits修复内容AssetContainer 处理修复此前通过AssetContainer加载 OBJ 时材质/纹理的归属可能错乱如_parentContainer未正确设置、资源未被纳入容器。修复后材质与纹理在容器模式下通过scene._executeWithBlockedEntityCollection正确建立归属关系并设置_parentContainer与容器内的materials/textures列表。可选的纹理加载等待opt-inMTL 解析在创建材质后立即返回纹理异步加载可能未完成导致首帧贴图缺失。新增等待纹理加载完成的开关开启后加载流程会等待所有 MTL 引用的纹理就绪再完成。源码证据在 mtlFileLoader.ts 中材质创建走容器收集路径第 94-97 行scene._executeWithBlockedEntityCollection(!!assetContainer, ...)后material._parentContainer assetContainer; assetContainer?.materials.push(material);各贴图槽ambient/diffuse/specular/bump/opacity统一通过MTLFileLoader._GetTexture(rootUrl, value, scene, assetContainer, invertTextureY, textureLoadPromises)创建并把 promise 收集到textureLoadPromises第 140-173 行供可选的等待逻辑使用纹理创建同样受容器模式约束并记录_parentContainer与textures列表第 266-277 行。使用建议在OBJFileLoader的加载选项或SceneLoader.ImportMeshAsync的相应参数中启用纹理等待开关可以保证 OBJMTL 资源在异步纹理全部就绪后才触发完成回调适合需要首帧即展示完整贴图的场景。七、小结本次发布说明的工程价值正确性优先Atmosphere 插件场景隔离、深度预通道 alpha 一致性、Cube 加载契约补全三处都属于多场景/多路径下行为一致的稳健性修复新能力落地RootMotionClip/RootMotionController为动画组引入了完整的根运动管线是本次变更中功能增量最大的一项渲染管线细节Gaussian Splatting 数据纹理的最近邻采样与 WGSL 变量冲突修复直接关系到新渲染特性的正确显示加载体验OBJFileLoader 的容器归属与可选纹理等待让资产管线更可靠。若要进一步深入可直接阅读上述源码文件根运动核心见 rootMotion.ts大气系统见 atmosphere.ts深度预通道见 depthRenderer.pure.tsOBJ 加载见 mtlFileLoader.ts 与 objFileLoader.pure.ts。赞分享图形学游戏开发3D渲染【免费下载链接】Babylon.jsBabylon.js is a powerful, beautiful, simple, and open game and rendering engine packed into a friendly JavaScript framework.项目地址https://gitcode.com/gh_mirrors/ba/Babylon.js点击查看免费下载相关推荐SciPy 1.9.2 版本发布说明与修复深度解析SciPy 1.9.2 版本发布说明与修复深度解析 本文基于 1.9.2 Release Notes https://link.gitcode.com/i/89科学计算数据科学高性能计算CPython 3.5.2rc1 发布说明深度解读安全修复、核心 Bug 修复与标准库增强全解析CPython 3.5.2rc1 发布说明深度解读安全修复、核心 Bug 修复与标准库增强全解析 本篇指南基于 CPython 官方仓库中的 3.5.2rc1编程语言语言运行时解释器标准库Longhorn v1.6.3 发布说明深度解读关键修复、升级路径与监控增强Longhorn v1.6.3 发布说明深度解读关键修复、升级路径与监控增强 导读 Longhorn v1.6.3 是 1.6.x 系列的重要补丁版本围绕系云原生存储高可用容器编排创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考