类方法
+ (instancetype)layer
便捷创建图层函数。
示例代码:
CALayer *layer = [CATextLayer layer];
+ (nullable id)defaultValueForKey:(NSString *)key
重写修改CALayer或其子类属性的默认值,key为属性名称,如果没有该属性则返回nil。
示例:
创建一个类XPQLayer继承自CALayer,重写defaultValueForKey:
+(id)defaultValueForKey:(NSString *)key {
if ([key isEqualToString:@"anchorPoint"]) {
// anchorPoint的原默认值为(0.5, 0.5)
return [NSValue valueWithCGPoint:CGPointMake(1.0, 1.0)];
}
else {
return [super defaultValueForKey:key];
}
}
然后创建一个XPQLayer的实例,获取anchorPoint的默认值
XPQLayer *layer = [XPQLayer layer];
NSLog(@"x:%f y:%f", layer.anchorPoint.x, layer.anchorPoint.y);
// 输出x:1.000000 y:1.000000
+ (BOOL)needsDisplayForKey:(NSString *)key
需要子类重写,当CALayer或其子类属性被修改时调用此方法。key为修改的属性名,当返回值为YES时系统自动调用-display 方法。
示例:
创建一个类继承自CALayer,重写needsDisplayForKey:和-display
+ (BOOL)needsDisplayForKey:(NSString *)key
{
if ([@"time" isEqualToString:key])
{
return YES;
}
return [super needsDisplayForKey:key];
}
- (void)display
{
NSLog(@"time: %f", self.time);
}
这段代码的作用是无论何时 time 属性被修改,它都需要调用 -display 方法。在 -display 方法打印出 time 的值。
+ (nullable id< CAAction >)defaultActionForKey:(NSString *)event
返回当前类的默认操作。
实例方法
- (instancetype)init
初始化。
- (instancetype)initWithLayer:(id)layer
复制一个图层。
- (nullable id)presentationLayer
返回当前呈现层的副本。
- (id)modelLayer
返回模型层。
如果是-presentationLayer返回的呈现层调用则返回所依赖的CALayer;
如果不是-presentationLayer返回的层调用则返回self。
Layer也和View一样存在着一个层级树状结构,称之为图层树(Layer Tree),直接创建的或者通过UIView获得的(view.layer)用于显示的图层树,称之为模型树(Model Tree),模型树的背后还存在两份图层树的拷贝,一个是呈现树(Presentation Tree),一个是渲染树(Render Tree). 呈现树可以通过普通layer(其实就是模型树)的layer.presentationLayer获得,而模型树则可以通过modelLayer属性获得(详情文档).模型树的属性在其被修改的时候就变成了新的值,这个是可以用代码直接操控的部分;呈现树的属性值和动画运行过程中界面上看到的是一致的.而渲染树是私有的,你无法访问到,渲染树是对呈现树的数据进行渲染,为了不阻塞主线程,渲染的过程是在单独的进程或线程中进行的,所以你会发现Animation的动画并不会阻塞主线程.
呈现树通过图层树中所有图层的呈现图层所形成。注意呈现图层仅仅当图层首次被提交(就是首次第一次在屏幕上显示)的时候创建,所以在那之前调用-presentationLayer将会返回nil。
示例:
为图层添加一个动画
// 设置隐式动画时长
[CATransaction setAnimationDuration:3.0];
_subLayer.position = CGPointMake(200.0, 150.0);
打印图层的值
NSLog(@"Layer x:%f", _subLayer.position.x);
// 获取呈现层
CALayer *preLayer = [_subLayer presentationLayer];
NSLog(@"presentationLayer x:%f", preLayer.position.x);
// 获取呈现层的依赖层
CALayer *modelLayer = [preLayer modelLayer];
NSLog(@"modelLayer x:%f", modelLayer.position.x);
效果图
- (BOOL)shouldArchiveValueForKey:(NSString *)key
指示指定键的值是否应该归档。
- (CGAffineTransform)affineTransform
返回仿射变换值。
- (void)setAffineTransform:(CGAffineTransform)m
设置仿射变换值。
- (BOOL)contentsAreFlipped
返回一个布尔值,指示是否在呈现的图层内容隐含翻转。
如果这些层的内容被隐式翻转时返回YES;否则返回NO。默认返回NO。
- (void)removeFromSuperlayer
从父图层移除或者从mask属性上移除。
- (void)addSublayer:(CALayer*)layer
添加一个子图层。
- (void)insertSublayer:(CALayer*)layer atIndex:(unsigned)idx
将layer插入到subLayer的指定索引idx位置。
- (void)insertSublayer:(CALayer*)layer below:(nullable CALayer*)sibling
将layer插入到sibling下面。
- (void)insertSublayer:(CALayer*)layer above:(nullable CALayer*)sibling
将layer插入到sibling上面
- (void)replaceSublayer:(CALayer*)layer with:(CALayer*)layer2
把layer替换成layer2。
如果layer2为nil则只做删除layer操作。
如果layer不是子图层则不做任何操作。
- (CGPoint)convertPoint:(CGPoint)p fromLayer:(nullable CALayer *)l
- (CGPoint)convertPoint:(CGPoint)p toLayer:(nullable CALayer *)l
转换坐标点。
- (CGRect)convertRect:(CGRect)r fromLayer:(nullable CALayer *)l
- (CGRect)convertRect:(CGRect)r toLayer:(nullable CALayer *)l
转换矩形
- (CFTimeInterval)convertTime:(CFTimeInterval)t fromLayer:(nullable CALayer *)l
- (CFTimeInterval)convertTime:(CFTimeInterval)t toLayer:(nullable CALayer *)l
转换CAMediaTiming协议的相对时间。
- (nullable CALayer *)hitTest:(CGPoint)p
返回点所在的最上层的图层。
- (BOOL)containsPoint:(CGPoint)p
判断点是否在图层范围内。
- (void)display
重新加载该层的内容。
不要直接调用此方法。layer会自动在适当的适合调用此方法。
子类可以覆盖此方法,并用它来修改图层。
- (void)setNeedsDisplay
- (void)setNeedsDisplayInRect:(CGRect)r
标记图层的内容为需要更新。
调用此方法将导致重新缓存内容层。
- (BOOL)needsDisplay
返回是否需要更新标志。
- (void)displayIfNeeded
调用此方法会进行额外的更新,一般不需要使用此方法。
- (void)drawInContext:(CGContextRef)ctx
使用指定的图形上下文绘制图层的内容。
- (void)renderInContext:(CGContextRef)ctx
将各层呈现到指定的上下文。
- (CGSize)preferredFrameSize
返回首选的帧大小。
- (void)setNeedsLayout
使层布局无效,并标记需要更新。
可以调用此方法以指示子图层的布局发生了变化,必须进行更新。
子图层的添加或删除会自动调用此方法。
- (BOOL)needsLayout
返回是否需要布局更新标志。
- (void)layoutIfNeeded
如果需要,重新计算布局。
- (void)layoutSublayers
告知子图层需要更新布局。
- (nullable id< CAAction>)actionForKey:(NSString *)event
- (void)addAnimation:(CAAnimation*)anim forKey:(nullable NSString *)key
将指定动画对象添加到渲染树上。
动画对象添加到渲染树上是复制而不是增加引用计数。所以添加有修改动画对象不会影响渲染结果。
key用于来标识动画,可以设置为nil。如果设置成kCATransition
则自动用于过渡动画。
- (void)removeAllAnimations
移除该图层上的所有动画。
- (void)removeAnimationForKey:(NSString *)key
移除指定key对应的动画。
- (nullable NSArray< NSString*> *)animationKeys
获取当前图层所有动画的key。
- (nullable CAAnimation*)animationForKey:(NSString *)key
返回与key对应的动画对象,如果没有则返回nil。
CALayerDelegate
- (void)displayLayer:(CALayer *)layer
更新图层时回调。
- (void)drawLayer:(CALayer *)layer inContext:(CGContextRef)ctx
绘制图层时回调。
- (void)layoutSublayersOfLayer:(CALayer *)layer
子图层布局时回调。
- (nullable id< CAAction>)actionForLayer:(CALayer*)layer forKey:(NSString *)event
执行指定操作是回调。