From 4b23cd7a8c142a273bc4dbd903c97a2075de9b24 Mon Sep 17 00:00:00 2001 From: Hans-Christoph Steiner Date: Sat, 31 May 2008 13:57:45 +0000 Subject: cleaned up help files a bit in search of what the [adc~] inlet does (it does nothing) svn path=/trunk/; revision=9955 --- doc/pddp/adc~-help.pd | 135 ++++++++++++++-------------- doc/pddp/adc~_dac~-help.pd | 213 ++++++++++++++++++++++----------------------- 2 files changed, 172 insertions(+), 176 deletions(-) (limited to 'doc') 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".; -- cgit v1.2.1