Class

NSViewAnimation

The NSViewAnimation class, a public subclass of NSAnimation, offers a convenient way to animate multiple views and windows. The animation effects you can achieve are limited to changes in frame location and size, and to fade-in and fade-out effects.

Overview

An NSViewAnimation object takes an array of dictionaries from which it determines the objects to animate and the effects to apply to them. Each dictionary must have a target object and, optionally, properties that specify beginning and ending frame and whether to fade in or fade out. (See View Animation Dictionary Keys for further information.) Animations with NSViewAnimation are, by default, in non-blocking mode over a duration of 0.5 seconds using the ease in-out animation curve. But you can configure the animation to have any duration, curve, frame rate, and blocking mode. You may also set progress marks, assign a delegate, and implement delegation methods in order to animate view and windows concurrent with the ones specified as targets in the view-animation dictionary.

Invoking the NSAnimation stop() method on a running NSViewAnimation object moves the animation to the end frame.

Symbols

Initializing an NSViewAnimation object

init(viewAnimations: [[String : Any]])

Returns an NSViewAnimation object initialized with the supplied information.

Getting and setting view-animation dictionaries

var viewAnimations: [[String : Any]]

The dictionaries defining the objects to animate.

Constants

View Animation Dictionary Keys

The following string constants are keys for the dictionaries in the array passed into init(viewAnimations:) and viewAnimations.

Values for NSViewAnimationEffectKey

The following constants specify the animation effect to apply and are used as values for the animation effect property of the animation view. See the description of NSViewAnimationEffectKey for usage details.

Relationships

Inherits From