Core Animation Reference
Search these docs to answer questions about Core Animation (the QuartzCore framework). Use this skill when working directly with CALayer, layer-backed UIKit/AppKit views, explicit keyframe or spring animations on layer properties, particle systems, or per-frame callbacks via CADisplayLink.
For SwiftUI's declarative animation API (withAnimation, Animation, .animation(_:value:), transitions), use guide-swiftui-animations instead. For SwiftUI immediate-mode drawing, use swiftui/canvas.md and swiftui/graphicscontext.md.
Return Format
Always include:
- Summary — answer the question concisely.
- File paths — list relevant files for full details, e.g.:
calayer.md for layer geometry, contents, hierarchycabasicanimation.md for animating a single property between two valuescatransaction.md for batching, disabling implicit animations, or changing default duration
Files
| File |
Content |
core-animation-index.md |
Full QuartzCore framework index — layer basics, animation classes, transactions, layer subclasses |
calayer.md |
CALayer — the root layer class: geometry, contents, hierarchy, layout, animations |
caanimation.md |
CAAnimation — abstract base class for all Core Animation animation types |
capropertyanimation.md |
CAPropertyAnimation — abstract subclass animating a single layer property |
cabasicanimation.md |
CABasicAnimation — interpolate a layer property between two values |
cakeyframeanimation.md |
CAKeyframeAnimation — animate a property through a sequence of keyframes |
caspringanimation.md |
CASpringAnimation — spring-based interpolation with mass, stiffness, damping |
caanimationgroup.md |
CAAnimationGroup — run multiple animations together with a shared duration |
catransition.md |
CATransition — fade, push, reveal, and move-in transitions between layer states |
camediatiming.md |
CAMediaTiming — protocol shared by layers and animations (beginTime, duration, repeat, speed) |
catransaction.md |
CATransaction — batch property changes, disable implicit animations, set default duration/timing |
catransform3d.md |
CATransform3D — 4×4 matrix used by CALayer.transform for 3D transforms |
cashapelayer.md |
CAShapeLayer — vector-shape layer driven by a CGPath (stroke, fill, line dash) |
cagradientlayer.md |
CAGradientLayer — axial, radial, and conic gradient layers |
caemitterlayer.md |
CAEmitterLayer — particle emitter layer (fire, smoke, confetti, sparkles) |
caemittercell.md |
CAEmitterCell — individual particle definition used by CAEmitterLayer |
careplicatorlayer.md |
CAReplicatorLayer — replicate a sublayer with offsets and transforms |
cametallayer.md |
CAMetalLayer — layer backed by a Metal drawable for GPU-rendered content |
catextlayer.md |
CATextLayer — layer that renders plain or attributed text |
catiledlayer.md |
CATiledLayer — tile-based asynchronous content rendering for large or zoomable layers |
cadisplaylink.md |
CADisplayLink — timer synchronized to the display's refresh rate |
When to Reach for Core Animation
- You need to animate a layer property SwiftUI/UIKit doesn't expose declaratively (e.g.,
CAGradientLayer.colors, CAShapeLayer.strokeEnd, CAEmitterLayer.birthRate).
- You need explicit keyframe or spring control with timing functions (
CAMediaTimingFunction) per segment.
- You want to batch implicit animations off (
CATransaction.setDisableActions(true)).
- You need a
CADisplayLink per-frame callback (custom drawing loops, scrubbing, physics).
- You're rendering thousands of particles with
CAEmitterLayer or replicating sublayers with CAReplicatorLayer.
If your problem fits inside withAnimation { ... } in SwiftUI or UIView.animate { ... } in UIKit, prefer those — Core Animation sits underneath both and is rarely the right starting point in 2026-era code.
Fetching More Docs
- Search this skill's local
.md files first.
- If the topic is not here, check the other installed Apple skills, then grep their local files.
- If no installed skill has the page, the QuartzCore path on Apple's site is
/documentation/quartzcore/<symbol> — fetch via the sosumi.ai Markdown mirror (e.g. https://sosumi.ai/documentation/quartzcore/camediatimingfunction) or by running pnpm fetch-doc against the apple-skills tooling.
1---2name: core-animation3description: API reference: Core Animation (QuartzCore). Query for CALayer, CAAnimation, CABasicAnimation, CAKeyframeAnimation, CASpringAnimation, CATransaction, CAShapeLayer, CAGradientLayer, CAEmitterLayer, CATransform3D, CADisplayLink.4---5
6# Core Animation Reference
7
8Search these docs to answer questions about Core Animation (the QuartzCore framework). Use this skill when working directly with `CALayer`, layer-backed UIKit/AppKit views, explicit keyframe or spring animations on layer properties, particle systems, or per-frame callbacks via `CADisplayLink`.
9
10For SwiftUI's declarative animation API (`withAnimation`, `Animation`, `.animation(_:value:)`, transitions), use `guide-swiftui-animations` instead. For SwiftUI immediate-mode drawing, use `swiftui/canvas.md` and `swiftui/graphicscontext.md`.
11
12## Return Format
13
14Always include:
151. **Summary** — answer the question concisely.
162. **File paths** — list relevant files for full details, e.g.:
17 - `calayer.md` for layer geometry, contents, hierarchy
18 - `cabasicanimation.md` for animating a single property between two values
19 - `catransaction.md` for batching, disabling implicit animations, or changing default duration
20
21## Files
22
23| File | Content |
24|------|---------|
25| `core-animation-index.md` | Full QuartzCore framework index — layer basics, animation classes, transactions, layer subclasses |
26| `calayer.md` | `CALayer` — the root layer class: geometry, contents, hierarchy, layout, animations |
27| `caanimation.md` | `CAAnimation` — abstract base class for all Core Animation animation types |
28| `capropertyanimation.md` | `CAPropertyAnimation` — abstract subclass animating a single layer property |
29| `cabasicanimation.md` | `CABasicAnimation` — interpolate a layer property between two values |
30| `cakeyframeanimation.md` | `CAKeyframeAnimation` — animate a property through a sequence of keyframes |
31| `caspringanimation.md` | `CASpringAnimation` — spring-based interpolation with mass, stiffness, damping |
32| `caanimationgroup.md` | `CAAnimationGroup` — run multiple animations together with a shared duration |
33| `catransition.md` | `CATransition` — fade, push, reveal, and move-in transitions between layer states |
34| `camediatiming.md` | `CAMediaTiming` — protocol shared by layers and animations (beginTime, duration, repeat, speed) |
35| `catransaction.md` | `CATransaction` — batch property changes, disable implicit animations, set default duration/timing |
36| `catransform3d.md` | `CATransform3D` — 4×4 matrix used by `CALayer.transform` for 3D transforms |
37| `cashapelayer.md` | `CAShapeLayer` — vector-shape layer driven by a `CGPath` (stroke, fill, line dash) |
38| `cagradientlayer.md` | `CAGradientLayer` — axial, radial, and conic gradient layers |
39| `caemitterlayer.md` | `CAEmitterLayer` — particle emitter layer (fire, smoke, confetti, sparkles) |
40| `caemittercell.md` | `CAEmitterCell` — individual particle definition used by `CAEmitterLayer` |
41| `careplicatorlayer.md` | `CAReplicatorLayer` — replicate a sublayer with offsets and transforms |
42| `cametallayer.md` | `CAMetalLayer` — layer backed by a Metal drawable for GPU-rendered content |
43| `catextlayer.md` | `CATextLayer` — layer that renders plain or attributed text |
44| `catiledlayer.md` | `CATiledLayer` — tile-based asynchronous content rendering for large or zoomable layers |
45| `cadisplaylink.md` | `CADisplayLink` — timer synchronized to the display's refresh rate |
46
47## When to Reach for Core Animation
48
49- You need to animate a layer property SwiftUI/UIKit doesn't expose declaratively (e.g., `CAGradientLayer.colors`, `CAShapeLayer.strokeEnd`, `CAEmitterLayer.birthRate`).
50- You need explicit keyframe or spring control with timing functions (`CAMediaTimingFunction`) per segment.
51- You want to batch implicit animations off (`CATransaction.setDisableActions(true)`).
52- You need a `CADisplayLink` per-frame callback (custom drawing loops, scrubbing, physics).
53- You're rendering thousands of particles with `CAEmitterLayer` or replicating sublayers with `CAReplicatorLayer`.
54
55If your problem fits inside `withAnimation { ... }` in SwiftUI or `UIView.animate { ... }` in UIKit, prefer those — Core Animation sits underneath both and is rarely the right starting point in 2026-era code.
56
57## Fetching More Docs
58
591. Search this skill's local `.md` files first.
602. If the topic is not here, check the other installed Apple skills, then grep their local files.
613. If no installed skill has the page, the QuartzCore path on Apple's site is `/documentation/quartzcore/<symbol>` — fetch via the `sosumi.ai` Markdown mirror (e.g. `https://sosumi.ai/documentation/quartzcore/camediatimingfunction`) or by running `pnpm fetch-doc` against the apple-skills tooling.
prisma-labs-dev