From 67aa648299f67c8f6dcb949663565d3ad9ac5361 Mon Sep 17 00:00:00 2001 From: 0xdeadbeer <64986162+0xdeadbeer@users.noreply.github.com> Date: Fri, 1 Dec 2023 00:36:23 +0100 Subject: [PATCH] 05: Bootstrap basic OpenGL project --- 04-map/.imgs/showcase.png | Bin 3457 -> 107909 bytes 04-map/README.md | 6 +- 05-opengl/Makefile | 29 + 05-opengl/README.md | 3 + 05-opengl/assets/linux.png | Bin 0 -> 39064 bytes 05-opengl/assets/shaders/shader.frag | 12 + 05-opengl/assets/shaders/shader.vert | 11 + 05-opengl/assets/wall.jpg | Bin 0 -> 256989 bytes 05-opengl/src/game.cpp | 164 + 05-opengl/src/game.hpp | 33 + 05-opengl/src/main.cpp | 40 + 05-opengl/src/object.cpp | 45 + 05-opengl/src/object.hpp | 28 + 05-opengl/src/other/stb_image.cpp | 2 + 05-opengl/src/other/stb_image.h | 7987 ++++++++++++++++++++++++++ 05-opengl/src/texture.cpp | 21 + 05-opengl/src/texture.hpp | 10 + README.md | 4 +- 18 files changed, 8390 insertions(+), 5 deletions(-) create mode 100644 05-opengl/Makefile create mode 100644 05-opengl/README.md create mode 100644 05-opengl/assets/linux.png create mode 100644 05-opengl/assets/shaders/shader.frag create mode 100644 05-opengl/assets/shaders/shader.vert create mode 100644 05-opengl/assets/wall.jpg create mode 100644 05-opengl/src/game.cpp create mode 100644 05-opengl/src/game.hpp create mode 100644 05-opengl/src/main.cpp create mode 100644 05-opengl/src/object.cpp create mode 100644 05-opengl/src/object.hpp create mode 100644 05-opengl/src/other/stb_image.cpp create mode 100644 05-opengl/src/other/stb_image.h create mode 100644 05-opengl/src/texture.cpp create mode 100644 05-opengl/src/texture.hpp diff --git a/04-map/.imgs/showcase.png b/04-map/.imgs/showcase.png index bbb63ef84011213d1ce40637d85c3d843adae476..4a68f3f877e03c1e8ffee19d794fec00d98fa22f 100644 GIT binary patch literal 107909 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 RYLoSwkxKi&-Uo)pa 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 WQ5x0ze#%xd0D-5gpUXO@geCxy;sgZ% literal 3457 zcmeHKYfO`86n?RqDnu^vLN=xdacd^aKr6RYs5;4DGH}-DoYkU~ixe#vX@NqEw|J+i z%((*EL}QWY3KI)Op)Er#!BXNtD5dbBm5W%u!anVVuPyuhNxNT5_G1Y@-h9dXot&KW zoadbLycc#QeY@QAQ%?ZE@`U&uy8*yW0N?>FU4-2v2Bq<_&$68O{rLcRKlyk(u7!99 zV8+CR9ozO4R!`|So~N_dC}-|Re|5w!Bq%y+v#-yol=bJue(!Sp1t<32%Q?Au`^w+W zWd9V0i`Xuy7n}%M@4tIz<=t(G>lP=qO|-?ur+HGe_s@o*G_6W)RMW>EBep%vb4|>( zh}inqc;wva_S*&y0A)jF;V}q{Crp%s2W8-uHx}q0YXDeuh6KRkrECC}`oaMCuG4#f zbz5aPu(fQ#Z~>kLQY^H>!ld|5=VQ*%!AO9PT4#suXvngHqHoxXz{4MN=TB+1jOP1A z4SV20a>gVtCLCxp_PPveB7FFx!G`1v0i!qz)HCn9FgIPFnwW$GMncHHob$>%*ao2{ z;+wwiF6Y-l2hnhkveMM2^Os1NVQp&Oqs(hHV{ZYN%W(gjp7*GO-~+1ptLE<<*n6{5ePi{@n%LWZ*FQ8d>-MzhI`{qh(=W~;b>8d?Rq{f5NOlfAs}UCNlFhs zOJE>yRbwX=eejG~Uc?5ncy}<^9pZ6aZ2%jl(UaK-3~~gnn0tHk%bQAlIL8K>&AFXL ztC%hC4MZ9b71s3UmCBt}{@o>x3noY2lu6prg6^y1=CbU4UHkgDK0qnn?@~acLB50! zSz)7fXb|Zpx8f`>KR~{WP2v6WW!(_Dq+obU^k=;AjT$Kq6u2jLAR;M9!9fEX3_bZ% zqMNzj4c>$=Sv8lM(p7;;)kN-9CX}CN*Q=g8j=XB+J4qz&2Q zdnKF5CF4c{*OLD{W;CRm%YmbLg(FaYchS4Cke#iepx(>1V&+`v2TG5ceaPx)t}C*U z38WG}rC-5)Pk&uh{pZcf$wmblEFRN+Ygi$yWYg%9H9(7Z1rn7p+k#OU521-f98E9+ z8&-aJ;I!2Qs$*1_(M&rVbYrc21K^Zm1CKxrOBUI ziZdQ!WD6EeZh$TdFuvVwcs*ZVQFZ3!#>WNUhbipS_zbzcbFmpR>7#9_j#R||iS^5v z6QiAa --> - - +

+ +

