From 219142139c02f47f76656fcec3387ef1bbb8e815 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jan=20H=C3=B8ydahl?= <janhoy@users.noreply.github.com>
Date: Thu, 8 Aug 2024 21:04:15 +0200
Subject: [PATCH 1/5] TIFF EXIF orientation fix Based on #549 Fixes #548

---
 .../illinois/library/cantaloupe/image/Metadata.java | 13 +++++++++++--
 .../library/cantaloupe/image/exif/Directory.java    |  8 ++++++++
 2 files changed, 19 insertions(+), 2 deletions(-)

diff --git a/src/main/java/edu/illinois/library/cantaloupe/image/Metadata.java b/src/main/java/edu/illinois/library/cantaloupe/image/Metadata.java
index 8a2d26819..00d482554 100644
--- a/src/main/java/edu/illinois/library/cantaloupe/image/Metadata.java
+++ b/src/main/java/edu/illinois/library/cantaloupe/image/Metadata.java
@@ -5,6 +5,7 @@
 import com.fasterxml.jackson.annotation.JsonInclude;
 import com.fasterxml.jackson.annotation.JsonProperty;
 import edu.illinois.library.cantaloupe.image.exif.Directory;
+import edu.illinois.library.cantaloupe.image.exif.Field;
 import edu.illinois.library.cantaloupe.image.exif.Tag;
 import edu.illinois.library.cantaloupe.image.iptc.DataSet;
 import edu.illinois.library.cantaloupe.image.xmp.MapReader;
