This library provides run-time detection of the PPI (pixels per inch) resolution of the main display of an iOS device.
It is useful for applications that display content in true size, for example:
- 3-in-1 Ruler uses it to display an on-screen ruler.
- Print to Size uses it for its zoom indicator.
As Apple releases new iOS devices this library needs to be continously updated to add new devices to its built-in list. It cannot guarantee an accurate PPI value for new devices that it does not yet know, but in such cases it provides a "best guess" PPI based on heuristics (UIUserInterfaceIdiom
and UIScreen
values) and an error code which you can treat as a non-fatal error.
let ppi: Double = {
switch Ppi.get() {
case .success(let ppi):
return ppi
case .unknown(let bestGuessPpi, let error):
// A bestGuessPpi value is provided but may be incorrect
// Treat as a non-fatal error -- e.g. log to your backend and/or display a message
return bestGuessPpi
}
}()
iOS 8 or later.
Add a package dependency with this URL:
https://github.com/Clafou/DevicePpi
Alternatively, DevicePpi can be added to your project via CocoaPods.
pod 'DevicePpi'
Capacitor users can use this package on npm and GitHub
The list of devices and their PPI is updated as new models are announced. Currently, the following devices are included:
iPhone
- iPhone 4S
- iPhone 5
- iPhone 5C
- iPhone 5S
- iPhone 6
- iPhone 5 Plus
- iPhone 6S
- iPhone SE
- iPhone 7
- iPhone 7 Plus
- iPhone 8
- iPhone 8 Plus
- iPhone X
- iPhone XS
- iPhone XS Max
- iPhone XR
- iPhone 11
- iPhone 11 Pro
- iPhone 11 Pro Max
- iPhone SE (2nd generation)
- iPhone 12 mini
- iPhone 12
- iPhone 12 Pro
- iPhone 12 Pro Max
- iPhone 13 mini
- iPhone 13
- iPhone 13 Pro
- iPhone 13 Pro Max
- iPhone SE (3rd generation)
- iPhone 14
- iPhone 14 Plus
- iPhone 14 Pro
- iPhone 14 Pro Max
- iPhone 15
- iPhone 15 Plus
- iPhone 15 Pro
- iPhone 15 Pro Max
iPod touch
- iPod touch (5th generation)
- iPod touch (6th generation)
- iPod touch (7th generation)
iPad
- iPad 2
- iPad mini
- iPad (3rd generation)
- iPad (4th generation)
- iPad Air
- iPad mini 2
- iPad mini 3
- iPad Air 2
- iPad mini 4
- iPad Pro (9.7″)
- iPad Pro (12.9″)
- iPad (5th generation)
- iPad Pro (12.9″, 2nd generation)
- iPad Pro (10.5″)
- iPad (6th generation)
- iPad Pro (11″)
- iPad Pro (12.9″, 3rd generation)
- iPad Air (3rd generation)
- iPad mini (5th generation)
- iPad (7th generation)
- iPad Pro (11″, 2nd generation)
- iPad Pro (12.9″, 4th generation)
- iPad (8th generation)
- iPad Air (4th generation)
- iPad Pro (11″, 3rd generation)
- iPad Pro (12.9″, 5th generation)
- iPad (9th generation)
- iPad mini (6th generation)
- iPad Air (5th generation)
- iPad (10th generation)
- iPad Pro (11″, 4th generation)
- iPad Pro (12.9″, 6th generation)
- iPad Air 11-inch (M2)
- iPad Air 13-inch (M2)
- iPad Pro 11-inch (M4)
- iPad Pro 13-inch (M4)
Devices that are too old to support iOS 8 or later (this library's deployment target) are not included. These are: iPhone (original model), iPhone 3GS, iPhone 4, and the first, 2nd and 3rd generation of iPod touch.
Sébastien Molines
DevicePpi is available under the MIT license. See the LICENSE file for more info.