CAReplicatorLayer Class Reference

Inherits from
CALayer : NSObject
Conforms to
NSCoding (CALayer)
CAMediaTiming (CALayer)
NSObject (NSObject)
Framework
/System/Library/Frameworks/QuartzCore.framework
Availability
Available in OS X v10.6 and later.
Declared in
CAReplicatorLayer.h
Companion guides
Core Animation Programming Guide
Core Animation Cookbook
Related sample code

Overview

The CAReplicatorLayer class creates a specified number of copies of its sublayers (the source layer), each copy potentially having geometric, temporal and color transformations applied to it.

Tasks

Setting Instance Display Properties

Modifying Instance Layer Geometry

Accessing Instance Color Values

Properties

instanceAlphaOffset

Defines the offset added to the alpha component of the color for each replicated instance. Animatable.

@property float instanceAlphaOffset
Discussion

The instanceAlphaOffset is added to the alpha color component of instance k-1 to produce the modulation color of instance k.

Default is 0.0.

Availability
  • Available in OS X v10.6 and later.
Declared In
CAReplicatorLayer.h

instanceBlueOffset

Defines the offset added to the blue component of the color for each replicated instance. Animatable.

@property float instanceBlueOffset
Discussion

The instanceBlueOffset is added to the blue color component of instance k-1 to produce the modulation color of instance k.

Default is 0.0.

Availability
  • Available in OS X v10.6 and later.
Related Sample Code
Declared In
CAReplicatorLayer.h

instanceColor

Defines the color used to multiply the source object. Animatable.

@property CGColorRef instanceColor
Discussion

Defaults to opaque white.

Availability
  • Available in OS X v10.6 and later.
Related Sample Code
Declared In
CAReplicatorLayer.h

instanceCount

The number of copies to create, including the source layers.

@property NSInteger instanceCount
Discussion

Default value is 1, no extra copies are created.

Availability
  • Available in OS X v10.6 and later.
Related Sample Code
Declared In
CAReplicatorLayer.h

instanceDelay

Specifies the delay, in seconds, between replicated copies. Animatable.

@property CFTimeInterval instanceDelay
Discussion

Default is 0.0.

Availability
  • Available in OS X v10.6 and later.
Related Sample Code
Declared In
CAReplicatorLayer.h

instanceGreenOffset

Defines the offset added to the green component of the color for each replicated instance. Animatable.

@property float instanceGreenOffset
Discussion

The instanceGreenOffset is added to the green color component of instance k-1 to produce the modulation color of instance k.

Default is 0.0.

Availability
  • Available in OS X v10.6 and later.
Related Sample Code
Declared In
CAReplicatorLayer.h

instanceRedOffset

Defines the offset added to the red component of the color for each replicated instance. Animatable.

@property float instanceRedOffset
Discussion

The instanceRedOffset is added to the red color component of instance k-1 to produce the modulation color of instance k.

Default is 0.0.

Availability
  • Available in OS X v10.6 and later.
Related Sample Code
Declared In
CAReplicatorLayer.h

instanceTransform

The transform matrix applied to the previous instance to produce the current instance. Animatable.

@property CATransform3D instanceTransform
Discussion

This transform matrix is applied to instance k-1 to produce instance k. The matrix is applied relative to the center of this layer.

Defaults to the identity matrix.

Availability
  • Available in OS X v10.6 and later.
Related Sample Code
Declared In
CAReplicatorLayer.h

preservesDepth

Defines whether this layer flattens its sublayers into its plane.

@property BOOL preservesDepth
Discussion

If YES, the layer acts similarly to the CATransformLayer and has the same restrictions.

Default is NO.

Availability
  • Available in OS X v10.6 and later.
Related Sample Code
Declared In
CAReplicatorLayer.h


© 2009 Apple Inc. All Rights Reserved. (Last updated: 2009-03-10)

Did this document help you? Yes It's good, but... Not helpful...