From 92d02264af1f8e4bc46345e4024fcab8ea37acdd Mon Sep 17 00:00:00 2001 From: papadanku Date: Sat, 3 Aug 2024 23:32:43 +0000 Subject: [PATCH] deploy: 7627c41d8664242a06299e42624e80187d152ee5 --- .buildinfo | 4 + .doctrees/environment.pickle | Bin 0 -> 51836 bytes .doctrees/index.doctree | Bin 0 -> 3520 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 -> 14498 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 -> 13954 bytes .doctrees/source/blog/opticalflow.doctree | Bin 0 -> 17448 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 -> 9775 bytes .doctrees/source/social/youtube.doctree | Bin 0 -> 18499 bytes .nojekyll | 0 _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 | 102 ++ _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 | 38 + _sources/source/blog/opticalflow.rst.txt | 205 ++++ _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 | 100 ++ _static/basic.css | 925 ++++++++++++++++++ _static/doctools.js | 156 +++ _static/documentation_options.js | 13 + _static/file.png | Bin 0 -> 286 bytes _static/language_data.js | 199 ++++ _static/minus.png | Bin 0 -> 90 bytes _static/plus.png | Bin 0 -> 90 bytes _static/pygments.css | 75 ++ _static/searchtools.js | 620 ++++++++++++ _static/sphinx-logo.svg | 4 + _static/sphinx13.css | 697 +++++++++++++ _static/sphinx_highlight.js | 154 +++ genindex.html | 124 +++ index.html | 247 +++++ objects.inv | 6 + search.html | 142 +++ searchindex.js | 1 + source/blog/autoexposure.html | 272 +++++ source/blog/censustransform.html | 193 ++++ source/blog/chromaticity.html | 267 +++++ source/blog/coordinatespaces.html | 183 ++++ source/blog/cpp.html | 897 +++++++++++++++++ source/blog/gaussianblur.html | 192 ++++ source/blog/logdepth.html | 211 ++++ source/blog/loops.html | 236 +++++ source/blog/opticalflow.html | 349 +++++++ source/blog/outerralogdepth.html | 163 +++ source/blog/pythonengine.html | 208 ++++ source/blog/reshadefx.html | 275 ++++++ source/blog/shadermodel3.html | 280 ++++++ source/blog/sobel.html | 165 ++++ source/social/instagram.html | 200 ++++ source/social/project.html | 193 ++++ source/social/youtube.html | 267 +++++ 73 files changed, 9852 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 _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/basic.css create mode 100644 _static/doctools.js create mode 100644 _static/documentation_options.js create mode 100644 _static/file.png 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-logo.svg create mode 100644 _static/sphinx13.css 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..8c72ccb --- /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: 16134c3f9da7596b519e45c0ceca9f52 +tags: 645f666f9bcd5a90fca523b33c5a78b7 diff --git a/.doctrees/environment.pickle b/.doctrees/environment.pickle new file mode 100644 index 0000000000000000000000000000000000000000..9959cca6a5f34b2cdaec3449b23fb70629840b08 GIT binary patch literal 51836 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 literal 0 HcmV?d00001 diff --git a/.doctrees/index.doctree b/.doctrees/index.doctree new file mode 100644 index 0000000000000000000000000000000000000000..c8ed9bbe9297284be20f7eddb7b4cabed26839d1 GIT binary patch literal 3520 zcma)9ZEIu4751)IvSeHKdb69R?7H1hl5A)!l_nobp`~O?H?12bgpv<|a2ee@x@W4n zGdJ_HmIzB5Xv!LfK*;S+>DT_YJ~LO6B_$tX5Z0WTIdAiv=N$dB^Pm3?_R?QCwKWMf zAF`rQy5P16y+Y@{;>tDOHE(~_yl9?;zF}8Zdz14f?BPUCLKcRr=JO_;#N$p#J6zsB zusnA{tMzs2P?ruqZ=O&;bewRKZ)}C$2fE@lD|r*o;K-f7@p-hpvGaA)`q8Z!th$EI zLO)x(N&BI@^llvPNTGN$_7fHknR7-=yhBtmihWVo=$tSorh;5g6AXSmEvY}rOj+qvzir5&HS(wj{IaO^bgA5 z`bemP&xgh$nx9?n`w1fN<+`f1SH(tt+SJh=oY1*5d^2~;y`LjEdL6m@1wL=!^A^sVJNFjaJ3ryr z;^A1RT>64fg>0?RALxDhBM-fb%?n;TYA$ah^Q=zL2(LcX%E76}PYq{L^!S+<1>kk3 zlzP&<3|$gM0fb$L!BX{F&{MveaKnq{axWYvKv}Ki0%s2a)SFP#a%GbK;^~+4YdWWQ zknj#3as-gjX7a-6GRGHJhSfDU4cp9Tynk^6fT#yJqhVVlE0oi_JL^pgo9dwHcl3Ld z#TZ4Hifc5Hx*X+oowEJfrjU83`MlQFo0#x%c(}Qnb7j4ChABJMrhTlf>p2-+AU&!OJ1o4Kswv_-$dt{Qt6#=KOsw|I?ccqC34(SYR75EWLt+3eK?cK(nou@!b$E; zB4`c6d&jnEq3~fV;gTmwc7=A3t=bOkEiWwl5Yl3J zt&Phhe+~?SDG!Os^|BMr_*@{1jyZ2vhdQBC@QE*B?&OLYg)HI(=(K{Qk0;A{3<+F% zA{26#ag}S7dD(=%chigCTv&nckG3~6)SfmOF;z$qAYg#l&>X^PoB0hbous7+=Q}$) zD(HXVq*Z$3!0PIw?TwwA;cg57pt6MgNCeb`fn=)m7#EQ4*e`CQM}$`l&p}}sScs#o zsyw#3ap>k+O%Wr~A&M0ms2ffqn`Sqna9aRtgThyJw#Fl}ngjxU$|xqI!qX&K^X!eN zw%ivwn^zG{cN0agL}_zgxZH?e`@VWPGI?|pGG6W_cFtBD_Y<)%Lfe5yW=b((X{366N$Do=gtlWafB<=W%$B9^@Bq{OUdA^TbT^ z9raOiqyEj6dQ>ipc%5-G6x>adjW{Ebt0au|9h;zpia12{!Z`q0W$VgZ2au)ag(2Xs zT`0%q8Hti4J^=3>sUz->ZN*S!UwD+XMWS9w>vow*jg|y4ro!`_82rJ*x5b7mrxfD$ z%-1jxhu$=JEI9yE3M4{Jfq^9{+>0z>{bc8us3LZyW^E^#Tl&U^eiXPx4G&*5^zF5! z*YW=wI<{f3`Bv%n0CPy&O`x%r#FAW{Yu((GL>wh4-nN=(xqkj6yuTw{pYCsI?60h* zOZT?)gIbMiP%961buD)=X@W3vOy@ua+DWdZL}HOb^oxV1OZj&Q{_ExwfFHk9P)7J| mVe#Ir!8LDeiI3Le^khfNX%`SF<7*ujk=m9l5SurCRs0_-E_aat literal 0 HcmV?d00001 diff --git a/.doctrees/source/blog/autoexposure.doctree b/.doctrees/source/blog/autoexposure.doctree new file mode 100644 index 0000000000000000000000000000000000000000..f0265574b10314576931c9886ca8f9d77a8d5594 GIT binary patch literal 11833 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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..1a92e8327d6e270270c05af8eb6b0594d24baa18 GIT binary patch literal 14498 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 literal 0 HcmV?d00001 diff --git a/.doctrees/source/blog/coordinatespaces.doctree b/.doctrees/source/blog/coordinatespaces.doctree new file mode 100644 index 0000000000000000000000000000000000000000..c2c1092907ed29a1248a022c49e62c8ea43fda4e GIT binary patch literal 9540 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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..d588e7ac06e13333a550dce251166666cede7494 GIT binary patch literal 13954 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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..a0c8b581f8d232b5b3698669afdf067008d472b8 GIT binary patch literal 9775 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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..f54c93060ce77a81c89f302805b6fc77df8040c9 GIT binary patch literal 18499 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 literal 0 HcmV?d00001 diff --git a/.nojekyll b/.nojekyll new file mode 100644 index 0000000..e69de29 diff --git a/_sources/index.rst.txt b/_sources/index.rst.txt new file mode 100644 index 0000000..bdb6e91 --- /dev/null +++ b/_sources/index.rst.txt @@ -0,0 +1,19 @@ + +Homepage +======== + +.. toctree:: + :caption: Content Creation Guide + :glob: + :maxdepth: 2 + + source/social/project + source/social/* + +.. toctree:: + :caption: Graphics Programming Blog + :glob: + :maxdepth: 2 + + 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..81c4251 --- /dev/null +++ b/_sources/source/blog/chromaticity.rst.txt @@ -0,0 +1,102 @@ + +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..92eaab9 --- /dev/null +++ b/_sources/source/blog/loops.rst.txt @@ -0,0 +1,38 @@ + +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)); + } + +.. note:: + + == ============ == ================= == + 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..9202428 --- /dev/null +++ b/_sources/source/blog/opticalflow.rst.txt @@ -0,0 +1,205 @@ + +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 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; + } + + // [-Half, Half] -> [-1.0, 1.0] + float2 UnpackMotionVectors(float2 Half2) + { + return clamp(Half2 / GetHalfMax(), -1.0, 1.0); + } + + // [-1.0, 1.0] -> [-Half, Half] + float2 PackMotionVectors(float2 Half2) + { + return Half2 * GetHalfMax(); + } + + // [-1.0, 1.0] -> [Width, Height] + float2 UnnormalizeMotionVectors(float2 Vectors, float2 ImageSize) + { + return Vectors / abs(ImageSize); + } + + // [Width, Height] -> [-1.0, 1.0] + float2 NormalizeMotionVectors(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 GetPixelPyLK + ( + float2 MainTex, + float2 Vectors, + 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; + + // Get required data to calculate main texel data + const float Pi2 = acos(-1.0) * 2.0; + + // Unpack motion vectors + Vectors = UnpackMotionVectors(Vectors); + + // Calculate main texel data (TexelSize, TexelLOD) + WarpTex = float4(MainTex, MainTex + Vectors); + + // Get gradient information + float4 TexIx = ddx(WarpTex); + float4 TexIy = ddy(WarpTex); + float2 PixelSize = abs(TexIx.xy) + abs(TexIy.xy); + + [loop] for(int i = 1; i < 4; ++i) + { + [loop] for(int j = 0; j < 4 * i; ++j) + { + float Shift = (Pi2 / (4.0 * float(i))) * float(j); + float2 AngleShift = 0.0; + sincos(Shift, AngleShift.x, AngleShift.y); + AngleShift *= float(i); + + // 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); + } + } + + /* + Calculate Lucas-Kanade matrix + --- + [ Ix^2/D -IxIy/D] [-IxIt] + [-IxIy/D Iy^2/D] [-IyIt] + */ + + // 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) ? 0.0 : mul(B, A); + + // Propagate normalized motion vectors + Vectors += NormalizeMotionVectors(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 PackMotionVectors(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..75af92f --- /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..b6702bd --- /dev/null +++ b/_sources/source/social/youtube.rst.txt @@ -0,0 +1,100 @@ + +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 +-------------- + +.. 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`` + +.. list-table:: Template + :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 diff --git a/_static/basic.css b/_static/basic.css new file mode 100644 index 0000000..f316efc --- /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: 360px; + 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/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/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..84ab303 --- /dev/null +++ b/_static/pygments.css @@ -0,0 +1,75 @@ +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: #3D7B7B; font-style: italic } /* Comment */ +.highlight .err { border: 1px solid #FF0000 } /* Error */ +.highlight .k { color: #008000; font-weight: bold } /* Keyword */ +.highlight .o { color: #666666 } /* Operator */ +.highlight .ch { color: #3D7B7B; font-style: italic } /* Comment.Hashbang */ +.highlight .cm { color: #3D7B7B; font-style: italic } /* Comment.Multiline */ +.highlight .cp { color: #9C6500 } /* Comment.Preproc */ +.highlight .cpf { color: #3D7B7B; font-style: italic } /* Comment.PreprocFile */ +.highlight .c1 { color: #3D7B7B; font-style: italic } /* Comment.Single */ +.highlight .cs { color: #3D7B7B; font-style: italic } /* Comment.Special */ +.highlight .gd { color: #A00000 } /* Generic.Deleted */ +.highlight .ge { font-style: italic } /* Generic.Emph */ +.highlight .ges { font-weight: bold; font-style: italic } /* Generic.EmphStrong */ +.highlight .gr { color: #E40000 } /* Generic.Error */ +.highlight .gh { color: #000080; font-weight: bold } /* Generic.Heading */ +.highlight .gi { color: #008400 } /* Generic.Inserted */ +.highlight .go { color: #717171 } /* Generic.Output */ +.highlight .gp { color: #000080; font-weight: bold } /* Generic.Prompt */ +.highlight .gs { font-weight: bold } /* Generic.Strong */ +.highlight .gu { color: #800080; font-weight: bold } /* Generic.Subheading */ +.highlight .gt { color: #0044DD } /* Generic.Traceback */ +.highlight .kc { color: #008000; font-weight: bold } /* Keyword.Constant */ +.highlight .kd { color: #008000; font-weight: bold } /* Keyword.Declaration */ +.highlight .kn { color: #008000; font-weight: bold } /* Keyword.Namespace */ +.highlight .kp { color: #008000 } /* Keyword.Pseudo */ +.highlight .kr { color: #008000; font-weight: bold } /* Keyword.Reserved */ +.highlight .kt { color: #B00040 } /* Keyword.Type */ +.highlight .m { color: #666666 } /* Literal.Number */ +.highlight .s { color: #BA2121 } /* Literal.String */ +.highlight .na { color: #687822 } /* Name.Attribute */ +.highlight .nb { color: #008000 } /* Name.Builtin */ +.highlight .nc { color: #0000FF; font-weight: bold } /* Name.Class */ +.highlight .no { color: #880000 } /* Name.Constant */ +.highlight .nd { color: #AA22FF } /* Name.Decorator */ +.highlight .ni { color: #717171; font-weight: bold } /* Name.Entity */ +.highlight .ne { color: #CB3F38; font-weight: bold } /* Name.Exception */ +.highlight .nf { color: #0000FF } /* Name.Function */ +.highlight .nl { color: #767600 } /* Name.Label */ +.highlight .nn { color: #0000FF; font-weight: bold } /* Name.Namespace */ +.highlight .nt { color: #008000; font-weight: bold } /* Name.Tag */ +.highlight .nv { color: #19177C } /* Name.Variable */ +.highlight .ow { color: #AA22FF; font-weight: bold } /* Operator.Word */ +.highlight .w { color: #bbbbbb } /* Text.Whitespace */ +.highlight .mb { color: #666666 } /* Literal.Number.Bin */ +.highlight .mf { color: #666666 } /* Literal.Number.Float */ +.highlight .mh { color: #666666 } /* Literal.Number.Hex */ +.highlight .mi { color: #666666 } /* Literal.Number.Integer */ +.highlight .mo { color: #666666 } /* Literal.Number.Oct */ +.highlight .sa { color: #BA2121 } /* Literal.String.Affix */ +.highlight .sb { color: #BA2121 } /* Literal.String.Backtick */ +.highlight .sc { color: #BA2121 } /* Literal.String.Char */ +.highlight .dl { color: #BA2121 } /* Literal.String.Delimiter */ +.highlight .sd { color: #BA2121; font-style: italic } /* Literal.String.Doc */ +.highlight .s2 { color: #BA2121 } /* Literal.String.Double */ +.highlight .se { color: #AA5D1F; font-weight: bold } /* Literal.String.Escape */ +.highlight .sh { color: #BA2121 } /* Literal.String.Heredoc */ +.highlight .si { color: #A45A77; font-weight: bold } /* Literal.String.Interpol */ +.highlight .sx { color: #008000 } /* Literal.String.Other */ +.highlight .sr { color: #A45A77 } /* Literal.String.Regex */ +.highlight .s1 { color: #BA2121 } /* Literal.String.Single */ +.highlight .ss { color: #19177C } /* Literal.String.Symbol */ +.highlight .bp { color: #008000 } /* Name.Builtin.Pseudo */ +.highlight .fm { color: #0000FF } /* Name.Function.Magic */ +.highlight .vc { color: #19177C } /* Name.Variable.Class */ +.highlight .vg { color: #19177C } /* Name.Variable.Global */ +.highlight .vi { color: #19177C } /* Name.Variable.Instance */ +.highlight .vm { color: #19177C } /* Name.Variable.Magic */ +.highlight .il { color: #666666 } /* 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-logo.svg b/_static/sphinx-logo.svg new file mode 100644 index 0000000..b2b83c7 --- /dev/null +++ b/_static/sphinx-logo.svg @@ -0,0 +1,4 @@ + + + + diff --git a/_static/sphinx13.css b/_static/sphinx13.css new file mode 100644 index 0000000..e008e2f --- /dev/null +++ b/_static/sphinx13.css @@ -0,0 +1,697 @@ +/* Stylesheet for Sphinx's documentation */ + +/* Set master colours */ +:root { + --fonts-sans-serif: system-ui, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji"; + --colour-sphinx-blue: #0A507A; + --colour-text: #333; + --colour-links-light: #057; + --admonition-radius: 3px; + + /* colours for admonition titles */ + --color-admonition-bg: hsl(0, 0%, 90%); + --color-admonition-fg: hsl(0, 0%, 50%); + --colour-warning-bg: hsl(28.5, 74%, 90%); + --colour-warning-fg: hsl(28.5, 74%, 50%); + --colour-note-bg: hsl(219.5, 84%, 90%); + --colour-note-fg: hsl(219.5, 84%, 50%); + --colour-success-bg: hsl(150, 36.7%, 90%); + --colour-success-fg: hsl(150, 36.7%, 50%); + --colour-error-bg: hsl(0, 37%, 90%); + --colour-error-fg: hsl(0, 37%, 50%); + --colour-todo-bg: hsl(266.8, 100%, 90%); + --colour-todo-fg: hsl(266.8, 100%, 50%); + + /* icons used for admonition titles */ + --icon-pencil: url('data:image/svg+xml;charset=utf-8,'); + --icon-abstract: url('data:image/svg+xml;charset=utf-8,'); + --icon-info: url('data:image/svg+xml;charset=utf-8,'); + --icon-flame: url('data:image/svg+xml;charset=utf-8,'); + --icon-question: url('data:image/svg+xml;charset=utf-8,'); + --icon-warning: url('data:image/svg+xml;charset=utf-8,'); + --icon-failure: url('data:image/svg+xml;charset=utf-8,'); + --icon-spark: url('data:image/svg+xml;charset=utf-8,'); +} + +body { + font-family: var(--fonts-sans-serif); + margin: 0 auto; + color: var(var(--colour-text)); +} + +.pageheader { + position: sticky; + top: 0; + z-index: 99; + height: 3rem; + display: flex; + column-gap: 1em; + align-items: center; + justify-content: space-between; + width: 100%; + background-color: var(--colour-sphinx-blue); + padding: 10px 20px; + box-sizing: border-box; +} + +.pageheader .brand { + display: flex; + align-items: baseline; + column-gap: 1em; + color: white; + text-decoration: none; +} + +.pageheader .brand img { + width: 2em; + filter: invert(1) drop-shadow(1px 1px 2px black); +} + +.pageheader .brand span { + color: white; + margin-left: 0.4em; + font-weight: 400; + font-size: 2em; + line-height: 1; +} + +.pageheader .icons a { + color: white; +} + +.pageheader .icons a:hover { + color: rgba(255, 255, 255, 0.8); +} + +.pageheader .icons svg { + height: 1.6em; + width: 1.6em; +} + +div.document { + display: flex; + margin: 0 0.5em; +} + +div.body { + border-left: 1px solid var(--colour-sphinx-blue); + margin: 0; + padding: 0.5em 1.75em; + min-width: 0; + max-width: 800px; +} + +div.related { + position: sticky; + top: 3rem; + z-index: 99; + display: flex; + color: white; + background-color: var(--colour-sphinx-blue); + border-top: 1px solid #002e50; +} + +div.related ul li { + margin: 0 5px 0 0; + float: left; +} + +div.related ul li a { + padding: 0 5px 0 5px; + line-height: 1.75em; + color: white; +} + +div.related ul li a:hover { + text-shadow: 0 0 1px rgba(255, 255, 255, 0.5); +} + +div.sphinxsidebarwrapper { + padding: 0; +} + +div.sphinxsidebar { + position: sticky; + top: 4.6rem; + align-self: flex-start; + height: calc(100vh - 4.6rem); + width: 250px; + min-width: 150px; + overflow-y: auto; + overflow-wrap: break-word; + margin: 0; + padding: 0.5em 15px 0.5em 10px; + font-size: 1em; +} + +/* horizontal line between sidebar components */ +div.sphinxsidebar div:not(:first-child) { + border-top: 1px solid var(--colour-sphinx-blue); +} + +/* overwrite color from basic theme */ +div.sphinxsidebar input { + border: 1px solid var(--colour-sphinx-blue); +} + +div.sphinxsidebar h3 { + font-size: 1.2em; + font-weight: 300; + margin-top: 0; + margin-bottom: 0.5em; + padding-top: 0.5em; +} + +div.sphinxsidebar h4 { + font-size: 1.2em; + margin-bottom: 0; +} + +div.sphinxsidebar h3, div.sphinxsidebar h4 { + margin-right: -15px; + margin-left: -15px; + padding-right: 14px; + padding-left: 14px; + color: #333; + font-weight: 300; +} + +div.sphinxsidebar h3 a { + color: #333; +} + +div.sphinxsidebar ul { + color: #444; + margin-top: 7px; + padding: 0; + line-height: 130%; +} + +div.sphinxsidebar ul ul { + margin-left: 1rem; + list-style-type: none; + font-size: .9em; +} + +/* De-dent the first list because we hide the top-level item */ +.sphinxsidebar .sphinxsidebar-navigation__contents > ul > li > ul { + margin-left: 0; +} + +div.sphinxsidebar p.caption { + font-weight: 300; + font-size: 1.2rem; +} + +div.sphinxsidebar li.current > a { + font-weight: 600; +} + +.sphinxsidebar-navigation__contents > ul > li > a { + display: none; +} + +div.sphinxsidebar #searchbox { + margin: 12px 0 20px 0; +} + +div.sphinxsidebar #searchbox input[type="text"] { + border-radius: var(--admonition-radius) 0 0 var(--admonition-radius); +} + +div.sphinxsidebar #searchbox input[type="submit"] { + border-radius: 0 var(--admonition-radius) var(--admonition-radius) 0; + color: white; + background: var(--colour-sphinx-blue); +} + +div.footer { + background-color: var(--colour-sphinx-blue); + color: #ccc; + text-shadow: 0 0 .2px rgba(255, 255, 255, 0.8); + padding: 3px 8px 3px 8px; + clear: both; + font-size: 0.8em; +} + +/* no need to make a visible link to Sphinx on the Sphinx page */ +div.footer a { + color: #ccc; +} + +/* -- body styles ----------------------------------------------------------- */ + +.body :target { + /* ensure targets are not obscured by top-bar when they are navigated to */ + scroll-margin-top: 6.5rem; +} + +p { + margin: 0.8em 0 0.5em 0; + line-height: 1.5; +} + +a { + color: var(--colour-links-light); + text-decoration: none; +} + +div.body a { + text-decoration: underline; +} + +h1 { + margin: 10px 0 0 0; + font-size: 2.4em; + color: var(--colour-sphinx-blue); + font-weight: 400; +} + +h1 span.pre { + /* for code in titles */ + word-break: break-all; + white-space: normal; +} + +h2 { + margin: 1em 0 0.2em 0; + font-size: 1.5em; + font-weight: 400; + padding: 0; + color: #174967; +} + +h3 { + margin: 1em 0 -0.3em 0; + font-size: 1.3em; + font-weight: 400; +} + +div.body h1 a, div.body h2 a, div.body h3 a, div.body h4 a, div.body h5 a, div.body h6 a { + text-decoration: none; +} + +div.body h1 a tt, div.body h2 a tt, div.body h3 a tt, div.body h4 a tt, div.body h5 a tt, div.body h6 a tt { + color: var(--colour-sphinx-blue) !important; + font-size: inherit !important; +} + +a.headerlink { + color: var(--colour-sphinx-blue) !important; + font-size: .8em; + margin-left: 6px; + padding: 0 4px 0 4px; + text-decoration: none !important; +} + +a.headerlink:hover { + background-color: #ccc; + color: white!important; +} + +/* avoid font-size when :mod: role in headings */ +h1 code, h2 code, h3 code, h4 code { + font-size: inherit; +} + +cite, code, tt { + font-family: 'Consolas', 'DejaVu Sans Mono', + 'Bitstream Vera Sans Mono', monospace; + font-size: 1em; + letter-spacing: -0.02em; +} + +table.deprecated code.literal { + word-break: break-all; +} + +tt { + background-color: #f2f2f2; + border: 1px solid #ddd; + border-radius: 2px; + color: #333; + padding: 1px 0.2em; +} + +tt.descname, tt.descclassname, tt.xref { + border: 0; +} + +hr { + border: 1px solid #abc; + margin: 2em; +} + +a tt { + border: 0; + color: var(--colour-links-light); +} + +pre { + font-family: 'Consolas', 'Courier New', 'DejaVu Sans Mono', + 'Bitstream Vera Sans Mono', monospace; + font-size: 1em; + letter-spacing: 0.015em; + line-height: 120%; + padding: 0.5em; + border: 1px solid #ccc; + border-radius: 2px; + background-color: #f8f8f8; +} + +pre a { + color: inherit; + text-decoration: underline; +} + +td.linenos pre { + padding: 0.5em 0; +} + +div.quotebar { + background-color: #f8f8f8; + max-width: 250px; + float: right; + padding: 0px 7px; + border: 1px solid #ccc; + margin-left: 1em; +} + +blockquote.epigraph { + font-size: 1.5em; + padding-left: 1rem; + margin-left: 0; +} + +nav.contents, +div.topic, +aside.topic { + background-color: #f8f8f8; +} + +p.topic-title { + margin-top: 0; +} + +table { + border-collapse: collapse; + margin: 0 -0.5em 0 -0.5em; +} + +table td, table th { + padding: 0.2em 0.5em 0.2em 0.5em; +} + +div.admonition, div.warning { + font-size: 0.9em; + margin: 1em 0 1em 0; + border: 1px solid #86989B; + border-radius: var(--admonition-radius); + background-color: #f7f7f7; + padding: 1rem; +} + +div.admonition > p, div.warning > p { + margin: 0; + padding: 0; +} + +div.admonition > pre, div.warning > pre { + margin: 0.4em 1em 0.4em 1em; +} + +div.admonition > p.admonition-title { + position: relative; + font-weight: 500; + background-color: var(--color-admonition-bg); + margin: -1rem -1rem 0.8rem -1rem; + padding: 0.3rem 1rem 0.3rem 2rem; + border-radius: var(--admonition-radius) var(--admonition-radius) 0 0; +} + +div.attention > p.admonition-title, +div.danger > p.admonition-title, +div.error > p.admonition-title { + background-color: var(--colour-error-bg); +} + +div.important > p.admonition-title, +div.caution > p.admonition-title, +div.warning > p.admonition-title { + background-color: var(--colour-warning-bg); +} + +div.note > p.admonition-title { + background-color: var(--colour-note-bg); +} + +div.hint > p.admonition-title, +div.tip > p.admonition-title, +div.seealso > p.admonition-title { + background-color: var(--colour-success-bg); +} + +div.admonition-todo > p.admonition-title { + background-color: var(--colour-todo-bg); +} + +p.admonition-title::before { + content: ""; + height: 1rem; + left: .5rem; + top: .5rem; + position: absolute; + width: 1rem; + background-color: #5f5f5f; +} + +div.admonition > p.admonition-title::before { + background-color: var(--color-admonition-fg); + -webkit-mask-image: var(--icon-abstract); + mask-image: var(--icon-abstract); +} +div.attention > p.admonition-title::before { + background-color: var(--colour-error-fg); + -webkit-mask-image: var(--icon-warning); + mask-image: var(--icon-warning); +} +div.caution > p.admonition-title::before { + background-color: var(--colour-warning-fg); + -webkit-mask-image: var(--icon-spark); + mask-image: var(--icon-spark); +} +div.danger > p.admonition-title::before { + background-color: var(--colour-error-fg); + -webkit-mask-image: var(--icon-spark); + mask-image: var(--icon-spark); +} +div.error > p.admonition-title::before { + background-color: var(--colour-error-fg); + -webkit-mask-image: var(--icon-failure); + mask-image: var(--icon-failure); +} +div.hint > p.admonition-title::before { + background-color: var(--colour-success-fg); + -webkit-mask-image: var(--icon-question); + mask-image: var(--icon-question); +} +div.important > p.admonition-title::before { + background-color: var(--colour-warning-fg); + -webkit-mask-image: var(--icon-flame); + mask-image: var(--icon-flame); +} +div.note > p.admonition-title::before { + background-color: var(--colour-note-fg); + -webkit-mask-image: var(--icon-pencil); + mask-image: var(--icon-pencil); +} +div.seealso > p.admonition-title::before { + background-color: var(--colour-success-fg); + -webkit-mask-image: var(--icon-info); + mask-image: var(--icon-info); +} +div.tip > p.admonition-title::before { + background-color: var(--colour-success-fg); + -webkit-mask-image: var(--icon-info); + mask-image: var(--icon-info); +} +div.admonition-todo > p.admonition-title::before { + background-color: var(--colour-todo-fg); + -webkit-mask-image: var(--icon-pencil); + mask-image: var(--icon-pencil); +} +div.warning > p.admonition-title::before { + background-color: var(--colour-warning-fg); + -webkit-mask-image: var(--icon-warning); + mask-image: var(--icon-warning); +} +div.caution, +div.important, +div.warning { + border-color: var(--colour-warning-fg); +} +div.attention, +div.danger, +div.error { + border-color: var(--colour-error-fg); +} + +div.admonition > ul, +div.admonition > ol, +div.warning > ul, +div.warning > ol { + margin: 0.1em 0.5em 0.5em 3em; + padding: 0; +} + +div.admonition div.highlight { + background: none; +} + +.viewcode-back { + font-family: var(--fonts-sans-serif); +} + +div.viewcode-block:target { + background-color: #f4debf; + border-top: 1px solid #ac9; + border-bottom: 1px solid #ac9; +} + + +/* media queries */ + +/* Reduce padding & margins for smaller screens */ +@media (max-width: 768px) { + .sphinxsidebar { + display: none; + } + div.body { + border-left: none; + padding-left: 0.5em; + padding-right: 0.5em; + } +} + +/* Next/previous content footer */ +.related-pages { + display: flex; + flex-direction: row; + justify-content: space-between; + margin-top: 2rem; + font-size: smaller; +} +.related-pages .next-page { + text-align: right; +} +.related-pages a.prev-page, +.related-pages a.next-page { + flex: 1 1 0%; + display: flex; + align-items: center; + border-radius: .25rem; + padding: .25rem; + text-decoration: none; +} +.related-pages a.prev-page { + justify-content: flex-start; + padding-left: 0; +} +.related-pages a.next-page { + justify-content: flex-end; + padding-right: 0; +} +.related-pages a:hover { + background-color: #f8f8f8; +} +.related-pages a .context { + font-size: small; + color: #5f5f5f; +} +.related-pages svg { + height: .75rem; + width: .75rem; + margin: 0 .5rem; + flex-shrink: 0; +} +.related-pages .prev-page svg { + transform: rotate(180deg); +} + +/* ReadtheDocs docs selector */ +/* see https://docs.readthedocs.io/en/stable/flyout-menu.html */ +.rst-versions.rst-badge { + background-color: #f7f7f7; + border: 1px solid var(--colour-sphinx-blue); + border-radius: var(--admonition-radius); + color: var(--colour-sphinx-blue); +} +.rst-versions .rst-current-version { + background-color: #f7f7f7; + border-radius: var(--admonition-radius); + color: var(--colour-sphinx-blue); +} +.rst-versions .rst-current-version .fa { + color: var(--colour-sphinx-blue); +} +.rst-versions .rst-other-versions { + border-radius: 0 0 var(--admonition-radius) var(--admonition-radius); + border-top: 1px solid var(--colour-sphinx-blue); + background-color: #f7f7f7; + color: var(--colour-text); +} +.rst-versions .rst-other-versions dd a { + color: var(--colour-sphinx-blue); +} + + +/* Landing page */ +.sphinx-tagline * { + hyphens: none !important; + font-style: italic !important; +} +/* By default align the sphinx-features one per-row and center them, +then for larger screens align them two per-row. */ +.sphinx-features { + display: flex; + flex-wrap: wrap; + gap: 10px; + justify-content: center; +} +.sphinx-feature { + flex: 1 1 100%; + margin: 0 !important; + background-color: white !important; +} +.sphinx-feature p { + hyphens: none !important; +} +div.sphinx-feature > p.admonition-title { + background-color: #f7f7f7 !important; + padding-left: 1rem; + font-weight: bold; +} +div.sphinx-feature > p.admonition-title::before { + display: none; +} +@media (min-width: 768px) { + .sphinx-feature { + flex: 0 0 auto; + box-sizing: border-box; + width: 48%; + } +} +.sphinx-users { + text-align: center; + font-weight: 500; +} +.sphinx-users-logos { + display: flex; + flex-wrap: wrap; + justify-content: center; + gap: 10px; +} + +.sphinx-users-logos .headerlink { + display: none; +} 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( + '" + ) + ); + }, + + /** + * 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..9d9447c --- /dev/null +++ b/genindex.html @@ -0,0 +1,124 @@ + + + + + + + Index — A Shaderboy's Collection documentation + + + + + + + + + + + + + + + GitHub + + + + + Expand + + + + + + +
+
+ A Shaderboy's Collection +
+
+ + + +
+
+ + + +
+ +
+ + +

Index

+ +
+ +
+ + + + + +
+
+ + + \ No newline at end of file diff --git a/index.html b/index.html new file mode 100644 index 0000000..18af913 --- /dev/null +++ b/index.html @@ -0,0 +1,247 @@ + + + + + + + + Homepage — A Shaderboy's Collection documentation + + + + + + + + + + + + + + + + + + GitHub + + + + + Expand + + + + + + +
+
+ A Shaderboy's Collection +
+
+ + + +
+
+ + + +
+ +
+ +
+

Homepage

+
+

Content Creation Guide

+ +
+
+

Graphics Programming Blog

+ +
+
+ + + + + +
+
+ + + \ 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..23cb0f8 --- /dev/null +++ b/search.html @@ -0,0 +1,142 @@ + + + + + + + Search — A Shaderboy's Collection documentation + + + + + + + + + + + + + + + + + + + + + + GitHub + + + + + Expand + + + + + + +
+
+ A Shaderboy's Collection +
+
+ + + +
+
+ + + +
+ +
+ +

Search

+ + + + +

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

+ + +
+ + + +
+ + +
+ + + + + +
+
+ + + \ No newline at end of file diff --git a/searchindex.js b/searchindex.js new file mode 100644 index 0000000..226654a --- /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"]], "Template": [[17, "id1"]], "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": [0, 1, 2, 3, 5, 6, 8, 9, 12, 13, 17], "20": 5, "2004": [3, 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, "3d": 0, "3x3": 8, "4": [2, 5, 8, 9, 14], "40": 5, "4138051_robust_optical_flow_from_photometric_invari": [3, 9], "42": 5, "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": [0, 3, 13, 17], "IT": 9, "If": [0, 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], "abstract": 0, "account": 0, "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": [0, 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, "arrai": 0, "articl": 6, "asin": [3, 9], "asm": 13, "assign": 0, "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, 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], "cast": 0, "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, "class": 0, "clip": 12, "code": [0, 11, 12], "coder": 11, "color": [1, 2, 3, 7, 9, 12, 13], "color0": [1, 13], "column": 5, "columntex": 2, "com": [1, 7, 12], "command": 0, "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": [0, 13], "constant0": 13, "constant1": 13, "constant2": 13, "construct": 5, "constructor": 0, "constuctor": 5, "contact": 17, "contain": 9, "content": [15, 17], "convent": 5, "convers": 16, "convert": [2, 7], "coordin": [0, 12, 13], "copi": 5, "correct": [0, 11], "count": 0, "countryoforigin": 5, "cout": 5, "cover": [7, 9, 11, 12], "cpu": [11, 12], "craft": 11, "creat": [5, 11], "creator": 15, "crop": 15, "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": [0, 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, "download": 0, "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], "environ": 0, "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, "except": 0, "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], "feedback": 0, "feel": 17, "fetch": [5, 9, 14], "ffmpeg": 16, "file": 16, "filter": [0, 2, 9, 15], "find": 5, "first": [0, 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, "fog": 0, "follow": [3, 9, 11, 13, 17], "format": [0, 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": [0, 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, "gethalfmax": 9, "getpixelpylk": 9, "getrgbchromat": 3, "getsobel": 14, "getsphericalrg": [3, 9], "getter": 0, "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, "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], "i": [0, 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], "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, "inherit": 0, "initi": 9, "input": [0, 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, "j": 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], "luca": 0, "luckynumb": 5, "luma": 1, "lumaaverag": 1, "magna": [15, 17], "mai": [5, 9], "main": [0, 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": [0, 3], "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, "normal": [0, 6, 9, 11], "normalizemotionvector": 9, "note": [1, 5, 12, 17], "notifi": 5, "num": 5, "num1": 5, "num2": 5, "number": [0, 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": [0, 1, 3, 6, 7, 10, 12, 14], "outputcolor": [2, 6], "outputcolor0": 1, "overrid": 5, "overwrit": 1, "own": 17, "p": 13, "pack": 9, "packmotionvector": 9, "paper": [3, 9], "parmesan": 5, "part": [9, 10, 12], "particular": 13, "pass": [1, 5, 12], "pass0": 1, "pass1": 1, "pasta": 5, "path": 16, "pcf": 0, "pecis": 3, "pedal": 5, "peopl": [11, 17], "per": [5, 7], "percis": 5, "person": 0, "phong": 11, "photometr": [3, 9], "pi": 6, "pi2": 9, "pipelin": [1, 11], "pixel": [0, 1, 2, 6, 7, 13, 14], "pixels": [2, 6, 9, 14], "pixelshad": [1, 12, 13], "plane": [5, 11], "playlist": 17, "pnum": 5, "po": [7, 13], "point": [3, 5, 13], "pointer": 0, "polymorph": 11, "port": 13, "posit": [1, 5, 7, 10, 12, 13], "position0": [7, 13], "possibl": [3, 15, 17], "post": [0, 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, "print": 0, "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], "purpos": [11, 17], "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, "recommend": 0, "record": [16, 17], "red": [1, 3, 12], "reddit": 12, "refactor": 11, "refresh": 0, "regist": 0, "relat": [11, 17], "relationship": 2, "relev": [15, 17], "remaind": 5, "render": [1, 11], "replac": 11, "repres": [2, 3, 12], "requir": [0, 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], "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, "setter": 0, "settitl": 5, "setup": 9, "shade": 1, "shader": [0, 1, 6, 7, 10], "shadow": 0, "share": 17, "shift": 9, "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, "sinco": 9, "singl": 5, "sit": [15, 17], "size": [5, 12, 13], "sky": 5, "skybox": 0, "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": [0, 5, 17], "space": [0, 3, 10, 11, 12], "spatial": 9, "special": 5, "specif": 17, "specifi": 5, "spent": 11, "spheric": 0, "sqrt": [3, 9], "squar": 12, "srcalpha": 1, "srcblend": 1, "standalon": 17, "standard": 4, "start": [5, 8, 11], "statement": 0, "std": 5, "step": [2, 9], "store": [1, 5, 9, 11], "straight": 11, "stretch": 12, "string": [0, 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, "switch": 0, "syetem": 5, "system": 11, "t": [3, 5, 9, 13], "tag": 17, "tangent": [4, 11], "taught": 11, "team": [7, 13], "techniqu": [0, 1], "templat": [0, 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], "texel": 9, "texellod": 9, "texels": 9, "texii": 9, "texit": 9, "texix": 9, "textur": [1, 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": [0, 17], "top": 12, "totalweight": 6, "trailer": 17, "trait": 5, "transform": [0, 7, 11], "transport": 5, "triangl": [3, 12], "true": [1, 5], "trunc": 8, "try": 5, "turn": 0, "tutori": 0, "twice": 12, "txt": 16, "type": 13, "uint": 12, "ultric": 17, "undefin": 3, "unformat": 11, "uniform": 11, "unnecessari": 17, "unnormalizemotionvector": 9, "unpack": 9, "unpackmotionvector": 9, "unsign": [5, 13], "updat": [7, 13], "upload": 17, "upper": 5, "urna": 17, "us": [0, 1, 5, 9, 11, 12, 13, 17], "user": 0, "usual": 7, "ut": [15, 17], "v": 13, "v0": 13, "valid": 9, "valu": [3, 5, 12], "van": [3, 9], "vari": 6, "variabl": [0, 9, 13], "vbo": 11, "vector": [0, 9], "vehicl": 5, "vendor": 5, "version": [7, 10], "vertex": [0, 1, 4, 10, 11, 13], "vertexshad": [1, 12, 13], "vertic": 12, "video": [0, 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, "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": [0, 5, 15, 17], "when": [3, 13], "while": 0, "white": 3, "who": 11, "why": 5, "width": 9, "window": 8, "windowhalf": 8, "windows": 8, "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": [0, 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..674a705 --- /dev/null +++ b/source/blog/autoexposure.html @@ -0,0 +1,272 @@ + + + + + + + + Temporal Auto-Exposure with Hardware Blending — A Shaderboy's Collection documentation + + + + + + + + + + + + + + + + + GitHub + + + + + Expand + + + + + + +
+
+ A Shaderboy's Collection +
+
+ + + +
+
+ + + +
+ +
+ +
+

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;
+   }
+}
+
+
+
+
+ + + + + +
+
+ + + \ No newline at end of file diff --git a/source/blog/censustransform.html b/source/blog/censustransform.html new file mode 100644 index 0000000..8b17375 --- /dev/null +++ b/source/blog/censustransform.html @@ -0,0 +1,193 @@ + + + + + + + + Census Transform in HLSL — A Shaderboy's Collection documentation + + + + + + + + + + + + + + + + + GitHub + + + + + Expand + + + + + + +
+
+ A Shaderboy's Collection +
+
+ + + +
+
+ + + +
+ +
+ +
+

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));
+}
+
+
+
+
+ + + + + +
+
+ + + \ No newline at end of file diff --git a/source/blog/chromaticity.html b/source/blog/chromaticity.html new file mode 100644 index 0000000..96fd2ca --- /dev/null +++ b/source/blog/chromaticity.html @@ -0,0 +1,267 @@ + + + + + + + + Chromaticity in HLSL — A Shaderboy's Collection documentation + + + + + + + + + + + + + + + + + + GitHub + + + + + Expand + + + + + + +
+
+ A Shaderboy's Collection +
+
+ + + +
+
+ + + +
+ +
+ +
+

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);
+}
+
+
+
+
+
+ + + + + +
+
+ + + \ No newline at end of file diff --git a/source/blog/coordinatespaces.html b/source/blog/coordinatespaces.html new file mode 100644 index 0000000..cb3ae14 --- /dev/null +++ b/source/blog/coordinatespaces.html @@ -0,0 +1,183 @@ + + + + + + + + Coordinate Spaces: A Refresher — A Shaderboy's Collection documentation + + + + + + + + + + + + + + + + + GitHub + + + + + Expand + + + + + + +
+
+ A Shaderboy's Collection +
+
+ + + +
+
+ + + +
+ +
+ +
+

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.

