From b2bf0d9aba3a3b2500c2442b07b83c60667dbfef Mon Sep 17 00:00:00 2001 From: MrAwesomeOwl <140653655+MrAwesomeOwl@users.noreply.github.com> Date: Sat, 1 Feb 2025 14:20:40 -0500 Subject: [PATCH] sound page --- docs/assets/sound_arg_clarification.png | Bin 0 -> 30424 bytes docs/codeitems/sound.md | 45 ++++++++++++++++++++++++ mkdocs.yml | 1 + 3 files changed, 46 insertions(+) create mode 100644 docs/assets/sound_arg_clarification.png create mode 100644 docs/codeitems/sound.md diff --git a/docs/assets/sound_arg_clarification.png b/docs/assets/sound_arg_clarification.png new file mode 100644 index 0000000000000000000000000000000000000000..c305bc27bb281e746a8f33f5f1e48b05eda57027 GIT binary patch literal 30424 zcmc$`2{hF0|1dn1D4|lc*xHpWW#49|+@+Ewl&quNvK!eAV@N29He?-=?56D743U&Q zYsi+}5Q7=Zn3?CA?mN@@{r~Uzzt3~t_dGf?#`V3H&-K~2>5-m}CeMz8J0K7U&y~x6 z=|dpwmEd)ZYa1BZh+K7oKz88lG&J)7}x1AsfXgxdI>} zmVtYd^Oa*S+;w>egFAZCv(c5|e;xH~biYbOFc`QKjpNp?kbwKUb%yV{w(o{MdK@W~ zBF+uzy!{b}Kcl5or?~6wqo?e<{T1r2$Zq(A@xMKwofNU1&qMPSFC?kyZuoPESiG1& zO5x=8uZMN#KA2UHbMI=={HCm~9u)4vS+ni(<6R@C(3fhk?$7D3W5vGyUGU5F@0;&@Y`O!pbLUJ?I2iG^^6vCf$9l{>4(ISa-U)~Jx?eDR}(&lRtawIo;<+m>%T zQj_|llj{*Iw*L9l*E+IX!(-`&UC|k1IY(?+Lw1sp0poXdWj&PtZV3U@0v& zSGw;W52api2~;){50<4-BS10$sk<)y^ zqNS|p!*khdx2fA&&kYAbs<#Q1FP~w1TG#j`uJ565h>X!k-K#CHWuNtbN-fwbB+Fl( zR+h#CG4S%5=<*glhdy~YI7xY^Z-~uhCLtj~O@4A|ZtL(X;l*2h6Moxvj+s1%lz#uT zJ3QaUZz@xC=i>4kHXd;{k7S;m0jJ(=Ew0{O%C0-ieIKs$kS+X~$&2$Uy8^AnM040K zCU14z)_Snjq8eiD?`M~0XjTAlcZDFC$#n_I8ET$CcZ8zL;15Qm=ncCmEEiot$j&4KS?m8Ga zcph1dwdk}W<`0KwiqB8Cn9>_Y_6=1LFk?NeXO)oV=+V)Ib*xOX?uMxJQ z?px!6EW#`v4F=@FMgLMvl}<*caDKI#65YS!(mt!l_p0B?e0_DS>D;y5Z+995+0~eR z{QhC574**gTO2viZeC*0lMin#W2_V{y{rzsw|S5Lc6e5aH`Ji!z-WTYc_jrYZleeN zk5nHMKMs848HJ8s@#d*KKFBQ^E;!7+V7;obD!UrLD!97+{?79;!*H%6F5AleRcv?RynY2^p1UFL)&NsZFR2R+5(vP7EZhT)BSn z>y2mWw{pH^cx#ff_n3b%ICaA=TtB?s%DOQBnd`&FbK~j_f>D|`Y)?m=7K*wPHF}!Q z@b-{Yv3vY%v0WK?9OXCMt=snFNwyIi`59UMERI=wH( zq{~j*ExWFBtiO7j^)~YDEjR34+{A-u!p#Ra18=5wTRFW}&``bZ8}AuIc@+_&6QD!T z!MAKNzb~bsXzUg0T=MgzIvOvI_drRaq{;ip#_K-oU0IkVz3oCvP0#D<*8@Ki)1Do#&u?EW-dESqXdiVWyUWzU z${~p?LiANIjEBT~D3~h@In6mZ#&M@~oI$KOlEW#%jxGzWS%ZX8$O3C{2*l zH1tg9C@)4SPUWqNh^t>29K(kE5XhmSW1{1jj@H@I;y&p;32rPEC*>GpACsQfmuJ>< zut)Hk#@!uDGD}b5%i=%hewlkw5k%dwQXnGEhm5=vX`!p!%GJ7~^`wP~#T5&(h1HWucmH$J*kO%NDxRBs*SXJQdf8BQ}@RR>1DH0^oUD>w%PUX0~goB zT?NdIb1IdbNYlsLwZ3WTe6;$J`h%|yW5xMCyLWVZ&I9x9RzhAaye$rS5?+VA9!!3e z7{_0Bzj{X7FLvx@p}gI(-s5Fwd|uAC;D)QTNmnwjuDv|?(j;CbRv@bTRfKM&E|UNA zc6|=PbDgrT=hh#5syQ-Jtsk1!9~1Ft<1hJGy@}UN-DeKAA0t2H`3QT&S&&#DQ2>(; zH}gEAsi66^!0k?YqPD)k;WV5yi1#`lUrds+(_ z7FJegq}8O=aFyUR>{z-UUMD?XblU zXnA_d)!eK%Geisepf9y@Mc#;bBWAAtXX_wi13nh`6LFxbyGy+1Wv3r*Unj57PId2; zmb|>5PiIoJ$u9U(|1p>EBZoBAA_^5=Da<+;+MZF~5fK(iP!Yh){=8Q;YJPJ6$%8sG zN#DEvaysoC66Y3QZ}Qx9n~9YPwa>4=yid44UMDs&Yp!iJLroHc>NxNtwnp|vqEF(e zO|Xq->+!@xGbZii1;6FBe!&Y;%NENO-fPc$(v}9Aezr8~#Hi*enb}n|l=itcQ%u|< zwRJm?3RUvtK8gaOq+$?NOTXkhbe|xrXzrX;F@BHO?$kZ!;Ke?_Jn*E{7YED342!G` zHd5_YhM=GQWk@dMqfMzl>d!?sCS^b~=>rQZpV;~XJAy=l)OBl^`6t^LD=p*Zzt+$rHEtr1o|KfFM zPy&ymS<+G*)Vw#o)GtT!W5Zw)Xy|G%DUIsT*(1o`NEjhRVH7t8>9zCqsb7}ATsds| zG0B-j?{fe@KbyA^H{|#>$m#YNe!-UI?v8EEetg&XS9R4oFuL)Q5FRPV*-9Nf1ZLDSpDzsEzd(BoZzoL;PoJx{r7D4%H%DZpO1lOkn;u_ zSFV8H23D@t*3NFWNcRu@-~7P9c9+Y>ZV-sTapsHdivF<$;C}bm8QyZgrF~7s3h5+u z`)}kOYbkFh7v???HE$L0(aGBVwwSk*qqCcexB8J^GgQE5=CJe;v0qc%9n_E9($*8x zK)PCsDM-mk$sB?15EBzqbN&0SivC}h{#_3KQa@tr?(U)@E$!vyCFLb6g>j#Fc9rlM!(ZS8pL zFFPlIY5*EkQAS4X*D?R)2@BAFR^D*4cGW;Sfrai+7OnnW{O7~}T=?rqW7d)Ka!P+5 z`Nxw#Rx+=kqHpbnbo5}N@P@OUJM^5I^nW+}pR0^n%b;iF zSLnLh0X*Dhf(AYN?+Jg7{X1Vxno0UUSm7T&`!xy}4Z1^3dXs6PJI)}R_d+0W$d$j& z8+x;l$Ye=_`DFbII9Vs@z3snisdd zw-!SQ%HgBGy&fq<^k!qU%`fqDO-R^OR!1Eji558;F5JNXUd~sv4CH1@IzZEbNzxLq*)}rSg*V0xk&QkKb~T@Qh2=Fd)wza!p;e9-35oR zfw$yI_WDRsKG{l2pM!?6mtXG)kJ{dUpMeSMC*alnCHt(Qzt4cMpAQI7bkX}~HFJxp zc=)uCMRV-bA+DwKzxHIl*_Ko{D-M|{RhuI5@|^{>hm^$sg%UuttQ`cm#y;5a!2OSvcfp7P zj@L?K6PS!M@M_c8r@XA=`oKv4MAvOc*1e)QxV$C!+u2xK$AgjnN|nbvECBN1i_pp_ z+|#MyCrCf5*B5gLq)&%N1CwGpZN5$*Jbb!vju`KleGbL=ypzO^97X(502q3=WoU`C z#1}Qz`L1AVH)ExTo8)N|1W*%ljxDhe`+46hA6{gaP-WKS?b*G~3yB4}HUD0HXIPGO_dgDPSS}}XVC0ZTPACrh} zIoXBnCa$5-PB^kjULQ6I*VBW-`*-D2a6P(Y++=#6S1v{v*J4EUp!Zo2ixOsZ`(x%1 zt-9todj?9q;n(&9yTC0E5kHFW-n_!wy<)?Odm=hmFqR(%Fh23P^O6OT!47w+P_G7` zZqK+0uI@zs3|bW4qL;G6fU=Q4D%oEZfpavjk5Pfi6AaN^bn-@dJ&qQWsGEh(vcTcS z^CuMtEb286Fp-iR57@)gZD7CrCJn0}uy3v8zwmV@i-hrDWWY@E(vwZx%cMY*!6YBq z=FCo^3rNME#;u|~5u*dU#4G65HeK!v>!C<%fG1=xy|GwYRiuweRIX)>0O3LZoTCMs z*WI=MD7;#ATSzVIacUu@UK*&v0+VYE&Z4JSBmwcv$Hm_ni2(GeZ!Il@fd6l*d zAV;Z{?h%_KGRVN#$pw3zq>0%y__80Mur;-ZUT9VX6UI_-)=o@POFH<@AsSJH?h<^? zD9)FDgK7ku(`~c{m~JgM^VmSqbLv~kzo@u=s+t!G>xnWxyeV-B{9?o7xto8AwK)J* zwvd*7!4kl4CGviI&kDi(D>LF$Hc`R0_3mkxrDjDzi}`L-BoBFZVH@ub7Vgks-?{#< zbE2CI0>$9f|NDxBDOkDUf9NJIfVRLO_Dv>%4{hc0rWU_$;@m{77}u`)l&{R zm!?c>xo0s_H6uevgP#3PDV0+keqlpwtHTCo^voKmoY*^oKTHN;t9!Zk_RLTxKR-KK zce2y0kr&yV>>j#F|28Rbf6rXbRF-beFb3-Pu3kBdKDIINQRPY%^X8GZbwW&}u&Th@ z4CTtzVg5le{bAZsG5wF4@HY=511|3tWqWo6%6{ac-`2mvX52Pb@7aBId?q}27d0gTVA6{uPwwzcQNnG-iK+w~w=q+vaL#p$Z;us=!K)8XiV1wLg4Y;aJ zG;jq!kA9*vVJ+=zoJ#9Z2K0X?4m5^T!&O<`-#lh{9%yDk_mNnI-|PYAY^@B>Z*SuN zeZgCLY_8tcBUr}#pg@G*=!iy&-|%pt9(^M<{X#5Yt7T2Gs8lLHjKm-Og0?XU6P=kS zs7|cHmSS7aU!1_ctR4^B=i zwPhLcHhF-wyxjex7dMe6e!Q&$nBNchb9Eg{c`;FT|o=)+u)>+kN8KPTIjl=il7Nf$1b@|X2`JzrE z2|p2gi($S!(!r?aUUZ!U-8zF&hDBM4yA2J1Jpy&OZCmmtI-?W6b6YIjuQ7nqNs)rx z4rvjZ_1SZ$0G55X%1z#I^E6N{R(ZkazYsLiW&@-4>gnv0s@hm=do$~;lcaW_1?d|I z5RKb4%0g?#F_|Ud!Kzh z4wCfABt>s=_tG*UqQ>~v;B>WHm7}h8t{aV-{O$+h&hSKQtX+?d^vAy>Z%4BUgTyx}&N$5&hibZ{@@+TESN#(fY$cAF&2v3UI{DlqLRHbGundPbM`tNii zV1kP7psy?@=sY8{Bs3UTkDbl4Z*g8^m)m5SJ?wEES<1LfA+zR`E}?<^m65Iyd!0NA zP8n~4qZQ>g@%|TX2QI0^$wZbJEz|}=;v`Yy&GMG)_f47eN-I|s5nxkH4`vEqjrCuS zOT;0aG%())619^7D^^0fip9|Z+M+$k)P~vhlZBe zxBOgU4D_=vD2hP$HdHO=8wH=^U@EOZ|Lr->>ga_BPqMd35G8Kk$u^A)UZg*1!8Gn% zI%PUl(W(vG=T=B;neGzm%Tg}L6dLMWA9QV$Ou1t3mvT?%d~2)SxgL#hT9>L3N^0;; zb)rLKP?eI;?H4hxw1%{_8b``)dU`Z`?0nv1>ChGho&W>3`H-#ORIvHb+Y6G?enSQ@*`3~^_G{t?M8GLp$=(&W zEmD7!vyjQvd8}=HE_t5*bDq}#Jsik+VNG+8B(1Tw5BF$XFV9?lpIx5iYwcWH1ywFR+gtb&QG^pZJI_z?+t8I zN`FT<;Pv!{YE4k-QMIR%k8*QM>$6oqXJ?aWDH^BeQiTgk{ZQE6L|7LWZ73W{y~c6$ zB)NHV`ys~VyGs49Co1iAa1j%WjnaIfyrNK{h8x^*9oe*L?;^t7csFOI6X)N4|K6tU zV&LkQzXffoU!4?uN(=g;`{wv>>j~UKbEXembNcKhmSM}}Fo|h@+R%$1d#+XUw{-cB zc#Sgq+e;pd*Y<)5z-tiR*CzC>UL@S>Lz|tjilJn^5w&A+z4z6Y9I}cE-)z9N?CcTi>kwhtUx$O3Uylze9OKeT4=A9R6D?7FcN%bsn^K5LIqgVnq z0USzIPIswCo9>c~YGC*H0=J1j>d!(aAO^Y#3LnT7yWFy@~nDy4UeYQrtNc%jG$)-WC zA@s=exB}miV8M{}Ji%`xbL%_K`Lob+0T`JJBBxn0ST5C8{xT#lXmirkeRzrf!E&*_ ziL=F0!(9pA%iTN?>%{q;L{eZ3!&}^7ssw&IbfIBMQH#yY$KTO^^2-lIoGl}h^4{yJ z2e%pHS>(%^MS6^dVBd?NgGyHgS5e~HpSE*#o=8^yfWn&NpBDG57srHGsg|IZAMf@fQ<7y_(%O@t z)jX};tkc><$)r11<(cu?X2C#wNwUM3=#X)9M3E{Aq9}*>Y({qyr<~D;E!Oq1rFMGj z)27#2SKEY98Sl)B8Tq5qm8A=srSK36VRM6i{N`VJ-JteFSX3#?aW~ zKfo`Rmg4L1=^^V%S3%?wUH$shCfmbTwjR{AE1fIuzaJK@G0whME?rZ-uo80Yc9=0X z9W%kl*}9|XgtCuE}2f8yB_ef2ke4h*lP$FS5q98Si#`{`uqO6LAh#b4@7Jn8b{s)*`d4B@wxs*rS>eP3|{Ipf^LhxsD~(yKF6h zDfO|+W5uL0nt`7T4o)a3N^OSyk9QAC@mN`+e7q+Bv$`zn7g_3~5Wr^o5KV_nTs#@s zd3Z`+;uZgqn3!#R1LWyM*H}TVM(Q>R3E!bX6t=Yyy72Yfz=?kQ2-BGd`Ez7wvd84! zXklG@|G3&Xdu*2O6I_;V7Nc`jpBxv2&)473Dpu7MSh-b#o0y&H37y!OnUXtcL@de~ z)itmB>|nQ+;|aUh%fMg8W8(ZV*VKlUUkR_~(?7o;uQvzShrpKak0?v!97szRM z+3qbty64)nRqo_mU4&LrPEVdp{}j`4F--$S%OC9t zcfgn+ip&%y4eL8R5cv7r7Tj!)W*7OgIf9sN5xKM*Zh3F(WxHDmMR(u+X4&csJ9aHd zjpfVQ{RZp5%z1Yd&O6Ur$6hHmY#wki?_6C0VhtIbjv*l#Qk@7&6LRNxv7p>Z84v9B z=HAMsc?IjR_m%GtFwSe6>&|z?*-HzG&K?;0vZ|GUr`hqS54)%5QE(vc%rWI7e22Z-rlN*{Rvrc}bKAk~hvMIQN zp?+-f!*TrF=*BYfc#`&Zpc20UUumFdc;CM$Kl2d&J>u5WE7A*c+r0(7NwF&bJP4P7 zf3CRffcUu*9)7IWj3uI|!ytzu9sQng#kS?=4I?wdtR?C^y`YWYpp5^L0RK{E)+_2J zRy&sK;(1i4PpLwr0SKUSY|6QGm-$$Yk*U5u6LDP5OQN*$P#blyCTWQuy5c8Kd7lS; zzLcY!O`4raQy;|*T2I~9Wo*Z~ggEm7LFKfQCAs;)t>C z*Ol2CCl*kBpKC9JSS-eMZ8Ok?Cs%>^nBwIW3p}M?Zt&xMVxeAVwD}}}?HYM~?)Yy~ zLITa%JiWanRo1S$IeYBMq>jz3WhM-?ey66nJThdYkalt#30oZ4_?%Yj*PHtTJ6wbs zY9}aNwR=~nJHvTa)61Yw>)yL`#(5I@)~MySptLk4Y=PiM0j%Ko4-ym0o7+?jTJS)<=uTe2~82QFV@&;5%nv3Hl5xr4&KrhUIH=`A?O z9jF#h#l6U0Y3`zqMJI|Vms!`@{z{d!X@iFqWzHQ>;)DmMzbkS7UIkA+3N{ip77zKu zQ%QuJ;^`>6C-CoK?j`{*Lv*AOUq0|JL~nI4b!+bJ5*m8z=1L}1&!n!bb)g!5iz2*( z{f(TQKFd(AybZJ8*~N*&@C&tSos(YL?1O8)ZsQNCM<&fxSBnsSHnv5S z1)~c-*2Eur&;l}Ce7;{WEJ$)q(0S;&+{0$h9&~+4IaegVN_Ic?H^k;~NdS?|9>N`PIWt`gaNH^!ZY1T|Z zNxi?&TIU!4rXb^&`yMhxqSfOm15EYSjpC6zxk9gCIKGv=JU%;v4uoxxl%T?xufw8@ zCp|m;eWzcyjSWhx9c&0yOghlu(8w3O_^Fo+$|8&O)#D2k1lrejaZ%LIN!)=(g)JjA zXtkKNIz5q{cOd2Yux&Z%Egu6sd>CN~qT$)u*(25e2;IlE2Mq}qjIjw)4Z?komn4Zx zTJv;FEjelRar%SBKHAq*B6Mh>hN0Y~JA_26Zv>_Ich6&8?tuhU06d)I^N17ahm72B zhJggmu#Xo9Wg#L(m;or_O4rV-USK8=#RZzxc>$Df97s?72a5s8TYVk#3rIRoV`xg#H|1L zpf_TubC=>6pX$yQ=LZIq&d@%5@JZgQ%*H*LMAu)?1FikFT@9+}+H7E?WTEOp?6Un=p{y(L<#VVpg!hQiV`M1^tZZ z_GIPE8=)C1P6I&Imv^q~DTm&lco{8RGm7)pA32qo&>@Yce{dm8B-lsT+p3*UnMHdS zX*J*OLP^FnuXWQKCqCQzk|in#C_+o*Id)_p9&f3jWK2+aL2EoYc3DvTX$V$Q~zwSe1p-aEL)AOXG z0O)W13h|WmaV%z~HB`fTzSh*kf87c_7W&I?Jw=p zzgZ^$E&;T>>HD2K*?*%Lo_vZ;|6ttnw4nprp9aYvwUr72kS|{Y1W`9_tC`-lAh76; z(|5BcL(4LS5b9NP?ADC3_Jr$rKF9uvY~@#RRne=<-8(zwi~u#w1bB~Z`j^WWL2ZVR zGgi|Qg#9Y$IUTD6VAs0>pov;l@jRzmDQqee63#Rozn19ffa$Ili4Frr3Ez#kIOrf} z)-#3bJJ)Uy(4j1W;q2KK#sp`6qrfU9iUD76*9WIZaD2}=z|*S zT+ir3bWA!hW(tan1@4-YY5Xdw%zG7H25$Go@DF-#cMluscVyh-{dL9=Oki3aezo>U zu7cZU-daEppn$_{8LAzNZKW2*HE{sazDfkTh=jbzf`~dwu4(Dpdn;z)gIosc z(}Ib|nh@wglHfcSS%OHCtSr+{s6C+b^Za=?DS6ETPJg`pxwM!#kL_HE z%p!&PGqU;+BzwL1Jz{BxkN>64x_CNJV5)e(oxda4U2w7EyD*{&_S)*~x%^_>*&bRo z0nEgf4$#M`{EdbkVu$#=kri{rGKP|&4IJXOI*}+_AGXUidksJ$vMo2)U}OWA6tS|8 z2Pj$ckOx}Hok~UWjT;{J@XvyFVZe*AzK+TYuUR)_FgeUdFH<>qCT0A<&dh~9*6NML zJ>f>=OcYvJcVIkgG<(Ki#V_tBF2`udPk#uOS2hu+ul01DUbnKc8k+~ApO=fdeWf5Y zoPj8d1|DJahf24n@G@n@G67)n)0gEXB{op4^9a0K2Q%g_{C17$hh$s_d?|mYm>>Zy z>|Q^9C*Ze2hOpn*dY4d}tt@q8+fbbw8R{3;5u{tGTd;1++e?2kzMyc+*aDOY&bxhs zt_Mbj7+7qy3x?(kL}Pd1aFY(S_Ae;Rrvwj1=30+B3~!N@vvRmQ!5qzavmWn(wpY(4 zRLxMXJn`!GN8$5Fv->scJBnRFwD;?74gRnRsxL{^3>_f~v+%pnTtxO?$@OvhqmmT> zzY!Qazi?AnX7cFMePUZAvOhR5EotBtj#c{EOhZ`T?gfgKu%NfV#*3or@YYV?aR=^T z_hV!P^pqKF_f{?WduORmV5HyJ(Uc0J1;jZs?9ik5*0T zn_bd?$`gFr@;idOq`S{>KsuzSNN%U=Tbozq`=baJxByY4o?1~>6mK4{Sr`@Eob&^NeqQ|C|hPG6d6X` zX?QbDHvpyQW>V+6q48uY)C4<&)Wwf^+v6!%6s8jj71n#5Gpg=Bp{Hc!b!Y#|PJQa&jKz3v{Y_r~@58&dj^7Wkhy67&Gu~D>23CkKxZi z-s%~zN3P(vgHMCH)-V2IcQ`j-nXfe$?OZMcNBE&u4@(4=1VPUNTLn1pRQrR{MmA1aT@?Qy+_MF=^#Sox*^bdx)XE@*?m{aLwt&b3< z0mvx~XI?f$3*uge-QlHIGQB5}9BFokn9u(AG?bjJX+x3DG8ts>Hw6 z1Ifv`^!@s&>2m6Hpx9A~8!57(HHXm*CVQ?Mrp%HXi$Rjd5#38fs^#yNy54;5i4rP)XI zm6ak@e;bwP1iQs3-a%)W1+YWw!XNWN>)7jxDluW`45t#XX3j$N(xwI!)4LA*gd<|< ztfGFQDHs_b)=sgKc&B%q@vK2yRMWxYtKVbQ1*A|Nx&wO~(9&meb3#rfLGc0&5{(im zmA1g-8wrW}g>i&AQ0erq^U`$(J3X}l@&2<;4hn8z;h$KHY|iX2`Okv;*h2J=*Z2Cj z3P?`Qe0%?@)~{K<=fQDh)UvI(vkx{j`IX z?dbz`wEmyu+wQEB_W{2{g5CAsJP{a&S1>~mn_pjDkB{1TbYri=maF84H4XHJe`W$dP)&nH#P{jqk%`7J9J_JblA4~OV zZr<`XuaRPZboc-yC=U6#jX;oia<^V9?|*b30x|j@n}#UqC;n=2zWNY&;r{{@sKEWM z_W!7_5ZuE0f(q+iwxII`8E+K&{tsdU(&k>f%*jHS6O-6WGcpP+02 zB#@pw5~%A^9Q3xjy=4y8MR+HBT7r8D^>XehSwcdfKbujho*j`svvxfloknQYtrK)2 zs9->ns4W4AY;$kBEQ_k#%mC~i*G`r$NLB_YnsA){)p_?1$8s=RB93cjb7T*`KK!!z z@HnmGb)A*?6YiI^bz48U8FSWD2H0EJTq)#_a3vOmrGM)b{!+-lFaRd8AvFafZnHGR zwG*K9Zqa(vFz3D8OP$&fd;Sa;mr4wFd% z{dN=+DPMJA90-7!)&ZP$qqT>wKVCkG>yc2!8d44M7KldcR%BoL%+Nx%s9JIt*G(9d*OZa3$)Ag-BziEcC$Wpyx`LF?85P> z!{mL@n5i}3`{A6(HzrdjWvhy}e2gHcN3r*k$*Xu1&;qq_`PlUxJnm; zS*iUMf9qK+14m;X;0Ks;}p7Nq+geou1#A2)zZa~u2o><7Pno^@!+fAl$m`~PQ8 z4=~uW;sY!_Td0*x60%6ln{cs34>i_D2y+{B3R(CqY)9@owLss!>(r0`t|5}F?7vZ3 zXj}Z5_y4~>N6@O$!d*Si@-5<+T|3<|gRGGW(4s_LXz?MKF_Rj$PpUJk2zZw>*!3mq z1sY?)3AUHnJqI-L34W09KX=lEb#He=;Dn`e*S}-!b^^FaiA|4gvNVY>C;9m@5=;|)XP{*u_O)4whOIi5{*}dO zdj+~J-A$4mb$%X?G21iotFamw&@^@Gb)0rtrXi8o3)xKX-F zO-NET>BULikfnYLU^(U_KCZGX#c6Qkn?FYX{sRY0hYlUQ|Bvk8aZr;21!7RsS~iA* zL~nh`bb=XP`ke_8?O&7xh6^=^pJ|G05Bi$W%YRbm0SZ6wlp!SWvtphAx^Z0jKdINp~vvi8?J?78+yB_>{TT5dwwePSl*=Y!vXM= zfQdr;7KhWEMsBw9nk68E?(q(k;Ajpyz;VDhNdN{d-gjG##h^u?Sp5&>e`RdJn-h?Q z|H4C`M{=WHv;g+iWw&;_W1w7WJs%IcQqlR=Qe0=^;Jpdv&6zi(|G)3Uds^EsE}aO> z5SByEMls4Qz8v{8oxVZ1kY|V<`C@n^pxTT>F0|Ob#qo5#qI|EZbJ=mZD^H~5T24)^ zDQi!l9tsbZExO%f5&kW}ZoI%-3~QteV4x)m8_x2<(i}i3@7_LI*UB zvooJR3nW8!BAmdVF}d3_oYF z6qnp7;F!IULbD)l0uX!s)T)NCWHN4VMs!>E*ypK3Al<{QmcPL;{F$mHoRgOqGLo10 zXl2CQI6|3_LfRYrq<~1u`76R{23r2UU|p+#l8M>YOu5y~?BL7jW&5hieju>i?e07f z#B1|GffKV9-Xp;&1R@7$A;*c0YKn1vyViePrQQUYPu1C zta2Nl{K0*qx~KoXq*BLRA$*jL*(SE7?Y&j~1)s0nt9z@qES#bk8yj!uq0EOP+Chyt z#e#c9&D}$3`SHnt-3>+?UXj7BSuWPI&Mxx|uZ)G461c&gv$8}JS8p51mVdr~^NUgL0-UQF zI7@|WUQEUzaFzPX7?DT>%C4FH?|t3OO7dPnq?-X6``B~$*s2ZVK?_*TgCe2Rg2~Cs z>Y(VrA-3J%<4Kpdl4s||AKNjXFXU?SbXg%?o`A|nMMJ4!R zgVT60eyk;lQ)PJH>HRL zehLHxnV5@YBrVahSB0PGDq~0MBL%?~=bE;FzHwbIuBN|+bs5W}BPv77+R|LsJB|j* z+O#-UDY*Tqx{O(TqvFY>}_JdRF$7tSE_94%Wu&yop z*#$B6A8l3+>=dA4hs{I%u#_rHABikL76di3eXmVisgf!%9N_N#8Eh<$SP}laUDM^>zE2-0YyylTL@pxH?k z-e_7oKYQZd1xPn1mdCwEM70RLx{wmIMb&@Ahm#ZQ>+LS855pk?=M%j?9xAg<{-HzP zNH|KuzSPAyE(e{TQG+3Hll3%XH_sycgyp&qJ!g_iy4TvrDE0LBD`89xllhY9oOIW$ z$pN}1@Q{WK1#?Nq(4v2D8OY6To|BmCFOhpUs-;EUMw~o?fFZy7yJS5}%G-6zJ8%ON zC78q!aFKr@pldQwa0+EkS?kqRt2B4i9qw6(|qDdpp&)Qt&z zy%Nb;?z3Z^PV(>LUsYHlN85Zj3+iIvyRN3qkp-$!GET`36?noZweX~cjQ58$K}RjW z4Q|AsKgHh$KWe&Cg5Z&}u)XCqo>{%Eq*=__b2J{fQ<1**8Y*@5qQeMGf@| zn`_;87pl%6*CIr2!L#{tO;y#`yJ#C;e#A9_S+?L-)k9N#xH!#7Z>QmI5ZxXJ{CdtZfw5ZGGJGCAo)~6aee!E(A{q~oc4O$05c*q}*Tgls^xoavC#6g&D z*O^%FWTLQlS!5vcdNNV9nC|Co&8ViUlA^9BirLVdq)Ppkw?2$4llrOA z#ZhBXSn=o9i_qScfCJV;oC33Vi6?WH1`v#Ajcy;&LIu8z&Lwj3=Xv3Yi0YiJ8$;p7 z=8?ogcs08*-`#>*9|m;@_KvZ9HVsP_<>kqtjvxOVUq_R1h^UBvj{Y`+h3ylaj6 zIVm@nW~2Ng>8GWIN}j@@b0F3C>Iq0q72I>KyRmrR?9jLVAv#3{DqTe>!tvD8Hl$`( z?*^I0Ki~uv^B^;BZ^_R^)s&k0$e+cQY&o#mS6%9JUs8nz9TSDA#46#5m5EMcmxSDc z9?CoVnW-X(_n@e=#EuhQK`+PW29&rR)sa2yyD+O~r6<+r5eGr9drVJDq;cCFw#OKy zFOjX(UJTc}dw-)R)TI#hy>qq`t=j8j^*i+~&dw9vy?lDTD!xv9zOWf; zx+HYXUg#nu(0IqJzZZ7=Mp^eY4mG{5aFnG(J+f>(T91YwqT*EpU1HdWuCNcte0Ad( zifZ0gH2BjE;cZJz>sjOMoK5atQ}*!?m|9OQt5Dg?02&b@T3?r4poQb*0asy$3XLGei@G1zNk36J-bj5r;DWFMw%cQFhJZTnWPH7USg>(T3a= zb7PF?--o7sKf;plIu+(ksZq~=5v9{fq6u%wB>E?qAO`;g7I_d5uBiH_*RU}nmM9PY zpNlrKnfak=UHX`=bL1$8wDm5zqrYiU8EIjihZr+>D~dE78zq`4ERYFAe@bBtep_lHqQauAe3kxa zzTzvAzkJM~M3HtlpxPT4A(BF3E(vaUayT$sl#w^To)<`4d2FL*wLpr*_)!;tYlKHF zEWsE{s<^pe?9kil67ja8mmI!Rk{=xvdzL)poo-VfxG_}E*m1w;wkr=xoIIbmGNSyU znCPJTDarLZIghtC60&x@7^@Ch4C;k@DIPyO$llPev#z!twd|awL8+`%p?P=|Vxh9P%+=q?Lb>;=d#jPAG7~L(4mx5UI+hacRdGor#EMdaL`BE-iHlJxeExHB z-I4QRrVz*TxOB~1dOs^F{ilnHG-=ksHjT*dJSWbGEe?Nmlc4o9)6FP%k~EZ6kSiuP zBRt+uR;mmo7T9o`Z1nUC2sJyz^q9}~dLEsFm4wSSNRKzmR#~sx9>6x|uGZ?7ugpj` z9Vc2@`|dqpn7K6ElV?X;b>28OkM&tK6nx7Gcny4)*2|c+k33l_-mD+q9RYqyX0;!&m!l}JG-FO z6ZJFO-SLXPBIu0zEr=nGWp}orsDkLEplQ`t2u95hX8M5^J~~NPi#GSzKkE&-gQn)i z}V!YogU}1y<(CWL&_+I#U6^0Zhe~8+aFrYgBkZtXSM$2^j@F9!B z73{~H$kuwal)5{W67iM~UXQG&3HdtB(QZR$COt-ziZJB&OZm{zb<*e!w*rhDxh z^#jIoLBZL^8VwB2n(s&I`<2%9vZ~7e)!w)NL!I}37mG@0J5a*Z?zNqS+HxFYSX;KE zN+E|~S0d-a3^QXSSJ|!5u1b+ZDOO@+nsFEgt8GGN$YIPd2Z_NP8FMhl`=h$9y&vEE z{u92x%@6N+%xB)G*Wr2i5P~ge&LaIgk!W?$axx<~kZE}=jjP?ewP&*Gye>d*JK2ke zgMUwV9cC#L26M&^ilx?mWAhMn^j#JQ5iNdYXdI33xD6L#i2hM4pNsfGZGxd7anMS-rusvC&M!iLw?k+0dY6*4sWokCI880N)D%1Y`i;g?l7x@ zCeyj0@87TB_DqKoEjE*a!fr}^b?-nokPeTUW)?aNbC%iFS#+RjM4_}0Y?s1*7#z}L zU&b3p>NEMVH4@Je{a}Dqa2l0ZY@tvp(5)vlQv_qv+oZ>srFYSY)B0?F9+nG;At3HK zv{FrW45ntkuaCIFr~zI&l75vRZ`UE^jFduBJ4+$!8ZrFGS;BOckJo5L6ylo)r@MCR z5}lO|ilM6$x9Qm1yp&2B8M1(b|7kZ5_Tm!T4TMWk1ApuTvaf}ga{RZN( z)a`2ubUnGbHFaq9`>u-6afcTr4B;{TFtdY@;ZBcz)5NCIk#MhCYl-Km+X9mw*TKt{ zwvM;DnIR#gQl6^Wat4-^w8&dJ5QP}jYZZK?UN&+-u@;&`$8$?+>ozNtdDtqq3yG4u zf~t41)S5->kNjqvMPxmXMkUOL)ACBTVhBZF0N3OH0xHC>{fL&Dd5~^ib~P@*QB@xj zq)OCj)se$Q`|)I9R}8%HMyn59MjGQ~EHSNM+J!>Z;R8dNZf6^|oM@}zW6`5*{P+-a1m zgCEUmoc@d{W-aI~{eF50;}T)2XA>U7LCN^Lewt^F424>_i}A#Rqu%#8RuE-g&86MS23(WC)RtOLbf6`*ZyyX#+pLHPaz~Y(T2S zmb$fR7A_n4tgHt)NJ3JIpEAeEr}L{jXp$&9GEI_>Yi`5zR>zg(rQZE(-^12`q-p4b z=I*(j40_d!X2YWP(VCPDA6mAYIX-!s6Q^1Dj4uPOKr0is)ZTBj2IPM+olPAyXzTQ# zq=BncUe1(hTlv&#Px(;w>4e%wtb`6n*!4@dIb#!h=kf5#GuG~>@Ex=Tl)%h)rmj{b zyXa@Lqi;a!Nh3QY_%u?&Y1l|FtU-&-N98;pXFwWB2zj1u^n5H!BtE&i0yX(2G?*>G z`_fbqA$fJe8Du$+8y}wwhsy>0MWo4>nY;_MTJ5;Qzl{_al59p9IW)C*w38Q@?eTHi z%nUuYc}BTeL(hh>r|^^cFEUcW>tvyvBYxHmV3LhOnKOoVrYYr~bl8};pT)s`%|b-J ziM>lo^pIj)M}2hOY--lH)bI{F+o+Ay8(Zs?)7)jgN@Xv8T5W2sP}bE}*(x9bnkK0z ztD%kHv!@@g{H}XU%0Ue2>ppWa${zvK=Zf{mYnf~fvolfsCNWM|=v;r6Q`~mUn^k5m zyKA87T92t6$`dk*SPf)q+%zzYkbXQZA3ar*z0)1DxYCLEM5yO$sQ@kybQI0Uqg(Jd zzs|TNIJPrE_H&jfz&HO2LZIkr9!rZH8}+#9wCW4zoD3o@?w@^749*Uqqye ztzoKlMUc208g5oGMAW{Tw^qk=+QBS?K;^Nk! zMaDIlZ)m+ea6wnip1YqAuO6TQ zcz;vuc~z8$rcMh{Uzkw1t^Sm6~haJ zNqCB1mPn+gh~lVxaJvNDSVmkwGj}EJ6b}@FLmJ0vn(nm;Ibw(FOWtD&rd6xEsaT^VOMKD1Hjx(+iAI086sdTx(t0BplV{!Y6O^~&^xRNm6PhV!8 z*#OUG4Ge^q03pmQLE~}xauL){p&BrW5?}*+qwB1H~8dw1xAJ|vj$TM z{F%8G5Kn0dD{dbz9$3NbaI>qmEU1`}Oi3ckSLc8l+j@EA1}cGAgZR1M(?9!X6Lc-q zH!=_^FC3vfVrss%r1MV5f(Vy$cBWr#!3`D<{%+V}X@%-9j*kM9j&b4X$t~k7rnNyA zG2*@FNUx1pi32ra5Xor>M82es40N5A*ZK{RYvdKocFc33x+Q&;XhWIe^(a(S?3{a+ zQ^S4b*gt$3DV|%2HNrFOg9(HYivBOgNP#px$5eO_oS0^0;2SH>F6s#<66xWzGZqc$ zEimp%thAtz#nCv=KQi&J%`}Vgqcy-Wb?pRC8t7P;%URL8`mIm%g3fO%Hu*&mEqg#q z@8D(7q-uIWm0_8-=ix-y&0AiQX?ow!o)EWb=w^kZoc@{uA$(*-!=lInJTzD$pmllF zLItW2|F>c*QMw`yO!FVH=3gfBhvI@owy3z#*O+&K9-Mpd_u}s#vf~1m_zx91-eS6@ z&$oyByvsJ5`$%P*H*((y01-bk01phzG-QcF5lqJc*O9mS?8`e-zU#-kkMV(6Z~Sk_ z9Vy&~gQQdD;qZ4t#lG$?coMF9t$9B(2`ofI$zzvHMU(zF8h35=uz?U!nXJnh0tks% zJeRt@MzA_X0#Af=NIl$va7LG;w_(O{1`YIWPFp`#Qs%cc>ET1qG5f5+WafHpIGuH$(|!U_*-1N zEXZ$*`>#@XdKUJXecH`zyo3oeLl?8=rJP=}i~XNcBx=NyM%nUg|LtpT?9L&x*XQ?S zL)7LMY~IC#th5de;keL=xFlg#vC&mbf*)0}u@`_EyzQ13Vw;v!!;FYb*{~+?W)}}8 zZ&@8Ia*}i)V^to50o)Sy7rS{QMpIWxvILL8y_{yH90c87q zkJ#{%s`ZhA&58h;+x)PW>r<=$5_W z+V%W|64klpJlZvL-JORtx=@g+Qy?8qE}~VL>QggS{3Yb?X1Wm}>L))7_nAHxHh_w) zai@@#a*!dPj%XD$8E9Zpk(qx2$C-<0ms{Ze?u4qe0iwGZB#dWf;Dgs>%sz2ws;DZD zdwywSZmMNj*g6pi7~%NA?_k0lfEZf?p;-`^bJ%A-578Py)X`d}9q}Ptz@th8hx%d` z3SwumF+1_#X`~;(fhbU!&5z0j45wjj-oWP_kCs2e2NJFRS zsfXq3^H9t?KervyOEDI$W**Z$fXR<}aQWlJ?YD9nH|Y7Qh>a(1*P1l9n=c|)@RHvh z^LtzAmbQW~u-iAngkcAx#;y;S1RBTTX4e+6!c)`JTj(WW?G{*A;zC2l<~=I*%yHu& zcTWkaVPz4hSc)@Bg){j)zDr8ff#3id?+7{t2%wynH{lYhWgw^6E-EYv`%v0Vq7bT; z$PthGe>}dlWl(v6%ew0;vup(@A@DT-(~^=}9eMVIQCs|~6q6n}LemvF<|W#P?}R>> zzOBEIp<;zY0Sr=m&=Ib3~s9@hjF%ng0&KI`XJ(OPZx}_~* z>K*9qmWB-k6M5~b?_{qeinl%<4H5=yFLd5>SFG1qY}%GhGbGo3sP~D!0&g?6XfEAO$4x;@NzfK!Q`A7T4)T8EJn!cHu+BwTMv1h z_$pZ5NW>?$X`)~#*`cK!K6d?nz-Zv4V5e?P66AY|Ts!c!Lp7r7y zlfRj~q%bqmK7#BNJrMNI#kVzZXJU&Rw?>!TYpZ)373JeDdEDMgdTv#GJ%38fV5mYg zbd%?|%aQ>{gn0k}LA6ZN%W0Kqw9o>b0pZ9`Bq5KKKs;Zp$ILd8XtESh3`j&f=3m)5k}9yCXJ(cJ;ov7H z(Q2zt87Dv`JNJ9(Jx6hE1k#*O*xf&Tb?Ch%|96vw<;*BZ4kU%t%)cg0O>LH9v}Ice zA;H8Pp!~RK{#JPsD}7vTf@$O9j7Trj1i8U1<$?U8?DUlxVCmyn&REQ(ai=o z(lu$|OoGhjY3{YVOt4wnw#j%wx~|{@=<8--3lIL>0Wx2h-5C+a+D(&w!;{pp)z^>wL5mrkAG3f(qH*wcgTb+Y&@lZt&;J6}E%0+9Y8Vt&?q)avBgJuae z723X(06jP$k!2(w01wMbyA4T<-s(f}W78TsH``D)~g!IDu;0VgzT>~Be8bgl9n!(--=Yva4lKirIn>>mj zq*%WxH{eRcR(r_2vvr(1@y;TeQad2OYw%alY5;?fxwOXl3FSN3+}7^t5hpSa~EP1v3{Bslp1(G8{(LxGdc(uf#dc z0ZNte#rQBk0J&SX#{{=N0TL9e(ab@2J{G$a7G6B9K09JAiD(+OQgmOQ_y-3I*_j>Tu zM2;Uk@0HJrtm&@+T|EVU5rXOmcZ06gLl0k;GZCWOeb-nZbth@CtF|xJeRZMN5k};Y|gW2-{$%ZD$`&oDMZ&M1<#@P?w|u+ldmf{ow=2p;8#gQNs8H4 zZo?AE6*R6A8Ak7?*MIUUa9LD>GBSYMom?Re8nHUx+l()#u|erltp^V77A6QwzK?Tl zVU4i-=;1EB$@sKoshA8?_4m_ZJsz)u6BGFzrip9_xx|U}!fN*4yfpaDo0XdkT7Z&L z&@>q1n&5?nEa-)`Ulj_2PJuU9+Ftc7$1Sgi;>fe2m zIR}A?tsN<2B?Sp^y)9-zuP`C54y(EicTZA^Me|5Fn)k?C)d!C%mfOsGx?mIJ@48{L zsH6JqZscRYHD&KjU^n{&F!X>PjM;SM+T)gr5vj%K^p+V|a^LTQP3i*ZQiXuq+CdY3 z2qyyhO{_^qAq~bgXe15BN)MTt{8AeaWBdTzgYV4`jt*NhE!q_=PkPOV{8i#otLa*zVNea)8&S^(pn$1XPbi&_fqu0*Zxk>?v!6 z?5U{iG8bS}9g*P)6@bIot!0bDd3<9z%_iN8`!q}R>Z^3xBB_WqAmu3}|H{Hvx?RYI z@yLj)T{*PxXV+ltP_hyx|D|B@#>7hYY@cEC2<2Kx-$1QHe_!4O5$}i|n|U^;jjQ^7 z4*;K^M0$RpvJfoE$L(n>`XC6%ua!23qb??<`{NzJnd@N9gC^5-;vWh2 zBD@iyw2B9GasmPn$+h{FddvxSWzW_Rl$YIl?2_qb2Q_V=z|g_w-)S8@D#l&@%@r|6 zY?i(k*3ewR{CdpLIl8bns5`Q|u1LQ+Seqx~7V8fgE`_R6H;Dh4bUnPLz+` zI2XQl)hj=MB3QyZlYTZ*pZ&xb4n(?lG{*xBJR%cdka0`x<()>L{0rIuNRn$S$DJOq1A{k1BjXz$v_wcR} z>7jQ7OgJ5_#0tp=Lpr+liyc8@O#IbCp96Ydwe&T;x7Eu49UCuDI{nXnIKL8NMHg6BZFA@^{~FQYcqv7^h^w zwC+bZy!czCT+obpZXL<3Jv2bAZ$7I{B{yKRdR}?#84UoH?2H83AmRQ%J%sxsVK()R z0SPe1l?1tcxOl@coY0-q>j89mx?&+?i-mYa52NZ==Vm-%Q18-;yP zd5y6%fat*mCMmto4z?xz-weoL=ig8+7kS?2RfAUmnJ-{% z^l{$<%Qc_8u(qESh)yIT3*cLNu(|nm*D>nqDXBgp=gM>OXir4-j>p=5<>OQKD2z*bV86CO zs^b;-n&f#bwelbT7N*NF@-@ZG8mo+Ii~@`Sm!;VWz`bCKVey9D<(66pNQeA1msCTJ zui6KzPUiR>BnOP;ym2+K_MHP%T7!`j+Xd}0naG#R9xYZqq|E27pt8lAw6*q{iLzB0 zh?gDh)W2(P_`dWVRxC^xC)&4m)Hbp#=O(S+dv5|}@-t!q#Iu%Vs}ecw&X#TU-_|?s zQeW>o35I>vrvNTX|F2DsC3T{0;>K3+urFgA6IJtrC1tf%4tf{G~q`!K!4{%%dfc*o5JiyXl+b8CY z46(?$hn?>iNY$#DuHTOJ&fD8WQD2{*IM7Tzms6!3wXaspJo_o8gXm4=@TF-|phBvYX-^}4iAQ@Xbjkh=X+2gV6&J1!9P0a4lyiY3CX0UnXgs&)i$h zM!;=P6B2OoADVB{$*Wfj8~-mGb}X>ZQEjcq{}I7nwSuwqSEU4U&Qmk}H*4C;TAc5y z&W?sOsKll0s@?lPy~ZMI%j)_r@D~f1&pTot2q1SXH6@?>?*;+}0kHL|qTbH~mhrlG zK7hXD(;&;QU1T`28#V*>-#^AO*szqobv28cl{&s+qDy53Q}&3 z{D-g#Sne$wF-91_N%}hQY}N*gP>&|t{Yw^@UbdMXMqmLj&Z$Vsxi4a6w7-W8HVr7v zaX=I=sdWzUUXiuifaJb*J-_`4S*{lQ{(FwCZPabQn-7!P{YT+k_6sQH>zM|?8YdJ6 zdGn8t`W+x9oLD~qoRBYPrMwqdi~k+-AIkUt&d>kujZcT;|9dV*%i>PI>;&j*-e$`} zzo|nG96z;b$A2{bpWdyop#5YhbYJfKlKLW+K2d^qq5UKHe^3ovmB*W#|1sd~cmdpF g|C6vU*6DXV{afrCI7eE3J=T#!Cx5K_A^h6^0j+RJq5uE@ literal 0 HcmV?d00001 diff --git a/docs/codeitems/sound.md b/docs/codeitems/sound.md new file mode 100644 index 0000000..c76a576 --- /dev/null +++ b/docs/codeitems/sound.md @@ -0,0 +1,45 @@ +## Syntax +Sounds are created using the `snd` and `csnd` constructors. Like all constructors in Terracotta, the values passed into the constructor are [Expressions](../language_features/expressions.md) and can take full advantage of their features. + +```tc +snd[Sound: str, Volume: num*, Pitch: num*, Variant: str*] +csnd[Sound: str, Volume: num*, Pitch: num*] +``` + +!!! warning "Constant numbers passed directly into the constructor will maintain their full precision, however if an expression that evaluates to a number is passed, that number's precision will be limited to three decimal places due to DiamondFire's precision limit." + +`Volume` and `Pitch` default to `1` if omitted. +To play a random variant every time, omit the `Variant` argument. + +When using the `snd` constructor, `Sound` is the name that appears at the top of a sound's button, and `Variant` is the ID that appears in the button's lore. +```tc +snd["Stone Break", 1, 1, "stone1"]; +``` +![Clarification Image](../assets/sound_arg_clarification.png){ width="500" } + +When using the `csnd` constructor, `Sound` is the minecraft id of the sound that would be used in a /playsound command. This allows the use of custom sounds provided by a plot resource pack. + +```tc +# Custom sounds can be played. +csnd["item.custom_magic_wand.use"] + +# Vanilla sounds can also be played with their Minecraft ids. +# Using csnd for vanilla sounds is not recommended as variants cannot +# be specified and a sound's Minecraft id may change between updates. +csnd["block.stone.break", 1, 0.8] +``` + +## Operations + +### + (Addition) +#### `txt` + `snd`: `txt` +Converts the right Sound into a String then adds it onto the end of the left Styled Text. +```tc +s"Cool sound: " + snd["Stone Break", 1, 1, "stone1"] = s"Cool sound: Stone Break,stone1[1.0][1.0]" +``` + +#### `snd` + `txt`: `txt` +Converts the left Sound into a String then adds it at the beginning of the right Styled Text. +```tc +snd["Stone Break", 1, 1, "stone1"] + s" is a cool sound." = s"Stone Break,stone1[1.0][1.0] is a cool sound." +``` \ No newline at end of file diff --git a/mkdocs.yml b/mkdocs.yml index e996cea..c3340e6 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -59,6 +59,7 @@ nav: - Styled Text: codeitems/styled_text.md - Vector: codeitems/vector.md - Location: codeitems/location.md + - Sound: codeitems/sound.md - Code Blocks: - Action: codeblocks/action.md - Function: codeblocks/function.md