Core Animation Release Notes

@protocol CAMediaTiming

/* Deprecate kCAFillModeFrozen. Replace with: */

CA_EXTERN NSString * const kCAFillModeForwards;

CA_EXTERN NSString * const kCAFillModeBackwards;

CA_EXTERN NSString * const kCAFillModeBoth;

/* `forwards' is equivalent to existing `frozen', `backwards' clamps time

 * values before zero to zero, `both' clamps time values at both ends

 * of the object's time space. */

@end

@interface CAKeyframeAnimation

/* Defines whether objects animating along paths rotate to match the

 * path tangent. Possible values are `auto' and `autoReverse'. Defaults

 * to nil. The effect of setting this property to a non-nil value when

 * no path object is supplied is undefined. `autoReverse' rotates to

 * match the tangent plus 180 degrees. */

@property(copy) NSString *rotationMode;

CA_EXTERN NSString * const kCAAnimationRotateAuto;

CA_EXTERN NSString * const kCAAnimationRotateAutoReverse;

@end

@interface CATiledLayer

/* The time in seconds that newly added images take to "fade-in" to the

 * rendered representation of the tiled layer. The default implementation

 * returns 0.25 seconds. */

+ (CFTimeInterval)fadeDuration;

@end

@interface CALayer

/* Returns a copy of the layer containing all properties as they were

 * at the start of the current transaction, with any active animations

 * applied. This gives a close approximation to the version of the layer

 * that is currently displayed.

 *

 * The effect of attempting to modify the returned layer in any way is

 * undefined.

 *

 * The `sublayers', `mask' and `superlayer' properties of the returned

 * layer return the presentation versions of these properties. This

 * carries through to read-only layer methods. E.g., calling -hitTest:

 * on the result of the -presentationLayer will query the presentation

 * values of the layer tree. */

- (id)presentationLayer;

/* When called on the result of the -presentationLayer method, returns

 * the underlying layer with the current model values. The result of

 * calling this method after the transaction that produced the

 * presentation layer has completed is undefined. */

- (id)modelLayer;

/* This initializer is used to create shadow copies of layers, e.g.

 * for the -presentationLayer method. Subclasses can optionally copy

 * their instance variables into the new object. Subclasses should

 * always invoke the superclass implementation; calling this method in

 * any other situations will produce undefined behavior. */

- (id)initWithLayer:(id)layer;

/* Returns the animation added to the layer with identifier 'key', or nil

 * if no such animation exists. Attempting to modify any properties of

 * the returned object will result in undefined behavior. */

- (CAAnimation *)animationForKey:(NSString *)key;

/* A rectangle in the unit coordinate space defining the subrectangle

 * of the `contents' property that will be drawn into the layer. If

 * pixels outside the unit rectangles are requested, the edge pixels of

 * the contents image will be extended outwards. If an empty rectangle

 * is provided, the results are undefined. Defaults to the unit

 * rectangle [0 0 1 1]. Animatable. */

@property CGRect contentsRect;

/* A bitmask defining how the edges of the layer are rasterized. For

 * each of the four edges (left, right, bottom, top) if the

 * corresponding bit is set the edge will be antialiased. Typically

 * this property is used to disable antialiasing for edges that abut

 * edges of other layers, to eliminate the seams that would otherwise

 * occur. The default value is for all edges to be antialiased. */

enum CAEdgeAntialiasingMask

{

  kCALayerLeftEdge    = 1U << 0,

  kCALayerRightEdge    = 1U << 1,

  kCALayerBottomEdge    = 1U << 2,

  kCALayerTopEdge    = 1U << 3,

};

@property unsigned int edgeAntialiasingMask;

/** Layer `contentsGravity' values. **/

/* Similar to kCAGravityResizeAspect except that it resizes the contents

 * of the layer to fill the bounds (while preserving its aspect ratio.) */

CA_EXTERN NSString * const kCAGravityResizeAspectFill;

@end