Appearance
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单帧渲染用。FrozenCamera—FreeCamera私有字段接口(_worldMatrix/_isWorldMatrixFrozen),供planar-reflection镜像相机矩阵设置用。
与其他子系统关系
- 被
env-texture、env-ground等环境子系统引用。 FrozenCamera被planar-reflection使用。