From 72627abf78f8006e74951fc69aa4f3bdc54eefd9 Mon Sep 17 00:00:00 2001 From: papadanku Date: Sun, 6 Oct 2024 07:29:04 +0000 Subject: [PATCH] deploy: f82318c4d92ce27697003d146c52f4009f91c3d6 --- .buildinfo | 4 + .doctrees/environment.pickle | Bin 0 -> 52030 bytes .doctrees/index.doctree | Bin 0 -> 3526 bytes .doctrees/source/blog/autoexposure.doctree | Bin 0 -> 11833 bytes .doctrees/source/blog/censustransform.doctree | Bin 0 -> 7327 bytes .doctrees/source/blog/chromaticity.doctree | Bin 0 -> 14411 bytes .../source/blog/coordinatespaces.doctree | Bin 0 -> 9540 bytes .doctrees/source/blog/cpp.doctree | Bin 0 -> 34726 bytes .doctrees/source/blog/gaussianblur.doctree | Bin 0 -> 7165 bytes .doctrees/source/blog/logdepth.doctree | Bin 0 -> 7260 bytes .doctrees/source/blog/loops.doctree | Bin 0 -> 13372 bytes .doctrees/source/blog/opticalflow.doctree | Bin 0 -> 18890 bytes .doctrees/source/blog/outerralogdepth.doctree | Bin 0 -> 5618 bytes .doctrees/source/blog/pythonengine.doctree | Bin 0 -> 11452 bytes .doctrees/source/blog/reshadefx.doctree | Bin 0 -> 12976 bytes .doctrees/source/blog/shadermodel3.doctree | Bin 0 -> 17231 bytes .doctrees/source/blog/sobel.doctree | Bin 0 -> 4402 bytes .doctrees/source/social/instagram.doctree | Bin 0 -> 6942 bytes .doctrees/source/social/project.doctree | Bin 0 -> 9868 bytes .doctrees/source/social/youtube.doctree | Bin 0 -> 18224 bytes .nojekyll | 0 .../Video Templates (Project Reality).drp | Bin 0 -> 53515 bytes _sources/index.rst.txt | 19 + _sources/source/blog/autoexposure.rst.txt | 109 +++ _sources/source/blog/censustransform.rst.txt | 48 + _sources/source/blog/chromaticity.rst.txt | 100 ++ _sources/source/blog/coordinatespaces.rst.txt | 31 + _sources/source/blog/cpp.rst.txt | 750 ++++++++++++++ _sources/source/blog/gaussianblur.rst.txt | 46 + _sources/source/blog/logdepth.rst.txt | 66 ++ _sources/source/blog/loops.rst.txt | 36 + _sources/source/blog/opticalflow.rst.txt | 223 +++++ _sources/source/blog/outerralogdepth.rst.txt | 18 + _sources/source/blog/pythonengine.rst.txt | 58 ++ _sources/source/blog/reshadefx.rst.txt | 125 +++ _sources/source/blog/shadermodel3.rst.txt | 119 +++ _sources/source/blog/sobel.rst.txt | 28 + _sources/source/social/instagram.rst.txt | 38 + _sources/source/social/project.rst.txt | 34 + _sources/source/social/youtube.rst.txt | 101 ++ _static/alabaster.css | 668 +++++++++++++ _static/basic.css | 925 ++++++++++++++++++ _static/custom.css | 1 + _static/doctools.js | 156 +++ _static/documentation_options.js | 13 + _static/file.png | Bin 0 -> 286 bytes _static/github-banner.svg | 5 + _static/language_data.js | 199 ++++ _static/minus.png | Bin 0 -> 90 bytes _static/plus.png | Bin 0 -> 90 bytes _static/pygments.css | 84 ++ _static/searchtools.js | 620 ++++++++++++ _static/sphinx_highlight.js | 154 +++ genindex.html | 128 +++ index.html | 163 +++ objects.inv | 6 + search.html | 146 +++ searchindex.js | 1 + source/blog/autoexposure.html | 262 +++++ source/blog/censustransform.html | 183 ++++ source/blog/chromaticity.html | 247 +++++ source/blog/coordinatespaces.html | 183 ++++ source/blog/cpp.html | 866 ++++++++++++++++ source/blog/gaussianblur.html | 182 ++++ source/blog/logdepth.html | 201 ++++ source/blog/loops.html | 223 +++++ source/blog/opticalflow.html | 356 +++++++ source/blog/outerralogdepth.html | 153 +++ source/blog/pythonengine.html | 194 ++++ source/blog/reshadefx.html | 262 +++++ source/blog/shadermodel3.html | 267 +++++ source/blog/sobel.html | 158 +++ source/social/instagram.html | 179 ++++ source/social/project.html | 178 ++++ source/social/youtube.html | 254 +++++ 75 files changed, 9570 insertions(+) create mode 100644 .buildinfo create mode 100644 .doctrees/environment.pickle create mode 100644 .doctrees/index.doctree create mode 100644 .doctrees/source/blog/autoexposure.doctree create mode 100644 .doctrees/source/blog/censustransform.doctree create mode 100644 .doctrees/source/blog/chromaticity.doctree create mode 100644 .doctrees/source/blog/coordinatespaces.doctree create mode 100644 .doctrees/source/blog/cpp.doctree create mode 100644 .doctrees/source/blog/gaussianblur.doctree create mode 100644 .doctrees/source/blog/logdepth.doctree create mode 100644 .doctrees/source/blog/loops.doctree create mode 100644 .doctrees/source/blog/opticalflow.doctree create mode 100644 .doctrees/source/blog/outerralogdepth.doctree create mode 100644 .doctrees/source/blog/pythonengine.doctree create mode 100644 .doctrees/source/blog/reshadefx.doctree create mode 100644 .doctrees/source/blog/shadermodel3.doctree create mode 100644 .doctrees/source/blog/sobel.doctree create mode 100644 .doctrees/source/social/instagram.doctree create mode 100644 .doctrees/source/social/project.doctree create mode 100644 .doctrees/source/social/youtube.doctree create mode 100644 .nojekyll create mode 100644 _downloads/af96786462247ba26af205370a7ad1b0/Video Templates (Project Reality).drp create mode 100644 _sources/index.rst.txt create mode 100644 _sources/source/blog/autoexposure.rst.txt create mode 100644 _sources/source/blog/censustransform.rst.txt create mode 100644 _sources/source/blog/chromaticity.rst.txt create mode 100644 _sources/source/blog/coordinatespaces.rst.txt create mode 100644 _sources/source/blog/cpp.rst.txt create mode 100644 _sources/source/blog/gaussianblur.rst.txt create mode 100644 _sources/source/blog/logdepth.rst.txt create mode 100644 _sources/source/blog/loops.rst.txt create mode 100644 _sources/source/blog/opticalflow.rst.txt create mode 100644 _sources/source/blog/outerralogdepth.rst.txt create mode 100644 _sources/source/blog/pythonengine.rst.txt create mode 100644 _sources/source/blog/reshadefx.rst.txt create mode 100644 _sources/source/blog/shadermodel3.rst.txt create mode 100644 _sources/source/blog/sobel.rst.txt create mode 100644 _sources/source/social/instagram.rst.txt create mode 100644 _sources/source/social/project.rst.txt create mode 100644 _sources/source/social/youtube.rst.txt create mode 100644 _static/alabaster.css create mode 100644 _static/basic.css create mode 100644 _static/custom.css create mode 100644 _static/doctools.js create mode 100644 _static/documentation_options.js create mode 100644 _static/file.png create mode 100644 _static/github-banner.svg create mode 100644 _static/language_data.js create mode 100644 _static/minus.png create mode 100644 _static/plus.png create mode 100644 _static/pygments.css create mode 100644 _static/searchtools.js create mode 100644 _static/sphinx_highlight.js create mode 100644 genindex.html create mode 100644 index.html create mode 100644 objects.inv create mode 100644 search.html create mode 100644 searchindex.js create mode 100644 source/blog/autoexposure.html create mode 100644 source/blog/censustransform.html create mode 100644 source/blog/chromaticity.html create mode 100644 source/blog/coordinatespaces.html create mode 100644 source/blog/cpp.html create mode 100644 source/blog/gaussianblur.html create mode 100644 source/blog/logdepth.html create mode 100644 source/blog/loops.html create mode 100644 source/blog/opticalflow.html create mode 100644 source/blog/outerralogdepth.html create mode 100644 source/blog/pythonengine.html create mode 100644 source/blog/reshadefx.html create mode 100644 source/blog/shadermodel3.html create mode 100644 source/blog/sobel.html create mode 100644 source/social/instagram.html create mode 100644 source/social/project.html create mode 100644 source/social/youtube.html diff --git a/.buildinfo b/.buildinfo new file mode 100644 index 0000000..9de0c0d --- /dev/null +++ b/.buildinfo @@ -0,0 +1,4 @@ +# Sphinx build info version 1 +# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done. +config: af8944bf982a86054c862fa67e487b75 +tags: 645f666f9bcd5a90fca523b33c5a78b7 diff --git a/.doctrees/environment.pickle b/.doctrees/environment.pickle new file mode 100644 index 0000000000000000000000000000000000000000..7bee0ae398dc3bb1c599f598c38fe015d069d008 GIT binary patch literal 52030 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 Hllp%F!&xvD literal 0 HcmV?d00001 diff --git a/.doctrees/source/blog/censustransform.doctree b/.doctrees/source/blog/censustransform.doctree new file mode 100644 index 0000000000000000000000000000000000000000..010d53491eda596bf9035b12ed02c2801eacc964 GIT binary patch literal 7327 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 literal 0 HcmV?d00001 diff --git a/.doctrees/source/blog/chromaticity.doctree b/.doctrees/source/blog/chromaticity.doctree new file mode 100644 index 0000000000000000000000000000000000000000..c49f1fdc88c6a775b50c88d58cdade81d44549c1 GIT binary patch literal 14411 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 A*Z=?k literal 0 HcmV?d00001 diff --git a/.doctrees/source/blog/gaussianblur.doctree b/.doctrees/source/blog/gaussianblur.doctree new file mode 100644 index 0000000000000000000000000000000000000000..b45e80f1ac9741a265c1d5a1733e694c80794e30 GIT binary patch literal 7165 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 literal 0 HcmV?d00001 diff --git a/.doctrees/source/blog/loops.doctree b/.doctrees/source/blog/loops.doctree new file mode 100644 index 0000000000000000000000000000000000000000..e6044eae6c4e5ea16ebd9d45884ff8d0216ba1a6 GIT binary patch literal 13372 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 literal 0 HcmV?d00001 diff --git a/.doctrees/source/blog/outerralogdepth.doctree b/.doctrees/source/blog/outerralogdepth.doctree new file mode 100644 index 0000000000000000000000000000000000000000..b3d7e1db4c4b1bfd7ca97cfa75a0122cd4c06d34 GIT binary patch literal 5618 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 literal 0 HcmV?d00001 diff --git a/.doctrees/source/blog/sobel.doctree b/.doctrees/source/blog/sobel.doctree new file mode 100644 index 0000000000000000000000000000000000000000..4bc4d3663a4e8747c2b192eb5f6223cd49d7d631 GIT binary patch literal 4402 zcmeHK-)|hZ5tc2Vq&xj~;-EmRbb})GDc0Quh64mK3^bO})^Mr@RZ#RLSa5fFN9MTX zhD%zf76RIb01?2qY+w3E^l$9P~Ll{^UZMP@4bIM+Fz;v+-_Mg zE*E2xWm09dtlUPXQkzq0s_(1Ae^eLM(DgMrE0xtLt=tMYQpQE5sjR-L+>U2AT$JPH z{CY`K!t9tv)^|O_ji5`PT=aqqE-BH`sYcPd~5x zSscChC0%%%ZgJwUpeNH)Q5NRcx2N%eL44d4APPCPh z>dBeX^GQJpk`Xz#;~6*1CS$JtCk>`gg2j_Ws2SGq)L56e*?X^7Z36G~aaA(Yq+rX= z{r8uQHh!JfevLH!#&S)|=v>*zsHh})A!zhTRPY5AWkj^HGK&n(rEne9;lnuck{TJj zj6%qcqEgj@QX>CL62kX1GKiVgI7v;)pfx!Ud?CK0gqkx-Wutr?Lj8{We>1zm8-hIv z!9HQ{c}THe0!Qq9!1q`9eSqI1{0@N;_Lz;>0XstcdM!o}$IXy%R~fU{65Qr#oq*9X zvb6QnHQJRCzq!2;9-z+ydu_}{4W@0u5qTnFpe>y*0qQTScUM+Qqit#etOkD@L{T&q zikPR-tHrbB-TAY@#k0X6r1kHpsTaclIAnVbyjMAy(W4;XNrVjV)?au$p7Oua!=NLG z`J*+3HOp!~i=KOwJ$X62CJ~~d$I-C1?8$KS(fH$|=rR5uMju93q7RoPy||4eFXJaA z9p6S$u*v`b5u0A#MpCfpha?4;jbAMwYWM<9d3hL(qTy#)9f$k39Os_H(_hpa$2D*5 zAx)9RGHShl(E#vgIQ$F;B;!RDY7c737v+ysJ=b64;?uGqzK_@_@Cs4=hStUKq$!45 zZ9TFH?W(8S43FO^^|g<*#k3_y4SA`y4%(X9h(%dj5*H;+%Q31S(ouNU@Fb1695GRf zB^@0vo;u&2biBSjX?SlaUR|oEc$|Ou73kU!cI4hRn#fWR-#NvFRx@}fv>`pC3=!4q z6*p*kXojuzkH{UjlUnVYoVaUgwpvPPZQMpljlu2E+wFJF+EgpN?lP;~+MkKA=xMrc zZ%x%jwmMwpw7f zZB!cjHpzd5DLvS%&ntI-3Nca{y7ciox9yuqY4dn7RXVS}b31r-coC;6_pNCOf$s(i z6||%TUy{wM_J%0fJuVnC#s8e%W5IM7W znBi_DoV$xo-@T=2s&p1-v;b_Nh66JvZY@=EiaWv`JZsUw*4z%UM#Wbocb5Ze+nLRa zxWgm7S`)Z$G$j#U;BHN+k?uo(MJh^aGZmwRfNPH~3RTj0`D6`|)WmOi$pc<@}{PP^4&DJ8a8S5(3+OUbtT{V~XTctPKEXY$zIaq@S;xv>1Kx(Np+yM^Dom;yvX`{I6T_$Xw#_I;VQfshQR~{9M6I zE}*P$NP-l~469ymxB~z(kGst5E)a*}ed+efb7{yTW_-p3egN-1p*-%l%A6p}zOhK@ z5{`PS-iK|Bc9Jx%JxCcQmK1>x$p$aiF2w1%Evn0Uu&k%WrUqOBJu2mL3Jf$w;l8gD zrA=d?F zv`e>2|qbN-n6Zc^hkYz9!qnu}cFuXviyG9MeBgl|8 z?KW$^o?`9TGn>T z5r1zCLF~Bu*Ch5^t@WY%*W{znYEvO|9^91G ze8GE%@{wX31xE0=q)G_58F#?zv3}gpzlRsTt^R~mzyOS-!gO9D`axk=MXr%IJ8~Vs ZO)gVmGY^=VkKG{ig|4Xy{wc>?{vZ2*M)3du literal 0 HcmV?d00001 diff --git a/.doctrees/source/social/instagram.doctree b/.doctrees/source/social/instagram.doctree new file mode 100644 index 0000000000000000000000000000000000000000..3a1a904f00fc15ef5a938f9cf965f832f15980a7 GIT binary patch literal 6942 zcmd5>&5Inz72lP#A2a*CmW=h~w7+Gd-Ib#Rf&vaACPZv9QXJdl%QQ9JHB&X))7|Q- z*6tn*^1(zKDqpw*MnqsROPMMyNFF zCv2Dz5ok`m#rJ6Q=F|sSF3D`nu&>UT^UFyzVBZj|h7#Vlq%3wP4ZzSJV^Zp!GfV-S5Sml*#%$$~9enqf0h(C^vplWA8h zs+N-k$dJWJLPUxEq5b0B^JpO^4?1)o=;p7^p= zYa=HYm$CWm(VH*6$#17J;p8T&lwfqQ7UTM4V!YlEqXjWqW`&1v$b@O`yMcstO2@42 z(lRZYai!+N#N#3)$4fZVQBt~F3ob?e7mLP1@x#KbM=_{X{OR#k z{IR%bExdpOdgn>U@>YZR`?Lq_@pk0`=Wars#DTx>DCd&wIdP<0YRcCOq{D$=uu zl9s1;1Vycs%H{r>m|MG@_joZN1_@;`+Br;~~Cup!1e#JE-ZZ<#=9-*-BZ zQ)LdPCj-qB`(p?Ye=7j}kbOzH(hV z0cT1(uQ>_C6R8ZEkDsiq`1#~kd>V%N5B#BJ7P@H= zaD7X5hVtm5$6X>Sb1DuAo{kYZzi`# zl&X$(T&tIBts#fdL7gFmi#C&lAwTS)^wXPHbPUesef83goLFuX!udB`V%`arG zb5Q>q6PSzWb92?%xtWcrR5i0XCXm}VD7O#hNwmD6f)^2R4qr@lZdp(f%8KxF_yX|@ z@k{Y56`cAF;B&rtIEKvg_jhXq_;F+70= zBWi>vr0UjNd>98Po2wGNF;XAz{zS)%a$#_%T45`Oi$_-st8d3a#C+sr=f;rrYiS;x zsD=7@wZ(BF4+-_NYK0Zbu`zThz>Oebf!hrtZ>LeKI z?mH|{1Yc7L#6v7l%Nb?C+iFr((;cR0*>!n6eos@EB_#`h$w zsF_YxNi<_-eBMp_kbilXB_XT`3N#sp7-``+JWeW+d@_X1Tom*Xg+p|>Qr+A5`i7Et zzA!rJ@+658SD-Wvc!CokQ9YfRmE7_TE;E)(W-gA+jIkK}8+bFzIp11_a`lDLiLu3I zm2`mbDFG7&7R^fm3;QV|IxOx3-6zlyG*2bmixS`UdCWr}+eo-g$IK$6_Mj##BK^`K za9LkwsgB%w$efUHw3y9&09kI?%r(X}nil=_$BIe}MHFsENgs$hLzGqkP`YJIqhQP9jhC)`74}?Cdfpg&8mZa8T(Spv z8M*8ZPc|jjJ-Y{WD}^2g*sP^l7bxf^$-_I;fHw1aGy#0!i8A!jF@@i0mh?GlJ^0NUgo0;j zG|&;zeQGzqhiEr4nzy7e3~s&ZWtKuJy4e_?qrv?7(%{d)_~1{JSU(mI#u`|ifuh-% zzCNX|hxGMF`uYRDQqv+%)L64g#qv53A0G_1PE1W5*u@8S;elOrkc#KfQqFf<6c5l7 z%f#!Jz4&Ax!BITSx1f5_ZefeG)GReU#_F)-N%$QZ0ea;l6c|dn+*r+#oDL?0hYhwRyowp5T7)gzgQxhs;6=Et+h0DAL+8Fl zy?Km(h!Yxo4*j>M)d$&|fFjz>05yJdP_`CE559%OwXXo&apr{tyXMNz?mpPe>U#VKaDhoW0p|y|u;Qq~ z#(D@dGexSMHmCBI?x`D{Z{MVRm;c~|_?!Qtv%O9iz7EMTdJRLTkeT%=6O=}@XSz@g cTM#awN)J*W0XXUt{@Okzt0JzGdicfWzkzl2mH+?% literal 0 HcmV?d00001 diff --git a/.doctrees/source/social/project.doctree b/.doctrees/source/social/project.doctree new file mode 100644 index 0000000000000000000000000000000000000000..67e5bf6373183db2fc11b39477bd9f922c9942a9 GIT binary patch literal 9868 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 literal 0 HcmV?d00001 diff --git a/.doctrees/source/social/youtube.doctree b/.doctrees/source/social/youtube.doctree new file mode 100644 index 0000000000000000000000000000000000000000..6a3c8fad1a44323bbebbbccc401e64ca36fead79 GIT binary patch literal 18224 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 literal 0 HcmV?d00001 diff --git a/.nojekyll b/.nojekyll new file mode 100644 index 0000000..e69de29 diff --git a/_downloads/af96786462247ba26af205370a7ad1b0/Video Templates (Project Reality).drp b/_downloads/af96786462247ba26af205370a7ad1b0/Video Templates (Project Reality).drp new file mode 100644 index 0000000000000000000000000000000000000000..e75781d8e04590d8e4e3faf8ed82b6fb462ee0f9 GIT binary patch literal 53515 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�}wJ#ny8rz@MUJx zaT6@jb?-oxYjACsGxOd`Hh#AR$M(^MBu?V8BAhLy6gTTG=@|*tzm%jua-dsNjV+&J zHUwF9Nt#KgqkzbNVRj8jjUHbKq(MAVVFt6dyomt5&#)t1)#W zfU6e8f|fFr#+3FA-UMb5OM==#v*_f(uOQM#Ybl6rWyCcdG~V<5J5 zn@GdPl5=2QcVV;Ed;GkeZLT1w?f z7#m@!n{dH3Y;{Y9dP*5wAPNwb0(MY6xHAAGs61b%7P^cSR2CguqG$IM`FNGD$Hzm zYJ%Gt&o_uDy(qmdlp^+vYNT{hxT#a<#<;X8cZeN0+6O?FDmNb1)@WfabF^Wp6wHpA zn4Xo0rXY|!zMEt>SKx`)kqcz9%jNTzWG*w-hx{e%-sVCWjO=FP#C_2;iy{(^T9f2m zJR%WB$EKCmLFJgp-%nyjFvqEf;wTmqoe(8-FSbCGE4Lc>E&mzm7=k0CL@Wy9%(<_c zUvIbYV@XcNO;#q~Y)Xmu5~~>k55g!B$2%~Ei_8$8PzP5M0Cr)fphV8imZ?zKZlet0 zRIlo#rp6oXy+H1y9oUQnt-Otf2?YyJF&$ls`U2#tRi5C^I)gTXvXZ-9{$8%tj0M?P zwSZes^AA{Ktwxg({dqBc*IM4J(Z=N?6g_6l-VN-P3{ z#OFYXp8L)am=%Jml(-gyn?bHtzDdc|jOPmA*evT3pfsuH>0wD5V;dm6VbS3Aaa$%- zgsAX!B7EntanmFUq*A5!szoBgR@IhXl27QOz9Nc5hzj*CE&v5J~u;KbRU7GN4SkalK^?2hhN{7olCT)QY~XL%z}texNw03Zgtx zfOOy`823DEX}YB+mkAgZ!7N=7A;0iYYZ9@rG89$^1rf#^Fp)*M@DK0?S`T2z#f0}r z)vgv5vQiO*z+zh&a^cj}r@IohE#dP@VqR2&;K{zJU1IP^&>G5yqCtg zAr9IRVv7qFuDC5^@yyMnK%R7UMGuKjvgo3iSI$+K#%^qxihaj$?&w5dBw3LDpg@+w z^+Ii%0-r#Y?~;|ls!Ck=qRUV?!B*33iC+V{|6EFhu*tWw^k9Q!pb5Ywn+s^2A~*(> z3#D!G)4;sAn2^z$5HBt&>y>{{7>A2)$!v_*6Hfa$gqA0=x!A4LHlxV#ilm1YtyJ2JV z(6=oIu^rEia8kHz@|T(38bXBw^o693HVwqcg&VC%>Hw;I6rd97Ix;JTR;YI(A2|!r z^;kIHkh-?-nq)3SWJ9vy3_@X;rMipd*r9)TP^g15i_p1NlcFfu^yDCJK)DdBDJc&0 z6%5~yuQigI`J{wgr{hiQtf1dH)Fd>6so08f2$54V*^$)H1*ZXOjC6Wa$vTTI?cU@Q zQ>k72JT0cIRn}ZQEO_%^^s2~YGGYp+Q3IL9C;O-(ojkWod)PNdWtJ_@`2FRhf1`k4 z;n>lVBNu_D%~sxU;LeKel^}ZKGL>|fe1`_1VaslaA4pi#TWSIkq?+d(S#Hu zh3J)FhmyXqgCUX({yE;>3}C06K>1`OZa>xoG{ZnoDch3FQFRoj*ad;fEbtVD3M&@1 zjdvLTq$n0@ba^iQcSYL3jh+#5PCp^3 zD{zf-%hG3Id(a?uE)K496vC+?(w%G@h4wEbFg~%_puxk~eoF@sv?L8u@H&bnX_4JG zS2Rhe8<=F}Xu(ggzY(jIMzfmZdrZU?LgRrW`>IXPvINtXa*DDBP+;P^5Wn{LbT+M& z-q~-TgWz=;B=o4rZ|OsHV}zoeCTL{=3!*+zrr7n>P{EOf#Ei#izsGEzj*7^_*@o#c z^_jxq8xFvMP&ge~It(;1eub)8`Z%vj#Y7W^3-Ip?b{CUmumQrzXrlS0)-F|mq;aQ4|ykh}+cST+<<%kV2I%q8Xv?u~ zn4u4`TK{cQE`mpxCLw!e!%C(ITT1K`z4-)E7?t!y>68=r=Lp1p8ijS9#a7~SiZQ)} zZgIMtvq2YUSzF(B11xp&ZOImCPc&i|j8*QMz%3yo0})GK!3}>?y)Yt2T+}Jq^y!L- zb$x>a26iw_T8i$e4K@6k48)jWH8a$)JLS!@YnCqP=X z(tRh@BCL$?s?>b9qIG4vF9rJS%in>81d~P;i;j4`Z2fWsaa(L3ik*)@hK+7hMFx6^ zGJ4SqI-v}N(lAM}{Ihc!$8K&u@ZRer^E0jnmzxTum_U8w%^^n*9Hv!s--BmT)a8#9 zTsrZQez8ZxiGvCRB#Q2#$Rf#`4kRP~QdQ=ogAyzmm4iLd3?G4hFIA|t1>gh@{Y{=| zR+S`NhRBZY3ECP#oH&s^bWTX*^Tz&RS_UJ^A;Br9U$P^Ywpz&Y+fJ}LIdsC@X^Jf( zDINU2G@pVdYHl!~xCa8X1dPQ~N|u=!Xp(Mi1$ny+h=rDK#6>YTM!xCHe8 z!0`eUa#Fripz=l@X+lQcbNx?e*BR8*wuLEzfD{qA6cJPek$oZ)oVDLD{ zQTIz<+AFfOhhv2DLa32|xbQW~mw+PCOHx@NC+g=u6vXPzDX#>6MKw8~BKkC9naJ&| zTJILqcU@IGB|=V8M<1X*a8fvO7ld+$N@*x@Kh8F{P`eeNhN-{n@AiN`??bET^WxSo zKh;XbNUps@7Ivou0i}a@c$||cGba~ejhlBdq{el(0W)jLv@50(eTaQk9jv0taP2fjkssn?$3)9u=6*yT0SpT3$)M#a^mGU5 zHn0vpq2JoR#Gc@jwWee&&W;8R?$^)i^GFEN2CEj{ zrF&BQ`o5nRQi3DGdCMGv>A9Ga`&HOs%%FOe>@j6tI+eBT%IXX(R*Q1lseV>4hj)ntv%b^e8#@7{vUV$0#6MqBmP{?yRR5DYGoW^O=c%_JQr zJ(s%q+^6acURS!k(6F`nRmOYo8E{g9uiSGv0}ZC7^{bU<*%~<5{q!y7&^F_A^H)vG zP>Z<)sig4>g@*YqaSjZkP43%*wn)zSFSR)V&O>oU?_E)^A9L(50>!>Wp+f9X3)6wy zB-3>LySjjr@haTnLb6!QE8#7cr>2|ljUpwCh;MQvyz6Y5coYJg1 zgRKI>P0H8LmjS*IS5KN=lU^)$mA@9M3SE`K(lwDLKV#liWA@Bq)&P6QC8J?y)7(G6 zZ+ya+s{sA%5r*Rs5zx36W?Q+#MTb_#zE7^^Doc3cm+W&HeoI)jGck8P_pp3>r8zk< z60duR5%d#GM)RG;rz^C+sC?l6+s%MS268Dsj&X#4p;#PrA+wSn#5su}_-@|hgs|v`1KH6(c{{ZN z^Q@?(JiXfkv*HN0|Ar4+>$kK%mUGE0;PM?1p>mqeYLtfZQmSwnc7b9nk@1_9KjfLB=6 z=0~9B#Z+gVI}eFCqu(Vt=0?Oz6eU-Z_3)J+rXXDy&U4C|_q+O!>6f@@e@!5Qol+1I zuXb~qB``|;I7YL?`1~76iv72Z%J@#=mhT-|U3HmSfP)_t*+t1>97&i1gh9RNyufy6O~*Mf3Z^+j_U|bbTTnZ3i9-Em>J7Y6CMJRL@&Nb?Ii0+1(U0 zh4to=A~$zO2FI#heB@@}hYKa$j)>USYN#Hq8Q+ylxRTwW-7$F`(XA$IkQ}bC(i^BL zHzH9eQ8I^x&RHTGpzrK^`bmqJ*Su&+Pm^>8ohN%eKM|LBa>RmvW;}Th*NuY!((Tt{ z=$C~?)Z7F&=_{GgFfJ9Ldv>| z*Ze`Ow^xM6EK@Xmd^79t#YWKa?C^27Pc@#~#R5TwZ;wgm8qq*tWamqxSAkw9+PS@$?rrdh8%<62T ze_bDs~`RxYpJ`SOc$wMP;2g{*R$VK5INQ}0lU3>^5bnDYJrmmcFz2Ko{z^>PeBX~4sLhdi6km; zRLp37OI}H6C5zi%9;xyM$;taZvq$Z$8M3e0g5^&4OG*^x{YZD#)~6$v%ZcWaED0wv zb0J2&7C4tyb=81p#|5Vq$J4G~EQpIX>b+Z1hLGv$ZVDUeynA)UL^lSLZs;G%CRXO$w-`ExoS|W@oPahrhOEYXp0DsjuO*M#%sW zP9s{f*ETPWnlB>-q}@s?%PgTBLYY7QLI`@EK$+wDZEl&DjK{`Yo~xbRe!DmBg-@OC z>t@?mk8l6jBFK~*;U(Jk!lDeLhaO(78aA$DJWbrguleSFrhdUgOer}<{%M&c6L9Rr zDJ5)z{EFE4(Px9~GrRtlr9He;LaEoqz8^iM%gw9H&f zAX8Dq((d$(MPI?Ndp9!oH-9|-)WWuxdBvV_E$vL!ZLjOm#_$ z--JzR?DN>te93F0*Vzw0PQI@GZq@j8orlmWPP$5)R?0WeyIz>2swAU?bNT77G0^VU{*Y8$P7?O*_5Ihhi%pyUk>3$sUj` z0h*)@x?_ujHvi*UTm0%Qvao(rXuF_!kkF>_4pizj^W&wgAgJ%RMc=6|+j=ASnz`l0 z_N%G$gZS?&YEJN63zo_cY_N?1Y?i&f9^c&kTKlj#wahondZOGFF@s02I@mZ{cY9W;^V@a^)R7lu56>_+Av7^Q0DXx$6Rji{Y=>9d9;WHmI8>glI~6Mi{d(Bsf{SRU0{`QIWby9 zpC6qx3McbyeK%xd^}dRX`?-lv%MfYTl6-ue_xJ`8K> z{6IQ5A)u;8T|=@dz$M;wp)=UpYvzpE7WC81)1I)Q8s+`55G@%iYMGw35;f8=o2%=E z7A^LOPVA|56{=)-CH1lBZEjCT&zfvdTuK&16{>3rL?s&~-sN+0{LDQelW&S<+K#_2 z{)6;-EXiW^i1JkLjKk+)gYnK52__lMwXR1+Pw2|H?mM?kvVjo(F)ok6k>d8#Yz-g- zxzE%ZED52mB`ZNzWySUvn=n>tl5SIE69$R9TBVZPU1YMTqy!kBnk*=qii5(bO-oF` z05#&sOZlnlT$(VCIpTMjNgfH`-N{v^P?On8Dj);qc3am_{bupq%--HJoALxMW%cDc zHb61*RZw8D)pyp6w@@eu`IlWPa$EyaLkk5NFrpkJCl^6N`G+3~UxHjLMCH>@G7zDo zh%Ng8rsyRAa)_!S@+w7ISXcVW21RFo@Zr#OWB}1c&A{(2NneMUgq`#{5d~qW-@R>W zGF8E#El5O^;QWufB6ut!V!~AybaCenb91)0g3%aaoh#(!G-)|>TS&b$%63bYJV@A_%}pC(H{{1 zYt7xC5Wj~6|Av@G{Q>d6R%84L@%xLsh%GMUpN+EV`&Xo)uR}%%L5PUR31fvYgKp&F F=|45v{#gJ3 literal 0 HcmV?d00001 diff --git a/_sources/index.rst.txt b/_sources/index.rst.txt new file mode 100644 index 0000000..db6f755 --- /dev/null +++ b/_sources/index.rst.txt @@ -0,0 +1,19 @@ + +Homepage +======== + +.. toctree:: + :caption: Content Creation Guide + :glob: + :titlesonly: + + source/social/project + source/social/* + +.. toctree:: + :caption: Graphics Programming Blog + :glob: + :titlesonly: + + source/blog/cpp + source/blog/* diff --git a/_sources/source/blog/autoexposure.rst.txt b/_sources/source/blog/autoexposure.rst.txt new file mode 100644 index 0000000..a0d45c3 --- /dev/null +++ b/_sources/source/blog/autoexposure.rst.txt @@ -0,0 +1,109 @@ + +Temporal Auto-Exposure with Hardware Blending +============================================= + +Some graphics pipelines compute auto-exposure like this: + :Textures: + #. Previous average brightness + #. Current average brightness + :Passes: + #. Store previously generated average brightness + #. Generates current average brightness + #. Smooth average brightnesses and compute auto-exposure + +You can use hardware blending for auto-exposure: + :Textures: + #. Average brightnesses (previous + current) + :Passes: + #. Generate and smooth average brightnesses + #. Compute auto-exposure + +Source Code +----------- + +:: + + /* + Automatic exposure shader using hardware blending + */ + + /* + Vertex shaders + */ + + struct APP2VS + { + float4 HPos : POSITION; + float2 Tex0 : TEXCOORD0; + }; + + struct VS2PS + { + float4 HPos : POSITION; + float2 Tex0 : TEXCOORD0; + }; + + VS2PS VS_Quad(APP2VS Input) + { + VS2PS Output; + Output.HPos = Input.HPos; + Output.Tex0 = Input.Tex0; + return Output; + } + + /* + Pixel shaders + --- + AutoExposure(): https://knarkowicz.wordpress.com/2016/01/09/automatic-exposure/ + */ + + float3 GetAutoExposure(float3 Color, float2 Tex) + { + float LumaAverage = exp(tex2Dlod(SampleLumaTex, float4(Tex, 0.0, 99.0)).r); + float Ev100 = log2(LumaAverage * 100.0 / 12.5); + Ev100 -= _ManualBias; // optional manual bias + float Exposure = 1.0 / (1.2 * exp2(Ev100)); + return Color * Exposure; + } + + float4 PS_GenerateAverageLuma(VS2PS Input) : COLOR0 + { + float4 Color = tex2D(SampleColorTex, Input.Tex0); + float3 Luma = max(Color.r, max(Color.g, Color.b)); + + // OutputColor0.rgb = Output the highest brightness out of red/green/blue component + // OutputColor0.a = Output the weight for temporal blending + float Delay = 1e-3 * _Frametime; + return float4(log(max(Luma.rgb, 1e-2)), saturate(Delay * _SmoothingSpeed)); + } + + float3 PS_Exposure(VS2PS Input) : COLOR0 + { + float4 Color = tex2D(SampleColorTex, Input.Tex0); + return GetAutoExposure(Color.rgb, Input.Tex0); + } + + technique AutoExposure + { + // Pass0: This shader renders to a texture that blends itself + // NOTE: Do not have another shader overwrite the texture + pass GenerateAverageLuma + { + // Use hardware blending + BlendEnable = TRUE; + BlendOp = ADD; + SrcBlend = SRCALPHA; + DestBlend = INVSRCALPHA; + + VertexShader = VS_Quad; + PixelShader = PS_GenerateAverageLuma; + } + + // Pass1: Get the texture generated from Pass0 + // Do autoexposure shading here + pass ApplyAutoExposure + { + VertexShader = VS_Quad; + PixelShader = PS_Exposure; + } + } diff --git a/_sources/source/blog/censustransform.rst.txt b/_sources/source/blog/censustransform.rst.txt new file mode 100644 index 0000000..8951818 --- /dev/null +++ b/_sources/source/blog/censustransform.rst.txt @@ -0,0 +1,48 @@ + +Census Transform in HLSL +======================== + +The census transform is a filter that represents the pixel's neighborhood relationship in a binary string. The binary string will be ``0000000`` if the center pixel is lesser than all of its neighbors. The binary string will be ``11111111`` if the center pixel is greater than or equal to all of its neighbors. + +The filter does not depend on the image's actual intensity. As a result, the filter is robust to illumination. + +Source Code +----------- + +:: + + float GetGreyScale(float3 Color) + { + return max(max(Color.r, Color.g), Color.b); + } + + float GetCensusTransform(sampler SampleImage, float2 Tex, float2 PixelSize) + { + float OutputColor = 0.0; + float4 ColumnTex[3]; + ColumnTex[0] = Tex.xyyy + (float4(-1.0, +1.0, 0.0, -1.0) * PixelSize.xyyy); + ColumnTex[1] = Tex.xyyy + (float4( 0.0, +1.0, 0.0, -1.0) * PixelSize.xyyy); + ColumnTex[2] = Tex.xyyy + (float4(+1.0, +1.0, 0.0, -1.0) * PixelSize.xyyy); + + const int Neighbors = 8; + float SampleNeighbor[Neighbors]; + SampleNeighbor[0] = GetGreyScale(tex2D(SampleImage, ColumnTex[0].xy).rgb); + SampleNeighbor[1] = GetGreyScale(tex2D(SampleImage, ColumnTex[1].xy).rgb); + SampleNeighbor[2] = GetGreyScale(tex2D(SampleImage, ColumnTex[2].xy).rgb); + SampleNeighbor[3] = GetGreyScale(tex2D(SampleImage, ColumnTex[0].xz).rgb); + SampleNeighbor[4] = GetGreyScale(tex2D(SampleImage, ColumnTex[2].xz).rgb); + SampleNeighbor[5] = GetGreyScale(tex2D(SampleImage, ColumnTex[0].xw).rgb); + SampleNeighbor[6] = GetGreyScale(tex2D(SampleImage, ColumnTex[1].xw).rgb); + SampleNeighbor[7] = GetGreyScale(tex2D(SampleImage, ColumnTex[2].xw).rgb); + float CenterSample = GetGreyScale(tex2D(SampleImage, ColumnTex[1].xz).rgb); + + // Generate 8-bit integer from the 8-pixel neighborhood + for(int i = 0; i < Neighbors; i++) + { + float Comparison = step(SampleNeighbor[i], CenterSample); + OutputColor += ldexp(Comparison, i); + } + + // Convert the 8-bit integer to float, and average the results from each channel + return OutputColor * (1.0 / (exp2(8) - 1)); + } diff --git a/_sources/source/blog/chromaticity.rst.txt b/_sources/source/blog/chromaticity.rst.txt new file mode 100644 index 0000000..f93e555 --- /dev/null +++ b/_sources/source/blog/chromaticity.rst.txt @@ -0,0 +1,100 @@ + +Chromaticity in HLSL +==================== + +Images often represent color in 3 channels: ``(R, G, B)`` - red, green, and blue. You can represent ``(R, G, B)`` in any range. For this post, the range is a minimum of **0.0** and a maximum of **1.0**. + +Normalized Chromaticity +----------------------- + +Formulas +^^^^^^^^ + +Normalized RG/RGB + .. math:: + + r = \frac{R}{R+G+B}\\ + g = \frac{G}{R+G+B}\\ + b = \frac{B}{R+G+B}\\ + \\ + r+g+b = 1 + + Output :math:`(r,g,b)` + :(1.0, 0.0, 0.0): 100% red + :(0.0, 1.0, 0.0): 100% green + :(0.0, 0.0, 1.0): 100% blue + + Output :math:`(r,g)` + :\(1.0, 0.0\): 100% red + :\(0.0, 1.0\): 100% green + :\(0.0, 0.0\): 100% blue + +Normalized RG/RGB White-Point + .. math:: + + R=1\\ + G=1\\ + B=1\\ + \\ + r = \frac{R}{R+G+B}\\ + g = \frac{G}{R+G+B}\\ + b = \frac{B}{R+G+B}\\ + \\ + r+g+b = 1 + +Source Code +^^^^^^^^^^^ + +:: + + float3 GetRGBChromaticity(float3 Color) + { + // Optimizes 2 ADD instructions 1 DP3 instruction + float SumRGB = dot(Color, 1.0); + float3 Chromaticity = saturate(Color / SumRGB); + // Output the chromaticity's white point if the divisor is 0.0 + // Prevents undefined behavior happens when you divide by 0 + Chromaticity = (SumRGB == 0.0) ? 1.0 / 3.0 : Chromaticity; + return Chromaticity; + } + +Spherical Chromaticity +---------------------- + +This post introduces a color space that computes chromaticity with angles. + +Precision Loss in RG Chromaticity +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Pecision is a major drawback to RG chromaticity. In RG chromaticity, all possible values map into a right-triangle, eliminating half of the precision in integer buffers. + +We can encode data that fits in the entire ``RG8`` range by calculating the angles between the channels. + +Source Code +^^^^^^^^^^^ + +:: + + /* + This code is based on the algorithm described in the following paper: + Author(s): Joost van de Weijer, T. Gevers + Title: "Robust optical flow from photometric invariants" + Year: 2004 + DOI: 10.1109/ICIP.2004.1421433 + Link: https://www.researchgate.net/publication/4138051_Robust_optical_flow_from_photometric_invariants + */ + + float2 GetSphericalRG(float3 Color) + { + const float HalfPi = 1.0 / acos(0.0); + + // Precalculate (x*x + y*y)^0.5 and (x*x + y*y + z*z)^0.5 + float L1 = length(Color.rg); + float L2 = length(Color.rgb); + + float2 Angles = 0.0; + Angles[0] = (L1 == 0.0) ? 1.0 / sqrt(2.0) : Color.g / L1; + Angles[1] = (L2 == 0.0) ? 1.0 / sqrt(3.0) : L1 / L2; + + return saturate(asin(abs(Angles)) * HalfPi); + } diff --git a/_sources/source/blog/coordinatespaces.rst.txt b/_sources/source/blog/coordinatespaces.rst.txt new file mode 100644 index 0000000..f841227 --- /dev/null +++ b/_sources/source/blog/coordinatespaces.rst.txt @@ -0,0 +1,31 @@ + +Coordinate Spaces: A Refresher +============================== + +Standard Basis + Defines the directions of the x-axis, y-axis, and z-axis. + + :(1.0, 0.0, 0.0): x-axis + :(0.0, 1.0, 0.0): y-axis + :(0.0, 0.0, 1.0): z-axis + + +.. list-table:: Coordinate Spaces + :header-rows: 1 + + * - Coordinate Space + - Standard-Basis Location + - (0.0, 0.0, 0.0) Location + * - Tangent-Space + - On the **face or vertex**. + - On the center of the **face or vertex**. + * - Object-Space + - On the **object**. + - On the center of the **object**. + * - World-Space + - On the **world**. + - On the center of the **world**. + * - View-Space + - On the **viewer**. + - On the center of the **viewer**. + diff --git a/_sources/source/blog/cpp.rst.txt b/_sources/source/blog/cpp.rst.txt new file mode 100644 index 0000000..298f118 --- /dev/null +++ b/_sources/source/blog/cpp.rst.txt @@ -0,0 +1,750 @@ +GiraffeAcademy's C++ Examples +============================= + +Sourced from: `C++ Programming | In One Video `_ + +Abstract Classes +---------------- + +.. code-block:: cpp + + #include + using namespace std; + + class Vehicle + { + public: + virtual void move() = 0; + void getDescription() + { + cout << "Vehicles are used for transportation" << endl; + } + }; + + class Bicycle : public Vehicle + { + public: + void move() + { + cout << "The bicycle pedals forward" << endl; + } + }; + + class Plane : public Vehicle + { + public: + virtual void move() + { + cout << "The plane flys through the sky" << endl; + } + }; + + int main() + { + Plane myPlane; + myPlane.move(); + myPlane.getDescription(); + + return 0; + } + +Arrays +------ + +.. code-block:: cpp + + #include + using namespace std; + + int main() + { + // Define an integer array + // int luckyNumbers[6]; + int luckyNumbers[] = {4, 8, 15, 16, 23, 42}; + // indexes: 0 1 2 3 4 5 + + // Set the number 99 at the 1st member + luckyNumbers[0] = 90; + + // Print out the array's 1st and 2nd members + cout << luckyNumbers[0] << endl; + cout << luckyNumbers[1] << endl; + + return 0; + } + +Arrays (2D) +----------- + +.. code-block:: cpp + + #include + using namespace std; + + int main() + { + // Define a 2D integer array + // int numberGrid[2][3]; + int numberGrid[2][3] = {{1, 2, 3}, {4, 5, 6}}; + + // Set the number 99 at [row 1][column 2] + numberGrid[0][1] = 99; + + // Print [row 1][column 1 and 2] + cout << numberGrid[0][0] << endl; + cout << numberGrid[0][1] << endl; + + return 0; + } + +Casting +------- + +.. code-block:: cpp + + #include + using namespace std; + + int main() + { + cout << (int)3.14 << endl; + cout << (double)3 / 2 << endl; + + return 0; + } + +Classes +------- + +.. code-block:: cpp + + #include + #include + using namespace std; + + // Create the Book datatype + class Book + { + public: + string title; + string author; + + void readBook() + { + cout << "Reading " + this->title + " by " + this->author << endl; + } + }; + + int main() + { + // Construct the book1 object instance + Book book1; + book1.title = "Harry Potter"; + book1.author = "JK Rowling"; + + // Print out info from the book1 object instance + book1.readBook(); + cout << book1.title << endl; + + // Construct the book2 object instance + Book book2; + book2.title = "Lord of the Rings"; + book2.author = "JRR Tolkien"; + + // Print out info from the book2 object instance + book2.readBook(); + cout << book2.title << endl; + + return 0; + } + +Constants +--------- + +.. code-block:: cpp + + #include + using namespace std; + + int main() + { + const int BIRTH_YEAR = 1945; + // BIRTH_YEAR = 1988; // Can't change BIRTH_YEAR + cout << BIRTH_YEAR; + + return 0; + } + +Constructors +------------ + +.. code-block:: cpp + + #include + #include + using namespace std; + + // Create the Book datatype + class Book + { + public: + string title; + string author; + + // Define the class' constuctor function + // NOTE: This is like `def __init__()` in Python :D + Book(string title, string author) + { + this->title = title; + this->author = author; + } + + void readBook() + { + cout << "Reading " + this->title + " by " + this->author << endl; + } + }; + + int main() + { + // Construct the book1 object instance + Book book1("Harry Potter", "JK Rowling"); + + // Print out info from the book1 object instance + book1.readBook(); + cout << book1.title << endl; + + // Construct the book2 object instance + Book book2("Lord of the Rings", "JRR Tolkien"); + + // Print out info from the book2 object instance + book2.readBook(); + cout << book2.title << endl; + + return 0; + } + +Exceptions +---------- + +.. code-block:: cpp + + #include + using namespace std; + + double division(int a, int b) + { + if (b == 0) + { + throw "Division by zero error!"; + } + return (a / b); + } + + int main() + { + try + { + division(10, 0); + } + catch (const char *msg) + { + cerr << msg << endl; + } + + return 0; + } + +For Loops +--------- + +.. code-block:: cpp + + #include + using namespace std; + + int main() + { + for (int i = 0; i < 5; i++) + { + cout << i << endl; + } + + return 0; + } + +Functions +--------- + +.. code-block:: cpp + + #include + using namespace std; + + // Specify a method signature + int addNumbers(int num1, int num2); + + int main() + { + // NOTE: We declare the function first + int sum = addNumbers(4, 60); + cout << sum << endl; + + return 0; + } + + int addNumbers(int num1, int num2) + { + return num1 + num2; + } + +Getters & Setters +----------------- + +.. code-block:: cpp + + #include + #include + using namespace std; + + // Create the Book datatype + class Book + { + private: + string title; + string author; + + public: + // Define the class' constuctor function + // NOTE: This is like `def __init__()` in Python :D + Book(string title, string author) + { + this->setTitle(title); + this->setAuthor(author); + } + + string getTitle() + { + return this->title; + } + + void setTitle(string title) + { + this->title = title; + } + + string getAuthor(string author) + { + return this->author; + } + + void setAuthor(string author) + { + this->author = author; + } + + void readBook() + { + cout << "Reading " + this->title + " by " + this->author << endl; + } + }; + + int main() + { + // Construct the book1 object instance + Book book1("Harry Potter", "JK Rowling"); + + // Print out info from the book1 object instance + book1.readBook(); + cout << book1.getTitle() << endl; + + // Construct the book2 object instance + Book book2("Lord of the Rings", "JRR Tolkien"); + + // Print out info from the book2 object instance + book2.readBook(); + cout << book2.getTitle() << endl; + + return 0; + } + +If Statements +------------- + +.. code-block:: cpp + + #include + using namespace std; + + int main() + { + // Define 2 booleans + bool isStudent = false; + bool isSmart = false; + + if (isStudent && isSmart) + { + cout << "You are a student" << endl; + } + else if (isStudent && !isSmart) + { + cout << "You are not a smart student" << endl; + } + else + { + cout << "You are not a student and not smart" << endl; + } + + // >, <, >=, <=, !=, == + if (1 > 3) + { + cout << "Number comparison was true" << endl; + } + + if ('a' > 'b') + { + cout << "Character comparison was true" << endl; + } + + string myString = "cat"; + if (myString.compare("cat") != 0) + { + cout << "string comparison was true" << endl; + } + + return 0; + } + +Inheritance +----------- + +.. code-block:: cpp + + #include + using namespace std; + + // Create a Chef datatype + class Chef + { + public: + string name; + int age; + + Chef(string name, int age) + { + this->name = name; + this->age = age; + } + + void makeChicken() + { + cout << "The chef makes chicken" << endl; + } + + void makeSalad() + { + cout << "The chef makes salad" << endl; + } + + void makeSpecialDish() + { + cout << "The chef makes a special dish" << endl; + } + }; + + // Create an ItalianChef datatype that is an extenion of the Chef datatype + class ItalianChef : public Chef + { + public: + string countryOfOrigin; + + // Extended class' constructor from Chef's class constructor + ItalianChef(string name, int age, string countryOfOrigin) : Chef(name, age) + { + this->countryOfOrigin = countryOfOrigin; + } + + void makePasta() + { + cout << "The chef makes pasta" << endl; + } + + // Override the Chef class' makeSpecialDish() + void makeSpecialDish() + { + cout << "The chef makes chicken parmesan" << endl; + } + }; + + int main() + { + // Example of the Chef class + Chef myChef("Gordon Ramsay", 50); + myChef.makeSpecialDish(); + + // Example of the extended ItalianChef class + ItalianChef myItalianChef("Massimo Bottura", 55, "Italy"); + myItalianChef.makeSpecialDish(); + cout << myItalianChef.age << endl; + + return 0; + } + +Numbers +------- + +.. code-block:: cpp + + #include + using namespace std; + + int main() + { + cout << 2 * 3 << endl; // Basic arithmetic: +, -, /, * + cout << 10 % 3 << endl; // Modulus operator: returns the remainder of 10 / 3 + cout << (1 + 2) * 3 << endl; // Order of operations + + /* + Division rules with ints and doubles: + f/f = f + i/i = i + i/f = f + f/i = f + */ + cout << 10 / 3.0 << endl; + + int num = 10; + num += 100; // +=, -=, /=, *= + cout << num << endl; + + // Example: variable incrementation + num++; + cout << num << endl; + + return 0; + } + +Pointers +-------- + +.. code-block:: cpp + + #include + using namespace std; + + int main() + { + /* + What pointers are: + - Exposes memory addresses + - Manipulates memory addresses + Why we use pointers: + - Memory addresses can change per-syetem + - Directly change data without copying it + */ + + // Print out an integer variable's memory address + int num = 10; + cout << &num << endl; + + // Store the integer variable's memory address into memory + int *pNum = # + cout << pNum << endl; // Print the memory adddress + cout << *pNum << endl; // Dereference the memory address to fetch its stored value + + return 0; + } + +Printing +-------- + +.. code-block:: cpp + + #include + using namespace std; + + int main() + { + cout << "Hello World!" << endl; + + return 0; + } + +Strings +------- + +.. code-block:: cpp + + #include + #include + using namespace std; + + int main() + { + string greetings = "Hello"; + // char indexes: 01234 + + cout << greetings.length() << endl; // Get string length + cout << greetings[0] << endl; // Get 1st character of string + cout << greetings.find("llo") << endl; // Find "llo"'s starting character position + cout << greetings.substr(2) << endl; // Get all characters, starting from the 2nd character of the string + cout << greetings.substr(1, 3) << endl; // Get 3 characters, starting from the 1st character of the string + + return 0; + } + +Switch Statements +----------------- + +.. code-block:: cpp + + #include + using namespace std; + + int main() + { + char myGrade = 'A'; + switch (myGrade) + { + case 'A': + cout << "You pass" << endl; + break; + case 'B': + cout << "You fail" << endl; + break; + default: + cout << "Invalid grade" << endl; + } + + return 0; + } + +User Input +---------- + +.. code-block:: cpp + + #include + #include + using namespace std; + + int main() + { + string name; + cout << "Enter your name: "; + cin >> name; + cout << "Hello " << name << endl; + + int num1, num2; + cout << "Enter first number: "; + cin >> num1; + cout << "Enter second number: "; + cin >> num2; + cout << "Answer: " << num1 + num2 << endl; + + return 0; + } + +Variables +--------- + +.. code-block:: cpp + + #include + #include + using namespace std; + + int main() + { + /* + Traits: + - Case-sensitive + - May begin with letters + - Can include letters, numbers, or _ + Convention: + - First word lower-case, rest upper-case (camelCase) + - Example: myVariable + */ + + string name = "Mike"; // string of characters, not primitive + char testGrade = 'A'; // single 8-bit character + + // NOTE: You can make them unsigned by adding the "unsigned" prefix + short age0 = 10; // atleast 16-bit signed integer + int age1 = 20; // atleast 16-bits signed integer (not smaller than short) + long age2 = 30; // atleast 32-bits signed integer + long long age3 = 40; // atleast 64-bits signed integer + + float gpa0 = 2.5f; // single percision floating point + double gpa1 = 3.5l; // double-precision floating point + long double gpa2 = 3.5; // extended-precision floating point + + bool isTall; // 1-bit -> true/false + isTall = true; + + return 0; + } + +Vectors +------- + +.. code-block:: cpp + + #include + #include + #include + using namespace std; + + int main() + { + // Define a vector of strings + vector friends; + // Append 3 strings into the vector + friends.push_back("Oscar"); + friends.push_back("Angela"); + friends.push_back("Kevin"); + // Append "Jim" at the 2nd index of the vendor + friends.insert(friends.begin() + 1, "Jim"); + + // Print out the friend vector's first 3 members + cout << friends.at(0) << endl; + cout << friends.at(1) << endl; + cout << friends.at(2) << endl; + // Print out the friend vector's size + cout << friends.size() << endl; + + return 0; + } + +While Loops +----------- + +.. code-block:: cpp + + #include + using namespace std; + + int main() + { + // Notify that this is a while loop + cout << "Executing while loop" << endl; + + // Do while loop + int index = 1; + while (index <= 5) + { + cout << index << endl; + index++; + } + + // Notify that this is a do-while loop + cout << "Executing do-while loop" << endl; + + do + { + cout << index << endl; + index++; + } while (index <= 5); + + return 0; + } \ No newline at end of file diff --git a/_sources/source/blog/gaussianblur.rst.txt b/_sources/source/blog/gaussianblur.rst.txt new file mode 100644 index 0000000..56561c8 --- /dev/null +++ b/_sources/source/blog/gaussianblur.rst.txt @@ -0,0 +1,46 @@ + +RasterGrid's Gaussian Blur in HLSL +================================== + +Gaussian blurs sample many pixels. `RasterGrid optimized Gaussian blur by sampling in-between pixels `_. RasterGrid's article did not include shader code for varied Gaussian blur radii. This post solves that. + +Source Code +----------- + +:: + + float GetGaussianWeight(float SampleIndex, float Sigma) + { + const float Pi = 3.1415926535897932384626433832795f; + float Output = rsqrt(2.0 * Pi * (Sigma * Sigma)); + return Output * exp(-(SampleIndex * SampleIndex) / (2.0 * Sigma * Sigma)); + } + + float GetGaussianOffset(float SampleIndex, float Sigma, out float LinearWeight) + { + float Offset1 = SampleIndex; + float Offset2 = SampleIndex + 1.0; + float Weight1 = GetGaussianWeight(Offset1, Sigma); + float Weight2 = GetGaussianWeight(Offset2, Sigma); + LinearWeight = Weight1 + Weight2; + return ((Offset1 * Weight1) + (Offset2 * Weight2)) / LinearWeight; + } + + float4 GetGaussianBlur(float2 Tex, float LOD, float2 PixelSize, float Sigma) + { + // Sample and weight center first to get even number sides + float TotalWeight = GetGaussianWeight(0.0, Sigma); + float4 OutputColor = tex2Dlod(SampleColorTex, float4(Tex, 0.0, LOD)) * TotalWeight; + + for(float i = 1.0; i < Sigma * 3.0; i += 2.0) + { + float LinearWeight = 0.0; + float LinearOffset = GetGaussianOffset(i, Sigma, LinearWeight); + OutputColor += tex2Dlod(SampleColorTex, float4(Tex - (LinearOffset * PixelSize), 0.0, LOD)) * LinearWeight; + OutputColor += tex2Dlod(SampleColorTex, float4(Tex + (LinearOffset * PixelSize), 0.0, LOD)) * LinearWeight; + TotalWeight += LinearWeight * 2.0; + } + + // Normalize intensity to prevent altered output + return OutputColor / TotalWeight; + } diff --git a/_sources/source/blog/logdepth.rst.txt b/_sources/source/blog/logdepth.rst.txt new file mode 100644 index 0000000..8394383 --- /dev/null +++ b/_sources/source/blog/logdepth.rst.txt @@ -0,0 +1,66 @@ + +Logarithmic Depth Buffering in HLSL +=================================== + +`The Project Reality Team `_ implemented logarithmic depth buffering for the 1.7.3 update. This post covers our implementation of simple logarithmic depth buffering in HLSL. + +`Outerra has an optimized 2013 implementation of logarithmic depth in GLSL `_. This is our simplified version of Outerra’s logarithmic depth in HLSL. + +Source Code +----------- + +:: + + float4x4 _WorldViewProj : WorldViewProj; + + struct APP2VS + { + float4 Pos : POSITION0; + }; + + struct VS2PS + { + float4 HPos : POSITION; + float Depth : TEXCOORD0; + }; + + struct PS2FB + { + float4 Color : COLOR; + float Depth : DEPTH; + }; + + // Converts linear depth to logarithmic depth in the pixel shader + // Source: https://outerra.blogspot.com/2013/07/logarithmic-depth-buffer-optimizations.html + float ApplyLogarithmicDepth(float Depth) + { + const float FarPlane = 10000.0; + const float FCoef = 1.0 / log2(FarPlane + 1.0); + return log2(Depth) * FCoef; + } + + VS2PS VS_LogDepth(APP2VS Input) + { + VS2PS Output = (VS2PS)0; + + // Usually a transformation happens here + Output.HPos = mul(float4(Input.Pos.xyz, 1.0), _WorldViewProj); + + // Output depth + Output.Depth = Output.HPos.w + 1.0; + + return Output; + } + + PS2FB PS_LogDepth(VS2PS Input) + { + PS2FB Output; + + // You need to output something to the color buffer + Output.Color = 0.0; + + // You must output to the pixel shader’s DEPTH semantic so the GPU can do per-fragment depth testing. + Output.Depth = ApplyLogarithmicDepth(Input.Depth); + + return Output; + }; diff --git a/_sources/source/blog/loops.rst.txt b/_sources/source/blog/loops.rst.txt new file mode 100644 index 0000000..527a320 --- /dev/null +++ b/_sources/source/blog/loops.rst.txt @@ -0,0 +1,36 @@ + +Turning a Nested 2D Loop into 1D +================================ + +In GPU programming, you might sample a 2D window with a nested. However, a nested loop might be more inefficient than 1 loop. + +This post is an example of how to sample a 3x3 window of offsets in 1 loop. + +Source Code +----------- + +:: + + // Get required data to calculate main window data + const int WindowSize = 3; + const int WindowHalf = trunc(WindowSize / 2); + + // Start from the negative so we can process a window in 1 loop + [loop] for (int i = 0; i < (WindowSize * WindowSize); i++) + { + float2 XY = -WindowHalf + float2(i % WindowSize, trunc(i / WindowSize)); + } + +== ============ == ================= == +i# X Y +== ============ == ================= == +0 -1 + (0 % 3) -1 -1 + trunc(0 / 3) -1 +1 -1 + (1 % 3) 0 -1 + trunc(1 / 3) -1 +2 -1 + (2 % 3) 1 -1 + trunc(2 / 3) -1 +3 -1 + (3 % 3) -1 -1 + trunc(3 / 3) 0 +4 -1 + (4 % 3) 0 -1 + trunc(4 / 3) 0 +5 -1 + (5 % 3) 1 -1 + trunc(5 / 3) 0 +6 -1 + (6 % 3) -1 -1 + trunc(6 / 3) 1 +7 -1 + (7 % 3) 0 -1 + trunc(7 / 3) 1 +8 -1 + (8 % 3) 1 -1 + trunc(8 / 3) 1 +== ============ == ================= == diff --git a/_sources/source/blog/opticalflow.rst.txt b/_sources/source/blog/opticalflow.rst.txt new file mode 100644 index 0000000..de81953 --- /dev/null +++ b/_sources/source/blog/opticalflow.rst.txt @@ -0,0 +1,223 @@ + +Lucas-Kanade Optical Flow in HLSL +================================= + +An optical flow algorithm estimates the motion between frames. Optical flow is essential in object detection, object recognition, motion estimation, video compression, and video effects. + +This post covers an HLSL implementation of Lucas-Kanade optical flow. + +Algorithm +--------- + +The pyramid LK algorithm consists of the following steps. + +#. Build the current frame’s mipmap pyramid + + Encode the image into chromaticity with ``GetSphericalRG()`` + +#. Filter the current frame with a Gaussian blur +#. Set the initial motion vector to ``<0.0, 0.0>`` +#. Compute optical flow from the smallest to largest pyramid level + + Propagate the optical flow at each level + +#. Filter the optical flow with a Gaussian blur +#. Store the current frame for use in the next frame + +.. note:: + + The code contains **generic** functions, so you may need to change some parts of the code so it is compatible with your setup. + +Source Code +----------- + +:: + + /* + This code is based on the algorithm described in the following paper: + Author(s): Joost van de Weijer, T. Gevers + Title: "Robust optical flow from photometric invariants" + Year: 2004 + DOI: 10.1109/ICIP.2004.1421433 + Link: https://www.researchgate.net/publication/4138051_Robust_optical_flow_from_photometric_invariants + */ + + float2 GetSphericalRG(float3 Color) + { + const float HalfPi = 1.0 / acos(0.0); + + // Precalculate (x*x + y*y)^0.5 and (x*x + y*y + z*z)^0.5 + float L1 = length(Color.rg); + float L2 = length(Color.rgb); + + float2 Angles = 0.0; + Angles[0] = (L1 == 0.0) ? 1.0 / sqrt(2.0) : Color.g / L1; + Angles[1] = (L2 == 0.0) ? 1.0 / sqrt(3.0) : L1 / L2; + + return saturate(asin(abs(Angles)) * HalfPi); + } + + float CMath_GetHalfMax() + { + // Get the Half format distribution of bits + // Sign Exponent Significand + // 0 00000 000000000 + const int SignBit = 0; + const int ExponentBits = 5; + const int SignificandBits = 10; + + const int Bias = -15; + const int Exponent = exp2(ExponentBits); + const int Significand = exp2(SignificandBits); + + const float MaxExponent = ((float)Exponent - (float)exp2(1)) + (float)Bias; + const float MaxSignificand = 1.0 + (((float)Significand - 1.0) / (float)Significand); + + return (float)pow(-1, SignBit) * (float)exp2(MaxExponent) * MaxSignificand; + } + + // [-HalfMax, HalfMax) -> [-1.0, 1.0) + float2 CMath_HalfToNorm(float2 Half2) + { + return clamp(Half2 / CMath_GetHalfMax(), -1.0, 1.0); + } + + // [-1.0, 1.0) -> [-HalfMax, HalfMax) + float2 CMath_NormToHalf(float2 Half2) + { + return Half2 * CMath_GetHalfMax(); + } + + // [-1.0, 1.0] -> [Width, Height] + float2 CMotionEstimation_UnnormalizeMV(float2 Vectors, float2 ImageSize) + { + return Vectors / abs(ImageSize); + } + + // [Width, Height] -> [-1.0, 1.0] + float2 CMotionEstimation_NormalizeMV(float2 Vectors, float2 ImageSize) + { + return clamp(Vectors * abs(ImageSize), -1.0, 1.0); + } + + /* + Lucas-Kanade optical flow with bilinear fetches + --- + Calculate Lucas-Kanade optical flow by solving (A^-1 * B) + [A11 A12]^-1 [-B1] -> [ A11/D -A12/D] [-B1] + [A21 A22]^-1 [-B2] -> [-A21/D A22/D] [-B2] + --- + [ Ix^2/D -IxIy/D] [-IxIt] + [-IxIy/D Iy^2/D] [-IyIt] + */ + + float2 CMotionEstimation_GetPixelPyLK + ( + float2 MainTex, // Texture coordinates in the [0.0, 1.0) range + float2 Vectors, // Vectors in the [-HalfMax, HalfMax) range + sampler2D SampleI0, + sampler2D SampleI1 + ) + { + // Initialize variables + float4 WarpTex; + float IxIx = 0.0; + float IyIy = 0.0; + float IxIy = 0.0; + float IxIt = 0.0; + float IyIt = 0.0; + float SSD = 0.0; + + // Initiate main & warped texture coordinates + WarpTex = MainTex.xyxy; + + // Calculate warped texture coordinates + WarpTex.zw -= 0.5; // Pull into [-0.5, 0.5) range + WarpTex.zw = CMath_NormToHalf(WarpTex.zw) + Vectors; // Warp in [-HalfMax, HalfMax) range + WarpTex.zw = CMath_HalfToNorm(WarpTex.zw) + 0.5; // Push into [0.0, 1.0) range + WarpTex.zw = saturate(WarpTex.zw); // Clamp into [0.0, 1.0) range + + // Get gradient information + float4 TexIx = ddx(WarpTex); + float4 TexIy = ddy(WarpTex); + float2 PixelSize = abs(TexIx.xy) + abs(TexIy.xy); + float2x2 Rotation = CMath_GetRotationMatrix(45.0); + + // Get required data to calculate main window data + const int WindowSize = 3; + const int WindowHalf = trunc(WindowSize / 2); + + [loop] for (int i = 0; i < (WindowSize * WindowSize); i++) + { + float2 AngleShift = -WindowHalf + float2(i % WindowSize, trunc(i / WindowSize)); + AngleShift = mul(Rotation, AngleShift); + + // Get temporal gradient + float4 TexIT = WarpTex.xyzw + (AngleShift.xyxy * PixelSize.xyxy); + float2 I0 = tex2Dgrad(SampleI0, TexIT.xy, TexIx.xy, TexIy.xy).rg; + float2 I1 = tex2Dgrad(SampleI1, TexIT.zw, TexIx.zw, TexIy.zw).rg; + float2 IT = I0 - I1; + + // Get spatial gradient + float4 OffsetNS = AngleShift.xyxy + float4(0.0, -1.0, 0.0, 1.0); + float4 OffsetEW = AngleShift.xyxy + float4(-1.0, 0.0, 1.0, 0.0); + float4 NS = WarpTex.xyxy + (OffsetNS * PixelSize.xyxy); + float4 EW = WarpTex.xyxy + (OffsetEW * PixelSize.xyxy); + float2 N = tex2Dgrad(SampleI0, NS.xy, TexIx.xy, TexIy.xy).rg; + float2 S = tex2Dgrad(SampleI0, NS.zw, TexIx.xy, TexIy.xy).rg; + float2 E = tex2Dgrad(SampleI0, EW.xy, TexIx.xy, TexIy.xy).rg; + float2 W = tex2Dgrad(SampleI0, EW.zw, TexIx.xy, TexIy.xy).rg; + float2 Ix = E - W; + float2 Iy = N - S; + + // IxIx = A11; IyIy = A22; IxIy = A12/A22 + IxIx += dot(Ix, Ix); + IyIy += dot(Iy, Iy); + IxIy += dot(Ix, Iy); + + // IxIt = B1; IyIt = B2 + IxIt += dot(Ix, IT); + IyIt += dot(Iy, IT); + + SSD += dot(IT, IT); + } + + /* + Calculate Lucas-Kanade matrix + --- + [ Ix^2/D -IxIy/D] [-IxIt] + [-IxIy/D Iy^2/D] [-IyIt] + */ + + /* + Create a normalized SSD-based mask. + https://www.cs.huji.ac.il/~peleg/papers/HUJI-CSE-LTR-2006-39-LK-Plus.pdf + */ + + float M = (SSD / (IxIx + IyIy)) > 0.1; + IxIx *= M; + IyIy *= M; + IxIy *= M; + IxIt *= M; + IyIt *= M; + + // Calculate A^-1 and B + float D = determinant(float2x2(IxIx, IxIy, IxIy, IyIy)); + float2x2 A = float2x2(IyIy, -IxIy, -IxIy, IxIx) / D; + float2 B = float2(-IxIt, -IyIt); + + // Calculate A^T*B + float2 Flow = (D > 0.0) ? mul(B, A) : 0.0; + + // Convert motion vectors from Half -> Norm + Vectors = CMath_HalfToNorm(Vectors); + + // Propagate normalized motion vectors in Norm Range + Vectors += CMotionEstimation_NormalizeMV(Flow, PixelSize); + + // Clamp motion vectors to restrict range to valid lengths + Vectors = clamp(Vectors, -1.0, 1.0); + + // Pack motion vectors to Half format + return CMath_NormToHalf(Vectors); + } diff --git a/_sources/source/blog/outerralogdepth.rst.txt b/_sources/source/blog/outerralogdepth.rst.txt new file mode 100644 index 0000000..29d6e31 --- /dev/null +++ b/_sources/source/blog/outerralogdepth.rst.txt @@ -0,0 +1,18 @@ + +Correcting Outerra's Logarithmic Depth Buffering +================================================ + +`Outerra has a vertex shader implementation of log depth buffering in GLSL `_. However, Outerra missed a major part of their log depth buffering. This is our corrected version of Outerra’s log depth buffering in HLSL. + +Outerra missed a multiply in the end. We must multiply log depth by ``W`` because the GPU automatically divides the vertex position ``HPos`` by ``W``. + +Source Code +----------- + +:: + + // Output.HPos is the computed vertex position in homogeneous space + const float FarPlane = 10000.0; + const float FCoef = 1.0 / log2(FarPlane + 1.0); + Output.HPos.z = saturate(log2(max(1e-6, Output.HPos.w)) * FCoef); + Output.HPos.z *= Output.HPos.w; diff --git a/_sources/source/blog/pythonengine.rst.txt b/_sources/source/blog/pythonengine.rst.txt new file mode 100644 index 0000000..86da7ef --- /dev/null +++ b/_sources/source/blog/pythonengine.rst.txt @@ -0,0 +1,58 @@ + +A Pythonic 3D Engine in 1 Weekend +================================= + +I spent this weekend following `Coder Space's Python 3D engine tutorial series `_. The tutorial covered the fundamentals of the OpenGL pipeline, from the CPU to the GPU. + +Video 1: Main Tutorial +---------------------- + +I learned about the OpenGL pipeline, starting from the CPU to the GPU. The first tutorial taught me how to… + +#. Render basic geometry +#. Add a camera to a scene +#. Add Phong lighting into a scene +#. Refactor code to re-use buffer object data +#. Use Uniform transformations +#. Adopt Best practices in rendering + + - Mipmapping + - Gamma correction + +#. Load external 3D models + +.. note:: + + I learned that VBOs are unformatted, allocated spaces of memory that store vertex-related data. However, we can use buffer objects for purposes other than being a VBO. + +Video 2: SkyBox, Environment Mapping +------------------------------------ + +I created a skybox for the rendering scene. The second tutorial taught me how to… + +#. Refactor code with polymorphism +#. Make cube-maps with faces +#. Replace cube-based skybox with plane-based skybox + +.. note:: + + Implementing a plane-based skybox was difficult, to say the least. + +Video 3: Shadow Mapping, PCF +---------------------------- + +I just created a smooth shadow-mapping system for objects. + +Feedback +-------- + +As someone who wanted to learn the graphics programming fundamentals, I found this series enjoyable to follow. I believe this tutorial can reach the masses if it also covers… + +- Instancing +- Deferred rendering +- Generating vertex normal and tangent + +Recommendation +-------------- + +I recommend this tutorial for people who already have experience with Python and want to get straight to crafting graphics. Thank you, Coder Space! diff --git a/_sources/source/blog/reshadefx.rst.txt b/_sources/source/blog/reshadefx.rst.txt new file mode 100644 index 0000000..30d718f --- /dev/null +++ b/_sources/source/blog/reshadefx.rst.txt @@ -0,0 +1,125 @@ + +ReShadeFX for Beginners +======================= + +No bullshit, just move along. + +Recap + :Vertex Shader: Code that does math on every vertex + :Pixel Shader: Code that does math on every pixel + +What is a Shader? +----------------- + +A shader is code that does math. + +A shader is like a drawing a square. Here is how you draw a red square: + +#. You draw a dotted outline of the square. +#. You connect the dotted outline of the square. +#. You color red inside the square. + +Your First Vertex Shader +------------------------ + +.. code:: + :number-lines: + + // Vertex shader generating a triangle covering the entire screen. + // See also https://www.reddit.com/r/gamedev/comments/2j17wk/a_slightly_faster_bufferless_vertex_shader_trick/ + + // Make a function that calculate on each vertex. + // PostProcessVS() outputs a triangle that is twice the screen's size. + void PostProcessVS + ( + in uint id : SV_VertexID, // Get "id" from CPU memory named "SV_VertexID" + out float4 position : SV_Position, // Send "position" to GPU memory named "SV_Position" + out float2 texcoord : TEXCOORD // Send "texcoord" to GPU memory named "TEXCOORD" + ) + { + /* + PART 1 + --- + Use the vertex's ID to calculate its texture coordinates. + NOTE: Texture coordinates are 0-1 + --- + ID 0 -> texcoord (0.0, 0.0) + ID 1 -> texcoord (0.0, 2.0) + ID 2 -> texcoord (2.0, 0.0) + */ + + // If the vertex's ID is 2, set the its texcoord's X position to 2. + // If the vertex's ID is not 2, set its texcoord's X position to 0. + texcoord.x = (id == 2) ? 2.0 : 0.0; + + // If the vertex's ID is 1, set the its texcoord's Y position to 2. + // If the vertex's ID is not 1, set its texcoord's Y position to 0. + texcoord.y = (id == 1) ? 2.0 : 0.0; + + /* + PART 2 + --- + We stretch the triangle to be twice the size of the screen. + To do this, use the vertex's texture coordinates to calculate it's position in clip-space. + + In clip-space, the values represent: + Bottom-left of screen: (-1.0, -1.0) + Bottom-right of screen: (1.0, -1.0) + Top-left of screen: (-1.0, 1.0) + Top-right of screen: (1.0, 1.0) + --- + texcoord (0.0, 0.0) -> position (-1.0, 1.0) + texcoord (0.0, 2.0) -> position (-1.0, 3.0) + texcoord (2.0, 0.0) -> position (3.0, 1.0) + */ + + position = float4(texcoord * float2(2.0, -2.0) + float2(-1.0, 1.0), 0.0, 1.0); + + /* + PART 3 + --- + 1. The GPU will "clip" fragments that have a position beyond -1 or 1. + 2. The GPU will interpolate the "texcoord" and "position" data between vertices + */ + } + +Your First Pixel Shader +----------------------- + +.. code:: + :number-lines: + + // Make a function that calculate on each pixel. + // PostProcessPS() outputs a color on each of the triangle's pixel. + void PostProcessPS + ( + in float2 texcoord : TEXCOORD, // Get "texcoord" from GPU memory named "TEXCOORD" + out float4 color : SV_Target // Send "color" to GPU memory named "SV_Target" + ) + { + /* + Use the texcoord's XY value to set the triangle's red and green value. + texcoord(1.0, 0.0) -> color(1.0, 0.0, 0.0, 1.0) -> all red + texcoord(0.0, 1.0) -> color(1.0, 0.0, 0.0, 1.0) -> all green + texcoord(1.0, 1.0) -> color(1.0, 1.0, 0.0, 1.0) -> mix of red and green + */ + color.r = texcoord.x; + color.g = texcoord.y; + color.b = 0.0; + color.a = 1.0; + } + +Your First Technique +-------------------- + +.. code:: + :number-lines: + + technique ExampleShader + { + pass + { + VertexShader = PostProcessVS; + PixelShader = PostProcessPS; + } + } diff --git a/_sources/source/blog/shadermodel3.rst.txt b/_sources/source/blog/shadermodel3.rst.txt new file mode 100644 index 0000000..f0930a0 --- /dev/null +++ b/_sources/source/blog/shadermodel3.rst.txt @@ -0,0 +1,119 @@ + +Project Reality: Shader Model 3.0 Considerations +================================================ + +`The Project Reality Team `_ updated Project Reality to support Shader Model 3. The update gave Project Reality more graphical potential. This post considerations when porting shaders from Shader Model 2 to 3. + +Fogging +------- + +From Shader Model 3, fogging is no longer fixed-function. You must implement your fogging method in the pixel shader. + +Output Register Count +--------------------- + +- `Shader Model 2 vertex shaders have a certain number of output registers for each type of data `__. + + :oPos: 1 position + :oFog: 1 fog + :oPts: 1 point-size + :oD#: 2 vertex color + :oT#: 8 texture coordinate + +- In Shader Model 3, you have 12 output registers available for any type of data. + +Input Register Format +--------------------- + +- In Shader Model 2, output registers have different levels of precision. + + For example, `vertex color registers, like oD#, are 8 bits of unsigned data, in the range of 0-1 in the pixel shader `_. + +- When you port vertex colors ``oD#`` from Shader Model 2 to 3, you must apply ``saturate()`` to the vertex color output. + +Register Assignments and Declarations +------------------------------------- + +If you encounter the following asm, with constants not declared in ASM. + +:: + + VertexShader = asm + { + vs.1.1 + + dcl_position0 v0 + + add r0.xyz, v0.xzw, -c[0].xyz + mul r0.xyz, r0.xyz, c[1].xyw // z = 0, w = 1 + add oPos.x, r0.x, -c[1].w + add oPos.y, r0.y, -c[1].w + mov oPos.z, r0.z + mov oPos.w, c[1].w // z = 0, w = 1 + add r1, v0.y, -c[2].x + mul oD0, r1, c[2].y + mov oD0.a, c[1].z // z = 0 + }; + + PixelShader = asm + { + ps.1.1 + mov r0, v0 + }; + +The solution: use the ``: register()`` to a shader variable to a particular register. You can read more about it `here `_. + +:: + + // Assign variables to registers because DICE didn't do so in their ASM. + float4 Constant0 : register(c0); // c[0] + float4 Constant1 : register(c1); // c[1] + float4 Constant2 : register(c2); // c[2] + + struct APP2PS_ProjectRoad + { + float4 Pos : POSITION0; + }; + + struct VS2PS_ProjectRoad + { + float4 HPos : POSITION; + float4 Color : TEXCOORD0; + }; + + // VertexShader + VS2PS_ProjectRoad VS_ProjectRoad(APP2PS_ProjectRoad Input) + { + VS2PS_ProjectRoad Output = (VS2PS_ProjectRoad)0.0; + + // add r0.xyz, v0.xzw, -c[0].xyz + // mul r0.xyz, r0.xyz, c[1].xyw // z = 0, w = 1 + float3 ProjPos = Input.Pos.xzw - Constant0.xyz; + ProjPos *= Constant1.xyw; // z = 0, w = 1 + + // add oPos.x, r0.x, -c[1].w + // add oPos.y, r0.y, -c[1].w + // mov oPos.z, r0.z + // mov oPos.w, c[1].w // z = 0, w = 1 + Output.HPos.x = ProjPos.x - Constant1.w; + Output.HPos.y = ProjPos.y - Constant1.w; + Output.HPos.z = ProjPos.z; + Output.HPos.w = Constant1.w; // z = 0, w = 1 + + // add r1, v0.y, -c[2].x + // mul oD0, r1, c[2].y + // mov oD0.a, c[1].z // z = 0 + float4 Color = Input.Pos.y - Constant2.x; + Output.Color = Color * Constant2.y; + Output.Color.a = Constant1.z; // z = 0 + Output.Color = saturate(Output.Color); + + return Output; + } + + // PixelShader + float4 PS_ProjectRoad(VS2PS_ProjectRoad Input) : COLOR0 + { + // mov r0, v0 + return Input.Color; + } diff --git a/_sources/source/blog/sobel.rst.txt b/_sources/source/blog/sobel.rst.txt new file mode 100644 index 0000000..1b1f3bb --- /dev/null +++ b/_sources/source/blog/sobel.rst.txt @@ -0,0 +1,28 @@ + +Bilinear Sobel Filtering in HLSL +================================ + +The Sobel filter requires you to sample 8 pixels around the center pixel. The filter is linear, so you can sample 8 pixels in 4 texture fetches by sampling in-between pixels. + +Source Code +----------- + +:: + + struct Sobel + { + float4 Ix; + float4 Iy; + }; + + Sobel GetSobel(sampler SampleImage, float2 Tex, float2 PixelSize) + { + Sobel Output; + float4 A = tex2D(SampleImage, Tex + (float2(-0.5, +0.5) * PixelSize)); + float4 B = tex2D(SampleImage, Tex + (float2(+0.5, +0.5) * PixelSize)); + float4 C = tex2D(SampleImage, Tex + (float2(-0.5, -0.5) * PixelSize)); + float4 D = tex2D(SampleImage, Tex + (float2(+0.5, -0.5) * PixelSize)); + Output.Ix = (B + D) - (A + C); + Output.Iy = (A + B) - (C + D); + return Output; + } diff --git a/_sources/source/social/instagram.rst.txt b/_sources/source/social/instagram.rst.txt new file mode 100644 index 0000000..3e7f900 --- /dev/null +++ b/_sources/source/social/instagram.rst.txt @@ -0,0 +1,38 @@ + +Instagram +========= + +Account +------- + +Requirements +^^^^^^^^^^^^ + +#. Description of the creator +#. Other links (if possible) + +Posts +----- + +Requirements +^^^^^^^^^^^^ + +#. No Instagram filters or cropping +#. At least 1 sentence on what the content is about +#. Only 3 to 5 hashtags + + - Hashtags must be relevant + - Hashtags must be different + - Hashtag set must be mix of well known and niche + +Templates +--------- + +Uploading Images +^^^^^^^^^^^^^^^^ + +:: + + Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. + + #hashtag1 #hashtag2 #hashtag3 diff --git a/_sources/source/social/project.rst.txt b/_sources/source/social/project.rst.txt new file mode 100644 index 0000000..f4dffb3 --- /dev/null +++ b/_sources/source/social/project.rst.txt @@ -0,0 +1,34 @@ + +Personal Project +================ + +Tools +----- + +`Davinci Resolve `_ + Editing and compositing Video +`FFmpeg `_ + Media conversion, used with `yt-dlp` +`OBS Studio `_ + Desktop recording +`yt-dlp `_ + Downloading media + +Downloads +--------- + +- :download:`Davinci Resolve: Video Templates (Project Reality) <../../_downloads/Video Templates (Project Reality).drp>` + +Useful Commands +--------------- + +yt-dlp +^^^^^^ + +.. describe:: yt-dlp -f bv+ba + + Downloads the best video and audio from a link. + +.. describe:: yt-dlp -f bv+ba -a <.txt file path> + + Downloads the best video and audio from a list. diff --git a/_sources/source/social/youtube.rst.txt b/_sources/source/social/youtube.rst.txt new file mode 100644 index 0000000..81b3ea1 --- /dev/null +++ b/_sources/source/social/youtube.rst.txt @@ -0,0 +1,101 @@ + +YouTube +======= + +Account Requirements +-------------------- + +#. Description of the channel +#. Methods of contact (if possible) +#. Other links (if possible) + +Video Requirements +------------------ + +#. Description + + #. **At least 1 sentence** on what the video is about + #. Timecodes (if needed) + #. **All** sources used in the video, including their respective authors + #. **Only 3** hashtags related to the video + + - Hashtags must be **relevant** + - Hashtags must be **different** + - Hashtag set must be **mix of well known and niche** + - **Re-use** hashtags across similar videos, especially if they share a playlist. + + #. **No** unnecessary keywords + +#. **High-definition** thumbnails +#. Associated playlist(s) +#. **Only 3 to 5** tags + + - Tags should be **lower-case** + - Tags should be left-to-right, from **least-to-most** specific + - **Re-use** hashtags across similar videos, especially if they share a playlist. + +#. Appropriate category +#. **Scheduled at 12:00am** before the following.. + + - Weekends (Friday and Saturday) + - Related events, such as holidays + +Video Template +-------------- + +.. list-table:: + :header-rows: 1 + + * - Title + - Playlist + - Tags + - Category + * - Video Name • Video Subject + - Generic Playlist + - alternative title 1, alternative title 2, alternative title 3 + - People & Blogs + +:: + + Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. + + 0:00 | Event 1 + 1:00 | Event 2 + + *Links* + • Link 1 Name: Link + • Link 2 Name: Link + + *Products in This Video* + • Product Link 1: Link + • Product Link 2: Link + + Product description... + + *Audio Sources* + • Recording Name (Author Name): Link + • Song Name (Author Name): Link + + *Video Sources* + • Channel Name: Link + • Video Name (Author Name): Link + • Video Re-upload Name (Re-upload Author Name, Original Author: Original Author Name): Link + + *What I Used to Make This Video* + • Tool 1: Link + • Tool 2: Link + + *Notes* + • Rhoncus urna neque viverra justo nec ultrices dui sapien. + + *Disclaimer* + • For non-commercial purposes only. Feel free to claim this video content if you own the song. + + #hashtag1 #hashtag2 #hashtag3 + + +.. note:: + **Do not** include ``Author Name`` if they are already included in the source's name. + + :No: Project Reality Standalone Trailer (Project Reality): https://youtu.be/vkYX41j6ZbA + :Yes: Project Reality Standalone Trailer: https://youtu.be/vkYX41j6ZbA diff --git a/_static/alabaster.css b/_static/alabaster.css new file mode 100644 index 0000000..d92336b --- /dev/null +++ b/_static/alabaster.css @@ -0,0 +1,668 @@ +/* -- page layout ----------------------------------------------------------- */ + +body { + font-family: Georgia, serif; + font-size: 17px; + background-color: #fff; + color: #000; + margin: 0; + padding: 0; +} + + +div.document { + width: 940px; + margin: 30px auto 0 auto; +} + +div.documentwrapper { + float: left; + width: 100%; +} + +div.bodywrapper { + margin: 0 0 0 220px; +} + +div.sphinxsidebar { + width: 220px; + font-size: 14px; + line-height: 1.5; +} + +hr { + border: 1px solid #B1B4B6; +} + +div.body { + background-color: #fff; + color: #3E4349; + padding: 0 30px 0 30px; +} + +div.body > .section { + text-align: left; +} + +div.footer { + width: 940px; + margin: 20px auto 30px auto; + font-size: 14px; + color: #888; + text-align: right; +} + +div.footer a { + color: #888; +} + +p.caption { + font-family: inherit; + font-size: inherit; +} + + +div.relations { + display: none; +} + + +div.sphinxsidebar { + max-height: 100%; + overflow-y: auto; +} + +div.sphinxsidebar a { + color: #444; + text-decoration: none; + border-bottom: 1px dotted #999; +} + +div.sphinxsidebar a:hover { + border-bottom: 1px solid #999; +} + +div.sphinxsidebarwrapper { + padding: 18px 10px; +} + +div.sphinxsidebarwrapper p.logo { + padding: 0; + margin: -10px 0 0 0px; + text-align: center; +} + +div.sphinxsidebarwrapper h1.logo { + margin-top: -10px; + text-align: center; + margin-bottom: 5px; + text-align: left; +} + +div.sphinxsidebarwrapper h1.logo-name { + margin-top: 0px; +} + +div.sphinxsidebarwrapper p.blurb { + margin-top: 0; + font-style: normal; +} + +div.sphinxsidebar h3, +div.sphinxsidebar h4 { + font-family: Georgia, serif; + color: #444; + font-size: 24px; + font-weight: normal; + margin: 0 0 5px 0; + padding: 0; +} + +div.sphinxsidebar h4 { + font-size: 20px; +} + +div.sphinxsidebar h3 a { + color: #444; +} + +div.sphinxsidebar p.logo a, +div.sphinxsidebar h3 a, +div.sphinxsidebar p.logo a:hover, +div.sphinxsidebar h3 a:hover { + border: none; +} + +div.sphinxsidebar p { + color: #555; + margin: 10px 0; +} + +div.sphinxsidebar ul { + margin: 10px 0; + padding: 0; + color: #000; +} + +div.sphinxsidebar ul li.toctree-l1 > a { + font-size: 120%; +} + +div.sphinxsidebar ul li.toctree-l2 > a { + font-size: 110%; +} + +div.sphinxsidebar input { + border: 1px solid #CCC; + font-family: Georgia, serif; + font-size: 1em; +} + +div.sphinxsidebar #searchbox { + margin: 1em 0; +} + +div.sphinxsidebar .search > div { + display: table-cell; +} + +div.sphinxsidebar hr { + border: none; + height: 1px; + color: #AAA; + background: #AAA; + + text-align: left; + margin-left: 0; + width: 50%; +} + +div.sphinxsidebar .badge { + border-bottom: none; +} + +div.sphinxsidebar .badge:hover { + border-bottom: none; +} + +/* To address an issue with donation coming after search */ +div.sphinxsidebar h3.donation { + margin-top: 10px; +} + +/* -- body styles ----------------------------------------------------------- */ + +a { + color: #004B6B; + text-decoration: underline; +} + +a:hover { + color: #6D4100; + text-decoration: underline; +} + +div.body h1, +div.body h2, +div.body h3, +div.body h4, +div.body h5, +div.body h6 { + font-family: Georgia, serif; + font-weight: normal; + margin: 30px 0px 10px 0px; + padding: 0; +} + +div.body h1 { margin-top: 0; padding-top: 0; font-size: 240%; } +div.body h2 { font-size: 180%; } +div.body h3 { font-size: 150%; } +div.body h4 { font-size: 130%; } +div.body h5 { font-size: 100%; } +div.body h6 { font-size: 100%; } + +a.headerlink { + color: #DDD; + padding: 0 4px; + text-decoration: none; +} + +a.headerlink:hover { + color: #444; + background: #EAEAEA; +} + +div.body p, div.body dd, div.body li { + line-height: 1.4em; +} + +div.admonition { + margin: 20px 0px; + padding: 10px 30px; + background-color: #EEE; + border: 1px solid #CCC; +} + +div.admonition tt.xref, div.admonition code.xref, div.admonition a tt { + background-color: #FBFBFB; + border-bottom: 1px solid #fafafa; +} + +div.admonition p.admonition-title { + font-family: Georgia, serif; + font-weight: normal; + font-size: 24px; + margin: 0 0 10px 0; + padding: 0; + line-height: 1; +} + +div.admonition p.last { + margin-bottom: 0; +} + +dt:target, .highlight { + background: #FAF3E8; +} + +div.warning { + background-color: #FCC; + border: 1px solid #FAA; +} + +div.danger { + background-color: #FCC; + border: 1px solid #FAA; + -moz-box-shadow: 2px 2px 4px #D52C2C; + -webkit-box-shadow: 2px 2px 4px #D52C2C; + box-shadow: 2px 2px 4px #D52C2C; +} + +div.error { + background-color: #FCC; + border: 1px solid #FAA; + -moz-box-shadow: 2px 2px 4px #D52C2C; + -webkit-box-shadow: 2px 2px 4px #D52C2C; + box-shadow: 2px 2px 4px #D52C2C; +} + +div.caution { + background-color: #FCC; + border: 1px solid #FAA; +} + +div.attention { + background-color: #FCC; + border: 1px solid #FAA; +} + +div.important { + background-color: #EEE; + border: 1px solid #CCC; +} + +div.note { + background-color: #EEE; + border: 1px solid #CCC; +} + +div.tip { + background-color: #EEE; + border: 1px solid #CCC; +} + +div.hint { + background-color: #EEE; + border: 1px solid #CCC; +} + +div.seealso { + background-color: #EEE; + border: 1px solid #CCC; +} + +div.topic { + background-color: #EEE; +} + +p.admonition-title { + display: inline; +} + +p.admonition-title:after { + content: ":"; +} + +pre, tt, code { + font-family: 'Consolas', 'Menlo', 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', monospace; + font-size: 0.9em; +} + +.hll { + background-color: #FFC; + margin: 0 -12px; + padding: 0 12px; + display: block; +} + +img.screenshot { +} + +tt.descname, tt.descclassname, code.descname, code.descclassname { + font-size: 0.95em; +} + +tt.descname, code.descname { + padding-right: 0.08em; +} + +img.screenshot { + -moz-box-shadow: 2px 2px 4px #EEE; + -webkit-box-shadow: 2px 2px 4px #EEE; + box-shadow: 2px 2px 4px #EEE; +} + +table.docutils { + border: 1px solid #888; + -moz-box-shadow: 2px 2px 4px #EEE; + -webkit-box-shadow: 2px 2px 4px #EEE; + box-shadow: 2px 2px 4px #EEE; +} + +table.docutils td, table.docutils th { + border: 1px solid #888; + padding: 0.25em 0.7em; +} + +table.field-list, table.footnote { + border: none; + -moz-box-shadow: none; + -webkit-box-shadow: none; + box-shadow: none; +} + +table.footnote { + margin: 15px 0; + width: 100%; + border: 1px solid #EEE; + background: #FDFDFD; + font-size: 0.9em; +} + +table.footnote + table.footnote { + margin-top: -15px; + border-top: none; +} + +table.field-list th { + padding: 0 0.8em 0 0; +} + +table.field-list td { + padding: 0; +} + +table.field-list p { + margin-bottom: 0.8em; +} + +/* Cloned from + * https://github.com/sphinx-doc/sphinx/commit/ef60dbfce09286b20b7385333d63a60321784e68 + */ +.field-name { + -moz-hyphens: manual; + -ms-hyphens: manual; + -webkit-hyphens: manual; + hyphens: manual; +} + +table.footnote td.label { + width: .1px; + padding: 0.3em 0 0.3em 0.5em; +} + +table.footnote td { + padding: 0.3em 0.5em; +} + +dl { + margin-left: 0; + margin-right: 0; + margin-top: 0; + padding: 0; +} + +dl dd { + margin-left: 30px; +} + +blockquote { + margin: 0 0 0 30px; + padding: 0; +} + +ul, ol { + /* Matches the 30px from the narrow-screen "li > ul" selector below */ + margin: 10px 0 10px 30px; + padding: 0; +} + +pre { + background: unset; + padding: 7px 30px; + margin: 15px 0px; + line-height: 1.3em; +} + +div.viewcode-block:target { + background: #ffd; +} + +dl pre, blockquote pre, li pre { + margin-left: 0; + padding-left: 30px; +} + +tt, code { + background-color: #ecf0f3; + color: #222; + /* padding: 1px 2px; */ +} + +tt.xref, code.xref, a tt { + background-color: #FBFBFB; + border-bottom: 1px solid #fff; +} + +a.reference { + text-decoration: none; + border-bottom: 1px dotted #004B6B; +} + +a.reference:hover { + border-bottom: 1px solid #6D4100; +} + +/* Don't put an underline on images */ +a.image-reference, a.image-reference:hover { + border-bottom: none; +} + +a.footnote-reference { + text-decoration: none; + font-size: 0.7em; + vertical-align: top; + border-bottom: 1px dotted #004B6B; +} + +a.footnote-reference:hover { + border-bottom: 1px solid #6D4100; +} + +a:hover tt, a:hover code { + background: #EEE; +} +div.sphinxsidebar { + position: fixed; + margin-left: 0; +} + +@media screen and (max-width: 940px) { + + body { + margin: 0; + padding: 20px 30px; + } + + div.documentwrapper { + float: none; + background: #fff; + margin-left: 0; + margin-top: 0; + margin-right: 0; + margin-bottom: 0; + } + + div.sphinxsidebar { + display: block; + float: none; + width: unset; + margin: -20px -30px 20px -30px; + position: static; + padding: 10px 20px; + background: #333; + color: #FFF; + } + + div.sphinxsidebar h3, div.sphinxsidebar h4, div.sphinxsidebar p, + div.sphinxsidebar h3 a { + color: #fff; + } + + div.sphinxsidebar a { + color: #AAA; + } + + div.sphinxsidebar p.logo { + display: none; + } + + div.document { + width: 100%; + margin: 0; + } + + div.footer { + display: none; + } + + div.bodywrapper { + margin: 0; + } + + div.body { + min-height: 0; + min-width: auto; /* fixes width on small screens, breaks .hll */ + padding: 0; + } + + .hll { + /* "fixes" the breakage */ + width: max-content; + } + + .rtd_doc_footer { + display: none; + } + + .document { + width: auto; + } + + .footer { + width: auto; + } + + .github { + display: none; + } + + ul { + margin-left: 0; + } + + li > ul { + /* Matches the 30px from the "ul, ol" selector above */ + margin-left: 30px; + } +} + + +/* misc. */ + +.revsys-inline { + display: none!important; +} + +/* Hide ugly table cell borders in ..bibliography:: directive output */ +table.docutils.citation, table.docutils.citation td, table.docutils.citation th { + border: none; + /* Below needed in some edge cases; if not applied, bottom shadows appear */ + -moz-box-shadow: none; + -webkit-box-shadow: none; + box-shadow: none; +} + + +/* relbar */ + +.related { + line-height: 30px; + width: 100%; + font-size: 0.9rem; +} + +.related.top { + border-bottom: 1px solid #EEE; + margin-bottom: 20px; +} + +.related.bottom { + border-top: 1px solid #EEE; +} + +.related ul { + padding: 0; + margin: 0; + list-style: none; +} + +.related li { + display: inline; +} + +nav#rellinks { + float: right; +} + +nav#rellinks li+li:before { + content: "|"; +} + +nav#breadcrumbs li+li:before { + content: "\00BB"; +} + +/* Hide certain items when printing */ +@media print { + div.related { + display: none; + } +} + +img.github { + position: absolute; + top: 0; + border: 0; + right: 0; +} \ No newline at end of file diff --git a/_static/basic.css b/_static/basic.css new file mode 100644 index 0000000..e5179b7 --- /dev/null +++ b/_static/basic.css @@ -0,0 +1,925 @@ +/* + * basic.css + * ~~~~~~~~~ + * + * Sphinx stylesheet -- basic theme. + * + * :copyright: Copyright 2007-2024 by the Sphinx team, see AUTHORS. + * :license: BSD, see LICENSE for details. + * + */ + +/* -- main layout ----------------------------------------------------------- */ + +div.clearer { + clear: both; +} + +div.section::after { + display: block; + content: ''; + clear: left; +} + +/* -- relbar ---------------------------------------------------------------- */ + +div.related { + width: 100%; + font-size: 90%; +} + +div.related h3 { + display: none; +} + +div.related ul { + margin: 0; + padding: 0 0 0 10px; + list-style: none; +} + +div.related li { + display: inline; +} + +div.related li.right { + float: right; + margin-right: 5px; +} + +/* -- sidebar --------------------------------------------------------------- */ + +div.sphinxsidebarwrapper { + padding: 10px 5px 0 10px; +} + +div.sphinxsidebar { + float: left; + width: 230px; + margin-left: -100%; + font-size: 90%; + word-wrap: break-word; + overflow-wrap : break-word; +} + +div.sphinxsidebar ul { + list-style: none; +} + +div.sphinxsidebar ul ul, +div.sphinxsidebar ul.want-points { + margin-left: 20px; + list-style: square; +} + +div.sphinxsidebar ul ul { + margin-top: 0; + margin-bottom: 0; +} + +div.sphinxsidebar form { + margin-top: 10px; +} + +div.sphinxsidebar input { + border: 1px solid #98dbcc; + font-family: sans-serif; + font-size: 1em; +} + +div.sphinxsidebar #searchbox form.search { + overflow: hidden; +} + +div.sphinxsidebar #searchbox input[type="text"] { + float: left; + width: 80%; + padding: 0.25em; + box-sizing: border-box; +} + +div.sphinxsidebar #searchbox input[type="submit"] { + float: left; + width: 20%; + border-left: none; + padding: 0.25em; + box-sizing: border-box; +} + + +img { + border: 0; + max-width: 100%; +} + +/* -- search page ----------------------------------------------------------- */ + +ul.search { + margin: 10px 0 0 20px; + padding: 0; +} + +ul.search li { + padding: 5px 0 5px 20px; + background-image: url(file.png); + background-repeat: no-repeat; + background-position: 0 7px; +} + +ul.search li a { + font-weight: bold; +} + +ul.search li p.context { + color: #888; + margin: 2px 0 0 30px; + text-align: left; +} + +ul.keywordmatches li.goodmatch a { + font-weight: bold; +} + +/* -- index page ------------------------------------------------------------ */ + +table.contentstable { + width: 90%; + margin-left: auto; + margin-right: auto; +} + +table.contentstable p.biglink { + line-height: 150%; +} + +a.biglink { + font-size: 1.3em; +} + +span.linkdescr { + font-style: italic; + padding-top: 5px; + font-size: 90%; +} + +/* -- general index --------------------------------------------------------- */ + +table.indextable { + width: 100%; +} + +table.indextable td { + text-align: left; + vertical-align: top; +} + +table.indextable ul { + margin-top: 0; + margin-bottom: 0; + list-style-type: none; +} + +table.indextable > tbody > tr > td > ul { + padding-left: 0em; +} + +table.indextable tr.pcap { + height: 10px; +} + +table.indextable tr.cap { + margin-top: 10px; + background-color: #f2f2f2; +} + +img.toggler { + margin-right: 3px; + margin-top: 3px; + cursor: pointer; +} + +div.modindex-jumpbox { + border-top: 1px solid #ddd; + border-bottom: 1px solid #ddd; + margin: 1em 0 1em 0; + padding: 0.4em; +} + +div.genindex-jumpbox { + border-top: 1px solid #ddd; + border-bottom: 1px solid #ddd; + margin: 1em 0 1em 0; + padding: 0.4em; +} + +/* -- domain module index --------------------------------------------------- */ + +table.modindextable td { + padding: 2px; + border-collapse: collapse; +} + +/* -- general body styles --------------------------------------------------- */ + +div.body { + min-width: inherit; + max-width: 800px; +} + +div.body p, div.body dd, div.body li, div.body blockquote { + -moz-hyphens: auto; + -ms-hyphens: auto; + -webkit-hyphens: auto; + hyphens: auto; +} + +a.headerlink { + visibility: hidden; +} + +a:visited { + color: #551A8B; +} + +h1:hover > a.headerlink, +h2:hover > a.headerlink, +h3:hover > a.headerlink, +h4:hover > a.headerlink, +h5:hover > a.headerlink, +h6:hover > a.headerlink, +dt:hover > a.headerlink, +caption:hover > a.headerlink, +p.caption:hover > a.headerlink, +div.code-block-caption:hover > a.headerlink { + visibility: visible; +} + +div.body p.caption { + text-align: inherit; +} + +div.body td { + text-align: left; +} + +.first { + margin-top: 0 !important; +} + +p.rubric { + margin-top: 30px; + font-weight: bold; +} + +img.align-left, figure.align-left, .figure.align-left, object.align-left { + clear: left; + float: left; + margin-right: 1em; +} + +img.align-right, figure.align-right, .figure.align-right, object.align-right { + clear: right; + float: right; + margin-left: 1em; +} + +img.align-center, figure.align-center, .figure.align-center, object.align-center { + display: block; + margin-left: auto; + margin-right: auto; +} + +img.align-default, figure.align-default, .figure.align-default { + display: block; + margin-left: auto; + margin-right: auto; +} + +.align-left { + text-align: left; +} + +.align-center { + text-align: center; +} + +.align-default { + text-align: center; +} + +.align-right { + text-align: right; +} + +/* -- sidebars -------------------------------------------------------------- */ + +div.sidebar, +aside.sidebar { + margin: 0 0 0.5em 1em; + border: 1px solid #ddb; + padding: 7px; + background-color: #ffe; + width: 40%; + float: right; + clear: right; + overflow-x: auto; +} + +p.sidebar-title { + font-weight: bold; +} + +nav.contents, +aside.topic, +div.admonition, div.topic, blockquote { + clear: left; +} + +/* -- topics ---------------------------------------------------------------- */ + +nav.contents, +aside.topic, +div.topic { + border: 1px solid #ccc; + padding: 7px; + margin: 10px 0 10px 0; +} + +p.topic-title { + font-size: 1.1em; + font-weight: bold; + margin-top: 10px; +} + +/* -- admonitions ----------------------------------------------------------- */ + +div.admonition { + margin-top: 10px; + margin-bottom: 10px; + padding: 7px; +} + +div.admonition dt { + font-weight: bold; +} + +p.admonition-title { + margin: 0px 10px 5px 0px; + font-weight: bold; +} + +div.body p.centered { + text-align: center; + margin-top: 25px; +} + +/* -- content of sidebars/topics/admonitions -------------------------------- */ + +div.sidebar > :last-child, +aside.sidebar > :last-child, +nav.contents > :last-child, +aside.topic > :last-child, +div.topic > :last-child, +div.admonition > :last-child { + margin-bottom: 0; +} + +div.sidebar::after, +aside.sidebar::after, +nav.contents::after, +aside.topic::after, +div.topic::after, +div.admonition::after, +blockquote::after { + display: block; + content: ''; + clear: both; +} + +/* -- tables ---------------------------------------------------------------- */ + +table.docutils { + margin-top: 10px; + margin-bottom: 10px; + border: 0; + border-collapse: collapse; +} + +table.align-center { + margin-left: auto; + margin-right: auto; +} + +table.align-default { + margin-left: auto; + margin-right: auto; +} + +table caption span.caption-number { + font-style: italic; +} + +table caption span.caption-text { +} + +table.docutils td, table.docutils th { + padding: 1px 8px 1px 5px; + border-top: 0; + border-left: 0; + border-right: 0; + border-bottom: 1px solid #aaa; +} + +th { + text-align: left; + padding-right: 5px; +} + +table.citation { + border-left: solid 1px gray; + margin-left: 1px; +} + +table.citation td { + border-bottom: none; +} + +th > :first-child, +td > :first-child { + margin-top: 0px; +} + +th > :last-child, +td > :last-child { + margin-bottom: 0px; +} + +/* -- figures --------------------------------------------------------------- */ + +div.figure, figure { + margin: 0.5em; + padding: 0.5em; +} + +div.figure p.caption, figcaption { + padding: 0.3em; +} + +div.figure p.caption span.caption-number, +figcaption span.caption-number { + font-style: italic; +} + +div.figure p.caption span.caption-text, +figcaption span.caption-text { +} + +/* -- field list styles ----------------------------------------------------- */ + +table.field-list td, table.field-list th { + border: 0 !important; +} + +.field-list ul { + margin: 0; + padding-left: 1em; +} + +.field-list p { + margin: 0; +} + +.field-name { + -moz-hyphens: manual; + -ms-hyphens: manual; + -webkit-hyphens: manual; + hyphens: manual; +} + +/* -- hlist styles ---------------------------------------------------------- */ + +table.hlist { + margin: 1em 0; +} + +table.hlist td { + vertical-align: top; +} + +/* -- object description styles --------------------------------------------- */ + +.sig { + font-family: 'Consolas', 'Menlo', 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', monospace; +} + +.sig-name, code.descname { + background-color: transparent; + font-weight: bold; +} + +.sig-name { + font-size: 1.1em; +} + +code.descname { + font-size: 1.2em; +} + +.sig-prename, code.descclassname { + background-color: transparent; +} + +.optional { + font-size: 1.3em; +} + +.sig-paren { + font-size: larger; +} + +.sig-param.n { + font-style: italic; +} + +/* C++ specific styling */ + +.sig-inline.c-texpr, +.sig-inline.cpp-texpr { + font-family: unset; +} + +.sig.c .k, .sig.c .kt, +.sig.cpp .k, .sig.cpp .kt { + color: #0033B3; +} + +.sig.c .m, +.sig.cpp .m { + color: #1750EB; +} + +.sig.c .s, .sig.c .sc, +.sig.cpp .s, .sig.cpp .sc { + color: #067D17; +} + + +/* -- other body styles ----------------------------------------------------- */ + +ol.arabic { + list-style: decimal; +} + +ol.loweralpha { + list-style: lower-alpha; +} + +ol.upperalpha { + list-style: upper-alpha; +} + +ol.lowerroman { + list-style: lower-roman; +} + +ol.upperroman { + list-style: upper-roman; +} + +:not(li) > ol > li:first-child > :first-child, +:not(li) > ul > li:first-child > :first-child { + margin-top: 0px; +} + +:not(li) > ol > li:last-child > :last-child, +:not(li) > ul > li:last-child > :last-child { + margin-bottom: 0px; +} + +ol.simple ol p, +ol.simple ul p, +ul.simple ol p, +ul.simple ul p { + margin-top: 0; +} + +ol.simple > li:not(:first-child) > p, +ul.simple > li:not(:first-child) > p { + margin-top: 0; +} + +ol.simple p, +ul.simple p { + margin-bottom: 0; +} + +aside.footnote > span, +div.citation > span { + float: left; +} +aside.footnote > span:last-of-type, +div.citation > span:last-of-type { + padding-right: 0.5em; +} +aside.footnote > p { + margin-left: 2em; +} +div.citation > p { + margin-left: 4em; +} +aside.footnote > p:last-of-type, +div.citation > p:last-of-type { + margin-bottom: 0em; +} +aside.footnote > p:last-of-type:after, +div.citation > p:last-of-type:after { + content: ""; + clear: both; +} + +dl.field-list { + display: grid; + grid-template-columns: fit-content(30%) auto; +} + +dl.field-list > dt { + font-weight: bold; + word-break: break-word; + padding-left: 0.5em; + padding-right: 5px; +} + +dl.field-list > dd { + padding-left: 0.5em; + margin-top: 0em; + margin-left: 0em; + margin-bottom: 0em; +} + +dl { + margin-bottom: 15px; +} + +dd > :first-child { + margin-top: 0px; +} + +dd ul, dd table { + margin-bottom: 10px; +} + +dd { + margin-top: 3px; + margin-bottom: 10px; + margin-left: 30px; +} + +.sig dd { + margin-top: 0px; + margin-bottom: 0px; +} + +.sig dl { + margin-top: 0px; + margin-bottom: 0px; +} + +dl > dd:last-child, +dl > dd:last-child > :last-child { + margin-bottom: 0; +} + +dt:target, span.highlighted { + background-color: #fbe54e; +} + +rect.highlighted { + fill: #fbe54e; +} + +dl.glossary dt { + font-weight: bold; + font-size: 1.1em; +} + +.versionmodified { + font-style: italic; +} + +.system-message { + background-color: #fda; + padding: 5px; + border: 3px solid red; +} + +.footnote:target { + background-color: #ffa; +} + +.line-block { + display: block; + margin-top: 1em; + margin-bottom: 1em; +} + +.line-block .line-block { + margin-top: 0; + margin-bottom: 0; + margin-left: 1.5em; +} + +.guilabel, .menuselection { + font-family: sans-serif; +} + +.accelerator { + text-decoration: underline; +} + +.classifier { + font-style: oblique; +} + +.classifier:before { + font-style: normal; + margin: 0 0.5em; + content: ":"; + display: inline-block; +} + +abbr, acronym { + border-bottom: dotted 1px; + cursor: help; +} + +.translated { + background-color: rgba(207, 255, 207, 0.2) +} + +.untranslated { + background-color: rgba(255, 207, 207, 0.2) +} + +/* -- code displays --------------------------------------------------------- */ + +pre { + overflow: auto; + overflow-y: hidden; /* fixes display issues on Chrome browsers */ +} + +pre, div[class*="highlight-"] { + clear: both; +} + +span.pre { + -moz-hyphens: none; + -ms-hyphens: none; + -webkit-hyphens: none; + hyphens: none; + white-space: nowrap; +} + +div[class*="highlight-"] { + margin: 1em 0; +} + +td.linenos pre { + border: 0; + background-color: transparent; + color: #aaa; +} + +table.highlighttable { + display: block; +} + +table.highlighttable tbody { + display: block; +} + +table.highlighttable tr { + display: flex; +} + +table.highlighttable td { + margin: 0; + padding: 0; +} + +table.highlighttable td.linenos { + padding-right: 0.5em; +} + +table.highlighttable td.code { + flex: 1; + overflow: hidden; +} + +.highlight .hll { + display: block; +} + +div.highlight pre, +table.highlighttable pre { + margin: 0; +} + +div.code-block-caption + div { + margin-top: 0; +} + +div.code-block-caption { + margin-top: 1em; + padding: 2px 5px; + font-size: small; +} + +div.code-block-caption code { + background-color: transparent; +} + +table.highlighttable td.linenos, +span.linenos, +div.highlight span.gp { /* gp: Generic.Prompt */ + user-select: none; + -webkit-user-select: text; /* Safari fallback only */ + -webkit-user-select: none; /* Chrome/Safari */ + -moz-user-select: none; /* Firefox */ + -ms-user-select: none; /* IE10+ */ +} + +div.code-block-caption span.caption-number { + padding: 0.1em 0.3em; + font-style: italic; +} + +div.code-block-caption span.caption-text { +} + +div.literal-block-wrapper { + margin: 1em 0; +} + +code.xref, a code { + background-color: transparent; + font-weight: bold; +} + +h1 code, h2 code, h3 code, h4 code, h5 code, h6 code { + background-color: transparent; +} + +.viewcode-link { + float: right; +} + +.viewcode-back { + float: right; + font-family: sans-serif; +} + +div.viewcode-block:target { + margin: -1px -10px; + padding: 0 10px; +} + +/* -- math display ---------------------------------------------------------- */ + +img.math { + vertical-align: middle; +} + +div.body div.math p { + text-align: center; +} + +span.eqno { + float: right; +} + +span.eqno a.headerlink { + position: absolute; + z-index: 1; +} + +div.math:hover a.headerlink { + visibility: visible; +} + +/* -- printout stylesheet --------------------------------------------------- */ + +@media print { + div.document, + div.documentwrapper, + div.bodywrapper { + margin: 0 !important; + width: 100%; + } + + div.sphinxsidebar, + div.related, + div.footer, + #top-link { + display: none; + } +} \ No newline at end of file diff --git a/_static/custom.css b/_static/custom.css new file mode 100644 index 0000000..2a924f1 --- /dev/null +++ b/_static/custom.css @@ -0,0 +1 @@ +/* This file intentionally left blank. */ diff --git a/_static/doctools.js b/_static/doctools.js new file mode 100644 index 0000000..4d67807 --- /dev/null +++ b/_static/doctools.js @@ -0,0 +1,156 @@ +/* + * doctools.js + * ~~~~~~~~~~~ + * + * Base JavaScript utilities for all Sphinx HTML documentation. + * + * :copyright: Copyright 2007-2024 by the Sphinx team, see AUTHORS. + * :license: BSD, see LICENSE for details. + * + */ +"use strict"; + +const BLACKLISTED_KEY_CONTROL_ELEMENTS = new Set([ + "TEXTAREA", + "INPUT", + "SELECT", + "BUTTON", +]); + +const _ready = (callback) => { + if (document.readyState !== "loading") { + callback(); + } else { + document.addEventListener("DOMContentLoaded", callback); + } +}; + +/** + * Small JavaScript module for the documentation. + */ +const Documentation = { + init: () => { + Documentation.initDomainIndexTable(); + Documentation.initOnKeyListeners(); + }, + + /** + * i18n support + */ + TRANSLATIONS: {}, + PLURAL_EXPR: (n) => (n === 1 ? 0 : 1), + LOCALE: "unknown", + + // gettext and ngettext don't access this so that the functions + // can safely bound to a different name (_ = Documentation.gettext) + gettext: (string) => { + const translated = Documentation.TRANSLATIONS[string]; + switch (typeof translated) { + case "undefined": + return string; // no translation + case "string": + return translated; // translation exists + default: + return translated[0]; // (singular, plural) translation tuple exists + } + }, + + ngettext: (singular, plural, n) => { + const translated = Documentation.TRANSLATIONS[singular]; + if (typeof translated !== "undefined") + return translated[Documentation.PLURAL_EXPR(n)]; + return n === 1 ? singular : plural; + }, + + addTranslations: (catalog) => { + Object.assign(Documentation.TRANSLATIONS, catalog.messages); + Documentation.PLURAL_EXPR = new Function( + "n", + `return (${catalog.plural_expr})` + ); + Documentation.LOCALE = catalog.locale; + }, + + /** + * helper function to focus on search bar + */ + focusSearchBar: () => { + document.querySelectorAll("input[name=q]")[0]?.focus(); + }, + + /** + * Initialise the domain index toggle buttons + */ + initDomainIndexTable: () => { + const toggler = (el) => { + const idNumber = el.id.substr(7); + const toggledRows = document.querySelectorAll(`tr.cg-${idNumber}`); + if (el.src.substr(-9) === "minus.png") { + el.src = `${el.src.substr(0, el.src.length - 9)}plus.png`; + toggledRows.forEach((el) => (el.style.display = "none")); + } else { + el.src = `${el.src.substr(0, el.src.length - 8)}minus.png`; + toggledRows.forEach((el) => (el.style.display = "")); + } + }; + + const togglerElements = document.querySelectorAll("img.toggler"); + togglerElements.forEach((el) => + el.addEventListener("click", (event) => toggler(event.currentTarget)) + ); + togglerElements.forEach((el) => (el.style.display = "")); + if (DOCUMENTATION_OPTIONS.COLLAPSE_INDEX) togglerElements.forEach(toggler); + }, + + initOnKeyListeners: () => { + // only install a listener if it is really needed + if ( + !DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS && + !DOCUMENTATION_OPTIONS.ENABLE_SEARCH_SHORTCUTS + ) + return; + + document.addEventListener("keydown", (event) => { + // bail for input elements + if (BLACKLISTED_KEY_CONTROL_ELEMENTS.has(document.activeElement.tagName)) return; + // bail with special keys + if (event.altKey || event.ctrlKey || event.metaKey) return; + + if (!event.shiftKey) { + switch (event.key) { + case "ArrowLeft": + if (!DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS) break; + + const prevLink = document.querySelector('link[rel="prev"]'); + if (prevLink && prevLink.href) { + window.location.href = prevLink.href; + event.preventDefault(); + } + break; + case "ArrowRight": + if (!DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS) break; + + const nextLink = document.querySelector('link[rel="next"]'); + if (nextLink && nextLink.href) { + window.location.href = nextLink.href; + event.preventDefault(); + } + break; + } + } + + // some keyboard layouts may need Shift to get / + switch (event.key) { + case "/": + if (!DOCUMENTATION_OPTIONS.ENABLE_SEARCH_SHORTCUTS) break; + Documentation.focusSearchBar(); + event.preventDefault(); + } + }); + }, +}; + +// quick alias for translations +const _ = Documentation.gettext; + +_ready(Documentation.init); diff --git a/_static/documentation_options.js b/_static/documentation_options.js new file mode 100644 index 0000000..7e4c114 --- /dev/null +++ b/_static/documentation_options.js @@ -0,0 +1,13 @@ +const DOCUMENTATION_OPTIONS = { + VERSION: '', + LANGUAGE: 'en', + COLLAPSE_INDEX: false, + BUILDER: 'html', + FILE_SUFFIX: '.html', + LINK_SUFFIX: '.html', + HAS_SOURCE: true, + SOURCELINK_SUFFIX: '.txt', + NAVIGATION_WITH_KEYS: false, + SHOW_SEARCH_SUMMARY: true, + ENABLE_SEARCH_SHORTCUTS: true, +}; \ No newline at end of file diff --git a/_static/file.png b/_static/file.png new file mode 100644 index 0000000000000000000000000000000000000000..a858a410e4faa62ce324d814e4b816fff83a6fb3 GIT binary patch literal 286 zcmV+(0pb3MP)s`hMrGg#P~ix$^RISR_I47Y|r1 z_CyJOe}D1){SET-^Amu_i71Lt6eYfZjRyw@I6OQAIXXHDfiX^GbOlHe=Ae4>0m)d(f|Me07*qoM6N<$f}vM^LjV8( literal 0 HcmV?d00001 diff --git a/_static/github-banner.svg b/_static/github-banner.svg new file mode 100644 index 0000000..c47d9dc --- /dev/null +++ b/_static/github-banner.svg @@ -0,0 +1,5 @@ + + + + + diff --git a/_static/language_data.js b/_static/language_data.js new file mode 100644 index 0000000..367b8ed --- /dev/null +++ b/_static/language_data.js @@ -0,0 +1,199 @@ +/* + * language_data.js + * ~~~~~~~~~~~~~~~~ + * + * This script contains the language-specific data used by searchtools.js, + * namely the list of stopwords, stemmer, scorer and splitter. + * + * :copyright: Copyright 2007-2024 by the Sphinx team, see AUTHORS. + * :license: BSD, see LICENSE for details. + * + */ + +var stopwords = ["a", "and", "are", "as", "at", "be", "but", "by", "for", "if", "in", "into", "is", "it", "near", "no", "not", "of", "on", "or", "such", "that", "the", "their", "then", "there", "these", "they", "this", "to", "was", "will", "with"]; + + +/* Non-minified version is copied as a separate JS file, if available */ + +/** + * Porter Stemmer + */ +var Stemmer = function() { + + var step2list = { + ational: 'ate', + tional: 'tion', + enci: 'ence', + anci: 'ance', + izer: 'ize', + bli: 'ble', + alli: 'al', + entli: 'ent', + eli: 'e', + ousli: 'ous', + ization: 'ize', + ation: 'ate', + ator: 'ate', + alism: 'al', + iveness: 'ive', + fulness: 'ful', + ousness: 'ous', + aliti: 'al', + iviti: 'ive', + biliti: 'ble', + logi: 'log' + }; + + var step3list = { + icate: 'ic', + ative: '', + alize: 'al', + iciti: 'ic', + ical: 'ic', + ful: '', + ness: '' + }; + + var c = "[^aeiou]"; // consonant + var v = "[aeiouy]"; // vowel + var C = c + "[^aeiouy]*"; // consonant sequence + var V = v + "[aeiou]*"; // vowel sequence + + var mgr0 = "^(" + C + ")?" + V + C; // [C]VC... is m>0 + var meq1 = "^(" + C + ")?" + V + C + "(" + V + ")?$"; // [C]VC[V] is m=1 + var mgr1 = "^(" + C + ")?" + V + C + V + C; // [C]VCVC... is m>1 + var s_v = "^(" + C + ")?" + v; // vowel in stem + + this.stemWord = function (w) { + var stem; + var suffix; + var firstch; + var origword = w; + + if (w.length < 3) + return w; + + var re; + var re2; + var re3; + var re4; + + firstch = w.substr(0,1); + if (firstch == "y") + w = firstch.toUpperCase() + w.substr(1); + + // Step 1a + re = /^(.+?)(ss|i)es$/; + re2 = /^(.+?)([^s])s$/; + + if (re.test(w)) + w = w.replace(re,"$1$2"); + else if (re2.test(w)) + w = w.replace(re2,"$1$2"); + + // Step 1b + re = /^(.+?)eed$/; + re2 = /^(.+?)(ed|ing)$/; + if (re.test(w)) { + var fp = re.exec(w); + re = new RegExp(mgr0); + if (re.test(fp[1])) { + re = /.$/; + w = w.replace(re,""); + } + } + else if (re2.test(w)) { + var fp = re2.exec(w); + stem = fp[1]; + re2 = new RegExp(s_v); + if (re2.test(stem)) { + w = stem; + re2 = /(at|bl|iz)$/; + re3 = new RegExp("([^aeiouylsz])\\1$"); + re4 = new RegExp("^" + C + v + "[^aeiouwxy]$"); + if (re2.test(w)) + w = w + "e"; + else if (re3.test(w)) { + re = /.$/; + w = w.replace(re,""); + } + else if (re4.test(w)) + w = w + "e"; + } + } + + // Step 1c + re = /^(.+?)y$/; + if (re.test(w)) { + var fp = re.exec(w); + stem = fp[1]; + re = new RegExp(s_v); + if (re.test(stem)) + w = stem + "i"; + } + + // Step 2 + re = /^(.+?)(ational|tional|enci|anci|izer|bli|alli|entli|eli|ousli|ization|ation|ator|alism|iveness|fulness|ousness|aliti|iviti|biliti|logi)$/; + if (re.test(w)) { + var fp = re.exec(w); + stem = fp[1]; + suffix = fp[2]; + re = new RegExp(mgr0); + if (re.test(stem)) + w = stem + step2list[suffix]; + } + + // Step 3 + re = /^(.+?)(icate|ative|alize|iciti|ical|ful|ness)$/; + if (re.test(w)) { + var fp = re.exec(w); + stem = fp[1]; + suffix = fp[2]; + re = new RegExp(mgr0); + if (re.test(stem)) + w = stem + step3list[suffix]; + } + + // Step 4 + re = /^(.+?)(al|ance|ence|er|ic|able|ible|ant|ement|ment|ent|ou|ism|ate|iti|ous|ive|ize)$/; + re2 = /^(.+?)(s|t)(ion)$/; + if (re.test(w)) { + var fp = re.exec(w); + stem = fp[1]; + re = new RegExp(mgr1); + if (re.test(stem)) + w = stem; + } + else if (re2.test(w)) { + var fp = re2.exec(w); + stem = fp[1] + fp[2]; + re2 = new RegExp(mgr1); + if (re2.test(stem)) + w = stem; + } + + // Step 5 + re = /^(.+?)e$/; + if (re.test(w)) { + var fp = re.exec(w); + stem = fp[1]; + re = new RegExp(mgr1); + re2 = new RegExp(meq1); + re3 = new RegExp("^" + C + v + "[^aeiouwxy]$"); + if (re.test(stem) || (re2.test(stem) && !(re3.test(stem)))) + w = stem; + } + re = /ll$/; + re2 = new RegExp(mgr1); + if (re.test(w) && re2.test(w)) { + re = /.$/; + w = w.replace(re,""); + } + + // and turn initial Y back to y + if (firstch == "y") + w = firstch.toLowerCase() + w.substr(1); + return w; + } +} + diff --git a/_static/minus.png b/_static/minus.png new file mode 100644 index 0000000000000000000000000000000000000000..d96755fdaf8bb2214971e0db9c1fd3077d7c419d GIT binary patch literal 90 zcmeAS@N?(olHy`uVBq!ia0vp^+#t*WBp7;*Yy1LIik>cxAr*|t7R?Mi>2?kWtu=nj kDsEF_5m^0CR;1wuP-*O&G^0G}KYk!hp00i_>zopr08q^qX#fBK literal 0 HcmV?d00001 diff --git a/_static/plus.png b/_static/plus.png new file mode 100644 index 0000000000000000000000000000000000000000..7107cec93a979b9a5f64843235a16651d563ce2d GIT binary patch literal 90 zcmeAS@N?(olHy`uVBq!ia0vp^+#t*WBp7;*Yy1LIik>cxAr*|t7R?Mi>2?kWtu>-2 m3q%Vub%g%s<8sJhVPMczOq}xhg9DJoz~JfX=d#Wzp$Pyb1r*Kz literal 0 HcmV?d00001 diff --git a/_static/pygments.css b/_static/pygments.css new file mode 100644 index 0000000..04a4174 --- /dev/null +++ b/_static/pygments.css @@ -0,0 +1,84 @@ +pre { line-height: 125%; } +td.linenos .normal { color: inherit; background-color: transparent; padding-left: 5px; padding-right: 5px; } +span.linenos { color: inherit; background-color: transparent; padding-left: 5px; padding-right: 5px; } +td.linenos .special { color: #000000; background-color: #ffffc0; padding-left: 5px; padding-right: 5px; } +span.linenos.special { color: #000000; background-color: #ffffc0; padding-left: 5px; padding-right: 5px; } +.highlight .hll { background-color: #ffffcc } +.highlight { background: #f8f8f8; } +.highlight .c { color: #8f5902; font-style: italic } /* Comment */ +.highlight .err { color: #a40000; border: 1px solid #ef2929 } /* Error */ +.highlight .g { color: #000000 } /* Generic */ +.highlight .k { color: #004461; font-weight: bold } /* Keyword */ +.highlight .l { color: #000000 } /* Literal */ +.highlight .n { color: #000000 } /* Name */ +.highlight .o { color: #582800 } /* Operator */ +.highlight .x { color: #000000 } /* Other */ +.highlight .p { color: #000000; font-weight: bold } /* Punctuation */ +.highlight .ch { color: #8f5902; font-style: italic } /* Comment.Hashbang */ +.highlight .cm { color: #8f5902; font-style: italic } /* Comment.Multiline */ +.highlight .cp { color: #8f5902 } /* Comment.Preproc */ +.highlight .cpf { color: #8f5902; font-style: italic } /* Comment.PreprocFile */ +.highlight .c1 { color: #8f5902; font-style: italic } /* Comment.Single */ +.highlight .cs { color: #8f5902; font-style: italic } /* Comment.Special */ +.highlight .gd { color: #a40000 } /* Generic.Deleted */ +.highlight .ge { color: #000000; font-style: italic } /* Generic.Emph */ +.highlight .ges { color: #000000 } /* Generic.EmphStrong */ +.highlight .gr { color: #ef2929 } /* Generic.Error */ +.highlight .gh { color: #000080; font-weight: bold } /* Generic.Heading */ +.highlight .gi { color: #00A000 } /* Generic.Inserted */ +.highlight .go { color: #888888 } /* Generic.Output */ +.highlight .gp { color: #745334 } /* Generic.Prompt */ +.highlight .gs { color: #000000; font-weight: bold } /* Generic.Strong */ +.highlight .gu { color: #800080; font-weight: bold } /* Generic.Subheading */ +.highlight .gt { color: #a40000; font-weight: bold } /* Generic.Traceback */ +.highlight .kc { color: #004461; font-weight: bold } /* Keyword.Constant */ +.highlight .kd { color: #004461; font-weight: bold } /* Keyword.Declaration */ +.highlight .kn { color: #004461; font-weight: bold } /* Keyword.Namespace */ +.highlight .kp { color: #004461; font-weight: bold } /* Keyword.Pseudo */ +.highlight .kr { color: #004461; font-weight: bold } /* Keyword.Reserved */ +.highlight .kt { color: #004461; font-weight: bold } /* Keyword.Type */ +.highlight .ld { color: #000000 } /* Literal.Date */ +.highlight .m { color: #990000 } /* Literal.Number */ +.highlight .s { color: #4e9a06 } /* Literal.String */ +.highlight .na { color: #c4a000 } /* Name.Attribute */ +.highlight .nb { color: #004461 } /* Name.Builtin */ +.highlight .nc { color: #000000 } /* Name.Class */ +.highlight .no { color: #000000 } /* Name.Constant */ +.highlight .nd { color: #888888 } /* Name.Decorator */ +.highlight .ni { color: #ce5c00 } /* Name.Entity */ +.highlight .ne { color: #cc0000; font-weight: bold } /* Name.Exception */ +.highlight .nf { color: #000000 } /* Name.Function */ +.highlight .nl { color: #f57900 } /* Name.Label */ +.highlight .nn { color: #000000 } /* Name.Namespace */ +.highlight .nx { color: #000000 } /* Name.Other */ +.highlight .py { color: #000000 } /* Name.Property */ +.highlight .nt { color: #004461; font-weight: bold } /* Name.Tag */ +.highlight .nv { color: #000000 } /* Name.Variable */ +.highlight .ow { color: #004461; font-weight: bold } /* Operator.Word */ +.highlight .pm { color: #000000; font-weight: bold } /* Punctuation.Marker */ +.highlight .w { color: #f8f8f8 } /* Text.Whitespace */ +.highlight .mb { color: #990000 } /* Literal.Number.Bin */ +.highlight .mf { color: #990000 } /* Literal.Number.Float */ +.highlight .mh { color: #990000 } /* Literal.Number.Hex */ +.highlight .mi { color: #990000 } /* Literal.Number.Integer */ +.highlight .mo { color: #990000 } /* Literal.Number.Oct */ +.highlight .sa { color: #4e9a06 } /* Literal.String.Affix */ +.highlight .sb { color: #4e9a06 } /* Literal.String.Backtick */ +.highlight .sc { color: #4e9a06 } /* Literal.String.Char */ +.highlight .dl { color: #4e9a06 } /* Literal.String.Delimiter */ +.highlight .sd { color: #8f5902; font-style: italic } /* Literal.String.Doc */ +.highlight .s2 { color: #4e9a06 } /* Literal.String.Double */ +.highlight .se { color: #4e9a06 } /* Literal.String.Escape */ +.highlight .sh { color: #4e9a06 } /* Literal.String.Heredoc */ +.highlight .si { color: #4e9a06 } /* Literal.String.Interpol */ +.highlight .sx { color: #4e9a06 } /* Literal.String.Other */ +.highlight .sr { color: #4e9a06 } /* Literal.String.Regex */ +.highlight .s1 { color: #4e9a06 } /* Literal.String.Single */ +.highlight .ss { color: #4e9a06 } /* Literal.String.Symbol */ +.highlight .bp { color: #3465a4 } /* Name.Builtin.Pseudo */ +.highlight .fm { color: #000000 } /* Name.Function.Magic */ +.highlight .vc { color: #000000 } /* Name.Variable.Class */ +.highlight .vg { color: #000000 } /* Name.Variable.Global */ +.highlight .vi { color: #000000 } /* Name.Variable.Instance */ +.highlight .vm { color: #000000 } /* Name.Variable.Magic */ +.highlight .il { color: #990000 } /* Literal.Number.Integer.Long */ \ No newline at end of file diff --git a/_static/searchtools.js b/_static/searchtools.js new file mode 100644 index 0000000..b08d58c --- /dev/null +++ b/_static/searchtools.js @@ -0,0 +1,620 @@ +/* + * searchtools.js + * ~~~~~~~~~~~~~~~~ + * + * Sphinx JavaScript utilities for the full-text search. + * + * :copyright: Copyright 2007-2024 by the Sphinx team, see AUTHORS. + * :license: BSD, see LICENSE for details. + * + */ +"use strict"; + +/** + * Simple result scoring code. + */ +if (typeof Scorer === "undefined") { + var Scorer = { + // Implement the following function to further tweak the score for each result + // The function takes a result array [docname, title, anchor, descr, score, filename] + // and returns the new score. + /* + score: result => { + const [docname, title, anchor, descr, score, filename] = result + return score + }, + */ + + // query matches the full name of an object + objNameMatch: 11, + // or matches in the last dotted part of the object name + objPartialMatch: 6, + // Additive scores depending on the priority of the object + objPrio: { + 0: 15, // used to be importantResults + 1: 5, // used to be objectResults + 2: -5, // used to be unimportantResults + }, + // Used when the priority is not in the mapping. + objPrioDefault: 0, + + // query found in title + title: 15, + partialTitle: 7, + // query found in terms + term: 5, + partialTerm: 2, + }; +} + +const _removeChildren = (element) => { + while (element && element.lastChild) element.removeChild(element.lastChild); +}; + +/** + * See https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions#escaping + */ +const _escapeRegExp = (string) => + string.replace(/[.*+\-?^${}()|[\]\\]/g, "\\$&"); // $& means the whole matched string + +const _displayItem = (item, searchTerms, highlightTerms) => { + const docBuilder = DOCUMENTATION_OPTIONS.BUILDER; + const docFileSuffix = DOCUMENTATION_OPTIONS.FILE_SUFFIX; + const docLinkSuffix = DOCUMENTATION_OPTIONS.LINK_SUFFIX; + const showSearchSummary = DOCUMENTATION_OPTIONS.SHOW_SEARCH_SUMMARY; + const contentRoot = document.documentElement.dataset.content_root; + + const [docName, title, anchor, descr, score, _filename] = item; + + let listItem = document.createElement("li"); + let requestUrl; + let linkUrl; + if (docBuilder === "dirhtml") { + // dirhtml builder + let dirname = docName + "/"; + if (dirname.match(/\/index\/$/)) + dirname = dirname.substring(0, dirname.length - 6); + else if (dirname === "index/") dirname = ""; + requestUrl = contentRoot + dirname; + linkUrl = requestUrl; + } else { + // normal html builders + requestUrl = contentRoot + docName + docFileSuffix; + linkUrl = docName + docLinkSuffix; + } + let linkEl = listItem.appendChild(document.createElement("a")); + linkEl.href = linkUrl + anchor; + linkEl.dataset.score = score; + linkEl.innerHTML = title; + if (descr) { + listItem.appendChild(document.createElement("span")).innerHTML = + " (" + descr + ")"; + // highlight search terms in the description + if (SPHINX_HIGHLIGHT_ENABLED) // set in sphinx_highlight.js + highlightTerms.forEach((term) => _highlightText(listItem, term, "highlighted")); + } + else if (showSearchSummary) + fetch(requestUrl) + .then((responseData) => responseData.text()) + .then((data) => { + if (data) + listItem.appendChild( + Search.makeSearchSummary(data, searchTerms, anchor) + ); + // highlight search terms in the summary + if (SPHINX_HIGHLIGHT_ENABLED) // set in sphinx_highlight.js + highlightTerms.forEach((term) => _highlightText(listItem, term, "highlighted")); + }); + Search.output.appendChild(listItem); +}; +const _finishSearch = (resultCount) => { + Search.stopPulse(); + Search.title.innerText = _("Search Results"); + if (!resultCount) + Search.status.innerText = Documentation.gettext( + "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories." + ); + else + Search.status.innerText = _( + "Search finished, found ${resultCount} page(s) matching the search query." + ).replace('${resultCount}', resultCount); +}; +const _displayNextItem = ( + results, + resultCount, + searchTerms, + highlightTerms, +) => { + // results left, load the summary and display it + // this is intended to be dynamic (don't sub resultsCount) + if (results.length) { + _displayItem(results.pop(), searchTerms, highlightTerms); + setTimeout( + () => _displayNextItem(results, resultCount, searchTerms, highlightTerms), + 5 + ); + } + // search finished, update title and status message + else _finishSearch(resultCount); +}; +// Helper function used by query() to order search results. +// Each input is an array of [docname, title, anchor, descr, score, filename]. +// Order the results by score (in opposite order of appearance, since the +// `_displayNextItem` function uses pop() to retrieve items) and then alphabetically. +const _orderResultsByScoreThenName = (a, b) => { + const leftScore = a[4]; + const rightScore = b[4]; + if (leftScore === rightScore) { + // same score: sort alphabetically + const leftTitle = a[1].toLowerCase(); + const rightTitle = b[1].toLowerCase(); + if (leftTitle === rightTitle) return 0; + return leftTitle > rightTitle ? -1 : 1; // inverted is intentional + } + return leftScore > rightScore ? 1 : -1; +}; + +/** + * Default splitQuery function. Can be overridden in ``sphinx.search`` with a + * custom function per language. + * + * The regular expression works by splitting the string on consecutive characters + * that are not Unicode letters, numbers, underscores, or emoji characters. + * This is the same as ``\W+`` in Python, preserving the surrogate pair area. + */ +if (typeof splitQuery === "undefined") { + var splitQuery = (query) => query + .split(/[^\p{Letter}\p{Number}_\p{Emoji_Presentation}]+/gu) + .filter(term => term) // remove remaining empty strings +} + +/** + * Search Module + */ +const Search = { + _index: null, + _queued_query: null, + _pulse_status: -1, + + htmlToText: (htmlString, anchor) => { + const htmlElement = new DOMParser().parseFromString(htmlString, 'text/html'); + for (const removalQuery of [".headerlink", "script", "style"]) { + htmlElement.querySelectorAll(removalQuery).forEach((el) => { el.remove() }); + } + if (anchor) { + const anchorContent = htmlElement.querySelector(`[role="main"] ${anchor}`); + if (anchorContent) return anchorContent.textContent; + + console.warn( + `Anchored content block not found. Sphinx search tries to obtain it via DOM query '[role=main] ${anchor}'. Check your theme or template.` + ); + } + + // if anchor not specified or not found, fall back to main content + const docContent = htmlElement.querySelector('[role="main"]'); + if (docContent) return docContent.textContent; + + console.warn( + "Content block not found. Sphinx search tries to obtain it via DOM query '[role=main]'. Check your theme or template." + ); + return ""; + }, + + init: () => { + const query = new URLSearchParams(window.location.search).get("q"); + document + .querySelectorAll('input[name="q"]') + .forEach((el) => (el.value = query)); + if (query) Search.performSearch(query); + }, + + loadIndex: (url) => + (document.body.appendChild(document.createElement("script")).src = url), + + setIndex: (index) => { + Search._index = index; + if (Search._queued_query !== null) { + const query = Search._queued_query; + Search._queued_query = null; + Search.query(query); + } + }, + + hasIndex: () => Search._index !== null, + + deferQuery: (query) => (Search._queued_query = query), + + stopPulse: () => (Search._pulse_status = -1), + + startPulse: () => { + if (Search._pulse_status >= 0) return; + + const pulse = () => { + Search._pulse_status = (Search._pulse_status + 1) % 4; + Search.dots.innerText = ".".repeat(Search._pulse_status); + if (Search._pulse_status >= 0) window.setTimeout(pulse, 500); + }; + pulse(); + }, + + /** + * perform a search for something (or wait until index is loaded) + */ + performSearch: (query) => { + // create the required interface elements + const searchText = document.createElement("h2"); + searchText.textContent = _("Searching"); + const searchSummary = document.createElement("p"); + searchSummary.classList.add("search-summary"); + searchSummary.innerText = ""; + const searchList = document.createElement("ul"); + searchList.classList.add("search"); + + const out = document.getElementById("search-results"); + Search.title = out.appendChild(searchText); + Search.dots = Search.title.appendChild(document.createElement("span")); + Search.status = out.appendChild(searchSummary); + Search.output = out.appendChild(searchList); + + const searchProgress = document.getElementById("search-progress"); + // Some themes don't use the search progress node + if (searchProgress) { + searchProgress.innerText = _("Preparing search..."); + } + Search.startPulse(); + + // index already loaded, the browser was quick! + if (Search.hasIndex()) Search.query(query); + else Search.deferQuery(query); + }, + + _parseQuery: (query) => { + // stem the search terms and add them to the correct list + const stemmer = new Stemmer(); + const searchTerms = new Set(); + const excludedTerms = new Set(); + const highlightTerms = new Set(); + const objectTerms = new Set(splitQuery(query.toLowerCase().trim())); + splitQuery(query.trim()).forEach((queryTerm) => { + const queryTermLower = queryTerm.toLowerCase(); + + // maybe skip this "word" + // stopwords array is from language_data.js + if ( + stopwords.indexOf(queryTermLower) !== -1 || + queryTerm.match(/^\d+$/) + ) + return; + + // stem the word + let word = stemmer.stemWord(queryTermLower); + // select the correct list + if (word[0] === "-") excludedTerms.add(word.substr(1)); + else { + searchTerms.add(word); + highlightTerms.add(queryTermLower); + } + }); + + if (SPHINX_HIGHLIGHT_ENABLED) { // set in sphinx_highlight.js + localStorage.setItem("sphinx_highlight_terms", [...highlightTerms].join(" ")) + } + + // console.debug("SEARCH: searching for:"); + // console.info("required: ", [...searchTerms]); + // console.info("excluded: ", [...excludedTerms]); + + return [query, searchTerms, excludedTerms, highlightTerms, objectTerms]; + }, + + /** + * execute search (requires search index to be loaded) + */ + _performSearch: (query, searchTerms, excludedTerms, highlightTerms, objectTerms) => { + const filenames = Search._index.filenames; + const docNames = Search._index.docnames; + const titles = Search._index.titles; + const allTitles = Search._index.alltitles; + const indexEntries = Search._index.indexentries; + + // Collect multiple result groups to be sorted separately and then ordered. + // Each is an array of [docname, title, anchor, descr, score, filename]. + const normalResults = []; + const nonMainIndexResults = []; + + _removeChildren(document.getElementById("search-progress")); + + const queryLower = query.toLowerCase().trim(); + for (const [title, foundTitles] of Object.entries(allTitles)) { + if (title.toLowerCase().trim().includes(queryLower) && (queryLower.length >= title.length/2)) { + for (const [file, id] of foundTitles) { + const score = Math.round(Scorer.title * queryLower.length / title.length); + const boost = titles[file] === title ? 1 : 0; // add a boost for document titles + normalResults.push([ + docNames[file], + titles[file] !== title ? `${titles[file]} > ${title}` : title, + id !== null ? "#" + id : "", + null, + score + boost, + filenames[file], + ]); + } + } + } + + // search for explicit entries in index directives + for (const [entry, foundEntries] of Object.entries(indexEntries)) { + if (entry.includes(queryLower) && (queryLower.length >= entry.length/2)) { + for (const [file, id, isMain] of foundEntries) { + const score = Math.round(100 * queryLower.length / entry.length); + const result = [ + docNames[file], + titles[file], + id ? "#" + id : "", + null, + score, + filenames[file], + ]; + if (isMain) { + normalResults.push(result); + } else { + nonMainIndexResults.push(result); + } + } + } + } + + // lookup as object + objectTerms.forEach((term) => + normalResults.push(...Search.performObjectSearch(term, objectTerms)) + ); + + // lookup as search terms in fulltext + normalResults.push(...Search.performTermsSearch(searchTerms, excludedTerms)); + + // let the scorer override scores with a custom scoring function + if (Scorer.score) { + normalResults.forEach((item) => (item[4] = Scorer.score(item))); + nonMainIndexResults.forEach((item) => (item[4] = Scorer.score(item))); + } + + // Sort each group of results by score and then alphabetically by name. + normalResults.sort(_orderResultsByScoreThenName); + nonMainIndexResults.sort(_orderResultsByScoreThenName); + + // Combine the result groups in (reverse) order. + // Non-main index entries are typically arbitrary cross-references, + // so display them after other results. + let results = [...nonMainIndexResults, ...normalResults]; + + // remove duplicate search results + // note the reversing of results, so that in the case of duplicates, the highest-scoring entry is kept + let seen = new Set(); + results = results.reverse().reduce((acc, result) => { + let resultStr = result.slice(0, 4).concat([result[5]]).map(v => String(v)).join(','); + if (!seen.has(resultStr)) { + acc.push(result); + seen.add(resultStr); + } + return acc; + }, []); + + return results.reverse(); + }, + + query: (query) => { + const [searchQuery, searchTerms, excludedTerms, highlightTerms, objectTerms] = Search._parseQuery(query); + const results = Search._performSearch(searchQuery, searchTerms, excludedTerms, highlightTerms, objectTerms); + + // for debugging + //Search.lastresults = results.slice(); // a copy + // console.info("search results:", Search.lastresults); + + // print the results + _displayNextItem(results, results.length, searchTerms, highlightTerms); + }, + + /** + * search for object names + */ + performObjectSearch: (object, objectTerms) => { + const filenames = Search._index.filenames; + const docNames = Search._index.docnames; + const objects = Search._index.objects; + const objNames = Search._index.objnames; + const titles = Search._index.titles; + + const results = []; + + const objectSearchCallback = (prefix, match) => { + const name = match[4] + const fullname = (prefix ? prefix + "." : "") + name; + const fullnameLower = fullname.toLowerCase(); + if (fullnameLower.indexOf(object) < 0) return; + + let score = 0; + const parts = fullnameLower.split("."); + + // check for different match types: exact matches of full name or + // "last name" (i.e. last dotted part) + if (fullnameLower === object || parts.slice(-1)[0] === object) + score += Scorer.objNameMatch; + else if (parts.slice(-1)[0].indexOf(object) > -1) + score += Scorer.objPartialMatch; // matches in last name + + const objName = objNames[match[1]][2]; + const title = titles[match[0]]; + + // If more than one term searched for, we require other words to be + // found in the name/title/description + const otherTerms = new Set(objectTerms); + otherTerms.delete(object); + if (otherTerms.size > 0) { + const haystack = `${prefix} ${name} ${objName} ${title}`.toLowerCase(); + if ( + [...otherTerms].some((otherTerm) => haystack.indexOf(otherTerm) < 0) + ) + return; + } + + let anchor = match[3]; + if (anchor === "") anchor = fullname; + else if (anchor === "-") anchor = objNames[match[1]][1] + "-" + fullname; + + const descr = objName + _(", in ") + title; + + // add custom score for some objects according to scorer + if (Scorer.objPrio.hasOwnProperty(match[2])) + score += Scorer.objPrio[match[2]]; + else score += Scorer.objPrioDefault; + + results.push([ + docNames[match[0]], + fullname, + "#" + anchor, + descr, + score, + filenames[match[0]], + ]); + }; + Object.keys(objects).forEach((prefix) => + objects[prefix].forEach((array) => + objectSearchCallback(prefix, array) + ) + ); + return results; + }, + + /** + * search for full-text terms in the index + */ + performTermsSearch: (searchTerms, excludedTerms) => { + // prepare search + const terms = Search._index.terms; + const titleTerms = Search._index.titleterms; + const filenames = Search._index.filenames; + const docNames = Search._index.docnames; + const titles = Search._index.titles; + + const scoreMap = new Map(); + const fileMap = new Map(); + + // perform the search on the required terms + searchTerms.forEach((word) => { + const files = []; + const arr = [ + { files: terms[word], score: Scorer.term }, + { files: titleTerms[word], score: Scorer.title }, + ]; + // add support for partial matches + if (word.length > 2) { + const escapedWord = _escapeRegExp(word); + if (!terms.hasOwnProperty(word)) { + Object.keys(terms).forEach((term) => { + if (term.match(escapedWord)) + arr.push({ files: terms[term], score: Scorer.partialTerm }); + }); + } + if (!titleTerms.hasOwnProperty(word)) { + Object.keys(titleTerms).forEach((term) => { + if (term.match(escapedWord)) + arr.push({ files: titleTerms[term], score: Scorer.partialTitle }); + }); + } + } + + // no match but word was a required one + if (arr.every((record) => record.files === undefined)) return; + + // found search word in contents + arr.forEach((record) => { + if (record.files === undefined) return; + + let recordFiles = record.files; + if (recordFiles.length === undefined) recordFiles = [recordFiles]; + files.push(...recordFiles); + + // set score for the word in each file + recordFiles.forEach((file) => { + if (!scoreMap.has(file)) scoreMap.set(file, {}); + scoreMap.get(file)[word] = record.score; + }); + }); + + // create the mapping + files.forEach((file) => { + if (!fileMap.has(file)) fileMap.set(file, [word]); + else if (fileMap.get(file).indexOf(word) === -1) fileMap.get(file).push(word); + }); + }); + + // now check if the files don't contain excluded terms + const results = []; + for (const [file, wordList] of fileMap) { + // check if all requirements are matched + + // as search terms with length < 3 are discarded + const filteredTermCount = [...searchTerms].filter( + (term) => term.length > 2 + ).length; + if ( + wordList.length !== searchTerms.size && + wordList.length !== filteredTermCount + ) + continue; + + // ensure that none of the excluded terms is in the search result + if ( + [...excludedTerms].some( + (term) => + terms[term] === file || + titleTerms[term] === file || + (terms[term] || []).includes(file) || + (titleTerms[term] || []).includes(file) + ) + ) + break; + + // select one (max) score for the file. + const score = Math.max(...wordList.map((w) => scoreMap.get(file)[w])); + // add result to the result list + results.push([ + docNames[file], + titles[file], + "", + null, + score, + filenames[file], + ]); + } + return results; + }, + + /** + * helper function to return a node containing the + * search summary for a given text. keywords is a list + * of stemmed words. + */ + makeSearchSummary: (htmlText, keywords, anchor) => { + const text = Search.htmlToText(htmlText, anchor); + if (text === "") return null; + + const textLower = text.toLowerCase(); + const actualStartPosition = [...keywords] + .map((k) => textLower.indexOf(k.toLowerCase())) + .filter((i) => i > -1) + .slice(-1)[0]; + const startWithContext = Math.max(actualStartPosition - 120, 0); + + const top = startWithContext === 0 ? "" : "..."; + const tail = startWithContext + 240 < text.length ? "..." : ""; + + let summary = document.createElement("p"); + summary.classList.add("context"); + summary.textContent = top + text.substr(startWithContext, 240).trim() + tail; + + return summary; + }, +}; + +_ready(Search.init); diff --git a/_static/sphinx_highlight.js b/_static/sphinx_highlight.js new file mode 100644 index 0000000..8a96c69 --- /dev/null +++ b/_static/sphinx_highlight.js @@ -0,0 +1,154 @@ +/* Highlighting utilities for Sphinx HTML documentation. */ +"use strict"; + +const SPHINX_HIGHLIGHT_ENABLED = true + +/** + * highlight a given string on a node by wrapping it in + * span elements with the given class name. + */ +const _highlight = (node, addItems, text, className) => { + if (node.nodeType === Node.TEXT_NODE) { + const val = node.nodeValue; + const parent = node.parentNode; + const pos = val.toLowerCase().indexOf(text); + if ( + pos >= 0 && + !parent.classList.contains(className) && + !parent.classList.contains("nohighlight") + ) { + let span; + + const closestNode = parent.closest("body, svg, foreignObject"); + const isInSVG = closestNode && closestNode.matches("svg"); + if (isInSVG) { + span = document.createElementNS("http://www.w3.org/2000/svg", "tspan"); + } else { + span = document.createElement("span"); + span.classList.add(className); + } + + span.appendChild(document.createTextNode(val.substr(pos, text.length))); + const rest = document.createTextNode(val.substr(pos + text.length)); + parent.insertBefore( + span, + parent.insertBefore( + rest, + node.nextSibling + ) + ); + node.nodeValue = val.substr(0, pos); + /* There may be more occurrences of search term in this node. So call this + * function recursively on the remaining fragment. + */ + _highlight(rest, addItems, text, className); + + if (isInSVG) { + const rect = document.createElementNS( + "http://www.w3.org/2000/svg", + "rect" + ); + const bbox = parent.getBBox(); + rect.x.baseVal.value = bbox.x; + rect.y.baseVal.value = bbox.y; + rect.width.baseVal.value = bbox.width; + rect.height.baseVal.value = bbox.height; + rect.setAttribute("class", className); + addItems.push({ parent: parent, target: rect }); + } + } + } else if (node.matches && !node.matches("button, select, textarea")) { + node.childNodes.forEach((el) => _highlight(el, addItems, text, className)); + } +}; +const _highlightText = (thisNode, text, className) => { + let addItems = []; + _highlight(thisNode, addItems, text, className); + addItems.forEach((obj) => + obj.parent.insertAdjacentElement("beforebegin", obj.target) + ); +}; + +/** + * Small JavaScript module for the documentation. + */ +const SphinxHighlight = { + + /** + * highlight the search words provided in localstorage in the text + */ + highlightSearchWords: () => { + if (!SPHINX_HIGHLIGHT_ENABLED) return; // bail if no highlight + + // get and clear terms from localstorage + const url = new URL(window.location); + const highlight = + localStorage.getItem("sphinx_highlight_terms") + || url.searchParams.get("highlight") + || ""; + localStorage.removeItem("sphinx_highlight_terms") + url.searchParams.delete("highlight"); + window.history.replaceState({}, "", url); + + // get individual terms from highlight string + const terms = highlight.toLowerCase().split(/\s+/).filter(x => x); + if (terms.length === 0) return; // nothing to do + + // There should never be more than one element matching "div.body" + const divBody = document.querySelectorAll("div.body"); + const body = divBody.length ? divBody[0] : document.querySelector("body"); + window.setTimeout(() => { + terms.forEach((term) => _highlightText(body, term, "highlighted")); + }, 10); + + const searchBox = document.getElementById("searchbox"); + if (searchBox === null) return; + searchBox.appendChild( + document + .createRange() + .createContextualFragment( + '

