@egret/engine 7.0.1-rc.3 → 7.0.2

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 (304) hide show
  1. package/dist/Engine.js +7 -2
  2. package/dist/animation/sequenceResetTypes.d.ts +6 -0
  3. package/dist/animation/types.d.ts +6 -0
  4. package/dist/assetBundle.d.ts +2 -0
  5. package/dist/assetGroupTypes.d.ts +2 -0
  6. package/dist/audioCues.d.ts +4 -0
  7. package/dist/audioTypes.d.ts +13 -0
  8. package/dist/bitmapButtonTypes.d.ts +2 -0
  9. package/dist/bitmapFontTypes.d.ts +3 -0
  10. package/dist/bitmapResourceSlot.d.ts +1 -0
  11. package/dist/camera2d.js +10 -2
  12. package/dist/cameraTypes.d.ts +12 -0
  13. package/dist/contentTypes.d.ts +2 -0
  14. package/dist/createEngineForProfile.js +8 -5
  15. package/dist/fontContentTypes.d.ts +5 -0
  16. package/dist/gameClockTypes.d.ts +6 -0
  17. package/dist/gameRun.d.ts +3 -0
  18. package/dist/gamepadTypes.d.ts +8 -0
  19. package/dist/hoverInputTypes.d.ts +10 -0
  20. package/dist/index.d.ts +5 -2
  21. package/dist/index.js +2 -1
  22. package/dist/inputActions.d.ts +5 -0
  23. package/dist/internal/uiFactoryState.d.ts +4 -0
  24. package/dist/internal/uiFactoryState.js +18 -2
  25. package/dist/keyboardInput.d.ts +1 -0
  26. package/dist/keyboardInput.js +1 -0
  27. package/dist/keyboardInputTypes.d.ts +12 -0
  28. package/dist/kit.d.ts +3 -1
  29. package/dist/kit.js +2 -1
  30. package/dist/manifestResourceState.d.ts +1 -0
  31. package/dist/manifestResourceState.js +1 -0
  32. package/dist/manifestResourceTypes.d.ts +1 -0
  33. package/dist/motion.d.ts +2 -0
  34. package/dist/mouseInputTypes.d.ts +4 -0
  35. package/dist/particleEmitter.js +8 -0
  36. package/dist/particleTypes.d.ts +8 -0
  37. package/dist/physics2d.d.ts +2 -2
  38. package/dist/physics2d.js +1 -1
  39. package/dist/physics2dTypes.d.ts +55 -1
  40. package/dist/physics2dWorld.js +209 -9
  41. package/dist/pointerInput.d.ts +1 -0
  42. package/dist/pointerInput.js +1 -0
  43. package/dist/pointerInputTypes.d.ts +3 -0
  44. package/dist/random.d.ts +1 -0
  45. package/dist/rendering/packSharedDraws2D.js +53 -5
  46. package/dist/rendering/prepareSharedDraws2D.d.ts +2 -0
  47. package/dist/rendering/prepareSharedDraws2D.js +17 -6
  48. package/dist/rendering/sharedColor2D.d.ts +35 -1
  49. package/dist/rendering/sharedColor2D.js +131 -8
  50. package/dist/rendering/sharedEffects2D.js +16 -8
  51. package/dist/rendering/world3d/Animation3D.d.ts +9 -0
  52. package/dist/rendering/world3d/Animation3D.js +4 -0
  53. package/dist/rendering/world3d/AnimationTexture3D.d.ts +6 -0
  54. package/dist/rendering/world3d/AnimationTexture3D.js +2 -0
  55. package/dist/rendering/world3d/Batch3D.d.ts +4 -0
  56. package/dist/rendering/world3d/Batch3D.js +3 -0
  57. package/dist/rendering/world3d/Camera3D.d.ts +5 -0
  58. package/dist/rendering/world3d/Camera3D.js +3 -0
  59. package/dist/rendering/world3d/Character3D.d.ts +4 -0
  60. package/dist/rendering/world3d/Character3D.js +2 -0
  61. package/dist/rendering/world3d/Cloth3D.d.ts +18 -3
  62. package/dist/rendering/world3d/Cloth3D.js +6 -1
  63. package/dist/rendering/world3d/Compression3D.d.ts +1 -0
  64. package/dist/rendering/world3d/Compression3D.js +1 -0
  65. package/dist/rendering/world3d/Curves3D.d.ts +8 -0
  66. package/dist/rendering/world3d/Curves3D.js +5 -0
  67. package/dist/rendering/world3d/Decal3D.d.ts +2 -0
  68. package/dist/rendering/world3d/Decal3D.js +1 -0
  69. package/dist/rendering/world3d/Export3D.d.ts +13 -0
  70. package/dist/rendering/world3d/Export3D.js +263 -0
  71. package/dist/rendering/world3d/Geometry3D.d.ts +11 -1
  72. package/dist/rendering/world3d/Geometry3D.js +10 -1
  73. package/dist/rendering/world3d/GeometryBuilder3D.d.ts +2 -0
  74. package/dist/rendering/world3d/Gizmo3D.d.ts +5 -0
  75. package/dist/rendering/world3d/Gizmo3D.js +2 -0
  76. package/dist/rendering/world3d/Gltf3D.d.ts +6 -0
  77. package/dist/rendering/world3d/Gltf3D.js +25 -5
  78. package/dist/rendering/world3d/GpuParticles3D.d.ts +2 -0
  79. package/dist/rendering/world3d/GpuParticles3D.js +1 -0
  80. package/dist/rendering/world3d/Hdr3D.d.ts +2 -0
  81. package/dist/rendering/world3d/Hdr3D.js +1 -0
  82. package/dist/rendering/world3d/Jelly3D.d.ts +2 -0
  83. package/dist/rendering/world3d/Jelly3D.js +1 -0
  84. package/dist/rendering/world3d/Ktx23D.d.ts +3 -0
  85. package/dist/rendering/world3d/Light3D.d.ts +9 -0
  86. package/dist/rendering/world3d/Light3D.js +4 -0
  87. package/dist/rendering/world3d/Material3D.d.ts +10 -0
  88. package/dist/rendering/world3d/Material3D.js +2 -0
  89. package/dist/rendering/world3d/Mesh3D.d.ts +4 -0
  90. package/dist/rendering/world3d/Mesh3D.js +16 -2
  91. package/dist/rendering/world3d/Meshopt3D.d.ts +3 -0
  92. package/dist/rendering/world3d/Meshopt3D.js +1 -0
  93. package/dist/rendering/world3d/Navigation3D.d.ts +41 -1
  94. package/dist/rendering/world3d/Navigation3D.js +74 -2
  95. package/dist/rendering/world3d/Object3D.d.ts +11 -0
  96. package/dist/rendering/world3d/Object3D.js +10 -0
  97. package/dist/rendering/world3d/Particles3D.d.ts +5 -0
  98. package/dist/rendering/world3d/Particles3D.js +3 -0
  99. package/dist/rendering/world3d/Physics3D.d.ts +14 -0
  100. package/dist/rendering/world3d/Physics3D.js +5 -0
  101. package/dist/rendering/world3d/PhysicsHull3D.d.ts +2 -0
  102. package/dist/rendering/world3d/PhysicsHull3D.js +2 -0
  103. package/dist/rendering/world3d/PhysicsMesh3D.d.ts +2 -0
  104. package/dist/rendering/world3d/PhysicsMesh3D.js +2 -0
  105. package/dist/rendering/world3d/PhysicsRemote3D.d.ts +5 -0
  106. package/dist/rendering/world3d/PhysicsRemote3D.js +2 -0
  107. package/dist/rendering/world3d/Ragdoll3D.d.ts +5 -0
  108. package/dist/rendering/world3d/Ragdoll3D.js +2 -0
  109. package/dist/rendering/world3d/Raycast3D.d.ts +3 -0
  110. package/dist/rendering/world3d/Raycast3D.js +1 -0
  111. package/dist/rendering/world3d/RenderList3D.d.ts +3 -0
  112. package/dist/rendering/world3d/RenderList3D.js +12 -0
  113. package/dist/rendering/world3d/Retarget3D.d.ts +1 -0
  114. package/dist/rendering/world3d/Rig3D.d.ts +57 -0
  115. package/dist/rendering/world3d/Rig3D.js +219 -0
  116. package/dist/rendering/world3d/Sdf3D.d.ts +181 -0
  117. package/dist/rendering/world3d/Sdf3D.js +1136 -0
  118. package/dist/rendering/world3d/SdfLod3D.d.ts +17 -0
  119. package/dist/rendering/world3d/SdfLod3D.js +56 -0
  120. package/dist/rendering/world3d/Serialize3D.d.ts +17 -0
  121. package/dist/rendering/world3d/Serialize3D.js +22 -0
  122. package/dist/rendering/world3d/Simplify3D.d.ts +29 -0
  123. package/dist/rendering/world3d/Simplify3D.js +426 -0
  124. package/dist/rendering/world3d/StateMachine3D.d.ts +9 -0
  125. package/dist/rendering/world3d/StateMachine3D.js +3 -0
  126. package/dist/rendering/world3d/SurfaceMaterial3D.d.ts +26 -0
  127. package/dist/rendering/world3d/SurfaceMaterial3D.js +138 -0
  128. package/dist/rendering/world3d/Terrain3D.d.ts +21 -0
  129. package/dist/rendering/world3d/Terrain3D.js +25 -1
  130. package/dist/rendering/world3d/Text3D.d.ts +5 -0
  131. package/dist/rendering/world3d/Text3D.js +2 -0
  132. package/dist/rendering/world3d/Texture3D.d.ts +16 -1
  133. package/dist/rendering/world3d/Texture3D.js +19 -1
  134. package/dist/rendering/world3d/Trail3D.d.ts +3 -0
  135. package/dist/rendering/world3d/Trail3D.js +2 -0
  136. package/dist/rendering/world3d/Vehicle3D.d.ts +5 -0
  137. package/dist/rendering/world3d/Vehicle3D.js +2 -0
  138. package/dist/rendering/world3d/VolumetricFog3D.d.ts +2 -0
  139. package/dist/rendering/world3d/VolumetricFog3D.js +1 -0
  140. package/dist/rendering/world3d/Water3D.d.ts +2 -0
  141. package/dist/rendering/world3d/Water3D.js +1 -0
  142. package/dist/rendering/world3d/core3D.d.ts +2 -0
  143. package/dist/rendering/world3d/debug3D.d.ts +5 -0
  144. package/dist/rendering/world3d/debug3D.js +5 -0
  145. package/dist/rendering/world3d/geometries3D.d.ts +12 -0
  146. package/dist/rendering/world3d/geometries3D.js +5 -0
  147. package/dist/rendering/world3d/helpers3D.d.ts +2 -0
  148. package/dist/rendering/world3d/helpers3D.js +1 -0
  149. package/dist/rendering/world3d/index.d.ts +12 -0
  150. package/dist/rendering/world3d/index.js +6 -0
  151. package/dist/rendering/world3d/math3D.d.ts +36 -0
  152. package/dist/rendering/world3d/math3D.js +35 -0
  153. package/dist/rendering/world3d/primitives3D.d.ts +7 -0
  154. package/dist/rendering/world3d/primitives3D.js +1 -0
  155. package/dist/saveStore.d.ts +18 -3
  156. package/dist/saveStore.js +23 -4
  157. package/dist/semanticList.d.ts +4 -0
  158. package/dist/semanticList.js +1 -0
  159. package/dist/semanticTree.js +11 -4
  160. package/dist/semanticTypes.d.ts +8 -0
  161. package/dist/sequencePlaybackTypes.d.ts +3 -0
  162. package/dist/text.d.ts +1 -0
  163. package/dist/textTable.d.ts +41 -0
  164. package/dist/textTable.js +114 -0
  165. package/dist/tilemapTypes.d.ts +13 -0
  166. package/dist/timer.d.ts +34 -0
  167. package/dist/timer.js +119 -0
  168. package/dist/tweenTypes.d.ts +4 -0
  169. package/dist/ui/controlKeys.d.ts +4 -0
  170. package/dist/ui/controlKeys.js +1 -0
  171. package/dist/ui/controls.d.ts +6 -0
  172. package/dist/ui/controls.js +2 -0
  173. package/dist/ui/layerTypes.d.ts +7 -0
  174. package/dist/ui/rangeControl.d.ts +3 -0
  175. package/dist/ui/rangeControl.js +1 -0
  176. package/dist/ui/scrollControl.d.ts +12 -0
  177. package/dist/ui/scrollControl.js +5 -1
  178. package/dist/ui/stateControls.d.ts +8 -0
  179. package/dist/ui/stateControls.js +3 -0
  180. package/dist/ui/textEditor.d.ts +1 -0
  181. package/dist/ui/textEditor.js +1 -0
  182. package/dist/ui/textEditorTypes.d.ts +7 -0
  183. package/dist/ui/textFieldControl.d.ts +4 -0
  184. package/dist/ui/textFieldControl.js +1 -0
  185. package/dist/ui/theme.d.ts +5 -0
  186. package/dist/ui/theme.js +1 -0
  187. package/dist/ui/types.d.ts +20 -0
  188. package/dist/ui/uiRoot.js +38 -9
  189. package/dist/ui/uiRootModel.d.ts +3 -1
  190. package/dist/ui/uiRootModel.js +8 -2
  191. package/dist/videoTypes.d.ts +3 -0
  192. package/dist/web/BrowserAssetBundle.d.ts +2 -0
  193. package/dist/web/BrowserAudio.d.ts +34 -1
  194. package/dist/web/BrowserAudio.js +69 -39
  195. package/dist/web/BrowserFrameLoop.d.ts +4 -0
  196. package/dist/web/BrowserGame.d.ts +64 -2
  197. package/dist/web/BrowserGame.js +129 -8
  198. package/dist/web/BrowserGamepadInput.d.ts +3 -0
  199. package/dist/web/BrowserHoverInput.d.ts +1 -0
  200. package/dist/web/BrowserImageTextures.d.ts +6 -0
  201. package/dist/web/BrowserInputActions.d.ts +10 -0
  202. package/dist/web/BrowserInputActions.js +4 -1
  203. package/dist/web/BrowserPlay.d.ts +130 -2
  204. package/dist/web/BrowserPlay.js +366 -19
  205. package/dist/web/BrowserPreferences.d.ts +10 -0
  206. package/dist/web/BrowserPreferences.js +39 -0
  207. package/dist/web/BrowserSemantics.d.ts +2 -0
  208. package/dist/web/BrowserStatsPanel.d.ts +10 -0
  209. package/dist/web/BrowserStatsPanel.js +9 -3
  210. package/dist/web/BrowserStorage.d.ts +2 -0
  211. package/dist/web/BrowserTextEditor.d.ts +3 -0
  212. package/dist/web/BrowserTextInput.d.ts +6 -0
  213. package/dist/web/BrowserTextureProvider.d.ts +6 -0
  214. package/dist/web/BrowserVideo.d.ts +13 -1
  215. package/dist/web/BrowserVideo.js +28 -2
  216. package/dist/web/CanvasKitFontSetProvider.d.ts +3 -0
  217. package/dist/web/CanvasKitParagraphProvider.d.ts +4 -0
  218. package/dist/web/CanvasKitParagraphProvider.js +1 -0
  219. package/dist/web/ManifestByteSource.d.ts +4 -0
  220. package/dist/web/ManifestByteSource.js +1 -0
  221. package/dist/web/ManifestFontContentLoader.d.ts +1 -0
  222. package/dist/web/WebGL2Host.js +64 -25
  223. package/dist/web/WebGPUHost.d.ts +13 -0
  224. package/dist/web/WebGPUHost.js +117 -36
  225. package/dist/web/audio.d.ts +2 -2
  226. package/dist/web/audio.js +1 -1
  227. package/dist/web/editorFonts.d.ts +4 -0
  228. package/dist/web/game.d.ts +1 -1
  229. package/dist/web/imageProjections2D.d.ts +2 -0
  230. package/dist/web/kit.d.ts +1 -0
  231. package/dist/web/kit.js +1 -0
  232. package/dist/web/play.d.ts +6 -1
  233. package/dist/web/play.js +4 -1
  234. package/dist/web/playMusic.d.ts +33 -0
  235. package/dist/web/playMusic.js +194 -0
  236. package/dist/web/playTouch.d.ts +45 -0
  237. package/dist/web/playTouch.js +141 -0
  238. package/dist/web/playWidgets.d.ts +71 -0
  239. package/dist/web/playWidgets.js +431 -0
  240. package/dist/web/prepareSharedSubmission2D.js +9 -3
  241. package/dist/web/resources.d.ts +2 -0
  242. package/dist/web/sharedEffectShaders.d.ts +6 -2
  243. package/dist/web/sharedEffectShaders.js +23 -7
  244. package/dist/web/sharedSubmissionStorage2D.js +1 -1
  245. package/dist/web/sharedWebGL2Options.d.ts +3 -0
  246. package/dist/web/sharedWebGL2Options.js +8 -2
  247. package/dist/web/sharedWebGL2Shaders.d.ts +15 -2
  248. package/dist/web/sharedWebGL2Shaders.js +108 -14
  249. package/dist/web/sharedWebGPUOptions.d.ts +5 -1
  250. package/dist/web/sharedWebGPUOptions.js +6 -2
  251. package/dist/web/video.d.ts +1 -1
  252. package/dist/web/webgl2Native.d.ts +3 -1
  253. package/dist/web/webgl2Native.js +9 -5
  254. package/dist/web/webgl2Types.d.ts +18 -0
  255. package/dist/web/webgpuImageResidency.d.ts +5 -2
  256. package/dist/web/webgpuImageResidency.js +7 -3
  257. package/dist/web/webgpuRetentionPool.d.ts +2 -2
  258. package/dist/web/webgpuRetentionPool.js +2 -1
  259. package/dist/web/webgpuSharedPass.d.ts +1 -1
  260. package/dist/web/webgpuSharedPass.js +87 -5
  261. package/dist/web/webgpuSharedResolvePass.d.ts +1 -1
  262. package/dist/web/webgpuSharedResolvePass.js +9 -4
  263. package/dist/web/world3d/Audio3D.d.ts +18 -1
  264. package/dist/web/world3d/Audio3D.js +62 -3
  265. package/dist/web/world3d/BrowserPlay3D.d.ts +115 -2
  266. package/dist/web/world3d/BrowserPlay3D.js +448 -43
  267. package/dist/web/world3d/FlyControls3D.d.ts +4 -0
  268. package/dist/web/world3d/FlyControls3D.js +2 -0
  269. package/dist/web/world3d/FollowControls3D.d.ts +3 -0
  270. package/dist/web/world3d/FollowControls3D.js +2 -0
  271. package/dist/web/world3d/OrbitControls3D.d.ts +3 -0
  272. package/dist/web/world3d/OrbitControls3D.js +2 -0
  273. package/dist/web/world3d/TransformControls3D.d.ts +5 -2
  274. package/dist/web/world3d/TransformControls3D.js +7 -4
  275. package/dist/web/world3d/WebGL2Renderer3D.d.ts +3 -0
  276. package/dist/web/world3d/WebGL2Renderer3D.js +2 -0
  277. package/dist/web/world3d/WebGPURenderer3D.d.ts +2 -0
  278. package/dist/web/world3d/WebGPURenderer3D.js +1 -0
  279. package/dist/web/world3d/World3DView.d.ts +3 -0
  280. package/dist/web/world3d/World3DView.js +2 -0
  281. package/dist/web/world3d/app3D.d.ts +7 -0
  282. package/dist/web/world3d/app3D.js +1 -0
  283. package/dist/web/world3d/assets3D.d.ts +1 -0
  284. package/dist/web/world3d/atmosphere3D.d.ts +9 -0
  285. package/dist/web/world3d/atmosphere3D.js +19 -4
  286. package/dist/web/world3d/canvasFont3D.d.ts +21 -0
  287. package/dist/web/world3d/canvasFont3D.js +165 -0
  288. package/dist/web/world3d/frame3D.d.ts +2 -0
  289. package/dist/web/world3d/host3D.d.ts +1 -0
  290. package/dist/web/world3d/index.d.ts +4 -2
  291. package/dist/web/world3d/index.js +2 -1
  292. package/dist/web/world3d/loaders3D.d.ts +1 -0
  293. package/dist/web/world3d/markers3D.d.ts +4 -0
  294. package/dist/web/world3d/overlay3D.d.ts +19 -0
  295. package/dist/web/world3d/overlay3D.js +21 -4
  296. package/dist/web/world3d/post3D.d.ts +4 -0
  297. package/dist/web/world3d/post3D.js +3 -0
  298. package/dist/web/world3d/probe3D.d.ts +1 -0
  299. package/dist/web/world3d/stats3D.d.ts +3 -0
  300. package/dist/web/world3d/stats3D.js +1 -0
  301. package/dist/web/world3d/webGL2FrameMetrics3D.d.ts +5 -0
  302. package/dist/web/world3d/webgpu.d.ts +2 -0
  303. package/dist/web/world3d/webgpu.js +1 -0
  304. package/package.json +3 -3
