Three.js(React Three Fiber) 实现可留存圆形鼠标拖尾的方法
核心问题根因
- 当前实现每帧直接将全屏平面输出到默认画布,未将历史绘制结果存入持久化渲染目标,每帧默认画布自动清空,导致拖迹无法留存。
- 代码中声明的
u_texture仅为初始化的空浮点纹理,未实际接入渲染流程,既未被作为渲染输出目标,也未在每帧读取作为上一帧的画面基底。 - 单独设置画布Alpha为0无法实现留存效果,因为Three.js默认会在每帧渲染时根据配置清空画布,与自定义绘制逻辑完全脱节。
可落地的Ping-Pong FBO实现方案
原bidello辅助类实现拖尾留存的核心就是双帧缓冲循环,不需要依赖任何额外库,直接基于React Three Fiber原生能力即可实现:
1. 渲染流程逻辑
- 初始化两个与屏幕尺寸完全一致的WebGLRenderTarget,分别作为前帧纹理缓存、当前帧渲染目标,每帧绘制完成后交换两个目标的引用形成循环。
- 渲染顺序固定为:先将当前帧的拖尾效果(基于鼠标位置、移动速度计算的圆形亮度)绘制到离屏目标,读取上一帧的纹理作为初始颜色基底,对全画面做固定比例的亮度衰减实现自然淡化,最后将离屏目标的结果绘制到屏幕。
2. 代码调整细节
Plane.js 组件改造
- 删除原代码中无实际作用的空DataTexture定义,替换为两个离屏渲染目标:
// 组件初始化时创建两个同尺寸渲染目标,适配浮点精度存储亮度值 const renderTargetA = useMemo(() => new THREE.WebGLRenderTarget(width, height, { type: THREE.FloatType, minFilter: THREE.LinearFilter, magFilter: THREE.LinearFilter, format: THREE.RGBAFormat }), [width, height]) const renderTargetB = useMemo(() => new THREE.WebGLRenderTarget(width, height, { type: THREE.FloatType, minFilter: THREE.LinearFilter, magFilter: THREE.LinearFilter, format: THREE.RGBAFormat }), [width, height])
- 调整uniforms中
u_texture的初始值,后续每帧动态指向交换后的前帧纹理。 - 修正
useFrame钩子逻辑,接入完整的离屏渲染流程:
useFrame((state, delta) => { // 原有鼠标插值、速度计算逻辑全部保留 uniforms.u_time.value += delta uniforms.u_mouse.value.lerp(pointer, 0.2) const diffSpeed = Math.max(Math.abs(diff.speedX), Math.abs(diff.speedY)) * 0.05 speed += diffSpeed speed *= 0.9 uniforms.u_speed.value = speed // 1. 将渲染目标切换到当前离屏缓存 state.gl.setRenderTarget(renderTargetB) // 2. 给着色器传入上一帧的纹理作为拖迹基底 uniforms.u_texture.value = renderTargetA.texture // 3. 在离屏目标上执行当前帧的全屏平面绘制 state.gl.render(state.scene, state.camera) // 4. 交换两个渲染目标,为下一帧的循环做准备 const temp = renderTargetA renderTargetA = renderTargetB renderTargetB = temp // 5. 切回默认画布,将离屏缓存的最终结果输出到屏幕 state.gl.setRenderTarget(null) })
片元着色器修正
- 删除不存在的
v_uv变量引用,当前着色器使用gl_FragCoord计算uv坐标 - 修正纹理采样逻辑,实现全画面自然淡化,无需手动偏移uv:
// 片元着色器顶部提前定义圆形函数 float circle(vec2 uv, vec2 center, float radius, float softness) { float d = distance(uv, center); return smoothstep(radius, radius - softness, d); } uniform vec2 u_resolution; uniform vec3 u_mouse; uniform float u_time; uniform float u_ratio; uniform float u_speed; uniform sampler2D u_texture; void main() { vec2 uv = gl_FragCoord.xy / u_resolution.xy; // 读取上一帧的全画面颜色作为拖迹基底 vec4 prevColor = texture2D(u_texture, uv); vec2 center = u_mouse.xy / 2. + .5; vec2 scaledUv = uv * u_ratio; vec2 scaledCenter = center * u_ratio; // 计算当前鼠标位置的圆形亮度叠加值 float circleBrightness = circle(scaledUv, scaledCenter, 0.0, .08) * u_speed; // 全画面每帧降低2%亮度,实现自然淡出效果 vec4 finalColor = prevColor * 0.98; // 叠加当前帧的鼠标圆形特效 finalColor.r += circleBrightness; finalColor.g = finalColor.r; gl_FragColor = clamp(finalColor, 0.0, 1.0); }
关键注意事项
- 不需要手动调用
state.gl.setClearColor将Alpha设为0,离屏渲染目标每帧会自动保留上一次的渲染结果,不需要主动清空。 - 渲染目标尺寸要与窗口实际尺寸完全一致,窗口resize时要同步调用
renderTarget.setSize()更新缓存尺寸,避免画面拉伸。
内容的提问来源于stack exchange,提问作者FRMR
相关产品推荐
相关产品推荐

