有没有限制?
没有。Three.js 里能跑的东西在这里都能跑,没有例外。
react-three-fiber · pmndrs/react-three-fiber
react-three-fiber 是 pmndrs 组织下的开源项目,仓库描述为“A React renderer for Three.js”,即面向 Three.js 的 React 渲染器。项目主要使用 TypeScript,仓库话题涵盖 3D、动画、fiber、React、渲染器与 Three.js。适合关注 React 与...
react-three-fiber(包名 @react-three/fiber,简称 R3F)是 pmndrs 社区维护的一个 React 渲染器,作用对象是 Three.js。它的定位与 react-dom、react-native 属于同一层级:把 Three.js 的场景描述交给 React 的组件模型来组织。
README 用一句话概括:用可复用、自包含的组件以声明式方式构建场景,这些组件能响应状态、天然可交互,并且可以参与 React 生态。安装方式为:
npm install three @types/three @react-three/fiber
需要特别注意的是版本配对规则(README 中以醒目的警告标出):three-fiber 是 React 渲染器,必须与 React 的主版本配套使用——@react-three/fiber@8 对应 react@18,@react-three/fiber@9 对应 react@19。
没有。Three.js 里能跑的东西在这里都能跑,没有例外。
不会。没有额外开销,组件在 React 之外渲染;由于 React 的调度能力,在大规模场景下表现更好。
能。它只是把 Three.js 表达为 JSX,`<mesh />` 会动态转成 `new THREE.Mesh()`。Three.js 版本新增、删除或修改特性时,无需等待本库跟进即可使用。
useFrame((state, delta) => ...) 将组件挂到每帧回调中,适合做旋转、动画等逐帧更新。onClick、onPointerOver、onPointerOut 等指针事件可直接写在 mesh 上,配合 useState 即可实现悬停变色、点击缩放等交互。useLoader 或 Drei 的 useGLTF、useTexture 等抽象,可能需要在 metro.config.js 中配置 sourceExts 与 assetExts(如 glb、png、jpg)。示例基于 react 18 与 expo-cli,也可以用模板或 react-native CLI 创建裸项目。README 给出的示例是一个带自身状态、响应用户输入、并接入渲染循环的可复用组件 Box:
useRef 拿到真实的 THREE.Mesh 对象引用;useState 保存 hovered / clicked 两种交互状态;useFrame 订阅渲染循环,每帧按 delta 递增旋转角度;<mesh>、<boxGeometry>、<meshStandardMaterial> 都是 Three.js 元素在 JSX 中的表达,并直接绑定 onClick、onPointerOver、onPointerOut 等事件。挂载时用 createRoot(document.getElementById('root')) 渲染 <Canvas>,内部再放 <ambientLight>、<spotLight>、<pointLight> 以及两个 Box。README 同时提供了 TypeScript 版本(组件参数类型写作 ThreeElements['mesh'],useRef<THREE.Mesh>(null!))和 React Native 版本(从 @react-three/fiber/native 导入 Canvas 与 useFrame)。
官方文档站点为 docs.pmnd.rs,README 指向其中包含教程与示例的板块。源码仓库内也提供了可在线运行的演示(CodeSandbox 链接,含 JS 与 TS 两个版本)。
README 推荐的学习材料包括:
README 明确提醒:在动手之前,应当同时熟悉 React 与 Three.js。若对 React 不确定,先读 React 官方文档,特别是 Hooks 部分;对 Three.js,建议按以下顺序推进:
mesh、ambientLight 等)——所有 Three.js 导出在 three-fiber 中都是原生可用的;README 强调 three-fiber 周边有相当丰富的库、辅助工具与抽象层,并逐一列出,例如:
@react-three/drei:实用辅助集合,README 称其「本身就是一个生态」;@react-three/gltfjsx:把 GLTF 转成 JSX 组件;@react-three/postprocessing:后处理特效;@react-three/uikit:为 three-fiber 提供 WebGL 渲染的 UI 组件;@react-three/test-renderer:用于 node 环境下的单元测试;@react-three/offscreen:离屏 / worker 画布;@react-three/flex:flexbox 布局;@react-three/xr:VR/AR 控制器与事件;@react-three/csg:构造实体几何;@react-three/rapier、@react-three/cannon、@react-three/p2:分别基于 Rapier、Cannon 的 3D 物理与基于 P2 的 2D 物理;@react-three/a11y:场景可访问性;@react-three/gpu-pathtracer:路径追踪;create-r3f-app next(Next.js 起始模板)、lamina(分层着色器材质)、leva(快速搭建 GUI 控件)、maath(数学辅助)、miniplex(ECS)、composer-suite、triplex(可视化编辑器)等。这些清单可作为按需选型的索引,具体用法需查阅各子项目文档。
Farbrausch 2001—2011 年 demo 工具源码合集,使用 C++,涉及 demoscene 与 D...
该仓库为 Java 语言项目,名称 BuildGDX 由「Build」与「GDX」组合,推测与 B...
id Software 以 GPL 许可证发布的《雷神之锤3竞技场》(Quake III Arena)源...