`requestanimationframe` 本身不支持直接传参，需通过闭包或箭头函数包装回调；若参数是动态变化的引用（如 `roi?.data`），应传入对象本身而非其属性值，以确保每次动画帧获取最新数据。
在使用 requestAnimationFrame 实现持续动画或实时数据可视化（如直方图绘制）时，一个常见误区是：试图将“当前快照”式的参数（如 roi?.data）直接传入回调函数，并期望后续递归调用能自动捕获更新后的值。但事实是——requestAnimationFrame(() => drawHistogram(roi?.data, ctx)) 中的 roi?.data 仅在首次调用时求值一次，后续所有递归调用都复用这个初始值，导致图表无法响应数据更新。
✅ 正确做法：传入可变对象引用，而非其属性值
应将整个 roi 对象（或其他可变数据源）作为参数传入，让每次回调内部重新读取其最新状态：
function drawHistogram(roi, chartContext) {
const data = roi?.data; // ✅ 每次执行都获取最新 data
chartContext.clearRect(0, 0, chartCanvas.width, chartCanvas.height);
const histogram = new Array(256).fill(0);
for (let i = 0; i < data?.length; i += 4) {
histogram[data[i]]++;
}
const maxFrequency = Math.max(...histogram);
for (let i = 0; i < 256; i++) {
let height = (histogram[i] / maxFrequency) * chartCanvas.height;
if (histogram[i] === 1) height = Math.floor(Math.random() * 3);
chartContext.fillStyle = 'rgb(0, 0, 255)';
chartContext.fillRect(
i * (chartCanvas.width / 256),
chartCanvas.height - height,
chartCanvas.width / 256,
height
);
}
// 更新统计文本
const totalPixels = histogram.reduce((a, b) => a + b, 0);
const pixelsAboveThreshold = histogram.slice(threshold + 1).reduce((a, b) => a + b, 0);
pat.innerHTML = `${((pixelsAboveThreshold / totalPixels) * 100).toFixed(1)}%`;
// ✅ 递归调用：仍传入 roi（非 roi?.data），确保下次也读取最新值
requestAnimationFrame(() => drawHistogram(roi, chartContext));
}
// 启动动画：传入 roi 对象本身
requestAnimationFrame(() => drawHistogram(roi, chartContext));⚠️ 关键注意事项
- 避免“参数冻结”陷阱：roi?.data 是表达式，在箭头函数中求值后即固化为某个数组实例（或 undefined）。若 roi.data 后续被替换（如新图像加载完成），旧引用不会自动更新。
- 闭包 vs. 参数传递：你也可以选择不传参，改用闭包捕获外部变量（如 const roiRef = roi; requestAnimationFrame(() => drawHistogram(roiRef, ctx))），但显式传参更清晰、更易测试和复用。
- 性能提示：Math.max(...histogram) 在大数据量下可能有性能开销，生产环境建议用循环替代展开运算符。
- 清理机制（进阶）：长期运行的 rAF 链应提供取消能力（如保存 id 并调用 cancelAnimationFrame(id)），防止内存泄漏或意外重绘。
总之，requestAnimationFrame 的参数传递本质是 JavaScript 函数调用问题——把握「值传递」与「引用传递」的区别，始终让动态数据在每次执行时按需读取，才能构建健壮、响应式的视觉更新逻辑。
