# webgl-scroll：可组合的 WebGL 滚动效果

根据项目 README 整理

面向 React、Next.js 与智能体前端工作流的可组合 WebGL 滚动效果工具包，提供分层核心运行时、内置效果和 React 触发器，并支持按视口距离调度生命周期及由宿主协调资源预取。

[网站原文](https://zzzxc.com/projects/gh-1265195464)

## 解决的问题与方案

项目旨在减少滚动驱动 WebGL 页面中的重复集成工作。应用可通过声明式触发器组合效果，而底层运行时负责效果注册、状态、共享指针输入和 GPU 辅助能力。

## 包结构与内置效果

项目分为核心引擎、内置效果和 React 绑定。内置效果包括图像、视频与 GLB 资源层，WebGL 标题淡入，基于 GLB 表面采样的指针响应粒子，以及像素化全屏转场。React 组件会输出触发器元数据。

## 生命周期与资源加载

效果可依据其与视口的距离预加载、暂停和卸载，并限制并发预加载数量。配置既可全局设置，也可在触发器或单个效果层级覆盖。宿主还可提供资源解析器，并从效果声明生成内置资源的预加载清单。

## 职责边界与状态

宿主应用仍需负责画布初始化、渲染循环和清理，也可以统一管理资源下载。README 将 0.1.0 描述为首个公开发行系列；其中提及的生命周期调度和宿主资源预取改动仍位于开发分支，后续发布尚待合并与发版。

## 继续了解

- [项目源码](https://github.com/agenticnoob/webgl-scroll)

[内容目录](https://zzzxc.com/agent/zh/index.md)