react-native-pdf-sdk 0.0.0-stage → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (178) hide show
  1. package/CHANGELOG.md +16 -0
  2. package/LICENSE +21 -0
  3. package/PdfSdk.podspec +32 -0
  4. package/README.md +265 -2
  5. package/android/CMakeLists.txt +24 -0
  6. package/android/build.gradle +132 -0
  7. package/android/gradle.properties +4 -0
  8. package/android/src/main/AndroidManifest.xml +1 -0
  9. package/android/src/main/cpp/cpp-adapter.cpp +9 -0
  10. package/android/src/main/java/com/margelo/nitro/pdfsdk/HybridPdfDocument.kt +72 -0
  11. package/android/src/main/java/com/margelo/nitro/pdfsdk/HybridPdfSdk.kt +17 -0
  12. package/android/src/main/java/com/margelo/nitro/pdfsdk/HybridPdfView.kt +194 -0
  13. package/android/src/main/java/com/margelo/nitro/pdfsdk/PdfDocumentLayout.kt +109 -0
  14. package/android/src/main/java/com/margelo/nitro/pdfsdk/PdfFailure.kt +36 -0
  15. package/android/src/main/java/com/margelo/nitro/pdfsdk/PdfPageSource.kt +141 -0
  16. package/android/src/main/java/com/margelo/nitro/pdfsdk/PdfSdkPackage.kt +35 -0
  17. package/android/src/main/java/com/margelo/nitro/pdfsdk/PdfSourceLoader.kt +117 -0
  18. package/android/src/main/java/com/margelo/nitro/pdfsdk/PdfSurface.kt +839 -0
  19. package/android/src/main/java/com/margelo/nitro/pdfsdk/PdfTileStore.kt +210 -0
  20. package/android/src/main/java/com/margelo/nitro/pdfsdk/PdfViewport.kt +255 -0
  21. package/android/src/main/java/com/margelo/nitro/pdfsdk/TileGrid.kt +276 -0
  22. package/ios/HybridPdfDocument.swift +71 -0
  23. package/ios/HybridPdfSdk.swift +10 -0
  24. package/ios/HybridPdfView.swift +202 -0
  25. package/ios/PdfDocumentLayout.swift +174 -0
  26. package/ios/PdfFailure.swift +46 -0
  27. package/ios/PdfImageCache.swift +83 -0
  28. package/ios/PdfPageSource.swift +221 -0
  29. package/ios/PdfScrollPlan.swift +108 -0
  30. package/ios/PdfSourceLoader.swift +120 -0
  31. package/ios/PdfSurface.swift +711 -0
  32. package/ios/PdfTileCanvas.swift +148 -0
  33. package/ios/PdfTileGrid.swift +518 -0
  34. package/ios/PdfTileStore.swift +346 -0
  35. package/ios/PdfViewport.swift +200 -0
  36. package/lib/commonjs/PdfView.js +149 -0
  37. package/lib/commonjs/PdfView.js.map +1 -0
  38. package/lib/commonjs/document.js +38 -0
  39. package/lib/commonjs/document.js.map +1 -0
  40. package/lib/commonjs/index.js +26 -0
  41. package/lib/commonjs/index.js.map +1 -0
  42. package/lib/commonjs/package.json +1 -0
  43. package/lib/commonjs/specs/PdfSdk.nitro.js +6 -0
  44. package/lib/commonjs/specs/PdfSdk.nitro.js.map +1 -0
  45. package/lib/commonjs/specs/PdfView.nitro.js +6 -0
  46. package/lib/commonjs/specs/PdfView.nitro.js.map +1 -0
  47. package/lib/module/PdfView.js +143 -0
  48. package/lib/module/PdfView.js.map +1 -0
  49. package/lib/module/document.js +34 -0
  50. package/lib/module/document.js.map +1 -0
  51. package/lib/module/index.js +5 -0
  52. package/lib/module/index.js.map +1 -0
  53. package/lib/module/specs/PdfSdk.nitro.js +4 -0
  54. package/lib/module/specs/PdfSdk.nitro.js.map +1 -0
  55. package/lib/module/specs/PdfView.nitro.js +4 -0
  56. package/lib/module/specs/PdfView.nitro.js.map +1 -0
  57. package/lib/typescript/src/PdfView.d.ts +65 -0
  58. package/lib/typescript/src/PdfView.d.ts.map +1 -0
  59. package/lib/typescript/src/document.d.ts +22 -0
  60. package/lib/typescript/src/document.d.ts.map +1 -0
  61. package/lib/typescript/src/index.d.ts +6 -0
  62. package/lib/typescript/src/index.d.ts.map +1 -0
  63. package/lib/typescript/src/specs/PdfSdk.nitro.d.ts +60 -0
  64. package/lib/typescript/src/specs/PdfSdk.nitro.d.ts.map +1 -0
  65. package/lib/typescript/src/specs/PdfView.nitro.d.ts +131 -0
  66. package/lib/typescript/src/specs/PdfView.nitro.d.ts.map +1 -0
  67. package/nitro.json +40 -0
  68. package/nitrogen/generated/.gitattributes +1 -0
  69. package/nitrogen/generated/android/PdfSdk+autolinking.cmake +87 -0
  70. package/nitrogen/generated/android/PdfSdk+autolinking.gradle +27 -0
  71. package/nitrogen/generated/android/PdfSdkOnLoad.cpp +84 -0
  72. package/nitrogen/generated/android/PdfSdkOnLoad.hpp +34 -0
  73. package/nitrogen/generated/android/c++/JFunc_void_PdfErrorEvent.hpp +80 -0
  74. package/nitrogen/generated/android/c++/JFunc_void_PdfLoadEvent.hpp +77 -0
  75. package/nitrogen/generated/android/c++/JFunc_void_PdfPageEvent.hpp +77 -0
  76. package/nitrogen/generated/android/c++/JFunc_void_PdfTapEvent.hpp +77 -0
  77. package/nitrogen/generated/android/c++/JFunc_void_PdfZoomEvent.hpp +77 -0
  78. package/nitrogen/generated/android/c++/JHybridNativePdfViewSpec.cpp +266 -0
  79. package/nitrogen/generated/android/c++/JHybridNativePdfViewSpec.hpp +92 -0
  80. package/nitrogen/generated/android/c++/JHybridPdfDocumentSpec.cpp +87 -0
  81. package/nitrogen/generated/android/c++/JHybridPdfDocumentSpec.hpp +65 -0
  82. package/nitrogen/generated/android/c++/JHybridPdfSdkSpec.cpp +58 -0
  83. package/nitrogen/generated/android/c++/JHybridPdfSdkSpec.hpp +63 -0
  84. package/nitrogen/generated/android/c++/JPdfErrorCode.hpp +67 -0
  85. package/nitrogen/generated/android/c++/JPdfErrorEvent.hpp +63 -0
  86. package/nitrogen/generated/android/c++/JPdfFit.hpp +64 -0
  87. package/nitrogen/generated/android/c++/JPdfLoadEvent.hpp +65 -0
  88. package/nitrogen/generated/android/c++/JPdfPageEvent.hpp +61 -0
  89. package/nitrogen/generated/android/c++/JPdfPageSize.hpp +61 -0
  90. package/nitrogen/generated/android/c++/JPdfRenderRequest.hpp +86 -0
  91. package/nitrogen/generated/android/c++/JPdfTapEvent.hpp +65 -0
  92. package/nitrogen/generated/android/c++/JPdfViewSource.hpp +84 -0
  93. package/nitrogen/generated/android/c++/JPdfZoomEvent.hpp +61 -0
  94. package/nitrogen/generated/android/c++/views/JHybridNativePdfViewStateUpdater.cpp +108 -0
  95. package/nitrogen/generated/android/c++/views/JHybridNativePdfViewStateUpdater.hpp +49 -0
  96. package/nitrogen/generated/android/kotlin/com/margelo/nitro/pdfsdk/Func_void_PdfErrorEvent.kt +80 -0
  97. package/nitrogen/generated/android/kotlin/com/margelo/nitro/pdfsdk/Func_void_PdfLoadEvent.kt +80 -0
  98. package/nitrogen/generated/android/kotlin/com/margelo/nitro/pdfsdk/Func_void_PdfPageEvent.kt +80 -0
  99. package/nitrogen/generated/android/kotlin/com/margelo/nitro/pdfsdk/Func_void_PdfTapEvent.kt +80 -0
  100. package/nitrogen/generated/android/kotlin/com/margelo/nitro/pdfsdk/Func_void_PdfZoomEvent.kt +80 -0
  101. package/nitrogen/generated/android/kotlin/com/margelo/nitro/pdfsdk/HybridNativePdfViewSpec.kt +185 -0
  102. package/nitrogen/generated/android/kotlin/com/margelo/nitro/pdfsdk/HybridPdfDocumentSpec.kt +65 -0
  103. package/nitrogen/generated/android/kotlin/com/margelo/nitro/pdfsdk/HybridPdfSdkSpec.kt +54 -0
  104. package/nitrogen/generated/android/kotlin/com/margelo/nitro/pdfsdk/PdfErrorCode.kt +26 -0
  105. package/nitrogen/generated/android/kotlin/com/margelo/nitro/pdfsdk/PdfErrorEvent.kt +56 -0
  106. package/nitrogen/generated/android/kotlin/com/margelo/nitro/pdfsdk/PdfFit.kt +25 -0
  107. package/nitrogen/generated/android/kotlin/com/margelo/nitro/pdfsdk/PdfLoadEvent.kt +61 -0
  108. package/nitrogen/generated/android/kotlin/com/margelo/nitro/pdfsdk/PdfPageEvent.kt +56 -0
  109. package/nitrogen/generated/android/kotlin/com/margelo/nitro/pdfsdk/PdfPageSize.kt +56 -0
  110. package/nitrogen/generated/android/kotlin/com/margelo/nitro/pdfsdk/PdfRenderRequest.kt +86 -0
  111. package/nitrogen/generated/android/kotlin/com/margelo/nitro/pdfsdk/PdfSdkOnLoad.kt +35 -0
  112. package/nitrogen/generated/android/kotlin/com/margelo/nitro/pdfsdk/PdfTapEvent.kt +61 -0
  113. package/nitrogen/generated/android/kotlin/com/margelo/nitro/pdfsdk/PdfViewSource.kt +66 -0
  114. package/nitrogen/generated/android/kotlin/com/margelo/nitro/pdfsdk/PdfZoomEvent.kt +56 -0
  115. package/nitrogen/generated/android/kotlin/com/margelo/nitro/pdfsdk/views/HybridNativePdfViewManager.kt +80 -0
  116. package/nitrogen/generated/android/kotlin/com/margelo/nitro/pdfsdk/views/HybridNativePdfViewStateUpdater.kt +23 -0
  117. package/nitrogen/generated/ios/PdfSdk+autolinking.rb +62 -0
  118. package/nitrogen/generated/ios/PdfSdk-Swift-Cxx-Bridge.cpp +123 -0
  119. package/nitrogen/generated/ios/PdfSdk-Swift-Cxx-Bridge.hpp +474 -0
  120. package/nitrogen/generated/ios/PdfSdk-Swift-Cxx-Umbrella.hpp +88 -0
  121. package/nitrogen/generated/ios/PdfSdkAutolinking.mm +41 -0
  122. package/nitrogen/generated/ios/PdfSdkAutolinking.swift +38 -0
  123. package/nitrogen/generated/ios/c++/HybridNativePdfViewSpecSwift.cpp +11 -0
  124. package/nitrogen/generated/ios/c++/HybridNativePdfViewSpecSwift.hpp +209 -0
  125. package/nitrogen/generated/ios/c++/HybridPdfDocumentSpecSwift.cpp +11 -0
  126. package/nitrogen/generated/ios/c++/HybridPdfDocumentSpecSwift.hpp +105 -0
  127. package/nitrogen/generated/ios/c++/HybridPdfSdkSpecSwift.cpp +11 -0
  128. package/nitrogen/generated/ios/c++/HybridPdfSdkSpecSwift.hpp +86 -0
  129. package/nitrogen/generated/ios/c++/views/HybridNativePdfViewComponent.mm +187 -0
  130. package/nitrogen/generated/ios/swift/Func_void_PdfErrorEvent.swift +46 -0
  131. package/nitrogen/generated/ios/swift/Func_void_PdfLoadEvent.swift +46 -0
  132. package/nitrogen/generated/ios/swift/Func_void_PdfPageEvent.swift +46 -0
  133. package/nitrogen/generated/ios/swift/Func_void_PdfTapEvent.swift +46 -0
  134. package/nitrogen/generated/ios/swift/Func_void_PdfZoomEvent.swift +46 -0
  135. package/nitrogen/generated/ios/swift/Func_void_std__exception_ptr.swift +46 -0
  136. package/nitrogen/generated/ios/swift/Func_void_std__string.swift +46 -0
  137. package/nitrogen/generated/ios/swift/HybridNativePdfViewSpec.swift +70 -0
  138. package/nitrogen/generated/ios/swift/HybridNativePdfViewSpec_cxx.swift +438 -0
  139. package/nitrogen/generated/ios/swift/HybridPdfDocumentSpec.swift +57 -0
  140. package/nitrogen/generated/ios/swift/HybridPdfDocumentSpec_cxx.swift +173 -0
  141. package/nitrogen/generated/ios/swift/HybridPdfSdkSpec.swift +55 -0
  142. package/nitrogen/generated/ios/swift/HybridPdfSdkSpec_cxx.swift +148 -0
  143. package/nitrogen/generated/ios/swift/PdfErrorCode.swift +52 -0
  144. package/nitrogen/generated/ios/swift/PdfErrorEvent.swift +34 -0
  145. package/nitrogen/generated/ios/swift/PdfFit.swift +48 -0
  146. package/nitrogen/generated/ios/swift/PdfLoadEvent.swift +39 -0
  147. package/nitrogen/generated/ios/swift/PdfPageEvent.swift +34 -0
  148. package/nitrogen/generated/ios/swift/PdfPageSize.swift +34 -0
  149. package/nitrogen/generated/ios/swift/PdfRenderRequest.swift +129 -0
  150. package/nitrogen/generated/ios/swift/PdfTapEvent.swift +39 -0
  151. package/nitrogen/generated/ios/swift/PdfViewSource.swift +97 -0
  152. package/nitrogen/generated/ios/swift/PdfZoomEvent.swift +34 -0
  153. package/nitrogen/generated/shared/c++/HybridNativePdfViewSpec.cpp +51 -0
  154. package/nitrogen/generated/shared/c++/HybridNativePdfViewSpec.hpp +112 -0
  155. package/nitrogen/generated/shared/c++/HybridPdfDocumentSpec.cpp +24 -0
  156. package/nitrogen/generated/shared/c++/HybridPdfDocumentSpec.hpp +70 -0
  157. package/nitrogen/generated/shared/c++/HybridPdfSdkSpec.cpp +21 -0
  158. package/nitrogen/generated/shared/c++/HybridPdfSdkSpec.hpp +66 -0
  159. package/nitrogen/generated/shared/c++/PdfErrorCode.hpp +88 -0
  160. package/nitrogen/generated/shared/c++/PdfErrorEvent.hpp +89 -0
  161. package/nitrogen/generated/shared/c++/PdfFit.hpp +84 -0
  162. package/nitrogen/generated/shared/c++/PdfLoadEvent.hpp +91 -0
  163. package/nitrogen/generated/shared/c++/PdfPageEvent.hpp +87 -0
  164. package/nitrogen/generated/shared/c++/PdfPageSize.hpp +87 -0
  165. package/nitrogen/generated/shared/c++/PdfRenderRequest.hpp +112 -0
  166. package/nitrogen/generated/shared/c++/PdfTapEvent.hpp +91 -0
  167. package/nitrogen/generated/shared/c++/PdfViewSource.hpp +97 -0
  168. package/nitrogen/generated/shared/c++/PdfZoomEvent.hpp +87 -0
  169. package/nitrogen/generated/shared/c++/views/HybridNativePdfViewComponent.cpp +226 -0
  170. package/nitrogen/generated/shared/c++/views/HybridNativePdfViewComponent.hpp +130 -0
  171. package/nitrogen/generated/shared/json/NativePdfViewConfig.json +23 -0
  172. package/package.json +80 -4
  173. package/react-native.config.js +10 -0
  174. package/src/PdfView.tsx +221 -0
  175. package/src/document.ts +34 -0
  176. package/src/index.ts +16 -0
  177. package/src/specs/PdfSdk.nitro.ts +60 -0
  178. package/src/specs/PdfView.nitro.ts +149 -0
