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

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 +24 -0
  2. package/LICENSE +21 -0
  3. package/PdfSdk.podspec +32 -0
  4. package/README.md +270 -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,210 @@
1
+ package com.margelo.nitro.pdfsdk
2
+
3
+ import android.graphics.Bitmap
4
+ import android.os.Handler
5
+ import android.os.HandlerThread
6
+ import android.util.LruCache
7
+ import kotlin.math.min
8
+
9
+ /**
10
+ * Draws tiles away from the screen's thread and keeps the ones drawn.
11
+ *
12
+ * One at a time, because the renderer takes a page at a time anyway; what
13
+ * matters is choosing the right next one, which is the tile nearest the middle
14
+ * of what the reader is looking at. A tile that has left the view before its
15
+ * turn came is dropped rather than drawn.
16
+ *
17
+ * Thumbnails are the same work at a lower priority: a whole page drawn small,
18
+ * kept so that a page coming into view is never a blank rectangle. They are
19
+ * drawn only once nothing sharper is waiting.
20
+ */
21
+ class PdfTileStore(
22
+ private val source: PdfPageSource,
23
+ private val onTileReady: () -> Unit,
24
+ private val onError: (Throwable) -> Unit,
25
+ ) {
26
+ private class Thumbnail(val page: Int, val size: PageSize, val outWidth: Int, val outHeight: Int)
27
+
28
+ private val thread = HandlerThread("pdf-sdk-tiles").apply { start() }
29
+ private val handler = Handler(thread.looper)
30
+
31
+ private val tiles = object : LruCache<String, Bitmap>(cacheBytes()) {
32
+ override fun sizeOf(key: String, value: Bitmap): Int = value.byteCount
33
+ }
34
+
35
+ /** A page's whole content, drawn small. Far cheaper to keep than a tile. */
36
+ private val thumbnails = object : LruCache<Int, Bitmap>(THUMBNAIL_CACHE) {
37
+ override fun sizeOf(key: Int, value: Bitmap): Int = value.byteCount
38
+ }
39
+
40
+ private val queue = LinkedHashMap<String, TileSpec>()
41
+ private val thumbnailQueue = LinkedHashMap<Int, Thumbnail>()
42
+ private var focusX = 0f
43
+ private var focusY = 0f
44
+ private var era = 0
45
+ private var working = false
46
+ private var closed = false
47
+
48
+ fun bitmap(key: String): Bitmap? = tiles.get(key)
49
+
50
+ fun thumbnail(page: Int): Bitmap? = thumbnails.get(page)
51
+
52
+ /**
53
+ * Takes the tiles the view wants. Anything asked for before and no longer
54
+ * wanted is forgotten, so a drag does not leave a trail of work behind it.
55
+ */
56
+ fun request(specs: List<TileSpec>, focusX: Float, focusY: Float) {
57
+ synchronized(queue) {
58
+ if (closed) return
59
+ this.focusX = focusX
60
+ this.focusY = focusY
61
+
62
+ val wanted = HashSet<String>(specs.size)
63
+ for (spec in specs) {
64
+ wanted.add(spec.key)
65
+ if (tiles.get(spec.key) != null) continue
66
+ queue[spec.key] = spec
67
+ }
68
+ queue.keys.retainAll(wanted)
69
+ }
70
+ pump()
71
+ }
72
+
73
+ /** Asks for the small drawing of a page, if it is not already held. */
74
+ fun requestThumbnail(page: Int, size: PageSize) {
75
+ synchronized(queue) {
76
+ if (closed || thumbnails.get(page) != null || thumbnailQueue.containsKey(page)) return
77
+
78
+ val aspect = if (size.height > 0f) size.width / size.height else 1f
79
+ val height = kotlin.math.sqrt(THUMBNAIL_PIXELS / aspect)
80
+ val width = height * aspect
81
+ thumbnailQueue[page] = Thumbnail(
82
+ page = page,
83
+ size = size,
84
+ outWidth = Math.max(1, Math.round(width)),
85
+ outHeight = Math.max(1, Math.round(height)),
86
+ )
87
+ }
88
+ pump()
89
+ }
90
+
91
+ /** Everything drawn so far belongs to another document. */
92
+ fun clear() {
93
+ synchronized(queue) {
94
+ era++
95
+ queue.clear()
96
+ thumbnailQueue.clear()
97
+ }
98
+ tiles.evictAll()
99
+ thumbnails.evictAll()
100
+ }
101
+
102
+ fun close() {
103
+ synchronized(queue) {
104
+ closed = true
105
+ queue.clear()
106
+ thumbnailQueue.clear()
107
+ }
108
+ tiles.evictAll()
109
+ thumbnails.evictAll()
110
+ thread.quitSafely()
111
+ }
112
+
113
+ private fun pump() {
114
+ val tile: TileSpec?
115
+ val thumbnail: Thumbnail?
116
+ val currentEra: Int
117
+
118
+ synchronized(queue) {
119
+ if (closed || working) return
120
+ currentEra = era
121
+ tile = nearest()
122
+ if (tile != null) {
123
+ queue.remove(tile.key)
124
+ thumbnail = null
125
+ } else {
126
+ // Nothing sharp is waiting, so a page's small drawing can have the thread.
127
+ val next = thumbnailQueue.keys.firstOrNull()
128
+ thumbnail = next?.let { thumbnailQueue.remove(it) }
129
+ }
130
+ working = tile != null || thumbnail != null
131
+ if (!working) return
132
+ }
133
+
134
+ handler.post {
135
+ try {
136
+ if (!isStale(currentEra)) {
137
+ if (tile != null) drawTile(tile, currentEra) else drawThumbnail(thumbnail!!, currentEra)
138
+ }
139
+ } catch (error: Throwable) {
140
+ onError(error)
141
+ } finally {
142
+ synchronized(queue) { working = false }
143
+ pump()
144
+ }
145
+ }
146
+ }
147
+
148
+ private fun drawTile(spec: TileSpec, currentEra: Int) {
149
+ val bitmap = Bitmap.createBitmap(spec.outWidth, spec.outHeight, Bitmap.Config.ARGB_8888)
150
+ source.render(spec.page, spec.source, bitmap)
151
+ if (isStale(currentEra)) return
152
+ tiles.put(spec.key, bitmap)
153
+ onTileReady()
154
+ }
155
+
156
+ private fun drawThumbnail(thumbnail: Thumbnail, currentEra: Int) {
157
+ val bitmap = Bitmap.createBitmap(thumbnail.outWidth, thumbnail.outHeight, Bitmap.Config.ARGB_8888)
158
+ source.render(
159
+ thumbnail.page,
160
+ PageRect(0f, 0f, thumbnail.size.width, thumbnail.size.height),
161
+ bitmap,
162
+ )
163
+ if (isStale(currentEra)) return
164
+ thumbnails.put(thumbnail.page, bitmap)
165
+ onTileReady()
166
+ }
167
+
168
+ private fun isStale(currentEra: Int): Boolean = synchronized(queue) { closed || era != currentEra }
169
+
170
+ /**
171
+ * The tile nearest what is being looked at, so the middle fills in first.
172
+ * Between two tiles at much the same distance, the one on the page the
173
+ * renderer already has open wins: opening a page is where the platform parses
174
+ * it, and on a drawing that costs more than the tile itself.
175
+ */
176
+ private fun nearest(): TileSpec? {
177
+ var best: TileSpec? = null
178
+ var bestCost = Float.MAX_VALUE
179
+ val open = source.openPageIndex
180
+ for (spec in queue.values) {
181
+ val dx = spec.rect.x + spec.rect.width / 2f - focusX
182
+ val dy = spec.rect.y + spec.rect.height / 2f - focusY
183
+ var cost = dx * dx + dy * dy
184
+ if (spec.page != open) cost *= PAGE_SWITCH_COST
185
+ if (cost < bestCost) {
186
+ bestCost = cost
187
+ best = spec
188
+ }
189
+ }
190
+ return best
191
+ }
192
+
193
+ private companion object {
194
+ /** A quarter of what the app may hold, and never more than this. */
195
+ const val CACHE_CEILING = 96L * 1024 * 1024
196
+
197
+ /** Thumbnails are small and there are few of them. */
198
+ const val THUMBNAIL_CACHE = 8 * 1024 * 1024
199
+ const val THUMBNAIL_PIXELS = 400_000f
200
+
201
+ /**
202
+ * How much further a tile has to be before it is preferred over one on the
203
+ * page already open. A page has to be parsed before any of it can be drawn.
204
+ */
205
+ const val PAGE_SWITCH_COST = 4f
206
+
207
+ fun cacheBytes(): Int =
208
+ min(Runtime.getRuntime().maxMemory() / 4, CACHE_CEILING).toInt()
209
+ }
210
+ }
@@ -0,0 +1,255 @@
1
+ package com.margelo.nitro.pdfsdk
2
+
3
+ import kotlin.math.max
4
+ import kotlin.math.min
5
+
6
+ /** A rectangle of the document, in points. */
7
+ data class PageRect(val x: Float, val y: Float, val width: Float, val height: Float) {
8
+ val right get() = x + width
9
+ val bottom get() = y + height
10
+ }
11
+
12
+ /**
13
+ * How a document is sized when it opens, which is also what a zoom of 1 means.
14
+ *
15
+ * The twin of the `PdfFit` union in the JavaScript API, kept apart from it so
16
+ * that everything deciding what the reader sees stays free of the bridge and
17
+ * can be tested on the JVM.
18
+ */
19
+ enum class PdfFitPolicy {
20
+ AUTO,
21
+ WIDTH,
22
+ HEIGHT,
23
+ PAGE,
24
+ }
25
+
26
+ /**
27
+ * Where the document sits on the screen, and everything that follows from it.
28
+ *
29
+ * Deliberately free of Android: this is the arithmetic that decides what the
30
+ * reader sees, and it is worth being able to test on its own. `scale` is screen
31
+ * pixels to the document point, and the offsets are where the document's top
32
+ * left corner sits in the view, so a point maps to `point * scale + offset`.
33
+ */
34
+ class PdfViewport {
35
+ /** The document's bounding box: the widest page, and every page stacked up. */
36
+ var contentWidth = 0f
37
+ private set
38
+ var contentHeight = 0f
39
+ private set
40
+
41
+ /** The first page, which is what decides how the document opens. */
42
+ var firstPage = PageSize(0f, 0f)
43
+ private set
44
+
45
+ var viewWidth = 0f
46
+ private set
47
+ var viewHeight = 0f
48
+ private set
49
+
50
+ var scale = 1f
51
+ private set
52
+ var offsetX = 0f
53
+ private set
54
+ var offsetY = 0f
55
+ private set
56
+
57
+ /** What the document is fitted to when it opens. */
58
+ var fit = PdfFitPolicy.AUTO
59
+
60
+ /** How far it may be zoomed, in multiples of the zoom it opened at. */
61
+ var minZoom: Float? = null
62
+ var maxZoom: Float? = null
63
+ var doubleTapZoom: Float? = null
64
+
65
+ fun setDocument(width: Float, height: Float, firstPage: PageSize) {
66
+ contentWidth = width
67
+ contentHeight = height
68
+ this.firstPage = firstPage
69
+ }
70
+
71
+ fun setDocument(layout: PdfDocumentLayout) {
72
+ setDocument(layout.width, layout.height, layout.firstPage)
73
+ }
74
+
75
+ /** A document of a single page, which is what most of the tests are about. */
76
+ fun setPage(width: Float, height: Float) {
77
+ setDocument(width, height, PageSize(width, height))
78
+ }
79
+
80
+ fun setView(width: Float, height: Float) {
81
+ viewWidth = width
82
+ viewHeight = height
83
+ }
84
+
85
+ val ready: Boolean
86
+ get() = contentWidth > 0f && contentHeight > 0f && viewWidth > 0f && viewHeight > 0f
87
+
88
+ /**
89
+ * The zoom that fits the document's width.
90
+ *
91
+ * Width rather than the whole document: a document is read by scrolling, and
92
+ * fitting twelve pages on a phone would show twelve stamps.
93
+ */
94
+ fun widthScale(): Float {
95
+ if (!ready) return 1f
96
+ return viewWidth / contentWidth
97
+ }
98
+
99
+ /** The zoom that fills the height with the first page. */
100
+ fun heightScale(): Float {
101
+ if (!ready || firstPage.height <= 0f) return widthScale()
102
+ return viewHeight / firstPage.height
103
+ }
104
+
105
+ /** The zoom that shows the whole of the first page. */
106
+ fun pageScale(): Float = min(widthScale(), heightScale())
107
+
108
+ /**
109
+ * The zoom a document opens at.
110
+ *
111
+ * Left to itself it fits the width, unless the first page is a strip rather
112
+ * than a page: the formwork plans of a building arrive as one sheet thirteen
113
+ * metres wide, and fitted to the width that is a line across the middle of
114
+ * the screen. Those open filling the height instead, read by panning
115
+ * sideways.
116
+ */
117
+ fun restScale(): Float {
118
+ if (!ready) return 1f
119
+ return when (fit) {
120
+ PdfFitPolicy.WIDTH -> widthScale()
121
+ PdfFitPolicy.HEIGHT -> heightScale()
122
+ PdfFitPolicy.PAGE -> pageScale()
123
+ PdfFitPolicy.AUTO -> {
124
+ val width = widthScale()
125
+ if (firstPage.height <= 0f) width
126
+ else if (firstPage.height * width < viewHeight * STRIP_HEIGHT_SHARE) heightScale()
127
+ else width
128
+ }
129
+ }
130
+ }
131
+
132
+ /**
133
+ * The furthest a document can be zoomed in, in pixels to the point.
134
+ *
135
+ * A point is a 72nd of an inch, so this is about forty times the printed
136
+ * sheet. It sounds excessive, and on an ordinary page it is; on a formwork
137
+ * plan drawn at 1:50 it is where a dimension written along a beam becomes
138
+ * comfortable rather than merely possible, and nobody is forced to go there.
139
+ */
140
+ fun maxScale(): Float {
141
+ val rest = restScale()
142
+ maxZoom?.let { return max(rest, rest * it) }
143
+ return max(rest, max(TARGET_POINT_SIZE, widthScale() * MIN_ZOOM_RANGE))
144
+ }
145
+
146
+ /**
147
+ * As far out as it goes. Left to itself, far enough to see the widest page
148
+ * whole, whatever zoom the document opened at.
149
+ */
150
+ fun minScale(): Float {
151
+ val rest = restScale()
152
+ minZoom?.let { return min(rest, rest * it) }
153
+ return min(rest, widthScale())
154
+ }
155
+
156
+ /**
157
+ * Where a double tap should take the reader.
158
+ *
159
+ * Zoomed in at all, it goes back out to where the document opened; otherwise
160
+ * it goes far enough in one tap to read what is written on the page, rather
161
+ * than a polite step that leaves the reader pinching afterwards.
162
+ */
163
+ fun doubleTapTarget(): Float {
164
+ val rest = restScale()
165
+ if (scale > rest * 1.05f) return rest
166
+ doubleTapZoom?.let { return min(maxScale(), rest * it) }
167
+ return min(maxScale(), max(rest * 3f, DOUBLE_TAP_SCALE))
168
+ }
169
+
170
+ /** Opens the document: at rest, at the top, and at the left when it is a strip. */
171
+ fun reset() {
172
+ if (!ready) return
173
+ scale = restScale()
174
+ offsetX = if (restScale() > widthScale()) 0f else centreX()
175
+ offsetY = 0f
176
+ clampOffsets()
177
+ }
178
+
179
+ private fun centreX() = (viewWidth - contentWidth * scale) / 2f
180
+ private fun centreY() = (viewHeight - contentHeight * scale) / 2f
181
+
182
+ /** Holds the document against its edges, and centres it where it is the smaller. */
183
+ fun clampOffsets() {
184
+ offsetX = if (contentWidth * scale <= viewWidth) centreX()
185
+ else offsetX.coerceIn(viewWidth - contentWidth * scale, 0f)
186
+
187
+ offsetY = if (contentHeight * scale <= viewHeight) centreY()
188
+ else offsetY.coerceIn(viewHeight - contentHeight * scale, 0f)
189
+ }
190
+
191
+ fun panBy(dx: Float, dy: Float) {
192
+ offsetX += dx
193
+ offsetY += dy
194
+ clampOffsets()
195
+ }
196
+
197
+ /**
198
+ * Zooms about a point of the screen, leaving whatever is under that point
199
+ * where it is. Answers the factor actually applied, which is less than the
200
+ * one asked for at the ends of the range.
201
+ */
202
+ fun zoomAround(focusX: Float, focusY: Float, factor: Float): Float {
203
+ val next = (scale * factor).coerceIn(minScale(), maxScale())
204
+ val applied = next / scale
205
+ offsetX = focusX - (focusX - offsetX) * applied
206
+ offsetY = focusY - (focusY - offsetY) * applied
207
+ scale = next
208
+ clampOffsets()
209
+ return applied
210
+ }
211
+
212
+ /** Puts the document at a given zoom and position, for working out a landing. */
213
+ fun place(scale: Float, offsetX: Float, offsetY: Float) {
214
+ this.scale = scale
215
+ this.offsetX = offsetX
216
+ this.offsetY = offsetY
217
+ clampOffsets()
218
+ }
219
+
220
+ /** Puts the document at a given position, used by the scroller and the tests. */
221
+ fun moveTo(offsetX: Float, offsetY: Float) {
222
+ this.offsetX = offsetX
223
+ this.offsetY = offsetY
224
+ clampOffsets()
225
+ }
226
+
227
+ fun documentToScreenX(point: Float) = point * scale + offsetX
228
+ fun documentToScreenY(point: Float) = point * scale + offsetY
229
+ fun screenToDocumentX(pixel: Float) = (pixel - offsetX) / scale
230
+ fun screenToDocumentY(pixel: Float) = (pixel - offsetY) / scale
231
+
232
+ /** What is on screen, in document points, clipped to the document. */
233
+ fun visible(): PageRect {
234
+ val left = max(0f, screenToDocumentX(0f))
235
+ val top = max(0f, screenToDocumentY(0f))
236
+ val right = min(contentWidth, screenToDocumentX(viewWidth))
237
+ val bottom = min(contentHeight, screenToDocumentY(viewHeight))
238
+ return PageRect(left, top, max(0f, right - left), max(0f, bottom - top))
239
+ }
240
+
241
+ /** How far the document may be moved, for a scroller that needs its limits. */
242
+ fun minOffsetX() = min(0f, viewWidth - contentWidth * scale)
243
+ fun maxOffsetX() = if (contentWidth * scale <= viewWidth) centreX() else 0f
244
+ fun minOffsetY() = min(0f, viewHeight - contentHeight * scale)
245
+ fun maxOffsetY() = if (contentHeight * scale <= viewHeight) centreY() else 0f
246
+
247
+ companion object {
248
+ const val STRIP_HEIGHT_SHARE = 0.3f
249
+ const val TARGET_POINT_SIZE = 40f
250
+ const val MIN_ZOOM_RANGE = 8f
251
+
252
+ /** Where one double tap lands when the document is at rest, at the least. */
253
+ const val DOUBLE_TAP_SCALE = 12f
254
+ }
255
+ }