From ad99d3050e8e7c36bf06ba9ef1dcda70d1d84d89 Mon Sep 17 00:00:00 2001 From: Akos Horvath Date: Wed, 17 May 2023 17:45:47 +0200 Subject: [PATCH] inital commit --- .gitignore | 3 + Makefile | 25 + assets/image.png | Bin 0 -> 404846 bytes gaussian_blur_kernel.cl | 40 + image.c | 5 + main.c | 17 + opencl.c | 298 ++ opencl.h | 49 + sobel_kernel.cl | 39 + stb/stb_image.h | 7987 +++++++++++++++++++++++++++++++++++++++ stb/stb_image_write.h | 1724 +++++++++ template_kernel.cl | 40 + utils.c | 210 + utils.h | 61 + 14 files changed, 10498 insertions(+) create mode 100644 .gitignore create mode 100644 Makefile create mode 100644 assets/image.png create mode 100644 gaussian_blur_kernel.cl create mode 100644 image.c create mode 100644 main.c create mode 100644 opencl.c create mode 100644 opencl.h create mode 100644 sobel_kernel.cl create mode 100644 stb/stb_image.h create mode 100644 stb/stb_image_write.h create mode 100644 template_kernel.cl create mode 100644 utils.c create mode 100644 utils.h diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..042a5f0 --- /dev/null +++ b/.gitignore @@ -0,0 +1,3 @@ +obj/* +image_blurred.bmp +main diff --git a/Makefile b/Makefile new file mode 100644 index 0000000..8eddc17 --- /dev/null +++ b/Makefile @@ -0,0 +1,25 @@ +CC=gcc +EXT=.c +FLAGS=-O0 -g +DEPFLAGS=-MD -MP +LIBS=-lOpenCL -lSDL2 -lm +EXEC_NAME=main + +OBJDIR=obj + +SRC=$(wildcard *$(EXT)) +OBJS=$(patsubst %,$(OBJDIR)/%.o, $(basename $(SRC))) + +$(shell mkdir -p $(dir $(OBJS)) > /dev/null) + +$(EXEC_NAME): $(OBJS) + $(CC) $(FLAGS) $(LIBS) $^ -o $(EXEC_NAME) + +$(OBJDIR)/%.o: %$(EXT) + $(CC) $(FLAGS) $(DEPFLAGS) -c -o $@ $< + +.PHONY: clean +clean: + rm -rf $(OBJDIR) + +-include $(SRC:$(EXT)=.d) diff --git a/assets/image.png b/assets/image.png new file mode 100644 index 0000000000000000000000000000000000000000..9f589c5b5acfb3ab6808431bda4796fc741bca7b GIT binary patch literal 404846 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

AGKelU!GKC3P_+qN>(u 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�r8B8={`avX^$ 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�dk5RdsG_>`YB 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%0Afk1>0Zq%;$W7&V;;h6aQN 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%0D>8yXQm$I| zm;J--teVFu&tsm)u-Iyz!8AnN1c(lZbqO$kDH?VLu*Skg>$4xn zrteeRMrL^R!#E7*K2P)KAAX#MewrpnC~7%pb{5uQ(o%FT5E0^W%X3POjBjOwUY%vv zf3OZLueQl;PUvOnhl_S(C5B!>Sg#VVD;T-*IM>WDyo8<+A`>TRng#%-v5y^KeRxeH zUDy2F25-Iu`P4xYuItc-n7iSl)SlcmzIe-Wzv{7FwGFlr=3Beb>u=e9MXxO0ZhGsJA#6f!_YyC+>n@QDGsKD8a$kc zSWzToqQsJf5;I%ZrMBIB@zZfEIhPVinuLhz3`VY|a~1$lY}+=@0I~WJW4DvL+xGEc zf4E6z9Gz7_R9zQ_XXs`K=^VPdK~lOKq`MmlksP`khDJiV8|iKY1PMt2K}u2({LlCA zi@BVunRE79>v^Abom|xaaxMAq8Hil9xE-95sY5l{nUv={^o;vyc_;>65qxW8ihefG&p z_Z48{BF@baH!Xmy?vCVp_T6i8T|a={AG#)Oehnr9e7z zjH>J$#WbxuSW;*%gq6&)KI&`yUlz{xUsnB|?x|mk2mMDD?;gHbhIr?}=Pu55PI@=q zrzPZ2#x)X%Rz>Me6_B9QyYAaioRJewd=BZ7aU|FuVei7`cP%~vytSphd1*Q<=R)yYXd2y#V zE^pb8-VASfH`P)ZC7oZPdVPHn&-!!CuVxFsI6v>Mciu2vYJ?z`gzpCygdy9md843I z5MH@T%f!)GdUK`Ed3(Om$$1PCy?b_?3TWSRI>ew^X#BMSv>W{3(~{3u^Oc^uEx7%E zX75A(WDET}qrRaI<{C(BJy@oGLXiA!2u^b(Vf(J4cimgNN+kN$c=PT&sp8n~L}1M8 z8>&aoso9P~{JD~1iwH92sNytt;?JPI{(jjYBwd5LTwT@!44Z54}-)0R9;eTspk7PCMsM(#ish*B& z)rB>tfqb$w`J?Z8 zl!{y6$z=>FFqb}du+C)qdj${-nPL-(61-l|(^4w0NYCQy+OkoZRX%CDO7He~UDlPb z|EUGc$n8f{^Xo4our{vuv&yap?D5A&Nt(ivBI9Z&}?s!QB4q@cuqb2t#)k4{y;uL zJV{9P2wAP#Wkt>lE7fmXqJ===&ztGM$}0M86M16IO{kR#S5Hx9B72=ncwDc^pN?i3 z5vP_w@cX*YfqV);E|hor4tmGn+w?<%o2LynS;AxM%R9P!mZOLtTkO-k?H9fAT+;QY z=HlgS9|%zP{ky!{-#w>-6NQ(po`EK2P=Rn9-77qNr{4!SCYUz^+s=(0`dE~9goyL&+pHI)TiFATh&R^!1D*|AGx6i_Jd^W8nCh?i2U7?XIpjpaZcmt$$ z?{3zMlZ`{fZEu3bt4yf72Zr~9LP8ypS)X3xd17Du-TEQ#{II_`)ir-lPuPXKo1QPT zZGJNwZ(J$Kj_^^f@eJiiDh32x%DwCR@8_+Ae`Z*Vz=u8@&W&Ia;jZ*2vai1zW;mY$ zcyu{-hI*Qf>74bB*xvFt)9l)Z((ba$3-JqGrdZ0QaFc$mcQ8pT&rspJ>plu{j-DKkvhQtW!^2?cQTeIAFav_r2!&-q3kluR7c)_!ly`h@Hx_o;!_2 zyczz(zR`mgZE!Z#1HGY&M+BBxPA*9A<3ay6N0TZH1yZ*|3^kD>+~Y7 z7C`kRuC543 zY{LuSu>6xqs55T_14Wjn+K|o=vRPn=yY!5->HReHT`(a3`VR5CNfIqq(*By@0%Ddt zze{qi^o+mjpAX)1O(ydGx7ol#vEw z7}21DuyOPpW3;2HS9MA{G9xgg!UbqnDj3Ec#;vtVd3S%`fqQX5MSZay5*P$1y0%=O zcJ2I*zs$O}Y|A=ve&)7P;6|mf@B`WKf+FOi8TJSVP1L6Iy_+1xlb85!p09jPG@h#@ z?<=o`H2{=@Ji5!NHVT+e%)#4`3L%={gf&CCG=4SK(J7O$fVkdb#T_MZ2*7(O0KIHGdPNl7tE8wG2dj* z&KeQkOnm!oGloJDoBj7IW=^)X`db5|EqDEH1Bb5FOmlX;5?qLT3u28(d^vdVQpA8R>HSpV`9ixr8?YPbL^=1Q_e|I5n@1q;O0}HQzt`%u$FzJ2h{QU10(31w; zU%d-qGcw&;&QwYv5Grgt=!(;!pcshVcd^GCY-0(!GLO*4jFh?6Ffs9a>%AD4*ZDB{ zbs8G{rc?Pl;gow;8AGK_qD`F;y}QdB_gb=kG})s|QqI*+D}&dV78i$EAB!O^WG-~H(aBEd+ zp<~}e9|&D@g)}7;&o*(17jbuvP>S|#Q|VC?wfa%;$^86yFxmV#&=mC)E>f43#N8J@ zIs({$!)xxOeZyw=PE-rDm^hoLse@%2fkPu~3baU_jdq~w+{{YiPS}T!YdU}HnEQP@ za>gKcSWc)DZ-K(ce4dd)8A~6*iOFAiFH^#cYjx)AxpQ}Zn_~jgYVv! zJLjErX4d9_-F}boy3|(4?|b=&_kL_?>nMIbn?;N|9*CCs>QLs4&1Zjczz2|Dxo9*c z9{l&_C)dm4w)pG67ow^?hbi6s5zh}dwuOuqWWRG_24|ATZx9xjAzk2&EgG(XHT;CeF9NosWm^RI_V`QF1b}-m*XzQ3Wj=LB;7kWI_U(FL1 zKgH_>VwXvqd0@ag_gX(6pNe#p@GyB#ys|bEp}oB%D{lv*^Wx=^XE<_tYawFYmWLAy zfxY|^4JG1wv3-y#y$YZBrO9>|%JZVSWqU5Prxh*qrn8ZBB4TqX@n((!j)5xj$j4&i8^F0fX*5z}EgTR0!PWWNIFaiwJmz52tn-2QrZD5{nMB$Ws%(k0iOemHf!6andmU_^2qowTKO7*!zNq-dT5wDU`3xHaWB0<=DN^6OBv# z8n_|-r>UbogI>G^{r&I#17DY-fycs;c|!aQJnGZ~8)K|5A@Qj+EN1FidIaid?TlW+dW+52GW#g`*1GVh^A5UeE$zFG zY2Fr2gd5rabE>Ltc%KG`SM%7Jf`leY5rQE`gHW@okr;bRX3)|p?xbKHut)I~eSn1N zBWW$&?^VXFv-9^W{brL6eF?19wJtv~OekmuLgNN@`D5A5K@5Z=Q=Re_^fl;*XqbLm z3+UFi@hybl(kfC!-8Ckj2mN+1N~YzUza!$;CYrCq(@k5vL731*lJh))z~@&@OqKZ_qS6U|uaz5*i~(0GFo@Ar~IzqAn=3e=DZaXfD( zzfSz1rM5}o=KjvryVKDf=j>%cSxZ`O$Oh$bG>$KeQG_qG1u;v+SxYxNqfCjmt{%0! z6eC~Ts>Fm{z6=Yf4)ou&d2IaPjl?Loi{Z)3{>9VvrUC+klNYm*qtg=PeKYaOA1$lu z`gWsTeH7)o5g-xgUm)y~;_vKW&>MTA8WaOMa!}_`t}dUI;rc+R&Rk$w4db$6#I(qC ztWf;iVCIz=Uz5S7gFwXS5*g3ukD#h(%EL>*RMAeG5w1J)?g{8n0`)DhgSa2?PrU3` zK3zzD?gwyztu(YUl$ZhR8Jge%v8MAyf1_!LI1#2XvAn>vh{mw+kG;r>d;mxM<0JlB zBILv4-QTk+>S*y8;A|iT$oPbNL-b!z1Ij@T3M?2R% z0Caf*O6%d>6z`Xxl>oC+xqsD(^_^Lt!$)~D)cKNQKOz@I<9s+Ws@!g6r|woi%7mQR zUNFTy6BQF%MFJ(UfMY`@GsaD%!g4L|es7*;JWW2LcXGuxkp;{2DGh|;iJ!v`GS}^N zSPXTIxkR#Q^N7frSRDA)bZ71s&X?TA2VR$(zTBGk_P;Mm3VDeR`TOrLu(;&k)jwFJ z`IRJl_$SZDl*5?lvZVRPc{5vGR}yFv@z@nCX66)1r#>65}oSzxd}-n z;2&9)KS;l6nJZrwMJ;yiHmT_P6nG%_11{d}^MztIhR#nr#?N(J@k)|(a%DNbN85#) zjDej1-4c;A=8ND{zQFuCe}Om4=uE_hddzVve~Y+7kMLnEMVYHqT@lKHj8aazqi+gd z)cQ>+<}|5pCP)peyC8uP`zo$+%O_hb+yDsy#9bcqQRvpn>3k^P(8N+KYdnPrl%*Ym zM_Jd&CKvWr7x6n5k@D3V`XXpkg-2FaR+V1ekWe`jK@{wnp0fa|6wgb94b6nwSfCIU zDtk~@vP1JnwptupCGeqZ2gaqSO|xzYGI}d}>s6irmOuFv=j#%*|GDsx2o4u3wW25OM|0DJ#0l(g7ak0ep!fpVxv$*t(TO`) zh`B*4d-{iI-OK0Q%M6Z#4uPW24@V9C1iuNxT0EPjwPh4oEe-{+btE2CrTgzeM0|K4 z0v>Lmd}aZlulY^9!mUJD?KoyciGGgVZbzSg^A4|psG}nKAbo9spXM#vKpUydjGje4WwDkyuVlz?s#5f;SfD~hYj9p(Z^qWS=-spJPSVE*~KD0zJU z55WE&^<5kVB$1v7&p9_6YO%*b)tayd!be==GE7z|)I{`jeM|K_9ls=Lx>KF6%LB`+ zN&&)Bv;Z1@=^Gu=cITG&?$lmMH_mnmzshxoKF1J?)7>e5dt!1EB;rL4CcsERQ$`@9 zN2GrPuKD=VU5_q9@koh)LFvv)%;XKiilxIKUb52Zur4h#Tr0uDAB##MxuCx52U;pc zA%TxaArD8A&r2asry)=77Jm00A>KV2_xC-|w4_-)$uXP)_Qi7jr~{?(y>cB;)Mr#dtbh(s|d z#3+ywHT&N7lg;-A%WnI}uiEtK_3EIe6E8cQnaXprc3aj?lgSTaJhj08s1U~Kd$1MX z!NYF5<9oEk1GtBX$nj~lC6t6$GK&~kdy3P;R!sIFa$F}!s8Y>jaGNF=h{kI1SWCyW zfVmgt0eZQdy%0Vnez|&*UPK;!h0&H|w^%CGM674a5osMYHIn3(#l2o_an2HIEho2N z;z50QWr$6i!hZbfFJx6gGcbR`6ft)CAT?+FRXWCbnO&8dz*Ucu_yV(IbfqmWfp$uiMk3L8;YzWIuy|X zKYB#@~CdYV(fH-Rx73?}7WVx^4?Wj8*$?wQs=q?B^Yrv&AhkCB%!} zMnE@OjzWvXVsvKEeM?)lk5mg^#YqWnH3vj6HhlhzZ9OGZ_y2oY#l`h2>U$s3Su*~9 zjasVOqvR`@jMR>WlZyrTO{mEN#Sr}byt>#}bvNjBcIiH_$8JS}GI`uHr~kD?@-X4c zmLuG2t~{r@+j>r9zFSWhAr#Fhwve{n6&mjF&2!e7DRr5D%WXA|-|c#T-x^A*uYHA(J~EWX#gGx<*~uVbK1>od6Hs%M zvoUB{=r31Ca2{P%agPy0^c_HV2I$XW8%OqTa=Zm7i=oht!>*gH z$>}4NPIsq5`@CO4p<8;SuAU|ZUszLdjE^h6CF+8Bw3}Xa^a8k8Io(W+$bk1!FUcJ% zp@C8XY%g!jVCP&!dO7Ni2TRCA>eY_P&2e^XVR;n%5JZ0cVvI05b8ctMPG(BzrV&Jm zGdSamXx6@_(v0=k9mQ_#!h}GS(3`=V$&i5Z!)iH+MxgWuhrCZowaD8NwuV#Ks`byc zmG<=8sho|3q7I2a{-SRuY%>Zy-@5)ZE+_OUODuN#bJp1f2D8K&cnkTIi+adG?V!GV zzBCY}RNC-R8pBO!Uo^}hcBb7Z>DHztF~;m9AW1(`&R(m`I511WevrqB>}PR=?JWZe z9>!`9L1SX9B6kwE~g(LO}40jO871fdtF^_{-udlhr*L112p?-@h3=XObNQ zmuQse(El}cK-|k3K_`t+TpkvIfvu&&j--rpE_Ml9d5uuz*lkLu<_(;CkEg4B0Lr9t zr#=Uusf!DDTvSDDMM@so$$;KCaQ3IHIDX0E)`|>ns2K3URFA zpN4+hK(sN*TQcEV9JMGQRT_n)42j`9awLL6)*BTi#)*K2;QdluPk9A;?h3H_JSN}! zQ_b=|SX@%_{)4%7mznf+$LmGCH(f6h{PWr6B5sNt7E#jB-A^c+p$pic6-+YTo)|?a z!a8Gjt=z)^ZPk}7%eP<&!)f?h{$rnpu_g(gblU+IQKMVJNZImb0LA$QH9_0x8THGZ z`~B8gQSj}Nc)`2^9hH{|7gu-$J_oWERva|0iiF)mgdYj%5>Ee&8Qb{Q^)jt5 z$=9vdNU!5~hiz4PB#O^_Z`n6dQ8t!Dm^puUl?kE#Mg3i;i%~yTX}1e`-b7gUdOa+D zma1#YJMQPTNsPv zV|aJai6pF!in24)Wc6?eNgmYh(qw?dq@vAQ&7u%NYv=Dy1bQ)!KdZ`TQ|?<82H%c^ zB%ODBc4@!gn!-UOq?cMaDO$4`;7Y-cOTlSDaKKWGu^XkmQ{YELvPP2D))YXtg4*oV zo`dat-n$Cl3H&dXQKa$2Hn*iGE`BqDxB% zmq7ytgwmdNG6*fa$@_oMw%^Hpntkelevjq<8TDZ<;5GI2bw_Za_097Pg5@-Me+C&2t z>tamuFJrAu*5?uRzkE-z=U(E*iJZFi3LUu$>P$lS-0^rdV~WkwZe~TF@OO#%PjwN7 z5!`}sL}{JQ{ClmM8ljLLX2<4SjO`+=K?f54m>7~?hgOR?U1UzN%Ur)nG?Svqf5vQ< zgCfO=ip5+R1RC77H?IE#D~_WuuminRq+l{TiJBXLn5BHHev7($xI{(l<;*?g`QaQ0 z82;DTJMD&h%_B5bcXkhF+@?gyjVgZt4oXXOCkr`2L$;?LY7ZV9U1qKIDy2 z6jxvWp{P4_ghzYMT+!?2CXAK{yS$61`fYXib%b56x>_W{Xrq1BZG7hG`Q`5J&I3r^ zqvDZ{U(H;O|9gqZ!k_xGv*gB>wi=l3%Dyf*5Ck7%D1Eic5kR+Y<3sOJx=z1fvha#d z38`R!$L4KR5=1l77X7X8&-!fIgD*oYZdilgIA6>1B+9nt2C_I*oR?>K7UDOF{=HdR zt#nu5j`xU}mwawLy;FLp0qDY(Cc7qa!kYA!w13w-BGCp0hHCb{GY?2*T&6A0d(TYT zj&dKD+V$nEKgt^Lvpi)Z^Pw#*o^N8l0WulCj#zi}D53&KNQwkq~z)v5xfRa@5N&jF_Dq z;8UdmVOBdnZx0Vd-#47(U*# z9db3EIrg{wQq-sfw&u}6uxcHW@@Ql>OLCZ)A=sfbp5Ub^$|$AL*(u z3;N_y(pd^l;zx%oN0_I_<=AIK@G9ACdP?GAEi=^mb4U%58sC;E5Z}wO z=5-C8Wsy@n5&jkD8v5U0($Pf-X+9PSOIS-pj<;e_a}yE%F1=bBQNjJwaF1Uywd7|Y zbFj5P-V;5Zw`B&9k581;ILob}Xiht{m2z)>k4T|IK2nxgd`FAmU{|{>g|}o`Jr@u2 z7iq})WUd+xxNrAykbd@-!&h74KN5F#vG$il2~AfcMZ z?9S~u6yYq0IpAwhVSOw&G2G*#9MCo3{@jo_K7m+!hKC#<*Tu}sSYpd@$uhr8JZpsi ziy9vCP#F?lyOa~FLm~G4^HXRDz$4D3S1z|s#&}gJ{c8R6yamW|qHU5>DX_uV;bm`w z@{->h6jugR+4C@1fLr&miylYx@m+|7!1a z$3S16?^=7)G#iBSTT!Q;cJQ36p~#39!B2=4iG~CUT`BbQ0a4uWjs;7)BLjU;DOH*IZ&w9*l z)yEWAjmV8NZavxJ?8&Hr#Bne;QZIs|y>l`uK7>5UvC&M!m8cryfZB87Y^;`oe4m0C z%{;!mnV{>9WKQ>{3qLGuls(V(`d6V-9ah^9g8d%u>3yrCRfgcImoKIJBGw|QkN!(P zYg61eUYnMk$zpw>bd%2M8}Qv^v93!NbF>v9`vU`|(zv zVmbHIN5=4gHbR|<>i%jM_Fh=JRtz2;d$)G$mU7cdav!P6pS;=p)vw){UCY3X!m}TB zd~{H)%(KD!jp3nAQbJ$lD5E;_4pI)pus|4HMmZG8@Z+L=HI<(_zc;a7iz2SIUIK_>1w8X8tbR}N! z#B-p&FMRhQNKzZ&gcn6rF8H3+m_Y-NF;$nZR|g}PqgDAXpc6VEM=9@dg2j(yHtWyyFz zaw@kp9-Bj=QvY^r<*t25&O9fHl>?V^27KqbPd(`-X(ST^ z=yZY`(prZ2*T&#k_ClZ)&D+oW>A}B$`yzcIsgy`pFTV;VvzCqkD$a#tQ=CtlYRKQ{XeF<;u7 zjjsz7%cdXGs!mBA^5CjAWT=dUHbPwbG0y7}7M%(t%L2n4MTHehDX5ehOZCpZ86`zi z7T)elpNvB(z#>Dv`!4cV7#}~<$r;no(vD&o#*b}D4asaWG^HJR`Y4+5kBGU^bQX(y z>M?+zrZeKzC$LfyYkfcdZB;z|nT;{4{`C&>3f>JeJ?*EsYJqovKC_L>>D3oQUDN%$ zdWB!po->mT0+@i=;GOV|H#xVkvFlRro! zYHu(&>a2d>mJIrPz65BGw}bw9v}h#b;&yaYorTgJcY+9ng##IVQqgEFP(g79wIg1} zvE@<2juS@HWlQ|nl~({Nw$X8xZ(^BlhKkBnF?99bR;R7jD=mkJ&->^&{9D`4pAXa8HaE9{7xOs|Wy*X&YnUyyixxf} z-9ncTjUNNl&JR~sq*^@>W&by6A~Q!>SKFv^gNtwWdW^YzW^ct_FIs_bI^hwK$9;Zf zK)#}3Bb$pS!rLrG9|Ny|+1~f*WK9*}?i4o=v7Z>upS~CRx`wIja6;3?Na(F(TT+Zf zj3uah2AlEv+4qBU#Xbc1U)64wMz(wl?U*n3;zNTh?%$f##%6x)aKhXq0Cf^2j*hhC z<`T=%qu9;8?m^WQZI=Ro!a&55f2_1lZ@1R%F8evMJHjv|@B4b?PEPJhjok)vZEY{e zrEEWO<%%8_&vb5IP*YR8U*N?4xu$-3Pu<-Zb8!u?m+0|6rdG4p;~33iCsOz%8-qO3 z^J&LYY{TsDxaW5kX?2t7n}EV}OnsrQH~(Hyf@c?Ga?}LS$MJZSc!y1tVQXxm(5`^A z;?RQu5pG^OzJ)d70*c>Fs_O#isz(8LE`lZYn%?wwwd0)3B19wy3oIZy-Y{-PM??Hl zRC1MKyj{-8+1W&6swnTdQsaeu5)#e!n9^fTI4S!03-OR7ZYEekjzDIScb--T?T7C~ z%qn`H-0ervO!NYgJ!5f%Q*?SB_QW3yU`DtBW3#fTb(KI%RAjE~W)sz4p%aD8&9IuF zK;PHPexf-uF^XxeGv%K|Mn%y%-S~;Q>HLTttyfuW3+*A@v@TX57)`I4pof6DMF>bV zMgt4$#{VB$x!h{#3kg#66I!5$fJZJbL?g8kA)j^Mv{&g{=PT2>f#i42F|KnoDw`y6 z50>xuuSCNCja~ow`!`6mU>=B!sP6v>Dy*m)TdjeA6HY35v>wa%rVkXvPF^~8OHjoB zpr|S{vv+Q~QIV15KL;%OQcCG;rQ8C}_V&fQ9$;>>v~=bF_wm-5aC4Zu)-oIelJ$nq zR7W>fv&`tvLyW*aGnM^PtAGOg(F8+n75g>Ct(nWr;CEs9JgqlA;B}ZG4%C#>5bWu_hr(CPQ1Nf|NXiG1Vf|y@Xt5r@4+<#KFMr zKDu3H26o_w+W|BZ3l)y+a(L0x!T$KPO6Z`ts<4{89+h-u7X7_i+zI-e0V(?gS_J4j zQzodJrZO1lJ(=KgHu*E8J``O+(XJUjU~1*0E4E^*zFMR{cf*ZFgaRrIpqHJ2&y-uC zv~IVB@^w_=2y4LLX;Zmk18(GO^eYQuq9!yO)v4iKwp%S0>h|ttq#2Ec?mZeB&u<<+ zQ38UdT*o=LteB(He4BV)v+c*2oVsH+kRKNVpR_W|a(E)YbZqRM>fgxpgZ$J+S1~<- zSxx(n&V`RtqPg-T?XD`h22FX8L9el$iP?f9-uXndoWp=>)bX_<6|ftnd1s|lyr(B< zmBB9ndO>w=olhvBWP*6g@=i}~{yHJXQ>>xj-%22`%&<4_)VDdm_xT5V5tv5x5$}dj zHuvn$*i3f?hj-y`lYy9tO@J%!HWf@Xw{&aj2rw-&pp}6dUw_Qcjm%r~(-laA&L1&J zAtnjV{{W2-Erv~t2qpT=7B2c0&iwlG=cfVg1s=~4yUZ&;gJt^ij5VW`MPP$$Xl@*l zv=bb~WSZZI@r0}-in6lmAc+3cM>fH!4|W-iL!z$~q=abIU1^pioO5*}?6s8_dBf*j zv+tfHS~>%ATLcgm&Gp!T7=#UVaRh9H1IKYUD{ev5?Mr+(FYEpSX?p+H*CvjrM7bF?{!j96IqCsLK|`W`nVeov`X+M1O0klu zxL#V!39<(*;h2QXk)7gl+blqty$9aDe$@RTe%>M1yTkj#PftLPZKLgss+%bE@mPb7 zCWU|~I}+9n{(a{4hoG@Pfv(C&?pVaRu^NPr=7eFE>HI#=()5 z;*li|0SsJL<)_U9Cf8V4G6%2&L%u}x?~=XF_dWXSdr^nK~hxMn>F5Tr7DVYcsb zPxm*?TBDU1f#2@0IWb(VPj%xY)1}Z)aUv(?$_dhYx4gO~A}oQrb|a~e|Ka+?S;$Q5 z&CA~;KZvX-y{I|(P0LcAE^<%B{c!!j_^tFRt)M~VVwR4-ZHzglnzW)PA@gDdl!ghv zQjrxiaty9LY&MPF8<=e#QD2{%k<^_KP2w?YS)auh${{E6k_d&#EDhuB)KH2#l)iYA z?S!cL59gV6+NRxB!?InE#UB{$D`CDs#8j0ejjyo>K=sDwFK_-vQd-4tse6C)eD%A&e0>m( zuEL*P&b=XLM3CzAO`eC-j}u>MX8N;?joOMHB@$;1kh|h#u=`qD?(o%$>)@W&I{DK( zI;8Lv4|#K@y@b!}Y$*d)j2&faa*yU76iQGu8j7X9bLR7tQKv?=&+0S9O248~J?8WG zGUhV`bx@W>|1p9f3OI7|H^mXzC_BGk12X6b2$ACsOL|kJ3cW6k1_l&=yhNgA%}uu0 zCJ?b{U$1&z$BWVbp0|4bQI{szJvh|d_54Y28qDoMH8Q=jAA{u<3WE%OW?05;S~$>d zruFBwNAgrevyl?vV^GRZK_3WhbR=lU{^Ob^yDAW!2W-(k>$$(b_`XGXz78-V`@8KQ z{9WD&4ItPFFv^X@cqO3jbwlxQavJ0aiA9R5Ph83~g2~1$MGGGL0Cy@dcT1j^-3CIt z!1!Sv$eE~Ki>vD`h^Ozct|J9C{fesa&V1^wK}P3W+d7G9KJ6X{hJ-y&8q}`=E}+;G z{##rO0)`(gbroGh)=QbSqb+kPl!OFJe)#BJq(Zt8q)g^QLt))YI)kAD@KI8Iy;ZkA z-6iMncdr&)&!J38gEa|I7TqH=H5mC+2y{N)W#+LU0LZ3UDqbPO^P^x+n? za+(%MOENpR#khLbojB%1)Z7h@#%x*+`vna2^@Hp2vs2(4VVd1RC)!f_*xbl;QHMDr z?35Ii?thpm0^en-FLC8QU1D@jo&3pVzD;>IFg1YCP4()Jihp;+*cv89imc0<8F2?! zxd;*XlGSAZCGr)Q8{Y=UiIeW%s8+GEDFF!(CmjD=y;LX|>Tz;Q+2m>XaNB<@MYkX9Yru zVIH8*nIIp4&0$%M#*!Zp&e>TxY%B{32|a1tNB^gN_;<7Q6n*apSRbBC9F04B5Z!15 z+Ex;9U{QwnqiRM&iLOZykcbW6vQ>rM=wSd=6i|m=2M8C<&udfy3dKL-`9R{(hw8EF z0!S}i3)^zk+d+K1$i{bPBiKQ;kMSOC@RDkQ*cyFJJ^W3|Za_rT0F3;ej#sgV`ESO9 zCsmk5@At3s#~+HEjh6Ulxv>m@yNYWQtAz$(cmk;uZX^2hrN?HacJN_U~{1MVT zJ14xH^5$&)|?8WMd_xS0qv4$eTsi*TAV%Kn7$j!zD1$BEPT#p^ z%jrL-jD8=}XC7}4;Vn6it&z+SPGW6gE?As(h`CM zqWG0({GX~dA)fmcYlRQZwnHhp)^B20PxGqNaoIL3l+F~})L;VfMEMBPIvaDo(y=gh zhfV={ejcV9q#P158hDgZnRAaknUc)bYl+QmDxB#4zq9>aJv~nkKcAoOg@ig%@X^5d z?2gepZaZ(7(VSk}*9m$z%qA`vbbA!~{u&2<*DUuRLV{icAL4~i!T!Obl*vbyIZ?sq zPoD4!&zyK$9X+mNBKaMGpWaI3Mhvu`iV2_1C2*2Soboz7qC)t>6nS8kR% z_LC)F9?mwrVQn>bZY-z01#^9zyzK~|*%+ozxX~j$Tv~aqD93>>4*kpJzU}*Kg{+RO zFc-oYpc_opWFNK%K0qS;VWU>eO(Sbe^FlsNu)a67z))>u?Tvk9;5$?j)<9|wV?*g5 zf+s?dCJ6~CbkUiOZOSto;o-YDn4fTSht?+OEq&wK=qDtLo!($i#%_UGa_Uh=m#4c+ z`sQYgJ~JDX^s@bR5Nqh-{WV4mELfoG3!-wJ|gWHvR;1M}mU9Oyt z79NK{LW|#G=j|tjb5*P5I>goJ4s<+usLt?937Q*R?9eE9QxkD|+h=*cWQReE8Kz89 zGs-OSX<40s^+wf1N3MrNy(0pg_-Gi$J!p8N#5y`CbVxMvjDn4&p;T5%(yS1sAGfzg z1JdDbxoTm3w`c_xR&a46jQ&?(vUeJYD z^Z(!`8yhqJDU`RmWbkGq6Uvw&@V0rRz5GVBXb$3qLx6+NL=!H9ft(^6OXclWIj{x( zrz&>u+x3n`!ypQ$)cjprk#!K*9Seg<%R1rkJHOfu@eXe#lU>x_zmU;bdD0In4n{|{ z+3(heloL|FHc#&2Z>x-A>T_X#-4Y^;gSnriym?Tr!xr$%{LZiZ`Da-imzy~HThZl0g=O-)Ug^x$?x2nyrXePHaXE!znVKn!v3kvc14GLj5 zzFnV9V}#*#icp%JKcD?D-X#lz`X-k^pySjaFU%MSsFNjB80wts#knM$ZR%K67fLug zV}&#T*^|Ob1dH&z;dMD?ej~i1rG?z)4)>2amXEO@bE@dJ>ZFUI32o#ivtdHE!B1l> zckAC)2;r%Hqsmg=o`L^?n`qr7fc@k)2vw0{34;k~c`pYom2}W#@#9CF1R27xPDqkO zLISY`eVp+U2k(zf>C{gc8>d>tP+Kqy1+LcH@tZZupjUVT*f>A83t4^l9-;Sh|DW@v=;Up{fUvu}Yw8_>x$WUdh*| z;vb%Vs{D-$C>+0bsHPY&UGgLgbFP!(IYf8uS}Dm9gV~~eE(Erf9)X;Z(nN1^oy7us zG~7EpECU%Bd3_fqOhbPVy+Nq6zf??bUH46XM-xuU@g--SgeG~d-1n`q=aMQR?dJ5~ zi@ornm~`xUZS4940{VTp;StrBag&M)=h*7dA{{71K?@hfsd2+Hk-Md%zI)Y6EixB%DDrw-2oZ8u<+ zHtbPYp~MEyjHQIUp=S`}W5oioL)8}&6tsRXjD~`{ z!EiLZrsbr>_p}kECyW7~$p&~VW}|#L?U4>G4pF3s@Jblv_zzQeP?CPd;JvXyl5;?l z15t3Nn0VWGpO-&n3M&bdIq!d z#-09xGjS|Exdd7)RFX2_*0q1hjgtRTZKi*VHMN-XZ9}2i9m`*~=<`;}4M8ne$c321(NJ@&cObDs~1sIH7-qviDV zFcGVa`=pNUdMJ?wEJuskA zTrAex&$CzxDEiQRim{3?Jdn_#Qs+XhNQ`j;6f&~_rvaOx$7fDTu!B*cpn+j9LdD%U zS|}CD%nnhETT*OkZ+rjmJOzjx2D%SHH~MK|>Wk>^UC9wFe45x*KO4|FFRCCk2utO(HB5;aI$}Hpp+gWt0!@YQtVr zk?D(ovZr=nB@n_#r7S|lprHhwc?xY(0+kM57SRYuXPsCbwGoHKy{iAP$Er(hrfmz3 z`Rzf!war3qeG&UCe>M<{a3`k+l#V!YM5cN*E66Rd7n2q*%RL~~7?Dsw#XRzg$`8ql zrRF@)Le~dzey>G`#SH1v^Hq!IbGu(=B+KmX%?0ckG#oaj%pb;!aEEogYe7uZO;JYb z4nsiU!;+C3c9YB~=tfTIXct43_Y&nrsks6Vsr+`PL6}%V&v3j?!e0EICv-OOLoo&i zEy*M%2K$4TEMKazmGIfrv!(ev>j&-Z$*s*A>r5?(BZ)Gw=A|>LC%$pw3b=&Kx>!Jy zjP3bs51)e@kZ@2S`kGD4)fF+EgxLRZyQW2%a zQVESLNW$4U1O#@}8dg1m9UzE+zypS;j45klOfXH7et>eo5QO27XA2@>H*ho=glQnz zA&7%Gk(9m27|zuIk)@RVFre_^wEyt_{{4s3*B>9g`S$&ffArzQyTdqw2n;3XQ3>G( zVo)<8CuBqj=4kE+x=hs#B7|`ek+kA1i%!#0t6eUar>CdK$LG(VKj#Mg{ck=m%W^(n z1;(|SS*X@&n%q6R7HKYG=0Ol3d(8cw2c*DSXJ=>Tz(_iE&Nu3$=~(HiB{MY-ClHYx zGke5Rb@Ye03uCE*CL=>m#zSi8qAM1V)^{} zah}t@h%7+l5upJdUft5s$WTl*AXs>*2q+fl=7K09?pT-0@ie%5qSGi>8ILf3e)`g_ zs7}I2psH1uyTe^vLm0FjSu6;OT4bIb$(R_@s$Q7$TM80WRxpYl0~aP@W(_qnFeoe_ zVi0QcC`3D{UZGm8^~;wp@85rvp>QDu1+=o;)xh)9bT{mngjz)%=H`$pugt!S)?&}G z7eZ!`nY%{jDW)(a=4B29aYaG-b+&BTB_Il4<8+2R8$qWkCjT)1WEAN=3`AecZV2eD)ZG8jW2If~ zhp}xIgqeEc$<8k{&=4GUHm^&T;{mYWA3d={|^6;Uw47GN4pttHQ+M}&GfI1xCsyQ)nY)YXVUb?FVfX7gZ zfn(4*W1|$cSJErRW)Ocb5y})u!w5zwE_U5$RKDHTN|1^Qp*|U0Z2(6&Um!WT49ffrDhwPpb2J~ zvE#ElF&F~~nTADOb#iY-;)1%UGBXk*usKvuhkUl^M|G`rF<%fv%HUWg3*YURa4@%_ zV9H9X1`~Nf7;50zV<&vt?Qp+C<~_;zJTVt3Wpc-%@NQpgC4gLGNtl_Putp%K-7DWt zi3nXZ(919sqzFvcVM4aSfdGmKs)sE@_`Q&^yPf@cp1zb>XyE%@fw`DQH5_T!FShJ< z1MFDQnE7zGE6folL_)&8xFrK2Pb1`)<$^4Q3vr>sBr=rIoa#b`#lh5;Ou`hxV5(jb zlbf9Nd}{(C69k}fAZ8_yejLQe2vR4;0O0J9mt}DZZWgWpa!7XFalb>#{9_@&&zmLNXhoM5u zEdV$$TMPtD0g}Omk$slri6R0wdcKB6xYv1}pP!#E=jr?JKWBCO`1ttv`26(r^!#+0 z=egFbiR-c~rjgx5GwWiY)+|j4Re-B5X;^5Z@r2Yir}L`L&);$FTy4iiiNDZrK=+^s zQw;zMV2>sB>Us3c999p^K)Rl4@xt-B#@?+OW+DPY^$ay@8P29|7Ve-5X6R1tj+TmI zfFKRCaJMWb*%1&Kg~7ACD;m`SH7iXJ*FN6gxUDvA*sRZ*{5}xQ^Ry|0vVTa3xa6q< zgEE7#pD-9u0SF>dZ_pj9`F?YsNZOHU7zY-Fh!B7t)zbb=pPn=r9GD{`Lo%$>pOd{i zAVfzJrf?GGlxXFw5`hBQU4==b(@wJK0xc1_OPO*eu-f@D<~SnBOc~D^1^|Rk4dv!7 zt|zLSL8>f?;gyQ22ew8wt`ayFL`{5ijX`{4)-If^qZH!jSP!}q2v#O#>#JweBU%yS z*QjI?WMC9VVPI-m0TJyxw)Ssn{jDpICws8TVBr8m7;>ziD!YKNa0`!~tlUA!2vx*EyRc$#J7)*=}@sju%&1Q9XnFWM9q9Zq# z7aAZ1l0_`;1tS#0Lz_bXZ;UScEyfdpG1a)4n#LZ-2&+HhliJBCA8j;0;aFX#FExd=Eof(ZeW1K2R) zxTCUby)7a0P&1Q(MWv91g@QXmhLKTd^Nk^a5Ctx2_!^;j3h$Qm=Tp)N;Ym(h5~^EM3IW|JPG3Cgr$t76h?^v zAY>|B2H^pv3}qb0@$T;7t8c#k_M0ESdw>6-kxbQ8nORU)A#{c$n0q>mR2S97tVS4-bXKrMn7a}%c!CK*kO~tLNg)WT ziV1KJqylVaEBQ8ITV3}{+u_|>ucz4ID(vZc+gfX?o%6!3ee^by&T|mNmQR%WhD^Dk z-g5&K;5AaG^|@0al@8gS+oda^joLs9W`xIbuJWtm@t_ z;v3AAWf92?A_vdj>Gr#A$DB9Y&`n~&_Nn>X<&2wDAJmeQ-%nLAkSRcOzrgsB5(vU z2rQ*kbu)zsLQZwRYKG1Nz?E(324=A(+IF25B{LWincKp&8omi4fx_#qopLH&mSkKq zBO`I-EOJf zxtbGPGg1Td00i^)7ZhT^x2LGUTvtxFg!J9~_C1zqz!F?G+0P}RlM~;X@%Cd;7 z)ywqo{(djRC?#1#VWz4&Uqpy^Qf4!#Y91WW&T}H10IrN5v;fGD)&R)R2_w)LQ-1^q zPQmGk0^^MI$vc3ZJs_PK2poYFkTEtyoP~EpQ?{^x5HJT3a!^Xr5!f`C8F>eRJv0!I z*eryPyI}{29!f;}{kYrhPN&oH?(p&B$B!T1fB5j>;o;%_{%*I2vV)TTU21`f0~?Z+ z%(&0Y#2!Z*2E@hNeid$^T2)O|>tdJ7{QP`*dVGF*diwnN@%!(;PeNpBte&5rmqlx> zS??x|&McoLCzMv-bZOGYR-0m+?!4+qiW}GCP0VK+`B$NAQ&DjS9|20aE&A z(6UDm!p+^RcK*PvulF@{*WH(8cCfUyH9Bh(Lgr^`d4TH@%4juP_FuctPngQU1Uw8v zB+CLynx1mzSmp~N-6R2Q;@_`9F&psKD%oprlB>?8T{>SC%WK(`b;nhh+K(ZfP_WsM zLbBDL&A`NA)>?;Q5aK$YWvA$YXi^xx$7#PMe7&*oVrSvzdfic@N%VX(5BrU~B3iNu ztcHT^7S#@F=BuS`eZOzho3@fJ!2iFd+tTSac&A$G_zgdEA~7 zHcanme!Ilq1b_npIT*O+u`q>X0RV0h!~-d4m(#B5G*_5N=WW7|A8U`hlXbYl;+0ETPAb?(6) zfB{LW3+B4iWjaTg3KClE!SPg?_CC@Oj$o~LW z0vM#EAeaJ$gg8qCQyrzrT)1-~0|9_t0fI4rLYN9dZt+2oupcy3gIe8EipJzDI51zz-`}6U{^tG1uio9C zB#9Yq@WOzQfsuyf!Y+tQea^iDgCK+=MKOqkW?+V9zAW`}p0lpKT;}Je^QTXrk{0>= zeChE-PpQCCRd?vIKPEh^DtAi5S@ZF>+#Xd;8ExJQrAW%z)`)`Wqx7`_$8uFzWJ*^{ z5l0B{tZb5Q(&bvv&z;6BJvAl2bE8T)z91!RNIe|kwJzQCg0udUhs`u~K@)A7cB z(B$G`@n8JSL>61 zl@Rwgui3&1N-*rDRpp|jm z#H(*K!96#8-q%bp8VV6pdbPy0}CiN4ycrO zy-?r>Ag=B!pr)9LetrjlBGUX_U1b&kj?4iDM$o-HO^=vEG>5R9wj&`Bx(EchJ0Q6= zz1`~Ff8{!JM8-rvrS`QQS;H_I+bRgX4-^0pU>JtA0`B(|uJ)>EHwh!6TMoz!FbJ%H z6gup$jov!y&)tZz46-Z3$bufrJkRHgsgC3D?%l)p=Q#@j3@9z0nUGLSh2ZrmGpBE9 zHi9%W5oSbMWCBt^?%d4GEo8h274v~3Bp?=yFxAP!78G_RoiE5hx|~n@{kTH}a5t-U zUg~@i^bo{gF`%RpWJH=(g`PN=ovOrO2zA>ABM^gIWQ-ay0aB;LwDKRYde0$45}+1V zlgKw@K~h3U_E+S(Y1%gp{K{oQY{m9r)kMz z_xyZ$dOCMo(RrTdWp119^Z7AV3{8%IOR>)RnwW?dS05z&+n!U6X{$!%xdU1%TFAy&P6l)}+Rm&xK z1I5J+z@!~$uBY$bV8~wYikoevQtt4KB0?gmG|84s-%26N-+7(~83qy8?ERPrmG0QO zCg5(0*ACwE7hpJqHDI7uJpM!Aq&ER6-C!uvWb|~ymtMF0?6SRG?5-)TaIN{^EzH*I z67Wr*?sjgneJIvCGVhPJ)NV4W*9I@SQN}jn4NYrhUA;tV^rO#BEX11C@rs1?3QoEC zfAh}2si6}R_h$8flgXAR0Q1Tifw-;N8z}0fjefN}w8XeA>jn^$G0;r$*Z&*?!gHpS z=2pvwNO+iI1Os}2nNb7+3bA1za;NTW^otR1QN!TP%tX#<7C;88=h-f+)*_`%yD;7| zlwWc2+1w7$oUKAzOxk+somv-!Xzpn48Zm@B1z?cQ%lUj()w|Q_oNyUNkYu37lz6Hq8Cd2am9=AM8+6k;S+ZV?iuMozBb69Bl+ z=coN{R|d?^DnMA(rAnyEz`&@?VeKyV$WdjBNJ9()PsGbmFgw_gUXJE2M}iDe@bzA1 zBqj#4=wWZtWS^Oj2Ta1 z5BrC^)5GbTuRgwef4V;%Pj|b!6YLLA7@*k*JklK-#$XvPx6T{DHB8;Slp!T6plFV@ z*6Fg$i+%t2be`t43|-DGmFRpvPt%f8=jpQKey}2%(_;ewYkDye1z3Pb%9$G$)!i)z z-A&q?_AKnPOpMnPskr8oB=wHA+cV;NEcF(?8?_^Tp&24EMNqk2TPA=KHDLC3$=I?T z*2gmOTs;%8Qq^%c^eUuyihaREC^9N6*6q8hRxSb<49s~adW}4>Yhb96063$tpgFkP zFbs+1Ld1j{sd04(vY_ZQ;G5?2W+%A*6hcHCh9SKy z>q43DBK`6!Lp$}@*7h|_CP+{AZrj63fh7bYT5}QJ{3ZPm*F_TzZ_!B?K*`yMHmYW1 zA_@d|rvNi|@)a<$o)Vb3q;#JeUGRsJU|#cKQa$h{{Q32kkZsbfG%^PksYPg~Udnt! ziijd~Rb!<4rafrZKCti>e+&)rpP3r~NG$|6WB8zng8B?0>v`3hv&lAX4M^KzUc@Z& zsJYm|2t3E=*tc+OVSITOM*=W&OT`}sQW&UN5(PHLFm5?E7%$Mj>luzAci2=pCHT+U ztOXNj+@(!vD)9hE&V2$HDHpu39%$X(okLtD8bBFfg8@-%O_+HpB|lpAy67C{jKs{Y zb~&GIsmIg(hx>;=-T$Y;V&sCP5gfryI+g*7uGY)8m|`+{RtYRFte$~ zIs*pCQxOxOn_$beMGubzOZ)PuSk;K#Dta&yVS-a!TYCVIpsDI3pt&Yj*qM0*IM$&^ zt<}`Q9Ke8?)BMuY?A^ULvH-B(pe_8@$w52PH;f`l%|sH`{AN@#G~NLMoT-#DjN^FN z?Td`NGL|w9!*Dv?e|-Ppcz5{rx4u2z?cTk6ce=x&C>k#U%q^~TrQW({QUepO;b4LxHqHX zA|jPXM7Sm*Z}Vz4nU~RY6Amk?bfb}JK>Mmo{|;{qWw-mv8ceqKYBnP-568aVt~f9U zATu?y%p{>yX%c4i+xq=CM+#pnfLd#Yf<*+eyUqc+<~@gVN~MT_oRAdSjN8qtSxpBj zP%28(O=7ulo3+gAgm?RxXP{#LmYUpL^$&Q`4L@i)O5HwU;al;aKf2DA!T`#Z{ZtEbB) z-%FRnP(lFSN`|MSVQAdQBi6v(*FI@R zP&arfoofddmR0n($yREefS?y33qeX12eg=xMuS8M=4%dB8=C@fzMhuK5L&gJ1!*wz zRJ3F&M(@wxD)QRXM_pV3KoHzQC{oMPp-Isi3Q0^2U$vquU<9|?mz>sF?Wh6=E6y zfU4?Vu#ku(5v!WQvJjETFtBK7wjr7Ma5(ICyKx*`tq6sOn-PQr^5!U;?4qm&iOArE z0c6Excj`B`2w@^&ww#ei%aF99e{z0p+k8=6O=p z!Zhqpd0lp8cRrt2B4AkcuriJ^6uZpe3a*48G7u4%+fogHv5|m^@U=newbsQAhG9g4 zzz_;zf}jXr>eS|VLJpxd_TwEIi%8iOQ#GqX<+wi#f`@~=f4F=1?&00LcVB(=)wf@N zefREo`Y@6}TSYAZd=M&(%n;@o)QDXi;0Ecm22Z;YxIs-@jM6mK=cnm%sq=Y$e!hJ9 ze15*1zg!-lFHc{-JmrXYnKcc(DUIoo@-J1#0JI@p=Lb{@M^Nt)TSO2OL2CvM!$8!U znQ7dd=Q$x8E50})g^jdMv)1U`=;*#}Mb!;UZq~iU!_digbr^&Qm@xu+2dFuIGV5^7 zOieTIFbu8@#^m8BZBG}FjU=k^;zd~1TAmKdG@UP(3o#syyWHO}yv|eJ*@Y1RtkxoQ z*pDI-=5?OTOo;Q9q{M6u705?C(Uz&r&T5bub+Jtu0p3_vA>tlVHVb?!>?l(GdQ?Z;i-V#~7Z zcDr>)Z1;9mRTU}PFWve%=A0tmDe)D|>0xe>O0HDGX9m|g9S^?+ZZGpx1}>!#p;_cN zFNK$70c>cXQVKJ6mcwhE0p(Y1(NtUJB~$y{uRY9+HE3Y@=rDNz#N%$SwuEcj)!d0t zq=b827F#L-4yEJ+Qautt)OCw_PHOT`cdxoGSq?xJ6>xwc5l-S&SDfLp%)a)BCh(F|6|s z+wTU%P;E%`EYq->yPi=e|Y%GkG}o-n~(SR zce~xN9}5r2@(k>Ktd*y7c3@w?UBmL=N!fHT4+QprNJYo$&7JG?JY6pJ@ypZG<8(ex zPfyQ}pP$Z`%f&92`FuW~r)e^cmH(2(;`Y*YtEzRQ{fmU3b*JoKas!#NZHliu_TaE< z*wGE16J7%CeDiBF%*$G;Rpj~q<}x&nrfIrS(BzM;%cT?+ z8Ej|F1*y49a|3?a=?%(ELWHZAb7car{AbURLDo`euab^eIn_-(?e=wT2IsyVvR+$r z{iC^DE{IX`?1+5TrgpOQmMX}CfFyTys^8Rqy`%7Y4|Owhh+CS{M!gTO8sI%Y;EglKYctZS z^N4FfjM?-+kJg0EAO~g^B^wxbsJ&X@t$0=s#5%Fqa5)tYn*M1^V)d(=S z8k}r>(7^FET6`<<{h^WhI;z{gksAO`QUP$ypJ+J;Zf3m7ccYE3@*?O}Hk@5KcLQxL zsP>sgLtX%(cymHG3v#AS00y(%T+Ywu^V8+LJM7Kw2B507xLcyt2gP{>@>%v^Bu2vMG>g@pO&w9UmRk_Mig*wrqOkM? zYxi(Syclygkhj)!8iEi=x?QBn!6PsM5loVkZ=&FKhIQ2i+zJy4cawEsT4n$#h(Wle zP$UN;jC#=&iU4NeY3%PIfk*(zlF^PRdVG9-dU`%TPv`S=d3wGqbD%D|q`)d-yW!pJrmab6rrD^u;iS9kc0tUu`3q~N zHz;QqZe*g?=V+bL;Ww*W7b05i27K>#b}nG4%0zd_Hc{?wnJ?B~e`N7p>wH;eZ&E2T zvw5BqyOT)g8_PsM+7)i&1#hCfTOE^`t>JsP33b`N{zk9t-9z12$*HG)HzA3|mi7#r z!(SV+Z2YVFQdNyxwnYEAIdmpMXv3G4OhSOxN5z?7ngNAbRkp!M*3G5VQc|mTv$eMa z1jCKIE4NqfR?$S(ygIa9kI4By%fNl{YEHS_Ygur+^`>Q@Gt#fdsK&UAaP#f-s7Vj8 zXD;U^g@K5S!31F|9PAo8i-6$Kuz;A(PBV8kh~yKXH?M2XgpndV0HNo3)ON0RRZVKT zW1BBGa4awahR4Rd2icV&x{3#pLPVI6DHy3R6E+nkAZS3u+;-0hXj3qv0AkwugEJ** zlZQdCGSAX?4 zzx>sB*bAZ7Ie^SU1cZeMBHY3J`%&)3aesfhdw6$zcsPCa^}8Q^^YQ(M zPJQGcjT*$WWx~H))U(#oK3;!^K7X=S+}nI+?Qq9mI8SkskK(G5thBD6!&hR_IOip z2jst`XroYY>rAKCHOUu->yFiT4uS@WO30?GI--SSF((lQ1{#iF+aG$J`-bLjwCT`L z1Om7G>1?v)LU2uhz>SLPWxm$B!zFT=hw?_r0$@#ECx{JavF@p6m6>p0^Jp;vi2?4R&8!1ZoZwZu0r2c(q(2>+tX$P-qN$-)dsfJB&ST_Mw|UQ zV0e?l*ZLXllQj>bn>YJ9|9ktHZl%{9o)DT!f}Zi59b*xpup6oV_AO*?&-U@$K8A4B zuKSkSv3;4ek?E~NB@ZPU)|VPv;f}xI*~=`IK0T$U|5=5T&qS5JQ^B zFt81z+}ltrPjgx5S-3-r8D8FuxUpitD1Qli_E-c-cE8Xa!Xej(Qi6y)NnU}b5fRA5 zG-d+Md73^yeg5=#{QE!s?Ym+B$M4?#;upUV8!}=G$jy|C5D_w&>U!JzrV%B?3=|Qy z2L+`jk&vPTQ-RPCtbv&z^^ytL>h~~dByOSi(J~;}i2@8*umBYyO2H@Q2CSOGkOZB# z@_KV@G;mKkh5*(;bcCQ3=}{0mgQ2&Z8Y8ee0q&TJ3?oEFF|}ygXy{oWqH(u7old*m z?%R(a9`5eG`s%9>AMZcDe|Y!q?(Tj+?&!n&0T3|4y{apK3KLP$s!a~sCn*tN?nL4S zs@2SDwRu^l^SmrN&&xDTk6)g@eEIVD_`DJ`K7al^FUvel^Rk#~-a;NBUeo-Ui|aDf3^v<^pgqzAEAFbbow3DO2dpuIngd7xZ>M4Owfog_p%DXK!iEyQyT(d2 zyWkpd8yOec$D*XVY`fOE*VejFA&1D$in>)(L_||=xc@7y*TTb%nZnz2&<$Gr6fiM_ zV?~RYBOqy)rft3AwiadTGXuI?Fv>9O4u}0Hqq{DPPIak^r#Ef8)iJZx>hAsYCe4@& zq+!kbMC6`FlT8csm0@NJLuj}0OJnW}b8(}MtdvUu<1sEI|2Q90J|Cb%5D}!^NYjhPs6#VDv27E#>321t@MEO5J%y>4{GFb8DMK-wYz- zCp=)2gLGq3YBI6Tg1)voei$l6ycSVf`%=nYZ91 zFA*p|q#)a9xNHSP5CeF++Ir?wGu7lBWvkRK-N2Y1kQ;6cR~A)& z#vwd4kDk#iS|dl9F4y1<10XJ3LV`ftAk^(LPmj+}#C-Q~`ta5J{eH}LF!F#zKxw#4 zku$EAFiQOjKw(bno|~5>jr1PYI$ZahEZpm4FjR?(;mW zE&0o=8U)2Ebj*;Mn_K_3@unWKgBLI@M(Zj6wR-c- z9KaigXsR>TxX|st$pDG$9ybwC_=ud0+4ZT*uU!Y0FMb?i=C>r0a~z@+Dv~{a1fXS6 z2!bGDh(NQYMdKo@?L}@lh}iA+`~CiSyxWyQRS_={QAP7;xg|Vo6U|WxNVuPDhF?+Auw~vjQ}=zGIZUKnYbUnkeNv&2cp@o2cSX9`7*hy5E`PsU^l^* zqqLQ*=bsHi5G_1qS$#SlA`+e&q8A!wWa4PntZS=(YgBz1T%T|7+V*={cfJ~(0wShl zsUJ#iD@$yX=}pA)rkuQ)S={iaUSE?fj!}rCPZ^?D`4Y0HL?*?Seb&@hO~LyjN@Trl z@;lsg{x{u%_7|&&^12yN1F+v5l~xuK1-!;8ZU21z%XVmfBTjK8qrQxzg&QkiYhW;O z5lW$xo2phfGYiM1I%3I{Fje|y;X%Vtpyi}zj&CFdnMksI6G4dW%@Vo0AZ>dCIVo_F zf*1^(+$4o)Ok?5oglZ9uZ;M;y|9VX*r&@V+H#bH0ThbYBrs2tkO# z6jW^g+VC;C|Da6_@Z^5 z=UMCJJkND`etv#BKR-V|KR!R7&*wTV=cmi%GJkn`JfF{XNlbX#M>SMqaa03!Fd#(8 zI8wSQTq2r}i~=J2tF~FT*fh4HkF{_Tk&d-$St$MBh3OZ|GQN`{VpG?yYeB10UXz|) zAL_3$e=-6@_6}Z%K8O_D4eHWUW>JLm*jDoiVMY<^$u~_-*%x|XMgSoXGt3B@S}PF) z5h9l|ZuQ2gI7u#bQ)VCu$%;#4q#{G1WRPVlQJ8si9kg!kwK15=*c*A;wlldx4sv>u zENGAIHoW2hd+7t7Qj1&>uPbARD-jWwl5=#FoZu7;Yb}J!#Ino%n5$k}tl+ds@!Oh? zZf3v+0Z0)_t6P#<8I--dKd&WNmdj-X_s*?Q`qCdqq!# zzuA^YqK&Y~U+b;5lh>^nZ8b(WWeX($3k)DX-|U)FMv*cPgy2}iYkhGYas%!r-OZK{ z*K^wzTyt&UzuJHSAdQvoUUkkk_$I&Bu8J89Owm@nVK3fpz^}-cJqxfGR*WQhL8!qU z*H_b6k^mlV;aQ9mf$EaaMRluItEriVb9F*k-)wGci~zV2<+9rVk#Nsjf~ci0p5tvOmsWQ073@I{8?CIV|)!z8HQmEq}ggaz!{*nz1b0g zIjh7Z=>@iehy*dx7O3GGo*Dvoo96k;^V6??^WDdXcMl&P{?6a|?aSrzI6VJv}{rd48In&&#qzVE&tV zp1XZ00N}FBY4ve;3r!pxBWNtNX6|U__cYeMW+zw>(f_2vd#b?((qa|7p6Wd^m3wkW*mPh{o63;>q0RU#;X4nS^O>@blL0W_C!q7biT zG!mO>b&Ckeo)o1^D)2R?0|1#aF8LZQ41fXZ7G~br7f6(2zIESPgLk&G+g92zX3`#c zsAb0i1CnT;%};kjZ^~wHNDUo%V;oRVI8K@m5?H(OHu38P00IMvkp)nLAPm6?LwNNH zUmqe!4uV@wg!;&!Wmoruu{RJQMj`~rfdvUU&*klGO7u!^-|>Ff^uUflfY~{7%nTx= zyk9+n(mIIyfH8DVzf-8i=#B77=37{??HP zp#T#iQ?zy@HWn4EK@Zt;E(5!>Y8w7?1;~(i2+WimMg|loVS-pRg)$zH0}hmIcUyZt zF*4vWWlOf(pB7N}n)AEtzBk9Sa~qeXb%KalRF`O-S8mBn2mxZrdv_0GqyP(5pXU1g z=jW&A%lqTq$8WwK|NOt;cg|o|m;LeN<{FmrWMN4na9WyKMrLW#G(bU_U70|#j|ZvE zjDSEQGVcenZaE7KMkg@9^nDQk5wnz9D}W$iAUL&~Fo0x$yCSi61BfG)3ce^)5VogO zLqpAiVk8YjuS}(ggtHsF(L5_t5!n?Pg~#**10jd+4*TPAe?0B)?v5Wmy#M-}_xBHn zhlkU6kke^@I1Z(x(+dj0v6L`1TT0FeeE|T$G}M!8)M|txLi4nI|K&5WE_J?~r_1GX zxm?cY>3lxVi>mt5)ARS=fB*T@<1|gx)HT$ryDr&n?F(G?4_9$45fKcTU9{+hnLR2~ z$=TQ{L7(c>jv2@+g^4IcplWSFq|D5+Hjq`9-pg&BF%d~j#G3Qtp|zTMon|{64#O~Z zWeqZyR9U~2(X4CwE%2|Q8#w1Nu_8hZFaR_R7*NpB9X*3@b=Ck)duz%7F^H+{A_x#+ zOj{AMmBQm#RJAVWTI9Ij9d_*I$C1Cx&*Afa$E6&mWd`tZ9MQnctSTY!z~dmL36343 zs=~5B+v^dC$d)-M2$U&L2`EJ55T;DP#0C*otJgwYn0LDzNY@SKkO9CFY|_HNuh*)r zuz*Od|CYcV3kZ)Ah(J;b3Lz38gefzV6sMxZBt`9cnWxjG-rwI3W#I5+|@&h6mFijI%BTmS>dCj54aA>4k6AYH5u{5@PBs5z62fV9KeXhgxJ8n?$&IksVe583{5na)3dQ zqeBor!(h z2W}WNl+y87*?}-1Osi})tERhQOe7Vi`k7h+;6St@-;>}kM2zUnNql4GgarizBLxj= zp{mTpTmVBWxZAQ|q6&eCa9{*v_Kvmzk;M!)HLE5cm z69Ev!Fb#KoJYR-E1}VwB;vzQ9=VfLtOH|F=MuZ9q0R;;>2+BAPSMLK6F+4wA@@zhE zuQbrj9Eh+C0vOJLKt&iZ30VY!j;cT;A_F2+Q$k_DKrA5URu%L7cD^h>|K+b9{^9!{ z{nl^)^sj#L-LHOG&rk18cXM6#yCdxP^IT1%0y49K55q1ZET}pb-j(C1%e+jr5K#o1 z2|)UWlU*1P)x#M|j*LC3sk`&>WC0Tf1`sz270kNBVoR6@G8Go!@BoAhG74j%#>^;;fha_d9vancdR`3BX1~m4i!bWSWx3Sn zr^|1a_G+e!yt#}?g8 z8P#-ck^_J{Cz?Jjm#@En&(ev_-(i4nNU5=fQ>xY$nF@>;LN0`XaXEjf%LJ|w$-YyA z5aKlL1OSCoG|hUVH>Kf=(*afMV)HyBY39;1MnE)Ih-yR-Py-ug9n~ppV3uD(0WD=P zyb$N{+%uG>r=_}k)-Km(ECjYKlOnD4!3BfXGAG+Q{lnt!U}WaMO>? zIxHGc2{RhYJ2)^;S0bXeG&Us$Gn#oW+#-_7)2s6SDmx9@@X_9cMSE}iT={}IUh>EQ z&}I?rN0XK<`clc9gqGJCSpZO2*65ZO5;N9t0CEV16jwp0J2*0; z!abaw+=Bo)Fd!JxLK5y8gy<1u5$kKln%{>gIv9NI>vXAkU<9~18hSCW{<3ZGTCKhP zJ^P|S+!XTGhP0UB87qIT9R`C?iGcg0I$x`0k=@yk*&-u=0J1PkZ)z}jmiFXC>eTx4 zKtVlKFEB+3)S9#{GV?`wy#=?nLv1uI7ce3P7y|a|pEpPwUWLQ7R3Ku8Y;GB#Hycvx zRX5nEy9X-xK#~#x+$is=w$W+7&d|F$FxMrY5o+uPH-iXmtC^}+5dn7s%B7;Dzm^4;0$A zk$W&9CvL3P3SebO%u9v}qnW9C|MDxz*(_E1nTtwD5yE z?qLuB!3Ig6Nc|v36Nv$#^bL5+r(30J+Ye&ZA|&1mFpwf!=3Di9io2Uo#%WoUhzhl2 z_h{TF((0{gfeh(ZaR9I=gBnD5NBv{N$aiUC^d&3ryIN~9%&(%q2zMW(tb}kW)Wju# zB)oEIn2Vq!^6cs9>GS8$pFVv$?aPOcU;WPS{LWvv{pDZ%N=|!MLm)7Zpy=%JM4GvW zMj$a^b;`i+-#>iw&DZZgJe*Fa#8=%P zPY)l`Ei=7RamM%eYt%9 z>B}-LBxRoGskZ*}mon-~ld7iBtl9dOCa3 zqNBsHi5o-~{N+OLt@E}SH?G&P)=CV*L)Tom8>p)AkXtEIgrkQcu!Tq8bSR(fK#OSa z4#)w_SBQ!Ocy(jM5YF{$Ro;S>)hF6M#1=X7c3kd?$k;B&!0q-}Z-&=})Jv&OxZ73$ zwYF+*5(cw9V_LVn?DqR_In1x?xi|4l>z8lC6SrXJ_4u_#bFcUF>s@&($iLZud;C;z z55~T=e!*?&)~s{|*Op;DNo?u~BG4Unqx6eY2T16EV3)h1Yov=Bp3nh#ZLibIlLlB8jS z=C*Wq$re4t5;oNtnIJL(u(e!Lgoh-s$#A?u$*L&}x(`H9N+D!}VHgIr*c`Jg7wXTS zAAkPypPzQ)`}gnp_x|DK`TR$J^5^gF--mgCg?W;I!93?gy}#$+Kmiah|4S@#S)Uo-TEo&-1xXb=Lapzy7s4P_PBoNuSP>R|odX zROeZrpO^DFyU^1#&6y_MpYbLzW(On_@iqKlyU-_-nmMki|7BO+lowxq?1mIp* zY3@yW{LQA@Ujy_A(RTahe_5)UH7@V^|E9MU5W_mJE?U+ncmM>L_f}Sm7l9WxyLQxU z$5j#{NlBy!xNm}mdlo%(CtS;MiI)A56?^{y=nl)Gm&=?^v3b$Vm1|1xXh|nIfdv3y z3POwUFf|>RG<>erBHU@7=f%_k3{cyFvYCS%DQ{)(G00b>7|=C}svjK8!8|!Nkk_-t z^){|pkT=s*TUg@-Al}^@{DwCA;kS@mD;}~1(7I!ULqfdW3{@GiA%`f%x`CVQciS=w zZnn%7WZ#I#A6tlE4N2B>{=vuJdSzo;#TCdVdPkS>4 zcx!gL*{2&;6q`CUFGpO75s8UDV1lTHFBJ>D# z=X@rqhifJIms3Xd;wSbA?)9bK6vx9L76!03ywp_S;|o_20Pvs{xCetGnb>u>~pSWC{Yo zb2gPX2$O;!u@DV66-SNYR4SEfkOw_a&(&>S@Ojc{(z%8@D4v@;gKe zzDnzGqz5dI;Y6GyK_Dj9z#0*YDZNTd&1PV&HRFbsWii8AtJZLbrZ(_AT?7&$5OZM? zB!EDVcFI6NWHvJg1P6oQZ1*`BVD5zBpqYS@wLQi)Gd;o$kivm5Ec?$Cg3xwE$i#;Oqvwqwp0b+AE~(o|GHjHWMjt$!@}KHs8Ldt|xuFrVQaNi{qvMz4__e zE#ykwNCgUFR&+nks|5 z)~MBLb)wwQ!jY0GiJc_Sy6Ol-NX*^Tz$Cotm@}ed`;oQUu^ZKH{9wW@d~svMNZ$&# zC1^U|lIOD~L$kyr&L`ZWL%K^I?>PWJRe&0BLn~o5JR+Kp%GOCZz<6UAr0_wRdYZET&gWootAl-mgmd) z{PcX8mM`aJQP6pswOXC0Wzl7sYd!3CAHV+g{r$&Z|K|I7`p!KV(F2GJV08fXPz!7P zYgSzn@Y|x@li-bM_Pjpc>yxvFC2ad|EteMr(XJ~3=DFM3BsH3bxqG042>uq0B@6E=W`R6y$^e_JbcDQo46g#>%eZNRy)}*$(hkyV=PhJW{ih!44+G}l@ zwJ-rP5Q3T;RCPiFfMM9Rq6fJY=Ou$^d|2aVn=~{9T9%f3Vkac?cA{|zE&~!;fT{sd zAx36~ASpSh$}w(c&=aA$TVT_KphsfKkaHV`^zl;{eE_EoqlJd0x4ahnt7{nj!WAmi+@}zncnvYvaxWaXq+i)2Ubg z^vxcuZAhP*IZUPqGkTy$YR@5n0D-tLQ zd)pr8>~==;>j7+zbm+GIK#-7$3t)JtrzJ328;?j3-IGk=*u>6^I;#{Jq(~`5q!B|e z%G(J)b(GY2VFVnAlyRlLF45QoA_NIRnx?6gQUp=B#BLW1Fj+MOWXcR8BgA>GfANdI z`u4y4`MY=TzWK>-|I>f^zyIU^@JCiHAdnb{v89?Zr~x7|J0f87r2vJyC;A16Tc|Sy zIhZPEEOP_60Rb~&xI-{F0f=)U+MyhR$1n;RaoD5mXxNqgVShLbyHN@s96=K+ib7b3 z2EuaK?+{sJ7>C{6-Q8DTef8DXAMfu^-+cRUJdF=`M+1Y!XY z7H*OW-bff>8dh~#RMqFHPSgDSd^tZ~^;6TlTx#cHfJH>DI?uJ%dVl}!!-uavy#M;~ zd3wIgm&;5fRV`pp)w#~gvP{dxtO7bfs4o)aC;;wI1Jt0E;3<;4A-L*>3;L=^^*1$; zjYA2|*#^-}=K$BU-pz*kI`ib_;J?+*Y#B+n!JMyFw;P7=O_Q*H73c07l*Wc`z$G!O zn}v0|7-e%P(ajWKFY{>W+VW~C?y%}yA_7UGjo?%2U_pX!HE-7!!^|sLsec@lj{|@w zgAbrEr{XZ{QE!G!l0XGV3l9$^C!h>Ob_fJ=bPNg%3+4B*S5NoaFr{;#h;Q<$RvXgIZJgloo9+Mg%e%H}o39hLcP|k|`%8cM zj%dw?Xa|T_Q5-MccoRm)jok8D)Hd-sZo{VFWt;sb7I!_z^wtG!JMe2x)b=8;-L*9q zu%Y#@ovJ1?M6B2h&FNueUFP-sI9wYZnI`85%-ql#ts@H81O;5%?Zb?T|5_?6b*PnxL69(yK{aY7ixc27&%``U%g_Jf7suoNCqMbgH(!1I zU;q9;`LqB0X9P%XBu_cTxXxvm2*9#hi~vw<;3ZBIaPJj3nj#=_a3@6@B6|S~cW{sZ z2G|FUL`UEeNoYLs?ojrJvOnza?oRg)`~6<(B9sCZ#4-;1{ZV8H$HU=pe}DhYH$VFJ z+poX+>Z=bQ-#t9wVGjd?6et3LU==KFD-Nd}SSV!VP%g!pVgcr6b+LJ_)3l^iYFX+$ z+4($OE|XSY7M@ z+3${sbh$iD^Ld`1m*s3edl(@g#V{s8VfIi5Lvj%jrseqpQm!ytfZTd>(y%s^HnEJ9 zoTG>+rK|v>&AJnmYA4JSw`>FEwkpbPX57meGi;_r4S$iQy_?kZQp&PeA3De83FlM~ zijb=3*JdMe`$N+*lup|HexH?|G;(AhVrCR>XVncZlrV}2M%vcy%q*o$b%|<8!>P3j z$$q~d$5B<2Fwe}Tl-hp@W2&9EoBg^UnAtq5suGoaJ$Z>T%s4-<+>>s;Fn@XkB1^`b z_nB@)0JCH>E>v@QGqbu}gjq<0`AX;|V#YF#iPx6G!!R(TS*>+W1L%75q+-)DJh;Q0 zJHfG;O)VVJrEt4G5~Y-$2?L18f=HtE8s|(zmhKAI6hHUGUq-Zu1yK{t7!m58|7IIU z-?@yqy@10oBoSh*)zjsx=ZO?;(!xFx}?$2OxZixIL2 zHzF0HNRfgy&H#!m;b>M>9g+9@<1%Y0$m~wYQiLd3@jEHv0E;4E5fLdhz|0o6ZN}f) zjaGF^wKxTlFqhECca%U-X4&tLhvS}^=jC!bJ-BNL9LEtH>SESh5aMp(!HnO3dioFl z>5uov(?9)Z|A+th@Bi>W{x5&1x?q5+lJHckX~ovwMod;~fV*M9X&ig_aey23>Yj&^ z#PYBpkw&T{aT5n-*~#tzvNI6i1MLpOu)|?r_Q&1vu)n*%fB){`{k!AwD7F9&JeE-o z!~Nae$FIJ6|L~!V!|(pRzccKH(_z0mjJvUv5yk&6(jLyt{ z{_|ga{`{zFzxvg$=XoASYT#zoc{!`i0ZW8>%%%aD6EcJFmSqG6Xb`;3K;1;u!rSDa zP4U|Ev#yfS7M`{N)b(Udc(d5OnTqwD7<(*NTp>PJ9##%|8Nd;T2%~f@IW;3qGe()a zBL!nY3T7s53A+i(e_126arNeq4&9Um?zYCK=PSu1%9aCh6W)n#eMXgFhg3MVe?tgK zcylBoU_!;%^l;ZTF4y8~$lZpIxJfKboK|)SEaM8ZG|%4?>|bjQ{K2yCHsr^_FjZ&a z#98L&_^LHHno-9cDZSuutACC)>wbH#y4G{9=F!wiTPfd_y8mJWYtv0;k6a?xsHGQ> zND;}(Wb4O$ZJW6PBCg$$8}{=0apbvVOMtqWo~|Ft+REPUYHKt6br1Zt?)t_+oZ%T8 z)9owZWqSMwRs-oaQg_|#w`qy)n8xt+WYD~%{q*))0=;d6ZQpo)$?GC`t-x;@@;@|$ zN}lj*r`GmNe=W#7()EzG?^G>C3kU`xDuKWx#OwDdrAXgje`wj+zIU~*wnXl2XK?U5 zcq39oqjhEHyhy24*MbB9RDJc!ZBg5RAV>(QK0*eh0PtW3_mIFqK)}>?q);^A%~99- zbVRdBV`dtHN6gD2jHML!(AhOK3>=}z5MeCAMANkV>ibWho}NAM+i$=9i$DFdX>k;u zXGOwN$~;}h{m?JkCiEqM!8k&IkWwGp#Kgb|!H$%GW|D%)0Xz30usDywN8kad;BesG z@p%89cEkSu{&aVDdN@72e|PtAcQ}9u^TXZ!S06vV|M20PufP8BPk!>v*I)0CyLb0U z1%v@pb%#I*LV&77iqJVYfMygS;hNGlcTm-No~LP==lZMfKFwN}%kq4g=gVbUYG_#C z^gIQjV5w%)^Zax<3(5#cfJipwX0#^emf?3R;(xW*=a$)G(bIQp@j5Bt zwW)tytn=L3x0xIeHlyw8bV!fBdlLH`GshFC=b>qax1r}*8(A=Nw1O=Laf7|=X(R2d zfJ7+5k~vk)$`A>TUA-|IpK)j9G!dtHC{pA^Dm1au4g?OCy@6Dnu%HN;p<85vvK;_p5sW45DBe)@@6SH*%n@Vks zK~E`V>y2GcTv>I!ws=AxVQkwT*T^HXbbPs!Q+8)^@(TS7(ZzA-#K4}T1Od!4C|0xS zcCaUskPK2)*yIhY_g;3bSC!BW1NpVhW-AKI!^AoResg+qBW&IdM{g2}en^_IMvPst z+l*k=!b%{nWB5K~L#9vzgiV(?GRRqEpcZ3;{e)*kXka3=zO^ha*BS5|XM&COWqt2! z`M4dZZzD=?zSV2D;q{1vblWH2*w~wAfT)@O(1nG-(=U*i)x<|&kG*T{WoSu-!!Ynh zE4OwmUQfRICWj5)449-4cTWa8_3)pRpfWK_&@h_K0Y*%_G7!<_GOI2bYKF)jZl)1P z!fgf($Vj=9r0W|zcnu2c2a6;d5fE&|o|^|PdbP7Y)B)(rvdD2a3_FqHHLO;3Bj7x_ z0%Jt{=F^w>FMsjPw?F>rH$VA1fA@F4|L!;XpZ?_2^J9xW9>%BXay_!FL~B4{AP50t zh-~yXhfyktkRUiv0@yt{6GFp7z({4l@kqmtrHqHucsvb<<9OQLeYk)B{@wk%yZigy z@dV=t^85ejAAI}mw?F;qPd|SA`0#Lde}CBTfh8R&85<3NiV;K*q0B~@0`Y{?m?{G3 zvS{Y)PSeteROj=&)X!h0B<0TYyevyytVdRZS6kf7;@ZosX7Z4RduyxnM}3nY;`fS$S~)~Tno$@dLVO7+WV8TZhl*BLbmv}Hp=`w z+BsKaE1t~zo(Q^)ttEyLky=gt{p$_*wXw2=on_&R4rl<;!n@c50>i>RpayXM?oDOQ zJxnR>>K-lsi+c`=HC{TwgaHK=Vil^@)!cK+2xhi&^!vHQ5Rpj`(Jjm?Uw5fCa?Rt{ z`Zvi&c5nBUl$>3~4Syh8uUmaeq7L0%kr~~AK^pdXo$n$BP#73S;Gsp`eq?`b0*lZLEUCgL9=3Xl!06B}@EW$*;!Agq0TCkc zJe`02-S>a~7k~NFZ-4X;e)5xl@h|?xm*?p(|LwmiyVEcX3b5Plym=Ebxq(PQ!c170 z$$?Yk-RwrH6^O?mCM<^R!4ZNef%`I^5O+N8%i&mdd)e&{_YbH0yAU|s9p8Vv|M2nd z{$Y1G!fu38K>pAFmw)!*!-x0p-?g&ZIKj#iJnMe;tTiAc1E?zO*bv0 z%nqSQuu-=gy?K{FBY<@E%^O|lZR|`B_w_Zjrf;Ho&;vwBGRDfZ>V?fhoR0Ml z+(0BwW50PubUK*VMk_=BU}Wq$TG4l3T#>+1h!xesRLv?eVv7EfiyM(;bPMn6B&oy38;OjZpFuc`HYXK_QC-x8>M_An7hcx&L<78dP>p<9to^fe38 zx0Ic$wybyr1aN?d=js`qBbmiLXTNk)vEkP45`MdPZZ(5%`ir(&fj9Q2e&qL-G#c9( z%}OADZKZvERDH9cyy-u`uA#S@@~w>(0JpDy+tptKRG_5-WR71>k0bBfB;O&0x!qi@ zRgrYlE^gb>s{_Z)0b+d_>t^=m2K)wsG=DS!A}~Ot`4qE@9SjlR6pr8w2m};C0j>t% zo$8QUWylF7Ff}T%d$jcE7vW3m^!LV9@xoO_(rZf2L~WvsS!%N}eahT;&5)?paV(~LwJoq>>;d=e7j(k#9X+4o%(Rr$C(1rLDYP%y|r zKnn69h6Bo8_Q&!5v^yMk$HU!+cX#jZ#{(UYyZ0Xt5ATNK0m=vi0}{yZ{p{Ou97V!R zbNQo^UM_=h0!Iua1VGOSMIKe7E;Yl^l0daA`svfBX_}s%p3djBy06M!SSEw^@0anzL@KfD2N z!9Xv6oUQfWCL=aFQ+hKb%Ip)5z+BcHF%m|RqDb?alj8{U=zA1mug5z54-g_JsnTb_ z5MgFDz$3`R;OYVJmSLP*g~pm{3~ikZYxH~1#%a~reBj_9cd+bkQOmpu&n9QPGG3qo zdR|owx$JuTDo?!;Fz3f-eXoT65oBX9%vz1I9ayf~nYA7Fq6Y{R2pZ0T>(YvZ+4J)p z0Y^(%TA|Yp9!R~ZPp|!~>vVnl*0R?Eag_mX)@XPwL3rtVfwXsT>zg-+tgH5FH59!j zVXf3c^gICx`Ul7ZFf} z2=qY81V%t`uhx6TZC2Vy<_>Lrh)rfZzqsIA#oTKuOSguGTUNS&Ac#oF+sQ&|Kg&Rb zgaoP~k{MiP%bHut*%&7xh42`IP~F_Ul2g+7FbKjS6k@?B(45=(pSOl8;18m1Rzc-z zD2VKAJ)bARCp;cShW&20oa^Lsga2EY19CyPPhXz?_)q@q?|uFC@Bdf-n;-r3CqMhy z&ptm--+lQcW%rt;Ptfim=D}RsqXZZsL8Rof3-Z9c4;Tz6c;K?5vM>8P9u9}QySw}Q z-SM!yJG}ew@bLb0cfZ>m@a~QdM;J$7GD2kxk#Yu{mkOpqBpGJ}08dZn{sBNv@>J_m z-Iy+uK0ZF?UYi^6JYVK{Ug~tYT(X1FPSsA!#E2E#&(r1k@##EW+$tazAqy8m8A?F) z@C?$mSzWQtORY1dzZ4-{^D!_Df{;>%QV_!;&d<{_FSb}{o~Fnh0*#r|IF8GA1tF?a3SlV+G+YnyC#H715*%d&Y9OXm*m*auUa{jBFk zUrY65A@q=dW@?NVsg$twj1jdUiEZV&rkeNj3Nf^ti)Db-ZfKyd25=dJU$NDto*!#vd21o&%U^_w< z8M;5JH;SkMWD^^e&%V2YL9NwQn~DWVgw%})N?{;G!D*RQwSpsH7Lm`JR~j4@(j~T18*&_~AcH{mujQjC;8g}E|yNBb${qC^e9m@Ut`-cz1{s7|$`yC8}G0y-K zK@A8g10W`B&k^0dUZz@W-S1ACc?9muY|FBo&*$@`PxJTB=lSvR@%;Rh#C$Ug)5pip z*<@B#i##@}8Cn%YaSeAADL81v05u3$ z-K;9I}@v#=%t=4^zE zT7)^WL;6InpaUahGIT@^mSBnumCBTpa8M_1A>;;>&?^YHL}CIGx=Tc$M>v3nXJ9U- zoC7hyqy3rI%IRhQ@J)cx+I^)60N$*j=}e{ErlTW3-GVv5Apo5aEW?=000=C%iZo3| z9-hpB9Kpc_gCHP7F08A*TKS7FwTbp91WE-kiWgcZLYE%*(^JZ3kvndPEpdv}6Dz3R6Vsg`*)fh3|R; zP!~|-fOnnL1^{=wj-^PcpR~3!;Mdyw?FhM@@D^YPq?|(lS-1yTh_Ik|7<%HAuVW`$ zj{*pY><9$xXm}M#^@j5x+J-N!Gvuy07i%>`#-K&_{s1AB+-uXcD20g;$)_n&UfQ9y zJ*&#W4Qs8nYUIEu59Td9lbB12M#11>pqUWtjNy;~h9C%PF5p(KAm$^L5G`!s-HANP z+gU^`p?5jT0Sk3k8>Ogfn1$mwjy&@7X{M*=8ne)t=^W@Fl!ER0{o~XB^2dMl&;R*9 z|Jm>VZ~w=C{jcZw^6ugE>CG<5 z#slzB#^e5Y9F990cy}xh4-a<_ce~v%?)c$dd3Xoo03xs}ARO6#BqXE|%#>q*!Uc%k zLftL=`EssqOSM{Up6BPM%a`Y;d0zhdZ+=tN>#|r~!14nLFt1PN$H&KcwxNtXjILpo zBXD}2fCK{@Uo?vJNg>pWLm5Db@j9)!>HxlXe|?8*R47H$@Tqz)bs z=3)*4wc7J^0j7DX%W^>sVFU;fU?#24gfWij#_Fc(1|Epyg2sU4ZsBTSoB}>TB4naL z1_Cq>trg97<1j6kr5Ye06^1UEg>(au5CKYTa}H%FvC?uJ$5>}xUMSjyN> zsU2ns5RsXe(oK-ST$qch4&~tPDT=(J9My*XUPH|*w8++k^4KUNrT7+dSH-RmjC9zT z85oQ*+Gt_6ESEA0I8M_X24x%o*iB_9gdt^sHJT7C6oX~N0SDkr-ZG7dIxovKbFj$3 zz}dA4AC7#OeYz}_0EvVE>#Sio41BRFBBhWp_X|wWL(m`s4KYv%3hzYNs%HBvr`t>^ z1;bh^GiCxu$J7m(v7}nli`kp26)}cEnv&cjYegV*0COwABEuk(;&U>>pb&Ax7$B)U zHD&^10V-k+RiP9vTm;CxlDh{mi~*MFY+@v&aCNOXG%ypDGKiSQG)?X4L=Q@+y|9EK z4TUbt91(?y*>#@6s|U)!`{NE7YOSduXB0Er4=sfOt7{igd5Q%x(Qn7Fu zgqB$g6&LW(a5T^4C=7s1%xZ`$Y{AkQZXMQu!?~roS&^~x$r`oIViQx5aJn|#2M3U$ zSY+^)x2i7V-$xd;b1qOg#GF#{BIbU`T091UaCa0wCN>J|tl z49ETO>C-3SayT5)Fv(nq=yG|Ea0WzXK}wQ`hBL8-hdCgOQZh0j6E+J=9y-@aO0BhY zX#*2q9c%zY8Pb6h5e>}-5de&`8^m*C@|LVOSA*u@K|luJ0LoF&xI1WMN|G}(5CLO^ z5qrw%5fRC)WuK#}rbBw|wG!Q!b93~laFzJUQ+A=MESIX z0fpCELyZs*`kuU&M&vMV4P?#Xx+-<3X zvfB-S&dh+$jr;1tG_qLr5`s?4G(TUaaeo-^?;ntV^{Zbk^Fje**$IR$GY819|BpZa z^ShsX{F|rG|L~jN|HuE$Kl=4|zdV2W?l{op{Pgj|*T4DnX@7UmS9q)! zU^wnaaT3R&qJ->uzk_k_;{lGRay;#ihr{7?I2>dzvDf{nJlr21?uLis{OndBp2sO3?xx zVm&z1dU{UzasH*M-K5rZJ2Iq;VU=<9P90ynRhy~eYpVX*+awfZC}ji=;j$9>`M}t5x zL}$#{00v@_Qp!-6i6Ouwl+E}=JvC}E0)V-t>Xq_@OXLXBt~lxytx6HT)k&b?DqL%rDu@&xrt&De zuUIt*fyBTV3;{D_s7(#>u>?SbLd;BzLEufs4_%UPmdD=&{%7m}AY|G!Cz{DIFr>lb z2mm-Xp^0z(x*6mX;=qYhL;$dUyH-rqlDkK`8%cyk0&VhV$2CtSZ)^&PB)9+=qU7Iq z<%0Hj3+TcK1c-4Q5x7T@l8B7sSV{>5)y2cIxsC+rKm_9`%(CH@1CbDs&;SJL9sxBP zT@%qMCqsY{Xw|`;JPLB*(yb#Xl-liNk8`&R5_t+r0l<-&7>Ee~$si&)))s>0;0rvL z+yD;-iZH9DvtBM2EQQK&xTo^;?14F@Cd7dls+sD1*8lvcfA;a?*FXE&&wldTKl#W1 z_`m+cfA0}VqN_q)UX za5$V!hr82hIIujxc!0aZ?*2F)M?Ma?mlzq*7Xhb02E-r$!VmxuqQTwOz^kb)mub0N z=4n}e^P4Z1Y5MYXxm+%_CdVGb;mgzWJkRH+$IJP7xlGG^(RotUWvUS|j{CCPu?(K_ zzA#r;bpRO0aktwc;`w}jetrgkd7dwq%lUks=XpIx8~VyIZx3x#9VaZiXWMm)LYobn zW!iOf5PEPX5F+K_(b3%U9=D2shMCF$#FPv*4>b)ngaQJ{1qd8Ny*dIHN#B856k=j& zs$92DXbd8xZsAQ;a}RyOEn)(C9g#@}U0W4zq{O`PjS$h6S-s*LuR-f?p?7cAhu7=H z8VMjGX6i^3036w{OmTiDr?zfE*J4`hb|L5Th;6I`=w>w{P_W1DIuH$mXq34!Dy1s4 zt=Ohw+M>;`zmQ1KZHwc7v&DB~W_{Cwx%zas-whF~rMy0FfFT+U9w*Z;6 zNI61ojpp`?!FxTrz8y7Pa}f|JarWU(5T@$p7{QIdOlodsAw7#?Wk)37c)13gM3-gd z2Hfet*E^6h87QqN&GrbnykZ!Hfk!7Uq`E&~lyw9cs~^{l+I&6Jy4JB$L`%Yc!A9ON z01|+mXb$Q$x;(iO0Oj#_Wu5l@jIxwW{nzV|$Nc_l{_gdx9DtM&vIGEVp=imLaL-WC z06=PURX`T16cj5fYJ1ObL<4YrM-(E=EE(M5)+CTa3*E`Zgi4WdSB7CgqFTA?5@B1J zND}?bOx*#539xvQ?*cp!)tks5_46fjh>_fVt_xbDvyDtO+&vJGi2%uJ4Rc~{kImX$ zZ{Fam-NVDf<@xzb__J1bMG<1k`w#>F>M#H1 zk01WzPk#2NzxTVp_mhub|N57I{YQWFM<=F5Dq=~~U??+GTnDw)yNsGn6G zNQ6X&bj=wuFb;GAB5+Kau)AxuO5w~X$qlBc`5+0g!K@k@AW%HRNt*f=JJFSh+!V0s zr;^N?ufNviWe`1Y24k_+NWaOff5XD`%J0AZCS4~IH(Jow1cvqdi%602JWY@ZjCq29 zh-+q)6Z0xg1^@&Hq(}i&O0pr4A*a+4h7=fRU>;6bcn~tg*4XG%%m{Oz=b4y`Svn`A zlq?f#y(KxAS&Ix!S6JNYp$^v@D@B>7< zWm=yo-)c8XgQf(5$0_lL!eX-^_Lh~P0uLU3>_(f;GmX>yL6xc026{Ea3eznZrxui z$?jSKM~D!Sgk!k%Zcb(w1|#PffSHpYz|0(7@yBhXRcoe`VTLOpSSf&5h^%WYGRd8& zg-~@z9H2$G)^voD@F)UW)r~QUT@m$4LCG&!0XT$Yrf!&b2F6wTHx3eQWZ$QISND9f z_hGusSe|$Lj>r9Yfc+hm0fzzufdEJVd0;ZEA{b#kujMI z8(=!n%$7x;9?xICe0jcHzWe-T(OT!pwT3BzV`#XdWLw6n>0D=uwwW$wgu+DC%+BXp z>-l`1=6MC(S*nJZTiB!fx{UUqG`wAZJ*lC3Re^PT?hE5KAVi`qdP+%Xaz+DN{$Kx> zse$*va4_|XL8GVFHy<2dXuRjVo%Us($` zd9h}OhNYB1Yq2oGL}_Hbp2k)`)m9PRRkc7AH*n^Z4a279PL+(RA`(lq(4B0Db?a!C zHg(wx1wc>`IwtERtxAjpA`#(L*A3X*lhbzFbZvxvdPQVhMUe^kGiY-h>+ixmgF|4A zJ2V4xa5T>rG(m1AEFvi4{UT(aMu;Sv&>|YH)gipN36vZ#FY1drk+Esbktq@L6tamBBDa&Y z8e$8y_pm1SB4S1cgdhSGLU14=K>`n8LX!6Cv-J)L?AL-Mcj$Pd$-njoGgF>92&k%^ zpPu)-=lyVH-GTI`$xb3?N5K}cYpVHfA?p9 z|Chh~_4!;+5ASg}Jx^HVp80M(GD_i6%5EI@$MJMHoQ}uSX}8<)!282^Ivwur52yWZ ze<-^VxWHI|2}-7MIS?2|AO(bT_BwKml7dDA`HP?bYN}J6>a;9ZRb$X}u4XnZx-4~? zrswC&^YimG*UPMnnJo|=lvWEsA~`=#<9;Z^K!s2c1#PjpE}msVM6Fd-mu1PC)y&F< zYk%E25VjVG$aJgg-*`5QQt6PX0}aL8V4>K-No~H0(2(ws>9I%w4&ebr5E_B*3Mxp! z!NHk>vDm`E>)?$6a;tCzbYD#SpTiM2ThIUwpc4vj4KI^3j1Ab$d-Ktn$ zOG&p}g6+TD_6)Yr!B>2MwS$U)esffpVOM8xSONtY(F~aw!oqSpbI0bN@dzaBW)Hw< z8!)v|v}(<|2gv{(Fd18nOu%GX-5r_6VHo$ju?$>fkV3*j%tZ=|h!CkRb?&^31X<^* z*e@4c7xczjd6CeUchN8muhZq2nTu@fstSSO;B70$j6IKj1ccn)KsH!xvKC z|ITmykN@5O?f?G&{Pm|_j6pj&1Od8 z<9TTA!8VSqZ|3gqHHkLaAT={pQ`O92HnU|}q75Ri3Zw2&CHESD;hm_DK|~(mZU{l1 zJ&$Gxg(joPyekj)z#uL`7zox>Ru~BC9_p?BNDd_;U^b3|2rx5|^NedPv#+gjvBqEL zK?mI+z+XEVw#n_U5kha$^|k_>RZYESy4?(hy<1$jVd+GIEFP#Hhz3ECQY%CeYT*{W z?%|wmM>2b%T`?rd7(WPAU3B4+hjcfn4u;Gm1JdkZ;gtx-{qFAJ;qJIc;eiF1(8C}Y z5D~_41dnA|0xX-pz4n0KDajJRn)oJs9gwfnQ{SW&tuxe2ivnZ>>%DziV`BS?yn>Xm zce9bu8922v$pbNWDnk$lvJAUD$?@=+AD?}i%>vMgktm5=FN#{ETgoF5r6Fg_Vp|jC zwl>^O5^Tf!Qc5_gru^8cNXr|}R%4rOTdkEOgvImh6%9w&9N6aO*9VF-ekYka=JPz8 zSs~s6Kr+|4iF-QP=*Dz(lT4hEiw!)-1rQ89AP*|miUbG`cMRY(^a3&f5(Y?mmJ+bz z?rOw@C52|`Tk3e>>@)=l?2KoT&WQ` zT%}?@h+<*Bw%wl4_7yHGxw}_9X;C*B#aC|(a?z73U_-k^J_3i zZ?I;NlN10j&3lPOL`qiSu?e^`)v9XlIpS@HEs>;R5us!f5mO4M34+Yr7IV}=!MLjhtaoE@LanZyVl;RwdPWtg90bnSpc7=)ZJOLg)M`-@V+;1xxQvz7mH#66yY2WLd?mK^d4ghjqmE7izTFW7g7p`fGIHb z%@6emBPk++!mxlkjEFJ}$K&yEcUW;8stQ>jyJymihi*b@(}zkg@}1&ER?qhBtlRK5 zmLO>i!!W2tk7&#cZ->Z|aTTsM8DKA-l5)BZ0`s#5CLt_{#8O5s!|o)*r&!d&sn=$3 zo%hF9Nw|8(MPkqf^Byrs$;vnK6xDc&-qWa?m@CCe943Jr zKn`Gm8Rbmogox5a&4_WedE??9t@wJGJ4P4Juxw=T5ZXJJOqniHth1m-&sHV-GGrpkL)hc7T%KC-Vt4=k4Pw8 zluG^XqBYR0E6(c5PPmfK8*+dMr4)1rLS`-*wd)?L)y-vWIPM$}pa+tnljP~kGbRt+ z$xJ=e6)CsSOmHzLKq6kEVk8zgJ6a7rm3L($*`+pxIa`SlsUJp&glhqzIB1wB9yuah z&8wQ~JWZ$5>2x^Er{nqjq`H_p1Q!~XxgrAb{uh7s-M{{~|MP$MfBNsg`N{A6ga7LH z|KJb*3lI0lyAS0sobJ9Yx@a_xxglEJ2RGr%TUlUOcjF| zEjxkCvfJ;M>8W?F3bP=lm5%?{zTTxtk|fK{yDwEWa}SS*%Rv+#&4u%{)bx;v{f+}&LDKF;}0 zUHY~)RSng<-Pw?~ZHv~nloDra&ZX8ZCdot;1n>~2T(8&Odu#o``ndbHZP(?MnG17# zY_Un)50|(xz`%iqD-^(P%T-m0(gCPqW^=E#f`>guh{(*hZDT6;RYLr^@e+42kz&nb!o6M z?$uig04e4B(c&JtN+nOs3lk+4Cai4%QxS^v)5J*YlTVIw%RS7+;XkgJR z8mLV|zBL3WBtYI;=j5j{w?rPZEJOfb%`-7`a&-s}S-0IIZtn2%^15wX;BMkvQq{0& zs6uPqy&pjrs&8H(6+wT zS|evDB?QHz>o&~#^-rvN*2y|@M$iG+#Shlt+yNIED5Ri&P3|oYDK_@`2mq% zet97yQ2X)6AOG23{S6}im;dx1Ypsu$XYVqfPAuNq`tz4xIDh@$|IPpTumAPGK3#tJ zU;fws?eG5X58bEFr{Co1aXvjyk0*YfES$`ip+(k3`P9u0*oN&OwN&G20)+) ziWZ)j$aul1ccy7_L?G;@wbo@@*H*i!sDV4GfxGp6dWVPyX?*{Gwr|CGOcTJ#4Qywo z8}`_}3l>T#C3kGLF>^|Aj09s7d_P~k-?IEFp!Lu^N71@Bvi-wzc8JTOP;! z_+pGT$M?g{iD(ef z5D`J+?Tz>mX6(HV)yuw2x}OPuXmdYof8WO@ehgpQ&BX9Q;JP~~VmSFBauv~mQ3yGf zxg2i{B9ef)0U;(NCq`4~##1@R1$;CLjDishjlfix3sVZ$itpl~M4VEYk^+PEzAVeb zY3jX`d+$9q^^6W^x8-%`o4zqLq6c>fp>Ndhk@Dmp5^V0bn{m`0cIOdDZow1-rUV#- z`4+OR{f(l1b3a&>2;`_fGOUoDB0p7fkvvV)>HP3`zC21Us(wfa-&!Jo|9|Hw+?7_x zOE{L+_klJZL0kxK+&kx-v^$up285D`9DqV|NTIw{GqU(Ko?8Mm0Bs$aV!0s1jv&O0 zWN!Xz?zLTdP4~}gsDgMelE$RH``b&vBUvO28L;)n9Dy0+h+S*6hr-A}LFfw|6sVKI z_Vrr^$s{FVlEmd?nO&XO9gu=LzR!op7YgFrwhJYlj!=429T8i=#KbIS`u&&g{z3YX zxpXgzycb9xi-TjpFw!F;#G7DmFyh(Rg9W22fDt=LLE1zj5<&(JAv6I%tviZmqaQQ^hhXWQ00uOr@*2Eb`=tRsb#5D#!E5n;|^MrPI>$Ym-i=gb5uVy&VR zF(|TGkDN3jaWuCS2R;EIGMcM;trZ=-57wIjIy(5Cj7nj5HXN%Th=F31JphT2MBdP< zA?n_v$q|vjFgRLm>$hvY&dYo%Nv1MCsNY%#>*ioHXP#4G*-ZZ5|MU<4=KuJ&fByO9 z<<=n2=jrnJ_&lASPUoj`Ipc-XDPPW~hf_Kgmx8gZB&D?%HAqVh*aV zHOM*L-I;_*L~?KH3M`Te2kWHwUVDpPDswh>1W*q~fPv$l&H5%@I1qHZQ8h&X)`2v- zo6gmeqM ze}VxB5)qg)f*}yXc(M_VnR_3mS%gEA!a-yGKE3=y*3JDy>sQsh$GQCBHXZpzAFpr@ zx#K;_c0c+_Py+75NQ|cOonQfs^j{WAl#}2PN*FpJI}%`|Kbjh-IVNU8qQq2KG7y_W zSIkn})VNP6LskQ|uIugQ&rjC6xp`MYXJT})t}iby>usrZeFKc|UA}p|KW~{Csx9Z~ zUi@<3J4UA%XVWpXkJ3KmDipDjgb~F1K~sauq0bHR_Teox1O_6Mob&1QaDKQveg6FU zH$P5)_usarOvlO~paXHS^ZU}%-ZI$V3yF_v?A{6eR#kLhMl?bvQ!oSV;9AYJk6BR) zBkpdam*9UnqM>6Hj>Ld&s^~08j6h6=kO+BryC7IjL*6iqu>g_kGX}^*=foWF%)9U+ z!ozh9Z{p}UTYYPr3$P@jSQ~{)d!LB#rtXBa;|Y8u~#F zJtq;q_ZFHu0Jdh!b$cl{ky7TT=TAR5{8Af$lx|5W=XsXXMP2{#&&$94zyAICbg7;m zp5~`dKRiAEW}Z*e>0!RiT`W(0c>n=H{=VRc6U+&6hJqjr!hjyTC<3sE;5y{xZXPE; z5ec#~^{&l&t#xV3b-iBeZC%%;!r4AqlRh+lg{0m zc5qcCCPHKv@7_b6Y)H%^a7=FBbBW*OriE%zMmWzHo5a@b5Yg;s;+vsEv)}21;u^^LVCR}cm`Ih7KA`09<*)ZG?|qos_mpEIiWU3!Mf!bX{Xqu&J+g;@ zn0%51QldN+zZiLL>*^LlI7(Ic5=9EpF5+_b3 zts9Y(tAQC95r8m~v4LsZ>eg?sudVHAByX^OQ;QX~-VyV=8Hm^iPuH<(z4z+uZwMW^ zSdoAhfJ`DXZSG(S#1M#vz51c!J3%InvHErepUUZUemGwqFOSbp&!44C>()vshm{HL zq|5gyhw$DIOzuJe5Q{Fp7-XUActeSh*-dgXz-?)LbR5K@XX2%fTSyV|8bMNFZ za(Fm^r8|DS_d`_mLG*VY8yw(^uI6|sGLigkTIXmMi=9Gx||;#PR~C)UoMw2rD;mjiIkueemLQ&Ko$@L24~j{OsGSE za%V8<+9R1gW*zQOt-Jg6cH4Se*X34UZ`*CD%WYk2-^4(P!Ofbr=FQLm!|WItx8S?a zCjxeoArnyKwX!Js2xN|I7i_qKJjl}HFACMrW@K^T9+hC`BXV!RAn%klakz&$YKW5J_Y(21riI_ziavN-56R5;)y((O)BBP2 z{ue_b`N23b!2QHi%AnS)s`(KwgTT@4cO`XHrQQKelT1iXNKA=_cNpCj%!LuKbYpNy zIRUWwCXzFwau=*UCK5=3WL-r>h@GXIZ>_DjCBi<<9C4_wA}iZ00>(8k6frgN_bGB8 z67+_tW><0@4xCVa0)*(p_Y04Dv)+4mNW_4k>PMft_X~T*sk=M&Zlz3@%VnPDROWd; z3#V90h2-@a0Mf` zP(K3!(SWI%hu+uBOsz$Ml3;)A51CuEB(a1hqA=^KI|ZwCUnlL(F^p+HGslrXm_&$# zc+Sb)p;jkO#ArB5F#ytk(t>=&H6p#%*m{P z^TZ`zPG{Y80eL7BCn?jz<222Z^W)>=)2HWYE~W70ae923PUn;hPczLEs~ZElxeo6~Y(zXfc0{Dw_c|_W?4hGIdn03fFLJ)$?A{mV z_jmAd<@_3p$3Hkg4p$NpABl?hz&u9Gl1$WEi)Pjk94wVgM%tkpxq4G{96n5+BFe0X#&GZ% zMw5zh#kwLgf_b3K5Wv(NphuKK{OVo`e?YLst4T?IrRw*!4iOb+4J||S|5f<-!sKNl+nApK>z@{>u$AxP%b%=ld89- zh=?xC7{ye{+a(pi|ff0kdWrM~> zA=WS=MjD}Khi?waMM9oQf+U1Hkakoi5%FXW<`y>xLo#>kkv%i^EP_-dsR3%lZ-l58 zhwm}6f!&AA-Ld!XX3Qav#UaiJTz3#Y!N*vXM4i>h%z;EZF1NEta%(dLWf9XiwsnBcXmKS z07qh>(O6+4dNWm~p(Tl=!s<#qYCuB&{zek-LgU~8LMkK9Kf6 zJ2JE4%Mc>058j($R|GOMW(>cZVeDMcEIh2jfC>N#YL;?DEbTGZjzmDn2x#Dfpv?e! zWMhwM7(jGv=)*DSHnc#%xL=23at>fD_c(=s7rIB134rNAI(=u=Jw`_UK4A52l(d%= z9}dCyq)ETeaXXY*ch}Xs_)>HbW^h-L+HjEh5X?csl_!a~I21~$W^pr6iJP0tJw^YL-GL1ov&dwQbYhdu`gfWmd$xZp-zyEU$IjT;tH( zO&2?h;{#3egO&CJhU|Md<(=RhyRPvNg?Pt7wf8|wMN5DwB_E%{=%M*;cW!2_sdnpA zpQh<@xj6E1&Bw`d_u-C6^$*{I`_G;B12u%u_hXM*>v6=7R)7IeyWIuSiKmo$vL@>8 zp**0y{ut#NpaF*WBiIcPX%XOEP2F70BFhfkS>GD{*znw;|3~e3FG_m<>JG_IDBgz+ zLq|LV1F||d^=7A3P9>o^_bvvHX`VTk7q$Zrk$m`nA?IF5peq+xqhL_3N_UmLeB*m0Z&a(% zhe0>P*pdzfd+dLfAK#uIl z>LWwm9mvd8$3QaWOgyJNpC6u|9?nk_d0SN-flJOQrC{A9#@_4gs#~>;T$mBixHsQe zghhH6W>UA-ZL7VTb~OiGx3(Qw1WYsN3q_+Pb0U|p98E8<=#vau1ppM@s7TjAo zKPbk{ylxc;g(Lj{_E&5X^H0XfjJO%Bg<{(OEYKvYoD#EHZ>=@;<_eiAX=D%@_DywjwZuf& zAp}-7uII3%hXEbT4M01PlR3I)kqXq>+M1FZr-=!LrM6+J9pIun4AzIt4*&>^7jZ)J z0FIhNY_%K!Faa`>L=(9SbSz-ny^p}hAYBl$yLUr!!o#FXl%+whIe?<^TX#=P}Hi7En zCl6cC9_|QlJ4*6{=s9dI21eo_4umpEIa8iGKj9fyVj;#+j`r!ZLRCF zEVr%I_4W0o)@|KxwJ)`9*X7&o+sn)CMbvCvsuF`{Hql6B)0p{;^@dt-Ic2CJCax(MqI~jlhbsNqPp!fn?9O*~= z3U(t#3J=&YfGH6rVb#EhIWY@SVkY*bElXP$-ISY)TXO`M^Ng5*nagy3czF8s!_%kF z=ZD8xaIz|1qS>;pL^>r+DYe$tZG&c$(3Dap=-t%%X{OdzAU;2&FE4ca!xcF_JU?~7 zr5UXKdR^D8tFb$DRZgiJL|hR$d2G5Eb!$!p4%$t71qKGjFl8_ibML*IMrI2Um3eaa z+FQJz5uHnbr}JcHt^huI-_}~|rs@RHoSG9-A|hq3M&y7-P>p)eMKVvFdE2hU3Db0X zd~Q|Uh&?^!^8|?$897Ta@Mb+Cbh|rZiW`oIGfR<_g_00cLPu9Xp}CZv%<)>6uBHw^ zg5r$my?1S`83^Sb3s`Ltojy2UQ|ilRXepVDAh@ z5~(LV6p`SqZOlC9g0Wz;xCI62<{KZd?pO&A${{HX(8vx`?7(i13JQbXiYkMgqIfhC-C+ZBfQoTWE zRYqVWW)=o>?cUo;vq(cwE?mc8%q!YnnE`pqvK6oH%%!|^V!U6H*_Or z=8TlOg7uzrPI68H1mN9!H}DF<;AG~UI44TNIaA4!xGxUf0S(y@Eqr!}pngc8*+9A> zD0HxwZDD54%!xsaq=!%+e8KRuP>O^~asaTl^!y;_^F=ssTU&3-+I#O_mCS%hfT>$p zU08C$krPLV96oYj2ZvRg6P7u1x8A#Ubps&iz}fnh@;v`kITJ zrYCk|#MXM2obtoEp{nHhv%63_sT7bR(^MW#r}H^I%vkcnr{^@K^TT{Pm-Ec?Wb?F@ zygogaoO~)=GG``2M^A3d7BgW$axit!s_wN7z5?{n2N`VIT%nuQbz5FvU+cQH+S|4* zx7)U?*Xwn?-L_>_)pcFIeEIUrFTX6y5`+ins@BaLxS=32ITLmdrc>O&xnO zWo;nUyEP|vCPrd!R=am~1xGYRYv!WwkrAUK!TaHxnjt`UM?@tAYbpfDNn{MA9SI0q z)wsq&R;gw^ip~(s!EpEA_kRi=4Io;C2)iM$h$EPKS9dgaB*K`=#mL6p#X1Kta{p0x z^|niNL_U(zx+@t~H3oK2Hv|&*AbqMKlB*$uo9+^Aa2wt=B*!r`yPu}M4KUv`kKDb3 z$>76NU}$`x2b7r&V^O1SXrKrTYUm~-=Ev`Y?HmapV(f?rk=(SYnL_PQ&8nHY^&>d! zVLqMCm(M@`_P0O%^!YbGmeXwRpc^kYhVJg#1}TYr18txU+lsoP88BEg2=fjoV5h;> zjyn{Z_OIVwODT-Bbv30O-W$J~g1e)FgF%n{Dnc0g-N4|IApp<;OS#{ae;>|z5dLCo zaV$6w)498M2ka(I9hJxv5TPfzvu(WPNP-4v4++^BGc%JjIcPI$rV@K>ie?l*4EAWG zoqq}DuCbeaYtxB2=Nyz6b0=ZY{-(MzZ|;O5VlncG&NyY>w&3)}OWg4ngxxJ7&e%L5 z4IwYQxs!(x)RBlBscDC;x% z4ow-LNQx}b;vijV-8?O@ZK4jK0!dPqM4H)z+mOLd#Z={>n1hYZV$l*TY zPR+D$sbdDngyIfrUVBE~+{sZy2)fp0QF=!@(|8Z=Y+>+D5EsA37TFDeC3+(aS1uw6 zA!$k^g2?9H)i&+j&3uelBW4T%StJ<{C$u3(M>C_uiIM}wlAZujNYIqn%oLCUenyOx zoilM^kvyq(->O+#)j$nY-K_75hZt7|En(08BOn42Pni-Ei$_H-#6k%X(ZtLM1j$e~ z=7hjz(9OF+2R1?@aCAjv+83f|MnsYjeGgp_1a$$56bb?~!U!-{)ozZ1W$nXv!j3?k z44~u$?rZIdkyDzdljOUcB^aaTYdfZdV6`@wr#y_U%q^K{r0kLn*?9pv}ptAag-wftxL@q z0pqjeLX_P_denVcL^}2`=prJs^tJ{;Sy9At1EYk`hN8Fp=QaNAOwuIhXNVMy9O(u8}-^=dpENz zY0&l+qQ}$5%G?l%p&tNVK*{QBmlJ3_U*Q` z-dixsN}Vi8Y2OCgBeQsT@^+(*yMjR+c|rlTAv1MVkFkQ2 z4PA`_P)a;ag>zemgz52sjgm3G zVna|dj6^Utz~N^U)!3s&(n*~2)_ZT*%sma_lT&EK0Ud=2NtD9q@l+Nde=hOMz za9!$aM>S`1R+OCQd^%&Ar_)0@pXbYCI!&oan)2ykE_1$IE;8}MoKGj3XPgU66Xc{* zB1R+h5gIY*mN6d>7I|D}5EZMc?_X6l>)Ud>Uaz-p?Y(YwxxFsiZHWoNa=W#)Ua!}e zudlCPzirF9-nQ%YT9;~O(t96d=wM(0DmZo{O2R4SNm2n|Q_!|;wf0^eR1!%dtz(hq zZ?u6S3%koT@(=yT9u*p8{yXe566Tx}Bd0v(v8vrXAZ;=4z2E8$_UxS+)#s zijF(e+;;Y4RJgr&Gu779AXmG=5Z4ckmH|xY|3~X!b zRXGtUq7ys2D-+Jl4@rJFo&V~GPk;Nhz*-LrUXb&&yQ#Kr>S&k?uz;{J8o#NXkApnojv@#$ z<}>&Ix|eT9(v67F9>dUDV`hkOduBphTfc`c9ggR~yB@mn0a{Ar-N=u!)YLs34p|Z^ zjso{i8=f+>0D3brr4e+Gc3Z2(_ly}Z0TMcq+hoY#!jhN~J%zMK+?SQi(M@tHIZ4Kx z7 z6a#m3V{6(~o3@-zOvHjoh)B%aK#miTcz1H5L716SPE*cQIJ@fYc3YMu@T&*>d|%RQtgw(YA?AshF-uB`av~9a z1K$pBUm&JAr7Q`{1o4Q5(E7klFh{t^SkW>EikRHOo;J7$#N!(lS`;5?)`v+_Icy>B zs7~%k$S4j(kPOtE4Fq|T@_0T!_uRgI>y4baq;eL>)A{-G=`*F0r_<^2>GAoJ&oha0 zmh;0royzG{a^};VrWxl9dGbjhCCU;DMvNF8hLQ6`kul;Pk+7;yTWeiwUE8*{by;3tuGg2BZK*&1`O9*>F0ZTh-kVx;1QAB@?%+zukRBLfOB&L?Wz&zg@~bCzsELlZ}xqp&kj9D06d%$M?R}C z9!`c4L1?>8ew<(Qy@B;EEPbq0V}N|HccLASBP?Y8p>D0c_STSnBs+_+gr4fi-;PVy zk4(8Y;};C~g8OdU9Vuxv=q=IWm@{!y)`Y|nFaTy?es_`In^vQfd&jW@KtT5nhRDPS zC!KpXq3k)e4cwCr~P-ML@xB%Lu*i^q$N2{?fuIuR4VrA$xf^XJR?^W}Ug zjBUBSyng-TAL_Sn*!%6}Miwrfq^k&_R2eCiEGIU4kfWu!T zA_8iW8EP=XaKcu;3vSgN%9PCW{d2`ElGs4a2+Y}m0NqTxTI*N{fYMu4g9zYkB4lW$ zPGo@H?U4K{fRHe!LXwe_I$&=MkO@*6xf%qR5>Gj&YHeLmZKm{iI?X8yaYEu%eVpK; zgo_&rITe^EOKBqv>l6}8&J$5dnVE&Sq*PKi@IYpUlPaG0!3Y9CCv+6xEIDz~))Da2 z)AL{c_NUv|>mTL!b-6)TAueUsZt6NjpZHEuA7Ydb4*SsqfH95G9>QeZThrFy;XLI+ zWs)qQTGh?ET33W@2u$%JoJi)=G|lPh`IK{3H?`aAl~o;45gn5V=h#aE1Z|m^l888x zId(S(KoO?GL{mnX+BHuv;n9lyy?fff;{d?qi9y7L=v0^p6Ei1aMyBYGqemuiBoYJ` zNjXm`Q4-x*_-{U|c)t)VL{f&Xs(`@ErW8s*_n;(@lbdxSiGV0~XO6HnGV`L$rWP_> zbB?PTq&Gy!oC-wE-znSzkPjOuj{uj-`ZANQwBt5v>ebF+1a$ngozj&RK-o^=^^Ko zM4I;Atku?9(_S5wS<*BmN~^cNnrQ=YMhY!EVj$|^9wTrckQv!$hnn}u8I9@OXei_6 zz_&9o?o}Lo+cyW!2X5cK#_K_=-@83{x0KosS&vE*?j0<2OnuEfWc+f6Px?qs{^*B^ z_)H5cP9$Z*SSK-n4#pkw{=bfv=pDLmf63qf^Y5kO(a?%>^Nt1x#)vd`>g})#(7fQ!s&<=`^Ruhv}3V`u6h6pVrr}-@d)ReEHH^1E$_u{CImF zty$|)zMzAMB<2lZTNYJiMs!HT?#M_frHAub6<@B`yM3x1irj9RNDhkkeHKMzmwwL= zzjpwCNO^h-0eo-6{Q!VGI)D#el-_$I6pnFYw9)bG7^2s(9=%tt&9BMBvg4(Q<|an#;> zck4SjYX_glpj zyoV`4Oc4zrQzD=Q!a&y5z%EZufAQ1r{_god|M~edG)FT<%91Ks-@;?|4yb+Mp>J#TJ!wif#aBM(jLZl;O~ULf4%poluoD}R zgZI{#X+EV?rd)R8J~9%Lh=>C@GJ_)`r<_VInNKq$_H|i){`u#a_N8bmhz%6Xfn3-{ zASXlRfv>9MZh_8VN=U<^hKNAU%!WR8;zYO=x1Z3jFjEU72F#lCc#ofIAKa`xvkyWVzs$-1Tce$Y1pwjfs|qq z{{SwICwbf2_k?%cZF(aOj_}~uznPEsiK43d9!a!kX$5Lv95=(oagZWM93YZI=<$57 z2}ER^h=Cv(L?mG5-rC-yC;-LveP`T^V8OQ)M_j9W`5}mVTqT4|l=fLPMt1s#8{*#O z8GppFAdku`Glqy20Ttc6n~vQ3c*DX>HS|`1B&fD$%=rk|QPq*=yXO%NHZo8*QxEKjJNVE+I(1Mr zrLhMhKp7Gyg4%1hh77<6z1F@MXf6U;Atopkz%XED1nAcGr)YnE#%`%0M)l@{zij|} zK@cgez+eWTu#0QDniE3~05?KwE%IL_kvsOF6sQ(|kq8x-I(rSti5L$TUQ%9G?w z$cRjw=JN)%qvt$vnG~Vn*o4RaQq_`yurmR;5du4qg~|Z6H!v4sBGTAjd$$-f~8WM>})6qHj`^DMe^xX-R$J3?jx(Kll6MD%k zoIPo+NNDICoZP#$YOP!A0Y7sf7Lc4unPOquy|3#H(0lLOdIj%HX1Z+)&L?C^X_|!d z;Ew_Wiy$EmT`a(-|J<`WSan&DJEsmkRyf3Y>cJUv}Le@-b~PUp+x8PT4e&$;k? z;%VlTA!o{ka>DZri699OhiBaw4M(6O1O+;+b=#_S*N)yWl-{5KVZA1i2r|o!ad-`^tPUf2<69`4NuYMtl#P@UQF&oUF_ zu066V;sTC9s*zu$8s?MZzV8Oz!A8~q067X$q4VYJ+Lz@P9dpj9LfdLvmIZJas79u2 z>#emZXWP?!@BgK$>>L5h1o3eryaO$b^N!Gw>E*hBzw<`_D$Dvqe8s!L`}-Nm{U#3) z!|3&af^vW0rj*_!ghX8%BM`^D^RTeHYI86|1?*s^RslP+YrhZ4*hhkBZS#GQ`wj@I z*7>d*_KyM25R;qZ6^Y23hH;lo9GJO75dJnuR|A09%qB@4k*iQ;7`pWPNMfW|$P)>R z5W9B5ZK8Ba({F$HQQOwG>h4)2=PWr3(e0Pl#A#xlBsYcCnwTZWxs>Xt(k0;6YCtRu zJWbvmz(zPDT378O={=rh1+Z<~v~@B)%@fjy&~EBo8<+_W>Fj-Wcqn}nOV!@dOpIeP zqs@DJF4ONGpLA*Zr~dMK^Tb3#!iVnfLtz&TgL}wjJT9#@5Y?W{M*nKo%<8t(o;j(Q z_kcmVJ0f)rEhjKb&UxgEyWWHc5@sEwT@Gf(s3Y!9iN$nbDm1hIi(zFo;lI; zMNHSWZI|;yN(ov!IuwE+Mgb8p8H)=$xsDn#(xhN`*?Mzlb0XkC4u|7{N|unhAaYEp z!7-XzGebh8A!6Q1mTVT=9E_M(H+u^@-0Pg+awDdg-#K9;Fc3g-m>jv3Q|sWEjK~R% zQgdp}e)E_Ae5?BK@bKx=vj{z$rpKoec9?&tvBP6 zOXjQFydGlDJ~&1D>D1I*D42fF0Gzb7Ig`1bncG?$#Ss@7VMqc*}A;*d?mnWa0_*4Ee8t<{Ldjc|>j zFxqNdExq?`+e#_SEIC#4>+9OrH8Etu#$X9$PMg+ky;-wqnjXpn6KmUEw`JQlNjd&e z@y6D5YpuBkgK31V9wk93g&ey3;ORIdmh<^+d;Be+!R}@b1mnF%DXy`&W<9oTY>|zDh%$6chTw#0Dsikd3s)GKSr&0?A#VWywbr#cC?T)Q%eSvT ze?Fgpd|O|qBCW6I`Q+}kt(i)af<$Ir!F%uKJ+4Ee!D^29XC&}Q;2SS+s9QvGDd_Id z0YL$jNYENH?u%^;^Ev>OQUIX$rM2dcaZlH_f|C#lQOKU7`C-=SxnPRQ~ee@s#s&`}Xr6|3KP)dwDJ;U2og@@q(1lp{>>0HVL2eG?667 zluF3Q;sqf1`*XPnvTWN{YwK=|be>PQ zKtJ@32(cJWDRCCJsHLoF7oj4_TmADt{Nsf5KmSkva(lV{Sk-LL}ae+ z{_^sbh#0WM(?fJHaMiHu5`Kt#1a#94HjXr6G&B*|G2-Jo}OFeM~s za7KgC_=1lHYy`HtntDe_jLk)OzYc?h!Z<7)=*KJQ%9y#ncQ)QwJx&=GIknDLI#jmp?`bao5I=cf57ubKfQYLY#B%2Fx2e zfWIk_P3;~&{9U{Rg!=zOE4+^)-jN;e8^>R{eIs$>I}Y=Q9q`dNtC|zKdtk7lcVPz%-qNm_?_Yrm4(jDkUeu$IE$|<#IWH z{``2koWFj3>Dq|sXnRtMP)=fI1m}ZHZU&KvjtEF#pxqHowIW2uEMp8fW5otQBp%?0 zaijwfIv6tp3V;!jb_F0ejyDle_hXve(LE;K#3U#{1Sr{@z=|4oV^sm3B~A1BiKm=P z$#cqcK0TZs9?#``PV>2xayp$JPUSR}dFHur5}z`Ncur6 zhDYEg?(1nY1czE{)4FZj?RHykw{=~6-OOx>d-r~Zfx$N@q*hickuC8DuRK_q6^ zem`0?^B}#I^6qYicV-?uBpb)vd+Qrx!0SflN$|v32_V8IVAnvKfsoVvDkU6*AEtqlR1dEd62GeIyW zhf7C&=%V&_@(nZrYD8oQ=2L_K6+9`W6EomkCPOeJGvCxVHAsxY zl!S94cX5-}!W6sJy0sRSP1Ei$PJD7ez(hd+#++JS3{2AH?+h*IVt}mHE zwJ|ed3i{g^*S|Rh-nRSuKpSKA>!9w2K%u4&0)R+Xbr%p(P=pQ)(E+2`z-|CquxXh| zgj>VN%R@vWAq)d1S@#OT(I=E7j>ANYOe73wuGVyRPMFS;3er^IG06`P=ciLSQ9@gj zS~AmC?RMQN_pPtmfm=jM7fB@oIvf&E&M|ZyAja`|DH0J#VzMCWG$KdqTTKW#7C}w| z?j0NnV}uq+_LLAju0zCk_I#J8)~nsd%9$sOiapTkTyHBdE#T z-DP+v$jq#R8OLb$_IeZfRzH0zr93`8wANI+h@4K7sxtaK@#7^w%o8G-)+B5N#|-Xpba0GE6OhT$NXI!0x_doq!kEVxPr6w$s+BGOec5u3U)DLXUKB>D9C`G-7} z`8?%w$#a^|)5GOd<~)^CDdlvYPII11o+m6BN`gcnOu{DAnIO)#!1yDAnc^{F+81|W zVB3+I)_SknYTvfD-fp++^}5_{tuozh1A2i6dwn3QMO3faTlTQJB--=e`rSlkbzs=9N^ zv*_sX&OqYh&I|sS1l&@J2Ax7m zOcZ&&Fhbh`Up1zz46JvPfJ3Bx59U3rhXA(Lt@nCc)@@lZyi>@ot!~k7ini9f5do0| zDeTTEZ!x@$&p((OVj%}|5~2oRs;)hgt7>c8R33y_BqNEMYlqfBjpD_0RW=jm zQVJqY)AaK4;s~wA@GVF>v35^x4#=1|r(}RBB}OuM$E!MoyZ0$?$E9^As)zg82>|$A ze8q=shF={)A131uLx>~8_5Bpi)tEgJaM279j2r-b67Jje&wuzwc=>r-S6yGBE$6~7 zw+1lnA!Bac5S<|%4)yrt$DfNK`rxo)F(CTWlA}Vw(8nbQo>Euv0LlwH-7lKc*??Jk%Q6ot(OAQ#5mjjsi>t*}FOl$H0Ubh=C&QB0@%x%?zT&7}^d;49?vl zEsRsz&Cre9Xh;4L0BARNR6sLg5<&7 zS=Y6WT-08*wzb`At!rJ|>+AK~m#?qiUS3{amg}vxhREJ=xSVm6Zr}va-<~KQ8G7KR z;4-DmnStEVm@(&!KDBPCV5_FJse)>(b#t0#~^l+Eg7F$p9f}b2wg2M3_4QAR`*s9o6z~T1($alST|c zw+`fhTDw_?Oa#Ub;aUMF>sB{2BkxF*+||IFcI-43%%xx{YpdPuAQ$=oKImK<5dedT zGhkxLl1eGq$5>Ai0h1H%{7?V>A^Gnqus%c{y)WZ_g+>`8Xg`c6;ol+*e@`e!+#L5c zJUXf)0)x9ang%Y%g=n5K^!D=~e*g8)e^{FF|0$xzp&FI!vN%a^a_y{R_Nj``}|ns(C=+VGfJ zMx+3egVxp{-ZJdH*50D6JfBg_nWBEDkc%Vv`Sh^WMZ1-hrj!6|QB$zBZRikrqjgz0h_715cGt`+P5#i%;wxe%pkPOWW%fa-3`^74AK4qdyeWOf8o@V+GmMhC~tf`X-_c`hX< zBG+SY>z1?oFFE7jMm5Ao~WI!+?sNE6G$F?P~5aGd%@DpHnGYJ+F zF&J9Txs+s{W!2LxSKXRLjx8}umM$sO!BlHqUv*tq5t-+?lnHbT=fW{WKbR5+>~I`n z--%A&{B{To&dfj*AprrTCGeb?Or0>L)YV&SvaQzlTWXif6Cv7|b=wDup}V;!7T%9< z=C^of)x+6j2*asHM398>ILGLqgPth}NnIu?)Ls%o&1u6#1Iq1ZZwV45l=G zbbU91e$z?q?1=dBYOPzVYpu*g5`Q8AF&Y4J$--G86^IE$n1~I`+WMB@eb@X2%#ZhT zBzECQlD7t&5bNgP>TJLcu2yfWNEUCEJ9q*90 zJ_{>wr!f>8FB$h#N*Liw%pN;nV>2U$#N76G=?z!XyTxk{&ESY84C@`e_4j7xgia(m zP196zrpZsae0q9*IzJ@W=fs~+)AQr`R3@nX)wb6~Yi+HyYNiBO9vb?sw$-YsUrI_u zC8anh7%&kt^S0i!_st9t4ae@;+?#eIPljy7$P7SkXfS1gMh&`{vzxl2X$$~jzuVnf z>s#Hn);x>>d;7b0z=QJ{hpvI?2rE%WJLS}GuV<0d!{hIM`26{DR`j*52mAK8V)fwk zA^w^RZWtyx2?470=z0fI8_|&r%pDCw@6U&o9UPH>h=<_-vv5vn5}v@>yQ{T`l5AUj z{rYvezCKTvX)2PiZVjO$^j5Fy^;_E(>xu+4%eoaS?q*>k~Ccq({KI3*~FC4mqK zsW1wm_l-k;YzE-rx{Q!6|1jRz)gC?Um0M`4uGi~zt=nyBTW@V`wN~pIvyIc~;rIXb z-@m?Iw`B!$PzONm(5fGZ%Da8VeuBm2AHO>;D0TsWob&0NxyaL}&%gQcFV&`Ls(7SP85C%eziL|}B@vwfli zb|j4C!#k_VP)>=!ZX4aL%*Y54-w`Jp5CZUFL-NDl`OX=|`++M&VaTiARbN?Mx+fqwuj@nZeuv4F>Z0-+Q{^R?fuCK&e1o&02DV4t;6e znKC*X_HZji8W%|QZU)|7d+XgS zh0LuZ#>06pfqqj#+q*dAJGr=jxMhzI===Gzhqf7hMe225GDZ=Jh+ytr5g5U7q!b$i zGLp7#y}o?=`PQ_eSQC;X+qciYUJ}f- zN$;(7=qqYPFwWUqR~DR33b?>}gPf!*+W30LBmsb#r(77kY45!wQOc9#DjZ|;~=;)mQL1OVX<0PyZ!jMTp1?=U$4I)%Jz$jk`Ubt6*& z6s8{@AODBH{cF6w{y%^J-}32UFf8}tFV3sO9fyb{{O0Te0>|No_JN*77DNPMa|E{- zLC5J!C`OS+X+%K#0Vp8Msie8&bK#RawraI4%s_10w*Bc(e|q}iGM$AP)KvTG(7bJJ zdu{b~TW{XFf%i3X1LgX~E}9FL6Hmz}>_t2aCI)n6R6=J2pyBQXck~f28!JFS z#=R`=UA1+!rmC&gb-k_Yx^A~+xh~66YhBi^j&<2yUte3T=kxiW{qz?<{`liBfB5t5 zy1l;M&>^!3XNNHrfFRzXK_s9IkhnU!!A?R405$*^7x3kBIX#|#{ONZ;{>49cO{Y_P z{rcZtU$&T=9YRg>ek86ibI8xu+qPU^rxXt*-Is}R1>Xyc?nqeuX!zces|nFH5|ECY zG71(QJ{Ctrhqt&J*Sp=}{_7#Jra-&^8+go;R2A>?*qPbE@4sN~?qml5G8*f!+#aE) zcSr}=1=^#B?r2P8)&X+R9HZHe9q@ki>#;+UeLQeo zt{*PigOL2a%qp4}!e5!k+!sJ^7cjauk3?b^uF9bst97&9>auRPWx2hg16a3KnUe+N zB$7m!#{lZT!xgy~b-(|};sPf3(E&5F*?^AjZ^+w17_lGKYEZEd>+!8g#7aP>;pily zx~&@$JDl@$KA)eTpV{Gd`!Z)tu=#4MdfR$inrcS`NeK-Mg}Eq)RwoI$UcUmri7LQ` zDUoTyZHuv1DW%Ml6L#zC*I%4McShzN4ICN}ZPvhyiCnF=b!}Brn&+8Hx!u;*RtI2a zNr@Uot|yEsG%$?%=ves>g}?-yVrzi6mv2%HmD{$S=lO5{`fs*h{`i0Y=l}TO6N#O{ zvG|D6kc5x#`IA8ts|Jz z+PC`U%g2f|j<@}hZ^V8F($LA+QD>I+YTuwj*a)CU-oI#o$+^My?k37xvlk=Uw*0E z#>_wb@Wa3QSO4no{== w || y >= h) + return; + + int4 sum = {0, 0, 0, 255}; + + for (int kx = 0; kx < 2*k+1; kx++) { + for (int ky = 0; ky < 2*k+1; ky++) { + int overlap_x = x + kx - k; + int overlap_y = y + ky - k; + + if (overlap_x < 0) + overlap_x = 0; + else if (overlap_x >= w) + overlap_x = w - 1; + + if (overlap_y < 0) + overlap_y = 0; + else if (overlap_y >= h) + overlap_y = h - 1; + + int idxk = kx * 2*k+1 + ky; + int4 pixel = read_imagei(image, sampler, (int2) { overlap_x, overlap_y }); + + sum.x += pixel.x * _kernel[idxk]; + sum.y += pixel.y * _kernel[idxk]; + sum.z += pixel.z * _kernel[idxk]; + } + } + + write_imagei(result, (int2) { x, y }, sum); +} diff --git a/image.c b/image.c new file mode 100644 index 0000000..3b0caf0 --- /dev/null +++ b/image.c @@ -0,0 +1,5 @@ +#define STB_IMAGE_IMPLEMENTATION +#include "stb/stb_image.h" + +#define STB_IMAGE_WRITE_IMPLEMENTATION +#include "stb/stb_image_write.h" diff --git a/main.c b/main.c new file mode 100644 index 0000000..32bd0d2 --- /dev/null +++ b/main.c @@ -0,0 +1,17 @@ +#include "opencl.h" + +int main(int argc, char **argv) +{ + Matrixd kernel = gauss_filter_create(15, 2.0); + Matrixu8 image = matrixu8_create_from_file("assets/image.png"); + matrixd_print(&kernel); + + cl_struct cl = {0}; + opencl_init(&cl, "gaussian_blur_kernel.cl"); + opencl_init_copy_host_buffers_mu8(&cl, &image, &kernel); + opencl_load_kernel(&cl, "sobel_kernel.cl", "sobel", &cl.kernel1, &cl.program1); + opencl_execute_image(&cl); + opencl_read_result_image(&cl); + + return 0; +} diff --git a/opencl.c b/opencl.c new file mode 100644 index 0000000..cee7a1b --- /dev/null +++ b/opencl.c @@ -0,0 +1,298 @@ +#include "opencl.h" +#include "utils.h" +#include +#include +#include +#include +#include +#include +#include +#include "stb/stb_image.h" +#include "stb/stb_image_write.h" + +cl_int opencl_init(cl_struct *cl, const char *program_path) +{ + cl_platform_id platform_id = NULL; + cl_uint ret_num_devices; + cl_uint ret_num_platforms; + cl_int ret; + + ret = clGetPlatformIDs(1, &platform_id, &ret_num_platforms); + CHECK_CL_ERROR(ret); + + ret = clGetDeviceIDs(platform_id, CL_DEVICE_TYPE_GPU, 1, + &(cl->device_id), &ret_num_devices); + CHECK_CL_ERROR(ret); + + cl->context = clCreateContext(NULL, 1, &(cl->device_id), NULL, NULL, &ret); + CHECK_CL_ERROR(ret); + + cl_queue_properties properties[] = { + CL_QUEUE_PROPERTIES, CL_QUEUE_PROFILING_ENABLE, 0, + }; + + cl->command_queue = clCreateCommandQueueWithProperties(cl->context, + cl->device_id, properties, &ret); + CHECK_CL_ERROR(ret); + + ret = opencl_load_kernel(cl, program_path, "gaussian_blur", &cl->kernel, &cl->program); + + return ret; +} + +cl_int opencl_load_kernel(cl_struct *cl, const char *path, const char* kernel_name, + cl_kernel *kernel, cl_program *program) +{ + assert(cl); + assert(path); + assert(kernel_name); + assert(kernel); + assert(program); + + cl_int ret; + + FILE *fp; + char *source_str; + size_t source_size; + const size_t max_source_size = 10000; + + fp = fopen(path, "r"); + if (!fp) { + fprintf(stderr, "failed to open kernel source file.\n"); + exit(1); + } + + source_str = malloc(max_source_size); + assert(source_str); + + source_size = fread(source_str, 1, max_source_size, fp); + fprintf(stderr, "kernel: read %ld bytes\n", source_size); + + fclose(fp); + + *program = clCreateProgramWithSource(cl->context, 1, + (const char **)&source_str, (const size_t *)&source_size, &ret); + CHECK_CL_ERROR(ret); + + ret = clBuildProgram(*program, 1, &(cl->device_id), NULL, NULL, NULL); + CHECK_CL_ERROR(ret); + + if (ret != CL_SUCCESS) { + char build_log[2000]; + size_t ret_size; + ret = clGetProgramBuildInfo(*program, cl->device_id, CL_PROGRAM_BUILD_LOG, 2000, + build_log, &ret_size); + CHECK_CL_ERROR(ret); + + fprintf(stderr, "build: read %ld bytes: %s\n", ret_size, build_log); + fprintf(stderr, "build failed, exiting\n"); + exit(1); + } + + *kernel = clCreateKernel(*program, kernel_name, &ret); + CHECK_CL_ERROR(ret); + + free(source_str); + return ret; +} + +cl_int opencl_init_copy_host_buffers(cl_struct *cl, Matrixd *mat1, Matrixd *mat2) +{ + cl_int ret; + + cl->mat1 = mat1; + cl->mat2 = mat2; + + cl->cl_buffer1 = clCreateBuffer(cl->context, CL_MEM_READ_WRITE, + matrixd_size(cl->mat1) * sizeof(double), NULL, &ret); + CHECK_CL_ERROR(ret); + + cl->cl_buffer2 = clCreateBuffer(cl->context, CL_MEM_READ_WRITE, + matrixd_size(cl->mat2) * sizeof(double), NULL, &ret); + CHECK_CL_ERROR(ret); + + // size_t result_size = (cl->mat1 > cl->mat2) ? matrixd_size(cl->mat1) : matrixd_size(cl->mat2); + size_t result_size = matrixd_size(cl->mat1); + + cl->cl_result = clCreateBuffer(cl->context, CL_MEM_READ_WRITE, + result_size * sizeof(double), NULL, &ret); + CHECK_CL_ERROR(ret); + + + // copy host memory to device memory + ret = clEnqueueWriteBuffer(cl->command_queue, cl->cl_buffer1, CL_TRUE, 0, + matrixd_size(cl->mat1) * sizeof(double), cl->mat1->buf, 0, NULL, NULL); + CHECK_CL_ERROR(ret); + + ret = clEnqueueWriteBuffer(cl->command_queue, cl->cl_buffer2, CL_TRUE, 0, + matrixd_size(cl->mat2) * sizeof(double), cl->mat2->buf, 0, NULL, NULL); + CHECK_CL_ERROR(ret); + + return ret; +} + +cl_int opencl_init_copy_host_buffers_mu8(cl_struct *cl, Matrixu8 *mat1, Matrixd *kernel) +{ + cl_int ret; + + cl->matu8 = mat1; + cl->kernel_m = kernel; + + cl_image_format format = {.image_channel_order = CL_RGBA, + .image_channel_data_type = CL_UNSIGNED_INT8}; + cl_image_desc desc; + memset(&desc, 0, sizeof(cl_image_desc)); + desc.image_type = CL_MEM_OBJECT_IMAGE2D; + desc.image_width = cl->matu8->w; + desc.image_height = cl->matu8->h; + + cl->cl_buffer1 = clCreateImage(cl->context, CL_MEM_READ_ONLY | CL_MEM_COPY_HOST_PTR, + &format, &desc, cl->matu8->buf, &ret); + CHECK_CL_ERROR(ret); + + cl->cl_buffer2 = clCreateBuffer(cl->context, CL_MEM_READ_ONLY, + matrixd_size(cl->kernel_m) * sizeof(double), NULL, &ret); + CHECK_CL_ERROR(ret); + + cl->cl_result = clCreateImage(cl->context, CL_MEM_WRITE_ONLY, + &format, &desc, NULL, &ret); + CHECK_CL_ERROR(ret); + + cl->sampler = clCreateSamplerWithProperties(cl->context, NULL, &ret); + CHECK_CL_ERROR(ret); + + // copy host memory to device memory + ret = clEnqueueWriteBuffer(cl->command_queue, cl->cl_buffer2, CL_TRUE, 0, + matrixd_size(cl->kernel_m) * sizeof(double), cl->kernel_m->buf, 0, NULL, NULL); + CHECK_CL_ERROR(ret); + + return ret; +} + +cl_int opencl_execute_image(cl_struct* cl) +{ + cl_int ret; + + ret = clSetKernelArg(cl->kernel, 0, sizeof(cl_mem), (void *)&(cl->sampler)); + CHECK_CL_ERROR(ret); + + ret = clSetKernelArg(cl->kernel, 1, sizeof(cl_mem), (void *)&(cl->cl_buffer1)); + CHECK_CL_ERROR(ret); + + ret = clSetKernelArg(cl->kernel, 2, sizeof(cl_mem), (void *)&(cl->cl_buffer2)); + CHECK_CL_ERROR(ret); + + ret = clSetKernelArg(cl->kernel, 3, sizeof(cl_mem), (void *)&(cl->cl_result)); + CHECK_CL_ERROR(ret); + + ret = clSetKernelArg(cl->kernel, 4, sizeof(int32_t), (void *)&cl->matu8->w); + CHECK_CL_ERROR(ret); + + ret = clSetKernelArg(cl->kernel, 5, sizeof(int32_t), (void *)&cl->matu8->h); + CHECK_CL_ERROR(ret); + + int k = cl->kernel_m->w-1/2; + ret = clSetKernelArg(cl->kernel, 6, sizeof(int32_t), (void *)&k); + CHECK_CL_ERROR(ret); + + size_t mat1_size = cl->matu8->w * cl->matu8->h; + size_t mat2_size = matrixd_size(cl->kernel_m); + + size_t local_size = 16; + size_t local_items_size[2] = {local_size, local_size}; + size_t global_items_size[2]; + size_t work_groups1 = (cl->matu8->w + local_size + 1) / local_size; + size_t work_groups2 = (cl->matu8->h + local_size + 1) / local_size; + global_items_size[0] = work_groups1 * local_size; + global_items_size[1] = work_groups2 * local_size; + ret = clEnqueueNDRangeKernel(cl->command_queue, cl->kernel, 2, NULL, + global_items_size, local_items_size, 0, NULL, NULL); + CHECK_CL_ERROR(ret); + + return ret; +} + +cl_int opencl_execute(cl_struct* cl) +{ + cl_int ret; + + ret = clSetKernelArg(cl->kernel, 0, sizeof(cl_mem), (void *)&(cl->cl_buffer1)); + CHECK_CL_ERROR(ret); + + ret = clSetKernelArg(cl->kernel, 1, sizeof(cl_mem), (void *)&(cl->cl_buffer2)); + CHECK_CL_ERROR(ret); + + ret = clSetKernelArg(cl->kernel, 2, sizeof(cl_mem), (void *)&(cl->cl_result)); + CHECK_CL_ERROR(ret); + + ret = clSetKernelArg(cl->kernel, 3, sizeof(uint32_t), (void *)&cl->mat1->w); + CHECK_CL_ERROR(ret); + + ret = clSetKernelArg(cl->kernel, 4, sizeof(uint32_t), (void *)&cl->mat1->h); + CHECK_CL_ERROR(ret); + + int k = cl->mat2->w-1/2; + ret = clSetKernelArg(cl->kernel, 5, sizeof(uint32_t), (void *)&k); + CHECK_CL_ERROR(ret); + + size_t mat1_size = matrixd_size(cl->mat1); + size_t mat2_size = matrixd_size(cl->mat2); + + size_t local_size = 16; + size_t local_items_size[2] = {local_size, local_size}; + size_t global_items_size[2]; + size_t work_groups1 = (cl->mat1->w + local_size + 1) / local_size; + size_t work_groups2 = (cl->mat1->h + local_size + 1) / local_size; + global_items_size[0] = work_groups1 * local_size; + global_items_size[1] = work_groups2 * local_size; + + ret = clEnqueueNDRangeKernel(cl->command_queue, cl->kernel, 2, NULL, + global_items_size, local_items_size, 0, NULL, NULL); + CHECK_CL_ERROR(ret); + + return ret; +} + +cl_int opencl_read_result(cl_struct *cl) +{ + cl_int ret; + + clFinish(cl->command_queue); + + size_t result_size = matrixd_size(cl->mat1); + + double *result_buffer = calloc(result_size, sizeof(double)); + ret = clEnqueueReadBuffer(cl->command_queue, cl->cl_result, CL_TRUE, 0, + result_size * sizeof(double), result_buffer, 0, NULL, NULL); + CHECK_CL_ERROR(ret); + + for (size_t i = 0; i < result_size; i+=100) { + printf("%ld: %lf\n", i, result_buffer[i]); + } + + free(result_buffer); + return ret; +} + +cl_int opencl_read_result_image(cl_struct* cl) +{ + cl_int ret; + + clFinish(cl->command_queue); + + size_t result_size = matrixu8_size(cl->matu8) * 4; + + uint8_t *result_buffer = calloc(result_size, 1); + + size_t origin[] = {0, 0, 0}; + size_t region[] = {cl->matu8->w, cl->matu8->h, 1}; + + ret = clEnqueueReadImage(cl->command_queue, cl->cl_result, CL_TRUE, origin, + region, 0, 0, result_buffer, 0, NULL, NULL); + CHECK_CL_ERROR(ret); + + stbi_write_bmp("image_blurred.bmp", cl->matu8->w, cl->matu8->h, 4, result_buffer); + + free(result_buffer); + return ret; +} diff --git a/opencl.h b/opencl.h new file mode 100644 index 0000000..64a7072 --- /dev/null +++ b/opencl.h @@ -0,0 +1,49 @@ +#ifndef OPENCL_H +#define OPENCL_H + +#include +#include +#include +#include +#include +#include "utils.h" + +#define CHECK_CL_ERROR(ret) \ +do { \ + if ((ret) != CL_SUCCESS) { \ + fprintf(stderr, "[%s:%d]: opencl function failed: %s\n", \ + __FILE__, __LINE__, cl_get_error_string(ret)); \ + } \ +} while (0); \ + +typedef struct { + Matrixd *mat1; + Matrixd *mat2; + Matrixp *matp1; + Matrixu8 *matu8; + Matrixd *kernel_m; + cl_mem cl_buffer1; + cl_mem cl_buffer2; + cl_mem cl_result; + cl_sampler sampler; + cl_device_id device_id; + cl_context context; + cl_command_queue command_queue; + cl_program program; + cl_kernel kernel; + cl_program program1; + cl_kernel kernel1; +} cl_struct; + +cl_int opencl_init(cl_struct *cl, const char *program_path); +cl_int opencl_load_kernel(cl_struct *cl, const char *path, const char *kernel_name, + cl_kernel *kernel, cl_program *program); +cl_int opencl_init_copy_host_buffers(cl_struct *cl, Matrixd *mat1, Matrixd *mat2); +cl_int opencl_init_copy_host_buffers_pixel(cl_struct *cl, Matrixp *mat1, Matrixd *mat2); +cl_int opencl_init_copy_host_buffers_mu8(cl_struct *cl, Matrixu8 *mat1, Matrixd *mat2); +cl_int opencl_execute(cl_struct* cl); +cl_int opencl_execute_image(cl_struct* cl); +cl_int opencl_read_result(cl_struct* cl); +cl_int opencl_read_result_image(cl_struct* cl); + +#endif diff --git a/sobel_kernel.cl b/sobel_kernel.cl new file mode 100644 index 0000000..db8986c --- /dev/null +++ b/sobel_kernel.cl @@ -0,0 +1,39 @@ +__kernel void sobel(sampler_t sampler, __read_only image2d_t image, + __global double *_kernel, __write_only image2d_t result, + int w, int h, int k) +{ + + int x = get_global_id(0); + int y = get_global_id(1); + + if (x >= w || y >= h) + return; + + int4 sum = {0, 0, 0, 255}; + + for (int kx = 0; kx < 2*k+1; kx++) { + for (int ky = 0; ky < 2*k+1; ky++) { + int overlap_x = x + kx - k; + int overlap_y = y + ky - k; + + if (overlap_x < 0) + overlap_x = 0; + else if (overlap_x >= w) + overlap_x = w - 1; + + if (overlap_y < 0) + overlap_y = 0; + else if (overlap_y >= h) + overlap_y = h - 1; + + int idxk = kx * 2*k+1 + ky; + int4 pixel = read_imagei(image, sampler, (int2) { overlap_x, overlap_y }); + + sum.x += pixel.x * _kernel[idxk]; + sum.y += pixel.y * _kernel[idxk]; + sum.z += pixel.z * _kernel[idxk]; + } + } + + write_imagei(result, (int2) { x, y }, sum); +} diff --git a/stb/stb_image.h b/stb/stb_image.h new file mode 100644 index 0000000..5e807a0 --- /dev/null +++ b/stb/stb_image.h @@ -0,0 +1,7987 @@ +/* stb_image - v2.28 - public domain image loader - http://nothings.org/stb + no warranty implied; use at your own risk + + Do this: + #define STB_IMAGE_IMPLEMENTATION + before you include this file in *one* C or C++ file to create the implementation. + + // i.e. it should look like this: + #include ... + #include ... + #include ... + #define STB_IMAGE_IMPLEMENTATION + #include "stb_image.h" + + You can #define STBI_ASSERT(x) before the #include to avoid using assert.h. + And #define STBI_MALLOC, STBI_REALLOC, and STBI_FREE to avoid using malloc,realloc,free + + + QUICK NOTES: + Primarily of interest to game developers and other people who can + avoid problematic images and only need the trivial interface + + JPEG baseline & progressive (12 bpc/arithmetic not supported, same as stock IJG lib) + PNG 1/2/4/8/16-bit-per-channel + + TGA (not sure what subset, if a subset) + BMP non-1bpp, non-RLE + PSD (composited view only, no extra channels, 8/16 bit-per-channel) + + GIF (*comp always reports as 4-channel) + HDR (radiance rgbE format) + PIC (Softimage PIC) + PNM (PPM and PGM binary only) + + Animated GIF still needs a proper API, but here's one way to do it: + http://gist.github.com/urraka/685d9a6340b26b830d49 + + - decode from memory or through FILE (define STBI_NO_STDIO to remove code) + - decode from arbitrary I/O callbacks + - SIMD acceleration on x86/x64 (SSE2) and ARM (NEON) + + Full documentation under "DOCUMENTATION" below. + + +LICENSE + + See end of file for license information. + +RECENT REVISION HISTORY: + + 2.28 (2023-01-29) many error fixes, security errors, just tons of stuff + 2.27 (2021-07-11) document stbi_info better, 16-bit PNM support, bug fixes + 2.26 (2020-07-13) many minor fixes + 2.25 (2020-02-02) fix warnings + 2.24 (2020-02-02) fix warnings; thread-local failure_reason and flip_vertically + 2.23 (2019-08-11) fix clang static analysis warning + 2.22 (2019-03-04) gif fixes, fix warnings + 2.21 (2019-02-25) fix typo in comment + 2.20 (2019-02-07) support utf8 filenames in Windows; fix warnings and platform ifdefs + 2.19 (2018-02-11) fix warning + 2.18 (2018-01-30) fix warnings + 2.17 (2018-01-29) bugfix, 1-bit BMP, 16-bitness query, fix warnings + 2.16 (2017-07-23) all functions have 16-bit variants; optimizations; bugfixes + 2.15 (2017-03-18) fix png-1,2,4; all Imagenet JPGs; no runtime SSE detection on GCC + 2.14 (2017-03-03) remove deprecated STBI_JPEG_OLD; fixes for Imagenet JPGs + 2.13 (2016-12-04) experimental 16-bit API, only for PNG so far; fixes + 2.12 (2016-04-02) fix typo in 2.11 PSD fix that caused crashes + 2.11 (2016-04-02) 16-bit PNGS; enable SSE2 in non-gcc x64 + RGB-format JPEG; remove white matting in PSD; + allocate large structures on the stack; + correct channel count for PNG & BMP + 2.10 (2016-01-22) avoid warning introduced in 2.09 + 2.09 (2016-01-16) 16-bit TGA; comments in PNM files; STBI_REALLOC_SIZED + + See end of file for full revision history. + + + ============================ Contributors ========================= + + Image formats Extensions, features + Sean Barrett (jpeg, png, bmp) Jetro Lauha (stbi_info) + Nicolas Schulz (hdr, psd) Martin "SpartanJ" Golini (stbi_info) + Jonathan Dummer (tga) James "moose2000" Brown (iPhone PNG) + Jean-Marc Lienher (gif) Ben "Disch" Wenger (io callbacks) + Tom Seddon (pic) Omar Cornut (1/2/4-bit PNG) + Thatcher Ulrich (psd) Nicolas Guillemot (vertical flip) + Ken Miller (pgm, ppm) Richard Mitton (16-bit PSD) + github:urraka (animated gif) Junggon Kim (PNM comments) + Christopher Forseth (animated gif) Daniel Gibson (16-bit TGA) + socks-the-fox (16-bit PNG) + Jeremy Sawicki (handle all ImageNet JPGs) + Optimizations & bugfixes Mikhail Morozov (1-bit BMP) + Fabian "ryg" Giesen Anael Seghezzi (is-16-bit query) + Arseny Kapoulkine Simon Breuss (16-bit PNM) + John-Mark Allen + Carmelo J Fdez-Aguera + + Bug & warning fixes + Marc LeBlanc David Woo Guillaume George Martins Mozeiko + Christpher Lloyd Jerry Jansson Joseph Thomson Blazej Dariusz Roszkowski + Phil Jordan Dave Moore Roy Eltham + Hayaki Saito Nathan Reed Won Chun + Luke Graham Johan Duparc Nick Verigakis the Horde3D community + Thomas Ruf Ronny Chevalier github:rlyeh + Janez Zemva John Bartholomew Michal Cichon github:romigrou + Jonathan Blow Ken Hamada Tero Hanninen github:svdijk + Eugene Golushkov Laurent Gomila Cort Stratton github:snagar + Aruelien Pocheville Sergio Gonzalez Thibault Reuille github:Zelex + Cass Everitt Ryamond Barbiero github:grim210 + Paul Du Bois Engin Manap Aldo Culquicondor github:sammyhw + Philipp Wiesemann Dale Weiler Oriol Ferrer Mesia github:phprus + Josh Tobin Neil Bickford Matthew Gregan github:poppolopoppo + Julian Raschke Gregory Mullen Christian Floisand github:darealshinji + Baldur Karlsson Kevin Schmidt JR Smith github:Michaelangel007 + Brad Weinberger Matvey Cherevko github:mosra + Luca Sas Alexander Veselov Zack Middleton [reserved] + Ryan C. Gordon [reserved] [reserved] + DO NOT ADD YOUR NAME HERE + + Jacko Dirks + + To add your name to the credits, pick a random blank space in the middle and fill it. + 80% of merge conflicts on stb PRs are due to people adding their name at the end + of the credits. +*/ + +#ifndef STBI_INCLUDE_STB_IMAGE_H +#define STBI_INCLUDE_STB_IMAGE_H + +// DOCUMENTATION +// +// Limitations: +// - no 12-bit-per-channel JPEG +// - no JPEGs with arithmetic coding +// - GIF always returns *comp=4 +// +// Basic usage (see HDR discussion below for HDR usage): +// int x,y,n; +// unsigned char *data = stbi_load(filename, &x, &y, &n, 0); +// // ... process data if not NULL ... +// // ... x = width, y = height, n = # 8-bit components per pixel ... +// // ... replace '0' with '1'..'4' to force that many components per pixel +// // ... but 'n' will always be the number that it would have been if you said 0 +// stbi_image_free(data); +// +// Standard parameters: +// int *x -- outputs image width in pixels +// int *y -- outputs image height in pixels +// int *channels_in_file -- outputs # of image components in image file +// int desired_channels -- if non-zero, # of image components requested in result +// +// The return value from an image loader is an 'unsigned char *' which points +// to the pixel data, or NULL on an allocation failure or if the image is +// corrupt or invalid. The pixel data consists of *y scanlines of *x pixels, +// with each pixel consisting of N interleaved 8-bit components; the first +// pixel pointed to is top-left-most in the image. There is no padding between +// image scanlines or between pixels, regardless of format. The number of +// components N is 'desired_channels' if desired_channels is non-zero, or +// *channels_in_file otherwise. If desired_channels is non-zero, +// *channels_in_file has the number of components that _would_ have been +// output otherwise. E.g. if you set desired_channels to 4, you will always +// get RGBA output, but you can check *channels_in_file to see if it's trivially +// opaque because e.g. there were only 3 channels in the source image. +// +// An output image with N components has the following components interleaved +// in this order in each pixel: +// +// N=#comp components +// 1 grey +// 2 grey, alpha +// 3 red, green, blue +// 4 red, green, blue, alpha +// +// If image loading fails for any reason, the return value will be NULL, +// and *x, *y, *channels_in_file will be unchanged. The function +// stbi_failure_reason() can be queried for an extremely brief, end-user +// unfriendly explanation of why the load failed. Define STBI_NO_FAILURE_STRINGS +// to avoid compiling these strings at all, and STBI_FAILURE_USERMSG to get slightly +// more user-friendly ones. +// +// Paletted PNG, BMP, GIF, and PIC images are automatically depalettized. +// +// To query the width, height and component count of an image without having to +// decode the full file, you can use the stbi_info family of functions: +// +// int x,y,n,ok; +// ok = stbi_info(filename, &x, &y, &n); +// // returns ok=1 and sets x, y, n if image is a supported format, +// // 0 otherwise. +// +// Note that stb_image pervasively uses ints in its public API for sizes, +// including sizes of memory buffers. This is now part of the API and thus +// hard to change without causing breakage. As a result, the various image +// loaders all have certain limits on image size; these differ somewhat +// by format but generally boil down to either just under 2GB or just under +// 1GB. When the decoded image would be larger than this, stb_image decoding +// will fail. +// +// Additionally, stb_image will reject image files that have any of their +// dimensions set to a larger value than the configurable STBI_MAX_DIMENSIONS, +// which defaults to 2**24 = 16777216 pixels. Due to the above memory limit, +// the only way to have an image with such dimensions load correctly +// is for it to have a rather extreme aspect ratio. Either way, the +// assumption here is that such larger images are likely to be malformed +// or malicious. If you do need to load an image with individual dimensions +// larger than that, and it still fits in the overall size limit, you can +// #define STBI_MAX_DIMENSIONS on your own to be something larger. +// +// =========================================================================== +// +// UNICODE: +// +// If compiling for Windows and you wish to use Unicode filenames, compile +// with +// #define STBI_WINDOWS_UTF8 +// and pass utf8-encoded filenames. Call stbi_convert_wchar_to_utf8 to convert +// Windows wchar_t filenames to utf8. +// +// =========================================================================== +// +// Philosophy +// +// stb libraries are designed with the following priorities: +// +// 1. easy to use +// 2. easy to maintain +// 3. good performance +// +// Sometimes I let "good performance" creep up in priority over "easy to maintain", +// and for best performance I may provide less-easy-to-use APIs that give higher +// performance, in addition to the easy-to-use ones. Nevertheless, it's important +// to keep in mind that from the standpoint of you, a client of this library, +// all you care about is #1 and #3, and stb libraries DO NOT emphasize #3 above all. +// +// Some secondary priorities arise directly from the first two, some of which +// provide more explicit reasons why performance can't be emphasized. +// +// - Portable ("ease of use") +// - Small source code footprint ("easy to maintain") +// - No dependencies ("ease of use") +// +// =========================================================================== +// +// I/O callbacks +// +// I/O callbacks allow you to read from arbitrary sources, like packaged +// files or some other source. Data read from callbacks are processed +// through a small internal buffer (currently 128 bytes) to try to reduce +// overhead. +// +// The three functions you must define are "read" (reads some bytes of data), +// "skip" (skips some bytes of data), "eof" (reports if the stream is at the end). +// +// =========================================================================== +// +// SIMD support +// +// The JPEG decoder will try to automatically use SIMD kernels on x86 when +// supported by the compiler. For ARM Neon support, you must explicitly +// request it. +// +// (The old do-it-yourself SIMD API is no longer supported in the current +// code.) +// +// On x86, SSE2 will automatically be used when available based on a run-time +// test; if not, the generic C versions are used as a fall-back. On ARM targets, +// the typical path is to have separate builds for NEON and non-NEON devices +// (at least this is true for iOS and Android). Therefore, the NEON support is +// toggled by a build flag: define STBI_NEON to get NEON loops. +// +// If for some reason you do not want to use any of SIMD code, or if +// you have issues compiling it, you can disable it entirely by +// defining STBI_NO_SIMD. +// +// =========================================================================== +// +// HDR image support (disable by defining STBI_NO_HDR) +// +// stb_image supports loading HDR images in general, and currently the Radiance +// .HDR file format specifically. You can still load any file through the existing +// interface; if you attempt to load an HDR file, it will be automatically remapped +// to LDR, assuming gamma 2.2 and an arbitrary scale factor defaulting to 1; +// both of these constants can be reconfigured through this interface: +// +// stbi_hdr_to_ldr_gamma(2.2f); +// stbi_hdr_to_ldr_scale(1.0f); +// +// (note, do not use _inverse_ constants; stbi_image will invert them +// appropriately). +// +// Additionally, there is a new, parallel interface for loading files as +// (linear) floats to preserve the full dynamic range: +// +// float *data = stbi_loadf(filename, &x, &y, &n, 0); +// +// If you load LDR images through this interface, those images will +// be promoted to floating point values, run through the inverse of +// constants corresponding to the above: +// +// stbi_ldr_to_hdr_scale(1.0f); +// stbi_ldr_to_hdr_gamma(2.2f); +// +// Finally, given a filename (or an open file or memory block--see header +// file for details) containing image data, you can query for the "most +// appropriate" interface to use (that is, whether the image is HDR or +// not), using: +// +// stbi_is_hdr(char *filename); +// +// =========================================================================== +// +// iPhone PNG support: +// +// We optionally support converting iPhone-formatted PNGs (which store +// premultiplied BGRA) back to RGB, even though they're internally encoded +// differently. To enable this conversion, call +// stbi_convert_iphone_png_to_rgb(1). +// +// Call stbi_set_unpremultiply_on_load(1) as well to force a divide per +// pixel to remove any premultiplied alpha *only* if the image file explicitly +// says there's premultiplied data (currently only happens in iPhone images, +// and only if iPhone convert-to-rgb processing is on). +// +// =========================================================================== +// +// ADDITIONAL CONFIGURATION +// +// - You can suppress implementation of any of the decoders to reduce +// your code footprint by #defining one or more of the following +// symbols before creating the implementation. +// +// STBI_NO_JPEG +// STBI_NO_PNG +// STBI_NO_BMP +// STBI_NO_PSD +// STBI_NO_TGA +// STBI_NO_GIF +// STBI_NO_HDR +// STBI_NO_PIC +// STBI_NO_PNM (.ppm and .pgm) +// +// - You can request *only* certain decoders and suppress all other ones +// (this will be more forward-compatible, as addition of new decoders +// doesn't require you to disable them explicitly): +// +// STBI_ONLY_JPEG +// STBI_ONLY_PNG +// STBI_ONLY_BMP +// STBI_ONLY_PSD +// STBI_ONLY_TGA +// STBI_ONLY_GIF +// STBI_ONLY_HDR +// STBI_ONLY_PIC +// STBI_ONLY_PNM (.ppm and .pgm) +// +// - If you use STBI_NO_PNG (or _ONLY_ without PNG), and you still +// want the zlib decoder to be available, #define STBI_SUPPORT_ZLIB +// +// - If you define STBI_MAX_DIMENSIONS, stb_image will reject images greater +// than that size (in either width or height) without further processing. +// This is to let programs in the wild set an upper bound to prevent +// denial-of-service attacks on untrusted data, as one could generate a +// valid image of gigantic dimensions and force stb_image to allocate a +// huge block of memory and spend disproportionate time decoding it. By +// default this is set to (1 << 24), which is 16777216, but that's still +// very big. + +#ifndef STBI_NO_STDIO +#include +#endif // STBI_NO_STDIO + +#define STBI_VERSION 1 + +enum +{ + STBI_default = 0, // only used for desired_channels + + STBI_grey = 1, + STBI_grey_alpha = 2, + STBI_rgb = 3, + STBI_rgb_alpha = 4 +}; + +#include +typedef unsigned char stbi_uc; +typedef unsigned short stbi_us; + +#ifdef __cplusplus +extern "C" { +#endif + +#ifndef STBIDEF +#ifdef STB_IMAGE_STATIC +#define STBIDEF static +#else +#define STBIDEF extern +#endif +#endif + +////////////////////////////////////////////////////////////////////////////// +// +// PRIMARY API - works on images of any type +// + +// +// load image by filename, open file, or memory buffer +// + +typedef struct +{ + int (*read) (void *user,char *data,int size); // fill 'data' with 'size' bytes. return number of bytes actually read + void (*skip) (void *user,int n); // skip the next 'n' bytes, or 'unget' the last -n bytes if negative + int (*eof) (void *user); // returns nonzero if we are at end of file/data +} stbi_io_callbacks; + +//////////////////////////////////// +// +// 8-bits-per-channel interface +// + +STBIDEF stbi_uc *stbi_load_from_memory (stbi_uc const *buffer, int len , int *x, int *y, int *channels_in_file, int desired_channels); +STBIDEF stbi_uc *stbi_load_from_callbacks(stbi_io_callbacks const *clbk , void *user, int *x, int *y, int *channels_in_file, int desired_channels); + +#ifndef STBI_NO_STDIO +STBIDEF stbi_uc *stbi_load (char const *filename, int *x, int *y, int *channels_in_file, int desired_channels); +STBIDEF stbi_uc *stbi_load_from_file (FILE *f, int *x, int *y, int *channels_in_file, int desired_channels); +// for stbi_load_from_file, file pointer is left pointing immediately after image +#endif + +#ifndef STBI_NO_GIF +STBIDEF stbi_uc *stbi_load_gif_from_memory(stbi_uc const *buffer, int len, int **delays, int *x, int *y, int *z, int *comp, int req_comp); +#endif + +#ifdef STBI_WINDOWS_UTF8 +STBIDEF int stbi_convert_wchar_to_utf8(char *buffer, size_t bufferlen, const wchar_t* input); +#endif + +//////////////////////////////////// +// +// 16-bits-per-channel interface +// + +STBIDEF stbi_us *stbi_load_16_from_memory (stbi_uc const *buffer, int len, int *x, int *y, int *channels_in_file, int desired_channels); +STBIDEF stbi_us *stbi_load_16_from_callbacks(stbi_io_callbacks const *clbk, void *user, int *x, int *y, int *channels_in_file, int desired_channels); + +#ifndef STBI_NO_STDIO +STBIDEF stbi_us *stbi_load_16 (char const *filename, int *x, int *y, int *channels_in_file, int desired_channels); +STBIDEF stbi_us *stbi_load_from_file_16(FILE *f, int *x, int *y, int *channels_in_file, int desired_channels); +#endif + +//////////////////////////////////// +// +// float-per-channel interface +// +#ifndef STBI_NO_LINEAR + STBIDEF float *stbi_loadf_from_memory (stbi_uc const *buffer, int len, int *x, int *y, int *channels_in_file, int desired_channels); + STBIDEF float *stbi_loadf_from_callbacks (stbi_io_callbacks const *clbk, void *user, int *x, int *y, int *channels_in_file, int desired_channels); + + #ifndef STBI_NO_STDIO + STBIDEF float *stbi_loadf (char const *filename, int *x, int *y, int *channels_in_file, int desired_channels); + STBIDEF float *stbi_loadf_from_file (FILE *f, int *x, int *y, int *channels_in_file, int desired_channels); + #endif +#endif + +#ifndef STBI_NO_HDR + STBIDEF void stbi_hdr_to_ldr_gamma(float gamma); + STBIDEF void stbi_hdr_to_ldr_scale(float scale); +#endif // STBI_NO_HDR + +#ifndef STBI_NO_LINEAR + STBIDEF void stbi_ldr_to_hdr_gamma(float gamma); + STBIDEF void stbi_ldr_to_hdr_scale(float scale); +#endif // STBI_NO_LINEAR + +// stbi_is_hdr is always defined, but always returns false if STBI_NO_HDR +STBIDEF int stbi_is_hdr_from_callbacks(stbi_io_callbacks const *clbk, void *user); +STBIDEF int stbi_is_hdr_from_memory(stbi_uc const *buffer, int len); +#ifndef STBI_NO_STDIO +STBIDEF int stbi_is_hdr (char const *filename); +STBIDEF int stbi_is_hdr_from_file(FILE *f); +#endif // STBI_NO_STDIO + + +// get a VERY brief reason for failure +// on most compilers (and ALL modern mainstream compilers) this is threadsafe +STBIDEF const char *stbi_failure_reason (void); + +// free the loaded image -- this is just free() +STBIDEF void stbi_image_free (void *retval_from_stbi_load); + +// get image dimensions & components without fully decoding +STBIDEF int stbi_info_from_memory(stbi_uc const *buffer, int len, int *x, int *y, int *comp); +STBIDEF int stbi_info_from_callbacks(stbi_io_callbacks const *clbk, void *user, int *x, int *y, int *comp); +STBIDEF int stbi_is_16_bit_from_memory(stbi_uc const *buffer, int len); +STBIDEF int stbi_is_16_bit_from_callbacks(stbi_io_callbacks const *clbk, void *user); + +#ifndef STBI_NO_STDIO +STBIDEF int stbi_info (char const *filename, int *x, int *y, int *comp); +STBIDEF int stbi_info_from_file (FILE *f, int *x, int *y, int *comp); +STBIDEF int stbi_is_16_bit (char const *filename); +STBIDEF int stbi_is_16_bit_from_file(FILE *f); +#endif + + + +// for image formats that explicitly notate that they have premultiplied alpha, +// we just return the colors as stored in the file. set this flag to force +// unpremultiplication. results are undefined if the unpremultiply overflow. +STBIDEF void stbi_set_unpremultiply_on_load(int flag_true_if_should_unpremultiply); + +// indicate whether we should process iphone images back to canonical format, +// or just pass them through "as-is" +STBIDEF void stbi_convert_iphone_png_to_rgb(int flag_true_if_should_convert); + +// flip the image vertically, so the first pixel in the output array is the bottom left +STBIDEF void stbi_set_flip_vertically_on_load(int flag_true_if_should_flip); + +// as above, but only applies to images loaded on the thread that calls the function +// this function is only available if your compiler supports thread-local variables; +// calling it will fail to link if your compiler doesn't +STBIDEF void stbi_set_unpremultiply_on_load_thread(int flag_true_if_should_unpremultiply); +STBIDEF void stbi_convert_iphone_png_to_rgb_thread(int flag_true_if_should_convert); +STBIDEF void stbi_set_flip_vertically_on_load_thread(int flag_true_if_should_flip); + +// ZLIB client - used by PNG, available for other purposes + +STBIDEF char *stbi_zlib_decode_malloc_guesssize(const char *buffer, int len, int initial_size, int *outlen); +STBIDEF char *stbi_zlib_decode_malloc_guesssize_headerflag(const char *buffer, int len, int initial_size, int *outlen, int parse_header); +STBIDEF char *stbi_zlib_decode_malloc(const char *buffer, int len, int *outlen); +STBIDEF int stbi_zlib_decode_buffer(char *obuffer, int olen, const char *ibuffer, int ilen); + +STBIDEF char *stbi_zlib_decode_noheader_malloc(const char *buffer, int len, int *outlen); +STBIDEF int stbi_zlib_decode_noheader_buffer(char *obuffer, int olen, const char *ibuffer, int ilen); + + +#ifdef __cplusplus +} +#endif + +// +// +//// end header file ///////////////////////////////////////////////////// +#endif // STBI_INCLUDE_STB_IMAGE_H + +#ifdef STB_IMAGE_IMPLEMENTATION + +#if defined(STBI_ONLY_JPEG) || defined(STBI_ONLY_PNG) || defined(STBI_ONLY_BMP) \ + || defined(STBI_ONLY_TGA) || defined(STBI_ONLY_GIF) || defined(STBI_ONLY_PSD) \ + || defined(STBI_ONLY_HDR) || defined(STBI_ONLY_PIC) || defined(STBI_ONLY_PNM) \ + || defined(STBI_ONLY_ZLIB) + #ifndef STBI_ONLY_JPEG + #define STBI_NO_JPEG + #endif + #ifndef STBI_ONLY_PNG + #define STBI_NO_PNG + #endif + #ifndef STBI_ONLY_BMP + #define STBI_NO_BMP + #endif + #ifndef STBI_ONLY_PSD + #define STBI_NO_PSD + #endif + #ifndef STBI_ONLY_TGA + #define STBI_NO_TGA + #endif + #ifndef STBI_ONLY_GIF + #define STBI_NO_GIF + #endif + #ifndef STBI_ONLY_HDR + #define STBI_NO_HDR + #endif + #ifndef STBI_ONLY_PIC + #define STBI_NO_PIC + #endif + #ifndef STBI_ONLY_PNM + #define STBI_NO_PNM + #endif +#endif + +#if defined(STBI_NO_PNG) && !defined(STBI_SUPPORT_ZLIB) && !defined(STBI_NO_ZLIB) +#define STBI_NO_ZLIB +#endif + + +#include +#include // ptrdiff_t on osx +#include +#include +#include + +#if !defined(STBI_NO_LINEAR) || !defined(STBI_NO_HDR) +#include // ldexp, pow +#endif + +#ifndef STBI_NO_STDIO +#include +#endif + +#ifndef STBI_ASSERT +#include +#define STBI_ASSERT(x) assert(x) +#endif + +#ifdef __cplusplus +#define STBI_EXTERN extern "C" +#else +#define STBI_EXTERN extern +#endif + + +#ifndef _MSC_VER + #ifdef __cplusplus + #define stbi_inline inline + #else + #define stbi_inline + #endif +#else + #define stbi_inline __forceinline +#endif + +#ifndef STBI_NO_THREAD_LOCALS + #if defined(__cplusplus) && __cplusplus >= 201103L + #define STBI_THREAD_LOCAL thread_local + #elif defined(__GNUC__) && __GNUC__ < 5 + #define STBI_THREAD_LOCAL __thread + #elif defined(_MSC_VER) + #define STBI_THREAD_LOCAL __declspec(thread) + #elif defined (__STDC_VERSION__) && __STDC_VERSION__ >= 201112L && !defined(__STDC_NO_THREADS__) + #define STBI_THREAD_LOCAL _Thread_local + #endif + + #ifndef STBI_THREAD_LOCAL + #if defined(__GNUC__) + #define STBI_THREAD_LOCAL __thread + #endif + #endif +#endif + +#if defined(_MSC_VER) || defined(__SYMBIAN32__) +typedef unsigned short stbi__uint16; +typedef signed short stbi__int16; +typedef unsigned int stbi__uint32; +typedef signed int stbi__int32; +#else +#include +typedef uint16_t stbi__uint16; +typedef int16_t stbi__int16; +typedef uint32_t stbi__uint32; +typedef int32_t stbi__int32; +#endif + +// should produce compiler error if size is wrong +typedef unsigned char validate_uint32[sizeof(stbi__uint32)==4 ? 1 : -1]; + +#ifdef _MSC_VER +#define STBI_NOTUSED(v) (void)(v) +#else +#define STBI_NOTUSED(v) (void)sizeof(v) +#endif + +#ifdef _MSC_VER +#define STBI_HAS_LROTL +#endif + +#ifdef STBI_HAS_LROTL + #define stbi_lrot(x,y) _lrotl(x,y) +#else + #define stbi_lrot(x,y) (((x) << (y)) | ((x) >> (-(y) & 31))) +#endif + +#if defined(STBI_MALLOC) && defined(STBI_FREE) && (defined(STBI_REALLOC) || defined(STBI_REALLOC_SIZED)) +// ok +#elif !defined(STBI_MALLOC) && !defined(STBI_FREE) && !defined(STBI_REALLOC) && !defined(STBI_REALLOC_SIZED) +// ok +#else +#error "Must define all or none of STBI_MALLOC, STBI_FREE, and STBI_REALLOC (or STBI_REALLOC_SIZED)." +#endif + +#ifndef STBI_MALLOC +#define STBI_MALLOC(sz) malloc(sz) +#define STBI_REALLOC(p,newsz) realloc(p,newsz) +#define STBI_FREE(p) free(p) +#endif + +#ifndef STBI_REALLOC_SIZED +#define STBI_REALLOC_SIZED(p,oldsz,newsz) STBI_REALLOC(p,newsz) +#endif + +// x86/x64 detection +#if defined(__x86_64__) || defined(_M_X64) +#define STBI__X64_TARGET +#elif defined(__i386) || defined(_M_IX86) +#define STBI__X86_TARGET +#endif + +#if defined(__GNUC__) && defined(STBI__X86_TARGET) && !defined(__SSE2__) && !defined(STBI_NO_SIMD) +// gcc doesn't support sse2 intrinsics unless you compile with -msse2, +// which in turn means it gets to use SSE2 everywhere. This is unfortunate, +// but previous attempts to provide the SSE2 functions with runtime +// detection caused numerous issues. The way architecture extensions are +// exposed in GCC/Clang is, sadly, not really suited for one-file libs. +// New behavior: if compiled with -msse2, we use SSE2 without any +// detection; if not, we don't use it at all. +#define STBI_NO_SIMD +#endif + +#if defined(__MINGW32__) && defined(STBI__X86_TARGET) && !defined(STBI_MINGW_ENABLE_SSE2) && !defined(STBI_NO_SIMD) +// Note that __MINGW32__ doesn't actually mean 32-bit, so we have to avoid STBI__X64_TARGET +// +// 32-bit MinGW wants ESP to be 16-byte aligned, but this is not in the +// Windows ABI and VC++ as well as Windows DLLs don't maintain that invariant. +// As a result, enabling SSE2 on 32-bit MinGW is dangerous when not +// simultaneously enabling "-mstackrealign". +// +// See https://github.com/nothings/stb/issues/81 for more information. +// +// So default to no SSE2 on 32-bit MinGW. If you've read this far and added +// -mstackrealign to your build settings, feel free to #define STBI_MINGW_ENABLE_SSE2. +#define STBI_NO_SIMD +#endif + +#if !defined(STBI_NO_SIMD) && (defined(STBI__X86_TARGET) || defined(STBI__X64_TARGET)) +#define STBI_SSE2 +#include + +#ifdef _MSC_VER + +#if _MSC_VER >= 1400 // not VC6 +#include // __cpuid +static int stbi__cpuid3(void) +{ + int info[4]; + __cpuid(info,1); + return info[3]; +} +#else +static int stbi__cpuid3(void) +{ + int res; + __asm { + mov eax,1 + cpuid + mov res,edx + } + return res; +} +#endif + +#define STBI_SIMD_ALIGN(type, name) __declspec(align(16)) type name + +#if !defined(STBI_NO_JPEG) && defined(STBI_SSE2) +static int stbi__sse2_available(void) +{ + int info3 = stbi__cpuid3(); + return ((info3 >> 26) & 1) != 0; +} +#endif + +#else // assume GCC-style if not VC++ +#define STBI_SIMD_ALIGN(type, name) type name __attribute__((aligned(16))) + +#if !defined(STBI_NO_JPEG) && defined(STBI_SSE2) +static int stbi__sse2_available(void) +{ + // If we're even attempting to compile this on GCC/Clang, that means + // -msse2 is on, which means the compiler is allowed to use SSE2 + // instructions at will, and so are we. + return 1; +} +#endif + +#endif +#endif + +// ARM NEON +#if defined(STBI_NO_SIMD) && defined(STBI_NEON) +#undef STBI_NEON +#endif + +#ifdef STBI_NEON +#include +#ifdef _MSC_VER +#define STBI_SIMD_ALIGN(type, name) __declspec(align(16)) type name +#else +#define STBI_SIMD_ALIGN(type, name) type name __attribute__((aligned(16))) +#endif +#endif + +#ifndef STBI_SIMD_ALIGN +#define STBI_SIMD_ALIGN(type, name) type name +#endif + +#ifndef STBI_MAX_DIMENSIONS +#define STBI_MAX_DIMENSIONS (1 << 24) +#endif + +/////////////////////////////////////////////// +// +// stbi__context struct and start_xxx functions + +// stbi__context structure is our basic context used by all images, so it +// contains all the IO context, plus some basic image information +typedef struct +{ + stbi__uint32 img_x, img_y; + int img_n, img_out_n; + + stbi_io_callbacks io; + void *io_user_data; + + int read_from_callbacks; + int buflen; + stbi_uc buffer_start[128]; + int callback_already_read; + + stbi_uc *img_buffer, *img_buffer_end; + stbi_uc *img_buffer_original, *img_buffer_original_end; +} stbi__context; + + +static void stbi__refill_buffer(stbi__context *s); + +// initialize a memory-decode context +static void stbi__start_mem(stbi__context *s, stbi_uc const *buffer, int len) +{ + s->io.read = NULL; + s->read_from_callbacks = 0; + s->callback_already_read = 0; + s->img_buffer = s->img_buffer_original = (stbi_uc *) buffer; + s->img_buffer_end = s->img_buffer_original_end = (stbi_uc *) buffer+len; +} + +// initialize a callback-based context +static void stbi__start_callbacks(stbi__context *s, stbi_io_callbacks *c, void *user) +{ + s->io = *c; + s->io_user_data = user; + s->buflen = sizeof(s->buffer_start); + s->read_from_callbacks = 1; + s->callback_already_read = 0; + s->img_buffer = s->img_buffer_original = s->buffer_start; + stbi__refill_buffer(s); + s->img_buffer_original_end = s->img_buffer_end; +} + +#ifndef STBI_NO_STDIO + +static int stbi__stdio_read(void *user, char *data, int size) +{ + return (int) fread(data,1,size,(FILE*) user); +} + +static void stbi__stdio_skip(void *user, int n) +{ + int ch; + fseek((FILE*) user, n, SEEK_CUR); + ch = fgetc((FILE*) user); /* have to read a byte to reset feof()'s flag */ + if (ch != EOF) { + ungetc(ch, (FILE *) user); /* push byte back onto stream if valid. */ + } +} + +static int stbi__stdio_eof(void *user) +{ + return feof((FILE*) user) || ferror((FILE *) user); +} + +static stbi_io_callbacks stbi__stdio_callbacks = +{ + stbi__stdio_read, + stbi__stdio_skip, + stbi__stdio_eof, +}; + +static void stbi__start_file(stbi__context *s, FILE *f) +{ + stbi__start_callbacks(s, &stbi__stdio_callbacks, (void *) f); +} + +//static void stop_file(stbi__context *s) { } + +#endif // !STBI_NO_STDIO + +static void stbi__rewind(stbi__context *s) +{ + // conceptually rewind SHOULD rewind to the beginning of the stream, + // but we just rewind to the beginning of the initial buffer, because + // we only use it after doing 'test', which only ever looks at at most 92 bytes + s->img_buffer = s->img_buffer_original; + s->img_buffer_end = s->img_buffer_original_end; +} + +enum +{ + STBI_ORDER_RGB, + STBI_ORDER_BGR +}; + +typedef struct +{ + int bits_per_channel; + int num_channels; + int channel_order; +} stbi__result_info; + +#ifndef STBI_NO_JPEG +static int stbi__jpeg_test(stbi__context *s); +static void *stbi__jpeg_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri); +static int stbi__jpeg_info(stbi__context *s, int *x, int *y, int *comp); +#endif + +#ifndef STBI_NO_PNG +static int stbi__png_test(stbi__context *s); +static void *stbi__png_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri); +static int stbi__png_info(stbi__context *s, int *x, int *y, int *comp); +static int stbi__png_is16(stbi__context *s); +#endif + +#ifndef STBI_NO_BMP +static int stbi__bmp_test(stbi__context *s); +static void *stbi__bmp_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri); +static int stbi__bmp_info(stbi__context *s, int *x, int *y, int *comp); +#endif + +#ifndef STBI_NO_TGA +static int stbi__tga_test(stbi__context *s); +static void *stbi__tga_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri); +static int stbi__tga_info(stbi__context *s, int *x, int *y, int *comp); +#endif + +#ifndef STBI_NO_PSD +static int stbi__psd_test(stbi__context *s); +static void *stbi__psd_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri, int bpc); +static int stbi__psd_info(stbi__context *s, int *x, int *y, int *comp); +static int stbi__psd_is16(stbi__context *s); +#endif + +#ifndef STBI_NO_HDR +static int stbi__hdr_test(stbi__context *s); +static float *stbi__hdr_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri); +static int stbi__hdr_info(stbi__context *s, int *x, int *y, int *comp); +#endif + +#ifndef STBI_NO_PIC +static int stbi__pic_test(stbi__context *s); +static void *stbi__pic_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri); +static int stbi__pic_info(stbi__context *s, int *x, int *y, int *comp); +#endif + +#ifndef STBI_NO_GIF +static int stbi__gif_test(stbi__context *s); +static void *stbi__gif_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri); +static void *stbi__load_gif_main(stbi__context *s, int **delays, int *x, int *y, int *z, int *comp, int req_comp); +static int stbi__gif_info(stbi__context *s, int *x, int *y, int *comp); +#endif + +#ifndef STBI_NO_PNM +static int stbi__pnm_test(stbi__context *s); +static void *stbi__pnm_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri); +static int stbi__pnm_info(stbi__context *s, int *x, int *y, int *comp); +static int stbi__pnm_is16(stbi__context *s); +#endif + +static +#ifdef STBI_THREAD_LOCAL +STBI_THREAD_LOCAL +#endif +const char *stbi__g_failure_reason; + +STBIDEF const char *stbi_failure_reason(void) +{ + return stbi__g_failure_reason; +} + +#ifndef STBI_NO_FAILURE_STRINGS +static int stbi__err(const char *str) +{ + stbi__g_failure_reason = str; + return 0; +} +#endif + +static void *stbi__malloc(size_t size) +{ + return STBI_MALLOC(size); +} + +// stb_image uses ints pervasively, including for offset calculations. +// therefore the largest decoded image size we can support with the +// current code, even on 64-bit targets, is INT_MAX. this is not a +// significant limitation for the intended use case. +// +// we do, however, need to make sure our size calculations don't +// overflow. hence a few helper functions for size calculations that +// multiply integers together, making sure that they're non-negative +// and no overflow occurs. + +// return 1 if the sum is valid, 0 on overflow. +// negative terms are considered invalid. +static int stbi__addsizes_valid(int a, int b) +{ + if (b < 0) return 0; + // now 0 <= b <= INT_MAX, hence also + // 0 <= INT_MAX - b <= INTMAX. + // And "a + b <= INT_MAX" (which might overflow) is the + // same as a <= INT_MAX - b (no overflow) + return a <= INT_MAX - b; +} + +// returns 1 if the product is valid, 0 on overflow. +// negative factors are considered invalid. +static int stbi__mul2sizes_valid(int a, int b) +{ + if (a < 0 || b < 0) return 0; + if (b == 0) return 1; // mul-by-0 is always safe + // portable way to check for no overflows in a*b + return a <= INT_MAX/b; +} + +#if !defined(STBI_NO_JPEG) || !defined(STBI_NO_PNG) || !defined(STBI_NO_TGA) || !defined(STBI_NO_HDR) +// returns 1 if "a*b + add" has no negative terms/factors and doesn't overflow +static int stbi__mad2sizes_valid(int a, int b, int add) +{ + return stbi__mul2sizes_valid(a, b) && stbi__addsizes_valid(a*b, add); +} +#endif + +// returns 1 if "a*b*c + add" has no negative terms/factors and doesn't overflow +static int stbi__mad3sizes_valid(int a, int b, int c, int add) +{ + return stbi__mul2sizes_valid(a, b) && stbi__mul2sizes_valid(a*b, c) && + stbi__addsizes_valid(a*b*c, add); +} + +// returns 1 if "a*b*c*d + add" has no negative terms/factors and doesn't overflow +#if !defined(STBI_NO_LINEAR) || !defined(STBI_NO_HDR) || !defined(STBI_NO_PNM) +static int stbi__mad4sizes_valid(int a, int b, int c, int d, int add) +{ + return stbi__mul2sizes_valid(a, b) && stbi__mul2sizes_valid(a*b, c) && + stbi__mul2sizes_valid(a*b*c, d) && stbi__addsizes_valid(a*b*c*d, add); +} +#endif + +#if !defined(STBI_NO_JPEG) || !defined(STBI_NO_PNG) || !defined(STBI_NO_TGA) || !defined(STBI_NO_HDR) +// mallocs with size overflow checking +static void *stbi__malloc_mad2(int a, int b, int add) +{ + if (!stbi__mad2sizes_valid(a, b, add)) return NULL; + return stbi__malloc(a*b + add); +} +#endif + +static void *stbi__malloc_mad3(int a, int b, int c, int add) +{ + if (!stbi__mad3sizes_valid(a, b, c, add)) return NULL; + return stbi__malloc(a*b*c + add); +} + +#if !defined(STBI_NO_LINEAR) || !defined(STBI_NO_HDR) || !defined(STBI_NO_PNM) +static void *stbi__malloc_mad4(int a, int b, int c, int d, int add) +{ + if (!stbi__mad4sizes_valid(a, b, c, d, add)) return NULL; + return stbi__malloc(a*b*c*d + add); +} +#endif + +// returns 1 if the sum of two signed ints is valid (between -2^31 and 2^31-1 inclusive), 0 on overflow. +static int stbi__addints_valid(int a, int b) +{ + if ((a >= 0) != (b >= 0)) return 1; // a and b have different signs, so no overflow + if (a < 0 && b < 0) return a >= INT_MIN - b; // same as a + b >= INT_MIN; INT_MIN - b cannot overflow since b < 0. + return a <= INT_MAX - b; +} + +// returns 1 if the product of two signed shorts is valid, 0 on overflow. +static int stbi__mul2shorts_valid(short a, short b) +{ + if (b == 0 || b == -1) return 1; // multiplication by 0 is always 0; check for -1 so SHRT_MIN/b doesn't overflow + if ((a >= 0) == (b >= 0)) return a <= SHRT_MAX/b; // product is positive, so similar to mul2sizes_valid + if (b < 0) return a <= SHRT_MIN / b; // same as a * b >= SHRT_MIN + return a >= SHRT_MIN / b; +} + +// stbi__err - error +// stbi__errpf - error returning pointer to float +// stbi__errpuc - error returning pointer to unsigned char + +#ifdef STBI_NO_FAILURE_STRINGS + #define stbi__err(x,y) 0 +#elif defined(STBI_FAILURE_USERMSG) + #define stbi__err(x,y) stbi__err(y) +#else + #define stbi__err(x,y) stbi__err(x) +#endif + +#define stbi__errpf(x,y) ((float *)(size_t) (stbi__err(x,y)?NULL:NULL)) +#define stbi__errpuc(x,y) ((unsigned char *)(size_t) (stbi__err(x,y)?NULL:NULL)) + +STBIDEF void stbi_image_free(void *retval_from_stbi_load) +{ + STBI_FREE(retval_from_stbi_load); +} + +#ifndef STBI_NO_LINEAR +static float *stbi__ldr_to_hdr(stbi_uc *data, int x, int y, int comp); +#endif + +#ifndef STBI_NO_HDR +static stbi_uc *stbi__hdr_to_ldr(float *data, int x, int y, int comp); +#endif + +static int stbi__vertically_flip_on_load_global = 0; + +STBIDEF void stbi_set_flip_vertically_on_load(int flag_true_if_should_flip) +{ + stbi__vertically_flip_on_load_global = flag_true_if_should_flip; +} + +#ifndef STBI_THREAD_LOCAL +#define stbi__vertically_flip_on_load stbi__vertically_flip_on_load_global +#else +static STBI_THREAD_LOCAL int stbi__vertically_flip_on_load_local, stbi__vertically_flip_on_load_set; + +STBIDEF void stbi_set_flip_vertically_on_load_thread(int flag_true_if_should_flip) +{ + stbi__vertically_flip_on_load_local = flag_true_if_should_flip; + stbi__vertically_flip_on_load_set = 1; +} + +#define stbi__vertically_flip_on_load (stbi__vertically_flip_on_load_set \ + ? stbi__vertically_flip_on_load_local \ + : stbi__vertically_flip_on_load_global) +#endif // STBI_THREAD_LOCAL + +static void *stbi__load_main(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri, int bpc) +{ + memset(ri, 0, sizeof(*ri)); // make sure it's initialized if we add new fields + ri->bits_per_channel = 8; // default is 8 so most paths don't have to be changed + ri->channel_order = STBI_ORDER_RGB; // all current input & output are this, but this is here so we can add BGR order + ri->num_channels = 0; + + // test the formats with a very explicit header first (at least a FOURCC + // or distinctive magic number first) + #ifndef STBI_NO_PNG + if (stbi__png_test(s)) return stbi__png_load(s,x,y,comp,req_comp, ri); + #endif + #ifndef STBI_NO_BMP + if (stbi__bmp_test(s)) return stbi__bmp_load(s,x,y,comp,req_comp, ri); + #endif + #ifndef STBI_NO_GIF + if (stbi__gif_test(s)) return stbi__gif_load(s,x,y,comp,req_comp, ri); + #endif + #ifndef STBI_NO_PSD + if (stbi__psd_test(s)) return stbi__psd_load(s,x,y,comp,req_comp, ri, bpc); + #else + STBI_NOTUSED(bpc); + #endif + #ifndef STBI_NO_PIC + if (stbi__pic_test(s)) return stbi__pic_load(s,x,y,comp,req_comp, ri); + #endif + + // then the formats that can end up attempting to load with just 1 or 2 + // bytes matching expectations; these are prone to false positives, so + // try them later + #ifndef STBI_NO_JPEG + if (stbi__jpeg_test(s)) return stbi__jpeg_load(s,x,y,comp,req_comp, ri); + #endif + #ifndef STBI_NO_PNM + if (stbi__pnm_test(s)) return stbi__pnm_load(s,x,y,comp,req_comp, ri); + #endif + + #ifndef STBI_NO_HDR + if (stbi__hdr_test(s)) { + float *hdr = stbi__hdr_load(s, x,y,comp,req_comp, ri); + return stbi__hdr_to_ldr(hdr, *x, *y, req_comp ? req_comp : *comp); + } + #endif + + #ifndef STBI_NO_TGA + // test tga last because it's a crappy test! + if (stbi__tga_test(s)) + return stbi__tga_load(s,x,y,comp,req_comp, ri); + #endif + + return stbi__errpuc("unknown image type", "Image not of any known type, or corrupt"); +} + +static stbi_uc *stbi__convert_16_to_8(stbi__uint16 *orig, int w, int h, int channels) +{ + int i; + int img_len = w * h * channels; + stbi_uc *reduced; + + reduced = (stbi_uc *) stbi__malloc(img_len); + if (reduced == NULL) return stbi__errpuc("outofmem", "Out of memory"); + + for (i = 0; i < img_len; ++i) + reduced[i] = (stbi_uc)((orig[i] >> 8) & 0xFF); // top half of each byte is sufficient approx of 16->8 bit scaling + + STBI_FREE(orig); + return reduced; +} + +static stbi__uint16 *stbi__convert_8_to_16(stbi_uc *orig, int w, int h, int channels) +{ + int i; + int img_len = w * h * channels; + stbi__uint16 *enlarged; + + enlarged = (stbi__uint16 *) stbi__malloc(img_len*2); + if (enlarged == NULL) return (stbi__uint16 *) stbi__errpuc("outofmem", "Out of memory"); + + for (i = 0; i < img_len; ++i) + enlarged[i] = (stbi__uint16)((orig[i] << 8) + orig[i]); // replicate to high and low byte, maps 0->0, 255->0xffff + + STBI_FREE(orig); + return enlarged; +} + +static void stbi__vertical_flip(void *image, int w, int h, int bytes_per_pixel) +{ + int row; + size_t bytes_per_row = (size_t)w * bytes_per_pixel; + stbi_uc temp[2048]; + stbi_uc *bytes = (stbi_uc *)image; + + for (row = 0; row < (h>>1); row++) { + stbi_uc *row0 = bytes + row*bytes_per_row; + stbi_uc *row1 = bytes + (h - row - 1)*bytes_per_row; + // swap row0 with row1 + size_t bytes_left = bytes_per_row; + while (bytes_left) { + size_t bytes_copy = (bytes_left < sizeof(temp)) ? bytes_left : sizeof(temp); + memcpy(temp, row0, bytes_copy); + memcpy(row0, row1, bytes_copy); + memcpy(row1, temp, bytes_copy); + row0 += bytes_copy; + row1 += bytes_copy; + bytes_left -= bytes_copy; + } + } +} + +#ifndef STBI_NO_GIF +static void stbi__vertical_flip_slices(void *image, int w, int h, int z, int bytes_per_pixel) +{ + int slice; + int slice_size = w * h * bytes_per_pixel; + + stbi_uc *bytes = (stbi_uc *)image; + for (slice = 0; slice < z; ++slice) { + stbi__vertical_flip(bytes, w, h, bytes_per_pixel); + bytes += slice_size; + } +} +#endif + +static unsigned char *stbi__load_and_postprocess_8bit(stbi__context *s, int *x, int *y, int *comp, int req_comp) +{ + stbi__result_info ri; + void *result = stbi__load_main(s, x, y, comp, req_comp, &ri, 8); + + if (result == NULL) + return NULL; + + // it is the responsibility of the loaders to make sure we get either 8 or 16 bit. + STBI_ASSERT(ri.bits_per_channel == 8 || ri.bits_per_channel == 16); + + if (ri.bits_per_channel != 8) { + result = stbi__convert_16_to_8((stbi__uint16 *) result, *x, *y, req_comp == 0 ? *comp : req_comp); + ri.bits_per_channel = 8; + } + + // @TODO: move stbi__convert_format to here + + if (stbi__vertically_flip_on_load) { + int channels = req_comp ? req_comp : *comp; + stbi__vertical_flip(result, *x, *y, channels * sizeof(stbi_uc)); + } + + return (unsigned char *) result; +} + +static stbi__uint16 *stbi__load_and_postprocess_16bit(stbi__context *s, int *x, int *y, int *comp, int req_comp) +{ + stbi__result_info ri; + void *result = stbi__load_main(s, x, y, comp, req_comp, &ri, 16); + + if (result == NULL) + return NULL; + + // it is the responsibility of the loaders to make sure we get either 8 or 16 bit. + STBI_ASSERT(ri.bits_per_channel == 8 || ri.bits_per_channel == 16); + + if (ri.bits_per_channel != 16) { + result = stbi__convert_8_to_16((stbi_uc *) result, *x, *y, req_comp == 0 ? *comp : req_comp); + ri.bits_per_channel = 16; + } + + // @TODO: move stbi__convert_format16 to here + // @TODO: special case RGB-to-Y (and RGBA-to-YA) for 8-bit-to-16-bit case to keep more precision + + if (stbi__vertically_flip_on_load) { + int channels = req_comp ? req_comp : *comp; + stbi__vertical_flip(result, *x, *y, channels * sizeof(stbi__uint16)); + } + + return (stbi__uint16 *) result; +} + +#if !defined(STBI_NO_HDR) && !defined(STBI_NO_LINEAR) +static void stbi__float_postprocess(float *result, int *x, int *y, int *comp, int req_comp) +{ + if (stbi__vertically_flip_on_load && result != NULL) { + int channels = req_comp ? req_comp : *comp; + stbi__vertical_flip(result, *x, *y, channels * sizeof(float)); + } +} +#endif + +#ifndef STBI_NO_STDIO + +#if defined(_WIN32) && defined(STBI_WINDOWS_UTF8) +STBI_EXTERN __declspec(dllimport) int __stdcall MultiByteToWideChar(unsigned int cp, unsigned long flags, const char *str, int cbmb, wchar_t *widestr, int cchwide); +STBI_EXTERN __declspec(dllimport) int __stdcall WideCharToMultiByte(unsigned int cp, unsigned long flags, const wchar_t *widestr, int cchwide, char *str, int cbmb, const char *defchar, int *used_default); +#endif + +#if defined(_WIN32) && defined(STBI_WINDOWS_UTF8) +STBIDEF int stbi_convert_wchar_to_utf8(char *buffer, size_t bufferlen, const wchar_t* input) +{ + return WideCharToMultiByte(65001 /* UTF8 */, 0, input, -1, buffer, (int) bufferlen, NULL, NULL); +} +#endif + +static FILE *stbi__fopen(char const *filename, char const *mode) +{ + FILE *f; +#if defined(_WIN32) && defined(STBI_WINDOWS_UTF8) + wchar_t wMode[64]; + wchar_t wFilename[1024]; + if (0 == MultiByteToWideChar(65001 /* UTF8 */, 0, filename, -1, wFilename, sizeof(wFilename)/sizeof(*wFilename))) + return 0; + + if (0 == MultiByteToWideChar(65001 /* UTF8 */, 0, mode, -1, wMode, sizeof(wMode)/sizeof(*wMode))) + return 0; + +#if defined(_MSC_VER) && _MSC_VER >= 1400 + if (0 != _wfopen_s(&f, wFilename, wMode)) + f = 0; +#else + f = _wfopen(wFilename, wMode); +#endif + +#elif defined(_MSC_VER) && _MSC_VER >= 1400 + if (0 != fopen_s(&f, filename, mode)) + f=0; +#else + f = fopen(filename, mode); +#endif + return f; +} + + +STBIDEF stbi_uc *stbi_load(char const *filename, int *x, int *y, int *comp, int req_comp) +{ + FILE *f = stbi__fopen(filename, "rb"); + unsigned char *result; + if (!f) return stbi__errpuc("can't fopen", "Unable to open file"); + result = stbi_load_from_file(f,x,y,comp,req_comp); + fclose(f); + return result; +} + +STBIDEF stbi_uc *stbi_load_from_file(FILE *f, int *x, int *y, int *comp, int req_comp) +{ + unsigned char *result; + stbi__context s; + stbi__start_file(&s,f); + result = stbi__load_and_postprocess_8bit(&s,x,y,comp,req_comp); + if (result) { + // need to 'unget' all the characters in the IO buffer + fseek(f, - (int) (s.img_buffer_end - s.img_buffer), SEEK_CUR); + } + return result; +} + +STBIDEF stbi__uint16 *stbi_load_from_file_16(FILE *f, int *x, int *y, int *comp, int req_comp) +{ + stbi__uint16 *result; + stbi__context s; + stbi__start_file(&s,f); + result = stbi__load_and_postprocess_16bit(&s,x,y,comp,req_comp); + if (result) { + // need to 'unget' all the characters in the IO buffer + fseek(f, - (int) (s.img_buffer_end - s.img_buffer), SEEK_CUR); + } + return result; +} + +STBIDEF stbi_us *stbi_load_16(char const *filename, int *x, int *y, int *comp, int req_comp) +{ + FILE *f = stbi__fopen(filename, "rb"); + stbi__uint16 *result; + if (!f) return (stbi_us *) stbi__errpuc("can't fopen", "Unable to open file"); + result = stbi_load_from_file_16(f,x,y,comp,req_comp); + fclose(f); + return result; +} + + +#endif //!STBI_NO_STDIO + +STBIDEF stbi_us *stbi_load_16_from_memory(stbi_uc const *buffer, int len, int *x, int *y, int *channels_in_file, int desired_channels) +{ + stbi__context s; + stbi__start_mem(&s,buffer,len); + return stbi__load_and_postprocess_16bit(&s,x,y,channels_in_file,desired_channels); +} + +STBIDEF stbi_us *stbi_load_16_from_callbacks(stbi_io_callbacks const *clbk, void *user, int *x, int *y, int *channels_in_file, int desired_channels) +{ + stbi__context s; + stbi__start_callbacks(&s, (stbi_io_callbacks *)clbk, user); + return stbi__load_and_postprocess_16bit(&s,x,y,channels_in_file,desired_channels); +} + +STBIDEF stbi_uc *stbi_load_from_memory(stbi_uc const *buffer, int len, int *x, int *y, int *comp, int req_comp) +{ + stbi__context s; + stbi__start_mem(&s,buffer,len); + return stbi__load_and_postprocess_8bit(&s,x,y,comp,req_comp); +} + +STBIDEF stbi_uc *stbi_load_from_callbacks(stbi_io_callbacks const *clbk, void *user, int *x, int *y, int *comp, int req_comp) +{ + stbi__context s; + stbi__start_callbacks(&s, (stbi_io_callbacks *) clbk, user); + return stbi__load_and_postprocess_8bit(&s,x,y,comp,req_comp); +} + +#ifndef STBI_NO_GIF +STBIDEF stbi_uc *stbi_load_gif_from_memory(stbi_uc const *buffer, int len, int **delays, int *x, int *y, int *z, int *comp, int req_comp) +{ + unsigned char *result; + stbi__context s; + stbi__start_mem(&s,buffer,len); + + result = (unsigned char*) stbi__load_gif_main(&s, delays, x, y, z, comp, req_comp); + if (stbi__vertically_flip_on_load) { + stbi__vertical_flip_slices( result, *x, *y, *z, *comp ); + } + + return result; +} +#endif + +#ifndef STBI_NO_LINEAR +static float *stbi__loadf_main(stbi__context *s, int *x, int *y, int *comp, int req_comp) +{ + unsigned char *data; + #ifndef STBI_NO_HDR + if (stbi__hdr_test(s)) { + stbi__result_info ri; + float *hdr_data = stbi__hdr_load(s,x,y,comp,req_comp, &ri); + if (hdr_data) + stbi__float_postprocess(hdr_data,x,y,comp,req_comp); + return hdr_data; + } + #endif + data = stbi__load_and_postprocess_8bit(s, x, y, comp, req_comp); + if (data) + return stbi__ldr_to_hdr(data, *x, *y, req_comp ? req_comp : *comp); + return stbi__errpf("unknown image type", "Image not of any known type, or corrupt"); +} + +STBIDEF float *stbi_loadf_from_memory(stbi_uc const *buffer, int len, int *x, int *y, int *comp, int req_comp) +{ + stbi__context s; + stbi__start_mem(&s,buffer,len); + return stbi__loadf_main(&s,x,y,comp,req_comp); +} + +STBIDEF float *stbi_loadf_from_callbacks(stbi_io_callbacks const *clbk, void *user, int *x, int *y, int *comp, int req_comp) +{ + stbi__context s; + stbi__start_callbacks(&s, (stbi_io_callbacks *) clbk, user); + return stbi__loadf_main(&s,x,y,comp,req_comp); +} + +#ifndef STBI_NO_STDIO +STBIDEF float *stbi_loadf(char const *filename, int *x, int *y, int *comp, int req_comp) +{ + float *result; + FILE *f = stbi__fopen(filename, "rb"); + if (!f) return stbi__errpf("can't fopen", "Unable to open file"); + result = stbi_loadf_from_file(f,x,y,comp,req_comp); + fclose(f); + return result; +} + +STBIDEF float *stbi_loadf_from_file(FILE *f, int *x, int *y, int *comp, int req_comp) +{ + stbi__context s; + stbi__start_file(&s,f); + return stbi__loadf_main(&s,x,y,comp,req_comp); +} +#endif // !STBI_NO_STDIO + +#endif // !STBI_NO_LINEAR + +// these is-hdr-or-not is defined independent of whether STBI_NO_LINEAR is +// defined, for API simplicity; if STBI_NO_LINEAR is defined, it always +// reports false! + +STBIDEF int stbi_is_hdr_from_memory(stbi_uc const *buffer, int len) +{ + #ifndef STBI_NO_HDR + stbi__context s; + stbi__start_mem(&s,buffer,len); + return stbi__hdr_test(&s); + #else + STBI_NOTUSED(buffer); + STBI_NOTUSED(len); + return 0; + #endif +} + +#ifndef STBI_NO_STDIO +STBIDEF int stbi_is_hdr (char const *filename) +{ + FILE *f = stbi__fopen(filename, "rb"); + int result=0; + if (f) { + result = stbi_is_hdr_from_file(f); + fclose(f); + } + return result; +} + +STBIDEF int stbi_is_hdr_from_file(FILE *f) +{ + #ifndef STBI_NO_HDR + long pos = ftell(f); + int res; + stbi__context s; + stbi__start_file(&s,f); + res = stbi__hdr_test(&s); + fseek(f, pos, SEEK_SET); + return res; + #else + STBI_NOTUSED(f); + return 0; + #endif +} +#endif // !STBI_NO_STDIO + +STBIDEF int stbi_is_hdr_from_callbacks(stbi_io_callbacks const *clbk, void *user) +{ + #ifndef STBI_NO_HDR + stbi__context s; + stbi__start_callbacks(&s, (stbi_io_callbacks *) clbk, user); + return stbi__hdr_test(&s); + #else + STBI_NOTUSED(clbk); + STBI_NOTUSED(user); + return 0; + #endif +} + +#ifndef STBI_NO_LINEAR +static float stbi__l2h_gamma=2.2f, stbi__l2h_scale=1.0f; + +STBIDEF void stbi_ldr_to_hdr_gamma(float gamma) { stbi__l2h_gamma = gamma; } +STBIDEF void stbi_ldr_to_hdr_scale(float scale) { stbi__l2h_scale = scale; } +#endif + +static float stbi__h2l_gamma_i=1.0f/2.2f, stbi__h2l_scale_i=1.0f; + +STBIDEF void stbi_hdr_to_ldr_gamma(float gamma) { stbi__h2l_gamma_i = 1/gamma; } +STBIDEF void stbi_hdr_to_ldr_scale(float scale) { stbi__h2l_scale_i = 1/scale; } + + +////////////////////////////////////////////////////////////////////////////// +// +// Common code used by all image loaders +// + +enum +{ + STBI__SCAN_load=0, + STBI__SCAN_type, + STBI__SCAN_header +}; + +static void stbi__refill_buffer(stbi__context *s) +{ + int n = (s->io.read)(s->io_user_data,(char*)s->buffer_start,s->buflen); + s->callback_already_read += (int) (s->img_buffer - s->img_buffer_original); + if (n == 0) { + // at end of file, treat same as if from memory, but need to handle case + // where s->img_buffer isn't pointing to safe memory, e.g. 0-byte file + s->read_from_callbacks = 0; + s->img_buffer = s->buffer_start; + s->img_buffer_end = s->buffer_start+1; + *s->img_buffer = 0; + } else { + s->img_buffer = s->buffer_start; + s->img_buffer_end = s->buffer_start + n; + } +} + +stbi_inline static stbi_uc stbi__get8(stbi__context *s) +{ + if (s->img_buffer < s->img_buffer_end) + return *s->img_buffer++; + if (s->read_from_callbacks) { + stbi__refill_buffer(s); + return *s->img_buffer++; + } + return 0; +} + +#if defined(STBI_NO_JPEG) && defined(STBI_NO_HDR) && defined(STBI_NO_PIC) && defined(STBI_NO_PNM) +// nothing +#else +stbi_inline static int stbi__at_eof(stbi__context *s) +{ + if (s->io.read) { + if (!(s->io.eof)(s->io_user_data)) return 0; + // if feof() is true, check if buffer = end + // special case: we've only got the special 0 character at the end + if (s->read_from_callbacks == 0) return 1; + } + + return s->img_buffer >= s->img_buffer_end; +} +#endif + +#if defined(STBI_NO_JPEG) && defined(STBI_NO_PNG) && defined(STBI_NO_BMP) && defined(STBI_NO_PSD) && defined(STBI_NO_TGA) && defined(STBI_NO_GIF) && defined(STBI_NO_PIC) +// nothing +#else +static void stbi__skip(stbi__context *s, int n) +{ + if (n == 0) return; // already there! + if (n < 0) { + s->img_buffer = s->img_buffer_end; + return; + } + if (s->io.read) { + int blen = (int) (s->img_buffer_end - s->img_buffer); + if (blen < n) { + s->img_buffer = s->img_buffer_end; + (s->io.skip)(s->io_user_data, n - blen); + return; + } + } + s->img_buffer += n; +} +#endif + +#if defined(STBI_NO_PNG) && defined(STBI_NO_TGA) && defined(STBI_NO_HDR) && defined(STBI_NO_PNM) +// nothing +#else +static int stbi__getn(stbi__context *s, stbi_uc *buffer, int n) +{ + if (s->io.read) { + int blen = (int) (s->img_buffer_end - s->img_buffer); + if (blen < n) { + int res, count; + + memcpy(buffer, s->img_buffer, blen); + + count = (s->io.read)(s->io_user_data, (char*) buffer + blen, n - blen); + res = (count == (n-blen)); + s->img_buffer = s->img_buffer_end; + return res; + } + } + + if (s->img_buffer+n <= s->img_buffer_end) { + memcpy(buffer, s->img_buffer, n); + s->img_buffer += n; + return 1; + } else + return 0; +} +#endif + +#if defined(STBI_NO_JPEG) && defined(STBI_NO_PNG) && defined(STBI_NO_PSD) && defined(STBI_NO_PIC) +// nothing +#else +static int stbi__get16be(stbi__context *s) +{ + int z = stbi__get8(s); + return (z << 8) + stbi__get8(s); +} +#endif + +#if defined(STBI_NO_PNG) && defined(STBI_NO_PSD) && defined(STBI_NO_PIC) +// nothing +#else +static stbi__uint32 stbi__get32be(stbi__context *s) +{ + stbi__uint32 z = stbi__get16be(s); + return (z << 16) + stbi__get16be(s); +} +#endif + +#if defined(STBI_NO_BMP) && defined(STBI_NO_TGA) && defined(STBI_NO_GIF) +// nothing +#else +static int stbi__get16le(stbi__context *s) +{ + int z = stbi__get8(s); + return z + (stbi__get8(s) << 8); +} +#endif + +#ifndef STBI_NO_BMP +static stbi__uint32 stbi__get32le(stbi__context *s) +{ + stbi__uint32 z = stbi__get16le(s); + z += (stbi__uint32)stbi__get16le(s) << 16; + return z; +} +#endif + +#define STBI__BYTECAST(x) ((stbi_uc) ((x) & 255)) // truncate int to byte without warnings + +#if defined(STBI_NO_JPEG) && defined(STBI_NO_PNG) && defined(STBI_NO_BMP) && defined(STBI_NO_PSD) && defined(STBI_NO_TGA) && defined(STBI_NO_GIF) && defined(STBI_NO_PIC) && defined(STBI_NO_PNM) +// nothing +#else +////////////////////////////////////////////////////////////////////////////// +// +// generic converter from built-in img_n to req_comp +// individual types do this automatically as much as possible (e.g. jpeg +// does all cases internally since it needs to colorspace convert anyway, +// and it never has alpha, so very few cases ). png can automatically +// interleave an alpha=255 channel, but falls back to this for other cases +// +// assume data buffer is malloced, so malloc a new one and free that one +// only failure mode is malloc failing + +static stbi_uc stbi__compute_y(int r, int g, int b) +{ + return (stbi_uc) (((r*77) + (g*150) + (29*b)) >> 8); +} +#endif + +#if defined(STBI_NO_PNG) && defined(STBI_NO_BMP) && defined(STBI_NO_PSD) && defined(STBI_NO_TGA) && defined(STBI_NO_GIF) && defined(STBI_NO_PIC) && defined(STBI_NO_PNM) +// nothing +#else +static unsigned char *stbi__convert_format(unsigned char *data, int img_n, int req_comp, unsigned int x, unsigned int y) +{ + int i,j; + unsigned char *good; + + if (req_comp == img_n) return data; + STBI_ASSERT(req_comp >= 1 && req_comp <= 4); + + good = (unsigned char *) stbi__malloc_mad3(req_comp, x, y, 0); + if (good == NULL) { + STBI_FREE(data); + return stbi__errpuc("outofmem", "Out of memory"); + } + + for (j=0; j < (int) y; ++j) { + unsigned char *src = data + j * x * img_n ; + unsigned char *dest = good + j * x * req_comp; + + #define STBI__COMBO(a,b) ((a)*8+(b)) + #define STBI__CASE(a,b) case STBI__COMBO(a,b): for(i=x-1; i >= 0; --i, src += a, dest += b) + // convert source image with img_n components to one with req_comp components; + // avoid switch per pixel, so use switch per scanline and massive macros + switch (STBI__COMBO(img_n, req_comp)) { + STBI__CASE(1,2) { dest[0]=src[0]; dest[1]=255; } break; + STBI__CASE(1,3) { dest[0]=dest[1]=dest[2]=src[0]; } break; + STBI__CASE(1,4) { dest[0]=dest[1]=dest[2]=src[0]; dest[3]=255; } break; + STBI__CASE(2,1) { dest[0]=src[0]; } break; + STBI__CASE(2,3) { dest[0]=dest[1]=dest[2]=src[0]; } break; + STBI__CASE(2,4) { dest[0]=dest[1]=dest[2]=src[0]; dest[3]=src[1]; } break; + STBI__CASE(3,4) { dest[0]=src[0];dest[1]=src[1];dest[2]=src[2];dest[3]=255; } break; + STBI__CASE(3,1) { dest[0]=stbi__compute_y(src[0],src[1],src[2]); } break; + STBI__CASE(3,2) { dest[0]=stbi__compute_y(src[0],src[1],src[2]); dest[1] = 255; } break; + STBI__CASE(4,1) { dest[0]=stbi__compute_y(src[0],src[1],src[2]); } break; + STBI__CASE(4,2) { dest[0]=stbi__compute_y(src[0],src[1],src[2]); dest[1] = src[3]; } break; + STBI__CASE(4,3) { dest[0]=src[0];dest[1]=src[1];dest[2]=src[2]; } break; + default: STBI_ASSERT(0); STBI_FREE(data); STBI_FREE(good); return stbi__errpuc("unsupported", "Unsupported format conversion"); + } + #undef STBI__CASE + } + + STBI_FREE(data); + return good; +} +#endif + +#if defined(STBI_NO_PNG) && defined(STBI_NO_PSD) +// nothing +#else +static stbi__uint16 stbi__compute_y_16(int r, int g, int b) +{ + return (stbi__uint16) (((r*77) + (g*150) + (29*b)) >> 8); +} +#endif + +#if defined(STBI_NO_PNG) && defined(STBI_NO_PSD) +// nothing +#else +static stbi__uint16 *stbi__convert_format16(stbi__uint16 *data, int img_n, int req_comp, unsigned int x, unsigned int y) +{ + int i,j; + stbi__uint16 *good; + + if (req_comp == img_n) return data; + STBI_ASSERT(req_comp >= 1 && req_comp <= 4); + + good = (stbi__uint16 *) stbi__malloc(req_comp * x * y * 2); + if (good == NULL) { + STBI_FREE(data); + return (stbi__uint16 *) stbi__errpuc("outofmem", "Out of memory"); + } + + for (j=0; j < (int) y; ++j) { + stbi__uint16 *src = data + j * x * img_n ; + stbi__uint16 *dest = good + j * x * req_comp; + + #define STBI__COMBO(a,b) ((a)*8+(b)) + #define STBI__CASE(a,b) case STBI__COMBO(a,b): for(i=x-1; i >= 0; --i, src += a, dest += b) + // convert source image with img_n components to one with req_comp components; + // avoid switch per pixel, so use switch per scanline and massive macros + switch (STBI__COMBO(img_n, req_comp)) { + STBI__CASE(1,2) { dest[0]=src[0]; dest[1]=0xffff; } break; + STBI__CASE(1,3) { dest[0]=dest[1]=dest[2]=src[0]; } break; + STBI__CASE(1,4) { dest[0]=dest[1]=dest[2]=src[0]; dest[3]=0xffff; } break; + STBI__CASE(2,1) { dest[0]=src[0]; } break; + STBI__CASE(2,3) { dest[0]=dest[1]=dest[2]=src[0]; } break; + STBI__CASE(2,4) { dest[0]=dest[1]=dest[2]=src[0]; dest[3]=src[1]; } break; + STBI__CASE(3,4) { dest[0]=src[0];dest[1]=src[1];dest[2]=src[2];dest[3]=0xffff; } break; + STBI__CASE(3,1) { dest[0]=stbi__compute_y_16(src[0],src[1],src[2]); } break; + STBI__CASE(3,2) { dest[0]=stbi__compute_y_16(src[0],src[1],src[2]); dest[1] = 0xffff; } break; + STBI__CASE(4,1) { dest[0]=stbi__compute_y_16(src[0],src[1],src[2]); } break; + STBI__CASE(4,2) { dest[0]=stbi__compute_y_16(src[0],src[1],src[2]); dest[1] = src[3]; } break; + STBI__CASE(4,3) { dest[0]=src[0];dest[1]=src[1];dest[2]=src[2]; } break; + default: STBI_ASSERT(0); STBI_FREE(data); STBI_FREE(good); return (stbi__uint16*) stbi__errpuc("unsupported", "Unsupported format conversion"); + } + #undef STBI__CASE + } + + STBI_FREE(data); + return good; +} +#endif + +#ifndef STBI_NO_LINEAR +static float *stbi__ldr_to_hdr(stbi_uc *data, int x, int y, int comp) +{ + int i,k,n; + float *output; + if (!data) return NULL; + output = (float *) stbi__malloc_mad4(x, y, comp, sizeof(float), 0); + if (output == NULL) { STBI_FREE(data); return stbi__errpf("outofmem", "Out of memory"); } + // compute number of non-alpha components + if (comp & 1) n = comp; else n = comp-1; + for (i=0; i < x*y; ++i) { + for (k=0; k < n; ++k) { + output[i*comp + k] = (float) (pow(data[i*comp+k]/255.0f, stbi__l2h_gamma) * stbi__l2h_scale); + } + } + if (n < comp) { + for (i=0; i < x*y; ++i) { + output[i*comp + n] = data[i*comp + n]/255.0f; + } + } + STBI_FREE(data); + return output; +} +#endif + +#ifndef STBI_NO_HDR +#define stbi__float2int(x) ((int) (x)) +static stbi_uc *stbi__hdr_to_ldr(float *data, int x, int y, int comp) +{ + int i,k,n; + stbi_uc *output; + if (!data) return NULL; + output = (stbi_uc *) stbi__malloc_mad3(x, y, comp, 0); + if (output == NULL) { STBI_FREE(data); return stbi__errpuc("outofmem", "Out of memory"); } + // compute number of non-alpha components + if (comp & 1) n = comp; else n = comp-1; + for (i=0; i < x*y; ++i) { + for (k=0; k < n; ++k) { + float z = (float) pow(data[i*comp+k]*stbi__h2l_scale_i, stbi__h2l_gamma_i) * 255 + 0.5f; + if (z < 0) z = 0; + if (z > 255) z = 255; + output[i*comp + k] = (stbi_uc) stbi__float2int(z); + } + if (k < comp) { + float z = data[i*comp+k] * 255 + 0.5f; + if (z < 0) z = 0; + if (z > 255) z = 255; + output[i*comp + k] = (stbi_uc) stbi__float2int(z); + } + } + STBI_FREE(data); + return output; +} +#endif + +////////////////////////////////////////////////////////////////////////////// +// +// "baseline" JPEG/JFIF decoder +// +// simple implementation +// - doesn't support delayed output of y-dimension +// - simple interface (only one output format: 8-bit interleaved RGB) +// - doesn't try to recover corrupt jpegs +// - doesn't allow partial loading, loading multiple at once +// - still fast on x86 (copying globals into locals doesn't help x86) +// - allocates lots of intermediate memory (full size of all components) +// - non-interleaved case requires this anyway +// - allows good upsampling (see next) +// high-quality +// - upsampled channels are bilinearly interpolated, even across blocks +// - quality integer IDCT derived from IJG's 'slow' +// performance +// - fast huffman; reasonable integer IDCT +// - some SIMD kernels for common paths on targets with SSE2/NEON +// - uses a lot of intermediate memory, could cache poorly + +#ifndef STBI_NO_JPEG + +// huffman decoding acceleration +#define FAST_BITS 9 // larger handles more cases; smaller stomps less cache + +typedef struct +{ + stbi_uc fast[1 << FAST_BITS]; + // weirdly, repacking this into AoS is a 10% speed loss, instead of a win + stbi__uint16 code[256]; + stbi_uc values[256]; + stbi_uc size[257]; + unsigned int maxcode[18]; + int delta[17]; // old 'firstsymbol' - old 'firstcode' +} stbi__huffman; + +typedef struct +{ + stbi__context *s; + stbi__huffman huff_dc[4]; + stbi__huffman huff_ac[4]; + stbi__uint16 dequant[4][64]; + stbi__int16 fast_ac[4][1 << FAST_BITS]; + +// sizes for components, interleaved MCUs + int img_h_max, img_v_max; + int img_mcu_x, img_mcu_y; + int img_mcu_w, img_mcu_h; + +// definition of jpeg image component + struct + { + int id; + int h,v; + int tq; + int hd,ha; + int dc_pred; + + int x,y,w2,h2; + stbi_uc *data; + void *raw_data, *raw_coeff; + stbi_uc *linebuf; + short *coeff; // progressive only + int coeff_w, coeff_h; // number of 8x8 coefficient blocks + } img_comp[4]; + + stbi__uint32 code_buffer; // jpeg entropy-coded buffer + int code_bits; // number of valid bits + unsigned char marker; // marker seen while filling entropy buffer + int nomore; // flag if we saw a marker so must stop + + int progressive; + int spec_start; + int spec_end; + int succ_high; + int succ_low; + int eob_run; + int jfif; + int app14_color_transform; // Adobe APP14 tag + int rgb; + + int scan_n, order[4]; + int restart_interval, todo; + +// kernels + void (*idct_block_kernel)(stbi_uc *out, int out_stride, short data[64]); + void (*YCbCr_to_RGB_kernel)(stbi_uc *out, const stbi_uc *y, const stbi_uc *pcb, const stbi_uc *pcr, int count, int step); + stbi_uc *(*resample_row_hv_2_kernel)(stbi_uc *out, stbi_uc *in_near, stbi_uc *in_far, int w, int hs); +} stbi__jpeg; + +static int stbi__build_huffman(stbi__huffman *h, int *count) +{ + int i,j,k=0; + unsigned int code; + // build size list for each symbol (from JPEG spec) + for (i=0; i < 16; ++i) { + for (j=0; j < count[i]; ++j) { + h->size[k++] = (stbi_uc) (i+1); + if(k >= 257) return stbi__err("bad size list","Corrupt JPEG"); + } + } + h->size[k] = 0; + + // compute actual symbols (from jpeg spec) + code = 0; + k = 0; + for(j=1; j <= 16; ++j) { + // compute delta to add to code to compute symbol id + h->delta[j] = k - code; + if (h->size[k] == j) { + while (h->size[k] == j) + h->code[k++] = (stbi__uint16) (code++); + if (code-1 >= (1u << j)) return stbi__err("bad code lengths","Corrupt JPEG"); + } + // compute largest code + 1 for this size, preshifted as needed later + h->maxcode[j] = code << (16-j); + code <<= 1; + } + h->maxcode[j] = 0xffffffff; + + // build non-spec acceleration table; 255 is flag for not-accelerated + memset(h->fast, 255, 1 << FAST_BITS); + for (i=0; i < k; ++i) { + int s = h->size[i]; + if (s <= FAST_BITS) { + int c = h->code[i] << (FAST_BITS-s); + int m = 1 << (FAST_BITS-s); + for (j=0; j < m; ++j) { + h->fast[c+j] = (stbi_uc) i; + } + } + } + return 1; +} + +// build a table that decodes both magnitude and value of small ACs in +// one go. +static void stbi__build_fast_ac(stbi__int16 *fast_ac, stbi__huffman *h) +{ + int i; + for (i=0; i < (1 << FAST_BITS); ++i) { + stbi_uc fast = h->fast[i]; + fast_ac[i] = 0; + if (fast < 255) { + int rs = h->values[fast]; + int run = (rs >> 4) & 15; + int magbits = rs & 15; + int len = h->size[fast]; + + if (magbits && len + magbits <= FAST_BITS) { + // magnitude code followed by receive_extend code + int k = ((i << len) & ((1 << FAST_BITS) - 1)) >> (FAST_BITS - magbits); + int m = 1 << (magbits - 1); + if (k < m) k += (~0U << magbits) + 1; + // if the result is small enough, we can fit it in fast_ac table + if (k >= -128 && k <= 127) + fast_ac[i] = (stbi__int16) ((k * 256) + (run * 16) + (len + magbits)); + } + } + } +} + +static void stbi__grow_buffer_unsafe(stbi__jpeg *j) +{ + do { + unsigned int b = j->nomore ? 0 : stbi__get8(j->s); + if (b == 0xff) { + int c = stbi__get8(j->s); + while (c == 0xff) c = stbi__get8(j->s); // consume fill bytes + if (c != 0) { + j->marker = (unsigned char) c; + j->nomore = 1; + return; + } + } + j->code_buffer |= b << (24 - j->code_bits); + j->code_bits += 8; + } while (j->code_bits <= 24); +} + +// (1 << n) - 1 +static const stbi__uint32 stbi__bmask[17]={0,1,3,7,15,31,63,127,255,511,1023,2047,4095,8191,16383,32767,65535}; + +// decode a jpeg huffman value from the bitstream +stbi_inline static int stbi__jpeg_huff_decode(stbi__jpeg *j, stbi__huffman *h) +{ + unsigned int temp; + int c,k; + + if (j->code_bits < 16) stbi__grow_buffer_unsafe(j); + + // look at the top FAST_BITS and determine what symbol ID it is, + // if the code is <= FAST_BITS + c = (j->code_buffer >> (32 - FAST_BITS)) & ((1 << FAST_BITS)-1); + k = h->fast[c]; + if (k < 255) { + int s = h->size[k]; + if (s > j->code_bits) + return -1; + j->code_buffer <<= s; + j->code_bits -= s; + return h->values[k]; + } + + // naive test is to shift the code_buffer down so k bits are + // valid, then test against maxcode. To speed this up, we've + // preshifted maxcode left so that it has (16-k) 0s at the + // end; in other words, regardless of the number of bits, it + // wants to be compared against something shifted to have 16; + // that way we don't need to shift inside the loop. + temp = j->code_buffer >> 16; + for (k=FAST_BITS+1 ; ; ++k) + if (temp < h->maxcode[k]) + break; + if (k == 17) { + // error! code not found + j->code_bits -= 16; + return -1; + } + + if (k > j->code_bits) + return -1; + + // convert the huffman code to the symbol id + c = ((j->code_buffer >> (32 - k)) & stbi__bmask[k]) + h->delta[k]; + if(c < 0 || c >= 256) // symbol id out of bounds! + return -1; + STBI_ASSERT((((j->code_buffer) >> (32 - h->size[c])) & stbi__bmask[h->size[c]]) == h->code[c]); + + // convert the id to a symbol + j->code_bits -= k; + j->code_buffer <<= k; + return h->values[c]; +} + +// bias[n] = (-1<code_bits < n) stbi__grow_buffer_unsafe(j); + if (j->code_bits < n) return 0; // ran out of bits from stream, return 0s intead of continuing + + sgn = j->code_buffer >> 31; // sign bit always in MSB; 0 if MSB clear (positive), 1 if MSB set (negative) + k = stbi_lrot(j->code_buffer, n); + j->code_buffer = k & ~stbi__bmask[n]; + k &= stbi__bmask[n]; + j->code_bits -= n; + return k + (stbi__jbias[n] & (sgn - 1)); +} + +// get some unsigned bits +stbi_inline static int stbi__jpeg_get_bits(stbi__jpeg *j, int n) +{ + unsigned int k; + if (j->code_bits < n) stbi__grow_buffer_unsafe(j); + if (j->code_bits < n) return 0; // ran out of bits from stream, return 0s intead of continuing + k = stbi_lrot(j->code_buffer, n); + j->code_buffer = k & ~stbi__bmask[n]; + k &= stbi__bmask[n]; + j->code_bits -= n; + return k; +} + +stbi_inline static int stbi__jpeg_get_bit(stbi__jpeg *j) +{ + unsigned int k; + if (j->code_bits < 1) stbi__grow_buffer_unsafe(j); + if (j->code_bits < 1) return 0; // ran out of bits from stream, return 0s intead of continuing + k = j->code_buffer; + j->code_buffer <<= 1; + --j->code_bits; + return k & 0x80000000; +} + +// given a value that's at position X in the zigzag stream, +// where does it appear in the 8x8 matrix coded as row-major? +static const stbi_uc stbi__jpeg_dezigzag[64+15] = +{ + 0, 1, 8, 16, 9, 2, 3, 10, + 17, 24, 32, 25, 18, 11, 4, 5, + 12, 19, 26, 33, 40, 48, 41, 34, + 27, 20, 13, 6, 7, 14, 21, 28, + 35, 42, 49, 56, 57, 50, 43, 36, + 29, 22, 15, 23, 30, 37, 44, 51, + 58, 59, 52, 45, 38, 31, 39, 46, + 53, 60, 61, 54, 47, 55, 62, 63, + // let corrupt input sample past end + 63, 63, 63, 63, 63, 63, 63, 63, + 63, 63, 63, 63, 63, 63, 63 +}; + +// decode one 64-entry block-- +static int stbi__jpeg_decode_block(stbi__jpeg *j, short data[64], stbi__huffman *hdc, stbi__huffman *hac, stbi__int16 *fac, int b, stbi__uint16 *dequant) +{ + int diff,dc,k; + int t; + + if (j->code_bits < 16) stbi__grow_buffer_unsafe(j); + t = stbi__jpeg_huff_decode(j, hdc); + if (t < 0 || t > 15) return stbi__err("bad huffman code","Corrupt JPEG"); + + // 0 all the ac values now so we can do it 32-bits at a time + memset(data,0,64*sizeof(data[0])); + + diff = t ? stbi__extend_receive(j, t) : 0; + if (!stbi__addints_valid(j->img_comp[b].dc_pred, diff)) return stbi__err("bad delta","Corrupt JPEG"); + dc = j->img_comp[b].dc_pred + diff; + j->img_comp[b].dc_pred = dc; + if (!stbi__mul2shorts_valid(dc, dequant[0])) return stbi__err("can't merge dc and ac", "Corrupt JPEG"); + data[0] = (short) (dc * dequant[0]); + + // decode AC components, see JPEG spec + k = 1; + do { + unsigned int zig; + int c,r,s; + if (j->code_bits < 16) stbi__grow_buffer_unsafe(j); + c = (j->code_buffer >> (32 - FAST_BITS)) & ((1 << FAST_BITS)-1); + r = fac[c]; + if (r) { // fast-AC path + k += (r >> 4) & 15; // run + s = r & 15; // combined length + if (s > j->code_bits) return stbi__err("bad huffman code", "Combined length longer than code bits available"); + j->code_buffer <<= s; + j->code_bits -= s; + // decode into unzigzag'd location + zig = stbi__jpeg_dezigzag[k++]; + data[zig] = (short) ((r >> 8) * dequant[zig]); + } else { + int rs = stbi__jpeg_huff_decode(j, hac); + if (rs < 0) return stbi__err("bad huffman code","Corrupt JPEG"); + s = rs & 15; + r = rs >> 4; + if (s == 0) { + if (rs != 0xf0) break; // end block + k += 16; + } else { + k += r; + // decode into unzigzag'd location + zig = stbi__jpeg_dezigzag[k++]; + data[zig] = (short) (stbi__extend_receive(j,s) * dequant[zig]); + } + } + } while (k < 64); + return 1; +} + +static int stbi__jpeg_decode_block_prog_dc(stbi__jpeg *j, short data[64], stbi__huffman *hdc, int b) +{ + int diff,dc; + int t; + if (j->spec_end != 0) return stbi__err("can't merge dc and ac", "Corrupt JPEG"); + + if (j->code_bits < 16) stbi__grow_buffer_unsafe(j); + + if (j->succ_high == 0) { + // first scan for DC coefficient, must be first + memset(data,0,64*sizeof(data[0])); // 0 all the ac values now + t = stbi__jpeg_huff_decode(j, hdc); + if (t < 0 || t > 15) return stbi__err("can't merge dc and ac", "Corrupt JPEG"); + diff = t ? stbi__extend_receive(j, t) : 0; + + if (!stbi__addints_valid(j->img_comp[b].dc_pred, diff)) return stbi__err("bad delta", "Corrupt JPEG"); + dc = j->img_comp[b].dc_pred + diff; + j->img_comp[b].dc_pred = dc; + if (!stbi__mul2shorts_valid(dc, 1 << j->succ_low)) return stbi__err("can't merge dc and ac", "Corrupt JPEG"); + data[0] = (short) (dc * (1 << j->succ_low)); + } else { + // refinement scan for DC coefficient + if (stbi__jpeg_get_bit(j)) + data[0] += (short) (1 << j->succ_low); + } + return 1; +} + +// @OPTIMIZE: store non-zigzagged during the decode passes, +// and only de-zigzag when dequantizing +static int stbi__jpeg_decode_block_prog_ac(stbi__jpeg *j, short data[64], stbi__huffman *hac, stbi__int16 *fac) +{ + int k; + if (j->spec_start == 0) return stbi__err("can't merge dc and ac", "Corrupt JPEG"); + + if (j->succ_high == 0) { + int shift = j->succ_low; + + if (j->eob_run) { + --j->eob_run; + return 1; + } + + k = j->spec_start; + do { + unsigned int zig; + int c,r,s; + if (j->code_bits < 16) stbi__grow_buffer_unsafe(j); + c = (j->code_buffer >> (32 - FAST_BITS)) & ((1 << FAST_BITS)-1); + r = fac[c]; + if (r) { // fast-AC path + k += (r >> 4) & 15; // run + s = r & 15; // combined length + if (s > j->code_bits) return stbi__err("bad huffman code", "Combined length longer than code bits available"); + j->code_buffer <<= s; + j->code_bits -= s; + zig = stbi__jpeg_dezigzag[k++]; + data[zig] = (short) ((r >> 8) * (1 << shift)); + } else { + int rs = stbi__jpeg_huff_decode(j, hac); + if (rs < 0) return stbi__err("bad huffman code","Corrupt JPEG"); + s = rs & 15; + r = rs >> 4; + if (s == 0) { + if (r < 15) { + j->eob_run = (1 << r); + if (r) + j->eob_run += stbi__jpeg_get_bits(j, r); + --j->eob_run; + break; + } + k += 16; + } else { + k += r; + zig = stbi__jpeg_dezigzag[k++]; + data[zig] = (short) (stbi__extend_receive(j,s) * (1 << shift)); + } + } + } while (k <= j->spec_end); + } else { + // refinement scan for these AC coefficients + + short bit = (short) (1 << j->succ_low); + + if (j->eob_run) { + --j->eob_run; + for (k = j->spec_start; k <= j->spec_end; ++k) { + short *p = &data[stbi__jpeg_dezigzag[k]]; + if (*p != 0) + if (stbi__jpeg_get_bit(j)) + if ((*p & bit)==0) { + if (*p > 0) + *p += bit; + else + *p -= bit; + } + } + } else { + k = j->spec_start; + do { + int r,s; + int rs = stbi__jpeg_huff_decode(j, hac); // @OPTIMIZE see if we can use the fast path here, advance-by-r is so slow, eh + if (rs < 0) return stbi__err("bad huffman code","Corrupt JPEG"); + s = rs & 15; + r = rs >> 4; + if (s == 0) { + if (r < 15) { + j->eob_run = (1 << r) - 1; + if (r) + j->eob_run += stbi__jpeg_get_bits(j, r); + r = 64; // force end of block + } else { + // r=15 s=0 should write 16 0s, so we just do + // a run of 15 0s and then write s (which is 0), + // so we don't have to do anything special here + } + } else { + if (s != 1) return stbi__err("bad huffman code", "Corrupt JPEG"); + // sign bit + if (stbi__jpeg_get_bit(j)) + s = bit; + else + s = -bit; + } + + // advance by r + while (k <= j->spec_end) { + short *p = &data[stbi__jpeg_dezigzag[k++]]; + if (*p != 0) { + if (stbi__jpeg_get_bit(j)) + if ((*p & bit)==0) { + if (*p > 0) + *p += bit; + else + *p -= bit; + } + } else { + if (r == 0) { + *p = (short) s; + break; + } + --r; + } + } + } while (k <= j->spec_end); + } + } + return 1; +} + +// take a -128..127 value and stbi__clamp it and convert to 0..255 +stbi_inline static stbi_uc stbi__clamp(int x) +{ + // trick to use a single test to catch both cases + if ((unsigned int) x > 255) { + if (x < 0) return 0; + if (x > 255) return 255; + } + return (stbi_uc) x; +} + +#define stbi__f2f(x) ((int) (((x) * 4096 + 0.5))) +#define stbi__fsh(x) ((x) * 4096) + +// derived from jidctint -- DCT_ISLOW +#define STBI__IDCT_1D(s0,s1,s2,s3,s4,s5,s6,s7) \ + int t0,t1,t2,t3,p1,p2,p3,p4,p5,x0,x1,x2,x3; \ + p2 = s2; \ + p3 = s6; \ + p1 = (p2+p3) * stbi__f2f(0.5411961f); \ + t2 = p1 + p3*stbi__f2f(-1.847759065f); \ + t3 = p1 + p2*stbi__f2f( 0.765366865f); \ + p2 = s0; \ + p3 = s4; \ + t0 = stbi__fsh(p2+p3); \ + t1 = stbi__fsh(p2-p3); \ + x0 = t0+t3; \ + x3 = t0-t3; \ + x1 = t1+t2; \ + x2 = t1-t2; \ + t0 = s7; \ + t1 = s5; \ + t2 = s3; \ + t3 = s1; \ + p3 = t0+t2; \ + p4 = t1+t3; \ + p1 = t0+t3; \ + p2 = t1+t2; \ + p5 = (p3+p4)*stbi__f2f( 1.175875602f); \ + t0 = t0*stbi__f2f( 0.298631336f); \ + t1 = t1*stbi__f2f( 2.053119869f); \ + t2 = t2*stbi__f2f( 3.072711026f); \ + t3 = t3*stbi__f2f( 1.501321110f); \ + p1 = p5 + p1*stbi__f2f(-0.899976223f); \ + p2 = p5 + p2*stbi__f2f(-2.562915447f); \ + p3 = p3*stbi__f2f(-1.961570560f); \ + p4 = p4*stbi__f2f(-0.390180644f); \ + t3 += p1+p4; \ + t2 += p2+p3; \ + t1 += p2+p4; \ + t0 += p1+p3; + +static void stbi__idct_block(stbi_uc *out, int out_stride, short data[64]) +{ + int i,val[64],*v=val; + stbi_uc *o; + short *d = data; + + // columns + for (i=0; i < 8; ++i,++d, ++v) { + // if all zeroes, shortcut -- this avoids dequantizing 0s and IDCTing + if (d[ 8]==0 && d[16]==0 && d[24]==0 && d[32]==0 + && d[40]==0 && d[48]==0 && d[56]==0) { + // no shortcut 0 seconds + // (1|2|3|4|5|6|7)==0 0 seconds + // all separate -0.047 seconds + // 1 && 2|3 && 4|5 && 6|7: -0.047 seconds + int dcterm = d[0]*4; + v[0] = v[8] = v[16] = v[24] = v[32] = v[40] = v[48] = v[56] = dcterm; + } else { + STBI__IDCT_1D(d[ 0],d[ 8],d[16],d[24],d[32],d[40],d[48],d[56]) + // constants scaled things up by 1<<12; let's bring them back + // down, but keep 2 extra bits of precision + x0 += 512; x1 += 512; x2 += 512; x3 += 512; + v[ 0] = (x0+t3) >> 10; + v[56] = (x0-t3) >> 10; + v[ 8] = (x1+t2) >> 10; + v[48] = (x1-t2) >> 10; + v[16] = (x2+t1) >> 10; + v[40] = (x2-t1) >> 10; + v[24] = (x3+t0) >> 10; + v[32] = (x3-t0) >> 10; + } + } + + for (i=0, v=val, o=out; i < 8; ++i,v+=8,o+=out_stride) { + // no fast case since the first 1D IDCT spread components out + STBI__IDCT_1D(v[0],v[1],v[2],v[3],v[4],v[5],v[6],v[7]) + // constants scaled things up by 1<<12, plus we had 1<<2 from first + // loop, plus horizontal and vertical each scale by sqrt(8) so together + // we've got an extra 1<<3, so 1<<17 total we need to remove. + // so we want to round that, which means adding 0.5 * 1<<17, + // aka 65536. Also, we'll end up with -128 to 127 that we want + // to encode as 0..255 by adding 128, so we'll add that before the shift + x0 += 65536 + (128<<17); + x1 += 65536 + (128<<17); + x2 += 65536 + (128<<17); + x3 += 65536 + (128<<17); + // tried computing the shifts into temps, or'ing the temps to see + // if any were out of range, but that was slower + o[0] = stbi__clamp((x0+t3) >> 17); + o[7] = stbi__clamp((x0-t3) >> 17); + o[1] = stbi__clamp((x1+t2) >> 17); + o[6] = stbi__clamp((x1-t2) >> 17); + o[2] = stbi__clamp((x2+t1) >> 17); + o[5] = stbi__clamp((x2-t1) >> 17); + o[3] = stbi__clamp((x3+t0) >> 17); + o[4] = stbi__clamp((x3-t0) >> 17); + } +} + +#ifdef STBI_SSE2 +// sse2 integer IDCT. not the fastest possible implementation but it +// produces bit-identical results to the generic C version so it's +// fully "transparent". +static void stbi__idct_simd(stbi_uc *out, int out_stride, short data[64]) +{ + // This is constructed to match our regular (generic) integer IDCT exactly. + __m128i row0, row1, row2, row3, row4, row5, row6, row7; + __m128i tmp; + + // dot product constant: even elems=x, odd elems=y + #define dct_const(x,y) _mm_setr_epi16((x),(y),(x),(y),(x),(y),(x),(y)) + + // out(0) = c0[even]*x + c0[odd]*y (c0, x, y 16-bit, out 32-bit) + // out(1) = c1[even]*x + c1[odd]*y + #define dct_rot(out0,out1, x,y,c0,c1) \ + __m128i c0##lo = _mm_unpacklo_epi16((x),(y)); \ + __m128i c0##hi = _mm_unpackhi_epi16((x),(y)); \ + __m128i out0##_l = _mm_madd_epi16(c0##lo, c0); \ + __m128i out0##_h = _mm_madd_epi16(c0##hi, c0); \ + __m128i out1##_l = _mm_madd_epi16(c0##lo, c1); \ + __m128i out1##_h = _mm_madd_epi16(c0##hi, c1) + + // out = in << 12 (in 16-bit, out 32-bit) + #define dct_widen(out, in) \ + __m128i out##_l = _mm_srai_epi32(_mm_unpacklo_epi16(_mm_setzero_si128(), (in)), 4); \ + __m128i out##_h = _mm_srai_epi32(_mm_unpackhi_epi16(_mm_setzero_si128(), (in)), 4) + + // wide add + #define dct_wadd(out, a, b) \ + __m128i out##_l = _mm_add_epi32(a##_l, b##_l); \ + __m128i out##_h = _mm_add_epi32(a##_h, b##_h) + + // wide sub + #define dct_wsub(out, a, b) \ + __m128i out##_l = _mm_sub_epi32(a##_l, b##_l); \ + __m128i out##_h = _mm_sub_epi32(a##_h, b##_h) + + // butterfly a/b, add bias, then shift by "s" and pack + #define dct_bfly32o(out0, out1, a,b,bias,s) \ + { \ + __m128i abiased_l = _mm_add_epi32(a##_l, bias); \ + __m128i abiased_h = _mm_add_epi32(a##_h, bias); \ + dct_wadd(sum, abiased, b); \ + dct_wsub(dif, abiased, b); \ + out0 = _mm_packs_epi32(_mm_srai_epi32(sum_l, s), _mm_srai_epi32(sum_h, s)); \ + out1 = _mm_packs_epi32(_mm_srai_epi32(dif_l, s), _mm_srai_epi32(dif_h, s)); \ + } + + // 8-bit interleave step (for transposes) + #define dct_interleave8(a, b) \ + tmp = a; \ + a = _mm_unpacklo_epi8(a, b); \ + b = _mm_unpackhi_epi8(tmp, b) + + // 16-bit interleave step (for transposes) + #define dct_interleave16(a, b) \ + tmp = a; \ + a = _mm_unpacklo_epi16(a, b); \ + b = _mm_unpackhi_epi16(tmp, b) + + #define dct_pass(bias,shift) \ + { \ + /* even part */ \ + dct_rot(t2e,t3e, row2,row6, rot0_0,rot0_1); \ + __m128i sum04 = _mm_add_epi16(row0, row4); \ + __m128i dif04 = _mm_sub_epi16(row0, row4); \ + dct_widen(t0e, sum04); \ + dct_widen(t1e, dif04); \ + dct_wadd(x0, t0e, t3e); \ + dct_wsub(x3, t0e, t3e); \ + dct_wadd(x1, t1e, t2e); \ + dct_wsub(x2, t1e, t2e); \ + /* odd part */ \ + dct_rot(y0o,y2o, row7,row3, rot2_0,rot2_1); \ + dct_rot(y1o,y3o, row5,row1, rot3_0,rot3_1); \ + __m128i sum17 = _mm_add_epi16(row1, row7); \ + __m128i sum35 = _mm_add_epi16(row3, row5); \ + dct_rot(y4o,y5o, sum17,sum35, rot1_0,rot1_1); \ + dct_wadd(x4, y0o, y4o); \ + dct_wadd(x5, y1o, y5o); \ + dct_wadd(x6, y2o, y5o); \ + dct_wadd(x7, y3o, y4o); \ + dct_bfly32o(row0,row7, x0,x7,bias,shift); \ + dct_bfly32o(row1,row6, x1,x6,bias,shift); \ + dct_bfly32o(row2,row5, x2,x5,bias,shift); \ + dct_bfly32o(row3,row4, x3,x4,bias,shift); \ + } + + __m128i rot0_0 = dct_const(stbi__f2f(0.5411961f), stbi__f2f(0.5411961f) + stbi__f2f(-1.847759065f)); + __m128i rot0_1 = dct_const(stbi__f2f(0.5411961f) + stbi__f2f( 0.765366865f), stbi__f2f(0.5411961f)); + __m128i rot1_0 = dct_const(stbi__f2f(1.175875602f) + stbi__f2f(-0.899976223f), stbi__f2f(1.175875602f)); + __m128i rot1_1 = dct_const(stbi__f2f(1.175875602f), stbi__f2f(1.175875602f) + stbi__f2f(-2.562915447f)); + __m128i rot2_0 = dct_const(stbi__f2f(-1.961570560f) + stbi__f2f( 0.298631336f), stbi__f2f(-1.961570560f)); + __m128i rot2_1 = dct_const(stbi__f2f(-1.961570560f), stbi__f2f(-1.961570560f) + stbi__f2f( 3.072711026f)); + __m128i rot3_0 = dct_const(stbi__f2f(-0.390180644f) + stbi__f2f( 2.053119869f), stbi__f2f(-0.390180644f)); + __m128i rot3_1 = dct_const(stbi__f2f(-0.390180644f), stbi__f2f(-0.390180644f) + stbi__f2f( 1.501321110f)); + + // rounding biases in column/row passes, see stbi__idct_block for explanation. + __m128i bias_0 = _mm_set1_epi32(512); + __m128i bias_1 = _mm_set1_epi32(65536 + (128<<17)); + + // load + row0 = _mm_load_si128((const __m128i *) (data + 0*8)); + row1 = _mm_load_si128((const __m128i *) (data + 1*8)); + row2 = _mm_load_si128((const __m128i *) (data + 2*8)); + row3 = _mm_load_si128((const __m128i *) (data + 3*8)); + row4 = _mm_load_si128((const __m128i *) (data + 4*8)); + row5 = _mm_load_si128((const __m128i *) (data + 5*8)); + row6 = _mm_load_si128((const __m128i *) (data + 6*8)); + row7 = _mm_load_si128((const __m128i *) (data + 7*8)); + + // column pass + dct_pass(bias_0, 10); + + { + // 16bit 8x8 transpose pass 1 + dct_interleave16(row0, row4); + dct_interleave16(row1, row5); + dct_interleave16(row2, row6); + dct_interleave16(row3, row7); + + // transpose pass 2 + dct_interleave16(row0, row2); + dct_interleave16(row1, row3); + dct_interleave16(row4, row6); + dct_interleave16(row5, row7); + + // transpose pass 3 + dct_interleave16(row0, row1); + dct_interleave16(row2, row3); + dct_interleave16(row4, row5); + dct_interleave16(row6, row7); + } + + // row pass + dct_pass(bias_1, 17); + + { + // pack + __m128i p0 = _mm_packus_epi16(row0, row1); // a0a1a2a3...a7b0b1b2b3...b7 + __m128i p1 = _mm_packus_epi16(row2, row3); + __m128i p2 = _mm_packus_epi16(row4, row5); + __m128i p3 = _mm_packus_epi16(row6, row7); + + // 8bit 8x8 transpose pass 1 + dct_interleave8(p0, p2); // a0e0a1e1... + dct_interleave8(p1, p3); // c0g0c1g1... + + // transpose pass 2 + dct_interleave8(p0, p1); // a0c0e0g0... + dct_interleave8(p2, p3); // b0d0f0h0... + + // transpose pass 3 + dct_interleave8(p0, p2); // a0b0c0d0... + dct_interleave8(p1, p3); // a4b4c4d4... + + // store + _mm_storel_epi64((__m128i *) out, p0); out += out_stride; + _mm_storel_epi64((__m128i *) out, _mm_shuffle_epi32(p0, 0x4e)); out += out_stride; + _mm_storel_epi64((__m128i *) out, p2); out += out_stride; + _mm_storel_epi64((__m128i *) out, _mm_shuffle_epi32(p2, 0x4e)); out += out_stride; + _mm_storel_epi64((__m128i *) out, p1); out += out_stride; + _mm_storel_epi64((__m128i *) out, _mm_shuffle_epi32(p1, 0x4e)); out += out_stride; + _mm_storel_epi64((__m128i *) out, p3); out += out_stride; + _mm_storel_epi64((__m128i *) out, _mm_shuffle_epi32(p3, 0x4e)); + } + +#undef dct_const +#undef dct_rot +#undef dct_widen +#undef dct_wadd +#undef dct_wsub +#undef dct_bfly32o +#undef dct_interleave8 +#undef dct_interleave16 +#undef dct_pass +} + +#endif // STBI_SSE2 + +#ifdef STBI_NEON + +// NEON integer IDCT. should produce bit-identical +// results to the generic C version. +static void stbi__idct_simd(stbi_uc *out, int out_stride, short data[64]) +{ + int16x8_t row0, row1, row2, row3, row4, row5, row6, row7; + + int16x4_t rot0_0 = vdup_n_s16(stbi__f2f(0.5411961f)); + int16x4_t rot0_1 = vdup_n_s16(stbi__f2f(-1.847759065f)); + int16x4_t rot0_2 = vdup_n_s16(stbi__f2f( 0.765366865f)); + int16x4_t rot1_0 = vdup_n_s16(stbi__f2f( 1.175875602f)); + int16x4_t rot1_1 = vdup_n_s16(stbi__f2f(-0.899976223f)); + int16x4_t rot1_2 = vdup_n_s16(stbi__f2f(-2.562915447f)); + int16x4_t rot2_0 = vdup_n_s16(stbi__f2f(-1.961570560f)); + int16x4_t rot2_1 = vdup_n_s16(stbi__f2f(-0.390180644f)); + int16x4_t rot3_0 = vdup_n_s16(stbi__f2f( 0.298631336f)); + int16x4_t rot3_1 = vdup_n_s16(stbi__f2f( 2.053119869f)); + int16x4_t rot3_2 = vdup_n_s16(stbi__f2f( 3.072711026f)); + int16x4_t rot3_3 = vdup_n_s16(stbi__f2f( 1.501321110f)); + +#define dct_long_mul(out, inq, coeff) \ + int32x4_t out##_l = vmull_s16(vget_low_s16(inq), coeff); \ + int32x4_t out##_h = vmull_s16(vget_high_s16(inq), coeff) + +#define dct_long_mac(out, acc, inq, coeff) \ + int32x4_t out##_l = vmlal_s16(acc##_l, vget_low_s16(inq), coeff); \ + int32x4_t out##_h = vmlal_s16(acc##_h, vget_high_s16(inq), coeff) + +#define dct_widen(out, inq) \ + int32x4_t out##_l = vshll_n_s16(vget_low_s16(inq), 12); \ + int32x4_t out##_h = vshll_n_s16(vget_high_s16(inq), 12) + +// wide add +#define dct_wadd(out, a, b) \ + int32x4_t out##_l = vaddq_s32(a##_l, b##_l); \ + int32x4_t out##_h = vaddq_s32(a##_h, b##_h) + +// wide sub +#define dct_wsub(out, a, b) \ + int32x4_t out##_l = vsubq_s32(a##_l, b##_l); \ + int32x4_t out##_h = vsubq_s32(a##_h, b##_h) + +// butterfly a/b, then shift using "shiftop" by "s" and pack +#define dct_bfly32o(out0,out1, a,b,shiftop,s) \ + { \ + dct_wadd(sum, a, b); \ + dct_wsub(dif, a, b); \ + out0 = vcombine_s16(shiftop(sum_l, s), shiftop(sum_h, s)); \ + out1 = vcombine_s16(shiftop(dif_l, s), shiftop(dif_h, s)); \ + } + +#define dct_pass(shiftop, shift) \ + { \ + /* even part */ \ + int16x8_t sum26 = vaddq_s16(row2, row6); \ + dct_long_mul(p1e, sum26, rot0_0); \ + dct_long_mac(t2e, p1e, row6, rot0_1); \ + dct_long_mac(t3e, p1e, row2, rot0_2); \ + int16x8_t sum04 = vaddq_s16(row0, row4); \ + int16x8_t dif04 = vsubq_s16(row0, row4); \ + dct_widen(t0e, sum04); \ + dct_widen(t1e, dif04); \ + dct_wadd(x0, t0e, t3e); \ + dct_wsub(x3, t0e, t3e); \ + dct_wadd(x1, t1e, t2e); \ + dct_wsub(x2, t1e, t2e); \ + /* odd part */ \ + int16x8_t sum15 = vaddq_s16(row1, row5); \ + int16x8_t sum17 = vaddq_s16(row1, row7); \ + int16x8_t sum35 = vaddq_s16(row3, row5); \ + int16x8_t sum37 = vaddq_s16(row3, row7); \ + int16x8_t sumodd = vaddq_s16(sum17, sum35); \ + dct_long_mul(p5o, sumodd, rot1_0); \ + dct_long_mac(p1o, p5o, sum17, rot1_1); \ + dct_long_mac(p2o, p5o, sum35, rot1_2); \ + dct_long_mul(p3o, sum37, rot2_0); \ + dct_long_mul(p4o, sum15, rot2_1); \ + dct_wadd(sump13o, p1o, p3o); \ + dct_wadd(sump24o, p2o, p4o); \ + dct_wadd(sump23o, p2o, p3o); \ + dct_wadd(sump14o, p1o, p4o); \ + dct_long_mac(x4, sump13o, row7, rot3_0); \ + dct_long_mac(x5, sump24o, row5, rot3_1); \ + dct_long_mac(x6, sump23o, row3, rot3_2); \ + dct_long_mac(x7, sump14o, row1, rot3_3); \ + dct_bfly32o(row0,row7, x0,x7,shiftop,shift); \ + dct_bfly32o(row1,row6, x1,x6,shiftop,shift); \ + dct_bfly32o(row2,row5, x2,x5,shiftop,shift); \ + dct_bfly32o(row3,row4, x3,x4,shiftop,shift); \ + } + + // load + row0 = vld1q_s16(data + 0*8); + row1 = vld1q_s16(data + 1*8); + row2 = vld1q_s16(data + 2*8); + row3 = vld1q_s16(data + 3*8); + row4 = vld1q_s16(data + 4*8); + row5 = vld1q_s16(data + 5*8); + row6 = vld1q_s16(data + 6*8); + row7 = vld1q_s16(data + 7*8); + + // add DC bias + row0 = vaddq_s16(row0, vsetq_lane_s16(1024, vdupq_n_s16(0), 0)); + + // column pass + dct_pass(vrshrn_n_s32, 10); + + // 16bit 8x8 transpose + { +// these three map to a single VTRN.16, VTRN.32, and VSWP, respectively. +// whether compilers actually get this is another story, sadly. +#define dct_trn16(x, y) { int16x8x2_t t = vtrnq_s16(x, y); x = t.val[0]; y = t.val[1]; } +#define dct_trn32(x, y) { int32x4x2_t t = vtrnq_s32(vreinterpretq_s32_s16(x), vreinterpretq_s32_s16(y)); x = vreinterpretq_s16_s32(t.val[0]); y = vreinterpretq_s16_s32(t.val[1]); } +#define dct_trn64(x, y) { int16x8_t x0 = x; int16x8_t y0 = y; x = vcombine_s16(vget_low_s16(x0), vget_low_s16(y0)); y = vcombine_s16(vget_high_s16(x0), vget_high_s16(y0)); } + + // pass 1 + dct_trn16(row0, row1); // a0b0a2b2a4b4a6b6 + dct_trn16(row2, row3); + dct_trn16(row4, row5); + dct_trn16(row6, row7); + + // pass 2 + dct_trn32(row0, row2); // a0b0c0d0a4b4c4d4 + dct_trn32(row1, row3); + dct_trn32(row4, row6); + dct_trn32(row5, row7); + + // pass 3 + dct_trn64(row0, row4); // a0b0c0d0e0f0g0h0 + dct_trn64(row1, row5); + dct_trn64(row2, row6); + dct_trn64(row3, row7); + +#undef dct_trn16 +#undef dct_trn32 +#undef dct_trn64 + } + + // row pass + // vrshrn_n_s32 only supports shifts up to 16, we need + // 17. so do a non-rounding shift of 16 first then follow + // up with a rounding shift by 1. + dct_pass(vshrn_n_s32, 16); + + { + // pack and round + uint8x8_t p0 = vqrshrun_n_s16(row0, 1); + uint8x8_t p1 = vqrshrun_n_s16(row1, 1); + uint8x8_t p2 = vqrshrun_n_s16(row2, 1); + uint8x8_t p3 = vqrshrun_n_s16(row3, 1); + uint8x8_t p4 = vqrshrun_n_s16(row4, 1); + uint8x8_t p5 = vqrshrun_n_s16(row5, 1); + uint8x8_t p6 = vqrshrun_n_s16(row6, 1); + uint8x8_t p7 = vqrshrun_n_s16(row7, 1); + + // again, these can translate into one instruction, but often don't. +#define dct_trn8_8(x, y) { uint8x8x2_t t = vtrn_u8(x, y); x = t.val[0]; y = t.val[1]; } +#define dct_trn8_16(x, y) { uint16x4x2_t t = vtrn_u16(vreinterpret_u16_u8(x), vreinterpret_u16_u8(y)); x = vreinterpret_u8_u16(t.val[0]); y = vreinterpret_u8_u16(t.val[1]); } +#define dct_trn8_32(x, y) { uint32x2x2_t t = vtrn_u32(vreinterpret_u32_u8(x), vreinterpret_u32_u8(y)); x = vreinterpret_u8_u32(t.val[0]); y = vreinterpret_u8_u32(t.val[1]); } + + // sadly can't use interleaved stores here since we only write + // 8 bytes to each scan line! + + // 8x8 8-bit transpose pass 1 + dct_trn8_8(p0, p1); + dct_trn8_8(p2, p3); + dct_trn8_8(p4, p5); + dct_trn8_8(p6, p7); + + // pass 2 + dct_trn8_16(p0, p2); + dct_trn8_16(p1, p3); + dct_trn8_16(p4, p6); + dct_trn8_16(p5, p7); + + // pass 3 + dct_trn8_32(p0, p4); + dct_trn8_32(p1, p5); + dct_trn8_32(p2, p6); + dct_trn8_32(p3, p7); + + // store + vst1_u8(out, p0); out += out_stride; + vst1_u8(out, p1); out += out_stride; + vst1_u8(out, p2); out += out_stride; + vst1_u8(out, p3); out += out_stride; + vst1_u8(out, p4); out += out_stride; + vst1_u8(out, p5); out += out_stride; + vst1_u8(out, p6); out += out_stride; + vst1_u8(out, p7); + +#undef dct_trn8_8 +#undef dct_trn8_16 +#undef dct_trn8_32 + } + +#undef dct_long_mul +#undef dct_long_mac +#undef dct_widen +#undef dct_wadd +#undef dct_wsub +#undef dct_bfly32o +#undef dct_pass +} + +#endif // STBI_NEON + +#define STBI__MARKER_none 0xff +// if there's a pending marker from the entropy stream, return that +// otherwise, fetch from the stream and get a marker. if there's no +// marker, return 0xff, which is never a valid marker value +static stbi_uc stbi__get_marker(stbi__jpeg *j) +{ + stbi_uc x; + if (j->marker != STBI__MARKER_none) { x = j->marker; j->marker = STBI__MARKER_none; return x; } + x = stbi__get8(j->s); + if (x != 0xff) return STBI__MARKER_none; + while (x == 0xff) + x = stbi__get8(j->s); // consume repeated 0xff fill bytes + return x; +} + +// in each scan, we'll have scan_n components, and the order +// of the components is specified by order[] +#define STBI__RESTART(x) ((x) >= 0xd0 && (x) <= 0xd7) + +// after a restart interval, stbi__jpeg_reset the entropy decoder and +// the dc prediction +static void stbi__jpeg_reset(stbi__jpeg *j) +{ + j->code_bits = 0; + j->code_buffer = 0; + j->nomore = 0; + j->img_comp[0].dc_pred = j->img_comp[1].dc_pred = j->img_comp[2].dc_pred = j->img_comp[3].dc_pred = 0; + j->marker = STBI__MARKER_none; + j->todo = j->restart_interval ? j->restart_interval : 0x7fffffff; + j->eob_run = 0; + // no more than 1<<31 MCUs if no restart_interal? that's plenty safe, + // since we don't even allow 1<<30 pixels +} + +static int stbi__parse_entropy_coded_data(stbi__jpeg *z) +{ + stbi__jpeg_reset(z); + if (!z->progressive) { + if (z->scan_n == 1) { + int i,j; + STBI_SIMD_ALIGN(short, data[64]); + int n = z->order[0]; + // non-interleaved data, we just need to process one block at a time, + // in trivial scanline order + // number of blocks to do just depends on how many actual "pixels" this + // component has, independent of interleaved MCU blocking and such + int w = (z->img_comp[n].x+7) >> 3; + int h = (z->img_comp[n].y+7) >> 3; + for (j=0; j < h; ++j) { + for (i=0; i < w; ++i) { + int ha = z->img_comp[n].ha; + if (!stbi__jpeg_decode_block(z, data, z->huff_dc+z->img_comp[n].hd, z->huff_ac+ha, z->fast_ac[ha], n, z->dequant[z->img_comp[n].tq])) return 0; + z->idct_block_kernel(z->img_comp[n].data+z->img_comp[n].w2*j*8+i*8, z->img_comp[n].w2, data); + // every data block is an MCU, so countdown the restart interval + if (--z->todo <= 0) { + if (z->code_bits < 24) stbi__grow_buffer_unsafe(z); + // if it's NOT a restart, then just bail, so we get corrupt data + // rather than no data + if (!STBI__RESTART(z->marker)) return 1; + stbi__jpeg_reset(z); + } + } + } + return 1; + } else { // interleaved + int i,j,k,x,y; + STBI_SIMD_ALIGN(short, data[64]); + for (j=0; j < z->img_mcu_y; ++j) { + for (i=0; i < z->img_mcu_x; ++i) { + // scan an interleaved mcu... process scan_n components in order + for (k=0; k < z->scan_n; ++k) { + int n = z->order[k]; + // scan out an mcu's worth of this component; that's just determined + // by the basic H and V specified for the component + for (y=0; y < z->img_comp[n].v; ++y) { + for (x=0; x < z->img_comp[n].h; ++x) { + int x2 = (i*z->img_comp[n].h + x)*8; + int y2 = (j*z->img_comp[n].v + y)*8; + int ha = z->img_comp[n].ha; + if (!stbi__jpeg_decode_block(z, data, z->huff_dc+z->img_comp[n].hd, z->huff_ac+ha, z->fast_ac[ha], n, z->dequant[z->img_comp[n].tq])) return 0; + z->idct_block_kernel(z->img_comp[n].data+z->img_comp[n].w2*y2+x2, z->img_comp[n].w2, data); + } + } + } + // after all interleaved components, that's an interleaved MCU, + // so now count down the restart interval + if (--z->todo <= 0) { + if (z->code_bits < 24) stbi__grow_buffer_unsafe(z); + if (!STBI__RESTART(z->marker)) return 1; + stbi__jpeg_reset(z); + } + } + } + return 1; + } + } else { + if (z->scan_n == 1) { + int i,j; + int n = z->order[0]; + // non-interleaved data, we just need to process one block at a time, + // in trivial scanline order + // number of blocks to do just depends on how many actual "pixels" this + // component has, independent of interleaved MCU blocking and such + int w = (z->img_comp[n].x+7) >> 3; + int h = (z->img_comp[n].y+7) >> 3; + for (j=0; j < h; ++j) { + for (i=0; i < w; ++i) { + short *data = z->img_comp[n].coeff + 64 * (i + j * z->img_comp[n].coeff_w); + if (z->spec_start == 0) { + if (!stbi__jpeg_decode_block_prog_dc(z, data, &z->huff_dc[z->img_comp[n].hd], n)) + return 0; + } else { + int ha = z->img_comp[n].ha; + if (!stbi__jpeg_decode_block_prog_ac(z, data, &z->huff_ac[ha], z->fast_ac[ha])) + return 0; + } + // every data block is an MCU, so countdown the restart interval + if (--z->todo <= 0) { + if (z->code_bits < 24) stbi__grow_buffer_unsafe(z); + if (!STBI__RESTART(z->marker)) return 1; + stbi__jpeg_reset(z); + } + } + } + return 1; + } else { // interleaved + int i,j,k,x,y; + for (j=0; j < z->img_mcu_y; ++j) { + for (i=0; i < z->img_mcu_x; ++i) { + // scan an interleaved mcu... process scan_n components in order + for (k=0; k < z->scan_n; ++k) { + int n = z->order[k]; + // scan out an mcu's worth of this component; that's just determined + // by the basic H and V specified for the component + for (y=0; y < z->img_comp[n].v; ++y) { + for (x=0; x < z->img_comp[n].h; ++x) { + int x2 = (i*z->img_comp[n].h + x); + int y2 = (j*z->img_comp[n].v + y); + short *data = z->img_comp[n].coeff + 64 * (x2 + y2 * z->img_comp[n].coeff_w); + if (!stbi__jpeg_decode_block_prog_dc(z, data, &z->huff_dc[z->img_comp[n].hd], n)) + return 0; + } + } + } + // after all interleaved components, that's an interleaved MCU, + // so now count down the restart interval + if (--z->todo <= 0) { + if (z->code_bits < 24) stbi__grow_buffer_unsafe(z); + if (!STBI__RESTART(z->marker)) return 1; + stbi__jpeg_reset(z); + } + } + } + return 1; + } + } +} + +static void stbi__jpeg_dequantize(short *data, stbi__uint16 *dequant) +{ + int i; + for (i=0; i < 64; ++i) + data[i] *= dequant[i]; +} + +static void stbi__jpeg_finish(stbi__jpeg *z) +{ + if (z->progressive) { + // dequantize and idct the data + int i,j,n; + for (n=0; n < z->s->img_n; ++n) { + int w = (z->img_comp[n].x+7) >> 3; + int h = (z->img_comp[n].y+7) >> 3; + for (j=0; j < h; ++j) { + for (i=0; i < w; ++i) { + short *data = z->img_comp[n].coeff + 64 * (i + j * z->img_comp[n].coeff_w); + stbi__jpeg_dequantize(data, z->dequant[z->img_comp[n].tq]); + z->idct_block_kernel(z->img_comp[n].data+z->img_comp[n].w2*j*8+i*8, z->img_comp[n].w2, data); + } + } + } + } +} + +static int stbi__process_marker(stbi__jpeg *z, int m) +{ + int L; + switch (m) { + case STBI__MARKER_none: // no marker found + return stbi__err("expected marker","Corrupt JPEG"); + + case 0xDD: // DRI - specify restart interval + if (stbi__get16be(z->s) != 4) return stbi__err("bad DRI len","Corrupt JPEG"); + z->restart_interval = stbi__get16be(z->s); + return 1; + + case 0xDB: // DQT - define quantization table + L = stbi__get16be(z->s)-2; + while (L > 0) { + int q = stbi__get8(z->s); + int p = q >> 4, sixteen = (p != 0); + int t = q & 15,i; + if (p != 0 && p != 1) return stbi__err("bad DQT type","Corrupt JPEG"); + if (t > 3) return stbi__err("bad DQT table","Corrupt JPEG"); + + for (i=0; i < 64; ++i) + z->dequant[t][stbi__jpeg_dezigzag[i]] = (stbi__uint16)(sixteen ? stbi__get16be(z->s) : stbi__get8(z->s)); + L -= (sixteen ? 129 : 65); + } + return L==0; + + case 0xC4: // DHT - define huffman table + L = stbi__get16be(z->s)-2; + while (L > 0) { + stbi_uc *v; + int sizes[16],i,n=0; + int q = stbi__get8(z->s); + int tc = q >> 4; + int th = q & 15; + if (tc > 1 || th > 3) return stbi__err("bad DHT header","Corrupt JPEG"); + for (i=0; i < 16; ++i) { + sizes[i] = stbi__get8(z->s); + n += sizes[i]; + } + if(n > 256) return stbi__err("bad DHT header","Corrupt JPEG"); // Loop over i < n would write past end of values! + L -= 17; + if (tc == 0) { + if (!stbi__build_huffman(z->huff_dc+th, sizes)) return 0; + v = z->huff_dc[th].values; + } else { + if (!stbi__build_huffman(z->huff_ac+th, sizes)) return 0; + v = z->huff_ac[th].values; + } + for (i=0; i < n; ++i) + v[i] = stbi__get8(z->s); + if (tc != 0) + stbi__build_fast_ac(z->fast_ac[th], z->huff_ac + th); + L -= n; + } + return L==0; + } + + // check for comment block or APP blocks + if ((m >= 0xE0 && m <= 0xEF) || m == 0xFE) { + L = stbi__get16be(z->s); + if (L < 2) { + if (m == 0xFE) + return stbi__err("bad COM len","Corrupt JPEG"); + else + return stbi__err("bad APP len","Corrupt JPEG"); + } + L -= 2; + + if (m == 0xE0 && L >= 5) { // JFIF APP0 segment + static const unsigned char tag[5] = {'J','F','I','F','\0'}; + int ok = 1; + int i; + for (i=0; i < 5; ++i) + if (stbi__get8(z->s) != tag[i]) + ok = 0; + L -= 5; + if (ok) + z->jfif = 1; + } else if (m == 0xEE && L >= 12) { // Adobe APP14 segment + static const unsigned char tag[6] = {'A','d','o','b','e','\0'}; + int ok = 1; + int i; + for (i=0; i < 6; ++i) + if (stbi__get8(z->s) != tag[i]) + ok = 0; + L -= 6; + if (ok) { + stbi__get8(z->s); // version + stbi__get16be(z->s); // flags0 + stbi__get16be(z->s); // flags1 + z->app14_color_transform = stbi__get8(z->s); // color transform + L -= 6; + } + } + + stbi__skip(z->s, L); + return 1; + } + + return stbi__err("unknown marker","Corrupt JPEG"); +} + +// after we see SOS +static int stbi__process_scan_header(stbi__jpeg *z) +{ + int i; + int Ls = stbi__get16be(z->s); + z->scan_n = stbi__get8(z->s); + if (z->scan_n < 1 || z->scan_n > 4 || z->scan_n > (int) z->s->img_n) return stbi__err("bad SOS component count","Corrupt JPEG"); + if (Ls != 6+2*z->scan_n) return stbi__err("bad SOS len","Corrupt JPEG"); + for (i=0; i < z->scan_n; ++i) { + int id = stbi__get8(z->s), which; + int q = stbi__get8(z->s); + for (which = 0; which < z->s->img_n; ++which) + if (z->img_comp[which].id == id) + break; + if (which == z->s->img_n) return 0; // no match + z->img_comp[which].hd = q >> 4; if (z->img_comp[which].hd > 3) return stbi__err("bad DC huff","Corrupt JPEG"); + z->img_comp[which].ha = q & 15; if (z->img_comp[which].ha > 3) return stbi__err("bad AC huff","Corrupt JPEG"); + z->order[i] = which; + } + + { + int aa; + z->spec_start = stbi__get8(z->s); + z->spec_end = stbi__get8(z->s); // should be 63, but might be 0 + aa = stbi__get8(z->s); + z->succ_high = (aa >> 4); + z->succ_low = (aa & 15); + if (z->progressive) { + if (z->spec_start > 63 || z->spec_end > 63 || z->spec_start > z->spec_end || z->succ_high > 13 || z->succ_low > 13) + return stbi__err("bad SOS", "Corrupt JPEG"); + } else { + if (z->spec_start != 0) return stbi__err("bad SOS","Corrupt JPEG"); + if (z->succ_high != 0 || z->succ_low != 0) return stbi__err("bad SOS","Corrupt JPEG"); + z->spec_end = 63; + } + } + + return 1; +} + +static int stbi__free_jpeg_components(stbi__jpeg *z, int ncomp, int why) +{ + int i; + for (i=0; i < ncomp; ++i) { + if (z->img_comp[i].raw_data) { + STBI_FREE(z->img_comp[i].raw_data); + z->img_comp[i].raw_data = NULL; + z->img_comp[i].data = NULL; + } + if (z->img_comp[i].raw_coeff) { + STBI_FREE(z->img_comp[i].raw_coeff); + z->img_comp[i].raw_coeff = 0; + z->img_comp[i].coeff = 0; + } + if (z->img_comp[i].linebuf) { + STBI_FREE(z->img_comp[i].linebuf); + z->img_comp[i].linebuf = NULL; + } + } + return why; +} + +static int stbi__process_frame_header(stbi__jpeg *z, int scan) +{ + stbi__context *s = z->s; + int Lf,p,i,q, h_max=1,v_max=1,c; + Lf = stbi__get16be(s); if (Lf < 11) return stbi__err("bad SOF len","Corrupt JPEG"); // JPEG + p = stbi__get8(s); if (p != 8) return stbi__err("only 8-bit","JPEG format not supported: 8-bit only"); // JPEG baseline + s->img_y = stbi__get16be(s); if (s->img_y == 0) return stbi__err("no header height", "JPEG format not supported: delayed height"); // Legal, but we don't handle it--but neither does IJG + s->img_x = stbi__get16be(s); if (s->img_x == 0) return stbi__err("0 width","Corrupt JPEG"); // JPEG requires + if (s->img_y > STBI_MAX_DIMENSIONS) return stbi__err("too large","Very large image (corrupt?)"); + if (s->img_x > STBI_MAX_DIMENSIONS) return stbi__err("too large","Very large image (corrupt?)"); + c = stbi__get8(s); + if (c != 3 && c != 1 && c != 4) return stbi__err("bad component count","Corrupt JPEG"); + s->img_n = c; + for (i=0; i < c; ++i) { + z->img_comp[i].data = NULL; + z->img_comp[i].linebuf = NULL; + } + + if (Lf != 8+3*s->img_n) return stbi__err("bad SOF len","Corrupt JPEG"); + + z->rgb = 0; + for (i=0; i < s->img_n; ++i) { + static const unsigned char rgb[3] = { 'R', 'G', 'B' }; + z->img_comp[i].id = stbi__get8(s); + if (s->img_n == 3 && z->img_comp[i].id == rgb[i]) + ++z->rgb; + q = stbi__get8(s); + z->img_comp[i].h = (q >> 4); if (!z->img_comp[i].h || z->img_comp[i].h > 4) return stbi__err("bad H","Corrupt JPEG"); + z->img_comp[i].v = q & 15; if (!z->img_comp[i].v || z->img_comp[i].v > 4) return stbi__err("bad V","Corrupt JPEG"); + z->img_comp[i].tq = stbi__get8(s); if (z->img_comp[i].tq > 3) return stbi__err("bad TQ","Corrupt JPEG"); + } + + if (scan != STBI__SCAN_load) return 1; + + if (!stbi__mad3sizes_valid(s->img_x, s->img_y, s->img_n, 0)) return stbi__err("too large", "Image too large to decode"); + + for (i=0; i < s->img_n; ++i) { + if (z->img_comp[i].h > h_max) h_max = z->img_comp[i].h; + if (z->img_comp[i].v > v_max) v_max = z->img_comp[i].v; + } + + // check that plane subsampling factors are integer ratios; our resamplers can't deal with fractional ratios + // and I've never seen a non-corrupted JPEG file actually use them + for (i=0; i < s->img_n; ++i) { + if (h_max % z->img_comp[i].h != 0) return stbi__err("bad H","Corrupt JPEG"); + if (v_max % z->img_comp[i].v != 0) return stbi__err("bad V","Corrupt JPEG"); + } + + // compute interleaved mcu info + z->img_h_max = h_max; + z->img_v_max = v_max; + z->img_mcu_w = h_max * 8; + z->img_mcu_h = v_max * 8; + // these sizes can't be more than 17 bits + z->img_mcu_x = (s->img_x + z->img_mcu_w-1) / z->img_mcu_w; + z->img_mcu_y = (s->img_y + z->img_mcu_h-1) / z->img_mcu_h; + + for (i=0; i < s->img_n; ++i) { + // number of effective pixels (e.g. for non-interleaved MCU) + z->img_comp[i].x = (s->img_x * z->img_comp[i].h + h_max-1) / h_max; + z->img_comp[i].y = (s->img_y * z->img_comp[i].v + v_max-1) / v_max; + // to simplify generation, we'll allocate enough memory to decode + // the bogus oversized data from using interleaved MCUs and their + // big blocks (e.g. a 16x16 iMCU on an image of width 33); we won't + // discard the extra data until colorspace conversion + // + // img_mcu_x, img_mcu_y: <=17 bits; comp[i].h and .v are <=4 (checked earlier) + // so these muls can't overflow with 32-bit ints (which we require) + z->img_comp[i].w2 = z->img_mcu_x * z->img_comp[i].h * 8; + z->img_comp[i].h2 = z->img_mcu_y * z->img_comp[i].v * 8; + z->img_comp[i].coeff = 0; + z->img_comp[i].raw_coeff = 0; + z->img_comp[i].linebuf = NULL; + z->img_comp[i].raw_data = stbi__malloc_mad2(z->img_comp[i].w2, z->img_comp[i].h2, 15); + if (z->img_comp[i].raw_data == NULL) + return stbi__free_jpeg_components(z, i+1, stbi__err("outofmem", "Out of memory")); + // align blocks for idct using mmx/sse + z->img_comp[i].data = (stbi_uc*) (((size_t) z->img_comp[i].raw_data + 15) & ~15); + if (z->progressive) { + // w2, h2 are multiples of 8 (see above) + z->img_comp[i].coeff_w = z->img_comp[i].w2 / 8; + z->img_comp[i].coeff_h = z->img_comp[i].h2 / 8; + z->img_comp[i].raw_coeff = stbi__malloc_mad3(z->img_comp[i].w2, z->img_comp[i].h2, sizeof(short), 15); + if (z->img_comp[i].raw_coeff == NULL) + return stbi__free_jpeg_components(z, i+1, stbi__err("outofmem", "Out of memory")); + z->img_comp[i].coeff = (short*) (((size_t) z->img_comp[i].raw_coeff + 15) & ~15); + } + } + + return 1; +} + +// use comparisons since in some cases we handle more than one case (e.g. SOF) +#define stbi__DNL(x) ((x) == 0xdc) +#define stbi__SOI(x) ((x) == 0xd8) +#define stbi__EOI(x) ((x) == 0xd9) +#define stbi__SOF(x) ((x) == 0xc0 || (x) == 0xc1 || (x) == 0xc2) +#define stbi__SOS(x) ((x) == 0xda) + +#define stbi__SOF_progressive(x) ((x) == 0xc2) + +static int stbi__decode_jpeg_header(stbi__jpeg *z, int scan) +{ + int m; + z->jfif = 0; + z->app14_color_transform = -1; // valid values are 0,1,2 + z->marker = STBI__MARKER_none; // initialize cached marker to empty + m = stbi__get_marker(z); + if (!stbi__SOI(m)) return stbi__err("no SOI","Corrupt JPEG"); + if (scan == STBI__SCAN_type) return 1; + m = stbi__get_marker(z); + while (!stbi__SOF(m)) { + if (!stbi__process_marker(z,m)) return 0; + m = stbi__get_marker(z); + while (m == STBI__MARKER_none) { + // some files have extra padding after their blocks, so ok, we'll scan + if (stbi__at_eof(z->s)) return stbi__err("no SOF", "Corrupt JPEG"); + m = stbi__get_marker(z); + } + } + z->progressive = stbi__SOF_progressive(m); + if (!stbi__process_frame_header(z, scan)) return 0; + return 1; +} + +static int stbi__skip_jpeg_junk_at_end(stbi__jpeg *j) +{ + // some JPEGs have junk at end, skip over it but if we find what looks + // like a valid marker, resume there + while (!stbi__at_eof(j->s)) { + int x = stbi__get8(j->s); + while (x == 255) { // might be a marker + if (stbi__at_eof(j->s)) return STBI__MARKER_none; + x = stbi__get8(j->s); + if (x != 0x00 && x != 0xff) { + // not a stuffed zero or lead-in to another marker, looks + // like an actual marker, return it + return x; + } + // stuffed zero has x=0 now which ends the loop, meaning we go + // back to regular scan loop. + // repeated 0xff keeps trying to read the next byte of the marker. + } + } + return STBI__MARKER_none; +} + +// decode image to YCbCr format +static int stbi__decode_jpeg_image(stbi__jpeg *j) +{ + int m; + for (m = 0; m < 4; m++) { + j->img_comp[m].raw_data = NULL; + j->img_comp[m].raw_coeff = NULL; + } + j->restart_interval = 0; + if (!stbi__decode_jpeg_header(j, STBI__SCAN_load)) return 0; + m = stbi__get_marker(j); + while (!stbi__EOI(m)) { + if (stbi__SOS(m)) { + if (!stbi__process_scan_header(j)) return 0; + if (!stbi__parse_entropy_coded_data(j)) return 0; + if (j->marker == STBI__MARKER_none ) { + j->marker = stbi__skip_jpeg_junk_at_end(j); + // if we reach eof without hitting a marker, stbi__get_marker() below will fail and we'll eventually return 0 + } + m = stbi__get_marker(j); + if (STBI__RESTART(m)) + m = stbi__get_marker(j); + } else if (stbi__DNL(m)) { + int Ld = stbi__get16be(j->s); + stbi__uint32 NL = stbi__get16be(j->s); + if (Ld != 4) return stbi__err("bad DNL len", "Corrupt JPEG"); + if (NL != j->s->img_y) return stbi__err("bad DNL height", "Corrupt JPEG"); + m = stbi__get_marker(j); + } else { + if (!stbi__process_marker(j, m)) return 1; + m = stbi__get_marker(j); + } + } + if (j->progressive) + stbi__jpeg_finish(j); + return 1; +} + +// static jfif-centered resampling (across block boundaries) + +typedef stbi_uc *(*resample_row_func)(stbi_uc *out, stbi_uc *in0, stbi_uc *in1, + int w, int hs); + +#define stbi__div4(x) ((stbi_uc) ((x) >> 2)) + +static stbi_uc *resample_row_1(stbi_uc *out, stbi_uc *in_near, stbi_uc *in_far, int w, int hs) +{ + STBI_NOTUSED(out); + STBI_NOTUSED(in_far); + STBI_NOTUSED(w); + STBI_NOTUSED(hs); + return in_near; +} + +static stbi_uc* stbi__resample_row_v_2(stbi_uc *out, stbi_uc *in_near, stbi_uc *in_far, int w, int hs) +{ + // need to generate two samples vertically for every one in input + int i; + STBI_NOTUSED(hs); + for (i=0; i < w; ++i) + out[i] = stbi__div4(3*in_near[i] + in_far[i] + 2); + return out; +} + +static stbi_uc* stbi__resample_row_h_2(stbi_uc *out, stbi_uc *in_near, stbi_uc *in_far, int w, int hs) +{ + // need to generate two samples horizontally for every one in input + int i; + stbi_uc *input = in_near; + + if (w == 1) { + // if only one sample, can't do any interpolation + out[0] = out[1] = input[0]; + return out; + } + + out[0] = input[0]; + out[1] = stbi__div4(input[0]*3 + input[1] + 2); + for (i=1; i < w-1; ++i) { + int n = 3*input[i]+2; + out[i*2+0] = stbi__div4(n+input[i-1]); + out[i*2+1] = stbi__div4(n+input[i+1]); + } + out[i*2+0] = stbi__div4(input[w-2]*3 + input[w-1] + 2); + out[i*2+1] = input[w-1]; + + STBI_NOTUSED(in_far); + STBI_NOTUSED(hs); + + return out; +} + +#define stbi__div16(x) ((stbi_uc) ((x) >> 4)) + +static stbi_uc *stbi__resample_row_hv_2(stbi_uc *out, stbi_uc *in_near, stbi_uc *in_far, int w, int hs) +{ + // need to generate 2x2 samples for every one in input + int i,t0,t1; + if (w == 1) { + out[0] = out[1] = stbi__div4(3*in_near[0] + in_far[0] + 2); + return out; + } + + t1 = 3*in_near[0] + in_far[0]; + out[0] = stbi__div4(t1+2); + for (i=1; i < w; ++i) { + t0 = t1; + t1 = 3*in_near[i]+in_far[i]; + out[i*2-1] = stbi__div16(3*t0 + t1 + 8); + out[i*2 ] = stbi__div16(3*t1 + t0 + 8); + } + out[w*2-1] = stbi__div4(t1+2); + + STBI_NOTUSED(hs); + + return out; +} + +#if defined(STBI_SSE2) || defined(STBI_NEON) +static stbi_uc *stbi__resample_row_hv_2_simd(stbi_uc *out, stbi_uc *in_near, stbi_uc *in_far, int w, int hs) +{ + // need to generate 2x2 samples for every one in input + int i=0,t0,t1; + + if (w == 1) { + out[0] = out[1] = stbi__div4(3*in_near[0] + in_far[0] + 2); + return out; + } + + t1 = 3*in_near[0] + in_far[0]; + // process groups of 8 pixels for as long as we can. + // note we can't handle the last pixel in a row in this loop + // because we need to handle the filter boundary conditions. + for (; i < ((w-1) & ~7); i += 8) { +#if defined(STBI_SSE2) + // load and perform the vertical filtering pass + // this uses 3*x + y = 4*x + (y - x) + __m128i zero = _mm_setzero_si128(); + __m128i farb = _mm_loadl_epi64((__m128i *) (in_far + i)); + __m128i nearb = _mm_loadl_epi64((__m128i *) (in_near + i)); + __m128i farw = _mm_unpacklo_epi8(farb, zero); + __m128i nearw = _mm_unpacklo_epi8(nearb, zero); + __m128i diff = _mm_sub_epi16(farw, nearw); + __m128i nears = _mm_slli_epi16(nearw, 2); + __m128i curr = _mm_add_epi16(nears, diff); // current row + + // horizontal filter works the same based on shifted vers of current + // row. "prev" is current row shifted right by 1 pixel; we need to + // insert the previous pixel value (from t1). + // "next" is current row shifted left by 1 pixel, with first pixel + // of next block of 8 pixels added in. + __m128i prv0 = _mm_slli_si128(curr, 2); + __m128i nxt0 = _mm_srli_si128(curr, 2); + __m128i prev = _mm_insert_epi16(prv0, t1, 0); + __m128i next = _mm_insert_epi16(nxt0, 3*in_near[i+8] + in_far[i+8], 7); + + // horizontal filter, polyphase implementation since it's convenient: + // even pixels = 3*cur + prev = cur*4 + (prev - cur) + // odd pixels = 3*cur + next = cur*4 + (next - cur) + // note the shared term. + __m128i bias = _mm_set1_epi16(8); + __m128i curs = _mm_slli_epi16(curr, 2); + __m128i prvd = _mm_sub_epi16(prev, curr); + __m128i nxtd = _mm_sub_epi16(next, curr); + __m128i curb = _mm_add_epi16(curs, bias); + __m128i even = _mm_add_epi16(prvd, curb); + __m128i odd = _mm_add_epi16(nxtd, curb); + + // interleave even and odd pixels, then undo scaling. + __m128i int0 = _mm_unpacklo_epi16(even, odd); + __m128i int1 = _mm_unpackhi_epi16(even, odd); + __m128i de0 = _mm_srli_epi16(int0, 4); + __m128i de1 = _mm_srli_epi16(int1, 4); + + // pack and write output + __m128i outv = _mm_packus_epi16(de0, de1); + _mm_storeu_si128((__m128i *) (out + i*2), outv); +#elif defined(STBI_NEON) + // load and perform the vertical filtering pass + // this uses 3*x + y = 4*x + (y - x) + uint8x8_t farb = vld1_u8(in_far + i); + uint8x8_t nearb = vld1_u8(in_near + i); + int16x8_t diff = vreinterpretq_s16_u16(vsubl_u8(farb, nearb)); + int16x8_t nears = vreinterpretq_s16_u16(vshll_n_u8(nearb, 2)); + int16x8_t curr = vaddq_s16(nears, diff); // current row + + // horizontal filter works the same based on shifted vers of current + // row. "prev" is current row shifted right by 1 pixel; we need to + // insert the previous pixel value (from t1). + // "next" is current row shifted left by 1 pixel, with first pixel + // of next block of 8 pixels added in. + int16x8_t prv0 = vextq_s16(curr, curr, 7); + int16x8_t nxt0 = vextq_s16(curr, curr, 1); + int16x8_t prev = vsetq_lane_s16(t1, prv0, 0); + int16x8_t next = vsetq_lane_s16(3*in_near[i+8] + in_far[i+8], nxt0, 7); + + // horizontal filter, polyphase implementation since it's convenient: + // even pixels = 3*cur + prev = cur*4 + (prev - cur) + // odd pixels = 3*cur + next = cur*4 + (next - cur) + // note the shared term. + int16x8_t curs = vshlq_n_s16(curr, 2); + int16x8_t prvd = vsubq_s16(prev, curr); + int16x8_t nxtd = vsubq_s16(next, curr); + int16x8_t even = vaddq_s16(curs, prvd); + int16x8_t odd = vaddq_s16(curs, nxtd); + + // undo scaling and round, then store with even/odd phases interleaved + uint8x8x2_t o; + o.val[0] = vqrshrun_n_s16(even, 4); + o.val[1] = vqrshrun_n_s16(odd, 4); + vst2_u8(out + i*2, o); +#endif + + // "previous" value for next iter + t1 = 3*in_near[i+7] + in_far[i+7]; + } + + t0 = t1; + t1 = 3*in_near[i] + in_far[i]; + out[i*2] = stbi__div16(3*t1 + t0 + 8); + + for (++i; i < w; ++i) { + t0 = t1; + t1 = 3*in_near[i]+in_far[i]; + out[i*2-1] = stbi__div16(3*t0 + t1 + 8); + out[i*2 ] = stbi__div16(3*t1 + t0 + 8); + } + out[w*2-1] = stbi__div4(t1+2); + + STBI_NOTUSED(hs); + + return out; +} +#endif + +static stbi_uc *stbi__resample_row_generic(stbi_uc *out, stbi_uc *in_near, stbi_uc *in_far, int w, int hs) +{ + // resample with nearest-neighbor + int i,j; + STBI_NOTUSED(in_far); + for (i=0; i < w; ++i) + for (j=0; j < hs; ++j) + out[i*hs+j] = in_near[i]; + return out; +} + +// this is a reduced-precision calculation of YCbCr-to-RGB introduced +// to make sure the code produces the same results in both SIMD and scalar +#define stbi__float2fixed(x) (((int) ((x) * 4096.0f + 0.5f)) << 8) +static void stbi__YCbCr_to_RGB_row(stbi_uc *out, const stbi_uc *y, const stbi_uc *pcb, const stbi_uc *pcr, int count, int step) +{ + int i; + for (i=0; i < count; ++i) { + int y_fixed = (y[i] << 20) + (1<<19); // rounding + int r,g,b; + int cr = pcr[i] - 128; + int cb = pcb[i] - 128; + r = y_fixed + cr* stbi__float2fixed(1.40200f); + g = y_fixed + (cr*-stbi__float2fixed(0.71414f)) + ((cb*-stbi__float2fixed(0.34414f)) & 0xffff0000); + b = y_fixed + cb* stbi__float2fixed(1.77200f); + r >>= 20; + g >>= 20; + b >>= 20; + if ((unsigned) r > 255) { if (r < 0) r = 0; else r = 255; } + if ((unsigned) g > 255) { if (g < 0) g = 0; else g = 255; } + if ((unsigned) b > 255) { if (b < 0) b = 0; else b = 255; } + out[0] = (stbi_uc)r; + out[1] = (stbi_uc)g; + out[2] = (stbi_uc)b; + out[3] = 255; + out += step; + } +} + +#if defined(STBI_SSE2) || defined(STBI_NEON) +static void stbi__YCbCr_to_RGB_simd(stbi_uc *out, stbi_uc const *y, stbi_uc const *pcb, stbi_uc const *pcr, int count, int step) +{ + int i = 0; + +#ifdef STBI_SSE2 + // step == 3 is pretty ugly on the final interleave, and i'm not convinced + // it's useful in practice (you wouldn't use it for textures, for example). + // so just accelerate step == 4 case. + if (step == 4) { + // this is a fairly straightforward implementation and not super-optimized. + __m128i signflip = _mm_set1_epi8(-0x80); + __m128i cr_const0 = _mm_set1_epi16( (short) ( 1.40200f*4096.0f+0.5f)); + __m128i cr_const1 = _mm_set1_epi16( - (short) ( 0.71414f*4096.0f+0.5f)); + __m128i cb_const0 = _mm_set1_epi16( - (short) ( 0.34414f*4096.0f+0.5f)); + __m128i cb_const1 = _mm_set1_epi16( (short) ( 1.77200f*4096.0f+0.5f)); + __m128i y_bias = _mm_set1_epi8((char) (unsigned char) 128); + __m128i xw = _mm_set1_epi16(255); // alpha channel + + for (; i+7 < count; i += 8) { + // load + __m128i y_bytes = _mm_loadl_epi64((__m128i *) (y+i)); + __m128i cr_bytes = _mm_loadl_epi64((__m128i *) (pcr+i)); + __m128i cb_bytes = _mm_loadl_epi64((__m128i *) (pcb+i)); + __m128i cr_biased = _mm_xor_si128(cr_bytes, signflip); // -128 + __m128i cb_biased = _mm_xor_si128(cb_bytes, signflip); // -128 + + // unpack to short (and left-shift cr, cb by 8) + __m128i yw = _mm_unpacklo_epi8(y_bias, y_bytes); + __m128i crw = _mm_unpacklo_epi8(_mm_setzero_si128(), cr_biased); + __m128i cbw = _mm_unpacklo_epi8(_mm_setzero_si128(), cb_biased); + + // color transform + __m128i yws = _mm_srli_epi16(yw, 4); + __m128i cr0 = _mm_mulhi_epi16(cr_const0, crw); + __m128i cb0 = _mm_mulhi_epi16(cb_const0, cbw); + __m128i cb1 = _mm_mulhi_epi16(cbw, cb_const1); + __m128i cr1 = _mm_mulhi_epi16(crw, cr_const1); + __m128i rws = _mm_add_epi16(cr0, yws); + __m128i gwt = _mm_add_epi16(cb0, yws); + __m128i bws = _mm_add_epi16(yws, cb1); + __m128i gws = _mm_add_epi16(gwt, cr1); + + // descale + __m128i rw = _mm_srai_epi16(rws, 4); + __m128i bw = _mm_srai_epi16(bws, 4); + __m128i gw = _mm_srai_epi16(gws, 4); + + // back to byte, set up for transpose + __m128i brb = _mm_packus_epi16(rw, bw); + __m128i gxb = _mm_packus_epi16(gw, xw); + + // transpose to interleave channels + __m128i t0 = _mm_unpacklo_epi8(brb, gxb); + __m128i t1 = _mm_unpackhi_epi8(brb, gxb); + __m128i o0 = _mm_unpacklo_epi16(t0, t1); + __m128i o1 = _mm_unpackhi_epi16(t0, t1); + + // store + _mm_storeu_si128((__m128i *) (out + 0), o0); + _mm_storeu_si128((__m128i *) (out + 16), o1); + out += 32; + } + } +#endif + +#ifdef STBI_NEON + // in this version, step=3 support would be easy to add. but is there demand? + if (step == 4) { + // this is a fairly straightforward implementation and not super-optimized. + uint8x8_t signflip = vdup_n_u8(0x80); + int16x8_t cr_const0 = vdupq_n_s16( (short) ( 1.40200f*4096.0f+0.5f)); + int16x8_t cr_const1 = vdupq_n_s16( - (short) ( 0.71414f*4096.0f+0.5f)); + int16x8_t cb_const0 = vdupq_n_s16( - (short) ( 0.34414f*4096.0f+0.5f)); + int16x8_t cb_const1 = vdupq_n_s16( (short) ( 1.77200f*4096.0f+0.5f)); + + for (; i+7 < count; i += 8) { + // load + uint8x8_t y_bytes = vld1_u8(y + i); + uint8x8_t cr_bytes = vld1_u8(pcr + i); + uint8x8_t cb_bytes = vld1_u8(pcb + i); + int8x8_t cr_biased = vreinterpret_s8_u8(vsub_u8(cr_bytes, signflip)); + int8x8_t cb_biased = vreinterpret_s8_u8(vsub_u8(cb_bytes, signflip)); + + // expand to s16 + int16x8_t yws = vreinterpretq_s16_u16(vshll_n_u8(y_bytes, 4)); + int16x8_t crw = vshll_n_s8(cr_biased, 7); + int16x8_t cbw = vshll_n_s8(cb_biased, 7); + + // color transform + int16x8_t cr0 = vqdmulhq_s16(crw, cr_const0); + int16x8_t cb0 = vqdmulhq_s16(cbw, cb_const0); + int16x8_t cr1 = vqdmulhq_s16(crw, cr_const1); + int16x8_t cb1 = vqdmulhq_s16(cbw, cb_const1); + int16x8_t rws = vaddq_s16(yws, cr0); + int16x8_t gws = vaddq_s16(vaddq_s16(yws, cb0), cr1); + int16x8_t bws = vaddq_s16(yws, cb1); + + // undo scaling, round, convert to byte + uint8x8x4_t o; + o.val[0] = vqrshrun_n_s16(rws, 4); + o.val[1] = vqrshrun_n_s16(gws, 4); + o.val[2] = vqrshrun_n_s16(bws, 4); + o.val[3] = vdup_n_u8(255); + + // store, interleaving r/g/b/a + vst4_u8(out, o); + out += 8*4; + } + } +#endif + + for (; i < count; ++i) { + int y_fixed = (y[i] << 20) + (1<<19); // rounding + int r,g,b; + int cr = pcr[i] - 128; + int cb = pcb[i] - 128; + r = y_fixed + cr* stbi__float2fixed(1.40200f); + g = y_fixed + cr*-stbi__float2fixed(0.71414f) + ((cb*-stbi__float2fixed(0.34414f)) & 0xffff0000); + b = y_fixed + cb* stbi__float2fixed(1.77200f); + r >>= 20; + g >>= 20; + b >>= 20; + if ((unsigned) r > 255) { if (r < 0) r = 0; else r = 255; } + if ((unsigned) g > 255) { if (g < 0) g = 0; else g = 255; } + if ((unsigned) b > 255) { if (b < 0) b = 0; else b = 255; } + out[0] = (stbi_uc)r; + out[1] = (stbi_uc)g; + out[2] = (stbi_uc)b; + out[3] = 255; + out += step; + } +} +#endif + +// set up the kernels +static void stbi__setup_jpeg(stbi__jpeg *j) +{ + j->idct_block_kernel = stbi__idct_block; + j->YCbCr_to_RGB_kernel = stbi__YCbCr_to_RGB_row; + j->resample_row_hv_2_kernel = stbi__resample_row_hv_2; + +#ifdef STBI_SSE2 + if (stbi__sse2_available()) { + j->idct_block_kernel = stbi__idct_simd; + j->YCbCr_to_RGB_kernel = stbi__YCbCr_to_RGB_simd; + j->resample_row_hv_2_kernel = stbi__resample_row_hv_2_simd; + } +#endif + +#ifdef STBI_NEON + j->idct_block_kernel = stbi__idct_simd; + j->YCbCr_to_RGB_kernel = stbi__YCbCr_to_RGB_simd; + j->resample_row_hv_2_kernel = stbi__resample_row_hv_2_simd; +#endif +} + +// clean up the temporary component buffers +static void stbi__cleanup_jpeg(stbi__jpeg *j) +{ + stbi__free_jpeg_components(j, j->s->img_n, 0); +} + +typedef struct +{ + resample_row_func resample; + stbi_uc *line0,*line1; + int hs,vs; // expansion factor in each axis + int w_lores; // horizontal pixels pre-expansion + int ystep; // how far through vertical expansion we are + int ypos; // which pre-expansion row we're on +} stbi__resample; + +// fast 0..255 * 0..255 => 0..255 rounded multiplication +static stbi_uc stbi__blinn_8x8(stbi_uc x, stbi_uc y) +{ + unsigned int t = x*y + 128; + return (stbi_uc) ((t + (t >>8)) >> 8); +} + +static stbi_uc *load_jpeg_image(stbi__jpeg *z, int *out_x, int *out_y, int *comp, int req_comp) +{ + int n, decode_n, is_rgb; + z->s->img_n = 0; // make stbi__cleanup_jpeg safe + + // validate req_comp + if (req_comp < 0 || req_comp > 4) return stbi__errpuc("bad req_comp", "Internal error"); + + // load a jpeg image from whichever source, but leave in YCbCr format + if (!stbi__decode_jpeg_image(z)) { stbi__cleanup_jpeg(z); return NULL; } + + // determine actual number of components to generate + n = req_comp ? req_comp : z->s->img_n >= 3 ? 3 : 1; + + is_rgb = z->s->img_n == 3 && (z->rgb == 3 || (z->app14_color_transform == 0 && !z->jfif)); + + if (z->s->img_n == 3 && n < 3 && !is_rgb) + decode_n = 1; + else + decode_n = z->s->img_n; + + // nothing to do if no components requested; check this now to avoid + // accessing uninitialized coutput[0] later + if (decode_n <= 0) { stbi__cleanup_jpeg(z); return NULL; } + + // resample and color-convert + { + int k; + unsigned int i,j; + stbi_uc *output; + stbi_uc *coutput[4] = { NULL, NULL, NULL, NULL }; + + stbi__resample res_comp[4]; + + for (k=0; k < decode_n; ++k) { + stbi__resample *r = &res_comp[k]; + + // allocate line buffer big enough for upsampling off the edges + // with upsample factor of 4 + z->img_comp[k].linebuf = (stbi_uc *) stbi__malloc(z->s->img_x + 3); + if (!z->img_comp[k].linebuf) { stbi__cleanup_jpeg(z); return stbi__errpuc("outofmem", "Out of memory"); } + + r->hs = z->img_h_max / z->img_comp[k].h; + r->vs = z->img_v_max / z->img_comp[k].v; + r->ystep = r->vs >> 1; + r->w_lores = (z->s->img_x + r->hs-1) / r->hs; + r->ypos = 0; + r->line0 = r->line1 = z->img_comp[k].data; + + if (r->hs == 1 && r->vs == 1) r->resample = resample_row_1; + else if (r->hs == 1 && r->vs == 2) r->resample = stbi__resample_row_v_2; + else if (r->hs == 2 && r->vs == 1) r->resample = stbi__resample_row_h_2; + else if (r->hs == 2 && r->vs == 2) r->resample = z->resample_row_hv_2_kernel; + else r->resample = stbi__resample_row_generic; + } + + // can't error after this so, this is safe + output = (stbi_uc *) stbi__malloc_mad3(n, z->s->img_x, z->s->img_y, 1); + if (!output) { stbi__cleanup_jpeg(z); return stbi__errpuc("outofmem", "Out of memory"); } + + // now go ahead and resample + for (j=0; j < z->s->img_y; ++j) { + stbi_uc *out = output + n * z->s->img_x * j; + for (k=0; k < decode_n; ++k) { + stbi__resample *r = &res_comp[k]; + int y_bot = r->ystep >= (r->vs >> 1); + coutput[k] = r->resample(z->img_comp[k].linebuf, + y_bot ? r->line1 : r->line0, + y_bot ? r->line0 : r->line1, + r->w_lores, r->hs); + if (++r->ystep >= r->vs) { + r->ystep = 0; + r->line0 = r->line1; + if (++r->ypos < z->img_comp[k].y) + r->line1 += z->img_comp[k].w2; + } + } + if (n >= 3) { + stbi_uc *y = coutput[0]; + if (z->s->img_n == 3) { + if (is_rgb) { + for (i=0; i < z->s->img_x; ++i) { + out[0] = y[i]; + out[1] = coutput[1][i]; + out[2] = coutput[2][i]; + out[3] = 255; + out += n; + } + } else { + z->YCbCr_to_RGB_kernel(out, y, coutput[1], coutput[2], z->s->img_x, n); + } + } else if (z->s->img_n == 4) { + if (z->app14_color_transform == 0) { // CMYK + for (i=0; i < z->s->img_x; ++i) { + stbi_uc m = coutput[3][i]; + out[0] = stbi__blinn_8x8(coutput[0][i], m); + out[1] = stbi__blinn_8x8(coutput[1][i], m); + out[2] = stbi__blinn_8x8(coutput[2][i], m); + out[3] = 255; + out += n; + } + } else if (z->app14_color_transform == 2) { // YCCK + z->YCbCr_to_RGB_kernel(out, y, coutput[1], coutput[2], z->s->img_x, n); + for (i=0; i < z->s->img_x; ++i) { + stbi_uc m = coutput[3][i]; + out[0] = stbi__blinn_8x8(255 - out[0], m); + out[1] = stbi__blinn_8x8(255 - out[1], m); + out[2] = stbi__blinn_8x8(255 - out[2], m); + out += n; + } + } else { // YCbCr + alpha? Ignore the fourth channel for now + z->YCbCr_to_RGB_kernel(out, y, coutput[1], coutput[2], z->s->img_x, n); + } + } else + for (i=0; i < z->s->img_x; ++i) { + out[0] = out[1] = out[2] = y[i]; + out[3] = 255; // not used if n==3 + out += n; + } + } else { + if (is_rgb) { + if (n == 1) + for (i=0; i < z->s->img_x; ++i) + *out++ = stbi__compute_y(coutput[0][i], coutput[1][i], coutput[2][i]); + else { + for (i=0; i < z->s->img_x; ++i, out += 2) { + out[0] = stbi__compute_y(coutput[0][i], coutput[1][i], coutput[2][i]); + out[1] = 255; + } + } + } else if (z->s->img_n == 4 && z->app14_color_transform == 0) { + for (i=0; i < z->s->img_x; ++i) { + stbi_uc m = coutput[3][i]; + stbi_uc r = stbi__blinn_8x8(coutput[0][i], m); + stbi_uc g = stbi__blinn_8x8(coutput[1][i], m); + stbi_uc b = stbi__blinn_8x8(coutput[2][i], m); + out[0] = stbi__compute_y(r, g, b); + out[1] = 255; + out += n; + } + } else if (z->s->img_n == 4 && z->app14_color_transform == 2) { + for (i=0; i < z->s->img_x; ++i) { + out[0] = stbi__blinn_8x8(255 - coutput[0][i], coutput[3][i]); + out[1] = 255; + out += n; + } + } else { + stbi_uc *y = coutput[0]; + if (n == 1) + for (i=0; i < z->s->img_x; ++i) out[i] = y[i]; + else + for (i=0; i < z->s->img_x; ++i) { *out++ = y[i]; *out++ = 255; } + } + } + } + stbi__cleanup_jpeg(z); + *out_x = z->s->img_x; + *out_y = z->s->img_y; + if (comp) *comp = z->s->img_n >= 3 ? 3 : 1; // report original components, not output + return output; + } +} + +static void *stbi__jpeg_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri) +{ + unsigned char* result; + stbi__jpeg* j = (stbi__jpeg*) stbi__malloc(sizeof(stbi__jpeg)); + if (!j) return stbi__errpuc("outofmem", "Out of memory"); + memset(j, 0, sizeof(stbi__jpeg)); + STBI_NOTUSED(ri); + j->s = s; + stbi__setup_jpeg(j); + result = load_jpeg_image(j, x,y,comp,req_comp); + STBI_FREE(j); + return result; +} + +static int stbi__jpeg_test(stbi__context *s) +{ + int r; + stbi__jpeg* j = (stbi__jpeg*)stbi__malloc(sizeof(stbi__jpeg)); + if (!j) return stbi__err("outofmem", "Out of memory"); + memset(j, 0, sizeof(stbi__jpeg)); + j->s = s; + stbi__setup_jpeg(j); + r = stbi__decode_jpeg_header(j, STBI__SCAN_type); + stbi__rewind(s); + STBI_FREE(j); + return r; +} + +static int stbi__jpeg_info_raw(stbi__jpeg *j, int *x, int *y, int *comp) +{ + if (!stbi__decode_jpeg_header(j, STBI__SCAN_header)) { + stbi__rewind( j->s ); + return 0; + } + if (x) *x = j->s->img_x; + if (y) *y = j->s->img_y; + if (comp) *comp = j->s->img_n >= 3 ? 3 : 1; + return 1; +} + +static int stbi__jpeg_info(stbi__context *s, int *x, int *y, int *comp) +{ + int result; + stbi__jpeg* j = (stbi__jpeg*) (stbi__malloc(sizeof(stbi__jpeg))); + if (!j) return stbi__err("outofmem", "Out of memory"); + memset(j, 0, sizeof(stbi__jpeg)); + j->s = s; + result = stbi__jpeg_info_raw(j, x, y, comp); + STBI_FREE(j); + return result; +} +#endif + +// public domain zlib decode v0.2 Sean Barrett 2006-11-18 +// simple implementation +// - all input must be provided in an upfront buffer +// - all output is written to a single output buffer (can malloc/realloc) +// performance +// - fast huffman + +#ifndef STBI_NO_ZLIB + +// fast-way is faster to check than jpeg huffman, but slow way is slower +#define STBI__ZFAST_BITS 9 // accelerate all cases in default tables +#define STBI__ZFAST_MASK ((1 << STBI__ZFAST_BITS) - 1) +#define STBI__ZNSYMS 288 // number of symbols in literal/length alphabet + +// zlib-style huffman encoding +// (jpegs packs from left, zlib from right, so can't share code) +typedef struct +{ + stbi__uint16 fast[1 << STBI__ZFAST_BITS]; + stbi__uint16 firstcode[16]; + int maxcode[17]; + stbi__uint16 firstsymbol[16]; + stbi_uc size[STBI__ZNSYMS]; + stbi__uint16 value[STBI__ZNSYMS]; +} stbi__zhuffman; + +stbi_inline static int stbi__bitreverse16(int n) +{ + n = ((n & 0xAAAA) >> 1) | ((n & 0x5555) << 1); + n = ((n & 0xCCCC) >> 2) | ((n & 0x3333) << 2); + n = ((n & 0xF0F0) >> 4) | ((n & 0x0F0F) << 4); + n = ((n & 0xFF00) >> 8) | ((n & 0x00FF) << 8); + return n; +} + +stbi_inline static int stbi__bit_reverse(int v, int bits) +{ + STBI_ASSERT(bits <= 16); + // to bit reverse n bits, reverse 16 and shift + // e.g. 11 bits, bit reverse and shift away 5 + return stbi__bitreverse16(v) >> (16-bits); +} + +static int stbi__zbuild_huffman(stbi__zhuffman *z, const stbi_uc *sizelist, int num) +{ + int i,k=0; + int code, next_code[16], sizes[17]; + + // DEFLATE spec for generating codes + memset(sizes, 0, sizeof(sizes)); + memset(z->fast, 0, sizeof(z->fast)); + for (i=0; i < num; ++i) + ++sizes[sizelist[i]]; + sizes[0] = 0; + for (i=1; i < 16; ++i) + if (sizes[i] > (1 << i)) + return stbi__err("bad sizes", "Corrupt PNG"); + code = 0; + for (i=1; i < 16; ++i) { + next_code[i] = code; + z->firstcode[i] = (stbi__uint16) code; + z->firstsymbol[i] = (stbi__uint16) k; + code = (code + sizes[i]); + if (sizes[i]) + if (code-1 >= (1 << i)) return stbi__err("bad codelengths","Corrupt PNG"); + z->maxcode[i] = code << (16-i); // preshift for inner loop + code <<= 1; + k += sizes[i]; + } + z->maxcode[16] = 0x10000; // sentinel + for (i=0; i < num; ++i) { + int s = sizelist[i]; + if (s) { + int c = next_code[s] - z->firstcode[s] + z->firstsymbol[s]; + stbi__uint16 fastv = (stbi__uint16) ((s << 9) | i); + z->size [c] = (stbi_uc ) s; + z->value[c] = (stbi__uint16) i; + if (s <= STBI__ZFAST_BITS) { + int j = stbi__bit_reverse(next_code[s],s); + while (j < (1 << STBI__ZFAST_BITS)) { + z->fast[j] = fastv; + j += (1 << s); + } + } + ++next_code[s]; + } + } + return 1; +} + +// zlib-from-memory implementation for PNG reading +// because PNG allows splitting the zlib stream arbitrarily, +// and it's annoying structurally to have PNG call ZLIB call PNG, +// we require PNG read all the IDATs and combine them into a single +// memory buffer + +typedef struct +{ + stbi_uc *zbuffer, *zbuffer_end; + int num_bits; + stbi__uint32 code_buffer; + + char *zout; + char *zout_start; + char *zout_end; + int z_expandable; + + stbi__zhuffman z_length, z_distance; +} stbi__zbuf; + +stbi_inline static int stbi__zeof(stbi__zbuf *z) +{ + return (z->zbuffer >= z->zbuffer_end); +} + +stbi_inline static stbi_uc stbi__zget8(stbi__zbuf *z) +{ + return stbi__zeof(z) ? 0 : *z->zbuffer++; +} + +static void stbi__fill_bits(stbi__zbuf *z) +{ + do { + if (z->code_buffer >= (1U << z->num_bits)) { + z->zbuffer = z->zbuffer_end; /* treat this as EOF so we fail. */ + return; + } + z->code_buffer |= (unsigned int) stbi__zget8(z) << z->num_bits; + z->num_bits += 8; + } while (z->num_bits <= 24); +} + +stbi_inline static unsigned int stbi__zreceive(stbi__zbuf *z, int n) +{ + unsigned int k; + if (z->num_bits < n) stbi__fill_bits(z); + k = z->code_buffer & ((1 << n) - 1); + z->code_buffer >>= n; + z->num_bits -= n; + return k; +} + +static int stbi__zhuffman_decode_slowpath(stbi__zbuf *a, stbi__zhuffman *z) +{ + int b,s,k; + // not resolved by fast table, so compute it the slow way + // use jpeg approach, which requires MSbits at top + k = stbi__bit_reverse(a->code_buffer, 16); + for (s=STBI__ZFAST_BITS+1; ; ++s) + if (k < z->maxcode[s]) + break; + if (s >= 16) return -1; // invalid code! + // code size is s, so: + b = (k >> (16-s)) - z->firstcode[s] + z->firstsymbol[s]; + if (b >= STBI__ZNSYMS) return -1; // some data was corrupt somewhere! + if (z->size[b] != s) return -1; // was originally an assert, but report failure instead. + a->code_buffer >>= s; + a->num_bits -= s; + return z->value[b]; +} + +stbi_inline static int stbi__zhuffman_decode(stbi__zbuf *a, stbi__zhuffman *z) +{ + int b,s; + if (a->num_bits < 16) { + if (stbi__zeof(a)) { + return -1; /* report error for unexpected end of data. */ + } + stbi__fill_bits(a); + } + b = z->fast[a->code_buffer & STBI__ZFAST_MASK]; + if (b) { + s = b >> 9; + a->code_buffer >>= s; + a->num_bits -= s; + return b & 511; + } + return stbi__zhuffman_decode_slowpath(a, z); +} + +static int stbi__zexpand(stbi__zbuf *z, char *zout, int n) // need to make room for n bytes +{ + char *q; + unsigned int cur, limit, old_limit; + z->zout = zout; + if (!z->z_expandable) return stbi__err("output buffer limit","Corrupt PNG"); + cur = (unsigned int) (z->zout - z->zout_start); + limit = old_limit = (unsigned) (z->zout_end - z->zout_start); + if (UINT_MAX - cur < (unsigned) n) return stbi__err("outofmem", "Out of memory"); + while (cur + n > limit) { + if(limit > UINT_MAX / 2) return stbi__err("outofmem", "Out of memory"); + limit *= 2; + } + q = (char *) STBI_REALLOC_SIZED(z->zout_start, old_limit, limit); + STBI_NOTUSED(old_limit); + if (q == NULL) return stbi__err("outofmem", "Out of memory"); + z->zout_start = q; + z->zout = q + cur; + z->zout_end = q + limit; + return 1; +} + +static const int stbi__zlength_base[31] = { + 3,4,5,6,7,8,9,10,11,13, + 15,17,19,23,27,31,35,43,51,59, + 67,83,99,115,131,163,195,227,258,0,0 }; + +static const int stbi__zlength_extra[31]= +{ 0,0,0,0,0,0,0,0,1,1,1,1,2,2,2,2,3,3,3,3,4,4,4,4,5,5,5,5,0,0,0 }; + +static const int stbi__zdist_base[32] = { 1,2,3,4,5,7,9,13,17,25,33,49,65,97,129,193, +257,385,513,769,1025,1537,2049,3073,4097,6145,8193,12289,16385,24577,0,0}; + +static const int stbi__zdist_extra[32] = +{ 0,0,0,0,1,1,2,2,3,3,4,4,5,5,6,6,7,7,8,8,9,9,10,10,11,11,12,12,13,13}; + +static int stbi__parse_huffman_block(stbi__zbuf *a) +{ + char *zout = a->zout; + for(;;) { + int z = stbi__zhuffman_decode(a, &a->z_length); + if (z < 256) { + if (z < 0) return stbi__err("bad huffman code","Corrupt PNG"); // error in huffman codes + if (zout >= a->zout_end) { + if (!stbi__zexpand(a, zout, 1)) return 0; + zout = a->zout; + } + *zout++ = (char) z; + } else { + stbi_uc *p; + int len,dist; + if (z == 256) { + a->zout = zout; + return 1; + } + if (z >= 286) return stbi__err("bad huffman code","Corrupt PNG"); // per DEFLATE, length codes 286 and 287 must not appear in compressed data + z -= 257; + len = stbi__zlength_base[z]; + if (stbi__zlength_extra[z]) len += stbi__zreceive(a, stbi__zlength_extra[z]); + z = stbi__zhuffman_decode(a, &a->z_distance); + if (z < 0 || z >= 30) return stbi__err("bad huffman code","Corrupt PNG"); // per DEFLATE, distance codes 30 and 31 must not appear in compressed data + dist = stbi__zdist_base[z]; + if (stbi__zdist_extra[z]) dist += stbi__zreceive(a, stbi__zdist_extra[z]); + if (zout - a->zout_start < dist) return stbi__err("bad dist","Corrupt PNG"); + if (zout + len > a->zout_end) { + if (!stbi__zexpand(a, zout, len)) return 0; + zout = a->zout; + } + p = (stbi_uc *) (zout - dist); + if (dist == 1) { // run of one byte; common in images. + stbi_uc v = *p; + if (len) { do *zout++ = v; while (--len); } + } else { + if (len) { do *zout++ = *p++; while (--len); } + } + } + } +} + +static int stbi__compute_huffman_codes(stbi__zbuf *a) +{ + static const stbi_uc length_dezigzag[19] = { 16,17,18,0,8,7,9,6,10,5,11,4,12,3,13,2,14,1,15 }; + stbi__zhuffman z_codelength; + stbi_uc lencodes[286+32+137];//padding for maximum single op + stbi_uc codelength_sizes[19]; + int i,n; + + int hlit = stbi__zreceive(a,5) + 257; + int hdist = stbi__zreceive(a,5) + 1; + int hclen = stbi__zreceive(a,4) + 4; + int ntot = hlit + hdist; + + memset(codelength_sizes, 0, sizeof(codelength_sizes)); + for (i=0; i < hclen; ++i) { + int s = stbi__zreceive(a,3); + codelength_sizes[length_dezigzag[i]] = (stbi_uc) s; + } + if (!stbi__zbuild_huffman(&z_codelength, codelength_sizes, 19)) return 0; + + n = 0; + while (n < ntot) { + int c = stbi__zhuffman_decode(a, &z_codelength); + if (c < 0 || c >= 19) return stbi__err("bad codelengths", "Corrupt PNG"); + if (c < 16) + lencodes[n++] = (stbi_uc) c; + else { + stbi_uc fill = 0; + if (c == 16) { + c = stbi__zreceive(a,2)+3; + if (n == 0) return stbi__err("bad codelengths", "Corrupt PNG"); + fill = lencodes[n-1]; + } else if (c == 17) { + c = stbi__zreceive(a,3)+3; + } else if (c == 18) { + c = stbi__zreceive(a,7)+11; + } else { + return stbi__err("bad codelengths", "Corrupt PNG"); + } + if (ntot - n < c) return stbi__err("bad codelengths", "Corrupt PNG"); + memset(lencodes+n, fill, c); + n += c; + } + } + if (n != ntot) return stbi__err("bad codelengths","Corrupt PNG"); + if (!stbi__zbuild_huffman(&a->z_length, lencodes, hlit)) return 0; + if (!stbi__zbuild_huffman(&a->z_distance, lencodes+hlit, hdist)) return 0; + return 1; +} + +static int stbi__parse_uncompressed_block(stbi__zbuf *a) +{ + stbi_uc header[4]; + int len,nlen,k; + if (a->num_bits & 7) + stbi__zreceive(a, a->num_bits & 7); // discard + // drain the bit-packed data into header + k = 0; + while (a->num_bits > 0) { + header[k++] = (stbi_uc) (a->code_buffer & 255); // suppress MSVC run-time check + a->code_buffer >>= 8; + a->num_bits -= 8; + } + if (a->num_bits < 0) return stbi__err("zlib corrupt","Corrupt PNG"); + // now fill header the normal way + while (k < 4) + header[k++] = stbi__zget8(a); + len = header[1] * 256 + header[0]; + nlen = header[3] * 256 + header[2]; + if (nlen != (len ^ 0xffff)) return stbi__err("zlib corrupt","Corrupt PNG"); + if (a->zbuffer + len > a->zbuffer_end) return stbi__err("read past buffer","Corrupt PNG"); + if (a->zout + len > a->zout_end) + if (!stbi__zexpand(a, a->zout, len)) return 0; + memcpy(a->zout, a->zbuffer, len); + a->zbuffer += len; + a->zout += len; + return 1; +} + +static int stbi__parse_zlib_header(stbi__zbuf *a) +{ + int cmf = stbi__zget8(a); + int cm = cmf & 15; + /* int cinfo = cmf >> 4; */ + int flg = stbi__zget8(a); + if (stbi__zeof(a)) return stbi__err("bad zlib header","Corrupt PNG"); // zlib spec + if ((cmf*256+flg) % 31 != 0) return stbi__err("bad zlib header","Corrupt PNG"); // zlib spec + if (flg & 32) return stbi__err("no preset dict","Corrupt PNG"); // preset dictionary not allowed in png + if (cm != 8) return stbi__err("bad compression","Corrupt PNG"); // DEFLATE required for png + // window = 1 << (8 + cinfo)... but who cares, we fully buffer output + return 1; +} + +static const stbi_uc stbi__zdefault_length[STBI__ZNSYMS] = +{ + 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, + 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, + 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, + 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, + 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, 9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9, + 9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9, 9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9, + 9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9, 9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9, + 9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9, 9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9, + 7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7, 7,7,7,7,7,7,7,7,8,8,8,8,8,8,8,8 +}; +static const stbi_uc stbi__zdefault_distance[32] = +{ + 5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5 +}; +/* +Init algorithm: +{ + int i; // use <= to match clearly with spec + for (i=0; i <= 143; ++i) stbi__zdefault_length[i] = 8; + for ( ; i <= 255; ++i) stbi__zdefault_length[i] = 9; + for ( ; i <= 279; ++i) stbi__zdefault_length[i] = 7; + for ( ; i <= 287; ++i) stbi__zdefault_length[i] = 8; + + for (i=0; i <= 31; ++i) stbi__zdefault_distance[i] = 5; +} +*/ + +static int stbi__parse_zlib(stbi__zbuf *a, int parse_header) +{ + int final, type; + if (parse_header) + if (!stbi__parse_zlib_header(a)) return 0; + a->num_bits = 0; + a->code_buffer = 0; + do { + final = stbi__zreceive(a,1); + type = stbi__zreceive(a,2); + if (type == 0) { + if (!stbi__parse_uncompressed_block(a)) return 0; + } else if (type == 3) { + return 0; + } else { + if (type == 1) { + // use fixed code lengths + if (!stbi__zbuild_huffman(&a->z_length , stbi__zdefault_length , STBI__ZNSYMS)) return 0; + if (!stbi__zbuild_huffman(&a->z_distance, stbi__zdefault_distance, 32)) return 0; + } else { + if (!stbi__compute_huffman_codes(a)) return 0; + } + if (!stbi__parse_huffman_block(a)) return 0; + } + } while (!final); + return 1; +} + +static int stbi__do_zlib(stbi__zbuf *a, char *obuf, int olen, int exp, int parse_header) +{ + a->zout_start = obuf; + a->zout = obuf; + a->zout_end = obuf + olen; + a->z_expandable = exp; + + return stbi__parse_zlib(a, parse_header); +} + +STBIDEF char *stbi_zlib_decode_malloc_guesssize(const char *buffer, int len, int initial_size, int *outlen) +{ + stbi__zbuf a; + char *p = (char *) stbi__malloc(initial_size); + if (p == NULL) return NULL; + a.zbuffer = (stbi_uc *) buffer; + a.zbuffer_end = (stbi_uc *) buffer + len; + if (stbi__do_zlib(&a, p, initial_size, 1, 1)) { + if (outlen) *outlen = (int) (a.zout - a.zout_start); + return a.zout_start; + } else { + STBI_FREE(a.zout_start); + return NULL; + } +} + +STBIDEF char *stbi_zlib_decode_malloc(char const *buffer, int len, int *outlen) +{ + return stbi_zlib_decode_malloc_guesssize(buffer, len, 16384, outlen); +} + +STBIDEF char *stbi_zlib_decode_malloc_guesssize_headerflag(const char *buffer, int len, int initial_size, int *outlen, int parse_header) +{ + stbi__zbuf a; + char *p = (char *) stbi__malloc(initial_size); + if (p == NULL) return NULL; + a.zbuffer = (stbi_uc *) buffer; + a.zbuffer_end = (stbi_uc *) buffer + len; + if (stbi__do_zlib(&a, p, initial_size, 1, parse_header)) { + if (outlen) *outlen = (int) (a.zout - a.zout_start); + return a.zout_start; + } else { + STBI_FREE(a.zout_start); + return NULL; + } +} + +STBIDEF int stbi_zlib_decode_buffer(char *obuffer, int olen, char const *ibuffer, int ilen) +{ + stbi__zbuf a; + a.zbuffer = (stbi_uc *) ibuffer; + a.zbuffer_end = (stbi_uc *) ibuffer + ilen; + if (stbi__do_zlib(&a, obuffer, olen, 0, 1)) + return (int) (a.zout - a.zout_start); + else + return -1; +} + +STBIDEF char *stbi_zlib_decode_noheader_malloc(char const *buffer, int len, int *outlen) +{ + stbi__zbuf a; + char *p = (char *) stbi__malloc(16384); + if (p == NULL) return NULL; + a.zbuffer = (stbi_uc *) buffer; + a.zbuffer_end = (stbi_uc *) buffer+len; + if (stbi__do_zlib(&a, p, 16384, 1, 0)) { + if (outlen) *outlen = (int) (a.zout - a.zout_start); + return a.zout_start; + } else { + STBI_FREE(a.zout_start); + return NULL; + } +} + +STBIDEF int stbi_zlib_decode_noheader_buffer(char *obuffer, int olen, const char *ibuffer, int ilen) +{ + stbi__zbuf a; + a.zbuffer = (stbi_uc *) ibuffer; + a.zbuffer_end = (stbi_uc *) ibuffer + ilen; + if (stbi__do_zlib(&a, obuffer, olen, 0, 0)) + return (int) (a.zout - a.zout_start); + else + return -1; +} +#endif + +// public domain "baseline" PNG decoder v0.10 Sean Barrett 2006-11-18 +// simple implementation +// - only 8-bit samples +// - no CRC checking +// - allocates lots of intermediate memory +// - avoids problem of streaming data between subsystems +// - avoids explicit window management +// performance +// - uses stb_zlib, a PD zlib implementation with fast huffman decoding + +#ifndef STBI_NO_PNG +typedef struct +{ + stbi__uint32 length; + stbi__uint32 type; +} stbi__pngchunk; + +static stbi__pngchunk stbi__get_chunk_header(stbi__context *s) +{ + stbi__pngchunk c; + c.length = stbi__get32be(s); + c.type = stbi__get32be(s); + return c; +} + +static int stbi__check_png_header(stbi__context *s) +{ + static const stbi_uc png_sig[8] = { 137,80,78,71,13,10,26,10 }; + int i; + for (i=0; i < 8; ++i) + if (stbi__get8(s) != png_sig[i]) return stbi__err("bad png sig","Not a PNG"); + return 1; +} + +typedef struct +{ + stbi__context *s; + stbi_uc *idata, *expanded, *out; + int depth; +} stbi__png; + + +enum { + STBI__F_none=0, + STBI__F_sub=1, + STBI__F_up=2, + STBI__F_avg=3, + STBI__F_paeth=4, + // synthetic filters used for first scanline to avoid needing a dummy row of 0s + STBI__F_avg_first, + STBI__F_paeth_first +}; + +static stbi_uc first_row_filter[5] = +{ + STBI__F_none, + STBI__F_sub, + STBI__F_none, + STBI__F_avg_first, + STBI__F_paeth_first +}; + +static int stbi__paeth(int a, int b, int c) +{ + int p = a + b - c; + int pa = abs(p-a); + int pb = abs(p-b); + int pc = abs(p-c); + if (pa <= pb && pa <= pc) return a; + if (pb <= pc) return b; + return c; +} + +static const stbi_uc stbi__depth_scale_table[9] = { 0, 0xff, 0x55, 0, 0x11, 0,0,0, 0x01 }; + +// create the png data from post-deflated data +static int stbi__create_png_image_raw(stbi__png *a, stbi_uc *raw, stbi__uint32 raw_len, int out_n, stbi__uint32 x, stbi__uint32 y, int depth, int color) +{ + int bytes = (depth == 16? 2 : 1); + stbi__context *s = a->s; + stbi__uint32 i,j,stride = x*out_n*bytes; + stbi__uint32 img_len, img_width_bytes; + int k; + int img_n = s->img_n; // copy it into a local for later + + int output_bytes = out_n*bytes; + int filter_bytes = img_n*bytes; + int width = x; + + STBI_ASSERT(out_n == s->img_n || out_n == s->img_n+1); + a->out = (stbi_uc *) stbi__malloc_mad3(x, y, output_bytes, 0); // extra bytes to write off the end into + if (!a->out) return stbi__err("outofmem", "Out of memory"); + + if (!stbi__mad3sizes_valid(img_n, x, depth, 7)) return stbi__err("too large", "Corrupt PNG"); + img_width_bytes = (((img_n * x * depth) + 7) >> 3); + img_len = (img_width_bytes + 1) * y; + + // we used to check for exact match between raw_len and img_len on non-interlaced PNGs, + // but issue #276 reported a PNG in the wild that had extra data at the end (all zeros), + // so just check for raw_len < img_len always. + if (raw_len < img_len) return stbi__err("not enough pixels","Corrupt PNG"); + + for (j=0; j < y; ++j) { + stbi_uc *cur = a->out + stride*j; + stbi_uc *prior; + int filter = *raw++; + + if (filter > 4) + return stbi__err("invalid filter","Corrupt PNG"); + + if (depth < 8) { + if (img_width_bytes > x) return stbi__err("invalid width","Corrupt PNG"); + cur += x*out_n - img_width_bytes; // store output to the rightmost img_len bytes, so we can decode in place + filter_bytes = 1; + width = img_width_bytes; + } + prior = cur - stride; // bugfix: need to compute this after 'cur +=' computation above + + // if first row, use special filter that doesn't sample previous row + if (j == 0) filter = first_row_filter[filter]; + + // handle first byte explicitly + for (k=0; k < filter_bytes; ++k) { + switch (filter) { + case STBI__F_none : cur[k] = raw[k]; break; + case STBI__F_sub : cur[k] = raw[k]; break; + case STBI__F_up : cur[k] = STBI__BYTECAST(raw[k] + prior[k]); break; + case STBI__F_avg : cur[k] = STBI__BYTECAST(raw[k] + (prior[k]>>1)); break; + case STBI__F_paeth : cur[k] = STBI__BYTECAST(raw[k] + stbi__paeth(0,prior[k],0)); break; + case STBI__F_avg_first : cur[k] = raw[k]; break; + case STBI__F_paeth_first: cur[k] = raw[k]; break; + } + } + + if (depth == 8) { + if (img_n != out_n) + cur[img_n] = 255; // first pixel + raw += img_n; + cur += out_n; + prior += out_n; + } else if (depth == 16) { + if (img_n != out_n) { + cur[filter_bytes] = 255; // first pixel top byte + cur[filter_bytes+1] = 255; // first pixel bottom byte + } + raw += filter_bytes; + cur += output_bytes; + prior += output_bytes; + } else { + raw += 1; + cur += 1; + prior += 1; + } + + // this is a little gross, so that we don't switch per-pixel or per-component + if (depth < 8 || img_n == out_n) { + int nk = (width - 1)*filter_bytes; + #define STBI__CASE(f) \ + case f: \ + for (k=0; k < nk; ++k) + switch (filter) { + // "none" filter turns into a memcpy here; make that explicit. + case STBI__F_none: memcpy(cur, raw, nk); break; + STBI__CASE(STBI__F_sub) { cur[k] = STBI__BYTECAST(raw[k] + cur[k-filter_bytes]); } break; + STBI__CASE(STBI__F_up) { cur[k] = STBI__BYTECAST(raw[k] + prior[k]); } break; + STBI__CASE(STBI__F_avg) { cur[k] = STBI__BYTECAST(raw[k] + ((prior[k] + cur[k-filter_bytes])>>1)); } break; + STBI__CASE(STBI__F_paeth) { cur[k] = STBI__BYTECAST(raw[k] + stbi__paeth(cur[k-filter_bytes],prior[k],prior[k-filter_bytes])); } break; + STBI__CASE(STBI__F_avg_first) { cur[k] = STBI__BYTECAST(raw[k] + (cur[k-filter_bytes] >> 1)); } break; + STBI__CASE(STBI__F_paeth_first) { cur[k] = STBI__BYTECAST(raw[k] + stbi__paeth(cur[k-filter_bytes],0,0)); } break; + } + #undef STBI__CASE + raw += nk; + } else { + STBI_ASSERT(img_n+1 == out_n); + #define STBI__CASE(f) \ + case f: \ + for (i=x-1; i >= 1; --i, cur[filter_bytes]=255,raw+=filter_bytes,cur+=output_bytes,prior+=output_bytes) \ + for (k=0; k < filter_bytes; ++k) + switch (filter) { + STBI__CASE(STBI__F_none) { cur[k] = raw[k]; } break; + STBI__CASE(STBI__F_sub) { cur[k] = STBI__BYTECAST(raw[k] + cur[k- output_bytes]); } break; + STBI__CASE(STBI__F_up) { cur[k] = STBI__BYTECAST(raw[k] + prior[k]); } break; + STBI__CASE(STBI__F_avg) { cur[k] = STBI__BYTECAST(raw[k] + ((prior[k] + cur[k- output_bytes])>>1)); } break; + STBI__CASE(STBI__F_paeth) { cur[k] = STBI__BYTECAST(raw[k] + stbi__paeth(cur[k- output_bytes],prior[k],prior[k- output_bytes])); } break; + STBI__CASE(STBI__F_avg_first) { cur[k] = STBI__BYTECAST(raw[k] + (cur[k- output_bytes] >> 1)); } break; + STBI__CASE(STBI__F_paeth_first) { cur[k] = STBI__BYTECAST(raw[k] + stbi__paeth(cur[k- output_bytes],0,0)); } break; + } + #undef STBI__CASE + + // the loop above sets the high byte of the pixels' alpha, but for + // 16 bit png files we also need the low byte set. we'll do that here. + if (depth == 16) { + cur = a->out + stride*j; // start at the beginning of the row again + for (i=0; i < x; ++i,cur+=output_bytes) { + cur[filter_bytes+1] = 255; + } + } + } + } + + // we make a separate pass to expand bits to pixels; for performance, + // this could run two scanlines behind the above code, so it won't + // intefere with filtering but will still be in the cache. + if (depth < 8) { + for (j=0; j < y; ++j) { + stbi_uc *cur = a->out + stride*j; + stbi_uc *in = a->out + stride*j + x*out_n - img_width_bytes; + // unpack 1/2/4-bit into a 8-bit buffer. allows us to keep the common 8-bit path optimal at minimal cost for 1/2/4-bit + // png guarante byte alignment, if width is not multiple of 8/4/2 we'll decode dummy trailing data that will be skipped in the later loop + stbi_uc scale = (color == 0) ? stbi__depth_scale_table[depth] : 1; // scale grayscale values to 0..255 range + + // note that the final byte might overshoot and write more data than desired. + // we can allocate enough data that this never writes out of memory, but it + // could also overwrite the next scanline. can it overwrite non-empty data + // on the next scanline? yes, consider 1-pixel-wide scanlines with 1-bit-per-pixel. + // so we need to explicitly clamp the final ones + + if (depth == 4) { + for (k=x*img_n; k >= 2; k-=2, ++in) { + *cur++ = scale * ((*in >> 4) ); + *cur++ = scale * ((*in ) & 0x0f); + } + if (k > 0) *cur++ = scale * ((*in >> 4) ); + } else if (depth == 2) { + for (k=x*img_n; k >= 4; k-=4, ++in) { + *cur++ = scale * ((*in >> 6) ); + *cur++ = scale * ((*in >> 4) & 0x03); + *cur++ = scale * ((*in >> 2) & 0x03); + *cur++ = scale * ((*in ) & 0x03); + } + if (k > 0) *cur++ = scale * ((*in >> 6) ); + if (k > 1) *cur++ = scale * ((*in >> 4) & 0x03); + if (k > 2) *cur++ = scale * ((*in >> 2) & 0x03); + } else if (depth == 1) { + for (k=x*img_n; k >= 8; k-=8, ++in) { + *cur++ = scale * ((*in >> 7) ); + *cur++ = scale * ((*in >> 6) & 0x01); + *cur++ = scale * ((*in >> 5) & 0x01); + *cur++ = scale * ((*in >> 4) & 0x01); + *cur++ = scale * ((*in >> 3) & 0x01); + *cur++ = scale * ((*in >> 2) & 0x01); + *cur++ = scale * ((*in >> 1) & 0x01); + *cur++ = scale * ((*in ) & 0x01); + } + if (k > 0) *cur++ = scale * ((*in >> 7) ); + if (k > 1) *cur++ = scale * ((*in >> 6) & 0x01); + if (k > 2) *cur++ = scale * ((*in >> 5) & 0x01); + if (k > 3) *cur++ = scale * ((*in >> 4) & 0x01); + if (k > 4) *cur++ = scale * ((*in >> 3) & 0x01); + if (k > 5) *cur++ = scale * ((*in >> 2) & 0x01); + if (k > 6) *cur++ = scale * ((*in >> 1) & 0x01); + } + if (img_n != out_n) { + int q; + // insert alpha = 255 + cur = a->out + stride*j; + if (img_n == 1) { + for (q=x-1; q >= 0; --q) { + cur[q*2+1] = 255; + cur[q*2+0] = cur[q]; + } + } else { + STBI_ASSERT(img_n == 3); + for (q=x-1; q >= 0; --q) { + cur[q*4+3] = 255; + cur[q*4+2] = cur[q*3+2]; + cur[q*4+1] = cur[q*3+1]; + cur[q*4+0] = cur[q*3+0]; + } + } + } + } + } else if (depth == 16) { + // force the image data from big-endian to platform-native. + // this is done in a separate pass due to the decoding relying + // on the data being untouched, but could probably be done + // per-line during decode if care is taken. + stbi_uc *cur = a->out; + stbi__uint16 *cur16 = (stbi__uint16*)cur; + + for(i=0; i < x*y*out_n; ++i,cur16++,cur+=2) { + *cur16 = (cur[0] << 8) | cur[1]; + } + } + + return 1; +} + +static int stbi__create_png_image(stbi__png *a, stbi_uc *image_data, stbi__uint32 image_data_len, int out_n, int depth, int color, int interlaced) +{ + int bytes = (depth == 16 ? 2 : 1); + int out_bytes = out_n * bytes; + stbi_uc *final; + int p; + if (!interlaced) + return stbi__create_png_image_raw(a, image_data, image_data_len, out_n, a->s->img_x, a->s->img_y, depth, color); + + // de-interlacing + final = (stbi_uc *) stbi__malloc_mad3(a->s->img_x, a->s->img_y, out_bytes, 0); + if (!final) return stbi__err("outofmem", "Out of memory"); + for (p=0; p < 7; ++p) { + int xorig[] = { 0,4,0,2,0,1,0 }; + int yorig[] = { 0,0,4,0,2,0,1 }; + int xspc[] = { 8,8,4,4,2,2,1 }; + int yspc[] = { 8,8,8,4,4,2,2 }; + int i,j,x,y; + // pass1_x[4] = 0, pass1_x[5] = 1, pass1_x[12] = 1 + x = (a->s->img_x - xorig[p] + xspc[p]-1) / xspc[p]; + y = (a->s->img_y - yorig[p] + yspc[p]-1) / yspc[p]; + if (x && y) { + stbi__uint32 img_len = ((((a->s->img_n * x * depth) + 7) >> 3) + 1) * y; + if (!stbi__create_png_image_raw(a, image_data, image_data_len, out_n, x, y, depth, color)) { + STBI_FREE(final); + return 0; + } + for (j=0; j < y; ++j) { + for (i=0; i < x; ++i) { + int out_y = j*yspc[p]+yorig[p]; + int out_x = i*xspc[p]+xorig[p]; + memcpy(final + out_y*a->s->img_x*out_bytes + out_x*out_bytes, + a->out + (j*x+i)*out_bytes, out_bytes); + } + } + STBI_FREE(a->out); + image_data += img_len; + image_data_len -= img_len; + } + } + a->out = final; + + return 1; +} + +static int stbi__compute_transparency(stbi__png *z, stbi_uc tc[3], int out_n) +{ + stbi__context *s = z->s; + stbi__uint32 i, pixel_count = s->img_x * s->img_y; + stbi_uc *p = z->out; + + // compute color-based transparency, assuming we've + // already got 255 as the alpha value in the output + STBI_ASSERT(out_n == 2 || out_n == 4); + + if (out_n == 2) { + for (i=0; i < pixel_count; ++i) { + p[1] = (p[0] == tc[0] ? 0 : 255); + p += 2; + } + } else { + for (i=0; i < pixel_count; ++i) { + if (p[0] == tc[0] && p[1] == tc[1] && p[2] == tc[2]) + p[3] = 0; + p += 4; + } + } + return 1; +} + +static int stbi__compute_transparency16(stbi__png *z, stbi__uint16 tc[3], int out_n) +{ + stbi__context *s = z->s; + stbi__uint32 i, pixel_count = s->img_x * s->img_y; + stbi__uint16 *p = (stbi__uint16*) z->out; + + // compute color-based transparency, assuming we've + // already got 65535 as the alpha value in the output + STBI_ASSERT(out_n == 2 || out_n == 4); + + if (out_n == 2) { + for (i = 0; i < pixel_count; ++i) { + p[1] = (p[0] == tc[0] ? 0 : 65535); + p += 2; + } + } else { + for (i = 0; i < pixel_count; ++i) { + if (p[0] == tc[0] && p[1] == tc[1] && p[2] == tc[2]) + p[3] = 0; + p += 4; + } + } + return 1; +} + +static int stbi__expand_png_palette(stbi__png *a, stbi_uc *palette, int len, int pal_img_n) +{ + stbi__uint32 i, pixel_count = a->s->img_x * a->s->img_y; + stbi_uc *p, *temp_out, *orig = a->out; + + p = (stbi_uc *) stbi__malloc_mad2(pixel_count, pal_img_n, 0); + if (p == NULL) return stbi__err("outofmem", "Out of memory"); + + // between here and free(out) below, exitting would leak + temp_out = p; + + if (pal_img_n == 3) { + for (i=0; i < pixel_count; ++i) { + int n = orig[i]*4; + p[0] = palette[n ]; + p[1] = palette[n+1]; + p[2] = palette[n+2]; + p += 3; + } + } else { + for (i=0; i < pixel_count; ++i) { + int n = orig[i]*4; + p[0] = palette[n ]; + p[1] = palette[n+1]; + p[2] = palette[n+2]; + p[3] = palette[n+3]; + p += 4; + } + } + STBI_FREE(a->out); + a->out = temp_out; + + STBI_NOTUSED(len); + + return 1; +} + +static int stbi__unpremultiply_on_load_global = 0; +static int stbi__de_iphone_flag_global = 0; + +STBIDEF void stbi_set_unpremultiply_on_load(int flag_true_if_should_unpremultiply) +{ + stbi__unpremultiply_on_load_global = flag_true_if_should_unpremultiply; +} + +STBIDEF void stbi_convert_iphone_png_to_rgb(int flag_true_if_should_convert) +{ + stbi__de_iphone_flag_global = flag_true_if_should_convert; +} + +#ifndef STBI_THREAD_LOCAL +#define stbi__unpremultiply_on_load stbi__unpremultiply_on_load_global +#define stbi__de_iphone_flag stbi__de_iphone_flag_global +#else +static STBI_THREAD_LOCAL int stbi__unpremultiply_on_load_local, stbi__unpremultiply_on_load_set; +static STBI_THREAD_LOCAL int stbi__de_iphone_flag_local, stbi__de_iphone_flag_set; + +STBIDEF void stbi_set_unpremultiply_on_load_thread(int flag_true_if_should_unpremultiply) +{ + stbi__unpremultiply_on_load_local = flag_true_if_should_unpremultiply; + stbi__unpremultiply_on_load_set = 1; +} + +STBIDEF void stbi_convert_iphone_png_to_rgb_thread(int flag_true_if_should_convert) +{ + stbi__de_iphone_flag_local = flag_true_if_should_convert; + stbi__de_iphone_flag_set = 1; +} + +#define stbi__unpremultiply_on_load (stbi__unpremultiply_on_load_set \ + ? stbi__unpremultiply_on_load_local \ + : stbi__unpremultiply_on_load_global) +#define stbi__de_iphone_flag (stbi__de_iphone_flag_set \ + ? stbi__de_iphone_flag_local \ + : stbi__de_iphone_flag_global) +#endif // STBI_THREAD_LOCAL + +static void stbi__de_iphone(stbi__png *z) +{ + stbi__context *s = z->s; + stbi__uint32 i, pixel_count = s->img_x * s->img_y; + stbi_uc *p = z->out; + + if (s->img_out_n == 3) { // convert bgr to rgb + for (i=0; i < pixel_count; ++i) { + stbi_uc t = p[0]; + p[0] = p[2]; + p[2] = t; + p += 3; + } + } else { + STBI_ASSERT(s->img_out_n == 4); + if (stbi__unpremultiply_on_load) { + // convert bgr to rgb and unpremultiply + for (i=0; i < pixel_count; ++i) { + stbi_uc a = p[3]; + stbi_uc t = p[0]; + if (a) { + stbi_uc half = a / 2; + p[0] = (p[2] * 255 + half) / a; + p[1] = (p[1] * 255 + half) / a; + p[2] = ( t * 255 + half) / a; + } else { + p[0] = p[2]; + p[2] = t; + } + p += 4; + } + } else { + // convert bgr to rgb + for (i=0; i < pixel_count; ++i) { + stbi_uc t = p[0]; + p[0] = p[2]; + p[2] = t; + p += 4; + } + } + } +} + +#define STBI__PNG_TYPE(a,b,c,d) (((unsigned) (a) << 24) + ((unsigned) (b) << 16) + ((unsigned) (c) << 8) + (unsigned) (d)) + +static int stbi__parse_png_file(stbi__png *z, int scan, int req_comp) +{ + stbi_uc palette[1024], pal_img_n=0; + stbi_uc has_trans=0, tc[3]={0}; + stbi__uint16 tc16[3]; + stbi__uint32 ioff=0, idata_limit=0, i, pal_len=0; + int first=1,k,interlace=0, color=0, is_iphone=0; + stbi__context *s = z->s; + + z->expanded = NULL; + z->idata = NULL; + z->out = NULL; + + if (!stbi__check_png_header(s)) return 0; + + if (scan == STBI__SCAN_type) return 1; + + for (;;) { + stbi__pngchunk c = stbi__get_chunk_header(s); + switch (c.type) { + case STBI__PNG_TYPE('C','g','B','I'): + is_iphone = 1; + stbi__skip(s, c.length); + break; + case STBI__PNG_TYPE('I','H','D','R'): { + int comp,filter; + if (!first) return stbi__err("multiple IHDR","Corrupt PNG"); + first = 0; + if (c.length != 13) return stbi__err("bad IHDR len","Corrupt PNG"); + s->img_x = stbi__get32be(s); + s->img_y = stbi__get32be(s); + if (s->img_y > STBI_MAX_DIMENSIONS) return stbi__err("too large","Very large image (corrupt?)"); + if (s->img_x > STBI_MAX_DIMENSIONS) return stbi__err("too large","Very large image (corrupt?)"); + z->depth = stbi__get8(s); if (z->depth != 1 && z->depth != 2 && z->depth != 4 && z->depth != 8 && z->depth != 16) return stbi__err("1/2/4/8/16-bit only","PNG not supported: 1/2/4/8/16-bit only"); + color = stbi__get8(s); if (color > 6) return stbi__err("bad ctype","Corrupt PNG"); + if (color == 3 && z->depth == 16) return stbi__err("bad ctype","Corrupt PNG"); + if (color == 3) pal_img_n = 3; else if (color & 1) return stbi__err("bad ctype","Corrupt PNG"); + comp = stbi__get8(s); if (comp) return stbi__err("bad comp method","Corrupt PNG"); + filter= stbi__get8(s); if (filter) return stbi__err("bad filter method","Corrupt PNG"); + interlace = stbi__get8(s); if (interlace>1) return stbi__err("bad interlace method","Corrupt PNG"); + if (!s->img_x || !s->img_y) return stbi__err("0-pixel image","Corrupt PNG"); + if (!pal_img_n) { + s->img_n = (color & 2 ? 3 : 1) + (color & 4 ? 1 : 0); + if ((1 << 30) / s->img_x / s->img_n < s->img_y) return stbi__err("too large", "Image too large to decode"); + } else { + // if paletted, then pal_n is our final components, and + // img_n is # components to decompress/filter. + s->img_n = 1; + if ((1 << 30) / s->img_x / 4 < s->img_y) return stbi__err("too large","Corrupt PNG"); + } + // even with SCAN_header, have to scan to see if we have a tRNS + break; + } + + case STBI__PNG_TYPE('P','L','T','E'): { + if (first) return stbi__err("first not IHDR", "Corrupt PNG"); + if (c.length > 256*3) return stbi__err("invalid PLTE","Corrupt PNG"); + pal_len = c.length / 3; + if (pal_len * 3 != c.length) return stbi__err("invalid PLTE","Corrupt PNG"); + for (i=0; i < pal_len; ++i) { + palette[i*4+0] = stbi__get8(s); + palette[i*4+1] = stbi__get8(s); + palette[i*4+2] = stbi__get8(s); + palette[i*4+3] = 255; + } + break; + } + + case STBI__PNG_TYPE('t','R','N','S'): { + if (first) return stbi__err("first not IHDR", "Corrupt PNG"); + if (z->idata) return stbi__err("tRNS after IDAT","Corrupt PNG"); + if (pal_img_n) { + if (scan == STBI__SCAN_header) { s->img_n = 4; return 1; } + if (pal_len == 0) return stbi__err("tRNS before PLTE","Corrupt PNG"); + if (c.length > pal_len) return stbi__err("bad tRNS len","Corrupt PNG"); + pal_img_n = 4; + for (i=0; i < c.length; ++i) + palette[i*4+3] = stbi__get8(s); + } else { + if (!(s->img_n & 1)) return stbi__err("tRNS with alpha","Corrupt PNG"); + if (c.length != (stbi__uint32) s->img_n*2) return stbi__err("bad tRNS len","Corrupt PNG"); + has_trans = 1; + // non-paletted with tRNS = constant alpha. if header-scanning, we can stop now. + if (scan == STBI__SCAN_header) { ++s->img_n; return 1; } + if (z->depth == 16) { + for (k = 0; k < s->img_n; ++k) tc16[k] = (stbi__uint16)stbi__get16be(s); // copy the values as-is + } else { + for (k = 0; k < s->img_n; ++k) tc[k] = (stbi_uc)(stbi__get16be(s) & 255) * stbi__depth_scale_table[z->depth]; // non 8-bit images will be larger + } + } + break; + } + + case STBI__PNG_TYPE('I','D','A','T'): { + if (first) return stbi__err("first not IHDR", "Corrupt PNG"); + if (pal_img_n && !pal_len) return stbi__err("no PLTE","Corrupt PNG"); + if (scan == STBI__SCAN_header) { + // header scan definitely stops at first IDAT + if (pal_img_n) + s->img_n = pal_img_n; + return 1; + } + if (c.length > (1u << 30)) return stbi__err("IDAT size limit", "IDAT section larger than 2^30 bytes"); + if ((int)(ioff + c.length) < (int)ioff) return 0; + if (ioff + c.length > idata_limit) { + stbi__uint32 idata_limit_old = idata_limit; + stbi_uc *p; + if (idata_limit == 0) idata_limit = c.length > 4096 ? c.length : 4096; + while (ioff + c.length > idata_limit) + idata_limit *= 2; + STBI_NOTUSED(idata_limit_old); + p = (stbi_uc *) STBI_REALLOC_SIZED(z->idata, idata_limit_old, idata_limit); if (p == NULL) return stbi__err("outofmem", "Out of memory"); + z->idata = p; + } + if (!stbi__getn(s, z->idata+ioff,c.length)) return stbi__err("outofdata","Corrupt PNG"); + ioff += c.length; + break; + } + + case STBI__PNG_TYPE('I','E','N','D'): { + stbi__uint32 raw_len, bpl; + if (first) return stbi__err("first not IHDR", "Corrupt PNG"); + if (scan != STBI__SCAN_load) return 1; + if (z->idata == NULL) return stbi__err("no IDAT","Corrupt PNG"); + // initial guess for decoded data size to avoid unnecessary reallocs + bpl = (s->img_x * z->depth + 7) / 8; // bytes per line, per component + raw_len = bpl * s->img_y * s->img_n /* pixels */ + s->img_y /* filter mode per row */; + z->expanded = (stbi_uc *) stbi_zlib_decode_malloc_guesssize_headerflag((char *) z->idata, ioff, raw_len, (int *) &raw_len, !is_iphone); + if (z->expanded == NULL) return 0; // zlib should set error + STBI_FREE(z->idata); z->idata = NULL; + if ((req_comp == s->img_n+1 && req_comp != 3 && !pal_img_n) || has_trans) + s->img_out_n = s->img_n+1; + else + s->img_out_n = s->img_n; + if (!stbi__create_png_image(z, z->expanded, raw_len, s->img_out_n, z->depth, color, interlace)) return 0; + if (has_trans) { + if (z->depth == 16) { + if (!stbi__compute_transparency16(z, tc16, s->img_out_n)) return 0; + } else { + if (!stbi__compute_transparency(z, tc, s->img_out_n)) return 0; + } + } + if (is_iphone && stbi__de_iphone_flag && s->img_out_n > 2) + stbi__de_iphone(z); + if (pal_img_n) { + // pal_img_n == 3 or 4 + s->img_n = pal_img_n; // record the actual colors we had + s->img_out_n = pal_img_n; + if (req_comp >= 3) s->img_out_n = req_comp; + if (!stbi__expand_png_palette(z, palette, pal_len, s->img_out_n)) + return 0; + } else if (has_trans) { + // non-paletted image with tRNS -> source image has (constant) alpha + ++s->img_n; + } + STBI_FREE(z->expanded); z->expanded = NULL; + // end of PNG chunk, read and skip CRC + stbi__get32be(s); + return 1; + } + + default: + // if critical, fail + if (first) return stbi__err("first not IHDR", "Corrupt PNG"); + if ((c.type & (1 << 29)) == 0) { + #ifndef STBI_NO_FAILURE_STRINGS + // not threadsafe + static char invalid_chunk[] = "XXXX PNG chunk not known"; + invalid_chunk[0] = STBI__BYTECAST(c.type >> 24); + invalid_chunk[1] = STBI__BYTECAST(c.type >> 16); + invalid_chunk[2] = STBI__BYTECAST(c.type >> 8); + invalid_chunk[3] = STBI__BYTECAST(c.type >> 0); + #endif + return stbi__err(invalid_chunk, "PNG not supported: unknown PNG chunk type"); + } + stbi__skip(s, c.length); + break; + } + // end of PNG chunk, read and skip CRC + stbi__get32be(s); + } +} + +static void *stbi__do_png(stbi__png *p, int *x, int *y, int *n, int req_comp, stbi__result_info *ri) +{ + void *result=NULL; + if (req_comp < 0 || req_comp > 4) return stbi__errpuc("bad req_comp", "Internal error"); + if (stbi__parse_png_file(p, STBI__SCAN_load, req_comp)) { + if (p->depth <= 8) + ri->bits_per_channel = 8; + else if (p->depth == 16) + ri->bits_per_channel = 16; + else + return stbi__errpuc("bad bits_per_channel", "PNG not supported: unsupported color depth"); + result = p->out; + p->out = NULL; + if (req_comp && req_comp != p->s->img_out_n) { + if (ri->bits_per_channel == 8) + result = stbi__convert_format((unsigned char *) result, p->s->img_out_n, req_comp, p->s->img_x, p->s->img_y); + else + result = stbi__convert_format16((stbi__uint16 *) result, p->s->img_out_n, req_comp, p->s->img_x, p->s->img_y); + p->s->img_out_n = req_comp; + if (result == NULL) return result; + } + *x = p->s->img_x; + *y = p->s->img_y; + if (n) *n = p->s->img_n; + } + STBI_FREE(p->out); p->out = NULL; + STBI_FREE(p->expanded); p->expanded = NULL; + STBI_FREE(p->idata); p->idata = NULL; + + return result; +} + +static void *stbi__png_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri) +{ + stbi__png p; + p.s = s; + return stbi__do_png(&p, x,y,comp,req_comp, ri); +} + +static int stbi__png_test(stbi__context *s) +{ + int r; + r = stbi__check_png_header(s); + stbi__rewind(s); + return r; +} + +static int stbi__png_info_raw(stbi__png *p, int *x, int *y, int *comp) +{ + if (!stbi__parse_png_file(p, STBI__SCAN_header, 0)) { + stbi__rewind( p->s ); + return 0; + } + if (x) *x = p->s->img_x; + if (y) *y = p->s->img_y; + if (comp) *comp = p->s->img_n; + return 1; +} + +static int stbi__png_info(stbi__context *s, int *x, int *y, int *comp) +{ + stbi__png p; + p.s = s; + return stbi__png_info_raw(&p, x, y, comp); +} + +static int stbi__png_is16(stbi__context *s) +{ + stbi__png p; + p.s = s; + if (!stbi__png_info_raw(&p, NULL, NULL, NULL)) + return 0; + if (p.depth != 16) { + stbi__rewind(p.s); + return 0; + } + return 1; +} +#endif + +// Microsoft/Windows BMP image + +#ifndef STBI_NO_BMP +static int stbi__bmp_test_raw(stbi__context *s) +{ + int r; + int sz; + if (stbi__get8(s) != 'B') return 0; + if (stbi__get8(s) != 'M') return 0; + stbi__get32le(s); // discard filesize + stbi__get16le(s); // discard reserved + stbi__get16le(s); // discard reserved + stbi__get32le(s); // discard data offset + sz = stbi__get32le(s); + r = (sz == 12 || sz == 40 || sz == 56 || sz == 108 || sz == 124); + return r; +} + +static int stbi__bmp_test(stbi__context *s) +{ + int r = stbi__bmp_test_raw(s); + stbi__rewind(s); + return r; +} + + +// returns 0..31 for the highest set bit +static int stbi__high_bit(unsigned int z) +{ + int n=0; + if (z == 0) return -1; + if (z >= 0x10000) { n += 16; z >>= 16; } + if (z >= 0x00100) { n += 8; z >>= 8; } + if (z >= 0x00010) { n += 4; z >>= 4; } + if (z >= 0x00004) { n += 2; z >>= 2; } + if (z >= 0x00002) { n += 1;/* >>= 1;*/ } + return n; +} + +static int stbi__bitcount(unsigned int a) +{ + a = (a & 0x55555555) + ((a >> 1) & 0x55555555); // max 2 + a = (a & 0x33333333) + ((a >> 2) & 0x33333333); // max 4 + a = (a + (a >> 4)) & 0x0f0f0f0f; // max 8 per 4, now 8 bits + a = (a + (a >> 8)); // max 16 per 8 bits + a = (a + (a >> 16)); // max 32 per 8 bits + return a & 0xff; +} + +// extract an arbitrarily-aligned N-bit value (N=bits) +// from v, and then make it 8-bits long and fractionally +// extend it to full full range. +static int stbi__shiftsigned(unsigned int v, int shift, int bits) +{ + static unsigned int mul_table[9] = { + 0, + 0xff/*0b11111111*/, 0x55/*0b01010101*/, 0x49/*0b01001001*/, 0x11/*0b00010001*/, + 0x21/*0b00100001*/, 0x41/*0b01000001*/, 0x81/*0b10000001*/, 0x01/*0b00000001*/, + }; + static unsigned int shift_table[9] = { + 0, 0,0,1,0,2,4,6,0, + }; + if (shift < 0) + v <<= -shift; + else + v >>= shift; + STBI_ASSERT(v < 256); + v >>= (8-bits); + STBI_ASSERT(bits >= 0 && bits <= 8); + return (int) ((unsigned) v * mul_table[bits]) >> shift_table[bits]; +} + +typedef struct +{ + int bpp, offset, hsz; + unsigned int mr,mg,mb,ma, all_a; + int extra_read; +} stbi__bmp_data; + +static int stbi__bmp_set_mask_defaults(stbi__bmp_data *info, int compress) +{ + // BI_BITFIELDS specifies masks explicitly, don't override + if (compress == 3) + return 1; + + if (compress == 0) { + if (info->bpp == 16) { + info->mr = 31u << 10; + info->mg = 31u << 5; + info->mb = 31u << 0; + } else if (info->bpp == 32) { + info->mr = 0xffu << 16; + info->mg = 0xffu << 8; + info->mb = 0xffu << 0; + info->ma = 0xffu << 24; + info->all_a = 0; // if all_a is 0 at end, then we loaded alpha channel but it was all 0 + } else { + // otherwise, use defaults, which is all-0 + info->mr = info->mg = info->mb = info->ma = 0; + } + return 1; + } + return 0; // error +} + +static void *stbi__bmp_parse_header(stbi__context *s, stbi__bmp_data *info) +{ + int hsz; + if (stbi__get8(s) != 'B' || stbi__get8(s) != 'M') return stbi__errpuc("not BMP", "Corrupt BMP"); + stbi__get32le(s); // discard filesize + stbi__get16le(s); // discard reserved + stbi__get16le(s); // discard reserved + info->offset = stbi__get32le(s); + info->hsz = hsz = stbi__get32le(s); + info->mr = info->mg = info->mb = info->ma = 0; + info->extra_read = 14; + + if (info->offset < 0) return stbi__errpuc("bad BMP", "bad BMP"); + + if (hsz != 12 && hsz != 40 && hsz != 56 && hsz != 108 && hsz != 124) return stbi__errpuc("unknown BMP", "BMP type not supported: unknown"); + if (hsz == 12) { + s->img_x = stbi__get16le(s); + s->img_y = stbi__get16le(s); + } else { + s->img_x = stbi__get32le(s); + s->img_y = stbi__get32le(s); + } + if (stbi__get16le(s) != 1) return stbi__errpuc("bad BMP", "bad BMP"); + info->bpp = stbi__get16le(s); + if (hsz != 12) { + int compress = stbi__get32le(s); + if (compress == 1 || compress == 2) return stbi__errpuc("BMP RLE", "BMP type not supported: RLE"); + if (compress >= 4) return stbi__errpuc("BMP JPEG/PNG", "BMP type not supported: unsupported compression"); // this includes PNG/JPEG modes + if (compress == 3 && info->bpp != 16 && info->bpp != 32) return stbi__errpuc("bad BMP", "bad BMP"); // bitfields requires 16 or 32 bits/pixel + stbi__get32le(s); // discard sizeof + stbi__get32le(s); // discard hres + stbi__get32le(s); // discard vres + stbi__get32le(s); // discard colorsused + stbi__get32le(s); // discard max important + if (hsz == 40 || hsz == 56) { + if (hsz == 56) { + stbi__get32le(s); + stbi__get32le(s); + stbi__get32le(s); + stbi__get32le(s); + } + if (info->bpp == 16 || info->bpp == 32) { + if (compress == 0) { + stbi__bmp_set_mask_defaults(info, compress); + } else if (compress == 3) { + info->mr = stbi__get32le(s); + info->mg = stbi__get32le(s); + info->mb = stbi__get32le(s); + info->extra_read += 12; + // not documented, but generated by photoshop and handled by mspaint + if (info->mr == info->mg && info->mg == info->mb) { + // ?!?!? + return stbi__errpuc("bad BMP", "bad BMP"); + } + } else + return stbi__errpuc("bad BMP", "bad BMP"); + } + } else { + // V4/V5 header + int i; + if (hsz != 108 && hsz != 124) + return stbi__errpuc("bad BMP", "bad BMP"); + info->mr = stbi__get32le(s); + info->mg = stbi__get32le(s); + info->mb = stbi__get32le(s); + info->ma = stbi__get32le(s); + if (compress != 3) // override mr/mg/mb unless in BI_BITFIELDS mode, as per docs + stbi__bmp_set_mask_defaults(info, compress); + stbi__get32le(s); // discard color space + for (i=0; i < 12; ++i) + stbi__get32le(s); // discard color space parameters + if (hsz == 124) { + stbi__get32le(s); // discard rendering intent + stbi__get32le(s); // discard offset of profile data + stbi__get32le(s); // discard size of profile data + stbi__get32le(s); // discard reserved + } + } + } + return (void *) 1; +} + + +static void *stbi__bmp_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri) +{ + stbi_uc *out; + unsigned int mr=0,mg=0,mb=0,ma=0, all_a; + stbi_uc pal[256][4]; + int psize=0,i,j,width; + int flip_vertically, pad, target; + stbi__bmp_data info; + STBI_NOTUSED(ri); + + info.all_a = 255; + if (stbi__bmp_parse_header(s, &info) == NULL) + return NULL; // error code already set + + flip_vertically = ((int) s->img_y) > 0; + s->img_y = abs((int) s->img_y); + + if (s->img_y > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large","Very large image (corrupt?)"); + if (s->img_x > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large","Very large image (corrupt?)"); + + mr = info.mr; + mg = info.mg; + mb = info.mb; + ma = info.ma; + all_a = info.all_a; + + if (info.hsz == 12) { + if (info.bpp < 24) + psize = (info.offset - info.extra_read - 24) / 3; + } else { + if (info.bpp < 16) + psize = (info.offset - info.extra_read - info.hsz) >> 2; + } + if (psize == 0) { + // accept some number of extra bytes after the header, but if the offset points either to before + // the header ends or implies a large amount of extra data, reject the file as malformed + int bytes_read_so_far = s->callback_already_read + (int)(s->img_buffer - s->img_buffer_original); + int header_limit = 1024; // max we actually read is below 256 bytes currently. + int extra_data_limit = 256*4; // what ordinarily goes here is a palette; 256 entries*4 bytes is its max size. + if (bytes_read_so_far <= 0 || bytes_read_so_far > header_limit) { + return stbi__errpuc("bad header", "Corrupt BMP"); + } + // we established that bytes_read_so_far is positive and sensible. + // the first half of this test rejects offsets that are either too small positives, or + // negative, and guarantees that info.offset >= bytes_read_so_far > 0. this in turn + // ensures the number computed in the second half of the test can't overflow. + if (info.offset < bytes_read_so_far || info.offset - bytes_read_so_far > extra_data_limit) { + return stbi__errpuc("bad offset", "Corrupt BMP"); + } else { + stbi__skip(s, info.offset - bytes_read_so_far); + } + } + + if (info.bpp == 24 && ma == 0xff000000) + s->img_n = 3; + else + s->img_n = ma ? 4 : 3; + if (req_comp && req_comp >= 3) // we can directly decode 3 or 4 + target = req_comp; + else + target = s->img_n; // if they want monochrome, we'll post-convert + + // sanity-check size + if (!stbi__mad3sizes_valid(target, s->img_x, s->img_y, 0)) + return stbi__errpuc("too large", "Corrupt BMP"); + + out = (stbi_uc *) stbi__malloc_mad3(target, s->img_x, s->img_y, 0); + if (!out) return stbi__errpuc("outofmem", "Out of memory"); + if (info.bpp < 16) { + int z=0; + if (psize == 0 || psize > 256) { STBI_FREE(out); return stbi__errpuc("invalid", "Corrupt BMP"); } + for (i=0; i < psize; ++i) { + pal[i][2] = stbi__get8(s); + pal[i][1] = stbi__get8(s); + pal[i][0] = stbi__get8(s); + if (info.hsz != 12) stbi__get8(s); + pal[i][3] = 255; + } + stbi__skip(s, info.offset - info.extra_read - info.hsz - psize * (info.hsz == 12 ? 3 : 4)); + if (info.bpp == 1) width = (s->img_x + 7) >> 3; + else if (info.bpp == 4) width = (s->img_x + 1) >> 1; + else if (info.bpp == 8) width = s->img_x; + else { STBI_FREE(out); return stbi__errpuc("bad bpp", "Corrupt BMP"); } + pad = (-width)&3; + if (info.bpp == 1) { + for (j=0; j < (int) s->img_y; ++j) { + int bit_offset = 7, v = stbi__get8(s); + for (i=0; i < (int) s->img_x; ++i) { + int color = (v>>bit_offset)&0x1; + out[z++] = pal[color][0]; + out[z++] = pal[color][1]; + out[z++] = pal[color][2]; + if (target == 4) out[z++] = 255; + if (i+1 == (int) s->img_x) break; + if((--bit_offset) < 0) { + bit_offset = 7; + v = stbi__get8(s); + } + } + stbi__skip(s, pad); + } + } else { + for (j=0; j < (int) s->img_y; ++j) { + for (i=0; i < (int) s->img_x; i += 2) { + int v=stbi__get8(s),v2=0; + if (info.bpp == 4) { + v2 = v & 15; + v >>= 4; + } + out[z++] = pal[v][0]; + out[z++] = pal[v][1]; + out[z++] = pal[v][2]; + if (target == 4) out[z++] = 255; + if (i+1 == (int) s->img_x) break; + v = (info.bpp == 8) ? stbi__get8(s) : v2; + out[z++] = pal[v][0]; + out[z++] = pal[v][1]; + out[z++] = pal[v][2]; + if (target == 4) out[z++] = 255; + } + stbi__skip(s, pad); + } + } + } else { + int rshift=0,gshift=0,bshift=0,ashift=0,rcount=0,gcount=0,bcount=0,acount=0; + int z = 0; + int easy=0; + stbi__skip(s, info.offset - info.extra_read - info.hsz); + if (info.bpp == 24) width = 3 * s->img_x; + else if (info.bpp == 16) width = 2*s->img_x; + else /* bpp = 32 and pad = 0 */ width=0; + pad = (-width) & 3; + if (info.bpp == 24) { + easy = 1; + } else if (info.bpp == 32) { + if (mb == 0xff && mg == 0xff00 && mr == 0x00ff0000 && ma == 0xff000000) + easy = 2; + } + if (!easy) { + if (!mr || !mg || !mb) { STBI_FREE(out); return stbi__errpuc("bad masks", "Corrupt BMP"); } + // right shift amt to put high bit in position #7 + rshift = stbi__high_bit(mr)-7; rcount = stbi__bitcount(mr); + gshift = stbi__high_bit(mg)-7; gcount = stbi__bitcount(mg); + bshift = stbi__high_bit(mb)-7; bcount = stbi__bitcount(mb); + ashift = stbi__high_bit(ma)-7; acount = stbi__bitcount(ma); + if (rcount > 8 || gcount > 8 || bcount > 8 || acount > 8) { STBI_FREE(out); return stbi__errpuc("bad masks", "Corrupt BMP"); } + } + for (j=0; j < (int) s->img_y; ++j) { + if (easy) { + for (i=0; i < (int) s->img_x; ++i) { + unsigned char a; + out[z+2] = stbi__get8(s); + out[z+1] = stbi__get8(s); + out[z+0] = stbi__get8(s); + z += 3; + a = (easy == 2 ? stbi__get8(s) : 255); + all_a |= a; + if (target == 4) out[z++] = a; + } + } else { + int bpp = info.bpp; + for (i=0; i < (int) s->img_x; ++i) { + stbi__uint32 v = (bpp == 16 ? (stbi__uint32) stbi__get16le(s) : stbi__get32le(s)); + unsigned int a; + out[z++] = STBI__BYTECAST(stbi__shiftsigned(v & mr, rshift, rcount)); + out[z++] = STBI__BYTECAST(stbi__shiftsigned(v & mg, gshift, gcount)); + out[z++] = STBI__BYTECAST(stbi__shiftsigned(v & mb, bshift, bcount)); + a = (ma ? stbi__shiftsigned(v & ma, ashift, acount) : 255); + all_a |= a; + if (target == 4) out[z++] = STBI__BYTECAST(a); + } + } + stbi__skip(s, pad); + } + } + + // if alpha channel is all 0s, replace with all 255s + if (target == 4 && all_a == 0) + for (i=4*s->img_x*s->img_y-1; i >= 0; i -= 4) + out[i] = 255; + + if (flip_vertically) { + stbi_uc t; + for (j=0; j < (int) s->img_y>>1; ++j) { + stbi_uc *p1 = out + j *s->img_x*target; + stbi_uc *p2 = out + (s->img_y-1-j)*s->img_x*target; + for (i=0; i < (int) s->img_x*target; ++i) { + t = p1[i]; p1[i] = p2[i]; p2[i] = t; + } + } + } + + if (req_comp && req_comp != target) { + out = stbi__convert_format(out, target, req_comp, s->img_x, s->img_y); + if (out == NULL) return out; // stbi__convert_format frees input on failure + } + + *x = s->img_x; + *y = s->img_y; + if (comp) *comp = s->img_n; + return out; +} +#endif + +// Targa Truevision - TGA +// by Jonathan Dummer +#ifndef STBI_NO_TGA +// returns STBI_rgb or whatever, 0 on error +static int stbi__tga_get_comp(int bits_per_pixel, int is_grey, int* is_rgb16) +{ + // only RGB or RGBA (incl. 16bit) or grey allowed + if (is_rgb16) *is_rgb16 = 0; + switch(bits_per_pixel) { + case 8: return STBI_grey; + case 16: if(is_grey) return STBI_grey_alpha; + // fallthrough + case 15: if(is_rgb16) *is_rgb16 = 1; + return STBI_rgb; + case 24: // fallthrough + case 32: return bits_per_pixel/8; + default: return 0; + } +} + +static int stbi__tga_info(stbi__context *s, int *x, int *y, int *comp) +{ + int tga_w, tga_h, tga_comp, tga_image_type, tga_bits_per_pixel, tga_colormap_bpp; + int sz, tga_colormap_type; + stbi__get8(s); // discard Offset + tga_colormap_type = stbi__get8(s); // colormap type + if( tga_colormap_type > 1 ) { + stbi__rewind(s); + return 0; // only RGB or indexed allowed + } + tga_image_type = stbi__get8(s); // image type + if ( tga_colormap_type == 1 ) { // colormapped (paletted) image + if (tga_image_type != 1 && tga_image_type != 9) { + stbi__rewind(s); + return 0; + } + stbi__skip(s,4); // skip index of first colormap entry and number of entries + sz = stbi__get8(s); // check bits per palette color entry + if ( (sz != 8) && (sz != 15) && (sz != 16) && (sz != 24) && (sz != 32) ) { + stbi__rewind(s); + return 0; + } + stbi__skip(s,4); // skip image x and y origin + tga_colormap_bpp = sz; + } else { // "normal" image w/o colormap - only RGB or grey allowed, +/- RLE + if ( (tga_image_type != 2) && (tga_image_type != 3) && (tga_image_type != 10) && (tga_image_type != 11) ) { + stbi__rewind(s); + return 0; // only RGB or grey allowed, +/- RLE + } + stbi__skip(s,9); // skip colormap specification and image x/y origin + tga_colormap_bpp = 0; + } + tga_w = stbi__get16le(s); + if( tga_w < 1 ) { + stbi__rewind(s); + return 0; // test width + } + tga_h = stbi__get16le(s); + if( tga_h < 1 ) { + stbi__rewind(s); + return 0; // test height + } + tga_bits_per_pixel = stbi__get8(s); // bits per pixel + stbi__get8(s); // ignore alpha bits + if (tga_colormap_bpp != 0) { + if((tga_bits_per_pixel != 8) && (tga_bits_per_pixel != 16)) { + // when using a colormap, tga_bits_per_pixel is the size of the indexes + // I don't think anything but 8 or 16bit indexes makes sense + stbi__rewind(s); + return 0; + } + tga_comp = stbi__tga_get_comp(tga_colormap_bpp, 0, NULL); + } else { + tga_comp = stbi__tga_get_comp(tga_bits_per_pixel, (tga_image_type == 3) || (tga_image_type == 11), NULL); + } + if(!tga_comp) { + stbi__rewind(s); + return 0; + } + if (x) *x = tga_w; + if (y) *y = tga_h; + if (comp) *comp = tga_comp; + return 1; // seems to have passed everything +} + +static int stbi__tga_test(stbi__context *s) +{ + int res = 0; + int sz, tga_color_type; + stbi__get8(s); // discard Offset + tga_color_type = stbi__get8(s); // color type + if ( tga_color_type > 1 ) goto errorEnd; // only RGB or indexed allowed + sz = stbi__get8(s); // image type + if ( tga_color_type == 1 ) { // colormapped (paletted) image + if (sz != 1 && sz != 9) goto errorEnd; // colortype 1 demands image type 1 or 9 + stbi__skip(s,4); // skip index of first colormap entry and number of entries + sz = stbi__get8(s); // check bits per palette color entry + if ( (sz != 8) && (sz != 15) && (sz != 16) && (sz != 24) && (sz != 32) ) goto errorEnd; + stbi__skip(s,4); // skip image x and y origin + } else { // "normal" image w/o colormap + if ( (sz != 2) && (sz != 3) && (sz != 10) && (sz != 11) ) goto errorEnd; // only RGB or grey allowed, +/- RLE + stbi__skip(s,9); // skip colormap specification and image x/y origin + } + if ( stbi__get16le(s) < 1 ) goto errorEnd; // test width + if ( stbi__get16le(s) < 1 ) goto errorEnd; // test height + sz = stbi__get8(s); // bits per pixel + if ( (tga_color_type == 1) && (sz != 8) && (sz != 16) ) goto errorEnd; // for colormapped images, bpp is size of an index + if ( (sz != 8) && (sz != 15) && (sz != 16) && (sz != 24) && (sz != 32) ) goto errorEnd; + + res = 1; // if we got this far, everything's good and we can return 1 instead of 0 + +errorEnd: + stbi__rewind(s); + return res; +} + +// read 16bit value and convert to 24bit RGB +static void stbi__tga_read_rgb16(stbi__context *s, stbi_uc* out) +{ + stbi__uint16 px = (stbi__uint16)stbi__get16le(s); + stbi__uint16 fiveBitMask = 31; + // we have 3 channels with 5bits each + int r = (px >> 10) & fiveBitMask; + int g = (px >> 5) & fiveBitMask; + int b = px & fiveBitMask; + // Note that this saves the data in RGB(A) order, so it doesn't need to be swapped later + out[0] = (stbi_uc)((r * 255)/31); + out[1] = (stbi_uc)((g * 255)/31); + out[2] = (stbi_uc)((b * 255)/31); + + // some people claim that the most significant bit might be used for alpha + // (possibly if an alpha-bit is set in the "image descriptor byte") + // but that only made 16bit test images completely translucent.. + // so let's treat all 15 and 16bit TGAs as RGB with no alpha. +} + +static void *stbi__tga_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri) +{ + // read in the TGA header stuff + int tga_offset = stbi__get8(s); + int tga_indexed = stbi__get8(s); + int tga_image_type = stbi__get8(s); + int tga_is_RLE = 0; + int tga_palette_start = stbi__get16le(s); + int tga_palette_len = stbi__get16le(s); + int tga_palette_bits = stbi__get8(s); + int tga_x_origin = stbi__get16le(s); + int tga_y_origin = stbi__get16le(s); + int tga_width = stbi__get16le(s); + int tga_height = stbi__get16le(s); + int tga_bits_per_pixel = stbi__get8(s); + int tga_comp, tga_rgb16=0; + int tga_inverted = stbi__get8(s); + // int tga_alpha_bits = tga_inverted & 15; // the 4 lowest bits - unused (useless?) + // image data + unsigned char *tga_data; + unsigned char *tga_palette = NULL; + int i, j; + unsigned char raw_data[4] = {0}; + int RLE_count = 0; + int RLE_repeating = 0; + int read_next_pixel = 1; + STBI_NOTUSED(ri); + STBI_NOTUSED(tga_x_origin); // @TODO + STBI_NOTUSED(tga_y_origin); // @TODO + + if (tga_height > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large","Very large image (corrupt?)"); + if (tga_width > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large","Very large image (corrupt?)"); + + // do a tiny bit of precessing + if ( tga_image_type >= 8 ) + { + tga_image_type -= 8; + tga_is_RLE = 1; + } + tga_inverted = 1 - ((tga_inverted >> 5) & 1); + + // If I'm paletted, then I'll use the number of bits from the palette + if ( tga_indexed ) tga_comp = stbi__tga_get_comp(tga_palette_bits, 0, &tga_rgb16); + else tga_comp = stbi__tga_get_comp(tga_bits_per_pixel, (tga_image_type == 3), &tga_rgb16); + + if(!tga_comp) // shouldn't really happen, stbi__tga_test() should have ensured basic consistency + return stbi__errpuc("bad format", "Can't find out TGA pixelformat"); + + // tga info + *x = tga_width; + *y = tga_height; + if (comp) *comp = tga_comp; + + if (!stbi__mad3sizes_valid(tga_width, tga_height, tga_comp, 0)) + return stbi__errpuc("too large", "Corrupt TGA"); + + tga_data = (unsigned char*)stbi__malloc_mad3(tga_width, tga_height, tga_comp, 0); + if (!tga_data) return stbi__errpuc("outofmem", "Out of memory"); + + // skip to the data's starting position (offset usually = 0) + stbi__skip(s, tga_offset ); + + if ( !tga_indexed && !tga_is_RLE && !tga_rgb16 ) { + for (i=0; i < tga_height; ++i) { + int row = tga_inverted ? tga_height -i - 1 : i; + stbi_uc *tga_row = tga_data + row*tga_width*tga_comp; + stbi__getn(s, tga_row, tga_width * tga_comp); + } + } else { + // do I need to load a palette? + if ( tga_indexed) + { + if (tga_palette_len == 0) { /* you have to have at least one entry! */ + STBI_FREE(tga_data); + return stbi__errpuc("bad palette", "Corrupt TGA"); + } + + // any data to skip? (offset usually = 0) + stbi__skip(s, tga_palette_start ); + // load the palette + tga_palette = (unsigned char*)stbi__malloc_mad2(tga_palette_len, tga_comp, 0); + if (!tga_palette) { + STBI_FREE(tga_data); + return stbi__errpuc("outofmem", "Out of memory"); + } + if (tga_rgb16) { + stbi_uc *pal_entry = tga_palette; + STBI_ASSERT(tga_comp == STBI_rgb); + for (i=0; i < tga_palette_len; ++i) { + stbi__tga_read_rgb16(s, pal_entry); + pal_entry += tga_comp; + } + } else if (!stbi__getn(s, tga_palette, tga_palette_len * tga_comp)) { + STBI_FREE(tga_data); + STBI_FREE(tga_palette); + return stbi__errpuc("bad palette", "Corrupt TGA"); + } + } + // load the data + for (i=0; i < tga_width * tga_height; ++i) + { + // if I'm in RLE mode, do I need to get a RLE stbi__pngchunk? + if ( tga_is_RLE ) + { + if ( RLE_count == 0 ) + { + // yep, get the next byte as a RLE command + int RLE_cmd = stbi__get8(s); + RLE_count = 1 + (RLE_cmd & 127); + RLE_repeating = RLE_cmd >> 7; + read_next_pixel = 1; + } else if ( !RLE_repeating ) + { + read_next_pixel = 1; + } + } else + { + read_next_pixel = 1; + } + // OK, if I need to read a pixel, do it now + if ( read_next_pixel ) + { + // load however much data we did have + if ( tga_indexed ) + { + // read in index, then perform the lookup + int pal_idx = (tga_bits_per_pixel == 8) ? stbi__get8(s) : stbi__get16le(s); + if ( pal_idx >= tga_palette_len ) { + // invalid index + pal_idx = 0; + } + pal_idx *= tga_comp; + for (j = 0; j < tga_comp; ++j) { + raw_data[j] = tga_palette[pal_idx+j]; + } + } else if(tga_rgb16) { + STBI_ASSERT(tga_comp == STBI_rgb); + stbi__tga_read_rgb16(s, raw_data); + } else { + // read in the data raw + for (j = 0; j < tga_comp; ++j) { + raw_data[j] = stbi__get8(s); + } + } + // clear the reading flag for the next pixel + read_next_pixel = 0; + } // end of reading a pixel + + // copy data + for (j = 0; j < tga_comp; ++j) + tga_data[i*tga_comp+j] = raw_data[j]; + + // in case we're in RLE mode, keep counting down + --RLE_count; + } + // do I need to invert the image? + if ( tga_inverted ) + { + for (j = 0; j*2 < tga_height; ++j) + { + int index1 = j * tga_width * tga_comp; + int index2 = (tga_height - 1 - j) * tga_width * tga_comp; + for (i = tga_width * tga_comp; i > 0; --i) + { + unsigned char temp = tga_data[index1]; + tga_data[index1] = tga_data[index2]; + tga_data[index2] = temp; + ++index1; + ++index2; + } + } + } + // clear my palette, if I had one + if ( tga_palette != NULL ) + { + STBI_FREE( tga_palette ); + } + } + + // swap RGB - if the source data was RGB16, it already is in the right order + if (tga_comp >= 3 && !tga_rgb16) + { + unsigned char* tga_pixel = tga_data; + for (i=0; i < tga_width * tga_height; ++i) + { + unsigned char temp = tga_pixel[0]; + tga_pixel[0] = tga_pixel[2]; + tga_pixel[2] = temp; + tga_pixel += tga_comp; + } + } + + // convert to target component count + if (req_comp && req_comp != tga_comp) + tga_data = stbi__convert_format(tga_data, tga_comp, req_comp, tga_width, tga_height); + + // the things I do to get rid of an error message, and yet keep + // Microsoft's C compilers happy... [8^( + tga_palette_start = tga_palette_len = tga_palette_bits = + tga_x_origin = tga_y_origin = 0; + STBI_NOTUSED(tga_palette_start); + // OK, done + return tga_data; +} +#endif + +// ************************************************************************************************* +// Photoshop PSD loader -- PD by Thatcher Ulrich, integration by Nicolas Schulz, tweaked by STB + +#ifndef STBI_NO_PSD +static int stbi__psd_test(stbi__context *s) +{ + int r = (stbi__get32be(s) == 0x38425053); + stbi__rewind(s); + return r; +} + +static int stbi__psd_decode_rle(stbi__context *s, stbi_uc *p, int pixelCount) +{ + int count, nleft, len; + + count = 0; + while ((nleft = pixelCount - count) > 0) { + len = stbi__get8(s); + if (len == 128) { + // No-op. + } else if (len < 128) { + // Copy next len+1 bytes literally. + len++; + if (len > nleft) return 0; // corrupt data + count += len; + while (len) { + *p = stbi__get8(s); + p += 4; + len--; + } + } else if (len > 128) { + stbi_uc val; + // Next -len+1 bytes in the dest are replicated from next source byte. + // (Interpret len as a negative 8-bit int.) + len = 257 - len; + if (len > nleft) return 0; // corrupt data + val = stbi__get8(s); + count += len; + while (len) { + *p = val; + p += 4; + len--; + } + } + } + + return 1; +} + +static void *stbi__psd_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri, int bpc) +{ + int pixelCount; + int channelCount, compression; + int channel, i; + int bitdepth; + int w,h; + stbi_uc *out; + STBI_NOTUSED(ri); + + // Check identifier + if (stbi__get32be(s) != 0x38425053) // "8BPS" + return stbi__errpuc("not PSD", "Corrupt PSD image"); + + // Check file type version. + if (stbi__get16be(s) != 1) + return stbi__errpuc("wrong version", "Unsupported version of PSD image"); + + // Skip 6 reserved bytes. + stbi__skip(s, 6 ); + + // Read the number of channels (R, G, B, A, etc). + channelCount = stbi__get16be(s); + if (channelCount < 0 || channelCount > 16) + return stbi__errpuc("wrong channel count", "Unsupported number of channels in PSD image"); + + // Read the rows and columns of the image. + h = stbi__get32be(s); + w = stbi__get32be(s); + + if (h > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large","Very large image (corrupt?)"); + if (w > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large","Very large image (corrupt?)"); + + // Make sure the depth is 8 bits. + bitdepth = stbi__get16be(s); + if (bitdepth != 8 && bitdepth != 16) + return stbi__errpuc("unsupported bit depth", "PSD bit depth is not 8 or 16 bit"); + + // Make sure the color mode is RGB. + // Valid options are: + // 0: Bitmap + // 1: Grayscale + // 2: Indexed color + // 3: RGB color + // 4: CMYK color + // 7: Multichannel + // 8: Duotone + // 9: Lab color + if (stbi__get16be(s) != 3) + return stbi__errpuc("wrong color format", "PSD is not in RGB color format"); + + // Skip the Mode Data. (It's the palette for indexed color; other info for other modes.) + stbi__skip(s,stbi__get32be(s) ); + + // Skip the image resources. (resolution, pen tool paths, etc) + stbi__skip(s, stbi__get32be(s) ); + + // Skip the reserved data. + stbi__skip(s, stbi__get32be(s) ); + + // Find out if the data is compressed. + // Known values: + // 0: no compression + // 1: RLE compressed + compression = stbi__get16be(s); + if (compression > 1) + return stbi__errpuc("bad compression", "PSD has an unknown compression format"); + + // Check size + if (!stbi__mad3sizes_valid(4, w, h, 0)) + return stbi__errpuc("too large", "Corrupt PSD"); + + // Create the destination image. + + if (!compression && bitdepth == 16 && bpc == 16) { + out = (stbi_uc *) stbi__malloc_mad3(8, w, h, 0); + ri->bits_per_channel = 16; + } else + out = (stbi_uc *) stbi__malloc(4 * w*h); + + if (!out) return stbi__errpuc("outofmem", "Out of memory"); + pixelCount = w*h; + + // Initialize the data to zero. + //memset( out, 0, pixelCount * 4 ); + + // Finally, the image data. + if (compression) { + // RLE as used by .PSD and .TIFF + // Loop until you get the number of unpacked bytes you are expecting: + // Read the next source byte into n. + // If n is between 0 and 127 inclusive, copy the next n+1 bytes literally. + // Else if n is between -127 and -1 inclusive, copy the next byte -n+1 times. + // Else if n is 128, noop. + // Endloop + + // The RLE-compressed data is preceded by a 2-byte data count for each row in the data, + // which we're going to just skip. + stbi__skip(s, h * channelCount * 2 ); + + // Read the RLE data by channel. + for (channel = 0; channel < 4; channel++) { + stbi_uc *p; + + p = out+channel; + if (channel >= channelCount) { + // Fill this channel with default data. + for (i = 0; i < pixelCount; i++, p += 4) + *p = (channel == 3 ? 255 : 0); + } else { + // Read the RLE data. + if (!stbi__psd_decode_rle(s, p, pixelCount)) { + STBI_FREE(out); + return stbi__errpuc("corrupt", "bad RLE data"); + } + } + } + + } else { + // We're at the raw image data. It's each channel in order (Red, Green, Blue, Alpha, ...) + // where each channel consists of an 8-bit (or 16-bit) value for each pixel in the image. + + // Read the data by channel. + for (channel = 0; channel < 4; channel++) { + if (channel >= channelCount) { + // Fill this channel with default data. + if (bitdepth == 16 && bpc == 16) { + stbi__uint16 *q = ((stbi__uint16 *) out) + channel; + stbi__uint16 val = channel == 3 ? 65535 : 0; + for (i = 0; i < pixelCount; i++, q += 4) + *q = val; + } else { + stbi_uc *p = out+channel; + stbi_uc val = channel == 3 ? 255 : 0; + for (i = 0; i < pixelCount; i++, p += 4) + *p = val; + } + } else { + if (ri->bits_per_channel == 16) { // output bpc + stbi__uint16 *q = ((stbi__uint16 *) out) + channel; + for (i = 0; i < pixelCount; i++, q += 4) + *q = (stbi__uint16) stbi__get16be(s); + } else { + stbi_uc *p = out+channel; + if (bitdepth == 16) { // input bpc + for (i = 0; i < pixelCount; i++, p += 4) + *p = (stbi_uc) (stbi__get16be(s) >> 8); + } else { + for (i = 0; i < pixelCount; i++, p += 4) + *p = stbi__get8(s); + } + } + } + } + } + + // remove weird white matte from PSD + if (channelCount >= 4) { + if (ri->bits_per_channel == 16) { + for (i=0; i < w*h; ++i) { + stbi__uint16 *pixel = (stbi__uint16 *) out + 4*i; + if (pixel[3] != 0 && pixel[3] != 65535) { + float a = pixel[3] / 65535.0f; + float ra = 1.0f / a; + float inv_a = 65535.0f * (1 - ra); + pixel[0] = (stbi__uint16) (pixel[0]*ra + inv_a); + pixel[1] = (stbi__uint16) (pixel[1]*ra + inv_a); + pixel[2] = (stbi__uint16) (pixel[2]*ra + inv_a); + } + } + } else { + for (i=0; i < w*h; ++i) { + unsigned char *pixel = out + 4*i; + if (pixel[3] != 0 && pixel[3] != 255) { + float a = pixel[3] / 255.0f; + float ra = 1.0f / a; + float inv_a = 255.0f * (1 - ra); + pixel[0] = (unsigned char) (pixel[0]*ra + inv_a); + pixel[1] = (unsigned char) (pixel[1]*ra + inv_a); + pixel[2] = (unsigned char) (pixel[2]*ra + inv_a); + } + } + } + } + + // convert to desired output format + if (req_comp && req_comp != 4) { + if (ri->bits_per_channel == 16) + out = (stbi_uc *) stbi__convert_format16((stbi__uint16 *) out, 4, req_comp, w, h); + else + out = stbi__convert_format(out, 4, req_comp, w, h); + if (out == NULL) return out; // stbi__convert_format frees input on failure + } + + if (comp) *comp = 4; + *y = h; + *x = w; + + return out; +} +#endif + +// ************************************************************************************************* +// Softimage PIC loader +// by Tom Seddon +// +// See http://softimage.wiki.softimage.com/index.php/INFO:_PIC_file_format +// See http://ozviz.wasp.uwa.edu.au/~pbourke/dataformats/softimagepic/ + +#ifndef STBI_NO_PIC +static int stbi__pic_is4(stbi__context *s,const char *str) +{ + int i; + for (i=0; i<4; ++i) + if (stbi__get8(s) != (stbi_uc)str[i]) + return 0; + + return 1; +} + +static int stbi__pic_test_core(stbi__context *s) +{ + int i; + + if (!stbi__pic_is4(s,"\x53\x80\xF6\x34")) + return 0; + + for(i=0;i<84;++i) + stbi__get8(s); + + if (!stbi__pic_is4(s,"PICT")) + return 0; + + return 1; +} + +typedef struct +{ + stbi_uc size,type,channel; +} stbi__pic_packet; + +static stbi_uc *stbi__readval(stbi__context *s, int channel, stbi_uc *dest) +{ + int mask=0x80, i; + + for (i=0; i<4; ++i, mask>>=1) { + if (channel & mask) { + if (stbi__at_eof(s)) return stbi__errpuc("bad file","PIC file too short"); + dest[i]=stbi__get8(s); + } + } + + return dest; +} + +static void stbi__copyval(int channel,stbi_uc *dest,const stbi_uc *src) +{ + int mask=0x80,i; + + for (i=0;i<4; ++i, mask>>=1) + if (channel&mask) + dest[i]=src[i]; +} + +static stbi_uc *stbi__pic_load_core(stbi__context *s,int width,int height,int *comp, stbi_uc *result) +{ + int act_comp=0,num_packets=0,y,chained; + stbi__pic_packet packets[10]; + + // this will (should...) cater for even some bizarre stuff like having data + // for the same channel in multiple packets. + do { + stbi__pic_packet *packet; + + if (num_packets==sizeof(packets)/sizeof(packets[0])) + return stbi__errpuc("bad format","too many packets"); + + packet = &packets[num_packets++]; + + chained = stbi__get8(s); + packet->size = stbi__get8(s); + packet->type = stbi__get8(s); + packet->channel = stbi__get8(s); + + act_comp |= packet->channel; + + if (stbi__at_eof(s)) return stbi__errpuc("bad file","file too short (reading packets)"); + if (packet->size != 8) return stbi__errpuc("bad format","packet isn't 8bpp"); + } while (chained); + + *comp = (act_comp & 0x10 ? 4 : 3); // has alpha channel? + + for(y=0; ytype) { + default: + return stbi__errpuc("bad format","packet has bad compression type"); + + case 0: {//uncompressed + int x; + + for(x=0;xchannel,dest)) + return 0; + break; + } + + case 1://Pure RLE + { + int left=width, i; + + while (left>0) { + stbi_uc count,value[4]; + + count=stbi__get8(s); + if (stbi__at_eof(s)) return stbi__errpuc("bad file","file too short (pure read count)"); + + if (count > left) + count = (stbi_uc) left; + + if (!stbi__readval(s,packet->channel,value)) return 0; + + for(i=0; ichannel,dest,value); + left -= count; + } + } + break; + + case 2: {//Mixed RLE + int left=width; + while (left>0) { + int count = stbi__get8(s), i; + if (stbi__at_eof(s)) return stbi__errpuc("bad file","file too short (mixed read count)"); + + if (count >= 128) { // Repeated + stbi_uc value[4]; + + if (count==128) + count = stbi__get16be(s); + else + count -= 127; + if (count > left) + return stbi__errpuc("bad file","scanline overrun"); + + if (!stbi__readval(s,packet->channel,value)) + return 0; + + for(i=0;ichannel,dest,value); + } else { // Raw + ++count; + if (count>left) return stbi__errpuc("bad file","scanline overrun"); + + for(i=0;ichannel,dest)) + return 0; + } + left-=count; + } + break; + } + } + } + } + + return result; +} + +static void *stbi__pic_load(stbi__context *s,int *px,int *py,int *comp,int req_comp, stbi__result_info *ri) +{ + stbi_uc *result; + int i, x,y, internal_comp; + STBI_NOTUSED(ri); + + if (!comp) comp = &internal_comp; + + for (i=0; i<92; ++i) + stbi__get8(s); + + x = stbi__get16be(s); + y = stbi__get16be(s); + + if (y > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large","Very large image (corrupt?)"); + if (x > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large","Very large image (corrupt?)"); + + if (stbi__at_eof(s)) return stbi__errpuc("bad file","file too short (pic header)"); + if (!stbi__mad3sizes_valid(x, y, 4, 0)) return stbi__errpuc("too large", "PIC image too large to decode"); + + stbi__get32be(s); //skip `ratio' + stbi__get16be(s); //skip `fields' + stbi__get16be(s); //skip `pad' + + // intermediate buffer is RGBA + result = (stbi_uc *) stbi__malloc_mad3(x, y, 4, 0); + if (!result) return stbi__errpuc("outofmem", "Out of memory"); + memset(result, 0xff, x*y*4); + + if (!stbi__pic_load_core(s,x,y,comp, result)) { + STBI_FREE(result); + result=0; + } + *px = x; + *py = y; + if (req_comp == 0) req_comp = *comp; + result=stbi__convert_format(result,4,req_comp,x,y); + + return result; +} + +static int stbi__pic_test(stbi__context *s) +{ + int r = stbi__pic_test_core(s); + stbi__rewind(s); + return r; +} +#endif + +// ************************************************************************************************* +// GIF loader -- public domain by Jean-Marc Lienher -- simplified/shrunk by stb + +#ifndef STBI_NO_GIF +typedef struct +{ + stbi__int16 prefix; + stbi_uc first; + stbi_uc suffix; +} stbi__gif_lzw; + +typedef struct +{ + int w,h; + stbi_uc *out; // output buffer (always 4 components) + stbi_uc *background; // The current "background" as far as a gif is concerned + stbi_uc *history; + int flags, bgindex, ratio, transparent, eflags; + stbi_uc pal[256][4]; + stbi_uc lpal[256][4]; + stbi__gif_lzw codes[8192]; + stbi_uc *color_table; + int parse, step; + int lflags; + int start_x, start_y; + int max_x, max_y; + int cur_x, cur_y; + int line_size; + int delay; +} stbi__gif; + +static int stbi__gif_test_raw(stbi__context *s) +{ + int sz; + if (stbi__get8(s) != 'G' || stbi__get8(s) != 'I' || stbi__get8(s) != 'F' || stbi__get8(s) != '8') return 0; + sz = stbi__get8(s); + if (sz != '9' && sz != '7') return 0; + if (stbi__get8(s) != 'a') return 0; + return 1; +} + +static int stbi__gif_test(stbi__context *s) +{ + int r = stbi__gif_test_raw(s); + stbi__rewind(s); + return r; +} + +static void stbi__gif_parse_colortable(stbi__context *s, stbi_uc pal[256][4], int num_entries, int transp) +{ + int i; + for (i=0; i < num_entries; ++i) { + pal[i][2] = stbi__get8(s); + pal[i][1] = stbi__get8(s); + pal[i][0] = stbi__get8(s); + pal[i][3] = transp == i ? 0 : 255; + } +} + +static int stbi__gif_header(stbi__context *s, stbi__gif *g, int *comp, int is_info) +{ + stbi_uc version; + if (stbi__get8(s) != 'G' || stbi__get8(s) != 'I' || stbi__get8(s) != 'F' || stbi__get8(s) != '8') + return stbi__err("not GIF", "Corrupt GIF"); + + version = stbi__get8(s); + if (version != '7' && version != '9') return stbi__err("not GIF", "Corrupt GIF"); + if (stbi__get8(s) != 'a') return stbi__err("not GIF", "Corrupt GIF"); + + stbi__g_failure_reason = ""; + g->w = stbi__get16le(s); + g->h = stbi__get16le(s); + g->flags = stbi__get8(s); + g->bgindex = stbi__get8(s); + g->ratio = stbi__get8(s); + g->transparent = -1; + + if (g->w > STBI_MAX_DIMENSIONS) return stbi__err("too large","Very large image (corrupt?)"); + if (g->h > STBI_MAX_DIMENSIONS) return stbi__err("too large","Very large image (corrupt?)"); + + if (comp != 0) *comp = 4; // can't actually tell whether it's 3 or 4 until we parse the comments + + if (is_info) return 1; + + if (g->flags & 0x80) + stbi__gif_parse_colortable(s,g->pal, 2 << (g->flags & 7), -1); + + return 1; +} + +static int stbi__gif_info_raw(stbi__context *s, int *x, int *y, int *comp) +{ + stbi__gif* g = (stbi__gif*) stbi__malloc(sizeof(stbi__gif)); + if (!g) return stbi__err("outofmem", "Out of memory"); + if (!stbi__gif_header(s, g, comp, 1)) { + STBI_FREE(g); + stbi__rewind( s ); + return 0; + } + if (x) *x = g->w; + if (y) *y = g->h; + STBI_FREE(g); + return 1; +} + +static void stbi__out_gif_code(stbi__gif *g, stbi__uint16 code) +{ + stbi_uc *p, *c; + int idx; + + // recurse to decode the prefixes, since the linked-list is backwards, + // and working backwards through an interleaved image would be nasty + if (g->codes[code].prefix >= 0) + stbi__out_gif_code(g, g->codes[code].prefix); + + if (g->cur_y >= g->max_y) return; + + idx = g->cur_x + g->cur_y; + p = &g->out[idx]; + g->history[idx / 4] = 1; + + c = &g->color_table[g->codes[code].suffix * 4]; + if (c[3] > 128) { // don't render transparent pixels; + p[0] = c[2]; + p[1] = c[1]; + p[2] = c[0]; + p[3] = c[3]; + } + g->cur_x += 4; + + if (g->cur_x >= g->max_x) { + g->cur_x = g->start_x; + g->cur_y += g->step; + + while (g->cur_y >= g->max_y && g->parse > 0) { + g->step = (1 << g->parse) * g->line_size; + g->cur_y = g->start_y + (g->step >> 1); + --g->parse; + } + } +} + +static stbi_uc *stbi__process_gif_raster(stbi__context *s, stbi__gif *g) +{ + stbi_uc lzw_cs; + stbi__int32 len, init_code; + stbi__uint32 first; + stbi__int32 codesize, codemask, avail, oldcode, bits, valid_bits, clear; + stbi__gif_lzw *p; + + lzw_cs = stbi__get8(s); + if (lzw_cs > 12) return NULL; + clear = 1 << lzw_cs; + first = 1; + codesize = lzw_cs + 1; + codemask = (1 << codesize) - 1; + bits = 0; + valid_bits = 0; + for (init_code = 0; init_code < clear; init_code++) { + g->codes[init_code].prefix = -1; + g->codes[init_code].first = (stbi_uc) init_code; + g->codes[init_code].suffix = (stbi_uc) init_code; + } + + // support no starting clear code + avail = clear+2; + oldcode = -1; + + len = 0; + for(;;) { + if (valid_bits < codesize) { + if (len == 0) { + len = stbi__get8(s); // start new block + if (len == 0) + return g->out; + } + --len; + bits |= (stbi__int32) stbi__get8(s) << valid_bits; + valid_bits += 8; + } else { + stbi__int32 code = bits & codemask; + bits >>= codesize; + valid_bits -= codesize; + // @OPTIMIZE: is there some way we can accelerate the non-clear path? + if (code == clear) { // clear code + codesize = lzw_cs + 1; + codemask = (1 << codesize) - 1; + avail = clear + 2; + oldcode = -1; + first = 0; + } else if (code == clear + 1) { // end of stream code + stbi__skip(s, len); + while ((len = stbi__get8(s)) > 0) + stbi__skip(s,len); + return g->out; + } else if (code <= avail) { + if (first) { + return stbi__errpuc("no clear code", "Corrupt GIF"); + } + + if (oldcode >= 0) { + p = &g->codes[avail++]; + if (avail > 8192) { + return stbi__errpuc("too many codes", "Corrupt GIF"); + } + + p->prefix = (stbi__int16) oldcode; + p->first = g->codes[oldcode].first; + p->suffix = (code == avail) ? p->first : g->codes[code].first; + } else if (code == avail) + return stbi__errpuc("illegal code in raster", "Corrupt GIF"); + + stbi__out_gif_code(g, (stbi__uint16) code); + + if ((avail & codemask) == 0 && avail <= 0x0FFF) { + codesize++; + codemask = (1 << codesize) - 1; + } + + oldcode = code; + } else { + return stbi__errpuc("illegal code in raster", "Corrupt GIF"); + } + } + } +} + +// this function is designed to support animated gifs, although stb_image doesn't support it +// two back is the image from two frames ago, used for a very specific disposal format +static stbi_uc *stbi__gif_load_next(stbi__context *s, stbi__gif *g, int *comp, int req_comp, stbi_uc *two_back) +{ + int dispose; + int first_frame; + int pi; + int pcount; + STBI_NOTUSED(req_comp); + + // on first frame, any non-written pixels get the background colour (non-transparent) + first_frame = 0; + if (g->out == 0) { + if (!stbi__gif_header(s, g, comp,0)) return 0; // stbi__g_failure_reason set by stbi__gif_header + if (!stbi__mad3sizes_valid(4, g->w, g->h, 0)) + return stbi__errpuc("too large", "GIF image is too large"); + pcount = g->w * g->h; + g->out = (stbi_uc *) stbi__malloc(4 * pcount); + g->background = (stbi_uc *) stbi__malloc(4 * pcount); + g->history = (stbi_uc *) stbi__malloc(pcount); + if (!g->out || !g->background || !g->history) + return stbi__errpuc("outofmem", "Out of memory"); + + // image is treated as "transparent" at the start - ie, nothing overwrites the current background; + // background colour is only used for pixels that are not rendered first frame, after that "background" + // color refers to the color that was there the previous frame. + memset(g->out, 0x00, 4 * pcount); + memset(g->background, 0x00, 4 * pcount); // state of the background (starts transparent) + memset(g->history, 0x00, pcount); // pixels that were affected previous frame + first_frame = 1; + } else { + // second frame - how do we dispose of the previous one? + dispose = (g->eflags & 0x1C) >> 2; + pcount = g->w * g->h; + + if ((dispose == 3) && (two_back == 0)) { + dispose = 2; // if I don't have an image to revert back to, default to the old background + } + + if (dispose == 3) { // use previous graphic + for (pi = 0; pi < pcount; ++pi) { + if (g->history[pi]) { + memcpy( &g->out[pi * 4], &two_back[pi * 4], 4 ); + } + } + } else if (dispose == 2) { + // restore what was changed last frame to background before that frame; + for (pi = 0; pi < pcount; ++pi) { + if (g->history[pi]) { + memcpy( &g->out[pi * 4], &g->background[pi * 4], 4 ); + } + } + } else { + // This is a non-disposal case eithe way, so just + // leave the pixels as is, and they will become the new background + // 1: do not dispose + // 0: not specified. + } + + // background is what out is after the undoing of the previou frame; + memcpy( g->background, g->out, 4 * g->w * g->h ); + } + + // clear my history; + memset( g->history, 0x00, g->w * g->h ); // pixels that were affected previous frame + + for (;;) { + int tag = stbi__get8(s); + switch (tag) { + case 0x2C: /* Image Descriptor */ + { + stbi__int32 x, y, w, h; + stbi_uc *o; + + x = stbi__get16le(s); + y = stbi__get16le(s); + w = stbi__get16le(s); + h = stbi__get16le(s); + if (((x + w) > (g->w)) || ((y + h) > (g->h))) + return stbi__errpuc("bad Image Descriptor", "Corrupt GIF"); + + g->line_size = g->w * 4; + g->start_x = x * 4; + g->start_y = y * g->line_size; + g->max_x = g->start_x + w * 4; + g->max_y = g->start_y + h * g->line_size; + g->cur_x = g->start_x; + g->cur_y = g->start_y; + + // if the width of the specified rectangle is 0, that means + // we may not see *any* pixels or the image is malformed; + // to make sure this is caught, move the current y down to + // max_y (which is what out_gif_code checks). + if (w == 0) + g->cur_y = g->max_y; + + g->lflags = stbi__get8(s); + + if (g->lflags & 0x40) { + g->step = 8 * g->line_size; // first interlaced spacing + g->parse = 3; + } else { + g->step = g->line_size; + g->parse = 0; + } + + if (g->lflags & 0x80) { + stbi__gif_parse_colortable(s,g->lpal, 2 << (g->lflags & 7), g->eflags & 0x01 ? g->transparent : -1); + g->color_table = (stbi_uc *) g->lpal; + } else if (g->flags & 0x80) { + g->color_table = (stbi_uc *) g->pal; + } else + return stbi__errpuc("missing color table", "Corrupt GIF"); + + o = stbi__process_gif_raster(s, g); + if (!o) return NULL; + + // if this was the first frame, + pcount = g->w * g->h; + if (first_frame && (g->bgindex > 0)) { + // if first frame, any pixel not drawn to gets the background color + for (pi = 0; pi < pcount; ++pi) { + if (g->history[pi] == 0) { + g->pal[g->bgindex][3] = 255; // just in case it was made transparent, undo that; It will be reset next frame if need be; + memcpy( &g->out[pi * 4], &g->pal[g->bgindex], 4 ); + } + } + } + + return o; + } + + case 0x21: // Comment Extension. + { + int len; + int ext = stbi__get8(s); + if (ext == 0xF9) { // Graphic Control Extension. + len = stbi__get8(s); + if (len == 4) { + g->eflags = stbi__get8(s); + g->delay = 10 * stbi__get16le(s); // delay - 1/100th of a second, saving as 1/1000ths. + + // unset old transparent + if (g->transparent >= 0) { + g->pal[g->transparent][3] = 255; + } + if (g->eflags & 0x01) { + g->transparent = stbi__get8(s); + if (g->transparent >= 0) { + g->pal[g->transparent][3] = 0; + } + } else { + // don't need transparent + stbi__skip(s, 1); + g->transparent = -1; + } + } else { + stbi__skip(s, len); + break; + } + } + while ((len = stbi__get8(s)) != 0) { + stbi__skip(s, len); + } + break; + } + + case 0x3B: // gif stream termination code + return (stbi_uc *) s; // using '1' causes warning on some compilers + + default: + return stbi__errpuc("unknown code", "Corrupt GIF"); + } + } +} + +static void *stbi__load_gif_main_outofmem(stbi__gif *g, stbi_uc *out, int **delays) +{ + STBI_FREE(g->out); + STBI_FREE(g->history); + STBI_FREE(g->background); + + if (out) STBI_FREE(out); + if (delays && *delays) STBI_FREE(*delays); + return stbi__errpuc("outofmem", "Out of memory"); +} + +static void *stbi__load_gif_main(stbi__context *s, int **delays, int *x, int *y, int *z, int *comp, int req_comp) +{ + if (stbi__gif_test(s)) { + int layers = 0; + stbi_uc *u = 0; + stbi_uc *out = 0; + stbi_uc *two_back = 0; + stbi__gif g; + int stride; + int out_size = 0; + int delays_size = 0; + + STBI_NOTUSED(out_size); + STBI_NOTUSED(delays_size); + + memset(&g, 0, sizeof(g)); + if (delays) { + *delays = 0; + } + + do { + u = stbi__gif_load_next(s, &g, comp, req_comp, two_back); + if (u == (stbi_uc *) s) u = 0; // end of animated gif marker + + if (u) { + *x = g.w; + *y = g.h; + ++layers; + stride = g.w * g.h * 4; + + if (out) { + void *tmp = (stbi_uc*) STBI_REALLOC_SIZED( out, out_size, layers * stride ); + if (!tmp) + return stbi__load_gif_main_outofmem(&g, out, delays); + else { + out = (stbi_uc*) tmp; + out_size = layers * stride; + } + + if (delays) { + int *new_delays = (int*) STBI_REALLOC_SIZED( *delays, delays_size, sizeof(int) * layers ); + if (!new_delays) + return stbi__load_gif_main_outofmem(&g, out, delays); + *delays = new_delays; + delays_size = layers * sizeof(int); + } + } else { + out = (stbi_uc*)stbi__malloc( layers * stride ); + if (!out) + return stbi__load_gif_main_outofmem(&g, out, delays); + out_size = layers * stride; + if (delays) { + *delays = (int*) stbi__malloc( layers * sizeof(int) ); + if (!*delays) + return stbi__load_gif_main_outofmem(&g, out, delays); + delays_size = layers * sizeof(int); + } + } + memcpy( out + ((layers - 1) * stride), u, stride ); + if (layers >= 2) { + two_back = out - 2 * stride; + } + + if (delays) { + (*delays)[layers - 1U] = g.delay; + } + } + } while (u != 0); + + // free temp buffer; + STBI_FREE(g.out); + STBI_FREE(g.history); + STBI_FREE(g.background); + + // do the final conversion after loading everything; + if (req_comp && req_comp != 4) + out = stbi__convert_format(out, 4, req_comp, layers * g.w, g.h); + + *z = layers; + return out; + } else { + return stbi__errpuc("not GIF", "Image was not as a gif type."); + } +} + +static void *stbi__gif_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri) +{ + stbi_uc *u = 0; + stbi__gif g; + memset(&g, 0, sizeof(g)); + STBI_NOTUSED(ri); + + u = stbi__gif_load_next(s, &g, comp, req_comp, 0); + if (u == (stbi_uc *) s) u = 0; // end of animated gif marker + if (u) { + *x = g.w; + *y = g.h; + + // moved conversion to after successful load so that the same + // can be done for multiple frames. + if (req_comp && req_comp != 4) + u = stbi__convert_format(u, 4, req_comp, g.w, g.h); + } else if (g.out) { + // if there was an error and we allocated an image buffer, free it! + STBI_FREE(g.out); + } + + // free buffers needed for multiple frame loading; + STBI_FREE(g.history); + STBI_FREE(g.background); + + return u; +} + +static int stbi__gif_info(stbi__context *s, int *x, int *y, int *comp) +{ + return stbi__gif_info_raw(s,x,y,comp); +} +#endif + +// ************************************************************************************************* +// Radiance RGBE HDR loader +// originally by Nicolas Schulz +#ifndef STBI_NO_HDR +static int stbi__hdr_test_core(stbi__context *s, const char *signature) +{ + int i; + for (i=0; signature[i]; ++i) + if (stbi__get8(s) != signature[i]) + return 0; + stbi__rewind(s); + return 1; +} + +static int stbi__hdr_test(stbi__context* s) +{ + int r = stbi__hdr_test_core(s, "#?RADIANCE\n"); + stbi__rewind(s); + if(!r) { + r = stbi__hdr_test_core(s, "#?RGBE\n"); + stbi__rewind(s); + } + return r; +} + +#define STBI__HDR_BUFLEN 1024 +static char *stbi__hdr_gettoken(stbi__context *z, char *buffer) +{ + int len=0; + char c = '\0'; + + c = (char) stbi__get8(z); + + while (!stbi__at_eof(z) && c != '\n') { + buffer[len++] = c; + if (len == STBI__HDR_BUFLEN-1) { + // flush to end of line + while (!stbi__at_eof(z) && stbi__get8(z) != '\n') + ; + break; + } + c = (char) stbi__get8(z); + } + + buffer[len] = 0; + return buffer; +} + +static void stbi__hdr_convert(float *output, stbi_uc *input, int req_comp) +{ + if ( input[3] != 0 ) { + float f1; + // Exponent + f1 = (float) ldexp(1.0f, input[3] - (int)(128 + 8)); + if (req_comp <= 2) + output[0] = (input[0] + input[1] + input[2]) * f1 / 3; + else { + output[0] = input[0] * f1; + output[1] = input[1] * f1; + output[2] = input[2] * f1; + } + if (req_comp == 2) output[1] = 1; + if (req_comp == 4) output[3] = 1; + } else { + switch (req_comp) { + case 4: output[3] = 1; /* fallthrough */ + case 3: output[0] = output[1] = output[2] = 0; + break; + case 2: output[1] = 1; /* fallthrough */ + case 1: output[0] = 0; + break; + } + } +} + +static float *stbi__hdr_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri) +{ + char buffer[STBI__HDR_BUFLEN]; + char *token; + int valid = 0; + int width, height; + stbi_uc *scanline; + float *hdr_data; + int len; + unsigned char count, value; + int i, j, k, c1,c2, z; + const char *headerToken; + STBI_NOTUSED(ri); + + // Check identifier + headerToken = stbi__hdr_gettoken(s,buffer); + if (strcmp(headerToken, "#?RADIANCE") != 0 && strcmp(headerToken, "#?RGBE") != 0) + return stbi__errpf("not HDR", "Corrupt HDR image"); + + // Parse header + for(;;) { + token = stbi__hdr_gettoken(s,buffer); + if (token[0] == 0) break; + if (strcmp(token, "FORMAT=32-bit_rle_rgbe") == 0) valid = 1; + } + + if (!valid) return stbi__errpf("unsupported format", "Unsupported HDR format"); + + // Parse width and height + // can't use sscanf() if we're not using stdio! + token = stbi__hdr_gettoken(s,buffer); + if (strncmp(token, "-Y ", 3)) return stbi__errpf("unsupported data layout", "Unsupported HDR format"); + token += 3; + height = (int) strtol(token, &token, 10); + while (*token == ' ') ++token; + if (strncmp(token, "+X ", 3)) return stbi__errpf("unsupported data layout", "Unsupported HDR format"); + token += 3; + width = (int) strtol(token, NULL, 10); + + if (height > STBI_MAX_DIMENSIONS) return stbi__errpf("too large","Very large image (corrupt?)"); + if (width > STBI_MAX_DIMENSIONS) return stbi__errpf("too large","Very large image (corrupt?)"); + + *x = width; + *y = height; + + if (comp) *comp = 3; + if (req_comp == 0) req_comp = 3; + + if (!stbi__mad4sizes_valid(width, height, req_comp, sizeof(float), 0)) + return stbi__errpf("too large", "HDR image is too large"); + + // Read data + hdr_data = (float *) stbi__malloc_mad4(width, height, req_comp, sizeof(float), 0); + if (!hdr_data) + return stbi__errpf("outofmem", "Out of memory"); + + // Load image data + // image data is stored as some number of sca + if ( width < 8 || width >= 32768) { + // Read flat data + for (j=0; j < height; ++j) { + for (i=0; i < width; ++i) { + stbi_uc rgbe[4]; + main_decode_loop: + stbi__getn(s, rgbe, 4); + stbi__hdr_convert(hdr_data + j * width * req_comp + i * req_comp, rgbe, req_comp); + } + } + } else { + // Read RLE-encoded data + scanline = NULL; + + for (j = 0; j < height; ++j) { + c1 = stbi__get8(s); + c2 = stbi__get8(s); + len = stbi__get8(s); + if (c1 != 2 || c2 != 2 || (len & 0x80)) { + // not run-length encoded, so we have to actually use THIS data as a decoded + // pixel (note this can't be a valid pixel--one of RGB must be >= 128) + stbi_uc rgbe[4]; + rgbe[0] = (stbi_uc) c1; + rgbe[1] = (stbi_uc) c2; + rgbe[2] = (stbi_uc) len; + rgbe[3] = (stbi_uc) stbi__get8(s); + stbi__hdr_convert(hdr_data, rgbe, req_comp); + i = 1; + j = 0; + STBI_FREE(scanline); + goto main_decode_loop; // yes, this makes no sense + } + len <<= 8; + len |= stbi__get8(s); + if (len != width) { STBI_FREE(hdr_data); STBI_FREE(scanline); return stbi__errpf("invalid decoded scanline length", "corrupt HDR"); } + if (scanline == NULL) { + scanline = (stbi_uc *) stbi__malloc_mad2(width, 4, 0); + if (!scanline) { + STBI_FREE(hdr_data); + return stbi__errpf("outofmem", "Out of memory"); + } + } + + for (k = 0; k < 4; ++k) { + int nleft; + i = 0; + while ((nleft = width - i) > 0) { + count = stbi__get8(s); + if (count > 128) { + // Run + value = stbi__get8(s); + count -= 128; + if ((count == 0) || (count > nleft)) { STBI_FREE(hdr_data); STBI_FREE(scanline); return stbi__errpf("corrupt", "bad RLE data in HDR"); } + for (z = 0; z < count; ++z) + scanline[i++ * 4 + k] = value; + } else { + // Dump + if ((count == 0) || (count > nleft)) { STBI_FREE(hdr_data); STBI_FREE(scanline); return stbi__errpf("corrupt", "bad RLE data in HDR"); } + for (z = 0; z < count; ++z) + scanline[i++ * 4 + k] = stbi__get8(s); + } + } + } + for (i=0; i < width; ++i) + stbi__hdr_convert(hdr_data+(j*width + i)*req_comp, scanline + i*4, req_comp); + } + if (scanline) + STBI_FREE(scanline); + } + + return hdr_data; +} + +static int stbi__hdr_info(stbi__context *s, int *x, int *y, int *comp) +{ + char buffer[STBI__HDR_BUFLEN]; + char *token; + int valid = 0; + int dummy; + + if (!x) x = &dummy; + if (!y) y = &dummy; + if (!comp) comp = &dummy; + + if (stbi__hdr_test(s) == 0) { + stbi__rewind( s ); + return 0; + } + + for(;;) { + token = stbi__hdr_gettoken(s,buffer); + if (token[0] == 0) break; + if (strcmp(token, "FORMAT=32-bit_rle_rgbe") == 0) valid = 1; + } + + if (!valid) { + stbi__rewind( s ); + return 0; + } + token = stbi__hdr_gettoken(s,buffer); + if (strncmp(token, "-Y ", 3)) { + stbi__rewind( s ); + return 0; + } + token += 3; + *y = (int) strtol(token, &token, 10); + while (*token == ' ') ++token; + if (strncmp(token, "+X ", 3)) { + stbi__rewind( s ); + return 0; + } + token += 3; + *x = (int) strtol(token, NULL, 10); + *comp = 3; + return 1; +} +#endif // STBI_NO_HDR + +#ifndef STBI_NO_BMP +static int stbi__bmp_info(stbi__context *s, int *x, int *y, int *comp) +{ + void *p; + stbi__bmp_data info; + + info.all_a = 255; + p = stbi__bmp_parse_header(s, &info); + if (p == NULL) { + stbi__rewind( s ); + return 0; + } + if (x) *x = s->img_x; + if (y) *y = s->img_y; + if (comp) { + if (info.bpp == 24 && info.ma == 0xff000000) + *comp = 3; + else + *comp = info.ma ? 4 : 3; + } + return 1; +} +#endif + +#ifndef STBI_NO_PSD +static int stbi__psd_info(stbi__context *s, int *x, int *y, int *comp) +{ + int channelCount, dummy, depth; + if (!x) x = &dummy; + if (!y) y = &dummy; + if (!comp) comp = &dummy; + if (stbi__get32be(s) != 0x38425053) { + stbi__rewind( s ); + return 0; + } + if (stbi__get16be(s) != 1) { + stbi__rewind( s ); + return 0; + } + stbi__skip(s, 6); + channelCount = stbi__get16be(s); + if (channelCount < 0 || channelCount > 16) { + stbi__rewind( s ); + return 0; + } + *y = stbi__get32be(s); + *x = stbi__get32be(s); + depth = stbi__get16be(s); + if (depth != 8 && depth != 16) { + stbi__rewind( s ); + return 0; + } + if (stbi__get16be(s) != 3) { + stbi__rewind( s ); + return 0; + } + *comp = 4; + return 1; +} + +static int stbi__psd_is16(stbi__context *s) +{ + int channelCount, depth; + if (stbi__get32be(s) != 0x38425053) { + stbi__rewind( s ); + return 0; + } + if (stbi__get16be(s) != 1) { + stbi__rewind( s ); + return 0; + } + stbi__skip(s, 6); + channelCount = stbi__get16be(s); + if (channelCount < 0 || channelCount > 16) { + stbi__rewind( s ); + return 0; + } + STBI_NOTUSED(stbi__get32be(s)); + STBI_NOTUSED(stbi__get32be(s)); + depth = stbi__get16be(s); + if (depth != 16) { + stbi__rewind( s ); + return 0; + } + return 1; +} +#endif + +#ifndef STBI_NO_PIC +static int stbi__pic_info(stbi__context *s, int *x, int *y, int *comp) +{ + int act_comp=0,num_packets=0,chained,dummy; + stbi__pic_packet packets[10]; + + if (!x) x = &dummy; + if (!y) y = &dummy; + if (!comp) comp = &dummy; + + if (!stbi__pic_is4(s,"\x53\x80\xF6\x34")) { + stbi__rewind(s); + return 0; + } + + stbi__skip(s, 88); + + *x = stbi__get16be(s); + *y = stbi__get16be(s); + if (stbi__at_eof(s)) { + stbi__rewind( s); + return 0; + } + if ( (*x) != 0 && (1 << 28) / (*x) < (*y)) { + stbi__rewind( s ); + return 0; + } + + stbi__skip(s, 8); + + do { + stbi__pic_packet *packet; + + if (num_packets==sizeof(packets)/sizeof(packets[0])) + return 0; + + packet = &packets[num_packets++]; + chained = stbi__get8(s); + packet->size = stbi__get8(s); + packet->type = stbi__get8(s); + packet->channel = stbi__get8(s); + act_comp |= packet->channel; + + if (stbi__at_eof(s)) { + stbi__rewind( s ); + return 0; + } + if (packet->size != 8) { + stbi__rewind( s ); + return 0; + } + } while (chained); + + *comp = (act_comp & 0x10 ? 4 : 3); + + return 1; +} +#endif + +// ************************************************************************************************* +// Portable Gray Map and Portable Pixel Map loader +// by Ken Miller +// +// PGM: http://netpbm.sourceforge.net/doc/pgm.html +// PPM: http://netpbm.sourceforge.net/doc/ppm.html +// +// Known limitations: +// Does not support comments in the header section +// Does not support ASCII image data (formats P2 and P3) + +#ifndef STBI_NO_PNM + +static int stbi__pnm_test(stbi__context *s) +{ + char p, t; + p = (char) stbi__get8(s); + t = (char) stbi__get8(s); + if (p != 'P' || (t != '5' && t != '6')) { + stbi__rewind( s ); + return 0; + } + return 1; +} + +static void *stbi__pnm_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri) +{ + stbi_uc *out; + STBI_NOTUSED(ri); + + ri->bits_per_channel = stbi__pnm_info(s, (int *)&s->img_x, (int *)&s->img_y, (int *)&s->img_n); + if (ri->bits_per_channel == 0) + return 0; + + if (s->img_y > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large","Very large image (corrupt?)"); + if (s->img_x > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large","Very large image (corrupt?)"); + + *x = s->img_x; + *y = s->img_y; + if (comp) *comp = s->img_n; + + if (!stbi__mad4sizes_valid(s->img_n, s->img_x, s->img_y, ri->bits_per_channel / 8, 0)) + return stbi__errpuc("too large", "PNM too large"); + + out = (stbi_uc *) stbi__malloc_mad4(s->img_n, s->img_x, s->img_y, ri->bits_per_channel / 8, 0); + if (!out) return stbi__errpuc("outofmem", "Out of memory"); + if (!stbi__getn(s, out, s->img_n * s->img_x * s->img_y * (ri->bits_per_channel / 8))) { + STBI_FREE(out); + return stbi__errpuc("bad PNM", "PNM file truncated"); + } + + if (req_comp && req_comp != s->img_n) { + if (ri->bits_per_channel == 16) { + out = (stbi_uc *) stbi__convert_format16((stbi__uint16 *) out, s->img_n, req_comp, s->img_x, s->img_y); + } else { + out = stbi__convert_format(out, s->img_n, req_comp, s->img_x, s->img_y); + } + if (out == NULL) return out; // stbi__convert_format frees input on failure + } + return out; +} + +static int stbi__pnm_isspace(char c) +{ + return c == ' ' || c == '\t' || c == '\n' || c == '\v' || c == '\f' || c == '\r'; +} + +static void stbi__pnm_skip_whitespace(stbi__context *s, char *c) +{ + for (;;) { + while (!stbi__at_eof(s) && stbi__pnm_isspace(*c)) + *c = (char) stbi__get8(s); + + if (stbi__at_eof(s) || *c != '#') + break; + + while (!stbi__at_eof(s) && *c != '\n' && *c != '\r' ) + *c = (char) stbi__get8(s); + } +} + +static int stbi__pnm_isdigit(char c) +{ + return c >= '0' && c <= '9'; +} + +static int stbi__pnm_getinteger(stbi__context *s, char *c) +{ + int value = 0; + + while (!stbi__at_eof(s) && stbi__pnm_isdigit(*c)) { + value = value*10 + (*c - '0'); + *c = (char) stbi__get8(s); + if((value > 214748364) || (value == 214748364 && *c > '7')) + return stbi__err("integer parse overflow", "Parsing an integer in the PPM header overflowed a 32-bit int"); + } + + return value; +} + +static int stbi__pnm_info(stbi__context *s, int *x, int *y, int *comp) +{ + int maxv, dummy; + char c, p, t; + + if (!x) x = &dummy; + if (!y) y = &dummy; + if (!comp) comp = &dummy; + + stbi__rewind(s); + + // Get identifier + p = (char) stbi__get8(s); + t = (char) stbi__get8(s); + if (p != 'P' || (t != '5' && t != '6')) { + stbi__rewind(s); + return 0; + } + + *comp = (t == '6') ? 3 : 1; // '5' is 1-component .pgm; '6' is 3-component .ppm + + c = (char) stbi__get8(s); + stbi__pnm_skip_whitespace(s, &c); + + *x = stbi__pnm_getinteger(s, &c); // read width + if(*x == 0) + return stbi__err("invalid width", "PPM image header had zero or overflowing width"); + stbi__pnm_skip_whitespace(s, &c); + + *y = stbi__pnm_getinteger(s, &c); // read height + if (*y == 0) + return stbi__err("invalid width", "PPM image header had zero or overflowing width"); + stbi__pnm_skip_whitespace(s, &c); + + maxv = stbi__pnm_getinteger(s, &c); // read max value + if (maxv > 65535) + return stbi__err("max value > 65535", "PPM image supports only 8-bit and 16-bit images"); + else if (maxv > 255) + return 16; + else + return 8; +} + +static int stbi__pnm_is16(stbi__context *s) +{ + if (stbi__pnm_info(s, NULL, NULL, NULL) == 16) + return 1; + return 0; +} +#endif + +static int stbi__info_main(stbi__context *s, int *x, int *y, int *comp) +{ + #ifndef STBI_NO_JPEG + if (stbi__jpeg_info(s, x, y, comp)) return 1; + #endif + + #ifndef STBI_NO_PNG + if (stbi__png_info(s, x, y, comp)) return 1; + #endif + + #ifndef STBI_NO_GIF + if (stbi__gif_info(s, x, y, comp)) return 1; + #endif + + #ifndef STBI_NO_BMP + if (stbi__bmp_info(s, x, y, comp)) return 1; + #endif + + #ifndef STBI_NO_PSD + if (stbi__psd_info(s, x, y, comp)) return 1; + #endif + + #ifndef STBI_NO_PIC + if (stbi__pic_info(s, x, y, comp)) return 1; + #endif + + #ifndef STBI_NO_PNM + if (stbi__pnm_info(s, x, y, comp)) return 1; + #endif + + #ifndef STBI_NO_HDR + if (stbi__hdr_info(s, x, y, comp)) return 1; + #endif + + // test tga last because it's a crappy test! + #ifndef STBI_NO_TGA + if (stbi__tga_info(s, x, y, comp)) + return 1; + #endif + return stbi__err("unknown image type", "Image not of any known type, or corrupt"); +} + +static int stbi__is_16_main(stbi__context *s) +{ + #ifndef STBI_NO_PNG + if (stbi__png_is16(s)) return 1; + #endif + + #ifndef STBI_NO_PSD + if (stbi__psd_is16(s)) return 1; + #endif + + #ifndef STBI_NO_PNM + if (stbi__pnm_is16(s)) return 1; + #endif + return 0; +} + +#ifndef STBI_NO_STDIO +STBIDEF int stbi_info(char const *filename, int *x, int *y, int *comp) +{ + FILE *f = stbi__fopen(filename, "rb"); + int result; + if (!f) return stbi__err("can't fopen", "Unable to open file"); + result = stbi_info_from_file(f, x, y, comp); + fclose(f); + return result; +} + +STBIDEF int stbi_info_from_file(FILE *f, int *x, int *y, int *comp) +{ + int r; + stbi__context s; + long pos = ftell(f); + stbi__start_file(&s, f); + r = stbi__info_main(&s,x,y,comp); + fseek(f,pos,SEEK_SET); + return r; +} + +STBIDEF int stbi_is_16_bit(char const *filename) +{ + FILE *f = stbi__fopen(filename, "rb"); + int result; + if (!f) return stbi__err("can't fopen", "Unable to open file"); + result = stbi_is_16_bit_from_file(f); + fclose(f); + return result; +} + +STBIDEF int stbi_is_16_bit_from_file(FILE *f) +{ + int r; + stbi__context s; + long pos = ftell(f); + stbi__start_file(&s, f); + r = stbi__is_16_main(&s); + fseek(f,pos,SEEK_SET); + return r; +} +#endif // !STBI_NO_STDIO + +STBIDEF int stbi_info_from_memory(stbi_uc const *buffer, int len, int *x, int *y, int *comp) +{ + stbi__context s; + stbi__start_mem(&s,buffer,len); + return stbi__info_main(&s,x,y,comp); +} + +STBIDEF int stbi_info_from_callbacks(stbi_io_callbacks const *c, void *user, int *x, int *y, int *comp) +{ + stbi__context s; + stbi__start_callbacks(&s, (stbi_io_callbacks *) c, user); + return stbi__info_main(&s,x,y,comp); +} + +STBIDEF int stbi_is_16_bit_from_memory(stbi_uc const *buffer, int len) +{ + stbi__context s; + stbi__start_mem(&s,buffer,len); + return stbi__is_16_main(&s); +} + +STBIDEF int stbi_is_16_bit_from_callbacks(stbi_io_callbacks const *c, void *user) +{ + stbi__context s; + stbi__start_callbacks(&s, (stbi_io_callbacks *) c, user); + return stbi__is_16_main(&s); +} + +#endif // STB_IMAGE_IMPLEMENTATION + +/* + revision history: + 2.20 (2019-02-07) support utf8 filenames in Windows; fix warnings and platform ifdefs + 2.19 (2018-02-11) fix warning + 2.18 (2018-01-30) fix warnings + 2.17 (2018-01-29) change sbti__shiftsigned to avoid clang -O2 bug + 1-bit BMP + *_is_16_bit api + avoid warnings + 2.16 (2017-07-23) all functions have 16-bit variants; + STBI_NO_STDIO works again; + compilation fixes; + fix rounding in unpremultiply; + optimize vertical flip; + disable raw_len validation; + documentation fixes + 2.15 (2017-03-18) fix png-1,2,4 bug; now all Imagenet JPGs decode; + warning fixes; disable run-time SSE detection on gcc; + uniform handling of optional "return" values; + thread-safe initialization of zlib tables + 2.14 (2017-03-03) remove deprecated STBI_JPEG_OLD; fixes for Imagenet JPGs + 2.13 (2016-11-29) add 16-bit API, only supported for PNG right now + 2.12 (2016-04-02) fix typo in 2.11 PSD fix that caused crashes + 2.11 (2016-04-02) allocate large structures on the stack + remove white matting for transparent PSD + fix reported channel count for PNG & BMP + re-enable SSE2 in non-gcc 64-bit + support RGB-formatted JPEG + read 16-bit PNGs (only as 8-bit) + 2.10 (2016-01-22) avoid warning introduced in 2.09 by STBI_REALLOC_SIZED + 2.09 (2016-01-16) allow comments in PNM files + 16-bit-per-pixel TGA (not bit-per-component) + info() for TGA could break due to .hdr handling + info() for BMP to shares code instead of sloppy parse + can use STBI_REALLOC_SIZED if allocator doesn't support realloc + code cleanup + 2.08 (2015-09-13) fix to 2.07 cleanup, reading RGB PSD as RGBA + 2.07 (2015-09-13) fix compiler warnings + partial animated GIF support + limited 16-bpc PSD support + #ifdef unused functions + bug with < 92 byte PIC,PNM,HDR,TGA + 2.06 (2015-04-19) fix bug where PSD returns wrong '*comp' value + 2.05 (2015-04-19) fix bug in progressive JPEG handling, fix warning + 2.04 (2015-04-15) try to re-enable SIMD on MinGW 64-bit + 2.03 (2015-04-12) extra corruption checking (mmozeiko) + stbi_set_flip_vertically_on_load (nguillemot) + fix NEON support; fix mingw support + 2.02 (2015-01-19) fix incorrect assert, fix warning + 2.01 (2015-01-17) fix various warnings; suppress SIMD on gcc 32-bit without -msse2 + 2.00b (2014-12-25) fix STBI_MALLOC in progressive JPEG + 2.00 (2014-12-25) optimize JPG, including x86 SSE2 & NEON SIMD (ryg) + progressive JPEG (stb) + PGM/PPM support (Ken Miller) + STBI_MALLOC,STBI_REALLOC,STBI_FREE + GIF bugfix -- seemingly never worked + STBI_NO_*, STBI_ONLY_* + 1.48 (2014-12-14) fix incorrectly-named assert() + 1.47 (2014-12-14) 1/2/4-bit PNG support, both direct and paletted (Omar Cornut & stb) + optimize PNG (ryg) + fix bug in interlaced PNG with user-specified channel count (stb) + 1.46 (2014-08-26) + fix broken tRNS chunk (colorkey-style transparency) in non-paletted PNG + 1.45 (2014-08-16) + fix MSVC-ARM internal compiler error by wrapping malloc + 1.44 (2014-08-07) + various warning fixes from Ronny Chevalier + 1.43 (2014-07-15) + fix MSVC-only compiler problem in code changed in 1.42 + 1.42 (2014-07-09) + don't define _CRT_SECURE_NO_WARNINGS (affects user code) + fixes to stbi__cleanup_jpeg path + added STBI_ASSERT to avoid requiring assert.h + 1.41 (2014-06-25) + fix search&replace from 1.36 that messed up comments/error messages + 1.40 (2014-06-22) + fix gcc struct-initialization warning + 1.39 (2014-06-15) + fix to TGA optimization when req_comp != number of components in TGA; + fix to GIF loading because BMP wasn't rewinding (whoops, no GIFs in my test suite) + add support for BMP version 5 (more ignored fields) + 1.38 (2014-06-06) + suppress MSVC warnings on integer casts truncating values + fix accidental rename of 'skip' field of I/O + 1.37 (2014-06-04) + remove duplicate typedef + 1.36 (2014-06-03) + convert to header file single-file library + if de-iphone isn't set, load iphone images color-swapped instead of returning NULL + 1.35 (2014-05-27) + various warnings + fix broken STBI_SIMD path + fix bug where stbi_load_from_file no longer left file pointer in correct place + fix broken non-easy path for 32-bit BMP (possibly never used) + TGA optimization by Arseny Kapoulkine + 1.34 (unknown) + use STBI_NOTUSED in stbi__resample_row_generic(), fix one more leak in tga failure case + 1.33 (2011-07-14) + make stbi_is_hdr work in STBI_NO_HDR (as specified), minor compiler-friendly improvements + 1.32 (2011-07-13) + support for "info" function for all supported filetypes (SpartanJ) + 1.31 (2011-06-20) + a few more leak fixes, bug in PNG handling (SpartanJ) + 1.30 (2011-06-11) + added ability to load files via callbacks to accomidate custom input streams (Ben Wenger) + removed deprecated format-specific test/load functions + removed support for installable file formats (stbi_loader) -- would have been broken for IO callbacks anyway + error cases in bmp and tga give messages and don't leak (Raymond Barbiero, grisha) + fix inefficiency in decoding 32-bit BMP (David Woo) + 1.29 (2010-08-16) + various warning fixes from Aurelien Pocheville + 1.28 (2010-08-01) + fix bug in GIF palette transparency (SpartanJ) + 1.27 (2010-08-01) + cast-to-stbi_uc to fix warnings + 1.26 (2010-07-24) + fix bug in file buffering for PNG reported by SpartanJ + 1.25 (2010-07-17) + refix trans_data warning (Won Chun) + 1.24 (2010-07-12) + perf improvements reading from files on platforms with lock-heavy fgetc() + minor perf improvements for jpeg + deprecated type-specific functions so we'll get feedback if they're needed + attempt to fix trans_data warning (Won Chun) + 1.23 fixed bug in iPhone support + 1.22 (2010-07-10) + removed image *writing* support + stbi_info support from Jetro Lauha + GIF support from Jean-Marc Lienher + iPhone PNG-extensions from James Brown + warning-fixes from Nicolas Schulz and Janez Zemva (i.stbi__err. Janez (U+017D)emva) + 1.21 fix use of 'stbi_uc' in header (reported by jon blow) + 1.20 added support for Softimage PIC, by Tom Seddon + 1.19 bug in interlaced PNG corruption check (found by ryg) + 1.18 (2008-08-02) + fix a threading bug (local mutable static) + 1.17 support interlaced PNG + 1.16 major bugfix - stbi__convert_format converted one too many pixels + 1.15 initialize some fields for thread safety + 1.14 fix threadsafe conversion bug + header-file-only version (#define STBI_HEADER_FILE_ONLY before including) + 1.13 threadsafe + 1.12 const qualifiers in the API + 1.11 Support installable IDCT, colorspace conversion routines + 1.10 Fixes for 64-bit (don't use "unsigned long") + optimized upsampling by Fabian "ryg" Giesen + 1.09 Fix format-conversion for PSD code (bad global variables!) + 1.08 Thatcher Ulrich's PSD code integrated by Nicolas Schulz + 1.07 attempt to fix C++ warning/errors again + 1.06 attempt to fix C++ warning/errors again + 1.05 fix TGA loading to return correct *comp and use good luminance calc + 1.04 default float alpha is 1, not 255; use 'void *' for stbi_image_free + 1.03 bugfixes to STBI_NO_STDIO, STBI_NO_HDR + 1.02 support for (subset of) HDR files, float interface for preferred access to them + 1.01 fix bug: possible bug in handling right-side up bmps... not sure + fix bug: the stbi__bmp_load() and stbi__tga_load() functions didn't work at all + 1.00 interface to zlib that skips zlib header + 0.99 correct handling of alpha in palette + 0.98 TGA loader by lonesock; dynamically add loaders (untested) + 0.97 jpeg errors on too large a file; also catch another malloc failure + 0.96 fix detection of invalid v value - particleman@mollyrocket forum + 0.95 during header scan, seek to markers in case of padding + 0.94 STBI_NO_STDIO to disable stdio usage; rename all #defines the same + 0.93 handle jpegtran output; verbose errors + 0.92 read 4,8,16,24,32-bit BMP files of several formats + 0.91 output 24-bit Windows 3.0 BMP files + 0.90 fix a few more warnings; bump version number to approach 1.0 + 0.61 bugfixes due to Marc LeBlanc, Christopher Lloyd + 0.60 fix compiling as c++ + 0.59 fix warnings: merge Dave Moore's -Wall fixes + 0.58 fix bug: zlib uncompressed mode len/nlen was wrong endian + 0.57 fix bug: jpg last huffman symbol before marker was >9 bits but less than 16 available + 0.56 fix bug: zlib uncompressed mode len vs. nlen + 0.55 fix bug: restart_interval not initialized to 0 + 0.54 allow NULL for 'int *comp' + 0.53 fix bug in png 3->4; speedup png decoding + 0.52 png handles req_comp=3,4 directly; minor cleanup; jpeg comments + 0.51 obey req_comp requests, 1-component jpegs return as 1-component, + on 'test' only check type, not whether we support this variant + 0.50 (2006-11-19) + first released version +*/ + + +/* +------------------------------------------------------------------------------ +This software is available under 2 licenses -- choose whichever you prefer. +------------------------------------------------------------------------------ +ALTERNATIVE A - MIT License +Copyright (c) 2017 Sean Barrett +Permission is hereby granted, free of charge, to any person obtaining a copy of +this software and associated documentation files (the "Software"), to deal in +the Software without restriction, including without limitation the rights to +use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies +of the Software, and to permit persons to whom the Software is furnished to do +so, subject to the following conditions: +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. +------------------------------------------------------------------------------ +ALTERNATIVE B - Public Domain (www.unlicense.org) +This is free and unencumbered software released into the public domain. +Anyone is free to copy, modify, publish, use, compile, sell, or distribute this +software, either in source code form or as a compiled binary, for any purpose, +commercial or non-commercial, and by any means. +In jurisdictions that recognize copyright laws, the author or authors of this +software dedicate any and all copyright interest in the software to the public +domain. We make this dedication for the benefit of the public at large and to +the detriment of our heirs and successors. We intend this dedication to be an +overt act of relinquishment in perpetuity of all present and future rights to +this software under copyright law. +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN +ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION +WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. +------------------------------------------------------------------------------ +*/ diff --git a/stb/stb_image_write.h b/stb/stb_image_write.h new file mode 100644 index 0000000..e4b32ed --- /dev/null +++ b/stb/stb_image_write.h @@ -0,0 +1,1724 @@ +/* stb_image_write - v1.16 - public domain - http://nothings.org/stb + writes out PNG/BMP/TGA/JPEG/HDR images to C stdio - Sean Barrett 2010-2015 + no warranty implied; use at your own risk + + Before #including, + + #define STB_IMAGE_WRITE_IMPLEMENTATION + + in the file that you want to have the implementation. + + Will probably not work correctly with strict-aliasing optimizations. + +ABOUT: + + This header file is a library for writing images to C stdio or a callback. + + The PNG output is not optimal; it is 20-50% larger than the file + written by a decent optimizing implementation; though providing a custom + zlib compress function (see STBIW_ZLIB_COMPRESS) can mitigate that. + This library is designed for source code compactness and simplicity, + not optimal image file size or run-time performance. + +BUILDING: + + You can #define STBIW_ASSERT(x) before the #include to avoid using assert.h. + You can #define STBIW_MALLOC(), STBIW_REALLOC(), and STBIW_FREE() to replace + malloc,realloc,free. + You can #define STBIW_MEMMOVE() to replace memmove() + You can #define STBIW_ZLIB_COMPRESS to use a custom zlib-style compress function + for PNG compression (instead of the builtin one), it must have the following signature: + unsigned char * my_compress(unsigned char *data, int data_len, int *out_len, int quality); + The returned data will be freed with STBIW_FREE() (free() by default), + so it must be heap allocated with STBIW_MALLOC() (malloc() by default), + +UNICODE: + + If compiling for Windows and you wish to use Unicode filenames, compile + with + #define STBIW_WINDOWS_UTF8 + and pass utf8-encoded filenames. Call stbiw_convert_wchar_to_utf8 to convert + Windows wchar_t filenames to utf8. + +USAGE: + + There are five functions, one for each image file format: + + int stbi_write_png(char const *filename, int w, int h, int comp, const void *data, int stride_in_bytes); + int stbi_write_bmp(char const *filename, int w, int h, int comp, const void *data); + int stbi_write_tga(char const *filename, int w, int h, int comp, const void *data); + int stbi_write_jpg(char const *filename, int w, int h, int comp, const void *data, int quality); + int stbi_write_hdr(char const *filename, int w, int h, int comp, const float *data); + + void stbi_flip_vertically_on_write(int flag); // flag is non-zero to flip data vertically + + There are also five equivalent functions that use an arbitrary write function. You are + expected to open/close your file-equivalent before and after calling these: + + int stbi_write_png_to_func(stbi_write_func *func, void *context, int w, int h, int comp, const void *data, int stride_in_bytes); + int stbi_write_bmp_to_func(stbi_write_func *func, void *context, int w, int h, int comp, const void *data); + int stbi_write_tga_to_func(stbi_write_func *func, void *context, int w, int h, int comp, const void *data); + int stbi_write_hdr_to_func(stbi_write_func *func, void *context, int w, int h, int comp, const float *data); + int stbi_write_jpg_to_func(stbi_write_func *func, void *context, int x, int y, int comp, const void *data, int quality); + + where the callback is: + void stbi_write_func(void *context, void *data, int size); + + You can configure it with these global variables: + int stbi_write_tga_with_rle; // defaults to true; set to 0 to disable RLE + int stbi_write_png_compression_level; // defaults to 8; set to higher for more compression + int stbi_write_force_png_filter; // defaults to -1; set to 0..5 to force a filter mode + + + You can define STBI_WRITE_NO_STDIO to disable the file variant of these + functions, so the library will not use stdio.h at all. However, this will + also disable HDR writing, because it requires stdio for formatted output. + + Each function returns 0 on failure and non-0 on success. + + The functions create an image file defined by the parameters. The image + is a rectangle of pixels stored from left-to-right, top-to-bottom. + Each pixel contains 'comp' channels of data stored interleaved with 8-bits + per channel, in the following order: 1=Y, 2=YA, 3=RGB, 4=RGBA. (Y is + monochrome color.) The rectangle is 'w' pixels wide and 'h' pixels tall. + The *data pointer points to the first byte of the top-left-most pixel. + For PNG, "stride_in_bytes" is the distance in bytes from the first byte of + a row of pixels to the first byte of the next row of pixels. + + PNG creates output files with the same number of components as the input. + The BMP format expands Y to RGB in the file format and does not + output alpha. + + PNG supports writing rectangles of data even when the bytes storing rows of + data are not consecutive in memory (e.g. sub-rectangles of a larger image), + by supplying the stride between the beginning of adjacent rows. The other + formats do not. (Thus you cannot write a native-format BMP through the BMP + writer, both because it is in BGR order and because it may have padding + at the end of the line.) + + PNG allows you to set the deflate compression level by setting the global + variable 'stbi_write_png_compression_level' (it defaults to 8). + + HDR expects linear float data. Since the format is always 32-bit rgb(e) + data, alpha (if provided) is discarded, and for monochrome data it is + replicated across all three channels. + + TGA supports RLE or non-RLE compressed data. To use non-RLE-compressed + data, set the global variable 'stbi_write_tga_with_rle' to 0. + + JPEG does ignore alpha channels in input data; quality is between 1 and 100. + Higher quality looks better but results in a bigger image. + JPEG baseline (no JPEG progressive). + +CREDITS: + + + Sean Barrett - PNG/BMP/TGA + Baldur Karlsson - HDR + Jean-Sebastien Guay - TGA monochrome + Tim Kelsey - misc enhancements + Alan Hickman - TGA RLE + Emmanuel Julien - initial file IO callback implementation + Jon Olick - original jo_jpeg.cpp code + Daniel Gibson - integrate JPEG, allow external zlib + Aarni Koskela - allow choosing PNG filter + + bugfixes: + github:Chribba + Guillaume Chereau + github:jry2 + github:romigrou + Sergio Gonzalez + Jonas Karlsson + Filip Wasil + Thatcher Ulrich + github:poppolopoppo + Patrick Boettcher + github:xeekworx + Cap Petschulat + Simon Rodriguez + Ivan Tikhonov + github:ignotion + Adam Schackart + Andrew Kensler + +LICENSE + + See end of file for license information. + +*/ + +#ifndef INCLUDE_STB_IMAGE_WRITE_H +#define INCLUDE_STB_IMAGE_WRITE_H + +#include + +// if STB_IMAGE_WRITE_STATIC causes problems, try defining STBIWDEF to 'inline' or 'static inline' +#ifndef STBIWDEF +#ifdef STB_IMAGE_WRITE_STATIC +#define STBIWDEF static +#else +#ifdef __cplusplus +#define STBIWDEF extern "C" +#else +#define STBIWDEF extern +#endif +#endif +#endif + +#ifndef STB_IMAGE_WRITE_STATIC // C++ forbids static forward declarations +STBIWDEF int stbi_write_tga_with_rle; +STBIWDEF int stbi_write_png_compression_level; +STBIWDEF int stbi_write_force_png_filter; +#endif + +#ifndef STBI_WRITE_NO_STDIO +STBIWDEF int stbi_write_png(char const *filename, int w, int h, int comp, const void *data, int stride_in_bytes); +STBIWDEF int stbi_write_bmp(char const *filename, int w, int h, int comp, const void *data); +STBIWDEF int stbi_write_tga(char const *filename, int w, int h, int comp, const void *data); +STBIWDEF int stbi_write_hdr(char const *filename, int w, int h, int comp, const float *data); +STBIWDEF int stbi_write_jpg(char const *filename, int x, int y, int comp, const void *data, int quality); + +#ifdef STBIW_WINDOWS_UTF8 +STBIWDEF int stbiw_convert_wchar_to_utf8(char *buffer, size_t bufferlen, const wchar_t* input); +#endif +#endif + +typedef void stbi_write_func(void *context, void *data, int size); + +STBIWDEF int stbi_write_png_to_func(stbi_write_func *func, void *context, int w, int h, int comp, const void *data, int stride_in_bytes); +STBIWDEF int stbi_write_bmp_to_func(stbi_write_func *func, void *context, int w, int h, int comp, const void *data); +STBIWDEF int stbi_write_tga_to_func(stbi_write_func *func, void *context, int w, int h, int comp, const void *data); +STBIWDEF int stbi_write_hdr_to_func(stbi_write_func *func, void *context, int w, int h, int comp, const float *data); +STBIWDEF int stbi_write_jpg_to_func(stbi_write_func *func, void *context, int x, int y, int comp, const void *data, int quality); + +STBIWDEF void stbi_flip_vertically_on_write(int flip_boolean); + +#endif//INCLUDE_STB_IMAGE_WRITE_H + +#ifdef STB_IMAGE_WRITE_IMPLEMENTATION + +#ifdef _WIN32 + #ifndef _CRT_SECURE_NO_WARNINGS + #define _CRT_SECURE_NO_WARNINGS + #endif + #ifndef _CRT_NONSTDC_NO_DEPRECATE + #define _CRT_NONSTDC_NO_DEPRECATE + #endif +#endif + +#ifndef STBI_WRITE_NO_STDIO +#include +#endif // STBI_WRITE_NO_STDIO + +#include +#include +#include +#include + +#if defined(STBIW_MALLOC) && defined(STBIW_FREE) && (defined(STBIW_REALLOC) || defined(STBIW_REALLOC_SIZED)) +// ok +#elif !defined(STBIW_MALLOC) && !defined(STBIW_FREE) && !defined(STBIW_REALLOC) && !defined(STBIW_REALLOC_SIZED) +// ok +#else +#error "Must define all or none of STBIW_MALLOC, STBIW_FREE, and STBIW_REALLOC (or STBIW_REALLOC_SIZED)." +#endif + +#ifndef STBIW_MALLOC +#define STBIW_MALLOC(sz) malloc(sz) +#define STBIW_REALLOC(p,newsz) realloc(p,newsz) +#define STBIW_FREE(p) free(p) +#endif + +#ifndef STBIW_REALLOC_SIZED +#define STBIW_REALLOC_SIZED(p,oldsz,newsz) STBIW_REALLOC(p,newsz) +#endif + + +#ifndef STBIW_MEMMOVE +#define STBIW_MEMMOVE(a,b,sz) memmove(a,b,sz) +#endif + + +#ifndef STBIW_ASSERT +#include +#define STBIW_ASSERT(x) assert(x) +#endif + +#define STBIW_UCHAR(x) (unsigned char) ((x) & 0xff) + +#ifdef STB_IMAGE_WRITE_STATIC +static int stbi_write_png_compression_level = 8; +static int stbi_write_tga_with_rle = 1; +static int stbi_write_force_png_filter = -1; +#else +int stbi_write_png_compression_level = 8; +int stbi_write_tga_with_rle = 1; +int stbi_write_force_png_filter = -1; +#endif + +static int stbi__flip_vertically_on_write = 0; + +STBIWDEF void stbi_flip_vertically_on_write(int flag) +{ + stbi__flip_vertically_on_write = flag; +} + +typedef struct +{ + stbi_write_func *func; + void *context; + unsigned char buffer[64]; + int buf_used; +} stbi__write_context; + +// initialize a callback-based context +static void stbi__start_write_callbacks(stbi__write_context *s, stbi_write_func *c, void *context) +{ + s->func = c; + s->context = context; +} + +#ifndef STBI_WRITE_NO_STDIO + +static void stbi__stdio_write(void *context, void *data, int size) +{ + fwrite(data,1,size,(FILE*) context); +} + +#if defined(_WIN32) && defined(STBIW_WINDOWS_UTF8) +#ifdef __cplusplus +#define STBIW_EXTERN extern "C" +#else +#define STBIW_EXTERN extern +#endif +STBIW_EXTERN __declspec(dllimport) int __stdcall MultiByteToWideChar(unsigned int cp, unsigned long flags, const char *str, int cbmb, wchar_t *widestr, int cchwide); +STBIW_EXTERN __declspec(dllimport) int __stdcall WideCharToMultiByte(unsigned int cp, unsigned long flags, const wchar_t *widestr, int cchwide, char *str, int cbmb, const char *defchar, int *used_default); + +STBIWDEF int stbiw_convert_wchar_to_utf8(char *buffer, size_t bufferlen, const wchar_t* input) +{ + return WideCharToMultiByte(65001 /* UTF8 */, 0, input, -1, buffer, (int) bufferlen, NULL, NULL); +} +#endif + +static FILE *stbiw__fopen(char const *filename, char const *mode) +{ + FILE *f; +#if defined(_WIN32) && defined(STBIW_WINDOWS_UTF8) + wchar_t wMode[64]; + wchar_t wFilename[1024]; + if (0 == MultiByteToWideChar(65001 /* UTF8 */, 0, filename, -1, wFilename, sizeof(wFilename)/sizeof(*wFilename))) + return 0; + + if (0 == MultiByteToWideChar(65001 /* UTF8 */, 0, mode, -1, wMode, sizeof(wMode)/sizeof(*wMode))) + return 0; + +#if defined(_MSC_VER) && _MSC_VER >= 1400 + if (0 != _wfopen_s(&f, wFilename, wMode)) + f = 0; +#else + f = _wfopen(wFilename, wMode); +#endif + +#elif defined(_MSC_VER) && _MSC_VER >= 1400 + if (0 != fopen_s(&f, filename, mode)) + f=0; +#else + f = fopen(filename, mode); +#endif + return f; +} + +static int stbi__start_write_file(stbi__write_context *s, const char *filename) +{ + FILE *f = stbiw__fopen(filename, "wb"); + stbi__start_write_callbacks(s, stbi__stdio_write, (void *) f); + return f != NULL; +} + +static void stbi__end_write_file(stbi__write_context *s) +{ + fclose((FILE *)s->context); +} + +#endif // !STBI_WRITE_NO_STDIO + +typedef unsigned int stbiw_uint32; +typedef int stb_image_write_test[sizeof(stbiw_uint32)==4 ? 1 : -1]; + +static void stbiw__writefv(stbi__write_context *s, const char *fmt, va_list v) +{ + while (*fmt) { + switch (*fmt++) { + case ' ': break; + case '1': { unsigned char x = STBIW_UCHAR(va_arg(v, int)); + s->func(s->context,&x,1); + break; } + case '2': { int x = va_arg(v,int); + unsigned char b[2]; + b[0] = STBIW_UCHAR(x); + b[1] = STBIW_UCHAR(x>>8); + s->func(s->context,b,2); + break; } + case '4': { stbiw_uint32 x = va_arg(v,int); + unsigned char b[4]; + b[0]=STBIW_UCHAR(x); + b[1]=STBIW_UCHAR(x>>8); + b[2]=STBIW_UCHAR(x>>16); + b[3]=STBIW_UCHAR(x>>24); + s->func(s->context,b,4); + break; } + default: + STBIW_ASSERT(0); + return; + } + } +} + +static void stbiw__writef(stbi__write_context *s, const char *fmt, ...) +{ + va_list v; + va_start(v, fmt); + stbiw__writefv(s, fmt, v); + va_end(v); +} + +static void stbiw__write_flush(stbi__write_context *s) +{ + if (s->buf_used) { + s->func(s->context, &s->buffer, s->buf_used); + s->buf_used = 0; + } +} + +static void stbiw__putc(stbi__write_context *s, unsigned char c) +{ + s->func(s->context, &c, 1); +} + +static void stbiw__write1(stbi__write_context *s, unsigned char a) +{ + if ((size_t)s->buf_used + 1 > sizeof(s->buffer)) + stbiw__write_flush(s); + s->buffer[s->buf_used++] = a; +} + +static void stbiw__write3(stbi__write_context *s, unsigned char a, unsigned char b, unsigned char c) +{ + int n; + if ((size_t)s->buf_used + 3 > sizeof(s->buffer)) + stbiw__write_flush(s); + n = s->buf_used; + s->buf_used = n+3; + s->buffer[n+0] = a; + s->buffer[n+1] = b; + s->buffer[n+2] = c; +} + +static void stbiw__write_pixel(stbi__write_context *s, int rgb_dir, int comp, int write_alpha, int expand_mono, unsigned char *d) +{ + unsigned char bg[3] = { 255, 0, 255}, px[3]; + int k; + + if (write_alpha < 0) + stbiw__write1(s, d[comp - 1]); + + switch (comp) { + case 2: // 2 pixels = mono + alpha, alpha is written separately, so same as 1-channel case + case 1: + if (expand_mono) + stbiw__write3(s, d[0], d[0], d[0]); // monochrome bmp + else + stbiw__write1(s, d[0]); // monochrome TGA + break; + case 4: + if (!write_alpha) { + // composite against pink background + for (k = 0; k < 3; ++k) + px[k] = bg[k] + ((d[k] - bg[k]) * d[3]) / 255; + stbiw__write3(s, px[1 - rgb_dir], px[1], px[1 + rgb_dir]); + break; + } + /* FALLTHROUGH */ + case 3: + stbiw__write3(s, d[1 - rgb_dir], d[1], d[1 + rgb_dir]); + break; + } + if (write_alpha > 0) + stbiw__write1(s, d[comp - 1]); +} + +static void stbiw__write_pixels(stbi__write_context *s, int rgb_dir, int vdir, int x, int y, int comp, void *data, int write_alpha, int scanline_pad, int expand_mono) +{ + stbiw_uint32 zero = 0; + int i,j, j_end; + + if (y <= 0) + return; + + if (stbi__flip_vertically_on_write) + vdir *= -1; + + if (vdir < 0) { + j_end = -1; j = y-1; + } else { + j_end = y; j = 0; + } + + for (; j != j_end; j += vdir) { + for (i=0; i < x; ++i) { + unsigned char *d = (unsigned char *) data + (j*x+i)*comp; + stbiw__write_pixel(s, rgb_dir, comp, write_alpha, expand_mono, d); + } + stbiw__write_flush(s); + s->func(s->context, &zero, scanline_pad); + } +} + +static int stbiw__outfile(stbi__write_context *s, int rgb_dir, int vdir, int x, int y, int comp, int expand_mono, void *data, int alpha, int pad, const char *fmt, ...) +{ + if (y < 0 || x < 0) { + return 0; + } else { + va_list v; + va_start(v, fmt); + stbiw__writefv(s, fmt, v); + va_end(v); + stbiw__write_pixels(s,rgb_dir,vdir,x,y,comp,data,alpha,pad, expand_mono); + return 1; + } +} + +static int stbi_write_bmp_core(stbi__write_context *s, int x, int y, int comp, const void *data) +{ + if (comp != 4) { + // write RGB bitmap + int pad = (-x*3) & 3; + return stbiw__outfile(s,-1,-1,x,y,comp,1,(void *) data,0,pad, + "11 4 22 4" "4 44 22 444444", + 'B', 'M', 14+40+(x*3+pad)*y, 0,0, 14+40, // file header + 40, x,y, 1,24, 0,0,0,0,0,0); // bitmap header + } else { + // RGBA bitmaps need a v4 header + // use BI_BITFIELDS mode with 32bpp and alpha mask + // (straight BI_RGB with alpha mask doesn't work in most readers) + return stbiw__outfile(s,-1,-1,x,y,comp,1,(void *)data,1,0, + "11 4 22 4" "4 44 22 444444 4444 4 444 444 444 444", + 'B', 'M', 14+108+x*y*4, 0, 0, 14+108, // file header + 108, x,y, 1,32, 3,0,0,0,0,0, 0xff0000,0xff00,0xff,0xff000000u, 0, 0,0,0, 0,0,0, 0,0,0, 0,0,0); // bitmap V4 header + } +} + +STBIWDEF int stbi_write_bmp_to_func(stbi_write_func *func, void *context, int x, int y, int comp, const void *data) +{ + stbi__write_context s = { 0 }; + stbi__start_write_callbacks(&s, func, context); + return stbi_write_bmp_core(&s, x, y, comp, data); +} + +#ifndef STBI_WRITE_NO_STDIO +STBIWDEF int stbi_write_bmp(char const *filename, int x, int y, int comp, const void *data) +{ + stbi__write_context s = { 0 }; + if (stbi__start_write_file(&s,filename)) { + int r = stbi_write_bmp_core(&s, x, y, comp, data); + stbi__end_write_file(&s); + return r; + } else + return 0; +} +#endif //!STBI_WRITE_NO_STDIO + +static int stbi_write_tga_core(stbi__write_context *s, int x, int y, int comp, void *data) +{ + int has_alpha = (comp == 2 || comp == 4); + int colorbytes = has_alpha ? comp-1 : comp; + int format = colorbytes < 2 ? 3 : 2; // 3 color channels (RGB/RGBA) = 2, 1 color channel (Y/YA) = 3 + + if (y < 0 || x < 0) + return 0; + + if (!stbi_write_tga_with_rle) { + return stbiw__outfile(s, -1, -1, x, y, comp, 0, (void *) data, has_alpha, 0, + "111 221 2222 11", 0, 0, format, 0, 0, 0, 0, 0, x, y, (colorbytes + has_alpha) * 8, has_alpha * 8); + } else { + int i,j,k; + int jend, jdir; + + stbiw__writef(s, "111 221 2222 11", 0,0,format+8, 0,0,0, 0,0,x,y, (colorbytes + has_alpha) * 8, has_alpha * 8); + + if (stbi__flip_vertically_on_write) { + j = 0; + jend = y; + jdir = 1; + } else { + j = y-1; + jend = -1; + jdir = -1; + } + for (; j != jend; j += jdir) { + unsigned char *row = (unsigned char *) data + j * x * comp; + int len; + + for (i = 0; i < x; i += len) { + unsigned char *begin = row + i * comp; + int diff = 1; + len = 1; + + if (i < x - 1) { + ++len; + diff = memcmp(begin, row + (i + 1) * comp, comp); + if (diff) { + const unsigned char *prev = begin; + for (k = i + 2; k < x && len < 128; ++k) { + if (memcmp(prev, row + k * comp, comp)) { + prev += comp; + ++len; + } else { + --len; + break; + } + } + } else { + for (k = i + 2; k < x && len < 128; ++k) { + if (!memcmp(begin, row + k * comp, comp)) { + ++len; + } else { + break; + } + } + } + } + + if (diff) { + unsigned char header = STBIW_UCHAR(len - 1); + stbiw__write1(s, header); + for (k = 0; k < len; ++k) { + stbiw__write_pixel(s, -1, comp, has_alpha, 0, begin + k * comp); + } + } else { + unsigned char header = STBIW_UCHAR(len - 129); + stbiw__write1(s, header); + stbiw__write_pixel(s, -1, comp, has_alpha, 0, begin); + } + } + } + stbiw__write_flush(s); + } + return 1; +} + +STBIWDEF int stbi_write_tga_to_func(stbi_write_func *func, void *context, int x, int y, int comp, const void *data) +{ + stbi__write_context s = { 0 }; + stbi__start_write_callbacks(&s, func, context); + return stbi_write_tga_core(&s, x, y, comp, (void *) data); +} + +#ifndef STBI_WRITE_NO_STDIO +STBIWDEF int stbi_write_tga(char const *filename, int x, int y, int comp, const void *data) +{ + stbi__write_context s = { 0 }; + if (stbi__start_write_file(&s,filename)) { + int r = stbi_write_tga_core(&s, x, y, comp, (void *) data); + stbi__end_write_file(&s); + return r; + } else + return 0; +} +#endif + +// ************************************************************************************************* +// Radiance RGBE HDR writer +// by Baldur Karlsson + +#define stbiw__max(a, b) ((a) > (b) ? (a) : (b)) + +#ifndef STBI_WRITE_NO_STDIO + +static void stbiw__linear_to_rgbe(unsigned char *rgbe, float *linear) +{ + int exponent; + float maxcomp = stbiw__max(linear[0], stbiw__max(linear[1], linear[2])); + + if (maxcomp < 1e-32f) { + rgbe[0] = rgbe[1] = rgbe[2] = rgbe[3] = 0; + } else { + float normalize = (float) frexp(maxcomp, &exponent) * 256.0f/maxcomp; + + rgbe[0] = (unsigned char)(linear[0] * normalize); + rgbe[1] = (unsigned char)(linear[1] * normalize); + rgbe[2] = (unsigned char)(linear[2] * normalize); + rgbe[3] = (unsigned char)(exponent + 128); + } +} + +static void stbiw__write_run_data(stbi__write_context *s, int length, unsigned char databyte) +{ + unsigned char lengthbyte = STBIW_UCHAR(length+128); + STBIW_ASSERT(length+128 <= 255); + s->func(s->context, &lengthbyte, 1); + s->func(s->context, &databyte, 1); +} + +static void stbiw__write_dump_data(stbi__write_context *s, int length, unsigned char *data) +{ + unsigned char lengthbyte = STBIW_UCHAR(length); + STBIW_ASSERT(length <= 128); // inconsistent with spec but consistent with official code + s->func(s->context, &lengthbyte, 1); + s->func(s->context, data, length); +} + +static void stbiw__write_hdr_scanline(stbi__write_context *s, int width, int ncomp, unsigned char *scratch, float *scanline) +{ + unsigned char scanlineheader[4] = { 2, 2, 0, 0 }; + unsigned char rgbe[4]; + float linear[3]; + int x; + + scanlineheader[2] = (width&0xff00)>>8; + scanlineheader[3] = (width&0x00ff); + + /* skip RLE for images too small or large */ + if (width < 8 || width >= 32768) { + for (x=0; x < width; x++) { + switch (ncomp) { + case 4: /* fallthrough */ + case 3: linear[2] = scanline[x*ncomp + 2]; + linear[1] = scanline[x*ncomp + 1]; + linear[0] = scanline[x*ncomp + 0]; + break; + default: + linear[0] = linear[1] = linear[2] = scanline[x*ncomp + 0]; + break; + } + stbiw__linear_to_rgbe(rgbe, linear); + s->func(s->context, rgbe, 4); + } + } else { + int c,r; + /* encode into scratch buffer */ + for (x=0; x < width; x++) { + switch(ncomp) { + case 4: /* fallthrough */ + case 3: linear[2] = scanline[x*ncomp + 2]; + linear[1] = scanline[x*ncomp + 1]; + linear[0] = scanline[x*ncomp + 0]; + break; + default: + linear[0] = linear[1] = linear[2] = scanline[x*ncomp + 0]; + break; + } + stbiw__linear_to_rgbe(rgbe, linear); + scratch[x + width*0] = rgbe[0]; + scratch[x + width*1] = rgbe[1]; + scratch[x + width*2] = rgbe[2]; + scratch[x + width*3] = rgbe[3]; + } + + s->func(s->context, scanlineheader, 4); + + /* RLE each component separately */ + for (c=0; c < 4; c++) { + unsigned char *comp = &scratch[width*c]; + + x = 0; + while (x < width) { + // find first run + r = x; + while (r+2 < width) { + if (comp[r] == comp[r+1] && comp[r] == comp[r+2]) + break; + ++r; + } + if (r+2 >= width) + r = width; + // dump up to first run + while (x < r) { + int len = r-x; + if (len > 128) len = 128; + stbiw__write_dump_data(s, len, &comp[x]); + x += len; + } + // if there's a run, output it + if (r+2 < width) { // same test as what we break out of in search loop, so only true if we break'd + // find next byte after run + while (r < width && comp[r] == comp[x]) + ++r; + // output run up to r + while (x < r) { + int len = r-x; + if (len > 127) len = 127; + stbiw__write_run_data(s, len, comp[x]); + x += len; + } + } + } + } + } +} + +static int stbi_write_hdr_core(stbi__write_context *s, int x, int y, int comp, float *data) +{ + if (y <= 0 || x <= 0 || data == NULL) + return 0; + else { + // Each component is stored separately. Allocate scratch space for full output scanline. + unsigned char *scratch = (unsigned char *) STBIW_MALLOC(x*4); + int i, len; + char buffer[128]; + char header[] = "#?RADIANCE\n# Written by stb_image_write.h\nFORMAT=32-bit_rle_rgbe\n"; + s->func(s->context, header, sizeof(header)-1); + +#ifdef __STDC_LIB_EXT1__ + len = sprintf_s(buffer, sizeof(buffer), "EXPOSURE= 1.0000000000000\n\n-Y %d +X %d\n", y, x); +#else + len = sprintf(buffer, "EXPOSURE= 1.0000000000000\n\n-Y %d +X %d\n", y, x); +#endif + s->func(s->context, buffer, len); + + for(i=0; i < y; i++) + stbiw__write_hdr_scanline(s, x, comp, scratch, data + comp*x*(stbi__flip_vertically_on_write ? y-1-i : i)); + STBIW_FREE(scratch); + return 1; + } +} + +STBIWDEF int stbi_write_hdr_to_func(stbi_write_func *func, void *context, int x, int y, int comp, const float *data) +{ + stbi__write_context s = { 0 }; + stbi__start_write_callbacks(&s, func, context); + return stbi_write_hdr_core(&s, x, y, comp, (float *) data); +} + +STBIWDEF int stbi_write_hdr(char const *filename, int x, int y, int comp, const float *data) +{ + stbi__write_context s = { 0 }; + if (stbi__start_write_file(&s,filename)) { + int r = stbi_write_hdr_core(&s, x, y, comp, (float *) data); + stbi__end_write_file(&s); + return r; + } else + return 0; +} +#endif // STBI_WRITE_NO_STDIO + + +////////////////////////////////////////////////////////////////////////////// +// +// PNG writer +// + +#ifndef STBIW_ZLIB_COMPRESS +// stretchy buffer; stbiw__sbpush() == vector<>::push_back() -- stbiw__sbcount() == vector<>::size() +#define stbiw__sbraw(a) ((int *) (void *) (a) - 2) +#define stbiw__sbm(a) stbiw__sbraw(a)[0] +#define stbiw__sbn(a) stbiw__sbraw(a)[1] + +#define stbiw__sbneedgrow(a,n) ((a)==0 || stbiw__sbn(a)+n >= stbiw__sbm(a)) +#define stbiw__sbmaybegrow(a,n) (stbiw__sbneedgrow(a,(n)) ? stbiw__sbgrow(a,n) : 0) +#define stbiw__sbgrow(a,n) stbiw__sbgrowf((void **) &(a), (n), sizeof(*(a))) + +#define stbiw__sbpush(a, v) (stbiw__sbmaybegrow(a,1), (a)[stbiw__sbn(a)++] = (v)) +#define stbiw__sbcount(a) ((a) ? stbiw__sbn(a) : 0) +#define stbiw__sbfree(a) ((a) ? STBIW_FREE(stbiw__sbraw(a)),0 : 0) + +static void *stbiw__sbgrowf(void **arr, int increment, int itemsize) +{ + int m = *arr ? 2*stbiw__sbm(*arr)+increment : increment+1; + void *p = STBIW_REALLOC_SIZED(*arr ? stbiw__sbraw(*arr) : 0, *arr ? (stbiw__sbm(*arr)*itemsize + sizeof(int)*2) : 0, itemsize * m + sizeof(int)*2); + STBIW_ASSERT(p); + if (p) { + if (!*arr) ((int *) p)[1] = 0; + *arr = (void *) ((int *) p + 2); + stbiw__sbm(*arr) = m; + } + return *arr; +} + +static unsigned char *stbiw__zlib_flushf(unsigned char *data, unsigned int *bitbuffer, int *bitcount) +{ + while (*bitcount >= 8) { + stbiw__sbpush(data, STBIW_UCHAR(*bitbuffer)); + *bitbuffer >>= 8; + *bitcount -= 8; + } + return data; +} + +static int stbiw__zlib_bitrev(int code, int codebits) +{ + int res=0; + while (codebits--) { + res = (res << 1) | (code & 1); + code >>= 1; + } + return res; +} + +static unsigned int stbiw__zlib_countm(unsigned char *a, unsigned char *b, int limit) +{ + int i; + for (i=0; i < limit && i < 258; ++i) + if (a[i] != b[i]) break; + return i; +} + +static unsigned int stbiw__zhash(unsigned char *data) +{ + stbiw_uint32 hash = data[0] + (data[1] << 8) + (data[2] << 16); + hash ^= hash << 3; + hash += hash >> 5; + hash ^= hash << 4; + hash += hash >> 17; + hash ^= hash << 25; + hash += hash >> 6; + return hash; +} + +#define stbiw__zlib_flush() (out = stbiw__zlib_flushf(out, &bitbuf, &bitcount)) +#define stbiw__zlib_add(code,codebits) \ + (bitbuf |= (code) << bitcount, bitcount += (codebits), stbiw__zlib_flush()) +#define stbiw__zlib_huffa(b,c) stbiw__zlib_add(stbiw__zlib_bitrev(b,c),c) +// default huffman tables +#define stbiw__zlib_huff1(n) stbiw__zlib_huffa(0x30 + (n), 8) +#define stbiw__zlib_huff2(n) stbiw__zlib_huffa(0x190 + (n)-144, 9) +#define stbiw__zlib_huff3(n) stbiw__zlib_huffa(0 + (n)-256,7) +#define stbiw__zlib_huff4(n) stbiw__zlib_huffa(0xc0 + (n)-280,8) +#define stbiw__zlib_huff(n) ((n) <= 143 ? stbiw__zlib_huff1(n) : (n) <= 255 ? stbiw__zlib_huff2(n) : (n) <= 279 ? stbiw__zlib_huff3(n) : stbiw__zlib_huff4(n)) +#define stbiw__zlib_huffb(n) ((n) <= 143 ? stbiw__zlib_huff1(n) : stbiw__zlib_huff2(n)) + +#define stbiw__ZHASH 16384 + +#endif // STBIW_ZLIB_COMPRESS + +STBIWDEF unsigned char * stbi_zlib_compress(unsigned char *data, int data_len, int *out_len, int quality) +{ +#ifdef STBIW_ZLIB_COMPRESS + // user provided a zlib compress implementation, use that + return STBIW_ZLIB_COMPRESS(data, data_len, out_len, quality); +#else // use builtin + static unsigned short lengthc[] = { 3,4,5,6,7,8,9,10,11,13,15,17,19,23,27,31,35,43,51,59,67,83,99,115,131,163,195,227,258, 259 }; + static unsigned char lengtheb[]= { 0,0,0,0,0,0,0, 0, 1, 1, 1, 1, 2, 2, 2, 2, 3, 3, 3, 3, 4, 4, 4, 4, 5, 5, 5, 5, 0 }; + static unsigned short distc[] = { 1,2,3,4,5,7,9,13,17,25,33,49,65,97,129,193,257,385,513,769,1025,1537,2049,3073,4097,6145,8193,12289,16385,24577, 32768 }; + static unsigned char disteb[] = { 0,0,0,0,1,1,2,2,3,3,4,4,5,5,6,6,7,7,8,8,9,9,10,10,11,11,12,12,13,13 }; + unsigned int bitbuf=0; + int i,j, bitcount=0; + unsigned char *out = NULL; + unsigned char ***hash_table = (unsigned char***) STBIW_MALLOC(stbiw__ZHASH * sizeof(unsigned char**)); + if (hash_table == NULL) + return NULL; + if (quality < 5) quality = 5; + + stbiw__sbpush(out, 0x78); // DEFLATE 32K window + stbiw__sbpush(out, 0x5e); // FLEVEL = 1 + stbiw__zlib_add(1,1); // BFINAL = 1 + stbiw__zlib_add(1,2); // BTYPE = 1 -- fixed huffman + + for (i=0; i < stbiw__ZHASH; ++i) + hash_table[i] = NULL; + + i=0; + while (i < data_len-3) { + // hash next 3 bytes of data to be compressed + int h = stbiw__zhash(data+i)&(stbiw__ZHASH-1), best=3; + unsigned char *bestloc = 0; + unsigned char **hlist = hash_table[h]; + int n = stbiw__sbcount(hlist); + for (j=0; j < n; ++j) { + if (hlist[j]-data > i-32768) { // if entry lies within window + int d = stbiw__zlib_countm(hlist[j], data+i, data_len-i); + if (d >= best) { best=d; bestloc=hlist[j]; } + } + } + // when hash table entry is too long, delete half the entries + if (hash_table[h] && stbiw__sbn(hash_table[h]) == 2*quality) { + STBIW_MEMMOVE(hash_table[h], hash_table[h]+quality, sizeof(hash_table[h][0])*quality); + stbiw__sbn(hash_table[h]) = quality; + } + stbiw__sbpush(hash_table[h],data+i); + + if (bestloc) { + // "lazy matching" - check match at *next* byte, and if it's better, do cur byte as literal + h = stbiw__zhash(data+i+1)&(stbiw__ZHASH-1); + hlist = hash_table[h]; + n = stbiw__sbcount(hlist); + for (j=0; j < n; ++j) { + if (hlist[j]-data > i-32767) { + int e = stbiw__zlib_countm(hlist[j], data+i+1, data_len-i-1); + if (e > best) { // if next match is better, bail on current match + bestloc = NULL; + break; + } + } + } + } + + if (bestloc) { + int d = (int) (data+i - bestloc); // distance back + STBIW_ASSERT(d <= 32767 && best <= 258); + for (j=0; best > lengthc[j+1]-1; ++j); + stbiw__zlib_huff(j+257); + if (lengtheb[j]) stbiw__zlib_add(best - lengthc[j], lengtheb[j]); + for (j=0; d > distc[j+1]-1; ++j); + stbiw__zlib_add(stbiw__zlib_bitrev(j,5),5); + if (disteb[j]) stbiw__zlib_add(d - distc[j], disteb[j]); + i += best; + } else { + stbiw__zlib_huffb(data[i]); + ++i; + } + } + // write out final bytes + for (;i < data_len; ++i) + stbiw__zlib_huffb(data[i]); + stbiw__zlib_huff(256); // end of block + // pad with 0 bits to byte boundary + while (bitcount) + stbiw__zlib_add(0,1); + + for (i=0; i < stbiw__ZHASH; ++i) + (void) stbiw__sbfree(hash_table[i]); + STBIW_FREE(hash_table); + + // store uncompressed instead if compression was worse + if (stbiw__sbn(out) > data_len + 2 + ((data_len+32766)/32767)*5) { + stbiw__sbn(out) = 2; // truncate to DEFLATE 32K window and FLEVEL = 1 + for (j = 0; j < data_len;) { + int blocklen = data_len - j; + if (blocklen > 32767) blocklen = 32767; + stbiw__sbpush(out, data_len - j == blocklen); // BFINAL = ?, BTYPE = 0 -- no compression + stbiw__sbpush(out, STBIW_UCHAR(blocklen)); // LEN + stbiw__sbpush(out, STBIW_UCHAR(blocklen >> 8)); + stbiw__sbpush(out, STBIW_UCHAR(~blocklen)); // NLEN + stbiw__sbpush(out, STBIW_UCHAR(~blocklen >> 8)); + memcpy(out+stbiw__sbn(out), data+j, blocklen); + stbiw__sbn(out) += blocklen; + j += blocklen; + } + } + + { + // compute adler32 on input + unsigned int s1=1, s2=0; + int blocklen = (int) (data_len % 5552); + j=0; + while (j < data_len) { + for (i=0; i < blocklen; ++i) { s1 += data[j+i]; s2 += s1; } + s1 %= 65521; s2 %= 65521; + j += blocklen; + blocklen = 5552; + } + stbiw__sbpush(out, STBIW_UCHAR(s2 >> 8)); + stbiw__sbpush(out, STBIW_UCHAR(s2)); + stbiw__sbpush(out, STBIW_UCHAR(s1 >> 8)); + stbiw__sbpush(out, STBIW_UCHAR(s1)); + } + *out_len = stbiw__sbn(out); + // make returned pointer freeable + STBIW_MEMMOVE(stbiw__sbraw(out), out, *out_len); + return (unsigned char *) stbiw__sbraw(out); +#endif // STBIW_ZLIB_COMPRESS +} + +static unsigned int stbiw__crc32(unsigned char *buffer, int len) +{ +#ifdef STBIW_CRC32 + return STBIW_CRC32(buffer, len); +#else + static unsigned int crc_table[256] = + { + 0x00000000, 0x77073096, 0xEE0E612C, 0x990951BA, 0x076DC419, 0x706AF48F, 0xE963A535, 0x9E6495A3, + 0x0eDB8832, 0x79DCB8A4, 0xE0D5E91E, 0x97D2D988, 0x09B64C2B, 0x7EB17CBD, 0xE7B82D07, 0x90BF1D91, + 0x1DB71064, 0x6AB020F2, 0xF3B97148, 0x84BE41DE, 0x1ADAD47D, 0x6DDDE4EB, 0xF4D4B551, 0x83D385C7, + 0x136C9856, 0x646BA8C0, 0xFD62F97A, 0x8A65C9EC, 0x14015C4F, 0x63066CD9, 0xFA0F3D63, 0x8D080DF5, + 0x3B6E20C8, 0x4C69105E, 0xD56041E4, 0xA2677172, 0x3C03E4D1, 0x4B04D447, 0xD20D85FD, 0xA50AB56B, + 0x35B5A8FA, 0x42B2986C, 0xDBBBC9D6, 0xACBCF940, 0x32D86CE3, 0x45DF5C75, 0xDCD60DCF, 0xABD13D59, + 0x26D930AC, 0x51DE003A, 0xC8D75180, 0xBFD06116, 0x21B4F4B5, 0x56B3C423, 0xCFBA9599, 0xB8BDA50F, + 0x2802B89E, 0x5F058808, 0xC60CD9B2, 0xB10BE924, 0x2F6F7C87, 0x58684C11, 0xC1611DAB, 0xB6662D3D, + 0x76DC4190, 0x01DB7106, 0x98D220BC, 0xEFD5102A, 0x71B18589, 0x06B6B51F, 0x9FBFE4A5, 0xE8B8D433, + 0x7807C9A2, 0x0F00F934, 0x9609A88E, 0xE10E9818, 0x7F6A0DBB, 0x086D3D2D, 0x91646C97, 0xE6635C01, + 0x6B6B51F4, 0x1C6C6162, 0x856530D8, 0xF262004E, 0x6C0695ED, 0x1B01A57B, 0x8208F4C1, 0xF50FC457, + 0x65B0D9C6, 0x12B7E950, 0x8BBEB8EA, 0xFCB9887C, 0x62DD1DDF, 0x15DA2D49, 0x8CD37CF3, 0xFBD44C65, + 0x4DB26158, 0x3AB551CE, 0xA3BC0074, 0xD4BB30E2, 0x4ADFA541, 0x3DD895D7, 0xA4D1C46D, 0xD3D6F4FB, + 0x4369E96A, 0x346ED9FC, 0xAD678846, 0xDA60B8D0, 0x44042D73, 0x33031DE5, 0xAA0A4C5F, 0xDD0D7CC9, + 0x5005713C, 0x270241AA, 0xBE0B1010, 0xC90C2086, 0x5768B525, 0x206F85B3, 0xB966D409, 0xCE61E49F, + 0x5EDEF90E, 0x29D9C998, 0xB0D09822, 0xC7D7A8B4, 0x59B33D17, 0x2EB40D81, 0xB7BD5C3B, 0xC0BA6CAD, + 0xEDB88320, 0x9ABFB3B6, 0x03B6E20C, 0x74B1D29A, 0xEAD54739, 0x9DD277AF, 0x04DB2615, 0x73DC1683, + 0xE3630B12, 0x94643B84, 0x0D6D6A3E, 0x7A6A5AA8, 0xE40ECF0B, 0x9309FF9D, 0x0A00AE27, 0x7D079EB1, + 0xF00F9344, 0x8708A3D2, 0x1E01F268, 0x6906C2FE, 0xF762575D, 0x806567CB, 0x196C3671, 0x6E6B06E7, + 0xFED41B76, 0x89D32BE0, 0x10DA7A5A, 0x67DD4ACC, 0xF9B9DF6F, 0x8EBEEFF9, 0x17B7BE43, 0x60B08ED5, + 0xD6D6A3E8, 0xA1D1937E, 0x38D8C2C4, 0x4FDFF252, 0xD1BB67F1, 0xA6BC5767, 0x3FB506DD, 0x48B2364B, + 0xD80D2BDA, 0xAF0A1B4C, 0x36034AF6, 0x41047A60, 0xDF60EFC3, 0xA867DF55, 0x316E8EEF, 0x4669BE79, + 0xCB61B38C, 0xBC66831A, 0x256FD2A0, 0x5268E236, 0xCC0C7795, 0xBB0B4703, 0x220216B9, 0x5505262F, + 0xC5BA3BBE, 0xB2BD0B28, 0x2BB45A92, 0x5CB36A04, 0xC2D7FFA7, 0xB5D0CF31, 0x2CD99E8B, 0x5BDEAE1D, + 0x9B64C2B0, 0xEC63F226, 0x756AA39C, 0x026D930A, 0x9C0906A9, 0xEB0E363F, 0x72076785, 0x05005713, + 0x95BF4A82, 0xE2B87A14, 0x7BB12BAE, 0x0CB61B38, 0x92D28E9B, 0xE5D5BE0D, 0x7CDCEFB7, 0x0BDBDF21, + 0x86D3D2D4, 0xF1D4E242, 0x68DDB3F8, 0x1FDA836E, 0x81BE16CD, 0xF6B9265B, 0x6FB077E1, 0x18B74777, + 0x88085AE6, 0xFF0F6A70, 0x66063BCA, 0x11010B5C, 0x8F659EFF, 0xF862AE69, 0x616BFFD3, 0x166CCF45, + 0xA00AE278, 0xD70DD2EE, 0x4E048354, 0x3903B3C2, 0xA7672661, 0xD06016F7, 0x4969474D, 0x3E6E77DB, + 0xAED16A4A, 0xD9D65ADC, 0x40DF0B66, 0x37D83BF0, 0xA9BCAE53, 0xDEBB9EC5, 0x47B2CF7F, 0x30B5FFE9, + 0xBDBDF21C, 0xCABAC28A, 0x53B39330, 0x24B4A3A6, 0xBAD03605, 0xCDD70693, 0x54DE5729, 0x23D967BF, + 0xB3667A2E, 0xC4614AB8, 0x5D681B02, 0x2A6F2B94, 0xB40BBE37, 0xC30C8EA1, 0x5A05DF1B, 0x2D02EF8D + }; + + unsigned int crc = ~0u; + int i; + for (i=0; i < len; ++i) + crc = (crc >> 8) ^ crc_table[buffer[i] ^ (crc & 0xff)]; + return ~crc; +#endif +} + +#define stbiw__wpng4(o,a,b,c,d) ((o)[0]=STBIW_UCHAR(a),(o)[1]=STBIW_UCHAR(b),(o)[2]=STBIW_UCHAR(c),(o)[3]=STBIW_UCHAR(d),(o)+=4) +#define stbiw__wp32(data,v) stbiw__wpng4(data, (v)>>24,(v)>>16,(v)>>8,(v)); +#define stbiw__wptag(data,s) stbiw__wpng4(data, s[0],s[1],s[2],s[3]) + +static void stbiw__wpcrc(unsigned char **data, int len) +{ + unsigned int crc = stbiw__crc32(*data - len - 4, len+4); + stbiw__wp32(*data, crc); +} + +static unsigned char stbiw__paeth(int a, int b, int c) +{ + int p = a + b - c, pa = abs(p-a), pb = abs(p-b), pc = abs(p-c); + if (pa <= pb && pa <= pc) return STBIW_UCHAR(a); + if (pb <= pc) return STBIW_UCHAR(b); + return STBIW_UCHAR(c); +} + +// @OPTIMIZE: provide an option that always forces left-predict or paeth predict +static void stbiw__encode_png_line(unsigned char *pixels, int stride_bytes, int width, int height, int y, int n, int filter_type, signed char *line_buffer) +{ + static int mapping[] = { 0,1,2,3,4 }; + static int firstmap[] = { 0,1,0,5,6 }; + int *mymap = (y != 0) ? mapping : firstmap; + int i; + int type = mymap[filter_type]; + unsigned char *z = pixels + stride_bytes * (stbi__flip_vertically_on_write ? height-1-y : y); + int signed_stride = stbi__flip_vertically_on_write ? -stride_bytes : stride_bytes; + + if (type==0) { + memcpy(line_buffer, z, width*n); + return; + } + + // first loop isn't optimized since it's just one pixel + for (i = 0; i < n; ++i) { + switch (type) { + case 1: line_buffer[i] = z[i]; break; + case 2: line_buffer[i] = z[i] - z[i-signed_stride]; break; + case 3: line_buffer[i] = z[i] - (z[i-signed_stride]>>1); break; + case 4: line_buffer[i] = (signed char) (z[i] - stbiw__paeth(0,z[i-signed_stride],0)); break; + case 5: line_buffer[i] = z[i]; break; + case 6: line_buffer[i] = z[i]; break; + } + } + switch (type) { + case 1: for (i=n; i < width*n; ++i) line_buffer[i] = z[i] - z[i-n]; break; + case 2: for (i=n; i < width*n; ++i) line_buffer[i] = z[i] - z[i-signed_stride]; break; + case 3: for (i=n; i < width*n; ++i) line_buffer[i] = z[i] - ((z[i-n] + z[i-signed_stride])>>1); break; + case 4: for (i=n; i < width*n; ++i) line_buffer[i] = z[i] - stbiw__paeth(z[i-n], z[i-signed_stride], z[i-signed_stride-n]); break; + case 5: for (i=n; i < width*n; ++i) line_buffer[i] = z[i] - (z[i-n]>>1); break; + case 6: for (i=n; i < width*n; ++i) line_buffer[i] = z[i] - stbiw__paeth(z[i-n], 0,0); break; + } +} + +STBIWDEF unsigned char *stbi_write_png_to_mem(const unsigned char *pixels, int stride_bytes, int x, int y, int n, int *out_len) +{ + int force_filter = stbi_write_force_png_filter; + int ctype[5] = { -1, 0, 4, 2, 6 }; + unsigned char sig[8] = { 137,80,78,71,13,10,26,10 }; + unsigned char *out,*o, *filt, *zlib; + signed char *line_buffer; + int j,zlen; + + if (stride_bytes == 0) + stride_bytes = x * n; + + if (force_filter >= 5) { + force_filter = -1; + } + + filt = (unsigned char *) STBIW_MALLOC((x*n+1) * y); if (!filt) return 0; + line_buffer = (signed char *) STBIW_MALLOC(x * n); if (!line_buffer) { STBIW_FREE(filt); return 0; } + for (j=0; j < y; ++j) { + int filter_type; + if (force_filter > -1) { + filter_type = force_filter; + stbiw__encode_png_line((unsigned char*)(pixels), stride_bytes, x, y, j, n, force_filter, line_buffer); + } else { // Estimate the best filter by running through all of them: + int best_filter = 0, best_filter_val = 0x7fffffff, est, i; + for (filter_type = 0; filter_type < 5; filter_type++) { + stbiw__encode_png_line((unsigned char*)(pixels), stride_bytes, x, y, j, n, filter_type, line_buffer); + + // Estimate the entropy of the line using this filter; the less, the better. + est = 0; + for (i = 0; i < x*n; ++i) { + est += abs((signed char) line_buffer[i]); + } + if (est < best_filter_val) { + best_filter_val = est; + best_filter = filter_type; + } + } + if (filter_type != best_filter) { // If the last iteration already got us the best filter, don't redo it + stbiw__encode_png_line((unsigned char*)(pixels), stride_bytes, x, y, j, n, best_filter, line_buffer); + filter_type = best_filter; + } + } + // when we get here, filter_type contains the filter type, and line_buffer contains the data + filt[j*(x*n+1)] = (unsigned char) filter_type; + STBIW_MEMMOVE(filt+j*(x*n+1)+1, line_buffer, x*n); + } + STBIW_FREE(line_buffer); + zlib = stbi_zlib_compress(filt, y*( x*n+1), &zlen, stbi_write_png_compression_level); + STBIW_FREE(filt); + if (!zlib) return 0; + + // each tag requires 12 bytes of overhead + out = (unsigned char *) STBIW_MALLOC(8 + 12+13 + 12+zlen + 12); + if (!out) return 0; + *out_len = 8 + 12+13 + 12+zlen + 12; + + o=out; + STBIW_MEMMOVE(o,sig,8); o+= 8; + stbiw__wp32(o, 13); // header length + stbiw__wptag(o, "IHDR"); + stbiw__wp32(o, x); + stbiw__wp32(o, y); + *o++ = 8; + *o++ = STBIW_UCHAR(ctype[n]); + *o++ = 0; + *o++ = 0; + *o++ = 0; + stbiw__wpcrc(&o,13); + + stbiw__wp32(o, zlen); + stbiw__wptag(o, "IDAT"); + STBIW_MEMMOVE(o, zlib, zlen); + o += zlen; + STBIW_FREE(zlib); + stbiw__wpcrc(&o, zlen); + + stbiw__wp32(o,0); + stbiw__wptag(o, "IEND"); + stbiw__wpcrc(&o,0); + + STBIW_ASSERT(o == out + *out_len); + + return out; +} + +#ifndef STBI_WRITE_NO_STDIO +STBIWDEF int stbi_write_png(char const *filename, int x, int y, int comp, const void *data, int stride_bytes) +{ + FILE *f; + int len; + unsigned char *png = stbi_write_png_to_mem((const unsigned char *) data, stride_bytes, x, y, comp, &len); + if (png == NULL) return 0; + + f = stbiw__fopen(filename, "wb"); + if (!f) { STBIW_FREE(png); return 0; } + fwrite(png, 1, len, f); + fclose(f); + STBIW_FREE(png); + return 1; +} +#endif + +STBIWDEF int stbi_write_png_to_func(stbi_write_func *func, void *context, int x, int y, int comp, const void *data, int stride_bytes) +{ + int len; + unsigned char *png = stbi_write_png_to_mem((const unsigned char *) data, stride_bytes, x, y, comp, &len); + if (png == NULL) return 0; + func(context, png, len); + STBIW_FREE(png); + return 1; +} + + +/* *************************************************************************** + * + * JPEG writer + * + * This is based on Jon Olick's jo_jpeg.cpp: + * public domain Simple, Minimalistic JPEG writer - http://www.jonolick.com/code.html + */ + +static const unsigned char stbiw__jpg_ZigZag[] = { 0,1,5,6,14,15,27,28,2,4,7,13,16,26,29,42,3,8,12,17,25,30,41,43,9,11,18, + 24,31,40,44,53,10,19,23,32,39,45,52,54,20,22,33,38,46,51,55,60,21,34,37,47,50,56,59,61,35,36,48,49,57,58,62,63 }; + +static void stbiw__jpg_writeBits(stbi__write_context *s, int *bitBufP, int *bitCntP, const unsigned short *bs) { + int bitBuf = *bitBufP, bitCnt = *bitCntP; + bitCnt += bs[1]; + bitBuf |= bs[0] << (24 - bitCnt); + while(bitCnt >= 8) { + unsigned char c = (bitBuf >> 16) & 255; + stbiw__putc(s, c); + if(c == 255) { + stbiw__putc(s, 0); + } + bitBuf <<= 8; + bitCnt -= 8; + } + *bitBufP = bitBuf; + *bitCntP = bitCnt; +} + +static void stbiw__jpg_DCT(float *d0p, float *d1p, float *d2p, float *d3p, float *d4p, float *d5p, float *d6p, float *d7p) { + float d0 = *d0p, d1 = *d1p, d2 = *d2p, d3 = *d3p, d4 = *d4p, d5 = *d5p, d6 = *d6p, d7 = *d7p; + float z1, z2, z3, z4, z5, z11, z13; + + float tmp0 = d0 + d7; + float tmp7 = d0 - d7; + float tmp1 = d1 + d6; + float tmp6 = d1 - d6; + float tmp2 = d2 + d5; + float tmp5 = d2 - d5; + float tmp3 = d3 + d4; + float tmp4 = d3 - d4; + + // Even part + float tmp10 = tmp0 + tmp3; // phase 2 + float tmp13 = tmp0 - tmp3; + float tmp11 = tmp1 + tmp2; + float tmp12 = tmp1 - tmp2; + + d0 = tmp10 + tmp11; // phase 3 + d4 = tmp10 - tmp11; + + z1 = (tmp12 + tmp13) * 0.707106781f; // c4 + d2 = tmp13 + z1; // phase 5 + d6 = tmp13 - z1; + + // Odd part + tmp10 = tmp4 + tmp5; // phase 2 + tmp11 = tmp5 + tmp6; + tmp12 = tmp6 + tmp7; + + // The rotator is modified from fig 4-8 to avoid extra negations. + z5 = (tmp10 - tmp12) * 0.382683433f; // c6 + z2 = tmp10 * 0.541196100f + z5; // c2-c6 + z4 = tmp12 * 1.306562965f + z5; // c2+c6 + z3 = tmp11 * 0.707106781f; // c4 + + z11 = tmp7 + z3; // phase 5 + z13 = tmp7 - z3; + + *d5p = z13 + z2; // phase 6 + *d3p = z13 - z2; + *d1p = z11 + z4; + *d7p = z11 - z4; + + *d0p = d0; *d2p = d2; *d4p = d4; *d6p = d6; +} + +static void stbiw__jpg_calcBits(int val, unsigned short bits[2]) { + int tmp1 = val < 0 ? -val : val; + val = val < 0 ? val-1 : val; + bits[1] = 1; + while(tmp1 >>= 1) { + ++bits[1]; + } + bits[0] = val & ((1<0)&&(DU[end0pos]==0); --end0pos) { + } + // end0pos = first element in reverse order !=0 + if(end0pos == 0) { + stbiw__jpg_writeBits(s, bitBuf, bitCnt, EOB); + return DU[0]; + } + for(i = 1; i <= end0pos; ++i) { + int startpos = i; + int nrzeroes; + unsigned short bits[2]; + for (; DU[i]==0 && i<=end0pos; ++i) { + } + nrzeroes = i-startpos; + if ( nrzeroes >= 16 ) { + int lng = nrzeroes>>4; + int nrmarker; + for (nrmarker=1; nrmarker <= lng; ++nrmarker) + stbiw__jpg_writeBits(s, bitBuf, bitCnt, M16zeroes); + nrzeroes &= 15; + } + stbiw__jpg_calcBits(DU[i], bits); + stbiw__jpg_writeBits(s, bitBuf, bitCnt, HTAC[(nrzeroes<<4)+bits[1]]); + stbiw__jpg_writeBits(s, bitBuf, bitCnt, bits); + } + if(end0pos != 63) { + stbiw__jpg_writeBits(s, bitBuf, bitCnt, EOB); + } + return DU[0]; +} + +static int stbi_write_jpg_core(stbi__write_context *s, int width, int height, int comp, const void* data, int quality) { + // Constants that don't pollute global namespace + static const unsigned char std_dc_luminance_nrcodes[] = {0,0,1,5,1,1,1,1,1,1,0,0,0,0,0,0,0}; + static const unsigned char std_dc_luminance_values[] = {0,1,2,3,4,5,6,7,8,9,10,11}; + static const unsigned char std_ac_luminance_nrcodes[] = {0,0,2,1,3,3,2,4,3,5,5,4,4,0,0,1,0x7d}; + static const unsigned char std_ac_luminance_values[] = { + 0x01,0x02,0x03,0x00,0x04,0x11,0x05,0x12,0x21,0x31,0x41,0x06,0x13,0x51,0x61,0x07,0x22,0x71,0x14,0x32,0x81,0x91,0xa1,0x08, + 0x23,0x42,0xb1,0xc1,0x15,0x52,0xd1,0xf0,0x24,0x33,0x62,0x72,0x82,0x09,0x0a,0x16,0x17,0x18,0x19,0x1a,0x25,0x26,0x27,0x28, + 0x29,0x2a,0x34,0x35,0x36,0x37,0x38,0x39,0x3a,0x43,0x44,0x45,0x46,0x47,0x48,0x49,0x4a,0x53,0x54,0x55,0x56,0x57,0x58,0x59, + 0x5a,0x63,0x64,0x65,0x66,0x67,0x68,0x69,0x6a,0x73,0x74,0x75,0x76,0x77,0x78,0x79,0x7a,0x83,0x84,0x85,0x86,0x87,0x88,0x89, + 0x8a,0x92,0x93,0x94,0x95,0x96,0x97,0x98,0x99,0x9a,0xa2,0xa3,0xa4,0xa5,0xa6,0xa7,0xa8,0xa9,0xaa,0xb2,0xb3,0xb4,0xb5,0xb6, + 0xb7,0xb8,0xb9,0xba,0xc2,0xc3,0xc4,0xc5,0xc6,0xc7,0xc8,0xc9,0xca,0xd2,0xd3,0xd4,0xd5,0xd6,0xd7,0xd8,0xd9,0xda,0xe1,0xe2, + 0xe3,0xe4,0xe5,0xe6,0xe7,0xe8,0xe9,0xea,0xf1,0xf2,0xf3,0xf4,0xf5,0xf6,0xf7,0xf8,0xf9,0xfa + }; + static const unsigned char std_dc_chrominance_nrcodes[] = {0,0,3,1,1,1,1,1,1,1,1,1,0,0,0,0,0}; + static const unsigned char std_dc_chrominance_values[] = {0,1,2,3,4,5,6,7,8,9,10,11}; + static const unsigned char std_ac_chrominance_nrcodes[] = {0,0,2,1,2,4,4,3,4,7,5,4,4,0,1,2,0x77}; + static const unsigned char std_ac_chrominance_values[] = { + 0x00,0x01,0x02,0x03,0x11,0x04,0x05,0x21,0x31,0x06,0x12,0x41,0x51,0x07,0x61,0x71,0x13,0x22,0x32,0x81,0x08,0x14,0x42,0x91, + 0xa1,0xb1,0xc1,0x09,0x23,0x33,0x52,0xf0,0x15,0x62,0x72,0xd1,0x0a,0x16,0x24,0x34,0xe1,0x25,0xf1,0x17,0x18,0x19,0x1a,0x26, + 0x27,0x28,0x29,0x2a,0x35,0x36,0x37,0x38,0x39,0x3a,0x43,0x44,0x45,0x46,0x47,0x48,0x49,0x4a,0x53,0x54,0x55,0x56,0x57,0x58, + 0x59,0x5a,0x63,0x64,0x65,0x66,0x67,0x68,0x69,0x6a,0x73,0x74,0x75,0x76,0x77,0x78,0x79,0x7a,0x82,0x83,0x84,0x85,0x86,0x87, + 0x88,0x89,0x8a,0x92,0x93,0x94,0x95,0x96,0x97,0x98,0x99,0x9a,0xa2,0xa3,0xa4,0xa5,0xa6,0xa7,0xa8,0xa9,0xaa,0xb2,0xb3,0xb4, + 0xb5,0xb6,0xb7,0xb8,0xb9,0xba,0xc2,0xc3,0xc4,0xc5,0xc6,0xc7,0xc8,0xc9,0xca,0xd2,0xd3,0xd4,0xd5,0xd6,0xd7,0xd8,0xd9,0xda, + 0xe2,0xe3,0xe4,0xe5,0xe6,0xe7,0xe8,0xe9,0xea,0xf2,0xf3,0xf4,0xf5,0xf6,0xf7,0xf8,0xf9,0xfa + }; + // Huffman tables + static const unsigned short YDC_HT[256][2] = { {0,2},{2,3},{3,3},{4,3},{5,3},{6,3},{14,4},{30,5},{62,6},{126,7},{254,8},{510,9}}; + static const unsigned short UVDC_HT[256][2] = { {0,2},{1,2},{2,2},{6,3},{14,4},{30,5},{62,6},{126,7},{254,8},{510,9},{1022,10},{2046,11}}; + static const unsigned short YAC_HT[256][2] = { + {10,4},{0,2},{1,2},{4,3},{11,4},{26,5},{120,7},{248,8},{1014,10},{65410,16},{65411,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0}, + {12,4},{27,5},{121,7},{502,9},{2038,11},{65412,16},{65413,16},{65414,16},{65415,16},{65416,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0}, + {28,5},{249,8},{1015,10},{4084,12},{65417,16},{65418,16},{65419,16},{65420,16},{65421,16},{65422,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0}, + {58,6},{503,9},{4085,12},{65423,16},{65424,16},{65425,16},{65426,16},{65427,16},{65428,16},{65429,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0}, + {59,6},{1016,10},{65430,16},{65431,16},{65432,16},{65433,16},{65434,16},{65435,16},{65436,16},{65437,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0}, + {122,7},{2039,11},{65438,16},{65439,16},{65440,16},{65441,16},{65442,16},{65443,16},{65444,16},{65445,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0}, + {123,7},{4086,12},{65446,16},{65447,16},{65448,16},{65449,16},{65450,16},{65451,16},{65452,16},{65453,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0}, + {250,8},{4087,12},{65454,16},{65455,16},{65456,16},{65457,16},{65458,16},{65459,16},{65460,16},{65461,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0}, + {504,9},{32704,15},{65462,16},{65463,16},{65464,16},{65465,16},{65466,16},{65467,16},{65468,16},{65469,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0}, + {505,9},{65470,16},{65471,16},{65472,16},{65473,16},{65474,16},{65475,16},{65476,16},{65477,16},{65478,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0}, + {506,9},{65479,16},{65480,16},{65481,16},{65482,16},{65483,16},{65484,16},{65485,16},{65486,16},{65487,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0}, + {1017,10},{65488,16},{65489,16},{65490,16},{65491,16},{65492,16},{65493,16},{65494,16},{65495,16},{65496,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0}, + {1018,10},{65497,16},{65498,16},{65499,16},{65500,16},{65501,16},{65502,16},{65503,16},{65504,16},{65505,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0}, + {2040,11},{65506,16},{65507,16},{65508,16},{65509,16},{65510,16},{65511,16},{65512,16},{65513,16},{65514,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0}, + {65515,16},{65516,16},{65517,16},{65518,16},{65519,16},{65520,16},{65521,16},{65522,16},{65523,16},{65524,16},{0,0},{0,0},{0,0},{0,0},{0,0}, + {2041,11},{65525,16},{65526,16},{65527,16},{65528,16},{65529,16},{65530,16},{65531,16},{65532,16},{65533,16},{65534,16},{0,0},{0,0},{0,0},{0,0},{0,0} + }; + static const unsigned short UVAC_HT[256][2] = { + {0,2},{1,2},{4,3},{10,4},{24,5},{25,5},{56,6},{120,7},{500,9},{1014,10},{4084,12},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0}, + {11,4},{57,6},{246,8},{501,9},{2038,11},{4085,12},{65416,16},{65417,16},{65418,16},{65419,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0}, + {26,5},{247,8},{1015,10},{4086,12},{32706,15},{65420,16},{65421,16},{65422,16},{65423,16},{65424,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0}, + {27,5},{248,8},{1016,10},{4087,12},{65425,16},{65426,16},{65427,16},{65428,16},{65429,16},{65430,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0}, + {58,6},{502,9},{65431,16},{65432,16},{65433,16},{65434,16},{65435,16},{65436,16},{65437,16},{65438,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0}, + {59,6},{1017,10},{65439,16},{65440,16},{65441,16},{65442,16},{65443,16},{65444,16},{65445,16},{65446,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0}, + {121,7},{2039,11},{65447,16},{65448,16},{65449,16},{65450,16},{65451,16},{65452,16},{65453,16},{65454,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0}, + {122,7},{2040,11},{65455,16},{65456,16},{65457,16},{65458,16},{65459,16},{65460,16},{65461,16},{65462,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0}, + {249,8},{65463,16},{65464,16},{65465,16},{65466,16},{65467,16},{65468,16},{65469,16},{65470,16},{65471,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0}, + {503,9},{65472,16},{65473,16},{65474,16},{65475,16},{65476,16},{65477,16},{65478,16},{65479,16},{65480,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0}, + {504,9},{65481,16},{65482,16},{65483,16},{65484,16},{65485,16},{65486,16},{65487,16},{65488,16},{65489,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0}, + {505,9},{65490,16},{65491,16},{65492,16},{65493,16},{65494,16},{65495,16},{65496,16},{65497,16},{65498,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0}, + {506,9},{65499,16},{65500,16},{65501,16},{65502,16},{65503,16},{65504,16},{65505,16},{65506,16},{65507,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0}, + {2041,11},{65508,16},{65509,16},{65510,16},{65511,16},{65512,16},{65513,16},{65514,16},{65515,16},{65516,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0}, + {16352,14},{65517,16},{65518,16},{65519,16},{65520,16},{65521,16},{65522,16},{65523,16},{65524,16},{65525,16},{0,0},{0,0},{0,0},{0,0},{0,0}, + {1018,10},{32707,15},{65526,16},{65527,16},{65528,16},{65529,16},{65530,16},{65531,16},{65532,16},{65533,16},{65534,16},{0,0},{0,0},{0,0},{0,0},{0,0} + }; + static const int YQT[] = {16,11,10,16,24,40,51,61,12,12,14,19,26,58,60,55,14,13,16,24,40,57,69,56,14,17,22,29,51,87,80,62,18,22, + 37,56,68,109,103,77,24,35,55,64,81,104,113,92,49,64,78,87,103,121,120,101,72,92,95,98,112,100,103,99}; + static const int UVQT[] = {17,18,24,47,99,99,99,99,18,21,26,66,99,99,99,99,24,26,56,99,99,99,99,99,47,66,99,99,99,99,99,99, + 99,99,99,99,99,99,99,99,99,99,99,99,99,99,99,99,99,99,99,99,99,99,99,99,99,99,99,99,99,99,99,99}; + static const float aasf[] = { 1.0f * 2.828427125f, 1.387039845f * 2.828427125f, 1.306562965f * 2.828427125f, 1.175875602f * 2.828427125f, + 1.0f * 2.828427125f, 0.785694958f * 2.828427125f, 0.541196100f * 2.828427125f, 0.275899379f * 2.828427125f }; + + int row, col, i, k, subsample; + float fdtbl_Y[64], fdtbl_UV[64]; + unsigned char YTable[64], UVTable[64]; + + if(!data || !width || !height || comp > 4 || comp < 1) { + return 0; + } + + quality = quality ? quality : 90; + subsample = quality <= 90 ? 1 : 0; + quality = quality < 1 ? 1 : quality > 100 ? 100 : quality; + quality = quality < 50 ? 5000 / quality : 200 - quality * 2; + + for(i = 0; i < 64; ++i) { + int uvti, yti = (YQT[i]*quality+50)/100; + YTable[stbiw__jpg_ZigZag[i]] = (unsigned char) (yti < 1 ? 1 : yti > 255 ? 255 : yti); + uvti = (UVQT[i]*quality+50)/100; + UVTable[stbiw__jpg_ZigZag[i]] = (unsigned char) (uvti < 1 ? 1 : uvti > 255 ? 255 : uvti); + } + + for(row = 0, k = 0; row < 8; ++row) { + for(col = 0; col < 8; ++col, ++k) { + fdtbl_Y[k] = 1 / (YTable [stbiw__jpg_ZigZag[k]] * aasf[row] * aasf[col]); + fdtbl_UV[k] = 1 / (UVTable[stbiw__jpg_ZigZag[k]] * aasf[row] * aasf[col]); + } + } + + // Write Headers + { + static const unsigned char head0[] = { 0xFF,0xD8,0xFF,0xE0,0,0x10,'J','F','I','F',0,1,1,0,0,1,0,1,0,0,0xFF,0xDB,0,0x84,0 }; + static const unsigned char head2[] = { 0xFF,0xDA,0,0xC,3,1,0,2,0x11,3,0x11,0,0x3F,0 }; + const unsigned char head1[] = { 0xFF,0xC0,0,0x11,8,(unsigned char)(height>>8),STBIW_UCHAR(height),(unsigned char)(width>>8),STBIW_UCHAR(width), + 3,1,(unsigned char)(subsample?0x22:0x11),0,2,0x11,1,3,0x11,1,0xFF,0xC4,0x01,0xA2,0 }; + s->func(s->context, (void*)head0, sizeof(head0)); + s->func(s->context, (void*)YTable, sizeof(YTable)); + stbiw__putc(s, 1); + s->func(s->context, UVTable, sizeof(UVTable)); + s->func(s->context, (void*)head1, sizeof(head1)); + s->func(s->context, (void*)(std_dc_luminance_nrcodes+1), sizeof(std_dc_luminance_nrcodes)-1); + s->func(s->context, (void*)std_dc_luminance_values, sizeof(std_dc_luminance_values)); + stbiw__putc(s, 0x10); // HTYACinfo + s->func(s->context, (void*)(std_ac_luminance_nrcodes+1), sizeof(std_ac_luminance_nrcodes)-1); + s->func(s->context, (void*)std_ac_luminance_values, sizeof(std_ac_luminance_values)); + stbiw__putc(s, 1); // HTUDCinfo + s->func(s->context, (void*)(std_dc_chrominance_nrcodes+1), sizeof(std_dc_chrominance_nrcodes)-1); + s->func(s->context, (void*)std_dc_chrominance_values, sizeof(std_dc_chrominance_values)); + stbiw__putc(s, 0x11); // HTUACinfo + s->func(s->context, (void*)(std_ac_chrominance_nrcodes+1), sizeof(std_ac_chrominance_nrcodes)-1); + s->func(s->context, (void*)std_ac_chrominance_values, sizeof(std_ac_chrominance_values)); + s->func(s->context, (void*)head2, sizeof(head2)); + } + + // Encode 8x8 macroblocks + { + static const unsigned short fillBits[] = {0x7F, 7}; + int DCY=0, DCU=0, DCV=0; + int bitBuf=0, bitCnt=0; + // comp == 2 is grey+alpha (alpha is ignored) + int ofsG = comp > 2 ? 1 : 0, ofsB = comp > 2 ? 2 : 0; + const unsigned char *dataR = (const unsigned char *)data; + const unsigned char *dataG = dataR + ofsG; + const unsigned char *dataB = dataR + ofsB; + int x, y, pos; + if(subsample) { + for(y = 0; y < height; y += 16) { + for(x = 0; x < width; x += 16) { + float Y[256], U[256], V[256]; + for(row = y, pos = 0; row < y+16; ++row) { + // row >= height => use last input row + int clamped_row = (row < height) ? row : height - 1; + int base_p = (stbi__flip_vertically_on_write ? (height-1-clamped_row) : clamped_row)*width*comp; + for(col = x; col < x+16; ++col, ++pos) { + // if col >= width => use pixel from last input column + int p = base_p + ((col < width) ? col : (width-1))*comp; + float r = dataR[p], g = dataG[p], b = dataB[p]; + Y[pos]= +0.29900f*r + 0.58700f*g + 0.11400f*b - 128; + U[pos]= -0.16874f*r - 0.33126f*g + 0.50000f*b; + V[pos]= +0.50000f*r - 0.41869f*g - 0.08131f*b; + } + } + DCY = stbiw__jpg_processDU(s, &bitBuf, &bitCnt, Y+0, 16, fdtbl_Y, DCY, YDC_HT, YAC_HT); + DCY = stbiw__jpg_processDU(s, &bitBuf, &bitCnt, Y+8, 16, fdtbl_Y, DCY, YDC_HT, YAC_HT); + DCY = stbiw__jpg_processDU(s, &bitBuf, &bitCnt, Y+128, 16, fdtbl_Y, DCY, YDC_HT, YAC_HT); + DCY = stbiw__jpg_processDU(s, &bitBuf, &bitCnt, Y+136, 16, fdtbl_Y, DCY, YDC_HT, YAC_HT); + + // subsample U,V + { + float subU[64], subV[64]; + int yy, xx; + for(yy = 0, pos = 0; yy < 8; ++yy) { + for(xx = 0; xx < 8; ++xx, ++pos) { + int j = yy*32+xx*2; + subU[pos] = (U[j+0] + U[j+1] + U[j+16] + U[j+17]) * 0.25f; + subV[pos] = (V[j+0] + V[j+1] + V[j+16] + V[j+17]) * 0.25f; + } + } + DCU = stbiw__jpg_processDU(s, &bitBuf, &bitCnt, subU, 8, fdtbl_UV, DCU, UVDC_HT, UVAC_HT); + DCV = stbiw__jpg_processDU(s, &bitBuf, &bitCnt, subV, 8, fdtbl_UV, DCV, UVDC_HT, UVAC_HT); + } + } + } + } else { + for(y = 0; y < height; y += 8) { + for(x = 0; x < width; x += 8) { + float Y[64], U[64], V[64]; + for(row = y, pos = 0; row < y+8; ++row) { + // row >= height => use last input row + int clamped_row = (row < height) ? row : height - 1; + int base_p = (stbi__flip_vertically_on_write ? (height-1-clamped_row) : clamped_row)*width*comp; + for(col = x; col < x+8; ++col, ++pos) { + // if col >= width => use pixel from last input column + int p = base_p + ((col < width) ? col : (width-1))*comp; + float r = dataR[p], g = dataG[p], b = dataB[p]; + Y[pos]= +0.29900f*r + 0.58700f*g + 0.11400f*b - 128; + U[pos]= -0.16874f*r - 0.33126f*g + 0.50000f*b; + V[pos]= +0.50000f*r - 0.41869f*g - 0.08131f*b; + } + } + + DCY = stbiw__jpg_processDU(s, &bitBuf, &bitCnt, Y, 8, fdtbl_Y, DCY, YDC_HT, YAC_HT); + DCU = stbiw__jpg_processDU(s, &bitBuf, &bitCnt, U, 8, fdtbl_UV, DCU, UVDC_HT, UVAC_HT); + DCV = stbiw__jpg_processDU(s, &bitBuf, &bitCnt, V, 8, fdtbl_UV, DCV, UVDC_HT, UVAC_HT); + } + } + } + + // Do the bit alignment of the EOI marker + stbiw__jpg_writeBits(s, &bitBuf, &bitCnt, fillBits); + } + + // EOI + stbiw__putc(s, 0xFF); + stbiw__putc(s, 0xD9); + + return 1; +} + +STBIWDEF int stbi_write_jpg_to_func(stbi_write_func *func, void *context, int x, int y, int comp, const void *data, int quality) +{ + stbi__write_context s = { 0 }; + stbi__start_write_callbacks(&s, func, context); + return stbi_write_jpg_core(&s, x, y, comp, (void *) data, quality); +} + + +#ifndef STBI_WRITE_NO_STDIO +STBIWDEF int stbi_write_jpg(char const *filename, int x, int y, int comp, const void *data, int quality) +{ + stbi__write_context s = { 0 }; + if (stbi__start_write_file(&s,filename)) { + int r = stbi_write_jpg_core(&s, x, y, comp, data, quality); + stbi__end_write_file(&s); + return r; + } else + return 0; +} +#endif + +#endif // STB_IMAGE_WRITE_IMPLEMENTATION + +/* Revision history + 1.16 (2021-07-11) + make Deflate code emit uncompressed blocks when it would otherwise expand + support writing BMPs with alpha channel + 1.15 (2020-07-13) unknown + 1.14 (2020-02-02) updated JPEG writer to downsample chroma channels + 1.13 + 1.12 + 1.11 (2019-08-11) + + 1.10 (2019-02-07) + support utf8 filenames in Windows; fix warnings and platform ifdefs + 1.09 (2018-02-11) + fix typo in zlib quality API, improve STB_I_W_STATIC in C++ + 1.08 (2018-01-29) + add stbi__flip_vertically_on_write, external zlib, zlib quality, choose PNG filter + 1.07 (2017-07-24) + doc fix + 1.06 (2017-07-23) + writing JPEG (using Jon Olick's code) + 1.05 ??? + 1.04 (2017-03-03) + monochrome BMP expansion + 1.03 ??? + 1.02 (2016-04-02) + avoid allocating large structures on the stack + 1.01 (2016-01-16) + STBIW_REALLOC_SIZED: support allocators with no realloc support + avoid race-condition in crc initialization + minor compile issues + 1.00 (2015-09-14) + installable file IO function + 0.99 (2015-09-13) + warning fixes; TGA rle support + 0.98 (2015-04-08) + added STBIW_MALLOC, STBIW_ASSERT etc + 0.97 (2015-01-18) + fixed HDR asserts, rewrote HDR rle logic + 0.96 (2015-01-17) + add HDR output + fix monochrome BMP + 0.95 (2014-08-17) + add monochrome TGA output + 0.94 (2014-05-31) + rename private functions to avoid conflicts with stb_image.h + 0.93 (2014-05-27) + warning fixes + 0.92 (2010-08-01) + casts to unsigned char to fix warnings + 0.91 (2010-07-17) + first public release + 0.90 first internal release +*/ + +/* +------------------------------------------------------------------------------ +This software is available under 2 licenses -- choose whichever you prefer. +------------------------------------------------------------------------------ +ALTERNATIVE A - MIT License +Copyright (c) 2017 Sean Barrett +Permission is hereby granted, free of charge, to any person obtaining a copy of +this software and associated documentation files (the "Software"), to deal in +the Software without restriction, including without limitation the rights to +use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies +of the Software, and to permit persons to whom the Software is furnished to do +so, subject to the following conditions: +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. +------------------------------------------------------------------------------ +ALTERNATIVE B - Public Domain (www.unlicense.org) +This is free and unencumbered software released into the public domain. +Anyone is free to copy, modify, publish, use, compile, sell, or distribute this +software, either in source code form or as a compiled binary, for any purpose, +commercial or non-commercial, and by any means. +In jurisdictions that recognize copyright laws, the author or authors of this +software dedicate any and all copyright interest in the software to the public +domain. We make this dedication for the benefit of the public at large and to +the detriment of our heirs and successors. We intend this dedication to be an +overt act of relinquishment in perpetuity of all present and future rights to +this software under copyright law. +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN +ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION +WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. +------------------------------------------------------------------------------ +*/ diff --git a/template_kernel.cl b/template_kernel.cl new file mode 100644 index 0000000..d1ab313 --- /dev/null +++ b/template_kernel.cl @@ -0,0 +1,40 @@ +__kernel void template(__global double *buf1, __global double *buf2, + __global double *result, int mat1_w, int mat1_h, int k) +{ + + int x = get_global_id(0); + int y = get_global_id(1); + + int idx = x * mat1_h + y; + if (idx >= mat1_h * mat1_w) + return; + + double sum = 0.0; + + for (int kx = 0; kx < 2*k+1; kx++) { + for (int ky = 0; ky < 2*k+1; ky++) { + int overlap_x = x + kx - k; + int overlap_y = y + ky - k; + + if (overlap_x < 0) + overlap_x = 0; + else if (overlap_x >= mat1_w) + overlap_x = mat1_w - 1; + + if (overlap_y < 0) + overlap_y = 0; + else if (overlap_y >= mat1_h) + overlap_y = mat1_h - 1; + + int idx1 = overlap_x * mat1_h + overlap_y; + int idxk = kx * 2*k+1 + ky; + + if (idx1 >= mat1_h * mat1_w) + return; + sum += buf1[idx1] * buf2[idxk]; + } + } + + + result[idx] = sum; +} diff --git a/utils.c b/utils.c new file mode 100644 index 0000000..ab823ff --- /dev/null +++ b/utils.c @@ -0,0 +1,210 @@ +#include +#include +#include +#include +#include "stb/stb_image.h" +#include "stb/stb_image_write.h" +#include "utils.h" + +Matrixd matrixd_create(uint32_t w, uint32_t h) +{ + Matrixd ret; + ret.w = w; + ret.h = h; + ret.buf = calloc(w * h, sizeof(double)); + + return ret; +} + +size_t matrixd_size(Matrixd *m) +{ + return m->w * m->h; +} + +void matrixd_print(Matrixd *m) +{ + assert(m); + + for (size_t i = 0; i < m->w; i++) { + for (size_t j = 0; j < m->h; j++) { + printf("%f ", m->buf[i * m->h + j]); + } + printf("\n"); + } +} + +Matrixp matrixp_create(uint32_t w, uint32_t h) +{ + Matrixp ret; + ret.w = w; + ret.h = h; + ret.buf = calloc(w * h, sizeof(Pixel)); + + return ret; +} + +Matrixp matrixp_create_from_file(const char *filename) +{ + Matrixp matrix = (Matrixp) { 0 }; + + if (!filename) + return matrix; + + int x, y, channels; + uint8_t *ret_ptr = stbi_load(filename, &x, &y, &channels, 3); + matrix.w = x; + matrix.h = y; + matrix.buf = calloc(matrix.w * matrix.h, sizeof(Pixel)); + memcpy(matrix.buf, ret_ptr, x * y * sizeof(Pixel)); + stbi_image_free(ret_ptr); + + return matrix; +} + +Matrixu8 matrixu8_create_from_file(const char *filename) +{ + Matrixu8 matrix = (Matrixu8) { 0 }; + + if (!filename) + return matrix; + + int x, y, channels; + uint8_t *ret_ptr = stbi_load(filename, &x, &y, &channels, 4); + printf("%s return channels: %d\n", __func__, channels); + matrix.w = x; + matrix.h = y; + matrix.buf = calloc(matrix.w * matrix.h * 4, 1); + memcpy(matrix.buf, ret_ptr, x * y * 4); + stbi_image_free(ret_ptr); + + return matrix; +} + +void matrixu8_write_to_bmp(Matrixu8 *matrix, const char *filename) +{ + assert(matrix); + assert(filename); + + stbi_write_bmp(filename, matrix->w, matrix->h, 4, matrix->buf); +} + +size_t matrixu8_size(Matrixu8* m) +{ + return m->w * m->h; +} + +size_t matrixp_size(Matrixp* m) +{ + return m->w * m->h; +} + +Matrixd gauss_filter_create(uint32_t size, double sigma) +{ + Matrixd ret = matrixd_create(size, size); + + size_t _i, _j, index; + + double k = (size - 1.0) / 2.0; + double sigma2 = sigma * sigma; + double pi_part = 1 / (2.0 * M_PI * sigma2); + double sum = 0; + + for (_i = 0; _i < size; _i++) + for (_j = 0; _j < size; _j++) { + index = _i * size + _j; + + double i = _i + 1; + double j = _j + 1; + + double exp_numerator_1 = pow(i - (k + 1), 2); + double exp_numerator_2 = pow(j - (k + 1), 2); + double exp_denominator = 2 * sigma2; + double _exp = exp(-(exp_numerator_1 + exp_numerator_2) / exp_denominator); + + ret.buf[index] = pi_part * _exp; + sum += ret.buf[index]; + } + + for (_i = 0; _i < size; _i++) + for (_j = 0; _j < size; _j++) { + index = _i * size + _j; + ret.buf[index] /= sum; + } + + return ret; +} + +const char *cl_get_error_string(int error) +{ +switch(error){ + case 0: return "CL_SUCCESS"; + case -1: return "CL_DEVICE_NOT_FOUND"; + case -2: return "CL_DEVICE_NOT_AVAILABLE"; + case -3: return "CL_COMPILER_NOT_AVAILABLE"; + case -4: return "CL_MEM_OBJECT_ALLOCATION_FAILURE"; + case -5: return "CL_OUT_OF_RESOURCES"; + case -6: return "CL_OUT_OF_HOST_MEMORY"; + case -7: return "CL_PROFILING_INFO_NOT_AVAILABLE"; + case -8: return "CL_MEM_COPY_OVERLAP"; + case -9: return "CL_IMAGE_FORMAT_MISMATCH"; + case -10: return "CL_IMAGE_FORMAT_NOT_SUPPORTED"; + case -11: return "CL_BUILD_PROGRAM_FAILURE"; + case -12: return "CL_MAP_FAILURE"; + case -13: return "CL_MISALIGNED_SUB_BUFFER_OFFSET"; + case -14: return "CL_EXEC_STATUS_ERROR_FOR_EVENTS_IN_WAIT_LIST"; + case -15: return "CL_COMPILE_PROGRAM_FAILURE"; + case -16: return "CL_LINKER_NOT_AVAILABLE"; + case -17: return "CL_LINK_PROGRAM_FAILURE"; + case -18: return "CL_DEVICE_PARTITION_FAILED"; + case -19: return "CL_KERNEL_ARG_INFO_NOT_AVAILABLE"; + + // compile-time errors + case -30: return "CL_INVALID_VALUE"; + case -31: return "CL_INVALID_DEVICE_TYPE"; + case -32: return "CL_INVALID_PLATFORM"; + case -33: return "CL_INVALID_DEVICE"; + case -34: return "CL_INVALID_CONTEXT"; + case -35: return "CL_INVALID_QUEUE_PROPERTIES"; + case -36: return "CL_INVALID_COMMAND_QUEUE"; + case -37: return "CL_INVALID_HOST_PTR"; + case -38: return "CL_INVALID_MEM_OBJECT"; + case -39: return "CL_INVALID_IMAGE_FORMAT_DESCRIPTOR"; + case -40: return "CL_INVALID_IMAGE_SIZE"; + case -41: return "CL_INVALID_SAMPLER"; + case -42: return "CL_INVALID_BINARY"; + case -43: return "CL_INVALID_BUILD_OPTIONS"; + case -44: return "CL_INVALID_PROGRAM"; + case -45: return "CL_INVALID_PROGRAM_EXECUTABLE"; + case -46: return "CL_INVALID_KERNEL_NAME"; + case -47: return "CL_INVALID_KERNEL_DEFINITION"; + case -48: return "CL_INVALID_KERNEL"; + case -49: return "CL_INVALID_ARG_INDEX"; + case -50: return "CL_INVALID_ARG_VALUE"; + case -51: return "CL_INVALID_ARG_SIZE"; + case -52: return "CL_INVALID_KERNEL_ARGS"; + case -53: return "CL_INVALID_WORK_DIMENSION"; + case -54: return "CL_INVALID_WORK_GROUP_SIZE"; + case -55: return "CL_INVALID_WORK_ITEM_SIZE"; + case -56: return "CL_INVALID_GLOBAL_OFFSET"; + case -57: return "CL_INVALID_EVENT_WAIT_LIST"; + case -58: return "CL_INVALID_EVENT"; + case -59: return "CL_INVALID_OPERATION"; + case -60: return "CL_INVALID_GL_OBJECT"; + case -61: return "CL_INVALID_BUFFER_SIZE"; + case -62: return "CL_INVALID_MIP_LEVEL"; + case -63: return "CL_INVALID_GLOBAL_WORK_SIZE"; + case -64: return "CL_INVALID_PROPERTY"; + case -65: return "CL_INVALID_IMAGE_DESCRIPTOR"; + case -66: return "CL_INVALID_COMPILER_OPTIONS"; + case -67: return "CL_INVALID_LINKER_OPTIONS"; + case -68: return "CL_INVALID_DEVICE_PARTITION_COUNT"; + + case -1000: return "CL_INVALID_GL_SHAREGROUP_REFERENCE_KHR"; + case -1001: return "CL_PLATFORM_NOT_FOUND_KHR"; + case -1002: return "CL_INVALID_D3D10_DEVICE_KHR"; + case -1003: return "CL_INVALID_D3D10_RESOURCE_KHR"; + case -1004: return "CL_D3D10_RESOURCE_ALREADY_ACQUIRED_KHR"; + case -1005: return "CL_D3D10_RESOURCE_NOT_ACQUIRED_KHR"; + default: return "Unknown OpenCL error"; + } +} diff --git a/utils.h b/utils.h new file mode 100644 index 0000000..9af1d3a --- /dev/null +++ b/utils.h @@ -0,0 +1,61 @@ +#ifndef UTILS_H +#define UTILS_H + +#include +#include +#include + +#define DEBUG +#define DEBUG_PRINT(fmt, ...) \ +do {if (DEBUG) fprintf(stderr, fmt, __VA_ARGS__);} while(0); + +typedef struct { + int x; + int y; +} Vec2i; + +typedef struct { + double x; + double y; +} Vec2d; + +typedef struct { + uint32_t w; + uint32_t h; + double *buf; +} Matrixd; + +typedef struct { + uint8_t r; + uint8_t g; + uint8_t b; +} Pixel; + +typedef struct { + uint32_t w; + uint32_t h; + Pixel *buf; +} Matrixp; + +typedef struct { + uint32_t w; + uint32_t h; + uint8_t *buf; +} Matrixu8; + +Matrixd matrixd_create(uint32_t w, uint32_t h); +size_t matrixd_size(Matrixd *m); +void matrixd_print(Matrixd *m); + +Matrixp matrixp_create(uint32_t w, uint32_t h); +Matrixp matrixp_create_from_file(const char *filename); +Matrixu8 matrixu8_create_from_file(const char *filename); +void matrixu8_write_to_bmp(Matrixu8 *matrix, const char *filename); +size_t matrixp_size(Matrixp* m); +size_t matrixu8_size(Matrixu8* m); + +Matrixd gauss_filter_create(uint32_t size, double sigma); + +const char* cl_get_error_string(int error); + +#endif