' + + '' + + _("Hide Search Matches") + + "

" + ) + ); + }, + + /** + * helper function to hide the search marks again + */ + hideSearchWords: () => { + document + .querySelectorAll("#searchbox .highlight-link") + .forEach((el) => el.remove()); + document + .querySelectorAll("span.highlighted") + .forEach((el) => el.classList.remove("highlighted")); + localStorage.removeItem("sphinx_highlight_terms") + }, + + initEscapeListener: () => { + // only install a listener if it is really needed + if (!DOCUMENTATION_OPTIONS.ENABLE_SEARCH_SHORTCUTS) return; + + document.addEventListener("keydown", (event) => { + // bail for input elements + if (BLACKLISTED_KEY_CONTROL_ELEMENTS.has(document.activeElement.tagName)) return; + // bail with special keys + if (event.shiftKey || event.altKey || event.ctrlKey || event.metaKey) return; + if (DOCUMENTATION_OPTIONS.ENABLE_SEARCH_SHORTCUTS && (event.key === "Escape")) { + SphinxHighlight.hideSearchWords(); + event.preventDefault(); + } + }); + }, +}; + +_ready(() => { + /* Do not call highlightSearchWords() when we are on the search page. + * It will highlight words from the *previous* search query. + */ + if (typeof Search === "undefined") SphinxHighlight.highlightSearchWords(); + SphinxHighlight.initEscapeListener(); +}); diff --git a/genindex.html b/genindex.html new file mode 100644 index 0000000..e255425 --- /dev/null +++ b/genindex.html @@ -0,0 +1,128 @@ + + + + + + + Index — A Shaderboy's Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+
+ + +
+ + +

