From b7db218d929652199c8bbd8c643c6fb931ad728a Mon Sep 17 00:00:00 2001
From: Lex Neva <github@lexneva.name>
Date: Sat, 23 Sep 2017 01:07:21 +0100
Subject: [PATCH] remove notes about autofill hole hacks

---
 README.md                        |  24 +---------
 images/autofill_hole_example.svg |  77 -------------------------------
 images/autofill_with_holes.png   | Bin 7327 -> 0 bytes
 3 files changed, 2 insertions(+), 99 deletions(-)
 delete mode 100644 images/autofill_hole_example.svg
 delete mode 100644 images/autofill_with_holes.png

diff --git a/README.md b/README.md
index 6aa92fb5d..8f82748df 100644
--- a/README.md
+++ b/README.md
@@ -98,30 +98,10 @@ Another issue is that Inkscape has a memory leak related to extensions.  The mor
 
 ### AutoFill
 
-AutoFill is the default method for generating fill stitching.  To use it, create a closed path in Inskcape and add a fill color.
+AutoFill is the default method for generating fill stitching.  To use it, create a closed path in Inskcape and add a fill color.  This algorithm works for complex shapes with or without holes.
 
-inkscape-embroidery will break the shape up into sections that it can embroider at once using back-and-forth rows of stitches.  It then adds straight-stitching between sections until it's filled in the entire design.  The staggered pattern of stitches is continued seamlessly between sections, so the end result doesn't appear to have any breaks.  When moving from one section to the next, it generates running stitching along the outside edge of the shape.
+inkscape-embroidery will break the shape up into sections that it can embroider at once using back-and-forth rows of stitches.  It then adds straight-stitching between sections until it's filled in the entire design.  The staggered pattern of stitches is continued seamlessly between sections, so the end result doesn't appear to have any breaks.  When moving from one section to the next, it generates running stitching along the border of the shape.
 
-This algorithm works great for simple shapes, convex or concave.  However, it doesn't work for shapes with holes, because the stitching could get "stuck" on the edge of a hole and be unable to reach any remaining section.  For this reason, AutoFill rejects regions with holes in them.
-
-So what do you do if your shape does have holes?  You have two choices: use manually-routed fill (described below), or break the shape up into one or more shapes without holes.
-
-Here's an example of converting a region with a hole into a region without:
-![breaking auto-fill regions with holes](images/autofill_with_holes.png)
-
-An SVG version is available in `images/autofill_hole_example.svg` for you to test out.
-
-Note the thin line drawn from the hole to the edge.  In fact, this is a very thin strip missing from the shape -- thinner than the spacing between the rows of stitches.  This allows the autofill system to travel into and out of the center of the shape if necessary to get from section to section.
-
-Note that I've drawn the gap at exactly the same angle as the fill.  When the autofill system sees that it is traveling in the same direction as the fill, **it places stitches correctly to match the fill pattern**.  This means that the gap will be virtually undetectable because the travel stitches will be hidden in the fill.  This may double- or triple-up one of the fill rows, but it's really hard to tell unless you look very closely.
-
-To easily create a gap like this, follow these steps:
-
-1. Draw a line with the pencil tool that is parallel to your fill angle.  For an angle that's a multiple of 45 degrees, hold control while drawing the line to snap the angle.
-1. Make sure your line goes from outside the fill area to inside the hole. 
-1. Set the stroke width to 0.1 pixels.
-1. Path -> Stroke to Path
-1. Select the new path and your fill region together and do Path -> Difference (control-minus).
 
 #### AutoFill parameters
 
