### 使用 `animation` 装饰器实现自定义可动画属性 在 Python 中，为了创建带有动画效果的对象属性，可以利用装饰器模式来增强类的功能。假设存在一个名为 `@animation` 的装饰器，该装饰器能够使被修饰的方法支持动画特性。 对于想要让某个特定的属性具备随时间变化的能力，可以通过如下方式构建： #### 定义 Animation 类与 Decorator 首先定义一个基础的 `Animation` 类用于处理动画逻辑，并提供了一个简单的线性插值函数作为示例[^1]。 其次实现了 `animation_decorator` 函数，它接受目标对象以及要设置成可动状态的目标属性名称作为参数，在内部通过闭包机制返回一个新的方法给调用者[^2]。 ```python from functools import wraps class Animation: @staticmethod def lerp(start, end, t): # Linear interpolation function return start * (1 - t) + end * t def animation_decorator(attr_name): """Decorator to make an attribute animatable.""" def decorator(func): @wraps(func) def wrapper(self, target_value, duration=1.0, elapsed_time=0.0): current_value = getattr(self, attr_name) if elapsed_time >= duration: setattr(self, attr_name, target_value) func(self, target_value) else: progress = elapsed_time / duration animated_value = Animation.lerp(current_value, target_value, progress) setattr(self, attr_name, animated_value) func(self, animated_value) return wrapper return decorator ``` #### 应用到具体场景中的例子 下面展示的是如何将上述概念应用于实际案例——即创建一个具有位置移动能力的小球实例。这里的位置坐标（x,y）就是我们希望赋予其动态特性的两个属性[^3]。 ```python class Ball: def __init__(self, x=0, y=0): self.x = x self.y = y @animation_decorator('x') def set_x_animated(self, value, **kwargs): print(f"Setting X position with animation: {value}") @animation_decorator('y') def set_y_animated(self, value, **kwargs): print(f"Setting Y position with animation: {value}") ball_instance = Ball() # Simulate setting new positions over time. for i in range(6): ball_instance.set_x_animated(i*5, duration=5, elapsed_time=i) ball_instance.set_y_animated((i+1)*7, duration=5, elapsed_time=i) ``` 在这个例子中，每当更新小球的位置时都会触发相应的 setter 方法并传入当前经过的时间比例 (`elapsed_time/duration`) 来计算中间过渡值，从而达到平滑变换的效果[^4]。