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,276 @@
1
+ package com.margelo.nitro.pdfsdk
2
+
3
+ import kotlin.math.ceil
4
+ import kotlin.math.floor
5
+ import kotlin.math.max
6
+ import kotlin.math.min
7
+
8
+ /** A rectangle on the screen, in pixels. */
9
+ data class ScreenRect(val left: Float, val top: Float, val right: Float, val bottom: Float) {
10
+ val width get() = right - left
11
+ val height get() = bottom - top
12
+ }
13
+
14
+ /**
15
+ * One tile: which page it belongs to, where it is, and how large it is drawn.
16
+ *
17
+ * `rect` is in document points, which is where it is put on screen; `source` is
18
+ * the same rectangle in the page's own points, which is what the renderer is
19
+ * asked for.
20
+ */
21
+ data class TileSpec(
22
+ val page: Int,
23
+ val level: Float,
24
+ val column: Int,
25
+ val row: Int,
26
+ val rect: PageRect,
27
+ val source: PageRect,
28
+ val outWidth: Int,
29
+ val outHeight: Int,
30
+ ) {
31
+ val key: String get() = "${level.toBits()}:$page:$column:$row"
32
+ }
33
+
34
+ /** A tile and where it goes on the screen. */
35
+ data class PlannedTile(val spec: TileSpec, val destination: ScreenRect)
36
+
37
+ /**
38
+ * Which tiles the view needs, which of them to draw, and which to ask for next.
39
+ *
40
+ * All of it is arithmetic over the viewport, the document's layout and a set of
41
+ * keys already drawn, so it can be exercised on its own: whether a drag leaves a
42
+ * gap, whether a change of zoom leaves the screen bare, and in what order the
43
+ * missing ones are asked for are questions that can be answered without a
44
+ * device, a renderer or a single pixel.
45
+ */
46
+ class TileGrid(
47
+ private val tilePx: Int = 512,
48
+ private val levelDrift: Float = 1.45f,
49
+ private val lookaheadSeconds: Float = 0.3f,
50
+ ) {
51
+ var levelScale = 0f
52
+ private set
53
+
54
+ /** Set while a zoom is on its way to a scale that is already known. */
55
+ private var aimed = false
56
+
57
+ /** The tiles wanted at the current zoom, and the ones wanted at the last one. */
58
+ var current: List<TileSpec> = emptyList()
59
+ private set
60
+ var previous: List<TileSpec> = emptyList()
61
+ private set
62
+
63
+ /**
64
+ * Works out what the view needs now. `velocityX` and `velocityY` are how fast
65
+ * the document is moving in pixels a second, which is used to ask for tiles
66
+ * along the way rather than only where the view already is.
67
+ *
68
+ * Answers whether a new grid was started.
69
+ */
70
+ fun update(
71
+ viewport: PdfViewport,
72
+ layout: PdfDocumentLayout,
73
+ velocityX: Float = 0f,
74
+ velocityY: Float = 0f,
75
+ ): Boolean {
76
+ if (!viewport.ready || layout.pageCount == 0) return false
77
+
78
+ val drift = if (levelScale > 0f) viewport.scale / levelScale else Float.MAX_VALUE
79
+ val changed = !aimed && (drift > levelDrift || drift < 1f / levelDrift)
80
+ if (changed) {
81
+ previous = current
82
+ levelScale = viewport.scale
83
+ }
84
+
85
+ val tilePt = tilePx / levelScale
86
+ val margin = tilePt * TILE_MARGIN
87
+ val visible = viewport.visible()
88
+ val aheadX = -velocityX * lookaheadSeconds / viewport.scale
89
+ val aheadY = -velocityY * lookaheadSeconds / viewport.scale
90
+
91
+ val left = min(visible.x, visible.x + aheadX) - margin
92
+ val top = min(visible.y, visible.y + aheadY) - margin
93
+ val right = max(visible.right, visible.right + aheadX) + margin
94
+ val bottom = max(visible.bottom, visible.bottom + aheadY) + margin
95
+
96
+ val specs = ArrayList<TileSpec>()
97
+ for (page in layout.pagesIn(top, bottom)) {
98
+ specs.addAll(tilesOf(page, left, top, right, bottom, tilePt))
99
+ }
100
+ current = specs
101
+ return changed
102
+ }
103
+
104
+ /** The tiles of one page that fall inside the band being drawn. */
105
+ private fun tilesOf(
106
+ page: PageBox,
107
+ left: Float,
108
+ top: Float,
109
+ right: Float,
110
+ bottom: Float,
111
+ tilePt: Float,
112
+ ): List<TileSpec> {
113
+ val fromX = max(page.x, left)
114
+ val toX = min(page.right, right)
115
+ val fromY = max(page.y, top)
116
+ val toY = min(page.bottom, bottom)
117
+ if (toX <= fromX || toY <= fromY) return emptyList()
118
+
119
+ val firstColumn = max(0, floor((fromX - page.x) / tilePt).toInt())
120
+ val lastColumn = min(
121
+ ceil(page.width / tilePt).toInt() - 1,
122
+ floor((toX - page.x) / tilePt).toInt(),
123
+ )
124
+ val firstRow = max(0, floor((fromY - page.y) / tilePt).toInt())
125
+ val lastRow = min(
126
+ ceil(page.height / tilePt).toInt() - 1,
127
+ floor((toY - page.y) / tilePt).toInt(),
128
+ )
129
+
130
+ val specs = ArrayList<TileSpec>()
131
+ for (column in firstColumn..lastColumn) {
132
+ for (row in firstRow..lastRow) {
133
+ val x = column * tilePt
134
+ val y = row * tilePt
135
+ val width = min(tilePt, page.width - x)
136
+ val height = min(tilePt, page.height - y)
137
+ if (width <= 0f || height <= 0f) continue
138
+
139
+ specs.add(
140
+ TileSpec(
141
+ page = page.index,
142
+ level = levelScale,
143
+ column = column,
144
+ row = row,
145
+ rect = PageRect(page.x + x, page.y + y, width, height),
146
+ source = PageRect(x, y, width, height),
147
+ outWidth = max(1, Math.round(width * levelScale)),
148
+ outHeight = max(1, Math.round(height * levelScale)),
149
+ )
150
+ )
151
+ }
152
+ }
153
+ return specs
154
+ }
155
+
156
+ /**
157
+ * Draws for a zoom the view has not reached yet.
158
+ *
159
+ * A double tap knows where it is going before it starts. Asked for at the
160
+ * start, the tiles are there as it lands, and nothing is asked for on the way
161
+ * that will be thrown away when it arrives. Until then they are drawn small,
162
+ * which costs nothing and is never worse than what they replace.
163
+ */
164
+ fun aim(scale: Float) {
165
+ if (scale <= 0f) return
166
+ if (scale != levelScale) {
167
+ previous = current
168
+ current = emptyList()
169
+ levelScale = scale
170
+ }
171
+ aimed = true
172
+ }
173
+
174
+ /** Back to choosing the level from the zoom the reader is at. */
175
+ fun stopAiming() {
176
+ aimed = false
177
+ }
178
+
179
+ /** Everything to draw, oldest zoom first, skipping what has not been drawn yet. */
180
+ fun toDraw(viewport: PdfViewport, drawn: (String) -> Boolean): List<PlannedTile> {
181
+ val planned = ArrayList<PlannedTile>(previous.size + current.size)
182
+ for (spec in previous) if (drawn(spec.key)) planned.add(place(viewport, spec))
183
+ for (spec in current) if (drawn(spec.key)) planned.add(place(viewport, spec))
184
+ return planned
185
+ }
186
+
187
+ /** What is still to be drawn, nearest the middle of the view first. */
188
+ fun missing(viewport: PdfViewport, drawn: (String) -> Boolean): List<TileSpec> {
189
+ val visible = viewport.visible()
190
+ val centreX = visible.x + visible.width / 2f
191
+ val centreY = visible.y + visible.height / 2f
192
+ return current
193
+ .filterNot { drawn(it.key) }
194
+ .sortedBy {
195
+ val dx = it.rect.x + it.rect.width / 2f - centreX
196
+ val dy = it.rect.y + it.rect.height / 2f - centreY
197
+ dx * dx + dy * dy
198
+ }
199
+ }
200
+
201
+ /**
202
+ * The share of the screen covered by tiles drawn for the zoom it is shown at,
203
+ * between zero and one. What is left is covered by something coarser, either
204
+ * the tiles of the zoom before or the thumbnail of the page underneath. What
205
+ * falls between two pages counts as covered: there is nothing to draw there.
206
+ */
207
+ fun coverage(viewport: PdfViewport, layout: PdfDocumentLayout, drawn: (String) -> Boolean): Float =
208
+ coverageOf(viewport, layout, current.filter { drawn(it.key) })
209
+
210
+ /** The same, counting everything on screen however coarse. */
211
+ fun coarseCoverage(
212
+ viewport: PdfViewport,
213
+ layout: PdfDocumentLayout,
214
+ drawn: (String) -> Boolean,
215
+ ): Float = coverageOf(viewport, layout, (previous + current).filter { drawn(it.key) })
216
+
217
+ private fun coverageOf(
218
+ viewport: PdfViewport,
219
+ layout: PdfDocumentLayout,
220
+ tiles: List<TileSpec>,
221
+ ): Float {
222
+ if (!viewport.ready) return 0f
223
+ val visible = viewport.visible()
224
+ if (visible.width <= 0f || visible.height <= 0f) return 0f
225
+
226
+ // Sampled rather than measured: the tiles of one grid never overlap, but
227
+ // those of two grids do, and adding areas would count the overlap twice.
228
+ val steps = 40
229
+ var counted = 0
230
+ var covered = 0
231
+ for (row in 0 until steps) {
232
+ for (column in 0 until steps) {
233
+ val x = visible.x + visible.width * (column + 0.5f) / steps
234
+ val y = visible.y + visible.height * (row + 0.5f) / steps
235
+
236
+ val onPage = layout.pages.any { x >= it.x && x < it.right && y >= it.y && y < it.bottom }
237
+ if (!onPage) continue
238
+
239
+ counted++
240
+ if (tiles.any { x >= it.rect.x && x < it.rect.right && y >= it.rect.y && y < it.rect.bottom }) {
241
+ covered++
242
+ }
243
+ }
244
+ }
245
+ return if (counted == 0) 1f else covered.toFloat() / counted
246
+ }
247
+
248
+ fun clear() {
249
+ levelScale = 0f
250
+ current = emptyList()
251
+ previous = emptyList()
252
+ aimed = false
253
+ }
254
+
255
+ private fun place(viewport: PdfViewport, spec: TileSpec) = PlannedTile(
256
+ spec,
257
+ ScreenRect(
258
+ viewport.documentToScreenX(spec.rect.x),
259
+ viewport.documentToScreenY(spec.rect.y),
260
+ viewport.documentToScreenX(spec.rect.right),
261
+ viewport.documentToScreenY(spec.rect.bottom),
262
+ ),
263
+ )
264
+
265
+ companion object {
266
+ /** Tiles are also drawn this far outside the view, as a share of a tile. */
267
+ const val TILE_MARGIN = 0.35f
268
+
269
+ /** Handy for tests and for callers that keep their own set of keys. */
270
+ fun drawnFrom(keys: Set<String>): (String) -> Boolean = { keys.contains(it) }
271
+
272
+ fun overlaps(a: ScreenRect, b: ScreenRect): Boolean =
273
+ max(a.left, b.left) < min(a.right, b.right) - 0.01f &&
274
+ max(a.top, b.top) < min(a.bottom, b.bottom) - 0.01f
275
+ }
276
+ }
@@ -0,0 +1,71 @@
1
+ import CoreGraphics
2
+ import Foundation
3
+ import NitroModules
4
+
5
+ /**
6
+ * An open document, for taking pictures of pages.
7
+ *
8
+ * Drawing happens on a queue of its own: a page of a structural drawing takes a
9
+ * tenth of a second to read whatever size is asked for, and that is not
10
+ * something to do on the thread JavaScript runs on.
11
+ */
12
+ final class HybridPdfDocument: HybridPdfDocumentSpec {
13
+
14
+ private let source: PdfPageSource
15
+ private let queue = DispatchQueue(label: "pdf-sdk-document", qos: .userInitiated)
16
+
17
+ init(source: PdfPageSource) {
18
+ self.source = source
19
+ super.init()
20
+ }
21
+
22
+ var pageCount: Double { Double(source.pageCount) }
23
+
24
+ func getPageSize(page: Double) throws -> PdfPageSize {
25
+ guard page.isFinite, page >= 0 else { throw PdfFailure.unknown("There is no page \(page)") }
26
+ let size = try source.pageSize(Int(page))
27
+ return PdfPageSize(width: Double(size.width), height: Double(size.height))
28
+ }
29
+
30
+ func renderToFile(request: PdfRenderRequest) throws -> Promise<String> {
31
+ guard request.page.isFinite, request.page >= 0 else {
32
+ throw PdfFailure.unknown("There is no page \(request.page)")
33
+ }
34
+ guard request.outWidth >= 1, request.outHeight >= 1 else {
35
+ throw PdfFailure.unknown("An image cannot be smaller than a pixel")
36
+ }
37
+ let page = Int(request.page)
38
+ let size = try source.pageSize(page)
39
+ let rect = PageRect(
40
+ x: CGFloat(request.x ?? 0),
41
+ y: CGFloat(request.y ?? 0),
42
+ width: CGFloat(request.width ?? Double(size.width)),
43
+ height: CGFloat(request.height ?? Double(size.height))
44
+ )
45
+ let pixelWidth = Int(request.outWidth)
46
+ let pixelHeight = Int(request.outHeight)
47
+ let path = request.path ?? HybridPdfDocument.temporaryFile()
48
+
49
+ return Promise.parallel(queue) { [source] in
50
+ let image = try source.image(
51
+ page: page,
52
+ rect: rect,
53
+ pixelWidth: pixelWidth,
54
+ pixelHeight: pixelHeight
55
+ )
56
+ try PdfPageSource.writePNG(image, to: path)
57
+ return path
58
+ }
59
+ }
60
+
61
+ func close() throws {
62
+ source.close()
63
+ }
64
+
65
+ private static func temporaryFile() -> String {
66
+ let directory = FileManager.default
67
+ .urls(for: .cachesDirectory, in: .userDomainMask)[0]
68
+ .appendingPathComponent("pdf-sdk", isDirectory: true)
69
+ return directory.appendingPathComponent("\(UUID().uuidString).png").path
70
+ }
71
+ }
@@ -0,0 +1,10 @@
1
+ import Foundation
2
+ import NitroModules
3
+
4
+ /// Opens documents for whoever wants pictures of pages rather than a viewer.
5
+ final class HybridPdfSdk: HybridPdfSdkSpec {
6
+ func open(path: String, password: String?) throws -> any HybridPdfDocumentSpec {
7
+ let file = try PdfSourceLoader.localPath(for: path)
8
+ return HybridPdfDocument(source: try PdfPageSource(path: file, password: password))
9
+ }
10
+ }
@@ -0,0 +1,202 @@
1
+ import Foundation
2
+ import NitroModules
3
+ import UIKit
4
+
5
+ /**
6
+ * The view as React Native sees it. It holds the surface and passes on what
7
+ * comes from JavaScript; everything that happens per frame stays inside the
8
+ * surface.
9
+ */
10
+ final class HybridPdfView: HybridNativePdfViewSpec {
11
+
12
+ let view = PdfSurface(frame: .zero)
13
+
14
+ /// Set while props are arriving, so the document and the page are read together.
15
+ private var updating = false
16
+ private var needsLoad = false
17
+
18
+ override init() {
19
+ super.init()
20
+
21
+ view.onLoad = { [weak self] pageCount, width, height in
22
+ self?.onLoad?(
23
+ PdfLoadEvent(pageCount: Double(pageCount), width: Double(width), height: Double(height))
24
+ )
25
+ }
26
+ view.onPageChange = { [weak self] page, pageCount in
27
+ self?.onPageChange?(PdfPageEvent(page: Double(page), pageCount: Double(pageCount)))
28
+ }
29
+ view.onZoom = { [weak self] zoom, scale in
30
+ self?.onZoom?(PdfZoomEvent(zoom: Double(zoom), scale: Double(scale)))
31
+ }
32
+ view.onFailure = { [weak self] failure in
33
+ self?.onError?(PdfErrorEvent(code: failure.code.reported, message: failure.message))
34
+ }
35
+ view.onTap = { [weak self] x, y, page in
36
+ self?.onTap?(PdfTapEvent(x: Double(x), y: Double(y), page: Double(page)))
37
+ }
38
+ }
39
+
40
+ // ─── Props ──────────────────────────────────────────────────────────────────
41
+
42
+ var source = PdfViewSource(uri: "", headers: nil, password: nil, cache: nil) {
43
+ didSet { load() }
44
+ }
45
+
46
+ var page: Double = 0 {
47
+ didSet { load() }
48
+ }
49
+
50
+ var fit: PdfFit = .auto {
51
+ didSet { view.setFit(HybridPdfView.policy(for: fit)) }
52
+ }
53
+
54
+ /**
55
+ * Zero means the viewer decides, on all three of these.
56
+ *
57
+ * They are not optional because React hands native a `null` when a property
58
+ * is taken away and nitro reads only `undefined` as empty, so an optional
59
+ * number would throw in the bridge the first time a caller passed a value
60
+ * and then stopped. The wrapper in JavaScript fills the gaps.
61
+ */
62
+ var minZoom: Double = 0 {
63
+ didSet { view.setZoomRange(min: asked(minZoom), max: asked(maxZoom)) }
64
+ }
65
+
66
+ var maxZoom: Double = 0 {
67
+ didSet { view.setZoomRange(min: asked(minZoom), max: asked(maxZoom)) }
68
+ }
69
+
70
+ var doubleTapZoom: Double = 0 {
71
+ didSet { view.setDoubleTapZoom(asked(doubleTapZoom)) }
72
+ }
73
+
74
+ var pageGap: Double = Double(PdfDocumentLayout.defaultGap) {
75
+ didSet { view.setPageGap(CGFloat(pageGap)) }
76
+ }
77
+
78
+ var backdropColor: Double = 0 {
79
+ didSet { view.setBackdropColor(UIColor.fromProcessedColor(backdropColor)) }
80
+ }
81
+
82
+ var scrollIndicators: Bool = true {
83
+ didSet { view.setScrollIndicators(scrollIndicators) }
84
+ }
85
+
86
+ private func asked(_ value: Double) -> CGFloat? {
87
+ value > 0 ? CGFloat(value) : nil
88
+ }
89
+
90
+ var onLoad: ((_ event: PdfLoadEvent) -> Void)?
91
+ var onPageChange: ((_ event: PdfPageEvent) -> Void)?
92
+ var onZoom: ((_ event: PdfZoomEvent) -> Void)?
93
+ var onError: ((_ event: PdfErrorEvent) -> Void)?
94
+ var onTap: ((_ event: PdfTapEvent) -> Void)?
95
+
96
+ /**
97
+ * The document and the page arrive as separate properties, so opening on the
98
+ * first would open the old page of the new document. React updates props in
99
+ * one batch, and they are read once the batch has landed.
100
+ */
101
+ func beforeUpdate() {
102
+ updating = true
103
+ }
104
+
105
+ func afterUpdate() {
106
+ updating = false
107
+ if needsLoad { load() }
108
+ }
109
+
110
+ private func load() {
111
+ if updating {
112
+ needsLoad = true
113
+ return
114
+ }
115
+ needsLoad = false
116
+
117
+ let uri = source.uri
118
+ guard !uri.isEmpty else { return }
119
+ view.load(
120
+ uri: uri,
121
+ headers: source.headers ?? [:],
122
+ password: source.password,
123
+ cache: source.cache ?? true,
124
+ page: page.isFinite ? Int(max(0, page)) : 0
125
+ )
126
+ }
127
+
128
+ func onDropView() {
129
+ view.release()
130
+ }
131
+
132
+ // ─── Methods ────────────────────────────────────────────────────────────────
133
+
134
+ /**
135
+ * Nitro calls these straight from JavaScript's own thread: there is no hop to
136
+ * the screen's thread anywhere in its view layer. Touching a `UIScrollView`
137
+ * or a layer tree from there is undefined behaviour, and blocks JavaScript
138
+ * for as long as the work takes, which is how a single zoom cost half the
139
+ * frames on both threads. So the work is handed to the main thread and the
140
+ * call returns at once.
141
+ */
142
+ func goToPage(page: Double, animated: Bool) throws {
143
+ guard page.isFinite else { return }
144
+ onScreen { [view] in view.goToPage(Int(max(0, page)), animated: animated) }
145
+ }
146
+
147
+ func setZoom(zoom: Double, animated: Bool) throws {
148
+ guard zoom.isFinite, zoom > 0 else { return }
149
+ onScreen { [view] in view.setZoom(CGFloat(zoom), animated: animated) }
150
+ }
151
+
152
+ /// The last measurement the view made, which it takes on its own thread.
153
+ func coverage() throws -> Double {
154
+ Double(view.lastCoverage)
155
+ }
156
+
157
+ private func onScreen(_ work: @escaping () -> Void) {
158
+ if Thread.isMainThread {
159
+ work()
160
+ } else {
161
+ DispatchQueue.main.async(execute: work)
162
+ }
163
+ }
164
+
165
+ /// The viewer's own idea of a fit, which knows nothing about the bridge.
166
+ private static func policy(for fit: PdfFit) -> PdfFitPolicy {
167
+ switch fit {
168
+ case .width: return .width
169
+ case .height: return .height
170
+ case .page: return .page
171
+ default: return .auto
172
+ }
173
+ }
174
+ }
175
+
176
+
177
+
178
+ private extension PdfFailureCode {
179
+ var reported: PdfErrorCode {
180
+ switch self {
181
+ case .notFound: return .notfound
182
+ case .password: return .password
183
+ case .unsupported: return .unsupported
184
+ case .network: return .network
185
+ case .unknown: return .unknown
186
+ }
187
+ }
188
+ }
189
+
190
+ private extension UIColor {
191
+ /// What React Native's `processColor` hands over: alpha, red, green, blue.
192
+ static func fromProcessedColor(_ value: Double) -> UIColor? {
193
+ guard value.isFinite, value != 0 else { return nil }
194
+ let packed = UInt32(truncatingIfNeeded: Int64(value))
195
+ return UIColor(
196
+ red: CGFloat((packed >> 16) & 0xff) / 255,
197
+ green: CGFloat((packed >> 8) & 0xff) / 255,
198
+ blue: CGFloat(packed & 0xff) / 255,
199
+ alpha: CGFloat((packed >> 24) & 0xff) / 255
200
+ )
201
+ }
202
+ }