NSView+RBLAnimationAdditions.h

//
//  NSView+RBLAnimationAdditions.h
//  Rebel
//
//  Created by Justin Spahr-Summers on 2012-09-04.
//  Copyright (c) 2012 GitHub. All rights reserved.
//

#import <Cocoa/Cocoa.h>

// Better block-based animation and animator proxies.
@interface NSView (RBLAnimationAdditions)

// Invokes +rbl_animate:completion: with a nil completion block.
+ (void)rbl_animate:(void (^)(void))animations;

// Executes the given animation block within a new NSAnimationContext. When all
// animations in the group complete or are canceled, the given completion block
// (if not nil) will be invoked.
+ (void)rbl_animate:(void (^)(void))animations completion:(void (^)(void))completion;

// Invokes +rbl_animate:completion:, setting the animation duration of the
// context before queuing the given animations.
+ (void)rbl_animateWithDuration:(NSTimeInterval)duration animations:(void (^)(void))animations completion:(void (^)(void))completion;

// Returns whether the calling code is executing in an animation context created
// by this category (like through -rbl_animate:completion:).
//
// This only describes whether an animation context is open, not if animations
// happen to be executing at the moment.
+ (BOOL)rbl_isInAnimationContext;

// Returns an animator proxy for the receiver if +rbl_isInAnimationContext
// returns YES. Otherwise, the receiver is returned (so that animating is
// effectively disabled).
- (instancetype)rbl_animator;

@end