+
+ + + + + +
+
+ + + \ No newline at end of file diff --git a/source/blog/cpp.html b/source/blog/cpp.html new file mode 100644 index 0000000..ebce417 --- /dev/null +++ b/source/blog/cpp.html @@ -0,0 +1,897 @@ + + + + + + + + GiraffeAcademy’s C++ Examples — A Shaderboy's Collection documentation + + + + + + + + + + + + + + + + + GitHub + + + + + Expand + + + + + + +
+
+ A Shaderboy's Collection +
+
+ + + +
+
+ + + +
+ +
+ +
+

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;
+}
+
+
+
+
+ + + + + +
+
+ + + \ No newline at end of file diff --git a/source/blog/gaussianblur.html b/source/blog/gaussianblur.html new file mode 100644 index 0000000..15d9a81 --- /dev/null +++ b/source/blog/gaussianblur.html @@ -0,0 +1,192 @@ + + + + + + + + RasterGrid’s Gaussian Blur in HLSL — A Shaderboy's Collection documentation + + + + + + + + + + + + + + + + + GitHub + + + + + Expand + + + + + + +
+
+ A Shaderboy's Collection +
+
+ + + +
+
+ + + +
+ +
+ +
+

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;
+}
+
+
+
+
+ + + + + +
+
+ + + \ No newline at end of file diff --git a/source/blog/logdepth.html b/source/blog/logdepth.html new file mode 100644 index 0000000..da760d2 --- /dev/null +++ b/source/blog/logdepth.html @@ -0,0 +1,211 @@ + + + + + + + + Logarithmic Depth Buffering in HLSL — A Shaderboy's Collection documentation + + + + + + + + + + + + + + + + + GitHub + + + + + Expand + + + + + + +
+
+ A Shaderboy's Collection +
+
+ + + +
+
+ + + +
+ +
+ +
+

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;
+};
+
+
+
+
+ + + + + +
+
+ + + \ No newline at end of file diff --git a/source/blog/loops.html b/source/blog/loops.html new file mode 100644 index 0000000..5917df9 --- /dev/null +++ b/source/blog/loops.html @@ -0,0 +1,236 @@ + + + + + + + + Turning a Nested 2D Loop into 1D — A Shaderboy's Collection documentation + + + + + + + + + + + + + + + + + GitHub + + + + + Expand + + + + + + +
+
+ A Shaderboy's Collection +
+
+ + + +
+
+ + + +
+ +
+ +
+

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));
+}
+
+
+
+

