aboutsummaryrefslogtreecommitdiff
path: root/doc/pddp/switch~-help.pd
blob: 5005c4c46f89b68cbfc690abb52426bbd9b9d2f2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
#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 switch~ 3 12 0 18
-204280 -1 0;
#X obj 0 225 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13
-228856 -1 0;
#N canvas 53 247 494 344 META 0;
#X text 12 105 LIBRARY internal;
#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/;
#X text 12 45 LICENSE SIBSD;
#X text 12 125 AUTHOR Miller Puckette;
#X text 12 185 HELP_PATCH_AUTHORS Updated for Pd version 0.4. Jonathan
Wilkes revised the patch to conform to the PDDP template for Pd version
0.42.;
#X text 12 65 DESCRIPTION block size and on/off control for DSP;
#X text 12 5 ALIAS block~;
#X text 12 85 INLET_0 set float bang;
#X text 12 25 KEYWORDS signal canvas_op;
#X text 12 165 RELEASE_DATE 1997;
#X restore 500 597 pd META;
#X obj 0 347 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0
13 -228856 -1 0;
#X obj 0 370 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12
0 13 -228856 -1 0;
#X obj 0 499 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12
0 13 -228856 -1 0;
#N canvas 91 484 428 108 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 [switch~] Related Objects;
#X obj 22 43 fft~;
#X obj 69 43 block~;
#X restore 102 597 pd Related_objects;
#X obj 78 234 cnv 17 3 105 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856
-162280 0;
#X obj 445 20 pddp/pddplink http://wiki.puredata.info/en/switch~ -text
pdpedia: switch~;
#X text 98 233 bang;
#X text 168 233 - a "bang" message causes one block of DSP to be computed.
This might be useful for pre-computing waveforms or window functions
\, or also for video processing.;
#X text 98 295 set;
#X text 98 351 (none);
#N canvas 65 117 428 374 messages-to-switch 0;
#X obj 23 238 bang~;
#X obj 23 264 t b b;
#X obj 23 290 timer;
#X floatatom 23 319 5 0 0 0 - - -;
#X obj 23 38 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0 1
;
#X msg 52 63 set 4096 1 1;
#X msg 52 121 set 4096 2 1;
#X msg 52 92 set 8192 1 1;
#X msg 52 151 set 4096 1 0.5;
#X msg 52 178 set 4096 1 2;
#X obj 23 205 switch~ 4096 1 1;
#X obj 23 347 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
-1;
#X text 128 220 (args are blocksize \, overlap \, up/downsampling)
;
#X text 141 62 block size 4096 \, no overlap \, no resampling;
#X text 141 91 bigger block size;
#X text 140 120 double overlap;
#X text 148 150 downsampled by factor of 2;
#X text 148 179 upsampled by factor of 2;
#X text 128 205 creation arguments (if any) initialize blocking;
#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 [switch~] The "set" Message;
#X text 65 319 <- measured time (msec) between blocks;
#X text 50 37 <- switch this subpatch on and off;
#X connect 0 0 1 0;
#X connect 1 0 2 0;
#X connect 1 1 2 1;
#X connect 2 0 3 0;
#X connect 3 0 11 0;
#X connect 4 0 10 0;
#X connect 5 0 10 0;
#X connect 6 0 10 0;
#X connect 7 0 10 0;
#X connect 8 0 10 0;
#X connect 9 0 10 0;
#X restore 171 325 pd messages-to-switch;
#X text 168 295 - the "set" message can be used to change the blocksize
\, overlap \, and up/downsampling.;
#N canvas 82 247 428 234 switched 0;
#X floatatom 140 95 1 0 0 0 - - -;
#X floatatom 23 159 7 0 0 0 - - -;
#X obj 23 95 noise~;
#X obj 23 127 env~ 512;
#X text 20 37 DSP in this subwindow is turned on and off by the [switch~]
object. Any subwindows of this window can also be switched off here.
If a patch and a superpatch both have switches \, both must be "on"
for DSP to run in the patch.;
#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 [switch~] A simple example;
#X obj 140 122 switch~;
#X text 20 183 [switch~] takes optional arguments the same as block~.
If you supply arguments to switch \, the patch will be switched AND
reblocked.;
#X connect 0 0 7 0;
#X connect 2 0 3 0;
#X connect 3 0 1 0;
#X restore 78 183 pd switched;
#X text 237 204 interactions with other objects;
#X text 75 103 The [switch~] object also allows you to set the block
size \, overlap \, and up/down-sampling ratio for the window. (The
overlap and resampling ratio are relative to the super-patch.);
#X text 76 39 The [switch~] object allows you to switch DSP on and
off for the window. All subwindows are also switched. (If a subwindow
of a switched window is also switched \, both switches must be on for
the subwindow's audio DSP to run. Pd's global DSP must also be on.)
;
#X text 75 151 You may have at most one block~/switch~ object in any
window \, so the examples are in subpatches below:;
#X text 162 183 a simple example;
#X text 99 503 BUG! [dac~] and [adc~] work only with a blocksize of
64 . If you want to reblock audio computation \, do so in a sub-patch
and keep the [adc~] and [dac~] objects in a super-patch. Only the [inlet~]
and [outlet~] objects know how to reblock signals. In this example
\, you could put a [dac~] in this \, outer window \, or in the switched
subwindow \, but not the blocked one.;
#N canvas 114 316 428 159 more_about_blocksize 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 [switch~] Block Size;
#X text 20 38 Pd's default block size is 64 samples. The [inlet~] and
[outlet~] objects reblock signals to adjust for differences between
parent and subpatch \, but only power-of-two adjustments are possible.
So for "normal" audio computations \, all blocaks should also be power-of-two
in size. HOWEVER \, if you have no [inlet~] or [outlet~] you may specify
any other block size. This is intended for later use in video processing.
;
#X restore 170 476 pd more_about_blocksize;
#X text 11 23 block size and on/off control for DSP;
#X text 168 418 - up/downsampling;
#X text 168 403 - overlap;
#X text 168 388 - blocksize;
#X text 167 434 [switch~] with no arguments does not reblock audio
computation -- in other words \, block size and sample rate are as
in the parent patch.;
#X text 298 389 (See the "messages_to_switch" subpatch;
#X text 298 404 above for more details.);
#X text 98 270 float;
#X text 467 3 [switch~];
#N canvas 80 270 428 229 [switch~]-interactions 0;
#X text 20 98 If using send~ or delwrite~ from a switched-off patch
\, the output of corresponding receive~ and delread~ objects in other
\, running patches will cycle old input (and sound like garbage). Throw~
may be switched with impunity \, but not catch~.;
#X text 20 38 dac~ and adc~ don't work correctly if reblocked \, nor
if a parent window is reblocked \, even if the window containing the
dac~ or adc~ is reblocked back to the default block size and sample
rate.;
#X text 20 168 Patches using send~/receive~ or throw~/catch~ to intercommunicate
must have the same blocking -- and if their parents are blocked bigger
than they are \, there might be weirdness.;
#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 [switch~] Interactions between [switch~] and other objects
;
#X restore 78 204 pd [switch~]-interactions;
#X text 168 270 - "0" turns DSP off for the window \, "1" (or any nonzero
value) turns it on.;
#X text 80 388 1) float;
#X text 80 403 2) float;
#X text 80 418 3) float;
#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide;
#X obj 455 51 pddp/dsp;