From fe4f9ed59785563d535ea7d5de1002ae8b311db5 Mon Sep 17 00:00:00 2001
From: Albert Graef <aggraef@gmail.com>
Date: Mon, 23 Sep 2024 11:38:08 +0200
Subject: [PATCH] Integrate Ben's section on dollar symbol expansion, add
 example.

---
 pdlua/tutorial/examples/localsend.pd     |  20 +++++
 pdlua/tutorial/examples/localsend.pd_lua |  23 ++++++
 pdlua/tutorial/pd-lua-intro.pdf          | Bin 1548448 -> 1589712 bytes
 tutorial/19-dollar-symbols.png           | Bin 0 -> 27834 bytes
 tutorial/pd-lua-intro.html               |  45 +++++++-----
 tutorial/pd-lua-intro.md                 |  89 +++++++++++++----------
 6 files changed, 120 insertions(+), 57 deletions(-)
 create mode 100644 pdlua/tutorial/examples/localsend.pd
 create mode 100644 pdlua/tutorial/examples/localsend.pd_lua
 create mode 100644 tutorial/19-dollar-symbols.png

diff --git a/pdlua/tutorial/examples/localsend.pd b/pdlua/tutorial/examples/localsend.pd
new file mode 100644
index 0000000..383c103
--- /dev/null
+++ b/pdlua/tutorial/examples/localsend.pd
@@ -0,0 +1,20 @@
+#N canvas 580 203 398 197 12;
+#X declare -lib pdlua;
+#X obj 240 110 tgl 20 0 empty \$0-onoff empty 17 7 0 10 #dfdfdf #000000
+#000000 1 1;
+#X floatatom 240 144 5 0 0 0 - - -, f 5;
+#X obj 40 120 bng 20 250 50 0 empty empty empty 17 7 0 10 #dfdfdf #000000
+#000000;
+#X text 68 119 <-- click me;
+#X obj 175 19 declare -lib pdlua;
+#X obj 40 154 localsend \$0-onoff;
+#X obj 290 110 tgl 20 0 empty onoff empty 17 7 0 10 #dfdfdf #000000
+#000000 0 1;
+#X floatatom 290 144 5 0 0 0 - - -, f 5;
+#X msg 40 50 sender \\\$0-onoff;
+#X msg 40 80 sender onoff;
+#X connect 0 0 1 0;
+#X connect 2 0 5 0;
+#X connect 6 0 7 0;
+#X connect 8 0 5 0;
+#X connect 9 0 5 0;
diff --git a/pdlua/tutorial/examples/localsend.pd_lua b/pdlua/tutorial/examples/localsend.pd_lua
new file mode 100644
index 0000000..f4a75c5
--- /dev/null
+++ b/pdlua/tutorial/examples/localsend.pd_lua
@@ -0,0 +1,23 @@
+local localsend = pd.Class:new():register("localsend")
+
+function localsend:initialize(sel, atoms)
+   self.inlets = 1
+   -- pass the symbol from the creation argument,
+   -- which gets automatically expanded here
+   self.sender = tostring(atoms[1])
+   return true
+end
+
+function localsend:in_1_sender(x)
+   local sendername = tostring(x[1])
+
+   -- store the original name as argument (like "\$0-foo")
+   self:set_args({sendername})
+
+   -- apply the expanded name with the local id
+   self.sender = self:canvas_realizedollar(sendername)
+end
+
+function localsend:in_1_bang()
+   pd.send(self.sender, "bang", {})
+end
diff --git a/pdlua/tutorial/pd-lua-intro.pdf b/pdlua/tutorial/pd-lua-intro.pdf
index 02c86d6ff9996c4d5d0b50abdbbfdd3b4800271c..d31fc13ff9bbdd12cf1c5ea18ea83bac06212291 100644
GIT binary patch
delta 314374
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

delta 274311
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%0DNfs2e_bq5LoNQ<N
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

diff --git a/tutorial/19-dollar-symbols.png b/tutorial/19-dollar-symbols.png
new file mode 100644
index 0000000000000000000000000000000000000000..68bbbcb456daffc243b91105aab88f69fced7f61
GIT binary patch
literal 27834
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

literal 0
HcmV?d00001

diff --git a/tutorial/pd-lua-intro.html b/tutorial/pd-lua-intro.html
index ddae956..40f9571 100644
--- a/tutorial/pd-lua-intro.html
+++ b/tutorial/pd-lua-intro.html
@@ -704,27 +704,27 @@
 </style><title>A Quick Introduction to Pd-Lua</title>
 </head>
 <body class='typora-export'><div class='typora-export-content'>
-<div id='write'  class=''><h1 id='a-quick-introduction-to-pd-lua'><span>A Quick Introduction to Pd-Lua</span></h1><p><span>Albert Gräf </span><span>&lt;</span><a href='mailto:aggraef@gmail.com' target='_blank' class='url'>aggraef@gmail.com</a><span>&gt;</span><span></span><br/><span>Computer Music Dept., Institute of Art History and Musicology</span><br/><span>Johannes Gutenberg University (JGU) Mainz, Germany</span><br/><span>September 2024</span></p><p><span>This document is licensed under </span><a href='https://creativecommons.org/licenses/by-sa/4.0/'><span>CC BY-SA 4.0</span></a><span>. Other formats: </span><a href='https://github.com/agraef/pd-lua/blob/master/tutorial/pd-lua-intro.md'><span>Markdown</span></a><span> source, </span><a href='https://agraef.github.io/pd-lua/tutorial/pd-lua-intro.pdf'><span>PDF</span></a><span></span><br/><span>Permanent link: </span><a href='https://agraef.github.io/pd-lua/tutorial/pd-lua-intro.html' target='_blank' class='url'>https://agraef.github.io/pd-lua/tutorial/pd-lua-intro.html</a></p><h2 id='why-pd-lua'><span>Why Pd-Lua?</span></h2><p><span>Pd&#39;s facilities for data structures, iteration, and recursion are somewhat limited, thus sooner or later you&#39;ll probably run into a problem that can&#39;t be easily solved by a Pd abstraction any more. At this point you&#39;ll have to consider writing an external object (or just </span><em><span>external</span></em><span>, for short) in a &quot;real&quot; programming language instead. Pd externals are usually programmed using C, the same programming language that Pd itself is written in. But novices may find C difficult to learn, and the arcana of Pd&#39;s C interface may also be hard to master.</span></p><p><span>Enter Pd-Lua, the Pd programmer&#39;s secret weapon, which lets you develop your externals in the </span><a href='https://www.lua.org/'><span>Lua</span></a><span> scripting language. Pd-Lua was originally written by Claude Heiland-Allen and has since been maintained by a number of other people in the Pd community. Lua, from </span><a href='http://www.puc-rio.br/'><span>PUC Rio</span></a><span>, is open-source (under the MIT license), mature, very popular, and supported by a large developer community. It is a small programming language, but very capable, and is generally considered to be relatively easy to learn. For programming Pd externals, you&#39;ll also need to learn a few bits and pieces which let you interface your Lua functions to Pd, as explained in this tutorial, but programming externals in Lua is still quite easy and a lot of fun. Using Pd-Lua, you can program your own externals ranging from little helper objects to full-blown synthesizers, sequencers, and algorithmic composition tools. It gives you access to Pd arrays and tables, as well as a number of other useful facilities such as clocks and receivers, which we&#39;ll explain in some detail. Pd-Lua also ships with a large collection of instructive examples which you&#39;ll find helpful when exploring its possibilities.</span></p><p><span>Pd-Lua was originally designed for control processing, so we used to recommend </span><a href='https://faust.grame.fr/'><span>Faust</span></a><span> for doing dsp instead. We still do, but Faust isn&#39;t for everyone; being a purely functional language, Faust follows a paradigm which most programmers aren&#39;t very familiar with. Fortunately, thanks to the work of Timothy Schoen, the most recent Pd-Lua versions now also provide support for signal processing and even graphics. So it is now possible to create pretty much any kind of Pd object in Lua, including dsp objects. (However, Faust will almost certainly execute dsp code much more efficiently than Pd-Lua, as it generates highly optimized native code for just this purpose.)</span></p><p><span>Note that we can&#39;t possibly cover Pd or the Lua language themselves here, so you&#39;ll have to refer to other online resources to learn about those. In particular, check out the Lua website, which has extensive </span><a href='https://www.lua.org/docs.html'><span>documentation</span></a><span> available, and maybe have a look at Derek Banas&#39; </span><a href='https://www.youtube.com/watch?v=iMacxZQMPXs'><span>video tutorial</span></a><span> for a quick overview of Lua. For Pd, we recommend the Pd FLOSS Manual at </span><a href='https://flossmanuals.net/' target='_blank' class='url'>https://flossmanuals.net/</a><span> to get started.</span></p><h2 id='installation'><span>Installation</span></h2><p><span>Pd-Lua works inside any reasonably modern Pd flavor. This encompasses vanilla </span><a href='http://msp.ucsd.edu/software.html'><span>Pd</span></a><span>, of course, but also </span><a href='https://agraef.github.io/purr-data/'><span>Purr Data</span></a><span> which includes an up-to-date version of Pd-Lua for Lua 5.4 and has it enabled by default, so you should be ready to go immediately; no need to install anything else. The same is true for </span><a href='https://plugdata.org/'><span>plugdata</span></a><span> (version 0.6.3 or later), a Pd flavor which can also run as a plug-in inside a DAW.</span></p><p><span>With vanilla Pd, you can install the pdlua package from Deken. There&#39;s also an official </span><a href='https://salsa.debian.org/multimedia-team/pd/pd-lua'><span>Debian</span></a><span> package, maintained by IOhannes Zmölnig. You can also compile Pd-Lua from source, using the author&#39;s </span><a href='https://github.com/agraef/pd-lua'><span>Github repository</span></a><span>. Compilation instructions are in the README, and you&#39;ll also find some Mac and Windows binaries there. In either case, after installing Pd-Lua you also have to add </span><code>pdlua</code><span> to Pd&#39;s startup libraries.</span></p><p><span>If all is well, you should see a message like the following in the Pd console (note that for vanilla Pd you&#39;ll have to switch the log level to 2 or more to see that message):</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang=""><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang=""><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51982px; left: 7.99336px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation"><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;">pdlua 0.12.4 (GPL) 2008 Claude Heiland-Allen, 2014 Martin Peach et al.</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;">pdlua: compiled for pd-0.55 on Aug 24 2024 00:51:01</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;">Using lua version 5.4</span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 69px;"></div><div class="CodeMirror-gutters" style="display: none; height: 69px;"></div></div></div></pre><p><span>This will also tell you the Lua version that Pd-Lua is using, so that you can install a matching version of the stand-alone Lua interpreter if needed. Lua should be readily available from your package repositories on Linux, and for Mac and Windows you can find binaries on the Lua website. In the following we generally assume that you&#39;re using Lua 5.3 or later (using Lua versions older than 5.3 is not recommended).</span></p><p><span>If all is not well and you do </span><em><span>not</span></em><span> see that message, then most likely Pd-Lua refused to load because the Lua library is missing. This shouldn&#39;t happen if you installed Pd-Lua from a binary package, but if it does then you may have to manually install the right version of the Lua library to make Pd-Lua work. Make sure that you install the package with the Lua </span><em><span>library</span></em><span> in it; on Debian, Ubuntu and their derivatives this will be something like liblua5.4-0.</span></p><h2 id='a-basic-example'><span>A basic example</span></h2><p><span>With that out of the way, let&#39;s have a look at the most essential parts of a Lua external. To make an external, say </span><code>foo</code><span>, loadable by Pd-Lua, you need to put it into a Lua script, which is simply a text file with the right name (which must be the same as the object name, </span><code>foo</code><span> in this case) and extension (which needs to be </span><code>.pd_lua</code><span>), so the file name will be </span><code>foo.pd_lua</code><span> in this example.</span></p><p><span>Any implementation of an object must always include:</span></p><ul><li><p><span>a call to the </span><code>pd.Class:new():register</code><span> method which registers the object class with Pd (this should always be the first line of the script, other than comments)</span></p></li><li><p><span>a definition of the </span><code>initialize</code><span> method for your object class</span></p></li></ul><p><span>Here is a prototypical example (this is the contents of the foo.pd_lua file):</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51982px; left: 7.99336px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><span><span>​</span>x</span></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">local</span> <span class="cm-variable">foo</span> = <span class="cm-variable">pd.Class</span>:<span class="cm-variable">new</span>():<span class="cm-variable">register</span>(<span class="cm-string">"foo"</span>)</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
-</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">foo</span>:<span class="cm-variable">initialize</span>(<span class="cm-variable">sel</span>, <span class="cm-variable">atoms</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">return</span> <span class="cm-keyword">true</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 115px;"></div><div class="CodeMirror-gutters" style="display: none; height: 115px;"></div></div></div></pre><p><span>Note that in the first line we called </span><code>pd.Class:new():register</code><span> with the name of the object class as a string, which </span><em><span>must</span></em><span> be the same as the basename of the script, otherwise Pd&#39;s loader will get very confused, create the wrong object class, print a (rather cryptic) error message, and won&#39;t be able to create the object.</span></p><p><span>We also assigned the created class (which is represented as a Lua table) to a variable </span><code>foo</code><span> (which we made local to the script file here, as explained below). We need that variable as a qualifier for the methods of the object class, including </span><code>initialize</code><span>. You can actually name that variable whatever you want, as long as you use that name consistently throughout the script. This can be useful at times, if the actual class name you chose, as it is known to Pd and set with </span><code>pd.Class:new():register</code><span> (as well as being the basename of your .pd_lua script), is a jumble of special characters such as </span><code>fo:o#?!</code><span>, which isn&#39;t a valid Lua identifier.</span></p><p><span>Next comes the </span><code>initialize</code><span> method, which is implemented as a Lua function, prefixing the method name with the name of the class variable we created above and a colon, i.e., </span><code>foo:initialize</code><span>. (This </span><em><span>colon syntax</span></em><span> is used for all functions that represent </span><em><span>methods</span></em><span>, which receive the called object as an implicit </span><code>self</code><span> parameter; please check the section on function definitions in the Lua manual for details.) As a bare minimum, as is shown here, this method </span><em><span>must</span></em><span> return </span><code>true</code><span>, otherwise the loader will assume that the object creation has failed, and will complain that it couldn&#39;t create the object with an error message.</span></p><p><span>We mention in passing here that Pd-Lua also provides a parameter-less </span><code>postinitialize</code><span> method which can be used to execute code after the object has been created, but before the object starts processing messages. We&#39;ll see an example of this method later.</span></p><hr /><p><strong><span>NOTE:</span></strong><span> Pd-Lua runs </span><em><span>all</span></em><span> Lua objects in the same instance of the Lua interpreter. Therefore, as a general guideline, we want to keep the global name space tidy and clean. That&#39;s why we made </span><code>foo</code><span> a local variable, which means that its scope is confined to this single script. Note that this isn&#39;t needed for the member variables and methods, as these are securely stowed away inside the object and not accessible from the outside anyway, if the class variable is </span><code>local</code><span>. But the same caveat applies to all variables and functions in the script file that might be needed to implement the object, so normally you want to mark these as </span><code>local</code><span>, too (or turn them into member variables and methods, if that seems more appropriate).</span></p><p><span>We mention in passing that global variables and functions may also have their uses if you need to share a certain amount of global state between different Lua objects. But even then it&#39;s usually safer to have the objects communicate with each other behind the scenes using receivers, which we&#39;ll explain later.</span></p><hr /><p><span>To actually use the object class we just created, Pd needs be able to find our foo.pd_lua file. We&#39;ll discuss different approaches in the following section, but the easiest way to achieve this is to just drop foo.pd_lua into the directory that your patch is in (say, </span><code>pd-lua</code><span> in your home directory). Now we can just create our first </span><code>foo</code><span> object (hit Ctrl+1, then type the object name </span><code>foo</code><span>), and we should see something like this:</span></p><p><img src="01-first-light.png" referrerpolicy="no-referrer" alt="First light"></p><p><span>Hooray, it works! :)) Well, this object doesn&#39;t do anything right now, so let&#39;s equip it with a single inlet/outlet pair. This is what the </span><code>initialize</code><span> method is for, so we have to edit that method accordingly.</span></p><p><span>NB: If you closed the editor already and don&#39;t remember where the file is, you can just right-click the object and choose </span><code>Open</code><span>, which will open the .pd_lua file in your favorite text editor, as configured in your desktop and/or shell environment.</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51982px; left: 7.99336px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">local</span> <span class="cm-variable">foo</span> = <span class="cm-variable">pd.Class</span>:<span class="cm-variable">new</span>():<span class="cm-variable">register</span>(<span class="cm-string">"foo"</span>)</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
-</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">foo</span>:<span class="cm-variable">initialize</span>(<span class="cm-variable">sel</span>, <span class="cm-variable">atoms</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.inlets</span> = <span class="cm-number">1</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.outlets</span> = <span class="cm-number">1</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">return</span> <span class="cm-keyword">true</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 161px;"></div><div class="CodeMirror-gutters" style="display: none; height: 161px;"></div></div></div></pre><p><span>Note that, as we already mentioned, the </span><code>self</code><span> variable here is an implicit parameter of any Lua method, which refers to the object itself. Every Pd-Lua object has two member variables </span><code>inlets</code><span> and </span><code>outlets</code><span> which let us specify the number of inlets and outlets our object should have. This needs to be done when the object is initialized; afterwards, the number of inlets and outlets is set in stone and can&#39;t be changed any more.</span></p><p><span>Next, we have to make sure that Pd picks up our edited class definition. Since the Pd-Lua loader will never reload the .pd_lua file for any given object class during a Pd session, we will have to save the patch, quit Pd, relaunch it and reopen the patch:</span></p><p><img src="02-inoutlets.png" referrerpolicy="no-referrer" alt="Inlet and outlet"></p><p><span>So there, we got our single inlet/outlet pair now. To do anything with these, we finally have to add some </span><em><span>message handlers</span></em><span> to our object. Say, for instance, we want to handle a bang message by incrementing a counter and outputting its current value to the outlet. We first have to initialize the counter value in the </span><code>initialize</code><span> method. As we want each </span><code>foo</code><span> object to have its own local counter value, we create the counter as a member variable:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51982px; left: 7.99336px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">foo</span>:<span class="cm-variable">initialize</span>(<span class="cm-variable">sel</span>, <span class="cm-variable">atoms</span>)</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.inlets</span> = <span class="cm-number">1</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.outlets</span> = <span class="cm-number">1</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.counter</span> = <span class="cm-number">0</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">return</span> <span class="cm-keyword">true</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 138px;"></div><div class="CodeMirror-gutters" style="display: none; height: 138px;"></div></div></div></pre><p><span>It&#39;s not necessary to declare the </span><code>self.counter</code><span> variable in any way, just give it an initial value and be done with it. Finally, we have to add a method for the bang message, which looks as follows:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51982px; left: 7.99336px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation"><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">foo</span>:<span class="cm-variable">in_1_bang</span>()</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.counter</span> = <span class="cm-variable">self.counter</span> + <span class="cm-number">1</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self</span>:<span class="cm-variable">outlet</span>(<span class="cm-number">1</span>, <span class="cm-string">"float"</span>, {<span class="cm-variable">self.counter</span>})</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 92px;"></div><div class="CodeMirror-gutters" style="display: none; height: 92px;"></div></div></div></pre><p><span>We&#39;ll dive into the naming conventions for message handlers later, but note that </span><code>in_1</code><span> specifies the first (and only) inlet and </span><code>bang</code><span> the kind of message we expect. In the body of the method we increment the </span><code>self.counter</code><span> value and output its new value on the first (and only) outlet. This is done by the predefined </span><code>self:outlet</code><span> method which takes three arguments: the outlet number, the (Pd) data type to output, and the output value itself. (In general, it&#39;s possible to have multiple values there, e.g., when outputting a list value. Therefore the output value is always specified as a Lua table, hence the curly braces around the float output value.)</span></p><p><span>Throwing everything together, our Lua external now looks as follows:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51982px; left: 7.99336px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">local</span> <span class="cm-variable">foo</span> = <span class="cm-variable">pd.Class</span>:<span class="cm-variable">new</span>():<span class="cm-variable">register</span>(<span class="cm-string">"foo"</span>)</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
+<div id='write'  class=''><h1 id='a-quick-introduction-to-pd-lua'><span>A Quick Introduction to Pd-Lua</span></h1><p><span>Albert Gräf </span><span>&lt;</span><a href='mailto:aggraef@gmail.com' target='_blank' class='url'>aggraef@gmail.com</a><span>&gt;</span><span></span><br/><span>Computer Music Dept., Institute of Art History and Musicology</span><br/><span>Johannes Gutenberg University (JGU) Mainz, Germany</span><br/><span>September 2024</span></p><p><span>This document is licensed under </span><a href='https://creativecommons.org/licenses/by-sa/4.0/'><span>CC BY-SA 4.0</span></a><span>. Other formats: </span><a href='https://github.com/agraef/pd-lua/blob/master/tutorial/pd-lua-intro.md'><span>Markdown</span></a><span> source, </span><a href='https://agraef.github.io/pd-lua/tutorial/pd-lua-intro.pdf'><span>PDF</span></a><span></span><br/><span>Permanent link: </span><a href='https://agraef.github.io/pd-lua/tutorial/pd-lua-intro.html' target='_blank' class='url'>https://agraef.github.io/pd-lua/tutorial/pd-lua-intro.html</a></p><h2 id='why-pd-lua'><span>Why Pd-Lua?</span></h2><p><span>Pd&#39;s facilities for data structures, iteration, and recursion are somewhat limited, thus sooner or later you&#39;ll probably run into a problem that can&#39;t be easily solved by a Pd abstraction any more. At this point you&#39;ll have to consider writing an external object (or just </span><em><span>external</span></em><span>, for short) in a &quot;real&quot; programming language instead. Pd externals are usually programmed using C, the same programming language that Pd itself is written in. But novices may find C difficult to learn, and the arcana of Pd&#39;s C interface may also be hard to master.</span></p><p><span>Enter Pd-Lua, the Pd programmer&#39;s secret weapon, which lets you develop your externals in the </span><a href='https://www.lua.org/'><span>Lua</span></a><span> scripting language. Pd-Lua was originally written by Claude Heiland-Allen and has since been maintained by a number of other people in the Pd community. Lua, from </span><a href='http://www.puc-rio.br/'><span>PUC Rio</span></a><span>, is open-source (under the MIT license), mature, very popular, and supported by a large developer community. It is a small programming language, but very capable, and is generally considered to be relatively easy to learn. For programming Pd externals, you&#39;ll also need to learn a few bits and pieces which let you interface your Lua functions to Pd, as explained in this tutorial, but programming externals in Lua is still quite easy and a lot of fun. Using Pd-Lua, you can program your own externals ranging from little helper objects to full-blown synthesizers, sequencers, and algorithmic composition tools. It gives you access to Pd arrays and tables, as well as a number of other useful facilities such as clocks and receivers, which we&#39;ll explain in some detail. Pd-Lua also ships with a large collection of instructive examples which you&#39;ll find helpful when exploring its possibilities.</span></p><p><span>Pd-Lua was originally designed for control processing, so we used to recommend </span><a href='https://faust.grame.fr/'><span>Faust</span></a><span> for doing dsp instead. We still do, but Faust isn&#39;t for everyone; being a purely functional language, Faust follows a paradigm which most programmers aren&#39;t very familiar with. Fortunately, thanks to the work of Timothy Schoen, the most recent Pd-Lua versions now also provide support for signal processing and even graphics. So it is now possible to create pretty much any kind of Pd object in Lua, including dsp objects. (However, Faust will almost certainly execute dsp code much more efficiently than Pd-Lua, as it generates highly optimized native code for just this purpose.)</span></p><p><span>Note that we can&#39;t possibly cover Pd or the Lua language themselves here, so you&#39;ll have to refer to other online resources to learn about those. In particular, check out the Lua website, which has extensive </span><a href='https://www.lua.org/docs.html'><span>documentation</span></a><span> available, and maybe have a look at Derek Banas&#39; </span><a href='https://www.youtube.com/watch?v=iMacxZQMPXs'><span>video tutorial</span></a><span> for a quick overview of Lua. For Pd, we recommend the Pd FLOSS Manual at </span><a href='https://flossmanuals.net/' target='_blank' class='url'>https://flossmanuals.net/</a><span> to get started.</span></p><h2 id='installation'><span>Installation</span></h2><p><span>Pd-Lua works inside any reasonably modern Pd flavor. This encompasses vanilla </span><a href='http://msp.ucsd.edu/software.html'><span>Pd</span></a><span>, of course, but also </span><a href='https://agraef.github.io/purr-data/'><span>Purr Data</span></a><span> which includes an up-to-date version of Pd-Lua for Lua 5.4 and has it enabled by default, so you should be ready to go immediately; no need to install anything else. The same is true for </span><a href='https://plugdata.org/'><span>plugdata</span></a><span> (version 0.6.3 or later), a Pd flavor which can also run as a plug-in inside a DAW.</span></p><p><span>With vanilla Pd, you can install the pdlua package from Deken. There&#39;s also an official </span><a href='https://salsa.debian.org/multimedia-team/pd/pd-lua'><span>Debian</span></a><span> package, maintained by IOhannes Zmölnig. You can also compile Pd-Lua from source, using the author&#39;s </span><a href='https://github.com/agraef/pd-lua'><span>Github repository</span></a><span>. Compilation instructions are in the README, and you&#39;ll also find some Mac and Windows binaries there. In either case, after installing Pd-Lua you also have to add </span><code>pdlua</code><span> to Pd&#39;s startup libraries.</span></p><p><span>If all is well, you should see a message like the following in the Pd console (note that for vanilla Pd you&#39;ll have to switch the log level to 2 or more to see that message):</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang=""><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang=""><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51801px; left: 7.98611px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation"><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;">pdlua 0.12.4 (GPL) 2008 Claude Heiland-Allen, 2014 Martin Peach et al.</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;">pdlua: compiled for pd-0.55 on Aug 24 2024 00:51:01</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;">Using lua version 5.4</span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 69px;"></div><div class="CodeMirror-gutters" style="display: none; height: 69px;"></div></div></div></pre><p><span>This will also tell you the Lua version that Pd-Lua is using, so that you can install a matching version of the stand-alone Lua interpreter if needed. Lua should be readily available from your package repositories on Linux, and for Mac and Windows you can find binaries on the Lua website. In the following we generally assume that you&#39;re using Lua 5.3 or later (using Lua versions older than 5.3 is not recommended).</span></p><p><span>If all is not well and you do </span><em><span>not</span></em><span> see that message, then most likely Pd-Lua refused to load because the Lua library is missing. This shouldn&#39;t happen if you installed Pd-Lua from a binary package, but if it does then you may have to manually install the right version of the Lua library to make Pd-Lua work. Make sure that you install the package with the Lua </span><em><span>library</span></em><span> in it; on Debian, Ubuntu and their derivatives this will be something like liblua5.4-0.</span></p><h2 id='a-basic-example'><span>A basic example</span></h2><p><span>With that out of the way, let&#39;s have a look at the most essential parts of a Lua external. To make an external, say </span><code>foo</code><span>, loadable by Pd-Lua, you need to put it into a Lua script, which is simply a text file with the right name (which must be the same as the object name, </span><code>foo</code><span> in this case) and extension (which needs to be </span><code>.pd_lua</code><span>), so the file name will be </span><code>foo.pd_lua</code><span> in this example.</span></p><p><span>Any implementation of an object must always include:</span></p><ul><li><p><span>a call to the </span><code>pd.Class:new():register</code><span> method which registers the object class with Pd (this should always be the first line of the script, other than comments)</span></p></li><li><p><span>a definition of the </span><code>initialize</code><span> method for your object class</span></p></li></ul><p><span>Here is a prototypical example (this is the contents of the foo.pd_lua file):</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51801px; left: 7.98611px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">local</span> <span class="cm-variable">foo</span> = <span class="cm-variable">pd.Class</span>:<span class="cm-variable">new</span>():<span class="cm-variable">register</span>(<span class="cm-string">"foo"</span>)</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
+</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">foo</span>:<span class="cm-variable">initialize</span>(<span class="cm-variable">sel</span>, <span class="cm-variable">atoms</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">return</span> <span class="cm-keyword">true</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 115px;"></div><div class="CodeMirror-gutters" style="display: none; height: 115px;"></div></div></div></pre><p><span>Note that in the first line we called </span><code>pd.Class:new():register</code><span> with the name of the object class as a string, which </span><em><span>must</span></em><span> be the same as the basename of the script, otherwise Pd&#39;s loader will get very confused, create the wrong object class, print a (rather cryptic) error message, and won&#39;t be able to create the object.</span></p><p><span>We also assigned the created class (which is represented as a Lua table) to a variable </span><code>foo</code><span> (which we made local to the script file here, as explained below). We need that variable as a qualifier for the methods of the object class, including </span><code>initialize</code><span>. You can actually name that variable whatever you want, as long as you use that name consistently throughout the script. This can be useful at times, if the actual class name you chose, as it is known to Pd and set with </span><code>pd.Class:new():register</code><span> (as well as being the basename of your .pd_lua script), is a jumble of special characters such as </span><code>fo:o#?!</code><span>, which isn&#39;t a valid Lua identifier.</span></p><p><span>Next comes the </span><code>initialize</code><span> method, which is implemented as a Lua function, prefixing the method name with the name of the class variable we created above and a colon, i.e., </span><code>foo:initialize</code><span>. (This </span><em><span>colon syntax</span></em><span> is used for all functions that represent </span><em><span>methods</span></em><span>, which receive the called object as an implicit </span><code>self</code><span> parameter; please check the section on function definitions in the Lua manual for details.) As a bare minimum, as is shown here, this method </span><em><span>must</span></em><span> return </span><code>true</code><span>, otherwise the loader will assume that the object creation has failed, and will complain that it couldn&#39;t create the object with an error message.</span></p><p><span>We mention in passing here that Pd-Lua also provides a parameter-less </span><code>postinitialize</code><span> method which can be used to execute code after the object has been created, but before the object starts processing messages. We&#39;ll see an example of this method later.</span></p><hr /><p><strong><span>NOTE:</span></strong><span> Pd-Lua runs </span><em><span>all</span></em><span> Lua objects in the same instance of the Lua interpreter. Therefore, as a general guideline, we want to keep the global name space tidy and clean. That&#39;s why we made </span><code>foo</code><span> a local variable, which means that its scope is confined to this single script. Note that this isn&#39;t needed for the member variables and methods, as these are securely stowed away inside the object and not accessible from the outside anyway, if the class variable is </span><code>local</code><span>. But the same caveat applies to all variables and functions in the script file that might be needed to implement the object, so normally you want to mark these as </span><code>local</code><span>, too (or turn them into member variables and methods, if that seems more appropriate).</span></p><p><span>We mention in passing that global variables and functions may also have their uses if you need to share a certain amount of global state between different Lua objects. But even then it&#39;s usually safer to have the objects communicate with each other behind the scenes using receivers, which we&#39;ll explain later.</span></p><hr /><p><span>To actually use the object class we just created, Pd needs be able to find our foo.pd_lua file. We&#39;ll discuss different approaches in the following section, but the easiest way to achieve this is to just drop foo.pd_lua into the directory that your patch is in (say, </span><code>pd-lua</code><span> in your home directory). Now we can just create our first </span><code>foo</code><span> object (hit Ctrl+1, then type the object name </span><code>foo</code><span>), and we should see something like this:</span></p><p><img src="01-first-light.png" referrerpolicy="no-referrer" alt="First light"></p><p><span>Hooray, it works! :)) Well, this object doesn&#39;t do anything right now, so let&#39;s equip it with a single inlet/outlet pair. This is what the </span><code>initialize</code><span> method is for, so we have to edit that method accordingly.</span></p><p><span>NB: If you closed the editor already and don&#39;t remember where the file is, you can just right-click the object and choose </span><code>Open</code><span>, which will open the .pd_lua file in your favorite text editor, as configured in your desktop and/or shell environment.</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51801px; left: 7.98611px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">local</span> <span class="cm-variable">foo</span> = <span class="cm-variable">pd.Class</span>:<span class="cm-variable">new</span>():<span class="cm-variable">register</span>(<span class="cm-string">"foo"</span>)</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
+</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">foo</span>:<span class="cm-variable">initialize</span>(<span class="cm-variable">sel</span>, <span class="cm-variable">atoms</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.inlets</span> = <span class="cm-number">1</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.outlets</span> = <span class="cm-number">1</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">return</span> <span class="cm-keyword">true</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 161px;"></div><div class="CodeMirror-gutters" style="display: none; height: 161px;"></div></div></div></pre><p><span>Note that, as we already mentioned, the </span><code>self</code><span> variable here is an implicit parameter of any Lua method, which refers to the object itself. Every Pd-Lua object has two member variables </span><code>inlets</code><span> and </span><code>outlets</code><span> which let us specify the number of inlets and outlets our object should have. This needs to be done when the object is initialized; afterwards, the number of inlets and outlets is set in stone and can&#39;t be changed any more.</span></p><p><span>Next, we have to make sure that Pd picks up our edited class definition. Since the Pd-Lua loader will never reload the .pd_lua file for any given object class during a Pd session, we will have to save the patch, quit Pd, relaunch it and reopen the patch:</span></p><p><img src="02-inoutlets.png" referrerpolicy="no-referrer" alt="Inlet and outlet"></p><p><span>So there, we got our single inlet/outlet pair now. To do anything with these, we finally have to add some </span><em><span>message handlers</span></em><span> to our object. Say, for instance, we want to handle a bang message by incrementing a counter and outputting its current value to the outlet. We first have to initialize the counter value in the </span><code>initialize</code><span> method. As we want each </span><code>foo</code><span> object to have its own local counter value, we create the counter as a member variable:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51801px; left: 7.98611px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">foo</span>:<span class="cm-variable">initialize</span>(<span class="cm-variable">sel</span>, <span class="cm-variable">atoms</span>)</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.inlets</span> = <span class="cm-number">1</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.outlets</span> = <span class="cm-number">1</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.counter</span> = <span class="cm-number">0</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">return</span> <span class="cm-keyword">true</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 138px;"></div><div class="CodeMirror-gutters" style="display: none; height: 138px;"></div></div></div></pre><p><span>It&#39;s not necessary to declare the </span><code>self.counter</code><span> variable in any way, just give it an initial value and be done with it. Finally, we have to add a method for the bang message, which looks as follows:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51801px; left: 7.98611px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation"><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">foo</span>:<span class="cm-variable">in_1_bang</span>()</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.counter</span> = <span class="cm-variable">self.counter</span> + <span class="cm-number">1</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self</span>:<span class="cm-variable">outlet</span>(<span class="cm-number">1</span>, <span class="cm-string">"float"</span>, {<span class="cm-variable">self.counter</span>})</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 92px;"></div><div class="CodeMirror-gutters" style="display: none; height: 92px;"></div></div></div></pre><p><span>We&#39;ll dive into the naming conventions for message handlers later, but note that </span><code>in_1</code><span> specifies the first (and only) inlet and </span><code>bang</code><span> the kind of message we expect. In the body of the method we increment the </span><code>self.counter</code><span> value and output its new value on the first (and only) outlet. This is done by the predefined </span><code>self:outlet</code><span> method which takes three arguments: the outlet number, the (Pd) data type to output, and the output value itself. (In general, it&#39;s possible to have multiple values there, e.g., when outputting a list value. Therefore the output value is always specified as a Lua table, hence the curly braces around the float output value.)</span></p><p><span>Throwing everything together, our Lua external now looks as follows:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51801px; left: 7.98611px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">local</span> <span class="cm-variable">foo</span> = <span class="cm-variable">pd.Class</span>:<span class="cm-variable">new</span>():<span class="cm-variable">register</span>(<span class="cm-string">"foo"</span>)</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
 </span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">foo</span>:<span class="cm-variable">initialize</span>(<span class="cm-variable">sel</span>, <span class="cm-variable">atoms</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.inlets</span> = <span class="cm-number">1</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.outlets</span> = <span class="cm-number">1</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.counter</span> = <span class="cm-number">0</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">return</span> <span class="cm-keyword">true</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