Index

+ +
+ +
+ + +
+
+   + +
+ +
+
+
+
+
+ ©2024, papadanku. + + | + Powered by Sphinx 8.0.2 + & Alabaster 1.0.0 + +
+ + + + + + \ No newline at end of file diff --git a/index.html b/index.html new file mode 100644 index 0000000..4c4b1f9 --- /dev/null +++ b/index.html @@ -0,0 +1,163 @@ + + + + + + + + Homepage — A Shaderboy's Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+
+ + +
+ +
+

Homepage

+
+

Content Creation Guide

+ +
+
+

Graphics Programming Blog

+ +
+
+ + +
+
+   + +
+ +
+
+
+
+
+ ©2024, papadanku. + + | + Powered by Sphinx 8.0.2 + & Alabaster 1.0.0 + + | + Page source +
+ + + + + + \ No newline at end of file diff --git a/objects.inv b/objects.inv new file mode 100644 index 0000000..09ebd69 --- /dev/null +++ b/objects.inv @@ -0,0 +1,6 @@ +# Sphinx inventory version 2 +# Project: A Shaderboy's Collection +# Version: +# The remainder of this file is compressed using zlib. +xڅn0 } +݋r-ifXMGflm(P2{=hK ZlK4Th-q|( ѨɕE>ugd%hXR*_l & N.dzb*Ɵyj˵@u[rH{Q3 Mno:j \ Zv5+7MH]oErHV-Vc vY@ìX"@@@EV򵚩g0yl\\kgB { vmZ΁ > ߳.{}7ʩȯD>TK4P>mʁX%C'h lv P_QP "'@j1 fc-H3XzQuNmZ)\wjs$۷ 3;c_?Y~F&ltncJ}C)yuapս}Wr{n';4vIK Vw#RF⃔z-KrilIݼyuh2FV}6dz*4Km}Ԍ;`ɥe9Ij!%% vm$Wj_/-n \ No newline at end of file diff --git a/search.html b/search.html new file mode 100644 index 0000000..93dbf49 --- /dev/null +++ b/search.html @@ -0,0 +1,146 @@ + + + + + + + Search — A Shaderboy's Collection documentation + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+
+ + +
+ +

