SuperAPI AI 工具集

pixijs-scene-core-concepts

前端与建站

查看项目

更新于 10-16 03:42

技能介绍

用途:这是所有 pixijs-scene-* 叶子技能共享的心智模型,用于整体理解 PixiJS v8 场景图——容器、叶子、变换与渲染顺序如何组合。它不深入单个 API,而是勾勒各部分并指向对应技能或参考文件。

主要能力:说明场景图是以 app.stage 为根的显示对象树,每帧渲染器遍历树、合成变换与视觉状态、剔除离屏对象并发出绘制调用;渲染顺序即兄弟节点数组顺序。区分两类角色:Container(或 RenderLayer)用于分组、定位、变换其他节点;叶子(Sprite、Graphics、Text、Mesh、ParticleContainer 的 Particle、DOMContainer、GifSprite)负责绘制且不应有子节点,v8 中给叶子添加子节点会记录弃用警告并计划变为硬错误。

必要用法:用 Container 包裹需要分组的叶子;用 toGlobal(point) 与 toLocal(point, from?) 在坐标空间间转换,getGlobalPosition() 取世界位置;单容器显式 z 排序需设 sortableChildren = true 并给子节点赋 zIndex;解耦渲染顺序用 RenderLayer;大型稳定子树设 isRenderGroup: true 或调用 enableRenderGroup();剔除用 cullable = true 加 cullArea;遮罩设 container.mask;销毁分支用 container.destroy({ children: true })。

适用场景:布局与渲染顺序调试、世界/UI 层组织、遮罩裁剪、性能优化(渲染组、剔除、缓存)。

限制:v8 已移除 DisplayObject,所有显示对象均为 Container 子类;叶子不应持有子节点;child.x 为局部坐标而非世界坐标;sortableChildren 仅在子节点有不同 zIndex 时生效。具体 API 细节见 pixijs-scene-container、pixijs-math、pixijs-performance 等技能与 references 目录文件。