Patch A06.frequency.pd (figure 1.9) shows Pd's object for converting pitch to
frequency units (mtof, meaning "MIDI to frequency")
and its inverse ftom. We also introduce two other
object classes, send and
receive:
,
: Converts MIDI pitch to
frequency units according to the PITCH/FREQUENCY CONVERSION
formulas. Inputs and outputs are messages (but "tilde" equivalents
of the two also exist, although like dbtorms~ they're
expensive in CPU time). The ftom object's output is
-1500 of the input is zero or negative; and likewise, if you give
mtof -1500 or lower it outputs zero.
,
: Receive messages
non-locally. The receive object, which may be
abbreviated as ``r" waits for non-local messages to be
sent by a send object (below) or by a message box
using redirection (the ``;" feature discussed in the earlier
example, A01.sinewave.pd). The argument (such as ``frequency" and
``pitch" in this example) is the name to which messages are sent.
Multiple receive objects may share the same name, in
which case any message sent to that name will go to all of
them.
,
: The send
object, which may be abbreviated as ``s", directs
messages to receive objects.
Two new properties of number boxes are used here. Heretofore we've used them as controls or as displays; here, the two number boxes each function as both. If a number box gets a number in its inlet, it not only displays the number but also repeats it to its output. However, a number box may also be sent a ``set" message, such as ``set 55" for example. This would set the value of the number box to 55 (and display it) but not cause the output that would result from the simple ``55" message. In this case, numbers coming from the two receives are formatted (using message boxes) to read ``set 55" instead of just ``55", and so on. (The special word ``$1" is replaced by the incoming number.) This is done because otherwise we would have an infinite loop: frequency would change pitch which would change frequency and so on forever, or at least until something breaks.