aboutsummaryrefslogtreecommitdiff
path: root/doc/pddp
diff options
context:
space:
mode:
authorHans-Christoph Steiner <eighthave@users.sourceforge.net>2005-04-28 00:25:05 +0000
committerHans-Christoph Steiner <eighthave@users.sourceforge.net>2005-04-28 00:25:05 +0000
commit061e4be1f20ac78e3b52bc6429322d5fadcf5831 (patch)
treec6449d7cf4a19547b97d234ef4c65251ee766c1d /doc/pddp
parente30864640368dc4c25c309fb83365807955e832e (diff)
cleaned up a number of patches; renamed all to the standard -help.pd format; added some more ideas to the style guide; finished up lists_vs_anythings
svn path=/trunk/; revision=2841
Diffstat (limited to 'doc/pddp')
-rw-r--r--doc/pddp/adc~-help.pd (renamed from doc/pddp/help-adc~.pd)16
-rw-r--r--doc/pddp/adc~_dac~-help.pd (renamed from doc/pddp/help-adc~_dac~.pd)38
-rw-r--r--doc/pddp/all_about_acoustic_conversions.pd52
-rw-r--r--doc/pddp/all_about_arrays.pd52
-rw-r--r--doc/pddp/all_about_atom_conversion.pd77
-rw-r--r--doc/pddp/all_about_lists_vs_anythings.pd179
-rw-r--r--doc/pddp/all_about_midi_flags.pd16
-rw-r--r--doc/pddp/all_about_scope_and_locality.pd12
-rw-r--r--doc/pddp/all_about_send_n_receive.pd4
-rw-r--r--doc/pddp/bang-help.pd (renamed from doc/pddp/help-bang.pd)10
-rw-r--r--doc/pddp/bendin-help.pd (renamed from doc/pddp/help-bendin.pd)132
-rw-r--r--doc/pddp/bendout-help.pd (renamed from doc/pddp/help-bendout.pd)8
-rw-r--r--doc/pddp/bng-help.pd (renamed from doc/pddp/help-bng.pd)4
-rw-r--r--doc/pddp/change-help.pd (renamed from doc/pddp/help-change.pd)4
-rw-r--r--doc/pddp/clip-help.pd106
-rw-r--r--doc/pddp/cputime-help.pd (renamed from doc/pddp/help-cputime.pd)26
-rw-r--r--doc/pddp/ctlin-help.pd (renamed from doc/pddp/help-ctlin.pd)8
-rw-r--r--doc/pddp/ctlout-help.pd (renamed from doc/pddp/help-ctlout.pd)8
-rw-r--r--doc/pddp/dac~-help.pd (renamed from doc/pddp/help-dac~.pd)16
-rw-r--r--doc/pddp/delay-help.pd (renamed from doc/pddp/help-delay.pd)10
-rw-r--r--doc/pddp/float-help.pd (renamed from doc/pddp/help-float.pd)4
-rw-r--r--doc/pddp/glossary.pd14
-rw-r--r--doc/pddp/help-clip.pd130
-rw-r--r--doc/pddp/int-help.pd (renamed from doc/pddp/help-int.pd)14
-rw-r--r--doc/pddp/key-help.pd (renamed from doc/pddp/help-key.pd)8
-rw-r--r--doc/pddp/line-help.pd (renamed from doc/pddp/help-line.pd)10
-rw-r--r--doc/pddp/loadbang-help.pd (renamed from doc/pddp/help-loadbang.pd)8
-rw-r--r--doc/pddp/makefilename-help.pd (renamed from doc/pddp/help-makefilename.pd)10
-rw-r--r--doc/pddp/math-help.pd (renamed from doc/pddp/help-math.pd)4
-rw-r--r--doc/pddp/metro-help.pd (renamed from doc/pddp/help-metro.pd)8
-rw-r--r--doc/pddp/midi-help.pd (renamed from doc/pddp/help-midi.pd)2
-rw-r--r--doc/pddp/moses-help.pd (renamed from doc/pddp/help-moses.pd)8
-rw-r--r--doc/pddp/notein-help.pd (renamed from doc/pddp/help-notein.pd)8
-rw-r--r--doc/pddp/noteout-help.pd (renamed from doc/pddp/help-noteout.pd)8
-rw-r--r--doc/pddp/operators-help.pd (renamed from doc/pddp/help-operators.pd)12
-rw-r--r--doc/pddp/otherbinops-help.pd (renamed from doc/pddp/help-otherbinops.pd)10
-rw-r--r--doc/pddp/pack-help.pd (renamed from doc/pddp/help-pack.pd)8
-rw-r--r--doc/pddp/pddp-style-guide.pd51
-rw-r--r--doc/pddp/pddp.pd31
-rw-r--r--doc/pddp/pddp_open.pd4
-rw-r--r--doc/pddp/pgmin-help.pd (renamed from doc/pddp/help-pgmin.pd)8
-rw-r--r--doc/pddp/pgmout-help.pd (renamed from doc/pddp/help-pgmout.pd)8
-rw-r--r--doc/pddp/pipe-help.pd (renamed from doc/pddp/help-pipe.pd)8
-rw-r--r--doc/pddp/print-help.pd (renamed from doc/pddp/help-print.pd)8
-rw-r--r--doc/pddp/random-help.pd (renamed from doc/pddp/help-random.pd)10
-rw-r--r--doc/pddp/realtime-help.pd (renamed from doc/pddp/help-realtime.pd)28
-rw-r--r--doc/pddp/receive-help.pd (renamed from doc/pddp/help-receive.pd)8
-rw-r--r--doc/pddp/route-help.pd (renamed from doc/pddp/help-route.pd)48
-rw-r--r--doc/pddp/select-help.pd (renamed from doc/pddp/help-select.pd)14
-rw-r--r--doc/pddp/send-help.pd (renamed from doc/pddp/help-send.pd)6
-rw-r--r--doc/pddp/spigot-help.pd (renamed from doc/pddp/help-spigot.pd)12
-rw-r--r--doc/pddp/swap-help.pd (renamed from doc/pddp/help-swap.pd)2
-rw-r--r--doc/pddp/symbol-help.pd (renamed from doc/pddp/help-symbol.pd)8
-rw-r--r--doc/pddp/table_of_contents.pd34
-rw-r--r--doc/pddp/tabread-help.pd (renamed from doc/pddp/help-tabread.pd)8
-rw-r--r--doc/pddp/tabread4-help.pd (renamed from doc/pddp/help-tabread4.pd)6
-rw-r--r--doc/pddp/tabwrite-help.pd (renamed from doc/pddp/help-tabwrite.pd)4
-rw-r--r--doc/pddp/timer-help.pd (renamed from doc/pddp/help-timer.pd)26
-rw-r--r--doc/pddp/trigger-help.pd (renamed from doc/pddp/help-trigger.pd)10
-rw-r--r--doc/pddp/unpack-help.pd (renamed from doc/pddp/help-unpack.pd)8
-rw-r--r--doc/pddp/until-help.pd (renamed from doc/pddp/help-until.pd)18
-rw-r--r--doc/pddp/value-help.pd (renamed from doc/pddp/help-value.pd)26
62 files changed, 774 insertions, 664 deletions
diff --git a/doc/pddp/help-adc~.pd b/doc/pddp/adc~-help.pd
index e281fc9a..a9caeaef 100644
--- a/doc/pddp/help-adc~.pd
+++ b/doc/pddp/adc~-help.pd
@@ -5,30 +5,30 @@
#N canvas 85 2 593 609 More_Info 0;
#X text 16 13 MULTI-CHANNEL AUDIO;
#X text 32 40 All sound cards are capable of at least two channels
-of audio. PD supports these two channels by default and uses your system's
+of audio. Pd supports these two channels by default and uses your system's
generic audio drivers to communicate with your hardware. However \,
for faster input/output and for more than two channels of audio \,
PD incorporates the use of "PortAudio" which uses ASIO drivers to communicate
-with your hardware. So \, to instruct PD to use more than two channels
+with your hardware. So \, to instruct Pd to use more than two channels
of audio \, your command line should read like below:;
#X text 93 182 c:/pd/bin/pd.exe -pa -inchannels 8 -outchannels 8;
#X text 32 211 The "-pa" switch means "PortAudio". This switch is new
-as of PD version 0.37 TEST 4 and replaces the old "-asio" switch.;
+as of Pd version 0.37 TEST 4 and replaces the old "-asio" switch.;
#X text 32 271 The "-inchannels" and "-outchannels" switches can be
summarized by using "-channels 8" because currently PortAudio requires
that the number of incoming and outgoing channels must be equal. This
-may change in the PD's future...;
-#X text 32 361 To further optimize PD's usage of your audio hardware
+may change in the Pd's future...;
+#X text 32 361 To further optimize Pd's usage of your audio hardware
\, you can explore the following:;
#X text 42 402 - audiobuf;
#X text 43 420 - blocksize;
#X text 42 436 - audioindev;
#X text 42 454 - audiooutdev;
-#X text 38 480 With the right hardware \, PD can manage audio input
+#X text 38 480 With the right hardware \, Pd can manage audio input
and output with lower than 10 milliseconds of latency.;
#X restore 104 514 pd More_Info;
#N canvas 85 2 395 244 Related_Objects 0;
-#X text 25 8 Native PD Objects;
+#X text 25 8 Native Pd Objects;
#X text 25 92 Externals and other object libraries;
#X obj 45 46 dac~;
#X obj 98 46 switch~;
@@ -43,7 +43,7 @@ and output with lower than 10 milliseconds of latency.;
#X text 108 18 - AUDIO INPUT: ANALOG/DIGITAL CONVERTER SIGNAL;
#X text 152 541 - Dave Sabine \, May 6 \, 2003;
#X text 104 53 [adc~] is an acronym meaning "Analog/Digital Converter
-Signal" and is PD's interface to access the audio information arriving
+Signal" and is Pd's interface to access the audio information arriving
at your soundcard(s).;
#X text 106 106 The object defaults to 2 incoming audio channels (usually
a left and right stereo pair). Any number of arguments (integers) can
diff --git a/doc/pddp/help-adc~_dac~.pd b/doc/pddp/adc~_dac~-help.pd
index 33a21a23..781c080b 100644
--- a/doc/pddp/help-adc~_dac~.pd
+++ b/doc/pddp/adc~_dac~-help.pd
@@ -6,12 +6,12 @@
#N canvas 131 29 532 435 sample_rate 0;
#X text 12 24 SAMPLE RATE;
#X text 29 46 [adc~] and [dac~] always operate at the sample rate that
-is specified in PD's command line. By default \, the sample rate is
-44100 hz. But PD operates any sample rate supported by standard audio
-hardware. Sample rates cannot be changed at run-time in PD \, but must
-be stated in the command line when PD is instantiated. As well \, two
-or more instances of PD running simoultaneously can each be using different
-sample rates! Having said that \, PD can easily upsample or downsample
+is specified in Pd's command line. By default \, the sample rate is
+44100 hz. But Pd operates any sample rate supported by standard audio
+hardware. Sample rates cannot be changed at run-time in Pd \, but must
+be stated in the command line when Pd is instantiated. As well \, two
+or more instances of Pd running simoultaneously can each be using different
+sample rates! Having said that \, Pd can easily upsample or downsample
by using the [block~] object. Here are some example of the common sample
rates:;
#X text 85 232 c:/pd/bin/pd.exe -r 11025;
@@ -28,38 +28,38 @@ rates:;
#N canvas 131 31 564 558 multi-channel_audio 0;
#X text 16 13 MULTI-CHANNEL AUDIO;
#X text 32 40 All sound cards are capable of at least two channels
-of audio. PD supports these two channels by default and uses your system's
+of audio. Pd supports these two channels by default and uses your system's
generic audio drivers to communicate with your hardware. However \,
for faster input/output and for more than two channels of audio \,
PD incorporates the use of "PortAudio" which uses ASIO drivers to communicate
-with your hardware. So \, to instruct PD to use more than two channels
+with your hardware. So \, to instruct Pd to use more than two channels
of audio \, your command line should read like below:;
#X text 93 182 c:/pd/bin/pd.exe -pa -inchannels 8 -outchannels 8;
#X text 32 211 The "-pa" switch means "PortAudio". This switch is new
-as of PD version 0.37 TEST 4 and replaces the old "-asio" switch.;
+as of Pd version 0.37 TEST 4 and replaces the old "-asio" switch.;
#X text 32 271 The "-inchannels" and "-outchannels" switches can be
summarized by using "-channels 8" because currently PortAudio requires
that the number of incoming and outgoing channels must be equal. This
-may change in the PD's future...;
-#X text 32 361 To further optimize PD's usage of your audio hardware
+may change in the Pd's future...;
+#X text 32 361 To further optimize Pd's usage of your audio hardware
\, you can explore the following:;
#X text 42 402 - audiobuf;
#X text 43 420 - blocksize;
#X text 42 436 - audioindev;
#X text 42 454 - audiooutdev;
-#X text 38 480 With the right hardware \, PD can manage audio input
+#X text 38 480 With the right hardware \, Pd can manage audio input
and output with lower than 10 milliseconds of latency.;
#X restore 40 112 pd multi-channel_audio;
#N canvas 132 30 528 211 defeating_audio_computation 0;
#X text 21 15 -NODAC and -NOADC;
-#X text 26 37 There may be cases when you do not want PD to send or
+#X text 26 37 There may be cases when you do not want Pd to send or
receive audio signal with your soundcard. You can manually disable
the [dac~] and [adc~] objects separately using the "-nodac" and "-noadc"
switch \, or disable both using the "-nosound" switch.;
#X restore 41 152 pd defeating_audio_computation;
#X restore 104 514 pd More_Info;
#N canvas 85 2 399 248 Related_Objects 0;
-#X text 25 8 Native PD Objects;
+#X text 25 8 Native Pd Objects;
#X text 25 118 Externals and other object libraries;
#X obj 57 35 bilge;
#X text 35 143 [shoutcast~];
@@ -79,10 +79,10 @@ switch \, or disable both using the "-nosound" switch.;
#X text 108 18 - AUDIO INPUT/OUTPUT;
#X text 30 47 PURPOSE:;
#X text 104 47 [adc~] and [dac~] provide real-time audio input and
-output for PD \, respectively \, whether analog or digital.;
+output for Pd \, respectively \, whether analog or digital.;
#X text 152 541 - Dave Sabine \, May 5 \, 2003;
#X text 104 83 Both of these objects accept arguments (numbers) which
-indicate which audio channels are to be used by PD. By default \, these
+indicate which audio channels are to be used by Pd. By default \, these
objects are stereo and communicate on audio channels 1 and 2 (left
and right respectively) but by using arguments \, other channel numbers
can be specified. These objects can communicate with hundreds of audio
@@ -97,12 +97,12 @@ channels \, but you are likely limited by your audio hardware to 2
#X text 210 314 three outgoing signals on channels 1 \, 5 \, and 6
;
#X obj 115 314 dac~ 1 5 6;
-#X text 107 345 The actual number of PD inputs and outputs are set
-on PD's command line. You can open patches that want to use more channels
+#X text 107 345 The actual number of Pd inputs and outputs are set
+on Pd's command line. You can open patches that want to use more channels
\, but channel numbers that out of range will be dropped by [dac~]
or appears as zero by [adc~].;
#X text 14 344 IMPORTANT:;
-#X text 108 419 Also \, these objects do not operate unless PD is instructed
+#X text 108 419 Also \, these objects do not operate unless Pd is instructed
to "Compute Audio".;
#X obj 104 464 help-adc~;
#X obj 190 464 help-dac~;
diff --git a/doc/pddp/all_about_acoustic_conversions.pd b/doc/pddp/all_about_acoustic_conversions.pd
index 1ead8b5f..6fb8b907 100644
--- a/doc/pddp/all_about_acoustic_conversions.pd
+++ b/doc/pddp/all_about_acoustic_conversions.pd
@@ -6,7 +6,7 @@
#X text 47 82 -- MIDI note number to frequency converter.;
#N canvas 37 22 899 659 understanding_mtof 0;
#X text 20 13 [mtof] will convert MIDI note numbers to Wave Freqeuency.
-This object exists in PD for the sake of convenience and speed of processing.
+This object exists in Pd for the sake of convenience and speed of processing.
;
#X obj 37 165 mtof;
#X floatatom 37 143 5 0 0 0 - - -;
@@ -113,10 +113,10 @@ This object exists in PD for the sake of convenience and speed of processing.
-1;
#X obj 477 12 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
-1;
-#X text 496 123 The examples at the botton left are PD structures which
+#X text 496 123 The examples at the botton left are Pd structures which
emulate the source code of the [mtof] object. In one case \, I have
used the [expr] object to perform the necessary calculation. In the
-other case \, I used PD's Arithmetic objects to perform the calculation.
+other case \, I used Pd's Arithmetic objects to perform the calculation.
;
#X text 498 291 Secondly \, the incoming MIDI note number is translated
into a frequency value by the simple equation:;
@@ -135,11 +135,11 @@ methods.;
#X msg 408 403 8.1758;
#X text 504 12 THE ALTERNATIVE EXPLAINED;
#X text 499 33 The [mtof] object is really just a function defined
-in PD's source code - which is programmed in "C".;
+in Pd's source code - which is programmed in "C".;
#X text 497 67 As such \, it operates very quickly. If a similar function
-were to be created using PD's arithmetic objects \, the process would
+were to be created using Pd's arithmetic objects \, the process would
be quite a bit slower. How much slower?;
-#X text 498 409 As well \, notice that RESULT C (the output from PD's
+#X text 498 409 As well \, notice that RESULT C (the output from Pd's
basic arithmetic objects) is not as accurate as the other two methods:
[mtof] and/or [expr]. This is because the message boxes and the [*]
object round off the operands because they cannot handle enough decimal
@@ -150,7 +150,7 @@ is the filtering out of all numbers less than -1500 and greater than
and underflows are clipped" as Miller Puckette stated in the original
documentation for this object.;
#X text 22 62 MIDI notes usually range between 0 and 127 from an incoming
-MIDI controller. However \, in PD negative numbers to -1500 and positive
+MIDI controller. However \, in Pd negative numbers to -1500 and positive
numbers to 1499 are also supported and decimal places can be used to
achive microtonal pitches.;
#X text 11 125 CONVENIENT? YES!;
@@ -208,11 +208,11 @@ achive microtonal pitches.;
#X text 9 318 RESULT A;
#X text 534 12 THE ALTERNATIVE EXPLAINED;
#X text 527 67 As such \, it operates very quickly. If a similar function
-were to be created using PD's arithmetic objects \, the process would
+were to be created using Pd's arithmetic objects \, the process would
be quite a bit slower. How much slower?;
#X text 12 68 CONVENIENT? YES!;
#X text 22 14 [ftom] will convert Wave/Signal Frequency to MIDI note
-numbers. This object exists in PD for the sake of convenience and speed
+numbers. This object exists in Pd for the sake of convenience and speed
of processing.;
#X text 78 85 Select a Frequency: (i.e. 440 hz is an "A" above middle
C);
@@ -222,11 +222,11 @@ C);
#X text 76 232 Select a FREQUENCY here.;
#X obj 33 276 ftom;
#X text 529 33 The [ftom] object is really just a function defined
-in PD's source code - which is programmed in "C".;
-#X text 526 123 The examples at the botton left are PD structures which
+in Pd's source code - which is programmed in "C".;
+#X text 526 123 The examples at the botton left are Pd structures which
emulate the source code of the [ftom] object. In one case \, I have
used the [expr] object to perform the necessary calculation. In the
-other case \, I used PD's Arithmetic objects to perform the calculation.
+other case \, I used Pd's Arithmetic objects to perform the calculation.
;
#X obj 64 256 moses 0;
#X msg 64 277 -1500;
@@ -249,7 +249,7 @@ other case \, I used PD's Arithmetic objects to perform the calculation.
#X text 189 520 Arithmetic is __?__ milliseconds slower than [mtof].
;
#X text 156 556 [expr] is __?__ milliseconds slower than [mtof].;
-#X text 528 200 Firstly \, the PD source code "clips" overflows and
+#X text 528 200 Firstly \, the Pd source code "clips" overflows and
underflows. This means simply that frequencies LESS THAN zero cannot
be tranlated into a MIDI note value - so they're ignored completely
and the object responds with "-1500".;
@@ -260,7 +260,7 @@ MIDI_note;
#X text 528 355 For curiosity's sake \, I included a timer to show
how much faster the [ftom] object is compared to the two alternative
methods.;
-#X text 528 409 As well \, notice that RESULT C (the output from PD's
+#X text 528 409 As well \, notice that RESULT C (the output from Pd's
basic arithmetic objects) is not as accurate as the other two methods:
[ftom] and/or [expr]. This is because the message boxes and the [*]
object round off the operands because they cannot handle enough decimal
@@ -328,12 +328,12 @@ performed on electrical flow. It is used to measure voltage or current.
It is important to note however \, that it does NOT measure "power".
It's also important to recognize that our ears perceive changes in
amplitude (decibels) more than we perceive changes in RMS levels.;
-#X text 23 133 In the digital realm \, i.e. PD! \, RMS is better defined
+#X text 23 133 In the digital realm \, i.e. Pd! \, RMS is better defined
as "a measurement of a signal taken by squaring data points along the
curve \, finding the mean \, and then determining the square root of
that mean value.;
#X restore 39 47 pd What_does_RMS_mean?;
-#X text 19 80 [dbtorms] in PD performs the following equation to convert
+#X text 19 80 [dbtorms] in Pd performs the following equation to convert
the data: Note that incoming values less than 0 or greater than 485
are considered overflow or underflow and are clipped/ignored.;
#X text 22 241 Example:;
@@ -396,7 +396,7 @@ performed on electrical flow. It is used to measure voltage or current.
It is important to note however \, that it does NOT measure "power".
It's also important to recognize that our ears perceive changes in
amplitude (decibels) more than we perceive changes in RMS levels.;
-#X text 23 133 In the digital realm \, i.e. PD! \, RMS is better defined
+#X text 23 133 In the digital realm \, i.e. Pd! \, RMS is better defined
as "a measurement of a signal taken by squaring data points along the
curve \, finding the mean \, and then determining the square root of
that mean value.;
@@ -406,7 +406,7 @@ that mean value.;
#X floatatom 24 422 0 0 0 0 - - -;
#X floatatom 151 354 0 0 0 0 - - -;
#X msg 68 278 0;
-#X text 19 80 [rmstodb] in PD performs the following equation to convert
+#X text 19 80 [rmstodb] in Pd performs the following equation to convert
the data: Note that incoming values less than 0 is consider underflow
and is clipped/ignored.;
#X text 18 178 On a scale of zero to 1 decibels \, the [rmstodb] produces
@@ -455,15 +455,15 @@ not an acoustician.;
#X floatatom 148 242 0 0 0 0 - - -;
#N canvas 0 22 442 244 What_does_power_mean? 0;
#X text 30 25 What does power mean? I really don't know? I can't determine
-from my own research or from PD's documentation why or how this data
-is used. All that I do know \, is that PD provides these objects for
+from my own research or from Pd's documentation why or how this data
+is used. All that I do know \, is that Pd provides these objects for
a good reason -- I just don't know the reason.;
#X text 27 103 Having said that \, I would enjoy learning from somebody
who DOES know more about these objects and their usage. All that I
can offer is an explanation of the equation used to perform these conversions.
;
#X restore 39 47 pd What_does_power_mean?;
-#X text 18 80 [dbtopow] in PD performs the following equation to convert
+#X text 18 80 [dbtopow] in Pd performs the following equation to convert
the data: Note that incoming values less than 0 or greater than 870
are considered overflow or underflow and are clipped/ignored.;
#X obj 148 222 dbtopow;
@@ -502,15 +502,15 @@ not an acoustician.;
#X floatatom 149 298 0 0 0 0 - - -;
#N canvas 0 22 442 244 What_does_power_mean? 0;
#X text 30 25 What does power mean? I really don't know? I can't determine
-from my own research or from PD's documentation why or how this data
-is used. All that I do know \, is that PD provides these objects for
+from my own research or from Pd's documentation why or how this data
+is used. All that I do know \, is that Pd provides these objects for
a good reason -- I just don't know the reason.;
#X text 27 103 Having said that \, I would enjoy learning from somebody
who DOES know more about these objects and their usage. All that I
can offer is an explanation of the equation used to perform these conversions.
;
#X restore 39 47 pd What_does_power_mean?;
-#X text 17 81 [powtodb] in PD performs the following equation to convert
+#X text 17 81 [powtodb] in Pd performs the following equation to convert
the data: Note that incoming values less than 0 are considered underflow
and are clipped/ignored.;
#X text 17 149 (100 + ((10/2.302585092994) * log(POWER_value))) = Debibels
@@ -542,10 +542,10 @@ and are clipped/ignored.;
#X obj 150 40 t3_sig~;
#X obj 205 40 m2f~;
#X obj 249 41 tmtof;
-#X text 18 96 These objects are offered in PD only if you have downloaded
+#X text 18 96 These objects are offered in Pd only if you have downloaded
and properly installed the appropriate library. These objects may or
may not exist in a single library.;
-#X text 17 145 The best places to find information about PD's libraries
+#X text 17 145 The best places to find information about Pd's libraries
is:;
#X text 14 167 www.puredata.org and click on "Downloads" then "Software"
;
diff --git a/doc/pddp/all_about_arrays.pd b/doc/pddp/all_about_arrays.pd
index 9ef53ab8..57c87ca8 100644
--- a/doc/pddp/all_about_arrays.pd
+++ b/doc/pddp/all_about_arrays.pd
@@ -6,7 +6,7 @@ to be "a sequence of objects all of which have the same variable type"
wherein each object is called an element and the elements are numbered
in a row 0 \, 1 \, 2 \, 3 \, etc. These numbers are called indices.
Each index holds a corresponding value.;
-#X text 46 222 Arrays in PD look like this:;
+#X text 46 222 Arrays in Pd look like this:;
#N canvas 0 0 450 300 graph18 0;
#X array example_array 100 float 0;
#X coords 0 1 99 -1 200 140 1;
@@ -17,18 +17,18 @@ called "array".;
#X text 64 543 2 Then right-click again on the array and select "Help"
from the menu. The window that opens is the table.pd help document.
;
-#X text 45 148 All of this is true in PD \, except that arrays in PD
-can only hold floating point data. (other data types in PD are called
+#X text 45 148 All of this is true in Pd \, except that arrays in Pd
+can only hold floating point data. (other data types in Pd are called
"lists" or "anythings" and require different tools to manipulate them.)
;
#X text 45 378 The array above is actually only the horizontal line!
The rectangle surrounding the array is called a "graph". These two
-objects are separate \, but PD creates both simoultaneously for purposes
+objects are separate \, but Pd creates both simoultaneously for purposes
of convenience. These two objects together are called a "table". To
see what I mean by all of this:;
#X restore 43 42 pd What_is_an_array_in_PD;
#N canvas 118 1 608 615 How_to_manipulate_arrays_in_PD 0;
-#X text 13 5 HOW TO MANIPULATE ARRAYS IN PD;
+#X text 13 5 HOW TO MANIPULATE ARRAYS IN Pd;
#N canvas 0 0 452 302 graph28 0;
#X array exampleArray 67 float 0;
#X coords 0 2 67 -2 200 140 1;
@@ -149,7 +149,7 @@ with the contents of exampleArray and concatArray.;
#X text 29 37 In some other programming environments \, including Visual
Basic and Java (among others) \, there are functions which join all
elements of an array into a list. This example shows how this functionality
-can be duplicated in PD. This example uses the elements of exampleArray
+can be duplicated in Pd. This example uses the elements of exampleArray
from the previous help window. The list can either be printed to the
terminal window \, or it can be saved to a text file.;
#X obj 23 214 t f b;
@@ -182,9 +182,9 @@ terminal window \, or it can be saved to a text file.;
#N canvas 2 29 719 337 Getting_the_size_of_an_array 0;
#X text 15 11 GETTING THE SIZE OF AN ARRAY;
#X text 34 34 If you deal with arrays often \, you will want to download
-the [arraysize] external written by PIX. PD lacks a native object for
+the [arraysize] external written by PIX. Pd lacks a native object for
this purpose and I'm afraid that without this external this functionality
-is impossible in PD.;
+is impossible in Pd.;
#X obj 38 127 arraysize exampleArray;
#X obj 38 107 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
-1;
@@ -425,17 +425,17 @@ element of the array and return its value. This is opposite of the
#X connect 45 0 43 0;
#X connect 46 0 9 1;
#X restore 24 449 pd Shifting_an_array;
-#X text 25 32 Arrays in PD are different than the arrays in other languages
-primarily because \, in PD \, they are designed to be displayed graphically
+#X text 25 32 Arrays in Pd are different than the arrays in other languages
+primarily because \, in Pd \, they are designed to be displayed graphically
on screen. This is due to the nature of audio synthesis - we want to
see our wave forms and visually understand the data. That's why arrays
-in PD are complicated by other objects like tables \, graphs and widgets.
+in Pd are complicated by other objects like tables \, graphs and widgets.
PD uses these objects to provide a graphic representation of the array
data. If you're not interested in seeing the array data within your
PD patch \, you can use the [table] object to store the array and corresponding
table in a sub-window. Note that [table]s are more CPU friendly than
their graphical counterpart.;
-#X text 26 230 Like all programming languages \, PD provides numerous
+#X text 26 230 Like all programming languages \, Pd provides numerous
tools to manipulate arrays and their data.;
#N canvas 3 32 718 310 Setting_a_constant_array_value 0;
#X floatatom 26 151 0 0 0 0 - - -;
@@ -443,7 +443,7 @@ tools to manipulate arrays and their data.;
#X msg 26 215 \; exampleArray const \$1;
#X text 18 16 SETTING A CONSTANT ARRAY VALUE;
#X text 27 46 By default \, all array element values are zero. However
-\, PD allows you to change that using the "CONST" message.;
+\, Pd allows you to change that using the "CONST" message.;
#X text 26 88 This feature is useful to reset all values in an array
\, or with a little creativity can be used to "delete" a slice \, or
create silence in audio samples.;
@@ -467,7 +467,7 @@ will be normalized);
#X msg 40 210 \; exampleArray sinesum 64 1;
#X text 26 7 SINE WAVES;
#X text 29 30 comment;
-#X text 45 29 When the "sinesum" message is sent to the array \, PD
+#X text 45 29 When the "sinesum" message is sent to the array \, Pd
will want to know two things:;
#X text 58 65 1 How many samples (array elements) should be used? The
higher the number is \, the higher the resolution of the wave form.
@@ -484,12 +484,12 @@ these wave forms as analog instruments do.;
#X restore 7 42 pd sine_waves;
#X text 141 26 Audio signals in a digital realm are created using a
series of samples. It is digitally possible to create extremely angular
-wave forms using PD arrays \, but the aural result is sometimes distorted
+wave forms using Pd arrays \, but the aural result is sometimes distorted
and unpleasant. Hence \, higher math functions help our digital tools
to produce data which can effectively be converted to analog signals
similar to those of our electronic and mechanical predecessors. The
first and one of the most important mathematic functions in digital
-synthesis is undoubtebly "sinesum". PD provides an easy method for
+synthesis is undoubtebly "sinesum". Pd provides an easy method for
us to integrate these higher math functions in our arrays.;
#N canvas 0 195 750 302 cosine_waves 0;
#X text 11 22 Cosinesum;
@@ -503,7 +503,7 @@ us to integrate these higher math functions in our arrays.;
#X restore 6 73 pd cosine_waves;
#X text 222 257 To normalize an audio signal means to alter the average
amplitude of the signal. For the sake of clear \, undistored sounds
-\, PD would like all of your audio signals to never exceed 1 or -1
+\, Pd would like all of your audio signals to never exceed 1 or -1
The first step in achieving this is "normalization" \, but can be assisted
by more drastic tools like compressors \, limiters \, gain multipliers
\, etc.;
@@ -520,10 +520,10 @@ by more drastic tools like compressors \, limiters \, gain multipliers
#X obj 475 89 openpanel;
#X msg 475 113 \; exampleArray read \$1;
#X text 26 29 Using text files can be helpful in saving or loading
-arrays in PD. Note that the "read" message does not resize your array
+arrays in Pd. Note that the "read" message does not resize your array
automatically.;
#X text 29 160 Audio files can be treated in similar ways by incorporating
-the [soundfiler] object. The soundfiler object provides PD with tools
+the [soundfiler] object. The soundfiler object provides Pd with tools
to automatically resize arrays \, and read/write audio files in a variety
of formats.;
#X obj 77 231 openpanel;
@@ -575,7 +575,7 @@ of formats.;
#X restore 24 526 pd Files_and_arrays;
#N canvas 0 0 719 423 Additional_tools 0;
#X text 18 14 ADDITIONAL TOOLS;
-#X text 29 38 The "array" object in PD accepts special messages to
+#X text 29 38 The "array" object in Pd accepts special messages to
alter the appearance of the array on screen.;
#X text 19 81 Arrays can be renamed:;
#X msg 203 78 \; exampleArray rename george;
@@ -599,7 +599,7 @@ Give a y value and a bunch of x values or vice versa:;
#X restore 24 553 pd Additional_tools;
#N canvas 4 29 717 375 Populating_an_array 0;
#X text 27 12 POPULATING AN ARRAY;
-#X text 41 37 An array in PD is primarily a storage device for numbers.
+#X text 41 37 An array in Pd is primarily a storage device for numbers.
The result is a series of numbers that you can do with whatever you
wish...but how does one populate an array?;
#X text 53 185 list element 1 = array[0];
@@ -618,7 +618,7 @@ than your list \, then your list will be truncated.;
#X restore 41 173 pd How_to_manipulate_arrays_in_PD;
#N canvas 132 0 587 609 How_to_create_an_array_in_PD 0;
#X text 22 9 1 Select "array" from the "Put" menu above.;
-#X text 21 288 4 If you want PD to create a new graph for this array
+#X text 21 288 4 If you want Pd to create a new graph for this array
\, then select "in new graph". If you have another location in mind
-- for example if you want to overlap two arrays in a single graph
\, then select "in last graph".;
@@ -643,7 +643,7 @@ small arrays...larger arrays should be saved to either a text file
\, or an audio file.;
#X restore 42 106 pd How_to_create_an_array_in_PD;
#N canvas 133 1 646 607 Common_uses_for_arrays_in_PD 0;
-#X text 27 26 COMMON USES FOR ARRAYS IN PD;
+#X text 27 26 COMMON USES FOR ARRAYS IN Pd;
#X text 49 60 Arrays are versatile. Their simple structure make them
useful in countless situations. This page discusses perhaps the most
common applications.;
@@ -653,12 +653,12 @@ common applications.;
range \, such as pitch benders.;
#X text 50 306 3 Envelopes: an array with four elements can be used
effectively as an ADSR enveloper. There are numerous examples of this
-in other PD help documents.;
+in other Pd help documents.;
#X text 53 377 4 Math and conversion tables: arrays are an excellent
visual tool when performing fourier analysis and other higher mathematic
functions.;
#X text 54 450 5 Wave editing: with proper manipulation of array data
-\, PD can be fully functional wave editor \, complete with mouse-clickable
+\, Pd can be fully functional wave editor \, complete with mouse-clickable
cut-n-paste \, pitch-shift \, time expansion \, down/upsampling \,
and other tools typically found in commercial wave editors.;
#X text 49 128 1 Audio sample data: when an array's values are limited
@@ -670,7 +670,7 @@ text.;
#X text 39 309 NOTE: I strongly recommend that you download the [arraysize]
external to your "pd/extra" folder before continuing. Some of these
examples are impossible without it -- I personally feel that [arraysize]
-should be considered for permanent inclusion in future PD distributions.
+should be considered for permanent inclusion in future Pd distributions.
Check the CVS Repository or Pure-data.org for [arraysize].;
#X text 40 459 This document is meant to supplement the help documentation
for [table] \, [tabread] \, [tabwrite] \, [soundfiler] \, [tabsend~]
diff --git a/doc/pddp/all_about_atom_conversion.pd b/doc/pddp/all_about_atom_conversion.pd
new file mode 100644
index 00000000..e2160f04
--- /dev/null
+++ b/doc/pddp/all_about_atom_conversion.pd
@@ -0,0 +1,77 @@
+#N canvas 91 99 882 611 10;
+#X obj 4 2 cnv 15 850 20 empty empty all_about_atom_conversion 20 10
+1 18 -233017 -66577 0;
+#X obj 821 3 pddp;
+#X obj 47 364 list2int;
+#X obj 111 363 l2i;
+#X obj 113 389 a2l;
+#X obj 46 390 any2list;
+#X obj 46 340 lister;
+#X obj 46 416 list2symbol;
+#X obj 46 437 symbol2list;
+#X obj 135 416 l2s;
+#X obj 135 436 s2l;
+#X obj 179 417 tosymbol;
+#X obj 179 436 fromsymbol;
+#X obj 548 410 glue;
+#X obj 609 437 pack;
+#X obj 608 411 list2symbol;
+#X obj 718 410 tosymbol;
+#X text 525 384 making "lists" from untyped inputs:;
+#X obj 484 410 repack;
+#X obj 47 318 list;
+#X obj 46 293 any;
+#X obj 75 293 pipe;
+#X text 499 46 a set that is not a "list" has an undefined type:;
+#X obj 528 138 bng 15 250 50 0 empty empty bang 0 20 1 9 -262144 -1
+-1;
+#X obj 574 138 bng 15 250 50 0 empty empty float 0 21 1 9 -262144 -1
+-1;
+#X obj 622 138 bng 15 250 50 0 empty empty symbol 0 21 1 9 -262144
+-1 -1;
+#X msg 526 73 list this is a set with a cast;
+#X msg 533 92 this is a set withOUT a cast;
+#X obj 527 117 route bang float symbol list;
+#X obj 670 138 bng 15 250 50 0 empty empty list 0 21 1 9 -262144 -1
+-1;
+#X obj 718 138 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X msg 10 63 list;
+#X symbolatom 32 129 10 0 0 0 - - -;
+#X text 7 39 SPECIAL CASES OF "LISTS".;
+#X msg 17 83 list 25;
+#X msg 24 103 list foo;
+#X obj 10 171 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 57 170 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 105 169 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 153 170 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 201 169 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 10 148 route bang float symbol list;
+#X text 87 104 A "list" of one "symbol" is converted to a "symbol"
+;
+#X text 72 83 A "list" of one "float" is converted to a "float";
+#X text 50 63 An empty "list" is converted to a "bang";
+#X obj 513 560 pddp_open all_about_data_types;
+#X obj 513 517 pddp_open all_about_lists_vs_anythings;
+#X connect 15 0 14 0;
+#X connect 26 0 28 0;
+#X connect 27 0 28 0;
+#X connect 28 0 23 0;
+#X connect 28 1 24 0;
+#X connect 28 2 25 0;
+#X connect 28 3 29 0;
+#X connect 28 4 30 0;
+#X connect 31 0 41 0;
+#X connect 34 0 41 0;
+#X connect 35 0 32 0;
+#X connect 35 0 41 0;
+#X connect 41 0 36 0;
+#X connect 41 1 37 0;
+#X connect 41 2 38 0;
+#X connect 41 3 39 0;
+#X connect 41 4 40 0;
diff --git a/doc/pddp/all_about_lists_vs_anythings.pd b/doc/pddp/all_about_lists_vs_anythings.pd
index 9881111d..fe9e2136 100644
--- a/doc/pddp/all_about_lists_vs_anythings.pd
+++ b/doc/pddp/all_about_lists_vs_anythings.pd
@@ -1,89 +1,122 @@
-#N canvas 197 93 874 603 10;
-#X msg 74 278 1 2 3;
-#X obj 134 309 route list;
-#X msg 41 258 list 1 2 3;
+#N canvas 330 124 865 611 10;
+#X msg 95 288 1 2 3;
+#X obj 125 319 route list;
+#X msg 62 268 list 1 2 3;
#X msg 10 63 list;
-#X msg 17 83 list 5;
-#X msg 24 103 list pie;
#X symbolatom 32 129 10 0 0 0 - - -;
#X obj 4 2 cnv 15 850 20 empty empty all_about_lists_vs_anythings 20
10 1 18 -233017 -66577 0;
-#X obj 821 3 pddp;
-#X text 20 558 by Hans-Christoph Steiner <hans@at.or.at>;
-#X obj 65 437 list2int;
-#X obj 129 436 l2i;
-#X obj 131 462 a2l;
-#X obj 64 463 any2list;
-#X obj 64 413 lister;
-#X obj 64 489 list2symbol;
-#X obj 64 510 symbol2list;
-#X obj 153 489 l2s;
-#X obj 153 509 s2l;
-#X obj 197 490 tosymbol;
-#X obj 197 509 fromsymbol;
-#X text 501 288 use [prepend]!!;
-#X obj 618 286 prepend;
-#X obj 661 331 drip;
-#X text 568 331 write about:;
-#X obj 539 411 glue;
-#X obj 600 438 pack;
-#X obj 599 412 list2symbol;
-#X obj 709 411 tosymbol;
-#X text 8 208 More than one "float" in a message is considered a "list".
+#X text 9 218 More than one "float" in a message is considered a "list".
More than one "symbol" in a message is not implicitly considered a
"list" \, only if you cast it.;
-#X text 87 104 A "list" of one "symbol" is translated into a "symbol".
-;
-#X text 72 83 A "list" of one "float" is translated into a "float".
-;
-#X text 50 63 An empty "list" is tranlated into a "bang".;
#X text 7 39 SPECIAL CASES OF "LISTS".;
-#X text 497 243 working with "lists" and "anythings":;
-#X text 516 385 making "lists" from untyped inputs:;
-#X obj 10 148 print NOT-LISTS;
-#X obj 475 411 repack;
-#X obj 134 332 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+#X obj 125 342 bng 15 250 50 0 empty empty list -20 7 1 10 -262144
+-1 -1;
+#X obj 189 343 bng 15 250 50 0 empty empty non-list 19 7 1 10 -262144
+-1 -1;
+#X msg 184 267 list this is a set with a cast;
+#X msg 191 286 this is a set withOUT a cast;
+#X obj 488 138 bng 15 250 50 0 empty empty bang 0 20 1 9 -262144 -1
+-1;
+#X obj 535 138 bng 15 250 50 0 empty empty float 0 21 1 9 -262144 -1
-1;
-#X obj 198 333 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+#X obj 684 138 bng 15 250 50 0 empty empty symbol 0 21 1 9 -262144
+-1 -1;
+#X msg 486 73 list this is a set with a cast;
+#X msg 493 92 this is a set withOUT a cast;
+#X obj 585 138 bng 15 250 50 0 empty empty list 0 21 1 9 -262144 -1
-1;
-#X text 478 138 Miller's list explanation;
-#X obj 65 391 list;
-#X obj 64 366 any;
-#X obj 93 366 pipe;
-#X text 509 190 - anything is not a atom type;
-#X text 506 162 - lists map to inlets \, non-lists don't;
-#X obj 55 166 route b f s;
-#X msg 183 257 list this is a set with a cast;
-#X msg 190 276 this is a set withOUT a cast;
-#X text 370 475 a set that is not a "list" has an undefined type:;
-#X obj 469 568 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+#X obj 100 528 route list;
+#X obj 100 551 bng 15 250 50 0 empty empty list -20 7 1 10 -262144
+-1 -1;
+#X obj 164 552 bng 15 250 50 0 empty empty non-list 19 7 1 10 -262144
+-1 -1;
+#X msg 20 491 one 2 three 4 five;
+#X msg 20 469 1 two 3 four 5;
+#X text 8 198 IMPLICIT LISTS;
+#X msg 179 469 list 1 two 3 four 5;
+#X msg 179 491 list one 2 three 4 five;
+#X msg 17 83 list 25;
+#X msg 24 103 list foo;
+#X obj 10 171 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
-1;
-#X obj 516 567 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+#X obj 57 170 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
-1;
-#X obj 564 566 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+#X obj 105 169 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
-1;
-#X msg 468 501 list this is a set with a cast;
-#X msg 475 520 this is a set withOUT a cast;
-#X obj 469 545 route bang float symbol list;
-#X obj 612 567 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+#X obj 153 170 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
-1;
-#X obj 660 566 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+#X obj 201 169 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
-1;
+#X obj 10 148 route bang float symbol list;
+#X text 87 104 A "list" of one "symbol" is converted to a "symbol"
+;
+#X text 72 83 A "list" of one "float" is converted to a "float";
+#X text 50 63 An empty "list" is converted to a "bang";
+#X obj 520 514 pddp_open all_about_atom_conversion;
+#X obj 821 3 pddp;
+#X text 11 392 Sets of mixed atoms are defined based on what the "selector"
+(the first element of a set). If the "selector" is a "float" \, then
+the set is a "list". If the "selector" is the word "list" \, then the
+set is a "list". If the "selector" is a "symbol" \, then the set is
+NOT a "list":;
+#X text 22 575 (C) Copyright 2004 Hans-Christoph Steiner <hans@at.or.at>
+;
+#X text 239 589 released under the GNU GPL;
+#X text 445 576 $Revision: 1.4 $$Date: 2005-04-28 00:25:04 $;
+#X text 446 589 $Author: eighthave $;
+#X text 673 551 updated for Pd 0.38-2;
+#X obj 487 117 route bang float list pointer symbol;
+#X obj 635 138 bng 15 250 50 0 empty empty pointer 0 21 1 9 -262144
+-1 -1;
+#X obj 734 138 bng 15 250 50 0 empty empty UNDEFINED 0 21 1 9 -262144
+-1 -1;
+#X msg 502 286 1 1;
+#X obj 495 312 +;
+#X floatatom 495 334 5 0 0 0 - - -;
+#X msg 467 286 1 3;
+#X text 459 46 A set that is not a "list" has an undefined type:;
+#X msg 494 267 list 1 2;
+#X text 445 208 If you send a "list" of arguments to the first inlet
+of an object \, the elements of that "list" will be applied to the
+respective inlet. This does not apply to sets that are NOT "lists".
+;
+#X text 443 192 "LISTS" MAP TO INLETS;
+#X text 450 389 When working with sets that might be either "lists"
+or undefined \, use [prepend]. Most of the "list" handling objects
+in Pd are not general enough to handle this situation.;
+#X text 450 367 WORKING WITH MIXED SETS;
+#X text 11 373 SETS OF MIXED "ATOMS";
#X connect 0 0 1 0;
-#X connect 1 0 38 0;
-#X connect 1 1 39 0;
+#X connect 1 0 8 0;
+#X connect 1 1 9 0;
#X connect 2 0 1 0;
-#X connect 3 0 36 0;
-#X connect 4 0 36 0;
-#X connect 5 0 6 0;
-#X connect 5 0 36 0;
-#X connect 27 0 26 0;
-#X connect 47 0 1 0;
-#X connect 48 0 1 0;
-#X connect 53 0 55 0;
-#X connect 54 0 55 0;
-#X connect 55 0 50 0;
-#X connect 55 1 51 0;
-#X connect 55 2 52 0;
-#X connect 55 3 56 0;
-#X connect 55 4 57 0;
+#X connect 3 0 33 0;
+#X connect 10 0 1 0;
+#X connect 11 0 1 0;
+#X connect 15 0 45 0;
+#X connect 16 0 45 0;
+#X connect 18 0 19 0;
+#X connect 18 1 20 0;
+#X connect 21 0 18 0;
+#X connect 22 0 18 0;
+#X connect 24 0 18 0;
+#X connect 25 0 18 0;
+#X connect 26 0 33 0;
+#X connect 27 0 4 0;
+#X connect 27 0 33 0;
+#X connect 33 0 28 0;
+#X connect 33 1 29 0;
+#X connect 33 2 30 0;
+#X connect 33 3 31 0;
+#X connect 33 4 32 0;
+#X connect 45 0 12 0;
+#X connect 45 1 13 0;
+#X connect 45 2 17 0;
+#X connect 45 3 46 0;
+#X connect 45 4 14 0;
+#X connect 45 5 47 0;
+#X connect 48 0 49 0;
+#X connect 49 0 50 0;
+#X connect 51 0 49 0;
+#X connect 53 0 49 0;
diff --git a/doc/pddp/all_about_midi_flags.pd b/doc/pddp/all_about_midi_flags.pd
index 220246e1..b4abd127 100644
--- a/doc/pddp/all_about_midi_flags.pd
+++ b/doc/pddp/all_about_midi_flags.pd
@@ -1,7 +1,7 @@
#N canvas 224 22 513 695 10;
-#X text 11 34 MIDI in PD is handled through the 'raw' midi devices
-(such as /dev/midi*). One could specify which MIDI port PD is supposed
-to use through a command line switch when starting PD \, i.e.:;
+#X text 11 34 MIDI in Pd is handled through the 'raw' midi devices
+(such as /dev/midi*). One could specify which MIDI port Pd is supposed
+to use through a command line switch when starting Pd \, i.e.:;
#X text 35 95 pd -midiindev 1 -midioutdev 2;
#X text 43 236 pd -mididev 1;
#X text 17 264 This will use the first port for both MIDI input and
@@ -17,23 +17,23 @@ etc).;
#X text 13 119 so \, the above will use the first MIDI device for MIDI
input (it could be a MIDI controller such as a keyboard \, midi-guitar
\, midi knob box etc) and the device #2 will be used for outputting
-the MIDI (re)generated or sent by PD.;
+the MIDI (re)generated or sent by Pd.;
#X text 13 181 For using the same device for MIDI input AND output
(i.e. when one uses a MIDI keyboard which is also a synthesizer) the
following command line switch will do:;
-#X text 19 470 MIDI objects in PD (the ones that read and write to
+#X text 19 470 MIDI objects in Pd (the ones that read and write to
MIDI ports) take a MIDI channel as an argument. Channels 1-16 use the
first MIDI device \, 17-32 use the second MIDI device and so on. For
-this to work one must specify which devices PD is supposed to use:
+this to work one must specify which devices Pd is supposed to use:
;
#X text 39 548 -midiindev 1 \, 2 -- use devices 1 and 2 for input;
#X text 39 564 -midioutdev 1 \, 2 -- use devices 1 and 2 for output
;
#X text 39 580 -mididev 1 \, 2 -- use devices 1 and 2 for input and
output;
-#X text 17 292 NOTE (Linux): PD counts the MIDI devices starting from
+#X text 17 292 NOTE (Linux): Pd counts the MIDI devices starting from
1 Usually \, the operating system counts them starting with 0 (zero)
-so if you want to use /dev/midi00 \, PD has to be started with -mididev
+so if you want to use /dev/midi00 \, Pd has to be started with -mididev
1 Always add 1 to the device number.;
#X text 21 600 NOTE (Windows): -listdev command line option lists all
available MIDI and audio devices.;
diff --git a/doc/pddp/all_about_scope_and_locality.pd b/doc/pddp/all_about_scope_and_locality.pd
index 0c937690..2c413bd4 100644
--- a/doc/pddp/all_about_scope_and_locality.pd
+++ b/doc/pddp/all_about_scope_and_locality.pd
@@ -49,7 +49,7 @@ cyberspace from send objects of the same name! Hence \, if you name
a [send] something like "foo" \, then all [receive] objects in open
patches named "foo" will 'hear' those messages. Also note that the
term 'open patches' includes all sub-patches \, abstractions and patches
-that are currently open in PD - they don't have to be VISIBLE...they
+that are currently open in Pd - they don't have to be VISIBLE...they
only have to be active.;
#X connect 5 0 4 0;
#X connect 7 0 10 0;
@@ -84,9 +84,9 @@ These two agruments are now available in this patch by using \$1 or
'Inheritance'.;
#X text 13 267 In the examples above I have used a variable ($1) to
name these [send] and [receive] objects. The value of this variable
-is assigned either by PD (randomly for each abstraction or patch) \,
+is assigned either by Pd (randomly for each abstraction or patch) \,
or by me with the use of arguments.;
-#X text 11 335 If you would like PD to assign the value of your local
+#X text 11 335 If you would like Pd to assign the value of your local
variable at random \, use \$0. This will ensure that your local variables
will always be 'local' and won't ever correspond with variables in
other open patches or abstractions.;
@@ -109,7 +109,7 @@ you should see:;
#N canvas 145 31 610 615 INHERITANCE 0;
#X text 20 18 The word "Inherit" means to "receive a characteristic
from one's parent".;
-#X text 19 59 In PD \, all abstracions and subpatches have 'parents'
+#X text 19 59 In Pd \, all abstracions and subpatches have 'parents'
-- the parent is the main patch which created the instance of the abstraction
or subpatch.;
#X text 18 117 We can use 'arguments' when creating an abstraction
@@ -127,7 +127,7 @@ this abstraction and all of its subpatches!;
#X symbolatom 146 356 0 0 0 0 - - -;
#X obj 146 327 symbol \$2;
#X text 24 388 So \, if a [send] object is named "$1-foo" or "$2-foo"
-inside this abstraction \, PD identifies that [send] object as "and-foo"
+inside this abstraction \, Pd identifies that [send] object as "and-foo"
or "inheritance-foo".;
#X obj 47 466 s and-foo;
#X obj 47 516 s \$1-foo;
@@ -158,7 +158,7 @@ or "inheritance-foo".;
#X connect 16 0 20 0;
#X connect 19 0 17 0;
#X restore 11 217 pd INHERITANCE;
-#X text 16 285 From section 2.6.5 of the PD manual \, Miller Puckette
+#X text 16 285 From section 2.6.5 of the Pd manual \, Miller Puckette
says:;
#X text 39 316 "Note that the expansion of variables such as \$0 and
\$1 only works at the beginning of the symbol. So \, for instance \,
diff --git a/doc/pddp/all_about_send_n_receive.pd b/doc/pddp/all_about_send_n_receive.pd
index a3684888..de004148 100644
--- a/doc/pddp/all_about_send_n_receive.pd
+++ b/doc/pddp/all_about_send_n_receive.pd
@@ -10,7 +10,7 @@ message sent within a single patch - from a [send] object to a [receive]
object in the same patch. But the functionality of these objects goes
far beyond the scope of a single patch.;
#X text 10 385 A [send] object is a little like a radio station...it
-broadcasts information throughout PD \, for all the [receives] to hear!
+broadcasts information throughout Pd \, for all the [receives] to hear!
A [receive] object is a little like your own AM/FM tuner...it will
receive messages from all the [send] objects that it is 'tuned' to.
Hence \, naming your [send] and [receive] objects becomes very important.
@@ -75,7 +75,7 @@ with send and receives objects.;
-1 -1 0 256;
#X text 310 360 These number boxes are linked together via their 'send'
or 'receive' property.;
-#X text 298 8 Some objects in PD contain their own internal send and
+#X text 298 8 Some objects in Pd contain their own internal send and
receive functionality.;
#X connect 23 0 25 0;
#X connect 26 0 24 0;
diff --git a/doc/pddp/help-bang.pd b/doc/pddp/bang-help.pd
index 1fa70925..485c9699 100644
--- a/doc/pddp/help-bang.pd
+++ b/doc/pddp/bang-help.pd
@@ -79,7 +79,7 @@ inlet.;
because it lights-up when it receives a message or is clicked on and
can be coloured \, resized \, or renamed. It is sometimes 'friendlier'
as well because it can act as its own send and receive object (see
-properties...). This object can be put in a PD patch either by keyboard
+properties...). This object can be put in a Pd patch either by keyboard
shortcut: ALT+B or by creating and object (CTRL+1) called "bng".;
#X text 66 482 The default hold is 250 milliseconds. The hold value
controls the length of time that the bng object stays "lit". Note that
@@ -103,9 +103,9 @@ see the effect.;
#X obj 370 620 print;
#X text 69 143 a.k.a. "bng";
#X text 43 264 PROPERTIES OF BNG;
-#X text 497 548 This document was updated for PD version 0.35 test
+#X text 497 548 This document was updated for Pd version 0.35 test
24 by Dave Sabine as part of a project called pddp proposed by Krzysztof
-Czaja to build comprehensive documentation for PD.;
+Czaja to build comprehensive documentation for Pd.;
#N canvas 4 24 432 275 related_objects_from_other_libraries 0;
#X obj 266 48 oneshot;
#X obj 259 28 toddle;
@@ -117,10 +117,10 @@ Czaja to build comprehensive documentation for PD.;
#X obj 108 48 countund;
#X obj 163 48 kalashnikov;
#X obj 236 48 init;
-#X text 18 86 These objects are offered in PD only if you have downloaded
+#X text 18 86 These objects are offered in Pd only if you have downloaded
and properly installed the appropriate library. These objects may or
may not exist in a single library.;
-#X text 17 135 The best places to find information about PD's libraries
+#X text 17 135 The best places to find information about Pd's libraries
is:;
#X text 14 157 www.puredata.org and click on "Downloads" then "Software"
;
diff --git a/doc/pddp/help-bendin.pd b/doc/pddp/bendin-help.pd
index e14aa01d..5bca1ea3 100644
--- a/doc/pddp/help-bendin.pd
+++ b/doc/pddp/bendin-help.pd
@@ -1,66 +1,66 @@
-#N canvas 244 81 492 554 10;
-#X text 118 123 outlets:;
-#X floatatom 16 149 5 0 0;
-#X floatatom 59 149 5 0 0;
-#N canvas 240 135 476 472 other_midi_objects 0;
-#X obj 7 29 ctlin;
-#X obj 49 29 pgmin;
-#X obj 92 28 bendin;
-#X obj 143 27 touchin;
-#X obj 204 27 polytouchin;
-#X obj 289 27 midiin;
-#X obj 340 26 sysexin;
-#X obj 6 85 noteout;
-#X obj 63 84 ctlout;
-#X obj 160 84 bendout;
-#X obj 217 83 touchout;
-#X obj 281 82 polytouchout;
-#X obj 370 82 midiout;
-#X obj 113 84 pgmout;
-#X obj 11 153 makenote;
-#X text 10 194 MIDI notes deconstruction:;
-#X text 8 128 MIDI note construction:;
-#X text 8 58 MIDI output:;
-#X text 8 2 MIDI input:;
-#X obj 15 226 stripnote;
-#X text 11 266 Additional useful objects for MIDI processing (Maxlib
-by Olaf Matthes);
-#X obj 148 297 chord;
-#X obj 109 296 borax;
-#X obj 54 296 score o;
-#X obj 13 296 pitch;
-#X text 15 336 Also \, from cyclone (alpha) by Krzysztof Czaja:;
-#X obj 16 359 midiformat;
-#X obj 172 359 midiflush;
-#X obj 98 359 midiparse;
-#X text 15 386 and xeq \, from the same developer;
-#X obj 16 411 xeq;
-#X text 41 402 an experimental MIDI sequencer;
-#X restore 20 401 pd other_midi_objects;
-#X text 18 346 related object;
-#X obj 283 420 midi-basics;
-#X text 18 421 for an explanation of MIDI usage in PD see:;
-#X obj 33 18 bendin;
-#X text 119 103 inlets : none (reads directly from the MIDI port);
-#X obj 23 107 bendin;
-#X text 9 49 The [bendin] object reads incoming pitch bend values and
-reports them. If started with no arguments it reports the channel number
-through the right outlet.;
-#X text 14 192 Arguments: the MIDI channel number from which to read.
-If the argument is present \, the [bendin] object does not show the
-second (right) outlet:;
-#X obj 25 256 bendin 2;
-#X floatatom 25 278 5 0 0;
-#X obj 21 361 bendout;
-#X text 76 279 <-- pitch bend values on channel 2;
-#X text 16 312 Output (int) is a 14-bit pitchbend value;
-#X text 130 142 left: pitchbend value;
-#X text 129 159 right: MIDI channel number (if no argument);
-#X text 81 19 - read incoming pitch bend values.;
-#X text 19 482 This document was updated for PD version 0.35 by Michal
-Seta as part of a project called pddp proposed by Krzysztof Czaja \,
-managed and edited by Dave Sabine \, to build comprehensive documentation
-for PD.;
-#X connect 9 0 1 0;
-#X connect 9 1 2 0;
-#X connect 12 0 13 0;
+#N canvas 244 81 496 558 10;
+#X text 118 123 outlets:;
+#X floatatom 16 149 5 0 0 0 - - -;
+#X floatatom 59 149 5 0 0 0 - - -;
+#N canvas 240 135 476 472 other_midi_objects 0;
+#X obj 7 29 ctlin;
+#X obj 49 29 pgmin;
+#X obj 92 28 bendin;
+#X obj 143 27 touchin;
+#X obj 204 27 polytouchin;
+#X obj 289 27 midiin;
+#X obj 340 26 sysexin;
+#X obj 6 85 noteout;
+#X obj 63 84 ctlout;
+#X obj 160 84 bendout;
+#X obj 217 83 touchout;
+#X obj 281 82 polytouchout;
+#X obj 370 82 midiout;
+#X obj 113 84 pgmout;
+#X obj 11 153 makenote;
+#X text 10 194 MIDI notes deconstruction:;
+#X text 8 128 MIDI note construction:;
+#X text 8 58 MIDI output:;
+#X text 8 2 MIDI input:;
+#X obj 15 226 stripnote;
+#X text 11 266 Additional useful objects for MIDI processing (Maxlib
+by Olaf Matthes);
+#X obj 148 297 chord;
+#X obj 109 296 borax;
+#X obj 54 296 score o;
+#X obj 13 296 pitch;
+#X text 15 336 Also \, from cyclone (alpha) by Krzysztof Czaja:;
+#X obj 16 359 midiformat;
+#X obj 172 359 midiflush;
+#X obj 98 359 midiparse;
+#X text 15 386 and xeq \, from the same developer;
+#X obj 16 411 xeq;
+#X text 41 402 an experimental MIDI sequencer;
+#X restore 20 401 pd other_midi_objects;
+#X text 18 346 related object;
+#X obj 104 447 pddp_open all_about_midi_flags;
+#X text 18 421 for an explanation of MIDI usage in Pd see:;
+#X obj 33 18 bendin;
+#X text 119 103 inlets : none (reads directly from the MIDI port);
+#X obj 23 107 bendin;
+#X text 9 49 The [bendin] object reads incoming pitch bend values and
+reports them. If started with no arguments it reports the channel number
+through the right outlet.;
+#X text 14 192 Arguments: the MIDI channel number from which to read.
+If the argument is present \, the [bendin] object does not show the
+second (right) outlet:;
+#X obj 25 256 bendin 2;
+#X floatatom 25 278 5 0 0 0 - - -;
+#X obj 21 361 bendout;
+#X text 76 279 <-- pitch bend values on channel 2;
+#X text 16 312 Output (int) is a 14-bit pitchbend value;
+#X text 130 142 left: pitchbend value;
+#X text 129 159 right: MIDI channel number (if no argument);
+#X text 81 19 - read incoming pitch bend values.;
+#X text 19 482 This document was updated for Pd version 0.35 by Michal
+Seta as part of a project called pddp proposed by Krzysztof Czaja \,
+managed and edited by Dave Sabine \, to build comprehensive documentation
+for Pd.;
+#X connect 9 0 1 0;
+#X connect 9 1 2 0;
+#X connect 12 0 13 0;
diff --git a/doc/pddp/help-bendout.pd b/doc/pddp/bendout-help.pd
index f25791f3..68391ab0 100644
--- a/doc/pddp/help-bendout.pd
+++ b/doc/pddp/bendout-help.pd
@@ -37,8 +37,8 @@ by Olaf Matthes);
#X obj 8 31 midiin;
#X restore 20 392 pd other_midi_objects;
#X text 18 337 related object;
-#X obj 282 412 midi-basics;
-#X text 18 412 for an explanation of MIDI usage in PD see:;
+#X obj 282 412 pddp_open all_about_midi_flags;
+#X text 18 412 for an explanation of MIDI usage in Pd see:;
#X floatatom 20 266 5 0 0;
#X text 111 263 <-- pitch bend values on channel 2;
#X obj 39 21 bendout;
@@ -58,10 +58,10 @@ and formats it into a pitchbend MIDI message and sends out the MIDI
port on the appropriate channel. If no argument is given it defaults
to channel 1;
#X text 87 22 - send pitchbend value to the MIDI port;
-#X text 18 482 This document was updated for PD version 0.35 by Michal
+#X text 18 482 This document was updated for Pd version 0.35 by Michal
Seta as part of a project called pddp proposed by Krzysztof Czaja \,
managed and edited by Dave Sabine \, to build comprehensive documentation
-for PD.;
+for Pd.;
#X connect 0 0 9 0;
#X connect 1 0 9 1;
#X connect 6 0 15 0;
diff --git a/doc/pddp/help-bng.pd b/doc/pddp/bng-help.pd
index e5ddf65f..71e5d17e 100644
--- a/doc/pddp/help-bng.pd
+++ b/doc/pddp/bng-help.pd
@@ -252,9 +252,9 @@
#X obj 180 11 x_all_guis aaa bbb ccc ddd eee fff ggg hhh iii;
#X text 366 35 SEE ALSO:;
#X obj 429 34 bang;
-#X text 22 341 This document was updated for PD version 0.35 test 24
+#X text 22 341 This document was updated for Pd version 0.35 test 24
by Dave Sabine as part of a project called pddp proposed to build comprehensive
-documentation for PD.;
+documentation for Pd.;
#X connect 6 0 5 0;
#X connect 8 0 9 0;
#X connect 9 0 7 0;
diff --git a/doc/pddp/help-change.pd b/doc/pddp/change-help.pd
index 3f77da07..2a799401 100644
--- a/doc/pddp/help-change.pd
+++ b/doc/pddp/change-help.pd
@@ -31,9 +31,9 @@ the currently stored value) and then stored.;
#X obj 23 467 change;
#X text 19 365 The "set" method can be used to store a number in the
object without outputting that value.;
-#X text 22 585 This document was updated for PD version 0.35 test 26
+#X text 22 585 This document was updated for Pd version 0.35 test 26
by Dave Sabine as part of a project called pddp proposed by Krzysztof
-Czaja to build comprehensive documentation for PD.;
+Czaja to build comprehensive documentation for Pd.;
#X text 17 269 Sending a "bang" message to the inlet will force [change]
to output its current value.;
#X connect 0 0 8 0;
diff --git a/doc/pddp/clip-help.pd b/doc/pddp/clip-help.pd
new file mode 100644
index 00000000..b4bc684f
--- /dev/null
+++ b/doc/pddp/clip-help.pd
@@ -0,0 +1,106 @@
+#N canvas 3 22 569 590 10;
+#X obj 114 540 pddp;
+#X obj 8 3 cnv 15 90 578 empty empty empty 20 12 0 14 -233017 -66577
+0;
+#X text 38 36 INLETS:;
+#X text 38 51 - LEFT:;
+#X text 32 230 - RIGHT:;
+#X text 29 346 OUTLETS:;
+#X text 13 281 ARGUMENTS:;
+#X text 20 392 EXAMPLES:;
+#X text 20 488 SEE ALSO:;
+#N canvas 58 22 423 272 Related_Objects 0;
+#X text 25 11 Native Pd Objects;
+#X text 23 92 Externals and other object libraries;
+#X obj 45 54 int;
+#X obj 85 53 f;
+#X obj 123 53 min;
+#X obj 166 53 max;
+#X obj 206 53 clip~;
+#X obj 260 53 min~;
+#X obj 308 53 max~;
+#X text 44 125 - none that I am aware of;
+#X restore 114 488 pd Related_Objects;
+#N canvas 57 22 651 632 More_Info 0;
+#X text 40 187 LOW AND HIGH VALUES;
+#X text 304 34 Consider the following:;
+#X floatatom 101 66 5 0 0 0 - - -;
+#X floatatom 83 147 5 0 0 0 - - -;
+#X obj 83 121 min 50;
+#X obj 83 95 max -50;
+#X text 170 106 same as;
+#X obj 271 104 clip -50 50;
+#X floatatom 271 133 5 0 0 0 - - -;
+#X text 43 18 [clip] is a tool which combines the functionality of
+[min] and [max] into a single object.;
+#X text 56 208 [clip] always assumes that the first argument (second
+inlet) is the low extreme of the range and the second argument (third
+inlet) is the high extreme. However \, strange behaviour should be
+expected if you mix these arguments up.;
+#X obj 64 331 clip -50 50;
+#X obj 190 325 clip 72 -104;
+#X floatatom 64 298 5 0 0 0 - - -;
+#X floatatom 64 360 5 0 0 0 - - -;
+#X floatatom 190 357 5 0 0 0 - - -;
+#X text 195 284 Numbers below 72 are clipped to 72;
+#X text 195 304 Numbers above -104 are clipped to -104;
+#X text 72 405 This could be used effectively to toggle between two
+numbers.;
+#X floatatom 401 383 5 0 0 0 - - -;
+#X obj 370 360 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0
+1;
+#X obj 402 352 clip 1 -1024;
+#X connect 2 0 5 0;
+#X connect 2 0 7 0;
+#X connect 4 0 3 0;
+#X connect 5 0 4 0;
+#X connect 7 0 8 0;
+#X connect 11 0 14 0;
+#X connect 12 0 15 0;
+#X connect 13 0 11 0;
+#X connect 13 0 12 0;
+#X connect 20 0 21 0;
+#X connect 21 0 19 0;
+#X restore 114 514 pd More_Info;
+#X obj 57 11 clip;
+#X text 105 51 Float - A float at the left inlet will be clipped to
+the low and high values stored in the object.;
+#X text 105 82 List - A list at the left inlet will be truncated to
+include only the first three elements. The first element in the list
+is the number which will be clipped. The second element will update
+the value stored at the second inlet. The third element will update
+the value stored at the third inlet.;
+#X text 25 180 - CENTER:;
+#X text 105 180 Float - A float at the second inlet is stored for later
+use. It will be used as either the low or high value at which to clip
+incoming floats at that left inlet.;
+#X text 105 231 Float - A float at the third inlet is stored for later
+use. It will be used as either the low or high value at which to clip
+incoming floats at that left inlet.;
+#X text 104 281 Two - [float] accepts two floats as creation arguments
+which initializes the first values to be stored in the object and duplicate
+the functions of the second and third inlet.;
+#X text 108 12 - FORCE A NUMBER INTO A RANGE;
+#X obj 122 428 clip -50 50;
+#X floatatom 122 455 5 0 0 0 - - -;
+#X floatatom 122 404 5 0 0 0 - - -;
+#X text 181 405 creation arguments;
+#X obj 411 466 clip;
+#X floatatom 410 437 5 0 0 0 - - -;
+#X floatatom 460 437 5 0 0 0 - - -;
+#X floatatom 510 437 5 0 0 0 - - -;
+#X floatatom 411 492 5 0 0 0 - - -;
+#X text 464 468 no arguments;
+#X text 450 405 list;
+#X text 158 541 - Dave Sabine \, April 25 \, 2003;
+#X msg 373 405 42 100 500;
+#X text 344 565 updated for Pd version 0.38-2;
+#X text 102 346 One - outputs a float which is limited to a range within
+the high and low values of the second and third inlet.;
+#X connect 19 0 20 0;
+#X connect 21 0 19 0;
+#X connect 23 0 27 0;
+#X connect 24 0 23 0;
+#X connect 25 0 23 1;
+#X connect 26 0 23 2;
+#X connect 31 0 23 0;
diff --git a/doc/pddp/help-cputime.pd b/doc/pddp/cputime-help.pd
index 3e71f7ce..17bce30b 100644
--- a/doc/pddp/help-cputime.pd
+++ b/doc/pddp/cputime-help.pd
@@ -11,7 +11,7 @@
#X floatatom 108 585 0 0 0;
#X floatatom 175 573 0 0 0;
#X text 11 358 In the example below \, I've created an abstraction
-which will force each of PD's stop-watches \, [timer] [cputime] and
+which will force each of Pd's stop-watches \, [timer] [cputime] and
[realtime] to measure various processes and report the elapsed time.
Click on each [bng] to begin the process and wait for the results.
Notice the discrepancies in the results.;
@@ -22,7 +22,7 @@ Notice the discrepancies in the results.;
-1;
#X text 72 435 1 Measures elapsed time between two "bangs" from a [trigger]
object.;
-#X text 87 469 2 Measures the amount of time PD requires to turn on
+#X text 87 469 2 Measures the amount of time Pd requires to turn on
DSP and start an oscillator.;
#X obj 445 484 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
-1;
@@ -32,13 +32,13 @@ DSP and start an oscillator.;
#X text 475 59 In a fantasy world \, computers could exist somehow
beyond the restrictions of time and digital computation could be performed
in ZERO time. However \, that is not the case. Instead \, every process
-within PD and within your operating system requires at least a few
+within Pd and within your operating system requires at least a few
nanoseconds of your CPU's time.;
#X obj 111 509 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
-1;
#X text 476 144 The [timer] object is like a clock that is not constrained
to the regular laws of physics and the universal space-time continuum.
-It reports "time" measurements as only PD can see them!;
+It reports "time" measurements as only Pd can see them!;
#X text 477 203 The [cputime] object is like a clock that measures
how much time your CPU actually required to carry out your request.
Keep in mind however that your CPU is busy doing many things simoultaneously
@@ -46,35 +46,35 @@ Keep in mind however that your CPU is busy doing many things simoultaneously
CPU does not pay full attention to that process for the entire 5 minutes.
Instead \, it simply begins the process \, then refers back to that
process from time to time until the it is complete. In other cases
-\, your CPU might require a full 5 minutes while PD might report that
+\, your CPU might require a full 5 minutes while Pd might report that
merely a few milliseconds have passed. This type of discrepancy depends
heavily on your computer's hardware and the type of processing it is
performing.;
#X text 478 368 The [realtime] object is as much like your own wrist
-watch as PD can possibly manage. It measures time according to your
+watch as Pd can possibly manage. It measures time according to your
operating system's internal clock.;
#N canvas 0 0 456 306 related_objects_from_other_libraries 0;
-#X text 27 63 These objects are offered in PD only if you have downloaded
+#X text 27 63 These objects are offered in Pd only if you have downloaded
and properly installed the appropriate library. These objects may or
may not exist in a single library.;
-#X text 26 112 The best places to find information about PD's libraries
+#X text 26 112 The best places to find information about Pd's libraries
is:;
#X text 23 134 www.puredata.org and click on "Downloads" then "Software"
;
#X text 25 149 or;
#X text 25 164 iem.kug.ac.at/pdb/;
#X obj 44 24 t3_timer;
-#X text 469 589 This document was updated for PD version 0.35 test
+#X text 469 589 This document was updated for Pd version 0.35 test
26 by Dave Sabine as part of a project called pddp proposed by Krzysztof
-Czaja to build comprehensive documentation for PD.;
+Czaja to build comprehensive documentation for Pd.;
#X restore 482 539 pd related_objects_from_other_libraries;
-#X text 309 580 This document was updated for PD version 0.35 test
+#X text 309 580 This document was updated for Pd version 0.35 test
28 by Dave Sabine as part of a project called pddp proposed by Krzysztof
-Czaja to build comprehensive documentation for PD.;
+Czaja to build comprehensive documentation for Pd.;
#X obj 602 508 metro;
#X text 481 485 RELATED OBJECTS;
#X obj 539 508 realtime;
-#X text 132 501 3 Measures the amount of time PD requires count to
+#X text 132 501 3 Measures the amount of time Pd requires count to
three...please wait for approximately 3 seconds.;
#X obj 25 15 cputime;
#X text 80 14 -- measure CPU time;
diff --git a/doc/pddp/help-ctlin.pd b/doc/pddp/ctlin-help.pd
index 136ea95d..1ff68af6 100644
--- a/doc/pddp/help-ctlin.pd
+++ b/doc/pddp/ctlin-help.pd
@@ -34,8 +34,8 @@ by Olaf Matthes);
#X text 41 402 an experimental MIDI sequencer;
#X obj 8 31 midiin;
#X restore 88 534 pd other_midi_objects;
-#X obj 280 562 midi-basics;
-#X text 18 562 for an explanation of MIDI usage in PD see:;
+#X obj 280 562 pddp_open all_about_midi_flags;
+#X text 18 562 for an explanation of MIDI usage in Pd see:;
#X obj 28 18 ctlin;
#X obj 19 226 ctlin;
#X floatatom 19 252 5 0 0;
@@ -74,10 +74,10 @@ from the MIDI port. See a MIDI-specification chart near you for control
change message numbers and their meannings (MIDI implementation documents
are freely available on the internet in c=various forms).;
#X text 69 18 - read incoming Control Change messages;
-#X text 19 586 This document was updated for PD version 0.35 by Michal
+#X text 19 586 This document was updated for Pd version 0.35 by Michal
Seta as part of a project called pddp proposed by Krzysztof Czaja \,
managed and edited by Dave Sabine \, to build comprehensive documentation
-for PD.;
+for Pd.;
#X connect 4 0 5 0;
#X connect 4 1 6 0;
#X connect 4 2 7 0;
diff --git a/doc/pddp/help-ctlout.pd b/doc/pddp/ctlout-help.pd
index 621fb9d7..4429a51e 100644
--- a/doc/pddp/help-ctlout.pd
+++ b/doc/pddp/ctlout-help.pd
@@ -34,8 +34,8 @@ by Olaf Matthes);
#X text 41 402 an experimental MIDI sequencer;
#X obj 8 31 midiin;
#X restore 89 430 pd other_midi_objects;
-#X obj 285 469 midi-basics;
-#X text 21 469 for an explanation of MIDI usage in PD see:;
+#X obj 285 469 pddp_open all_about_midi_flags;
+#X text 21 469 for an explanation of MIDI usage in Pd see:;
#X obj 18 16 ctlout;
#X text 14 43 The [ctlout] objects sends control messages to the MIDI
port. See a MIDI specification chart for various controller numbers/values
@@ -74,10 +74,10 @@ number and third the channel number.;
#X text 22 411 See also:;
#X obj 25 430 ctlin;
#X text 66 17 - send MIDI control messages to the MIDI port;
-#X text 19 515 This document was updated for PD version 0.35 by Michal
+#X text 19 515 This document was updated for Pd version 0.35 by Michal
Seta as part of a project called pddp proposed by Krzysztof Czaja \,
managed and edited by Dave Sabine \, to build comprehensive documentation
-for PD.;
+for Pd.;
#X connect 8 0 9 0;
#X connect 10 0 9 1;
#X connect 11 0 9 2;
diff --git a/doc/pddp/help-dac~.pd b/doc/pddp/dac~-help.pd
index a45a4594..d332da95 100644
--- a/doc/pddp/help-dac~.pd
+++ b/doc/pddp/dac~-help.pd
@@ -5,30 +5,30 @@
#N canvas 85 2 595 611 More_Info 0;
#X text 16 13 MULTI-CHANNEL AUDIO;
#X text 32 40 All sound cards are capable of at least two channels
-of audio. PD supports these two channels by default and uses your system's
+of audio. Pd supports these two channels by default and uses your system's
generic audio drivers to communicate with your hardware. However \,
for faster input/output and for more than two channels of audio \,
PD incorporates the use of "PortAudio" which uses ASIO drivers to communicate
-with your hardware. So \, to instruct PD to use more than two channels
+with your hardware. So \, to instruct Pd to use more than two channels
of audio \, your command line should read like below:;
#X text 93 182 c:/pd/bin/pd.exe -pa -inchannels 8 -outchannels 8;
#X text 32 211 The "-pa" switch means "PortAudio". This switch is new
-as of PD version 0.37 TEST 4 and replaces the old "-asio" switch.;
+as of Pd version 0.37 TEST 4 and replaces the old "-asio" switch.;
#X text 32 271 The "-inchannels" and "-outchannels" switches can be
summarized by using "-channels 8" because currently PortAudio requires
that the number of incoming and outgoing channels must be equal. This
-may change in the PD's future...;
-#X text 32 361 To further optimize PD's usage of your audio hardware
+may change in the Pd's future...;
+#X text 32 361 To further optimize Pd's usage of your audio hardware
\, you can explore the following:;
#X text 42 402 - audiobuf;
#X text 43 420 - blocksize;
#X text 42 436 - audioindev;
#X text 42 454 - audiooutdev;
-#X text 38 480 With the right hardware \, PD can manage audio input
+#X text 38 480 With the right hardware \, Pd can manage audio input
and output with lower than 10 milliseconds of latency.;
#X restore 104 514 pd More_Info;
#N canvas 85 2 397 246 Related_Objects 0;
-#X text 25 8 Native PD Objects;
+#X text 25 8 Native Pd Objects;
#X text 25 92 Externals and other object libraries;
#X obj 98 46 switch~;
#X obj 171 46 block~;
@@ -44,7 +44,7 @@ and output with lower than 10 milliseconds of latency.;
#X obj 33 20 dac~;
#X text 108 18 - AUDIO OUTPUT: DIGITAL/ANALOG CONVERTER SIGNAL;
#X text 104 53 [dac~] is an acronym meaning "Digital/Analog Converter
-Signal" and is PD's interface to send audio information to the audio
+Signal" and is Pd's interface to send audio information to the audio
channels of your soundcard(s).;
#X text 106 106 The object defaults to 2 outgoing audio channels (usually
a left and right stereo pair). Any number of arguments (integers) can
diff --git a/doc/pddp/help-delay.pd b/doc/pddp/delay-help.pd
index 8dca318b..a486eab9 100644
--- a/doc/pddp/help-delay.pd
+++ b/doc/pddp/delay-help.pd
@@ -79,7 +79,7 @@ dusty" sound \, you make the density quite low.;
1;
#X text 432 376 Dust.ar(2) in SC will produce 2 dusty impulses randomly
per second. In the example below \, you'll see a version of this process
-created using PD's delay object.;
+created using Pd's delay object.;
#X obj 434 463 random 500;
#X obj 434 442 metro 500;
#X text 13 563 It is important to realize that [delay] only outputs
@@ -95,10 +95,10 @@ than "bang". For that purpose \, you should explore;
#X obj 63 25 z~;
#X obj 93 25 t3_delay;
#X obj 153 25 idelay~;
-#X text 18 59 These objects are offered in PD only if you have downloaded
+#X text 18 59 These objects are offered in Pd only if you have downloaded
and properly installed the appropriate library. These objects may or
may not exist in a single library.;
-#X text 17 108 The best places to find information about PD's libraries
+#X text 17 108 The best places to find information about Pd's libraries
is:;
#X text 14 130 www.puredata.org and click on "Downloads" then "Software"
;
@@ -106,9 +106,9 @@ is:;
#X restore 432 569 pd related_objects_from_other_libraries;
#X obj 543 548 makenote;
#X obj 603 548 delwrite~;
-#X text 445 594 This document was updated for PD version 0.35 test
+#X text 445 594 This document was updated for Pd version 0.35 test
28 by Dave Sabine as part of a project called pddp proposed by Krzysztof
-Czaja to build comprehensive documentation for PD.;
+Czaja to build comprehensive documentation for Pd.;
#X floatatom 504 428 5 0 0;
#X text 546 421 low numbers will produce a very "dusty" output.;
#X text 546 433 high numbers will produce a slightly "dusty" output.
diff --git a/doc/pddp/help-float.pd b/doc/pddp/float-help.pd
index 10630895..bd04f8c5 100644
--- a/doc/pddp/help-float.pd
+++ b/doc/pddp/float-help.pd
@@ -45,14 +45,14 @@ object.;
#X text 249 384 lists;
#X text 106 355 creation argument;
#N canvas 58 0 401 250 Related_Objects 0;
-#X text 25 11 Native PD Objects;
+#X text 25 11 Native Pd Objects;
#X text 23 92 Externals and other object libraries;
#X obj 42 48 int;
#X obj 109 48 symbol;
#X text 36 126 [randomF];
#X restore 114 508 pd Related_Objects;
#N canvas 57 0 637 618 More_Info 0;
-#X text 43 24 All numbers in PD are kept in 32-bit floating point and
+#X text 43 24 All numbers in Pd are kept in 32-bit floating point and
can represent real numbers between -8 \, 388608 and 8.388.608.00;
#X text 11 78 WHAT IS A FLOATING POINT NUMBER?;
#X text 41 267 The following are examples of floating point numbers:
diff --git a/doc/pddp/glossary.pd b/doc/pddp/glossary.pd
new file mode 100644
index 00000000..e908f71a
--- /dev/null
+++ b/doc/pddp/glossary.pd
@@ -0,0 +1,14 @@
+#N canvas 38 95 466 565 10;
+#X obj 2 2 cnv 15 450 20 empty empty glossary 2 11 1 18 -233017 -66577
+0;
+#X obj 418 3 pddp;
+#X text 6 63 "atom";
+#X text 9 88 "bang";
+#X text 15 111 "float";
+#X text 11 223 "symbol";
+#X text 11 210 "selector";
+#X text 11 153 "list";
+#X text 8 45 "anything";
+#X text 11 190 "pointer";
+#X text 8 131 "inlet";
+#X text 12 171 "outlet";
diff --git a/doc/pddp/help-clip.pd b/doc/pddp/help-clip.pd
deleted file mode 100644
index 04f8ddb5..00000000
--- a/doc/pddp/help-clip.pd
+++ /dev/null
@@ -1,130 +0,0 @@
-#N canvas 3 0 630 628 12;
-#X obj 114 560 pddp;
-#X obj 8 3 cnv 15 90 578 empty empty empty 20 12 0 14 -233017 -66577
-0;
-#X text 38 36 INLETS:;
-#X text 38 51 - LEFT:;
-#X text 32 230 - RIGHT:;
-#X text 29 346 OUTLETS:;
-#X text 13 281 ARGUMENTS:;
-#X text 20 412 EXAMPLES:;
-#X text 20 508 SEE ALSO:;
-#N canvas 58 0 411 260 Related_Objects 0;
-#X text 25 11 Native PD Objects;
-#X text 23 92 Externals and other object libraries;
-#X obj 45 54 int;
-#X obj 85 53 f;
-#X obj 123 53 min;
-#X obj 166 53 max;
-#X obj 206 53 clip~;
-#X obj 260 53 min~;
-#X obj 308 53 max~;
-#X text 44 125 - none that I am aware of;
-#X restore 114 508 pd Related_Objects;
-#N canvas 57 0 639 620 More_Info 0;
-#X text 26 174 THE MYSTERIOUS RIGHT OUTLET;
-#X obj 158 252 clip;
-#X obj 82 240 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
--1;
-#X floatatom 130 203 5 0 0 0 - - -;
-#X symbolatom 195 204 10 0 0 0 - - -;
-#X msg 209 227 list dave peter john;
-#X msg 49 200 message;
-#X floatatom 199 281 5 0 0 0 - - -;
-#X obj 258 278 print;
-#X obj 174 283 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
--1;
-#X text 313 280 no response to any message or atom.;
-#X text 30 347 LOW AND HIGH VALUES;
-#X text 304 34 Consider the following:;
-#X floatatom 101 66 5 0 0 0 - - -;
-#X floatatom 83 147 5 0 0 0 - - -;
-#X obj 83 121 min 50;
-#X obj 83 95 max -50;
-#X text 170 106 same as;
-#X obj 271 104 clip -50 50;
-#X floatatom 271 133 5 0 0 0 - - -;
-#X text 43 18 [clip] is a tool which combines the functionality of
-[min] and [max] into a single object.;
-#X text 46 368 [clip] always assumes that the first argument (second
-inlet) is the low extreme of the range and the second argument (third
-inlet) is the high extreme. However \, strange behaviour should be
-expected if you mix these arguments up.;
-#X obj 54 491 clip -50 50;
-#X obj 180 485 clip 72 -104;
-#X floatatom 54 458 5 0 0 0 - - -;
-#X floatatom 54 520 5 0 0 0 - - -;
-#X floatatom 180 517 5 0 0 0 - - -;
-#X text 50 306 I assume it is there for a reason...but I don't know
-that reason. It might exist for compatiblity with MAX?;
-#X text 185 444 Numbers below 72 are clipped to 72;
-#X text 185 464 Numbers above -104 are clipped to -104;
-#X text 172 565 This could be used effectively to toggle between two
-numbers.;
-#X floatatom 391 543 5 0 0 0 - - -;
-#X obj 360 520 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0
-1;
-#X obj 392 512 clip 1 -1024;
-#X connect 1 1 7 0;
-#X connect 1 1 8 0;
-#X connect 1 1 9 0;
-#X connect 2 0 1 0;
-#X connect 3 0 1 0;
-#X connect 4 0 1 0;
-#X connect 5 0 1 0;
-#X connect 6 0 1 0;
-#X connect 13 0 16 0;
-#X connect 13 0 18 0;
-#X connect 15 0 14 0;
-#X connect 16 0 15 0;
-#X connect 18 0 19 0;
-#X connect 22 0 25 0;
-#X connect 23 0 26 0;
-#X connect 24 0 22 0;
-#X connect 24 0 23 0;
-#X connect 32 0 33 0;
-#X connect 33 0 31 0;
-#X restore 114 534 pd More_Info;
-#X obj 57 11 clip;
-#X text 105 51 Float - A float at the left inlet will be clipped to
-the low and high values stored in the object.;
-#X text 105 82 List - A list at the left inlet will be truncated to
-include only the first three elements. The first element in the list
-is the number which will be clipped. The second element will update
-the value stored at the second inlet. The third element will update
-the value stored at the third inlet.;
-#X text 25 180 - CENTER:;
-#X text 105 180 Float - A float at the second inlet is stored for later
-use. It will be used as either the low or high value at which to clip
-incoming floats at that left inlet.;
-#X text 105 231 Float - A float at the third inlet is stored for later
-use. It will be used as either the low or high value at which to clip
-incoming floats at that left inlet.;
-#X text 104 281 Two - [float] accepts two floats as creation arguments
-which initializes the first values to be stored in the object and duplicate
-the functions of the second and third inlet.;
-#X text 102 346 One - outputs a float which is limited to a range within
-the high and low values of the second and third inlet. (The second
-outlet has no apparent purpose other than cross-compatibility with
-MAX.);
-#X text 108 12 - FORCE A NUMBER INTO A RANGE;
-#X obj 122 448 clip -50 50;
-#X floatatom 122 475 5 0 0 0 - - -;
-#X floatatom 122 424 5 0 0 0 - - -;
-#X text 181 425 creation arguments;
-#X obj 411 486 clip;
-#X floatatom 404 458 5 0 0 0 - - -;
-#X floatatom 460 457 5 0 0 0 - - -;
-#X floatatom 520 457 5 0 0 0 - - -;
-#X floatatom 411 512 5 0 0 0 - - -;
-#X text 464 488 no arguments;
-#X text 494 425 list;
-#X text 158 561 - Dave Sabine \, April 25 \, 2003;
-#X msg 383 425 42 100 500;
-#X connect 20 0 21 0;
-#X connect 22 0 20 0;
-#X connect 24 0 28 0;
-#X connect 25 0 24 0;
-#X connect 26 0 24 1;
-#X connect 27 0 24 2;
-#X connect 32 0 24 0;
diff --git a/doc/pddp/help-int.pd b/doc/pddp/int-help.pd
index 4fa30b74..4d9ec1a8 100644
--- a/doc/pddp/help-int.pd
+++ b/doc/pddp/int-help.pd
@@ -13,9 +13,9 @@
-1;
#X obj 450 547 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
-1;
-#X text 284 568 This document was updated for PD version 0.35 test
+#X text 284 568 This document was updated for Pd version 0.35 test
24 by Dave Sabine as part of a project called pddp proposed by Krzysztof
-Czaja to build comprehensive documentation for PD.;
+Czaja to build comprehensive documentation for Pd.;
#X text 482 480 RELATED OBJECTS;
#X obj 529 507 symbol;
#X text 97 11 - STORE AN INTEGER;
@@ -26,11 +26,11 @@ number when it receives a "bang" message or a new number in its left
inlet.;
#X text 18 98 This object acts exactly as its nearest cousin:;
#X obj 307 97 float;
-#X text 495 159 All numbers in PD are kept in 32-bit floating point
+#X text 495 159 All numbers in Pd are kept in 32-bit floating point
and can represent real numbers between -8 \, 388 \, 608 and 8 \, 388
\, 608 Hence \, the [int] object takes about as much CPU as the [float]
object \; but is useful when numbers need to be truncated and/or when
-patches are being designed to be compatible with PD and MAX/MSP.;
+patches are being designed to be compatible with Pd and MAX/MSP.;
#X text 18 160 Tip: Press and hold SHIFT while click-n-dragging these
number boxes to see how the [int] object truncates the number - drops
decimal places.;
@@ -51,17 +51,17 @@ contain fractions. The following are examples of whole numbers:;
#X obj 22 19 list2int;
#X obj 77 19 i2l;
#X obj 104 19 probalizer;
-#X text 20 56 These objects are offered in PD only if you have downloaded
+#X text 20 56 These objects are offered in Pd only if you have downloaded
and properly installed the appropriate library. These objects may or
may not exist in a single library.;
-#X text 19 105 The best places to find information about PD's libraries
+#X text 19 105 The best places to find information about Pd's libraries
is:;
#X text 16 127 www.puredata.org and click on "Downloads" then "Software"
;
#X text 18 157 iem.kug.ac.at/pdb/;
#X restore 490 529 pd related_objects_from_other_libraries;
#X text 496 283 The [int] object can be used as a basis for building
-simple counter mechanisms in PD. In the example below \, the [int]
+simple counter mechanisms in Pd. In the example below \, the [int]
object's stored value is incremented by 1 with each "bang".;
#X text 87 281 The creation argument initializes the object and stores
the number until the value is reset. The creation argument is optional.
diff --git a/doc/pddp/help-key.pd b/doc/pddp/key-help.pd
index ff0ae4fb..2d8cba9e 100644
--- a/doc/pddp/help-key.pd
+++ b/doc/pddp/key-help.pd
@@ -11,7 +11,7 @@
us with tools to capture 'user initiated' events from the operating
system. Keyboard input \, mouse clicks \, and mouse movements are the
most common events in this 'user event' category.;
-#X text 41 125 PD's [key] \, [keyup] \, and [keyname] are complimented
+#X text 41 125 Pd's [key] \, [keyup] \, and [keyname] are complimented
by the externals such as [gemmouse] and [nimouse] to provide us with
a full range of tools to gleen a user's activities at the computer.
;
@@ -21,7 +21,7 @@ for example has:;
#X text 55 272 onKeyUp;
#X text 55 253 onKeyDown;
#X text 55 291 onKeyPress;
-#X text 42 322 hmmm...wouldn't it be great if PD also gave us onChange
+#X text 42 322 hmmm...wouldn't it be great if Pd also gave us onChange
\, onBlur \, onFocus \, onClick \, onDblClick \, onDragDrop \, onLoad
\, onMouseDown \, onMouseOver \, onMouseOut \, onMouseMove \, onUnload...?
;
@@ -106,7 +106,7 @@ the name of the key.;
#X connect 17 0 14 0;
#X restore 107 491 pd More_Info;
#N canvas 85 22 397 246 Related_Objects 0;
-#X text 25 8 Native PD Objects;
+#X text 25 8 Native Pd Objects;
#X text 25 92 Externals and other object libraries;
#X obj 61 129 gemkeyboard;
#X obj 62 159 gemkeyname;
@@ -125,7 +125,7 @@ the name of the key.;
#X text 104 53 None;
#X text 104 94 Please see the following sub-patch called "More_Info"
for detailed information about the objects' outlets. The outlets of
-this 'object group' provide PD with information about keystrokes on
+this 'object group' provide Pd with information about keystrokes on
your computer's keyboard.;
#X obj 108 174 key;
#X floatatom 108 201 3 0 0 0 - - -;
diff --git a/doc/pddp/help-line.pd b/doc/pddp/line-help.pd
index 1fad6ccc..7a46344f 100644
--- a/doc/pddp/help-line.pd
+++ b/doc/pddp/line-help.pd
@@ -66,7 +66,7 @@ takes off from its current value.;
#X msg 49 172 0 5000;
#X text 18 23 CONTINUOUS RAMPS;
#X text 24 278 Due to this unique behavior \, a common construct found
-in PD patches includes the [pack] object as follows:;
+in Pd patches includes the [pack] object as follows:;
#X obj 38 399 line;
#X floatatom 38 420 10 0 0 0 - - -;
#X floatatom 38 313 5 0 0 0 - - -;
@@ -92,9 +92,9 @@ in PD patches includes the [pack] object as follows:;
#X text 507 194 stops the current ramp.;
#X text 428 316 More information about [line] can be found in the Pure
Documentation folder doc/3.audio.examples.;
-#X text 431 478 This document was updated for PD version 0.35 test
+#X text 431 478 This document was updated for Pd version 0.35 test
28 by Dave Sabine as part of a project called pddp proposed by Krzysztof
-Czaja to build comprehensive documentation for PD.;
+Czaja to build comprehensive documentation for Pd.;
#X text 423 354 RELATED OBJECTS;
#X obj 443 373 line~;
#N canvas 0 22 456 306 related_objects_from_other_libraries 0;
@@ -102,10 +102,10 @@ Czaja to build comprehensive documentation for PD.;
#X obj 105 20 t3_line~;
#X obj 171 20 fade~;
#X obj 219 21 step;
-#X text 17 54 These objects are offered in PD only if you have downloaded
+#X text 17 54 These objects are offered in Pd only if you have downloaded
and properly installed the appropriate library. These objects may or
may not exist in a single library.;
-#X text 16 103 The best places to find information about PD's libraries
+#X text 16 103 The best places to find information about Pd's libraries
is:;
#X text 13 125 www.puredata.org and click on "Downloads" then "Software"
;
diff --git a/doc/pddp/help-loadbang.pd b/doc/pddp/loadbang-help.pd
index e6509ed1..efed1e90 100644
--- a/doc/pddp/help-loadbang.pd
+++ b/doc/pddp/loadbang-help.pd
@@ -14,7 +14,7 @@
#X obj 8 8 cnv 15 90 553 empty empty empty 20 12 0 14 -233017 -66577
0;
#X obj 21 18 loadbang;
-#X text 104 464 PD Documentation Chapter 3.6 - doc/1.manual/x3.htm
+#X text 104 464 Pd Documentation Chapter 3.6 - doc/1.manual/x3.htm
;
#X text 104 53 The inlet is inactive and serves no purpose.;
#X text 104 81 This object does not accept arguments of any type.;
@@ -53,9 +53,9 @@ message below was immediately printed in the terminal window.;
#X text 14 438 Loadbangs are a useful tool to set initial values in
a patch - however \, there are times when it might be necessary to
debug a patch and "turn off" all the loadbang objects. This can be
-accomplished by opening PD with the -noloadbang flag.;
+accomplished by opening Pd with the -noloadbang flag.;
#X text 14 523 For example \, to suppress all loadbangs \, your command
-line might look something like this: (more info about PD's command
+line might look something like this: (more info about Pd's command
line can be found in Chapter 3.6 of the HTML documentation.;
#X msg 25 127 you have opened the [loadbang] help document;
#X connect 1 0 19 0;
@@ -78,7 +78,7 @@ line can be found in Chapter 3.6 of the HTML documentation.;
#X obj 102 51 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
-1;
#X obj 143 48 trigger;
-#X text 25 8 Native PD Objects;
+#X text 25 8 Native Pd Objects;
#X text 25 92 Externals and other object libraries;
#X text 36 126 [init];
#X restore 104 488 pd Related_Objects;
diff --git a/doc/pddp/help-makefilename.pd b/doc/pddp/makefilename-help.pd
index 5e9d12cd..7f12625d 100644
--- a/doc/pddp/help-makefilename.pd
+++ b/doc/pddp/makefilename-help.pd
@@ -2,7 +2,7 @@
#X obj 104 539 pddp;
#X obj 8 8 cnv 15 90 553 empty empty empty 20 12 0 14 -233017 -66577
0;
-#X text 104 463 PD Documentation Chapter 3.6 - doc/1.manual/x3.htm
+#X text 104 463 Pd Documentation Chapter 3.6 - doc/1.manual/x3.htm
;
#N canvas 523 37 597 612 More_Info 0;
#X text 17 24 COMMON USES;
@@ -107,8 +107,8 @@ which operates 24 hours per day \, every day.;
#X connect 36 0 25 0;
#X restore 47 445 pd spaces_and_multiple_variables;
#N canvas 175 22 507 609 help_with_interfaces 0;
-#X text 17 16 Building user interfaces in PD is a difficult balance
-between usability and performance. PD is not winning any awards for
+#X text 17 16 Building user interfaces in Pd is a difficult balance
+between usability and performance. Pd is not winning any awards for
usability - let's face it: it's powerful \, it's cool \, and that's
the way we like it. You're not here because you want a colourful \,
bevelled interface...you want the raw power that object oriented languages
@@ -190,7 +190,7 @@ ingenuity and compromise -- see below.;
#X connect 8 0 5 0;
#X restore 104 513 pd More_Info;
#N canvas 85 22 397 246 Related_Objects 0;
-#X text 25 8 Native PD Objects;
+#X text 25 8 Native Pd Objects;
#X text 25 92 Externals and other object libraries;
#X obj 42 46 symbol;
#X obj 112 46 int;
@@ -216,7 +216,7 @@ ingenuity and compromise -- see below.;
#X obj 353 380 symbol;
#X msg 353 343 dave;
#X msg 412 341 drums;
-#X msg 479 344 PD;
+#X msg 479 344 Pd;
#X msg 526 355 cool;
#X obj 353 404 makefilename %s_PD.aif;
#X text 107 198 This object generates symbols according to a format
diff --git a/doc/pddp/help-math.pd b/doc/pddp/math-help.pd
index 48edb0b4..2ff9b793 100644
--- a/doc/pddp/help-math.pd
+++ b/doc/pddp/math-help.pd
@@ -113,9 +113,9 @@ the left inlet is the base.;
#X obj 18 597 <;
#X text 41 597 Math/Binary operators;
#X obj 84 557 expr;
-#X text 420 563 This document was updated for PD version 0.35 test
+#X text 420 563 This document was updated for Pd version 0.35 test
28 by Dave Sabine as part of a project called pddp proposed by Krzysztof
-Czaja to build comprehensive documentation for PD.;
+Czaja to build comprehensive documentation for Pd.;
#X connect 0 0 25 0;
#X connect 2 0 24 0;
#X connect 7 0 20 0;
diff --git a/doc/pddp/help-metro.pd b/doc/pddp/metro-help.pd
index ddb1a841..a6ec7ec6 100644
--- a/doc/pddp/help-metro.pd
+++ b/doc/pddp/metro-help.pd
@@ -28,10 +28,10 @@ creation argument.;
#X obj 35 27 metroplus;
#X obj 102 27 t3_metro;
#X obj 164 27 pulse;
-#X text 18 56 These objects are offered in PD only if you have downloaded
+#X text 18 56 These objects are offered in Pd only if you have downloaded
and properly installed the appropriate library. These objects may or
may not exist in a single library.;
-#X text 17 105 The best places to find information about PD's libraries
+#X text 17 105 The best places to find information about Pd's libraries
is:;
#X text 14 127 www.puredata.org and click on "Downloads" then "Software"
;
@@ -39,9 +39,9 @@ is:;
#X text 16 157 iem.kug.ac.at/pdb/;
#X obj 210 25 exciter;
#X restore 23 372 pd related_objects_from_other_libraries;
-#X text 18 402 This document was updated for PD version 0.35 test 28
+#X text 18 402 This document was updated for Pd version 0.35 test 28
by Dave Sabine as part of a project called pddp proposed to build comprehensive
-documentation for PD.;
+documentation for Pd.;
#X connect 0 0 13 0;
#X connect 2 0 0 1;
#X connect 3 0 0 0;
diff --git a/doc/pddp/help-midi.pd b/doc/pddp/midi-help.pd
index a2d88092..893dcf16 100644
--- a/doc/pddp/help-midi.pd
+++ b/doc/pddp/midi-help.pd
@@ -73,7 +73,7 @@ updates.;
#X connect 8 0 6 0;
#X connect 9 0 8 0;
#X restore 40 433 pd window_controls;
-#X text 144 346 If you have installed PD into;
+#X text 144 346 If you have installed Pd into;
#X text 143 361 a unique location \, type the path;
#X text 144 377 here to your 5.reference folder;
#X text 141 394 and then save this patch.;
diff --git a/doc/pddp/help-moses.pd b/doc/pddp/moses-help.pd
index be5e8ad2..01e8a590 100644
--- a/doc/pddp/help-moses.pd
+++ b/doc/pddp/moses-help.pd
@@ -31,19 +31,19 @@ require a completely different structure \, as in the example below:
#X text 16 474 RELATED OBJECTS;
#N canvas 0 0 454 304 related_objects_from_other_libraries 0;
#X obj 34 29 split;
-#X text 18 86 These objects are offered in PD only if you have downloaded
+#X text 18 86 These objects are offered in Pd only if you have downloaded
and properly installed the appropriate library. These objects may or
may not exist in a single library.;
-#X text 17 135 The best places to find information about PD's libraries
+#X text 17 135 The best places to find information about Pd's libraries
is:;
#X text 14 157 www.puredata.org and click on "Downloads" then "Software"
;
#X text 15 173 or;
#X text 16 187 iem.kug.ac.at/pdb/;
#X restore 22 494 pd related_objects_from_other_libraries;
-#X text 18 530 This document was updated for PD version 0.35 test 26
+#X text 18 530 This document was updated for Pd version 0.35 test 26
by Dave Sabine as part of a project called pddp proposed by Krzysztof
-Czaja to build comprehensive documentation for PD.;
+Czaja to build comprehensive documentation for Pd.;
#X connect 0 0 3 0;
#X connect 0 1 4 0;
#X connect 1 0 0 0;
diff --git a/doc/pddp/help-notein.pd b/doc/pddp/notein-help.pd
index e727db7d..df189889 100644
--- a/doc/pddp/help-notein.pd
+++ b/doc/pddp/notein-help.pd
@@ -56,8 +56,8 @@ by Olaf Matthes);
#X text 11 41 The [notein] object reads incoming MIDI notes and reports
their note number \, velocity and channel number. Without the argument
it reads from all MIDI channels (omni).;
-#X obj 280 526 midi-basics;
-#X text 14 526 for an explanation of MIDI usage in PD see:;
+#X obj 280 526 pddp_open all_about_midi_flags;
+#X text 14 526 for an explanation of MIDI usage in Pd see:;
#X text 13 312 Arguments: the MIDI channel number from which to read
(with no argument it listens to all channels):;
#X text 80 13 - read incoming stream of MIDI notes.;
@@ -72,10 +72,10 @@ be sometimes misleading when tracking notes.;
#X text 103 462 velocity;
#X obj 44 416 notein 17;
#X text 107 415 notein listening only to channel 1 on port 2;
-#X text 13 582 This document was created for PD version 0.35 by Michal
+#X text 13 582 This document was created for Pd version 0.35 by Michal
Seta as part of a project called pddp proposed by Krzysztof Czaja \,
managed and edited by Dave Sabine \, to build comprehensive documentation
-for PD.;
+for Pd.;
#X connect 6 0 7 0;
#X connect 6 1 8 0;
#X connect 6 2 9 0;
diff --git a/doc/pddp/help-noteout.pd b/doc/pddp/noteout-help.pd
index 43636a3f..dea0ecf6 100644
--- a/doc/pddp/help-noteout.pd
+++ b/doc/pddp/noteout-help.pd
@@ -1,8 +1,8 @@
#N canvas 233 2 471 650 10;
#X obj 40 15 noteout;
#X obj 41 343 noteout;
-#X obj 287 506 midi-basics;
-#X text 18 505 for an explanation of MIDI usage in PD see:;
+#X obj 287 506 pddp_open all_about_midi_flags;
+#X text 18 505 for an explanation of MIDI usage in Pd see:;
#X text 13 43 The [noteout] objects writes a note-on MIDI message to
the output port.;
#X text 13 79 inlets:;
@@ -76,10 +76,10 @@ by Olaf Matthes);
#X text 41 402 an experimental MIDI sequencer;
#X restore 119 467 pd other_midi_objects;
#X text 93 15 - transmit MIDI notes;
-#X text 19 543 This document was updated for PD version 0.35 by Michal
+#X text 19 543 This document was updated for Pd version 0.35 by Michal
Seta as part of a project called pddp proposed by Krzysztof Czaja \,
managed and edited by Dave Sabine \, to build comprehensive documentation
-for PD.;
+for Pd.;
#X connect 20 0 1 0;
#X connect 23 0 22 0;
#X connect 24 0 27 0;
diff --git a/doc/pddp/help-operators.pd b/doc/pddp/operators-help.pd
index 6ff5ae0b..f64e8c53 100644
--- a/doc/pddp/help-operators.pd
+++ b/doc/pddp/operators-help.pd
@@ -2,7 +2,7 @@
#X obj 637 350 +~;
#X obj 641 499 trigger;
#X text 25 8 ARITHMETIC;
-#X text 30 29 PD's arithmetic objects include:;
+#X text 30 29 Pd's arithmetic objects include:;
#X obj 231 30 +;
#X obj 256 30 -;
#X obj 282 30 *;
@@ -152,7 +152,7 @@ a number with every number or "bang" that is sent to the left inlet.
#X obj 430 12 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
-1;
#X text 469 20 THE SUM OF MANY NUMBERS;
-#X text 473 40 PD has wonderful object called [expr] which allows you
+#X text 473 40 Pd has wonderful object called [expr] which allows you
to write mathematical expressions. I would suggest that you investigate
the [expr] object to process basic mathematical equations with more
than 2 separate values.;
@@ -242,10 +242,10 @@ example below: (i.e. a + b + c = d);
#X obj 323 27 divmod;
#X obj 324 47 minus;
#X obj 324 67 plus;
-#X text 29 104 These objects are offered in PD only if you have downloaded
+#X text 29 104 These objects are offered in Pd only if you have downloaded
and properly installed the appropriate library. These objects may or
may not exist in a single library.;
-#X text 28 153 The best places to find information about PD's libraries
+#X text 28 153 The best places to find information about Pd's libraries
is:;
#X text 25 175 www.puredata.org and click on "Downloads" then "Software"
;
@@ -258,9 +258,9 @@ is:;
#X obj 806 499 int;
#X obj 809 398 %;
#X obj 251 539 timer;
-#X text 292 584 This document was updated for PD version 0.35 test
+#X text 292 584 This document was updated for Pd version 0.35 test
28 by Dave Sabine as part of a project called pddp proposed by Krzysztof
-Czaja to build comprehensive documentation for PD.;
+Czaja to build comprehensive documentation for Pd.;
#X obj 754 449 pow;
#X connect 11 0 13 0;
#X connect 12 0 11 0;
diff --git a/doc/pddp/help-otherbinops.pd b/doc/pddp/otherbinops-help.pd
index e44a299e..6481cf15 100644
--- a/doc/pddp/help-otherbinops.pd
+++ b/doc/pddp/otherbinops-help.pd
@@ -43,7 +43,7 @@ oriented languages: C. They are "bitwise" operators which perform logical
and shift operations on 32-bit numbers.;
#X text 467 100 WHAT DOES "BITWISE" MEAN?;
#X text 478 208 Hence \, performing "bitwise" relational tests means
-that PD can compare "1101" to "1001" instead of operating with the
+that Pd can compare "1101" to "1001" instead of operating with the
integers that are represented by those binary codes.;
#N canvas 81 197 456 306 understanding_&_AND 0;
#X obj 33 216 &;
@@ -284,9 +284,9 @@ on the value that is already stored in the left inlet.;
#X floatatom 346 631 0 0 0 0 - - -;
#X obj 346 611 <;
#X text 138 631 Is a less than or equal to b?;
-#X text 464 583 This document was updated for PD version 0.35 test
+#X text 464 583 This document was updated for Pd version 0.35 test
29 by Dave Sabine as part of a project called pddp proposed by Krzysztof
-Czaja to build comprehensive documentation for PD.;
+Czaja to build comprehensive documentation for Pd.;
#X text 461 460 RELATED OBJECTS;
#X obj 853 477 +;
#X text 460 477 Visit the Help document for MATH for more math objects:
@@ -294,10 +294,10 @@ Czaja to build comprehensive documentation for PD.;
#N canvas 0 22 452 302 related_objects_from_other_libraries 0;
#X obj 47 34 strcomp;
#X text 102 33 Relational tests for strings.;
-#X text 29 104 These objects are offered in PD only if you have downloaded
+#X text 29 104 These objects are offered in Pd only if you have downloaded
and properly installed the appropriate library. These objects may or
may not exist in a single library.;
-#X text 28 153 The best places to find information about PD's libraries
+#X text 28 153 The best places to find information about Pd's libraries
is:;
#X text 25 175 www.puredata.org and click on "Downloads" then "Software"
;
diff --git a/doc/pddp/help-pack.pd b/doc/pddp/pack-help.pd
index 44a88b7b..ff1cc16c 100644
--- a/doc/pddp/help-pack.pd
+++ b/doc/pddp/pack-help.pd
@@ -96,19 +96,19 @@ object.;
#X obj 21 42 repack;
#X obj 70 42 drip;
#X obj 107 42 sort;
-#X text 18 86 These objects are offered in PD only if you have downloaded
+#X text 18 86 These objects are offered in Pd only if you have downloaded
and properly installed the appropriate library. These objects may or
may not exist in a single library.;
-#X text 17 135 The best places to find information about PD's libraries
+#X text 17 135 The best places to find information about Pd's libraries
is:;
#X text 14 157 www.puredata.org and click on "Downloads" then "Software"
;
#X text 15 173 or;
#X text 16 187 iem.kug.ac.at/pdb/;
#X restore 440 571 pd related_objects_from_other_libraries;
-#X text 443 601 This document was updated for PD version 0.35 test
+#X text 443 601 This document was updated for Pd version 0.35 test
26 by Dave Sabine as part of a project called pddp proposed by Krzysztof
-Czaja to build comprehensive documentation for PD.;
+Czaja to build comprehensive documentation for Pd.;
#X connect 2 0 3 0;
#X connect 3 0 23 0;
#X connect 5 0 24 0;
diff --git a/doc/pddp/pddp-style-guide.pd b/doc/pddp/pddp-style-guide.pd
index 219b5c23..1894db81 100644
--- a/doc/pddp/pddp-style-guide.pd
+++ b/doc/pddp/pddp-style-guide.pd
@@ -1,28 +1,33 @@
-#N canvas 196 180 459 553 10;
-#X text 15 38 Here are various text conventions for discussing various
-aspects of Pd in text:;
-#X text 30 108 "anything" \, "bang" \, "float" \, "list" \, "pointer"
-\, "symbol";
-#X text 15 138 objects:;
-#X text 30 157 [route] \, [set] \, [float] \, [symbol] \, [trigger]
-\, etc.;
-#X text 15 191 messages:;
-#X text 30 214 [send 1( \, [set 0( \,;
-#X text 15 270 design principles;
-#X text 50 300 - Make states visible and visibly distinguished;
-#X text 50 315 - Teach by example \, not by formalism;
-#X text 50 330 - Communicate visually;
-#X text 50 345 - Offer informative feedback;
-#X text 50 360 - Strive for consistency;
-#X text 50 375 - Avoid arbitrary syntax;
-#X text 50 390 - Use standard language;
-#X text 50 405 - Use the application's terminology;
-#X text 50 420 - Support clear conceptual models for documentation
+#N canvas 102 76 462 561 10;
+#X text 15 30 design principles;
+#X text 50 50 - Make states visible and visibly distinguished;
+#X text 50 65 - Teach by example \, not by formalism;
+#X text 50 80 - Communicate visually;
+#X text 50 95 - Offer informative feedback;
+#X text 50 110 - Strive for consistency;
+#X text 50 125 - Avoid arbitrary syntax;
+#X text 50 140 - Use standard language;
+#X text 50 155 - Use the application's terminology;
+#X text 50 170 - Support clear conceptual models for documentation
;
-#X text 50 435 - Respect the rules of human conversation;
-#X text 50 450 - Respond with an appropriate amount of information
+#X text 50 185 - Respect the rules of human conversation;
+#X text 50 200 - Respond with an appropriate amount of information
;
-#X text 17 88 reserved words:;
#X obj 2 2 cnv 15 450 20 empty empty pddp-style-guide 2 11 1 18 -233017
-66577 0;
#X obj 418 3 pddp;
+#X obj 14 529 pddp_open standard_gui_elements;
+#X text 15 230 Here are various text conventions for discussing various
+aspects of Pd in text:;
+#X text 30 300 "anything" \, "bang" \, "float" \, "list" \, "pointer"
+\, "symbol";
+#X text 15 330 objects:;
+#X text 30 349 [route] \, [set] \, [float] \, [symbol] \, [trigger]
+\, etc.;
+#X text 15 383 messages:;
+#X text 30 406 [send 1( \, [set 0( \,;
+#X text 17 280 reserved words:;
+#X text 15 441 Though an old term in the realm of the Max family of
+languages \, "abstraction" is a misleading term. Pd patches are either
+applications or objects. If a Pd patch is meant to be reused in other
+patches \, it is an object just like any other.;
diff --git a/doc/pddp/pddp.pd b/doc/pddp/pddp.pd
index 5f32d1e2..138aa6a7 100644
--- a/doc/pddp/pddp.pd
+++ b/doc/pddp/pddp.pd
@@ -1,34 +1,35 @@
-#N canvas 298 124 488 624 10;
-#X text 25 69 The PDDP was proposed initially in early 2002 by Krzysztof
+#N canvas 298 124 492 628 10;
+#X text 25 119 The PDDP was proposed initially in early 2002 by Krzysztof
Czaja who suggested that Pure Data was in need of comprehensive documentation.
;
-#X text 45 181 - Michal Seta;
-#X text 45 154 - Miller Puckette;
-#X text 45 167 - Dave Sabine;
-#X text 14 324 THINGS TO NOTE:;
-#X text 25 430 Externals and other Libraries: Each PDDP document includes
-mention of "related objects from other PD libraries" as well as mention
-of "related native PD objects". The objects from other libraries are
+#X text 45 231 - Michal Seta;
+#X text 45 204 - Miller Puckette;
+#X text 45 217 - Dave Sabine;
+#X text 14 374 THINGS TO NOTE:;
+#X text 25 480 Externals and other Libraries: Each PDDP document includes
+mention of "related objects from other Pd libraries" as well as mention
+of "related native Pd objects". The objects from other libraries are
available only if you download those libraries from their respective
-authors and integrate them properly into your version of PD. We do
+authors and integrate them properly into your version of Pd. We do
not and cannot maintain a complete list of externals - but we try.
For more info about externals and other objects \, see http://www.puredata.org/
and the Pure Data Base at http://iem.kug.ac.at/pdb/;
-#X text 45 195 - Hans-Christoph Steiner;
-#X text 25 265 All comments \, corrections \, etc. regarding the PDDP
+#X text 45 245 - Hans-Christoph Steiner;
+#X text 25 315 All comments \, corrections \, etc. regarding the PDDP
reference files should be directed to the Pd Developers' list: pd-dev@iem.at
;
-#X text 26 215 PDDP is now part of the CVS Pd distributions. It was
+#X text 26 265 PDDP is now part of the CVS Pd distributions. It was
originally available at Dave's web site: http://www.davesabine.com/media/puredata.asp
;
#X obj 3 2 cnv 15 450 20 empty empty PDDP 2 12 1 18 -233017 -66577
0;
#X text 102 5 Pure Data Documentation Project;
#X obj 25 38 pddp_open table_of_contents;
-#X text 25 342 Authors: If you would like to participate in this project
+#X text 25 392 Authors: If you would like to participate in this project
\, simply gather together information about objects \, tutorials \,
examples \, etc. and email pd-dev@iem.at for info about formatting
your documents. All documents should be committed to the CVS so that
they will be included in future releases.;
-#X text 25 118 The project was originally managed by Dave Sabine. The
+#X text 25 168 The project was originally managed by Dave Sabine. The
people involved in this project include (alphabetically):;
+#X obj 25 67 pddp_open glossary;
diff --git a/doc/pddp/pddp_open.pd b/doc/pddp/pddp_open.pd
index a0d93dba..c872aac5 100644
--- a/doc/pddp/pddp_open.pd
+++ b/doc/pddp/pddp_open.pd
@@ -4,7 +4,7 @@
#X obj 86 192 pack s s;
#X obj 86 137 symbol;
#X obj 108 111 t a b;
-#X obj 0 0 bng 18 250 50 0 \$0- \$0- empty 0 -6 0 8 -44926 -1 -1;
+#X obj 46 0 bng 18 250 50 0 \$0- \$0- empty 0 -6 0 8 -44926 -1 -1;
#X obj 0 61 symbol \$1;
#X obj 58 40 symbol;
#X text 313 346 released under the GNU GPL;
@@ -14,7 +14,7 @@
it;
#X text 20 287 This patch opens a patch either from the first argument
or sent in as a message.;
-#X obj 19 0 cnv 16 45 18 empty empty open: 6 9 0 14 -233017 -1 0;
+#X obj 0 0 cnv 16 45 18 empty empty open: 6 9 0 14 -233017 -1 0;
#X text 279 176 GOP: 168x18;
#X obj 137 166 getdir;
#X connect 0 0 4 0;
diff --git a/doc/pddp/help-pgmin.pd b/doc/pddp/pgmin-help.pd
index 71ebe3fb..6db8896d 100644
--- a/doc/pddp/help-pgmin.pd
+++ b/doc/pddp/pgmin-help.pd
@@ -53,15 +53,15 @@ by Olaf Matthes);
#X obj 16 411 xeq;
#X text 41 402 an experimental MIDI sequencer;
#X restore 105 333 pd other_midi_objects;
-#X obj 298 380 midi-basics;
-#X text 25 379 for an explanation of MIDI usage in PD see:;
+#X obj 298 380 pddp_open all_about_midi_flags;
+#X text 25 379 for an explanation of MIDI usage in Pd see:;
#X text 120 180 Left - program change number;
#X text 66 17 - read incoming program change messages from the MIDI
port;
-#X text 22 453 This document was updated for PD version 0.35 by Michal
+#X text 22 453 This document was updated for Pd version 0.35 by Michal
Seta as part of a project called pddp proposed by Krzysztof Czaja \,
managed and edited by Dave Sabine \, to build comprehensive documentation
-for PD.;
+for Pd.;
#X connect 4 0 5 0;
#X connect 4 1 6 0;
#X connect 11 0 12 0;
diff --git a/doc/pddp/help-pgmout.pd b/doc/pddp/pgmout-help.pd
index 1498584f..943d4c27 100644
--- a/doc/pddp/help-pgmout.pd
+++ b/doc/pddp/pgmout-help.pd
@@ -44,8 +44,8 @@ by Olaf Matthes);
#X obj 16 411 xeq;
#X text 41 402 an experimental MIDI sequencer;
#X restore 109 316 pd other_midi_objects;
-#X obj 295 354 midi-basics;
-#X text 25 353 for an explanation of MIDI usage in PD see:;
+#X obj 295 354 pddp_open all_about_midi_flags;
+#X text 25 353 for an explanation of MIDI usage in Pd see:;
#X text 92 166 Outlets: None. Sends directly to the MIDI port;
#X floatatom 25 205 5 0 0;
#X obj 31 316 pgmin;
@@ -57,10 +57,10 @@ will send on channel 1 by default.;
#X msg 238 204 2;
#X obj 193 233 pgmout;
#X text 70 12 - send program change messages to the MIDI port;
-#X text 23 393 This document was updated for PD version 0.35 by Michal
+#X text 23 393 This document was updated for Pd version 0.35 by Michal
Seta as part of a project called pddp proposed by Krzysztof Czaja \,
managed and edited by Dave Sabine \, to build comprehensive documentation
-for PD.;
+for Pd.;
#X connect 2 0 1 0;
#X connect 3 0 1 1;
#X connect 13 0 7 0;
diff --git a/doc/pddp/help-pipe.pd b/doc/pddp/pipe-help.pd
index de48c58d..5e527fcb 100644
--- a/doc/pddp/help-pipe.pd
+++ b/doc/pddp/pipe-help.pd
@@ -78,19 +78,19 @@ ensure that [pipe] receives the messages from right to left order.
#X text 432 518 RELATED OBJECTS;
#N canvas 0 0 454 304 related_objects_from_other_libraries 0;
#X obj 45 31 t3_delay;
-#X text 26 77 These objects are offered in PD only if you have downloaded
+#X text 26 77 These objects are offered in Pd only if you have downloaded
and properly installed the appropriate library. These objects may or
may not exist in a single library.;
-#X text 25 126 The best places to find information about PD's libraries
+#X text 25 126 The best places to find information about Pd's libraries
is:;
#X text 22 148 www.puredata.org and click on "Downloads" then "Software"
;
#X text 24 163 or;
#X text 24 178 iem.kug.ac.at/pdb/;
#X restore 437 561 pd related_objects_from_other_libraries;
-#X text 439 579 This document was updated for PD version 0.35 test
+#X text 439 579 This document was updated for Pd version 0.35 test
28 by Dave Sabine as part of a project called pddp proposed by Krzysztof
-Czaja to build comprehensive documentation for PD.;
+Czaja to build comprehensive documentation for Pd.;
#X connect 0 0 8 0;
#X connect 1 0 3 0;
#X connect 3 0 44 0;
diff --git a/doc/pddp/help-print.pd b/doc/pddp/print-help.pd
index b3d620d5..a6fc43a9 100644
--- a/doc/pddp/help-print.pd
+++ b/doc/pddp/print-help.pd
@@ -4,7 +4,7 @@
#X msg 60 173 234;
#X obj 21 10 print;
#X obj 19 208 print;
-#X text 20 44 The print object is used in PD to send messages to the
+#X text 20 44 The print object is used in Pd to send messages to the
'terminal window'. When the print object receives a message \, its
output will appear in the terminal window following the name of the
print object and a colon (:). If the print object does not have a name
@@ -31,11 +31,11 @@ terminal window as you click on these messages.;
#X text 17 408 To output the list as separate elements \, the list
needs to be unpacked first. Note that [unpack]'s outlets are triggered
from right to left. Like below:;
-#X text 28 481 The arguments here are used to tell PD what type of
+#X text 28 481 The arguments here are used to tell Pd what type of
atom to expect: (f = float \, s = symbol).;
-#X text 402 524 This document was updated for PD version 0.35 test
+#X text 402 524 This document was updated for Pd version 0.35 test
24 by Dave Sabine as part of a project called pddp proposed by Krzysztof
-Czaja to build comprehensive documentation for PD.;
+Czaja to build comprehensive documentation for Pd.;
#X connect 0 0 4 0;
#X connect 1 0 4 0;
#X connect 2 0 4 0;
diff --git a/doc/pddp/help-random.pd b/doc/pddp/random-help.pd
index 7b22f171..6f74d6f7 100644
--- a/doc/pddp/help-random.pd
+++ b/doc/pddp/random-help.pd
@@ -20,7 +20,7 @@ N-1 where N is the creation argument or the value of the right inlet.
which produces a pseudo-predictable sequence of numbers. Each [random]
object's equation is provided with a "seed" which is really just one
of the variables in the equation which produces the sequence. The "seed"
-is generated by PD based on specific parameters in each patch which
+is generated by Pd based on specific parameters in each patch which
contains a [random] object. If more than one [random] objects are contained
within a single patch \, they each get a different "seed".;
#X text 21 363 However \, "seeds" can be inputted into [random] by
@@ -139,19 +139,19 @@ like this:;
#X obj 149 47 pin~;
#X obj 25 47 randomblock~;
#X obj 109 47 utime;
-#X text 29 104 These objects are offered in PD only if you have downloaded
+#X text 29 104 These objects are offered in Pd only if you have downloaded
and properly installed the appropriate library. These objects may or
may not exist in a single library.;
-#X text 28 153 The best places to find information about PD's libraries
+#X text 28 153 The best places to find information about Pd's libraries
is:;
#X text 25 175 www.puredata.org and click on "Downloads" then "Software"
;
#X text 27 190 or;
#X text 27 205 iem.kug.ac.at/pdb/;
#X restore 408 494 pd related_objects_from_other_libraries;
-#X text 416 592 This document was updated for PD version 0.35 test
+#X text 416 592 This document was updated for Pd version 0.35 test
29 by Dave Sabine as part of a project called pddp proposed by Krzysztof
-Czaja to build comprehensive documentation for PD.;
+Czaja to build comprehensive documentation for Pd.;
#X connect 3 0 5 0;
#X connect 4 0 3 0;
#X connect 7 0 9 0;
diff --git a/doc/pddp/help-realtime.pd b/doc/pddp/realtime-help.pd
index 5794a087..7cbd0290 100644
--- a/doc/pddp/help-realtime.pd
+++ b/doc/pddp/realtime-help.pd
@@ -11,7 +11,7 @@
#X floatatom 108 585 0 0 0;
#X floatatom 175 573 0 0 0;
#X text 9 357 In the example below \, I've created an abstraction which
-will force each of PD's stop-watches \, [timer] [cputime] and [realtime]
+will force each of Pd's stop-watches \, [timer] [cputime] and [realtime]
to measure various processes and report the elapsed time. Click on
each [bng] to begin the process and wait for the results. Notice the
discrepancies in the results.;
@@ -22,7 +22,7 @@ discrepancies in the results.;
-1;
#X text 72 435 1 Measures elapsed time between two "bangs" from a [trigger]
object.;
-#X text 87 469 2 Measures the amount of time PD requires to turn on
+#X text 87 469 2 Measures the amount of time Pd requires to turn on
DSP and start an oscillator.;
#X obj 445 484 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
-1;
@@ -32,13 +32,13 @@ DSP and start an oscillator.;
#X text 475 59 In a fantasy world \, computers could exist somehow
beyond the restrictions of time and digital computation could be performed
in ZERO time. However \, that is not the case. Instead \, every process
-within PD and within your operating system requires at least a few
+within Pd and within your operating system requires at least a few
nanoseconds of your CPU's time.;
#X obj 111 509 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
-1;
#X text 476 144 The [timer] object is like a clock that is not constrained
to the regular laws of physics and the universal space-time continuum.
-It reports "time" measurements as only PD can see them!;
+It reports "time" measurements as only Pd can see them!;
#X text 477 204 The [cputime] object is like a clock that measures
how much time your CPU actually required to carry out your request.
Keep in mind however that your CPU is busy doing many things simoultaneously
@@ -46,35 +46,35 @@ Keep in mind however that your CPU is busy doing many things simoultaneously
CPU does not pay full attention to that process for the entire 5 minutes.
Instead \, it simply begins the process \, then refers back to that
process from time to time until the it is complete. In other cases
-\, your CPU might require a full 5 minutes while PD might report that
+\, your CPU might require a full 5 minutes while Pd might report that
merely a few milliseconds have passed. This type of discrepancy depends
heavily on your computer's hardware and the type of processing it is
performing.;
#X text 478 368 The [realtime] object is as much like your own wrist
-watch as PD can possibly manage. It measures time according to your
+watch as Pd can possibly manage. It measures time according to your
operating system's internal clock.;
#N canvas 0 0 454 304 related_objects_from_other_libraries 0;
-#X text 27 63 These objects are offered in PD only if you have downloaded
+#X text 27 63 These objects are offered in Pd only if you have downloaded
and properly installed the appropriate library. These objects may or
may not exist in a single library.;
-#X text 26 112 The best places to find information about PD's libraries
+#X text 26 112 The best places to find information about Pd's libraries
is:;
#X text 23 134 www.puredata.org and click on "Downloads" then "Software"
;
#X text 25 149 or;
#X text 25 164 iem.kug.ac.at/pdb/;
#X obj 44 24 t3_timer;
-#X text 469 589 This document was updated for PD version 0.35 test
+#X text 469 589 This document was updated for Pd version 0.35 test
26 by Dave Sabine as part of a project called pddp proposed by Krzysztof
-Czaja to build comprehensive documentation for PD.;
+Czaja to build comprehensive documentation for Pd.;
#X restore 505 476 pd related_objects_from_other_libraries;
-#X text 309 580 This document was updated for PD version 0.35 test
+#X text 309 580 This document was updated for Pd version 0.35 test
28 by Dave Sabine as part of a project called pddp proposed by Krzysztof
-Czaja to build comprehensive documentation for PD.;
+Czaja to build comprehensive documentation for Pd.;
#X obj 607 445 metro;
#X text 504 422 RELATED OBJECTS;
#X obj 504 446 cputime;
-#X text 132 501 3 Measures the amount of time PD requires count to
+#X text 132 501 3 Measures the amount of time Pd requires count to
three...please wait for approximately 3 seconds.;
#X obj 25 15 realtime;
#X text 83 15 -- ask Operating System for elasped real time;
@@ -92,7 +92,7 @@ is that a stop-watch can be stopped! [realtime] can only be started
or reset. It cannot be stopped.;
#X text 9 282 As stated above \, [realtime] measures "real" or actual
time. This value may be slightly different that CPU time or "logical"
-time. PD offers two objects which measure CPU time and "logical" time.
+time. Pd offers two objects which measure CPU time and "logical" time.
See the reference documents for those objects for more information.
;
#X obj 562 445 timer;
diff --git a/doc/pddp/help-receive.pd b/doc/pddp/receive-help.pd
index 182960ac..be391976 100644
--- a/doc/pddp/help-receive.pd
+++ b/doc/pddp/receive-help.pd
@@ -8,7 +8,7 @@
#X text 19 213 EXAMPLES:;
#X text 23 369 SEE ALSO:;
#N canvas 109 3 415 264 Related_Objects 0;
-#X text 25 11 Native PD Objects;
+#X text 25 11 Native Pd Objects;
#X text 22 148 Externals and other object libraries;
#X obj 25 53 receive~;
#X obj 109 54 send~;
@@ -32,8 +32,8 @@
#N canvas 57 0 649 630 More_Info 0;
#X obj 44 576 pddp_open all_about_send_n_receive;
#X text 25 18 MESSAGES AND DATA TYPES;
-#X text 40 41 PD's [send] and [receive] objects can communicate any
-data type that is supported by PD: floats \, anythings \, lists \,
+#X text 40 41 Pd's [send] and [receive] objects can communicate any
+data type that is supported by Pd: floats \, anythings \, lists \,
symbols \, and bangs. However \, you will need to plan ahead in your
patch to ensure that a symbol doesn't accidently arrive at a [float]
object \, or that a list doesn't arrive at a [symbol] object. Consider
@@ -118,7 +118,7 @@ to a [send] object of that name.;
#X text 109 18 - RECEIVE MESSAGES WITHOUT PATCH CORDS - abbreviation:
;
#X text 104 45 None. Data can be inputted to the [receive] object using
-the [send] object or by creating a PD 'send' command in a message box.
+the [send] object or by creating a Pd 'send' command in a message box.
The [receive] object accepts any atom type as input.;
#X floatatom 442 235 5 0 0 0 - - -;
#X msg 442 258 \; dave \$1;
diff --git a/doc/pddp/help-route.pd b/doc/pddp/route-help.pd
index cc689a66..bb87e568 100644
--- a/doc/pddp/help-route.pd
+++ b/doc/pddp/route-help.pd
@@ -1,4 +1,4 @@
-#N canvas 209 40 1015 653 10;
+#N canvas 103 43 1019 657 10;
#X obj 7 331 print x1;
#X obj 69 331 print x2;
#X obj 131 331 print x3;
@@ -13,8 +13,8 @@
#X text 8 217 numeric arguments:;
#X text 16 356 symbolic arguments:;
#X msg 590 287 bang;
-#X msg 621 405 list;
-#X msg 622 438 list 5;
+#X msg 621 380 list;
+#X msg 622 413 list 5;
#X msg 593 307 symbol pie;
#X msg 596 327 pie;
#X msg 584 248 1 2 3;
@@ -50,7 +50,7 @@ the second outlet \, symbols through the third outlet \, bangs through
the fourth outlet. The fifth outlet will then output anything that
does not match one of the previously defined data types (i.e. the "pie"
message below is a text message that hasn't been defined as a 'symbol'
-- hence \, PD cannot determine which data type it is and it will be
+- hence \, Pd cannot determine which data type it is and it will be
output through the right-most outlet).;
#X text 608 208 a float;
#X text 632 247 a list (of floats);
@@ -58,25 +58,25 @@ output through the right-most outlet).;
#X text 672 307 a symbol;
#X text 630 328 none of the above!;
#X text 702 268 a list of symbols;
-#X text 599 374 SPECIAL CASES OF LISTS.;
+#X text 599 349 SPECIAL CASES OF LISTS.;
#X text 18 563 RELATED OBJECTS;
#X obj 22 584 select;
#X obj 67 584 trigger;
#X obj 119 584 moses;
-#X text 378 588 This document was updated for PD version 0.35 test
+#X text 588 603 This document was updated for Pd version 0.35 test
26 by Dave Sabine as part of a project called pddp proposed by Krzysztof
-Czaja to build comprehensive documentation for PD.;
+Czaja to build comprehensive documentation for Pd.;
#X text 26 36 Route checks the first element of a message against each
of its creation arguments \, which may be numbers or symbols (but not
a mixture of the two unless the data types are defined explicitly)
\, then sends the messages through the appropriate outlets.;
-#N canvas 0 22 458 308 related_objects_from_other_libraries 0;
+#N canvas 0 22 466 316 related_objects_from_other_libraries 0;
#X obj 26 33 segregate;
#X obj 104 34 multiselect;
-#X text 18 86 These objects are offered in PD only if you have downloaded
+#X text 18 86 These objects are offered in Pd only if you have downloaded
and properly installed the appropriate library. These objects may or
may not exist in a single library.;
-#X text 17 135 The best places to find information about PD's libraries
+#X text 17 135 The best places to find information about Pd's libraries
is:;
#X text 14 157 www.pure-data.org and click on "Downloads" then "Software"
;
@@ -85,28 +85,28 @@ is:;
#X obj 193 34 demux;
#X obj 245 34 gate;
#X restore 22 607 pd related_objects_from_other_libraries;
-#X floatatom 625 526 5 0 0 0 - - -;
-#X symbolatom 673 525 10 0 0 0 - - -;
-#X obj 578 549 bng 15 250 50 0 empty empty bang -6 23 1 12 -262144
+#X floatatom 625 498 5 0 0 0 - - -;
+#X symbolatom 673 497 10 0 0 0 - - -;
+#X obj 578 518 bng 15 250 50 0 empty empty bang -6 23 1 12 -262144
-1 -1;
-#X msg 622 475 list not-a-list;
+#X msg 622 450 list not-a-list;
#X msg 578 208 89;
#X msg 581 228 float 7;
-#X obj 578 499 route bang float symbol list;
-#X obj 625 549 bng 15 250 50 0 empty empty float -4 23 1 12 -262144
+#X obj 578 474 route bang float symbol list;
+#X obj 625 518 bng 15 250 50 0 empty empty float -4 23 1 12 -262144
-1 -1;
-#X obj 673 549 bng 15 250 50 0 empty empty symbol -12 23 1 12 -262144
+#X obj 673 518 bng 15 250 50 0 empty empty symbol -12 23 1 12 -262144
-1 -1;
-#X obj 721 549 bng 15 250 50 0 empty empty list -2 23 1 12 -262144
+#X obj 721 518 bng 15 250 50 0 empty empty list -2 23 1 12 -262144
-1 -1;
-#X obj 769 549 bng 15 250 50 0 empty empty undefined -18 23 1 12 -262144
+#X obj 769 518 bng 15 250 50 0 empty empty undefined -18 23 1 12 -262144
-1 -1;
#X msg 587 268 list moon earth;
#X text 636 228 definitely a float!;
-#X text 620 391 An empty list is translated into a bang;
-#X text 620 424 A list with only one float is translated to a float
+#X text 620 366 An empty list is translated into a bang;
+#X text 620 399 A list with only one float is translated to a float
;
-#X text 620 460 A list with only one symbol is translated to a symbol
+#X text 620 435 A list with only one symbol is translated to a symbol
;
#X obj 141 439 bng 15 250 50 0 empty empty big -4 23 1 12 -262144 -1
-1;
@@ -125,6 +125,10 @@ is:;
#X obj 129 469 print x1;
#X obj 189 469 print x2;
#X obj 249 469 print x3;
+#X text 526 557 [trigger]-style shortcuts don't work:;
+#X obj 538 577 route a b f l p s;
+#X text 667 576 !=;
+#X obj 689 577 route anything bang float list pointer symbol;
#X connect 4 0 0 0;
#X connect 4 1 1 0;
#X connect 4 2 2 0;
diff --git a/doc/pddp/help-select.pd b/doc/pddp/select-help.pd
index acc8943c..1ac90d9e 100644
--- a/doc/pddp/help-select.pd
+++ b/doc/pddp/select-help.pd
@@ -99,15 +99,15 @@ object cannot successfully match it to the creation argument.;
#X floatatom 54 392 5 0 0 0 - - -;
#X floatatom 31 349 5 0 0 0 - - -;
#X floatatom 80 351 5 0 0 0 - - -;
-#X text 325 686 This document was updated for PD version 0.35 test
+#X text 325 686 This document was updated for Pd version 0.35 test
24 by Dave Sabine as part of a project called pddp proposed by Krzysztof
-Czaja to build comprehensive documentation for PD.;
+Czaja to build comprehensive documentation for Pd.;
#X obj 514 639 route;
#X text 513 618 RELATED OBJECTS;
#X text 22 614 A WORD ABOUT CONDITIONAL OBJECTS;
#N canvas 245 41 580 582 more 0;
#X text 22 16 Using the [select] object \, and others listed below
-\, PD users can emulate the "conditional" statements of other programming
+\, Pd users can emulate the "conditional" statements of other programming
environments.;
#X text 21 62 Consider the following: (Visual Basic Script);
#X text 60 80 IF input = 1 THEN;
@@ -117,7 +117,7 @@ environments.;
#X text 59 130 ELSEIF (input = 3 AND input < 10) THEN;
#X text 59 153 ELSE;
#X text 58 177 END IF;
-#X text 23 195 Now the PD equivalent:;
+#X text 23 195 Now the Pd equivalent:;
#X msg 37 218 1;
#X msg 67 218 2;
#X floatatom 123 221 5 0 0 0 - - -;
@@ -131,7 +131,7 @@ environments.;
#X obj 114 505 <;
#X obj 141 505 >=;
#X obj 168 505 <=;
-#X text 28 482 OTHER CONDITIONAL/RELATIONAL OBJECTS IN PD;
+#X text 28 482 OTHER CONDITIONAL/RELATIONAL OBJECTS IN Pd;
#X text 58 164 response.write("No_match_for_me..."& input);
#X text 59 142 response.write("This_is_cool.");
#X obj 74 309 moses 3;
@@ -154,10 +154,10 @@ environments.;
#X restore 24 632 pd more;
#N canvas 0 22 456 306 related_objects_from_other_libraries 0;
#X obj 28 15 multiselect;
-#X text 19 53 These objects are offered in PD only if you have downloaded
+#X text 19 53 These objects are offered in Pd only if you have downloaded
and properly installed the appropriate library. These objects may or
may not exist in a single library.;
-#X text 18 102 The best places to find information about PD's libraries
+#X text 18 102 The best places to find information about Pd's libraries
is:;
#X text 15 124 www.puredata.org and click on "Downloads" then "Software"
;
diff --git a/doc/pddp/help-send.pd b/doc/pddp/send-help.pd
index 9f4c816f..7508db41 100644
--- a/doc/pddp/help-send.pd
+++ b/doc/pddp/send-help.pd
@@ -8,7 +8,7 @@
#X text 19 213 EXAMPLES:;
#X text 23 369 SEE ALSO:;
#N canvas 109 3 419 268 Related_Objects 0;
-#X text 25 11 Native PD Objects;
+#X text 25 11 Native Pd Objects;
#X text 22 148 Externals and other object libraries;
#X obj 11 53 receive~;
#X obj 95 54 send~;
@@ -66,7 +66,7 @@ some interesting functionality \, consider the following:;
#X text 143 384 In this example \, I have created a single routine
which acts as a 'dynamic' send object. The variable ($1) in this message
box is replaced by the incoming 'symbol'.;
-#X text 135 213 In this example \, the message box contains a PD command
+#X text 135 213 In this example \, the message box contains a Pd command
which effectively sends the value of the variable ($1) to either 'dave'
or 'hans'.;
#X connect 4 0 6 0;
@@ -100,7 +100,7 @@ or 'hans'.;
#X obj 446 306 r dave;
#X floatatom 220 310 5 0 0 0 - - -;
#X text 104 45 None. Data can be inputted to the [receive] object using
-the [send] object or by creating a PD 'send' command in a message box.
+the [send] object or by creating a Pd 'send' command in a message box.
The [receive] object accepts any atom type as input.;
#X obj 521 306 r hans;
#X obj 220 334 s hans;
diff --git a/doc/pddp/help-spigot.pd b/doc/pddp/spigot-help.pd
index f9965551..7f912580 100644
--- a/doc/pddp/help-spigot.pd
+++ b/doc/pddp/spigot-help.pd
@@ -10,10 +10,10 @@
#X text 51 160 control: nonzero to pass messages \, zero to stop them
;
#X text 4 294 USING [SPIGOT] TO CREATE A GATE.;
-#X text 14 312 Unlike its closest cousin MAX \, PD does not have a
-native [gate] object. There are other PD libraries which include gates
+#X text 14 312 Unlike its closest cousin MAX \, Pd does not have a
+native [gate] object. There are other Pd libraries which include gates
for both audio and numerical data \, but similar routines can be built
-in PD using [spigot]. The example below shows a two-way gate using
+in Pd using [spigot]. The example below shows a two-way gate using
two [spigots] and the [expr] object.;
#X obj 87 505 spigot;
#X floatatom 88 459 1 0 0 0 - - -;
@@ -47,7 +47,7 @@ value of the incoming number.;
types which are accepted by this object are floats \, symbols \, lists
\, bangs \, anythings and pointers. However \, audio signals require
a completely different treatment.;
-#X text 444 285 PD does not have a [spigot] for audio signals \, but
+#X text 444 285 Pd does not have a [spigot] for audio signals \, but
the same effect can be created using the following structure:;
#X obj 458 332 osc~ 800;
#X obj 426 15 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
@@ -72,10 +72,10 @@ the same effect can be created using the following structure:;
#X text 446 518 RELATED OBJECTS;
#N canvas 0 22 454 304 related_objects_from_other_libraries 0;
#X obj 40 36 gate;
-#X text 18 86 These objects are offered in PD only if you have downloaded
+#X text 18 86 These objects are offered in Pd only if you have downloaded
and properly installed the appropriate library. These objects may or
may not exist in a single library.;
-#X text 17 135 The best places to find information about PD's libraries
+#X text 17 135 The best places to find information about Pd's libraries
is:;
#X text 14 157 www.puredata.org and click on "Downloads" then "Software"
;
diff --git a/doc/pddp/help-swap.pd b/doc/pddp/swap-help.pd
index 5b966254..a6b539ca 100644
--- a/doc/pddp/help-swap.pd
+++ b/doc/pddp/swap-help.pd
@@ -44,7 +44,7 @@ inlet.;
#X text 244 409 list;
#X text 428 510 creation argument;
#N canvas 59 0 397 246 Related_Objects 0;
-#X text 25 11 Native PD Objects;
+#X text 25 11 Native Pd Objects;
#X text 23 92 Externals and other object libraries;
#X obj 42 48 pack;
#X obj 104 48 unpack;
diff --git a/doc/pddp/help-symbol.pd b/doc/pddp/symbol-help.pd
index 93993aa1..2a21eb8e 100644
--- a/doc/pddp/help-symbol.pd
+++ b/doc/pddp/symbol-help.pd
@@ -1,7 +1,7 @@
#N canvas 353 86 570 640 10;
-#X text 31 576 This document was updated for PD version 0.35 test 24
+#X text 31 576 This document was updated for Pd version 0.35 test 24
by Dave Sabine as part of a project called pddp proposed by Krzysztof
-Czaja to build comprehensive documentation for PD.;
+Czaja to build comprehensive documentation for Pd.;
#X obj 55 12 symbol;
#X obj 28 259 symbol;
#X msg 28 112 bang;
@@ -43,14 +43,14 @@ the appropriate data type.;
#X obj 118 28 index;
#X obj 16 27 ftos;
#X obj 52 27 unsymbol;
-#X text 10 129 The best places to find information about PD's libraries
+#X text 10 129 The best places to find information about Pd's libraries
is:;
#X text 13 159 www.puredata.org and click on "Downloads" then "Software"
;
#X text 14 172 or;
#X text 15 186 iem.kug.ac.at/pdb/;
#X obj 243 28 lister;
-#X text 17 58 These objects are offered in PD only if you have downloaded
+#X text 17 58 These objects are offered in Pd only if you have downloaded
and properly installed the appropriate library. These objects may or
may not exist in a single library. These objects usually included in
the installers.;
diff --git a/doc/pddp/table_of_contents.pd b/doc/pddp/table_of_contents.pd
index c7994654..6372f94b 100644
--- a/doc/pddp/table_of_contents.pd
+++ b/doc/pddp/table_of_contents.pd
@@ -1,4 +1,4 @@
-#N canvas 282 141 518 637 10;
+#N canvas 282 141 522 641 10;
#X obj 3 2 cnv 15 500 20 empty empty pddp 2 12 1 18 -233017 -66577
0;
#X obj 9 572 pddp_open;
@@ -19,7 +19,6 @@
#X msg 10 490 dynamic_sends;
#X msg 10 520 time_measurements;
#X text 170 121 comment;
-#X text 170 141 comment;
#X text 170 181 comment;
#X text 170 321 comment;
#X text 170 341 comment;
@@ -53,21 +52,22 @@
#X text 22 35 TABLE OF CONTENTS;
#X text 7 56 pddp provides a number of overview patches called "all_about_"
patches. Here is a listing of them:;
-#X connect 2 0 24 0;
-#X connect 3 0 24 0;
-#X connect 4 0 24 0;
-#X connect 5 0 24 0;
-#X connect 6 0 24 0;
-#X connect 7 0 24 0;
-#X connect 8 0 24 0;
-#X connect 9 0 24 0;
-#X connect 10 0 24 0;
-#X connect 11 0 24 0;
-#X connect 12 0 24 0;
-#X connect 13 0 24 0;
-#X connect 14 0 24 0;
+#X text 170 141 cyclone is the Max/MSP compatibility library;
+#X connect 2 0 23 0;
+#X connect 3 0 23 0;
+#X connect 4 0 23 0;
+#X connect 5 0 23 0;
+#X connect 6 0 23 0;
+#X connect 7 0 23 0;
+#X connect 8 0 23 0;
+#X connect 9 0 23 0;
+#X connect 10 0 23 0;
+#X connect 11 0 23 0;
+#X connect 12 0 23 0;
+#X connect 13 0 23 0;
+#X connect 14 0 23 0;
#X connect 15 0 1 0;
#X connect 16 0 1 0;
#X connect 17 0 1 0;
-#X connect 24 0 1 0;
-#X connect 30 0 24 0;
+#X connect 23 0 1 0;
+#X connect 29 0 23 0;
diff --git a/doc/pddp/help-tabread.pd b/doc/pddp/tabread-help.pd
index 27ce6847..9107fbda 100644
--- a/doc/pddp/help-tabread.pd
+++ b/doc/pddp/tabread-help.pd
@@ -6,7 +6,7 @@
#X text 19 323 EXAMPLES:;
#X text 22 471 SEE ALSO:;
#N canvas 58 0 405 254 Related_Objects 0;
-#X text 25 11 Native PD Objects;
+#X text 25 11 Native Pd Objects;
#X text 16 166 Externals and other object libraries;
#X obj 16 41 tabread~;
#X obj 90 41 tabread4;
@@ -35,9 +35,9 @@ A GRAPH AND A TEMPLATE AND A LIST AND A SCALAR AND A WIDGET?;
#X text 43 56 That question isn't relevant yet \, but I know you're
probably asking it. Let's just set aside these terms and their uses
and say the following:;
-#X text 67 114 1 In PD \, the terms "graph" and "table" are almost
+#X text 67 114 1 In Pd \, the terms "graph" and "table" are almost
synonymous.;
-#X text 66 164 2 A table in PD is a convenient place to store an array.
+#X text 66 164 2 A table in Pd is a convenient place to store an array.
;
#X text 65 392 5 For more discussion about arrays and tables \, please
see the help documentation in: doc/2.control.examples/15.arrays.pd
@@ -67,7 +67,7 @@ to the index you query using the inlet.;
from dynamic sources. You can change the source at any time using the
"set" message.;
#X text 105 223 One - the argument informs [tabread] which array to
-read. The array must exist in an open PD patch/canvas or an error message
+read. The array must exist in an open Pd patch/canvas or an error message
will appear in the terminal window.;
#X text 29 278 OUTLETS:;
#X text 410 433 tables which store \; arrays of the same name.;
diff --git a/doc/pddp/help-tabread4.pd b/doc/pddp/tabread4-help.pd
index a2f2fcef..e6a3cd51 100644
--- a/doc/pddp/help-tabread4.pd
+++ b/doc/pddp/tabread4-help.pd
@@ -6,7 +6,7 @@
#X text 19 323 EXAMPLES:;
#X text 22 471 SEE ALSO:;
#N canvas 58 0 407 256 Related_Objects 0;
-#X text 25 11 Native PD Objects;
+#X text 25 11 Native Pd Objects;
#X text 16 166 Externals and other object libraries;
#X obj 16 41 tabread~;
#X obj 165 41 tabwrite;
@@ -56,7 +56,7 @@ represent the path a ball travels after a pitch. Using 4-point interpolation
curve ball.;
#X text 35 419 There are different formulas used to interpolate arrays.
Each method has a sort of niche where it is most comfortable and most
-effective. PD \, like most contemporary audio software \, uses 4-point
+effective. Pd \, like most contemporary audio software \, uses 4-point
interpolation which is also known as "Hermite" interpolation. It is
the most "intelligent" 2-dimensional method of interpolation.;
#N canvas 167 0 570 613 What_does_it_really_do? 0;
@@ -119,7 +119,7 @@ in the arrays - otherwise [tabread] will always output "0".;
#X text 111 10 - READ NUMBERS FROM A TABLE WITH 4-POINT INTERPOLATION
;
#X text 105 213 One - the argument informs [tabread4] which array to
-read. The array must exist in an open PD patch/canvas or an error message
+read. The array must exist in an open Pd patch/canvas or an error message
will appear in the terminal window.;
#X text 104 265 One - outputs a floating point number representing
an interpolation of the array value corresponding to the location described
diff --git a/doc/pddp/help-tabwrite.pd b/doc/pddp/tabwrite-help.pd
index 2bb10c73..beaf8ef6 100644
--- a/doc/pddp/help-tabwrite.pd
+++ b/doc/pddp/tabwrite-help.pd
@@ -6,7 +6,7 @@
#X text 20 303 EXAMPLES:;
#X text 22 471 SEE ALSO:;
#N canvas 58 0 407 256 Related_Objects 0;
-#X text 25 11 Native PD Objects;
+#X text 25 11 Native Pd Objects;
#X text 16 166 Externals and other object libraries;
#X obj 16 41 tabread~;
#X obj 90 41 tabread4;
@@ -69,7 +69,7 @@ to dynamic locations. You can change the table at any time using the
#X text 104 203 Float - selects which index in which to write the new
value.;
#X text 105 223 One - the argument informs [tabwrite] which array to
-write to. The array must exist in an open PD patch/canvas or an error
+write to. The array must exist in an open Pd patch/canvas or an error
message will appear in the terminal window.;
#X text 104 277 None.;
#X obj 161 437 tabwrite davids_array;
diff --git a/doc/pddp/help-timer.pd b/doc/pddp/timer-help.pd
index af9ad7ce..5010abaa 100644
--- a/doc/pddp/help-timer.pd
+++ b/doc/pddp/timer-help.pd
@@ -27,7 +27,7 @@ reference documents for those objects for more information.;
#X floatatom 108 585 0 0 0;
#X floatatom 175 573 0 0 0;
#X text 11 358 In the example below \, I've created an abstraction
-which will force each of PD's stop-watches \, [timer] [cputime] and
+which will force each of Pd's stop-watches \, [timer] [cputime] and
[realtime] to measure various processes and report the elapsed time.
Click on each [bng] to begin the process and wait for the results.
Notice the discrepancies in the results.;
@@ -38,7 +38,7 @@ Notice the discrepancies in the results.;
-1;
#X text 72 435 1 Measures elapsed time between two "bangs" from a [trigger]
object.;
-#X text 87 469 2 Measures the amount of time PD requires to turn on
+#X text 87 469 2 Measures the amount of time Pd requires to turn on
DSP and start an oscillator.;
#X obj 445 484 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
-1;
@@ -48,13 +48,13 @@ DSP and start an oscillator.;
#X text 475 59 In a fantasy world \, computers could exist somehow
beyond the restrictions of time and digital computation could be performed
in ZERO time. However \, that is not the case. Instead \, every process
-within PD and within your operating system requires at least a few
+within Pd and within your operating system requires at least a few
nanoseconds of your CPU's time.;
#X obj 111 509 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
-1;
#X text 476 144 The [timer] object is like a clock that is not constrained
to the regular laws of physics and the universal space-time continuum.
-It reports "time" measurements as only PD can see them!;
+It reports "time" measurements as only Pd can see them!;
#X text 477 204 The [cputime] object is like a clock that measures
how much time your CPU actually required to carry out your request.
Keep in mind however that your CPU is busy doing many things simoultaneously
@@ -62,31 +62,31 @@ Keep in mind however that your CPU is busy doing many things simoultaneously
CPU does not pay full attention to that process for the entire 5 minutes.
Instead \, it simply begins the process \, then refers back to that
process from time to time until the it is complete. In other cases
-\, your CPU might require a full 5 minutes while PD might report that
+\, your CPU might require a full 5 minutes while Pd might report that
merely a few milliseconds have passed. This type of discrepancy depends
heavily on your computer's hardware and the type of processing it is
performing.;
#X text 478 368 The [realtime] object is as much like your own wrist
-watch as PD can possibly manage. It measures time according to your
+watch as Pd can possibly manage. It measures time according to your
operating system's internal clock.;
#N canvas 0 0 454 304 related_objects_from_other_libraries 0;
-#X text 27 63 These objects are offered in PD only if you have downloaded
+#X text 27 63 These objects are offered in Pd only if you have downloaded
and properly installed the appropriate library. These objects may or
may not exist in a single library.;
-#X text 26 112 The best places to find information about PD's libraries
+#X text 26 112 The best places to find information about Pd's libraries
is:;
#X text 23 134 www.puredata.org and click on "Downloads" then "Software"
;
#X text 25 149 or;
#X text 25 164 iem.kug.ac.at/pdb/;
#X obj 44 24 t3_timer;
-#X text 469 589 This document was updated for PD version 0.35 test
+#X text 469 589 This document was updated for Pd version 0.35 test
26 by Dave Sabine as part of a project called pddp proposed by Krzysztof
-Czaja to build comprehensive documentation for PD.;
+Czaja to build comprehensive documentation for Pd.;
#X restore 505 476 pd related_objects_from_other_libraries;
-#X text 309 580 This document was updated for PD version 0.35 test
+#X text 309 580 This document was updated for Pd version 0.35 test
28 by Dave Sabine as part of a project called pddp proposed by Krzysztof
-Czaja to build comprehensive documentation for PD.;
+Czaja to build comprehensive documentation for Pd.;
#X text 11 232 The odd aspect about comparing [timer] to a stop-watch
is that a stop-watch can be stopped! [timer] can only be started or
reset. It cannot be stopped.;
@@ -94,7 +94,7 @@ reset. It cannot be stopped.;
#X text 504 422 RELATED OBJECTS;
#X obj 504 446 cputime;
#X obj 562 445 realtime;
-#X text 132 501 3 Measures the amount of time PD requires count to
+#X text 132 501 3 Measures the amount of time Pd requires count to
three...please wait for approximately 3 seconds.;
#X connect 0 0 2 1;
#X connect 1 0 2 0;
diff --git a/doc/pddp/help-trigger.pd b/doc/pddp/trigger-help.pd
index 00f0780a..4f150485 100644
--- a/doc/pddp/help-trigger.pd
+++ b/doc/pddp/trigger-help.pd
@@ -62,7 +62,7 @@ to convert data types. For instance \, Visual Basic has:;
#X text 24 99 - isNumeric: to test whether the variable is a number.
;
#X text 22 113 - etc.;
-#X text 19 137 [trigger] is one object in PD which can convert an incoming
+#X text 19 137 [trigger] is one object in Pd which can convert an incoming
atom to a different type of atom.;
#X text 422 30 In the example below \, you can see that this [trigger]
has creation arguments which specify what data type the object should
@@ -161,9 +161,9 @@ to the terminal window.;
#X floatatom 902 164 5 0 0 0 - - -;
#X text 477 246 at the top-right to clearly see "logical time";
#X text 477 259 as measured by [timer].;
-#X text 509 554 This document was updated for PD version 0.35 test
+#X text 509 554 This document was updated for Pd version 0.35 test
26 by Dave Sabine as part of a project called pddp proposed by Krzysztof
-Czaja to build comprehensive documentation for PD.;
+Czaja to build comprehensive documentation for Pd.;
#X text 472 378 RELATED OBJECTS;
#X obj 557 404 route;
#X obj 477 404 unpack;
@@ -175,10 +175,10 @@ Czaja to build comprehensive documentation for PD.;
#X obj 744 404 symbol;
#N canvas 0 22 456 306 related_objects_from_other_libraries 0;
#X obj 31 36 exciter 200 200 8 0.1 1 1;
-#X text 26 77 These objects are offered in PD only if you have downloaded
+#X text 26 77 These objects are offered in Pd only if you have downloaded
and properly installed the appropriate library. These objects may or
may not exist in a single library.;
-#X text 25 126 The best places to find information about PD's libraries
+#X text 25 126 The best places to find information about Pd's libraries
is:;
#X text 22 148 www.puredata.org and click on "Downloads" then "Software"
;
diff --git a/doc/pddp/help-unpack.pd b/doc/pddp/unpack-help.pd
index 7b6ae36f..1bb88ae3 100644
--- a/doc/pddp/help-unpack.pd
+++ b/doc/pddp/unpack-help.pd
@@ -26,19 +26,19 @@ the symbol 'f') \, pointer (symbol 'p') or symbol (symbol 's').;
#X obj 21 42 repack;
#X obj 70 42 drip;
#X obj 107 42 sort;
-#X text 18 86 These objects are offered in PD only if you have downloaded
+#X text 18 86 These objects are offered in Pd only if you have downloaded
and properly installed the appropriate library. These objects may or
may not exist in a single library.;
-#X text 17 135 The best places to find information about PD's libraries
+#X text 17 135 The best places to find information about Pd's libraries
is:;
#X text 14 157 www.puredata.org and click on "Downloads" then "Software"
;
#X text 15 173 or;
#X text 16 187 iem.kug.ac.at/pdb/;
#X restore 24 333 pd related_objects_from_other_libraries;
-#X text 27 363 This document was updated for PD version 0.35 test 26
+#X text 27 363 This document was updated for Pd version 0.35 test 26
by Dave Sabine as part of a project called pddp proposed by Krzysztof
-Czaja to build comprehensive documentation for PD.;
+Czaja to build comprehensive documentation for Pd.;
#X connect 6 0 12 0;
#X connect 7 0 12 0;
#X connect 8 0 12 0;
diff --git a/doc/pddp/help-until.pd b/doc/pddp/until-help.pd
index 26c96c89..59d8652a 100644
--- a/doc/pddp/help-until.pd
+++ b/doc/pddp/until-help.pd
@@ -7,15 +7,15 @@ For example in Visual Basic:;
#X text 18 159 i = i + 1;
#X text 19 130 i = 0;
#X text 18 174 LOOP;
-#X text 3 285 And now PD's version of the above programming structures:
+#X text 3 285 And now Pd's version of the above programming structures:
;
#X obj 12 332 until;
#X msg 12 312 100;
#X obj 12 352 print i;
#X text 5 379 If you start [until] with a "bang" \, it will begin an
infinite loop! Please plan ahead in this case so that there is a mechanism
-in place to stop the loop - otherwise PD will effectively freeze.;
-#X text 5 446 HOW TO FREEZE PD;
+in place to stop the loop - otherwise Pd will effectively freeze.;
+#X text 5 446 HOW TO FREEZE Pd;
#X msg 13 469 bang;
#X obj 13 489 until;
#X obj 13 509 print;
@@ -41,12 +41,12 @@ it outputs "bang" until its right inlet gets a "bang" which stops it.
#X text 55 49 - LOOPing mechanism;
#X text 441 381 RELATED OBJECTS;
#X text 446 400 ?? This author does not know of any other native looping
-mechanisms in PD.;
+mechanisms in Pd.;
#N canvas 0 22 452 302 related_objects_from_other_libraries 0;
-#X text 27 63 These objects are offered in PD only if you have downloaded
+#X text 27 63 These objects are offered in Pd only if you have downloaded
and properly installed the appropriate library. These objects may or
may not exist in a single library.;
-#X text 26 112 The best places to find information about PD's libraries
+#X text 26 112 The best places to find information about Pd's libraries
is:;
#X text 23 134 www.puredata.org and click on "Downloads" then "Software"
;
@@ -68,11 +68,11 @@ is:;
#X obj 496 197 print;
#X obj 525 175 mod 10;
#X text 444 58 The example below includes a method to stop the loop
-to prevent PD from looping infinitely.;
+to prevent Pd from looping infinitely.;
#X text 54 489 If you click \, kill Pd or reboot the computer.;
-#X text 447 546 This document was updated for PD version 0.35 test
+#X text 447 546 This document was updated for Pd version 0.35 test
26 by Dave Sabine as part of a project called pddp proposed by Krzysztof
-Czaja to build comprehensive documentation for PD.;
+Czaja to build comprehensive documentation for Pd.;
#X obj 2 2 cnv 15 870 20 empty empty [until] 20 10 1 18 -233017 -66577
0;
#X obj 821 3 pddp;
diff --git a/doc/pddp/help-value.pd b/doc/pddp/value-help.pd
index fb55a035..783ea5a4 100644
--- a/doc/pddp/help-value.pd
+++ b/doc/pddp/value-help.pd
@@ -4,29 +4,29 @@
#X text 17 46 [value] is a container. It holds a global variable numeric
value and can be "polled" at any time with a "bang" message. In other
words \, [value] is a place where numbers can be stored and then accessed
-by all active PD windows.;
+by all active Pd windows.;
#X text 16 109 SCOPE;
#X text 18 127 Understanding "scope" is important while developing
-programmatic applications. In PD there are three levels of "scope":
+programmatic applications. In Pd there are three levels of "scope":
;
#X text 29 170 1 Local Scope: all objects \, subroutines \, data \,
and variables which exist within a single patch on a single computer
-and do not communicate with other active PD patches.;
+and do not communicate with other active Pd patches.;
#X text 27 226 2 Global Scope: all objects \, subroutines \, data and
variables which exist within single or multiple patches on a single
-computer which communicate with other active PD patches.;
+computer which communicate with other active Pd patches.;
#X text 17 354 As a general rule \, all things are considered "local"
-in PD and if communication between PD windows is necessary \, then
+in Pd and if communication between Pd windows is necessary \, then
[send]/[receive] \, or [throw]/[catch] objects are used. Likewise \,
-if communication is necessary between many computers running PD \,
+if communication is necessary between many computers running Pd \,
then objects such as [netsend]/[netreceive] are used.;
#X text 16 441 The exception to the above rule is [value]. This object
is a container which makes its data known to all [value] objects of
-the same name in all active PD windows on a single computer: hence
+the same name in all active Pd windows on a single computer: hence
\, GLOBAL scope.;
#X text 28 288 3 Network (Universal) Scope: all objects \, subroutines
\, data and variables which exist within single or multiple patches
-on two or more computers which communicate with other active PD patches
+on two or more computers which communicate with other active Pd patches
via a network.;
#X text 419 15 To create a [value] object \, a name should be defined
for the variable that it will contain. For example:;
@@ -60,7 +60,7 @@ like below:;
sub-patch below and then "bang" the [value] object to retreive the
current number. While you're in the sub-patch \, change the number
and then return to this window and click the above "bang". You'll quickly
-see how this variable can be retreived or reset in any active PD window.
+see how this variable can be retreived or reset in any active Pd window.
;
#N canvas 0 0 452 302 global_values 0;
#X obj 43 127 v my_variable;
@@ -76,10 +76,10 @@ see how this variable can be retreived or reset in any active PD window.
#X text 409 490 RELATED OBJECTS;
#N canvas 73 229 452 302 related_objects_from_other_libraries 0;
#X obj 28 37 getenv;
-#X text 18 86 These objects are offered in PD only if you have downloaded
+#X text 18 86 These objects are offered in Pd only if you have downloaded
and properly installed the appropriate library. These objects may or
may not exist in a single library.;
-#X text 17 135 The best places to find information about PD's libraries
+#X text 17 135 The best places to find information about Pd's libraries
is:;
#X text 14 157 www.puredata.org and click on "Downloads" then "Software"
;
@@ -91,9 +91,9 @@ is:;
#X text 492 504 These objects are actually quite different than [value]
but it's important to understand that difference in relation to [value].
;
-#X text 252 603 This document was updated for PD version 0.35 test
+#X text 252 603 This document was updated for Pd version 0.35 test
26 by Dave Sabine as part of a project called pddp proposed by Krzysztof
-Czaja to build comprehensive documentation for PD.;
+Czaja to build comprehensive documentation for Pd.;
#X connect 13 0 22 0;
#X connect 14 0 13 0;
#X connect 19 0 20 0;