Creates a layer object that is associated with a graphics context.
SDKs
- iOS 2.0+
- macOS 10.4+
- Mac Catalyst 13.0+
- tvOS 9.0+
- watchOS 2.0+
Framework
- Core Graphics
Declaration
init?(_ context: CGContext, size: CGSize, auxiliaryInfo: CFDictionary?)
Parameters
contextThe graphics context you want to create the layer relative to. The layer uses this graphics context as a reference for initialization.
sizeThe size, in default user space units, of the layer relative to the graphics context.
auxiliaryInfoReserved for future use. Pass
NULL.
Return Value
A CGLayer object. You are responsible for releasing this object using the function CGLayer when you no longer need the layer.
Discussion
After you create a CGLayer object, you should reuse it whenever you can to facilitate the Core Graphics caching strategy. Core Graphics caches any objects that are reused, including CGLayer objects. Objects that are reused frequently remain in the cache. In contrast, objects that are used once in a while may be moved in and out of the cache according to their frequency of use. If you don’t reuse CGLayer objects, Core Graphics won’t cache them. This means that you lose an opportunity to improve the performance of your application.