JNWAnimatableWindow
is a NSWindow
subclass that adds a layer
property onto the window, allowing you to animate it as you wish.
JNWAnimatableWindow
has provides both a layer property and a set of order out & order front methods to simplify common animations. If you would like to animate the window manually and if the window is already visible, you can just manipulate the layer
property on the window.
The following methods exist to animate the window using implicit animations:
- (void)orderOutWithDuration:(CFTimeInterval)duration timing:(CAMediaTimingFunction *)timingFunction animations:(void (^)(CALayer *windowLayer))animations;
- (void)makeKeyAndOrderFrontWithDuration:(CFTimeInterval)duration timing:(CAMediaTimingFunction *)timingFunction setup:(void (^)(CALayer *windowLayer))setup animations:(void (^)(CALayer *layer))animations;
- (void)setFrame:(NSRect)frameRect withDuration:(CFTimeInterval)duration timing:(CAMediaTimingFunction *)timing;
If you would like to animate the window explicitly, you can do so using the following methods:
- (void)orderOutWithAnimation:(CAAnimation *)animation;
- (void)makeKeyAndOrderFrontWithAnimation:(CAAnimation *)animation;
All of these methods are explained fully in the header's documentation.
Closing:
[self.window orderOutWithDuration:0.7 timing:nil animations:^(CALayer *layer) {
layer.opacity = 0.f;
}];
Opening:
[self.window makeKeyAndOrderFrontWithDuration:0.7 timing:nil setup:^(CALayer *layer) {
// Setup is not animated
layer.opacity = 0.f;
} animations:^(CALayer *layer) {
// This is animated
layer.opacity = 1.f;
}];
Frame change:
[self.window setFrame:newFrame withDuration:0.7 timing:nil];
Explicit animation:
CABasicAnimation *opacity = [CABasicAnimation animationWithKeyPath:@"opacity"];
opacity.toValue = @0;
[self.window orderOutWithAnimation:opacity];
In the convenience methods, everything is wrapped in an animated CATransaction
, so you can modify any layer property you wish and it should be implicitly animated. Also note that passing in nil for the timing function will result in a default animation of ease-in-out.
If you want to just make your windows fly around the screen like a boss on a whim, you can directly use the layer
property on JNWAnimatableWindow
. The first time this property is accessed, it will lazily create an image representation of the window and place that into a layer which is then animatable. When you are done with the layer, you are responsible for calling -destroyTransformingWindow
, which will remove the extra window and release resources. This is not necessary if you use one of the convenience methods listed above.
See the demo for more examples, and see the header files for more complete documentation.
Due to the way NSWindow
works, there are some large limitations with what this library can provide. It works by taking an image representation of the window, and placing it in a layer, which is in an additional non-opaque fullscreen window. As a result of this static representation, if the window updates its contents while the layer is shown, that change will not be reflected in the layer. So as a result, this class is more geared toward short animations that take place during a time where the content is most unlikely to change, such as when the window is opening or closing.
JNWAnimatableWindow
is licensed under the MIT license. See LICENSE.md.
But really, all I care about is that you put this library to good use. I want to help make OS X development a friendlier place, and this is one of my attempts at doing so. If you use this, please make a note on the Wiki, or get in touch with me and I'll do it for you.
You can follow me on Twitter as @willing, email me at the email listed on my GitHub profile, or read my blog at jwilling.com.