@@ -132,9 +133,17 @@ public Orientation getOrientation() {
     }
 
     private void readOrientationFromEXIF() {
+        Field field = exif.getField(Tag.ORIENTATION);
         Object value = exif.getValue(Tag.ORIENTATION);
-        if (value != null) {
-            orientation = Orientation.forEXIFOrientation((int) value);
+        if (field != null && value != null) {
+            switch (field.getDataType()) {
+              case LONG:
+                orientation = Orientation.forEXIFOrientation(Math.toIntExact((long) value));
+                break;
+              case SHORT:
+                orientation = Orientation.forEXIFOrientation((int) value);
+                break;
+            }
         }
     }
 
diff --git a/src/main/java/edu/illinois/library/cantaloupe/image/exif/Directory.java b/src/main/java/edu/illinois/library/cantaloupe/image/exif/Directory.java
index c421ae259..193397d44 100644
--- a/src/main/java/edu/illinois/library/cantaloupe/image/exif/Directory.java
+++ b/src/main/java/edu/illinois/library/cantaloupe/image/exif/Directory.java
@@ -170,6 +170,14 @@ public Object getValue(Tag tag) {
                 .orElse(null);
     }
 
+    public Field getField(Tag tag) {
+        return fields.keySet()
+                .stream()
+                .filter(f -> f.getTag().equals(tag))
+                .findFirst()
+                .orElse(null);
+    }
+
     @Override
     public int hashCode() {
         final Map<Integer,Integer> codes = new HashMap<>();

From 565de9e8bdb8262c20666ff9bc5622881f82b1a3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jan=20H=C3=B8ydahl?= <janhoy@users.noreply.github.com>
Date: Thu, 8 Aug 2024 21:10:23 +0200
Subject: [PATCH 2/5] Add signed variants and log warning on unknown dataType

---
 .../illinois/library/cantaloupe/image/Metadata.java    | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/src/main/java/edu/illinois/library/cantaloupe/image/Metadata.java b/src/main/java/edu/illinois/library/cantaloupe/image/Metadata.java
index 00d482554..b93a3bcee 100644
--- a/src/main/java/edu/illinois/library/cantaloupe/image/Metadata.java
+++ b/src/main/java/edu/illinois/library/cantaloupe/image/Metadata.java
@@ -121,10 +121,7 @@ public Orientation getOrientation() {
                 if (orientation == null) {
                     orientation = Orientation.ROTATE_0;
                 }
-            } catch (IllegalArgumentException e) {
-                LOGGER.info("readOrientation(): {}", e.getMessage());
-                orientation = Orientation.ROTATE_0;
-            } catch (RiotException e) {    
+            } catch (IllegalArgumentException | RiotException e) {
                 LOGGER.info("readOrientation(): {}", e.getMessage());
                 orientation = Orientation.ROTATE_0;
             }
@@ -138,11 +135,16 @@ private void readOrientationFromEXIF() {
         if (field != null && value != null) {
             switch (field.getDataType()) {
               case LONG:
+              case SLONG:
                 orientation = Orientation.forEXIFOrientation(Math.toIntExact((long) value));
                 break;
               case SHORT:
+              case SSHORT:
                 orientation = Orientation.forEXIFOrientation((int) value);
                 break;
+              default:
+                LOGGER.warn("readOrientationFromEXIF(): Unsupported Orientation data type: {}",
+                        field.getDataType());
             }
         }
     }

From c6e9d676561f1683828dd142b9b6530426a6ffe0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jan=20H=C3=B8ydahl?= <janhoy@users.noreply.github.com>
Date: Fri, 9 Aug 2024 11:31:01 +0200
Subject: [PATCH 3/5] Add tests

---
 .../library/cantaloupe/image/Metadata.java    |  11 +++++++---
 .../cantaloupe/image/MetadataTest.java        |  19 +++++++++++++++++-
 .../cantaloupe/image/exif/DirectoryTest.java  |  10 ++++++++-
 .../images/jpg-exif-long-orientation.jpg      | Bin 0 -> 36000 bytes
 4 files changed, 35 insertions(+), 5 deletions(-)
 create mode 100755 src/test/resources/images/jpg-exif-long-orientation.jpg

diff --git a/src/main/java/edu/illinois/library/cantaloupe/image/Metadata.java b/src/main/java/edu/illinois/library/cantaloupe/image/Metadata.java
index b93a3bcee..b78b15a7b 100644
--- a/src/main/java/edu/illinois/library/cantaloupe/image/Metadata.java
+++ b/src/main/java/edu/illinois/library/cantaloupe/image/Metadata.java
@@ -136,11 +136,16 @@ private void readOrientationFromEXIF() {
             switch (field.getDataType()) {
               case LONG:
               case SLONG:
-                orientation = Orientation.forEXIFOrientation(Math.toIntExact((long) value));
-                break;
               case SHORT:
               case SSHORT:
-                orientation = Orientation.forEXIFOrientation((int) value);
+                // According to spec the orientation must be an unsigned short (16 bit)
+                // However, we have seen exif data in the wild with LONG and SLONG types
+                // Thus to be lenient we accept either and convert to int (github issue #548)
+                if (value instanceof Long) {
+                    orientation = Orientation.forEXIFOrientation(Math.toIntExact((long) value));
+                } else if (value instanceof Integer) {
+                    orientation = Orientation.forEXIFOrientation((int) value);
+                }
                 break;
               default:
                 LOGGER.warn("readOrientationFromEXIF(): Unsupported Orientation data type: {}",
diff --git a/src/test/java/edu/illinois/library/cantaloupe/image/MetadataTest.java b/src/test/java/edu/illinois/library/cantaloupe/image/MetadataTest.java
index de3d914f6..e3b46bd3e 100644
--- a/src/test/java/edu/illinois/library/cantaloupe/image/MetadataTest.java
+++ b/src/test/java/edu/illinois/library/cantaloupe/image/MetadataTest.java
@@ -17,12 +17,15 @@
 import org.junit.jupiter.api.BeforeEach;
 import org.junit.jupiter.api.Test;
 
+import java.nio.file.FileVisitOption;
+import java.nio.file.Files;
 import java.nio.file.Path;
 import java.util.Collections;
 import java.util.HashMap;
 import java.util.LinkedHashMap;
 import java.util.List;
 import java.util.Map;
+import java.util.stream.Collectors;
 
 import static org.junit.jupiter.api.Assertions.*;
 
@@ -232,7 +235,21 @@ void testGetOrientationWithOnlyIllegalEXIFOrientation() throws Exception {
         }
     }
 
-    @Test
+  @Test
+  void testGetOrientationWithOnlyLONGEXIFOrientation() throws Exception {
+      // This image has exif Orientation stored as SLONG, causing a failure (github issue #548)
+      Path fixture = TestUtil.getImage("jpg-exif-long-orientation.jpg");
+      ImageReader reader = new ImageReaderFactory()
+              .newImageReader(Format.get("jpg"), fixture);
+      try {
+          Metadata metadata = reader.getMetadata(0);
+          assertEquals(Orientation.ROTATE_0, metadata.getOrientation());
+      } finally {
+          reader.dispose();
+      }
+  }
+
+  @Test
     void testGetOrientationWithOnlyXMPOrientation() throws Exception {
         Path fixture = TestUtil.getImage("jpg-xmp-orientation-90.jpg");
         ImageReader reader = new ImageReaderFactory()
diff --git a/src/test/java/edu/illinois/library/cantaloupe/image/exif/DirectoryTest.java b/src/test/java/edu/illinois/library/cantaloupe/image/exif/DirectoryTest.java
index 9624a6c8a..6a740e2d6 100644
--- a/src/test/java/edu/illinois/library/cantaloupe/image/exif/DirectoryTest.java
+++ b/src/test/java/edu/illinois/library/cantaloupe/image/exif/DirectoryTest.java
@@ -366,7 +366,15 @@ void testGetValueWithoutMatchingValue() {
         assertNull(ifd.getValue(Tag.MAKE));
     }
 
-    @Test
+  @Test
+  void testGetField() {
+    final Directory ifd = new Directory(TagSet.BASELINE_TIFF);
+    ifd.put(Tag.MAKE, DataType.ASCII, "Cats");
+    Field field = ifd.getField(Tag.MAKE);
+    assertEquals(DataType.ASCII, field.getDataType());
+  }
+
+  @Test
     void testHashCodeWithEqualInstances() {
         final Directory subIFD1 = new Directory(TagSet.EXIF);
         subIFD1.put(Tag.EXPOSURE_TIME, DataType.RATIONAL, new Rational(1, 160));
diff --git a/src/test/resources/images/jpg-exif-long-orientation.jpg b/src/test/resources/images/jpg-exif-long-orientation.jpg
new file mode 100755
index 0000000000000000000000000000000000000000..8ad6fb145a6d95d821fd1f2cc1ca081db77e6a5e
GIT binary patch
literal 36000
zcmeFYby!@>(l0znupq(R-Q7KSaQ6flZ1BNdgM{E39D=($B#_|l?(PH)1iO>$ea^{y
z-hJM4?|1J%-}9X2p;u2;{i?gFt9#9w)%7&@v<7(bN?J}D00jjA$U^=APwUJ#Qtlvg
z06<X@zyJUM5CE`H7yv{_3nBuMBLF=6vn>Ke`1iJSC<p-iCtV40wE-aA`vU;9FaCao
z&V~lS{FH!V0syjM{%8YwA(Wp54(e|dIEctU`e^yBk1tSkf1;oP0BESc_cs6y{kJwV
z%^&K1TJmeWzphVzW#=M50`Lq578Vxf8Kipl>=_(9G6FoLpgn(%h>VVgfq{;Oj*f{#
zgo}wqfQ^ohM~+88OiW5jiit}>ML|MEL_$jP1W^J7fx^SVqaq-nl3<}@k^CQ*rw#x*
z0w5UB2Lpu;fJTRcL5F(k0+2$+{|xF^`O_o-6f_JhWRwVqNY5bx^)DbkfPsOAj2~hE
zMA`?!2f(5~!ysoDhr?7ghNl2yaRkKXAW*)n?!;Cb|3<}W;uwgCgoBHRPe4sWOGnSZ
z#m&RZ$1fluDJ3l<EB8uWLsLszM^_JMYG!U>39@o>c5!uc_wWpQ8ypfE_AWdwJ|QtF
z`9n(T$K1U9g2JNWlA7AO`i91)=9VvCySjUN`}zkaCa0!nX6NP?);Bh{ws&^-_7Bd^
zFD|dHzu(;c_-Pju0Ok*~AoU-X{gYh~CqO|%rUe%Mr(ICcZa)o2hkZuQ4u>JG3U3U?
zq~HiZz<L>*Q{9P3$*J}Y+r)7k35SYno%-yjX}>J{-!m-m|C42ZH|!sFEdY>Vpdgb6
zgANb{9GFcWmjhE4*gn19xU25*puBhj9BRKiY1chGsAB>(no1#?^I$4x1jsC_<nn*V
zCl*Y#W9i5&$lqw1i-4@Q(bw=!GaopU&TMi-2BFg#2Y8Wz0rAn>8gHFN(X#QI;+w?$
z^t@;YYx5l>;y5RT8PFAW+rVDehCGb6bDS7Dk3>H36vd1+ufulk+4Bt###diUu_iOA
z!Zy5FU&3P_wUh1L)R!?F+Rho<|4y-2U*1K-zbW3t){B35b>yVVH=l@ai08{bVQ<g1
zhtWm<K_Q#d0)V_L`eCEivQ}UA(~NDKsI9Tkc<Z7b6(=6B)3G$r(SuYqNO8E{m~K(^
zE>ly>gi_^$3a_uEMdcKM7Jbcm;D~Ert{u-&2mWcaUBVG#{0F%4_Nq?b6w%O`v?-*h
z)?{P__h?iZJibR~9Z5tcp0nhJ#kRBWA<vC69X%htkxG%a4JEYd>ryvvX~N~z0BJxw
zN#C4MJ5=%Bdh<!OE5_8l#vDU^1CQ(^btlZQN1J2jv8+n_S2M3qwxljFYvhR2ttnp|
z(kgxq<&Lk>Hh-^e>H*)Qs99$yBQ-_IbU@?2BRM*X&qsS02tIjcz{{CdBMdK=b|?Ks
zXP2yRQXr6jse{EgGuu;R*h=H|TM?4_xLzF}ev^mAcrG=l`PvxeYW&{M^`@zEsoYK`
z*INGXM0_&k+4$BX&Mx`5!Ai2pxk9TO=0!}-?{WgNMm~j!;~62UeBBX^>G8Z!Y)Hz>
zwdhP$2a%xF);cc=Pd+d9Ym4|AEaDH~`!U^G^djq%+iQl}WgFIyv>4bJIa~I`h}V1%
z&n$=)sT_YOZZ)nj%9?I(M4ym#7|!3fpbgXp)l@rby9w;eEZE^m7h2lb2?6iJYm_*9
zW_Dm~DIH;Zt(`|?-b`K<;v5&{)eHEA+7XN#!9j&fE8Fp+Kl&ytBIJHdw>1G!3X#y0
z*N*y<8QRSlhf<QL_Q9mX<;ZKH*f?iCt7~hl4<svzedXQDxAoxjxu@~{cEI}?sSGu1
ziIVy)#<!a1%af$-qDOb&*@dd><hj|nZhpJA+eE{cl4t{f{nHbleZ7+-w>??g^qL@y
zlHyy}C@D3=F5RdVzJyxS29LfiuW2Ys^zD!9K{l{)eBES>+ygSnrc7T?w%kgpDvS?)
zOlL$G=VkD2CFzW~RiCa3^O5EgkmJKB&U)+CaO-kCa8i27cFRXAYf<@PO*m55y>A)u
zw>h@wN}#c<SYwwu((!Kk!4b}o7v~e0aWd-^d&9qhfBI>$U>TFTCxbqKm#DM=O2v;u
zl%XIY$DHnyuBE4StD@b2nf7~2Jf{#!k@h)LXi<`@ekGyu!UvBGOt)I0!c8HhVat(R
zMi+`0L5m%{$1J@?TjZ5Omu)%Y4cb837g8=YI}}j8Ljq_LF@wF0<(g8?<7}?n6|v^c
z;Tp(6mh`MX^CQZQMMX6ShJE*vR4TYbD^Uue96qB7+de(Ye&QN&HcGoOHBW#qpflo}
z2%JeKeiJkR{fXa#kXL~E;Ls87wze><T5K)Oj9_)_7)kE^qh{W6EW2KVvuETGa>Mm`
z^b!^tg`Zaue3k;{Xt`5&Lq()vgE?_#Vj)i<%9Je_XWq${Bc?#f_t0~9@(im`UXzMX
zV`6BpEdQ;so?3+|>Q|ymp)4!VoPPRg7o&TcBBul`x-9C_mQhgBJ*uc4*k~NM9z11j
z?;b~l6HLf|!WsKx4B?Q*-89TY4MQ9ym?+CC+amF%Wl^>HY&9OGwhfs-*7xA?tcHUR
z-ru9R%HR^AApR(jKmVM0{AJiCABar=0~~w!U@a$D%0XF>&o7yrOoZa^fJyo7$CQoM
z_FmZx7M>|SOq`5pKG$4|-2%ElN8ZB(xOZ1+-FQNrW=C;6QP|PzPSq7oJIqC&80Uq3
zVK}YLk>aKk)M{qXN~(>*`o`xo-bj0VAwfX(#CXGCkpcaJ-x6sLINB=TttumFS2yoQ
zRAFM?B31W_vA&aYxk{ARsDur0-K`fcX|Nh1cBEm{;DE5_b5LolGkm6VzERuUr!DhL
zOenBCU5lHPOOGpj+fC?A#|!4<9uzO7umD1F>@PnsXxM|U$f5^IM88UYj?5e_nJ@En
zlEeM+#k&JdWivJ!7(oiu8MYp3<c>D?;O!a=t7LI5^>SWjn)nFYBTN0oU#5sGJl_@r
z^JG-zOt^Bvx$h+B){aTmWkI0u2~eil2;$KG5}xYQyU3I-&p;-7T?Q0Pk6oNIodSW=
zdAlny<O@NsrAqzsM@~URMZHFZjt0J;GpNbuYS*HXAt5IEkvaK8oS_2ptP<9C9^Ync
zIvxBO?M#De%~XGDt&@&3ZxsLmIR_P&XbW@n^>o^-mfl!=H|~ahUI_DGd%)rS^VnO=
z(M=_iBPn6s&)9F@uU$858Z$A~%Jd*~jGhnEa}O3xOvS%)pX=px;IUbZ*cFPd)cc|a
znwzE&HW^Z)j@-}=SAkMprG)jZM^d(E)-ptPtqpzIDF0r!!dA_jT-Iz5BRBQ}CVW~d
zW;wi}CEoCJ3gMgnix;ppNqF}F(Sc&|8jmCA8J^g#>$p1k#-r_bz&^@mV!<D-1sM$}
zeTAVz=>voeYY9f~WZ&W9p=Fu#{EKa~<Kw!#=br$mAeL^AID=s)|1V;tb@q5`M2?Ej
zhX{`(QyT{~WX%{B9ox1ZbxNw4<3O{HD?PJXk8kE<)|7Tbc3}hV#e88_(%LJYYk7o5
zJL{K{;&hiOQd%_xOjjHmRA0oHMt;~o$+!hXT%c#kW7D|^3k>R2P1U`(ZYNl$p4<|v
z@_2<s2SdnnO<5qQ{d$+5>!ruy4ms9l2p{l-foOtWs%E;09Shw*r<sp*_fYr3U|hPJ
z6wiAfh%b6R76)(KQ4~K0vhsj`J7adU=_TC48ski6LG2W07pCC*Cf^oq9bYu!s<bux
zoV1ROs%Hqkfd6>X-<oQ^ct;ek?$*}4>MSajd^m4>&<OyK<cKG_d!AJ;Ny>E8OYOc)
zy!-?RQ~Uk}XLcqI8+RO_S$*!ESCf@*wUu8&o7gKYC{-IZvrN+zOJI_R4HH89BVtqJ
zDw)%=LepvJksmbBu(7f7Qj)`?n8e9{*-tAUr_#t;K4UecVpe^u?8-Dk+U{sPJide4
zqdZ>($W4emwZf0mit!xUwL!$dQ_Tz6^g8GMRZ?H~?Diw+Yvrp#W}A0<Bw+*nfJXZa
zr4z9Z7`z_AGaa7W3Y$-u$!~=m+vA^+S{P9>@iE@ho<B;zEA8pTEzWhLdXG0Ei|+!T
zj+#!YWKCV1JJxYlzVzb8bpzCgF4>w-*#NlxjHb7+V~cTP8<o5Mz#^Zfp}QSy8t<l>
zDL$(F1Ta)jt4hEgiE;^95cEoUW6Hk64<$;cwHD_`^oYgG4PQ(&bLKxDY}hB~m`mNV
zHZ4eQHMC!VjGZ_ZxqA|^=Ho?@`>ptZ7}?gV>xF&;jXn1qDFYQguoH%VPk3)pgL%NU
zMdb5_E_u=^fp3B`83ulWE6gV!PcO})X8Wo%*`;LphHqUs?+V`G3<XlXbhD*O&&nwU
zYt>N8omf~=9#_9|L!9;RaM1A#h*DxdHModolpgo);q|9^|CL~<MRKnnSY*Ie&DkKS
z)&ND)v1YLfKa(Z&@#q>OJg#NwN)^EftColkuv;NI%3bj`RyuTaU=v9INdeWZyYZ9R
zPzdewtsYgKORX)73;ufsl8SDdDAsk`ctb0Kicc!fG9|0)Y1>{P+dTmS_<>i$wzQUc
zX4q~{1yj3{tsg!XQ?c!iMVLN*F1NtWvFWUyW^R)K3O8(LE}MBlV<B@Gp+0n4Im(rO
z3RKpoeEzlCDruqX2lj?wr!hkf9K3Zgtlj;~C}BmQ5-L&OLS91I$fVj7T%=9h8##Qr
z6ml&Vp57*BqHlh&SZb}w^qe)?oNZpFElDAhoS|kbHDoqPh7pmy6+|&UVx?Q#tq027
z56D@8sX<Hb3Ujh~?ZKnTfy&E=lLz$D-z^>IISXd8^)m$cDZj+htk=aLP@UZX8_Pi^
zETUh#lsEAUm|OT#YLxGoM2maZmA?B?D2wZ^$5u&?rE_|1J^?Cq=qau7L}(k&S&l0|
z4!xs0Pw80WRZ-ruY8=xSOf=(&-Jv_*c-{!#EYf^@tjl#;{E@?juKeV9V(K`Siq=^Q
zhLRN@8O`2`)i$taCha*HllFiC%Gb#9QRQu^&eR$_JKLRrgs^-<1n>yL_j~1aeMW8|
zZ%#b-ZVJp|pQc%Tms2q*XQ9~FTg-*`OZr5wi#Oh<aHAb%A@|swxWS?TP_v^@*?Zu>
zN5iZ{eg%4cc|?s?&TwJ2vu}9aD585CE7#dSx?(@M&=4tTHMCS&JvHo%@<soxcN3M7
z1AEVE@#wzRJUzz9J0|4#tmP_vz(sTy!H5e^-vryNI+{jxv_hL)wrERy(P5P56M#Xn
zAb^n*zNf`m8+@u*+=QXTFGEZi-TRHEDs5(Hf>AzKW_>m+|MTS5B&!Zjjww<RN<5Ph
zK%`7mMZBbtwdRZbF=c*Jsvt4@Ngf%`bEjUuHLW;Ta>h)T4V<PaGFz5GQR@$!uRNf!
zg`ih%M&KttrtY{AEhk0}63Y9aNi^2^7lk880%;rg`H7zZJ!#%Ua=JvUkuIR2agdgk
zV)r5-KzTTXkK|V9k!aE=Dr)j;(kJ4v^13T?&^PleP~Qb1;B3wm>PD-k&bT<;B`J9B
zB+(@G+A^Vq{PxSkh5%`~Q@-=Z;k23E)SCudi5_2yNpIc)`Ra0WT<tiEE%ih`zQ?`8
zlj-qSLM?b2Zo)|Ts<AmQ(uXg=QzV=FsSLeZz3?CTqC;!^OueONxg5(048QCUT>~S_
zZ^L(@YLq{PoXXZ;2s2z9Rq4_u;U#D?$&Dbuhws%&^U~jFab%LUgvC|v3`nCo@`8UL
zKXQkAavT>g2=!1se3L$KgLd>Ni{oZS*l3?Lt51x=gN}}h5Fp4qqKTjv^?(hOq)}X?
z>gA(s<l_23BV}#=+Oj{4h#!`}pY)jIp@b^@JvRY#aMT55BDr=(2|SfWBmey{RX{DJ
z_7nzVK1S6$^u~eiFaB&!@r$=J-=x(nXyK}P-`C5p7wluo0c~<|W#xc@g3kOz$A{5<
z721qVC%6p}_8}E4LgdBr*F_?eK<AvcEtR47na#v9MF(ixQVjhdW_SS~)xCyu>W4CI
zoC!oSM+EmpM-pKl{`<q6ek#+Ca~DJorTiwEo(-Ha{AJWU!&n$|R9a#^+)KK(5xcjU
znP2iN!tz$tB+n~sN$6n`=mUET*QJgG4Yu<!JfiIx@5evE4{-XsizcdTPraYpY7<A<
zNpWqtP9u~7!w(GvRj~IF_YUzr?u#U1M%#|7_*@IL4lc{<>iac_HF&L~)F`)-hz-WB
z#&;Z8r8<s>9|+<w*_3lFs&n*yz3<*4YYS~<zY;oIDE?ea{5Dy;dB}aVD+ZJ#?Xke2
zv<XYz?8pJ<H@_ACa#B@TH~HJDY|2i2&nL2_bDr1Zq=9_v-#k5`=Cl$vuTwaaCG7^e
ze&ny5cTw^vUy>%8sVUh#Acb#Bw#50=Wza0Bm6Z@^sd4%{%6`AgolI5rZmF*KLGSX$
zMF)Lv8A)R@IshxC5J&0hT=;t&UJyM2I)Ys$Ex%Zv)Ze*=teb|N2)ZTqDyypV)1(n;
zMhl-cKMvfatS?)}ZyAK;I4TM7Ox^%GHkv24TaJtCPc4=%nGH>&`ck0gchc8<)}SE2
zbj%E=l=q#SP>$D!U9kt*Q&K31uj@vwekBVsh_hoR?4~SkPkCoK26Z0Ud?KUAU#9tv
z>#&(Ta?41lj*NKuIZ0r7DPv4Vm;bA=p$$?_@3%3_gz3A7Y9RvG^qa`z*m8XH=jp&e
znJ2)Th2jcR#`%;PH*H(HK-Ha^;tNB>ue_8+o5gz!#`yXg{M=(-&Srv&tuk?&WG&vY
zgiz@Oep?i0Dv#Q!x7F(b2@i^*o-mID0PTU$`f?_%cD8egALIg>KltH*V?2TTN&?4Y
zYGd;=b^G>)6*jNwcAY-yd-;18%fi|%MuZ&4DygVXVWm6sTU(d56Wq-AoEFsbnTKqC
zAk8e1S)X&;Y0jXR0h)1r7YJ*UJbC*mE0IW0ugOT*UHAz=V5M9F*UHf`!$cKUL-<zB
z*JzAKrg9lRHE)9YKtLF%Tq};YNDFLq#Yal_JcsI5$e5SY8F(D4Z=XUr;MtQEobz7V
z{lo`zV3klgmK2BYJkyBOC-G{8O;Tq2wKRtxYQiTf?p%0ta}bq<6W&1?8(Jf`-jW{P
zBi$Jmfmv+kS*NB+Kc3O^O+M00__3KtU39N>`@l9)uT5b??qf4OVj7%fB8zRzwcXF(
zJTtFULOEM$)Eato4x+KI)t+fq1qD;t>Jk?C@B~aG>b<)wHU5I;TfqCyh0q>tpVf=2
z6QDSlrQiVHyixP|M-B5`#nGAwv6bFQ;RdsOw_CO7+^Si5i@z%X(FDGUXm_SX&!9mX
z*Sn`8``g|V0Gq4b3?Yhe?`6XZ)Y4b7N8NiyM7gecDcQ^S_x&(IgRrnfSBFo4+51Bi
zH1?Z%yYn0Al`9RVBwqix(sBG(aeglnSr|WHx(dU-N?ySpzrqZ<{vc5`s-^*n_RYDx
zPv}>apTFG=`c+q4&k@(iA-u`x+hSS27u6e$Pg&W1lW5~yCCC+!M?19XdXjRgZqiSc
zXu-hSlXPafh5o$;PWe2qqa8UCkFib`zwzWTGhr-n!weNmu4y;Z(^Hd5-pr8a1j_`|
zd}7u4VJ&O(k&CxHBw0;vth&pcPt>JJRQa);JiVdVL~Zj<x^rRRnoKrU7QeSbAmUo2
zE|qv#6z%5YtU6=Cp&W7hiKrWmLtIr4o3gY>qR@z7a6$vOy^Tq0z;V4i--$76B6Gib
zRPT-QM4cv9QXZc^FlMSvq`JRRa;i`hpUIQ~8a&2Z*?>atSjSg57UG9$7&f!=y-Oe!
zUjhq#sihY63E+Ub>|V4TYEsFvdHF!7IO!^ZosL4WcG`qONqTqGpgd(>r})t(QciU{
z;^CuQI>mj-(938gLDY0L-|I~|=74P-6^h_~DgZw)itj#BO|rqlT5V-vuV%T^^y0(u
z@&uX4H55s1RA_i9!kRDX-t3zf^@8nAU7R0vbq#EA5bondjPOX_k8Wz@xVg$F#vbV9
zZQzO4lqGSY;bFk8$>56Rj>U*FIAtWpWT&~AD_*TNM!S7@k8C-w%?AY#_SkGJcUnw2
zu=S$szoI|=MCo2Y%+l?*p=l1IEHc?Q@*FctNo4Ow>RyB=CCy#tP^wR2R%rQU8lfKx
z-6m3XNp!;9W_sompxp9Oi}MijU_zxY&l;e0PVoc)O;iR5ol}~)|A5=51_|Sr*jhzB
z0lqfcmRPz9yp?Qo<Ed_>rOL<^EfUS(v#G#X+Ib{f#Qhf1jEMgn&++p~OR6SG^%cU=
z1IimDCG#8Ybx@e$Kn?kBj7F3w8GSpHl?wwx#yon8&#NtDlPY_4$vT=(P4Zr%iBuSU
zuKs}2PSM?&cvk}Q@x)m5VP~ii0uHF2@s9gG{?i~y7jcTK;jdqSsq^cr^v@{-UvMsM
zR`u|g)Hd^u?Rra9`h=U-MQM0A61duheO~UZ)T;~Q=F)FsMW>0{b``-3!a?<Ux8=II
zlHaR#TgSTmrg!(nP|k;Q#M2{7qwrY@+Tb}#)cZ`C$(ewZWQfbUBo$wPM|iGC9z^w$
zD$1TWvqZTdsL2yXN`uOt0NW|9gN3%i?Pw;xiAabXON&ya%C&Ku$VE-?Lme<#5_%ZA
zNIctGa-1=Ev8xlQ)Uj<2viSMPP!X84&!aN@di*);UE~pt^6W*Q^$$e>5c~mzwEMA&
z<OXTtJOcS~R#hV`HhmNrq3?L&lW3dzMD<w4blGQ5CY2;Mt#UeGgox0-!Xha~^`=T)
zKLHT$U&=oS%okKo6ZSU;=oAs_8eHPT0{5);M;7DhR)MuB9O6{*#~9TY)Fwmx!tEVf
zo7@pw+l-X5`Pi-=ev$QQr<gZkH|k$k>5|m1`#aa@)&gaWSI;ZLdIowhk_roMSS2R!
z8FR}MQ!P%~YN~FxY>aAwm)JFt5la<ziz9<B_|GEBL=2!JEDDSJxYHNC2&DAY-=A?J
zM&%oCza*OivcE#I>*&AByR_L&#j<ZoFRwZcl3w!`tk+G0d;UI545nZP5IxFOZc@Ry
zA-QV)ZKjoGdElD|8D^AW*f33{DWPGKHyy$1`kPR<j1|*p3I}&x=)}J3Vg6Eb@uj02
zdp6jP9vS6wr}p8bZbh||85AWL_9V+$z_VR2>?Nt{%}!3EV^UY_YNtKc#0F3L!`v8Y
z0<zPOnRhWG+TD*dnJbe#XSqU=HF#;1%nv65o3r(nVH`r3d2bFq^JeuTBKDM11d}!^
zz*%Z?oA>l5oqL`NN%W4v%!x+qbm$3pc~RkDiTWd|ED3J=4PN%NW&)lIWJehapf%JK
z>FdV_E4^xMT8~XFdKefI-t>z&nd0Nga0N@|-4%_n$xIDXQ((lM+kJ_23Jp*48qQ*%
zAZ8T&?NtFsQ`3q92XIh(lQ9Xt625BxP~9%*v)ZM4E4{u)7>rOYpg&@IPrTc`wI^`q
zhav$X=(IBESXLAND-Q=-HYRN)49S(8LDF4fT{N84Yl>JGR{TLKoD(<daN>xs57{DX
zyLk8_h4p&Tjt0pR%@fDQRdw-7^^qnG4K#d|;%}wkPoiy1YBRULn$SN1JfYaD>DZp5
zwujEfFfi$+2`40Lr&qkjL4Nh^Yk_w9?wrPefF;)zzy15yGz3b~)cH9w?X47qDkTa*
zf&nH1XC3?B!?2xCX7V&vU)l#}zIcN+PuHSpt9FX9^jR(3!4>9sb!pasa%ng1$P+&H
zSzeqRPq*}Kltwc#IEH`3Q$tC6f?AqqIwq#$AzRYe16?lSDl!Z<`fEO2Ybi&5`*{DM
zkb%sFofB&x4>aP|xw5#{r6jX%>Dn;g-fO(tkabm4Gf+P4Me|%=?}5DUhq4UGK~>A`
zPwdJF-vk$X>+6Y4t_9uI@yR9Z>_h>ak7FOvR5E*wy+GIn!8xF+3d*-q1X1a*Fjw80
z+G84b$(QZx)CtDnXvr`cyTSLhSznq-opP}2<>iFtDjFHXavj!_DXAP}NC#)~QEJM+
z$RUebF?C2EnHsLTfP3J**B-IUY$Pi@dWyaa^fX1A;}wI6ygUKJBk)eAr`io~Gh1`_
zzrLExp48qJlu#t^kx%#aKGRrbz-~@)l&Pt0d;-Wdhp$kJa@F*26^R6=!CW2dygr)g
zCvpq(mRZM#%AD;^rCp#DD|=r=>Cxf2mg$4mZi}FJ$&rw=WcPlfoa7kk31BJKEj^3D
z(S<<9#-I-sDlC3vWd`?QDlu}ZWin@Iv{)?1)4nAPDk$A?ZqE}*j(5zv--RMgZya{s
zRvKDtq07vl>?{N@KJYaIg&;GYqguYuK20!g<|UrX0dCe4K$9qrR7h4`t@iznx+9Ty
zGf&)_uORyqVCLSkF4#S#rAvgkZF-}L#H^su@-C+}0I5zg!V&!Cn<IOaN8ZwAnZ#03
z#N?!qoB+>YKhr4%sq6Ziev$Oh+vmW$GLghGtA=_>KI&R#{Wp2D=9)(98H4ncleC}r
zNA;3V1rzGVTvp1>EO3)OJZx=|a?z=3OFS%uwi*C?f{$1U`tvCL%su;!KcuV8sD8Z8
zFH{I|n7~S~5C(|kE`9U(sABC*O?7RN=KUsw5mfFiW6fN;1e&F%q!@}q&|2<*P4{CO
ze_o8LWqB$@yAdg>HF4}BNWLq_hKwWVK}{}urMY$%<@M+?%}<>(ig4&;YRJ^wWGiy#
zV32W^jSTrIz>n-f%IPzusrkz5A@Wt~9Enzj0@c<+J|tB4QZ-fTf}x@=y~wtUe(sth
z!QP}D#kUqAeJX@m>gxO}GZGOt@<oHi!ddsP>Y3?x)tUo!4ClqvlNM@F9Yi}cdS<8W
zuE#blCR~oSyJlJ%syUQwO&CE$u1z6q`ZQvh=JFOoyEigKNYfgDbHiWkoobU#uF7l&
z<Ur0d$6+bV^A73}FHD7Yg~1CoPCHzx)zj2@N&6^eer^4noT!`WzPc6W!*PT~R*xhT
zF~r(h6Xj;)nje$)VaqeKXx!58kS5UM=h5k<>_!B;1S*Ql7UeD0Pf?b*lu(yn-3XU|
z!uKq*`DFb<S+RugZl#5;=;Tp9W@}Y~@T)K0RM{@aXc<#&HZ*rb00tj8GvI5S$AOY>
zLOzS3+QTbVdsjQd1uG88QgGQpBb-FK@KPcC<B!eDBFFf|4^u!}<h{#w0z`u)ow6Ew
zLEVoRc~5{(i&UOh1zRi0&#>Fy%M)1*Gz414w!|mGe<RHV={KFu?H|)bP0CvW&vipr
zOyHJ0(_J>>6mhkoCP(dP9~O@pIs_6?f_lKK7X^yLvUWsb_^_SsJzrFKp8$ICQkVlL
zWUdQJGou6ZF#A~}nf?-B$9-fFB_~yA`h7O|z{^Pv#+;_X(R(|FBW&u~!B;8^_(t*B
zsmYg|_Q$}MNDW3<l%yW`9R6N|jl`G}-ES-NpQf$Gk@F{Hp^FIPBms8&nJSOYM~E>B
zz>voi-JmQ^E6HY9>FmHx89u67r+tmgzysCRDVCdXp7f11nkk=Va|`u!7ktuk?xG5r
z4LLm@q=g^c3yt7G<kCR(M8=NI3dqAMMZB1WH);#1N!$2}mTP0O0|wEpkqgY2BigPy
z&Qz*zz8o#q_^f+Y7mt8cV&A*qsbWIT7hg?ZK~cpCo=sFdylZqy`nG+w(+Vm$tROC{
z)JP$>3HnalR?tf*J<WGItj#ggHGd`0s_m~EPvCnTvbEp<c_)mvC#bSDM-@A&+l$4q
zw1k)!B6mWSv90S`14MxHfi8IfEAlY9(1tvJo49-TW<lDGKKA-pRD~a2xOY>ABF2e}
z)c(D4s#k_82Akh>zrVCH-e&v(B6MvcFUl*m-LZ0>M5A*~Ka0g=#zwDVTD&c@cYLDB
z>#BHDKCkSELl&u{V#Ys|T`oRzLxP+y_=4Db#^Fz2Pn&C$s!wre?P*H>(RxqM1o0Np
zQMi%)Q6tx7jM`$VoHv|HAIGhE+C(vklqo37IKn)m{`sEKfrub)+${<5WW7A(n1e7y
zqX{obdi0KE0yPbis#G-EzOT>>t$bSlvGbinA&EW5-L}k4_yks&WC>xc0hj9;;o(~g
zNvMpd@qp=;vn(ZR;g#T{a0wlmY2R*p`iFgurQzVtBf(34TKIgucPMFEs(SMyyZyYV
z;XJjOa#UMS09N06j93uG*z^R&C;1@sCx9+y1J4W3-2yb=<Sf?4<Wf@EC3p7J)NVgh
zH=#{+Rj2x%jFqhpR)vf&%9a$6jGk<hY_pQIoP1^HrBe0IjHwiRA`^R{2Q7S7Ar@V9
zS`NKylTQpI!*(E?Q8ugZ6X4Z5t~vt6SWsM=*J>lc6|b#05x1zH@-V{U;;M8W5w6sj
z@LA?`L=_LUxqrGTQ9wEo3A~=Kzv;Z5oR0u^N%A7kH84gXPEI&Pj{hDs7w3nLP5^3f
zJ>AJKeMWTd8W11Q%P*QiUD`B1=<X%s!?LM9WkHX&fEOH_W=Fx?6u*A~zQoEmE?wwl
zKEv!`J9JgMVeOnbf357k!I<`;m-)rEKV>#^#C6B_a(Z>pMc+u?NwbOD3e>p0^JgRw
zf$1zm!LXi39Ge_SS9vfFTxWU~wG5sq#HvSVxD>F~(Zt}3btv(V5r7GpJTE&@9UY{o
zKZ>Xf8y8dIC-M`iw>HK#iha#7+*G_(Ow1q_s#7QbUMJV`mOU^#D^1w_zJ!{V87W-V
zjb(0ua_)KQ;b6iADGEvspb?nlyQ%~zx=!5_QRK$d8gCPJv$>!c{cN}KorB#BZ&YE;
zB0!^Xi>N^R?LF&9tDcR=lL2})`V>{%6AUy3XELOD{DzT|UF9+7Lr%*58JvN1a((9&
z{V{NyPw_Id?(>vZqO0lSqu?y%#_$Oqq1Iz$nH|7`HLsyhg7s0>f*IdVd#a><xoX>6
zepk5w1Gl@+13A-a^y=^AyF@{$hH-{Vy{50;;;c!vL1pST?<qrvH9@|u)Oeu)rN+uL
zpL@wO$`MddW%OonA|q$4eo>yOTmYSX^x*!U;`HT_aZ*TvEqtt`MK;isEV8g*J<t(N
z_+oY@zgN7ln7J!1f3Yfz>upSD@+q{^QB>ArOGfz8=9S?ajd5=o3!+97VUg|ou#=Q`
zJX?)OM;>%g_#+PNd)Dq;(<up)N_!{6+mGqve%4}vqU&u9)EhRJ%S*mG#fgG8NaEL1
zt?7gK7tlmz+Cngc76oj6ub8t>#Hiy0<6kTkGqr{Qwn#d5<CFxogd&A?3pu=S?O7;l
zYE;7XECkVIRzL{-_k6t*nJ1kSTaHTP=X!`V93`b(p_EP*@v&1F?j<$Nyk?+E)>j*H
z<_L~r7ihz)`1gCVgk;csb_zd&at1g$p&N9zuBcq@MG|&JGz)U@E`*htZ*og-LLh6g
zW|D=4YVxvlAA<r_yA;S8G)WAvBwQ*h<=vN_Hkq?<<M)MtHzb({opGq5l=^GN$nGLc
zKpcuqowSTuuHLbKf6P_|{;0B}H9^?~0&SZ!KvL6pY=dib1rX@R7OrSs&*h0_9;t$N
zv0Y6b7)<hT=isS{5i)SDpDP7;cJU6;Aj&Va@^xawfzHH>X2UDFkwWbDd-P6z14-~(
zUvMK)dW?f81I1~Ryri{`;#TQEjWL#g$$^7A?DxaW$LZu0xl0ajYi}OvGKHc^S>!Zu
zMz-ezxVPRK-qF<cHBux~n<%VfPi#+YN}l;;@0&hN#W@vi{?=$rmcj}}dz*$602zje
zPJHHl>>@2u>WE6bwiixbQrOlf^0rh1)zx7OTP_+E{4aJw4=4J?PyvsLDv24vRH@Ca
z_RI++*!9g(E3i#X!MeaG@(T>8CHMlgeI+Niu@5qeN?PX8T_jYElQtW%5*)ex__sjP
zo;f09<VQYi)$e5(b*ghx-%h_O49v=d-3Pz7&HKLeGLwF0I}qWKGNHRq;8Px?H#fJa
z2Y^yVHUfOj$;m@({UD;_Zk{eH^@SZZkOIjma=ss6vC^E<!v6+er+z2VwI<sna)%){
zQ&X8(06jJ<Uky{>G}N<9Z#T$T4sc=XWX;hZSB489?LyZ?n)z-@KdHR((qJEB|2u}f
zNtto{J95$D%|c(FQbVdb&h|!9lhSK;I@idcW5lKqWErO=U^|c(D0`qXK|_#ue4Xno
zlW1D7u=M%t)qVB;ygTFtqDH4<&%;1`YokfOD9yam1RtMG9Ml?;n~#(Ut}9t02Xw9j
z<-FhMt|GgR<Sk8#VIvLdj(U<%e82E@(9L9%&Zdw{K|wLd#Y!_kmiHw%It2~>48NP}
zxG1%G&YP<>`pvh*%p7o=p-dQyMs!LB0RIPiP*%A{$*GA4kIm}T3C_y1x<>TeCEsK1
zf@xu$8RpbHqd_h=5*Fvi55k$rIJ0I#gzw;=U+H{PesIRl)68|Gx~ew8<|PQM7>`<v
zg0~{X;5?}(v}TlP{gm8~!j;9wZ?ILg<}|la6}OWrI}O4adSJ&?v%X!KajA`w4%jj*
z9O|S_Z~*|CgdF_{XmQFRd)+eOBWS)6PjeS0VhSqMx0I#X9v@GYBEpyS!AW17f@*%|
z=EtM0=of43YWkgBFgy{|<kiD7$@YD!0X?bO5h1d2k{m&gi5FkJ0$1IERKAJzX6`lg
zty~t~+EaG+>s4bwCs<ZCH}D{i39iT-HWs&=&-2ocHQYi#+L&*8V#r_#Jju>2h6t$G
zSCp3V;z^2>5`oreEP`oaU9}2>%_(y0aGrFFS5)z-vuUxGrnw_m!th_u`@z<>4h9vM
zu-SKQ(fisy2-f<<%w-G%@^N#=nT)imsdSWaGtBGn4b9OjbeqYHE+QWB0UJ3s>f<R3
z-7Nw&&2~DDg+#VOzFFneO)I^K-$t$#1-pJ^l%R1SPGJ&a*1fnH5e5fjSur@9Nf@FT
zMR7F-Zpd~n3^oFZ0xmx?cQ0d1&lFN_Jl_ppSeLZ&t|L_PN`C@eeP&Qxk#i%^dT*{A
zbkfx#*5KZ<+*Z~Z);}WX^UQfz7q9!k#p%<c#$0Sb;Agj`EWPer4b31+D6zY2)TK3}
zN9P!hE-Prr>06D@O1qVhZ$V2k{H0yIUB2q|1DA(A9*-K6Qv`JGN+*VB-Mla6H;=y4
zx3Al`5LSpCkNCmpHiF(X`(ZKtAp8+h&RvmMdT3ANGz!bqSDDd<9B?^8pYQt4uCMaj
zIMI#l>rqBUx1xdX$sCzwr-5RZFaR`TL(YjA_Gm5p-g@~@<LAX>sBB_~x;5j&H!XOp
z9W`;yLO`Ll?I=I>+ZpQ(h02<7oOUnj#<%9}kz!^w7tn#yI?`yD`GNy_f!~2SPxDX5
zP_8PL_RjWBmi7*0oGferzL#=}KaUne3LVkUGuHrUB4}~I3u%auwy~ob*{_C~2@!N7
z0A51n4Lb)n$4?B*@h{AaKTlyp|LyvVckzpd@T-PYKWUIt;y(-0uM^upThPBGuYNWm
zSXOg$2*(CeL(Yc(Dt}ONQd0j;;egPg0D6%6Z!+A!D9rz${L~3c4fzZJyci#>%Vqtj
z@;)Oklm4shy~(fsZhr9`AZOtJvcT;9<o_k>>HmiJw2sDP>Fn$vz{+ap#A0k}Z(_y*
zw6|q-H+EoUXJKOn2#LBo7z3@%oXJegEI@X`6sN79Dab&k!W7!vifoDw5@wblSx-kZ
zbx$P?pr<vE-;_dB1WCwUz}?ot*38+M%-z<;&Pl*snBtdm0Z98NnU#X<mx!~qFolky
z3YmmGWJbAJxLMdJM3BhH$b=kC%>~pXrT>IOJ_%F&IZih>Hx@Te7JEkvR(5`VepWUP
zRt^qkhy=5fhn=&rJF}e=<sVA^rbp7u3FruNa0c1ik^R(bY+~=?EKEW1v!lP4KgVh7
zps4uwuKv;`wzjPQ0{K7V{t9FUNp|>a)KAW@8Tc!hGsyg3z<zT6CCuS(3+%7E{5$(!
zDgZh<{WTP5Y-{Fd%<O3F#_VL~><qHAaQZ{ZugUzw$3l>ZP*fC<v<JG_n%OzaNs2%S
zET$k+0e(JqX>mR&cFvc4Y+RDkJY@VYIl0-n#W`MbvUBn9aPtbW{x|GD=I&3u%8npN
zd>Y&Q-{}7f9sjK#IXfq3V>_VPpW_EX#xKP$$<EC!&CMqv!Oz9d!9yl4&L+<Fl9P{5
z{3R!^B&XEh#{V1kzv>l`a5OV^Hj{+>i*T@Ua51y-Ftc%LuyYEq^9gXUGqQ0Au(AEp
z^1I|e=}@#c1(|#N@96kV@}G4;)~2bkv+@6ymfvOnNzX5P>>V}i?QKN<dB^_Ejz1;-
z2@Kf~q(L@j>dwZt4o<&C5G0O%?F;H=;Qvbf8^Z?lKY8!x(uYX=qq9Hb@=yBz;P<~m
z3bFpA{@0=WVcEYLzR=G#EuaE&H?z@^1VPq-6J$dY;ruzVf64jBKz~E({sRfw{eDOO
z#`z8Tb3+h-#5H8a8UNe>Mc9Q{{~PU}<#p7|oa}8}e#!H4u>CBo?7uF5f`1qIXRz+S
z1OG1Y&)|PxHSIvoA{>AA_fO>CP=DXF1SITj>>VMIZ6?Ag#QIm{-%yZ^OhDGyNy5?I
zK}6cv#>q^G^>@;rl7CF`Z+DMhvGWHNa&Lm%=2-uJpZjlN^+$01Kd%2_!vAB%zpMLC
zC%=2+-?snbu7B&I-v$2TuHU`!Z`=QI*S~eq?*jjE*YDo=x9$J9>tDJE=^szNW_FOr
zT{p;c?a!2J030L_`WY-793&eW9u5KN1rib>A`%uV8uANVEId41EF2sHVro(XLP{bW
z95N;{N*Y>v26}u_W;SLzHflP0x?g$QkW_CZ1SCu(BuqL290I!k<MKz|b}tmufAY3}
z<)i=qK5u(fQG`RsLHf88oaH^6W=1*I{=rTs50RiaNePbcc<O;(Umo>AQI!E%hA0RO
zvrY7(c`bgCkBb*vj<{p<tOsE+{YqGP|6StCU0A4AA&aKX=v@UF&JupxS9Hn@;k{>@
zq&Wp}jiEraqL<*2Bj2pY63V6);=CZM<Fyz8uL--OyfUdi_}d+SQ*HI<*7W&QIFzLM
z7z-Uy(2slX79<9-me|MAuS@kPc$wzrmc?@lK5}#^nK>vaeE|UPqXad}-<dyTOgVj|
zXD}2fbQCV-m#jNs9+H%6VXq_F%*@(~o=FUKdVdx;NPJwY-*KWpybv2DN3@B}3eHdt
z;r8ll6D;^j-I(kc<G*1d5OFtsv2Xh7efyxj=fuz{i)n^a4Bzv~>;=C>>1`Wn-j=wq
z;mjR1nGJTO4*djn%Kk4F4T7FvDSywvNqQA%+tY||@OswbsOL9*#2oHIE?hbYctOyy
z=T)Ta52E=v(EP?|^qk%UVq_KpR|U{@#pV&+V|4pT0GK%Np#qCcao_kb@fK8o3N;xt
zM;V+r$#g=z(x$RFi=B~iunBgCEaQkyKreQgDs%GDCI+bSmA=gfd<7s(HOVr_0D(!K
zi-n{4xUp#M>Vclwjig&XdmjOr*9M%)A+mRPtAczU{bDtewPzH$CZVB;L}_Dg!B86{
z`Vv=Uz9f)F;nEi4XnCoxGM-U7XSSw_%E<G&IA%j)gP3a+6C1|yTsW-A>Y%&O!f__l
zv5}rAwqnMa*4}8o6OZIA>BQShxOy(TK`LY@K*(Cq6gcR9Pie!dTYhz=Nu5p_DufX4
zx@7*nQ{Y+TZT(n&03t4~0<OIpmLvGKsGy_%+rZ#aQZhkWE)?rYOfamm7;Vr*NtPq+
z+<tZ_{YA|dxF7P8{X$n*x1eYG-p{;UFknu4%f|HyAUg845xycsgY6x4>i)dgU3l{r
ztAUR)X$(nS+SU@r4z66H#Z=`R!jC2;c|@jkn^#ni+_tS&RI#7k+kq<CMt*t{oE1xX
zGM0m^#v^nu`I*HVtQ{+SH3uS|0BsC0QCVMdeRBave%V~tFy)EgaXR|p;j(LB{38>$
zqxreUX+*>AkX;FV4I}+`TfUEOhYN&CglTfT3Ky|o0cR;(Jo+3|P)=O-ZOF@JQ_IK5
zkxrhMBe1&|GMBNE#i3G=vf*zz_3fX^4eYtratVFr3Lq@r<-b1EUHX`~#n$h(!(<`_
ze@dd{zDBbA>}9-JUCb)=M`We3r7T9i2e5)3GJ4Jj*&wt`Tp=i>4yBkBT&hIryG8e5
zL4-QUfi(yH*gje=C^9pHE%0RYz8G|}qclKb&!-4FeIyo<L=(}TMC44A_cfpZ78j$o
zKR6j#yyJOBE=lO2f;3M32Hz1C1<It7oMDNBqq6Jqm;;?HxgB#<KG?~j;P!jV5pvV5
z2HO@IIJ5bq{1U=v_bwlaJId}Fz1KVx9B53jF?j)jGKGBibOqg9u6kT2ryoZ40Ue{#
zczZq~_1w+|-RiRvy3~<lc<+#Qq2#tmP#O8ATWh%-YB=oOm>eq*BxBu7F9P#0Z;X7M
zk3mS^W!~S*)?1f*YP&j!BRlv6bX#UbY*l!gXJP6dXluD4E2sN2lB88N+1&XTKEhgk
zh#l{ya$}<%LN5K@Pyuz^<AYd6*ji)WYNaws9<A`%jgFnt_=5x7=Ir8+012^_LWfv^
zG_9pcdVap`vr)X$-c5~UhN`qywv4v^p@Te>R)27ypwlfujWWY*1!`$Ui5PMT;XpKu
z(8cJ!Dh*e(Zev6Epj`OOeEdK-$7fbY8UA~}d~0F~^D9$U4i>=bWJYP~NKdG>6QHe{
zP6K}oH(I!lSd=7@&H}|R><QqVhlOt>013L-A8JJ{QONNfC+1>%%?6J1Cxo##8&TF(
zviroT8z#7fp=7>XU0p2=%LwWheO<A=fH=+{NP0`2Ive%tTL)dH0RgwWmD|w+l_p9-
zo#zY(JpRzn*<nZ}(jW12s&lJ4G|4@KF7r5Ak$D*-z8BCqlJI1B2jjygcPx1H904!&
zf=ioLW;idO16@2z1n75RZhaH;Tug<d4&|y}^bJ#*L9f+<qrY{7_?>Cc55$WM9~z9p
z)@`x2_}{cgY+Wpl`JgymI0+K!4Q#_Tdr;^kzLezCcnvwzs98!Y$+P@zlZ@>y*WO<F
zi$61=dB0$b3x3Bi7lm0^iD^K@=0yp#90E}=q1YC>EbK}@ma)nUcahvwCRmPiXMEv{
z$$U2Q)b(kei#X2A4?FJ>23x1fkFyu3mU7brAz?^$mg)uN|0D9Gm^`H4)Opj1yrUPA
z3vMvcevPJXE%hz1EOyB%&d&EE-Ve0mCjhe7G~JbHgO#<OGdq{l%WOKeP~vKhYnp{j
z?K3^ZXTkMneXfzol%+O4g`z<)x>9#b1#z#BM{+w_-XC~km&Ms)^b>sYI_cOw6CJ5D
zr7YJ9mqBAVQmRP@6JD-HE1!L@u%?qwypKHDstBv37;dW$0r9X=Wo_VZX%&Td$VB-I
z)VxCbv1n?4gT9>A+qf=^CUy3#7=8bHbtx2;HRcaSz$?;TYCneY*oo~228|cw4TP}8
z{ge*Ke4Ur18RioTt#KY^ucgxM-i;3T+NJyO7iMD~$bL3Mu7C}2<t)OtA+m`5q3U3{
z?rmJ+XS#RJ(0{kDBF)}we{oAd@`cTp03;1EpR(AXhU4oKss+dY*a+(_lDiZ}I`*%}
zhrG8{218D2mUuE^)Vq;4zSGsI#$U4LEw)g1VGrr@K$eU{3HJ(!Ql4#`n!3dT9(X#l
z0-CiH=m)bGTlo%zA3oJRQk%1eYG_W>+0z``+uHHa!w-d_CARnQ!B6>Jm15)M#dA5f
z@E*-Fo%mh^#lhQU_#sWdP#A-&kLX)<Fy**VS_cN7nPNz|5b`aVDGtCxj=bu_rBbJo
zASJ?;TFQyC(O#(0yU^RX*`?(f$AA|;U{`1c<zA{FP|g;JmP1>lxj*jqw~NQ1Z`nLs
z+ZNkA>l1xfJZGL9xTB+H9SWPY7Zg7U$xvOX3##VO7O44-3raDSEl=KIFYY;M!sqMX
zTqH@z_dpfEvM;zmJ9*sWTat$4Jy#_9+qPGm3*L}nbcgz0@*p%5nW;k4cMwBgWaZ<c
zn;^WCV#+`~>}I2)>vABxRdt|X8p-3}g<s4By~*yz8|e_SW7o(M$Ja|Lw6%;fOMr$a
zbG-)@PzE)f5kFS@&ZH8TD(#k%p!<wwU+4RF+U?2|y7TxYZ5n>!l$C}>2Na2td>-7_
z99+^qa^Xoj)A>RXC>#?3SzlUmHqJyS%X`qoQm_sDfMb-I0%h?$kIE=!k=gY#!pK3Q
zk)}&sEVKs%EkUK7Xq~yf8(u*JcVA?)wv@d0{QE&oetRa3u?a51#<n~s8R8By^s^3>
zh3!DT3q}H3TLo8o?4g)I<sq~8;7uSs{JD_t>w32DN%?a6z+rDA^*f*m@{Sb1?YMVm
zwOoHGer~Hlf0##Jt<^C_O$MyVjF(%&A1Pqbkk*&zq1D&18$a-XN-rEhh!=OTAUBUs
z;rvW)i(P2<R!!E8vtB+CC!T71Ee=b|J2r6>rGI~tpQO(JTv17W6z?Y1_NbHRzyS{x
z%OdG92r`43tyPt_$_n)j`qt{U(6)_1rm9AsF8o*fsdZt^IVI7TvI8GYv02;Bvx(Au
z0pahLlVTOIQ{3oD*=e)NWk-TE9Nxnkr)|AFlEdFER4zPxl`caATzpNKvPlOf$Vzbj
zkvcITi0(S9+dEge?trv7P)Iqp8Llo7_AnBFuaj-gpy5kPyULwnb{nU&VH~Hzs%)1v
z5nnX|?D{qcHfx466EpOJidNtAc%W-4QyE*4XFPOm4cB*$utQ;RXlLUix+-+2o>Ht>
zfM;rCauD#ab8tTnXJMz9$!($rzT58QGXS2!Q27ZEl`$F&OxIn_;0V4if(?5!q|8Lb
zh#u8O!Y0x-%~)+|t*={<WrnAD-uqqUn06*34ri0P%>zmsiQ+X+;s}2}I5O1f)i8#1
z&?o7Y1plc<2Tb~4<JpL)poM@SgIo+XB?-*F9zkEOZWG!3utXr4&AGq>$iS5fmrSM+
zs)qmcc9P1*=_IE2t~#LaFhBtnvqyx7-Jl@LD2>1lIma{V!<(~$3YwuxG<V;N?%4e0
z?LmEzP@*%8cOjpkGI)09zGYIiDXn_1#WpJAqfUN729gwpuf<YoD;48X%`DRJfpA{|
zMXgXAy9#!c!&g}1^i7hDqz;1y!)$vy8T);;Ewz^iGUh4ZKsa1iz^R(*?!p)RvW88t
zhnQ%*k+1vx0pa)1vF%T=kqgY@D^T+1ui_&%xE^zFXU;j^9mNlks}nKdhgdVCAfrH%
zAQKDf3GK+qb4R7002XK195qw<t{!qtfrmXwAZOVKL+FkO>_KFDk|ne+B`hafgOXn9
z;xBS8T-R%4ib^s!qIy}&>*P!Oj5_&YNLPe*3ze>f;S474_sOlb$-=aOwBOrBnup0`
zm^Wn-bgX<K-&BQjEfZq<pE(Ho_`UkjYNvkAKN?KwoLWM2VxnLio+-B(walpJqp;)2
z+;UqzOnK1{Bg`3~q_#&_k*Aj~US@7%Zxnfc*2x$pERdR@3oD4hMg@$WB-$w$;-Z;3
znOBpB#YqVx{`5MCG}yo%OQ9YORllybBzRqnDs!sR^|?ghnPT<hpxg`Zv-Q!*fLCg*
z^o$h2Y48e7cx1A97I@r{gvxrLB*!RvA0YxI*)Hw3BI^`G?1m8UhLbc+{d6p+xniQ7
z)Oe%m5M?|=5&1yFOfo3E6=4CApu%lEs+O3=J*SBSH%Tgo$`iSc^L1G8fu`rx_tNbH
z#X))M?m;v*Tx6cu4*0`VD+-&{OdMNsQU{EW8LjRN?s#}l0KQ>)%Y4V-JMw0pwT+kV
zs$*-WzQXR;*-UCW*GaHNHWwoxDDnmk<qsv#@DFDaAt}tB!N>?i&x|{-dT-RLXvZp<
zEVDR$I!D}v;vqSbh2R&x?getNQVpmgQiOi&Q+Mj<uQ%1_#=mGkP?*nS*ujhJj-hg<
z3IzcTnH%&=SB5I`YpL{WK8!kgoDS17q6(x}Mshu8eo0EcabfI;ME52|Sqv-Cf$#VL
z>iaNHW-wRgj!aOS^e5s>W>Rerk`XhVW0s6hngAdWwKuc<36L~qU7Q}fsxaI}5v2@W
zPlf?Q)02Lzx|$lwi1krlc3P9IBWT1?nN%-iUJgx)#Eo1=7@q&$63=RjC7JD!hEQ5~
zn2fJnCe{oOh85iVnGAT*QLNWz4~)1Wx6)ReX6<_dM3+|Oii9^m+W9f87$O^aCY+a9
zK1a{!h&^7tHK{qUuA*LHNe;RFxbpG|;1$S6(({fPN?4iWCMP#fO{N@F1bnHXfCaSn
zL)@IiE8A}s(bBlm792%9{A~Yi$Z0qLjO6=`bYn9pE8ntks2{v7?V5({<`%qT;_BZ8
zv$RV(P@t?45<BS;E8R*7Wf0qOoS8Kf>cuv(gZ4g--gc<we+4=_#l(ZTpkTx)&Pc)h
zdXL7TyD_D7d8dOOO*6-W+#Qij?+XFIBa)<kLmyhzPnS{}zK5;^K3*J<O7o7Ng$aR5
zc|f(9q8SBF;zuO%2kA@*Au;Ug1r`D=VmFF(MpaRq@ZEEgPv~l!(3G`0FAKowZM`E5
zO8|0l!0Kx^bgqh8y-mxalZg<v^Rz2wvx`?QTO8f9`FXTqhKQ8>Gm-iq(zLNRFIu+9
z*;H&G{J1=H{&j_&>}$|lnNIwWH|^QL<oD<Erk1xt-$pif{{Tm3RXe<}4hK+1IsC<H
znI|Kr-9sOV($uzo(n%;t#_^5cjv0R{Y4jzdsG1vjZU)%4;D%S~Ncv!6l%>%PN2@d^
zw`p|QVuirqf?Ky3qoBvmvD_>&u*`3PAR{LuxANw$*CON-LJI(jHZC~LD**#YO3F|I
z6NXXL=cP+25hc^xz|0p61_ERB{HfaOQC`IhyU5ZhW}T5y7i)5GeFi({nm!QR=k-l?
zS(D4MM+h*x@s@5e@{Zq)JB5q-FM|HoZSM6}bf0i_85@Dm89e=QRTy<-xf>SqOKW*8
zysQha$aw4TkEIQC1juflNgL(|%urDIW0EtFFhK{m9`%z})tV=Bjqz5I2Bm0lTYl`}
zN2YroLk@j<<2-{xzUWNsyc4OWqo<@2v6Aux2`M<tgBTB08je~$!NEsVbqI_R6t^k{
za51>|<F!&mjc9@rTjuI=K+Zis4B~(i42c+;7!^E4I1!{{AKoBTvaEUci?su%LoM6x
z+ih&|#e@F<Eu3&i(*U2soEEnxPeT6y!@Vo}C&K!DyCxi`n#y{D+~EFrtCJ=u+|<H}
zpE%(;J9_lb@&ckZ+_q4^)Yiex?$yP*41#z#=by_Tl~9Op;!Egcf>NGU$`u(s8{7HR
z$}0B+^s&Whx7Rvl`)Q54dxnL<9Y7fe@*k~Z2)NW}+D%FcotBbH+ABh!%F01}_RUnD
zw;^p~PwkPcZ5zJ%WyogSGPyWYgZcje`l-S5dWu>Lc&75-ckc@z&mYD91DbJza`%DC
z%R|UDh?`B-G|8NSGzhlx5PGy~s;~4aRMK~|Ls~R@4V}teTH4$xVzMI0a(Z!$VyQc;
zlGUAuOB%}*%AwP95}a@_dJ*fvszNa>Ey+j7V}~MuB-PwWs2~S+ODM<XM7AXz#)S||
zB-%dqKO7(b097d!64OQ%j&d@iH5M-Y4trUETi!=90z<CCeMss0XY#5h<j_jo0yi&w
zagLoUHm>ekb|aaQ{MFz-?ZA3{O-<0svrCAjd9bVUsU0}M&+GjvuF$M=njVofej&Zo
z<&rrfauVJw^0^-|KAeNo-kytLdYzSt1a4LhA>aZs2U=I`J9jl><-)i-GwXsnR*TG*
zXIS~kdv#|tipt-;k05u*BOiunk6?Ypx?>y#90z_t1miRd%+B81Hr&dLal2<fg7x<6
z{HP0<+UBcoW~&{%tvvkvfZ&ceE$K(7y$p>W!t=y;&nY{CHVljo#OEXrT4^>7*z_GM
zNVL-<3la$>KYB(SlkMqRsH8)8FGnU$?2<=3jB`x^k*-***qlj;vyV)Qm!_jy=wzst
z-sOD#<F;|r>M2S$RvK+GYmGT4x0TfX@N!4f`BrK?x+0so%3S%{Hm<k!;Ek<^82|=u
zamVnGN6^-CTHO~H(Vmy3YB1_{5#2;V&r!xy_Xf3$uC7B?EL})ZMlqasst~b_sfO-3
zG?*O4?EZDjyZy!a*bd4&ena)F*=Gl<BWv3ImYE?xXIAs4AaRZf&(x4H>}zQEGJTIn
zfca|AwBQaDb^3l)4VJbtFK66Y+=T<ECzH=idiAEX6V%{5XQ<p>MfMvK=;tW=PDx{q
zKDp!D28F0Ivx|MZL<;$YZG1TE>-g18J7`Q^x{>Qz9lh?YZKy^H7}bVXA2O9A2k<BI
z6`XzRGe@R|#8}hN?edmVy8^HWYU7{Br9)}E4%SyVFNj_u`zE=kTU)*)SroAV<SVit
z<<s%4snbc_8C08U%<e6xo!;UcVPqLS@H+AO{<P=rgk8=D;!TF=KG1;gQ;((q=lT9s
z8#1~bPk`@5--g7lxce@55y#4KN9&PM2d6J$=e_%zc3avsLJ4Ml#F9o17$4_atqjV7
zQ5f&@eB5zKjG;4qqgarPaUfCO___YHo7o8-fp0h2;KXA)1^~xeRUMg7)fQryE?P{t
zO!1S=Mar>TS+*CNYqhW*Y-20+2O_9O9gE7*?g4;qTb>6TXVbW(*HksxizF)qN~Zuh
z+;jOJbKi=DtXBG!q@6sXb~CeKN@I{S>+eH)Y8KRXoo?GzqajOhKpY-P?bp}wrRWB<
zN#&xm0Io7Ji;cZc`R`3W;w*_-q+=p%C2&S@fm$bWSyNRl_I0^{g_SY$U}psIGx!h8
zQ+>p{6lT1)ngM!+Rzfz&2?NSFJF}l*){EazIL&v&etpY9rO3>K<?|Ij`QwE3<n^N9
zXn0@36I>{|))dB#%EBKmeaZFuRmL63a<Sb;v0B8DK@g5L7zzhL+O)NaxfSg4#~CoD
z`3nsE#YQv9&JS$ykHmGP?h3^4jp_-`(m289lbF<QN*qQ33`qKC@y%rAb409F)@`Gf
z+_*yR?bLtus?@HvCfev`SjxzyT;!(&w{cQ46Irx{q?;-XPQN;*J+agB{J$(yv$1Vm
zT*>gJtNn+oNd?5E?Ii(R6UN?w{-dG#dsDw7zd*M#vFSlxOMu4@2^mISe;VA(hh4l|
zYiId@W*7s%)}~IwNaHW=+9-{>A(Haoj7Q1if-*lEi0aCgh_T`AB`oKfd7Q~{FbvMz
z=jo2z{ylmc)=t_P#a~lLQJG>Jw=e^s9nVk);zdH$l=L|76zUIcZMaCnX|k!$AZM2U
z00ZiMs-A*ckN9t+E!5Ad-7oIrC(86E)|?knN$F#x)a3Idl&Yida+xDM@y{NeY1ELQ
zh%CbwZ!8^|-N-+W^Q=~hvrX)b&k^ctZ6uRiF^=8@JGkJSWDkC-KN`|2LR&b$4e1hi
z!^9KnI*G(dAbAM?0LM@tZYx-sNc0ae(jZ7Xkd)8k{{ZTuX$}s^r{Zf_FSKctC?(Y6
z9-mLCIj(uTNY*-|o%m6D-d*L3@+D2IJ%=P?@iZlA`i}RHq3NRKyojPhxyL|1&(gNH
zQ#+jP-N;#rsT)TFidGp7pw6RsbN44I52**A=UMd`-NMfj1t7A5GC|{~f6w%(p04Fb
zV!@I&&e60fz{&1-sVKE%;~`vv56W_Q<WoX1uAnv-azrvCljlYqI`Tg}eg>;_C7~76
zE9HpL008vie!jh_SgVx$wUHdD^Dw}<CqJL9Oo19U(UAaaH7fWd5=UGS*X!?7uR@7D
zud~7n?m2w*KA>}s`OmjnYio&+-&`Ui9O0NA0MF}IwI!6FP`0wtUgq}XDumj@)9LzE
zyI6ylj`G)6P}VIWlt0{Lz<*8;Tn=$rzja*}z2|0UX!i}HYe_ZQ387Q8wlcsI_l9br
zG)$t=>K6BqUB;3^;nl|FbsQ0#b*;?7!#k(VkO2e_uUbHbTXs{1!C}ul<NW5K%(V*(
zA_EgC-U;ill|O+UDjK-&VX`<v0qS#wC$GLeDLWL45U|@GTzluzj(}xrQ8l#U;xM~i
zwzr_FLTJvDe1bj{Fgz3dJ$e0kq>x<aJV9mWfi=4Am000>gOil}dwnQz(!x&8=8uB>
zR~&FXjO-XBW=L4|$94C`L>pe|a!Kl0y||M4VoEf(668Y{;lVzgy=t0rc0x|d<obS<
z6}*k+Kb>;f^W+0Oo~k{&AEr81nn76+tex3<>UiLfAQIr@0fG3RT8+v%{aaCr-WhH#
z8xcYX7|+hco(I1J{{Yogw!0^Dg0hP9#d`QwKPbU+KJ01eKhM1hIWg>doXrN4rNd=r
zQ~;qyIs9vFB8;_@F&Mqf+i`_lj!!}UHO$*=*()Peird?+_6qF7aXG*k&+-%})q_04
z;siG=mUl81TX|%Wyu5N4wp5?MVzt{tHm-MG3tL-V0?lnQVKIi}edZ@5{&}sVv70ot
zYj+AH0Epz^Fc`t~{{TMJo4$ifLZ+VHW4e9PGP}X#0zXQ^alXBcV(p>kJ`!W5_|+|D
zB|&o@JzKZ+6m(2Gqt=z!G`JXL7#voFnC38WP6_YFN|J}%29H&gbn^+5J-HaHuVLEf
za|EH|MobV?KPR>a{{X6!DHZNyCnrC6=N+k_E!o@+*lrkfIi+EVt!1EykM+#|04eLo
zL;T0-MZ{Hj1hB^Ort&ZwILFrm{PRKpWb(LVLJ1+2hIr2=n*>ZQ<Ar00;afNe4{mrK
z{W3G(+*B>>Q`+J@%7#Ki`K-D5vw%H^LHJc9OEI-a46-{ESin0~4^j2SXp$kb&hBpS
zyi=@0VQsWV2}sloAi>FUJwCjj#*@|P3q*QGkD+PSc8#UAyGw!#+!ON`z&X!iGuo+I
z{I(Om<xPId7};UJARu4eU5Nfy9N}aGqkHt{r)tVnto_qPJMLt{w|W$!OJ?6^KP?X6
zLwl*uUY!2`I!dFCfyktGmU^|F=FhX`W<M*V5D5K$l|Fu8<*|8@hcX3LCjf(tds9GH
zI7uXBV%Y#;jsV3igK^Vs0ObP^4;abjsd<T!*t}AbU5h_lH*dm|8W&SUxV4mrEZtNA
z*S!%2VOptnWgL;v<C9f#ZE`!SR87F(7YIoma;=bkxX<ZBdJQ6mm8Dt5s%jTA##p?8
zf-u?{uns`S13dj|Q@a~Rj4}wNm81CtoHUzukiXquLHe3$rSOTX?q5k#C=6q6&_FwA
z0|QaM^5GN9f-{r--ZA;|agMp^O=u^n=K8hu--xx9wt$yskci_Pfu8(v{(m!YJx9aZ
zG(H^CN{yw!-7JTz8rm`CMpAb(=V`9)JlP3VBO})z;aN^x%+f2AwQJ?ah69D~j;5kd
zl%%fCZ^Zs4hSONnt<>+D=2cLtc~mC_zax*&(zJ|pB2uxZ;;S{){65%4QWHFK7mS0S
zZ<N%=Jhv&km>&x7o!aL~xEL@=<}Q5?-e0ak{OeUKD;c=mo{4y(c#&6dT;%>-ez+K<
zJ<MT*xf?>|hDgpi6kC5VJln?r>Ao{twIMewS4szSz+gWRYba`(E?PUDwyd&Q%W$i?
zSbgO=&&!|dS|@Z%MH@S1Ws#dBEyvRWmBvY{NA{GA!b43CPCK%nPCp;cu$pNWnryM*
zJx#APsh6uj?Fq=osQzG|#)Yv<a`S@mi1%cvz!=9A@2!wnmdZILm&;HT0g_KZ5BW8r
z7Zz!L(}NHtK^VtiI%oX<04mRY##xdHFq?L+-<t=aUgDYo^1<b~eXK^+1ypAz>FHF2
z%t@@$+VUx*V;h1(k12^6=Ylw2x;pkXE;n~WQqs(tG`JDSR7jzKjaPo=Z_Cv3PaP_w
z7M7xJ`w~H?!xkD+C6zES{3<!lGuNk6Rn6F&cQ_~0W$>Q9*H$sSmJ+5VP)f+EPa#fw
zf1g^Lm2Ss-r^yY>Uuv?r^O5-(>+~b8YT~-4L+oFWEYSIPaj-@pZE@F+{{USy?k22r
z*P0E*lx+G;&n$S!hEfQBTyc#4RWgm$ichLA;g;4*g-gUXlPhBY78|<fla>8?cC2Mh
z^fXgO?Y;HkESC44aR7p@LGQ*7Q^(U3mDYp0WyrOgxK7K9RbW4j2?z1(S9ZxKZBTr!
z)|W#Zl^aLp&p-WYIkdQ2P@7t|w~aSjO%gW)%-S;EooP3HhO{c&_=O9il89L61c&X{
z3zPh*YPLhsk=x8*W|h`vLP7H$KP?B)6OmS~wPfkgal4EHBh2!%amEK<Ui6c=3}<H^
zZObn3Iu4&qQ%D77XyPn9qS-$vJpNhf_)wOia)s^UTSp|*NreS-l22UYf%NIut!bho
zbIrBQUh7%Bg38Gm@I17Q208vC^(2x{Y~rVJo{8X}3`L<@o12}jcEd8hGqiQUtz#P*
z$(k3FwyAKch{Db@z|K6z^*ym!&Uf@K5wO_N8gjdpobo~A<pVu<7|7zYa_nC(bDHsv
zwGNqT#GXJa8k5xLk&o+CqTb}UZI3wco|Aj8_@Ol>-0N=ZGqdLh9Tax_D|q%sPkXb}
zbcY}<r2M0)13u${{OTl&i#YuzQKR_D!x9yy1Tpj{2l<0o%SNPVwYoh}oCx;d0@(im
z>;9FonUSg?X@LxI$2-2i<kRRQhxnsxO|G4Isz6gDFYXB3KV8(m(+{$D-Vm5xco`*-
zhW)`m@E~wMT2a`ixg;R4Y;NI*;7|sBs|EF>tM)i!xGkS7sQJ@9k3X$vB;LbTTbiC9
zw3knUSfza2TsNC9&C{?R=7$?1le;z`05Cm6bQq=7eFxl376S}GZhQtkeqa8-^34tO
z6@^4)jDgUfeEac83!+pdGC9T$;eslFNeil%C$|K4rjUwv8*q*?#c&mOcPEqj(?TuV
zNV!;Waz;xGe=1kF?P3{Js348Y$oWP|=l=lLNr9bqkxZLsD5n@=dJlR4=b9U>8sqIc
zX(|Za<qlPca6Jw|;-#x>Rr{Szhp*ad$>hjPS6_9bZs*i<LYAP>Zt5Si23U6}a!yyM
z<E>hkLOFVsFZAmjT?5=iMB8!ZgNEtfvHWVAOj{h@q2cSh2;NvGifB{=hdl;;`hIkp
zzQJ=TMzJvc%<CF1I05Axp2U#9uX@jxCG#>{jU!vVMjzUGlxxwvxFh+7KBpf+M<ja(
zG>Np|4%pbn4C!?wn80bL!#C-ZS8{A@TQGrfVH8%wINXu^-rq4NH2I%E<?bx7w1K6b
zSA1oF-OuIFR9LNvRHR7cf=Yp$3?F=YRS1q}0%*Y-U2+1E$RrWd*P5Xj+P0w;ovim4
zI9P(P;y?>Far$$gelbW#n_p{pzADwtmXRBIWzNyi0n<Li9s1L0uuSxy2Y6Z!587^g
zOMfR1Cvl#`(ylSFE!@@CF8=^_Y$EE!dCofz?vH%YQe6TosZv&G&_tVpDgF=u&(z>n
z4W{gCW@ldNX#`6=jk6Jw<oD;-(~fGR5?kzfJ^jSqF7Y3gYYAA(1&I_f3Zsq3CqDga
zLJw{5){$?c=&1#mUA(ig9I@_6`qixwFH;*_2HNg9VLM959Ax(HKT}gJ3W>&iQiR%S
zb~o{4ETB6Pz$c;nz#o-MSJ124%<uH8mbud`r&canA(B3BoKXjKhb3moZ`4T}91Qcv
zpzT&c$$0q;z7)e_32=?mo<S9you-OQ-DdB@Io5B7cR+%{C1mN-=g9t*TQ()BwWdb$
z+mg8;F&Q1|ZaWsGmwc+AW91p=zIds<nC)^zPn5R>k8pYcM5S@1Vn!ke*~@&Oa1AEx
zGQEw+mStHCXMSD3*#PiAAxUZs(1^^j$s-WMs-WsWF5gN(Ndb+}l;MvhTLho-b5sN}
zTnP(h$4)@)>?(=5PH7C8D%lZ(j2`_7{-2#E*b!zD#ZWwo@wfMRz~ikXQ!U7#O|=+p
zI2`xm6vT?RN6bWQWrj{h4+o!5^O^w7yNrlfAC+4pb~|8yPz@k3uJpM%mM3+Ua6>Ny
zel$3yG}<;a?-MjQw${KBU~ISpDt!wN>sY(3%T{|Ew|5rEizGN;!{rIieGk*#tx3N@
zN+}sznrRcy`HB0B$xw0W->+J~Qg$t@yJasrp(O1X>^=Vg&$TNK<P8J7(!0wimBCnp
z5wwo{8g|!F5Zqf~m&qYflpLwcbJ+fL_YeR=%l3loQ4b}!`T_ZKNsSJjS}SK}+KQwz
z7SBxbed+8g+^saN<mC<wg^0+`DWYD4_I9iOzCg<owm~PC#yR%pm=yK9JA2!E+esip
z9@HamB?mnFfPb&8E3w$~e+=Fa2KdA!$`7$z<`$Ew9n|O2t}@h?k6gdMHqd$M2xGzm
zJ-=L4w`FotyRnY}F{b$y-f42g?an>VxBmcMx#aDuHcI*xZ|Cw^<8PKApF1`=>A=T9
z#R*?gH*F6q@m9Ysy{RppoE_oau~i59!&=yjo{!*P3dN)8%4S{Hvkc0^qWTZYtt%4U
z^g4+)1X%u7UO-0ZcmQYA<21xm*DO+9Jtc{YkaEY8K+hxetog28ta3gvvu#Jf-f=Pc
zwsP{NfMPR)f%?+fhL$AwRdz0XFkyY0?VPInf+$YSq3)AA8?B87)fxM|`VODrRdF1b
zit#6dudoRV<u~NxgHbi_MU6cgEPN)AFM{=$!*H$}7&+vO=B<*Bi%K#JW3@K|+2b5=
zDj7wm4)SI+Cj@mk_3v4>T1A*V#E{@*@Ccv^x~0QN@xdA?8NtEexBmcJ`qFQp(H*2J
zw(PSoX?BHh2?6uL0CpUnD2Ov%W?1BoLAzq8UOfl%tFad--6}Qi66E7?+{$o9TPm3c
zw<G9933Ud{j}U50X%gDokdr!)&Bj3X_o@+{qUtcgFOXH=mMlQZfO?<9{Ag<6v^vWs
zwo(d5vG8~&mOtmMO@_x@-Ku2B+1dA)e+l}~#)c)!G7zLNJQ0k3NAaXR0_BN9K|X;<
z>-44~9m}}5W1fn5=hOMpU{$(_ZjqAV5Uy}TatQ1Aai8)j43|oRJ2-r-C|v&O&rQGG
zKK}sDgscpf8J(w9G5LJ|01)7hQTS81Sh6OK&ebUG>DxKvP=StrH2(n4Fj$fo6vQ=M
zzj9(#M$coxIqQ!~1XI**<3b?_uQQSeP&fzg6UPFW8Jf1WY=3zmiYry;B!W-V>+3@9
z53ysz7uK5e4S#MLOK7BM(<6o>2PfAV<NpAyO3i3BW@}x@%u446ZyaD6E*3J>4UWNC
z+dE0%^Vsvy_Q%qTg^nx6+AzI>Nfk(!Y579;=cYeD&XRTw)r+1I{?NM8EPu4-^CW^W
zr;n-UBd#z$xvP|uB}T^8$twYQo<+|rug4sKJAYoaf=+L9SMIHkG4bz+rn<PBPO@*j
zLd?iHKkN_d`Fht%Mh{b|_<7-U(rv}n(kov`x#yoLeLlXmX>}#OhioJf!-1AXVl(P<
z%~gePXY!)+6;R347UV5NwJm5jQDgQj<f=-<V1F0kQkJ@ny$(K5rg9|&jQ8~KR~4Zw
zt?-W3pj~b$3Ed3K3lDL-Kd7j;QK!)FE<e@C0RHYjJpTYH25{avmEiEOMPQ$3l|y7?
zmCy3v{!}ekJrT3;!T}$F?(PQg*HN=DKkT+M{c7BFxhd*z=uF1V$WTw1LC>}a@&dAE
zg~;7_7{SL=S+Sy6Rf4l89Dkql??BA^C5lVT%PO!N$^tXEjx+kyCN^2LRhHv&#LE<T
z;P6i!e?wX#SeIIaDi|)-EB8Zk59d^wEamm@5Us2xNdvUGK337U2e2QhrnLrgkX+qr
zI**?rJDH0TM|1vj>HMj%JsZQ?WOjC<X^{ES4Z}FfuWr7*e<~6}WY;$B9BXlGa|&m2
zuO&T5$EH6I<TY>!C6;KOWC+R^E(>EkbsQR-4&{RYc$9+3ai5fYxjlbc0Eo^RvQ<hh
zG2Au?=RbueJB^NLx2$E88&oz=Ilv#&^`K;%gX~lrc*Z*5=dt?Z^E3d|!a&(ykaAbp
z^gqmg6oxf!b{3Cn$b_6LU={Cxe!u6MNn2oglE94^B^V*#`G0$_zx1acF)~KFepV*}
zUP0g-b*iwgQ@z#J-CWCY<wl)f9OwM|9<<UG&L>*&Oi(1S*hITqmbi6ck?GGZPst0^
zk4f-#?!MyZSb44Om}hC?Ni*&IBir+)kefTL9>y&tPM>OlEaD|m2e2J|fBN+^T9p#)
ztYe+GF&HIDJdS#QT7vW`$r_hu#^Zs&=z0GD>yOHvgiyRgFfqI?;iJOg`55CIbJL1e
z3zF$^NfoS(^Ue|W?LbR0^*+R4^z3RAY23DxM=Rsqb}c(c&AO`HPR$f+fO!YzZ*VyL
zaa%2SF=spQ+rxiom9=a1W=!S)-Ceu2XqCxs$E-nb=36^9K_`J)Sj@F$ZMZB#BE$@Z
z>9q0JHI(Ji8b&?J^7&I3r?=)A6<8q~a1S^m^gi^U^eRY$QFbZ71OvzER+gkUq0U{#
z%Or9b;VQf?Mp=$}0gt5&2|NX4A+o%>ar0f?+)nI9I5H5U^1=LRHntjCoh|f$+igMf
zxxg6b{Pd`092dp^04~GBHa78q*Av`sZO5Ier>CbU{N}1VlRb{tK(bvs!SGu00@~pE
z?%GfDs+Ynj?pe?_uAT|xvlG&=dzz*YIcHv&_0QI&vXU)G#6=Wfuy+0HDC$8341b?W
zmd0~pF+J4zWidns<s^)bxW+z*@S{h#YFm=w(TMY8L-OTNV?2}BsO0+9B3V-MH4%v;
zelxX>2nq*Z%B=|DuWsYM)LL0v5JmDtjo1PF{{W>|K^>oiw1k}fs^LkujPSVo$FTmU
zlGGX1&n%BF02yKic);`@UbRix2`iJC1PT*tV;t=Vf$Ndb)?Ciz*;>atsM@WN^Owy_
zIr%$A3`F!e^gMkk?|n(wET(akdxZxDLt|(pgO2B?CX=!RT1fK~d2gH$FbF^AwN1xi
z6zqgTu0SQX0GJ1nfuHlzm=^#I3l(k%J-U6`3L{WTa-(MAr)kdwlm0~@u>rSXB#xza
z^lzx``u>y!h}Uw32u|UQAJldA{&XQ1ZSEbF)!P~4Cmj#BT4Fdq9%$OF%+g-jsCh&{
zd1a2kan*e(satTjV(-KKA3~8}xOm!4Wmor!bi}$heWRv5#cHh9hED0~cerODqZM7b
z`FJ4yUs_;MxO7|Fl1|`A`=o=>MP)Nc>`5~2k|OKW@8hWB2Oj*Il7>%j94K-_!y5t|
z^Ts{<^r4_2`yrnFizI$TY8dW0!RL&6=O3K`Vk@v@g{M?#*?v;M<b4S4KhJuWpFyL?
zb!es5{AXuts7NA#m_n+f0TU$cAEz~}HQdfx9>SI*%8ENsh>)N~QN}BNQ!ATsM6pJ@
zRT+*7r&@`=h`7hADIYfB3ZqFI9OdF|haJbJYc$d=tAuGBF(g*Xs*xZFfw%x156?6$
zMX{f7;h+U_FhR%p^sPuRZV`p#Qw1ylDs$0rM?Z~Ade~`oIx9<yds`cLA`23jzCyh2
z9Y^U{`LjWRC7wi(5?C<U6kvXRDXqkLp0#-1F7d(g1I?xB?XXF=h6~AW_!AC2fHkaD
zjO5Q&jFX|K$jV(g1bPgAS|;u|s}?jUm2}9w@0HGY=~%NwQ?Z35olp?j;glTr{#dBd
zl(a6sWu8goBj#ck7(5OJKLJy6x*69tYZQ~po0H6CMhWvUIRFp=>EH0Gw^Dq9I18+?
zvjmc61UPOu=bYeU>H5_nG;+Qoyb(l}hk5w`<wyhoIV0S0SLR8HrRj5CY8J{@EY0@-
z$6lHIF-7h()y=WAwTjj~s;a*;1K+s<t7J~>m>583^2>5iga;(_!3XJB%2#HISrzZK
ziybp3Q@w)8e)sxJsS&~UBv6xjBn_pjXFETSyeS|tzO`>6kU&V+%qQC(pPgu_&2%DF
zAo`dS_>WA6Ne-CTx3MA@jxlRAWH9FenF8bAKb=>zWb>nL%fz-4fhfF+5h8-o&yYs|
zk=xXF>sj)?h^}jHYYkGt9oXGzz@ZG^=@EdL=n9jbeLK*i`wy7`*EHzMV)7Y^umx?^
z-_Z2~9S3TBudun15Z3IKvS8E{FaYAlY!U79d(!1^Ve<<XtptqC9-pbp8!mSXNe4ce
zBZJnCN9Fg2GX9X+uY-V7P1H*ByKTAXdV$ZcKZP8xy8FYJYv0IlTTRtt+;YU)w_ooJ
z1CHL^Xt$VO$S(C`708HN-h9ItHnU@ngCREcKd)+5A2FYL_7{sAT-#j5a6lw2w1J}_
z^%!1%N|hF!)3IF1^d_^^=dz3>+LxCZ$XM^wW0m%BbMMV+r7L$c<wcn9qqs5=vCr`Y
zV8cB}E1oG{`-QAuS+>H0Sy7a2+*IXqK=1AU0M??zGp=>(4LC@;h5fV<f>=p#%7C2q
z9a|rbH3>bCoYLKkp?IT3)~9%2zd<o14bFk2;GC-NC#OEt+$5HurkgC@Tv)*gaereO
z2ODO&j0WxNQD!@%%f2Ek3oKXmS2prX8wMiYRg|F|kGe_6_zH1NI|Q1w&d0$%CQVOB
zN!ly<<d-0Yw{9EIHq~5o?oX+$+^wOCSJddO?r%ts%dwm<UDtOB9u7a*^9^R&G_x%k
zZ@it-TUkdg3F23jXV;?C=vJi`YrbCM;?xDnERb#F`sJFc_9oXc^$Vv=8=JYIg}D;4
z#tU<R0V)^s=j%r>tY1X88gVjxqC``KdC5ZA!Oj#ebLa=RtwVBeQkASQHju<ccX2c_
zY{H1|WQeH70RTAT^rKa<X|p+t{{RSCNa{SJD^9!7=ay*{=NLaT=REQaY3*9w5$x01
zhL_>Utv4dr+XX|1NLi!K1`Z05`u>!iP*jckSS(lV0?s)jk}@M<_K7!-ayRD(9e>Er
zoxY}=sTp^+_UmxQ<~A<hHc@k*bCc_ucb7oW?(LDR?b+qxU9Gf^+3)qN?zbqG%nhj<
z0#{}*M}J@Q>r#qkrGg|)uAx&oz~evX6?Y`T*0o(HN`imwOZ#gE3T07oF2Z>~bYm_?
z4-1o37{9Viq?YHHUFugl#;9k|bgP?~0)&p@;CT@dj#zISo057jr_!&M%iebUN#?)8
zu5V~|nyripBS~g1@q$*}-Bac#3U{w_-AzY4R>-bdJ<WaE%d0f{z0p?~!$oen9)oOI
z{b@>f-3>y;DeRhM-FbJZGN~9}w_FA1f$}SX`cS0$152qjhllJTLo60Hw(XENq)M(1
zPDx-g-&!1--GWJMi!Te?sVO@n6O0U!Pk;XaT}_I)ErL9<t4OUTTLEOxB-61sI$OJ;
z3}F;AjO{9<1<$deBn^zX-Z0TR$h&^y91=Z`{{X6u!(rBv$iNrLIXv#*3}c_xiw@<#
zIDiSAmNg@UQgh#~FgkVr02%;#ux4ZPg#!n9$<N|xp%A07eXxLXPi~Z$#kiD7@<>A9
zV1V48Ond$`2+P%DX*`rgS(V00x84LC=ReYz8S05Km^e+jBWVZaJ+KGk?MaOlZ><_z
zoNgi6gFI@A2j`6T_5T1GRtwm%q%yXveE~#SWVTmVRqM5m;h&>^l~xgc^->ELoD9r^
z%~DF`wvIaWJGi8f*+Wf3ZKoo=z<a4=KWLSIgpZhj2Tw|-`w1aiRJki8Yd+I(NGw|=
zcP{Mn(*Td_Kn&8gKeal;HO#N)e(733SfgN``5jjt`5iE6+QKtDMI`8Ntt2luoe4ND
z7i)AG7{}ft9@RD-&VS*2rr%L$B$PG0g#PWng|Wf>sdHL(?mJ!=?0TeVOna0lHK7Gv
zUi#lpv|&7e%*&9O!N<R~D~`t=`m~yYLve43Ev1{vgu{)w2a-7(y+2x{yOL{ZVJES*
zyqNF4niXkfak;X?B|$wGlhcY6fv)DWY!>4(HdiF)<~=)Sr)rlb$I6arE&R=D`tC<!
zyHe6V-zwys{aMKW0D#qA$X2^7%rD*mkY0JHdD}9E$;mvoU&pT$^m~hKi0x#OC0T9+
zf>m66o1I9{VxvCXfl}bcq=$>Bu5W_KZNy{%tk1SpIrQs}o&KQKZY8E)xU=(|Z9)P7
zoRAJjTD2yLX%4^FH3?EBhr_o_ak%-@!kPa7zFm$u^c{aJz1^-|-(o9|5Nhn~G|dj%
zA#=X-QB(l?Dh4O>6w;4YCgsr-&F_h?WLWOCdutLt^m<*0E`7JkU-Jqo`JlE}CenMc
zEWA6WeXTC;?XLA3)B#22sXI*~fO|8XFH^#SM?9aB4p^^KN_Abw%VkE#EW|(g{Ak%|
zJ>H_*n6{8uvBp;eAk;lsTOni#<S-2D8uuJE6H7*dE%h_!dq9E}oFt&}xp@bSocjCF
z<iR63rnQoHSuR0tc7}3tc<4G)if?f?x*9)ahsjor+D2o?2adgu{{UW_5n>4qylwLZ
zLccj9ra33_q%u#pE7}<mm03VBk{ca)KbC(=64XuTMfU0LWoL#4WZi%c3oZ{*bC2+<
zu&!xBj~>>USgGWU(4EJsG)aa*AD8n1&>Um@^y^8WOtBP+ycsY7>Hx+)C>_w(i6V0$
zAV$YODI@t%&>7d$G&3Zq6v*L52^`~$_Ury}Kr$$$mf|%73ZaUUGo1QxKD4eo6%qo{
zO5A|VPJIS(PU5iX7BS`kNx;B39FE*}IW(BcDn7%iY4=Z&5*CU~9*Eq3_5T10eFSZ4
zkeKa!q=(GGU`QO~kU{D=_x7M{!nl8#axkwVhuAn=oM$7qCYdE^9e&YuF;Tb8m4PRy
zDxrUwpas&cfxEJeS)nFbBqyFgDo5x!{A#Wt{w74a)`VzEm*BDYVUN&Mp|gS0UTZ%U
z0dAgRn}ZQm>yYOM++ftsH$_3~W7O_-*~u{4Mgtx<9!`C!x70~=INu%IK8@kKtw!oy
z*K+14SE+VoY!T^$gO5reoTQTpH5j%*@NMFo!*j;!+aZtv&u}?m_0Kg;H75IsG~$ue
zY0_`B(#^m6uOuv(>A=SyQYZsaiDcTjRbmbSJRA&j-=LsIJiof(ivIdmY!S#AIOEp<
zesxGg;+=>s=7Ap=On$%2(s~TETjV}a1@n!=p~oN6nvpIgd(q}vnG7ME41nqg$oDl;
zlCY9@DCv>N$#M3p!ekRL`SYA{`2KavCuVddp?XO2awAOj-sF;f2e7J8Y>r|#fD`_^
zYM#9_{HmN9+)7E1eXbi@l(%<i*BRdDjC$iecsx<cJCez+SlSb|StOSoRP9{#;1B1z
zr73nBXpT*0$a#<ZnD`r0a*{`=$<Onuv+7OJTI0q#eWY14GrJ$UtVRcJ!i2nr-<gGf
z;`_Z&n6#}vc``X|g_w`7Fh4pR8xoOLEgN6fWmma`T1O}GNZ^$Rl6cKjY1ka@b-FKr
zt!-kFuWp*)?d4FI(;dM*Pv?r!N4X9~i&*2ewnPC!1qz6{!jEtB>sa3G(_}L5RDvj+
zET!Z{^ETiG1abi+{{T*Dq$bK5J?Xr^iaBK1`7ebzD7+KLZhM-)B2JTXL30MgjU!S>
z1FuYV^v6GiWbRrV`h?K1Yk(vj)SkY(PwP{0kPEQ{&hShY9Q>^OE_3%=(DT9mxX!8H
zMnhKE)sFZ(y|bf5aHQrZAe{Sp(A9*U$z!=?1s(RG^%Wx-Gz%!n!N4FD#y**#t<1M`
zZE+kjWF4n+jQpgIoqFW{Ij3P<lkH3(F-7IFmIIdgM<?6fl&qD(HuN5mG|tPtV+c9i
zdBGpAN{25Zxk|CZw+gY9&h5pC&paHTrzW(yCY`0+Qh9J*osJZFY<}wwoYG99o!z6y
zBg&B%3IUD$u-W(T)9K!rjJPv%D<nblf(GO&T%M!@&~y0Hu_nEpvgwwk<=Q6NRRR75
zCnxiy*wKfm25nRrnVVpYug%<drnUn!PtlAzt7-+211`m0e)kz~#D6+X^cojd@fDYc
zA(iBC_k<A|pW!~Izv=5!%H^U9sOrx%)o*oA9%~TA40*P<k8Eg9%7FD|<Eh|r>0J?z
zBJ(nn=6*-1cvnD&PS7ILrjl1IcT2WHp^s8HJt&sfV7!i*Ay{ODMuIp}Euk0X1Fvqt
z3~^aEa>-y)Sg~9;-ak)jE(bk(Ae!Y^;!iC=2OT}Ckck#TvTRK4#v9O{w3-=hSSSQ2
z1A(+2orNI|lrgYRFsg%{$2iUhZ%pQ;vg}b|3cDGKWzOJ0>MI%O%_8(H>5*RFGs$GE
zr<_YT3Ku<r2R_xac4kRj(T75k<sZ-0qh=&;Sazux{t|iqRCA!^W<IImn|Q$}_Y$}p
z*_uLrQP(^V&}N#F2APj%pj+y<vPBxSYrg|)oB{3+vHfa^XHj9{9UjR*HtRDErN>iM
zWKG$8==KqVCB2jpFyxg%mip6H71@(}dueYeYjqOLI38C3el$5K?lhdXGuv6cX9ZR$
z!00i&kL6jqy^(64ac$?mzq$a*?xbX@3~t9`QtCD}1cqvt*Ko?PTfr1tbMxFkl%pfB
zsqT7F6gJGOEjkOCyv=h|6Cfn)M<5(v40R`r_RmVuA}`qL?e1(Xtlr;ButW@3bh}9;
zcjWW<`_#&5Ee4|A<I?)w<MX0yDUE}U30_Db{eP8C=&qr5N7&P1l8nazhd(c1eZN|f
znd>xhmR-BjZR2d64tT-!<PnNuXD_YmlWB7-S9|BR65%G06EY{c?o{Khaz9;Q@1dN#
zo7Niq;wYuONo2Kf3QRI`KD|G!5{F<<xxHt16y(iqCiuwp;8tx|q$SjbQm7G|3`3O}
z8RHr0{&7@*uW^HEf`!-~0nbs#Z?EH7%IelCHtI1hUPpo=0=q6)2M3Qs?^2V#r9HGS
zTf&P7X8D?29zTUa?fmNWB#j*0Uzh_C8V@o}$MIF;)QtTzifJvuvNJndN*N_(!DVF!
zaL?1V77LO80BFt&B1+6zxH~xqAaj5_`q8eyRi5nZ-7A@73<-~%o`04xRFIn&PPX$R
zxwyS88FB^(1fJvk^r5v7Nwbyl$Bb??^zyXuo@PRa1Tc#ozYGc^3%jvOR@mco9}nMn
zws~(Z=6@hJ&odmCK7-P=T4;>-)t-l=XqI|1M3#||7jqZR2|WNcLN}~ncPP?t-cLOA
zA4-{QHMyxK6&--xfDjyKaXfx_{#Ajg441xKK@bq~HpS$65`REVG=pN4QQ~CsV^`;e
zVV};Zk_3&u>G`(z0~y63lTUN@aA8z0kQu^|F^^MF<Wg56n^w2FK?H~(<gOg#bK0ik
zu?6kTta7T{tV<wV9sC{%AJUtJ#H7)+r`>sIv6pek+q<2kz6Yi&H@>Bz;>g7ky0+q=
z?NP@q#!s(a{VKW&#&)%-HLa>f&aEuGVU9@yuS&S0S!cl3a!DP{<g5vE^5kRdS9=j_
zokQD|iJjRMK*=QVDRZInGY3@{7qK?k7CTI2E<R~J$m#_|syC!cj1twH{lI%bN?EL<
zJT#B6H{f~-QG@DJlIT^oy1u()OM5FN4T4lQ=Hz}Ar?a^n=8xI#BZMj#qH;h#HUQ_}
zr*B%8mF;qq(&lEXaxJ1hZM@BJS7^hA9maZe{{T6om4cEnS667!{J3LQE5{po_VuHd
z;mlHdoo4vFc9xftd7OOeRRHz}0<A?7+cvx<;Vo|3{yU4CrME`NXjh%!=kHUs$!#5M
zz^#g;pzn@CrE}2WXN-5-*ZgW8jHRhTV*nleBIgH_h9j>}Ui6tr%Gd29zO}fvaHY0y
zi=Vo~Ip^>qnqp)>3H2%M+HE3Y4Yo_e>bW^!e;od`s+zrw`5mrxTAqlDBVB2kx42)t
z6XjF*Q)o$;uukc6%X^sF&J2s39y|JU{{Zz=v{E%L3PUl8B2f_;+QT5{xiqdZA&xk%
zHhF;~+FQ#AOA+<XJ9ViV9jjlZm5kFuLlg2K&M<Mu*B+Ih#Oz<fu19NXY|$Z*5hEyf
z9ZvEF0s0O<16q&{005seEaMqG?dKflwnZQs;xeR2qb#{3_ZTFey@>w+IG_ZIR6vIw
zbcbjFAtgxnI0GEh)ClDBt}`UJIR^m7nI{K~Za6tSasa556t^leYh#!3E|Y6<rpIov
zh=ibwgVBk?aqK~@6q+HVXZ$R@ct)Y4Oxs)oGI5;of<LWmdzsku4<<=g6(p%vRv~lA
z?mm=U4NC|bG$wp<-H)whDO}M;!!MitEn@@yQWK7V5`V(8D9T%(J6-!Sk+Ry@$l!7V
zJ7IrBlk*j8Vp%og4S;RH1D|v2Kn+=1D@kO>AYo2A9Ah+?(Fjz)U+#_aAAj?j!K<@W
z^fPr+4EG6aun3s#Wsn@_lgCcIYSU{%TIwpKG7m3Pl~(Ex-7`K;@Hqr@IKdrzgH;(O
ziE(M0wuCjqNXT}D9ZBPg&7{#+vn(XQM<7RKQNZ&XC%5?0x<lOL^;?Cx)d3tLuEC!E
zwX)cUx!w4786dHR7~nU}$MvFJg&yP{GS*|Vi7iW#%ZFtj#NC1VaDJqER3*&pi+UrR
z(XLwkS<H<L0ZA^g?kwMl=j+mkPBGLJ+t6=_EF0{y%?oY_2brEQ7<I?^b^K~=%jh)k
zxy^h(zn)EF$$y$#edHa-k;<t)xa06Oz3r);uc6m#_h?t_)`}b{QdO|Pa5=%_IT^>V
zHHo3d>bk4XBE=30MgSo?WDH<>{{W3zy{t>N=Xc><DmzUs8E-A)`*eiJ>_8*}au@Iz
z6|_>Zi+5(~EL^t1h8X!q59TR|mMnq;v1|}I6ozE$(Rp&kIEXe#3^$d=K^gbsx6-10
z%ZXCzI3%`NEh3R&C(GR-9Z2cG`Wno$E_hw1e4m-V>Ba*dMh~WWszPTUJ=B^%h$6eR
z%6#$46n6&!hhI`^X0EPO9i5M1Nu#@hD}^R7;aPf&<O5Y2x)UgCVuquqrO73g1K<IH
zfXCnPty4_TRAl*c+LT9EYks9YyW_1V5vOxXQi&9CM(oQVEX9rp#(rJCzx`^;PoZfX
z_LaL)@jPoO#l5a)locG2jiCKV&ONAt)0igy$+LRm=69ARCk!*ZW3S=<b3;wA*oeCB
z+;Zn20gUIjAFUU<9f-Fu!2oUA6!inR&*%PmrkI)=B8`%nH?9IdEy+3So}A=<R9q}1
z4$#J1JI?l)F(ij7LXLZkgZWU{SjpA*`G`>f3nn8zqdcF_H0~pi)mlv-#a4QajC+GP
zZKI(Ce8ByArln<eE?c`E&1}%i3{${2hfvCUVA68BA1^Dg+q;B@CYnQxebhb8NX*M?
zn|pma>i1BaYLqgwp30z~ue~L!8!|jDu59Jh?n4Q+8BM`bcN9Z`8k6jSD`%pyo$l^j
zoU^d@#(z4Ij@9E~V+P4dGDxa3(+2{k<FQX!)*!GfZU#|~)o6!aPgBzsoL4lgi+U|g
z?J=&kO<Kj)0Sp%GCNesW(hv>+9fnU{{i@{_lWdhF-H`20J9d^Yv_Tt4BLJR9tz%}5
zR;NI+g<YwYBw*ETp#(P!s}r{1T?1nS9O9ZtE@Ie3CDl<nfr0w<{#B|oXQK;+u+!wY
z;|RGK2N~!;TF!FP=8;#>@=p<6Pk(bL^9vQ^mg>ak`J9^4oOw|be9YAF^GGd%$szkX
z^2Y$<w*%8P6>n>m4aq!9ttF0ybrLao?tq9c-W73-^Yp1+_Jut)XF2fJ-c?OcQ=e!o
z!Wf2rZo8Y2)1r*~n%1S2k|Gy(WSXVM`P@WGE-=IlegdToz2Tckt?g4%xkD_>acdVH
zy2!_;(0-nlthFKC=#Gm_)@HuD@~4bPHcKlfLOYIo;+m3dPAwf3p_j~U$0$JBJC9mo
zG@*@{;GMs%OPWO}vMpNCWV4bs%MHA-KhmMf?6n&lwX9LB#|yEa48tU;U^?TsIq5)&
zE~4DTH_Q8`BWU9xhCfWylyH7AwEqA{g_*Yp1${85BlD|7vwz{{s<P-X+upl8k;&zb
zKIdNj$NvCZ(zB9D*wf<F?4h<PI+$IVM%<$kdJK0zPs)v*(L0gqQX#n9H*h)p`+8Q6
zO_HLHcT>EJ>}@#Q2`#i^xg=+=pcR_dT&3);W_U{S7|x>dF-aWxN-$4A4<|mv563;L
zp{pYs>U35M5ZH4ojpGW;aqIb3Y_v^tBB_uFxo6#l#sJU%0IH>;kyaH|5uw|VxP0e1
z&s_ckk6J)TBUwyKAlyMxdGsLFY)<6gcoINjs;YC;<%#R~P%{$tCTn>RFU|lP%W<~{
zck52*T9~)CDSKnI0FnS6Ha(9~{uJA|Ee(GH>un9Y+1&i<hkR$Bly_RnF4`JRb82f%
za&;X=RzQ5E<R*Wgu4%GPSI3&8Y8TOXYQrfl$zQcfcnY0%k5k<Haopodaq2{$L$-!B
zhRP_R1S+V<umb>oRZ`qbVlu0^Z5RX{$31gWI}u-m`&FcQAPEETG0$J;QZoz3cI*9@
z8=hE5%m=aRKhLF1G?m8nRxemc8&0*7Am20zxRd_Ks;MjJC@X4te~x@Zd1>M);Ix_5
X5mYb-zhC4<X-<-oyCQX5U6KFU|AI5B

literal 0
HcmV?d00001


From 8cc0389d8ebb66892a74b33676e6908a9b67e2b8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jan=20H=C3=B8ydahl?= <janhoy@users.noreply.github.com>
Date: Thu, 22 Aug 2024 15:32:32 +0200
Subject: [PATCH 4/5] Fix indents

---
 .../library/cantaloupe/image/Metadata.java    | 32 +++++++++----------
 .../cantaloupe/image/MetadataTest.java        | 30 ++++++++---------
 .../cantaloupe/image/exif/DirectoryTest.java  | 18 +++++------
 3 files changed, 40 insertions(+), 40 deletions(-)

diff --git a/src/main/java/edu/illinois/library/cantaloupe/image/Metadata.java b/src/main/java/edu/illinois/library/cantaloupe/image/Metadata.java
index b78b15a7b..02c9bd5c0 100644
--- a/src/main/java/edu/illinois/library/cantaloupe/image/Metadata.java
+++ b/src/main/java/edu/illinois/library/cantaloupe/image/Metadata.java
@@ -134,22 +134,22 @@ private void readOrientationFromEXIF() {
         Object value = exif.getValue(Tag.ORIENTATION);
         if (field != null && value != null) {
             switch (field.getDataType()) {
-              case LONG:
-              case SLONG:
-              case SHORT:
-              case SSHORT:
-                // According to spec the orientation must be an unsigned short (16 bit)
-                // However, we have seen exif data in the wild with LONG and SLONG types
-                // Thus to be lenient we accept either and convert to int (github issue #548)
-                if (value instanceof Long) {
-                    orientation = Orientation.forEXIFOrientation(Math.toIntExact((long) value));
-                } else if (value instanceof Integer) {
-                    orientation = Orientation.forEXIFOrientation((int) value);
-                }
-                break;
-              default:
-                LOGGER.warn("readOrientationFromEXIF(): Unsupported Orientation data type: {}",
-                        field.getDataType());
+                case LONG:
+                case SLONG:
+                case SHORT:
+                case SSHORT:
+                    // According to spec the orientation must be an unsigned short (16 bit)
+                    // However, we have seen exif data in the wild with LONG and SLONG types
+                    // Thus to be lenient we accept either and convert to int (github issue #548)
+                    if (value instanceof Long) {
+                        orientation = Orientation.forEXIFOrientation(Math.toIntExact((long) value));
+                    } else if (value instanceof Integer) {
+                        orientation = Orientation.forEXIFOrientation((int) value);
+                    }
+                    break;
+                default:
+                    LOGGER.warn("readOrientationFromEXIF(): Unsupported Orientation data type: {}",
+                            field.getDataType());
             }
         }
     }
diff --git a/src/test/java/edu/illinois/library/cantaloupe/image/MetadataTest.java b/src/test/java/edu/illinois/library/cantaloupe/image/MetadataTest.java
index e3b46bd3e..325a5d5f4 100644
--- a/src/test/java/edu/illinois/library/cantaloupe/image/MetadataTest.java
+++ b/src/test/java/edu/illinois/library/cantaloupe/image/MetadataTest.java
@@ -235,21 +235,21 @@ void testGetOrientationWithOnlyIllegalEXIFOrientation() throws Exception {
         }
     }
 
-  @Test
-  void testGetOrientationWithOnlyLONGEXIFOrientation() throws Exception {
-      // This image has exif Orientation stored as SLONG, causing a failure (github issue #548)
-      Path fixture = TestUtil.getImage("jpg-exif-long-orientation.jpg");
-      ImageReader reader = new ImageReaderFactory()
-              .newImageReader(Format.get("jpg"), fixture);
-      try {
-          Metadata metadata = reader.getMetadata(0);
-          assertEquals(Orientation.ROTATE_0, metadata.getOrientation());
-      } finally {
-          reader.dispose();
-      }
-  }
-
-  @Test
+    @Test
+    void testGetOrientationWithOnlyLONGEXIFOrientation() throws Exception {
+        // This image has exif Orientation stored as SLONG, causing a failure (github issue #548)
+        Path fixture = TestUtil.getImage("jpg-exif-long-orientation.jpg");
+        ImageReader reader = new ImageReaderFactory()
+                .newImageReader(Format.get("jpg"), fixture);
+        try {
+            Metadata metadata = reader.getMetadata(0);
+            assertEquals(Orientation.ROTATE_0, metadata.getOrientation());
+        } finally {
+            reader.dispose();
+        }
+    }
+
+    @Test
     void testGetOrientationWithOnlyXMPOrientation() throws Exception {
         Path fixture = TestUtil.getImage("jpg-xmp-orientation-90.jpg");
         ImageReader reader = new ImageReaderFactory()
diff --git a/src/test/java/edu/illinois/library/cantaloupe/image/exif/DirectoryTest.java b/src/test/java/edu/illinois/library/cantaloupe/image/exif/DirectoryTest.java
index 6a740e2d6..be13f18ff 100644
--- a/src/test/java/edu/illinois/library/cantaloupe/image/exif/DirectoryTest.java
+++ b/src/test/java/edu/illinois/library/cantaloupe/image/exif/DirectoryTest.java
@@ -366,15 +366,15 @@ void testGetValueWithoutMatchingValue() {
         assertNull(ifd.getValue(Tag.MAKE));
     }
 
-  @Test
-  void testGetField() {
-    final Directory ifd = new Directory(TagSet.BASELINE_TIFF);
-    ifd.put(Tag.MAKE, DataType.ASCII, "Cats");
-    Field field = ifd.getField(Tag.MAKE);
-    assertEquals(DataType.ASCII, field.getDataType());
-  }
-
-  @Test
+    @Test
+    void testGetField() {
+        final Directory ifd = new Directory(TagSet.BASELINE_TIFF);
+        ifd.put(Tag.MAKE, DataType.ASCII, "Cats");
+        Field field = ifd.getField(Tag.MAKE);
+        assertEquals(DataType.ASCII, field.getDataType());
+    }
+
+    @Test
     void testHashCodeWithEqualInstances() {
         final Directory subIFD1 = new Directory(TagSet.EXIF);
         subIFD1.put(Tag.EXPOSURE_TIME, DataType.RATIONAL, new Rational(1, 160));

From 2cc413d782923d7f2c77bc7059f69b30b6086a5d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jan=20H=C3=B8ydahl?= <janhoy@users.noreply.github.com>
Date: Wed, 2 Oct 2024 17:45:48 +0200
Subject: [PATCH 5/5] Add extra comments about data types

---
 .../java/edu/illinois/library/cantaloupe/image/Metadata.java    | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/main/java/edu/illinois/library/cantaloupe/image/Metadata.java b/src/main/java/edu/illinois/library/cantaloupe/image/Metadata.java
index 02c9bd5c0..4c5809bce 100644
--- a/src/main/java/edu/illinois/library/cantaloupe/image/Metadata.java
+++ b/src/main/java/edu/illinois/library/cantaloupe/image/Metadata.java
@@ -141,6 +141,8 @@ private void readOrientationFromEXIF() {
                     // According to spec the orientation must be an unsigned short (16 bit)
                     // However, we have seen exif data in the wild with LONG and SLONG types
                     // Thus to be lenient we accept either and convert to int (github issue #548)
+                    // It could also happen that 'value' is in fact a Java Integer even if the
+                    // exif data type is LONG or SLONG, so we need to check for that as well.
                     if (value instanceof Long) {
                         orientation = Orientation.forEXIFOrientation(Math.toIntExact((long) value));
                     } else if (value instanceof Integer) {