Search

+ + + + +

+ Searching for multiple words only shows matches that contain + all words. +

+ + +
+ + + +
+ + +
+ + +
+
+   + +
+ +
+
+
+
+
+ ©2024, papadanku. + + | + Powered by Sphinx 8.0.2 + & Alabaster 1.0.0 + +
+ + + + + + \ No newline at end of file diff --git a/searchindex.js b/searchindex.js new file mode 100644 index 0000000..04c8749 --- /dev/null +++ b/searchindex.js @@ -0,0 +1 @@ +Search.setIndex({"alltitles": {"A Pythonic 3D Engine in 1 Weekend": [[11, null]], "Abstract Classes": [[5, "abstract-classes"]], "Account": [[15, "account"]], "Account Requirements": [[17, "account-requirements"]], "Algorithm": [[9, "algorithm"]], "Arrays": [[5, "arrays"]], "Arrays (2D)": [[5, "arrays-2d"]], "Bilinear Sobel Filtering in HLSL": [[14, null]], "Casting": [[5, "casting"]], "Census Transform in HLSL": [[2, null]], "Chromaticity in HLSL": [[3, null]], "Classes": [[5, "classes"]], "Constants": [[5, "constants"]], "Constructors": [[5, "constructors"]], "Content Creation Guide": [[0, null]], "Coordinate Spaces": [[4, "id1"]], "Coordinate Spaces: A Refresher": [[4, null]], "Correcting Outerra\u2019s Logarithmic Depth Buffering": [[10, null]], "Downloads": [[16, "downloads"]], "Exceptions": [[5, "exceptions"]], "Feedback": [[11, "feedback"]], "Fogging": [[13, "fogging"]], "For Loops": [[5, "for-loops"]], "Formulas": [[3, "formulas"]], "Functions": [[5, "functions"]], "Getters & Setters": [[5, "getters-setters"]], "GiraffeAcademy\u2019s C++ Examples": [[5, null]], "Graphics Programming Blog": [[0, null]], "Homepage": [[0, null]], "If Statements": [[5, "if-statements"]], "Inheritance": [[5, "inheritance"]], "Input Register Format": [[13, "input-register-format"]], "Instagram": [[15, null]], "Logarithmic Depth Buffering in HLSL": [[7, null]], "Lucas-Kanade Optical Flow in HLSL": [[9, null]], "Normalized Chromaticity": [[3, "normalized-chromaticity"]], "Numbers": [[5, "numbers"]], "Output Register Count": [[13, "output-register-count"]], "Personal Project": [[16, null]], "Pointers": [[5, "pointers"]], "Posts": [[15, "posts"]], "Precision Loss in RG Chromaticity": [[3, "precision-loss-in-rg-chromaticity"]], "Printing": [[5, "printing"]], "Project Reality: Shader Model 3.0 Considerations": [[13, null]], "RasterGrid\u2019s Gaussian Blur in HLSL": [[6, null]], "ReShadeFX for Beginners": [[12, null]], "Recommendation": [[11, "recommendation"]], "Register Assignments and Declarations": [[13, "register-assignments-and-declarations"]], "Requirements": [[15, "requirements"], [15, "id1"]], "Source Code": [[1, "source-code"], [2, "source-code"], [3, "source-code"], [3, "id1"], [6, "source-code"], [7, "source-code"], [8, "source-code"], [9, "source-code"], [10, "source-code"], [14, "source-code"]], "Spherical Chromaticity": [[3, "spherical-chromaticity"]], "Strings": [[5, "strings"]], "Switch Statements": [[5, "switch-statements"]], "Templates": [[15, "templates"]], "Temporal Auto-Exposure with Hardware Blending": [[1, null]], "Tools": [[16, "tools"]], "Turning a Nested 2D Loop into 1D": [[8, null]], "Uploading Images": [[15, "uploading-images"]], "Useful Commands": [[16, "useful-commands"]], "User Input": [[5, "user-input"]], "Variables": [[5, "variables"]], "Vectors": [[5, "vectors"]], "Video 1: Main Tutorial": [[11, "video-1-main-tutorial"]], "Video 2: SkyBox, Environment Mapping": [[11, "video-2-skybox-environment-mapping"]], "Video 3: Shadow Mapping, PCF": [[11, "video-3-shadow-mapping-pcf"]], "Video Requirements": [[17, "video-requirements"]], "Video Template": [[17, "video-template"]], "What is a Shader?": [[12, "what-is-a-shader"]], "While Loops": [[5, "while-loops"]], "YouTube": [[17, null]], "Your First Pixel Shader": [[12, "your-first-pixel-shader"]], "Your First Technique": [[12, "your-first-technique"]], "Your First Vertex Shader": [[12, "your-first-vertex-shader"]], "yt-dlp": [[16, "id1"]]}, "docnames": ["index", "source/blog/autoexposure", "source/blog/censustransform", "source/blog/chromaticity", "source/blog/coordinatespaces", "source/blog/cpp", "source/blog/gaussianblur", "source/blog/logdepth", "source/blog/loops", "source/blog/opticalflow", "source/blog/outerralogdepth", "source/blog/pythonengine", "source/blog/reshadefx", "source/blog/shadermodel3", "source/blog/sobel", "source/social/instagram", "source/social/project", "source/social/youtube"], "envversion": {"sphinx": 63, "sphinx.domains.c": 3, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 9, "sphinx.domains.index": 1, "sphinx.domains.javascript": 3, "sphinx.domains.math": 2, "sphinx.domains.python": 4, "sphinx.domains.rst": 2, "sphinx.domains.std": 2}, "filenames": ["index.rst", "source/blog/autoexposure.rst", "source/blog/censustransform.rst", "source/blog/chromaticity.rst", "source/blog/coordinatespaces.rst", "source/blog/cpp.rst", "source/blog/gaussianblur.rst", "source/blog/logdepth.rst", "source/blog/loops.rst", "source/blog/opticalflow.rst", "source/blog/outerralogdepth.rst", "source/blog/pythonengine.rst", "source/blog/reshadefx.rst", "source/blog/shadermodel3.rst", "source/blog/sobel.rst", "source/social/instagram.rst", "source/social/project.rst", "source/social/youtube.rst"], "indexentries": {}, "objects": {}, "objnames": {}, "objtypes": {}, "terms": {"": [0, 2, 3, 7, 9, 11, 12, 17], "0": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 12, 14, 17], "00": 17, "00000": 9, "0000000": 2, "000000000": 9, "00am": 17, "01": 1, "01234": 5, "07": 7, "09": 1, "1": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 12, 13, 15, 17], "10": [3, 5, 9], "100": [1, 3, 5], "10000": [7, 10], "1109": [3, 9], "11111111": 2, "12": [1, 13, 17], "14": 5, "1415926535897932384626433832795f": 6, "1421433": [3, 9], "15": [5, 9], "16": 5, "1945": 5, "1988": 5, "1d": 0, "1e": [1, 10], "1st": 5, "2": [1, 2, 3, 5, 6, 8, 9, 12, 13, 17], "20": 5, "2004": [3, 9], "2006": 9, "2013": 7, "2016": 1, "23": 5, "2d": 0, "2j17wk": 12, "2nd": 5, "3": [0, 1, 2, 3, 5, 6, 7, 8, 9, 12, 15, 17], "30": 5, "32": 5, "39": 9, "3d": 0, "3x3": 8, "4": [2, 5, 8, 14], "40": 5, "4138051_robust_optical_flow_from_photometric_invari": [3, 9], "42": 5, "45": 9, "5": [1, 2, 3, 5, 8, 9, 14, 15, 17], "50": 5, "55": 5, "5f": 5, "5l": 5, "6": [2, 5, 8, 10], "60": 5, "64": 5, "7": [2, 7, 8], "8": [2, 5, 8, 13, 14], "90": 5, "99": [1, 5], "A": [0, 5, 9, 12, 14], "As": [2, 11], "At": [15, 17], "For": [3, 13, 17], "IT": 9, "If": [12, 13], "In": [3, 5, 8, 12, 13], "No": [12, 15, 17], "On": 4, "One": 5, "The": [2, 5, 7, 9, 11, 12, 13, 14], "To": 12, "_": 5, "__init__": 5, "_frametim": 1, "_manualbia": 1, "_smoothingspe": 1, "_worldviewproj": 7, "a11": 9, "a12": 9, "a21": 9, "a22": 9, "a_slightly_faster_bufferless_vertex_shader_trick": 12, "ab": [3, 9], "about": [11, 13, 15, 17], "ac": 9, "aco": [3, 9], "across": 17, "actual": 2, "ad": 5, "add": [1, 3, 11, 13], "adddress": 5, "addnumb": 5, "address": 5, "adipisc": [15, 17], "adopt": 11, "ag": 5, "age0": 5, "age1": 5, "age2": 5, "age3": 5, "algorithm": 3, "aliqua": [15, 17], "all": [2, 3, 5, 12, 17], "alloc": 11, "along": 12, "alreadi": [11, 17], "also": [11, 12], "alter": 6, "altern": 17, "amet": [15, 17], "an": [5, 7, 8, 9], "angela": 5, "angl": [3, 9], "angleshift": 9, "ani": [3, 13], "anoth": 1, "answer": 5, "app2ps_projectroad": 13, "app2v": [1, 7], "append": 5, "appli": 13, "applyautoexposur": 1, "applylogarithmicdepth": 7, "appropri": 17, "ar": [5, 11, 12, 13, 17], "arithmet": 5, "around": 14, "articl": 6, "asin": [3, 9], "asm": 13, "associ": 17, "atleast": 5, "audio": [16, 17], "author": [3, 5, 9, 17], "auto": 0, "autoexposur": 1, "automat": [1, 10], "avail": 13, "averag": [1, 2], "axi": 4, "b": [1, 2, 3, 5, 9, 12, 14], "b1": 9, "b2": 9, "ba": 16, "base": [3, 9, 11], "basi": 4, "basic": [5, 11], "becaus": [10, 13], "befor": 17, "begin": 5, "beginn": 0, "behavior": 3, "being": 11, "believ": 11, "best": [11, 16], "between": [3, 6, 9, 12, 14], "beyond": 12, "bia": [1, 9], "bicycl": 5, "bilinear": [0, 9], "binari": 2, "birth_year": 5, "bit": [2, 5, 9, 13], "blend": 0, "blenden": 1, "blendop": 1, "blog": 17, "blogspot": 7, "blue": [1, 3], "blur": [0, 9], "book": 5, "book1": 5, "book2": 5, "bool": 5, "boolean": 5, "bottom": 12, "bottura": 5, "break": 5, "bright": 1, "buffer": [0, 3, 11], "build": 9, "bullshit": 12, "bv": 16, "c": [0, 9, 13, 14], "c0": 13, "c1": 13, "c2": 13, "calcul": [3, 8, 9, 12], "camelcas": 5, "camera": 11, "can": [1, 3, 5, 7, 8, 11, 13, 14], "case": [5, 17], "cat": 5, "catch": 5, "categori": 17, "censu": 0, "center": [2, 4, 6, 14], "centersampl": 2, "cerr": 5, "certain": 13, "chang": [5, 9], "channel": [2, 3, 17], "char": 5, "charact": 5, "chef": 5, "chicken": 5, "chromat": [0, 9], "cin": 5, "claim": 17, "clamp": 9, "clip": 12, "cmath_gethalfmax": 9, "cmath_getrotationmatrix": 9, "cmath_halftonorm": 9, "cmath_normtohalf": 9, "cmotionestimation_getpixelpylk": 9, "cmotionestimation_normalizemv": 9, "cmotionestimation_unnormalizemv": 9, "code": [11, 12], "coder": 11, "color": [1, 2, 3, 7, 9, 12, 13], "color0": [1, 13], "column": 5, "columntex": 2, "com": [1, 7, 12], "comment": 12, "commerci": 17, "compar": 5, "comparison": [2, 5], "compat": 9, "compon": 1, "composit": 16, "compress": 9, "comput": [1, 3, 9, 10], "connect": 12, "consectetur": [15, 17], "consider": 0, "consist": 9, "const": [2, 3, 5, 6, 7, 8, 9, 10], "constant": 13, "constant0": 13, "constant1": 13, "constant2": 13, "construct": 5, "constuctor": 5, "contact": 17, "contain": 9, "content": [15, 17], "convent": 5, "convers": 16, "convert": [2, 7, 9], "coordin": [0, 9, 12, 13], "copi": 5, "correct": [0, 11], "countryoforigin": 5, "cout": 5, "cover": [7, 9, 11, 12], "cpu": [11, 12], "craft": 11, "creat": [5, 9, 11], "creator": 15, "crop": 15, "cse": 9, "cube": 11, "current": [1, 9], "d": [5, 9, 14], "data": [3, 5, 8, 9, 11, 12, 13], "datatyp": 5, "davinci": 16, "dcl_position0": 13, "ddx": 9, "ddy": 9, "de": [3, 9], "declar": 5, "def": 5, "default": 5, "defer": 11, "defin": [4, 5], "definit": 17, "delai": 1, "depend": 2, "depth": 0, "derefer": 5, "describ": [3, 9], "descript": [15, 17], "desktop": 16, "destblend": 1, "detect": 9, "determin": 9, "dice": 13, "did": 6, "didn": 13, "differ": [13, 15, 17], "difficult": 11, "direct": 4, "directli": 5, "disclaim": 17, "dish": 5, "distribut": 9, "divid": [3, 10], "divis": 5, "divisor": 3, "do": [1, 5, 7, 12, 13, 15, 17], "doe": [2, 12], "doi": [3, 9], "dolor": [15, 17], "dot": [3, 9, 12], "doubl": 5, "dp3": 3, "draw": 12, "drawback": 3, "dui": 17, "e": 9, "each": [2, 9, 12, 13], "edit": 16, "effect": 9, "eiusmod": [15, 17], "elimin": 3, "elit": [15, 17], "els": 5, "encod": [3, 9], "encount": 13, "end": 10, "endl": 5, "engin": 0, "enjoy": 11, "enter": 5, "entir": [3, 12], "equal": 2, "error": 5, "especi": 17, "essenti": 9, "estim": 9, "et": [15, 17], "ev100": 1, "even": 6, "event": 17, "everi": 12, "ew": 9, "exampl": [0, 8, 13], "exampleshad": 12, "execut": 5, "exp": [1, 6], "exp2": [1, 2, 9], "experi": 11, "expon": 9, "exponentbit": 9, "expos": 5, "exposur": 0, "extend": 5, "extenion": 5, "extern": 11, "f": [5, 16], "face": [4, 11], "fail": 5, "fals": 5, "farplan": [7, 10], "fcoef": [7, 10], "feel": 17, "fetch": [5, 9, 14], "ffmpeg": 16, "file": 16, "filter": [0, 2, 9, 15], "find": 5, "first": [5, 6, 11], "fit": 3, "fix": 13, "float": [1, 2, 3, 5, 6, 7, 9, 10], "float2": [1, 2, 3, 6, 8, 9, 12, 14], "float2x2": 9, "float3": [1, 2, 3, 9, 13], "float4": [1, 2, 6, 7, 9, 12, 13, 14], "float4x4": 7, "flow": [0, 3], "fly": 5, "follow": [3, 9, 11, 13, 17], "format": 9, "forward": 5, "found": 11, "frac": 3, "fragment": [7, 12], "frame": 9, "free": 17, "fridai": 17, "friend": 5, "from": [1, 2, 3, 5, 8, 9, 11, 12, 13, 16, 17], "function": [9, 12, 13], "fundament": 11, "g": [1, 2, 3, 9, 12], "gamedev": 12, "gamma": 11, "gaussian": [0, 9], "gave": 13, "gener": [1, 2, 9, 11, 12, 17], "generateaverageluma": 1, "geometri": 11, "get": [1, 5, 6, 8, 9, 11, 12], "getauthor": 5, "getautoexposur": 1, "getcensustransform": 2, "getdescript": 5, "getgaussianblur": 6, "getgaussianoffset": 6, "getgaussianweight": 6, "getgreyscal": 2, "getrgbchromat": 3, "getsobel": 14, "getsphericalrg": [3, 9], "gettitl": 5, "gever": [3, 9], "giraffeacademi": 0, "glsl": [7, 10], "gordon": 5, "gpa0": 5, "gpa1": 5, "gpa2": 5, "gpu": [7, 8, 10, 11, 12], "grade": 5, "gradient": 9, "graphic": [1, 11, 13], "greater": 2, "green": [1, 3, 12], "greet": 5, "ha": [7, 10], "half": [3, 9], "half2": 9, "halfmax": 9, "halfpi": [3, 9], "happen": [3, 7], "hardwar": 0, "harri": 5, "hashtag": [15, 17], "hashtag1": [15, 17], "hashtag2": [15, 17], "hashtag3": [15, 17], "have": [1, 11, 12, 13], "height": 9, "hello": 5, "here": [1, 7, 12, 13], "high": 17, "highest": 1, "hlsl": [0, 10], "holidai": 17, "homogen": 10, "how": [8, 11, 12], "howev": [8, 10, 11], "hpo": [1, 7, 10, 13], "html": 7, "http": [1, 3, 7, 9, 12, 17], "huji": 9, "i": [2, 3, 5, 6, 7, 8, 9, 10, 11, 13, 14, 15, 17], "i0": 9, "i1": 9, "icip": [3, 9], "id": 12, "ii": [9, 14], "il": 9, "illumin": 2, "imag": [2, 3, 9], "images": 9, "implement": [7, 9, 10, 11, 13], "incididunt": [15, 17], "includ": [5, 6, 17], "increment": 5, "index": 5, "ineffici": 8, "info": 5, "inform": 9, "initi": 9, "input": [1, 7], "insert": 5, "insid": 12, "instagram": 0, "instanc": [5, 11], "instruct": 3, "int": [2, 5, 8, 9], "integ": [2, 3, 5], "intens": [2, 6], "interpol": 12, "introduc": 3, "invalid": 5, "invari": [3, 9], "invsrcalpha": 1, "iostream": 5, "ipsum": [15, 17], "issmart": 5, "isstud": 5, "istal": 5, "itali": 5, "italianchef": 5, "its": [2, 5, 12], "itself": 1, "ix": [9, 14], "ixii": 9, "ixit": 9, "ixix": 9, "iyii": 9, "iyit": 9, "jim": 5, "jk": 5, "joost": [3, 9], "jrr": 5, "just": [11, 12], "justo": 17, "kanad": 0, "kevin": 5, "keyword": 17, "knarkowicz": 1, "known": [15, 17], "l1": [3, 9], "l2": [3, 9], "labor": [15, 17], "largest": 9, "ldexp": 2, "learn": 11, "least": [11, 15, 17], "left": [12, 17], "length": [3, 5, 9], "lesser": 2, "letter": 5, "level": [9, 13], "light": 11, "like": [1, 5, 12, 13], "linear": [7, 14], "linearoffset": 6, "linearweight": 6, "link": [3, 9, 15, 16, 17], "list": 16, "lk": 9, "llo": 5, "load": 11, "locat": 4, "lod": 6, "log": [1, 10], "log2": [1, 7, 10], "logarithm": 0, "long": 5, "longer": 13, "loop": [0, 9], "lord": 5, "lorem": [15, 17], "lower": [5, 17], "ltr": 9, "luca": 0, "luckynumb": 5, "luma": 1, "lumaaverag": 1, "m": 9, "magna": [15, 17], "mai": [5, 9], "main": [5, 8, 9], "maintex": 9, "major": [3, 10], "make": [5, 11, 12, 17], "makechicken": 5, "makepasta": 5, "makesalad": 5, "makespecialdish": 5, "mani": 6, "manipul": 5, "manual": 1, "map": 3, "mask": 9, "mass": 11, "massimo": 5, "math": 12, "matrix": 9, "max": [1, 2, 10], "maxexpon": 9, "maximum": 3, "maxsignificand": 9, "me": 11, "media": 16, "member": 5, "memori": [5, 11, 12], "method": [5, 13, 17], "might": 8, "mike": 5, "minimum": 3, "mipmap": [9, 11], "miss": 10, "mix": [12, 15, 17], "model": [0, 11], "modulu": 5, "more": [8, 13], "most": 17, "motion": 9, "mov": 13, "move": [5, 12], "msg": 5, "mul": [7, 9, 13], "multipli": 10, "must": [7, 10, 13, 15, 17], "mychef": 5, "mygrad": 5, "myitalianchef": 5, "myplan": 5, "mystr": 5, "myvari": 5, "n": 9, "name": [5, 12, 17], "namespac": 5, "nec": 17, "need": [7, 9, 17], "neg": 8, "neighbor": 2, "neighborhood": 2, "nequ": 17, "nest": 0, "net": [3, 9], "next": 9, "nich": [15, 17], "non": 17, "norm": 9, "normal": [6, 9, 11], "note": [1, 5, 12, 17], "notifi": 5, "num": 5, "num1": 5, "num2": 5, "number": [6, 13], "numbergrid": 5, "ob": 16, "object": [4, 5, 9, 11], "od": 13, "od0": 13, "offset": 8, "offset1": 6, "offset2": 6, "offsetew": 9, "offsetn": 9, "ofog": 13, "often": 3, "onli": [15, 17], "opengl": 11, "oper": 5, "opo": 13, "opt": 13, "optic": [0, 3], "optim": [3, 6, 7], "option": 1, "order": 5, "origin": 17, "oscar": 5, "ot": 13, "other": [11, 15, 17], "our": [7, 10], "out": [1, 5, 6, 12], "outerra": [0, 7], "outlin": 12, "output": [1, 3, 6, 7, 10, 12, 14], "outputcolor": [2, 6], "outputcolor0": 1, "overrid": 5, "overwrit": 1, "own": 17, "p": 13, "pack": 9, "paper": [3, 9], "parmesan": 5, "part": [9, 10, 12], "particular": 13, "pass": [1, 5, 12], "pass0": 1, "pass1": 1, "pasta": 5, "path": 16, "pdf": 9, "pecis": 3, "pedal": 5, "peleg": 9, "peopl": [11, 17], "per": [5, 7], "percis": 5, "person": 0, "phong": 11, "photometr": [3, 9], "pi": 6, "pipelin": [1, 11], "pixel": [1, 2, 6, 7, 13, 14], "pixels": [2, 6, 9, 14], "pixelshad": [1, 12, 13], "plane": [5, 11], "playlist": 17, "plu": 9, "pnum": 5, "po": [7, 13], "point": [3, 5, 13], "polymorph": 11, "port": 13, "posit": [1, 5, 7, 10, 12, 13], "position0": [7, 13], "possibl": [3, 15, 17], "post": [3, 6, 7, 8, 9, 13], "postprocessp": 12, "postprocessv": 12, "potenti": 13, "potter": 5, "pow": 9, "practic": 11, "precalcul": [3, 9], "precis": [5, 13], "prefix": 5, "prevent": [3, 6], "previou": 1, "previous": 1, "primit": 5, "privat": 5, "process": 8, "product": 17, "program": [5, 8, 11], "project": [0, 7, 17], "projpo": 13, "propag": 9, "ps2fb": 7, "ps_exposur": 1, "ps_generateaverageluma": 1, "ps_logdepth": 7, "ps_projectroad": 13, "public": [3, 5, 9], "pull": 9, "purpos": [11, 17], "push": 9, "push_back": 5, "pyramid": 9, "python": [0, 5], "r": [1, 2, 3, 12], "r0": 13, "r1": 13, "radii": 6, "ramsai": 5, "rang": [3, 9, 13], "rastergrid": 0, "re": [11, 17], "reach": 11, "read": [5, 13], "readbook": 5, "realiti": [0, 7, 16, 17], "recap": 12, "recognit": 9, "record": [16, 17], "red": [1, 3, 12], "reddit": 12, "refactor": 11, "refresh": 0, "relat": [11, 17], "relationship": 2, "relev": [15, 17], "remaind": 5, "render": [1, 11], "replac": 11, "repres": [2, 3, 12], "requir": [8, 9, 14], "researchg": [3, 9], "reshadefx": 0, "resolv": 16, "respect": 17, "rest": 5, "restrict": 9, "result": 2, "return": [1, 2, 3, 5, 6, 7, 9, 13, 14], "rg": 9, "rg8": 3, "rgb": [1, 2, 3, 9], "rhoncu": 17, "right": [3, 12, 17], "ring": 5, "robust": [2, 3, 9], "rotat": 9, "row": 5, "rowl": 5, "rsqrt": 6, "rule": 5, "sai": 11, "salad": 5, "sampl": [6, 8, 14], "samplecolortex": [1, 6], "samplei0": 9, "samplei1": 9, "sampleimag": [2, 14], "sampleindex": 6, "samplelumatex": 1, "sampleneighbor": 2, "sampler": [2, 14], "sampler2d": 9, "sapien": 17, "satur": [1, 3, 9, 10, 13], "saturdai": 17, "scene": 11, "schedul": 17, "screen": 12, "second": [5, 11], "sed": [15, 17], "see": 12, "semant": 7, "send": 12, "sensit": 5, "sentenc": [15, 17], "seri": 11, "set": [5, 9, 12, 15, 17], "setauthor": 5, "settitl": 5, "setup": 9, "shade": 1, "shader": [0, 1, 6, 7, 10], "share": 17, "short": 5, "should": 17, "side": 6, "sigma": 6, "sign": [5, 9], "signatur": 5, "signbit": 9, "significand": 9, "significandbit": 9, "similar": 17, "simpl": 7, "simplifi": 7, "singl": 5, "sit": [15, 17], "size": [5, 12, 13], "sky": 5, "smaller": 5, "smallest": 9, "smart": 5, "smooth": [1, 11], "so": [7, 8, 9, 13, 14], "sobel": 0, "solut": 13, "solv": [6, 9], "some": [1, 9], "someon": 11, "someth": 7, "song": 17, "sourc": [5, 17], "space": [0, 3, 10, 11, 12], "spatial": 9, "special": 5, "specif": 17, "specifi": 5, "spent": 11, "sqrt": [3, 9], "squar": 12, "srcalpha": 1, "srcblend": 1, "ssd": 9, "standalon": 17, "standard": 4, "start": [5, 8, 11], "std": 5, "step": [2, 9], "store": [1, 5, 9, 11], "straight": 11, "stretch": 12, "string": 2, "struct": [1, 7, 13, 14], "student": 5, "studio": 16, "subject": 17, "substr": 5, "sum": 5, "sumrgb": 3, "support": 13, "sv_posit": 12, "sv_target": 12, "sv_vertexid": 12, "syetem": 5, "system": 11, "t": [3, 5, 9, 13], "tag": 17, "tangent": [4, 11], "taught": 11, "team": [7, 13], "techniqu": 1, "templat": 16, "tempor": [0, 9, 15, 17], "test": 7, "testgrad": 5, "tex": [1, 2, 6, 14], "tex0": 1, "tex2d": [1, 2, 14], "tex2dgrad": 9, "tex2dlod": [1, 6], "texcoord": 12, "texcoord0": [1, 7, 13], "texii": 9, "texit": 9, "texix": 9, "textur": [1, 9, 12, 13, 14], "than": [2, 5, 8, 11], "thank": 11, "thei": 17, "them": 5, "thi": [1, 3, 5, 6, 7, 8, 9, 10, 11, 12, 13, 17], "through": 5, "throw": 5, "thumbnail": 17, "timecod": 17, "titl": [3, 5, 9, 17], "tolkien": 5, "tool": 17, "top": 12, "totalweight": 6, "trailer": 17, "trait": 5, "transform": [0, 7, 11], "transport": 5, "triangl": [3, 12], "true": [1, 5], "trunc": [8, 9], "try": 5, "turn": 0, "twice": 12, "txt": 16, "type": 13, "uint": 12, "ultric": 17, "undefin": 3, "unformat": 11, "uniform": 11, "unnecessari": 17, "unsign": [5, 13], "updat": [7, 13], "upload": 17, "upper": 5, "urna": 17, "us": [1, 5, 9, 11, 12, 13, 17], "usual": 7, "ut": [15, 17], "v": 13, "v0": 13, "valid": 9, "valu": [3, 5, 12], "van": [3, 9], "vari": 6, "variabl": [9, 13], "vbo": 11, "vector": 9, "vehicl": 5, "vendor": 5, "version": [7, 10], "vertex": [1, 4, 10, 11, 13], "vertexshad": [1, 12, 13], "vertic": 12, "video": [5, 9, 16], "view": 4, "viewer": 4, "virtual": 5, "viverra": 17, "vkyx41j6zba": 17, "void": [5, 12], "vs2p": [1, 7], "vs2ps_projectroad": 13, "vs_logdepth": 7, "vs_projectroad": 13, "vs_quad": 1, "w": [7, 9, 10, 13], "wa": [5, 11], "want": 11, "warp": 9, "warptex": 9, "we": [3, 5, 8, 10, 11, 12], "weekend": [0, 17], "weight": [1, 6], "weight1": 6, "weight2": 6, "weijer": [3, 9], "well": [15, 17], "what": [5, 15, 17], "when": [3, 13], "white": 3, "who": 11, "why": 5, "width": 9, "window": [8, 9], "windowhalf": [8, 9], "windows": [8, 9], "without": 5, "word": 5, "wordpress": 1, "world": [4, 5], "worldviewproj": 7, "www": [3, 9, 12], "x": [3, 4, 8, 9, 12, 13], "xw": 2, "xy": [2, 8, 9, 12], "xyw": 13, "xyxi": 9, "xyyi": 2, "xyz": [7, 13], "xyzw": 9, "xz": 2, "xzw": 13, "y": [3, 4, 8, 9, 12, 13], "ye": 17, "year": [3, 9], "you": [1, 3, 5, 7, 8, 9, 11, 12, 13, 14, 17], "your": [5, 9, 13], "youtu": 17, "youtub": 0, "z": [3, 4, 9, 10, 13], "zero": 5, "zw": 9}, "titles": ["Homepage", "Temporal Auto-Exposure with Hardware Blending", "Census Transform in HLSL", "Chromaticity in HLSL", "Coordinate Spaces: A Refresher", "GiraffeAcademy\u2019s C++ Examples", "RasterGrid\u2019s Gaussian Blur in HLSL", "Logarithmic Depth Buffering in HLSL", "Turning a Nested 2D Loop into 1D", "Lucas-Kanade Optical Flow in HLSL", "Correcting Outerra\u2019s Logarithmic Depth Buffering", "A Pythonic 3D Engine in 1 Weekend", "ReShadeFX for Beginners", "Project Reality: Shader Model 3.0 Considerations", "Bilinear Sobel Filtering in HLSL", "Instagram", "Personal Project", "YouTube"], "titleterms": {"": [5, 6, 10], "0": 13, "1": 11, "1d": 8, "2": 11, "2d": [5, 8], "3": [11, 13], "3d": 11, "A": [4, 11], "For": 5, "If": 5, "abstract": 5, "account": [15, 17], "algorithm": 9, "arrai": 5, "assign": 13, "auto": 1, "beginn": 12, "bilinear": 14, "blend": 1, "blog": 0, "blur": 6, "buffer": [7, 10], "c": 5, "cast": 5, "censu": 2, "chromat": 3, "class": 5, "code": [1, 2, 3, 6, 7, 8, 9, 10, 14], "command": 16, "consider": 13, "constant": 5, "constructor": 5, "content": 0, "coordin": 4, "correct": 10, "count": 13, "creation": 0, "declar": 13, "depth": [7, 10], "dlp": 16, "download": 16, "engin": 11, "environ": 11, "exampl": 5, "except": 5, "exposur": 1, "feedback": 11, "filter": 14, "first": 12, "flow": 9, "fog": 13, "format": 13, "formula": 3, "function": 5, "gaussian": 6, "getter": 5, "giraffeacademi": 5, "graphic": 0, "guid": 0, "hardwar": 1, "hlsl": [2, 3, 6, 7, 9, 14], "homepag": 0, "i": 12, "imag": 15, "inherit": 5, "input": [5, 13], "instagram": 15, "kanad": 9, "logarithm": [7, 10], "loop": [5, 8], "loss": 3, "luca": 9, "main": 11, "map": 11, "model": 13, "nest": 8, "normal": 3, "number": 5, "optic": 9, "outerra": 10, "output": 13, "pcf": 11, "person": 16, "pixel": 12, "pointer": 5, "post": 15, "precis": 3, "print": 5, "program": 0, "project": [13, 16], "python": 11, "rastergrid": 6, "realiti": 13, "recommend": 11, "refresh": 4, "regist": 13, "requir": [15, 17], "reshadefx": 12, "rg": 3, "setter": 5, "shader": [12, 13], "shadow": 11, "skybox": 11, "sobel": 14, "sourc": [1, 2, 3, 6, 7, 8, 9, 10, 14], "space": 4, "spheric": 3, "statement": 5, "string": 5, "switch": 5, "techniqu": 12, "templat": [15, 17], "tempor": 1, "tool": 16, "transform": 2, "turn": 8, "tutori": 11, "upload": 15, "us": 16, "user": 5, "variabl": 5, "vector": 5, "vertex": 12, "video": [11, 17], "weekend": 11, "what": 12, "while": 5, "your": 12, "youtub": 17, "yt": 16}}) \ No newline at end of file diff --git a/source/blog/autoexposure.html b/source/blog/autoexposure.html new file mode 100644 index 0000000..2f73af1 --- /dev/null +++ b/source/blog/autoexposure.html @@ -0,0 +1,262 @@ + + + + + + + + Temporal Auto-Exposure with Hardware Blending — A Shaderboy's Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+
+ + +
+ +
+

