Skip to content

Babylon.js 类型逃逸封装

系统概览

集中封装 Babylon.js 私有 API 访问与类型逃逸(as unknown as 断言),消除散落在业务代码中的类型逃生点。每个 helper 对应一处私有字段/未导出常量的访问,降低升级时断裂风险。

核心职责

  • env-type-helpers.ts — 私有 API 桥接、类型断言封装。

对外 API(节选)

  • getCanvasCtx(dt) — 封装 DynamicTexture.getContext()CanvasRenderingContext2D | null 的断言(可能为 null)。
  • REFRESHRATE_RENDER_ONCE — Babylon 未导出的静态常量(Number.MAX_VALUE),供 RenderTargetTexture 单帧渲染用。
  • FrozenCameraFreeCamera 私有字段接口(_worldMatrix / _isWorldMatrixFrozen),供 planar-reflection 镜像相机矩阵设置用。

与其他子系统关系