You need to enable JavaScript to run this app. Three.js(React Three Fiber) 实现可留存圆形鼠标拖尾的方法
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.17 16:24:05