@@ -0,0 +1,711 @@
1
+ import UIKit
2
+
3
+ /**
4
+ * The viewer itself: one view that owns the document, the zoom, the movement
5
+ * and the drawing.
6
+ *
7
+ * The Kotlin twin, `PdfSurface.kt`, counts the pinch and the flick by
8
+ * hand, because Android's own detectors would not do what a document needs.
9
+ * Here a `UIScrollView` does that work: it is the same scroll view every iOS
10
+ * app is read through, so the momentum, the rubber band at the edges and the
11
+ * pinch are the ones the reader already knows, and none of them is ours to get
12
+ * wrong. What is left is this: turn a document into a content size and a zoom
13
+ * range, and on every frame the scroll view moves, put the right tiles in the
14
+ * right places.
15
+ *
16
+ * The scroll view is transparent and its content is an empty view. Nothing is
17
+ * drawn inside it, so nothing is stretched by its zoom: the drawing happens
18
+ * underneath it in `PdfTileCanvas`, from numbers read out of it, which is what
19
+ * keeps a sheet thirteen metres wide sharp at every zoom instead of magnifying
20
+ * one picture of it.
21
+ */
22
+ final class PdfSurface: UIView, UIScrollViewDelegate {
23
+
24
+ // ─── What the view tells whoever is holding it ──────────────────────────────
25
+
26
+ var onLoad: ((_ pageCount: Int, _ width: CGFloat, _ height: CGFloat) -> Void)?
27
+ /// Zero based, so it matches the page property. A caller adds one to show it.
28
+ var onPageChange: ((_ page: Int, _ pageCount: Int) -> Void)?
29
+ /// The zoom as a multiple of what the document opened at, and what that is.
30
+ var onZoom: ((_ zoom: CGFloat, _ scale: CGFloat) -> Void)?
31
+ var onFailure: ((PdfFailure) -> Void)?
32
+ /// A tap that was not part of a double tap, and the page under it.
33
+ var onTap: ((_ x: CGFloat, _ y: CGFloat, _ page: Int) -> Void)?
34
+
35
+ private let scrollView = UIScrollView()
36
+ private let content = UIView()
37
+ private let canvas = PdfTileCanvas()
38
+
39
+ private let viewport = PdfViewport()
40
+ private var grid = PdfTileGrid(pixelRatio: 2)
41
+ private var pixelRatio: CGFloat = 0
42
+ private var plan: PdfScrollPlan?
43
+ private var layout = PdfDocumentLayout([])
44
+ private var pageSizes: [PageSize] = []
45
+
46
+ private var store: PdfTileStore?
47
+
48
+ private let loader = DispatchQueue(label: "pdf-sdk-loader", qos: .userInitiated)
49
+
50
+ // ─── What it was told ───────────────────────────────────────────────────────
51
+
52
+ private var uri: String?
53
+ private var headers: [String: String] = [:]
54
+ private var password: String?
55
+ private var cache = true
56
+ private var openAtPage = 0
57
+ private var pageGap = PdfDocumentLayout.defaultGap
58
+
59
+ private var reportedPage = -1
60
+ private var reportedZoom: CGFloat = 0
61
+ private var lastZoomAt: CFTimeInterval = 0
62
+ private var zoomQueued = false
63
+
64
+ private var viewSize: CGSize = .zero
65
+ private var zoom: ZoomStep?
66
+ private var ticker: CADisplayLink?
67
+ private var lastEnsure: CFTimeInterval = 0
68
+ private var ensureQueued = false
69
+ private var velocity = CGPoint.zero
70
+ private var lastOffset = CGPoint.zero
71
+ private var lastMovedAt: CFTimeInterval = 0
72
+
73
+ override init(frame: CGRect) {
74
+ super.init(frame: frame)
75
+
76
+ // React Native leaves overflow visible on the views around us, so without
77
+ // this the document is drawn over whatever the screen puts above and below
78
+ // it, the header included.
79
+ clipsToBounds = true
80
+ backgroundColor = .clear
81
+
82
+ canvas.frame = bounds
83
+ addSubview(canvas)
84
+
85
+ scrollView.frame = bounds
86
+ scrollView.delegate = self
87
+ scrollView.backgroundColor = .clear
88
+ scrollView.contentInsetAdjustmentBehavior = .never
89
+ scrollView.decelerationRate = .normal
90
+ scrollView.bouncesZoom = true
91
+ scrollView.minimumZoomScale = 1
92
+ scrollView.maximumZoomScale = 1
93
+ content.backgroundColor = .clear
94
+ scrollView.addSubview(content)
95
+ addSubview(scrollView)
96
+
97
+ let doubleTap = UITapGestureRecognizer(target: self, action: #selector(handleDoubleTap))
98
+ doubleTap.numberOfTapsRequired = 2
99
+ scrollView.addGestureRecognizer(doubleTap)
100
+
101
+ let singleTap = UITapGestureRecognizer(target: self, action: #selector(handleTap))
102
+ singleTap.require(toFail: doubleTap)
103
+ scrollView.addGestureRecognizer(singleTap)
104
+ }
105
+
106
+ @available(*, unavailable)
107
+ required init?(coder: NSCoder) {
108
+ fatalError("PdfSurface is not built from a storyboard")
109
+ }
110
+
111
+ // ─── Loading ────────────────────────────────────────────────────────────────
112
+
113
+ func load(uri: String, headers: [String: String], password: String?, cache: Bool, page: Int) {
114
+ let same = uri == self.uri && password == self.password && store != nil
115
+ self.headers = headers
116
+ self.cache = cache
117
+
118
+ if same {
119
+ if page != openAtPage {
120
+ openAtPage = page
121
+ goToPage(page, animated: false)
122
+ }
123
+ return
124
+ }
125
+
126
+ self.uri = uri
127
+ self.password = password
128
+ openAtPage = page
129
+ reportedPage = -1
130
+ reportedZoom = 0
131
+
132
+ closeDocument()
133
+ canvas.clear()
134
+ guard !uri.isEmpty else { return }
135
+
136
+ loader.async { [weak self] in
137
+ guard let self else { return }
138
+
139
+ let tiles: PdfTileStore
140
+ let sizes: [PageSize]
141
+ do {
142
+ let path = try PdfSourceLoader.localPath(for: uri, headers: headers, cache: cache)
143
+ tiles = try PdfTileStore(
144
+ path: path,
145
+ password: password,
146
+ onTileReady: { [weak self] in self?.redraw() },
147
+ onError: { [weak self] error in self?.report(error) }
148
+ )
149
+ // Every page measured before the document is shown. The Kotlin twin
150
+ // assumes they are all the size of the first and corrects it
151
+ // afterwards, because opening a page on Android is where the platform
152
+ // parses its content, and on a large drawing that is a third of a
153
+ // second each. Here a page's size is read from the page's dictionary
154
+ // without touching its content, so all of them cost nothing.
155
+ sizes = try tiles.pageSizes()
156
+ } catch {
157
+ self.report(error)
158
+ return
159
+ }
160
+
161
+ DispatchQueue.main.async {
162
+ guard self.uri == uri, self.window != nil else {
163
+ tiles.close()
164
+ return
165
+ }
166
+ self.store = tiles
167
+ self.pageSizes = sizes
168
+ self.layout = PdfDocumentLayout(sizes, gap: self.pageGap)
169
+ self.viewport.setDocument(self.layout)
170
+ if self.viewport.ready {
171
+ self.applyPlan()
172
+ self.goToPage(self.openAtPage, animated: false)
173
+ self.ensureTiles(force: true)
174
+ DispatchQueue.main.asyncAfter(deadline: .now() + 0.5) { [weak self] in
175
+ guard let self, self.uri == uri else { return }
176
+ self.settle()
177
+ }
178
+ }
179
+ let first = self.layout.firstPage
180
+ self.onLoad?(tiles.pageCount, first.width, first.height)
181
+ }
182
+ }
183
+ }
184
+
185
+ // ─── What the reader is allowed to do ───────────────────────────────────────
186
+
187
+ func setFit(_ policy: PdfFitPolicy) {
188
+ guard viewport.fit != policy else { return }
189
+ viewport.fit = policy
190
+ refit()
191
+ }
192
+
193
+ func setZoomRange(min minZoom: CGFloat?, max maxZoom: CGFloat?) {
194
+ guard viewport.minZoom != minZoom || viewport.maxZoom != maxZoom else { return }
195
+ viewport.minZoom = minZoom
196
+ viewport.maxZoom = maxZoom
197
+ refit()
198
+ }
199
+
200
+ func setDoubleTapZoom(_ value: CGFloat?) {
201
+ viewport.doubleTapZoom = value
202
+ }
203
+
204
+ func setPageGap(_ gap: CGFloat) {
205
+ guard gap != pageGap else { return }
206
+ pageGap = gap
207
+ guard !pageSizes.isEmpty else { return }
208
+ layout = PdfDocumentLayout(pageSizes, gap: gap)
209
+ viewport.setDocument(layout)
210
+ refit()
211
+ }
212
+
213
+ func setBackdropColor(_ color: UIColor?) {
214
+ backgroundColor = color ?? .clear
215
+ }
216
+
217
+ func setScrollIndicators(_ shown: Bool) {
218
+ scrollView.showsVerticalScrollIndicator = shown
219
+ scrollView.showsHorizontalScrollIndicator = shown
220
+ }
221
+
222
+ /// Something about the shape of the document changed, so it opens again.
223
+ private func refit() {
224
+ guard viewport.ready, store != nil else { return }
225
+ let page = reportedPage < 0 ? openAtPage : reportedPage
226
+ applyPlan()
227
+ goToPage(page, animated: false)
228
+ ensureTiles(force: true)
229
+ }
230
+
231
+ // ─── What a caller can ask for ──────────────────────────────────────────────
232
+
233
+ func goToPage(_ page: Int, animated: Bool) {
234
+ guard let plan, layout.pages.indices.contains(page) else { return }
235
+ let offset = plan.offset(
236
+ atZoom: scrollView.zoomScale,
237
+ pageTop: layout.pages[page].y,
238
+ keepingX: scrollView.contentOffset.x
239
+ )
240
+ stopZooming()
241
+ velocity = .zero
242
+ lastMovedAt = 0
243
+ if animated {
244
+ scrollView.setContentOffset(offset, animated: true)
245
+ } else {
246
+ scrollView.contentOffset = offset
247
+ moved(force: true)
248
+ }
249
+ }
250
+
251
+ /// `zoom` is a multiple of the zoom the document opened at.
252
+ func setZoom(_ zoom: CGFloat, animated: Bool) {
253
+ guard let plan, viewport.ready else { return }
254
+ let target = min(max(zoom, plan.minimumZoomScale), plan.maximumZoomScale)
255
+ let middle = CGPoint(x: bounds.midX, y: bounds.midY)
256
+ let anchor = CGPoint(
257
+ x: viewport.screenToDocumentX(middle.x),
258
+ y: viewport.screenToDocumentY(middle.y)
259
+ )
260
+
261
+ if animated {
262
+ startZooming(to: target, about: anchor, under: middle)
263
+ return
264
+ }
265
+
266
+ stopZooming()
267
+ velocity = .zero
268
+ lastMovedAt = 0
269
+ scrollView.setZoomScale(target, animated: false)
270
+ applyMargin()
271
+ let scale = plan.scale(atZoom: target)
272
+ scrollView.contentOffset = plan.clamp(
273
+ CGPoint(x: anchor.x * scale - middle.x, y: anchor.y * scale - middle.y),
274
+ atZoom: target
275
+ )
276
+ moved(force: true)
277
+ }
278
+
279
+ /**
280
+ * How much of what is on screen has been drawn for the zoom it is shown at,
281
+ * worked out whenever the tiles are, and read from anywhere.
282
+ */
283
+ private(set) var lastCoverage: CGFloat = 0
284
+
285
+ private func measureCoverage() {
286
+ guard let store else {
287
+ lastCoverage = 0
288
+ return
289
+ }
290
+ lastCoverage = grid.coverage(viewport, layout) { store.image($0) != nil }
291
+ }
292
+
293
+ func release() {
294
+ stopZooming()
295
+ closeDocument()
296
+ canvas.clear()
297
+ uri = nil
298
+ }
299
+
300
+ private func closeDocument() {
301
+ stopZooming()
302
+ let current = store
303
+ store = nil
304
+ plan = nil
305
+ pageSizes = []
306
+ layout = PdfDocumentLayout([])
307
+ viewport.setDocument(layout)
308
+ grid.clear()
309
+ if let current {
310
+ loader.async { current.close() }
311
+ }
312
+ }
313
+
314
+ private func report(_ error: Error) {
315
+ let failure = PdfFailure.from(error)
316
+ DispatchQueue.main.async { [weak self] in self?.onFailure?(failure) }
317
+ }
318
+
319
+ override func didMoveToWindow() {
320
+ super.didMoveToWindow()
321
+ if window == nil {
322
+ // An open PDF is a file handle and a page parsed into memory; a view that
323
+ // has left the screen should be holding neither.
324
+ let current = uri
325
+ closeDocument()
326
+ canvas.clear()
327
+ uri = current
328
+ } else if let current = uri, store == nil {
329
+ let page = openAtPage
330
+ uri = nil
331
+ load(uri: current, headers: headers, password: password, cache: cache, page: page)
332
+ }
333
+ }
334
+
335
+ // ─── Layout ─────────────────────────────────────────────────────────────────
336
+
337
+ override func layoutSubviews() {
338
+ super.layoutSubviews()
339
+ scrollView.frame = bounds
340
+ canvas.frame = bounds
341
+
342
+ // How many pixels a point of the screen has, which is how large a tile is
343
+ // drawn. Read here rather than when the view is made: a view that is not on
344
+ // a screen yet has no screen to answer for.
345
+ let ratio = traitCollection.displayScale
346
+ if ratio > 0, ratio != pixelRatio {
347
+ pixelRatio = ratio
348
+ grid = PdfTileGrid(pixelRatio: ratio)
349
+ if let plan { grid.setLadder(base: plan.baseScale) }
350
+ store?.clear()
351
+ ensureTiles(force: true)
352
+ }
353
+
354
+ guard bounds.size != viewSize else { return }
355
+ viewSize = bounds.size
356
+ viewport.setView(width: bounds.width, height: bounds.height)
357
+ guard viewport.ready else { return }
358
+
359
+ applyPlan()
360
+ goToPage(openAtPage, animated: false)
361
+ ensureTiles(force: true)
362
+ }
363
+
364
+ /**
365
+ * Tells the scroll view what it is holding: how large the document is, how
366
+ * far it may be zoomed either way, and where it opens.
367
+ *
368
+ * The zoom the document opens at is the scroll view's 1, so everything the
369
+ * reader does is a multiple of how the document came up rather than of its
370
+ * printed size, and a sheet thirteen metres wide and a letter page are the
371
+ * same arithmetic.
372
+ */
373
+ private func applyPlan() {
374
+ guard viewport.ready else { return }
375
+
376
+ let plan = PdfScrollPlan(viewport: viewport)
377
+ self.plan = plan
378
+ // Every level is a multiple of the zoom the document opens at, so the grid
379
+ // is told what that is before it is asked for anything.
380
+ grid.setLadder(base: plan.baseScale)
381
+
382
+ velocity = .zero
383
+ lastMovedAt = 0
384
+
385
+ scrollView.minimumZoomScale = plan.minimumZoomScale
386
+ scrollView.maximumZoomScale = plan.maximumZoomScale
387
+ scrollView.zoomScale = 1
388
+ content.frame = CGRect(origin: .zero, size: plan.contentSize)
389
+ scrollView.contentSize = plan.contentSize
390
+ applyMargin()
391
+ scrollView.contentOffset = plan.initialOffset
392
+
393
+ plan.place(viewport, offset: scrollView.contentOffset, zoom: 1)
394
+ grid.clear()
395
+ grid.setLadder(base: plan.baseScale)
396
+ }
397
+
398
+ /// Holds a document smaller than the screen in the middle of it.
399
+ private func applyMargin() {
400
+ guard let plan else { return }
401
+ let margin = plan.margin(atZoom: scrollView.zoomScale)
402
+ let insets = UIEdgeInsets(
403
+ top: margin.height,
404
+ left: margin.width,
405
+ bottom: margin.height,
406
+ right: margin.width
407
+ )
408
+ guard insets != scrollView.contentInset else { return }
409
+ scrollView.contentInset = insets
410
+ }
411
+
412
+ // ─── Movement ───────────────────────────────────────────────────────────────
413
+
414
+ func viewForZooming(in scrollView: UIScrollView) -> UIView? { content }
415
+
416
+ func scrollViewDidScroll(_ scrollView: UIScrollView) { moved() }
417
+
418
+ func scrollViewDidZoom(_ scrollView: UIScrollView) {
419
+ applyMargin()
420
+ moved()
421
+ }
422
+
423
+ func scrollViewDidEndZooming(_ scrollView: UIScrollView, with view: UIView?, atScale scale: CGFloat) {
424
+ applyMargin()
425
+ moved(force: true)
426
+ }
427
+
428
+ func scrollViewWillBeginDragging(_ scrollView: UIScrollView) { stopZooming() }
429
+
430
+ func scrollViewWillBeginZooming(_ scrollView: UIScrollView, with view: UIView?) {
431
+ stopZooming()
432
+ }
433
+
434
+ func scrollViewDidEndDragging(_ scrollView: UIScrollView, willDecelerate decelerate: Bool) {
435
+ if !decelerate { settle() }
436
+ }
437
+
438
+ func scrollViewDidEndDecelerating(_ scrollView: UIScrollView) { settle() }
439
+
440
+ func scrollViewDidEndScrollingAnimation(_ scrollView: UIScrollView) { settle() }
441
+
442
+ /**
443
+ * The document has come to rest, so nothing is being looked ahead of, and the
444
+ * ground around what is on screen is worth drawing before it is asked for.
445
+ */
446
+ private func settle() {
447
+ velocity = .zero
448
+ lastMovedAt = 0
449
+ ensureTiles(force: true, margin: PdfTileGrid.restMargin)
450
+ }
451
+
452
+ /**
453
+ * Where the scroll view has arrived, read into the viewport.
454
+ *
455
+ * The speed is measured from the movement itself rather than taken from the
456
+ * pan gesture, because it has to cover the glide after the finger has left as
457
+ * well, and that is what the tiles are asked for ahead of.
458
+ */
459
+ private func moved(force: Bool = false) {
460
+ guard let plan else { return }
461
+
462
+ let offset = scrollView.contentOffset
463
+ let now = CACurrentMediaTime()
464
+ let elapsed = now - lastMovedAt
465
+ if lastMovedAt > 0, elapsed > 0.001 {
466
+ velocity = CGPoint(
467
+ x: -(offset.x - lastOffset.x) / elapsed,
468
+ y: -(offset.y - lastOffset.y) / elapsed
469
+ )
470
+ }
471
+ lastMovedAt = now
472
+ lastOffset = offset
473
+
474
+ plan.place(viewport, offset: offset, zoom: scrollView.zoomScale)
475
+ notifyZoom()
476
+ ensureTiles(force: force)
477
+ redraw()
478
+ }
479
+
480
+ /**
481
+ * The zoom, as a multiple of what the document opened at.
482
+ *
483
+ * Held to a few a second on purpose. A pinch changes the zoom on every frame,
484
+ * and whoever is listening is almost certainly putting the number on the
485
+ * screen, which means a React render per frame and a JavaScript thread on its
486
+ * knees while the fingers are still moving. What matters is that the reader
487
+ * sees a number that keeps up and that the last one is right, so one that
488
+ * comes too early is sent late rather than dropped.
489
+ */
490
+ private func notifyZoom() {
491
+ let zoom = scrollView.zoomScale
492
+ guard abs(zoom - reportedZoom) > reportedZoom * 0.005 else { return }
493
+
494
+ let now = CACurrentMediaTime()
495
+ guard now - lastZoomAt >= PdfSurface.zoomSecondsApart else {
496
+ if !zoomQueued {
497
+ zoomQueued = true
498
+ DispatchQueue.main.asyncAfter(deadline: .now() + PdfSurface.zoomSecondsApart) {
499
+ [weak self] in
500
+ self?.zoomQueued = false
501
+ self?.notifyZoom()
502
+ }
503
+ }
504
+ return
505
+ }
506
+
507
+ lastZoomAt = now
508
+ reportedZoom = zoom
509
+ onZoom?(zoom, viewport.scale)
510
+ }
511
+
512
+ // ─── Taps ───────────────────────────────────────────────────────────────────
513
+
514
+ @objc private func handleTap(_ recognizer: UITapGestureRecognizer) {
515
+ guard onTap != nil, viewport.ready else { return }
516
+ let point = recognizer.location(in: self)
517
+ let page = layout.pageAt(viewport.screenToDocumentY(point.y))
518
+ onTap?(point.x, point.y, page)
519
+ }
520
+
521
+ /// A double tap, from where it is to where it is going, and what it turns about.
522
+ private struct ZoomStep {
523
+ let from: CGFloat
524
+ let to: CGFloat
525
+ /// The point of the document under the finger, which stays under it.
526
+ let anchor: CGPoint
527
+ let finger: CGPoint
528
+ let started: CFTimeInterval
529
+ }
530
+
531
+ @objc private func handleDoubleTap(_ recognizer: UITapGestureRecognizer) {
532
+ guard let plan, viewport.ready else { return }
533
+
534
+ let finger = recognizer.location(in: self)
535
+ velocity = .zero
536
+ lastMovedAt = 0
537
+
538
+ let anchor = CGPoint(
539
+ x: viewport.screenToDocumentX(finger.x),
540
+ y: viewport.screenToDocumentY(finger.y)
541
+ )
542
+ startZooming(to: plan.zoom(forScale: viewport.doubleTapTarget()), about: anchor, under: finger)
543
+ }
544
+
545
+ /**
546
+ * Moves the zoom over a quarter of a second, a frame at a time.
547
+ *
548
+ * The scroll view can animate a zoom itself, and asking it to was the first
549
+ * thing tried, but it does that with one animation on its content and tells
550
+ * its delegate once. The document is not drawn inside it, so what the reader
551
+ * saw was the page arriving at its new size in a single step. Stepped here,
552
+ * every frame goes through the same path a finger does.
553
+ */
554
+ private func startZooming(to target: CGFloat, about anchor: CGPoint, under finger: CGPoint) {
555
+ stopZooming()
556
+ guard scrollView.zoomScale != target else { return }
557
+
558
+ zoom = ZoomStep(
559
+ from: scrollView.zoomScale,
560
+ to: target,
561
+ anchor: anchor,
562
+ finger: finger,
563
+ started: CACurrentMediaTime()
564
+ )
565
+ askForWhereItLands(zoom: target, anchor: anchor, finger: finger)
566
+
567
+ let ticker = CADisplayLink(target: self, selector: #selector(stepZoom))
568
+ ticker.add(to: .main, forMode: .common)
569
+ self.ticker = ticker
570
+ }
571
+
572
+ @objc private func stepZoom() {
573
+ guard let plan, let zoom else {
574
+ stopZooming()
575
+ return
576
+ }
577
+
578
+ let elapsed = CACurrentMediaTime() - zoom.started
579
+ let through = min(1, elapsed / PdfSurface.zoomSeconds)
580
+ // Slow at both ends, quickest in the middle, which is the shape Android's
581
+ // animator uses and what a step of this size needs to read as one movement.
582
+ let eased = through < 0.5
583
+ ? 2 * through * through
584
+ : 1 - pow(-2 * through + 2, 2) / 2
585
+
586
+ let next = zoom.from + (zoom.to - zoom.from) * eased
587
+ let scale = plan.scale(atZoom: next)
588
+ scrollView.zoomScale = next
589
+ scrollView.contentOffset = plan.clamp(
590
+ CGPoint(x: zoom.anchor.x * scale - zoom.finger.x, y: zoom.anchor.y * scale - zoom.finger.y),
591
+ atZoom: next
592
+ )
593
+ applyMargin()
594
+
595
+ if through >= 1 {
596
+ stopZooming()
597
+ settle()
598
+ }
599
+ }
600
+
601
+ private func stopZooming() {
602
+ ticker?.invalidate()
603
+ ticker = nil
604
+ zoom = nil
605
+ grid.stopAiming()
606
+ }
607
+
608
+ /**
609
+ * Asks for the tiles of where the zoom is going, before it goes.
610
+ *
611
+ * Worked out from a viewport put where the movement will end, so that what is
612
+ * asked for is the screenful that will be there rather than the one that is
613
+ * there now, which at eight times the zoom is sixty times the tiles. While
614
+ * the movement runs, nothing else is asked for: the renderers have exactly
615
+ * the right work in front of them.
616
+ */
617
+ private func askForWhereItLands(zoom: CGFloat, anchor: CGPoint, finger: CGPoint) {
618
+ guard let plan, let store else { return }
619
+
620
+ let scale = plan.scale(atZoom: zoom)
621
+ let landing = PdfViewport()
622
+ landing.setDocument(layout)
623
+ landing.setView(width: bounds.width, height: bounds.height)
624
+ plan.place(
625
+ landing,
626
+ offset: plan.clamp(
627
+ CGPoint(x: anchor.x * scale - finger.x, y: anchor.y * scale - finger.y),
628
+ atZoom: zoom
629
+ ),
630
+ zoom: zoom
631
+ )
632
+
633
+ grid.aim(at: scale)
634
+ grid.update(landing, layout)
635
+ let visible = landing.visible()
636
+ store.request(
637
+ grid.missing(landing) { store.image($0) != nil },
638
+ focusX: visible.x + visible.width / 2,
639
+ focusY: visible.y + visible.height / 2
640
+ )
641
+ redraw()
642
+ }
643
+
644
+ // ─── Tiles ──────────────────────────────────────────────────────────────────
645
+
646
+ private func ensureTiles(force: Bool = false, margin: CGFloat = PdfTileGrid.tileMargin) {
647
+ guard let store, viewport.ready, layout.pageCount > 0 else { return }
648
+ // A movement that knows where it is going has already asked for what it
649
+ // needs, and what is on screen on the way there is not worth a renderer.
650
+ guard zoom == nil else { return }
651
+
652
+ let now = CACurrentMediaTime()
653
+ if !force, now - lastEnsure < PdfSurface.ensureSeconds {
654
+ if !ensureQueued {
655
+ ensureQueued = true
656
+ DispatchQueue.main.asyncAfter(deadline: .now() + PdfSurface.ensureSeconds) {
657
+ [weak self] in
658
+ self?.ensureQueued = false
659
+ self?.ensureTiles(force: true)
660
+ }
661
+ }
662
+ return
663
+ }
664
+ lastEnsure = now
665
+
666
+ grid.update(
667
+ viewport,
668
+ layout,
669
+ velocityX: velocity.x,
670
+ velocityY: velocity.y,
671
+ margin: margin
672
+ )
673
+
674
+ let visible = viewport.visible()
675
+ store.request(
676
+ grid.missing(viewport) { store.image($0) != nil },
677
+ focusX: visible.x + visible.width / 2,
678
+ focusY: visible.y + visible.height / 2
679
+ )
680
+
681
+ // A page coming into view should never be a blank rectangle, so each one on
682
+ // screen is asked for its own small drawing as well, unless the whole page
683
+ // is already one of the tiles above.
684
+ for page in layout.pagesIn(top: visible.y, bottom: visible.bottom)
685
+ where !grid.drawsWholePage(page) {
686
+ store.requestThumbnail(page.index, size: PageSize(width: page.width, height: page.height))
687
+ }
688
+
689
+ notifyPage(visible)
690
+ measureCoverage()
691
+ redraw()
692
+ }
693
+
694
+ private func redraw() {
695
+ canvas.update(viewport: viewport, layout: layout, grid: grid, store: store)
696
+ }
697
+
698
+ /// The page the reader would say they are on: the one under the middle of the view.
699
+ private func notifyPage(_ visible: PageRect) {
700
+ let page = layout.pageAt(visible.y + visible.height / 2)
701
+ guard page != reportedPage else { return }
702
+ reportedPage = page
703
+ onPageChange?(page, layout.pageCount)
704
+ }
705
+
706
+ private static let ensureSeconds: CFTimeInterval = 0.06
707
+
708
+ /// How often the zoom is worth telling anyone about.
709
+ private static let zoomSecondsApart: CFTimeInterval = 0.12
710
+ private static let zoomSeconds: CFTimeInterval = 0.25
711
+ }