How to add a UIImage to a CALayer

You can add an image to a view’s layer simply by using its contents property:

myView.layer.contents = UIImage(named: "star")?.CGImage

Note that the UIImage needs to be converted to a CGImage.

If you wish to add the image in its own layer, you can do it like this:

let myLayer = CALayer()
let myImage = UIImage(named: "star")?.CGImage
myLayer.frame = myView.bounds
myLayer.contents = myImage
myView.layer.addSublayer(myLayer)

Modifying the appearance

The above code produces a view like this. The light blue is the UIView and the dark blue star is the UIImage.

As you can see, though, it looks pixelated. This is because the UIImage is smaller than the UIView so it is being scaled to fill the view, which is the default it you don’t specify anything else.

The examples below show variations on the layer’s contentsGravity property. The code looks like this:

myView.layer.contents = UIImage(named: "star")?.CGImage
myView.layer.contentsGravity = kCAGravityTop
myView.layer.geometryFlipped = true

In iOS, you may want to set the geometryFlipped property to true if you are doing anything with top or bottom gravity, otherwise it will be the opposite of what you expect. (Only the gravity is flipped vertically, not the content rendering. If you are having trouble with the content being flipped, see this Stack Overflow answer.)

There are two UIView examples below for every contentsGravity setting, one view is larger than the UIImage and the other is smaller. This way you can see the effects of the scaling and gravity.

kCAGravityResize

This is the default.

kCAGravityResizeAspect

kCAGravityResizeAspectFill

kCAGravityCenter

kCAGravityTop

kCAGravityBottom

kCAGravityLeft

kCAGravityRight

kCAGravityTopLeft

kCAGravityTopRight

kCAGravityBottomLeft

kCAGravityBottomRight

Notes

This example comes originally from this Stack Overflow answer.

Found a mistake? Have a question or improvement idea? Let me know.

CALayer:

* Adding Transforms to a CALayer translate rotate scale

* Shadows

* Emitter View with custom image

* Creating particles with CAEmitterLayer

* How to add a UIImage to a CALayer

* Disable Animations

* Rounded corners

* Creating a CALayer

Table Of Contents

0 Getting started with iOS

1 UILabel

2 Change Status Bar Color

3 Passing Data between View Controllers

4 Managing the Keyboard

5 UIButton

6 UILocalNotification

7 UIImageView

8 Checking for Network Connectivity

9 Accessibility

10 UITableView

11 Auto Layout

12 UIView

13 UIAlertController

14 MKMapView

15 UIColor

16 NSAttributedString

17 CAAnimation

18 UITextView

19 UINavigationController

20 Concurrency

21 CAGradientLayer

22 UIGestureRecognizer

23 Custom UIViews from XIB files

24 Safari Services

25 UIStackView

26 UIImage

27 UIWebView

28 CALayer

29 Swift and Objective-C interoperability

30 NSDate

31 Custom Fonts

32 AVSpeechSynthesizer

33 UIBarButtonItem

34 UIScrollView

35 Localization

36 NSNotificationCenter

37 UITextField

38 Networking with Alamofire

39 UIViewController

40 iBeacon

41 CLLocation

42 NSURLSession

43 UISwitch

44 Checking iOS version

45 Universal Links

46 UICollectionView

47 PDF Creation

48 In-App Purchase

49 NSTimer

50 CGContext

51 UITabBarController

52 UISearchController

53 UIActivityViewController

54 Core Location

55 FacebookSDK

56 AFNetworking

57 CTCallCenter

58 UIImagePickerController

59 NSUserDefaults

60 UIControl - Event Handling with Blocks

61 UIBezierPath

62 UIPageViewController

63 UIAppearance

64 Push Notifications

65 Key Value Coding

66 Initialization idioms

67 Storyboard

68 Background Modes and Events

69 Fastlane

70 CAShapeLayer

71 WKWebView

72 UUID Universally Unique Identifier