-</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">foo</span>:<span class="cm-variable">in_1_bang</span>()</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.counter</span> = <span class="cm-variable">self.counter</span> + <span class="cm-number">1</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self</span>:<span class="cm-variable">outlet</span>(<span class="cm-number">1</span>, <span class="cm-string">"float"</span>, {<span class="cm-variable">self.counter</span>})</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 300px;"></div><div class="CodeMirror-gutters" style="display: none; height: 300px;"></div></div></div></pre><p><span>So let&#39;s relaunch Pd, reload the patch again, and add some GUI elements to test it out:</span></p><p><img src="03-basic-example.png" referrerpolicy="no-referrer" alt="Basic example"></p><p><span>Note that this is still a very basic example. While the example is complete and fully functional, we have barely scratched the surface here. Pd-Lua also allows you to process an object&#39;s creation arguments (employing the </span><code>atoms</code><span> parameter of the </span><code>initialize</code><span> method, which we didn&#39;t use above), log messages and errors in the Pd console, create handlers for different types of input messages and signals, output data and signals to different outlets, work with Pd arrays, clocks, and receivers, and even do some graphics and live coding. We will dive into each of these topics in the rest of this tutorial.</span></p><h2 id='objects-and-shortcuts'><span>Objects and Shortcuts</span></h2><p><span>You may have wondered about the whole </span><code>pd.Class:new():register(&quot;foo&quot;)</code><span> thing, why is that so complicated? The answer is that Lua uses </span><em><span>prototypes</span></em><span> (class-less objects) to define object-oriented data structures and their methods. Consequently, Pd-Lua defines a few of these to represent various kinds of Pd objects on the Lua side. There&#39;s </span><code>pd.Class</code><span> which represents Pd object classes, </span><code>pd.Table</code><span> which is used to access Pd arrays and tables, and </span><code>pd.Clock</code><span>, </span><code>pd.Receive</code><span> for Pd&#39;s clock and receiver objects.</span></p><p><span>Each kind of object needs a way to create an instance of the object, that&#39;s what the </span><code>new()</code><span> method is for, and a second method (usually called </span><code>register</code><span>, but Pd arrays use </span><code>sync</code><span> instead) which associates the Lua object with its counterpart in Pd. The </span><code>register()</code><span> method also creates the corresponding data structure in Pd in most cases.</span></p><p><span>So that&#39;s why we first invoke </span><code>new()</code><span> and then </span><code>register()</code><span> on the prototype (</span><code>pd.Class</code><span>, etc.); it&#39;s always this two-step process. However, since version 0.12.14, Pd-Lua also provides some convenient </span><em><span>shortcuts</span></em><span>. In the case of </span><code>pd.Class:new():register()</code><span>, the shortcut is simply </span><code>pd.class()</code><span>. (Note that </span><code>class</code><span> is written in all lower-case, while the prototype </span><code>pd.Class</code><span> has </span><code>Class</code><span> capitalized -- this may be hard to see in the font we&#39;ve chosen for this document.)</span></p><p><span>Thus, we can abbreviate the definition of the </span><code>foo</code><span> object class in our first example as:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51982px; left: 7.99336px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation"><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">local</span> <span class="cm-variable">foo</span> = <span class="cm-variable">pd.class</span>(<span class="cm-string">"foo"</span>)</span></pre></div></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 23px;"></div><div class="CodeMirror-gutters" style="display: none; height: 23px;"></div></div></div></pre><p><span>Much shorter, and easy to remember. Shortcuts for the other kinds of objects will be introduced along with the long forms in the corresponding sections below. Feel free to use them. But note that in the tutorial and the accompanying examples we generally keep to the long forms, so that our examples will work unchanged with older Pd-Lua versions.</span></p><h2 id='where-your-lua-files-go'><span>Where your Lua files go</span></h2><p><span>As already mentioned, the externals (.pd_lua files) themselves can go either into the directory of the patch using the external, or into any other directory on Pd&#39;s search path (on Linux, this generally includes, ~/.pd-externals, or  ~/.pd-l2ork-externals when running pd-l2ork or purr-data).</span></p><p><span>The Lua loader temporarily sets up Lua&#39;s </span><code>package.path</code><span> so that it includes the directory with the external, so you can put any Lua modules (.lua files) required by the external into that directory.</span></p><hr /><p><strong><span>NOTE:</span></strong><span> As of Pd-Lua 0.12.5, the same is true for the pdlua external directory, where you can put any Lua modules that should be readily available to all your Pd-Lua objects. One example of this is Pd-Lua&#39;s own </span><a href='#pdxlua'><span>pdx.lua</span></a><span> live-coding module which we&#39;ll discuss later, but it can also be used for general Lua utility modules that you want to use. There are a lot of incredibly useful Lua libraries out there, such as </span><a href='https://github.com/kikito/inspect.lua'><span>kikito &#39;s inspect</span></a><span> or </span><a href='https://github.com/lunarmodules/Penlight'><span>lunarmodules&#39; penlight</span></a><span>, although you might prefer to install these using </span><a href='https://luarocks.org/'><span>LuaRocks</span></a><span>, Lua&#39;s most popular package manager.</span></p><hr /><p><span>If you need/want to use Lua libraries from other locations which aren&#39;t on the standard Lua </span><code>package.path</code><span>, then you&#39;ll have to set up the </span><code>LUA_PATH</code><span> environment variable accordingly. LuaRocks usually takes care of this for you when set up properly. Otherwise you can set </span><code>LUA_PATH</code><span> manually in your system startup files, such as ~/.bashrc or ~/.xprofile on Linux. E.g.:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="shell"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="shell"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51982px; left: 7.99336px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation"><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">export</span> <span class="cm-def">LUA_PATH</span><span class="cm-operator">=</span>~/lua/<span class="cm-string">'?.lua;;'</span></span></pre></div></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 23px;"></div><div class="CodeMirror-gutters" style="display: none; height: 23px;"></div></div></div></pre><p><span>Note that </span><code>?</code><span> is a placeholder for the module name, the semicolon </span><code>;</code><span> can be used to separate different locations, and a double semicolon </span><code>;;</code><span> adds Lua&#39;s standard search path (make sure that you quote those special characters so that the shell doesn&#39;t try to interpret them). You should </span><em><span>always</span></em><span> include the double semicolon somewhere, otherwise the Lua interpreter won&#39;t be able to find its standard library modules any more. Also note that you may want to place the </span><code>;;</code><span> in front of the path instead, if the standard locations are to be searched before your custom ones.</span></p><h2 id='creation-arguments'><span>Creation arguments</span></h2><p><span>Besides the implicit </span><code>self</code><span> argument, the </span><code>initialize</code><span> method has two additional parameters:</span></p><ul><li><p><code>sel</code><span>, the selector argument, is a string which contains the Pd name of the object class. You probably won&#39;t need this, unless you want to use it for error reporting, or if you have a generic setup function for several related object classes. We won&#39;t go into this here.</span></p></li><li><p><code>atoms</code><span> is a Lua table which contains all the arguments (Pd &quot;atoms&quot;, i.e., numbers or strings) an object was created with. </span><code>#atoms</code><span> gives you the number of creation arguments (which may be zero if none were specified), </span><code>atoms[1]</code><span> is the first argument, </span><code>atoms[2]</code><span> the second, and so on. As usual in Lua, if the index </span><code>i</code><span> runs past the last argument, </span><code>atoms[i]</code><span> returns </span><code>nil</code><span>.</span></p></li></ul><p><span>For instance, let&#39;s say that we want to equip our </span><code>foo</code><span> object with an optional creation argument, a number, to set the initial counter value. This can be done as follows:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51982px; left: 7.99336px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">foo</span>:<span class="cm-variable">initialize</span>(<span class="cm-variable">sel</span>, <span class="cm-variable">atoms</span>)</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.inlets</span> = <span class="cm-number">1</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.outlets</span> = <span class="cm-number">1</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">if</span> <span class="cm-builtin">type</span>(<span class="cm-variable">atoms</span>[<span class="cm-number">1</span>]) == <span class="cm-string">"number"</span> <span class="cm-keyword">then</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">self.counter</span> = <span class="cm-variable">atoms</span>[<span class="cm-number">1</span>]</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">else</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">self.counter</span> = <span class="cm-number">0</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">return</span> <span class="cm-keyword">true</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 230px;"></div><div class="CodeMirror-gutters" style="display: none; height: 230px;"></div></div></div></pre><p><span>Here we check that the first creation argument is a number. In that case we use it to initialize the </span><code>counter</code><span> member variable, otherwise a default value of 0 is set. Note that if there is no creation argument, </span><code>atoms[1]</code><span> will be </span><code>nil</code><span> which is of type </span><code>&quot;nil&quot;</code><span>, in which case the zero default value will be used.</span></p><p><span>Note that currently our </span><code>bang</code><span> handler outputs the value </span><em><span>after</span></em><span> incrementing it, which seems a bit awkward now that we can actually specify the counter&#39;s start value. Let&#39;s rework that method so that it spits out the </span><em><span>current</span></em><span> value before incrementing it:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51982px; left: 7.99336px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation"><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">foo</span>:<span class="cm-variable">in_1_bang</span>()</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self</span>:<span class="cm-variable">outlet</span>(<span class="cm-number">1</span>, <span class="cm-string">"float"</span>, {<span class="cm-variable">self.counter</span>})</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.counter</span> = <span class="cm-variable">self.counter</span> + <span class="cm-number">1</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 92px;"></div><div class="CodeMirror-gutters" style="display: none; height: 92px;"></div></div></div></pre><p><span>Note that it&#39;s perfectly fine to invoke </span><code>self:outlet</code><span> at any point in the method.</span></p><p><span>While we&#39;re at it, we might as well add an optional second creation argument to specify the step value of the counter. Try doing that on your own, before peeking at the solution below!</span></p><p><span>Got it? Good. Here is our final script:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua" style="break-inside: unset;"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51982px; left: 7.99336px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">local</span> <span class="cm-variable">foo</span> = <span class="cm-variable">pd.Class</span>:<span class="cm-variable">new</span>():<span class="cm-variable">register</span>(<span class="cm-string">"foo"</span>)</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
+</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">foo</span>:<span class="cm-variable">in_1_bang</span>()</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.counter</span> = <span class="cm-variable">self.counter</span> + <span class="cm-number">1</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self</span>:<span class="cm-variable">outlet</span>(<span class="cm-number">1</span>, <span class="cm-string">"float"</span>, {<span class="cm-variable">self.counter</span>})</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 299px;"></div><div class="CodeMirror-gutters" style="display: none; height: 299px;"></div></div></div></pre><p><span>So let&#39;s relaunch Pd, reload the patch again, and add some GUI elements to test it out:</span></p><p><img src="03-basic-example.png" referrerpolicy="no-referrer" alt="Basic example"></p><p><span>Note that this is still a very basic example. While the example is complete and fully functional, we have barely scratched the surface here. Pd-Lua also allows you to process an object&#39;s creation arguments (employing the </span><code>atoms</code><span> parameter of the </span><code>initialize</code><span> method, which we didn&#39;t use above), log messages and errors in the Pd console, create handlers for different types of input messages and signals, output data and signals to different outlets, work with Pd arrays, clocks, and receivers, and even do some graphics and live coding. We will dive into each of these topics in the rest of this tutorial.</span></p><h2 id='objects-and-shortcuts'><span>Objects and Shortcuts</span></h2><p><span>You may have wondered about the whole </span><code>pd.Class:new():register(&quot;foo&quot;)</code><span> thing, why is that so complicated? The answer is that Lua uses </span><em><span>prototypes</span></em><span> (class-less objects) to define object-oriented data structures and their methods. Consequently, Pd-Lua defines a few of these to represent various kinds of Pd objects on the Lua side. There&#39;s </span><code>pd.Class</code><span> which represents Pd object classes, </span><code>pd.Table</code><span> which is used to access Pd arrays and tables, and </span><code>pd.Clock</code><span>, </span><code>pd.Receive</code><span> for Pd&#39;s clock and receiver objects.</span></p><p><span>Each kind of object needs a way to create an instance of the object, that&#39;s what the </span><code>new()</code><span> method is for, and a second method (usually called </span><code>register</code><span>, but Pd arrays use </span><code>sync</code><span> instead) which associates the Lua object with its counterpart in Pd. The </span><code>register()</code><span> method also creates the corresponding data structure in Pd in most cases.</span></p><p><span>So that&#39;s why we first invoke </span><code>new()</code><span> and then </span><code>register()</code><span> on the prototype (</span><code>pd.Class</code><span>, etc.); it&#39;s always this two-step process. However, since version 0.12.14, Pd-Lua also provides some convenient </span><em><span>shortcuts</span></em><span>. In the case of </span><code>pd.Class:new():register()</code><span>, the shortcut is simply </span><code>pd.class()</code><span>. (Note that </span><code>class</code><span> is written in all lower-case, while the prototype </span><code>pd.Class</code><span> has </span><code>Class</code><span> capitalized -- this may be hard to see in the font we&#39;ve chosen for this document.)</span></p><p><span>Thus, we can abbreviate the definition of the </span><code>foo</code><span> object class in our first example as:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51801px; left: 7.98611px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation"><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">local</span> <span class="cm-variable">foo</span> = <span class="cm-variable">pd.class</span>(<span class="cm-string">"foo"</span>)</span></pre></div></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 23px;"></div><div class="CodeMirror-gutters" style="display: none; height: 23px;"></div></div></div></pre><p><span>Much shorter, and easy to remember. Shortcuts for the other kinds of objects will be introduced along with the long forms in the corresponding sections below. Feel free to use them. But note that in the tutorial and the accompanying examples we generally keep to the long forms, so that our examples will work unchanged with older Pd-Lua versions.</span></p><h2 id='where-your-lua-files-go'><span>Where your Lua files go</span></h2><p><span>As already mentioned, the externals (.pd_lua files) themselves can go either into the directory of the patch using the external, or into any other directory on Pd&#39;s search path (on Linux, this generally includes, ~/.pd-externals, or  ~/.pd-l2ork-externals when running pd-l2ork or purr-data).</span></p><p><span>The Lua loader temporarily sets up Lua&#39;s </span><code>package.path</code><span> so that it includes the directory with the external, so you can put any Lua modules (.lua files) required by the external into that directory.</span></p><hr /><p><strong><span>NOTE:</span></strong><span> As of Pd-Lua 0.12.5, the same is true for the pdlua external directory, where you can put any Lua modules that should be readily available to all your Pd-Lua objects. One example of this is Pd-Lua&#39;s own </span><a href='#pdxlua'><span>pdx.lua</span></a><span> live-coding module which we&#39;ll discuss later, but it can also be used for general Lua utility modules that you want to use. There are a lot of incredibly useful Lua libraries out there, such as </span><a href='https://github.com/kikito/inspect.lua'><span>kikito &#39;s inspect</span></a><span> or </span><a href='https://github.com/lunarmodules/Penlight'><span>lunarmodules&#39; penlight</span></a><span>, although you might prefer to install these using </span><a href='https://luarocks.org/'><span>LuaRocks</span></a><span>, Lua&#39;s most popular package manager.</span></p><hr /><p><span>If you need/want to use Lua libraries from other locations which aren&#39;t on the standard Lua </span><code>package.path</code><span>, then you&#39;ll have to set up the </span><code>LUA_PATH</code><span> environment variable accordingly. LuaRocks usually takes care of this for you when set up properly. Otherwise you can set </span><code>LUA_PATH</code><span> manually in your system startup files, such as ~/.bashrc or ~/.xprofile on Linux. E.g.:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="shell"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="shell"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51801px; left: 7.98611px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation"><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">export</span> <span class="cm-def">LUA_PATH</span><span class="cm-operator">=</span>~/lua/<span class="cm-string">'?.lua;;'</span></span></pre></div></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 23px;"></div><div class="CodeMirror-gutters" style="display: none; height: 23px;"></div></div></div></pre><p><span>Note that </span><code>?</code><span> is a placeholder for the module name, the semicolon </span><code>;</code><span> can be used to separate different locations, and a double semicolon </span><code>;;</code><span> adds Lua&#39;s standard search path (make sure that you quote those special characters so that the shell doesn&#39;t try to interpret them). You should </span><em><span>always</span></em><span> include the double semicolon somewhere, otherwise the Lua interpreter won&#39;t be able to find its standard library modules any more. Also note that you may want to place the </span><code>;;</code><span> in front of the path instead, if the standard locations are to be searched before your custom ones.</span></p><h2 id='creation-arguments'><span>Creation arguments</span></h2><p><span>Besides the implicit </span><code>self</code><span> argument, the </span><code>initialize</code><span> method has two additional parameters:</span></p><ul><li><p><code>sel</code><span>, the selector argument, is a string which contains the Pd name of the object class. You probably won&#39;t need this, unless you want to use it for error reporting, or if you have a generic setup function for several related object classes. We won&#39;t go into this here.</span></p></li><li><p><code>atoms</code><span> is a Lua table which contains all the arguments (Pd &quot;atoms&quot;, i.e., numbers or strings) an object was created with. </span><code>#atoms</code><span> gives you the number of creation arguments (which may be zero if none were specified), </span><code>atoms[1]</code><span> is the first argument, </span><code>atoms[2]</code><span> the second, and so on. As usual in Lua, if the index </span><code>i</code><span> runs past the last argument, </span><code>atoms[i]</code><span> returns </span><code>nil</code><span>.</span></p></li></ul><p><span>For instance, let&#39;s say that we want to equip our </span><code>foo</code><span> object with an optional creation argument, a number, to set the initial counter value. This can be done as follows:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51801px; left: 7.98611px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">foo</span>:<span class="cm-variable">initialize</span>(<span class="cm-variable">sel</span>, <span class="cm-variable">atoms</span>)</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.inlets</span> = <span class="cm-number">1</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.outlets</span> = <span class="cm-number">1</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">if</span> <span class="cm-builtin">type</span>(<span class="cm-variable">atoms</span>[<span class="cm-number">1</span>]) == <span class="cm-string">"number"</span> <span class="cm-keyword">then</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">self.counter</span> = <span class="cm-variable">atoms</span>[<span class="cm-number">1</span>]</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">else</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">self.counter</span> = <span class="cm-number">0</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">return</span> <span class="cm-keyword">true</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 230px;"></div><div class="CodeMirror-gutters" style="display: none; height: 230px;"></div></div></div></pre><p><span>Here we check that the first creation argument is a number. In that case we use it to initialize the </span><code>counter</code><span> member variable, otherwise a default value of 0 is set. Note that if there is no creation argument, </span><code>atoms[1]</code><span> will be </span><code>nil</code><span> which is of type </span><code>&quot;nil&quot;</code><span>, in which case the zero default value will be used.</span></p><p><span>Note that currently our </span><code>bang</code><span> handler outputs the value </span><em><span>after</span></em><span> incrementing it, which seems a bit awkward now that we can actually specify the counter&#39;s start value. Let&#39;s rework that method so that it spits out the </span><em><span>current</span></em><span> value before incrementing it:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51801px; left: 7.98611px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation"><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">foo</span>:<span class="cm-variable">in_1_bang</span>()</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self</span>:<span class="cm-variable">outlet</span>(<span class="cm-number">1</span>, <span class="cm-string">"float"</span>, {<span class="cm-variable">self.counter</span>})</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.counter</span> = <span class="cm-variable">self.counter</span> + <span class="cm-number">1</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 92px;"></div><div class="CodeMirror-gutters" style="display: none; height: 92px;"></div></div></div></pre><p><span>Note that it&#39;s perfectly fine to invoke </span><code>self:outlet</code><span> at any point in the method.</span></p><p><span>While we&#39;re at it, we might as well add an optional second creation argument to specify the step value of the counter. Try doing that on your own, before peeking at the solution below!</span></p><p><span>Got it? Good. Here is our final script:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua" style="break-inside: unset;"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51801px; left: 7.98611px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">local</span> <span class="cm-variable">foo</span> = <span class="cm-variable">pd.Class</span>:<span class="cm-variable">new</span>():<span class="cm-variable">register</span>(<span class="cm-string">"foo"</span>)</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
 </span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">foo</span>:<span class="cm-variable">initialize</span>(<span class="cm-variable">sel</span>, <span class="cm-variable">atoms</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.inlets</span> = <span class="cm-number">1</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.outlets</span> = <span class="cm-number">1</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">if</span> <span class="cm-builtin">type</span>(<span class="cm-variable">atoms</span>[<span class="cm-number">1</span>]) == <span class="cm-string">"number"</span> <span class="cm-keyword">then</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">self.counter</span> = <span class="cm-variable">atoms</span>[<span class="cm-number">1</span>]</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">else</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">self.counter</span> = <span class="cm-number">0</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">if</span> <span class="cm-builtin">type</span>(<span class="cm-variable">atoms</span>[<span class="cm-number">2</span>]) == <span class="cm-string">"number"</span> <span class="cm-keyword">then</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">self.step</span> = <span class="cm-variable">atoms</span>[<span class="cm-number">2</span>]</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">else</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">self.step</span> = <span class="cm-number">1</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">return</span> <span class="cm-keyword">true</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
-</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">foo</span>:<span class="cm-variable">in_1_bang</span>()</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self</span>:<span class="cm-variable">outlet</span>(<span class="cm-number">1</span>, <span class="cm-string">"float"</span>, {<span class="cm-variable">self.counter</span>})</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.counter</span> = <span class="cm-variable">self.counter</span> + <span class="cm-variable">self.step</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 507px;"></div><div class="CodeMirror-gutters" style="display: none; height: 507px;"></div></div></div></pre><p><span>That was easy enough. If you&#39;ve been following along, you also know by now how to reload the patch and add a few bits to test the new features. For instance: </span></p><p><img src="04-creation-args.png" referrerpolicy="no-referrer" alt="Creating arguments"></p><h2 id='log-messages-and-errors'><span>Log messages and errors</span></h2><p><span>As soon as your objects get more complicated, you&#39;ll probably want to add some messages indicating to the user (or yourself) what&#39;s going on inside the object&#39;s methods. To these ends, Pd-Lua provides the following two facilities which let you output text messages to the Pd console:</span></p><ul><li><p><code>pd.post(msg)</code><span> outputs the string </span><code>msg</code><span> to the console on a separate line. You can also post multi-line messages by embedding newline (</span><code>\n</code><span>) characters in the </span><code>msg</code><span> string. This is also frequently used for debugging purposes, e.g., to print out incoming messages or intermediate values that your code calculates.</span></p></li><li><p><code>self:error(msg)</code><span> reports an error message, given as a string </span><code>msg</code><span>, to the console. These messages are printed in red, to make them stand out, and you can use the &quot;Find Last Error&quot; menu option to locate the object which reported the error. (In Purr Data it&#39;s also possible to just click on the &quot;error&quot; link in the console to locate the object.) Note that </span><code>self:error</code><span> simply prints the message in a way that ties in with &quot;Find Last Error&quot;. It doesn&#39;t abort the method that executes it, or have any other grave consequences. Thus you can also use it for debugging purposes, like </span><code>pd.post</code><span>, if you need to trace the message back to the object it came from.</span></p></li></ul><p><span>For instance, let&#39;s use these facilities to have our </span><code>foo</code><span> object post the initial counter value in the </span><code>initialize</code><span> method, as well as report an error if any of the given creation arguments is of the wrong type. Here is the suitably modified </span><code>initialize</code><span> method:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua" style="break-inside: unset;"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51982px; left: 7.99336px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">foo</span>:<span class="cm-variable">initialize</span>(<span class="cm-variable">sel</span>, <span class="cm-variable">atoms</span>)</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.inlets</span> = <span class="cm-number">1</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.outlets</span> = <span class="cm-number">1</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.counter</span> = <span class="cm-number">0</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.step</span> = <span class="cm-number">1</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">if</span> <span class="cm-builtin">type</span>(<span class="cm-variable">atoms</span>[<span class="cm-number">1</span>]) == <span class="cm-string">"number"</span> <span class="cm-keyword">then</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">self.counter</span> = <span class="cm-variable">atoms</span>[<span class="cm-number">1</span>]</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">elseif</span> <span class="cm-builtin">type</span>(<span class="cm-variable">atoms</span>[<span class="cm-number">1</span>]) ~= <span class="cm-string">"nil"</span> <span class="cm-keyword">then</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">self</span>:<span class="cm-builtin">error</span>(<span class="cm-builtin">string.format</span>(<span class="cm-string">"foo: #1: %s is of the wrong type %s"</span>,</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class="cm-builtin">tostring</span>(<span class="cm-variable">atoms</span>[<span class="cm-number">1</span>]), <span class="cm-builtin">type</span>(<span class="cm-variable">atoms</span>[<span class="cm-number">1</span>])))</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">if</span> <span class="cm-builtin">type</span>(<span class="cm-variable">atoms</span>[<span class="cm-number">2</span>]) == <span class="cm-string">"number"</span> <span class="cm-keyword">then</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">self.step</span> = <span class="cm-variable">atoms</span>[<span class="cm-number">2</span>]</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">elseif</span> <span class="cm-builtin">type</span>(<span class="cm-variable">atoms</span>[<span class="cm-number">2</span>]) ~= <span class="cm-string">"nil"</span> <span class="cm-keyword">then</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">self</span>:<span class="cm-builtin">error</span>(<span class="cm-builtin">string.format</span>(<span class="cm-string">"foo: #2: %s is of the wrong type %s"</span>,</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class="cm-builtin">tostring</span>(<span class="cm-variable">atoms</span>[<span class="cm-number">2</span>]), <span class="cm-builtin">type</span>(<span class="cm-variable">atoms</span>[<span class="cm-number">2</span>])))</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">pd.post</span>(<span class="cm-builtin">string.format</span>(<span class="cm-string">"foo: initialized counter: %g, step size: %g"</span>,</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class="cm-variable">self.counter</span>, <span class="cm-variable">self.step</span>))</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">return</span> <span class="cm-keyword">true</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 484px;"></div><div class="CodeMirror-gutters" style="display: none; height: 484px;"></div></div></div></pre><p><span>And here&#39;s how the console log looks like after loading our test patch, and creating an erroneous </span><code>foo bad</code><span> object:</span></p><p><img src="05-post-and-error.png" referrerpolicy="no-referrer" alt="Log messages"></p><p><span>Note that the </span><code>foo bad</code><span> object was still created with the appropriate defaults </span><em><span>after</span></em><span> the error message, so the </span><code>initialize</code><span> method ran through to the end alright. If you </span><em><span>want</span></em><span> the object creation to fail after printing the error message, you only have to add a </span><code>return false</code><span> statement in the </span><code>elseif</code><span> branch, after the call to </span><code>self:error</code><span>. Try it! (Of course, you won&#39;t be able to locate the object using the printed error message in this case, since the object wasn&#39;t actually created. But &quot;Find Last Error&quot; will still work, since Pd itself will also print a &quot;couldn&#39;t create&quot; error message.)</span></p><p><span>Here&#39;s another fun exercise: Let&#39;s have </span><code>foo</code><span> print a welcome message when it first gets invoked. This can be done by adding a variable </span><code>init</code><span> to the </span><code>foo</code><span> class itself, which is shared between different object instances, as follows:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51982px; left: 7.99336px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation"><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-variable">foo.init</span> = <span class="cm-keyword">false</span></span></pre></div></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 23px;"></div><div class="CodeMirror-gutters" style="display: none; height: 23px;"></div></div></div></pre><p><span>You should put this after the definition of </span><code>foo</code><span> (i.e., after the line with the </span><code>pd.Class:new()</code><span> call), but before any code that uses this variable. Note that we could also just have used an ordinary local variable at script level instead, but this illustrates how you create static class members in Lua.</span></p><p><span>You still have to add the code which outputs the welcome message. An obvious place for this is somewhere in </span><code>initialize</code><span>, but here we use the </span><code>postinitialize</code><span> method for illustration purposes:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51982px; left: 7.99336px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">foo</span>:<span class="cm-variable">postinitialize</span>()</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">if</span> <span class="cm-keyword">not</span> <span class="cm-variable">foo.init</span> <span class="cm-keyword">then</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">pd.post</span>(<span class="cm-string">"Welcome to foo! Copyright (c) by Foo software."</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">foo.init</span> = <span class="cm-keyword">true</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 138px;"></div><div class="CodeMirror-gutters" style="display: none; height: 138px;"></div></div></div></pre><p><span>This will print the message just once, right after the first </span><code>foo</code><span> object is created. There&#39;s another </span><code>finalize</code><span> method which can be used to perform any kind of cleanup when an object gets destroyed. For instance, let&#39;s rework our example so that it keeps track of the actual number of </span><code>foo</code><span> objects, and prints an additional message when the last </span><code>foo</code><span> object is deleted. To these ends, we turn </span><code>foo.init</code><span> into a counter which keeps track of the number of </span><code>foo</code><span> objects:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua" style="break-inside: unset;"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51982px; left: 7.99336px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-variable">foo.init</span> = <span class="cm-number">0</span></span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
+</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">foo</span>:<span class="cm-variable">in_1_bang</span>()</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self</span>:<span class="cm-variable">outlet</span>(<span class="cm-number">1</span>, <span class="cm-string">"float"</span>, {<span class="cm-variable">self.counter</span>})</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.counter</span> = <span class="cm-variable">self.counter</span> + <span class="cm-variable">self.step</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 507px;"></div><div class="CodeMirror-gutters" style="display: none; height: 507px;"></div></div></div></pre><p><span>That was easy enough. If you&#39;ve been following along, you also know by now how to reload the patch and add a few bits to test the new features. For instance: </span></p><p><img src="04-creation-args.png" referrerpolicy="no-referrer" alt="Creating arguments"></p><h2 id='log-messages-and-errors'><span>Log messages and errors</span></h2><p><span>As soon as your objects get more complicated, you&#39;ll probably want to add some messages indicating to the user (or yourself) what&#39;s going on inside the object&#39;s methods. To these ends, Pd-Lua provides the following two facilities which let you output text messages to the Pd console:</span></p><ul><li><p><code>pd.post(msg)</code><span> outputs the string </span><code>msg</code><span> to the console on a separate line. You can also post multi-line messages by embedding newline (</span><code>\n</code><span>) characters in the </span><code>msg</code><span> string. This is also frequently used for debugging purposes, e.g., to print out incoming messages or intermediate values that your code calculates.</span></p></li><li><p><code>self:error(msg)</code><span> reports an error message, given as a string </span><code>msg</code><span>, to the console. These messages are printed in red, to make them stand out, and you can use the &quot;Find Last Error&quot; menu option to locate the object which reported the error. (In Purr Data it&#39;s also possible to just click on the &quot;error&quot; link in the console to locate the object.) Note that </span><code>self:error</code><span> simply prints the message in a way that ties in with &quot;Find Last Error&quot;. It doesn&#39;t abort the method that executes it, or have any other grave consequences. Thus you can also use it for debugging purposes, like </span><code>pd.post</code><span>, if you need to trace the message back to the object it came from.</span></p></li></ul><p><span>For instance, let&#39;s use these facilities to have our </span><code>foo</code><span> object post the initial counter value in the </span><code>initialize</code><span> method, as well as report an error if any of the given creation arguments is of the wrong type. Here is the suitably modified </span><code>initialize</code><span> method:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua" style="break-inside: unset;"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51801px; left: 7.98611px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">foo</span>:<span class="cm-variable">initialize</span>(<span class="cm-variable">sel</span>, <span class="cm-variable">atoms</span>)</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.inlets</span> = <span class="cm-number">1</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.outlets</span> = <span class="cm-number">1</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.counter</span> = <span class="cm-number">0</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.step</span> = <span class="cm-number">1</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">if</span> <span class="cm-builtin">type</span>(<span class="cm-variable">atoms</span>[<span class="cm-number">1</span>]) == <span class="cm-string">"number"</span> <span class="cm-keyword">then</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">self.counter</span> = <span class="cm-variable">atoms</span>[<span class="cm-number">1</span>]</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">elseif</span> <span class="cm-builtin">type</span>(<span class="cm-variable">atoms</span>[<span class="cm-number">1</span>]) ~= <span class="cm-string">"nil"</span> <span class="cm-keyword">then</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">self</span>:<span class="cm-builtin">error</span>(<span class="cm-builtin">string.format</span>(<span class="cm-string">"foo: #1: %s is of the wrong type %s"</span>,</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class="cm-builtin">tostring</span>(<span class="cm-variable">atoms</span>[<span class="cm-number">1</span>]), <span class="cm-builtin">type</span>(<span class="cm-variable">atoms</span>[<span class="cm-number">1</span>])))</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">if</span> <span class="cm-builtin">type</span>(<span class="cm-variable">atoms</span>[<span class="cm-number">2</span>]) == <span class="cm-string">"number"</span> <span class="cm-keyword">then</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">self.step</span> = <span class="cm-variable">atoms</span>[<span class="cm-number">2</span>]</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">elseif</span> <span class="cm-builtin">type</span>(<span class="cm-variable">atoms</span>[<span class="cm-number">2</span>]) ~= <span class="cm-string">"nil"</span> <span class="cm-keyword">then</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">self</span>:<span class="cm-builtin">error</span>(<span class="cm-builtin">string.format</span>(<span class="cm-string">"foo: #2: %s is of the wrong type %s"</span>,</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class="cm-builtin">tostring</span>(<span class="cm-variable">atoms</span>[<span class="cm-number">2</span>]), <span class="cm-builtin">type</span>(<span class="cm-variable">atoms</span>[<span class="cm-number">2</span>])))</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">pd.post</span>(<span class="cm-builtin">string.format</span>(<span class="cm-string">"foo: initialized counter: %g, step size: %g"</span>,</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class="cm-variable">self.counter</span>, <span class="cm-variable">self.step</span>))</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">return</span> <span class="cm-keyword">true</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 484px;"></div><div class="CodeMirror-gutters" style="display: none; height: 484px;"></div></div></div></pre><p><span>And here&#39;s how the console log looks like after loading our test patch, and creating an erroneous </span><code>foo bad</code><span> object:</span></p><p><img src="05-post-and-error.png" referrerpolicy="no-referrer" alt="Log messages"></p><p><span>Note that the </span><code>foo bad</code><span> object was still created with the appropriate defaults </span><em><span>after</span></em><span> the error message, so the </span><code>initialize</code><span> method ran through to the end alright. If you </span><em><span>want</span></em><span> the object creation to fail after printing the error message, you only have to add a </span><code>return false</code><span> statement in the </span><code>elseif</code><span> branch, after the call to </span><code>self:error</code><span>. Try it! (Of course, you won&#39;t be able to locate the object using the printed error message in this case, since the object wasn&#39;t actually created. But &quot;Find Last Error&quot; will still work, since Pd itself will also print a &quot;couldn&#39;t create&quot; error message.)</span></p><p><span>Here&#39;s another fun exercise: Let&#39;s have </span><code>foo</code><span> print a welcome message when it first gets invoked. This can be done by adding a variable </span><code>init</code><span> to the </span><code>foo</code><span> class itself, which is shared between different object instances, as follows:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51801px; left: 7.98611px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation"><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-variable">foo.init</span> = <span class="cm-keyword">false</span></span></pre></div></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 23px;"></div><div class="CodeMirror-gutters" style="display: none; height: 23px;"></div></div></div></pre><p><span>You should put this after the definition of </span><code>foo</code><span> (i.e., after the line with the </span><code>pd.Class:new()</code><span> call), but before any code that uses this variable. Note that we could also just have used an ordinary local variable at script level instead, but this illustrates how you create static class members in Lua.</span></p><p><span>You still have to add the code which outputs the welcome message. An obvious place for this is somewhere in </span><code>initialize</code><span>, but here we use the </span><code>postinitialize</code><span> method for illustration purposes:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51801px; left: 7.98611px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">foo</span>:<span class="cm-variable">postinitialize</span>()</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">if</span> <span class="cm-keyword">not</span> <span class="cm-variable">foo.init</span> <span class="cm-keyword">then</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">pd.post</span>(<span class="cm-string">"Welcome to foo! Copyright (c) by Foo software."</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">foo.init</span> = <span class="cm-keyword">true</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 138px;"></div><div class="CodeMirror-gutters" style="display: none; height: 138px;"></div></div></div></pre><p><span>This will print the message just once, right after the first </span><code>foo</code><span> object is created. There&#39;s another </span><code>finalize</code><span> method which can be used to perform any kind of cleanup when an object gets destroyed. For instance, let&#39;s rework our example so that it keeps track of the actual number of </span><code>foo</code><span> objects, and prints an additional message when the last </span><code>foo</code><span> object is deleted. To these ends, we turn </span><code>foo.init</code><span> into a counter which keeps track of the number of </span><code>foo</code><span> objects:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua" style="break-inside: unset;"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51801px; left: 7.98611px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-variable">foo.init</span> = <span class="cm-number">0</span></span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
 </span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">foo</span>:<span class="cm-variable">postinitialize</span>()</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">if</span> <span class="cm-variable">foo.init</span> == <span class="cm-number">0</span> <span class="cm-keyword">then</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">pd.post</span>(<span class="cm-string">"Welcome to foo! Copyright (c) by Foo software."</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">foo.init</span> = <span class="cm-variable">foo.init</span> + <span class="cm-number">1</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