Temporal Auto-Exposure with Hardware Blending

+
+
Some graphics pipelines compute auto-exposure like this:
+
Textures:
+
    +

  1. Previous average brightness

    2. +

  2. Current average brightness

    3. +
+
+
Passes:
+
    +

  1. Store previously generated average brightness

    2. +

  2. Generates current average brightness

    3. +

  3. Smooth average brightnesses and compute auto-exposure

    4. +
+
+
+
+
You can use hardware blending for auto-exposure:
+
Textures:
+
    +

  1. Average brightnesses (previous + current)

    2. +
+
+
Passes:
+
    +

  1. Generate and smooth average brightnesses

    2. +

  2. Compute auto-exposure

    3. +
+
+
+
+
+
+

Source Code

+
/*
+   Automatic exposure shader using hardware blending
+*/
+
+/*
+   Vertex shaders
+*/
+
+struct APP2VS
+{
+   float4 HPos : POSITION;
+   float2 Tex0 : TEXCOORD0;
+};
+
+struct VS2PS
+{
+   float4 HPos : POSITION;
+   float2 Tex0 : TEXCOORD0;
+};
+
+VS2PS VS_Quad(APP2VS Input)
+{
+   VS2PS Output;
+   Output.HPos = Input.HPos;
+   Output.Tex0 = Input.Tex0;
+   return Output;
+}
+
+/*
+   Pixel shaders
+   ---
+   AutoExposure(): https://knarkowicz.wordpress.com/2016/01/09/automatic-exposure/
+*/
+
+float3 GetAutoExposure(float3 Color, float2 Tex)
+{
+   float LumaAverage = exp(tex2Dlod(SampleLumaTex, float4(Tex, 0.0, 99.0)).r);
+   float Ev100 = log2(LumaAverage * 100.0 / 12.5);
+   Ev100 -= _ManualBias; // optional manual bias
+   float Exposure = 1.0 / (1.2 * exp2(Ev100));
+   return Color * Exposure;
+}
+
+float4 PS_GenerateAverageLuma(VS2PS Input) : COLOR0
+{
+   float4 Color = tex2D(SampleColorTex, Input.Tex0);
+   float3 Luma = max(Color.r, max(Color.g, Color.b));
+
+   // OutputColor0.rgb = Output the highest brightness out of red/green/blue component
+   // OutputColor0.a = Output the weight for temporal blending
+   float Delay = 1e-3 * _Frametime;
+   return float4(log(max(Luma.rgb, 1e-2)), saturate(Delay * _SmoothingSpeed));
+}
+
+float3 PS_Exposure(VS2PS Input) : COLOR0
+{
+   float4 Color = tex2D(SampleColorTex, Input.Tex0);
+   return GetAutoExposure(Color.rgb, Input.Tex0);
+}
+
+technique AutoExposure
+{
+   // Pass0: This shader renders to a texture that blends itself
+   // NOTE: Do not have another shader overwrite the texture
+   pass GenerateAverageLuma
+   {
+      // Use hardware blending
+      BlendEnable = TRUE;
+      BlendOp = ADD;
+      SrcBlend = SRCALPHA;
+      DestBlend = INVSRCALPHA;
+
+      VertexShader = VS_Quad;
+      PixelShader = PS_GenerateAverageLuma;
+   }
+
+   // Pass1: Get the texture generated from Pass0
+   // Do autoexposure shading here
+   pass ApplyAutoExposure
+   {
+      VertexShader = VS_Quad;
+      PixelShader = PS_Exposure;
+   }
+}
+
+
+
+
+ + +
+
+   + +
+ +
+
+
+
+
+ ©2024, papadanku. + + | + Powered by Sphinx 8.0.2 + & Alabaster 1.0.0 + + | + Page source +
+ + + + + + \ No newline at end of file diff --git a/source/blog/censustransform.html b/source/blog/censustransform.html new file mode 100644 index 0000000..bc3b867 --- /dev/null +++ b/source/blog/censustransform.html @@ -0,0 +1,183 @@ + + + + + + + + Census Transform in HLSL — A Shaderboy's Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+
+ + +
+ +
+