73 Categories

74 Handling URL Schemes

75 Realm database

76 ARC Automatic Reference Counting

77 UIPickerView

78 Dynamic Type

79 NSURL

80 SWRevealViewController

81 Snapshot of UIView

82 DispatchGroup

83 GCD Grand Central Dispatch

84 Size Classes and Adaptivity

85 UIScrollView, AutoLayout

86 IBOutlets

87 AWS SDK

88 Debugging Crashes

89 UISplitViewController

90 UISplitViewController

91 UIDevice

92 CloudKit

93 GameplayKit

94 XCode Build Archive From Command Line

95 Unit Testing with XCTest

96 NSData

97 AVPlayer and AVPlayerViewController

98 Deep Linking

99 App Transport Security (ATS)

100 Core Graphics

101 Segues

102 UIDatePicker

103 NSPredicate

104 EventKit

105 NSBundle

106 SiriKit

107 Contacts Framework

108 Dynamically updating a UIStackView

109 Speech Recognition

110 NSURLConnection

111 StoreKit

112 Code signing

113 .ipa file to upload on appstore with ApplicationLoader

114 Resizing UIImage

115 Size Classes and Adaptivity

116 MKDistanceFormatter

117 3D Touch

118 GameCenter Leaderboards

119 Keychain

120 Handle Multiple Environment using Macro

121 Set View Background

122 Block

123 Content Hugging

124 Google Places API

125 Navigation Bar

126 UITextField Delegate

127 App-wide operations

128 UILabel text underlining

129 Cut a UIImage into a circle

130 Make selective UIView corners rounded

131 Convert HTML to NSAttributed string and vice versa

132 Convert NSAttributedString to UIImage

133 CoreImage Filters

134 Face Detection Using CoreImageOpenCV

135 MPMediaPickerDelegate

136 Graph Coreplot

137 NSHTTPCookieStorage

138 FCM Messaging

139 Create Custom Framework

140 Custom Keyboard

141 AirDrop

142 SLComposeViewController

143 AirPrint tutorial

144 UISlider

145 Carthage

146 HealthKit

147 Core SpotLight

148 UI Testing

149 Core Motion

150 QR Code Scanner

151 plist

152 NSInvocation

153 UIRefreshControl TableView

154 WCSessionDelegate

155 AppDelegate

156 App Submission Process

157 MVVM

158 UIStoryboard

159 Basic text file I/O

160 Text To Speech (TTS)

161 MPVolumeView

162 Objective-C Associated Objects

163 Passing Data between View Controllers

164 UIPhoenix

165 Blocks in Queue with MKBlockQueue

166 Simulator

167 BackgroundModes

168 NSArray

169 OpenGL

170 UIScrollView with StackView child

171 Cache online images

172 MVP Architecture

173 UIKit Dynamics

174 Configure Beacons with CoreBluetooth

175 Core Data

176 Extension for rich Push Notification

177 Profiling with Instruments

178 Application rating review request

179 MyLayout

180 UIFont

181 Simulator Builds

182 Simulating Location Using GPX files

183 Custom methods of selection of UITableViewCells

184 Custom methods of selection of UITableViewCells

185 UISegmentedControl

186 SqlCipher integration

187 Custom UITextField

188 Custom UITextField

189 Security

190 Guideline to architecture patterns

191 UIFeedbackGenerator

192 UIKit Dynamics with UICollectionView

193 Multicast Delegates

194 Using image assets

195 UITableViewCell

196 Runtime in Objective-C

197 ModelPresentationStyles

198 CydiaSubstrate tweak

199 Create a video from images

200 Codable

201 FileHandle

202 NSUserActivity

203 Rich Notifications

204 Load images async

205 Adding Swift bridging header

206 Creating an App ID

207 Changing the rootview controller

208 Attributed text in UILabel

209 UITableViewController

210 Contributors

How to add a UIImage to a CALayer

Modifying the appearance

Related

Notes