-</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">foo</span>:<span class="cm-variable">finalize</span>()</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">foo.init</span> = <span class="cm-variable">foo.init</span> - <span class="cm-number">1</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">if</span> <span class="cm-variable">foo.init</span> == <span class="cm-number">0</span> <span class="cm-keyword">then</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">pd.post</span>(<span class="cm-string">"Thanks for using foo!"</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 346px;"></div><div class="CodeMirror-gutters" style="display: none; height: 346px;"></div></div></div></pre><p><span>Here are the messages logged in the console if we now load our test patch and then go on to delete all </span><code>foo</code><span> objects in it:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang=""><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang=""><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51982px; left: 7.99336px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;">foo: initialized counter: 0, step size: 1</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;">Welcome to foo! Copyright (c) by Foo software.</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;">foo: initialized counter: 5, step size: 1</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;">foo: initialized counter: 0, step size: 5</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;">Thanks for using foo!</span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 115px;"></div><div class="CodeMirror-gutters" style="display: none; height: 115px;"></div></div></div></pre><h3 id='lua-errors'><span>Lua errors</span></h3><p><span>We all make mistakes. It&#39;s inevitable that you&#39;ll run into errors in the Lua code you wrote, so let&#39;s finally discuss how those mishaps are handled. Pd-Lua simply reports errors from the Lua interpreter in the Pd console. For instance, suppose that we omitted the </span><code>pd</code><span> qualifier in the one-time welcome message above, turning </span><code>pd.post</code><span> into just </span><code>post</code><span> (quite an easy mistake to make). You&#39;ll then see an error message like this in the console:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang=""><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang=""><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51982px; left: 7.99336px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation"><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;">error: lua: foo.pd_lua: 29: attempt to call a nil value (global 'post')</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;">error: couldn't create "foo"</span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 46px;"></div><div class="CodeMirror-gutters" style="display: none; height: 46px;"></div></div></div></pre><p><span>You&#39;ll recall that an undefined global like the mistyped </span><code>post</code><span> symbol above will always yield the </span><code>nil</code><span> value in Lua, which obviously isn&#39;t a function and thus can&#39;t be called like one. (Not all error messages will be quite as perspicuous, so a web search may be in order to figure them out.) In this case the error happened in the </span><code>postinitialize</code><span> method, so the object couldn&#39;t actually be created, and you will have to correct the typo before going on. Fortunately, the message tells us exactly where the error occurred, so we can fix it easily.</span></p><p><span>Syntax errors anywhere in the script file will be caught and handled in a similar fashion.</span></p><p><span>Runtime errors in inlet methods, on the other hand, will allow your objects to be created and to start executing. They just won&#39;t behave as expected and cause a variety of error messages to be printed in the console which might look a bit cryptic at first glance. For instance, let&#39;s suppose that you forgot the curly braces around the float value in </span><code>self:outlet</code><span> (another fairly common error), so that the method reads:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51982px; left: 7.99336px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation"><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">foo</span>:<span class="cm-variable">in_1_bang</span>()</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self</span>:<span class="cm-variable">outlet</span>(<span class="cm-number">1</span>, <span class="cm-string">"float"</span>, <span class="cm-variable">self.counter</span>) <span class="cm-comment">-- WRONG!</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.counter</span> = <span class="cm-variable">self.counter</span> + <span class="cm-variable">self.step</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 92px;"></div><div class="CodeMirror-gutters" style="display: none; height: 92px;"></div></div></div></pre><p><span>Lua is a dynamically-typed language, so this little glitch becomes apparent only when you actually send a </span><code>bang</code><span> message to the object, which causes the following error to be logged in the console:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang=""><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang=""><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51982px; left: 7.99336px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation"><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;">error: foo.pd_lua: 41: error: invalid atoms table [outlet 1]</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;">... click the link above to track it down, or click the 'Find Last Error' item in the Edit menu.</span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 69px;"></div><div class="CodeMirror-gutters" style="display: none; height: 69px;"></div></div></div></pre><p><span>This message actually comes from the C routine deep down in Pd-Lua which checks the arguments of the </span><code>outlet</code><span> method for validity before it sends any data through the outlet. In this case it took issue with the </span><code>atoms</code><span> argument. If you see that message, it&#39;s a telltale sign that you tried to output an atom not properly wrapped in a Lua table. The message also tells you about the outlet number which caused the issue, and the line number with the definition of the method in which the error happened (which is the </span><code>foo:in_1_bang</code><span> method in this case). So it&#39;s not the </span><em><span>exact</span></em><span> location of the </span><code>self:outlet()</code><span> call, but still close enough so that you can easily find that spot with the extra information provided in the error message.</span></p><p><span>To actually fix the error, simply go to the line number from the error message in the editor to find the method with the error, and edit the </span><code>outlet</code><span> call to add the curly braces around </span><code>self.counter</code><span> back in. In case you already closed the editor, recall that you can just click on the error message (or use the &quot;Find Last Error&quot; operation) to locate the object, then right-click the object and open it.</span></p><h2 id='inlets-and-outlets'><span>Inlets and outlets</span></h2><p><span>As we&#39;ve already seen, the number of inlets and outlets is set with the </span><code>inlets</code><span> and </span><code>outlets</code><span> member variables in the </span><code>initialize</code><span> method of an object. You can set these to any numbers you want, including zero. (In the current implementation, fractional numbers will be truncated to integers, and negative numbers will be treated as zero. If the variables aren&#39;t set at all, they also default to zero.)</span></p><h3 id='inlets'><span>Inlets</span></h3><p><span>Let&#39;s have a look at the inlets first. Pd-Lua supports a number of different forms of inlet methods which enable us to process any kind of Pd message. In the following list, &quot;1&quot; stands for any literal inlet number (counting the inlets from left to right, starting at 1), and &quot;sym&quot; for any symbol denoting either one of the predefined Pd message types (bang, float, symbol, pointer, and list), or any other (selector) symbol at the beginning of a Pd meta message. Note that, as usual, in your code these methods are always prefixed with the class name, using Lua colon syntax.</span></p><ul><li><p><code>in_1_sym(...)</code><span> matches the given type or selector symbol on the given inlet; the method receives zero or one arguments (denoted </span><code>...</code><span> here), depending on the selector symbol </span><code>sym</code><span>, see below</span></p></li><li><p><code>in_n_sym(n, ...)</code><span> (with a verbatim &quot;n&quot; replacing the inlet number) matches the given type or selector symbol on </span><em><span>any</span></em><span> inlet; the actual inlet number is passed as the first argument (denoted </span><code>n</code><span> here), along with the zero or one extra arguments </span><code>...</code><span> which, like above, depend on the selector symbol </span><code>sym</code></p></li><li><p><code>in_1(sel, atoms)</code><span> matches </span><em><span>any</span></em><span> type or selector symbol on the given inlet; the type or selector symbol is passed as a string </span><code>sel</code><span>, and the remaining arguments of the message are passed as a Lua table </span><code>atoms</code><span> containing number and string values</span></p></li><li><p><code>in_n(n, sel, atoms)</code><span> matches </span><em><span>any</span></em><span> type or selector symbol on </span><em><span>any</span></em><span> inlet; the method is invoked with the inlet number </span><code>n</code><span> along with type/selector symbol </span><code>sel</code><span> and the remaining message arguments in the Lua table </span><code>atoms</code></p></li></ul><p><span>These alternatives are tried in the indicated order, i.e., from most specific to most general. In addition, Pd-Lua understands the following specific </span><code>sym</code><span> type selectors and adjusts the number and type of the extra </span><code>...</code><span> arguments accordingly:</span></p><ul><li><p><code>bang</code><span> denotes a bang message and passes no arguments</span></p></li><li><p><code>float</code><span> denotes a Pd float value, which is passed as a number argument</span></p></li><li><p><code>symbol</code><span> denotes a Pd symbol, which is passed as a string argument</span></p></li><li><p><code>pointer</code><span> denotes a Pd pointer, which is passed as a Lua userdata argument</span></p></li><li><p><code>list</code><span> denotes a Pd list, which is passed as a Lua table argument containing all the list elements</span></p></li><li><p><span>any other </span><code>sym</code><span> value is taken as a literal Pd symbol to be matched against the selector symbol of the incoming message; the remaining arguments of the message are passed as a Lua table argument</span></p></li></ul><p><span>Note that there can only be zero or one additional arguments in this case (besides the inlet number for </span><code>in_n_sym</code><span>). In contrast, the two most generic kinds of methods, </span><code>in_1</code><span> and </span><code>in_n</code><span>, always have the type/selector symbol </span><code>sel</code><span> (a string) and the remaining message arguments </span><code>atoms</code><span> (a Lua table) as arguments.</span></p><p><span>Among these, the methods for </span><code>bang</code><span>, </span><code>float</code><span>, and </span><code>list</code><span> are probably the most frequently used, along with </span><code>in_1</code><span> or </span><code>in_n</code><span> as a catch-all method for processing any other kind of input message. We&#39;ve already employed the </span><code>in_1_bang</code><span> method in our basic example above. Here are some (rather contrived) examples for the other methods; we&#39;ll see some real examples of some of these later on.</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua" style="break-inside: unset;"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51982px; left: 7.99336px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">foo</span>:<span class="cm-variable">in_1_float</span>(<span class="cm-variable">x</span>)</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">pd.post</span>(<span class="cm-builtin">string.format</span>(<span class="cm-string">"foo: got float %g"</span>, <span class="cm-variable">x</span>))</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
+</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">foo</span>:<span class="cm-variable">finalize</span>()</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">foo.init</span> = <span class="cm-variable">foo.init</span> - <span class="cm-number">1</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">if</span> <span class="cm-variable">foo.init</span> == <span class="cm-number">0</span> <span class="cm-keyword">then</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">pd.post</span>(<span class="cm-string">"Thanks for using foo!"</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 346px;"></div><div class="CodeMirror-gutters" style="display: none; height: 346px;"></div></div></div></pre><p><span>Here are the messages logged in the console if we now load our test patch and then go on to delete all </span><code>foo</code><span> objects in it:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang=""><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang=""><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51801px; left: 7.98611px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;">foo: initialized counter: 0, step size: 1</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;">Welcome to foo! Copyright (c) by Foo software.</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;">foo: initialized counter: 5, step size: 1</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;">foo: initialized counter: 0, step size: 5</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;">Thanks for using foo!</span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 115px;"></div><div class="CodeMirror-gutters" style="display: none; height: 115px;"></div></div></div></pre><h3 id='lua-errors'><span>Lua errors</span></h3><p><span>We all make mistakes. It&#39;s inevitable that you&#39;ll run into errors in the Lua code you wrote, so let&#39;s finally discuss how those mishaps are handled. Pd-Lua simply reports errors from the Lua interpreter in the Pd console. For instance, suppose that we omitted the </span><code>pd</code><span> qualifier in the one-time welcome message above, turning </span><code>pd.post</code><span> into just </span><code>post</code><span> (quite an easy mistake to make). You&#39;ll then see an error message like this in the console:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang=""><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang=""><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51801px; left: 7.98611px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation"><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;">error: lua: foo.pd_lua: 29: attempt to call a nil value (global 'post')</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;">error: couldn't create "foo"</span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 46px;"></div><div class="CodeMirror-gutters" style="display: none; height: 46px;"></div></div></div></pre><p><span>You&#39;ll recall that an undefined global like the mistyped </span><code>post</code><span> symbol above will always yield the </span><code>nil</code><span> value in Lua, which obviously isn&#39;t a function and thus can&#39;t be called like one. (Not all error messages will be quite as perspicuous, so a web search may be in order to figure them out.) In this case the error happened in the </span><code>postinitialize</code><span> method, so the object couldn&#39;t actually be created, and you will have to correct the typo before going on. Fortunately, the message tells us exactly where the error occurred, so we can fix it easily.</span></p><p><span>Syntax errors anywhere in the script file will be caught and handled in a similar fashion.</span></p><p><span>Runtime errors in inlet methods, on the other hand, will allow your objects to be created and to start executing. They just won&#39;t behave as expected and cause a variety of error messages to be printed in the console which might look a bit cryptic at first glance. For instance, let&#39;s suppose that you forgot the curly braces around the float value in </span><code>self:outlet</code><span> (another fairly common error), so that the method reads:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51801px; left: 7.98611px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation"><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">foo</span>:<span class="cm-variable">in_1_bang</span>()</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self</span>:<span class="cm-variable">outlet</span>(<span class="cm-number">1</span>, <span class="cm-string">"float"</span>, <span class="cm-variable">self.counter</span>) <span class="cm-comment">-- WRONG!</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.counter</span> = <span class="cm-variable">self.counter</span> + <span class="cm-variable">self.step</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 92px;"></div><div class="CodeMirror-gutters" style="display: none; height: 92px;"></div></div></div></pre><p><span>Lua is a dynamically-typed language, so this little glitch becomes apparent only when you actually send a </span><code>bang</code><span> message to the object, which causes the following error to be logged in the console:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang=""><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang=""><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51801px; left: 7.98611px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation"><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;">error: foo.pd_lua: 41: error: invalid atoms table [outlet 1]</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;">... click the link above to track it down, or click the 'Find Last Error' item in the Edit menu.</span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 69px;"></div><div class="CodeMirror-gutters" style="display: none; height: 69px;"></div></div></div></pre><p><span>This message actually comes from the C routine deep down in Pd-Lua which checks the arguments of the </span><code>outlet</code><span> method for validity before it sends any data through the outlet. In this case it took issue with the </span><code>atoms</code><span> argument. If you see that message, it&#39;s a telltale sign that you tried to output an atom not properly wrapped in a Lua table. The message also tells you about the outlet number which caused the issue, and the line number with the definition of the method in which the error happened (which is the </span><code>foo:in_1_bang</code><span> method in this case). So it&#39;s not the </span><em><span>exact</span></em><span> location of the </span><code>self:outlet()</code><span> call, but still close enough so that you can easily find that spot with the extra information provided in the error message.</span></p><p><span>To actually fix the error, simply go to the line number from the error message in the editor to find the method with the error, and edit the </span><code>outlet</code><span> call to add the curly braces around </span><code>self.counter</code><span> back in. In case you already closed the editor, recall that you can just click on the error message (or use the &quot;Find Last Error&quot; operation) to locate the object, then right-click the object and open it.</span></p><h2 id='inlets-and-outlets'><span>Inlets and outlets</span></h2><p><span>As we&#39;ve already seen, the number of inlets and outlets is set with the </span><code>inlets</code><span> and </span><code>outlets</code><span> member variables in the </span><code>initialize</code><span> method of an object. You can set these to any numbers you want, including zero. (In the current implementation, fractional numbers will be truncated to integers, and negative numbers will be treated as zero. If the variables aren&#39;t set at all, they also default to zero.)</span></p><h3 id='inlets'><span>Inlets</span></h3><p><span>Let&#39;s have a look at the inlets first. Pd-Lua supports a number of different forms of inlet methods which enable us to process any kind of Pd message. In the following list, &quot;1&quot; stands for any literal inlet number (counting the inlets from left to right, starting at 1), and &quot;sym&quot; for any symbol denoting either one of the predefined Pd message types (bang, float, symbol, pointer, and list), or any other (selector) symbol at the beginning of a Pd meta message. Note that, as usual, in your code these methods are always prefixed with the class name, using Lua colon syntax.</span></p><ul><li><p><code>in_1_sym(...)</code><span> matches the given type or selector symbol on the given inlet; the method receives zero or one arguments (denoted </span><code>...</code><span> here), depending on the selector symbol </span><code>sym</code><span>, see below</span></p></li><li><p><code>in_n_sym(n, ...)</code><span> (with a verbatim &quot;n&quot; replacing the inlet number) matches the given type or selector symbol on </span><em><span>any</span></em><span> inlet; the actual inlet number is passed as the first argument (denoted </span><code>n</code><span> here), along with the zero or one extra arguments </span><code>...</code><span> which, like above, depend on the selector symbol </span><code>sym</code></p></li><li><p><code>in_1(sel, atoms)</code><span> matches </span><em><span>any</span></em><span> type or selector symbol on the given inlet; the type or selector symbol is passed as a string </span><code>sel</code><span>, and the remaining arguments of the message are passed as a Lua table </span><code>atoms</code><span> containing number and string values</span></p></li><li><p><code>in_n(n, sel, atoms)</code><span> matches </span><em><span>any</span></em><span> type or selector symbol on </span><em><span>any</span></em><span> inlet; the method is invoked with the inlet number </span><code>n</code><span> along with type/selector symbol </span><code>sel</code><span> and the remaining message arguments in the Lua table </span><code>atoms</code></p></li></ul><p><span>These alternatives are tried in the indicated order, i.e., from most specific to most general. In addition, Pd-Lua understands the following specific </span><code>sym</code><span> type selectors and adjusts the number and type of the extra </span><code>...</code><span> arguments accordingly:</span></p><ul><li><p><code>bang</code><span> denotes a bang message and passes no arguments</span></p></li><li><p><code>float</code><span> denotes a Pd float value, which is passed as a number argument</span></p></li><li><p><code>symbol</code><span> denotes a Pd symbol, which is passed as a string argument</span></p></li><li><p><code>pointer</code><span> denotes a Pd pointer, which is passed as a Lua userdata argument</span></p></li><li><p><code>list</code><span> denotes a Pd list, which is passed as a Lua table argument containing all the list elements</span></p></li><li><p><span>any other </span><code>sym</code><span> value is taken as a literal Pd symbol to be matched against the selector symbol of the incoming message; the remaining arguments of the message are passed as a Lua table argument</span></p></li></ul><p><span>Note that there can only be zero or one additional arguments in this case (besides the inlet number for </span><code>in_n_sym</code><span>). In contrast, the two most generic kinds of methods, </span><code>in_1</code><span> and </span><code>in_n</code><span>, always have the type/selector symbol </span><code>sel</code><span> (a string) and the remaining message arguments </span><code>atoms</code><span> (a Lua table) as arguments.</span></p><p><span>Among these, the methods for </span><code>bang</code><span>, </span><code>float</code><span>, and </span><code>list</code><span> are probably the most frequently used, along with </span><code>in_1</code><span> or </span><code>in_n</code><span> as a catch-all method for processing any other kind of input message. We&#39;ve already employed the </span><code>in_1_bang</code><span> method in our basic example above. Here are some (rather contrived) examples for the other methods; we&#39;ll see some real examples of some of these later on.</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua" style="break-inside: unset;"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51801px; left: 7.98611px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">foo</span>:<span class="cm-variable">in_1_float</span>(<span class="cm-variable">x</span>)</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">pd.post</span>(<span class="cm-builtin">string.format</span>(<span class="cm-string">"foo: got float %g"</span>, <span class="cm-variable">x</span>))</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
 </span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">foo</span>:<span class="cm-variable">in_1_symbol</span>(<span class="cm-variable">x</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">pd.post</span>(<span class="cm-builtin">string.format</span>(<span class="cm-string">"foo: got symbol %s"</span>, <span class="cm-variable">x</span>))</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
 </span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">foo</span>:<span class="cm-variable">in_1_list</span>(<span class="cm-variable">x</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">pd.post</span>(<span class="cm-builtin">string.format</span>(<span class="cm-string">"foo: got list %s"</span>, <span class="cm-builtin">table.concat</span>(<span class="cm-variable">x</span>, <span class="cm-string">" "</span>)))</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
 </span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">foo</span>:<span class="cm-variable">in_1_bar</span>(<span class="cm-variable">x</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">pd.post</span>(<span class="cm-builtin">string.format</span>(<span class="cm-string">"foo: got bar %s"</span>, <span class="cm-builtin">table.concat</span>(<span class="cm-variable">x</span>, <span class="cm-string">" "</span>)))</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
 </span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">foo</span>:<span class="cm-variable">in_n_baz</span>(<span class="cm-variable">n</span>, <span class="cm-variable">x</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">pd.post</span>(<span class="cm-builtin">string.format</span>(<span class="cm-string">"foo: got baz %s on inlet #%d"</span>,</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class="cm-builtin">table.concat</span>(<span class="cm-variable">x</span>, <span class="cm-string">" "</span>), <span class="cm-variable">n</span>))</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
 </span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">foo</span>:<span class="cm-variable">in_1</span>(<span class="cm-variable">sel</span>, <span class="cm-variable">atoms</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">pd.post</span>(<span class="cm-builtin">string.format</span>(<span class="cm-string">"foo: got %s %s"</span>, <span class="cm-variable">sel</span>, <span class="cm-builtin">table.concat</span>(<span class="cm-variable">atoms</span>, <span class="cm-string">" "</span>)))</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
-</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">foo</span>:<span class="cm-variable">in_n</span>(<span class="cm-variable">n</span>, <span class="cm-variable">sel</span>, <span class="cm-variable">atoms</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">pd.post</span>(<span class="cm-builtin">string.format</span>(<span class="cm-string">"foo: got %s %s on inlet #%d"</span>, <span class="cm-variable">sel</span>,</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class="cm-builtin">table.concat</span>(<span class="cm-variable">atoms</span>, <span class="cm-string">" "</span>), <span class="cm-variable">n</span>))</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 668px;"></div><div class="CodeMirror-gutters" style="display: none; height: 668px;"></div></div></div></pre><p><span>(Note that we omitted the pointer type in the above examples, as it is rarely used in Lua externals. But if you want, you can also receive such values, which will be represented as &quot;userdata&quot; a.k.a. C pointers on the Lua side. In Lua 5.4 it is possible to print such values using the </span><code>%p</code><span> format specifier of </span><code>string.format</code><span>, while in older Lua versions you will have to use the Lua </span><code>tostring()</code><span> function for this purpose.)</span></p><h3 id='outlets'><span>Outlets</span></h3><p><span>Luckily, things are much simpler on the output side. As we&#39;ve already seen, to output a message to an outlet, you simply call </span><code>self:outlet(n, sel, atoms)</code><span> with the following arguments:</span></p><ul><li><p><code>n</code><span> is the outlet number, counting from left to right, starting at 1</span></p></li><li><p><code>sel</code><span> is the type or selector symbol of the message; all the usual Pd type symbols that we&#39;ve already seen above are recognized here as well: </span><code>bang</code><span>, </span><code>float</code><span>, </span><code>symbol</code><span>, </span><code>pointer</code><span>, </span><code>list</code></p></li><li><p><code>atoms</code><span> are the remaining arguments of the message as a Lua table containing numbers, pointers and strings, as required by the message</span></p></li></ul><p><span>Here are some common examples:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51982px; left: 7.99336px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-variable">self</span>:<span class="cm-variable">outlet</span>(<span class="cm-number">1</span>, <span class="cm-string">"bang"</span>, {})</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-variable">self</span>:<span class="cm-variable">outlet</span>(<span class="cm-number">1</span>, <span class="cm-string">"float"</span>, {<span class="cm-builtin">math.pi</span>})</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-variable">self</span>:<span class="cm-variable">outlet</span>(<span class="cm-number">1</span>, <span class="cm-string">"symbol"</span>, {<span class="cm-string">"bar"</span>})</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-variable">self</span>:<span class="cm-variable">outlet</span>(<span class="cm-number">1</span>, <span class="cm-string">"list"</span>, {<span class="cm-number">1</span>, <span class="cm-number">2</span>, <span class="cm-number">3</span>})</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-variable">self</span>:<span class="cm-variable">outlet</span>(<span class="cm-number">1</span>, <span class="cm-string">"fruit"</span>, {<span class="cm-string">"apple"</span>, <span class="cm-string">"orange"</span>, <span class="cm-string">"kiwi"</span>})</span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 115px;"></div><div class="CodeMirror-gutters" style="display: none; height: 115px;"></div></div></div></pre><p><span>Usually, </span><code>self:outlet</code><span> will be called in the inlet methods of an object, but you&#39;ll also see it in clocks and receivers, which we&#39;ll discuss later.</span></p><p><span>Note that, by convention, most Pd objects handle inlets and outlets in a certain order, namely:</span></p><ul><li><p><span>The </span><em><span>leftmost</span></em><span> inlet is the so-called </span><em><span>hot</span></em><span> inlet which triggers the actual computation and resulting output of an object. Thus in Lua the calls to </span><code>self:outlet</code><span> should normally be put into the </span><code>in_1</code><span> methods.</span></p></li><li><p><span>Consequently, outlets are normally triggered </span><em><span>from right to left</span></em><span>, so that, with a straight (non-crossing) wiring of the patch cables, a connected object gets its hot inlet triggered </span><em><span>last</span></em><span>. In Lua this means that your </span><code>self:outlet</code><span> calls should be ordered such that the outlet numbers are </span><em><span>decreasing</span></em><span>, not increasing with each call.</span></p></li></ul><p><span>You&#39;ll also see this guideline being used in the Fibonacci number example in the next section. Let us emphasize again that this is merely a </span><em><span>convention</span></em><span> and thus you&#39;re not obliged to follow it, but most built-in and external Pd objects do. Thus if your Lua object works differently for no good reason, then seasoned Pd users will think that it is malfunctioning. There are some rare cases, however, where it&#39;s legitimate to deviate from these rules. Consider, for instance, the built-in </span><code>timer</code><span> object whose </span><em><span>right</span></em><span> inlet is the &quot;hot&quot; one.</span></p><h2 id='fibonacci-number-example'><span>Fibonacci number example</span></h2><p><span>Nobody in their right mind would actually bother to implement counters in Lua, since they&#39;re very easy to do directly in Pd. So let&#39;s now take a look at a slightly more interesting example, the Fibonacci numbers. It is also instructive to see how surprisingly difficult it is to write this as a Pd abstraction (you should actually give it a try), whereas it is really dead-easy in Lua.</span></p><p><span>If you know some math or have studied the Golden ratio, then you&#39;ve probably heard about these. Starting from the pair 0, 1, the next number is always the sum of the two preceding ones: 0, 1, 1, 2, 3, 5, 8, 13, 21, 34, 55, 89, 144, etc. It goes without saying that these numbers grow pretty quickly (with the ratio of successive numbers approaching the Golden ratio). Thus we may want to limit their range, which is also useful if we want to use these numbers in a musical context, e.g., employing them as the basis of MIDI note numbers. One idea which produces both mathematically and musically interesting results is to take the numbers modulo </span><em><span>m</span></em><span>, i.e., just retain their remainders when divided by the given modulus. As these sequences all have a finite range, they must repeat eventually, but they have a surprisingly large period (also known as the </span><em><span>Pisano period</span></em><span> in number theory) even for small values of </span><em><span>m</span></em><span>.</span></p><p><span>So, without any further ado, here is a Pd-Lua object which calculates the Fibonacci numbers for a given modulus (10 by default, which, as </span><a href='https://en.wikipedia.org/wiki/Pisano_period'><span>Wikipedia</span></a><span> will tell you, has a Pisano period of 60). We actually compute (and output) the numbers in pairs, since we have to keep track of the pairs anyway in order to compute them efficiently.</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua" style="break-inside: unset;"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51982px; left: 7.99336px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">local</span> <span class="cm-variable">fibs</span> = <span class="cm-variable">pd.Class</span>:<span class="cm-variable">new</span>():<span class="cm-variable">register</span>(<span class="cm-string">"fibs"</span>)</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
+</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">foo</span>:<span class="cm-variable">in_n</span>(<span class="cm-variable">n</span>, <span class="cm-variable">sel</span>, <span class="cm-variable">atoms</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">pd.post</span>(<span class="cm-builtin">string.format</span>(<span class="cm-string">"foo: got %s %s on inlet #%d"</span>, <span class="cm-variable">sel</span>,</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class="cm-builtin">table.concat</span>(<span class="cm-variable">atoms</span>, <span class="cm-string">" "</span>), <span class="cm-variable">n</span>))</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 668px;"></div><div class="CodeMirror-gutters" style="display: none; height: 668px;"></div></div></div></pre><p><span>(Note that we omitted the pointer type in the above examples, as it is rarely used in Lua externals. But if you want, you can also receive such values, which will be represented as &quot;userdata&quot; a.k.a. C pointers on the Lua side. In Lua 5.4 it is possible to print such values using the </span><code>%p</code><span> format specifier of </span><code>string.format</code><span>, while in older Lua versions you will have to use the Lua </span><code>tostring()</code><span> function for this purpose.)</span></p><h3 id='outlets'><span>Outlets</span></h3><p><span>Luckily, things are much simpler on the output side. As we&#39;ve already seen, to output a message to an outlet, you simply call </span><code>self:outlet(n, sel, atoms)</code><span> with the following arguments:</span></p><ul><li><p><code>n</code><span> is the outlet number, counting from left to right, starting at 1</span></p></li><li><p><code>sel</code><span> is the type or selector symbol of the message; all the usual Pd type symbols that we&#39;ve already seen above are recognized here as well: </span><code>bang</code><span>, </span><code>float</code><span>, </span><code>symbol</code><span>, </span><code>pointer</code><span>, </span><code>list</code></p></li><li><p><code>atoms</code><span> are the remaining arguments of the message as a Lua table containing numbers, pointers and strings, as required by the message</span></p></li></ul><p><span>Here are some common examples:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51801px; left: 7.98611px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-variable">self</span>:<span class="cm-variable">outlet</span>(<span class="cm-number">1</span>, <span class="cm-string">"bang"</span>, {})</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-variable">self</span>:<span class="cm-variable">outlet</span>(<span class="cm-number">1</span>, <span class="cm-string">"float"</span>, {<span class="cm-builtin">math.pi</span>})</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-variable">self</span>:<span class="cm-variable">outlet</span>(<span class="cm-number">1</span>, <span class="cm-string">"symbol"</span>, {<span class="cm-string">"bar"</span>})</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-variable">self</span>:<span class="cm-variable">outlet</span>(<span class="cm-number">1</span>, <span class="cm-string">"list"</span>, {<span class="cm-number">1</span>, <span class="cm-number">2</span>, <span class="cm-number">3</span>})</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-variable">self</span>:<span class="cm-variable">outlet</span>(<span class="cm-number">1</span>, <span class="cm-string">"fruit"</span>, {<span class="cm-string">"apple"</span>, <span class="cm-string">"orange"</span>, <span class="cm-string">"kiwi"</span>})</span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 115px;"></div><div class="CodeMirror-gutters" style="display: none; height: 115px;"></div></div></div></pre><p><span>Usually, </span><code>self:outlet</code><span> will be called in the inlet methods of an object, but you&#39;ll also see it in clocks and receivers, which we&#39;ll discuss later.</span></p><p><span>Note that, by convention, most Pd objects handle inlets and outlets in a certain order, namely:</span></p><ul><li><p><span>The </span><em><span>leftmost</span></em><span> inlet is the so-called </span><em><span>hot</span></em><span> inlet which triggers the actual computation and resulting output of an object. Thus in Lua the calls to </span><code>self:outlet</code><span> should normally be put into the </span><code>in_1</code><span> methods.</span></p></li><li><p><span>Consequently, outlets are normally triggered </span><em><span>from right to left</span></em><span>, so that, with a straight (non-crossing) wiring of the patch cables, a connected object gets its hot inlet triggered </span><em><span>last</span></em><span>. In Lua this means that your </span><code>self:outlet</code><span> calls should be ordered such that the outlet numbers are </span><em><span>decreasing</span></em><span>, not increasing with each call.</span></p></li></ul><p><span>You&#39;ll also see this guideline being used in the Fibonacci number example in the next section. Let us emphasize again that this is merely a </span><em><span>convention</span></em><span> and thus you&#39;re not obliged to follow it, but most built-in and external Pd objects do. Thus if your Lua object works differently for no good reason, then seasoned Pd users will think that it is malfunctioning. There are some rare cases, however, where it&#39;s legitimate to deviate from these rules. Consider, for instance, the built-in </span><code>timer</code><span> object whose </span><em><span>right</span></em><span> inlet is the &quot;hot&quot; one.</span></p><h2 id='fibonacci-number-example'><span>Fibonacci number example</span></h2><p><span>Nobody in their right mind would actually bother to implement counters in Lua, since they&#39;re very easy to do directly in Pd. So let&#39;s now take a look at a slightly more interesting example, the Fibonacci numbers. It is also instructive to see how surprisingly difficult it is to write this as a Pd abstraction (you should actually give it a try), whereas it is really dead-easy in Lua.</span></p><p><span>If you know some math or have studied the Golden ratio, then you&#39;ve probably heard about these. Starting from the pair 0, 1, the next number is always the sum of the two preceding ones: 0, 1, 1, 2, 3, 5, 8, 13, 21, 34, 55, 89, 144, etc. It goes without saying that these numbers grow pretty quickly (with the ratio of successive numbers approaching the Golden ratio). Thus we may want to limit their range, which is also useful if we want to use these numbers in a musical context, e.g., employing them as the basis of MIDI note numbers. One idea which produces both mathematically and musically interesting results is to take the numbers modulo </span><em><span>m</span></em><span>, i.e., just retain their remainders when divided by the given modulus. As these sequences all have a finite range, they must repeat eventually, but they have a surprisingly large period (also known as the </span><em><span>Pisano period</span></em><span> in number theory) even for small values of </span><em><span>m</span></em><span>.</span></p><p><span>So, without any further ado, here is a Pd-Lua object which calculates the Fibonacci numbers for a given modulus (10 by default, which, as </span><a href='https://en.wikipedia.org/wiki/Pisano_period'><span>Wikipedia</span></a><span> will tell you, has a Pisano period of 60). We actually compute (and output) the numbers in pairs, since we have to keep track of the pairs anyway in order to compute them efficiently.</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua" style="break-inside: unset;"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51801px; left: 7.98611px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">local</span> <span class="cm-variable">fibs</span> = <span class="cm-variable">pd.Class</span>:<span class="cm-variable">new</span>():<span class="cm-variable">register</span>(<span class="cm-string">"fibs"</span>)</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
 </span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">fibs</span>:<span class="cm-variable">initialize</span>(<span class="cm-variable">sel</span>, <span class="cm-variable">atoms</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- one inlet for bangs and other messages</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.inlets</span> = <span class="cm-number">1</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- two outlets for the numbers in pairs</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.outlets</span> = <span class="cm-number">2</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- intial pair</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.a</span>, <span class="cm-variable">self.b</span> = <span class="cm-number">0</span>, <span class="cm-number">1</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- the modulus can also be set as creation argument</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.m</span> = <span class="cm-builtin">type</span>(<span class="cm-variable">atoms</span>[<span class="cm-number">1</span>]) == <span class="cm-string">"number"</span> <span class="cm-keyword">and</span> <span class="cm-variable">atoms</span>[<span class="cm-number">1</span>] <span class="cm-keyword">or</span> <span class="cm-number">10</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- make sure that it's an integer &gt; 0</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.m</span> = <span class="cm-builtin">math.max</span>(<span class="cm-number">1</span>, <span class="cm-builtin">math.floor</span>(<span class="cm-variable">self.m</span>))</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- print the modulus in the console, so that the user knows what it is</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">pd.post</span>(<span class="cm-builtin">string.format</span>(<span class="cm-string">"fibs: modulus %d"</span>, <span class="cm-variable">self.m</span>))</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">return</span> <span class="cm-keyword">true</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
 </span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">fibs</span>:<span class="cm-variable">in_1_bang</span>()</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- output the current pair in the conventional right-to-left order</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self</span>:<span class="cm-variable">outlet</span>(<span class="cm-number">2</span>, <span class="cm-string">"float"</span>, {<span class="cm-variable">self.b</span>})</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self</span>:<span class="cm-variable">outlet</span>(<span class="cm-number">1</span>, <span class="cm-string">"float"</span>, {<span class="cm-variable">self.a</span>})</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- calculate the next pair; note that it's sufficient to calculate the</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- remainder for the new number</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.a</span>, <span class="cm-variable">self.b</span> = <span class="cm-variable">self.b</span>, (<span class="cm-variable">self.a</span>+<span class="cm-variable">self.b</span>) % <span class="cm-variable">self.m</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
 </span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">fibs</span>:<span class="cm-variable">in_1_float</span>(<span class="cm-variable">m</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- a float input changes the modulus and resets the sequence</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.m</span> = <span class="cm-builtin">math.max</span>(<span class="cm-number">1</span>, <span class="cm-builtin">math.floor</span>(<span class="cm-variable">m</span>))</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.a</span>, <span class="cm-variable">self.b</span> = <span class="cm-number">0</span>, <span class="cm-number">1</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">pd.post</span>(<span class="cm-builtin">string.format</span>(<span class="cm-string">"fibs: modulus %d"</span>, <span class="cm-variable">self.m</span>))</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
-</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">fibs</span>:<span class="cm-variable">in_1_reset</span>()</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- a reset message just resets the sequence</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.a</span>, <span class="cm-variable">self.b</span> = <span class="cm-number">0</span>, <span class="cm-number">1</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 876px;"></div><div class="CodeMirror-gutters" style="display: none; height: 876px;"></div></div></div></pre><p><span>And here you can see the object running in a little test patch which outputs the two streams of Fibonacci notes to two different MIDI channels. The two streams can be enabled and disabled individually with the corresponding spigots, and you can also change the modulus on the fly.</span></p><p><img src="06-fibonacci.png" referrerpolicy="no-referrer" alt="Fibonacci example"></p><h2 id='using-arrays-and-tables'><span>Using arrays and tables</span></h2><p><span>Pd&#39;s arrays provide an efficient means to store possibly large vectors of float values. These are often used for sample data (waveforms) of a given size (the number of samples), but can also be employed to store copious amounts of numerical control data. Arrays are usually associated with a graphical display (called a </span><em><span>graph</span></em><span>), and Pd&#39;s table object lets you create an array along with a graph as a special kind of subpatch.</span></p><p><span>Pd-Lua provides </span><code>pd.Table</code><span> to represent array and table data, and a few functions to query and manipulate that data. This comes in handy, e.g., if you want to fill an array with a computed waveform. While Pd has its own corresponding facilities, complicated waveforms are often much easier to create in Lua, which offers a fairly complete set of basic mathematical functions in its standard library, and a whole lot more through 3rd party libraries such as </span><a href='https://github.com/michal-h21/numlua'><span>Numeric Lua</span></a><span>.</span></p><p><span>Here are the array/table functions provided by Pd-Lua. Note that like in Pd arrays, indices are zero-based and thus range from </span><code>0</code><span> to </span><code>tab:length()-1</code><span>.</span></p><ul><li><p><code>pd.Table:new():sync(name)</code><span>, short form: </span><code>pd.table(name)</code><span>: creates the Lua representation of a Pd array and associates it with the Pd array named </span><code>name</code><span>. This requires that an array or table of that name already exists (</span><code>sync</code><span> will </span><em><span>not</span></em><span> create it), otherwise the result is </span><code>nil</code><span>. You usually assign that value to a local variable (named </span><code>tab</code><span> below) to refer to it later.</span></p></li><li><p><code>tab:length()</code><span>: returns the length of </span><code>tab</code><span> (i.e., the number of samples in it)</span></p></li><li><p><code>tab:get(i)</code><span>: gets the sample at index </span><code>i</code><span> from </span><code>tab</code><span>; returns a number, or </span><code>nil</code><span> if the index runs past the table boundaries</span></p></li><li><p><code>tab:set(i, x)</code><span>: sets the sample at index </span><code>i</code><span> of </span><code>tab</code><span> to </span><code>x</code><span> (a number)</span></p></li><li><p><code>tab:redraw()</code><span>: redraws the graph of </span><code>tab</code><span>; you should call this once you&#39;re finished updating the table</span></p></li></ul><p><span>One important point worth mentioning here is that arrays and tables are subject to change at any time in Pd, as they may have their properties changed, be deleted, and recreated with new parameters. This means that you will have to call </span><code>pd.Table:new():sync(name)</code><span>, assign it to a local variable, and check that value </span><em><span>every</span></em><span> time you want to access the Pd array in a method.</span></p><p><span>Here is a simple example of a </span><code>luatab</code><span> object which takes the array name as a creation argument, and generates a waveform of the given frequency whenever a float value is received on the single inlet. After finishing generating the waveform, a bang message is output on the single outlet.</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua" style="break-inside: unset;"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51982px; left: 7.99336px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">local</span> <span class="cm-variable">luatab</span> = <span class="cm-variable">pd.Class</span>:<span class="cm-variable">new</span>():<span class="cm-variable">register</span>(<span class="cm-string">"luatab"</span>)</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
+</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">fibs</span>:<span class="cm-variable">in_1_reset</span>()</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- a reset message just resets the sequence</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.a</span>, <span class="cm-variable">self.b</span> = <span class="cm-number">0</span>, <span class="cm-number">1</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 875px;"></div><div class="CodeMirror-gutters" style="display: none; height: 875px;"></div></div></div></pre><p><span>And here you can see the object running in a little test patch which outputs the two streams of Fibonacci notes to two different MIDI channels. The two streams can be enabled and disabled individually with the corresponding spigots, and you can also change the modulus on the fly.</span></p><p><img src="06-fibonacci.png" referrerpolicy="no-referrer" alt="Fibonacci example"></p><h2 id='using-arrays-and-tables'><span>Using arrays and tables</span></h2><p><span>Pd&#39;s arrays provide an efficient means to store possibly large vectors of float values. These are often used for sample data (waveforms) of a given size (the number of samples), but can also be employed to store copious amounts of numerical control data. Arrays are usually associated with a graphical display (called a </span><em><span>graph</span></em><span>), and Pd&#39;s table object lets you create an array along with a graph as a special kind of subpatch.</span></p><p><span>Pd-Lua provides </span><code>pd.Table</code><span> to represent array and table data, and a few functions to query and manipulate that data. This comes in handy, e.g., if you want to fill an array with a computed waveform. While Pd has its own corresponding facilities, complicated waveforms are often much easier to create in Lua, which offers a fairly complete set of basic mathematical functions in its standard library, and a whole lot more through 3rd party libraries such as </span><a href='https://github.com/michal-h21/numlua'><span>Numeric Lua</span></a><span>.</span></p><p><span>Here are the array/table functions provided by Pd-Lua. Note that like in Pd arrays, indices are zero-based and thus range from </span><code>0</code><span> to </span><code>tab:length()-1</code><span>.</span></p><ul><li><p><code>pd.Table:new():sync(name)</code><span>, short form: </span><code>pd.table(name)</code><span>: creates the Lua representation of a Pd array and associates it with the Pd array named </span><code>name</code><span>. This requires that an array or table of that name already exists (</span><code>sync</code><span> will </span><em><span>not</span></em><span> create it), otherwise the result is </span><code>nil</code><span>. You usually assign that value to a local variable (named </span><code>tab</code><span> below) to refer to it later.</span></p></li><li><p><code>tab:length()</code><span>: returns the length of </span><code>tab</code><span> (i.e., the number of samples in it)</span></p></li><li><p><code>tab:get(i)</code><span>: gets the sample at index </span><code>i</code><span> from </span><code>tab</code><span>; returns a number, or </span><code>nil</code><span> if the index runs past the table boundaries</span></p></li><li><p><code>tab:set(i, x)</code><span>: sets the sample at index </span><code>i</code><span> of </span><code>tab</code><span> to </span><code>x</code><span> (a number)</span></p></li><li><p><code>tab:redraw()</code><span>: redraws the graph of </span><code>tab</code><span>; you should call this once you&#39;re finished updating the table</span></p></li></ul><p><span>One important point worth mentioning here is that arrays and tables are subject to change at any time in Pd, as they may have their properties changed, be deleted, and recreated with new parameters. This means that you will have to call </span><code>pd.Table:new():sync(name)</code><span>, assign it to a local variable, and check that value </span><em><span>every</span></em><span> time you want to access the Pd array in a method.</span></p><p><span>Here is a simple example of a </span><code>luatab</code><span> object which takes the array name as a creation argument, and generates a waveform of the given frequency whenever a float value is received on the single inlet. After finishing generating the waveform, a bang message is output on the single outlet.</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua" style="break-inside: unset;"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51801px; left: 7.98611px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">local</span> <span class="cm-variable">luatab</span> = <span class="cm-variable">pd.Class</span>:<span class="cm-variable">new</span>():<span class="cm-variable">register</span>(<span class="cm-string">"luatab"</span>)</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
 </span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">luatab</span>:<span class="cm-variable">initialize</span>(<span class="cm-variable">sel</span>, <span class="cm-variable">atoms</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- single inlet for the frequency, bang goes to the single outlet when we</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- finished generating a new waveform</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.inlets</span> = <span class="cm-number">1</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.outlets</span> = <span class="cm-number">1</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- the name of the array/table should be in the 1st creation argument</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">if</span> <span class="cm-builtin">type</span>(<span class="cm-variable">atoms</span>[<span class="cm-number">1</span>]) == <span class="cm-string">"string"</span> <span class="cm-keyword">then</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">self.tabname</span> = <span class="cm-variable">atoms</span>[<span class="cm-number">1</span>]</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-keyword">return</span> <span class="cm-keyword">true</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">else</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">self</span>:<span class="cm-builtin">error</span>(<span class="cm-builtin">string.format</span>(<span class="cm-string">"luatab: expected array name, got %s"</span>,</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class="cm-builtin">tostring</span>(<span class="cm-variable">atoms</span>[<span class="cm-number">1</span>])))</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-keyword">return</span> <span class="cm-keyword">false</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
-</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">luatab</span>:<span class="cm-variable">in_1_float</span>(<span class="cm-variable">freq</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">if</span> <span class="cm-builtin">type</span>(<span class="cm-variable">freq</span>) == <span class="cm-string">"number"</span> <span class="cm-keyword">then</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-comment">-- the waveform we want to compute, adjust this as needed</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-keyword">local</span> <span class="cm-keyword">function</span> <span class="cm-variable">f</span>(<span class="cm-variable">x</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp; &nbsp; <span class="cm-keyword">return</span> <span class="cm-builtin">math.sin</span>(<span class="cm-number">2</span>*<span class="cm-builtin">math.pi</span>*<span class="cm-variable">freq</span>*(<span class="cm-variable">x</span>+<span class="cm-number">1</span>))/(<span class="cm-variable">x</span>+<span class="cm-number">1</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-comment">-- get the Pd array and its length</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-keyword">local</span> <span class="cm-variable">t</span> = <span class="cm-variable">pd.Table</span>:<span class="cm-variable">new</span>():<span class="cm-variable">sync</span>(<span class="cm-variable">self.tabname</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-keyword">if</span> <span class="cm-variable">t</span> == <span class="cm-keyword">nil</span> <span class="cm-keyword">then</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp; &nbsp; <span class="cm-variable">self</span>:<span class="cm-builtin">error</span>(<span class="cm-builtin">string.format</span>(<span class="cm-string">"luatab: array or table %s not found"</span>,</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;<span class="cm-variable">self.tabname</span>))</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp; &nbsp; <span class="cm-keyword">return</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-keyword">local</span> <span class="cm-variable">l</span> = <span class="cm-variable">t</span>:<span class="cm-variable">length</span>()</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-comment">-- Pd array indices are zero-based</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-keyword">for</span> <span class="cm-variable">i</span> = <span class="cm-number">0</span>, <span class="cm-variable">l-1</span> <span class="cm-keyword">do</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp; &nbsp; <span class="cm-comment">-- normalize arguments to the 0-1 range</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp; &nbsp; <span class="cm-variable">t</span>:<span class="cm-variable">set</span>(<span class="cm-variable">i</span>, <span class="cm-variable">f</span>(<span class="cm-variable">i</span>/<span class="cm-variable">l</span>))</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-comment">-- this is needed to update the graph display</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">t</span>:<span class="cm-variable">redraw</span>()</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-comment">-- output a bang to indicate that we've generated a new waveform</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">self</span>:<span class="cm-variable">outlet</span>(<span class="cm-number">1</span>, <span class="cm-string">"bang"</span>, {})</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">else</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">self</span>:<span class="cm-builtin">error</span>(<span class="cm-builtin">string.format</span>(<span class="cm-string">"luatab: expected frequency, got %s"</span>,</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class="cm-builtin">tostring</span>(<span class="cm-variable">freq</span>)))</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 1060px;"></div><div class="CodeMirror-gutters" style="display: none; height: 1060px;"></div></div></div></pre><p><span>And here is a sample patch running the </span><code>luatab</code><span> object:</span></p><p><img src="07-table.png" referrerpolicy="no-referrer" alt="Table example"></p><p><span>In the same vein, the Pd-Lua distribution includes a much more comprehensive example ltabfill.pd_lua, which leverages Lua&#39;s </span><code>load</code><span> function to create a waveform from a user-specified Lua function created dynamically at runtime (instead of being hard-coded into the Lua code, which is what we did above).</span></p><h2 id='using-clocks'><span>Using clocks</span></h2><p><span>Clocks are used internally in Pd to implement objects which &quot;do things&quot; when a timeout occurs, such as delays, pipes, and metronomes. Pd-Lua exposes this functionality so that objects written in Lua can do the same. The following functions are provided:</span></p><ul><li><p><code>pd.Clock:new():register(self, method)</code><span>, short form </span><code>pd.clock(self, method)</code><span>: This creates a new clock for the Pd-Lua object </span><code>self</code><span> which, when it goes off, runs the method specified as a string </span><code>method</code><span>. Let&#39;s say that </span><code>method</code><span> is </span><code>&quot;trigger&quot;</code><span>, then </span><code>self:trigger()</code><span> will be called without arguments when the clock times out. You usually want to assign the result (a </span><code>pd.Clock</code><span> object) to a member variable of the object (called </span><code>self.clock</code><span> below), so that you can refer to it later.</span></p></li><li><p><code>self.clock:delay(time)</code><span>: sets the clock so that it will go off (and call the clock method) after </span><code>time</code><span> milliseconds</span></p></li><li><p><code>self.clock:set(systime)</code><span>: sets the clock so that it will go off at the specified absolute </span><code>systime</code><span> (measured in Pd time units of </span><code>pd.TIMEUNITPERMSEC</code><span>, see below)</span></p></li><li><p><code>self.clock:unset()</code><span>: unsets the clock, canceling any timeout that has been set previously</span></p></li><li><p><code>self.clock:destruct()</code><span>: destroys the clock</span></p></li></ul><hr /><p><strong><span>NOTE:</span></strong><span> Calling </span><code>self.clock:destruct()</code><span> on a clock that isn&#39;t needed any more (in the </span><code>finalize</code><span> method at the latest) used to be mandatory, and is still possible, but since 0.12.12 it is no longer necessary, as it also happens automatically when the target object gets deleted. This makes it now possible to have one-shot timers like </span><code>pd.Clock:new():register(self, &quot;oneshot&quot;):delay(1000)</code><span> which aren&#39;t assigned to any variable. (This is not recommended, though, if you want to maintain compatibility with earlier Pd-Lua versions.)</span></p><hr /><p><span>We mention in passing that you can call </span><code>self.clock:delay(time)</code><span> as soon as the clock has been created, even in the </span><code>initialize</code><span> method of an object. Furthermore, you can have as many clocks as you want in the same object, carrying out different actions, as long as you assign each clock to a different method.</span></p><p><span>Here is a little </span><code>tictoc</code><span> object we came up with for illustration purposes.</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua" style="break-inside: unset;"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51982px; left: 7.99336px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">local</span> <span class="cm-variable">tictoc</span> = <span class="cm-variable">pd.Class</span>:<span class="cm-variable">new</span>():<span class="cm-variable">register</span>(<span class="cm-string">"tictoc"</span>)</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
+</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">luatab</span>:<span class="cm-variable">in_1_float</span>(<span class="cm-variable">freq</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">if</span> <span class="cm-builtin">type</span>(<span class="cm-variable">freq</span>) == <span class="cm-string">"number"</span> <span class="cm-keyword">then</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-comment">-- the waveform we want to compute, adjust this as needed</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-keyword">local</span> <span class="cm-keyword">function</span> <span class="cm-variable">f</span>(<span class="cm-variable">x</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp; &nbsp; <span class="cm-keyword">return</span> <span class="cm-builtin">math.sin</span>(<span class="cm-number">2</span>*<span class="cm-builtin">math.pi</span>*<span class="cm-variable">freq</span>*(<span class="cm-variable">x</span>+<span class="cm-number">1</span>))/(<span class="cm-variable">x</span>+<span class="cm-number">1</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-comment">-- get the Pd array and its length</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-keyword">local</span> <span class="cm-variable">t</span> = <span class="cm-variable">pd.Table</span>:<span class="cm-variable">new</span>():<span class="cm-variable">sync</span>(<span class="cm-variable">self.tabname</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-keyword">if</span> <span class="cm-variable">t</span> == <span class="cm-keyword">nil</span> <span class="cm-keyword">then</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp; &nbsp; <span class="cm-variable">self</span>:<span class="cm-builtin">error</span>(<span class="cm-builtin">string.format</span>(<span class="cm-string">"luatab: array or table %s not found"</span>,</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;<span class="cm-variable">self.tabname</span>))</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp; &nbsp; <span class="cm-keyword">return</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-keyword">local</span> <span class="cm-variable">l</span> = <span class="cm-variable">t</span>:<span class="cm-variable">length</span>()</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-comment">-- Pd array indices are zero-based</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-keyword">for</span> <span class="cm-variable">i</span> = <span class="cm-number">0</span>, <span class="cm-variable">l-1</span> <span class="cm-keyword">do</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp; &nbsp; <span class="cm-comment">-- normalize arguments to the 0-1 range</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp; &nbsp; <span class="cm-variable">t</span>:<span class="cm-variable">set</span>(<span class="cm-variable">i</span>, <span class="cm-variable">f</span>(<span class="cm-variable">i</span>/<span class="cm-variable">l</span>))</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-comment">-- this is needed to update the graph display</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">t</span>:<span class="cm-variable">redraw</span>()</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-comment">-- output a bang to indicate that we've generated a new waveform</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">self</span>:<span class="cm-variable">outlet</span>(<span class="cm-number">1</span>, <span class="cm-string">"bang"</span>, {})</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">else</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">self</span>:<span class="cm-builtin">error</span>(<span class="cm-builtin">string.format</span>(<span class="cm-string">"luatab: expected frequency, got %s"</span>,</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class="cm-builtin">tostring</span>(<span class="cm-variable">freq</span>)))</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 1060px;"></div><div class="CodeMirror-gutters" style="display: none; height: 1060px;"></div></div></div></pre><p><span>And here is a sample patch running the </span><code>luatab</code><span> object:</span></p><p><img src="07-table.png" referrerpolicy="no-referrer" alt="Table example"></p><p><span>In the same vein, the Pd-Lua distribution includes a much more comprehensive example ltabfill.pd_lua, which leverages Lua&#39;s </span><code>load</code><span> function to create a waveform from a user-specified Lua function created dynamically at runtime (instead of being hard-coded into the Lua code, which is what we did above).</span></p><h2 id='using-clocks'><span>Using clocks</span></h2><p><span>Clocks are used internally in Pd to implement objects which &quot;do things&quot; when a timeout occurs, such as delays, pipes, and metronomes. Pd-Lua exposes this functionality so that objects written in Lua can do the same. The following functions are provided:</span></p><ul><li><p><code>pd.Clock:new():register(self, method)</code><span>, short form </span><code>pd.clock(self, method)</code><span>: This creates a new clock for the Pd-Lua object </span><code>self</code><span> which, when it goes off, runs the method specified as a string </span><code>method</code><span>. Let&#39;s say that </span><code>method</code><span> is </span><code>&quot;trigger&quot;</code><span>, then </span><code>self:trigger()</code><span> will be called without arguments when the clock times out. You usually want to assign the result (a </span><code>pd.Clock</code><span> object) to a member variable of the object (called </span><code>self.clock</code><span> below), so that you can refer to it later.</span></p></li><li><p><code>self.clock:delay(time)</code><span>: sets the clock so that it will go off (and call the clock method) after </span><code>time</code><span> milliseconds</span></p></li><li><p><code>self.clock:set(systime)</code><span>: sets the clock so that it will go off at the specified absolute </span><code>systime</code><span> (measured in Pd time units of </span><code>pd.TIMEUNITPERMSEC</code><span>, see below)</span></p></li><li><p><code>self.clock:unset()</code><span>: unsets the clock, canceling any timeout that has been set previously</span></p></li><li><p><code>self.clock:destruct()</code><span>: destroys the clock</span></p></li></ul><hr /><p><strong><span>NOTE:</span></strong><span> Calling </span><code>self.clock:destruct()</code><span> on a clock that isn&#39;t needed any more (in the </span><code>finalize</code><span> method at the latest) used to be mandatory, and is still possible, but since 0.12.12 it is no longer necessary, as it also happens automatically when the target object gets deleted. This makes it now possible to have one-shot timers like </span><code>pd.Clock:new():register(self, &quot;oneshot&quot;):delay(1000)</code><span> which aren&#39;t assigned to any variable. (This is not recommended, though, if you want to maintain compatibility with earlier Pd-Lua versions.)</span></p><hr /><p><span>We mention in passing that you can call </span><code>self.clock:delay(time)</code><span> as soon as the clock has been created, even in the </span><code>initialize</code><span> method of an object. Furthermore, you can have as many clocks as you want in the same object, carrying out different actions, as long as you assign each clock to a different method.</span></p><p><span>Here is a little </span><code>tictoc</code><span> object we came up with for illustration purposes.</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua" style="break-inside: unset;"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51801px; left: 7.98611px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">local</span> <span class="cm-variable">tictoc</span> = <span class="cm-variable">pd.Class</span>:<span class="cm-variable">new</span>():<span class="cm-variable">register</span>(<span class="cm-string">"tictoc"</span>)</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
 </span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">tictoc</span>:<span class="cm-variable">initialize</span>(<span class="cm-variable">sel</span>, <span class="cm-variable">atoms</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- inlet 1 takes an on/off flag, inlet 2 the delay time</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.inlets</span> = <span class="cm-number">2</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- bangs are output alternating between the two outlets</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.outlets</span> = <span class="cm-number">2</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- the delay time (optional creation argument, 1000 msec by default)</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.delay</span> = <span class="cm-builtin">type</span>(<span class="cm-variable">atoms</span>[<span class="cm-number">1</span>]) == <span class="cm-string">"number"</span> <span class="cm-keyword">and</span> <span class="cm-variable">atoms</span>[<span class="cm-number">1</span>] <span class="cm-keyword">or</span> <span class="cm-number">1000</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- we start out on the left outlet</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.left</span> = <span class="cm-keyword">true</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- initialize the clock</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.clock</span> = <span class="cm-variable">pd.Clock</span>:<span class="cm-variable">new</span>():<span class="cm-variable">register</span>(<span class="cm-variable">self</span>, <span class="cm-string">"tictoc"</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">return</span> <span class="cm-keyword">true</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
 </span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">tictoc</span>:<span class="cm-variable">finalize</span>()</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp;<span class="cm-variable">self.clock</span>:<span class="cm-variable">destruct</span>()</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
 </span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-comment">-- As with the metro object, nonzero, "bang" and "start" start the clock,</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-comment">-- zero and "stop" stop it.</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
@@ -735,42 +735,47 @@
 </span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-comment">-- set the delay (always in msec, we don't convert units)</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
 </span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">tictoc</span>:<span class="cm-variable">in_2_float</span>(<span class="cm-variable">delay</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- this will be picked up the next time the clock reschedules itself</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.delay</span> = <span class="cm-variable">delay</span> &gt;= <span class="cm-number">1</span> <span class="cm-keyword">and</span> <span class="cm-variable">delay</span> <span class="cm-keyword">or</span> <span class="cm-number">1</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
 </span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-comment">-- the clock method: tic, toc, tic, toc ...</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
-</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">tictoc</span>:<span class="cm-variable">tictoc</span>()</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- output a bang, alternate between left and right</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self</span>:<span class="cm-variable">outlet</span>(<span class="cm-variable">self.left</span> <span class="cm-keyword">and</span> <span class="cm-number">1</span> <span class="cm-keyword">or</span> <span class="cm-number">2</span>, <span class="cm-string">"bang"</span>, {})</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.left</span> = <span class="cm-keyword">not</span> <span class="cm-variable">self.left</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- reschedule</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.clock</span>:<span class="cm-variable">delay</span>(<span class="cm-variable">self.delay</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 1405px;"></div><div class="CodeMirror-gutters" style="display: none; height: 1405px;"></div></div></div></pre><p><span>And here is the usual test patch:</span></p><p><img src="08-clock.png" referrerpolicy="no-referrer" alt="Clock example"></p><p>&nbsp;</p><p><span>An explanation of </span><code>self.clock:set(systime)</code><span> is still in order. In contrast to </span><code>self.clock:delay(time)</code><span>, this schedules a timeout at the given </span><em><span>absolute</span></em><span> time given in </span><code>pd.TIMEUNITPERMSEC</code><span> units. This may be preferable in some situations, e.g., if you have to schedule some events that use increasing timestamps instead of delta times. Version 0.12.12 of Pd-Lua adds the </span><code>pd.TIMEUNITPERMSEC</code><span> constant and some support functions for dealing with these time values:</span></p><ul><li><p><code>pd.systime()</code><span>: Returns the current time in </span><code>pd.TIMEUNITPERMSEC</code><span> units. You can use this to derive a value for </span><code>self.clock:set</code><span>&#39;s </span><code>systime</code><span> argument. For instance, </span><code>self.clock:set(pd.systime() + time * pd.TIMEUNITPERMSEC)</code><span> is equivalent to </span><code>self.clock:delay(time)</code><span>.</span></p></li><li><p><code>pd.timesince(systime)</code><span>: Returns the time since the given </span><code>systime</code><span> in msec. You might use this to measure the time between two events, like Pd&#39;s built-in </span><code>timer</code><span> object does. In particular, </span><code>pd.timesince(0)</code><span> gives you the msec equivalent of  </span><code>pd.systime()</code><span>, i.e., Pd&#39;s current time in msec.</span></p></li></ul><p><span>Also note that the notion of time alluded to above is Pd&#39;s internal or </span><em><span>logical</span></em><span> time which always advances monotonically (until it wraps around) with each dsp tick, i.e., once per 64 samples with Pd&#39;s default block size setting.</span></p><p><span>More comprehensive examples using clocks can be found in the Pd-Lua distribution; have a look, e.g., at ldelay.pd_lua and luametro.pd_lua. Also, lpipe.pd_lua demonstrates how to dynamically create an entire collection of clocks in order to implement a delay line for a stream of messages.</span></p><h2 id='using-receivers'><span>Using receivers</span></h2><p><span>As every seasoned Pd user knows, Pd also enables you to transmit messages in a wireless fashion, using receiver symbols, or just </span><em><span>receivers</span></em><span> for short, as destination addresses. In Pd, this is done through the built-in </span><code>send</code><span> and </span><code>receive</code><span> objects, as well as the &quot;send&quot; and &quot;receive symbol&quot; properties of GUI objects.</span></p><p><span>Sending messages to a receiver is straightforward:</span></p><ul><li><p><code>pd.send(sym, sel, atoms)</code><span>: Sends a message with the given selector symbol </span><code>sel</code><span> (a string) and arguments </span><code>atoms</code><span> (a Lua table, which may be empty if the message has no arguments) to the given receiver </span><code>sym</code><span> (a string).</span></p></li></ul><p><span>This works pretty much like the </span><code>outlet</code><span> method, but outputs messages to the given receiver instead. For instance, let&#39;s say you have a toggle with receiver symbol </span><code>onoff</code><span> in your patch, then you can turn on that toggle with a call like </span><code>pd.send(&quot;onoff&quot;, &quot;float&quot;, {1})</code><span>. (Recall that the </span><code>atoms</code><span> argument always needs to be a table, even if it is a singleton, lest you&#39;ll get that &quot;invalid atoms table&quot; error that we discussed earlier).</span></p><p><span>One complication are receiver symbols using a </span><code>$0-</code><span> patch id prefix, which are commonly used to differentiate receiver symbols in different toplevel patches or abstractions, in order to prevent name clashes. A Pd-Lua object doesn&#39;t have any idea of what toplevel patch it is located in, and what the numeric id of that patch is, so you&#39;ll have to expand the </span><code>$0-</code><span> prefix on the Pd side and pass it, e.g., as a creation argument. For instance, suppose that the toggle receiver is in fact named </span><code>$0-onoff</code><span>, then something like the following Pd-Lua object will do the trick, if you invoke it as </span><code>luasend $0-onoff</code><span>:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51982px; left: 7.99336px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">local</span> <span class="cm-variable">luasend</span> = <span class="cm-variable">pd.Class</span>:<span class="cm-variable">new</span>():<span class="cm-variable">register</span>(<span class="cm-string">"luasend"</span>)</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
+</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">tictoc</span>:<span class="cm-variable">tictoc</span>()</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- output a bang, alternate between left and right</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self</span>:<span class="cm-variable">outlet</span>(<span class="cm-variable">self.left</span> <span class="cm-keyword">and</span> <span class="cm-number">1</span> <span class="cm-keyword">or</span> <span class="cm-number">2</span>, <span class="cm-string">"bang"</span>, {})</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.left</span> = <span class="cm-keyword">not</span> <span class="cm-variable">self.left</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- reschedule</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.clock</span>:<span class="cm-variable">delay</span>(<span class="cm-variable">self.delay</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 1405px;"></div><div class="CodeMirror-gutters" style="display: none; height: 1405px;"></div></div></div></pre><p><span>And here is the usual test patch:</span></p><p><img src="08-clock.png" referrerpolicy="no-referrer" alt="Clock example"></p><p>&nbsp;</p><p><span>An explanation of </span><code>self.clock:set(systime)</code><span> is still in order. In contrast to </span><code>self.clock:delay(time)</code><span>, this schedules a timeout at the given </span><em><span>absolute</span></em><span> time given in </span><code>pd.TIMEUNITPERMSEC</code><span> units. This may be preferable in some situations, e.g., if you have to schedule some events that use increasing timestamps instead of delta times. Version 0.12.12 of Pd-Lua adds the </span><code>pd.TIMEUNITPERMSEC</code><span> constant and some support functions for dealing with these time values:</span></p><ul><li><p><code>pd.systime()</code><span>: Returns the current time in </span><code>pd.TIMEUNITPERMSEC</code><span> units. You can use this to derive a value for </span><code>self.clock:set</code><span>&#39;s </span><code>systime</code><span> argument. For instance, </span><code>self.clock:set(pd.systime() + time * pd.TIMEUNITPERMSEC)</code><span> is equivalent to </span><code>self.clock:delay(time)</code><span>.</span></p></li><li><p><code>pd.timesince(systime)</code><span>: Returns the time since the given </span><code>systime</code><span> in msec. You might use this to measure the time between two events, like Pd&#39;s built-in </span><code>timer</code><span> object does. In particular, </span><code>pd.timesince(0)</code><span> gives you the msec equivalent of  </span><code>pd.systime()</code><span>, i.e., Pd&#39;s current time in msec.</span></p></li></ul><p><span>Also note that the notion of time alluded to above is Pd&#39;s internal or </span><em><span>logical</span></em><span> time which always advances monotonically (until it wraps around) with each dsp tick, i.e., once per 64 samples with Pd&#39;s default block size setting.</span></p><p><span>More comprehensive examples using clocks can be found in the Pd-Lua distribution; have a look, e.g., at ldelay.pd_lua and luametro.pd_lua. Also, lpipe.pd_lua demonstrates how to dynamically create an entire collection of clocks in order to implement a delay line for a stream of messages.</span></p><h2 id='using-receivers'><span>Using receivers</span></h2><p><span>As every seasoned Pd user knows, Pd also enables you to transmit messages in a wireless fashion, using receiver symbols, or just </span><em><span>receivers</span></em><span> for short, as destination addresses. In Pd, this is done through the built-in </span><code>send</code><span> and </span><code>receive</code><span> objects, as well as the &quot;send&quot; and &quot;receive symbol&quot; properties of GUI objects.</span></p><p><span>Sending messages to a receiver is straightforward:</span></p><ul><li><p><code>pd.send(sym, sel, atoms)</code><span>: Sends a message with the given selector symbol </span><code>sel</code><span> (a string) and arguments </span><code>atoms</code><span> (a Lua table, which may be empty if the message has no arguments) to the given receiver </span><code>sym</code><span> (a string).</span></p></li></ul><p><span>This works pretty much like the </span><code>outlet</code><span> method, but outputs messages to the given receiver instead. For instance, let&#39;s say you have a toggle with receiver symbol </span><code>onoff</code><span> in your patch, then you can turn on that toggle with a call like </span><code>pd.send(&quot;onoff&quot;, &quot;float&quot;, {1})</code><span>. (Recall that the </span><code>atoms</code><span> argument always needs to be a table, even if it is a singleton, lest you&#39;ll get that &quot;invalid atoms table&quot; error that we discussed earlier).</span></p><p><span>One complication are receiver symbols using a </span><code>$0-</code><span> patch id prefix, which are commonly used to differentiate receiver symbols in different toplevel patches or abstractions, in order to prevent name clashes. For instance, suppose that the toggle receiver is in fact named </span><code>$0-onoff</code><span>, then something like the following Pd-Lua object will do the trick, if you invoke it as </span><code>luasend $0-onoff</code><span>:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51801px; left: 7.98611px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">local</span> <span class="cm-variable">luasend</span> = <span class="cm-variable">pd.Class</span>:<span class="cm-variable">new</span>():<span class="cm-variable">register</span>(<span class="cm-string">"luasend"</span>)</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
 </span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">luasend</span>:<span class="cm-variable">initialize</span>(<span class="cm-variable">sel</span>, <span class="cm-variable">atoms</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.inlets</span> = <span class="cm-number">1</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.receiver</span> = <span class="cm-builtin">tostring</span>(<span class="cm-variable">atoms</span>[<span class="cm-number">1</span>])</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">return</span> <span class="cm-keyword">true</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
-</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">luasend</span>:<span class="cm-variable">in_1_bang</span>()</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">pd.send</span>(<span class="cm-variable">self.receiver</span>, <span class="cm-string">"float"</span>, {<span class="cm-number">1</span>})</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 253px;"></div><div class="CodeMirror-gutters" style="display: none; height: 253px;"></div></div></div></pre><p><span>Of course, this also handles ordinary receive symbols just fine if you pass them as a creation argument. Here is a little test patch showing </span><code>luasend</code><span> in action:</span></p><p><img src="09-send.png" referrerpolicy="no-referrer" alt="Send example"></p><p><span>It is worth noting here that the same technique applies whenever you need to pass on &quot;$&quot; arguments to a Pd-Lua object in a Pd abstraction.</span></p><p><span>So let&#39;s have a look at receivers now. These work pretty much like clocks in that you create them registering a method, and destroy them when they are no longer needed:</span></p><ul><li><p><code>pd.Receive:new():register(self, sym, method)</code><span>, short form </span><code>pd.receive(self, sym, method)</code><span>: This creates a new receiver named </span><code>sym</code><span> (a string) for the Pd-Lua object </span><code>self</code><span> which, when a message for that receiver becomes available, runs the method specified as a string </span><code>method</code><span>. Let&#39;s say that </span><code>method</code><span> is </span><code>&quot;receive&quot;</code><span>, then </span><code>self:receive(sel, atoms)</code><span> will be invoked with the selector symbol </span><code>sel</code><span> and arguments </span><code>atoms</code><span> of the transmitted message. You want to assign the result (a </span><code>pd.Receive</code><span> object) to a member variable of the object (called </span><code>self.recv</code><span> below), so that you can refer to it later (if only to destroy it, see below).</span></p></li><li><p><code>self.recv:destruct()</code><span>: destroys the receiver (as with clocks, this is now entirely optional, but it may still be useful if the receiver needs to be removed before its target object ceases to be)</span></p></li></ul><p><span>Here is a little example which receives any kind of message, stores it, and outputs the last stored message when it gets a </span><code>bang</code><span> on its inlet.</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua" style="break-inside: unset;"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51982px; left: 7.99336px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">local</span> <span class="cm-variable">luarecv</span> = <span class="cm-variable">pd.Class</span>:<span class="cm-variable">new</span>():<span class="cm-variable">register</span>(<span class="cm-string">"luarecv"</span>)</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
+</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">luasend</span>:<span class="cm-variable">in_1_bang</span>()</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">pd.send</span>(<span class="cm-variable">self.receiver</span>, <span class="cm-string">"float"</span>, {<span class="cm-number">1</span>})</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 253px;"></div><div class="CodeMirror-gutters" style="display: none; height: 253px;"></div></div></div></pre><p><span>Of course, this also handles ordinary receive symbols just fine if you pass them as a creation argument. Here is a little test patch showing </span><code>luasend</code><span> in action:</span></p><p><img src="09-send.png" referrerpolicy="no-referrer" alt="Send example"></p><hr /><p><strong><span>NOTE:</span></strong><span> The same technique applies whenever you need to pass on &quot;$&quot; arguments to a Pd-Lua object in a Pd abstraction. This also works in older Pd-Lua versions. However, since Pd-Lua 0.12.17 there&#39;s also the possibility to expand such &quot;$&quot; symbols directly in Lua, see </span><a href='#expanding-dollar-symbols'><span>Expanding dollar symbols</span></a><span> below.</span></p><hr /><p><span>So let&#39;s have a look at receivers now. These work pretty much like clocks in that you create them registering a method, and destroy them when they are no longer needed:</span></p><ul><li><p><code>pd.Receive:new():register(self, sym, method)</code><span>, short form </span><code>pd.receive(self, sym, method)</code><span>: This creates a new receiver named </span><code>sym</code><span> (a string) for the Pd-Lua object </span><code>self</code><span> which, when a message for that receiver becomes available, runs the method specified as a string </span><code>method</code><span>. Let&#39;s say that </span><code>method</code><span> is </span><code>&quot;receive&quot;</code><span>, then </span><code>self:receive(sel, atoms)</code><span> will be invoked with the selector symbol </span><code>sel</code><span> and arguments </span><code>atoms</code><span> of the transmitted message. You want to assign the result (a </span><code>pd.Receive</code><span> object) to a member variable of the object (called </span><code>self.recv</code><span> below), so that you can refer to it later (if only to destroy it, see below).</span></p></li><li><p><code>self.recv:destruct()</code><span>: destroys the receiver (as with clocks, this is now entirely optional, but it may still be useful if the receiver needs to be removed before its target object ceases to be)</span></p></li></ul><p><span>Here is a little example which receives any kind of message, stores it, and outputs the last stored message when it gets a </span><code>bang</code><span> on its inlet.</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua" style="break-inside: unset;"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51801px; left: 7.98611px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">local</span> <span class="cm-variable">luarecv</span> = <span class="cm-variable">pd.Class</span>:<span class="cm-variable">new</span>():<span class="cm-variable">register</span>(<span class="cm-string">"luarecv"</span>)</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
 </span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">luarecv</span>:<span class="cm-variable">initialize</span>(<span class="cm-variable">sel</span>, <span class="cm-variable">atoms</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.inlets</span> = <span class="cm-number">1</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.outlets</span> = <span class="cm-number">1</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- pass the receiver symbol as creation argument</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">local</span> <span class="cm-variable">sym</span> = <span class="cm-builtin">tostring</span>(<span class="cm-variable">atoms</span>[<span class="cm-number">1</span>])</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">pd.post</span>(<span class="cm-builtin">string.format</span>(<span class="cm-string">"luarecv: receiver '%s'"</span>, <span class="cm-variable">sym</span>))</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- create the receiver</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.recv</span> = <span class="cm-variable">pd.Receive</span>:<span class="cm-variable">new</span>():<span class="cm-variable">register</span>(<span class="cm-variable">self</span>, <span class="cm-variable">sym</span>, <span class="cm-string">"receive"</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">return</span> <span class="cm-keyword">true</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
 </span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">luarecv</span>:<span class="cm-variable">finalize</span>()</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.recv</span>:<span class="cm-variable">destruct</span>()</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
 </span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">luarecv</span>:<span class="cm-variable">receive</span>(<span class="cm-variable">sel</span>, <span class="cm-variable">atoms</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- simply store the message, so that we can output it later</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.sel</span>, <span class="cm-variable">self.atoms</span> = <span class="cm-variable">sel</span>, <span class="cm-variable">atoms</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">pd.post</span>(<span class="cm-builtin">string.format</span>(<span class="cm-string">"luarecv: got '%s %s'"</span>, <span class="cm-variable">sel</span>,</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class="cm-builtin">table.concat</span>(<span class="cm-variable">atoms</span>, <span class="cm-string">" "</span>)))</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
-</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">luarecv</span>:<span class="cm-variable">in_1_bang</span>()</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- output the last message we received (if any)</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">if</span> <span class="cm-variable">self.sel</span> <span class="cm-keyword">then</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">self</span>:<span class="cm-variable">outlet</span>(<span class="cm-number">1</span>, <span class="cm-variable">self.sel</span>, <span class="cm-variable">self.atoms</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 691px;"></div><div class="CodeMirror-gutters" style="display: none; height: 691px;"></div></div></div></pre><p><span>The obligatory test patch:</span></p><p><img src="10-receive.png" referrerpolicy="no-referrer" alt="Receive example"></p><h2 id='signals-and-graphics'><span>Signals and graphics</span></h2><p><span>So far all of our examples only did control processing, which is what Pd-Lua was originally designed for. But thanks to the work of Timothy Schoen (the creator and main developer of </span><a href='https://plugdata.org/'><span>plugdata</span></a><span>), as of version 0.12.0 Pd-Lua also provides facilities for audio signal processing and graphics. It goes without saying that these capabilities vastly extend the scope of Pd-Lua applications, as you can now program pretty much any kind of Pd object in Lua, covering both signal and control processing, as well as custom GUI objects. We&#39;ll first discuss how to write a signal processing (a.k.a. dsp) object in Pd-Lua, and then go on to show the implementation of a simple GUI object using the graphics API.</span></p><hr /><p><strong><span>NOTE:</span></strong><span> As these features are still fairly new, some details of the implementation may still be subject to change in future Pd-Lua versions. Also, we can&#39;t cover all the details here, so we recommend having a look at the examples included in the Pd-Lua distribution. You can find these under pdlua/examples in the source or in the help browser. Specifically, check the sig-example folder for another example illustrating the use of signal inlets and outlets, and Benjamin Wesch&#39;s </span><a href='https://github.com/ben-wes/scope3d-'><span>osci3d~</span></a><span> which shows how to implement a 3d oscilloscope employing both signal processing and graphics.</span></p><hr /><h3 id='signals'><span>Signals</span></h3><p><span>Enabling signal processing in a Pd-Lua object involves three ingredients:</span></p><ol start='' ><li><p><strong><span>Adding signal inlets and outlets:</span></strong><span> As before, this is done by setting the </span><code>inlets</code><span> and </span><code>outlets</code><span> member variables in the </span><code>initialize</code><span> method. But instead of setting each variable to just a number, you specify a </span><em><span>signature</span></em><span>, which is a table indicating the signal and control in- and outlets with the special </span><code>SIGNAL</code><span> and </span><code>DATA</code><span> values. The number of in- and outlets is then given by the size of these tables. Thus, e.g., you&#39;d use </span><code>self.inlets = { SIGNAL, SIGNAL, DATA }</code><span> if you need two signal and one control data inlet, in that order. Note that a number as the value of </span><code>inlets</code><span> or </span><code>outlets</code><span> corresponds to a signature with just </span><code>DATA</code><span> values in it.</span></p></li><li><p><strong><span>Adding a dsp method:</span></strong><span> This step is optional. The </span><code>dsp</code><span> method gets invoked whenever signal processing is turned on in Pd, passing two parameters: </span><code>samplerate</code><span> and </span><code>blocksize</code><span>. The former tells you about the sample rate (number of audio samples per second) Pd runs at, which will be useful if your object needs to translate time and frequency values from physical units (i.e., seconds, milliseconds, and Hz) to sample-based time and frequency values, so usually you want to store the given value in a member variable of your object. The latter specifies the block size, i.e., the number of samples Pd expects to be processed during each call of the </span><code>perform</code><span> method (see below). You only need to store that number if your object doesn&#39;t have any signal inlets, so that you know how many samples need to be generated. Otherwise the block size can also be inferred from the size of the </span><code>in</code><span> tables passed to the </span><code>perform</code><span> method. Adding the </span><code>dsp</code><span> method is optional. You only have to define it if the signal and control data processing in your object requires the </span><code>samplerate</code><span> and </span><code>blocksize</code><span> values, or if you need to be notified when dsp processing gets turned on for some other reason.</span></p></li><li><p><strong><span>Adding a perform method:</span></strong><span> This method is where the actual signal processing happens. It receives blocks of signal data from the inlets through its arguments, where each block is represented as a Lua table containing floating point sample values. The method then needs to return a tuple of similar Lua tables with the blocks of signal data for each outlet. Note that the number of </span><em><span>arguments</span></em><span> of the method matches the number of signal </span><em><span>inlets</span></em><span>, while the number of </span><em><span>return values</span></em><span> corresponds to the number of signal </span><em><span>outlets</span></em><span>. The </span><code>perform</code><span> method is </span><em><span>not</span></em><span> optional; if your object outputs any signal data, the method needs to be implemented, otherwise you&#39;ll get a </span><code>perform: function should return a table</code><span> or similar error in the Pd console as soon as you turn on dsp processing.</span></p></li></ol><p><span>In addition to the </span><code>dsp</code><span> and </span><code>perform</code><span> methods, your object may contain any number of methods doing the usual control data processing on the </span><code>DATA</code><span> inlets. It is also possible to receive control data on the </span><code>SIGNAL</code><span> inlets; however, you won&#39;t be able to receive </span><code>float</code><span> messages, because they will be interpreted as constant signals which get passed as blocks of signal data to the </span><code>perform</code><span> method instead.</span></p><h4 id='example-1-mixing-signals'><span>Example 1: Mixing signals</span></h4><p><span>Let&#39;s take a look at a few simple examples illustrating the kind of processing the </span><code>perform</code><span> method might do. First, let&#39;s mix two signals (stereo input) down to a single (mono) output by computing the average of corresponding samples. We need two signal inlets and one signal outlet, so our </span><code>initialize</code><span> method looks like this:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51982px; left: 7.99336px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">local</span> <span class="cm-variable">foo</span> = <span class="cm-variable">pd.Class</span>:<span class="cm-variable">new</span>():<span class="cm-variable">register</span>(<span class="cm-string">"foo"</span>)</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
-</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">foo</span>:<span class="cm-variable">initialize</span>(<span class="cm-variable">sel</span>, <span class="cm-variable">atoms</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.inlets</span> = {<span class="cm-variable">SIGNAL</span>,<span class="cm-variable">SIGNAL</span>}</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.outlets</span> = {<span class="cm-variable">SIGNAL</span>}</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">return</span> <span class="cm-keyword">true</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 161px;"></div><div class="CodeMirror-gutters" style="display: none; height: 161px;"></div></div></div></pre><p><span>And here&#39;s the </span><code>perform</code><span> method (in this simple example we don&#39;t need </span><code>foo:dsp()</code><span>):</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51982px; left: 7.99336px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">foo</span>:<span class="cm-variable">perform</span>(<span class="cm-variable">in1</span>, <span class="cm-variable">in2</span>)</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">for</span> <span class="cm-variable">i</span> = <span class="cm-number">1</span>, #<span class="cm-variable">in1</span> <span class="cm-keyword">do</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">in1</span>[<span class="cm-variable">i</span>] = (<span class="cm-variable">in1</span>[<span class="cm-variable">i</span>]+<span class="cm-variable">in2</span>[<span class="cm-variable">i</span>])/<span class="cm-number">2</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">return</span> <span class="cm-variable">in1</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 138px;"></div><div class="CodeMirror-gutters" style="display: none; height: 138px;"></div></div></div></pre><p><span>Note that here we replaced the signal data in the </span><code>in1</code><span> table with the result, so we simply return the modified </span><code>in1</code><span> signal; no need to create a third </span><code>out</code><span> table. (This is safe because it won&#39;t actually modify any signal data outside the Lua method.)</span></p><p><span>Easy enough. And this is how this object works in a little test patch:</span></p><p><img src="17-signal1.png" referrerpolicy="no-referrer" alt="Mixing signals"></p><h4 id='example-2-analyzing-a-signal'><span>Example 2: Analyzing a signal</span></h4><p><span>A dsp object can also have no signal outlets at all if you just want to process the incoming signal data in some way and output the result through a normal control outlet. E.g., here&#39;s one (rather simplistic) way to compute the rms (</span><a href='https://en.wikipedia.org/wiki/Root_mean_square'><span>root mean square</span></a><span>) envelope of a signal as control data:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua" style="break-inside: unset;"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51982px; left: 7.99336px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">foo</span>:<span class="cm-variable">initialize</span>(<span class="cm-variable">sel</span>, <span class="cm-variable">atoms</span>)</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.inlets</span> = {<span class="cm-variable">SIGNAL</span>}</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.outlets</span> = {<span class="cm-variable">DATA</span>}</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">return</span> <span class="cm-keyword">true</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
-</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">foo</span>:<span class="cm-variable">perform</span>(<span class="cm-variable">in1</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">local</span> <span class="cm-variable">rms</span> = <span class="cm-number">0</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">for</span> <span class="cm-variable">i</span> = <span class="cm-number">1</span>, #<span class="cm-variable">in1</span> <span class="cm-keyword">do</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">rms</span> = <span class="cm-variable">rms</span> + <span class="cm-variable">in1</span>[<span class="cm-variable">i</span>]*<span class="cm-variable">in1</span>[<span class="cm-variable">i</span>]</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">rms</span> = <span class="cm-builtin">math.sqrt</span>(<span class="cm-variable">rms</span>/#<span class="cm-variable">in1</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self</span>:<span class="cm-variable">outlet</span>(<span class="cm-number">1</span>, <span class="cm-string">"float"</span>, {<span class="cm-variable">rms</span>})</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 323px;"></div><div class="CodeMirror-gutters" style="display: none; height: 323px;"></div></div></div></pre><p><span>A little test patch:</span></p><p><img src="17-signal2.png" referrerpolicy="no-referrer" alt="Analyzing a signal"></p><h4 id='example-3-generating-a-signal'><span>Example 3: Generating a signal</span></h4><p><span>Conversely, we can also have an object which converts control inputs into signal data, such as this little oscillator object which produces a sine wave:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua" style="break-inside: unset;"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51982px; left: 7.99336px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">foo</span>:<span class="cm-variable">initialize</span>(<span class="cm-variable">sel</span>, <span class="cm-variable">atoms</span>)</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.inlets</span> = {<span class="cm-variable">DATA</span>}</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.outlets</span> = {<span class="cm-variable">SIGNAL</span>}</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.phase</span> = <span class="cm-number">0</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.freq</span> = <span class="cm-number">220</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.amp</span> = <span class="cm-number">0.5</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">return</span> <span class="cm-keyword">true</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
+</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">luarecv</span>:<span class="cm-variable">in_1_bang</span>()</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- output the last message we received (if any)</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">if</span> <span class="cm-variable">self.sel</span> <span class="cm-keyword">then</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">self</span>:<span class="cm-variable">outlet</span>(<span class="cm-number">1</span>, <span class="cm-variable">self.sel</span>, <span class="cm-variable">self.atoms</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 691px;"></div><div class="CodeMirror-gutters" style="display: none; height: 691px;"></div></div></div></pre><p><span>The obligatory test patch:</span></p><p><img src="10-receive.png" referrerpolicy="no-referrer" alt="Receive example"></p><h3 id='expanding-dollar-symbols'><span>Expanding dollar symbols</span></h3><p><span>Some more in-depth information about dollar symbols and their use in Lua is in order. Specifically, we will discuss two new Pd-Lua object methods, </span><code>canvas_realizedollar()</code><span> (available since Pd-Lua 0.12.17) and  </span><code>set_args()</code><span> (available since Pd-Lua 0.12.0) which help you manage your receiver and sender symbols. In this use case, you will typically use quoted symbols like </span><code>\$0-foo</code><span>, so that your object receives the symbol unexpanded, which requires some facilities to expand such symbols in Lua, and maybe also record the unexpanded symbols in the object&#39;s creation arguments. These helper methods are technically considered part of Pd-Lua&#39;s graphics API (see </span><a href='#graphics'><span>Graphics</span></a><span> below) since they are often used for graphics objects. But they both work just as well with ordinary (non-graphical) Lua objects, and they come in handy here, so that we introduce them now:</span></p><ul><li><p><code>self:canvas_realizedollar(symbol)</code><span>: Expand &quot;$&quot; symbols in the </span><code>symbol</code><span> string argument and return the resulting string.</span></p></li><li><p><code>self:set_args(atoms)</code><span>: Set the given list of numbers and strings </span><code>atoms</code><span> as the object&#39;s creation arguments. (Note that the new argument list doesn&#39;t become visible on the canvas until you edit, copy, or duplicate the modified object.)</span></p></li></ul><p><span>To explain how these two work in concert, let&#39;s go back to the basics first. As mentioned above, the patch id </span><code>$0</code><span> is widely used in Pd for send and receive names to avoid conflicts with other receivers and senders of similar names. Pd expands </span><code>$0</code><span> to the canvas id, which differs for every open patch, and it expands </span><code>$1</code><span>, </span><code>$2</code><span> etc. if the corresponding creation arguments are set in the context of an abstraction or clone instance. (Also note that in Purr Data there is another </span><code>$@</code><span> symbol which expands to the list of all creation arguments.)</span></p><p><span>If you set the sender or receiver names for your Pd-Lua object as </span><em><span>creation arguments</span></em><span> of the object, Pd automatically expands them for you as discussed above. But if you want to set them through </span><em><span>messages</span></em><span> to the object, you will often use a quoted symbol like </span><code>\$0-foo</code><span>, so that your object receives the symbol unexpanded. You&#39;ve probably seen this before, as it is also common practice, e.g., with Pd&#39;s GUI objects like sliders, radio buttons, etc. (check the escaping-characters subpatch of the message help patch for some examples).</span></p><p><span>Quoting dollar symbols in this way offers the advantage that you can record the &quot;$&quot; symbol itself (rather than its expansion) in the object&#39;s properties (in the case of Pd GUI objects) or in its creation arguments (as can be done with Pd-Lua&#39;s </span><code>set_args()</code><span> method). But of course this means that if you want to use the actual receiver symbol in your Lua object then you need to expand the symbol in Lua (which is what the </span><code>canvas_realizedollar()</code><span> method is for).</span></p><p><span>Here&#39;s a simple example illustrating this:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua" style="break-inside: unset;"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51801px; left: 7.98611px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><span><span>​</span>x</span></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">local</span> <span class="cm-variable">localsend</span> = <span class="cm-variable">pd.Class</span>:<span class="cm-variable">new</span>():<span class="cm-variable">register</span>(<span class="cm-string">"localsend"</span>)</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
+</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">localsend</span>:<span class="cm-variable">initialize</span>(<span class="cm-variable">sel</span>, <span class="cm-variable">atoms</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.inlets</span> = <span class="cm-number">1</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- pass the symbol from the creation argument,</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- which gets automatically expanded here</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.sender</span> = <span class="cm-builtin">tostring</span>(<span class="cm-variable">atoms</span>[<span class="cm-number">1</span>])</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">return</span> <span class="cm-keyword">true</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
+</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">localsend</span>:<span class="cm-variable">in_1_sender</span>(<span class="cm-variable">x</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">local</span> <span class="cm-variable">sendername</span> = <span class="cm-builtin">tostring</span>(<span class="cm-variable">x</span>[<span class="cm-number">1</span>])</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
+</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- store the original name as argument (like "\$0-foo")</span></span></pre><div class="" style="position: relative;"><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self</span>:<span class="cm-variable">set_args</span>({<span class="cm-variable">sendername</span>})</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
+</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- apply the expanded name with the local id</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.sender</span> = <span class="cm-variable">self</span>:<span class="cm-variable">canvas_realizedollar</span>(<span class="cm-variable">sendername</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
+</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">localsend</span>:<span class="cm-variable">in_1_bang</span>()</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">pd.send</span>(<span class="cm-variable">self.sender</span>, <span class="cm-string">"float"</span>, {<span class="cm-number">1</span>})</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 530px;"></div><div class="CodeMirror-gutters" style="display: none; height: 530px;"></div></div></div></pre><p><span>And here&#39;s a test patch from the tutorial examples which shows this object in action:</span></p><p><img src="19-dollar-symbols.png" referrerpolicy="no-referrer" alt="Dollar symbol example"></p><h2 id='signals-and-graphics'><span>Signals and graphics</span></h2><p><span>So far all of our examples only did control processing, which is what Pd-Lua was originally designed for. But thanks to the work of Timothy Schoen (the creator and main developer of </span><a href='https://plugdata.org/'><span>plugdata</span></a><span>), as of version 0.12.0 Pd-Lua also provides facilities for audio signal processing and graphics. It goes without saying that these capabilities vastly extend the scope of Pd-Lua applications, as you can now program pretty much any kind of Pd object in Lua, covering both signal and control processing, as well as custom GUI objects. We&#39;ll first discuss how to write a signal processing (a.k.a. dsp) object in Pd-Lua, and then go on to show the implementation of a simple GUI object using the graphics API.</span></p><hr /><p><strong><span>NOTE:</span></strong><span> As these features are still fairly new, some details of the implementation may still be subject to change in future Pd-Lua versions. Also, we can&#39;t cover all the details here, so we recommend having a look at the examples included in the Pd-Lua distribution. You can find these under pdlua/examples in the source or in the help browser. Specifically, check the sig-example folder for another example illustrating the use of signal inlets and outlets, and Benjamin Wesch&#39;s </span><a href='https://github.com/ben-wes/scope3d-'><span>osci3d~</span></a><span> which shows how to implement a 3d oscilloscope employing both signal processing and graphics.</span></p><hr /><h3 id='signals'><span>Signals</span></h3><p><span>Enabling signal processing in a Pd-Lua object involves three ingredients:</span></p><ol start='' ><li><p><strong><span>Adding signal inlets and outlets:</span></strong><span> As before, this is done by setting the </span><code>inlets</code><span> and </span><code>outlets</code><span> member variables in the </span><code>initialize</code><span> method. But instead of setting each variable to just a number, you specify a </span><em><span>signature</span></em><span>, which is a table indicating the signal and control in- and outlets with the special </span><code>SIGNAL</code><span> and </span><code>DATA</code><span> values. The number of in- and outlets is then given by the size of these tables. Thus, e.g., you&#39;d use </span><code>self.inlets = { SIGNAL, SIGNAL, DATA }</code><span> if you need two signal and one control data inlet, in that order. Note that a number as the value of </span><code>inlets</code><span> or </span><code>outlets</code><span> corresponds to a signature with just </span><code>DATA</code><span> values in it.</span></p></li><li><p><strong><span>Adding a dsp method:</span></strong><span> This step is optional. The </span><code>dsp</code><span> method gets invoked whenever signal processing is turned on in Pd, passing two parameters: </span><code>samplerate</code><span> and </span><code>blocksize</code><span>. The former tells you about the sample rate (number of audio samples per second) Pd runs at, which will be useful if your object needs to translate time and frequency values from physical units (i.e., seconds, milliseconds, and Hz) to sample-based time and frequency values, so usually you want to store the given value in a member variable of your object. The latter specifies the block size, i.e., the number of samples Pd expects to be processed during each call of the </span><code>perform</code><span> method (see below). You only need to store that number if your object doesn&#39;t have any signal inlets, so that you know how many samples need to be generated. Otherwise the block size can also be inferred from the size of the </span><code>in</code><span> tables passed to the </span><code>perform</code><span> method. Adding the </span><code>dsp</code><span> method is optional. You only have to define it if the signal and control data processing in your object requires the </span><code>samplerate</code><span> and </span><code>blocksize</code><span> values, or if you need to be notified when dsp processing gets turned on for some other reason.</span></p></li><li><p><strong><span>Adding a perform method:</span></strong><span> This method is where the actual signal processing happens. It receives blocks of signal data from the inlets through its arguments, where each block is represented as a Lua table containing floating point sample values. The method then needs to return a tuple of similar Lua tables with the blocks of signal data for each outlet. Note that the number of </span><em><span>arguments</span></em><span> of the method matches the number of signal </span><em><span>inlets</span></em><span>, while the number of </span><em><span>return values</span></em><span> corresponds to the number of signal </span><em><span>outlets</span></em><span>. The </span><code>perform</code><span> method is </span><em><span>not</span></em><span> optional; if your object outputs any signal data, the method needs to be implemented, otherwise you&#39;ll get a </span><code>perform: function should return a table</code><span> or similar error in the Pd console as soon as you turn on dsp processing.</span></p></li></ol><p><span>In addition to the </span><code>dsp</code><span> and </span><code>perform</code><span> methods, your object may contain any number of methods doing the usual control data processing on the </span><code>DATA</code><span> inlets. It is also possible to receive control data on the </span><code>SIGNAL</code><span> inlets; however, you won&#39;t be able to receive </span><code>float</code><span> messages, because they will be interpreted as constant signals which get passed as blocks of signal data to the </span><code>perform</code><span> method instead.</span></p><h4 id='example-1-mixing-signals'><span>Example 1: Mixing signals</span></h4><p><span>Let&#39;s take a look at a few simple examples illustrating the kind of processing the </span><code>perform</code><span> method might do. First, let&#39;s mix two signals (stereo input) down to a single (mono) output by computing the average of corresponding samples. We need two signal inlets and one signal outlet, so our </span><code>initialize</code><span> method looks like this:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51801px; left: 7.98611px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">local</span> <span class="cm-variable">foo</span> = <span class="cm-variable">pd.Class</span>:<span class="cm-variable">new</span>():<span class="cm-variable">register</span>(<span class="cm-string">"foo"</span>)</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
+</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">foo</span>:<span class="cm-variable">initialize</span>(<span class="cm-variable">sel</span>, <span class="cm-variable">atoms</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.inlets</span> = {<span class="cm-variable">SIGNAL</span>,<span class="cm-variable">SIGNAL</span>}</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.outlets</span> = {<span class="cm-variable">SIGNAL</span>}</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">return</span> <span class="cm-keyword">true</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 161px;"></div><div class="CodeMirror-gutters" style="display: none; height: 161px;"></div></div></div></pre><p><span>And here&#39;s the </span><code>perform</code><span> method (in this simple example we don&#39;t need </span><code>foo:dsp()</code><span>):</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51801px; left: 7.98611px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">foo</span>:<span class="cm-variable">perform</span>(<span class="cm-variable">in1</span>, <span class="cm-variable">in2</span>)</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">for</span> <span class="cm-variable">i</span> = <span class="cm-number">1</span>, #<span class="cm-variable">in1</span> <span class="cm-keyword">do</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">in1</span>[<span class="cm-variable">i</span>] = (<span class="cm-variable">in1</span>[<span class="cm-variable">i</span>]+<span class="cm-variable">in2</span>[<span class="cm-variable">i</span>])/<span class="cm-number">2</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">return</span> <span class="cm-variable">in1</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 138px;"></div><div class="CodeMirror-gutters" style="display: none; height: 138px;"></div></div></div></pre><p><span>Note that here we replaced the signal data in the </span><code>in1</code><span> table with the result, so we simply return the modified </span><code>in1</code><span> signal; no need to create a third </span><code>out</code><span> table. (This is safe because it won&#39;t actually modify any signal data outside the Lua method.)</span></p><p><span>Easy enough. And this is how this object works in a little test patch:</span></p><p><img src="17-signal1.png" referrerpolicy="no-referrer" alt="Mixing signals"></p><h4 id='example-2-analyzing-a-signal'><span>Example 2: Analyzing a signal</span></h4><p><span>A dsp object can also have no signal outlets at all if you just want to process the incoming signal data in some way and output the result through a normal control outlet. E.g., here&#39;s one (rather simplistic) way to compute the rms (</span><a href='https://en.wikipedia.org/wiki/Root_mean_square'><span>root mean square</span></a><span>) envelope of a signal as control data:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua" style="break-inside: unset;"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51801px; left: 7.98611px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">foo</span>:<span class="cm-variable">initialize</span>(<span class="cm-variable">sel</span>, <span class="cm-variable">atoms</span>)</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.inlets</span> = {<span class="cm-variable">SIGNAL</span>}</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.outlets</span> = {<span class="cm-variable">DATA</span>}</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">return</span> <span class="cm-keyword">true</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
+</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">foo</span>:<span class="cm-variable">perform</span>(<span class="cm-variable">in1</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">local</span> <span class="cm-variable">rms</span> = <span class="cm-number">0</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">for</span> <span class="cm-variable">i</span> = <span class="cm-number">1</span>, #<span class="cm-variable">in1</span> <span class="cm-keyword">do</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">rms</span> = <span class="cm-variable">rms</span> + <span class="cm-variable">in1</span>[<span class="cm-variable">i</span>]*<span class="cm-variable">in1</span>[<span class="cm-variable">i</span>]</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">rms</span> = <span class="cm-builtin">math.sqrt</span>(<span class="cm-variable">rms</span>/#<span class="cm-variable">in1</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self</span>:<span class="cm-variable">outlet</span>(<span class="cm-number">1</span>, <span class="cm-string">"float"</span>, {<span class="cm-variable">rms</span>})</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 323px;"></div><div class="CodeMirror-gutters" style="display: none; height: 323px;"></div></div></div></pre><p><span>A little test patch:</span></p><p><img src="17-signal2.png" referrerpolicy="no-referrer" alt="Analyzing a signal"></p><h4 id='example-3-generating-a-signal'><span>Example 3: Generating a signal</span></h4><p><span>Conversely, we can also have an object which converts control inputs into signal data, such as this little oscillator object which produces a sine wave:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua" style="break-inside: unset;"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51801px; left: 7.98611px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">foo</span>:<span class="cm-variable">initialize</span>(<span class="cm-variable">sel</span>, <span class="cm-variable">atoms</span>)</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.inlets</span> = {<span class="cm-variable">DATA</span>}</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.outlets</span> = {<span class="cm-variable">SIGNAL</span>}</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.phase</span> = <span class="cm-number">0</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.freq</span> = <span class="cm-number">220</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.amp</span> = <span class="cm-number">0.5</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">return</span> <span class="cm-keyword">true</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
 </span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-comment">-- message to set frequency...</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">foo</span>:<span class="cm-variable">in_1_freq</span>(<span class="cm-variable">atoms</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.freq</span> = <span class="cm-variable">atoms</span>[<span class="cm-number">1</span>]</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
 </span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-comment">-- ... and amplitude.</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">foo</span>:<span class="cm-variable">in_1_amp</span>(<span class="cm-variable">atoms</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.amp</span> = <span class="cm-variable">atoms</span>[<span class="cm-number">1</span>]</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
 </span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">foo</span>:<span class="cm-variable">perform</span>()</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">local</span> <span class="cm-variable">freq</span> = <span class="cm-variable">self.freq</span> &nbsp;<span class="cm-comment">-- frequency of the sine wave in Hz</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">local</span> <span class="cm-variable">amp</span> = <span class="cm-variable">self.amp</span> &nbsp; &nbsp;<span class="cm-comment">-- amplitude of the sine wave (0 to 1)</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
 </span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- calculate the angular frequency (in radians per sample)</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">local</span> <span class="cm-variable">angular_freq</span> = <span class="cm-number">2</span> * <span class="cm-builtin">math.pi</span> * <span class="cm-variable">freq</span> / <span class="cm-variable">self.samplerate</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
 </span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">local</span> <span class="cm-variable">out</span> = {} <span class="cm-comment">-- result table</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">for</span> <span class="cm-variable">i</span> = <span class="cm-number">1</span>, <span class="cm-variable">self.blocksize</span> <span class="cm-keyword">do</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">out</span>[<span class="cm-variable">i</span>] = <span class="cm-variable">amp</span> * <span class="cm-builtin">math.sin</span>(<span class="cm-variable">self.phase</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">self.phase</span> = <span class="cm-variable">self.phase</span> + <span class="cm-variable">angular_freq</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-keyword">if</span> <span class="cm-variable">self.phase</span> &gt;= <span class="cm-number">2</span> * <span class="cm-builtin">math.pi</span> <span class="cm-keyword">then</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp; &nbsp; <span class="cm-variable">self.phase</span> = <span class="cm-variable">self.phase</span> - <span class="cm-number">2</span> * <span class="cm-builtin">math.pi</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
-</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">return</span> <span class="cm-variable">out</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 852px;"></div><div class="CodeMirror-gutters" style="display: none; height: 852px;"></div></div></div></pre><p><span>The obligatory test patch:</span></p><p><img src="17-signal3.png" referrerpolicy="no-referrer" alt="Generating a signal"></p><h4 id='real-world-example-cross-fades'><span>Real-world example: Cross-fades</span></h4><p><span>Let&#39;s finally take a look at a somewhat more realistic and useful example which performs cross-fades on two incoming signals by doing linear interpolation between the input signals. A customary design for this kind of dsp object is to have a target cross-fade value (</span><code>xfade</code><span> argument) ranging from 0 (all left signal) to 1 (all right signal). We also want to be able to smoothly ramp from one cross-fade value to the next in order to avoid clicks (</span><code>time</code><span> argument), and have an initial delay until moving to the new xfade value (</span><code>delay</code><span> argument). Here is the definition of a </span><code>luaxfade~</code><span> object which does all this, including the checking of all argument values, so that we don&#39;t run into any Lua exceptions because of bad values. The example also illustrates how to receive control messages on a signal inlet (cf. the </span><code>fade</code><span> message on the left signal inlet). You can find this as luaxfade~.pd_lua in the tutorial examples.</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua" style="break-inside: unset;"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51982px; left: 7.99336px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">local</span> <span class="cm-variable">luaxfade</span> = <span class="cm-variable">pd.Class</span>:<span class="cm-variable">new</span>():<span class="cm-variable">register</span>(<span class="cm-string">"luaxfade~"</span>)</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
+</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">return</span> <span class="cm-variable">out</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 852px;"></div><div class="CodeMirror-gutters" style="display: none; height: 852px;"></div></div></div></pre><p><span>The obligatory test patch:</span></p><p><img src="17-signal3.png" referrerpolicy="no-referrer" alt="Generating a signal"></p><h4 id='real-world-example-cross-fades'><span>Real-world example: Cross-fades</span></h4><p><span>Let&#39;s finally take a look at a somewhat more realistic and useful example which performs cross-fades on two incoming signals by doing linear interpolation between the input signals. A customary design for this kind of dsp object is to have a target cross-fade value (</span><code>xfade</code><span> argument) ranging from 0 (all left signal) to 1 (all right signal). We also want to be able to smoothly ramp from one cross-fade value to the next in order to avoid clicks (</span><code>time</code><span> argument), and have an initial delay until moving to the new xfade value (</span><code>delay</code><span> argument). Here is the definition of a </span><code>luaxfade~</code><span> object which does all this, including the checking of all argument values, so that we don&#39;t run into any Lua exceptions because of bad values. The example also illustrates how to receive control messages on a signal inlet (cf. the </span><code>fade</code><span> message on the left signal inlet). You can find this as luaxfade~.pd_lua in the tutorial examples.</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua" style="break-inside: unset;"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51801px; left: 7.98611px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">local</span> <span class="cm-variable">luaxfade</span> = <span class="cm-variable">pd.Class</span>:<span class="cm-variable">new</span>():<span class="cm-variable">register</span>(<span class="cm-string">"luaxfade~"</span>)</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
 </span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">luaxfade</span>:<span class="cm-variable">initialize</span>(<span class="cm-variable">sel</span>, <span class="cm-variable">atoms</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.inlets</span> = {<span class="cm-variable">SIGNAL</span>,<span class="cm-variable">SIGNAL</span>}</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.outlets</span> = {<span class="cm-variable">SIGNAL</span>}</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.xfade</span> = <span class="cm-number">0</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.xfade_to</span> = <span class="cm-number">0</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.xfade_time</span> = <span class="cm-number">0</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.xfade_delay</span> = <span class="cm-number">0</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.time</span> = <span class="cm-number">0</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.ramp</span> = <span class="cm-number">0</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">return</span> <span class="cm-keyword">true</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
 </span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">luaxfade</span>:<span class="cm-variable">dsp</span>(<span class="cm-variable">samplerate</span>, <span class="cm-variable">blocksize</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.samplerate</span> = <span class="cm-variable">samplerate</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
 </span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">luaxfade</span>:<span class="cm-variable">in_1_fade</span>(<span class="cm-variable">atoms</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- If self.samplerate is not initialized, because the dsp method has not</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- been run yet, then we cannot compute the sample delay and ramp times</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- below, so we bail out, telling the user to enable dsp first.</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">if</span> <span class="cm-keyword">not</span> <span class="cm-variable">self.samplerate</span> <span class="cm-keyword">then</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">self</span>:<span class="cm-builtin">error</span>(<span class="cm-string">"luaxfade~: unknown sample rate, please enable dsp first"</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-keyword">return</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">local</span> <span class="cm-variable">fade</span>, <span class="cm-variable">time</span>, <span class="cm-variable">delay</span> = <span class="cm-variable">table.unpack</span>(<span class="cm-variable">atoms</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">if</span> <span class="cm-builtin">type</span>(<span class="cm-variable">delay</span>) == <span class="cm-string">"number"</span> <span class="cm-keyword">then</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-comment">-- delay time (msec -&gt; samples)</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">self.xfade_delay</span> = <span class="cm-builtin">math.floor</span>(<span class="cm-variable">self.samplerate</span>*<span class="cm-variable">delay</span>/<span class="cm-number">1000</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">if</span> <span class="cm-builtin">type</span>(<span class="cm-variable">time</span>) == <span class="cm-string">"number"</span> <span class="cm-keyword">then</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-comment">-- xfade time (msec -&gt; samples)</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">self.xfade_time</span> = <span class="cm-builtin">math.floor</span>(<span class="cm-variable">self.samplerate</span>*<span class="cm-variable">time</span>/<span class="cm-number">1000</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">if</span> <span class="cm-builtin">type</span>(<span class="cm-variable">fade</span>) == <span class="cm-string">"number"</span> <span class="cm-keyword">then</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-comment">-- new xfade value (clamp to 0-1)</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">self.xfade_to</span> = <span class="cm-builtin">math.max</span>(<span class="cm-number">0</span>, <span class="cm-builtin">math.min</span>(<span class="cm-number">1</span>, <span class="cm-variable">fade</span>))</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">if</span> <span class="cm-variable">self.xfade_to</span> ~= <span class="cm-variable">self.xfade</span> <span class="cm-keyword">then</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-comment">-- start a new cycle</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-keyword">if</span> <span class="cm-variable">self.xfade_delay</span> &gt; <span class="cm-number">0</span> <span class="cm-keyword">then</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp; &nbsp; <span class="cm-variable">self.time</span>, <span class="cm-variable">self.ramp</span> = <span class="cm-variable">self.xfade_delay</span>, <span class="cm-number">0</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-keyword">elseif</span> <span class="cm-variable">self.xfade_time</span> &gt; <span class="cm-number">0</span> <span class="cm-keyword">then</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp; &nbsp; <span class="cm-variable">self.time</span>, <span class="cm-variable">self.ramp</span> = <span class="cm-variable">self.xfade_time</span>,</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; (<span class="cm-variable">self.xfade_to-self.xfade</span>)/<span class="cm-variable">self.xfade_time</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-keyword">else</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp; &nbsp; <span class="cm-variable">self.xfade</span> = <span class="cm-variable">self.xfade_to</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp; &nbsp; <span class="cm-variable">self.time</span>, <span class="cm-variable">self.ramp</span> = <span class="cm-number">0</span>, <span class="cm-number">0</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
 </span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">luaxfade</span>:<span class="cm-variable">perform</span>(<span class="cm-variable">in1</span>, <span class="cm-variable">in2</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">local</span> <span class="cm-variable">xfade</span>, <span class="cm-variable">xfade_to</span> = <span class="cm-variable">self.xfade</span>, <span class="cm-variable">self.xfade_to</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">local</span> <span class="cm-variable">xfade_time</span> = <span class="cm-variable">self.xfade_time</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">local</span> <span class="cm-variable">time</span>, <span class="cm-variable">ramp</span> = <span class="cm-variable">self.time</span>, <span class="cm-variable">self.ramp</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
 </span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- loop through each sample index</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">for</span> <span class="cm-variable">i</span> = <span class="cm-number">1</span>, #<span class="cm-variable">in1</span> <span class="cm-keyword">do</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-comment">-- mix (we do this in-place, using in1 for output)</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">in1</span>[<span class="cm-variable">i</span>] = <span class="cm-variable">in1</span>[<span class="cm-variable">i</span>]*(<span class="cm-number">1</span>-<span class="cm-variable">xfade</span>) + <span class="cm-variable">in2</span>[<span class="cm-variable">i</span>]*<span class="cm-variable">xfade</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-comment">-- update the mix if time &gt; 0 (sample countdown)</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-keyword">if</span> <span class="cm-variable">time</span> &gt; <span class="cm-number">0</span> <span class="cm-keyword">then</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp; &nbsp; <span class="cm-comment">-- update cycle is still in ptogress</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp; &nbsp; <span class="cm-keyword">if</span> <span class="cm-variable">ramp</span> ~= <span class="cm-number">0</span> <span class="cm-keyword">then</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;<span class="cm-variable">xfade</span> = <span class="cm-variable">xfade</span> + <span class="cm-variable">ramp</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp; &nbsp; <span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp; &nbsp; <span class="cm-variable">time</span> = <span class="cm-variable">time</span> - <span class="cm-number">1</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-keyword">elseif</span> <span class="cm-variable">xfade_to</span> ~= <span class="cm-variable">xfade</span> <span class="cm-keyword">then</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp; &nbsp; <span class="cm-keyword">if</span> <span class="cm-variable">xfade_time</span> &gt; <span class="cm-number">0</span> <span class="cm-keyword">then</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;<span class="cm-comment">-- start the ramp up or down</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;<span class="cm-variable">time</span>, <span class="cm-variable">ramp</span> = <span class="cm-variable">xfade_time</span>, (<span class="cm-variable">xfade_to-xfade</span>)/<span class="cm-variable">xfade_time</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp; &nbsp; <span class="cm-keyword">else</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;<span class="cm-comment">-- no xfade_time, jump to the new value immediately</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;<span class="cm-variable">xfade</span> = <span class="cm-variable">xfade_to</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp; &nbsp; <span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
 </span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- update internal state</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.xfade</span>, <span class="cm-variable">self.time</span>, <span class="cm-variable">self.ramp</span> = <span class="cm-variable">xfade</span>, <span class="cm-variable">time</span>, <span class="cm-variable">ramp</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
-</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- return the mixed down sample data</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">return</span> <span class="cm-variable">in1</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 1981px;"></div><div class="CodeMirror-gutters" style="display: none; height: 1981px;"></div></div></div></pre><p><span>And here&#39;s the luaxfade.pd patch which takes a sine wave on the left and a noise signal on the right inlet and performs cross fades with a ramp time of 500 msec and an initial delay of 200 msec. To adjust these values, just edit the </span><code>fade</code><span> message accordingly.</span></p><p><img src="17-signal4.png" referrerpolicy="no-referrer" alt="Cross-fades"></p><h3 id='graphics'><span>Graphics</span></h3><p><span>Timothy Schoen&#39;s Pd-Lua graphics API provides you with a way to equip an object with a static or animated graphical display inside its object box on the Pd canvas. Typical examples would be various kinds of wave displays, or custom GUI objects consisting of text and simple geometric shapes. To these ends, you can adjust the size of the object box to any width and height you specify. Inside the box rectangle you can then draw text and basic geometric shapes such as lines, rectangles, circles, and arbitrary paths, through stroke and fill operations using any rgb color.</span></p><p><span>In order to enable graphics in a Pd-Lua object, you have to provide a </span><code>paint</code><span> method. This receives a graphics context </span><code>g</code><span> as its argument, which lets you set the current color, and draw text and the various different geometric shapes using that color. In addition, you can provide methods to be called in response to mouse down, up, move, and drag actions on the object, which is useful to equip your custom GUI objects with mouse-based interaction.</span></p><p><span>Last but not least, the </span><code>set_args</code><span> method lets you store internal object state in the object&#39;s creation arguments, which is useful if you need to keep track of persistent state when storing an object on disk (via saving the patch) or when duplicating or copying objects. This can also be used with ordinary Pd-Lua objects which don&#39;t utilize the graphics API, but it is most useful in the context of custom GUI objects.</span></p><p><span>We use a custom GUI object, a simple kind of dial, as a running example to illustrate most of these elements in the following subsections. To keep things simple, we will not discuss the graphics API in much detail here, so you may want to check the graphics subpatch in the main pdlua-help patch, which contains a detailed listing of all available methods for reference.</span></p><h4 id='getting-started-a-basic-dial-object'><span>Getting started: A basic dial object</span></h4><p><span>Let&#39;s begin with a basic clock-like dial: just a circular </span><em><span>face</span></em><span> and a border around it, on which we draw a </span><em><span>center point</span></em><span> and the </span><em><span>hand</span></em><span> (a line) starting at the center point and pointing in any direction which indicates the current </span><em><span>phase</span></em><span> angle. So this is what we are aiming for:</span></p><p><img src="18-graphics1.png" referrerpolicy="no-referrer" alt="A basic dial"></p><p><span>Following the clock paradigm, we assume that a zero phase angle means pointing upwards (towards the 12 o&#39;clock position), while +1 or -1 indicates the 6 o&#39;clock position, pointing downwards. Phase angles less than -1 or greater than +1 wrap around. Positive phase differences denote clockwise, negative differences counter-clockwise rotation. And since we&#39;d like to change the phase angle displayed on the dial, we add an inlet taking float values.</span></p><p><span>Here&#39;s the code implementing the object initialization and the float inlet:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua" style="break-inside: unset;"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51982px; left: 7.99336px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">local</span> <span class="cm-variable">dial</span> = <span class="cm-variable">pd.Class</span>:<span class="cm-variable">new</span>():<span class="cm-variable">register</span>(<span class="cm-string">"dial"</span>)</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
+</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- return the mixed down sample data</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">return</span> <span class="cm-variable">in1</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 1981px;"></div><div class="CodeMirror-gutters" style="display: none; height: 1981px;"></div></div></div></pre><p><span>And here&#39;s the luaxfade.pd patch which takes a sine wave on the left and a noise signal on the right inlet and performs cross fades with a ramp time of 500 msec and an initial delay of 200 msec. To adjust these values, just edit the </span><code>fade</code><span> message accordingly.</span></p><p><img src="17-signal4.png" referrerpolicy="no-referrer" alt="Cross-fades"></p><h3 id='graphics'><span>Graphics</span></h3><p><span>Timothy Schoen&#39;s Pd-Lua graphics API provides you with a way to equip an object with a static or animated graphical display inside its object box on the Pd canvas. Typical examples would be various kinds of wave displays, or custom GUI objects consisting of text and simple geometric shapes. To these ends, you can adjust the size of the object box to any width and height you specify. Inside the box rectangle you can then draw text and basic geometric shapes such as lines, rectangles, circles, and arbitrary paths, through stroke and fill operations using any rgb color.</span></p><p><span>In order to enable graphics in a Pd-Lua object, you have to provide a </span><code>paint</code><span> method. This receives a graphics context </span><code>g</code><span> as its argument, which lets you set the current color, and draw text and the various different geometric shapes using that color. In addition, you can provide methods to be called in response to mouse down, up, move, and drag actions on the object, which is useful to equip your custom GUI objects with mouse-based interaction.</span></p><p><span>Last but not least, the </span><code>set_args</code><span> method lets you store internal object state in the object&#39;s creation arguments, which is useful if you need to keep track of persistent state when storing an object on disk (via saving the patch) or when duplicating or copying objects. Also, its companion </span><code>canvas_realizedollar</code><span> method allows you to expand symbols containing &quot;$&quot; patch arguments like </span><code>$0</code><span>, </span><code>$1</code><span>, etc. These two are often employed together, but they can also be used separately, and they work just as well with ordinary Pd-Lua objects which don&#39;t utilize the graphics API. In fact we&#39;ve already introduced them while discussing receivers, see </span><a href='#expanding-dollar-symbols'><span>Expanding dollar symbols</span></a><span> above, so we won&#39;t go into them again; however, check the circle-gui example included in the distribution to see how to store Lua object configuration data persistently in the creation arguments of a custom GUI object.</span></p><p><span>We use a custom GUI object, a simple kind of dial, as a running example to illustrate most of these elements in the following subsections. To keep things simple, we will not discuss the graphics API in much detail here, so you may want to check the graphics subpatch in the main pdlua-help patch, which contains a detailed listing of all available methods for reference.</span></p><h4 id='getting-started-a-basic-dial-object'><span>Getting started: A basic dial object</span></h4><p><span>Let&#39;s begin with a basic clock-like dial: just a circular </span><em><span>face</span></em><span> and a border around it, on which we draw a </span><em><span>center point</span></em><span> and the </span><em><span>hand</span></em><span> (a line) starting at the center point and pointing in any direction which indicates the current </span><em><span>phase</span></em><span> angle. So this is what we are aiming for:</span></p><p><img src="18-graphics1.png" referrerpolicy="no-referrer" alt="A basic dial"></p><p><span>Following the clock paradigm, we assume that a zero phase angle means pointing upwards (towards the 12 o&#39;clock position), while +1 or -1 indicates the 6 o&#39;clock position, pointing downwards. Phase angles less than -1 or greater than +1 wrap around. Positive phase differences denote clockwise, negative differences counter-clockwise rotation. And since we&#39;d like to change the phase angle displayed on the dial, we add an inlet taking float values.</span></p><p><span>Here&#39;s the code implementing the object initialization and the float inlet:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua" style="break-inside: unset;"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51801px; left: 7.98611px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">local</span> <span class="cm-variable">dial</span> = <span class="cm-variable">pd.Class</span>:<span class="cm-variable">new</span>():<span class="cm-variable">register</span>(<span class="cm-string">"dial"</span>)</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
 </span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">dial</span>:<span class="cm-variable">initialize</span>(<span class="cm-variable">sel</span>, <span class="cm-variable">atoms</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.inlets</span> = <span class="cm-number">1</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.outlets</span> = <span class="cm-number">0</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.phase</span> = <span class="cm-number">0</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self</span>:<span class="cm-variable">set_size</span>(<span class="cm-number">127</span>, <span class="cm-number">127</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">return</span> <span class="cm-keyword">true</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
-</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">dial</span>:<span class="cm-variable">in_1_float</span>(<span class="cm-variable">x</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.phase</span> = <span class="cm-variable">x</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self</span>:<span class="cm-variable">repaint</span>()</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 323px;"></div><div class="CodeMirror-gutters" style="display: none; height: 323px;"></div></div></div></pre><p><span>The </span><code>self:set_size()</code><span> call in the </span><code>initialize</code><span> method sets the pixel size of the object rectangle on the canvas (in this case it&#39;s a square with a width and height of 127 pixels). Also note the call to </span><code>self:repaint()</code><span> in the float handler for the inlet, which will redraw the graphical representation after updating the phase value.</span></p><p><span>We still have to add the </span><code>dial:paint()</code><span> method to do all the actual drawing:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua" style="break-inside: unset;"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51982px; left: 7.99336px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">dial</span>:<span class="cm-variable">paint</span>(<span class="cm-variable">g</span>)</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">local</span> <span class="cm-variable">width</span>, <span class="cm-variable">height</span> = <span class="cm-variable">self</span>:<span class="cm-variable">get_size</span>()</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">local</span> <span class="cm-variable">x</span>, <span class="cm-variable">y</span> = <span class="cm-variable">self</span>:<span class="cm-variable">tip</span>()</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
+</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">dial</span>:<span class="cm-variable">in_1_float</span>(<span class="cm-variable">x</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.phase</span> = <span class="cm-variable">x</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self</span>:<span class="cm-variable">repaint</span>()</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 323px;"></div><div class="CodeMirror-gutters" style="display: none; height: 323px;"></div></div></div></pre><p><span>The </span><code>self:set_size()</code><span> call in the </span><code>initialize</code><span> method sets the pixel size of the object rectangle on the canvas (in this case it&#39;s a square with a width and height of 127 pixels). Also note the call to </span><code>self:repaint()</code><span> in the float handler for the inlet, which will redraw the graphical representation after updating the phase value.</span></p><p><span>We still have to add the </span><code>dial:paint()</code><span> method to do all the actual drawing:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua" style="break-inside: unset;"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51801px; left: 7.98611px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">dial</span>:<span class="cm-variable">paint</span>(<span class="cm-variable">g</span>)</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">local</span> <span class="cm-variable">width</span>, <span class="cm-variable">height</span> = <span class="cm-variable">self</span>:<span class="cm-variable">get_size</span>()</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">local</span> <span class="cm-variable">x</span>, <span class="cm-variable">y</span> = <span class="cm-variable">self</span>:<span class="cm-variable">tip</span>()</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
 </span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- standard object border, fill with bg color</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">g</span>:<span class="cm-variable">set_color</span>(<span class="cm-number">0</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">g</span>:<span class="cm-variable">fill_all</span>()</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
-</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- dial face</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">g</span>:<span class="cm-variable">fill_ellipse</span>(<span class="cm-number">2</span>, <span class="cm-number">2</span>, <span class="cm-variable">width</span> - <span class="cm-number">4</span>, <span class="cm-variable">height</span> - <span class="cm-number">4</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">g</span>:<span class="cm-variable">set_color</span>(<span class="cm-number">1</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- dial border</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">g</span>:<span class="cm-variable">stroke_ellipse</span>(<span class="cm-number">2</span>, <span class="cm-number">2</span>, <span class="cm-variable">width</span> - <span class="cm-number">4</span>, <span class="cm-variable">height</span> - <span class="cm-number">4</span>, <span class="cm-number">4</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- center point</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">g</span>:<span class="cm-variable">fill_ellipse</span>(<span class="cm-variable">width</span>/<span class="cm-number">2</span> - <span class="cm-number">3.5</span>, <span class="cm-variable">height</span>/<span class="cm-number">2</span> - <span class="cm-number">3.5</span>, <span class="cm-number">7</span>, <span class="cm-number">7</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- dial hand</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">g</span>:<span class="cm-variable">draw_line</span>(<span class="cm-variable">x</span>, <span class="cm-variable">y</span>, <span class="cm-variable">width</span>/<span class="cm-number">2</span>, <span class="cm-variable">height</span>/<span class="cm-number">2</span>, <span class="cm-number">2</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 415px;"></div><div class="CodeMirror-gutters" style="display: none; height: 415px;"></div></div></div></pre><p><span>The existence of the  </span><code>paint</code><span> method tells Pd-Lua that this is a graphical object. As mentioned before, this method receives a graphics context </span><code>g</code><span> as argument. The graphics context is an internal data structure keeping track of the graphics state of the object, which is used to invoke all the graphics operations. The </span><code>set_color</code><span> method of the graphics context is used to set the color for all drawing operations; in the case of </span><code>fill</code><span> operations it fills the graphical element with the color, while in the case of </span><code>stroke</code><span> operations it draws its border. There&#39;s just one color value, so we need to set the desired fill color in case of </span><code>fill</code><span>, and the desired stroke color in case of </span><code>stroke</code><span> operations. The color values 0 and 1 we use in this example are predefined, and indicate the default background color (usually white) and default foreground color (usually black), respectively.</span></p><p><span>It is possible to choose other colors by calling </span><code>g:set_color(r, g, b)</code><span> with rgb color values instead, with each r, g, b value ranging from 0 to 255 (i.e., a byte value). For instance, the color &quot;teal&quot; would be specified as 0, 128, 128, the color &quot;orange&quot; as 255, 165, 0, &quot;black&quot; as 0, 0, 0, &quot;white&quot; as 255, 255, 255, etc. It&#39;s also possible to add a fourth </span><em><span>alpha</span></em><span> a.k.a. opacity value a, which is a floating point number in the range 0-1, where 0 means fully transparent, 1 fully opaque, and any value in between will blend in whatever is behind the graphical element to varying degrees. As of Pd-Lua 0.12.7, alpha values are fully supported in both plugdata and purr-data. In vanilla Pd they are simply ignored at present, so all graphical objects will be opaque no matter what alpha value you specify.</span></p><p><span>Let&#39;s now take a closer look at the drawing operations themselves. We start out by filling the entire object rectangle, which is our drawing surface, with the default background color 0, using </span><code>g:fill_all()</code><span>. This operation is special in that it not only fills the entire object rectangle, but also creates a standard border rectangle around it. If you skip this, you&#39;ll get an object without border, which may be useful at times.</span></p><p><span>We then go on to fill a circle with the background color, the dial&#39;s face. The graphics API has no operation to draw a circle, so we just draw an ellipse instead. The coordinates given to </span><code>g:fill_ellipse()</code><span> are the coordinates of the rectangle surrounding the ellipse. In this case the width and height values are what we specified with </span><code>self:set_size(127, 127)</code><span> in the </span><code>initialize</code><span> method, so they are identical, and thus our ellipse is in fact a circle. Also note that we make the ellipse a little smaller and put it at a small offset from the upper left corner, so the actual width and height are reduced by 4 and the shape is centered in the object rectangle (or square, in this case).</span></p><p><span>Note that we could have skipped drawing the face entirely at this point, since it just draws a white circle on white background. But we could make the face a different color later, so it&#39;s good to include it anyway.</span></p><p><span>After the face we draw its border, drawing the same ellipse again, but this time in the default foreground color and with a stroke width of 4. We then go on to draw the remaining parts, a small disk in the center which mimics the shaft on which the single hand of the dial is mounted, and the hand itself, which is just a simple line pointing in a certain direction.</span></p><p><span>Which direction? I&#39;m glad you asked. The line representing the hand goes from the center point width/2, height/2 to the point given by the x, y coordinates. Both width, height and x, y are calculated and assigned to local variables at the beginning of the </span><code>paint</code><span> method:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51982px; left: 7.99336px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation"><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">local</span> <span class="cm-variable">width</span>, <span class="cm-variable">height</span> = <span class="cm-variable">self</span>:<span class="cm-variable">get_size</span>()</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">local</span> <span class="cm-variable">x</span>, <span class="cm-variable">y</span> = <span class="cm-variable">self</span>:<span class="cm-variable">tip</span>()</span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 46px;"></div><div class="CodeMirror-gutters" style="display: none; height: 46px;"></div></div></div></pre><p><span>The </span><code>get_size()</code><span>  call employs a built-in method which returns the current dimensions of the object rectangle; this is part of the graphics API. We could have used the constant 127 from the </span><code>initialize</code><span> method there, but we could change the size of the object rectangle later, so it&#39;s better not to hard-code the size in the </span><code>paint</code><span> method.</span></p><p><span>The </span><code>tip()</code><span> method we have to define ourselves. It is supposed to calculate the coordinates of the tip of the hand. I have factored this out into its own routine right away, so that we can reuse it later when we add the mouse actions. Here it is:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51982px; left: 7.99336px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">dial</span>:<span class="cm-variable">tip</span>()</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">local</span> <span class="cm-variable">width</span>, <span class="cm-variable">height</span> = <span class="cm-variable">self</span>:<span class="cm-variable">get_size</span>()</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">local</span> <span class="cm-variable">x</span>, <span class="cm-variable">y</span> = <span class="cm-builtin">math.sin</span>(<span class="cm-variable">self.phase</span>*<span class="cm-builtin">math.pi</span>), -<span class="cm-builtin">math.cos</span>(<span class="cm-variable">self.phase</span>*<span class="cm-builtin">math.pi</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">x</span>, <span class="cm-variable">y</span> = (<span class="cm-variable">x</span>/<span class="cm-number">2</span>*<span class="cm-number">0.8</span>+<span class="cm-number">0.5</span>)*<span class="cm-variable">width</span>, (<span class="cm-variable">y</span>/<span class="cm-number">2</span>*<span class="cm-number">0.8</span>+<span class="cm-number">0.5</span>)*<span class="cm-variable">height</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">return</span> <span class="cm-variable">x</span>, <span class="cm-variable">y</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 138px;"></div><div class="CodeMirror-gutters" style="display: none; height: 138px;"></div></div></div></pre><p><span>This basically just converts the position of the tip from polar coordinates (1, phase) to rectangular coordinates (x, y) and then translates and scales the normalized coordinates to pixel coordinates in the object rectangle which has its center at (width/2, height/2). We also put the tip at a normalized radius of 0.8 so that it is well within the face of the dial. Moreover, the formula computing the x, y pair accounts for the fact that the y coordinates of the object rectangle are upside-down (0 is at the top), and that we want the center-up (a.k.a. 12 o&#39;clock) position to correspond to a zero phase angle. Hence the sin and cos terms have been swapped and the cos term adorned with a minus sign compared to the standard polar - rectangular conversion formula.</span></p><p><span>So now that we hopefully understand all the bits and pieces, here&#39;s the Lua code of the object in its entirety again:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua" style="break-inside: unset;"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51982px; left: 7.99336px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">local</span> <span class="cm-variable">dial</span> = <span class="cm-variable">pd.Class</span>:<span class="cm-variable">new</span>():<span class="cm-variable">register</span>(<span class="cm-string">"dial"</span>)</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
+</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- dial face</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">g</span>:<span class="cm-variable">fill_ellipse</span>(<span class="cm-number">2</span>, <span class="cm-number">2</span>, <span class="cm-variable">width</span> - <span class="cm-number">4</span>, <span class="cm-variable">height</span> - <span class="cm-number">4</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">g</span>:<span class="cm-variable">set_color</span>(<span class="cm-number">1</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- dial border</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">g</span>:<span class="cm-variable">stroke_ellipse</span>(<span class="cm-number">2</span>, <span class="cm-number">2</span>, <span class="cm-variable">width</span> - <span class="cm-number">4</span>, <span class="cm-variable">height</span> - <span class="cm-number">4</span>, <span class="cm-number">4</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- center point</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">g</span>:<span class="cm-variable">fill_ellipse</span>(<span class="cm-variable">width</span>/<span class="cm-number">2</span> - <span class="cm-number">3.5</span>, <span class="cm-variable">height</span>/<span class="cm-number">2</span> - <span class="cm-number">3.5</span>, <span class="cm-number">7</span>, <span class="cm-number">7</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- dial hand</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">g</span>:<span class="cm-variable">draw_line</span>(<span class="cm-variable">x</span>, <span class="cm-variable">y</span>, <span class="cm-variable">width</span>/<span class="cm-number">2</span>, <span class="cm-variable">height</span>/<span class="cm-number">2</span>, <span class="cm-number">2</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 415px;"></div><div class="CodeMirror-gutters" style="display: none; height: 415px;"></div></div></div></pre><p><span>The existence of the  </span><code>paint</code><span> method tells Pd-Lua that this is a graphical object. As mentioned before, this method receives a graphics context </span><code>g</code><span> as argument. The graphics context is an internal data structure keeping track of the graphics state of the object, which is used to invoke all the graphics operations. The </span><code>set_color</code><span> method of the graphics context is used to set the color for all drawing operations; in the case of </span><code>fill</code><span> operations it fills the graphical element with the color, while in the case of </span><code>stroke</code><span> operations it draws its border. There&#39;s just one color value, so we need to set the desired fill color in case of </span><code>fill</code><span>, and the desired stroke color in case of </span><code>stroke</code><span> operations. The color values 0 and 1 we use in this example are predefined, and indicate the default background color (usually white) and default foreground color (usually black), respectively.</span></p><p><span>It is possible to choose other colors by calling </span><code>g:set_color(r, g, b)</code><span> with rgb color values instead, with each r, g, b value ranging from 0 to 255 (i.e., a byte value). For instance, the color &quot;teal&quot; would be specified as 0, 128, 128, the color &quot;orange&quot; as 255, 165, 0, &quot;black&quot; as 0, 0, 0, &quot;white&quot; as 255, 255, 255, etc. It&#39;s also possible to add a fourth </span><em><span>alpha</span></em><span> a.k.a. opacity value a, which is a floating point number in the range 0-1, where 0 means fully transparent, 1 fully opaque, and any value in between will blend in whatever is behind the graphical element to varying degrees. As of Pd-Lua 0.12.7, alpha values are fully supported in both plugdata and purr-data. In vanilla Pd they are simply ignored at present, so all graphical objects will be opaque no matter what alpha value you specify.</span></p><p><span>Let&#39;s now take a closer look at the drawing operations themselves. We start out by filling the entire object rectangle, which is our drawing surface, with the default background color 0, using </span><code>g:fill_all()</code><span>. This operation is special in that it not only fills the entire object rectangle, but also creates a standard border rectangle around it. If you skip this, you&#39;ll get an object without border, which may be useful at times.</span></p><p><span>We then go on to fill a circle with the background color, the dial&#39;s face. The graphics API has no operation to draw a circle, so we just draw an ellipse instead. The coordinates given to </span><code>g:fill_ellipse()</code><span> are the coordinates of the rectangle surrounding the ellipse. In this case the width and height values are what we specified with </span><code>self:set_size(127, 127)</code><span> in the </span><code>initialize</code><span> method, so they are identical, and thus our ellipse is in fact a circle. Also note that we make the ellipse a little smaller and put it at a small offset from the upper left corner, so the actual width and height are reduced by 4 and the shape is centered in the object rectangle (or square, in this case).</span></p><p><span>Note that we could have skipped drawing the face entirely at this point, since it just draws a white circle on white background. But we could make the face a different color later, so it&#39;s good to include it anyway.</span></p><p><span>After the face we draw its border, drawing the same ellipse again, but this time in the default foreground color and with a stroke width of 4. We then go on to draw the remaining parts, a small disk in the center which mimics the shaft on which the single hand of the dial is mounted, and the hand itself, which is just a simple line pointing in a certain direction.</span></p><p><span>Which direction? I&#39;m glad you asked. The line representing the hand goes from the center point width/2, height/2 to the point given by the x, y coordinates. Both width, height and x, y are calculated and assigned to local variables at the beginning of the </span><code>paint</code><span> method:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51801px; left: 7.98611px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation"><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">local</span> <span class="cm-variable">width</span>, <span class="cm-variable">height</span> = <span class="cm-variable">self</span>:<span class="cm-variable">get_size</span>()</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">local</span> <span class="cm-variable">x</span>, <span class="cm-variable">y</span> = <span class="cm-variable">self</span>:<span class="cm-variable">tip</span>()</span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 46px;"></div><div class="CodeMirror-gutters" style="display: none; height: 46px;"></div></div></div></pre><p><span>The </span><code>get_size()</code><span>  call employs a built-in method which returns the current dimensions of the object rectangle; this is part of the graphics API. We could have used the constant 127 from the </span><code>initialize</code><span> method there, but we could change the size of the object rectangle later, so it&#39;s better not to hard-code the size in the </span><code>paint</code><span> method.</span></p><p><span>The </span><code>tip()</code><span> method we have to define ourselves. It is supposed to calculate the coordinates of the tip of the hand. I have factored this out into its own routine right away, so that we can reuse it later when we add the mouse actions. Here it is:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51801px; left: 7.98611px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">dial</span>:<span class="cm-variable">tip</span>()</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">local</span> <span class="cm-variable">width</span>, <span class="cm-variable">height</span> = <span class="cm-variable">self</span>:<span class="cm-variable">get_size</span>()</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">local</span> <span class="cm-variable">x</span>, <span class="cm-variable">y</span> = <span class="cm-builtin">math.sin</span>(<span class="cm-variable">self.phase</span>*<span class="cm-builtin">math.pi</span>), -<span class="cm-builtin">math.cos</span>(<span class="cm-variable">self.phase</span>*<span class="cm-builtin">math.pi</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">x</span>, <span class="cm-variable">y</span> = (<span class="cm-variable">x</span>/<span class="cm-number">2</span>*<span class="cm-number">0.8</span>+<span class="cm-number">0.5</span>)*<span class="cm-variable">width</span>, (<span class="cm-variable">y</span>/<span class="cm-number">2</span>*<span class="cm-number">0.8</span>+<span class="cm-number">0.5</span>)*<span class="cm-variable">height</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">return</span> <span class="cm-variable">x</span>, <span class="cm-variable">y</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 138px;"></div><div class="CodeMirror-gutters" style="display: none; height: 138px;"></div></div></div></pre><p><span>This basically just converts the position of the tip from polar coordinates (1, phase) to rectangular coordinates (x, y) and then translates and scales the normalized coordinates to pixel coordinates in the object rectangle which has its center at (width/2, height/2). We also put the tip at a normalized radius of 0.8 so that it is well within the face of the dial. Moreover, the formula computing the x, y pair accounts for the fact that the y coordinates of the object rectangle are upside-down (0 is at the top), and that we want the center-up (a.k.a. 12 o&#39;clock) position to correspond to a zero phase angle. Hence the sin and cos terms have been swapped and the cos term adorned with a minus sign compared to the standard polar - rectangular conversion formula.</span></p><p><span>So now that we hopefully understand all the bits and pieces, here&#39;s the Lua code of the object in its entirety again:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua" style="break-inside: unset;"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51801px; left: 7.98611px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">local</span> <span class="cm-variable">dial</span> = <span class="cm-variable">pd.Class</span>:<span class="cm-variable">new</span>():<span class="cm-variable">register</span>(<span class="cm-string">"dial"</span>)</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
 </span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">dial</span>:<span class="cm-variable">initialize</span>(<span class="cm-variable">sel</span>, <span class="cm-variable">atoms</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.inlets</span> = <span class="cm-number">1</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.outlets</span> = <span class="cm-number">0</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.phase</span> = <span class="cm-number">0</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self</span>:<span class="cm-variable">set_size</span>(<span class="cm-number">127</span>, <span class="cm-number">127</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">return</span> <span class="cm-keyword">true</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
 </span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">dial</span>:<span class="cm-variable">in_1_float</span>(<span class="cm-variable">x</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.phase</span> = <span class="cm-variable">x</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self</span>:<span class="cm-variable">repaint</span>()</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
 </span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-comment">-- calculate the x, y position of the tip of the hand</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">dial</span>:<span class="cm-variable">tip</span>()</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">local</span> <span class="cm-variable">width</span>, <span class="cm-variable">height</span> = <span class="cm-variable">self</span>:<span class="cm-variable">get_size</span>()</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">local</span> <span class="cm-variable">x</span>, <span class="cm-variable">y</span> = <span class="cm-builtin">math.sin</span>(<span class="cm-variable">self.phase</span>*<span class="cm-builtin">math.pi</span>), -<span class="cm-builtin">math.cos</span>(<span class="cm-variable">self.phase</span>*<span class="cm-builtin">math.pi</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">x</span>, <span class="cm-variable">y</span> = (<span class="cm-variable">x</span>/<span class="cm-number">2</span>*<span class="cm-number">0.8</span>+<span class="cm-number">0.5</span>)*<span class="cm-variable">width</span>, (<span class="cm-variable">y</span>/<span class="cm-number">2</span>*<span class="cm-number">0.8</span>+<span class="cm-number">0.5</span>)*<span class="cm-variable">height</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">return</span> <span class="cm-variable">x</span>, <span class="cm-variable">y</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
 </span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">dial</span>:<span class="cm-variable">paint</span>(<span class="cm-variable">g</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">local</span> <span class="cm-variable">width</span>, <span class="cm-variable">height</span> = <span class="cm-variable">self</span>:<span class="cm-variable">get_size</span>()</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">local</span> <span class="cm-variable">x</span>, <span class="cm-variable">y</span> = <span class="cm-variable">self</span>:<span class="cm-variable">tip</span>()</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
 </span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- standard object border, fill with bg color</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">g</span>:<span class="cm-variable">set_color</span>(<span class="cm-number">0</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">g</span>:<span class="cm-variable">fill_all</span>()</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
-</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- dial face</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">g</span>:<span class="cm-variable">fill_ellipse</span>(<span class="cm-number">2</span>, <span class="cm-number">2</span>, <span class="cm-variable">width</span> - <span class="cm-number">4</span>, <span class="cm-variable">height</span> - <span class="cm-number">4</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">g</span>:<span class="cm-variable">set_color</span>(<span class="cm-number">1</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- dial border</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">g</span>:<span class="cm-variable">stroke_ellipse</span>(<span class="cm-number">2</span>, <span class="cm-number">2</span>, <span class="cm-variable">width</span> - <span class="cm-number">4</span>, <span class="cm-variable">height</span> - <span class="cm-number">4</span>, <span class="cm-number">4</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- center point</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">g</span>:<span class="cm-variable">fill_ellipse</span>(<span class="cm-variable">width</span>/<span class="cm-number">2</span> - <span class="cm-number">3.5</span>, <span class="cm-variable">height</span>/<span class="cm-number">2</span> - <span class="cm-number">3.5</span>, <span class="cm-number">7</span>, <span class="cm-number">7</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- dial hand</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">g</span>:<span class="cm-variable">draw_line</span>(<span class="cm-variable">x</span>, <span class="cm-variable">y</span>, <span class="cm-variable">width</span>/<span class="cm-number">2</span>, <span class="cm-variable">height</span>/<span class="cm-number">2</span>, <span class="cm-number">2</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 945px;"></div><div class="CodeMirror-gutters" style="display: none; height: 945px;"></div></div></div></pre><h4 id='adding-an-outlet'><span>Adding an outlet</span></h4><p><span>We can already send phase values into our dial object, but there&#39;s no way to get them out again. So let&#39;s add an outlet which lets us do that. Now that the grunt work is already done, this is rather straightforward. First we need to add the outlet in the </span><code>initialize</code><span> method:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51982px; left: 7.99336px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation"><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.outlets</span> = <span class="cm-number">1</span></span></pre></div></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 23px;"></div><div class="CodeMirror-gutters" style="display: none; height: 23px;"></div></div></div></pre><p><span>And then we just add a message handler for </span><code>bang</code><span> which outputs the value on the outlet:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51982px; left: 7.99336px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation"><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">dial</span>:<span class="cm-variable">in_1_bang</span>()</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self</span>:<span class="cm-variable">outlet</span>(<span class="cm-number">1</span>, <span class="cm-string">"float"</span>, {<span class="cm-variable">self.phase</span>})</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 69px;"></div><div class="CodeMirror-gutters" style="display: none; height: 69px;"></div></div></div></pre><p><span>Easy as pie. Here&#39;s how our patch looks like now:</span></p><p><img src="18-graphics2.png" referrerpolicy="no-referrer" alt="Adding an outlet"></p><h4 id='mouse-actions'><span>Mouse actions</span></h4><p><span>Our dial now has all the basic ingredients, but it still lacks one important piece: Interacting with the graphical representation itself using the mouse. The graphics API makes this reasonably easy since it provides us with four callback methods that we can implement. Each of these gets invoked with the current mouse coordinates relative to the object rectangle:</span></p><ul><li><p><code>mouse_down(x, y)</code><span>: called when the mouse is clicked</span></p></li><li><p><code>mouse_up(x, y)</code><span>: called when the mouse button is released</span></p></li><li><p><code>mouse_move(x, y)</code><span>: called when the mouse changes position while the mouse button is </span><em><span>not</span></em><span> pressed</span></p></li><li><p><code>mouse_drag(x, y)</code><span>: called when the mouse changes position while the mouse button </span><em><span>is</span></em><span> pressed</span></p></li></ul><p><span>Here we only need the </span><code>mouse_down</code><span> and </span><code>mouse_drag</code><span> methods which let us keep track of mouse drags in the object rectangle in order to update the phase value and recalculate the tip of the hand (I told you that the </span><code>tip()</code><span> method would come in handy again!). Here&#39;s the Lua code. Note that the </span><code>mouse_down</code><span> callback is used to initialize the </span><code>tip_x</code><span> and </span><code>tip_y</code><span> member variables, which we keep track of during the drag operation, so that we can detect in </span><code>mouse_drag</code><span> when it&#39;s time to output the phase value and repaint the object:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua" style="break-inside: unset;"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51982px; left: 7.99336px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">dial</span>:<span class="cm-variable">mouse_down</span>(<span class="cm-variable">x</span>, <span class="cm-variable">y</span>)</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.tip_x</span>, <span class="cm-variable">self.tip_y</span> = <span class="cm-variable">self</span>:<span class="cm-variable">tip</span>()</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
+</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- dial face</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">g</span>:<span class="cm-variable">fill_ellipse</span>(<span class="cm-number">2</span>, <span class="cm-number">2</span>, <span class="cm-variable">width</span> - <span class="cm-number">4</span>, <span class="cm-variable">height</span> - <span class="cm-number">4</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">g</span>:<span class="cm-variable">set_color</span>(<span class="cm-number">1</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- dial border</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">g</span>:<span class="cm-variable">stroke_ellipse</span>(<span class="cm-number">2</span>, <span class="cm-number">2</span>, <span class="cm-variable">width</span> - <span class="cm-number">4</span>, <span class="cm-variable">height</span> - <span class="cm-number">4</span>, <span class="cm-number">4</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- center point</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">g</span>:<span class="cm-variable">fill_ellipse</span>(<span class="cm-variable">width</span>/<span class="cm-number">2</span> - <span class="cm-number">3.5</span>, <span class="cm-variable">height</span>/<span class="cm-number">2</span> - <span class="cm-number">3.5</span>, <span class="cm-number">7</span>, <span class="cm-number">7</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- dial hand</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">g</span>:<span class="cm-variable">draw_line</span>(<span class="cm-variable">x</span>, <span class="cm-variable">y</span>, <span class="cm-variable">width</span>/<span class="cm-number">2</span>, <span class="cm-variable">height</span>/<span class="cm-number">2</span>, <span class="cm-number">2</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 944px;"></div><div class="CodeMirror-gutters" style="display: none; height: 944px;"></div></div></div></pre><h4 id='adding-an-outlet'><span>Adding an outlet</span></h4><p><span>We can already send phase values into our dial object, but there&#39;s no way to get them out again. So let&#39;s add an outlet which lets us do that. Now that the grunt work is already done, this is rather straightforward. First we need to add the outlet in the </span><code>initialize</code><span> method:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51801px; left: 7.98611px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation"><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.outlets</span> = <span class="cm-number">1</span></span></pre></div></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 23px;"></div><div class="CodeMirror-gutters" style="display: none; height: 23px;"></div></div></div></pre><p><span>And then we just add a message handler for </span><code>bang</code><span> which outputs the value on the outlet:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51801px; left: 7.98611px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation"><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">dial</span>:<span class="cm-variable">in_1_bang</span>()</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self</span>:<span class="cm-variable">outlet</span>(<span class="cm-number">1</span>, <span class="cm-string">"float"</span>, {<span class="cm-variable">self.phase</span>})</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 69px;"></div><div class="CodeMirror-gutters" style="display: none; height: 69px;"></div></div></div></pre><p><span>Easy as pie. Here&#39;s how our patch looks like now:</span></p><p><img src="18-graphics2.png" referrerpolicy="no-referrer" alt="Adding an outlet"></p><h4 id='mouse-actions'><span>Mouse actions</span></h4><p><span>Our dial now has all the basic ingredients, but it still lacks one important piece: Interacting with the graphical representation itself using the mouse. The graphics API makes this reasonably easy since it provides us with four callback methods that we can implement. Each of these gets invoked with the current mouse coordinates relative to the object rectangle:</span></p><ul><li><p><code>mouse_down(x, y)</code><span>: called when the mouse is clicked</span></p></li><li><p><code>mouse_up(x, y)</code><span>: called when the mouse button is released</span></p></li><li><p><code>mouse_move(x, y)</code><span>: called when the mouse changes position while the mouse button is </span><em><span>not</span></em><span> pressed</span></p></li><li><p><code>mouse_drag(x, y)</code><span>: called when the mouse changes position while the mouse button </span><em><span>is</span></em><span> pressed</span></p></li></ul><p><span>Here we only need the </span><code>mouse_down</code><span> and </span><code>mouse_drag</code><span> methods which let us keep track of mouse drags in the object rectangle in order to update the phase value and recalculate the tip of the hand (I told you that the </span><code>tip()</code><span> method would come in handy again!). Here&#39;s the Lua code. Note that the </span><code>mouse_down</code><span> callback is used to initialize the </span><code>tip_x</code><span> and </span><code>tip_y</code><span> member variables, which we keep track of during the drag operation, so that we can detect in </span><code>mouse_drag</code><span> when it&#39;s time to output the phase value and repaint the object:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua" style="break-inside: unset;"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51801px; left: 7.98611px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">dial</span>:<span class="cm-variable">mouse_down</span>(<span class="cm-variable">x</span>, <span class="cm-variable">y</span>)</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.tip_x</span>, <span class="cm-variable">self.tip_y</span> = <span class="cm-variable">self</span>:<span class="cm-variable">tip</span>()</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
 </span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">dial</span>:<span class="cm-variable">mouse_drag</span>(<span class="cm-variable">x</span>, <span class="cm-variable">y</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">local</span> <span class="cm-variable">width</span>, <span class="cm-variable">height</span> = <span class="cm-variable">self</span>:<span class="cm-variable">get_size</span>()</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
 </span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">local</span> <span class="cm-variable">x1</span>, <span class="cm-variable">y1</span> = <span class="cm-variable">x</span>/<span class="cm-variable">width-0.5</span>, <span class="cm-variable">y</span>/<span class="cm-variable">height-0.5</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- calculate the normalized phase, shifted by 0.5, since we want zero to be</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- the center up position</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">local</span> <span class="cm-variable">phase</span> = <span class="cm-builtin">math.atan</span>(<span class="cm-variable">y1</span>, <span class="cm-variable">x1</span>)/<span class="cm-builtin">math.pi</span> + <span class="cm-number">0.5</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- renormalize if we get an angle &gt; 1, to account for the phase shift</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">if</span> <span class="cm-variable">phase</span> &gt; <span class="cm-number">1</span> <span class="cm-keyword">then</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">phase</span> = <span class="cm-variable">phase</span> - <span class="cm-number">2</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
 </span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.phase</span> = <span class="cm-variable">phase</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
 </span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">local</span> <span class="cm-variable">tip_x</span>, <span class="cm-variable">tip_y</span> = <span class="cm-variable">self</span>:<span class="cm-variable">tip</span>();</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span cm-text="" cm-zwsp="">
-</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">if</span> <span class="cm-variable">tip_x</span> ~= <span class="cm-variable">self.tip_x</span> <span class="cm-keyword">or</span> <span class="cm-variable">tip_y</span> ~= <span class="cm-variable">self.tip_y</span> <span class="cm-keyword">then</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">self.tip_x</span> = <span class="cm-variable">tip_x</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">self.tip_y</span> = <span class="cm-variable">tip_y</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">self</span>:<span class="cm-variable">in_1_bang</span>()</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">self</span>:<span class="cm-variable">repaint</span>()</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 622px;"></div><div class="CodeMirror-gutters" style="display: none; height: 622px;"></div></div></div></pre><p><span>And here&#39;s the same patch again, which now lets us drag the hand to change the phase value:</span></p><p><img src="18-graphics3.png" referrerpolicy="no-referrer" alt="Dial with mouse interaction"></p><h4 id='more-dial-action-clocks-and-speedometers'><span>More dial action: clocks and speedometers</span></h4><p><span>Now that our dial object is basically finished, let&#39;s do something interesting with it. The most obvious thing is to just turn it into a clock (albeit one with just a seconds hand) counting off the seconds. For that we just need to add a metro object which increments the phase angle and sends the value to the dial each second:</span></p><p><img src="18-graphics4.png" referrerpolicy="no-referrer" alt="A clock"></p><p><span>Pd lets us store the phase angle in a named variable (</span><code>v phase</code><span>) which can be recalled in an </span><code>expr</code><span> object doing the necessary calculations. The </span><code>expr</code><span> object sends the computed value to the </span><code>phase</code><span> receiver, which updates both the variable and the upper numbox, and the numbox then updates the dial. Note that we also set the variable whenever the dial outputs a new value, so you can also drag around the hand to determine the starting phase. And we added a </span><code>0</code><span> message to reset the hand to the 12 o&#39;clock home position when needed.</span></p><p><span>Here&#39;s another little example, rather useless but fun, simulating a speedometer which just randomly moves the needle left and right:</span></p><p><img src="18-graphics5.png" referrerpolicy="no-referrer" alt="A speedometer"></p><p><span>I&#39;m sure you can imagine many more creative uses for this simple but surprisingly versatile little GUI object, which we did in just a few lines of fairly simple Lua code. Have fun with it! An extended version of this object, which covers some more features of the graphics API that we didn&#39;t discuss here to keep things simple, can be found as dial.pd and dial.pd_lua in the tutorial examples:</span></p><p><img src="18-graphics6.png" referrerpolicy="no-referrer" alt="Extended dial example"></p><p><span>The extended example adds messages for resizing the object and setting colors, and also shows how to save and restore object state in the creation arguments using the </span><code>set_args()</code><span> method mentioned at the beginning of this section. The accompanying patch covers all the examples we discussed here, and adds a third example showing how to utilize our dial object as a dB meter.</span></p><h2 id='live-coding'><span>Live coding</span></h2><p><span>I&#39;ve been telling you all along that in order to make Pd-Lua pick up changes you made to your .pd_lua files, you have to relaunch Pd and reload your patches. Well, as you probably guessed by now, this isn&#39;t actually true. So in this section we are going to cover Pd-Lua&#39;s </span><em><span>live coding</span></em><span> features, which let you modify your sources and have Pd-Lua reload them on the fly, without ever exiting the Pd environment. This rapid incremental style of development is one of the hallmark features of dynamic interactive programming environments like Pd and Lua. Musicians also like to employ it to modify their programs live on stage, which is where the term &quot;live coding&quot; comes from.</span></p><p><span>I&#39;ve kept this topic for the final section of this guide, because it is somewhat advanced, and there are several different (traditional and new) methods available which differ in capabilities and ease of use. However, in modern Pd-Lua versions there </span><em><span>is</span></em><span> one preferred method which rules them all, so if you want to cut to the chase as quickly as possible, then feel free to just skip ahead to the </span><a href='#pdxlua'><span>pdx.lua</span></a><span> section now.</span></p><p><span>If you&#39;re still here, then you probably want to learn about the other methods, too. So in the following we first describe the predefined Pd-Lua object classes </span><code>pdlua</code><span> and </span><code>pdluax</code><span>, so that you know the &quot;traditional&quot; live-coding instruments that Pd-Lua had on offer for a long time. We also discuss how to add a </span><code>reload</code><span> message to your existing object definitions. This is quite easy to do by directly employing Pd-Lua&#39;s </span><code>dofile</code><span> function, which is also what both </span><code>pdlua</code><span> and </span><code>pdluax</code><span> use internally.</span></p><p><span>These methods all work with pretty much any Pd-Lua version out there, but require a little bit of setup which can get time-consuming and error-prone if you&#39;re dealing with large patches involving a lot of different Lua objects.</span></p><p><span>That&#39;s why Pd-Lua nowadays includes an extension module called </span><em><span>pdx.lua</span></em><span> that &quot;just works&quot; out of the box and automatizes everything, so that you only have to put a simple </span><code>reload</code><span> message in your main patch and be done with it. This is also the method we recommend, to novices and expert users alike. We describe it last so that you can also gather a good understanding of Pd-Lua&#39;s traditional live coding methods, and learn to appreciate them. These are still used in many older scripts, and Pd-Lua will continue to support them for backward compatibility.</span></p><h3 id='pdlua'><span>pdlua</span></h3><p><span>The </span><code>pdlua</code><span> object accepts a single kind of message of the form </span><code>load filename</code><span> on its single inlet, which causes the given Lua file to be loaded and executed. Since </span><code>pdlua</code><span> has no outlets, its uses are rather limited. However, it does enable you to load global Lua definitions and execute an arbitrary number of statements, e.g., to post some text to the console or transmit messages to Pd receivers using the corresponding Pd-Lua functions. For instance, here&#39;s a little Lua script loadtest.lua which simply increments a global </span><code>counter</code><span> variable (first initializing it to zero if the variable doesn&#39;t exist yet) and posts its current value in the console:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51982px; left: 7.99336px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation"><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-variable">counter</span> = <span class="cm-variable">counter</span> <span class="cm-keyword">and</span> <span class="cm-variable">counter</span> + <span class="cm-number">1</span> <span class="cm-keyword">or</span> <span class="cm-number">0</span></span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-variable">pd.post</span>(<span class="cm-builtin">string.format</span>(<span class="cm-string">"loadtest: counter = %d"</span>, <span class="cm-variable">counter</span>))</span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 46px;"></div><div class="CodeMirror-gutters" style="display: none; height: 46px;"></div></div></div></pre><p><span>To run this Lua code in Pd, you just need to connect the message </span><code>load loadtest.lua</code><span> to </span><code>pdlua</code><span>&#39;s inlet (note that you really need to specify the full filename here, there&#39;s no default suffix):</span></p><p><img src="11-pdlua.png" referrerpolicy="no-referrer" alt="pdlua example"></p><p><span>Now, each time you click on the </span><code>load loadtest.lua</code><span> message, the file is reloaded and executed, resulting in some output in the console, e.g.:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang=""><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang=""><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51982px; left: 7.99336px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation"><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;">loadtest: counter = 0</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;">loadtest: counter = 1</span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 46px;"></div><div class="CodeMirror-gutters" style="display: none; height: 46px;"></div></div></div></pre><p><span>Also, you can edit the script between invocations and the new code will be loaded and used immediately. E.g., if you change </span><code>counter + 1</code><span> to </span><code>counter - 1</code><span>, you&#39;ll get:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang=""><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang=""><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51982px; left: 7.99336px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation"><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;">loadtest: counter = 0</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;">loadtest: counter = -1</span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 46px;"></div><div class="CodeMirror-gutters" style="display: none; height: 46px;"></div></div></div></pre><p><span>That&#39;s about all there is to say about </span><code>pdlua</code><span>; it&#39;s a very simple object.</span></p><h3 id='pdluax'><span>pdluax</span></h3><p><code>pdluax</code><span> is a bit more elaborate and allows you to create real Pd-Lua objects with an arbitrary number of inlets, outlets, and methods. To these ends, it takes a single creation argument, the basename of a .pd_luax file. This file is a Lua script returning a function to be executed in </span><code>pdluax</code><span>&#39;s own </span><code>initialize</code><span> method, which contains all the usual definitions, including the object&#39;s method definitions, in its body. This function receives the object&#39;s </span><code>self</code><span> as well as all the extra arguments </span><code>pdluax</code><span> was invoked with, and should return </span><code>true</code><span> if creation of the object succeeded.</span></p><p><span>For instance, here&#39;s a simplified version of our </span><code>foo</code><span> counter object, rewritten as a .pd_luax file, to be named foo.pd_luax:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51982px; left: 7.99336px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">return</span> <span class="cm-keyword">function</span> (<span class="cm-variable">self</span>, <span class="cm-variable">sel</span>, <span class="cm-variable">atoms</span>)</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.inlets</span> = <span class="cm-number">1</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.outlets</span> = <span class="cm-number">1</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.counter</span> = <span class="cm-builtin">type</span>(<span class="cm-variable">atoms</span>[<span class="cm-number">1</span>]) == <span class="cm-string">"number"</span> <span class="cm-keyword">and</span> <span class="cm-variable">atoms</span>[<span class="cm-number">1</span>] <span class="cm-keyword">or</span> <span class="cm-number">0</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.step</span> = <span class="cm-builtin">type</span>(<span class="cm-variable">atoms</span>[<span class="cm-number">2</span>]) == <span class="cm-string">"number"</span> <span class="cm-keyword">and</span> <span class="cm-variable">atoms</span>[<span class="cm-number">2</span>] <span class="cm-keyword">or</span> <span class="cm-number">1</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">function</span> <span class="cm-variable">self</span>:<span class="cm-variable">in_1_bang</span>()</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">self</span>:<span class="cm-variable">outlet</span>(<span class="cm-number">1</span>, <span class="cm-string">"float"</span>, {<span class="cm-variable">self.counter</span>})</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">self.counter</span> = <span class="cm-variable">self.counter</span> + <span class="cm-variable">self.step</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">return</span> <span class="cm-keyword">true</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 253px;"></div><div class="CodeMirror-gutters" style="display: none; height: 253px;"></div></div></div></pre><p><span>Note the colon syntax </span><code>self:in_1_bang()</code><span>. This adds the bang method directly to the </span><code>self</code><span> object rather than its class, which is </span><code>pdluax</code><span>. (We obviously don&#39;t want to modify the class itself, which may be used to create any number of different kinds of objects, each with their own collection of methods.) Also note that the outer function is &quot;anonymous&quot; (nameless) here; you can name it, but there&#39;s usually no need to do that, because this function will be executed just once, when the corresponding </span><code>pdluax</code><span> object is created. Another interesting point to mention here is that this approach of including all the object&#39;s method definitions in its initialization method works with regular .pd_lua objects, too; try it!</span></p><p><span>In the patch, we invoke a .pd_luax object by specifying the basename of its script file  as </span><code>pdluax</code><span>&#39;s first argument, adding any additional creation arguments that the object itself might need:</span></p><p><img src="12-pdluax.png" referrerpolicy="no-referrer" alt="pdluax example"></p><p><span>These </span><code>pdluax foo</code><span> objects work just the same as their regular </span><code>foo</code><span> counterparts, but there&#39;s an important difference: The code in foo.pd_luax is loaded </span><em><span>every time</span></em><span> you create a new </span><code>pdluax foo</code><span> object. Thus you can easily modify that file and just add a new </span><code>pdluax foo</code><span> object to have it run the latest version of your code. For instance, in foo.pd_luax take the line that reads:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51982px; left: 7.99336px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation"><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">self.counter</span> = <span class="cm-variable">self.counter</span> + <span class="cm-variable">self.step</span></span></pre></div></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 23px;"></div><div class="CodeMirror-gutters" style="display: none; height: 23px;"></div></div></div></pre><p><span>Now change that </span><code>+</code><span> operator to </span><code>-</code><span>:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51982px; left: 7.99336px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation"><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">self.counter</span> = <span class="cm-variable">self.counter</span> - <span class="cm-variable">self.step</span></span></pre></div></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 23px;"></div><div class="CodeMirror-gutters" style="display: none; height: 23px;"></div></div></div></pre><p><span>Don&#39;t forget to save your edits, then go back to the patch and recreate the </span><code>pdluax foo</code><span> object on the left. The quickest way to do that is to just delete the object, then use Pd&#39;s &quot;Undo&quot; operation, Ctrl+Z. Et voilà: the new object now decrements the counter rather than incrementing it. Also note that the other object on the right still runs the old code which increments the counter; thus you will have to give that object the same treatment if you want to update it, too.</span></p><p><span>While </span><code>pdluax</code><span> was considered Pd-Lua&#39;s main workhorse for live coding in the past, it has its quirks. Most notably, the syntax is different from regular object definitions, so you have to change the code if you want to turn it into a .pd_lua file. Also, having to recreate an object to reload the script file is quite disruptive (it resets the internal state of the object), and may leave objects in an inconsistent state (different objects may use various different versions of the same script file). Sometimes this may be what you want, but it makes </span><code>pdluax</code><span> somewhat difficult to use. It&#39;s not really tailored for interactive development, but it shines if you need a specialized tool for changing your objects on a whim in a live situation.</span></p><p><span>Fortunately, if you&#39;re not content with Pd-Lua&#39;s traditional facilities for live coding, it&#39;s easy to roll your own using the internal </span><code>dofile</code><span> method, which is discussed in the next subsection.</span></p><h3 id='dofile-and-dofilex'><span>dofile and dofilex</span></h3><p><span>So let&#39;s discuss how to use </span><code>dofile</code><span> in a direct fashion. Actually, we&#39;re going to use its companion </span><code>dofilex</code><span> here, which works the same as </span><code>dofile</code><span>, but loads Lua code relative to the &quot;externdir&quot; of the class (the directory of the .pd_lua file) rather than the directory of the Pd canvas with the pdlua object, which is what </span><code>dofile</code><span> does. Normally, this won&#39;t make much of a difference, but it </span><em><span>will</span></em><span> matter if Lua class names are specified using relative pathnames, such as </span><code>../foo</code><span> or </span><code>bar/baz</code><span>. Since we&#39;re reloading class definitions here, it&#39;s better to use </span><code>dofilex</code><span> so that our objects don&#39;t break if we move things about.</span></p><p><span>The method we sketch out below is really simple and doesn&#39;t have any of the drawbacks of the </span><code>pdluax</code><span> object, but you still have to add a small amount of boilerplate code to your existing object definition. Here is how </span><code>dofilex</code><span> is invoked:</span></p><ul><li><p><code>self:dofilex(scriptname)</code><span>: This loads the given Lua script, like Lua&#39;s </span><code>loadfile</code><span>, but also performs a search on Pd&#39;s path to locate the file, and finally executes the file if it was loaded successfully. Note that </span><code>self</code><span> must be a valid Pd-Lua object, which is used solely to determine the externdir of the object&#39;s class, so that the script will be found if it is located there.</span></p></li></ul><p><span>The return values of </span><code>dofilex</code><span> are those of the Lua script, along with the path under which the script was found. If the script itself returns no value, then only the path will be returned. (We don&#39;t use any of this information in what follows, but it may be useful in more elaborate schemes. For instance, </span><code>pdluax</code><span> uses the returned function to initialize the object, and the path in setting up the object&#39;s actual script name.)</span></p><p><span>Of course, </span><code>dofilex</code><span> needs the name of the script file to be loaded. We could hardcode this as a string literal, but it&#39;s easier to just ask the object itself for this information. Each Pd-Lua object has a number of private member variables, among them </span><code>_name</code><span> (which is the name under which the object class was registered) and </span><code>_scriptname</code><span> (which is the name of the corresponding script file, usually this is just </span><code>_name</code><span> with the </span><code>.pd_lua</code><span> extension tacked onto it). The latter is what we need. Pd-Lua also offers a </span><code>whoami()</code><span> method for this purpose, but that method just returns </span><code>_scriptname</code><span> if it is set, or </span><code>_name</code><span> otherwise. Regular Pd-Lua objects always have </span><code>_scriptname</code><span> set, so it will do for our purposes.</span></p><p><span>Finally, we need to decide how to invoke </span><code>dofilex</code><span> in our object. The easiest way to do this is to just add a message handler (i.e., an inlet method) to the object. For instance, say that the object is named </span><code>foo</code><span> which is defined in the foo.pd_lua script. Then all you have to do is add something like the following definition to the script:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51982px; left: 7.99336px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation"><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">foo</span>:<span class="cm-variable">in_1_reload</span>()</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self</span>:<span class="cm-variable">dofilex</span>(<span class="cm-variable">self._scriptname</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 69px;"></div><div class="CodeMirror-gutters" style="display: none; height: 69px;"></div></div></div></pre><p><span>As we already discussed, this code uses the object&#39;s internal </span><code>_scriptname</code><span> variable, and so is completely generic. You can just copy this over to any .pd_lua file, if you replace the </span><code>foo</code><span> prefix with whatever the name of your actual class variable is. With that definition added, you can now just send the object a </span><code>reload</code><span> message whenever you want to have its script file reloaded.</span></p><hr /><p><strong><span>NOTE:</span></strong><span> This works because the </span><code>pd.Class:new():register(&quot;foo&quot;)</code><span> call of the object only registers a new class if that object class doesn&#39;t exist yet; otherwise it just returns the existing class.</span></p><p><span>By reloading the script file, all of the object&#39;s method definitions will be overwritten, not only for the object receiving the </span><code>reload</code><span> message, but for </span><em><span>all</span></em><span> objects of the same class, so it&#39;s sufficient to send the message to any (rather than every) object of the class. Also, existing object state (as embodied by the internal member variables of each object) will be preserved.</span></p><p><span>In general all this works pretty well, but there are some caveats, too. Note that if you </span><em><span>delete</span></em><span> one of the object&#39;s methods, or change its name, the old method will still hang around in the runtime class definition until you relaunch Pd. That&#39;s because reloading the script does not erase any old method definitions, it merely replaces existing and adds new ones.</span></p><p><span>Finally, keep in mind that reloading the script file does </span><em><span>not</span></em><span> re-execute the </span><code>initialize</code><span> method. This method is only invoked when an object is instantiated. Thus, in particular, reloading the file won&#39;t change the number of inlets and outlets of an existing object. Newly created objects </span><em><span>will</span></em><span> pick up the changes in </span><code>initialize</code><span>, though, and have the proper number of inlets and outlets if those member variables were changed.</span></p><hr /><p><span>Let&#39;s give this a try, using luatab.pd_lua from the &quot;Using arrays and tables&quot; section as an example. In fact, that&#39;s a perfect showcase for live coding, since we want to be able to change the definition of the waveform function </span><code>f</code><span> in </span><code>luatab:in_1_float</code><span> on the fly. Just add the following code to the end of luatab.pd_lua:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51982px; left: 7.99336px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation"><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">luatab</span>:<span class="cm-variable">in_1_reload</span>()</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self</span>:<span class="cm-variable">dofilex</span>(<span class="cm-variable">self._scriptname</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 69px;"></div><div class="CodeMirror-gutters" style="display: none; height: 69px;"></div></div></div></pre><p><span>Now launch the luatab.pd patch and connect a </span><code>reload</code><span> message to the </span><code>luatab wave</code><span> object, like so:</span></p><p><img src="13-livecoding1.png" referrerpolicy="no-referrer" alt="Live-coding with dofilex 1"></p><p><span>Next change the wavetable function to whatever you want, e.g.:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51982px; left: 7.99336px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation"><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-keyword">local</span> <span class="cm-keyword">function</span> <span class="cm-variable">f</span>(<span class="cm-variable">x</span>)</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp; &nbsp; <span class="cm-keyword">return</span> <span class="cm-builtin">math.sin</span>(<span class="cm-number">2</span>*<span class="cm-builtin">math.pi</span>*<span class="cm-variable">freq</span>*<span class="cm-variable">x</span>)+<span class="cm-number">1</span>/<span class="cm-number">3</span>*<span class="cm-builtin">math.sin</span>(<span class="cm-number">2</span>*<span class="cm-builtin">math.pi</span>*<span class="cm-number">3</span>*<span class="cm-variable">freq</span>*<span class="cm-variable">x</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 69px;"></div><div class="CodeMirror-gutters" style="display: none; height: 69px;"></div></div></div></pre><p><span>Return to the patch, click the </span><code>reload</code><span> message, and finally reenter the frequency value, so that the waveform gets updated:</span></p><p><img src="14-livecoding2.png" referrerpolicy="no-referrer" alt="Live-coding with dofilex 2"></p><h3 id='pdxlua'><span>pdx.lua</span></h3><p><span>The method sketched out in the preceding subsection works well enough for simple patches. However, having to manually wire up the </span><code>reload</code><span> message to one object of each class that you&#39;re editing is still quite cumbersome. In a big patch, which is being changed all the time, this quickly becomes unwieldy. Wouldn&#39;t it be nice if we could equip each object with a special receiver, so that we can just click a message somewhere in the patch to reload a given class, or even all Pd-Lua objects at once? Or even send that message via the </span><code>pdsend</code><span> program, e.g., from the text editor in which you edit the Lua source of your object?</span></p><p><span>Well, all this is in fact possible, but the implementation is a bit too involved to fully present here. So we have provided this in a separate pdx.lua module, which you can find in the sources accompanying this tutorial for your perusal. As of Pd-Lua 0.12.8, pdx.lua is pre-loaded and all the required setup is performed automatically. You only have to add a message like the following to your patch, which goes to the special </span><code>pdluax</code><span> receiver (note that this is unrelated to the </span><code>pdluax</code><span> object discussed previously, it just incidentally uses the same name):</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang=""><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang=""><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51982px; left: 7.99336px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation"><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;">; pdluax reload</span></pre></div></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 23px;"></div><div class="CodeMirror-gutters" style="display: none; height: 23px;"></div></div></div></pre><p><span>When clicked, this just reloads all Pd-Lua objects in the patch. You can also specify the class to be reloaded (the receiver matches this against each object&#39;s class name):</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang=""><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang=""><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51982px; left: 7.99336px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation"><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;">; pdluax reload foo</span></pre></div></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 23px;"></div><div class="CodeMirror-gutters" style="display: none; height: 23px;"></div></div></div></pre><p><span>Or maybe name several classes, like so:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang=""><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang=""><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51982px; left: 7.99336px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation"><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;">; pdluax reload foo, reload bar</span></pre></div></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 23px;"></div><div class="CodeMirror-gutters" style="display: none; height: 23px;"></div></div></div></pre><p><span>You get the idea. Getting set up for remote control via </span><code>pdsend</code><span> isn&#39;t much harder. E.g., let&#39;s say that we use UDP port 4711 on localhost for communicating with Pd, then you just need to connect </span><code>netreceive 4711 1</code><span> to the </span><code>pdluax</code><span> receiver in a suitable way. Let&#39;s use the luatab.pd_lua object from the previous subsection as an example. You can remove the </span><code>in_1_reload</code><span> handler from that script -- it&#39;s no longer needed, as pdx.lua now dispatches the </span><code>reload</code><span> messages for us. Here&#39;s how the revised patch looks like:</span></p><p><img src="15-remote-control1.png" referrerpolicy="no-referrer" alt="Live-coding with remote control"></p><p><span>This doesn&#39;t look any simpler than before, but it also does a whole lot more. Clicking the message not just reloads the </span><code>luatab</code><span> script, but </span><em><span>any</span></em><span> Lua object you have running, in </span><em><span>any</span></em><span> of the patches you have opened. And you can now use </span><code>pdsend 4711 localhost udp</code><span> to reload your Lua objects from literally anywhere. Any decent code editor will let you bind a keyboard command which does this for you. Myself, I&#39;m a die-hard Emacs fan, so I&#39;ve included a little elisp module </span><em><span>pd-remote.el</span></em><span> which shows how to do this. Once you&#39;ve added this to your .emacs, you can just type Ctrl+C Ctrl+K in any Lua buffer to make Pd reload your Lua scripts after editing them. It doesn&#39;t get much easier than that.</span></p><p><span>In addition, I&#39;ve provided a little abstraction named </span><em><span>pd-remote.pd</span></em><span> which takes care of adding the </span><code>netreceive</code><span> and messaging bits and also looks much tidier in your patches. Using the abstraction is easy: Insert </span><code>pd-remote</code><span> into the patch you&#39;re working on, and (optionally) connect a </span><code>pdluax reload</code><span> message (without the </span><code>;</code><span> prefix) to the inlet of the abstraction; or use something like </span><code>pdluax reload foo</code><span> to reload a specific object class. Now you can just click on that message to reload your script files, and the abstraction will also respond to such messages on port 4711 (the port number can be changed in the abstraction if needed). Here&#39;s how that looks like in a patch:</span></p><p><img src="15-remote-control2.png" referrerpolicy="no-referrer" alt="Live-coding with pd-remote.pd"></p><hr /><p><strong><span>NOTE:</span></strong><span> To make Pd find the pd-remote.pd abstraction without having to copy it to your project directory, you can add the pdlua external directory (which is where the abstraction gets installed) to your Pd library path, either in your Pd setup, or inside the patch with a </span><code>declare -stdpath</code><span> object, as shown above.</span></p><p><span>The pd-remote.el file can be installed in your Emacs site-lisp directory if needed. However, the easiest way to install it is from </span><a href='https://melpa.org/'><span>MELPA</span></a><span>, a large repository of Emacs packages. Please also check the </span><a href='https://github.com/agraef/pd-remote'><span>pd-remote</span></a><span> repository on GitHub for the latest pd-remote version and further details. This also includes a pointer to a Visual Studio Code extension written by Baris Altun which can be used as a replacement for pd-remote.el if you prefer VS Code for editing.</span></p><hr /><p><span>And here&#39;s a little gif showing the above patch in action. You may want to watch this in </span><a href='https://www.typora.io/'><span>Typora</span></a><span> or your favorite web browser to make the animation work.</span></p><p><img src="16-remote-control2.gif" referrerpolicy="no-referrer" alt="Live-coding in action"></p><p><span>So there you have it: Not one, not two, but three different ways to live-code with Pd-Lua (or four, if you count in the </span><code>pdlua</code><span> object). pdx.lua certainly is the most advanced and user-friendly solution among these, but you can choose whatever best fits your purpose and is the most convenient for you.</span></p><h3 id='object-reinitialization-in-pdxlua'><span>Object reinitialization in pdx.lua</span></h3><p><span>If pdx.lua reloads a script file, it normally does </span><em><span>not</span></em><span> run the </span><code>initialize</code><span> method. This is by design, as we want the reload process to be as smooth as possible while running a patch, and invoking the </span><code>initialize</code><span> method could potentially be quite disruptive, as it usually reinitializes all your member variables.</span></p><p><span>However, pdx.lua has another trick up its sleeve if you do need some kind of custom reinitialization. There are two callback methods that you can implement, </span><code>prereload</code><span> and </span><code>postreload</code><span> which will be invoked immediately before and after reloading the script file, respectively.  Either method can be used to reinitialize your objects during reloading in any desired way. The only difference between the two methods is that </span><code>prereload</code><span> still runs in the old script, while </span><code>postreload</code><span> executes the new code which has just been loaded. Typically you&#39;d use </span><code>prereload</code><span> to perform any required bookkeeping or state-saving before the script gets loaded, and </span><code>postreload</code><span> for custom initialization afterwards.</span></p><p><span>In particular, these callbacks can change any member variables, either directly or by invoking other methods. The most important use cases probably are to change the </span><code>inlets</code><span> and </span><code>outlets</code><span> variables, and to add a </span><code>paint</code><span> method, which can be done on the fly to reconfigure your objects accordingly. To these ends, you can just call the </span><code>initialize</code><span> method from </span><code>postreload</code><span>. To demonstrate this, in the tutorial examples you&#39;ll find a pdxtest.pd patch and pdxtest~.pd_lua script. The script has the following </span><code>reload</code><span> method:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51982px; left: 7.99336px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">pdxtest</span>:<span class="cm-variable">postreload</span>()</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- stuff to do post-reload goes here</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">pd.post</span>(<span class="cm-string">"Reloaded!"</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- instead of doing a full initialization, you could also just change the</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- number of inlets and outlets here</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self</span>:<span class="cm-variable">initialize</span>()</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 161px;"></div><div class="CodeMirror-gutters" style="display: none; height: 161px;"></div></div></div></pre><p><span>Now, if you need to change the number of inlets and outlets of the object, you can just modify the definitions of </span><code>inlets</code><span> and </span><code>outlets</code><span> in the script&#39;s </span><code>initialize</code><span> method and reload. Easy as pie. Try it! Instructions can be found in the script.</span></p><h3 id='live-coding-and-dsp'><span>Live coding and dsp</span></h3><p><span>One caveat about using any of the above live-coding solutions in conjunction with Pd-Lua&#39;s </span><a href='#signals'><span>signal processing capabilities</span></a><span> is in order. When the Lua code of an object class gets reloaded, the existing code is replaced immediately. There isn&#39;t any kind of automatic &quot;cross-fade&quot; between old and new code. If you change the </span><code>perform</code><span> method of that class, there may well be discontinuities in the generated output signals which result in audible clicks. This won&#39;t matter much if you&#39;re just developing an object in your studio. But live on stage you may want to avoid this -- unless you accept or even cherish such glitches as part of your live performance.</span></p><p><span>There are ways to work around this issue, however. To demonstrate this, the tutorial examples include the following live-xfade.pd patch:</span></p><p><img src="17-live-xfade.png" referrerpolicy="no-referrer" alt="Live cross-fade"></p><p><span>The </span><code>foo~</code><span> and </span><code>bar~</code><span> objects in this example are essentially the same, with some minor variations in the sound generation parameters. The particular sounds in this example are not important, each object just outputs a random walk of sine waves of varying frequencies with some phase distortion. But they </span><em><span>will</span></em><span> produce clicks when switching them abruptly, thus we need a smooth cross-fade between the two sound sources. This is handled by the </span><a href='#real-world-example-cross-fades'><code>luaxfade~</code></a><span> object from the Signals section.</span></p><p><span>What&#39;s special here is that the transitions are being triggered automatically, </span><em><span>by the received reload messages</span></em><span>. By these means, you can edit, say, the </span><code>foo~</code><span> object while the </span><code>bar~</code><span> object is playing, then save your edits and send a </span><code>reload</code><span> message. At this point the new code for </span><code>foo~</code><span> is loaded while the cross-fade from </span><code>bar~</code><span> to </span><code>foo~</code><span> is initiated at the same time.</span></p><p><span>This method obviously requires some preparation and diligence when being used live on stage. Having some kind of automatic cross-fade functionality for dsp objects baked into Pd-Lua&#39;s run-time system would make this a lot easier. Maybe this can be provided by pdx.lua in a future release.</span></p><h2 id='conclusion'><span>Conclusion</span></h2><p><span>Congratulations! If you made it this far, you should have learned more than enough to start using Pd-Lua successfully for your own projects. You should also be able to read and understand the many examples in the Pd-Lua distribution, which illustrate all the various features in much more detail than we could muster in this introduction. You can find these in the examples folder, both in the Pd-Lua sources and the pdlua folder of your Pd installation.</span></p><p><span>The examples accompanying this tutorial (including the pdx.lua, pdlua-remote.el and pdlua-remote.pd files mentioned at the end of the pdx.lua section) are also available for your perusal in the examples subdirectory of the folder where you found this document.</span></p><p><span>Finally, I&#39;d like to thank Claude Heiland-Allen for creating such an amazing tool, it makes programming Pd externals really easy and fun. Kudos also to Roberto Ierusalimschy for Lua, which for me is one of the best-designed, easiest to learn, and most capable multi-paradigm scripting languages there are today, while also being fast, simple, and light-weight.</span></p></div></div>
+</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">if</span> <span class="cm-variable">tip_x</span> ~= <span class="cm-variable">self.tip_x</span> <span class="cm-keyword">or</span> <span class="cm-variable">tip_y</span> ~= <span class="cm-variable">self.tip_y</span> <span class="cm-keyword">then</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">self.tip_x</span> = <span class="cm-variable">tip_x</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">self.tip_y</span> = <span class="cm-variable">tip_y</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">self</span>:<span class="cm-variable">in_1_bang</span>()</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">self</span>:<span class="cm-variable">repaint</span>()</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 622px;"></div><div class="CodeMirror-gutters" style="display: none; height: 622px;"></div></div></div></pre><p><span>And here&#39;s the same patch again, which now lets us drag the hand to change the phase value:</span></p><p><img src="18-graphics3.png" referrerpolicy="no-referrer" alt="Dial with mouse interaction"></p><h4 id='more-dial-action-clocks-and-speedometers'><span>More dial action: clocks and speedometers</span></h4><p><span>Now that our dial object is basically finished, let&#39;s do something interesting with it. The most obvious thing is to just turn it into a clock (albeit one with just a seconds hand) counting off the seconds. For that we just need to add a metro object which increments the phase angle and sends the value to the dial each second:</span></p><p><img src="18-graphics4.png" referrerpolicy="no-referrer" alt="A clock"></p><p><span>Pd lets us store the phase angle in a named variable (</span><code>v phase</code><span>) which can be recalled in an </span><code>expr</code><span> object doing the necessary calculations. The </span><code>expr</code><span> object sends the computed value to the </span><code>phase</code><span> receiver, which updates both the variable and the upper numbox, and the numbox then updates the dial. Note that we also set the variable whenever the dial outputs a new value, so you can also drag around the hand to determine the starting phase. And we added a </span><code>0</code><span> message to reset the hand to the 12 o&#39;clock home position when needed.</span></p><p><span>Here&#39;s another little example, rather useless but fun, simulating a speedometer which just randomly moves the needle left and right:</span></p><p><img src="18-graphics5.png" referrerpolicy="no-referrer" alt="A speedometer"></p><p><span>I&#39;m sure you can imagine many more creative uses for this simple but surprisingly versatile little GUI object, which we did in just a few lines of fairly simple Lua code. Have fun with it! An extended version of this object, which covers some more features of the graphics API that we didn&#39;t discuss here to keep things simple, can be found as dial.pd and dial.pd_lua in the tutorial examples:</span></p><p><img src="18-graphics6.png" referrerpolicy="no-referrer" alt="Extended dial example"></p><p><span>The extended example adds messages for resizing the object and setting colors, and also shows how to save and restore object state in the creation arguments using the </span><code>set_args()</code><span> method mentioned at the beginning of this section. The accompanying patch covers all the examples we discussed here, and adds a third example showing how to utilize our dial object as a dB meter.</span></p><h2 id='live-coding'><span>Live coding</span></h2><p><span>I&#39;ve been telling you all along that in order to make Pd-Lua pick up changes you made to your .pd_lua files, you have to relaunch Pd and reload your patches. Well, as you probably guessed by now, this isn&#39;t actually true. So in this section we are going to cover Pd-Lua&#39;s </span><em><span>live coding</span></em><span> features, which let you modify your sources and have Pd-Lua reload them on the fly, without ever exiting the Pd environment. This rapid incremental style of development is one of the hallmark features of dynamic interactive programming environments like Pd and Lua. Musicians also like to employ it to modify their programs live on stage, which is where the term &quot;live coding&quot; comes from.</span></p><p><span>I&#39;ve kept this topic for the final section of this guide, because it is somewhat advanced, and there are several different (traditional and new) methods available which differ in capabilities and ease of use. However, in modern Pd-Lua versions there </span><em><span>is</span></em><span> one preferred method which rules them all, so if you want to cut to the chase as quickly as possible, then feel free to just skip ahead to the </span><a href='#pdxlua'><span>pdx.lua</span></a><span> section now.</span></p><p><span>If you&#39;re still here, then you probably want to learn about the other methods, too. So in the following we first describe the predefined Pd-Lua object classes </span><code>pdlua</code><span> and </span><code>pdluax</code><span>, so that you know the &quot;traditional&quot; live-coding instruments that Pd-Lua had on offer for a long time. We also discuss how to add a </span><code>reload</code><span> message to your existing object definitions. This is quite easy to do by directly employing Pd-Lua&#39;s </span><code>dofile</code><span> function, which is also what both </span><code>pdlua</code><span> and </span><code>pdluax</code><span> use internally.</span></p><p><span>These methods all work with pretty much any Pd-Lua version out there, but require a little bit of setup which can get time-consuming and error-prone if you&#39;re dealing with large patches involving a lot of different Lua objects.</span></p><p><span>That&#39;s why Pd-Lua nowadays includes an extension module called </span><em><span>pdx.lua</span></em><span> that &quot;just works&quot; out of the box and automatizes everything, so that you only have to put a simple </span><code>reload</code><span> message in your main patch and be done with it. This is also the method we recommend, to novices and expert users alike. We describe it last so that you can also gather a good understanding of Pd-Lua&#39;s traditional live coding methods, and learn to appreciate them. These are still used in many older scripts, and Pd-Lua will continue to support them for backward compatibility.</span></p><h3 id='pdlua'><span>pdlua</span></h3><p><span>The </span><code>pdlua</code><span> object accepts a single kind of message of the form </span><code>load filename</code><span> on its single inlet, which causes the given Lua file to be loaded and executed. Since </span><code>pdlua</code><span> has no outlets, its uses are rather limited. However, it does enable you to load global Lua definitions and execute an arbitrary number of statements, e.g., to post some text to the console or transmit messages to Pd receivers using the corresponding Pd-Lua functions. For instance, here&#39;s a little Lua script loadtest.lua which simply increments a global </span><code>counter</code><span> variable (first initializing it to zero if the variable doesn&#39;t exist yet) and posts its current value in the console:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51801px; left: 7.98611px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation"><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-variable">counter</span> = <span class="cm-variable">counter</span> <span class="cm-keyword">and</span> <span class="cm-variable">counter</span> + <span class="cm-number">1</span> <span class="cm-keyword">or</span> <span class="cm-number">0</span></span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-variable">pd.post</span>(<span class="cm-builtin">string.format</span>(<span class="cm-string">"loadtest: counter = %d"</span>, <span class="cm-variable">counter</span>))</span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 46px;"></div><div class="CodeMirror-gutters" style="display: none; height: 46px;"></div></div></div></pre><p><span>To run this Lua code in Pd, you just need to connect the message </span><code>load loadtest.lua</code><span> to </span><code>pdlua</code><span>&#39;s inlet (note that you really need to specify the full filename here, there&#39;s no default suffix):</span></p><p><img src="11-pdlua.png" referrerpolicy="no-referrer" alt="pdlua example"></p><p><span>Now, each time you click on the </span><code>load loadtest.lua</code><span> message, the file is reloaded and executed, resulting in some output in the console, e.g.:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang=""><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang=""><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51801px; left: 7.98611px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation"><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;">loadtest: counter = 0</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;">loadtest: counter = 1</span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 46px;"></div><div class="CodeMirror-gutters" style="display: none; height: 46px;"></div></div></div></pre><p><span>Also, you can edit the script between invocations and the new code will be loaded and used immediately. E.g., if you change </span><code>counter + 1</code><span> to </span><code>counter - 1</code><span>, you&#39;ll get:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang=""><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang=""><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51801px; left: 7.98611px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation"><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;">loadtest: counter = 0</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;">loadtest: counter = -1</span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 46px;"></div><div class="CodeMirror-gutters" style="display: none; height: 46px;"></div></div></div></pre><p><span>That&#39;s about all there is to say about </span><code>pdlua</code><span>; it&#39;s a very simple object.</span></p><h3 id='pdluax'><span>pdluax</span></h3><p><code>pdluax</code><span> is a bit more elaborate and allows you to create real Pd-Lua objects with an arbitrary number of inlets, outlets, and methods. To these ends, it takes a single creation argument, the basename of a .pd_luax file. This file is a Lua script returning a function to be executed in </span><code>pdluax</code><span>&#39;s own </span><code>initialize</code><span> method, which contains all the usual definitions, including the object&#39;s method definitions, in its body. This function receives the object&#39;s </span><code>self</code><span> as well as all the extra arguments </span><code>pdluax</code><span> was invoked with, and should return </span><code>true</code><span> if creation of the object succeeded.</span></p><p><span>For instance, here&#39;s a simplified version of our </span><code>foo</code><span> counter object, rewritten as a .pd_luax file, to be named foo.pd_luax:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51801px; left: 7.98611px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">return</span> <span class="cm-keyword">function</span> (<span class="cm-variable">self</span>, <span class="cm-variable">sel</span>, <span class="cm-variable">atoms</span>)</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.inlets</span> = <span class="cm-number">1</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.outlets</span> = <span class="cm-number">1</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.counter</span> = <span class="cm-builtin">type</span>(<span class="cm-variable">atoms</span>[<span class="cm-number">1</span>]) == <span class="cm-string">"number"</span> <span class="cm-keyword">and</span> <span class="cm-variable">atoms</span>[<span class="cm-number">1</span>] <span class="cm-keyword">or</span> <span class="cm-number">0</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self.step</span> = <span class="cm-builtin">type</span>(<span class="cm-variable">atoms</span>[<span class="cm-number">2</span>]) == <span class="cm-string">"number"</span> <span class="cm-keyword">and</span> <span class="cm-variable">atoms</span>[<span class="cm-number">2</span>] <span class="cm-keyword">or</span> <span class="cm-number">1</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">function</span> <span class="cm-variable">self</span>:<span class="cm-variable">in_1_bang</span>()</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">self</span>:<span class="cm-variable">outlet</span>(<span class="cm-number">1</span>, <span class="cm-string">"float"</span>, {<span class="cm-variable">self.counter</span>})</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">self.counter</span> = <span class="cm-variable">self.counter</span> + <span class="cm-variable">self.step</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">end</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-keyword">return</span> <span class="cm-keyword">true</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 253px;"></div><div class="CodeMirror-gutters" style="display: none; height: 253px;"></div></div></div></pre><p><span>Note the colon syntax </span><code>self:in_1_bang()</code><span>. This adds the bang method directly to the </span><code>self</code><span> object rather than its class, which is </span><code>pdluax</code><span>. (We obviously don&#39;t want to modify the class itself, which may be used to create any number of different kinds of objects, each with their own collection of methods.) Also note that the outer function is &quot;anonymous&quot; (nameless) here; you can name it, but there&#39;s usually no need to do that, because this function will be executed just once, when the corresponding </span><code>pdluax</code><span> object is created. Another interesting point to mention here is that this approach of including all the object&#39;s method definitions in its initialization method works with regular .pd_lua objects, too; try it!</span></p><p><span>In the patch, we invoke a .pd_luax object by specifying the basename of its script file  as </span><code>pdluax</code><span>&#39;s first argument, adding any additional creation arguments that the object itself might need:</span></p><p><img src="12-pdluax.png" referrerpolicy="no-referrer" alt="pdluax example"></p><p><span>These </span><code>pdluax foo</code><span> objects work just the same as their regular </span><code>foo</code><span> counterparts, but there&#39;s an important difference: The code in foo.pd_luax is loaded </span><em><span>every time</span></em><span> you create a new </span><code>pdluax foo</code><span> object. Thus you can easily modify that file and just add a new </span><code>pdluax foo</code><span> object to have it run the latest version of your code. For instance, in foo.pd_luax take the line that reads:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51801px; left: 7.98611px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation"><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">self.counter</span> = <span class="cm-variable">self.counter</span> + <span class="cm-variable">self.step</span></span></pre></div></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 23px;"></div><div class="CodeMirror-gutters" style="display: none; height: 23px;"></div></div></div></pre><p><span>Now change that </span><code>+</code><span> operator to </span><code>-</code><span>:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51801px; left: 7.98611px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation"><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-variable">self.counter</span> = <span class="cm-variable">self.counter</span> - <span class="cm-variable">self.step</span></span></pre></div></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 23px;"></div><div class="CodeMirror-gutters" style="display: none; height: 23px;"></div></div></div></pre><p><span>Don&#39;t forget to save your edits, then go back to the patch and recreate the </span><code>pdluax foo</code><span> object on the left. The quickest way to do that is to just delete the object, then use Pd&#39;s &quot;Undo&quot; operation, Ctrl+Z. Et voilà: the new object now decrements the counter rather than incrementing it. Also note that the other object on the right still runs the old code which increments the counter; thus you will have to give that object the same treatment if you want to update it, too.</span></p><p><span>While </span><code>pdluax</code><span> was considered Pd-Lua&#39;s main workhorse for live coding in the past, it has its quirks. Most notably, the syntax is different from regular object definitions, so you have to change the code if you want to turn it into a .pd_lua file. Also, having to recreate an object to reload the script file is quite disruptive (it resets the internal state of the object), and may leave objects in an inconsistent state (different objects may use various different versions of the same script file). Sometimes this may be what you want, but it makes </span><code>pdluax</code><span> somewhat difficult to use. It&#39;s not really tailored for interactive development, but it shines if you need a specialized tool for changing your objects on a whim in a live situation.</span></p><p><span>Fortunately, if you&#39;re not content with Pd-Lua&#39;s traditional facilities for live coding, it&#39;s easy to roll your own using the internal </span><code>dofile</code><span> method, which is discussed in the next subsection.</span></p><h3 id='dofile-and-dofilex'><span>dofile and dofilex</span></h3><p><span>So let&#39;s discuss how to use </span><code>dofile</code><span> in a direct fashion. Actually, we&#39;re going to use its companion </span><code>dofilex</code><span> here, which works the same as </span><code>dofile</code><span>, but loads Lua code relative to the &quot;externdir&quot; of the class (the directory of the .pd_lua file) rather than the directory of the Pd canvas with the pdlua object, which is what </span><code>dofile</code><span> does. Normally, this won&#39;t make much of a difference, but it </span><em><span>will</span></em><span> matter if Lua class names are specified using relative pathnames, such as </span><code>../foo</code><span> or </span><code>bar/baz</code><span>. Since we&#39;re reloading class definitions here, it&#39;s better to use </span><code>dofilex</code><span> so that our objects don&#39;t break if we move things about.</span></p><p><span>The method we sketch out below is really simple and doesn&#39;t have any of the drawbacks of the </span><code>pdluax</code><span> object, but you still have to add a small amount of boilerplate code to your existing object definition. Here is how </span><code>dofilex</code><span> is invoked:</span></p><ul><li><p><code>self:dofilex(scriptname)</code><span>: This loads the given Lua script, like Lua&#39;s </span><code>loadfile</code><span>, but also performs a search on Pd&#39;s path to locate the file, and finally executes the file if it was loaded successfully. Note that </span><code>self</code><span> must be a valid Pd-Lua object, which is used solely to determine the externdir of the object&#39;s class, so that the script will be found if it is located there.</span></p></li></ul><p><span>The return values of </span><code>dofilex</code><span> are those of the Lua script, along with the path under which the script was found. If the script itself returns no value, then only the path will be returned. (We don&#39;t use any of this information in what follows, but it may be useful in more elaborate schemes. For instance, </span><code>pdluax</code><span> uses the returned function to initialize the object, and the path in setting up the object&#39;s actual script name.)</span></p><p><span>Of course, </span><code>dofilex</code><span> needs the name of the script file to be loaded. We could hardcode this as a string literal, but it&#39;s easier to just ask the object itself for this information. Each Pd-Lua object has a number of private member variables, among them </span><code>_name</code><span> (which is the name under which the object class was registered) and </span><code>_scriptname</code><span> (which is the name of the corresponding script file, usually this is just </span><code>_name</code><span> with the </span><code>.pd_lua</code><span> extension tacked onto it). The latter is what we need. Pd-Lua also offers a </span><code>whoami()</code><span> method for this purpose, but that method just returns </span><code>_scriptname</code><span> if it is set, or </span><code>_name</code><span> otherwise. Regular Pd-Lua objects always have </span><code>_scriptname</code><span> set, so it will do for our purposes.</span></p><p><span>Finally, we need to decide how to invoke </span><code>dofilex</code><span> in our object. The easiest way to do this is to just add a message handler (i.e., an inlet method) to the object. For instance, say that the object is named </span><code>foo</code><span> which is defined in the foo.pd_lua script. Then all you have to do is add something like the following definition to the script:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51801px; left: 7.98611px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation"><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">foo</span>:<span class="cm-variable">in_1_reload</span>()</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self</span>:<span class="cm-variable">dofilex</span>(<span class="cm-variable">self._scriptname</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 69px;"></div><div class="CodeMirror-gutters" style="display: none; height: 69px;"></div></div></div></pre><p><span>As we already discussed, this code uses the object&#39;s internal </span><code>_scriptname</code><span> variable, and so is completely generic. You can just copy this over to any .pd_lua file, if you replace the </span><code>foo</code><span> prefix with whatever the name of your actual class variable is. With that definition added, you can now just send the object a </span><code>reload</code><span> message whenever you want to have its script file reloaded.</span></p><hr /><p><strong><span>NOTE:</span></strong><span> This works because the </span><code>pd.Class:new():register(&quot;foo&quot;)</code><span> call of the object only registers a new class if that object class doesn&#39;t exist yet; otherwise it just returns the existing class.</span></p><p><span>By reloading the script file, all of the object&#39;s method definitions will be overwritten, not only for the object receiving the </span><code>reload</code><span> message, but for </span><em><span>all</span></em><span> objects of the same class, so it&#39;s sufficient to send the message to any (rather than every) object of the class. Also, existing object state (as embodied by the internal member variables of each object) will be preserved.</span></p><p><span>In general all this works pretty well, but there are some caveats, too. Note that if you </span><em><span>delete</span></em><span> one of the object&#39;s methods, or change its name, the old method will still hang around in the runtime class definition until you relaunch Pd. That&#39;s because reloading the script does not erase any old method definitions, it merely replaces existing and adds new ones.</span></p><p><span>Finally, keep in mind that reloading the script file does </span><em><span>not</span></em><span> re-execute the </span><code>initialize</code><span> method. This method is only invoked when an object is instantiated. Thus, in particular, reloading the file won&#39;t change the number of inlets and outlets of an existing object. Newly created objects </span><em><span>will</span></em><span> pick up the changes in </span><code>initialize</code><span>, though, and have the proper number of inlets and outlets if those member variables were changed.</span></p><hr /><p><span>Let&#39;s give this a try, using luatab.pd_lua from the &quot;Using arrays and tables&quot; section as an example. In fact, that&#39;s a perfect showcase for live coding, since we want to be able to change the definition of the waveform function </span><code>f</code><span> in </span><code>luatab:in_1_float</code><span> on the fly. Just add the following code to the end of luatab.pd_lua:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51801px; left: 7.98611px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation"><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">luatab</span>:<span class="cm-variable">in_1_reload</span>()</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self</span>:<span class="cm-variable">dofilex</span>(<span class="cm-variable">self._scriptname</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 69px;"></div><div class="CodeMirror-gutters" style="display: none; height: 69px;"></div></div></div></pre><p><span>Now launch the luatab.pd patch and connect a </span><code>reload</code><span> message to the </span><code>luatab wave</code><span> object, like so:</span></p><p><img src="13-livecoding1.png" referrerpolicy="no-referrer" alt="Live-coding with dofilex 1"></p><p><span>Next change the wavetable function to whatever you want, e.g.:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51801px; left: 7.98611px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation"><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-keyword">local</span> <span class="cm-keyword">function</span> <span class="cm-variable">f</span>(<span class="cm-variable">x</span>)</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp; &nbsp; <span class="cm-keyword">return</span> <span class="cm-builtin">math.sin</span>(<span class="cm-number">2</span>*<span class="cm-builtin">math.pi</span>*<span class="cm-variable">freq</span>*<span class="cm-variable">x</span>)+<span class="cm-number">1</span>/<span class="cm-number">3</span>*<span class="cm-builtin">math.sin</span>(<span class="cm-number">2</span>*<span class="cm-builtin">math.pi</span>*<span class="cm-number">3</span>*<span class="cm-variable">freq</span>*<span class="cm-variable">x</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; &nbsp; &nbsp;<span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 69px;"></div><div class="CodeMirror-gutters" style="display: none; height: 69px;"></div></div></div></pre><p><span>Return to the patch, click the </span><code>reload</code><span> message, and finally reenter the frequency value, so that the waveform gets updated:</span></p><p><img src="14-livecoding2.png" referrerpolicy="no-referrer" alt="Live-coding with dofilex 2"></p><h3 id='pdxlua'><span>pdx.lua</span></h3><p><span>The method sketched out in the preceding subsection works well enough for simple patches. However, having to manually wire up the </span><code>reload</code><span> message to one object of each class that you&#39;re editing is still quite cumbersome. In a big patch, which is being changed all the time, this quickly becomes unwieldy. Wouldn&#39;t it be nice if we could equip each object with a special receiver, so that we can just click a message somewhere in the patch to reload a given class, or even all Pd-Lua objects at once? Or even send that message via the </span><code>pdsend</code><span> program, e.g., from the text editor in which you edit the Lua source of your object?</span></p><p><span>Well, all this is in fact possible, but the implementation is a bit too involved to fully present here. So we have provided this in a separate pdx.lua module, which you can find in the sources accompanying this tutorial for your perusal. As of Pd-Lua 0.12.8, pdx.lua is pre-loaded and all the required setup is performed automatically. You only have to add a message like the following to your patch, which goes to the special </span><code>pdluax</code><span> receiver (note that this is unrelated to the </span><code>pdluax</code><span> object discussed previously, it just incidentally uses the same name):</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang=""><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang=""><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51801px; left: 7.98611px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation"><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;">; pdluax reload</span></pre></div></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 23px;"></div><div class="CodeMirror-gutters" style="display: none; height: 23px;"></div></div></div></pre><p><span>When clicked, this just reloads all Pd-Lua objects in the patch. You can also specify the class to be reloaded (the receiver matches this against each object&#39;s class name):</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang=""><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang=""><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51801px; left: 7.98611px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation"><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;">; pdluax reload foo</span></pre></div></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 23px;"></div><div class="CodeMirror-gutters" style="display: none; height: 23px;"></div></div></div></pre><p><span>Or maybe name several classes, like so:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang=""><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang=""><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51801px; left: 7.98611px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation"><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;">; pdluax reload foo, reload bar</span></pre></div></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 23px;"></div><div class="CodeMirror-gutters" style="display: none; height: 23px;"></div></div></div></pre><p><span>You get the idea. Getting set up for remote control via </span><code>pdsend</code><span> isn&#39;t much harder. E.g., let&#39;s say that we use UDP port 4711 on localhost for communicating with Pd, then you just need to connect </span><code>netreceive 4711 1</code><span> to the </span><code>pdluax</code><span> receiver in a suitable way. Let&#39;s use the luatab.pd_lua object from the previous subsection as an example. You can remove the </span><code>in_1_reload</code><span> handler from that script -- it&#39;s no longer needed, as pdx.lua now dispatches the </span><code>reload</code><span> messages for us. Here&#39;s how the revised patch looks like:</span></p><p><img src="15-remote-control1.png" referrerpolicy="no-referrer" alt="Live-coding with remote control"></p><p><span>This doesn&#39;t look any simpler than before, but it also does a whole lot more. Clicking the message not just reloads the </span><code>luatab</code><span> script, but </span><em><span>any</span></em><span> Lua object you have running, in </span><em><span>any</span></em><span> of the patches you have opened. And you can now use </span><code>pdsend 4711 localhost udp</code><span> to reload your Lua objects from literally anywhere. Any decent code editor will let you bind a keyboard command which does this for you. Myself, I&#39;m a die-hard Emacs fan, so I&#39;ve included a little elisp module </span><em><span>pd-remote.el</span></em><span> which shows how to do this. Once you&#39;ve added this to your .emacs, you can just type Ctrl+C Ctrl+K in any Lua buffer to make Pd reload your Lua scripts after editing them. It doesn&#39;t get much easier than that.</span></p><p><span>In addition, I&#39;ve provided a little abstraction named </span><em><span>pd-remote.pd</span></em><span> which takes care of adding the </span><code>netreceive</code><span> and messaging bits and also looks much tidier in your patches. Using the abstraction is easy: Insert </span><code>pd-remote</code><span> into the patch you&#39;re working on, and (optionally) connect a </span><code>pdluax reload</code><span> message (without the </span><code>;</code><span> prefix) to the inlet of the abstraction; or use something like </span><code>pdluax reload foo</code><span> to reload a specific object class. Now you can just click on that message to reload your script files, and the abstraction will also respond to such messages on port 4711 (the port number can be changed in the abstraction if needed). Here&#39;s how that looks like in a patch:</span></p><p><img src="15-remote-control2.png" referrerpolicy="no-referrer" alt="Live-coding with pd-remote.pd"></p><hr /><p><strong><span>NOTE:</span></strong><span> To make Pd find the pd-remote.pd abstraction without having to copy it to your project directory, you can add the pdlua external directory (which is where the abstraction gets installed) to your Pd library path, either in your Pd setup, or inside the patch with a </span><code>declare -stdpath</code><span> object, as shown above.</span></p><p><span>The pd-remote.el file can be installed in your Emacs site-lisp directory if needed. However, the easiest way to install it is from </span><a href='https://melpa.org/'><span>MELPA</span></a><span>, a large repository of Emacs packages. Please also check the </span><a href='https://github.com/agraef/pd-remote'><span>pd-remote</span></a><span> repository on GitHub for the latest pd-remote version and further details. This also includes a pointer to a Visual Studio Code extension written by Baris Altun which can be used as a replacement for pd-remote.el if you prefer VS Code for editing.</span></p><hr /><p><span>And here&#39;s a little gif showing the above patch in action. You may want to watch this in </span><a href='https://www.typora.io/'><span>Typora</span></a><span> or your favorite web browser to make the animation work.</span></p><p><img src="16-remote-control2.gif" referrerpolicy="no-referrer" alt="Live-coding in action"></p><p><span>So there you have it: Not one, not two, but three different ways to live-code with Pd-Lua (or four, if you count in the </span><code>pdlua</code><span> object). pdx.lua certainly is the most advanced and user-friendly solution among these, but you can choose whatever best fits your purpose and is the most convenient for you.</span></p><h3 id='object-reinitialization-in-pdxlua'><span>Object reinitialization in pdx.lua</span></h3><p><span>If pdx.lua reloads a script file, it normally does </span><em><span>not</span></em><span> run the </span><code>initialize</code><span> method. This is by design, as we want the reload process to be as smooth as possible while running a patch, and invoking the </span><code>initialize</code><span> method could potentially be quite disruptive, as it usually reinitializes all your member variables.</span></p><p><span>However, pdx.lua has another trick up its sleeve if you do need some kind of custom reinitialization. There are two callback methods that you can implement, </span><code>prereload</code><span> and </span><code>postreload</code><span> which will be invoked immediately before and after reloading the script file, respectively.  Either method can be used to reinitialize your objects during reloading in any desired way. The only difference between the two methods is that </span><code>prereload</code><span> still runs in the old script, while </span><code>postreload</code><span> executes the new code which has just been loaded. Typically you&#39;d use </span><code>prereload</code><span> to perform any required bookkeeping or state-saving before the script gets loaded, and </span><code>postreload</code><span> for custom initialization afterwards.</span></p><p><span>In particular, these callbacks can change any member variables, either directly or by invoking other methods. The most important use cases probably are to change the </span><code>inlets</code><span> and </span><code>outlets</code><span> variables, and to add a </span><code>paint</code><span> method, which can be done on the fly to reconfigure your objects accordingly. To these ends, you can just call the </span><code>initialize</code><span> method from </span><code>postreload</code><span>. To demonstrate this, in the tutorial examples you&#39;ll find a pdxtest.pd patch and pdxtest~.pd_lua script. The script has the following </span><code>reload</code><span> method:</span></p><pre class="md-fences md-end-block ty-contain-cm modeLoaded" spellcheck="false" lang="lua"><div class="CodeMirror cm-s-inner cm-s-null-scroll CodeMirror-wrap" lang="lua"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 9.51801px; left: 7.98611px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation" style=""><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">function</span> <span class="cm-variable">pdxtest</span>:<span class="cm-variable">postreload</span>()</span></pre></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- stuff to do post-reload goes here</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">pd.post</span>(<span class="cm-string">"Reloaded!"</span>)</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- instead of doing a full initialization, you could also just change the</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-comment">-- number of inlets and outlets here</span></span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"> &nbsp; <span class="cm-variable">self</span>:<span class="cm-variable">initialize</span>()</span></pre><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;"><span class="cm-keyword">end</span></span></pre></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 161px;"></div><div class="CodeMirror-gutters" style="display: none; height: 161px;"></div></div></div></pre><p><span>Now, if you need to change the number of inlets and outlets of the object, you can just modify the definitions of </span><code>inlets</code><span> and </span><code>outlets</code><span> in the script&#39;s </span><code>initialize</code><span> method and reload. Easy as pie. Try it! Instructions can be found in the script.</span></p><h3 id='live-coding-and-dsp'><span>Live coding and dsp</span></h3><p><span>One caveat about using any of the above live-coding solutions in conjunction with Pd-Lua&#39;s </span><a href='#signals'><span>signal processing capabilities</span></a><span> is in order. When the Lua code of an object class gets reloaded, the existing code is replaced immediately. There isn&#39;t any kind of automatic &quot;cross-fade&quot; between old and new code. If you change the </span><code>perform</code><span> method of that class, there may well be discontinuities in the generated output signals which result in audible clicks. This won&#39;t matter much if you&#39;re just developing an object in your studio. But live on stage you may want to avoid this -- unless you accept or even cherish such glitches as part of your live performance.</span></p><p><span>There are ways to work around this issue, however. To demonstrate this, the tutorial examples include the following live-xfade.pd patch:</span></p><p><img src="17-live-xfade.png" referrerpolicy="no-referrer" alt="Live cross-fade"></p><p><span>The </span><code>foo~</code><span> and </span><code>bar~</code><span> objects in this example are essentially the same, with some minor variations in the sound generation parameters. The particular sounds in this example are not important, each object just outputs a random walk of sine waves of varying frequencies with some phase distortion. But they </span><em><span>will</span></em><span> produce clicks when switching them abruptly, thus we need a smooth cross-fade between the two sound sources. This is handled by the </span><a href='#real-world-example-cross-fades'><code>luaxfade~</code></a><span> object from the Signals section.</span></p><p><span>What&#39;s special here is that the transitions are being triggered automatically, </span><em><span>by the received reload messages</span></em><span>. By these means, you can edit, say, the </span><code>foo~</code><span> object while the </span><code>bar~</code><span> object is playing, then save your edits and send a </span><code>reload</code><span> message. At this point the new code for </span><code>foo~</code><span> is loaded while the cross-fade from </span><code>bar~</code><span> to </span><code>foo~</code><span> is initiated at the same time.</span></p><p><span>This method obviously requires some preparation and diligence when being used live on stage. Having some kind of automatic cross-fade functionality for dsp objects baked into Pd-Lua&#39;s run-time system would make this a lot easier. Maybe this can be provided by pdx.lua in a future release.</span></p><h2 id='conclusion'><span>Conclusion</span></h2><p><span>Congratulations! If you made it this far, you should have learned more than enough to start using Pd-Lua successfully for your own projects. You should also be able to read and understand the many examples in the Pd-Lua distribution, which illustrate all the various features in much more detail than we could muster in this introduction. You can find these in the examples folder, both in the Pd-Lua sources and the pdlua folder of your Pd installation.</span></p><p><span>The examples accompanying this tutorial (including the pdx.lua, pdlua-remote.el and pdlua-remote.pd files mentioned at the end of the pdx.lua section) are also available for your perusal in the examples subdirectory of the folder where you found this document.</span></p><p><span>Finally, I&#39;d like to thank Claude Heiland-Allen for creating such an amazing tool, it makes programming Pd externals really easy and fun. Kudos also to Roberto Ierusalimschy for Lua, which for me is one of the best-designed, easiest to learn, and most capable multi-paradigm scripting languages there are today, while also being fast, simple, and light-weight.</span></p></div></div>
 </body>
 </html>
\ No newline at end of file
diff --git a/tutorial/pd-lua-intro.md b/tutorial/pd-lua-intro.md
index e9c405d..6c7fdf3 100644
--- a/tutorial/pd-lua-intro.md
+++ b/tutorial/pd-lua-intro.md
@@ -718,7 +718,7 @@ Sending messages to a receiver is straightforward:
 
 This works pretty much like the `outlet` method, but outputs messages to the given receiver instead. For instance, let's say you have a toggle with receiver symbol `onoff` in your patch, then you can turn on that toggle with a call like `pd.send("onoff", "float", {1})`. (Recall that the `atoms` argument always needs to be a table, even if it is a singleton, lest you'll get that "invalid atoms table" error that we discussed earlier).
 
-One complication are receiver symbols using a `$0-` patch id prefix, which are commonly used to differentiate receiver symbols in different toplevel patches or abstractions, in order to prevent name clashes. For instance, suppose that the toggle receiver is in fact named `$0-onoff`, then something like the following Pd-Lua object will do the trick, if you invoke it as `luasend $0-onoff` (you'll also find an explanation further below on how to manage this expansion for symbols from incoming messages):
+One complication are receiver symbols using a `$0-` patch id prefix, which are commonly used to differentiate receiver symbols in different toplevel patches or abstractions, in order to prevent name clashes. For instance, suppose that the toggle receiver is in fact named `$0-onoff`, then something like the following Pd-Lua object will do the trick, if you invoke it as `luasend $0-onoff`:
 
 ~~~lua
 local luasend = pd.Class:new():register("luasend")
@@ -738,7 +738,11 @@ Of course, this also handles ordinary receive symbols just fine if you pass them
 
 ![Send example](09-send.png)
 
-It is worth noting here that the same technique applies whenever you need to pass on "$" arguments to a Pd-Lua object in a Pd abstraction.
+---
+
+**NOTE:** The same technique applies whenever you need to pass on "$" arguments to a Pd-Lua object in a Pd abstraction. This also works in older Pd-Lua versions. However, since Pd-Lua 0.12.17 there's also the possibility to expand such "$" symbols directly in Lua, see [Expanding dollar symbols](#expanding-dollar-symbols) below.
+
+---
 
 So let's have a look at receivers now. These work pretty much like clocks in that you create them registering a method, and destroy them when they are no longer needed:
 
@@ -785,6 +789,51 @@ The obligatory test patch:
 
 ![Receive example](10-receive.png)
 
+### Expanding dollar symbols
+
+Some more in-depth information about dollar symbols and their use in Lua is in order. Specifically, we will discuss two new Pd-Lua object methods, `canvas_realizedollar()` (available since Pd-Lua 0.12.17) and  `set_args()` (available since Pd-Lua 0.12.0) which help you manage your receiver and sender symbols. In this use case, you will typically use quoted symbols like `\$0-foo`, so that your object receives the symbol unexpanded, which requires some facilities to expand such symbols in Lua, and maybe also record the unexpanded symbols in the object's creation arguments. These helper methods are technically considered part of Pd-Lua's graphics API (see [Graphics](#graphics) below) since they are often used for graphics objects. But they both work just as well with ordinary (non-graphical) Lua objects, and they come in handy here, so that we introduce them now:
+
+- `self:canvas_realizedollar(symbol)`: Expand "$" symbols in the `symbol` string argument and return the resulting string.
+- `self:set_args(atoms)`: Set the given list of numbers and strings `atoms` as the object's creation arguments. (Note that the new argument list doesn't become visible on the canvas until you edit, copy, or duplicate the modified object.)
+
+To explain how these two work in concert, let's go back to the basics first. As mentioned above, the patch id `$0` is widely used in Pd for send and receive names to avoid conflicts with other receivers and senders of similar names. Pd expands `$0` to the canvas id, which differs for every open patch, and it expands `$1`, `$2` etc. if the corresponding creation arguments are set in the context of an abstraction or clone instance. (Also note that in Purr Data there is another `$@` symbol which expands to the list of all creation arguments.)
+
+If you set the sender or receiver names for your Pd-Lua object as *creation arguments* of the object, Pd automatically expands them for you as discussed above. But if you want to set them through *messages* to the object, you will often use a quoted symbol like `\$0-foo`, so that your object receives the symbol unexpanded. You've probably seen this before, as it is also common practice, e.g., with Pd's GUI objects like sliders, radio buttons, etc. (check the escaping-characters subpatch of the message help patch for some examples).
+
+Quoting dollar symbols in this way offers the advantage that you can record the "$" symbol itself (rather than its expansion) in the object's properties (in the case of Pd GUI objects) or in its creation arguments (as can be done with Pd-Lua's `set_args()` method). But of course this means that if you want to use the actual receiver symbol in your Lua object then you need to expand the symbol in Lua (which is what the `canvas_realizedollar()` method is for).
+
+Here's a simple example illustrating this:
+
+~~~lua
+local localsend = pd.Class:new():register("localsend")
+
+function localsend:initialize(sel, atoms)
+   self.inlets = 1
+   -- pass the symbol from the creation argument,
+   -- which gets automatically expanded here
+   self.sender = tostring(atoms[1])
+   return true
+end
+
+function localsend:in_1_sender(x)
+   local sendername = tostring(x[1])
+
+   -- store the original name as argument (like "\$0-foo")
+   self:set_args({sendername})
+
+   -- apply the expanded name with the local id
+   self.sender = self:canvas_realizedollar(sendername)
+end
+
+function localsend:in_1_bang()
+   pd.send(self.sender, "float", {1})
+end
+~~~
+
+And here's a test patch from the tutorial examples which shows this object in action:
+
+![Dollar symbol example](19-dollar-symbols.png)
+
 ## Signals and graphics
 
 So far all of our examples only did control processing, which is what Pd-Lua was originally designed for. But thanks to the work of Timothy Schoen (the creator and main developer of [plugdata](https://plugdata.org/)), as of version 0.12.0 Pd-Lua also provides facilities for audio signal processing and graphics. It goes without saying that these capabilities vastly extend the scope of Pd-Lua applications, as you can now program pretty much any kind of Pd object in Lua, covering both signal and control processing, as well as custom GUI objects. We'll first discuss how to write a signal processing (a.k.a. dsp) object in Pd-Lua, and then go on to show the implementation of a simple GUI object using the graphics API.
@@ -1012,7 +1061,7 @@ Timothy Schoen's Pd-Lua graphics API provides you with a way to equip an object
 
 In order to enable graphics in a Pd-Lua object, you have to provide a `paint` method. This receives a graphics context `g` as its argument, which lets you set the current color, and draw text and the various different geometric shapes using that color. In addition, you can provide methods to be called in response to mouse down, up, move, and drag actions on the object, which is useful to equip your custom GUI objects with mouse-based interaction.
 
-Last but not least, the `set_args` method lets you store internal object state in the object's creation arguments, which is useful if you need to keep track of persistent state when storing an object on disk (via saving the patch) or when duplicating or copying objects. This can also be used with ordinary Pd-Lua objects which don't utilize the graphics API, but it is most useful in the context of custom GUI objects.
+Last but not least, the `set_args` method lets you store internal object state in the object's creation arguments, which is useful if you need to keep track of persistent state when storing an object on disk (via saving the patch) or when duplicating or copying objects. Also, its companion `canvas_realizedollar` method allows you to expand symbols containing "$" patch arguments like `$0`, `$1`, etc. These two are often employed together, but they can also be used separately, and they work just as well with ordinary Pd-Lua objects which don't utilize the graphics API. In fact we've already introduced them while discussing receivers, see [Expanding dollar symbols](#expanding-dollar-symbols) above, so we won't go into them again; however, check the circle-gui example included in the distribution to see how to store Lua object configuration data persistently in the creation arguments of a custom GUI object.
 
 We use a custom GUI object, a simple kind of dial, as a running example to illustrate most of these elements in the following subsections. To keep things simple, we will not discuss the graphics API in much detail here, so you may want to check the graphics subpatch in the main pdlua-help patch, which contains a detailed listing of all available methods for reference.
 
@@ -1231,40 +1280,6 @@ I'm sure you can imagine many more creative uses for this simple but surprisingl
 
 The extended example adds messages for resizing the object and setting colors, and also shows how to save and restore object state in the creation arguments using the `set_args()` method mentioned at the beginning of this section. The accompanying patch covers all the examples we discussed here, and adds a third example showing how to utilize our dial object as a dB meter.
 
-### Expanding dollar symbols
-
-As mentioned above, the patch id `$0` is widely used in Pd for send and receive names to avoid conflicts with other receivers and senders of similar names. Pd expands `$0` to its local id, which differs for every open patch (similarly, it expands `$1`, `$2` etc. if the corresponding creation arguments are set in the context of an abstraction or clone instance).
-
-If you set these sender or receiver names for your Pd-Lua object as creation arguments, they will automatically get expanded as demonstrated before. If you want to set them through messages in Lua however (which is common for Pd's GUI objects like sliders, radio buttons, etc.), it becomes slightly more complicated since you will need to expand them yourself.
-
-Luckily, Pd's `canvas_realizedollar()` method does exactly this and is also available on the Lua side. Combined with the `set_args()` method, you can create objects that allow managing sender and receiver names, applying the expanded version immediately and also storing the original names in the arguments. Here's a simple example illustrating this:
-
-~~~lua
-local localsend = pd.Class:new():register("localsend")
-
-function localsend:initialize(sel, atoms)
-   self.inlets = 1
-   -- pass the symbol from the creation argument,
-   -- which gets automatically expanded here
-   self.sender = tostring(atoms[1])
-   return true
-end
-
-function localsend:in_1_sender(x)
-   local sendername = tostring(x[1])
-
-   -- store the original name as argument (like "\$0-foo")
-   self:set_args(sendername)
-
-   -- apply the expanded name with the local id
-   self.sender = self:canvas_realizedollar(sendername)
-end
-
-function localsend:in_1_bang()
-   pd.send(self.sender, "float", {1})
-end
-~~~
-
 ## Live coding
 
 I've been telling you all along that in order to make Pd-Lua pick up changes you made to your .pd_lua files, you have to relaunch Pd and reload your patches. Well, as you probably guessed by now, this isn't actually true. So in this section we are going to cover Pd-Lua's *live coding* features, which let you modify your sources and have Pd-Lua reload them on the fly, without ever exiting the Pd environment. This rapid incremental style of development is one of the hallmark features of dynamic interactive programming environments like Pd and Lua. Musicians also like to employ it to modify their programs live on stage, which is where the term "live coding" comes from.