From 01bf3b4c08e130a967fbe1f7cba1b36d5bf26798 Mon Sep 17 00:00:00 2001 From: Kelsi Date: Tue, 3 Feb 2026 13:33:31 -0800 Subject: [PATCH] Add loading screen with random WOWEE splash images - Add loading screen system with stb_image for JPEG loading - Two loading screen images (orc and dwarf) randomly selected - Display loading screen while terrain data loads - Cache WMO inverse matrices to reduce per-frame computation - Stub WMO liquid rendering (needs coordinate system fix) - Update spawn point to Stormwind Trade District --- CMakeLists.txt | 7 +- assets/loading1.jpg | Bin 0 -> 90473 bytes assets/loading2.jpg | Bin 0 -> 94592 bytes extern/stb_image.h | 7988 +++++++++++++++++++++++ include/pipeline/wmo_loader.hpp | 17 + include/rendering/camera_controller.hpp | 7 +- include/rendering/loading_screen.hpp | 50 + include/rendering/water_renderer.hpp | 18 + include/rendering/wmo_renderer.hpp | 1 + src/core/application.cpp | 183 +- src/rendering/loading_screen.cpp | 225 + src/rendering/terrain_manager.cpp | 28 +- src/rendering/water_renderer.cpp | 11 + src/rendering/wmo_renderer.cpp | 25 +- 14 files changed, 8395 insertions(+), 165 deletions(-) create mode 100644 assets/loading1.jpg create mode 100644 assets/loading2.jpg create mode 100644 extern/stb_image.h create mode 100644 include/rendering/loading_screen.hpp create mode 100644 src/rendering/loading_screen.cpp diff --git a/CMakeLists.txt b/CMakeLists.txt index 841b77cb..6f3320e3 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -133,6 +133,7 @@ set(WOWEE_SOURCES src/rendering/m2_renderer.cpp src/rendering/minimap.cpp src/rendering/swim_effects.cpp + src/rendering/loading_screen.cpp # UI src/ui/ui_manager.cpp @@ -205,6 +206,7 @@ set(WOWEE_HEADERS include/rendering/swim_effects.hpp include/rendering/character_renderer.hpp include/rendering/wmo_renderer.hpp + include/rendering/loading_screen.hpp include/ui/ui_manager.hpp include/ui/auth_screen.hpp @@ -221,6 +223,7 @@ add_executable(wowee ${WOWEE_SOURCES} ${WOWEE_HEADERS}) target_include_directories(wowee PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/include ${CMAKE_CURRENT_SOURCE_DIR}/src + ${CMAKE_CURRENT_SOURCE_DIR}/extern ) # Link libraries @@ -259,8 +262,8 @@ else() target_compile_options(wowee PRIVATE -Wall -Wextra -Wpedantic) endif() -# Copy shaders to build directory -file(COPY ${CMAKE_CURRENT_SOURCE_DIR}/assets/shaders +# Copy assets to build directory +file(COPY ${CMAKE_CURRENT_SOURCE_DIR}/assets DESTINATION ${CMAKE_RUNTIME_OUTPUT_DIRECTORY}) # Install targets diff --git a/assets/loading1.jpg b/assets/loading1.jpg new file mode 100644 index 0000000000000000000000000000000000000000..b5d7b73ff7c7c2f93728381c315dee97021ee463 GIT binary patch literal 90473 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 NA|koP0D9qw|JmgbzRUms literal 0 HcmV?d00001 diff --git a/assets/loading2.jpg b/assets/loading2.jpg new file mode 100644 index 0000000000000000000000000000000000000000..ed147fcd2c75b5df0c16ea50b1528bff4d2f8554 GIT binary patch literal 94592 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�%;YYnUsGp~ow(m=;1Lr{oWQI|$YPOU0oa4AR$eZySdku_E`XUPu7U2L#1r!U; zVt49!Kkn6;oY)6Qyf+<>ei}}CUXh2W4P1DOjmzHZc9TNzP>S-<%71%$V!AN;r3@lK zW0N%=y3Jf>7B*xlwle^x>fhLyu>TzHBm6swuOyBpl}F$-r>vsUR$5EIOZ;5@0F{2s z^)Tz(^KIT)rxA&`jWy$pNAX+Uo9?O0bZI|7Wy3ZlmbBgPUz>F}-clxYy&nKVSDx9h zpnJ_od>Rz5pKl4$KJST!!q3k4kbH3~*)zoPbM?_$ZS2U5p~BX;v%}F=$qN{G_9oA` zt2z95M_wn}%WJM9_HUW5{U!B5!}+4dP*FYM_wE)O8T~Rgw4V4|HRD&&a;P^g!e5Q+ zxCP=TGUT!;i(KF7kgdfo#Y^%{ zf6Jwz?mh-A9Y^jkf}fIgGJb`=lsxi;;6ZQXA}{hT)sWRULmb zkCCUk7aXW~&{F}vNgABY4gaU|ybpj4R9?kjrzwXcVZwq>*W1>80&Kfak3rVLAWiwd)|PNOGn zzRfILo(R$Mk!WTZeRejSu*3C1)v@gxcEpU0c_BM3RUGFncCHKZPsw(7#;>|npl7M3 z%vZ=V5rF zJjOiAo~hBA0;>F(0EZxxdRwALMTx7z8C}XB^&6{ZnKM#h1uoD_D#W*kr3FyFbd= zjjxGY9{{qwU4L2NQ-bXrs(*?R+4t(j>qP)tzTvxbshru zJci5RrWxSh^Gh}z{N}M98F^j_!QtNXbCKr@;11%-wLwN%>f0N`dz=8m{>2a|+K+SR ztTMK)C4R8Dx1NaKPgr_LF-^pUiVpa z*`G@LaxbwjsBPqXAy~zdZFG6{ zTRG^eajoQL8q-g&ZuP)%?$mW6MF05;^#hEuc339;Vs0bmUN09;gyyqV!id;t1o6)8WT*^84NJ5Nfbmv%ATo&<8&GjrfW z0DgO%yJs#t5V?pPt0!EoJbd=k3NY%L*|&R(sk8MCur=MQFxv;V=7Jw5aCV95LHtg= zwrU6R;5vc_EID#~bFG=!AH^7}TH4JL;#tP@q1F&sivmY)85ZqkmgWDL&j zqZe+QSp;w^p;6gFho#-2by;tDOa2=gg{(FXz&g0bF{;Y_!T(K=1KmU-11Y`>)J!!bf(=|uM7)D3Hf$Pq8TS~(= z&%4pcqaWtVNa${orUGp7aeQ2CCSl6?=reavtGoGTZTf{e)(n$-h|w({2~Z|v^JOe< zr%%7Y&W$SrHp|!G@cFu@L9i}xcZ)})?vby!Q9)zxRUd-~-Hg*QY#scLFdbpC+D|5D z1rlP}2E(-+dR=gp)y3JEwlNKSj!@1>vBP;o3jKmRP&ve{1_yI>KUj! zwbhg9d6K%SAE&ja?!_n+E>?MBHNyaT_h6W@Z4L;1!CpML4TsNugII(MLW*2a>4H^s zeMb|LzGHGEt-~;03tX}x5y4QscLl#6z(0lpjn;)yVW)N`IB_g=EjObkR+XM0gtY>vT9N-S$`y zX!9os-~1BWBdt2vo?A7ahF?oq&BUY6+{et>PKMQl8RF7TLThhGkOGEFGrSBT>}g}* z$7-d>bpqNGcftg2=?CDjQfqIRlPCPU{%aZ-3ik(~p7cUknMH>k$l<_qr@5LDcobl; zPiq&=Yt@pE+d`;aHaGnHSs4SVwgc+CDBh8H;IynPY<6+)kE>FDufWIzx^IbFHdJie zv@JN7;|ybRv1U zcmnU@aGJwpX>Q(}q`(Z7U=RVIjlV`2?Z$vaYBS616TLC(dYGS`!eN#i-booGeYg>(#MRSBC7QE$xV29beB zQD<}OkV`hMHeF``NlI{3vdg0|BNwsqV{Dp2c3N1AyOWvd zjCC!NZ|@O5V@P5I8aluBxRJ;c9xm8%#Ryz%`^G!PCrM3^$GxJa9IwnLm_@l+>ayoA zH11_GxTLP4)m3A66pfIJ4{zzE)5?iykAMexw57>{N<4lHF?NUKHg|Q@WSk;|_Zkr< z0Cu4-yakW9>m4gI;`bjTSOSpN4`()4*M9Nm#~h*wnp97q7Juql<2cP0yrRjIGi+tO z76cXO<|bjKmAweHRZQHth!o?B;7Cwsx=;YLum?4?*vK z)*>*I6FTm%^pN)p=>QuMcL8Q~admimMe2*Hr#I&8V%lS9Dr^V~T5Vu3^){N1edYkf!qv{&F9AiUrzo7do%And#duQnIZtV=E z`xpyYnpVgO9`8D*(2B}d(e50~!rzAN=M8S@N3cW;Yz1l6J-6XlhZ4H?-8d7A60hHS zmNVYuP7~6$GsCfguPEBjE-cply5GQ|PCetl@*9tYf4|&)+g=mY37S$eCZP4~jVdj^j~*whO=7WEbpi)_w|0Zi zKJL?qZ?XJp26+pO$!z^3e1ol2f5&E=q8`)8%0hMASU+CE)sUnnWZ^fip z3b~}ql8}Xp`cP_f7Kc(dw!5ThDr_I?Dv|ucifoe}Ao#|Me|{2V(5yDvK~f6_N=zK+ zTh3}V6H&s?K3FdX2F`|Z5m(D`<1ka^U?EG}BS?Kow>C&pt*Tg{H*Lro#dKZRQq-jj z!PvqcE|`!sPw))fyZ(fNgpR-PeGrmsLq1L(J+-k&@^W_kCDd9RBT`&5g^Dsah~VTN zoX<~_;2Mg}fOnNXdmC?e$DCoGKZL83aUy8lc*32lg7C`BX=C}27KzJJ7%Vf!n#uKDr|B(2QQ5%ou zUtz_S5$$dbiBf8u%-oy&!z-)7@Qf(Ch`-rC^D*N_L>UrgMKpLB!!Ic_-F41+FgDHj zhfrY)wzN{ThSYxo-Ec<4IhX*OOX50%V~as6^G*4O^Mr@wC4lXCpZoQl&-3kYq4j(8 z%~3=b-Q7K|Kh20xl({bF0+iMUwgGPyirP^})ANhZqu3YU4qeU(93}_m_U-^N+^|AAr;hasPFlza66We;vATEz~1~ zX<<7pnjg9=s&!517DY@9T95KZdlc6u%)e$+I(sk!xCfoS&k6Tl*8~z0@}H45PBXI! zP$mQ&@A}}BwPzaeI!tf&qspIP6SK<+BJl#yupE8~I9wsQoG-V{e=+lFnL-*CjMebh@V%B#7qofukKU>`l|Q@2q)@tlHOSds#U>yrCLjY&7)bEO*xz_c2n&i#_c< zWxw%__9bmR7Q>y=RoexIdCgWf%bt&aI3ryYB=P=bj}7cGEj?&HCPg%1l?SxVuafDy=sY zB44#nJ^&~;@V0-hr|i;Zj{H_M%e))LvGF>@@l#FU%wcRRXlK*3&E#5NS^juEQ>%CI zd0hVsd90|DhWVma{?-zt{TETzy|Mzwk}=9i|0V+OVi_mB*FhrXM_JDamDDZa7<08R z25O&EuW)ef&F+++CE0C^8O9zH3`yd>o_q!$%ggKOhIYb18Vi4}1u@cJ0#9|Zluua- zhmb6S)|hR~Ci^{anuJ0((hDt#yRH*voU6sNd)wu74SIp4fqo#Y%Ve6=nS+555y8IC zr&n41x#G7zV=~9;-5-F`t%z^D9!3Hemc-8rx+~5(%C{MeFJ+G2f;~shPuefQ*VvIm z<`BeKigsc9m}5YkpL?DCI!U~>uhZO+9dX$10K(px6o!?goGlgM_O~J{=ey2i*aR{- zsui66Pus#gKZR*AiAH=`;>D_DPV_)RSkp@`F@4ySVw8>GEhA+w^Qh&-bJZviJ>7wc z(`e(NXQOz{VwNd8^6*JR?FFwFX}@X;#BT0r*5;A>@_fv*WVypAJd>vz>P?_9tI>PU ziSqK`H+RuOb>U_+Wm~{CdjWm1{mW`I&2WSR2JiFte-uE#}ZpUr}jy19qWTZ%2k=bSKK% zzLv8kjKxEI5<*z3RBD0y!055R7q`&p*kRxA@ zw}Komy}cnlo2_~C7_(Pdf<8hYduDBtRk&2ncuD}+6=~_DSTe>MxpL2+@-qPYsQ^(7 zwQvNfqTK%v`QMuSiryGBt1e`s^SQ1xy8|EE*D$eX%n!gF2Tae+1(ezM%DC=9cMptT ze@x5V9UjBOW{fHC!Cnas(n4_NHW&Y&4}e|%1@7@x8Ze4PzIWwy<`!qDJTTi1MPR%@ z`L^U$aXcC92#ELq{2c}U9sdCQDUt`_`?-$65$SI*iKO=d@0UqL9%2n=ZbNtL z3QStVsDn7v7GXDy=Gn@06x&;5*7uI^u3WTEM;zhk9AW${u4V7vNU{AE2+iGn+-^_3lY41r1{(L3 zSxG3FMXM4NAu8>Gx$VJ=*nCxHNKm{quA^SCFyms-_us*%v&w@KN);YuN zsCMVUMCXGNjEAcg`>Pd#%eVt#Nq!*SvlF5)%ij1F-nJcDRX&uZEKMHEm41b)6@&U- zB+WN{=XQ`dx<8py>k1;_bfES`?msWm+g(Aec4sMdc9>mSqPgrg*L0gl>0_!w z2Gh{GJJYXg8F0pyxfln#O-8d7_D3C=FcB|QZ9n$2WOjKc?ZXNKx$0YCN`pMmn^`Vgw^?BWU><8c-BOExk2z)UD ze{7P~80Z2LNx$k2A0I;h33gGoWJ?lBQ z1yQT(J11&JE8Z_I^ouIKo z?hz`yu@)Ug_~YeM+)hY{BX+SJ@vcxs1x&JelqXp0Ab+CTZT6NTdAfegqx!>{EYE02 z<=QSwZkPXl%SRwF5qD+EAIz!OE`m63+23%WaoH-rJ9~p-w{W=ry#Q}a`kdYPeWm4j z2PQKn=j4G6oa$Fq5}@WlI=b5PUa0?GdX~3pJcb$qTkfxbxwNSC7>n$okkl%PluL9Z zHEI%xC%`D?+o;3Szj`OY_2Upv`vX8}T5@rRxC1;e5E5QG+iPG!k6@r@6ik=x%%V<~ ztJy*hP}C^6g~j>+REj--^Myrhcth0{xA@71C+Mu*nOsoJHo5q*ik*D7Y<8%#`g(tY zKbY7ff5G*MH~E!q(#oNHKl%X}@(cJJ+bPYT-H~&3XVrcE_XB_?Jf~p={=9%`%x6Uf z?VQv9N+W;v@!~JnBXV7$d;wmGvv<8+9hE3<`lEvb=SFtw6Xrcqgw`Hwc4ahTl%m1S zLvm9FEIS>0b1gJ(puzrLOGyn!xUj^k2eY}ROLrBuU|c?d^dzYw(Nv3e@O@UiHsG3= z-195T14Np?yz*W)Gp^xvGqqjm47Lx^J7oqZ5jRzyo8P@Vv83YWmHI>Z`f8J0*T!A_ z%4ojSh{S<9e^y)upDQ{3T!dde+T#%>@D;~+^%00O)yXe1!uVzbTw)1%($(DlfxKd? z*Z1y+RPg91a($()HvRiDK>F^^ChWqV zqR5*3DU-=v!RF{lJtWbTq; zxZ0MH318$Pe;gLKsy6N&(7C{ue0H}Er#j&Bu16W9jx!{ni{f*)?pm*%|H4jbt^{qj zwWg6O^FYwb3dnGi!&$_rBE!H>zS%rA#$-FF~6r z4^3AbOQ#5S*OdxLBFP(GCy5oRnL90H@H@dUBjZLHBR_?TwE5Qh^k;QFka8x6p#VqO zE!EE9&Fcjwt&woVwPg~|w+V06xPUpLKvI+iVx2Ik^!YFCWc3x+jknccJ?P=wO0m>A z{S=pE<}CjE?OT<0VNmTt<=AJFt*#&GBil{Y1g%i7ZbmfTQ?Tovy3Q=*oGIZ#>w-w6 zZ1sjv1A_Wk8)=~Z@|`8u0_?u+8I)h67d@OibMn_cB$-=V-S5N+*B-iAY*Kbkt(#VK z&q*sdxvW{GljP^W7q&*L^_$)yZSW?1|89b}_um??(QJZByn7Oq0{#~6Peqrpi!HBj z$UlW09~}l;zVlVjmAN?Gs+vv6{5)tz#Tnv|PR*0bKTzV@d$D|;T$y3`F>9&|?=|Ek zK{0{E<|ekEMzF;5(=R?oW6yT;&-3M$|DGAXBOQ`h54Fen9q~_JKB$N4^I75nj-qlG zh5wJGZ;q?%i~6p~HYVG)nYN+pei5k)ca z+wvi*AvwUcio7E$DNmSfk>|dK(rOzMPHoL81R28~>+^Lq%$xrQQR(zv)#xn^hr=C1 zOld5Vu?>Z&zqXn6(oKZq26S3Ud<%`qx-&30C69{$);X+FL))Rl#c<8a4gVkRB4 zl2S9C6&jZlj_pm5D*g%2giKgUIu>k=SNMFj^-|K4y^FrZ<|*K@QC$QfdwXQ1F8t7` zF_RL+)!nzf%@Kz(%6;C2C0~BWGzrV!HVoRWPpO_n#_*&jWHKnegGJWgGqx=v{8%&R z6*e~u{t=r)xx|FoUBC5gvF?!PaThRg;}EcNB3V06gZAFe>TY|xL%iP$ig8HJUCx11 zt9aPHmcK_Yj}w1m`42*(YBqrIi&F7T#U}-*>wP%j1BS44c#%wX*v@hv2}p0uUuQ?g zSqZ$QAL&c3-lk(muYAFxGT8}%3C)i3hGFbz@@eKa%0KQ=ejX~(rmuz)Tj`gD3q#(C|4{;9KI=yfC|FDkoa;7D8 zdA^tm8V9S}S}$_@;sR&dI&sj-ctv1g8|OH+a%0VIv{(eMbp!kxd(qNs=Ifj9xiFaz zyn#%>_Lo*dCfep`^}(>^C9acZp>%yzlMJ!#AgB4+b|a3z*+i#_h&I(lwGSfMMDOhK zlursHJ<3}eTztbMoHWU8)t2Nx5RQxZ32qFR;+s4FgW$S}YHdq2!ZHA6$G<<4T2t<{ z7q%EqiU9jwKx^_A`936MM5x_2@jtw{Y@mAs3##6j zksWr9;~k$69%^X%0WzKRdOVb5g1!pEbD6;OxKLV@>dbj-?OZIiB?ZB9q^gl7xcVuo zz*Ee*cYRE^?&o<;5#_ca6(^vXRVPg*qMZv~i&m=;TGlt$TcS0icvOWfVmk!iDdTmX zjbq8)-5}-Bd%J~&FH2WHz>klSIuKX0(FIAn{88_yikQEOh%CWYb;Wmk&W>f!8h2V} z#Bp(&(UJ@iJP&zaAZlJ161p@`ybNW&k%*VUtFZc>a$-S3ZAE{L5tY`o+7BXEknD<_ zCE(S}i&r*ChEsIG_8-O_ieTTi@Pz!O?A_-q-hM~fdBaVva@^Q?6)$$I<9dOw#}QQ^ zSNA_Jc#6BR&3Ns7N6AOr9`-&WMS}rmSE0WGy^tI|G8K6!IO=h^tf7{C%^@|+jg2}X zL;Q(>H^w8sbV2w-pu<)9gZNP+6j^v0fZ(gNZcbncWVOPm58K#Ed~(P(>hU;K{*i z^9`Agl)rqI3jv4>+vBnYzC1IfCDjXp5^i8xNO+&5@7qd5Df=00W$e4jwO{A7nih+D z@4E3^$7-XQ<^0f2=?~dM5R5hXzr5^|i~%ddXxCR=Hg2bVPFUZ+uq6vbOM zd35FbWyr-mFF#<~Tt|7A{Uc*UkCG^jK>7vw@Lfr&2nALCVEa#9@q&yz!qo1Xrsy!~ z6J(c=;_8^}j`_%#7n(Nz5*8oKE5%)SWY;dA1F2hJe$E=*YI{CLx2&oz2MSg>W^p%{Y&Nyj zWOk9=gCr%u^}v0ax@q&>GG7m^B`~AkQFjkE@XE2%USFx(UHw0Zgk7jc3@ePKF;4F< z&%b-91MqwNT+Ji)Z$f>UL@{&P)wvCC)`#1PeiMnGdPMKyWsZYHj$c*||9Dppf3_qt zgkMSgl@tUv?~IIpC6H^@3w*@O_%`a!Uy`GUo}7prXLyHt%rERYJ%cN9?oL9v8( zOUu$9_|#1ID3CfHxv^!rsdN_vhgofjqsLk}=e|>JZ)SrbKeQ3bM+Zcw6Co}v(Fe!fJ(=+m6q+}3fZ(|@{~YGn`P5KyBM{`Q zIFh%kw`DB`yBCA_<{L`L<#D+^{vQNb5G);bH{O1c@gz%>4ld>HTE5HN{Hf*#mkJk} zpF=etS%V3YCC?8g`q%f%)%Yofgo8`Zt_sZq|PwfjLWGur3Wtz>Kct-mL) z3@Y5R6@aZc{(lg=10u(i>+T<9Yt%H~#S|XYU(e6ZO%f9NIG*E&R)lz@We84A zU}x4sN*sFud}G4Q0i{{6@0|q*5AC|da1%&K_6rIBLHu3x9s9*4!uPMOE33nE zGPCLO>(6bJhp(cPq>z1zpW=TI8~meK2hpHNAPTY23lFLcH_l=bvBDKF%Pg9!>DZA6 zIgFDu`8nx$8X?~e_>;bzZxuD-ULZ9#dwbB_)6>CIS$(zR^oRM)#;FB_(Hu+rHC$^2 zV4q#B=jUlW(IMfw<;{L^67ELf(iYB-o(zI2@rl6t)JUlmbRt*p_=wF%f+eo3MTb^e8p*K|J)8JzbBxl= zUIvv4&x;I2zno9Yy3HwJL6&n2wDr+F)M3eAWw+?%iSzKiyxQLGZ+J@o`Q|#AN>4V0zFD{Tgiu}lTKnssSIWf_f@&)j%Due7o7uURQ_w**rr0mvvX;D?K8ABmE|9d>AoJsLw}Sy=axM` z8G5Xo-Fa6oi=6-nxP-6FFP1speD~%bN(;%Xtr6L+IUpxlWLLUof2zxe8RQpA3b zA3KfcpA6u7(d1Qm>QF}#R7hTBO!9&h*L7BZ0~7UO-}T7VdlC7Z0|yrBF@uiN46h+0 z1STSqYx6tVM`}W7PG|$Ln^79h(fJ;gWVUXiNXxR?hi8^jYMrX2+g+R2&6!O{mwPpE z!~K6A?fuM@`6PNvwj7u#>{LA|~@1`IVDfak#yq@c@b)p;9(s9?% zxvh5TirAPS7q|M#C|JH*$^9Xg^C$AZwLF>?ZFvcqB&vrTL0)JcT1-f!piqE5Y)`6s z8^i2RHF}!}h77lS;U#wZRsxy_ZCW(oMy8Uhv7kr0yHs2Kq9KzcdV* zOU!n45{FnJ{Su&&Qb`++xapTv)(|3-nfVP_90U*z;HoqPKs3#1DhRSxtTtqpZw}YP zOr-lU6#n*0ZRZ$Ysx9zaA+n-HA-T>JIn4!OdBJ&#I41hAs7go)=P#0QMO=kgkXAIn zeKGk54v}4lCgnB-Zm9*NX-sh<0e3kVP#fyrt~u)t9*bNl{vpYvsh?7Z2!U=P1&LB% zha9ep=l}CthrldlFe=hSj2_KkVe>dyG>+T+w=3sg?L4T4EE1A1??aXonU;oA#o6LX z0v3ZwMqR`xOFou-Fb(T{gd(FuGr_ISn`i27#F6}oc(949#4e0|pZSwLiRX z68N4*w}I4*ry(dRajsj4A(g85a<_j z7;EP5dno@%l;Q_#7X$7cD0Ry`)3=k^1t}6gRc^rQp0oQi(C4_#Xe%=cclflZ8RR?u zy(KuYCSvuCCEOjW%BgAZGk3ctYkIS5{%r?3<;ov?9h(gY&Dq`|vHr@^&EVpCq^^(u zBZ`q!vcPu1TG}~Q9Ty-d!}?vUaU}J$rDauP)>~=-K0Sk&^+W*sEr_H?$BZYT*H8Q+ zBoi4lGI^NUFYv_sMN`vuD`0*5v%$`IEfYAd=lI2dHJpW_6lWz~|BNG^Q!~rtPHF5H zM-`jOO6X+vyCOqXGAxw+KL}K{Hip+hz8M{T*0%Rls*8qkVU1g)p=(OCm3hGoo?v#l zY{C>?EDR#B<%H(W-=?={3D_Tf4*S5-JpJ1+Q|ME?li{KzCwyxTtShu86kJ?yH=s#^ z@X*Wk5y-tqW>mTA@CK1Fpq?h;f|^z;$`iK9#^J*EF=xq1$JT&+xetBi6JRl)=hXv$ z^ASUCBElbjOZ=wWvm=(@N0rJT4%`G^*Z;t>M0!Q!O`3Lk!!4FjPs9MobcBazk52$o zbGesG&q6Zs=J}O$c$2+&Z^kJM)^gp=+y1fSB7_NzO`n&TpRXa)_Kh}vqsvWBh1>Zt z$3#LC)d?LMhIax0&IDdx{AeSnm3?yHT)f<8wHm~@Q(&Y?l|M{M@halSnwY?2AC3js zW_Ic`Ntd0^U8%Cf_{OLz>RL@~*oJbJli>Xp{KRZ9gb&ZaCo~56&*JXzXH9!I>t4%y z|1Z2{A)MR!A(!;8K=ecPfrRTN{3)~XoD}ZK#<65%WJ#9KOPdO?9HdCpe^tNI8d41b zSv}s~{G3rJh;d74d;&9C-SHZ{kiB8xJz;+|tDQn6r#2=vO3&O% zMHrS9*#AU`N~Z2XO@BDa4dVObHwAoFMt_IV^^5%5iZ!k%%-;8bgVDk37yT2MYZaQ2 zX$7cJ&JVPR@Z4gn;i zVBd-oz5Qw5c&?=-fNAVGwfThHd2`DG|A};%laK!eH^18KM@0~$ZXdx)eRUaR6@;De zQMQ%?_xKNW*+C9@Dy))?POxt94XSj>d{J=Zyz#VK3+7Ig2_6k>FBJSA#Jj2p#@c@n zn3@NC`YBxBLYg#~l2_d4(>Q3l8)OC(3#7+LP(Z75dK8pq9(TfX!D_Fk zpGmn|xk7G7nYM><|IiaaW0-crZ`6czr%(SVhP2Pb2+-}}w|NrPqe_2t9BG+McGrC* zSot)$!GxJ1+uD)~AHo!thYSdWZ$3&CC&G=Ee!j|u4HZ;m4y3a5xmsN4_V-RI$WLf~2@dSUBJB7pP0|HCSX*_cH=u-9JPco;&}GEyrONVdzw>2U+3(fRv#_|qrO#~7l!v#yrV$LtJ{pNNlFy`P?F)cLaThAxS8oVW zz1y&~PZn-BKZ$T82S3yZgF>O9LWeYdqLqHRw3{)HDGw6_lUqopnUibr}3n_3J zBmE!5av?`pMCcm$EO2qP!g4Z?EyR-S=yxvt4pz_lzJd#&B|q>xmatZ9@iMel#TQDc zut9fDe-z1MWt+`d%n?tpGD#2dUElB&7Xk_bm3qikL4$|v*8EEvhRBe>9Zx7(v0PP_ zs!bMwUrupCvE_3{?^SL>QIY(T*sO;o#QZapaB21T0=QMmsQaoUu&nO;YuTqJ>aUKd zMepmhUp4DnLw9YUFI^7E;3YjT^_2oXsk9j;Z7w}IetJHy!EG;*Nj!-eTg-{eFVU}H z(5Aw9w|Z54RRxZFN@%#I?uKCxK<)`vr>?Iq{r+Mk)WY4_OHkL`*1nImek)b-u$JXf z*!E6!TB1&`K1ww&x)PzIw?+_=VThBYf@Ht&h3^$`sE`u)=04A~p&483M1EKXC&@_y zyD&A)OX-+rpuQ9Fg%x4pc;>=ToQP@y$t(}gF#Qob&a;~lHdG$0XJ6j&^8NlY;gJi9 zF{GWLk{o5># zntf3W$gZeIm^*N@F8LdX^ewm|MGkC50Qyb%p|-)Vex|3Uge!wfj;t)0vX8ji$k-z_ zz*VW6f?n8yV@e8Fh;U%PLfx;a6rO)9xD@P67ys{sKf#@{EZH_;1B>n=sjO6@4v5rT zIb5bg)UD|C&XUZJk zVzt9Me;pXUV0LiuMc_*XHK){tfDLok3I0atYzPeLE}0J1NWfII%z$kgPKp?vcsMs4 zN%WG==A8?+hhp997B6o5fVYgIDz*JV5#vUEGeTIoGRVLE;SfYxL%w||AUBdXx=t^qxcV^Thc_ue90qy;fwr@_6f&#f6FQM$*5L5pX8u{nkK46wPZk^ z2N4b{%SajOjX18`_CuUdsq}#NB_z#B7=m{KlqJ8s9%PQuKjNC{64qW zwv=2;Wix8M|L!wU@kMd-&!baX#6)H^`gG1CU{k!bXOpqZUam4Ayd}Hf)JS!mveS*` zD{WidpS@%6%qRa{BP^_qAb)zQkCgc8BlI}*ZAX}hYl-h0nuc#dpBXbUh(KzHKkq^y zlfiT(rIN@oRY}eY*6e^kfcDDr2MRUHquV~6H( zQ4%=Fc!U2HY~aeY?XS|qaz4ivS8XdJG&C?feOh+UNIu#l@0z?GBiIANTk^^n-(W89 z&crSqgP)a3rswNn!ft9OztE4a(^tB0gX%HrmcNTbPi-XIzWuh7QQ?Y$ytMpHAiOB# z#+uo#nwd(QFsRa~4%|1Kd2T#^zxSylCvXkhwp}?{55#pS%X#(QU{0PQ|J-l?fu6aVF-{9aH3aQJ?non zHQZb3%3}Hbn$xIqZ6Tjip1t`$y4Aro5sQp{ZEZIxH<%=?|9QypiM&wVK`QN6psCz9 z^DQuCn*-}JBU^L*0m##vrV;sfhBP5@PBuSe0m6+XR2pyO=@ohNo=5Eve>2kbO{Y>M zR^^a4mKW8Sw2r<@_;^*ncfHh}U6RnO3Y2kzgaF}W*7v4mt8eCXvI_8t(4|(Mct@WZB$)u)w-h%b~y*LWO3=Nu!0?`PJ?7lP^EP6082w;8su*c{mmZe75~Fp z0M$Gb>7pz-vj~H#lX>Phou696pw9i^K-{Y;?~WAdn#jM-9(51-urIg%BmLbq^)9s+ z<_=MsDR%Qh+ksK~FV#Q1i`7<7`l8>mTaOt7{LTj-!=7=3(myzM%oVjYJd0uErc7RC zjfpNZ-v-|!{630az?iGD!=*1qibWW0zjOx8AI6^#PHc^=AH^^3Z~eVhe(RK^$){+3 z=U1QL?wXU{&8rAvS3Nh4X^+fJ4KXge-hEX+f!##j-D7Y}YsomqeIq#S0gL%}IRE~t zo87yff8_}ZCl#&7UcrguJO&2+2caN(`~8KLG-U?ulkL;(tFLq-w_k9+R;29l9n;j^ z!MOqIzI8yfl(a^)BLWPKmVikkMVz~2Uk4$fe$Z73Ja|(#rB@OzGjGFYHLuzxqHhX* z&xP;dHLsfBV|AnF+^>UN20xhO!+Sf^yhkyrXYKx1jeVmxb-x&;Ab z!~LClM`5>K@bKOqMV5aOHR>1?3ia`z+`Zev_GjUvzD!}=@Pr3xlh2bC>XMk_KL~S_ z_DUwK7y2Gjnm6;6ao)Nr-@;@0U?{g`uKONSaG$?Zfd(AWRt4pA*MAU=;`h$p921U) zCo6kVWRRwI-~e|QhyR1{@LSIpWnf}^R~x+nbBeB0M3j_6l{3+j05OMUFD0%Xl?1?Y z5u>=h2A+>%$5>bJr`#>tK!y6MV7zxOD7*j`aeY!dQ20R$)xUBhUYX^Q<#b~qDjN7T zTS*_Y24$bL3zN7!b`lic`6U~YtfX}QH77YIb?PN6NuPm?qV0hZ^#5X~kyE4u%z!gCdVKUA)k?3f6 zo*ogi6_LWE8~#+h=0csKDJaqFc*!U$I}J}3$bzO$Kk8zg$?sd@JvuJ)W16Lw$Z!4K z43H{JIOWo-Of6Zkx@@Av!jdk8nLK)L{-ANH4p~ue^3LbA>^*qU3MPDuJq}$3o!l@O zH2FJAStItX!*6l3O5$V{IhWYuI{tD^CCwIKMHjrmsz5erAjN`wRC)aOENuTRVSvs% z-b%(D3+Sxv_(rGnx2d?^5VaWOmpOidXoNVp#0pquvDKclLp{fDrB}6#l4Ea)Tu%^d zU(a>mx~XaCrwnKucFv9Dq`FRHVo76Et(7eKE!R?vDvp34pr}^L^M*b1POGNQ04>4w zuL%1Kf+;RS+uyU~N)TIVLS!`EKBezYAyH?OkIFQGb11Z$!Gspix~QP2JR_P4!!h{= zhZcGmN#1qtrU_#C%;mLf+4sa=!BCG7UaNstvT`~?Aifg=Sq@(HI)-Ts=PV$p;O7dh zT?j;s+d=_~vq3{XMj?Jz$||%QPOTgq*-ct!vlnH6(kF4V1r>$(R{54B`JgT4-6{-; zZd8KCSj&=PLm9Q;GVDS!R)uGH98(6;jB^A~_m@^qRAB<~ar4~qe36kHI^vRKR_KI>mwzx=yYe$ zfw`cRc3$o{^(&zHqZh`TnV4(k>+_3JGUuR4cyiJ=s!PFrXIJywx3d=VFo&oRjGN<~ z*qw9k7DyB_ti4BBxINLg5L^|{cWQPVc|DUH4Qaw55xx0VfmjSD%K}u;NK$+%bq$A9_2x* z6B5aoO&3?k{=ksK2S~Z@PgQ(QC0ko>xA5TidN1<{H;_2^9?44Xx^ zq!f9v;*xz@el6^_+i8;$s44wOZ%24D6Tc<1y(M{!9`tX%w$~%Hb;s~}wV+K*E*M?M zn0V5A2n+XmBKN%3jXpVzUF2e)9_)z;3*UUu4OJTD(6)$)K_%I82yesKzk}G@+jB5; zw`O9k`a6rmJ&gysp|3mb)GJ;{k&PO9X^mDB9rLj4V4WQE8@ z3E9&zlBEijd45DE%^^Sm7t*L2Ev@!WQEim7r?3;5tK*WTc# zZ2wgvX*h@&X(|_9+c$oK{b}K)i-Q!~b_}+qxbLK5k7|q2m*uh5-rSz`3b)nerpn)r zK5(u){~l*21V^MYt36_wK^N7qD{Vn>#G5qea6k}`%h)$Jse)nc9&q{-CD7mh53-RK_8n4v=JclCrED(5%j@!*q+Vt zCzMmu=Kvf#88(t@guh=KS$sa~HFy9IK(l z!4(b98^D&aM^JTdE1$J_Wtsb|oCBvnq^}*=JJ8LdWt!8nm zQ6N_w>mgr$5R~@nK}rL6Jwq*#o5w^}1N#ZVpMSBI{w}Nc&b;TtATK1`OS5vsg^S>y zkB?V>3KIn_=J&C)Jf#?QWFw^PF35RL7bmu2AI9!UCjXIBF;w=?eaJdm)gSACkM99tt0s4wT1!LssC(?)`_TSefaXQt4I*kFSX6V$jp7pYRgmo7 zK>G9V$oq0@-4*k~f$|?OuBICigKJq7^3W59=~~Z zD{$<4>ats8V_XH1d;-U;hABc~bKGHn&M9u$833<+GGK27Ag4WM^ms3VmKyl-eI#y> zBm5I(TTJJ@zPS+_jCt1P3fDYke-sK{~7{x zd{Z!0NHF;0#k^hjZBazcdj_@M4(yf*VJKzgVTUUiv=@ex)`^Gj%>oM`ES<5ioEvfJ zQtaNkyMU(-aX90$ch+~dxB!(^Q2x!5DzQYM%qs&CJFlYNGG=;xL&{q4{@40bs(8%8 z;n7ukg!Hy10Lb@$d;8!*pg=&_L9FA$+?egv+ol=|tAW9B?*Bio(EYJ@d6^X7ucviX zh-y+OWi?RzEz$?9vUsT2y|{>r7Tq!AZvMX^IGwl@sWo3nXo;6fFF2TwDYzYT6Pk+Fx0b>~ zwCA+WjoFKh+-TAry*?YFsNO*FqsnEOzNzNieRQ=C zT+$`w9dl!UjkwpAQt%A(q!0fy!%EcqWFFY*u~@V}|5I96od2+`>Z`i^W$^PzS_K@E z=90I`*Zo;bJvz6_3zvwDZYXFFP$~Vfsd5)~XLwWTS7{@{_QjZgU#lbiH{3f|#~d^k z`#(Yc2Lbv#5*~Jc1WJFMzE9?J%7NXQuhVhmG%eM++ie1y+T$AD8$Uci|4OvG_C#vxVpmiwWQsmZIXF^c7+ocB*n+d{VO ztYVE=F!t2KcJRC^VPfiATy!CDNwxyc{>SpIn&0`kDoSVX__eNi^p`? ze#)+j56JDWaiI(Hs&wUaLDC;pTBn3gMTo9xr}sQ+utonFKX=N(ITO*j6_+us&TPlY zBlGHF80vuXhOH%Xav6?`DyAz$m!9wpP>sbYN>e^eT&l~+0@FT`=mt^#=^8=z-dpsl ze_kp}G9>-n2(cOelaYoI%oM{&WGL^R4-pf=KoFBaBvq5H89Zb=Kviyo8%J#`5bOnZ zlVwhUh>^^e5obUbO8gvn5?k_Czcr%Px08go;W65y7RS?lVr&V9wl*SgTp_!O-wu|s zA5+Q2{Kbwbw-PfZZry;mlE4yn`*dh`w}cZhwk$ovp|fiN`eNAvqjAm@(n! zOa-0fPwT&tIN=*%p)RoMs~nhkdNd*16trF^iOhySLFTF`*%&yJEBeKwRKFaLkw!d> zJTY3E2D5vvN4r}|_KF8p);mx=nA);P+u6LRip*UScUPTGu)75_K2i6Xhxrg9o~;`V zD!sG+WrCYbN8U-WQ>)gJaf5qW6V3RB^lhSMi)I;#O^iY;fHrW$oG7^)mc68d#Q3VR zxe*ts{mG)Qvm?nE;elqHGKve*ihK3U;n_}TI-ZAjfoX&JK^@nl@Htk7s>*z@um|>{ zTsjWj6?P{LY0WPCQQjq$7cF9pzuA365y~C_pEWElk-j?>`>?+_RBpIEuz#j>Bjj4{Mb+McI`7uL^%F+lBp$qlZpfQU5>R^Eatt}9X#<{OX z0*@Lcpz_p&WWBZNK$JdZhNjOFrp8eq1|}qRyeR64m012se115k$s)Qs@VAZ_OrRxh z7)GZa9ZRHAFo(2tli1L&i9x!$l^dcc5~h>KPQ|f*8Z5-GDhrxT1GKJjAxq1Oe|xio zEYQIJ+fmD2vZydOgWV1>89fC%gz(-EgQ3Kg@Qu^&6rN6aC>&A{B)FH}#L6LBwWL=7 z<2$tD^o1?RA?AwW*dLeOA@f3C-cqBFnJGJuPDQnCb2YM8tr5F2)Zv|+x%5c`-ejS$ zd`4!@!uh?7)tMn}NA3pt4yA0BM@mV6%)9Ye70u9x; zq7)D>Z@8TVdV4@O(JSx5>XdwwmBgW2=Kuo5sKIo%(q!WI=&}1(>b4AkdB(3j$!+pk zlZ+kQEnb5l=^yF30ANu&_OcBQP&r6BE%vY!;&ElrS-=l4fwEmcb?7EZx%CViNN`v_ zUv11Y^-Sy!ds-7|)M!7Zqwza3eUk`IQ2WIH)!f^peI1$BvZ)J-DTgrE0u05tx?}AB zF$bnh6&2Vzr_QQsTMAfvt=C))C7B=*&Y{Xp4w{jU+8e=-r1rGMN%Iz9pcz?UO0X}rRlc}I&K;*Mco_}y~G{k1RpdCPznp%YVU7H zg8QL|15jTMnkQ-#+|#D(%(L{}OE?bD65I4ypHb1SXtp^_l7lqXW+d}%Xm()Az9i6t zCk626G`1P}7HP|!V~+>h&JYU^mALRjte)UOrajfjH2RqZjZ}V%*W*`N*B*Rn@znFsB4)2T;D8|@sgj?Nb9%=3gW zUY3=Wm9+ORSFg!5r_38(8|{QXtbal+iJ6DB+JAU9qu}ZQu$vsi$KbIYBXGDm)5;E>`+rcw{5DZ|Sx<{(iIue_EH z%M@u!nO{O{C@vCKvbi&OD??OwY9t^(h*AS;+{;lg_fROR-GfypwISl4As7J{r2lm8vG&{T~;Se#|sWfr$ zAaTdwLU{hpmK8`US0eX^fcgPp4bBT;{UMkji2M=cS@Qr~j*GRm;{i#OnZo9oi33!^ z8w>R|W~S&z^5I%R*z~C?uY?_3-?2)D0{$I~C(xrfmtv@5RX1HU+Vfn)YSXxQGOaWR zgIH1V(Ehc7fUl($QI*$90Llq8x5f6;)6WTLo`7zt?#!3|_ZAvy}>YO7AA)f))Ud2a8`Y z{cKUylvc? zuFw8&MZ68~whMwk8(&4nmm)J}*^`Pae#I$lOTrtO2TG(jQ8I3BLYS+1zof3+nFf8h z$fZJA^8v2Emc-0Qt~vW{xE=<1ks~t*+-2?t((LG_Es|E4o21(fF^aE(D6Yq{3na1Y zS+|3UH;B_V;{6>G;ey-Yiz8#w#Ep{@_){V%aF{O4z&3ozAaq=oh6xH*dbU*dZ8(>* zBOEgf6hjmxX!z~XyANz$wo3GwF(|Cv%z}<@p(k>~;*^-OcjY8U1tKY0P7X}59xau) z*Q}9d3D;2iX{*cjpgBuuSKOBx`$JUJ*RCV}^?*C5qu;UlTf0!+12)$QL41cW6+NU10STw^twy z0OeK)?{=%}k!CnyF*R7^0Pjc4uyu__z?hQWqC^cbR*`$lZDimeU@{!>IB-7n(xvHM z{^&RUYCrv;%PSSdQ5diME2E6Y=!?`W-h+YP(ZfWBWEr0x)#{5+|?|23O zZ^a8#79v6|x6~Y|!?{X4w=xfAd+Db8wKtsnO+_qp^Aa*`e{SX!_y~-NsJZodvYW+1 z0@QOYFNV1#XyOgWGZh7!2?=U5fNr7}R;xt#*%Akx%}OC`@erM0h+3Iqw8oZMtoDF} zv5Zvk&U~Oir#mUlhen2+SCliw7MLx)leeu=-veU;Gv%h|?Af*&@7KgV2bFGdd2bmj zIQ$j^IK*Q}&>ndy(9uh7vq#b%`D6yRShZb91>Z!^z|=an75#}avP7$2fVx8*ak2&w zrm`WY-pNSrD6{RB&DS+|%T;PV)&4@5Sk?O%ZX}W;YYv=E{oQ6=!8?zzK?}dyfE%_j zv-SWd+@Jq6hEhWb8iUSEluFgPMm}W;+YxoU%=aK{9(acBzOij#rcFyY$#R-C`?nau zKtEZK+&s(9#x?W|p%h&QB6-(7cEVd(r7Ad>$v?N&;)!_1HU8JE^ft3N^~EsRx5&4I z2Sr>>h7!Lv-*Q6>H)N=4; zhMsuT3-YpW#Y~5`h)oij+)X6p{~e*DO6pwOt_F6r1=y$Y;@x-5y^Lbt{JA4+BKtYV zn)0^AKWL@XH(s+@bs5-Wvr#oCpk*GZaB^x@I zUI@7EQ6(n9tx)=i(jGUiJ!HrP|4RhYvRfj^?%8=luHTTLWfvoJd?K|mLdGavX)=*d zxOS5lVI;HYwyk5lGp_SnP5arGe=VBL3!@OOBUWfgicOvEP|Y`@q=HPH)fp9D9$cu~ zohU^FIz4L88ZJ0utqmgL7Bu#I_n2C!_Rir1fSn^4{fc91gc3x+XUR}{Gw%Gno!(+p*|DDXb3iY^Us#X zx~=`Ow1xke@OMrq=}nIQ2D!-nR%vCKC`(5CDecn71DFuL6(HpT=*B_TFLhGz%|e%# z!VGxA?;MXB8OY7F$>Vz!r^?on*T?u@yW89%ESyYRQV{?(^&BO`0&BTKIB!rf>WYcVUt)c=4Z?S~^G+ z-m9N)8d~J?@0jsm#UKhg=fgV@(1vhrw`LjrKCzmbX;2getbb;@N?)RNmN+m>7zK*b zR{ZwvnVj5UHC{=5n5#qb>emTFbCO7oLvMR-x?%oq(QdEbCnU%ifU?NAff6NKhxoX` zYU@00Da2*bvLnwvbTJf0eQTETt_62o4(vQO)V^+vtUw! z9CB+$4tUDggW{a9Ke)Wo`hlR5v6s5E|32i_Dw+4x$=0ELX<&benw;oU5kVP}_ejY- z-C=k!EW6HaKKNl-UB|08{Br><<$~(Y6P-Z1V%clRZ6alO|4;rd^>Kzm#NOApk|LNo zi50ACp_d}J);qad!scT~p_KGmMM4g>9zC{b;|e;1N+KQNdYY;fe)F;xHCyDpV0I)d z|7Em-AT6noXr)O_;K+yh*UO@W^CpWG$|D}dhkqLZ)2C()fro=xhXGeJ)>_nNB|fV= zud?8K6^p}B42(4h#QV!T{2d;e!4GA>fG5hvGtr&axq1n->nC}5_!RS+!uO^O1k>^s zQW=B0rQ|m)Q7=bTw=)FW(SGO~5OzaFrGMr%?5ittuefT1WSAXMZ3Cdu;mK~`8M#IU zVWSg`<467Sz}8f7g#l;~|M;simd;oFUjHt0l6&aUJxL~mDu7034~z+2>J4bBKI=cl(VV# zs#=Dvw+o+O)K|y3>CER7^~o&?6Z|)&nrDy`s#m4j1UBKAyiSApn)|0gE+C?XRj!RE z5D`>n>93IQ1AZZE0C5`8p$wL#mxsQ&@++vQSYw2xlpK>s76IaKDUqV+!c4yKYJ<3; z>=#rS*5{EzcGIY8H9z6+A4uK1(WNT3zDM#1c+w;cu}8Cb)(fB*zod{#lhPEY_b5Ufkx1o{PYeo;o1hNKaBkNy~T;Wn)Yjm>KC*1h<93`_f zD7mlwqdQ`$;L|Kn#N=vDegEA5ZMJV%l5g80@Bkk%PjV{jc>F7oZil~#9`)SJn|cE~ zc?#pmc7xSasfFQCa+AqwGdfODb41vjUJoOOCmnRNY!>q}pFFiPB7PM&EPd!xE47ky zUBe=%4|uAQCLS(IIli|!{EN8GEn5)=dde!{LLThWM`$Uvlue*_yK(w6FCJ;j865=f$}j-&7{F* zokPG0mq@QV)DB+8h>zvRPe!IrihEXf1|>O( z^x|KJp^)JUvgZL_?W(TGC<1o@qIUGzZj^*5QU30VvpuV=JrfOCW}7s@*@&!;St?Vj zQFU8(zdtZ*LgW(D=qlCO*%)f^G>#{BDIRX-d|Daq*HUdqUHfJ!;pSp#aw+z+K4Xzc zha0Z?7M}MO{%+ZLrlf4KqPo;}x31B4$p*lFDF)uWDScqC!b!3E+L+;%n-S={3VmwL zE*7qJCUFp%1;2MZ~Y=?x@Pdn2R)q*P~?>aTW@*dRD~?x_yo^#aG2jA+E(_FHT&2|I?C{a23>9>k_kkB3Ix(7L;$8F4apE@Q_C~LT zIrup~%v!M3c9pTuHZIRinOTdig=17_XMEu!^|O!2R6)17_Pc^w^UTC0hHcZ9o}k?c z*qh^32=s<<)DH+%-Jy5AMSwCf($xxr=Mw z@>%jXpoxzsl8VCVjX0D!&5_O|moy!%W0VjH4zRGb#fO^L(L#TYYK3z+uS9ueTZ}4Y zsHujIoC4u#WN|(SgYz|oKFni`IBo2Z0zIaS zA2D!#123~c~8_c>a?T;tR=tp&vT1cP`*@JQE97>_ON z*AbfjV^e-dO99Oj!>5xaIVwo)RAG;%EmMaGfQ)X?7)a)Qr~2L6CS^RXp6B9y?l(WN zHgi|h^cY?|O8b1Cb1bd!TKh8Mm($MYMoU~{-_gMP!R9%upK1M?M=W1Iq5xc8qLqXB zv%BSmqx_#Y!Y*6wH%ox)MAhYT~~^5yz79F5<``gQa?lDXEg+b?E~gqnz3mNGz=HjN{3+3f>pq&tD59nc#L zm@#_I7P19ss>NI>xPXfdtN|zX1>$mG-O=uJ z`puE#-RWa)L7l)T%HA=7m$3%i$^FY8#JHvI`bOOqZle=SW5<#)*}2!irhP^^Pkz;Z zCdoHxqW%$oPb9Zi^0PH)SPDjuL|{Et8L1BcyQtJ8QtUp8o*jnyGfZ!m-rH z-nqg#B5U%ylY!K+`dor+Tdl$MDusdLxlP<`6fYm~^QU_wWyDO>o9N@|%mLLS9Xzqm zbXlXDTM1&R_EBW6?uZX-fgm_vm^{baq+7(Xjl;gg?-(qokGgh_X}caZEH<{b-G`fg z<&{;^J~x&>M-MxKIToFZPy6h2TM=q#^0Ui0J~}pxW3=eyqmq&=!Orf(oJE0So#F!e zn-9He{gP6KQO3|LGfF_|;UYUdHm+9+g54~)7JXSqN=p(Mn zEZFW|#i1B6F4&ix)$S!LJnT@IVgkgdjTlC|a805uVhI9N1WB5ODH4#|HIW#^v1%NM zdxs(-AVEHWe!wmLU+Qt%(_oRB|s=G!UcrK1s#G5(4hdZ4BKKFLa!|BKK;= zEJwIT?h}9)oK+;tp$0&Y-KByYs1#ptfr${pof439l^j|j$fS0yPyQ z?T1y=++#(ao=|?F`xhlaIS&@SwM*m@%h@j`7DclHJ;})n)Vxa|c2iN)?gAa+r#=@M=ofwQ~hV#&?BdOp+_CAnIS71n@;h3ykWqJ3drpIwIQyHNm2@S@}C#4GSk72PkGDOexB&r;A z&A+x(VBr_dE0HBD^-Zg#OEz6peRR63qRoxudTlxAf=Lk5vvQBnwU4N&l=dAF8vTkA z2PwQds15c(mm?U-VNxB-ROV`PrG}%LX8MNdl|F*C3}s1lF|Xm{An4)Kny!|RNIQji zrmC?_IKv9K?;GWHWXjG8tra@4r>aVdoUczdo{35-s|``x;7M}FEs5h)CbW)8XV&PW zs%rd|5=@yP=g#hvG>&(oZA~{dCru$Ji6ziF3;d3G6vRT{Y(~m-PU|L9IF)M+wFy(F zLQNAPPDeDjm2{nwqg;-#!_7_5J6|HJbn+>Bdaj(1WEv7KG(c>M{8YyrfPEq@@7*qh-i-^uDl~&dJKagt!i{y zkbr8P7OGjuCDfJ=#4doBHpb%CKYzJLIjJhODe`c9OBj5v%=Z#}jfc2hB?Uokh$iFA zrty^EBam+R6usnZe^!r*c=|xZf5*3xscY?@M!t z#;(dq0mqYCNFWyxdmC)5IL0j;F-bIr%!!VBkCS-;&CVn=3vO2)aTgZJJg%vDw30X+ zmn1QxMn(@dvASQGxv;udQK(qedyviR5aVaN*lnB6$6tH&)5)XWtMgTAT;e?jgI~0t zGOGAKJn0(JbhzczDTwHEFFlttZ`8s@E?pL$5yS_0&>UNvL8gS8SR0#Ioi*8B=pUW8 z*n;M{r*^rf&Ia7U_<|2LkqS(N5ayByIdAXy+oITUYJkGZwvZs5tZd_x9tD{%u3ItU z-pIcs&XZQ6>GT#@col3rEUUDfFt(|#1H(}ZTYGIRCn+3-rTL<|OukN3%#Q-E%6ca}UnwoH=lm5HB)QlnU?Az4 zyu-G3oV5qj+@@YT*u#e7am{@0TpsruQss2Y1F$d!_elwy!)A{W8hH-BXQH#>FqVs* zhuW&t7^RM4E^ZIIb!9FEbujiVOu}*y(sLUN`CnUp^w%1Gjz8HRfjKp0&nKz-)4W~~ z*!KO&IX_X3xGH#dG+5wyEgjQEQwd~^5;5A4c{pt5o!Ifo?XewoSp4@Exc0RkYQe+U z)=qkV9F~W*p~$rOV|;hB8Ja&L@0>I0ytT7|(&sEv{8;Z(qNRyuhDLzrM)uy!kQO-k zS>Ok@{-e!r6gY@@(OWRe7|TGCHc6(fk)iGL@VF3-4NRlhwp|=$$}yZLw6`>l{ucl> z4~!Bo*Dj~^TzwYN!rin&=3LKC_OJpaow2@nuX_f*cK6r0@V8rX2wB0DHwCoOvd3u4 zqX*Tka2EF`P%?^>G?CK8BqWgc4Dt^qx=h8R$XQwHllB#kf!|{cQ;Xdp?;Is?cF&(P zTJ7M>NyDt`{M(O$sT zCF6F;;P7?xR(=ZYCn*B{5|SlG0U2 znkg(nZG@1@+vJ)Tkb9}4zK#P?c927eIR+Ek0k9XckauXJ*DqL4B=Jkr+Bctu!%=O% zAF;$eukdWxC3C4=E_mL?Nes?rR#dXqc3?a$nmGf6jBB*JPJ%!YxL>x|;XX4Y4kF#- zGdY^rSe63t(l-ucn{DnFTk%H`($+>Hs){;@T>PbyFgyY^xW27(bUB(ux~e07Mz}j) z-Z$r6*|GV*&MytToLFZA%f7Pon0!_aAM&nG39j%dW6IVhsH)+ews(whqZG|9uzb{T zGC2+G3tu#BX<;J7vovR&xh7`}bB*M2aXX9O;_c7awhl05G!aDvOo|v`yYfZ@16!!Q zfEP9nCC5@u>a$P7vA#H^WP$L`+|blCIkCRp+aDXhD-6-N<$GOlH?@k{@V$Ns$@!6` z>}P9yHQ|hD+@ED#up;*=$z8(|G}|fi=W)~#qrbCrA9)GKXB;Wg>F1#O$ zKQk*fw4RuzcFr@!Cnz#BIvHD+HO0tqH*1CV^S4fm563WG?d71|yR`LhFL>C5h6~2c zo)E)!zA{0L%9=aeb<3r{GOTo2IO`BucH#;rM)xt=Ij(R%@5EU9*GRT6!DD^0QMNhQT;`7XnSdlW#Tg8F z*4h@9d+xA&P8*=5@N4*N)MdBipi)h)>d0p1s--J6Ol27a?jp1vs^?VYb7M~2P-89JI^h2C(%Y_-$NNKNJZ48a{F>49 zoNr()ua!Xp>n%0A;18+n;8i}>*Ev?6j73KC(F#$pL%J7<77M+6K~)t>{EhTb&TcmI*)hKA8M*rP(Cx_X&!sG;xzXg6{8m!9%Cl- z?UyVs5wq{rOk#8`m|4R1*z+ETm!~yB!t3=4=SzrzsX8FaH24n;o0T#aJRQ+IUs1^I z?jw=1-+LtD<~K7WaA+-NTi@EvYiJK5vb;jhjGrrya%;la(eS@k>H}}k8wAJe zn=GM~O?w@ZD{kMDuHl>=h&Jd_;3(=`AUTYFUums5o1?WIM*jP!aYEqNJ9e-(`dENS zZOybgk*MmuW}C$$k?oSEBa=YlwuaTy*Sgq>S!vt~*%r zQV*+a*_y%~p$6L9L?<%vi?68#!CYJ_S#zU?;aVESfpFd`>RH{Tz;S7BmDcfq;zDKz zv{)WRMBOV3f=XOI$4!MeY-vvE8KEt?jio{cBwp<~A$rQ`ohCFbMeftLH3*Fo!3@I} zgemEX6g76@M%~f@8gv+p*p($KE;jDhglXS)i`}YS5XQxc8Cah^i8BhLWvGe7q8;18 z+bh21$JnexHl18P)!BH121zfrSAENl>%32}*g4;N1jRFZ2vXDd#n!`yl3-|AY;?dl zJ22?AEDo)vHjCKbb(^W?A@q`|6^=T9j_mbm9|Eg!MRj%U4vNi;-uj(YF{a6k5731* zE7r%9bkT?oLG>nv{`YDGBinnY) z&*qpuYwVJ$sZZ%BO@+7Srh++H8t6(rJOu2g;o+A$*W1ZS#f4?qD02$1x63Q^(Kv1j z8Jtw@Ys*H-r8HOFS8-(;62s~g^kqXyOVJsX#AsDna%r!zQt;GfX<_CFP*Kze1nII_ z18`NzO{|M6i%#JbI?8W~=`&hJk0PNd;!Z)@5u7QCLq3R-9Z)%zNn|9VlxTMtQnZRS zg*bHfRV^ANUsM8WEQ;u7pndY)bY}yP0J3*c~iw zcA`TSoaWn=+D^)egHw~Hi$(0>a~)(S^VxsVamw*-g{1OGN>sQWjBm3w;Ji$|u8G&r z4p!X#D9`gw^#B$-&9~;K%wND#{h;u7%&}P_0OfO}hs$5e#B}rkev#^uFfUu7&*tJ^ zCU$&#Wxm9%p}@v`4U>(H#dXNB)>So`=jG{#56r&Ge z<#kx4?Ee5Txpq)`Z|^*Xl)fd1z6l*oFv{=&YsKEQxnBPO&2zmia<!V0`n;=};6!G}qh1~tw%wSYQ%_5;mq zTrt`EpOnZf-7e5a+J6MrO-?u~Y-Tqugm7^APk=eZdw}&j1*dSI$@$eMJcNr)GsHj@j1(kd=KNo zmu6$fzb86&z(b&It-faxFR=~;9Kh>wdwDK3;%><$ibLE==L?-2NOqkZ-4DH?eLTRh z@mgFTA#)j|l2~QGHnf3a?Qf=mQFzC*tUa=1f;{hWumG15b-C!@QkBwpo=iWD*i4v| zokaQ5J{MNNbF`as4g~r1zr_-Vh};dX;70p`KWJS)#{421DQlWE{EcKX}~?(7}s0_U;%KqwCh~BawWxP>vh=U(l>P4 zjGIjJv3|qjs=s+tnovo5J&O`W@-*1nmTwW$lGLmFEuN4NFEo3Ldt=CrGY`>MtXG36 znImK^17GJ@ay_S!4sN7rs5e%6xZErRq1zVsg5ksTn_>@AJ_UJsYjQbmU3?uplDqjn zdVHy=9%$WB7<+P5#SK9h0K+p}BL?7D3V_D{0B*;0`{a|xk-4s*sCA;B@{l~=@>L?t zXHXk3J=?#sx?{Co8jhutQ_UG`Dj4YH16Ifg@V$}?HM2(G*RZ$)c8*{b!0+Hnx*3c! zM)LN!hD#7}WQ_!6k&bQ4Gjn5za}CC}1pN=eb$D}OmN_(}dA}2eRhBs;Z5`WDz;0_? z(g?~xAm~GZwr2itHq>she$(D*zbYeRnR`j%$&ts|BSH&bzbhR%tL7`)eN6Q9Z4s8q z6C;wT_rG~0do6`xpDGWelp<7O2|uHa}`4}<}593Zrsjk%-@EN zn_Vn&afE{9#T<}Lu1*f)I$3HZeBiaLIUAG$;M)KN-fT73qKLwHW@eLNaCh;5KFgJR z!MGx-l6i2+UzPE>#u*3(Id;2V!Y*4Q25{4>9eZ!8t$cADwK1Agu$6~BJGlZ#xsLrD z1(f8;IZ3H4nBJ_UMg9xkGinliFz+jfPUN{%U$D7cV~9>P7vr{B2yle%srgzigE z=WX$A$HvQ7ABka~Oj=rL$Jj8XUKDBdJxd+zmb=h{_5*bf#GGjjIJ1stokVTlUS#ai z>#5~*+tfiTunrI0d?`GajVhSzs+;*j31kJaNeqFnW6y&ug7CXNfo^vPMoG{(4o2zy zUkysl9~;|aV_+UXS~B5og$6q8QsT*Y8dpVal*PY~3mAK+~(^@h{0B9B#*bbk)WIdYrTPyA2FUfv+S^>AbpRrm#aOb!+fVsrz z*6M%V=4=;^oo+o2nKh5|9ZOJ)9w)B<0BW3*vRcy2*<;juJ?Dse*`>b+6+p(Y$zyfA zB=ios_vxbO$`asWd+{r1k>i|g#x@MsA=(S|8>o70XlNBfh%pzJ48hH|n%>v)x+E2c zs+W!?T=f!^t(puKch>4c0twfi{ST-*5UH4MEG@}RQ`hK#@z7Z0O$uVXBN*{9q#q-v z!0e!^3!96!1F0)p zHKLr;Jj6F-p@cm5Zx;pPz?NJaYsju&iM;_QkQ(2}4yyBw)lE%AA(5>QmHjUGn&yH= zZF0Ts1Qvs%NxtcvICo@K@>?cn2tUYx$Gb(D$14bHMwc6vO>x%euD=_U;JFN*i`=O3 zN0XG?otKU}24}(}9%OE6)Q?GP^;bzM*GiR~rd~@uVTe0lnBPlQ0BmZV%e4 z0blr%ow7DdG+Zaf$P38}`OO`0_7i&KJ)P0966Fv#y<#SE>GE`8l)WP$vGtl`bnm1e`4sP$H35mw7} zDaz64oKsfUJBMTp&1ad<(qks&XDIUq&M^hsY}i9X>Z=Umw^n2TfBW=<(sN!2rGQ}|pw z$WqCQwmYPQ;E}~Ga1^aQxhPu6uJuMT_$Ki8Xq?sJ2jHXWouV|-XjQ$7-vOOiN{*f_ zK}ner-fj>YI>q79z^Uq)tU>fu-uIfAmTR@Aq8x%jgv7TAt5k$+&*kQ=ST_JiP|(=s zwMUEcZg1q?2EmeU9)79clGVek$Bqd}nVGcibF@*ej?=1jiD55@kt0iNNH^FK)cqgr zSw=RjdqczrF{t?LocqKpb*dKfWSvnc!Tf$HrA2tzx}Lm;znSz<(_%&5*56cq+kVni zts_9OBINAR`+5b5sqrV)G&>DH7RQ)mE;}@Oo2x}V00QMj(?;)3zDfK#tk;@S=1i9# zWIv8wchNl!4$upxw2_0$-mF+{ErKpMxdU{C>99)+xQ6-!jJPHBZ{4D>(M_QTWa+Vk z*2-swKH(uQcqsE=ptRoCRUA%-DbZiJm4qJ-+|^FG!(y^CH69VUh7Iym@hVHU_Sc$i zTSjH3Hy_Ohc)9>|zuc#%kD^N&qjO+mFJ{U^o;r)|ewO5ij#b!9@ZiQUsIs`UY&9N- zU$Jlfj+meT8kE ztk9ag7MiEpd^dtnHP8~vpLl8h(!jV`u5?k2+|XEU)-#vwXb$(S4+zataALZMToYd0 z4qX}sLZl+3zQh}El!sf_DK@sA zH!gYT2xz%B0dp7fgX$)H^Xm7T*b-XMJ(jlr07ZjAe_m_Jc(kIQ{{XS4rrfypCoo9O zyd%_=BOHKe-A`U>zdkkeT7C*nj%#IWd{1`gpk7Kzj?p7U#fF*09bj>{{hQs($T<5a zZe11L7$THhmOOr|_VWV&00jvK1k8jy2M3Eer%-R#%kEUXSB9!-NpxA}gW4AHK0nQK zb#s8^_JeV_zNIPQQ~W$Jh~{gD$~4$8sM>UEzgPB!c)&22U2MdUeZOkw?jP-9Ktn(d zKUD92eC`jDwME*bm&@HXr>`%(q_SypJ_hmSfzz06btDb&G&$XO`*%oU-J`l-86)yU z-NSTqhf9vD6sPSFWC7M4a_{ygGjYsh-NV8*7vIg^UP&*xKXJ#MdmB|pYY*=GihD&6 z9JD&_Z_UT5tz&($GKw-HyWekXo@4pMT$8qo8sZMtql_Iz{J)E=M;z@wNgfC!wXV&U z_RVdsc_;9AR`<#QJxwkR{ysOCGo_rgx%!5mqw(qJtI}iDRgN)JGdV3J+~kRXZe1bp zjYzN;alYHE2N>h(xefd+7xqQn@h;!fMD{M$u_oIj*?IuMVWqa&Z{zUD#oM77WRpey zE;Xs8J=E=zo<_SV4mTI-*&0l44jO{j9TvOU&u;E9I-W;euW&6U_Xo(6V7R{-ha~mxWvb;V=#@w#CJ7zj>YhTOIuGV;NCmW(P+Kij29o5#l?=RS#+=5@UJqV&&H_Cp7C~IfcV`w-r>=R2IzA)0LYWjJve8 z!$W(WH}YC{4R(~-8Ub~Uxvwdo!nX4sjr@AG)Q-M(I~>dgH-~i1_Yij~k;Jr7xPv>rHF4YOEo2s(TfiM)R!L3(FIT0~ zWW$eq`(|7<5X+IldmO#;!{OfSQ(_SKp2FBy1}o_L+k+rjn+e!#8~k@@O=cA>PD6HnW49U~kULi8u=q?Z@!q%02l%b|%T^BK^%c#HLUruMw6ttt%>%o;>T+B$-m#wsy;=cN^bYSp zY>jQs&Kn=V`lRV;!QG?arKm#y%3J6B6h$(=T?0WIW6)|j^&Wm|evcCaXKCuH(nQ;w zt~cp#+LMu%HwRyW?ipsUg7Jvs4RdyDk4GDSpSQ(Ss?2WD;KWbX7am%+_8w#an9qqF zv?rQEqO1@a;h1Y-avU$sudyvYTD0>El>mGRVt6B>9qeudH(Ry9pT7F-qNH}8h6;L? zy@Zy?80UgXwr~&9*TQ!4R%(iVO>vM9X{2S9gQ;lJR{nHE`LrnR-f=kQlAVqA*w~|X zmbq#BNFM&F+*6WuV)+zWvwis{Vm3AMWov+=BO{s|9OEN9vgQ$$`AzgYU0;53>)#_| z@?b4*pN8ZQb(II?fs8eg*T!4oF|qA+xd#T8lgM7ge&wL!d|V_Mqj1X8l$@l+n0+4h z*)M%GaS9yv%8Oyfr5hm~g9&A83$o`V7g&-B2VHoj=7?8 zyVG$fiL*}j+q#M7`-Z*4D>>_$=GIk=a;>eTe3!N0(4Va=VXgaIw)9!OGrp(}s}|Om z$-~{2;ZK$jM}?)tx#v-G8*m5Gci1_tR{^JNcgQWMZTEAwxi0?z!YmUACXN`}6e7%w zWp7+pvN522RoDTSrS{Vj^d~!jb9q#?(P!frj{PISWD_OG96sw_H$1= zM8}@^#aZ~zfv&>IXyV$5)@rxOMf(%K$^f@3fU)H3ID86>sNpD`sAzBK8-1H5 zf@`N#CtcA}qd$6=u^lf50kgg%@J)p?nn?Rq+9?|U015EBuOguFS~A_#Z()3>rD$Oe zD{b^orNxVY7bf}v`;~q#8?4cOs`JBKI&X3{>utP;K$^#kcPw6cw(y6XJ;LA&&-S`< zZ>O4@G-PN6`2o4VPgL$Wa@zj@y=goXi^on}d!{}{v>fl(Bi-z@H*C#sh?B9hYE48G zLE%mkZ4*S(*wr{@iUX*Lq<=XlEZo}PihqvqYpN-^iL)6-ZQM?p`H`x3!I(*@mGa0- zgHC5(Qs*CJA0fH^$kAwKmsIwFdc4Q_9hqEqoOx3LV~ZRt=9>}by(v=NpisG$Qin8) zyH138C<&da^=ekE^Ae3phxC|neeJN^qql~nF_~J@V`;H)*nZ`8#CT`9!{VGBWIiu? z)O!Vmrhtb4L(G>1ToknO*CUYAsd4lo?3dwjq~tz1%0A(gwu4%q`_6 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\>|Ht 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 S5~A#g1Pw&FMq=QJAOG2QBH)ey literal 0 HcmV?d00001 diff --git a/extern/stb_image.h b/extern/stb_image.h new file mode 100644 index 00000000..9eedabed --- /dev/null +++ b/extern/stb_image.h @@ -0,0 +1,7988 @@ +/* stb_image - v2.30 - 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.30 (2024-05-31) avoid erroneous gcc warning + 2.29 (2023-05-xx) optimizations + 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 ints fits in a signed short, 0 on overflow. +static int stbi__mul2shorts_valid(int a, int 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 stbi_uc 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)) { + stbi_uc x = stbi__get8(j->s); + while (x == 0xff) { // 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; + int hit_zeof_once; + 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)) { + if (!a->hit_zeof_once) { + // This is the first time we hit eof, insert 16 extra padding btis + // to allow us to keep going; if we actually consume any of them + // though, that is invalid data. This is caught later. + a->hit_zeof_once = 1; + a->num_bits += 16; // add 16 implicit zero bits + } else { + // We already inserted our extra 16 padding bits and are again + // out, this stream is actually prematurely terminated. + return -1; + } + } else { + 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; + if (a->hit_zeof_once && a->num_bits < 16) { + // The first time we hit zeof, we inserted 16 extra zero bits into our bit + // buffer so the decoder can just do its speculative decoding. But if we + // actually consumed any of those bits (which is the case when num_bits < 16), + // the stream actually read past the end so it is malformed. + return stbi__err("unexpected end","Corrupt PNG"); + } + 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 (len > a->zout_end - zout) { + 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; + a->hit_zeof_once = 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 filter used for first scanline to avoid needing a dummy row of 0s + STBI__F_avg_first +}; + +static stbi_uc first_row_filter[5] = +{ + STBI__F_none, + STBI__F_sub, + STBI__F_none, + STBI__F_avg_first, + STBI__F_sub // Paeth with b=c=0 turns out to be equivalent to sub +}; + +static int stbi__paeth(int a, int b, int c) +{ + // This formulation looks very different from the reference in the PNG spec, but is + // actually equivalent and has favorable data dependencies and admits straightforward + // generation of branch-free code, which helps performance significantly. + int thresh = c*3 - (a + b); + int lo = a < b ? a : b; + int hi = a < b ? b : a; + int t0 = (hi <= thresh) ? lo : c; + int t1 = (thresh <= lo) ? hi : t0; + return t1; +} + +static const stbi_uc stbi__depth_scale_table[9] = { 0, 0xff, 0x55, 0, 0x11, 0,0,0, 0x01 }; + +// adds an extra all-255 alpha channel +// dest == src is legal +// img_n must be 1 or 3 +static void stbi__create_png_alpha_expand8(stbi_uc *dest, stbi_uc *src, stbi__uint32 x, int img_n) +{ + int i; + // must process data backwards since we allow dest==src + if (img_n == 1) { + for (i=x-1; i >= 0; --i) { + dest[i*2+1] = 255; + dest[i*2+0] = src[i]; + } + } else { + STBI_ASSERT(img_n == 3); + for (i=x-1; i >= 0; --i) { + dest[i*4+3] = 255; + dest[i*4+2] = src[i*3+2]; + dest[i*4+1] = src[i*3+1]; + dest[i*4+0] = src[i*3+0]; + } + } +} + +// 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; + stbi_uc *filter_buf; + int all_ok = 1; + 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"); + + // note: error exits here don't need to clean up a->out individually, + // stbi__do_png always does on error. + 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); + if (!stbi__mad2sizes_valid(img_width_bytes, y, img_width_bytes)) return stbi__err("too large", "Corrupt PNG"); + 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"); + + // Allocate two scan lines worth of filter workspace buffer. + filter_buf = (stbi_uc *) stbi__malloc_mad2(img_width_bytes, 2, 0); + if (!filter_buf) return stbi__err("outofmem", "Out of memory"); + + // Filtering for low-bit-depth images + if (depth < 8) { + filter_bytes = 1; + width = img_width_bytes; + } + + for (j=0; j < y; ++j) { + // cur/prior filter buffers alternate + stbi_uc *cur = filter_buf + (j & 1)*img_width_bytes; + stbi_uc *prior = filter_buf + (~j & 1)*img_width_bytes; + stbi_uc *dest = a->out + stride*j; + int nk = width * filter_bytes; + int filter = *raw++; + + // check filter type + if (filter > 4) { + all_ok = stbi__err("invalid filter","Corrupt PNG"); + break; + } + + // if first row, use special filter that doesn't sample previous row + if (j == 0) filter = first_row_filter[filter]; + + // perform actual filtering + switch (filter) { + case STBI__F_none: + memcpy(cur, raw, nk); + break; + case STBI__F_sub: + memcpy(cur, raw, filter_bytes); + for (k = filter_bytes; k < nk; ++k) + cur[k] = STBI__BYTECAST(raw[k] + cur[k-filter_bytes]); + break; + case STBI__F_up: + for (k = 0; k < nk; ++k) + cur[k] = STBI__BYTECAST(raw[k] + prior[k]); + break; + case STBI__F_avg: + for (k = 0; k < filter_bytes; ++k) + cur[k] = STBI__BYTECAST(raw[k] + (prior[k]>>1)); + for (k = filter_bytes; k < nk; ++k) + cur[k] = STBI__BYTECAST(raw[k] + ((prior[k] + cur[k-filter_bytes])>>1)); + break; + case STBI__F_paeth: + for (k = 0; k < filter_bytes; ++k) + cur[k] = STBI__BYTECAST(raw[k] + prior[k]); // prior[k] == stbi__paeth(0,prior[k],0) + for (k = filter_bytes; k < nk; ++k) + cur[k] = STBI__BYTECAST(raw[k] + stbi__paeth(cur[k-filter_bytes], prior[k], prior[k-filter_bytes])); + break; + case STBI__F_avg_first: + memcpy(cur, raw, filter_bytes); + for (k = filter_bytes; k < nk; ++k) + cur[k] = STBI__BYTECAST(raw[k] + (cur[k-filter_bytes] >> 1)); + break; + } + + raw += nk; + + // expand decoded bits in cur to dest, also adding an extra alpha channel if desired + if (depth < 8) { + stbi_uc scale = (color == 0) ? stbi__depth_scale_table[depth] : 1; // scale grayscale values to 0..255 range + stbi_uc *in = cur; + stbi_uc *out = dest; + stbi_uc inb = 0; + stbi__uint32 nsmp = x*img_n; + + // expand bits to bytes first + if (depth == 4) { + for (i=0; i < nsmp; ++i) { + if ((i & 1) == 0) inb = *in++; + *out++ = scale * (inb >> 4); + inb <<= 4; + } + } else if (depth == 2) { + for (i=0; i < nsmp; ++i) { + if ((i & 3) == 0) inb = *in++; + *out++ = scale * (inb >> 6); + inb <<= 2; + } + } else { + STBI_ASSERT(depth == 1); + for (i=0; i < nsmp; ++i) { + if ((i & 7) == 0) inb = *in++; + *out++ = scale * (inb >> 7); + inb <<= 1; + } + } + + // insert alpha=255 values if desired + if (img_n != out_n) + stbi__create_png_alpha_expand8(dest, dest, x, img_n); + } else if (depth == 8) { + if (img_n == out_n) + memcpy(dest, cur, x*img_n); + else + stbi__create_png_alpha_expand8(dest, cur, x, img_n); + } else if (depth == 16) { + // convert the image data from big-endian to platform-native + stbi__uint16 *dest16 = (stbi__uint16*)dest; + stbi__uint32 nsmp = x*img_n; + + if (img_n == out_n) { + for (i = 0; i < nsmp; ++i, ++dest16, cur += 2) + *dest16 = (cur[0] << 8) | cur[1]; + } else { + STBI_ASSERT(img_n+1 == out_n); + if (img_n == 1) { + for (i = 0; i < x; ++i, dest16 += 2, cur += 2) { + dest16[0] = (cur[0] << 8) | cur[1]; + dest16[1] = 0xffff; + } + } else { + STBI_ASSERT(img_n == 3); + for (i = 0; i < x; ++i, dest16 += 4, cur += 6) { + dest16[0] = (cur[0] << 8) | cur[1]; + dest16[1] = (cur[2] << 8) | cur[3]; + dest16[2] = (cur[4] << 8) | cur[5]; + dest16[3] = 0xffff; + } + } + } + } + } + + STBI_FREE(filter_buf); + if (!all_ok) return 0; + + 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 < 3; ++k) // extra loop test to suppress false GCC warning + tc16[k] = (stbi__uint16)stbi__get16be(s); // copy the values as-is + } else { + for (k = 0; k < s->img_n && k < 3; ++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/include/pipeline/wmo_loader.hpp b/include/pipeline/wmo_loader.hpp index 5cf14820..f3c76cd3 100644 --- a/include/pipeline/wmo_loader.hpp +++ b/include/pipeline/wmo_loader.hpp @@ -100,6 +100,20 @@ struct WMOPortalPlane { float distance; }; +// WMO Liquid (MLIQ chunk data) +struct WMOLiquid { + uint32_t xVerts = 0; // Vertices in X direction + uint32_t yVerts = 0; // Vertices in Y direction + uint32_t xTiles = 0; // Tiles in X (= xVerts - 1) + uint32_t yTiles = 0; // Tiles in Y (= yVerts - 1) + glm::vec3 basePosition; // Corner position in model space + uint16_t materialId = 0; // Liquid material/type + std::vector heights; // Height per vertex (xVerts * yVerts) + std::vector flags; // Flags per tile (xTiles * yTiles) + + bool hasLiquid() const { return xVerts > 0 && yVerts > 0; } +}; + // WMO Group Vertex struct WMOVertex { glm::vec3 position; @@ -143,6 +157,9 @@ struct WMOGroup { // BSP tree (for collision - optional) std::vector bspNodes; + // Liquid data (MLIQ chunk) + WMOLiquid liquid; + std::string name; std::string description; }; diff --git a/include/rendering/camera_controller.hpp b/include/rendering/camera_controller.hpp index 6de3e9aa..8da908c8 100644 --- a/include/rendering/camera_controller.hpp +++ b/include/rendering/camera_controller.hpp @@ -126,10 +126,9 @@ private: static constexpr float WOW_GRAVITY = -19.29f; static constexpr float WOW_JUMP_VELOCITY = 7.96f; - // Default spawn position (on terrain near Stormwind) - // Terrain chunks are around X=[-9100, -9066], Y=[-533, 0] - glm::vec3 defaultPosition = glm::vec3(-9080.0f, -100.0f, 100.0f); - float defaultYaw = 180.0f; // Look south toward Stormwind gate + // Default spawn position (Stormwind Trade District) + glm::vec3 defaultPosition = glm::vec3(-8830.0f, 640.0f, 200.0f); + float defaultYaw = 0.0f; // Look north toward canals float defaultPitch = -5.0f; }; diff --git a/include/rendering/loading_screen.hpp b/include/rendering/loading_screen.hpp new file mode 100644 index 00000000..d4f8f27b --- /dev/null +++ b/include/rendering/loading_screen.hpp @@ -0,0 +1,50 @@ +#pragma once + +#include +#include +#include + +namespace wowee { +namespace rendering { + +class LoadingScreen { +public: + LoadingScreen(); + ~LoadingScreen(); + + bool initialize(); + void shutdown(); + + // Select a random loading screen image + void selectRandomImage(); + + // Render the loading screen (call in a loop while loading) + void render(); + + // Update loading progress (0.0 to 1.0) + void setProgress(float progress) { loadProgress = progress; } + + // Set loading status text + void setStatus(const std::string& status) { statusText = status; } + +private: + bool loadImage(const std::string& path); + void createQuad(); + + GLuint textureId = 0; + GLuint vao = 0; + GLuint vbo = 0; + GLuint shaderId = 0; + + std::vector imagePaths; + int currentImageIndex = 0; + + float loadProgress = 0.0f; + std::string statusText = "Loading..."; + + int imageWidth = 0; + int imageHeight = 0; +}; + +} // namespace rendering +} // namespace wowee diff --git a/include/rendering/water_renderer.hpp b/include/rendering/water_renderer.hpp index 99ab49bc..f9ec86cf 100644 --- a/include/rendering/water_renderer.hpp +++ b/include/rendering/water_renderer.hpp @@ -9,6 +9,7 @@ namespace wowee { namespace pipeline { struct ADTTerrain; struct LiquidData; + struct WMOLiquid; } namespace rendering { @@ -28,6 +29,9 @@ struct WaterSurface { // Owning tile coordinates (for per-tile removal) int tileX = -1, tileY = -1; + // Owning WMO instance ID (for WMO liquid removal, 0 = terrain water) + uint32_t wmoId = 0; + // Water layer dimensions within chunk (0-7 offset, 1-8 size) uint8_t xOffset = 0; uint8_t yOffset = 0; @@ -73,6 +77,20 @@ public: void loadFromTerrain(const pipeline::ADTTerrain& terrain, bool append = false, int tileX = -1, int tileY = -1); + /** + * Load water surface from WMO liquid data + * @param liquid WMO liquid data from MLIQ chunk + * @param modelMatrix WMO instance model matrix for transforming to world space + * @param wmoId WMO instance ID for tracking ownership + */ + void loadFromWMO(const pipeline::WMOLiquid& liquid, const glm::mat4& modelMatrix, uint32_t wmoId); + + /** + * Remove all water surfaces belonging to a specific WMO instance + * @param wmoId WMO instance ID + */ + void removeWMO(uint32_t wmoId); + /** * Remove all water surfaces belonging to a specific tile * @param tileX Tile X coordinate diff --git a/include/rendering/wmo_renderer.hpp b/include/rendering/wmo_renderer.hpp index 52d2f983..ebdf5f0d 100644 --- a/include/rendering/wmo_renderer.hpp +++ b/include/rendering/wmo_renderer.hpp @@ -221,6 +221,7 @@ private: glm::vec3 rotation; // Euler angles (radians) float scale; glm::mat4 modelMatrix; + glm::mat4 invModelMatrix; // Cached inverse for collision void updateModelMatrix(); }; diff --git a/src/core/application.cpp b/src/core/application.cpp index 05b25db5..dc501d33 100644 --- a/src/core/application.cpp +++ b/src/core/application.cpp @@ -16,6 +16,7 @@ #include "rendering/character_renderer.hpp" #include "rendering/wmo_renderer.hpp" #include "rendering/minimap.hpp" +#include "rendering/loading_screen.hpp" #include #include "pipeline/m2_loader.hpp" #include "pipeline/wmo_loader.hpp" @@ -107,11 +108,42 @@ bool Application::initialize() { void Application::run() { LOG_INFO("Starting main loop"); - // Auto-load terrain for testing - if (assetManager && assetManager->isInitialized() && renderer) { - renderer->loadTestTerrain(assetManager.get(), "World\\Maps\\Azeroth\\Azeroth_32_49.adt"); - // Spawn player character with third-person camera - spawnPlayerCharacter(); + // Show loading screen while loading initial data + rendering::LoadingScreen loadingScreen; + if (loadingScreen.initialize()) { + // Render loading screen + loadingScreen.setStatus("Initializing..."); + loadingScreen.render(); + window->swapBuffers(); + + // Load terrain data + if (assetManager && assetManager->isInitialized() && renderer) { + loadingScreen.setStatus("Loading terrain..."); + loadingScreen.render(); + window->swapBuffers(); + + renderer->loadTestTerrain(assetManager.get(), "World\\Maps\\Azeroth\\Azeroth_32_49.adt"); + + loadingScreen.setStatus("Spawning character..."); + loadingScreen.render(); + window->swapBuffers(); + + // Spawn player character with third-person camera + spawnPlayerCharacter(); + } + + loadingScreen.setStatus("Ready!"); + loadingScreen.render(); + window->swapBuffers(); + SDL_Delay(500); // Brief pause to show "Ready!" + + loadingScreen.shutdown(); + } else { + // Fallback: load without loading screen + if (assetManager && assetManager->isInitialized() && renderer) { + renderer->loadTestTerrain(assetManager.get(), "World\\Maps\\Azeroth\\Azeroth_32_49.adt"); + spawnPlayerCharacter(); + } } auto lastTime = std::chrono::high_resolution_clock::now(); @@ -452,146 +484,7 @@ void Application::run() { LOG_INFO("Minimap ", renderer->getMinimap()->isEnabled() ? "enabled" : "disabled"); } } - // O: Spawn test WMO building at camera position - // Shift+O: Load real WMO from MPQ - else if (event.key.keysym.scancode == SDL_SCANCODE_O) { - // Check if Shift is held for real WMO loading - bool shiftHeld = (event.key.keysym.mod & KMOD_SHIFT) != 0; - - if (shiftHeld && assetManager && assetManager->isInitialized() && - renderer && renderer->getWMORenderer() && renderer->getCamera()) { - // Load a real WMO from MPQ (try a simple mailbox) - auto* wmoRenderer = renderer->getWMORenderer(); - auto* camera = renderer->getCamera(); - - // Try to load a simple WMO - mailbox is small and common - const char* wmoPath = "World\\wmo\\Azeroth\\Buildings\\Human_Mailbox\\Human_Mailbox.wmo"; - LOG_INFO("Loading real WMO from MPQ: ", wmoPath); - - auto wmoData = assetManager->readFile(wmoPath); - if (wmoData.empty()) { - LOG_WARNING("Failed to load WMO file from MPQ. Trying alternative path..."); - // Try alternative path - wmoPath = "World\\wmo\\Dungeon\\LD_Prison\\LD_Prison_Cell01.wmo"; - wmoData = assetManager->readFile(wmoPath); - } - - if (!wmoData.empty()) { - // Parse WMO - pipeline::WMOModel wmoModel = pipeline::WMOLoader::load(wmoData); - - if (wmoModel.isValid()) { - // Use unique model ID (2 for real WMOs) - static uint32_t nextModelId = 2; - uint32_t modelId = nextModelId++; - - if (wmoRenderer->loadModel(wmoModel, modelId)) { - // Spawn WMO in front of camera - glm::vec3 spawnPos = camera->getPosition() + camera->getForward() * 20.0f; - uint32_t instanceId = wmoRenderer->createInstance(modelId, spawnPos); - - if (instanceId > 0) { - LOG_INFO("Spawned real WMO (", wmoModel.groups.size(), " groups) at (", - static_cast(spawnPos.x), ", ", - static_cast(spawnPos.y), ", ", - static_cast(spawnPos.z), ")"); - LOG_INFO("WMO has ", wmoModel.materials.size(), " materials, ", - wmoModel.textures.size(), " textures"); - } - } else { - LOG_ERROR("Failed to load WMO model into renderer"); - } - } else { - LOG_ERROR("Failed to parse WMO file"); - } - } else { - LOG_WARNING("WMO file not found in MPQ archives"); - LOG_INFO("Make sure WOW_DATA_PATH environment variable points to valid WoW 3.3.5a installation"); - } - } - else if (renderer && renderer->getWMORenderer() && renderer->getCamera()) { - auto* wmoRenderer = renderer->getWMORenderer(); - auto* camera = renderer->getCamera(); - - // Create a simple cube building as placeholder WMO - // (Real WMO would be loaded from MPQ) - pipeline::WMOModel testWMO; - testWMO.version = 17; - testWMO.nGroups = 1; - - // Create a single group with cube geometry - pipeline::WMOGroup group; - group.flags = 0; - group.groupId = 0; - - // Cube building vertices (larger than character cube) - float size = 5.0f; - std::vector cubePos = { - {-size, -size, -size}, { size, -size, -size}, - { size, size, -size}, {-size, size, -size}, - {-size, -size, size}, { size, -size, size}, - { size, size, size}, {-size, size, size} - }; - - for (const auto& pos : cubePos) { - pipeline::WMOVertex v; - v.position = pos; - v.normal = glm::normalize(pos); - v.texCoord = glm::vec2(0.5f); - v.color = glm::vec4(0.8f, 0.7f, 0.6f, 1.0f); // Stone color - group.vertices.push_back(v); - } - - // Cube indices (12 triangles, 36 indices) - uint16_t cubeIndices[] = { - 0,1,2, 0,2,3, // Front - 4,6,5, 4,7,6, // Back - 0,4,5, 0,5,1, // Bottom - 2,6,7, 2,7,3, // Top - 0,3,7, 0,7,4, // Left - 1,5,6, 1,6,2 // Right - }; - for (uint16_t idx : cubeIndices) { - group.indices.push_back(idx); - } - - // Bounding box - group.boundingBoxMin = glm::vec3(-size); - group.boundingBoxMax = glm::vec3(size); - - // Single batch (no materials for now) - pipeline::WMOBatch batch; - batch.startIndex = 0; - batch.indexCount = 36; - batch.startVertex = 0; - batch.lastVertex = 7; - batch.materialId = 0; - group.batches.push_back(batch); - - testWMO.groups.push_back(group); - testWMO.boundingBoxMin = glm::vec3(-size); - testWMO.boundingBoxMax = glm::vec3(size); - - // Load WMO model (reuse ID 1 for simplicity) - static bool wmoModelLoaded = false; - if (!wmoModelLoaded) { - wmoRenderer->loadModel(testWMO, 1); - wmoModelLoaded = true; - } - - // Spawn WMO in front of camera - glm::vec3 spawnPos = camera->getPosition() + camera->getForward() * 20.0f; - uint32_t instanceId = wmoRenderer->createInstance(1, spawnPos); - - if (instanceId > 0) { - LOG_INFO("Spawned test WMO building at (", - static_cast(spawnPos.x), ", ", - static_cast(spawnPos.y), ", ", - static_cast(spawnPos.z), ")"); - } - } - } - // P: Remove all WMO buildings + // P: Remove all WMO buildings (O key removed) else if (event.key.keysym.scancode == SDL_SCANCODE_P) { if (renderer && renderer->getWMORenderer()) { renderer->getWMORenderer()->clearInstances(); diff --git a/src/rendering/loading_screen.cpp b/src/rendering/loading_screen.cpp new file mode 100644 index 00000000..d141e3f7 --- /dev/null +++ b/src/rendering/loading_screen.cpp @@ -0,0 +1,225 @@ +#include "rendering/loading_screen.hpp" +#include "core/logger.hpp" +#include +#include + +#define STB_IMAGE_IMPLEMENTATION +#include "stb_image.h" + +namespace wowee { +namespace rendering { + +LoadingScreen::LoadingScreen() { + // Add loading screen image paths + imagePaths.push_back("assets/loading1.jpg"); + imagePaths.push_back("assets/loading2.jpg"); +} + +LoadingScreen::~LoadingScreen() { + shutdown(); +} + +bool LoadingScreen::initialize() { + LOG_INFO("Initializing loading screen"); + + // Create simple shader for textured quad + const char* vertexSrc = R"( + #version 330 core + layout (location = 0) in vec2 aPos; + layout (location = 1) in vec2 aTexCoord; + out vec2 TexCoord; + void main() { + gl_Position = vec4(aPos, 0.0, 1.0); + TexCoord = aTexCoord; + } + )"; + + const char* fragmentSrc = R"( + #version 330 core + in vec2 TexCoord; + out vec4 FragColor; + uniform sampler2D screenTexture; + void main() { + FragColor = texture(screenTexture, TexCoord); + } + )"; + + // Compile vertex shader + GLuint vertexShader = glCreateShader(GL_VERTEX_SHADER); + glShaderSource(vertexShader, 1, &vertexSrc, nullptr); + glCompileShader(vertexShader); + + GLint success; + glGetShaderiv(vertexShader, GL_COMPILE_STATUS, &success); + if (!success) { + char infoLog[512]; + glGetShaderInfoLog(vertexShader, 512, nullptr, infoLog); + LOG_ERROR("Loading screen vertex shader compilation failed: ", infoLog); + return false; + } + + // Compile fragment shader + GLuint fragmentShader = glCreateShader(GL_FRAGMENT_SHADER); + glShaderSource(fragmentShader, 1, &fragmentSrc, nullptr); + glCompileShader(fragmentShader); + + glGetShaderiv(fragmentShader, GL_COMPILE_STATUS, &success); + if (!success) { + char infoLog[512]; + glGetShaderInfoLog(fragmentShader, 512, nullptr, infoLog); + LOG_ERROR("Loading screen fragment shader compilation failed: ", infoLog); + return false; + } + + // Link shader program + shaderId = glCreateProgram(); + glAttachShader(shaderId, vertexShader); + glAttachShader(shaderId, fragmentShader); + glLinkProgram(shaderId); + + glGetProgramiv(shaderId, GL_LINK_STATUS, &success); + if (!success) { + char infoLog[512]; + glGetProgramInfoLog(shaderId, 512, nullptr, infoLog); + LOG_ERROR("Loading screen shader linking failed: ", infoLog); + return false; + } + + glDeleteShader(vertexShader); + glDeleteShader(fragmentShader); + + createQuad(); + selectRandomImage(); + + LOG_INFO("Loading screen initialized"); + return true; +} + +void LoadingScreen::shutdown() { + if (textureId) { + glDeleteTextures(1, &textureId); + textureId = 0; + } + if (vao) { + glDeleteVertexArrays(1, &vao); + vao = 0; + } + if (vbo) { + glDeleteBuffers(1, &vbo); + vbo = 0; + } + if (shaderId) { + glDeleteProgram(shaderId); + shaderId = 0; + } +} + +void LoadingScreen::selectRandomImage() { + if (imagePaths.empty()) return; + + // Seed with current time + unsigned seed = static_cast( + std::chrono::system_clock::now().time_since_epoch().count()); + std::default_random_engine generator(seed); + std::uniform_int_distribution distribution(0, imagePaths.size() - 1); + + currentImageIndex = distribution(generator); + LOG_INFO("Selected loading screen: ", imagePaths[currentImageIndex]); + + loadImage(imagePaths[currentImageIndex]); +} + +bool LoadingScreen::loadImage(const std::string& path) { + // Delete old texture if exists + if (textureId) { + glDeleteTextures(1, &textureId); + textureId = 0; + } + + // Load image with stb_image + int channels; + stbi_set_flip_vertically_on_load(true); + unsigned char* data = stbi_load(path.c_str(), &imageWidth, &imageHeight, &channels, 4); + + if (!data) { + LOG_ERROR("Failed to load loading screen image: ", path); + return false; + } + + LOG_INFO("Loaded loading screen image: ", imageWidth, "x", imageHeight); + + // Create OpenGL texture + glGenTextures(1, &textureId); + glBindTexture(GL_TEXTURE_2D, textureId); + + glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_WRAP_S, GL_CLAMP_TO_EDGE); + glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_WRAP_T, GL_CLAMP_TO_EDGE); + glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_LINEAR); + glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_LINEAR); + + glTexImage2D(GL_TEXTURE_2D, 0, GL_RGBA, imageWidth, imageHeight, 0, + GL_RGBA, GL_UNSIGNED_BYTE, data); + + stbi_image_free(data); + glBindTexture(GL_TEXTURE_2D, 0); + + return true; +} + +void LoadingScreen::createQuad() { + // Full-screen quad vertices (position + texcoord) + float vertices[] = { + // Position // TexCoord + -1.0f, 1.0f, 0.0f, 1.0f, // Top-left + -1.0f, -1.0f, 0.0f, 0.0f, // Bottom-left + 1.0f, -1.0f, 1.0f, 0.0f, // Bottom-right + + -1.0f, 1.0f, 0.0f, 1.0f, // Top-left + 1.0f, -1.0f, 1.0f, 0.0f, // Bottom-right + 1.0f, 1.0f, 1.0f, 1.0f // Top-right + }; + + glGenVertexArrays(1, &vao); + glGenBuffers(1, &vbo); + + glBindVertexArray(vao); + glBindBuffer(GL_ARRAY_BUFFER, vbo); + glBufferData(GL_ARRAY_BUFFER, sizeof(vertices), vertices, GL_STATIC_DRAW); + + // Position attribute + glVertexAttribPointer(0, 2, GL_FLOAT, GL_FALSE, 4 * sizeof(float), (void*)0); + glEnableVertexAttribArray(0); + + // Texture coordinate attribute + glVertexAttribPointer(1, 2, GL_FLOAT, GL_FALSE, 4 * sizeof(float), (void*)(2 * sizeof(float))); + glEnableVertexAttribArray(1); + + glBindVertexArray(0); +} + +void LoadingScreen::render() { + if (!textureId || !vao || !shaderId) return; + + // Clear screen + glClearColor(0.0f, 0.0f, 0.0f, 1.0f); + glClear(GL_COLOR_BUFFER_BIT); + + // Disable depth test for 2D rendering + glDisable(GL_DEPTH_TEST); + + // Use shader and bind texture + glUseProgram(shaderId); + glActiveTexture(GL_TEXTURE0); + glBindTexture(GL_TEXTURE_2D, textureId); + + // Draw quad + glBindVertexArray(vao); + glDrawArrays(GL_TRIANGLES, 0, 6); + glBindVertexArray(0); + + // Re-enable depth test + glEnable(GL_DEPTH_TEST); +} + +} // namespace rendering +} // namespace wowee diff --git a/src/rendering/terrain_manager.cpp b/src/rendering/terrain_manager.cpp index 08a96e57..aba9430e 100644 --- a/src/rendering/terrain_manager.cpp +++ b/src/rendering/terrain_manager.cpp @@ -469,15 +469,37 @@ void TerrainManager::finalizeTile(std::unique_ptr pending) { } int loadedWMOs = 0; + int loadedLiquids = 0; for (auto& wmoReady : pending->wmoModels) { if (wmoRenderer->loadModel(wmoReady.model, wmoReady.modelId)) { uint32_t wmoInstId = wmoRenderer->createInstance(wmoReady.modelId, wmoReady.position, wmoReady.rotation); if (wmoInstId) { wmoInstanceIds.push_back(wmoInstId); loadedWMOs++; + + // Load WMO liquids (canals, pools, etc.) + if (waterRenderer) { + // Compute the same model matrix as WMORenderer uses + glm::mat4 modelMatrix = glm::mat4(1.0f); + modelMatrix = glm::translate(modelMatrix, wmoReady.position); + modelMatrix = glm::rotate(modelMatrix, wmoReady.rotation.z, glm::vec3(0.0f, 0.0f, 1.0f)); + modelMatrix = glm::rotate(modelMatrix, wmoReady.rotation.y, glm::vec3(0.0f, 1.0f, 0.0f)); + modelMatrix = glm::rotate(modelMatrix, wmoReady.rotation.x, glm::vec3(1.0f, 0.0f, 0.0f)); + + // Load liquids from each WMO group + for (const auto& group : wmoReady.model.groups) { + if (group.liquid.hasLiquid()) { + waterRenderer->loadFromWMO(group.liquid, modelMatrix, wmoInstId); + loadedLiquids++; + } + } + } } } } + if (loadedLiquids > 0) { + LOG_INFO(" Loaded WMO liquids for tile [", x, ",", y, "]: ", loadedLiquids); + } // Upload WMO doodad M2 models if (m2Renderer) { @@ -608,9 +630,13 @@ void TerrainManager::unloadTile(int x, int y) { LOG_DEBUG(" Removed ", tile->m2InstanceIds.size(), " M2 instances"); } - // Remove WMO instances + // Remove WMO instances and their liquids if (wmoRenderer) { for (uint32_t id : tile->wmoInstanceIds) { + // Remove WMO liquids associated with this instance + if (waterRenderer) { + waterRenderer->removeWMO(id); + } wmoRenderer->removeInstance(id); } LOG_DEBUG(" Removed ", tile->wmoInstanceIds.size(), " WMO instances"); diff --git a/src/rendering/water_renderer.cpp b/src/rendering/water_renderer.cpp index 9a9c43ce..09832531 100644 --- a/src/rendering/water_renderer.cpp +++ b/src/rendering/water_renderer.cpp @@ -2,6 +2,7 @@ #include "rendering/shader.hpp" #include "rendering/camera.hpp" #include "pipeline/adt_loader.hpp" +#include "pipeline/wmo_loader.hpp" #include "core/logger.hpp" #include #include @@ -209,6 +210,16 @@ void WaterRenderer::removeTile(int tileX, int tileY) { } } +void WaterRenderer::loadFromWMO([[maybe_unused]] const pipeline::WMOLiquid& liquid, + [[maybe_unused]] const glm::mat4& modelMatrix, + [[maybe_unused]] uint32_t wmoId) { + // WMO liquid rendering not yet implemented +} + +void WaterRenderer::removeWMO([[maybe_unused]] uint32_t wmoId) { + // WMO liquid rendering not yet implemented +} + void WaterRenderer::clear() { for (auto& surface : surfaces) { destroyWaterMesh(surface); diff --git a/src/rendering/wmo_renderer.cpp b/src/rendering/wmo_renderer.cpp index 78621086..e87fc765 100644 --- a/src/rendering/wmo_renderer.cpp +++ b/src/rendering/wmo_renderer.cpp @@ -620,6 +620,9 @@ void WMORenderer::WMOInstance::updateModelMatrix() { modelMatrix = glm::rotate(modelMatrix, rotation.x, glm::vec3(1.0f, 0.0f, 0.0f)); modelMatrix = glm::scale(modelMatrix, glm::vec3(scale)); + + // Cache inverse for collision detection + invModelMatrix = glm::inverse(modelMatrix); } GLuint WMORenderer::loadTexture(const std::string& path) { @@ -728,10 +731,9 @@ std::optional WMORenderer::getFloorHeight(float glX, float glY, float glZ const ModelData& model = it->second; - // Transform ray into model-local space - glm::mat4 invModel = glm::inverse(instance.modelMatrix); - glm::vec3 localOrigin = glm::vec3(invModel * glm::vec4(worldOrigin, 1.0f)); - glm::vec3 localDir = glm::normalize(glm::vec3(invModel * glm::vec4(worldDir, 0.0f))); + // Use cached inverse matrix + glm::vec3 localOrigin = glm::vec3(instance.invModelMatrix * glm::vec4(worldOrigin, 1.0f)); + glm::vec3 localDir = glm::normalize(glm::vec3(instance.invModelMatrix * glm::vec4(worldDir, 0.0f))); for (const auto& group : model.groups) { // Quick bounding box check: does the ray intersect this group's AABB? @@ -785,10 +787,9 @@ bool WMORenderer::checkWallCollision(const glm::vec3& from, const glm::vec3& to, if (it == loadedModels.end()) continue; const ModelData& model = it->second; - glm::mat4 invModel = glm::inverse(instance.modelMatrix); - // Transform positions into local space - glm::vec3 localTo = glm::vec3(invModel * glm::vec4(to, 1.0f)); + // Transform positions into local space using cached inverse + glm::vec3 localTo = glm::vec3(instance.invModelMatrix * glm::vec4(to, 1.0f)); for (const auto& group : model.groups) { // Quick bounding box check @@ -865,8 +866,7 @@ bool WMORenderer::isInsideWMO(float glX, float glY, float glZ, uint32_t* outMode if (it == loadedModels.end()) continue; const ModelData& model = it->second; - glm::mat4 invModel = glm::inverse(instance.modelMatrix); - glm::vec3 localPos = glm::vec3(invModel * glm::vec4(glX, glY, glZ, 1.0f)); + glm::vec3 localPos = glm::vec3(instance.invModelMatrix * glm::vec4(glX, glY, glZ, 1.0f)); // Check if inside any group's bounding box for (const auto& group : model.groups) { @@ -890,10 +890,9 @@ float WMORenderer::raycastBoundingBoxes(const glm::vec3& origin, const glm::vec3 const ModelData& model = it->second; - // Transform ray into local space - glm::mat4 invModel = glm::inverse(instance.modelMatrix); - glm::vec3 localOrigin = glm::vec3(invModel * glm::vec4(origin, 1.0f)); - glm::vec3 localDir = glm::normalize(glm::vec3(invModel * glm::vec4(direction, 0.0f))); + // Use cached inverse matrix + glm::vec3 localOrigin = glm::vec3(instance.invModelMatrix * glm::vec4(origin, 1.0f)); + glm::vec3 localDir = glm::normalize(glm::vec3(instance.invModelMatrix * glm::vec4(direction, 0.0f))); for (const auto& group : model.groups) { // Ray-AABB intersection (slab method)