# Map diff --git a/05-opengl/Makefile b/05-opengl/Makefile new file mode 100644 index 0000000..a7faf5c --- /dev/null +++ b/05-opengl/Makefile @@ -0,0 +1,29 @@ +CC=g++ +CFLAGS=`pkg-config --cflags glfw3 glew` +LDFLAGS=`pkg-config --libs glfw3 glew` +INCLUDE=/usr/include/stb/ +TARGET=opengl +SDIR=src +ADIR=assets +ODIR=build + +SRC=$(shell find $(SDIR) -type f -name *.cpp) +OBJ=$(SRC:.cpp=.o) + +all: $(TARGET) + +.PHONY: default +$(TARGET): $(OBJ) + mkdir -p build + cp -rf $(ADIR) $(ODIR)/$(ADIR) + $(CC) -o $(ODIR)/$@ $^ $(LDFLAGS) + +%.o: %.cpp + $(CC) $(CFLAGS) -o $@ -c $< + +run: + $(ODIR)/$(TARGET) + +.PHONY: clean +clean: + rm -f $(ODIR)/$(TARGET) $(OBJ) diff --git a/05-opengl/README.md b/05-opengl/README.md new file mode 100644 index 0000000..7e71fd8 --- /dev/null +++ b/05-opengl/README.md @@ -0,0 +1,3 @@ +# Opengl + +Playing with Opengl because I realized SDL2 is not enough :/ diff --git a/05-opengl/assets/linux.png b/05-opengl/assets/linux.png new file mode 100644 index 0000000000000000000000000000000000000000..29ab51d61ae2e5577320950a44e315de627caeaa GIT binary patch literal 39064 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%0DljuBHh!A1@!@z!YODAqQr&T5biP_YR5Pw~Y}{L+ z6I(r1cx=sCFXl$r*6o35cwtBB+;mt z>-0zvGiIWMXrE0?!qZZW_=uv86`veKQuk}u-mh5h10-sLSuc#?zd@GGf?a#(nv)?# zCAt00J?gq@>6MX`JylT=HpNSEJBNZAne!`IGClrzY`{2Vq{Tk9qFBd-~;gf|&*g!^{(UxMt9Ua%opcy3Mh6Q#TCn zOv_;&gA1dj-UuW3ZtT~15C%DC@(0&YA4~6;2p$4i@8y)S=lBC+w;UKJ1LKTTDkt)j&rnZ4|I0UqKpr*{ z=w1x;E*?&6$PIR;*{oJ6r5Jpt+{a1yq~u7Vuf*+&nPJ}fvJPGpNrJ+CmO3b9d+Woq zJ}BcFW>@7awnA@me|~ zZem*k)3B&zo4FhWS44bC8gf|LA=7^J;WZP9I6k2OL*YCC7z*O>WNFd9 ziLi$+zXI+DcZDeFc`1+QNw&s^`Waky_qttn8nmv5?s4M4A!!#y4HMN$iOv;OD{F04 z^7cA5%SiEZ;o=-nrAY?~5ZV;o5JhvlK1^P1=Q#7H;w|JAveXrBXP}4nC+*ox;Fd*7 z*^5C1w0sRYbCt?uG#KL*QTFPt8f_-J&&zyLq5zP#b2fJ<6QPzGcaVRhp3M4iR-yop z3Z{e(+YNo9V|SeFXrDXcew-6L^%{*@UCw-PQSD_ubLDj8Ubp@HWUn*5^GF2Ph)Muh zNUOX<4^82|mkw;^>k5J4+|G;7RR(Y0hEv-%(DuG9ep*P#^a4bj*zYQ@;AW%5Q$Lj6 zJ)lb}n|Rc4%dd2wLVQ3D8CmQRGK}f$$7EQQhEU}n!y7nJl@{AjmQN2$Y|UE-=u!gX z4ZPY*#e>3_vR2m$5I-tm+Rpxhla&m6$@MhYik942w;`>Pb;5a}p#6FmL@+S2x{2g3 zPUF&`r-tt6M-ry#*K{@M*3whdpA7ekb8tYal=;hemikeKZMg%~E(3Jt`U~R!7AAfY z`W4+ue~&><1!SX~u^jAGDYSRIF%oAm(&U{}w1znuk#!WY)N=#Aov-bBX&voP&avCC zn1%xQi+RJm~uRbDau~dmVAR)A;+L9C0u6U{c%7ItS<>mvqXsnK%A4Ss*{-Q3gp% zU=F2aHYvMOsq3ghSJlB^Foj^}J9fepQ0W>n$Xt>RT_1o7RD$EU(!tN}yV)OX(jwDHDiM8$8e>OYWHmcT84LQRH^|7eG7A&`D-qPDIkAVa9Yb;$c;LPE-_gMUiFHhQ@kV-iJZzx zorW`3Mm2EQ!}8eptoF;u1uF;zbR!c+N@Y2^2iH9d6lJAO2i+@ZN}`?;FxM?B?{)ay zYOxy?_Nr@M_+Y-k5A6h@7A$?zP^3-pzgpuVi?GcP*B6XzIxHcgW(5RNBjn@|6X7~8 zaZ>1=0`eS+q{}~!tXsQjVAt2SnNv@DcHhmOL+3?_dg-X1G7@zET|R=h*-HVe0TZ9v zCJ+Uj_H??yg>X|fqH;IP|7|AYq>!QW9*9~6(5by=sWwG&!Cq1qwKW|^m^ZjkwwSSg zm08(#ohJza^?AFqh_!_b+wo*^!pDOu6A#X?OCftoQpK6$o z{;t$8ckW7+H(+zx5I&9G;^SQw#&DGgpUV>bL@OP%dMg;^Cz~?sHmUmr8Fc>o?Sa_9zuH4I; zUJuE59fbRBvR`2lLk``zqB3GaiGiq<2XQ7RdbBcp;AU)kXJ4KbE{vYtPMrnv?mA$T z;#r>R&S)V7t|aXPZ6H1Y!ItlXaxNW{TJ6uTK6}I3$!)Jyx|TV zKni8Y&Ln53?sL=4xQ*G5@-?r1 zah>Z_+CyN0q-K7m@*6CW0K0uSLzz{>bCPBt}x}fH?oMZKlZhZ zn~>lS^j6vBhD)6&-0v#U3%7PsK!$;NG;lhb9)JoB+s0$=6t_L}^BdhGX~xLwtD&-A zD!Hx_g)sC%A>glqf`2))Lv}Qh{W7MVWxAt=i(Wd1z4f}@M47qUSU&hvWFO5ZgGvrz zL9o4EV#`&Oa$*DLA+6JOMhUS2fhlT5p`*0jYjEy>t93Dg)Cd_!l>*3SL8wg*1hk`j zo>csL3It2v&Hs^%mFk_Eu!sDYElTTmV9p@r=AuNsJI$Oyn}YD3_)WB4c{>(N?{!I4gZ0A&KpTT^Ax`6=08-xnlHJH+_oZa93OIm) zDLaqNcZ*&0pE);6H7#;6-R_v*qMU;yGq($CTaf*)(EJ|jD5x8T<;}W|8V~rAR{NN2hCepWFqda{}!%f*ugu7@7s0Hdx%H*dVJxf z`p#(Of)rV9dgKkZ>a_ka;3%?q0@t5GXpY%t|2$vkD2M5INR`HtYzum(!!Wdoa3L0$ z)C_lAp?a=hqJb6@7c%sfGC~&eolvSi*b&42j&;m{2y~m7juQ7cfPN7R9_RwP_Kv4^ zznt$DFWD8~^R52^Kf};yCF7{DWn`5S)?AZW2_Qb7v>-HkomrKm!*#)>=qqc#PkxND z6(}`h{1r!I(8x)fI9m8ICe8?k)Zc+!Qxccna=$fsdBfQGN_z*)sS$2IkXc) zrZv{nCZb0tLv^xs&ioe=6Ca}ajy+NC@k|`J#GUw69t}NA)Ln8n;126mrTuI~hzog& zGY*a1v-$3T=QUj9u@R?Ci{z3yf2=N-X3ow_>QeWT+a93_^!y1IxM>0m+NDh_m%ax1 zf1LL}MRv2YSj->)PSz!TmGV;I60!&it&*OxWZlmX8XvTzr!n7kXrvTBeuC>KDl6$5gEC*@_Q=7a z0^pGN5^LT#qiqQQEYPK? zGA5xNvnGN@fQ(ip@nY;0aR}b_szXWE=w`IM-)i(vg?wgZtJhALcKb4cUr%$AeqZzL*(y_xtL^pXcuR-B zy|Kb(M23>_s0%3jG;@-wHuKc9<-xG>KwDDSgOfcBB4t`XBLf>*(&BH1JH88HCpKWn z;`#Yis&@pKwflT3GiV8_&=b{%q+ph>S;3G<5w@>N>o-E0kE*;A(^>2Q5zX?)bIl(N zr&1!6lqqU%n8&B($I{dl#FZiKZU^0aQ-YmwXX58rJhyAEZfAQ>dV0;(X#;bgJDVSw z1UbI{;-@Z;y+{1oR2T&FU6DP*G+mR&;k$~=EvWdvIH=Tq3 ztA>W#Wq^U+7WYXZJL6Z^%cbmcO zsZtDyN+B5b!ke#KTr&lkABKj<5=T8pOX`>mRp21lzB4#}Z`Mm+i`uU;PE?M`rQTj1 zwH%}pN(gd3kg1rOg8lKhd@jnnZx3b}N0*$v8i1AW1@0etUrz2K^<7@f>HsP1YrCm3 z!4i+#_!ik;M-SLoGR&*2Rv&quWz!qo`UY6*C&lzfh?X}#8imS(ejXDHaRTNKYu_Eo z{5%9J-4z%pJ2I8T{l2D_@PW66hWy3>j@!8Q?5CXFHGCSg@8iS21)x$?4%1GDLGyrj z3S%dp^A3ZN!2pTC=r9!II;vn}oBG z3b);P+oZ^lLW{E$uiAh84F@|s-T_ln^^tQ)?H6}s`2JdXFqFJbYsp`DpYlQG9nx4=_3}^Y2SV4>L7HM`w z>{@G;vqln~sqJo_I38T{ApEwr5`(5Kw|B6aIfI?J zmsTU%Pps@qes-XH4P!9>J_>0T< zn#EBDj1kJD6EIiWif0gsUV2U2GJ;qdEUQY2vH>~-+MaMSHkDLY6Qp`p6R|&j#A`I6 zEKEz_M-oj3dM^&f5ly~wDQ*w9g>0mG4QJ?X)G$ZW%v(9zr`T~qV-YVh&Mf#slx{Z> zK-m~g%8b$c-RNjOFyT^9WD;X4)k`PhI8F8IH5_jG%4|$B<2JdU@G{WKEcFZ;pSK&_ z($gXK(5{{oUPP^PN1-p@L6y}P`>3d-$s5Qa!aB|b z8P)u5R<$SV7ZZpXS{G_#xd#i?N#4lD8F3g}rXAouq@?+f9Ly=9fjW-Ge9251F6dFn zK7BcY!oy%gBBOApOzU3=dd)W#$whe3J9I$dtZF=N$W8a6!1Ek+5y67P$m@IrpK%%f z(z7$C*X=YyXJ9qy3({w(kKZB)IDbUrrApLMaUQOb)580N@$&Szv-yuI4J?RrAW_9D z?>gGe5SWtequN1J1v(*wD6Ly!FNv!v?iLsuuWsdX3v4C5Z47E>7b6}iPdDoGh-;S; zDT&{q+#dek=6Ld0Gwug?s76sDzYvje_m1Fw5_ibM8i4i2fc6Z1<#G`tT%a3$9whw$ z4`u$!i*9U3VdRHc;IL0cXvo3MzHR_$liM0%^U5o{=Dj^W>^@(}yvQvMzCPdMKOi~OlLI(N?)1NY#?;^cAU_RyoVx-j{kgzo_-p4cMX_DdUGOX|wQ)amxNoXn(?C3baG7hqZW`@xT(0;l!?c-jNq! zod15eySwu}7~HL0XmsQ=S%9=(2EUbypzY3BGV(l{l-`-FF>wCw@@ctSgs)Jj2Esbb zg|@Pr(bHRZO9oIk8DAX(CqBWxJ|sOk7jB}$zP%&7zX=r{H56(r+0k#Z>#wX(=C>Dh za6c1llqi6C4YvUQTfIN?!-_rC4hvf7WkE_ZJ7bZIr->1SS=+>Z-!LunCazZBzeDf7 zG`l&vs&}x_(x=xr4F(y=6cUgbFG+dR48;9|W+TiwSzY#~zN{8VbRTIHlsS&?<<@UX zsDW6CT%u9K885_IAA*4YJw_&kz((J5Tz2l&;C_<^VLhColmf!eul5ET!>7P|me7DE zOmhe^&aDTo(O{7!p#KbT;b4&^1?%$@bv-pdd}^WhtBC?yWfu643La_54ap25)y{|e zJT$t~v{*|a&`%8sTeImfoK6Bj5@PM8OKg@DFe1={rSodp{(|T7Ck|n@$4QU$&x7}r zd{!J7r`v(RBE``&=H};jbtxp3y&q;PoUg^cBBTqO%DFD8v){6x@gR1EFwNT66H;}Z zV;7T6vlN3+y@vz%M#HYsN1lx;H+3!_KCE&)e%uXw8o0vgjl86{KKJG7YC6K3&f#h; zP0o~!hCra*{3uJ~<`(X{-$UI2 znFO`34vDoB?<xahlOS{VJI>!VnpX<97mqHFf3;<3CH27N{!z!=c%7zTkpMP-`JF0!8(Ql z|Gj8U_6_=abks*M($A6jYY^mfzA^G-5-%TH zfZ;0Kt?4gkR%GPZjCa^cPYlQe#C|6so>JpNfZ-=Xa)BtghihDMjnwh7+6qWZ{Xe29 z7QV?VF}||J(kL&c^jKt5Ys@i5$qhzhs&=4qTq){yL$eXY8DjN*5_bt{?2FQ_$fv(S|N$uQxl@x@Y89dIfPr*a# zw0?y@=!lM$_o@CQ-QCU4HDPXQjAK$Fn$7mHDZaAcXoTRH2mDrO^)~^2=g?R2!Jy<; znpTxdY0=nLrCNcaPGDU18=htQv9Shov+rYN|LR#fEQ#fq^z&rp_&d^G{@H7e-?=!A z_+qZY!qsr)!82g?8G)7LB}m%;eE#g(dp$SiImFzaL=C5e)#1O6}uazB<>jPEO&C6Vx(tqp+2#i37`-=DszcQ15ygLzCNl8`s zk?!O;#=B-sejax)C%VV=DerZ@@P6yw5Z{oIFvPsfC5|BSRc?NOSqs8(Tx*l;!5S^n zo2-WDxP^Locc5WLZuU<^X{GSDxjprH*j~E+IrdmRW?JeFs{Sv%FYG+J*RN;$?)T;Q zBGqKW(AO4K`R=*HpC9zTfyJi*#a@idP3oic9p^iQuX5yHcYOpm&IB)%^}^OFu|O62Yc9^0op`4Q z?lU7GfV^w`(nt8hyWZ(@<&bP(;{jn6mpflo7G{h*($Yq!ma_tzGaVcSvkoSAuzvBJjUF-Sb`DK6B-k;BY_FikRXFbo2 z#@79oDR3ahS`bxRvBe!3p}!_%G>pT5jj|4lnK4y&peEI6Dv)giu#C*ka+@veJ3%yq z&TF@;&lvy{g_{vje&$c>bgKugVE7MfjI4>!k$sO-$ zH!#YF111Y_!0g7POW@Hlk?4So#+MxzmQTP{X!=>cUb;GiJMyePh7V6B$neDkM6v9{ z_rsqkCT5sos5C9|p?Hq%w*`vY5pXZfS6$8IXmi4XnuV-Q%U2Xf0-)K%-l+BCI;S^Z zb99_-N;(_3xR%}Mu-Vi_*}$aqjRP_p@{fb`P2dNP0XUfIrYcGU6hjB16p ztMO89&uYZ`T~`uf0^>py82900o9&;q2MxZBhi5^1VbywB6$n_(-@cf5-R`tx-mE|_qmME>_w+Y&d*O8Kl)Du|HhvUVDd8%)EiNY38~0VOlvhZNo%r^O zy}O~!jYQ5ZIU4)F_gd_tUk_O&vy2V%@{|pZe-34+eEGT*xpLcS{cb+fm*w6;cKneO zcSHm@B58KsA6nQiFNa-OP_K@aS+$=YOj;-VRbiO&D*hT=gm9C*@OO(3ll8>7xG&p& zKi=HrnZQeoTBFt_5)=d*r?!V3j5o*2g~y(_YG_ zbo9x>=6V8Yh&SF{aX)V?#qswNs<|;_B%bK_!Sg%QVts)lsX24+y@rA=EK@`BW=jli zGvImj$6{&$UMie%LoRr-cJ*^Ed3z@5A=(SCU{tczvVZY7>G*UL=i=h+M(`LlfCxyc zl}1$;@Gj054qfe4y?;va9R;4D4Fq{Dz~ZWmd_+&9bwL$|wD z*^=ZxurPs$ygcqs`dKX-JmrP9SiC$b;56*zu{8QgU>U%(P z?w4Hbv{YuR7)r>VfL5PG5xqfxZ0_YZ0@!`a0=|c5XnV)t%6vf)fZxzWx-;;@U^O(p zB}r+nt6z1Ae@LD+9>2Yx@WZROvCSEM9!`GeZR7s_WPK108=k@bRR-#E!uWdC*V&JC zR_!~&%KZZUN`}%NZge|1&qZf&+yi~S*#C38&{iA8D8}`C%cEu}@gGaSpddrQdNUWL z%Lsj&b*&YBa7}AkOU4(__c6Fg3D^m+KjZ6;HZN8ShHgRIXKW)k3U@7h;WIQM67*HM z0I=B%3q-cBXtlsMR)8(Z%X+#o>fF(Tkq6d%rtjqzYbvf)a6}hP+fx_T;%GSPbu^b`hjkf4GC9Ze@M6h|Xv%o+lPj^5kmvbwcA;NL1|_ zrnkYDo2{*VP6P;&o84Hna(cm3s)$cduqwcFaI;5r24nnq2O=uQ�P>Vc22&D zTA!61qL`E8rU6A-S&~L_h*Epf6<&p5lMQ> znlzP~+U0GRV!iuLz;qF7*r%A`pzG8YpD{mOlJGEph;OL#p_M`)(arJjF@S%|xNWjP z=8=2Xm8IQ(xtJ5MU6eBHJEpTEM$#54m`>lhY}#U^4lS~CuWaUCEdQ#smd1g@1Ciac zV8`&_9jclFWx^bzG7;U39k(kt1rUC8s#Tv8vr6Z~h$q@&Lap&R`u^6Icj(q6Th;Gc zb`Q>feTm|t`mY%>7=ccwe-boSKuI7e?sT(D=@Eg)2lP+*&?%7Ed-UiF_H~T}5_z9E z;GD&h(0jA^xrfx0%#AJ6oEUnMxUziRp=-9cz~R#7JDSR{Akm#(UZ%Qr;}*(qY0u92 z8c27HlS9_o-0N|Al1P;;KIbgvDoW&;-b~^vBQWo_;ZVUE>Ynf#MirR~HuHS(oQ-sl zZAAWiG3QJl+pyo-T@n&F7vVJ*;76IRGZh@AMfj^fHf(kG_Q`5a{H?4!$;Qr5>Jk(l zI^=BhfDzqMZls~}jhpuUqsH*J-6WLVi~8MOf6^Ci@mixX)5m@-E@t~uYoz2BM>ZI| z3r-^Y^?@qs9YmghzRD&Y&5M@9I}24N6o55W8%(|Cu%!Vxr#puXS_wT;MM^U(Zq8maOq*jxFisQp44Zyy z$&`({^WW-`L4G^DBBEep#~qll@DpqS44x9$???&)?99|I4ZDKMHtxoPs#~kTh$}rn z63S?fM}f{1QT$cUhKK{Xze>$ZolF$g8kIg4eDSnIg`cWPI|!XR4uAS9BJfbu>D9yN zy_HG7q#e{^PGi@QBwxSz)hJ7`VRTU-_OW!KE{O^SSqm8n@i z<_#w`nqVG|^UHl(2ij9Amn1r_Y!hvn)?QH1Sln(>|7A%f3c`kbeDKBdUbOC%`DG&1 zC9{~~Pu|Wgy_#{ieBSh|LsyK<_jwq5t@wB?CZ?u44CAkMefb5NU zuC`bxmMf)v#@yF-{@lmfi(I2eS#6}MIXDQ_$qKTRgT=tsLv!@JM+r2WH8`88oeYF7HHzP>GF^ykkrhI?-J1E&yWCx8I5vqwwVJK=V`X0SR&FdDC*p=r znWN&Q&-o@!dFPT#<^aW@3$x5D67tITXwo814e|4|02RCW|3t_m!}kM4l4HUogo1qX|o^Vr1y E02K{PVE_OC literal 0 HcmV?d00001 diff --git a/05-opengl/assets/shaders/shader.frag b/05-opengl/assets/shaders/shader.frag new file mode 100644 index 0000000..51a6aac --- /dev/null +++ b/05-opengl/assets/shaders/shader.frag @@ -0,0 +1,12 @@ +#version 330 core +out vec4 color; +in vec2 tex_coord; + +uniform sampler2D texture1; + +void main() { + color = texture(texture1, tex_coord); + + if (color.a < 0.1) + discard; +} diff --git a/05-opengl/assets/shaders/shader.vert b/05-opengl/assets/shaders/shader.vert new file mode 100644 index 0000000..07744c4 --- /dev/null +++ b/05-opengl/assets/shaders/shader.vert @@ -0,0 +1,11 @@ +#version 330 core + +layout (location = 0) in vec3 pos; +layout (location = 1) in vec2 texture_coord; + +out vec2 tex_coord; + +void main() { + gl_Position = vec4(pos.xyz, 1.0); + tex_coord = texture_coord; +} diff --git a/05-opengl/assets/wall.jpg b/05-opengl/assets/wall.jpg new file mode 100644 index 0000000000000000000000000000000000000000..49631987d967c1201286664f2d6032525f9fe1e8 GIT binary patch literal 256989 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࣮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

