返回全部项目

agenticnoob/webgl-scroll

webgl-scroll

根据项目 README 整理

阅读项目

面向 React、Next.js 和智能体前端工作流的可组合 WebGL 滚动效果库,提供底层运行时、内置效果与 React 触发器,同时让宿主应用保留画布、渲染循环和销毁逻辑的控制权。

模块化包结构

核心包提供运行时、效果注册表、状态树、共享指针输入、GPU 辅助工具和自定义效果接口;效果包提供资源图层、WebGL 标题淡入、GLB 粒子和像素化转场;React 包将声明式触发配置映射为 DOM 元数据。

生命周期与资源加载

效果按其与视口的距离进行预载、暂停和卸载,并可限制并发预载数量。宿主既可以使用效果声明中的资源地址,也可以集中预取资源并通过解析器交给运行时;内置工具还能从效果配置生成资源请求清单。

集成边界与状态

库优先提供声明式触发器和已注册效果,宿主应用仍负责 Canvas 初始化、渲染循环与清理。这种边界允许应用先组合常见媒体和粒子效果,再在必要时扩展自定义运行时代码。

0.1.0 是首个公开发布线。README 所述的生命周期调度、宿主资源解析与相关加载能力位于尚待合并和发布后续版本的开发分支,因此这些更新尚不能视为已发布包能力。