Census Transform in HLSL

+

The census transform is a filter that represents the pixel’s neighborhood relationship in a binary string. The binary string will be 0000000 if the center pixel is lesser than all of its neighbors. The binary string will be 11111111 if the center pixel is greater than or equal to all of its neighbors.

+

The filter does not depend on the image’s actual intensity. As a result, the filter is robust to illumination.

+
+

Source Code

+
float GetGreyScale(float3 Color)
+{
+   return max(max(Color.r, Color.g), Color.b);
+}
+
+float GetCensusTransform(sampler SampleImage, float2 Tex, float2 PixelSize)
+{
+   float OutputColor = 0.0;
+   float4 ColumnTex[3];
+   ColumnTex[0] = Tex.xyyy + (float4(-1.0, +1.0, 0.0, -1.0) * PixelSize.xyyy);
+   ColumnTex[1] = Tex.xyyy + (float4( 0.0, +1.0, 0.0, -1.0) * PixelSize.xyyy);
+   ColumnTex[2] = Tex.xyyy + (float4(+1.0, +1.0, 0.0, -1.0) * PixelSize.xyyy);
+
+   const int Neighbors = 8;
+   float SampleNeighbor[Neighbors];
+   SampleNeighbor[0] = GetGreyScale(tex2D(SampleImage, ColumnTex[0].xy).rgb);
+   SampleNeighbor[1] = GetGreyScale(tex2D(SampleImage, ColumnTex[1].xy).rgb);
+   SampleNeighbor[2] = GetGreyScale(tex2D(SampleImage, ColumnTex[2].xy).rgb);
+   SampleNeighbor[3] = GetGreyScale(tex2D(SampleImage, ColumnTex[0].xz).rgb);
+   SampleNeighbor[4] = GetGreyScale(tex2D(SampleImage, ColumnTex[2].xz).rgb);
+   SampleNeighbor[5] = GetGreyScale(tex2D(SampleImage, ColumnTex[0].xw).rgb);
+   SampleNeighbor[6] = GetGreyScale(tex2D(SampleImage, ColumnTex[1].xw).rgb);
+   SampleNeighbor[7] = GetGreyScale(tex2D(SampleImage, ColumnTex[2].xw).rgb);
+   float CenterSample = GetGreyScale(tex2D(SampleImage, ColumnTex[1].xz).rgb);
+
+   // Generate 8-bit integer from the 8-pixel neighborhood
+   for(int i = 0; i < Neighbors; i++)
+   {
+      float Comparison = step(SampleNeighbor[i], CenterSample);
+      OutputColor += ldexp(Comparison, i);
+   }
+
+   // Convert the 8-bit integer to float, and average the results from each channel
+   return OutputColor * (1.0 / (exp2(8) - 1));
+}
+
+
+
+
+ + +
+
+   + +
+ +
+
+
+
+
+ ©2024, papadanku. + + | + Powered by Sphinx 8.0.2 + & Alabaster 1.0.0 + + | + Page source +
+ + + + + + \ No newline at end of file diff --git a/source/blog/chromaticity.html b/source/blog/chromaticity.html new file mode 100644 index 0000000..0ceb639 --- /dev/null +++ b/source/blog/chromaticity.html @@ -0,0 +1,247 @@ + + + + + + + + Chromaticity in HLSL — A Shaderboy's Collection documentation + + + + + + + + + + + + + + + + + + + +
+ + +
+
+ + +
+ +
+