&shoeJMBBztTS9`;l|qbF zY;^}LW9x`@XBNV8q=aL4$!Y z?Vyfe!9q%QQI5+wix;KAsn&}ShaC|^GE~GVOm(wC^6C_jMZ!nBcw_*E)SC+j4z)Qj zL~S%p-GCyW=KfKL(cnMMD&`op#(XYV#4H-3ilc0iPW3k|tS0eec0s4XH+)H2lg5^+ z69DYlPPjf=pvDYzxHMA7na0t9qMBcsmStpHLS$(pSfmWgc54&f$B1rUSx`7ZG@-2| z%wtY9iA9C8V6aj>UL{1a%`PW2O4C)mD9Ic&?F%xMK=*CQeJ;Ms*?p{$~*oYGO_Q_>1}#8wK5(!6mfTLJ=*j1PYfZ5KV_u}JBrn?OjAaO>Gv zYNEsDlL3bZs;8sFu|X=-NnbqaSkmq-zidH>iM+dljjh4ZT=7EH2~^^EQ;meFKx&Fk zVUf{GiP7P8u+vdPT~qSZv^25JE5s^XQ?nz&P0@FjD)tT7Uys_hJ)FfOdC34y+OoVR zvX2VHvIa_qG@+jc#A&enxcGc?%ZOB%sa_->Gw#I{Y5*=7wbTP{73XSix==iM_Rya$ zweJ-e^YWu_NrF`zOAW)Z$?52%#_QmkvXdM`H6*njXP6_IfsH)9pawgIoZMdAidaGc zFi8UrxTy;~WZE!-k%&At51l46B_>{yw=~n@Rd8kaBdn7RdR#VUN^&Y*HDI1Vc>Y6z?YRBSI%Hbw{h5UfKPfr zGtc zS7IX*uUp4yqpOiT%5nn}8@`I}S8zVg3vV3>Au1b25m5U{TooOsXrp13Gjz4}N;5SO zWy7i}9c$+EQD>w*;qyeM_r11g)huu_?0BW ziwlZpkyYug<}$IM7b9+^wOwz1AXsq#iIE=qXsS*kDQQoa>#6B+HKUDd{OXS< z6H3b^yn-VRV?OYG!~<*T#q6mL09CRoib9Xuw9~aK;kbEBHRzgr7Dt90QRj=xwO^L2 zGr(!hmr-rOY#pwr!Acs-!7*TF|8z6Y!&d-)LnIUq0LlP7|kvfRb58486PZ55Dig_ z!w$+>D&v4N$YDtt#r?&;r-b>Xs-AHqV;GarKYb22PcUlTr!nx85!WAu8Qz&sh2i-} z55lVO`piMI6p4k_K?F4ORMc0-1g$*M#<2h-V<)S~GYU0M=tFET3ix#V*$LFa^ndxg)i~O}iGpk87 z%veTQR@VmB)|RVrNyHK(1Hx%N<-15wN_2vD%eQ8SnyUJWSuiT8aVXLJ`6u&aQZ|%U7IHR?02=CSVVkSfsD*(ag-$k^e|Lr^cF~CF z)n`ny-8}fFV9!sJ>oSHDQ;OxxM=H`wB~;jwMiv@+ZzJ?k?w0Mnjg$jo4!l`sblE3a zjw7U+C(rVipHh3I%6QRSOgkK*sm5{2f95!5Va$-#;&pkx8v2PUsw-+xyzd|+*htn7 zaBro>uX^2GFIZSv^rL*MAZ4MUX~1;ss#?zVIYwL?BVl+R9a)NEQbk!+n4+teluD9H z7Fp1^Lo{KpxmAsUI*>Hr`IQu;Nr4p=W{o7cV~MA1J#%I+9yf+%xtkAqoI;BWt;{tw zRc}c_Q!kedGs_yeMuAv`klWhVxZ;rN7mpe((y*KWI+mz7nk%hW znr1W1U@L{`Z#c+*ew3X1&MT~#Jfufy>87q28bpn!tfxrlii%2^p^VBdW%oCG zhhm)zSRF{>WWgYrr6GD-F|_ff>bm2L;8jpW@tO=yIMeyu=&iOjap%V@ae^*~K<)2b z0s$5!TJ)t@(q_Q|2O4sq!f3HMqQ@e|C&2L-Wv9Th(_tP|R!E^L(;1}%D18En6z(_d zY(qujAV4*9Z6h7AjC4}V6|AJirJ9ynDh$~4GSSi1Q&b|&9wRhSlNvdV(WYB!)*$V* z^yY!lh^i|hMia7U6?vU;sN;Z}t+=i0ms&SgXi@o~hBTM}uzW|(1Wj3*eRhf*>0 zgAcB1N-B!!@ML6@3&5l+QCCm$dzqv!GVXx8s0^SI2EOkdvF`$sl3;Y2cQw)76Q@*c z1C0YTxQ!)t7n^Xp?m}GKLJmfGoB8NKV@*8cNqBj44Is%b13m(vV?YeS2wljV2X{H_l)fwJg|l6cqTG#v_)L)jZ8o zWfzK`Gyw^+szyEQ*jOGXvuy@cu?Bs#wRU>e5R)P?>hqu~Z%%a>=R^A8o9p_+moQv* zw+@dQ%e^wMr^V{(>uBpIib$u7VNgpPGD>6eS?0P#Y#gc72rU8|Ufd`JoFCbg0khpj z>m}oGoB~Wyu=k^)!!Lzm7;JN`JzP>pF3rp3y0g3_uH(CD9wgjxYk^vhkwL(4+aOSx zE-tveLyR8|YMe(8Xk)2NEw@7?vBR|?;_&7-V%uqK)&4gzAKe_9f_B=pp&OGe4_ zj}0V3NzBU^nKPMbkOoOu6Smg{PUEL2j_XND69%mZRwr#^YjBc$c>81II8lI}8N<~kf z6cLXyUng-9MzWb~K?=Jqy1{L)7ot?Z??qR=8g@aXR%N8bDzItju=wYxs-vb^V*sdO z1I)!Il^6!Hh1Mw8mTMn(hIYw9R!G2f(RI^`DHDuUf%H52^P4g!OEaD!iAPnGv3U|{ za~3gG6V^i{SZm5Wx>*@NM!Nv>7B+6{`=sz8ym!G37!!{sq%F{3JmffZ;fI|YtV>+Ycc35A*B+*O%f9bi+c^_cRX?twZgEl(|{ytbs=j64l%@j`X7sD z8F4KIgCmT@`eU-9QD!`6AH#60M+l>j5~Qa`$6jA58LK)c_!QJWeQqr!Y!gE5=F@{3 zFX=p>Rghb7AcLi^s@+W`y%8YM^3b;&LexT3HvY63VfeXf3P@@mqEy5c%|0Qzk)@(h zF7ze`xS5RhwujtnZ2)SeHi_>Ez-ihsgH8VcHE=SJu%(waY{H(gNieFsuR|sxQW`1b z#BgSyp^9h3R8b0frV_-WHG3?ZgGNbJxb6own>BZO(q&59)k;%(%F2-7C`v>}PsW=n zqn?JkYWbkT@T>+%DX|VKSz$^Ih;LS4NfbCE6_j5nnb8T7hQK= zC$S(|fIMVdt%PdPf=o>Z?p`h^BrmQHvZGYRSwo6Y<*G_=otCaxCB|#&T_Gw&LK z%e8|rw{f)nuYyIm-*i^47)M`El^ZJJ<)>2HDuSaV`@OUQ`lZFNOuvZb{Lz@gW8(?M zFxsgotH7F`c&34(`EfW5Jk@X+K}!Q-M-^_-Q3ehtnWD}A00lt15L1BsDI=Aq%UwgG zrOb4gRGlHi>zXQ@BMOeGq^tR07C9-KdZcAq&cSvKgsKaH!P1#=B!lBIP>NQ9aS>Rt zSFaVduv1gj(cx60MUdf0fh44Ht>!y}4biD!02k~pekK}qV-wfYPwH1esK3nd2Beaf zs)^WR6DAK)3cl!>m4PjCAIkFX4Zzmo#>bWk1yV4KY4Cz};%gpT$JZ_5Qm!E+QZmWD zsiH>mtV4ECKq}U;2e3BwS?3wor9_ykGUlHT6GHr0#F>(cS#X>XNsY7>wDZulM2QTN z&mzMar<2Xt0`37-wN~-sWH1|bB$JIew+fSh;ZUn-@tRoGaeP9eYN~NhPbLc@Ndn5A zL638aVWMhOx|=t!_vX^lHGr6kbp`=Z+e?h6P5jRlqOFd(X00(QRUm;)JkhK{;#(5C zhr9rF14|#LS1Quk!T_zdsZ^6oXxkftV_RQOCLc60rA`wRhANn=Dq3GCnvZg6*>=ib@ix4>J zA!~qek6KI>DcM2BDNeN%a;nqI^0g5|Q-;)~NLgn}Y4)>EBbHkuZrrR%7VsmEEs_>h zFbTx`>5Xz?D46wX3K7+;7K0GLUo+#`ivh*(mro(36!nae$xkUr)fyyL0h?gdEswi< z`KJK4QJg5kz>#p18!E-Jb{~Xbap4&|4Z>xh&6N0EJlH-di$ElymP)!rlB%uzjj6go zNQrmYX>)sy5IoWD%Y*FV2Hz@`L+y8=rxW{59UgQ)<=hIYn+~MG@hVv%s;m;>m}!!t z3Uf6b5}BE#VR6WeD#eK9>=y~Zs;gq4ucd<( zlAP2U$ESjliUyS(U}llk_b}Ruj4h$mSPm$*NKB*>qt420R(hHtLrM=CZO!IbTHV1MN%_Z6N#YFBTdPE2 zhS3;o+sBOu7z|XH{Y+~?MOy?k6*U=!#4TGTJ|c>QDo)iFeZVm>z|2S^vG2<|3Pz(C zi22fMQh?%2K^XNO5nh6kDiatq_(av%LXnBrW0=H=O6FraqeHwZwcC2G-pd%jd+^iq zfT$86oG8Z3sS42~r>6@4)i)G4{vQ@4N^7c?il%WjHXyi!&{b2Uj5q%Pl(nhVwl2~y zv+VaI@(m9eQ($5?bf1-E6OK5DE)67{e^1tu7~fFnBBPER4xX;QiyAU~KfJKA~qST(gs+$(ZWPM~C9H)dr2L z>tcCP3<%1?ck;+%xsu?E04^`ZcFi`W9XRNvcUiuM`=uQ^um_$sO*sM#3Lc_h**aWB zusk-hx$tP~b3|11@kNH!Iv1&{sbqnSN|J`$JJ_3A*BZXE8`K94l@H#sl)4a48WbtB z7F)_##yMSwW|}OkMO%st0*)LCnrhliQWdFcc9}fKV6equvv%DGZB6;G*;)Zm$Bh1z zmB$j5C=Hwlth3|v)ESV~;hC1MtNEPJ&e(ya!lh;jc|L5%5|7b`u~G?Oy0A8}bt&5% zDUZzzCmNeupZ4Y&5c!u6#IcywVZ@`Si{;~yDy5drvO1WfK3PG#?G`t%)P_T3;ZCaI zBaaH|n;xU1hZd6#sA?)Y{j~6H+Km`hX_7s$%>SyWPy|ts~l;#k+f|quIuT>bSW6d6!^G8ffJ1~;&r)Jj*}6g zp`{pM#6Ddo)5AP|TxLlsV^l_oVn#q!QB;rxi1v3p+Q&u|(FB}! z^-;g{b)E2>FFt1|a~)u-%2;+I6%c{WD@_WR)f#KwL1k-u0O1yOXkCCY z>7lmk<{^z*<75fp?5i-O>N?_>_8)=fnwmU21f|6OVv?-V%Tg+7pz|rvdE1FI`|7Xd zy0VkGN3fw*$V+M|;4z_Ic zMdhoCfYGu?ACy;Wd#876mg9xBD1tB?MQA$9dXqjOh$4eLYdqz8Ttf}R;mqVo9Rtf- zMNKrZ&qo{*ElgDqq;fKEsAU!m&F=0O7q=Y*gv4V$p0rNsh3cK79+Bn4+e!YObtQ8q zGc{N9bgh>xz-EsUo+8uL$5A^dj4HfwM!?;px{GZZ+Sh6H0TYDqr5R1iostd-8+~c} z8R{H3mSCm8F$$-~Dr+N3JYtV7Q5AZMR92A|DbT!-NfBQNJR9u6vGgBFBSmRKCr((YE@5CBEAjy-CHY9?YU zR}X1w7KzovkEJVUt6;65!04+msh9e{Ox|3$wL~%0`SLlXi6V+k%QVZkWz>Rzw(V`i zua&404L;KJtO9~ya}^r}gD_EGdB+F624BSK%mS7iMpl~>jsoly-X;;c?6C;jn`2n0 zz4>QS+LD#+F!8F7vZaD)PWd*M4kJLtf^y4kH7V%%!`QPSv%9WR`FaPKTyeA@>s-Fc~3A$ zQ;5^lP*=rHD=Fs@ljOTCq=qY|*7x`Eg+rI&BM9R`YvKb2L72jcuT1kMFN$UOXof31 zl+|WjM-QyT0?9`eO2k;K5|GYiWLpS^MQ!bx24$MB{u-75hkVa_y&n>9@)2?igv zFaVoCWWSi`Hq_(w*sNbGTTgJvuJW$gnL`WhAZ+j2!->|2Stn`P72uTuBWD^8F--M_ zV|2H|XqDxGDW4z2@UNbpCaO)yXS9zdjHN>|DxhO~Uxo;`aU`gjG3)DEOM)X{sK+zm zX9b~>yB84u03xH3mlvq7sH>Ur8&rWD3{m0#JM=#7n9JJFURRTblP+xn<6^rf!+=Hf^(rlXw(tT#OE*4QK!0@Q4iqnco zG0e+bB(*eg!H9n>StUtlmP!1kjf_MC3g2^|Fah+Q8nB!KL89`d12txzm$L>|PKA1C zt*pxQI8G=rY{ib@xyFvNwxbqWG4oWBMAX#_AZ@};@p(o|*?~7(2+w+u3f2b6+38a^ zXYMIT9U(A%v|@2utP2v&7&Z+iCj|~7YyMXl#_8S~TAlT#4msg*mZ6)l9Ygx*qmDk5ZUG+y3tgaovbQw9V?fzeI1lP)JFU7*X8Lx6m(WHUuuh)f};Ywn!P>nbZv z^ALwtQV+aB>9ihEl>oApeWX+OcZ{u&q$~EI;5s=KDts>t!LeLlHf3du)Z@h|@T>y1 zTB#~%)K)Z&Jd%}DB(iNPS7_RRcJ6I<`R@Cr7)i#Pw9agrc)SFzG3zzTjy!sbIq@tf z55sC|n5}8V8+}Yg(4=h9F7T-=YHs_2``x>0STEAE3pfECRA!9G!j#%z&mF4j!wL!{ z>Ca5_l~d+?Ckt$^nBO0bDsvtQQ&CDM@)0HyP4kS(svLq$ORsTlM;CuNx^2B7QUKXi z?=3@`R?Hd0r{hEHnc}kusg4E8n2IB`v~;VMBaU%8w%JDVQKXGS*!i1*adLb(9)8g) zNg+wuj@m!Gbq;ARG@wSpBOiShKUZlMH`2@|zLE+|pqSn_gUef2fX7#d;uHaK1gEK~ zgvsWXozR7dk9y?T@Yi8`KRXaj)vtCMQorgtcB0W|A54 zd}5{$1J=T--daNMCg57-0YxPR$nC=0#@D3B5wnl(_tKV960l~H*wQ6!d@@t{cx!yj z_+1_|TU8Y#kqWf)6wDo8^d$Ce4xn1+M{H0+HpdvI9#%Al{SFyHSA|f?GUCfqH=B*( zL8gP`{#>g=3Wh3J$P0Of!?0c)DR=@%*#esyc5$7*g$rFe%+=E6IjN|_HUSXwEAbk* z9%^B^itRM)PrMz@^2zQfJ{s_@;6kw5PIsfPqJ@mLTP9+}t159S)Q-0inKI-Q^hjzc zs)TzJZ8YH>8GAbYHU6r_Letz z5KrZ|oNlAc0K^#mHsB8ItssQ#seZxaxZahCfgZHG{<&dvdnR=i_|;gbt;1l%>SZpq zb*`?+WHN&hB0qM;S8av(%PkV1KZI2l#)JqSA~CEO=4GLRf~tzA9i*l+(SI(JF2_#w zY4Z%GVA9X#6;@XO#J$d-9Y+_a6DBd73F0Ygn{gUIASYoR6$1*-^s@@sF^?`PiRk`a zpi0>HK~&7JG=577HmFv*mU3)%_Zl=(5R#$ChZyOmn{7!)bvs5UgwD@6pywFJGVCza z)nK$js)AalmbRj?rCKx)Leo47wIVp--0Jd{W+aQ7u{Pxb)}?7wnC57c^5?qNm`*Y2 zPuMPErOr8f2+V&l)Dguwil&C1MWv;7ilJI}bc!pMjT|`ut-w$$G~+9{S9qyRgU6mU z@+|_85g{aS;A%uvlz3#BaTO)5!KkaIs;HQsHvt z{A#v38fl=7hx!VMq?KY=$qZQy$va8y#Ew|Dw84m_NzGQ;wIM_+Z9u~@PKDw)4Aofn zGmGX-%xX<6i;mahc&v13Nl1PQEWFc(Cox^R96t6ByBS?YAu971;QpqYhm9}_; zN*=Eay;Fx}TFENuvvv{kw9S{r5+u=5K_1vg%E>X^BKw9VXS)D>?!%0Uoq49* zI^;(hYr(P}NW}3RtxrYMDhv{eVj-%6gNZDe7jwOK|zW18xN+)H4sIG$w7jq8%c~qKoT;kOFWL{AI*(N zn|;>Zdy~SH=PZ>0IFm+WaxS~Fq5ySP>{=7@-bMXcBB9 zc@1SI9ZyeFyAGaOcp3<#MvzZUiO&&~0>TDh2fg+|xIEi=>nen&VcT1|+}Dxffh5#7 z^yk#v3n%Biy@cQp;n8UE6~qIz=q<52nmpC}mt04DZuw&ZSn<3G3){K47nosKjPyniMqgNlF+Jp7CdY z4Hr?yRhhCD4BNQ+Ss}QA?gj?lD4-zb5#qL8kn(~Rx8#p9vr*1cK)C84)H5iUG;hOS~PO_yATdAPJ zQy^eiwKS5hAaJ}wNU_-=-bzVTJI^F1a+4~?cMt$kZ8)mlhb$r@XH3>A4{$=Ts99t8o!f?Fnm@?ZWbeVb~m};=uqQpc&B~sB;%=e83g4TAu z$QM#VoFpLg#5`!WNBUHb&~2? z+^Ai3Zpk0AC{PJc=}#vk)dK4Hie*kf1JNr~6jK~r57 zW+4;IV)Dg2l}if>a-!}Tcbf}vO}0d%n-66woT1zTc~ zCpsvOAB73oM>6_m$@mrSs__~+jAt|B zdunNFX+fn$oK{9)m1SuGB^ZDP(`)g;mlXIy@idX#*=xoq!1TYZ{WHrQHpZ|HmvoXI zo8c>s)8yRam@tW^#bu4F;T2_S1yjhAB+7y%ECEudQU$n2eU_;g1xFDZX?9(5E>s%= zCkigvx6+qJD{<)aCIm6Ot%FzjbTVbUBQQ@uf}*N3Bvk?mdPkC+w2BLbk*}%H5C@sw z2O~lWfkLPE4GjMPbs!RUV}R+P$2j^)TptUm!0>*dX53Q)yAT&U!uI5TCwqvEL1QJCqZdFp7wy)ti75hC9$!rh97;YNL!y!$~cxTe>% zZ1>=4t8LRqh^UPlCV|Y^>3by7#_`LG=D6`}%U3>Ns>1Lr#}skX#T`>LNdEvju5Mro ztsvf5Y4G8#mUgmJtju6fT{C~XOQM}JSKu% za|K`J@kCS3i5d?mRBf|dOs{JLd)tmVysMo%BacO0TbKJSVQEq56Yj#ASJ1~#F&twn zJ_Cy8>9EXEs&IUAjdmJ9fRv;urUcX_2a98eeI-DRBWs zNg9j^oJ>ze8N93bdh}kG9K?U0(&voQv%vUN8G4U8H6&?GAVV-|eqN#NV#^U(7RJPq zLE;5(x>B8|-9}9IWVIqnksiN=BC)?m9U#Hzvve6tCgwUyTvkbp6quHIs;^k6qpA_w zINpvjWMxsk_g>eqy@xEU`A!)J5z|T4xZTJiLWfk)YmE9Jz_P|#d11#fn6f2o5@R|4 z04`DHIaW+smKIuw4K$5NrZ~`SRRM#$Ugx#1ZML8twBOw&o{`?JZor z6R;7+h%K{L?9`R%C#wo2`MR^zg={!wIO@zS9LN1>hZ?0GXm}=7K!HTA>KND(LDx@o z9vv}}tt!%0fTdTv=E~FIXaY_>et6K8l9#9%l4ZiWlhy2T>S*cq{El0pz~kB#+F1}9 z!6wBTZIW2q-8MUK#D^d)IjEQhuXn#ma@aP6#-E3_hl;846@493;ayJ6*dAg^Ri(x8 zY)1^qwYY71nMFqGiCgsQ@wymc*Z}fC09bLgS(g(Uze+;he%c)lXp_gGUUTJ(WDq*Ul!YObHS~+DOrH%JZ<;t5bRDc+e6shpy(`dB~2_TV0*Ey?3 zRi-~0f6EwFaDxlPMl05=+k-4hve4Dw6Tyj4(^IKOSlUcRAmE=cfo-;7W?ONmY#Cfi zM8sB`&9sQ)x2}_QwHPi3k5u9rf3JN<#c8PNrKY8mF;igFm0vkD=!~UpePfGp-FRiTtf$;!#z@U3Xch@rlyN9VpvvF!X&DWu2`7N zq5zSrM0X96H@tj(ptU=?(!eSSo;zuM?(u;TlLKMGO?8N7ey7zM8N(FDDDg** zmV-OwtRaL?J<+|^Z7^EN7N}1{wI1kB&200^0A_~O2M={=fE^W^-yTL$>BMfN3 z?{keoN{>G}iCvF%2RC&uDdbE8t+ct>D)ERWY#T6O0|TqUt8nO-5rQ?Ql6hq@hJXr< zp@>3zn{lC$C9fWwdTIB!g%>hY0G*?SDh*b2&K*jqti>^GLm*~OnjogBz_2_nd~XSw zuMm~0;-+dTs=-P`mUfw0SP)#Ezz!*CXhI=S0;sm;(5*Uv`+6y^qYTamEn^forhUe# zv(_Dm$%)k^PDe&c%tBCNW{#j#?_hz|qfoabTVDKitHdo@gb~w8m6MR(G6*q@VriQ& zbZaux;W&)&_3s&~s-vtF__bCsl6Ht_3{nWnd6V82-a<04a~Z$Ar#76`DDZ$F*T1vQ zDLSCwaisn?kb0?uRLhsCdWDE$6*x8<1}j}M<)qDmtQ+Ck1|<&@5P2Uh&G7m_v=$U=`UN;}w;443clELy5{Ii6de+ z1_Tf+w&8Wlq4gx_NrAT-WMyRuR4GtQaICoQbk8tiNghh-)ixl;u+K?^NszHhUGl{< zMkby)t7J>0O0I%1&3i9_h3f!dMusRdMtAg$2|AU zvF410iQ(xJ#>(>*XT%yb1lR;15_=1tQsIVy#MN5MmZQc;O$Y7Np0VQC)8&YB+<4{} z6->=v9Tr5yV~z@MC1g_Gb$^<7GLVU_z`G9IY3oZ=60K06DZya++#(6-*-tbXhpe+r zj8kRY;W@+T<7)bB$BkvIOY|)?`ygtRp{`X`hi~YB-?$r*b+;pSZ}N{Q z5CMUI@!*&|8K*p?uzxGd5zx%D`Gs0Uo*5QRiW(JQ zF3K;s+Pd0Ga5(f)owb_VQPt5&9-!o08!qPDw_S$MSzS|CLk?lha^QI8Gde>vp$!~n zM~$y|_Q@Dh!I+TNwVO7~s!|dUT|RRn6@l5XbktYKIA(R95ytRLBQoRlkB0d*_$EJ$ z;}q$JVpR;u6-^|t)fprxs)+ECK{j63LSc?<2bf-t*(j%cnTx@gG|h4-i#Ex1q$Zd zY-%D^f8{Z+R!Wu+!e&co5yO3WW3p`PYHHjm(>CK&RK|LxyGbN5 zOl57ciy4uubXK?`)qc@}snHnLn$2C%3YWuYtts-&HWg7>m#{2*t2xUH!YZkrvl*8! zW0>VsZ8dyO$qbb8vQ!V0WLuk-kbuJC!-`$7WUgXhVMwjBmjJ+>Q?|eV*KNZnXs}9F z!*PlkD5>jYIHeUSSrsQc9yrSsNmWy6WJR_26Tm9eT_Hg5qjI=ONx;!L>Xu8uF>F$! z8Oupln7n>XWl~o`906sF9nnO{SZ^n4s*P9@K^EcliWHRisSAhzVKmd1GTs)rem7e+ zIxO_iOtNArzG`@YaN-TN-p_SnSH{=Zmbh1sW))#1W5%7bwi}o6oI9o2d&#YmsduZqFos2a&7S(kFGCPsnf@4sadY=hQR`K><5hs*o4$HxGfy( z1!Ce=sZ5wP1|cFdJoP5cO#`S>Hu-FB*0CNvxmK-^;-DM`)78`Rr`*kz+!Lo2d(TI+ z8cf$<)sWL;Em=(14sxa_D`@Bo$RlcE%@@ph$^y>ONTuXqbrxHAaKY3B$}uS$D23Z% z_|^ytR^FY|`d6VV(g=z5pKUF0g%cQIdm|DB`N?;%q9m}qQp90amZ4mX(lJqoN;>UYAR^x zYbm3{aI9q$1;XrZfV{lg7Q1YR?RRrTt*`+fYHEy62wO`~vg|QS6F9VN zOSEJFem2*K*(w1}l!AU#5#M!cKvJVr?Z!`8qVMVt4th?#;+PwwW_mM6gW_ibhOStv zDJo77vQHz)N{IgeG=vEyP^CueYkmprRuBLK5$vdP?XTJp4A5&PNFH5Lk|Oh~3XC5O zqlQT8gcAjvd0>|Su_U`KtULH|#N29J16o@e2U*))QDOLDo{#1opo*QBZB`R9`Cl;_ zn8xDPc93p9@mr8=cX&SH07w%g<6c6ESBGJtR|m=1ra6ycbQnrg<9Uv*A1eyOBB!S` zbF7g(0-|+xPty{8&@JuUEpBSn1HHvFJ1cIt`#G2cjW^@iZAKS}HVus7Z9XSONHE%3 z+M0x^ zoK{I!G*7e41$@*I_T2zc*dHD#Y5fT!Wi+IfD;k}N(vRg(;h5bN6lHh?P zDSZysJA&BU>Rdq>k}8F)030bzhouCVHtMW8Ix3kd<-_Z7NMnfvb4>vjXw;LnY;+30 zx^753eU&Jf=&Cx}Q?u5aTE4puk~$nRog>5I@)iZHW^pH-0UmT~5~@gr0|jz-sU+Ig z;-2HXCIqYCDuK;$kB6d^`2!TJtIe6eA>efJVEJb_!-pBE@d%oDpsS(AQl)8Hrbzaq z$gJ%XASOm&zB&+RO@7Bn!AILd9nrcSdJuTqmpTs8^sJirjl8z41wNNV0Wsn(V@P&8rizE1t}@Ug4xxxP9+Sjei(`9 z$BjErlPV4^O;1To^Ip83Vd4=!=eioDHQa= zb1b51E8uw6H$Uj%7D!Mw)KUWi1S1Nq|Nke~lewNLg7Q(Z)EDvIngRwdQOs zFz6_9{MDI!!Z8{qc>L(7)+R-pbdeEKBz0@CDRcY1@5F3dk_jdh52+L~y}#}jhQf6u zjvEKgloDf^i78;lFtn=1X(gSg8w17ZAvBnZQTy5nHnd@ssuIn$z$W0|l@_cSK?BdC znsV;wiAt3x4H!bY`hE4w3d{IOI8Wt&rKw~-L|b$2~jX+czIP%`iG~+a?U5y z95WKfAsK5G%hVY54474X+fnObiKLEb#QNg~FAfKby^lrv3G@;q-(<%!JuWN92bFS??{c!Ea^nt+gJ#Y{SaNv?HRP8mfl zZX-+(;PeX`(9=A7L#SISO!9AGcDZnSf(RUBuRt9lor0Q&ufX0K2D+$Q? zC#{_<>Shvf+&>Ay^Mw*go%7UdNkcemVJq5~NJXz;sjg zXH$t07}5IZuR?GfOAW_*iJNihvC5q1iPz?wLleVk=8dLEu_-Cw5;_DCrH~W0JLnd~ z9t2;^RHq6EjW`OHSf&YF#iCa!hT^F=3s^6LgfKi<#^mG z6=q$jw&vqY-pCqCr%DN$F}G=zB$ALo#(F6mnX=AbgB*qP3sDRhVi2Y?hE}ahLs?N6 zys0$`=T461QrY} zeQl^D9wN6SsI6F#W6~(yO%%7?jf8C;doii`0+t%OTvn!@m8)K|kc?v{VGN>MDV85Fna0)KIHwU?6V?u(C$`5Y~hCu=ZVbx3A zZvevad_i*VC6^(k!snxn@oYeuBxsTk(*RmKNTE%LIsj}taVjs1Y1KS%>!8T-m=y8S z?7Nb>e+>0_-83J`Fv*&p7+GeLw-Ttmkz?~D0bNn9S(pYQ;OoOD^Ax< zDPmJYN0w)#!!fDj!m#S9oIaYSnMF8sl3zLos@jU4e0#!>+BbW9qV#3`YX=N{lwc50 zNi-KpmFh7l+Yrpl<-ltW6JJ#?`ZW|=5-DR;N?=pXYb(Ch_l>(RWsbe42Jq^n;#K!a zru-`|;TR4f^YJtcBdH(G69ZEtNePi)EKn8_2^5j#1{wp{aJlP+D*`b1Q>bN0I2knW zn4rtehet(A{`XN$PX!JyN~;7_Q3gp#P!7W66^hSyvA&n$bQg7*`$xFdyRcCS+IfmV zzD>$h71)gUZU=(m_|`W|EnXo%nORLf5G7@G^K}aHz^X#uMz}iPibB^qr1g2$)Pw>A zdYb>xLgviFC1jYTM3uDojw>{f)l}lY=`l%FSQtptfwddo2z}B*71zH3_Dv-tNFEwE zc*>-00)c$b9c^OGSBld-Ph5Ur;W12!K_tcY$2z1fb#+n#?a{O&hUr)kkZ}~9O{{px z@X#?^m}_#DVVf_SiAEoftd$YTiK~j}8b*;?qC0>X8*Wf;4e!Mvl&nb`DF|ASaOj~I zq?xvpC}4djo_btA7_P^$Tz>W{Z z)zE3gtxAE!{Hn^b?QIq}MThymO=TC%$C&6IsyT#JL`S^D84)CPQ*r@dcU)>T{WRth1t(dTm={?ww4j^>RX2OjIVVfAGrNXJNUh!5`R7ldt zI;9%zksxh?IOBGaNfF(M1GU?iUI>VYnl|_hg20L ziAdHmhU55#9sI7p52nN`^1NtpTyBb;qD#}eRv4r)D(`sS zLIkYatz;yNb61x@EgTSVB7?bQvx{(#xk)k)M^!zvQPtp8bICej*p4mbLyEpDv{j`c zkkm?u`y>UA_&fKxzPv(~G&u_KY1tpG55Joit@S6sN!ofn{AjiMl*oB&s$&7mdAAiz zy9Pfjk3}Rup@Mb8ljayNmnt7VRv~tVC7V^?mv(}*lQ?uxAAg()a3N_b!Y8MVR~B`S zvlQy@STSp4#wrAk`$f2b*9@Ogv5$o(_#=TEl*d7 zM^^OmQ^QYF1HdWTo-w*{Du9VajYg>oWHY1K0 zF$@^Wm`y?=h<;UHYP9Ot49G~@&b!F5*HCQh=t+_yN4C5fUdfty!J?zWDd&|i*fD9b zG9~k7gvj1=Ib@m%R3JsNlX%U$f(C<@D^i5abyW&`xx*92nyRR)EAstFs)Qso0r3~0 zGReR6Qg2ZjNcLc3OYTB%>>|UJ3P3U|&Lu=aGfXwPN$M-G%rb^|#v95NlvFXnA#{#a z6U!0=a>L(awN#Qt?mu)Y4icPB5llSDPue|tXhy>_WcZ~{8zwsxxO8}u$x(^?#Yt&e zD3md_+mw@VRgSb4ROR@ou*w;pi{|O%@@&)l zkqID)6=H3Q!AX3J|lA+yTJed2EN0hXL^cg&*##45IukdlSd5tfwl}ON-&v za>*cSxD4{O8$=?bf*rR>B?okiu%(^$?iUv$UPh~89gZThV=TfF^dcuot7(@jl{VU;xy)6`Yc7xM&$p`DdCJ(|kpm}zZD;l-`qmLg- z2IgpH<-kY?1VB#-ot$Vu!*ae29vPPKihMZHR>6&Y#ZGIlo!)q;CBm2GX%t4pZU;n_ z*Hj@%u;K?U5urs%@gIj@trX@KuOZ|lVuQn=^>umUOjwm zAoYo)oLDwp3y9^+B+G?V($mBIj}xne23b&o6%nNJ1e;u2TOrgCM-7(p)KYen!lWB^ z5UXDwfTL;a>iugjJ%-g((=mq}JX0?iWz9lqZi9)k~T=F-k~d#OX7_M^_8QhT<^Pidr~ojIk_7 z%#f_C%%l9AtaaD6gM^Qug%G4|7!gAzu0p|3bm|5O!U^lbeU$T6kHrOaElY?W<`{Hy zJ{=5b(BZJk^Tb|2)jK!rMmyDw*xabpa^IB*NzZ{ri-0RyN>#9QdGynK*|RZ0 zh+|clwj)DZgkiO34_ZuKKbJ}8Xm=~pwGu=ujKHGr2Hn_d3MS-|=Y%X+aY05$8h$mKP_dIR_g=5~= zHrI)=w_iaGu27Tj6q)el;~IiBEG7i)2W-_nb-t=>db6i7NVQl_GnDfEHVIoxH_AGs z%3e~EYQ-2cfVz@yFSISWHf1f6$pTE&Cz=x5pf6}NoWm#~!;=S>6rzr^5UhQeL8wzJ zNRp^VnG%`V8Z>1j1_6byW5pVdC<7D2=TsVW1#kjr!{teG{CGTc@y{8>u^FMmB*v(s zs905!GSkTQ4euwH8ymPcCr`6$6+FlaBx5`{`BK)&A|^bkWr3`8DrjmjD&>qjQ(^Ql zPZ^67l~hQw7bt;AQf+2aZtQPvB`QcDf;_Rpt`bQggU~wZaw#zUcMz_Z4|bl52az#M zcA950)y)cs(l!yeP#IZ*ce1VS2-lh_?vgaC6NM>ZDq75l6w^_L!;0e4QY5T!;6^1; zhs22;MDAULf*&vx-{rl*Q-2b4AiA|JDe*y`Jr(4-6i66G&brTs(^t_;S&33nEo5{t zHC;Ml(Lq@aRGv?i4NPz|0=`%~EG|ghVc^=9+j?dR<4rT(EMR=8`il#s!_6)uTZKLq zg--BBxU5e*&m6<_GpI0mra>E(4Rf_u-q%shsW`$;Jr%YcAtW80JvD}+3OZu3!xPDg z&m3~VwQ{hhSCT0atM^E^4`m4BX1&4JkEKNkgR`6|IYOLQUqvOe4p&SY0-CYj3Yrw8 zTCXvDxa*cFAy3g;{Gn*w$ae#=0CwXapGjH*j^BBvA7H0mkrS|V3M)Nw!SKw&oixc9 zv62PGv07Tp4zmoTFIM!?yVNQrB~HTrW2i|BSlpJ@);_biEb3Ck!Nac#cEJjDX##w> z)q;9r&pB@}biV|`b87s)V9Gx?g4SS|l#<0VLb!yBIi)caiJ3=r+hPGC);uD0)fK5} zGL=-4!r5CXL#g{jdC{WAbAB0zy5%V`oI?b_qNzBWW_jhqY9z0Yo`qqCk{IHioqU;O zaLPyNQI(FPL#szn5LQwrs%vjsI+p@F!>6x^^c2sRa;{{~xv7R;%n;-(#f0K9WxOhq zO57r`s#>oJX(d!zv}jYzgczNeqi(XPzZ+UhYtlSLVwt*J}V9dh+7KDO$^VPDN}ij`!Lf=Ci8*13^!P!|bRVpwxDi6vbipnO_7s#-{D zYAS7tR?_^tPdt*V6BLoJm9?Hdr3nJoxebJ%D-YdE&`))sfh6Eg)746xr;lSaF;z@5 z@5$5S6%$qBRMf9i6M3%wRZ9rnqd*i%ADJX??`YT5f`<1h1;i3|Z0M@9nFU+8l(IFc zQhIhq7{pNPg7o_|$taedzAO%}5RlQ(45+q(L@)`OG~FEKq-W5URVL)zb57l%0uIB| zMe55PQ-OM*j4;?bg;%drC$6FO8JuY<(l3{!ufXMM>`BYwk=I2}9A=z(Oe6BZcPjdZ z-L$Z`4lGwTol^|&oxs9q=yh`LsQBi zi5Fu;0NoJ%+mn7-+Z`?9sg8Y=5oyt`V+s-Q>I^F%#A)$7a~Y+B6vOJg=_zDMic~C6 zDGVv&P3VtefTy}h4WPLNSFJe1MJP!EDb`e#9kNAD%*%{n^)>WSR+9;-j=#*KXuUE2=f?{wj_~zjW}R}ow}r&dA3hL!lGqd*w_qJxqhb$!!ZhJ@biXH%Zby1 z^pzD=OF5D`^de_v+6!GkV|!nh%rQufrmT%YTQH}I69=w*RASN`9;eNKi6(_td&Yd% z@=FOL(!ePIDNv*n!t_R+B+YCLW}wvI7+qA-O+7>@QAaFzv{W^b6bn|%?yQm~;;sN& zxw^AlTa7UDicu%a(v$$$F&J&H|IrGnDL<@&sv4N)qr?_CrNgV+acR~TW_Fkv2vfDb z$(X40O<9a%M$bH~IE1rx&bJFscj^s!(SFmA-4ul195z+%u4*T#s~} zM+_QuYQSJmzKfrLJgCM{bl(}m{XFH2Um42K<8M!hVY%|3HVjV>STgl3Q`J&Dbg@L` zXvERq)xH280r$1SY2L17}##Ut#B+yVq<7KvO<+J@1++DTZkG&2-{I4s7WKGr-v`3 zkcg$jak|V>1vsnHK~U1ALQONT%Z8B^uD5cxxc83_Z5C3UqaTeET_Cum>O!zMY}r{U z)Kg;ARd{`L*t8PUO-DsdRV-49hn;-c!pMrGD@vN`sZ3`ArT10~&=Sn5if8*y#AP!a;M1ERE6 z=yywFK;t_-cA9v^ag>KH;TSy?e2OdPne!$Yg*bth7$c6UrC})0ZDF-{0JpyigGX5^ z5;#%i_3!Kwl&VSFO?YJVQ&eL3to5xVSaZ|=0HR_N8i%J5!?c+rqDJ$iaKQOz!`>dw zd0;IeyaA%d(zL9-iAdTEU_TmdY;vzQQ&rc?jme2%)v-@iQZXSgnLbfcnV?9vFOm|= zwKvGRrrjRsYhHUOeUrxA*rN5 z%PEdD2<9aPmPr(g*nn@x>{jb)7*iSJw$~{DOpH0|s?=;6OcOWe%sKIze9?`6qe)9w zfwYp-&qEX}s);4Smx3Y_ZNc58$rs?wmn9*6BBHFy1;I>u(2+q!iDR!@69$T=zGap1 z+Lw(gppjuDq>;C}1c8H=R0NxA-<4b1lYp%>gZAvDCL@tB3QQ{osmCbfOj4;*w-1vG zmYP5#m6|qZF)q+RZQk+kriV^6E(uWz5NSf#Yyk?UNb;zxsH#c~K02IKJJC~&QA)E7 zf;+h}jt>+Pk&$6PQ4wjxmkx1%yEaUWM7n5%F*qeNH z0{m*>>|kOKN5Zz!6+A~fYF%Dil`3e_DPx9dRq*;eLb{qr+MXp=ranbfN&!bkvk(a+ z1AB6aNmFq+)l}G(N3A5=1;QyC1d)r$~5^m z5(Wa9eYByl6*$t3a0qJRk?V1J@oYmLmS>=*#KkqHfq%)$(^JhB=|DbEM?f##u1(Go z>5V)&+eOX+_i?0tQ>w=>+~Mj!8it-+E|Un#SY|&h9W6V@479N3Dj*tFWnhcu-6C6? zweQ#xpEE~!ZU7WvyUI`IhNA$Tv~DtnX~S`9NlsnEB8EIh2ag`6Ve;k}Ry3%UV-rde zSfn>%5RhNE(%g>AEAJGApDM^J6f&Cxsg&SPiAQhlr#zK}tk{klLyON%4hw=}CQM3t zN;;cU(9~>K`B`fb73xaZZroPng=JDee&Xo?m_WdYGeJi3$HIvwbQ}i=jvQu%{6hx8 z@VaWB>UJ|8C70@+Xy~Ai5mm3Rf)6ULIi>O$(w;X-_MwT`E8PnMyk&OljY`B59$0Xs z?Pf?QN>U+UPCGXHX#t4gIgiSYTr&-(e7%U%VYr1n7_$7zP}H?!MvX8H?@jtW(z3Ak znMovE8UoUEtYT*xOK>hiR1h?zY$t)KxSW+#*q%3C79USG9Y^yN2C7<$n5({0aLS>T zma#&-l9r+h$69uVmtkf}EOzQjt&ZJw;^@w5wDf`H zp8=zy$L6BNDCCNsooS(I=CAUE=dPYcEH%wm%rsx=?Yq^ZnQ)Yy$Yb?G3ICiyz5b@P%ql-Vt1V{xZ8>%H1Q z(FH#W^XLw?rE3aGjuWE~TCoLNVv9gBAVAqdmJeHl z`P7uyWYsuC@&v@F%v zYCcO7uL#jrtt1fBH8RLp-OIFyp#)5BgY=9>nj7&_-%$bv2W>vf9vm+5Pk&pmTr2UXZ^>X1lk^)aXRLfA1WPS(El(m>OENfGT z;yBr-#TF1NNYpXsWjc#wsDwr*Wl5HY3VP}s z7M7_XtN#E-q`}^btR!&?g=edlPdzOnAlc^IhelTxuElB@=BSNgsrj0Uc>}amQ%2TgHXs|3a6tn6aNDIw)UAVOSDiLq2y+VK zjLY*?`Hiy$IVQO&<6J?o_Nc2`l8ScBBXxfwJ6YZp+$0tn0(qsNctAaT_0l!HiiyX7 zqBGYgugh8AqMb;>W{ylohaIPA^9?{1lTlPuR!vO@=yy0VJb_i)ZS2IABVI3Q0bxmr z90yf1X6!ncBx64hZ2a;744PWbDdrc6zyhAIeY5%CGCsuo&F)n;gy5h>Od>t zLAOf^P{edV`P8FsumX~#$QudS<|F4ub1K1>XO|IA>Rug)lW3|K28`0IPy^W6xh^HhY4aLzKLh2mC^p%J4RKV-ZU?=#cyo~A8|^+ zW77kokTzIo5TCS|pM57WJfkHkjj%d;XRoG;rwG7R<9N()Qo@RA<~Ct2<$IJPZkiBy z>j5iBIGicx$YjD}69D6~k~roGh(YodZ{}h&ffEPAljZ(ehN0-@*(8kBXdPyEAEF=& zsRGAdHXd$B;0+lzR-lytP7&oxysL@g6}8wl37O@Jrk}}|*8c!3^Q2=Uy)0C+ zuaNPp6_Htom`&_^aWb7k!t~%q-kPeNbxK5u_)QD4;-A&riBB9bO%`A^3y0L=4+oJQ zRJ71}3uIY06bzk(Ta$kq#p%v5kj@bs-4ju1*yyp*$Y?e~KtMoLx^plZq+z2wM5P;~ z8zlq@gRn5(-@CuzxvuAX-}gD6bLh6|)o4Z@GTOuQE?30w0$n06;lb<-rB!vcM4@{j zt{p<(1MRXeAuol9GvtNl~~igCPg{6enl8o-F4G+L=A+m%G?_bE(y8o;QdQ2$ZW z4!**KGwg3l%g-B ztgFPUf$;od9*-L8bLbjJQ?&|am$Ve}M|Rm7R+gR>%zox&Kf*D&Ol?1})0?efh*k(6 z&MnU^6hoHg@=v8rWGpPsBwN1KR^ze2C~UzZ^GMmH<_boZz1|eoH=uTE{+p`%N$Qa7FYAU_#YO){+7vk-fSF6Z7bWaI5wRR5<`-ZtdjCT5&Ho zk>0FYxJ2{Shw{4Kl=xx*C+8?tAzQ(rI$umZ@6KkVW?0HGMNB0>^ee<&aoGNQrGcmb`UfDTEo=0nmThbge^R9fvdAORW+MjFF4>#b@>hN zsb|7MsU_#N0-5NU^?GC8BDr9C@4^k_n4=u9D&{Zj#hGQF!1%oXBNMhzrvsbtq(K&y zW;s#El?-F{J9pKmq^i>mejT70zdo7VE_g!hxf9==@i*;HdgUbKN z<~hkWFLGb>T>fJgA^u0!nA^p@GH0=}vZQMoJ@$7%-%_7PAtkS{$hrWR*)6^uD*QB0 z(bt~0kJ?6Bve^8Dgl+Mz#Va#(Dsq?LpX$_lDl8FMlLbL51QE%x=*E$0RxbMUL` zKxIG5Spz>HM^Nygskpd)pN1)?+SQ2t68bG`y6H$OPxUb7k(qR?r6-fF+^~OI zKNC_^3j@2d!+CB6kL$L>wCJ0nzmCZ}k_1Ik5MF!0_PVJ`Zk%vGMaeez;gRiSTnx{C z3J>Lem=@qc*76C~`t5+@SHJiw4{P+pAbEdVET7cB$1Z3NZePleM*T%4V*EF^12GWq zixYRwf)D{JRkoCH!ht)pN_JlM0fOr?wJFN2wxs>Z3RwGou$38f$d7lBZrhw&dSxi- zz`}(#K;AG3Y0|oCNS0C#dgGtJivgt%bXlw;bos)ZehkB5MnW2Wi@?W>m?kH9EFxA`d+(uy(f8h+kS~w> zw*0BT6#a=)oie6{t&I090$AJPAyLIznP+<()&uB*Ogc^ZIHiwe#`ms8w$x0lqi$91J5{33OgZS#Jk7$?A9Iv&#Y6e-WyFh_PQeu~e+lxa1A{!Ct(I3v?&M|mdqGKOVH zxuw5~>=Sf+OAIq^Axf7PxcLG42a{kY4RA|XdZos!EgqO*bg7Z@qPT&X<*V3J<@ZDc;r#F?ZJ1{jZfU3JGkKOJyJ8 zH_n(yo?K>Eh4jCb`&z=*-7oy|~eo8yl?)QhWjHHkbqg#2B>_j@RwQC;kt&O|K@ z<)80oLRXI>Y?=~p&3qO$_;z-s;1?rm;teCw-!*e9r~VSCA@1B+x{R`Z+Xjns`oueL zfcu?v8L?)ZP#SSLb;E=v_l@xf)mK|@)T>}pBVs8pjwQnu1#d$jY{jh(iEb@DnH778 z0N$kYCP!%VCHRtS=&VA1W<&~mrf4FU$D0W3?82i^fl~~sn)npkW#Wu*9Uhr|lo@>w zlnXf=W-}@Lx$t^f-s0hFxDmgh&DUy4dqor12Ff!Q@)%3R;mYNH7jk2sF==pdWuXg+ zpc5xa>41Jci}pNWzVizH-6FeOsr@m@%Np#(x! z96Pyv5BOtS$F^+Ydb#K zJttIBU-q8!bpi)fo38knzJ5W+M7i}l!!0!~wbvz8{s67vr}d3BVABk6AcCw6r#uJP+NmPW=ZW){ejx)aOlY4w{04Caw2zAX=-nLr zW*Wq7?2x>Ud~1}Epv%T?YPKFOwpCLI>fr0}S8tWf7&us?B2QE{ZL5%03jOn&@F?~; z{DO8^arTw*-8(LUD+ts9ux-?{&Mql+wj?(g5na$d^OIrtcZ#>Tu#{`yx3dP>y$Ucp zKbR-o;*jPAJAqJV553%~u7=KoMdz+9=Jggw%q}|T9`6_dn29P~KRWMnWJcjFPOtE_Qw$hrz9t1ML@Z5qoe_ZK}s8Svf?*ip*UfNQGZFMe+!Q=;^l zc}UIJxa#S5L z2V3!ZYwlvZJ20#A{g>2?hqYNwuN`y(8Dj4@K`jncEY{a;)NV`A=X;e!A^sz?Er)lO zaUTj*)WVuYEk-H+7*mWElN!z~K7H%}*6V z%*`oGYW(+sQ`g7+2EKB!DlPyU5XS!3Qz*-VjJ{V$>C@dw%B=oux6nL`#4e+|0{1$r zYs@;evb-9$?%UV>ukG7}p?st9)j@uqD(DRA+{x-Q*C6Bxgo#eWR~># zwPHDx`kgvGoCc{qwq{u$1>wVBCnfiSS}R0# zx@)lvFsjmX_vlN|`kjY9#oKXTeT;GX(%yrEgDE6#3@w|T!J1!@C^X)nh^dPV5!V~@ zti^h})}+rul6l8KvLbxsKcjuf!m>xDpbVpi?fIQc#%^YyA~M2-#@Q_DaI9@nPH;5` zb)fRS5mcI&$6+V4XrN9LpuXEkX+J)a*fcQn1h zb0ootcl)e5gP>EO7nokdY5hfi?xkZOWA}%8oZ`K+iV~911##*4F=1t|7f*G~U0v<{ zKR7OWw@NS57s4L%CEHrji|S-Jeoa?)zyl;7W}HjW!&}C-}#+%5cG`S%EPoU z2N|(nTwSpz2HQ5mZbAYEy&75~t!3`Doe|vz-6C~Vl*C3`=WR%-oUt-dr7=G>SY)+y z5@I>{y&DvtGMKftY|ch6n*TC$t@Jgf8V$JZlEZ5Ccf3k&N>)WRLx4Ob_$JST{^>Mv zjpnCccxdCxRv5=Rtns;A3)je3vD)H`t>2Amz9Rw>%9d)JC=sYNwV4aSPCVr{1e8(9 zMfTQWJ7rv})s&|4?`9AhM0W=pUjpm{nb1|wOZ<9$JJFNjH}CIAN$Q9#cyFr|9`nqN z8D+Gh3=4^3p5JcbMyzK4aP zIS=eP04r2}sUjG))895(U2j&&%G5qjA)=r;NdhXvp8-H*i5P`B%K+FezdckS3T=xW zN+H3^K$uPX+jNytt5-00LvkdA;JTW0kCTkNySlnhz$e~r!`JDuL6-i}$#j3}n8Nhs zvDW;uN}s9C3%SHH4KP?~v_XPKza2I$;g+ClM?saYr@*9S4<%eEB4N-o-Fo}XPv9UK z!X~+`-?JiTRqx2tmc|0nh#zezW-6Ymzw#)mtrcz4vDVLY+Ztr^zmqc(nSKP;2Wjsg z>HV4VXZNe;_Y!>Z0BBXrI*fgE{J1fNLyot%YD6`p8wL2bP}sQ55aYg6!R|-*M*RD{jE)`~#^(eqeJnl~u`mybHTkBFA-nWLq+vq?vZ^P4@NE|&S zG!W}Dk8s!&j|93rb;7lpF9ldYmsn33K$YsO{Y)~3BYL|V1E(|F(PzAQE+9+AnT%L{ z9ae9h-8%Y&xVGdGEG&<&C^=Iyc+VInh z^|Fwij=t;CLS070Kn4hvDPQuE``n`98vl>jfpQz?hoZ6zLJrUsU9*)H7G6 zhg+5&Uy|5q+yz@PJygML^Pz|qfeVKkSVL+?(e`IxUuM7OJZmbYpz=(l(Uihd? zl+&x#JLF7N-k^=m?QDW%Vn42bcrWwd=VDkHF_v~tK>Ni<&3=zb+jxJK|Hz~uOvCUq zZ6=@V;=k=_)4#E(XVW{EsI3@MkKp~6DfE5Ro@84XS>u$u3?83sXmVIHXIpUX9o+TT z2RMlY;r1>?YWIHvpF-2qfC5^3d%W$_h`D!R>?abC=h-tA4&bkOESe+#VgU5DtVz`L+!o7Qhb zRm2baUIJ#AovliPj^tSJ7r2e|=azvCebwdH3^IY$NO}I^(xY4m5$l+G;xCh{yf0$= zE%2|DWQbn?uA*v?g<=1691@DYX?!F!f{k!15N@3MRkD%|D|uAI)TwGQqYA}UMnp&r ztS9L$IRwh&IZcOXT1Q2}VZ*m+Vlx#EKmUy8o)>r;EaJgH8YMthtIKIaFj;>QPJb6% zXD7bL3jWsP{)bJ_0G4`ufopxWYZ%6H^x$dxq04C6{gh`a6@$mat-pz}@vf+Xm0!b4 zOHGDTOW|YWp~>!y{QhnXd_J^jP5rUnu?-gXYHd@<V2d;rL3psJ zwsNA-?Hc-WU#`l$ESCwY^1)hCu6|J}t7?$RM?YANr!J8MRpVr;bNYW%Ja#W{@%@v| z(>tv*5~K~=&=8HDe|`A2Na-DRB49L;eBzlQV7Rt=vUVb7r+PG+n7uDRYa>0UTQ z!RSF6K&4N%L(^i=SmwabyIbb%4OPiune%>I?P}5u%%qk!0wS{6)5wOV!UgItH-f!)s4VKO&6?Uf3GOo zvxBZW%Mk4t|4<3}`m=nX+wi${siddmq3K;-O+&I!t33Hkn{^l!cWz6jexfcc)?~vS zc-#!dNNpIgpSoCZTH1CtYds30_X|U(S{PY#*73sz(@W+gPtMK)_;u>heTg3eObiU* zDVnIdki4=8XZcC@63v)LJhqEb-PJn|sk|YBdPX+G*;zTlhrH?X*JA9S& z$FAI^%$|xdhBn-JghQO3?ZJ)Fnk@>68=b14wUBkA_brcBqE&?1_DVg4SWoR+Pn^m# z&0Kx65j`&HD_93KkAW-m7<$3~k&$NDRhXD5H%^2{S|mk39JY1l%Y4KAj#GRNGJN+R z3TjV?Wk_BFg)lfAgL0c`Sa|I6MqAZ{MPoEDbNZMvyH(9!X79z_x-!mB)Usgw;-(FA zj(Ao!$#l_|9^dt1I7a`cVyKZAHI&w6YQmj+gR>`i74`1V$(m%F<=D>fQ^`)a1iSM7 zX7>qr;uc0&YGg1Fil>zeTItm-MpR`U+_(20xlBW33dQ8}W>m==ElQ`U^W_={Ct#T3 z5x9qn)7_UMGV(9ARQ5go41z{WydUS=w_aTs(Vv`EamLjOBrhMRK;eJiU-xcl>atec zz+7nPV#c#4L{MQr6T&&aJmzB&@90BH+PlCiOa2Id`A+Bp-~&$nNm-Azo(5|2Vx^=# z>l$O|6#6Hr*maprf)8$=p+vKYmF>iq5`)#1Cq{^5-zbASk@ffwHJG@1Ou_YVaW!{- zX_N;Kkt_e^Q;UT2aGShpYrm$xxOM(q3Q}^;eS;@iy*1?4ezB(|JIQJ(@6=~jY5{Ni z*gUX#i=$!uOyO@cpgV$&81P%;FH)C-`?T&SVGJrOleXrWKEy!jFa0QBxrabT&7!GE zaC%kQhG3C&zfkEOzR+|!TWXMZQ_$7A&`$i^oQ->!SJXTFJs3Ijwe!*l3HY(ozikG@ z>aZdAV(+~pDnEK7M=e~C8KPhfOE}ifIKR(i8o zDWd4uwVJGzsBY4X#+Q3O3fV8drL+rgb*n?jHI>8bwAd3-WJOY^+s2yNmbjC$%v*$M z<`OFS>P8+V=sP>l#|$<7N5~-#tF}}!?)vR_e|3Y-mX7hh=QV3{6bkh^J#;RAyL05M zkRyd>*gy>;uN%r3r7HtaiIGsPggPwNQQzP9_wuz{oaFiG*du}xDFFtN=!i>xwC_=vE$WZ znZv#etZ62O(KIWrnizfj2QI`18Sk*6=kS%b#o#bd6#O@f2;Z1(P4gMH= zR4``t&Jqx=ZQRv3DaJ*yRfaOn!ih?}@JE4sTmD-y`}Q9hn=+c-P)^_)*wsD+v0jSj z{ATg0S{_(!D_-)`iFbU9g;LI+EqZlb2c+g1p@taIJo@x1b51<;MCnLhbSCzr%yO#h z^OJL4DID{5w5&|AVJ^y8@Ha<5#*iEszS?>~t#-;y=G}U{qsv(_T+R)})RY;lSoj@_Ttf4gQGZH3ccOk)SU zc%j|Arnkqme$u{x;0ASc+q8gpo8_o`i^H;T({HOS|94g~{~sBL@B!p2vz&GLP>`HJ z+Qa56;^pn@<~s?z`&XApQ|^(0BuUdj6#%=$pw_)Vwo!EAd%b4@=6`WXq^#`5mYK`{@0eq&We3}{TNBzZgazWlN>v$!ja6F}hhTr3U zyWI&TtELqAEyj*TT0;6Gk`&{Y(6~I8=usq9^qM4TV*cms3y-Vn^&6ih4XW66@;^#= zig-H3sp`U}H^Jl#7qf%E!V$(oLx(whW7rc6B)~r91fwX!@evfCR(Gs!%rGSPAB$Z~||m53i`kSJC7DX@<^EVK1eD^LJhIk8g5>vtnzs0{0>s zR-fr@lu0e3_=k!DZm3jqdxJYySKdgP|5mbOS>&5kxfYW+(+tsspKA-NMS{0gDrPFr zpYGvXyv`y{x_&1Qdn8g1wK1VUk?J=%LsaULBIR7J()|;5QZ4{P`A!sd=RpH!OeHh} zXj%v%x7-~4wup@d-ZT?GPSv++G=l3!k8UP;E2(gFZdDm<6f3cSX$yZD{Ur77y)c<@ z?`6=hUS!0HWeAKrLp2fb@WY1N0fu7nZ_$nIClk+lYR{mo*PG9SOY1{%^gjOtzeZW( zJgkgmx3cdKt1bCgu}yeYHjWWr+1s*JBN-rYE|=7CMl$zUGml_8_O3> zGDM`+9q z!6OVyazLQ_?4iyx?K#{!x*+H82zs@+dQ=M2J)xdq`RTz%=tf`ZK`Ud;U zx5-KA#0lY1S1R$;=rF7Acg=Vl;>{CRCVjvblL}`tYHg8c;Y6=wL8yD7TTam3tq*Lk zX4t~8crdRKH?K^%{S=jrc=<3#~3dwKTV+)5@RLTe;-Wi*oS!wV=hklSM`%b@lvh&&0ak8VSE5OH)~E0jiBs zekGLF_YWhW=?;nA54f7{A5>6X58e!pd6f>Zed_OsfXdHF=*^-Wsnvaz+~9Ah74g>5 z2=HF^Rsr*80buMb#x+<6W{u`P)9#@Z@x9e0{aNtZjxE<&VoFx69AEEyVy<;oR)WFc zc{Mp`Ow<+jNF{-ZZZLr-2euC+`#G#983~p z3JU6^3JP9yjx-S|fE_(hzjbZ9{qUvF507n+Tr7-+D8JuX0~0mxL@cYXyRo|zd>3bu zq#+EQK8V3!MLAaVOk)2wKB}S+r8L{4c*f->-|hFZJb3zT$1I9cS{D-7M=z?lrTA;v zB9?`F<;BdJ=Gd!%B4VR;4_i%HZ63t7n>r$b2VDFJUi0sz5taXPYD);sa4mpnl`o@t zsYTXwC-V0zF#4B%I4zxt&5ayw!EDG%$ZafHZ7GHwD`-55;|<*n6n()L8HVh!iry-R zUe=g_F?Kq6=u30*bGz5t0jCPs-;I-(t_4hjAv9uEqD{)ns5uDI(TX_}SUls$>n}(Z z(8eljMSoEuR+&~&*;%S56Sx<7qIkygAQm{K+PbH*a)0W1&e{QIpZyyKoJ0mHLC-!V zC2to{-G&>6{yXYkBekxzUpwtfi&;XyGhC?>3MhY|jZTW{(k2{4-3lEzM^8A&W_e<% zhA+ViXE)~%LR)u@bB;5FzPa^T26>nTF?x?Xd&)t^!iw9?A~bNncOstomHdb|p|aW0 zzloTcZRs5ArW01rM@!TJ#Yc&+aJE^Kg~c?6J5)D0yR$UE(16E-TnYDu;2ftIth`}q zTf`>#a9sR_>{O=C|NMd*fYJ_7+kBUw{x(ln{DjU~06SPvjTn1-I<6GF-XNIrk(${| z5|)J8KNZl*<6Z?*Q84sxVjjvD#7N_is>44-M{_2O)003E7j+cKLL=e7uJ{|QdJNp4 zrP6Oj%su#fa4Ql{pPpGPG5J$v+TTJbn1X&G@JHIUs-5w1)gm+nMzW013z<&=DWSbxKc{p(eK3z3cKiKh+WpOcB=Yvn2Ztl zq+NsdudNaL8@}H7AXC5?J;oy)*oq4JGW+TCF|%VPOnl*NOsw>dKbX_iR@r(dxpW@(^Dfc-%0clEd?hT zzhNny$1^!l15Bv-AIij}&C0Sob#5evD~pbzRqe4`*UUrLwI8w8@9lFKIO;MrF^rS+ zqk)y2XRj^@L0@P&C4k>;o1Tdo>+0jBkxL`V-B*#F?BjL@yQBDf*A=geIA`l#!tlO) zhUQHX3)DO11gP1_?|=rHZ-}mM0$ek9Z_oP(T?b=%BO)I$vOkwhKRLwpYuMXimeg?} z7VBGUyo5f=sDaPpxj$MBVeg@ajiDy=Zt}_2vT9QAHNK^E8&tR zfhBM0fLqRmRNleU*5{sLZ8YZS%B$omvr3`#_@UL)rixpjj9afmvY{-%&-2x)b=I2R z3u8$(1C|zt-%j-)l5s=%t#O6N4dp~XdpD1eGL+}WnR5WBm5dQuEiTOxRst$@ASJXN@nv-Kp!?s@Y7NCSI^WMqR7Y& zl|LFXp9N|pi3sZjBh!2YM%&Z*!-}n&rJ)3snFrY`uO6_%kZLa!t1#>v^1YIb-ya`0 zb-u2mUoyNK+;mWD7^bPU$4WAHc@Esa>*hQk^dUTvP1P2q&&eG6m@RUB7MTY-%r=EI z6ol3@?Q3&6{RugETnZ<%Oxm{THqJHub zS=NoNdF^;o+aO|_Wh9{gFGeDgf|!>;FG_sDI5<>yg&{CBq&&vW4jaWj8S}3T-SdSy z9=3`|z-j=MO(owEVwy)gqV_v;=?nW;OZ!)ArVT(_`Qy85!XzU-CNx&TrtAMFIR-a+HEs(mkQM7l^&-drB@Wtnu`RB$tPs0 z`#3m0dK_bzAg=N@L*-XGKWAX4Z5anojaLp=njzxbAA2PanPF%7@Q0njt-qnei*<34 zXH$j-5-G2JW;dEy3-o;!kcg$#DH;y*)b;u43^%@NBcm08B>gYiyuSj*ii1z0I}u(f z!ymnveEwUdyz+YB)83^CROJ>|^qtg8DP1QCV1}M%O0KSoviGnvwx5i4A^Ug2#6Vwux}j0D6EcR z+rk>y>PHDZmMbsep)+qDp44{lcDLOVR=G7CS4;akao$;Ee6?b(7YDwd?(zFf(+W7+ zaPU68#vPhL9b+gzUzg8+UmBWy5c+CO>yM3JEGKgv^VLsrHoXAJkNWctvi`R?dwfF{ z{F1a2Jru8aMp*J?4zpc5PZJjQZ0f4v&Pv*pM%f94v+Z5U??&2uCZTUw6Ea#q`Wn+Zx<&+A>VK)xopi&; zHIFg+iTIZ@Z`lgjJLYz`vnG0~SUthwsw<4hp9iP6ng0?uU^grXGPqMvmBUiqf^Q&# z^I#6__UiRY4a%0FGE2I>#IEu4EOSQOmgP@3pl2P$ARKilmN{QBm%MNLPBOjHGjd29 z(QuDLKiOi+;&MV)z+huzc5%QQ%EF9OU})LYxWqf2F4u^ShVuUWfaqQU5-45x?tbeD zzxaeAwBaXML=uPr}MK4KHu&` zdh1tOz8RF|`%W%EJ1g3hOu%?sSQ~p3ctW%+M%no4N+yLu$J3n?(3tkxzH}_Pb&d2m zwXoL=(2umt7rp%39(?Xt0iB>f;rAv+)Q?%GQcZIf=(`dZ4<-cQTllQ`{n1*TF)~ku zzSoD()_7T*!SJ;jKns8b{ChqQ;rgH+W%)uzD*Hb&wV|{AKrpiG%IB)qb@WGoxz?gCkn z&Djf91cvSuFpuM;o!l(4f-ia<`QuaxsQ0!#olE7HcGC8$BjyqtX~>~zqrhvYcUV=d?6{%vMy2Xzj2DR`6GBYC=~*6}F`>7!>-jIk$3Ttd>z|hB+pkGLm&3MvMP(On3UV zb8eS+KWZV`Uw9yxO%ly+(;Wx{3Dm|pszLW(P}wv2LrjDi(^e2JoYONPnV8s6Q{JL5PfIwiJOryIVfOsL=)DL*MUVM-` zlvPzGvzvu+%tptSE^ZsHx4mIu4>J*!EY01HhZc>zXbjX+O?mFIpwE%y?)u=*~x8X9;? zV|Au>D+S>-keK?RM9VFPIl7ISoSI7t^jRQbOOs>)ivXf z5?>C0*cv5SfN|gXmiem|nQl^!_|@+&d3gtYuyC_*?F_1@svtB}QS(B*?N(I0{+7$} zy?L@hv$BNP$JQNp)HQS8k{)IvzZPO(yf7&#_+bV`j}pBvHNwT}>StTvSYcedendh_ z;lz!C`jb>o*EB}^y-V4d_`2bxEJPUMTsXCXTIo6tO1qnolbJhFBi|m`wQ<+Ldh`-L z<#R#T+V{M%OL_V4Xd`=?<)j!svG}MLQf)t)MGV74c7mx~>i=Tz&iL)zlENXk43k_s z>So^SiVFy;3d+YFhTU_n;61~uJz>s>IRg5H$%;c?9-UmE1QXtDh=UkN+g zH((JNyb1Y46IN_R_k-@+YTOaw4A?TtN|^&aTJfBb!Vu6&vb?_UkGeiy0lig7Dwt34f0Z ztHQxEZ6v{Yx^5a`2UDj4_uokX)|@M;6kJvD=bdU$AXsYX1xTKn=jAayfC)u@UG}0J z>L#GEZo-UA5)_bQmf7$jNL zEwje@^M^bgE#Zr+)B82Z`&NOoV|GOmkF-l8LW9QqSgb~{dn1+1^hM!V-r(jkNt}Tf zo(|BwF~3_Kqd(h`TV4B}GG1%*03e6I^DI~%O-qwQKBmYpidP<0U08ML?A5?m6RNHz zv){oA2<$WMlOhtw<2#t2T<|)!&~HmfV3hEX5QFpL(9ynKKJS&-=w*sBi+EeJ100z%!3|OCjK$HpXKN0( z$5nZ3TqsrigS4S#^#5EkT!VV(U$D%E-Yie`SQ;S@M_GX4mWVl7vj?e9EEs-g9^tv2 zxIOBNSs`y_zFO(BW$&6TnGtE?&L`yf5q6Tl62}`Sk`X4Cb>4~)`|81~HQHF0s{^Q< z)V1r?Tg&4aCjoAZDut!0uXYa(Lr zaJHOSgJU38mp)eXMw?Q^j3&5ro(22!^m*q46t97fJ$amL&v~U@S>*gZ3{kHM^JS5o zeg4)ppVkp389@m%!mUP*c4!B=*^ns_SmXm;#{5(gwohrdZ94pXdg(VaYlK>iH@G~i zh81PZ8Wc^FTr5|R7P?L`%Su+OuI#f$Mahyj?&$?NV$pqL0|rr!TT`u`6!;55%pxR& z4G)al3w1N>&SZU|aD)l4=iVlX5@0OWKtRmcDFt@dy-^%5F$Mrs#6=^?BD0C_->}t0 z2v|~XFPkg-*C_8wC%kKZLu$IqH~%oC5IKg*$6`-}V>||x1;sKao$Md8tDG{3EQrRl z=aTzB$$o-*9Pa@MF!3ePZb@8kk5;<32LmOd9fz{PTOCY}g7CgeVwwgPUIgzG2__W8 zJRn-@ysZ8sESf26_4DPWe%I8Oye6pGeA+$EwxA!KH4r7*p7}VF;^pPswm#`g`bt%4 zkg|<#8~EhJJscT61yY<|N>7=XMi|r{8eb|2A%;w}_`qZRT~bZ%C3kZ#&2^()pb7UB z*#8b!vDvTIRW*w-#}JFSjF@VUvSVI46>;!u`8@6Zg2gxai_7sC4ad$_)B<|Bb0#u# zEmC90EK%_XS?B^60@R60SEW%J7y=D4tK@-*XZ123t1Ysrtvq#f-;i-V2-sgY$ZIZF zv*J!~8)@M+JrEPfZvA9(2wW+AdInKU926TNnIJ294R0VAQJBDUqgp*n(W#zy_kDUe z9V)V7;;LiWS6II^$?Ra^)jB2_ZGTSROUxya`h>q-tuzVJQXN@$m!3heUN(TXx`L%~ zy+=bLRH{oKc5sIDkBos$h8E*e$J3|YIz~{|=ax09ksFFHgl1H~2XnuoMiU6lz!us2 zMMG5~DX_EB8SX>%=a9j+wJkgGuBtkCPIPImuSL`?5U})3G%@%)BP{cNW6K@-aj+D4 z_9kpU{E5&;mqnq%NAImtrj*1Wz3G>^8<^eby>(G3`n3wlbjqITU5w5WXY?qqM%atD zC|AY;+Qk&#{eFwEeSz^s#p%8TH_f(LU-AGr=Aw{N1v&p*pGP!NG0+ znz1J?(A%SD)maM*tJYP9mWV&^9(!H6dtg}h=uzE0An&kJy+KorZDFaxv+85}0fQlRtZqU}`vFi{mZ)oOal2kgT+VgAh22I8sv z8);d4-+E)x-iZ4%d6sEdTu<=VxG~thT3{p(1)aKvjm$R~-Q~l0TXUODvqrpMa^&h@ z7}N38c1}3Dk%(-|gaLD7I%`Z)IrS`HU3dvS-L9#?LqZSVOmhXA!ZiHbFBctJ)93%K zxzF9@8gA>oBt`__jQLHZd;)@RQU>H|Z{M1-=qMjZ6WbxTs`&gq>R1km2NhQRv&WSy zR*q%5`-;&fEg!`#ky=hBI$Wk*6j(nSjseQ6L3%4eFbgG zM_oON4rCNj6UUS(_;icVXDU)XZKzj$!lzWO5rlt)syW<&t-jN(E4#MG@$-^0mpp)k z()7r-DdDS`DUCrZv<71;o2p6iaNPa~x{5J0m5BUgt%~bm8V!K(J1DySO7~RGJ1aat zCxA~0Yj&|SuZ*pP?P9*V2;dvFn8w#12!FM>iV>!4%H&vq49D_S{O zrAY84Xg29m%g?|xv${-#CvIo6uP#3PA|^Y64LhVAT%%~A07agmR zgr#+Jg|7DR54~d|D?*V>V(Dt*)*Y1Ph(y{cXsBg<)rfmbB4a~U`c~HZYGbOU^f2ac zxhSLiyNWfyEps-~iS1$TzBu@We7a^TP>GM$`}Ax=Ko1I=>=frT2ym%9|!It=(KaMhKgt-m%Hf6|()#1@AE-@Lr z<$-GMMicULUxBpc=%7&rS*BI!&nJ9Wx_T!g4;eDJ$b!O5>Aw{?Nl3!%U}nqvp3Ts7 zlW*z0y;Rvi@$N6)jdr$A((X833Xxntp-<{3UXmi6p(~&6l{Hrh);EnQKrc(oh$6g) zD1}B&L^i!m8M-6fz?w;&nRo5Z!#Oah6yMp)hSLa73HYC(re*TtE1iU-mF3liq1ZN~ff4T2 zP3N5rErczX@D8KT@B(8)939GUf+5ga6yFQ74bj)<5=*Olksxhsl~Ub!7TUd%4jkW> z5GhD{^|>42phHV{ZT-%dEq5v@yH&8i%AeX5B|!Pn_^)e59c5i}Wm&~Vqd{R=H?dMR zCWo0=4Jp=49%xVrQv1-q(UB_O6VDTL>s`F}V4CKCWI`dzfuNx~%mFnMZa@-d0wEBG z6n#ZQOsweYi`peI{7rCC5ZqEHib7c6)p^dNp<&A($ytU?qV(e|Tg91Z`a%++{bD`( z*fnTMhU2X+lf|?y%F$^yZ<8r`6N;IGvN!@6uI;4bYGX znOik|l}yaX7A?t;{x1RVU>V{|mf%kPd` z9PL49O%A~3OMj~b-A5GZeFE^q!ZW9dtBZ)753Z z5ra(9pa|0os8M2U4++sOon-A8QMKcVWj)*wL4y&9iorpb>To;;wrR)A94c6Asqk7D z>09|ZNK|FqR0=lqr!C}VM2pl=%N=&;^iDtaV zRGFU-sC;IMN~+9H55eH8iE1$-iYck)h_$38r3TTB&iCICUL! zQq5HKa7?q(!&D-RZ`$*sGO<-+0op82iBc~9(1)VI8=afNLPrS z35~QH_1~sc`I92ghGDqgH-UL?ON-(4xpAcOD4r8L$db`i5FOq^q|0k6TS6{)UzOhX zDhe=F(MEahRP&FZvJQmt;zzVvQ~bUtcWvg&sRYd7);;p~QX2YAobE zL~9hkqavZ7aW~zdE8@H_xGn?W8+vwAEvd3RM`a0lR;sF|YAk0ClMRAu!VPq_a4N=; zM#M37s8ZWjFv{);_pNI;3zT3Gq~jQQ(UJ>pBthq{gj_DO2gfn0DClb74V2K*>~!0Cb|TRNhgZtqNzaOtNk3kAjKAjct(5vnyb z(;N>MqRX&UN{u6xWR6(~jF923RyQQCei*#yD+knkDU=luLC1t}uTx++23Nvy3`;UB zRG3v9(uk*NOy|gvd=w$Yqr@>W!*B1V7O=by z9enVj$&T0Jbv<s0Hw2eHtQ@u2le=#I-GCF`JR~IB6-Wn~;89$Vf z0Y_=3EL9GaPCV?Z4(KZ9EDI*obn2Q^l`x9hr@^s$c6O?sraH=!wN8^mG%l0K6d!wP zn_A;u1fK50g-6ObRJ&(%>0mSj5$zwX8;B@{7G0~tX>rUuGcF?nV_34u6z`1H#Sn1(rrio6nw z6_!}4>2Q+wVNonmF4)#q3b(Ucz}Oxa8wIIEY4Dsd<4;}|OIoKGoOpXE4Tmn~yi`Mp zVL14U8>yrIK}kVDBy|xp!ep9A$^~U;jU#N{M&qeq4ftxMrL`348b&l0O^V1$!-N%V z>ODI)MG0AQj=Eejx{`e1hW`L8rFvl&W6VKb8d)N!@?J?2HS@%Aw7U+~u{%IEBypEQ zP(acFS4AN$6zMwWPXol$b&eY*BSrEt)YoD!Bp6LLCp|+}7!68HDxz5-XNKws*?TI+ z1&Ai^TCEBIg9e^xLz1W%Q`T9G(fKI zNHU=%kdo_iyIkv~j|+=}F&-m~(aS1xP$5D;qu15@>EjBh%h|SvGh;ZtMIKOPqlH>bsV#Dp9k@#jT_8Rq^(IK zx<2pHs6#p9SiU9rft*f?W-wxgiaZ{IQnj-|RY^{210>Qsj$EpSFP1{O>t zTX?ZNdg?UZ8}9MLqXfnRte-BWP9yx!o<^?;p>!pFe z3f7Vg5r;|rD6x?SLD`NJy-ZK#tN#F*;BXp5mLY)r%^gT-8k8@PzoL@yqUo_#MY}NE zR3Cea0n&{s7{xXg37LUTIJPgEY4%f;mj%UZ<1u0wh92-sS1c(%$ptLF>1Dp>ZJ%UZ zl5{2Z>RR?01BEM2lww3sXPfKsi7F~Sda$M$PqPxh>msG7kUf0C6d86du06V_9v!S{ zY*J3lW-8_73{J?X71^ILQJ0SY0LuL7eqdr#$19oQkpy)x`^?D16cRUPzhkYq>usef zl!+9v=e2;T@q6iGln?cuIyG!HFgl6=V8rG{oufuG6@`RyOiz~}0p|k8cWc`GL4LmO zsN1Sg@~JcAsyc|vVkR73ml1C=qNZ9(mNiNeNVYGZZJLeI*bo2&+qV!R_<&$>tFWR| z;>N%K*A#O8Cl((*2TyhLDUtBXS!t3&(@eC?j9t-C-^k8m?=t`tGQiZCwX z1Y$N+tkp?AWT7}_Jrzb9F@Y*aUbLH8}oTSPWQ2eH;=cV@Mc6$x3QY=8JGHPRNm0QWpLc2tEX zJVuTz*P$(|qYqBHwJb6?WrrqWS%VFlY#O2F!Eo$uj-A#Cu@s#rRAgrnnW^_HGc!KR zj>PByUD7ltC&IJGs-#A&*_4L}Q1~9Y9HXkkD(I*%tQrv&HXRyMV#5ljNos2=46fd4 z&lAUaU5?ja3ES?FJCgO>tSd^!CY9Q-6oa7PlaJv^xxC++65O*WI8Hsfa$>gP1bR z6c`(0vu1b`4WdXY@Z6(>;m*rbEm4#i8QlA#AnUnYZ!Xuk793QJ!4ci3?>`QjZCOgh zIOKO}9{!ImK6K%ib5!|PF<@AxX3M8K<(v{p{{XKTeI_aVqH6k2lrz&JJPUI(Gx>Xo z*Z?;?vk$Tt3X#+{de!c2oprC-kYi~(W2X)@Bv4byQ-|e*Ttf(oqB&%(!&fa~R5bXG z5fx0+Ru7qx-J__ei*Z(!w|j?bj^~wm&{Ke%E7nXn$<(D|Glv1vKU!^|ucXY_h|TzR z9=VGv;tL%l$%xY@l^lzBsvdZS*@GDNp$fj&sieCZoeM;$dj zFI$3FJb|jGtg6B(Y2u-$qpFB1RLL5;0=7~>D%S_!@#1TR!2|*4)kNr3x>Qifm24pJ zHB;H!9L!Ytma=TgS1uui)z;Q#DoisSM{WD*9b?`Zfx3oWy4vFW7%1k7%c z;wdER$K^$bJLVa3uUNA*c%4mc7Cl+~uNAAro^eXE&^{dmkTmG3_FbEHmAJ9jQ^7@& zVSrR|A~2v!>LtShB80}qFM}LQ48%npSIpD26j)4=EKV4SOv=)$6bQGn3leoFxaCs7 z3d5qF4|sH*nh~k%<;G}fWfT!&CXJR{LTc8TO;qhKnG~_4Y%hB*Q(5lpQ_m=!Xk9;wQ;6W2pq zQ;OA6h!T?*tc|5Ku|*My;b;_i+;cH1ijYV2no5Dl<4nT>#sA+>yfzc9L9HF+RaX&ZwdW-<<>9 z9?rcv!n(`Uir%W^I*i4aaSWS{L06XYyiC}%p(>G~NTQs^s}mAnEF{rQ#qGo!-Ip%$ zhQbs;LcU)bIoylYv2aR6tztd(Gojcln2Z@$3#P!vUY8M!!G_dBMr9Q9%w?+(&s88) z-fgj3LRh!jAa)HKKKSa@F|QC&SVooBwj@*Qui*UT&Mu*c(LZxhV>(8;nDig zTHfs!7dl)Jm5fN|Wj^7U-8NsxYjK(!W@?-|zMZ53N`qGRYm4l{PRK3E(;@wj2&jOBZ}XqZx{dmkp?-dc3VPFnq|vk}^JM znAEjW1AfJs7~0pd;<0d~v!Fo{wt~)v)pAso5JAIa4zof9RZRHh7F?lA4EEj{WgAN|9_T78EI4K^5@$#7;tvpZR?c4Rq&P4m zNe5x$O0VRY1|xvi2x6wsN>bu`qdiC8VxDMVXuc1)PG7?Qeu>1vXU%5N<6unu@!6S`4k6aJR(chIz2DHW!KF zFbSHfs#u%K@@C!cM7CjKyNEl1+ra&+9qY-FjPT$ojPmJeVJIFsICWv^TJU5Fb(b<_ z2(bEJ=MugKAjYJfC1`1D7NVuzAfZO|*Ua6z;q(_8a(}Q{?lh?4D<5~6C>Li)!jA4) zp_Z+vAW02kV(TqJ*3w5AsH%`6N992b%)3qd?g4HH7w^QXUZ%{6Bi%%160wfnVwHF- zb=8#hc*HQA5_(mphL)nHcnTzKGdisB>?TGw0>E6}_V310*iVOn>8F!3BM!O|7Og8y zYUWm!Jh@C1Qmtg{uOzP_4kKnS?lh0J)B$~NZDYdstxIZz;-w5~?A(X8>=dbw8;8#| zm6dg~<1bFNby3s2(JT3IJTWw^Rw%b7;-QHw!G@5-VcXE zh|ptshGwUruBOD2d_N0~X7U-u(92HFs#JmgOIInNAd42>yHP>LI1aJZRX~ymraU_t zq`)dFu*oXo#N5DNn3dGAL}^OM*Fh4Nuq~j|ii#5If!GG$DsS@zI82l6 zq|S81@jMR^g)?>^PlRVY4p=0uqWQW?qlQlvKc2>_LFO!>Qba3b?_b`z98+o=Cj;O; zJZZ<4QVED7qJsQ48^z?t=kqZoqpZc^jyJ}sY20}glBsog$q&4U$GX8qu5a6py=)2r z7=V4<6-Hekja-@ubIooYN|?S!SZg;_6pT@mOnU>Zzm6v{iCa;#93uPok)pGAP>7`7%G~%N5*rFu3CD_mU7% z!;MnSpqB#9JsnkZUYv7%9KA7yFXiEI>I#fnx+67I6u}~fd1P4@7(p^DNEMY+O~Y^= z9F6|~C89>2iuEBY)Si>m`>C>a&r%3YJ|{;u zVpXf2EW<+4MOO7t?4^@%kTI25BgY~y*;Ye;v^nWxNl_JhhaD=?VnCS_wx6SgY4N(8 z%SD3LXB^dr#T7O&NlQ$#)>T5%tn*JIQADvHDnd+-wz6w>0^?T=tw0HcZSp_5i4|

~DU&+q6r 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

+cN8I83`olICW^C^LPSA%8qx6%~ltMDp1yO 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

E+m)_}JJdwsog%%AOO9eCYc*w7Is-5Z$7nDKdHi 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 +#include +#include +#include +#include "game.hpp" +#include "texture.hpp" +#include "object.hpp" +#include "other/stb_image.h" + +Game::Game(GLFWwindow *window) { + this->window = window; + this->program = glCreateProgram(); +} + +void Game::setup() { +} + +void Game::run(int initial_width, int initial_height) { + glfwSetKeyCallback(this->window, Game::input_callback); + glfwSetFramebufferSizeCallback(this->window, Game::resize_callback); + + Game::resize_callback(this->window, initial_width, initial_height); + + this->vshader = Game::load_shader("assets/shaders/shader.vert", GL_VERTEX_SHADER); + if (!this->vshader) + return; + + this->fshader = Game::load_shader("assets/shaders/shader.frag", GL_FRAGMENT_SHADER); + if (!this->fshader) + return; + + if (Game::link_program()) + return; + + stbi_set_flip_vertically_on_load(true); + + int width; + int height; + int channels; + unsigned char *image_bytes = stbi_load("assets/wall.jpg", &width, &height, &channels, 0); + if (image_bytes == NULL) { + std::cout << "Error: failed loading image data" << std::endl; + return; + } + + Texture new_texture; + new_texture.bind_texture(); + new_texture.load_data(image_bytes, width, height); + + stbi_image_free(image_bytes); + + Object new_object(this, new_texture); + + new_object.vertices = { + 0.5f, 0.5f, 0.0f, 1.0f, 0.0f, 0.0f, 1.0f, 1.0f, + 0.5f, -0.5f, 0.0f, 0.0f, 1.0f, 0.0f, 1.0f, 0.0f, + -0.5f, -0.5f, 0.0f, 0.0f, 0.0f, 1.0f, 0.0f, 0.0f, + -0.5f, 0.5f, 0.0f, 1.0f, 1.0f, 0.0f, 0.0f, 1.0f + }; + + new_object.indices = { + 0, 1, 3, + 1, 2, 3 + }; + + new_object.bake(); + this->objects.push_back(&new_object); + + Game::logic(); +} + +void Game::input_callback(GLFWwindow *window, int key, int scancode, int action, int mods) { + if (action != GLFW_PRESS) + return; + + switch (key) { + case GLFW_KEY_ESCAPE: + glfwSetWindowShouldClose(window, true); + break; + default: + break; + } +} + +void Game::resize_callback(GLFWwindow *window, int new_width, int new_height) { + glViewport(0, 0, new_width, new_height); +} + +void Game::logic() { + while (!glfwWindowShouldClose(this->window)) { + glClearColor(0, 0, 0, 1); + glClear(GL_COLOR_BUFFER_BIT); + + for (int i = 0; i < this->objects.size(); i++) + (*this->objects[i]).draw(); + + glfwPollEvents(); + glfwSwapBuffers(this->window); + } + + glBindVertexArray(0); +} + +unsigned int Game::load_shader(const char *path, unsigned int type) { + std::string source = Game::read_file(path); + const char *bytes = source.c_str(); + + unsigned int new_shader = glCreateShader(type); + if (!new_shader) + return 0; + + glShaderSource(new_shader, 1, &bytes, NULL); + glCompileShader(new_shader); + + int success; + char info_log[512]; + glGetShaderiv(new_shader, GL_COMPILE_STATUS, &success); + + if (!success) { + glGetShaderInfoLog(new_shader, 512, NULL, info_log); + std::cout << "Error: failed compiling new shader " << info_log << std::endl; + return 0; + } + + return new_shader; +} + +int Game::link_program() { + glAttachShader(this->program, this->vshader); + glAttachShader(this->program, this->fshader); + glLinkProgram(this->program); + + int success; + char info_log[512]; + glGetProgramiv(this->program, GL_LINK_STATUS, &success); + + if (!success) { + glGetProgramInfoLog(this->program, 512, NULL, info_log); + std::cout << "Error: failed linking program " << info_log << std::endl; + return -1; + } + + return 0; +} + +std::string Game::read_file(const char *path) { + std::string content; + std::ifstream fs(path, std::ios::in); + + if(!fs.is_open()) { + std::cerr << "Error: Could not read file " << path << ". File does not exist." << std::endl; + return NULL; + } + + std::string line = ""; + while(!fs.eof()) { + std::getline(fs, line); + content.append(line + "\n"); + } + + fs.close(); + return content; +} + diff --git a/05-opengl/src/game.hpp b/05-opengl/src/game.hpp new file mode 100644 index 0000000..689bb15 --- /dev/null +++ b/05-opengl/src/game.hpp @@ -0,0 +1,33 @@ +#pragma once + +#include +#include +#include +#include "object.hpp" + +class Game { +public: + Game(GLFWwindow *window); + static std::string read_file(const char *path); + unsigned int load_shader(const char *path, unsigned int type); + int link_program(); + void setup(); + void run(int initial_width, int initial_height); + void logic(); + + // callbacks + static void input_callback(GLFWwindow *window, int key, int scancode, int action, int mods); + static void resize_callback(GLFWwindow *window, int new_width, int new_height); + + GLFWwindow *window; + + std::vector objects; + + unsigned int vao; + unsigned int vbo; + unsigned int ebo; + + unsigned int vshader; + unsigned int fshader; + unsigned int program; +}; diff --git a/05-opengl/src/main.cpp b/05-opengl/src/main.cpp new file mode 100644 index 0000000..b2cde83 --- /dev/null +++ b/05-opengl/src/main.cpp @@ -0,0 +1,40 @@ +#include +#include +#include +#include +#include +#include "game.hpp" + +int initial_width = 1000; +int initial_height = 600; +std::string vertex_shader_location = "assets/shaders/shader.vert"; +std::string fragment_shader_location = "assets/shaders/shader.frag"; + +int main() { + glfwInit(); + glfwWindowHint(GLFW_CONTEXT_VERSION_MAJOR, 3); + glfwWindowHint(GLFW_CONTEXT_VERSION_MINOR, 3); + glfwWindowHint(GLFW_OPENGL_PROFILE, GLFW_OPENGL_CORE_PROFILE); + + GLFWwindow *window = glfwCreateWindow(initial_width, initial_height, "OpenGL", NULL, NULL); + if (window == NULL) { + std::cout << "Error: failed creating window" << std::endl; + glfwTerminate(); + return -1; + } + + glfwMakeContextCurrent(window); + + GLenum err = glewInit(); + if (err != GLEW_OK) { + std::cout << "Error: failed initializing glew " << glewGetErrorString(err) << std::endl; + return -1; + } + + Game main_game(window); + + main_game.run(initial_width, initial_height); + + glfwTerminate(); + return 0; +} diff --git a/05-opengl/src/object.cpp b/05-opengl/src/object.cpp new file mode 100644 index 0000000..ccfc21e --- /dev/null +++ b/05-opengl/src/object.cpp @@ -0,0 +1,45 @@ +#include +#include "game.hpp" +#include "object.hpp" + +Object::Object(Game *game, Texture texture) { + this->texture = texture; + this->game = game; + + glGenVertexArrays(1, &this->vao); + glGenBuffers(1, &this->vbo); + glGenBuffers(1, &this->ebo); +} + +void Object::bake() { + glBindVertexArray(this->vao); + + glBindBuffer(GL_ARRAY_BUFFER, this->vbo); + glBufferData(GL_ARRAY_BUFFER, this->vertices.size() * sizeof(float), &this->vertices[0], GL_STATIC_DRAW); + + glBindBuffer(GL_ELEMENT_ARRAY_BUFFER, this->ebo); + glBufferData(GL_ELEMENT_ARRAY_BUFFER, this->indices.size() * sizeof(int), &this->indices[0], GL_STATIC_DRAW); + + glVertexAttribPointer(0, 3, GL_FLOAT, GL_FALSE, 8*sizeof(float), (void *) 0); + glEnableVertexAttribArray(0); + + glVertexAttribPointer(1, 2, GL_FLOAT, GL_FALSE, 8*sizeof(float), (void *) (6 * sizeof(float))); + glEnableVertexAttribArray(1); + + glBindVertexArray(0); +} + +void Object::draw() { + glUseProgram(this->game->program); + + glUniform1i(glGetUniformLocation(this->game->program, "texture1"), 0); + + glActiveTexture(GL_TEXTURE0); + glBindTexture(GL_TEXTURE_2D, this->texture.texture_id); + + glBindVertexArray(this->vao); + glBindBuffer(GL_ARRAY_BUFFER, this->vbo); + glBindBuffer(GL_ELEMENT_ARRAY_BUFFER, this->ebo); + + glDrawElements(GL_TRIANGLES, this->indices.size(), GL_UNSIGNED_INT, 0); +} diff --git a/05-opengl/src/object.hpp b/05-opengl/src/object.hpp new file mode 100644 index 0000000..96e7ab1 --- /dev/null +++ b/05-opengl/src/object.hpp @@ -0,0 +1,28 @@ +#pragma once + +#include +#include "texture.hpp" + +class Game; +class Texture; + +class Object { +public: + Object(Game *game, Texture texture); + + void bake(); + void draw(); + + Texture texture; + int x; + int y; + + std::vector vertices; + std::vector indices; + + unsigned int vao; + unsigned int vbo; + unsigned int ebo; + + Game *game; +}; diff --git a/05-opengl/src/other/stb_image.cpp b/05-opengl/src/other/stb_image.cpp new file mode 100644 index 0000000..8ddfd1f --- /dev/null +++ b/05-opengl/src/other/stb_image.cpp @@ -0,0 +1,2 @@ +#define STB_IMAGE_IMPLEMENTATION +#include "stb_image.h" diff --git a/05-opengl/src/other/stb_image.h b/05-opengl/src/other/stb_image.h new file mode 100644 index 0000000..5e807a0 --- /dev/null +++ b/05-opengl/src/other/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/05-opengl/src/texture.cpp b/05-opengl/src/texture.cpp new file mode 100644 index 0000000..cf1f17b --- /dev/null +++ b/05-opengl/src/texture.cpp @@ -0,0 +1,21 @@ +#include +#include "texture.hpp" + +Texture::Texture() { + glGenTextures(1, &this->texture_id); +} + +void Texture::bind_texture() { + glBindTexture(GL_TEXTURE_2D, this->texture_id); + + glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_WRAP_S, GL_CLAMP_TO_BORDER); + glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_WRAP_T, GL_CLAMP_TO_BORDER); + + glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_LINEAR); + glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_LINEAR); +} + +void Texture::load_data(unsigned char *bytes, int width, int height) { + glTexImage2D(GL_TEXTURE_2D, 0, GL_RGB, width, height, 0, GL_RGB, GL_UNSIGNED_BYTE, bytes); + glGenerateMipmap(GL_TEXTURE_2D); +} diff --git a/05-opengl/src/texture.hpp b/05-opengl/src/texture.hpp new file mode 100644 index 0000000..70bee18 --- /dev/null +++ b/05-opengl/src/texture.hpp @@ -0,0 +1,10 @@ +#pragma once + +class Texture { +public: + unsigned int texture_id; + + Texture(); + void bind_texture(); + void load_data(unsigned char *bytes, int width, int height); +}; diff --git a/README.md b/README.md index f513e86..444432d 100644 --- a/README.md +++ b/README.md @@ -2,9 +2,9 @@

-# SDL Playground +# Graphics -My little playground for SDL. +My little playground for everything graphics ## License