1 files changed, 141 insertions, 55 deletions
diff --git a/doc/pddp/adc~-help.pd b/doc/pddp/adc~-help.pd
index fd825110..c59b0578 100644
--- a/doc/pddp/adc~-help.pd
+++ b/doc/pddp/adc~-help.pd
@@ -1,67 +1,153 @@
-#N canvas 578 22 544 568 12;
-#X obj 8 8 cnv 15 90 553 empty empty empty 20 12 0 14 -233017 -66577
-0;
-#N canvas 85 22 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
+#N canvas 0 0 555 619 10;
+#X obj 0 595 cnv 15 552 21 empty \$0-pddp.cnv.footer empty 20 12 0
+14 -228856 -66577 0;
+#X obj 0 0 cnv 15 552 40 empty \$0-pddp.cnv.header adc~ 3 12 0 18 -204280
+-1 0;
+#X obj 0 297 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13
+-228856 -1 0;
+#N canvas 44 246 494 344 META 0;
+#X text 12 105 PLATFORM windows macosx gnulinux;
+#X text 12 165 LIBRARY internal;
+#X text 12 205 WEBSITE http://crca.ucsd.edu/~msp/;
+#X text 12 65 LICENSE SIBSD;
+#X text 12 185 AUTHOR Miller Puckette;
+#X text 12 265 HELP_PATCH_AUTHORS Dave Sabine \, May 5 \, 2003 . Jonathan
+Wilkes revised the patch to conform to the PDDP template for Pd version
+0.42.;
+#X text 12 5 GENRE help;
+#X text 12 45 KEYWORDS signal conversion;
+#X text 12 85 DESCRIPTION: audio input;
+#X text 12 125 INLET_0;
+#X text 12 145 OUTLET_N signal;
+#X text 12 25 NAME adc~;
+#X text 12 225 RELEASE_DATE 1997;
+#X text 12 245 RELEASE_VERSION;
+#X restore 501 597 pd META;
+#X obj 0 334 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0
+13 -228856 -1 0;
+#X obj 0 421 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12
+0 13 -228856 -1 0;
+#X obj 0 508 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12
+0 13 -228856 -1 0;
+#X obj 79 306 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856
+-162280 0;
+#N canvas 94 375 428 209 Related_objects 0;
+#X obj 22 43 dac~;
+#X obj 62 43 switch~;
+#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0
+14 -204280 -1 0;
+#X text 7 2 [adc~] Related Objects;
+#X text 114 43 [block~];
+#X text 19 66 (Note: having a [block~] and a [switch~] in the same
+window causes an error \, which is why [block~] is shown above as a
+comment.);
+#X text 19 118 Externals;
+#X obj 173 43 throw~;
+#X obj 225 43 catch~;
+#X obj 277 43 send~;
+#X obj 321 43 receive~;
+#X obj 19 142 pddp/helplink pdogg/oggcast~;
+#X obj 19 162 pddp/helplink unauthorized/mp3cast~;
+#X text 18 183 [shoutcast~] (What library is this object in?);
+#X restore 102 597 pd Related_objects;
+#X obj 490 3 adc~;
+#X obj 466 20 pddp/pddplink http://wiki.puredata.info/en/adc~ -text
+pdpedia: adc~;
+#X text 99 343 signal;
+#X obj 79 343 cnv 17 3 70 empty \$0-pddp.cnv.let.n n 5 9 0 16 -228856
+-162280 0;
+#X obj 86 59 adc~;
+#X obj 86 196 adc~ 5;
+#X text 144 197 a mono signal from channel 5;
+#X obj 86 227 adc~ 1 3 8 6 11 15 19 22 23 24 36;
+#X text 360 228 11 channels of audio;
+#X obj 86 257 adc~ 1 2 3 4 5 6 7 8;
+#X text 257 258 all channels on an 8-channel device;
+#X text 130 59 default stereo signals: same as:;
+#X obj 332 60 adc~ 1 2;
+#X text 168 438 - the object defaults to 2 incoming audio channels
+(usually a left and right stereo pair). Any number of arguments (integers)
+can be used to define one or multiple input channels - each integer
+corresponds to an input channel on your audio hardware.;
+#X text 80 438 n) float;
+#X text 169 343 - the number of outlets corresponds with the number
+of arguments - each outlet represents an input channel on your audio
+hardware which corresponds to the argument you provide. If no arguments
+are provided \, then there are two outlets which represent audio channels
+1 and 2 on your computers sound card.;
+#X obj 87 103 env~;
+#X floatatom 87 151 5 0 0 0 - - -;
+#X obj 87 127 spigot;
+#X obj 150 104 tgl 15 0 empty empty empty 17 7 0 10 -262144 -1 -1 0
+1;
+#X text 180 104 <- Click to get amplitude of channel 1;
+#X text 130 151 RMS amplitude (dB);
+#X text 169 305 - the inlet to [adc~] is not used.;
+#X text 99 305 (inactive);
+#X obj 5 597 pddp/pddplink pddp/help.pd -text help;
+#X obj 455 51 pddp/dsp-reminder;
+#N canvas 44 65 428 471 Multi-channel_audio 0;
+#X text 19 38 All sound cards are capable of at least two channels
 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
 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