Chromaticity in HLSL

+

Images often represent color in 3 channels: (R, G, B) - red, green, and blue. You can represent (R, G, B) in any range. For this post, the range is a minimum of 0.0 and a maximum of 1.0.

+
+

Normalized Chromaticity

+
+

Formulas

+
+
Normalized RG/RGB
+\[\begin{split}r = \frac{R}{R+G+B}\\ +g = \frac{G}{R+G+B}\\ +b = \frac{B}{R+G+B}\\ +\\ +r+g+b = 1\end{split}\]
+
+
Output \((r,g,b)\)
+
(1.0, 0.0, 0.0):
+

100% red

+
+
(0.0, 1.0, 0.0):
+

100% green

+
+
(0.0, 0.0, 1.0):
+

100% blue

+
+
+
+
Output \((r,g)\)
+
(1.0, 0.0):
+

100% red

+
+
(0.0, 1.0):
+

100% green

+
+
(0.0, 0.0):
+

100% blue

+
+
+
+
+
+
Normalized RG/RGB White-Point
+\[\begin{split}R=1\\ +G=1\\ +B=1\\ +\\ +r = \frac{R}{R+G+B}\\ +g = \frac{G}{R+G+B}\\ +b = \frac{B}{R+G+B}\\ +\\ +r+g+b = 1\end{split}\]
+
+
+
+
+

Source Code

+
float3 GetRGBChromaticity(float3 Color)
+{
+   // Optimizes 2 ADD instructions 1 DP3 instruction
+   float SumRGB = dot(Color, 1.0);
+   float3 Chromaticity = saturate(Color / SumRGB);
+   // Output the chromaticity's white point if the divisor is 0.0
+   // Prevents undefined behavior happens when you divide by 0
+   Chromaticity = (SumRGB == 0.0) ? 1.0 / 3.0 : Chromaticity;
+   return Chromaticity;
+}
+
+
+
+
+
+

Spherical Chromaticity

+

This post introduces a color space that computes chromaticity with angles.

+
+

Precision Loss in RG Chromaticity

+

Pecision is a major drawback to RG chromaticity. In RG chromaticity, all possible values map into a right-triangle, eliminating half of the precision in integer buffers.

+

We can encode data that fits in the entire RG8 range by calculating the angles between the channels.

+
+
+

Source Code

+
/*
+    This code is based on the algorithm described in the following paper:
+    Author(s): Joost van de Weijer, T. Gevers
+    Title: "Robust optical flow from photometric invariants"
+    Year: 2004
+    DOI: 10.1109/ICIP.2004.1421433
+    Link: https://www.researchgate.net/publication/4138051_Robust_optical_flow_from_photometric_invariants
+*/
+
+float2 GetSphericalRG(float3 Color)
+{
+    const float HalfPi = 1.0 / acos(0.0);
+
+    // Precalculate (x*x + y*y)^0.5 and (x*x + y*y + z*z)^0.5
+    float L1 = length(Color.rg);
+    float L2 = length(Color.rgb);
+
+    float2 Angles = 0.0;
+    Angles[0] = (L1 == 0.0) ? 1.0 / sqrt(2.0) : Color.g / L1;
+    Angles[1] = (L2 == 0.0) ? 1.0 / sqrt(3.0) : L1 / L2;
+
+    return saturate(asin(abs(Angles)) * HalfPi);
+}
+
+
+
+
+
+ + +
+
+   + +
+ +
+
+
+
+
+ ©2024, papadanku. + + | + Powered by Sphinx 8.0.2 + & Alabaster 1.0.0 + + | + Page source +
+ + + + + + \ No newline at end of file diff --git a/source/blog/coordinatespaces.html b/source/blog/coordinatespaces.html new file mode 100644 index 0000000..83b96ad --- /dev/null +++ b/source/blog/coordinatespaces.html @@ -0,0 +1,183 @@ + + + + + + + + Coordinate Spaces: A Refresher — A Shaderboy's Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+
+ + +
+ +
+

Coordinate Spaces: A Refresher

+
+
Standard Basis

Defines the directions of the x-axis, y-axis, and z-axis.

+
+
(1.0, 0.0, 0.0):
+

x-axis

+
+
(0.0, 1.0, 0.0):
+

y-axis

+
+
(0.0, 0.0, 1.0):
+

z-axis

+
+
+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + +
Coordinate Spaces

Coordinate Space

Standard-Basis Location

(0.0, 0.0, 0.0) Location

Tangent-Space

On the face or vertex.

On the center of the face or vertex.

Object-Space

On the object.

On the center of the object.

World-Space

On the world.

On the center of the world.

View-Space

On the viewer.

On the center of the viewer.

+
+ + +
+
+   + +
+ +
+
+
+
+
+ ©2024, papadanku. + + | + Powered by Sphinx 8.0.2 + & Alabaster 1.0.0 + + | + Page source +
+ + + + + + \ No newline at end of file diff --git a/source/blog/cpp.html b/source/blog/cpp.html new file mode 100644 index 0000000..299f98e --- /dev/null +++ b/source/blog/cpp.html @@ -0,0 +1,866 @@ + + + + + + + + GiraffeAcademy’s C++ Examples — A Shaderboy's Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+
+ + +
+ +
+

GiraffeAcademy’s C++ Examples

+

Sourced from: C++ Programming | In One Video

+
+

Abstract Classes

+
#include <iostream>
+using namespace std;
+
+class Vehicle
+{
+public:
+   virtual void move() = 0;
+   void getDescription()
+   {
+      cout << "Vehicles are used for transportation" << endl;
+   }
+};
+
+class Bicycle : public Vehicle
+{
+public:
+   void move()
+   {
+      cout << "The bicycle pedals forward" << endl;
+   }
+};
+
+class Plane : public Vehicle
+{
+public:
+   virtual void move()
+   {
+      cout << "The plane flys through the sky" << endl;
+   }
+};
+
+int main()
+{
+   Plane myPlane;
+   myPlane.move();
+   myPlane.getDescription();
+
+   return 0;
+}
+
+
+
+
+

Arrays

+
#include <iostream>
+using namespace std;
+
+int main()
+{
+   // Define an integer array
+   // int luckyNumbers[6];
+   int luckyNumbers[] = {4, 8, 15, 16, 23, 42};
+   // indexes:           0  1   2   3   4   5
+
+   // Set the number 99 at the 1st member
+   luckyNumbers[0] = 90;
+
+   // Print out the array's 1st and 2nd members
+   cout << luckyNumbers[0] << endl;
+   cout << luckyNumbers[1] << endl;
+
+   return 0;
+}
+
+
+
+
+

Arrays (2D)

+
#include <iostream>
+using namespace std;
+
+int main()
+{
+   // Define a 2D integer array
+   // int numberGrid[2][3];
+   int numberGrid[2][3] = {{1, 2, 3}, {4, 5, 6}};
+
+   // Set the number 99 at [row 1][column 2]
+   numberGrid[0][1] = 99;
+
+   // Print [row 1][column 1 and 2]
+   cout << numberGrid[0][0] << endl;
+   cout << numberGrid[0][1] << endl;
+
+   return 0;
+}
+
+
+
+
+

Casting

+
#include <iostream>
+using namespace std;
+
+int main()
+{
+   cout << (int)3.14 << endl;
+   cout << (double)3 / 2 << endl;
+
+   return 0;
+}
+
+
+
+
+

Classes

+
#include <iostream>
+#include <string>
+using namespace std;
+
+// Create the Book datatype
+class Book
+{
+public:
+   string title;
+   string author;
+
+   void readBook()
+   {
+      cout << "Reading " + this->title + " by " + this->author << endl;
+   }
+};
+
+int main()
+{
+   // Construct the book1 object instance
+   Book book1;
+   book1.title = "Harry Potter";
+   book1.author = "JK Rowling";
+
+   // Print out info from the book1 object instance
+   book1.readBook();
+   cout << book1.title << endl;
+
+   // Construct the book2 object instance
+   Book book2;
+   book2.title = "Lord of the Rings";
+   book2.author = "JRR Tolkien";
+
+   // Print out info from the book2 object instance
+   book2.readBook();
+   cout << book2.title << endl;
+
+   return 0;
+}
+
+
+
+
+

Constants

+
#include <iostream>
+using namespace std;
+
+int main()
+{
+   const int BIRTH_YEAR = 1945;
+   // BIRTH_YEAR = 1988; // Can't change BIRTH_YEAR
+   cout << BIRTH_YEAR;
+
+   return 0;
+}
+
+
+
+
+

Constructors

+
#include <iostream>
+#include <string>
+using namespace std;
+
+// Create the Book datatype
+class Book
+{
+public:
+   string title;
+   string author;
+
+   // Define the class' constuctor function
+   // NOTE: This is like `def __init__()` in Python :D
+   Book(string title, string author)
+   {
+      this->title = title;
+      this->author = author;
+   }
+
+   void readBook()
+   {
+      cout << "Reading " + this->title + " by " + this->author << endl;
+   }
+};
+
+int main()
+{
+   // Construct the book1 object instance
+   Book book1("Harry Potter", "JK Rowling");
+
+   // Print out info from the book1 object instance
+   book1.readBook();
+   cout << book1.title << endl;
+
+   // Construct the book2 object instance
+   Book book2("Lord of the Rings", "JRR Tolkien");
+
+   // Print out info from the book2 object instance
+   book2.readBook();
+   cout << book2.title << endl;
+
+   return 0;
+}
+
+
+
+
+

Exceptions

+
#include <iostream>
+using namespace std;
+
+double division(int a, int b)
+{
+   if (b == 0)
+   {
+      throw "Division by zero error!";
+   }
+   return (a / b);
+}
+
+int main()
+{
+   try
+   {
+      division(10, 0);
+   }
+   catch (const char *msg)
+   {
+      cerr << msg << endl;
+   }
+
+   return 0;
+}
+
+
+
+
+

For Loops

+
#include <iostream>
+using namespace std;
+
+int main()
+{
+   for (int i = 0; i < 5; i++)
+   {
+      cout << i << endl;
+   }
+
+   return 0;
+}
+
+
+
+
+

Functions

+
#include <iostream>
+using namespace std;
+
+// Specify a method signature
+int addNumbers(int num1, int num2);
+
+int main()
+{
+   // NOTE: We declare the function first
+   int sum = addNumbers(4, 60);
+   cout << sum << endl;
+
+   return 0;
+}
+
+int addNumbers(int num1, int num2)
+{
+   return num1 + num2;
+}
+
+
+
+
+

Getters & Setters

+
#include <iostream>
+#include <string>
+using namespace std;
+
+// Create the Book datatype
+class Book
+{
+private:
+   string title;
+   string author;
+
+public:
+   // Define the class' constuctor function
+   // NOTE: This is like `def __init__()` in Python :D
+   Book(string title, string author)
+   {
+      this->setTitle(title);
+      this->setAuthor(author);
+   }
+
+   string getTitle()
+   {
+      return this->title;
+   }
+
+   void setTitle(string title)
+   {
+      this->title = title;
+   }
+
+   string getAuthor(string author)
+   {
+      return this->author;
+   }
+
+   void setAuthor(string author)
+   {
+      this->author = author;
+   }
+
+   void readBook()
+   {
+      cout << "Reading " + this->title + " by " + this->author << endl;
+   }
+};
+
+int main()
+{
+   // Construct the book1 object instance
+   Book book1("Harry Potter", "JK Rowling");
+
+   // Print out info from the book1 object instance
+   book1.readBook();
+   cout << book1.getTitle() << endl;
+
+   // Construct the book2 object instance
+   Book book2("Lord of the Rings", "JRR Tolkien");
+
+   // Print out info from the book2 object instance
+   book2.readBook();
+   cout << book2.getTitle() << endl;
+
+   return 0;
+}
+
+
+
+
+

If Statements

+
#include <iostream>
+using namespace std;
+
+int main()
+{
+   // Define 2 booleans
+   bool isStudent = false;
+   bool isSmart = false;
+
+   if (isStudent && isSmart)
+   {
+      cout << "You are a student" << endl;
+   }
+   else if (isStudent && !isSmart)
+   {
+      cout << "You are not a smart student" << endl;
+   }
+   else
+   {
+      cout << "You are not a student and not smart" << endl;
+   }
+
+   // >, <, >=, <=, !=, ==
+   if (1 > 3)
+   {
+      cout << "Number comparison was true" << endl;
+   }
+
+   if ('a' > 'b')
+   {
+      cout << "Character comparison was true" << endl;
+   }
+
+   string myString = "cat";
+   if (myString.compare("cat") != 0)
+   {
+      cout << "string comparison was true" << endl;
+   }
+
+   return 0;
+}
+
+
+
+
+

Inheritance

+
#include <iostream>
+using namespace std;
+
+// Create a Chef datatype
+class Chef
+{
+public:
+   string name;
+   int age;
+
+   Chef(string name, int age)
+   {
+      this->name = name;
+      this->age = age;
+   }
+
+   void makeChicken()
+   {
+      cout << "The chef makes chicken" << endl;
+   }
+
+   void makeSalad()
+   {
+      cout << "The chef makes salad" << endl;
+   }
+
+   void makeSpecialDish()
+   {
+      cout << "The chef makes a special dish" << endl;
+   }
+};
+
+// Create an ItalianChef datatype that is an extenion of the Chef datatype
+class ItalianChef : public Chef
+{
+public:
+   string countryOfOrigin;
+
+   // Extended class' constructor from Chef's class constructor
+   ItalianChef(string name, int age, string countryOfOrigin) : Chef(name, age)
+   {
+      this->countryOfOrigin = countryOfOrigin;
+   }
+
+   void makePasta()
+   {
+      cout << "The chef makes pasta" << endl;
+   }
+
+   // Override the Chef class' makeSpecialDish()
+   void makeSpecialDish()
+   {
+      cout << "The chef makes chicken parmesan" << endl;
+   }
+};
+
+int main()
+{
+   // Example of the Chef class
+   Chef myChef("Gordon Ramsay", 50);
+   myChef.makeSpecialDish();
+
+   // Example of the extended ItalianChef class
+   ItalianChef myItalianChef("Massimo Bottura", 55, "Italy");
+   myItalianChef.makeSpecialDish();
+   cout << myItalianChef.age << endl;
+
+   return 0;
+}
+
+
+
+
+

Numbers

+
#include <iostream>
+using namespace std;
+
+int main()
+{
+   cout << 2 * 3 << endl;       // Basic arithmetic: +, -, /, *
+   cout << 10 % 3 << endl;      // Modulus operator: returns the remainder of 10 / 3
+   cout << (1 + 2) * 3 << endl; // Order of operations
+
+   /*
+      Division rules with ints and doubles:
+         f/f = f
+         i/i = i
+         i/f = f
+         f/i = f
+   */
+   cout << 10 / 3.0 << endl;
+
+   int num = 10;
+   num += 100; // +=, -=, /=, *=
+   cout << num << endl;
+
+   // Example: variable incrementation
+   num++;
+   cout << num << endl;
+
+   return 0;
+}
+
+
+
+
+

Pointers

+
#include <iostream>
+using namespace std;
+
+int main()
+{
+   /*
+      What pointers are:
+      - Exposes memory addresses
+      - Manipulates memory addresses
+      Why we use pointers:
+      - Memory addresses can change per-syetem
+      - Directly change data without copying it
+   */
+
+   // Print out an integer variable's memory address
+   int num = 10;
+   cout << &num << endl;
+
+   // Store the integer variable's memory address into memory
+   int *pNum = &num;
+   cout << pNum << endl;  // Print the memory adddress
+   cout << *pNum << endl; // Dereference the memory address to fetch its stored value
+
+   return 0;
+}
+
+
+
+
+

Printing

+
#include <iostream>
+using namespace std;
+
+int main()
+{
+   cout << "Hello World!" << endl;
+
+   return 0;
+}
+
+
+
+
+

Strings

+
#include <iostream>
+#include <string>
+using namespace std;
+
+int main()
+{
+   string greetings = "Hello";
+   //    char indexes: 01234
+
+   cout << greetings.length() << endl;     // Get string length
+   cout << greetings[0] << endl;           // Get 1st character of string
+   cout << greetings.find("llo") << endl;  // Find "llo"'s starting character position
+   cout << greetings.substr(2) << endl;    // Get all characters, starting from the 2nd character of the string
+   cout << greetings.substr(1, 3) << endl; // Get 3 characters, starting from the 1st character of the string
+
+   return 0;
+}
+
+
+
+
+

Switch Statements

+
#include <iostream>
+using namespace std;
+
+int main()
+{
+   char myGrade = 'A';
+   switch (myGrade)
+   {
+      case 'A':
+            cout << "You pass" << endl;
+            break;
+      case 'B':
+            cout << "You fail" << endl;
+            break;
+      default:
+            cout << "Invalid grade" << endl;
+   }
+
+   return 0;
+}
+
+
+
+
+

User Input

+
#include <iostream>
+#include <string>
+using namespace std;
+
+int main()
+{
+   string name;
+   cout << "Enter your name: ";
+   cin >> name;
+   cout << "Hello " << name << endl;
+
+   int num1, num2;
+   cout << "Enter first number: ";
+   cin >> num1;
+   cout << "Enter second number: ";
+   cin >> num2;
+   cout << "Answer: " << num1 + num2 << endl;
+
+   return 0;
+}
+
+
+
+
+

Variables

+
#include <iostream>
+#include <string>
+using namespace std;
+
+int main()
+{
+   /*
+      Traits:
+      - Case-sensitive
+      - May begin with letters
+      - Can include letters, numbers, or _
+     Convention:
+      - First word lower-case, rest upper-case (camelCase)
+      - Example: myVariable
+   */
+
+   string name = "Mike"; // string of characters, not primitive
+   char testGrade = 'A'; // single 8-bit character
+
+   // NOTE: You can make them unsigned by adding the "unsigned" prefix
+   short age0 = 10;     // atleast 16-bit signed integer
+   int age1 = 20;       // atleast 16-bits signed integer (not smaller than short)
+   long age2 = 30;      // atleast 32-bits signed integer
+   long long age3 = 40; // atleast 64-bits signed integer
+
+   float gpa0 = 2.5f;      // single percision floating point
+   double gpa1 = 3.5l;     // double-precision floating point
+   long double gpa2 = 3.5; // extended-precision floating point
+
+   bool isTall; // 1-bit -> true/false
+   isTall = true;
+
+   return 0;
+}
+
+
+
+
+

Vectors

+
#include <iostream>
+#include <string>
+#include <vector>
+using namespace std;
+
+int main()
+{
+   // Define a vector of strings
+   vector<string> friends;
+   // Append 3 strings into the vector
+   friends.push_back("Oscar");
+   friends.push_back("Angela");
+   friends.push_back("Kevin");
+   // Append "Jim" at the 2nd index of the vendor
+   friends.insert(friends.begin() + 1, "Jim");
+
+   // Print out the friend vector's first 3 members
+   cout << friends.at(0) << endl;
+   cout << friends.at(1) << endl;
+   cout << friends.at(2) << endl;
+   // Print out the friend vector's size
+   cout << friends.size() << endl;
+
+   return 0;
+}
+
+
+
+
+

While Loops

+
#include <iostream>
+using namespace std;
+
+int main()
+{
+   // Notify that this is a while loop
+   cout << "Executing while loop" << endl;
+
+   // Do while loop
+   int index = 1;
+   while (index <= 5)
+   {
+      cout << index << endl;
+      index++;
+   }
+
+   // Notify that this is a do-while loop
+   cout << "Executing do-while loop" << endl;
+
+   do
+   {
+      cout << index << endl;
+      index++;
+   } while (index <= 5);
+
+   return 0;
+}
+
+
+
+
+ + +
+
+   + +
+ +
+
+
+
+
+ ©2024, papadanku. + + | + Powered by Sphinx 8.0.2 + & Alabaster 1.0.0 + + | + Page source +
+ + + + + + \ No newline at end of file diff --git a/source/blog/gaussianblur.html b/source/blog/gaussianblur.html new file mode 100644 index 0000000..c603fa4 --- /dev/null +++ b/source/blog/gaussianblur.html @@ -0,0 +1,182 @@ + + + + + + + + RasterGrid’s Gaussian Blur in HLSL — A Shaderboy's Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+
+ + +
+ +
+

RasterGrid’s Gaussian Blur in HLSL

+

Gaussian blurs sample many pixels. RasterGrid optimized Gaussian blur by sampling in-between pixels. RasterGrid’s article did not include shader code for varied Gaussian blur radii. This post solves that.

+
+

Source Code

+
float GetGaussianWeight(float SampleIndex, float Sigma)
+{
+   const float Pi = 3.1415926535897932384626433832795f;
+   float Output = rsqrt(2.0 * Pi * (Sigma * Sigma));
+   return Output * exp(-(SampleIndex * SampleIndex) / (2.0 * Sigma * Sigma));
+}
+
+float GetGaussianOffset(float SampleIndex, float Sigma, out float LinearWeight)
+{
+   float Offset1 = SampleIndex;
+   float Offset2 = SampleIndex + 1.0;
+   float Weight1 = GetGaussianWeight(Offset1, Sigma);
+   float Weight2 = GetGaussianWeight(Offset2, Sigma);
+   LinearWeight = Weight1 + Weight2;
+   return ((Offset1 * Weight1) + (Offset2 * Weight2)) / LinearWeight;
+}
+
+float4 GetGaussianBlur(float2 Tex, float LOD, float2 PixelSize, float Sigma)
+{
+   // Sample and weight center first to get even number sides
+   float TotalWeight = GetGaussianWeight(0.0, Sigma);
+   float4 OutputColor = tex2Dlod(SampleColorTex, float4(Tex, 0.0, LOD)) * TotalWeight;
+
+   for(float i = 1.0; i < Sigma * 3.0; i += 2.0)
+   {
+      float LinearWeight = 0.0;
+      float LinearOffset = GetGaussianOffset(i, Sigma, LinearWeight);
+      OutputColor += tex2Dlod(SampleColorTex, float4(Tex - (LinearOffset * PixelSize), 0.0, LOD)) * LinearWeight;
+      OutputColor += tex2Dlod(SampleColorTex, float4(Tex + (LinearOffset * PixelSize), 0.0, LOD)) * LinearWeight;
+      TotalWeight += LinearWeight * 2.0;
+   }
+
+   // Normalize intensity to prevent altered output
+   return OutputColor / TotalWeight;
+}
+
+
+
+
+ + +
+
+   + +
+ +
+
+
+
+
+ ©2024, papadanku. + + | + Powered by Sphinx 8.0.2 + & Alabaster 1.0.0 + + | + Page source +
+ + + + + + \ No newline at end of file diff --git a/source/blog/logdepth.html b/source/blog/logdepth.html new file mode 100644 index 0000000..24a473a --- /dev/null +++ b/source/blog/logdepth.html @@ -0,0 +1,201 @@ + + + + + + + + Logarithmic Depth Buffering in HLSL — A Shaderboy's Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+
+ + +
+ +
+

Logarithmic Depth Buffering in HLSL

+

The Project Reality Team implemented logarithmic depth buffering for the 1.7.3 update. This post covers our implementation of simple logarithmic depth buffering in HLSL.

+

Outerra has an optimized 2013 implementation of logarithmic depth in GLSL. This is our simplified version of Outerra’s logarithmic depth in HLSL.

+
+

Source Code

+
float4x4 _WorldViewProj : WorldViewProj;
+
+struct APP2VS
+{
+   float4 Pos : POSITION0;
+};
+
+struct VS2PS
+{
+   float4 HPos : POSITION;
+   float Depth : TEXCOORD0;
+};
+
+struct PS2FB
+{
+   float4 Color : COLOR;
+   float Depth : DEPTH;
+};
+
+// Converts linear depth to logarithmic depth in the pixel shader
+// Source: https://outerra.blogspot.com/2013/07/logarithmic-depth-buffer-optimizations.html
+float ApplyLogarithmicDepth(float Depth)
+{
+   const float FarPlane = 10000.0;
+   const float FCoef = 1.0 / log2(FarPlane + 1.0);
+   return log2(Depth) * FCoef;
+}
+
+VS2PS VS_LogDepth(APP2VS Input)
+{
+   VS2PS Output = (VS2PS)0;
+
+   // Usually a transformation happens here
+   Output.HPos = mul(float4(Input.Pos.xyz, 1.0), _WorldViewProj);
+
+   // Output depth
+   Output.Depth = Output.HPos.w + 1.0;
+
+   return Output;
+}
+
+PS2FB PS_LogDepth(VS2PS Input)
+{
+   PS2FB Output;
+
+   // You need to output something to the color buffer
+   Output.Color = 0.0;
+
+   // You must output to the pixel shader’s DEPTH semantic so the GPU can do per-fragment depth testing.
+   Output.Depth = ApplyLogarithmicDepth(Input.Depth);
+
+   return Output;
+};
+
+
+
+
+ + +
+
+   + +
+ +
+
+
+
+
+ ©2024, papadanku. + + | + Powered by Sphinx 8.0.2 + & Alabaster 1.0.0 + + | + Page source +
+ + + + + + \ No newline at end of file diff --git a/source/blog/loops.html b/source/blog/loops.html new file mode 100644 index 0000000..2fe3405 --- /dev/null +++ b/source/blog/loops.html @@ -0,0 +1,223 @@ + + + + + + + + Turning a Nested 2D Loop into 1D — A Shaderboy's Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+
+ + +
+ +
+

