SGDK中SPR_isAnimationDone函数在帧切换回调中的状态检测问题分析

问题背景

在SGDK(Sega Genesis Development Kit)游戏开发库中，SPR_isAnimationDone(..)函数用于检测精灵动画是否播放完成。然而，当这个函数从帧切换回调中被调用时，它无法正确报告动画状态。这个问题的根源在于精灵计时器(_sprite->timer)的处理逻辑存在缺陷。

问题详细分析

计时器处理的历史演变

最初的设计中，_sprite->timer在回调调用前被设置为帧计时器值。但这种实现导致isAnimationDone无法正确报告动画状态。随后开发者修改了逻辑，改为在回调调用前将timer保持为0，只有在回调调用完成且回调中没有自定义修改timer(即timer仍为0)的情况下，才将timer重置为帧计时器值。

当前状态检测逻辑

在主循环中，动画完成状态通过以下条件判断：

(frameInd == last) && (!loop || (timer == 1))

而在帧切换回调中，当frameInd == 0时，存在两种情况需要区分：

1. 动画循环播放的情况：需要返回TRUE
2. 通过SPR_setAnimation(x)切换动画的情况：需要返回FALSE

技术难点

主要挑战在于如何区分这两种情况。值得注意的是，如果动画不循环，那么在动画结束时不会调用帧切换回调，这一点需要开发者特别注意。

解决方案思路

为解决这个问题，可以考虑以下方法：

1. 在SPR_setNextFrame(..)中设置一个状态标志位(当动画循环时)，这个标志位在清除NEED_FRAME_UPDATE标志(updateFrame)时被清除。

2. 利用sprite->frame字段来区分内部设置的帧索引(frameInd)和当前显示的帧(*frame)。由于DMA传输可能被延迟，显示更新可能会有滞后，因此这两个字段可能存在不一致。

实现细节

最终的修复方案需要确保：

• 在主循环中能正确检测动画完成状态
• 在回调中能区分是动画循环还是动画切换
• 保持与DMA显示更新的兼容性

开发者注意事项

开发者在使用帧切换回调时需要注意：

• 非循环动画结束时不会触发帧切换回调
• 动画状态检测在回调中的行为与主循环中可能不同
• 显示帧可能滞后于实际动画帧索引

这个问题已在2024年12月13日的更新中得到修复，开发者可以更新到最新版SGDK以获得正确的动画状态检测行为。