+#X text 80 145 c:/pd/bin/pd.exe -pa -inchannels 8 -outchannels 8;
+#X text 19 174 The "-pa" switch means "PortAudio". This switch is new
 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
+#X text 19 234 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
+#X text 19 314 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 29 355 - audiobuf;
+#X text 30 373 - blocksize;
+#X text 29 389 - audioindev;
+#X text 29 407 - audiooutdev;
+#X text 25 433 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 22 395 244 Related_Objects 0;
-#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~;
-#X obj 171 46 block~;
-#X restore 104 488 pd Related_Objects;
-#X text 16 107 ARGUMENTS:;
-#X text 32 188 OUTLETS:;
-#X text 23 344 EXAMPLES:;
-#X text 20 487 SEE ALSO:;
-#X obj 33 20 adc~;
-#X text 30 53 PURPOSE:;
-#X text 108 18 - AUDIO INPUT: ANALOG/DIGITAL CONVERTER SIGNAL;
-#X text 112 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
-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
-be used to define multiple input channels - each integer corresponds
-to an input channel on your audio hardware.;
-#X text 107 188 Signal: the number of outlets correspond with the number
-of arguments - each outlet represents an input channel on your audio
-hardware which corresponds to the argument you provide. If no arguments
-are provided \, then there are two outlets which represent audio channels
-1 and 2 on your computers sound card.;
-#X text 107 290 The information at each outlet is an audio signal (i.e.
-the object operates at 'audio-rate') and therefore must be connected
-to an audio inlet on a related object.;
-#X obj 109 346 adc~;
-#X text 153 346 default stereo signals: same as;
-#X obj 411 348 adc~ 1 2;
-#X obj 109 373 adc~ 5;
-#X text 167 374 a mono signal from channel 5;
-#X obj 109 404 adc~ 1 3 8 6 11 15 19 22 23 24 36;
-#X text 383 405 11 channels of audio;
-#X obj 109 434 adc~ 1 2 3 4 5 6 7 8;
-#X text 280 435 all channels on an 8-channel device;
+#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0
+14 -204280 -1 0;
+#X text 7 2 [dac~] Multi-channel Audio;
+#X restore 102 542 pd Multi-channel_audio;
+#N canvas 84 165 428 347 sample_rate 0;
+#X text 19 37 [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
+by using the [block~] object. Here are some example of the common sample
+rates:;
+#X text 19 191 c:/pd/bin/pd.exe -r 11025;
+#X text 19 221 c:/pd/bin/pd.exe -r 22050;
+#X text 19 281 c:/pd/bin/pd.exe -r 88200;
+#X text 19 176 c:/pd/bin/pd.exe -r 8000;
+#X text 19 206 c:/pd/bin/pd.exe -r 16000;
+#X text 19 236 c:/pd/bin/pd.exe -r 32000;
+#X text 19 251 c:/pd/bin/pd.exe -r 44100 CD Quality;
+#X text 19 266 c:/pd/bin/pd.exe -r 48000 DAT Quality;
+#X text 19 311 c:/pd/bin/pd.exe -r 192000 DVD-Audio Quality;
+#X text 19 296 c:/pd/bin/pd.exe -r 96000 DVD-Video/Audio Quality;
+#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0
+14 -204280 -1 0;
+#X text 7 2 [dac~] Sample Rate;
+#X restore 102 517 pd sample_rate;
+#N canvas 59 444 428 117 defeating_audio_computation 0;
+#X text 19 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 obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0
+14 -204280 -1 0;
+#X text 7 2 [dac~] -nodac and -noadc;
+#X restore 102 567 pd defeating_audio_computation;
+#X text 12 23 audio input;
+#X connect 13 0 25 0;
+#X connect 25 0 27 0;
+#X connect 27 0 26 0;
+#X connect 28 0 27 1;