Note

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

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

+
+
+
+ + + + + +
+
+ + + \ No newline at end of file diff --git a/source/blog/opticalflow.html b/source/blog/opticalflow.html new file mode 100644 index 0000000..b027f42 --- /dev/null +++ b/source/blog/opticalflow.html @@ -0,0 +1,349 @@ + + + + + + + + Lucas-Kanade Optical Flow in HLSL — A Shaderboy's Collection documentation + + + + + + + + + + + + + + + + + GitHub + + + + + Expand + + + + + + +
+
+ A Shaderboy's Collection +
+
+ + + +
+
+ + + +
+ +
+ +
+

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 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;
+}
+
+// [-Half, Half] -> [-1.0, 1.0]
+float2 UnpackMotionVectors(float2 Half2)
+{
+    return clamp(Half2 / GetHalfMax(), -1.0, 1.0);
+}
+
+// [-1.0, 1.0] -> [-Half, Half]
+float2 PackMotionVectors(float2 Half2)
+{
+    return Half2 * GetHalfMax();
+}
+
+// [-1.0, 1.0] -> [Width, Height]
+float2 UnnormalizeMotionVectors(float2 Vectors, float2 ImageSize)
+{
+    return Vectors / abs(ImageSize);
+}
+
+// [Width, Height] -> [-1.0, 1.0]
+float2 NormalizeMotionVectors(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 GetPixelPyLK
+(
+    float2 MainTex,
+    float2 Vectors,
+    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;
+
+    // Get required data to calculate main texel data
+    const float Pi2 = acos(-1.0) * 2.0;
+
+    // Unpack motion vectors
+    Vectors = UnpackMotionVectors(Vectors);
+
+    // Calculate main texel data (TexelSize, TexelLOD)
+    WarpTex = float4(MainTex, MainTex + Vectors);
+
+    // Get gradient information
+    float4 TexIx = ddx(WarpTex);
+    float4 TexIy = ddy(WarpTex);
+    float2 PixelSize = abs(TexIx.xy) + abs(TexIy.xy);
+
+    [loop] for(int i = 1; i < 4; ++i)
+    {
+        [loop] for(int j = 0; j < 4 * i; ++j)
+        {
+            float Shift = (Pi2 / (4.0 * float(i))) * float(j);
+            float2 AngleShift = 0.0;
+            sincos(Shift, AngleShift.x, AngleShift.y);
+            AngleShift *= float(i);
+
+            // 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);
+        }
+    }
+
+    /*
+        Calculate Lucas-Kanade matrix
+        ---
+        [ Ix^2/D -IxIy/D] [-IxIt]
+        [-IxIy/D  Iy^2/D] [-IyIt]
+    */
+
+    // 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) ? 0.0 : mul(B, A);
+
+    // Propagate normalized motion vectors
+    Vectors += NormalizeMotionVectors(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 PackMotionVectors(Vectors);
+}
+
+
+
+
+ + + + + +
+
+ + + \ No newline at end of file diff --git a/source/blog/outerralogdepth.html b/source/blog/outerralogdepth.html new file mode 100644 index 0000000..7db3913 --- /dev/null +++ b/source/blog/outerralogdepth.html @@ -0,0 +1,163 @@ + + + + + + + + Correcting Outerra’s Logarithmic Depth Buffering — A Shaderboy's Collection documentation + + + + + + + + + + + + + + + + + GitHub + + + + + Expand + + + + + + +
+
+ A Shaderboy's Collection +
+
+ + + +
+
+ + + +
+ +
+ +
+

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;
+
+
+
+
+ + + + + +
+
+ + + \ No newline at end of file diff --git a/source/blog/pythonengine.html b/source/blog/pythonengine.html new file mode 100644 index 0000000..4e3a32c --- /dev/null +++ b/source/blog/pythonengine.html @@ -0,0 +1,208 @@ + + + + + + + + A Pythonic 3D Engine in 1 Weekend — A Shaderboy's Collection documentation + + + + + + + + + + + + + + + + + GitHub + + + + + Expand + + + + + + +
+
+ A Shaderboy's Collection +
+
+ + + +
+
+ + + +
+ +
+ +
+

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!

+
+
+ + + + + +
+
+ + + \ No newline at end of file diff --git a/source/blog/reshadefx.html b/source/blog/reshadefx.html new file mode 100644 index 0000000..c7f80e8 --- /dev/null +++ b/source/blog/reshadefx.html @@ -0,0 +1,275 @@ + + + + + + + + ReShadeFX for Beginners — A Shaderboy's Collection documentation + + + + + + + + + + + + + + + + + GitHub + + + + + Expand + + + + + + +
+
+ A Shaderboy's Collection +
+
+ + + +
+
+ + + +
+ +
+ +
+

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}
+
+
+
+
+ + + + + +
+
+ + + \ No newline at end of file diff --git a/source/blog/shadermodel3.html b/source/blog/shadermodel3.html new file mode 100644 index 0000000..d8c2958 --- /dev/null +++ b/source/blog/shadermodel3.html @@ -0,0 +1,280 @@ + + + + + + + + Project Reality: Shader Model 3.0 Considerations — A Shaderboy's Collection documentation + + + + + + + + + + + + + + + + + GitHub + + + + + Expand + + + + + + +
+
+ A Shaderboy's Collection +
+
+ + + +
+
+ + + +
+ +
+ +
+

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;
+}
+
+
+
+
+ + + + + +
+
+ + + \ No newline at end of file diff --git a/source/blog/sobel.html b/source/blog/sobel.html new file mode 100644 index 0000000..6bbfa5b --- /dev/null +++ b/source/blog/sobel.html @@ -0,0 +1,165 @@ + + + + + + + + Bilinear Sobel Filtering in HLSL — A Shaderboy's Collection documentation + + + + + + + + + + + + + + + + GitHub + + + + + Expand + + + + + + +
+
+ A Shaderboy's Collection +
+
+ + + +
+
+ + + +
+ +
+ +
+

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;
+}
+
+
+
+
+ + + + + +
+
+ + + \ No newline at end of file diff --git a/source/social/instagram.html b/source/social/instagram.html new file mode 100644 index 0000000..3799aeb --- /dev/null +++ b/source/social/instagram.html @@ -0,0 +1,200 @@ + + + + + + + + Instagram — A Shaderboy's Collection documentation + + + + + + + + + + + + + + + + + GitHub + + + + + Expand + + + + + + +
+
+ A Shaderboy's Collection +
+
+ + + +
+
+ + + +
+ +
+ +
+

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
+
+
+
+
+
+ + + + + +
+
+ + + \ No newline at end of file diff --git a/source/social/project.html b/source/social/project.html new file mode 100644 index 0000000..504633a --- /dev/null +++ b/source/social/project.html @@ -0,0 +1,193 @@ + + + + + + + + Personal Project — A Shaderboy's Collection documentation + + + + + + + + + + + + + + + + + GitHub + + + + + Expand + + + + + + +
+
+ A Shaderboy's Collection +
+
+ + + +
+
+ + + +
+ +
+ +
+

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

+
    +

  • Davinci Resolve: Video Templates (Project Reality)

    • +
+
+
+

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.

+
+ +
+
+
+ + + + + +
+
+ + + \ No newline at end of file diff --git a/source/social/youtube.html b/source/social/youtube.html new file mode 100644 index 0000000..ea9453c --- /dev/null +++ b/source/social/youtube.html @@ -0,0 +1,267 @@ + + + + + + + + YouTube — A Shaderboy's Collection documentation + + + + + + + + + + + + + + + + + GitHub + + + + + Expand + + + + + + +
+
+ A Shaderboy's Collection +
+
+ + + +
+
+ + + +
+ +
+ +
+

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

+
+

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

+
+
+
+ + + + + + + + + + + + + + + + +
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
+
+
+
+
+ + + + + +
+
+ + + \ No newline at end of file

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