r3f-fundamentals

用途：介绍 React Three Fiber（R3F）的核心用法，将 Three.js 的命令式 API 映射为 React 的声明式 JSX，并自动处理资源释放与生命周期集成。主要能力包括：Canvas 配置（gl、dpr、shadows、camera、frameloop、performance、onCreated）、场景层级（JSX 嵌套表达父子关系，group 与 object3D 等容器）、相机系统（默认透视相机参数 fov/near/far/position，支持正交相机与自定义相机组件）、灯光（ambientLight、directionalLight、pointLight、spotLight、hemisphereLight 及阴影设置）、渲染循环（useFrame 每帧执行，state 提供 clock、camera、scene、gl、size、viewport、mouse、raycaster，可按优先级排序）、useThree 访问 Three.js 对象、ref 直接操作、指针事件（onClick、onPointerOver 等）以及 Suspense 与 useLoader 异步加载。使用方式：安装 @react-three/fiber 与 three 后，用 <Canvas> 包裹场景内容，通过 JSX 声明网格、几何体与材质，动画在 useFrame 中基于 delta 更新。依赖示例：@react-three/fiber ^8.15.0、three ^0.160.0、react ^18.2.0。资料还提供 references 下的 canvas-props、hooks-api、event-system 文档及 scripts/templates 中的基础、带光照与交互模板。限制：当前资料未提供具体收费、授权协议、浏览器兼容范围或性能基准等细节，暂未提供。