Turning a Nested 2D Loop into 1D

+

In GPU programming, you might sample a 2D window with a nested. However, a nested loop might be more inefficient than 1 loop.

+

This post is an example of how to sample a 3x3 window of offsets in 1 loop.

+
+

Source Code

+
// Get required data to calculate main window data
+const int WindowSize = 3;
+const int WindowHalf = trunc(WindowSize / 2);
+
+// Start from the negative so we can process a window in 1 loop
+[loop] for (int i = 0; i < (WindowSize * WindowSize); i++)
+{
+   float2 XY = -WindowHalf + float2(i % WindowSize, trunc(i / WindowSize));
+}
+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

i#

X

Y

0

-1 + (0 % 3)

-1

-1 + trunc(0 / 3)

-1

1

-1 + (1 % 3)

0

-1 + trunc(1 / 3)

-1

2

-1 + (2 % 3)

1

-1 + trunc(2 / 3)

-1

3

-1 + (3 % 3)

-1

-1 + trunc(3 / 3)

0

4

-1 + (4 % 3)

0

-1 + trunc(4 / 3)

0

5

-1 + (5 % 3)

1

-1 + trunc(5 / 3)

0

6

-1 + (6 % 3)

-1

-1 + trunc(6 / 3)

1

7

-1 + (7 % 3)

0

-1 + trunc(7 / 3)

1

8

-1 + (8 % 3)

1

-1 + trunc(8 / 3)

1

+
+
+ + +
+
+   + +
+ +
+
+
+
+
+ ©2024, papadanku. + + | + Powered by Sphinx 8.0.2 + & Alabaster 1.0.0 + + | + Page source +
+ + + + + + \ No newline at end of file diff --git a/source/blog/opticalflow.html b/source/blog/opticalflow.html new file mode 100644 index 0000000..56cc9f8 --- /dev/null +++ b/source/blog/opticalflow.html @@ -0,0 +1,356 @@ + + + + + + + + Lucas-Kanade Optical Flow in HLSL — A Shaderboy's Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+
+ + +
+ +
+

Lucas-Kanade Optical Flow in HLSL

+

An optical flow algorithm estimates the motion between frames. Optical flow is essential in object detection, object recognition, motion estimation, video compression, and video effects.

+

This post covers an HLSL implementation of Lucas-Kanade optical flow.

+
+

Algorithm

+

The pyramid LK algorithm consists of the following steps.

+
    +

  1. Build the current frame’s mipmap pyramid

    +

    Encode the image into chromaticity with GetSphericalRG()

    +
    2. +

  2. Filter the current frame with a Gaussian blur

    3. +

  3. Set the initial motion vector to <0.0, 0.0>

    4. +

  4. Compute optical flow from the smallest to largest pyramid level

    +

    Propagate the optical flow at each level

    +
    5. +

  5. Filter the optical flow with a Gaussian blur

    6. +

  6. Store the current frame for use in the next frame

    7. +
+
+

Note

+

The code contains generic functions, so you may need to change some parts of the code so it is compatible with your setup.

+
+
+
+

Source Code

+
/*
+    This code is based on the algorithm described in the following paper:
+    Author(s): Joost van de Weijer, T. Gevers
+    Title: "Robust optical flow from photometric invariants"
+    Year: 2004
+    DOI: 10.1109/ICIP.2004.1421433
+    Link: https://www.researchgate.net/publication/4138051_Robust_optical_flow_from_photometric_invariants
+*/
+
+float2 GetSphericalRG(float3 Color)
+{
+    const float HalfPi = 1.0 / acos(0.0);
+
+    // Precalculate (x*x + y*y)^0.5 and (x*x + y*y + z*z)^0.5
+    float L1 = length(Color.rg);
+    float L2 = length(Color.rgb);
+
+    float2 Angles = 0.0;
+    Angles[0] = (L1 == 0.0) ? 1.0 / sqrt(2.0) : Color.g / L1;
+    Angles[1] = (L2 == 0.0) ? 1.0 / sqrt(3.0) : L1 / L2;
+
+    return saturate(asin(abs(Angles)) * HalfPi);
+}
+
+float CMath_GetHalfMax()
+{
+    // Get the Half format distribution of bits
+    // Sign Exponent Significand
+    // 0    00000    000000000
+    const int SignBit = 0;
+    const int ExponentBits = 5;
+    const int SignificandBits = 10;
+
+    const int Bias = -15;
+    const int Exponent = exp2(ExponentBits);
+    const int Significand = exp2(SignificandBits);
+
+    const float MaxExponent = ((float)Exponent - (float)exp2(1)) + (float)Bias;
+    const float MaxSignificand = 1.0 + (((float)Significand - 1.0) / (float)Significand);
+
+    return (float)pow(-1, SignBit) * (float)exp2(MaxExponent) * MaxSignificand;
+}
+
+// [-HalfMax, HalfMax) -> [-1.0, 1.0)
+float2 CMath_HalfToNorm(float2 Half2)
+{
+    return clamp(Half2 / CMath_GetHalfMax(), -1.0, 1.0);
+}
+
+// [-1.0, 1.0) -> [-HalfMax, HalfMax)
+float2 CMath_NormToHalf(float2 Half2)
+{
+    return Half2 * CMath_GetHalfMax();
+}
+
+// [-1.0, 1.0] -> [Width, Height]
+float2 CMotionEstimation_UnnormalizeMV(float2 Vectors, float2 ImageSize)
+{
+    return Vectors / abs(ImageSize);
+}
+
+// [Width, Height] -> [-1.0, 1.0]
+float2 CMotionEstimation_NormalizeMV(float2 Vectors, float2 ImageSize)
+{
+    return clamp(Vectors * abs(ImageSize), -1.0, 1.0);
+}
+
+/*
+    Lucas-Kanade optical flow with bilinear fetches
+    ---
+    Calculate Lucas-Kanade optical flow by solving (A^-1 * B)
+    [A11 A12]^-1 [-B1] -> [ A11/D -A12/D] [-B1]
+    [A21 A22]^-1 [-B2] -> [-A21/D  A22/D] [-B2]
+    ---
+    [ Ix^2/D -IxIy/D] [-IxIt]
+    [-IxIy/D  Iy^2/D] [-IyIt]
+*/
+
+float2 CMotionEstimation_GetPixelPyLK
+(
+    float2 MainTex, // Texture coordinates in the [0.0, 1.0) range
+    float2 Vectors, // Vectors in the [-HalfMax, HalfMax) range
+    sampler2D SampleI0,
+    sampler2D SampleI1
+)
+{
+    // Initialize variables
+    float4 WarpTex;
+    float IxIx = 0.0;
+    float IyIy = 0.0;
+    float IxIy = 0.0;
+    float IxIt = 0.0;
+    float IyIt = 0.0;
+    float SSD = 0.0;
+
+    // Initiate main & warped texture coordinates
+    WarpTex = MainTex.xyxy;
+
+    // Calculate warped texture coordinates
+    WarpTex.zw -= 0.5; // Pull into [-0.5, 0.5) range
+    WarpTex.zw = CMath_NormToHalf(WarpTex.zw) + Vectors; // Warp in [-HalfMax, HalfMax) range
+    WarpTex.zw = CMath_HalfToNorm(WarpTex.zw) + 0.5; // Push into [0.0, 1.0) range
+    WarpTex.zw = saturate(WarpTex.zw); // Clamp into [0.0, 1.0) range
+
+    // Get gradient information
+    float4 TexIx = ddx(WarpTex);
+    float4 TexIy = ddy(WarpTex);
+    float2 PixelSize = abs(TexIx.xy) + abs(TexIy.xy);
+    float2x2 Rotation = CMath_GetRotationMatrix(45.0);
+
+    // Get required data to calculate main window data
+    const int WindowSize = 3;
+    const int WindowHalf = trunc(WindowSize / 2);
+
+    [loop] for (int i = 0; i < (WindowSize * WindowSize); i++)
+    {
+        float2 AngleShift = -WindowHalf + float2(i % WindowSize, trunc(i / WindowSize));
+        AngleShift = mul(Rotation, AngleShift);
+
+        // Get temporal gradient
+        float4 TexIT = WarpTex.xyzw + (AngleShift.xyxy * PixelSize.xyxy);
+        float2 I0 = tex2Dgrad(SampleI0, TexIT.xy, TexIx.xy, TexIy.xy).rg;
+        float2 I1 = tex2Dgrad(SampleI1, TexIT.zw, TexIx.zw, TexIy.zw).rg;
+        float2 IT = I0 - I1;
+
+        // Get spatial gradient
+        float4 OffsetNS = AngleShift.xyxy + float4(0.0, -1.0, 0.0, 1.0);
+        float4 OffsetEW = AngleShift.xyxy + float4(-1.0, 0.0, 1.0, 0.0);
+        float4 NS = WarpTex.xyxy + (OffsetNS * PixelSize.xyxy);
+        float4 EW = WarpTex.xyxy + (OffsetEW * PixelSize.xyxy);
+        float2 N = tex2Dgrad(SampleI0, NS.xy, TexIx.xy, TexIy.xy).rg;
+        float2 S = tex2Dgrad(SampleI0, NS.zw, TexIx.xy, TexIy.xy).rg;
+        float2 E = tex2Dgrad(SampleI0, EW.xy, TexIx.xy, TexIy.xy).rg;
+        float2 W = tex2Dgrad(SampleI0, EW.zw, TexIx.xy, TexIy.xy).rg;
+        float2 Ix = E - W;
+        float2 Iy = N - S;
+
+        // IxIx = A11; IyIy = A22; IxIy = A12/A22
+        IxIx += dot(Ix, Ix);
+        IyIy += dot(Iy, Iy);
+        IxIy += dot(Ix, Iy);
+
+        // IxIt = B1; IyIt = B2
+        IxIt += dot(Ix, IT);
+        IyIt += dot(Iy, IT);
+
+        SSD += dot(IT, IT);
+    }
+
+    /*
+        Calculate Lucas-Kanade matrix
+        ---
+        [ Ix^2/D -IxIy/D] [-IxIt]
+        [-IxIy/D  Iy^2/D] [-IyIt]
+    */
+
+    /*
+        Create a normalized SSD-based mask.
+        https://www.cs.huji.ac.il/~peleg/papers/HUJI-CSE-LTR-2006-39-LK-Plus.pdf
+    */
+
+    float M = (SSD / (IxIx + IyIy)) > 0.1;
+    IxIx *= M;
+    IyIy *= M;
+    IxIy *= M;
+    IxIt *= M;
+    IyIt *= M;
+
+    // Calculate A^-1 and B
+    float D = determinant(float2x2(IxIx, IxIy, IxIy, IyIy));
+    float2x2 A = float2x2(IyIy, -IxIy, -IxIy, IxIx) / D;
+    float2 B = float2(-IxIt, -IyIt);
+
+    // Calculate A^T*B
+    float2 Flow = (D > 0.0) ? mul(B, A) : 0.0;
+
+    // Convert motion vectors from Half -> Norm
+    Vectors = CMath_HalfToNorm(Vectors);
+
+    // Propagate normalized motion vectors in Norm Range
+    Vectors += CMotionEstimation_NormalizeMV(Flow, PixelSize);
+
+    // Clamp motion vectors to restrict range to valid lengths
+    Vectors = clamp(Vectors, -1.0, 1.0);
+
+    // Pack motion vectors to Half format
+    return CMath_NormToHalf(Vectors);
+}
+
+
+
+
+ + +
+
+   + +
+ +
+
+
+
+
+ ©2024, papadanku. + + | + Powered by Sphinx 8.0.2 + & Alabaster 1.0.0 + + | + Page source +
+ + + + + + \ No newline at end of file diff --git a/source/blog/outerralogdepth.html b/source/blog/outerralogdepth.html new file mode 100644 index 0000000..11b78bc --- /dev/null +++ b/source/blog/outerralogdepth.html @@ -0,0 +1,153 @@ + + + + + + + + Correcting Outerra’s Logarithmic Depth Buffering — A Shaderboy's Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+
+ + +
+ +
+

Correcting Outerra’s Logarithmic Depth Buffering

+

Outerra has a vertex shader implementation of log depth buffering in GLSL. However, Outerra missed a major part of their log depth buffering. This is our corrected version of Outerra’s log depth buffering in HLSL.

+

Outerra missed a multiply in the end. We must multiply log depth by W because the GPU automatically divides the vertex position HPos by W.

+
+

Source Code

+
// Output.HPos is the computed vertex position in homogeneous space
+const float FarPlane = 10000.0;
+const float FCoef = 1.0 / log2(FarPlane + 1.0);
+Output.HPos.z = saturate(log2(max(1e-6, Output.HPos.w)) * FCoef);
+Output.HPos.z *= Output.HPos.w;
+
+
+
+
+ + +
+
+   + +
+ +
+
+
+
+
+ ©2024, papadanku. + + | + Powered by Sphinx 8.0.2 + & Alabaster 1.0.0 + + | + Page source +
+ + + + + + \ No newline at end of file diff --git a/source/blog/pythonengine.html b/source/blog/pythonengine.html new file mode 100644 index 0000000..42aad1a --- /dev/null +++ b/source/blog/pythonengine.html @@ -0,0 +1,194 @@ + + + + + + + + A Pythonic 3D Engine in 1 Weekend — A Shaderboy's Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+
+ + +
+ +
+

A Pythonic 3D Engine in 1 Weekend

+

I spent this weekend following Coder Space’s Python 3D engine tutorial series. The tutorial covered the fundamentals of the OpenGL pipeline, from the CPU to the GPU.

+
+

Video 1: Main Tutorial

+

I learned about the OpenGL pipeline, starting from the CPU to the GPU. The first tutorial taught me how to…

+
    +

  1. Render basic geometry

    2. +

  2. Add a camera to a scene

    3. +

  3. Add Phong lighting into a scene

    4. +

  4. Refactor code to re-use buffer object data

    5. +

  5. Use Uniform transformations

    6. +

  6. Adopt Best practices in rendering

    +
      +

    • Mipmapping

      • +

    • Gamma correction

      • +
    +
    7. +

  7. Load external 3D models

    8. +
+
+

Note

+

I learned that VBOs are unformatted, allocated spaces of memory that store vertex-related data. However, we can use buffer objects for purposes other than being a VBO.

+
+
+
+

Video 2: SkyBox, Environment Mapping

+

I created a skybox for the rendering scene. The second tutorial taught me how to…

+
    +

  1. Refactor code with polymorphism

    2. +

  2. Make cube-maps with faces

    3. +

  3. Replace cube-based skybox with plane-based skybox

    4. +
+
+

Note

+

Implementing a plane-based skybox was difficult, to say the least.

+
+
+
+

Video 3: Shadow Mapping, PCF

+

I just created a smooth shadow-mapping system for objects.

+
+
+

Feedback

+

As someone who wanted to learn the graphics programming fundamentals, I found this series enjoyable to follow. I believe this tutorial can reach the masses if it also covers…

+
    +

  • Instancing

    • +

  • Deferred rendering

    • +

  • Generating vertex normal and tangent

    • +
+
+
+

Recommendation

+

I recommend this tutorial for people who already have experience with Python and want to get straight to crafting graphics. Thank you, Coder Space!

+
+
+ + +
+
+   + +
+ +
+
+
+
+
+ ©2024, papadanku. + + | + Powered by Sphinx 8.0.2 + & Alabaster 1.0.0 + + | + Page source +
+ + + + + + \ No newline at end of file diff --git a/source/blog/reshadefx.html b/source/blog/reshadefx.html new file mode 100644 index 0000000..0516558 --- /dev/null +++ b/source/blog/reshadefx.html @@ -0,0 +1,262 @@ + + + + + + + + ReShadeFX for Beginners — A Shaderboy's Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+
+ + +
+ +
+

ReShadeFX for Beginners

+

No bullshit, just move along.

+
+
Recap
+
Vertex Shader:
+

Code that does math on every vertex

+
+
Pixel Shader:
+

Code that does math on every pixel

+
+
+
+
+
+

What is a Shader?

+

A shader is code that does math.

+

A shader is like a drawing a square. Here is how you draw a red square:

+
    +

  1. You draw a dotted outline of the square.

    2. +

  2. You connect the dotted outline of the square.

    3. +

  3. You color red inside the square.

    4. +
+
+
+

Your First Vertex Shader

+
 1// Vertex shader generating a triangle covering the entire screen.
+ 2// See also https://www.reddit.com/r/gamedev/comments/2j17wk/a_slightly_faster_bufferless_vertex_shader_trick/
+ 3
+ 4// Make a function that calculate on each vertex.
+ 5// PostProcessVS() outputs a triangle that is twice the screen's size.
+ 6void PostProcessVS
+ 7(
+ 8    in uint id : SV_VertexID, // Get "id" from CPU memory named "SV_VertexID"
+ 9    out float4 position : SV_Position, // Send "position" to GPU memory named "SV_Position"
+10    out float2 texcoord : TEXCOORD // Send "texcoord" to GPU memory named "TEXCOORD"
+11)
+12{
+13    /*
+14        PART 1
+15        ---
+16        Use the vertex's ID to calculate its texture coordinates.
+17        NOTE: Texture coordinates are 0-1
+18        ---
+19        ID 0 -> texcoord (0.0, 0.0)
+20        ID 1 -> texcoord (0.0, 2.0)
+21        ID 2 -> texcoord (2.0, 0.0)
+22    */
+23
+24    // If the vertex's ID is 2, set the its texcoord's X position to 2.
+25    // If the vertex's ID is not 2, set its texcoord's X position to 0.
+26    texcoord.x = (id == 2) ? 2.0 : 0.0;
+27
+28    // If the vertex's ID is 1, set the its texcoord's Y position to 2.
+29    // If the vertex's ID is not 1, set its texcoord's Y position to 0.
+30    texcoord.y = (id == 1) ? 2.0 : 0.0;
+31
+32    /*
+33        PART 2
+34        ---
+35        We stretch the triangle to be twice the size of the screen.
+36        To do this, use the vertex's texture coordinates to calculate it's position in clip-space.
+37
+38        In clip-space, the values represent:
+39            Bottom-left of screen: (-1.0, -1.0)
+40            Bottom-right of screen: (1.0, -1.0)
+41            Top-left of screen: (-1.0, 1.0)
+42            Top-right of screen: (1.0, 1.0)
+43        ---
+44        texcoord (0.0, 0.0) -> position (-1.0, 1.0)
+45        texcoord (0.0, 2.0) -> position (-1.0, 3.0)
+46        texcoord (2.0, 0.0) -> position (3.0, 1.0)
+47    */
+48
+49    position = float4(texcoord * float2(2.0, -2.0) + float2(-1.0, 1.0), 0.0, 1.0);
+50
+51    /*
+52        PART 3
+53        ---
+54        1. The GPU will "clip" fragments that have a position beyond -1 or 1.
+55        2. The GPU will interpolate the "texcoord" and "position" data between vertices
+56    */
+57}
+
+
+
+
+

Your First Pixel Shader

+
 1// Make a function that calculate on each pixel.
+ 2// PostProcessPS() outputs a color on each of the triangle's pixel.
+ 3void PostProcessPS
+ 4(
+ 5    in float2 texcoord : TEXCOORD, // Get "texcoord" from GPU memory named "TEXCOORD"
+ 6    out float4 color : SV_Target // Send "color" to GPU memory named "SV_Target"
+ 7)
+ 8{
+ 9    /*
+10        Use the texcoord's XY value to set the triangle's red and green value.
+11            texcoord(1.0, 0.0) -> color(1.0, 0.0, 0.0, 1.0) -> all red
+12            texcoord(0.0, 1.0) -> color(1.0, 0.0, 0.0, 1.0) -> all green
+13            texcoord(1.0, 1.0) -> color(1.0, 1.0, 0.0, 1.0) -> mix of red and green
+14    */
+15    color.r = texcoord.x;
+16    color.g = texcoord.y;
+17    color.b = 0.0;
+18    color.a = 1.0;
+19}
+
+
+
+
+

Your First Technique

+
1technique ExampleShader
+2{
+3    pass
+4    {
+5        VertexShader = PostProcessVS;
+6        PixelShader = PostProcessPS;
+7    }
+8}
+
+
+
+
+ + +
+
+   + +
+ +
+
+
+
+
+ ©2024, papadanku. + + | + Powered by Sphinx 8.0.2 + & Alabaster 1.0.0 + + | + Page source +
+ + + + + + \ No newline at end of file diff --git a/source/blog/shadermodel3.html b/source/blog/shadermodel3.html new file mode 100644 index 0000000..759c879 --- /dev/null +++ b/source/blog/shadermodel3.html @@ -0,0 +1,267 @@ + + + + + + + + Project Reality: Shader Model 3.0 Considerations — A Shaderboy's Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+
+ + +
+ +
+

Project Reality: Shader Model 3.0 Considerations

+

The Project Reality Team updated Project Reality to support Shader Model 3. The update gave Project Reality more graphical potential. This post considerations when porting shaders from Shader Model 2 to 3.

+
+

Fogging

+

From Shader Model 3, fogging is no longer fixed-function. You must implement your fogging method in the pixel shader.

+
+
+

Output Register Count

+ +
+
+

Input Register Format

+ +
+
+

Register Assignments and Declarations

+

If you encounter the following asm, with constants not declared in ASM.

+
VertexShader = asm
+{
+    vs.1.1
+
+    dcl_position0 v0
+
+    add r0.xyz, v0.xzw, -c[0].xyz
+    mul r0.xyz, r0.xyz, c[1].xyw // z = 0, w = 1
+    add oPos.x, r0.x, -c[1].w
+    add oPos.y, r0.y, -c[1].w
+    mov oPos.z, r0.z
+    mov oPos.w, c[1].w // z = 0, w = 1
+    add r1, v0.y, -c[2].x
+    mul oD0, r1, c[2].y
+    mov oD0.a, c[1].z // z = 0
+};
+
+PixelShader = asm
+{
+    ps.1.1
+    mov r0, v0
+};
+
+
+

The solution: use the : register() to a shader variable to a particular register. You can read more about it here.

+
// Assign variables to registers because DICE didn't do so in their ASM.
+float4 Constant0 : register(c0); // c[0]
+float4 Constant1 : register(c1); // c[1]
+float4 Constant2 : register(c2); // c[2]
+
+struct APP2PS_ProjectRoad
+{
+    float4 Pos : POSITION0;
+};
+
+struct VS2PS_ProjectRoad
+{
+    float4 HPos : POSITION;
+    float4 Color : TEXCOORD0;
+};
+
+// VertexShader
+VS2PS_ProjectRoad VS_ProjectRoad(APP2PS_ProjectRoad Input)
+{
+    VS2PS_ProjectRoad Output = (VS2PS_ProjectRoad)0.0;
+
+    // add r0.xyz, v0.xzw, -c[0].xyz
+    // mul r0.xyz, r0.xyz, c[1].xyw // z = 0, w = 1
+    float3 ProjPos = Input.Pos.xzw - Constant0.xyz;
+    ProjPos *= Constant1.xyw; // z = 0, w = 1
+
+    // add oPos.x, r0.x, -c[1].w
+    // add oPos.y, r0.y, -c[1].w
+    // mov oPos.z, r0.z
+    // mov oPos.w, c[1].w // z = 0, w = 1
+    Output.HPos.x = ProjPos.x - Constant1.w;
+    Output.HPos.y = ProjPos.y - Constant1.w;
+    Output.HPos.z = ProjPos.z;
+    Output.HPos.w = Constant1.w; // z = 0, w = 1
+
+    // add r1, v0.y, -c[2].x
+    // mul oD0, r1, c[2].y
+    // mov oD0.a, c[1].z // z = 0
+    float4 Color = Input.Pos.y - Constant2.x;
+    Output.Color = Color * Constant2.y;
+    Output.Color.a = Constant1.z; // z = 0
+    Output.Color = saturate(Output.Color);
+
+    return Output;
+}
+
+// PixelShader
+float4 PS_ProjectRoad(VS2PS_ProjectRoad Input) : COLOR0
+{
+    // mov r0, v0
+    return Input.Color;
+}
+
+
+
+
+ + +
+
+   + +
+ +
+
+
+
+
+ ©2024, papadanku. + + | + Powered by Sphinx 8.0.2 + & Alabaster 1.0.0 + + | + Page source +
+ + + + + + \ No newline at end of file diff --git a/source/blog/sobel.html b/source/blog/sobel.html new file mode 100644 index 0000000..69f57a8 --- /dev/null +++ b/source/blog/sobel.html @@ -0,0 +1,158 @@ + + + + + + + + Bilinear Sobel Filtering in HLSL — A Shaderboy's Collection documentation + + + + + + + + + + + + + + + + + +
+ + +
+
+ + +
+ +
+

Bilinear Sobel Filtering in HLSL

+

The Sobel filter requires you to sample 8 pixels around the center pixel. The filter is linear, so you can sample 8 pixels in 4 texture fetches by sampling in-between pixels.

+
+

Source Code

+
struct Sobel
+{
+   float4 Ix;
+   float4 Iy;
+};
+
+Sobel GetSobel(sampler SampleImage, float2 Tex, float2 PixelSize)
+{
+   Sobel Output;
+   float4 A = tex2D(SampleImage, Tex + (float2(-0.5, +0.5) * PixelSize));
+   float4 B = tex2D(SampleImage, Tex + (float2(+0.5, +0.5) * PixelSize));
+   float4 C = tex2D(SampleImage, Tex + (float2(-0.5, -0.5) * PixelSize));
+   float4 D = tex2D(SampleImage, Tex + (float2(+0.5, -0.5) * PixelSize));
+   Output.Ix = (B + D) - (A + C);
+   Output.Iy = (A + B) - (C + D);
+   return Output;
+}
+
+
+
+
+ + +
+
+   + +
+ +
+
+
+
+
+ ©2024, papadanku. + + | + Powered by Sphinx 8.0.2 + & Alabaster 1.0.0 + + | + Page source +
+ + + + + + \ No newline at end of file diff --git a/source/social/instagram.html b/source/social/instagram.html new file mode 100644 index 0000000..6f40187 --- /dev/null +++ b/source/social/instagram.html @@ -0,0 +1,179 @@ + + + + + + + + Instagram — A Shaderboy's Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+
+ + +
+ +
+

Instagram

+
+

Account

+
+

Requirements

+
    +

  1. Description of the creator

    2. +

  2. Other links (if possible)

    3. +
+
+
+
+

Posts

+
+

Requirements

+
    +

  1. No Instagram filters or cropping

    2. +

  2. At least 1 sentence on what the content is about

    3. +

  3. Only 3 to 5 hashtags

    +
      +

    • Hashtags must be relevant

      • +

    • Hashtags must be different

      • +

    • Hashtag set must be mix of well known and niche

      • +
    +
    4. +
+
+
+
+

Templates

+
+

Uploading Images

+
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
+
+#hashtag1 #hashtag2 #hashtag3
+
+
+
+
+
+ + +
+
+   + +
+ +
+
+
+
+
+ ©2024, papadanku. + + | + Powered by Sphinx 8.0.2 + & Alabaster 1.0.0 + + | + Page source +
+ + + + + + \ No newline at end of file diff --git a/source/social/project.html b/source/social/project.html new file mode 100644 index 0000000..3a6351b --- /dev/null +++ b/source/social/project.html @@ -0,0 +1,178 @@ + + + + + + + + Personal Project — A Shaderboy's Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+
+ + +
+ +
+

Personal Project

+
+

Tools

+
+
Davinci Resolve

Editing and compositing Video

+
+
FFmpeg

Media conversion, used with yt-dlp

+
+
OBS Studio

Desktop recording

+
+
yt-dlp

Downloading media

+
+
+
+
+

Downloads

+ +
+
+

Useful Commands

+
+

yt-dlp

+
+
+yt-dlp -f bv+ba <link path>
+

Downloads the best video and audio from a link.

+
+ +
+
+yt-dlp -f bv+ba -a <.txt file path>
+

Downloads the best video and audio from a list.

+
+ +
+
+
+ + +
+
+   + +
+ +
+
+
+
+
+ ©2024, papadanku. + + | + Powered by Sphinx 8.0.2 + & Alabaster 1.0.0 + + | + Page source +
+ + + + + + \ No newline at end of file diff --git a/source/social/youtube.html b/source/social/youtube.html new file mode 100644 index 0000000..ad0ab28 --- /dev/null +++ b/source/social/youtube.html @@ -0,0 +1,254 @@ + + + + + + + + YouTube — A Shaderboy's Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+
+ + +
+ +
+

YouTube

+
+

Account Requirements

+
    +

  1. Description of the channel

    2. +

  2. Methods of contact (if possible)

    3. +

  3. Other links (if possible)

    4. +
+
+
+

Video Requirements

+
    +

  1. Description

    +
      +

    1. At least 1 sentence on what the video is about

      2. +

    2. Timecodes (if needed)

      3. +

    3. All sources used in the video, including their respective authors

      4. +

    4. Only 3 hashtags related to the video

      +
        +

      • Hashtags must be relevant

        • +

      • Hashtags must be different

        • +

      • Hashtag set must be mix of well known and niche

        • +

      • Re-use hashtags across similar videos, especially if they share a playlist.

        • +
      +
      5. +

    5. No unnecessary keywords

      6. +
    +
    2. +

  2. High-definition thumbnails

    3. +

  3. Associated playlist(s)

    4. +

  4. Only 3 to 5 tags

    +
      +

    • Tags should be lower-case

      • +

    • Tags should be left-to-right, from least-to-most specific

      • +

    • Re-use hashtags across similar videos, especially if they share a playlist.

      • +
    +
    5. +

  5. Appropriate category

    6. +

  6. Scheduled at 12:00am before the following..

    +
      +

    • Weekends (Friday and Saturday)

      • +

    • Related events, such as holidays

      • +
    +
    7. +
+
+
+

Video Template

+ + + + + + + + + + + + + + + +

Title

Playlist

Tags

Category

Video Name • Video Subject

Generic Playlist

alternative title 1, alternative title 2, alternative title 3

People & Blogs

+
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
+
+0:00 | Event 1
+1:00 | Event 2
+
+*Links*
+• Link 1 Name: Link
+• Link 2 Name: Link
+
+*Products in This Video*
+• Product Link 1: Link
+• Product Link 2: Link
+
+Product description...
+
+*Audio Sources*
+• Recording Name (Author Name): Link
+• Song Name (Author Name): Link
+
+*Video Sources*
+• Channel Name: Link
+• Video Name (Author Name): Link
+• Video Re-upload Name (Re-upload Author Name, Original Author: Original Author Name): Link
+
+*What I Used to Make This Video*
+• Tool 1: Link
+• Tool 2: Link
+
+*Notes*
+• Rhoncus urna neque viverra justo nec ultrices dui sapien.
+
+*Disclaimer*
+• For non-commercial purposes only. Feel free to claim this video content if you own the song.
+
+#hashtag1 #hashtag2 #hashtag3
+
+
+
+

Note

+

Do not include Author Name if they are already included in the source’s name.

+
+
No:
+

Project Reality Standalone Trailer (Project Reality): https://youtu.be/vkYX41j6ZbA

+
+
Yes:
+

Project Reality Standalone Trailer: https://youtu.be/vkYX41j6ZbA

+
+
+
+
+
+ + +
+
+   + +
+ +
+
+
+
+
+ ©2024, papadanku. + + | + Powered by Sphinx 8.0.2 + & Alabaster 1.0.0 + + | + Page source +
+ + + + + + \ No newline at end of file