自定义结构类型的动画 NSView 属性

Question

我有一个NSView子类，其属性在 header 中声明如下：

@property (nonatomic) BaseRange range;

BaseRange定义为：

typedef struct BaseRange {          
    float start;
    float len;
} BaseRange;

我想使用NSAnimatablePropertyContainer协议为range属性设置动画。

我的 class 根据需要覆盖+ defaultAnimationForKey: 。

问题是，当我调用[myView.animator setRange:<some value>] （ myView是有问题的 class 的一个实例）时， myView在 animation 的每一步都发送-setNilValueForKey: range键，除了最终价值。 IOW，animation 不起作用。

如果我这样定义range属性：

@property (nonatomic) NSSize range;

并且不要更改任何其他内容，不会发送-setNilValueForKey:消息，而是像往常一样发送range键的中间值。

但我不想使用NSSize ，因为range键应该代表一个范围而不是一个大小。

有什么建议么？

Answer 1

如果您从+[NSAnimatablePropertyContainer defaultAnimationForKey:]方法返回CAPropertyAnimation或其子类，则行为是预期的，因为它适用于严格的一组值：

• 整数和双打
• CGRect 、 CGPoint 、 CGSize和CGAffineTransform结构
• CATransform3D数据结构
• CGColor和CGImage参考资料

据我所知， CAAnimation及其子类不能使用超出此集合的任意值，并且主要专注于使用 Core Graphics 属性（层、帧、colors 等）。 但是，在 macOS 上，您可以改用NSAnimation class，它更加灵活，但需要对 class 进行额外的自定义。首先，您应该NSAnimation本身并覆盖-[NSAnimation setCurrentProgress:]方法（这不是强制性的，但否则您将无法在 animation 步之间获得足够平滑的过渡）：

- (void)setCurrentProgress:(NSAnimationProgress)currentProgress {
    [super setCurrentProgress:currentProgress];

    // Range owner refers to the object (view) with the property of custom struct type
    // Range Key Path helps to locate the property inside the object
    if (!_rangeOwner || !_rangeKeyPath) {
        return;
    }

    static const char *const kTDWRangeEncoding = @encode(TDWRange);

    // Wraps new range with NSValue
    NSValue *newRange = [NSValue value:&(TDWRange){
        .location = (_targetRange.location - _originalRange.location) * currentProgress + _originalRange.location,
        .length = (_targetRange.length - _originalRange.length) * currentProgress + _originalRange.length
    } withObjCType:kTDWRangeEncoding];

    // Sends new value to the object that owns the range property
    [_rangeOwner setValue:newRange
               forKeyPath:_rangeKeyPath];
}

在这个实现中：

• TDWRange指的是表示范围的自定义结构；
• _rangeOwner指的是 object ，它有一个TDWRange类型的属性；
• _rangeKeyPath指的是NSAnimation子类可以找到该属性的关键路径；
• _targetRange是 animation 插入的值；
• _originalRange是 animation 开始之前的属性值。

然后，在您的自定义视图 class 中，您应该提供一种单独的方法来使用给定的 animation 更新属性。假设 animation class 被称为TDWRangeAnimation并且可以通过@"range"键路径访问范围属性，这样的方法可能看起来像这样:

- (void)setRange:(TDWRange)range animated:(BOOL)animated {
    if (animated) {
        TDWRangeAnimation *rangeAnimation = [[TDWRangeAnimation alloc] initWithRangeOwnder:self
                                                                              rangeKeyPath:@"range"
                                                                               targetRange:range
                                                                                  duration:0.4
                                                                            animationCurve:NSAnimationEaseOut];
        rangeAnimation.animationBlockingMode = NSAnimationNonblocking;
        [rangeAnimation startAnimation];
    } else {
        self.range = range;
    }
}

您不需要保留 animation object，因为它由运行循环维护，直到 animation 完成。

---

PS 如果您需要完整的实施示例，请随时参考要点。