CAPropertyAnimation Class Reference
Overview
CAPropertyAnimation
is an abstract subclass of CAAnimation
for creating animations that manipulate the value of layer properties. The property is specified using a key path that is relative to the layer using the animation.
Tasks
Animated Key Path
-
property
Property Value Calculation Behavior
-
property
-
property
-
property
Creating an Animation
Properties
additive
Determines if the value specified by the animation is added to the current render tree value to produce the new render tree value.
Discussion
If YES
, the value specified by the animation will be added to the current render tree value of the property to produce the new render tree value. The addition function is type-dependent, e.g. for affine transforms the two matrices are concatenated. The default is NO
.
Availability
- Available in iOS 2.0 and later.
Declared In
CAAnimation.h
cumulative
Determines if the value of the property is the value at the end of the previous repeat cycle, plus the value of the current repeat cycle.
Discussion
If YES
, then the value of the property is the value at the end of the previous repeat cycle, plus the value of the current repeat cycle. If NO
, the value of the property is simply the value calculated for the current repeat cycle. The default is NO
.
Availability
- Available in iOS 2.0 and later.
Declared In
CAAnimation.h
keyPath
Specifies the key path the receiver animates.
Discussion
The key path is relative to the layer the receiver is attached to.
Availability
- Available in iOS 2.0 and later.
Declared In
CAAnimation.h
valueFunction
An optional value function that is applied to interpolated values.
Discussion
If the valueFunction
property is not nil
, the function is applied to the values interpolated by the animation as they are applied to the presentation layer. Defaults to nil
.
Availability
- Available in iOS 3.0 and later.
Declared In
CAAnimation.h
Class Methods
animationWithKeyPath:
Creates and returns an CAPropertyAnimation
instance for the specified key path.
Parameters
- keyPath
-
The key path of the property to be animated.
Return Value
A new instance of CAPropertyAnimation
with the key path set to keyPath.
Availability
- Available in iOS 2.0 and later.
Declared In
CAAnimation.h