cleaned up help files a bit in search of what the [adc~] inlet does (it does nothing)

svn path=/trunk/; revision=9955

2 files changed, 172 insertions, 176 deletions

diff --git a/doc/pddp/adc~-help.pd b/doc/pddp/adc~-help.pd
index a9caeaef..fd825110 100644
--- a/doc/pddp/adc~-help.pd
+++ b/doc/pddp/adc~-help.pd
@@ -1,68 +1,67 @@
-#N canvas 2 1 611 606 12;

-#X obj 104 540 pddp;

-#X obj 8 8 cnv 15 90 553 empty empty empty 20 12 0 14 -233017 -66577

-0;

-#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

-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

-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

-\, 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

-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 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 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

-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;

+#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
+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
+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
+\, 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
+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;
diff --git a/doc/pddp/adc~_dac~-help.pd b/doc/pddp/adc~_dac~-help.pd
index 781c080b..4b8dc717 100644
--- a/doc/pddp/adc~_dac~-help.pd
+++ b/doc/pddp/adc~_dac~-help.pd
@@ -1,108 +1,105 @@
-#N canvas 3 0 619 592 12;

-#X obj 104 540 pddp;

-#X obj 8 8 cnv 15 90 553 empty empty empty 20 12 0 14 -233017 -66577

-0;

-#N canvas 129 0 415 237 More_Info 0;

-#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

-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;

-#X text 85 262 c:/pd/bin/pd.exe -r 22050;

-#X text 86 329 c:/pd/bin/pd.exe -r 88200;

-#X text 85 217 c:/pd/bin/pd.exe -r 8000;

-#X text 85 247 c:/pd/bin/pd.exe -r 16000;

-#X text 86 278 c:/pd/bin/pd.exe -r 32000;

-#X text 86 294 c:/pd/bin/pd.exe -r 44100 CD Quality;

-#X text 86 311 c:/pd/bin/pd.exe -r 48000 DAT Quality;

-#X text 87 366 c:/pd/bin/pd.exe -r 192000 DVD-Audio Quality;

-#X text 86 347 c:/pd/bin/pd.exe -r 96000 DVD-Video/Audio Quality;

-#X restore 40 75 pd sample_rate;

-#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

-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

-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

-\, 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

-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

-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 118 Externals and other object libraries;

-#X obj 57 35 bilge;

-#X text 35 143 [shoutcast~];

-#X text 35 166 [oggcast~];

-#X obj 115 35 send~;

-#X obj 169 35 receive~;

-#X obj 58 66 throw~;

-#X obj 121 66 catch~;

-#X obj 185 66 block~;

-#X obj 249 66 switch~;

-#X restore 104 488 pd Related_Objects;

-#X text 14 84 ARGUMENTS:;

-#X text 22 219 EXAMPLES:;

-#X text 21 463 SEE ALSO:;

-#X obj 12 19 adc~;

-#X obj 61 19 dac~;

-#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.;

-#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

-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

-channels \, but you are likely limited by your audio hardware to 2

-\, 4 \, 6 \, 8 \, 12 \, 16 \, 32 \, 64 \, etc.;

-#X obj 114 222 adc~;

-#X text 162 222 incoming stereo signals;

-#X obj 114 251 dac~;

-#X text 162 252 outgoing stereo signals;

-#X obj 114 280 adc~ 1 2 3 4 5 6 7 8;

-#X text 290 281 eight incoming audio signals;

-#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

-\, 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

-to "Compute Audio".;

-#X obj 104 464 help-adc~;

-#X obj 190 464 help-dac~;

+#N canvas 847 22 553 572 12;
+#X obj 8 8 cnv 15 90 553 empty empty empty 20 12 0 14 -233017 -66577
+0;
+#N canvas 129 22 415 237 More_Info 0;
+#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
+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;
+#X text 85 262 c:/pd/bin/pd.exe -r 22050;
+#X text 86 329 c:/pd/bin/pd.exe -r 88200;
+#X text 85 217 c:/pd/bin/pd.exe -r 8000;
+#X text 85 247 c:/pd/bin/pd.exe -r 16000;
+#X text 86 278 c:/pd/bin/pd.exe -r 32000;
+#X text 86 294 c:/pd/bin/pd.exe -r 44100 CD Quality;
+#X text 86 311 c:/pd/bin/pd.exe -r 48000 DAT Quality;
+#X text 87 366 c:/pd/bin/pd.exe -r 192000 DVD-Audio Quality;
+#X text 86 347 c:/pd/bin/pd.exe -r 96000 DVD-Video/Audio Quality;
+#X restore 40 75 pd sample_rate;
+#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
+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
+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
+\, 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
+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
+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 488 pd More_Info;
+#N canvas 85 22 399 248 Related_Objects 0;
+#X text 25 8 Native Pd Objects;
+#X text 25 118 Externals and other object libraries;
+#X text 35 143 [shoutcast~];
+#X text 35 166 [oggcast~];
+#X obj 55 35 send~;
+#X obj 109 35 receive~;
+#X obj 58 66 throw~;
+#X obj 121 66 catch~;
+#X obj 185 66 block~;
+#X obj 249 66 switch~;
+#X text 35 196 [mp3cast~];
+#X restore 104 462 pd Related_Objects;
+#X text 14 84 ARGUMENTS:;
+#X text 22 219 EXAMPLES:;
+#X text 21 463 SEE ALSO:;
+#X obj 12 19 adc~;
+#X obj 61 19 dac~;
+#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.;
+#X text 102 515 - 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
+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
+channels \, but you are likely limited by your audio hardware to 2
+\, 4 \, 6 \, 8 \, 12 \, 16 \, 32 \, 64 \, etc.;
+#X obj 114 222 adc~;
+#X text 162 222 incoming stereo signals;
+#X obj 114 251 dac~;
+#X text 162 252 outgoing stereo signals;
+#X obj 114 280 adc~ 1 2 3 4 5 6 7 8;
+#X text 290 281 eight incoming audio signals;
+#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
+\, 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
+to "Compute Audio".;