@@ -0,0 +1,431 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ // What most games of the play kind draw for themselves: bars, short notices, a box of words that is read and
3
+ // answered, and a menu. Each is made of the game's own sprites and texts on its ui layer, so it scrolls with nothing,
4
+ // fades and is removed as they are, and a restart takes it away. Every one answers the keyboard, the pointer and a
5
+ // finger alike.
6
+ import { Sprite } from '@egret/engine';
7
+ /** A bar of health, time or power. Setting `value` slides it there; a fall leaves a pale trail that catches up. */
8
+ export class PlayBar extends Sprite {
9
+ #value;
10
+ #max;
11
+ #color;
12
+ #shown;
13
+ #trail;
14
+ #width;
15
+ #height;
16
+ #back;
17
+ #drawn = '';
18
+ constructor(width, height, value, max, color, back) {
19
+ super();
20
+ this.#width = width;
21
+ this.#height = height;
22
+ this.#max = max;
23
+ this.#value = this.#shown = this.#trail = Math.max(0, Math.min(max, value));
24
+ this.#color = color;
25
+ this.#back = back;
26
+ this.draw();
27
+ }
28
+ get value() {
29
+ return this.#value;
30
+ }
31
+ set value(next) {
32
+ if (typeof next === 'number' && Number.isFinite(next))
33
+ this.#value = Math.max(0, Math.min(this.#max, next));
34
+ }
35
+ get max() {
36
+ return this.#max;
37
+ }
38
+ set max(next) {
39
+ if (typeof next !== 'number' || !Number.isFinite(next) || next <= 0)
40
+ return;
41
+ this.#max = next;
42
+ this.#value = Math.min(this.#value, next);
43
+ }
44
+ get color() {
45
+ return this.#color;
46
+ }
47
+ set color(next) {
48
+ if (Number.isInteger(next) && next >= 0 && next <= 0xffffff)
49
+ this.#color = next;
50
+ }
51
+ /** Moves what is shown towards the value, by the seconds since the last step. */
52
+ step(seconds) {
53
+ const toward = (from, rate) => Math.abs(this.#value - from) < this.#max / 1000
54
+ ? this.#value
55
+ : from + (this.#value - from) * Math.min(1, rate * seconds);
56
+ this.#shown = toward(this.#shown, 14);
57
+ // The trail of a fall waits a moment, then follows; a rise has no trail.
58
+ this.#trail = this.#trail < this.#shown ? this.#shown : toward(this.#trail, 3);
59
+ this.draw();
60
+ }
61
+ draw() {
62
+ const w = this.#width, h = this.#height, full = (this.#shown / this.#max) * w, trail = (this.#trail / this.#max) * w, key = full.toFixed(1) + ':' + trail.toFixed(1) + ':' + this.#color;
63
+ if (key === this.#drawn)
64
+ return;
65
+ this.#drawn = key;
66
+ const g = this.graphics.clear(), round = Math.min(h / 2, 6);
67
+ g.beginFill(this.#back).drawRoundRect(0, 0, w, h, round).endFill();
68
+ if (trail > full + 0.5)
69
+ g.beginFill(0xffffff, 0.55)
70
+ .drawRect(full, 1, trail - full, h - 2)
71
+ .endFill();
72
+ if (full > 0.5) {
73
+ g.beginFill(this.#color)
74
+ .drawRoundRect(0, 0, Math.max(full, Math.min(h, w)), h, round)
75
+ .endFill();
76
+ g.beginFill(0xffffff, 0.18)
77
+ .drawRect(2, 1, Math.max(0, full - 4), Math.max(1, h * 0.3))
78
+ .endFill();
79
+ }
80
+ }
81
+ }
82
+ /** How wide words are in units of their size: a character of Chinese, Japanese or Korean is one, any other about half. */
83
+ const wide = (character) => /[⺀-鿿가-힯豈-﫿＀-￯]/.test(character);
84
+ const measure = (words) => {
85
+ let units = 0;
86
+ for (const character of words)
87
+ units += wide(character) ? 1 : 0.55;
88
+ return units;
89
+ };
90
+ /** Breaks words into lines no wider than `units`: at a space where there is one, between any two wide characters. */
91
+ export function wrapPlayWords(words, units) {
92
+ const lines = [];
93
+ for (const paragraph of words.split('\n')) {
94
+ let line = '', lineUnits = 0;
95
+ const pieces = paragraph.match(/[⺀-鿿가-힯豈-﫿＀-￯]|\s+|[^\s⺀-鿿가-힯豈-﫿＀-￯]+/g) ?? [];
96
+ for (const piece of pieces) {
97
+ const size = measure(piece);
98
+ if (lineUnits + size > units && line.trim() !== '') {
99
+ lines.push(line.trimEnd());
100
+ line = /^\s+$/.test(piece) ? '' : piece;
101
+ lineUnits = line === '' ? 0 : size;
102
+ continue;
103
+ }
104
+ line += piece;
105
+ lineUnits += size;
106
+ }
107
+ lines.push(line.trimEnd());
108
+ }
109
+ return lines;
110
+ }
111
+ const NEXT = ['space', 'enter', 'z', 'pad:a'], UP = ['up', 'w', 'pad:up'], DOWN = ['down', 's', 'pad:down'];
112
+ /** The widgets of one game. `tick` is called once a step, also while the game is paused, with seconds of the wall. */
113
+ export function createPlayWidgets(game, wake = () => { }) {
114
+ const finite = (value) => typeof value === 'number' && Number.isFinite(value);
115
+ const colour = (value, fallback) => Number.isInteger(value) && value >= 0 && value <= 0xffffff ? value : fallback;
116
+ let bars = [];
117
+ let toasts = [];
118
+ // What is open: a box of words being read, and a list being chosen from. At most one of each at a time.
119
+ let talking;
120
+ let menu;
121
+ let queue = [];
122
+ const tap = (node, run) => game.onTap(node, run);
123
+ const click = () => {
124
+ try {
125
+ game.sfx.play('click', { volume: 0.5 });
126
+ }
127
+ catch {
128
+ // Sound never stops a game.
129
+ }
130
+ };
131
+ /** A column of answers to choose from, each a bar that can be tapped. */
132
+ const choose = (items, layer, left, top, width, size, color, finish) => {
133
+ const height = Math.round(size * 1.9), rows = [];
134
+ const choice = { items, rows, color, width, selected: 0, finish };
135
+ items.forEach((item, index) => {
136
+ const back = game.sprite(undefined, layer);
137
+ back.x = left;
138
+ back.y = top + index * (height + 6);
139
+ const label = game.text(item, { x: 16, y: height / 2, size, baseline: 'middle', layer: back });
140
+ tap(back, () => {
141
+ choice.selected = index;
142
+ paint(choice);
143
+ click();
144
+ finish(index);
145
+ });
146
+ rows.push({ back, label });
147
+ });
148
+ paint(choice, height);
149
+ return choice;
150
+ };
151
+ const paint = (choice, height = choice.rows[0] ? choice.rows[0].label.size * 1.9 : 0) => {
152
+ choice.rows.forEach(({ back, label }, index) => {
153
+ const on = index === choice.selected;
154
+ back.graphics
155
+ .clear()
156
+ .beginFill(on ? choice.color : 0xffffff, on ? 1 : 0.08)
157
+ .drawRoundRect(0, 0, choice.width, Math.round(height), 8)
158
+ .endFill();
159
+ label.color = on ? 0x111827 : 0xffffff;
160
+ });
161
+ };
162
+ /** The size of the words of a box, and how many lines fit under its name. */
163
+ const boxOf = (named) => {
164
+ const size = Math.max(14, Math.round(game.height / 22)), h = Math.max(size * 4.6, Math.round(game.height * 0.28)), top = 14 + (named ? Math.round(size * 1.3) : 0), step = Math.round(size * 1.35);
165
+ return { size, width: game.width - 32 - 36, lines: Math.max(1, Math.floor((h - top - 6) / step)) };
166
+ };
167
+ const pagesOf = (words, named) => {
168
+ const { size, width, lines } = boxOf(named), all = wrapPlayWords(words, width / size), pages = [];
169
+ for (let at = 0; at < all.length; at += lines)
170
+ pages.push(all.slice(at, at + lines).join('\n'));
171
+ return pages.length > 0 ? pages : [''];
172
+ };
173
+ /** Moves the choice by the keys or a stick, and gives true when it is taken. */
174
+ const steer = (choice) => {
175
+ const keys = game.keys, count = choice.items.length;
176
+ let move = keys.pressed(...UP) ? -1 : keys.pressed(...DOWN) ? 1 : 0;
177
+ // The arrows and W and S count in the axis too; a stick moves the choice only when none of them is held.
178
+ if (keys.down(...UP, ...DOWN))
179
+ steered = true;
180
+ const stick = keys.axis().y;
181
+ if (move === 0 && Math.abs(stick) > 0.6) {
182
+ if (!steered)
183
+ move = stick > 0 ? 1 : -1;
184
+ steered = true;
185
+ }
186
+ else if (Math.abs(stick) < 0.3)
187
+ steered = false;
188
+ if (move !== 0) {
189
+ choice.selected = (choice.selected + move + count) % count;
190
+ paint(choice);
191
+ click();
192
+ }
193
+ return keys.pressed(...NEXT);
194
+ };
195
+ let steered = false;
196
+ const PANEL = 0x0b1020;
197
+ const panelOf = (x, y, w, h, alpha = 0.88) => {
198
+ const panel = game.sprite(g => {
199
+ g.beginFill(PANEL, alpha).drawRoundRect(0, 0, w, h, 12).endFill();
200
+ g.lineStyle(2, 0xffffff, 0.18).drawRoundRect(1, 1, w - 2, h - 2, 11);
201
+ }, game.ui);
202
+ panel.x = x;
203
+ panel.y = y;
204
+ return panel;
205
+ };
206
+ const widgets = {
207
+ bar(o) {
208
+ if (o === null || typeof o !== 'object' || !finite(o.x) || !finite(o.y))
209
+ throw new TypeError('a bar takes { x, y }');
210
+ const w = finite(o.width) && o.width > 0 ? o.width : 120, h = finite(o.height) && o.height > 0 ? o.height : 12, max = finite(o.max) && o.max > 0 ? o.max : 1;
211
+ const bar = game.scope.use(new PlayBar(w, h, finite(o.value) ? o.value : max, max, colour(o.color, 0x22c55e), colour(o.back, 0x1f2937)));
212
+ bar.x = o.x;
213
+ bar.y = o.y;
214
+ (o.layer instanceof Sprite ? o.layer : game.ui).addChild(bar);
215
+ bars.push(bar);
216
+ return bar;
217
+ },
218
+ toast(words, o = {}) {
219
+ const size = Math.max(14, Math.round(game.height / 24)), seconds = finite(o?.seconds) && o.seconds > 0 ? o.seconds : 2, w = Math.min(game.width - 32, measure(String(words)) * size + 40), h = Math.round(size * 2);
220
+ toasts = toasts.filter(node => !node.isDisposed && node.parent !== null);
221
+ const node = game.sprite(g => {
222
+ g.beginFill(0x0b1020, 0.85)
223
+ .drawRoundRect(-w / 2, 0, w, h, h / 2)
224
+ .endFill();
225
+ }, game.ui);
226
+ node.x = game.width / 2;
227
+ node.y = 12 + toasts.length * (h + 6);
228
+ game.text(String(words), {
229
+ y: h / 2,
230
+ size,
231
+ align: 'center',
232
+ baseline: 'middle',
233
+ color: colour(o?.color, 0xffffff),
234
+ layer: node
235
+ });
236
+ toasts.push(node);
237
+ node.alpha = 0;
238
+ game
239
+ .tween(node)
240
+ .to({ alpha: 1 }, 0.15)
241
+ .wait(seconds)
242
+ .to({ alpha: 0 }, 0.3)
243
+ .call(() => game.remove(node));
244
+ },
245
+ say(words, o = {}) {
246
+ // Words longer than a box holds are shown a box at a time; the answers, if any, come with the last.
247
+ const pages = pagesOf(String(words), typeof o?.who === 'string' && o.who !== '');
248
+ const { choices: _answers, ...rest } = o ?? {};
249
+ for (const page of pages.slice(0, -1))
250
+ void widgets.sayPage(page, rest);
251
+ return widgets.sayPage(pages[pages.length - 1], o);
252
+ },
253
+ sayPage(words, o = {}) {
254
+ const choices = Array.isArray(o?.choices) && o.choices.length > 0 ? o.choices.map(String) : undefined;
255
+ return new Promise(resolve => {
256
+ const open = () => {
257
+ const margin = 16, w = game.width - 2 * margin, size = Math.max(14, Math.round(game.height / 22)), h = Math.max(size * 4.6, Math.round(game.height * 0.28)),
258
+ // Opaque, so the covers that hide words not yet shown are the panel's own colour.
259
+ panel = panelOf(margin, game.height - h - margin, w, h, 1), color = colour(o?.color, 0xfacc15);
260
+ let top = 14;
261
+ if (typeof o?.who === 'string' && o.who !== '') {
262
+ game.text(o.who, { x: 18, y: 10, size: Math.round(size * 0.9), bold: true, color, layer: panel });
263
+ top += Math.round(size * 1.3);
264
+ }
265
+ const lines = wrapPlayWords(String(words), (w - 36) / size), total = lines.reduce((sum, line) => sum + [...line].length, 0), step = Math.round(size * 1.35);
266
+ // Each line is drawn whole once; a cover over it moves right as its letters appear. Changing the words
267
+ // themselves each step would draw them again each step.
268
+ const body = lines.map((line, index) => game.text(line, { x: 18, y: top + index * step, size, layer: panel }));
269
+ const covers = lines.map((_, index) => {
270
+ const cover = game.sprite(g => g.beginFill(PANEL).drawRect(0, 0, 1, step).endFill(), panel);
271
+ cover.x = 16;
272
+ cover.y = top + index * step - 2;
273
+ cover.scaleX = w - 32;
274
+ return cover;
275
+ });
276
+ const hint = game.text('▼', {
277
+ x: w - 22,
278
+ y: h - size - 8,
279
+ size: Math.round(size * 0.7),
280
+ color,
281
+ layer: panel
282
+ });
283
+ hint.visible = false;
284
+ const speed = finite(o?.speed) && o.speed >= 0 ? o.speed : 40;
285
+ const record = {
286
+ panel,
287
+ words: body,
288
+ covers,
289
+ lines,
290
+ total,
291
+ shown: speed === 0 ? total : 0,
292
+ speed,
293
+ hint,
294
+ choice: undefined,
295
+ choices,
296
+ armed: false,
297
+ color,
298
+ finish(index) {
299
+ // A tap and a key in one step answer once.
300
+ if (talking !== record)
301
+ return;
302
+ talking = undefined;
303
+ game.remove(panel);
304
+ resolve(index);
305
+ const next = queue.shift();
306
+ next?.();
307
+ }
308
+ };
309
+ talking = record;
310
+ show();
311
+ };
312
+ if (talking === undefined)
313
+ open();
314
+ else
315
+ queue.push(open);
316
+ wake();
317
+ });
318
+ },
319
+ menu(items, o = {}) {
320
+ if (!Array.isArray(items) || items.length === 0)
321
+ throw new TypeError('a menu takes a list of items');
322
+ const list = items.map(String);
323
+ return new Promise(resolve => {
324
+ menu?.choice.finish(-1);
325
+ const size = Math.max(14, Math.round(game.height / 20)), row = Math.round(size * 1.9) + 6, titleLines = typeof o?.title === 'string' ? o.title.split('\n') : [], longest = Math.max(...list.map(measure), ...titleLines.map(line => measure(line) * 1.2)), w = finite(o?.width) && o.width > 0 ? o.width : Math.min(game.width - 32, longest * size + 64), titled = typeof o?.title === 'string' && o.title !== '',
326
+ // A title of several lines takes as many lines of room, so the first item is never under it.
327
+ titleHeight = titled ? Math.round(size * (0.35 + 1.45 * titleLines.length)) : 0, h = list.length * row + 24 + titleHeight, x = (finite(o?.x) ? o.x : game.width / 2) - w / 2, y = (finite(o?.y) ? o.y : game.height / 2) - h / 2;
328
+ const panel = panelOf(x, y, w, h);
329
+ if (titled)
330
+ game.text(o.title, {
331
+ x: w / 2,
332
+ y: 12,
333
+ size: Math.round(size * 1.1),
334
+ bold: true,
335
+ align: 'center',
336
+ layer: panel
337
+ });
338
+ const opened = { panel };
339
+ opened.choice = choose(list, panel, 12, titled ? titleHeight + 8 : 12, w - 24, size, colour(o?.color, 0xfacc15), index => {
340
+ if (menu !== opened)
341
+ return;
342
+ menu = undefined;
343
+ game.remove(panel);
344
+ if (index >= 0)
345
+ resolve(index);
346
+ });
347
+ menu = opened;
348
+ wake();
349
+ });
350
+ },
351
+ get asking() {
352
+ return talking !== undefined || menu !== undefined;
353
+ },
354
+ tick(seconds) {
355
+ bars = bars.filter(bar => !bar.isDisposed);
356
+ for (const bar of bars)
357
+ bar.step(seconds);
358
+ if (menu !== undefined) {
359
+ const open = menu;
360
+ if (steer(open.choice)) {
361
+ click();
362
+ open.choice.finish(open.choice.selected);
363
+ }
364
+ return;
365
+ }
366
+ if (talking === undefined)
367
+ return;
368
+ const open = talking;
369
+ if (game.pointer.pressed)
370
+ open.armed = true;
371
+ const pressed = game.keys.pressed(...NEXT) || (open.armed && game.pointer.released);
372
+ if (open.choice !== undefined) {
373
+ if (steer(open.choice)) {
374
+ click();
375
+ open.choice.finish(open.choice.selected);
376
+ }
377
+ return;
378
+ }
379
+ if (open.shown < open.total) {
380
+ if (pressed)
381
+ open.shown = open.total;
382
+ else
383
+ open.shown = Math.min(open.total, open.shown + open.speed * seconds);
384
+ show();
385
+ return;
386
+ }
387
+ if (open.choices !== undefined)
388
+ return;
389
+ if (pressed) {
390
+ click();
391
+ open.finish(undefined);
392
+ }
393
+ },
394
+ reset() {
395
+ // A restart has taken their sprites; what was being awaited is not answered.
396
+ bars = [];
397
+ toasts = [];
398
+ talking = undefined;
399
+ menu = undefined;
400
+ queue = [];
401
+ }
402
+ };
403
+ /** Shows as many letters as have appeared, and the answers once all have. */
404
+ function show() {
405
+ const open = talking;
406
+ if (open === undefined)
407
+ return;
408
+ let left = Math.floor(open.shown);
409
+ open.lines.forEach((line, index) => {
410
+ const characters = [...line], cover = open.covers[index], shown = Math.max(0, Math.min(characters.length, left));
411
+ left -= characters.length;
412
+ const from = 18 + measure(characters.slice(0, shown).join('')) * open.words[index].size;
413
+ cover.visible = shown < characters.length;
414
+ cover.x = from;
415
+ cover.scaleX = Math.max(1, game.width - 48 - from);
416
+ });
417
+ const done = open.shown >= open.total;
418
+ open.hint.visible = done && open.choices === undefined;
419
+ if (done && open.choices !== undefined && open.choice === undefined) {
420
+ const size = open.words[0].size, row = Math.round(size * 1.9) + 6, w = Math.min(game.width - 32, Math.max(...open.choices.map(measure)) * size + 64), x = game.width - 16 - w, y = open.panel.y - open.choices.length * row - 20;
421
+ const holder = panelOf(x, y, w, open.choices.length * row + 14);
422
+ const close = open.finish;
423
+ open.choice = choose(open.choices, holder, 8, 8, w - 16, size, open.color, index => {
424
+ game.remove(holder);
425
+ close(index);
426
+ });
427
+ }
428
+ }
429
+ return widgets;
430
+ }
431
+ //# sourceMappingURL=playWidgets.js.map
@@ -1,5 +1,6 @@
1
1
  import { packSharedDraws2D, packSharedRegions2D, SHARED_REGION_WINDOW_2D, SHARED_REGION_WINDOW_BYTES_2D } from '../rendering/packSharedDraws2D.js';
2
2
  import { noteOwnedPreparationFailure } from '../rendering/ownedPreparationFailure2D.js';
3
+ import { sharedPageChainBytes2D } from '../rendering/sharedColor2D.js';
3
4
  import { SharedStorageError2D, planSharedStorageFees2D, withSharedReadbackLayout2D, checkSharedCapacity2D as checkSharedStorageCapacity2D, materializeSharedPages2D as materializeSharedStoragePages2D } from './sharedSubmissionStorage2D.js';
4
5
  // Retain the existing error constructor identity and private WebGPU callable types.
5
6
  export { SharedStorageError2D } from './sharedSubmissionStorage2D.js';
@@ -28,11 +29,16 @@ export function planSharedSubmission2D(prepared, options, hardware, owner, readb
28
29
  SHARED_REGION_WINDOW_BYTES_2D >
29
30
  hardware.maxBufferSize)
30
31
  failDevice();
31
- const views = prepared.frame.pages.map(page => {
32
- const image = page.source;
32
+ const views = prepared.frame.pages.map((page, index) => {
33
+ const image = page.source, levels = prepared.pageLevels?.[index] ?? 1;
33
34
  if (image.width > hardware.maxTextureDimension2D || image.height > hardware.maxTextureDimension2D)
34
35
  failDevice();
35
- return { image, region: { x: 0, y: 0, width: image.width, height: image.height }, byteLength: image.byteLength };
36
+ return {
37
+ image,
38
+ region: { x: 0, y: 0, width: image.width, height: image.height },
39
+ byteLength: levels === 1 ? image.byteLength : sharedPageChainBytes2D(image.width, image.height, levels),
40
+ levels
41
+ };
36
42
  });
37
43
  const projectionPlan = {
38
44
  views,
@@ -8,11 +8,13 @@ import type { ManifestTextureProviderStatus } from './BrowserTextureProvider.js'
8
8
  export { createManifestByteSource } from './ManifestByteSource.js';
9
9
  export type { ManifestByteSource, ManifestByteSourceOptions, ManifestByteSourceStatus } from './ManifestByteSource.js';
10
10
  export type { ManifestTextureProvider, ManifestTextureProviderStatus } from './BrowserTextureProvider.js';
11
+ /** A manifest texture provider to make: the ports it decodes with. */
11
12
  export interface ManifestTextureProviderOptions {
12
13
  readonly ports?: BrowserPngPorts;
13
14
  }
14
15
  /** Source authentication precedes every caller-controlled options read. */
15
16
  export declare function createManifestTextureProvider(source: ManifestByteSource, options?: ManifestTextureProviderOptions): ManifestTextureProvider;
17
+ /** A content loader for a manifest in the browser: its status, and a call that closes it. */
16
18
  export interface ManifestContentLoader extends ContentLoader {
17
19
  close(): Promise<void>;
18
20
  getStatus(): Readonly<{
@@ -4,6 +4,10 @@ export type SharedEffectPass = 'horizontal' | 'vertical' | 'spread' | 'composite
4
4
  export declare const EFFECT_PASSES: readonly SharedEffectPass[];
5
5
  /** The bytes of one group's uniform, as prepareEffects2D fills it. */
6
6
  export declare const EFFECT_UNIFORM_BYTES: number;
7
- export declare function sharedEffectGLSL(mode: SharedEffectPass): string;
8
- export declare function createSharedEffectPipeline(shader: (d: GPUShaderModuleDescriptor) => GPUShaderModule, pipeline: (d: GPURenderPipelineDescriptor) => Promise<GPURenderPipeline>, mode: SharedEffectPass): Promise<GPURenderPipeline>;
7
+ /**
8
+ * In a target that mixes stored codes the colour already is as it is seen, so the matrix reads and writes it
9
+ * without the transfer.
10
+ */
11
+ export declare function sharedEffectGLSL(mode: SharedEffectPass, srgb?: boolean): string;
12
+ export declare function createSharedEffectPipeline(shader: (d: GPUShaderModuleDescriptor) => GPUShaderModule, pipeline: (d: GPURenderPipelineDescriptor) => Promise<GPURenderPipeline>, mode: SharedEffectPass, srgb?: boolean): Promise<GPURenderPipeline>;
9
13
  //# sourceMappingURL=sharedEffectShaders.d.ts.map
@@ -3,7 +3,11 @@ export const EFFECT_PASSES = ['horizontal', 'vertical', 'spread', 'composite'];
3
3
  const VECTORS = 36;
4
4
  /** The bytes of one group's uniform, as prepareEffects2D fills it. */
5
5
  export const EFFECT_UNIFORM_BYTES = VECTORS * 16;
6
- export function sharedEffectGLSL(mode) {
6
+ /**
7
+ * In a target that mixes stored codes the colour already is as it is seen, so the matrix reads and writes it
8
+ * without the transfer.
9
+ */
10
+ export function sharedEffectGLSL(mode, srgb = false) {
7
11
  return (`#version 300 es
8
12
  precision highp float;
9
13
  precision highp int;
@@ -20,9 +24,15 @@ bool inside(vec2 point,int base) {
20
24
  vec2 p=localPoint(point,base)-params[base+1].zw;
21
25
  return all(greaterThanEqual(p,vec2(0.0)))&&all(lessThan(p,params[base+2].xy));
22
26
  }
23
- vec3 decodeColor(vec3 c){return mix(c/12.92,pow((c+0.055)/1.055,vec3(2.4)),step(vec3(0.04045),c));}
27
+ ` +
28
+ (srgb
29
+ ? `vec3 decodeColor(vec3 c){return c;}
30
+ vec3 encodeColor(vec3 c){return c;}
31
+ `
32
+ : `vec3 decodeColor(vec3 c){return mix(c/12.92,pow((c+0.055)/1.055,vec3(2.4)),step(vec3(0.04045),c));}
24
33
  vec3 encodeColor(vec3 c){return mix(c*12.92,1.055*pow(c,vec3(1.0/2.4))-0.055,step(vec3(0.0031308),c));}
25
- float alphaAt(highp sampler2D image,ivec2 p,ivec2 size){return all(greaterThanEqual(p,ivec2(0)))&&all(lessThan(p,size))?texelFetch(image,p,0).a:0.0;}
34
+ `) +
35
+ `float alphaAt(highp sampler2D image,ivec2 p,ivec2 size){return all(greaterThanEqual(p,ivec2(0)))&&all(lessThan(p,size))?texelFetch(image,p,0).a:0.0;}
26
36
  void main(){
27
37
  ivec2 size=textureSize(sourceTexture,0),at=ivec2(gl_FragCoord.xy);
28
38
  ` +
@@ -77,7 +87,7 @@ void main(){
77
87
  `}
78
88
  `);
79
89
  }
80
- export function createSharedEffectPipeline(shader, pipeline, mode) {
90
+ export function createSharedEffectPipeline(shader, pipeline, mode, srgb = false) {
81
91
  const module = shader({
82
92
  code: `
83
93
  struct Params { values:array<vec4<f32>,${VECTORS}> }
@@ -90,9 +100,15 @@ struct Params { values:array<vec4<f32>,${VECTORS}> }
90
100
  `
91
101
  fn localPoint(point:vec2<f32>,base:u32)->vec2<f32>{let m=params.values[base];let t=params.values[base+1u];return vec2<f32>(m.x*point.x+m.z*point.y,m.y*point.x+m.w*point.y)+t.xy;}
92
102
  fn inside(point:vec2<f32>,base:u32)->bool{let p=localPoint(point,base)-params.values[base+1u].zw;return all(p>=vec2<f32>(0.0))&&all(p<params.values[base+2u].xy);}
93
- fn decodeColor(c:vec3<f32>)->vec3<f32>{return select(pow((c+0.055)/1.055,vec3<f32>(2.4)),c/12.92,c<vec3<f32>(0.04045));}
103
+ ` +
104
+ (srgb
105
+ ? `fn decodeColor(c:vec3<f32>)->vec3<f32>{return c;}
106
+ fn encodeColor(c:vec3<f32>)->vec3<f32>{return c;}
107
+ `
108
+ : `fn decodeColor(c:vec3<f32>)->vec3<f32>{return select(pow((c+0.055)/1.055,vec3<f32>(2.4)),c/12.92,c<vec3<f32>(0.04045));}
94
109
  fn encodeColor(c:vec3<f32>)->vec3<f32>{return select(1.055*pow(c,vec3<f32>(1.0/2.4))-0.055,c*12.92,c<vec3<f32>(0.0031308));}
95
- @vertex fn vertexMain(@builtin(vertex_index) index:u32)->@builtin(position) vec4<f32>{let p=array<vec2<f32>,3>(vec2<f32>(-1.0,-1.0),vec2<f32>(3.0,-1.0),vec2<f32>(-1.0,3.0));return vec4<f32>(p[index],0.0,1.0);}
110
+ `) +
111
+ `@vertex fn vertexMain(@builtin(vertex_index) index:u32)->@builtin(position) vec4<f32>{let p=array<vec2<f32>,3>(vec2<f32>(-1.0,-1.0),vec2<f32>(3.0,-1.0),vec2<f32>(-1.0,3.0));return vec4<f32>(p[index],0.0,1.0);}
96
112
  ` +
97
113
  (mode === 'composite'
98
114
  ? `fn glowAt(p:vec2<i32>,size:vec2<i32>)->f32{if(all(p>=vec2<i32>(0))&&all(p<size)){return textureLoad(glowTexture,p,0).a;}return 0.0;}
@@ -148,7 +164,7 @@ fn encodeColor(c:vec3<f32>)->vec3<f32>{return select(1.055*pow(c,vec3<f32>(1.0/2
148
164
  `) +
149
165
  `}`
150
166
  });
151
- const target = { format: 'rgba8unorm-srgb', writeMask: 15 };
167
+ const target = { format: srgb ? 'rgba8unorm' : 'rgba8unorm-srgb', writeMask: 15 };
152
168
  if (mode === 'composite')
153
169
  target.blend = {
154
170
  color: { operation: 'add', srcFactor: 'one', dstFactor: 'one-minus-src-alpha' },
@@ -60,7 +60,7 @@ export function materializeSharedPages2D(storage, cold, owner, diagnostics) {
60
60
  checkSharedCapacity2D(storage, owner, canonicalBytes, sourceCopy);
61
61
  const before = diagnostics?.canonicalBytes;
62
62
  try {
63
- const projections = storage.projectionPlan.views.map((view, index) => cold.has(index) ? copySharedPagePixels(view.image, diagnostics) : undefined);
63
+ const projections = storage.projectionPlan.views.map((view, index) => cold.has(index) ? copySharedPagePixels(view.image, diagnostics, view.levels ?? 1) : undefined);
64
64
  return { projections, canonicalBytes };
65
65
  }
66
66
  catch (cause) {
@@ -13,7 +13,10 @@ export interface SharedWebGL2Configuration extends SharedPreparationOptions2D, S
13
13
  readonly enableEffects: boolean;
14
14
  readonly outputAlpha: 'premultiplied' | 'opaque';
15
15
  readonly restoreTimeoutMs: number;
16
+ /** Where translucent draws mix: `linear` light (the default) or the stored `srgb` codes, as a 2D canvas does. */
17
+ readonly blendSpace: 'linear' | 'srgb';
16
18
  }
19
+ /** A shared WebGL2 host to make: its canvas, what it reports to, and whether it measures frames. */
17
20
  export interface SharedWebGL2HostOptions extends Partial<SharedWebGL2Configuration> {
18
21
  readonly canvas: HTMLCanvasElement;
19
22
  readonly onDiagnostic?: (diagnostic: WebGL2HostDiagnostic) => unknown;
@@ -20,7 +20,8 @@ const DEFAULTS = Object.freeze({
20
20
  // Read and judged after every earlier option, so their arrival changes no earlier refusal.
21
21
  maxFrameRegions: 4096,
22
22
  maxFramePageBytes: 67108864,
23
- maxReadyPageBytes: 134217728
23
+ maxReadyPageBytes: 134217728,
24
+ blendSpace: 'linear'
24
25
  });
25
26
  const KEYS = [
26
27
  'canvas',
@@ -46,7 +47,8 @@ const KEYS = [
46
47
  'measureSharedFrames',
47
48
  'maxFrameRegions',
48
49
  'maxFramePageBytes',
49
- 'maxReadyPageBytes'
50
+ 'maxReadyPageBytes',
51
+ 'blendSpace'
50
52
  ];
51
53
  function object(value) {
52
54
  return typeof value === 'object' && value !== null;
@@ -75,6 +77,10 @@ export function admitSharedWebGL2Options(input) {
75
77
  if (value !== 'premultiplied' && value !== 'opaque')
76
78
  throw new TypeError(key);
77
79
  }
80
+ else if (key === 'blendSpace') {
81
+ if (value !== 'linear' && value !== 'srgb')
82
+ throw new TypeError(key);
83
+ }
78
84
  else {
79
85
  if (typeof value !== 'number' ||
80
86
  !Number.isFinite(value) ||
@@ -10,11 +10,24 @@ export declare const sharedWebGL2LayerEffectFragmentSource = "#version 300 es\np
10
10
  export declare const sharedWebGL2VertexSource = "#version 300 es\nprecision highp float;\nprecision highp int;\nlayout(std140) uniform DrawUniform {\n vec4 viewport;\n vec4 materialLight;\n vec4 materialDark;\n uvec4 pageUnits0;\n uvec4 pageUnits1;\n uvec4 domain;\n uvec4 samplerPolicy;\n uvec4 pageExecution;\n};\n\nlayout(std140) uniform RegionWindow {\n uvec4 regions[1023];\n};\n\nlayout(location = 0) in vec2 position;\nlayout(location = 1) in vec2 uv;\nlayout(location = 2) in vec4 light;\nlayout(location = 3) in vec3 dark;\nlayout(location = 4) in vec2 slotOpacity;\nout vec2 vertexUV;\nout vec4 vertexLight;\nout vec3 vertexDark;\nflat out float drawOpacity;\nflat out uvec4 logicalTrim;\nflat out uvec4 contentOrigin;\nflat out uint quarterTurn;\n// The texture unit that holds the page of the region, and the page's width and height.\nflat out uvec3 pageOfRegion;\nvoid main() {\n // Prepared positions use top-left backing pixels; the GL viewport starts at (0, 0).\n gl_Position = vec4(2.0 * position.x / viewport.x - 1.0,\n 1.0 - 2.0 * position.y / viewport.y, 0.0, 1.0);\n vertexUV = uv;\n vertexLight = light;\n vertexDark = dark;\n drawOpacity = slotOpacity.y;\n\n int row = 3 * int(slotOpacity.x);\n logicalTrim = regions[row];\n contentOrigin = regions[row + 1];\n uvec4 last = regions[row + 2];\n quarterTurn = last.x;\n uint unit = 0u;\n for (int i = 1; i < 4; i++) { if (pageUnits0[i] == last.y) { unit = uint(i); } }\n for (int i = 0; i < 4; i++) { if (pageUnits1[i] == last.y) { unit = uint(i + 4); } }\n pageOfRegion = uvec3(unit, last.zw);\n}\n";
11
11
  /** A draw without a region has no region table to read. */
12
12
  export declare const sharedWebGL2SolidVertexSource = "#version 300 es\nprecision highp float;\nprecision highp int;\nlayout(std140) uniform DrawUniform {\n vec4 viewport;\n vec4 materialLight;\n vec4 materialDark;\n uvec4 pageUnits0;\n uvec4 pageUnits1;\n uvec4 domain;\n uvec4 samplerPolicy;\n uvec4 pageExecution;\n};\n\nlayout(location = 0) in vec2 position;\nlayout(location = 1) in vec2 uv;\nlayout(location = 2) in vec4 light;\nlayout(location = 3) in vec3 dark;\nlayout(location = 4) in vec2 slotOpacity;\nout vec2 vertexUV;\nout vec4 vertexLight;\nout vec3 vertexDark;\nflat out float drawOpacity;\nvoid main() {\n // Prepared positions use top-left backing pixels; the GL viewport starts at (0, 0).\n gl_Position = vec4(2.0 * position.x / viewport.x - 1.0,\n 1.0 - 2.0 * position.y / viewport.y, 0.0, 1.0);\n vertexUV = uv;\n vertexLight = light;\n vertexDark = dark;\n drawOpacity = slotOpacity.y;\n\n}\n";
13
- export declare const sharedWebGL2SolidFragmentSource = "#version 300 es\nprecision highp float;\nprecision highp int;\nlayout(std140) uniform DrawUniform {\n vec4 viewport;\n vec4 materialLight;\n vec4 materialDark;\n uvec4 pageUnits0;\n uvec4 pageUnits1;\n uvec4 domain;\n uvec4 samplerPolicy;\n uvec4 pageExecution;\n};\n\nin vec2 vertexUV;\nin vec4 vertexLight;\nin vec3 vertexDark;\nflat in float drawOpacity;\nlayout(location = 0) out vec4 fragmentColor;\n\nvec4 tinted(vec4 value) {\n float a = clamp(value.a, 0.0, 1.0);\n // A numerical guard after sampling, never a per-tap recipe change.\n vec3 p = clamp(value.rgb, vec3(0.0), vec3(a));\n vec3 v = p * vertexLight.rgb + (vec3(a) - p) * vertexDark;\n float factor = drawOpacity * vertexLight.a * materialLight.a;\n return vec4(factor * (v * materialLight.rgb + (vec3(a) - v) * materialDark.rgb), factor * a);\n}\n\nvoid main() { fragmentColor = tinted(vec4(1.0)); }\n";
13
+ /** The fragment stage of a draw without a region, for a target that mixes light or one that mixes codes. */
14
+ export declare const sharedWebGL2SolidFragment: (srgb: boolean) => string;
15
+ export declare const sharedWebGL2SolidFragmentSource: string;
16
+ /**
17
+ * The fragment stage of a sampled draw. The program of a batch of one page has one page sampler and reads it
18
+ * directly; the program of a batch of several pages has eight and selects by the unit of the region's page.
19
+ */
20
+ /** The fragment stage of a sampled draw, of one page or several, for a target that mixes light or codes. */
21
+ export declare const sampledFragmentSource: (paged: boolean, srgb: boolean) => string;
14
22
  export declare const sharedWebGL2FragmentSource: string;
15
23
  export declare const sharedWebGL2PagedFragmentSource: string;
16
24
  export declare const sharedWebGL2ResolveVertexSource = "#version 300 es\nprecision highp float;\nprecision highp int;\nvoid main() {\n vec2 position = gl_VertexID == 0 ? vec2(-1.0, -1.0) :\n (gl_VertexID == 1 ? vec2(3.0, -1.0) : vec2(-1.0, 3.0));\n gl_Position = vec4(position, 0.0, 1.0);\n}\n";
17
- export declare const sharedWebGL2ResolveFragmentSource = "#version 300 es\nprecision highp float;\nprecision highp int;\nuniform highp sampler2D workingTexture;\nuniform bool opaque;\nlayout(location = 0) out vec4 fragmentColor;\nvec3 encoded(vec3 value) {\n return mix(12.92 * value, 1.055 * pow(value, vec3(1.0 / 2.4)) - vec3(0.055),\n greaterThan(value, vec3(0.0031308)));\n}\nvoid main() {\n // SRGB8_ALPHA8 integer fetch already decodes RGB. Both targets use the same GL row.\n vec4 value = texelFetch(workingTexture, ivec2(gl_FragCoord.xy), 0);\n if (opaque) {\n fragmentColor = vec4(encoded(clamp(value.rgb, vec3(0.0), vec3(1.0))), 1.0);\n return;\n }\n float a = clamp(value.a, 0.0, 1.0);\n vec3 c = clamp(value.rgb, vec3(0.0), vec3(a));\n if (a == 0.0) { fragmentColor = vec4(0.0); }\n else { fragmentColor = vec4(a * encoded(c / a), a); }\n}\n";
25
+ /**
26
+ * Writes the working target to the canvas as it stores colour there: light encoded at the end, or, for a target
27
+ * that mixes codes, the codes as they are.
28
+ */
29
+ export declare const sharedWebGL2ResolveFragment: (srgb: boolean) => string;
30
+ export declare const sharedWebGL2ResolveFragmentSource: string;
18
31
  /** FUNC_ADD for RGB and alpha; admission separately restricts add-preserve to opaque output. */
19
32
  export declare function sharedWebGL2BlendFactors(blend: SharedMaterial2D['blend']): readonly [number, number, number, number];
20
33
  //# sourceMappingURL=sharedWebGL2Shaders.d.ts.map