如何让Pygame Animator的addAnimation支持直接传入属性而非对象与属性名

要实现直接传递sprite.position.x这类属性引用的效果，核心问题是Python中直接传递属性值时，传递的是属性的当前值而非引用，无法反向推导所属对象和属性路径。以下是几种实用的实现方案：

方案1：链式属性代理类（最接近需求的直观语法） #

通过自定义代理类捕获属性访问路径，让用户可以用类似直接访问属性的语法传递目标：

class AttrProxy:
    def __init__(self, obj, attr_path=None):
        self.obj = obj
        self.attr_path = attr_path or []

    def __getattr__(self, attr_name):
        # 链式调用时逐步构建属性路径
        return AttrProxy(self.obj, self.attr_path + [attr_name])

    def get_value(self):
        # 按路径获取当前属性值
        current_obj = self.obj
        for attr in self.attr_path:
            current_obj = getattr(current_obj, attr)
        return current_obj

    def set_value(self, new_value):
        # 按路径设置属性值
        current_obj = self.obj
        # 遍历到倒数第二层属性
        for attr in self.attr_path[:-1]:
            current_obj = getattr(current_obj, attr)
        # 设置最后一层属性
        setattr(current_obj, self.attr_path[-1], new_value)

class Animator:
    def __init__(self):
        self.animations = []

    # 新增辅助方法生成属性代理
    def attr(self, target_obj):
        return AttrProxy(target_obj)

    def addAnimation(self, target_proxy, new_value, duration=1, easingFunction=easeLinear, type=float):
        # 从代理获取初始值和操作方法
        start_value = type(target_proxy.get_value())
        new_value = type(new_value)
        # 保存动画所需信息
        self.animations.append({
            'getter': target_proxy.get_value,
            'setter': target_proxy.set_value,
            'start': start_value,
            'end': new_value,
            'duration': duration,
            'easing': easingFunction,
            'elapsed': 0.0
        })

    # 示例帧更新方法
    def update(self, dt):
        for anim in self.animations[:]:
            anim['elapsed'] += dt
            progress = min(anim['elapsed'] / anim['duration'], 1.0)
            current_value = anim['easing'](anim['start'], anim['end'], progress)
            anim['setter'](current_value)
            # 动画结束后移除
            if progress >= 1.0:
                self.animations.remove(anim)

调用方式 #

# 语法接近直接访问属性，无需手动传入对象和属性名
animator.addAnimation(animator.attr(sprite).position.x, 200, duration=1.5)

方案2：传递Getter/Setter Lambda表达式 #

如果不想引入额外类，可直接让用户传递获取和设置属性的lambda函数，灵活性更高：

class Animator:
    def __init__(self):
        self.animations = []

    def addAnimation(self, getter, setter, new_value, duration=1, easingFunction=easeLinear, type=float):
        start_value = type(getter())
        new_value = type(new_value)
        self.animations.append({
            'getter': getter,
            'setter': setter,
            'start': start_value,
            'end': new_value,
            'duration': duration,
            'easing': easingFunction,
            'elapsed': 0.0
        })

    # update方法同方案1

调用方式 #

animator.addAnimation(
    getter=lambda: sprite.position.x,
    setter=lambda v: setattr(sprite.position, 'x', v),
    new_value=100,
    duration=2
)

方案3：兼容原有API的混合模式 #

如果需要兼容旧版调用方式，可以让addAnimation自动识别参数类型，同时支持两种调用风格：

class Animator:
    def __init__(self):
        self.animations = []

    def attr(self, target_obj):
        return AttrProxy(target_obj)

    def addAnimation(self, *args, **kwargs):
        # 处理新调用风格：第一个参数是AttrProxy
        if len(args) > 0 and isinstance(args[0], AttrProxy):
            target_proxy = args[0]
            new_value = args[1]
            duration = args[2] if len(args) >2 else kwargs.get('duration', 1)
            easing = kwargs.get('easingFunction', easeLinear)
            type_conv = kwargs.get('type', float)
            
            start_value = type_conv(target_proxy.get_value())
            new_value = type_conv(new_value)
            self.animations.append({
                'getter': target_proxy.get_value,
                'setter': target_proxy.set_value,
                'start': start_value,
                'end': new_value,
                'duration': duration,
                'easing': easing,
                'elapsed': 0.0
            })
        # 处理旧调用风格：obj, attr_name, new_value...
        else:
            obj = args[0]
            attr_name = args[1]
            new_value = args[2]
            duration = args[3] if len(args) >3 else kwargs.get('duration',1)
            easing = kwargs.get('easingFunction', easeLinear)
            type_conv = kwargs.get('type', float)
            
            start_value = type_conv(getattr(obj, attr_name))
            new_value = type_conv(new_value)
            self.animations.append({
                'getter': lambda: getattr(obj, attr_name),
                'setter': lambda v: setattr(obj, attr_name, v),
                'start': start_value,
                'end': new_value,
                'duration': duration,
                'easing': easing,
                'elapsed': 0.0
            })

    # update方法同方案1

优缺点对比 #

额外建议 #

• 对于嵌套属性（如sprite.position.x），需注意动画过程中父属性（如sprite.position）被重新赋值的情况：此时动画会继续修改原来的position对象的x属性，若需要跟踪新的父属性，需在代理类中加入实时解析路径的逻辑（而非缓存初始对象）。
• 可在AttrProxy中加入属性存在性检查，避免用户传递不存在的属性时出现静默错误。

内容的提问来源于stack exchange，提问作者Rich. T.