diff --git a/images/autofill_hole_example.svg b/images/autofill_hole_example.svg
deleted file mode 100644
index 336daf679..000000000
--- a/images/autofill_hole_example.svg
+++ /dev/null
@@ -1,77 +0,0 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!-- Created with Inkscape (http://www.inkscape.org/) -->
-
-<svg
-   xmlns:dc="http://purl.org/dc/elements/1.1/"
-   xmlns:cc="http://creativecommons.org/ns#"
-   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
-   xmlns:svg="http://www.w3.org/2000/svg"
-   xmlns="http://www.w3.org/2000/svg"
-   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
-   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
-   width="1000"
-   height="1000"
-   viewBox="0 0 999.99999 999.99999"
-   id="svg8375"
-   version="1.1"
-   inkscape:version="0.91+devel r"
-   sodipodi:docname="fill_hole_test.svg">
-  <sodipodi:namedview
-     showguides="false"
-     inkscape:snap-global="false"
-     id="base"
-     pagecolor="#ffffff"
-     bordercolor="#666666"
-     borderopacity="1.0"
-     inkscape:pageopacity="0.0"
-     inkscape:pageshadow="2"
-     inkscape:zoom="0.7"
-     inkscape:cx="468.45776"
-     inkscape:cy="536.24327"
-     inkscape:document-units="px"
-     inkscape:current-layer="svg8375"
-     showgrid="false"
-     units="px"
-     inkscape:window-width="1366"
-     inkscape:window-height="705"
-     inkscape:window-x="-4"
-     inkscape:window-y="-4"
-     inkscape:window-maximized="1" />
-  <defs
-     id="defs8377" />
-  <metadata
-     id="metadata8380">
-    <rdf:RDF>
-      <cc:Work
-         rdf:about="">
-        <dc:format>image/svg+xml</dc:format>
-        <dc:type
-           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
-        <dc:title></dc:title>
-      </cc:Work>
-    </rdf:RDF>
-  </metadata>
-  <g
-     transform="translate(0,-52.362271)"
-     id="layer1"
-     inkscape:groupmode="layer"
-     inkscape:label="Layer 1">
-    <path
-       embroider_flip="false"
-       embroider_angle="0"
-       sodipodi:nodetypes="ccccccscccccccsccccccccccc"
-       inkscape:connector-curvature="0"
-       d="m 414.90565,693.75697 c -6.5866,20.30142 15.21664,49.37053 44.57587,52.0303 45.44418,8.51926 23.68134,10.31142 70.19909,15.5613 27.00355,7.96974 63.40857,-0.89056 70.47442,-31.65165 19.06371,-19.4564 6.3559,-23.21007 -15.77354,-50.43359 -25.27364,-19.92334 4.88868,39.08324 -25.52808,35.42564 -12.65191,-0.24114 -48.93148,7.24395 -61.76545,7.50181 -8.17255,0.1642 -14.77902,-58.59734 -37.38799,-55.83935 -22.60896,2.75798 -34.41447,-3.39812 -44.61575,27.25253 l -140.24492,-0.008 c 3.63842,-35.17072 14.75399,-69.76994 14.85157,-87.53594 l 3.12805,-32.91829 c 4.41043,-22.01287 21.67084,-9.66993 42.99708,-7.86081 30.64108,-4.8033 61.35018,-6.93231 92.35657,-5.95846 23.17821,0.32264 46.99947,-1.47767 70.41305,-0.50455 16.9103,0.70283 33.60794,2.85238 49.69706,8.29335 34.7607,13.40607 72.10758,1.7815 107.61777,9.46979 21.71457,8.56118 49.58446,13.3113 63.84245,33.12969 9.64206,38.43081 -23.11024,71.4676 -23.23456,109.20592 3.79524,28.37642 -2.66541,56.15236 -6.20726,84.14589 6.91104,29.48759 -11.37684,58.7607 -44.77434,50.89406 -82.68536,-13.30843 -149.52668,-65.52565 -233.27987,-62.68255 -33.26856,3.94593 -78.41763,30.92651 -106.60905,16.90432 -36.17407,-4.34864 -36.41922,-41.07773 -29.93402,-68.73791 -2.75654,-15.37135 -2.60739,-30.5701 -1.04307,-45.6915 z"
-       style="fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
-       id="path4418-8"
-       embroider_auto_fill="True"
-       embroider_row_spacing_mm="0.25"
-       embroider_running_stitch_length_mm="1.2"
-       embroider_staggers="4"
-       embroider_max_stitch_length_mm="2.5"
-       embroider_fill_underlay_max_stitch_length_mm=""
-       embroider_fill_underlay_angle=""
-       embroider_fill_underlay_row_spacing_mm=""
-       embroider_fill_underlay="True" />
-  </g>
-</svg>
diff --git a/images/autofill_with_holes.png b/images/autofill_with_holes.png
deleted file mode 100644
index 3ec4d0cf2c739650dc40e49f54854553d49fa62f..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 7327
zcmZu$XE@wXv|hb;iKwdw5u!%@iMqO|ArYbkNz~}FMD+gCBM4y$QKOd-f><@N61`i!
zuD*+K_kTa#5BI}7@0@qeoH=u*JkQLDeP{@yp=6_kKp-?a+8QPh2q6f85OkB{3COe9
z>brO#c2+e|g+OXRs!KZ(yv*&OZDIg{1PMYQp%D<sIi3pLfIxijK_FYtAP|Kt2!zEm
zx7An)-#}=u2h)IDM}tEhc!|P8OUoONz4%fNdFUdhiLa3P=on~{EmAQvNfUhX%d7iO
z&(BlU83G}(fIx^Kko-4DP6&j3K}SQ?EMR)~V<0^7(G}8zk>|AMyGNx-nQm!ez2J{q
zdTz#JTIMpDsUjk}CB|_+73OAfx(W)~Zm}X6cA^dI(Ts1xAD1=K*WNzMvt=%x<v&we
z&s~@Q9SH1qC<Hg4FaG8F=fBDK{%y|(=?kY}fMCfXaAM4VxX1^=Fm%Eoi+rIV1dmXH
z|APP_UWOAx079(GQxireCUJg#evY{K_!%~K_HTkBA}_7}s`vEnC0xk!EIqbo>#A)8
zV`Do6Ibvrx+1YP22*E8TIn}r@^A|ik=+{@{vlz@z`DxdLc4T9-;tmd7{b-(HYhh_A
zKRPm)gHe)SsPxeTy0_Qw;lbMzW#;q9lH^2My8NvZTMXR>RLL)B<?I`iyQ;Wvu)gx!
zfOXKA$_XwhQu-*Gg?;=`_*q(BSO(i=`!#ZD0oq20(zwX_Zntyi`>I=GDllfV!zB3@
zmP$@ScjdpCd(eGe|H`Z(=JIqka)N1>)Cf#M!dkhZzscSQ@q0C8SL;v1bJR5_Xgy-G
zq${2rZD|fyev+CkYoy4oTUDq>Z#%4&w7}~QUF3w8o7MlIPc>Xu(iijYz6$u_yyRf!
zeyzH4rQe6_N0wI}>3=&`0j%~9`M6K|=xmcV=h_N$NTlH_d~H8327jqN@Pk(W_2t=}
z4tCld+MY4#t!c1L*qW-(U6sDPbK{%gR4Of%6<q(-^2^D*@8K*vZMeRUynln|Q|dDl
zhhLjx=!~1)Cg)wVO2?2t>TNTpX>)LMRq=kv7K0<0UzI66p~8=nnOsD&aXk1$Cgjgi
zeOEjslg#`~0+PQHJdL7<aTG6DXAnYPSQ5PGF=-xL&cUFbXLsIO3OI?Y*;(N)2Faeq
zi>0&Hqq22P&gD4DHX@A{%Vu6GAW_IIj0Q{zu8!WpNchusF|-TMxH;uUetx$BzoZVi
zrRvp@yf1oadjBK%bTP^<9rpzDNYSGc8SR-Kd6N`vKByujDq=WwpHl=X{)5b_baLdn
z!4ADHIs@O(w=dh~%gW8_Zi$F)PCmNNe{K*n02=~ybz>zPwl1!QRig6<-j446x;{Pn
z=ivRgaufi59${64)=cXfJ*cktRQ>%5cNGG=Ie@FslqT}L8^J_sT@FmOMW+X^sME*V
zD#k+o7AiOKpLj`<_N6vYY)S>|)xrVV?h#9t>QKvQM}YL1nW({7GVvF<Ya~yN+@83&
zb~+MyTY~%3!;(Hn9k^%`3L>9QZk;3c4(z{0;YqjOnMI8VR*JNPgk=;Rc(M0FE=iz!
zx}#VuCn-cpcaxxIiWDcuzDaaDoid?cvI|)g!zEYp8site2b{w8xF40hHcstDzUB5w
zW@%7S_*?=eCd>6j2id*%J*r_`CdDmJJ=cs91Evi;yGfG?@;|97U}NU2JD<b5O*Jk8
z=!J<Ugin50)c{qn-cZsr!y4Y;ga=)rsl5!WUGN@vu?I#CR$s#4)LP9Ch*s6oBCuGI
zLXvDDMFGuFu#!P^M7tQ{x(AGFRXmU~f*qXJ5UY_;W1-7i4wQ@}`po2pYa3{Ba^`y`
z+prM89hMvVA@ok$e|9_H)o#n-uq3s_9G+Ca7MIa-8WhbVD=b_9?Ste{I)O)?m>Ry<
z#JQeS&(CTk?1^VL-uG|u`FRs0Vdor=P<ye|1h71L<O=#ZKY6psKhb!QjDdSmZ+GDq
zd^YqF;=FZPHHRecAq)6}X?22@@F{nGWHD(tmm^prxH|T6IrgHiB_h04jY1a0(2{q$
zCCWm*<izO1ezO_?ez4aM$lIlHlN>(?c+5st9B7EidOR)S!N?SL`tH{>!2AQ(2lRZ>
z*Z}Gp0@eEQMYKW>DY3C(IN1D+o*b>v4({{FaK}A82K>}sK44}z2FBI#2sOTNIs1<w
zD#fq&Na#HU(~Db)c+57rkRvG|urouP)`+VSbqVS2BK||qk`t5-a{+-@k?DB=VG6;!
z*`i}FR$d~)7L82@ay-hzHXWX5kP;s%7K6_jSn0KSKZ5JYx9I!b6rdB_65OfO3Q+Zw
zTlCth12~LW3^jQXZ!u_2&r07X<pbDg+CSj0+=S1@^n_}+j^bi|f)9k$H{tLbu>>jl
z#YZ(a8Hspf3l9%k+3}Sry;XD&F=@o>4+F>pa_X3#=!dwN_{nz<AER)VwD=y>cui_T
zBDD_&s}9U~oYG%K3lWoQEaz#gI=td1)i41^urA_B_`&9j4iD)6Q&nF@PmoiS3nUF7
z-{EZ*Im%{$iFki?U}|WG?A!QZaV#02BEv2E0WJ}!GtWKlRFf$);QRj?;WoqXI{Xy$
zzQB8INVu87S7w0w13V$lAOgM3i=X{l6fP#MDD+{{2+oormf+oAely@I4(~t|3fIht
z_t~}Rh~W$lNl70rJgT9=2b5K}6kh-Sf#U;i#SOSpSWoDKGWiX7!hZyU;v=Yzk8z)>
zF7yevBzID4#4p$z2}jZ%iFcz&1U|Sc#KoW<KDaO{wN11(zM&>`9CoQd)MG3iI|_@Y
z!>?#S+QV}!l_b&fq}nzgZ7<1k>E@@C1N8{f2#J)D^GU7(0^{au-CYN(B2o=h-pF|X
zp0N`xIrXAZBPtY1Gu(A3HLp7?{abVtin_k^dG<}09!8I#XaGM}rWvMC8p)jOPrb$V
zv<%vx*}^>`xqM>vBC`ykGr~bob7-td;x{mh>)_v>>4fAFc39eBiD@KSF(hIdsS$}T
zWu(8EqixOa=0iZ<^I`QEa5tBU*Fv8$DV$nFt6B@cSKUXm=n5L&!`v%ae|bl)Cyich
z9}#!<i<#X&)`fTXhIS7)yWn()G5*nR-7ZdF>F5)oHH+ap1{Bg2vkT3b?YM`bTnF|o
zq)?;sn_YDj5wS(*^s#g;SF&mEK~!Ai2=L+FYsSG<+`ViUj92YrR-Zxcp^EOOOiF#*
zZi4<$qKtu0%4D1r6q#iuyn@P=KR}m*npj<hbHSsLlp>krlH$1S+P?kxAvy6@>v%9}
znR3(eiesre<VA?QXuyuU=JgwtYq+tPdOWz!Jc<ftTKXwu6?A^|%nGTN*6x%j_!vH0
znhgG!_2Czm5!ie&5uP1#f2^ysZNcgF$$_`84_qWNAFS06zY&N{wLu<-t+6J)j}?TH
z2_q0l!!9Nj;p~@(6NRT)>(gZ(^*C&;B#^XR#)q3ykNVuIVlwu<OOQ1&Rd^a+@hL9p
zx%=Ts%JKVxa#hfxVV2+fL{%dVY|6k1+Y35#_D`uX`kY`1)zWsp&r}X0iOM!Cl|MFt
zD^Dq=&o^qyII2I`$!#&Y0V3WWcKrUF{hH$F8A@Nt8_%O`|9*aPd?2Oi<N9oUA3=R*
zUB$;_oCN0||Hfu~1FaZ`#X<=bQknLm&Sbi*o?gTa0335MTF~pyQAy^Knpo{t_W8+g
zhTCzO_F^J*7Ozffve^JbhC;rnR{;)0xh%4_drKI@i4BL=gM4izq1R6nz#fdIjK_+}
z<b??cds~P?I=ockBBLBdVQp)^t(#=cVXGMfzZ#c=Dk24l8DnE$dYf%F`>lIM@ptb1
zfb`$vTWCT7_%UDCy>m>GQ;UV)s?H0f!!6VnS|tM`p_U8Yr^$Q#<^7u%6sylU!Kc~5
zJ0)RBn(nbjs15TQ=0`$z4M&4*#yGQs(;ZTveAN_xQ+6a8@9($0oLLlJ4M^b04z8#S
z1GhEKwb@vwbDZ-UG<91Pwm&&RIi0NLKCrCTMx47~{(8?38>DzDl`#whHWo_<a@M6u
zD~&blZgaoBwJsedA|LJoy%*W}pUHmWwNumJHwPw(ijKV6{h&x8Ou!DeC9HOC<TPZs
zq?LLqiA*&6^BgjS5-X=y53UIF%_!#C`s)1dm*JX=@q;P~EuxK=fDn7fH@N(;5Y;M~
z$5gCvSAO%`*+NV7duS^@XY-_0+XaRXv?g91J&TAyzxV69cX;#0Nl*O;BF`HKzA_zh
z{bt$)rdM+pO6-$q0Wrz19e=8rvCzP^pDK2kgEE|Ny}{@YWD#%g$@(-!*rDs-%<v-G
zjs%|Y_XlirruizwyHd?6$xbBi=OX$h3H(x(4oYJ!xVLPWpsypl)&j8a^dQG5vCUR=
zP$@n3vApQ=i-GFF8l^L-n^2ZJi)dP9xb&W5=xed}0UB{{Do?*+<(PohzMF{YSBpW3
zuLJ`6PX`<i4jf4EM=BnqMTqh4=^C$)^@3VdUCZcuByj7>crYqaW|*hkYM2I^c=iFl
zQyvQ1ZlV#!>x^Qbgb(YRP>6%OY2astY895NFCbWyC$Y;}D027&0YfvVfg&7&V@9{3
zx7kLYQVci{)6C~T8v3<@I9Rwp8K`<2`c`6Pw}I+;1~Q?YzKGTCu%>_zxY@AHU&OPX
z23LPlTyy7&>?_U^MgVoY?R)6eNYH*mx2W>aLYNO}FPH=Ba$MaiNCP|AJ%6r2&LxrT
z@;BM1;G*SWpvUG4f*?mxNm}VboVDe%%)4QjKowinm-pbHkB3`Krlca<eP%9JS3uXh
zUy2Flb0{(VWdC~9{gv>M9$KrA&F;uJ@mq`F_DLx9XjAp_8)@^vuI3b%;SB_%LhJYN
zm<-O=M)QF9Mv>iKx2k~fVOTU9&{`{yP8akG9Gmlq61g7G#s);wog7N&H)Xb|{0(V>
zOLddlOXh%nn(&I$$~5rNNz2Gr%L{RLDYMO2lMh6n9Z5W4fVwSgo`mio+kHUY;Z|DK
z`@VK&`mU}!ahg(}?<U1MDE%I7PLwWRLPP8S4kCkRb*p9-?m3>8&9Purrlk^ce$I5Q
zIb@0et=}m=-dNjrBH8x2r645;7+A+%B(g_6bp;q@#Nr1F5H^6=n02A^t|4Fd{f{>~
z*fwo@X}SrtpfpOPJw<eVt~6=FH*A8OUk=6Ue-z=ro4`&|hM@b1wVeJ;xqHm!md!~Z
z0Jo+3=V!}^%0Q4N5e~nmbOtOedSO5OLzFs~25M)+jQsyS`;n>FL!O}2w=QQ;U<ik+
zaYDDZP6DxS19!<it5JS^>)TAn*>t{LntWi`Y|jQ-Y76U<Q!o*u_|{fv;;>Tq4s9_5
zB5<Zp;?rZc-5#VMCC+lE!bbgSzMHOR;O+%n?(IL6S+{1JUT%S@V7}z}q%IHi=fcIo
z?eaJ0{`-pjK6?YZ6s#H|lI-jX#6+yYJ4LBrt6Nb@R%~w)WK8;N;d-&sacr>3jmrAk
zKa+D4jn1sW998LH<4vownBv6v8`NB(qX~fF!$H`Sm}1`{=}X_vk4}Yyv7k5e5o%ZQ
z`O0V~J(_HhEeE_d9)dlIbr_h`944eVEWwfP_aJG?a4zM6Q)LQTgI@zbI9bIrLC<tX
z2%R6_x@L;yaXn4t3C<pTl#2~eRff7L*JXGmgayCmkg1IrM!J&hiNh1V`#l%+{$RSg
z+7}|50~WP%xM5b6w{h4Ce$*dp!ObCLrpUPq`^v+gQY<NJZ&-%y_I|;4?&|Tu1CjR7
zDceEDOR@w&*E2kcem>cCF7cVodx5ip1mIU@F~dCe_Lt>sDn}jfDp53U$uXl0m}bjs
zN&?wean|<72g$X-^nj~{W)pl<++ahQHCX@X;Un$eEjLjTb?MR{{Oym8i#emfKgz}o
z=tDu>ydK56^GV}88{&umZr{OTQ`LYZvuW6qcga4hzDm3(VT|;|jQojll%}`ZmySoi
zP%^!A**b8>><qQW6=42?^X;9ARPa&y8OrHS-GkM9y66FBnL4mUbP+Lps$XBLV3Tam
zxfg6>cj6T*0I#3Q_ApcLKnCcQWm&CvuLez1726fXQ6bOzeS5rYEui^L383su+Mg<6
z`=$Iz0Y!!#PA%vks{S$XSsUSX`MA1CBhB%T1YoZ*J;}dR4*p)jW9D|eZswkg7F4Av
z7nDz@u@2It;H-PnchgM>0lu?1KA`nouz`0Tzv@#-5gQjy0Ay>+Kz~fd!mH!l2Bg8o
z!M||$1ewI1|8VAJlORH9ja}~5H;VU9b5k&lnI4mHB_3NC>C(w%CnoswIi!OJ{hS!(
z3RFeJ(3yU+dFa@tbL#Gl?ax}YkcFBng6U+>6$~dmO@lahm5ZtOxpTnwPx+>^-dyP&
z0~HRZIj>3mGl!Aq55@iSwxEH=CY*IP8Patcg3w))O7ql|^X>_O!4ij;_pMYO?dStG
z5uP~Hufsn5dkih3*5efe^ny_TPT7f4sh8iB>ei5}a|mm280k^$rr&jaOysa)$;P~U
z*F#&p4kt&Ejd~~_&~e})$-}to9-Ls~3XuMg&}AFO4nO1sWiu4=cwB+T@MnJm>TMk-
zMZ7P3`fqFW*5NG4f?gDaF0|=sZ8Y0XpKV<XJwGze^R5|+dQ;ANpfD2<9CPW6s<b~u
zi7lMVOBomZ?n1QQ{jU8{WNE7wIXS$7_Lch?=YIiCY+|C)aOO8md%W`cVXtxxc=Bqm
z_;^oC;_41g6Ux@eyOiVmk;)Ha(UyNNFEF?qlD73+E{E)D+zs+HP^FW1FFl|NNoIS6
z)f23y+uEQNJWt&pTtk@u+LH(+l=(N$))DYW__Le*X=V5jhVdx$mn$&f*ZeN5*&JRl
zQ5p!7>C0mLXGl`#tC%&6w8CiKE<3(Hdl8p1FfGx)kf5ld;&9}}rh!U{Qx>dJO4(;D
z*fAZ{s!!czW_}cFe{>+FU3fn-?~U8&p&K$+blXU!PJp-Gh|jcoa$#@{?TEF@dT$O_
zBqb(3rWsfo4sE>qlI2lBdATcK-*jhD#|wX>3-J<jyy)D(KfcN3MoE6dxEb(U*Zw;h
z#!(Of+VZG%ri>*3V(Jm0d}OS_J?C7VX*mhNRRlSKiY|i|l#Wlm6YQ-3^3<b3p#&9x
z)3dici%2;OXzb=qIALt;vs2@}?q{JblRtJ4xz2?|-mgDQA#2DPFopbfrw8ms<N>Jk
zIb^#wo}l{%_8;bFkqoH`eFHUm?_fgZt-5|7o9Ou#d$?$UU+M{=OtBpBo;b?RSjmWR
zkoMA^96OR54Hn%GBevcc{E4h);9u-2v4*!<Ky(PXG`tQ{+9LP~=x7fQ4!rp(<Q6lB
zkjTNjKE|)68JL3<AI;2AP8AzKi%+lf*E1WyY4FXA(mgt<0GzfHpMK}i*(_XNI9!_G
z&g~YQwji%TXN>br6{zX3m%mVQmO?~6xT2R9^>Aa;a6d9Ka+r#a&h}PDcP$2EWoPH0
zHcuCX_!IxzOqkTb2O(tytz*lo{6|P*OLuXlAM(Dy`Kf%1fAGr6BG=tAmM}>**8V@R
z+8KQ^oY|g)?-NSjqepZemKeKg!OtzN6OKdcTYRi9ld9TnI9isK?06;Iap?qZ1Kr%;
zdk#+yPEAMscThh1t|Ci68}1%OwI#%gx#zBJ^T~6cwFmk}Rp|3ywzO@=H|2MSG5Xc(
zpRH^ndK78&h(!S-;?zcGt|G@G*`-}RR{rM*qr}N{9UpGkK#1>RhQ;*JnZ(77sqAAH
zR=<c19TV45;cC_UdH%QyZTAjt(`W(PcwJu7<nIn!cb@ay68J-c)lQx18@1W&%<{44
zrdT4#DlOu990BtGw2hiCBSShdbk`uG$pX}+Sz=k1`E;nHTWg%v>2B>W2iN);zD)er
zDYlr&+Y3{3Vh!Le`sT4A5$M=<Eg&e{tPn96t*em^t{`=L>sO}SuRKQk13>Hxw;C=!
z@yD@8Dc1YNZ&ftkh_>*QC;01FDSl0bbM>jIyaO0(+sdkj)Av|DiZmtod+q!y<@xJ9
zpiuy%{=GMsS!+QP*DoEOa3;q-Pmw<hN@-Pq5xMLZ8qu;_;N1GX*cdwP$MaNFzo9>j
zOjBjE-(n9fp#^sX&WCmHeT+X-Q5h!=Qtyh!j2~Opp#Gs>=*`4FmbKYBd47MG+h)(P
z0vbA&Mkn`0K%M=h!^{0M^g7bg2%JuJb7$R8ZGS<Y`C-AK7y#BhrCvT%5Aj}kZu8W~
zkc4Ib4yz)h!+XIl)g72$8vp$DYWPFAIQDQQ*e}wtO>eFByTFoz?OoK=WNOD@@hM4p
z-mn%tUld`er2S;>Tj|eW_&fwkQB!^L2NPvl_%GtRxX+p4QR;i2ug6{SaZy<O@92x~
z(!S$c|9%n(*w`GdAMQAfpP<4oLc}KIWtw1{mv@eX_D){pcv!0cyvU`lbTj8^*lDiw
zqM8qRw)Azp1)g{Y?@|$R9TtvPx&eKDHZnTSc))c*eR3c+LEAHQ6@Z-~aQo-IG3EcT
zuSfIM+0(D3F>h197uJz<=)MN>2{9`{0S@K3W=cTU0In^shr2}p6}atS&O*f*B*6j<
z7}+;ho5OR7pa!b&7@2YFPFP)X%ja?uplJya+pN@3wFQKbKn*mllc#eyGP_`DDa^t@
zUr2|Icq+5NrL*(HGoH48BLT8gj!O->bk74gfb8@mI~nHVgPU;ayQh<oF{e;nmwp03
zx4ZcFUxkV`F1WO!mnx-O>n1I9*vKS6&m7J{1<hF0j$y;!Cq&R2JZ?Jd_mA+Or9fGC
z%e}gM@~38hNQg1U7DE8hUoF!KjIn(PmDGWa)zW$j;Xg0e;6D{o53VCY-Pd<U7ZSwp
zM>c%CriB`G9*n&Fd{h(OXt9J4?h9-Yb`gViM1U{TZe8WZ`W!b?Lo;rRO-hpy;9j{h
z0NHVW1w!^dW4svP_2kZKullMTC@RUI-7qFb7SW5ic%H{k!okn{cgyOAR0Lc9Q9~=W
z>;v>(toJLr>`?;QS#@?s1Dj}BtcwB1%=|&75psN*Jq&cZt*q6W?;a8cW@^<|rz*2P
zeh0qve7!7HyJ5M(3@47@pvXWIcNke_hk_yu(3h7~{vUm?<a_8znc2yPR1!bQF*@iN
zAMm#`{E^_-F<R&i^V&QKg+`~gI2xdAAccbFWTNI!v$t#s(UnWHU$k!)xYS-D&<$&7
zsi|*ja#skdu&ZJLM2t>P>4WDzX208u-vl0qMPLjgBevy0^#Tk^gda&=CG4~8MF5H{
zAu{BEy7u?nobf%LU+96y3H1i(Y!>=^sJa}ZKnyC39~p%`oRgh7XDk_AL}<3u!k;PI
z#0x5`{8}@=39rAWQ&Vuo@!d#v5?RfUb@3W)G}!BtcGy#vNpq0LFwnobT=vhOkX6}~
zKNguVS>$Whvw%B#>gfu{lU@(BP-4lscvnkWh@PZ-qI!c&tG&e`Kp0YvQ+abN2&Zo{
z&d~_#fzm+Vc}t#(v(5g+t@{^O{Yj!cH(lcE3m@t(FQM5Q+0n`WRy``i=8JzXt+jQk
s&;x`Y@X50OlO+3pvTBgGtJehN@@3~c?F8TO`9Fw`rlCfa+Ox3#0W`55DgXcg