From f6676b83f05fac0279159327ac6993c3fe8c7d11 Mon Sep 17 00:00:00 2001 From: Brian Holman Date: Mon, 9 Nov 2026 23:35:34 -0700 Subject: [PATCH] Integrate CardGame with VCC Plus disk builds and verified graphics demo Preserve the upstream library, demo sources and Makefile unchanged. Add the vccplus-disk target, project settings, delivered CardGame.DSK and actual public-MCP screenshot with build-43 validation. --- .gitattributes | 3 + .gitignore | 18 +++++ CardGame.DSK | Bin 0 -> 161280 bytes README.md | 133 +++++++++-------------------------- VCCPlus.mk | 9 +++ docs/PROVENANCE.md | 35 +++++++++ docs/UPSTREAM_README.md | 115 ++++++++++++++++++++++++++++++ docs/VALIDATION.md | 54 ++++++++++++++ docs/screenshots/running.png | Bin 0 -> 11923 bytes vccplus-project.json | 25 +++++++ 10 files changed, 292 insertions(+), 100 deletions(-) create mode 100644 .gitattributes create mode 100644 .gitignore create mode 100644 CardGame.DSK create mode 100644 VCCPlus.mk create mode 100644 docs/PROVENANCE.md create mode 100644 docs/UPSTREAM_README.md create mode 100644 docs/VALIDATION.md create mode 100644 docs/screenshots/running.png create mode 100644 vccplus-project.json diff --git a/.gitattributes b/.gitattributes new file mode 100644 index 0000000..fbc3629 --- /dev/null +++ b/.gitattributes @@ -0,0 +1,3 @@ +*.DSK binary +*.dsk binary +*.png binary diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..e1004ac --- /dev/null +++ b/.gitignore @@ -0,0 +1,18 @@ +.DS_Store +._* +__pycache__/ +*.pyc +*.o +*.a +*.bin +*.map +*.lst +*.link +*.i +*.hex +*.dsk +*.DSK +!/CardGame.DSK +build/ +.build/ +.cache/ diff --git a/CardGame.DSK b/CardGame.DSK new file mode 100644 index 0000000000000000000000000000000000000000..0a84846d7281a0ca49d58347b508ece167f743db GIT binary patch literal 161280 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. +A playing-card and PMODE 4 graphics library by **Pierre Sarrazin**, with its +original demonstration program. This repository contains upstream version +**0.1.15** with a VCC Plus project and disk launcher. -This library is in the public domain. +![CardGame running in VCC Plus, displaying all four card suits](docs/screenshots/running.png) -It is a C library that offers a PMODE 4 game library that can display -playing cards. It targets the Tandy Color Computer but should also work -on the Dragon. Most of the features should also work on CoCo-based -versions of OS-9. +## Download and run +Download [CardGame.DSK](CardGame.DSK). Mount a writable copy in drive 0 of a +**512 KB CoCo 3 / 6809 / Disk BASIC** machine, then type: -# OS-9 Support +```basic +LOADM"CARDGAME":EXEC +``` -OS-9 was suspended with version 0.1.11 but has been restored with version 0.1.12. +The demonstration displays a complete four-suit deck and the prompt +**PRESS BREAK TO QUIT**. Use the CoCo Break key to leave the demonstration. -Note that the sound features of this version of the library are not supported under OS-9. +## Build in VCC Plus -To compile with OS-9, pass TARGET=os9 to make. +1. Open this repository’s root folder in **Develop → C Development → Open**. +2. Select **Release**, then choose **Build Disk**. +3. Use **Show Build Products** to find `CardGame.DSK` and `cardgame.bin` in the + build snapshot. Launch the disk with the command above. -The "cardgame" demo program MUST be run from a 32x16 VDG terminal. -Use the Clear key to find one. -If none exists, create one with the "shell i=/v1" command, then use Clear to find it. +The project selects `VCCPlus.mk`, which includes the original `Makefile` and adds +the `vccplus-disk` packaging target. It uses VCC Plus’s bundled CMOC and disk tools. -The "os9timer" demo program can be run from any terminal. +The disk build and illustrated run were verified through the public MCP +interface in **VCC Plus 3.5.0 build 43**, using the configuration above. +[Validation details](docs/VALIDATION.md) describe the checked behavior and limits. -There is no "beep" demo program for OS-9. +## Original source +- Author: [Pierre Sarrazin](http://sarrazip.com/). +- [CMOC project index](http://sarrazip.com/dev/cmoc.html). +- [Cardgame 0.1.15 source archive](http://sarrazip.com/dev/cardgame-0.1.15.tar.gz). +- Archive SHA-256: `ca706dddd96fec63b829f8958c2e47485b0e1166129d45fda0b6369404c1bb54`. -# Adapting to version 0.1.11 +The [original README](docs/UPSTREAM_README.md) and source notices are preserved. +See [source provenance](docs/PROVENANCE.md) for the import and integration history. -openPMode4GameScreenMode() and closePMode4GameScreenMode() have been renamed to -openPMode4Game() and closePMode4Game() because the latter does not restore -the screen mode anymore. It cannot know in which mode the screen was initially. +## License -openPMode4Game() does not call resetPalette() anymore, which assumed that Basic -was present. That call was made only when TRUE was passed for emulatePMode4OnCoCo3. -Now, in this case, only palette slots 0..3 are initialized. - -openCardGameScreenMode() and closeCardGameScreenMode() have been renamed to -openCardGame() and closeCardGame() for similar reasons. - -restoreOriginalTextMode() has been removed from the interface, since it relied -on Basic. The program must restore the text mode itself, if needed. - -Under OS-9, this can be done this way: - - putstr("\x12\x0E", 2); - -Under the native environment: - - screen(0, 0); - -Function waitForKeyWithAnimatedCursor() and readLineFromKeyboard() must now -be passed a callback to a function that returns a timer value that increments -60 times per second. See pmode4game.h for details. - - -# Text font - -The text font supports ASCII characters 32 to 96 inclusively. It does not -support lower-case letters. - -The font is 8 bits wide, which makes it relatively efficient to write. - -See 8-bit-wide-font.h and 8-bit-wide-font.c. - - -# Version history - - 0.1.0 - 2015-08-12 - First public release. - 0.1.1 - 2016-03-12 - New #defines. New function drawFaceDownCard(). - 0.1.2 - 2016-03-25 - setConsoleOutHook() and resetConsoleOutHook() now taken - from . - 0.1.3 - 2017-12-01 - openCardGameScreenMode() now optionally emulates PMODE 4 - in a CoCo 3 mode to approximate the artifact colors. - Assumes RGB mode. Adapted to compile in linker mode. - 0.1.4 - 2018-04-03 - Adaptation to CMOC 0.1.51 (const). - 0.1.5 - 2018-08-04 - Added square brackets and backslash to 8-bit-wide-font.c. - Added sound routines. - 0.1.6 - 2018-09-20 - Adapted to CMOC 0.1.53. - Sound functions now declared by cardgame.h. beep.h now obsolete. - 0.1.7 - 2018-10-04 - Fixed openPMode4GameScreenMode() re: CoCo 3 mode. - 0.1.8 - 2018-11-25 - Now compilable for the Dragon (make TARGET=dragon). - 0.1.9 - 2019-06-03 - OS-9 supported, except for sound. - 0.1.10 - 2020-06-28 - Functions added: drawCharWithoutMovingCursor(), moveCursorLeft(), - invertCharAtCursor(), waitForKeyWithAnimatedCursor(), readLineFromKeyboard(). - Removed PMODE4_PAGE0 and PMODE4_PAGE1: use - (byte *) (((word) * (byte *) 0x00BC) << 8) - to get the ECB PMODE buffer address instead. - 0.1.11 - 2023-06-27 - The library does not assume the presence of Basic anymore. - See section "Adapting to version 0.1.11" for details. - OS-9 support is suspended [restored with 0.1.12]. - 0.1.12 - 2024-06-08 - Added setScreenBuffer2(), which allows to omit showing the screen. - Put several functions in individual C files to help reduce the size - of programs that do not use all functions of this library. - Added os9timer-demo.c to the archive generated by 'make dist'. - 0.1.13 - 2025-11-16 Added drawCompiledCard2(), which supports drawing the suit a little - higher or lower than the default, and supports only drawing the top - of a card, by specifying the number of pixel rows to draw. - Fixed drawCompiledPixMap() so that its inline assembly does not - refer to any global C variable in the code section that uses - the Y register. (That register is used under OS-9 to point to - the current process's global variables segment.) The old code - was not defective but its structure was error prone. - Added getCursor(), which returns the current position of the cursor. - Removed runPMode4GameDoubleBufferLoop(), which is obsolete. - 0.1.14 - 2026-02-05 Added setInvertedColorsParameters(), which determines how caracters - are rendered in inverted colors mode, from parameters drawRowOverGlyph - and drawColumnAtRightOfGlyph. - Added makeSpacesTransparent(), which determines if space characters - are drawn (the pixels take the background color) or not (the pixels - remain unmodified). - 0.1.15 - 2026-09-06 Added ^, _ and ` to the 8-bit-wide font. +The upstream library and demonstration code are in the public domain. +Original file-level author notices are retained. diff --git a/VCCPlus.mk b/VCCPlus.mk new file mode 100644 index 0000000..3d99ed4 --- /dev/null +++ b/VCCPlus.mk @@ -0,0 +1,9 @@ +# VCC Plus disk packaging; the upstream build rules remain in Makefile. +include Makefile + +.PHONY: vccplus-disk +vccplus-disk: CardGame.DSK + +CardGame.DSK: cardgame.bin + perl -e 'print chr(255) x (35*18*256)' > $@ + writecocofile $@ cardgame.bin diff --git a/docs/PROVENANCE.md b/docs/PROVENANCE.md new file mode 100644 index 0000000..404975e --- /dev/null +++ b/docs/PROVENANCE.md @@ -0,0 +1,35 @@ +# Source provenance + +## Original package + +- Original author: **Pierre Sarrazin**. +- Package: **Cardgame 0.1.15**. +- [Author index](http://sarrazip.com/dev/cmoc.html). +- [Source archive](http://sarrazip.com/dev/cardgame-0.1.15.tar.gz). +- Archive SHA-256: `ca706dddd96fec63b829f8958c2e47485b0e1166129d45fda0b6369404c1bb54`. +- Upstream terms: public-domain library/demo, with original file-level notices. + +The VCCPlus Cardgame source manifest also records the historical author-hosted +URL `http://gvlsywt.cluster051.hosting.ovh.net/dev/cardgame-0.1.15.tar.gz` with +the same SHA-256. A checksum identifies the imported bytes; it is not an +independent authenticity guarantee. + +## Git history and VCC Plus integration + +The original distribution was a source archive. The initial commit, +`d3a54e24eef8b1cb6f8427cc1d8968504d403b48`, imports its 39 original regular files before integration. +The original README is also preserved byte-for-byte in `UPSTREAM_README.md`. +Original author notices remain in the source. + +The integration leaves the library/demo C/header files and upstream `Makefile` +unchanged. `VCCPlus.mk` includes that Makefile and adds the `vccplus-disk` target, +which packages `cardgame.bin` into `CardGame.DSK`. The VCC Plus project selects +that disk target and `LOADM"CARDGAME":EXEC` launcher. The top-level disk is an +intentional playable artifact, while incidental objects/libraries/maps are +excluded through `.gitignore`. + +The new public README, actual framebuffer screenshot and +[validation record](VALIDATION.md) describe the installed build-43 public MCP +build and displayed four-suit deck. Source import, integration, validation and +later hosting/avatar changes remain separate events. The original distribution +archive and earlier local project were not modified by this import. diff --git a/docs/UPSTREAM_README.md b/docs/UPSTREAM_README.md new file mode 100644 index 0000000..279a27b --- /dev/null +++ b/docs/UPSTREAM_README.md @@ -0,0 +1,115 @@ +CardGame +======== + +By Pierre Sarrazin (). + +This library is in the public domain. + +It is a C library that offers a PMODE 4 game library that can display +playing cards. It targets the Tandy Color Computer but should also work +on the Dragon. Most of the features should also work on CoCo-based +versions of OS-9. + + +# OS-9 Support + +OS-9 was suspended with version 0.1.11 but has been restored with version 0.1.12. + +Note that the sound features of this version of the library are not supported under OS-9. + +To compile with OS-9, pass TARGET=os9 to make. + +The "cardgame" demo program MUST be run from a 32x16 VDG terminal. +Use the Clear key to find one. +If none exists, create one with the "shell i=/v1" command, then use Clear to find it. + +The "os9timer" demo program can be run from any terminal. + +There is no "beep" demo program for OS-9. + + +# Adapting to version 0.1.11 + +openPMode4GameScreenMode() and closePMode4GameScreenMode() have been renamed to +openPMode4Game() and closePMode4Game() because the latter does not restore +the screen mode anymore. It cannot know in which mode the screen was initially. + +openPMode4Game() does not call resetPalette() anymore, which assumed that Basic +was present. That call was made only when TRUE was passed for emulatePMode4OnCoCo3. +Now, in this case, only palette slots 0..3 are initialized. + +openCardGameScreenMode() and closeCardGameScreenMode() have been renamed to +openCardGame() and closeCardGame() for similar reasons. + +restoreOriginalTextMode() has been removed from the interface, since it relied +on Basic. The program must restore the text mode itself, if needed. + +Under OS-9, this can be done this way: + + putstr("\x12\x0E", 2); + +Under the native environment: + + screen(0, 0); + +Function waitForKeyWithAnimatedCursor() and readLineFromKeyboard() must now +be passed a callback to a function that returns a timer value that increments +60 times per second. See pmode4game.h for details. + + +# Text font + +The text font supports ASCII characters 32 to 96 inclusively. It does not +support lower-case letters. + +The font is 8 bits wide, which makes it relatively efficient to write. + +See 8-bit-wide-font.h and 8-bit-wide-font.c. + + +# Version history + + 0.1.0 - 2015-08-12 - First public release. + 0.1.1 - 2016-03-12 - New #defines. New function drawFaceDownCard(). + 0.1.2 - 2016-03-25 - setConsoleOutHook() and resetConsoleOutHook() now taken + from . + 0.1.3 - 2017-12-01 - openCardGameScreenMode() now optionally emulates PMODE 4 + in a CoCo 3 mode to approximate the artifact colors. + Assumes RGB mode. Adapted to compile in linker mode. + 0.1.4 - 2018-04-03 - Adaptation to CMOC 0.1.51 (const). + 0.1.5 - 2018-08-04 - Added square brackets and backslash to 8-bit-wide-font.c. + Added sound routines. + 0.1.6 - 2018-09-20 - Adapted to CMOC 0.1.53. + Sound functions now declared by cardgame.h. beep.h now obsolete. + 0.1.7 - 2018-10-04 - Fixed openPMode4GameScreenMode() re: CoCo 3 mode. + 0.1.8 - 2018-11-25 - Now compilable for the Dragon (make TARGET=dragon). + 0.1.9 - 2019-06-03 - OS-9 supported, except for sound. + 0.1.10 - 2020-06-28 - Functions added: drawCharWithoutMovingCursor(), moveCursorLeft(), + invertCharAtCursor(), waitForKeyWithAnimatedCursor(), readLineFromKeyboard(). + Removed PMODE4_PAGE0 and PMODE4_PAGE1: use + (byte *) (((word) * (byte *) 0x00BC) << 8) + to get the ECB PMODE buffer address instead. + 0.1.11 - 2023-06-27 - The library does not assume the presence of Basic anymore. + See section "Adapting to version 0.1.11" for details. + OS-9 support is suspended [restored with 0.1.12]. + 0.1.12 - 2024-06-08 - Added setScreenBuffer2(), which allows to omit showing the screen. + Put several functions in individual C files to help reduce the size + of programs that do not use all functions of this library. + Added os9timer-demo.c to the archive generated by 'make dist'. + 0.1.13 - 2025-11-16 Added drawCompiledCard2(), which supports drawing the suit a little + higher or lower than the default, and supports only drawing the top + of a card, by specifying the number of pixel rows to draw. + Fixed drawCompiledPixMap() so that its inline assembly does not + refer to any global C variable in the code section that uses + the Y register. (That register is used under OS-9 to point to + the current process's global variables segment.) The old code + was not defective but its structure was error prone. + Added getCursor(), which returns the current position of the cursor. + Removed runPMode4GameDoubleBufferLoop(), which is obsolete. + 0.1.14 - 2026-02-05 Added setInvertedColorsParameters(), which determines how caracters + are rendered in inverted colors mode, from parameters drawRowOverGlyph + and drawColumnAtRightOfGlyph. + Added makeSpacesTransparent(), which determines if space characters + are drawn (the pixels take the background color) or not (the pixels + remain unmodified). + 0.1.15 - 2026-09-06 Added ^, _ and ` to the 8-bit-wide font. diff --git a/docs/VALIDATION.md b/docs/VALIDATION.md new file mode 100644 index 0000000..a09c171 --- /dev/null +++ b/docs/VALIDATION.md @@ -0,0 +1,54 @@ +# CardGame installed-app validation + +Verified **November 9, 2026** through the installed VCC Plus public MCP build +and disposable-playtest interface. This records the supplied graphics demo; +it is not a complete library regression suite or card-game playthrough. + +## Configuration + +- VCC Plus **3.5.0 build 43** with bundled CMOC/Make/disk tools. +- An isolated native copy of the installed app preserved the active CoCoMan + workspace. Its emulator code was unchanged; the bundle identity was changed + and the copy was ad-hoc signed for isolation. +- **Release**, **512 KB RAM**, **MC6809**, **Disk BASIC**. +- Approved Make recipe: `VCCPlus.mk`, including upstream `Makefile`. +- Public build action: `disk`; declared target: `vccplus-disk`. +- Launch command: `LOADM"CARDGAME":EXEC`. + +## Build evidence + +- Project ID: `7E8305F0-FF04-46E8-A991-7E86A76F372F`; source revision: `0`. +- Recipe ID: `d0430e152313d2964ea1f3a601b2e0062cb10119c9f5084ed6c717f5bed995f0`. +- Build ID: `47760045-032C-490F-AA75-1B29BB368D37`; result: **succeeded**. +- Artifact ID: `E27DB402-DF5B-49C4-9CFC-63E1F5D4632E`. +- `cardgame.bin`: **6,190 bytes**; SHA-256 + `35a87b7f8027b2343c533005c0f388ee47ee7b17ef88b9405aeaad9eaa961688`. +- Delivered `CardGame.DSK`: **161,280 bytes**; SHA-256 + `584df711fc5814cadaf958c772c57cedc6aeaac39731fe9095ebb43ee000c475`. + +Compilation, library creation, linking and disk packaging completed. The +available build log contained no compiler warnings, and the build receipt +reported no diagnostics. Original library/demo source and Makefile were unchanged. + +## Execution and screenshot + +MCP-owned run `1BC4F286-AFA5-4F93-A888-B06BDE0A4F8D` displayed the complete +four-suit deck and **PRESS BREAK TO QUIT** prompt. The actual framebuffer was +captured after **1,096 emulated video fields**, with **6,912 bytes read from +disk**, zero disk writes and the same disk SHA-256 as the verified artifact. +The run was then stopped and its test disk retained by VCC Plus. + +[The screenshot](screenshots/running.png) is the actual **640 × 480** framebuffer +returned by MCP. SHA-256: +`5968f09c6ca539b250cf6589e67263d2bb3c07d573c3acaf7c99dd7236af6f67`. +It is not an illustration or a capture of an older supplied disk. + +The capture shows the quit instruction. Sending Break and checking the return +to BASIC were not separately tested; the owned run was stopped after capture. + +## Scope + +This establishes the specified fresh Release disk build and displayed demo. +It does not claim all library APIs, OS-9/Dragon targets, HD6309 execution, +Intel/Rosetta qualification, physical CoCo hardware, audible audio or a full +card-game test. No private connection grant or raw host log is included. diff --git a/docs/screenshots/running.png b/docs/screenshots/running.png new file mode 100644 index 0000000000000000000000000000000000000000..125bdc9fd8ff965348e6dccb8e9351d2e341655f GIT binary patch literal 11923 zcmeHtc~n!^-gXi}rYb7p$l%b58U?IXK!)H@u~vzS0tzHJf`SAEAri;|t=g&(>x7CB zlqwELK!iXcBx*4VLZpa@KoW=$#)L3rAjA1Kkkfm;Yu$IPzU%$o_5N}HV3CuPefIu6 zzvk`iy1<3= zLH{2PZQY7m3O*a7(B}@L3`Tzf{^o!`Fgz23e1l2MoPc~r3rBCdX}T7nQ1&K2Y*@RK zjP7e`z1(yE`owqg_X!oB=i_ajW{bV+A9na~f7)dH1EoDR|Lb5z@|qi`dmF?JkgaZ^ zXCexXF)*I8cws;8-~!9VV;A#06FHFK7Stqz(Oclka|POhv(IFvz5X`G;N2|n_1Mtq z7LMp;*CSh}>A%>5N=6>?pJC$|{Ra}`|Dh<+`J@Yn<969i!Hq|)UB61T+rC4J4nS*i zTUY4=FEi0oWyy(1fkScg<8|GH718Tr4R@%M?clTfW1lN~G-iov#_atP_F2*KGZL-a zC(#=b^vsntXij4{2&-uU=(3ZT6ZG-SnCG}O*wC@U7iz1eUimf4&+1ksw6veJQ|V+i zX!eS@KQKbGs+KnMIKHX>{KsyYlg;s{3W+l9QwA{)qtsYkxTJr~JL4Ou)mEnC357}$ zo83Tp;J6FE)~C^Tm_><`&SCTx2vy*c$ICZ18BIU%gk(-n&%>MY3zAzec@Cd_b_Auc z+bA#F9zNW@qK}yo1RL;g(sH2>^uCajk#5mVypaOj>Ar&}TI2<+oOxBJwOvK@;SgwI zQ&qRUfa<_^%RnD;DLX6TjXc#pz~Onvnc5s2_Vqxoyg=7WwBhN}gHm)XUA!QPFAzkO z^Zg)Qt+$3n=1KcYmhVBkH3WnqhO}eKjq*}YDGl;n+-bI26UQFjwr|Gas5J9O zTUld5AWXIVDZ2pI%80;;f`TL`-%5x@#N}`Zm#zwIp~}5(ayFo`@fOD%wiQ}(%)VYb zbF5wgz(P#@(QZBg0R|~EURyrQ>hZHhV<2q*$YbraWFAf@-)UqV=*=+|w(q#R9x_vIut`;P0p3@y5)6tYM=1$`-j}Ob)~Cr1QA+vy~_7^VREA7 zb0=pfw*!X#XMdBRBnJCKv7Km`AEKx&q;w!sIzn~9$pOIpdS~6ES!?!)Z;*?u`K7G4?dRLbcSTuAG4%xFS0U^q=tsC z;6~h`kFq!T??R$N;ratV!zIitS%@Zqjc$R&d`QrjU6x|`X9Hat;Nl8PDN!5{u(S)Y zm)@ER=iR77@+fwuBf5+-arm#~UL1^ZHtvWQA5VdRvzT?iDVAi??Wr$_Mm z4m)eQBihO!Y7LU%5{w)rsSYNYdwsygQ3>?++L4Vs;Agizf=*Q<;ksAPTz6bk)j()M zmNzN9U;%3x?SoSswJ7!952oKH^Vjh!ZXF$k7LjuNP03=-@vbfh1=tkChIGYL5-#3za;#k#44Z635cOl zfGO~XKg`h^7F?2OA{?0Bsm}^eVIbfRQLMs^dK~=iga79A{Q(>bYmhnH3+mafRvRdp z)K|ow6{QC>g)hK|eCAbA7%AZjLlIDZCCNOOZz_DA`3NC4fkD8y?%99h5C=a8h1KZv zqZIw}B2ScG#RLaCyd-QnKWeSLrlt+I$6E0=qt-!U?t%9|AX{YAi!2 z8n(0=?d2-N+4I+ai%mQo>}`jva}+Vj?Dr6Y*r*+UD}%P6q#0|q$n(B3y@8s1$|W6v zB^HE3X~;GhG3PXJ$lsbCgabp)+=kPILS}=54b9WVq`gPzuwp7G1`W=-LN!moKD0Ak zqhKGVtlPV?oN{#f1px`InD~=OAF^l+ZCXE`L))AkjCd~rtg8IimB=M+nj<=X=NiNH z`k?IuIU!HJy;grozM7bwIJiW(Mfy4W?(g`+huLpl*WxP%XxW}~`xvKW4L{FoBm>FvV8c8nhAh=|yN{<(|LH_aj_tOx z@Ab3I>kmYmC%HK>7a$>_0aZ)6@PZS9ArGWzd_=_eNRBDD10QE)Kl>vdw7nGs`ppr0fJ;GG9@bW*aRC|l~ct_HJhy2 zMT15AbZN4}0_dh-t2S*azkG#uBwbd>YPlY#6;R@v+TKWqGA96g9TVBp+ft##YOJ*3##7&YQ;eS9hhU%u=@IgS85FP9Yso zdlBiwUV~|EdeSF|?(cP4gAHy>kASnv%XG)Fr)r7V#G|irP(?PIk@axRl;2!>K3#10 zo5sM|KS(hY?%+UZoW{m(04au(aHN zZE3TqK!OVM12G??`(EE0r-RnG>_+r_i*ZjBf`$?%CJv2H>A4nEXhz1+$J4*!S8SD1 z8CtUGi8yG6Q(j}#3>nSijO(15ZuuZZc1UWnnMcrMWn_s-pKPCSRLmK#HR6mv0*n+s zVv)3|Q32zF2KdJS$)gqQv_L|A2Dmn=yGlnHIoNuzO50ND@6HAkHyDPfV^8cmGb9py zw*9cXg*vm7Zx`-6Z!k4cVx7Uam}T)A7JL@a-8_6t3-B{QEBLm!1F0U50Sn5l;RLI* zr7pkVqg7S4O_n8B{5TV}8}ZVUB$4gWy}g=VUSps5e00jW{LqmQQd1bWVYN<9W}m5< z{ZhpC5mZmkCZ({`&J>iE&c@MOep~9l81Rev<@b@C#{yb6`H{i{J=s@0l;RmD?oye! z(XbZt`sXDzN69na{j^RP4k%v8g)o{v{`33+U28MAxLOb(>wa>>x`iK_5bMeoC&ah` zx+fCREVG-hkYhBX9;7u6$BKH~&ZMi}WEWG0U2QNcbfQjfuN2+#Oq{%al;>4G{Hq=e zgKGlL>qp8Bdgh=-j0&G9yV_a%=8*(aDec5;r;J1Dx4BSkJj>KdV0TGW%3M&)Smj4w z7HrsmAhH@^9=>K}n zT?E@`x%^|{CyULhodZ8DTDt47Vcw3Sip~0(s01zIyRQ(JR~T$TUHB%jSf3^!WbJ54 zkNaG1T1oE5$(jZWXHT~)->aDo*-d6{^T@>C+s>z~-2{N*?xbHV50HmD0C8T&LBq9ejk%|}APS}tDb{l`I5ZZ9kU25Ft zx;~y;9;lWFPBOnW!NE~?kv-vDUF0sjEi{|%p7e74ABH3lh2_tW{ft!D4WPo>9on@8 zDHl$lQII075EA6J9gv{(-PP{1OG5UC47XGj!i}?JxLEuxgvxXI&`BtPS^hbU-A;M) zOcRuygVLp6R3Kq*KHBO+_nkqSqtX@3$i5=;K=Szx;MF#_Kk_q@8z~2XTi;X;4d7yE zJ4WU}uZStXNDnHA6nI#YDve>1wSIF2UJ{dD!(ST|HL>xj0HmOJ`$Y&7!h?Q5b*bBr zbUk}8)tC2eIO_H-w6V2uh7EhWN~2RiBCK&=+uk*#y|Xk)n!l-YU^y zUP9Dhz*Sk(SvtGpRjyXKe2=a=aiwlf%1bi|PC;Dxz+0!Td**&8Z?=H7`g{d3eq?a3 zVP5QdXK#dy+yGqU<+P<%dUHL2m-6gBJ0pPZ1rcZd99e3cgj7tdhOFCylHdR{U zpC3GBhqJ6t*!-h<>&6u7((7!Q;H$i4#qgY|3gXLSCF>N@#!#9a4X%|8fo3Z3;ka+- zA~9%S^UWA%Q$C0`J3AivN*pM)uh9BMBzi6ZjP2@XW-v0umTL0HJcMZMw8;BX?6`rt zZi_*UuQ=%lFrfZhd&0PVnPrJ4!K(Qvz4Z?k1^@Sl_S27`&ADoBNYooK<9=~zf46o< zzI^U}9pI{`WQsUar!FkM88Fv&(-yVrxci4Y*Fbah>kdmp8i*&yH25xF_XoZDXyqr; zrWC@l(53K04tsm6Ao8ulEGYR{iL7A*j-b?p!xfe1g~faCVRKNvl|}vt5JX_zSp=s{ z;LG6rpUhJA&kx3geuZp1&zsyp&G@l65*f%~WS{-SJ$wGOh)i1Zw2@Me> zCG6BNIixt&7j^DUpuRFpDP|^0(Y@^s9&3+!^F&?{=Iuzqgp-=CK3i*I9O21rRkf~N zmaRGvAHrq-uD!_gtI;S%1dpXhxO5vqec7a>-Hy zTwg@nm%Fz&J;kFY)DAqK$c=hqmO+MmZw|k)PlI_6g*vjkWNGY8>1=x(byL1!-p!nt*i%o;k znE4)FfaF9SUos6b6*mnCv9uee^qpD@Nqrl84^&gWswM^QmDk9vj*>=YEicw>yzm9U z)Zw;O5VFa73!d-1{=}hl7M@e$b&y1SS{{z0Nsmg8G=z-%wO-{vDr$OZqvBHtbTI=c zay*^2HR%Imi}3lVgKr1kK^#n-Moyq=6?I8Vr7Qwt(R;8<=fP^!ce)yF)Ms53{G<#n zXS%na$hlOmyZvY7QLMXK+EDd zzv@u-Iz7V$C=;|Af%>gSB~;X}9#JtpSlPFm3a%Mj0ad$yoA)(jeYp;xF=?&3kj;;9 z8>pM>U3MW`%Hr}w_r!vz1H7tmpppzi(v|APaN`SUj~M2M$ZIno8>U@k%*OZdRsg@# zR}M(pS^{E(J+S*CvSbp-e}Q8evh&0L!IB-J-0P1BHww z_o_&7r^ERfS%orNOILZkjvIIAXjd3M*mQ{$__=rj?;f&3SI{2$E5b&$=pXfQJ`k+F zxc_lNu~S%y-9klp?-O<`OCB&^_YWb5+xur7m-x!5$wzw+B-!n>G97hS1q<(*_AGJPO=7Z6)P;cs;`)lqdRriLtE(x-mU=eFYi-O zAtB2Z(H|{V29!OaLp^&ng*F90z9M47!3P(QPg$D{?gMadS3W+Dq|7jQ2qV?P9ieSo z0O|VjK7mezgBStg;m+Z>RmthqcM^00qfA+>guYNgSCiVc3Rd3|#(rLV4{ynn=Au6f zU_N0|rKzy~+q*af=r_QHSCV!i0%`Fr(AfWP-KUy4Q_Ykjnw+@_2US;l>SjEYt03EB zuLQBlB4R20Nq~_n#La9Rm)2SIs#+Ogp6Z}lE*w~o(!0kq^LiqL$-PFZMXHtuI95ff z@PBKM*_@FB&5${^6d+=5cVw!y*G7y~C-I3?t*|$h__5E29Lr!@? zfF{1H$(BD8j6`ToyIu%lm(8nW^$d~&%a_>j;R+EWPGdWBP;ilvuC3BUbPF!_%agkr zq!$@|eMRqkV7{nn2A-NNjy)cm`=Pm$%-#blC6i1wtGFY;mv9y_Q7uF!YoTNAGMWfnkba#3=f$l(KZ zL{g0>(1(qr_np-vIZ#~^S=6ZuQSXMNhgX zNkbimr;_bJS4vOWk37z3bgSa{a2-;J%D~G8@!6tTNEb)~n>~X2!^iZt?m}Dq9YT5( z30_U9S)k()DFI|iJ0=WyEYK-fwzyjvEG0K!R_VSv-N*Kt@)FMuoZ@S~n_G*+XrlPP zIP;^v;DfgBJaNE6C~SY3O`@LsI_yRn=1TPwdwQQB*~xbk&cj=`H@&_uHc683;*jCD zkVz-MwF_vsXMhMY!@K<5c={yW8inEz+u-<6#+AVBbDu!+VF2H1)*hImtyVsTDS%7h z7}8-op7a`JxX-$(#3U#;Bd3B?L&|~SHTYW1_b$oKS zN-T>%U+Tve&7UH|rBI{UMnl~VbnTN#b2)`1e{^6E;{+1?U7$&RVHh2dt-5E zKDJrL_vWwnX@Li1_!@}hStGw01WS~0md-kYup1lAQiqXXL64j6fhC8V?VpH*fGJS<;S_BQ-h}p*pVbAGoRp897L{;AQwXzkd4Xz6Z&Kp;71r%WLGq6BJZggTRN zgTltWx6^YB6``$h4*xWu?2zZsXP+FDhfC=`gtcnsfebR5P8#ENNnBv9QaPP%_Rdu3 zYRyH+k~uiLQgVJX{bj6FM;rP|p9hReoQ-yXWW`XwN7Rdt#$eZQ=_0F@xmr3LkhZ_E zkG>op5ZHb*SmUV6Sfz_oxoMcE`p~yyqxhMJu!&BaF54rGE@kw5?6>>Bj{_ZKFgAxS zXyChtbYGO+^GDYa2D1xiCLpf{d!`5&4syYsbnU2mE_CQ=6^_(!l{_Y3gMFocvavHmY0?Ey9fdJR2XjY80Kz&+8%b_=66jW*+@!oa-;G3VQ zNE`PC8y@nsXNSg-zo$q3-sNM|5b!1dDffFMOLqX|e^jj+S5{`209tFTn^V09UAEC? z=oI3fTOji49<16hmK65-ICi*t-ZCg3Q@k$dFIDLb0Dfj$*sZZ~%PjJYB4=wY=M-Vc zXO?wNK)eH9)=0G57j}N^M}ZrIhi%I0`-qFChOOCW7@1t^i)3k)0fES_Cgao#RnjAc| zD!}Sz%lL@q;uZiBD@5!UJ)S`!NpG;>wtmFDn%(!_minTqe%q6YR2&$@LFm`xiF+R7 zN4%59TBq7RGS!%Z!tw|A>B+?rvvDD*o%}O?lNauq%gEL1@|A1Vm6~Ljx$w1C(63b2 zMF!@+(^6J{63v3sszMm=wno66vNBnTaxUmwZfk!>63uxJ5LUoj5243~$0HnTyoIp0 zbVOl1V#C3HwJrfMV~X=ujt?h$d)T<*8n{W=K~csq90`jpvA^##7n+_piX`9+K#cHWjur47eiFrhfS^Y9J5Z#{#PfO8EyZ;gjtm0>SBFyquUYv8+k|ZlhR<4Z_NZnoM*`|43C#s(yB@6!5B}T&KdGQzEf_3~11)y0yGM7e zD?2v+8FZ4$&^2ECu zyRf;r?z=gE@_W3Run?8HP8xrAxzsQbl?2(pQ&TQO(9@1mB3(8e8}P;Zk2$EASDZsM zPpJj|eeBRM%d*%lqfadBlyp37tL-T$XSIjJqBh-Z>3#U*y6oHdW8CZYHT9DLg%c)^ zuIhJ~t&BfCs9FE7Cz*IO_wwf4k3+t1=TtM+5&psI2q#He3PaGuCa6!kHT9hA7~^{U z;g{S&$|9J&YHNpL+iD~8#X}=$TZd|-*1VC8RjiQ^Tb@q-scNvGOfiy!ABE(lpYb5k z|7^HTreB;q5C)`HO}g=v6>Y_!lG(?5^Al z!#9m*`7}(0-|ORe@-Md`vp@euzNnO