From fae070bf21fa5b1ea46e6621d035afaa6cbb9673 Mon Sep 17 00:00:00 2001 From: Connor Fitzgerald Date: Sat, 29 Aug 2026 18:59:58 -0400 Subject: [PATCH] Convert wiki and api-specs into documentation modules (#9779) --- .github/ISSUE_TEMPLATE/bug_report.md | 2 +- AGENTS.md | 4 +- README.md | 8 +- deno_webgpu/README.md | 2 +- docs/README.md | 3 + docs/big-picture.png | Bin 149220 -> 0 bytes docs/managing-cargo-dependencies.md | 65 + docs/render_coordinates.png | Bin 8408 -> 0 bytes docs/running-tests-on-android-and-ios.md | 165 +++ docs/texture_coordinates.png | Bin 5597 -> 0 bytes .../features/src/cooperative_matrix/README.md | 4 +- typos.toml | 4 +- wgpu-hal/README.md | 8 +- wgpu-hal/src/lib.rs | 8 +- wgpu-types/src/tokens.rs | 6 +- wgpu/build.rs | 73 + .../best_practices/dos_and_donts.rs | 36 + .../best_practices/middleware.rs | 104 ++ wgpu/src/documentation/best_practices/mod.rs | 8 + wgpu/src/documentation/color/hdr_surfaces.rs | 149 ++ wgpu/src/documentation/color/mod.rs | 6 + wgpu/src/documentation/color/srgb.rs | 119 ++ .../debugging/debugging_applications.rs | 178 +++ wgpu/src/documentation/debugging/mod.rs | 11 + .../documentation/debugging/performance.rs | 16 + .../debugging/vulkan_validation_layers.rs | 57 + wgpu/src/documentation/debugging/xcode.rs | 80 + .../extensions/cooperative_matrices.rs | 41 +- .../documentation/extensions/mesh_shading.rs | 26 +- wgpu/src/documentation/extensions/mod.rs | 7 + .../documentation/extensions/ray_tracing.rs | 61 +- wgpu/src/documentation/features.rs | 16 + .../getting_started/learning_wgpu.rs | 80 + wgpu/src/documentation/getting_started/mod.rs | 9 + .../getting_started/running_the_examples.rs | 39 + .../images/architecture.excalidraw | 1309 +++++++++++++++++ .../documentation/images/architecture.webp | Bin 0 -> 8682 bytes .../src/documentation/images/big-picture.webp | Bin 0 -> 11022 bytes .../src/documentation/images}/big-picture.xml | 0 .../documentation/images/life-of-a-frame.svg | 1 + .../render-pipeline-and-resource-binding.svg | 1 + .../images/render_coordinates.webp | Bin 0 -> 8032 bytes .../images/texture_coordinates.webp | Bin 0 -> 6062 bytes .../documentation/images/xcode-attached.webp | Bin 0 -> 22314 bytes .../images/xcode-build-tool.webp | Bin 0 -> 10576 bytes .../images/xcode-edit-scheme.webp | Bin 0 -> 11706 bytes .../images/xcode-new-project.webp | Bin 0 -> 15516 bytes .../images/xcode-play-button.webp | Bin 0 -> 9928 bytes .../images/xcode-project-type.webp | Bin 0 -> 13418 bytes .../images/xcode-scheme-arguments.webp | Bin 0 -> 14652 bytes .../images/xcode-scheme-options.webp | Bin 0 -> 18772 bytes .../images/xcode-select-binary.webp | Bin 0 -> 11590 bytes .../images/xcode-start-capture.webp | Bin 0 -> 10854 bytes .../documentation/internals/architecture.rs | 269 ++++ .../internals/known_driver_issues.rs | 194 +++ wgpu/src/documentation/internals/mod.rs | 10 + .../internals/reporting_driver_bugs.rs | 35 + wgpu/src/documentation/mod.rs | 19 + wgpu/src/documentation/platforms/android.rs | 24 + wgpu/src/documentation/platforms/angle.rs | 20 + .../src/documentation/platforms/emscripten.rs | 33 + .../platforms/mobile_app_integration.rs | 29 + wgpu/src/documentation/platforms/mod.rs | 13 + .../platforms/vulkan_requirements.rs | 12 + wgpu/src/documentation/platforms/web.rs | 111 ++ wgpu/src/documentation/shaders.rs | 16 + wgpu/src/lib.rs | 199 +-- wgpu/src/macros/mod.rs | 44 + 68 files changed, 3461 insertions(+), 273 deletions(-) create mode 100644 docs/README.md delete mode 100644 docs/big-picture.png create mode 100644 docs/managing-cargo-dependencies.md delete mode 100644 docs/render_coordinates.png create mode 100644 docs/running-tests-on-android-and-ios.md delete mode 100644 docs/texture_coordinates.png create mode 100644 wgpu/src/documentation/best_practices/dos_and_donts.rs create mode 100644 wgpu/src/documentation/best_practices/middleware.rs create mode 100644 wgpu/src/documentation/best_practices/mod.rs create mode 100644 wgpu/src/documentation/color/hdr_surfaces.rs create mode 100644 wgpu/src/documentation/color/mod.rs create mode 100644 wgpu/src/documentation/color/srgb.rs create mode 100644 wgpu/src/documentation/debugging/debugging_applications.rs create mode 100644 wgpu/src/documentation/debugging/mod.rs create mode 100644 wgpu/src/documentation/debugging/performance.rs create mode 100644 wgpu/src/documentation/debugging/vulkan_validation_layers.rs create mode 100644 wgpu/src/documentation/debugging/xcode.rs rename docs/api-specs/cooperative_matrix.md => wgpu/src/documentation/extensions/cooperative_matrices.rs (95%) rename docs/api-specs/mesh_shading.md => wgpu/src/documentation/extensions/mesh_shading.rs (90%) create mode 100644 wgpu/src/documentation/extensions/mod.rs rename docs/api-specs/ray_tracing.md => wgpu/src/documentation/extensions/ray_tracing.rs (91%) create mode 100644 wgpu/src/documentation/features.rs create mode 100644 wgpu/src/documentation/getting_started/learning_wgpu.rs create mode 100644 wgpu/src/documentation/getting_started/mod.rs create mode 100644 wgpu/src/documentation/getting_started/running_the_examples.rs create mode 100644 wgpu/src/documentation/images/architecture.excalidraw create mode 100644 wgpu/src/documentation/images/architecture.webp create mode 100644 wgpu/src/documentation/images/big-picture.webp rename {docs => wgpu/src/documentation/images}/big-picture.xml (100%) create mode 100644 wgpu/src/documentation/images/life-of-a-frame.svg create mode 100644 wgpu/src/documentation/images/render-pipeline-and-resource-binding.svg create mode 100644 wgpu/src/documentation/images/render_coordinates.webp create mode 100644 wgpu/src/documentation/images/texture_coordinates.webp create mode 100644 wgpu/src/documentation/images/xcode-attached.webp create mode 100644 wgpu/src/documentation/images/xcode-build-tool.webp create mode 100644 wgpu/src/documentation/images/xcode-edit-scheme.webp create mode 100644 wgpu/src/documentation/images/xcode-new-project.webp create mode 100644 wgpu/src/documentation/images/xcode-play-button.webp create mode 100644 wgpu/src/documentation/images/xcode-project-type.webp create mode 100644 wgpu/src/documentation/images/xcode-scheme-arguments.webp create mode 100644 wgpu/src/documentation/images/xcode-scheme-options.webp create mode 100644 wgpu/src/documentation/images/xcode-select-binary.webp create mode 100644 wgpu/src/documentation/images/xcode-start-capture.webp create mode 100644 wgpu/src/documentation/internals/architecture.rs create mode 100644 wgpu/src/documentation/internals/known_driver_issues.rs create mode 100644 wgpu/src/documentation/internals/mod.rs create mode 100644 wgpu/src/documentation/internals/reporting_driver_bugs.rs create mode 100644 wgpu/src/documentation/mod.rs create mode 100644 wgpu/src/documentation/platforms/android.rs create mode 100644 wgpu/src/documentation/platforms/angle.rs create mode 100644 wgpu/src/documentation/platforms/emscripten.rs create mode 100644 wgpu/src/documentation/platforms/mobile_app_integration.rs create mode 100644 wgpu/src/documentation/platforms/mod.rs create mode 100644 wgpu/src/documentation/platforms/vulkan_requirements.rs create mode 100644 wgpu/src/documentation/platforms/web.rs create mode 100644 wgpu/src/documentation/shaders.rs diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md index 7ea9519f9..4d16ebca6 100644 --- a/.github/ISSUE_TEMPLATE/bug_report.md +++ b/.github/ISSUE_TEMPLATE/bug_report.md @@ -6,7 +6,7 @@ labels: bug assignees: "" --- - **Description** diff --git a/AGENTS.md b/AGENTS.md index c451abc37..9b2933380 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -88,7 +88,7 @@ behavior in the WebGPU or WGSL specification. # Overview of the Code -See `docs/big-picture.png` for an overview of the system. +See `wgpu/src/documentation/images/big-picture.webp` for an overview of the system. The major components are: @@ -116,7 +116,7 @@ The major components are: apply to other clients, the issue should probably be fixed in `wgpu-core`. For a more detailed discussion of the `wgpu` architecture, refer to -. +wgpu/src/documentation/internals/architecture.rs ## Naga diff --git a/README.md b/README.md index f31db0387..fdeb73783 100644 --- a/README.md +++ b/README.md @@ -24,9 +24,9 @@ Additionally, [WebGPU Fundamentals] is a tutorial for WebGPU which is very simil [Learn Wgpu]: https://sotrh.github.io/learn-wgpu/ [WebGPU Fundamentals]: https://webgpufundamentals.org/ -### Wiki +### Documentation Guides -We have a [wiki](https://github.com/gfx-rs/wgpu/wiki) which has information on useful architecture patterns, debugging tips, and more getting started information. +We ship a set of [documentation modules](https://docs.rs/wgpu/latest/wgpu/documentation/index.html) with information on useful architecture patterns, debugging tips, and more getting started information. ### Need Help? Want to Contribute? @@ -75,7 +75,7 @@ Contributors are welcome! See [CONTRIBUTING.md][contrib] for more information. ✅ = First Class Support 🆗 = Downlevel/Best Effort Support -📐 = Requires the [ANGLE](https://github.com/gfx-rs/wgpu/wiki/Running-on-ANGLE) translation layer (GL ES 3.0 only). On macOS/iOS, use the `angle` feature. On Windows, `gles` uses WGL by default; build with `cfg(windows_angle)` to use ANGLE instead. +📐 = Requires the [ANGLE](https://docs.rs/wgpu/latest/wgpu/documentation/platforms/angle/index.html) translation layer (GL ES 3.0 only). On macOS/iOS, use the `angle` feature. On Windows, `gles` uses WGL by default; build with `cfg(windows_angle)` to use ANGLE instead. 🌋 = Requires the [MoltenVK](https://vulkan.lunarg.com/sdk/home#mac) translation layer 🛠️ = Unsupported, though open to contributions @@ -93,7 +93,7 @@ When running the CTS, use the variables `DENO_WEBGPU_ADAPTER_NAME`, `DENO_WEBGPU ## Repo Overview -For an overview of all the components in the gfx-rs ecosystem, see [the big picture](./docs/big-picture.png). +For an overview of all the components in the gfx-rs ecosystem, see [the big picture](./wgpu/src/documentation/images/big-picture.webp). ## MSRV policy diff --git a/deno_webgpu/README.md b/deno_webgpu/README.md index 3cedd111c..d0d90e351 100644 --- a/deno_webgpu/README.md +++ b/deno_webgpu/README.md @@ -11,7 +11,7 @@ spec becomes more concrete, we will implement to follow the spec more closely. In addition, setting the `DENO_WEBGPU_TRACE` environmental variable will output a -[wgpu trace](https://github.com/gfx-rs/wgpu/wiki/Debugging-wgpu-Applications#tracing-infrastructure) +[wgpu trace](https://docs.rs/wgpu/latest/wgpu/documentation/debugging/debugging_applications/index.html#tracing-infrastructure) to the specified directory. This op crate is tested primarily by running the diff --git a/docs/README.md b/docs/README.md new file mode 100644 index 000000000..327f51b75 --- /dev/null +++ b/docs/README.md @@ -0,0 +1,3 @@ +# `wgpu` Contributor Documentation + +This folder contains documentation for contributors of wgpu. If you're looking for user facing documentation, look at for documentation on `trunk` and for the latest release. diff --git a/docs/big-picture.png b/docs/big-picture.png deleted file mode 100644 index 86d754da9d9e5bcc596c619c3305d3e6bc52570a..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 149220 zcmd3N^$J5?PDV zM6l!!s&ydX2rVVlRpu^&eji z(V+0dl4X$=J!d}jIlcdHf8l~+L5d&?<%~w65LSsF*hQ=%zl>-9=hTNV{+Sbr%+yuS|I&!_&&Y7}R;0=P-(vl% zm*wDK8l_eso-xJ0t>nKN|3B@LV>ZyG|4=fvq&@53_F)4QTptdzZK&(01gb(m8gIsU z$(o3-Qwyewp$Vn2n|85ww6!<<+XpZEB+gHbr2{$`N~EcCT;kp67B(|8gZG;+H6hB& zE$lvu=$M(CcXm6w2k8cozPHLk91J;qdqF3g1v_`$T|EAG1Ehqbfbf9^jdtGx&TsJq zI=ri;WToZjum2RHnF#N)88NyOvd(6=d#$et`2?A+KUMwZCmj`TC5-?Xw_7Ydh2dxx zzmN2a+3pRxz1({4$;p^uf@6|-OaC`h-vEj0VHXLw?+(q%Q^+^ss83foi9}Tz$(u3j z>U8|tUuiT9@(S|ix3CZ$HEuGpdTx^!y!ykw(&mY%|FgRKHKp=*{_vSRFGtV+Zh$Cc zuYuCg&8;oVqv#!tP8)0r^><`=Cknp!2slOh_Pp{-U9rV&aXz-K_4qnX8OMp?rdhQxVfHY9m|e4QqEI~JI^i#4i;F%wrS*B zc`_L^)Znpb$h{-{SkYH1jv$$~{C^Mbf7xNe4Hk+J%mV>*0HIOxbuO}UjlWUA7D%Wr z!TYG8M@=0qCv~2uQK5&OP!x(XCh0>imn1~`dKg=-YWl;wDV41;czMvpP4cXG<{p>1 zJ13jAc7*l7+4k>L{Wm?kK7J>p4i9ddP)j7-YcYY3Pu+zvDlMNOS?8X6FQ<|7p9L|J zGf~M>*jQ;=o4`*nCVVH)0rHoT#!o64GQ$bc#r8>iCkVq^4I|l{qY&}af~vN|(KB-8+X_PYzRS4+HWZEUXYerZ4=A7y| zgBvC}>?%)|w4N;=s3m#%py0pT!bSReED&Tc0d2&HU+ak z3YTGfkRm8qK8b$#VrL`}6lFbqMlSk5(0YI3U*Pp84KgvJ?cr18tYB@0kwBFE(b#}l zyQ~0ID*csz^k8+m!PcA!)G-xs`*52V(s9s>DV7}cbeUb}dudgwT^{#v`uvm~L&PB* zyq-2;>Am1#1*io@wIs9Xs-S9yAz>6+PmoXNO3E^6w-rF>#udvKe+EUNW=j}0IjAfB zHEOxFGBX>m_p#`A4@t-Be!64%H2+nh7mSgl1g&T>y|XG18lg(K`o{}j5w#0#yC5>& z0Rn&fmHsYhY;c^>$WxS&i^A!bfJQ5-gZAl%f`()n@1wB1Ng|8R#@1{&T?}pZ%uDzqa+OyrFZFAjv-lm%G&5|aW`=2Ze+&41t_CzU6CIqO08V~2#L@f`g$twnNbJ3vZ6sZZ>$<$AWN z=2tDrLZkf-&%q$!{e)!VO@^W#0}e-qP%2VK$zyDbo$4_LfceT(^&TdZOjSha2xCoZQmx3F5${&Aeq@oV(wESUR z|7@sAoq9Ku{lr{p(3tT0?Pb_#@BIOj;Pj+7IGSRlv*g#!5Ka7$eRXG%MU;$9rNNcQ zO_y9^o*Vsn2G|RO6o4i0wZFh6_tOH$%^6(EgfxqZ{VNDWMh^5-R4vo1E#tPE)e@28 zjc31I7X5MoBIWmy^Kw{X_P=?m%HC>uIqs%UXM^4Q9Yw{%L=WIs=P0zuwP!^x7|Q^Q z5=i8y1ue!HYYzkmau*DX;uI!OGHisC)yTA8*3NX3C|Vvv&=deLcxf(E}4(l6v2V)KDuCvYTjxcPRQRXXd&H zs$>Y#agXX&m}VFJ#vl3qt*X*M-WX45?6}9C-L%<+x>j{rsq6wz=Hu<{xBQ z(^O`Sd_NvKr784b$&a`qO5rc=)g}2=7@sZT}D2UHBsmb1s zu-uHarSj|E&F%{XlWQUlw~m+=OJS5G+3&9p18Vg+G>w)Heg`u2ZccUZGN8H9DUv;@@<<3 zB6V%PTRZnw46e$T2q!8pKp5vAAdG4xBi2NM*(7TcBv~|($zUuT+F-Rs|2uLLY*^i` z;zS~d2rBlGVK3hc5;!aIwbaelsqq%Zpt2G$L^1&jwo%}<&d84 z-A2(g$tF&@$~Gyy1iYKb?xwVsNLI-dWw9QoJ)C$TS!1yF`}1q>$}+xo>jbRsL&$56 zy(!=ON%D{=)Phx!SdIP|2}~J-3CZ1)hi3U1u}@)x4zm0yAXc#?TaT}?=$Ojv;xh7e z?nLpx>P|#w*+C{Km?*LB6b(XK49j%hYnPNUZJ*qpmft>-aL|m?%1h@)eh489YFd34 zVfm8_xYV@vtJeZmv-o4D1?V>Wy(<9|1&>BVsq3Azx(Qk(_}v1a zpP1)x_>cE8gNWa?1}u3Ejjv(D6D*e&)?)Od-h8F4@#5OhS^U_t2r^799X$d<^&VNd zS*5Z3DV4wcmQU`TZ5Lsa6)nekM~0y1oUnf|>N#^2sI-Ra*+3D%4RjNGeyERYrBi~# z&-LoFYs6pl?CTuI=c@bK1kW@>;QF+S}K_ z-tF~`-i2FX7Gp{q*WzkCxt-C#vjToy~Yu+Q56?Dg=`Fe z(vZ>^Vah^bp4(Ml+LejOqH|TES=bzq!P9w>(z3kw1vdprP{lHP)w1+kPRTGCoc3}dCcLqot1ls|1pOupE(Fq zk}erM^-Go;?)`AP*WX4W>b~pkckX|BA4XhljU7E0WUuB}{3LHG)io*8sq*|3wj(;ahJG8OE3~b``(vB+ky!?Dt!UWqAGyYiIqtDhSYUYL%)YkR zMG_+ZKlfZbDUe)m#jwiA+HZz>DL;uUHYFm<#zH6(TZC_yP74I_z%Ra?>Ha<0_XwHT zWM+Jp0y!vA+07bLHcKnjRMc}|v0uYUNSeyMmGafyh{U>F$2id2eyhpR%{czVr#iLc z>7ZC*t-Uo!?Dor3XpUoRuIlM=_Ef4(2-@%nqK)qZ&GH7lZJYQsh&0vx%wW>p6#+~p zsbxbXdO3@Gam=OqH-Q>Rj0Tem3mvd<^^1V=N#;Yqt);sR{!S_LV3CQ|zx=R?w5}@9v-!JSGCF=8(x% z(I+oDC2VZyyh#a}yBE>!Pa|$Wt#NAjH^iR~!cZ3l`vPRNw`g$@-Q)TS?o2e7OISsj zZddg=v2uJ@*t#?1WLDyXDFv266QL;|+aAgMPi2 z0)4yJpMn;to_eLwiCBEmFrxRP)>zr{@cr{UF!Tcqk5!9L#GSV0SvcEdDd_PlIsH~+ z=U!IC>{g|(W{WkRG{j>R!&e!jyP-x|)v=Vtn89nAD_YuMg8b&oiS$dpp`5#kDSZ2n zq$4VLo2NuyGfVoDB>=_^+*k8;|A}`cXFSuI)L=6yt`dsQVH#x-(HBAG3paWT-u~TD z`eNwk&`yg|ze=C(9!i^zwIa|Tg-N--{ZhfV!;?J;+?kyowv#vXlpZecR~1XybWz6> zRtKU)L3rcBt{gmfP|Z?y2t&tTuI8x30z`%+;ipsCK#PbR0IlkFG_3FHU}2>)vdP%8_P zyLd>qMA zf2>eblB|VAL9}dxgY8cvy)ACGFu*PK2G4IVGpBnGf+-{x9oCeqqage^%)-edO4UNq z4*qW}x>{ii3d)+1v;tloI$B!En}j5WTm@T%8Gw~HoNGe~bO~>wZ5L_)#5YAMsbzVL z96qO=m^<>@d+Pf+7Q>vJ2-};x*fgHF!5c*ea|np$E7kVcFh1S))Wp(Uz@PZHU>lgmX$}^SAZwLk z^#bp6U`AU+6)@4k`s}CM;g6wj1>NKQfL|p2Z*cq?}4E?^`+upmqwAgaCr~NV_BM|C2 z9yUPK)xditaW2Png)d{#J~p3u$85nR%}TVv2XH>tNO3w1u5c^k9QRGZRZS zi$67Fh|Kfm_eM4Bt~E*_&IN?stNOW`0J{j zLj!zCzQip1Yys$^9`2_L6)gs0C>rKwd8JVG>TLHA2jf9e8oxxaBqocL4VgkFOosoy zrBk9r#(0U&d+Zga^U0AX!W0|=3e{_QZE{4fX1P!V0^hY{AyPS2u0r3FE!hu!5Tn4r zWbO>6P|ezoElgI3t!l-?8g`UZsx2XIXLD8(aS(t0%;9zQ^LoyxT@M=lu za3QJ9m@y$42Nov(Ij!-Z9rEd85gZ}lqE$l0{iH)}i>0B5*gnqNy7C2eDaeO_Baez=R-o@Hrd2!u=X) z$LsbuDIVT1l|N`_oW-ooJiNI7BX%YW!WCf@3wW;Vc$jv-SaKdP zpKWrK?KFu$F^*-eXBZo;sd>BL<9A#;D6V3~*kdbQKUS9wy)EyQ4)7841NuvhXIQ}7or{SSwy$j+=#nJII8js&=E-8PdkMpF!cd zswbRI!dFT*S{<;D8T9?yam!=$Kw#A7vE_$Z$M9fpRpl__r?DoNj}7+o2wMx{d;}GP z^G%87!tXaSgYITb)zDiqs)qjv;fQk=4_jcJ@!0DW^NStxME3K{qbKA_ItL@Sw&E4F zsMPuC*@{>%-?yT@gxgiqKJ*Mq%16Jx4X%CBEi&heF)4b=6tZ8PykjeIex*@|=49p< z!1!K5B2t-BE&{03(D%j+wF`ZJqtvt>oOQo4aT$hFWQ!ud!DFXWUbZ(TAxDm?nG+G^ zwoNM$Yfl2hBZ3efcM5@5a;W5(8Vh;6hH$)8I#Y1eOHR8FHvY0h$1f9x(zV-o?61)WZK%I~1d$G;* z4XK#n^JX7raslqh9R|q=8J6t+LTNe<3*`0gp_Jrx=7xQeSQa{LyIKG)8*?++BRPxG z9&JHg(b}-}2iQ2FlUyQD@`AJA_{n6bR7d!8aw$&a?aJac9xKN*y7yHv)5bTON1kPxIPrf_c4(-H~6ZIFtV<=6J58p83&+>srG( z-}cYU>Ak5RAz?MGZtxx$Q(M)aF&%~hUBjNie4rSp5&O5J6En7bTGe1ydq$=K*8r?Gs$LLr_^<~$)(?E z7qz-Z-s?olbhCVupjD-%E`sZTJUjxSW6?HtSrtyoQSpRL<)2R05KG#{Fq6lQ{H-+H z-bpc)l3V9yBQ_9e`o8?-Uc~KMgK1N(puOh17wE<=2OQQ= z2M~m$?*hO;xe6#Oh*I>D+}ih)3*eq??szWK}sB2!Ao* z6IZn+Z`_O3C_n)En3}JEb@O!O-A`@rEw(;XjHr4lyHv>JcHtjssW10q6>V~2fTE-; z<)L~Bsdk?8Fp^KOz67zVD_<0m{1j^{UTmM)YE>m9`6aK+0{TzfsYmXIqqe^r{n_V6 zI8%A?kL(-uO|K4lruGIr-&CuIq&+}Kz7n#{P%qY7r}KES2#1;vEEk%~Z2olV**wci zJk}Vcp}E@f>D&fI{S1B?wX9|ViQ~Gb*!{6PJPI`IlZZyZ8fvYs>fjaw`L2fC1Ug{s zt5-0i$#+QQM2YVzvA^F*$&!7VL(0I#KwkuI0TcY9Msf+Ps7CW=tjF!LNZr@0LPjUD z;}=bR;=Z%!N(=zqEk>cW8o8v0O%m&&AeQ8JAb|_TQJzE2{{*jD_@8t3h6u_UFP3RJ zX$8X3LTRav<8amr6NiRq==9Hjgf>^~S%?kV8^Zb~*riDMq6poysT1RWQDyFcO zlCyzV4m!_YHP0(a#UVx+)!c**M@QuSb@HlGCWNG9?(dEJ7pDO5bzz8MJSC%NFG(n1 z{&zR7=(VQPN%B>)?s>VHgY%$tzQK`lcCoK&_0@O_yku?Vw625Ku68Z}k7MfO$JM|+ zN6?sXRV(^SgeJYest4LYmz~1BNoX)Rb8}LDEBnymS38G(YJVLKKr<9`I#3PwTfB+Okk$(b3F9SK+i&dR|Ee_7FcN*C#Igux#OUi&uM#XhuW5|Vsb0{NbkM)sS{UY16x zx= zfd#F>=)Gmyd^QB|A4)XXWCngna$20J8PO=<TLZw3--F~){k0_hxRDZVS2U;|%=6huVjg6SiMF9ASM z9E_%pq^t$LsgnKl&2P2kqi=)FluGBctK(uxaX%p>BKDU!=1k`T_x}8;fo25i(F42` zm(li27=~-AxhbvW^!A_)IE1kf83`lZxZ@On_JK$~a#=k@?!k^I@$J7w#vp-T&P=ct zqp3`FyT@+@5Q1nNY3*sF;{l!0K`F)Hk?R(SYKYXDTnq8nqAleLZLm5NQ?vL>E^R`q zp>SFMEJA9lVO0oU6x8mC@)GtJHt`l)gNUMA+vHWq{Vqwq;6kH4`)p&IX}HD34htn= zj?>RuAf`$Z*;$dRigNaKs$ZHx(*fhC|MBm}dK}3>E99ZxVm>%8*HK>}{T}6uB5M4@ z*YZV3quc}fXzJl|UE%3dX{Wa~iSIY3T`7txoJrq(UVRB@UY^3x8TOXNevRQ-p|MgY z6F1`lU9Ngh!LEB$)CB=dW!2}APQdqp5$`IkbYrU8nZ0__5!=V%y2Nj-4|8<}yLC6M zXCe0~sc$Z_XK#Xp<{fe;JuU7W5x>V@l$ev08r+AblTY4i zEs1@sUJ^E-ev`vD`u>Sbd#_%m7FQOF6X^PC3qX`^DqOu!Nxjom{hSj#KSiKa^ z9kzI|xjU*;V06HFKf~d0sd0M0+-Zob9|ro^>qFyBet<{JhK|8V)Bs-0EgZ~%M5ELz z8}o}-mijJue!k79kHB%K1uzjV9cw*yCv(sD>hOYe^vyR4vsxW_$ zl2fXBk&w$e<=l`x%8Z{XhMAD8TpB;SLmZHUeGsq!mRWyzzYEMusnIUy)xh1v84cO$ zFn@mM*EnDCW8@_;2JBtik&}r~@=lZ}eA7$FSSk=30&Y-C$F|W+Q`D$myj=CLFoh{( zT!^gMRI#%d9CM>f54oH&4;DHv_Q<^ykIJjUtXox)j-An5WYd&NLwdU6e{H+c@QzcH&Q-KmuMVh)%6AwjAu4L$BYu>y1gp3ip-atuSTlKNoJnNXPO1ELm(Z%($ft z){VZYrDkv4IT~XahZqXt!M?l*B;M^MbYR8l%YC%Ohdbmhi`Rl@SJ8&Y+!v%@w0*!g z5VW);d{C*=BfX4#MIeLr2Fs{fxk-;U#!)`EK-Z(#tw*$Q1ZgN4sv#{sxS#9v8^Rl8 zn^nBnty`3-T#kA~ByJHQ@0GxA=K9*PJ^eKqv^|*IO_hA_PXf}%vq#JgM_-&<(e^@v zSU4tCL%1(Z@%k}%MuHXwGcDUE9o zuYeAix1sZ))hH3`gW4&gWW)DrEe)IA2*%UV%NGhS42swTVS!+iAI&)jryRV+d(YGU zv(cXKb!}w$yi?`za%!+z3+GTO@tcFADXim2q^b6G;|Zg$Ncn%nP|b5DB@{Flnc3W| zS9Z(vqyF>&9-`WDggb~JmY4Zn;=Gx(8#Ai0f8T2FA{mJ(rI~M)6JNCEL7#CG!g`Nv zRsapD8}sP%GiOrk_NcfR;@?_sKoS~;;1@~_GTVOF)2!Un)d}JjTqSQVvlNrl7I9X-CcaO1r%h%JY(09 zdwB&^lL5IHg_Kp|&apV_+=uVp(kP_{#@K$r5Vn1Tv`iT&5&DzbBF3M{L2U1X2%BlZ zdHA?9&7GR+5%<-}lI}Tk$c@;&M;%U)$P2v)6@F#elUM{tFfkAsHZ-MmF(TZ<(yv1? zBPHQ=fN<_GQ+3qk^$lnZ?&W)ae5|`89BpL?u#YCeXHELdN7e9!U?40V2`}(7IRU1j zSQXXbpetL-WayF%R^NE@XHe8@fn?2MM4=G?zc+f@zdWB+oA+rkFa?8nmQT7OgoRIO;XTXu-1N79?~B;ZeddIjX1X4< zPI-LxQLg3&2Xv-xZShrN3p!0_Y3sL6L{l#R#cT=$F>kLBv?X+O2wkK14MkVCRZuGZ z!7`DB&0^h(Jg5{Sj7`!(5J{qC%&#;{`Z+fI&}awsg_C3`W7Ss>23nIu@6>vI8QsKT zvqg^n_z9EX35=f7%DbR2G+T}6)nrGK{ zGJPOB)zov(*jtfpd&(t10ExTKhiye)_swMXQbLxtWv4Iw+8ATvZ;qq)!)~j+2^>v? zTS_<*l2|~U>h9|_dbm65LYIQJSpm5ncfU^jR7Yl;nrPu?MBE!5JY3oXVL3z$X^d8> z;#QVZ_7XcpVopiu=AuVpIyhcp$Vj=~yqcWsGXf@uO&K=x~GRUgP(&5m`51N9Gk`$_NDW2uH0@&^SV>|Ym)+W zvC+P|f8iTt7|Jv*K6Go~+@y7raBTSY$v+=5C}_()U8!Iyk5i=e$?DA@A08;`h>~EH zdKY&fw+s7nT0uIcj~?k0ehAGTi)${jZS?L1bdp;U>UVWezL8F=Ro!`)hhql;?N%;Q zgWy!QxbsNl-_Q>6IU4JfP|6iD++*M1Wm24-LA2bnuo%W|vzld4XSUAlh^yIZseN}Y zLusQpFT8L=?YVs)TabJP&PBY(-!Q9imcydsu?yWCaMeVcZGO+3i z$%&Z}i~=^4K^oWe*Av{B?@St;R>;#?u-nLoP8>U#$JQ?00JjzS>loRdFKpEGgx8zj zZD{F&%IVyk0$vDpx3)Vig?swzQNl+eUS0u|SO8^9ipdh;Sa(Wa3Z#;KBcEd{dxk;>V9EaezHV?D{bZ259F zh9cXJoGY{QBE-yf?XEB>v@;NU_$;jMZHAoHm)O2hrZrH*PLy@%89dnI^Z8>L&PrcY z(srY+37qNp{4$ofSwq#hc$^GqHs!vVC`jZc!`z0FygyeSO>}9aF@-#N?Qt?K{nhD$ zvWHUNZy_nid9tN&wOk~URYY4$f|h{PnmD}3iV)*T`(nACosw^h1+PhDmqYHdt2233pCV4EhR}9Wd z1o+<4rm6N5#wy7V>f^&$aH6yg0OXN}*FClz>4; zt_Db|_jv?8|AYw_+!wm$Bb|NhS(s0=re{#-rDOUOa;+u-5dG3VCzQrN1uB|;Gi-0K zM>$>`z4Hx=9y~c$zD5LUOfy--QU~{Jm_F@ES5AlFW2=+42A8C~h2e#9u!Jqj8O)EN zRX1dbUx&H>(ez1d9bo#BkO9c`CN{XaJ7OnMYP(WDbqvJfFq!bv`=;k(A|1!Kw$+iN zK`}h7??8DbFi^WqY!nt?;}>^Kk2s8jim^6-g^2^ZcKw(*`uo-a&518Knyhw=5txS@ zd6`?_2YmoV0qY%lYe<}@u6|gP^a{umr5;J^|1BKRWmFLhxM_3_w78CVPv)1?jVZod zP+F}5-EHv&*4b93j;_uJe%zycNp=l~Z|`J8B`q1eP?Jt1Q^$W)=dg;h09Y@qJ0PId zUm^ZI2I7fex*D4w@PcX(Md$+1Rk|-@{u75D;{XBM_m++TJ&>CARpO7SmSPUOBZc3S zwX?$bA)Je&iawtcw5zw$ymU+Jj@_3f4_wf#FE@^GvP0p8#R(6lKB}L7 zh~gNEJ8v@9VE+LNS6t_KK$LPM@8B^ExaAMIDK0a85nU34XDfWUuplbaC>!eiwIj~4 zz$EY850|w3wt%h?wE1ftm{#)_V=|Vp);x|A?BpMUGPEp&*yM7#VSFY*_&=?2e|;TP zlY*RbYz>sIzm9c=v<@dR-JM0U)3PT3)Csac2l?^n2M3WI=|VL!#Jy;W69|@LQQ0OV z<@sCEM#I;jwQm7SutwV1~Kj4Q~*)DgQ+#-tU1KTh|C zG>#bYyklpQ-waYnRysF&%2WX3*^seIE{e{|Iga zWtF}%RL>y9aet*a8}eBc&C?u#9V1pcosd;8?+;X9#v#LKc&h77R<{qB+kRE5Gw`^& zN`3;@?vtwK#7YO`zJ0<<>^}r+`gH8~5sQtKbcjZBS?MIXGL+>gxZWN|GemuH?CuCQ z=)|FBTFpKH-!z#}Cb)d!YiHRk8BugO9Qrx=4fWhl_}{{;Hgwz59nCLz=HCoBL*9T% zCum%OD(LpLef<&!q)22KC_m|w2wR!NIF3og>;K!h}u|k z`^^L;tMj8@(h@A+suIlHGS%ttU8!#AF7NOc)3RKDuYWUZF5qs&^r@&Z!68Hoj4`#; zlkaX#WJR>+M>zmbfVvi?^f59o2B4a`zWYRE*zAx(rT&R0auAk?!#>yM)3o()m4@^_!g5mZg~tI1hpCK{$3>|x(h6Bh7oDV1%2 zlGW3C_!&Fo{^f2^aNqQaArerzlq%^cY1M{SS9D5-V9l)p-)m9=1>eEo3a^0F0+b=n zO3p}gD4p-|(9W16e=Rs7yTt~&EbmGY zXW>h9Cf2Q;Kj->{ay}i_WE_;_qt*^lX9GV`p6P&QD&MY7%J<`Flx#(=VNZcCqQx&L z#>iE82n=^Fg(z(k46^@NqdWMJ&ml(!Rr2%S@IMTU18BH%(Agg#!V>4_uDcJ!yxagb z;0sbJ-M#kMpOu$SK;_A2PCwV%Q7rN*7FxGcGM**H9?&}%2LF(nu9?4{wBaQG`dO%o zn>_o=oh{Et{gz}fCPsBu=l#C50wtgLeIYr%Bo-^sOpd%$bNOJ`wHJft8$kPo?h_#Y zt7L_WyL5$XH!6a(6)-nSkpyDp9IezgV)(#y&1<_-^sOoWFIP%P`;$&auuR@JX%$Cp z;o!-7LQHLra!7E|5I$jSr9lGqACCuCsq$3%;kLm{YQOLcS-!#5EWUHRGCuV1NJAatnK z5t7AD7&8Gww>@u8I^lPCv^D*)jzX{ZBEbi~p(I+xv{T!HtQD_WX$@A>r0$8lMy_yU z06UT^0KXLnIdVzg)~=SRya@~}xhtik0We#ReMx%!D1;SIG$r(R2G*}QTh8MSKA)qd zQ$ngPSBAn{Lt+W4#H#$alp9FUZfE}kBzD*~_ogOA= zg-G90sy}UMi3nF5Y(-HN;6Vl_x-c6>%+DNobM*iLPDEbyyJS-SS@l2EB-_v1gPy7A zl&UEQBL{1MG~cl5J~K;x=Tw9)%>7wvW=Zr%?(dS{*89;U_^!?=;*R*zftosR=kCZE zqTU>bFkD^)=EqPafn1`!NZ&?ND{lq%)Rw|8#`f5uHT0U71EcoW;h#wUEO~POw5Ie+ z7O~1TCRcz4%Z3HJ>XbT8xLXhBj|l+(&Zf@niKmU1x%BJr=46CWlWmvX951n>p7A@b zwwMsG|JDCu*euh#re*UcE5mhbki;zC(=ui{k04E%rjC&jNUi=N0lplEju1fcR58PO zx_?b<`!X@8-0AfTG&ypBq6BQ=l-lJ6Q<|DA%$j1)pZY(9zW4rL@X^@j=_`;AK9@p0;lidO~hzSmiw2Kdlex(=58ERysYWV@QtYNu3b-2SPDLKqQ- z3OH6s`B;g>)hRuizFt*HycaT1zpJ;ds>2(PgR+1zZy*JDO64*;%qcL6h#a`65V)LO zzqdVMb?l8a9O%*Xz&w2YP2n4WO}|bFBgdJN=m(7!=wP-qiPH6y1-RJeSzdsL1 zqgucG69KgVCi_tr-3Mx|xj2dQqx;jY6wI|CG&AJxgFq*VDZOY`tumB4)U8xAGG;o8 z^(jSL&lfcZ?PZ1}{CF~w_G4LEy&GBvy1ZFyX1Xns5PsNAq(5cBhxJV=j`w&{CJNVu0;cwh zkwHfaokbb!tO3!r3{gtsN*K1Bxn|dvhraq(pSU7KAI@mv0k@X@r4U(&Gz@-Vojt@g zq`8d7p8s>!+!3SQ7Q`@tkyrgfq=mjg#XZUsdHTCm23u&bW%;M_E`erN@?5{grxXku zPutMVf=6uAT>&2V#GchJBsZnmd83r)os45Ed=g^God7O>rjmxn-jUN6AB$!yn7Bf5Mk8` zc`#;zS29g$j3>?!5D!$aAAA%Ez<#N`4j3G76b7O2Peovb9(*h$e@lb^s7gW1&6sK` z;U=-g#D-tB-71P71i5poN1w(fLVp+B@dT(YwH>f~{Y*=6qK_xRJ2+(IwBX=1mgl6i5Bp z)GSgO%l$n5RQMX|s2E9(uYXY#mUULm%MkWO(wL7rbfiwKTRbNAD_ngesqz8#msCVa zRpa&)A`2y-JmV#XcF10k`4W6AoTlu3{`rjs`Sehx%@o#2dRCl$} z722o9tfX79$C5`PUWepm3{)qDIudO3EjF$J^TSppChQ`aSQ7s{G8v>aa{Nq8X01f{ zLaTfHE`8_i?vb6I=9L5Krv)cOb++gZGMtaQ1^-mpmEshQrSp~#!XqeRg!zvMr!?_! z4cYn=I>KHGI)wcW3R42Y&6MTH-Q4zp@6_eU=Y{%}Y@jplWhSVq@+zHzA-+nb0>@nc z(gIvt`*CWW^_;F?u!fFa;kGd0lt8ReXB37GH5V*c3UbzVfhwvTzw4VSb>W+Do=5e}aM~6ql$?0hp{S z{`14h&!!qYn7B`rY&`K-4Dh?Q;a+=tCrS|?+S=7x=QWea(g#-L_hbn+4)of&gBYJ! z3rCW<^XLtV$4zB^po(rku|K_dN&zO?)8zwAx4R+r)&wZ@-ddjMs>a3xl_`1=|3je9 zi%LT#j1)E!!(-OyV&-Uz-`dcTQ1(ocyVMMD`I)9Pdi7S9mG`h0t1 z&Y0XP;oWm@!lmcbYT3YDp?l9c6@iB0m@Y=~);rthb=|{}lL#%>(y< z(CtX@qV2X}W?1vy>zBfoVJ-<wKAz5=`ScKMtOXA2V{E(Kd}4!(X@-S zpqz0CGum$TIbpU$-}u`+T(rQng&_)8@~SK2DYoP916Q4GFY%w=eM9Gz+U7W2Y_w=g zn<`AYjW=$A8U}W{3Q(Jjp#Q_vJBP;^b$i3HZKH7-8xuFSZL6`}*tVUC(^yR!+qT^p zjlb!0&ikF`-&~Vx-?Q$u_pH6v5BIafw6rgkb{kdz14f+|b;!(za618V914Y0mcnkM z(A&pO2b&D)WA^Sq?oHpXQM)Kf^ej=y(So3DCkg_-z)a*PfiUwg9U0g~sFWaNAw>Y1 zEs#=-rv^5}cKnWV6^8P2>Zfty=w}|6F+Fwp%y7D)zxI~bD{{hPGMNnLt}y{4WL>90 zCB+77`w1j#CZAiSw-=s{jQOC`{&!gP9!-JioT@6#nx&Z$P?I;rnt@CEg!hXGt2wls z0xA6b0??4oSf}+8*Y8(CPJFf_Y~R}$)#&JcdpIhoO8lxUb9V)K$KwtRrn*QZ@g1ft zbya_go`L|L@fVG|LQ3hN7}5Zi%Jdx40h8XqbERv7L%6OEc_dg1q4w{OSNvcPLyD;r zS3<5zV`JXnyX;SNgbq}=d)?c1r#g8oSg-w1QuN=dr7OBPOffE;6CmZTP06--YOf|y}F(Th73e#Fl=K;ytIV$iT?|UIvM&p4N z2f)Q-qnL;$02V_6J}D_`(QV3Q+I+=VP<<)b4QrLSSvE-^tG=L7BnM{82`UBfA}>it zHrieM$oX^lBsAVgMxxRcslVn4rUG#I|8ZA$YP@iMZoo(N%X7zyYAt(4GHJ_niy@J| z`W-WQJ>|9@WLxJ0T|EvfSqZYZ--ZZ{q0(-=GV%D#?_6ld<)%?wGJK!WWHR1LM)xcb z{0LIJ?maOuG2Bm{uYSG8r8}s|!yt8$NbCp$5#tTaATEaLN zjiR=b{a(k%c=mhmW}9VL5^gDG+6qoPE#0xSNR83I`U!0L;ebZe#9CKlF>{rijT2x;6WZk>i2_cmUgVJv}L$u_50iDbM1ZI`~}SZeIh8V?Qp zI))OQ2esK8jcBTKcb@HeKYlzwKn_He9HC*<%O>d?I41`9V&$DaHE3T~huLR6D=WS{ z5QcQv=%agU8IEII3rZHSv_V5qHU{J{k_G_q?O)WV9cBs=0r%lT6yY~~`At1X1H64D ze-Bdo(aYpw?&;d@o_cq7T8&(rZIXHlKvT6qRx?uGSmJ_y7WX20^%NQTZ0SOiL3USr znwJFfwvEwKVX|@z>Z3|WnluA6ZyN*eQ!l(Y*#)Ux1xLF{J}C@`GX6Ubjp<^RlkXvA zj>}%`0FnFN86~UbTK3AVZDwNrrYE%}InPW4SkDqVPG)B8t*JbLXs!uxCm)Q5kRxlt z6Kj)(X%Nv*_W5V&?9|islhk>PlP`fo-uC zs-^KjBM7blO~tD1P8N$3Z2j@t0f0HN3@ts^7w&DFsbOc&4^O3$LXlu=oESwIRQ z$D!mTXm>jf8fDTqyuWlr{yB0}WBOgvX~$ML7l za0!J33`(2Eo(|{yi|)Nv_s81#N`$9@*siCeSc&vLj!Kn9Op37b4!fm-?AwxOLKSuf zB25V|U}-p>RBWVfw8pF!UAnrG*aU!=CF4M`{59ISTs(v4iRbFXc(aMl;Nx{^{rXEl zU{~$-!;ATt+JdEg_e*oBUZx7411c#$eKxm!lHqbSc;bdRi`e%a+K}s5JXX;`^NEcx z??PmeM<~8Ie*ep^3kl&yNA|^tf5iwnWqhHh&r)rwOU1G>Is)6^ct&_F|4-N;rI>IE zxm9-e_UBq4I<^077V-Q7qG?%9|H4SQJ9f}sF?IM5rWIHPFj6pq#i=~oYQB2<6JGdWs?uWr_pp(xQ}AFYa}0_LiI zGsI+x|ht;3TE{4C}ZV@@L-U~e;7gZ(bj8#)Gc~O+OD74=W_7#obepT}?Qf73& zBBl6Tbt-0Y+h0f{={6t*FolpK`bS#K_mrFkZ^ZU=eU~5GmwQ72@2o2ih~2Am=snRZ z%PU?$!O*AweCV-A&|41(RIAWZR@5vNjLG%R=;}&pN?J+w$(YOHrt4O`U22zAyx2eu z;}M3$Cgx^)VBoR+MhZex^G58Nim2aSzh)GRZ26=a=oWl_4|xPUm@dd%!Y3CvOLt>8`N}9HZGc2%;K`= z>uMx5nKxCR=^J|VA1M948I~os1OmEDgkw~q3}3TvB7uQt^4w5(p+HdiJmSq6qb8*b zecUj!T?~=alZf6n9Hlqk9<5*PeHi|glBxfd`fbE8KF_Z-Am6qj=tiJRp7if9WQepZ zPDwON<_2w*-f^9#yY%u?$2Qk*+j}5L$LLt=l~9e5t>!@#Q2TpG^z&o6z>1S=7+ppe z$}Dn4WoO9SH2CnOlr!$~{aTEy8cx-{>R?r=D;RF@t7>Cf3Q(V4tk7_mTfo^pT8xu~ ziIUke-i4=y3B-W|z+WoNp)rW}4T#3mU7Wzu$e{{%tR`byj;Qd#CF9io*;W)gYD%CH zl(aVWe^Eq5!Nn5Tto7ns3RbN*LPt&qiELn)d{$LWu-I}fR;ug9`X3o5 zfT=voV(-&#=b-eNop&oq?XftE;4wB>^-vG~fzD3vi3*Mry&H==GFClwWPDuTUHFouoYH${`T_`+Y;^MT;r`(zuj zE8j0^EcuG!Ng_j^S)9V&&2f<~6W$NE(d9)5MUWSaE+h>vlgWln#x5u#5l<4!mBL=4 zY%5vH$ZprAWZ@2r5Q2xQdbU3?&02j!Thf0#ZAiK8|CIX{CEDpz|Mi!{)m4Y;bbp-T z!wMcSSgBismTlvwIw2kG-gttD7#z8WJieo+D{YI>Hv%^5mxL`&0%Z_W6AZi5w;e&H z)W)20mRmjYVJx+(!iI#E+`ol|e zyYNC3VKg+K$*4-@KS^Zh751SgPzJ!u#8SsNOssS+6dRA|tQ9c?`6(o_82@=_;g!4I z0j?F&h!flNEp#%g-^v;59KFpH&`^h?kc7c{z<0H??^^3otb1JcZa@A#b9VAu24iwN zUra{%!%xo9ntRmjWY5MtjbUTp@^63;^CtT1-MC}V=QbnL66>O1Zx4jXkNm(dm0NOK zueXl&{REK_cgpicRJg{sy7`+6*tiLKP+b*TtdV29Wq}ncBZC4eEXJ=2nVdd(3_5K}0@CXq-(hil{IoKjwMj@G$FAL%ByxW~ zVuXuMQzZ~iTJq(CZwMP3?-$W;8Fw|rv6Mc+qir4Y_N4^fG!}Y>M&X8g0G-0bde|Jl zdf4!x!5w;n8WXNymkQF{5O2=80zPrxj#e2em+i{MM^bhU#Y0ewC3bNkI8n$L5T&>4 zjh6cajpQAUBJ>)SVfCp?e?^(ALK&JJzaZ%obV)e=_H@;#(J6h}3MT-dCsLKd->Taz zRsutrrR}sFQ#(%p`4Y4E5tu{(Pc<%k`2_o$b+hF-PhQ{q0vJXtdM!1vZY1NVAY)x= zggz;w8y$i_OMwN6B@c>f=EyML2uP@F_6HpC52VoZ*_Be)KVC@=n(WlXEIvOr1^d)$ zY>-FPxl<|^D@VYwEd6dm%hivvhtaTVOT&S_?QAyJwl{isny{!BV!x*JR_mQ8`sS3P z%e;u{qvr)N8(qlcWYZZn6ro;K(B3H%t-!FW8!geI!auE$&~;U9BjIDYF1PLEl1AcEVP%Bsrt%ebt{uPP5deZkXdkAV>eF;YInkZW)+$A+Z1h|cT3_FXJPg&&2OkG}DE zV)mMAZ=98qi!uw~=|DYWyGiy?mU*t-rxqtc2dA1jSL#^zHKpwABjv`3l zscIq=>q8K2eZ=SvKabX%Tq-Pb_y&{481E|S;hbwEO`dRvSD*l$Cy`3#2i}4h3Ua@| z_()W$txlaR`;i6`WBM{e0{l_qqE=U~rE`$D6;`szpo}mcm4cHd zuYGQ|UL6qEUE!R(|M@2Z1d=b)g-|`|J`Qq28c$@6vT8#~eFz5i*rrd0(me=^+THPM zuhk)#`+F;;s7!uu%FtVdb|=$Xq`XmxS{9m&s*vz-u&wTS751!GgTocLc2v&LVo!D0 z$dEA=h2F#;CCzHp@+tZi(YdM;_y8d!J+8MFd?;JUzKxdi4sv69!`h?;aOo=5avV76 z6e1ya5NAmz@W!C#uF<-YM?aZsI4d#0Zpi_Mp36WbVAl>?@b|-% zaSipJwg=G{CXg^e=!#UA9R&_qd?fAJ1n(HHN=pv8+#UW z3bx`lpQ5ea<|{AhKdGTr{3P6{nYtVy;=c0GLXv+PA(j{Yg{2a?7fA#PP-8jEd0K-8Z!mks?tbwI z8QIa$wVcryee8U@OKyQBB?}|sR>efv?_>chl)H3IdKlE*{Qg5lkH`5r`?UC`3DitF>83pjfd&<{} zhgs<;e&H_QIfi(ZuM>DBMlvLXkegUZoA*RVY@vC6lVZE-cEu$n(PE~I?=S!;I_qq$ zEG#AZFn9fj@vl$sRfzD8PzOwO(Iq^)aU}QR^{DP|HU|-{$1{c=tUZ;aazL}+wxLUA zj~~%SmKzI<9f0HE%b2rtz^@I(zJl^u#bYp`Vu?h5r`NBOn9R0BGc0@E)4fW{!7w3_ zol|c)Vbz|Tl1&Qnk_1-5Gbe`v)-hFmy1istbY`jOmV1qiTC#OA!n5;DNWXLWJ#2_` z=v2#kM{2;_T1DU@2~osas~?r4yKQFGT>=PH)Gl5@bzq{{ebIn}cAfO=1UkNVzvHH| z#Ro*}92}J#%OzeE|;6s6*v&eG6?aifs{$ zsaI{PHOuOdXv>QOo*~rU-{hj7ECN~3&tqcPua5Ic$redYOIfXAgdN_juzdE*ZxK)G z;)vCeXAKAjWZaYS1FU27b4|mlg9hp^vEXSy;5f~)lLjwnSxZ%BtSyU`^p^0u$acpJ z*$I5r+oMTkT{NB*UxUwe9kl#(Gx)x0dbJ9&)-65-m_ll7s$D-9-c>!5Y$4B2d#~4; z#DKK^(ht?0~O<&!cYT?cxNF87)a> zHq(M)8Nzy6ce0UEMS{9opE21i94D)&U)`pg``ahIrf>s})_A5LuvsKM1?vjEBJVMb ziKKi%#lH2F_yWQHG4JOoz6QjQJPgN*9g*YawYhUHiK~;*6?w7ylc@2A0Fi$-r5rrV+gLd+schC&v zrF@^nZAK15X|qA!gU>`WKOIOU7DSB-VY~lI-0D(Z5+qzP+#e~}Mu%$yb%DzfOF;0+ zQE$yKBUKPo@U8!DBtwTJ9rw{JdqUyYHdz_Do$0CdNJ0~oM%Ghk2T;U3Ca94G;hvpE z;%{l)P`sv|2C@KJNc1(%3|!%j;;mUM9hKbD{JxhLp3PuAW2Ly$v0k@~fs+b>?kOvY zLJki(NLnId$#1t?r^yNue_x3FxifoA=`PQvcc$!CPoH7#<*cf1I|GW@px=%z*o?Dg@rov@Mt1=mIl_??{goD#^a=g_yNW1U3djY>bCQXCU?1dyr0k zD)EMhz-}_SEhyJZqHHjI=+{kO>G8-3&$=zW(+w0yh3C+Xso|8@-H=okP0i;4jobkE ze);>|F=MIan=jAK3&TRTl>lz<9>z7RKScuHbVCZDclw$(?9cD|L0|fa7kxWKX$+S? zDM|(MlqVL%88@nZ9Fge+fs`2*_eAC_)E=*>jL2n_&) zwbras({ED#apadne`%<7t`Pmylz#+ren)IrYdL+}(dlK6yj#M6MoFjVet~P&%vi)J zI(oYn^sy zuxcYcssf2ZSazFP#B5qRll((o{iL8|UMMu=bwCKwjQ(i?ATma%<3(etStPd1XSGEV zL>9m4i?<_2?d&J0Hl%mm$Cu=Yu)di6P^VCpj(^@msrE5LhBOVCr)8szHhc@qc}8T? z5t}|3$k6(X=E?tj0RRX(Op)pL(d(CQ-X}z>Pbp;|^OC9kkQ#ym$kUCwqnJQQQL!-8 z9%wh^tb*?fbjVJ{tp3+KOKK^koM%41+--SU85E)+>;>-Zg znRP-T;%8S}k!1hQ=e||j&fJs;1^rk>%s%OJ*LTD)D_?hWyxq_m#vj@8fB^GC8C<7f zIzh0XVb8(?+cMlVPqI{uZ6}y7!C0ed;IE$N_eiJiZ8rDO3|X6g4iXu;G+?AdMn}c? zT1muK=YXAZbF!*ezhmhc6cR(;ijEOhy(28II zL*Hr6T0%6GDSqU^lCeTb&vt)~0~AyF+B2UPqukSJyM$V9A?5uHmz8HrD(1>;D=rdG zeZl^F?-xD!?(N@4KOMH#9`6d zocr^ONsQ^aQ`7$O-9?3QrHD5PK8I;WA_XtXQZ}~dbV{w|QS`C-?O{FTrvTa2Xg{AL zLvwo<%7<>fRisS(bdE6st7=7wfACNRx7s=y^+Y^7Tx98&J%SNihqb0zkFA~G+!RFj zICQGD)dtadhG78>C|LcS2sj5{{YEH*ZnxwPjYWC)T}p{;||`?=EVmoP^jSNg5F;#7y6Nif(P-AQE=%fyfGJ%{oabo@?5+H)|CGrs(%2PnYIeg}|?+dkBS zA`QCVOU%4+$%kkD&%T&U=&FW$m$A12#Owt#D`qixAa#mdwtKZDl{9B_BYtk-b((#8 z4FB2XY!uyCtNwTA5d|1sI!mL$Q8M~N((m)Xj2g?2uS{O}CHphg=Sm~*HeKe=an$qQ zsIk4ey-O@aJS*c&8PeX|+$6j`EC=l!Ytxk3ES}NZZdH3Bp3W2|4-70^yI0fsDV&;C ze*W%#I3r`d7){E(H%iEJQDM^xeivwLqg{mSQ(<@R9v33@ePeT;Tu5`deTAl2{mm-# zvV7k}gU9toC^isBA`quzQgtwl&u;#lgiT9Hcvbb<&%c_b#+slN9~m1;=|-4v#dJ2= z220JM+H!-!#696uDc0-js3h8b^>t>pjZdIRO z&^-=12Wxt)8Mp#if6HK_jh++{2|F?dKYzkZJx*1>nEv&q7EHNjd;nqgsw^qeKr-XyC6>erZO3}!Q84v z2M^M4;qT(TmuR;3Sd=xSyv{_N$$RGWLzB0!R~3+POA-q6(5dA>P6B@x54*M=*PGN3Zd&S__e179vx{Gdc$Y|w|G1DKh8m6W9)tIa6 z&CY;jM@4Vte+rDasuVbGK$B8A;9Lex1^6KytMir;wz6$DG!_|(I-LHL_)PNzNc&$3 z6;vWZi_m=)>ro-V!YIp(#wpe^Xi}@vQobbiPo~ThN+0OI|J`(YyBdS9(yc-zWs;Z5 zNyt4~kSAb9TWKcr^c$89aZHF(8W(N7(@FP73{iw*aIO9Ux*q?EPb)I<7sP;P@vWTO zb^=C9SR_cIh2n5mn^l#%(S6c9kLcxw9!&`H&VR8BSG+G&&S{FY1#jPz!kUYo$zmet zua(Z{+MqTy2&xKA?2H#9+d!)?!Ykv7N<6j5$g5mbwwE^zvpV;-ojxb~G&`)2&Z9M+ za2wNMY%ww~FcNOt-CN6cf{MA#)KraO`!LX_uOhMRhPzk!`-X48LvV~?-V)JlFynhZWk`TppBBCCBK zJ5V$e>jMdHuQaH%s7ZUh{qa!ly-C^d-V}Z&GG<$q&)^~HR8saGPpe6Sdnh)6Q%8De z@ZN{fZt@COtDV(4Tdt~WI3J8|C_^waQjd(`U;QA0{(QF{DOKd+S+G|)^@c`dOQ%5K z2bQ9bsi`dH*~$6rSk7U7I5)3dTqbj)*Bg6jlx3Hk$`xr!!bRC)xv-q+_6|2f#uh+e zFUBme9QLc%t|o)Eio0ySP3gLfO;Iu4%SC$Dk)+Ce*L}8AbR`?r>+}7>YC@Y=BRSY^ zHmV|#LVAa@SKEpb)D`{@8&It=I({}&w@`-rZzhWxOHdkO{oLUulW|0@HU;7dTocr2 z^%y)7@f4JV6}mDKa$TdB866BI0gbL=+a7hObSBcj%$j6u$|eh?k>WBX6?S`%eeuly znar|!^VeFPgZzC}wS^ia5^Hwl*FtI8L*9YG3~1+e+lf}7VyH^QN);TcMY`?D8U7{T-7*Q7bK!RIQ9rm9J!%}sMLv@pvFe8Yd`N`km%N}n z6|(b4Yh>C4hZ^uhX-WQ{DX&Kn=ZRuFGXMNPz`CnZ-epjYzc|q$F@r~r#|iixT+bHI zHR|hP2mfUjJx;56SBG$kcV;*Kx$gvJ(99koAOtJDWCRP6UcXHfI7S@(K!h6(1RsjJ z*sy1)#qQRQ24A*>c788IwhE%NbD}zDKFBvG@7W)YA1xFMPlR=bYbTfFm;ib|Xq`q~ zPk@HR6t2JuO;QTC)aC^4Dg7C8G$?RV>)S;M)(3T_I>^Ix)7C+MdjYC_Xq472DsE!Y zSmAN8es?KnzVVj zd`tb``o6`_rMnze+H5fsa#g?$7#+~xA-6 zDj@fIA`6cq_gW|C_)S#C4(DW)K`Ku9*GJ=+MgPyuink2qZj&@w`5KOGM?FrsclH7r zJM>-OAD)n$CXj^5elx+rX}#;|nl=b6R9r-&Gq|A%Nrl9Z`#pGfE&B_E2Go~&>ZI+z zoTQEC)0(E#1$inmx7#SUUEzUL;w`mtHLIrQA1fVFL7dSs%bPeUlb-UGUEx2^8^p-2 z$p2~dRH@zmWXEEr>ic#BjZp?7ii5=91mvcFeHOmq^k5r%A|LJ~789^(;@SuS4+%>p zGNgPf+HmFWjkWT(*xZg7o{e5yBSo0hqz?vJpjc|1iWz9+G<^USNv*WTLI-V?QV%xj zNX91Ma&O~Akq`!~V~&(^c|iEXhFmtUTQko*l+g%uiV~25;&o1@Uc!Mm%H5Xf%mYt3 znNcL>y6M?~-qz1vZ^k&d}g6VPwl>vgKJxn@N=QXy8AlHqAMG#F8 zDx{GeYZ`@R6iylgnm9vsAei2B!q`ToJnkdcOCE4Fa5{fxO&?R_4Io&qg_d@r;LOv5 z$RYRnx)Y1=NHT4{rNW}^)IzQ_l*4uipilo={xl+^eN!bsQkm51n>!#(#awId5@CVG z9Rklb$Ph7lO{yABk<-QEFFQ|w0)okcycz_Tjsc)>^!Y2%wtfnpZXN!=9UYpGhF`KAz zt|)c>9ZP)w?F2NU^BW`J#p?&=?w+ZPitRx1yt)5K5G3qjyJfy)4KT@h+wV!lnxUsMHjzVHG3$;k^i#)K z;D7yb{uvLExxyV-_qjHU^@wuYwcp9C@{-(?lfO7p=YJCxVdCp(OHrCLgG;WYS>4Mt zP8z|&i`tX@0b^_uG+dtVtpaMIP(5vbCLriyF=$=0X1qmo%qJ_&RAc`~_FdRO0+aA3?Cqz?X9ixKi z;V9c-G>*8_3`-5;t9qqTm+aE~L8LH# zCrD%W<`I%0Ns|JG+=~iCD-rh&0VW(hhkR~T*LbjlzzN!oN1E-AYv3w9{sP!dEQMaz z99|H(aV+|$)$aKo|K~45)=HK@1Fz~H=6{$Li8A5d zW=zi{UYKO5cF>p4;xv%~`?nvJ-R$E{93BXJj~g@)0X%D zUN_p-KLZH_aVZ1$aR1OJS9rg3mp;z}&<^kUMeD{HF(~Z*vPWY>_LAs6iY>e6RM<{4W5Fa$8HKQs8Jzr@^L!fc-VE#_E7`7B=~xCqRn= zpNGqTxgGVv{2K*nVkF^mQS1?TFM0|N8L*paZ)I^uc1#2i4I* z-FQ$MF2WywKl(q1CSfgdkkpJ8a=NXZ26=*qIH?|rs>URphyH&p=?wcXt{_{A%M4fE z22d{Z&W7jkFzaXkSDuXc|JyF+8Xz{Ju{-0)C|p|t07TbGJ}$S-{x3JA)o75d)@pQ5 zrw@uS*;SFEFPS@UpkV7JlsYfhWM z!xnkW>uhGuLsewTJ423o4-b$QgmM`J8B8n;yVBakzB9!}LlAf!EoC08IoCklsw z8kxQ+X^hHNN-$(Sk@iq?&&=TR|36xVzf1h9MHJvi`Q5GyF0?x(JVuMF)RW(!iH*mm z#GPMeM0j%&z>3tA={fDGL!+>#9bG`1PA9c1I-O~3&c4xn{A0VsH}XuSLU(KB=OQs#Lu>Po>C8nofzV=YUxWtb|+0AdW--UD?Uwf72_dDpoiG^u(=Z z^V|B_KCJ)ejFkF;8h$Mow)aQ7Q)4QZkLrK6*jUK**`*4;I2qQzuGdcks;j@56hA%B z<#_!*suvixp$y>55fWzG^N5f06#(SAPc?}r5Qinkp(rYN*>d1)H+c(s7C)Fc0hh-f36xGc=hHUt*Y8i^^P ze-jS^6Fmvpf}kX)ED67d`80U_^?HjzLhj|o*}m+Bxy5*#(>dM#l?Nt z0damYkw;Bz^;065ot^#kD&Uh}b20DZvGucbW+v{%W_7nTfOH*kL@88$=JGhtXUeLR z*GHY1D0^t1oJ1lf^v8qPEZo#0gnXc;U%JAufBrYDR zs^bk~zxgwCDpxk~2nq^n#Le&JzBHLeQOZkOTiaQ#{d=|E@(OECXXyCGPw^YHLdJ^e z^>x{?{^k`WrZcg2(CTwxGc!uS{^8;HynrpwPJMh|kbS~5yU|$j%|4CN@Qx9Ipf8WQ zTFQJPMfeJd@HBn%9N}z9bQbc0QP2CGmTCbtKo-(L8&0A{sfH$76!2stWLZ)u=82`IgOe zKTVY}>37V60PX`r?V=!ESW6fYy8Bhj{J9jmyYDAkZLJnHtLTzMl)TJ&i3L3qEH(s#kER0x z#|=b$@Dkjjql=T~*kly>6=q42C8k8>c8IdXfS6Hr>_!u%*Vjxb`MTd+j<;mfnGWaUg+7E;%eMNsGU*4z(AQ_Y z=CW*DhKc-isyGp?aAp{c3~^?_R54%r^%m-=)k<^cpb)i+gg9nl$0G$#PCZHFhVK?n zJmvBB+?^0kJn>h72Ri5yK?;cnySoxw1|$c^SA&70!GKlvy^D(thTbNSpOg2~rUwMF%eQ`179Pt__Gs3Hbs@Sd`iN-C$sK zQvw@1yVY+o#1%vws>+Z*_>8}^%jfPnX3TKoqn68jE^xp7isY?^MB(JF}w) zSU4qh0AJ6)1V`YG=B6@0zCqH_&?u@nLqol&T3a^+mPcYb7_;1vKDL=f{~ua(jLXi}Jqj0xc_Cjuq~2ewyFk4NbZ(PiQYR+aeJI+VY*540dj1tk+v= z7V5TzLCW7WR4#Kq|Lo;q({8#vM{Kubc#?;zzX3R8A1pM3cYO_c^=^L=PCVd+ zCEAv@!DOtQ>AM`H+!6kj4qX;B2Pnte^8Q6wgm`p~-s`BuU%!sMX@9vjkm{wlM)|hI zZgnX6=OhLVtHlIuhwrL$3LrMl+y)fo^NS~f(XE+H zUR70P(z5HI*i7ZN@0~oK_dQQMe-R$ebdc+FBxZT$<&n&0$KYIjAw_1 z4157Z!r4j#rrXt4@~`Kkuizv-pYNnV)nlcX>;2LuKV6JXK|h$%vi!n>gYE@RYMluL zG*Gy~VCbf=Tiqct6!HMnHzN4>nMfHDv(@~TH%|y_Q^N{GLiDcPF?X34(1fE6Vvree zPb7y&g^XgUE!P52F1lbXOTLXs)*hB8bTCq&hnlfPN>Ip=N_>I9k9dFGu7fjzKzsSS zPu1ZrH2DW5+5I!h9pwG>XSFd_L>v4)PGsfLkh?Mc6l}d6QWXt$ZX&Za852^~^7yex zsRF?s3}78NN|H}fBmXbdO%jM!fxtwAW~hfMPLwaUo5`i17)J_Tthxm5OZ_??H3ERF zC1;BQrB#O;m*$PPyoHDP^ZnvB#`;I<^h0KDpctOntZpBYt}@!hG`e_`-NDL02lrg1 zx^2a^3VeJ|HdX%Sa@Deu)UZ*9+Y8ni$#O6bqjx@i75(Y1B+1?i9kAcDt2fL&Vm2^)te05atPw<3Z&L`laRh-o`^@7zDgye_zLcM(MqOIj@VF+uUeJWlMF0_sLg)qdg0A z?|C=;?m@okGEHRd!30^heJhYFls|OLWbX6o{Eo^JNJQBZHVhvK?_`Q#W#fI3;UyWa zk@Y|I!`gqcSvwoVUOdy34O>YQ@S$_M+VU1hGW!s4R`FtwEopX0JBx3D$xz6Z*@a(4 zh>UJKukE}K9MuNENJ*_JR0uI{a=3M+>CA8~SGjg|U3@tczBxF(_-cackLJ@G9+b>a zIp~JfaMXkm2pZp*-mlr#siIWv3EYkp?==K1)6w%Kk@&oESLfjhzdl|TFB;Za5Ezs$ zq$XyH_lHrMeJElCun8Nz`HhwU8q0Z27jG4hWF}xd# zkWhAB`>*lzRIaPwJJI0JCtz3C57Uyr9fUM9f#8tVgHeif?*P*1L(?2oc#LiC4VIuX zh1|Zad_Sb?UwbWTj!4P;xjhNeVwhp`NO8?NQ)IM<3%rHLZqetW4qZ3&xq_u&6@g%4 zz4u^#eZp7EhOG!QKZa>hA7ncvXZ8jiR2BRM-yb7|B4{oIV1f$n1s?x8(DBeF=>7Et zqv9?TiL$KAY%rZXrTC-w@2vjMX|ndOeyaxlPyAtb?xJz#HHGX8SdkJ$As|l=+SMwn zfo0*BZNc9O1glF2*B>6zF5+7xM#o1-3tP9mqu<^kt#iiM+;S7zy~ z4GDkg-Om3#07vzS*82TviZTw@WE#V#ps%=NMhQj=-2bD=_83J*Q4up zwLg9U8f06)3qU78vugcL8!(3`2};5x!Il@pzjsAJEY>HQR!cCfV1_lv!lB>Z%ou`0 zAOkoSJQDNN$E(awN#j53#W!V7-4MDpuhw3177gm&Ix3nCVqvNf^ejg z@J677uMC$SpFYT#PG7S5Pq{n~L14r-=a5$9-|QLz#zHLUm-X>@EgE%P(!T!qr#xNg zB|-ujPk36;u?NfHBvhqaG5l{9he09nR%`r64kEz%61_iYva2rVlsa4?uZT7e>^|~* zY0e_+-P`s)JVH>dNmFC)J%tCkKlOfzgIA<$2xQSX@%5;=3*#e2ZYTjx?S|#X5EB49 z#HX)1%>G(zlnSBFmuIVu_slOIK|pfQ3HjDd6$kGMnCX`*4B6F&v8t@;o?zQtRMQ?M z{m|_%fEO0!l8{y46L0(a<^YyA?u!<%xPPlDVCaFbc90S~y-b|`;>Z~AEiD@ta!1^L z8%0eN(nZD(VGvn3hB?XojC<4H8ZlrYq$$cd_mb~T7h_WNN!Pm7n`A5zS_oyM@+Oh|R{F@5E6TNL6s`e4bbZ~s$Y z*DU-em&HdLu^y^QO-JyIymPUOz%uf>9GLzXO?|*tX^ek^;z+|NOPk2#ODzp*w1%vb zV>DA#qdLa$dTpGhtE-53al2Bu`<^QinuFv_Okfvl34V2D#p$tUfEhbS)Nslvu|(>2xYEH6lkWbF^Z~*Ss~Qa*^#w{}wYfgoUKq&A z$ap&I_8ZMfPIWJp0rywuF&FMz7G`gd7H$9=gN+AQ$CJH41>)%xc>W<0K`=QmX?3Kv zs!E%`{9wrtN|eiJf_yp^2y9S+Bk&!siOgUsV;(zLVpx=e@WR1LZI?v)?cPQu>)UbQ zDI2JtPU0nA6Qa!T3YaM2%o}U%|Dtl^lFZ-Xvngfwz`adBCwHT$(H19f& z&KhHtZ?BV4WDKS=nC@@GW%1wiiY%{s46Qi+#xV+Vg}IXoelda*K26WfesK^sPfa;nAW zHW2qPuRoCc&eTP~=%tu4n%K@wLxY=#bu%UaiDqbcxIaZEpJ-ECHJRgPS`@Z(MiQe0k~R*-HKO5k_Yr#5^Kkm;p@eN)V2f z&=o+~3^1bluP``D3Tpp^o0N2&(&FPVBvFgz%x7ZNQG5vp70B}`?0&r@`Ds9jWQ-%h(%mF30 zN<@joJV%+<6MME0xnmFdtxCe9v6H@Vs;sUp177g*Wjl%VD#4GRrm<4lqF4eA8y(pQOM{09jQ}!X8bM+?;U=aYrqvVQ~xGIiX+*9Wmu&05T?RTBOgGG{P=C6G{$$wAI zYoCAw!m@$;=t+Cmq6Wrbb8-1}ALM&;XFOh-o@n|@;Kh&E2NC5`?a%JMu^sxx2}KZ? zrHooDN^zAWL;`wqUL~$Pa-SQ(2l_nnQl!D462bJh+<2$2(!P}tmkTYlT)mQ8C@z}VKc792H)6A#bgp+r>+nuhXL;V2D+1<>0z9#{zUCYZ#XOHs(L}(OqiW*FZ;jPZ_2vks6fcIbeof5OM zBngQzH zKj3bwo_&}Y@HlF!VT$*?Ahh2?i2C3{7c`lg&CHQngLAxT{q|X(`HU#9)>t;6>QjJb zL3mR>*ASN9q|^adbqhooR@*7Y3b#EE%%w(d03-kI5BR6$;2PKfZvKnA=M{OH4R82iI*I zBu6hj*p6Senm1=3+kjDf7-$Vr>c0!z8x>;sI-K(N0vPT1OLuYuKftUI;NW&BHwpnl zCzH}`sp8UNsI5!fN2Iu*vWx*#mQAYxn%4;-<({^=a{V_N#BM_Yyp}CW)?{Eo$Ry?1 zw#&1xMB5A8OmTF+>{fuPGjJntj^~^Hr)-}~9PhktyQK@%iUX?BBQ$9DvWkc)qLrz+ zQKG8dNNl%(2e|iAk%YETB=t#>-!9euZ9Y#-d=ngF32}uSAR79VJSI&Fc_@h%Y@VEb z7=dTL^AUqz&vyaUdxf80v{-zi`ktwXCL(#ow8W?5^>T9DgrX`vVwcCfj#~WRy}hrx zTTd@mv9#giV`7rN<$>O4DY)3H(yw{^O8Wrq;{D7u5w12A*RF%)PAkJbC;G`iyEdjL zRMqQ^mCoJ0qM22-D3A*Z;^g;6woEnZ-Uktd_adZt&dwwYJtf!#g3gNFknZ;6OI!KB z=e>bb{m|JbSx_XYj6+VxVyW%y9IZ5YuqikLxAA!!6mpmXMOvg zeV*t3f}U&kT60#7dTUgH;&Q$S2Bm=9U(p5(ow`tDyz!b5ru~{nwbgf={a@WQF+$=b z`Z@mhLLMGC4e}ipziWjmVYz>DGyQ{k9%mM>^^4T(4#C$?AUUB;8kTbOFjJ)ZnMerF zj5A6+-O4Pbt7!_6zuK40l#=h)x?AV=O)FpG*&cF`OlJ!vAtih!x1ike1d*4X2&KG8 zNJY4p26_~4FC*-a@p~;w*8BdULzD zd1aZvF`nUq;DUBuR5Drybq|SABEQHHKykg|GT1*`e^$TaOz+gG^bH8d4`QK&m(F{q za`^-eafP+GBI0Sb@0$!Fg${6vBcLEHK#tDk4h@xwFq1MsN4f)4vIPQm`U)T>VN80V z(uRfSO@|x}PC^-`{`GJX%Ob!<|AU(VpDGmO%Hcgx$*yOO!uYxQ$n&&Qm*ddv1(gPS zpeRyLu~V8xUokJ?iVi8dj@?@9sf&Fr1!i4D$#1r{Cv?q3ln^Gn_vX##`A*)_lg4HD z$JCD9uYhf@!7&}9sPaZ@1ePE~nZfh?W!=E>auVbu{bFofTzi%?wzJ6BEP^v$QAgcD zNpSr6bmC{~C$7jDk`+^8WKL}TdTjE^jWTyjH3DgEg7G@(i!Wt{sG$d+h(#tS$U09a z(3A0ZV0#)LD(2@hMZXG8H>8f^zUD(ypo1u6{~Q&x5Eaf^EL{9_s_2?!q1Mf z7s4Hv?dTjyo}K!TAH-6^kb@}b$fzFuoS}RmsO_eWORiW6rff3>CC5kZmh`wSt)h0r z?pqXr2BQ8VYDH+q%|*AjqgIkaXs%V%B1k%_irT_qv4oIZj@LevWKahGsj4pBzshHs zzQ735T2c}v8V4qxm4a5`Xw#kjI`_qmPOrm*Tn?#(Gq1DG$iN^Tsyav;S76yStkzm8 z-{O(H{|F|H$3l_s@~ohQ$@%Qn`9j3*gLVqB+~MXVLxx%8n>@A0so;naLv1by@GgaI z5}Jy`Ue=TDdQ46a!hEUTweA)8IC-<6^=`nOg#3Ef(!GO7H=Jw_4kvZlsMn?|fQ5{O zf6J3B%E4)3Nk-PeV=Q)GvPaP^Mdw!+KJU239oELNuT;T?DK?m^dDo91nTj6unMiC; zr5y~tnIH6B9-NxNpZ*D_?9x#Vt%hW~n5nI!z1%(^6_1jZmw<3l6cJ$F@P!tY{5k|z zqpWwK3St2}3TYWhu)Bw}^u0}D*ZI7}`XSfa-wopFDS}f!wOvnWymVc}ZAy2V$AKuu z>r;+ZL^6PZsaod!p{Q)WFX|b9>5r{%UTJhj0_&urjq9%CDw}>i-0heyJTeHYLm|M| zmo0@)S$?G9*0kbH!kDLW-7BeJCv0k}7v?uQSDH7@RPc{@B>kDPK#eJhG!h{m=~re& zsB!VEEKa^x=yhPIXF*<=iZ3|^iKS~BF9XFJ74-;PvNn6(fllaLgOKAmciBOk{=e7f z#G|G~-F%>~F*9XQXx;;Ym-2b~X{qZgLxa;KT^JKUh`dK&AY^4BnmG$iLo`{%8|9rI zgYZP;$l%f7Hj+sxWShl?Ga6q$*Am`8o+Z<4sIjp9VP$M!=10q<3ZEh4z0qL)OnHUk z5FGB+m-$#Z4G*rW7ejI)KG!T$7U^PvNO6O&ax%Wv5Rx9t%vLdAB!vT(t!xg>dLPYO zsdfCzi?C+hwvvW1(AN7MnMqVa?>BFLNMwbKxoRfoU_L0ZmD-~@&$lUD!DL%zrCb1( z>6AxI#}nPOhb`{qrSlUTwLhXVnTj=3i^<45OaDCSt>}k~z|_Ave9xRQN3!sgqv)6* zEW=Q;E-Ar8i$pAyaA{tdgt$aLa2)G`Bt8L+OTNrsS;~5KfK7R(rfG}xC-;MwO2$!9 zR?(6vBY!SkC=70MJ*k+!1bd@Z`e+al)%@hfIM8*xQZXKInFR5INqzeSIv_EuR-1`j z|EwO&HKd$-2E>=LTFP@VG7IIsT1lMNB2_~JxbtHy{Iw1B$+P$}#iZR87>e@3T^jnbtl385cA5NPMix zyZ{JdpC&8=PhC^GaU*@4-%Tij6 zmXeyHsH%!P-0({QLwZ3?RYl1|1LwUezdnPM+sT5X)yvA6*D59%fZgO&GtY(dWqpD} zktQ*Dt2X#6aYy>lLEur#I+xs_l#R^RYBjr6MSV$|lB#j5v*(7}*R+cFRZp(lp^!5i zP*3pYPa5C*cR;cowd=)_;~hCi!VNRP4gN4tO7|g1JIH1|WxvhOMFD58EWEm*!AZT- zl^L$ye=!K1pDMEK5Fx!^;-ujyvSQz|ND5bK@ybbc??c!Mk98! zsI!o$3^=Y{0+lh#sHQ6;4Fv^yDUWpWk|W_q$>YD9fWD=16~OGY>~idGuzQZ(J5nh$ zd|d?cv&-M}xNw8Z$~4PLZ++Bs_)lO{Uxs!;`2fe(dB4%#5tlNacoUM9Ln?o1{riWG zOyI_q@+Z|U(e~rz2KDUvnC5+UeKMKfne|r+#+=xMb)!Q45i30Q6?-it zkUN}@63Av%F!$hSs{L&7O1)AwzCa6>MFc3x*q{=%KG5!|=_IX5XK?2j@z&nXU6$f` zv_8b+c_n!-0m4KHh(hHepZVC#h)ZmxTy2zD%zr^@9D2OP|EYu4p_vSEDt^pvC~B3O zfDMV@#rs^%4Va3AblsL*C9F|Ib$iSOL)}OAQQDSnU-go@_%)>nk*_;7*vAqNwyuA z@LSPA#Cv^g)MR)neBhL{G-xK9)#m7HdZN9k?MpV}-}3N@zFEnL6`C*aYq+~kG-Y%} zFnG=KsPmfa8uY%OT3)UD=W*MCY6xOc9!}tifeC* zR)-Eb?Mcq#`4+rkr^hju*VM+2 ztiA$GL%S75^4(syEBob{EoMg(;e(6XrS;*VK8EbfLpts$nn--9^4ogbLC*4A__eV? zzI3#Q>c$Q}{p4JXxe`$7DAj|wDqD3-=st-sKK0Oe^yeiE7oc|$cIN{p$gzHN-fo#c zH92`QF5{d3%d3z1Mu$hjG6AjoL|b@ev0fm6E@E&9II=~P2n1LJAkG1vD$Q6u0R_jY z8E%2HdlZQ^X0r-foQ8T>I2LltI25LvQN{hs+xSX1&&MznOY^ z-?Ac?>$|mLZ5wT7YZ~{**ii~txHOn6M6cHP<1EORkdTnf7f#aIPGc+@?G}B@DvFBI z`U*))nQG)6)p2lenSb3us9QFLIb>SHp?P4BCs9waX-<)l)%*#Y&sBXWZ3NRfO~=ON zi6(1wU_F=~uxfY5^1^eWyu~{Rhtjr!DKlq3R_e5?f)Z0x@eW=;Y-MR5z_N{Jy5&M= z#5w4WaodfZ%^xq&={q1((fy?F3+%CjDcyNch+~6=PWvKX1Vs_)2CD|T8!5^49Yty` z;k4TUN5sUW+&7cHfsndcQm1<=EIPO3{eiLVyk2>}=?gMd*EC*7=w1lmfhP|z+m-8x&=XnV_j=}7-@8pLKW3d{ZLJZ{ct(!Z>WTbI{^`8Gl!YXE8oqMm{^vE(*<2n@cSFnZ?;Gawe&&gRIBnbDn1?6e36~! zIJ3CZC!oIT!Sp@Qa#myHJXP=eOg>E5<&zOPD_#usRUukOJ^BjvHh67)ovhbJr#cHV zm1jTE1V^ttI@sm&Z2ov9$EmO-M7_Dl;SXTeV}ETpQSm1f5Aw-(kM~RgS)CiB#b$+q zIP)#&2@x>%w>@f?K6>9WIA&|;@6uy z`58mTM4w$tu8ha?qBJSpkw&zd{f4Pmn*F`*aa$o!94V=bowmEsBrGc8>q>B(Al9In_zW6= z_ZWRi79|Lr^EUS}`pZXHAgxWd4?zG+R3$MnZl!*y zM{&gZgVbeTDQzrhd!W_ZnjQgM5Ia2hH3g{F+hqA!#D3t@hj|^{6iB1kU{0}ZV+|i_PAi$x|cXG*jA@7lgS>Z2`b>%&lvQlmfA-@MD9;x zIpwp~bOUl)mgIymC?y5u-?`Ed4axRVQe69O#1;gErFM7wwV%-(z%hcMT57@;oR*HS zT3k_G9Urxk7ptPCb`{)|@UE(4ViFD39Y1m$zHV?k_kFq=n@n?ck>J(6U>bBem+^VN zFS+p5#pYm2*ycv9M0Dsxl!gSKp#xrIn4_-8s?uqS;gf2a=`nzT z8~9bvftEvMrfUQ9d&CgxgEvAR%bMV=NXN(RTogX=kh!a+b&@9TXq{P)F_>sFlP~## z?oo&+wp02-b6Z^Xqire7=HTEUbQ*&r;cV{Piy9L0=^y_t)eEj%Y6t0Z?<#%=(s%t# zrSa*Z8ssX^|7vI`ba^1ixbO%8vtckXQ-N3>b17 z3eZ+grMu~-6sP42)=*w0yS;Z8_`PFfd59H{FA7JFE>gx)jPo+KncD_!x|8*8%>aE* ziR)C2dbiD#T(8xV!)83i1TP&#-R4C}W6v!~ykQHB(^MOvvaYLov_!2^uMZ3uufkqq zPE%#jlH`zUPd98I{;5_beoj2sB(C;!Q#ffp7hP!HyMrEqP+kQMNh#eiSnCA3`5R5f zzCVrI`HBZ|R`3py59v5w3Bl*3vzbqUB7PpyDPvUHZX;;HfScV}8o7bHeghf=mhgj` z4hs%e5CbJ*8d*(*@Q!UJ@61nOFntY0bV5L7N-tq#?=dFku`K4Sg{vfe%5zKxHzv}2 zj^IU3%hKJNG=Z1T`%B%(l^j~~#$HzdpPIkK=XEy?%y(et&ZcD-zW$A*^WcwpW5xB67U9S+&KkkD5U(}ny5TLc6o;(PCRp{Ika;;nS5%^ ziX*HlL~>#T=n+j;-DcBa_ho+X0c>Vx+DIQz@>r=44qxv#@iaGgVg)GtC6lf`(KVTU zsd6|NzXn?to8#7U0EET}zvmAaaLOq{7&I87ctvL=T;(j@;;#ZyLXIw?fWY`enJa>@ z{Sz5T63{5iewEezC>Xauf__O%aAn3hhaDVpEq>s?%z7V*F7umL9^ZgCk$aUbbOsyp z+%+K*$#tf#5yHI?^0|Xuh2YTjVg2EVAu<9sxHZ~f?WmLUkDDUfNhu9#NWvJi=UK9D zlikv}jAhKz2)}zfXft#Fq{FpL3OD_F#vg^+MeqjJPz;eTn~uk-QWu)m7Kz8mf*O`gfKC#B`9ZW(p>RkZns%3Z9US2M$zAb!dF-pZJB=lzRy?CeWPV$9Ip@Vz*}{NKs4*QcA4%`S1T7ewwNO^Q5n3|MR540T-QMw%j|F zBJIZ3Qv@n{x|BlgYA)qL9aH7imm1(O9LbVUc!Z)Zo#ms>>Yv^Sfxh zG6?~L&3FJKB04g8Rxqgl%}^DGZLKCH;Ckzl3&?gl zx{y+Kt~2%^vvrrT+U6sJ+eMZ+yWP4s6iIkBkKsp2M&USxTS4H^FYIILqDRoZ?UHa%E1Xby2&_Uhe418vvJ>r;~6@Ang71%jD;>& z9en+IYXRWen^C@^!L=obSUcMh&?|oY@s>Y#0zWY= zOA*x+e}{_W9`?uzjrsJ46m9xx`)@Qf=V)tMVIm<(DG(hQ4{EKTS?So7#^B9#ad^~n zppv3?@t;6l-x>ly_#C%c3RGyhiVv4V|M!LPII8k!c6KE9wn~vxB>g~f#0_#$a=DR% zB5D(jikc=*Ai*C4fR6ft7@=h$X9PlQ~6GCq~HG!k59(cWRbjA4hrX` z_^P!z)LE>QY|+ucu{M#{V4|G5dIRMbeEsr&-N1Or*$j58;6M(~8};Ma5_A|!l66EW zL2Pp!ubJ<&Aq8welEWBM(SnK~I9AS|>zcDr`4ZDiX`33z6kb(Xp5!-t`?FBXOlFpL zjf-1f@yHz``$NY}BK$4U$Od_erhrF62mu=4{qe*bFckH9{M|Jln8%`ENb2?RGgCAn zSHeAQxqs+07N*$DA+r%8B28lRc^-YZ793Obr@_4_qH#&uY!APL(xdqWRh@<`tK?1m zdzcSs1mCkxxl)ERGba*DqKr^^n@&6ys+*(XzT2#TGrv>L{8sozZID(s(4Bv30G9i(j)DUg&S~p-Q^{yrKE~$grSc(w(I?XmBR-1aRO?2t$y_Sy3}8-*QZaI zy3$U-@v=1XtA(WoK6%ZA;vfn?&{(JQbXXX>M1V1pm}`pb^1m!V8-e7Ca_>I2Qa7RW25 zTu$CD%*aVEebL#v7a&{r52%KrQ6xr2vK}-ZGy2WTz{oZG8a6&Wxe(QfT{)|0_+kfi0M*GTSrvyi~%$`BU=}`2Rt16j^(MclU7gG>(?a`~E}#kP6plN6=fRoRDOTKz z5#70i^@wt$i7rWat(}F**~BxA2hRQ^fn%7t)$12a$V9kZA(77XAU@QWNU4G|fwjVc z???AW=taa2K_K#=SM3NxOfEgHy_G#G@oI+de4oC0qlW33 z@pY0I=rsFH35v|bM3Lp?W#{l6n{v*S>b5q`w?O{lz!IwfDx>Fr)n92C7)k&*N4)#x zsxT=s@73S`3*_LoaN1~CQLqvjPW(|m_AmfVX1HPNqRDd}Py*9p4vtR5iHU8YlU_bE zdDJZhwG%}0F*V6L6Tm)yuvEN=E1<7wT>b5vzS3efDJWfH#8_vWR>WSDrRvwEd(b_R zQ+5*YYVlE0U)MP8`2#IvVMT^<{>}Sh2l)hsu%a4A1=+dg@(wgyZj56(NU_biCEM(mwCWru zYL>}Rf_-}+V4n>m@s-f?xeWntd;7qYiBG!Yv$<2b9L>fD8tPDU7gXqwRm>BoKr{qp zRR5_Gi*=p$c_^Mq@e_6jf1>dIYvX9hO-ylAPAQqcF>e!^u;ubOUc+%iP)d8XW;c(; z6yYmNIT~lLdY^)_del-)AVc;yxuT_8#}j;g%N2>miTaTL{x{?bEB}!dRX0GNMwZHH zEz?^#`@5i;Oa9cq0W}L4tDBD`kk2IFukoY?9Toog31X|DmB6LJqHii8plGOifA!pf z+N;#KrvH!KR`h&=i-`Ou8We^C*jghfphQCLw(tlwoeg5I*42m&x92dQ?z;bf6`2Zr z?#FuZk?eq4=oC=a+M4=h;x$E+nPzs|XP8+|2p7+v**Xkn#qU47bn+|zL?$JsN)vH0 zJId?F(Rp(^_QHsdt!V} z`=8zg?E`Vhv%xf$j0&EEP*-#ApYyV`?$QyRF@O@bxm1$YL z1=#=k*E}eQ*a=YYNi}J&zfH9rd8;*>MhIUwT3%3~TaJ)J4I-bqIUfE?>%nkL(GF2? z2L?IG0OK*XV5^BrwOTkGom`4%>ZK$VGn711t{8I*V}!PVg$59FB*z?R;)=b=e$1-G zJ$BE*{(DZ(4E_zbdt5$s$tD+i%cFXWVYkr{eo-kB@5px0(RW?xPvM^Cd>owNHTgtT zH1Dnh1awDj6!oKsz$a0e{vWZF_#bTi-%?#tZI6JZ_S^uBDwF<-u+eZ#;m2>7pE~C1 z-Hsx_wm5BQLF6idOJ9x$l3G<1rpYxhSfo>h1tg-*n*}k2GkH8Dw=kSz><6%CmJ?FVni`47b44 zz>|6DbtNjCUnBdE_LnrRe~|odq2d26REc~NbFRk9WiLOm#C*6nXpXX)fc)l^w#4M% zVD>*!os21N2!+^rzL>l+BXlX#QI)yhA!{*%L;5a^PwDCcTD#SeoQTss__}dTw$pPU zJPa|jfz=C^^9;6rGr}=lcKMIsYip|!v~I;1A%ROepE}4i`9!1K^slm_io~#^TO1Z8 zhYjk8Wu_ILIG>)}u#rngOl1thh^4~N&M$HS0miFcbqY0H6bG@F1X;QPh4cC8m1wf* zC2wzU4;SZ%tC*oLh&AdA;fjljrv9Y6)gPNC**Y}wQ4YE$v<428 zALFW5O+yxxfd-$b8wh!s-VppGqa@GKUTn%tEx*qpfU+cVNT=GZw&cD&FCVaZ{snoy ze&#q!DW^L_`V zf#NQpttSN}>Y-6ZS#|2CQ=(ux?8#Lz92A>U%R&RN-XJ(xc@1#lR6Ql%;GRQUijYn< zX*B_W6VUpDOScf!uT*viE{Qe(mO`d&C4#75r5FO4nJyI9s21?|ygBUc8BxpW)bzcR z`UEE8^US(>d_148pmYiUuz1A+^m8_@;MWPh)~zPqovllUYqfmPKVGkhjapAgkj5t2 zj1-L^b#c~(U*K~ZrHS2Eo~XMq3ys*lg@4yyU-F=9Luw!<4-U8EIX zcNdIV;SP+Z*Pm~5aqf@ixQdu2@~lH}hskoG6|;QS?@MV`2rua=iWb6xA(s$a)U7Ul zJqmZOV+(479kx1l|L%dAp=aUa(%~+vT2Z?5SjU}%&X1C{wwxGn8Kg4Y+*#%^UTGE* z7ziDIzS-r&gSzczEthh3e{-`xFg@t}^1!^(V1|xL#2>XknJXTEQcgyh$e&-8k~!kZ zS3EyA1^vit_6P*9H%5y97{kKapuWYdtf+9Z-kuwZN+5f^KfZs17qGp|^oM$3W|O)~ zJW4C?tA51KpGoRwfAHAQmBz%QfkfD>7{r}+&*(|s7F?I303=81Cb zP-65m{zf;+DW|KzAdm|+HBRPF|pQ~Q$2 z6xk#}x3x44vc+U;w6aI5X5kKdG0f>Mq0zBBzb>)xpa@DL-aEmud#L}aY{rIZ#^vk1 zz*Hn-*Kh0$rMWUC&ihD`nm?&iA;<^R+-=A};~9y?_CO|?n8Ns2kqqzZpNra6fB(f3y*j?o@r~gn9ycR@KGMPe7H!xwtr1xF0{Cv6c`)beP?oEOjDzAsH}aM zVISl5;ukUZ?c(2n9wqJX+vO<@Tv(d|KuC&f<82fbmk(djk%ufy<~fyQn`k}iqdUFV zLdtjd&iWiz2uTJw=t-26v8#=0HP2Q@M;&SQ)I(U#7{MvESK6AI6Uv<1DhD}qL z1CdY<)lpxsV{>u8caCf4WNHb%zn*Kocqrv~N#gz?0sU9g$`3&%p?C+yKpCLtAyZ_x zg_kr`Ptsk=TCxr;+Rhmxf4Kg}m^*yxXYyir0*ztN-I6OXp4lCT%X{(V0BdL9_$5Xt zi)@4a^rOf(Ls6UcLYw*{f=+oLf~>31EC=3jX~nBb0R5<>RngSts+o#1u9>-eMc|xT zOqDGuQSdd0&(TdC*v3enpJ%gMVe9LLN;8#97uIV?zz-%-*1z7I?9R(|BSZ8-KXAFY z$LmQNJ`kAvQd-9{Et?gI>Mz+P&=}Vz%&qRqhM!b@Hyp3Sb41m`wU{21NB>KQ6rF}b z&T$Vh9Jzb#a&bJJl2P_2o?)#sTpZ%Nt*2}ugzX;5m*WB9#}&1ZeSn2M|Hj4~JA@YK z4h-t+=RuSgBUGRtW;W=LjULGMPbg8Esvj7T+)iH_`}Mp=F-iq4Jk*!JQ?jzdG4=M(si#B7;X_lr5f9yJS}8pj#;Jg4 zIsf^v(~4?XN{|0362U|IU1-D>;)e7M-93G&eRn@pg}E}+Kr#FYDh)e?+sWos=NBw;tGKnCpp&LcO518~B-Lz%o7*Ix8V1lDw}G*um~}5R0YSG-R<$99!}pvV+l1%w zXug$CV?dC!_7@PK_pBom*n0-VYRPdXYrRx7H|iS9j=rK@bSJj{i&XQI!8vj9beyox z`Q09_4%2KqJ>8hL2g#HgQQ`xur@!1^;Y6ocSoIj6zF|yx2ElX_A2Y+Uk%GT=~ljTcAX8DvxH!_Gec{bC0|+pLT~tcXwPCb75bI$!66~7N<&r z2zhkpR}8zfxVSt7aNd@V+>H<%_ySX>2CM~5p>-opq>nEg1b;INMd1d=bfkMxZrx%+ zGW=9b>t2S2-LyzvrgF$B#Q-M_KUwbFaSc}n1nC(>n|*C3Iz*H9Uj=XD=JW_lBk`fjIdLp^<)k#2v*^O19D6^Fua8f}gvslwUY1pRh;hbEf$qz{*p3^c=*|0t{?ju&gSP7BbrmiR!vTMDHQoeZill!pXX))XY0Ez2nE%yu#*w?Ig#qq?_k>UFQWuOH10 ze}}9qYpO^woUW6X;&G*a;SV5@qA>X>AF`#YsVGZ{2Dym%#WQ#t**U5%1E-VHRA22p z=4KXY2gBvTV5%GE$Q|mk&8$J$mT%YfQg~)+X<1QR<8Aqkx`$fPTssa!4QP3*ERRXe zR1l;_m@T_eY^`Jn`vI>Y{-(dC4W2AKY2j8bT5Ex%XS2npu|p+GNg$VTr!~ifhZgLYAUp zs^oYKyUC+{dA4umjjp~xC?MCZ)e_`*B%-C2vbc6__k0;h@Ddbgo5|Tcf7*Q7AEvbO zFB=qSjmG^8s0Ud|yjt?zbgRiRI&D?YJJzkxX}syeU%1ko^AHndB=Y;(mHadcg_dw!l)~G(iKo@M2nDgBOSWrW2#q|YU^4^JYivoX1!UegS zn}FjMdh>AvY56w#cbjfg1nKCoG21$2QQj06=FtdFv1?o?6sXxs4Y&GH2F%6()bCrK z^Z&LCuo(xKsES!lBd+F?*wApRSMN@B&vYRyrBT7KkMVHp!Hul~1LNnkgC?`J#AAzI zF4C6;RR*=nIyxda;HtKP*8EW^kAyMWb`=$N=ps;ta!)X?;->d2YSqiO(QzMQ;=x)= z+|x~XYQGf9Cw|^^1>4$3h((YZ83`|##ODDm>A>QwBaFJsjnTxrR9Af6(pbc6+Z#+6 z&o)EEHOL7sHqsf~V>QuP6dBaeC<&Yf^83r$x(@sE9z^o>&e@ueRhvMS9?m0`itT%v zaC_|mYOAj^k~M_tL&`qU$DZ9IB0=4^_^M6+6{3}7I8a}Nbd7wn5*rsQ4)%t7M+x~> z4TEkgHR=N3@=|I1#ASoYw4Cr{;;GiOL2I*4Li$vD{>derL|6m?U0*|w@s5f5hCF}w z5*eA6Z(+q6Dkf?@6DiHo(vqu{!7FW)HUwU2a07CTKiFObU(q+6q>+-jS)R}v5fLT?trbCs^L{u9p>hXin~(f&tJ0zS(r5YoJ2OWbova) zJp?M+ic+>vCtRpkxNzTVVdf+$R1Y$*iQ)8V#y3VBQUTpfjl^P)Z5_He>!9`vM_ug$` z%hS_q{aVS}R^Pz}`Z$MWAa{G9{83GLdqdxh0=MD%6E_wgQ(kr&QWL)p0j3Mfn}hrUd&`P}x|DuC}MEGGePF1_uC7~p(C zKbg5h{{yKh+LS`g(MCI-mpSz_TR;w_V0iot&PIte9y!)+QPKL%xnH+%CdWJ7rOXmE zH1|xW6LC@dSyv=9%*(Dg2wU7eBS~9vA-!>Rv((Nrve|ZBma+QIFn-7DcDKs9!#pa4KUwepFel6^)csg0fvf6f|5;&ss1>$Y72AB&CrJY(OW-g>c#y2se+KMir_QmUoo&HqqDlf2^5egbQN zam!>66KJcC+r zLf9a^pMYJ;WLRl9e43`)dCNpQk5A6Q7rbmZG6PsGjY+C*!ksM{OG7`j;D*!#I&Jamt9FKOB-?W zWIWL>|9OABL^hx3VHm^)qsuG;ErRPWp9RLZZd-Y}IQ!^zf_e0K@GiuTlIHuqJIm&M zp%2H@>Zm9&K*mfjcexNy@6be#nv7F(AC#G$J$`EgiHpO)=W(^}q+oX`?%MJJ>h!)F ztyN{@7(Txx#wjTM)R2CDz)+dx2EM?1o0tJkM?~NSuU5Fyoc-cZ>jkARHNO309wjaA z1kYb`yVN6I0S0_Go&JBp74$jA=R?P5^ANtu&k2>E&;lr(~%#$Og`i%iM5$?ozxxu~}&h zf4hwJlfT8GeCkh}oVxgmr0?ixU`M4y_;DB(J&{JBVq?CEWw^riJ8!kF)5C><=UMAP zsoVL+O-uJ{4XBx0(rXrz{M%Qn1&xWOB896HuO2S-f7m_F@hi{m3WA(46kw)TE=sI~ z=%BtiaF23=m%8#*hc`5PGA{xFa#en7-fpo8wt}g_7p~SY35MSwKX))xS_Xd(JK*{y zE|LiX=lPmYP%1g7;==t9jTg^L_@c0CZ4@xZKChgV!_ZJS^}xUT*?9GB>IVs!1OWub zW6=KlfNh6_hL-PCc5u`$ry7?VDiJ0cToNKgAx= zJFn4R?jZEQVkjy71IxW_#j<&qPV^5XiG?E?eU0wu&|YbCK`t&X9vKIwe*m3%5hbNW zHp>aW{TL$;KD>qumeBc<7)Hj#6f+wQ%~b2G!ezOft);&`Ep{_UJO0wH7-g%tlpC+3 zG86$y*a?&A`7%pr#Ilg0^;Hd`T9Tl_k4aF#|TmLp2Mp57mtuv?PXMqkbQBWsXdoHKMb20OcY zOP;rDqVuPa=3s2M|FP3Mjh`M1tPyYb1gq3Jk^&9kdybi@kqk5cotMLAm`3_1AtOaH zv*m2htsud@%`BFI&GzOC5+WK~rp?#phD;n?ht2qp`HFg673l>zrN5aH|MkA+RrbPo zNop)}Jzl*oT{hgF89h$~Ic|OnyPw{4>zA6hBCx^(o^8IeXJtxtDfc%?KYh|NlDXPJ zt$r)RH&*d3w{u)kO4;I3e!_l!JJ}NbbAlfv^^8SIvZ8GBZNuTi%242OEzp0SdR{BQ zWk{XGi;}nf2i)d(n*uXbZ*<&NyhwUP?Z-*L-SNLH0JM=Ib*a@NMOn9Y z%M@-FP%py$6w5e&0N~L1${UNUOiIay?|U zxVbVU#_M({ngFLqx!?at5+2;|;vcRyh4T>=kK6Tx>J_lUn+43G%-LXam_@S@A;JnbGny?P;BhO1WSrNH+#pEhqo3 zF1t#oy39yCpIw_k zo8dg0^c^8hKQ?PyTKRWmew-dIQlfiWhPZ*^>58J%M*De9f!e0FP%PcAptpziWyO2xP=yz1k`PEI=y+i;|zGWk4Qw%pvO z;!111zomvWzW+shdX9{=Fxs|lb2!0R=E$>i^SqodZhX1Ey-6)O80#chMI+*pnRL*2 zgiAd<_tTXy5~FrVI|epq)KB%N`cxbgAJyXpHIzB}pH7uyztizOZ|`*f+^;Bq?FsV^ z&(g7u7PN+DfMplyJjY06UiggPhtDkJ!+6cU@Aw#?RG;{?BQd2PGSC0N_msxtlOWCu zjD~{qNPWtjlwAs3miox={@jK#uO;7G@xop9ihtGI8gO6?PYG$Go|`R7Z0w}~V5BN_ z!Y&A$<}8v2BL0~F2XIHq*evJ5x=3l7yR5cF({G!Z2;mcX{}vI<$aE3lcF5@WNK0u$ z>UlYcSGu0;O4oDA)cO8KdUxY7qxYbFafXS7_1W9Q@kCMF^Qai_lY~p50RJ_mf^gDq zOM+nhbL9L(M&>4@IH?0@l^y8WW{>zAbt}j6o6GT~);}WZ&owsDyr{p}Iq@ZQ`OIVq zGm}Te(>+n?y>R~UGs~}lFiO5}GSz&!@e{h)u(JFA#=nSNVzjomA|7&kzr-bZTt_D! zJ%krF2JvykZz(wP^~@l_Q*nPWuOq?U&Z(AI-3^1V?K0~UeAJ#o>&n{ySH}`QG%+=rR^7W z4ny38MkE}yGB|Y|;;AgB*6;c1{kr>MF7* z=2UWo&A}UbyweORD2C>eNr)N)gqlO*9xi_`1dk6Q$|nlC*&t2gFc+Mx;AP(Q=@uQ0 zIhxTBoCpx1-1D;Z#J$%6sKqy*ZCK@OuFS9ZoYoQ@(~gt%VW|E`C#}eev5XC)xzZmppAFn^7q@^f?{nc-KKI0M9K+iw}i6?Ys z>8&8Cvy2-Vc+wJGkN$(A@J}}ymi>u9{nG|*QXchS6#61yE7#|4GOIBBP>)UqO{R}B z=Yj9Pel-EDbm7lrg48Va$mCI<25&|b`On`=wX{+AZs!`>NHiyM2SJN)T#diZztn9K z`mZWZhb5NC9rjN3J;ut9wqirk>*^wPqHYv@f?${DS#G_E9~qA#-hHpaEhjE@$*Wlx zcou@-ha!KGGtKZ^>~Zmr^#{$lf{V z1JwVa=_^W!kRrB!L$_3rpl#C*i-f#m4$W?Z zpMs4g0vbG@EEb*v+TR7=*@@KZ|B;Cki}C*!^}-hlr16g}m+sI1EBc54Ix}k7+O$~x zON_l*od-;ImozZq+N}2~g|&7?)D1$K3wci3%cAKB<6s|Gcme z!9NmFljJ2a5*;kyK4}`W*YEg87OG^Q2MSl06A<}7-;%GWsmbH!=C&LBs_{LkuV3V} zQ_;=s=-ez6O1@g{PsawtL4E zqP7(U_JY3a>gS$)mptZotoP3&%~a#xvWJs$6<+rI`Bh=!+G8)8MPX!BW4hpSE`Lhi zOqOV}$f?@pjt z{lM?M_}Y_KeXsleH))Jp&hYoHq|A3LRvZ4lpVjqR>ryrqHMa_8f_;O#jhjQA^SL9t zJ{uglsaQ>0;R$Bqj{zZBQTbtr%iK}Eagk-P_*XbSl6yye8e zzaOA2faRz%cik-Yu-0gitprUQ3+K8=3ZM6&<)u;#px~qSHaVQCB0_=T#@jJ#Oo&WTiA-~bXm)Mgkp&3>mMX+paK#tS7|!e{gM~) z{mX8kYxpWQB2nFPw?pnpL5FKy@hh}c9%5HtoG%EXiR6`EzgG8?4Ie~2tp{;iOCW$3 zrWd$;Q{CG>yx5(F!WMgM1=;b}U!9aq%_*E{jo_7#P>7Yic!Zi?gZ|Q2d^mxEsSuT}{{x#H0+eWEe(3sXH=lD)Cy_cf=0uj6 z>Ja3=Ix2Eg~+>O z_Zj!Mr}924d{IB^|As#7V-F3>#YM4k)`vKEx`|>b#TU-MeHWqHAc%wlCM1+&rvaBm zM@NmKD48n1p*1V2H<&<73mQD}bw47JC6gR7y5A=(Fb)FuZ6atzzwVg0--+z))hdUg zCn<-#LqHFICqwFYfty^Yxr_i`Zy?<1s&hk9C}t>@?VD0(DyBD+Ue-QMlgN5P3uxr$ z>J1%1>m63Vg8g*z;mJR18azW-AM)NGSN{POs%eFuNJI zH}(xeE&lqYv^Cn_6)83w)tFXnvoW~g#&rQUpxppSNm2Ec92we%{-gSQqmd8EGZOE3 zplQr#5le&P!0(I$?OYnY!m|)gj#P%R6*-%*6$whHiB1bc76tn4V8Qzvh7r;zd{BBl zA}mOyK0K^g_$Y3=$(U`GXeIN+XKOn3Y{p%?JByDf`89N2BYTw34d6``wyr*;iW}e5 z4o>!Ah4TyOI;$7b22B;7BOzloVQEW~K>94awin0`R(Rx2STYf{Wm2MnrUl1ZU23e9 zPADL05d^0Ce;xH7f`#VcuYtYRB>da!1VsFG!qyjlm*w$-Hjmj6{5#t!%_5;Uv`u7X zhh1V&i4%383F&tB>bIqg`IZng_=JG)0fH6?xymuXih39DmQc1z1< zoE6e9*S9@jrwqZ`LqGV8D$4T!$7mGZ9?9KBTYbG1sm!Pc$u@bl9x8PBs9f_Ro;r6N ziTsS0)P$YTs}FfJU}*U}UrR2+d@xjs*NUfnPsW4Ij~(8&KMdp60H{K*t5x)Bt5ob} zK^Fx}7-;`pu5IY3q*f+Fwgmj3X5br5^hp$DUf~59I z2zp;`XfiNFMWx#PB4%+1If_=2fAJIRL( zmvlle>NGeI==YqHCFIG2yc+b*oL3}lD4bRbjMc6-4o?Xq49Um}eY+6g*ld0{Bbbs! zMaNP?DEY20T5)b`R?{#`;}wPQ1Pr zuBuQh0pW(!Y{%eKAmK(!`@+!~R*UHEf(QiqyE&B9rY%WYZWjkEu^~W(9qSd4F>1%} z0#pVe5vEle92I45W!YO6GsW0>d5(;~`WlMoU5Vk45#EIFs=idD&Ytm(5?uY}UCbV` zICcSWDJP^xkyWtMf}$}iG&cv(a9DJt@CxWch}ADXg({&>Yef~B{i#z5^Vz}>Mwlyj z`oaXp5U7e3pD5tdvkg+#3#7XVyS00JL8AdjUI<-~9v~}=6pQXuKv1yS`A9Vm(XaD? zEfFsLfC!|szpSe|xIS4ms?)I=cIn#j{&V{r7GQ^;mGL&2MW_(G;u+@)=Lb9Eb81eX zbm^DzAc=lMh3` zA+|R(3#n)Ax=uI+hwM-KNMvDnu8FTyyx&UI{Ien$@RKP=Ai%!sm*jl$c3+(5ZA~uo zZ&tf`Sfb+L!1rM!L_r?sE-6v&!{7z*v1ERlvr@7JyH}0;tt}!Kf(N`)Miz;NQ+;*) zT+=Qzl5iF9adhqjZo}%YG&f7+vFUWAPVup1M4twY5t$e2beyM8xRBs2#|kgbqJ4VU z?-BeN9MSJ-MTed?zqog*0@*NOa{zp5B-I5AY|4mqH;+w_ZpEG_Dr4LcA)o#{{K0BF=<7w9-}JR;5Wq=Wt~wXS z2{0zngFrp2!IQ_|YRkXE8K={7Wc5&a6*OOB1R5++7VszpY(0M>2iNia{OPdxk=~38 zy6T|M$(n#rTe#8(=Ezf40Rjkhm4q&N4HiJ<-H$`QlS|%=PUd7*6VTehO1K z_SE2|NFq-i8p?jm1#JognVd`tBV%<;QbYtI(Ln52&ydQg%fS)s zP~w2Rb(l0&+V<)CWp1wRf-&&#nR9iJR#Xb*$AGTV-rvq~?Z9G`M|p0aYx42 zuP5SWYmqdKh?%C+nYb}?0jHDuLx~Q*4*%xyP#Ab0`7%w$%gvIDODFQ~Ox+qQ-UdwH z22YQs*%+jm?;+`OvQ z;hL55qkeB1wW!z^aQSzc)N;I3_ZMme>O9(0*{`nivizs#4*7jLSHnkj=Fk~W6sPvZ zP`)3*J-k(&CO@vuRSz+Y&S5E9Of!a$;slOgT&y3}DTF@6b@-vrbCj z3fZUub8dyd%U$(zgHrYm$gvu@2s$Ivw`cO6Ts~q)5!dmx==~vvHNI!6r#KABTWQ8p zNSzPvm5f$W<>!}n_s$}4<&%?!8%MScA#3-4uQQ=++e-XG(Y_tSH0_nwOb8z1Zf+9F z6|=RI+FG-G(=Bi0An|iD-w2fUV$h1#2Y+VnN{Y$vL{>8K8x|s?@r85upBHsKa!j%D zp%t%Cl&g=2mHnH=lBc$`!bg`m{HlmK@jm*Fu5`$_C($_LFd$WiWe3%t3@R}B-M>); zr3LHHW;YRl?+G0JZZy1xJzA|!@R_d-8Ad%wy@cxcP_CGuCvfqmpW=RR@n>Q~2vSAq zp@!e)yFcKAkM%>@hp^&e`;TTrl*c-a1#6G07?Dnf6`-_N81M1HL9W`<#Ssv;>srGp z$o?|J{1mthuWo}mz(GdRMX>-M?9?`HI!s^Kx*vuQezMpJ>X$uC=6n1(_o`BW*{^P_ z^9nB`uYnImG$sYV?B~pnn_%x74E;7&de0*`X6vf35tHANnS&cAJ(LECHR^#G$v;;- znrWKzON`n|IzIR?YWyKwkx@<--no;yn>eAoo7lxiZko!i`rQb4W4t*c=93P@^5y;pf4d)#kHObD3)Eejb z&w~c9q{`{m?J_yvB1$|pVGk!#k0$|@dZxSbja*zouGBVfS)k_k>;4lv(LV`hjDVX{ z=`~@6w}p>Chradc$K{0h8+a%E=%wuMk2Zzd#;+OI?c&2B`}1GKAC7ny8m(9+;BGk9 z+4qIDp0AfRh+vpFSVM;5ea?$ohx5{F!fE*6wb-ntpQ0#Nyg~Si1%7U6FHPb@fZy(s z08gIq{`ce^%8gdtmz86(<0R%eF4Z(#go*{?PlaV=Xr@8eI)ZKo*uOlcMQztws7aNr zD76@%MMd}ra_3q>hP$~o=U)Am%!;N~PUPv|iKV?vKDv0LVKoWAT0r9}!Z5?KYp=^U znEajwF<7}OYU!X-Xwfk;vU<_U@pk0LnsXNC`UYYj{RaLE0z7(H3Qd9H-+?!&o&?*>{;w6VO%jTgG76viEX)yhGOsFK*ujgF8t=&dULy01rV^tip!3ygW-7%;n-Bxs>oi;o$lE;EwyfSUR zZdTX#!d2Cw3U6FDk4{hwuQ=16R;B2b&(bjo!D2?m*C9oxX7HDm_7wqPU~*9tbg9tR zu#Q%bTz|;;*siYWOMCzsu#8g;RX57p*MAsCbzqMppEjF-3^A4R6iDgM{9w<;2Up7$ z?|A=P@;I{^UUt^C%<1y$?>uq|%zo7L;`C^nTg7x>eoO{O_;9Pk5rAqLRQ`F%D|J?>k@JRZ zPvec`G?@^T_8u=PWgtotiLk8g&NezG#a~nP1Y1akr54oSApYBu`=}PPuU~UHJwHE2)-!hU(O)Wdi4Tg2ZqZO}ux_}E*-Gx^1JJEBqjWSBM&@SK|;^v1m)gc$E zor>dA6CrA(!0-tOA`e|{S8#sn;@08$Hp-$@G&K=lTweZ3$<2*JF4MFP<09iS7sMu) zw&bDVQI^dFarVDnpdV$NRYb#Yw3C+vrFqxbPL~mO4&JpS6D|`-j1bi2E8IAfgjVHX ze(iE4#EfbS*tRGcSOBb1*>zIy99I@XCh98Uk;A%`s^Wr`7-*w@N)}+g8SEMTW z&CvM%+g|w#Ej2tQnUILmfr0))qxlnv|99KH1+D}hrRL`AM<`{=NBs2lh)sq7@3GI6 z;&-bF0rf+GLY)BmfuT%41|O)z6chkPsSHn-vNv}vZK9_*15~AOF_F|Gq6cW-@SFl} zPM`PmBTb1R6eaz!m=y|2k@o3<`wjWE7-7GbT%&spr8G47CpaQX!qIu48@B2pS#-s{ zmWp`8+a=*_p!}0!b8~twdIDMud?M<}Iv?2rTkf#0uf%wuH|EWKmNy}miW4-y4nO`| zl=~i73K;b<8(9%DD z@hcfM8?vA-&7dsX3ueEDwqQ14Vd+tR0t4xvvV=T~#3;#>-~JxIdpXUnp~Dd(C5*mM(!1!O(+H^06_D9){Gpe5Z`#Y+bkWa21>gQh*Ki~ml$6> zs>JGP>Y`a%;!~2K$~;^<-JD_!L>ct>2sbyR*5ChsF2KxJvJ~aj4vTh#80tcga$HPU zY~r9JCSlnbP-!sv022eTn>mV4#GN4uZpXvGR#0=aDMJ}S}uSu{0Lq?f;`A?yZQDq^L+KHWMD zA7#xFOD!g$M2C!4rdU6&jiumr?)YFnqA08`NIMg%y%#77 zzigN;7NveiHN!_7kH2maH0qRE^tbT&6XM@GR?aAbY{omj&jKaP{{A`QaKHjvqYY#% zaK3FPZ#>)RWCjoSm7WjKSxBnssqTD!$jL_p#FNrws2r5G%HbzB))~n7_|xShIhVQO z>bWsU=>TCrzrochPa1A+(SS=-XJ_7TDUkK4lYM$3nSo3eZmY%QhckWPV9h^5TfcJ{ zuBZk`)EURh0N#lh=&!(E+L_NTYVe136H^xGcSA;CRfOOY71{}!kbn!5yCaYKf#Tb& zepx1k{d~t-py^oUbIwGH3G%q%8$XXY`|Oga3l70$e!mQl;q3PKUX z9%Q7=k%(}YJ{95vf55S$)}kk&O&=8sTnCjlISo8CsW_oO@!a>FPzTWMP6!3R z7T6W_Jo**NBdRhje=71pf?as*Tj-e5_+3}pi0XyIn}|1o)WT}>G$suR<$vy3l0IzS zZZ+JHcVz|bfgX`Dv>v|SxRMfKfe@B1)2^$8_1)o)`jLQZZ&fx$#b8ya=jq#E3i=+jLM3 zS$MI~_#iphNN~w~E-OB;k9S^X=+D%`v{NAwn1|U{S;7Q!y!$QgoC_Q`A2RniJnrJ^ zdK$E6D(LpeH1m+9l8;iP@4r5dmnBJvd%@uLJ_0oIDMe=Ew}?w*((@mJ8l&cdQ3bLS zpZh^_G6_G?`22K?(^tMx)3@U+!K2f%&fnjaHz~V$mj3c+e_UPCIfVDlm_6?mIl}!e zq20q-v_Tka!GEYrH;yC-fFuvx-t_AF5PmkN^?bcGSikH;t!Xy}<^@)^FSC<2qK+oV;w0y z9l|FMcXz+sXjLdx`jqrI&2!t=o)_qQd_3JI@vW4hOMJIwUve-e@vqw-G_Z8DzO=>P zK8wfIC!e=?4nI$AJ&kb-b|bU11}5j#V1(8`CgZV-R>Su*jjW{%bMV1p59z?!cNt$y zB>U}?mr9CeWpgnouHJ9$8l=uQV<}w_n!_PO3m95t^8~Zyt6Fr!nkS1vD1rG9KZa38 zjMeN|$NvBv#{RGjstekp9LAj8-Y{X`G*-})#(^8W5jbV`!EK}h+^p1rEb zL|?d6&J)!r+9AxU3nOi{3{SL|LloC)sGN?8YJLD*8unTkbwws&|BL@{l~BLz?mOpa z>4oUu3bzy47!n-I2&fT5XA?voewyd)e@D z{d^u}J@B$VI2`4Gm3AI16q>}?cs)VnBlS0U<+>ARWqJo1;!r(C$6kjl%j_AM{7E6H z-YT34uxTT(_B|9tMfgOj-#%?!uTV)gm-$@O>wu!e5CVw(9X=D3bz}=$i&(Z$xj@rb z2c)%rC4Ts;vYrU6W_%G_H9b(*ucJ<=jnJhTC9PyEFM}*oh9OJA>OdTYQVO#2Z5k>O zt?wk}`_hI(DMrl0dpgkDhn%ec3ybLkW51@Z<^dg)WQPRmDg4prJ>H8T(0KO)d0m@3 zH-1WStzG0k<^--4t?<~aNb0=TaSE=)^TUYsEpw&GXaphHh3QYpVOmY%cF1djvbPg( zOe20rtNu5)QkE}?cuZ+KFX@$W*eK#_x!PR7&UImE=@^J_=Nsek>3mH7<;H|p6J+I(0GVvF7Y%%RV*fhM`Cf60n0(cK zf=Z($1~g~*n9DyV`%P}QmFl?Ks&Y3e*uDR}B z7zeD zrR2NdC~XD1O>&x15)v)}bin76oCp+0@}plJM6+&UL{7B?VD1q8M9qPtfko(7+uGS= z0+~B;OfFz3`;23g2k z33g!A>J)n^(FQ(J_xyGVAN`7*RuFE-MOfxY50wiHDjFrR`w(bWV(ovBYEw2bj!xHX zNz_Ha7{$a%&g=(tsS6_qr)(QE2A~+1{8s^#nB}%d#?;9>z=QSgk*(c0dcW^$wf6)) z{h3dWKMX4?;;q-~F@5FrC7tP%j*ugD`&)N<1Mp&^mQUKLyWif6)!7M80!{yPFZ`B@ zuaZF89uDvvMm_r%mB=}YGk#wy-g6tTB#Snu!-}7DUmFb_X53@%CAfFxwmZeWc(wV^ zcGxHMYLs#FO|Az2wtpRLHWxw;yI)sxfPcN(xQ_VH-#o|C=fwl=i{tD<-&yb}2;B3Y z_`0;P7uvEaHV5mYq!mzx)4bcm)xSH@6K5Oc@yAI6h>5Lou|iNnzm_az zf8cz~EJ~S%Tw*Yp3GaHbF>=)ZiAmjX`#%7z^9I9&e(6PdfIy++Y(FZN0gV8lqyvM; z21|WT#~cDG3cj@}cYDFbleM#;w8Qa~$I083);KU2EIBG}hox|TAcLnqoc8$%Iq-ZV z>s3NrQqs;A8ZONqA*>jCPR~}{ZMzp{%*YqQBfHG+WYO>W{S!g} zTk5fqAgZ2-vAFa1q)k7+zbIj59jNY)c;M%+pljs4%yjUqU)I(&z_!8sywM-Qpn$6w zrmE3J59aMVz5}p2&wEIvfKBFj&axT5&?h0IbH))>8FuSr1$TJ^CT7S@Lp6(WK7?;hb=BIEe&T&`dQtr4P*q255o8g~D$y>j&>P*PB;N z-up-?ioZ!OcsSyp-F|oE*s}_|y?{WwqmIL=)Mv(UjtJ$JRtq9;E0kpX*OM)F$~Mk>1GtTKs!} z)^x35;i27~nKm^T@E-sO#P>wQEi6;Cdu!?u;gD+>Hg}zOt9+U|9L^@hwwmJP-a=mf zw7;fu{I%BcrL%XWIw-B6YXR;7xP|WX%t@A}q*HmJ9s%A`PF5rfGhWfvj$_trDE4lB zZq(wb9bQq}G-7RJRphyVk0xnQw}FcU_zR*L+a|ncHT4nwRUWQYn{?@@q%!7#MhY>< zpp7DelitG%F7|BtInFRtoZiF`}!*%XpJxJ`9UM4RayDIHttLGaM0 z5<7;>u;_#$^Q}Ec3W|OrXG4~i2|DP37@YaM(Y)s@g5Qr(93bql#E>svbz9!A1Dvct zKYi^L8j>`;Gql543k&$cP;L}ErXZ7SR2&CH#@y$CYw_~ScJoh`i7B(DpEQ2730#Nv zMUA|qN|;H-vmdD#wr1(rO+N@L*KWKFujC7_IqwEAjGD!0`1Eyh6?i;vkSzw63+~KES^>G@VJ4>NkFwP>X>hXc@-)HN|2>bfJqO8UwAR=mwv%nfeN@@SS(JS{+2OJF-#VbPxy~0kHCX{-%#P03Xc|+Q>NR*mpe$?3q-M+V+ zbLjNY;cL?@j5%PscgO^(l9CdgurLK!H4g;LPT74yBN0s1*qAv0v|{ZG z1M|2ka*f2K;nIl+1`v;K)bumcufo}80z&vs--6O^+M;FEM0EX+?aEN5+b016m+Uxo zo?>-%$`zoT-vzGOlZ(>>1yfcW1YibbtQW6(4KbN#zWC5Cw7PIE$qx4h-LBvP4b&ri z)=aR+8yl19yyV8`G?~=P*SVRXK&}&-lcpy873v)FTxgwjPBf(bFxBP>qJY&E15mo1 zG2O-wn*Yw7+c0&WSR`dH`__-!=)DaSjC<~?=p)F$3Bkowjr*^XE@K75C{GVwo5!2U zaA1HnI?(?lX|crO44AdsH$yLz-TQd@_ZcS=ml|!}#D}r-YW8gdgFoiuZ-Kw4AFY^^ zn?{t!4m+E`Idk* zrr=?r*|W5j$#=4OB+KN&FfRTFH(hP>Jn3qyI~sufIIrkP9fv-v+sl)eO*Cw+7e zQq-86niyf#cRmt2>i3WbUsp%bVT^t|(5Z%CdEsANV$rd)V}jqhp;|Jy#U{kaWhJVE zaPUIa-47&@c4B#_7q2$bEJPqcjc9{sgAB6 zB1ihVOMnTLXY?Kh#>TNaAK@km?==&2)fKoQO=ZY|MxL1AOPhuw6Aq_Forlt1R$R-G z=uvN^q0++m1yXx7HW4aJe!9`phfXtjFo3EQuz~yEp5P>j-=k>Hf0xF&|M~ZH?HLIj zk18^X){n~H`!x1NWXNIGnBel&?_3v2V`B!<$FqTCE?b0fMi?g6h`epZz|u?xHqmnI zTh_=AJr4w#wWfH@z6}In=zV91$VF&8rj#u%Q3)d6XC_HszlIQmao?RLEc<*td_Tba zAfw>~N&kt?IGWTePKoLUH;FA`h)#zQ_J6+@h&h6R{#}2733I>+)G78U;=p?sAZ@g~ z^73>yPYh4U#-qsTf!H>8Y51j+?QwB4A0Iwt9(I1QzYNq?+Tjc3O*a5*UlM{zM0KQf zbu>@_sy`BTFdBmu$04Z!!(cKyU%&HpP*wOouPdc5D>}&JwQE!DWPWef9BurIW-`38 ztqt%q0&b4N-aa49Lm(D(jw>BF&!?w<(Yqe5-m~?zVYWE0qEsF)^})Ha@yW?!&QkFMZ#MuIA?Ew3A6 z+!@1{OPWiYNvgTT&my~l9NWLQ#}41iTs|SruV@UXaTjW&@G~h3B1c%VQPA=OsPV7S zM3NC}xMI(Gs%%oU77+OeX8CarHR5-Pn9ObMoq@?{+>6VO@ErP7eKMmYVm4Ap4`%V& zfj_qBvB2oh>P#adZkyP3 zHV0U(zuXx+wwW(OwCSO&9-G(Dy7nCcSXJMIu9w$qZEfvh-a;fLrI&?Nf6L|%8xqnt zGzA_>|HkOqdCp&SAVsau%xJymij&P&OI;t5Wi*IQl$>?hif6Tgm(Ju~_e?xCL;%9k z2@s)v?0=1S4r|Phn(Slv-BYXjm0lEcr_-Ufmt9Ie}b2q zmBYT3@Dw@BdxE6hiDQv98KC@NXu6f=uZt#U`^cDWA04;`J7@i%Jc+iBj*OEDwH~jx zxw5*=Ujc(`5kaC8hI$?&LMq~)Uz>97LAA9dM>dw0g0gbqJPmqKC1b`L!-vmDETE>y zf7rpLeY-ibnq=)3yr%!>Zntpr`g| zWR}Y@vt8jRBD+qU&3wQ)Om&?kun9WzqDZbH2Xnu34TBJ{dihQ+8BXwOh$OS>=)jC1 zUrJNyNCY>P*h4jAci2yXD=Aa*Y<5a~m2v%CU(&;Jb#4^ zd0?8x2gx;bh*f8?FDugXw(Ug=b=LY?xRa>3>Ls+FM+=Szx>bmP)5Z~7oeZ+qe6(AD7 z8W#?+8;QO77xP=Z>f_Vy{M?EUo^}Zpo;Zvm{aAs(QB$? zD>T1tOx03RId~dPyTm}Ez&`_GktA87IO+jGr1a1wnZnk8^n&+M?y?qeJa^x|0el?@ zb|K21FkP4pIq#iS4T)xI7!u%q;jbIHIrSTpcUD_d`G$!IPt zwoLNAa@3R!v;g7|DZ|Vo+aza^jbf7!Ne`*%^=Po^p zH*f{}cysKYrD#aLs5h=Op=0s_SBk?fvpG(ozNbL5MuS_r&PxZKW&?Eq64{ywr;+Sm-#7^DJ0NOn@%AOe^nP!BWDog?VR z(B!oI({1qi>7k))7TkhO%kK!cm`v{QuGp{X^g#RiM=ZN*UL@RITuKuEOz$5|Qf zG;&$=C@mDlMtGR_W=QtzKZccrO1IV!F}Kwz#BB@Q>l+9Xe|<~T|NE$2v;w;}s?Cx~ zX`vjrGfN0sPph^{a9afB2y;8EktH$vA}v1?w!0S zw`;M`^_1a#e{(bVe6)%J0169vqy!LA=+n{X>HewwFB?67A9{-3{S6*lqRT54a$QGw z@nbpOE5n~2MsZ@RgN)eW+ZFYBvh`;+jc~)u2MVmDJQI9;6cof$`gOeU%Fa^E#8VL* zo21{a8|SuE>vF9z)*q$6wVSh!cJ(5Rl&*&eFlYYl4yn)B&P4fs=%8B@Y4Xt02S493 zn+SIcJY^P&9{AJSUv%9zB5k~^&ssZpA9vlXf60Yp-tg5|IuQHkOq{EooavKg8dH7a zHWNxj1}v=_!EtMX0SePfuqP7c<`z92*fVc5IG{%5MmrzLAG=&UW9 zvO_MA3h@sX0=iMCc!DrAKO-Z8hh5_g=(;Ck>Wq7|+#1y(Qr5ZE0Jq^aZc~rHwsX`^ z2o%I7TcE|I7DX^hR=D1uqcm`%qUoWUDiFhpiHXVkc(Bwg^1de^3GqRJRowPbq3(;eSsq&Ex!X5m*F5|EcJ@(5hPPoT-HnZyO3GtJHD|o( zCW2wtG}T3&U^I67E#E+58f}!8Li0ows~{@vA1}$XfFr(~O8bO$=!#3ZKoEI#Sh%hg zbtfsR)<$Ig-e~-3@J0MxxHe)qvkd%oV$3_Ln_aSrK`dC~l#9;{;JzHb_1|ayDe8Ur zlSsGb>w8rb;ek%S+kxE=!AK7Cby6|CzK=+lBd_M@n^5rNinUO+%AS#E9(R!cF>YrA zcx!z+dT()dr}D$PzWB)a`wJ76KF!p>m4FLf`ukr0K>dV)ob{c>gi6XU3sKNZNiu#I zE7#+$ZL!%#`KclQoNB(zV_g4GKfmR&;k?ih#PU*v8x7aBLL_}nCP&x7v2Oc=AZzT4 zrJPJmx8QtgC;=&h96^gKjoC1rU2*Z2EWDzuAd}p$`K^XT?MAR6j+GV3o%+2!>hqV# zUm=wr+`}m5J+J--`|bOF+9BO+#CbRdt|%R&1p@Zo{MxEkhK1d+@K7wvfKiM?;ijTs zL^vzQY`S`MVxt=%z@s6M9E9H6rYoCK2>F8%b(7_2>OCsfi{7T{a>n*{+~>#gT{oOL zKe*Tf$K7U}S|L#ER1kO|v7vCo1?2k>#FL2=V`6y}HWp)^yj$06n;ucuF~A*=Pwcy0 zi@aZ=Amg#-C9G{GGozfy<{|y8Cm|giOe1_)Z)htX44g##Y2jNrwAl zO|~Z0)s@>U&kJFpFMxgqAq_JCZkOWgHyS1~Vc*y*de;)%$GE>qrXTF4j8|PEEZS)} zmV|!p=}BC%9d9}Q%)wR1c79{VnN zikHcwGP1G&2w6BI_aZ1|wj zv(jlri9K+%R~U*+%?yoZCD^d>vGkO~{r-Gl_V@KVaJ1?;3JfaxW|;~^Da@4Ob3HK- zyZvdv96gEQ8g}}+iHV#2tZnUoEwG09?&zqn!Un=v5iyyQBk8BGaPUx=; zfed?7H}Wz}i;ctjp0Hy{D%u&J^;d@;vz!O5RfP>Gd?>Xbu?2%Knc!u89qi zzz0)|Yq_~m#Q)TuFFdM5iz}FCy}tCFS}hQ<)28W1i-%9prgZ(y0#jzg)Wc(C*0 z6C*N^HeXBTu`{bh{Kjc?Y7@S)#FuMEeY2Lb;1Y#LKH=;3mYE?W{6n;4atE5ct5!z= z5AHUd$^rWW3WiONx-&&=Q0_sNeXW5~!@u;OLU*X~1@@f=9x!0(<2BGZh1=L~hjab@ z&}H*zT4(|SOlxL&^>m302MlxU+dCT-(--gKu~nVei^ed(~S zkCP+>73(>ayrR$b?-QPRtT$Gka1e$6%^oss&>6?OQPGzIQXchG7&TNqL%pu`^rk#QOhS02IV}`hQZKt)Ytv zPs<5;@onC$rLu(vy@(yw_^wAJ7v-DV!EG>Ir)sI&@j)|d%-b+aJCt}Do>^5mv9x5E zswy|zU#)2Ckgc**`JC)>sgJ_CGs10-_eHvjX@+l8M~Sk<7al4*-W6`Gg3#Zjp}*9v z3;j_&FY|jZ1rmtT!Ab-x?vo%agHSz2tq-h*W=vGhfqffiv_jF{G{#POS!>g=^Z5e; zZTdYAYg?t*!Q6Yz>t;%_W>hnx(i*OIA|K|1?_T+D6awSLe@uUnpq(eCmPPMG%zIKi zo*`iN^BL$l4&N_|qP5uVycG|`Q#l{y)4W-T9yokrkC13&@Of!Y%OiLlLV_||kJqHS8J))q`VEhcamG4sjg-O`7H z&U)i^!kxpHW>-~H07Nn*+p45rO7Pm1 zah{TIh$DP7Y;UaSpVgWJ-C@Bt-9m!CE2>RqqM;XL=OvV^ zsT7cd`@?&ZFoo1RnkFU$%w~v*)Wol*p0vf1uI7h77&QN7Lm^7uvw>yWq24SvKIK_ zu7fCz=>Bd@C#QNNb9_g*0c3D4l8%@wJR~u4?hPf(z4J~0@9X~{X3W=0vHi|&CzF%X zyU1(UI~qP(w??d3@PL@fh>9rH>qBtH(!c#h1Jb>7_0SslN9pd54TWb_c%`nvfNY&h z6WOol<$cjT?rtl0RH^k@koww3j9V)>J++9psO6@tP{JXci3`@hL*i|a9lsNQtO985 zp)8EF16&y_>gqF%Ff8iI0TF8??MBPiNKbPpZjk>Rr<)F*N}JpO~-;5 zIu(&)wR!?Y&7Tl9f8|;5c+|v#DxD1}0Dc`9=)y;H+`fI$$zp((b`tcpd5tu9vsL?j*#$tL6g$lZRb@Iep;k`Z^zo}&rwh2AeZs(OjQuRvk@0=c18%zZB59a(oE!nr_RVHV-@?iZ#83)bMDNL2l z0(EU+WLRncL*thOKn9)o@6|T*>hKu!{6_s{%7zq&mc-uMwRd22@V zWq~M|lz}0A;z%vy{vwSuTy&tmxg;Ax@O9gLgbDqx`e)@lSY!EnVjb$|=>|;|dTA&; z5A%Snp6$!|`Bk@xPc7!Xf^{Jwr*|Q2gh@2SQChKl5|`flG}!IZ_I2b%_di#R4e+ra zc|WN*D}%Jm1{dF+UZkmshdO=n?u&P*i|7{f$ADdE7DhnGu>$cMnE8~qT_MF2sY zAbYRj&T!{Q8eT()VHYI=>O3E&biLYUgY(#MG`Xa0(m|{CWmr{1=EA>xRa}wMd*G6W zH(BgV6#!nP37dO#95hrB}wAA8}u+J-1a#25=i@j4v)wIDZd>`V2kKeyd{cEzj3LpHLAnR~HLeklpqZ5E+$;ogOJc&n8eOUQ( z%|c9d%jOs%*5dzmhza9<@%Dd6%9#<6Kc~IG1IY-8)uPkT$kHK%t!48lm8A?%oMc+k z{zzag5c%!9r`OPIZj!n-b8c-QZIiU-O}VJ|C{e40R);JQFcc{*D`R60fZ$eL@-BD9 z34|D(11o#s=$`yvxc2WueB*0fQ6nHld_40o3V?gSluF@mitTN%7%}@+{6=4d2T0w0 z@>YmW+U>|`68b_tM`x0$--KB{A_9;EWc|to|9LxOi@?Q}#CN4cq=!1o>}sK7!Y(RZ z6)gx5GhXfdE{Fo!?jm!eSxLT5Wv)6@+-4=_ffmujF*+(9Mk-W-G zt<}h4HWd3RaLOBD^Re5Wao>@|nb-Y0FzCgnpW{{Wix)43@fJIy5Qf5n5u92;WWt_g zp8K=eq;#`c?32S4c_G9XB*f`hu7YBO&s7GQNN|*U%TrgOCkTWb*X=mxB>b2@U{j0DG2KF z+|_r1aNcIjk|X>=;ALRO_o5TR*f}|)fJu#KZSTP*cHFP&>1hbl2;C40Kn+|C@O)5n z8uQppw9;VihxapQkm#7Ch*H^jwLm0UIaya|G9y zU=^=sIf%+8+|t%7%L^hgws>GG_t$6T5@J!|`!@ea(^tkt^?hFx(%s!d3CNJr-3*O_ zG}0xFbayvHmy`%7Al)h5Al(hpUC-tF`#-!G-tZaj-RJIo&slq|wPjhj`t|!xRLDg` zEl4cuXre{L7>2pWSqT#82QAUbc+nT?>}*&)ovsyWRdsYCxxzE4+1s%JXXW5C%YM%t zhuVQ6q$j39^kf%W@jNr&iARt*LB{WrGL5h;O=C9URtJD%D4j`!9+6u`;an?>`MmH4$AtKJ$6xeQ zHje-Pf(OR+!av<#C0%hWJOupnQU~mfS1@$z|M|O>W#@a{#PWVyf3$yg zB0!>8K1;*9M|yn|(8X3POXp!1k7T~D!EjYq*9DHCn0tTuF%DD*d$E$;_=nEPB^}l4 z8XMJoztg;|@5pa~k>K8ntItuE&(rk>^WoCdD6SlWXQ?4Q1;V%Eo>*-ktCnbu)!RC1 z;=xatC>lXqU$&s~r)%s~p=xxYoo*mTp!21rUGqHv%->E$Vim+hPCmtjksRZqs8-~T z1ARv+;>{-|D_ie*Q61!noF$kB4`2>K)sduov#snsJw0NxMZpSj=p({N)JY*hSM6kuu{E_+w~R`#$IY`S zF~1A=XrUR2kkuV!mfs9Yeu71YKB0yKkgX$vw&f^UHGW&r9npVaHc(T;Nup2K@Tl)j z#JBGbjd3`-CDCi1#@Lvk7&AwcJh$yeC``a6BOCa{Kz5D7bI24t(9Drku8RkhO#pIT zsX%?xC8geC-*$&t47o#qqU=zY(8%Z$*K#o`s7H4=t7{)NJZ1%+owz2=pk( zu`f<`Pbz!5{dd9Jhy73(90oxvb>yVPI~#HawaC5D`bk~Q>O5+ zSr<1h%7nf%Rj_yvm(gm#)9KD(RmZ}Na-#6VLr{Y1LFr4`D+q)kx_JTphFqL!nI;5tu&@EfHKI!!`PcN9O5d1HF}oN zpiTDx&&S#?}aV6vM&^*fP-8bzu2aH0NQnL;V9z=6a>ef8S0Y81FYu?yrkq{gVzNA2x+ z#Xu47AhU0QEwiF98qI2C>MeJiKF(ha4CTaAU`~{&X1{ZKMT(Vxx;*(NX;H9I7W&T< zhBF>aAutYS+;x)<&c~0NEhiR-_7IF6L&==-YVg_LHem>EPGHfH_{O7GiATyJQe&9P zn-`;_gk?>uU?X#PZ7~`<-|;?XgY8z^C`6tvHTLHGU|tnmxD1@0rMtt4O?81a5K9=T z%*S^POCeh@;{J0iWj3#!0lzSCHkij%Y6y5qH^~D(a+RNX{65_$;aC0mfnH}j-*qG6 zvZtE-OM0KmDroF4b#J*pCWV*SH~mOit_Yg^tN7FmIA&(c=Z;bL$h)vdCQ@>I{?@VA zebTOE={_QGQ58DBQQKagy@-W9(IHUqK#o3bmsHe*6`YczB0+CJ@jqHY6gbQ`Z&_G8 zSP5cH%6A}Ce>94|e@`SZ;NX~u9ZQdH*E^9ipo2&ym;Pb>@c3`Bo(edprlKU(z=|ot zUcJ|9Sz6L_e>kq^_x!r*^By+}e~xaymyT5NY|^np9qwR?Wu3axQPBB-JFx?uSnvx7 zv?*bjYWUXzcN_k&H*cWG2M)-75gdj%vi+0b2y1~!lck0;?LtR#Jcj#<-L7k65`IZ@AUI*=DwU(`8}cOpT|}!=8O;`EY=;H7L5Tt+Hn#}_>SU(Ostzz8_!6I zzUrOn1@+Xlj%D$8-^h;D0+X#f<7p)GWaB7pujEd)x3|x{%F4?N`dd%NYo~)&cD&dvi6#1`PzEE&AwzzvNl|l2*>O4n z>qkl});G|pxvjU)AutK_q@t5tN^*cK z4c8_+#hCUp3^}lSx~39(qh%rycBm7+69MR6R1X%|IPYt7qUK_3CCw=6K28)0r^|0o=8#|<8700Rf128)%}cqlQFvFUyOES#nK zl5%*`d_vOU9UKq`ZyJT1dJb%4ysPckjuVu_r12V8C2O57nPKv@-vBvj_epLP+Z}m& ztvW0Oji@X4`I0dwJdd7&R~PiGk0l#t-rY0wE)2kUP!Y{8`#Fe}wKw^qMeM)7`PgT$ z@DRNoTvl0!2!J67Ks&$Vb1|9GTqQ+|c?8^I%~wAN*$N5(?Di3|poyitop6D7b?cfI z%h*!{>ZX)bFg@DzcbkOpQ&qQ80Hj{=JY<6e^>y>i>A@?evaXMM19RgYf-RTTfoZTV zM}HGgruL^w?u0#KVhhpnpBBH{WB`@c_sJ6!DB69txqIq}7)w5nR8%B=8>Ec^YzzZ{ zs)d1wMQJ+5YHTYBBXMjhPt)_<)RD$nct1-%_5AC4C&%^nF1m*&!Y&@f_<1$XctA-b z%IGd}mJpCGE;yWDwZesgV`RIyG3Ru~PXwP=oXc>sQa3B3kgfCB(dRoV;mC-Xvefh*a!7~y{%9tW`i|)hL^J%IB>K7{Uf38 z^$nO8Eg?m_w+d7pSAeA&D4W=VC35R;->-$71Z0v)^B5LmgRzH<&q`hU*?OU^@CrdgTQqMPkW%SC(x9brQ?&5O|{XtF0 zq9^onSzT&h1d#h;sIY)C(C->KxF%=Hm-deuASGg4fqa~hX4aH`z7lB+e3s8)bS!ZZy+@{HqD0?l2} zcTLxd*|9bOMv+=wj#=}6o4ptlyJDcUD?#6w$jz7C82fGrQ_ZDiK6`VpLAc0A&v-bb zoS2hv01LgY-cs39=iFXAgyrTNe`bvm07q}$h^AN1Qk0QGP8y(?RZPR{0>Qs$cNK2@ zK}9WAnUpfa^V4$Tvpeh@XSRSVda-gd;lH+B@jYlp->0S0QsnT+I&p{#DE3zbxGY`Y zFSCO8U0yK`11cuLcR@c9D!^;55$QG(#oRA17s~ltaEOUN6Y&i6Eh~FfU{;pU-=7|6owB#SxnD<>7)|_o^PS=)zaX~bXuw|kApLhC``-`E5h4PBqS1w^fIR=II+~-Ye zVm=)e&+#!&NNJJU6^4KrH-docK{V#j%;`=03svgTKp+ZUNk@1>cRs*QfIuV1gO9vd zJhJ{`22d_HpEohwx4NPsQQeVGGLHOJ_BZmfB(^IpC=oIdMMdtj&&;z`u1ZDjj%N{&)Pnde+=-Yz zbag%)sYi)2NhLd;;_wT!sJw5r=(y~W>SRPhTJH17BWow1yqV z$EUuRQW+IK5)suV?3?9gi}#r7UpI|@R{?=;yM^De&SX#AD01784w6d#?2xU)UF>0U zY9FbOJ*qQ~l!mOqgKHYe?y9+a8#-^t?s3&F!4Fxi&6vv;PDAs%eLA6j@qVZGwHxCU z$S4W2+9BVa^wl*n(cTry;Yg-(hLr2~S7TrPRch|bCHai>bfEu4vAC2mtrt5Gg=Cz1 z45TTZ4SA8xGBl$O!K3&21|$j{VS&0o*edt3DaOQMGjMr+zo`<>jXPfa+Rd2j9ntRE zYTOrHP7%yJtqipcsKaKU|ClVT^E{=6t(hHH^HdhULPDiKnS2wQ9a^Zp5yta3(60g0%Z+2|v9|dQDd-04TqY%jke_Il! zBT8~Rd@q6J!7U-JB?f*!8NJzz`Ps`PGMX!jmC0Lap%J{^UBTXa@vKt$i_IZ*!}X`) z8516Hh*ShbSdK`Mgu%(g_*!z5jd+t((AX)KolN93x~%J(AjeopU%SQ}qc~UPGetZH zD~|53&-}VAEV{zLQ7GX>C*TwPg6Gu%n%~2s;W%v$@>I+z01OsX_}~gXU2-*)p5y;m z{YeQ7F@U2GaFfsoB5+_8%sdG?z*2&OVKq9J=Z~lbACPn74xH4)H_vVjstj7)6a72X zQ36r0i5KNFvX(z#jRd1`FalKVC&b&GLn`f9Aknu6j~ZJkqo88kh-%15W%{!=M1^Dh zXPYH!Bkxx?PQn2L*BXFmW2|-W{nPscCj|f7_D~v^aYphy8AA-!&hLhSkk`Ic1~RtV zigPKt`sBUj+!wx1`&~l48w~x-Wyd`pAi(n|c>LeabPyg&Rnr~&j^GvQ_tGs22js~~ zsO8UqnfBpsJ-w-{sx~A4jP=T2k82YX-~h8EwFJ4uc&6TdX_`-wMmK_kv>YgTdIih> zs@1&bNh*vJ+DWA3rFUku45bH#R2+cW^@X5XxZiD69bnMrot&xV!-(IL-_o_{^ZE^U zb(q(Q56p`D=7-vT5iEcrkB3{VLQTT~YvETFbmDhQ`Cx%F+-Sl(YH8lRYv_%cE$Au{ zb%px(w=>*Cj|=2KUVwdpeFSJCB6OqAPEBOi`d#@h$RzK zgxM#q#qXQMDVnO*>jqkL5He-x=L9glQD_9|cVd3-;dsa50g=O_c=>fSFSnCGfZ-#t z+D6-Z;Z|?=w$~;~y~Sae76&$#rk|iXrvFN4%fG+vSB@jK#Z4u9sf^+}+#e!>V~mwSE>01qey! zsPB5BgC0)&;<-j^eIv|$E!Cy7pE#O*{x8P8P~M52$=3m=^o*3AdpJ4Jf)jW%jHJ)7 zN25PVIVxO_e|T0I7o1F+gz-wwVe*FIkNqYbSb6OspCD(A)^yH$yC6g(Z_4|4j%%mL zCEfcRpdvB=fWU@5F{nI|!u2|xR5_|^uF5bB{#-6$qY+m==-O_SAkMaPU@W)Dz19~+ zkVY$Zr}u$K@i1#sapcl;BAc^Nm#$$M6he)n!0+`-o`Nk`J2nvLEAyz) zj=k+vX!j4GsSx>5ekFiubZ&fqNoG8dsPeOJ7BhK?z8n2VHjl;Vasy@+ZY+f;tl(GM zpe5&$c@)R(!4%6v5&VBmHk2P%eUmaDw~}54#@O3#8Mjy6+1#q~(@heW_%OnS8fD9= z6mvZ|y*)7HnT?-%@Knwq0%oa9f@K?PVH1mbDXUxcs>?lGbG4m!iTzIayGA30soC$V!fl6NU&5vkojD! zkU>oE*;_Wcd=A!_5Bd}qP@tG!H#91xfPNUZ=NuAEG|`t6mh#Xq5H`puR=Q7o$Hx*h z;`V%ym0Hlq0-$t+3|}?8Qa}9$2Uw(oF=PFzAU&$c15c$)5%?Xt2%4_Tzndy&Fxypr z9szU4BiUZ;ta`VIS-^;(r^>J*MbUu74O%&Q`Ccr2{Nbi6Udy>U3h&c(q@Oy_PaM2Zhee(F-|A&M;ekj!cCH;z?({d@*4GY&I_Ryc4%P>X$gt1l%AR z34h87vTY`oFf7sCv*?e)cV-<@@ywkt73=byfYdkjkYQUp9t4reeZgDQj{wp zVJig5bffToI94|p<7RNCt?c(8o7;5hupRL0!2BW1~utAPVPzgHZ8N&La=DLNi;VZ%N96n-cEx&wv=*L8x+Ll77^H|_O z1G+WGLepWc{*~E+G=M->gS&^**qXS$$w^HSIMVz6^t`gJtQaqp#Yz@3jv=F3{&6k2 zjTsHh&2a#x7;%G{LhFvFe!=L_4)#eTaOV%eFNVu**2LJ@{8|hTDRLjZQGve__PQyY z@8+z1RPGo5!vvT#tRLYfd`s%DnV77HAG%oByf283&i`rmK*+?#9!4qb)gAEU)k$dH zO*>eaSK2^qcQPlg6Q<2zw{nc|G+la{gohC9D*4F^I$Xlw0KKkLTspCzCOBptlkeG>tt#+xpC;K;oK>o zf1LnFX|a#9)_fl4+{&O(iO=e+AjXoP`4De!bU%C56bGlt!V&W*f6d|Osjq1x<~H1C z8^^2kfFk3jSxNUAW+WAhY9VgG7_+jh$nRu14a4WbWqWR+7}S|@C1`Zjlnr*f6#GM- zGI4}3V=^?va@X)qyZw97NQ%#Ldvj{s(yv46Rg3yd%%xc$Wzo zol8$bk*s^V_l)6nIMdFe{aT-73khww9e*i$bt>*Qz5DnNz0E+S z1ht)baB%PpsY$q2@i?&3J%6b)ob?wz)*KtNG95;x`^vNU>?Bp`i>f};yR2v_U|wY8 z%f|--`5nu`=MwX8x9J8ox}VF(E(Thf+gvK=a@ODfl%7V?1@Z2{k^1e;;EjWt+)h;h;HT5Ztoug%}}uTytRLc`kj z(&x4CjHU`_f|3cMg*QwpM@#_l2#Gwj<*9tKgHO|U<0tYiIicURO}1K{Qkb#sFMe-~ z3X)%0jA{#B6?qX@@_xd&IF#MJ?=thZtkm=0Z&`Lw9%D;ZJ-|F@!F9 z^iMll$TFT(kCuFpb9$Y(iSWDabK9^OqRAFE!unHuVs78GJyccQwN*j6ai5V+I0zz; z?aVjCP4|1#RwN0ec%q3Xk?QCo=x9A|DCQi5p3l#lZ=XLih|fockEGXvLjK#!yRAIM-`?(UaM7r z_6Y;aIwhdO1-1qoS^DsFZ%_LjIi$Mzj~rRmr-CNMWGg4PUan)=zulQyNOX{lpN1c3 zIlgrb)FRBI1(ZEt?>oBZ3+mSgh^=$*DXWEJ;V^_~a>&wlnHq9QhrJ~zb_C``7~I!e zmnjF446>FTroqwF6eyergMY8&hk$>_CWs#A`-Y9*s9^ZS8L54}KQ8>CAuWvnxOV?y z#wGcysinowV7>Pc%+RQuD-y9~&2FBqu7>MP;c_yePore;b~~?6#=Z+*?wyCBPir93 z{Bo0mD0=Z_NNg+~Lcm25`9E`Ce&uPwnD?MMt1XA9zI#E;?vJkQ&1OR&q zk?#pvc=Ee3<~Au#%}ZD_tawSxUcBL7O(vDS)>kwY2cJb+yH0S%zL%gUJ$=*6O1+k3 zCD@pDpWtm*{zNdUSyt0Yq+6q#ud+9T2*B$J_<$0K#c#gGcv5D7``2Wk9~J-HNWJ{( z*n!lC?%8W{GOO|PgGUDOkw zM>d!J3Py-4ES1_I`-De!tPj(npUO8W)x3^e33e zOb98hpcD7~WVzrw5bi;AOyoq3oL)9cQY6W`>qoA$Z^S+iPZ{Q$V)Gn+tA8)ok+^;KcmcqXbUau}I&t@+7;7{*V#{cI`-5J2 z5!~G5I8uf$Ych(TJV*M>K!nh^Sndy7pq+G>QhEzEOU)_=Wj=Ku?myv`Im+#X6Z03b z?Hk|^WJ^G^>OC#8i}b&Ap^Bs|{*AiCwNaN(*>pE^>7Eo~Fuct5%+jAN8HQoO@>>N& zYjHnc9ZT<~a+KupEGjYoQ^gt8UeFo9t}LxG#PZvwh10j&eA0T+nd|+G#OhZdD}38~ysT)zcKZ zm$UacvM$f@FvJp-88eT;#cp9`?#!Xir8m+Wu<)fv=AvhW2$OTeI!&a+5Rbw27Yo1n zM9?>PsZ@8j5fS2|JHHny<&4!|83q#~VFM)igWkbm8>D0)rP{upw1Gs=+|i(fzMD!@ z==4N*5CkW|X+!3K142j!P!|TQzf=6Kq3e$Z=Zf)zk$?Mt7aH@J{rk|`(Lf076=Ey? zTb;$6(N&Fu1$nb<_3q%pv0%dGjx8{41G8W zpyFA+^I(74l!V6Fm^BrZh@+4O#tWVFrE7IC8a^XisNxb)5@LqMW|?{z=;)9!&`ZTK z#*p=yh9kzIFdY}bUhC+k6;>M4;!1xr-CnSRsE22j>Q3=MMjxJ?R$?qiQ;=65e};Z# zfBV+aH0afQ<@WZ13R;^W5stWfuz5MZM7YT7qH51usXBM_SZga;V*}muG+z@Bwz_Gf zb2z?~j~*$m@ZuMg(XO*k8$SPI#=@%)w7BH3DvUD(Jfe4aAm1Us_=O_Ct#zkU<|Z;{ zOF?$F?{bo3zO_y0k%zb3KkU>e3ZZ5Rc*)e5uu7KFbt9F`b3fPv2D_Wh{E~LNaDxTL zz0qQ>>|781v*ChnIYq7_?d5&6m^DZ-Xh#`Cf6C?=42NbL$zD~H33&fiu%)SaZ<$X- zR*Z7WHXw?51_Rl$Jk`+A8Z^R|!I!p^wg-G!WmeL$;anYwf^i?8K!0MguG(#NH5r+HXDR^&Aq=1fijg#l2v%gD@TT5iQHi-Z;E9g zKEglTIA9ky)>w!sWJ(!)#ScA9O-jOD3(KA3ZDuzM3I~RSrk#4AqOo(+zHiiSjt}p3 z)U){QJ!3u`P7%^rQx#w!ENDV#6%jPdUte)6f%15`d155C`Y&tZQ}Y+usNex~A*P^u zuM?cT)q1k}5<%S3Vo)`+F>Th&5uUM&-$mU1wPleE#sO&6 z$Ml;;>bt!d;5Y@a{DIlR=exo)tFle9u548%!bKYQ&7H}`lq;SWYvGjF_p5 z9G?oV67%Jb)w4=UyaoP)&JC90r~C#bhu~{mFP|>pCMhH#M&K z9B4n|ZLZhpN~XKMCTwEqx+O0l;8t$gX&$ftss;6(algH9o*Ai&Su)8k3f7&l&F7cT zNq7IDSJMhO2kjb~op}~~>(Q1C9RN(#E(OD@1FPEZNUBz8cO??Z6I;$1q6y64Ka{(q z$npFyl0k0=Z2q+(aiGb`hXJwtMaA)>UDVI)y!DRFSlt&nd7s0TP-*j9>nhT+?)$y0 zJLFo{@Om&-@F4)JQJTGm4>edgn`=$Uk1F%ox9#S+eeE=#&S5j=y+qo(?39A~TV&}7 z9vlX)6u8%N>@-m5tCYw_%Zs-1*kequd>EtI-;iyIe)dLT-4a`wOum1`pryxHGf&6( z=6E>=(LdgOdrKm+*4%<lq- z^qVw8Uj$QA^o{osObL!y6^b85sD?X~UW+^65c(N3_mcrG?Jf1u@kZCI6vQe8fNy1G z7Z?EPUIxHf|AxY_0(2tXewdCSzS-lto>Cby+8&$%`#$m!^E-hQS0b1~LIA=-80`?3 z3E)?ZkfE4E!jWjBjR(s^C;Lfo5W=6yqjw-|vl8P`0l3t7Xb+_T{Q3@RfUReR^znb+ z+!t(hcb+2Gpe1I$V@dq}T@sOh%_j4F)Zz$LFj&3{2jG+WNq1B!Q9bflIvD~0=D0if z2GBA)#r!VGea3kAxnli&*=U-;g;LF`c}3MvC);4~Cw_rhJ2EAO(qOBjzZ_y%v=DJ^ zJ(aSel7{WOx37LVt`9l25bU3*04wG{3BjuzDa79tTHDR=zsKT&q}Ut<&pchTM2O1) z@G&L=UWVp9a+Ng5w|H;>bW>tE*oq7X8~Gad0HW90KYyVf90Bt9tq>Z)*(e45=}=K+ z4h8PO9*~a&DAG_DV@-;_-ux~g-1sIO{3=MG_d>*cy_(DagbiI=Xg(cf)lKZ&S_@3b z+9&{NYoYM}p3*gJ2FC%wBNbSfG>H!N#1_~fuC+e_KBqfmeql4^Y5WVqPFqq?=Q((= z`ycA?h?rn)Z%~i4B8wT6}E8TR9eZ@b&m8wWcBwjvx+Sy#2CjB+dK-%1#ER4=*p9#8sb=9UIs1^Cu~Hm zz(+}D198K3(QVN1P0wzy=_(|q1thje(hi^{KQrGjBkzU2UWjU?UL$F#`3FZwdO**Y zr0ws*O+`*h2nU!J1AKaZ>jO*C@}vC|WIeqwdA)PJNdDPhZwEx-=n-V8nLy~vZ@Tpa z^xS620z6C0SOeDL9m4GwiD*AB)XPENDmbl4tcZgkDQV=YhszTDx%|kbjxkFABA)W> zqKE)r1m_JJt=EST{&n3bmh2YYXpHYEj#mBRQKnL~lmTPKhHP*M@WP5UUjwcoc)(KL z05BxP-#!ZUd}M!HN%saJ3{iRa*IM?+6e6)t6OQE6^+CaI@H8OS>fVp31eCH}F33!H zW>H@}#Oyj3U7F>elf`W@f+Hu%haU+gAx>D~%6qJU!BxkW53q=*`u{EB@-LGTzV6H8 z`qfuC3JT!bABBb434mbc(5?hi$tE4!sNUpS_I)socL7m0KYoJ8HvDyF%0%ATPK5a3F|E zM-bLCt}5HKTq4owze4q$^#V-#VEG4&9}_vs>MhWoFW5=b71H}@nOgDPdg2{1?v@m) z&6DW!a{|Z>xP}})Kb4pMC%=C6QhIF3Lpisdyh52JXduSgtI9x~QiV5CVZkjnWBJ&jO$(uu@q$33 z9R{2~+!Meo|0%EE`y!-AqUv>pxV`a(CXc5LnDT&TK!k~F6^3RsP#Ng&^-7411+1Td zaR^;3RgYAFP8j)JyEm$ke|1aca+8=Q$PC&Abb|T#EYVN|G=rd}CFk*a zdqZMgZxA{O=Nr$fBTTymkfgdgt(1(+#zK6Qe3JJ{tx2WNSd^dEkHDICJO*L?^Q9DD zs}siR5*B24QmhJiYpn&)gANjG#TkKoP9HQSSxeH_5kXUPW({XBF2mlL!4A!sr)#rl z`GAIl7Y=B8P(v*`Q_Qu^{MYGK;m)gHAJy!i1+o|!qFExYn1Hng;5K`KVQTh-91;>T z-s*+5H(SAySOgm8rKdKIbnq_TswtwdVDk#i5Am|K{Xuak<*gigdFf&~r(AZmVXL!d zcLangqLdS?iZ&g|k|Q%5y`&WO8Xz(cGN&(_*bekyCcwuXOtu*gH{HwC0UV9@7K zc4X3}6+K6vsU_qX!FymO6%%(OE)`9fxQ}Jd^I5%17kkdSjc`Ta?55}_E740U0_~N* zh^SKiZD!BR#1G}PiS*kkMX%2&&0$An9N!b-;86RL-5-h6h-(OFtfWr$d`W&R`(Q>6 z9a8hq1MJW=FYombC%$YA7=3kGW6LW1@F-N1F8pYz)F1JZN9QyER)(1zkp@tf1pb1C z=q!E$-i!e2D>Sg{GoQx>cNTxtD!}>FjL!`_NtvJHnBXDhY^*d?i?xh|!I@2*R3APf z5cd@qc^wXcdU3(gorbAp;6V>*_7u20p2}3>yA{OTJ!tt|JiLmMMETAmN1^@lKKRF{ zc6bA?2d-C7Wf9@#j<%rw+v%HCA0M#!LL+-b-<7=4mbmbruhPE>9MLkl;@S^D|bg+T+V) zzrg_v6eAijC)tHPKgi3I2)%!y`0IDd1YpB@#DGKhvk$uO!_pxzIRUfX=U!xQl0T&e z%NjBAI{%0GCl7>n-^ZR$Ula&@*0{L*3SH>c_K%e9hi>}7LLMN098j?3BkReE+;uUxjm?>Hn!Yg%h;>G-B3}mi zT)K#m^ZQ~7fP%&5+|-P^)3ux~BcsuGso=?;DR3v({%!Z}3>GO#0o!>mBbHc?LC<0x z@)oU&LPG2Evw*4zuiCPgn`76^f5xT*Lc7s@3FwjD8Q`*ky1p&4s>0DurX5@iN&gNGx5Yh4i?Kpg_DwPy*VFCZ}oDe2f0+aG`A^L!djjDtG^ieH+r`-OyVsnD46?2 z+W}>{cF!p--+DeUvSd{t6>*xkX$By+Q-Dn>{cip!kn(@d+jl=jv4!ehuzqXA>M%TQ zz7e^Pg>~l9s4iy~V$~L#Sg?Pu5Nfsl7_}dkTc;ua379L&VHmrA@a#ZSs3Xvh3fAw4 z6dx>G$jAHQnvRBHx`zbH4Axj-Iw>b2G^MGn!5!QEQt6$gz-M7sYc`Yu$>(A{i zcY>tbisei?g%vCUbiv+^g4+tFEVdKRj~F~N%Nf3Ll*E7=@KXgZ%E9(_?)lKE**?;^ zcbvQWS(j*0`BXENFCAL_|y-w#quS)^G-q) z6pFCLA6ZQ#57O9naYztI?1zK#bhGMeSifAz%+)aP#Tm&iiV(BijfUfthk-ag zer;8z&%NJtYV{+w~?3|{sCH_ zVB_K79~<%}a}Fgod^cPI93h3${qek4p+-&Tb#bu+jfe~ice(*7oVNM6sk zweMfnnk=NN-fp|D1|#Fe2S5G3F08D93f1Bd-1^rGs8a|;&A^vtgj)l0*eU&pTr7IG z!H8!RsO@inMbIaH4ytr*dYmj%;v}vlq+T=;8AOfK@R&g148F|wAJ^7}B#p%7r?D7> zCx#7A1tfRFLEG+p4-tGi$ic=xoA%&2A=us>z*t8Rb;oMaQzx#ZE*FraJT;{S8=p2l z$1Wmiwrok3lzy*`|IF8Hx<>F(6q6W^m=ytuY%3IF4T2Yl{GolT!NakLi@C!zbAFu6 z2@PRPu6OE>`>y@lF;lY4L)rb$!<_ph#h#<5#|znFVqZ8htS&5?@!_!i$wij;rxmy+*=#V1Kji{4DGrm!^7` zEhsNV6^{|T2OlgNpJGsRFLQsEmd$n#v*%gWdKZEYo7@)Ig%99876KUR zQnSM_ATOQ5;aF$np&lTYIU+za?#d`i4eOflVEk7e+_T9suN3>0vv71~FfQ0}aKb^U z;j>ZqPmPET{Q6_$V4ur*8u-orgR>&27z>SxMos&j86Q7<_wDg#63sr-a zYh!i9V2fjQRDD(nSdDVl;VlP8Ml3om@qI2QWG}Hb&OiQW$!-FRNrX~R36}$V7$pp_ zT`>k(-8kSKb;l(sCDG)vKd8iUcQ-Wu&c5)dkT+O;k4|T-d{=L- zcXKcF7g&FS)Vl6>vXGZ*yRB9IPK=G~{%NXd;RpiFsqn?lw|G$hSg4aI<3(S6B?Fz^ z*xgU=yt?g2*Gp}fKhVP99!-8t#Tc8BUDX>{Q&6TKQS}C$Hfz_?dsX<|kDM1o;L@Ut zLmdAyetMc*vKK)0qT$Z>{sHHua&it8r^&6d2%t&>f9ak#Cx))q489F=@Ri&Fvfrj?QnTe?M-_Qf^IT!`Oum8R!C*zZfcnALogaxNp zasDP$Z6+gNr@Mk_y?oT*HoawPI!So3nyGLe%}#hiJ$LqKf9Zd)!PwLDu~F!?$)jF< zx1?7SiD~w2DqW+*swj4vmIQ->qIdhN>!NGl8FR-piN$gaAV*+(W8`^I z#z+DdmcbIb{W+Z)KpV8etSvT~<9A(UGRX-+1&hBa;(kF+AtcZ5_z8FtUM#Zm-LdAv!ax`%{6&3%{kE<2+lBT<<-I1=jYSC!iz&(Wl%WE@u`Wi1c31}4iX zb+vr+93jiJbBhz--J9KPiwnc1%=Gx@Eto*uS)TpZB?VpH0v?Y{(lWhrv!yS2`PEq0 zvZ=_6rN8j3P%R>Pt6mKJRUr_2SP3<|M#cxC%M3u4y)TYnH z5X9Y3M#w2Tx4%MZrXyJEfHw$Xro!$QK!xF2TUjx83Hrs_Ee zdwz9OVx0BF%*u)l{(V}!U2A%$pWNVu;3px+EN=#xYDA>d9FIVpQ8%*TlpO|JPu`Q=#L-7~*)d|7B&V zM-2|~8EnL9X!YSzNOlBzF;)nZbg?TI({WAcuf77f#xU0kVSt4tu9l35sZsn%CG2g_Th zj@vq(jwiSbu?+$H7Du5P44L?EW@!!dc{pI6z+%ty;v)t41QlY8$e7}BBfn;^H!xGN zY=`t*+%7%Dh$1SemR;=$`d#f_oTs0fHYo4cD$>dtO8x&ezBs}{s$Mofk*xM=4Hs64 zcxW+seEs3kAfK)7`z4l~j+<3NY>x4y-BG;bjS;Mlp`~_%KUmTzFJdQbIF*KaFVI!J zj+?mDJ%ZJ*(S*gKF&3mj7}QTEJ4xI^a5iX-fk7!0O~`Jbu-O;GW1i~%r8PV%hUe!u z*v~`Ov$p(S7Rk}(RUI|s7FCJAfZsUi8$-R};Nibr!)5Yk7PV4q!7{`-lemhz2g!%- z%ijq-GBJ6eL#^*BdPx{W4gX2^`^(#WE=M8%>wI|WKL9(;?lqd*Pq7&AzdFPF@4q_J zRJ11vJNMS-vU9Qa%d!?+a=aR>wnVD&<=+9wOh$M06fAOYZJ+N-j~{QmR+>Pp>|vR> zU(G3o)+U8`eyhw>k0V`~J)}WW3LeIsQynYAI&%1hf^bD&46Tl(O7~kpcAyZRk^B+` z<8L7t$ZazwG(JVb99dI9Y0sD|hLr0Uic!sG4iE= z^^936`!3a47tSYx=GRYf+o)`a{pI%*PPW2bu2JN+uk>R3e3*9jc|)|lX7aJSp%=TK zuVLU2q4ieN4BU-P$UBYrCyWrYAK%rbojVZ#w^6M3SHpKGhtWMM+naBFd&L4iD*c~d zyRFG2DrrGr&M<0%m%n!5Qk|&%?jSgQv6T|mlqD;R!dF~bWYXLJwJI#l>Y&;L)*Ett zb7TGhJCga}=9J&>#|6UnKTOX>;aA)G==Fe+iv{C5M!YnM&8K#F9t5VD2a%B ztCiWHILt}8-eV}Juz+d)O|`6S1kbEc0}@zLY9PjNK0f7_b?#2i7ZgrW5d9B(AeuS9 za%2=rQ%nhgMyj`SCblr|__iemqY(~V{-BN|>AM`EA4(I8$FyJscdd=>&1-jlnV?+0 zSvcuB`Q0c~7*2wI`$b2GaCaa753DH6zxM1drjj4GpAZ$Wt$KdT#JcxnluR*JjJ#un z>`-A>1e>U#Cc_m<^Y+rj3yy*-7c z0i2_WtW#oG^BgGq-FTfWX9t~xbCgOpGt;EBvLrE;;SC@hBpBcvB$SbBp#+&}7qg=% z+tScfpSmc|i%<3Rl@xMSlafLSpd#0;b>^EmAH#Xqb9p>*IkJdCFO@P;6;P;}QJ8@z z`h}N^%YeSYVmv(?ATL69we*Lm=%$DwH6?VJwO&+xOER!?I`^P>%DyGnhczzbg_rVYION|k>d)|;Lf_d#AAd4_@TlJC)Pj+UoCs0(_bupr214~bpdpIV%& zxhS9qz>4tqQK20aIZx4QK?lyC<1n1)-aw8Zo$%tCmRHT8;%#y(bpeQA<5rU)*@uf| zHa6{EGmKCUamF=fg)323O8XE~6}O z{DdT%FlW6_eQ&W_Ye0?^J=<-1$*=PJuIDFoI%G%X&6wE_Nw_>o_j5i`&&tZtK3eff zva4ABinbp^qI2TjM>Q@qYZk5FU-Df$i5XxHh-F|m`h5&u?%1>gmZD(dP3xi)BJvfs za(!61oaMQ9@$SXb4e{jgQ|Vqq~=a zkv4@6Az9yNZuU*Zzq~XGPM)P?$L~SI?F^)mm`VNd6Z8FDh>l1o>tFPyvO~LW`|Ill zbwf|p;$=z|>Y;(RXK#>l=i&v;$lre27SkF!vetO&&bmhk(!W%d%AxGW8HY~Og9kcS3BVfa^D0}Lg2OD1 zg18g7_8=|dk4}t+F-BS{UhLpOgh})bv{+0v29+P0Mgvr&Tn+I?+7bokyEv|EPwcy~ zaJF;5zBi1hZ(Dta!Se>+B*Pes8>K`<$ipafc=UlSTZ3Q&VBtC4^SbaRtn{86aEw)1 z_d)^d7z*_bC09%+uqdGyNLUw|)klpaGQ15TZT6po-OSB>XK$xE%p4_J*pAe)!ZHil zQYtq2?%caE47Ej+4{7$U4wL-tX)w;(NH$rsU4)$FT_d!+eV8U(C59C+#8&MhdXkun z*)8^h)59g-so&)PBHM1L(9qx#YgM}E+gjL|c+?EWD|>q|wGG#e^vm!%_o^ILmS6Kz zM{W-OR; zX4UXZ1=8(Hx;`~rK6Xtvu+9y@ENaC$p7`(p%$X0yrMo|FDtOj&)r!WUr%hG)!d@O> zw(U*$Jaoa(f?t{QsnI|>e!5z8^Bw8`T7)whEhb~DhGgyE6`jUsBz8+9Rm4bQj==sX zvaQ&p)4tJcdvD5}*|8TEV`n&u?8-{!t>!!^t=;Eiv5wmdevjKc2dmv$_xf*#E{($N za%5FyP2?7DKeE30x%v(q1Og)F=lp4m+1gS6aQjqiq}xIxJguV9kgy2p@}NQ z0A~mUzMlR-InzU*c?=W_&qp^->U`Mln~a=@TRrp_&#T%Rn~L1)-`nv`$gCLv!svzV4Xc6nEb zV2i53brm;F_oJs-KFnBg+RUM~AdYrOjZGh6>b2n^B+pFuW3vF6Cg3oxY=Eb>vYQu5 zf|akBh+Ga8hW}uUvWtej)5Ap>(w~Yu#5okk_0yw2@--8MaqSmuSSX5GqXmXGcl`d~M9W2(Y+S(}PXfh#QVrQ(|c=0N5E{h&FAoH;th#W_wcC{V7&SC5k zYvbWDP5$y{{mFuS%>fnAyJ2V)ouE3I@A!f9d=agr!b(p37`gFcy5O7xFL&gVevD3J z-1Gj>n9=KIQH#@d&^T4ZC=bRr7uh<~a3UWRS7#xYvHt6y+i>(P;Ytvc9&f6fDERj| zgloJC6gL1%H^a+WDVSE~aOg9^TAZE1u&6G*78bS-duu9J>K22*1Ak|&E;z&H=!#7E z9_Dv{D$QliaSHOYMI<5azCUdQ5@8mAcFBX#mnO-0V}4&vh!P2TaN^JGRYSxOQHfV% z%QV-AB9p#yC1By^RhmMbc zoQd%xb6l3mOIxnk2er%gdkOM)|{+96#*4_Z`hQ_h8ZDRidV*#(Ces=AdET@E4g5 zFqbD8R0s^y;yW7FsXwmN6Fu*GWwppboUZbI_BBfa#E{?valdjOw(MtaGONK?7<%D% z4EZwg@MMwwIO(#Sj1h~q`>23_U<;iXj?ZzTq;3Gm1I}^k-+ZpHh=}Y2rt`PD6(Erk zF?eI^jwl%zy7^2!uGSkJ$Om8K5q>+S@XySHnGOrpL0`tx`?3fGyw&@;snjiN!pn$Oe*P4OpakK_3kYJrX!-FxOF%`dCd|GpDgqwVR?iSzUUS|xW z;aiJ@7@eN17jNZ$8+B=?U83|v+XtYxaPkFi=<0F()h`&0OnyS}^1ZCWP_{IgdxV%G zz0m8EQ!GNNh|hCv;FW?AdKz>v_c2TKj2wg#9zTym3v>^(?D8{O+vNB<0>giM7>DIP==gtYA%KrCC1QNJp<~At+ zg$Ro+0>zns_uoI?#qgEkL?IExB|}dh-%V1}|I1fu_vbTX<~H#RzZqdv1+znO|<+4^;^XG_U9DeNM}-KCO25j1Thz`aT3)y+u?)z7|BbGy7 zYByp)h6g;K+6x9M<{~10sOI+UJSphqEHQGCrSUj`Pr>HHB)Tc$ zps!<7m#`l8ZFaa`7kx?U8fuc?*PZa!zY60tnTA~9qM}9@Vy^q7A)+5CX&E)e7(NXc zF*Iti!5GNMAi+DMlkonu@jA=K6!A<$S*QdMJFrDPV%W3t>+bm%-^0-ql0y2<{`mH< z=oVD#CFb?Ws^n)E7NeZB1meRX!FN`K6AW+1o{@W3>2o z>J-A6A}xaJlc|hjch~7TySC8g$iCm9c~)EbAE34Z!jz$|mq^Pyp{AB7KGp6$6R*!> zm@9%$oCYGVj4%2u^9?^HUJB<0tjY)UtBS@=rK^tnwAQkd47~$@34*d}MGAQg*b5Vz zukBFcsz_VS#`s1(loxWRlEH~ASLaw`M)MNUW*Htl6$NJH#cYEFsrSxU6{3U=`bdN z7(`?btd!Gcm0|l)0P5nK4LcK6XE8B#b;#kqOBra?s>cv5Nm!_qMw$J_nO}c>ri6ol z)B1I-1v`Z{cdh364u&hhqyP6L>x+)yJSU9kJrcs-uI=L7`uK+{QizLCr)Q-H&^Squ zF~~psVjwwPIFU_X`Ra$$1fm-PTX6}Vi4Ljx4jG)8@emXVO@?E$>cJGwMcUiQl1Y$T zyMJg1GYzVRq73soM_^cxqoo|4;Nf7ZO*^MF&PfA=LWSCn2Xi~&^9t&*UY9J z+b;%mc}n}&BwfBKn+ANTyy!+jl6VIazQBU)(B)zR&hflcb^R|IYW&~NpWNN~M6lu9 zVTO#4lx}w7lw_0|Lv&;=Va8?WFF%t%%!%bxHZ}%p@uo;mkPG#iRrS#+O@RH}VUKw6 z)UlZ2oyvWibD+$IlbTu$dz-rHQzwq6b0X5cS7x#+KEA}+(b*sJq=&8#&+UpStsTfK zBHN!1=jO}$tA1473sQytxk;;nE<1FHGdUPh@3J4*l-~Q%QP4L0rkm$^Ond(r@Zs(# zj3C@poB5L*Dv9AA2UhhjW5h$dAZ#+T&zO z-#%WTnKAw?X)A_KvB_K8b>SBC?%W@V@W7^;4UYEHb8B4r-C~_Cx|&2F-9xqvo(&T> zP)UKHQ%xQgRq) zRx+`E1B&|s^TRw&h!kuUZt!%H7*uIJzBI3lJ1_px5j)&4`|9{jF0%4u)*)57DPsQ0 z>Av7q$78a0)B9gQq4Xnmf8^{Mn;W9jF^^{jntE@pztz3?$K zejP}DwB4eA1WHn-MdLELpyX0}bN!vIa42usCqy@QY1rt!!N|Nly)v1~{m=DXrkL<@ z&A)0MsCDQHcSF-%wQeo-!Y@P$9m3uU$kI9MFoKh%NdVDYx=@nfHq{OOb$KJIt2u1K@B z|G|F{@Hu;)4XFPz1{dot>FL*M`P=3vTfHXj9x~EIW7_x`AbQ|-bsfY~A7u5r;ne-C z72X&Mr!@oiqbfkCe(MPi6H4}1(&#Wd9Vr!h9I-QR&#HzE!%s7$*k?$gU1fa;$0wwK zk?6-IIK}Mva^}foeeFC*!u62fo_r_5Z@iTz*I7(H;*4{uxJ%q(wX~8!^vVdC$rO$rN?0m$N|yWb}1#yahfD|#^@XL7^#Dd!)n$Q8~g6wMOitfM7WO67>MYTvMFgee_O|V9$RVPO{~yEXdeT^ z7JeJ=gaHRNIx!bo@C+b7_%nS*8rn-k*DMm^#)o&^&)U|&ZW4-0%Re{nN@Gruiwv8U z#N+*C&W;f1_I?N$Her85Bk-vhDpMs_rQ&|GXmP-2AMzIh7d`29D?$^B$Q+o=;s0mU zYJB1d&2?IweY}-jQUmYZpV8gEz?&~O28duQF*<)ua8|@s!5pljP3DUAx~mT4cLk4d zgfCQJ%kq>cFrd@y>_?=iES!9Wo&RPe+n&@?fKD(nPwB<<6GDNLSbdu2W0YA&1k*T1 z>j_4N6igvTijvnN9CNn0Be&dfB#_=Vct`@&UaZ-%6pkX~Ydmo_dWkvuX6@&ONNYn) zO}v8q{OVQ<0(4^T^mp&xxp@wP$F_vOn%;jeQP3{6-a2?5&=f;BwNo@Z4aw1hsLFnUd&0}x?&6?Opi0H>|-kxat zlig&$I$B}WSk1pApZdWR5f$D)tPdU14QsLvtxeX=E_WoZA0w^8-`3oo-`G`IN?p>`iSScSVx$E<0{PhFE1|-Grq6o zkgky1Z~YGS)F)5O5FSaXw5+@?`2tE9?7rsIt=ZD76hhE@6$ZoG0|8$#FPfzM<-2iV3ho;SY}oC9Ukxb1KtoTkBwEi=X1pdHv` z0%ogvCDZIx8IBK`$tu%T$Y}U83c``CLm}kbL4+W>aqz`6ydNv5(EcgCyQ84bAu^g? zshw@qbY^eDckfp0hoJ;3z+!WPIT9F#9fpni4{Y1i!k=fO17b6qLCx-d%*yl*BW`yP zbnuNU8ZDgt{+vpuNKnO9yf+7bfV>p~YsM;!C)`m(zl^7K`+N(i(M||{Oi2kze!*u^ z7X!tor#s;g3;2@l_#O>2v2EsBRJa0~_8!3_bA)H)-gjdC-vCLAY3)*-Y)XO0@(6_P zRa`+lWq3;OyhSml{>JZFjCu=8DFc>eQs|8mHEkWU1Q}KV5c%wK&|CG#MDMXYWD!}vJH-{K2q-Qy7i2VpHH_G)F<%4BIL0`}Am!d&n~ zA+S?^?d_f(_YGPHyGcfc;*~bgrj3m^x}MW^&b?b{3=zl9*-#va&UXZp`y5kvJ-3Z(SuPC6dHAeri=%$%k7lVIUSs=# zcqEX4<6!Lvd3K6C=1hNXLm9|xu#MPUyqQ*^0HGNUh$N(QIrb<-5FPW}3Vp9T z3P$+D(XWMP4x|^eCrl7CCb`mWdQ@kse_3uQot}Yp8Q$dV;!(A=lg^Ohb=iNIo zREOpSJmz+l2iBZdY2|D`+><8;f{Z=Fa?AMU8z$}sPI^!w$@oe8-(j1pBRRHjiSLs% z4tgvPp&HJYEKRlihSg??;7ka}NCgV}m4mCfp3+zxj6~ZFw3cbq%0Fn^>v#yTw3zb+ z1;fjgp}<+J#&~`F#ec-If(Xtr&#K8v%yYm35J@}7dBH3Ip3J}p{;+Xy;Wmefu7(7` z#7SLRMOp_Y30cBxKYKr2tjpEO*uKdOB!lM<&3)?@nC12$d60s`sVtdzs5J34F*N+* zy+Y^D#H#i*sc0hFPBidal2PBG1v@gPE-EH_c=^WaIAJ_ayVYtF4xy2hj0}OMspbnc z%h@BNsb)uPGv?wfSOX-}?)3t#@C)xcTsvv4s*jQQ{eQav)gz&RM(7=~n$<3;jb)D; zUcm-Gs#&6_3R-+CE6ed0xe^z>g<0I_98et7c-Zy;06Uu6RRS-k72}1>8(4Ujs9+g2 z*}N@W)&>1vMOffj4&#Rm&a~fjM~bk?wq1YEu%xu`O%f1B3*svtauEd5n81e(^0DSy zx`jSoPi(DwN5_W`k~~hE4PEq!lyTVaNFW;!C0{Y>Pg9C>D%qbaaY77(TUy+&n!27d z*1T?o#=o(AN$5;S*Z7-Mj#tbNBZvXQ1@TUl^Guw!chs^{=s}E+w>>wI1e95huUizWg|sS&!FCWHB8w{i^o~mWK^S zH&r&#SxMQY)b%#$?dzK!Y0Q=7X_(cs0Ot*4*|M&VYEQaaA z$r(bmd*SJwV3;)uUKm|Np25`P2G$z_)b;J^k%w2?!Ym(MCAF6BBN{R#A&X4VT8xI& z4LU@DsB&q9l|_3ooUdBeLTBNNO>240T!voH_oSMH8p-sLhygsflFAB-F8dcwK@Tb* z5J_^clXMc%ix^88;EjzFx3a*doxD9;I)yzgBbF|)a0B+LxV=3+2#wQ&@CmWAoCVhS z1EifNs^dw|W<^(BTf7gU&rB3CL?qI5YPT&iTj8vpwea|Nv980S-RY>MDFZ8G0Tmf) zzlkv;g?BJrStR?GwsH5s%WcQ|yAD|SxrZE!GXMiO-PeGj8(7lIP|$%;GiSpUR{t?h zb(;nA8@eUuetfL;EQyxZUw6khX?p{uJ%OwCV0;B5JOobe2q&q=7$q|Z6wAC@){KDA zvM%|H&G5`jpP3RfaJ-Mq75^+WpQTqD6mkz}OCJz=1HXm9rK_3<$vJ1*yThL~prtHA83j9`K5bSqrEak?0qgVx=S$EcoN4aIukfsm(_d z{oyMeub9t`kN}l z?x-OOyK~VX#qLBV_ig6ZEehB@)uQp-1IO4pYjx?71-R;M_^yS_{S<9s(7_$zI=eEQ z4u@PbBHwWCAK_g;hc{0Y@PJR5IRrwF^@bVdd;}3(QE?k;MJrjb+%3+q^2-u(ZVKyc z`AN^s#PF`eNlKm;d+FBVo`55W=``+Y7zHbT%Be5VRR~fOKriYnWS&f60m-h37z|^`!=m=3>QHo{B`3^(DcSMdwv;@?){5>o zLKf>5ub$Rl#Am&C>px$AlQjB<{e99(=6r0z9pC=)MDFx6V zfti{a^dD`51l&d|Gtj|&KehnZcY{`Z$%NXRgD}3Anak$$6yN^TZgo>0p1_}(HcDwJ z6OtUIrLpmG%0Rjn62NAWfQCboZ=MXwoRr6bZh06n^R(1spkq4=7H?}Xy0l{~PHA+V zSb1YY0Py}?`OBQ6ZsQ5}5%zQ)gYgyuCMPTp44nnrSX-%S^F06-emj8&*fZKc%IX+U z-2xGCyoQ8|uVV?@THIb)$Vs1udK&@B3LwN! zQl>|A(2Yb+wKYiSTVkUHqGdx!W_H2gSy%dJ@7e!j@5_3kC7~_*IH{I0_p8Mr^Oi8u ze)@I!p+W?MZ#M?Q+*kPxP6Phm*RQUedo7-;lodUCNt*LbE4QgQs|SYm>>Y&zV<+tL zfb<~@05=sc_b2j}miUe7a-i0}$U23rrNKk0?;WR~|E=P0hX1Z&a|Z$r>4Z>`auMx) zA_wV2_@P^Q6p}{!q%u0#FREzDonOfnnFBC9q31=YO4j-90pAyj(yD^d(U0*-NlJ0= zql*Bn_^W0@1o?ai(s(-G$McR`vVeR<-BxEppjNGFV33gvr!JTgJHL2lD)-zScLP9> zHFb*&AndzNYbO@e<_DBa8=Vmssl1ur`WCF^gfi4DCCP_wsr+OfYzQ?AA1yy+o2BwI zkt&sJ>uk%MH8?nR@wkP6CyNX7bV3;JH-wk6Vjw!HR##<46*`EavE&rRaK#4sa+c$sa!UAvvV^}?8RTQ8bzKe8a zl^RCPN)mk+UrW{8g(XcIPVOu+W#s_FewLD$o_R33C*V1PjmA#;TJ(H_^kk!oiR%Lr z@rqPYojfhtx2?B74g_xt{#p?8C5Mwq-9B1t23@fo%jrl*D|_g&pRRVLMUg1xc-MFx zPD%U7%^Uf2NT9fpyXW{|(X>Qn58)sf^P z^z5))$v(p&#-+dX&zASeW}4htxv$wfkyRKavS}Ib%q)EOg=vJ*r!j%n;F9;xWBipF zzjt<^V&TqIHypC_l_g?ALISw@K>Tu#C3o3gZ>YYJ-u=B*b^wRG;U~_oZ0s*=-fPVb z?QVCyiPrG6)&ttl6EvUN}uY(I61FA{+OhWVWYASnD5k+cz;(FZv~7~|lx zHCyMWQCWrZZEoj&tayII5lyX^6Ep|s6~4_|1|4K)8itT@vhw_$9k2MrREd@r3;2k; zdxYuo#iXf~a5gM!;=09R8=h)a0%wACIU+Z9B>Bi~hm<`Z;kVEm8;r`-v-u}&07gLw zQr6an50VU2(RL%4CnPe{2gxi+6DM_o7>?YYekhPCeXt?fw;C7t$ERrM7y!}nDzd9x z+>niLkE#+}MS^iBg>EL=?gZ;jzAHgkXt3^Fz*A{n3N%rH0STMI(MK?# z=s7+sZKOdIf2vgAybyVN;PP=$Z%r;2FBCzj#1!fqQdi5h=dZ#42kKLZs`jY^*CNrm zKe*JOHh`n$fD-qgBXmPEhL*TBpc?|@9L{?u5v&Hj30QH%mDf*3XA#tfz(K|W}mPyXU@@(9W4JaUOyI)G2IXVO|yE7@)kBp%K(7?QIS!E@@0wj@yW zHV82H!?W1;46erv}^AET1c z#r6Ih-T>7Bo5j-MtkX@qN+)?Im-fL*>Y*ZH4q~?&jBMl-noo`vWCF4mZCk~yrHNn0 zTYm!jXI`z(l?SqWG1FA2D5369y*+}uh+&~EEH@xIctBkcln()&J@!Ph!`%lY2zGQETEu>E z4VAGTpomY^7Kqq`HBvcpV^Q+|Yk~h&Q2?V`;$y|noDEj5lJRV$A1(;HmV11SC_;xdSenR~{Yx?thXRqgvLCI*MEv%| zzd+ya?8a9{<$~lGY?p!l|Mh%<*htuz5aqhN5nraWU?bRAG`eOIxeT^%0joO{jK@iu zJR@x@sn3t6n@E=b(DB)pU8Paj{>RJ(g^B0ZZ)8?(%sgSQhd~#2U5dh|MY^-2S|qEZ zTk4_p@HEa#e}k`YyL@1uX~K8LxI|o-QeZCe1+0FyTLpfw)|z3fW)6O(5Bw zy9P6#k|-iW-DOqC%TEPPX30wMl&m52g1=kr-(^nI#$~LkE;zt1r)L51yZILRaLfTQ zUJ?4O58AM}(RH%jVlc7hJt$d;2G9d|YbQHYdajznOQ*dZLXX{ht;3VUI_GohTWBD| zwjH})qi|)xkz33SAUBqupHH(?YmPdPj|c?@#aTgoVfyJBGaLLX{`)*%JQoYP==TIOyX5hX2=kTAsT5M6GKssKDy?c+8UW7Sf( zD3|!g@wrcZ0+M0|W%P`bau4F7j&C^Ir5H17vNdN}8_ZRc?mJYmodA+?B7Y{iTC}X3 z+~Gzy99ld#6o_$}b-sL9b)Oe=4O9LO=DviJ9OIec+L(jk=x1DirgY4?4Y06p>W{k*pZ0WGDhnY00$mDGHN`DsrGC z;Vpj$kqV_#Zk+7xexKsHbof>-UB7MnAJ*W`a*+F`hBG~N#&|maSjNmiHOdsuFFOQW zB~*y|FKYq$(?3=9S_;hWKJ2Ga%L;(VUpzm#*R&7WGMlD18BRG%tQjd^fB4%U^o16f z_bvEUplu5oWF-1WTW;Ph=6=AIR$GU84x9_9 zNW@21BomQ293uQC5}%ML=QO(axbzO(P#(3f1T;Q4Kiz$hU8sw5Jz1dQZ1?wv9Ww-C z2M02bc>B%^IzsY?Hj3(#eiT#fU-KHhEABbHx<36Y-E8a}Q9q5)NI(4MEV{d2yOS^k zr>*=Rh`XVidihO5G}6fvoaMzET=r0Vw*KdphU_xb^nFQbZ5aMhkNF8)2pW!9AnGZP z?abFT2j4@(x%0Z*9x4=M^qgsVlZx{4{LQ?Oq344M*^+7?!$(M$QJqb$k z^7*IBP19^$PvTg=RIUb}Nz>K-%LSm0o}3wqQ|OCaD*ZCj?k-)j1%#R3Kuw_-XG$9( z-pyw5e|!ykC<-Y=qN(ysY0Bz1_g$`D(%7K1TKdu>TI&;~0xUk5z9prlVRO%q*!=04 zqikVn3ZQA2GgQ9_Y|;6t-oq>CrIN~5OZwH@!B@^9_TAktPIT7TU4e>&Xr`~l#bmJ= z!$ZQq8b+*fg(kB{^iSok7eo`<>^c12O{!4wz4P%0$d&6Nvb>g%@#9@hnby-3Yy zPUUjF(Ns(C$v#r@_;cCf8wjTDt@A2@MuR}eutpJ0NO0UFJcZwn#W5Zn-`xuY5dNkd zETsn;&+ta>u`F3TucZ*fsdrLu-=7pYbZHNWeNN=G?hn4;I%`YrS0wq-eW4=|H#U1= zZDZ5CcLYy+I{z?{pHGtC(<3--;>gCT?Tjt-XQOw9jT_JWOuR($Ybe#d{hB3vWa`IT z44UY@Le=3EiT^-A*=u&GxR~qU0745rNSHNhTS3Asc*~rNtQ+mFp6@`QtBR7SUh&=jLzWV$yh_dw5me zwsds35IdB;{zn=D!5{k*+~u@AwoGZYyA%@)=u$dO9Vve<%A)Q%jm>z~jRxM=e4w)N zEx+M@bpR9jO-*{!<^Yg=6#%1WV!0jGj31uk8JsNphJRR&Hh*yDrH)*C>PjMfvK2hP z-R_Uxoz<<_SG4>J0vcc@U!EU%%jz>4?Uw17(hS->riE_Tq;FT8@DUIQIIZN($S1*y z!jWtiUR;AJ>g{%E-i1mcZUF&^MuyK}SfbE2C6OU8r5euLxAgN*+pTPeakoZAWtDAy z-7~8*OSjID_-2cc1=#rZp=k@b;F5bp<-k###ywxa0sH!v0BkAPg)c^)L1y`&lLt&9 zD&NzqQ0CTT7!r2vn>A-f!f zbuoG*NUI2UyEC*ZPVG!BNV_^aqqd^$^3{R{N{ndA6z(mB9fn+gilGN$RUbk=VX}AK z{gET$v!_|TOlz|mH+P~r5RYlO7fG|iMM|OWN3$@#COZvXrtV(43NIXTd^>r%Kr%p> zZ(9FtY?#jX@X^PIt!y*Nz^TMHx_w3P;cz*Np5yrqi=k@(ymvugK}8r>JrdaK@}7s& z`s7oqb+<2i&ZVk*yy0;1 zdA9aY){ZMi^qGt2P>RJQd|ppJ)05dq^8ViwX4^^p9$lX!EUAtTSdyZCY0>NKPNexP zGGDSg4#Q)EVcqWb*A4Nr5R@mq^pQ}Ljh>i!ITs4N_(XWJU^YXpE?Zy0LY{(SEuS%_ z=U{gX1K6TT1pLqT9&vQknJsOXs}LkDB+sO=E$<_9}$c4XTeYyiY8@F~_ zgETI5$*K4`0YU$t?ggJK_X$Qa&;gpld=MfB6N$5Ppr6Yhggn>K3p_O*|ooHWPu;n^d3QT5L= zSk+3=n((j!hrBfjKOnVc7w%1EHe*MvWSt_UyUBo_{mdPRU1V^*w z7vVyU71DaNgR+}M^GP_Uip!<#21J+cwA;aiKmY@8GRi(HnOTTwY#k%lDbJEiHGRmt|`+9Z51^sZ$&8OV^MDJe}>LJG;{ zUO7^Ik%pX-@T=~W*w}6uGCgvbH}Sa_ZTE{3G2Vk`vVtcLKjItk&olZUl48Du-cR{W zDXqVZdf&C&+2dHKXx53qKEZ+DJ^?XVpw}(yQXNM(a8T{#()IPg>%`66q{SPCAL;Ji zswp^Pij%;1^8Li8tzL&v2K+u5l<;c0`SGw3iD?PFlKECOUvorq6Xdgg4KZkUtNtya z^!(JzMl<5c5FpR&v0>O3yx%A7;3aX~`4p8{-kg${>@@(rZ&1gDCZb!hkftpu=|IT- zMGj<|cF)PKNb(5!Wmi*34%4kJM###rNrY@<<)5R-1X4EETZB$R)3<4|z=G9 zb>iaT40j^8>qf1k@9U!K!4}R0lzh`SBe*&hhoFj4YF@!)#@L1LZ#*QOdv6BC4SgfA zZ3M|@(-v5e<&%n#=3d+IOqY~9FW)B-lUof2YPVjT-8xb*gz#s=tuPtpt*>HO zwhxbmD7E$=BH@I4`2I8tQ_`Dcq!|B+b+_fuY0|G-qp9A}(H|VPlbVWKmI5wlweZkELz8-+$(dEZJXdvDn6w zdFXZ_-?ywpOB+N|HalHyVrtp#|NpvpDgb+7Zsa`;--4cxiJoW^ruNc<#1moaZI|b*+i>*#aFc1*VWr#0D{0zN@!5 za=pT$WObVBaEEv*A^0}M43|`?%dNbT`YX}+rO$l8_o*auF9tEXqj(VW6$rI##pv0l z0zMtpL5F_*{$|91_Ad2%Z#!M%OdUH&3Xle`xRziSnaeMUV@8z!BOUQ7F()&9|0@T! zfHnEJ=Ie^udqo*zo)oP)Huz+q|C1TpQW_LS3v|$1TNgJMCo7T&ndCY*pn_o@Q$H*_ z>q3W2_lr51d}D75Pz>;K7ISmwIOP5OOyonta5qVV=i4EEa86PLuUsR4mq%;(rXwVA zr0v|+e@CI_GU1QsI0jhgoKDy*iimg~e;f)kY}k-R2CCu1fvgX}oriK~)SuFS%Qp>6 zfo_aor&1PbvZ&xSzL0yMV z3<50c9xqnPlz@GE=aE|6`n!JG*q}fATc17iYZxx~ zuaWfJHAqiKM)TUC9z-iVVLkp_58)l$r0@krbjY-9{Dn!Ou}$&EO#pDN{gYCc-a)w; z&I@zBB{JbJ_tO=6!fP?nN4Z4S{rip-+%Pxq z7L#m|uKIeazy0?Oy9+Zlwx)iysZ>kftx;!HGc>MfFYAtB-mx?CR5gdbT(0`i48nUI ziikXkzg5s~zd}S*`f)gzL)}kTjjc~LDA=oDg@pq*dZ?H6;su|t1J_>tIa>GqWFmzw zOsdHzZJ;PXmEU=obncTw*&DpT+-s&N7k0uQd)!-kPw3*00k-V%3MHa*szG{Q^7rpK zgpTY_U!^z=PK3b8nO5X9sZ70dwo0>~?EFe$Tw2ajfYR%DBvOru9zkS^+krEWP97wJ zM#i1Ir!O2*$3i~sEB36TY$n{%yGZBzDp%Q>eC*nZe^kUuvW4PnHBl+_O$jFbco_&& zN1hvh{AllmnI5+jD8N9W!ep`2HvXVBS^xW7S95^l>&YhDksC~IR1tF0f;kK%R;<)3 z9>Lbu50G*60O&`DY(DN$ebZ!lz)-rMr8+LPOl)ZI1fG0}d)ndHSgY#9_-Wc}CcemF za@xBiLk!tMp^pr#_W0oMLkCvN}O`+v?Cgb#Cnol!B+wwyK(prXX zKmEoP;=7;YbsxyA(?xe}kin!FogOkcM0@3OGAGXdh zx~{1G_9wR0IBDA0HXGYkV<(MmG;VA(w#~-2Z8f%Yckes?$L zv3EGmyoFA!IaOLeE}RT~CrY@bmf2DQl|y}dgpnmJjla19>w(u-`N+Jv!7aYja+Tx4+_p|NM7ucDrX?Wud?iS}evkS>SKn<6q4q z2yJ_bYQN74*SD<&wKL4{e~HMyLnqgq^0BKwnCRYuJwOYN#iEIrtUdGjBU0|oc|R?0 zBppGh+}n437t;oRuiic+_K~}&Ss|)*Qt0ag|M~P*{gh1SM7G(B&{8;})SW+fb?W+1 zOxD&2#jFtv?PsxA=>{#+wT~VKrPBMG#v^1n28;4ndG~L1@kCkORrF}wbttgefvEK3 zk|GkC&S6$ON6o8S)+8+7U6V>#OI78ei;o&%g^0nY_jj;Q;X3}b_2@B5g;gl$j?ziQKYMP8lPl#_Qnvdni1xbGP4H zM-1O_d+`=IA5&&;<--yU+z zO`3rP#%LM(3l zLX77kWN7_Msps|`o^~_dAIvAilJOr5!w z=Ym0emyJ-@fc$l_l9wcT=d=80{r(5<=)0$6gO94YCKRAgW(yL+uXTI&ms) z=-0o{_!FJRjl3B4{I{h6?YhNf2wHh@`qeIoODUrHEwD=mR5SrVdau7h> zkO$bzGJp**i9g7k8yT;(DnWp<+qlf#7J|{n7+~B%6pk0(q(T&`*wX*xm$|ya0m*Ek zIwE0^BfllOb;PLq{{1owS!se)#SI*GjFw`$-Iyl;6!{KHzB0eKXe_0wV*60VD{B)C zc^)}w72a|k5GB-)Of3+MiT|tXm@bYFlfTc;?(z^Y<^!DZu<^sDbOm}+g`8mNd&IOA z9vly!qhkU7el}OC+ZTaX4kTixHBP zc5gS@E@lDz3@7Mp&{;S18{t_r&v}k$1h$2aN2ia?e$kc2L_Jg`7Y#$=%;Z^~frxS2 zv0Ll7vk5I`Zys?3k@3lhQSpZ$G1=SUW7fv$eETv*t#UCK_>$o6%2%BnTjUf4lzCSJ zeG6y=O(TV=YJq^-(H0IFJEM+ozz%!Gn=xHrq8pgucKHv}tv5vIKmymkBQ$m>nRgxQ zcfLi2ihZ$6g?7Z4u-L?#oE$-m==2dkbR@ymIKHO7(DdRU=QA=~{k7yj8Gl$VxrC|$ z?F^yN*B(ksEl0*_Ft;#Kwi2o%v?&s%f8*Q!hFa90yd$=D&&>L=*H9JLJ#X85qs!B?qBOu}6;MVLpWZpLty&nLX$FAwv9~lOM zA~xcUbU~3&mq|ak(Zk9K)C5NsMe5s$_Q?*+Q_x{Dy za}k0Y(SD~V=8==yeghspg2k=i8o zHc?>7w}VZQV{VrHPUYye7$MXbix&9RZ)7Wr#UIglg_;uvwy&Ag)Zg2Agk%Ctl=pQ4 z2rKbb`i^ckQ2PZnYU^}|F^ThHSVe@gGi{sOqD=%W09}ugf7E?K$O6u^xu!osb*Q;!z2337F zyQvyFDA?<9B@E;&8tK4L#zhnT%SNvj+bY8cRWpl^;+@?LB zETAitckM3>1VH3BZ(E~7#ZWaKUm6kCi4Pvwu^DPxhAVtJf4zEjKaFKW*gPploVdwQ z%+FnceV>djw8{(Z{%&0-KPtWGebbBFJ*!3NhDJsMGfpvOYCQ<38tN>+uRctMP&`4Z z2sLT`-SC=UNXXAyzc_kryb3#y&gCqzy%@f}-b~&;|E+Rt97`@pGBQViD16rmWwTn) zffoGvdWb0OfAjwKv)<#5+I{+b37103KW9%iojnmqv=wUfOX8YONNu%W;f=|1Kak(K z=<+^wfR;g1BK{n1j5wrFMx1kHSWQj#Ap$h|jTh^4 zX`73S^D{qp2i?F(q5-gF&zVeIiV|O_&&P|vC3QP_XTFKdlee+gIlz_MY*7+#%7h~M z^D!+>3}*n4EegebU-SuF$F>gLGyCwus4mAsi9kEH^PXb>j*iD5E|CaC4mtaIZ;Dc$ zCY4-F>h6_T*`4=;4@;$;3qlrp*mhFCkD8Ip}dV&wnVaU z@^K;P(s)NI98S?R;w*BleT6!KXSBe!lm04$&9XEIN~!+C0k$@6hk$u(sgR#qSY-CP zJ=r{Y1=fI)YGjk!%XYDP;1ha?-I&*MdHAj9sqWfDn-@(>K+LhLs-gm|L38M6aB%R- z@zt*$>}T|OKkIR*rl@uBoQ$Nx&(qFdmHBmq8BeDTRRwd?e1E{*Dl<790ySAG9NI`?q10}Lfb^rnL!ZC0RF)IPrlPC?L>))%^Q^2hzSzH;!Yz^2z0jSfhnqmp%GJ*;bZB-nUG6+{UqDWxF_+^z_|cSN&bH z`H~pNS)RUh254p1odl1A{WfORx5&y}9@93X$#v~60^8?gu)#e!3;r7|G(vY{W~<)T zWSO)>zkPm{*DioLw?}i*?{)h=o#Q+|dEVMk@2fJ;aj{mPm3`TTp)#9O^`p)QVaO=U zr!Gq-Bm>i13ryVh!2PUm2OMD+ie5pZw)Z=87m{=ckum}hMbF%&W*$xzxT1KQV2LQ5 z$MAj|cwOke2iC{K!mHEL6#HBgtpGOqVaW%AQnwSFD8V%HLqPZhZIb zsUL7gc`kx5$Ysz+;!tSBM*;||ddRS+pZQKylyw{C_;*#sRk5oV!0EsW+uM0hMl0MZ zn|CZ*uS?6gvW_Sk+6>^ktAu)cKbPOKur(ekrYc*}ZC=0AL#Aj1Jeg+=g$;fKlyWwO zO>g2Y|A(X#O9NeiNaJ#@fw{3JjOqpYYWMLTcsnH$18eVbJ~{d0BaOM$rr&ZUxjytq z?W7{oqNm{4_JVe@gTJqzgc`-EBx*OS#q}4hUfjaknIBqR?*ag|6B=*4{V5m$M^Szv zHjMepQSmD<=;usD;V1C=`18z$kaK4V%w7d#iVRwH4Z3XDH5Q;lf0d>ST>ddma_-Ex z`=wj*9n4e8q@-p+q^!!Z2&d}WY_gML>)|*RhU&aXq~7NY8{1Rz<`h9qeeswUga*3E9(+YW@fEc@($BO z{NJ1%BmBA6Ye+6D>;Erj$2$Mntw;8!hQn&(**`yIM74;Mlbw{znm7au@L8hVH+v&0v3Pt(B z!})AX;be-WcXKfjO$NVk@(iW?#139yC+6gBfwEja1J~%{`cpeyX%G{kyfPeu@txEJ zXjCfC#6Sl^9?x%vLsw`l^W1KK^89q(CPw$+C4O*1(LxPWa4Nrxs0qV?v+7>C#e z6MeDxNrw7mCRB=`{z|_SuUYA?=6=4VS&iT*wPATAjI+|v&l|q7y9S7}A?9P_%xE*) z@2=p|pPH`CT$_bh9dhoi4_M~_iE2U7k_CN;ywu9*8PSfW6z}pJEx}-y`Gjh{SN}Sz zIpb)4U~S(W;pb#KV{yUeLCUSwtnK0pN`$3#@G#jNe(Tq+J`B|8fM^s;8L*_SNe@0J zX-w-jl$l=nEvIfs3eK!?Z&{^DB}sQWY1J2r81kG$?xYSZAHEa5vBX;)AEhRHm{{@aMhkrMIVg38Gn$qRtCLhz$$`8C-Ozw99=pv>bc8fnJ2Tv1FP?`el8BQ>r^CNChr&bVJ!h;VY>&I*UX zK>NfkXV-aPAQ+GrPifk4e!)O$05&zlaI$jX2QDaC%O|*95{{>NT3nnc3W~l;4*=BJ zPp$65gsgV{3$eJOS9q#e2&!5Py#JQ*?NGP0#WlX4cA%!7b17*I;G~K@?8G_p6x!O) z-2H$K^dGn{DGHp%I(}?(ppl!WYp$QIt|k@I z^4GI{@c)o)@?B%u?fCy9FU~J~YIrvQ@gki@u+3~?@WV}g=`32WAj(77-jArP@^xfQL|SRSq1$vsdBQidAhXCb!HFr6PyK8DK+sH z^CzAbpE$b3qF}U)UEl;#^8m!3VriM}AJdbfQB4UPu z3Z;cUibB5?KL@uBfD8L8naB2kc}aF$Fd*zUE|%64m){kIWVsJ!mV^ssEQ|_64E?E> zv|0Z*`8=(T$02*AGZq_@YrA{~*FkjgE|=rlJwNaQcxo@T401fY998DI3CUYkB0@uc z3(GkP6LZ%%9T{iHsZVfP=`h0~oaC0AEgH|4W=NO*qq9kI!EE$aEElX+&wDsg!R=Wm z%B0-)$CpW|w9Wn!gqL+&m(XekEj6<`E0LziI$>V_yc_#&ub^BvZpg9^oM98AGnk72PEa@me0Sm{5*_t`vV_1uB@p=^H zwx2C_nO}3ynrf;Hq5obBom7t)??(rs&C{t%D)|u&pQ?mWSMkAlVos5bEZ^`W~zi6&(Egq?i)hJ??Z^4rsi zgZ|y3!_s&gfvMzk6{idH{4xNTKS*!A^)_lZ*jSvI;Z}{1FLkm04hC=;gadc5+@io$ zM^U)nm6@es)!4`};Wy@P#@>m_|0v~qHQ*7>F>V*kXeb=D7)Ul%R$@cvL|ezB(Xrue zKAJ*RV_Lx#HD3jn4YMNrnE8_KTx|!PatX!Pfoxw&*jqzXIoEgUE3mwa*r+yGH~1;j zL1uq)qPlf=!o71d6#f$IMd+KHLULaNfrf)PVM!mlPAK&i{rYk4A?Inn;@h`d#IHTcSYqJQU+O6mjhb1uw|S(M_ZD;dr`#D3(h{! zY?x+a|C4a{yicxkFCu_b30;wkc=4NA8lHd>vuQT;JFNS!08E$?m)@1zVO4zCdMbGTp8o zhC?wms4`eAk02;XIa~s}chYa<(~smdX5Ts07vTnN&29`j1HdcslQ8F8Q!}T8HfOFc zZR8rMtx{>QY~9C_m%~~o_3bDm(vvJel;$aiCR3~4GxBwI0Ocop+qmjW0#pK2>A&m@ zJS4z{ZTZirm_}GNcV&6O!Iq`#$h*375)%D#;-0^vT9HR-Z4(N}ZGfM|LN|5m_tTM) zD@ViTAB-c)9Qfu!*nrDc0bnOO8&KI@_75BjDpK0r2+I7OmQTB7h;8oCy=Mrm-c&|w z01cQ3m{@Lw-&S*gOEsn90XvJ*l}N`{GvGj9V}lvm zSLp$7MviK#eBGA>r?cd3J8)}kn73S8wWMmuuJx<+tNZsu>S)U*fJ-R-yF|Rpm`R#R zgj7lwv2o&hS9N_u$s7;`e`Re|Hs9PduVg7;0%ihc21Krqn`xt~iK=c>{gmdn4`ei(-*r*8kdjti17TU$td%RDq4|zZ6 zPc?FJoWFITtAtl-8Z53jrJDWNTRdupz0tbe2{<~iDWjt^lF|0bjier7P#6kk$K0L| z0dJNtvsVBG1N=}pWRjrWr$_r~IfkJxp2)DaM{bS%uZ3$xU`DT}$JQgLa101aLEI8cV53%OJ_l*;4x@J=jVp#VV zC`JQ#`0rDYE9S8CelO8DL31pVBNZ#e@JO^!V+5%K7w?4qhq8AZXaUn9Ra6VjF~oF(LhH*$wA|nuh21L-TO7?~z{^tML0V%`mWO&&#@%0dqjlB0uqbbje{bOcTRScu_ zhMwLvhdjC`V~Cl^V4WnfauK`LZU|ky!y7vuXEia>rxb}q-XQ;9X)GE&EQsC4>DNl-rNThBn;@wnhAuHPNx^4&02G?SQLTq+sgwMHu6LPH2QLC;8eh#Ef+CW z_{|V9oi$?Y9-ZKDU4EZcG@a)l5SKCiyaqFHlQxgPAJ1w`^7ShcuuW_v1Lno?VA~E1 zIII6X;As3Ca5UyICg48z5M?hdGm~c-c*3mZ)lj1xN-ljlmw$SQ8_`~QxafQ#D#$OK z$y6>>u$C!@PWe(50v6AC4n4c=b-4vnUa}9Ddfrb?L`-3yK4Ky(*5CBOGuZK503ifn z<8io3q*ptEpD4ibQvA2BVC=sJZ;M@QYDHh2DM`_SOf1%f4%vMrTvN)ML#>B@TMZ{7m zPy1Cx%%e5VmdNf3j}(~c^R%z7)#X4Ih079h!~ZNTk;j?bQ>qC;KKP)lYc}^|pxzEY zaM`k*r|v@PKGN)^a&JZaj~vjXxXH`yUR*|`Ur-=gmmzRJN;*8th=VqDw)62tic--L z@GJwMDDdVc&+}0u01ZqoZE?Di;-3c0Wk+)*tZD4B5HebvD2H&u%- zf!Pxz{7;O!LV?f7v5aDz$$FSz0B|4<>v~T-GE4fWcLAn8MWrRm-lz+2zr>5Zy=#b-|Bs@%366{ zE+C<*MGB?VMN7Lo5iH&#yR4=hxF86DwUPKZ$?w=p5!d7pOWDDKD_w<#*75k6*_7Dp zTw$^>?z8YK74w`vbt4Uzaa~Ny%BmTta889Tl#0960~xRhpI?@@9xSO;G_HeJf~QDH zNdYpj&1){-ciwF~c-G~O#q&CfAc<3|_oZfR1x;swh=Q{ii~tLpv$X}(O1LCn2#B|W zSARAGOT^1P7eBae^T`_86>nB)W2M~tyvD)?K_NvdsAqS@O}Xhga&`@d>yr8N>HL($ z_~m*&Ny+hlE0WJHyuL>Fo~~2s zps_yIX<}%EaYnBM_4&+ zXh=w0RaF(PZ0Sn=zuo|eprWFpU}#9Xzi%PqXlMwAE8_@-@kNN2;r4VR6B_Z81l$$e zvoLSZU41N{cmR15xC~UkNxj7;E_bG~ROU(_V958wXqC^LQA5B?OqljJGAqt6_VZ{$ z$V;&=RK)%A^z1PzPV+dtB?%+jn5BNU=!6Y0QC`lP0C;e{c*tH95nl+js73;(t~?EEl38!lpA`;{i`mV z5vc{Rmg%U+3dSWNmT$D6!Dlxuc0xY)5UmhT#g}Hm>s=4F&QAVU@Y}DxzWUd@*$u)) z(YjE@`qJ|ocQt~}-A*`%jH0S#y?f{XI{v&_eX;jAkW?WaO%F`emotr~i;S+{2pb?6pwQ)Dk>1dZirNOn-gz zqMF)_0S|n{I2!aDR!4sTpgJR2rJD^v_eE5G6N_9~jRfw!R;MKv5{v;JYyLDCM$bj( z^9c>N&ucTNVDt5WBO`uF5$r1qGWI;V2^dZ_=m#;tJ(R*{x6UswC&1%m{5hb*6oTVS z);F1;f~spjw!z5P1d^e~oYcv~&2<|Vmseg`ma#-z$>;&^7>WV2Ht-{cf`PW@_3*2f z@j=Xq9n2TL9-H?~wnPHW`hL9Vj|>gvr?OlWTwXHvGhP`-Dkzhgt~h%rH_R#1O{w_7 zk-G7?oaO)(G1@VKeu`~TM+AW2>_XKG%AdhIZ~j|^AlHLZtY`F%`9~2S77@uN%N`7+$PWqG%Z2sB zWy6T#mZAPKSwkjQvdy)S)tFTQP)fRIPUg#wUoN^1t5ZJ##Ls{|>JnLCiUO>meqn=F zftUt?Yp=Sj73U+FMLk!#2D{ZXZ^cJS?p0&)^Y&2)a;)&fA;X1BM^a3?i(D0Iu54+z zF?y)l=0JfuX(7ZUVG$rf8kFR>XV3edKB8~g3^Wu`p~!tZ7>5&v&X34_PqDPP*#Ihq zWX~T}I?BeONEVFT^+eX0K^829-Dc%mw%0XW|G>bEP1CyA*-C>l;lIKF3Hpoh1P9Xx$tZ>PI$Sd<_Dk^KM-jA` zKj^|&DXQ>DaOg>J29id}_4d3CEzwYNS-g@r2jh9zbXxy{zgonkf?0{S77Y;BnJ9o( zE#l_M&d;=lm#knsZ=ZUaTXzR#6vPO;r{HM49^bFpsT&M06P8a@0j(nut@M4|hIzI= z#-RmginaZ&#=}h=;I$p-(fd)ZFBLWlPF@ghR#}uwjmeNGoR+L$U5))4tJ?t1&`mYh z&F3>!<&R{b>oqo-_J$zUI~^;@6%+K;{Mk)4WCkfaN-ia>X!S6*;GhBsrv(Iy#!vn2x7KIo&P&JszPMyzKGzqg})Q zZ3L2Qw2nefv8?3J=JQkwR}d8!mp0@!YFk6-R~5d3ho6`&bfzgTE{=^0iOMZLI$_|| z<{rknFToDSnaKe6>iB|L^}9Wzy`82+R2XrvLi}XJ?fh7!O;~^}Kk9HIGw)%;GX_Dr z5U`gh7kj@%XEf`QZo!fa8>E~_J96a9MmeAUv)j@vRsm!ljjvVuy?+^7(DA1=*j*a_ zmTNafZ+P9v>h;qWOz1ceISXCVj-|0hw7Q(h0k808aU9s}$LnM^6~A2iLrtWDw&=6; z`iuU@v-(PhXH`a#dKJ-gr55MUjMOt5Lav7XLMgx&(T<+G7gubD6VO=N$oKrvP6pHR45i%H-I5_!1O`RH!xHcAVl#B#3PxGQxS4Za@aFte13!FQB=Cl!UVkw# zSg~V#pbFluuue3Hg^hjXLjz2VF@EsxUO?xRYF>5L06r30I*n?4*6Bxt?%(vZ>t6)x?x-m!4XAEoii=x_qXY2h9#R(*!&BEYwK5 z8fMKX$thWmz@4nSk_3x?)9fT3+uT1eo<1kkE;cD^yzWSCOv`oiAD23MtRZt^bZ2hZX@pry)?J$9!bY0&|pFecxms zJPq;-uHSIn$KKjTVE*j^`h_8l%$vSMg_f4DV+FV=N&f5cv&CVfpqMU2QI&14+Y z7<`HDWb`(~fcU$Ar-e))J<)jEmf%WUPo(}qiYX~*p(42grKa=sT>ElKyV;V&K9{6)PhM0FwzF~J5#cRve{EZz3e*2Zd+Y@F-2uwBY%jOF zI+Ia1t$t*a)qBFDRI_&p_ZBWz-}g4i19HYGb-x)EA0pD6%cd^AL0a`%&Mb~AYHCbE zAq$HJ@zRYFH&d|kOx;kRdfqGv32p2G{VY%Tie8|c*A~U9doJ5sFf4#puRY~P79EP# z`D{hiI^YSzsIk0UM!4$_FF;b3@sh-(g+iDwk|$oq@#O&`h>-ADkA9=7#jsSj8b(0H zPTm4~jhPTx9w57cLh-|=Lo^a`DW6()Zzk7W4o1e1+n^_W?fz`Fxp+?X3 z(BslI<}%PBd+v}a1L8}p)v(6A{(ZA!UC562!#u_9(;xyBbx6d)H9VQ%boU>!qv+#@ zX>o+jT2NuY&C~7li=CpT1@6-iaO;I-7N_x|vo9k5qXlSAFDY-2WUtf};*d-0VVJ(Z z9mw#N5Eo#4!R2L|<8 zbb3tl;abX~m=X1N@Z_7ea_%=S3)2(T3c7s)IXJUJU}}+g$VN_{H1K0RL9fHZp?DuE zVk@u@EO22V(af^aH2q@YWb=0jsF0d{holb8w|GDd^17YFYQdX;{*u0+FneJ+%yCTY zi;59hHzk39&o?~1_$ZKajq~4r>u)GY)&s6q3*||>v92!e?7!jj=QpLY93ce<56075 zHnB&(3rp)gT224PYOq|74nZaq^U=w9*-zHX*`Io3RHF%3SykEGzJQcTq z=|YH*4$qINt7SfRH!b|^o@;%7I{27@a5R8q3=3F4v+Y`<&G(A z-1=j~MEE8HIc0>4mBxM3)+g64|E_%nP=XOjzJIHAQ%9C>d%LHaOIC-bj%67I4M!Mt zb{Mlo`r7DO{Cp5|O-fKzaIt`W3U0`kv)Q5KW$ni7Ky#C z0a57b^TJ8@ag5LHvIkn96r}u2ownh1Mr<8(!^&s@X|voM0*!<#S#w2qygDh6;EB)S zz-*EsSHQ>9blq}Zr1uj-#$nPNQuykgShC33YGJB`5B~@f*;p;!%9-fR6R zN&6fVM$ss#S-&H!{SK!II;>2v#=>?i5I=w^^2;y~-zGeP?jtr{P^sI-q=6@Gvs#aq z6QscVp3P~XO0wiFLWd8ZqUUubni+2aRr0$#Pyy1J7gVN zzbH38lcpINKkz5qBt-?VLJPY;-4F$sYNda~+>}SL;lN|N#kwu{lZ~p;Ovc0>kFEO> zq^r@mF~HP%LM|aud}MCz=cJ%(2I01CLR0v-(|>(EodNn0SIwgoGF{r>3)&)$rPF6Vgaa<(R9Hkm*Cg6hY~R3p%ZQglUqw2C?Yl-2doTZh>Pr3(nFMOV5m zNOV2VAnAvigKBH#5v+pwSK2Mec;XUiyMJKV>^+DZt2Fyvf0}?BI6%6SLR&7OUJ2{s z!Dj?h=)4-hhlJVphat)VG_>y5_KFXBp-_n3kOQ!jXnv?YH{C>rB4I=aa(g+vKptGr zXF^VU!S|40vZ2|$SZ?eR2LdHNRPb<7z97F+fZDnOeyQEfT(Q|4KM<7-)LR!5p)3$Q z;+7Y=fZo(1RN0AEw<|Y5mW!8-*wB{%+D^rzule~V6bZx4F6l`ck2}qx#-KGP6xmHx zEtX*rgBkY^DfMZ>@it_NpL{l-{5GA(^paIoUL)MELdBhx25***;Yfvx&cGvo@hmhD zBuI6LLDZ_7b$bEu<8w%-28Wv%+~Krb1m7G?rC|xoHmBR-C;*@b2}54Az1sC^pfW0v zW}~d~b$KgAGxeGV?bxh3$1Zq%Fxlu`A@MA6y0&9SxB}J>z zdR$KDb7Df$jioDe$NfnefI^gW-QY@0UABYL;JZGGzrL`l3P7?HV=-Nm7I=S!I9sYo z{qMJ%vk7T`#Vn#NeT=_wd@9V@$GKH(x>zg;{W-uW~)+)oL6&OQm zU5jXf7jOEF+sbUtdk2*t*3wul7dWGA_8lW3pO>KU%2v6{`GT_T1?nOA)ARH2g+a<# zEwIk#A_#YVzZJ45!VXWSg_}rB+@C9u)~`J9p}9NlN5&Oo45YlRBCc}t@Pr_Rz;yiB zDa?pUVV&PxX?oUMjRK2jsG0+-77r3<4#Xev?w?Ez<54*&J9$jZmeR$Qk4IY+Hec5q z%FFeGgYtigebdVjMMb%VEyLInB-nkvjWx~L_pp?=rd@zUqc}5{`yGeaku$_Ep{Kx zQ#i%3>7@q2*g=Z`zdNwrlWTcXBAbqV3q;o4@Hiyjas;8BcU%ZPALXHFFdmX*yRwI3 z_D^?xyrDDnV9m?{*-cpQIMm;7-ozu%2>Y%;!NkqE+CEr zfAynE*c4^M!v56+V+zkDbJ2bi{TjI@j1_(OJuv52dV23K9KesW?`lLUo5dXX{fUo~ zHa<7a_2+XAFm=mSs%DK%E%?0B;)pUhTV?VmRF!wgwJv^N)OC$3&~{&=r+Nxi@6Wv< z$sP>`@3n4Zb!<=Ej};%zh*|`Cg~LV%OfA?K{8Gx!rd@oo%+IJI=E^USILMbb7V;7R}N% zZA{Qa{b`Ro*S7j#Uywa6P%71(Nc!?PV41yKnYS!0lBUYMB-U*0oTHK~5wUzeym8M8 z$tXmQgQz^JWXZGJ6tiJ25Y=|k( zSJWq%T0_>~WUMiHHt_J7%qD1@NS+u&BRTjxp(ZJ~@&9aVgUqKD ze`#$S(rPdXhQvpCv0^0w$vS^-s=c1zq4^PTgY;sBCn&hu(Yp@-ZT_Lp`6Q`@<9-Wp zE|2l!H`f@ZVXooxt>!=HfPK~s|M11|#CXxTc8bl((oZ6{OVW{j`=$Pj7^iJvs{X#F z@73)Qsl^jco8AwzE$!CyJQaw<#}w{%3Kgg8Z4AV9exFmP|J;2y`b~El*Dg<* zZM6@}nQj=c1Yx{DdheHk3G9{5nSy}|{{?OK9CuR-6%vy=15*IZ0oZLoLGde4u_BKYYrQLJccOf~W$V^*d{VesklqpZ|8?Sd-Cht2gV$q|6!4zJl2Z9OzLR z-^E8_%nhR=@XyHL)l}4ObAhPXOPtAxRY>FBr&lb8-Qx5Flkosgy6TbRcaFZ#9?46( zQk<&{b{D=XkFub91|33#yZ4H{4wz1d{v}@%v!I3JxwuO{CSb9z^C{~vCVdAL@C7}m z=7uQSKv{|o>Y=<*(orR0-JXqosnqQX>FLb_l3Uw2V@lL3-n8rVQot;?+(zYLOo6P?`sPC>d89j<%@GY!dM_;BOpfz;QE&mBh zbug+dr;90>24SetZyP7n*o!DSP*p+iO&!?q9FcULuGVl0cXfI%Q6cZ{(FmmOHNdxz zQ?XP9H4=^Ol#g zqMJb3!ongPJjAmJ|D~?&uXRfoKKINL7?jK^D6Xf+Z)0?LKD3=Tm#Yg?*`F}voYG?~ zsP$lXC#2bLN&@{({Na|>5A);eTCp^aO=2zlo_Wr((us#e;rnH8jQMI~#ayYXbkh0y z;3CRF;>ybslVmw*lhxkF90&g-=K4;8*r%=OxMbrYj5@Lyd!`@<3%Lf*13FFo22ww` zLx1Hc0&>m;I%jt9T(U)7S3aJew?~r?;<8J+I4_(fm*-ngcc^=#%&4PY>ppkjL*n7% zUWhw6QzQb%f1fgU3DT5|lea+G(-ff23jPoy#dhFg2Y;f6?T5hdf5MuqYg?H8F&FrI zo@CdHfB2ZD=z0cTjeFmhYw>qnFHsb#+NoJ;otyukT9RI6UDXtt!;@>BkWH|($eqUD zU&75~1z->3VqVP}O!MV6J#e*Kpt0FdwW$0gH;N39$|^5pLf~lLhV+GtDKxo`g zn)1U7jDs`9M76i?D(Q=A)>Z_rjtx(OWa<-ae*~K@W!5w<^pw9jM59V&iHe$*Fos>a z9N9pmbGo873noKfR|}^)s0Ab}G=};tTmjKycFLOIkePM5=9m$vD1l~}yVjL~(R-RZ z-8IhDLQlgYozOutjz8!QTGIL<%!@t^tXx%-*2Zf<cROO=2TJdct?m+zk1h4Lb~9eHovd?NQC<Yr5cT3#H1RnSx><}r@R!5(eQm~raiK_rG?2yax>?%W9BB48;=S1_k-(?ug>Wl`X zCFLYv?#~jHmiHs~w>OOl0{mefEr6G$AMcSTg(5+y+jRlxDHwbGNG@<)WWR`Kb^~Eh z)VAG-_zSIDyvG#nI^O8T!ys#5XQI&Ka3=hyf|SE9ks%G0wcRlfA;{+pcLqpkL8QDX zw>9wU69%v&!WxNzEdB$e^-$==_C5a!PO5ZU%)SDGoTaVRi~_HdoGc)=5qifLH5>nJ zX*NpII>+A-yhA#ME=ZLEgB$D4SW51=>F+Jb2@O)l6;@r!jm`hDL3~8`@^~Z+ChZR8 zHT@F7RrOix$rxCEYDu0{8X1_Z#C5{xSHmd26q|)|}6z4^{e<*1YPM2-d7(DB9h!s7o7{6=ALl znY|lMWLAz>=o1f;N5Blx24;a8!qoQ$#2GN!X2PMVcD;_rjmT=-C$WqDR;Rg1W4@Dw zvpr7sT1S>kBIM=V_u`2su>JVhUmOYVL9>Z=)<9t%5M2UMy4Lu>!nWzZ{!#b*!j$KQ z0*qDm?AD*W9@H(n+!ESVQHx7XAJAo<$fE?V*F*RjGfj$nRCtyDQ2{u%t^W$(ra>)U z#4!{5>+^w)AvgEpYa8X~8i_reOL~~x(D9}*N-~s6*6cJTi~%+s>N=?hf|!Q#w#g0nLKW5xf(y|gVB%!G~{qdQ8or#C3|`+AKy_UF*g zhD(7p)8NGS-*tc;fpgn3w}a(RAn%7)uq*jAJ!gb=M#9f7=laP+H@RHLX74B>cJJi| zo5V`UB1rbihi6emDY@fYHElp0E`lOe zcsVHbsAM7kyt?{4fc0LC)lJO*$uP-NFie;A)Y@$iGyaWVRN{;iCySyjeuukD%%FD< zKM6DhFid9$uoBM$92eJ zyIp^wNAq|C4Xy>=C65sx#&?A?v^1L|c3$(Ov_A~4Maa=lA?&N3`N3W;)`b7cEJWhW(P$xZ9|5@Klv zgJJ54;Uw7UNIc+Lx?DCOb%vN(Iu<-QBCBI?rT1Coq@NO}^J-0B)Vu1p7P8&4P5aED zPFdK7wgy`H2D;ux0CE#^ls0CNUc!6VqlNW^l;+Nt7-Z(=g@%}$ulf+ulq$}FykDFH zDG2Rcyk}ZJ*SQDovvI<&(^hZdj$UNSdQu*l&>IRJ9DWSJo?Pkff%EgX$#ajDLo?O8 z>K*g*Ht{+R%dH(~VhwhgwB;uv6{3x9$963%3-$ULq>I^w4xiV4*SvAUj^<%-PZ_Av zEj|?UW|Jf&V z2YvZDURc{XkCkH?O!@V-xKzqwS=zu`4~_5Jg;|(2jA*E`U-Q54z7w_`N`#_)1-l`| zopayaA>&&a>FM=hga8TEQ<7|J*|pp|C1tOf^0e7?)dy1R b;D*|Hiyu(gw(Fl7v z#AV}ktACAu%BYSQo64;jSHWOGp)aie_Nzr5KVcUsR0+|Xz2#&hh4Pg^nnUY8lXnr- zm#8}EJ7OM?rn7Th@SY5v8c@AA>47|*2V=5xy{#nP(8+)iU=`c__UwrpuA%5J(B{C2 zbX$<$Q9EdR?8O5#cQ;!E3k?@G*o=J&urldN&dfE3hZ(H?Nc5c=QS8-#*B(4153<4^ zSn9>pg)69km{+9foSNw4rOdi;p4`$r1G*-7-H=*%;0ACP#fcnMm!in(zrVZ?|FK0` zbU3J%m+iL}7_GnmGXA5Z)Y%zl;ed+p9Q6WRgc=p+ghcVBfWSM@bY=7Mk2^9MuUi^f z=EyzED$T^vx{-QosR8r?i4c9+Wp4U$6XmFDSGVD11*hKAK^?ejDf_xUzM!nG7N4_m z-`FfTK__Jtq`bJmKY;ek>|`Vgo$8z>rYplZ*3WR4@KN@$#?*X&rJ`d_?<%cb=%v^1 zAn@C{$`|EQEMXWGhg#PEwwF(Q6*B@FwS*y zJ(x&M8%sB2t|fSe)G+(yp786HLkW44GVL6GJ(i1jrpci-rtfBX#{{Ux&3d7iO6oH7KWg#tb6^N%eo4Owrkgoc_+KsJY--p z6qlL!krg34ji2wNHO1|CMfJ>ymp=meCGI&Y+?A^u3ZCAaY0*SQC*a2rix6*RPyq7v z0&}g)n2a!ZEQ7i&oZ>CGR-#^*mcG%U7EMB?ygYN@4EkJ>JF7m>Y(~wceSS=s0+pwttLy7krlQF?wt?2DIwqL~jD_T!4$JVT^5cCRkhUX=+E!GP{> z4HJ$R{*_p&p<(~*2dC><#em2flQQ6%M}GbKOFvr=T|hGZn^G(<J#E+(!_^uG>sFR`OaH6XP2? zC}{769xLIi4`XzLdm|^y-simL44++Q%ZPqA(K~Yy+DFC4rd)pkg8x7S&=)7B^EJ8H zBc_0!uajQo_@BJtCn0eS2pBuCM?M?8$tp@h?dH)0F;%S1HJRpdvT)_Ud*ItsQ7y&j zw~xTn+D!XWx`7OI;zY?6yG>1PF7-SO(_^z+;h- z^!2C7%MG6^j?2SEW~}RL2qa*c5NpGEbP$tUpSc+s&#X;4BkDkCq(@H=!qJPX%Kk_a z7r#D^*2inH*Bu0O(rCj=&D^Ql5{5t8>p!phq06N6?-Q@=68#t*H#~Y8`(l+w_{ryJXR*K5j=yyLKX7CMEH4S_40)+9FS0+McybwKgMq7axN;feEIfxLQ+%djbs zYJAyMvg<1#>FJTS;lY#`Eua!>cG^?oC9$G>Nz_gk(mn}E{tns1MN#22WcW$vhV+NZ zIkg6O3Ns@Wv3FZP;2q^;6h){1nl4Qov_NjMZ>C15d-<|QLuNOyhOT3N3=3qul-p68heEE`1>^q=N*ph9CRia)tz}_^dxB3Rn z0wbafzm?Ks7OrZn1sS)weLHJSa51Whb^9$Xf_;SW?y4T|$@0s4NVp9kjfkq>_pENN(%GFqP`;2#uj_w$Zdh2Ii@cr14 z&j_RT3hsP-HDsRj-mAu^{?&kxG~qKHJox_a z7J}t3a~v($#39sPHiFrw?4r)ErA$-`c=kd<`YES;aOR5cf@7#92EN!n4GAd77E~FR z>r|3uNQ_|3VV^uSj`F$6J($HlJ^68ifkv%5s=Sg*!7IYf1LsWr)KX~oSV>7-> zajbMO7TZ6cA_*3O(<1RK)LGWofa3aawv4(Es+0vSfAE7v(U!|1k>_hn5y#SnVi$rm z&dslLp#ADaymCLQjK$C=MLl@*Gj7uz(uUSpwIhUp4{gFi_{+sHOk4>0#)bip*jZf- z0iS*u%@IepM$17% z?ufqVAG&M!Th_ed6Pa9XBqyYn_Bvg#BA)m5^7NVZ)ed*(AGK69r(;Ca*q>=%4)rUQ;x=RV2_th)RzWL$Gc`#`;V;uRCtqx31SM~ zs9a4{4bwPhm1N53(Pzo)PNzejT_f;ZL8nE|N{d%U-gRc>DoF@@goT(AqtnsEU7~y< z8x>JOv#e((oTy;|5zM3senx>zS?qXUy)6g`3XP+gbDfe+y_M(6^&_XP+p;5tzd@Bh z@A!_o_)M0oi~w^Kx10Hc9cM*c$h(5BN(0ZDdBkT1U%f5E-;=1`ou!(y3|ItdzI|I( zu}I%=O!lFldq`@+lfGP-UwOn5VR|8&Y)n3K#qydj>>I8BglZj42f)YaQGwqXfB$1V z9010|B{%3t_&s#cZ@+Ro$T= zq(Fi5o^#iWM0qUEq+V9C`0Tv;+LGA$?8dqznn3NpVf(=mqoBoQ2k;Cj+MH)jdr%vx ziQW28i8iF11?BaIhdF>Q3Tlj&GXK0)ltvy*SWolHp>H?qg;%WL#9ENen{%h)^H&5!^sK~ zo9>s;8;B-pSDuaRj9I^D^j_x?+xh3pFGdPV*SG1a1k||i)&tb%v6@^j89Jr;q&iiRM(WJBGHj`}SZ+5gTe_m8Alx z>hwjy<{R{nY^;L8VC2C@IZ`l0N%l;5g`ms>t)EYJ{$PX)y=s!E3-lA0O{)jqk`zgn za{gBQz;&H5W+R$Bju#_bTYu!uuCxRr`1Lu_2=ie-?Y0mV583Y|BTXsXht2jlS)mN6 zU}9k4o>PQuhrk3qNlGF#rKY{XLT(f%CeZI6#kVM!s~z=q)uOCNZ06~O)9EjeB|u`W zDMs;dT+&`$aanT|6U0?QX^5#wCwfZ?4NzW;QY7)a`9xkHZMY4NOzuVy=Z#wnbfl0n)pAKf(n7NhAed2-iLE^I#%MEFgC@! z!E{rHT-1jrs7R)rCFI`Y1QT|By2{<}O1FX6i@;*FH17OP_L9P)wz};^6d883my=oi zYce;ggK&$)ZgBF2SOF_Y(^LtV+#D-~S2o5OG|o;SaACsg#);lD`L6{hebZKVQesu3 zF3jlCc)9*kqdvGhQRmpmCBoQqX^?yF@$ddhInI~U1;aL?OzK)x58+sqH4NN#8yhyDL?1X4B2*hA%v~SP~NQ{{j5PIOnB}J*Ww%3 z{5o$GLVT=Q!fm4n;YqdHzSc7=ld{+1bnQcAn|+$&`VE%~iBQrjQI6ogDVfqjWe z!?9uXEi$(E<;YwH2>}@q*AbXHqMwFi=TA-Lkydk}J*{|!8ck*%KB@F(9N{k&Hb@v6JV5ct@$}?(B=HXcInrrnOb9J>~HBRtF@oNb|>u@T=(ls z+(CnKi%Zz(fb)13YIfYf0fEvw{9md*)IH`*DzrOqoQO5w+z1b;)_GW&k7IX!b+{eoxxPOr{_)%S8z zaTFoCDE)Iw$V*`*sXMqISY>6*M_B1uGLS)Jrydabr^p@ph@e_!3fE6UMtPRzmd z$9u8XoEfo&M7W`x-dN~^IkRX}7n0c7pO2~@(QAvcE|v4)69v(+=XYnLq(?{~@)=OB z4XYXJ%iA7~N{Tt|AgY>@dSLdv*y+NIxXN%aN^AXal8G;<+t>20Qa^ZLWJzsB4XDG- zXUFr6pdG;>QumYba>H7Ek7#G)Z$c3NNEa}%Fa(oi2bO+`Y{GKzo-S=jZ1C$f5HTqi zJYFdBOBh^eHj#QO;+G_ME%@i|{s+Q)CEMDPV1+Y}rJ+yoyMN~jIW2`+cw?6Rw5cDJ zc(6;-t(4ImZs~mgY0e9ZrWugR@7UkjCrB`?8l)wajdrg30KEF<>eAiidm|d?{?T3i zOunUtFSg5q?@ggY0c?#F_#7R{01guf8Jz1|Qqmb_aS|?dsBG*TgHITX)8m~b7d-9i z%??X4hD|30Pmf*~#j(Ndq)Ibm1svXwy4RG;s`-F-XG zdA4goAUfxB7X%TAp(L>9ikaUouZ*?+=(rLQmp>l)&{n$1k2!-3Q)jqSOm0-fvyyrS zS^2&cj=!v-LB)A{JM?yd$jIH&W zP1)incblU=Q@6!#)vsw5lJnurugkia#GD?lfO>c*-DNwq&(Gr^PAJGt^67Ru;WStt zYo-kJaCmZ%pg^rD!o8K`#9`^=R7!jYjdRMHh@Nsupt0RjJHX`cnHrMSn@udJT{rM! z62!}oH*fUBp}-!z`_mbBr~cLTlQ!Dmtax?pd{L%`Sasnz-E+lQVLJ)=$g^RWA0NrX zO3#{I4U{R`)R`M@;l^WjeciJ78;C_LztWp-nkxh+cJtFRVA5>Wf;g0@6UR9M#A;S8 z9TvxH{qP)&y1wb&G}V2VF?qU7B%wdSblMt1hbvbm-&aSwA(DfGQrLHI|3ngss5nN| zq;b5&DVd`~zt(ATchy!L71nSjRe_#B4sw*}y=gQTud8 zd|1!2!k}Gbo3mXnYY4jFUX+%y6|ZB4RM?00@1Q3V4n(%Z(}nu5Stg-BW(4(Am9XPK z=bIa=B(TgqW#(>Go;LM<)ugWtehdZoz#Cd+?CpG9w=ODHt9s(ZgUH{2IoIoggZ}9& z(VDfs_*vY&rH7PlOY&cbjec=-s?f!v(PfZ0xpe$9(v3}jm}Nu-ubLgS*zTkc#ul^zLHi&N=dMP5{Zx z|K5|0zDiIc`?bMz%e8?4zt2=k`G!N+`KE`_OOI*egu;0Y88e`N68>&bY6L3LcO_)Z5$Ett@#c$1dDuCB0q_DSL~F^4upjd z7hi^N;hlr);t<@>d$_4-2S3-SKmbWzOeJ}FEy{)8nWYd#$#zP&NPV!CAQ!PdNgrLOP~5YD;j8iOa- zHWmz5C&EWrqC$&arE-T0y><$Q#_9Fe@Ua<%L!nkYmEg+PQndj?Sx`Dgnp#3-M7=CX zGgc5yy*^D5e8R6Id$Y>OKZ^F;uhuwPJ00>Zwu<&~K_^R`lmx=jwrA)jeLmyV-bBC2jwjW)uqr#h<$?8Sg z>4B8%d>@^vHQ68SjzWQl%em^pf|u4Vk5pS_(BUIU-_bGO;f1ww8=%$he``n6i}3II zkOW_!_H$#p?^_AKW!J6PLfX*g*cHtHPpf<0nIY>sga1sGtxF5cc2GR2edC+EY|(ya ziTTBNqDlG~if+b04oUD-MrA|ME5-QK=&VyoN>6`2L;h8(7G&@tl6Z&Fy17PvzzL-u z0wSVk9vDI-grE$5xG4q0);LDabg=5a_+_hJ|KLUVT_OEVKrWY8)u7wPy}I8b$_Ekt zW-DkrR$FSOKh97}q{f?wqY~j=ql7U^ukPcmfwZkaPFWZ~1*$%ild=_oSN7p*r3Lz5 z0m=lSzyuU}rA`fs5wtG1_o4s(bF$-+p`kc~P~qlUdB>7t7_YhBn}XP}#OnY=REt$W zq`l}9wcw@&9sVd`c5?k)9P+B!lWJPD9Vvy|qzbVp9xE;MM+9RAS#a~$jie7)8ZNHC z-DiLC5^Gz(CwA;aK0s3Gsq)arzj=X20A&{bne50)&i6xv2k`V^!oXe)Oj)7Sze)itd;_!tlaOop?)8KC9sU{X5?AQxr|3 z?w3W7ca#S7V=hO;g0}jq?N-g(tBE`WXN45kBiUj@7KwD@@jO%P}zqBRKfG<4mF!mM+Ef!OzZ{&i>?&^%*z71JZ3=c0Y^gBJb$?CsZ16% z`8D}Tlm}0;`%hfC?`Mt(8(DB28GnL<1t(hzlQ*qHO;bI1sAAkCF}LK)S^q}Ip^TYV zTNxjn4rJuO8xf0~E;x&yy5XdRF?g~-p#;6eVlu|%9B8*F$r)4fh+swum$7FqNP>z0 zM0ahD^5-vswI@5JG zc$}GuTmv$_ZyPOD-&x_VcOML!9jLZlqMHHLxl?9yWwP1uU<_5F6BLJ38I3HUv`_DA zWF);$EN^0BV(&{inI1@!?X<#x*4SA{trfd^mrrD7a~OikcztE>coaGoqVvM5;H~I2 zH6jRpC^|L_@qj|4qWj?WzXoAi#rJP}L01v&TjyT`Q)9l^-A*=E{+YXMtke%%guWZ| zA1COF8HnX>2<%AgN!D0K1QcAwq4*y22EqAn?Aok^k-`L6mTwb>?!XGOr3C zu_(&+yB|g<0#(%bOG|_Pu~>mLQ@|Q{y#ewEG{yk^Bd?d@jPiQM6d@5!U=DD*49|l= zfRz=2k(pWflLV;f^3wHSzLx%YE6ruO^-Df`)%U;=Gaoxs-foE5Z!B{Dul*xBCj6bC z-{7^ePT*;{rk>Je1e|37F&gi*h->QpsljYSl*1w`ZgX1YUZ~TR-T^1-Mkr@ZB820G+cc>O22Z7t?S6Q7 zkm7Vy8+DGP@59fhj$!`O<7dam*liNu)n=2I$YDs1)=26eHgSX!$blhw3Cy3#dmA*Y zVWI4y!-=Rtt?ntc&`PKh7%OF8Bi5m$9IChgP1?sFylYq>4e0I*Jv0De#+(5jd`DkbM5LwK&gog8#n_1o4klrWuf4u#c_Jjqj$d|^b2^oXO_}6PYR7>!* zKER%t{t|Adj>xh0_WyQqdpM6%DRA4JOHb_12iV{y_yq_L{O=kRI{=zL{PEX4_9uG12d8AG0eWU z3?L^iK~SOR)(;#0fZEiFGQrJJSkZ3A##z25*Z8(2h2>Ohb-E4yL_#w8B|t%}AUr|~5g-UQuO3kJ9eiefT@nv*j^_Q& z8!h_$hQ5hboHnfoF`xV_;>3j&8K$zBA|fK9L5YRIfQW(xK^+7zK~wVOo$c*OwvWe2 zNlCBWmj$AAr(cqB*g}W1zR4w~Nedj-5tn3(KU%64yE&F1k0QaQUSZliW=(IA;Jz_l z>KD0`oE;vu4XF5y@K!Qe_006cOxq{nF1hyap%KkK?HzaK`WE$^Y%(B%a?@y1-h@!5 z7cP2qR`gpw+dsZ>D2Z!WgwGZM1N9sZh~Ph950u&|dFg)HUFs*m1yWOtp)^w`RQB@& zYiVe_O-;2fd6$lTxo58C7*Mkshtq|2_6o_S%q&gIBMY%rCsS4*?tlqH=lQhg9*SL< zSsYVo&dMe}bmFan+8TqL5Sy9HN0vInC{e=I{xixlx69R1yF(t7KpVerd{>^AX zNeSBdx;T?m1^Ic`hYwg;mnk`wxx`F@0d{G1&=CWGl7eoA!|q=2{=L4-!2+ucvEIzi z3NZ@@SD`VgW@-BxC1Q~@iqZ-p>7JrYH<*xcZLsTM*c*6HZ>UiZPX1v4DXoD|DW$b? zST=eOcGr2?%EiR9ltC}MHxXsx$@aGLBkGG{RKEw@7c^Xldz+j6 zwfk>DJ?ojdswEuiYM3x&9+@N4!T666(HOOr5tN##5{*I5&EmxSl8_e~-7$|WT5XKGSn_Ix`^nKL7YUhKx@V!f77mU12zDgWP z!eqzZUX*CVgzA+f&;8I|pcklH!D_yT`Y?T!wE2?yk;GSBM1@O&Uu*Nc^YRjaI$&@0*)Mv<_eLVkahj9ga?yB{4S5KYJI=%ptr2Y}R%)=&d{*5X zPw>kjmA|i{$x%#KooIfY^dlz(1zylceX#nu$`7fJS~WwZQ25t18s;B-9p2yo4I4B* z6|A(sB4Oxv$|#V!E5A&EtZ#3#DkXBRU05;sJDCEMQwNDC%0Y=M_C$quS~{-DY(F9k z)GNpY8xV6!6Qrb`+5`P=okac-S3_}>U(U=+SK*(h{B@nB2OxU1oDSM!%UCy)ae}wE ziiv6<655YC$OuG^c34+tnO}_!H}RO zHQw}zkmz8Qq50^5L>r1OF$CZGyYR_X(mawl@8|EOGLv*0EyGw22U%4INz2`=Vs*cL z)5184F`CMggyi}@XrTYV>Yq&epoq6@+!AVI?Q*OvZY*~pZfg%`_`g(UQ=P9^2VE9V zIZ&r{FxhHR4LP?ZA7qZ!f7WVY6q!Z52%yESSMKJx#zlb>(&C|aX584#K*}aE#q7n! z@Oe5OPTGRKRI@ZliPs!2_a=>E&#LZS3m0{p;R7ATwlt9&!RLHadxiwxlRc69XYxNG zF(DcZQ`pt;V`Q5sg2oXGfD*-A>+P52Y@M))wu;_gtT_{C99rtcv)nU3=>4>tx#pd2DDkiLU;bMRaAWC!315IEif`u=|UletNuyJasc2EK?A zZ|@0~osR6@FH8L>Kd7~%og`yXRfsI_l2U#oEXy;q^0yM)p}h8bJ(zyQ#Qq~< z&uBpM2e-uzhYzVIGQ*Hv$(Il>#&m~YE1Ji3P5)VHMaB;^oWpPPL7YX->AoChIE=X7 ze-hM>adr9??uMR9Tv%D%vMNo0OjtN6#!tNhgQ*Y-x{7(8&99gj;tRW+_NGnWW9swE>rC24_WO+H&a;~r4(Xx+bY(p}?HXeq5feGs?4-~Zw9g1{TVu(iu6f{Q}0qJcWRKD(IecoI5{ z)_>ukqms+JJUoKhB4cOIhM7ccsj0Il`9qXOR$emv^$J}=4&~5+e?Z3fD1(=Nod%D% zKrvjFGV|qAqqHWNiSZg@kJB>Y7dkHoj+AIHtwr@G_D0*e(-<)>!}kWYA$6mA3tC58 zD~4^YuMqZHsNs08@B*yT57|OnF%rZ)`T%f7jYsdGLiUXORRpCYhwPa%-}RJj4D)#9 zo}A@}$vhAX?`;5>u*Z}Uk{Z_+MdIg+!6lmGc|iCB;i?IKFl)bGY~q(&P{2SgU`A*^ zVzlNo(l1N)=Rt4ySiAj$tV4 z81NhA%^uE8!+3S4a{Le}1+$1Cb;Uvr=D>oxjvWjBd%;qn!|MH-xgI;Dr(P@{6c+JB zHD?0Gb=_Wm{)csv^<^y)lffoIA1R>;j1zx{s~)13mXD~-ZdVVFq4Kr?3@9`CibCW< zCn#Yeu#~zceD6Q)wR)OIbZwk%A8__>FrT1qT^~p<@h;}VrkDT{6s4?y z1+BUPmG-DxmPdmk0sw8YuFCyj0DG5O3PeCGWjnKpxR-j?Xca5Ud?;0!2p^Fdpf?;ZO^3 zlt)THjnAD*=7UT}0kc7ROmRUS!tyd94OKoU5nUm*1G*0Y5gW|!YDbb=(breXZJJ8;Ea+5VX@qh@a(o630(imzm+kt$d;y*|h* zNlS`UH~EPfDrk-JZLn@e&4mN9*k^_lmNXx<5Ed%8q|10MO-Q}gFOp3eL(+3~FH1## z4IKzX2H09p@}9^cm-FUoan&iYKrSe}2LX!Xe_3m^iVW%pE;Qv4SOuiK>T?k-+}hpE zAw+{Os~AgNc(U9!EphXkK3X3@357YK0JVWf=0mrLq|*ix;PZz9b+SF!P`ICdBXX$*zh;+^x;}LDGd*e5zU%RE8hwUUz@6)Ra<;;ep1GIQtoV=masZU zVq4d3E2X-*M2rrrnvD?W>_!_>+R1H!+NhJMpr7-Bn1#Dbn!DrjrKOeCD~MNcZ+;Il ztxN;bnhCq`vG9L3tu(epUu8e_pO>G%s*f+!TO$lq2txNm!OKggg59`Ug% zlte9cb!j|2JbuSDX*O2YT%Z#O(1KZweXnK-si-*p2SXpbb;!FAr8hqVZLoY8jC29@ zYD!%WYm{&R#{QA3n`bs-ufD#Xm780Q+NL4~Qr{o$Fsk0pxpX}lAjfP2d8VFebTRxP zoc@ko=W}6R9zHprGpO-XqBOH=(R6Ec+ug1QdGZWUQ#wESmD2th_zvkI)iQM?-eY!Est_uYrgjQ8j{*I| zzntJjrhA*~NObmo&`sf?T|}e7?4*sC3f0w4!kjPxw*N{vbVdM#j1@UCXh`A;(KCKQ`6vDVj?1WAat4p z4uFIwMuhs1yuTAd0ym+kuD}^nh2|z_y*Dh9K0ssZsqdzq>mr6`B#HoKmx%GRgK=?tB=j zzj-g~7q)Hyu( z9B8W8E^A8_F&FffMMJm$BIS1>&$w}dy13k)j7hYR{H8WN5TINGqU@e7o|y7J?U=x1 zl;`(6w{TV{DEL6hS#K>Hnda+Q_TysO|fhm ziCpc$XifF)Ts~vY5PG9o)uPs1kZ>hU=LS8nY;W-%Oc!$lr_7{G!cB?N=#+a9MFn;j zfK%I|!F>%tCPKP(Nxz+W^r94LQH-P+dHRmqU&bJ)T*qnx8+%j~7FY?b7ZDO@g3Oe| zRP*Y3WNb_uI{f5dUq^q;YV@#QoIS-|aqV?j*?ev`tj%vdPU%;jxlN*g<|(xi!SK>Jso$~H4KewXkHB_z<*F^)ZJHd(&Y99Bvf zr^l(XLI1;825*4ExgR7!=iuWM)NeV2vF8b-q8MBJQKK)?w{$5hzY4`~RvNcoG1P-@>MoKo|6mXEp*?_AzGJXPCuuG^mp&!0N! z?j2B{s+mmoexod*l>V!-!RK_B2L2FL)cKgm@jyA>94UA%x$9id$|0Vxv0*smek|%* zR3*WGz2ZglmwM!3O%(Wr6T0{8$AZRrxe*?2KcOUzgHrPb|J4r$U4D%mRT5`?n*0_+ zwC@S~ZxIBAdZa(4s=cU5ijP;)^ynwutjcQ-WMkuk^f~hfaY3e_8aV%|hQGjOwx=oF zq_-|4d;X8OW|{~g((C`~CIs<5so9aG7~XE3$$`cxt=tj#G`YResa{1+#l4D}dt=DTsVf|b3{JrtW8YoG!NOo3fJ9)R{DxYu@Nf{jIGx!@ z$z}ESwd_Nd?>X1OLVms_NH6RxHQKa{EW%wz>+HKU=imxGAr6$4MV-JaZdMs}$8+WZ z{XHs>v11Ds4!q46;m$erzYX|RWiX=p_8)I74h3sZ8804h@rSsY!J=%e8(nX_K+h@g zyywrEJXbS*XjjXY{JTLeCl~gjxYL(Fq)0rYiCS2BP?bbuP_UMeh}yzBlH#U@sLMwg zb9c;=cpuGK=@*ar8_iXoiv zDrss>-igY_kS($n2Tp?qTsTrP(1k+%Drr>0QXGVO{j;eu9Vz5wpiWhb-iI z?s~A=%#9=bX=)%MRVNZBgs$;iJajrh_~gxM;*4l(!zAWRXE)Y#)}!M74n_4^TssvZ z2>~6>aPsj3*^!Y9yUwR=o>sIpzg=Okr$TpDW}(=CiDd-pKVpKx2OVvD?2AnopvUdh z2b-VJlTqqg#CYd4rgP7(JHN)@jYsaVLn2}#Ol8ZhS6@yC&T>cJcHDH|6rm578xpDE z^qa$x$ejGKx$(5ci6Z702+CVa%sHU2V+^a*b29$pmBuh#i@D)QW}crZFY|klq~$MA z%dA4bM_>KuLTUY)SlxV~Y#%=w0=tlvqc3qkm25WaK*CERI=Dm^b zJP5Yad8upa@sA&Qep;8^Srl@yJM~R>ReIW5VidCPd-vP*kpB+yuu(66DS66gI;GW` z*^Pa@+HNZFZu3zwhMHa4=0tg7a{M^`w%vc-B|60yZUumL#K>X%31CgUjw^repRKba zd!4Hi?{tj>#)(v{Z2vWmJ})aS3038`&jh*d!Tm(N7*a7XoME#Z`Qw@1KaZQ${)yY^ z{sv0*VTOLIyR~TN1|;K_mX_x+W5dIE%qZ)pL(QMYI1qKdwS75O?QDl?cgr%7PLt*v z*p#Bc$n!pwff66(CO*KmQYwUd&TGhq?^6Dx@`vjT**?CV_OzuH8POW^RY0 zTLZ;Q4%7A=H7!=N{;7aHxis-nT1g3S!VuRVYDS%*?xt{8WbxF4bGzp5=K%EDMMmwY z0De@+kCBn>Q@t11IMxGpTaElyf2n4&GdF*oE#^hBe*~#~e%wVS?}Z@eATM=qNg(94 zx*jq@P)*(TM__W?W-o;8(dG?3#xg`SwTQOA~?!t_MSL z+kL&=9KWt&nAWQn7Y{Xd%eG9R)P^-43jQqnES0yMKKEwcOJ6?#%Gl0KK!7@(!!S+) zWl7+meFfsS`i_Y=jSuyYE{@xw5b1$Keub$v9ZvIioj2#0{tL5#sLyC4ne zgc$-kBUZ zdv&yuRa6IhZQ)V!7r5|R*tz!HfjH}wufPhd>|!aQhNav6E?A<3*OK>_gLcsU#%Dhj zDb6KnzT##0M{VayI#0CCrH<2@Qc$8szx~X5F_#rSCVY|*j?@$`L!h%iB7%b?iwi(< z2>^`=?l_mSz{Tj7Tw-{`rzN-h+f5us$`=>3qyV$TOJic?k%b|b;_65$80F@8N5c#U zq;fizO%Jsl7+shJX)d{C27meSL)3oQMAYvn?pOZN3$Al_>{NXOFISW_I=w5euex zhYSyjFNX_qq>Lsg!kuyT){J7&rmv95`EyQ=N4}iub+82@%fI}7tqKZL5)8_{5*Lp$ zrGKpjkO7RwzE~+?vNpaeZE8}SVo?nAAr&?QN)bsXU?|^KX}1KljF#E-P+MMKQExQ| z5Frp8+f}IdD!jSMe}@i}Eri(S2;%_|?tWN9$>4Q%`19O*na;tm;=L{X#VW;zN zz~7@}_O0$`-?mxq+#_r&>QZr|iiPjl5zu^buCxkdZFERPL-rO(iAVq4K%7i_?4`O^*) zR`Ur&@Tg0U1DAy2~L)2>}6-j-e6h79^!hkQqus>5}g5 zE@3EuG-;t>86QE zy5WUh(nfaZBtab(`6rp@f^E5`@Qhq8&YNZrm21!k>>vRKCe8AbO*$7#M@O z6IIc6C6A4`(LJsI^H_dUH^3VU!Qj}s4OL!~rki-q^(a}|m;u5*8*cG*Ki;7Gbli@i zr1uvk)x*&bZvjn1lGlXWNTc>q^2$NBjk~c1sEtXnJV8NQA5zV^Hsxeb~p>YG9FZJA#mYK25mI%wRV>|nNqB#Cn?;9$Y?^_4R0 z&PQ9bG?Y#ReDXGfe1n;i4fjU-+9yu>d~*Vhi&Noo>LI@n%_1;7=vfovT;R+fduwsL&Bl)~A`Qa5jZsWJ?af z{HS8R_i;vvFxb{%Zyl}Vo}87uT5olDY&pA}?Q;E_v|JU3_=BO*Ou9qcS5I|cauWqd z9Z99vQSV=K8Xr|7`|Tct@o4VCIY<(nDp$@-4V-60Y5#QZR+0C)T>VmX9;PKy=~`8F zY*iX&tqMwQy0>uWrAmBj4{7pNcv4QsU3(7%xl?xk^(uy`t;@J;P3Gy77A%vhoGogb zews&)(~6k#pPP=?1XD6fw|(D;?E2E@vzHc=iiGG%t-@T87f^J+VEE%`-b%%} z$F7*fEMTsCp6B)VI=MM)&zUgWsc9OGT(CHfITU-6FZ=60O}e4WRO6+Hh8dj>as z5h4ASbW)Xog$xTddOyp4@w?^(h@xtRqzmX!R4`ew|7ByM+hp?fOK)EbP{ASL%;#Cw zun|weXvcYPg^<&cB>&%IL{U-pGj4pvC|nzlUn_Fg9hE{^o}=LNpR>oLP~2zwms-r< zsbQUa8>&hfEz(oZ6;*m465q53<*&LAtLJa%Y=B|BIlk{H!z#A*pscRdZwc5ubik9y>pJPC5^brJ#TOUDJCl zVRL8*gP1+fCR0=owmWrYeiF|>y+jO3e5 zFme6EWCyPAef-(P`u`T98- ziRY_oFMSbKv)yTt3y*)(B?LX|7)IwMAdsxwozY|}!jn!0 zRPHT{u3yBrN0*X+9+$o%9Qb6!;r6v}G5OVFsz+Wm100)o4|tylSH5~E#J9Z=pN7^> z84vP)2i_qG?y}K+Y-ux3e^9p46H_h%Znr4y^*rT*@$M## zYPaPv{Pq%vuJAfm|8S}B0208W$Sb+RITOr!x$6{PE6^MVnS_H!KD=?CDbq34|M(|) zQfNcptyt2ZOUnWE=TX`YNa}#KPCklODDG`nj(I8n$>krbqbi$j+gMwLp6jh7< zxT8(%1XUb+?t883CyOvX4E{{4`BRFcgRThn-V2mGFf~ngspMhmGE5&yE6R$g)KaWf z))gE1I!3iyy=)Va=d$J-3fUYK6*t~F6~i61@yn1=qCeTDC9+MqF8zLlp)B}k5LH-k z#w`d`TBfArkFE(MqOp)@mh^jQvlftfS>M@~VkT|rX|GSM;>V9C<6_$yu}PB-i0Myk zZ14m?G6%}`hyfjM^JH9yvHT1nY_lu_GOg+VK^9A-Cnahuz0XuEQKfG8;YxF!tGd{$ zUv&A{p2FyOwOHt9LJ1U$V!H9o!Reh!GhU9oqZKRSH<*O9<%xm|QCyPo1IbLqFV2Yu zou%qVQ65hAiZ?ur5b^Yil607ZmEy#gsch&^x3$m6^F!~L4lI0+ZB z?azX#;$%Wfdd3A)2VE)+c|Fbv!P%G_ask=W78A$gJ7P9+1Qq38mm?lVxC&SW3i4^Y z8o(1HZl9RxV-|u1;n9ary4D$4XyaVw6_Y<6+cmC|IYVp2BPicK+01(J$uD5ul6o}n zC7#i7tU2ZEomcmlTei$b)UOWGOU?(!&qVtS{Sx2NjPZRRqBj@kbfo^)P)?KjNc{MU zAx|d7C{Mr1itw53IlPGW-in@Rvwekr2!(A>u_T@5kMaoggNP$7NBmeXEmqI$~3@1 zc*mK)2|#!)>!u&^#>oi_YI1L*~tYPykWQ4T(+B z*Yc_!?Y0UD(~$rgk-mXr*L%hjF`ZqY0<#bboXAWq#hA^ycf#j7)sHbC9)I zUPaQq57HTN@5e4S%u9-7O_dU2%pVs^`fx>$qk|T#3%S~3Cf+9Ulk-tUTC}XPb>FWd zpw}_|7Q^{_GbAuJ$%HX?Vs@{yTiRD{Mn6@Yu_eAdI;e%MkG2?;xGF@L9T%CzUF;DP zNsNMN<~PxkXMw}C8S_#7CiNzqKi`aKx5>~yeR}Dr+WRd8Nyt)G?h&CI6D$imUNY zN=1?z0J9~OyGkWGqo<+X$t!WGq?MRfiNqR7(BIDX6t8vb8Wv0Ez(Q*m`MdJ`r04LQ zDTnRQxngQFs*oY)x>p4+^Vy@BHpljuc;uD@UkjI85e81}F_{e0L(e?PV%TQ(Iv0=k zu(fw&li;EKP(*!wy-?u2ly<65 zUkq0|zHa%XPYQ~AvYbSU%62Jn4*EW^IhPj>MI>{{XepeO!<)aWzAVX)?9u0UjDot! zpoUu`cNdlW@;nJs#NA{XwT&AAtE?_qJKgjn|C1aq!b1S zyQo>Fsw1A4(vb7^dmt(B<5nUI1}q^2Kiy4NZ8ez#%f>4hsv=ySy3b?38py7)x5e8e zL9QSVxk6zJzMkcH%Vl#O&AY~6d#)Z|xjlT5s=rQLi{nWf2T2Ziii-})e_m<)&~~yY z8H2P!vB7@MTrvcLCVS;1>ieszbGbkzHKjvosnxU51CdPhoAt{UPU2XueB*@@uSxsj zwcl|sh5XsG{Vflj3PYPe)B-P~&+sYcFOC92SQ<0 zUFr?0LTR~9SexuJNlvly*$=gj#U7vT=~8e>*1qMvCye{(+x#BWL^a7zz>lc`X$hYI<$1J@ymZ8zbZ-3j7y3Q)8zO9MJCU0hwQprGwQ@SyG%j)A zA5R9j9s;oa2NBl-f^PmVVk`h!5)Gt%_dCk5hz7nS)g&Q~;pE{-cu(_4Uxi{EHzGWI zed@VM{TGRo&nypL48(677T}52S`F8HS##}+Vn}NDyPV%tC*7FY6_7#6y`vnnP4DWG zdQG=r2Ly{MGO<-Ej~<5XivwKL4Muew<6HNb5m*Iv7kckYYGHtX`%H=qmId?jVk9T5 zS}#~-s+m-YfeG@r=2Fiz`Oo66!XColouf?hcF7>cB0XmAUO(X`X+oG}Ee;`pRgjVM zFn!77o>_E?_BN))xe<2v)a&z)_P>5yVAfAE zbO~#_zStceW24T9N5>qzw2 z)&vf})lE_73Tk1Hv2u#M8!6F@#+tyBNdhT>sAW(ka6|%f39tILno;;MIyBoj44$uK_Zpk7Y)!=kNB{J_7k31{G~5O3lAFQujrS zyMH+CW;){hu$1fmLMI@?3rIK`qYnn2JbvFP;oD!^-*0-p)C8;rf!-+WV7v zyGp&DjmXCba8oHPoNb@blc5j%eQ4}rAK)Z40if=fzc%(E_Y%`;r zY50@|>6{0pSvaDwVOq(?^dYOQi<{FB9m%Ex!xG$Ub3&zTQedrZg0Cyq^HY*|SS9!} zO1uAr0LR^B984vir{?Q9@{vsjHEl&0%KPH=_+EA?s<^Z>x0Eol!q)#K0qOW62riNN zh4~TQJ#ILTc-|0`ZJ>bIBo@Z4R^Ti?!l^%y-^f4^5ek=uA}TO?GsItW2L#WTMCPrh zf9Rr^YtsVE!h_6nvKn4fF4wNZdiiRw{=vz|G{4~{@I+5PspVQ@>i0_j--I8vs;ipa zDU1Y+td?9e5u*M%{MJ$T>Jk&kip(S{=G0l#Qt<$nK$~%i?3ey9eS7Ylv_3&A5aJiA z=LtN~f<{Mf0zOg&xS#_3UWP76;|xbph)EDvAtKN@z-|xuX60McvJB5CzzaI0on2Bg zpm_vR)dgvI4W~;(HDI7PyYc0nHRHvWkh=$O0{DE4_;D8zvPyKO_RDD0F#Fw?@&*+B zD+q>pgN~2REI^;M<-y!B4#lo^vNbmihBS{G`;IchN#QDSdbNi$zEfdPMCy8Thgdnf zu1F9*+^)v1=7>=+t~orRV>+PSCkWQ!ew((C1N4Xd)-Bj9Js;>?dqX8r^|o2f<+uUt z?oLo+kvYPr`wSLnb{?I?7A*SKsQ9ZSH!o)uO}MwHcexhL&ij^8-TZY~$UT^ou6MQn z3hm{p2pLwv=gGUlMl<=N?t(o!cj-h~DU7|c9h?C6pm9K8$W<2Kh{82>MR3NM82x^W z-B=on|MBC6oOeKGc_JsYPe!b7Jh7DdtMq%?#L-Y|OL2QWt|9S|jYk%D5nIavfJ)Iv z%eT$bzbAKEJu6);yL#~Q{BPP_q{U)2Gmfr(AYRI2U)X+-o(A1Ce+usF-LD z92>4eKBQbO=f4Sw@aT1|x`T)*rn4u%x%%gm4mlap!Hyhz+1FPbAGLQQjo?k)u2;@YkO)E%!j8-bb;1D>UDaxVMU?2(9U-mq#= z!8uu&2z*5*QqjV%{tdym>4AQ&XPQP@TxUL;_#P9#cMdFmoV+YCO3(OJ>QlV!_4ac7`Gu>E-O@K7;zgHEE7N?wJ+8`hf$}pW5faU+|9P>$qUa7O3$0!&o8$p z9X_3OQ7tH8gOx*sST}?Nei)fWX5b071T`lu-qF&~$XJpY8i&!ekr+MvI%7epYNMRU zU46%x>z}I;S_s`GJ_`2m<2*nDgRcp@6(?)eLlu#fEoo4^#SOXv zs8$6q<5~d#HN(!;6&M8w1cHsIs_SF@tUw^^L#N4idO}BoY2?qwC zkI)7(g4;fgyraP`8IKXSVX@FArk{k>bn^S^URc+qo~^7=bY)yRr}m1>%4~tvd_U^n z_c)yl{R&oqK-0PkdSDK4JS()@^Q_lF^)ssov>Y!oq0q!-UA49Rf^2+!j?4`*Ni}<) zm~Ef5nHP|9nYs{SRic7tF5(a-x?nBK+!Zh&owUe^BtuBN`^=+xNCcCjrrntXi4>uv z-ELEjpsfddZ;m5$A|r~Nr6(sL>@swje&>1-x_?fRI>`2Fc}g#UmHnq9@qsTG8SVId z4UdvYaLY~@cl|zhHaqSY3p zN)o?OwmT~zb>yAe!hDo_L~U9EgGIS`D`3bnDK|>rlZ&*nST9yKe)=XuywC0fed+}7 zGd&nb^?+($lHpzRV4~!PWDI360e;s2NKQ;{<+O(>8szv{^96;_*Hzb zg^~ebx+lt;bAXFpFIdmM2PG~6D9kwyh2*BYKTn6-1ocDMkwmH+ z1fnrzm@>)ti=Q5b)*~$ERs2uW&)_Te6PKLA;d=XdrZH@)Uet4N7arifZYu!svhwum z`LhtefWFkm?IouLgX(OcU)&;gPUAZXwC44l%MQHVmVdNR{B^2NR)+1yw;Mzcw;j1_* z;i?{tC@uk1R9DNMwXM1Dea8F3o}BuPa!y;g!D>+J`r1gSmokQ@u?R(q`rtY;)}VF0 z{JLQ#^%Tr*!M=%|n}L%q`gLf-wQy!6%!mL{3|2KFQ0hbn;o1Of-CRGv`TLhv((wvo zXf}a91^BNW+*oJ&S>4F(kk|MdZt_dw^F}HwD?1n&-suK`D8?%Yyq(rLW=R&^b-UYv zw^=4O!+V2jfj9DXo)41>9-3?(N0NkIVa0{T9IIfuql7NK>0S)|yEDLtvtGkDRa%dI z`Mj4GC>~4EXOD9~M1qmD%}X5zqAHa_>G#w6RX=)|E3BhF`Dp?0iVswHG$>VxI`5TF z1)r|`qGGF7<#T)IRwqig*d7t0G4}85UouG7Ac%gb>M=Oq)D%i#mI9!S`K>E=+jqI| z=yuV)p#Yc{cX{X9ylXM=!~Z-O;|~9Y0jTo*%3d0J$^+G`2lAG@IT_jLp1)88W>MW>3CqxX1J9=;aEs$lYuMKvv41!(pA*@lwH8taaxOB>Awy}zE zBW%Q2#wf0Gm>75SE5I0IWicL&li@3<48?P+SUxr{lf>hPe6u{YO5^#8jt8_?U#W*< zB|B-nQy>mMs0OJ9ut4q&`4z&tjyKp zvp*#RVJN{WxZmDn^GgG)MSWMa6#@BYjnZbMB2y56*W;)rTe?mbX=vWY-^J>0?^L0K zQgw-JfYexjKsD8(CaTsUk7oi0jU#!-X`!IHQ}I_I&C#adV!Nd-ks8 z?`3odq{61+sq9fUU2*xZu#Y=C9+vf%n+fbIk66xC{y!k%oJK8>ha`F2G??y7q=MQ*&S)B2|$w#7F0+j^uvL5JC` zrWUI}71|dC0Gj{1$rvoU3{7TK`O60Q4Y07H`t4W-uK%$cpb-UP$Q=aip}IXgxq>V3 z(dG@P>hfQ^B6BOzHb|Hsdny6< z#35&dyQ{-1RR3$QM-Bt5W$(7G1Kep#ALyJ>DPQCN{kbk1gbI6$4Lm?`76=6+mkV?F zYb480fvf3hwLQZA|0nympV3gDQBAY>Svg=l?;ymm|30TWD(JRbp?ixk;GT3qHzuEU zHi`b*L3IpHA{xjlF5>L$tj7Q5P5;nPJm3oU6<`|Gk=K##%RU}6<~@Fn>{GrHRND|I zNsje)n-%&yhx9s(^ynbGZ*-46KIh0ruoB(*{5{EpH&;GN)%IDV{TwsEg4?{lu`%$D zir*5*GsG$seoq;dB#fJG-pT~epG8(T|DB|^93&qYq>DZa4-dy@o&lh^7PVyfQ>kySN?k!MKqe!V*KK&G(`{XC=zH9oKD~arJuzMI ztW-zv6$=n7%+GxF7^CODMYyg{50(}#CSrp720z%+N%+owvY04PDgTOvwm>Xazf!h- z2Wdc6qm%0zSzY#6L{zVj-ah$!PKWb7WA3N2vvYnX~t1y5~9| z1RD!fgsB0F;}1H6cL68DUUF*s1V}39TIY?Sacp`D0D4xXz2M}#w8EwiV33j5N^pab z49?}*F2^kj#{V$%joF8XFT&gY4{frN>F!y}clZ#1vH=3G24>U8nx}mYhR8CsD7<4%3uP6)zD=SxcS7%)aysy}Pr#Ae=EAiV>$VF(8+Ed!ey% z(f{U8gE*Rs9?5_D&EYwa0q-hvGA7SZ?+#!XKDRyqt+F6ZZvwbk;M}h!S9nlJ_~?GD8O)`ZS#_`SrN&J-!eR$+)>byn!WfV7jcST+nFBnC=vX7-s%w zOqo0LdF<;`0o4f~ zBk_C;DJ@#P{DzVroRpgU8E8PU8OCEE1AbOEtwNtp5-^5*Sv!PK7@ERQPbbtCHZc%4 zSDQ~%`1WXaO}`;4N8_s$A}M5=offZv7mh6Ri#5d+2+`QUJ!jmPe5g6VCZ*mME`D4mSIOdnBd|Ie)!*QBZ~k6LXea9?FBSGuXOQVM&XE-lk*Z0 zW1wXPdF?T%e?2nBp=IoH`!W2eP&;UQzwujxXu-~o?F0l)N^3?fWUu>nn31RxW3Oot zctx#!n5c2!U|mKf*Y63>Q;c7B1JzeN!Igmj2cS6kNajg>vmv6VPJBfeae8$22SbH@f|pm;3I_ToeYEMS&*KR0%&r=cMq~? zi9Z9>xf#_Gk$m>KJh}%Z)rVVA_&GK}VMzhmy|Z{5=xDF3BS9P{V$0LY>d`dZU0b(8 z?Z3?~%?JY&_hqwDAm`I3pNJGjKi(9!#bCH*pnB`+<+q#m<_-1~zn-<)B4Q~5((5i` zF@1HHg?ACQGJ&ASPp*%ncw7RDCcfQVdtx%kSW5gkod6uU`w<4Ur>hZs)X~PS!-Cix zzZ&s)I^AU)>F^kLd%{Su5nIXzXtI>p%?26`(mJ}BJINkd1=!ohQDP^dfM3b6f6)4o znwp+3hHf|=gZ&+wDU~S$F1+{k9?NdC?mAG}zd0D4ZSnmI7Ds2w`E25CtdxqPLm1rM zZvQu@m2)wrgh`D0q_-pn zdVFf%$aq~P<7zn-yi>}dsXL^GCoPJNMCQ!!bQL||==85QQCEsgZFrwTIZ1oVWNDS| z2Qb8Z(iZtCMQLNLK%tcHoov`0q>GH@DzW?aPTq~w|1TLaZstL-K!aWYGQVz3LI_*u%*tNVmM$bF!}LK7BNkFP;cuiF!lH} zNy;-2(RIHuG&qi&)o;Bx^1{72!*hRXKX}UY%l#ekC#r-SDRhFG(`?lam)5Yt~( zH^t-cJEP2ylnay1=sm%{WM0P^g;(XrWB6Hn!%qm@$bkcXHc( z){i_I*F@DnMqu-wp_+mKj1JpEX&&3nk1P-P;!y)e+{GD)In&n zqS7Q_?sPo-IwszMiSn0M#UVublJNk@C?l2>^;6q4N>dg?rekyXwPK=gwPu0pWf(q# zkPNim3ik&*!Ipq@ulI-B_&lJt9>M#dE1r{O&_fgBUms23DP(7dnmd2z{UhUo;mASH|RnVO-C;aa=zS#+D7? zrzUZ`nGt9OU`Mv*|1VxymWAx>($pv4)ZIJl$P;|<+FhbRPe`7S;T(Ap&jUTkbdCQ_mqn278#wz?1K_|TX&iT@mKZB$5zT=|@h zI^OF0lX2xAldxCGA{(8M_y0m_U!mx`ej{leN^({)hR##&qTe*z^Vd30F$fXHsY$81 zRq<5QOniz+SXfEts(8R6!`~T>f+0oOWj@&2`T`zIvLIXB;Xo|gd@ON_M`Qg1v3s zAfzmg6ELxI4eG=ttO^RVePB~Ao8(rbFO$^OyhfZHYauoV{p-BXKnZArNH+nk2*g+4-43$Qf$yuu{CREig#B6+ZQ%5@ zdsSF3rQBf8bCr?#4MX%mN#_GZiKfFG`UY_c+KyHBo;qe-6&q z@4D>-xSuRF7+oxAFj{;`XOup}M!Yf3kd2D=c%FsS&O!(MPJ*5Y5~#grsHxRAJRZ4c zB*l-5(71c=$^RF;RwA{&OlB2(6OfFaie*Yo6c2FD)wsXqHfTrOrCZGPe1rEr&Gn-A z?3V(SxKBJjC0z0lx~ZlA&#F-izC8*Ayo~{%#QeqDr(x=1i5%iQ^9auOlp^{A14^t~ zPy0<3JMWud;0mpR*u`AV>bd<0-Ie#7S08ls1V;Yn`-ZlH6^89zI%VMss?_gfJl9%F zvglJAu=@B*uk=iXoSfVzJI;(kq_;O%Q(r&FV?Frde#4iI_4O@?hTh`B2pwQVME;PY z#~RO`<)1|rP6-zbWIWf&h$rPZtuL{4Zy1aLlnf!>tKb z1_vKpI!$tmkWR{x=()TezN2;3m-+f{1Rw1IZDJ>KR3YUJxw;lD9(zfOE-on0L2V}& z?D|!@-&x3CJz|QGTTyk=(P>Dlkl>-ZXcL6jAKE8)Fu!i-zOU35s4NN_&C=NRNgpg% z)$+#l$<5EMHhxb7%~$(|a#6iOjh8-G<9`JLiFA-cm3BgKbfw&Ix4pd3qO?Q_31OdO zF_q|0Y%enc&@vov-7adXD*t^sm+2t1FUOTl9?7clgMjCtY_C{ZHhoUolDEf5P!R`%Z<2H#IDP z+^d3G@TF+_HJ|iKALAXE*G`ai4BLBVD%S6!Uuwy-K$=!`U&)^B+~>}}5AS^=+4O%1 zQ>kR25D$xYY9Y@qkj=(&M<#VgU}~f}qRhqz$q~%%Uw%Eci9)tl95T@n{t(gAHz9RH zwe3AjX^Wfe!={mkJGzaO6Qfn5&gmOBE`Y$ZkFQ89UD&&n@mcYe*Q9< zm^Dqho+i9&@`K|E|KCNbNb(_UG%cqPZ6O&n&mPRo{}#jzyAL@!L}F^6y-$e^JR?iN zk2Td()mJKDdSOr`nRMUO*^(krpv1Cja#*oj+O7YAx6@A2!&J>fsfk0w!+nS}Ut*52n-!=( zpJ*>0d9)CA2g8dt7hBLC?Mji%J+LmOzLxx91tGI5AxfhGCC@|yn*pr z8vGpfXyU=7oY*9W0x&FJ5-tEKoU1?cDSIq$8eX5Xc$+KtU#qv^T!sc?FtRweAU}hO z#Utpy7ysX@P*|{NDRewzaFfB`jm_acx_Hw2B``1m+E@vojh7Zf^#4AFWDk@G#he(< g_0NyvGN>CuUAE=`k99>`5b&iat143=Wg77R0D$CcZ~y=R diff --git a/docs/managing-cargo-dependencies.md b/docs/managing-cargo-dependencies.md new file mode 100644 index 000000000..1afd82d24 --- /dev/null +++ b/docs/managing-cargo-dependencies.md @@ -0,0 +1,65 @@ +# Managing Cargo dependencies + +In general, `wgpu` tries to stay up-to-date with the current Rust ecosystem; we are interested in keeping the version of dependency crates we use up-to-date. However, there are some considerations to keep in mind when upgrading or adding dependencies to `wgpu`. + +## Adding or upgrading dependencies may cause dependency duplication downstream + +Some crates in the Rust ecosystem are useful for both `wgpu` and its downstream consumers. Popular crates—like those in the `serde` ecosystem, for example—are often used in multiple places in a Rust crate's dependency tree. Normally, Cargo can unify dependencies behind a single SemVer-compatible version. When one or more, but not all, of these places consume a [SemVer-incompatible upgrade][semver-summary], Cargo uses both in the new dependency tree (see The Cargo Book's section titled [`Version-incompatibility hazards`](https://doc.rust-lang.org/cargo/reference/resolver.html#version-incompatibility-hazards)). These are often referred to as "duplicate dependencies"[^1]. + +[semver-summary]: https://semver.org/spec/v2.0.0.html#summary + +[^1]: One can detect such duplicates with [`cargo tree --duplicates`](https://doc.rust-lang.org/cargo/commands/cargo-tree.html#option-cargo-tree---duplicates). + +There exist many Rust projects that, for some reason or another, are sensitive to duplicate dependencies. The most common reason for this is to minimize the number of built dependencies, but there are other reasons for doing so, like projects that prefer to [vendor in their dependencies' source code](https://doc.rust-lang.org/cargo/commands/cargo-vendor.html) and keep diffs easy to inspect. **When a dependency of `wgpu` releases a SemVer-incompatible change and `wgpu` consumes it (even if it's new _to `wgpu`_), it may cause conflicts for projects that avoid duplicate dependencies.** + +> [!TIP] +> Downstreams like Firefox can and do work around Cargo's (well-motivated) refusal to unify SemVer-incompatible versions of crates, but this happens only on a case-by-case basis. In general, this requires source compatibility for the APIs actually consumed between both versions. + +## Firefox needs to audit every dependency + +In addition to the above, Firefox has unusual sensitivities to updates because of required auditing via [`cargo-vet`](https://github.com/mozilla/cargo-vet). **Firefox contributors _cannot_ bring in a Rust dependency—including new versions of dependencies already in use—without an audit indicating that the dependency meets [`safe-to-deploy`] criteria for _all_ of its feature combinations.** One can ask the following questions to determine whether an upgrade is feasible for Firefox; "yes" answers are significantly easier cases to deal with: + +1. If the dependency had to be audited for [`safe-to-deploy`], would it take less than an hour to review? + + One can use to quickly gauge the answer to this question for upgrades. Example: [`serde` 1.0.218 → 1.0.219](https://diff.rs/serde/1.0.218/1.0.219/src%2Flib.rs) + +1. Does the same code work between the two dependency's versions without needing to be changed (viz., are they "source-compatible")? + + NOTE: This is somewhat different from [SemVer compatibility][semver-summary], because it deals with code already written, rather than SemVer's dealing with code that _might_ be written. + +1. Does the dependency already have an audit in Mozilla's [`supply-chain/audits.toml`](https://searchfox.org/mozilla-central/source/supply-chain/audits.toml) or in the other audit databases it `import`s in [`supply-chain/config.toml`](https://searchfox.org/mozilla-central/source/supply-chain/config.toml)? + +[`safe-to-deploy`]: https://mozilla.github.io/cargo-vet/built-in-criteria.html#safe-to-deploy + +> [!TIP] +> [Searchfox](https://searchfox.org) can be used to answer question (3) and other simple questions with just a web browser. For example: +> +> - "Does Firefox use the `itertools` crate?" can be answered by a case-sensitive search scoped to files with the `rs` extension: https://searchfox.org/mozilla-central/search?q=itertools&path=*.rs&case=true®exp=false +> - "Is `serde` 1.0.143 already audited?" can be answered by examining `supply-chain/audits.toml` ([permalink](https://searchfox.org/mozilla-central/rev/f3c8c63a097b61bb1f01e13629b9514e09395947/supply-chain/audits.toml#4730-4733)). + +> [!TIP] +> For more complicated questions like, "What features does Mozilla use in the `hashbrown` crate?" the best known way to satisfy the question is using Cargo's CLI, i.e., `cargo tree` or `cargo metadata`, in tandem with editing Cargo manifests directly. A Git mirror of Firefox's source code can be found at [`mozilla/gecko-dev`](https://github.com/mozilla/gecko-dev). +> +> A full checkout of `gecko-dev` fills multiple gigabytes, and is not recommended to make one locally unless you plan on doing work directly on Firefox. However, we can optimize to somewhat less than 1 GiB of storage, and speed up the checkout process by using `git sparse-checkout`: +> +> ```sh +> git clone --sparse --depth=1 'https://github.com/mozilla/gecko-dev.git' +> cd gecko-dev +> git sparse-checkout set --no-cone +> git sparse-checkout add \ +> '**/Cargo.toml' \ +> '**/lib.rs' \ +> '**/main.rs' \ +> '**/src/bin/*.rs' \ +> ; +> ``` +> +> From here, you can invoke Cargo with the `--locked` flag, i.e: +> +> ```sh +> cargo --locked tree -i itertools +> ``` +> +> ```sh +> cargo --locked metadata --format-version=1 +> ``` diff --git a/docs/render_coordinates.png b/docs/render_coordinates.png deleted file mode 100644 index c8f544fb9aff743401169e6338884a7e65e12b82..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 8408 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 diff --git a/docs/running-tests-on-android-and-ios.md b/docs/running-tests-on-android-and-ios.md new file mode 100644 index 000000000..697279a77 --- /dev/null +++ b/docs/running-tests-on-android-and-ios.md @@ -0,0 +1,165 @@ +# Running the tests on Android and iOS + +An approach of cross-compiling the binaries on a host, then using various tools such as `adb` and `ssh` to transfer the test binaries over to run them, can be used. + +Below are example configuration and runner scripts that can be used to perform this yourself. + +## Android + +
+.cargo/config.toml + +```toml +[target.aarch64-linux-android] +# Runner script is written in powershell +runner = ["pwsh", "-File", "run-on-android.ps1"] +rustflags = [ + "-C", "linker=clang", + "-C", "link-arg=-fuse-ld=lld", + "-C", "link-arg=--target=aarch64-linux-android", + "-C", "link-arg=--sysroot=", + "-C", "link-arg=-B/usr/lib/aarch64-linux-android/", + "-C", "link-arg=-L/usr/lib/aarch64-linux-android/", + "-C", "link-arg=-L/usr/lib/aarch64-linux-android", + "-C", "link-arg=-L/toolchains/llvm/prebuilt//lib/clang/20/lib/linux/aarch64" +] +``` + +
+ +
+run-on-android.ps1 + +```powershell +param( + [string]$BinaryPath +) + +$ErrorActionPreference = "Stop" + +# /data/local/tmp is the most common directory where arbitrary binaries can be run +$RemoteDir = "/data/local/tmp/runner" +$BinaryName = Split-Path -Leaf $BinaryPath +$RemotePath = "$RemoteDir/$BinaryName" + +adb push --sync "$BinaryPath" "$RemotePath" *>$null + +adb shell "chmod 755 $RemotePath" + +$EscapedArgs = $args | ForEach-Object { + if ($_ -match " ") { + "`"$_`"" + } else { + $_ + } +} + +$LinuxArgs = $EscapedArgs -join " " +# Set LD_LIBRARY_PATH to the location of libc++_shared.so +$DeviceCmd = "cd $RemoteDir && LD_LIBRARY_PATH=$RemoteDir ./$BinaryName $LinuxArgs" + +adb shell "$DeviceCmd" +exit $LASTEXITCODE +``` + +
+ +All Android binaries link to `libc++_shared.so`. Remember to put a copy alongside the binaries. + +## iOS + +Apple does not normally provide shell access and `sshd` on their operating system, so jailbreaking the system is required. + +Only a copy of the iOS sysroot is required to cross-compile, so Linux and Windows can also try this. + +
+.cargo/config.toml + +```toml +[target.aarch64-apple-ios] +# Runner script is written in powershell +runner = ["pwsh", "-File", "run-on-ios.ps1"] +rustflags = [ + "-C", "linker=clang", + "-C", "link-arg=-fuse-ld=lld", + "-C", "link-arg=--target=aarch64-apple-ios", + "-C", "link-arg=--sysroot=", + "-C", "link-arg=-miphoneos-version-min=", + "-C", "link-arg=-rpath", + "-C", "link-arg=@executable_path/Frameworks", + "-Lnative=/usr/lib", + "-Lframework=/System/Library/Frameworks", +] +``` + +
+ +If you're on a platform other than macOS, set an environment variable of `SDKROOT` to your sysroot location. + +This avoids `cc-rs` trying to run `xcrun`. + +
+run-on-ios.ps1 + +```powershell +param( + [string]$BinaryPath +) + +$SshTarget = "@" +$BinaryName = Split-Path -Leaf $BinaryPath +# Select one of the following paths depending on rootless or rootful jailbreak +$RemoteDir = "/var/jb/var/mobile/runner" +#$RemoteDir = "/var/root/runner" +$RemotePath = "$RemoteDir/$BinaryName" + +$EscapedArgs = $args | ForEach-Object { + if ($_ -match " ") { + "`"$_`"" + } else { + $_ + } +} + +$LinuxArgs = $EscapedArgs -join " " +$DeviceCmd = "./$BinaryName $LinuxArgs" + +ssh $SshTarget "test -f $RemotePath" + +if ($LASTEXITCODE -ne 0) { + scp -q "$BinaryPath" "$SshTarget`:$RemotePath" + $DeviceCmd = "chmod 755 $BinaryName && ldid -Sent.xml $BinaryName && $DeviceCmd" +} + +ssh $SshTarget "cd $RemoteDir && $DeviceCmd" +exit $LASTEXITCODE +``` + +
+ +Due to iOS security measures, a binary needs to contain specific entitlements to run without a container and access IOKit, so it is required to have the `ldid` tool installed on your target device to set the entitlements with `ent.xml`. It should be placed in your runner directory. + +
+ent.xml + +```xml + + + + platform-application + + com.apple.private.security.container-required + + com.apple.security.iokit-user-client-class + + AGXCommandQueue + AGXDevice + AGXDeviceUserClient + AGXSharedUserClient + IOSurfaceRootUserClient + + + +``` + +
diff --git a/docs/texture_coordinates.png b/docs/texture_coordinates.png deleted file mode 100644 index f3fbbca0879433c266f958b1c733bbe9013ec23f..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 5597 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 Self { Self { enabled: true } } diff --git a/wgpu/build.rs b/wgpu/build.rs index cd5316fbd..1198608f2 100644 --- a/wgpu/build.rs +++ b/wgpu/build.rs @@ -62,4 +62,77 @@ fn main() { ) }, no_std: { not(std) } } + + // Expose a `file://` base URL pointing at the crate's + // `src/documentation/images/` directory so that local documentation builds + // resolve images from disk. Because these images live inside the crate, they + // are packaged on publish and this path also resolves when a downstream user + // builds the docs of `wgpu` as a dependency. `docsrs` builds ignore this and + // use an HTTP URL instead; see the `doc_image!` macro in `src/macros/mod.rs`. + // Resolving the path here lets us normalize to forward slashes and pick the + // right number of leading slashes for the host. + let manifest_dir = std::env::var("CARGO_MANIFEST_DIR").unwrap(); + let docs_dir = std::path::Path::new(&manifest_dir) + .join("src") + .join("documentation") + .join("images"); + let docs_dir = docs_dir.to_string_lossy().replace('\\', "/"); + let docs_url = if docs_dir.starts_with('/') { + format!("file://{docs_dir}") + } else { + format!("file:///{docs_dir}") + }; + println!("cargo::rustc-env=WGPU_DOCS_URL_BASE={docs_url}"); + + // Pin hosted documentation image URLs (docs.rs and the self-hosted trunk + // docs) to the exact commit being built rather than the moving `trunk` + // branch, so the images never drift from the prose. Only the `docsrs` arm of + // the `doc_image!` macro reads this; local builds use the on-disk path above + // and ignore it, so we deliberately don't add a `rerun-if-changed` on the + // git HEAD — recomputing it on the build script's normal re-runs is enough. + println!( + "cargo::rustc-env=WGPU_DOCS_COMMIT={}", + docs_commit(&manifest_dir) + ); +} + +/// Best-effort lookup of the commit this build corresponds to, for pinning +/// documentation image URLs. +/// +/// Tries `git` first (a local checkout, and the self-hosted trunk docs CI), then +/// the `.cargo_vcs_info.json` that `cargo publish` embeds in the packaged crate +/// (the docs.rs case, where there is no `.git`), and finally falls back to +/// `trunk` so the URLs still resolve. +fn docs_commit(manifest_dir: &str) -> String { + commit_from_git(manifest_dir) + .or_else(|| commit_from_vcs_info(manifest_dir)) + .unwrap_or_else(|| "trunk".to_owned()) +} + +fn commit_from_git(manifest_dir: &str) -> Option { + let output = std::process::Command::new("git") + .args(["rev-parse", "HEAD"]) + .current_dir(manifest_dir) + .output() + .ok()?; + if !output.status.success() { + return None; + } + let sha = String::from_utf8(output.stdout).ok()?.trim().to_owned(); + (!sha.is_empty()).then_some(sha) +} + +fn commit_from_vcs_info(manifest_dir: &str) -> Option { + let path = std::path::Path::new(manifest_dir).join(".cargo_vcs_info.json"); + let contents = std::fs::read_to_string(path).ok()?; + // Minimal extraction of `"sha1": ""`, to avoid pulling a JSON parser + // into the build script. + let sha = contents + .split_once("\"sha1\"")? + .1 + .split_once('"')? + .1 + .split_once('"')? + .0; + (!sha.is_empty()).then(|| sha.to_owned()) } diff --git a/wgpu/src/documentation/best_practices/dos_and_donts.rs b/wgpu/src/documentation/best_practices/dos_and_donts.rs new file mode 100644 index 000000000..812d994d1 --- /dev/null +++ b/wgpu/src/documentation/best_practices/dos_and_donts.rs @@ -0,0 +1,36 @@ +/*! +# Dos and Don'ts + +A short list of common performance pitfalls and the patterns that avoid +them. + +### Don't: create temporary mapped buffers when updating data + +Instead, [`Queue::write_buffer`] and [`Queue::write_texture`] can be used +conveniently. If you are uploading a lot of data that is generated (as +opposed to already sitting in a data vector), it may be more efficient to +recycle staging buffers in a pool. + +### Do: group resource bindings by change frequency, starting from the lowest + +For example, put per-frame resources into bind group 0, per-pass resources +into bind group 1, and per-material resources into bind group 2. This allows +the WebGPU implementation to keep the other bindings intact, reducing state +changes. + +### Don't: create many resources (buffers or textures) per frame + +This puts pressure on the WebGPU memory allocator and tracker. Prefer +coalescing smaller resources into larger ones. For buffers, you can create a +large buffer and use different parts of it for different purposes. For +textures, consider texture atlases and arrays. + +### Don't: submit many times per frame + +There is a visible CPU cost per submission, and resources are tracked per +submission by the implementation. It is fine to have multiple +[`CommandBuffer`]s per submission, but the number of [`Queue::submit`] calls +should be limited to a few per frame (e.g. 1–5). +*/ + +use crate::{CommandBuffer, Queue}; diff --git a/wgpu/src/documentation/best_practices/middleware.rs b/wgpu/src/documentation/best_practices/middleware.rs new file mode 100644 index 000000000..557489c85 --- /dev/null +++ b/wgpu/src/documentation/best_practices/middleware.rs @@ -0,0 +1,104 @@ +/*! +# Encapsulating Graphics Work: the Middleware Pattern + +Whether you are designing a library to be used by others or modularizing +your own code, it is important to be able to encapsulate graphics code in a +way that offers the calling code as much flexibility as possible. + +The following pattern is called the "middleware pattern" and works well both +in separate libraries and in regular modules. + +## Middleware libraries + +Middleware is a piece of software that fits unobtrusively into an existing +application, giving it some extra functionality. In the case of `wgpu`, +middleware are libraries that use the `wgpu` context the user provides to do +their work. If a library creates the `wgpu` adapter, device, etc. for you, +it isn't middleware — it would more likely be called a framework. + +## API design + +This does not have to be the extent of the API; you may have more (or +different) arguments or more functions, but this is the gist of the +interactions with `wgpu`. + +```ignore +impl MiddlewareRenderer { + /// Create all unchanging resources here. + pub fn new(device: &Device, format: &TextureFormat, ..) -> Self; + + /// Prepare for rendering this frame; create all resources that will be + /// used during the next render that do not already exist. + pub fn prepare(&mut self, ..); + + /// Render using a caller-provided render pass. + pub fn render(&self, render_pass: &mut RenderPass<'_>); +} +``` + +The goal of this API is to use as few render passes and submissions as +possible. + +- On GPUs that use _tiled rendering_, there is significant cost to ending a + render pass. Therefore, the middleware should accept an existing + [`RenderPass`] (presuming it is rendering to a surface/texture provided by + the user). + +- [`Queue::submit`] is expensive for `wgpu` to execute. Therefore, if the + middleware generates a [`CommandBuffer`] when preparing, it should hand + that buffer back to the caller to become part of a larger submission, + instead of submitting it alone. + +## Functions + +### New + +```ignore +fn new(device: &Device, format: &TextureFormat, ..) -> Self; +``` + +This is where you create your renderer and set up all the static resources. +Things like pipelines, buffers, or textures should be created and uploaded +here. When the middleware needs to know the parameters of what it is +rendering to, favor accepting a [`TextureFormat`], `width`, and `height` +over a [`SurfaceConfiguration`], as the user may not be rendering to the +surface but to another texture. + +### Prepare + +```ignore +fn prepare(&mut self, ..); +``` + +Ideally there should be a minimal amount of resources created per frame, but +that is often hard to avoid. `prepare()` should create those resources and +do any other computation required to be ready to render. + +### Render + +```ignore +fn render(&self, render_pass: &mut RenderPass<'_>); +``` + +This is where the magic happens! Using the resources created during `new()` +and `prepare()`, render everything using the provided render pass. + +The split between `prepare()` and `render()` is not critical but improves +flexibility. By avoiding borrowing the middleware object exclusively +(`&mut`) during `render()`, the user has more options for organizing their +code; for example, they might want to perform command encoding — including +the middleware's `render()` — in parallel into multiple command buffers, and +this may be easier if the middleware (and therefore whatever owns it) does +not have to be exclusively borrowed. It also means that the order of calls +to `prepare()` of different middleware can be independent of the order of +drawing. + +## Multiple render targets + +If your piece of middleware has to render to multiple targets, it is pretty +unavoidable to have multiple render passes. As much as possible, this +pattern should be used as a guideline for the design of your API, but it +doesn't work for every possible piece of middleware out there. +*/ + +use crate::{CommandBuffer, Queue, RenderPass, SurfaceConfiguration, TextureFormat}; diff --git a/wgpu/src/documentation/best_practices/mod.rs b/wgpu/src/documentation/best_practices/mod.rs new file mode 100644 index 000000000..975588f21 --- /dev/null +++ b/wgpu/src/documentation/best_practices/mod.rs @@ -0,0 +1,8 @@ +/*! +Best Practices + +Patterns and pitfalls for writing efficient, well-structured `wgpu` code. +*/ + +pub mod dos_and_donts; +pub mod middleware; diff --git a/wgpu/src/documentation/color/hdr_surfaces.rs b/wgpu/src/documentation/color/hdr_surfaces.rs new file mode 100644 index 000000000..ac1884c06 --- /dev/null +++ b/wgpu/src/documentation/color/hdr_surfaces.rs @@ -0,0 +1,149 @@ +/*! +# HDR Surfaces + +A surface can present in different color spaces to get HDR or wide-gamut +output onto the screen. This is configured through +[`SurfaceConfiguration::color_space`], and the rest of this section is a +concept primer on how it works. + +### HDR output in a nutshell + +By default a surface is standard dynamic range (SDR) with the sRGB gamut: the +value `1.0` is the brightest white, anything above it clips, and only colors +within sRGB are expressible. Other [`SurfaceColorSpace`]s opt into a **wider +gamut** (for example [`DisplayP3`](SurfaceColorSpace::DisplayP3), still SDR +but with more saturated colors than sRGB), **high dynamic range** (values +above `1.0` drive brighter-than-white output), or both (for example +[`Bt2100Pq`](SurfaceColorSpace::Bt2100Pq), aka HDR10), on platforms that +support it. + +Three ideas carry most of the weight: + +* **Reference white and headroom.** Brightness is measured in *nits* + (cd/m²). On HDR-capable monitors, SDR reference white (plain white, `(1.0, 1.0, 1.0)` in the + extended color spaces) sits *below* the display's peak output on purpose, so + highlights have room above it. That gap is the display's *headroom*. +* **The transfer function is a round-trip.** Your shader applies an + encoding transfer function (the OETF) to turn the light it computed into a + stored signal, and the display applies the inverse decoding transfer + function (the EOTF) to turn it back into light. Choosing a color space + chooses which transfer functions both ends use. +* **Who applies the encoding transfer function.** wgpu applies it for you + **only** when you render to an `*Srgb` texture view format, where the GPU + runs the sRGB OETF when a value is stored to a texture. For every other + color space (linear extended sRGB, encoded extended sRGB or P3, PQ, HLG) + **the values your shader writes to the surface texture must already be + encoded by you**, along with any gamut conversion; in a typical renderer + this happens in a final tone-mapping or post-processing pass. wgpu hands + the signal to the compositor unchanged; getting this wrong produces a + wrong image with no error. + +wgpu does **not** tonemap or gamut-map for you. It gives you the surface +and, through [`DisplayHdrInfo`], the display's advisory capabilities; +*choosing* and *applying* a tone curve is your application's job. + +### The practical path + +1. **Query capabilities.** Call [`Surface::get_capabilities`]. To use HDR or + wide-gamut output, read [`SurfaceCapabilities::format_capabilities`] (each + format and the [`SurfaceColorSpaces`] it supports), **not** + [`SurfaceCapabilities::formats`]: the latter lists only formats usable + with [`Auto`](SurfaceColorSpace::Auto), which never selects HDR. + [`SurfaceCapabilities::color_spaces`] is a convenience lookup for one + format. +2. **Optionally query the display.** Call [`Surface::display_hdr_info`] for the + current [`DisplayHdrInfo`] (peak and SDR-white nits, EDR headroom, + primaries, and a coarse dynamic-range/gamut bucket). Use it to pick a + tone-map target ([`DisplayHdrInfo::tone_map_headroom`]); *whether* HDR is + worthwhile is the capability question from step 1, not this live value. + Every field is advisory and optional; `None` means "cannot tell here", + never "SDR". +3. **Choose a format and color space.** Intersect what you want with what + step 1 advertises, in your own preference order (for example HDR10, then + linear extended sRGB, then encoded extended sRGB, then SDR + [`Srgb`](SurfaceColorSpace::Srgb)). Keep an SDR fallback for when nothing + HDR is advertised, such as when OS HDR is off. +4. **Configure the surface.** Set [`SurfaceConfiguration::color_space`] and + `format`. [`Auto`](SurfaceColorSpace::Auto) (the default) reproduces + wgpu's historical behavior and never picks HDR; any other value must be in + that format's advertised set or configuration fails validation. +5. **Encode what you write to the surface texture.** For an `*Srgb` format, + output linear and the hardware encodes for you. Otherwise the values your + shader writes to the surface texture must already carry the encoding the + chosen color space expects (sRGB, extended sRGB, PQ, or HLG) **and** any + gamut conversion (for example outputting in the BT.2020 gamut for HDR10); + in a typical renderer you do this in a final tone-mapping or + post-processing pass. See the table below. +6. **Present** as usual. If OS HDR is toggled mid-run, you'll see it on the + next [`Surface::display_hdr_info`] poll; re-query [`Surface::get_capabilities`] + and re-run the steps above. + +The standalone [HDR surface example] implements every step, including the +encoding transfer function for each color space. + +### What to output from your fragment shader + +What the values your shader writes to the surface texture must contain for +each color space, and whether wgpu applies the transfer function for you: + +| Color space | Typical format | You write | wgpu encodes? | +| ----------- | -------------- | --------- | ------------- | +| `Srgb`, `*Srgb` format | `{Rgba,Bgra}8UnormSrgb` | linear | **yes** (hardware sRGB OETF on store) | +| `Srgb`, non-srgb format | `{Rgba,Bgra}8Unorm` | sRGB-encoded | no; apply the sRGB OETF yourself or use `*Srgb` instead | +| `ExtendedSrgbLinear` (scRGB) | `Rgba16Float` | linear, `1.0` = SDR white | no, but no encoding is necessary | +| `ExtendedSrgb` | `Rgba16Float` | extended sRGB-encoded | no; apply the extended sRGB OETF yourself | +| `DisplayP3` | `Bgra8Unorm` | sRGB-encoded, P3 primaries | no; apply the sRGB OETF (after gamut-mapping to P3) | +| `ExtendedDisplayP3` | `Rgba16Float` | extended sRGB-encoded, P3 primaries | no; apply the extended sRGB OETF (after gamut-mapping to P3) | +| `Bt2100Pq` (HDR10) | `Rgb10a2Unorm` | PQ-encoded, BT.2020 primaries | no; apply the PQ OETF (after gamut-mapping to BT.2020) | +| `Bt2100Hlg` | `Rgb10a2Unorm` | HLG-encoded, BT.2020 primaries | no; apply the HLG OETF (after gamut-mapping to BT.2020) | + +In short, wgpu applies the transfer function for you only when you render to +an `*Srgb` format. In every other case the values your shader writes to the +surface texture must already carry both the transfer function and any gamut +conversion. The [HDR surface example] implements every encoder in WGSL. + +### Glossary + +* **Chromaticity** --- a color's hue and saturation independent of its + brightness, given as an `(x, y)` coordinate on the CIE 1931 diagram. +* **Primaries / gamut** --- the chromaticities of the red, green, and blue a + color space addresses, and so the range of colors it can express. [BT.709] + is the sRGB gamut, [Display P3] is wider, and [BT.2020] is wider still. +* **White point** --- the chromaticity of `R = G = B` (what "white" looks + like). Every color space here uses [D65], standard daylight. +* **Transfer function (OETF / EOTF)** --- how stored values map to light. The + *OETF* is the encoding transfer function your application applies; the + *EOTF* is the inverse decoding transfer function the display applies. +* **SDR / HDR** --- standard dynamic range clips at `1.0` (reference white); + high dynamic range lets values above `1.0` drive brighter-than-white + output. +* **Nits and reference white** --- a *nit* (cd/m²) is a unit of brightness; + *reference white* (also called *paper white*, especially on Windows) is the + brightness of SDR plain white, set below the panel's peak so highlights have + room above it. +* **Headroom (EDR)** --- how much brighter than current SDR white the display + can go right now, as a multiplier (`1.0` means none). Dynamic; see + [`DisplayHdrInfo::tone_map_headroom`]. +* **PQ / HLG** --- the two HDR transfer functions: [PQ] (SMPTE ST 2084, + HDR10) encodes absolute luminance, [HLG] (BT.2100) encodes relative + luminance. +* **scRGB / extended-range sRGB** --- sRGB extended past 0.0..=1.0 for + HDR: [scRGB] is *linear* + ([`ExtendedSrgbLinear`](SurfaceColorSpace::ExtendedSrgbLinear)), while + [`ExtendedSrgb`](SurfaceColorSpace::ExtendedSrgb) is the same range but + sRGB-*encoded* (gamma), the web's HDR path. + +[HDR surface example]: https://github.com/gfx-rs/wgpu/tree/v29/examples/standalone/03_hdr_surface +[BT.709]: https://www.itu.int/rec/R-REC-BT.709 +[BT.2020]: https://www.itu.int/rec/R-REC-BT.2020 +[Display P3]: https://en.wikipedia.org/wiki/DCI-P3#Display_P3 +[D65]: https://en.wikipedia.org/wiki/Standard_illuminant#D65_values +[PQ]: https://en.wikipedia.org/wiki/Perceptual_quantizer +[HLG]: https://www.itu.int/rec/R-REC-BT.2100 +[scRGB]: https://en.wikipedia.org/wiki/ScRGB +*/ + +use crate::{ + DisplayHdrInfo, Surface, SurfaceCapabilities, SurfaceColorSpace, SurfaceColorSpaces, + SurfaceConfiguration, +}; diff --git a/wgpu/src/documentation/color/mod.rs b/wgpu/src/documentation/color/mod.rs new file mode 100644 index 000000000..d3067a435 --- /dev/null +++ b/wgpu/src/documentation/color/mod.rs @@ -0,0 +1,6 @@ +/*! +Articles about HDR, color, and color spaces. +*/ + +pub mod hdr_surfaces; +pub mod srgb; diff --git a/wgpu/src/documentation/color/srgb.rs b/wgpu/src/documentation/color/srgb.rs new file mode 100644 index 000000000..7a5f180a2 --- /dev/null +++ b/wgpu/src/documentation/color/srgb.rs @@ -0,0 +1,119 @@ +/*! +# Texture Color Formats and sRGB Conversions + +Tips and common misconceptions about color formats. For surface output, +wide-gamut, and high-dynamic-range color, see +[HDR and Wide-Gamut Color Spaces](crate::documentation::color::hdr_surfaces). + +_(The following is adapted from conversations on the `wgpu` users Matrix +channel, saved here as a useful resource for future `wgpu` developers.)_ + +Digital color can be an extremely confusing topic, and the resources in +common circulation aren't always great. Modern low-level graphics APIs (such +as those under the hood of `wgpu`) give us powerful tools to manipulate color +data, though this comes at the cost of having to understand several low-level +principles in how digital color works. + +The best place to start is to have an understanding of the problems and +history of gamma correction. This page won't go deeply into the topic, but +some useful links can be found here: + +- [What every coder should know about gamma](https://blog.johnnovak.net/2016/09/21/what-every-coder-should-know-about-gamma/) +- [Hitchhiker's Guide to Digital Color](https://hg2dc.com/) +- [Learn OpenGL — Gamma Correction](https://learnopengl.com/Advanced-Lighting/Gamma-Correction) + +## What do `TextureFormat`s do? + +There are many different texture formats you can specify for the format of +your color data. This can be image data you upload from the CPU, shaded +geometry rendered to intermediate textures (what we used to call frame +buffers in OpenGL), compute shader targets, or geometry shaded to the window +surface itself. + +We won't go into all the different formats here, but it's useful to talk +about two of the most commonly used formats and some misconceptions about +what they do (and don't) do. + +## What are Unorm and UnormSrgb? + +Some of the most common formats you will see used for texture data, render +targets, etc. are [`Rgba8Unorm`](TextureFormat::Rgba8Unorm) and +[`Rgba8UnormSrgb`](TextureFormat::Rgba8UnormSrgb). So what are they, and how +do they relate to the issues of gamma correction, perceptually-linear "sRGB" +space, and physically-accurate "linear" space (as described in detail in the +links above)? + +First of all, it will be useful to clarify some terminology, as the words +"linear" and "sRGB" can be overloaded and lead to confusion: + +- **sRGB space** is a set of color primaries — this defines what red, green, + and blue are. + +In this sense (and perhaps counter-intuitively), texture formats ending in +"Unorm" and "UnormSrgb" are BOTH in the sRGB color space, and encode their +data in the same way without losing precision (as might be implied by some +descriptions of "linear" vs. "sRGB"); more on this later. + +Here is some useful terminology to help avoid "linear" and "sRGB" confusion: + +- What we traditionally called "linear space" is more accurately called + "scene-referred color". +- What we traditionally called "sRGB space" is more accurately called + "monitor-referred color". +- The conversion from scene-referred color to monitor-referred color is done + by the sRGB OETF (opto-electrical transfer function \[light → bits\]). +- The conversion from monitor-referred color to scene-referred color is done + by the sRGB EOTF (electro-optical transfer function \[bits → light\]). + +Let's walk our way up the color pipeline. The OS assumes that the bits you +are sending to the screen are monitor-referred and in the sRGB space (unless +otherwise specified). It will interpret the bits this way no matter what. + +- If you write/shade to a texture which is in a **Unorm** format, it will + take the output of your shader and do a float → int conversion, and that's + it (Unorm floats are written as ints under the hood, though you don't need + to worry about this). + + This means that if you're using this **Unorm** texture as a surface, *the + floats you are writing from your shader need to be **monitor-referred*** (i.e. + numbers that the OS can safely assume are already in sRGB space). + +- If you write/shade to a texture which is in a **UnormSrgb** format, it will + take the output of your shader and then apply the sRGB OETF to it, then + afterwards do the float → int conversion to store the data. + + This means that if you're using this **UnormSrgb** texture as a surface, + *the floats you are writing from your shader need to be **scene-referred***, + as the GPU will do the conversion to monitor-referred as part of the write! + +The inverse happens when you read from a texture: + +- a **Unorm** texture just does int → float on read. +- a **UnormSrgb** texture applies the sRGB EOTF to do monitor → scene and + then does the int → float read. + +## Common misconceptions + +**Q: So Unorm textures are in "linear" space and UnormSrgb textures are in +"sRGB" space?** + +**A:** No. Despite the naming, you are responsible for whether the outputs of +your shader represent "scene"- or "monitor"-referred values. The "Srgb" tag on +the texture format just lets the shader know that you want it to do a +conversion from sRGB to linear (or, more specifically, "monitor" to "scene") +when you sample it, or the inverse when you write to it. + +## Tips + +- Think of texture formats as a combination of data resolution and data + conversion functions. For example: + [`Rgba8UnormSrgb`](TextureFormat::Rgba8UnormSrgb) = `Rgba8` data + + `UnormSrgb` conversion step. +- Let the GPU do the conversion work for you. Historically in WebGL, for + example, if you wanted to do physically-accurate lighting you would need to + convert from linear to sRGB manually (often with an approximation like + `pow(col, 2.2)`). By being aware of the textures you are sampling and + writing to, you should be able to avoid manual conversions. +*/ + +use crate::TextureFormat; diff --git a/wgpu/src/documentation/debugging/debugging_applications.rs b/wgpu/src/documentation/debugging/debugging_applications.rs new file mode 100644 index 000000000..3a4778300 --- /dev/null +++ b/wgpu/src/documentation/debugging/debugging_applications.rs @@ -0,0 +1,178 @@ +/*! +# Debugging wgpu Applications + +This page describes the tricks and tools aimed at investigating issues +related to `wgpu`. + +## Native API validation + +`wgpu`'s goal is to guarantee that only valid workloads reach the low-level +APIs under the hood. If anything is not correct, we are going to complain +about it. You should never need to listen to the low-level API's complaints. + +This is a big [work-in-progress](https://github.com/gfx-rs/wgpu/labels/area%3A%20validation), +however. So in the meantime, it's useful to hear what the low-level +validation has to say. + +### Vulkan and OpenGL + +On Khronos APIs we redirect all the validation output to the console. You +will see it as long as: + +1. you run a debug build, +2. you have the validation layers installed (i.e. the LunarG SDK), and +3. you capture logging (with something like + [`env_logger`](https://crates.io/crates/env_logger)). + +To enable the validation layers in non-debug builds, manually turn on +validation in the [`InstanceDescriptor`] with [`InstanceFlags::VALIDATION`]. +See also [Enabling Vulkan Validation Layers](crate::documentation::debugging::vulkan_validation_layers). + +### D3D + +#### COM + +The refcount of a COM object is 9 32-bit words behind the pointer's +destination and is 4 bytes. As such, subtract 36 from the pointer's address +to get a pointer to that object's refcount. This allows you to use data +breakpoints to see all changes to the object's refcount, useful for +detecting leaks and other such things. + +### Metal + +You can either set `METAL_DEVICE_WRAPPER_TYPE=1` in the environment, or +launch from Xcode, where validation options are configurable in the project +menus (and enabled by default). To launch from Xcode, you can create a +project of "External Build System" type, picking `cargo` or any other +command as the build system. Then you'd need to edit the target +configuration and select the executable. + +A full guide that explains how to launch from Xcode is available in +[Debugging with Xcode](crate::documentation::debugging::xcode). + +#### Mac leaks + +To look for leaks using "Instruments", you need to add a special entitlement +to your executable's signature. Write the following to `entitle.xml`: + +```xml + + + + + com.apple.security.get-task-allow + + + +``` + +Then run `codesign -s - -v -f --entitlements=entitle.xml /path/to/my/app`. + +([Source](https://stackoverflow.com/questions/74262518/why-required-kernel-recording-resources-are-in-use-by-another-document-error-i).) + +## GPU debugging + +If the validation is clean, and you are getting incorrect rendering or +computing, it's time to dive into GPU debugging. Many tools exist today: + +- RenderDoc can be used on Windows and Linux to capture Vulkan, D3D, and + OpenGL. + - If RenderDoc is used with a compute shader without any normal rendering + components, wrap the work in [`Device::start_graphics_debugger_capture`] + and [`Device::stop_graphics_debugger_capture`] so RenderDoc picks up the + pipeline. + - Vulkan initialization may fail in RenderDoc under Wayland (see + [issue 3889](https://github.com/gfx-rs/wgpu/issues/3889)). To work around + it, force winit to use X11 by setting the `WAYLAND_DISPLAY` environment + variable to an empty string for winit versions `0.28.2` and onward, or + the `WINIT_UNIX_BACKEND` environment variable to `"x11"` for winit + versions up to `0.29.1`. When in doubt, do both. +- PIX can be used on Windows to capture D3D12. +- Xcode has powerful Metal GPU capture support with full shader debugging. + +In order to run your application from Xcode, you can create an empty project, +select your executable binary, and provide the command-line parameters in +the project settings. + +### Capturing WebGPU in Chrome with PIX + + + +### Capturing WebGPU in Chrome with Xcode + + + +## CPU debugging + +As `wgpu` is a Rust project, all the regular methods of debugging work. It's +convenient to launch an application from Xcode (e.g. as an "External Build +System" type project), or Visual Studio (just go to "Open Project" and +select the executable, adjusting the path and parameters). + +When looking at a crash/panic, the first step is typically enabling +`RUST_BACKTRACE=1` in the environment. This will spew out the stack trace, +which helps you locate the problem. + +## Rubber-duck debugging + +Hop on to [`#wgpu:matrix.org`](https://matrix.to/#/#wgpu:matrix.org) and try +to explain what happens and why. Maybe we listen. Maybe you'll figure out +the answer by then ;) + +## Tracing infrastructure + +API tracing is built into `wgpu-core` under the `trace` feature. To record a +trace, first make sure this feature is enabled, then set the `trace` field +of the [`DeviceDescriptor`] to [`Trace::Directory`](crate::Trace) with an existing folder +path when calling [`Adapter::request_device`]. The device will then record a +trace of everything that's going on to that folder. + +Once the trace is recorded, you can zip the folder and attach it to an +issue. This should allow anyone, including the developers, to reproduce the +issue on their machines, using the `player`: + +```bash +cd player +cargo run --features winit -- +``` + +If the program crashed or was interrupted in the midst of recording, you may +need to edit the trace folder's `trace.ron` file and add a closing `]` +bracket to the end. When that bracket is missing, the player exits with a +message like: + +```text +thread 'main' panicked at 'called `Result::unwrap()` on an `Err` value: +Error { code: Eof, position: Position { line: 96233, col: 1 } }', player/src/bin/play.rs:28:70 +``` + +### Running in Gecko + +If you encounter a problem with something that runs fine outside of Gecko +but fails to run in Gecko, there is a way to trace the API use by the +browser. Simply run Firefox Nightly (with prefs enabled for WebGPU, +obviously) under `WGPU_TRACE` pointing to a writable folder, and it will +record the API trace. Setting `MOZ_DISABLE_GPU_SANDBOX=1` might also be +required if the GPU process is sandboxed by default. This trace can be +replayed as usual, or even compared to a trace you get by running the same +application natively, to find out what the browser doesn't do right. + +To replay a capture from Firefox and inspect it in RenderDoc or similar +tools, it is best not to build the player with the `winit` cargo feature. + +When Firefox renders a WebGPU canvas, the result is done in a texture rather +than a window's swapchain, and that texture is then shared and put onto the +screen via other means that aren't part of the `wgpu` trace. Since there is +no window swapchain involved, RenderDoc can't guess when a frame starts and +ends, so it has to be helped by manually inserting begin/end capture +markers. When built without the `winit` feature, the player replays the +commands without rendering them into a window, and adds these markers at the +beginning and end of the trace; it doesn't when the `winit` feature is +enabled, since it then assumes the trace will eventually render into the +winit window's swapchain. + +This applies to Firefox as well as any other software using `wgpu` to render +content into a texture but not to present that texture into a window. +*/ + +use crate::{Adapter, Device, DeviceDescriptor, InstanceDescriptor, InstanceFlags, Trace}; diff --git a/wgpu/src/documentation/debugging/mod.rs b/wgpu/src/documentation/debugging/mod.rs new file mode 100644 index 000000000..d3924c351 --- /dev/null +++ b/wgpu/src/documentation/debugging/mod.rs @@ -0,0 +1,11 @@ +/*! +Debugging + +Tools and techniques for investigating correctness, validation, and +performance problems in `wgpu` applications. +*/ + +pub mod debugging_applications; +pub mod performance; +pub mod vulkan_validation_layers; +pub mod xcode; diff --git a/wgpu/src/documentation/debugging/performance.rs b/wgpu/src/documentation/debugging/performance.rs new file mode 100644 index 000000000..7888ab5be --- /dev/null +++ b/wgpu/src/documentation/debugging/performance.rs @@ -0,0 +1,16 @@ +/*! +# Debugging Performance Issues + +If you're encountering performance problems, here's a checklist: + +- Are you building with `--release`? (Don't laugh!) Development-profile + builds trade overhead for diagnostic ability: + - [`InstanceFlags::DEBUG`] is set by default in development builds, which + enables platform-level validation, like the Vulkan validation layers. + - The Rust compiler doesn't optimize the generated machine code. + - Development builds have more assertions enabled. + +Please add more checklist items, based on your experience. +*/ + +use crate::InstanceFlags; diff --git a/wgpu/src/documentation/debugging/vulkan_validation_layers.rs b/wgpu/src/documentation/debugging/vulkan_validation_layers.rs new file mode 100644 index 000000000..20acbe16f --- /dev/null +++ b/wgpu/src/documentation/debugging/vulkan_validation_layers.rs @@ -0,0 +1,57 @@ +/*! +# Enabling Vulkan Validation Layers + +When developing an application it is often useful to enable Vulkan's +validation layers. They can catch errors when you are using the API +incorrectly or exceeding device limits. You can read more about validation +layers here: . + +Validation layers are a Vulkan-only feature, so they cannot be used with +other backends. You can restrict which backends `wgpu` uses via +[`InstanceDescriptor`] and [`Backends`]. + +## Installation + +For validation layers to work you need to install the Vulkan SDK: + +### Linux + +Visit to install the Vulkan SDK along with +some validation layers. Click the "Latest Supported Release" button (which +looks like it's just a header, but it is in fact a button) and follow the +instructions. + +### Other operating systems + +TODO. + +## Enabling validation layers + +`wgpu` enables validation layers automatically in most cases when the +application is compiled in debug mode (that is, if the `--release` flag is +*not* passed to `cargo`), because [`InstanceFlags::DEBUG`] is set by default +in development builds. You can also enable them explicitly with +[`InstanceFlags::VALIDATION`], or by setting the environment variable +`VK_INSTANCE_LAYERS=VK_LAYER_KHRONOS_validation`. + +The validation layers use normal Rust logging functionality, which also +needs to be enabled. The `wgpu` examples use the +[`env_logger`](https://crates.io/crates/env_logger) crate for logging, which +means you can enable validation-layer logging by setting an environment +variable: + +```bash +env RUST_LOG=trace cargo run --bin wgpu-examples cube +``` + +There are several logging levels (see for +more info), with `trace` being the highest. If you choose a lower level such +as `info`, then fewer messages will be logged. + +If you want to enable validation layers in your own application, make sure +it has logging configured. The +[`env_logger`](https://crates.io/crates/env_logger) crate is one possible +way to do this. +*/ + +use crate::{Backends, InstanceDescriptor, InstanceFlags}; diff --git a/wgpu/src/documentation/debugging/xcode.rs b/wgpu/src/documentation/debugging/xcode.rs new file mode 100644 index 000000000..c7cb7eb0f --- /dev/null +++ b/wgpu/src/documentation/debugging/xcode.rs @@ -0,0 +1,80 @@ +#![doc = crate::macros::doc_image!("xcode-new-project.webp")] +#![doc = crate::macros::doc_image!("xcode-project-type.webp")] +#![doc = crate::macros::doc_image!("xcode-build-tool.webp")] +#![doc = crate::macros::doc_image!("xcode-edit-scheme.webp")] +#![doc = crate::macros::doc_image!("xcode-scheme-options.webp")] +#![doc = crate::macros::doc_image!("xcode-scheme-arguments.webp")] +#![doc = crate::macros::doc_image!("xcode-select-binary.webp")] +#![doc = crate::macros::doc_image!("xcode-play-button.webp")] +#![doc = crate::macros::doc_image!("xcode-attached.webp")] +#![doc = crate::macros::doc_image!("xcode-start-capture.webp")] +/*! +# Debugging with Xcode (Metal GPU Capture) + +Xcode provides powerful Metal GPU capture and shader debugging tools. This +page walks through attaching Xcode to a `wgpu` application so you can enable +Metal validation and capture frames. + +A Chinese version is also available: +[使用 Xcode 调试 wgpu 程序](https://jinleili.github.io/learn-wgpu-zh/integration-and-debugging/ios/#xcode-%E4%B8%8E-metal). + +First we'll start by opening Xcode and creating a new project using the menu +or "Create a new Xcode project" in the startup dialog. + +![Xcode startup dialog][xcode-new-project.webp] + +Select "External Build System" as the project type. + +![Xcode project type][xcode-project-type.webp] + +Choose which build tool to use in the "Build Tool" field. This will be +called whenever we build in Xcode. + +We can write our `cargo` build command here if we'd like Xcode to run it, +but we could also skip the build step to avoid Xcode building the project +for us. + +It's possible to skip the build step by specifying our build command as +`ls`, `echo`, or anything else that exits successfully (note: `:` doesn't +appear to work here). + +The rest of the fields don't actually matter to us, so we can put any values +there. + +![Xcode build tool][xcode-build-tool.webp] + +Click on the project name and then click "Edit Scheme". + +![Xcode edit scheme][xcode-edit-scheme.webp] + +Under the "Options" tab we can choose the level of validation for Metal and +whether to enable GPU frame capture. + +![Xcode scheme options][xcode-scheme-options.webp] + +Under the "Arguments" tab we'll choose which executable to run. We want this +to be the binary created by `cargo`. We'll select "Other" and then find the +binary in the target directory. + +![Xcode scheme arguments][xcode-scheme-arguments.webp] + +![Xcode select binary][xcode-select-binary.webp] + +Next we'll click the play button to run our binary and attach Xcode to it. + +![Xcode play button][xcode-play-button.webp] + +Now we should see our application running and some output telling us that +Metal validation has been enabled. + +![Xcode attached][xcode-attached.webp] + +To start a GPU capture, click the camera button while Xcode is attached to +our running application. + +![Xcode start capture][xcode-start-capture.webp] + +After a frame has been captured, we will be able to use all the regular +Metal tools (e.g. shader debugging, GPU statistics, etc.). + +*/ diff --git a/docs/api-specs/cooperative_matrix.md b/wgpu/src/documentation/extensions/cooperative_matrices.rs similarity index 95% rename from docs/api-specs/cooperative_matrix.md rename to wgpu/src/documentation/extensions/cooperative_matrices.rs index 20dbd3a39..335c11482 100644 --- a/docs/api-specs/cooperative_matrix.md +++ b/wgpu/src/documentation/extensions/cooperative_matrices.rs @@ -1,8 +1,7 @@ -# Cooperative Matrix Extensions +/*! +# 🧪Experimental🧪 Cooperative Matrix Extensions -🧪Experimental🧪 - -`wgpu` supports an experimental cooperative matrix feature when `Features::EXPERIMENTAL_COOPERATIVE_MATRIX` is enabled. +`wgpu` supports an experimental cooperative matrix feature when [`Features::EXPERIMENTAL_COOPERATIVE_MATRIX`] is enabled. This exposes hardware-accelerated matrix multiply-accumulate (MMA) operations (for example, NVIDIA tensor cores, Metal SIMD-group matrices, and Vulkan `VK_KHR_cooperative_matrix`). @@ -63,7 +62,7 @@ Each `CooperativeMatrixProperties` describes a single supported configuration. F Example usage: -```/dev/null/cooperative-matrix-host.rs#L1-40 +```ignore let coop_props = adapter.cooperative_matrix_properties(); for prop in &coop_props { println!( @@ -77,7 +76,7 @@ for prop in &coop_props { You **must**: -1. Enable `Features::EXPERIMENTAL_COOPERATIVE_MATRIX` on the `Device`. +1. Enable [`Features::EXPERIMENTAL_COOPERATIVE_MATRIX`] on the `Device`. 2. Query `adapter.cooperative_matrix_properties()` and ensure that the configuration(s) you intend to use in WGSL are actually available on the running adapter/backend. 3. Treat the sizes and types as a contract between your shaders and the underlying hardware implementation. @@ -90,7 +89,7 @@ You **must**: ### `wgpu` feature - Using cooperative matrices requires enabling: - - `Features::EXPERIMENTAL_COOPERATIVE_MATRIX` + - [`Features::EXPERIMENTAL_COOPERATIVE_MATRIX`] This feature may be restricted to certain backends and hardware. @@ -107,7 +106,7 @@ These are general guidelines, not a complete compatibility matrix: - Requires the `VK_KHR_cooperative_matrix` extension. - Many NVIDIA and AMD GPUs support `f16` at 16×16 tile sizes and similar. - 8×8 `f32` support is hardware-dependent. - - Exact configurations are enumerated by `Adapter::cooperative_matrix_properties()`. + - Exact configurations are enumerated by [`Adapter::cooperative_matrix_properties()`]. - **Other backends**: - May not support cooperative matrices at all. In that case the feature will not be exposed, and @@ -156,7 +155,7 @@ may change; the details below describe the intended semantics. Any WGSL program using cooperative matrices must declare an extension at the top of the shader, for example: -```/dev/null/example.wgsl#L1-3 +```wgsl enable wgpu_cooperative_matrix; ``` @@ -175,7 +174,7 @@ A cooperative matrix is a value type parameterized by: Conceptually: -```/dev/null/example.wgsl#L1-8 +```wgsl // A: MxK, B: KxN, C: MxN type coop_matMxN; type coop_matMxN; @@ -185,7 +184,7 @@ type coop_matMxN; Concrete examples (sizes and types must match a supported configuration from `Adapter::cooperative_matrix_properties`): -```/dev/null/example.wgsl#L10-20 +```wgsl // 8x8 single-precision tiles alias CoopMatA = coop_mat8x8; alias CoopMatB = coop_mat8x8; @@ -233,7 +232,7 @@ select the memory layout: `stride` is the number of elements between adjacent rows. This is the natural fit for C-style `ptr[i * num_cols + j]` storage. -```/dev/null/example.wgsl#L1-10 +```wgsl fn coopLoad( ptr: ptr, // base pointer to scalar or vector elements stride: u32 // elements between adjacent columns @@ -260,7 +259,7 @@ selection mirrors the load builtins: - `coopStore` — writes **column-major**; `stride` between columns. - `coopStoreT` — writes **row-major**; `stride` between rows. -```/dev/null/example.wgsl#L12-23 +```wgsl fn coopStore( value: coop_matMxN, ptr: ptr, @@ -282,7 +281,7 @@ fn coopStoreT( Perform a matrix multiply-accumulate operation on cooperative matrices: -```/dev/null/example.wgsl#L15-23 +```wgsl fn coopMultiplyAdd( a: coop_matMAxKA, // A: MAxKA tile b: coop_matKBxNB, // B: KBxNB tile (KB == KA) @@ -302,7 +301,7 @@ Semantics: For example, with a supported configuration: -```/dev/null/example.wgsl#L25-39 +```wgsl enable wgpu_cooperative_matrix; alias MatA = coop_mat8x8; @@ -354,7 +353,7 @@ For portable code: Example: -```/dev/null/example.wgsl#L1-42 +```wgsl enable wgpu_cooperative_matrix; struct Matrices { @@ -405,7 +404,7 @@ Implementations must validate the following where possible: - The `wgpu_cooperative_matrix` WGSL extension is enabled if any cooperative matrix types or builtins are used. - Tile sizes `(M, N, K)` and scalar types `(ab_type, cr_type)` match at least one - `CooperativeMatrixProperties` entry for the current adapter/backend. + [`CooperativeMatrixProperties`] entry for the current adapter/backend. - Workgroup size, shader stage, and other pipeline configuration constraints required by the backend are satisfied. @@ -413,7 +412,7 @@ The following are examples of **undefined behavior** (non-exhaustive): - Using cooperative matrix operations without enabling the WGSL extension. - Using a cooperative matrix type `(M, N, T, R)` not supported by - `Adapter::cooperative_matrix_properties()`. + [`Adapter::cooperative_matrix_properties()`]. - Mismatching sizes or roles in `coopMultiplyAdd` (e.g. incompatible M/N/K, or incorrect roles). - Executing `coopLoad` / `coopLoadT`, `coopStore` / `coopStoreT`, or `coopMultiplyAdd` in divergent control flow within the cooperating execution group. @@ -451,7 +450,7 @@ Key points from the example: - Workgroup size is chosen so that all cooperative operations are well-defined and efficient for 8×8 tiles. - Host-side code: - - Enables `Features::EXPERIMENTAL_COOPERATIVE_MATRIX`. + - Enables [`Features::EXPERIMENTAL_COOPERATIVE_MATRIX`]. - Queries `cooperative_matrix_properties` and verifies that 8×8 `f32` or chosen configuration is supported. - Dispatches the compute pipeline with appropriate grid dimensions. @@ -466,3 +465,7 @@ Key points from the example: - Avoid divergent control flow around cooperative operations. - Consider providing a fallback non-cooperative implementation for devices that do not support the feature. - This is an experimental extension; API and semantics may change across versions of `wgpu` and `naga`. + +*/ + +use crate::{Adapter, CooperativeMatrixProperties, Features}; diff --git a/docs/api-specs/mesh_shading.md b/wgpu/src/documentation/extensions/mesh_shading.rs similarity index 90% rename from docs/api-specs/mesh_shading.md rename to wgpu/src/documentation/extensions/mesh_shading.rs index 4b9e7a741..d0ef2762a 100644 --- a/docs/api-specs/mesh_shading.md +++ b/wgpu/src/documentation/extensions/mesh_shading.rs @@ -1,8 +1,7 @@ -# Mesh Shader Extensions +/*! +# 🧪Experimental🧪 Mesh Shading -🧪Experimental🧪 - -`wgpu` supports an experimental version of mesh shading when `Features::EXPERIMENTAL_MESH_SHADER` is enabled. +`wgpu` supports an experimental version of mesh shading when [`Features::EXPERIMENTAL_MESH_SHADER`] is enabled. The status of the implementation is documented in [the mesh-shading issue](https://github.com/gfx-rs/wgpu/issues/7197). **Note**: The features documented here may have major bugs in them and are expected to be subject @@ -69,19 +68,20 @@ With the current pipeline set to a mesh pipeline, a draw command like ### New `wgpu` functions -`Device::create_mesh_pipeline` - Creates a mesh shader pipeline. This is very similar to creating a standard render pipeline, except that it takes a mesh shader state and optional task shader state instead of a vertex state. If the task state is omitted, during rendering the number of workgroups is passed directly from the draw call to the mesh shader state, with an empty payload. +[`Device::create_mesh_pipeline`] - Creates a mesh shader pipeline. This is very similar to creating a standard render pipeline, except that it takes a mesh shader state and optional task shader state instead of a vertex state. If the task state is omitted, during rendering the number of workgroups is passed directly from the draw call to the mesh shader state, with an empty payload. -`RenderPass::draw_mesh_tasks` - Dispatches the mesh shader pipeline. This ignores render pipeline specific information, such as vertex buffer bindings and index buffer bindings. The dispatch size must adhere to the limits described below. +[`RenderPass::draw_mesh_tasks`] - Dispatches the mesh shader pipeline. This ignores render pipeline specific information, such as vertex buffer bindings and index buffer bindings. The dispatch size must adhere to the limits described below. -`RenderPass::draw_mesh_tasks_indirect`, `RenderPass::multi_draw_mesh_tasks_indirect` and `RenderPass::multi_draw_mesh_tasks_indirect_count` - Dispatches the mesh shader pipeline with dispatch size taken from a buffer. This ignores render pipeline specific information, such as vertex buffer bindings and index buffer bindings. The dispatch size must adhere to the limits described below. Analogous to `draw_indirect`, `multi_draw_indirect` and `multi_draw_indirect_count`. Requires the corresponding indirect feature to be enabled. +[`RenderPass::draw_mesh_tasks_indirect`], [`RenderPass::multi_draw_mesh_tasks_indirect`] and [`RenderPass::multi_draw_mesh_tasks_indirect_count`] - Dispatches the mesh shader pipeline with dispatch size taken from a buffer. This ignores render pipeline specific information, such as vertex buffer bindings and index buffer bindings. The dispatch size must adhere to the limits described below. Analogous to `draw_indirect`, `multi_draw_indirect` and `multi_draw_indirect_count`. Requires the corresponding indirect feature to be enabled. -An example of using mesh shaders to render a single triangle can be seen [here](../../examples/features/src/mesh_shader). +An example of using mesh shaders to render a single triangle can be seen +[here](https://github.com/gfx-rs/wgpu/tree/trunk/examples/features/src/mesh_shader). ### Features -- Using mesh shaders requires enabling `Features::EXPERIMENTAL_MESH_SHADER`. -- Using mesh shaders with multiview requires enabling `Features::EXPERIMENTAL_MESH_SHADER_MULTIVIEW`. -- Using mesh shaders with point primitives requires enabling `Features::EXPERIMENTAL_MESH_SHADER_POINTS`. +- Using mesh shaders requires enabling [`Features::EXPERIMENTAL_MESH_SHADER`]. +- Using mesh shaders with multiview requires enabling [`Features::EXPERIMENTAL_MESH_SHADER_MULTIVIEW`]. +- Using mesh shaders with point primitives requires enabling [`Features::EXPERIMENTAL_MESH_SHADER_POINTS`]. - Queries are unsupported - Primitive index support will be added once support lands in for them in general. @@ -280,3 +280,7 @@ fn fs_main(vertex: VertexOutput, primitive: PrimitiveInput) -> @location(0) vec4 return vertex.color * primitive.colorMask; } ``` + +*/ + +use crate::{Device, Features, RenderPass}; diff --git a/wgpu/src/documentation/extensions/mod.rs b/wgpu/src/documentation/extensions/mod.rs new file mode 100644 index 000000000..eb34702f8 --- /dev/null +++ b/wgpu/src/documentation/extensions/mod.rs @@ -0,0 +1,7 @@ +/*! +Extensions to the WebGPU API +*/ + +pub mod cooperative_matrices; +pub mod mesh_shading; +pub mod ray_tracing; diff --git a/docs/api-specs/ray_tracing.md b/wgpu/src/documentation/extensions/ray_tracing.rs similarity index 91% rename from docs/api-specs/ray_tracing.md rename to wgpu/src/documentation/extensions/ray_tracing.rs index 10842d93d..9976c7516 100644 --- a/docs/api-specs/ray_tracing.md +++ b/wgpu/src/documentation/extensions/ray_tracing.rs @@ -1,10 +1,9 @@ -# Ray Tracing Extensions - -🧪Experimental🧪 +/*! +# 🧪Experimental🧪 Ray Tracing `wgpu` supports an experimental version of ray tracing which is subject to change. The extensions allow for acceleration structures to be created and built (with -`Features::EXPERIMENTAL_RAY_QUERY` enabled) and interacted with in shaders. Currently `naga` only supports ray queries -(accessible with `Features::EXPERIMENTAL_RAY_QUERY` enabled in wgpu). +[`Features::EXPERIMENTAL_RAY_QUERY`] enabled) and interacted with in shaders. Currently `naga` only supports ray queries +(accessible with [`Features::EXPERIMENTAL_RAY_QUERY`] enabled in wgpu). **Note**: The features documented here may have major bugs in them and are expected to be subject to breaking changes, suggestions for the API exposed by this should be posted on [the ray-tracing issue](https://github.com/gfx-rs/wgpu/issues/1040). @@ -18,7 +17,7 @@ an [introduction](https://developer.nvidia.com/blog/introduction-nvidia-rtx-dire The documentation and specific details of the functions and structures provided can be found with their definitions. -Acceleration structures do not have a separate feature, instead they are enabled by `Features::EXPERIMENTAL_RAY_QUERY`, unlike vulkan. +Acceleration structures do not have a separate feature, instead they are enabled by [`Features::EXPERIMENTAL_RAY_QUERY`], unlike vulkan. When ray tracing pipelines are added, that feature will also enable acceleration structures. A [`Blas`] can be created with [`Device::create_blas`]. @@ -72,7 +71,7 @@ Some memory is allocated when building to be "scratch" data (a temporary buffer the build) and instance staging memory (to copy the instances to the GPU). The some of this can be reused for between the [`Blas`] and [`Tlas`] builds so in general it is advisable to try and integrate the builds together. Because building is slow, it should be done as few times as possible. For moving geometry (players, particles, etc.), use -[`PREFER_FAST_BUILD`](https://wgpu.rs/doc/wgpu_hal/struct.AccelerationStructureBuildFlags.html#associatedconstant.PREFER_FAST_BUILD) +[`AccelerationStructureFlags::PREFER_FAST_BUILD`](wgt::AccelerationStructureFlags::PREFER_FAST_BUILD) to speed up builds. Updating (performing a partial rebuild) is currently unsupported, but may be implemented in the future. You should compact any geometry which will not change (e.g. static level geometry) once it has been built. @@ -80,7 +79,7 @@ future. You should compact any geometry which will not change (e.g. static level Once a [`Blas`] has been built, it can be compacted. Acceleration structures are allocated conservatively, without knowing the exact data that is inside them. Once a [`Blas`] has been built, the driver can make data specific -optimisations to make the [`BLAS`] smaller. To begin compaction call [`Blas::prepare_compaction_async`] on it. This +optimisations to make the [`Blas`] smaller. To begin compaction call [`Blas::prepare_compaction_async`] on it. This method waits until all builds operating on the [`Blas`] are finished, prepares the [`Blas`] to be compacted, and runs the given callback. To check whether the [`Blas`] is ready, you can also call [`Blas::ready_for_compaction`] instead of waiting for the callback (useful if you are asynchronously compacting a large number of [`Blas`]es). Submitting a @@ -95,44 +94,38 @@ An example of compaction being run when [`Blas`]es are ready, this would be in a problem, otherwise (e.g. if you get an out of memory error) you should compact immediately (and switching all non-compacted [`Blas`]es to compacted ones). -```rust +```no_run +# let queue: wgpu::Queue = unimplemented!(); +# let device: wgpu::Device = unimplemented!(); +# let mut tlas: wgpu::Tlas = unimplemented!(); use std::iter; use wgpu::Blas; struct BlasToBeCompacted { blas: Blas, - /// The index into the TlasInstance this BLAS is used in. + /// The index into the TLAS instance this BLAS is used in. tlas_index: usize, } -fn render(/*whatever args you need to render*/) { - /* additional code to prepare the renderer */ - //An iterator of whatever BLASes you have called `prepare_compaction_async` on. - let blas_s_pending_compaction: impl Iterator = iter::empty(); - for blas_to_be_compacted in blas_s_pending_compaction { +// An iterator over whatever BLASes you have called `prepare_compaction_async` on. +let blas_s_pending_compaction = iter::empty::(); +for blas_to_be_compacted in blas_s_pending_compaction { if blas_to_be_compacted.blas.ready_for_compaction() { let compacted_blas = queue.compact_blas(&blas_to_be_compacted.blas); - tlas_instance[blas_to_be_compacted.tlas_index].set_blas(&compacted_blas); + tlas[blas_to_be_compacted.tlas_index] + .as_mut() + .unwrap() + .set_blas(&compacted_blas); } - } - let mut encoder = - device.create_command_encoder(&wgpu::CommandEncoderDescriptor { label: None }); - /* do other preparations on the TlasInstance.*/ - encoder.build_acceleration_structures(iter::empty(), iter::once(&tlas_package)); - /* more render code */ - queue.submit([encoder.finish()]); } +let mut encoder = + device.create_command_encoder(&wgpu::CommandEncoderDescriptor { label: None }); +// do any other preparations on the TLAS here +encoder.build_acceleration_structures(iter::empty(), iter::once(&tlas)); +// more render code +queue.submit([encoder.finish()]); ``` -[`Device::create_blas`]: https://wgpu.rs/doc/wgpu/struct.Device.html#method.create_blas -[`CommandEncoder::build_acceleration_structures`]: https://wgpu.rs/doc/wgpu/struct.CommandEncoder.html#method.build_acceleration_structures -[`Device::create_tlas`]: https://wgpu.rs/doc/wgpu/struct.Device.html#method.create_tlas -[`Tlas`]: https://wgpu.rs/doc/wgpu/struct.Tlas.html -[`Blas`]: https://wgpu.rs/doc/wgpu/struct.Blas.html -[`TlasInstance`]: https://wgpu.rs/doc/wgpu/struct.TlasInstance.html -[`Blas::prepare_compaction_async`]: https://wgpu.rs/doc/wgpu/struct.Blas.html#method.prepare_compaction_async -[`Blas::ready_for_compaction`]: https://wgpu.rs/doc/wgpu/struct.Blas.html#method.ready_for_compaction -[`Queue::compact_blas`]: https://wgpu.rs/doc/wgpu/struct.Queue.html#method.compact_blas ## `naga`'s raytracing API: @@ -409,3 +402,7 @@ These are tags that can be added to a acceleration structure (`acceleration_stru | Tag | Requirements | Description | | --------------- | ------------------------------------- | ---------------------------------------------------------------------- | | `vertex_return` | `enable wgpu_ray_query_vertex_return` | Allows getting the vertices of the hit triangle when using ray queries | + +*/ + +use crate::{Blas, CommandEncoder, Device, Features, Queue, Tlas, TlasInstance}; diff --git a/wgpu/src/documentation/features.rs b/wgpu/src/documentation/features.rs new file mode 100644 index 000000000..9c177b14e --- /dev/null +++ b/wgpu/src/documentation/features.rs @@ -0,0 +1,16 @@ +/*! +## Feature flags +*/ +#![doc = document_features::document_features!()] +/*! + +### Feature Aliases + +These features aren't actually features on the crate itself, but a convenient shorthand for +complicated cases. + +- **`wgpu_core`** --- Enabled when there is any non-webgpu backend enabled on the platform. +- **`naga`** --- Enabled when target `glsl` or `spirv` input is enabled, or when `wgpu_core` is enabled. +*/ + +use crate::Adapter; diff --git a/wgpu/src/documentation/getting_started/learning_wgpu.rs b/wgpu/src/documentation/getting_started/learning_wgpu.rs new file mode 100644 index 000000000..86e25179a --- /dev/null +++ b/wgpu/src/documentation/getting_started/learning_wgpu.rs @@ -0,0 +1,80 @@ +/*! +# Learning wgpu: Key Concepts and Resources + +If you are new to `wgpu` and graphics programming, this page collects +external learning resources and a primer on the core concepts of the API. + +## External resources + +Learning materials: + +- [Learn Wgpu tutorial](https://sotrh.github.io/learn-wgpu/) +- [Draw You a Triangle for Great Good](https://github.com/dwbrite/wgpu-rendering-project/wiki/Draw-You-a-Triangle-for-Great-Good) +- Chinese version of [学习 wgpu](https://jinleili.github.io/learn-wgpu-zh/) +- [GPU Architecture](https://docs.google.com/presentation/d/1qi2j-SZuzew7Rrf5VKEPDZAQQEitV40k9fKvwJNyicM/edit), + a presentation by Kangz on how GPUs work under the hood. + +Reference material: + +- The `wgpu` examples; see + [Running the Examples](crate::documentation::getting_started::running_the_examples). +- The [WebGPU specification](https://www.w3.org/TR/webgpu/), which `wgpu` + follows closely. + +Runtimes: + +- The [Deno](https://deno.land/) JS/TS runtime. + +## Important concepts + +### Device and Queue + +- [`Device`] + - All resource creation. + - All of its methods take `&self` (no `&mut`!). +- [`Queue`] + - All GPU work submission. + +_Typically_ both are created once on startup, one of each. A [`Device`] is +created with a set of [`Features`] and [`Limits`], which are enforced +independently of the underlying hardware's actual capabilities (e.g. texture +size and formats, number of bound resources, native extensions, …). + +### Relationship of [`RenderPipeline`]s and resource binding + +A slightly simplified overview of what you need to set up before rendering a +frame. + +*/ +#![doc = include_str!("../images/render-pipeline-and-resource-binding.svg")] +/*! + +- _Round boxes:_ temporary descriptor structs. +- _Cornered boxes:_ resources created from a [`Device`]. +- _Bold:_ what you deal with on a per-frame basis. + +Each [`BindGroupLayoutEntry`] has a (mostly) corresponding +[`BindingResource`]. Compute pipelines follow a similar pattern. + +### Drawing a "frame" + +A simplified overview of what you need to do to draw a frame. + +*/ +#![doc = include_str!("../images/life-of-a-frame.svg")] +/*! + +- _Full lines:_ needed for creation. +- _Dashed lines:_ provided as "information". + +[`CommandEncoder::finish`] consumes a [`CommandEncoder`] and produces a +[`CommandBuffer`]; [`Queue::submit`] consumes [`CommandBuffer`]s. The +[`TextureView`] on a [`RenderPassColorAttachment`] can come from a +[`Surface`] — a special target for the final output. + +*/ + +use crate::{ + BindGroupLayoutEntry, BindingResource, CommandBuffer, CommandEncoder, Device, Features, Limits, + Queue, RenderPassColorAttachment, RenderPipeline, Surface, TextureView, +}; diff --git a/wgpu/src/documentation/getting_started/mod.rs b/wgpu/src/documentation/getting_started/mod.rs new file mode 100644 index 000000000..5dc30681e --- /dev/null +++ b/wgpu/src/documentation/getting_started/mod.rs @@ -0,0 +1,9 @@ +/*! +Getting Started + +First steps for new `wgpu` users: running the bundled examples and learning +the core concepts of the API. +*/ + +pub mod learning_wgpu; +pub mod running_the_examples; diff --git a/wgpu/src/documentation/getting_started/running_the_examples.rs b/wgpu/src/documentation/getting_started/running_the_examples.rs new file mode 100644 index 000000000..78f52c839 --- /dev/null +++ b/wgpu/src/documentation/getting_started/running_the_examples.rs @@ -0,0 +1,39 @@ +/*! +# Running the Examples + +This section shows you how to get the dependencies needed to run the +examples included in the `wgpu` repository. + +## Dependencies + +The examples require: + +- The Rust compiler ([installation instructions](https://www.rust-lang.org/)). +- Drivers for your graphics card. Note that some platforms have multiple + possible driver backends (e.g. D3D12 or Vulkan on Windows). +- Git ([installation instructions](https://git-scm.com/downloads)). + +## Cloning + +Once you have the tools above, clone the repository: + +```bash +git clone --depth 1 https://github.com/gfx-rs/wgpu.git +cd wgpu +``` + +## Running the examples + +You can run the examples using the `wgpu-examples` binary: + +```bash +# Show a list of all examples +cargo run --bin wgpu-examples + +# Run the cube example +cargo run --bin wgpu-examples cube +``` + +To run an example in a browser, see +[Running on the Web](crate::documentation::platforms::web). +*/ diff --git a/wgpu/src/documentation/images/architecture.excalidraw b/wgpu/src/documentation/images/architecture.excalidraw new file mode 100644 index 000000000..1bd827d23 --- /dev/null +++ b/wgpu/src/documentation/images/architecture.excalidraw @@ -0,0 +1,1309 @@ +{ + "type": "excalidraw", + "version": 2, + "source": "https://excalidraw.com", + "elements": [ + { + "id": "gSlk-KZ0az3xLtYVwpV6n", + "type": "rectangle", + "x": 762.5, + "y": 67.5, + "width": 284.5, + "height": 79.5, + "angle": 0, + "strokeColor": "#1e1e1e", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 1, + "opacity": 100, + "groupIds": [], + "frameId": null, + "index": "a0", + "roundness": { + "type": 3 + }, + "seed": 2055822768, + "version": 94, + "versionNonce": 1654394288, + "isDeleted": false, + "boundElements": [ + { + "type": "text", + "id": "EOJeNDRI9VCo58buyL0ht" + } + ], + "updated": 1761262529866, + "link": null, + "locked": false + }, + { + "id": "EOJeNDRI9VCo58buyL0ht", + "type": "text", + "x": 811.4166641235352, + "y": 82.25, + "width": 186.6666717529297, + "height": 50, + "angle": 0, + "strokeColor": "#1e1e1e", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 1, + "opacity": 100, + "groupIds": [], + "frameId": null, + "index": "a0V", + "roundness": null, + "seed": 1480859472, + "version": 78, + "versionNonce": 432754096, + "isDeleted": false, + "boundElements": null, + "updated": 1761262464679, + "link": null, + "locked": false, + "text": "wgpu:\nidiomatic Rust API", + "fontSize": 20, + "fontFamily": 5, + "textAlign": "center", + "verticalAlign": "middle", + "containerId": "gSlk-KZ0az3xLtYVwpV6n", + "originalText": "wgpu:\nidiomatic Rust API", + "autoResize": true, + "lineHeight": 1.25 + }, + { + "id": "FexGSk3-7wSIZh1r6oK_B", + "type": "rectangle", + "x": 426, + "y": 222.484375, + "width": 493, + "height": 135, + "angle": 0, + "strokeColor": "#1e1e1e", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 1, + "opacity": 100, + "groupIds": [], + "frameId": null, + "index": "a3", + "roundness": { + "type": 3 + }, + "seed": 1995068752, + "version": 515, + "versionNonce": 1165187920, + "isDeleted": false, + "boundElements": [ + { + "type": "text", + "id": "UouP4CTsZUCXlkRHTlbuY" + }, + { + "id": "_CcUJ7FiICG5sRW4dEznb", + "type": "arrow" + }, + { + "id": "e4IIKq6IKfX_zal-YK48U", + "type": "arrow" + }, + { + "id": "jBIVwmVeHfZE3pROh984s", + "type": "arrow" + } + ], + "updated": 1761263008536, + "link": null, + "locked": false + }, + { + "id": "UouP4CTsZUCXlkRHTlbuY", + "type": "text", + "x": 565.0500030517578, + "y": 239.984375, + "width": 214.89999389648438, + "height": 100, + "angle": 0, + "strokeColor": "#1e1e1e", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 1, + "opacity": 100, + "groupIds": [], + "frameId": null, + "index": "a3V", + "roundness": null, + "seed": 330572208, + "version": 580, + "versionNonce": 218960304, + "isDeleted": false, + "boundElements": null, + "updated": 1761264516061, + "link": null, + "locked": false, + "text": "wgpu_core:\nbullet-proof validation\nresource tracking\nFFI-friendly API", + "fontSize": 20, + "fontFamily": 5, + "textAlign": "center", + "verticalAlign": "middle", + "containerId": "FexGSk3-7wSIZh1r6oK_B", + "originalText": "wgpu_core:\nbullet-proof validation\nresource tracking\nFFI-friendly API", + "autoResize": true, + "lineHeight": 1.25 + }, + { + "id": "G8sPC5weFJhSc7UjcJaLU", + "type": "rectangle", + "x": 1060.5, + "y": 224.484375, + "width": 379.5, + "height": 80.99999999999999, + "angle": 0, + "strokeColor": "#1e1e1e", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 1, + "opacity": 100, + "groupIds": [], + "frameId": null, + "index": "a5", + "roundness": { + "type": 3 + }, + "seed": 228774832, + "version": 404, + "versionNonce": 1105650096, + "isDeleted": false, + "boundElements": [ + { + "type": "text", + "id": "0bdIE_MQ-mrOJpOh8iswL" + }, + { + "id": "jaDpPhStncec9MyqMnCVB", + "type": "arrow" + } + ], + "updated": 1761262545685, + "link": null, + "locked": false + }, + { + "id": "0bdIE_MQ-mrOJpOh8iswL", + "type": "text", + "x": 1073.4166717529297, + "y": 239.984375, + "width": 353.6666564941406, + "height": 50, + "angle": 0, + "strokeColor": "#1e1e1e", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 1, + "opacity": 100, + "groupIds": [], + "frameId": null, + "index": "a6", + "roundness": null, + "seed": 1939502512, + "version": 390, + "versionNonce": 2147429296, + "isDeleted": false, + "boundElements": null, + "updated": 1761262545685, + "link": null, + "locked": false, + "text": "WebGPU backend\n(in browser, when compiled to WASM)", + "fontSize": 20, + "fontFamily": 5, + "textAlign": "center", + "verticalAlign": "middle", + "containerId": "G8sPC5weFJhSc7UjcJaLU", + "originalText": "WebGPU backend\n(in browser, when compiled to WASM)", + "autoResize": true, + "lineHeight": 1.25 + }, + { + "id": "_CcUJ7FiICG5sRW4dEznb", + "type": "arrow", + "x": 829.7597162706998, + "y": 145.734375, + "width": 189.7063666979443, + "height": 74.49999999999997, + "angle": 0, + "strokeColor": "#1e1e1e", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 1, + "opacity": 100, + "groupIds": [], + "frameId": null, + "index": "a7", + "roundness": { + "type": 2 + }, + "seed": 1846275504, + "version": 499, + "versionNonce": 1681612112, + "isDeleted": false, + "boundElements": null, + "updated": 1761263008538, + "link": null, + "locked": false, + "points": [ + [ + 0, + 0 + ], + [ + -34.072216270699755, + 39.5 + ], + [ + -128.57221627069976, + 28 + ], + [ + -189.7063666979443, + 74.49999999999997 + ] + ], + "lastCommittedPoint": null, + "startBinding": null, + "endBinding": { + "elementId": "FexGSk3-7wSIZh1r6oK_B", + "focus": -0.3703219188512025, + "gap": 2.25 + }, + "startArrowhead": null, + "endArrowhead": "arrow", + "elbowed": false + }, + { + "id": "jaDpPhStncec9MyqMnCVB", + "type": "arrow", + "x": 980.1875, + "y": 146.734375, + "width": 180.75718517925202, + "height": 75.99999999999997, + "angle": 0, + "strokeColor": "#1e1e1e", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 1, + "opacity": 100, + "groupIds": [], + "frameId": null, + "index": "a8", + "roundness": { + "type": 2 + }, + "seed": 148690352, + "version": 428, + "versionNonce": 439287120, + "isDeleted": false, + "boundElements": null, + "updated": 1761262567378, + "link": null, + "locked": false, + "points": [ + [ + 0, + 0 + ], + [ + 41, + 36 + ], + [ + 120, + 36.5 + ], + [ + 180.75718517925202, + 75.99999999999997 + ] + ], + "lastCommittedPoint": null, + "startBinding": null, + "endBinding": { + "elementId": "G8sPC5weFJhSc7UjcJaLU", + "focus": 0.039085649989101766, + "gap": 1.75 + }, + "startArrowhead": null, + "endArrowhead": "arrow", + "elbowed": false + }, + { + "id": "h7LUtpI8Df6yQ3UQt0bOk", + "type": "rectangle", + "x": 446.6875, + "y": 647.234375, + "width": 448.5, + "height": 140, + "angle": 0, + "strokeColor": "#1e1e1e", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 1, + "opacity": 100, + "groupIds": [], + "frameId": null, + "index": "a9", + "roundness": { + "type": 3 + }, + "seed": 1256970160, + "version": 308, + "versionNonce": 1539189072, + "isDeleted": false, + "boundElements": [ + { + "type": "text", + "id": "ONs3bXwavVHVxI9l73lNw" + }, + { + "id": "e4IIKq6IKfX_zal-YK48U", + "type": "arrow" + }, + { + "id": "ZDQ74d9lauVZFTgku5F04", + "type": "arrow" + }, + { + "id": "2QeIhXNaY_JMfvtOyabKq", + "type": "arrow" + }, + { + "id": "HlAC2LtmtzcQGUTbYq9ri", + "type": "arrow" + }, + { + "id": "BHimquNEempTwqRFeLWmp", + "type": "arrow" + }, + { + "id": "Zq6XQM9FnCBckSs8jjrma", + "type": "arrow" + } + ], + "updated": 1761263229447, + "link": null, + "locked": false + }, + { + "id": "ONs3bXwavVHVxI9l73lNw", + "type": "text", + "x": 532.7208404541016, + "y": 679.734375, + "width": 276.4333190917969, + "height": 75, + "angle": 0, + "strokeColor": "#1e1e1e", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 1, + "opacity": 100, + "groupIds": [], + "frameId": null, + "index": "aA", + "roundness": null, + "seed": 930322864, + "version": 357, + "versionNonce": 1888357712, + "isDeleted": false, + "boundElements": null, + "updated": 1761264525235, + "link": null, + "locked": false, + "text": "wgpu_hal:\nportable cross-platform API\nwildly unsafe", + "fontSize": 20, + "fontFamily": 5, + "textAlign": "center", + "verticalAlign": "middle", + "containerId": "h7LUtpI8Df6yQ3UQt0bOk", + "originalText": "wgpu_hal:\nportable cross-platform API\nwildly unsafe", + "autoResize": true, + "lineHeight": 1.25 + }, + { + "id": "e4IIKq6IKfX_zal-YK48U", + "type": "arrow", + "x": 566.1875000000001, + "y": 360.234375, + "width": 65.50000000000011, + "height": 285.9999999999998, + "angle": 0, + "strokeColor": "#1e1e1e", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 1, + "opacity": 100, + "groupIds": [], + "frameId": null, + "index": "aB", + "roundness": { + "type": 2 + }, + "seed": 30269776, + "version": 872, + "versionNonce": 1592818608, + "isDeleted": false, + "boundElements": null, + "updated": 1761263229448, + "link": null, + "locked": false, + "points": [ + [ + 0, + 0 + ], + [ + -6.500000000000114, + 93.5 + ], + [ + -65.50000000000011, + 205 + ], + [ + -40.93721207248859, + 285.9999999999998 + ] + ], + "lastCommittedPoint": null, + "startBinding": { + "elementId": "FexGSk3-7wSIZh1r6oK_B", + "focus": 0.4037891448278799, + "gap": 2.75 + }, + "endBinding": { + "elementId": "h7LUtpI8Df6yQ3UQt0bOk", + "focus": -0.5057777966092336, + "gap": 1.0000000000001137 + }, + "startArrowhead": null, + "endArrowhead": "arrow", + "elbowed": false + }, + { + "id": "5fw7aivimOm_Y0eNBBFCs", + "type": "rectangle", + "x": 727.1875, + "y": 370.234375, + "width": 486.00000000000006, + "height": 109.50000000000003, + "angle": 0, + "strokeColor": "#1e1e1e", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 1, + "opacity": 100, + "groupIds": [], + "frameId": null, + "index": "aC", + "roundness": { + "type": 3 + }, + "seed": 251127632, + "version": 432, + "versionNonce": 1743327664, + "isDeleted": false, + "boundElements": [ + { + "type": "text", + "id": "8Ej1_bAepMvcsQPl1KG1P" + }, + { + "id": "jBIVwmVeHfZE3pROh984s", + "type": "arrow" + } + ], + "updated": 1761262997358, + "link": null, + "locked": false + }, + { + "id": "8Ej1_bAepMvcsQPl1KG1P", + "type": "text", + "x": 756.0708312988281, + "y": 387.484375, + "width": 428.23333740234375, + "height": 75, + "angle": 0, + "strokeColor": "#1e1e1e", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 1, + "opacity": 100, + "groupIds": [], + "frameId": null, + "index": "aD", + "roundness": null, + "seed": 1198376272, + "version": 453, + "versionNonce": 1105794896, + "isDeleted": false, + "boundElements": null, + "updated": 1761263723835, + "link": null, + "locked": false, + "text": "Naga front ends:\nparse WGSL, SPIR-V, or GLSL to IR Module\nbullet-proof validation", + "fontSize": 20, + "fontFamily": 5, + "textAlign": "center", + "verticalAlign": "middle", + "containerId": "5fw7aivimOm_Y0eNBBFCs", + "originalText": "Naga front ends:\nparse WGSL, SPIR-V, or GLSL to IR Module\nbullet-proof validation", + "autoResize": true, + "lineHeight": 1.25 + }, + { + "id": "BpumVh8D-EaEg_Q_CSATV", + "type": "rectangle", + "x": 727.1875, + "y": 515.484375, + "width": 511.00000000000006, + "height": 107.50000000000004, + "angle": 0, + "strokeColor": "#1e1e1e", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 1, + "opacity": 100, + "groupIds": [], + "frameId": null, + "index": "aE", + "roundness": { + "type": 3 + }, + "seed": 868560304, + "version": 856, + "versionNonce": 507786160, + "isDeleted": false, + "boundElements": [ + { + "type": "text", + "id": "jHNe21eMlLGqsOmVWocpV" + }, + { + "id": "ZDQ74d9lauVZFTgku5F04", + "type": "arrow" + } + ], + "updated": 1761263744496, + "link": null, + "locked": false + }, + { + "id": "jHNe21eMlLGqsOmVWocpV", + "type": "text", + "x": 734.7375030517578, + "y": 531.734375, + "width": 495.8999938964844, + "height": 75, + "angle": 0, + "strokeColor": "#1e1e1e", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 1, + "opacity": 100, + "groupIds": [], + "frameId": null, + "index": "aF", + "roundness": null, + "seed": 942929840, + "version": 983, + "versionNonce": 2106398128, + "isDeleted": false, + "boundElements": [], + "updated": 1761263761525, + "link": null, + "locked": false, + "text": "Naga back ends:\ngenerate SPIR-V, HLSL, MSL, GLSL from IR Module\ncan inject run-time validation", + "fontSize": 20, + "fontFamily": 5, + "textAlign": "center", + "verticalAlign": "middle", + "containerId": "BpumVh8D-EaEg_Q_CSATV", + "originalText": "Naga back ends:\ngenerate SPIR-V, HLSL, MSL, GLSL from IR Module\ncan inject run-time validation", + "autoResize": true, + "lineHeight": 1.25 + }, + { + "id": "jBIVwmVeHfZE3pROh984s", + "type": "arrow", + "x": 921.1875, + "y": 271.09102225030887, + "width": 68.01251687072329, + "height": 96.64335274969113, + "angle": 0, + "strokeColor": "#1e1e1e", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 1, + "opacity": 100, + "groupIds": [], + "frameId": null, + "index": "aG", + "roundness": { + "type": 2 + }, + "seed": 749384528, + "version": 218, + "versionNonce": 874947920, + "isDeleted": false, + "boundElements": null, + "updated": 1761263068970, + "link": null, + "locked": false, + "points": [ + [ + 0, + 0 + ], + [ + 41, + 34.14335274969113 + ], + [ + 68.01251687072329, + 96.64335274969113 + ] + ], + "lastCommittedPoint": null, + "startBinding": { + "elementId": "FexGSk3-7wSIZh1r6oK_B", + "focus": -0.8284860511669349, + "gap": 2.1875 + }, + "endBinding": { + "elementId": "5fw7aivimOm_Y0eNBBFCs", + "focus": 0.16408721158789183, + "gap": 2.5 + }, + "startArrowhead": "arrow", + "endArrowhead": "arrow", + "elbowed": false + }, + { + "id": "ZDQ74d9lauVZFTgku5F04", + "type": "arrow", + "x": 1044.780494368418, + "y": 627.234375, + "width": 146.90018348207195, + "height": 90.04235032134864, + "angle": 0, + "strokeColor": "#1e1e1e", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 1, + "opacity": 100, + "groupIds": [], + "frameId": null, + "index": "aH", + "roundness": { + "type": 2 + }, + "seed": 1405992368, + "version": 484, + "versionNonce": 1194264496, + "isDeleted": false, + "boundElements": null, + "updated": 1761263744497, + "link": null, + "locked": false, + "points": [ + [ + 0, + 0 + ], + [ + -81.09299436841798, + 74 + ], + [ + -146.90018348207195, + 90.04235032134864 + ] + ], + "lastCommittedPoint": null, + "startBinding": { + "elementId": "BpumVh8D-EaEg_Q_CSATV", + "focus": -0.3996551100727328, + "gap": 4.25 + }, + "endBinding": { + "elementId": "h7LUtpI8Df6yQ3UQt0bOk", + "focus": 0.44411054346969303, + "gap": 2.692810886346024 + }, + "startArrowhead": "arrow", + "endArrowhead": "arrow", + "elbowed": false + }, + { + "id": "6Hq-kz6tFvyf02RO2Nnns", + "type": "rectangle", + "x": 440.390625, + "y": 846.8125, + "width": 163.00000000000003, + "height": 55.500000000000014, + "angle": 0, + "strokeColor": "#1e1e1e", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 1, + "opacity": 100, + "groupIds": [], + "frameId": null, + "index": "aI", + "roundness": { + "type": 3 + }, + "seed": 1751719248, + "version": 196, + "versionNonce": 1514496848, + "isDeleted": false, + "boundElements": [ + { + "type": "text", + "id": "B_kPXx-OkEPJMUThIJKrp" + }, + { + "id": "2QeIhXNaY_JMfvtOyabKq", + "type": "arrow" + } + ], + "updated": 1761263196356, + "link": null, + "locked": false + }, + { + "id": "B_kPXx-OkEPJMUThIJKrp", + "type": "text", + "x": 462.6572914123535, + "y": 862.0625, + "width": 118.46666717529297, + "height": 25, + "angle": 0, + "strokeColor": "#1e1e1e", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 1, + "opacity": 100, + "groupIds": [], + "frameId": null, + "index": "aJ", + "roundness": null, + "seed": 1618275664, + "version": 100, + "versionNonce": 437471568, + "isDeleted": false, + "boundElements": null, + "updated": 1761263173206, + "link": null, + "locked": false, + "text": "Direct3D 12", + "fontSize": 20, + "fontFamily": 5, + "textAlign": "center", + "verticalAlign": "middle", + "containerId": "6Hq-kz6tFvyf02RO2Nnns", + "originalText": "Direct3D 12", + "autoResize": true, + "lineHeight": 1.25 + }, + { + "id": "RwcuXXgiWjYpjyYPqjjzL", + "type": "rectangle", + "x": 627.390625, + "y": 846.5625, + "width": 163.00000000000003, + "height": 55.500000000000014, + "angle": 0, + "strokeColor": "#1e1e1e", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 1, + "opacity": 100, + "groupIds": [], + "frameId": null, + "index": "aL", + "roundness": { + "type": 3 + }, + "seed": 1103486288, + "version": 220, + "versionNonce": 1201785776, + "isDeleted": false, + "boundElements": [ + { + "type": "text", + "id": "EQ2j_Tvkp3ctGzAV2jdvk" + }, + { + "id": "HlAC2LtmtzcQGUTbYq9ri", + "type": "arrow" + } + ], + "updated": 1761263206975, + "link": null, + "locked": false + }, + { + "id": "EQ2j_Tvkp3ctGzAV2jdvk", + "type": "text", + "x": 682.3072910308838, + "y": 861.8125, + "width": 53.16666793823242, + "height": 25, + "angle": 0, + "strokeColor": "#1e1e1e", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 1, + "opacity": 100, + "groupIds": [], + "frameId": null, + "index": "aM", + "roundness": null, + "seed": 230536016, + "version": 129, + "versionNonce": 523168592, + "isDeleted": false, + "boundElements": [], + "updated": 1761263176192, + "link": null, + "locked": false, + "text": "Metal", + "fontSize": 20, + "fontFamily": 5, + "textAlign": "center", + "verticalAlign": "middle", + "containerId": "RwcuXXgiWjYpjyYPqjjzL", + "originalText": "Metal", + "autoResize": true, + "lineHeight": 1.25 + }, + { + "id": "6KJBZm7xuDfhk8_IERv9R", + "type": "rectangle", + "x": 991.390625, + "y": 851.0625, + "width": 163.00000000000003, + "height": 55.500000000000014, + "angle": 0, + "strokeColor": "#1e1e1e", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 1, + "opacity": 100, + "groupIds": [], + "frameId": null, + "index": "aP", + "roundness": { + "type": 3 + }, + "seed": 1765068624, + "version": 240, + "versionNonce": 1105507152, + "isDeleted": false, + "boundElements": [ + { + "type": "text", + "id": "6M9sWfktMLnkwnvSIter4" + }, + { + "id": "Zq6XQM9FnCBckSs8jjrma", + "type": "arrow" + } + ], + "updated": 1761263217869, + "link": null, + "locked": false + }, + { + "id": "6M9sWfktMLnkwnvSIter4", + "type": "text", + "x": 1036.1906242370605, + "y": 866.3125, + "width": 73.4000015258789, + "height": 25, + "angle": 0, + "strokeColor": "#1e1e1e", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 1, + "opacity": 100, + "groupIds": [], + "frameId": null, + "index": "aQ", + "roundness": null, + "seed": 243164496, + "version": 164, + "versionNonce": 464954192, + "isDeleted": false, + "boundElements": [], + "updated": 1761263183292, + "link": null, + "locked": false, + "text": "OpenGL", + "fontSize": 20, + "fontFamily": 5, + "textAlign": "center", + "verticalAlign": "middle", + "containerId": "6KJBZm7xuDfhk8_IERv9R", + "originalText": "OpenGL", + "autoResize": true, + "lineHeight": 1.25 + }, + { + "id": "9V_EeI74SHitV49zxvGDE", + "type": "rectangle", + "x": 808.890625, + "y": 848.0625, + "width": 163.00000000000003, + "height": 55.500000000000014, + "angle": 0, + "strokeColor": "#1e1e1e", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 1, + "opacity": 100, + "groupIds": [], + "frameId": null, + "index": "aR", + "roundness": { + "type": 3 + }, + "seed": 781782448, + "version": 258, + "versionNonce": 1580686160, + "isDeleted": false, + "boundElements": [ + { + "type": "text", + "id": "VggrEqSBa_L00q-xPcBn2" + }, + { + "id": "BHimquNEempTwqRFeLWmp", + "type": "arrow" + } + ], + "updated": 1761263210602, + "link": null, + "locked": false + }, + { + "id": "VggrEqSBa_L00q-xPcBn2", + "type": "text", + "x": 860.8739585876465, + "y": 863.3125, + "width": 59.03333282470703, + "height": 25, + "angle": 0, + "strokeColor": "#1e1e1e", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 1, + "opacity": 100, + "groupIds": [], + "frameId": null, + "index": "aS", + "roundness": null, + "seed": 1837881264, + "version": 173, + "versionNonce": 322670928, + "isDeleted": false, + "boundElements": [], + "updated": 1761263180087, + "link": null, + "locked": false, + "text": "Vulkan", + "fontSize": 20, + "fontFamily": 5, + "textAlign": "center", + "verticalAlign": "middle", + "containerId": "9V_EeI74SHitV49zxvGDE", + "originalText": "Vulkan", + "autoResize": true, + "lineHeight": 1.25 + }, + { + "id": "2QeIhXNaY_JMfvtOyabKq", + "type": "arrow", + "x": 556.390625, + "y": 791.3125, + "width": 21.5, + "height": 53.5, + "angle": 0, + "strokeColor": "#1e1e1e", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 1, + "opacity": 100, + "groupIds": [], + "frameId": null, + "index": "aT", + "roundness": { + "type": 2 + }, + "seed": 1739146160, + "version": 103, + "versionNonce": 1869172656, + "isDeleted": false, + "boundElements": null, + "updated": 1761263229449, + "link": null, + "locked": false, + "points": [ + [ + 0, + 0 + ], + [ + -21.5, + 53.5 + ] + ], + "lastCommittedPoint": null, + "startBinding": { + "elementId": "h7LUtpI8Df6yQ3UQt0bOk", + "focus": 0.33590965478295476, + "gap": 4.078125 + }, + "endBinding": { + "elementId": "6Hq-kz6tFvyf02RO2Nnns", + "focus": 0.011272222922709026, + "gap": 2 + }, + "startArrowhead": null, + "endArrowhead": "arrow", + "elbowed": false + }, + { + "id": "HlAC2LtmtzcQGUTbYq9ri", + "type": "arrow", + "x": 664.3906249999999, + "y": 792.3125, + "width": 26.500000000000114, + "height": 52, + "angle": 0, + "strokeColor": "#1e1e1e", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 1, + "opacity": 100, + "groupIds": [], + "frameId": null, + "index": "aU", + "roundness": { + "type": 2 + }, + "seed": 2098281296, + "version": 76, + "versionNonce": 1862523312, + "isDeleted": false, + "boundElements": null, + "updated": 1761263229449, + "link": null, + "locked": false, + "points": [ + [ + 0, + 0 + ], + [ + 26.500000000000114, + 52 + ] + ], + "lastCommittedPoint": null, + "startBinding": { + "elementId": "h7LUtpI8Df6yQ3UQt0bOk", + "focus": 0.17238885857502215, + "gap": 5.078125 + }, + "endBinding": { + "elementId": "RwcuXXgiWjYpjyYPqjjzL", + "focus": -0.028350968909443285, + "gap": 2.25 + }, + "startArrowhead": null, + "endArrowhead": "arrow", + "elbowed": false + }, + { + "id": "BHimquNEempTwqRFeLWmp", + "type": "arrow", + "x": 752.1523437499998, + "y": 788.234375, + "width": 96.73828125, + "height": 53.578125, + "angle": 0, + "strokeColor": "#1e1e1e", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 1, + "opacity": 100, + "groupIds": [], + "frameId": null, + "index": "aV", + "roundness": { + "type": 2 + }, + "seed": 687371088, + "version": 97, + "versionNonce": 1857889200, + "isDeleted": false, + "boundElements": null, + "updated": 1761263229449, + "link": null, + "locked": false, + "points": [ + [ + 0, + 0 + ], + [ + 96.73828125, + 53.578125 + ] + ], + "lastCommittedPoint": null, + "startBinding": { + "elementId": "h7LUtpI8Df6yQ3UQt0bOk", + "focus": 0.13398285867068108, + "gap": 1 + }, + "endBinding": { + "elementId": "9V_EeI74SHitV49zxvGDE", + "focus": 0.15112658962587633, + "gap": 6.25 + }, + "startArrowhead": null, + "endArrowhead": "arrow", + "elbowed": false + }, + { + "id": "Zq6XQM9FnCBckSs8jjrma", + "type": "arrow", + "x": 851.390625, + "y": 789.8124999999999, + "width": 164.4999999999999, + "height": 57.50000000000023, + "angle": 0, + "strokeColor": "#1e1e1e", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 1, + "opacity": 100, + "groupIds": [], + "frameId": null, + "index": "aW", + "roundness": { + "type": 2 + }, + "seed": 1662653872, + "version": 214, + "versionNonce": 2092772784, + "isDeleted": false, + "boundElements": null, + "updated": 1761263229449, + "link": null, + "locked": false, + "points": [ + [ + 0, + 0 + ], + [ + 164.4999999999999, + 57.50000000000023 + ] + ], + "lastCommittedPoint": null, + "startBinding": { + "elementId": "h7LUtpI8Df6yQ3UQt0bOk", + "focus": 0.06403469466137489, + "gap": 2.578125 + }, + "endBinding": { + "elementId": "6KJBZm7xuDfhk8_IERv9R", + "focus": 0.20583983029091066, + "gap": 3.75 + }, + "startArrowhead": null, + "endArrowhead": "arrow", + "elbowed": false + } + ], + "appState": { + "gridSize": 20, + "gridStep": 5, + "gridModeEnabled": false, + "viewBackgroundColor": "#ffffff", + "lockedMultiSelections": {} + }, + "files": {} +} \ No newline at end of file diff --git a/wgpu/src/documentation/images/architecture.webp b/wgpu/src/documentation/images/architecture.webp new file mode 100644 index 0000000000000000000000000000000000000000..8da3cd1fdf39eb2429d503cf362b5608e7102f11 GIT binary patch literal 8682 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 Ic9$Rk0IC)5SpWb4 literal 0 HcmV?d00001 diff --git a/wgpu/src/documentation/images/big-picture.webp b/wgpu/src/documentation/images/big-picture.webp new file mode 100644 index 0000000000000000000000000000000000000000..bd4c32f663cbafeb8e4ed85d8131a3317b991d3e GIT binary patch literal 11022 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 literal 0 HcmV?d00001 diff --git a/docs/big-picture.xml b/wgpu/src/documentation/images/big-picture.xml similarity index 100% rename from docs/big-picture.xml rename to wgpu/src/documentation/images/big-picture.xml diff --git a/wgpu/src/documentation/images/life-of-a-frame.svg b/wgpu/src/documentation/images/life-of-a-frame.svg new file mode 100644 index 000000000..fd6c9d365 --- /dev/null +++ b/wgpu/src/documentation/images/life-of-a-frame.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/wgpu/src/documentation/images/render-pipeline-and-resource-binding.svg b/wgpu/src/documentation/images/render-pipeline-and-resource-binding.svg new file mode 100644 index 000000000..f7acbd053 --- /dev/null +++ b/wgpu/src/documentation/images/render-pipeline-and-resource-binding.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/wgpu/src/documentation/images/render_coordinates.webp b/wgpu/src/documentation/images/render_coordinates.webp new file mode 100644 index 0000000000000000000000000000000000000000..3aa748105e13344af7f9db2d2fe44bf931e844ff GIT binary patch literal 8032 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 F{tNn?9$Nqa literal 0 HcmV?d00001 diff --git a/wgpu/src/documentation/images/texture_coordinates.webp b/wgpu/src/documentation/images/texture_coordinates.webp new file mode 100644 index 0000000000000000000000000000000000000000..87eb875c9fe2b02e7aaf3a799b979d0d8f5a1bbd GIT binary patch literal 6062 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 J=#}t*{{yhVKHvZV literal 0 HcmV?d00001 diff --git a/wgpu/src/documentation/images/xcode-edit-scheme.webp b/wgpu/src/documentation/images/xcode-edit-scheme.webp new file mode 100644 index 0000000000000000000000000000000000000000..50a3ec995e7f59816b2541dddd4525f63e7057fa GIT binary patch literal 11706 zcmb_?Wmp#57w^1DcXxMpNOyOGDBay5p@4LWw19*(n1F<&AcB;X3J4;N(p`5@kLNu1 z|K)zT^E@-}Z`NM5*WP>ftTnHms*=)kE&woAl+!WN5j8;v0DuuZYau`k0I15#>qJn1 zw*Wk;x4#;h7>to{v;+FsbkFxRf_5}c>C`e}r@b$dL79b|{ z1|0;k=QVctjiauy^>3X0i^o7u9^|P308~sXD{lt?z-|KRwEi{@pdRdLunphc*2x_d z+XS(cjiZ$<7z<92htti?;~JZQnAQ3}dK~_Pt*os7>a?(Uhx>^PO zy7~WkadY(pC6+^~--!5I5Pm%l?T8%+k)skv?L3c25k$0RQW%>x$gZxk^gV6{`LX*H|l@* z(0I|HXe4MdXsrLYBsM#?&|eR)WBNNDzoYisSL?rV{l|mh^4rm>y4!Gb((?22^8K61?i0DF4B z_6G>@@V_*hXaEq|1^~3ve`#)e0PqytsAx6+r7>B8%M1ws70Wh$-u}P!!LNT10Q#>T ziVUCz7ywqVKm33&a08G56ah6r8!!M&0ZVY!IfC=q8wdbGfk<%YO8`=Vhd?e+2$TR7 zKrQebXarh;PM{YU07ifb;0ri=mVgal8#n~cAP@)&1Pej{A%oCBm>?VweuyYU3Ze+n zfapO?A-5q85O;_lBouNFk^o7EQDpdO{fFZ3mOcKf+j<=p~cV|XalqpIsl!3&O;#U46ToTVT;L2=fg8eY;9l@Bcp^L( zUIA}__rO2G7vS6QO9U2z62XBGN2nr95Dtg{L<}Mm@dWV-@fKW7ONc`x5=o3?L5hH@ z(G=;73_&I$A0g|J9mrASBJuzQ1%(WS14R-=8^sF67bONI2c-t39c2t<3FR0S1C<7q zA5{s}4AmX=E@~!f73v$*G1L{*Gc;T@CNyz0Z8Tf7AhZ;;QnY5YVYDT*Gju$37IaB; z19WHfNc3#zVi>v@P8bmw*%(hT-eD|YoM7T(vSZ3)T44HNCS#Uk zc3^(O+{41cV#boeGQ;x4O2(?h>c*PGI>siz=EhdVw#5#|&cklN9>e~LgNDO|Ba35+ z6O5CI^8#lWXA>6#>VFF<-;Sk|A5k8S1kr7cKQ65nn z(L6DXn3-6W*p)bi_&M<;@hJ%vi7bg7NgPQX$r#BIDFvwvsU2xNX+7x#=_wg4nIf4B zSsGa**(^DnoSj^kJb=7_{4Mz=1tG-^3LA=eisuxcDWR0?lzNmQlqHmdlm}GQRLWGI zR5?`LRGZYq)H2l0)EU%osMlx+XrySIXfkNpY1V0pXk}?#X|rj2Xt(Jo=~U?a=pNGz z(Vfw=&>PaTWw2++VCZ7lW~5=%WDI4jX8g>A#w5z*$dtv@$8^NZ!fecZ zpSh8Fm4%c=l_i*^nq`I+i&dJ{i?x__oDIn)%I3oMh;4)&$}Yt2$ezbO%mL*P=5XS8 z#4*Z=;1uI@=Pc%&;=<&TNn^0wGPI`$Anp7s4XK-okal zYa)yyw?**qw2=01dD{7M5)B0 zB)z1SWEf;@WuC~a$g;^g%ht⋘f52mU|_4Brh(1 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 G9r!;Hl&|*y literal 0 HcmV?d00001 diff --git a/wgpu/src/documentation/images/xcode-new-project.webp b/wgpu/src/documentation/images/xcode-new-project.webp new file mode 100644 index 0000000000000000000000000000000000000000..7a02a507c22b3f53f8c6b8e0bd646db47c9fdfc7 GIT binary patch literal 15516 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 MF#Er$7exmCAK8op1ONa4 literal 0 HcmV?d00001 diff --git a/wgpu/src/documentation/images/xcode-play-button.webp b/wgpu/src/documentation/images/xcode-play-button.webp new file mode 100644 index 0000000000000000000000000000000000000000..ab3da67fc1e4cf9683b1ff8c8dc4d2f61c347916 GIT binary patch literal 9928 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 bP*xD*|9|@PD_B3NV6@~>vVwmjFOT{^X3-`6 literal 0 HcmV?d00001 diff --git a/wgpu/src/documentation/images/xcode-project-type.webp b/wgpu/src/documentation/images/xcode-project-type.webp new file mode 100644 index 0000000000000000000000000000000000000000..bb3dd5221ad112b189c3248e5881b6ece7bead4b GIT binary patch literal 13418 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 KPwHhbf&T-1KBut& literal 0 HcmV?d00001 diff --git a/wgpu/src/documentation/images/xcode-scheme-arguments.webp b/wgpu/src/documentation/images/xcode-scheme-arguments.webp new file mode 100644 index 0000000000000000000000000000000000000000..d2d0560ce6377724b06c693f41460f66cfeaf333 GIT binary patch literal 14652 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 reUdj24!c8L_?qSO6hF3J3yl2d6+kMFRt!3+{h@ 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 b{)-O$r$fJ^^@|FIOAaN&|2On. Can be worked + around by only doing one submission per frame. + +- **`cmd_begin_debug_utils_label_ext` pointer is NULL** + + | Property | Values observed | + | ---------------- | ------------------- | + | Operating System | Windows 10 Pro 21H1 | + | Driver OEM | UHD Graphics 630 | + | Driver Version | 24.20.100.6287 | + + The extension is supported, but the pointer to the function is NULL. + Escalated in . Still needs an + upstream report. + +## Intel / DirectX 12 + +- **Offset after resizing window** — + [wgpu-rs#647](https://github.com/gfx-rs/wgpu-rs/issues/647) + + | Property | Values observed | + | ---------------- | ----------------- | + | Operating System | Windows 10 64-bit | + | Driver OEM | Microsoft | + | Driver Version | 26.20.100.7639 | + + This issue affects programs running on any GPU if the Intel GPU is being + used by the compositor. This would typically be the case in dual-GPU + systems. It can be worked around by replacing the Microsoft OEM driver with + the generic Intel driver. + +- **`CreatePlacedResource` TDRs** — + [wgpu#1319](https://github.com/gfx-rs/wgpu/issues/1319) + + | Property | Values observed | + | ---------------- | ------------------------------ | + | Operating System | Windows 10 64-bit, build 19042 | + | GPU | HD Graphics 4600 | + | Driver Version | 20.19.15.5171 | + + Reported in + . + +## Intel / DX11 + +- **Buffer write not synchronized with draw** — + [wgpu#1060](https://github.com/gfx-rs/wgpu/issues/1060) + + | Property | Values observed | + | ---------------- | --------------- | + | Operating System | Windows | + + Buffer upload isn't being properly synchronized with the draw call that is + using it. This is entirely on the driver to get right; there is no way to + do manual sync. + +## Intel / All + +- **Cannot combine MSAA with sRGB resolve** — + [wgpu#725](https://github.com/gfx-rs/wgpu/issues/725) + + | Property | Values observed | + | ---------------- | --------------- | + | Operating System | Linux | + + Attempting to do MSAA resolve at the same time as sRGB resolve will cause + MSAA to not work and the clear color to not be properly converted into + sRGB. + +## Nvidia / Vulkan + +- **Hang/panic/device loss after specific render sequence** — + [wgpu#983](https://github.com/gfx-rs/wgpu/issues/983) + + | Property | Values observed | + | ---------------- | ------------------------- | + | Operating System | Windows 10 64-bit | + | GPU | GeForce RTX 2080 Ti | + | Driver Name | GeForce Game Ready Driver | + | Driver Version | 456.38, 457.09, 457.30 | + + Does not occur on driver version 452.06. After submitting a frame to + `wgpu`, Vulkan seems to become unstable and this manifests itself in a few + ways. + +- **`write_buffer` only works when aligned to 16** — + [wgpu#1323](https://github.com/gfx-rs/wgpu/issues/1323) + + | Property | Values observed | + | ---------------- | ---------------------------- | + | Operating System | Windows 10 64-bit | + | GPU | GeForce GTX 1050, 1070 | + | Driver Version | 27.21.14.5256, 27.21.14.6589 | + + We issue `vkCmdFillBuffer` for the uninitialized area of a buffer. If only + the first 40 bytes were filled, the fill buffer is called with an offset of + 40, but the driver ends up erasing all the data starting with offset 32. + Issue reported directly to the NVIDIA level-2 support team, ticket + 210412-000661. + +- **Flat-interpolated integers come out as zeroes** — + [wgpu#1775](https://github.com/gfx-rs/wgpu/issues/1775) + + | Property | Values observed | + | ---------------- | ---------------- | + | Operating System | Linux | + | GPU | GeForce GTX 1050 | + | Driver Version | 390 | + + Fragment shader sees interpolated values as 0. Issue reported to NVIDIA + Vulkan support. + +## WARP / D3D12 + +- **CPU descriptors are used after `CopyDescriptors`** — + [wgpu#1002](https://github.com/gfx-rs/wgpu/issues/1002) + + | Property | Values observed | + | ---------------- | ----------------- | + | Operating System | Windows 10 64-bit | + +## AMD / D3D12 + +- **Updating partial texture data doesn't show up** — + [wgpu#1306](https://github.com/gfx-rs/wgpu/issues/1306) + + | Property | Values observed | + | ---------------- | ----------------- | + | Operating System | Windows 10 64-bit | + | GPU | Ryzen 3500U | + | Driver Name | ? | + | Driver Version | ? | + + When a texture only gets partially updated, sampling from it returns + zeroes. Issue has been reported directly to AMD. + +## Mesa / Vulkan + +- **Integer overflow with very large buffers** — + [wgpu#2796](https://github.com/gfx-rs/wgpu/pull/2796) + + | Property | Values observed | + | ---------------- | ----------------- | + | Operating System | Linux | + | Driver Name | Mesa/lavapipe | + + When a buffer size or range parameter does not fit a 32-bit signed integer, + Mesa runs into integer overflows. + +*/ diff --git a/wgpu/src/documentation/internals/mod.rs b/wgpu/src/documentation/internals/mod.rs new file mode 100644 index 000000000..c91531133 --- /dev/null +++ b/wgpu/src/documentation/internals/mod.rs @@ -0,0 +1,10 @@ +/*! +Internals and Architecture + +How `wgpu` is put together internally, and the driver-level issues it has to +contend with. +*/ + +pub mod architecture; +pub mod known_driver_issues; +pub mod reporting_driver_bugs; diff --git a/wgpu/src/documentation/internals/reporting_driver_bugs.rs b/wgpu/src/documentation/internals/reporting_driver_bugs.rs new file mode 100644 index 000000000..15978bb7a --- /dev/null +++ b/wgpu/src/documentation/internals/reporting_driver_bugs.rs @@ -0,0 +1,35 @@ +/*! +# Reporting Driver Bugs + +It can sometimes be hard to figure out where to report driver bugs to the +vendor. Here is a collection of known places for issues to go, and whether +reports have been successful. + +Proprietary: + +- NVIDIA Windows/Linux: + [forum](https://forums.developer.nvidia.com/c/gaming-and-visualization-technologies/apis/489) + (success) +- AMD (Windows — GL/VK): + [forum](https://community.amd.com/t5/opengl-vulkan/bd-p/opengl-and-vulkan-discussions) + (unknown) +- Intel (Windows): + [GitHub](https://github.com/IGCIT/Intel-GPU-Community-Issue-Tracker-IGCIT) + (unknown) +- Qualcomm: + [forum](https://developer.qualcomm.com/forums/software/adreno-gpu-sdk) + (success) +- WARP: ping `@soldieroflight` in `#dx12-developers` on the + [DX12 Discord](https://discord.gg/directx) + +Open source: + +- AMDVLK (Linux): [GitHub](https://github.com/GPUOpen-Drivers/AMDVLK) +- Mesa: [GitLab](https://gitlab.freedesktop.org/mesa/mesa) + - AMD (Linux) RADV + - Intel (Linux) + - Raspberry Pi + - llvmpipe + - lavapipe +- MoltenVK: [GitHub](https://github.com/KhronosGroup/MoltenVK) +*/ diff --git a/wgpu/src/documentation/mod.rs b/wgpu/src/documentation/mod.rs new file mode 100644 index 000000000..7175e1596 --- /dev/null +++ b/wgpu/src/documentation/mod.rs @@ -0,0 +1,19 @@ +#![cfg_attr(not(doc), expect(unused_imports))] + +/*! +General documentation and guides for the `wgpu` crate. + +Each module here is documentation only (it contains no runtime code) and +collects concept primers, best practices, debugging tips, platform notes, +and explanations of `wgpu`'s internals that don't belong on any single API item. +*/ + +pub mod best_practices; +pub mod color; +pub mod debugging; +pub mod extensions; +pub mod features; +pub mod getting_started; +pub mod internals; +pub mod platforms; +pub mod shaders; diff --git a/wgpu/src/documentation/platforms/android.rs b/wgpu/src/documentation/platforms/android.rs new file mode 100644 index 000000000..e184b28ea --- /dev/null +++ b/wgpu/src/documentation/platforms/android.rs @@ -0,0 +1,24 @@ +/*! +# Running on Android + +## Surface creation + +On Android, surface creation should happen on the resume event of the +window, and surface cleanup on the suspend event. A valid surface cannot be +created beforehand. This means that, when using `winit`, `sdl2`, or anything +similar, surface creation should happen in the resume handler, roughly like +this: + +```ignore +// winit's `ApplicationHandler::resumed`: +fn resumed(&mut self, event_loop: &ActiveEventLoop) { + let window = event_loop.create_window(Window::default_attributes()).unwrap(); + let surface = instance.create_surface(window).unwrap(); + // ... +} +``` + +Correspondingly, drop the [`Surface`] when the window is suspended. +*/ + +use crate::Surface; diff --git a/wgpu/src/documentation/platforms/angle.rs b/wgpu/src/documentation/platforms/angle.rs new file mode 100644 index 000000000..d809b58d7 --- /dev/null +++ b/wgpu/src/documentation/platforms/angle.rs @@ -0,0 +1,20 @@ +/*! +# Running on ANGLE + +[ANGLE](https://angleproject.org) is a translation layer from GLES to other +backends, developed by Google. We support running our GLES3 backend over it +in order to reach platforms with D3D11 support, which aren't accessible +otherwise. + +In order to run with ANGLE, the `angle` feature has to be enabled, and ANGLE +libraries placed in a location visible to the application. These binaries +can be downloaded from +[gfbuild-angle](https://github.com/DileSoft/gfbuild-angle) artifacts; +[manual compilation](https://github.com/google/angle/blob/main/doc/DevSetup.md) +may be required on Macs with Apple silicon. + +On Windows, you generally need to copy the libraries into the working +directory, into the same directory as the executable, or somewhere in your +`PATH`. On Linux, you can point to them using the `LD_LIBRARY_PATH` +environment variable. +*/ diff --git a/wgpu/src/documentation/platforms/emscripten.rs b/wgpu/src/documentation/platforms/emscripten.rs new file mode 100644 index 000000000..749c8c22f --- /dev/null +++ b/wgpu/src/documentation/platforms/emscripten.rs @@ -0,0 +1,33 @@ +/*! +# Running on the Web with Emscripten + +At the moment `wgpu` has one example meant to run under Emscripten: +`wgpu-hal/examples/raw-gles.rs`. + +In the workspace's top directory, build the example as follows: + +```bash +cargo clean +EMCC_CFLAGS="-g -s ERROR_ON_UNDEFINED_SYMBOLS=0 --no-entry -s FULL_ES3=1" \ + cargo build --example raw-gles --target wasm32-unknown-emscripten --features gles,emscripten,webgl +``` + +Then copy the HTML page that loads the compiled example into the target +directory alongside the WebAssembly: + +```bash +cp wgpu-hal/examples/raw-gles.em.html target/wasm32-unknown-emscripten/debug/examples/ +``` + +Finally, start an HTTP server publishing the contents of that directory: + +```bash +cd target/wasm32-unknown-emscripten/debug/examples/ +python -m http.server +``` + +Then visit `localhost:8000/` in your browser. + +If you get other, more interesting examples working with Emscripten, please +update this page! +*/ diff --git a/wgpu/src/documentation/platforms/mobile_app_integration.rs b/wgpu/src/documentation/platforms/mobile_app_integration.rs new file mode 100644 index 000000000..723ba5281 --- /dev/null +++ b/wgpu/src/documentation/platforms/mobile_app_integration.rs @@ -0,0 +1,29 @@ +/*! +# Integrating wgpu into Existing iOS and Android Apps + +`wgpu` does not depend on any windowing library, so it does not provide +window creation and management functions. Only when creating a window-based +[`Surface`] may an argument that implements the +[`raw-window-handle`](https://github.com/rust-windowing/raw-window-handle) +abstract interface be required. The +[`winit`](https://github.com/rust-windowing/winit) crate used by the `wgpu` +examples is a cross-platform window creation and management crate that +implements that interface; it takes over the window management and event +loop of the entire app. + +There is no doubt that, for game apps, the combination of `wgpu` + `winit` +is very suitable. However, a large number of non-game apps also often need +to use graphics APIs (for charts, image filters, etc.). These apps need to +use a lot of system UI components and interactions, and `winit`'s way of +taking over the entire app window is not suitable. So, it would be very +useful to integrate `wgpu` into existing iOS and Android apps without using +third-party window-management libraries. + +[wgpu-in-app](https://github.com/jinleili/wgpu-in-app) is a complete doc and +example of how to do it. The doc section also has two Chinese versions: +[与 iOS App 集成](https://jinleili.github.io/learn-wgpu-zh/integration-and-debugging/ios/) +and +[与 Android App 集成](https://jinleili.github.io/learn-wgpu-zh/integration-and-debugging/android/). +*/ + +use crate::Surface; diff --git a/wgpu/src/documentation/platforms/mod.rs b/wgpu/src/documentation/platforms/mod.rs new file mode 100644 index 000000000..29885a6aa --- /dev/null +++ b/wgpu/src/documentation/platforms/mod.rs @@ -0,0 +1,13 @@ +/*! +Platform-Specific Guides + +Notes on running `wgpu` on specific platforms and targets: the web, mobile, +ANGLE, and the requirements `wgpu` places on the Vulkan backend. +*/ + +pub mod android; +pub mod angle; +pub mod emscripten; +pub mod mobile_app_integration; +pub mod vulkan_requirements; +pub mod web; diff --git a/wgpu/src/documentation/platforms/vulkan_requirements.rs b/wgpu/src/documentation/platforms/vulkan_requirements.rs new file mode 100644 index 000000000..346a02105 --- /dev/null +++ b/wgpu/src/documentation/platforms/vulkan_requirements.rs @@ -0,0 +1,12 @@ +/*! +# Vulkan Requirements + +`wgpu`'s Vulkan backend requires the following from a physical device: + +- `fragmentStoresAndAtomics` must be enabled (see + ). +- `independentBlending` must be enabled (see + [wgpu#2498](https://github.com/gfx-rs/wgpu/pull/2498)). +- The `maxDrawIndexedIndexValue` limit must be 32-bit. +- `VK_KHR_storage_buffer_storage_class` must be supported. +*/ diff --git a/wgpu/src/documentation/platforms/web.rs b/wgpu/src/documentation/platforms/web.rs new file mode 100644 index 000000000..213fcc5da --- /dev/null +++ b/wgpu/src/documentation/platforms/web.rs @@ -0,0 +1,111 @@ +/*! +# Running on the Web (WebGPU and WebGL) + +`wgpu` can run in the browser by compiling to WebAssembly, targeting either +WebGPU (where available) or the WebGL2 backend as a fallback. The WebGL2 +backend is still missing some features compared to the native and WebGPU +backends. + +## Running the examples + +### Installing the Rust WebAssembly target + +To build the `wgpu` examples for execution in a browser, you must first +install the Rust toolchain for the `wasm32-unknown-unknown` target. Using +`rustup`: + +```bash +rustup target add wasm32-unknown-unknown +``` + +### Using `cargo xtask run-wasm` + +The simplest way to run the examples on the web is the `run-wasm` xtask: + +```bash +cargo xtask run-wasm +``` + +This builds the `wgpu-examples` crate for `wasm32-unknown-unknown` (both the +WebGPU and WebGL2 variants), runs `wasm-bindgen` on the output, and serves +the result. It requires +[`wasm-bindgen-cli`](https://crates.io/crates/wasm-bindgen-cli) and +[`simple-http-server`](https://crates.io/crates/simple-http-server) to be +installed. Once it's running, open in your browser +and pick an example. + +> **Note:** the server binds to `127.0.0.1` on purpose. WebGPU requires a +> [secure context](https://developer.mozilla.org/en-US/docs/Web/Security/Secure_Contexts), +> which `127.0.0.1` satisfies but `0.0.0.0` does not. + +### WebGPU browser support + +WebGPU is available in current versions of Chrome and other Chromium-based +browsers, and is shipping or in progress elsewhere. For up-to-date +implementation status, check [webgpu.io](https://webgpu.io) or +[caniuse.com/webgpu](https://caniuse.com/webgpu). Note that `wgpu` is often +ahead of browsers in catching up with upstream WebGPU API changes. + +## Manual compilation with `wasm-bindgen-cli` + +If you'd rather not use the xtask, you can reproduce what it does by hand. +First install the version of `wasm-bindgen-cli` that matches the version +used by `wgpu` (check the workspace `Cargo.lock`): + +```bash +cargo install -f wasm-bindgen-cli --version +``` + +Then build the examples for `wasm32-unknown-unknown` and run `wasm-bindgen` +on the output. For WebGPU: + +```bash +cargo build --target wasm32-unknown-unknown -p wgpu-examples --no-default-features --features webgpu +wasm-bindgen target/wasm32-unknown-unknown/debug/wgpu-examples.wasm \ + --target web --no-typescript --out-dir target/generated --out-name webgpu +``` + +For WebGL2, swap the `webgpu` feature for `webgl` and the `--out-name` +accordingly: + +```bash +cargo build --target wasm32-unknown-unknown -p wgpu-examples --no-default-features --features webgl +wasm-bindgen target/wasm32-unknown-unknown/debug/wgpu-examples.wasm \ + --target web --no-typescript --out-dir target/generated --out-name webgl2 +``` + +### Setting up the page + +Create an `index.html` file in the `target/generated` directory that loads +the generated module: + +```html + + + + + + + + + + +``` + +### Running the code + +Now run a web server locally inside the `target/generated` directory to view +the example in the browser. A secure context is required for WebGPU, so +serve from `127.0.0.1` (or `localhost`), for example with +[`simple-http-server`](https://crates.io/crates/simple-http-server): + +```bash +simple-http-server target/generated -c wasm,html,js -i --coep --coop --ip 127.0.0.1 +``` + +The `--coep` and `--coop` flags set the cross-origin isolation headers some +features require. +*/ diff --git a/wgpu/src/documentation/shaders.rs b/wgpu/src/documentation/shaders.rs new file mode 100644 index 000000000..745b1167a --- /dev/null +++ b/wgpu/src/documentation/shaders.rs @@ -0,0 +1,16 @@ +/*! +## Shader Support + +`wgpu` can consume shaders in [WGSL](https://gpuweb.github.io/gpuweb/wgsl/), SPIR-V, and GLSL. +Both [HLSL](https://github.com/Microsoft/DirectXShaderCompiler) and [GLSL](https://github.com/KhronosGroup/glslang) +have compilers to target SPIR-V. All of these shader languages can be used with any backend as we handle all of the conversions. Additionally, support for these shader inputs is not going away. + +While WebGPU does not support any shading language other than WGSL, we will automatically convert your +non-WGSL shaders if you're running on WebGPU. + +WGSL is always supported by default, but GLSL and SPIR-V need features enabled to compile in support. + +To enable WGSL shaders, enable the `wgsl` feature of `wgpu` (enabled by default). +To enable SPIR-V shaders, enable the `spirv` feature of `wgpu`. +To enable GLSL shaders, enable the `glsl` feature of `wgpu`. +*/ diff --git a/wgpu/src/lib.rs b/wgpu/src/lib.rs index 9e855a43b..a342c5f6f 100644 --- a/wgpu/src/lib.rs +++ b/wgpu/src/lib.rs @@ -1,8 +1,9 @@ //! `wgpu` is a cross-platform, safe, pure-Rust graphics API. It runs natively on //! Vulkan, Metal, D3D12, and OpenGL; and on top of WebGL2 and WebGPU on wasm. //! -//! The API is based on the [WebGPU standard][webgpu], but is a fully native Rust library. -//! It serves as the core of the WebGPU integration in Firefox, Servo, and Deno. +//! The API is based on the [WebGPU standard][webgpu], but is a fully native Rust library +//! and includes many extensions specific to the native backends. It serves as the core of +//! the WebGPU integration in Firefox, Servo, and Deno. //! //! [webgpu]: https://gpuweb.github.io/gpuweb/ //! @@ -15,7 +16,7 @@ //! //! Additionally, [WebGPU Fundamentals] is a tutorial for WebGPU which is very similar to our API, minus differences between Rust and Javascript. //! -//! We have a [wiki](https://github.com/gfx-rs/wgpu/wiki) which has information on useful architecture patterns, debugging tips, and more getting started information. +//! Most types and functions are documented, but for more general guides and explanations, see the [documentation modules][documentation]. //! //! There are examples for this version [available on GitHub](https://github.com/gfx-rs/wgpu/tree/v30/examples#readme). //! @@ -24,197 +25,16 @@ //! //! `wgpu` uses the coordinate systems of D3D and Metal. Depth ranges from [0, 1]. //! -//! | Render | Texture | -//! | --------------------- | ---------------------- | -//! | ![render_coordinates] | ![texture_coordinates] | +//! | Render | Texture | +//! | --- | --- | +//! | ![Render coordinates][render_coordinates.webp] | ![Texture coordinates][texture_coordinates.webp] | //! //! `wgpu`'s MSRV is **1.87**. //! //! [Learn Wgpu]: https://sotrh.github.io/learn-wgpu/ //! [WebGPU Fundamentals]: https://webgpufundamentals.org/ -//! [render_coordinates]: https://raw.githubusercontent.com/gfx-rs/wgpu/refs/heads/v30/docs/render_coordinates.png -//! [texture_coordinates]: https://raw.githubusercontent.com/gfx-rs/wgpu/refs/heads/v30/docs/texture_coordinates.png -//! -//! ## Extension Specifications -//! -//! While the core of `wgpu` is based on the WebGPU standard, we also support extensions that allow for features that the standard does not have yet. -//! For high-level documentation on how to use these extensions, see documentation on [`Features`] or the relevant specification: -//! -//! 🧪EXPERIMENTAL🧪 APIs are subject to change and may allow undefined behavior if used incorrectly. -//! -//! - 🧪EXPERIMENTAL🧪 [Ray Tracing](https://github.com/gfx-rs/wgpu/blob/v30/docs/api-specs/ray_tracing.md). -//! - 🧪EXPERIMENTAL🧪 [Mesh Shading](https://github.com/gfx-rs/wgpu/blob/v30/docs/api-specs/mesh_shading.md). -//! -//! ## Shader Support -//! -//! `wgpu` can consume shaders in [WGSL](https://gpuweb.github.io/gpuweb/wgsl/), SPIR-V, and GLSL. -//! Both [HLSL](https://github.com/Microsoft/DirectXShaderCompiler) and [GLSL](https://github.com/KhronosGroup/glslang) -//! have compilers to target SPIR-V. All of these shader languages can be used with any backend as we handle all of the conversions. Additionally, support for these shader inputs is not going away. -//! -//! While WebGPU does not support any shading language other than WGSL, we will automatically convert your -//! non-WGSL shaders if you're running on WebGPU. -//! -//! WGSL is always supported by default, but GLSL and SPIR-V need features enabled to compile in support. -//! -//! To enable WGSL shaders, enable the `wgsl` feature of `wgpu` (enabled by default). -//! To enable SPIR-V shaders, enable the `spirv` feature of `wgpu`. -//! To enable GLSL shaders, enable the `glsl` feature of `wgpu`. -//! -//! ## Feature flags -#![doc = document_features::document_features!()] -//! -//! ### Feature Aliases -//! -//! These features aren't actually features on the crate itself, but a convenient shorthand for -//! complicated cases. -//! -//! - **`wgpu_core`** --- Enabled when there is any non-webgpu backend enabled on the platform. -//! - **`naga`** --- Enabled when target `glsl` or `spirv` input is enabled, or when `wgpu_core` is enabled. -//! -//! ## Surface color spaces and HDR output -//! -//! A surface can present in different color spaces to get HDR or wide-gamut -//! output onto the screen. This is configured through -//! [`SurfaceConfiguration::color_space`], and the rest of this section is a -//! concept primer on how it works. -//! -//! ### HDR output in a nutshell -//! -//! By default a surface is standard dynamic range (SDR) with the sRGB gamut: the -//! value `1.0` is the brightest white, anything above it clips, and only colors -//! within sRGB are expressible. Other [`SurfaceColorSpace`]s opt into a **wider -//! gamut** (for example [`DisplayP3`](SurfaceColorSpace::DisplayP3), still SDR -//! but with more saturated colors than sRGB), **high dynamic range** (values -//! above `1.0` drive brighter-than-white output), or both (for example -//! [`Bt2100Pq`](SurfaceColorSpace::Bt2100Pq), aka HDR10), on platforms that -//! support it. -//! -//! Three ideas carry most of the weight: -//! -//! * **Reference white and headroom.** Brightness is measured in *nits* -//! (cd/m²). On HDR-capable monitors, SDR reference white (plain white, `(1.0, 1.0, 1.0)` in the -//! extended color spaces) sits *below* the display's peak output on purpose, so -//! highlights have room above it. That gap is the display's *headroom*. -//! * **The transfer function is a round-trip.** Your shader applies an -//! encoding transfer function (the OETF) to turn the light it computed into a -//! stored signal, and the display applies the inverse decoding transfer -//! function (the EOTF) to turn it back into light. Choosing a color space -//! chooses which transfer functions both ends use. -//! * **Who applies the encoding transfer function.** wgpu applies it for you -//! **only** when you render to an `*Srgb` texture view format, where the GPU -//! runs the sRGB OETF when a value is stored to a texture. For every other -//! color space (linear extended sRGB, encoded extended sRGB or P3, PQ, HLG) -//! **the values your shader writes to the surface texture must already be -//! encoded by you**, along with any gamut conversion; in a typical renderer -//! this happens in a final tone-mapping or post-processing pass. wgpu hands -//! the signal to the compositor unchanged; getting this wrong produces a -//! wrong image with no error. -//! -//! wgpu does **not** tonemap or gamut-map for you. It gives you the surface -//! and, through [`DisplayHdrInfo`], the display's advisory capabilities; -//! *choosing* and *applying* a tone curve is your application's job. -//! -//! ### The practical path -//! -//! 1. **Query capabilities.** Call `Surface::get_capabilities`. To use HDR or -//! wide-gamut output, read [`SurfaceCapabilities::format_capabilities`] (each -//! format and the [`SurfaceColorSpaces`] it supports), **not** -//! [`SurfaceCapabilities::formats`]: the latter lists only formats usable -//! with [`Auto`](SurfaceColorSpace::Auto), which never selects HDR. -//! [`SurfaceCapabilities::color_spaces`] is a convenience lookup for one -//! format. -//! 2. **Optionally query the display.** Call `Surface::display_hdr_info` for the -//! current [`DisplayHdrInfo`] (peak and SDR-white nits, EDR headroom, -//! primaries, and a coarse dynamic-range/gamut bucket). Use it to pick a -//! tone-map target ([`DisplayHdrInfo::tone_map_headroom`]); *whether* HDR is -//! worthwhile is the capability question from step 1, not this live value. -//! Every field is advisory and optional; `None` means "cannot tell here", -//! never "SDR". -//! 3. **Choose a format and color space.** Intersect what you want with what -//! step 1 advertises, in your own preference order (for example HDR10, then -//! linear extended sRGB, then encoded extended sRGB, then SDR -//! [`Srgb`](SurfaceColorSpace::Srgb)). Keep an SDR fallback for when nothing -//! HDR is advertised, such as when OS HDR is off. -//! 4. **Configure the surface.** Set [`SurfaceConfiguration::color_space`] and -//! `format`. [`Auto`](SurfaceColorSpace::Auto) (the default) reproduces -//! wgpu's historical behavior and never picks HDR; any other value must be in -//! that format's advertised set or configuration fails validation. -//! 5. **Encode what you write to the surface texture.** For an `*Srgb` format, -//! output linear and the hardware encodes for you. Otherwise the values your -//! shader writes to the surface texture must already carry the encoding the -//! chosen color space expects (sRGB, extended sRGB, PQ, or HLG) **and** any -//! gamut conversion (for example outputting in the BT.2020 gamut for HDR10); -//! in a typical renderer you do this in a final tone-mapping or -//! post-processing pass. See the table below. -//! 6. **Present** as usual. If OS HDR is toggled mid-run, you'll see it on the -//! next `Surface::display_hdr_info` poll; re-query `Surface::get_capabilities` -//! and re-run the steps above. -//! -//! The standalone [HDR surface example] implements every step, including the -//! encoding transfer function for each color space. -//! -//! ### What to output from your fragment shader -//! -//! What the values your shader writes to the surface texture must contain for -//! each color space, and whether wgpu applies the transfer function for you: -//! -//! | Color space | Typical format | You write | wgpu encodes? | -//! | ----------- | -------------- | --------- | ------------- | -//! | `Srgb`, `*Srgb` format | `{Rgba,Bgra}8UnormSrgb` | linear | **yes** (hardware sRGB OETF on store) | -//! | `Srgb`, non-srgb format | `{Rgba,Bgra}8Unorm` | sRGB-encoded | no; apply the sRGB OETF yourself or use `*Srgb` instead | -//! | `ExtendedSrgbLinear` (scRGB) | `Rgba16Float` | linear, `1.0` = SDR white | no, but no encoding is necessary | -//! | `ExtendedSrgb` | `Rgba16Float` | extended sRGB-encoded | no; apply the extended sRGB OETF yourself | -//! | `DisplayP3` | `Bgra8Unorm` | sRGB-encoded, P3 primaries | no; apply the sRGB OETF (after gamut-mapping to P3) | -//! | `ExtendedDisplayP3` | `Rgba16Float` | extended sRGB-encoded, P3 primaries | no; apply the extended sRGB OETF (after gamut-mapping to P3) | -//! | `Bt2100Pq` (HDR10) | `Rgb10a2Unorm` | PQ-encoded, BT.2020 primaries | no; apply the PQ OETF (after gamut-mapping to BT.2020) | -//! | `Bt2100Hlg` | `Rgb10a2Unorm` | HLG-encoded, BT.2020 primaries | no; apply the HLG OETF (after gamut-mapping to BT.2020) | -//! -//! In short, wgpu applies the transfer function for you only when you render to -//! an `*Srgb` format. In every other case the values your shader writes to the -//! surface texture must already carry both the transfer function and any gamut -//! conversion. The [HDR surface example] implements every encoder in WGSL. -//! -//! ### Glossary -//! -//! * **Chromaticity** --- a color's hue and saturation independent of its -//! brightness, given as an `(x, y)` coordinate on the CIE 1931 diagram. -//! * **Primaries / gamut** --- the chromaticities of the red, green, and blue a -//! color space addresses, and so the range of colors it can express. [BT.709] -//! is the sRGB gamut, [Display P3] is wider, and [BT.2020] is wider still. -//! * **White point** --- the chromaticity of `R = G = B` (what "white" looks -//! like). Every color space here uses [D65], standard daylight. -//! * **Transfer function (OETF / EOTF)** --- how stored values map to light. The -//! *OETF* is the encoding transfer function your application applies; the -//! *EOTF* is the inverse decoding transfer function the display applies. -//! * **SDR / HDR** --- standard dynamic range clips at `1.0` (reference white); -//! high dynamic range lets values above `1.0` drive brighter-than-white -//! output. -//! * **Nits and reference white** --- a *nit* (cd/m²) is a unit of brightness; -//! *reference white* (also called *paper white*, especially on Windows) is the -//! brightness of SDR plain white, set below the panel's peak so highlights have -//! room above it. -//! * **Headroom (EDR)** --- how much brighter than current SDR white the display -//! can go right now, as a multiplier (`1.0` means none). Dynamic; see -//! [`DisplayHdrInfo::tone_map_headroom`]. -//! * **PQ / HLG** --- the two HDR transfer functions: [PQ] (SMPTE ST 2084, -//! HDR10) encodes absolute luminance, [HLG] (BT.2100) encodes relative -//! luminance. -//! * **scRGB / extended-range sRGB** --- sRGB extended past 0.0..=1.0 for -//! HDR: [scRGB] is *linear* -//! ([`ExtendedSrgbLinear`](SurfaceColorSpace::ExtendedSrgbLinear)), while -//! [`ExtendedSrgb`](SurfaceColorSpace::ExtendedSrgb) is the same range but -//! sRGB-*encoded* (gamma), the web's HDR path. -//! -//! [HDR surface example]: https://github.com/gfx-rs/wgpu/tree/v30/examples/standalone/03_hdr_surface -//! [BT.709]: https://www.itu.int/rec/R-REC-BT.709 -//! [BT.2020]: https://www.itu.int/rec/R-REC-BT.2020 -//! [Display P3]: https://en.wikipedia.org/wiki/DCI-P3#Display_P3 -//! [D65]: https://en.wikipedia.org/wiki/Standard_illuminant#D65_values -//! [PQ]: https://en.wikipedia.org/wiki/Perceptual_quantizer -//! [HLG]: https://www.itu.int/rec/R-REC-BT.2100 -//! [scRGB]: https://en.wikipedia.org/wiki/ScRGB -//! - +#![doc = crate::macros::doc_image!("render_coordinates.webp")] +#![doc = crate::macros::doc_image!("texture_coordinates.webp")] #![no_std] // `-Znext-solver` requires deeper recursion limits (at least for now) to prove Send/Sync #![recursion_limit = "256"] @@ -259,6 +79,7 @@ mod api; mod backend; mod cmp; mod dispatch; +pub mod documentation; mod macros; pub mod util; diff --git a/wgpu/src/macros/mod.rs b/wgpu/src/macros/mod.rs index 95979796e..d338f0603 100644 --- a/wgpu/src/macros/mod.rs +++ b/wgpu/src/macros/mod.rs @@ -255,6 +255,50 @@ macro_rules! hal_type_gles { } pub(crate) use hal_type_gles; +// Reference an image from the crate's `src/documentation/images/` directory. Put +// the expansion in a `#[doc]` attribute and reference the image by file name +// elsewhere in the same docs: +// +// #![doc = crate::macros::doc_image!("foo.png")] +// //! ![alt text][foo.png] +// +// Local builds resolve the image from the on-disk `src/documentation/images/` +// directory (which, because it lives inside the crate, is also present when a +// downstream user builds `wgpu`'s docs as a dependency); `docsrs` builds resolve +// it from the repository over HTTP, pinned to the commit being built. Both base +// URLs are set in `build.rs`. The expansion must be a single line, as it is used +// in a `#[doc]` attribute. +// +// Place these attributes *before* the module's doc comment, as shown above. +// rustdoc strips trailing blank lines from each doc fragment and joins the +// fragments with a single newline, so a definition placed after a doc comment +// that ends in a paragraph is swallowed by that paragraph as a lazy +// continuation, and every image reference in the module silently fails to +// resolve. + +/// Expands to a Markdown reference-style link definition for a `src/documentation/images/` image. +#[cfg(docsrs)] +macro_rules! doc_image { + ($name:literal) => { + concat!( + "[", + $name, + "]: https://raw.githubusercontent.com/gfx-rs/wgpu/", + env!("WGPU_DOCS_COMMIT"), + "/wgpu/src/documentation/images/", + $name + ) + }; +} +/// Expands to a Markdown reference-style link definition for a `src/documentation/images/` image. +#[cfg(not(docsrs))] +macro_rules! doc_image { + ($name:literal) => { + concat!("[", $name, "]: ", env!("WGPU_DOCS_URL_BASE"), "/", $name) + }; +} +pub(crate) use doc_image; + #[doc(hidden)] pub mod helpers { pub use alloc::{borrow::Cow, string::String};