From 7d6affca746f49f5ffb2818b8a9ccf9d91388e8f Mon Sep 17 00:00:00 2001 From: Jonathan Wilkes Date: Wed, 25 Aug 2010 00:31:27 +0000 Subject: revised help docs that conform to the PDDP template svn path=/trunk/; revision=13942 --- doc/pddp/dac~-help.pd | 219 ++++++++++++++++++++++++++++++++++---------------- 1 file changed, 151 insertions(+), 68 deletions(-) (limited to 'doc/pddp/dac~-help.pd') diff --git a/doc/pddp/dac~-help.pd b/doc/pddp/dac~-help.pd index fd007ae4..d1ad4638 100644 --- a/doc/pddp/dac~-help.pd +++ b/doc/pddp/dac~-help.pd @@ -1,68 +1,151 @@ -#N canvas 2 1 613 608 12; -#X obj 104 540 pddp/pddplink http://puredata.info/dev/pddp -text pddp; -#X obj 8 8 cnv 15 90 553 empty empty empty 20 12 0 14 -233017 -66577 -0; -#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 -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 397 246 Related_Objects 0; -#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~; -#X obj 45 46 adc~; -#X restore 104 488 pd Related_Objects; -#X text 16 107 ARGUMENTS:; -#X text 23 344 EXAMPLES:; -#X text 20 487 SEE ALSO:; -#X text 30 53 PURPOSE:; -#X text 152 541 - Dave Sabine \, May 6 \, 2003; -#X text 153 346 default stereo signals: same as; -#X text 280 435 all channels on an 8-channel device; -#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 -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 -be used to define multiple output channels - each integer corresponds -to an output channel on your audio hardware.; -#X text 36 188 INLETS:; -#X text 108 188 Signal: the number of inlets correspond with the number -of arguments - each inlet represents an output channel on your audio -hardware which corresponds to the argument you provide. If no arguments -are provided \, then there are two inlets which represent audio channels -1 and 2 on your computer's sound card.; -#X text 107 290 The information at each inlet should be an audio signal -(i.e. the object operates at 'audio-rate') and therefore must be connected -to an audio outlet on a related object.; -#X obj 109 346 dac~; -#X obj 411 348 dac~ 1 2; -#X obj 109 373 dac~ 5; -#X text 167 374 a mono signal to channel 5; -#X obj 109 404 dac~ 1 3 8 6 11 15 19 22 23 24 36; -#X text 383 405 11 channels of output; -#X obj 109 434 dac~ 1 2 3 4 5 6 7 8; +#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 dac~ 3 12 0 18 -204280 +-1 0; +#X obj 0 259 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 50 243 494 344 META 0; +#X text 12 105 PLATFORM windows macosx gnulinux; +#X text 12 145 LIBRARY internal; +#X text 12 185 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 65 LICENSE SIBSD; +#X text 12 165 AUTHOR Miller Puckette; +#X text 12 245 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 output; +#X text 12 25 NAME dac~; +#X text 12 125 INLET_n signal; +#X text 12 205 RELEASE_DATE 1997; +#X text 12 225 RELEASE_VERSION; +#X restore 500 597 pd META; +#X obj 0 355 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 383 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 471 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#X obj 78 268 cnv 17 3 17 empty \$0-pddp.cnv.let.n n 5 9 0 16 -228856 +-162280 0; +#N canvas 41 417 428 171 Related_objects 0; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 8 2 [dac~] Related Objects; +#X obj 63 42 switch~; +#X text 115 42 [block~]; +#X text 20 65 (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 20 117 Externals; +#X text 19 142 [shoutcast~]; +#X text 106 142 [oggcast~]; +#X text 181 142 [mp3cast~]; +#X obj 174 42 throw~; +#X obj 226 42 catch~; +#X obj 278 42 send~; +#X obj 322 42 receive~; +#X obj 23 42 adc~; +#X restore 101 597 pd Related_objects; +#X obj 465 20 pddp/pddplink http://wiki.puredata.info/en/dac~ -text +pdpedia: dac~; +#X obj 492 3 dac~; +#X text 109 133 default stereo signals: same as; +#X text 198 221 all channels on an 8-channel device; +#X obj 65 133 dac~; +#X obj 367 135 dac~ 1 2; +#X obj 65 160 dac~ 5; +#X text 123 159 a mono signal to channel 5; +#X obj 65 191 dac~ 1 3 8 6 11 15 19 22 23 24 36; +#X text 280 191 11 channels of output; +#X obj 65 221 dac~ 1 2 3 4 5 6 7 8; +#X text 98 359 (none); +#X text 98 267 signal; +#X text 168 401 - the object defaults to 2 outgoing audio channels +(usually a left and right stereo pair). Any number of arguments (integers) +can be used to define multiple output channels - each integer corresponds +to an output channel on your audio hardware.; +#X text 168 267 - the number of inlets correspond with the number of +arguments - each inlet represents an output channel on your audio hardware +which corresponds to the argument you provide. If no arguments are +provided \, then there are two inlets which represent audio channels +1 and 2 on your computer's sound card.; +#X text 98 475 [dac~] is an acronym meaning "Digital/Analog Converter +Signal" and is Pd's interface to send audio information to the audio +channels of your soundcard(s).; +#N canvas 37 90 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 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 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 19 314 To further optimize Pd's usage of your audio hardware +\, you can explore the following:; +#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 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 101 545 pd Multi-channel_audio; +#X text 80 401 n) float; +#X obj 4 597 pddp/pddplink pddp/help.pd -text help; +#X obj 66 51 osc~ 880; +#X obj 66 80 *~; +#X obj 66 106 *~ 0.1; +#X obj 96 80 tgl 15 0 empty empty empty 17 7 0 10 -262144 -1 -1 0 1 +; +#X obj 455 51 pddp/dsp-reminder; +#N canvas 84 189 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 101 520 pd sample_rate; +#N canvas 99 375 428 211 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 101 570 pd defeating_audio_computation; +#X text 117 79 <- Click to test; +#X text 11 23 audio output; +#X connect 28 0 29 0; +#X connect 29 0 30 0; +#X connect 30 0 13 0; +#X connect 31 0 29 1; -- cgit v1.2.1