From f3bf212e607800a473466ad7f2a224b75d3a78c8 Mon Sep 17 00:00:00 2001 From: Jonathan Wilkes <jon.w.wilkes@gmail.com> Date: Sun, 12 Feb 2017 17:46:12 -0500 Subject: [PATCH] merge doc/pddp with pd/doc/5.reference --- doc/Makefile | 14 - doc/pddp/LICENSE.txt | 340 ------ doc/pddp/TODO | 13 - doc/pddp/about/GUIs-about.pd | 88 -- doc/pddp/about/mapping-about.pd | 292 ------ doc/pddp/about/pddp-about.pd | 35 - doc/pddp/about/reverb-about.pd | 5 - doc/pddp/acoustics-help.pd | 100 -- doc/pddp/acoustics~-help.pd | 124 --- doc/pddp/adc~_dac~-help.pd | 108 -- doc/pddp/append-help.pd | 114 -- doc/pddp/bag-help.pd | 86 -- doc/pddp/bang-help.pd | 133 --- doc/pddp/bang~-help.pd | 75 -- doc/pddp/biquad~-help.pd | 88 -- doc/pddp/block~-help.pd | 211 ---- doc/pddp/bng-help.pd | 443 -------- doc/pddp/bp~-help.pd | 88 -- doc/pddp/canvas-help.pd | 85 -- doc/pddp/change-help.pd | 102 -- doc/pddp/clip-help.pd | 141 --- doc/pddp/clip~-help.pd | 90 -- doc/pddp/cos~-help.pd | 140 --- doc/pddp/cpole~-help.pd | 188 ---- doc/pddp/cputime-help.pd | 167 --- doc/pddp/czero_rev~-help.pd | 206 ---- doc/pddp/czero~-help.pd | 190 ---- doc/pddp/declare-help.pd | 68 -- doc/pddp/delay-help.pd | 185 ---- doc/pddp/delread~-help.pd | 87 -- doc/pddp/delwrite~-help.pd | 95 -- doc/pddp/drawnumber-help.pd | 161 --- doc/pddp/drawpolygon-help.pd | 171 --- doc/pddp/element-help.pd | 135 --- doc/pddp/env~-help.pd | 75 -- doc/pddp/fft~-help.pd | 111 -- doc/pddp/float-help.pd | 199 ---- doc/pddp/framp~-help.pd | 86 -- doc/pddp/gatom-help.pd | 158 --- doc/pddp/get-help.pd | 122 --- doc/pddp/getsize-help.pd | 102 -- doc/pddp/graph-help.pd | 59 -- doc/pddp/hdial-help.pd | 283 ----- doc/pddp/hip~-help.pd | 95 -- doc/pddp/hslider-help.pd | 439 -------- doc/pddp/int-help.pd | 137 --- doc/pddp/key-help.pd | 142 --- doc/pddp/line-help.pd | 252 ----- doc/pddp/line~-help.pd | 105 -- doc/pddp/list-help.pd | 676 ------------ doc/pddp/lop~-help.pd | 91 -- doc/pddp/makefilename-help.pd | 361 ------- doc/pddp/makenote-help.pd | 128 --- doc/pddp/math-help.pd | 132 --- doc/pddp/message-help.pd | 289 ------ doc/pddp/midi-help.pd | 100 -- doc/pddp/moses-help.pd | 120 --- doc/pddp/my_canvas-help.pd | 748 ------------- doc/pddp/namecanvas-help.pd | 53 - doc/pddp/netreceive-help.pd | 94 -- doc/pddp/netsend-help.pd | 113 -- doc/pddp/noise~-help.pd | 62 -- doc/pddp/numbox2-help.pd | 424 -------- doc/pddp/openpanel-help.pd | 72 -- doc/pddp/operators-help.pd | 105 -- doc/pddp/osc~-help.pd | 96 -- doc/pddp/otherbinops-help.pd | 519 ---------- doc/pddp/pack-help.pd | 208 ---- doc/pddp/pd-help.pd | 161 --- doc/pddp/phasor~-help.pd | 84 -- doc/pddp/pipe-help.pd | 223 ---- doc/pddp/plot-help.pd | 190 ---- doc/pddp/pointer-help.pd | 185 ---- doc/pddp/poly-help.pd | 101 -- doc/pddp/print-help.pd | 153 --- doc/pddp/print~-help.pd | 63 -- doc/pddp/qlist-help.pd | 144 --- doc/pddp/random-help.pd | 576 ---------- doc/pddp/readsf~-help.pd | 125 --- doc/pddp/realtime-help.pd | 159 --- doc/pddp/receive-help.pd | 185 ---- doc/pddp/route-help.pd | 540 ---------- doc/pddp/rpole~-help.pd | 141 --- doc/pddp/rsqrt~-help.pd | 73 -- doc/pddp/rzero_rev~-help.pd | 136 --- doc/pddp/rzero~-help.pd | 134 --- doc/pddp/samphold~-help.pd | 107 -- doc/pddp/savepanel-help.pd | 69 -- doc/pddp/select-help.pd | 318 ------ doc/pddp/send-help.pd | 185 ---- doc/pddp/send~-help.pd | 75 -- doc/pddp/set-help.pd | 143 --- doc/pddp/setsize-help.pd | 107 -- doc/pddp/sigbinops-help.pd | 123 --- doc/pddp/sig~-help.pd | 64 -- doc/pddp/snapshot~-help.pd | 80 -- doc/pddp/soundfiler-help.pd | 122 --- doc/pddp/spigot-help.pd | 187 ---- doc/pddp/sqrt~-help.pd | 77 -- doc/pddp/stripnote-help.pd | 109 -- doc/pddp/struct-help.pd | 161 --- doc/pddp/sublist-help.pd | 61 -- doc/pddp/swap-help.pd | 232 ----- doc/pddp/switch~-help.pd | 172 --- doc/pddp/tabosc4~-help.pd | 192 ---- doc/pddp/tabplay~-help.pd | 162 --- doc/pddp/tabread-help.pd | 131 --- doc/pddp/tabread4~-help.pd | 141 --- doc/pddp/tabreceive~-help.pd | 54 - doc/pddp/tabsend~-help.pd | 92 -- doc/pddp/tabwrite-help.pd | 132 --- doc/pddp/tabwrite~-help.pd | 110 -- doc/pddp/templates/+pager.pd | 141 --- doc/pddp/templates/example-about.pd | 144 --- doc/pddp/templates/example-help.pd | 162 --- doc/pddp/templates/template-about.pd | 63 -- doc/pddp/templates/template-help.pd | 66 -- doc/pddp/templates/template-help_elements.pd | 60 -- doc/pddp/text-help.pd | 73 -- doc/pddp/textfile-help.pd | 111 -- doc/pddp/threshold~-help.pd | 93 -- doc/pddp/throw~-help.pd | 87 -- doc/pddp/timer-help.pd | 169 --- doc/pddp/toggle-help.pd | 395 ------- doc/pddp/trigger-help.pd | 391 ------- doc/pddp/unpack-help.pd | 120 --- doc/pddp/until-help.pd | 162 --- doc/pddp/value-help.pd | 142 --- doc/pddp/vcf~-help.pd | 94 -- doc/pddp/vdial-help.pd | 283 ----- doc/pddp/vd~-help.pd | 93 -- doc/pddp/vline~-help.pd | 100 -- doc/pddp/vslider-help.pd | 433 -------- doc/pddp/vu-help.pd | 373 ------- doc/pddp/wrap~-help.pd | 68 -- doc/pddp/writesf~-help.pd | 98 -- doc/pddp/x_all_guis.pd | 19 - .../doc/5.reference}/Nmop~3pIsdn~tno9V~llV.pd | 0 {doc/pddp => pd/doc/5.reference}/abs-help.pd | 0 pd/doc/5.reference/acoustics-help.pd | 147 ++- pd/doc/5.reference/acoustics~-help.pd | 201 ++-- {doc/pddp => pd/doc/5.reference}/adc~-help.pd | 0 pd/doc/5.reference/adc~_dac~-help.pd | 124 ++- {doc/pddp => pd/doc/5.reference}/all_about.pd | 0 .../all_about_acoustic_conversions.pd | 0 .../doc/5.reference}/all_about_arrays.pd | 0 .../doc/5.reference}/all_about_ascii_art.pd | 0 .../5.reference}/all_about_atom_conversion.pd | 0 .../doc/5.reference}/all_about_atoms.pd | 0 .../all_about_canvas_properties.pd | 0 .../doc/5.reference}/all_about_data_types.pd | 0 .../5.reference}/all_about_dollarsign_zero.pd | 0 .../5.reference}/all_about_expr_and_value.pd | 0 .../5.reference}/all_about_expr_functions.pd | 0 .../doc/5.reference}/all_about_expr_if.pd | 0 .../5.reference}/all_about_expr_multiline.pd | 0 .../doc/5.reference}/all_about_externals.pd | 0 .../5.reference}/all_about_finding_objects.pd | 0 .../5.reference}/all_about_getting_help.pd | 0 .../doc/5.reference}/all_about_haptics.pd | 0 .../5.reference}/all_about_help_patches.pd | 0 .../doc/5.reference}/all_about_hid.pd | 0 .../doc/5.reference}/all_about_index.pd | 0 .../doc/5.reference}/all_about_libraries.pd | 0 .../all_about_lists_vs_anythings.pd | 0 .../doc/5.reference}/all_about_looping.pd | 0 .../all_about_message_conversion.pd | 0 .../doc/5.reference}/all_about_messages.pd | 0 .../doc/5.reference}/all_about_midi_flags.pd | 0 .../doc/5.reference}/all_about_pd_META.pd | 0 .../doc/5.reference}/all_about_route.pd | 0 .../all_about_scope_and_locality.pd | 0 .../5.reference}/all_about_send_n_receive.pd | 0 .../5.reference}/all_about_submitting_bugs.pd | 0 .../all_about_symbol_construction.pd | 0 .../all_about_writing_help_patches.pd | 0 .../doc/5.reference}/all_about_z_order.pd | 0 pd/doc/5.reference/append-help.pd | 158 ++- .../pddp => pd/doc/5.reference}/array-help.pd | 0 {doc/pddp => pd/doc/5.reference}/atan-help.pd | 0 .../pddp => pd/doc/5.reference}/atan2-help.pd | 0 pd/doc/5.reference/bag-help.pd | 113 +- pd/doc/5.reference/bang-help.pd | 146 ++- pd/doc/5.reference/bang~-help.pd | 93 +- .../doc/5.reference}/bendin-help.pd | 0 .../doc/5.reference}/bendout-help.pd | 0 pd/doc/5.reference/biquad~-help.pd | 122 ++- pd/doc/5.reference/block~-help.pd | 285 +++-- pd/doc/5.reference/bng-help.pd | 682 +++++++----- .../pddp => pd/doc/5.reference}/bonk~-help.pd | 0 pd/doc/5.reference/bp~-help.pd | 124 ++- pd/doc/5.reference/canvas-help.pd | 102 +- .../doc/5.reference}/catch~-help.pd | 0 pd/doc/5.reference/change-help.pd | 125 ++- .../doc/5.reference}/choice-help.pd | 0 pd/doc/5.reference/clip-help.pd | 48 +- pd/doc/5.reference/clip~-help.pd | 158 +-- .../doc/5.reference}/closebang-abs.pd | 0 .../doc/5.reference}/closebang-help.pd | 0 .../doc/5.reference}/colour-guide.pd | 4 +- .../doc/5.reference}/complex-mod~-help.pd | 0 {doc/pddp => pd/doc/5.reference}/cos-help.pd | 0 pd/doc/5.reference/cos~-help.pd | 174 +++- pd/doc/5.reference/cpole~-help.pd | 237 +++-- pd/doc/5.reference/cputime-help.pd | 182 +++- .../pddp => pd/doc/5.reference}/ctlin-help.pd | 0 .../doc/5.reference}/ctlout-help.pd | 0 pd/doc/5.reference/czero_rev~-help.pd | 184 ++-- pd/doc/5.reference/czero~-help.pd | 238 +++-- {doc/pddp => pd/doc/5.reference}/dac~-help.pd | 0 .../doc/5.reference}/dbtopow-help.pd | 0 .../doc/5.reference}/dbtopow~-help.pd | 0 .../doc/5.reference}/dbtorms-help.pd | 0 .../doc/5.reference}/dbtorms~-help.pd | 0 pd/doc/5.reference/declare-help.pd | 89 +- pd/doc/5.reference/delay-help.pd | 215 +++- .../doc/5.reference}/delread4~-help.pd | 0 pd/doc/5.reference/delread~-help.pd | 120 ++- pd/doc/5.reference/delwrite~-help.pd | 110 +- pd/doc/5.reference/drawnumber-help.pd | 200 +++- pd/doc/5.reference/drawpolygon-help.pd | 215 +++- .../doc/5.reference}/drawsymbol-help.pd | 0 .../doc/5.reference}/dynamic_sends.pd | 0 pd/doc/5.reference/element-help.pd | 182 +++- pd/doc/5.reference/env~-help.pd | 100 +- {doc/pddp => pd/doc/5.reference}/exp-help.pd | 0 {doc/pddp => pd/doc/5.reference}/expr-help.pd | 0 .../pddp => pd/doc/5.reference}/expr~-help.pd | 0 .../doc/5.reference}/fexpr~-help.pd | 0 pd/doc/5.reference/fft~-help.pd | 145 ++- .../doc/5.reference}/fiddle~-help.pd | 0 pd/doc/5.reference/float-help.pd | 217 +++- pd/doc/5.reference/framp~-help.pd | 114 +- {doc/pddp => pd/doc/5.reference}/ftom-help.pd | 0 .../pddp => pd/doc/5.reference}/ftom~-help.pd | 0 pd/doc/5.reference/gatom-help.pd | 46 +- pd/doc/5.reference/get-help.pd | 169 ++- pd/doc/5.reference/getsize-help.pd | 133 ++- {doc/pddp => pd/doc/5.reference}/glossary.pd | 0 {doc/pddp => pd/doc/5.reference}/glossary.txt | 0 pd/doc/5.reference/graph-help.pd | 70 +- pd/doc/5.reference/hdial-help.pd | 45 +- .../doc/5.reference}/hilbert~-help.pd | 0 pd/doc/5.reference/hip~-help.pd | 124 ++- .../doc/5.reference}/hradio-help.pd | 0 pd/doc/5.reference/hslider-help.pd | 700 ++++++++----- .../doc/5.reference}/import-help.pd | 0 .../initbang-help-ex1-loadbang.pd | 0 .../initbang-help-ex2-initbang.pd | 0 .../doc/5.reference}/initbang-help.pd | 0 .../pddp => pd/doc/5.reference}/inlet-help.pd | 0 .../doc/5.reference}/inlet~-help.pd | 0 pd/doc/5.reference/int-help.pd | 161 ++- .../pddp => pd/doc/5.reference}/intro-help.pd | 0 pd/doc/5.reference/key-help.pd | 164 ++- .../doc/5.reference}/keyboard_fun.txt | 0 .../doc/5.reference}/keyname-help.pd | 0 .../pddp => pd/doc/5.reference}/keyup-help.pd | 0 pd/doc/5.reference/line-help.pd | 287 ++++- pd/doc/5.reference/line~-help.pd | 138 ++- pd/doc/5.reference/list-help.pd | 818 ++++++++++----- .../doc/5.reference}/loadbang-help.pd | 0 {doc/pddp => pd/doc/5.reference}/log-help.pd | 0 .../pddp => pd/doc/5.reference}/loop~-help.pd | 0 pd/doc/5.reference/lop~-help.pd | 126 ++- .../doc/5.reference}/lrshift~-help.pd | 0 pd/doc/5.reference/makefilename-help.pd | 402 ++++++- pd/doc/5.reference/makenote-help.pd | 154 ++- pd/doc/5.reference/math-help.pd | 192 ++-- {doc/pddp => pd/doc/5.reference}/max-help.pd | 0 pd/doc/5.reference/message-help.pd | 346 +++++-- .../pddp => pd/doc/5.reference}/metro-help.pd | 0 pd/doc/5.reference/midi-help.pd | 229 ++-- .../doc/5.reference}/midiin-help.pd | 0 .../doc/5.reference}/midiout-help.pd | 0 {doc/pddp => pd/doc/5.reference}/min-help.pd | 0 pd/doc/5.reference/moses-help.pd | 131 ++- {doc/pddp => pd/doc/5.reference}/mtof-help.pd | 0 .../pddp => pd/doc/5.reference}/mtof~-help.pd | 0 pd/doc/5.reference/my_canvas-help.pd | 980 +++++++++++++----- pd/doc/5.reference/namecanvas-help.pd | 61 +- pd/doc/5.reference/netreceive-help.pd | 117 ++- pd/doc/5.reference/netsend-help.pd | 162 ++- pd/doc/5.reference/noise~-help.pd | 80 +- .../doc/5.reference}/notein-help.pd | 0 .../doc/5.reference}/noteout-help.pd | 0 pd/doc/5.reference/numbox2-help.pd | 712 +++++++------ pd/doc/5.reference/openpanel-help.pd | 89 +- pd/doc/5.reference/operators-help.pd | 136 ++- pd/doc/5.reference/osc~-help.pd | 152 ++- pd/doc/5.reference/otherbinops-help.pd | 603 +++++++++-- .../doc/5.reference}/outlet-help.pd | 0 .../doc/5.reference}/outlet~-help.pd | 0 .../doc/5.reference}/output~-help.pd | 0 pd/doc/5.reference/pack-help.pd | 243 ++++- .../doc/5.reference}/parazit-help.pd | 0 pd/doc/5.reference/pd-help.pd | 296 +++--- .../doc/5.reference}/pddp-style-guide.pd | 0 {doc/pddp => pd/doc/5.reference}/pddp_open.pd | 0 .../pddp => pd/doc/5.reference}/pgmin-help.pd | 0 .../doc/5.reference}/pgmout-help.pd | 0 pd/doc/5.reference/phasor~-help.pd | 120 ++- pd/doc/5.reference/pipe-help.pd | 264 ++++- .../pddp => pd/doc/5.reference}/pique-help.pd | 0 pd/doc/5.reference/plot-help.pd | 238 +++-- pd/doc/5.reference/pointer-help.pd | 256 +++-- pd/doc/5.reference/poly-help.pd | 131 ++- .../doc/5.reference}/polytouch-out.pd | 0 .../doc/5.reference}/polytouchin-help.pd | 0 {doc/pddp => pd/doc/5.reference}/pow-help.pd | 0 .../doc/5.reference}/powtodb-help.pd | 0 .../doc/5.reference}/powtodb~-help.pd | 0 pd/doc/5.reference/print-help.pd | 173 +++- pd/doc/5.reference/print~-help.pd | 81 +- pd/doc/5.reference/qlist-help.pd | 201 ++-- pd/doc/5.reference/random-help.pd | 591 ++++++++++- pd/doc/5.reference/readsf~-help.pd | 182 ++-- pd/doc/5.reference/realtime-help.pd | 174 +++- pd/doc/5.reference/receive-help.pd | 211 +++- .../pddp => pd/doc/5.reference}/rev1~-help.pd | 0 .../pddp => pd/doc/5.reference}/rev2~-help.pd | 0 .../pddp => pd/doc/5.reference}/rev3~-help.pd | 0 .../doc/5.reference}/rmstodb-help.pd | 0 .../doc/5.reference}/rmstodb~-help.pd | 0 pd/doc/5.reference/route-help.pd | 113 +- pd/doc/5.reference/rpole~-help.pd | 158 ++- pd/doc/5.reference/rsqrt~-help.pd | 101 +- pd/doc/5.reference/rzero_rev~-help.pd | 155 ++- pd/doc/5.reference/rzero~-help.pd | 151 ++- pd/doc/5.reference/samphold~-help.pd | 147 ++- .../doc/5.reference}/samplerate~-help.pd | 0 pd/doc/5.reference/savepanel-help.pd | 81 +- .../doc/5.reference}/scalar-help.pd | 0 pd/doc/5.reference/select-help.pd | 389 +++++-- pd/doc/5.reference/send-help.pd | 211 +++- pd/doc/5.reference/send~-help.pd | 107 +- pd/doc/5.reference/set-help.pd | 200 ++-- pd/doc/5.reference/setsize-help.pd | 159 ++- pd/doc/5.reference/sigbinops-help.pd | 183 ++-- .../doc/5.reference}/sigmund~-help.pd | 0 pd/doc/5.reference/sig~-help.pd | 84 +- {doc/pddp => pd/doc/5.reference}/sin-help.pd | 0 pd/doc/5.reference/snapshot~-help.pd | 107 +- pd/doc/5.reference/soundfiler-help.pd | 171 +-- pd/doc/5.reference/spigot-help.pd | 204 +++- {doc/pddp => pd/doc/5.reference}/sqrt-help.pd | 0 pd/doc/5.reference/sqrt~-help.pd | 105 +- .../doc/5.reference}/standard_gui_elements.pd | 0 pd/doc/5.reference/stripnote-help.pd | 125 ++- pd/doc/5.reference/struct-help.pd | 179 +++- pd/doc/5.reference/sublist-help.pd | 63 +- pd/doc/5.reference/swap-help.pd | 269 ++++- pd/doc/5.reference/switch~-help.pd | 205 +++- .../doc/5.reference}/symbol-help.pd | 0 .../doc/5.reference}/sysexin-help.pd | 0 .../pddp => pd/doc/5.reference}/table-help.pd | 0 pd/doc/5.reference/tabosc4~-help.pd | 168 ++- pd/doc/5.reference/tabplay~-help.pd | 226 ++-- pd/doc/5.reference/tabread-help.pd | 152 ++- .../doc/5.reference}/tabread4-help.pd | 0 pd/doc/5.reference/tabread4~-help.pd | 6 +- .../doc/5.reference}/tabread~-help.pd | 0 pd/doc/5.reference/tabreceive~-help.pd | 60 +- pd/doc/5.reference/tabsend~-help.pd | 98 +- pd/doc/5.reference/tabwrite-help.pd | 153 ++- pd/doc/5.reference/tabwrite~-help.pd | 138 ++- {doc/pddp => pd/doc/5.reference}/tan-help.pd | 0 .../pddp => pd/doc/5.reference}/test-loop~.pd | 0 pd/doc/5.reference/text-help.pd | 77 +- pd/doc/5.reference/textfile-help.pd | 164 ++- pd/doc/5.reference/threshold~-help.pd | 124 ++- pd/doc/5.reference/throw~-help.pd | 121 ++- .../doc/5.reference}/time_measurements.pd | 0 pd/doc/5.reference/timer-help.pd | 184 +++- pd/doc/5.reference/toggle-help.pd | 648 +++++++----- .../doc/5.reference}/touchin-help.pd | 0 .../doc/5.reference}/touchout-help.pd | 0 pd/doc/5.reference/trigger-help.pd | 426 +++++++- pd/doc/5.reference/unpack-help.pd | 146 ++- pd/doc/5.reference/until-help.pd | 185 +++- pd/doc/5.reference/value-help.pd | 172 ++- pd/doc/5.reference/vcf~-help.pd | 124 ++- pd/doc/5.reference/vdial-help.pd | 47 +- pd/doc/5.reference/vd~-help.pd | 112 +- pd/doc/5.reference/vline~-help.pd | 138 ++- .../doc/5.reference}/vradio-help.pd | 0 pd/doc/5.reference/vslider-help.pd | 727 +++++++------ .../doc/5.reference}/vsnapshot~-help.pd | 0 pd/doc/5.reference/vu-help.pd | 568 ++++++---- {doc/pddp => pd/doc/5.reference}/wrap-help.pd | 0 pd/doc/5.reference/wrap~-help.pd | 90 +- pd/doc/5.reference/writesf~-help.pd | 141 ++- pd/doc/5.reference/x_all_guis.pd | 25 +- {doc/pddp => pd/doc/5.reference}/zexy.pd | 0 394 files changed, 18500 insertions(+), 28472 deletions(-) delete mode 100644 doc/pddp/LICENSE.txt delete mode 100644 doc/pddp/TODO delete mode 100644 doc/pddp/about/GUIs-about.pd delete mode 100644 doc/pddp/about/mapping-about.pd delete mode 100644 doc/pddp/about/pddp-about.pd delete mode 100644 doc/pddp/about/reverb-about.pd delete mode 100644 doc/pddp/acoustics-help.pd delete mode 100644 doc/pddp/acoustics~-help.pd delete mode 100644 doc/pddp/adc~_dac~-help.pd delete mode 100644 doc/pddp/append-help.pd delete mode 100644 doc/pddp/bag-help.pd delete mode 100644 doc/pddp/bang-help.pd delete mode 100644 doc/pddp/bang~-help.pd delete mode 100644 doc/pddp/biquad~-help.pd delete mode 100644 doc/pddp/block~-help.pd delete mode 100644 doc/pddp/bng-help.pd delete mode 100644 doc/pddp/bp~-help.pd delete mode 100644 doc/pddp/canvas-help.pd delete mode 100644 doc/pddp/change-help.pd delete mode 100644 doc/pddp/clip-help.pd delete mode 100644 doc/pddp/clip~-help.pd delete mode 100644 doc/pddp/cos~-help.pd delete mode 100644 doc/pddp/cpole~-help.pd delete mode 100644 doc/pddp/cputime-help.pd delete mode 100644 doc/pddp/czero_rev~-help.pd delete mode 100644 doc/pddp/czero~-help.pd delete mode 100644 doc/pddp/declare-help.pd delete mode 100644 doc/pddp/delay-help.pd delete mode 100644 doc/pddp/delread~-help.pd delete mode 100644 doc/pddp/delwrite~-help.pd delete mode 100644 doc/pddp/drawnumber-help.pd delete mode 100644 doc/pddp/drawpolygon-help.pd delete mode 100644 doc/pddp/element-help.pd delete mode 100644 doc/pddp/env~-help.pd delete mode 100644 doc/pddp/fft~-help.pd delete mode 100644 doc/pddp/float-help.pd delete mode 100644 doc/pddp/framp~-help.pd delete mode 100644 doc/pddp/gatom-help.pd delete mode 100644 doc/pddp/get-help.pd delete mode 100644 doc/pddp/getsize-help.pd delete mode 100644 doc/pddp/graph-help.pd delete mode 100644 doc/pddp/hdial-help.pd delete mode 100644 doc/pddp/hip~-help.pd delete mode 100644 doc/pddp/hslider-help.pd delete mode 100644 doc/pddp/int-help.pd delete mode 100644 doc/pddp/key-help.pd delete mode 100644 doc/pddp/line-help.pd delete mode 100644 doc/pddp/line~-help.pd delete mode 100644 doc/pddp/list-help.pd delete mode 100644 doc/pddp/lop~-help.pd delete mode 100644 doc/pddp/makefilename-help.pd delete mode 100644 doc/pddp/makenote-help.pd delete mode 100644 doc/pddp/math-help.pd delete mode 100644 doc/pddp/message-help.pd delete mode 100644 doc/pddp/midi-help.pd delete mode 100644 doc/pddp/moses-help.pd delete mode 100644 doc/pddp/my_canvas-help.pd delete mode 100644 doc/pddp/namecanvas-help.pd delete mode 100644 doc/pddp/netreceive-help.pd delete mode 100644 doc/pddp/netsend-help.pd delete mode 100644 doc/pddp/noise~-help.pd delete mode 100644 doc/pddp/numbox2-help.pd delete mode 100644 doc/pddp/openpanel-help.pd delete mode 100644 doc/pddp/operators-help.pd delete mode 100644 doc/pddp/osc~-help.pd delete mode 100644 doc/pddp/otherbinops-help.pd delete mode 100644 doc/pddp/pack-help.pd delete mode 100644 doc/pddp/pd-help.pd delete mode 100644 doc/pddp/phasor~-help.pd delete mode 100644 doc/pddp/pipe-help.pd delete mode 100644 doc/pddp/plot-help.pd delete mode 100644 doc/pddp/pointer-help.pd delete mode 100644 doc/pddp/poly-help.pd delete mode 100644 doc/pddp/print-help.pd delete mode 100644 doc/pddp/print~-help.pd delete mode 100644 doc/pddp/qlist-help.pd delete mode 100644 doc/pddp/random-help.pd delete mode 100644 doc/pddp/readsf~-help.pd delete mode 100644 doc/pddp/realtime-help.pd delete mode 100644 doc/pddp/receive-help.pd delete mode 100644 doc/pddp/route-help.pd delete mode 100644 doc/pddp/rpole~-help.pd delete mode 100644 doc/pddp/rsqrt~-help.pd delete mode 100644 doc/pddp/rzero_rev~-help.pd delete mode 100644 doc/pddp/rzero~-help.pd delete mode 100644 doc/pddp/samphold~-help.pd delete mode 100644 doc/pddp/savepanel-help.pd delete mode 100644 doc/pddp/select-help.pd delete mode 100644 doc/pddp/send-help.pd delete mode 100644 doc/pddp/send~-help.pd delete mode 100644 doc/pddp/set-help.pd delete mode 100644 doc/pddp/setsize-help.pd delete mode 100644 doc/pddp/sigbinops-help.pd delete mode 100644 doc/pddp/sig~-help.pd delete mode 100644 doc/pddp/snapshot~-help.pd delete mode 100644 doc/pddp/soundfiler-help.pd delete mode 100644 doc/pddp/spigot-help.pd delete mode 100644 doc/pddp/sqrt~-help.pd delete mode 100644 doc/pddp/stripnote-help.pd delete mode 100644 doc/pddp/struct-help.pd delete mode 100644 doc/pddp/sublist-help.pd delete mode 100644 doc/pddp/swap-help.pd delete mode 100644 doc/pddp/switch~-help.pd delete mode 100644 doc/pddp/tabosc4~-help.pd delete mode 100644 doc/pddp/tabplay~-help.pd delete mode 100644 doc/pddp/tabread-help.pd delete mode 100644 doc/pddp/tabread4~-help.pd delete mode 100644 doc/pddp/tabreceive~-help.pd delete mode 100644 doc/pddp/tabsend~-help.pd delete mode 100644 doc/pddp/tabwrite-help.pd delete mode 100644 doc/pddp/tabwrite~-help.pd delete mode 100644 doc/pddp/templates/+pager.pd delete mode 100644 doc/pddp/templates/example-about.pd delete mode 100644 doc/pddp/templates/example-help.pd delete mode 100644 doc/pddp/templates/template-about.pd delete mode 100644 doc/pddp/templates/template-help.pd delete mode 100644 doc/pddp/templates/template-help_elements.pd delete mode 100644 doc/pddp/text-help.pd delete mode 100644 doc/pddp/textfile-help.pd delete mode 100644 doc/pddp/threshold~-help.pd delete mode 100644 doc/pddp/throw~-help.pd delete mode 100644 doc/pddp/timer-help.pd delete mode 100644 doc/pddp/toggle-help.pd delete mode 100644 doc/pddp/trigger-help.pd delete mode 100644 doc/pddp/unpack-help.pd delete mode 100644 doc/pddp/until-help.pd delete mode 100644 doc/pddp/value-help.pd delete mode 100644 doc/pddp/vcf~-help.pd delete mode 100644 doc/pddp/vdial-help.pd delete mode 100644 doc/pddp/vd~-help.pd delete mode 100644 doc/pddp/vline~-help.pd delete mode 100644 doc/pddp/vslider-help.pd delete mode 100644 doc/pddp/vu-help.pd delete mode 100644 doc/pddp/wrap~-help.pd delete mode 100644 doc/pddp/writesf~-help.pd delete mode 100644 doc/pddp/x_all_guis.pd rename {doc/pddp => pd/doc/5.reference}/Nmop~3pIsdn~tno9V~llV.pd (100%) rename {doc/pddp => pd/doc/5.reference}/abs-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/adc~-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/all_about.pd (100%) rename {doc/pddp => pd/doc/5.reference}/all_about_acoustic_conversions.pd (100%) rename {doc/pddp => pd/doc/5.reference}/all_about_arrays.pd (100%) rename {doc/pddp => pd/doc/5.reference}/all_about_ascii_art.pd (100%) rename {doc/pddp => pd/doc/5.reference}/all_about_atom_conversion.pd (100%) rename {doc/pddp => pd/doc/5.reference}/all_about_atoms.pd (100%) rename {doc/pddp => pd/doc/5.reference}/all_about_canvas_properties.pd (100%) rename {doc/pddp => pd/doc/5.reference}/all_about_data_types.pd (100%) rename {doc/pddp => pd/doc/5.reference}/all_about_dollarsign_zero.pd (100%) rename {doc/pddp => pd/doc/5.reference}/all_about_expr_and_value.pd (100%) rename {doc/pddp => pd/doc/5.reference}/all_about_expr_functions.pd (100%) rename {doc/pddp => pd/doc/5.reference}/all_about_expr_if.pd (100%) rename {doc/pddp => pd/doc/5.reference}/all_about_expr_multiline.pd (100%) rename {doc/pddp => pd/doc/5.reference}/all_about_externals.pd (100%) rename {doc/pddp => pd/doc/5.reference}/all_about_finding_objects.pd (100%) rename {doc/pddp => pd/doc/5.reference}/all_about_getting_help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/all_about_haptics.pd (100%) rename {doc/pddp => pd/doc/5.reference}/all_about_help_patches.pd (100%) rename {doc/pddp => pd/doc/5.reference}/all_about_hid.pd (100%) rename {doc/pddp => pd/doc/5.reference}/all_about_index.pd (100%) rename {doc/pddp => pd/doc/5.reference}/all_about_libraries.pd (100%) rename {doc/pddp => pd/doc/5.reference}/all_about_lists_vs_anythings.pd (100%) rename {doc/pddp => pd/doc/5.reference}/all_about_looping.pd (100%) rename {doc/pddp => pd/doc/5.reference}/all_about_message_conversion.pd (100%) rename {doc/pddp => pd/doc/5.reference}/all_about_messages.pd (100%) rename {doc/pddp => pd/doc/5.reference}/all_about_midi_flags.pd (100%) rename {doc/pddp => pd/doc/5.reference}/all_about_pd_META.pd (100%) rename {doc/pddp => pd/doc/5.reference}/all_about_route.pd (100%) rename {doc/pddp => pd/doc/5.reference}/all_about_scope_and_locality.pd (100%) rename {doc/pddp => pd/doc/5.reference}/all_about_send_n_receive.pd (100%) rename {doc/pddp => pd/doc/5.reference}/all_about_submitting_bugs.pd (100%) rename {doc/pddp => pd/doc/5.reference}/all_about_symbol_construction.pd (100%) rename {doc/pddp => pd/doc/5.reference}/all_about_writing_help_patches.pd (100%) rename {doc/pddp => pd/doc/5.reference}/all_about_z_order.pd (100%) rename {doc/pddp => pd/doc/5.reference}/array-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/atan-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/atan2-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/bendin-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/bendout-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/bonk~-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/catch~-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/choice-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/closebang-abs.pd (100%) rename {doc/pddp => pd/doc/5.reference}/closebang-help.pd (100%) rename {doc/pddp/templates => pd/doc/5.reference}/colour-guide.pd (78%) rename {doc/pddp => pd/doc/5.reference}/complex-mod~-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/cos-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/ctlin-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/ctlout-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/dac~-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/dbtopow-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/dbtopow~-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/dbtorms-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/dbtorms~-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/delread4~-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/drawsymbol-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/dynamic_sends.pd (100%) rename {doc/pddp => pd/doc/5.reference}/exp-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/expr-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/expr~-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/fexpr~-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/fiddle~-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/ftom-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/ftom~-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/glossary.pd (100%) rename {doc/pddp => pd/doc/5.reference}/glossary.txt (100%) rename {doc/pddp => pd/doc/5.reference}/hilbert~-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/hradio-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/import-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/initbang-help-ex1-loadbang.pd (100%) rename {doc/pddp => pd/doc/5.reference}/initbang-help-ex2-initbang.pd (100%) rename {doc/pddp => pd/doc/5.reference}/initbang-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/inlet-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/inlet~-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/intro-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/keyboard_fun.txt (100%) rename {doc/pddp => pd/doc/5.reference}/keyname-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/keyup-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/loadbang-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/log-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/loop~-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/lrshift~-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/max-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/metro-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/midiin-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/midiout-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/min-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/mtof-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/mtof~-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/notein-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/noteout-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/outlet-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/outlet~-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/output~-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/parazit-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/pddp-style-guide.pd (100%) rename {doc/pddp => pd/doc/5.reference}/pddp_open.pd (100%) rename {doc/pddp => pd/doc/5.reference}/pgmin-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/pgmout-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/pique-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/polytouch-out.pd (100%) rename {doc/pddp => pd/doc/5.reference}/polytouchin-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/pow-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/powtodb-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/powtodb~-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/rev1~-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/rev2~-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/rev3~-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/rmstodb-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/rmstodb~-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/samplerate~-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/scalar-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/sigmund~-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/sin-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/sqrt-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/standard_gui_elements.pd (100%) rename {doc/pddp => pd/doc/5.reference}/symbol-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/sysexin-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/table-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/tabread4-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/tabread~-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/tan-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/test-loop~.pd (100%) rename {doc/pddp => pd/doc/5.reference}/time_measurements.pd (100%) rename {doc/pddp => pd/doc/5.reference}/touchin-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/touchout-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/vradio-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/vsnapshot~-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/wrap-help.pd (100%) rename {doc/pddp => pd/doc/5.reference}/zexy.pd (100%) diff --git a/doc/Makefile b/doc/Makefile index d2dad7c43..b0c329d10 100644 --- a/doc/Makefile +++ b/doc/Makefile @@ -182,20 +182,6 @@ pd_fileformat_install: $(manualsdir) pd_fileformat_clean: - -#------------------------------------------------------------------------------# -# PDDP -pddp_install: $(helpdir) - install -p $(doc_src)/pddp/*.pd $(DESTDIR)$(helpdir) -# this file is used in key-help.pd - install -p $(doc_src)/pddp/glossary.txt $(DESTDIR)$(helpdir) - install -p $(doc_src)/pddp/keyboard_fun.txt $(DESTDIR)$(helpdir) - -pddp_clean: - - - - #------------------------------------------------------------------------------# # TUTORIALS tutorials_install: $(manualsdir) diff --git a/doc/pddp/LICENSE.txt b/doc/pddp/LICENSE.txt deleted file mode 100644 index 7f87ef8bc..000000000 --- a/doc/pddp/LICENSE.txt +++ /dev/null @@ -1,340 +0,0 @@ - - GNU GENERAL PUBLIC LICENSE - Version 2, June 1991 - - Copyright (C) 1989, 1991 Free Software Foundation, Inc. - 675 Mass Ave, Cambridge, MA 02139, USA - Everyone is permitted to copy and distribute verbatim copies - of this license document, but changing it is not allowed. - - Preamble - - The licenses for most software are designed to take away your -freedom to share and change it. By contrast, the GNU General Public -License is intended to guarantee your freedom to share and change free -software--to make sure the software is free for all its users. This -General Public License applies to most of the Free Software -Foundation's software and to any other program whose authors commit to -using it. (Some other Free Software Foundation software is covered by -the GNU Library General Public License instead.) You can apply it to -your programs, too. - - When we speak of free software, we are referring to freedom, not -price. Our General Public Licenses are designed to make sure that you -have the freedom to distribute copies of free software (and charge for -this service if you wish), that you receive source code or can get it -if you want it, that you can change the software or use pieces of it -in new free programs; and that you know you can do these things. - - To protect your rights, we need to make restrictions that forbid -anyone to deny you these rights or to ask you to surrender the rights. -These restrictions translate to certain responsibilities for you if you -distribute copies of the software, or if you modify it. - - For example, if you distribute copies of such a program, whether -gratis or for a fee, you must give the recipients all the rights that -you have. You must make sure that they, too, receive or can get the -source code. And you must show them these terms so they know their -rights. - - We protect your rights with two steps: (1) copyright the software, and -(2) offer you this license which gives you legal permission to copy, -distribute and/or modify the software. - - Also, for each author's protection and ours, we want to make certain -that everyone understands that there is no warranty for this free -software. If the software is modified by someone else and passed on, we -want its recipients to know that what they have is not the original, so -that any problems introduced by others will not reflect on the original -authors' reputations. - - Finally, any free program is threatened constantly by software -patents. We wish to avoid the danger that redistributors of a free -program will individually obtain patent licenses, in effect making the -program proprietary. To prevent this, we have made it clear that any -patent must be licensed for everyone's free use or not licensed at all. - - The precise terms and conditions for copying, distribution and -modification follow. - - GNU GENERAL PUBLIC LICENSE - TERMS AND CONDITIONS FOR PDP.LICENSE, DISTRIBUTION AND MODIFICATION - - 0. This License applies to any program or other work which contains -a notice placed by the copyright holder saying it may be distributed -under the terms of this General Public License. The "Program", below, -refers to any such program or work, and a "work based on the Program" -means either the Program or any derivative work under copyright law: -that is to say, a work containing the Program or a portion of it, -either verbatim or with modifications and/or translated into another -language. (Hereinafter, translation is included without limitation in -the term "modification".) Each licensee is addressed as "you". - -Activities other than copying, distribution and modification are not -covered by this License; they are outside its scope. The act of -running the Program is not restricted, and the output from the Program -is covered only if its contents constitute a work based on the -Program (independent of having been made by running the Program). -Whether that is true depends on what the Program does. - - 1. You may copy and distribute verbatim copies of the Program's -source code as you receive it, in any medium, provided that you -conspicuously and appropriately publish on each copy an appropriate -copyright notice and disclaimer of warranty; keep intact all the -notices that refer to this License and to the absence of any warranty; -and give any other recipients of the Program a copy of this License -along with the Program. - -You may charge a fee for the physical act of transferring a copy, and -you may at your option offer warranty protection in exchange for a fee. - - 2. You may modify your copy or copies of the Program or any portion -of it, thus forming a work based on the Program, and copy and -distribute such modifications or work under the terms of Section 1 -above, provided that you also meet all of these conditions: - - a) You must cause the modified files to carry prominent notices - stating that you changed the files and the date of any change. - - b) You must cause any work that you distribute or publish, that in - whole or in part contains or is derived from the Program or any - part thereof, to be licensed as a whole at no charge to all third - parties under the terms of this License. - - c) If the modified program normally reads commands interactively - when run, you must cause it, when started running for such - interactive use in the most ordinary way, to print or display an - announcement including an appropriate copyright notice and a - notice that there is no warranty (or else, saying that you provide - a warranty) and that users may redistribute the program under - these conditions, and telling the user how to view a copy of this - License. (Exception: if the Program itself is interactive but - does not normally print such an announcement, your work based on - the Program is not required to print an announcement.) - -These requirements apply to the modified work as a whole. If -identifiable sections of that work are not derived from the Program, -and can be reasonably considered independent and separate works in -themselves, then this License, and its terms, do not apply to those -sections when you distribute them as separate works. But when you -distribute the same sections as part of a whole which is a work based -on the Program, the distribution of the whole must be on the terms of -this License, whose permissions for other licensees extend to the -entire whole, and thus to each and every part regardless of who wrote it. - -Thus, it is not the intent of this section to claim rights or contest -your rights to work written entirely by you; rather, the intent is to -exercise the right to control the distribution of derivative or -collective works based on the Program. - -In addition, mere aggregation of another work not based on the Program -with the Program (or with a work based on the Program) on a volume of -a storage or distribution medium does not bring the other work under -the scope of this License. - - 3. You may copy and distribute the Program (or a work based on it, -under Section 2) in object code or executable form under the terms of -Sections 1 and 2 above provided that you also do one of the following: - - a) Accompany it with the complete corresponding machine-readable - source code, which must be distributed under the terms of Sections - 1 and 2 above on a medium customarily used for software interchange; or, - - b) Accompany it with a written offer, valid for at least three - years, to give any third party, for a charge no more than your - cost of physically performing source distribution, a complete - machine-readable copy of the corresponding source code, to be - distributed under the terms of Sections 1 and 2 above on a medium - customarily used for software interchange; or, - - c) Accompany it with the information you received as to the offer - to distribute corresponding source code. (This alternative is - allowed only for noncommercial distribution and only if you - received the program in object code or executable form with such - an offer, in accord with Subsection b above.) - -The source code for a work means the preferred form of the work for -making modifications to it. For an executable work, complete source -code means all the source code for all modules it contains, plus any -associated interface definition files, plus the scripts used to -control compilation and installation of the executable. However, as a -special exception, the source code distributed need not include -anything that is normally distributed (in either source or binary -form) with the major components (compiler, kernel, and so on) of the -operating system on which the executable runs, unless that component -itself accompanies the executable. - -If distribution of executable or object code is made by offering -access to copy from a designated place, then offering equivalent -access to copy the source code from the same place counts as -distribution of the source code, even though third parties are not -compelled to copy the source along with the object code. - - 4. You may not copy, modify, sublicense, or distribute the Program -except as expressly provided under this License. Any attempt -otherwise to copy, modify, sublicense or distribute the Program is -void, and will automatically terminate your rights under this License. -However, parties who have received copies, or rights, from you under -this License will not have their licenses terminated so long as such -parties remain in full compliance. - - 5. You are not required to accept this License, since you have not -signed it. However, nothing else grants you permission to modify or -distribute the Program or its derivative works. These actions are -prohibited by law if you do not accept this License. Therefore, by -modifying or distributing the Program (or any work based on the -Program), you indicate your acceptance of this License to do so, and -all its terms and conditions for copying, distributing or modifying -the Program or works based on it. - - 6. Each time you redistribute the Program (or any work based on the -Program), the recipient automatically receives a license from the -original licensor to copy, distribute or modify the Program subject to -these terms and conditions. You may not impose any further -restrictions on the recipients' exercise of the rights granted herein. -You are not responsible for enforcing compliance by third parties to -this License. - - 7. If, as a consequence of a court judgment or allegation of patent -infringement or for any other reason (not limited to patent issues), -conditions are imposed on you (whether by court order, agreement or -otherwise) that contradict the conditions of this License, they do not -excuse you from the conditions of this License. If you cannot -distribute so as to satisfy simultaneously your obligations under this -License and any other pertinent obligations, then as a consequence you -may not distribute the Program at all. For example, if a patent -license would not permit royalty-free redistribution of the Program by -all those who receive copies directly or indirectly through you, then -the only way you could satisfy both it and this License would be to -refrain entirely from distribution of the Program. - -If any portion of this section is held invalid or unenforceable under -any particular circumstance, the balance of the section is intended to -apply and the section as a whole is intended to apply in other -circumstances. - -It is not the purpose of this section to induce you to infringe any -patents or other property right claims or to contest validity of any -such claims; this section has the sole purpose of protecting the -integrity of the free software distribution system, which is -implemented by public license practices. Many people have made -generous contributions to the wide range of software distributed -through that system in reliance on consistent application of that -system; it is up to the author/donor to decide if he or she is willing -to distribute software through any other system and a licensee cannot -impose that choice. - -This section is intended to make thoroughly clear what is believed to -be a consequence of the rest of this License. - - 8. If the distribution and/or use of the Program is restricted in -certain countries either by patents or by copyrighted interfaces, the -original copyright holder who places the Program under this License -may add an explicit geographical distribution limitation excluding -those countries, so that distribution is permitted only in or among -countries not thus excluded. In such case, this License incorporates -the limitation as if written in the body of this License. - - 9. The Free Software Foundation may publish revised and/or new versions -of the General Public License from time to time. Such new versions will -be similar in spirit to the present version, but may differ in detail to -address new problems or concerns. - -Each version is given a distinguishing version number. If the Program -specifies a version number of this License which applies to it and "any -later version", you have the option of following the terms and conditions -either of that version or of any later version published by the Free -Software Foundation. If the Program does not specify a version number of -this License, you may choose any version ever published by the Free Software -Foundation. - - 10. If you wish to incorporate parts of the Program into other free -programs whose distribution conditions are different, write to the author -to ask for permission. For software which is copyrighted by the Free -Software Foundation, write to the Free Software Foundation; we sometimes -make exceptions for this. Our decision will be guided by the two goals -of preserving the free status of all derivatives of our free software and -of promoting the sharing and reuse of software generally. - - NO WARRANTY - - 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY -FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN -OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES -PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED -OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF -MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS -TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE -PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, -REPAIR OR CORRECTION. - - 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING -WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR -REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, -INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING -OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED -TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY -YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER -PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE -POSSIBILITY OF SUCH DAMAGES. - - END OF TERMS AND CONDITIONS - - Appendix: How to Apply These Terms to Your New Programs - - If you develop a new program, and you want it to be of the greatest -possible use to the public, the best way to achieve this is to make it -free software which everyone can redistribute and change under these terms. - - To do so, attach the following notices to the program. It is safest -to attach them to the start of each source file to most effectively -convey the exclusion of warranty; and each file should have at least -the "copyright" line and a pointer to where the full notice is found. - - <one line to give the program's name and a brief idea of what it does.> - Copyright (C) 19yy <name of author> - - This program is free software; you can redistribute it and/or modify - it under the terms of the GNU General Public License as published by - the Free Software Foundation; either version 2 of the License, or - (at your option) any later version. - - This program is distributed in the hope that it will be useful, - but WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - GNU General Public License for more details. - - You should have received a copy of the GNU General Public License - along with this program; if not, write to the Free Software - Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. - -Also add information on how to contact you by electronic and paper mail. - -If the program is interactive, make it output a short notice like this -when it starts in an interactive mode: - - Gnomovision version 69, Copyright (C) 19yy name of author - Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'. - This is free software, and you are welcome to redistribute it - under certain conditions; type `show c' for details. - -The hypothetical commands `show w' and `show c' should show the appropriate -parts of the General Public License. Of course, the commands you use may -be called something other than `show w' and `show c'; they could even be -mouse-clicks or menu items--whatever suits your program. - -You should also get your employer (if you work as a programmer) or your -school, if any, to sign a "copyright disclaimer" for the program, if -necessary. Here is a sample; alter the names: - - Yoyodyne, Inc., hereby disclaims all copyright interest in the program - `Gnomovision' (which makes passes at compilers) written by James Hacker. - - <signature of Ty Coon>, 1 April 1989 - Ty Coon, President of Vice - -This General Public License does not permit incorporating your program into -proprietary programs. If your program is a subroutine library, you may -consider it more useful to permit linking proprietary applications with the -library. If this is what you want to do, use the GNU Library General -Public License instead of this License. diff --git a/doc/pddp/TODO b/doc/pddp/TODO deleted file mode 100644 index 00278f013..000000000 --- a/doc/pddp/TODO +++ /dev/null @@ -1,13 +0,0 @@ - -- create message-help.pd, namecanvas-help.pd and all_about_messages which - include [namecanvas] and the additional/pd-msg docs - -- check pddplinks to manuals folder (e.g., in all_about_getting_help.pd) - -- improve glossary - -- finish all_about_externals.pd - -- finish all_about_libraries.pd - -- update PDDP guidelines (or remove it) diff --git a/doc/pddp/about/GUIs-about.pd b/doc/pddp/about/GUIs-about.pd deleted file mode 100644 index 8baff1edc..000000000 --- a/doc/pddp/about/GUIs-about.pd +++ /dev/null @@ -1,88 +0,0 @@ -#N canvas 293 91 803 616 10; -#X obj 57 73 bng 15 250 50 0 \$1 \$1 empty 20 8 0 8 -262144 -1 -1; -#X obj 57 105 tgl 15 1.04858e+06 \$2 \$2 empty 20 8 0 8 -262144 -1 --1 0 1; -#X obj 56 137 vsl 15 128 0 127 0 1.04858e+06 \$3 \$3 empty 20 8 0 8 --262144 -1 -1 0 1; -#X obj 99 72 hsl 128 15 0 127 0 0 \$4 \$4 empty 20 8 0 8 -262144 -1 --1 0 1; -#X obj 97 105 hdl 15 1 2.6624e+06 8 \$5 \$5 empty 20 8 192 8 -262144 --1 -1 0; -#X obj 96 141 vu 15 120 \$6 empty 35 8 0 8 -66577 -1 1 0; -#X obj 149 141 cnv 15 100 60 \$7 \$7 \$7 20 12 0 14 -233017 -66577 -1.04858e+06; -#X obj 261 72 vdl 15 1 4.79232e+06 8 \$9 \$9 empty 20 8 192 8 -262144 --1 -1 0; -#X obj 150 218 nbx 5 14 -1e+37 1e+37 0 0 \$8 \$8 empty 45 7 0 10 -262144 --1 -1 0 256; -#X text 8 22 Pd comes with a standard \, built-in set of GUI elements -\, which you can select from the "Put" menu.; -#X text 16 332 There are also some OS-native GUI elements available -; -#X text 403 521 Graph-On-Parent aka GOP is an essential element for -building elaborate GUIs in Pd.; -#X obj 44 372 button OK; -#X obj 142 376 popup 124 25 #ffffff popup option; -#X text 23 348 [button]:; -#X text 129 350 [popup]:; -#X text 424 22 [unauthorized/playlist]:; -#X text 605 28 [unauthorized/grid]:; -#X obj 78 303 cnv-edit; -#X text 16 283 You can edit the look of the above GUI elements with -this editor:; -#X text 412 464 toxy's [tot] \, [tow] \, and [widget]; -#X obj 463 53 playlist all 100 100 {Helvetica 10 bold} #457782 yellow -black red; -#X obj 632 47 grid grid1 100 0 199 100 0 199 1 1 1 10 10 710 57; -#X text 17 427 cyclone has some clones of Max GUI objects:; -#X obj 53 456 Scope~ 130 130 256 3 128 -1 1 0 0 0 0 102 255 51 135 -135 135 0; -#X text 19 440 [cyclone/Scope~]:; -#N canvas 308 82 645 525 More 0; -#X text 440 185 [gcanvas]:; -#X obj 452 218 gcanvas 80 80; -#X obj 64 208 probalizer 100 100 100 100 1 0 10 1 10 2 10 3 10 4 10 -5 10 6 10 7 10 8 10 9 10 10 10 11 10 12 10 13 10 14 10 15 10 16 10 -17 10 18 10 19 10 20 10 21 10 22 10 23 10 24 10 25 10 26 10 27 10 28 -10 29 10 30 50 31 50 32 10 33 10 34 10 35 10 36 10 37 10 38 10 39 10 -40 10 41 10 42 10 43 10 44 10 45 10 46 10 47 10 48 10 49 10 50 10 51 -10 52 10 53 10 54 10 55 10 56 10 57 10 58 10 59 10 60 10 61 10 62 10 -63 10 64 54 65 10 66 10 67 55 68 10 69 10 70 10 71 10 72 10 73 10 74 -10 75 10 76 76 77 10 78 10 79 10 80 10 81 10 82 10 83 10 84 10 85 10 -86 10 87 10 88 10 89 10 90 10 91 10 92 10 93 10 94 10 95 10 96 10 97 -10 98 10 99 32; -#X text 17 188 [unauthorized/probalizer]:; -#X obj 319 265 image logo100.gif; -#X text 257 189 [image]:; -#X obj 443 41 entry 124 100 grey70 yellow; -#X text 438 6 [entry]:; -#X text 31 26 [unauthorized_scratcher~]:; -#X text 222 28 [unauthorized/audience~]:; -#X obj 75 45 scratcher~ 88200 100 100 25 2 0.01; -#X obj 261 47 audience~ 100 100 4 2 0.01 0 48 10 97 10 146 10 195 10 -0 190 195 190; -#X obj -1 -1 cooled~ 1024 300 100 1; -#X text 292 363 [unauthorized/cooled~]:; -#X text 8 361 LINK: [unauthorized/pianoroll]:; -#X text 6 343 Some are crash-prone:; -#X restore 487 495 pd More GUI elements; -#X obj 298 372 ticker ; -#X obj 516 347 state; -#X text 412 347 State saving:; -#X text 565 344 memento!; -#X obj 521 187 envgen 200 140 1 0 ; -#X text 404 440 libraries: cyclone \, ggee \, unauthorized; -#X text 398 567 data structures!; -#X obj 247 479 comment 0 10 helvetica ? 0 0 0 0 this is a comment; -#X text 195 462 [cyclone/comment]:; -#X obj 440 223 knob 32 32 0 127 0 0 empty empty empty 0 -8 32 8 -262144 --1 -1 0 1; -#X text 434 197 [knob]; -#X obj 569 397 sliderh 127 0 15; -#X text 591 374 [ggee/sliderh]; -#X text 281 349 [ggee/ticker]:; -#X text 501 163 [env/envgen]:; -#X obj 744 326 slider 127 0 15; -#X text 699 480 [ggee/slider]; -#X text 412 371 [ggee/toddle]; -#X obj 446 401 toddle black 15 15; diff --git a/doc/pddp/about/mapping-about.pd b/doc/pddp/about/mapping-about.pd deleted file mode 100644 index 63eeb30ba..000000000 --- a/doc/pddp/about/mapping-about.pd +++ /dev/null @@ -1,292 +0,0 @@ -#N canvas 209 116 779 549 10; -#X obj 0 0 cnv 15 750 17 empty empty Mapping 10 9 0 16 -233017 -66577 -0; -#X obj 305 18 cnv 15 445 15 empty empty Getting_your_message_across -10 7 0 12 -217069 -33289 0; -#X obj 305 230 cnv 15 445 15 empty empty Broadcasting_with_sends_and_receives -10 7 0 12 -217069 -33289 0; -#X obj 305 18 cnv 5 5 500 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X obj 0 500 cnv 15 750 20 bs br PDDP_Project_2005 10 10 0 14 -217069 --1 0; -#N canvas 0 22 454 304 META 0; -#X restore 151 502 pd META; -#N canvas 696 168 524 404 PAGES 0; -#X text 19 9 Put your pages here: (They must be named [pd PAGE1] [pd -PAGE2]... (PAGE0 is the main patch).; -#N canvas 93 122 779 548 PAGE4 0; -#X obj 0 0 cnv 15 750 17 empty empty Mapping 10 9 0 16 -233017 -66577 -0; -#X obj 6 328 cnv 15 300 15 empty empty Related_Objects 10 7 0 12 -217069 --33289 0; -#X obj 0 500 cnv 15 750 20 bs br PDDP_2005 10 10 0 14 -217069 -1 0 -; -#X obj 624 503 bng 15 250 50 0 \$0-previous \$0- Previous -60 8 0 12 --262144 -1 -1; -#X obj 644 503 cnv 15 15 15 empty empty 4 0 8 0 12 -217069 -1 0; -#X obj 660 503 cnv 15 15 15 empty empty of 0 8 0 12 -217069 -1 0; -#X obj 676 503 cnv 15 25 15 empty 1000-page_count 4 4 8 0 12 -217069 --1 0; -#X obj 692 503 bng 15 250 50 0 \$0-next \$0- Next 20 8 0 12 -262144 --1 -1; -#X obj 745 0 cnv 5 5 500 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X obj 0 0 cnv 5 5 500 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X obj 305 16 cnv 5 5 485 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X text 38 388 LINK: universal-help.pd; -#X obj 18 361 cnv 15 100 17 empty empty cyclone 3 9 0 12 -233017 -1 -0; -#X text 39 447 LINK: send13-help.pd; -#X text 39 467 LINK: receive13-help.pd; -#X obj 18 421 cnv 15 100 17 empty empty ext13 3 9 0 12 -233017 -1 0 -; -#X obj 305 378 cnv 15 445 15 empty empty More_Info 10 7 0 12 -217069 --33289 0; -#X text 345 401 LINK: spiffy example; -#X text 345 416 LINK: Scope and Locality; -#X text 345 432 LINK: pd-msg docs; -#X obj 305 18 cnv 15 445 15 empty empty Sending_And_Receiving_from_Pd_itself -10 7 0 12 -217069 -33289 0; -#X text 358 70 blah blah blah \, no text here yet.; -#X text 17 123 Or draw your own curve:; -#X obj 192 72 curve_graph; -#X restore 158 56 pd PAGE4; -#N canvas 184 134 785 547 PAGE3 0; -#X obj -70 0 cnv 15 750 17 empty empty Mapping 10 9 0 16 -233017 -66577 -0; -#X obj 235 18 cnv 15 445 15 empty empty Internal_sends_and_receives -10 7 0 12 -217069 -33289 0; -#X obj 235 18 cnv 5 5 500 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X obj -70 500 cnv 15 750 20 bs br PDDP_2005 10 10 0 14 -217069 -1 -0; -#X obj 554 503 bng 15 250 50 0 \$0-previous \$0- Previous -60 8 0 12 --262144 -1 -1; -#X obj 574 503 cnv 15 15 15 empty empty 3 0 8 0 12 -217069 -1 0; -#X obj 590 503 cnv 15 15 15 empty empty of 0 8 0 12 -217069 -1 0; -#X obj 606 503 cnv 15 25 15 empty 1000-page_count 4 4 8 0 12 -217069 --1 0; -#X obj 622 503 bng 15 250 50 0 \$0-next \$0- Next 20 8 0 12 -262144 --1 -1; -#X obj 235 200 cnv 15 445 15 empty empty Explicit_vs_hidden 10 7 0 -12 -217069 -33289 0; -#N canvas 0 22 450 300 graph1 0; -#X array \$0-sin 100 float 0; -#X coords 0 1 99 -1 100 100 1; -#X restore 127 98 graph; -#N canvas 0 22 450 300 graph1 0; -#X array \$0-cos 100 float 0; -#X coords 0 1 99 -1 100 100 1; -#X restore 127 217 graph; -#N canvas 0 22 450 300 graph1 0; -#X array \$0-atan 100 float 0; -#X coords 0 1 99 -1 100 100 1; -#X restore 127 337 graph; -#N canvas 0 22 450 300 graph1 0; -#X array \$0s 100 float 0; -#X coords 0 1 99 0 100 100 1; -#X restore -70 98 graph; -#N canvas 0 22 450 300 graph1 0; -#X array \$0c 100 float 0; -#X coords 0 1 99 0 100 100 1; -#X restore -70 217 graph; -#N canvas 0 22 450 300 graph1 0; -#X array \$0a 100 float 0; -#X coords 0 1 99 0 100 100 1; -#X restore -70 337 graph; -#X text 54 77 range; -#X text 151 78 -1 to 1; -#X text -43 77 0 to 1; -#N canvas 487 55 717 697 draw_arrays 0; -#X msg 77 62 bang; -#X obj 77 83 until; -#X text 108 62 start; -#X obj 77 105 f; -#X obj 106 105 + 1; -#X obj 152 107 sel 0; -#X obj 106 127 mod 100; -#X obj 77 23 loadbang; -#X obj 77 156 trigger float float; -#X obj 77 217 / 50; -#X obj 77 191 - 50; -#X obj 483 211 float; -#X obj 18 217 / 100; -#X obj 149 38 metro 5000; -#X obj 149 19 loadbang; -#X obj 183 255 tabwrite \$0-sin; -#X obj 183 300 tabwrite \$0-cos; -#X obj 183 351 tabwrite \$0-atan; -#X obj 183 445 tabwrite \$0s; -#X obj 183 485 tabwrite \$0c; -#X obj 183 536 tabwrite \$0a; -#X obj 183 236 sinusoid sin; -#X obj 183 281 sinusoid cos; -#X obj 183 332 sinusoid atan; -#X obj 183 420 sinusoid sin; -#X obj 183 466 sinusoid cos; -#X obj 183 517 sinusoid atan; -#X connect 0 0 1 0; -#X connect 1 0 3 0; -#X connect 3 0 4 0; -#X connect 3 0 8 0; -#X connect 4 0 6 0; -#X connect 5 0 1 1; -#X connect 6 0 3 1; -#X connect 6 0 5 0; -#X connect 7 0 0 0; -#X connect 8 0 10 0; -#X connect 8 0 12 0; -#X connect 8 1 11 0; -#X connect 9 0 21 0; -#X connect 9 0 22 0; -#X connect 9 0 23 0; -#X connect 10 0 9 0; -#X connect 11 0 15 1; -#X connect 11 0 16 1; -#X connect 11 0 17 1; -#X connect 11 0 18 1; -#X connect 11 0 19 1; -#X connect 11 0 20 1; -#X connect 12 0 24 0; -#X connect 12 0 25 0; -#X connect 12 0 26 0; -#X connect 13 0 0 0; -#X connect 14 0 13 0; -#X connect 21 0 15 0; -#X connect 22 0 16 0; -#X connect 23 0 17 0; -#X connect 24 0 18 0; -#X connect 25 0 19 0; -#X connect 26 0 20 0; -#X restore 36 502 pd draw_arrays; -#X text 151 198 -1 to 1; -#X text -43 197 0 to 1; -#X text 151 318 -1 to 1; -#X text -43 317 0 to 1; -#X text 151 438 -1 to 1; -#X text -43 437 0 to 1; -#X obj 32 98 sinusoid sin; -#X obj 36 218 sinusoid cos; -#X obj 32 337 sinusoid atan; -#X restore 95 56 pd PAGE3; -#X text 9 109 Don't forget to set \$0 and the number of pages \, including -the main page.; -#X obj 26 156 pddp_page \$0 4; -#N canvas 137 150 787 558 PAGE2 0; -#X obj 0 0 cnv 15 750 17 empty empty Mapping 10 9 0 16 -233017 -66577 -0; -#X obj 305 18 cnv 15 445 15 empty empty Getting_your_message_across -10 7 0 12 -217069 -33289 0; -#X obj 305 230 cnv 15 445 15 empty empty Broadcasting_with_sends_and_receives -10 7 0 12 -217069 -33289 0; -#X obj 305 18 cnv 5 5 500 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X obj 0 500 cnv 15 750 20 bs br PDDP_Project_2005 10 10 0 14 -217069 --1 0; -#X obj 624 503 bng 15 250 50 0 \$0-previous \$0- Previous -60 8 0 12 --262144 -1 -1; -#X obj 644 503 cnv 15 15 15 empty empty 2 0 8 0 12 -217069 -1 0; -#X obj 660 503 cnv 15 15 15 empty empty of 0 8 0 12 -217069 -1 0; -#X obj 676 503 cnv 15 25 15 empty \$0-page_count 4 4 8 0 12 -217069 --1 0; -#X obj 692 503 bng 15 250 50 0 \$0-next \$0- Next 20 8 0 12 -262144 --1 -1; -#N canvas 0 22 450 300 graph1 0; -#X array \$0-curve 200 float 0; -#X coords 0 1 199 -1 200 200 1; -#X restore 87 181 graph; -#X floatatom 46 58 8 0 0 0 - - -; -#X floatatom 46 129 8 0 0 0 - - -; -#X obj 49 146 hsl 200 15 0 1 0 0 empty empty empty 22 8 1 12 -262144 --1 -1 0 1; -#X obj 49 38 hsl 200 15 0 1 0 0 empty empty empty 22 8 1 12 -261681 --1 -1 0 1; -#N canvas 721 196 411 401 draw_array 0; -#X msg 54 82 bang; -#X obj 54 103 until; -#X text 85 82 start; -#X obj 54 125 f; -#X obj 83 125 + 1; -#X obj 54 43 loadbang; -#X text 96 257 mapping output range: -1 to 1; -#X obj 54 180 trigger float float; -#X obj 127 127 select 0; -#X obj 53 313 tabwrite \$0-curve; -#X obj 138 9 inlet; -#X obj 153 32 send \$0-to-numbox; -#X obj 139 53 trigger bang float; -#X obj 53 283 curve; -#X obj 83 147 mod 200; -#X obj 53 229 - 100; -#X obj 54 257 / 100; -#X connect 0 0 1 0; -#X connect 1 0 3 0; -#X connect 3 0 4 0; -#X connect 3 0 7 0; -#X connect 4 0 14 0; -#X connect 5 0 0 0; -#X connect 7 0 15 0; -#X connect 7 1 9 1; -#X connect 8 0 1 1; -#X connect 10 0 11 0; -#X connect 10 0 12 0; -#X connect 12 0 0 0; -#X connect 12 1 13 1; -#X connect 13 0 9 0; -#X connect 14 0 3 1; -#X connect 14 0 8 0; -#X connect 15 0 16 0; -#X connect 16 0 13 0; -#X restore 116 109 pd draw_array; -#X obj 74 84 hsl 128 15 -1 1 0 1 empty empty empty -2 -6 0 8 -225271 --1 -1 3600 0; -#X floatatom 213 85 7 0 0 0 - #0-to-numbox -; -#X obj 46 108 curve; -#X connect 11 0 18 0; -#X connect 12 0 13 0; -#X connect 14 0 11 0; -#X connect 16 0 15 0; -#X connect 16 0 18 1; -#X connect 18 0 12 0; -#X restore 31 56 pd PAGE2; -#X coords 0 0 1.01598e-05 1.58148e-05 96 15 0; -#X restore 208 502 pd PAGES; -#X obj 624 503 bng 15 250 50 0 \$0-previous \$0- Previous -60 8 0 12 --262144 -1 -1; -#X obj 644 503 cnv 15 15 15 empty empty 1 0 8 0 12 -217069 -1 0; -#X obj 660 503 cnv 15 15 15 empty empty of 0 8 0 12 -217069 -1 0; -#X obj 676 503 cnv 15 25 15 empty \$0-page_count 4 4 8 0 12 -217069 --1 0; -#X obj 692 503 bng 15 250 50 0 \$0-next \$0- Next 20 8 0 12 -262144 --1 -1; -#X obj 187 69 hid_rel2abs; -#X obj 17 112 hid_smooth; -#X obj 17 47 notescale; -#X obj 95 69 hid_centered; -#X obj 17 158 buttongate; -#X obj 96 158 keygate; -#X obj 96 112 hid_average; -#X text 9 28 SCALING AND RANGING; -#X text 9 95 SMOOTHING; -#X obj 93 47 autoscale; -#X text 9 141 BASIC CONTROLS; -#X text 10 182 ONE-TO-MANY MAPPING; -#X obj 17 207 hid_one2two; -#X obj 102 207 hid_one2three; -#X text 9 231 POLAR COORDINATES; -#X text 9 275 ANGLE CONVERSIONS; -#X obj 181 112 hid_lowpass; -#X obj 201 207 hid_one2four; -#X obj 17 69 reverse; -#X obj 67 248 polar; -#X obj 110 248 spiral; -#X obj 17 248 vector; -#X text 9 340 CURVES; -#X obj 18 366 curve; -#X obj 62 366 sinusoid; -#X obj 141 295 radians->mapping; -#X obj 143 315 degrees->mapping; -#X obj 18 295 mapping->radians; -#X obj 18 315 mapping->degrees; diff --git a/doc/pddp/about/pddp-about.pd b/doc/pddp/about/pddp-about.pd deleted file mode 100644 index 138aa6a74..000000000 --- a/doc/pddp/about/pddp-about.pd +++ /dev/null @@ -1,35 +0,0 @@ -#N canvas 298 124 492 628 10; -#X text 25 119 The PDDP was proposed initially in early 2002 by Krzysztof -Czaja who suggested that Pure Data was in need of comprehensive documentation. -; -#X text 45 231 - Michal Seta; -#X text 45 204 - Miller Puckette; -#X text 45 217 - Dave Sabine; -#X text 14 374 THINGS TO NOTE:; -#X text 25 480 Externals and other Libraries: Each PDDP document includes -mention of "related objects from other Pd libraries" as well as mention -of "related native Pd objects". The objects from other libraries are -available only if you download those libraries from their respective -authors and integrate them properly into your version of Pd. We do -not and cannot maintain a complete list of externals - but we try. -For more info about externals and other objects \, see http://www.puredata.org/ -and the Pure Data Base at http://iem.kug.ac.at/pdb/; -#X text 45 245 - Hans-Christoph Steiner; -#X text 25 315 All comments \, corrections \, etc. regarding the PDDP -reference files should be directed to the Pd Developers' list: pd-dev@iem.at -; -#X text 26 265 PDDP is now part of the CVS Pd distributions. It was -originally available at Dave's web site: http://www.davesabine.com/media/puredata.asp -; -#X obj 3 2 cnv 15 450 20 empty empty PDDP 2 12 1 18 -233017 -66577 -0; -#X text 102 5 Pure Data Documentation Project; -#X obj 25 38 pddp_open table_of_contents; -#X text 25 392 Authors: If you would like to participate in this project -\, simply gather together information about objects \, tutorials \, -examples \, etc. and email pd-dev@iem.at for info about formatting -your documents. All documents should be committed to the CVS so that -they will be included in future releases.; -#X text 25 168 The project was originally managed by Dave Sabine. The -people involved in this project include (alphabetically):; -#X obj 25 67 pddp_open glossary; diff --git a/doc/pddp/about/reverb-about.pd b/doc/pddp/about/reverb-about.pd deleted file mode 100644 index 7bf5ca1f1..000000000 --- a/doc/pddp/about/reverb-about.pd +++ /dev/null @@ -1,5 +0,0 @@ -#N canvas 0 22 454 304 10; -#X obj 101 233 freeverb~; -#X obj 109 92 rev1~; -#X obj 105 124 rev2~; -#X obj 104 157 rev3~; diff --git a/doc/pddp/acoustics-help.pd b/doc/pddp/acoustics-help.pd deleted file mode 100644 index fb51d40fa..000000000 --- a/doc/pddp/acoustics-help.pd +++ /dev/null @@ -1,100 +0,0 @@ -#N canvas 171 163 561 481 10; -#X obj 0 451 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 acoustics 3 12 0 -18 -204280 -1 0; -#X obj 0 289 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 317 389 404 227 META 0; -#X text 12 85 LIBRARY internal; -#X text 12 125 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 45 LICENSE SIBSD; -#X text 12 105 AUTHOR Miller Puckette; -#X text 12 165 HELP_PATCH_AUTHORS Updated for pd version 0.40. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 25 KEYWORDS control conversion MIDI; -#X text 12 5 NAME mtof ftom dbtorms rmstodb dbtopow powtodb; -#X text 12 65 DESCRIPTION control objects for conversion; -#X text 12 145 RELEASE_DATE 1997; -#X restore 500 453 pd META; -#X obj 0 359 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 392 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 421 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#X obj 78 298 cnv 17 3 55 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 396 (none); -#N canvas 79 451 428 163 Related_objects 0; -#X text 19 37 Control objects for conversion:; -#X obj 59 66 dbtorms; -#X obj 113 66 rmstodb; -#X obj 167 66 dbtopow; -#X obj 222 66 powtodb; -#X obj 22 125 mtof~; -#X obj 67 125 ftom~; -#X obj 110 125 dbtorms~; -#X obj 175 125 rmstodb~; -#X obj 241 125 dbtopow~; -#X obj 303 125 powtodb~; -#X text 19 102 Signal objects for conversion:; -#X obj 22 66 mtof; -#X obj 0 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 1 [ftom] Related Objects; -#X restore 221 453 pd Related_objects; -#X obj 78 368 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 297 float; -#X text 98 324 list; -#X text 98 368 float; -#X text 158 324 - lists will be truncated \, and the first element -will be used as input.; -#X obj 392 203 ftom; -#X obj 392 151 mtof; -#X floatatom 392 123 0 0 0 0 - - -; -#X floatatom 392 178 0 0 0 0 - - -; -#X floatatom 392 227 0 0 0 0 - - -; -#X floatatom 231 123 0 0 0 0 - - -; -#X floatatom 231 178 0 0 0 0 - - -; -#X floatatom 231 227 0 0 0 0 - - -; -#X obj 231 151 dbtorms; -#X obj 231 203 rmstodb; -#X floatatom 58 123 0 0 0 0 - - -; -#X floatatom 58 178 0 0 0 0 - - -; -#X floatatom 58 227 0 0 0 0 - - -; -#X obj 58 151 dbtopow; -#X obj 58 203 powtodb; -#X obj 258 10 mtof; -#X obj 294 10 ftom; -#X obj 330 11 dbtorms; -#X obj 386 11 rmstodb; -#X obj 440 11 dbtopow; -#X obj 497 11 powtodb; -#X text 11 23 control objects for conversion; -#X obj 110 150 pddp/pddplink dbtopow-help.pd -text dbtopow-help; -#X obj 110 204 pddp/pddplink powtodb-help.pd -text powtodb-help; -#X obj 282 150 pddp/pddplink dbtorms-help.pd -text dbtorms-help; -#X obj 282 204 pddp/pddplink rmstodb-help.pd -text rmstodb-help; -#X obj 426 150 pddp/pddplink ftom-help.pd -text ftom-help; -#X obj 426 204 pddp/pddplink mtof-help.pd -text mtof-help; -#X text 158 297 - the incoming value.; -#X obj 98 425 pddp/pddplink all_about_acoustic_conversions.pd; -#X text 87 79 Click on the links next to each object for more help: -; -#X obj 4 453 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X connect 15 0 19 0; -#X connect 16 0 18 0; -#X connect 17 0 16 0; -#X connect 18 0 15 0; -#X connect 20 0 23 0; -#X connect 21 0 24 0; -#X connect 23 0 21 0; -#X connect 24 0 22 0; -#X connect 25 0 28 0; -#X connect 26 0 29 0; -#X connect 28 0 26 0; -#X connect 29 0 27 0; diff --git a/doc/pddp/acoustics~-help.pd b/doc/pddp/acoustics~-help.pd deleted file mode 100644 index 5a1b63429..000000000 --- a/doc/pddp/acoustics~-help.pd +++ /dev/null @@ -1,124 +0,0 @@ -#N canvas 426 33 558 622 10; -#X obj 0 595 cnv 15 550 21 empty \$0-pddp.cnv.footer empty 20 12 0 -14 -228856 -66577 0; -#X obj 0 0 cnv 15 550 40 empty \$0-pddp.cnv.header (acoustics~) 3 12 -0 18 -204280 -1 0; -#X obj 0 424 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 569 391 408 239 META 0; -#X text 12 85 LIBRARY internal; -#X text 12 125 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 45 LICENSE SIBSD; -#X text 12 105 AUTHOR Miller Puckette; -#X text 12 165 HELP_PATCH_AUTHORS Updated for pd version 0.40. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 25 KEYWORDS signal conversion MIDI; -#X text 12 65 DESCRIPTION signal objects for conversion; -#X text 12 5 NAME mtof~ ftom~ dbtorms~ rmstodb~ dbtopow~ powtodb~; -#X text 12 145 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 499 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 536 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 565 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#X obj 78 433 cnv 17 3 55 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 540 (none); -#N canvas 339 468 428 163 Related_objects 0; -#X text 19 37 Control objects for conversion:; -#X obj 59 66 dbtorms; -#X obj 113 66 rmstodb; -#X obj 167 66 dbtopow; -#X obj 222 66 powtodb; -#X obj 22 125 mtof~; -#X obj 67 125 ftom~; -#X obj 110 125 dbtorms~; -#X obj 175 125 rmstodb~; -#X obj 241 125 dbtopow~; -#X obj 303 125 powtodb~; -#X text 19 102 Signal objects for conversion:; -#X obj 22 66 mtof; -#X obj 0 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 1 (acoustics) Related Objects; -#X restore 223 598 pd Related_objects; -#X obj 78 508 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 11 23 signal objects for conversion; -#X text 98 432 signal; -#X text 98 508 signal; -#X text 158 508 - the outgoing signal.; -#X text 158 432 - the incoming signal.; -#X floatatom 68 136 0 0 0 0 - - -; -#X obj 68 160 dbtopow~; -#X obj 67 217 snapshot~; -#X floatatom 67 246 0 0 0 0 - - -; -#X obj 67 294 powtodb~; -#X obj 67 341 snapshot~; -#X floatatom 67 368 0 0 0 0 - - -; -#X obj 237 11 mtof~; -#X obj 276 11 ftom~; -#X obj 315 11 dbtorms~; -#X obj 372 11 rmstodb~; -#X obj 429 11 dbtopow~; -#X obj 486 11 powtodb~; -#X floatatom 248 136 0 0 0 0 - - -; -#X obj 247 217 snapshot~; -#X floatatom 247 246 0 0 0 0 - - -; -#X obj 247 341 snapshot~; -#X floatatom 247 368 0 0 0 0 - - -; -#X obj 248 160 dbtorms~; -#X obj 247 294 rmstodb~; -#X floatatom 418 136 0 0 0 0 - - -; -#X obj 417 217 snapshot~; -#X floatatom 417 246 0 0 0 0 - - -; -#X obj 417 341 snapshot~; -#X floatatom 417 368 0 0 0 0 - - -; -#X obj 418 160 ftom~; -#X obj 417 294 mtof~; -#X obj 29 190 bang~; -#X obj 209 190 bang~; -#X obj 379 190 bang~; -#X obj 438 180 pddp/pddplink ftom~-help.pd -text ftom~-help; -#X obj 88 314 pddp/pddplink powtodb~-help.pd -text powtodb~-help; -#X obj 268 314 pddp/pddplink rmstodb~-help.pd -text rmstodb~-help; -#X obj 438 314 pddp/pddplink mtof~-help.pd -text mtof~-help; -#X obj 268 180 pddp/pddplink dbtorms~-help.pd -text dbtorms~-help; -#X obj 88 180 pddp/pddplink dbtopow~-help.pd -text dbtopow~-help; -#X text 98 452 float; -#X text 158 452 - an incoming float will be converted to a signal. -; -#X text 98 472 list; -#X text 158 472 - a list will be truncated to the first element.; -#X obj 98 569 pddp/pddplink all_about_acoustic_conversions.pd; -#X text 97 96 Click on the links under each object for more help:; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 455 51 pddp/dsp; -#X connect 16 0 17 0; -#X connect 17 0 18 0; -#X connect 18 0 19 0; -#X connect 19 0 20 0; -#X connect 20 0 21 0; -#X connect 21 0 22 0; -#X connect 29 0 34 0; -#X connect 30 0 31 0; -#X connect 31 0 35 0; -#X connect 32 0 33 0; -#X connect 34 0 30 0; -#X connect 35 0 32 0; -#X connect 36 0 41 0; -#X connect 37 0 38 0; -#X connect 38 0 42 0; -#X connect 39 0 40 0; -#X connect 41 0 37 0; -#X connect 42 0 39 0; -#X connect 43 0 18 0; -#X connect 43 0 21 0; -#X connect 44 0 30 0; -#X connect 44 0 32 0; -#X connect 45 0 37 0; -#X connect 45 0 39 0; diff --git a/doc/pddp/adc~_dac~-help.pd b/doc/pddp/adc~_dac~-help.pd deleted file mode 100644 index e82c4b4bc..000000000 --- a/doc/pddp/adc~_dac~-help.pd +++ /dev/null @@ -1,108 +0,0 @@ -#N canvas 427 35 559 624 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~/dac~) 3 12 -0 18 -204280 -1 0; -#N canvas 568 408 402 224 META 0; -#X text 12 85 LIBRARY internal; -#X text 12 125 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 45 LICENSE SIBSD; -#X text 12 105 AUTHOR Miller Puckette; -#X text 12 165 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 25 KEYWORDS signal conversion; -#X text 12 5 NAME adc~ dac~; -#X text 12 145 RELEASE_DATE 1997; -#X text 12 65 DESCRIPTION audio input/output; -#X restore 501 597 pd META; -#X obj 0 508 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 205 462 428 165 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 19 74 Externals; -#X obj 173 43 throw~; -#X obj 225 43 catch~; -#X obj 277 43 send~; -#X obj 321 43 receive~; -#X obj 19 94 pddp/helplink pdogg/oggcast~; -#X obj 19 114 pddp/helplink unauthorized/mp3cast~; -#X text 18 136 [shoutcast~] (What library is this in?); -#X obj 119 43 block~; -#X text 19 66; -#X text 115 43; -#X restore 102 597 pd Related_objects; -#X obj 469 10 adc~; -#X obj 5 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#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 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 102 542 pd Multi-channel_audio; -#N canvas 84 179 428 341 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 obj 509 10 adc~; -#X text 12 23 audio input/output; -#X obj 101 107 pddp/pddplink adc~-help.pd; -#X text 98 56 [adc~] and [dac~] provide real-time audio input and output -for Pd \, respectively \, whether analog or digital. Click below for -the individual help patches:; -#X obj 101 127 pddp/pddplink dac~-help.pd; diff --git a/doc/pddp/append-help.pd b/doc/pddp/append-help.pd deleted file mode 100644 index 944d593ff..000000000 --- a/doc/pddp/append-help.pd +++ /dev/null @@ -1,114 +0,0 @@ -#N canvas 427 33 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 append 3 12 0 18 --204280 -1 0; -#X obj 0 226 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 563 355 411 274 META 0; -#X text 12 145 LIBRARY internal; -#X text 12 185 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 165 AUTHOR Miller Puckette; -#X text 12 225 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 5 KEYWORDS control data_structure; -#X text 12 105 INLET_R pointer; -#X text 12 125 OUTLET_0 pointer; -#X text 12 65 INLET_0 float list; -#X text 12 85 INLET_N float; -#X text 12 205 RELEASE_DATE 1997; -#X text 12 45 DESCRIPTION add a scalar to a canvas; -#X restore 500 597 pd META; -#X obj 0 392 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 436 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 527 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#X obj 78 319 cnv 17 3 35 empty \$0-pddp.cnv.let.n n 5 9 0 16 -228856 --162280 0; -#X obj 78 235 cnv 17 3 78 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 319 float; -#N canvas 214 524 428 101 Related_objects 0; -#X obj 14 38 get; -#X obj 46 38 set; -#X obj 136 38 getsize; -#X obj 193 38 setsize; -#X obj 121 63 element; -#X obj 13 64 sublist; -#X obj 79 38 pointer; -#X obj 69 63 struct; -#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 [append] Related Objects; -#X restore 101 597 pd Related_objects; -#X obj 498 12 append; -#N canvas 116 162 428 109 help-append-template1 0; -#X obj 22 69 filledpolygon z z 0 0 0 20 0 20 30 0 30; -#X obj 22 42 struct help-append-template1 float x float y float z; -#X obj 0 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 1 [append] Template for "help-append-template1"; -#X restore 372 196 pd help-append-template1; -#N canvas 554 168 428 207 help-append-data 0; -#X obj 0 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 1 [append] Data Window; -#X restore 372 174 pd help-append-data; -#X obj 281 104 pointer; -#X msg 281 80 traverse pd-help-append-data \, bang; -#X obj 80 152 append help-append-template1 x y z; -#X floatatom 80 95 5 26 400 0 - - -, f 5; -#X obj 80 115 t f f; -#X msg 372 138 \; pd-help-append-data clear; -#X text 98 234 float; -#X text 98 264 list; -#X obj 78 401 cnv 17 3 30 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 401 pointer; -#X obj 78 360 cnv 17 3 27 empty \$0-pddp.cnv.let.r r 5 9 0 16 -228856 --162280 0; -#X text 98 360 pointer; -#X text 98 531 You may append objects of different templates using -different [append] objects.; -#X text 168 360 - the final inlet takes a pointer to a scalar (or to -the head of a list).; -#X text 168 234 - a float to the left inlet initializes the field(s) -of a scalar and appends the scalar to a glist.; -#X text 168 264 - a list to the first inlet is distributed among the -inlets of [append]. In the example above \, you can use the message -box to assign the values "5" \, "6" \, and "7" to fields "x" \, "y" -\, and "z" \, respectively.; -#X text 168 319 - an additional inlet is created for each field specified -by the creation arguments. A float sent to one of these inlets will -be stored for later use.; -#X text 168 401 - after [append] receives a value at its left inlet -\, it outputs a pointer to the new scalar that has been created.; -#X text 15 74 2) ...then here; -#X text 224 174 3) result is in here ->; -#X text 279 56 1) go to (and output) "head" of the list; -#X text 168 482 - all subsequent arguments are names of fields to initialize. -At least one field must be specified in order to append a new scalar. -; -#X text 80 455 1) symbol atom; -#X text 80 482 n) symbol atom; -#X text 168 455 - a [struct] name that specifies the template of a -new scalar to append.; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 98 572 pddp/pddplink ../4.data.structures/04.append.pd -text -doc/4.data.structures/04.append.pd; -#X obj 98 557 pddp/pddplink all_about_z_order.pd; -#X obj 325 557 pddp/pddplink scalar-help.pd; -#X text 11 23 add a scalar to a canvas; -#X msg 18 95 10 75 2; -#X connect 14 0 16 3; -#X connect 15 0 14 0; -#X connect 17 0 18 0; -#X connect 18 0 16 0; -#X connect 18 1 16 1; -#X connect 18 1 16 2; -#X connect 44 0 16 0; diff --git a/doc/pddp/bag-help.pd b/doc/pddp/bag-help.pd deleted file mode 100644 index 9a73fe22d..000000000 --- a/doc/pddp/bag-help.pd +++ /dev/null @@ -1,86 +0,0 @@ -#N canvas 430 33 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 bag 3 12 0 18 -204280 --1 0; -#X obj 0 288 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 562 360 414 263 META 0; -#X text 12 125 LIBRARY internal; -#X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 145 AUTHOR Miller Puckette; -#X text 12 205 HELP_PATCH_AUTHORS Updated for Pd v0.41. Revised by -Jonathan Wilkes to conform to the PDDP template for Pd version 0.42. -; -#X text 12 45 DESCRIPTION collection of numbers; -#X text 12 85 INLET_1 float; -#X text 12 105 OUTLET_0 float; -#X text 12 65 INLET_0 float list flush clear; -#X text 12 5 KEYWORDS control storage list_op; -#X text 12 185 RELEASE_DATE 2009; -#X restore 500 597 pd META; -#X obj 0 495 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 538 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 566 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#X text 98 542 (none); -#N canvas 225 510 428 109 Related_objects 0; -#X obj 62 43 makenote; -#X obj 22 43 poly; -#X obj 123 43 list; -#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 [bag] Related Objects; -#X restore 102 598 pd Related_objects; -#X obj 79 297 cnv 17 3 130 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 296 float; -#X text 98 353 list; -#X text 98 503 float; -#X obj 79 504 cnv 17 3 30 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 79 440 cnv 17 3 45 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 98 439 float; -#X text 98 383 flush; -#X text 98 413 clear; -#X text 168 383 - output all values one by one \, in the order they -were received \, and clear the collection.; -#X text 168 503 - upon sending the "flush" message to the left inlet -\, [bag] will output each value in the order it was received.; -#X text 99 570 You can use [bag] to mimic a sustain pedal \, for example. -; -#X msg 162 88 60 64; -#X msg 213 88 60 0; -#X msg 257 88 62 64; -#X msg 304 88 62 0; -#X obj 162 215 print; -#X text 207 216 Output is in the printout window.; -#X msg 304 134 clear; -#X msg 303 111 flush; -#X obj 162 185 bag; -#X text 168 353 - a (value \, flag) pair is distributed to the two -inlets. Lists with more than two elements will be truncated.; -#X text 11 23 collection of numbers; -#X obj 518 10 bag; -#X text 168 413 - clear the collection.; -#X text 167 439 - a float to the right inlet sets the "flag": if zero -\, values to the left inlet will not be added to the collection. If -nonzero \, values to the right inlet will be added to the collection. -; -#X text 168 296 - a float to the left inlet will be added to the collection -if the last value the right inlet received was nonzero. If the last -value the right inlet received was zero \, the float sent to the right -inlet will be removed from the collection.; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X connect 21 0 29 0; -#X connect 22 0 29 0; -#X connect 23 0 29 0; -#X connect 24 0 29 0; -#X connect 27 0 29 0; -#X connect 28 0 29 0; -#X connect 29 0 25 0; diff --git a/doc/pddp/bang-help.pd b/doc/pddp/bang-help.pd deleted file mode 100644 index 03d6621b3..000000000 --- a/doc/pddp/bang-help.pd +++ /dev/null @@ -1,133 +0,0 @@ -#N canvas 428 36 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 bang 3 12 0 18 -204280 --1 0; -#X obj 0 329 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 570 331 408 299 META 0; -#X text 12 125 LIBRARY internal; -#X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 45 LICENSE SIBSD; -#X text 12 145 AUTHOR Miller Puckette; -#X text 12 205 HELP_PATCH_AUTHORS This document was updated for Pd -version 0.35 test 28 by Dave Sabine as part of a project called pddp -proposed by Krzysztof Czaja to build comprehensive documentation for -Pd. Revised by Jonathan Wilkes to conform to the PDDP template for -Pd version 0.42.; -#X text 12 65 DESCRIPTION output a "bang" message whatever the input -; -#X text 12 85 INLET_0 anything; -#X text 12 105 OUTLET_0 bang; -#X text 12 5 ALIAS b; -#X text 12 25 KEYWORDS control bang_op; -#X text 12 185 RELEASE_DATE 2009; -#X restore 500 597 pd META; -#X obj 0 373 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 409 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 437 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#X obj 78 338 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 413 (none); -#N canvas 215 518 428 108 Related_objects 0; -#X obj 21 42 trigger; -#X obj 191 43 loadbang; -#X msg 91 43; -#X obj 262 43 until; -#X obj 144 43 bang; -#X obj 312 43 metro; -#X obj 0 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 1 [bang] Related Objects; -#X restore 101 598 pd Related_objects; -#X text 98 381 bang; -#X obj 78 381 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 468 11 bang; -#X obj 139 224 print; -#X msg 152 171 walk the cat; -#X msg 139 145 45; -#X obj 139 199 bang; -#X obj 288 199 print; -#X msg 288 147 walk the cat; -#X obj 288 175 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X text 310 173 <- gui "bng" object; -#X text 98 337 anything; -#N canvas 57 48 428 509 More_bang_objects 0; -#X obj 23 42 bang; -#X obj 66 42 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 43 116 bang; -#X text 20 115 1; -#X text 19 172 2; -#X obj 43 173 bng 15 250 50 0 empty empty empty 18 7 0 8 -262144 -1 --1; -#X text 178 42 - sending "bang" messages; -#X obj 140 42 t b; -#X msg 92 42 bang; -#X text 19 288 3; -#X msg 45 289 bang; -#X msg 98 342 bang \, bang; -#X obj 98 368 f; -#X obj 131 368 + 1; -#X floatatom 98 393 5 0 0 0 - - -, f 5; -#X msg 46 342 bang; -#X text 19 418 4; -#X obj 43 419 trigger bang; -#X text 151 419 Abbrevation:; -#X obj 253 419 t b; -#X obj 271 471 b; -#X text 43 138 This version uses minimal CPU but serves essentially -the same purpose as the GUI version below.; -#X text 42 309 The word "bang" in a message box (CTRL+2) makes a clickable -bang object. Use commas to send multiple messages:; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 1 [bang] Common Objects for Sending bang Messages; -#X text 20 65 The [bang] object is one of the basic building blocks -of PD and is normally used to activate events. The four basic ways -to send a "bang" message are:; -#X text 42 441 When given a single argument of "bang" \, the trigger -object is essentially the same as #1 above \, so in this case it's -preferable (and less typing) to use:; -#X text 67 174 a.k.a. [bng]; -#X text 42 191 This version uses a little more CPU than its cousin -because it lights up when it receives a message or is clicked on and -can be coloured \, resized \, or renamed. It is sometimes 'friendlier' -as well because it can act as its own send and receive object (see -properties...). This object can be put in a Pd patch either by keyboard -shortcut: ALT+SHIFT+B or by creating an object (CTRL+1) and naming -it "bng".; -#X connect 11 0 12 0; -#X connect 12 0 13 0; -#X connect 12 0 14 0; -#X connect 13 0 12 1; -#X connect 15 0 12 0; -#X restore 100 473 pd More_bang_objects; -#X text 98 441 Many objects in Pd output a "bang" message. Click the -subpatch below to read about the most common ones:; -#X obj 100 569 tgl 15 0 empty empty empty 17 7 0 10 -262144 -1 -1 0 -1; -#X text 98 498 It is important to note that "bang" is not boolean. -It's neither a zero or a one \; it's not true or false \; it's just -"bang". For a boolean object \, you should check out [toggle]:; -#X text 11 23 output a "bang" message whatever the input; -#X text 122 567 <- Right click and choose "Help" for [toggle] helpfile. -; -#X text 168 381 - the [bang] object always outputs a bang message. -; -#X text 168 337 - [bang] takes any message supplied to its inlet and -outputs a bang message in response.; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 520 11 b; -#X text 500 11 or; -#X connect 14 0 16 0; -#X connect 15 0 16 0; -#X connect 16 0 13 0; -#X connect 18 0 19 0; -#X connect 19 0 17 0; diff --git a/doc/pddp/bang~-help.pd b/doc/pddp/bang~-help.pd deleted file mode 100644 index 3d9ae5218..000000000 --- a/doc/pddp/bang~-help.pd +++ /dev/null @@ -1,75 +0,0 @@ -#N canvas 426 35 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 bang~ 3 12 0 18 --204280 -1 0; -#X obj 0 445 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 585 389 387 241 META 0; -#X text 12 105 LIBRARY internal; -#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 125 AUTHOR Miller Puckette; -#X text 12 185 HELP_PATCH_AUTHORS Updated for Pd version 0.33. Revised -by Jonathan Wilkes to conform to the PDDP template for Pd version 0.42. -; -#X text 12 45 DESCRIPTION output a "bang" message after each DSP cycle -; -#X text 12 65 INLET_0; -#X text 12 85 OUTLET_0 bang; -#X text 12 5 KEYWORDS signal conversion bang_op; -#X text 12 165 RELEASE_DATE 2009; -#X restore 500 597 pd META; -#X obj 0 482 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 537 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 565 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#X obj 78 454 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 541 (none); -#N canvas 214 518 428 114 Related_objects 0; -#X obj 15 34 print~; -#X obj 72 34 bang; -#X obj 0 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 6 1 [bang~] Related Objects; -#X restore 102 597 pd Related_objects; -#X text 98 491 bang; -#X obj 78 491 cnv 17 3 35 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 505 12 bang~; -#X obj 116 213 bang~; -#X obj 116 281 print; -#X text 228 169 click to test; -#X obj 116 249 spigot; -#X msg 190 253 dsp \$1; -#X obj 190 280 s pd; -#X msg 190 171 bang; -#X obj 190 219 1; -#X obj 226 219 0; -#X obj 226 195 delay 10; -#X obj 340 170 loadbang; -#X msg 340 196 dsp 0; -#X obj 340 221 s pd; -#X text 11 23 output a "bang" message after each DSP cycle; -#X text 168 453 - the inlet of [bang~] is not used.; -#X text 168 491 - [bang~] outputs a bang after each DSP cycle (at the -same logical time as the DSP cycle). This is primarily useful for sampling -the outputs of analysis algorithms.; -#X text 98 453 (inactive); -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X connect 13 0 16 0; -#X connect 16 0 14 0; -#X connect 17 0 18 0; -#X connect 19 0 20 0; -#X connect 19 0 22 0; -#X connect 20 0 16 1; -#X connect 20 0 17 0; -#X connect 21 0 16 1; -#X connect 21 0 17 0; -#X connect 22 0 21 0; -#X connect 23 0 24 0; -#X connect 24 0 25 0; diff --git a/doc/pddp/biquad~-help.pd b/doc/pddp/biquad~-help.pd deleted file mode 100644 index aba09e5bc..000000000 --- a/doc/pddp/biquad~-help.pd +++ /dev/null @@ -1,88 +0,0 @@ -#N canvas 429 36 555 619 10; -#X obj -1 595 cnv 15 552 21 empty \$0-pddp.cnv.footer empty 20 12 0 -14 -228856 -66577 0; -#X obj -1 0 cnv 15 552 40 empty \$0-pddp.cnv.header biquad~ 3 12 0 -18 -204280 -1 0; -#X obj -1 321 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 659 352 314 272 META 0; -#X text 12 105 LIBRARY internal; -#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 125 AUTHOR Miller Puckette; -#X text 12 185 HELP_PATCH_AUTHORS Updated for Pd version-0.30. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 5 KEYWORDS signal filters; -#X text 12 45 DESCRIPTION 2-pole-2-zero-filter; -#X text 12 85 OUTLET_0 signal; -#X text 12 65 INLET_0 list signal set clear; -#X text 12 165 RELEASE_DATE 2009; -#X restore 500 597 pd META; -#X obj -1 416 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj -1 453 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj -1 565 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 -12 0 13 -228856 -1 0; -#N canvas 211 524 428 102 Related_objects 0; -#X obj 22 42 hip~; -#X obj 62 41 lop~; -#X obj 104 41 bp~; -#X obj 139 41 vcf~; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 1 [biquad~] Related Objects; -#X restore 101 597 pd Related_objects; -#X obj 78 330 cnv 17 3 75 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 489 12 biquad~; -#X obj 155 216 env~; -#X floatatom 155 243 0 0 0 0 - - -; -#X floatatom 66 98 0 0 0 0 - - -; -#X obj 66 214 env~; -#X floatatom 66 242 0 0 0 0 - - -; -#X obj 155 183 biquad~ 1.41407 -0.9998 1 -1.41421 1; -#X msg 155 99 1.41407 -0.9998 1 -1.41421 1; -#X text 220 237 (= SR/8 = 5512.5 Hz @44.1k); -#X text 167 77 list sets filter parameters; -#X msg 190 129 set 0 0; -#X msg 191 154 clear; -#X obj 66 138 osc~ 5512.5; -#X text 260 131 set internal state; -#X text 258 153 ... or just clear it; -#X text 98 350 list; -#X text 98 330 signal; -#X text 98 370 set; -#X text 98 390 clear; -#X obj 78 425 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 426 signal; -#X text 169 503 y(n) = ff1 * w(n) + ff2 * w(n-1) + ff3 * w(n-2); -#X text 169 519 w(n) = x(n) + fb1 * w(n-1) + fb2 * w(n-2); -#X text 169 541 Syntax: biquad~ fb1 fb2 ff1 ff2 ff3; -#X text 59 267 Compare the value of the straight signal on the left -with the value of the filtered signal on the right.; -#X text 11 23 2-pole-2-zero-filter; -#X text 169 472 - [biquad~] takes five floats as arguments which are -used to calculate the following difference equation:; -#X text 168 370 - set internal state.; -#X text 168 390 - clear the internal state.; -#X text 85 472 5 floats; -#X text 214 218 this [biquad~] is a notch filter for fn = Pi/4; -#X text 168 350 - a list of 5 floats is used to set filter parameters. -; -#X text 168 330 - the incoming signal; -#X text 168 426 - the outgoing signal; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 474 51 pddp/dsp; -#X connect 10 0 11 0; -#X connect 12 0 21 0; -#X connect 13 0 14 0; -#X connect 15 0 10 0; -#X connect 16 0 15 0; -#X connect 19 0 15 0; -#X connect 20 0 15 0; -#X connect 21 0 13 0; -#X connect 21 0 15 0; diff --git a/doc/pddp/block~-help.pd b/doc/pddp/block~-help.pd deleted file mode 100644 index 5858a5531..000000000 --- a/doc/pddp/block~-help.pd +++ /dev/null @@ -1,211 +0,0 @@ -#N canvas 242 31 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 block~ 3 12 0 18 --204280 -1 0; -#X obj 0 251 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 479 284 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. Revised -by Jonathan Wilkes to conform to the PDDP template for Pd version 0.42. -; -#X text 12 65 DESCRIPTION block \, overlap \, and resampling control -for DSP; -#X text 12 85 INLET_0 set; -#X text 12 25 KEYWORDS signal block_oriented canvas_op; -#X text 12 165 RELEASE_DATE 2009; -#X text 12 5 ALIAS switch~; -#X restore 500 597 pd META; -#X obj 0 336 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 365 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 435 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 212 523 428 105 Related_objects 0; -#X obj 83 42 fft~; -#X obj 23 42 switch~; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 8 1 [block~] Related Objects; -#X restore 102 597 pd Related_objects; -#X obj 78 260 cnv 17 3 70 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 260 set; -#X text 98 341 (none); -#X floatatom 78 223 0 0 0 0 - - -; -#X text 165 224 <- measured time (msec) between blocks; -#X text 161 49 block size 4096 \, no overlap \, no resampling; -#X text 162 71 bigger block size; -#X text 160 92 double overlap; -#X text 169 116 downsampled by factor of 2; -#X text 160 139 upsampled by factor of 2; -#X msg 78 50 set 4096 1 1; -#X msg 78 72 set 8192 1 1; -#X msg 78 94 set 4096 2 1; -#X msg 78 116 set 4096 1 0.5; -#X msg 78 138 set 4096 1 2; -#N canvas 44 414 428 153 a-simple-block-example 0; -#X obj 22 42 block~ 1024 4; -#X text 19 64 This object specifies that DSP in this subwindow is to -be computed at a block size of 1024 \, and an overlap of 4 \, i.e. -\, every 256 samples. You may not (yet) specify a block size smaller -than your superpatch. This is useful for writing FFT based patches -(see the "fft examples" tutorial series.); -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 1 [block~] A Simple Example; -#X restore 242 555 pd a-simple-block-example; -#N canvas 56 284 428 261 block-interactions 0; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 1 [block~]/[switch~] Interactions with Other PD Objects; -#X text 20 36 [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 19 103 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 21 184 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 restore 102 555 pd block-interactions; -#X text 257 200 <- toggle display; -#X text 11 23 block \, overlap \, and resampling control for DSP; -#N canvas 22 87 428 396 visualize 0; -#X obj 49 219 f; -#X obj 81 219 + 1; -#X obj 117 170 i; -#X obj 117 243 s \$0-bng-rcv; -#X msg 117 218 flashtime 50 \$1; -#X obj 117 195 max 50; -#X obj 49 139 t b a; -#X obj 258 318 outlet; -#X obj 258 181 t a; -#X obj 201 315 tgl 15 0 \$0-tgl \$0-nothing empty 17 7 0 10 -204786 --1 -1 0 1; -#X obj 49 187 spigot; -#X obj 110 124 r \$0-tgl; -#X obj 49 319 bng 10 50 50 0 \$0-nowhere \$0-bng-rcv empty 17 7 0 10 --262144 -1 -1; -#X obj 64 319 bng 10 50 50 0 \$0-nowhere \$0-bng-rcv empty 17 7 0 10 --262144 -1 -1; -#X obj 79 319 bng 10 50 50 0 \$0-nowhere \$0-bng-rcv empty 17 7 0 10 --262144 -1 -1; -#X obj 94 319 bng 10 50 50 0 \$0-nowhere \$0-bng-rcv empty 17 7 0 10 --262144 -1 -1; -#X obj 109 319 bng 10 50 50 0 \$0-nowhere \$0-bng-rcv empty 17 7 0 -10 -262144 -1 -1; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 1 [block~] Bang every block; -#X text 10 347 This subpatch just triggers a series of bng objects -to display how different "set" messages change the block size.; -#X obj 260 114 inlet; -#X obj 260 138 block~ 4096 1; -#X obj 49 63 bang~; -#X obj 49 89 t b b; -#X obj 49 115 timer; -#X obj 49 273 sel 0 1 2 3 4 5 6 7 8 9; -#X obj 124 319 bng 10 50 50 0 \$0-nowhere \$0-bng-rcv empty 17 7 0 -10 -262144 -1 -1; -#X obj 139 319 bng 10 50 50 0 \$0-nowhere \$0-bng-rcv empty 17 7 0 -10 -262144 -1 -1; -#X obj 154 319 bng 10 50 50 0 \$0-nowhere \$0-bng-rcv empty 17 7 0 -10 -262144 -1 -1; -#X obj 169 319 bng 10 50 50 0 \$0-nowhere \$0-bng-rcv empty 17 7 0 -10 -262144 -1 -1; -#X obj 184 319 bng 10 50 50 0 \$0-nowhere \$0-bng-rcv empty 17 7 0 -10 -262144 -1 -1; -#X obj 49 246 mod 10; -#X connect 0 0 1 0; -#X connect 0 0 31 0; -#X connect 1 0 0 1; -#X connect 2 0 5 0; -#X connect 4 0 3 0; -#X connect 5 0 4 0; -#X connect 6 0 10 0; -#X connect 6 1 2 0; -#X connect 6 1 8 0; -#X connect 8 0 7 0; -#X connect 10 0 0 0; -#X connect 11 0 10 1; -#X connect 20 0 21 0; -#X connect 22 0 23 0; -#X connect 23 0 24 0; -#X connect 23 1 24 1; -#X connect 24 0 6 0; -#X connect 25 0 12 0; -#X connect 25 1 13 0; -#X connect 25 2 14 0; -#X connect 25 3 15 0; -#X connect 25 4 16 0; -#X connect 25 5 26 0; -#X connect 25 6 27 0; -#X connect 25 7 28 0; -#X connect 25 8 29 0; -#X connect 25 9 30 0; -#X connect 31 0 25 0; -#X coords 0 -1 1 1 175 35 1 45 300; -#X restore 78 185 pd visualize; -#X text 170 384 - blocksize.; -#X text 170 398 - (optional) overlap.; -#X text 170 411 - (optional) resampling factor (relative to super-patch). -; -#X text 80 398 2) float; -#X text 80 411 3) float; -#X text 80 384 1) float; -#X text 99 439 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 blocks 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 obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 455 51 pddp/dsp; -#X obj 102 576 pddp/pddplink ../3.audio.examples/J07.oversampling.pd --text doc/3.audio.examples/J07.oversampling.pd; -#X text 574 554 <-- weird 'bang' feature lets you single-step DSP; -#X text 385 10 [block~] or [switch~]; -#X text 90 161 Note: [block~] is in the subpatch (below) for this example: -; -#X text 168 260 - "set" followed by one to three floats determines -the block size \, overlap \, and resampling for the window (see example -above).; -#X text 98 310 bang; -#X text 168 310 - calculate a single block inside a subpatch (see below) -; -#N canvas 0 22 581 315 bang_message 0; -#X text 32 11 You can use the switch~ object to single-step dsp in -a subpatch. This might be useful for block operations that don't want -to be synced to the sample clock: loading a wondiw function in a table -\, or copying one table to another:; -#X obj 136 193 noise~; -#X obj 136 225 tabwrite~ zzzz; -#X obj 33 154 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 -1 --1; -#N canvas 0 22 450 300 (subpatch) 0; -#X array zzzz 256 float 2 black black; -#X coords 0 1 256 -1 256 140 1; -#X restore 300 116 graph; -#X obj 33 228 switch~ 256; -#X text 25 111 turn DSP on and click to; -#X text 26 127 randomize the table at right:; -#X connect 1 0 2 0; -#X connect 3 0 2 0; -#X connect 3 0 5 0; -#X restore 420 554 pd bang_message; -#X connect 18 0 27 0; -#X connect 19 0 27 0; -#X connect 20 0 27 0; -#X connect 21 0 27 0; -#X connect 22 0 27 0; -#X connect 27 0 11 0; diff --git a/doc/pddp/bng-help.pd b/doc/pddp/bng-help.pd deleted file mode 100644 index 30d61627a..000000000 --- a/doc/pddp/bng-help.pd +++ /dev/null @@ -1,443 +0,0 @@ -#N canvas 433 35 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 bng 3 12 0 18 -204280 --1 0; -#X obj 0 300 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 504 285 494 344 META 0; -#X text 12 115 LIBRARY internal; -#X text 12 25 LICENSE SIBSD; -#X text 12 135 AUTHOR Thomas Musil; -#X text 12 155 WEBSITE; -#X text 12 195 HELP_PATCH_AUTHORS Jonathan Wilkes revised the patch -to conform to the PDDP template for Pd version 0.42.; -#X text 12 45 DESCRIPTION gui-bang; -#X text 12 65 INLET_0 anything size flashtime init send receive label -label_pos label_font color pos delta; -#X text 12 95 OUTLET_0 bang; -#X text 12 5 KEYWORDS control nonlocal GUI bang_op; -#X text 12 175 RELEASE_DATE 2009; -#X restore 500 597 pd META; -#X obj 0 408 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 445 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 547 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#X obj 78 309 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#N canvas 220 497 428 129 Related_objects 0; -#X obj 22 43 bang; -#X obj 69 43 trigger; -#X obj 145 43 until; -#X obj 201 43 bang~; -#X msg 257 43; -#X obj 20 93 x_all_guis bng tgl vsl hsl hradio vradio vu cnv nbx; -#X text 18 69 All iem-gui objects:; -#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 [bng] Related Objects; -#X restore 101 597 pd Related_objects; -#X text 98 417 bang; -#X obj 78 417 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 308 anything; -#X obj 526 13 bng 15 250 50 0 foo5_rcv empty empty 17 7 0 10 -262144 --1 -1; -#X obj 144 227 print; -#N canvas 598 330 187 198 once 0; -#X msg 38 77 1; -#X obj 38 51 t b b; -#X obj 68 133 sel 0; -#X obj 68 107 f 0; -#X obj 38 24 inlet; -#X obj 68 163 outlet; -#X connect 0 0 3 1; -#X connect 1 0 0 0; -#X connect 1 1 3 0; -#X connect 2 0 5 0; -#X connect 3 0 2 0; -#X connect 4 0 1 0; -#X restore 144 203 pd once; -#X obj 116 228 bng 15 250 50 0 empty empty empty 8 -8 0 10 -262144 --1 -1; -#X obj 75 110 bng 15 250 50 0 empty empty empty 8 -8 0 10 -262144 -1 --1; -#X obj 116 148 bng 50 950 50 1 foo5_snd foo5_rcv big-bang 57 25 0 12 --262131 -260818 -143491; -#X msg 116 49 33; -#X msg 157 49 -3.14; -#X msg 180 97 11 22 33.33; -#X msg 170 73 open xxx; -#X msg 187 121 funny; -#X obj 292 72 s foo5_rcv; -#X obj 292 102 r foo5_snd; -#X obj 292 53 bng 15 250 50 0 empty empty empty 8 -8 0 10 -262144 -1 --1; -#X obj 292 126 bng 15 250 50 0 empty empty empty 8 -8 0 10 -262144 --1 -1; -#X msg 75 49 0; -#X text 321 142 and receive names. Right-; -#X text 321 157 click and choose; -#N canvas 85 201 428 309 bng_creation_arguments 0; -#X text 12 28 "bng" can be called with 14 creation arguments. These -are not "optional" - all parameters must be filled or the gui-bng will -not instantiate correctly.; -#X text 12 132 For example \, click the msg-box to dynamically create -a bng:; -#X text 12 80 bng creation arguments: Size Hold Interrupt Init sendName -receiveName Label labelXOff labelYOff Font# fontSize bgColor foregroundColor -lblColor; -#X obj 13 196 s pd-bng_creation_arguments; -#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 [bng] Creation Arguments and Dynamic Patching; -#X msg 13 154 obj 180 240 bng 30 500 50 0 send receive Atlas -2 40 -0 12 9 2 18; -#X connect 6 0 3 0; -#X restore 100 519 pd bng_creation_arguments; -#X text 320 173 "Properties" to set them \,; -#X text 320 126 [bng] has settable send; -#X text 110 250 Use the UP- \, DOWN- \, LEFT- or RIGHT-key to move -a selected gui-object. Right-click and choose "Properties" to modify -its appearance.; -#X text 321 187 or change them with messages; -#X text 321 201 (see the subpatch below); -#N canvas 48 5 428 610 Changing_GUI_Properties 0; -#X text 239 33 no init; -#X text 270 159 label position; -#X text 167 451 delta; -#X text 11 294 font properties; -#X text 151 159 label; -#X text 15 451 position; -#X msg 13 103 size \$1; -#X msg 104 104 flashtime \$1 \$2; -#X msg 239 54 init 0; -#X msg 249 104 init 1; -#X msg 321 54 send foo5a_snd; -#X msg 151 180 label new-label; -#X msg 272 231 label_pos \$1 \$2; -#X msg 13 366 label_font \$1 \$2; -#X msg 16 558 pos \$1 \$2; -#X msg 168 558 delta \$1 \$2; -#X text 171 294 preset-colors; -#X text 297 294 RGB-colors; -#X msg 171 401 color \$1 \$2 \$3; -#X msg 329 104 send bng-snd; -#X obj 13 127 s bng_rcv; -#X obj 104 128 s bng_rcv; -#X obj 239 129 s bng_rcv; -#X obj 321 129 s bng_rcv; -#X obj 13 255 s bng_rcv; -#X obj 23 230 s bng1a_rcv; -#X obj 151 256 s bng_rcv; -#X obj 272 256 s bng_rcv; -#X obj 13 391 s bng_rcv; -#X obj 171 426 s bng_rcv; -#X obj 168 583 s bng_rcv; -#X obj 16 583 s bng_rcv; -#X msg 23 206 receive bng_rcv; -#X msg 13 180 receive bng1a_rcv; -#X msg 163 231 label myBang; -#N canvas 375 166 160 287 init 0; -#X obj 16 11 loadbang; -#X obj 16 42 f \$0; -#X msg 16 72 \; \$1-interrupt 50 \; \$1-hold 250 \; \$1-xpos 340 \; -\$1-ypos 500 \; \$1-xlabel 17 \; \$1-ylabel 7 \; \$1-dim 15 \; \$1-font -0 \; \$1-font-size 10 \; \$1-bg 0 \; \$1-front 12 \; \$1-label 12; -#X connect 0 0 1 0; -#X connect 1 0 2 0; -#X restore 320 583 pd init; -#X text 320 33 change send name; -#X text 13 159 change receive name; -#N canvas 366 206 174 259 flash-time 0; -#X obj 68 180 pack; -#X obj 103 149 t b a; -#X obj 68 205 outlet; -#X obj 103 104 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-interrupt empty -0 -8 0 12 -262144 -1 -1 50 256 0; -#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-hold empty 0 --8 0 12 -262144 -1 -1 250 256 0; -#X connect 0 0 2 0; -#X connect 1 0 0 0; -#X connect 1 1 0 1; -#X connect 3 0 0 0; -#X connect 4 0 1 0; -#X coords 0 -1 1 1 48 42 2 100 100; -#X restore 104 54 pd flash-time; -#X text 101 33 flash-time; -#X text 12 32 dimensions; -#N canvas 364 205 306 317 flash-time 0; -#X obj 69 196 t b a; -#X obj 33 262 outlet; -#X obj 33 237 pack 0 0 0; -#X obj 120 197 t b a; -#X obj 103 104 nbx 3 14 0 29 0 0 \$0-dummy \$0-bg empty 0 -8 0 12 -262144 --1 -1 0 256 0; -#X obj 103 124 nbx 3 14 0 29 0 0 \$0-dummy \$0-front empty 0 -8 0 12 --262144 -1 -1 12 256 0; -#X obj 103 144 nbx 3 14 0 29 0 0 \$0-dummy \$0-label empty 0 -8 0 12 --262144 -1 -1 12 256 0; -#X connect 0 0 2 0; -#X connect 0 1 2 1; -#X connect 2 0 1 0; -#X connect 3 0 2 0; -#X connect 3 1 2 2; -#X connect 4 0 2 0; -#X connect 5 0 0 0; -#X connect 6 0 3 0; -#X coords 0 -1 1 1 48 62 2 100 100; -#X restore 171 316 pd flash-time; -#N canvas 0 0 306 317 flash-time 0; -#X obj 96 521 outlet; -#X obj 162 230 t b f; -#X obj 96 268 +; -#X obj 96 293 t b f; -#X obj 96 324 +; -#X obj 19 208 * -65536; -#X obj 96 208 * -256; -#X obj 162 208 * -1; -#X obj 96 355 - 1; -#X obj 96 385 list prepend 0; -#X obj 96 410 route 0 1 2; -#X obj 96 497 pack 0 0 0; -#X obj 115 456 t b a; -#X obj 168 455 t b a; -#X obj 104 124 vradio 15 1 0 3 empty empty empty 0 -8 0 10 -262144 --1 -1 0; -#X text 120 120 1.bg; -#X text 120 137 2.front; -#X text 120 153 3.label; -#X obj 103 105 nbx 3 14 0 255 0 0 \$0-dummy \$0-r empty 0 -8 0 10 -262144 --258113 -1 0 256 0; -#X obj 133 105 nbx 3 14 0 255 0 0 \$0-dummy \$0-g empty 0 -8 0 10 -262144 --13381 -1 0 256 0; -#X obj 163 105 nbx 3 14 0 255 0 0 \$0-dummy \$0-b empty 0 -8 0 10 -262144 --4160 -1 0 256 0; -#X connect 1 0 2 0; -#X connect 1 1 2 1; -#X connect 2 0 3 0; -#X connect 3 0 4 0; -#X connect 3 1 4 1; -#X connect 4 0 8 0; -#X connect 5 0 4 0; -#X connect 6 0 2 0; -#X connect 7 0 1 0; -#X connect 8 0 9 0; -#X connect 9 0 10 0; -#X connect 10 0 11 0; -#X connect 10 1 12 0; -#X connect 10 2 13 0; -#X connect 11 0 0 0; -#X connect 12 0 11 0; -#X connect 12 1 11 1; -#X connect 13 0 11 0; -#X connect 13 1 11 2; -#X connect 14 0 9 1; -#X connect 18 0 5 0; -#X connect 19 0 6 0; -#X connect 20 0 7 0; -#X coords 0 -1 1 1 102 74 2 100 100; -#X restore 298 316 pd flash-time; -#X text 248 72 init on; -#X text 248 85 loadbang; -#X obj 168 534 list; -#X obj 168 473 bng 20 250 50 0 empty empty empty 17 7 0 10 -262144 --1 -1; -#X obj 310 466 cnv 15 102 102 empty empty empty 20 12 0 14 -1 -66577 -0; -#X obj 311 467 cnv 15 100 100 empty empty empty 20 12 0 14 -261682 --66577 0; -#X obj 340 500 bng 15 250 50 1 bng-snd bng_rcv myBang 17 7 0 10 -262144 --33289 -33289; -#X text 62 318 1.font(0-2); -#X text 62 339 2.height; -#X text 220 318 1.bg; -#X text 220 338 2.front; -#X text 220 359 3.label; -#X text 64 472 1.x-position; -#X text 64 494 2.y-position; -#X text 247 472 1.x-delta; -#X text 247 494 2.y-delta; -#X obj 13 53 nbx 3 14 8 200 0 0 empty \$0-dim empty 0 -8 0 12 -262144 --1 -1 15 256 0; -#X text 58 51 size; -#N canvas 366 206 174 259 flash-time 0; -#X obj 68 180 pack; -#X obj 103 149 t b a; -#X obj 68 205 outlet; -#X obj 103 104 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-xlabel empty -0 -8 0 12 -262144 -1 -1 17 256 0; -#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-ylabel empty -0 -8 0 12 -262144 -1 -1 7 256 0; -#X connect 0 0 2 0; -#X connect 1 0 0 0; -#X connect 1 1 0 1; -#X connect 3 0 0 0; -#X connect 4 0 1 0; -#X coords 0 -1 1 1 48 42 2 100 100; -#X restore 272 181 pd flash-time; -#N canvas 366 206 174 259 flash-time 0; -#X obj 68 180 pack; -#X obj 103 149 t b a; -#X obj 68 205 outlet; -#X obj 103 104 nbx 3 14 0 2 0 0 \$0-dummy \$0-font empty 0 -8 0 12 --262144 -1 -1 0 256 0; -#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-font-size empty -0 -8 0 12 -262144 -1 -1 10 256 0; -#X connect 0 0 2 0; -#X connect 1 0 0 0; -#X connect 1 1 0 1; -#X connect 3 0 0 0; -#X connect 4 0 1 0; -#X coords 0 -1 1 1 48 42 2 100 100; -#X restore 13 316 pd flash-time; -#N canvas 366 206 174 259 flash-time 0; -#X obj 68 180 pack; -#X obj 103 149 t b a; -#X obj 68 205 outlet; -#X obj 103 104 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-xpos empty 0 --8 0 12 -262144 -1 -1 340 256 0; -#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-ypos empty 0 --8 0 12 -262144 -1 -1 500 256 0; -#X connect 0 0 2 0; -#X connect 1 0 0 0; -#X connect 1 1 0 1; -#X connect 3 0 0 0; -#X connect 4 0 1 0; -#X coords 0 -1 1 1 48 42 2 100 100; -#X restore 16 473 pd flash-time; -#N canvas 366 206 174 259 flash-time 0; -#X obj 68 180 pack; -#X obj 103 149 t b a; -#X obj 68 205 outlet; -#X obj 103 104 nbx 3 14 -20 20 0 0 \$0-dummy \$0-xdelta empty 0 -8 -0 12 -262144 -1 -1 0 256 0; -#X obj 103 124 nbx 3 14 -20 20 0 0 \$0-dummy \$0-ydelta empty 0 -8 -0 12 -262144 -1 -1 0 256 0; -#X connect 0 0 2 0; -#X connect 1 0 0 0; -#X connect 1 1 0 1; -#X connect 3 0 0 0; -#X connect 4 0 1 0; -#X coords 0 -1 1 1 48 42 2 100 100; -#X restore 197 473 pd flash-time; -#X text 321 203 2.y-offset; -#X text 321 182 1.x-offset; -#X text 153 56 1.interrupt; -#X text 153 76 2.hold; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 6 2 [bng] Changing Properties through Messages; -#X connect 6 0 20 0; -#X connect 7 0 21 0; -#X connect 8 0 22 0; -#X connect 9 0 22 0; -#X connect 10 0 23 0; -#X connect 11 0 26 0; -#X connect 12 0 27 0; -#X connect 13 0 28 0; -#X connect 14 0 31 0; -#X connect 15 0 30 0; -#X connect 18 0 29 0; -#X connect 19 0 23 0; -#X connect 32 0 25 0; -#X connect 33 0 24 0; -#X connect 34 0 26 0; -#X connect 38 0 7 0; -#X connect 41 0 18 0; -#X connect 42 0 18 0; -#X connect 45 0 15 0; -#X connect 46 0 45 0; -#X connect 59 0 6 0; -#X connect 61 0 12 0; -#X connect 62 0 13 0; -#X connect 63 0 14 0; -#X connect 64 0 45 1; -#X restore 101 380 pd Changing_GUI_Properties; -#X text 168 463 - creating a [bng] without any arguments will set default -values for all gui-properties. See the subpatch below to learn how -to dynamically instantiate a [bng] object with custom properties:; -#X text 11 23 gui-bang; -#N canvas 43 24 428 573 bng_properties 0; -#X text 22 53 1 Size; -#X obj 104 60 bng 8 250 50 0 empty empty 8 10 4 0 8 -262144 -1 -1; -#X obj 129 53 bng 15 250 50 0 empty empty 15 17 9 0 8 -262144 -1 -1 -; -#X obj 164 43 bng 25 250 50 0 empty empty 25 27 20 0 8 -262144 -1 -1 -; -#X text 51 75 Default size is 15 pixels. The minimum size is 8 and -it does not have a maximum size.; -#X text 23 258 3 Hold; -#X obj 93 258 bng 15 50 10 0 empty empty 50 17 8 0 8 -262144 -1 -1 -; -#X obj 128 258 bng 15 750 50 0 empty empty 750 17 8 0 8 -262144 -1 --1; -#X text 23 341 4 Receive Symbol/Send Symbol; -#X text 49 356 This object can act as its own send or receive object. -; -#X obj 41 391 bng 15 250 50 0 link_this_bang empty This_one_sends_a_bang -17 8 0 10 -262144 -1 -1; -#X obj 41 412 bng 15 250 50 0 empty link_this_bang This_one_receives_it. -17 8 0 10 -262144 -1 -1; -#X text 232 370 Here is the alternative method.; -#X text 26 447 5 GUI Options; -#X text 49 469 The other properties are 'name' \, 'x/y offset' \, 'font -size' \, and colours (for the background \, front \, and labels [name]) -; -#X text 48 275 The default hold is 250 milliseconds. The hold value -controls the length of time that the bng object stays "lit". Note that -bng sends its message immediately regardless of the hold value.; -#X obj 233 436 s linked_bngs; -#X obj 338 389 r linked_bngs; -#X text 22 105 2 Interrupt (milliseconds); -#X text 48 119 If the bng object is "lit" and holding (see "hold" below) -\, then receives another message before the hold time has passed \, -the bng will quickly flash again for the duration you set in this interrupt -property.; -#X obj 24 203 bng 15 1000 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X text 47 187 This bng will hold for 1000 milliseconds \, but interrupt -for 50 milliseconds if it gets a second message during its "hold". -Click it once...wait. Then click it multiple times rather quickly to -see the effect.; -#X obj 233 413 bang; -#X obj 338 413 bang; -#X msg 233 389 send a message; -#X text 18 510 This document was updated for Pd version 0.35 test 24 -by Dave Sabine as part of a project called pddp proposed by Krzysztof -Czaja to build comprehensive documentation for Pd.; -#X obj 338 439 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 --1 -1; -#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 [bng] Properties; -#X connect 17 0 23 0; -#X connect 22 0 16 0; -#X connect 23 0 26 0; -#X connect 24 0 22 0; -#X restore 101 556 pd bng_properties; -#X text 80 463 14; -#X text 215 551 (c) musil@iem.kug.ac.at; -#X text 257 564 IEM KUG; -#X text 232 576 graz \, austria 2002; -#X text 168 418 - [bng] only outputs a bang message.; -#X text 168 308 - [bng] outputs a bang message in response to any message -that has not been defined to affect gui-properties (see below).; -#X text 98 346 See the following subpatch for messages that change -the gui-properties of [bng]:; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X connect 14 0 13 0; -#X connect 16 0 17 0; -#X connect 17 0 15 0; -#X connect 17 0 14 0; -#X connect 18 0 17 0; -#X connect 19 0 17 0; -#X connect 20 0 17 0; -#X connect 21 0 17 0; -#X connect 22 0 17 0; -#X connect 24 0 26 0; -#X connect 25 0 23 0; -#X connect 27 0 17 0; diff --git a/doc/pddp/bp~-help.pd b/doc/pddp/bp~-help.pd deleted file mode 100644 index 6d44475b8..000000000 --- a/doc/pddp/bp~-help.pd +++ /dev/null @@ -1,88 +0,0 @@ -#N canvas 428 36 555 619 10; -#X obj -1 595 cnv 15 552 21 empty \$0-pddp.cnv.footer empty 20 12 0 -14 -228856 -66577 0; -#X obj -1 0 cnv 15 552 40 empty \$0-pddp.cnv.header bp~ 3 12 0 18 -204280 --1 0; -#X obj -1 364 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 483 262 494 367 META 0; -#X text 12 185 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 165 AUTHOR Miller Puckette; -#X text 12 225 HELP_PATCH_AUTHORS Updated for Pd version-0.30. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 5 KEYWORDS signal filter; -#X text 12 145 LIBRARY internal; -#X text 12 45 DESCRIPTION bandpass filter; -#X text 12 65 INLET_0 signal; -#X text 12 85 INLET_1 float; -#X text 12 105 INLET_2 float; -#X text 12 125 OUTLET_0 signal; -#X text 12 205 RELEASE_DATE 2009; -#X restore 500 597 pd META; -#X obj -1 472 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj -1 509 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj -1 568 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 -12 0 13 -228856 -1 0; -#X obj 78 373 cnv 17 3 35 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#N canvas 213 529 428 102 Related_objects 0; -#X obj 21 42 vcf~; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 1 [bp~] Related Objects; -#X restore 101 597 pd Related_objects; -#X obj 78 481 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 502 11 bp~; -#X obj 137 208 env~; -#X floatatom 137 228 0 0 0 0 - - -; -#X floatatom 166 138 0 0 0 0 - - -; -#X obj 78 208 env~; -#X floatatom 78 229 0 0 0 0 - - -; -#X floatatom 78 68 0 0 0 0 - - -; -#X obj 78 91 osc~ 100; -#X msg 138 115 clear; -#X obj 138 186 bp~ 100 10; -#X text 78 258 Compare the amplitude of the original signal on the -left with the amplitude of the filtered signal on the right.; -#X floatatom 195 162 0 0 0 0 - - -; -#X text 98 372 signal; -#X obj 78 416 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 98 392 clear; -#X text 98 415 float; -#X obj 78 444 cnv 17 3 17 empty \$0-pddp.cnv.let.2 2 5 9 0 16 -228856 --162280 0; -#X text 98 445 float; -#X text 98 481 signal; -#X text 11 23 bandpass filter; -#X text 168 392 - reinitialize internal state.; -#X text 168 415 - center frequency.; -#X text 168 445 - Q.; -#X text 170 528 - center frequency.; -#X text 170 544 - Q.; -#X text 80 528 1) float; -#X text 80 544 2) float; -#X text 185 209 [env~] gives the amplitude of the signal envelop in -dB.; -#X text 75 297 [bp~] passes a sinusoid at the center frequency at unit -gain (approximately). Other frequencies are attenuated.; -#X text 123 66 <- scroll to change input frequency; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 476 52 pddp/dsp; -#X obj 98 572 pddp/pddplink ../3.audio.examples/H07.measure.spectrum.pd --text doc/3.audio.examples/H07.measure.spectrum.pd; -#X connect 11 0 12 0; -#X connect 13 0 19 1; -#X connect 14 0 15 0; -#X connect 16 0 17 0; -#X connect 17 0 14 0; -#X connect 17 0 19 0; -#X connect 18 0 19 0; -#X connect 19 0 11 0; -#X connect 21 0 19 2; diff --git a/doc/pddp/canvas-help.pd b/doc/pddp/canvas-help.pd deleted file mode 100644 index fbae534b6..000000000 --- a/doc/pddp/canvas-help.pd +++ /dev/null @@ -1,85 +0,0 @@ -#N canvas 429 36 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 (canvas) 3 12 0 -18 -204280 -1 0; -#X obj 0 293 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 482 350 494 280 META 0; -#X text 12 85 LIBRARY internal; -#X text 12 125 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 45 LICENSE SIBSD; -#X text 12 105 AUTHOR Miller Puckette; -#X text 12 165 HELP_PATCH_AUTHORS Updated for Pd v0.41. Revised by -Jonathan Wilkes to conform to the PDDP template for Pd version 0.42. -; -#X text 12 25 KEYWORDS signal; -#X text 12 65 DESCRIPTION Pure Data document window; -#X text 12 5 NAME pd table graph; -#X text 12 145 RELEASE_DATE 2009; -#X restore 500 597 pd META; -#X obj 0 508 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 556 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 54 478 428 109 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 1 (canvas) Related Objects; -#N canvas 0 0 450 300 (subpatch) 0; -#X restore 22 42 pd; -#X obj 52 42 table; -#X restore 102 598 pd Related_objects; -#X obj 78 302 cnv 17 3 85 empty \$0-pddp.cnv.let.n n 5 9 0 16 -228856 --162280 0; -#X text 328 11 (This help patch itself is a canvas); -#X obj 101 560 pddp/pddplink all_about_canvas_properties.pd -text all_about_canvas_properties -; -#X text 72 56 This help patch is associated with several related objects: -; -#X text 73 142 4) root canvas (i.e. \, pd document); -#X text 93 157 Also known simply as a "patch" \, a canvas is a window -that contains a list of pd objects. A canvas can either be a root canvas-- -created from the "File" menu by choosing "new"-- or a subcanvas (like -one of the objects listed above).; -#X text 98 301 anything; -#X obj 377 76 pddp/pddplink pd-help.pd -text See pd-help; -#X text 73 76 1) [pd] - subcanvas \, a.k.a. subpatch or subwindow. -; -#X text 73 98 2) [table] - array of numbers.; -#X obj 257 98 pddp/pddplink table-help.pd -text See table-help; -#X text 73 120 3) graph (available from the "Put" menu).; -#X obj 322 120 pddp/pddplink graph-help.pd -text See graph-help; -#X text 62 122 *; -#X text 62 229 * If you're new to Pd \, it's easy to get graphs mixed -up with garrays (i.e. \, "Array" from the "Put" menu). For help on -garrays \, click below:; -#X obj 170 328 pddp/pddplink inlet-help.pd -text inlet-help; -#X text 98 347 signal; -#X obj 170 374 pddp/pddplink inlet~-help.pd -text inlet~-help; -#X obj 0 398 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 78 407 cnv 17 3 90 empty \$0-pddp.cnv.let.n n 5 9 0 16 -228856 --162280 0; -#X text 98 406 anything; -#X obj 170 433 pddp/pddplink outlet-help.pd -text outlet-help; -#X text 98 453 signal; -#X obj 170 480 pddp/pddplink outlet~-help.pd -text outlet~-help; -#X text 168 453 - outlets for signals can be created by using [outlet~] -objects on the canvas. See the links below for more details:; -#X text 168 347 - inlets for signals can be created by using [inlet~] -objects on the canvas. See the links below for more details:; -#X text 98 512 (5); -#X text 168 512 - canvas arguments are 5 floats which are not directly -accessible: topLeftX topLeftY canvasWidth canvasHeight fontSize.; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 101 575 pddp/pddplink ../3.audio.examples/G05.execution.order.pd --text doc/3.audio.examples/G05.execution.order.pd; -#X text 11 23 Pure Data document window; -#X text 168 301 - control inlets can be created by using [inlet] objects -on the canvas. See the links below for more details:; -#X text 168 406 - control outlets can be created by using [outlet] -objects on the canvas. See the links below for more details:; -#X obj 62 270 pddp/pddplink array-help.pd -text Help patch for "Put" -menu array; diff --git a/doc/pddp/change-help.pd b/doc/pddp/change-help.pd deleted file mode 100644 index 6e478cda5..000000000 --- a/doc/pddp/change-help.pd +++ /dev/null @@ -1,102 +0,0 @@ -#N canvas 424 45 555 619 10; -#X obj -1 595 cnv 15 552 21 empty \$0-pddp.cnv.footer empty 20 12 0 -14 -228856 -66577 0; -#X obj -1 0 cnv 15 552 40 empty \$0-pddp.cnv.header change 3 12 0 18 --204280 -1 0; -#X obj -1 337 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 479 297 494 344 META 0; -#X text 12 105 LIBRARY internal; -#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 125 AUTHOR Miller Puckette; -#X text 12 185 HELP_PATCH_AUTHORS This document was updated for Pd -version 0.35 test 26 by Dave Sabine as part of a project called pddp -proposed by Krzysztof Czaja to build comprehensive documentation for -Pd. Jonathan Wilkes revised the patch to conform to the PDDP template -for Pd version 0.42.; -#X text 12 5 KEYWORDS control filter; -#X text 12 45 DESCRIPTION eliminate redundancy in a number stream; -#X text 12 65 INLET_0 float bang set; -#X text 12 85 OUTLET_0 float; -#X text 12 165 RELEASE_DATE 2009; -#X restore 500 597 pd META; -#X obj -1 481 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj -1 524 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj -1 566 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 -12 0 13 -228856 -1 0; -#X obj 78 346 cnv 17 3 125 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#N canvas 210 534 428 104 Related_objects 0; -#X obj 15 31 spigot; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 1 [change] Related Objects; -#X obj 65 31 select; -#X restore 101 597 pd Related_objects; -#X obj 78 490 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 499 11 change; -#X msg 22 108 1; -#X msg 50 108 1; -#X msg 79 108 1; -#X msg 112 107 0; -#X text 20 90 Click from left to right...; -#X obj 22 139 change; -#X obj 22 160 print; -#X text 61 161 watch the console; -#X obj 22 218 change 6.5; -#X obj 22 241 print; -#X msg 22 189 6.5; -#X msg 52 189 5.5; -#X msg 88 190 bang; -#X text 93 218 creation argument; -#X text 98 345 bang; -#X text 98 375 float; -#X text 98 405 list; -#X text 98 444 set; -#X floatatom 210 271 0 0 0 0 - - -; -#X floatatom 210 182 0 0 0 0 - - -; -#X floatatom 248 198 0 0 0 0 - - -; -#X msg 248 220 set \$1; -#X text 293 220 set the value; -#X text 247 179 if different from current value \, output and set; -#X obj 210 292 print; -#X obj 210 249 change; -#X text 206 147 The "set" method can be used to store a number in the -object without outputting that value.; -#X text 98 490 float; -#X text 11 23 eliminate redundancy in a number stream; -#X text 167 543 - (optional) a number to specify the initial value. -; -#X text 168 345 - sending a bang message to the inlet will force [change] -to output its current value.; -#X text 168 375 - a float will be output only if it differs from the -previous value of [change].; -#X text 168 405 - lists will be truncated and the first element will -be output only if it differs from the previous value of [change].; -#X text 168 490 - if the incoming float was different than the previous -value \, it will be sent to the outlet.; -#X text 80 543 1) float; -#X text 168 444 "set" followed by a value (e.g. \, "set 12") will set -the value of [change] without outputting it.; -#X text 18 59 The change object passes its input to the outlet only -when it changes.; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X connect 11 0 16 0; -#X connect 12 0 16 0; -#X connect 13 0 16 0; -#X connect 14 0 16 0; -#X connect 16 0 17 0; -#X connect 19 0 20 0; -#X connect 21 0 19 0; -#X connect 22 0 19 0; -#X connect 23 0 19 0; -#X connect 29 0 35 0; -#X connect 30 0 36 0; -#X connect 31 0 32 0; -#X connect 32 0 36 0; -#X connect 36 0 29 0; diff --git a/doc/pddp/clip-help.pd b/doc/pddp/clip-help.pd deleted file mode 100644 index 2058dfe06..000000000 --- a/doc/pddp/clip-help.pd +++ /dev/null @@ -1,141 +0,0 @@ -#N canvas 424 40 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 clip 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 478 290 494 344 META 0; -#X text 12 145 LIBRARY internal; -#X text 12 185 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 165 AUTHOR Miller Puckette; -#X text 12 225 HELP_PATCH_AUTHORS Dave Sabine \, April 25 \, 2003 Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 5 KEYWORDS control filter; -#X text 12 45 DESCRIPTION force a number to lie between two limits -; -#X text 12 65 INLET_0 float list; -#X text 12 125 OUTLET_0 float; -#X text 12 85 INLET_1 float; -#X text 12 105 INLET_2 float; -#X text 12 205 RELEASE_DATE 2009; -#X restore 500 597 pd META; -#X obj 0 415 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 458 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 533 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#X obj 78 306 cnv 17 3 45 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#N canvas 207 532 428 102 Related_objects 0; -#X obj 234 43 int; -#X obj 274 42 f; -#X obj 22 42 min; -#X obj 65 42 max; -#X obj 105 42 clip~; -#X obj 149 42 min~; -#X obj 191 42 max~; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 1 [clip] Related Objects; -#X restore 101 597 pd Related_objects; -#X obj 78 424 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 362 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 98 361 float; -#X obj 78 387 cnv 17 3 17 empty \$0-pddp.cnv.let.2 2 5 9 0 16 -228856 --162280 0; -#X text 98 386 float; -#X obj 504 11 clip; -#X obj 306 179 clip -50 50; -#X floatatom 306 205 5 0 0 0 - - -, f 5; -#X floatatom 306 141 5 0 0 0 - - -, f 5; -#X text 383 177 creation arguments; -#X obj 128 179 clip; -#X floatatom 138 140 5 0 0 0 - - -, f 5; -#X floatatom 181 140 5 0 0 0 - - -, f 5; -#X floatatom 224 140 5 0 0 0 - - -, f 5; -#X floatatom 128 205 5 0 0 0 - - -, f 5; -#X text 171 179 no arguments; -#X text 205 108 list; -#X msg 128 108 42 100 500; -#X text 98 305 float; -#X text 168 305 - a float at the left inlet will be clipped to the -low and high values stored in the object.; -#X text 98 424 float; -#N canvas 102 355 428 206 clip_vs_min_and_max 0; -#X text 10 70 Consider the following:; -#X floatatom 50 96 5 0 0 0 - - -, f 5; -#X floatatom 50 177 5 0 0 0 - - -, f 5; -#X obj 50 151 min 50; -#X obj 50 125 max -50; -#X text 137 136 same as; -#X obj 257 148 clip -50 50; -#X floatatom 257 177 5 0 0 0 - - -, f 5; -#X text 10 37 [clip] is a tool which combines the functionality of -[min] and [max] into a single object.; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 1 [clip] Relationship between [clip] and [min] \, [max]; -#X connect 1 0 4 0; -#X connect 1 0 6 0; -#X connect 3 0 2 0; -#X connect 4 0 3 0; -#X connect 6 0 7 0; -#X restore 101 567 pd clip_vs_min_and_max; -#N canvas 99 243 428 294 low_and_high_values 0; -#X text 35 32 [clip] always assumes that the first argument (second -inlet) is the low extreme of the range and the second argument (third -inlet) is the high extreme. However \, strange behaviour should be -expected if you mix these arguments up.; -#X obj 43 155 clip -50 50; -#X obj 169 149 clip 72 -104; -#X floatatom 43 122 5 0 0 0 - - -, f 5; -#X floatatom 43 184 5 0 0 0 - - -, f 5; -#X floatatom 169 181 5 0 0 0 - - -, f 5; -#X text 174 104 Numbers below 72 are clipped to 72; -#X text 174 124 Numbers above -104 are clipped to -104; -#X floatatom 311 258 5 0 0 0 - - -, f 5; -#X obj 311 214 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0 -1; -#X obj 311 236 clip 1 -1024; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 1 [clip] Low and High Values; -#X text 114 238 This could be used effectively; -#X text 114 253 to toggle between two numbers.; -#X connect 1 0 4 0; -#X connect 2 0 5 0; -#X connect 3 0 1 0; -#X connect 3 0 2 0; -#X connect 9 0 10 0; -#X connect 10 0 8 0; -#X restore 101 542 pd low_and_high_values; -#X text 11 23 force a number to lie between two limits; -#X text 168 424 - outputs a float which is limited to a range within -the high and low values of the middle and last inlet.; -#X text 167 477 - (optional) initial minimum value beyond which to -clip the signal.; -#X text 167 502 - (optional) initial maximum value beyond which to -clip the signal.; -#X text 80 477 1) float; -#X text 80 502 2) float; -#X text 168 386 - maximum value beyond which the incoming signal is -clipped.; -#X text 168 361 - minimum value beyond which the incoming signal is -clipped.; -#X text 98 335 list; -#X text 168 335 - a list is distributed to the inlets of [clip].; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X connect 15 0 16 0; -#X connect 17 0 15 0; -#X connect 19 0 23 0; -#X connect 20 0 19 0; -#X connect 21 0 19 1; -#X connect 22 0 19 2; -#X connect 26 0 19 0; diff --git a/doc/pddp/clip~-help.pd b/doc/pddp/clip~-help.pd deleted file mode 100644 index 12dc750bc..000000000 --- a/doc/pddp/clip~-help.pd +++ /dev/null @@ -1,90 +0,0 @@ -#N canvas 425 36 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 clip~ 3 12 0 18 --204280 -1 0; -#X obj 0 357 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 481 286 494 344 META 0; -#X text 12 145 LIBRARY internal; -#X text 12 185 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 165 AUTHOR Miller Puckette; -#X text 12 225 HELP_PATCH_AUTHORS Updated for Pd version 0.33. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 5 KEYWORDS signal filter; -#X text 12 45 DESCRIPTION restrict a signal to lie between two limits -; -#X text 12 125 OUTLET_0 signal; -#X text 12 65 INLET_0 signal; -#X text 12 85 INLET_1 float; -#X text 12 105 INLET_2 float; -#X text 12 205 RELEASE_DATE 2009; -#X restore 500 597 pd META; -#X obj 0 449 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 486 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 566 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#X obj 78 366 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#N canvas 208 523 428 108 Related_objects 0; -#X obj 23 36 min~; -#X obj 70 36 max~; -#X obj 118 36 clip; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 1 [clip~] Related Objects; -#X restore 101 597 pd Related_objects; -#X text 98 365 signal; -#X obj 78 458 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 458 signal; -#X obj 502 12 clip~; -#X obj 41 177 clip~ -0.5 0.5; -#X obj 41 117 osc~ 1000; -#X obj 57 226 metro 500; -#X text 209 149 inlets to reset clip range; -#X floatatom 101 149 4 0 0 0 - - -, f 4; -#X floatatom 162 150 4 0 0 0 - - -, f 4; -#X text 176 177 creation arguments initialize clip range; -#X text 183 250 <- graph the output; -#X obj 78 396 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 98 395 float; -#X obj 78 421 cnv 17 3 17 empty \$0-pddp.cnv.let.2 2 5 9 0 16 -228856 --162280 0; -#X text 98 420 float; -#X obj 57 203 loadbang; -#N canvas 0 0 450 300 (subpatch) 0; -#X array \$0-array 100 float 0; -#X coords 0 1 100 -1 200 100 1 0 0; -#X restore 343 238 graph; -#X text 11 23 restrict a signal to lie between two limits; -#X text 168 365 - an incoming signal at the left inlet will be clipped -to lie between the two limits.; -#X text 168 458 - outputs the clipped signal.; -#X text 168 505 - (optional) initial minimum value beyond which to -clip the signal.; -#X text 168 535 - (optional) initial maximum value beyond which to -clip the signal.; -#X text 80 505 1) float; -#X text 80 535 2) float; -#X text 81 67 The [clip~] object passes its signal input to its output -\, clipping it to lie between two limits.; -#X text 168 395 - minimum value below which the incoming signal is -clipped.; -#X text 168 420 - maximum value above which the incoming signal is -clipped.; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 476 52 pddp/dsp; -#X obj 41 250 tabwrite~ \$0-array; -#X connect 13 0 39 0; -#X connect 14 0 13 0; -#X connect 15 0 39 0; -#X connect 17 0 13 1; -#X connect 18 0 13 2; -#X connect 25 0 15 0; diff --git a/doc/pddp/cos~-help.pd b/doc/pddp/cos~-help.pd deleted file mode 100644 index 8abd2e253..000000000 --- a/doc/pddp/cos~-help.pd +++ /dev/null @@ -1,140 +0,0 @@ -#N canvas 425 36 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 cos~ 3 12 0 18 -204280 --1 0; -#X obj 0 440 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 477 283 494 344 META 0; -#X text 12 105 LIBRARY internal; -#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 125 AUTHOR Miller Puckette; -#X text 12 185 HELP_PATCH_AUTHORS Updated for Pd version 0.41. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 5 KEYWORDS signal trigonometry; -#X text 12 45 DESCRIPTION cosine waveshaper; -#X text 12 65 INLET_0 signal; -#X text 12 85 OUTLET_0 signal; -#X text 12 165 RELEASE_DATE 1997; -#X restore 500 598 pd META; -#X obj 0 477 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 532 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 560 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 211 524 428 103 Related_objects 0; -#X obj 19 33 osc~; -#X obj 68 33 tabread4~; -#X obj 138 33 phasor~; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 1 [cos~] Related Objects; -#X restore 102 598 pd Related_objects; -#X obj 78 486 cnv 17 3 35 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 449 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 449 signal; -#X text 98 486 signal; -#X text 158 486 - [cos~] outputs the cosine of two pi times its signal -input. So -1 \, 0 \, 1 and 2 give 1 out \, 0.5 gives -1 \, and so on. -; -#X text 98 536 (none); -#X obj 505 11 cos~; -#X obj 131 240 cos~; -#X obj 131 289 snapshot~; -#X obj 131 192 sig~; -#X floatatom 131 315 7 0 0 0 - - -, f 7; -#X obj 131 165 * 0.01; -#X floatatom 131 138 0 0 0 0 - - -; -#X obj 198 255 metro 500; -#X obj 198 229 r metro; -#X text 194 165 Divide by 100; -#X text 179 193 convert to audio; -#X text 186 140 <-- Scroll to set input value; -#X text 205 315 <-- output of the cos~ object; -#X obj 470 126 loadbang; -#X obj 470 150 s metro; -#N canvas 107 147 428 410 cos~_vs_osc~ 0; -#X obj 63 164 cos~; -#X obj 63 136 phasor~; -#X text 16 146 this:; -#X text 165 139 is the same; -#X text 166 158 as this:; -#X obj 251 140 osc~; -#X text 18 28 ( from audio tutorial E08.phase.mod.pd ); -#X obj 111 206 tgl 20 0 empty empty empty 17 7 0 10 -262144 -1 -1 0 -1; -#X text 136 206 click to visualize; -#N canvas 0 0 450 300 (subpatch) 0; -#X array cos~-array1 100 float 3; -#A 0 -0.753024 -0.792766 -0.829394 -0.862767 -0.892751 -0.919226 -0.94208 --0.961235 -0.976614 -0.988159 -0.995823 -0.999576 -0.999404 -0.995308 --0.987303 -0.975405 -0.959676 -0.94018 -0.916991 -0.890202 -0.859916 --0.826254 -0.789346 -0.749339 -0.70638 -0.660644 -0.612314 -0.561581 --0.508642 -0.453706 -0.396988 -0.33871 -0.279102 -0.218395 -0.156829 --0.0946478 -0.0320953 0.0305825 0.0931407 0.155333 0.216916 0.277648 -0.337288 0.3956 0.452358 0.507339 0.560328 0.611116 0.659504 0.705303 -0.748333 0.788423 0.825405 0.859146 0.889513 0.916386 0.939661 0.959246 -0.975064 0.987053 0.995167 0.999358 0.999623 0.995963 0.988392 0.97694 -0.961651 0.942586 0.91982 0.893441 0.863544 0.830252 0.793699 0.75403 -0.7114 0.665977 0.617938 0.567472 0.514777 0.460057 0.403526 0.345411 -0.28594 0.225346 0.163868 0.101745 0.0392234 -0.0234532 -0.0860385 --0.148284 -0.209948 -0.270786 -0.33056 -0.389036 -0.445985 -0.501182 --0.554412 -0.605466 -0.654132 -0.700229; -#X coords 0 1 99 -1 100 60 1; -#X restore 64 328 graph; -#X obj 64 278 tabwrite~ cos~-array1; -#X msg 63 70 440; -#N canvas 0 0 450 300 (subpatch) 0; -#X array osc~-array1 100 float 3; -#A 0 0.779374 0.738588 0.694902 0.648488 0.599526 0.548211 0.494742 -0.43933 0.382189 0.323544 0.263629 0.202679 0.140933 0.0786344 0.0160266 --0.0466445 -0.109133 -0.171193 -0.232579 -0.293051 -0.352371 -0.410307 --0.466632 -0.521125 -0.573571 -0.623766 -0.671511 -0.71661 -0.758893 --0.798196 -0.834364 -0.867255 -0.896741 -0.922705 -0.945047 -0.963677 --0.978512 -0.9895 -0.996602 -0.99979 -0.999052 -0.994391 -0.985825 --0.973388 -0.957129 -0.937102 -0.913388 -0.886088 -0.855309 -0.82117 --0.783807 -0.743366 -0.700006 -0.653896 -0.605216 -0.554151 -0.500911 --0.445704 -0.388748 -0.330265 -0.270485 -0.209642 -0.147975 -0.085727 --0.0231406 0.0395359 0.102057 0.164176 0.225651 0.28624 0.345705 0.403812 -0.460335 0.515044 0.567729 0.618184 0.66621 0.711621 0.754237 0.793891 -0.830428 0.863704 0.893581 0.919942 0.942691 0.961737 0.977007 0.98844 -0.995992 0.999633 0.999348 0.995134 0.987001 0.974993 0.959156 0.939553 -0.91626 0.889369 0.858986 0.825229; -#X coords 0 1 99 -1 100 60 1; -#X restore 250 328 graph; -#X floatatom 63 101 5 0 0 0 - - -, f 5; -#X obj 250 278 tabwrite~ osc~-array1; -#X obj 111 236 metro 250; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 1 [cos~] What's the difference between [cos~] and [osc~]? -; -#X text 18 48 [phasor~] and [cos~] together are equivalent to [osc~] -; -#X connect 0 0 10 0; -#X connect 1 0 0 0; -#X connect 5 0 14 0; -#X connect 7 0 15 0; -#X connect 11 0 13 0; -#X connect 13 0 1 0; -#X connect 13 0 5 0; -#X connect 15 0 10 0; -#X connect 15 0 14 0; -#X restore 102 568 pd cos~_vs_osc~; -#X text 11 23 cosine waveshaper; -#X obj 4 598 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 472 52 pddp/dsp; -#X connect 15 0 16 0; -#X connect 16 0 18 0; -#X connect 17 0 15 0; -#X connect 19 0 17 0; -#X connect 20 0 19 0; -#X connect 21 0 16 0; -#X connect 22 0 21 0; -#X connect 27 0 28 0; diff --git a/doc/pddp/cpole~-help.pd b/doc/pddp/cpole~-help.pd deleted file mode 100644 index 6b011335e..000000000 --- a/doc/pddp/cpole~-help.pd +++ /dev/null @@ -1,188 +0,0 @@ -#N canvas 427 30 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 cpole~ 3 12 0 18 --204280 -1 0; -#X obj 0 287 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 480 218 494 405 META 0; -#X text 12 185 LIBRARY internal; -#X text 12 225 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 205 AUTHOR Miller Puckette; -#X text 12 265 HELP_PATCH_AUTHORS Updated for Pd version-0.38. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 5 KEYWORDS signal filter; -#X text 12 45 DESCRIPTION complex one-pole (recursive) filter \, raw -; -#X text 12 65 INLET_0 signal; -#X text 12 145 OUTLET_0 signal; -#X text 12 85 INLET_1 signal; -#X text 12 105 INLET_2 signal; -#X text 12 125 INLET_3 signal; -#X text 12 165 OUTLET_1 signal; -#X text 12 245 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 424 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 486 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 543 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 212 309 428 309 Related_objects 0; -#X obj 74 60 rzero~; -#X obj 25 80 cpole~; -#X obj 25 60 rpole~; -#X obj 123 60 rzero_rev~; -#X obj 74 80 czero~; -#X obj 123 80 czero_rev~; -#X text 201 60 real; -#X text 200 81 complex; -#X text 22 44 1-pole; -#X text 71 44 1-zero; -#X text 121 44 1-zero \, reversed; -#X text 47 29 summary of raw filters:; -#X text 18 184 User-friendly Filters; -#X obj 21 213 lop~; -#X obj 72 212 hip~; -#X obj 124 213 bp~; -#X obj 169 214 vcf~; -#X obj 22 274 biquad~; -#X text 18 250 Other Objects; -#X text 18 113 Pd also provides a suite of user-friendly filters. This -and other raw filters are provided for situations which the user-friendly -ones can't handle. See Chapter 8 of http://crca.ucsd.edu/~msp/techniques -for an introduction to the necessary theory.; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 1 [cpole~] Related Objects; -#X restore 101 597 pd Related_objects; -#X obj 78 433 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 296 cnv 17 3 45 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 296 signal; -#X text 98 433 signal; -#X obj 492 12 cpole~; -#X obj 57 132 osc~ 100; -#X msg 65 155 clear; -#X obj 84 199 sig~; -#X obj 121 200 sig~; -#X obj 158 200 sig~; -#X obj 56 230 cpole~ 0.9 0.4; -#X msg 67 177 set 0.6 0.8; -#X text 203 181 where y[n] is the output \, x[n] the input \, and a[n] -the filter coefficient (all complex numbers). The filter is unstable -if/when |a[n]|>1.; -#X text 203 223 The transfer function is H(Z) = 1/(1 - aZ^-1).; -#N canvas 45 205 428 355 test 0; -#X obj 66 88 osc~; -#X floatatom 66 65 5 0 0 0 - - -, f 5; -#X obj 8 297 env~ 16384; -#X floatatom 8 321 5 0 0 0 - - -, f 5; -#X obj 94 117 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0 1 -; -#X obj 66 115 *~; -#X msg 75 142 set 1; -#X floatatom 340 122 4 -1000 1000 0 - - -, f 4; -#X obj 205 325 dac~; -#X obj 205 289 *~; -#X text 70 28 Stuff to test it:; -#X obj 231 116 cos~; -#X obj 67 237 cpole~; -#X obj 251 75 phasor~; -#X floatatom 251 54 5 0 0 0 - - -, f 5; -#X floatatom 122 65 5 0 0 0 - - -, f 5; -#X obj 150 117 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0 -1; -#X obj 122 115 *~; -#X obj 122 88 phasor~; -#X floatatom 314 52 5 0 0 0 - - -, f 5; -#X obj 314 75 / 1000; -#X obj 264 117 -~ 0.25; -#X obj 264 139 cos~; -#X obj 340 141 / 1000; -#X obj 230 167 *~; -#X obj 264 167 *~; -#X obj 84 297 env~ 16384; -#X floatatom 84 321 5 0 0 0 - - -, f 5; -#X obj 237 285 dbtorms; -#X floatatom 238 265 5 0 0 0 - - -, f 5; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 1 [cpole~] Test; -#X connect 0 0 5 0; -#X connect 1 0 0 0; -#X connect 2 0 3 0; -#X connect 4 0 5 1; -#X connect 5 0 12 0; -#X connect 6 0 12 0; -#X connect 7 0 23 0; -#X connect 9 0 8 0; -#X connect 9 0 8 1; -#X connect 11 0 24 0; -#X connect 12 0 2 0; -#X connect 12 0 9 0; -#X connect 12 1 26 0; -#X connect 13 0 21 0; -#X connect 13 0 11 0; -#X connect 14 0 13 0; -#X connect 15 0 18 0; -#X connect 16 0 17 1; -#X connect 17 0 12 0; -#X connect 18 0 17 0; -#X connect 19 0 20 0; -#X connect 20 0 13 1; -#X connect 21 0 22 0; -#X connect 22 0 25 0; -#X connect 23 0 25 1; -#X connect 23 0 24 1; -#X connect 24 0 12 2; -#X connect 25 0 12 3; -#X connect 26 0 27 0; -#X connect 28 0 9 1; -#X connect 29 0 28 0; -#X restore 102 552 pd test; -#X text 98 311 clear; -#X text 98 326 set; -#X obj 78 346 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 98 346 signal; -#X obj 78 371 cnv 17 3 17 empty \$0-pddp.cnv.let.2 2 5 9 0 16 -228856 --162280 0; -#X text 98 371 signal; -#X obj 78 396 cnv 17 3 17 empty \$0-pddp.cnv.let.3 3 5 9 0 16 -228856 --162280 0; -#X obj 78 458 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 98 458 signal; -#X text 11 23 complex one-pole (recursive) filter \, raw; -#X text 98 396 signal; -#X text 168 296 - signal to filter (real part).; -#X text 168 311 - clear internal state to zero.; -#X text 168 326 - set internal state (real & imaginary parts).; -#X text 168 346 - signal to filter ( imaginary part ).; -#X text 168 371 - filter coefficient ( real part ).; -#X text 168 396 - filter coefficient ( imaginary part ).; -#X text 169 504 - (optional) coefficient (real).; -#X text 169 519 - (optional) coefficient (imaginary).; -#X text 80 504 1) float; -#X text 80 519 2) float; -#X text 202 134 The action of [cpole~] is:; -#X text 85 68 [cpole~] filters a complex audio signal (first two inlets) -via a one-pole filter \, whose coefficients are controlled by creation -arguments or by another complex audio signal (remaining two inlets). -; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 480 51 pddp/dsp; -#X obj 102 572 pddp/pddplink ../3.audio.examples/H12.peaking.pd -text -doc/3.audio.examples/H12.peaking.pd; -#X text 208 160 y[n] = x[n] + a[n] * y[n-1]; -#X connect 13 0 18 0; -#X connect 14 0 18 0; -#X connect 15 0 18 1; -#X connect 16 0 18 2; -#X connect 17 0 18 3; -#X connect 19 0 18 0; diff --git a/doc/pddp/cputime-help.pd b/doc/pddp/cputime-help.pd deleted file mode 100644 index 204b364f9..000000000 --- a/doc/pddp/cputime-help.pd +++ /dev/null @@ -1,167 +0,0 @@ -#N canvas 427 38 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 cputime 3 12 0 18 --204280 -1 0; -#X obj 0 333 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 483 273 494 360 META 0; -#X text 12 125 LIBRARY internal; -#X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 145 AUTHOR Miller Puckette; -#X text 12 205 HELP_PATCH_AUTHORS This help patch was updated for Pd -version 0.35 test 28 by Dave Sabine as part of a project called pddp -proposed by Krzysztof Czaja to build comprehensive documentation for -Pd. Jonathan Wilkes revised the patch to conform to the PDDP template -for Pd version 0.42.; -#X text 12 5 KEYWORDS control time; -#X text 12 45 DESCRIPTION measure CPU time; -#X text 12 65 INLET_0 bang; -#X text 12 85 INLET_1 bang; -#X text 12 105 OUTLET_0 float; -#X text 12 185 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 407 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 450 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 478 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#X obj 78 342 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 454 (none); -#X text 98 416 float; -#N canvas 214 380 428 252 Related_objects 0; -#X obj 125 35 metro; -#X obj 62 35 realtime; -#X obj 14 36 timer; -#X obj 173 35 delay; -#X text 11 170 The best places to find information about Pd's libraries -is:; -#X text 8 192 www.puredata.org and click on "Downloads" then "Software" -; -#X text 10 207 or; -#X text 10 222 iem.kug.ac.at/pdb/; -#X text 12 121 This object is only offered in Pd only if you have downloaded -and properly installed the appropriate library. These objects may or -may not exist in a single library.; -#X text 11 71 Externals; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 1 [cputime] Related Objects; -#X obj 11 91 pddp/helplink iemlib/t3_timer; -#X restore 102 597 pd Related_objects; -#X obj 493 10 cputime; -#X msg 122 156 bang; -#X msg 83 134 bang; -#X floatatom 83 200 0 0 0 0 - - -; -#X text 155 202 Output is in milliseconds; -#X text 118 134 Click here to start or reset; -#X text 78 57 The [cputime] object measures elapsed CPU time. CPU time -is the amount of time your computer's CPU requires to perform a task --- that's a short definition.; -#X obj 83 178 cputime; -#X text 160 157 Click here to get elapsed CPU time. Click again...and -again...to see periodic measurements from the start or reset time. -Be patient.; -#X obj 78 374 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 98 373 bang; -#X text 168 416 - the elapsed time in milliseconds arrives at the outlet -when the right inlet receives a bang.; -#X text 80 264 NOTE: Unlike most other objects in Pd \, the right inlet -of [cputime] is the hot one (i.e. \, a bang to it triggers the output). -; -#N canvas 70 46 428 538 Time_Measurements 0; -#X obj 30 395 time_measurements; -#X obj 30 291 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X floatatom 30 437 0 0 0 0 - - -; -#X floatatom 116 436 0 0 0 0 - - -; -#X floatatom 183 436 0 0 0 0 - - -; -#X text 27 208 In the example below \, I've created an abstraction -which will force each of Pd's stop-watches \, [timer] [cputime] and -[realtime] to measure various processes and report the elapsed time. -Click on each [bng] to begin the process and wait for the results. -Notice the discrepancies in the results.; -#X text 28 455 Logical Time; -#X text 181 455 Real Time; -#X text 115 455 CPU Time; -#X obj 45 327 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X text 50 285 1 Measures elapsed time between two "bangs" from a [trigger] -object.; -#X text 65 319 2 Measures the amount of time Pd requires to turn on -DSP and start an oscillator.; -#X obj 89 359 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X text 27 487 This document was updated for Pd version 0.35 test 28 -by Dave Sabine as part of a project called pddp proposed by Krzysztof -Czaja to build comprehensive documentation for Pd.; -#X text 110 351 3 Measures the amount of time Pd requires count to -three...please wait for approximately 3 seconds.; -#X text 27 35 [cputime] works like essentially like a stop-watch. Once -it starts \, you can continue to "poll" [cputime] to view the elapsed -time.; -#X text 27 82 The odd aspect about comparing [cputime] to a stop-watch -is that a stop-watch can be stopped! [cputime] can only be started -or reset. It cannot be stopped.; -#X text 26 132 As stated above \, [cputime] measures "CPU" time. This -value may be slightly different than "logical" time or "real" time. -PD offers two objects which measure "logical" time and "real" time. -See the reference documents for those objects for more information. -; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 1 [cputime] Time Measurements; -#X connect 0 0 2 0; -#X connect 0 1 3 0; -#X connect 0 2 4 0; -#X connect 1 0 0 0; -#X connect 9 0 0 1; -#X connect 12 0 0 2; -#X restore 102 511 pd Time_Measurements; -#N canvas 70 77 428 430 Time_Objects 0; -#X text 21 37 In a fantasy world \, computers could exist somehow beyond -the restrictions of time and digital computation could be performed -in ZERO time. However \, that is not the case. Instead \, every process -within Pd and within your operating system requires at least a few -nanoseconds of your CPU's time.; -#X text 22 122 The [timer] object is like a clock that is not constrained -to the regular laws of physics and the universal space-time continuum. -It reports "time" measurements as only Pd can see them!; -#X text 23 181 The [cputime] object is like a clock that measures how -much time your CPU actually required to carry out your request. Keep -in mind however that your CPU is busy doing many things simoultaneously -\, so even though a process might take 5 minutes to complete \, your -CPU does not pay full attention to that process for the entire 5 minutes. -Instead \, it simply begins the process \, then refers back to that -process from time to time until the it is complete. In other cases -\, your CPU might require a full 5 minutes while Pd might report that -merely a few milliseconds have passed. This type of discrepancy depends -heavily on your computer's hardware and the type of processing it is -performing.; -#X text 24 350 The [realtime] object is as much like your own wrist -watch as Pd can possibly manage. It measures time according to your -operating system's internal clock.; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 1 [cputime] Why the Discrepencies Between Clocks?; -#X restore 102 486 pd Time_Objects; -#X obj 78 416 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 11 23 measure CPU time; -#X text 98 341 bang; -#X text 168 341 - an initial bang to the left inlet starts the timer. -Subsequent bangs reset the timer.; -#X text 168 373 - a bang to the right inlet causes the elapsed time -to be output (in milliseconds).; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X text 101 531 For a patch that uses [cputime] see:; -#X obj 98 551 pddp/pddplink ../7.stuff/tools/load-meter.pd; -#X text 101 571 (also accessible from the "Media" menu); -#X connect 12 0 18 1; -#X connect 13 0 18 0; -#X connect 18 0 14 0; diff --git a/doc/pddp/czero_rev~-help.pd b/doc/pddp/czero_rev~-help.pd deleted file mode 100644 index dd31b1624..000000000 --- a/doc/pddp/czero_rev~-help.pd +++ /dev/null @@ -1,206 +0,0 @@ -#N canvas 427 33 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 czero_rev~ 3 12 -0 18 -204280 -1 0; -#X obj 0 303 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 484 243 494 384 META 0; -#X text 12 195 LIBRARY internal; -#X text 12 235 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 215 AUTHOR Miller Puckette; -#X text 12 275 HELP_PATCH_AUTHORS Updated for Pd version-0.38. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 5 KEYWORDS signal filter; -#X text 12 25 LICENSE SIBSD; -#X text 12 75 INLET_0 signal set clear; -#X text 12 95 INLET_1 signal; -#X text 12 115 INLET_2 signal; -#X text 12 135 INLET_3 signal; -#X text 12 155 OUTLET_0 signal; -#X text 12 175 OUTLET_1 signal; -#X text 12 255 RELEASE_DATE 1997; -#X text 12 45 DESCRIPTION complex one-zero (non-recursive) "reverse" -filter \, raw; -#X restore 500 597 pd META; -#X obj 0 440 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 502 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 559 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 207 322 428 309 Related_objects 0; -#X obj 74 60 rzero~; -#X obj 25 80 cpole~; -#X obj 25 60 rpole~; -#X obj 123 60 rzero_rev~; -#X obj 74 80 czero~; -#X obj 123 80 czero_rev~; -#X text 201 60 real; -#X text 200 81 complex; -#X text 22 44 1-pole; -#X text 71 44 1-zero; -#X text 121 44 1-zero \, reversed; -#X text 47 29 summary of raw filters:; -#X text 19 184 User-friendly Filters; -#X obj 22 213 lop~; -#X obj 73 212 hip~; -#X obj 125 213 bp~; -#X obj 170 214 vcf~; -#X obj 23 274 biquad~; -#X text 19 250 Other Objects; -#X text 19 113 Pd also provides a suite of user-friendly filters. This -and other raw filters are provided for situations which the user-friendly -ones can't handle. See Chapter 8 of http://crca.ucsd.edu/~msp/techniques -for an introduction to the necessary theory.; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 1 [czero_rev~] Related Objects; -#X restore 101 597 pd Related_objects; -#X obj 78 449 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 312 cnv 17 3 45 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 312 signal; -#X text 98 449 signal; -#N canvas 3 174 550 380 test 0; -#X obj 152 296 env~ 16384; -#X floatatom 152 320 5 0 0 0 - - -, f 5; -#X floatatom 499 76 4 -1000 1000 0 - - -, f 4; -#X obj 349 324 dac~; -#X obj 349 288 *~; -#X obj 390 70 cos~; -#X floatatom 298 8 5 0 0 0 - - -, f 5; -#X obj 298 31 phasor~; -#X floatatom 398 14 5 0 0 0 - - -, f 5; -#X obj 397 39 / 1000; -#X obj 423 71 -~ 0.25; -#X obj 423 93 cos~; -#X obj 499 95 / 1000; -#X obj 389 121 *~; -#X obj 423 121 *~; -#X obj 228 296 env~ 16384; -#X floatatom 228 320 5 0 0 0 - - -, f 5; -#X obj 381 284 dbtorms; -#X floatatom 382 264 5 0 0 0 - - -, f 5; -#X obj 117 89 phasor~; -#X floatatom 115 60 5 0 0 0 - - -, f 5; -#X text 77 13 Stuff to test it:; -#X obj 131 149 cpole~; -#X obj 241 262 *~ -1; -#X obj 21 261 env~ 16384; -#X floatatom 21 285 5 0 0 0 - - -, f 5; -#X obj 50 312 env~ 16384; -#X floatatom 50 336 5 0 0 0 - - -, f 5; -#X obj 138 181 cpole~; -#X obj 146 216 czero_rev~; -#X obj 154 264 czero_rev~; -#X msg 204 103 clear; -#X obj 262 50 cos~; -#X obj 261 83 *~ 0.02; -#X obj 193 50 sig~ 1.1; -#X obj 448 296 *~; -#X connect 0 0 1 0; -#X connect 2 0 12 0; -#X connect 4 0 3 0; -#X connect 5 0 13 0; -#X connect 6 0 7 0; -#X connect 7 0 32 0; -#X connect 8 0 9 0; -#X connect 9 0 7 1; -#X connect 10 0 11 0; -#X connect 11 0 14 0; -#X connect 12 0 14 1; -#X connect 12 0 13 1; -#X connect 13 0 22 2; -#X connect 13 0 28 2; -#X connect 13 0 29 2; -#X connect 13 0 30 2; -#X connect 14 0 22 3; -#X connect 14 0 23 0; -#X connect 14 0 29 3; -#X connect 15 0 16 0; -#X connect 17 0 4 1; -#X connect 17 0 35 1; -#X connect 18 0 17 0; -#X connect 19 0 22 0; -#X connect 19 0 24 0; -#X connect 19 0 35 0; -#X connect 20 0 19 0; -#X connect 22 0 28 0; -#X connect 22 1 28 1; -#X connect 23 0 28 3; -#X connect 23 0 30 3; -#X connect 24 0 25 0; -#X connect 26 0 27 0; -#X connect 28 0 26 0; -#X connect 28 0 29 0; -#X connect 28 1 29 1; -#X connect 29 0 30 0; -#X connect 29 1 30 1; -#X connect 30 0 0 0; -#X connect 30 0 4 0; -#X connect 30 1 15 0; -#X connect 31 0 22 0; -#X connect 31 0 28 0; -#X connect 32 0 33 0; -#X connect 33 0 5 0; -#X connect 33 0 10 0; -#X connect 34 0 33 0; -#X connect 35 0 3 1; -#X restore 101 568 pd test; -#X text 98 327 clear; -#X text 98 342 set; -#X obj 78 362 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 98 362 signal; -#X obj 78 387 cnv 17 3 17 empty \$0-pddp.cnv.let.2 2 5 9 0 16 -228856 --162280 0; -#X text 98 387 signal; -#X obj 78 412 cnv 17 3 17 empty \$0-pddp.cnv.let.3 3 5 9 0 16 -228856 --162280 0; -#X text 98 412 signal; -#X obj 78 474 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 98 474 signal; -#X obj 474 10 czero_rev~; -#X text 198 196 where y[n] is the output \, x[n] the input \, and a[n] -the filter coefficient (all complex numbers). The filter is always -stable.; -#X text 261 176 y[n] = - a[n] * x[n] + x[n-1]; -#X text 199 245 The transfer function is H(Z) = -a + Z^-1.; -#X obj 52 127 osc~ 100; -#X msg 60 152 clear; -#X obj 86 203 sig~; -#X obj 120 225 sig~; -#X obj 156 245 sig~; -#X msg 67 178 set 0.6 0.8; -#X obj 51 268 czero_rev~ 0.9 0.4; -#X text 11 23 complex one-zero (non-recursive) "reverse" filter \, -raw; -#X text 158 312 - signal to filter (real part).; -#X text 158 327 - clear internal state to zero.; -#X text 158 342 - set internal state (real & imaginary parts).; -#X text 158 362 - signal to filter ( imaginary part ).; -#X text 158 387 - filter coefficient ( real part ).; -#X text 158 412 - filter coefficient ( imaginary part ).; -#X text 157 521 - (optional) filter coefficient (real part).; -#X text 157 536 - (optional) filter coefficient (imaginary part).; -#X text 80 521 1) float; -#X text 80 536 2) float; -#X text 93 57 [czero_rev~] filters a complex audio signal (first two -inlets) via a one-zero filter \, whose coefficients are controlled -by creation arguments or by another complex audio signal (remaining -two inlets). The impulse response is that of "rzero" reversed in time. -; -#X text 201 155 The action of [czero_rev~] is:; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 476 56 pddp/dsp; -#X connect 27 0 33 0; -#X connect 28 0 33 0; -#X connect 29 0 33 1; -#X connect 30 0 33 2; -#X connect 31 0 33 3; -#X connect 32 0 33 0; diff --git a/doc/pddp/czero~-help.pd b/doc/pddp/czero~-help.pd deleted file mode 100644 index e19e8f7be..000000000 --- a/doc/pddp/czero~-help.pd +++ /dev/null @@ -1,190 +0,0 @@ -#N canvas 427 33 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 czero~ 3 12 0 18 --204280 -1 0; -#X obj 0 288 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 482 237 491 389 META 0; -#X text 12 185 LIBRARY internal; -#X text 12 225 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 205 AUTHOR Miller Puckette; -#X text 12 265 HELP_PATCH_AUTHORS Updated for Pd version-0.38. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 5 KEYWORDS signal filter; -#X text 12 45 DESCRIPTION complex one-zero (non-recursive) filter \, -raw; -#X text 12 65 INLET_0 signal clear set; -#X text 12 85 INLET_1 signal; -#X text 12 105 INLET_2 signal; -#X text 12 125 INLET_3 signal; -#X text 12 145 OUTLET_0 signal; -#X text 12 165 OUTLET_1 signal; -#X text 12 245 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 425 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 487 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 543 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 214 316 428 309 Related_objects 0; -#X obj 75 61 rzero~; -#X obj 26 81 cpole~; -#X obj 26 61 rpole~; -#X obj 124 61 rzero_rev~; -#X obj 75 81 czero~; -#X obj 124 81 czero_rev~; -#X text 202 61 real; -#X text 201 82 complex; -#X text 23 45 1-pole; -#X text 72 45 1-zero; -#X text 122 45 1-zero \, reversed; -#X text 48 30 summary of raw filters:; -#X text 22 185 User-friendly Filters; -#X obj 25 214 lop~; -#X obj 76 213 hip~; -#X obj 128 214 bp~; -#X obj 173 215 vcf~; -#X obj 26 275 biquad~; -#X text 22 251 Other Objects; -#X text 22 114 Pd also provides a suite of user-friendly filters. This -and other raw filters are provided for situations which the user-friendly -ones can't handle. See Chapter 8 of http://crca.ucsd.edu/~msp/techniques -for an introduction to the necessary theory.; -#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 [czero~] Related Objects; -#X restore 102 597 pd Related_objects; -#X obj 78 434 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 297 cnv 17 3 45 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 297 signal; -#X text 98 434 signal; -#N canvas 21 185 498 375 test 0; -#X obj 88 282 env~ 16384; -#X floatatom 88 306 5 0 0 0 - - -, f 5; -#X floatatom 420 107 4 -1000 1000 0 - - -, f 4; -#X obj 285 310 dac~; -#X obj 285 274 *~; -#X obj 311 101 cos~; -#X floatatom 237 46 5 0 0 0 - - -, f 5; -#X obj 265 98 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0 1 -; -#X obj 237 96 *~; -#X obj 237 69 phasor~; -#X floatatom 318 52 5 0 0 0 - - -, f 5; -#X obj 318 75 / 1000; -#X obj 344 102 -~ 0.25; -#X obj 344 124 cos~; -#X obj 420 126 / 1000; -#X obj 310 152 *~; -#X obj 344 152 *~; -#X obj 164 282 env~ 16384; -#X floatatom 164 306 5 0 0 0 - - -, f 5; -#X obj 317 270 dbtorms; -#X floatatom 318 250 5 0 0 0 - - -, f 5; -#X obj 181 206 czero~; -#X floatatom 137 118 4 -1000 1000 0 - - -, f 4; -#X obj 28 112 cos~; -#X obj 48 71 phasor~; -#X floatatom 51 46 5 0 0 0 - - -, f 5; -#X obj 61 113 -~ 0.25; -#X obj 61 135 cos~; -#X obj 137 137 / 1000; -#X obj 27 163 *~; -#X obj 61 163 *~; -#X text 150 13 Stuff to test it:; -#X connect 0 0 1 0; -#X connect 2 0 14 0; -#X connect 4 0 3 0; -#X connect 4 0 3 1; -#X connect 5 0 15 0; -#X connect 6 0 9 0; -#X connect 7 0 8 1; -#X connect 8 0 21 0; -#X connect 9 0 8 0; -#X connect 10 0 11 0; -#X connect 11 0 5 0; -#X connect 11 0 12 0; -#X connect 12 0 13 0; -#X connect 13 0 16 0; -#X connect 14 0 16 1; -#X connect 14 0 15 1; -#X connect 15 0 21 2; -#X connect 16 0 21 3; -#X connect 17 0 18 0; -#X connect 19 0 4 1; -#X connect 20 0 19 0; -#X connect 21 0 0 0; -#X connect 21 0 4 0; -#X connect 21 1 17 0; -#X connect 22 0 28 0; -#X connect 23 0 29 0; -#X connect 24 0 26 0; -#X connect 24 0 23 0; -#X connect 25 0 24 0; -#X connect 26 0 27 0; -#X connect 27 0 30 0; -#X connect 28 0 30 1; -#X connect 28 0 29 1; -#X connect 29 0 21 0; -#X connect 30 0 21 1; -#X restore 102 552 pd test; -#X text 98 312 clear; -#X text 98 327 set; -#X obj 78 347 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 98 347 signal; -#X obj 78 372 cnv 17 3 17 empty \$0-pddp.cnv.let.2 2 5 9 0 16 -228856 --162280 0; -#X text 98 372 signal; -#X obj 78 397 cnv 17 3 17 empty \$0-pddp.cnv.let.3 3 5 9 0 16 -228856 --162280 0; -#X text 98 397 signal; -#X obj 78 459 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 98 459 signal; -#X obj 42 111 osc~ 100; -#X msg 50 136 clear; -#X obj 69 187 sig~; -#X obj 96 209 sig~; -#X obj 126 229 sig~; -#X msg 57 162 set 0.6 0.8; -#X obj 41 252 czero~ 0.9 0.4; -#X obj 496 12 czero~; -#X text 179 152 The action of czero~ is:; -#X text 238 173 y[n] = x[n] - a[n] * x[n-1]; -#X text 176 193 where y[n] is the output \, x[n] the input \, and a[n] -the filter coefficient (all complex numbers). The filter is always -stable.; -#X text 175 248 The transfer function is H(Z) = 1 - aZ^-1.; -#X text 11 23 complex one-zero (non-recursive) filter \, raw; -#X text 168 297 - signal to filter (real part).; -#X text 168 312 - clear internal state to zero.; -#X text 168 327 - set internal state (real & imaginary parts).; -#X text 168 347 - signal to filter ( imaginary part ).; -#X text 168 372 - filter coefficient ( real part ).; -#X text 168 397 - filter coefficient ( imaginary part ).; -#X text 167 506 - (optional) filter coefficient (real part).; -#X text 167 521 - (optional) filter coefficient (imaginary part).; -#X text 80 506 1) float; -#X text 80 521 2) float; -#X text 84 53 [czero~] filters a complex audio signal (first two inlets) -via a one-zero filter \, whose coefficients are controlled by creation -arguments or by another complex audio signal (remaining two inlets). -; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 485 50 pddp/dsp; -#X obj 100 572 pddp/pddplink ../3.audio.examples/H12.peaking.pd -text -doc/3.audio.examples/H12.peaking.pd; -#X connect 23 0 29 0; -#X connect 24 0 29 0; -#X connect 25 0 29 1; -#X connect 26 0 29 2; -#X connect 27 0 29 3; -#X connect 28 0 29 0; diff --git a/doc/pddp/declare-help.pd b/doc/pddp/declare-help.pd deleted file mode 100644 index 046719bc0..000000000 --- a/doc/pddp/declare-help.pd +++ /dev/null @@ -1,68 +0,0 @@ -#N canvas 426 36 555 619 10; -#X declare; -#X declare; -#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 declare 3 12 0 18 --204280 -1 0; -#X obj 0 105 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 483 286 494 344 META 0; -#X text 12 65 LIBRARY internal; -#X text 12 105 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 85 AUTHOR Miller Puckette; -#X text 12 145 HELP_PATCH_AUTHORS Updated for Pd version 0.41. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 45 DESCRIPTION set environment for loading patch; -#X text 12 125 RELEASE_DATE 1997; -#X text 12 5 KEYWORDS control pd_op; -#X restore 500 597 pd META; -#X obj 0 134 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 164 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 386 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 215 523 428 103 Related_objects 0; -#X obj 15 34 import; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 1 [declare] Related Objects; -#X restore 101 597 pd Related_objects; -#X obj 494 12 declare; -#X text 98 109 (none); -#X text 98 139 (none); -#X text 164 291 -lib; -#X text 164 307 -stdlib; -#X text 164 255 -path; -#X text 164 271 -stdpath; -#X text 262 255 add to search path \, relative to the patch; -#X text 262 291 load a library \, relative to the patch; -#X text 262 308 load a library \, relative to Pd; -#X text 161 333 (for any of these you may use a full pathname such -as "/tmp/dir" or \, in Windows \, "C:/garbage" instead of a relative -path).; -#X text 262 272 add to search path \, relative to Pd; -#X text 98 482 WARNING: you might want to avoid putting "declare" statements -inside abstractions \, as their effects will extend to the calling -patch. As of version 0.41 \, "declare path" is ignored inside abstractions -\, although \, probably unwisely \, "-stdpath" takes effect (on the -calling patch as well as the abstraction.); -#X text 98 561 BUG: The name "-stdpath" is confusing \, as it has a -quite different effect from "-stdpath" on the pd command line.; -#X text 11 23 set environment for loading patch; -#X text 139 69 NEEDS AN EXAMPLE; -#X text 165 185 - the [declare] object adds one or more directories -to the search path \, and/or pre-loads one or more libraries ("extensions") -to Pd in preparation for opening the patch from a file. Usage is "declare -[-flag value] [-flag value] ..." where the flag can be:; -#X text 97 400 If you put abstractions and/or other supporting files -in a subdirectory "more" \, you can put an object \, "declare -path -more" to make sure Pd sees them when the patch is loaded. Or \, if -you have zexy installed in the directory extra/zexy (in the Pd installation") -you can get it using "declare -stdpath extra/zexy".; -#X text 80 185 n) symbol atom; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; diff --git a/doc/pddp/delay-help.pd b/doc/pddp/delay-help.pd deleted file mode 100644 index 7425a1dfc..000000000 --- a/doc/pddp/delay-help.pd +++ /dev/null @@ -1,185 +0,0 @@ -#N canvas 430 34 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 delay 3 12 0 18 --204280 -1 0; -#X obj 0 200 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 482 240 494 386 META 1; -#X text 12 145 LIBRARY internal; -#X text 12 185 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 45 LICENSE SIBSD; -#X text 12 165 AUTHOR Miller Puckette; -#X text 12 225 HELP_PATCH_AUTHORS This help patch was updated for Pd -version 0.35 test 28 by Dave Sabine as part of a project called pddp -proposed by Krzysztof Czaja to build comprehensive documentation for -Pd. Jonathan Wilkes revised the patch to conform to the PDDP template -for Pd version 0.42.; -#X text 12 65 DESCRIPTION bang after time delay; -#X text 12 5 ALIAS del; -#X text 12 85 INLET_0 float bang stop; -#X text 12 105 INLET_1 float; -#X text 12 125 OUTLET_0 bang; -#X text 12 25 KEYWORDS control time bang_op; -#X text 12 205 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 393 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 446 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 488 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 219 337 428 291 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 obj 42 37 timer; -#X obj 8 37 pipe; -#X obj 80 37 metro; -#X obj 119 37 makenote; -#X obj 180 87 delwrite~; -#X text 4 208 The best places to find information about Pd's libraries -is:; -#X text 4 230 www.puredata.org and click on "Downloads" then "Software" -; -#X text 4 251 iem.kug.ac.at/pdb/; -#X text 5 112 Externals; -#X text 5 159 Externals are offered in Pd only if you have downloaded -and properly installed the appropriate library. These objects may or -may not exist in a single library.; -#X text 7 62 Audio Objects; -#X obj 10 87 vd~; -#X obj 47 87 delread~; -#X obj 113 89 delwrite~; -#X text 7 1 [delay] Related Objects; -#X obj 12 134 nop~; -#X obj 48 134 z~; -#X obj 78 133 t3_delay; -#X obj 138 133 idelay~; -#X obj 192 133 delay~; -#X restore 101 597 pd Related_objects; -#X obj 78 209 cnv 17 3 145 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 402 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 360 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 98 359 float; -#X obj 452 12 delay; -#X text 492 12 or; -#X obj 518 11 del; -#X obj 100 102 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 100 150 delay 2000; -#X obj 100 173 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X text 98 253 bang; -#X text 98 313 stop; -#X text 168 359 - a float to the right inlet sets the delay time (in -milliseconds).; -#X text 98 336 list; -#X text 98 401 bang; -#X msg 168 101 stop; -#X msg 122 101 500; -#X floatatom 157 128 0 0 0 0 - - -; -#X text 188 129 <- scroll to change delay time in milliseconds; -#X text 168 401 - [delay] only outputs a bang. It cannot be used like -an "echo" or to delay messages other than bang. For that purpose \, -you should explore [pipe].; -#N canvas 106 287 428 250 A_delay_based_metronome 0; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 19 55 Let's assume for a moment that Miller had forgotten to -build the [metro] object. (I know that sounds absurd \, but for the -sake of example...); -#X text 19 104 [delay] could be used to create a metronome as follows. -; -#X obj 58 197 bng 15 50 10 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 58 175 delay 1000; -#X msg 22 135 bang; -#X msg 58 135 stop; -#X obj 260 176 metro 1000; -#X obj 260 197 bng 15 50 10 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 260 157 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0 -1; -#X floatatom 317 155 5 0 0 0 - - -, f 5; -#X floatatom 115 154 5 0 0 0 - - -, f 5; -#X text 152 175 is the same as; -#X text 19 36 A makeshift [metro]; -#X text 7 1 [delay] A Metronome Built with [delay]; -#X connect 3 0 5 0; -#X connect 4 0 3 0; -#X connect 5 0 4 0; -#X connect 6 0 4 0; -#X connect 7 0 8 0; -#X connect 9 0 7 0; -#X connect 10 0 7 1; -#X connect 11 0 4 1; -#X restore 101 550 pd A_delay_based_metronome; -#N canvas 103 173 428 389 Random_Impulse_Generator 0; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 21 35 Some users might be familiar with SC (SuperCollider) -by James McCartney. For more info about SC \, visit www.audiosynth.com. -Anyways...SC has a unit generator called "DUST". Dust will produce -random impulses at a specified "density". I believe that Dust was given -its name because it creates a sound that is similar to actual dust -on old vinyl LP's -- you know that old crackling sound like Rice Krispies. -; -#X text 20 143 The idea is quite simple. If you want a "very dusty" -sound \, you make the density quite high...if you want a "slightly -dusty" sound \, you make the density quite low.; -#X obj 22 299 delay; -#X obj 22 321 bng 15 50 10 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 22 235 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0 1 -; -#X text 20 188 Dust.ar(2) in SC will produce 2 dusty impulses randomly -per second. In the example below \, you'll see a version of this process -created using Pd's delay object.; -#X obj 22 278 random 500; -#X obj 22 257 metro 500; -#X floatatom 92 236 5 0 0 0 - - -, f 5; -#X text 20 343 Also note that this example merely approximates the -output of SC's "Dust" object.; -#X text 130 236 low numbers produce a very "dusty" output.; -#X text 130 248 high numbers produce a slightly "dusty" output.; -#X text 7 1 [delay] A Random Impulse Generator using [delay]; -#X connect 3 0 4 0; -#X connect 5 0 8 0; -#X connect 7 0 3 0; -#X connect 8 0 7 0; -#X connect 9 0 8 1; -#X connect 9 0 7 1; -#X restore 101 572 pd Random_Impulse_Generator; -#X text 168 313 - causes [delay] to cancel its scheduled output.; -#X text 168 336 - a list of floats will be truncated to the first element. -; -#X text 80 465 1) float; -#X text 97 54 The [delay] object sends a bang to its outlet after a -delay (in milliseconds) \, specified by its right inlet or its creation -argument.; -#X text 168 253 - a bang to the left inlet will output a bang after -the prescribed time (set either at the right inlet creation argument). -In the above example \, you should notice a delay of 2 seconds \, then -a bang at the outlet.; -#X text 168 208 - if a float is sent to the left inlet \, [delay] will -set the delay time equal to that number (milliseconds) and schedule -the outgoing bang.; -#X text 98 492 [delay] accepts only ONE bang at a time. It cannot process -multiple delays. In other words \, sending a "bang" to a [delay] which -is already set will reschedule its output \, cancelling the old one. -; -#X text 168 465 - (optional) initial delay time (in milliseconds). -; -#X text 98 208 float; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 298 550 pddp/pddplink ../2.control.examples/07.time.pd; -#X text 11 23 bang after time delay; -#X connect 15 0 16 0; -#X connect 16 0 17 0; -#X connect 23 0 16 0; -#X connect 24 0 16 0; -#X connect 25 0 16 1; diff --git a/doc/pddp/delread~-help.pd b/doc/pddp/delread~-help.pd deleted file mode 100644 index f35dfcf14..000000000 --- a/doc/pddp/delread~-help.pd +++ /dev/null @@ -1,87 +0,0 @@ -#N canvas 428 33 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 delread~ 3 12 0 -18 -204280 -1 0; -#X obj 0 292 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 484 286 494 344 META 0; -#X text 12 105 LIBRARY internal; -#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 165 RELEASE_DATE 2009-06-12; -#X text 12 25 LICENSE SIBSD; -#X text 12 125 AUTHOR Miller Puckette; -#X text 12 185 HELP_PATCH_AUTHORS Updated for Pd version 0.33. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 5 KEYWORDS signal nonlocal time; -#X text 12 45 DESCRIPTION read a signal from a delay line; -#X text 12 85 OUTLET_0 signal; -#X text 12 65 INLET_0 float; -#X restore 500 597 pd META; -#X obj 0 384 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 479 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#X obj 78 301 cnv 17 3 75 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#N canvas 216 491 428 139 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 19 78 Control objects for delays:; -#X obj 22 105 delay; -#X obj 67 105 pipe; -#X obj 22 42 delwrite~ help; -#X obj 127 42 vd~ help; -#X text 7 1 [delread~] Related Objects; -#X restore 101 597 pd Related_objects; -#X obj 78 393 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 393 signal; -#X floatatom 299 169 0 0 0 0 - - -; -#X text 340 168 input to delay line; -#X obj 299 193 sig~; -#X floatatom 112 122 0 0 0 0 - - -; -#X text 139 122 float input (delay time in ms); -#X obj 112 217 snapshot~; -#X floatatom 112 241 0 0 0 0 - - -; -#X obj 123 173 loadbang; -#X obj 123 195 metro 200; -#X text 98 300 float; -#X text 98 320 list; -#X text 98 339 Note: If the specified delay time is longer than the -size of the delay line or less than zero it is clipped to the length -of the delay line.; -#X text 98 483 You can use more than one [delread~] object for the -same delay line.; -#X obj 485 10 delread~; -#X obj 299 218 delwrite~ delread_ex 1000; -#X obj 112 148 delread~ delread_ex 1000; -#X text 11 23 read a signal from a delay line; -#X text 168 300 - a float sets the delay time (in milliseconds).; -#X text 168 320 - lists are truncated to the first element.; -#X text 168 393 - the delayed signal.; -#X text 168 440 - name of delay line.; -#X text 168 455 - (optional) initial delay time (ms).; -#X text 80 455 2) float; -#X text 98 511 Note: if the [delwrite~] runs after the [delread~] the -minimum delay is actually one DSP period \, not zero.; -#X text 80 440 1) symbol atom; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 474 58 pddp/dsp; -#X obj 98 542 pddp/pddplink ../3.audio.examples/G01.delay.pd -text -doc/3.audio.examples/G01.delay.pd; -#X obj 98 557 pddp/pddplink ../3.audio.examples/G02.delay.loop.pd -text -doc/3.audio.examples/G02.delay.loop.pd; -#X obj 98 572 pddp/pddplink ../3.audio.examples/G05.execution.order.pd --text doc/3.audio.examples/G05.execution.order.pd; -#X connect 11 0 13 0; -#X connect 13 0 25 0; -#X connect 14 0 26 0; -#X connect 16 0 17 0; -#X connect 18 0 19 0; -#X connect 19 0 16 0; -#X connect 26 0 16 0; diff --git a/doc/pddp/delwrite~-help.pd b/doc/pddp/delwrite~-help.pd deleted file mode 100644 index efcfbf265..000000000 --- a/doc/pddp/delwrite~-help.pd +++ /dev/null @@ -1,95 +0,0 @@ -#N canvas 431 33 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 delwrite~ 3 12 0 -18 -204280 -1 0; -#X obj 0 268 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 489 284 494 344 META 0; -#X text 12 85 LIBRARY internal; -#X text 12 125 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 145 RELEASE_DATE 2009-06-12; -#X text 12 25 LICENSE SIBSD; -#X text 12 105 AUTHOR Miller Puckette; -#X text 12 165 HELP_PATCH_AUTHORS Updated for Pd version 0.33. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 5 KEYWORDS signal nonlocal; -#X text 12 45 DESCRIPTION write a signal in a delay line; -#X text 12 65 INLET_0 signal; -#X restore 500 597 pd META; -#X obj 0 321 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 350 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 429 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#X obj 78 277 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#N canvas 219 490 428 139 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 19 79 Control objects for delays:; -#X obj 22 106 delay; -#X obj 67 106 pipe; -#X obj 22 43 delread~ delwrite_ex; -#X obj 157 43 vd~ delwrite_ex; -#X text 7 2 [delwrite~] Related Objects; -#X restore 101 597 pd Related_objects; -#X floatatom 90 97 0 0 0 0 - - -; -#X text 119 96 input to delay line; -#X obj 90 121 sig~; -#X floatatom 282 63 0 0 0 0 - - -; -#X obj 282 168 snapshot~; -#X floatatom 282 192 0 0 0 0 - - -; -#X obj 293 112 loadbang; -#X obj 293 134 metro 200; -#X obj 479 10 delwrite~; -#X obj 90 146 delwrite~ delwrite_ex 1000; -#X obj 282 86 delread~ delwrite_ex 1000; -#X floatatom 356 110 0 0 0 0 - - -; -#X obj 357 168 snapshot~; -#X floatatom 357 192 0 0 0 0 - - -; -#X obj 356 133 delread~ delwrite_ex 500; -#X text 98 326 (none); -#X text 98 276 signal; -#X text 168 276 - the signal is read by all [delread~] and [vd~] objects -with the same delay line name (delwrite_ex in the above example).; -#X text 169 384 - length of the delay line in milliseconds \, which -is the maximum delay time any receiving [delread~] or [vd~] object -may have.; -#X text 98 224 [delwrite~] allocates memory for a delay line and writes -an audio signal into it. [delread~] objects by the same name read from -the delay line.; -#X text 169 369 - name of the delay line.; -#X text 99 433 You can use more than one [delread~] object for the -same delay line. (See example above).; -#X text 80 384 2) float; -#X text 99 461 Note: if the [delwrite~] runs after the [delread~] the -minimum delay is actually one DSP period \, not zero.; -#X text 80 369 1) symbol atom; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 472 58 pddp/dsp; -#X obj 99 492 pddp/pddplink ../3.audio.examples/G01.delay.pd -text -doc/3.audio.examples/G01.delay.pd; -#X obj 99 512 pddp/pddplink ../3.audio.examples/G02.delay.loop.pd -text -doc/3.audio.examples/G02.delay.loop.pd; -#X obj 99 532 pddp/pddplink ../3.audio.examples/G03.delay.variable.pd --text doc/3.audio.examples/G03.delay.variable.pd; -#X obj 99 552 pddp/pddplink ../3.audio.examples/G04.control.blocksize.pd --text doc/3.audio.examples/G04.control.blocksize.pd; -#X obj 99 572 pddp/pddplink ../3.audio.examples/G05.execution.order.pd --text doc/3.audio.examples/G05.execution.order.pd; -#X text 11 23 write a signal in a delay line; -#X connect 9 0 11 0; -#X connect 11 0 18 0; -#X connect 12 0 19 0; -#X connect 13 0 14 0; -#X connect 15 0 16 0; -#X connect 16 0 13 0; -#X connect 16 0 21 0; -#X connect 19 0 13 0; -#X connect 20 0 23 0; -#X connect 21 0 22 0; -#X connect 23 0 21 0; diff --git a/doc/pddp/drawnumber-help.pd b/doc/pddp/drawnumber-help.pd deleted file mode 100644 index c5b92fbb7..000000000 --- a/doc/pddp/drawnumber-help.pd +++ /dev/null @@ -1,161 +0,0 @@ -#N struct drawnumber-help-template float x float y float cat float -dog float dog-vis; -#N canvas 429 35 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 drawnumber 3 12 -0 18 -204280 -1 0; -#X obj 0 119 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 487 282 494 344 META 0; -#X text 12 105 LIBRARY internal; -#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 165 RELEASE_DATE 2009-06-12; -#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.39. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 25 KEYWORDS control data_structure; -#X text 12 65 DESCRIPTION display a numberic field of a template; -#X text 12 5 ALIAS drawsymbol; -#X text 12 85 INLET_0 float; -#X restore 500 597 pd META; -#X obj 0 204 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 232 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 460 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 212 459 428 169 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 obj 92 42 struct; -#X obj 142 42 drawpolygon; -#X obj 223 42 plot; -#X obj 17 42 drawsymbol; -#X obj 262 42 drawcurve; -#X text 7 78 Other Data Structure Objects; -#X obj 245 112 element; -#X obj 76 112 get; -#X obj 107 112 set; -#X obj 136 112 getsize; -#X obj 190 112 setsize; -#X obj 22 112 pointer; -#X text 7 1 [drawnumber] Related Objects; -#X restore 101 597 pd Related_objects; -#X obj 78 128 cnv 17 3 65 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 127 float; -#X text 98 177 list; -#X text 168 127 - [drawnumber] has a single inlet to toggle visibility -of the number. A zero makes it invisible. Any nonzero value makes it -visible.; -#X text 98 208 (none); -#N canvas 7 169 428 164 drawnumber-help-data 0; -#X scalar drawnumber-help-template 24 61 49 17 1 \;; -#X scalar drawnumber-help-template 174 61 41 18 1 \;; -#X obj 1 1 cnv 15 425 20 empty empty empty 20 12 2 14 -204280 -195568 -0; -#X text 6 1 [drawnumber] Window to Display Data Structure Instances -; -#X text 21 91 Each dog/cat pair is a scalar. (You can click each in -editmode to get a bounding blue box and move them around.) When not -in editmode you may click and scroll the values up and down for each -field.; -#X restore 28 61 pd drawnumber-help-data; -#N canvas 115 43 428 526 drawnumber-help-template 0; -#X obj 23 121 drawnumber cat 0 0 0 cat=; -#X obj 23 92 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0 1 -; -#X obj 22 454 struct drawnumber-help-template float x float y float -cat float dog float dog-vis; -#X obj 22 314 tgl 15 0 empty empty empty 17 7 0 10 -262144 -1 -1 0 -1; -#X obj 22 353 set drawnumber-help-template dog-vis; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 1 [drawnumber] subpatch for data structure template; -#N canvas 115 239 426 147 init 0; -#X obj 14 57 pointer; -#X msg 14 35 traverse pd-drawnumber-help-data \, next; -#X obj 14 12 loadbang; -#X obj 14 80 outlet; -#X text 67 58 This just sends a pointer to the right inlet of the [set] -object; -#X text 257 39 the list); -#X text 255 27 (select the first scalar in; -#X connect 0 0 3 0; -#X connect 1 0 0 0; -#X connect 2 0 1 0; -#X restore 235 331 pd init; -#X text 42 91 "0" makes both "cat" fields invisible; -#X text 40 311 "0" makes a single instance of a "dog" field invisible -; -#X obj 23 210 drawnumber -v dog-vis dog 0 -15 900 dog=; -#X text 20 29 [drawnumber] is used below to display the values of two -fields- "dog" and "cat". These two fields are defined in the template -"drawnumber-help-template" located at the bottom of this subpatch. -; -#X text 20 139 For the [drawnumber] object associated with "cat" above -\, a [toggle] is connected to the inlet. This toggles visibility globally -(i.e. \, for all existing scalars defined by the template "drawnumber-help-template"). -; -#X text 21 229 The [drawnumber] object for "dog" above uses the -v -flag \, which can be used to set visibility for each scalar individually. -The (flag \, value) pair "-v dog-vis" means that the field "dog-vis" -determines whether "dog" will be visible in a given scalar. (If you -use the -v flag you can no longer use the inlet of this [drawsymbol] -object.); -#X text 19 372 With the [set] object \, we can change the value of -"dog-vis" in order to set visibility for the "dog" field. Notice when -you click the [toggle] \, it only affects one scalar-- the one which -the [set] object is currently pointing to (see the "init" subpatch). -; -#X text 19 487 This object defines the fields for this template. (Their -values were initialized when this help patch was created.); -#X connect 1 0 0 0; -#X connect 3 0 4 0; -#X connect 7 0 4 1; -#X restore 28 89 pd drawnumber-help-template; -#X obj 474 12 drawnumber; -#X text 99 464 When not in "edit" mode \, you can click and drag vertically -on the numbers to change their values. (In edit mode you can move \, -cut \, copy \, and paste the objects.); -#X text 201 89 <- click this subpatch to see how [drawnumber] is used. -; -#X text 179 59 <- subpatch to display the data structures; -#X text 11 23 display a numeric field of a template; -#X text 98 437 Note: you cannot use both the -n and -v flag.; -#X text 168 177 - a list will be truncated to the first element.; -#X text 80 253 0-2 flags; -#X text 168 304 - the field name of the number to draw.; -#X text 168 353 - RGB color (0=black \, 999=white \, 900=red \, 90=green -\, 9=blue \, 555=grey \, etc.).; -#X text 168 381 - (optional) label ("cat=" for instance).; -#X text 168 253 - "-n" flag to make the number invisible initially. -; -#X text 168 270 - a "-v [variable]" flag to assign a variable to make -the number visible/invisible.; -#X text 168 321 - relative x coordinate.; -#X text 168 337 - relative y coordinate.; -#X text 80 321 2) *; -#X text 80 337 3) *; -#X text 80 353 4) *; -#X text 80 304 1) *; -#X text 98 504 Keyboard entry is supported for [drawnumber] (but not -for [drawsymbol]) when not in editmode. Click a number to enter values -\, the click the enter key when you are finished.; -#X text 80 270 (symbol atoms); -#X text 80 381 5) symbol atom; -#X text 98 405 * Any of these can be numbers (float) or field names -(symbol atom).; -#X obj 98 542 pddp/pddplink drawsymbol-help.pd; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 318 542 pddp/pddplink ../4.data.structures/09.scaling.pd -text -doc/4.data.structure/09.scaling.pd; -#X obj 318 557 pddp/pddplink ../4.data.structures/10.onoff.pd -text -doc/4.data.structures/10.onoff.pd; -#X obj 98 572 pddp/pddplink all_about_z_order.pd; -#X obj 98 557 pddp/pddplink scalar-help.pd; diff --git a/doc/pddp/drawpolygon-help.pd b/doc/pddp/drawpolygon-help.pd deleted file mode 100644 index 4e135ab20..000000000 --- a/doc/pddp/drawpolygon-help.pd +++ /dev/null @@ -1,171 +0,0 @@ -#N struct drawpolygon-help-template float x float y float weasel float -dog float cat float vis; -#N canvas 432 31 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 drawpolygon 3 12 -0 18 -204280 -1 0; -#X obj 0 147 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 487 277 494 344 META 0; -#X text 12 85 LIBRARY internal; -#X text 12 125 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 145 RELEASE_DATE 2009-06-12; -#X text 12 25 LICENSE SIBSD; -#X text 12 105 AUTHOR Miller Puckette; -#X text 12 165 HELP_PATCH_AUTHORS This help patch was updated for Pd -version 0.35 test 28 by Dave Sabine as part of a project called pddp -proposed by Krzysztof Czaja to build comprehensive documentation for -Pd. Jonathan Wilkes revised the patch to conform to the PDDP template -for Pd version 0.42.; -#X text 12 5 KEYWORDS control data_structure; -#X text 12 45 DESCRIPTION display a polygon in a data structure instance -; -#X text 12 65 INLET_0 float; -#X restore 500 597 pd META; -#X obj 0 222 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 250 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 516 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 216 468 428 156 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 obj 92 42 struct; -#X obj 142 42 drawpolygon; -#X obj 223 42 plot; -#X obj 17 42 drawsymbol; -#X obj 262 42 drawcurve; -#X text 7 78 Other Data Structure Objects; -#X obj 245 112 element; -#X obj 76 112 get; -#X obj 107 112 set; -#X obj 136 112 getsize; -#X obj 190 112 setsize; -#X obj 22 112 pointer; -#X text 7 1 [drawpolygon] Related Objects; -#X restore 101 597 pd Related_objects; -#X obj 78 156 cnv 17 3 55 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 99 157 float; -#X text 168 154 - [drawnumber] has a single inlet to toggle visibility -of the number. A zero makes it invisible. Any nonzero value makes it -visible.; -#X text 98 226 (none); -#X text 179 80 <- subpatch to display the data structures; -#X obj 473 10 drawpolygon; -#N canvas 23 258 428 340 drawpolygon-help-data 0; -#X scalar drawpolygon-help-template 101 41 0 60 100 1 \;; -#X scalar drawpolygon-help-template 301 44 1 80 100 1 \;; -#X obj 1 1 cnv 15 425 20 empty empty empty 20 12 2 14 -204280 -195568 -0; -#X text 21 156 Three field values are used to draw these polygons. -The field "weasel" is used for the y-value of the top of the triangle -and the y-value of the top two points of the red "v". Fields "dog" -and "cat" are the top left and right x-values for the red "v".; -#X text 6 1 Window to Display Data Structures; -#X text 21 111 Each scalar consists of a set of numbers \, one triangle -\, and one red "v". In editmode you can click on a polygon to get a -blue bounding box around the scalar.; -#X text 21 226 In runmode you can click on each of these regions of -the polygons to alter their appearance. You may also scroll the displayed -values with the mouse to change them.; -#X text 21 276 Additionally \, you can right-click a scalar and select -"Properties" and edit the data in the text window that pops up.; -#X restore 28 82 pd drawpolygon-help-data; -#N canvas 102 75 428 563 drawpolygon-help-template 0; -#X obj 23 115 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0 1 -; -#N canvas 69 268 428 162 init 0; -#X obj 20 75 pointer; -#X obj 20 99 outlet; -#X obj 20 30 loadbang; -#X msg 20 53 traverse pd-drawpolygon-help-data \, next; -#X obj 0 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 6 1 [drawpolygon] Initialization subpatch; -#X text 81 80 This just locates the first scalar in the subpatch "drawpolygon-help-data" -and outputs a pointer to it.; -#X connect 0 0 1 0; -#X connect 2 0 3 0; -#X connect 3 0 0 0; -#X restore 217 316 pd init; -#X obj 22 298 tgl 15 0 empty empty empty 17 7 0 10 -262144 -1 -1 0 -1; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 1 [drawpolygon] subpatch; -#X obj 23 141 drawpolygon 0 4 0 40 40 40 20 weasel 0 40; -#X obj 22 27 struct drawpolygon-help-template float x float y float -weasel float dog float cat float vis; -#X text 42 114 "0" in inlet makes all instances of this polygon invisible -; -#X text 40 295 "0" in inlet makes a single instance of this polygon -invisible; -#X obj 22 340 set drawpolygon-help-template vis; -#X obj 23 491 drawnumber weasel -60 0 0 weasel=; -#X obj 23 511 drawnumber dog -60 15 0 dog=; -#X obj 23 532 drawnumber cat -60 30 0 cat=; -#X obj 23 199 drawpolygon -v vis 900 3 dog weasel 80 40 cat weasel -; -#X text 19 218 The next [drawpolygon] object uses the -v flag. This -flag controls visilibility of the polygon for only one instance of -a data structure. "-v vis" means that the value of field "vis" determines -whether the red "v" polygon is visible or not.; -#X text 19 360 Using the [set] object \, we can turn visibility on -and off for an instance of this polygon by changing the value of the -field "vis". Notice when you click the toggle above \, visibility only -changes for the red "v" furthest to the right. Once you use the -v -flag \, however \, you can no longer use the inlet to [drawpolygon] -to set visibility globally.; -#X text 19 447 Finally \, for convenience \, the following [drawnumber] -objects display the values of each field used in the drawing instructions -above:; -#X text 20 159 [drawpolygon] is used above to display a black triangle -and a red "v".; -#X text 19 60 The [struct] object defines the fields for this template. -You can see and edit the values by right-clicking the scalar in the -"data" subpatch and selecting "Properties."; -#X connect 0 0 5 0; -#X connect 1 0 9 1; -#X connect 2 0 9 0; -#X restore 28 109 pd drawpolygon-help-template; -#X text 98 471 Note: you cannot use the -n and -v flag together. When -using the -v flag \, the polygon is initially invisible by default. -; -#X text 99 519 When not in "edit" mode \, you can click on regions -of the polygon defined by template fields to stretch or alter the polygon's -shape.; -#X text 201 109 <- click this subpatch to see how [drawpolygon] is -used.; -#X text 11 23 display a polygon in a data structure instance; -#X text 168 195 - a list will be truncated to the first element.; -#X text 168 363 - RGB color (0=black \, 999=white \, 900=red \, 90=green -\, 9=blue \, 555=grey \, etc.); -#X text 168 390 - line width.; -#X text 168 414 - two or more (x \, y) pairs giving coordinates.; -#X text 168 270 - "-n" flag to make the polygon initially invisible. -; -#X text 168 289 - a "-v [variable]" flag to assign a variable to make -the polygon visible/invisible.; -#X text 80 390 2) *; -#X text 80 364 1) *; -#X text 80 414 n) *; -#X text 98 442 * Any of these can be numbers (float) or field names -(symbol atom).; -#X text 98 195 list; -#X text 80 309 (symbol atoms); -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 316 557 pddp/pddplink ../4.data.structures/09.scaling.pd -text -doc/4.data.structure/09.scaling.pd; -#X obj 316 572 pddp/pddplink ../4.data.structures/10.onoff.pd -text -doc/4.data.structures/10.onoff.pd; -#X obj 99 572 pddp/pddplink all_about_z_order.pd; -#X obj 99 557 pddp/pddplink scalar-help.pd; -#X text 80 270 0-3 flags; -#X text 80 290 (optional); -#X text 168 318 - "-x" flag to inhibit selecting the object when the -shape is clicked on in "edit" mode or clicked-and-dragged in "run mode". -; diff --git a/doc/pddp/element-help.pd b/doc/pddp/element-help.pd deleted file mode 100644 index 9346fbb81..000000000 --- a/doc/pddp/element-help.pd +++ /dev/null @@ -1,135 +0,0 @@ -#N struct element-help-template float x float y array array1 array1-element-help-template -; -#N struct array1-element-help-template float y; -#N canvas 428 35 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 element 3 12 0 18 --204280 -1 0; -#X obj 0 333 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 482 282 494 344 META 0; -#X text 12 125 LIBRARY internal; -#X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 145 AUTHOR Miller Puckette; -#X text 12 205 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 5 KEYWORDS control data_structure array; -#X text 12 65 INLET_0 float list; -#X text 12 85 INLET_1 pointer; -#X text 12 105 INLET_2 pointer; -#X text 12 45 DESCRIPTION get pointer to an element of an array; -#X text 12 185 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 449 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 493 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 553 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 211 492 428 134 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 obj 92 72 struct; -#X obj 142 72 drawpolygon; -#X obj 223 72 plot; -#X obj 17 72 drawsymbol; -#X obj 262 72 drawcurve; -#X obj 71 37 get; -#X obj 102 37 set; -#X obj 131 37 getsize; -#X obj 185 37 setsize; -#X obj 17 37 pointer; -#X obj 240 37 drawnumber; -#X text 7 1 [element] Related Objects; -#X restore 101 597 pd Related_objects; -#X obj 78 342 cnv 17 3 70 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 99 343 float; -#X text 98 398 list; -#X text 228 255 <- subpatch to display the data structures; -#X obj 497 10 element; -#N canvas 80 372 428 228 element-help-data 0; -#X scalar element-help-template 40 40 \; 19 \; 0 \; 11 \; 9 \; 41 \; -14 \; 31 \; 38 \; 33 \; \;; -#X obj 0 0 cnv 15 425 20 empty empty empty 20 12 2 14 -204280 -195568 -0; -#X text 5 0 Window to Display Data Structure Instances; -#X text 20 155 You can also click and drag each element vertically -to change its value. When there is no "x" field specified (as in the -template array1-element-help-template) you can click and drag horizontally -to change multiple elements in one mouse swoop.; -#X text 20 110 Each purple square above represents one element of the -array. Using the [element] object in the parent window you can get -the y-value of each element.; -#X restore 77 257 pd element-help-data; -#N canvas 73 89 428 189 element-help-template 0; -#X obj 0 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 6 1 [element] subpatch; -#X obj 21 76 struct element-help-template float x float y array array1 -array1-element-help-template; -#X obj 21 158 filledpolygon 777 666 1 -10 -10 210 -10 210 65 -10 65 -; -#X obj 21 120 plot -y y(0:41)(41:0) array1 500 1 0 15 25; -#X text 18 37 This [struct] contains an array "array1." The elements -of this array are defined by array1-element-help-template; -#X restore 77 279 pd element-help-template; -#N canvas 80 82 428 218 array1-element-help-template 0; -#X obj 0 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 6 1 [element] subpatch; -#X obj 21 73 struct array1-element-help-template float y; -#X obj 21 131 drawnumber y -5 -20 0; -#X obj 21 102 filledpolygon 509 0 1 -5 0 0 5 5 0 0 -5; -#X text 19 37 This [struct] is used in element-help-template to define -the elements of the array "array1."; -#X text 20 158 When "array1" is plotted \, each element will be represented -by a purple box and a number \, as specified here by the [filledpolygon] -and [drawnumber] objects.; -#X restore 77 301 pd array1-element-help-template; -#X obj 78 421 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 98 420 pointer; -#X text 169 343 - [element] takes a float to its left inlet \, which -specifies the element of an array. Indices range from zero to the number -of elements minus one. Indices out of range are quietly replaced by -the nearest endpoint.; -#X obj 78 458 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 459 pointer; -#X text 168 459 - when [element] receives a float to its left inlet -\, it outputs a pointer to the specified element of the array.; -#X obj 297 107 pointer; -#X floatatom 125 209 5 0 0 0 - - -, f 5; -#X text 130 156 outlet is pointer to single element; -#X text 176 207 here we just get the value of y.; -#X msg 297 83 traverse pd-element-help-data \, next; -#X obj 125 135 element element-help-template array1; -#X obj 125 182 get array1-element-help-template y; -#X obj 125 112 hradio 15 1 0 9 empty empty empty 0 -8 0 10 -262144 --1 -1 0; -#X text 155 93 index (0-8); -#X floatatom 81 135 5 0 0 0 - - -, f 5; -#X text 11 23 get pointer to an element of an array; -#X text 168 527 - field name. The field name must be an array.; -#X text 168 398 - a list will be truncated to the first element.; -#X text 168 512 - name of the template.; -#X text 168 420 - the right inlet of [element] takes a pointer to a -scalar.; -#X text 80 512 1) symbol atom; -#X text 80 527 2) symbol atom; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 98 557 pddp/pddplink all_about_arrays.pd; -#X obj 98 572 pddp/pddplink scalar-help.pd; -#X text 125 75 2 ... then here; -#X text 299 63 1 Click here first...; -#X connect 22 0 27 1; -#X connect 26 0 22 0; -#X connect 27 0 28 0; -#X connect 28 0 23 0; -#X connect 29 0 27 0; -#X connect 29 0 31 0; diff --git a/doc/pddp/env~-help.pd b/doc/pddp/env~-help.pd deleted file mode 100644 index c63a5a74b..000000000 --- a/doc/pddp/env~-help.pd +++ /dev/null @@ -1,75 +0,0 @@ -#N canvas 428 34 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 env~ 3 12 0 18 -204280 --1 0; -#X obj 0 343 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 486 284 494 344 META 0; -#X text 12 105 LIBRARY internal; -#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 125 AUTHOR Miller Puckette; -#X text 12 185 HELP_PATCH_AUTHORS Updated for Pd version 0.40. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 5 KEYWORDS signal conversion; -#X text 12 65 INLET_0 signal; -#X text 12 85 INLET_1 float; -#X text 12 45 DESCRIPTION envelope follower; -#X text 12 165 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 380 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 434 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 535 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#X obj 78 352 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 389 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 351 signal; -#X obj 513 10 env~; -#X text 98 539 The analysis is "Hanning" (raised cosine) windowed. -; -#X text 98 389 float; -#X floatatom 74 263 0 0 0 0 - - -; -#X obj 74 140 osc~ 400; -#X obj 74 167 *~; -#X floatatom 166 116 3 -99 300 0 - - -, f 3; -#X obj 166 140 dbtorms; -#X text 194 114 <- set peak-to-peak amplitude here in dB.; -#X text 110 264 <- the output is RMS amplitude which (for a sinusoid) -is about 3 dB below peak-to-peak amplitude.; -#X obj 74 200 env~ 16384 8192; -#N canvas 213 524 428 101 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 obj 9 38 threshold~; -#X text 7 1 [env~] Related Objects; -#X restore 101 597 pd Related_objects; -#X text 11 23 envelope follower; -#X text 168 452 - (optional) the analysis window size in samples (the -default is 1024).; -#X text 80 452 1) float; -#X text 80 479 2) float; -#X text 168 479 - (optional) the period (the number of samples per -analysis-- window/2 by default). This should normally be a multiple -of the DSP block size \, although this isn't enforced.; -#X text 168 389 - the [env~] object takes a signal and outputs its -RMS amplitude in dB (with 1 normalized to 100 dB.) Output is bounded -below by zero.; -#X text 168 351 - the incoming signal; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 480 56 pddp/dsp; -#X obj 98 557 pddp/pddplink ../3.audio.examples/C07.envelope.follower.pd --text doc.3.audio.examples/C07.envelope.follower.pd; -#X obj 98 572 pddp/pddplink ../3.audio.examples/H06.envelope.follower.pd --text doc.3.audio.examples/H06.envelope.follower.pd; -#X connect 14 0 15 0; -#X connect 15 0 20 0; -#X connect 16 0 17 0; -#X connect 17 0 15 1; -#X connect 20 0 13 0; diff --git a/doc/pddp/fft~-help.pd b/doc/pddp/fft~-help.pd deleted file mode 100644 index 0db35c408..000000000 --- a/doc/pddp/fft~-help.pd +++ /dev/null @@ -1,111 +0,0 @@ -#N canvas 428 35 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 fft~ 3 12 0 18 -204280 --1 0; -#X obj 0 399 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 468 274 507 361 META 0; -#X text 12 150 LIBRARY internal; -#X text 12 190 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 210 RELEASE_DATE 2009-06-12; -#X text 12 30 LICENSE SIBSD; -#X text 12 170 AUTHOR Miller Puckette; -#X text 12 230 HELP_PATCH_AUTHORS Updated for Pd version 0.33. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 70 INLET_0 signal; -#X text 12 90 INLET_1 signal; -#X text 12 110 OUTLET_0 signal; -#X text 12 130 OUTLET_1 signal; -#X text 12 50 DESCRIPTION Fourier analyses; -#X text 12 5 KEYWORDS signal block_oriented analysis; -#X restore 500 597 pd META; -#X obj 0 460 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 523 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 551 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#X text 98 527 (none); -#N canvas 214 524 428 107 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 7 1 [fft~] Related Objects; -#X obj 22 42 ifft~; -#X obj 68 42 rfft~; -#X obj 114 42 rifft~; -#X obj 163 42 block~; -#X obj 210 42 switch~; -#X restore 101 597 pd Related_objects; -#X obj 78 408 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 469 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 433 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X obj 512 10 fft~; -#X floatatom 15 124 0 0 0 0 - - -; -#X obj 15 75 * 44100; -#X floatatom 15 53 0 0 0 0 - - -; -#X obj 15 180 osc~; -#X obj 15 205 rfft~; -#X obj 15 99 / 64; -#X obj 15 261 rifft~; -#X obj 60 261 print~ real; -#X obj 74 236 print~ imaginary; -#X obj 15 298 /~ 64; -#X obj 15 364 print~ resynthesized; -#X msg 25 337 bang; -#X msg 60 192 bang; -#X msg 36 150 0.25; -#X msg 77 150 0; -#X text 42 125 frequency in Hz.; -#X text 43 52 frequency in bins; -#X text 55 298 <- renormalize; -#X text 61 337 <- print resynthesis; -#X text 98 407 signal; -#X text 98 432 signal; -#X obj 78 496 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 98 495 signal; -#X text 98 468 signal; -#X text 11 23 Fourier analyses; -#X text 183 313 There is no normalization \, so that an FFT followed -by an IFFT has a gain of N.; -#X text 182 352 See the FFT examples to see how to use these in practice. -; -#X text 184 243 The real FFT outputs N/2+1 real parts and N/2-1 imaginary -parts. The other outputs are zero. At DC and at the Nyquist there is -no imaginary part \, but the second through Nth output is as a real -and imaginary pair \, which can be thought of as the cosine and sin -component strengths.; -#X text 104 151 <- bash phase; -#X text 92 193 <- print analysis; -#X text 184 118 The FFT objects do Fourier analyses and resyntheses -of incoming real or complex signals. Complex signals are handled as -pairs of signals (real and imaginary part.) The analysis size is one -block (you can use the [block~] or [switch~] objects to control block -size).; -#X obj 5 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 481 55 pddp/dsp; -#X obj 98 555 pddp/pddplink ../3.audio.examples/I01.Fourier.analysis.pd --text doc/3.audio.examples/I01.Fourier.analysis.pd; -#X text 98 573 also see examples I02-I10 in doc/3.audio.examples; -#X connect 13 0 16 0; -#X connect 14 0 18 0; -#X connect 15 0 14 0; -#X connect 16 0 17 0; -#X connect 17 0 20 0; -#X connect 17 0 19 0; -#X connect 17 1 21 0; -#X connect 17 1 19 1; -#X connect 18 0 13 0; -#X connect 19 0 22 0; -#X connect 22 0 23 0; -#X connect 24 0 23 0; -#X connect 25 0 20 0; -#X connect 25 0 21 0; -#X connect 26 0 16 1; -#X connect 27 0 16 1; diff --git a/doc/pddp/float-help.pd b/doc/pddp/float-help.pd deleted file mode 100644 index 762e1f798..000000000 --- a/doc/pddp/float-help.pd +++ /dev/null @@ -1,199 +0,0 @@ -#N canvas 427 33 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 float 3 12 0 18 --204280 -1 0; -#X obj 0 339 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 494 296 482 332 META 0; -#X text 12 145 LIBRARY internal; -#X text 12 185 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 45 LICENSE SIBSD; -#X text 12 165 AUTHOR Miller Puckette; -#X text 12 225 HELP_PATCH_AUTHORS Jonathan Wilkes revised the patch -to conform to the PDDP template for Pd version 0.42.; -#X text 12 25 KEYWORDS control storage; -#X text 12 5 ALIAS f; -#X text 12 85 INLET_0 float bang; -#X text 12 105 INLET_1 float; -#X text 12 125 OUTLET_0 float; -#X text 12 65 DESCRIPTION store a number; -#X text 12 205 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 78 144 cnv 10 50 16 empty empty empty 20 12 0 14 -262126 -66577 -0; -#X obj 341 145 cnv 10 23 16 empty empty empty 20 12 0 14 -262126 -66577 -0; -#X floatatom 379 117 5 0 0 0 - - -, f 5; -#X floatatom 340 169 5 0 0 0 - - -, f 5; -#X obj 359 117 bng 15 250 50 0 empty empty empty 20 7 0 12 -4034 -1 --1; -#X floatatom 80 169 5 0 0 0 - - -, f 5; -#X msg 80 61 bang; -#X msg 320 61 7 3 4; -#X obj 340 144 f; -#X obj 80 144 float 7; -#X obj 0 436 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 473 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 523 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#X obj 78 408 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X obj 78 347 cnv 17 3 55 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 462 12 float; -#X obj 522 12 f; -#X text 501 13 or; -#X msg 119 115 12; -#X msg 152 115 -0.02; -#X msg 94 90 555; -#X msg 340 84 list one 2 3; -#X text 424 83 does not work!; -#X obj 100 543 pddp/pddplink http://crca.ucsd.edu/~msp/Pd_documentation/x2.htm#s3.1 --text Pd manual 2.3.1: anatomy of a message; -#N canvas 106 185 428 374 float/list 0; -#X msg 51 111 float 1 2 3; -#X msg 71 165 list 1 2 3; -#X text 68 142 A list with multiple elements remains a list.; -#X text 19 37 A float with one element remains a float.; -#X text 75 196 A list with one float element is converted to a float. -; -#X obj 27 286 bng 15 250 50 0 empty empty bang 0 20 1 9 -262144 -1 --1; -#X obj 76 286 bng 15 250 50 0 empty empty float 0 21 1 9 -262144 -1 --1; -#X obj 118 286 bng 15 250 50 0 empty empty symbol 0 21 1 9 -262144 --1 -1; -#X obj 166 286 bng 15 250 50 0 empty empty list 0 21 1 9 -262144 -1 --1; -#X obj 211 286 bng 15 250 50 0 empty empty UNDEFINED 0 21 1 9 -262144 --1 -1; -#X obj 26 264 route bang float symbol list; -#X obj 67 327 print FLOAT; -#X msg 26 59 float 3; -#X msg 82 217 list 2; -#X obj 149 327 print LIST; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 1 [float] Conversion To/From a List; -#X text 48 81 A float with multiple elements remains a float but is -truncated to one element.; -#X connect 0 0 10 0; -#X connect 1 0 10 0; -#X connect 10 0 5 0; -#X connect 10 1 6 0; -#X connect 10 1 11 0; -#X connect 10 2 7 0; -#X connect 10 3 8 0; -#X connect 10 3 14 0; -#X connect 10 4 9 0; -#X connect 12 0 10 0; -#X connect 13 0 10 0; -#X restore 386 556 pd float/list conversion; -#N canvas 111 59 428 526 More_Info 0; -#X text 19 37 All numbers in Pd are kept in 32-bit floating point and -can represent real numbers between -8 \, 388608 and 8.388.608.00; -#X text 19 233 The following are examples of floating point numbers: -; -#X text 49 253 3; -#X text 50 294 -111.5; -#X text 49 273 0.5; -#X text 20 126 According to Webopedia.com \, "computers are integer -machines and are capable of representing real numbers only by using -complex codes." Hence \, real numbers must be 'approximated' by computers -using the "floating point standard". In such a number \, the decimal -point can "float" meaning that there is no fixed number of digits preceding -or following the decimal. A floating point number is therefore a computer's -approximation of a real number.; -#X text 50 318 10000 to 1e-16; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 1 [float] More Info; -#X obj 1 91 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 -0 14 -204280 -1 0; -#X text 7 91 What is a floating point number?; -#X obj 1 411 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 -0 14 -204280 -1 0; -#X text 7 411 An Interesting Side-Note; -#X text 19 443 In the early 1990's \, the Intel 80486 was shipped with -a math coprocessor to help accelerate the process of computing floating -point numbers (which previously required a considerable amount of CPU -power). Math coprocessors have since found there way into nearly every -graphics card and CPU available today.; -#X text 49 343 3e-05 : This example is a computer shorthand for scientific -notation. It means 3*10^-5 (or 10 to the negative 5th power multiplied -by 3).; -#X restore 385 532 pd More_Info; -#X text 115 60 outputs argument; -#X text 123 89 overrides argument; -#X text 133 145 stores value; -#X text 98 346 bang; -#X text 98 366 float; -#X text 98 386 list; -#X text 98 408 float; -#N canvas 212 516 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 7 1 [float] Related Objects; -#X obj 22 36 int; -#X obj 54 36 value; -#X obj 101 36 list; -#X floatatom 142 37 5 0 0 0 - - -, f 5; -#X msg 185 36; -#X restore 101 597 pd Related_objects; -#X text 99 445 float; -#X text 11 20 store a number; -#X obj 78 445 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 168 386 - truncates to the first element \, outputs it \, and -stores it.; -#X text 168 408 - a float received on the right inlet is stored.; -#X text 169 445 - outputs the stored value as a float message.; -#X text 81 490 1) float; -#X text 168 346 - outputs the currently stored value.; -#X text 168 366 - outputs the incoming number and stores it.; -#X text 171 490 - [float] accepts a single number as a creation argument -which sets the value that is stored.; -#X obj 80 226 21; -#X obj 80 206 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 -1 --1; -#X floatatom 80 248 5 0 0 0 - - -, f 5; -#X text 122 204 As an additional shortcut \, you can leave off the -class name "float" altogether and just use a single number in an object -box to create a [float] object (with the value initialized to that -number).; -#X text 20 225 [float]; -#X text 21 239 object; -#X text 21 210 implicit; -#X obj 441 280 1 2 3; -#X obj 441 260 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 --1 -1; -#X obj 441 302 print; -#X text 483 264 implicit; -#X text 482 293 object; -#X text 482 279 [list]; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 100 575 pddp/pddplink http://en.wikipedia.org/wiki/Floating_point -; -#X obj 99 527 pddp/pddplink all_about_messages.pd; -#X obj 100 560 pddp/pddplink ../2.control.examples/05.counter.pd -text -doc/2.control.examples/05.counter.pd; -#X text 77 277 (If you add additional arguments after this number you -will create an implicit [list] object.); -#X connect 6 0 12 1; -#X connect 8 0 12 0; -#X connect 10 0 13 0; -#X connect 11 0 12 0; -#X connect 12 0 7 0; -#X connect 13 0 9 0; -#X connect 22 0 13 1; -#X connect 23 0 13 1; -#X connect 24 0 13 0; -#X connect 25 0 12 0; -#X connect 48 0 50 0; -#X connect 49 0 48 0; -#X connect 55 0 57 0; -#X connect 56 0 55 0; diff --git a/doc/pddp/framp~-help.pd b/doc/pddp/framp~-help.pd deleted file mode 100644 index a88b0b069..000000000 --- a/doc/pddp/framp~-help.pd +++ /dev/null @@ -1,86 +0,0 @@ -#N canvas 431 32 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 framp~ 3 12 0 18 --204280 -1 0; -#X obj 0 417 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 474 272 507 362 META 0; -#X text 12 155 LIBRARY internal; -#X text 12 195 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 175 AUTHOR Miller Puckette; -#X text 12 235 HELP_PATCH_AUTHORS Updated for Pd version 0.33. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 75 INLET_0 signal; -#X text 12 95 INLET_1 signal; -#X text 12 115 OUTLET_0 signal; -#X text 12 135 OUTLET_1 signal; -#X text 12 45 DESCRIPTION estimate frequency and amplitude of FFT components -; -#X text 12 215 RELEASE_DATE 1997; -#X text 12 5 KEYWORDS signal block_oriented; -#X restore 500 597 pd META; -#X obj 0 478 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 539 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 567 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#X text 98 543 (none); -#N canvas 222 513 428 109 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 obj 22 43 fft~; -#X text 8 2 [framp~] Related Objects; -#X restore 101 597 pd Related_objects; -#X obj 78 426 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 486 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 451 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X obj 497 10 framp~; -#X text 147 127 frequency; -#X floatatom 78 142 0 0 0 0 - - -; -#X obj 78 92 * 44100; -#X floatatom 78 67 0 0 0 0 - - -; -#X text 150 65 frequency; -#X text 153 83 in bins; -#X text 147 144 in Hz.; -#X obj 79 193 rfft~; -#X obj 78 117 / 64; -#X msg 165 214 bang; -#X obj 78 220 framp~; -#X obj 165 269 print~ frequency; -#X obj 180 244 print~ amplitude; -#X obj 78 168 osc~; -#X text 201 214 <- print analysis; -#X text 98 425 signal; -#X text 98 450 signal; -#X text 98 485 signal; -#X obj 78 511 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 98 510 signal; -#X text 11 23 estimate frequency and amplitude of FFT components; -#X text 75 309 [framp~] takes as input a rectangular-windowed FFT and -outputs \, for each FFT channel \, the estimated amplitude and frequency -of any component feedinf that channel. A sinusoidal component should -appear in four components (or three in the special case of a sinusoid -exactly tuned to a bin.) Frequency output is in bins \, i.e. \, units -of SR/N.; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 478 56 pddp/dsp; -#X connect 14 0 26 0; -#X connect 15 0 21 0; -#X connect 16 0 15 0; -#X connect 20 0 23 0; -#X connect 20 1 23 1; -#X connect 21 0 14 0; -#X connect 22 0 24 0; -#X connect 22 0 25 0; -#X connect 23 0 24 0; -#X connect 23 1 25 0; -#X connect 26 0 20 0; diff --git a/doc/pddp/gatom-help.pd b/doc/pddp/gatom-help.pd deleted file mode 100644 index 75f1883de..000000000 --- a/doc/pddp/gatom-help.pd +++ /dev/null @@ -1,158 +0,0 @@ -#N canvas 428 36 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 gatom 3 12 0 18 --204280 -1 0; -#X obj 0 231 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 486 289 494 344 META 0; -#X text 12 115 LIBRARY internal; -#X text 12 155 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 35 LICENSE SIBSD; -#X text 12 135 AUTHOR Miller Puckette; -#X text 12 195 HELP_PATCH_AUTHORS Updated for Pd version 0.34. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 75 INLET_0 float bang symbol set; -#X text 12 95 OUTLET_0 float; -#X text 12 175 RELEASE_DATE 1997; -#X text 12 55 DESCRIPTION atom (number box and symbol box); -#X text 12 5 KEYWORDS control storage GUI nonlocal symbol_op; -#X restore 500 597 pd META; -#X obj 0 396 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 470 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; -#X text 98 474 (none); -#N canvas 214 517 428 109 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 47 1 Related Objects; -#X floatatom 9 3 5 0 0 0 - - -, f 5; -#X obj 21 42 float; -#X obj 61 42 list; -#X obj 102 45 nbx 5 14 -1e+37 1e+37 0 0 empty empty empty 0 -8 0 10 --262144 -1 -1 0 256 0; -#X obj 169 42 drawnumber; -#X restore 102 597 pd Related_objects; -#X obj 78 240 cnv 17 3 145 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 404 float; -#X obj 78 405 cnv 17 3 52 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X floatatom 401 9 5 0 0 0 - - -, f 5; -#X floatatom 25 58 0 0 0 0 - - -; -#X floatatom 25 96 0 0 0 0 - - -; -#X msg 469 76 set 45; -#X floatatom 469 104 0 0 0 0 - - -; -#X text 98 239 bang; -#X text 98 259 float; -#X text 98 289 list; -#X text 98 309 symbol; -#X text 98 339 set; -#N canvas 98 96 430 514 Number_box_properties 0; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X floatatom 70 102 12 0 0 0 - - -, f 12; -#X floatatom 71 223 1 0 0 0 - - -, f 1; -#X text 50 2 Properties for gatom; -#X text 20 38 Right click on a number box and choose "Properties" to -change the following:; -#X text 19 69 width; -#X text 69 69 - width of the number box (in characters). By default -the width is 5 characters.; -#X text 148 102 width = 12 characters; -#X floatatom 70 123 2 0 0 0 - - -, f 2; -#X text 148 123 width = 2 characters; -#X text 69 164 If you select a width of 0 \, the number box will grow -as needed to hold the number--BUT BEWARE \, THIS IS EXPENSIVE IN CPU -TIME. In a production patch \, you'll want to set a specific width. -; -#X floatatom 70 143 0 0 0 0 - - -; -#X text 148 143 width = 0 characters (read below); -#X text 69 240 A width of one gives a clickable toggle switch ala Max. -; -#X text 88 223 width = 1 character: toggle between 0 and 1; -#X text 19 260 limits; -#X floatatom 71 282 5 0 127 0 - - -, f 5; -#X text 109 281 numbers between 0 and 127; -#X text 69 260 - set lower and upper limits for scrolling the number -box; -#X text 68 300 This only affects scrolling- you can still send values -to the number box that are outside these limits.; -#X floatatom 71 353 5 0 127 1 my_number_box - -, f 5; -#X text 19 331 label; -#X text 69 331 - give the number box a visible name; -#X text 68 371 Use the radio buttons to reposition the label to the -left \, right \, top \, or bottom of the number box. Spaces in the -label will automatically be converted to underscores.; -#X text 19 413 messages; -#X text 69 413 - nonlocal send and receive; -#X floatatom 193 532 5 0 0 2 Number_box_7 gatom-help-rcv gatom-help-snd -, f 5; -#X obj 276 540 r gatom-help-snd; -#X obj 71 516 s gatom-help-rcv; -#X msg 71 490 28; -#X text 68 433 As an alternative to using wires \, you can set send -and receive names to send messages through the number box. "Number-box-7" -below is set to receive messages to "gatom-help-rcv" \, and send messages -to "gatom-help-snd"; -#X floatatom 276 563 5 0 0 0 - - -, f 5; -#X text 68 583 Notice that you cannot make local connections with wires -to "Number_box_7" when using non-local send and receive names. If you -want to use both \, see the [nbx] object:; -#X obj 71 626 nbx 5 14 -1e+37 1e+37 0 0 empty empty empty 0 -8 0 10 --262144 -1 -1 0 256 0; -#X floatatom 13 3 5 0 0 0 - - -, f 5; -#X connect 27 0 31 0; -#X connect 29 0 28 0; -#X restore 102 571 pd Number_box_properties; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X symbolatom 25 138 10 0 0 0 - - -, f 10; -#X text 11 23 atom (number box and symbol box); -#X symbolatom 481 9 10 0 0 0 - - -, f 10; -#X text 445 9 and; -#X symbolatom 25 174 10 0 0 0 - - -, f 10; -#X text 61 52 A number box allows you to display a number or enter -a number using the mouse and keyboard. When a number arrives at the -number box's inlet \, it is displayed and sent to the outlet. You can -click on a number box and drag upward or downward to change the value -continuously.; -#X text 97 134 A symbol box allows you to display a single symbol-atom -or enter one using the mouse and keyboard. Unlike a number box you -cannot change the value by clicking and dragging.; -#X text 96 174 The symbol box is called "Symbol" in the "Put" menu. -; -#X text 168 239 - sends the current value to the outlet.; -#X msg 469 156 set foo; -#X symbolatom 469 180 10 0 0 0 - - -, f 10; -#X text 168 309 - symbol box only: an incoming symbol is displayed -and output. (Number box will display and output zero.); -#X text 168 259 - number box only: sets the current value and outputs -it. (Symbol box will display 'float' and output 'symbol float'.); -#X text 168 289 - a list will be truncated to the first item.; -#X text 168 339 - displays the incoming value without outputting it -(e.g. \, "set 23" will cause a number box to display 23). Sending a -set message without a value does not change the current value of a -number box or symbol box.; -#X text 168 404 - number box only: outputs a float for each message -it receives (except set).; -#X text 98 434 symbol; -#X text 168 434 - symbol box only: outputs a symbol message for each -message it receives (except set).; -#X text 100 537 Control-clicking (or command-clicking on a mac) toggles -the value between 0 and the last nonzero value.; -#X floatatom 59 545 5 0 0 0 - - -, f 5; -#X text 100 503 You can shift-click a number box and drag to change -the number by hundredths instead of ones.; -#X text 61 118 The number box is called "Number" in the "Put" menu. -; -#X text 67 197 To enter data simply click a number box or symbol box -and begin typing. Then click "Enter" to finish and output it.; -#X connect 13 0 14 0; -#X connect 15 0 16 0; -#X connect 24 0 28 0; -#X connect 33 0 34 0; diff --git a/doc/pddp/get-help.pd b/doc/pddp/get-help.pd deleted file mode 100644 index 7a675ecff..000000000 --- a/doc/pddp/get-help.pd +++ /dev/null @@ -1,122 +0,0 @@ -#N struct get-help-template float x float y symbol s; -#N canvas 430 33 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 get 3 12 0 18 -204280 --1 0; -#X obj 0 338 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 482 279 494 344 META 0; -#X text 12 105 LIBRARY internal; -#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 125 AUTHOR Miller Puckette; -#X text 12 185 HELP_PATCH_AUTHORS Updated for Pd version 0.39. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 5 KEYWORDS control data_structure; -#X text 12 45 DESCRIPTION get values from a scalar; -#X text 12 65 INLET_0 pointer; -#X text 12 85 OUTLET_N float symbol; -#X text 12 165 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 375 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 438 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 506 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 216 515 428 109 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 obj 72 34 set; -#X obj 104 34 append; -#X obj 163 34 getsize; -#X obj 14 59 setsize; -#X obj 72 59 element; -#X obj 184 59 sublist; -#X obj 14 34 pointer; -#X obj 132 59 struct; -#X text 7 1 [get] Related Objects; -#X restore 102 597 pd Related_objects; -#X obj 78 347 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 383 float; -#X obj 78 384 cnv 17 3 48 empty \$0-pddp.cnv.let.n n 5 9 0 16 -228856 --162280 0; -#X obj 518 11 get; -#X msg 121 139 next; -#X floatatom 106 234 5 0 0 0 - - -, f 5; -#X floatatom 185 234 5 0 0 0 - - -, f 5; -#X obj 106 162 pointer; -#X text 302 115 output first scalar in list; -#X text 164 138 output next item; -#X text 102 250 x output; -#X text 183 250 y output; -#X text 261 251 s output; -#X symbolatom 265 234 18 0 0 0 - - -, f 18; -#X obj 145 186 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X text 98 346 pointer; -#X text 168 346 - [get] takes a pointer to a scalar.; -#X text 98 398 symbol; -#X text 166 183 bang when there are no more items; -#X text 11 23 get values from a scalar; -#X text 221 283 <- Click here to see the data; -#N canvas 111 75 428 272 get-help-data 0; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 1 [get] Data Window; -#X scalar get-help-template 22 43 guten_tag \;; -#X scalar get-help-template 79 87 jo_napot_kivanok \;; -#X text 62 42 Each blue rectangle is a scalar. Their appearance and -data structure are defined by the template "get-help-template".; -#X text 27 187 In addition to using the [get] object \, you can right-click -on a rectangle and choose "Properties" to view the field values of -the scalar. (You can also change them-- once you are finished \, click -"Ok" to update the values.); -#X text 27 124 The "x" and "y" fields in a [struct] are special: they -always specify the screen coordinates for the top left corner of each -rectangle. In editmode you can click and drag each rectangle to change -these values.; -#X restore 106 283 pd get-help-data; -#X msg 106 116 traverse pd-get-help-data \, next; -#X obj 106 208 get get-help-template x y s; -#N canvas 105 219 428 175 get-help-template 0; -#X obj 23 118 filledpolygon 9 0 1 0 0 20 0 20 30 0 30; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 1 [get] Template subpatch; -#X text 19 69 This [struct] just defines a simple data structure. The -values for the fields were set when this help patch was created.; -#X obj 21 42 struct get-help-template float x float y symbol s; -#X text 21 137 Draw a blue rectangle with a black border.; -#X restore 106 305 pd get-help-template; -#X text 168 383 - one outlet is created for each field specified in -the creation arguments. When [get] receives a pointer at its inlet -\, the value of each field is output to the corresponding outlet.; -#X text 168 472 - the name of a field or fields in that template. An -outlet is created for each field specified.; -#X text 103 56 [get] \, when sent a pointer to a scalar \, retrieves -fields from it by name. The fields can be a float or symbol. (In the -future this will also allow access to sublists of scalars.); -#X text 168 457 - a struct name to specify the template of a scalar. -; -#X text 97 510 If you have data whose templates vary (from a heterogeneous -list \, for example) you can use [pointer] to select according to template -before sending to [get]. (See pointer-help.pd for more information.) -; -#X text 80 457 1) symbol atom; -#X text 80 472 n) symbol atom; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 97 563 pddp/pddplink ../04.data.structures/02.getting.data.pd --text doc/04.data.structures/02.getting.data.pd; -#X obj 97 578 pddp/pddplink scalar-help.pd; -#X connect 12 0 15 0; -#X connect 15 0 31 0; -#X connect 15 1 22 0; -#X connect 30 0 15 0; -#X connect 31 0 13 0; -#X connect 31 1 14 0; -#X connect 31 2 21 0; diff --git a/doc/pddp/getsize-help.pd b/doc/pddp/getsize-help.pd deleted file mode 100644 index 614bbba2c..000000000 --- a/doc/pddp/getsize-help.pd +++ /dev/null @@ -1,102 +0,0 @@ -#N struct help-getsize-template float x float y array array1 help-getsize-array1-template -; -#N struct help-getsize-array1-template float y float x; -#N canvas 426 32 555 619 10; -#X scalar help-getsize-template 89 279 \; 7 -6 \; 7 35 \; 26 57 \; -45 85 \; 74 90 \; 79 137 \; 48 150 \; \;; -#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 getsize 3 12 0 18 --204280 -1 0; -#X obj 0 406 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 478 284 494 344 META 0; -#X text 12 105 LIBRARY internal; -#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 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 5 KEYWORDS control data_structure array; -#X text 12 45 DESCRIPTION get the number of elements in an array; -#X text 12 65 INLET_0 pointer; -#X text 12 85 OUTLET_0 float; -#X text 12 165 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 443 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 485 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 553 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 214 518 428 109 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 obj 71 34 pointer; -#X obj 205 34 setsize; -#X obj 138 34 element; -#X obj 14 34 struct; -#X text 7 1 [getsize] Related Objects; -#X obj 14 70 get; -#X obj 51 70 set; -#X obj 84 70 append; -#X obj 138 70 sublist; -#X restore 102 597 pd Related_objects; -#X obj 78 415 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 451 float; -#X obj 78 452 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 492 11 getsize; -#X obj 78 135 pointer; -#X floatatom 78 190 5 0 0 0 - - -, f 5; -#X obj 78 161 getsize help-getsize-template array1; -#N canvas 83 204 428 227 help-getsize-template 0; -#X obj 21 42 struct help-getsize-template float x float y array array1 -help-getsize-array1-template; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 1 [getsize] Data Structure; -#X obj 21 138 filledpolygon 11 527 1 -10 0 175 0 175 110 -10 110; -#X obj 21 85 plot array1 770 2 10 15 20; -#X text 18 107 An array plotted with a yellow trace 2 pixels wide. -; -#X text 18 157 A black rectangle for the background.; -#X restore 78 223 pd help-getsize-template; -#N canvas 76 167 428 138 help-getsize-array1-template 0; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 1 [getsize] Data Structure; -#X obj 21 42 struct help-getsize-array1-template float y float x; -#X obj 21 69 filledpolygon 999 5 1 -5 0 0 5 5 0 0 -5; -#X text 18 91 This is the template for the elements of the array "array1" -\, which is defined in [pd help-getsize-template].; -#X restore 78 244 pd help-getsize-array1-template; -#X text 98 414 pointer; -#X text 11 23 get the number of elements in an array; -#X text 168 414 - a pointer to a scalar that contains an array.; -#X text 168 451 - the output of [getsize] is the number of elements -in the array. The smallest possible size is one.; -#X text 81 504 1) symbol; -#X text 81 520 2) symbol; -#X text 77 55 When sent a pointer \, [getsize] looks up a field \, -which should be an array \, and outputs the number of elements of the -array.; -#X text 168 504 - a struct name to specify the the template of a scalar. -; -#X text 119 190 here we just get the size of the array "array1".; -#X text 168 519 - the name of a field within that template. (The field -must be an array.); -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 98 557 pddp/pddplink all_about_arrays.pd; -#X obj 98 572 pddp/pddplink scalar-help.pd; -#X msg 78 109 traverse pd-getsize-help.pd \, next; -#X text 278 303 To the left is a scalar that contains; -#X text 278 333 diamond represents one element. (The; -#X text 278 318 an array of 7 elements. Each white; -#X text 278 348 black background is just a reference.); -#X connect 13 0 15 0; -#X connect 15 0 14 0; -#X connect 31 0 13 0; diff --git a/doc/pddp/graph-help.pd b/doc/pddp/graph-help.pd deleted file mode 100644 index 05d2f0285..000000000 --- a/doc/pddp/graph-help.pd +++ /dev/null @@ -1,59 +0,0 @@ -#N canvas 430 39 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 (graph) 3 12 0 18 --204280 -1 0; -#X obj 0 453 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 485 291 494 344 META 0; -#X text 12 65 LIBRARY internal; -#X text 12 105 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 85 AUTHOR Miller Puckette; -#X text 12 145 HELP_PATCH_AUTHORS Updated for Pd v0.41. Revised by -Jonathan Wilkes to conform to the PDDP template for Pd version 0.42. -; -#X text 12 5 KEYWORDS signal GUI; -#X text 12 45 DESCRIPTION container canvas for a garray; -#X text 12 125 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 483 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 513 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 566 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 218 526 428 109 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 obj 23 43 table; -#N canvas 0 0 450 300 (subpatch) 0; -#X restore 70 43 pd; -#X text 8 2 (graph) Related Objects; -#X restore 102 598 pd Related_objects; -#X text 80 532 1) symbol atom; -#X text 98 461 (none); -#X text 98 491 (none); -#N canvas 0 0 450 300 (subpatch) 0; -#X coords 0 1 100 -1 40 20 1; -#X restore 496 9 graph; -#N canvas 0 0 450 300 (subpatch) 0; -#X coords 0 1 100 -1 200 140 1; -#X restore 165 188 graph; -#X text 100 56 A graph in Pd is a rectangular subregion of the window -in which you can store numeric arrays.; -#X text 99 133 You can change the array values by redrawing it in the -graph. See also "11.arrays" and passim in the "control examples".; -#X text 99 88 If you create a new array Pd will usually make a new -graph to put it in (you can change this using the "array" dialog that -pops up.); -#X text 99 345 You can put a garray in the graph above by choosing -"Array" from the "Put" menu. Just choose "in last graph" from the dialog -window. For more help on garrays \, see below under the heading "more_info". -; -#X text 167 532 - (optional) the name of the graph. When using the -"Put" menu \, the name is created automatically.; -#X text 11 23 container canvas for a garray; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 98 572 pddp/pddplink array-help.pd -text array-help; diff --git a/doc/pddp/hdial-help.pd b/doc/pddp/hdial-help.pd deleted file mode 100644 index 37b603ddf..000000000 --- a/doc/pddp/hdial-help.pd +++ /dev/null @@ -1,283 +0,0 @@ -#N canvas 433 45 612 281 10; -#X obj 1 1 cnv 8 100 60 empty empty hdial=hdl 20 20 1 18 -262144 -1109 -0; -#X text 16 213 (c) musil@iem.kug.ac.at; -#X text 58 226 IEM KUG; -#X text 289 52 click properties to; -#X text 277 63 modify geometry \, colors \, etc.; -#X obj 356 172 bng 15 250 50 0 empty empty empty 8 -8 0 10 -262144 --1 -1; -#X obj 21 54 bng 15 250 50 0 empty empty empty 8 -8 0 10 -262144 -1 --1; -#X obj 355 124 s foo8_rcv; -#X obj 356 150 r foo8_snd; -#X obj 44 100 hdl 25 1 1 10 foo8_snd foo8_rcv hdial_0_9 156 -8 192 -10 -99865 -262144 -260818 2; -#X msg 44 142 \$1; -#X floatatom 44 164 4 0 0 0 - - -, f 4; -#X obj 44 186 bng 15 250 50 0 empty empty empty 8 -8 0 10 -262144 -1 --1; -#X obj 89 161 tgl 12 0 empty empty empty 8 -8 0 10 -262144 -1 -1 0 -1; -#X obj 89 140 route 0 1 2 3 4 5 6 7 8 9; -#X msg 176 64 set \$1; -#X floatatom 176 43 4 0 9 0 - - -, f 4; -#X floatatom 44 54 4 0 9 0 - - -, f 4; -#X msg 91 41 7 0 -5.44; -#X msg 95 63 3 3 4.55; -#X obj 106 161 tgl 12 0 empty empty empty 8 -8 0 10 -262144 -1 -1 0 -1; -#X obj 123 161 tgl 12 0 empty empty empty 8 -8 0 10 -262144 -1 -1 1 -1; -#X obj 140 161 tgl 12 0 empty empty empty 8 -8 0 10 -262144 -1 -1 0 -1; -#X obj 157 161 tgl 12 0 empty empty empty 8 -8 0 10 -262144 -1 -1 0 -1; -#X obj 174 161 tgl 12 0 empty empty empty 8 -8 0 10 -262144 -1 -1 0 -1; -#X obj 191 161 tgl 12 0 empty empty empty 8 -8 0 10 -262144 -1 -1 0 -1; -#X obj 208 161 tgl 12 0 empty empty empty 8 -8 0 10 -262144 -1 -1 0 -1; -#X obj 225 161 tgl 12 0 empty empty empty 8 -8 0 10 -262144 -1 -1 0 -1; -#X obj 242 161 tgl 12 0 empty empty empty 8 -8 0 10 -262144 -1 -1 0 -1; -#X obj 82 178 print; -#X floatatom 380 198 4 0 0 0 - - -, f 4; -#X msg 380 172 \$1; -#X msg 355 103 set \$1; -#X floatatom 355 82 4 0 9 0 - - -, f 4; -#X text 128 178 UP- \, DOWN- \, LEFT- or RIGHT-key; -#X text 127 189 for moving selected gui-objects; -#N canvas 226 227 699 530 edit 0; -#X obj 42 198 f; -#X msg 20 177 bang; -#X floatatom 58 176 3 63 156 0 - - -, f 3; -#X floatatom 93 198 3 -20 37 0 - - -, f 3; -#X obj 42 221 pack 0 0; -#X text 120 198 y-label; -#X text 86 176 x-label; -#X floatatom 270 187 3 8 50 0 - - -, f 3; -#X text 297 187 size; -#X obj 286 293 f; -#X msg 264 272 bang; -#X floatatom 302 271 3 -10 10 0 - - -, f 3; -#X floatatom 337 293 3 -10 10 0 - - -, f 3; -#X obj 286 316 pack 0 0; -#X obj 300 412 f; -#X msg 278 391 bang; -#X floatatom 316 390 3 20 60 0 - - -, f 3; -#X floatatom 351 412 3 100 200 0 - - -, f 3; -#X obj 300 435 pack 0 0; -#X text 330 271 x-delta; -#X text 364 293 y-delta; -#X text 344 390 x-position; -#X text 378 412 y-position; -#X obj 62 313 f; -#X msg 40 292 bang; -#X floatatom 78 291 3 0 2 0 - - -, f 3; -#X floatatom 113 313 3 4 36 0 - - -, f 3; -#X obj 62 336 pack 0 0; -#X text 106 291 font; -#X text 142 313 height; -#X text 504 293 no init; -#X text 475 348 init value on loadbang; -#X floatatom 482 228 5 2 20 0 - - -, f 5; -#X msg 47 125 \; foo8_rcv color \$1 \$2 \$3; -#X msg 42 246 \; foo8_rcv label_pos \$1 \$2; -#X msg 62 361 \; foo8_rcv label_font \$1 \$2; -#X msg 34 423 \; foo8_rcv label blabla; -#X msg 300 460 \; foo8_rcv pos \$1 \$2; -#X msg 286 341 \; foo8_rcv delta \$1 \$2; -#X msg 270 216 \; foo8_rcv size \$1; -#X msg 482 171 \; foo8a_rcv receive foo8_rcv; -#X msg 483 133 \; foo8_rcv receive foo8a_rcv; -#X msg 483 88 \; foo8_rcv send foo8_snd; -#X msg 483 50 \; foo8_rcv send foo8a_snd; -#X msg 483 312 \; foo8_rcv init 0; -#X msg 485 366 \; foo8_rcv init 1; -#X msg 490 436 \; foo8_rcv single_change; -#X msg 490 470 \; foo8_rcv double_change; -#X text 491 417 changing-behavior; -#X msg 482 254 \; foo8_rcv number \$1; -#X text 526 228 number of buttons; -#X obj 47 104 pack 0 0 0; -#X obj 47 76 f; -#X msg 24 28 bang; -#X floatatom 63 26 3 0 29 0 - - -, f 3; -#X floatatom 79 46 3 0 29 0 - - -, f 3; -#X floatatom 112 62 3 0 29 0 - - -, f 3; -#X text 91 26 background; -#X text 106 46 front-color; -#X text 140 63 label-color; -#X msg 285 25 back; -#X msg 285 45 front; -#X msg 285 65 label; -#X msg 247 25 bang; -#N canvas 15 207 606 448 RGB_____________ 0; -#X obj 97 56 inlet; -#X obj 262 53 inlet; -#X obj 339 55 inlet; -#X obj 405 56 inlet; -#X obj 97 270 bang; -#X msg 77 295 0; -#X msg 104 295 1; -#X obj 146 268 bang; -#X msg 132 295 0; -#X msg 160 295 1; -#X obj 196 269 bang; -#X msg 187 295 0; -#X msg 214 295 1; -#X obj 265 313 spigot; -#X obj 312 313 spigot; -#X obj 359 313 spigot; -#X obj 249 385 outlet; -#X text 93 33 select; -#X text 267 28 red; -#X text 337 30 green; -#X text 409 30 blue; -#X obj 405 102 t b f; -#X obj 339 160 +; -#X obj 339 185 t b f; -#X obj 339 216 +; -#X obj 296 385 outlet; -#X obj 343 385 outlet; -#X obj 28 180 loadbang; -#X obj 97 135 route back front label bang; -#X obj 343 362 f; -#X obj 296 361 f; -#X obj 249 361 f; -#X obj 262 79 * -65536; -#X obj 339 80 * -256; -#X obj 405 80 * -1; -#X obj 339 247 - 1; -#X obj 235 168 t b b b b; -#X connect 0 0 28 0; -#X connect 1 0 32 0; -#X connect 2 0 33 0; -#X connect 3 0 34 0; -#X connect 4 0 5 0; -#X connect 4 0 6 0; -#X connect 5 0 14 1; -#X connect 5 0 15 1; -#X connect 6 0 13 1; -#X connect 7 0 8 0; -#X connect 7 0 9 0; -#X connect 8 0 13 1; -#X connect 8 0 15 1; -#X connect 9 0 14 1; -#X connect 10 0 11 0; -#X connect 10 0 12 0; -#X connect 11 0 13 1; -#X connect 11 0 14 1; -#X connect 12 0 15 1; -#X connect 13 0 31 1; -#X connect 14 0 30 1; -#X connect 15 0 29 1; -#X connect 21 0 22 0; -#X connect 21 1 22 1; -#X connect 22 0 23 0; -#X connect 23 0 24 0; -#X connect 23 1 24 1; -#X connect 24 0 35 0; -#X connect 27 0 6 0; -#X connect 28 0 4 0; -#X connect 28 1 7 0; -#X connect 28 2 10 0; -#X connect 28 3 36 0; -#X connect 29 0 26 0; -#X connect 30 0 25 0; -#X connect 31 0 16 0; -#X connect 32 0 24 0; -#X connect 33 0 22 0; -#X connect 34 0 21 0; -#X connect 35 0 15 0; -#X connect 35 0 14 0; -#X connect 35 0 13 0; -#X connect 36 0 31 0; -#X connect 36 1 30 0; -#X connect 36 2 29 0; -#X connect 36 3 35 0; -#X restore 285 86 pd RGB_____________; -#X floatatom 327 55 3 0 255 0 - - -, f 3; -#X floatatom 370 55 3 0 255 0 - - -, f 3; -#X floatatom 413 56 3 0 255 0 - - -, f 3; -#X text 34 0 preset-colors; -#X text 296 -3 RGB-colors; -#X text 327 37 red; -#X text 363 36 green; -#X text 411 36 blue; -#X msg 34 459 \; foo8_rcv label hdial_0_9; -#X connect 0 0 4 0; -#X connect 1 0 0 0; -#X connect 2 0 0 1; -#X connect 3 0 4 1; -#X connect 4 0 34 0; -#X connect 7 0 39 0; -#X connect 9 0 13 0; -#X connect 10 0 9 0; -#X connect 11 0 9 1; -#X connect 12 0 13 1; -#X connect 13 0 38 0; -#X connect 14 0 18 0; -#X connect 15 0 14 0; -#X connect 16 0 14 1; -#X connect 17 0 18 1; -#X connect 18 0 37 0; -#X connect 23 0 27 0; -#X connect 24 0 23 0; -#X connect 25 0 23 1; -#X connect 26 0 27 1; -#X connect 27 0 35 0; -#X connect 32 0 49 0; -#X connect 51 0 33 0; -#X connect 52 0 51 0; -#X connect 53 0 52 0; -#X connect 54 0 52 1; -#X connect 55 0 51 1; -#X connect 56 0 51 2; -#X connect 60 0 64 0; -#X connect 61 0 64 0; -#X connect 62 0 64 0; -#X connect 63 0 64 0; -#X connect 64 0 51 0; -#X connect 64 1 51 1; -#X connect 64 2 51 2; -#X connect 65 0 64 1; -#X connect 66 0 64 2; -#X connect 67 0 64 3; -#X restore 469 108 pd edit; -#X obj 346 35 hdl 15 1 0 8 eee eee empty 20 8 192 8 -262144 -1 -1 0 -; -#X obj 260 11 x_all_guis aaa bbb ccc ddd eee fff ggg hhh iii; -#X text 183 11 gui-hdial:; -#X text 33 238 graz \, austria 2002; -#X text 251 232 updated for Pd version 0.35; -#X text 279 254 KEYWORDS deprecated; -#X connect 6 0 9 0; -#X connect 8 0 5 0; -#X connect 8 0 31 0; -#X connect 9 0 10 0; -#X connect 9 0 14 0; -#X connect 9 0 29 0; -#X connect 10 0 11 0; -#X connect 11 0 12 0; -#X connect 14 0 13 0; -#X connect 14 1 20 0; -#X connect 14 2 21 0; -#X connect 14 3 22 0; -#X connect 14 4 23 0; -#X connect 14 5 24 0; -#X connect 14 6 25 0; -#X connect 14 7 26 0; -#X connect 14 8 27 0; -#X connect 14 9 28 0; -#X connect 15 0 9 0; -#X connect 16 0 15 0; -#X connect 17 0 9 0; -#X connect 18 0 9 0; -#X connect 19 0 9 0; -#X connect 31 0 30 0; -#X connect 32 0 7 0; -#X connect 33 0 32 0; diff --git a/doc/pddp/hip~-help.pd b/doc/pddp/hip~-help.pd deleted file mode 100644 index 2fa253786..000000000 --- a/doc/pddp/hip~-help.pd +++ /dev/null @@ -1,95 +0,0 @@ -#N canvas 425 40 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 hip~ 3 12 0 18 -204280 --1 0; -#X obj 0 381 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 485 284 494 344 META 0; -#X text 12 125 LIBRARY internal; -#X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 145 AUTHOR Miller Puckette; -#X text 12 205 HELP_PATCH_AUTHORS Updated for Pd version 0.37. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 5 KEYWORDS signal filter; -#X text 12 45 DESCRIPTION one-pole high pass filter; -#X text 12 105 OUTLET_0 signal; -#X text 12 65 INLET_0 signal clear; -#X text 12 85 INLET_1 float; -#X text 12 185 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 488 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 525 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 566 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#X obj 78 390 cnv 17 3 37 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#N canvas 219 468 428 166 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 [hip~] Related Objects; -#X obj 22 43 lop~; -#X obj 69 43 bp~; -#X obj 117 43 vcf~; -#X text 22 81 Raw Filters; -#X obj 73 108 rzero~; -#X obj 195 108 cpole~; -#X obj 24 108 rpole~; -#X obj 122 108 rzero_rev~; -#X obj 244 108 czero~; -#X obj 293 108 czero_rev~; -#X restore 101 597 pd Related_objects; -#X text 98 389 signal; -#X obj 78 497 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 497 signal; -#X obj 510 11 hip~; -#X obj 146 270 env~; -#X floatatom 146 293 0 0 0 0 - - -; -#X floatatom 195 215 0 0 0 0 - - -; -#X obj 146 243 hip~ 5; -#X obj 88 270 env~; -#X floatatom 88 292 0 0 0 0 - - -; -#X floatatom 88 144 0 0 0 0 - - -; -#X text 89 105 The left inlet is the incoming audio signal. The right -inlet is the cutoff frequency in Hz.; -#X obj 88 167 osc~ 100; -#X text 133 142 <-- scroll to change input frequency; -#X msg 146 191 clear; -#X text 198 190 <-- reinitialize internal state; -#X text 227 216 <-- set cutoff frequency; -#X text 168 389 - incoming audio signal.; -#X obj 78 432 cnv 17 3 45 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 98 431 float; -#X text 98 449 list; -#X text 98 409 clear; -#X text 84 312 Compare the strength of the original signal on the left -with that of the filtered signal on the right.; -#X text 11 23 one-pole high pass filter; -#X text 168 543 - initial rolloff frequency.; -#X text 168 409 - reinitialize internal state.; -#X text 168 431 - cutoff frequency in Hz.; -#X text 168 449 - a list to the right inlet is truncated \, and the -first element is used as the cutoff frequency.; -#X text 88 68 [hip~] is a one-pole high pass filter with a specified -rolloff frequency.; -#X text 191 272 [env~] gives the amplitude of the signal envelop in -dB.; -#X text 168 497 - the output is the filtered audio signal.; -#X text 80 543 1) float; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 479 52 pddp/dsp; -#X connect 13 0 14 0; -#X connect 15 0 16 1; -#X connect 16 0 13 0; -#X connect 17 0 18 0; -#X connect 19 0 21 0; -#X connect 21 0 17 0; -#X connect 21 0 16 0; -#X connect 23 0 16 0; diff --git a/doc/pddp/hslider-help.pd b/doc/pddp/hslider-help.pd deleted file mode 100644 index 6b0fa6cf2..000000000 --- a/doc/pddp/hslider-help.pd +++ /dev/null @@ -1,439 +0,0 @@ -#N canvas 428 39 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 hslider 3 12 0 18 --204280 -1 0; -#X obj 0 291 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 482 291 494 344 META 0; -#X text 12 135 LIBRARY internal; -#X text 12 45 LICENSE SIBSD; -#X text 12 155 AUTHOR Thomas Musil; -#X text 12 175 WEBSITE; -#X text 12 215 HELP_PATCH_AUTHORS Jonathan Wilkes revised the patch -to conform to the PDDP template for Pd version 0.42.; -#X text 12 25 KEYWORDS control storage GUI nonlocal; -#X text 12 65 DESCRIPTION horizontal gui-slider; -#X text 12 5 ALIAS hsl; -#X text 12 85 INLET_0 float bang size range log init steady receive -send label label_pos label_font color pos delta; -#X text 12 115 OUTLET_0 float; -#X text 12 195 RELEASE_DATE 2002; -#X restore 500 597 pd META; -#X obj 0 410 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 461 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 546 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#X obj 78 300 cnv 17 3 105 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#N canvas 211 518 428 112 Related_objects 0; -#X obj 19 52 x_all_guis bng tgl vsl hsl hradio vradio vu cnv nbx; -#X text 17 28 All iem-gui objects:; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 1 [hslider] Related Objects; -#X restore 100 597 pd Related_objects; -#X obj 78 419 cnv 17 3 35 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 291 175 and receive names. Right-; -#X text 291 190 click and choose; -#X text 290 206 "Properties" to set them \,; -#X text 98 299 float; -#X text 98 340 list; -#X text 98 419 float; -#X text 291 220 or change them with messages (see below); -#X obj 414 45 hsl 128 15 0 127 0 0 empty empty empty -2 -8 0 10 -262144 --1 -1 0 1; -#X floatatom 135 116 4 0 0 0 - - -, f 4; -#X msg 199 69 set \$1; -#X floatatom 155 48 4 0 0 0 - - -, f 4; -#X obj 135 138 bng 15 250 50 0 empty empty empty 8 -8 0 10 -262144 --1 -1; -#X obj 135 49 bng 15 250 50 0 empty empty empty 8 -8 0 10 -262144 -1 --1; -#X obj 138 94 hsl 101 15 25 75 0 1 foo1_snd foo1_rcv empty 8 -8 0 10 --225280 -1109 -1 3900 1; -#X floatatom 199 48 4 0 0 0 - - -, f 4; -#X floatatom 292 141 4 0 0 0 - - -, f 4; -#X floatatom 292 48 4 0 0 0 - - -, f 4; -#X obj 179 140 print; -#N canvas 276 200 290 224 once 0; -#X obj 38 47 t b b f; -#X msg 56 85 1; -#X obj 31 108 f 0; -#X obj 31 131 pack 0 0; -#X obj 31 156 route 0; -#X obj 38 24 inlet; -#X obj 31 180 outlet; -#X connect 0 0 1 0; -#X connect 0 1 2 0; -#X connect 0 2 3 1; -#X connect 1 0 2 1; -#X connect 2 0 3 0; -#X connect 3 0 4 0; -#X connect 4 0 6 0; -#X connect 5 0 0 0; -#X restore 179 116 pd once; -#X obj 59 177 hsl 73 15 55 3520 1 1 goo2_snd goo2_rcv log.freq. 8 7 -0 10 -204800 -260818 -90133 1618 1; -#X obj 56 203 ftom; -#X floatatom 56 227 4 0 0 0 - - -, f 4; -#X floatatom 143 215 9 0 0 0 - - -, f 9; -#X floatatom 56 132 4 0 0 0 - - -, f 4; -#X obj 56 153 mtof; -#X obj 292 92 s foo1_rcv; -#X obj 292 117 r foo1_snd; -#X msg 292 68 set \$1; -#X text 139 193 (0.01 pixels); -#X text 142 163 shift-click & drag; -#X text 142 178 for fine-tuning; -#X text 54 248 Use the UP- \, DOWN- \, LEFT- or RIGHT-key to move a -selected gui-object. Right-click and choose "Properties" to modify -its appearance.; -#X text 290 159 hslider has settable send; -#X text 98 356 Special messages can be sent to [hslider] to change -its properties:; -#X text 168 419 - when the slider value is changed by clicking \, dragging -\, or sending a float to the inlet \, the new slider value is sent -to the outlet.; -#N canvas 94 219 428 370 hsl-creation-arguments 0; -#X obj 22 289 s pd-hsl-creation-arguments; -#X text 20 37 "hsl" can be called with 18 creation arguments. These -are not "optional" - all parameters must be filled or the gui-bng will -not instantiate correctly.; -#X text 21 225 For example \, click the msg-box to dynamically create -a hsl:; -#X text 20 84 hsl creation arguments: xSize ySize rangeBtm rangeTop -Logarithmic Init sendName receiveName Label labelXOff labelYOff Font# -fontSize bgColor foregroundColor lblColor sliderPosition steadyOnClick -; -#X text 21 142 note: sliderPosition is not the same as the initialization -value. To dynamically instantiate an hsl that initializes with a desired -value \, save an hsl in a patch and view it in a text editor to get -the right value for sliderPosition. Or \, refer to hslider_set in g_hslider.c -for conversion between sliderPosition and slider value.; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 1 [hslider] Creation Arguments and Dynamic Patching; -#X msg 22 247 obj 150 335 hsl 75 20 -1 1 0 1 send receive Celaeno 12 --9 0 12 7 13 21 4400 0; -#X connect 7 0 0 0; -#X restore 170 521 pd hsl-creation-arguments; -#N canvas 66 11 463 602 Setting_slider_properties_through_messages -0; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X floatatom 11 188 1 0 1 0 - #0-soc -, f 1; -#X text 323 34 no init; -#X text 8 169 steady-on-click; -#X text 339 169 label; -#X msg 339 191 label blabla; -#X msg 323 53 init 0; -#X msg 11 221 steady \$1; -#X msg 234 73 lin; -#X msg 244 105 log; -#X text 230 34 linear/; -#X text 230 49 logarithmical; -#X text 332 73 init value; -#X text 333 88 on loadbang; -#X text 231 169 change send name; -#X text 106 169 change receive name; -#X obj 120 244 s z_rcv; -#X msg 108 191 receive z_rcv; -#X msg 347 243 label mySlider; -#X obj 234 134 s hsl_rcv; -#X obj 323 134 s hsl_rcv; -#X obj 11 269 s hsl_rcv; -#X obj 233 269 s hsl_rcv; -#X obj 108 269 s hsl_rcv; -#X msg 120 221 receive hsl_rcv; -#X msg 233 192 send hsl1_snd; -#X msg 242 221 send hsl_snd; -#X obj 339 271 s hsl_rcv; -#N canvas 382 136 161 310 init 0; -#X obj 16 11 loadbang; -#X obj 16 42 f \$0; -#X msg 16 73 \; \$1-xpos 300 \; \$1-ypos 350 \; \$1-xlabel -2 \; \$1-ylabel --8 \; \$1-soc 1 \; \$1-font-size 10 \; \$1-width 128 \; \$1-height -15 \; \$1-bottom 0 \; \$1-top 127 \; \$1-bg 0 \; \$1-front 12 \; \$1-label -12; -#X connect 0 0 1 0; -#X connect 1 0 2 0; -#X restore 384 415 pd init; -#X msg 333 109 init 1; -#X msg 11 105 size \$1 \$2; -#X text 60 56 1.width; -#X text 60 77 2.height; -#X obj 11 134 s hsl_rcv; -#X obj 123 134 s hsl_rcv; -#X text 172 56 1.bottom; -#X text 172 77 2.top; -#X text 120 34 output-range; -#X msg 123 105 range \$1 \$2; -#X text 136 307 font properties; -#X msg 138 379 label_font \$1 \$2; -#X text 187 329 1.font(0-2); -#X text 187 350 2.height; -#X text 9 308 label position; -#X msg 11 380 label_pos \$1 \$2; -#X text 60 330 1.x-offset; -#X text 60 351 2.y-offset; -#X obj 11 405 s hsl_rcv; -#X obj 138 404 s hsl_rcv; -#X obj 273 325 cnv 15 157 82 empty empty empty 20 12 0 14 -1 -66577 -0; -#X obj 274 326 cnv 15 155 80 empty empty empty 20 12 0 14 -261682 -66577 -0; -#N canvas 366 206 174 259 flash-time 0; -#X obj 68 180 pack; -#X obj 103 149 t b a; -#X obj 68 205 outlet; -#X obj 103 104 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-width empty -0 -8 0 12 -262144 -1 -1 128 256 0; -#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-height empty -0 -8 0 12 -262144 -1 -1 15 256 0; -#X connect 0 0 2 0; -#X connect 1 0 0 0; -#X connect 1 1 0 1; -#X connect 3 0 0 0; -#X connect 4 0 1 0; -#X coords 0 -1 1 1 48 42 2 100 100; -#X restore 11 55 pd flash-time; -#N canvas 366 206 174 259 flash-time 0; -#X obj 68 180 pack; -#X obj 103 149 t b a; -#X obj 68 205 outlet; -#X obj 103 104 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-bottom empty -0 -8 0 12 -262144 -1 -1 0 256 0; -#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-top empty 0 --8 0 12 -262144 -1 -1 127 256 0; -#X connect 0 0 2 0; -#X connect 1 0 0 0; -#X connect 1 1 0 1; -#X connect 3 0 0 0; -#X connect 4 0 1 0; -#X coords 0 -1 1 1 48 42 2 100 100; -#X restore 123 55 pd flash-time; -#N canvas 366 206 174 259 flash-time 0; -#X obj 68 180 pack; -#X obj 103 149 t b a; -#X obj 68 205 outlet; -#X obj 103 104 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-xlabel empty -0 -8 0 12 -262144 -1 -1 -2 256 0; -#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-ylabel empty -0 -8 0 12 -262144 -1 -1 -8 256 0; -#X connect 0 0 2 0; -#X connect 1 0 0 0; -#X connect 1 1 0 1; -#X connect 3 0 0 0; -#X connect 4 0 1 0; -#X coords 0 -1 1 1 48 42 2 100 100; -#X restore 11 329 pd flash-time; -#N canvas 366 206 174 259 flash-time 0; -#X obj 68 180 pack; -#X obj 103 149 t b a; -#X obj 68 205 outlet; -#X obj 103 104 nbx 3 14 0 2 0 0 \$0-dummy \$0-font empty 0 -8 0 12 --262144 -1 -1 0 256 0; -#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-font-size empty -0 -8 0 12 -262144 -1 -1 10 256 0; -#X connect 0 0 2 0; -#X connect 1 0 0 0; -#X connect 1 1 0 1; -#X connect 3 0 0 0; -#X connect 4 0 1 0; -#X coords 0 -1 1 1 48 42 2 100 100; -#X restore 138 328 pd flash-time; -#X text 8 448 preset-colors; -#X text 104 448 RGB-colors; -#X msg 11 554 color \$1 \$2 \$3; -#N canvas 364 205 306 317 flash-time 0; -#X obj 69 196 t b a; -#X obj 33 262 outlet; -#X obj 33 237 pack 0 0 0; -#X obj 120 197 t b a; -#X obj 103 104 nbx 3 14 0 29 0 0 \$0-dummy \$0-bg empty 0 -8 0 12 -262144 --1 -1 0 256 0; -#X obj 103 124 nbx 3 14 0 29 0 0 \$0-dummy \$0-front empty 0 -8 0 12 --262144 -1 -1 12 256 0; -#X obj 103 144 nbx 3 14 0 29 0 0 \$0-dummy \$0-label empty 0 -8 0 12 --262144 -1 -1 12 256 0; -#X connect 0 0 2 0; -#X connect 0 1 2 1; -#X connect 2 0 1 0; -#X connect 3 0 2 0; -#X connect 3 1 2 2; -#X connect 4 0 2 0; -#X connect 5 0 0 0; -#X connect 6 0 3 0; -#X coords 0 -1 1 1 48 62 2 100 100; -#X restore 11 469 pd flash-time; -#N canvas 0 0 306 317 flash-time 0; -#X obj 96 521 outlet; -#X obj 162 230 t b f; -#X obj 96 268 +; -#X obj 96 293 t b f; -#X obj 96 324 +; -#X obj 19 208 * -65536; -#X obj 96 208 * -256; -#X obj 162 208 * -1; -#X obj 96 355 - 1; -#X obj 96 385 list prepend 0; -#X obj 96 410 route 0 1 2; -#X obj 96 497 pack 0 0 0; -#X obj 115 456 t b a; -#X obj 168 455 t b a; -#X obj 104 124 vradio 15 1 0 3 empty empty empty 0 -8 0 10 -262144 --1 -1 0; -#X text 120 120 1.bg; -#X text 120 137 2.front; -#X text 120 153 3.label; -#X obj 103 105 nbx 3 14 0 255 0 0 \$0-dummy \$0-r empty 0 -8 0 10 -262144 --258113 -1 0 256 0; -#X obj 133 105 nbx 3 14 0 255 0 0 \$0-dummy \$0-g empty 0 -8 0 10 -262144 --13381 -1 0 256 0; -#X obj 163 105 nbx 3 14 0 255 0 0 \$0-dummy \$0-b empty 0 -8 0 10 -262144 --4160 -1 0 256 0; -#X connect 1 0 2 0; -#X connect 1 1 2 1; -#X connect 2 0 3 0; -#X connect 3 0 4 0; -#X connect 3 1 4 1; -#X connect 4 0 8 0; -#X connect 5 0 4 0; -#X connect 6 0 2 0; -#X connect 7 0 1 0; -#X connect 8 0 9 0; -#X connect 9 0 10 0; -#X connect 10 0 11 0; -#X connect 10 1 12 0; -#X connect 10 2 13 0; -#X connect 11 0 0 0; -#X connect 12 0 11 0; -#X connect 12 1 11 1; -#X connect 13 0 11 0; -#X connect 13 1 11 2; -#X connect 14 0 9 1; -#X connect 18 0 5 0; -#X connect 19 0 6 0; -#X connect 20 0 7 0; -#X coords 0 -1 1 1 102 74 2 100 100; -#X restore 108 469 pd flash-time; -#X text 60 471 1.bg; -#X text 60 491 2.front; -#X text 60 512 3.label; -#X text 317 448 delta; -#X text 217 448 position; -#X msg 218 540 pos \$1 \$2; -#X msg 318 540 delta \$1 \$2; -#X obj 318 517 list; -#X obj 318 470 bng 20 250 50 0 empty empty empty 17 7 0 10 -262144 --1 -1; -#X text 397 469 1.x-delta; -#X text 397 491 2.y-delta; -#N canvas 366 206 174 259 flash-time 0; -#X obj 68 180 pack; -#X obj 103 149 t b a; -#X obj 68 205 outlet; -#X obj 103 104 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-xpos empty 0 --8 0 12 -262144 -1 -1 300 256 0; -#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-ypos empty 0 --8 0 12 -262144 -1 -1 350 256 0; -#X connect 0 0 2 0; -#X connect 1 0 0 0; -#X connect 1 1 0 1; -#X connect 3 0 0 0; -#X connect 4 0 1 0; -#X coords 0 -1 1 1 48 42 2 100 100; -#X restore 218 470 pd flash-time; -#N canvas 366 206 174 259 flash-time 0; -#X obj 68 180 pack; -#X obj 103 149 t b a; -#X obj 68 205 outlet; -#X obj 103 104 nbx 3 14 -20 20 0 0 \$0-dummy \$0-xdelta empty 0 -8 -0 12 -262144 -1 -1 0 256 0; -#X obj 103 124 nbx 3 14 -20 20 0 0 \$0-dummy \$0-ydelta empty 0 -8 -0 12 -262144 -1 -1 0 256 0; -#X connect 0 0 2 0; -#X connect 1 0 0 0; -#X connect 1 1 0 1; -#X connect 3 0 0 0; -#X connect 4 0 1 0; -#X coords 0 -1 1 1 48 42 2 100 100; -#X restore 347 470 pd flash-time; -#X floatatom 329 384 5 0 0 0 - - -, f 5; -#X obj 11 579 s hsl_rcv; -#X obj 318 565 s hsl_rcv; -#X obj 218 565 s hsl_rcv; -#X text 10 35 dimensions; -#X text 7 1 [hslider] Set Properties through Messages; -#X text 266 469 1.x-pos; -#X text 266 491 2.y-pos; -#X obj 289 356 hsl 128 15 0 127 0 0 hsl-snd hsl-rcv mySlider -2 -8 -0 10 -262144 -1 -1 0 1; -#X connect 1 0 7 0; -#X connect 5 0 27 0; -#X connect 6 0 20 0; -#X connect 7 0 21 0; -#X connect 8 0 19 0; -#X connect 9 0 19 0; -#X connect 17 0 23 0; -#X connect 18 0 27 0; -#X connect 24 0 16 0; -#X connect 25 0 22 0; -#X connect 26 0 22 0; -#X connect 29 0 20 0; -#X connect 30 0 33 0; -#X connect 38 0 34 0; -#X connect 40 0 48 0; -#X connect 44 0 47 0; -#X connect 51 0 30 0; -#X connect 52 0 38 0; -#X connect 53 0 44 0; -#X connect 54 0 40 0; -#X connect 57 0 74 0; -#X connect 58 0 57 0; -#X connect 59 0 57 0; -#X connect 65 0 76 0; -#X connect 66 0 75 0; -#X connect 67 0 66 0; -#X connect 68 0 67 0; -#X connect 71 0 65 0; -#X connect 72 0 67 1; -#X connect 81 0 73 0; -#X restore 101 388 pd Setting_slider_properties_through_messages; -#X text 11 21 horizontal gui-slider; -#X text 98 466 18; -#X text 168 466 - creating an [hslider] object without arguments sets -default values for its gui-properties. See the subpatch below to learn -how to dynamically instantiate a [bng] object with custom properties: -; -#X text 215 551 (c) musil@iem.kug.ac.at; -#X text 257 564 IEM KUG; -#X text 232 576 graz \, austria 2002; -#X text 168 299 - a float updates the slider value and is sent to the -outlet.; -#X text 168 340 - a list is truncated to the first element.; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X text 98 323 bang; -#X text 168 323 - output the current slider value.; -#X text 436 8 [hslider] or [hsl]; -#X connect 18 0 21 0; -#X connect 19 0 23 0; -#X connect 20 0 23 0; -#X connect 22 0 23 0; -#X connect 23 0 18 0; -#X connect 23 0 28 0; -#X connect 24 0 19 0; -#X connect 26 0 37 0; -#X connect 28 0 27 0; -#X connect 29 0 32 0; -#X connect 29 0 30 0; -#X connect 30 0 31 0; -#X connect 33 0 34 0; -#X connect 34 0 29 0; -#X connect 36 0 25 0; -#X connect 37 0 35 0; diff --git a/doc/pddp/int-help.pd b/doc/pddp/int-help.pd deleted file mode 100644 index 5478e5d4e..000000000 --- a/doc/pddp/int-help.pd +++ /dev/null @@ -1,137 +0,0 @@ -#N canvas 425 35 555 619 10; -#X obj 0 595 cnv 15 550 21 empty empty empty 20 12 0 14 -228856 -66577 -0; -#X obj 0 0 cnv 15 550 40 empty empty int 3 12 0 18 -204280 -1 0; -#X obj 0 234 cnv 3 550 3 empty empty inlets 8 12 0 13 -228856 -1 0 -; -#N canvas 492 233 482 395 META 0; -#X text 12 145 LIBRARY internal; -#X text 12 185 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 45 LICENSE SIBSD; -#X text 12 165 AUTHOR Miller Puckette; -#X text 12 225 HELP_PATCH_AUTHORS This help patch was updated for Pd -version 0.35 test 24 by Dave Sabine as part of a project called pddp -proposed by Krzysztof Czaja to build comprehensive documentation for -Pd. Jonathan Wilkes revised the patch to conform to the PDDP template -for Pd version 0.42.; -#X text 12 25 KEYWORDS control storage; -#X text 12 65 DESCRIPTION store an integer; -#X text 12 5 ALIAS i; -#X text 12 85 INLET_0 bang float; -#X text 12 105 INLET_1 float; -#X text 12 125 OUTLET_0 float; -#X text 12 205 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 375 cnv 3 550 3 empty empty outlets 8 12 0 13 -228856 -1 0 -; -#X obj 0 412 cnv 3 550 3 empty empty arguments 8 12 0 13 -228856 -1 -0; -#X obj 0 475 cnv 3 550 3 empty empty more_info 8 12 0 13 -228856 -1 -0; -#X obj 78 334 cnv 17 3 30 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X obj 78 243 cnv 17 3 82 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 495 12 or; -#X obj 100 524 pddp/pddplink http://crca.ucsd.edu/~msp/Pd_documentation/x2.htm#s3.1 --text Pd manual 2.3.1: anatomy of a message; -#N canvas 107 165 428 375 More_Info 0; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 19 36 Integers are "whole" numbers - numbers which do not contain -fractions. The following are examples of whole numbers:; -#X text 20 66 1; -#X text 20 81 -544; -#X text 20 110 10024; -#X text 19 95 420; -#X obj 1 161 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 -0 14 -204280 -1 0; -#X text 7 1 [int] What is an integer; -#X text 7 161 [int] Note; -#X text 21 231 -8 \,; -#X text 39 231 388 \,; -#X text 63 231 608; -#X text 22 248 and:; -#X text 33 267 388 \,; -#X text 57 267 608; -#X text 22 267 8 \,; -#X text 21 290 Hence \, the [int] object takes about as much CPU as -the [float] object \; but is useful when numbers need to be truncated -and/or when patches are being designed to be compatible with Pd and -MAX/MSP.; -#X text 21 206 All numbers in Pd are kept in 32-bit floating point -and can represent real numbers between:; -#X restore 102 545 pd More_Info; -#X text 101 508 all_about_data-types.pd; -#X text 98 242 bang; -#X text 98 262 float; -#X text 98 302 list; -#X text 98 334 float; -#N canvas 212 521 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 obj 64 36 value; -#X obj 111 36 list; -#X floatatom 152 37 5 0 0 0 - - -, f 5; -#X msg 195 36; -#X obj 22 36 float; -#X obj 22 66 symbol; -#X obj 71 66 random; -#X text 7 1 [int] Related Objects; -#X restore 101 597 pd Related_objects; -#X text 99 382 float; -#X obj 468 11 int; -#X obj 516 11 i; -#X msg 115 122 bang; -#X floatatom 105 205 0 0 0 0 - - -; -#X floatatom 105 100 0 0 0 0 - - -; -#X floatatom 144 153 0 0 0 0 - - -; -#X text 153 122 You can force the object to output the stored number. -; -#X text 150 100 You can set and output the value simoultaneously.; -#X text 172 153 You can store the number \, without outputting it. -; -#X text 100 52 Tip: Press and hold SHIFT while click-n-dragging these -number boxes to see how the [int] object truncates the number - drops -decimal places.; -#X obj 105 179 int 6.5; -#X text 100 479 Note: [int] does not 'rounded off' floats. It discards -everything to the right of the decimal point.; -#X obj 78 384 cnv 17 3 17 empty empty 0 5 9 0 16 -228856 -162280 0 -; -#N canvas 108 391 428 173 Building_a_counter 0; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 19 37 The [int] object can be used as a basis for building -simple counter mechanisms in Pd. In the example below \, the [int] -object's stored value is incremented by 1 with each "bang".; -#X msg 164 84 bang; -#X obj 164 113 int; -#X obj 192 113 + 1; -#X floatatom 164 139 5 0 0 0 - - -, f 5; -#X text 7 1 [int] Example: Building a Counter; -#X connect 2 0 3 0; -#X connect 3 0 4 0; -#X connect 3 0 5 0; -#X connect 4 0 3 1; -#X restore 102 567 pd Building_a_counter; -#X text 11 20 store an integer; -#X text 169 430 - initializes the object and stores the number until -the value is reset. The creation argument is optional. If no creation -argument is provided \, the object defaults to zero.; -#X text 169 382 - outputs the stored value as a float message.; -#X text 168 242 - output the currently stored integer.; -#X text 168 262 - [int] will convert an incoming float to an integer-- -all numerals to the right of the decimal place are truncated (dropped). -This value is then sent to the outlet.; -#X text 168 302 - a list is truncated to the first element \, which -is then output and stored.; -#X text 168 334 - a float received at the right inlet is converted -to an integer and stored for later use.; -#X text 81 430 1) float; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X connect 21 0 29 0; -#X connect 23 0 29 0; -#X connect 24 0 29 1; -#X connect 29 0 22 0; diff --git a/doc/pddp/key-help.pd b/doc/pddp/key-help.pd deleted file mode 100644 index 9e71c6d66..000000000 --- a/doc/pddp/key-help.pd +++ /dev/null @@ -1,142 +0,0 @@ -#N canvas 424 37 555 619 10; -#X obj 0 635 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 key 3 12 0 18 -204280 --1 0; -#X obj 0 257 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 487 278 494 344 META 0; -#X text 12 85 LIBRARY internal; -#X text 12 125 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 105 AUTHOR Miller Puckette; -#X text 12 165 HELP_PATCH_AUTHORS Dave Sabine \, July 11 \, 2003 Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 45 DESCRIPTION get input from the keyboard; -#X text 12 65 OUTLET_0 float; -#X text 12 5 KEYWORDS control user_input; -#X text 12 145 RELEASE_DATE 1997; -#X restore 500 637 pd META; -#X obj 0 285 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 445 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 513 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 222 479 428 145 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 obj 21 42 keyup; -#X obj 61 42 keyname; -#X text 19 72 Externals and other object libraries; -#X text 7 1 [key] Related Objects; -#X obj 18 94 pddp/helplink Gem/gemkeyboard; -#X obj 18 114 pddp/helplink Gem/gemkeyname; -#X restore 102 638 pd Related_objects; -#X text 98 293 float; -#X obj 78 294 cnv 17 3 140 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 517 9 key; -#X text 98 261 (none); -#X text 98 411 Also note that key combinations \, such as SHIFT+7 produce -a different result than SHIFT or 7 alone.; -#X text 168 346 Some keys \, such as SHIFT or the F1-F12 series all -produce a zero \, but we can see by the [bng] that the event is not -ignored completely...but the numeric "ID" of the key is not captured -successfully. (This may produce different results on different systems.) -; -#X text 168 293 - the number received at the outlet represents the -numeric "ID" of a key on the computer's keyboard. This event occurs -when the key is pressed down. Only one event is captured at a time. -; -#X obj 46 113 key; -#X obj 26 150 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X floatatom 46 150 5 0 0 0 - - -, f 5; -#X text 75 113 Type something on the keyboard to send input to Pd; -#X text 23 64 [key] reports the (system dependent) numbers of "printing" -keys of the keyboard.; -#X text 99 517 Caveat - this only works if Pd actually gets the key -events which can depend on the stacking order of windows and/or the -pointer location. This is dependent on the system.; -#N canvas 105 161 428 356 reacting_to_user_input 0; -#X text 19 37 Most \, if not all \, programming environments provide -us with tools to capture 'user initiated' events from the operating -system. Keyboard input \, mouse clicks \, and mouse movements are the -most common events in this 'user event' category.; -#X text 19 103 Pd's [key] \, [keyup] \, and [keyname] are complimented -by the externals such as [gemmouse] and [nimouse] to provide us with -a full range of tools to gleen a user's activities at the computer. -; -#X text 33 240 onKeyUp; -#X text 33 221 onKeyDown; -#X text 33 259 onKeyPress; -#X text 20 290 hmmm...wouldn't it be great if Pd also gave us onChange -\, onBlur \, onFocus \, onClick \, onDblClick \, onDragDrop \, onLoad -\, onMouseDown \, onMouseOver \, onMouseOut \, onMouseMove \, onUnload...? -; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 1 [key] Reacing to User Input; -#X text 20 169 It's interesting to note that with these tools \, PD -can mimic some of the functions in other languages - Javascript for -example has:; -#X restore 102 564 pd reacting_to_user_input; -#N canvas 105 31 345 511 some_keyboard_fun 0; -#X obj 52 75 loadbang; -#X msg 23 16 bang; -#X obj 33 158 qlist; -#X floatatom 33 185 5 0 0 0 - - -, f 5; -#X obj 228 30 r keyboard_fun; -#X msg 52 105 read keyboard_fun.txt; -#X msg 45 51 rewind; -#X obj 228 112 symbol add2; -#X obj 228 83 t b s; -#X obj 228 138 pack s s; -#X obj 228 164 route list; -#X msg 47 245 set; -#X msg 47 278; -#X obj 228 57 symbol; -#X text 71 17 Click here to start...; -#X msg 62 131 tempo 0.8; -#X obj 47 217 loadbang; -#X connect 0 0 5 0; -#X connect 0 0 15 0; -#X connect 1 0 2 0; -#X connect 2 0 3 0; -#X connect 4 0 13 0; -#X connect 5 0 2 0; -#X connect 6 0 2 0; -#X connect 7 0 9 0; -#X connect 8 0 7 0; -#X connect 8 1 9 1; -#X connect 9 0 10 0; -#X connect 10 0 12 0; -#X connect 11 0 12 0; -#X connect 13 0 8 0; -#X connect 15 0 2 0; -#X connect 16 0 11 0; -#X restore 102 588 pd some_keyboard_fun; -#X obj 245 611 pddp/pddplink all_about_hid.pd -text all_about_hid; -#X text 100 612 for more on HIDs:; -#X text 11 23 get input from the keyboard; -#X text 168 261 - [key] gets input directly from the keyboard.; -#X obj 4 637 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 153 190 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X floatatom 173 190 5 0 0 0 - - -, f 5; -#X obj 173 153 key 1; -#X text 210 153 Legacy version which also includesautorepeat can be -invoked by passingan optional argument 1 at creation.Notice how -this version reports multiplepresses when holding a key down.; -#X text 98 449 1) float; -#X text 168 449 - optional argument to enable legacy autorepeat detection. -0 or no argument will disable autorepeat reporting \, 1 will enable -legacy behavior and repeat press-and-hold as multiple pressess in succession. -; -#X connect 15 0 16 0; -#X connect 15 0 17 0; -#X connect 30 0 28 0; -#X connect 30 0 29 0; diff --git a/doc/pddp/line-help.pd b/doc/pddp/line-help.pd deleted file mode 100644 index c3e03d128..000000000 --- a/doc/pddp/line-help.pd +++ /dev/null @@ -1,252 +0,0 @@ -#N canvas 515 143 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 line 3 12 0 18 -204280 --1 0; -#X obj 0 267 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 565 371 494 364 META 0; -#X text 12 125 LIBRARY internal; -#X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 145 AUTHOR Miller Puckette; -#X text 12 205 HELP_PATCH_AUTHORS This help patch was updated for Pd -version 0.35 test 28 by Dave Sabine as part of a project called pddp -proposed by Krzysztof Czaja to build comprehensive documentation for -Pd. Jonathan Wilkes revised the patch to conform to the PDDP template -for Pd version 0.42.; -#X text 12 45 DESCRIPTION ramp generator; -#X text 12 65 INLET_0 float list stop; -#X text 12 85 INLET_1 float; -#X text 12 105 OUTLET_0 float; -#X text 12 185 RELEASE_DATE 1997; -#X text 12 5 KEYWORDS control time; -#X restore 500 598 pd META; -#X obj 0 375 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 439 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 498 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 297 500 428 230 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 obj 22 43 line~; -#X obj 62 43 vline~; -#X text 8 2 [line] Related Objects; -#X text 19 102 Externals; -#X obj 19 142 pddp/helplink markex/tripleLine; -#X obj 19 162 pddp/helplink iemlib/t3_line~; -#X obj 19 182 pddp/helplink iemlib/fade~; -#X obj 19 122 pddp/helplink maxlib/step; -#X restore 101 598 pd Related_objects; -#X obj 78 276 cnv 17 3 63 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 275 float; -#X text 98 301 list; -#X text 98 383 float; -#X obj 78 384 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 347 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 98 346 float; -#X obj 509 10 line; -#X obj 137 180 line; -#X msg 137 87 1000 1000; -#X floatatom 137 201 5 0 0 0 - - -, f 5; -#X text 203 86 ramp up.; -#X msg 146 110 0 1000; -#X text 193 110 ramp down.; -#X msg 158 154 stop; -#X msg 154 133 42; -#X text 180 134 jumps to this value immediately.; -#X text 195 154 stops the current ramp.; -#N canvas 106 115 428 446 continuous_ramps 0; -#X text 19 98 In other words \, if [line] receives a message specifying -some new target and time before reaching the previous target \, it -takes off from its current value.; -#X obj 26 247 hsl 128 15 0 127 0 0 empty empty empty -2 -6 0 8 -262144 --1 -1 0 1; -#X msg 56 205 stop; -#X msg 49 185 42; -#X obj 23 226 line; -#X msg 23 144 127 5000; -#X msg 41 165 0 5000; -#X text 16 271 Due to this unique behavior \, a common construct found -in Pd patches includes the [pack] object as follows:; -#X obj 30 392 line; -#X floatatom 30 413 10 0 0 0 - - -, f 10; -#X floatatom 30 306 5 0 0 0 - - -, f 5; -#X obj 30 372 pack f 500; -#X msg 41 325 50; -#X msg 49 346 2000; -#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 [line] Continuous Ramps; -#X text 21 37 [line] does not schedule its incoming messages. What -this means is that if you send [line] a new target value mid-way through -a ramp \, a new ramp is immediately created to the new target value -starting from the "current" value.; -#X connect 2 0 4 0; -#X connect 3 0 4 0; -#X connect 4 0 1 0; -#X connect 5 0 4 0; -#X connect 6 0 4 0; -#X connect 8 0 9 0; -#X connect 10 0 11 0; -#X connect 11 0 8 0; -#X connect 12 0 11 0; -#X connect 13 0 11 0; -#X restore 101 551 pd continuous_ramps; -#N canvas 107 25 428 516 grain_rate_and_creation_arguments 0; -#X text 21 39 The "grain rate" of [line] is the rate at which it will -output its values. The faster the grain is \, the smoother the ramp -will appear. While slower grain rates will produce a more disjunct -ramp. Of course this setting will alter the amount of CPU that the -[line] object will require. Higher rates require more computation. -; -#X text 22 145 This means simply that [line] will output a new value -between its current value and your new value once every 20 milliseconds. -; -#X text 22 126 The default grain rate is 20 milliseconds.; -#X text 19 193 [line]'s optional creation arguments can be used to -reset the grain rate. However \, the grain rate cannot be reset dynamically. -; -#X text 21 248 First creation argument is the initial value: the starting -point of the first ramp.; -#X text 20 287 The second creation argument sets the grain rate. Observe -the following two examples to see how the grain rate effects the output. -; -#X obj 33 403 line 0 5; -#X obj 36 436 hsl 128 15 0 127 0 0 empty empty empty -2 -6 0 8 -262144 --1 -1 0 1; -#X msg 136 332 127; -#X msg 168 340 0; -#X obj 135 368 pack f 5000; -#X obj 203 436 hsl 128 15 0 127 0 0 empty empty empty -2 -6 0 8 -262144 --1 -1 0 1; -#X obj 200 403 line 0 500; -#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 [line] Grain Rate; -#X text 31 469 You can check the default grain rate in the subpatch -below:; -#N canvas 398 136 429 326 default_grain_rate 0; -#X obj 22 87 line; -#X obj 22 226 timer; -#X obj 22 111 t b b; -#X obj 49 137 spigot; -#X obj 101 169 0; -#X obj 22 193 spigot; -#X obj 22 64 t a b; -#X obj 65 87 1; -#X obj 71 226 1; -#X obj 22 251 print Pd's_default_grain_rate; -#X msg 22 42 0 200; -#X text 19 274 Here we assume the grain rate is less than 200 ms. For -a more comprehensive test we could start with a time value of 1 ms -and step up until the output ceases to increase.; -#X obj 0 0 cnv 15 552 40 empty \$0-pddp.cnv.header empty 3 12 0 14 --204280 -1 0; -#X text 7 1 [line] Pd's Default Grain Rate; -#X text 60 42 Click here to output pd's default grain rate to the console -; -#X connect 0 0 2 0; -#X connect 1 0 9 0; -#X connect 2 0 5 0; -#X connect 2 1 3 0; -#X connect 3 0 4 0; -#X connect 3 0 1 1; -#X connect 4 0 3 1; -#X connect 4 0 5 1; -#X connect 5 0 1 0; -#X connect 5 0 8 0; -#X connect 6 0 0 0; -#X connect 6 1 7 0; -#X connect 7 0 5 1; -#X connect 8 0 3 1; -#X connect 10 0 6 0; -#X restore 34 491 pd default_grain_rate; -#X connect 6 0 7 0; -#X connect 8 0 10 0; -#X connect 9 0 10 0; -#X connect 10 0 6 0; -#X connect 10 0 12 0; -#X connect 12 0 11 0; -#X restore 101 529 pd grain_rate_and_creation_arguments; -#X text 11 23 ramp generator; -#X text 98 325 stop; -#X text 168 325 - stop the current ramp.; -#X text 167 346 - time to reach the target value (in milliseconds). -; -#X text 168 275 - target value. This value is stored and used as the -starting value for the next ramp.; -#X text 168 301 - a (target \, time) pair is distributed between the -two inlets.; -#X text 168 474 - grain rate in milliseconds (default: 20 ms).; -#X text 168 383 - [line] outputs a linear ramp \, reaching the target -value within the time value specified by the right inlet and at a grain -rate specified by the second creation argument (default 20 ms).; -#N canvas 106 32 428 493 tips_on_using_line 0; -#X text 20 39 [line]'s left inlet defines the "target" value. The right -inlet defines the "time" value. The "target \, time" pair of numbers -inform [line] to produce a numeric "ramp" from its current value (whatever -that might be at any given moment) to the new value within the alloted -time which is defined at the right inlet.; -#X obj 25 242 line; -#X msg 59 218 1000; -#X msg 25 218 1000; -#X obj 25 175 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 25 195 t b b; -#X floatatom 25 264 5 0 0 0 - - -, f 5; -#X obj 150 260 line; -#X msg 150 236 1000; -#X obj 150 216 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X floatatom 150 282 5 0 0 0 - - -, f 5; -#X text 20 309 If [line] receives a new target value without an accompanying -"time" \, it simply jumps to the new value...as in the example above -on the right. In the example above on the left \, you'll see that [line] -will create a numeric ramp from 0 to 1000 over 1000 milliseconds. You -should also note that if you click that [bng] again a second time \, -nothing happens. This is because [line] is already at 1000 \, so sending -it new instructions to ramp to 1000 is meaningless and has no effect. -; -#X text 20 425 Having said all of that \, let's just reiterate that -it's important to send a "time" value to [line] before sending it a -new "target" value...unless of course you WANT it to jump immediately -to the new target.; -#X text 149 182 While this does NOT work unless; -#X text 149 196 you click "500" first.; -#X msg 184 236 500; -#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 [line] Tips; -#X text 20 118 It is important to realize that [line] stores only the -current value...it does not remember the defined "time" (duration of -the ramp). Hence \, the example to the left works:; -#X connect 1 0 6 0; -#X connect 2 0 1 1; -#X connect 3 0 1 0; -#X connect 4 0 5 0; -#X connect 5 0 3 0; -#X connect 5 1 2 0; -#X connect 7 0 10 0; -#X connect 8 0 7 0; -#X connect 9 0 8 0; -#X connect 15 0 7 1; -#X restore 101 507 pd tips_on_using_line; -#X text 80 459 1) float; -#X text 80 474 2) float; -#X text 168 459 - initial value \, i.e. \, the starting point of the -first ramp.; -#X obj 3 598 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 98 571 pddp/pddplink ../3.audio.examples/C03.zipper.noise.pd --text doc/3.audio.examples/C03.zipper.noise.pd; -#X connect 16 0 18 0; -#X connect 17 0 16 0; -#X connect 20 0 16 0; -#X connect 22 0 16 0; -#X connect 23 0 16 0; diff --git a/doc/pddp/line~-help.pd b/doc/pddp/line~-help.pd deleted file mode 100644 index 57f528462..000000000 --- a/doc/pddp/line~-help.pd +++ /dev/null @@ -1,105 +0,0 @@ -#N canvas 426 36 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 line~ 3 12 0 18 --204280 -1 0; -#X obj 0 271 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 481 284 494 344 META 0; -#X text 12 125 LIBRARY internal; -#X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 145 AUTHOR Miller Puckette; -#X text 12 205 HELP_PATCH_AUTHORS Updated for version 0.33. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 5 KEYWORDS signal time conversion; -#X text 12 45 DESCRIPTION audio ramp generator; -#X text 12 85 INLET_1 list; -#X text 12 105 OUTLET_0 signal; -#X text 12 65 INLET_0 float list stop; -#X text 12 185 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 452 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 489 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 516 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#X text 98 493 (none); -#N canvas 213 398 428 230 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 obj 22 43 vline~; -#X obj 82 43 line; -#X text 8 2 [line~] Related Objects; -#X text 20 100 Externals; -#X obj 20 180 pddp/helplink markex/tripleLine; -#X obj 20 120 pddp/helplink iemlib/t3_line~; -#X obj 20 140 pddp/helplink iemlib/fade~; -#X obj 20 160 pddp/helplink maxlib/step; -#X restore 101 597 pd Related_objects; -#X obj 78 280 cnv 17 3 90 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 279 float; -#X text 98 305 list; -#X obj 78 461 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 381 cnv 17 3 65 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 98 380 float; -#X obj 509 9 line~; -#X obj 66 210 snapshot~; -#X obj 66 164 line~; -#X floatatom 66 233 0 0 0 0 - - -; -#X obj 108 187 metro 100; -#X msg 66 66 1 1000; -#X text 121 65 a pair of numbers starts a ramp; -#X msg 126 113 2; -#X text 158 113 a single number jumps to value; -#X msg 124 138 stop; -#X text 167 137 "stop" message freezes line~ at its current value; -#X msg 93 113 0; -#X msg 76 88 0 5000; -#X obj 108 164 loadbang; -#X text 98 359 stop; -#X text 98 460 signal; -#X text 167 380 - stores a duration in milliseconds until the next -target value is sent to the left inlet. Unlike most other objects in -Pd \, the value is only stored until it is used with this target value -to start the ramp-- after that point the right inlet is reset (to zero). -; -#X text 11 23 audio ramp generator; -#X text 168 305 - [line~] takes a two-element list to start a new ramp. -The first element specifies the target value \, and the second one -sets the duration in milliseconds. (Lists with more than two elements -will be truncated.); -#X text 168 279 - a float to the left inlet of [line~] will cause the -output to jump immediately to the target value.; -#X text 168 359 - the stop message freezes [line~] at its current value. -; -#X text 168 460 - the outgoing signal is the linear ramp.; -#X text 179 191 The [line~] object generates linear ramps whose levels -and timing are determined by messages you send it. The messages may -be a single target value (causing the output to jump to the target) -or a target and a time in milliseconds (to start a new ramp).; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 486 51 pddp/dsp; -#X obj 98 547 pddp/pddplink ../3.audio.examples/A03.line.pd/ -text -doc/3.audio.examples/A03.line.pd; -#X obj 98 562 pddp/pddplink ../3.audio.examples/A04.line2.pd/ -text -doc/3.audio.examples/A04.line2.pd; -#X text 98 521 More information about [line] can be found in the Pure -Documentation folder doc/3.audio.examples:; -#X obj 98 577 pddp/pddplink ../3.audio.examples/C05.sampler.oneshot.pd --text doc/3.audio.examples/C05.sampler.oneshot.pd; -#X connect 16 0 18 0; -#X connect 17 0 16 0; -#X connect 19 0 16 0; -#X connect 20 0 17 0; -#X connect 22 0 17 0; -#X connect 24 0 17 0; -#X connect 26 0 17 0; -#X connect 27 0 17 0; -#X connect 28 0 19 0; diff --git a/doc/pddp/list-help.pd b/doc/pddp/list-help.pd deleted file mode 100644 index 160df0eb1..000000000 --- a/doc/pddp/list-help.pd +++ /dev/null @@ -1,676 +0,0 @@ -#N canvas 398 77 555 619 10; -#X obj 0 635 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 list 3 12 0 18 -204280 --1 0; -#X obj 0 144 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 450 328 494 344 META 0; -#X text 12 90 LIBRARY internal; -#X text 12 130 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 50 LICENSE SIBSD; -#X text 12 110 AUTHOR Miller Puckette; -#X text 12 170 HELP_PATCH_AUTHORS Updated for Pd version 0.40. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 70 DESCRIPTION building and using variable-length messages -; -#X text 12 5 NAME list append list prepend list trim list split list -length; -#X text 12 30 KEYWORDS control storage needs_work list_op symbol_op -; -#X text 12 150 RELEASE_DATE 2005; -#X restore 500 638 pd META; -#X obj 0 237 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 288 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 546 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 179 562 428 109 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 7 1 [list] Related Objects; -#X obj 21 42 float; -#X obj 61 42 symbol; -#X obj 112 42 pack; -#X obj 152 42 unpack; -#X restore 102 639 pd Related_objects; -#X obj 78 246 cnv 17 3 17 empty \$0-pddp.cnv.let.n n 5 9 0 16 -228856 --162280 0; -#X obj 78 153 cnv 17 3 17 empty \$0-pddp.cnv.let.n n 5 9 0 16 -228856 --162280 0; -#X obj 510 11 list; -#N canvas 1 112 555 502 append 0; -#X obj 0 0 cnv 15 552 40 empty \$0-pddp.cnv.header empty 3 12 0 14 --204280 -1 0; -#X obj 13 3 list append; -#X text 18 24 append (concatenate) the second list to the first; -#X obj 0 294 cnv 3 520 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#X obj 0 377 cnv 3 520 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 78 386 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 303 cnv 17 3 40 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 353 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 98 304 anything; -#X text 98 354 anything; -#X obj 0 421 cnv 3 520 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X text 80 456 n); -#X text 98 471 float; -#X text 80 440 1); -#X text 170 440 - the symbol "append".; -#X text 170 456 - an arbitrary number of additional floats or symbols -may be specified to initialize the list stored at the right inlet. -; -#X obj 158 219 list append 1 2; -#X floatatom 168 165 5 0 0 0 - - -, f 5; -#X msg 158 140 1 2 3; -#X msg 178 190 bang; -#X msg 285 189 bang; -#X obj 158 241 print append; -#X msg 285 163 4 5 6 and 7; -#X msg 285 80 4 5 6; -#X msg 285 139 four 5 6; -#X msg 285 110 list four 5 6; -#X text 178 354 - all input is converted to a list and stored.; -#X text 178 304 - all input is converted to a list. The list stored -at the right inlet is appended to it \, and the resulting list is sent -to the outlet.; -#X text 98 387 list; -#X text 168 387 - the output is always a message with the selector -"list" (see subpatch "list_conversion" for more info).; -#X text 98 440 symbol atom; -#X text 98 456 symbol atom; -#X connect 16 0 21 0; -#X connect 17 0 16 0; -#X connect 18 0 16 0; -#X connect 19 0 16 0; -#X connect 20 0 16 1; -#X connect 22 0 16 1; -#X connect 23 0 16 1; -#X connect 24 0 16 1; -#X connect 25 0 16 1; -#X restore 102 365 pd append; -#N canvas 89 83 428 592 about-lists 0; -#X obj 22 567 print message; -#X msg 22 380 list x.wav 44100; -#X msg 22 538 read \$1 \$2; -#X msg 22 409 set x.wav 44100; -#X msg 39 509 set \, add2 read \, adddollar 1 \, adddollar 2; -#X msg 22 439 x.wav 44100; -#X obj 39 483 loadbang; -#X text 127 486 reset message as it was; -#X text 139 380 good; -#X text 128 411 bad; -#X text 94 439 ugly; -#X msg 223 403 list 44100 x.wav; -#X msg 236 428 44100 x.wav; -#X obj 223 454 print number-first; -#X text 217 375 these two are equivalent:; -#X text 19 266 In the example below \, the top message sets \$1 to -"x.wav" and \$2 to 44100 in the "read" message. The lower message box -outputs the message "read x.wav 44100". The "set" message changes the -content of the message box itself (click on the longer message box -below to repair the damage.) The "ugly" message \, since it is neither -"list" nor "set" \, gets interpreted in an arbitrary (and probably -inappropriate!) way.; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 1 [list] About lists in Pd; -#X text 19 37 Messages in Pd are somewhat artificially divided into -two classes. First are data-holding messages (bang \, float \, symbol -\, list) which are the primary way of communicating between objects. -Second is "everything else" (you could call them out-of-band messages -or metamessages) that describe changes in configuration \, read and -write files \, quit Pd \, etc. These are provided so that complex objects -don't need to have 100 separate inlets for every possible functionality. -It's not clear whether this was a good design choice \, but it's entrenched. -; -#X text 19 170 The distinction becomes visible \, and ugly \, when -the leading item in a data-holding message is a symbol. In this case -\, to disambiguate it from the other sort \, the printed form of the -message has a selector \, "list" or "symbol" prepended to it. Underneath -\, there is always a selector in front of data messages \, but it is -implied if the first data item is a number.; -#X connect 1 0 2 0; -#X connect 2 0 0 0; -#X connect 3 0 2 0; -#X connect 4 0 2 0; -#X connect 5 0 2 0; -#X connect 6 0 4 0; -#X connect 11 0 13 0; -#X connect 12 0 13 0; -#X restore 101 586 pd about-lists; -#X text 11 23 building and using variable-length messages; -#X text 80 307 1); -#X text 80 514 n); -#X text 180 365 append - append the second list to the first; -#X text 180 409 split - split a list in two; -#X text 180 387 prepend - prepend the second list to the first; -#X text 180 453 length - output the number of items in a list; -#X text 180 431 trim - trim the "list" selector off; -#X obj 212 98 list; -#X msg 233 68 rice; -#X msg 212 46 beans; -#X obj 212 120 print groceries; -#X msg 276 68 cornbread; -#X text 98 550 Here are some examples showing how to use these objects -to compose and/or use variable length messages:; -#N canvas 20 53 525 646 simple_sequencer 0; -#X obj 23 173 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 232 176 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X text 227 154 clear; -#X text 20 153 send; -#X msg 71 175 250; -#X msg 103 175 500; -#X msg 136 175 750; -#X msg 169 175 1000; -#X obj 23 258 list append; -#X obj 188 220 t l; -#X obj 71 214 list prepend; -#X obj 23 426 t l l; -#X obj 74 426 print start; -#X obj 129 257 print stored; -#X obj 23 451 list split 1; -#X obj 23 575 del; -#X obj 23 607 print bang; -#X obj 55 542 list append; -#X msg 35 403 0 250 250 500; -#X text 98 150 -- add --; -#X text 37 20 example 1: simple rhythmic sequencer; -#X text 29 53 The top part of this patch demonstrates building up a -message from a variable number of elements provided sequentially. The -"list prepend" object stores the list and \, each time a number arrives -\, prepends the previous list to it.; -#X text 216 237 "list prepend" to its own inlet.; -#X text 213 220 "trigger list" is needed only to connect outlet of -; -#X text 254 258 printout shows the growing message.; -#X text 47 279 "list append" stores the growing message which is output -by the "send" button above. "list prepend" would have been equivalent. -; -#X text 165 403 <-- test message; -#X text 39 354 The bottom part of the patch takes numbers off the beginning -of the list \, one by one \, to use as delays.; -#X text 190 426 printout shows the sequence as it starts.; -#X text 169 543 The rest of the list is stored for next time.; -#X obj 141 505 print done; -#X text 150 450 Split off the first item. If there is none \, nothing -comes out the first or second outlet \, but instead we get a "bang" -from the third one.; -#X text 64 575 After delay \, output a bang and recall the rest of -the list.; -#X connect 0 0 8 0; -#X connect 1 0 10 1; -#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 11 0; -#X connect 9 0 10 1; -#X connect 10 0 9 0; -#X connect 10 0 8 1; -#X connect 10 0 13 0; -#X connect 11 0 14 0; -#X connect 11 1 12 0; -#X connect 14 0 15 0; -#X connect 14 1 17 1; -#X connect 14 2 30 0; -#X connect 15 0 16 0; -#X connect 15 0 17 0; -#X connect 17 0 14 0; -#X connect 18 0 11 0; -#X restore 401 586 pd simple_sequencer; -#N canvas 127 68 397 569 another_sequencer 0; -#X obj 66 263 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 292 266 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X text 287 244 clear; -#X text 63 243 send; -#X obj 66 342 list append; -#X obj 213 317 t l; -#X obj 94 303 list prepend; -#X obj 66 410 t l l; -#X obj 121 410 print start; -#X obj 171 340 print stored; -#X obj 66 486 del; -#X obj 105 486 list append; -#X msg 94 264 250 57; -#X msg 154 264 500 52; -#X msg 215 264 750 55; -#X obj 66 461 unpack; -#X obj 66 435 list split 2; -#X text 80 38 example 2: sequencer with pitch; -#X text 147 242 -- add --; -#X obj 185 438 print done; -#X obj 115 517 print pitch; -#X text 13 69 This example is a slight modification of example 1 showing -how to build up lists with more than one item per iteration. We regard -pairs of numbers as specifying a delay time and a pitch. Unlike the -previous example \, the delay here is interpreted as teh delay until -the next event \, not the delay since the previous one. This is done -by taking the "pitch" output before the delay object (previously the -"output" was taken from the delay object's output.); -#X connect 0 0 4 0; -#X connect 1 0 6 1; -#X connect 4 0 7 0; -#X connect 5 0 6 1; -#X connect 6 0 5 0; -#X connect 6 0 4 1; -#X connect 6 0 9 0; -#X connect 7 0 16 0; -#X connect 7 1 8 0; -#X connect 10 0 11 0; -#X connect 11 0 16 0; -#X connect 12 0 6 0; -#X connect 13 0 6 0; -#X connect 14 0 6 0; -#X connect 15 0 10 0; -#X connect 15 1 20 0; -#X connect 16 0 15 0; -#X connect 16 1 11 1; -#X connect 16 2 19 0; -#X restore 401 608 pd another_sequencer; -#N canvas 48 176 447 426 serializer 0; -#X obj 19 287 list split 1; -#X obj 19 378 print; -#X obj 19 204 until; -#X obj 19 242 list append; -#X obj 45 171 t b l; -#X obj 149 287 bang; -#X msg 45 148 1 2 3 4 a b c; -#X text 34 21 example 3: serializing a message without delays; -#X text 17 55 The "until" object can be used as shown to iterate through -all the items of a list.; -#X text 178 147 <- click to test; -#X text 101 171 First store list \, then start the loop; -#X text 88 199 "until" bangs its output until told to stop by a "bang" -to its right inlet.; -#X text 107 241 Store the remaining list.; -#X text 184 286 third outlet of "split" tells us to stop.; -#X text 37 318 Second outlet of "split" becomes the new list for "list -append" above.; -#X text 75 377 First outlet is the output.; -#X connect 0 0 1 0; -#X connect 0 1 3 1; -#X connect 0 2 5 0; -#X connect 2 0 3 0; -#X connect 3 0 0 0; -#X connect 4 0 2 0; -#X connect 4 1 3 1; -#X connect 5 0 2 1; -#X connect 6 0 4 0; -#X restore 241 608 pd serializer; -#N canvas 101 244 428 350 lists_vs_non-lists 0; -#X obj 23 290 list append 1 2; -#X floatatom 23 120 5 0 0 0 - - -, f 5; -#X msg 23 95 1 2 3; -#X msg 23 68 list cis boom bah; -#X msg 23 145 bang; -#X msg 162 260 bang; -#X obj 23 319 print append; -#X msg 23 43 walk the dog; -#X msg 162 210 list x y z; -#X msg 161 184 go dog go; -#X msg 160 234 4 5 6 and 7; -#X text 119 43 non-list message converted to list; -#X text 144 68 list starting with symbol; -#X text 75 118 number is one-element list; -#X text 75 95 numeric list; -#X text 75 145 bang is zero-element list; -#X text 226 184 same for right inlet...; -#X text 235 233 (note: only the first item; -#X text 238 252 need be a number to make this; -#X text 238 270 a list.); -#X text 121 290 <- creation args initialize the list to append; -#X obj 2 2 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 8 2 [list] Lists vs. Non-lists; -#X connect 0 0 6 0; -#X connect 1 0 0 0; -#X connect 2 0 0 0; -#X connect 3 0 0 0; -#X connect 4 0 0 0; -#X connect 5 0 0 1; -#X connect 7 0 0 0; -#X connect 8 0 0 1; -#X connect 9 0 0 1; -#X connect 10 0 0 1; -#X restore 101 608 pd lists_vs_non-lists; -#N canvas 0 82 555 506 prepend 0; -#X obj 0 0 cnv 15 552 40 empty \$0-pddp.cnv.header empty 3 12 0 14 --204280 -1 0; -#X obj 0 299 cnv 3 520 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#X obj 0 377 cnv 3 520 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 78 386 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 308 cnv 17 3 40 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 354 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 98 309 anything; -#X text 98 355 anything; -#X obj 0 421 cnv 3 520 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X text 80 456 n); -#X text 98 471 float; -#X text 80 440 1); -#X text 170 456 - an arbitrary number of additional floats or symbols -may be specified to initialize the list stored at the right inlet. -; -#X floatatom 198 160 5 0 0 0 - - -, f 5; -#X msg 188 135 1 2 3; -#X msg 208 185 bang; -#X msg 315 184 bang; -#X msg 315 158 4 5 6 and 7; -#X msg 315 75 4 5 6; -#X msg 315 134 four 5 6; -#X msg 315 105 list four 5 6; -#X text 178 355 - all input is converted to a list and stored.; -#X text 18 24 prepend the second list to the first; -#X obj 13 3 list prepend; -#X obj 188 214 list prepend 1 2; -#X obj 188 236 print prepend; -#X text 178 309 - all input is converted to a list. The list stored -at the right inlet is prepended to it \, and the resulting list is -sent to the outlet.; -#X text 170 440 - the symbol "prepend".; -#X text 98 387 list; -#X text 168 387 - the output is always a message with the selector -"list" (see subpatch "list_conversion" for more info).; -#X text 98 440 symbol atom; -#X text 98 456 symbol atom; -#X connect 13 0 24 0; -#X connect 14 0 24 0; -#X connect 15 0 24 0; -#X connect 16 0 24 1; -#X connect 17 0 24 1; -#X connect 18 0 24 1; -#X connect 19 0 24 1; -#X connect 20 0 24 1; -#X connect 24 0 25 0; -#X restore 102 387 pd prepend; -#N canvas 1 82 555 530 split 0; -#X obj 0 0 cnv 15 552 40 empty \$0-pddp.cnv.header empty 3 12 0 14 --204280 -1 0; -#X obj 0 277 cnv 3 520 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#X obj 0 371 cnv 3 520 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 78 380 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 286 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 314 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 98 287 anything; -#X obj 0 458 cnv 3 520 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X text 80 477 1); -#X msg 200 145 bang; -#X obj 159 173 list split 2; -#X floatatom 262 148 3 0 5 0 - - -, f 3; -#X msg 159 57 1 2; -#X msg 124 57 1; -#X text 156 228 first n; -#X text 245 228 rest of list; -#X text 337 228 shorter than n; -#X text 18 24 cut a list into smaller ones; -#X obj 13 3 list split; -#X msg 173 79 one 2 3; -#X msg 183 101 list one 2 3; -#X msg 193 123 1 2 three; -#X obj 159 211 print split0; -#X obj 248 211 print split1; -#X obj 340 211 print split2; -#X text 178 287 - all input is converted to a list.; -#X text 98 315 float; -#X text 98 381 list; -#X obj 78 403 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 98 404 list; -#X obj 78 425 cnv 17 3 17 empty \$0-pddp.cnv.let.2 2 5 9 0 16 -228856 --162280 0; -#X text 98 426 list; -#X text 178 315 - split point. A value of n will send the first n elements -to the left outlet \, and the rest of the list to the middle outlet. -Incoming lists shorter than n are sent to the rightmost outlet.; -#X text 168 381 - the first n elements of the incoming list.; -#X text 168 404 - the remaining elements of the incoming list.; -#X text 168 426 - if the incoming list has fewer than n elements \, -it is sent in its entirety to the rightmost outlet.; -#X text 170 477 - the symbol "split".; -#X text 98 493 float; -#X text 80 493 2); -#X text 98 477 symbol atom; -#X text 170 493 - (optional) an integer to initialize the split point. -; -#X connect 9 0 10 0; -#X connect 10 0 22 0; -#X connect 10 1 23 0; -#X connect 10 2 24 0; -#X connect 11 0 10 1; -#X connect 12 0 10 0; -#X connect 13 0 10 0; -#X connect 19 0 10 0; -#X connect 20 0 10 0; -#X connect 21 0 10 0; -#X restore 102 409 pd split; -#N canvas 1 82 555 481 trim 0; -#X obj 0 0 cnv 15 552 40 empty \$0-pddp.cnv.header empty 3 12 0 14 --204280 -1 0; -#X obj 0 330 cnv 3 520 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#X obj 0 385 cnv 3 520 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 78 394 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 339 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 340 anything; -#X obj 0 429 cnv 3 520 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X text 80 448 1); -#X msg 49 139 1 2 3; -#X msg 49 90 list cis boom bah; -#X msg 49 195 bang; -#X msg 49 63 walk the dog; -#X obj 49 276 list trim; -#X obj 49 298 print trim; -#X msg 49 222 1 x y; -#X msg 49 248 x 1 y; -#X msg 49 113 55; -#X text 98 395 anything; -#X text 170 448 - the symbol "trim".; -#X obj 13 3 list trim; -#X text 18 24 remove the list selector; -#X text 128 230 The [list trim] object inputs lists (or makes lists -out of incoming non-list messages) and outputs a message whose selector -is the first item of the list \, and whose arguments \, if any \, are -the remainder of the list. If the list has no items \, or if its first -item is numeric \, the selector is "list" (which might print out as -list \, float \, or bang.); -#X text 98 448 symbol atom; -#X text 178 340 - all input is converted to a list. A bang message -is converted to an empty list. A symbol message like "symbol blah" -is converted to "list blah".; -#X text 134 63 non-list messages remain non-list messages; -#X text 97 139 implicit list remains a list; -#X msg 49 167 symbol x; -#X text 86 195 becomes message "list" (interpreted by most objects -as bang); -#X text 166 90 "list" selector gets trimmed off; -#X text 79 113 becomes "list 55" (interpreted by most objects as float) -; -#X text 112 167 "symbol" selector gets trimmed off.; -#X text 168 395 - after the incoming message is converted to a list -\, the "list" selector is removed and the message is output.; -#X connect 8 0 12 0; -#X connect 9 0 12 0; -#X connect 10 0 12 0; -#X connect 11 0 12 0; -#X connect 12 0 13 0; -#X connect 14 0 12 0; -#X connect 15 0 12 0; -#X connect 16 0 12 0; -#X connect 26 0 12 0; -#X restore 102 431 pd trim; -#N canvas 2 128 555 490 length 0; -#X obj 0 0 cnv 15 552 40 empty \$0-pddp.cnv.header empty 3 12 0 14 --204280 -1 0; -#X obj 0 374 cnv 3 520 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#X obj 0 411 cnv 3 520 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 78 420 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 383 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 384 anything; -#X obj 0 448 cnv 3 520 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X text 80 467 1); -#X obj 13 3 list length; -#X msg 226 161 1 2 3; -#X msg 226 112 list cis boom bah; -#X msg 227 187 bang; -#X msg 226 85 walk the dog; -#X msg 227 209 1 x y; -#X msg 226 235 x 1 y; -#X msg 226 135 55; -#X obj 201 263 list length; -#X floatatom 201 289 5 0 0 0 - - -, f 5; -#X text 18 24 number of elements in a list; -#X text 98 421 float; -#X text 170 467 - the symbol "length".; -#X text 98 467 symbol atom; -#X text 168 384 - any message type is accepted and converted to a list. -; -#X text 168 421 - [list length] outputs the number of elements in the -list.; -#X connect 9 0 16 0; -#X connect 10 0 16 0; -#X connect 11 0 16 0; -#X connect 12 0 16 0; -#X connect 13 0 16 0; -#X connect 14 0 16 0; -#X connect 15 0 16 0; -#X connect 16 0 17 0; -#X restore 102 453 pd length; -#X text 98 307 symbol atom; -#X text 98 322 float; -#N canvas 51 146 428 419 list_conversion_in_Pd 0; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 1 [list] Conversion; -#X text 19 168 In brief:; -#X text 19 188 "list" -> bang; -#X text 19 208 "list 1" -> "float 1"; -#X text 19 228 "list hello" -> "symbol hello"; -#X text 19 37 Most objects in Pd handle zero- and one-element lists -in the following way:; -#X text 19 67 * an incoming zero-element list (i.e. \, a message consisting -onf the selector "list") is treated as a bang.; -#X text 19 97 * an incoming one-element list that contains a float -is treated as a float.; -#X obj 22 331 route list float; -#X obj 22 304 list; -#X obj 22 358 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 -1 --1; -#X obj 68 358 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 -1 --1; -#X msg 22 277 12; -#X text 55 277 implicit float-- same as "float 12"; -#X text 55 304 output as "list 12"; -#X floatatom 68 387 5 0 0 0 - - -, f 5; -#X text 130 331 [route] converts "list 12" to "float 12"; -#X text 19 127 * an incoming one-element list that contains a symbol -atom is treated as a symbol.; -#X connect 9 0 11 0; -#X connect 9 1 12 0; -#X connect 9 1 16 0; -#X connect 10 0 9 0; -#X connect 13 0 10 0; -#X restore 241 586 pd list_conversion_in_Pd; -#X text 170 307 - (optional) if no creation argument is given \, or -if the first creation argument is a number \, [list] will behave like -[list append]. Otherwise \, one of the following symbols may be given -as arguments (see subpatches for more info):; -#X text 98 245 [list] family objects always output a list. See the -"list_conversion_in_Pd" subpatch below for how lists are interpreted -by other objects.; -#X text 98 514 depending on what the first creation argument is \, -other creation arguments may be specified.; -#X text 98 154 See subpatches under the heading "arguments" for more -details. With the exception of the right inlet of [list split] \, All -[list] objects will convert incoming non-list messages to lists (e.g. -\, "set 5" will become "list set 5"). A bang message is converted to -an empty list (i.e. \, "list") \, and "symbol foo" is converted to -"list foo".; -#X obj 4 638 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X text 180 475 cat - build a list by accumulating elements; -#N canvas 1 112 555 488 cat 0; -#X obj 0 0 cnv 15 552 40 empty \$0-pddp.cnv.header empty 3 12 0 14 --204280 -1 0; -#X obj 0 304 cnv 3 520 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#X obj 0 387 cnv 3 520 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 78 396 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 313 cnv 17 3 40 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 363 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 98 314 anything; -#X obj 0 431 cnv 3 520 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X text 80 450 1); -#X floatatom 189 166 5 0 0 0 - - -, f 5; -#X msg 179 143 1 2 3; -#X msg 196 189 bang; -#X msg 170 120 4 5 6 and 7; -#X msg 128 51 4 5 6; -#X msg 158 98 four 5 6; -#X msg 144 74 list four 5 6; -#X text 98 397 list; -#X text 168 397 - the output is always a message with the selector -"list" (see subpatch "list_conversion" for more info).; -#X text 98 450 symbol atom; -#X obj 13 3 list cat; -#X text 18 24 append (concatenate) list to the previously entered list(s) -; -#X msg 203 225 clear; -#X obj 158 271 print cat; -#X obj 158 249 list cat; -#X text 98 364 clear; -#X text 178 364 - empties the stored list.; -#X text 178 314 - all input is converted to a list. The list is appended -to the list(s) previously entered in the left inlet \, and the resulting -list is sent to the outlet.; -#X text 170 450 - the symbol "cat".; -#X connect 9 0 23 0; -#X connect 10 0 23 0; -#X connect 11 0 23 0; -#X connect 12 0 23 0; -#X connect 13 0 23 0; -#X connect 14 0 23 0; -#X connect 15 0 23 0; -#X connect 21 0 23 1; -#X connect 23 0 22 0; -#X restore 102 475 pd cat; -#X connect 21 0 24 0; -#X connect 22 0 21 1; -#X connect 23 0 21 0; -#X connect 25 0 21 1; diff --git a/doc/pddp/lop~-help.pd b/doc/pddp/lop~-help.pd deleted file mode 100644 index 789173d9b..000000000 --- a/doc/pddp/lop~-help.pd +++ /dev/null @@ -1,91 +0,0 @@ -#N canvas 428 38 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 lop~ 3 12 0 18 -204280 --1 0; -#X obj 0 381 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 487 290 494 344 META 0; -#X text 12 125 LIBRARY internal; -#X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 145 AUTHOR Miller Puckette; -#X text 12 205 HELP_PATCH_AUTHORS Updated for Pd version-0.38. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 5 KEYWORDS signal filter; -#X text 12 45 DESCRIPTION one-pole low pass filter; -#X text 12 65 INLET_0 signal clear; -#X text 12 85 INLET_1 float; -#X text 12 105 OUTLET_0 signal; -#X text 12 185 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 488 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 525 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 567 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#X obj 78 390 cnv 17 3 37 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#N canvas 220 463 428 166 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 obj 69 43 bp~; -#X obj 117 43 vcf~; -#X text 22 81 Raw Filters; -#X obj 73 108 rzero~; -#X obj 195 108 cpole~; -#X obj 24 108 rpole~; -#X obj 122 108 rzero_rev~; -#X obj 244 108 czero~; -#X obj 293 108 czero_rev~; -#X obj 22 43 hip~; -#X text 8 2 [lop~] Related Objects; -#X restore 101 597 pd Related_objects; -#X text 98 389 signal; -#X obj 78 497 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 497 signal; -#X obj 147 240 env~; -#X floatatom 147 263 0 0 0 0 - - -; -#X floatatom 180 185 0 0 0 0 - - -; -#X obj 88 240 env~; -#X floatatom 88 262 0 0 0 0 - - -; -#X floatatom 88 114 0 0 0 0 - - -; -#X obj 88 137 osc~ 100; -#X msg 147 161 clear; -#X text 168 389 - incoming audio signal.; -#X obj 78 432 cnv 17 3 45 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 98 431 float; -#X text 98 449 list; -#X text 98 409 clear; -#X obj 514 10 lop~; -#X text 133 112 <- scroll to change input frequency; -#X obj 147 213 lop~ 5; -#X text 84 291 Compare the strength of the original signal on the left -with that of the filtered signal on the right.; -#X text 11 23 one-pole low pass filter; -#X text 168 544 - initial rolloff frequency.; -#X text 168 409 - reinitialize internal state.; -#X text 168 431 - cutoff frequency in Hz.; -#X text 168 449 - a list to the right inlet is truncated \, and the -first element is used as the cutoff frequency.; -#X text 168 497 - output is the filtered audio signal.; -#X text 80 544 1) float; -#X text 191 240 [env~] gives the amplitude of the signal envelop in -dB.; -#X text 88 68 [lop~] is a one-pole low pass filter with a specified -rolloff frequency.; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 479 51 pddp/dsp; -#X connect 12 0 13 0; -#X connect 14 0 27 1; -#X connect 15 0 16 0; -#X connect 17 0 18 0; -#X connect 18 0 15 0; -#X connect 18 0 27 0; -#X connect 19 0 27 0; -#X connect 27 0 12 0; diff --git a/doc/pddp/makefilename-help.pd b/doc/pddp/makefilename-help.pd deleted file mode 100644 index dc3ca7e28..000000000 --- a/doc/pddp/makefilename-help.pd +++ /dev/null @@ -1,361 +0,0 @@ -#N canvas 426 37 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 makefilename 3 12 -0 18 -204280 -1 0; -#X obj 0 179 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 483 287 494 344 META 0; -#X text 12 105 LIBRARY internal; -#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 125 AUTHOR Miller Puckette; -#X text 12 185 HELP_PATCH_AUTHORS Dave Sabine \, Hans-Christoph Steiner. -Jonathan Wilkes revised the patch to conform to the PDDP template for -Pd version 0.42.; -#X text 12 45 DESCRIPTION format a string with a variable field; -#X text 12 65 INLET_0 float symbol; -#X text 12 85 OUTLET_0 symbol; -#X text 12 165 RELEASE_DATE 1997; -#X text 12 5 KEYWORDS control conversion symbol_op; -#X restore 500 597 pd META; -#X obj 0 319 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 356 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 479 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 212 443 428 187 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 7 1 [makefilename] Related Objects; -#X obj 21 42 symbol; -#X obj 71 42 int; -#X obj 102 42 float; -#X obj 152 42 openpanel; -#X obj 19 96 pddp/helplink zexy/makesymbol; -#X obj 19 116 pddp/helplink cyclone/sprintf; -#X obj 19 136 pddp/helplink cxc/ascseq; -#X text 19 74 Externals; -#X restore 101 597 pd Related_objects; -#X obj 78 188 cnv 17 3 120 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 187 float; -#X obj 78 328 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 468 11 makefilename; -#X floatatom 49 64 0 0 0 0 - - -; -#X text 81 143 numbered filenames; -#X symbolatom 49 122 0 0 0 0 - - -; -#X obj 49 91 makefilename soundfile%d.aif; -#X obj 304 102 symbol; -#X msg 304 54 dave; -#X msg 343 54 drums; -#X msg 400 54 Pd; -#X msg 437 55 cool; -#X obj 304 126 makefilename %s_PD.aif; -#X symbolatom 304 150 0 0 0 0 - - -; -#X text 168 187 - if a number (integer) is sent to the inlet \, the -argument should be written with a "%c" \, "%d" \, or "%X" which represents -the location of the incoming variable number in the outgoing symbol. -Floats will be converted to integers.; -#X text 98 237 symbol; -#X text 98 278 list; -#X text 98 327 symbol; -#X text 169 374 - this object generates symbols according to a format -string (the argument) \, for use as a series of filenames \, table -names \, etc. Variables for numbers can be specified by using "%s" -\, "%c" \, "%d" \, or "%X" in the string (see subpatch below). For -variable symbols \, use "%s". No checking is done. Each [makefilename] -object can have only one variable.; -#X text 168 237 - if a symbol is sent to the inlet \, the argument -should be written with a "%s" which represents the location of the -incoming variable symbol in the outgoing symbol.; -#N canvas 74 23 428 594 More_Info 0; -#X text 20 33 I believe that this object was developed first to allow -PD to generate sequential file names - perhaps to be used in conjunction -with [soundfiler] or [openpanel]. For example \, an audio loop recorder -might generate a continuous series of sound files to be saved on a -hard drive...like below:; -#X obj 23 127 f; -#X symbolatom 23 168 0 0 0 0 - - -; -#X obj 52 127 + 1; -#X obj 23 147 makefilename file-%d.aif; -#X obj 23 104 bng 18 250 50 0 empty empty start 22 9 1 12 -90049 -1 --1; -#X symbolatom 61 358 0 0 0 0 - - -; -#X obj 64 309 hsl 150 18 0 122 0 1 empty empty ASCII_range 2 9 1 12 --262131 -1 -1 6800 0; -#X floatatom 30 360 3 0 0 0 - - -, f 3; -#X text 19 514 - only one printf pattern can be used at once; -#X text 19 476 - This object does not provide advanced formatting and -parsing abilities. For example \, you cannot use spaces or odd characters -in the argument.; -#X text 19 567 - non-printable ASCII characters show up as a little -box.; -#X symbolatom 264 358 0 0 0 0 - - -; -#X obj 267 309 hsl 150 18 0 255 0 1 empty empty 0_to_FF 2 9 1 12 -262131 --1 -1 5100 0; -#X obj 264 338 makefilename hex=%X; -#X floatatom 233 360 3 0 0 0 - - -, f 3; -#X obj 61 338 makefilename ASCII=%c; -#X text 29 381 Watch out! ASCII characters 123 and 125 (curly braces) -lock up Pd. Also \, reserved characters that Pd uses show up with a -backslash in front of them (comma \, semi-colon \, and backslash). -; -#X text 19 530 - currently \, floats are not supported via the printf -%f pattern. You can only display the integer part of the float using -%d or %X.; -#X text 20 189 This file name could be used when saving the audio to -disk.; -#X text 20 251 The %c pattern allows you to convert ASCII numbers to -the respective character. The %X converts the decimal number to hexadecimal. -Both %c and %X only use integers. For floats \, everything to the right -of the decimal is discarded.; -#X obj 2 2 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 8 2 [makefilename] Common Uses; -#X obj 2 216 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 -0 14 -204280 -1 0; -#X text 8 216 Conversions; -#X obj 2 442 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 -0 14 -204280 -1 0; -#X text 8 442 Limitations; -#X connect 1 0 3 0; -#X connect 1 0 4 0; -#X connect 3 0 1 1; -#X connect 4 0 2 0; -#X connect 5 0 1 0; -#X connect 7 0 16 0; -#X connect 7 0 8 0; -#X connect 13 0 14 0; -#X connect 13 0 15 0; -#X connect 14 0 12 0; -#X connect 16 0 6 0; -#X restore 100 488 pd More_Info; -#N canvas 105 144 428 318 all_possible_patterns 0; -#X text 33 86 %c; -#X text 110 86 character; -#X text 33 106 %d or %i; -#X text 110 106 signed decimal integer; -#X text 33 126 %e; -#X text 110 126 scientific notation using "e" character; -#X text 33 146 %E; -#X text 110 146 scientific notation using "e" character; -#X text 33 166 %f; -#X text 33 186 %o; -#X text 110 186 signed octal; -#X text 33 206 %s; -#X text 110 206 symbol; -#X text 33 226 %u; -#X text 110 226 unsigned integer; -#X text 33 246 %x; -#X text 110 246 unsigned hexadecimal in lowercase; -#X text 33 266 %X; -#X text 110 266 unsigned hexadecimal in CAPS; -#X text 33 286 %p; -#X text 110 286 unsigned hexadecimal in lowercase preceeded by "0x" -; -#X text 20 37 This is a listing of all possible printf patterns used -in Pd's [makefilename]:; -#X text 110 166 decimal floating point (currently broken); -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 1 [makefilename] All Possible Patterns; -#X restore 100 456 pd all_possible_patterns; -#N canvas 80 12 428 594 spaces_and_multiple_variables 0; -#X obj 223 71 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 223 90 f; -#X symbolatom 223 135 0 0 0 0 - - -; -#X obj 256 90 + 1; -#X obj 223 112 makefilename I_am_%d_years_old.; -#X text 20 197 With careful planning \, multiple variables can be incorporated -using a stack of [makefilename]s. In the example below \, let's assume -that this tool is used to generate file names for an audio loop recorder -which operates 24 hours per day \, every day.; -#X obj 25 265 loadbang; -#X obj 25 305 metro 200; -#X obj 25 286 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 1 1 -; -#X obj 58 330 + 1; -#X obj 153 369 route 0 1 2 3 4 5 6; -#X obj 25 379 mod 24; -#X floatatom 25 404 5 0 0 0 - - -, f 5; -#X floatatom 25 354 0 0 0 0 - - -; -#X obj 25 330 f; -#X obj 47 430 sel 0; -#X obj 162 289 f; -#X obj 194 289 + 1; -#X obj 162 314 mod 7; -#X obj 162 342 pack f f; -#X obj 168 518 makefilename Monday_%d.wav; -#X symbolatom 29 568 0 0 0 0 - - -; -#X obj 248 394 makefilename Saturday_%d.wav; -#X obj 232 419 makefilename Friday_%d.wav; -#X obj 234 346 t b f; -#X obj 216 444 makefilename Thursday_%d.wav; -#X obj 200 469 makefilename Wednesday_%d.wav; -#X obj 184 494 makefilename Tuesday_%d.wav; -#X obj 153 542 makefilename Sunday_%d.wav; -#X text 65 402 hour of day; -#X text 63 355 total hours; -#X text 153 569 Crude...but effective.; -#X obj 25 480 s dayHour; -#X obj 47 455 s weekDay; -#X obj 162 266 r weekDay; -#X obj 234 320 r dayHour; -#X text 228 291 loop through weekdays; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 1 [makefilename] Spaces and Multiple Variables; -#X symbolatom 22 115 0 0 0 0 - - -; -#X obj 22 93 makefilename one%ctwo; -#X msg 22 71 32; -#X text 51 70 ascii character 32 (space); -#X text 19 37 A symbol that includes a space will not be saved. An -underscore will often produce a tolerable compromise.; -#X obj 22 151 route symbol; -#X obj 22 172 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 -1 --1; -#X text 72 115 this symbol won't load; -#X text 72 130 properly if saved.; -#X text 41 171 but it's a valid symbol; -#X connect 0 0 1 0; -#X connect 1 0 3 0; -#X connect 1 0 4 0; -#X connect 3 0 1 1; -#X connect 4 0 2 0; -#X connect 6 0 8 0; -#X connect 7 0 14 0; -#X connect 8 0 7 0; -#X connect 9 0 14 1; -#X connect 10 0 28 0; -#X connect 10 1 20 0; -#X connect 10 2 27 0; -#X connect 10 3 26 0; -#X connect 10 4 25 0; -#X connect 10 5 23 0; -#X connect 10 6 22 0; -#X connect 11 0 12 0; -#X connect 12 0 15 0; -#X connect 12 0 32 0; -#X connect 13 0 11 0; -#X connect 14 0 9 0; -#X connect 14 0 13 0; -#X connect 15 0 33 0; -#X connect 16 0 17 0; -#X connect 16 0 18 0; -#X connect 17 0 16 1; -#X connect 18 0 19 0; -#X connect 19 0 10 0; -#X connect 20 0 21 0; -#X connect 22 0 21 0; -#X connect 23 0 21 0; -#X connect 24 0 19 0; -#X connect 24 1 19 1; -#X connect 25 0 21 0; -#X connect 26 0 21 0; -#X connect 27 0 21 0; -#X connect 28 0 21 0; -#X connect 34 0 16 0; -#X connect 35 0 24 0; -#X connect 39 0 44 0; -#X connect 40 0 39 0; -#X connect 41 0 40 0; -#X connect 44 0 45 0; -#X restore 100 511 pd spaces_and_multiple_variables; -#N canvas 58 29 463 530 help_with_interfaces 0; -#X text 21 32 Building user interfaces in Pd is a difficult balance -between usability and performance. Pd is not winning any awards for -usability - let's face it: it's powerful \, it's cool \, and that's -the way we like it. You're not here because you want a colourful \, -bevelled interface...you want the raw power that object oriented languages -provide mixed with a few of the conveniences that a graphic environment -affords.; -#X obj 6 221 cnv 15 450 300 empty empty empty 20 12 0 14 -261681 -66577 -0; -#X obj 34 331 tgl 15 0 s_dsp empty DSP 18 7 0 8 -262144 -1 -1 0 1; -#X obj 34 376 vsl 15 128 0 127 0 0 v_slider empty Volume 18 7 0 8 -262144 --1 -1 0 1; -#X obj 34 353 bng 15 250 50 0 b_panel empty Open_File 18 7 0 8 -262144 --1 -1; -#X obj 29 232 cnv 15 400 20 empty d_canvas DSP:OFF 20 12 0 8 -233017 --66577 0; -#X obj 29 254 cnv 15 400 20 empty f_canvas FILE_OPEN:/Users/hans/cvs/pure-data/doc/pddp/all_about_lists_vs_anythings.pd -20 12 0 8 -233017 -66577 0; -#X obj 29 276 cnv 15 400 20 empty v_canvas VOLUME:42/100 20 12 0 8 --233017 -66577 0; -#X text 176 313 The grey canvases above could; -#X text 178 335 be used like "status bars" to; -#X text 178 356 write relevant information to; -#X text 175 412 [makefilename] helps to format; -#X text 177 436 the information in a meaningful; -#X text 178 457 way.; -#X text 176 378 the screen.; -#N canvas 57 187 430 328 look_inside 0; -#X obj 199 14 r b_panel; -#X obj 235 166 r v_slider; -#X obj 36 236 s d_canvas; -#X obj 199 114 s f_canvas; -#X obj 235 263 s v_canvas; -#X obj 36 80 sel 0; -#X obj 71 152 symbol ON; -#X obj 36 128 symbol OFF; -#X obj 71 103 bang; -#X msg 36 210 label \$1; -#X obj 36 184 makefilename DSP:%s; -#X obj 36 13 r s_dsp; -#X msg 45 38 \; pd dsp \$1; -#X obj 199 40 openpanel; -#X obj 199 65 makefilename FILE_OPEN:%s; -#X msg 199 90 label \$1; -#X msg 235 240 label \$1; -#X obj 235 192 expr ($f1/128)*100; -#X obj 235 217 makefilename VOLUME:%d/100; -#X connect 0 0 13 0; -#X connect 1 0 17 0; -#X connect 5 0 7 0; -#X connect 5 1 8 0; -#X connect 6 0 10 0; -#X connect 7 0 10 0; -#X connect 8 0 6 0; -#X connect 9 0 2 0; -#X connect 10 0 9 0; -#X connect 11 0 5 0; -#X connect 11 0 12 0; -#X connect 13 0 14 0; -#X connect 14 0 15 0; -#X connect 15 0 3 0; -#X connect 16 0 4 0; -#X connect 17 0 18 0; -#X connect 18 0 16 0; -#X restore 29 302 pd look_inside; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 1 [makefilename] Help with Interfaces; -#X text 21 137 However \, there are times when sacrifices must be made -in the area of performance to provide users with on-screen reporting -\, record keeping \, and sometimes even a few 'pleasantries'. Consider -the following examples - but always weigh the pros and cons when incorporating -these types of interfaces. Performance vs. Usability.; -#X restore 100 534 pd help_with_interfaces; -#X text 11 23 format a string with a variable field; -#X text 168 278 - if the first element of the list matches the variable -type used \, then the list will be truncated.; -#X text 168 327 - the output of [makefilename] is always a symbol. -; -#X text 80 374 1) symbol atom; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 98 572 pddp/pddplink all_about_symbol_construction.pd; -#X obj 98 554 pddp/pddplink ../1.manual/x3.htm -text Pd Manual Chapter -3.6 - doc/1.manual/x3.htm; -#X connect 12 0 15 0; -#X connect 15 0 14 0; -#X connect 16 0 21 0; -#X connect 17 0 16 0; -#X connect 18 0 16 0; -#X connect 19 0 16 0; -#X connect 20 0 16 0; -#X connect 21 0 22 0; diff --git a/doc/pddp/makenote-help.pd b/doc/pddp/makenote-help.pd deleted file mode 100644 index 4f7239c33..000000000 --- a/doc/pddp/makenote-help.pd +++ /dev/null @@ -1,128 +0,0 @@ -#N canvas 428 39 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 makenote 3 12 0 -18 -204280 -1 0; -#X obj 0 281 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 485 265 494 367 META 0; -#X text 12 175 LIBRARY internal; -#X text 12 215 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 235 RELEASE_DATE 2009-06-12; -#X text 12 25 LICENSE SIBSD; -#X text 12 195 AUTHOR Miller Puckette; -#X text 12 255 HELP_PATCH_AUTHORS Updated for Pd version 0.33. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 5 KEYWORDS control MIDI; -#X text 12 75 INLET_0 float list; -#X text 12 95 INLET_1 float; -#X text 12 115 INLET_2 float; -#X text 12 135 OUTLET_0 float; -#X text 12 155 OUTLET_1 float; -#X text 12 45 DESCRIPTION send note-on messages and schedule note-off -for later; -#X restore 500 597 pd META; -#X obj 0 443 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 508 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 567 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 218 222 428 410 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 [makenote] Related Objects; -#X obj 74 80 ctlin; -#X obj 217 80 pgmin; -#X obj 24 80 bendin; -#X obj 79 107 touchin; -#X obj 261 80 polytouchin; -#X obj 118 80 midiin; -#X obj 23 107 sysexin; -#X obj 179 167 noteout; -#X obj 76 167 ctlout; -#X obj 24 167 bendout; -#X obj 366 167 touchout; -#X obj 280 167 polytouchout; -#X obj 123 167 midiout; -#X obj 231 167 pgmout; -#X obj 24 221 makenote; -#X text 21 198 MIDI note construction:; -#X text 21 140 MIDI output:; -#X text 21 57 MIDI input:; -#X obj 184 221 stripnote; -#X obj 168 80 notein; -#X text 181 198 MIDI note deconstruction:; -#X obj 24 33 stripnote; -#X text 21 265 Additional useful objects for MIDI processing (Maxlib -by Olaf Matthes); -#X text 20 344 Also \, from cyclone (alpha) by Krzysztof Czaja:; -#X text 21 246 Externals; -#X obj 21 295 pddp/helplink maxlib/pitch; -#X obj 21 310 pddp/helplink maxlib/score; -#X obj 21 325 pddp/helplink maxlib/chord; -#X obj 21 360 pddp/helplink cyclone/midiformat; -#X obj 21 375 pddp/helplink cyclone/midiparse; -#X obj 21 390 pddp/helplink cyclone/midiflush; -#X restore 101 597 pd Related_objects; -#X obj 78 290 cnv 17 3 95 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 289 float; -#X text 98 329 list; -#X text 98 451 float; -#X obj 78 452 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 391 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 98 390 float; -#X obj 486 11 makenote; -#X text 80 59 Makenote makes MIDI-style note-on/note-off pairs \, which -you can use for MIDI output or to drive note-like processes within -Pd.; -#X floatatom 276 163 0 0 0 0 - - -; -#X floatatom 276 142 0 0 0 0 - - -; -#X msg 194 119 60; -#X obj 183 218 print x1; -#X obj 276 218 print x2; -#X floatatom 183 97 0 0 0 0 - - -; -#X msg 234 123 60.5; -#X text 302 142 "velocity"; -#X text 311 166 duration in milliseconds; -#X obj 183 191 makenote 3.2 500; -#X text 168 289 - numbers to the left inlet are "pitches" (MIDI pitch -numbers) which may be integers or floating point numbers (for microtonal -pitches).; -#X msg 130 121 12 2; -#X text 11 23 send note-on messages and schedule note-off for later -; -#X text 168 329 - a list with three elements (pitch \, velocity \, -duration) will be distributed to the three inlets. You can also send -a two-element list to use the last duration supplied to [makenote]. -Lists with more than three elements are truncated.; -#X obj 78 415 cnv 17 3 17 empty \$0-pddp.cnv.let.2 2 5 9 0 16 -228856 --162280 0; -#X text 98 414 float; -#X text 158 544 - (optional) initial duration.; -#X text 158 529 - (optional) initial velocity.; -#X text 98 474 float; -#X obj 78 475 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 168 474 - velocity (in milliseconds). After the specified duration -\, a zero is output.; -#X text 167 390 - velocity.; -#X text 167 414 - duration (in milliseconds).; -#X text 80 529 1) float; -#X text 80 544 2) float; -#X text 168 451 - pitch. (It is output again after the specified duration.) -; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X connect 17 0 26 2; -#X connect 18 0 26 1; -#X connect 19 0 26 0; -#X connect 22 0 26 0; -#X connect 23 0 26 0; -#X connect 26 0 20 0; -#X connect 26 1 21 0; -#X connect 28 0 26 0; diff --git a/doc/pddp/math-help.pd b/doc/pddp/math-help.pd deleted file mode 100644 index ae00e7fef..000000000 --- a/doc/pddp/math-help.pd +++ /dev/null @@ -1,132 +0,0 @@ -#N canvas 406 25 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 (math_functions) -3 12 0 18 -204280 -1 0; -#X obj 0 315 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 488 281 494 344 META 0; -#X text 12 85 LIBRARY internal; -#X text 12 125 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 45 LICENSE SIBSD; -#X text 12 105 AUTHOR Miller Puckette; -#X text 12 165 HELP_PATCH_AUTHORS This document was updated for Pd -version 0.35 test 28 by Dave Sabine as part of a project called pddp -proposed by Krzysztof Czaja to build comprehensive documentation for -Pd. Revised by Jonathan Wilkes to conform to the PDDP template.; -#X text 12 65 DESCRIPTION higher math in Pd; -#X text 12 5 NAME sin cos tan atan atan2 exp log abs sqrt pow; -#X text 12 145 RELEASE_DATE 1997; -#X text 12 25 KEYWORDS control trigonometry; -#X restore 500 597 pd META; -#X obj 0 438 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 474 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 522 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 219 515 428 109 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 (math) Related Objects; -#X obj 22 42 osc~; -#X obj 58 42 cos~; -#X obj 96 42 exp~; -#X obj 134 42 log~; -#X obj 172 42 abs~; -#X obj 210 42 sqrt~; -#X obj 254 42 pow~; -#X restore 102 598 pd Related_objects; -#X obj 78 324 cnv 17 3 60 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 323 float; -#X text 98 342 list; -#X text 98 446 float; -#X obj 78 447 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 11 23 higher math in Pd; -#X obj 249 12 sin; -#X obj 275 12 cos; -#X obj 301 12 tan; -#X obj 328 12 atan; -#X obj 361 12 atan2; -#X obj 401 12 exp; -#X obj 429 12 log; -#X obj 456 12 abs; -#X obj 484 12 sqrt; -#X obj 519 12 pow; -#X obj 72 117 sin; -#X floatatom 72 91 5 0 0 0 - - -, f 5; -#X floatatom 72 144 5 0 0 0 - - -, f 5; -#X text 168 323 - the incoming value; -#X text 168 342 - a list will be truncated.; -#X text 168 446 - the outgoing value.; -#X text 98 478 The [pow] object accepts one float argument to initialize -the right inlet. All other math functions listed here take no arguments. -; -#X text 217 541 - binary arithmetic operators; -#X obj 98 541 pddp/pddplink operators-help.pd; -#X text 217 561 - relational and logical operators; -#X obj 98 561 pddp/pddplink otherbinops-help.pd; -#X text 98 359 (The [pow] object takes a bang \, which will output -the previous value.); -#X text 97 393 (Note: The [atan2] and [pow] objects have a right inlet. -See their respective help patches (links above) for more info.); -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X floatatom 142 91 5 0 0 0 - - -, f 5; -#X floatatom 142 144 5 0 0 0 - - -, f 5; -#X floatatom 212 91 5 0 0 0 - - -, f 5; -#X floatatom 212 144 5 0 0 0 - - -, f 5; -#X floatatom 282 91 5 0 0 0 - - -, f 5; -#X floatatom 282 144 5 0 0 0 - - -, f 5; -#X floatatom 352 91 5 0 0 0 - - -, f 5; -#X floatatom 352 144 5 0 0 0 - - -, f 5; -#X floatatom 72 201 5 0 0 0 - - -, f 5; -#X floatatom 72 254 5 0 0 0 - - -, f 5; -#X floatatom 142 201 5 0 0 0 - - -, f 5; -#X floatatom 142 254 5 0 0 0 - - -, f 5; -#X floatatom 212 201 5 0 0 0 - - -, f 5; -#X floatatom 212 254 5 0 0 0 - - -, f 5; -#X floatatom 282 201 5 0 0 0 - - -, f 5; -#X floatatom 282 254 5 0 0 0 - - -, f 5; -#X floatatom 352 201 5 0 0 0 - - -, f 5; -#X floatatom 352 254 5 0 0 0 - - -, f 5; -#X obj 142 117 cos; -#X obj 212 117 tan; -#X obj 282 117 atan; -#X obj 352 117 atan2; -#X obj 72 227 exp; -#X obj 142 227 log; -#X obj 212 227 abs; -#X obj 282 227 sqrt; -#X obj 352 227 pow; -#X floatatom 392 201 5 0 0 0 - - -, f 5; -#X floatatom 392 91 5 0 0 0 - - -, f 5; -#X floatatom 442 201 5 0 0 0 - - -, f 5; -#X floatatom 442 254 5 0 0 0 - - -, f 5; -#X obj 442 227 wrap; -#X connect 24 0 26 0; -#X connect 25 0 24 0; -#X connect 38 0 56 0; -#X connect 40 0 57 0; -#X connect 42 0 58 0; -#X connect 44 0 59 0; -#X connect 46 0 60 0; -#X connect 48 0 61 0; -#X connect 50 0 62 0; -#X connect 52 0 63 0; -#X connect 54 0 64 0; -#X connect 56 0 39 0; -#X connect 57 0 41 0; -#X connect 58 0 43 0; -#X connect 59 0 45 0; -#X connect 60 0 47 0; -#X connect 61 0 49 0; -#X connect 62 0 51 0; -#X connect 63 0 53 0; -#X connect 64 0 55 0; -#X connect 65 0 64 1; -#X connect 66 0 59 1; -#X connect 67 0 69 0; -#X connect 69 0 68 0; diff --git a/doc/pddp/message-help.pd b/doc/pddp/message-help.pd deleted file mode 100644 index 643d80b7e..000000000 --- a/doc/pddp/message-help.pd +++ /dev/null @@ -1,289 +0,0 @@ -#N canvas 420 26 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 message 3 12 0 18 --204280 -1 0; -#X obj 0 189 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 485 287 494 344 META 0; -#X text 12 125 LIBRARY internal; -#X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 35 LICENSE SIBSD; -#X text 12 145 AUTHOR Miller Puckette; -#X text 12 205 HELP_PATCH_AUTHORS Updated for Pd version 0.39. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 75 INLET_0 anything set add add2 addcomma addsemi adddollar -adddollsym; -#X text 12 105 OUTLET_0 anything; -#X text 12 55 DESCRIPTION clickable message box; -#X text 12 5 KEYWORDS control GUI nonlocal symbol_op list_op anything_op -bang_op; -#X text 12 185 RELEASE_DATE 1997; -#X restore 500 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 385 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 555 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 219 520 428 109 Related_objects 0; -#X obj 116 43 list; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X msg 12 3; -#X text 40 2 Related Objects; -#X obj 22 43 symbol; -#X obj 72 43 float; -#X restore 102 597 pd Related_objects; -#X obj 78 198 cnv 17 3 127 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 343 cnv 17 3 35 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X msg 514 11; -#X msg 101 141 walk the dog; -#X obj 101 164 print; -#N canvas 75 14 431 608 dollarsign_variables 0; -#X obj 23 156 print; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X msg 12 2; -#X text 40 2 Dollarsign Variables in Message Boxes; -#X msg 23 131 pitch \$3; -#X text 115 106 a list with three numbers; -#X msg 23 106 list 24 48 72; -#X text 83 131 replace "\$3" with the third element; -#X text 84 145 of the incoming message ("72"); -#X msg 23 236 24 48 72; -#X text 83 236 implicit list with three numbers; -#X msg 23 259 pitch \$3; -#X obj 23 281 print; -#X text 83 259 third element is still "72"; -#X text 20 303 It's important to note that you can't access the selector -of the message using the dollarsign variables. (In the patch above -\, "list" is the selector \, "24" is the first element \, and so on.) -Keep this in mind when using custom selectors \, as in the following: -; -#X msg 23 373 melody 67 67 67 63; -#X text 153 374 In this message \, "melody" is the selector \,; -#X text 153 389 and there are four elements (not five).; -#X msg 23 407 pitch \$4; -#X obj 23 490 print; -#X text 85 407 replace "\$4" with the fourth element ("63"); -#X msg 41 459 pitch \$5; -#X msg 41 433 melody 65 65 65 62; -#X text 163 438 this will output an error--; -#X text 163 452 there is no 5th element!; -#X text 20 180 Remember that the selectors "list" and "float" can be -omitted when the first atom in a message is a float. For example \, -the following still works exactly as the patch above:; -#X text 21 514 Multiple dollarsign variables may be used together: -; -#X obj 25 576 print; -#X msg 25 533 22 8 1791; -#X msg 25 555 \$1-\$2-\$3.wav; -#X text 20 38 You can use "dollarsign variables" to make variable messages. -Just use a dollarsign followed by a number-- "\$1" \, "\$2" \, etc. -The numbers (starting from one) specify which element of the incoming -message should replace the variable in the outgoing message.; -#X connect 4 0 0 0; -#X connect 6 0 4 0; -#X connect 9 0 11 0; -#X connect 11 0 12 0; -#X connect 15 0 18 0; -#X connect 18 0 19 0; -#X connect 21 0 19 0; -#X connect 22 0 21 0; -#X connect 28 0 29 0; -#X connect 29 0 27 0; -#X restore 171 457 pd dollarsign_variables; -#X text 11 23 clickable message box; -#X text 98 197 bang; -#X text 98 211 float; -#X text 98 225 symbol; -#X text 98 239 pointer; -#X text 98 254 anything; -#X text 168 197 - these message types will cause the message box to -send its message as output.; -#N canvas 50 89 428 405 messages_for_changing_the_content_of_a_message_box -0; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X msg 12 3; -#X text 40 2 Changing Messages; -#X msg 23 76 set dog; -#X msg 43 150 add monkey; -#X msg 48 195 add2 bird; -#X msg 37 124 set; -#X msg 31 99 set 1 2 3 skidoo; -#X text 71 124 "set" with no arguments clears it; -#X text 85 77 "set" to set contents (numbers and/or symbols); -#X msg 52 229 addcomma; -#X msg 56 255 addsemi; -#X msg 60 312 adddollsym 4-foo; -#X msg 59 282 adddollar 3; -#X text 118 229 add a comma; -#X text 118 254 add a semicolon; -#X text 137 282 add a dollar-sign argument; -#X text 167 312 add a dollar-sign-plus-symbol argument; -#X text 20 37 The following messages may be used to change contents -of messages boxes:; -#X text 118 165 plus a terminating semicolon; -#X text 117 151 "add" to add numbers and/or symbols \,; -#X text 118 209 the terminating semicolon; -#X text 117 195 "add2" to add contents without; -#X msg 23 357; -#X connect 3 0 23 0; -#X connect 4 0 23 0; -#X connect 5 0 23 0; -#X connect 6 0 23 0; -#X connect 7 0 23 0; -#X connect 10 0 23 0; -#X connect 11 0 23 0; -#X connect 12 0 23 0; -#X connect 13 0 23 0; -#X restore 101 308 pd messages_for_changing_the_content_of_a_message_box -; -#X text 98 342 anything; -#X text 168 342 - a message box will output its message (replacing -any dollar-sign variables with the relevant elements of the incoming -message).; -#X text 100 476 comma; -#X text 100 513 semicolon; -#N canvas 88 49 428 453 Using_Commas_in_Message_Boxes 0; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X msg 12 3; -#X text 40 2 About Commas and Semicolons; -#X obj 23 136 list length; -#X floatatom 23 164 5 0 0 3 No_of_atoms - -, f 5; -#X obj 23 94 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 -1 --1; -#X obj 23 114 list append one \, 3; -#X text 141 115 This list actually contains three atoms:; -#X text 141 135 1) The symbol "one"; -#X text 141 165 3) The float "3"; -#X text 20 37 Even though they are not be separated by whitespace \, -semicolons and commas are actually atoms in Pd-- just like float- and -symbol-atoms. You can see this clearly in the example below:; -#X text 43 92 <- Click to test; -#X msg 22 281 Because I do not hope to turn again \, Because I do not -hope; -#X obj 22 303 print from_Ash_Wednesday; -#X text 20 210 In message boxes \, commas and semicolons are used to -separate one message from another. For example \, there are two messages -in the message box below. Each is sent separately to the [print] object -(in the order they were written):; -#X msg 23 376 1 \, 2 \, 3; -#X obj 23 398 + 10; -#X obj 23 422 print sum; -#X text 20 329 Notice that the comma itself is not included as part -of the message-- it simply tells Pd where one message ends \, and the -next begins.; -#X text 141 150 2) A comma; -#X connect 3 0 4 0; -#X connect 5 0 6 0; -#X connect 6 0 3 0; -#X connect 12 0 13 0; -#X connect 15 0 16 0; -#X connect 16 0 17 0; -#X restore 172 495 pd Using_Commas_in_Message_Boxes; -#N canvas 82 29 428 495 Using_Semicolons_In_Message_Boxes 0; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X msg 12 3; -#X obj 24 362 print; -#X obj 228 291 receive my-receiver-name; -#X floatatom 228 315 0 0 0 0 - - -; -#X floatatom 227 362 0 0 0 0 - - -; -#X obj 227 338 receive another-receiver; -#X obj 23 191 receive msg2r; -#X obj 23 217 print after_semi; -#X obj 23 159 print before_semi; -#X msg 24 291 \; my-receiver-name 858 \; another-receiver -45; -#X text 40 2 About Semicolons and Nonlocal Sends; -#X msg 23 118 this msg comes out the outlet \; msg2r this msg comes -out of [receive msg2r]; -#X msg 201 441 \; pd dsp 1; -#X msg 25 441 dsp 1; -#X obj 25 468 s dsp; -#X text 85 451 is the same as; -#X text 22 396 For messages to a single named-object \, however \, -it is probably clearer to use a message box and a [send] object \, -but you can judge for yourself:; -#X text 20 37 Like commas \, semicolons may be used to send multiple -messages from a single message box. When using a semicolon \, however -\, the message following the semicolon is re-routed to a named object -\, such as [receive] \, an array \, or a canvas. The named object is -specified by the selector of the message ("msg2r" in this example): -; -#X text 22 246 To send messages to named objects without first sending -a message to the outlet \, put an initial semicolon in the message -box:; -#X connect 3 0 4 0; -#X connect 6 0 5 0; -#X connect 7 0 8 0; -#X connect 10 0 2 0; -#X connect 12 0 9 0; -#X connect 14 0 15 0; -#X restore 172 532 pd Using_Semicolons_In_Message_Boxes; -#X text 168 254 - other messages will cause the message box to send -its message as output \, except for the "special messages" that are -used to change the content of a message box. Click the subpatch below -to view these "special messages":; -#X text 168 476 - a comma may be used to separate multiple messages: -; -#X text 178 513 - a semicolon may be used to send messages nonlocally: -; -#X text 168 402 - message boxes can contain any number of float and/or -symbol arguments. Message boxes may also contain special "dollar-sign -variables" \, used to grab data from an incoming message. Click the -subpatch below for more info:; -#X text 98 97 Clicking on a message also sends it \, so you can use -messsage boxes as push buttons. For instance \, click here while watching -the printout window:; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 100 559 pddp/pddplink all_about_messages.pd -text all_about_messages -; -#X obj 100 574 pddp/pddplink all_about_symbol_construction.pd -text -all_about_symbol_construction; -#X obj 286 559 pddp/pddplink ../2.control.examples/04.messages.pd -text -doc/2.control.examples/04.messages.pd; -#X obj 286 574 pddp/pddplink ../2.control.examples/10.more.messages.pd --text doc/2.control.examples/10.more.messages.pd; -#X text 331 10 To create \, click <Control-2>; -#X text 98 57 Message boxes hold one or more messages. Anytime the -message box receives any message at all \, the messages in the box -are all sent to their destinations.; -#X text 188 141 <- message box; -#X text 141 164 <- object box (notice the different border); -#X text 81 402 n) symbol atom; -#X text 100 417 float; -#N canvas 423 174 432 262 \$0_variable 0; -#X obj 24 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 -0 14 -204280 -1 0; -#X msg 35 2; -#X text 63 2 \$0 Variable in Message Boxes; -#X msg 40 92 \$0; -#X text 39 38 Special case available in pd-l2ork is the \$0 variable -which resolves into canvas instance number \, just like placing such -a variable inside a regular object.; -#X floatatom 40 114 5 0 0 0 - - -, f 5; -#X text 68 92 <--click on this message; -#X obj 242 92 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 -1 --1; -#X obj 242 112 \$0; -#X floatatom 242 134 5 0 0 0 - - -, f 5; -#X text 261 92 <--compare to this; -#X floatatom 40 178 5 0 0 0 - - -, f 5; -#X msg 40 199 \$1 \$0; -#X obj 40 221 print; -#X text 80 199 <--works in any order; -#X connect 3 0 5 0; -#X connect 7 0 8 0; -#X connect 8 0 9 0; -#X connect 11 0 12 0; -#X connect 12 0 13 0; -#X restore 318 457 pd \$0_variable; -#X connect 11 0 12 0; diff --git a/doc/pddp/midi-help.pd b/doc/pddp/midi-help.pd deleted file mode 100644 index 58edae652..000000000 --- a/doc/pddp/midi-help.pd +++ /dev/null @@ -1,100 +0,0 @@ -#N canvas 430 38 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 (MIDI) 3 12 0 18 --204280 -1 0; -#X obj 0 288 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 489 291 494 344 META 0; -#X text 12 105 LIBRARY internal; -#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 65 LICENSE SIBSD; -#X text 12 125 AUTHOR Miller Puckette; -#X text 12 185 HELP_PATCH_AUTHORS Updated for Pd v0.41. Revised by -Jonathan Wilkes to conform to the PDDP template for Pd version 0.42. -; -#X text 12 45 KEYWORDS control MIDI; -#X text 12 85 DESCRIPTION MIDI input/output objects; -#X text 12 5 NAME bendin ctlin midiin notein pgmin polytouchin sysexin -touchin bendout ctlout midiout noteout pgmout polytouchout touchout -; -#X text 12 165 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 495 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 538 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 566 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#X text 98 542 (none); -#N canvas 217 519 428 109 Related_objects 0; -#X obj 62 43 makenote; -#X obj 22 43 poly; -#X obj 123 43 list; -#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 (MIDI) Related Objects; -#X restore 102 598 pd Related_objects; -#X obj 79 297 cnv 17 3 130 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 296 float; -#X text 98 353 list; -#X text 98 503 float; -#X obj 79 504 cnv 17 3 30 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 79 440 cnv 17 3 45 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 98 439 float; -#X text 98 383 flush; -#X text 98 413 clear; -#X text 168 383 - output all values one by one \, in the order they -were received \, and clear the collection.; -#X text 168 503 - upon sending the "flush" message to the left inlet -\, [bag] will output each value in the order it was received.; -#X text 168 353 - a (value \, flag) pair is distributed to the two -inlets. Lists with more than two elements will be truncated.; -#X text 168 413 - clear the collection.; -#X text 167 439 - a float to the right inlet sets the "flag": if zero -\, values to the left inlet will not be added to the collection. If -nonzero \, values to the right inlet will be added to the collection. -; -#X text 168 296 - a float to the left inlet will be added to the collection -if the last value the right inlet received was nonzero. If the last -value the right inlet received was zero \, the float sent to the right -inlet will be removed from the collection.; -#X text 11 23 MIDI input/output objects; -#X obj 86 86 bendin; -#X obj 86 123 bendout; -#X obj 131 86 ctlin; -#X obj 137 123 ctlout; -#X obj 215 86 notein; -#X obj 233 123 noteout; -#X obj 260 86 pgmin; -#X obj 284 123 pgmout; -#X obj 425 86 touchin; -#X obj 299 86 polytouchin; -#X obj 170 86 midiin; -#X obj 374 86 sysexin; -#X obj 182 123 midiout; -#X obj 329 123 polytouchout; -#X obj 410 123 touchout; -#X text 10 86 MIDI input:; -#X text 10 123 MIDI output:; -#X obj 320 185 pddp/pddplink touchin-help.pd; -#X obj 243 185 touchin; -#X obj 243 210 polytouchin; -#X obj 320 210 pddp/pddplink polytouchin-help.pd; -#X obj 243 235 touchout; -#X obj 320 235 pddp/pddplink touchout-help.pd; -#X obj 243 260 polytouchout; -#X obj 320 260 pddp/pddplink polytouchout-help.pd; -#X obj 80 185 midiin; -#X obj 80 235 sysexin; -#X obj 80 210 midiout; -#X obj 135 185 pddp/pddplink midiin-help.pd; -#X obj 135 235 pddp/pddplink sysexin-help.pd; -#X obj 135 210 pddp/pddplink midiout-help.pd; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X text 77 151 Right-click the objects above and choose "Help" \, or -follow the links below for help on these objects:; diff --git a/doc/pddp/moses-help.pd b/doc/pddp/moses-help.pd deleted file mode 100644 index 758748bd5..000000000 --- a/doc/pddp/moses-help.pd +++ /dev/null @@ -1,120 +0,0 @@ -#N canvas 429 36 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 moses 3 12 0 18 --204280 -1 0; -#X obj 0 302 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 486 245 494 384 META 0; -#X text 12 145 LIBRARY internal; -#X text 12 185 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 205 RELEASE_DATE 2009-06-12; -#X text 12 25 LICENSE SIBSD; -#X text 12 165 AUTHOR Miller Puckette; -#X text 12 225 HELP_PATCH_AUTHORS This help patch was updated for Pd -version 0.35 test 26 by Dave Sabine as part of a project called pddp -proposed by Krzysztof Czaja to build comprehensive documentation for -Pd. Jonathan Wilkes revised the patch to conform to the PDDP template -for Pd version 0.42.; -#X text 12 5 KEYWORDS control filter; -#X text 12 45 DESCRIPTION part a stream of numbers; -#X text 12 65 INLET_0 float list; -#X text 12 85 INLET_1 float; -#X text 12 105 OUTLET_0 float; -#X text 12 125 OUTLET_1 float; -#X restore 500 597 pd META; -#X obj 0 410 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 498 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 539 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 220 367 428 256 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 [moses] Related Objects; -#X text 19 168 The best places to find information about Pd's libraries -is:; -#X text 19 190 www.puredata.org and click on "Downloads" then "Software" -; -#X text 20 206 or; -#X text 19 221 iem.kug.ac.at/pdb/; -#X text 20 119 Externals are offered in Pd only if you have downloaded -and properly installed the appropriate library. These objects may or -may not exist in a single library.; -#X obj 22 42 list split; -#X text 20 80 Externals; -#X obj 20 98 pddp/helplink cyclone/split; -#X restore 102 597 pd Related_objects; -#X obj 78 311 cnv 17 3 65 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 310 float; -#X text 98 350 list; -#X text 98 418 float; -#X obj 78 419 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 382 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 98 381 float; -#X obj 506 11 moses; -#X floatatom 68 143 4 0 0 0 - - -, f 4; -#X floatatom 124 142 4 0 0 0 - - -, f 4; -#X floatatom 68 196 4 0 0 0 - - -, f 4; -#X floatatom 121 196 4 0 0 0 - - -, f 4; -#X text 65 66 Moses takes numbers and outputs them at left if they're -less than a control value \, and at right if they're greater or equal -to it. The creation argument initializes the control value (10 in this -example) and the right inlet changes it.; -#N canvas 103 360 428 202 More_info 0; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X obj 22 146 moses 0; -#X floatatom 22 170 5 0 0 0 - - -, f 5; -#X floatatom 65 170 5 0 0 0 - - -, f 5; -#X floatatom 22 124 5 0 0 0 - - -, f 5; -#X text 20 38 One way to think of [moses] is as a filter. For the following -example \, imagine that [moses] works as a low pass and high pass filter -simoultaneously -- for non-audio signals. Below you will see that negative -numbers will pass through the left outlet while positive numbers will -pass through the right outlet.; -#X text 8 2 [moses] More Info; -#X connect 1 0 2 0; -#X connect 1 1 3 0; -#X connect 4 0 1 0; -#X restore 102 548 pd More_info; -#X text 167 381 - a float to the right inlet sets the control value. -; -#X text 98 453 float; -#X obj 78 454 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 168 453 - incoming values (to the left inlet) will pass at -the right outlet if they are greater than or equal to the control value. -; -#X obj 68 169 moses 10; -#X text 224 179 The control value may be a float or integer. Try shift-scrolling: -; -#X floatatom 327 221 5 0 0 0 - - -, f 5; -#X floatatom 327 267 5 0 0 0 - - -, f 5; -#X obj 327 244 moses 1.5; -#X floatatom 378 267 5 0 0 0 - - -, f 5; -#X text 11 23 part a stream of numbers; -#X text 168 350 - a two element list is distributed to the two inlets. -Lists with more than two elements will be truncated.; -#X text 168 516 - (optional) initializes the control value.; -#X text 168 418 - incoming values (to the left inlet) will pass at -the left outlet if they are less than the control value.; -#X text 81 516 1) float; -#X text 168 310 - if the float the left inlet is less than the control -value \, it passes at the left inlet. If it is greater than or equal -to the control value it passes at the right inlet.; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 100 568 pddp/pddplink ../2.control.examples/18.conditional.pd --text doc/2.control.examples/18.conditional.pd; -#X connect 16 0 26 0; -#X connect 17 0 26 1; -#X connect 26 0 18 0; -#X connect 26 1 19 0; -#X connect 28 0 30 0; -#X connect 30 0 29 0; -#X connect 30 1 31 0; diff --git a/doc/pddp/my_canvas-help.pd b/doc/pddp/my_canvas-help.pd deleted file mode 100644 index 0d3bb8686..000000000 --- a/doc/pddp/my_canvas-help.pd +++ /dev/null @@ -1,748 +0,0 @@ -#N canvas 432 34 555 662 10; -#N canvas 93 78 450 511 let's-play-pong! 0; -#X obj 148 128 cnv 15 100 25 empty \$0-score Score:0 5 12 0 14 -233017 --66577 0; -#X obj 14 29 cnv 5 5 60 \$0-ps \$0-pr empty 20 12 0 14 -1 -66577 0 -; -#X msg 257 112 delta 0 \$1; -#X msg 257 87 -5; -#X obj 68 48 tgl 16 0 empty empty Go! 19 8 0 10 -4034 -1 -1 0 1; -#X obj 337 158 r \$0-ps; -#X obj 337 180 unpack; -#X obj 370 202 v py; -#X obj 68 117 t b b b; -#X msg 107 164 \; \$1-br get_pos \; \$1-pr get_pos \;; -#X obj 425 6 cnv 5 5 500 empty empty empty 20 12 0 14 -1 -66577 0; -#X obj 257 158 r \$0-bs; -#X obj 290 202 v by; -#X obj 68 447 pack; -#X msg 145 340 1; -#X msg 178 340 -1; -#X obj 68 491 s \$0-br; -#X obj 87 297 sel 0 1 2 3 4 5; -#X msg 101 361 1; -#N canvas 574 158 450 300 drift 0; -#X obj 55 40 inlet; -#X obj 136 40 inlet; -#X obj 205 45 inlet; -#X obj 55 117 f; -#X obj 93 142 mod; -#X obj 55 164 sel 1; -#X obj 55 231 f 1; -#X obj 55 266 outlet; -#X msg 90 231 0; -#X obj 136 61 b; -#X obj 136 88 random 8; -#X obj 136 115 sel 0; -#X msg 130 137 1e+37; -#X obj 205 155 t a; -#X floatatom 13 147 5 0 0 0 - - -, f 5; -#X obj 93 118 + 1; -#X connect 0 0 3 0; -#X connect 1 0 9 0; -#X connect 2 0 13 0; -#X connect 3 0 5 0; -#X connect 3 0 14 0; -#X connect 3 0 15 0; -#X connect 4 0 3 1; -#X connect 5 0 6 0; -#X connect 5 1 8 0; -#X connect 6 0 7 0; -#X connect 8 0 7 0; -#X connect 9 0 10 0; -#X connect 10 0 11 0; -#X connect 11 0 12 0; -#X connect 11 1 4 1; -#X connect 12 0 4 1; -#X connect 13 0 6 1; -#X connect 15 0 4 0; -#X restore 95 427 pd drift; -#X obj 68 405 t a b; -#X obj 68 383 f 1; -#X msg 134 18 10 SLOW; -#X msg 134 35 7 MEDIUM; -#X obj 257 43 spigot; -#X obj 77 71 s \$0-k; -#X obj 310 10 r \$0-k; -#N canvas 0 0 450 300 score 0; -#X obj 84 59 inlet; -#X obj 84 113 f; -#X obj 120 113 + 1; -#X obj 84 86 b; -#X msg 84 152 label Score:\$1; -#X obj 84 179 s \$0-score; -#X obj 165 51 sel 0; -#X obj 165 78 0; -#X obj 210 92 loadbang; -#X msg 210 114 0; -#X obj 165 24 r play; -#X connect 0 0 3 0; -#X connect 1 0 2 0; -#X connect 1 0 4 0; -#X connect 2 0 1 1; -#X connect 3 0 1 0; -#X connect 4 0 5 0; -#X connect 6 0 7 0; -#X connect 7 0 1 1; -#X connect 8 0 9 0; -#X connect 9 0 4 0; -#X connect 10 0 6 0; -#X restore 101 386 pd score; -#X obj 68 95 metro 10; -#N canvas 0 0 450 300 once 0; -#X obj 26 21 inlet; -#X obj 26 102 outlet; -#X obj 26 75 t a b; -#X msg 89 48 0; -#X obj 26 48 spigot 1; -#X connect 0 0 4 0; -#X connect 2 0 1 0; -#X connect 2 1 3 0; -#X connect 3 0 4 1; -#X connect 4 0 2 0; -#X restore 310 32 pd once; -#X obj 257 65 select 97 122 32; -#X msg 336 89 1; -#X obj 87 277 t a; -#X obj 256 442 cnv 15 100 40 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X text 256 439 a = up \; z = down \; <space> = replay; -#X text 216 318 0 - die at left wall \; 1 - richochet off left wall -\; 2 - die at right wall (not yet) \; 3 - richochet off right wall -\; 4 - richochet off top \; 5 - richochet of bottom \;; -#X obj 68 18 r play; -#X obj 336 111 s play; -#X msg 87 319 0; -#X obj 257 202 v bx; -#X obj 337 202 v px; -#X obj 257 180 unpack; -#X obj 257 134 s \$0-pr; -#X msg 294 87 5; -#X msg 134 52 4 FAST; -#X obj 107 139 f \$0; -#X msg 130 361 -1; -#X msg 68 469 delta \$1 \$2; -#X obj 87 341 s play; -#N canvas 528 152 450 386 sfx 0; -#X obj 21 169 noise~; -#X obj 22 201 *~; -#X obj 102 176 vline~; -#X obj 23 249 +~; -#X obj 174 146 delread~ \$0-b; -#X obj 36 278 delwrite~ \$0-b 500; -#X obj 22 302 *~ 0.1; -#X obj 23 330 dac~; -#X obj 135 120 del; -#X msg 102 120 1; -#X msg 135 145 0; -#X obj 174 120 * 10; -#X obj 175 176 *~ 0.8; -#X msg 174 81 2; -#X obj 117 9 inlet; -#X obj 174 54 change; -#X obj 117 31 sel -1 0 2; -#X connect 0 0 1 0; -#X connect 1 0 3 0; -#X connect 2 0 1 1; -#X connect 3 0 5 0; -#X connect 3 0 6 0; -#X connect 4 0 12 0; -#X connect 6 0 7 0; -#X connect 6 0 7 1; -#X connect 8 0 10 0; -#X connect 9 0 2 0; -#X connect 10 0 2 0; -#X connect 11 0 4 0; -#X connect 12 0 3 1; -#X connect 13 0 9 0; -#X connect 13 0 8 0; -#X connect 13 0 11 0; -#X connect 14 0 16 0; -#X connect 15 0 13 0; -#X connect 16 3 15 0; -#X restore 211 294 pd sfx; -#X obj 257 19 key 1; -#X msg 134 69 1.5 ???; -#X obj 87 225 expr if(bx<=20 \, py-10<=by && py+60>=by \, -1) \; if -(bx>=415 \, 3 \, -1) \; if (by<=0 \, 4 \, if (by>=500 \, 5 \, -1)) -; -#X obj 71 51 cnv 10 10 10 \$0-bs \$0-br empty 20 12 0 14 -1 -66577 -0; -#X connect 2 0 42 0; -#X connect 3 0 2 0; -#X connect 4 0 25 0; -#X connect 4 0 28 0; -#X connect 5 0 6 0; -#X connect 6 0 40 0; -#X connect 6 1 7 0; -#X connect 8 0 21 0; -#X connect 8 1 52 0; -#X connect 8 2 45 0; -#X connect 11 0 41 0; -#X connect 13 0 47 0; -#X connect 14 0 19 2; -#X connect 15 0 19 2; -#X connect 17 0 38 0; -#X connect 17 1 18 0; -#X connect 17 2 38 0; -#X connect 17 3 46 0; -#X connect 17 4 14 0; -#X connect 17 5 15 0; -#X connect 18 0 19 1; -#X connect 18 0 21 1; -#X connect 18 0 27 0; -#X connect 19 0 13 1; -#X connect 20 0 13 0; -#X connect 20 1 19 0; -#X connect 21 0 20 0; -#X connect 22 0 28 1; -#X connect 23 0 28 1; -#X connect 24 0 30 0; -#X connect 26 0 29 0; -#X connect 28 0 8 0; -#X connect 29 0 24 1; -#X connect 30 0 3 0; -#X connect 30 1 43 0; -#X connect 30 2 31 0; -#X connect 31 0 37 0; -#X connect 32 0 17 0; -#X connect 32 0 49 0; -#X connect 36 0 4 0; -#X connect 38 0 48 0; -#X connect 41 0 39 0; -#X connect 41 1 12 0; -#X connect 43 0 2 0; -#X connect 44 0 28 1; -#X connect 45 0 9 0; -#X connect 46 0 19 1; -#X connect 46 0 21 1; -#X connect 47 0 16 0; -#X connect 50 0 24 0; -#X connect 51 0 28 1; -#X connect 52 0 32 0; -#X connect 52 1 32 0; -#X connect 52 2 32 0; -#X restore 136 312 pd let's-play-pong!; -#X obj 0 639 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 my_canvas 3 12 0 -18 -204280 -1 0; -#X obj 0 352 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 485 284 494 344 META 0; -#X text 12 85 LIBRARY internal; -#X text 12 45 LICENSE SIBSD; -#X text 12 105 AUTHOR Thomas Musil; -#X text 12 125 WEBSITE; -#X text 12 165 HELP_PATCH_AUTHORS Jonathan Wilkes revised the patch -to conform to the PDDP template for Pd version 0.42.; -#X text 12 65 DESCRIPTION gui-rectangle; -#X text 12 5 ALIAS cnv; -#X text 12 145 RELEASE_DATE 2002; -#X text 12 25 KEYWORDS control GUI nonlocal; -#X restore 500 641 pd META; -#X obj 0 430 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 459 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 546 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 219 521 428 109 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 [cnv] Related Objects; -#X obj 22 43 drawpolygon; -#X obj 112 43 filledpolygon; -#X obj 22 73 x_all_guis bng tgl vsl hsl hradio vradio vu cnv nbx; -#X restore 102 641 pd Related_objects; -#X text 11 23 gui-rectangle; -#X text 420 10 [my_canvas] or [cnv]; -#X text 98 356 (none); -#X text 98 435 (none); -#X text 98 374 See the following subpatch for messages that change -the gui-properties of [cnv]:; -#N canvas 80 25 428 604 Changing_GUI_Properties 0; -#X obj 27 393 unpack 0 0; -#X text 12 301 get position on canvas; -#X msg 13 109 size \$1; -#X obj 13 72 nbx 3 14 8 200 0 0 empty \$0-dim empty 0 -8 0 12 -262144 --1 -1 15 256 0; -#X obj 13 133 s cnv_rcv; -#N canvas 366 206 174 259 flash-time 0; -#X obj 68 180 pack; -#X obj 103 149 t b a; -#X obj 68 205 outlet; -#X obj 103 104 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-width empty -0 -8 0 12 -262144 -1 -1 100 256 0; -#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-height empty -0 -8 0 12 -262144 -1 -1 60 256 0; -#X connect 0 0 2 0; -#X connect 1 0 0 0; -#X connect 1 1 0 1; -#X connect 3 0 0 0; -#X connect 4 0 1 0; -#X coords 0 -1 1 1 48 42 2 100 100; -#X restore 89 59 pd flash-time; -#X text 86 38 visible size; -#X text 138 61 1.width; -#X text 138 81 2.height; -#X msg 89 109 vis_size \$1 \$2; -#X obj 89 133 s cnv_rcv; -#X text 195 38 change send name; -#X text 310 38 change receive name; -#X obj 196 134 s cnv_rcv; -#X obj 310 134 s cnv_rcv; -#X msg 196 59 send cnv5a_snd; -#X msg 310 59 receive cnv1a_rcv; -#X obj 320 109 s cnv1a_rcv; -#X msg 320 85 receive cnv_rcv; -#X text 132 173 label position; -#X text 274 173 font properties; -#X text 13 173 label; -#X msg 13 194 label new-label; -#X msg 134 245 label_pos \$1 \$2; -#X msg 276 245 label_font \$1 \$2; -#X text 325 197 1.font(0-2); -#X text 325 218 2.height; -#X text 183 196 1.x-offset; -#X text 183 217 2.y-offset; -#N canvas 366 206 174 259 flash-time 0; -#X obj 68 180 pack; -#X obj 103 149 t b a; -#X obj 68 205 outlet; -#X obj 103 104 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-xlabel empty -0 -8 0 12 -262144 -1 -1 20 256 0; -#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-ylabel empty -0 -8 0 12 -262144 -1 -1 12 256 0; -#X connect 0 0 2 0; -#X connect 1 0 0 0; -#X connect 1 1 0 1; -#X connect 3 0 0 0; -#X connect 4 0 1 0; -#X coords 0 -1 1 1 48 42 2 100 100; -#X restore 134 195 pd flash-time; -#N canvas 366 206 174 259 flash-time 0; -#X obj 68 180 pack; -#X obj 103 149 t b a; -#X obj 68 205 outlet; -#X obj 103 104 nbx 3 14 0 2 0 0 \$0-dummy \$0-font empty 0 -8 0 12 --262144 -1 -1 0 256 0; -#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-font-size empty -0 -8 0 12 -262144 -1 -1 14 256 0; -#X connect 0 0 2 0; -#X connect 1 0 0 0; -#X connect 1 1 0 1; -#X connect 3 0 0 0; -#X connect 4 0 1 0; -#X coords 0 -1 1 1 48 42 2 100 100; -#X restore 276 195 pd flash-time; -#X text 164 461 delta; -#X text 12 461 position; -#X msg 13 558 pos \$1 \$2; -#X msg 165 558 delta \$1 \$2; -#X text 165 301 preset-colors; -#X text 264 301 RGB-colors; -#N canvas 364 205 169 292 flash-time 0; -#X obj 69 196 t b a; -#X obj 33 262 outlet; -#X obj 103 104 nbx 3 14 0 29 0 0 \$0-dummy \$0-bg empty 0 -8 0 12 -262144 --1 -1 10 256 0; -#X obj 103 124 nbx 3 14 0 29 0 0 \$0-dummy \$0-label empty 0 -8 0 12 --262144 -1 -1 12 256 0; -#X obj 33 237 pack 0 0; -#X connect 0 0 4 0; -#X connect 0 1 4 1; -#X connect 2 0 4 0; -#X connect 3 0 0 0; -#X connect 4 0 1 0; -#X coords 0 -1 1 1 48 42 2 100 100; -#X restore 165 323 pd flash-time; -#N canvas 0 0 306 317 flash-time 0; -#X obj 96 521 outlet; -#X obj 162 230 t b f; -#X obj 96 268 +; -#X obj 96 293 t b f; -#X obj 96 324 +; -#X obj 19 208 * -65536; -#X obj 96 208 * -256; -#X obj 162 208 * -1; -#X obj 96 355 - 1; -#X obj 96 385 list prepend 0; -#X obj 115 456 t b a; -#X obj 104 124 vradio 15 1 0 2 empty empty empty 0 -8 0 10 -262144 --1 -1 0; -#X text 120 120 1.bg; -#X obj 103 105 nbx 3 14 0 255 0 0 \$0-dummy \$0-r empty 0 -8 0 10 -262144 --258113 -1 0 256 0; -#X obj 133 105 nbx 3 14 0 255 0 0 \$0-dummy \$0-g empty 0 -8 0 10 -262144 --13381 -1 0 256 0; -#X obj 163 105 nbx 3 14 0 255 0 0 \$0-dummy \$0-b empty 0 -8 0 10 -262144 --4160 -1 0 256 0; -#X text 120 137 2.label; -#X obj 96 410 route 0 1; -#X obj 96 497 pack 0 0; -#X connect 1 0 2 0; -#X connect 1 1 2 1; -#X connect 2 0 3 0; -#X connect 3 0 4 0; -#X connect 3 1 4 1; -#X connect 4 0 8 0; -#X connect 5 0 4 0; -#X connect 6 0 2 0; -#X connect 7 0 1 0; -#X connect 8 0 9 0; -#X connect 9 0 17 0; -#X connect 10 0 18 0; -#X connect 10 1 18 1; -#X connect 11 0 9 1; -#X connect 13 0 5 0; -#X connect 14 0 6 0; -#X connect 15 0 7 0; -#X connect 17 0 18 0; -#X connect 17 1 10 0; -#X connect 18 0 0 0; -#X coords 0 -1 1 1 102 58 2 100 100; -#X restore 265 323 pd flash-time; -#X obj 165 534 list; -#X obj 165 483 bng 20 250 50 0 empty empty empty 17 7 0 10 -262144 --1 -1; -#X text 214 325 1.bg; -#X text 61 482 1.x-position; -#X text 61 504 2.y-position; -#X text 244 482 1.x-delta; -#X text 244 504 2.y-delta; -#N canvas 366 206 174 259 flash-time 0; -#X obj 68 180 pack; -#X obj 103 149 t b a; -#X obj 68 205 outlet; -#X obj 103 104 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-xpos empty 0 --8 0 12 -262144 -1 -1 310 256 0; -#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-ypos empty 0 --8 0 12 -262144 -1 -1 500 256 0; -#X connect 0 0 2 0; -#X connect 1 0 0 0; -#X connect 1 1 0 1; -#X connect 3 0 0 0; -#X connect 4 0 1 0; -#X coords 0 -1 1 1 48 42 2 100 100; -#X restore 13 483 pd flash-time; -#N canvas 366 206 174 259 flash-time 0; -#X obj 68 180 pack; -#X obj 103 149 t b a; -#X obj 68 205 outlet; -#X obj 103 104 nbx 3 14 -20 20 0 0 \$0-dummy \$0-xdelta empty 0 -8 -0 12 -262144 -1 -1 0 256 0; -#X obj 103 124 nbx 3 14 -20 20 0 0 \$0-dummy \$0-ydelta empty 0 -8 -0 12 -262144 -1 -1 0 256 0; -#X connect 0 0 2 0; -#X connect 1 0 0 0; -#X connect 1 1 0 1; -#X connect 3 0 0 0; -#X connect 4 0 1 0; -#X coords 0 -1 1 1 48 42 2 100 100; -#X restore 194 483 pd flash-time; -#X msg 27 322 get_pos; -#X obj 27 347 s cnv_rcv; -#X obj 165 433 s cnv_rcv; -#X obj 13 583 s cnv_rcv; -#X obj 165 583 s cnv_rcv; -#X obj 276 270 s cnv_rcv; -#X obj 134 270 s cnv_rcv; -#X obj 13 270 s cnv_rcv; -#X text 214 345 2.label; -#N canvas 375 166 157 260 init 0; -#X obj 16 11 loadbang; -#X obj 16 42 f \$0; -#X msg 16 72 \; \$1-width 100 \; \$1-height 60 \; \$1-xpos 310 \; \$1-ypos -500 \; \$1-xlabel 20 \; \$1-ylabel 12 \; \$1-dim 15 \; \$1-font 0 \; -\$1-font-size 14 \; \$1-bg 10 \; \$1-label 12; -#X connect 0 0 1 0; -#X connect 1 0 2 0; -#X restore 265 408 pd init; -#X obj 310 500 cnv 15 100 60 cnv_snd cnv_rcv my_canvas 20 12 0 14 -233017 --33289 0; -#X obj 27 370 r cnv_snd; -#X msg 165 408 color \$1 \$2; -#X obj 27 421 nbx 3 14 -1e+37 1e+37 0 0 empty empty empty 0 -8 0 12 --262144 -1 -1 0 256 0; -#X obj 90 421 nbx 3 14 -1e+37 1e+37 0 0 empty empty empty 0 -8 0 12 --262144 -1 -1 0 256 0; -#X msg 25 245 label my_canvas; -#X msg 204 109 send cnv_snd; -#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 [cnv] Changing Properties through Messages; -#X text 12 51 size; -#X text 12 38 selectable; -#X text 14 417 x; -#X text 76 418 y; -#X connect 0 0 61 0; -#X connect 0 1 62 0; -#X connect 2 0 4 0; -#X connect 3 0 2 0; -#X connect 5 0 9 0; -#X connect 9 0 10 0; -#X connect 15 0 13 0; -#X connect 16 0 14 0; -#X connect 18 0 17 0; -#X connect 22 0 55 0; -#X connect 23 0 54 0; -#X connect 24 0 53 0; -#X connect 29 0 23 0; -#X connect 30 0 24 0; -#X connect 33 0 51 0; -#X connect 34 0 52 0; -#X connect 37 0 60 0; -#X connect 38 0 60 0; -#X connect 39 0 34 0; -#X connect 40 0 39 0; -#X connect 46 0 33 0; -#X connect 47 0 39 1; -#X connect 48 0 49 0; -#X connect 59 0 0 0; -#X connect 60 0 50 0; -#X connect 63 0 55 0; -#X connect 64 0 13 0; -#X restore 170 407 pd Changing_GUI_Properties; -#N canvas 103 143 428 369 canvas-creation-arguments 0; -#X msg 23 43 canvas: cnv selectableSize xSize ySize sendName recieveName -Label labelXOff labelYOff Font# fontSize bgColor lblColor 0; -#X text 20 80 Canvas can be called with 13 creation arguments. These -are not "optional" - all parameters must be filled or the canvas will -not instantiate correctly.; -#X text 20 125 The function of the final "0" is unknown to me (it is -found in the textual entry for a canvas object in a .pd file) but can -be safely left off without ill effects.; -#X text 20 167 For example \, click the msg-box to dynamically create -a cnv:; -#X obj 23 237 s pd-canvas-creation-arguments; -#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 [cnv] Creation Arguments and Dynamic Patching; -#X msg 23 195 obj 110 260 cnv 15 200 100 myCanvas myCanvasR Alcyone -75 12 2 14 -261441 12; -#X connect 7 0 4 0; -#X restore 171 518 pd canvas-creation-arguments; -#X text 168 463 - creating a [cnv] without any arguments will set default -values for all gui-properties. See the subpatch below to learn how -to dynamically instantiate a [cnv] object with custom properties:; -#X floatatom 338 318 4 0 0 0 - - -, f 4; -#X floatatom 382 318 4 0 0 0 - - -, f 4; -#X text 349 334 x; -#X text 393 334 y; -#X obj 435 170 metro 100; -#X obj 435 150 tgl 15 1 empty empty empty 20 8 0 10 -262144 -1 -1 1 -1; -#X obj 338 270 r from_K1; -#X floatatom 435 318 4 0 0 0 - - -, f 4; -#X floatatom 479 318 4 0 0 0 - - -, f 4; -#X text 445 334 x; -#X text 490 334 y; -#X obj 435 270 r from_K2; -#N canvas 8 328 313 315 room 0; -#X obj 6 7 cnv 15 300 300 empty empty type...ctrl+e 100 140 2 17 -33289 --24198 0; -#X obj 26 27 cnv 1 1 264 empty empty move_K1_and_K2 65 160 2 17 -166441 --24198 0; -#X obj 287 30 cnv 1 1 261 empty empty empty 20 12 2 20 -99865 -66577 -0; -#X obj 27 27 cnv 1 260 1 empty empty empty 20 12 2 20 -166441 -66577 -0; -#X obj 28 291 cnv 1 260 1 empty empty empty 20 12 2 20 -99865 -66577 -0; -#X obj 38 40 cnv 25 25 25 from_K1 to_K K1 1 13 2 14 -261681 -123526 -0; -#X obj 251 255 cnv 25 25 25 from_K2 to_K K2 1 13 2 14 -225280 -1109 -0; -#X restore 128 171 pd room; -#X obj 338 294 unpack; -#X obj 435 294 unpack; -#X text 17 147 Click the subwindow below to use a cnv as a control -surface:; -#X obj 20 61 cnv 15 100 60 empty empty label 20 12 0 14 -233017 -66577 -0; -#X text 128 58 Colored rectangle with a label. Right-click in the top-left -corner of the gray rectangle to the left and click "properties" to -change the object's appearance.; -#X text 127 110 The blue rectangle at the top of each help patch is -a [cnv] \, as are the horizontal dividers below.; -#X text 98 463 13; -#X text 207 564 IEM KUG; -#X text 182 576 graz \, austria 2002; -#X msg 435 192 get_pos; -#X obj 435 214 send to_K; -#X obj 4 641 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#N canvas 405 89 483 507 (subpatch) 0; -#X msg 144 296 bang; -#X msg 144 321 1 30; -#X obj 144 409 line~; -#X obj 202 301 del 30; -#X obj 61 433 *~; -#X obj 62 485 dac~; -#X obj 62 359 osc~ 880; -#X obj 62 403 clip~ -1 1; -#X obj 35 220 list split 1; -#X obj 15 311 list; -#X obj 35 244 t b a; -#X obj 62 334 mtof; -#X obj 62 457 *~ 0.07; -#X obj 207 128 metro 50; -#X obj 207 202 s \$0-cnv; -#X obj 207 106 0; -#X obj 207 84 del 3000; -#X obj 310 170 f; -#X obj 342 170 + 1; -#X obj 35 12 r \$0-bng; -#X obj 106 14 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 -1 --1; -#X obj 310 197 div 13; -#X msg 310 314 color \$1 0; -#X obj 242 105 tgl 15 0 empty empty empty 17 7 0 10 -262144 -1 -1 0 -1; -#X obj 279 86 sel 0; -#X obj 279 107 -1; -#X obj 279 130 t a; -#X obj 207 155 f -1; -#X msg 207 180 delta 0 \$1; -#X obj 35 44 spigot 1; -#X obj 35 76 t a b; -#X obj 96 55 0; -#X obj 130 55 1; -#X obj 310 220 sel 3 4; -#X msg 371 246 5 \$1; -#X obj 371 268 -; -#X msg 310 246 1; -#X obj 340 245 f 2; -#X obj 383 170 sel 1; -#X msg 377 198 0; -#X msg 411 199 2; -#X obj 62 311 + 68; -#X obj 15 284 del 170; -#X text 167 14 IT'S A SECRET TO EVERYBODY.; -#X obj 56 106 loadbang; -#X obj 35 174 list; -#X obj 114 217 s \$0-randomize; -#X obj 71 149 r \$0-new-secret; -#X msg 56 128 7 1 0 8 12 16; -#X obj 35 197 list prepend 11 10; -#X obj 62 381 *~ 1.4; -#X msg 202 323 0 400; -#X connect 0 0 1 0; -#X connect 0 0 3 0; -#X connect 1 0 2 0; -#X connect 2 0 4 1; -#X connect 3 0 51 0; -#X connect 4 0 12 0; -#X connect 6 0 50 0; -#X connect 7 0 4 0; -#X connect 8 0 10 0; -#X connect 8 1 9 1; -#X connect 9 0 8 0; -#X connect 10 0 42 0; -#X connect 10 1 0 0; -#X connect 10 1 41 0; -#X connect 11 0 6 0; -#X connect 12 0 5 0; -#X connect 12 0 5 1; -#X connect 13 0 17 0; -#X connect 13 0 27 0; -#X connect 15 0 13 0; -#X connect 15 0 17 1; -#X connect 16 0 15 0; -#X connect 16 0 23 0; -#X connect 16 0 32 0; -#X connect 17 0 18 0; -#X connect 17 0 21 0; -#X connect 18 0 17 1; -#X connect 19 0 29 0; -#X connect 20 0 29 0; -#X connect 21 0 33 0; -#X connect 22 0 14 0; -#X connect 23 0 24 0; -#X connect 23 0 38 0; -#X connect 24 0 25 0; -#X connect 24 1 26 0; -#X connect 25 0 26 0; -#X connect 26 0 27 1; -#X connect 27 0 28 0; -#X connect 28 0 14 0; -#X connect 29 0 30 0; -#X connect 30 0 13 0; -#X connect 30 0 16 0; -#X connect 30 0 45 0; -#X connect 30 1 31 0; -#X connect 31 0 29 1; -#X connect 32 0 29 1; -#X connect 33 0 36 0; -#X connect 33 1 37 0; -#X connect 33 2 34 0; -#X connect 34 0 35 0; -#X connect 35 0 22 0; -#X connect 36 0 22 0; -#X connect 37 0 22 0; -#X connect 38 0 39 0; -#X connect 38 1 40 0; -#X connect 39 0 37 1; -#X connect 40 0 37 1; -#X connect 41 0 11 0; -#X connect 42 0 9 0; -#X connect 44 0 48 0; -#X connect 45 0 46 0; -#X connect 45 0 49 0; -#X connect 47 0 45 1; -#X connect 48 0 45 1; -#X connect 49 0 8 0; -#X connect 50 0 7 0; -#X connect 51 0 2 0; -#X coords 0 -1 1 1 15 15 2 100 100; -#X restore 71 330 pd; -#X obj 169 553 bng 14 250 50 0 \$0-bng empty empty 4 7 0 12 -262144 --262144 -1; -#X text 66 275 You can also use a white [cnv] to; -#X text 66 290 conceal parts of a patch (use; -#X text 66 305 with care); -#X text 185 551 musil@iem.kug.ac.at; -#X text 171 550 c; -#X obj 63 267 cnv 15 210 70 empty \$0-cnv empty 20 12 0 14 -262144 --262144 0; -#X obj 69 329 cnv 15 17 17 empty empty empty 20 12 0 14 -262144 -66577 -0; -#X text 244 191 send it a "get_pos" message ->; -#X text 244 176 To get a cnv position \,; -#X text 325 551 Note: [cnv] is not to be confused; -#X text 325 564 with the Pd canvas \, or [pd] \,; -#X text 325 577 [table] \, etc.; -#X text 66 233 enable the edit mode and selectthe area below to see -how you canuse cnv to hide things; -#N canvas 597 433 432 210 using_canvas_to_hide_objects_that_capture_mouse_clicks -0; -#X obj 100 47 tgl 43 0 empty empty empty 17 7 0 10 -262144 -1 -1 0 -1; -#X obj 81 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 -0 14 -204280 -1 0; -#X text 88 2 Using [cnv] to hide objects that capture mouse clicks -; -#X obj 100 47 cnv 15 43 43 empty empty CLICK 6 22 0 10 -247832 -66577 -0; -#X obj 100 109 tgl 21 0 empty empty empty 17 7 0 10 -262144 -1 -1 0 -1; -#X text 167 46 Try clicking on the [cnv] object to the left.Notice -how the [cnv] on the left seemingly exhibitstoggle-like behavior. -In fact \, it is not the [cnv]that is responsible for toggle changing -its state.Rather \, it is another toggle button that is hiddenunder -the [cnv] object that does this. This ispossible bacause unlike any -other iemgui objects \, [cnv] does not capture runtime clicks and -insteadpasses them to objects below it.; -#X connect 0 0 4 0; -#X restore 169 608 pd using_canvas_to_hide_objects_that_capture_mouse_clicks -; -#X connect 21 0 39 0; -#X connect 22 0 21 0; -#X connect 23 0 30 0; -#X connect 28 0 31 0; -#X connect 30 0 17 0; -#X connect 30 1 18 0; -#X connect 31 0 24 0; -#X connect 31 1 25 0; -#X connect 39 0 40 0; diff --git a/doc/pddp/namecanvas-help.pd b/doc/pddp/namecanvas-help.pd deleted file mode 100644 index 1f5ee68e8..000000000 --- a/doc/pddp/namecanvas-help.pd +++ /dev/null @@ -1,53 +0,0 @@ -#N canvas 429 35 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 namecanvas 3 12 -0 18 -204280 -1 0; -#X obj 0 450 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 483 286 494 344 META 0; -#X text 12 65 LIBRARY internal; -#X text 12 105 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 85 AUTHOR Miller Puckette; -#X text 12 145 HELP_PATCH_AUTHORS Updated for Pd version 0.40. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 45 DESCRIPTION attach a canvas to a name; -#X text 12 5 KEYWORDS control canvas_op; -#X text 12 125 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 478 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 505 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 568 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 219 517 428 109 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 [namecanvas] Related Objects; -#X obj 19 43 pddp/helplink iemguts/sendcanvas; -#X restore 102 597 pd Related_objects; -#X obj 477 11 namecanvas; -#X obj 120 153 namecanvas \$0-bonzo; -#X obj 120 210 s \$0-bonzo; -#X text 98 454 (none); -#X text 98 482 (none); -#X obj 120 366 s pd-namecanvas-help.pd; -#X text 11 23 attach a canvas to a name; -#X text 168 523 - sets the name to associate with this canvas. Any -messages sent to this name will be forwarded to the canvas containing -this [namecanvas] object.; -#X msg 120 186 msg 50 50 Hi there. This works locally.; -#X msg 120 338 msg 50 70 This works globally.; -#X text 78 523 1) symbol atom; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X text 120 240 If you open another instance of this help patch \, -you'll see that clicking the message box above will create an object -on the canvas where you click.; -#X text 119 294 The following is similar \, but it will create an object -in each "namecanvas-help.pd" patch that you have open:; -#X connect 16 0 10 0; -#X connect 17 0 13 0; diff --git a/doc/pddp/netreceive-help.pd b/doc/pddp/netreceive-help.pd deleted file mode 100644 index 04df2dc0b..000000000 --- a/doc/pddp/netreceive-help.pd +++ /dev/null @@ -1,94 +0,0 @@ -#N canvas 428 33 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 netreceive 3 12 -0 18 -204280 -1 0; -#X obj 0 311 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 481 282 494 344 META 0; -#X text 12 105 LIBRARY internal; -#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 125 AUTHOR Miller Puckette; -#X text 12 185 HELP_PATCH_AUTHORS Updated for Pd v0.41. Revised by -Jonathan Wilkes to conform to the PDDP template for Pd version 0.42. -; -#X text 12 5 KEYWORDS control network; -#X text 12 45 DESCRIPTION listen for incoming messages from a network -; -#X text 12 65 OUTLET_0 anything; -#X text 12 85 OUTLET_1 float; -#X text 12 165 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 338 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 419 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 558 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 216 518 428 109 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 [netreceive] Related Objects; -#X obj 16 35 netsend; -#X obj 70 35 disis_netsend; -#X obj 160 35 disis_netreceive; -#X restore 102 598 pd Related_objects; -#X obj 78 347 cnv 17 3 25 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 80 439 1) float; -#X obj 476 10 netreceive; -#X floatatom 226 82 0 0 0 0 - - -; -#X obj 139 145 netreceive 3001 1; -#X obj 139 82 print tcp; -#X obj 139 166 print udp; -#N canvas 57 331 428 261 About_netreceive 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 [netreceive] More Info; -#X text 21 38 The [netreceive] object opens a socket for TCP ("stream") -or UDP ("datagram") network reception on a specified port. If using -TCP \, an outlet gives you the number of [netsend] objects (or other -compatible clients) have opened connections here.; -#X text 20 170 There are some possibilities for intercommunication -with other programs... see the help for [netsend].; -#X text 19 104 Incoming network messages appear at the left inlet of -the [netreceive] object. (They used to be received by [receive] objects -\, in which case it was up to the sender to select which one). To test -the object you can send messages from the [netsend] help window.; -#X text 18 208 SECURITY ALERT: the port that netreceive opens has no -access restrictions \, so anyone can connect to it and send messages. -; -#X restore 102 567 pd About_netreceive; -#X text 11 23 listen for incoming messages from a network; -#X text 168 454 - (optional) 0 for TCP \, nonzero for UDP. (Default -is TCP.); -#X text 168 439 - (optional) port number.; -#X text 80 454 2) float; -#X text 168 469 - if you set the third argument to the word "old" \, -everything sent to the specified port is received into the global message -space. This is the original behavior of [netreceive]. This can be VERY -INSECURE since it gives someone full access to your computer \, allowing -them to do anything that Pd can via the network.; -#X text 98 270 Old behavior: [netreceive 4567 0 old] (see argument -3 below); -#X text 80 469 3) symbol atom; -#X text 98 346 anything; -#X obj 78 383 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 382 float; -#X text 264 60 <- TCP \, port 3000; -#X text 261 144 <- UDP \, port 3001; -#X text 98 205 You can send messages from the [netsend] objects in -the help patch for [netsend].; -#X text 168 346 - any message received by this [netreceive] object -will be sent to the left outlet.; -#X text 98 314 (none); -#X obj 139 61 netreceive 3000; -#X text 168 382 - when using TCP \, the [netreceive] object has a right -inlet which shows the number of open connections.; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X connect 12 0 14 0; -#X connect 31 0 13 0; -#X connect 31 1 11 0; diff --git a/doc/pddp/netsend-help.pd b/doc/pddp/netsend-help.pd deleted file mode 100644 index ab06e6038..000000000 --- a/doc/pddp/netsend-help.pd +++ /dev/null @@ -1,113 +0,0 @@ -#N canvas 398 77 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 netsend 3 12 0 18 --204280 -1 0; -#X obj 0 348 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 46 242 494 344 META 0; -#X text 12 105 LIBRARY internal; -#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 125 AUTHOR Miller Puckette; -#X text 12 185 HELP_PATCH_AUTHORS Updated for Pd v0.41. Revised by -Jonathan Wilkes to conform to the PDDP template for Pd version 0.42. -; -#X text 12 5 KEYWORDS control network; -#X text 12 45 DESCRIPTION send Pd messages over a network; -#X text 12 65 INLET_0 connect disconnect send; -#X text 12 85 OUTLET_0 float; -#X text 12 165 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 478 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 515 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 558 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 54 478 428 109 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 [netsend] Related Objects; -#X obj 11 34 netreceive; -#X obj 83 34 disis_netsend; -#X obj 173 34 disis_netreceive; -#X restore 102 598 pd Related_objects; -#X obj 78 357 cnv 17 3 110 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 486 float; -#X obj 78 487 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 11 23 send Pd messages over a network; -#X obj 445 20 pddp/pddplink http://wiki.puredata.info/en/netsend -text -pdpedia: netsend; -#X obj 473 3 netsend; -#X obj 15 238 netsend; -#X msg 15 79 connect localhost 3000; -#X msg 23 213 send foo \$1; -#X floatatom 23 186 0 0 0 0 - - -; -#X msg 15 160 disconnect; -#X msg 186 213 send foo \$1; -#X floatatom 186 186 0 0 0 0 - - -; -#X msg 178 160 disconnect; -#X obj 178 238 netsend 1; -#X msg 178 79 connect localhost 3001; -#X floatatom 15 265 0 0 0 0 - - -; -#X floatatom 178 265 0 0 0 0 - - -; -#X text 66 58 TCP; -#X text 253 55 UDP; -#X text 325 79 Connect to "localhost" port 3000/3001; -#X text 253 161 Close the connection; -#X text 215 188 Send messages to "foo" on remote machine; -#X text 12 294 Outlet is nonzero if connection is open \, zero otherwise. -; -#X msg 15 106 connect molloy 3000; -#X msg 178 106 connect molloy 3001; -#X msg 15 133 connect bug 3000; -#X msg 178 133 connect bug 3000; -#X text 98 356 connect; -#X text 98 413 disconnect; -#X text 98 443 send; -#X text 168 486 - nonzero if the connection is open \, zero otherwise. -; -#N canvas 55 339 428 233 About_netsend 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 [netsend] More Info; -#X text 20 39 The [netsend] object connects to another machine over -the network for sending TCP ("stream") or UDP ("datagram") messages. -An outlet reports whether the connection is open or not. A connection -request should specify the name or IP address of the other host and -the port number. There should be a [netreceive] object on the remote -host with a matching port number.; -#X text 20 148 The Linux version of Pd comes with "pdsend" and "pdreceive" -standalone programs. These haven't been tested in Windows yet (but -the source is included in the Pd distribution).; -#X restore 102 567 pd About_netsend; -#X text 80 535 1) float; -#X text 168 535 - (optional) 0 for TCP \, nonzero for UDP. (Default -is TCP.); -#X text 168 413 - disconnect from the remote machine. When it is disconnected -\, a "0" is sent to the outlet.; -#X text 168 443 - after successfully connecting \, use the "send" message -to forward data to the remote machine.; -#X text 168 356 - use the "connect" message to connect to the specified -remote machine-- providing its name or IP address-- on the specified -port (e.g. \, "connect localhost 3000"). A "1" is output if the connection -is successful.; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X connect 14 0 24 0; -#X connect 15 0 14 0; -#X connect 16 0 14 0; -#X connect 17 0 16 0; -#X connect 18 0 14 0; -#X connect 19 0 22 0; -#X connect 20 0 19 0; -#X connect 21 0 22 0; -#X connect 22 0 25 0; -#X connect 23 0 22 0; -#X connect 32 0 14 0; -#X connect 33 0 22 0; -#X connect 34 0 14 0; -#X connect 35 0 22 0; diff --git a/doc/pddp/noise~-help.pd b/doc/pddp/noise~-help.pd deleted file mode 100644 index 6e4c3cb25..000000000 --- a/doc/pddp/noise~-help.pd +++ /dev/null @@ -1,62 +0,0 @@ -#N canvas 429 34 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 noise~ 3 12 0 18 --204280 -1 0; -#X obj 0 466 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 481 283 494 344 META 0; -#X text 12 105 LIBRARY internal; -#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 125 AUTHOR Miller Puckette; -#X text 12 185 HELP_PATCH_AUTHORS Updated for Pd version 0.33. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 45 DESCRIPTION uniformly distributed white noise; -#X text 12 65 INLET_0; -#X text 12 85 OUTLET_0 signal; -#X text 12 165 RELEASE_DATE 1997; -#X text 12 5 KEYWORDS signal random; -#X restore 500 597 pd META; -#X obj 0 503 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 540 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 567 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#X text 98 544 (none); -#N canvas 216 518 428 109 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 [noise~] Related Objects; -#X obj 22 43 random; -#X restore 102 597 pd Related_objects; -#X obj 78 475 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 512 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 500 10 noise~; -#X floatatom 218 284 4 0 0 0 - - -, f 4; -#X obj 218 217 noise~; -#X obj 284 256 print~; -#X obj 218 256 env~ 4096; -#X text 216 192 the output range is -1 to 1...; -#X obj 152 256 snapshot~; -#X floatatom 152 283 0 0 0 0 - - -; -#X msg 152 229 bang; -#X msg 284 229 bang; -#X text 168 474 - the inlet to [noise~] is not used.; -#X text 98 511 signal; -#X text 11 23 uniformly distributed white noise; -#X text 98 474 (inactive); -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 480 53 pddp/dsp; -#X connect 13 0 14 0; -#X connect 13 0 15 0; -#X connect 13 0 17 0; -#X connect 15 0 12 0; -#X connect 17 0 18 0; -#X connect 19 0 17 0; -#X connect 20 0 14 0; diff --git a/doc/pddp/numbox2-help.pd b/doc/pddp/numbox2-help.pd deleted file mode 100644 index 74e83adb0..000000000 --- a/doc/pddp/numbox2-help.pd +++ /dev/null @@ -1,424 +0,0 @@ -#N canvas 433 38 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 nbx 3 12 0 18 -204280 --1 0; -#X obj 0 260 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 490 290 494 344 META 0; -#X text 12 155 LIBRARY internal; -#X text 12 65 LICENSE SIBSD; -#X text 12 175 AUTHOR Thomas Musil; -#X text 12 195 WEBSITE; -#X text 12 235 HELP_PATCH_AUTHORS Jonathan Wilkes revised the patch -to conform to the PDDP template for Pd version 0.42.; -#X text 12 45 KEYWORDS control storage GUI nonlocal; -#X text 12 85 DESCRIPTION gui-number box; -#X text 12 5 NAME nbx; -#X text 12 25 ALIAS my_numbox; -#X text 12 135 OUTLET_0 float; -#X text 12 105 INLET_0 float bang set size range log init log_height -send receive label label_pos label_font color pos delta; -#X text 12 215 RELEASE_DATE 2002; -#X restore 500 597 pd META; -#X obj 0 425 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 462 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 547 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 219 507 428 128 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 [nbx] Related Objects; -#X floatatom 22 43 5 0 0 0 - - -, f 5; -#X obj 62 43 float; -#X obj 106 43 int; -#X obj 20 90 x_all_guis bng tgl vsl hsl hradio vradio vu cnv nbx; -#X text 18 66 All iem-gui objects:; -#X restore 102 597 pd Related_objects; -#X obj 78 269 cnv 17 3 140 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 268 float; -#X text 98 338 list; -#X text 98 433 float; -#X obj 78 434 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X floatatom 28 175 6 0 0 0 - - -, f 6; -#X msg 57 94 set \$1; -#X floatatom 48 49 6 0 0 0 - - -, f 6; -#X obj 28 199 bng 15 250 50 0 empty empty empty 8 -8 0 10 -262144 -1 --1; -#X obj 28 49 bng 15 250 50 0 empty empty empty 8 -8 0 10 -262144 -1 --1; -#X floatatom 57 71 4 0 0 0 - - -, f 4; -#X floatatom 108 49 6 0 0 0 - - -, f 6; -#X floatatom 366 48 7 0 0 0 - - -, f 7; -#X obj 241 159 ftom; -#X floatatom 241 183 4 0 0 0 - - -, f 4; -#X floatatom 287 159 9 0 0 0 - - -, f 9; -#X floatatom 366 120 9 0 0 0 - - -, f 9; -#X floatatom 241 63 4 0 0 0 - - -, f 4; -#X obj 241 85 mtof; -#X text 104 151 (0.01 pixels); -#X msg 108 71 set \$1; -#X text 106 120 shift-click & drag; -#X text 107 135 for fine-tuning; -#X obj 77 199 print; -#N canvas 133 180 290 126 once 0; -#X obj 38 24 inlet; -#X obj 38 80 outlet; -#X obj 38 53 spigot 1; -#X msg 102 53 0; -#X connect 0 0 2 0; -#X connect 2 0 3 0; -#X connect 2 0 1 0; -#X connect 3 0 2 1; -#X restore 77 175 pd once; -#X obj 108 93 s foo13_rcv; -#X obj 366 71 s goo14_rcv; -#X obj 366 96 r goo14_snd; -#X obj 28 135 nbx 6 15 -1e+37 1e+37 0 0 foo13_snd foo13_rcv empty 45 -7 0 10 -225280 -1109 -1 0 256 0; -#X obj 241 128 nbx 5 18 55 3520 1 0 goo14_snd goo14_rcv log.freq. 10 --10 0 14 -261234 -159808 -90881 55 72 0; -#X text 363 157 and receive names. Right-; -#X text 363 172 click and choose; -#X text 362 141 [nbx] has settable send; -#X obj 466 48 nbx 5 14 -1e+37 1e+37 0 0 empty empty empty 0 -8 0 10 --262144 -1 -1 0 256 0; -#X text 168 268 - a float to the left inlet will be displayed \, stored -\, and sent to the outlet.; -#X text 168 338 - a list will be truncated to the first item.; -#X text 98 311 set; -#X text 168 311 - sending a set message followed by a value (e.g. \, -"set 14") will display and store the value without outputting it.; -#X text 97 360 see the following subpatch for messages that change -the gui-properties of [nbx]:; -#N canvas 49 27 446 599 Changing_GUI_Properties 0; -#X text 17 152 log height; -#X text 340 24 no init; -#X msg 350 94 init 1; -#X msg 340 43 init 0; -#X msg 242 64 lin; -#X msg 252 94 log; -#X text 238 24 linear/; -#X text 238 39 logarithmical; -#X text 349 58 init value; -#X text 350 73 on loadbang; -#X obj 242 119 s nbx_rcv; -#X obj 340 119 s nbx_rcv; -#X msg 17 175 log_height 256; -#X obj 17 245 s nbx_rcv; -#X text 346 152 label; -#X msg 346 172 label blabla; -#X text 115 153 change send name; -#X text 220 152 change receive name; -#X obj 117 245 s nbx_rcv; -#X obj 223 245 s nbx_rcv; -#X obj 346 245 s nbx_rcv; -#X msg 117 175 send nbx1_snd; -#X msg 127 200 send nbx_snd; -#X obj 231 222 s z_rcv; -#X msg 223 174 receive z_rcv; -#X msg 231 199 receive nbx_rcv; -#N canvas 372 228 161 250 init 0; -#X obj 16 11 loadbang; -#X obj 16 42 f \$0; -#X msg 16 73 \; \$1-xpos 320 \; \$1-ypos 330 \; \$1-xlabel 0 \; \$1-ylabel --8 \; \$1-font-size 10 \; \$1-width 5 \; \$1-height 14 \; \$1-bg 0 -\; \$1-front 12 \; \$1-label 12; -#X connect 0 0 1 0; -#X connect 1 0 2 0; -#X restore 360 400 pd init; -#N canvas 366 206 174 259 flash-time 0; -#X obj 68 180 pack; -#X obj 103 149 t b a; -#X obj 68 205 outlet; -#X obj 103 104 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-bottom empty -0 -8 0 12 -262144 -1 -1 0 256 0; -#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-top empty 0 --8 0 12 -262144 -1 -1 0 256 0; -#X connect 0 0 2 0; -#X connect 1 0 0 0; -#X connect 1 1 0 1; -#X connect 3 0 0 0; -#X connect 4 0 1 0; -#X coords 0 -1 1 1 48 42 2 100 100; -#X restore 124 44 pd flash-time; -#X text 121 23 output-range; -#X text 173 46 1.bottom; -#X text 173 66 2.top; -#X msg 124 94 range \$1 \$2; -#X obj 124 118 s nbx_rcv; -#X text 15 280 label position; -#X text 137 280 font properties; -#X msg 17 387 label_pos \$1 \$2; -#X msg 139 387 label_font \$1 \$2; -#X text 188 304 1.font(0-2); -#X text 188 325 2.height; -#X text 66 303 1.x-offset; -#X text 66 324 2.y-offset; -#N canvas 366 206 174 259 flash-time 0; -#X obj 68 180 pack; -#X obj 103 149 t b a; -#X obj 68 205 outlet; -#X obj 103 104 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-xlabel empty -0 -8 0 12 -262144 -1 -1 0 256 0; -#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-ylabel empty -0 -8 0 12 -262144 -1 -1 -8 256 0; -#X connect 0 0 2 0; -#X connect 1 0 0 0; -#X connect 1 1 0 1; -#X connect 3 0 0 0; -#X connect 4 0 1 0; -#X coords 0 -1 1 1 48 42 2 100 100; -#X restore 17 302 pd flash-time; -#N canvas 366 206 174 259 flash-time 0; -#X obj 68 180 pack; -#X obj 103 149 t b a; -#X obj 68 205 outlet; -#X obj 103 104 nbx 3 14 0 2 0 0 \$0-dummy \$0-font empty 0 -8 0 12 --262144 -1 -1 0 256 0; -#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-font-size empty -0 -8 0 12 -262144 -1 -1 10 256 0; -#X connect 0 0 2 0; -#X connect 1 0 0 0; -#X connect 1 1 0 1; -#X connect 3 0 0 0; -#X connect 4 0 1 0; -#X coords 0 -1 1 1 48 42 2 100 100; -#X restore 139 302 pd flash-time; -#X text 18 445 preset-colors; -#X text 119 445 RGB-colors; -#X msg 18 552 color \$1 \$2 \$3; -#N canvas 364 205 306 317 flash-time 0; -#X obj 69 196 t b a; -#X obj 33 262 outlet; -#X obj 33 237 pack 0 0 0; -#X obj 120 197 t b a; -#X obj 103 104 nbx 3 14 0 29 0 0 \$0-dummy \$0-bg empty 0 -8 0 12 -262144 --1 -1 0 256 0; -#X obj 103 124 nbx 3 14 0 29 0 0 \$0-dummy \$0-front empty 0 -8 0 12 --262144 -1 -1 12 256 0; -#X obj 103 144 nbx 3 14 0 29 0 0 \$0-dummy \$0-label empty 0 -8 0 12 --262144 -1 -1 12 256 0; -#X connect 0 0 2 0; -#X connect 0 1 2 1; -#X connect 2 0 1 0; -#X connect 3 0 2 0; -#X connect 3 1 2 2; -#X connect 4 0 2 0; -#X connect 5 0 0 0; -#X connect 6 0 3 0; -#X coords 0 -1 1 1 48 62 2 100 100; -#X restore 18 467 pd flash-time; -#N canvas 0 0 306 317 flash-time 0; -#X obj 96 521 outlet; -#X obj 162 230 t b f; -#X obj 96 268 +; -#X obj 96 293 t b f; -#X obj 96 324 +; -#X obj 19 208 * -65536; -#X obj 96 208 * -256; -#X obj 162 208 * -1; -#X obj 96 355 - 1; -#X obj 96 385 list prepend 0; -#X obj 96 410 route 0 1 2; -#X obj 96 497 pack 0 0 0; -#X obj 115 456 t b a; -#X obj 168 455 t b a; -#X obj 104 124 vradio 15 1 0 3 empty empty empty 0 -8 0 10 -262144 --1 -1 0; -#X text 120 120 1.bg; -#X text 120 137 2.front; -#X text 120 153 3.label; -#X obj 103 105 nbx 3 14 0 255 0 0 \$0-dummy \$0-r empty 0 -8 0 10 -262144 --258113 -1 0 256 0; -#X obj 133 105 nbx 3 14 0 255 0 0 \$0-dummy \$0-g empty 0 -8 0 10 -262144 --13381 -1 0 256 0; -#X obj 163 105 nbx 3 14 0 255 0 0 \$0-dummy \$0-b empty 0 -8 0 10 -262144 --4160 -1 0 256 0; -#X connect 1 0 2 0; -#X connect 1 1 2 1; -#X connect 2 0 3 0; -#X connect 3 0 4 0; -#X connect 3 1 4 1; -#X connect 4 0 8 0; -#X connect 5 0 4 0; -#X connect 6 0 2 0; -#X connect 7 0 1 0; -#X connect 8 0 9 0; -#X connect 9 0 10 0; -#X connect 10 0 11 0; -#X connect 10 1 12 0; -#X connect 10 2 13 0; -#X connect 11 0 0 0; -#X connect 12 0 11 0; -#X connect 12 1 11 1; -#X connect 13 0 11 0; -#X connect 13 1 11 2; -#X connect 14 0 9 1; -#X connect 18 0 5 0; -#X connect 19 0 6 0; -#X connect 20 0 7 0; -#X coords 0 -1 1 1 102 74 2 100 100; -#X restore 120 467 pd flash-time; -#X text 67 469 1.bg; -#X text 67 489 2.front; -#X text 67 510 3.label; -#X text 348 445 delta; -#X text 236 445 position; -#X msg 237 540 pos \$1 \$2; -#X msg 349 540 delta \$1 \$2; -#X obj 349 516 list; -#X obj 349 467 bng 20 250 50 0 empty empty empty 17 7 0 10 -262144 --1 -1; -#N canvas 366 206 174 259 flash-time 0; -#X obj 68 180 pack; -#X obj 103 149 t b a; -#X obj 68 205 outlet; -#X obj 103 104 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-xpos empty 0 --8 0 12 -262144 -1 -1 320 256 0; -#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-ypos empty 0 --8 0 12 -262144 -1 -1 330 256 0; -#X connect 0 0 2 0; -#X connect 1 0 0 0; -#X connect 1 1 0 1; -#X connect 3 0 0 0; -#X connect 4 0 1 0; -#X coords 0 -1 1 1 48 42 2 100 100; -#X restore 237 467 pd flash-time; -#N canvas 366 206 174 259 flash-time 0; -#X obj 68 180 pack; -#X obj 103 149 t b a; -#X obj 68 205 outlet; -#X obj 103 104 nbx 3 14 -20 20 0 0 \$0-dummy \$0-xdelta empty 0 -8 -0 12 -262144 -1 -1 0 256 0; -#X obj 103 124 nbx 3 14 -20 20 0 0 \$0-dummy \$0-ydelta empty 0 -8 -0 12 -262144 -1 -1 0 256 0; -#X connect 0 0 2 0; -#X connect 1 0 0 0; -#X connect 1 1 0 1; -#X connect 3 0 0 0; -#X connect 4 0 1 0; -#X coords 0 -1 1 1 48 42 2 100 100; -#X restore 378 467 pd flash-time; -#X obj 304 291 cnv 15 92 92 empty empty empty 20 12 0 14 -1 -66577 -0; -#X obj 305 292 cnv 15 90 90 empty empty empty 20 12 0 14 -261682 -66577 -0; -#X obj 320 330 nbx 5 14 -1e+37 1e+37 0 0 nbx_snd nbx_rcv my_nbx 0 -8 -0 10 -262144 -33289 -33289 0 256 0; -#X obj 17 412 s nbx_rcv; -#X obj 139 412 s nbx_rcv; -#X obj 18 577 s nbx_rcv; -#X obj 349 577 s nbx_rcv; -#X obj 237 577 s nbx_rcv; -#N canvas 366 206 174 259 flash-time 0; -#X obj 68 180 pack; -#X obj 103 149 t b a; -#X obj 68 205 outlet; -#X obj 103 104 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-width empty -0 -8 0 12 -262144 -1 -1 5 256 0; -#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-height empty -0 -8 0 12 -262144 -1 -1 14 256 0; -#X connect 0 0 2 0; -#X connect 1 0 0 0; -#X connect 1 1 0 1; -#X connect 3 0 0 0; -#X connect 4 0 1 0; -#X coords 0 -1 1 1 48 42 2 100 100; -#X restore 17 44 pd flash-time; -#X obj 17 118 s nbx_rcv; -#X text 66 46 1.width; -#X text 66 66 2.height; -#X text 14 23 dimensions; -#X msg 17 94 size \$1 \$2; -#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 [nbx] Changing GUI Properties through Messages; -#X msg 356 197 label my_nbx; -#X text 285 466 1.x-pos; -#X text 285 488 2.y-pos; -#X connect 2 0 11 0; -#X connect 3 0 11 0; -#X connect 4 0 10 0; -#X connect 5 0 10 0; -#X connect 12 0 13 0; -#X connect 15 0 20 0; -#X connect 21 0 18 0; -#X connect 22 0 18 0; -#X connect 24 0 19 0; -#X connect 25 0 23 0; -#X connect 27 0 31 0; -#X connect 31 0 32 0; -#X connect 35 0 62 0; -#X connect 36 0 63 0; -#X connect 41 0 35 0; -#X connect 42 0 36 0; -#X connect 45 0 64 0; -#X connect 46 0 45 0; -#X connect 47 0 45 0; -#X connect 53 0 66 0; -#X connect 54 0 65 0; -#X connect 55 0 54 0; -#X connect 56 0 55 0; -#X connect 57 0 53 0; -#X connect 58 0 55 1; -#X connect 67 0 72 0; -#X connect 72 0 68 0; -#X connect 75 0 20 0; -#X restore 170 394 pd Changing_GUI_Properties; -#N canvas 73 200 428 314 nbx-creation-arguments 0; -#X text 21 37 "nbx" can be called with 18 creation arguments. These -are not "optional" - all parameters must be filled or the gui-bng will -not instantiate correctly.; -#X text 21 171 For example \, click the msg-box to dynamically create -an nbx:; -#X obj 22 235 s pd-nbx-creation-arguments; -#X text 22 97 nbx creation arguments: xSize ySize rangeBtm rangeTop -Logarithmic Init sendName receiveName Label labelXOff labelYOff Font# -fontsize bgColor foregroundColor lblColor initValue logHeight; -#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 [nbx] Creation Arguments; -#X msg 22 193 obj 150 280 nbx 5 14 0 127 0 1 send receive Maia 15 -8 -0 13 14 12 23 63 256; -#X connect 6 0 2 0; -#X restore 170 524 pd nbx-creation-arguments; -#X text 168 465 - if you create an [nbx] object without arguments \, -default values are chosen for the GUI-properties. See the subpatch -below to learn how to dynamically instantiate a [nbx] with custom properties: -; -#X text 115 208 Use the UP- \, DOWN- \, LEFT- or RIGHT-key to move -a selected gui-object. Right-click and choose "Properties" to modify -its appearance.; -#X text 362 188 "Properties" to set them.; -#X text 11 23 gui-number box; -#X text 97 466 18; -#X text 215 551 (c) musil@iem.kug.ac.at; -#X text 257 564 IEM KUG; -#X text 232 576 graz \, austria 2002; -#X text 426 9 [my_numbox] or [nbx]; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X text 98 295 bang; -#X text 168 295 - output the current value; -#X connect 13 0 16 0; -#X connect 14 0 36 0; -#X connect 15 0 36 0; -#X connect 17 0 36 0; -#X connect 18 0 14 0; -#X connect 19 0 28 0; -#X connect 20 0 34 0; -#X connect 21 0 22 0; -#X connect 25 0 26 0; -#X connect 26 0 37 0; -#X connect 28 0 33 0; -#X connect 32 0 31 0; -#X connect 35 0 24 0; -#X connect 36 0 32 0; -#X connect 36 0 13 0; -#X connect 37 0 21 0; -#X connect 37 0 23 0; diff --git a/doc/pddp/openpanel-help.pd b/doc/pddp/openpanel-help.pd deleted file mode 100644 index 5b504dfcb..000000000 --- a/doc/pddp/openpanel-help.pd +++ /dev/null @@ -1,72 +0,0 @@ -#N canvas 431 36 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 openpanel 3 12 0 -18 -204280 -1 0; -#X obj 0 310 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 485 284 494 344 META 0; -#X text 12 105 LIBRARY internal; -#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 125 AUTHOR Miller Puckette; -#X text 12 185 HELP_PATCH_AUTHORS Updated for Pd version 0.40. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 5 KEYWORDS control GUI; -#X text 12 45 DESCRIPTION query the user for a filename; -#X text 12 65 INLET_0 bang symbol; -#X text 12 85 OUTLET_0 symbol; -#X text 12 165 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 432 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 475 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 503 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#X text 98 479 (none); -#N canvas 216 520 428 109 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 obj 22 43 savepanel; -#X obj 92 43 soundfiler; -#X text 8 2 [openpanel] Related Objects; -#X restore 102 597 pd Related_objects; -#X obj 78 319 cnv 17 3 105 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 441 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 484 11 openpanel; -#X msg 171 104 bang; -#X obj 171 217 print; -#X text 211 104 Starts open panel in current directory; -#X msg 187 130 symbol /tmp; -#X msg 187 159 symbol C:/; -#X text 265 130 Starts in a specified directory; -#X text 98 318 bang; -#X text 98 364 symbol; -#X text 98 398 list; -#X text 168 318 - a "bang" to the inlet causes an "Open file" browser -to appear on the screen. If you select a file \, the filename appears -at the outet.; -#X text 168 364 - sending a symbol will start the "Open file" browser -in the specified directory.; -#X text 98 440 symbol; -#X obj 171 192 openpanel; -#X text 167 440 - the filename of the selected file is output from -the outlet.; -#X text 99 507 Unlike other symbol-handling objects in Pd \, [openpanel] -can output a symbol that contains spaces \, which will get handled -propertly by an object like [soundfiler]. However \, if you set this -filename to a message box and save the patch \, the symbol will be -converted to a list the next time you open the patch.; -#X text 11 23 query the user for a filename; -#X text 168 398 - a list starting with a symbol will be truncated to -the first element.; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X connect 12 0 24 0; -#X connect 15 0 24 0; -#X connect 16 0 24 0; -#X connect 24 0 13 0; diff --git a/doc/pddp/operators-help.pd b/doc/pddp/operators-help.pd deleted file mode 100644 index bbfa0bc87..000000000 --- a/doc/pddp/operators-help.pd +++ /dev/null @@ -1,105 +0,0 @@ -#N canvas 428 38 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 (binops1) 3 12 0 -18 -204280 -1 0; -#X obj 0 324 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 468 268 507 358 META 0; -#X text 12 125 LIBRARY internal; -#X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 45 LICENSE SIBSD; -#X text 12 145 AUTHOR Miller Puckette; -#X text 12 205 HELP_PATCH_AUTHORS This help patch was updated for Pd -version 0.35 test 28 by Dave Sabine as part of a project called pddp -proposed by Krzysztof Czaja to build comprehensive documentation for -Pd. Jonathan Wilkes revised the patch to conform to the PDDP template -for Pd version 0.42.; -#X text 12 85 DATATYPE_IN bang float list; -#X text 12 105 DATATYPE_OUT float; -#X text 12 65 DESCRIPTION binary arithmetic operators; -#X text 12 5 NAME + - * / pow max min; -#X text 12 25 KEYWORDS control trigonometry; -#X text 12 185 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 442 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 479 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 523 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 215 519 428 109 Related_objects 0; -#X obj 0 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X obj 56 75 cos~; -#X obj 88 75 osc~; -#X obj 22 75 expr; -#X obj 22 42 sin; -#X obj 48 42 cos; -#X obj 75 42 tan; -#X obj 108 42 atan; -#X obj 143 42 atan2; -#X obj 181 42 exp; -#X obj 208 42 log; -#X obj 236 42 abs; -#X obj 265 42 sqrt; -#X text 7 1 (arithmetic_operators) Related Objects; -#X restore 102 597 pd Related_objects; -#X obj 78 333 cnv 17 3 70 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 386 list; -#X text 98 450 float; -#X obj 78 451 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 414 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 98 413 float; -#X text 78 499 1) float; -#X obj 364 12 +; -#X obj 389 12 -; -#X obj 415 12 *; -#X obj 441 12 /; -#X obj 467 12 pow; -#X obj 492 12 max; -#X obj 518 12 min; -#X obj 128 166 +; -#X msg 94 124 3 4; -#X floatatom 128 124 5 0 0 0 - - -, f 5; -#X floatatom 169 124 5 0 0 0 - - -, f 5; -#X floatatom 128 193 5 0 0 0 - - -, f 5; -#X msg 54 124 bang; -#X text 98 332 bang; -#X text 98 357 float; -#X text 168 413 - a float to the right inlet is stored.; -#X text 168 332 - perform the operation using the last values stored -at the inlets.; -#X text 168 357 - store the incoming value at the left inlet and perform -the operation.; -#X text 168 384 - a pair of floats will be distributed to the two inlets. -; -#X floatatom 259 124 5 0 0 0 - - -, f 5; -#X floatatom 259 193 5 0 0 0 - - -, f 5; -#X obj 259 168 * 2; -#X text 118 239 All of these objects share the same behavior.; -#X obj 364 170 pow 4; -#X floatatom 364 193 0 0 0 0 - - -; -#X floatatom 403 126 5 0 0 0 - - -, f 5; -#X floatatom 364 126 5 0 0 0 - - -, f 5; -#X obj 98 542 pddp/pddplink pow-help.pd; -#X text 168 499 - initializes the value of the right inlet.; -#X text 98 527 Click below for individual help patches:; -#X obj 98 557 pddp/pddplink min-help.pd; -#X obj 98 572 pddp/pddplink max-help.pd; -#X text 11 23 binary arithmetic operators; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X connect 22 0 26 0; -#X connect 23 0 22 0; -#X connect 24 0 22 0; -#X connect 25 0 22 1; -#X connect 27 0 22 0; -#X connect 34 0 36 0; -#X connect 36 0 35 0; -#X connect 38 0 39 0; -#X connect 40 0 38 1; -#X connect 41 0 38 0; diff --git a/doc/pddp/osc~-help.pd b/doc/pddp/osc~-help.pd deleted file mode 100644 index d5631ab58..000000000 --- a/doc/pddp/osc~-help.pd +++ /dev/null @@ -1,96 +0,0 @@ -#N canvas 429 35 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 osc~ 3 12 0 18 -204280 --1 0; -#X obj 0 358 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 487 285 494 344 META 0; -#X text 12 125 LIBRARY internal; -#X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 145 AUTHOR Miller Puckette; -#X text 12 205 HELP_PATCH_AUTHORS Updated for Pd version 0.33. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 5 KEYWORDS signal trigonometry; -#X text 12 45 DESCRIPTION cosine wave oscillator; -#X text 12 65 INLET_0 signal float; -#X text 12 85 INLET_1 float; -#X text 12 105 OUTLET_0 signal; -#X text 12 185 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 456 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 493 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 567 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 214 518 428 109 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 [osc~] Related Objects; -#X obj 83 42 cos~; -#X obj 127 42 tabread4~; -#X obj 23 42 phasor~; -#X restore 102 597 pd Related_objects; -#X obj 78 367 cnv 17 3 35 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 366 float; -#X obj 78 465 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 410 cnv 17 3 35 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 98 409 float; -#X obj 511 9 osc~; -#X obj 229 253 dac~ 1; -#X obj 229 223 *~; -#X floatatom 65 126 0 0 0 0 - - -; -#X obj 243 195 line~; -#X msg 243 139 0.1 100; -#X msg 262 164 0 100; -#X text 314 134 on; -#X text 311 163 off; -#X text 280 188 envelope; -#X text 280 201 generator; -#X text 227 114 amplitude controls:; -#X text 226 270 audio output; -#X obj 83 228 metro 500; -#X text 65 270 graph the output; -#X text 89 132 change frequency; -#X text 91 120 incoming numbers; -#X obj 65 155 osc~ 1000; -#N canvas 0 0 450 300 (subpatch) 0; -#X array \$0-array 100 float 0; -#X coords 0 -1 100 1 150 100 1; -#X restore 374 172 graph; -#X text 98 386 signal; -#X text 98 464 signal; -#X obj 83 203 loadbang; -#X text 98 429 list; -#X text 11 23 cosine wave oscillator; -#X text 168 511 - sets the initial frequency. If the argument is supplied -\, [osc~] takes floating-point messages to change frequency. If no -argument is supplied \, the input is taken to be an audio signal.; -#X text 168 366 - an incoming float changes the frequency.; -#X text 168 386 - an incoming signal changes the frequency.; -#X text 167 409 - a float to the right inlet resets the phase.; -#X text 167 429 - a list will be truncated to the first element.; -#X text 80 511 1) float; -#X text 167 464 - the outgoing cosine wave.; -#X text 22 60 The [osc~] object outputs a cosine wave. With a floating-point -argument \, [osc~] takes floating-point messages to change frequency. -; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 481 54 pddp/dsp; -#X obj 66 253 tabwrite~ \$0-array; -#X connect 15 0 14 0; -#X connect 16 0 30 0; -#X connect 17 0 15 1; -#X connect 18 0 17 0; -#X connect 19 0 17 0; -#X connect 26 0 47 0; -#X connect 30 0 15 0; -#X connect 30 0 47 0; -#X connect 34 0 26 0; diff --git a/doc/pddp/otherbinops-help.pd b/doc/pddp/otherbinops-help.pd deleted file mode 100644 index c110a89be..000000000 --- a/doc/pddp/otherbinops-help.pd +++ /dev/null @@ -1,519 +0,0 @@ -#N canvas 432 42 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 (binops2-3) 3 12 -0 18 -204280 -1 0; -#X obj 0 178 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 492 291 494 344 META 0; -#X text 12 85 LIBRARY internal; -#X text 12 125 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 45 LICENSE SIBSD; -#X text 12 105 AUTHOR Miller Puckette; -#X text 12 165 HELP_PATCH_AUTHORS This document was updated for Pd -version 0.35 test 29 by Dave Sabine as part of a project called pddp -proposed by Krzysztof Czaja to build comprehensive documentation for -Pd. Revised by Jonathan Wilkes to conform to the PDDP template.; -#X text 12 25 KEYWORDS control; -#X text 12 65 DESCRIPTION relational and logical operators; -#X text 12 5 NAME > >= == != <= < mod div & | << >> && || %; -#X text 12 145 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 301 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 338 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 381 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 221 481 428 156 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 (binops2-3) Related Objects; -#X text 138 57 - binary arithmetic operators; -#X obj 19 57 pddp/pddplink operators-help.pd; -#X obj 19 77 pddp/pddplink math-help.pd; -#X text 138 77 - higher math in Pd; -#X text 19 37 Links to other control operators; -#X text 19 107 Links to signal operators; -#X obj 19 127 pddp/pddplink sigbinops-help.pd; -#X restore 102 598 pd Related_objects; -#X obj 79 187 cnv 17 3 75 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 309 float; -#X obj 79 310 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 79 273 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 98 272 float; -#X text 11 23 relational and logical operators; -#X obj 127 4 >; -#X obj 154 4 >=; -#X obj 182 4 ==; -#X obj 236 4 <=; -#X obj 264 4 <; -#X obj 209 4 !=; -#X obj 290 4 mod; -#X obj 317 4 div; -#X obj 366 4 &; -#X obj 394 4 |; -#X obj 474 4 &&; -#X obj 501 4 ||; -#X obj 421 4 <<; -#X obj 448 4 >>; -#X obj 527 4 %; -#X text 341 4 and; -#X floatatom 254 51 5 0 0 0 - - -, f 5; -#X floatatom 296 51 5 0 0 0 - - -, f 5; -#X obj 254 88 >; -#X floatatom 254 125 5 0 0 0 - - -, f 5; -#X msg 219 51 bang; -#X text 98 186 bang; -#X text 168 186 - a bang outputs the last value computed by the object. -; -#X text 98 206 list; -#X text 168 206 - a pair of floats is distributed to the two inlets. -Lists with more than two elements will be truncated.; -#X text 98 236 float; -#X text 168 236 - a float will be stored at the left inlet and used -to evaluate and output a value.; -#X text 167 272 - a float to the right inlet will be stored.; -#X text 168 309 - all relational and logical operators output a float -value.; -#X text 80 358 1) float; -#X text 167 358 - (optional) initial value for the right inlet.; -#X text 142 154 All these objects share similar behavior.; -#X msg 183 51 2 1; -#N canvas 49 53 428 611 understanding_MOD_and_DIV 0; -#X text 24 35 [mod] and [div] are helpful objects to determine whether -or not a fraction produces a remainder \, or to determine the value -of the remainder.; -#X floatatom 28 195 0 0 0 0 - - -; -#X floatatom 28 237 0 0 0 0 - - -; -#X floatatom 140 197 0 0 0 0 - - -; -#X text 60 196 divided by; -#X text 175 198 has a remainder of; -#X floatatom 302 198 0 0 0 0 - - -; -#X obj 28 216 mod; -#X text 25 108 [mod] takes a number in its left inlet and will divide -that number by either the creation argument or the number given at -its left inlet and will produce the value of the remainder at its outlet. -If no creation argument is given \, then the default value is 1; -#X obj 80 178 loadbang; -#X msg 140 178 1; -#X text 25 260 [div] takes a number in its left inlet and will divide -that number by either the creation argument or the number given at -its left inlet and will produce the result without a remainder. If -no creation argument is given \, then the default value is 1; -#X floatatom 28 341 0 0 0 0 - - -; -#X floatatom 28 383 0 0 0 0 - - -; -#X floatatom 140 343 0 0 0 0 - - -; -#X text 60 342 divided by; -#X floatatom 256 344 0 0 0 0 - - -; -#X obj 80 324 loadbang; -#X msg 140 324 1; -#X obj 28 362 div; -#X text 176 343 is equal to; -#X text 294 343 with no remainder.; -#X obj 257 371 /; -#X floatatom 257 391 0 0 0 0 - - -; -#X text 227 389 or; -#X text 297 392 with a remainder.; -#X text 25 413 In the following example \, I've built a metronome which -counts bar numbers and beat numbers: default time signature is 4/4 -(Common Time).; -#X obj 28 474 metro 500; -#X obj 28 455 tgl 15 0 empty empty Start-Stop 20 8 0 8 -262144 -1 -1 -0 1; -#X obj 53 495 + 1; -#X floatatom 28 515 0 0 0 0 - - -; -#X text 57 513 Total Beat Count; -#X obj 28 539 div 4; -#X obj 139 540 mod 4; -#X floatatom 224 581 0 0 0 0 - - -; -#X floatatom 113 580 0 0 0 0 - - -; -#X obj 28 495 f 1; -#X msg 112 453 1; -#X obj 28 559 + 1; -#X obj 139 559 + 1; -#X text 136 453 Reset; -#X text 39 579 Bar number; -#X text 152 581 Beat Count; -#X floatatom 344 491 0 0 0 0 - - -; -#X text 181 491 How many beats per bar?; -#X obj 0 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 1 (binops2-3) [mod] and [div]; -#X text 25 76 For example \, 3 / 3 = 1 with a remainder of zero (i.e. -no remainder) \, while \, 4 / 3 = 1 with a remainder of one.; -#X connect 1 0 7 0; -#X connect 2 0 6 0; -#X connect 3 0 7 1; -#X connect 7 0 2 0; -#X connect 9 0 10 0; -#X connect 10 0 3 0; -#X connect 12 0 19 0; -#X connect 12 0 22 0; -#X connect 13 0 16 0; -#X connect 14 0 19 1; -#X connect 14 0 22 1; -#X connect 17 0 18 0; -#X connect 18 0 14 0; -#X connect 19 0 13 0; -#X connect 22 0 23 0; -#X connect 27 0 36 0; -#X connect 28 0 27 0; -#X connect 29 0 36 1; -#X connect 30 0 32 0; -#X connect 30 0 33 0; -#X connect 32 0 38 0; -#X connect 33 0 39 0; -#X connect 36 0 29 0; -#X connect 36 0 30 0; -#X connect 37 0 36 1; -#X connect 38 0 35 0; -#X connect 39 0 34 0; -#X connect 43 0 33 1; -#X connect 43 0 32 1; -#X restore 101 430 pd understanding_MOD_and_DIV; -#N canvas 61 337 428 254 understanding_%_modulus 0; -#X floatatom 21 184 0 0 0 0 - - -; -#X text 18 36 - this object has nothing to do with percentage!; -#X text 18 56 - a modulus is a number by which two given numbers can -be divided and produce the same remainder.; -#X text 18 86 - in the example below: 9 / 2 = 4.5 \, and 7 / 2 = 3.5. -Hence if 7 and 9 are divided by 2 \, then the remainder of both equations -is .5. Therefore \, the modulus of 7 and 9 is "2".; -#X msg 21 135 9; -#X obj 21 163 % 7; -#X floatatom 55 135 5 0 0 0 - - -, f 5; -#X text 18 214 Note that the modulus operator is not a "bitwise" operator -\, but a math function.; -#X obj 0 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 1 (binops2-3) Modulus [%]; -#X connect 4 0 5 0; -#X connect 5 0 0 0; -#X connect 6 0 5 0; -#X restore 281 562 pd understanding_%_modulus; -#N canvas 87 181 428 280 understanding_&_AND 0; -#X obj 174 221 &; -#X floatatom 228 187 5 0 0 0 - - -, f 5; -#X floatatom 270 188 5 0 0 0 - - -, f 5; -#X msg 174 164 13; -#X msg 203 165 9; -#X text 26 119 13 = "1101"; -#X text 32 131 9 = "1001"; -#X text 19 144 Hence:"1001"; -#X obj 174 124 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 174 142 t b b; -#X floatatom 174 243 0 0 0 0 - - -; -#X obj 0 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 18 35 [&] -- This is the bitwise AND operator which returns -a "1" for each bit position where the corresponding bits of both its -operands are "1".; -#X text 19 77 When comparing the binary codes for 13 and 9 (below) -\, we can see that the first and fourth digits of both codes are "1". -Hence the result will be "1001" -- in other words "9".; -#X text 7 1 (binops2-3) The [&] Object; -#X connect 0 0 10 0; -#X connect 1 0 0 0; -#X connect 2 0 0 1; -#X connect 3 0 0 0; -#X connect 4 0 0 1; -#X connect 8 0 9 0; -#X connect 9 0 3 0; -#X connect 9 1 4 0; -#X restore 281 430 pd understanding_&_AND; -#N canvas 92 219 428 293 understanding_|_OR 0; -#X floatatom 137 261 0 0 0 0 - - -; -#X floatatom 191 205 5 0 0 0 - - -, f 5; -#X floatatom 233 206 5 0 0 0 - - -, f 5; -#X msg 137 177 13; -#X msg 166 178 9; -#X text 26 131 13 = "1101"; -#X text 32 143 9 = "1001"; -#X obj 137 137 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 137 155 t b b; -#X text 19 156 Hence:"1101"; -#X obj 137 239 |; -#X obj 0 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 1 (binops2-3) Related Objects; -#X text 17 35 [|] -- This is the bitwise OR operator which returns -a "1" for each bit position where one OR both of the corresponding -bits of both its operands is a "1".; -#X text 18 77 When comparing the binary codes for 13 and 9 (below) -\, we can see that the first and fourth digits of both codes are both -1 and the second position of 13 is a one. Hence the result will be -"1101" -- in other words "13".; -#X connect 1 0 10 0; -#X connect 2 0 10 1; -#X connect 3 0 10 0; -#X connect 4 0 10 1; -#X connect 7 0 8 0; -#X connect 8 0 3 0; -#X connect 8 1 4 0; -#X connect 10 0 0 0; -#X restore 281 452 pd understanding_|_OR; -#N canvas 94 256 428 294 understanding_<<_LEFT-SHIFT 0; -#X obj 21 149 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 21 167 t b b; -#X msg 21 188 13; -#X obj 21 229 <<; -#X floatatom 21 251 5 0 0 0 - - -, f 5; -#X msg 49 188 2; -#X floatatom 87 200 5 0 0 0 - - -, f 5; -#X floatatom 135 200 5 0 0 0 - - -, f 5; -#X text 18 35 [<<] -- This is the left shift operator and it works -by shifting the digits of the binary representation of the first operand -(left inlet) to the left by the number of places specified by the second -operand (right inlet). The spaces created to the right are filled by -zeros \, and any digits falling off the left are discarded. The following -code returns 52 as the binary of 13 ("1101") is shifted two places -to the left giving "110100":; -#X obj 0 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 1 (binops2-3) Left-shift; -#X connect 0 0 1 0; -#X connect 1 0 2 0; -#X connect 1 1 5 0; -#X connect 2 0 3 0; -#X connect 3 0 4 0; -#X connect 5 0 3 1; -#X connect 6 0 3 0; -#X connect 7 0 3 1; -#X restore 281 474 pd understanding_<<_LEFT-SHIFT; -#N canvas 82 206 428 348 understanding_>>_RIGHT-SHIFT 0; -#X obj 21 162 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 21 180 t b b; -#X floatatom 21 264 5 0 0 0 - - -, f 5; -#X floatatom 87 213 5 0 0 0 - - -, f 5; -#X floatatom 135 213 5 0 0 0 - - -, f 5; -#X msg 21 201 13; -#X obj 21 242 >>; -#X msg 49 201 2; -#X text 18 35 [>>] -- This is the sign-propagating right shift operator -which shifts the digits of the binary representation of the first operand -(left inlet) to the right by the number of places specified by the -second operand (right inlet) \, discarding any shifted off to the right. -The copies of the leftmost bit are added on from the left \, thereby -preserving the sign of the number. This next examples returns 3 ("11") -as the two right-most bits of 13 ("1101") are shifted off to the right -and discarded.; -#X text 13 291 Note that this object preserves negative values for -negative operands. ("sign-propagating").; -#X obj 0 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 1 (binops2-3) Right-shift; -#X connect 0 0 1 0; -#X connect 1 0 5 0; -#X connect 1 1 7 0; -#X connect 3 0 6 0; -#X connect 4 0 6 1; -#X connect 5 0 6 0; -#X connect 6 0 2 0; -#X connect 7 0 6 1; -#X restore 281 496 pd understanding_>>_RIGHT-SHIFT; -#N canvas 94 222 428 418 understanding_&&_LOGICAL-AND 0; -#X msg 52 259 5; -#X obj 21 309 &&; -#X floatatom 21 329 5 0 0 0 - - -, f 5; -#X floatatom 190 267 5 0 0 0 - - -, f 5; -#X text 18 36 [&&] - This is the logical AND operator \, which returns -a Boolean true (a one) if both operands are true. Logically it follows -that if the first operand is false \, then the whole expression is -false \, and this is how the objects works: It first evaluates the -left hand operand (left inlet) and if this returns false (zero) then -\, without going any further \, it returns a false (a zero). Otherwise -it returns the value of the second operand (right inlet).; -#X floatatom 233 267 5 0 0 0 - - -, f 5; -#X text 18 354 Note that this is not a bitwise operator. It compares -floats.; -#X obj 21 217 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 21 235 t b b; -#X msg 21 259 17; -#X text 18 145 In other words \, IF the left inlet is zero \, THEN -output zero. ELSEIF the left inlet is non-zero AND the right inlet -is zero \, then output zero. ELSEIF the left inlet is non-zero AND -the right inlet is non-zero \, THEN output non-zero!; -#X obj 87 217 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 87 235 t b b; -#X msg 87 259 17; -#X msg 118 259 0; -#X obj 0 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 1 (binops2-3) Logical-and; -#X connect 0 0 1 1; -#X connect 1 0 2 0; -#X connect 3 0 1 0; -#X connect 5 0 1 1; -#X connect 7 0 8 0; -#X connect 8 0 9 0; -#X connect 8 1 0 0; -#X connect 9 0 1 0; -#X connect 11 0 12 0; -#X connect 12 0 13 0; -#X connect 12 1 14 0; -#X connect 13 0 1 0; -#X connect 14 0 1 1; -#X restore 281 518 pd understanding_&&_LOGICAL-AND; -#N canvas 105 196 428 400 understanding_||_LOGICAL-OR 0; -#X msg 52 250 5; -#X floatatom 21 320 5 0 0 0 - - -, f 5; -#X floatatom 192 251 5 0 0 0 - - -, f 5; -#X floatatom 235 251 5 0 0 0 - - -, f 5; -#X text 18 345 Note that this is not a bitwise operator. It compares -floats.; -#X obj 21 208 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 21 226 t b b; -#X msg 21 250 17; -#X text 18 35 [||] -- This is the logical OR operator and it returns -a value of true (non-zero) if one or both of the operands is true. -It works by first evaluating the left-hand operand (left inlet) and -\, if this is true \, diregarding the right-hand operand (right inlet) -and returning a non-zero. If \, however \, the left-hand operand (left -inlet) is false \, then it returns the value of the right-hand operand -(right inlet).; -#X text 18 146 In other words \, IF the left inlet is non-zero \, THEN -output non-zero. ELSEIF the left inlet is zero AND the right inlet -is zero \, then output zero. ELSEIF the left inlet is zero AND the -right inlet is non-zero \, THEN output non-zero!; -#X obj 21 300 ||; -#X obj 92 207 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 92 225 t b b; -#X msg 92 249 0; -#X msg 123 249 0; -#X obj 0 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 1 (binops2-3) Logical-or; -#X connect 0 0 10 1; -#X connect 2 0 10 0; -#X connect 3 0 10 1; -#X connect 5 0 6 0; -#X connect 6 0 7 0; -#X connect 6 1 0 0; -#X connect 7 0 10 0; -#X connect 10 0 1 0; -#X connect 11 0 12 0; -#X connect 12 0 13 0; -#X connect 12 1 14 0; -#X connect 13 0 10 0; -#X connect 14 0 10 1; -#X restore 281 540 pd understanding_||_LOGICAL-OR; -#X text 98 385 Relational Operators; -#X text 278 385 Logical Operators; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#N canvas 76 63 428 577 Relational_Operators 0; -#X obj 0 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X floatatom 227 354 0 0 0 0 - - -; -#X floatatom 277 433 0 0 0 0 - - -; -#X obj 227 333 >; -#X obj 277 412 ==; -#X obj 64 130 == 42; -#X floatatom 64 109 5 0 0 0 - - -, f 5; -#X floatatom 38 156 2 0 0 0 - - -, f 2; -#X obj 63 155 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X msg 34 105 42; -#X text 19 87 For example: IF 42 is equal to x \, then "1" (True); -#X text 83 147 Note that the object outputs 1 or 0 with every incoming -message.; -#X text 20 179 All of these objects operate the same way. The right -inlet or creation argument sets the "condition" to which the incoming -messages are compared. The left inlet accepts numbers or a "bang" -- -a number will reset the value and output a true or false (1 or 0) depending -on whether or not the incoming value meets the necessary condition. -A "bang" will force the object to output a true or false (1 or 0) based -on the value that is already stored in the left inlet.; -#X floatatom 35 280 5 0 0 0 - - -, f 5; -#X floatatom 73 280 5 0 0 0 - - -, f 5; -#X text 20 278 a; -#X text 113 279 b; -#X text 98 355 Is a greater than b?; -#X floatatom 252 394 0 0 0 0 - - -; -#X text 52 394 Is a greater than or equal to b?; -#X obj 252 373 >=; -#X text 171 433 Is a equal to b?; -#X obj 305 450 !=; -#X floatatom 305 470 0 0 0 0 - - -; -#X obj 335 283 r a_b; -#X obj 335 302 unpack f f; -#X obj 35 334 pack f f; -#X obj 35 354 s a_b; -#X text 177 471 Is a NOT equal to b?; -#X floatatom 331 508 0 0 0 0 - - -; -#X text 220 508 Is a less than b?; -#X obj 331 488 <; -#X floatatom 356 547 0 0 0 0 - - -; -#X obj 356 527 <; -#X text 173 547 Is a less than or equal to b?; -#X text 18 36 Most relational operators output a boolean value: true -or false (1 or 0) depending on the relation between the input (left -inlet) and the condition (right inlet or creation argument).; -#X obj 73 306 t b a; -#X text 7 1 (binops2-3) Relational Operators; -#X connect 3 0 1 0; -#X connect 4 0 2 0; -#X connect 5 0 7 0; -#X connect 5 0 8 0; -#X connect 6 0 5 0; -#X connect 9 0 5 0; -#X connect 13 0 26 0; -#X connect 14 0 36 0; -#X connect 20 0 18 0; -#X connect 22 0 23 0; -#X connect 24 0 25 0; -#X connect 25 0 3 0; -#X connect 25 0 20 0; -#X connect 25 0 4 0; -#X connect 25 0 22 0; -#X connect 25 0 31 0; -#X connect 25 0 33 0; -#X connect 25 1 3 1; -#X connect 25 1 20 1; -#X connect 25 1 4 1; -#X connect 25 1 22 1; -#X connect 25 1 31 1; -#X connect 25 1 33 1; -#X connect 26 0 27 0; -#X connect 31 0 29 0; -#X connect 33 0 32 0; -#X connect 36 0 26 0; -#X connect 36 1 26 1; -#X restore 101 408 pd Relational_Operators; -#N canvas 79 189 428 247 Logical_Operators 0; -#X obj -1 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 -0 14 -204280 -1 0; -#X text 7 1 (binops2-3) Logical Operators-- a.k.a. "Bit Twiddling" -; -#X text 24 26 These objects are adopted from the mother of all object -oriented languages: C. They are "bitwise" operators which perform logical -and shift operations on 32-bit numbers.; -#X text 17 194 Hence \, performing "bitwise" relational tests means -that Pd can compare "1101" to "1001" instead of operating with the -integers that are represented by those binary codes.; -#X text 17 116 Well \, these objects perform "relational" tests on -the binary forms of 32-bit numbers. For example \, the number 13 is -represented in your computer's operating system in binary code by "1101" -and the number 9 is "1001". Each of those binary digits is an 8-bit -word: 8 bits * 4 digits = 32-bits!; -#X obj -1 80 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 -0 14 -204280 -1 0; -#X text 7 81 What does "bitwise" mean?; -#X restore 281 408 pd Logical_Operators; -#X connect 30 0 32 0; -#X connect 31 0 32 1; -#X connect 32 0 33 0; -#X connect 34 0 32 0; -#X connect 46 0 32 0; diff --git a/doc/pddp/pack-help.pd b/doc/pddp/pack-help.pd deleted file mode 100644 index 87c750ea1..000000000 --- a/doc/pddp/pack-help.pd +++ /dev/null @@ -1,208 +0,0 @@ -#N canvas 429 37 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 pack 3 12 0 18 -204280 --1 0; -#X obj 0 113 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 482 257 494 370 META 0; -#X text 12 125 LIBRARY internal; -#X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 145 AUTHOR Miller Puckette; -#X text 12 205 HELP_PATCH_AUTHORS This help patch was updated for Pd -version 0.35 test 26 by Dave Sabine as part of a project called pddp -proposed by Krzysztof Czaja to build comprehensive documentation for -Pd. Jonathan Wilkes revised the patch to conform to the PDDP template -for Pd version 0.42.; -#X text 12 45 DESCRIPTION combine several atoms into one message; -#X text 12 65 INLET_0 anything; -#X text 12 85 INLET_N float symbol pointer; -#X text 12 105 OUTLET_0 list symbol pointer float; -#X text 12 5 KEYWORDS control needs_work list_op; -#X text 12 185 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 394 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 459 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 565 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 217 333 428 296 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 [pack] Related Objects; -#X text 20 163 These objects are offered in Pd only if you have downloaded -and properly installed the appropriate library. These objects may or -may not exist in a single library.; -#X text 19 212 The best places to find information about Pd's libraries -is:; -#X text 16 234 www.puredata.org and click on "Downloads" then "Software" -; -#X text 17 250 or; -#X text 18 264 iem.kug.ac.at/pdb/; -#X obj 20 36 pddp/helplink zexy/pack~; -#X obj 20 51 pddp/helplink zexy/unpack~; -#X obj 20 66 pddp/helplink zexy/tabdump; -#X obj 20 81 pddp/helplink zexy/niagara; -#X obj 20 96 pddp/helplink zexy/packel; -#X obj 20 111 pddp/helplink zexy/repack; -#X obj 20 126 pddp/helplink zexy/drip; -#X obj 20 141 pddp/helplink zexy/sort; -#X restore 102 597 pd Related_objects; -#X obj 78 120 cnv 17 3 225 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 266 list; -#X obj 78 401 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 350 cnv 17 3 37 empty \$0-pddp.cnv.let.n n 5 9 0 16 -228856 --162280 0; -#X obj 511 10 pack; -#X text 98 186 symbol; -#X text 98 119 bang; -#X text 98 147 float; -#X text 98 226 pointer; -#X text 98 400 list; -#N canvas 82 45 428 551 pack_peculiarities 0; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X msg 25 103 bang; -#X obj 25 123 pack 100 0 s 42; -#X text 25 162 In the same example \, this [pack] object will recognize -floats in the first \, second \, and fourth inlet \; it will recognize -symbols in the third inlet. If it receives anything else \, then you'll -see the "no method for ___" error message in the terminal window.; -#X obj 26 282 pack 100 0 s 42; -#X msg 26 238 400 1 cat 38; -#X text 111 238 This works.; -#X msg 38 260 cat dog 42 earth; -#X obj 31 448 pack cat; -#X text 25 333 So \, if [pack] understands that "100" is a float and -can therefore understand all incoming numbers to that inlet...then -you might assume that the word "cat" could be written as a creation -argument and [pack] should understand all incoming symbols. But that's -NOT the case. If you try to define a [pack] symbol with the word "cat" -in a creation argument \, you'll get a "bad type" error.; -#X text 39 430 WRONG; -#X obj 143 452 pack symbol; -#X text 223 442 CORRECT; -#X obj 143 473 print this_package; -#X msg 143 431 cat; -#X text 41 298 Note that the "s" above is an abbreviation for "symbol". -; -#X obj 31 525 pack bang; -#X text 30 492 Same problem with bangs! This [pack] object creates -an error.; -#X obj 25 144 print package_1; -#X obj 26 315 print package_2; -#X text 145 261 This doesn't work - the data types; -#X text 144 278 don't correspond with the arguments.; -#X text 20 32 In the example below \, the creation arguments are "100" -\, "0" \, a "symbol" \, and "42". Hence \, when [pack] receives a bang -\, it will send that information to its outlet as a list - or 'package' -- which will be printed in your terminal window.; -#X text 8 2 [pack] Peculiarities; -#X connect 1 0 2 0; -#X connect 2 0 18 0; -#X connect 4 0 19 0; -#X connect 5 0 4 0; -#X connect 7 0 4 0; -#X connect 11 0 13 0; -#X connect 14 0 11 0; -#X restore 171 545 pd pack_peculiarities; -#X text 168 400 - [pack] will output its package (i.e. \, the list -of values) when it receives a message to its left inlet.; -#N canvas 72 44 466 546 Another_example_using_pack 0; -#X text 181 97 is the same as; -#X obj 23 517 print my_package; -#X msg 46 285 1 2 dog; -#X obj 23 211 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X floatatom 55 390 5 0 0 0 - - -, f 5; -#X floatatom 53 343 5 0 0 0 - - -, f 5; -#X msg 129 450 100 earth me 42; -#X text 19 38 Perhaps the best way to build creation arguments is to -define the data types that [pack] should expect at each inlet: (i.e. -floats \, symbols \, or pointers -- or their abbreviations f \, s \, -or p); -#X obj 22 97 pack float symbol pointer; -#X obj 276 98 pack f s p; -#X msg 36 261 42 24 dog cat 1 2; -#X obj 23 497 pack f f s s f f; -#X text 42 205 Any message to the first inlet will force [pack] to -output its package - its list of values. A bang to the first inlet -will force [pack] to output the current values without resetting any -of them.; -#X text 101 380 This number box will update each of the 'float' values -and will NOT output the package - because the first inlet is not receiving -a message - to change this behavior \, you should explore the [trigger] -object.; -#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 [pack] Another Example; -#X text 20 124 [pack] can be created with any number of creation arguments. -There will be one inlet created for each argument and the values of -each [pack]ed element can be updated at any time using the separate -inlets \; or they can be updated simoultaneously with a list of messages -to its first inlet.; -#X text 151 261 This list contains new values for each item.; -#X text 97 280 This list doesn't contain enough items \; so it resets -only the first three items \, uses the previous values for the other -three items \, and then outputs the entire package.; -#X text 99 340 A new value for the first item will reset the it and -force [pack] to output the entire package of stored values.; -#X text 129 481 this list will cause an error.; -#X text 128 467 Lists can only be sent to the first inlet --; -#X connect 2 0 11 0; -#X connect 3 0 11 0; -#X connect 4 0 11 1; -#X connect 4 0 11 4; -#X connect 4 0 11 5; -#X connect 5 0 11 0; -#X connect 6 0 11 1; -#X connect 10 0 11 0; -#X connect 11 0 1 0; -#X restore 101 573 pd Another_example_using_pack; -#X obj 394 69 pack; -#X obj 394 91 print; -#X msg 432 46 2; -#X floatatom 394 46 5 0 0 0 - - -, f 5; -#X text 98 427 Note: [pack] may output a float \, symbol \, or pointer -if only one argument is specified.; -#X text 11 23 combine several atoms into one message; -#X text 23 46 The [pack] object takes a series of inputs and then outputs -a concatenated list. By default \, [pack] has two inlets \, each of -which will accept a float.; -#X text 168 147 - if the first argument is "float" \, "f" \, or a numeric -value (e.g. \, "12" \, "3.4") the first element in the list will be -set to the incoming value \, and [pack] will output its list.; -#X text 168 266 - a list is distributed to among the inlets of [pack]. -Each element must match the atom-type specified by the creation arguments. -Lists with more items than the total number of inlets will be truncated. -; -#X text 168 226 - if the first argument is "pointer" or "p" \, an incoming -pointer will be set to the first item in the list \, and [pack] will -output its list.; -#X text 98 491 float; -#X text 168 476 - the number of arguments determines the number of -inlets (default is two). The symbols described under the "inlets" heading -specify the atom-type of each inlet. You can also use a float to specify -float-type while also initializing that inlet's value. Some peculiarities -described below:; -#X text 80 476 n) symbol atom; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X text 168 186 - if the first argument is "symbol" or "s" \, an incoming -symbol will be set to the first item in the list \, and [pack] will -output its list.; -#X text 98 319 anything; -#X text 168 119 - a "bang" to the first inlet will force [pack] to -output the current package (i.e. \, the list of values).; -#X text 168 319 - an anything will be converted to a list and distributed -in the same manner as a list.; -#X text 98 348 An inlet is created for each argument given. Each may -store a float \, symbol \, or pointer \, depending on the argument -given. These inlets will not accept lists/anythings.; -#X connect 21 0 22 0; -#X connect 23 0 21 1; -#X connect 24 0 21 0; diff --git a/doc/pddp/pd-help.pd b/doc/pddp/pd-help.pd deleted file mode 100644 index 1f9982c78..000000000 --- a/doc/pddp/pd-help.pd +++ /dev/null @@ -1,161 +0,0 @@ -#N canvas 430 32 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 pd 3 12 0 18 -204280 --1 0; -#X obj 0 175 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 484 282 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 225 RELEASE_DATE 2009-06-12; -#X text 12 65 LICENSE SIBSD; -#X text 12 185 AUTHOR Miller Puckette; -#X text 12 245 HELP_PATCH_AUTHORS Updated for Pd v0.41. Revised by -Jonathan Wilkes to conform to the PDDP template for Pd version 0.42. -; -#X text 12 5 NAME pd; -#X text 12 25 ALIAS page; -#X text 12 125 INLET_N anything signal; -#X text 12 145 OUTLET_N anything signal; -#X text 12 85 DESCRIPTION subwindow (subpatch); -#X text 12 45 KEYWORDS signal canvas_op; -#X restore 500 597 pd META; -#X obj 0 302 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 432 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 539 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 220 269 428 356 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 [pd] Related Objects; -#X obj 22 43 inlet; -#X obj 22 73 outlet; -#X obj 68 43 inlet~; -#X obj 68 73 outlet; -#X obj 128 43 table; -#N canvas 0 0 450 300 (subpatch) 0; -#X coords 0 1 100 -1 200 140 1 0 0; -#X restore 182 44 graph; -#N canvas 0 0 450 300 (subpatch) 0; -#X array \$0-array 100 float 3; -#A 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 -0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 -0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 -0; -#X coords 0 1 100 -1 200 140 1; -#X restore 23 203 graph; -#X restore 102 598 pd Related_objects; -#X obj 78 184 cnv 17 3 110 empty \$0-pddp.cnv.let.n n 5 9 0 16 -228856 --162280 0; -#N canvas 0 0 450 300 (subpatch) 0; -#X restore 395 11 pd; -#X text 11 23 subwindow (subpatch); -#X text 98 183 anything; -#X text 98 242 signal; -#X text 80 451 1) symbol atom; -#X obj 78 311 cnv 17 3 110 empty \$0-pddp.cnv.let.n n 5 9 0 16 -228856 --162280 0; -#X text 98 310 anything; -#X text 98 369 signal; -#X obj 101 543 pddp/pddplink all_about_canvas_properties.pd -text all_about_canvas_properties -; -#X text 97 130 You can also change the graphical properties of the -object so that part of the subwindow is visible on the parent (referred -to as "graph on parent" or "gop").; -#N canvas 0 0 450 300 (subpatch) 0; -#X restore 514 11 page; -#X text 420 11 or (deprecated); -#X floatatom 242 86 5 0 0 0 - - -, f 5; -#X text 309 80 For help on inlets/outlets \, see:; -#X obj 308 95 pddp/pddplink inlet-help.pd -text inlet-help; -#X obj 308 110 pddp/pddplink inlet~-help.pd -text inlet~-help; -#X obj 398 95 pddp/pddplink outlet-help.pd -text outlet-help; -#X obj 398 110 pddp/pddplink outlet~-help.pd -text outlet~-help; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 100 560 pddp/pddplink ../2.control.examples/12.PART2.subpatch.pd --text doc/2.control.examples/12.PART2.subpatch.pd; -#X obj 100 575 pddp/pddplink ../3.audio.examples/G05.execution.order.pd --text doc/3.audio.examples/G05.execution.order.pd; -#N canvas 559 53 296 107 window_position 1; -#X text 19 8 If you leave open a [pd] subwindow like; -#X text 19 53 patch.; -#X text 19 38 visible the next time you load the; -#X text 19 23 this one and save the patch \, it will be; -#X restore 382 550 pd window_position; -#X text 97 42 The [pd] object provides a way to nest canvases. You -can click on the object to open the subwindow and see the objects inside. -; -#N canvas 1 53 450 300 click_me 0; -#X obj 26 50 inlet; -#X obj 26 209 outlet; -#X text 47 109 Use the [inlet] and [outlet] objects to add inlets and -outlets to your subpatch.; -#X obj 341 52 inlet; -#X floatatom 341 79 5 0 0 0 - - -, f 5; -#X text 46 147 The horizontal order of the [inlet]/[outlet] objects -corresponds to the placement of the inlets/outlets on the [pd] object -itself. I.e. \, the leftmost inlet -> leftmost [inlet] \, rightmost -inlet -> rightmost [inlet] \, and so on.; -#X obj 342 205 outlet; -#X connect 0 0 1 0; -#X connect 3 0 4 0; -#X restore 179 107 pd click_me; -#X text 168 242 - you can create a signal inlet by placing an [inlet~] -object inside the subpatch. If there are multiple [inlet~] objects -\, their horizontal order corresponds to the inlets drawn on the [pd] -object.; -#X text 168 183 - for sending control messages \, you can create an -inlet by placing an [inlet] object inside the subpatch. If there are -multiple [inlet] objects \, their horizontal order corresponds to the -inlets drawn on the [pd] object.; -#X text 168 369 - you can create a signal outlet by placing an [outlet~] -object inside the subpatch. If there are multiple [outlet~] objects -\, their horizontal order corresponds to the outlets drawn on the [pd] -object.; -#X text 168 310 - for sending control messages you can create one by -placing an [outlet] object inside the subpatch. If there are multiple -[outlet] objects \, their horizontal order corresponds to the outlets -drawn on the [pd] object.; -#X text 167 451 - (optional) specify a name for the subwindow \, which -you can use with the prefix "pd-" to send messages to the subpatch -itself. Duplicate names are allowed (named messages will be passed -to both subpatches). For ease of use \, Pd allows you to edit and change -this argument without destroying the data inside the subpatch.; -#N canvas 250 475 296 200 nesting 0; -#N canvas 258 420 264 105 (subpatch) 0; -#N canvas 252 328 240 113 (subpatch) 0; -#N canvas 203 263 309 126 (subpatch) 0; -#N canvas 240 228 264 118 thats-enough 0; -#X text 84 38 Ok \, that's it.; -#X text 70 53 For real this time.; -#N canvas 264 187 272 64 Really? 0; -#X text 2 27 Seriously \,; -#N canvas 227 161 266 81 What? 0; -#X text 3 58 You're being obsessive.; -#N canvas 89 146 450 72 Who? 0; -#N canvas 160 252 341 101 I 0; -#X text 16 16 Third base!; -#X restore 5 5 pd I don't know.; -#X text 2 39 Who's on first.; -#X restore 7 4 pd Who?; -#X restore 7 0 pd What?; -#X text 2 41 Stop.; -#X restore 197 98 pd Really?; -#X restore 2 102 pd thats-enough; -#X text 44 24 Ok that's enough. These; -#X text 44 39 windows will all go away when; -#X text 44 53 you close the main patch.; -#X restore 138 46 pd; -#X text 70 46 Or this:; -#X restore 105 60 pd; -#X text 91 33 Or this:; -#X restore 130 97 pd; -#X text 19 23 You can of course nest [pd] objects; -#X text 19 38 inside other [pd] objects \, like this:; -#X restore 382 572 pd nesting; -#X connect 21 0 32 1; diff --git a/doc/pddp/phasor~-help.pd b/doc/pddp/phasor~-help.pd deleted file mode 100644 index 4a50fc311..000000000 --- a/doc/pddp/phasor~-help.pd +++ /dev/null @@ -1,84 +0,0 @@ -#N canvas 428 37 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 phasor~ 3 12 0 18 --204280 -1 0; -#X obj 0 339 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 480 288 494 344 META 0; -#X text 12 125 LIBRARY internal; -#X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 145 AUTHOR Miller Puckette; -#X text 12 205 HELP_PATCH_AUTHORS Updated for Pd version 0.33. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 5 KEYWORDS signal; -#X text 12 45 DESCRIPTION sawtooth generator; -#X text 12 65 INLET_0 float signal; -#X text 12 85 INLET_1 float; -#X text 12 105 OUTLET_0 signal; -#X text 12 185 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 438 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 474 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 547 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 214 520 428 109 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 obj 22 43 osc~; -#X obj 62 43 cos~; -#X obj 103 43 tabread4~; -#X text 8 2 [phasor~] Related Objects; -#X restore 102 598 pd Related_objects; -#X obj 78 348 cnv 17 3 35 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 447 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 392 cnv 17 3 35 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 98 391 float; -#X obj 494 12 phasor~; -#N canvas 0 0 450 300 (subpatch) 0; -#X array \$0-array 100 float 0; -#X coords 0 1 100 -1 200 100 1; -#X restore 279 200 graph; -#X obj 84 197 metro 500; -#X floatatom 68 114 0 0 0 0 - - -; -#X text 86 238 graph the output; -#X text 97 114 <- specify frequency; -#X obj 68 142 phasor~ 440; -#X text 145 136 invoked with argument for non-signal input. Incoming -messages override the initial value.; -#X obj 84 172 loadbang; -#X text 98 347 float; -#X text 98 367 signal; -#X text 98 411 list; -#X text 98 446 signal; -#X text 11 23 sawtooth generator; -#X text 168 347 - a float sets the frequency of the sawtooth.; -#X text 168 367 - incoming signal sets the frequency of the sawtooth. -; -#X text 167 391 - resets the phase (range is 0 to 1).; -#X text 167 411 - a list will be truncated to the first element.; -#X text 80 492 1) float; -#X text 63 66 The [phasor~] object outputs a sawtooth signal \, traditionally -used for table lookup via [cos~] or [tabread4~].; -#X text 168 492 - (optional) with a floating-point argument \, [phasor~] -takes floating-point messages to change frequency. If no argument is -supplied \, the input is taken to be an audio signal.; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 480 51 pddp/dsp; -#X obj 98 551 pddp/pddplink ../3.audio.examples/C02.sawtooth-foldover.pd --text doc/3.audio.exampmles/C02.sawtooth-foldover.pd; -#X obj 98 566 pddp/pddplink ../3.audio.examples/J09.bandlimited.pd --text doc/3.audio.exampmles/J09.bandlimited.pd; -#X obj 68 221 tabwrite~ \$0-array; -#X connect 14 0 37 0; -#X connect 15 0 18 0; -#X connect 18 0 37 0; -#X connect 20 0 14 0; diff --git a/doc/pddp/pipe-help.pd b/doc/pddp/pipe-help.pd deleted file mode 100644 index 636abf1ea..000000000 --- a/doc/pddp/pipe-help.pd +++ /dev/null @@ -1,223 +0,0 @@ -#N canvas 429 34 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 pipe 3 12 0 18 -204280 --1 0; -#X obj 0 148 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 485 247 494 386 META 0; -#X text 12 145 LIBRARY internal; -#X text 12 185 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 165 AUTHOR Miller Puckette; -#X text 12 225 HELP_PATCH_AUTHORS This help patch was updated for Pd -version 0.35 test 28 by Dave Sabine as part of a project called pddp -proposed by Krzysztof Czaja to build comprehensive documentation for -Pd. Jonathan Wilkes revised the patch to conform to the PDDP template -for Pd version 0.42.; -#X text 12 5 KEYWORDS control time; -#X text 12 45 DESCRIPTION delay a message - a message "delay line" -; -#X text 12 65 INLET_0 float list symbol pointer bang flush clear; -#X text 12 105 INLET_R float; -#X text 12 85 INLET_N float list symbol pointer bang; -#X text 12 125 OUTLET_N float symbol pointer; -#X text 12 205 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 401 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 456 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 563 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 215 361 428 267 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 obj 23 43 delay; -#X obj 67 43 timer; -#X text 8 2 [pipe] Related Objects; -#X text 20 181 The best places to find information about Pd's libraries -is:; -#X text 21 203 www.puredata.org and click on "Downloads" then "Software" -; -#X text 22 218 or; -#X text 21 233 iem.kug.ac.at/pdb/; -#X text 20 132 This object is offered in Pd only if you have downloaded -and properly installed the appropriate library. It may or may not exist -in a single library.; -#X obj 17 105 pddp/helplink iemlib/t3_delay; -#X restore 102 597 pd Related_objects; -#X obj 78 157 cnv 17 3 160 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 181 float; -#X obj 78 410 cnv 17 3 40 empty \$0-pddp.cnv.let.n n 5 9 0 16 -228856 --162280 0; -#X obj 78 374 cnv 17 3 17 empty \$0-pddp.cnv.let.r r 5 9 0 16 -228856 --162280 0; -#X obj 513 11 pipe; -#X text 98 206 symbol; -#X text 98 232 pointer; -#X text 98 259 list; -#X text 98 156 bang; -#X text 98 286 flush; -#X text 98 304 clear; -#X obj 78 328 cnv 17 3 40 empty \$0-pddp.cnv.let.n n 5 9 0 16 -228856 --162280 0; -#X text 98 373 float; -#N canvas 78 30 428 522 Creation_arguments 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 [pipe] Related Objects; -#X obj 23 61 pipe 1000; -#X obj 20 189 pipe s 1000; -#X text 93 189 A pipe for symbols.; -#X obj 20 282 pipe f s 1000; -#X text 115 282 A pipe for one float \, and one symbol.; -#X msg 20 159 symbol cat; -#X msg 92 159 symbol dog; -#X symbolatom 20 210 10 0 0 0 - - -, f 10; -#X symbolatom 95 303 10 0 0 0 - - -, f 10; -#X floatatom 20 303 5 0 0 0 - - -, f 5; -#X msg 31 261 100 dog; -#X msg 20 240 42 cat; -#X floatatom 21 386 0 0 0 0 - - -; -#X floatatom 21 494 0 0 0 0 - - -; -#X obj 21 412 t f f f; -#X obj 49 443 + 1; -#X obj 77 443 + 2; -#X floatatom 64 493 0 0 0 0 - - -; -#X floatatom 108 494 0 0 0 0 - - -; -#X obj 21 469 pipe f f f 1000; -#X text 19 329 Miller's original example shows how a list of floats -can be delayed by [pipe]. Note that the [trigger] object is used to -ensure that [pipe] receives the messages from right to left order. -; -#X text 18 25 1) If only one creation argument is used \, it defines -the initial length of delay. [pipe] will then expect a float.; -#X text 17 87 2) If two or more arguments are provided \, then all -except for the last will define the data type to be expected at the -corresponding inlet. The delay time is initialized by the LAST creation -argument \, which can be changed by sending a new delay time to the -rightmost inlet.; -#X text 72 240 Messages can be sent as lists like this example.; -#X connect 3 0 9 0; -#X connect 5 0 11 0; -#X connect 5 1 10 0; -#X connect 7 0 3 0; -#X connect 8 0 3 0; -#X connect 12 0 5 0; -#X connect 13 0 5 0; -#X connect 14 0 16 0; -#X connect 16 0 21 0; -#X connect 16 1 17 0; -#X connect 16 2 18 0; -#X connect 17 0 21 1; -#X connect 18 0 21 2; -#X connect 21 0 15 0; -#X connect 21 1 19 0; -#X connect 21 2 20 0; -#X restore 170 543 pd Creation_arguments; -#X text 168 304 - forces [pipe] to forget all stored messages.; -#X text 168 259 - a list to the left inlet will be distributed among -[pipe]'s inlets.; -#X obj 95 104 pipe 1000; -#X floatatom 126 53 5 0 0 0 - - -, f 5; -#X msg 95 53 1; -#X floatatom 95 126 5 0 0 0 - - -, f 5; -#X floatatom 162 53 5 0 0 0 - - -, f 5; -#N canvas 80 25 428 536 More_info 0; -#X obj 1 451 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 -0 14 -204280 -1 0; -#X text 20 80 Like water running through a pipe \, it goes in one end...runs -the length of the pipe...then comes out the other end.; -#X floatatom 23 127 5 0 0 0 - - -, f 5; -#X obj 23 148 pipe 20; -#X floatatom 23 170 5 0 0 0 - - -, f 5; -#X text 20 38 The left inlet accepts numbers \, symbols \, pointers -\, messages \, and lists. The right inlet adjusts the delay time (the -length of the pipe).; -#X floatatom 69 127 5 0 0 0 - - -, f 5; -#X text 111 126 Adjust the length of the pipe.; -#X floatatom 23 298 0 0 0 0 - - -; -#X obj 23 391 pipe 2000; -#X text 62 296 numbers to store and output later; -#X text 88 319 output all stored messages immediately; -#X msg 34 323 flush; -#X msg 51 369 clear; -#X text 99 369 forget all stored messages; -#X text 19 199 [pipe] accepts two very important methods.; -#X text 20 219 1 "flush": forces [pipe] to output all stored messages -immediately.; -#X text 20 248 2 "clear": forces [pipe] to forget all stored messages. -; -#X obj 23 412 print; -#X msg 44 344 bang; -#X text 80 344 output the most recently stored message; -#X text 20 267 3 "bang": repeat the most recently stored message again. -; -#X text 20 473 [pipe] schedules its output immediately after storing -the incoming messages. This means that the delay time can be changed -at runtime without effecting the messages that have already been scheduled -for output.; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 8 449 Rescheduling; -#X text 8 2 [pipe] More Info; -#X connect 2 0 3 0; -#X connect 3 0 4 0; -#X connect 6 0 3 1; -#X connect 8 0 9 0; -#X connect 9 0 18 0; -#X connect 12 0 9 0; -#X connect 13 0 9 0; -#X connect 19 0 9 0; -#X restore 101 572 pd More_info; -#X text 11 23 delay a message - a message "delay line"; -#X text 169 93 The [pipe] object stores a sequence of messages and -outputs them after a specified delay time in milliseconds. You can -change the delay time as you wish. The outputs are sorted automatically. -; -#X text 80 475 1) float; -#X text 98 490 symbol atom; -#X text 168 156 - a bang will send the most recently stored message -to the outlet after the specified delay time.; -#X text 168 181 - a float to the left inlet will be stored \, then -sent to the outlet after the specified delay.; -#X text 168 232 - if the first argument to [pipe] is "p" \, an incoming -pointer will be output after the specified delay.; -#X text 168 206 - if the first argument to [pipe] is "s" \, an incoming -symbol will be output after the specified delay.; -#X msg 51 53 flush; -#X msg 9 53 clear; -#X text 168 286 - forces [pipe] to immediately output all stored messages. -; -#X text 168 373 - the rightmost inlet takes a float value that specifies -the length of the delay (in milliseconds).; -#X text 168 327 - an additional inlet is created for each argument -provided to [pipe] besides the delay time. This makes it possible to -send lists through [pipe].; -#X text 98 422 symbol; -#X text 98 409 float; -#X text 98 435 pointer; -#X text 168 409 - pipe can output symbols \, floats \, pointers. One -outlet is created for each argument provided (besides the final argument -to specify delay time).; -#X text 167 475 - (optional) creation arguments define the data type -to be expected at each inlet: "f" for float (or a float \, like "41" -\, to initialize the value) \, "s" for symbol \, and "p" for pointer. -The final argument defines the initial length of delay. See the subpatch -below for more about the arguments:; -#X obj 9 79 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 -1 --1; -#X text 98 327 float; -#X text 98 340 symbol; -#X text 98 353 pointer; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X connect 24 0 27 0; -#X connect 25 0 24 0; -#X connect 26 0 24 0; -#X connect 28 0 24 1; -#X connect 38 0 24 0; -#X connect 39 0 24 0; -#X connect 48 0 24 0; diff --git a/doc/pddp/plot-help.pd b/doc/pddp/plot-help.pd deleted file mode 100644 index 4fdd91dd7..000000000 --- a/doc/pddp/plot-help.pd +++ /dev/null @@ -1,190 +0,0 @@ -#N struct plot-help-template float x float y array array1 plot-help-array1-template -array array2 plot-help-array2-template array array3 plot-help-array3-template -; -#N struct plot-help-array1-template float y; -#N struct plot-help-array2-template float x float y; -#N struct plot-help-array3-template float y float w; -#N canvas 429 31 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 plot 3 12 0 18 -204280 --1 0; -#X obj 0 121 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 540 283 436 344 META 0; -#X text 12 85 LIBRARY internal; -#X text 12 125 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 105 AUTHOR Miller Puckette; -#X text 12 165 HELP_PATCH_AUTHORS Updated for Pd version 0.35. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 5 KEYWORDS control GUI data_structure array; -#X text 12 45 DESCRIPTION draw array elements of scalars; -#X text 12 65 INLET_0 float; -#X text 12 145 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 205 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 229 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 525 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 215 459 428 163 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 [plot] Related Objects; -#X obj 172 53 struct; -#X obj 222 53 drawpolygon; -#X obj 97 53 drawsymbol; -#X obj 302 53 drawcurve; -#X text 17 89 Other Data Structure Objects; -#X obj 255 123 element; -#X obj 86 123 get; -#X obj 117 123 set; -#X obj 146 123 getsize; -#X obj 200 123 setsize; -#X obj 32 123 pointer; -#X obj 26 53 drawnumber; -#X restore 102 597 pd Related_objects; -#X obj 78 130 cnv 17 3 65 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 129 float; -#X text 98 183 list; -#X obj 513 11 plot; -#N canvas 92 134 428 403 plot-help-data 0; -#X scalar plot-help-template 32 98 \; 2 \; -32 \; 12 \; -54 \; -9 \; -\; 0 0 \; 7 14 \; 27 -10 \; 0 -30 \; -40 0 \; 0 50 \; 60 0 \; \; 11 -7 \; 20 5 \; 22 14 \; -20 5 \; 20 11 \; -11 8 \; -17 16 \; \;; -#X obj 0 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 19 206 Above is a scalar defined by "plot-help-template". It -contains three arrays \, each of which has an associated [plot] object -that determines how they will be displayed.; -#X text 7 1 [plot] Window to Display Data Structures; -#X text 19 256 You can click and drag control points that correspond -to the elements of an array.; -#X text 19 286 If the [struct] that defines the array elements has -a "y" field but no "x" field \, then you can click on one control point -\, then drag horizontally to change multiple elements in one swipe -(as you can with the "Put" menu array).; -#X text 19 345 To see/edit the data itself \, select "properties" for -the scalar by right clicking on the purple square.; -#X restore 371 58 pd plot-help-data; -#N canvas 96 163 428 436 plot-help-template 0; -#X obj 22 42 plot array1 500 1 10 15 20; -#X text 19 67 This first example plots the red trace (500) \, width -1 \, at point (10 \, 15) \, with horizontal spacing 20 The black diamonds -come from the template of the array1 element itself.; -#X text 19 228 If a "w" variable is present in the template as for -array3 \, it is added to the line width.; -#X obj 21 374 filledpolygon 509 509 0 -10 -10 10 -10 10 10 -10 10; -#X obj 22 292 struct plot-help-template float x float y array array1 -plot-help-array1-template array array2 plot-help-array2-template array -array3 plot-help-array3-template; -#X obj 22 127 plot curve array2 70 3 100 0; -#X obj 22 208 plot curve array3 9 1 120 50 20; -#X obj 0 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 1 [plot] plot-help-template; -#X text 19 269 Here is the [struct] for all this:; -#X text 19 149 This is the green spiral (color 70 \, line width 3 \, -location (100 \, 0). Since the template for array2 contains an "x" -variable \, play ignores x spacing requests and takes x from the data -itself.; -#X text 18 397 Purple square to mark the left upper corner of the scalar -; -#X restore 371 81 pd plot-help-template; -#N canvas 25 161 428 241 plot-help-array1-template 0; -#X obj 0 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 1 [plot] Element of "array1" in "plot-help-template"; -#X obj 24 198 filledpolygon 0 0 0 -5 0 0 5 5 0 0 -5; -#X obj 23 168 struct plot-help-array1-template float y; -#X text 20 38 The following data structure is defined as an element -of "array1" in the data structure "plot-help-template". It defines -one "y" field \, which is a reserved field that controls the y-value -of GUI objects associated with this template. Notice there is no "x" -field defined-- this means that when the array is plotted \, you can -click on one of the elements (i.e. \, the small black squares defined -by [filledpolygon]) and drag horizontally to change the y-value for -other elements as well.; -#X restore 12 51 pd plot-help-array1-template; -#N canvas 18 155 428 183 plot-help-array2-template 0; -#X obj 0 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 1 [plot] Element of "array2" in "plot-help-template"; -#X obj 22 134 struct plot-help-array2-template float x float y; -#X text 20 36 This data structure is defined as an element for "array2" -in "plot-help-template". No drawing instructions are associated with -this [struct]. The only graphic visible in the "plot-help-data" subwindow -is the trace itself. The thickness and color of the line are defined -solely using the 2nd [plot] object in the "plot-help-template" subwindow. -; -#X restore 12 73 pd plot-help-array2-template; -#N canvas 19 222 428 285 plot-help-array3-template 0; -#X obj 0 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 1 [plot] Element of "array3" in "plot-help-template"; -#X obj 22 223 struct plot-help-array3-template float y float w; -#X text 19 36 This data structure is defined as the element for "array3" -in "plot-help-template". Since the reserved "w" field is defined here -\, you can adjust the width of the line at each element (the mouse -pointer will change to two vertical arrows when you hover over an area -that allows you to change the width). The graphical result is the wavy -blue line in the "plot-help-data" window. For both width and y-value -\, you can click an element and drag horizontally to select and adjust -other elements.; -#X text 19 174 For both width and y-value \, you can click an element -and drag horizontally to select and adjust other elements.; -#X restore 12 94 pd plot-help-array3-template; -#X text 202 82 explanation is in here-->; -#X text 168 129 - sending a zero to the inlet of [plot] will turn off -visibility for the drawing. A nonzero value will turn it back on. By -default the drawing is visible \, unless the -v flag is given as an -argument.; -#X text 98 210 (none); -#X text 11 23 draw array elements of scalars; -#X text 168 183 - a list will be truncated to the first element.; -#X text 80 414 2) float; -#X text 80 442 3) float; -#X text 80 459 4) float; -#X text 80 477 5) float; -#X text 80 493 6) float; -#X text 168 397 - the field to plot.; -#X text 168 414 - RGB color for the trace (0=black \, 999=white \, -900=red \, 90=green \, 9=blue \, 555=grey \, etc.).; -#X text 168 442 - line width of the trace.; -#X text 168 459 - relative x location.; -#X text 168 477 - relative y location.; -#X text 168 493 - x spacing (ignored if the template for the array -contains an "x" variable).; -#X text 80 247 0-6 flags; -#X text 168 248 - "-n" flag to make the drawing invisible initially. -; -#X text 168 264 - "-v [variable]" flag to assign a variable to make -the number visible/invisible.; -#X text 168 292 - "-vs [constant or variable]" flag to set visibility -of scalars along the path of the plot.; -#X text 168 319 - "-x [variable]" flag to use a different x variable. -; -#X text 168 339 - "-y [variable]" flag to use a different y variable. -; -#X text 168 359 - "-w [variable]" flag to use a different w variable. -; -#X text 168 376 - word "curve" to specify bezier.; -#X text 80 397 1) symbol atom; -#X text 79 263 (symbols atoms); -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 98 545 pddp/pddplink all_about_arrays.pd; -#X obj 98 575 pddp/pddplink ../4.data.structures/05.array.pd -text -doc/4.data.structures/05.array.pd; -#X obj 288 530 pddp/pddplink ../4.data.structures/09.scaling.pd -text -doc/4.data.structure/09.scaling.pd; -#X obj 288 545 pddp/pddplink ../4.data.structures/10.onoff.pd -text -doc/4.data.structures/10.onoff.pd; -#X obj 288 560 pddp/pddplink ../4.data.structures/11.array.controls.pd --text doc/4.data.structures/11.array.controls.pd; -#X obj 98 530 pddp/pddplink all_about_z_order.pd; -#X obj 98 560 pddp/pddplink scalar-help.pd; diff --git a/doc/pddp/pointer-help.pd b/doc/pddp/pointer-help.pd deleted file mode 100644 index 45e45e04c..000000000 --- a/doc/pddp/pointer-help.pd +++ /dev/null @@ -1,185 +0,0 @@ -#N struct template2 float x float y float z float q float zz; -#N struct template1 float x float y float z float q; -#N canvas 428 33 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 pointer 3 12 0 18 --204280 -1 0; -#X obj 0 142 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 478 262 496 366 META 0; -#X text 12 165 LIBRARY internal; -#X text 12 205 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 185 AUTHOR Miller Puckette; -#X text 12 245 HELP_PATCH_AUTHORS Updated for Pd version 0.35. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 5 KEYWORDS control data_structure storage nonlocal; -#X text 12 45 DESCRIPTION remember the location of a scalar in a list -; -#X text 12 85 INLET_1 pointer; -#X text 12 105 OUTLET_0 bang pointer; -#X text 12 125 OUTLET_N pointer; -#X text 12 145 OUTLET_R bang; -#X text 12 65 INLET_0 bang pointer traverse next vnext rewind send-window -; -#X text 12 225 RELEASE_DATE 1997; -#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 491 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 568 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 213 516 428 109 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 [pointer] Related Objects; -#X obj 12 34 get; -#X obj 45 34 set; -#X obj 80 34 append; -#X obj 130 34 getsize; -#X obj 186 34 setsize; -#X obj 246 34 element; -#X obj 12 59 sublist; -#X obj 70 59 struct; -#X restore 102 597 pd Related_objects; -#X obj 78 150 cnv 17 3 175 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 360 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 336 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X obj 494 11 pointer; -#X text 98 149 bang; -#X text 98 176 traverse; -#X text 98 227 next; -#X text 98 252 vnext; -#X text 98 335 pointer; -#X text 98 303 rewind; -#X text 98 163 pointer; -#X obj 78 398 cnv 17 3 17 empty \$0-pddp.cnv.let.n n 5 9 0 16 -228856 --162280 0; -#X text 98 359 pointer; -#X text 98 473 bang; -#X obj 78 471 cnv 17 3 17 empty \$0-pddp.cnv.let.r r 5 9 0 16 -228856 --162280 0; -#X text 98 397 pointer; -#X text 168 397 - an additional outlet is created for each argument -(a template name) provided to [pointer]. This makes it possible to -route outgoing pointers to different outlets according to the class -of the scalar being output. Pointers to objects that do not match any -of the specified templates are sent to the second to last outlet.; -#X text 168 303 - reset the pointer to the head of the list.; -#X text 167 335 - stores the value of the pointer without outputting -it.; -#X text 168 163 - an incoming pointer is stored and send to the left -outlet.; -#X text 168 252 - the message "vnext 0" behaves exactly as the "next" -message. "vnext 1" will move to the next selected object. The window -must be visible for the "selection" to make sense (i.e. \, you will -get an error if it is not visible).; -#X text 168 359 - the current value of the pointer. If one or more -arguments are provided \, the first outlet will only output a pointer -to the template specified by the first argument.; -#X obj 78 99 pointer; -#X msg 87 66 bang; -#X msg 126 66 next; -#X obj 78 121 print out1; -#X msg 165 66 vnext 1; -#X msg 224 66 rewind; -#X obj 181 121 print out2:end_of_list; -#N canvas 86 344 428 221 More_on_pointers 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 [pointer] More info; -#X text 20 38 [pointer] is a storage object like [float] \, except -that the thing stored is the location of a scalar somewhere. You can -send a pointer a value (perhaps from another [pointer] object). The -right inlet takes pointers and simply stores them. A bang in the left -outputs the [pointer] \, and a [pointer] in the left both sets and -outputs the value.; -#X text 20 120 The value of a [pointer] can either indicate a real -scalar \, or else the "head" (before the first element) of the list. -This allows you to point to an empty list \, and also \, to "append" -a scalar to the beginning of the list.; -#X text 21 175 Pointers are "safe": if you delete a scalar \, pointers -to it are marked invalid.; -#X restore 101 575 pd More_on_pointers; -#N canvas 103 349 428 192 Arguments_with_pointer 0; -#X text 20 38 Optional arguments to pointer allow you to select according -to the class of the scalar being output:; -#X msg 37 102 next; -#X obj 23 130 pointer help-pointer-template1 help-pointer-template2 -; -#X obj 23 156 print template1; -#X obj 128 156 print template2; -#X obj 233 156 print other; -#X obj 338 156 print bangout; -#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 [pointer] Specifying Creation Arguments; -#X msg 23 79 traverse pd-pointer-help-data; -#X connect 1 0 2 0; -#X connect 2 0 3 0; -#X connect 2 1 4 0; -#X connect 2 2 5 0; -#X connect 2 3 6 0; -#X connect 9 0 2 0; -#X restore 171 549 pd Arguments_with_pointer; -#N canvas 114 187 428 210 pointer-help-data 0; -#X scalar template2 48 120 -32 0 0 \;; -#X scalar template1 163 36 90 0 \;; -#X scalar template1 248 147 9 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 [pointer] Window to Display Scalars; -#X restore 395 81 pd pointer-help-data; -#X msg 78 44 traverse pd-pointer-help-data; -#N canvas 118 187 428 109 pointer-help-template1 0; -#X obj 24 58 filledpolygon z 0 1 0 0 20 0 20 30 0 30; -#X obj 11 32 struct template1 float x float y float z; -#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 [pointer] template1; -#X restore 365 101 pd pointer-help-template1; -#N canvas 107 187 428 106 pointer-help-template2 0; -#X obj 45 65 filledcurve 909 0 0 0 0 30 30 60 0 30 -30 0 0; -#X obj 24 35 struct template2 float x float y; -#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 [pointer] template2; -#X restore 365 121 pd pointer-help-template2; -#X text 11 23 remember the location of a scalar in a list; -#X text 168 227 - move forward one element and output the pointer. -When the end of the list is reached \, a bang goes to the right outlet. -; -#X text 168 176 - "traverse" \, followed by a subwindow name (or patch -filename) sets the value of [pointer] to the "head" of the list. The -"pd-" prefix must be used with the subwindow name \, e.g. \, "traverse -pd-pointer-help-data".; -#X text 98 318 send-window; -#X text 168 473 - a bang at the right outlet signals the end of the -list.; -#X text 168 495 - [pointer] takes (optional) arguments \, each of which -is the name of a template. An additional outlet is created for each -argument \, so that pointers are routed to different outlets based -on the class of scalar being output.; -#X msg 273 65 send-window vis 1; -#X text 168 318 - send a message to the canvas that contains the scalar. -; -#X text 168 149 - outputs the current value of the pointer.; -#X text 98 495 n) float; -#X text 93 510 symbol atom; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 245 575 pddp/pddplink scalar-help.pd; -#X connect 30 0 33 0; -#X connect 30 1 36 0; -#X connect 31 0 30 0; -#X connect 32 0 30 0; -#X connect 34 0 30 0; -#X connect 35 0 30 0; -#X connect 40 0 30 0; -#X connect 49 0 30 0; diff --git a/doc/pddp/poly-help.pd b/doc/pddp/poly-help.pd deleted file mode 100644 index c3bcf9b3d..000000000 --- a/doc/pddp/poly-help.pd +++ /dev/null @@ -1,101 +0,0 @@ -#N canvas 431 32 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 poly 3 12 0 18 -204280 --1 0; -#X obj 0 287 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 482 220 494 405 META 0; -#X text 12 165 LIBRARY internal; -#X text 12 205 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 185 AUTHOR Miller Puckette; -#X text 12 245 HELP_PATCH_AUTHORS Updated for Pd version 0.25. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 5 KEYWORDS control MIDI; -#X text 12 45 DESCRIPTION MIDI-style polyphonic voice allocator; -#X text 12 85 INLET_1 float; -#X text 12 125 OUTLET_1 float; -#X text 12 145 OUTLET_2 float; -#X text 12 65 INLET_0 float list stop clear; -#X text 12 105 OUTLET_0 float; -#X text 12 225 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 435 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 512 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 568 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 220 510 428 109 Related_objects 0; -#X obj 62 43 makenote; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X obj 22 43 route; -#X obj 122 43 pack; -#X text 8 2 [poly] Related Objects; -#X restore 102 597 pd Related_objects; -#X obj 78 296 cnv 17 3 100 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 295 float; -#X text 98 323 list; -#X obj 78 444 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 407 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 98 406 float; -#X text 98 381 clear; -#X obj 503 11 poly; -#X obj 102 190 poly 4 1; -#X msg 153 144 60 0; -#X msg 197 144 62 64; -#X msg 244 144 62 0; -#X obj 102 216 pack 0 0 0; -#X obj 102 242 print; -#X text 147 241 Output is in the printout window.; -#X msg 304 145 stop; -#X msg 346 145 clear; -#X msg 102 144 60 64; -#X text 98 353 stop; -#X text 168 353 - output all values one by one \, ordered according -to voice number \, and clear the memory of [poly].; -#X text 168 381 - clear all stored values.; -#X text 167 406 - the right inlet stores the velocity.; -#X text 11 23 MIDI-style polyphonic voice allocator; -#X text 168 323 - a (pitch \, velocity) pair is distributed to the -two inlets. Lists with more than two elements will be truncated.; -#X text 168 545 - a "1" sets voice stealing \, which is off by default. -; -#X text 168 530 - the first argument sets the number of voices.; -#X text 80 530 1) float; -#X text 80 545 2) float; -#X text 48 56 The [poly] object takes a stream of pitch/velocity pairs -and outputs triples containing voice number \, pitch and velocity. -You can pack the output and use the route object to route messages -among a bank of voices depending on the first outlet. [poly] can be -configured to do voice stealing or not (the default.); -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 78 467 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X obj 78 490 cnv 17 3 17 empty \$0-pddp.cnv.let.2 2 5 9 0 16 -228856 --162280 0; -#X text 98 443 float; -#X text 98 466 float; -#X text 98 489 float; -#X text 168 295 - a float to the left inlet sets the pitch and triggers -the output.; -#X text 168 443 - voice number; -#X text 168 466 - pitch; -#X text 168 489 - velocity; -#X connect 16 0 20 0; -#X connect 16 1 20 1; -#X connect 16 2 20 2; -#X connect 17 0 16 0; -#X connect 18 0 16 0; -#X connect 19 0 16 0; -#X connect 20 0 21 0; -#X connect 23 0 16 0; -#X connect 24 0 16 0; -#X connect 25 0 16 0; diff --git a/doc/pddp/print-help.pd b/doc/pddp/print-help.pd deleted file mode 100644 index c582f1e84..000000000 --- a/doc/pddp/print-help.pd +++ /dev/null @@ -1,153 +0,0 @@ -#N canvas 429 33 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 print 3 12 0 18 --204280 -1 0; -#X obj 0 324 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 484 283 494 344 META 0; -#X text 12 85 LIBRARY internal; -#X text 12 125 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 105 AUTHOR Miller Puckette; -#X text 12 165 HELP_PATCH_AUTHORS This document was updated for Pd -version 0.38.4 by Dave Sabine and Hans-Christoph Steiner as part of -a project called pddp proposed by Krzysztof Czaja to build comprehensive -documentation for Pd. Jonathan Wilkes revised the patch to conform -to the PDDP template for Pd version 0.42.; -#X text 12 5 KEYWORDS control; -#X text 12 45 DESCRIPTION print messages to the terminal window; -#X text 12 65 INLET_0 anything; -#X text 12 145 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 424 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 452 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 535 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 215 517 428 109 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 [print] Related Objects; -#X obj 22 43 print~; -#X restore 102 597 pd Related_objects; -#X obj 78 333 cnv 17 3 80 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 503 11 print; -#X text 98 428 (none); -#N canvas 103 75 428 487 print_oddities 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 [print] Oddities; -#X obj 33 189 print; -#X msg 33 73 1; -#X msg 42 97 float 1; -#X obj 65 161 symbol test; -#X msg 60 120 symbol this; -#X obj 65 142 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X msg 121 310 one 2 three; -#X obj 53 394 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 121 395 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 130 371 print STRAIGHT; -#X msg 105 290 list 1 two 3; -#X msg 88 270 1 two 3; -#X msg 130 331 list one 2 three; -#X obj 56 371 route list; -#X text 20 222 [print] only interprets the "list" selector when the -following body of the message is an implied list \, i.e. a set of atoms -that starts with a float.; -#X text 20 428 This document was updated for Pd version 0.38.4 by Dave -Sabine and Hans-Christoph Steiner as part of a project called pddp -proposed by Krzysztof Czaja to build comprehensive documentation for -Pd.; -#X text 138 114 "symbols" are not interpreted; -#X text 140 129 (i.e. "symbol" is also printed); -#X text 20 38 floats are interpreted (i.e. it doesn't show the word -"float" before the number):; -#X connect 3 0 2 0; -#X connect 4 0 2 0; -#X connect 5 0 2 0; -#X connect 6 0 2 0; -#X connect 7 0 5 0; -#X connect 8 0 11 0; -#X connect 8 0 15 0; -#X connect 12 0 11 0; -#X connect 12 0 15 0; -#X connect 13 0 11 0; -#X connect 13 0 15 0; -#X connect 14 0 11 0; -#X connect 14 0 15 0; -#X connect 15 0 9 0; -#X connect 15 1 10 0; -#X restore 101 569 pd print_oddities; -#X text 98 332 anything; -#X text 168 331 - the [print] object takes any message and prints it -to the console window. When the print object receives a message \, -its output will appear in the console window following the name of -the print object and a colon (:). If the print object does not have -a name (which you can supply as an argument within the print object -itself) then the word "print" appears followed by a colon (:) and your -message.; -#X text 168 428 - [print] routes output directly to the console window. -; -#X msg 159 64 walk the dog; -#X msg 85 64 bang; -#X msg 126 64 234; -#X obj 85 99 print; -#X msg 158 151 walk the dog; -#X msg 85 151 bang; -#X msg 125 151 234; -#X obj 85 188 print myPrintObject; -#X text 209 188 A print object with a name.; -#X text 132 92 A print object without a name. Be sure you can see the -terminal window as you click on these messages.; -#N canvas 105 232 428 300 print_and_lists 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 [print] Lists; -#X text 23 38 When the print object receives a list \, it will output -the entire list as a single message. Like below:; -#X obj 25 98 print print_this_list; -#X msg 25 75 10 20 30 foo; -#X msg 26 180 10 20 30 foo; -#X obj 26 233 unpack f f f s; -#X obj 26 266 print unpack_this_list; -#X text 23 127 To output the list as separate elements \, the list -needs to be unpacked first. Note that [unpack]'s outlets are triggered -from right to left. Like below:; -#X text 37 200 The arguments here are used to tell Pd what type of -atom to expect: (f = float \, s = symbol).; -#X connect 4 0 3 0; -#X connect 5 0 6 0; -#X connect 6 0 7 0; -#X connect 6 1 7 0; -#X connect 6 2 7 0; -#X connect 6 3 7 0; -#X restore 101 544 pd print_and_lists; -#X text 82 219 Use the "-n" flag to suppress "print:" in the output -to the console:; -#X msg 85 253 test; -#X obj 207 286 print; -#X msg 207 254 test; -#X text 159 286 vs.; -#X obj 85 286 print -n; -#X text 168 470 - if you provide a symbol as an argument \, the symbol-- -followed by a colon-- will precede the output when it is sent to the -console. Or you may use the "-n" flag to only print the incoming message -(see example above).; -#X text 78 469 1) symbol atom; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X text 11 23 print messages to the terminal window; -#X connect 15 0 18 0; -#X connect 16 0 18 0; -#X connect 17 0 18 0; -#X connect 19 0 22 0; -#X connect 20 0 22 0; -#X connect 21 0 22 0; -#X connect 27 0 31 0; -#X connect 29 0 28 0; diff --git a/doc/pddp/print~-help.pd b/doc/pddp/print~-help.pd deleted file mode 100644 index 85f1a3750..000000000 --- a/doc/pddp/print~-help.pd +++ /dev/null @@ -1,63 +0,0 @@ -#N canvas 428 36 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 print~ 3 12 0 18 --204280 -1 0; -#X obj 0 427 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 487 287 494 344 META 0; -#X text 12 85 LIBRARY internal; -#X text 12 125 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 105 AUTHOR Miller Puckette; -#X text 12 165 HELP_PATCH_AUTHORS Updated for Pd version 0.33. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 5 KEYWORDS signal; -#X text 12 45 DESCRIPTION print out raw values of a signal; -#X text 12 65 INLET_0 float bang signal; -#X text 12 145 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 512 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 540 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 568 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#X text 98 544 (none); -#N canvas 212 516 428 109 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 obj 22 43 print; -#X obj 62 43 bang~; -#X text 8 2 [print~] Related Objects; -#X restore 102 597 pd Related_objects; -#X obj 78 436 cnv 17 3 65 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 502 8 print~; -#X obj 138 274 print~; -#X msg 150 215 bang; -#X obj 138 189 phasor~ 1000; -#X text 198 216 bang prints one vector; -#X text 190 239 print two or more successive vectors; -#X msg 155 240 2; -#X text 98 435 signal; -#X text 98 456 bang; -#X text 98 476 float; -#X text 168 476 - sending a value of "2" or greater to [print~] will -print the specified number of vectors to the console.; -#X text 98 516 (none); -#X text 11 23 print out raw values of a signal; -#X text 168 435 - an incoming signal.; -#X text 168 456 - outputs one vector to the console.; -#X text 95 141 The [print~] object takes a signal input and prints -one or more vectors out when you send it a bang or a number. By default -a vector is 64 samples.; -#X text 168 516 - [print~] sends its output to the console window. -; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 480 56 pddp/dsp; -#X connect 12 0 11 0; -#X connect 13 0 11 0; -#X connect 16 0 11 0; diff --git a/doc/pddp/qlist-help.pd b/doc/pddp/qlist-help.pd deleted file mode 100644 index 8e08ebf92..000000000 --- a/doc/pddp/qlist-help.pd +++ /dev/null @@ -1,144 +0,0 @@ -#N canvas 426 32 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 qlist 3 12 0 18 --204280 -1 0; -#X obj 0 351 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 482 258 494 366 META 0; -#X text 12 135 LIBRARY internal; -#X text 12 175 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 155 AUTHOR Miller Puckette; -#X text 12 215 HELP_PATCH_AUTHORS Updated for Pd version 0.35. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 45 DESCRIPTION text-based sequencer; -#X text 12 65 INLET_0 bang print tempo rewind next clear add add2 read -write; -#X text 12 95 OUTLET_0 list; -#X text 12 115 OUTLET_1 bang; -#X text 12 5 KEYWORDS control storage nonlocal filesystem list_op; -#X text 12 195 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 393 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 502 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 529 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#X text 98 506 (none); -#N canvas 216 513 428 109 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 [qlist] Related Objects; -#X obj 22 43 textfile; -#X obj 85 43 receive; -#X restore 102 597 pd Related_objects; -#X obj 78 360 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 403 cnv 17 3 37 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 504 11 qlist; -#N canvas 72 97 428 339 messages_to_qlist 0; -#X msg 23 115 rewind; -#X msg 23 139 next; -#X msg 23 67 bang; -#X msg 23 91 tempo 1; -#X text 76 66 sequence automatically; -#X text 76 91 set relative tempo; -#X text 77 114 go to beginning (and stop); -#X text 78 138 single-step forward; -#X text 120 258 read a file; -#X msg 23 259 read qlist.txt; -#X msg 23 282 write /tmp/qlist.txt; -#X msg 23 187 clear; -#X msg 23 211 add 500 this is another message; -#X msg 23 235 add2 that; -#X text 80 186 empty the qlist; -#X text 96 234 add a message to a qlist but don't terminate it; -#X text 78 161 single-step forward SUPRESSING MESSAGE-SENDING; -#X msg 23 163 next 1; -#X msg 23 43 print; -#X text 77 42 print contents to Pd window; -#X obj 23 312 outlet; -#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 [qlist] Messages Accepted by [qlist]; -#X text 156 281 write a file; -#X text 217 210 add a message to a qlist; -#X connect 0 0 20 0; -#X connect 1 0 20 0; -#X connect 2 0 20 0; -#X connect 3 0 20 0; -#X connect 9 0 20 0; -#X connect 10 0 20 0; -#X connect 11 0 20 0; -#X connect 12 0 20 0; -#X connect 13 0 20 0; -#X connect 17 0 20 0; -#X connect 18 0 20 0; -#X restore 76 89 pd messages_to_qlist; -#X obj 76 115 qlist; -#X floatatom 76 163 0 0 0 0 - - -; -#X obj 103 140 print done; -#X text 112 165 This outlet gets a list of leading numbers for the -next message \, for you to use in designing your own sequencer.; -#X text 210 89 <- Click to see messages to qlist; -#X obj 135 276 r this; -#X obj 238 276 r that; -#X obj 135 305 print this; -#X obj 238 305 print that; -#X text 73 231 These receives are invoked in the file "qlist.txt" in -this directory.; -#N canvas 82 159 428 398 More_Info 0; -#X text 20 38 The qlist object reads text files containing time-tagged -Pd messages. You can have them sequenced automatically (by sending -a "bang" message \, possibly changing speed via "tempo" messages) or -manually via the "rewind" and "next" messages.; -#X text 20 228 To run it manually \, send "rewind" followed by "next". -All messages not preceeded by numbers are sent. As soon as a message -starting with one or more numbers is encountered \, the numbers are -output as a list. There are many ways you could design a sequencer -around this.; -#X text 20 298 You can also record textual messages and save them to -a file. Send "clear" to empty the qlist and "add" to add messages (terminated -with semicolons.) The message \, "add2" adds a list of atoms without -finishing with a semicolon in case you want to make variable-length -messages.; -#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 [qlist] More Info; -#X text 20 108 To run the qlist automatically \, send it a "read" message -(the filename is relative to the directory the patch is in) and later -a "bang." Messages in the file are separated by semicolons. Optional -leading numbers are delay times in milliseconds. If the tempo is different -from 1 the messages are sent faster or slower accordingly. Messages -should start with a symbol giving the destination object. In the file -"qlist.q" used here \, the messages go to objects "this" and "that" -which are receives below.; -#X restore 101 538 pd More_Info; -#X text 98 402 list; -#X obj 78 446 cnv 17 3 47 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 98 445 bang; -#X text 168 445 - this outlet gets a bang when you hit the end of the -sequence. In the file "qlist.txt" used in the example above \, the -end is delayed 1000 milliseconds after the last message.; -#X text 11 23 text-based sequencer; -#X text 98 359 See the subpatch "messages_to_qlist" in the example -above for a complete list of messages and their functionalities.; -#X text 168 402 - if you run [qlist] manually (using the "next" message) -\, messages starting with one or more numbers are are output as a list. -; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 98 557 pddp/pddplink ../2.control.examples/23.sequencing.pd --text doc/2.control.examples/23.sequencing.pd; -#X obj 98 572 pddp/pddplink ../3.audio.examples/D13.additive.qlist.pd --text doc/3.audio.examples/D13.additive.qlist.pd; -#X connect 12 0 13 0; -#X connect 13 0 14 0; -#X connect 13 1 15 0; -#X connect 18 0 20 0; -#X connect 19 0 21 0; diff --git a/doc/pddp/random-help.pd b/doc/pddp/random-help.pd deleted file mode 100644 index 5845077fa..000000000 --- a/doc/pddp/random-help.pd +++ /dev/null @@ -1,576 +0,0 @@ -#N canvas 427 34 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 random 3 12 0 18 --204280 -1 0; -#X obj 0 252 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 480 281 494 344 META 0; -#X text 12 125 LIBRARY internal; -#X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 145 AUTHOR Miller Puckette; -#X text 12 205 HELP_PATCH_AUTHORS This help patch was updated for Pd -version 0.35 test 29 by Dave Sabine as part of a project called pddp -proposed by Krzysztof Czaja to build comprehensive documentation for -Pd. Jonathan Wilkes revised the patch to conform to the PDDP template -for Pd version 0.42.; -#X text 12 45 DESCRIPTION pseudorandom integer generator; -#X text 12 5 KEYWORDS control random; -#X text 12 85 INLET_1 float; -#X text 12 105 OUTLET_0 float; -#X text 12 65 INLET_0 bang seed; -#X text 12 185 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 389 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 426 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 476 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 211 256 428 374 Related_objects 0; -#X text 20 255 These objects are offered in Pd only if you have downloaded -and properly installed the appropriate library. These objects may or -may not exist in a single library.; -#X text 20 297 The best places to find information about Pd's libraries -is:; -#X text 21 314 www.puredata.org and click on "Downloads" then "Software" -; -#X text 23 328 or; -#X text 20 343 iem.kug.ac.at/pdb/; -#X obj 20 95 pddp/helplink markex/randomF; -#X obj 20 115 pddp/helplink markex/tripleRand; -#X obj 20 135 pddp/helplink motex/shuffle; -#X obj 20 155 pddp/helplink cxc/utime; -#X obj 20 175 pddp/helplink mjlib/pin~; -#X obj 20 195 pddp/helplink iemmatrix/mtx_rand; -#X obj 20 215 pddp/helplink iemlib/randomblock~; -#X obj 20 235 pddp/helplink cyclone/drunk; -#X text 20 75 Externals; -#N canvas 404 60 483 507 (subpatch) 0; -#X msg 144 296 bang; -#X msg 144 321 1 30; -#X obj 144 409 line~; -#X obj 202 301 del 30; -#X obj 61 433 *~; -#X obj 62 485 dac~; -#X obj 62 359 osc~ 880; -#X obj 62 403 clip~ -1 1; -#X obj 35 220 list split 1; -#X obj 15 311 list; -#X obj 35 244 t b a; -#X obj 62 334 mtof; -#X obj 62 457 *~ 0.07; -#X obj 207 128 metro 50; -#X obj 207 202 s \$0-cnv; -#X obj 207 106 0; -#X obj 207 84 del 3000; -#X obj 310 170 f; -#X obj 342 170 + 1; -#X obj 35 12 r \$0-bng; -#X obj 106 14 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 -1 --1; -#X obj 310 197 div 13; -#X msg 310 314 color \$1 0; -#X obj 242 105 tgl 15 0 empty empty empty 17 7 0 10 -262144 -1 -1 0 -1; -#X obj 279 86 sel 0; -#X obj 279 107 -1; -#X obj 279 130 t a; -#X obj 207 155 f -1; -#X msg 207 180 delta 0 \$1; -#X obj 35 44 spigot 1; -#X obj 35 76 t a b; -#X obj 96 55 0; -#X obj 130 55 1; -#X obj 310 220 sel 3 4; -#X msg 371 246 5 \$1; -#X obj 371 268 -; -#X msg 310 246 1; -#X obj 340 245 f 2; -#X obj 383 170 sel 1; -#X msg 377 198 0; -#X msg 411 199 2; -#X obj 62 311 + 68; -#X obj 15 284 del 170; -#X text 167 14 IT'S A SECRET TO EVERYBODY.; -#X obj 100 100 cnv 15 15 15 empty empty empty 20 12 0 14 -262144 -66577 -0; -#X obj 56 106 loadbang; -#X obj 35 174 list; -#X obj 114 217 s \$0-randomize; -#X obj 71 149 r \$0-new-secret; -#X msg 56 128 7 1 0 8 12 16; -#X obj 35 197 list prepend 11 10; -#X obj 62 381 *~ 1.4; -#X msg 202 323 0 400; -#X connect 0 0 1 0; -#X connect 0 0 3 0; -#X connect 1 0 2 0; -#X connect 2 0 4 1; -#X connect 3 0 52 0; -#X connect 4 0 12 0; -#X connect 6 0 51 0; -#X connect 7 0 4 0; -#X connect 8 0 10 0; -#X connect 8 1 9 1; -#X connect 9 0 8 0; -#X connect 10 0 42 0; -#X connect 10 1 0 0; -#X connect 10 1 41 0; -#X connect 11 0 6 0; -#X connect 12 0 5 0; -#X connect 12 0 5 1; -#X connect 13 0 17 0; -#X connect 13 0 27 0; -#X connect 15 0 13 0; -#X connect 15 0 17 1; -#X connect 16 0 15 0; -#X connect 16 0 23 0; -#X connect 16 0 32 0; -#X connect 17 0 18 0; -#X connect 17 0 21 0; -#X connect 18 0 17 1; -#X connect 19 0 29 0; -#X connect 20 0 29 0; -#X connect 21 0 33 0; -#X connect 22 0 14 0; -#X connect 23 0 24 0; -#X connect 23 0 38 0; -#X connect 24 0 25 0; -#X connect 24 1 26 0; -#X connect 25 0 26 0; -#X connect 26 0 27 1; -#X connect 27 0 28 0; -#X connect 28 0 14 0; -#X connect 29 0 30 0; -#X connect 30 0 13 0; -#X connect 30 0 16 0; -#X connect 30 0 46 0; -#X connect 30 1 31 0; -#X connect 31 0 29 1; -#X connect 32 0 29 1; -#X connect 33 0 36 0; -#X connect 33 1 37 0; -#X connect 33 2 34 0; -#X connect 34 0 35 0; -#X connect 35 0 22 0; -#X connect 36 0 22 0; -#X connect 37 0 22 0; -#X connect 38 0 39 0; -#X connect 38 1 40 0; -#X connect 39 0 37 1; -#X connect 40 0 37 1; -#X connect 41 0 11 0; -#X connect 42 0 9 0; -#X connect 45 0 49 0; -#X connect 46 0 47 0; -#X connect 46 0 50 0; -#X connect 48 0 46 1; -#X connect 49 0 46 1; -#X connect 50 0 8 0; -#X connect 51 0 7 0; -#X connect 52 0 2 0; -#X coords 0 -1 1 1 15 15 2 100 100; -#X restore 266 222 pd; -#X obj 8 3 bng 15 250 50 0 \$0-bng empty empty 17 7 0 10 -262144 -1 --1; -#X obj 23 42 noise~; -#X obj 23 3 bng 15 250 50 0 \$0-bng empty empty 17 7 0 10 -262144 -1 --1; -#X obj 38 3 bng 15 250 50 0 \$0-bng empty empty 17 7 0 10 -262144 -1 --1; -#X obj 53 3 bng 15 250 50 0 \$0-bng empty empty 17 7 0 10 -262144 -1 --1; -#X obj 68 3 bng 15 250 50 0 \$0-bng empty empty 17 7 0 10 -262144 -1 --1; -#X obj 83 3 bng 15 250 50 0 \$0-bng empty empty 17 7 0 10 -262144 -1 --1; -#X obj 98 3 bng 15 250 50 0 \$0-bng empty empty 17 7 0 10 -262144 -1 --1; -#X obj 113 3 bng 15 250 50 0 \$0-bng empty empty 17 7 0 10 -262144 --1 -1; -#X obj 128 3 bng 15 250 50 0 \$0-bng empty empty 17 7 0 10 -262144 --1 -1; -#X obj 173 3 bng 15 250 50 0 \$0-bng empty empty 17 7 0 10 -262144 --1 -1; -#X obj 254 180 cnv 15 40 24 empty empty empty 20 12 0 14 -179689 -66577 -0; -#N canvas 271 87 451 558 (subpatch) 0; -#X obj 27 181 t a b; -#X obj 54 203 f; -#X obj 54 228 + 1; -#X obj 27 282 list prepend; -#X obj 84 203 mod 3; -#X msg 27 255 \$1\$2\$3\$4\$5\$6; -#X obj 179 115 0; -#X obj 27 358 list append; -#X obj 48 331 list append; -#X obj 27 40 t a b; -#X obj 27 304 route 3 2 1; -#X obj 24 119 cnv 15 110 24 empty empty empty 20 12 0 14 -179689 -66577 -0; -#N canvas 222 70 378 565 list-scramble 0; -#X obj 148 213 list; -#X obj 205 294 sel; -#X obj 148 181 t b a; -#X obj 104 372 f; -#X obj 205 267 list split 1; -#X obj 294 267 t a; -#X obj 77 318 spigot; -#X obj 116 291 1; -#X obj 128 318 0; -#X obj 77 98 t b b b; -#X obj 148 240 route bang; -#X msg 152 415 adddollar \$1; -#X msg 152 479 list \$2 \$4 \$1 \$3 \$6 \$5; -#X obj 104 415 s \$0-l; -#X obj 274 153 r \$0-l; -#X obj 77 345 t b b; -#X obj 40 373 f; -#X obj 68 372 + 1; -#X obj 18 442 moses; -#X obj 45 415 r \$0-len; -#X obj 159 -31 inlet; -#X obj 193 60 list length; -#X obj 236 95 s \$0-len; -#X obj 45 468 b; -#X obj 45 495 s \$0-end; -#X obj 77 71 until; -#X obj 120 71 r \$0-end; -#X obj 210 38 s \$0-r; -#X obj 25 318 r \$0-r; -#X obj 223 138 r \$0-r; -#X obj 25 345 0; -#X obj 148 158 + 1; -#X obj 252 395 r \$0-r; -#X obj 159 -4 t a b a b; -#X obj 3 73 s \$0-in; -#X obj 96 450 r \$0-in; -#X obj 152 506 outlet; -#X obj 3 46 list; -#X msg 252 417 set list; -#X obj 274 190 list; -#X obj 274 215 t a; -#X obj 134 131 cnv 15 70 24 empty empty empty 20 12 0 14 -179689 -66577 -0; -#X obj 148 134 random; -#X connect 0 0 10 0; -#X connect 1 0 8 0; -#X connect 2 0 0 0; -#X connect 2 1 1 1; -#X connect 2 1 3 1; -#X connect 3 0 11 0; -#X connect 3 0 13 0; -#X connect 4 0 1 0; -#X connect 4 1 5 0; -#X connect 5 0 4 0; -#X connect 6 0 15 0; -#X connect 7 0 6 1; -#X connect 8 0 6 1; -#X connect 9 0 6 0; -#X connect 9 1 42 0; -#X connect 9 2 7 0; -#X connect 10 1 4 0; -#X connect 11 0 12 0; -#X connect 12 0 36 0; -#X connect 14 0 39 0; -#X connect 15 0 16 0; -#X connect 15 1 3 0; -#X connect 16 0 17 0; -#X connect 17 0 16 1; -#X connect 17 0 18 0; -#X connect 18 1 23 0; -#X connect 19 0 18 1; -#X connect 20 0 33 0; -#X connect 21 0 22 0; -#X connect 21 0 42 1; -#X connect 23 0 24 0; -#X connect 25 0 9 0; -#X connect 26 0 25 1; -#X connect 28 0 30 0; -#X connect 29 0 0 1; -#X connect 29 0 39 1; -#X connect 30 0 16 1; -#X connect 31 0 2 0; -#X connect 32 0 38 0; -#X connect 33 0 37 0; -#X connect 33 1 25 0; -#X connect 33 2 21 0; -#X connect 33 3 27 0; -#X connect 35 0 12 0; -#X connect 37 0 34 0; -#X connect 38 0 12 0; -#X connect 39 0 40 0; -#X connect 39 0 0 1; -#X connect 40 0 39 1; -#X connect 42 0 31 0; -#X restore 27 121 pd list-scramble; -#X obj 27 464 t a b; -#X obj 27 539 s pd-\$0-random-header; -#X msg 72 489 clear \, donecanvasdialog 0 0 2 0 -1 1 1 200 18 0 0 \, -obj 0 0 cnv 15 200 18 empty \$0-pddp.cnv.random-subheading empty 3 -12 0 14 -204280 -1 0; -#X obj 112 20 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 -1 --1; -#X msg 27 67 b j e c t s \, e l a t e d \, r a n d o m; -#X obj 27 17 r \$0-bng; -#X obj 43 409 loadbang; -#X msg 43 436 text 8 0 [random] Related Objects; -#X msg 27 381 text 8 0 [\$1] R\$2 O\$3; -#X text 98 408 <- triggers a dirty flag; -#X obj 56 90 r \$0-randomize; -#N canvas 0 0 450 300 filter-numbers 0; -#X obj 121 55 inlet; -#X obj 121 82 list trim; -#X obj 121 109 route list; -#X obj 178 136 list; -#X obj 178 163 outlet; -#X obj 121 190 s \$0-new-secret; -#X connect 0 0 1 0; -#X connect 1 0 2 0; -#X connect 2 0 5 0; -#X connect 2 1 3 0; -#X connect 3 0 4 0; -#X restore 27 153 pd filter-numbers; -#X connect 0 0 5 0; -#X connect 0 1 1 0; -#X connect 1 0 2 0; -#X connect 2 0 4 0; -#X connect 2 0 3 1; -#X connect 3 0 10 0; -#X connect 4 0 1 1; -#X connect 5 0 3 0; -#X connect 6 0 1 1; -#X connect 7 0 21 0; -#X connect 8 0 7 1; -#X connect 9 0 17 0; -#X connect 9 1 6 0; -#X connect 10 0 7 0; -#X connect 10 1 8 0; -#X connect 10 2 8 1; -#X connect 12 0 24 0; -#X connect 13 0 14 0; -#X connect 13 1 15 0; -#X connect 15 0 14 0; -#X connect 16 0 9 0; -#X connect 17 0 12 0; -#X connect 18 0 9 0; -#X connect 20 0 13 0; -#X connect 21 0 13 0; -#X connect 23 0 12 0; -#X connect 24 0 0 0; -#X restore 263 183 pd; -#X obj 158 3 bng 15 250 50 0 \$0-bng empty empty 17 7 0 10 -262144 --1 -1; -#X obj 143 3 bng 15 250 50 0 \$0-bng empty empty 17 7 0 10 -262144 --1 -1; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#N canvas 0 0 450 300 \$0-random-header 0; -#X obj 0 0 cnv 15 200 18 empty 0-pddp.cnv.random-subheading empty 3 -12 0 14 -204280 -1 0; -#X text 8 0 [random] Related Objects; -#X coords 0 -1 1 1 200 18 2 0 0; -#X restore 11 1 pd \$0-random-header; -#X obj 180 171 cnv 3 210 60 empty \$0-cnv empty 20 12 0 14 -262144 --262144 0; -#X restore 102 597 pd Related_objects; -#X obj 78 261 cnv 17 3 85 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 397 float; -#X obj 78 398 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 356 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 98 355 float; -#X obj 499 10 random; -#X text 81 56 [random] outputs pseudorandom integers between 0 and -N-1 where N is the creation argument or the value of the right inlet. -; -#X obj 84 122 random 100; -#X obj 84 102 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X floatatom 84 144 3 0 0 0 - - -, f 3; -#X text 154 122 Generates random numbers between 0 and 99; -#X obj 84 187 random 100; -#X obj 84 167 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X floatatom 84 210 3 0 0 0 - - -, f 3; -#X floatatom 141 162 5 0 0 0 - - -, f 5; -#X text 181 162 Changes the 'range' of random numbers.; -#X text 98 260 bang; -#X text 98 299 seed; -#X text 168 299 - to specify the seed \, use the seed message followed -by a float ( "seed 42" ).; -#N canvas 65 83 428 454 About_seeds 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 [random] About seeds; -#X text 21 158 However \, "seeds" can be inputted into [random] by -sending a message \, like below:; -#X msg 24 221 seed 42; -#X obj 90 227 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 90 245 random 1000; -#X floatatom 90 265 3 0 0 0 - - -, f 3; -#X obj 24 201 loadbang; -#X text 21 294 Seeds are kept locally so that if two [random]s are -seeded the same \, they will have the same output - as demonstrated -below. Furthermore \, you can seed the same one twice to repeat the -output.; -#X msg 180 363 seed 42; -#X obj 106 366 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 106 398 random 1000; -#X floatatom 106 418 3 0 0 0 - - -, f 3; -#X obj 180 343 loadbang; -#X obj 180 398 random 1000; -#X floatatom 180 418 3 0 0 0 - - -, f 3; -#X text 233 363 Click again to repeat output.; -#X text 20 38 Random numbers are generated via a complex equation which -produces a pseudo-predictable sequence of numbers. Each [random] object's -equation is provided with a "seed" which is really just one of the -variables in the equation which produces the sequence. The "seed" is -generated by Pd based on specific parameters in each patch which contains -a [random] object. If more than one [random] object is contained within -a single patch \, each gets a different "seed".; -#X connect 3 0 5 0; -#X connect 4 0 5 0; -#X connect 5 0 6 0; -#X connect 7 0 3 0; -#X connect 9 0 11 0; -#X connect 9 0 14 0; -#X connect 10 0 11 0; -#X connect 10 0 14 0; -#X connect 11 0 12 0; -#X connect 13 0 9 0; -#X connect 14 0 15 0; -#X restore 171 332 pd About_seeds; -#N canvas 91 66 428 441 More_about_seeds 0; -#X text 20 39 While the "default" seed for each [random] is usually -very effective \, it may be necessary to find better - more unpredictable -- more indeterminate ways to seed the object to produce a more pleasing -result.; -#X text 20 96 Here are some ideas that may improve the implementation -of [random]:; -#X floatatom 202 211 0 0 0 0 - - -; -#X obj 44 138 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 202 182 / 100; -#X floatatom 44 208 0 0 0 0 - - -; -#X text 64 137 Both methods here produce random numbers between 0 and -5; -#X obj 202 157 random 501; -#X obj 44 179 random 6; -#X text 269 157 0 - 500; -#X text 41 239 between 0 and 5; -#X text 41 226 Produces whole numbers; -#X text 20 136 1; -#X text 20 283 2; -#X obj 44 284 loadbang; -#X obj 44 317 timer; -#X obj 106 297 bng 15 250 50 0 empty empty Click_to_seed 0 -8 0 10 --262144 -1 -1; -#X msg 44 343 seed \$1; -#X obj 106 381 bng 15 250 50 0 empty empty Click_for_output 0 -8 0 -10 -262144 -1 -1; -#X floatatom 106 421 5 0 0 0 - - -, f 5; -#X obj 106 400 random 42; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 240 226 between 0 and 5; -#X text 240 212 produces fractional results; -#X text 240 195 within range.; -#X text 240 182 divide by 100 to keep output; -#X text 206 298 "Time is on your side". Using the; -#X text 206 314 [timer] object here (which is; -#X text 206 343 interesting trick.; -#X text 207 329 started via loadbang) is an; -#X text 8 2 [random] More Info on Seeds; -#X connect 3 0 7 0; -#X connect 3 0 8 0; -#X connect 4 0 2 0; -#X connect 7 0 4 0; -#X connect 8 0 5 0; -#X connect 14 0 15 0; -#X connect 15 0 17 0; -#X connect 16 0 15 1; -#X connect 17 0 20 0; -#X connect 18 0 20 0; -#X connect 20 0 19 0; -#X restore 102 485 pd More_about_seeds; -#N canvas 107 145 428 418 weighted_random_numbers 0; -#X msg 23 118 bang; -#X text 20 58 You can generate weighted random numbers from uniformly -distributed ones. If you just want two possible outcomes with a varying -probability for each one \, you can do as shown:; -#X obj 23 144 random 100; -#X obj 23 202 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 89 202 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X floatatom 125 151 3 0 100 0 - - -, f 3; -#X obj 23 177 moses 80; -#X text 20 230 This outputs a number at left 80% of the time \, otherwise -at right \, unless you override the "80" using the number box. You -may extend this to more than two possible outcomes \, for instance -like this:; -#X msg 24 293 bang; -#X obj 24 319 random 100; -#X obj 24 372 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 114 373 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 24 347 moses 10; -#X obj 114 348 moses 30; -#X obj 182 373 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X text 22 388 10%; -#X text 112 389 20%; -#X text 184 388 70%; -#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 [random] Weighted Random Numbers; -#X text 62 117 <- click to test; -#X text 156 150 <- change probablilty; -#X text 64 293 <- click to test; -#X text 20 25 There are many ways that [random] can be incorporated -into other structures that change the qualities of the results.; -#X connect 0 0 2 0; -#X connect 2 0 6 0; -#X connect 5 0 6 1; -#X connect 6 0 3 0; -#X connect 6 1 4 0; -#X connect 8 0 9 0; -#X connect 9 0 12 0; -#X connect 12 0 10 0; -#X connect 12 1 13 0; -#X connect 13 0 11 0; -#X connect 13 1 14 0; -#X restore 102 507 pd weighted_random_numbers; -#X text 11 23 pseudorandom integer generator; -#X text 168 397 - the output is an integer between 0 and N-1.; -#X text 168 442 - sets the initial value of N \, where the output ranges -between 0 and N-1.; -#X text 168 260 - a bang to [random] will output an integer between -0 and N-1 \, where N is the creation argument or the value to the right -inlet.; -#X text 167 355 - a float to the right inlet sets N \, where the output -ranges between 0 and N-1.; -#X text 78 442 1) float; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 102 527 pddp/pddplink ../2.control.examples/19.random.pd -text -doc/2.control.examples/19.random.pd; -#X obj 102 542 pddp/pddplink ../2.control.examples/20.weighted-random.pd --text doc/2.control.examples/20.weighted-random.pd; -#X obj 102 557 pddp/pddplink ../2.control.examples/21.markov.chain.pd --text doc/2.control.examples/21.markov.chain.pd; -#X obj 102 572 pddp/pddplink ../2.control.examples/22.random-walk.pd --text doc/2.control.examples/22.random-walk.pd; -#X connect 15 0 17 0; -#X connect 16 0 15 0; -#X connect 19 0 21 0; -#X connect 20 0 19 0; -#X connect 22 0 19 1; diff --git a/doc/pddp/readsf~-help.pd b/doc/pddp/readsf~-help.pd deleted file mode 100644 index cd7f84918..000000000 --- a/doc/pddp/readsf~-help.pd +++ /dev/null @@ -1,125 +0,0 @@ -#N canvas 430 36 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 readsf~ 3 12 0 18 --204280 -1 0; -#X obj 0 283 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 485 286 494 344 META 0; -#X text 12 125 LIBRARY internal; -#X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 145 AUTHOR Miller Puckette; -#X text 12 205 HELP_PATCH_AUTHORS Updated for version 0.42-4. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 45 DESCRIPTION read a soundfile; -#X text 12 65 INLET_0 float open start stop print; -#X text 12 85 INLET_N signal; -#X text 12 105 OUTLET_R bang; -#X text 12 185 RELEASE_DATE 1997; -#X text 12 5 KEYWORDS signal soundfile; -#X restore 500 597 pd META; -#X obj 0 428 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 510 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 568 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 217 519 428 109 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 obj 23 44 soundfiler; -#X obj 103 44 writesf~; -#X text 8 2 [readsf~] Related Objects; -#X restore 102 597 pd Related_objects; -#X obj 78 292 cnv 17 3 125 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 437 cnv 17 3 17 empty \$0-pddp.cnv.let.n n 5 9 0 16 -228856 --162280 0; -#X obj 492 12 readsf~; -#X text 165 149 The wave \, aiff \, and nextstep formats are parsed -automatically \, although only 2- 3- and 4- byte samples are accepted -(4 bytes implies floating point and is not available in aiff format.) -; -#X text 98 318 open; -#X text 168 318 - the open message is followed by a filename \, an -onset in sample frames \, and \, as an override \, you may also supply -a header size to skip \, a number of channels \, bytes per channel -\, and endianness (see example above).; -#X text 98 367 start; -#X text 98 385 stop; -#X text 98 402 print; -#X text 168 402 - send statistics to the console for debugging.; -#X obj 78 477 cnv 17 3 17 empty \$0-pddp.cnv.let.r r 5 9 0 16 -228856 --162280 0; -#X text 98 476 bang; -#X text 98 436 signal; -#X text 168 436 - [readsf~] defaults to one signal outlet for a single -channel of audio output. An additional inlet is added for each channel -specified by the first creation argument.; -#X text 168 476 - the rightmost inlet sends a bang when the soundfile -is done.; -#X msg 80 124 0; -#X obj 446 231 print didit; -#X obj 120 233 env~ 16384; -#X floatatom 120 252 0 0 0 0 - - -; -#X msg 81 146 print; -#X obj 11 260 dac~; -#X obj 204 232 env~ 16384; -#X floatatom 204 251 0 0 0 0 - - -; -#X obj 11 176 readsf~ 4 1e+06; -#X obj 283 231 env~ 16384; -#X floatatom 283 250 0 0 0 0 - - -; -#X obj 367 231 env~ 16384; -#X floatatom 367 251 0 0 0 0 - - -; -#X msg 11 80 open ../sound/bell.aiff 0 200 4 2 b; -#X obj 71 234 *~ 0.1; -#X obj 12 235 *~ 0.1; -#X msg 11 59 open ../sound/bell.aiff; -#X msg 20 102 start; -#X msg 20 125 stop; -#X text 207 107 The object immediately starts reading from the file -\, but output will only appear after you send a "1" to start playback. -A "0" stops it.; -#X text 109 101 start playback; -#X text 109 123 stop it; -#X text 11 23 read a soundfile; -#X text 168 545 - buffer size per channel in bytes.; -#X text 168 528 - an integer that specifies the number of channels. -; -#X text 79 528 1) float; -#X text 79 545 2) float; -#X msg 80 103 1; -#X text 168 367 - start playback.; -#X text 168 385 - stop playback.; -#X text 98 292 float; -#X text 168 292 - "1" (or any nonzero value) has the same effect as -"start" \, and "0" has the same effect as "stop".; -#X text 195 41 The [readsf~] object reads a soundfile into its signal -outputs. You must open the soundfile in advance (a couple of seconds -before you'll need it) using the "open" message.; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X connect 23 0 31 0; -#X connect 25 0 26 0; -#X connect 27 0 31 0; -#X connect 29 0 30 0; -#X connect 31 0 25 0; -#X connect 31 0 38 0; -#X connect 31 1 29 0; -#X connect 31 1 37 0; -#X connect 31 2 32 0; -#X connect 31 2 37 0; -#X connect 31 3 34 0; -#X connect 31 3 38 0; -#X connect 31 4 24 0; -#X connect 32 0 33 0; -#X connect 34 0 35 0; -#X connect 36 0 31 0; -#X connect 37 0 28 1; -#X connect 38 0 28 0; -#X connect 39 0 31 0; -#X connect 40 0 31 0; -#X connect 41 0 31 0; -#X connect 50 0 31 0; diff --git a/doc/pddp/realtime-help.pd b/doc/pddp/realtime-help.pd deleted file mode 100644 index cd84776e0..000000000 --- a/doc/pddp/realtime-help.pd +++ /dev/null @@ -1,159 +0,0 @@ -#N canvas 428 32 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 realtime 3 12 0 -18 -204280 -1 0; -#X obj 0 376 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 479 256 494 372 META 0; -#X text 12 125 LIBRARY internal; -#X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 185 RELEASE_DATE 2009-06-12; -#X text 12 25 LICENSE SIBSD; -#X text 12 145 AUTHOR Miller Puckette; -#X text 12 205 HELP_PATCH_AUTHORS This help patch was updated for Pd -version 0.35 test 28 by Dave Sabine as part of a project called pddp -proposed by Krzysztof Czaja to build comprehensive documentation for -Pd. Jonathan Wilkes revised the patch to conform to the PDDP template -for Pd version 0.42.; -#X text 12 5 KEYWORDS control time; -#X text 12 45 DESCRIPTION ask operating system for elapsed real time -; -#X text 12 65 INLET_0 bang; -#X text 12 85 INLET_1 bang; -#X text 12 105 OUTLET_0 float; -#X restore 500 597 pd META; -#X obj 0 473 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 510 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 537 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#X text 98 514 (none); -#N canvas 210 352 428 268 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 [realtime] Related Objects; -#X obj 126 43 metro; -#X obj 23 43 cputime; -#X obj 81 43 timer; -#X text 20 134 These objects are offered in Pd only if you have downloaded -and properly installed the appropriate library. These objects may or -may not exist in a single library.; -#X text 19 183 The best places to find information about Pd's libraries -is:; -#X text 20 202 www.puredata.org and click on "Downloads" then "Software" -; -#X text 21 216 or; -#X text 20 231 iem.kug.ac.at/pdb/; -#X text 20 85 Related External Objects; -#X obj 20 110 pddp/helplink iemlib/t3_timer; -#X restore 102 597 pd Related_objects; -#X obj 78 385 cnv 17 3 35 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 481 float; -#X obj 78 482 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 429 cnv 17 3 35 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X obj 486 11 realtime; -#X msg 119 160 bang; -#X msg 94 138 bang; -#X floatatom 94 204 0 0 0 0 - - -; -#X text 166 206 Output is in milliseconds; -#X text 129 138 Click here to start or reset; -#X text 89 91 The [realtime] object measures elapsed "real" time as -measured by your operating system.; -#X obj 94 182 realtime; -#X text 157 161 Click here to get elapsed real time. Click again...and -again...to see periodic measurements from the start or reset time. -; -#X text 90 234 [realtime] works like essentially like a stop-watch. -Once it starts \, you can continue to "poll" [realtime] to view the -elapsed time.; -#X text 90 281 The odd aspect about comparing [realtime] to a stop-watch -is that a stop-watch can be stopped! [realtime] can only be started -or reset. It cannot be stopped.; -#N canvas 108 160 428 429 About_clocks 0; -#X text 20 60 In a fantasy world \, computers could exist somehow beyond -the restrictions of time and digital computation could be performed -in ZERO time. However \, that is not the case. Instead \, every process -within Pd and within your operating system requires at least a few -nanoseconds of your CPU's time.; -#X text 21 145 The [timer] object is like a clock that is not constrained -to the regular laws of physics and the universal space-time continuum. -It reports "time" measurements as only Pd can see them!; -#X text 22 205 The [cputime] object is like a clock that measures how -much time your CPU actually required to carry out your request. Keep -in mind however that your CPU is busy doing many things simoultaneously -\, so even though a process might take 5 minutes to complete \, your -CPU does not pay full attention to that process for the entire 5 minutes. -Instead \, it simply begins the process \, then refers back to that -process from time to time until the it is complete. In other cases -\, your CPU might require a full 5 minutes while Pd might report that -merely a few milliseconds have passed. This type of discrepancy depends -heavily on your computer's hardware and the type of processing it is -performing.; -#X text 21 369 The [realtime] object is as much like your own wrist -watch as Pd can possibly manage. It measures time according to your -operating system's internal clock.; -#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 [realtime] About Clocks; -#X text 21 38 Why the discrepancies between clocks?; -#X restore 102 569 pd About_clocks; -#N canvas 105 140 428 400 Comparing_timers 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 [realtime] Comparing timers in Pd; -#X obj 45 296 time_measurements; -#X obj 45 192 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X floatatom 45 353 0 0 0 0 - - -; -#X floatatom 114 353 0 0 0 0 - - -; -#X floatatom 184 353 0 0 0 0 - - -; -#X text 20 108 In the example below \, I've created an abstraction -which will force each of Pd's stop-watches \, [timer] [cputime] and -[realtime] to measure various processes and report the elapsed time. -Click on each [bng] to begin the process and wait for the results. -Notice the discrepancies in the results.; -#X text 20 371 Logical Time; -#X text 170 371 Real Time; -#X text 104 371 CPU Time; -#X obj 57 228 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X text 65 186 1 Measures elapsed time between two "bangs" from a [trigger] -object.; -#X text 77 220 2 Measures the amount of time Pd requires to turn on -DSP and start an oscillator.; -#X obj 97 260 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X text 118 252 3 Measures the amount of time Pd requires count to -three...please wait for approximately 3 seconds.; -#X text 20 39 As stated above \, [realtime] measures "real" or actual -time. This value may be slightly different that CPU time or "logical" -time. Pd offers two objects which measure CPU time and "logical" time. -See the reference documents for those objects for more information. -; -#X connect 2 0 4 0; -#X connect 2 1 5 0; -#X connect 2 2 6 0; -#X connect 3 0 2 0; -#X connect 11 0 2 1; -#X connect 14 0 2 2; -#X restore 102 547 pd Comparing_timers; -#X text 98 384 bang; -#X text 98 428 bang; -#X text 167 428 - a bang to the right inlet sends the elapsed time -to the outlet. Unlike most other objects in pd \, this is the "hot" -inlet \, i.e. \, it triggers the output.; -#X text 168 384 - a bang to the left inlet resets the timer. Unlike -most other objects in pd \, the left inlet of [realtime] is a "cold" -inlet \, i.e. \, it does not trigger the output.; -#X text 11 23 ask operating system for elapsed real time; -#X text 168 481 - elapsed time in milliseconds.; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X connect 14 0 20 1; -#X connect 15 0 20 0; -#X connect 20 0 16 0; diff --git a/doc/pddp/receive-help.pd b/doc/pddp/receive-help.pd deleted file mode 100644 index 31fe6e5e0..000000000 --- a/doc/pddp/receive-help.pd +++ /dev/null @@ -1,185 +0,0 @@ -#N canvas 431 34 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 receive 3 12 0 18 --204280 -1 0; -#X obj 0 271 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 485 282 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 Dave Sabine \, September 9 \, 2003 -. Jonathan Wilkes revised the patch to conform to the PDDP template -for Pd version 0.42.; -#X text 12 25 KEYWORDS control nonlocal; -#X text 12 65 DESCRIPTION receive messages without patch cords; -#X text 12 85 OUTLET_0 anything; -#X text 12 5 ALIAS r; -#X text 12 165 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 331 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 373 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 434 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 219 333 428 292 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 [receive] Related Objects; -#X text 20 109 Externals and other object libraries; -#X obj 115 43 receive~; -#X obj 177 43 send~; -#X obj 23 43 send; -#X obj 278 43 throw~; -#X obj 333 43 catch~; -#X obj 23 73 tabreceive~; -#X obj 121 73 tabsend~; -#X obj 193 73 netsend; -#X obj 259 73 netreceive; -#X obj 225 43 value; -#X obj 70 43 qlist; -#X obj 20 128 pddp/helplink ggee/streamin~; -#X obj 20 148 pddp/helplink ext13/receive13~; -#X obj 20 168 pddp/helplink maxlib/remote; -#X obj 20 188 pddp/helplink receivelocal; -#X obj 20 208 pddp/helplink maxlib/dist; -#X text 106 188 <- which library? (No help patch exists); -#X obj 20 228 pddp/helplink receiveOSC; -#X text 106 227 <- which library?; -#X text 106 247 <- which library?; -#X obj 20 248 pddp/helplink shoutamp~; -#X obj 20 268 pddp/helplink maxlib/netdist; -#X restore 102 597 pd Related_objects; -#X obj 78 340 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 518 12 r; -#X obj 444 12 receive; -#X text 494 12 or; -#X obj 47 107 s; -#X floatatom 47 83 5 0 0 0 - - -, f 5; -#X floatatom 149 112 5 0 0 0 - - -, f 5; -#X obj 149 83 r; -#X floatatom 204 112 5 0 0 0 - - -, f 5; -#X obj 204 83 r; -#X floatatom 255 112 5 0 0 0 - - -, f 5; -#X obj 255 83 r; -#X floatatom 51 166 5 0 0 0 - - -, f 5; -#X floatatom 306 192 5 0 0 0 - - -, f 5; -#X floatatom 377 192 5 0 0 0 - - -, f 5; -#X floatatom 452 192 5 0 0 0 - - -, f 5; -#X text 50 146 with creation argument; -#X obj 51 190 s dave; -#X obj 306 163 r dave; -#X obj 377 163 r dave; -#X floatatom 151 167 5 0 0 0 - - -, f 5; -#X floatatom 383 82 5 0 0 0 - - -, f 5; -#X msg 383 105 \; dave \$1; -#X floatatom 461 80 5 0 0 0 - - -, f 5; -#X msg 461 105 \; hans \$1; -#X obj 452 163 r hans; -#X obj 151 191 s hans; -#X text 98 275 (none); -#X text 98 339 anything; -#X text 168 339 - [receive] outputs the message(s) sent from a corresponding -[send] of the same name.; -#N canvas 100 55 428 469 Messages_and_Data_Types 0; -#X floatatom 23 177 5 0 0 0 - - -, f 5; -#X floatatom 22 288 5 0 0 0 - - -, f 5; -#X obj 23 234 s a_float; -#X obj 22 262 r a_float; -#X obj 33 205 s whatever; -#X obj 170 204 s whatever; -#X obj 158 233 s a_symbol; -#X obj 158 262 r a_symbol; -#X symbolatom 158 176 10 0 0 0 - - -, f 10; -#X text 62 176 click-n-drag; -#X text 228 176 type something; -#X text 318 200 click this; -#X obj 305 307 s whatever; -#X obj 295 277 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 295 336 s a_bang; -#X text 317 275 click this too; -#X obj 295 379 r a_bang; -#X obj 295 407 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 72 313 r whatever; -#X floatatom 72 443 5 0 0 0 - - -, f 5; -#X symbolatom 113 424 10 0 0 0 - - -, f 10; -#X obj 161 381 print; -#X obj 195 363 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X symbolatom 158 291 10 0 0 0 - - -, f 10; -#X obj 154 404 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X msg 295 217 \; whatever 1 2 3 4 \;; -#X obj 72 338 route float symbol list bang; -#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 [receive] More Info; -#X text 20 38 Pd's [send] and [receive] objects can communicate any -message that is supported by Pd: floats \, anythings \, lists \, symbols -\, and bangs. However \, you will need to plan ahead in your patch -to ensure that a symbol doesn't accidently arrive at a [float] object -\, or that a list doesn't arrive at a [symbol] object. Consider the -following: I have been very careful to keep [send] and [receive] groups -isolated to specific data types - and in the last case \, I have incorporated -a [route] object to properly receive the various data types at a single -[receive] object.; -#X connect 0 0 2 0; -#X connect 0 0 4 0; -#X connect 3 0 1 0; -#X connect 7 0 23 0; -#X connect 8 0 6 0; -#X connect 8 0 5 0; -#X connect 13 0 12 0; -#X connect 13 0 14 0; -#X connect 16 0 17 0; -#X connect 18 0 26 0; -#X connect 26 0 19 0; -#X connect 26 1 20 0; -#X connect 26 2 21 0; -#X connect 26 2 24 0; -#X connect 26 3 22 0; -#X restore 101 569 pd Messages_and_Data_Types; -#X text 11 23 receive messages without patch cords; -#X text 168 391 - [receive] accepts a single argument which is a 'name'. -All [receive]s of the same name correspond to a [send] object of that -name.; -#X text 168 275 - data can be inputted to the [receive] object using -the [send] object or by using the nonlocal send functionality of a -message box. The [receive] object accepts any message as input.; -#X text 334 99 Using; -#X text 334 110 message; -#X text 334 122 boxes; -#X text 80 391 1) symbol atom; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 98 439 pddp/pddplink all_about_send_n_receive.pd -text all_about_send_n_receive -; -#X obj 98 454 pddp/pddplink all_about_scope_and_locality.pd -text all_about_scope_and_locality -; -#X obj 97 512 pddp/pddplink ../2.control.examples/09.send_receive.pd --text doc/2.control.examples/09.send_receive.pd; -#X obj 97 527 pddp/pddplink ../2.control.examples/10.more.messages.pd --text doc/2.control.examples/10.more.messages.pd; -#X obj 97 542 pddp/pddplink ../2.control.examples/13.locality.pd -text -doc/2.control.examples/13.locality.pd; -#X obj 98 475 pddp/pddplink ../1.manual/x2.htm -text doc/1.manual/x2.htm -; -#X obj 98 490 pddp/pddplink ../1.manual/x5.htm -text doc/1.manual/x5.htm -; -#X connect 13 0 12 0; -#X connect 15 0 14 0; -#X connect 17 0 16 0; -#X connect 19 0 18 0; -#X connect 20 0 25 0; -#X connect 26 0 21 0; -#X connect 27 0 22 0; -#X connect 28 0 34 0; -#X connect 29 0 30 0; -#X connect 31 0 32 0; -#X connect 33 0 23 0; diff --git a/doc/pddp/route-help.pd b/doc/pddp/route-help.pd deleted file mode 100644 index f3f8aa152..000000000 --- a/doc/pddp/route-help.pd +++ /dev/null @@ -1,540 +0,0 @@ -#N canvas 427 31 555 685 10; -#X obj 0 697 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 route 3 12 0 18 --204280 -1 0; -#X obj 0 240 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 482 297 494 392 META 0; -#X text 12 85 PLATFORM windows macosx gnulinux; -#X text 12 165 LIBRARY internal; -#X text 12 205 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 35 LICENSE SIBSD; -#X text 12 185 AUTHOR Miller Puckette; -#X text 12 245 HELP_PATCH_AUTHORS This help patch was updated for Pd -version 0.38.4 by Dave Sabine and Hans-Christoph Steiner as part of -a project called pddp proposed by Krzysztof Czaja to build comprehensive -documentation for Pd. Jonathan Wilkes revised the patch to conform -to the PDDP template for Pd version 0.42.; -#X text 12 105 INLET_0 anything; -#X text 12 125 OUTLET_N anything; -#X text 12 145 OUTLET_R anything; -#X text 12 5 KEYWORDS control needs_work list_op symbol_op list_op -anything_op; -#X text 12 225 RELEASE_DATE 1997; -#X text 12 55 DESCRIPTION route a message according to the selector -or first element; -#X restore 500 699 pd META; -#X obj 0 447 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 576 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 672 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 211 576 428 109 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 [route] Related Objects; -#X obj 22 43 select; -#X obj 72 43 spigot; -#X obj 123 43 moses; -#X restore 102 699 pd Related_objects; -#X obj 78 249 cnv 17 3 125 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 456 cnv 17 3 17 empty \$0-pddp.cnv.let.0 n 5 9 0 16 -228856 --162280 0; -#X obj 508 12 route; -#X obj 27 113 route 0 1; -#X msg 27 61 0 12; -#X msg 65 61 1 13; -#X msg 103 61 2 14; -#X obj 78 156 print rejection_outlet; -#X obj 27 200 print left_outlet; -#X obj 78 136 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 -1 --1; -#X obj 52 178 print middle_outlet; -#X obj 52 136 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 -1 --1; -#X obj 27 136 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 -1 --1; -#X msg 140 61 7 17; -#N canvas 414 108 516 509 float_mode 0; -#X text 89 271 float; -#X text 89 365 list; -#X text 89 325 symbol; -#X text 89 455 pointer; -#X text 139 455 - a pointer is always sent to the rightmost outlet. -; -#X text 89 438 bang; -#X text 139 271 - the incoming value is compared to the creation argument(s). -If there is a match \, a bang is sent to the outlet corresponding to -the matching creation argument. If there is no match the input is sent -to the rightmost outlet.; -#X obj 0 0 cnv 15 515 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 8 2 [route] Message Handling in "Float Mode"; -#X obj 1 261 cnv 3 500 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#X obj 70 270 cnv 17 3 225 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 138 438 - a bang will be sent to the rightmost inlet.; -#X text 88 481 All other messages will be sent to the rightmost outlet. -; -#X msg 141 50 2; -#X msg 148 72 1 2 3; -#X obj 141 167 bng 12 250 50 0 empty empty empty 17 7 0 10 -262144 --1 -1; -#X obj 162 167 bng 12 250 50 0 empty empty empty 17 7 0 10 -262144 --1 -1; -#X msg 169 116 something else; -#X obj 204 167 print rejection_outlet; -#X obj 141 233 print out0; -#X obj 162 211 print out1; -#X text 50 26 For "float mode" \, the first argument must be a float. -; -#X obj 141 142 route 1 2 3; -#X obj 183 189 print out2; -#X obj 183 167 bng 12 250 50 0 empty empty empty 17 7 0 10 -262144 --1 -1; -#X msg 158 94 3 dog night; -#X text 139 325 - the symbol is compared to the creation arguments -\, and a bang is sent to the corresponding outlet if there is a match. -; -#X text 139 365 - the first element of the list is compared to the -creation argument(s). If there is a match \, the first element is removed -from the list \, and the remaining list is sent to the outlet corresponding -to the matching creation argument. If there is no match the input is -sent to the rightmost outlet.; -#X connect 13 0 22 0; -#X connect 14 0 22 0; -#X connect 17 0 22 0; -#X connect 22 0 15 0; -#X connect 22 0 19 0; -#X connect 22 1 16 0; -#X connect 22 1 20 0; -#X connect 22 2 23 0; -#X connect 22 2 24 0; -#X connect 22 3 18 0; -#X connect 25 0 22 0; -#X restore 171 306 pd float_mode; -#X text 98 249 anything; -#X text 168 249 - [route] handles its input in 3 different "modes" -\, depending on what the creation arguments are. Click the subpatches -below to see how message types are handled under each mode.; -#N canvas 289 73 516 599 selector_mode 0; -#X text 88 548 pointer; -#X text 138 548 - a pointer is always sent to the rightmost outlet. -; -#X obj 0 0 cnv 15 515 21 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X obj 0 389 cnv 3 500 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#X obj 69 398 cnv 17 3 255 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 68 244 bng 12 250 50 0 empty empty empty 17 7 0 10 -262144 -1 --1; -#X obj 101 244 bng 12 250 50 0 empty empty empty 17 7 0 10 -262144 --1 -1; -#X obj 203 262 print rejection_outlet; -#X msg 68 59 der; -#X obj 68 349 print out0; -#X obj 101 327 print out1; -#X text 7 1 [route] Message Handling in "Selector Mode"; -#X msg 92 690 foo; -#X msg 101 718 symbol foo; -#X obj 169 283 print out3; -#X obj 92 840 print out0; -#X obj 133 818 print out1; -#X text 120 690 the selector "foo" matches the first argument; -#X text 171 718 the selector "symbol" matches the second argument; -#X text 88 398 bang; -#X text 138 398 - if one of the creation arguments is "bang" \, then -a bang will be sent out the corresponding outlet.; -#X text 138 428 - if one of the creation arguments is "float" \, then -an incoming float will be sent out the corresponding outlet.; -#X text 88 428 float; -#X text 88 458 list; -#X text 138 458 - if one of the creation arguments is "list" \, then -two behaviors are possible:; -#X text 138 484 a) if the first element is a float \, the list is sent -out the corresponding outlet.; -#X text 138 509 b) if the first element is a symbol \, the "list" selector -is removed \, and the remaining message is sent out the corresponding -outlet.; -#X text 88 568 symbol; -#X text 138 568 - if one of the creation arguments is "symbol" \, then -an incoming symbol will be sent out the corresponding outlet.; -#X text 87 596 All other messages - the selector of the incoming message -is compared to the creation argument(s). If there is a match \, the -selector is stripped and the remaining message is sent to the corresponding -outlet. If there is no match the input is sent to the rightmost outlet. -; -#X text 91 667 Beware! All this can be confusing at times...; -#X msg 84 103 das; -#X obj 135 305 print out2; -#X obj 135 244 bng 12 250 50 0 empty empty empty 17 7 0 10 -262144 --1 -1; -#X obj 169 244 bng 12 250 50 0 empty empty empty 17 7 0 10 -262144 --1 -1; -#X msg 108 182 doh; -#X obj 203 244 bng 12 250 50 0 empty empty empty 17 7 0 10 -262144 --1 -1; -#X msg 74 81 die 41; -#X text 49 36 In selector mode \, all creation arguments should be -symbols.; -#X obj 68 221 route der die das float; -#X msg 93 125 float 41; -#X msg 103 153 41; -#X text 135 147 (Remember: a single float "n" in a message or object -box is shorthand for "float n"); -#X text 134 181 sent to the rightmost outlet (the "rejection outlet") -; -#X obj 92 774 route foo symbol list; -#X obj 174 796 print out2; -#X msg 128 744 2 3 four; -#X text 189 744 an implicit list-- matches the third argument; -#X connect 8 0 39 0; -#X connect 12 0 44 0; -#X connect 13 0 44 0; -#X connect 31 0 39 0; -#X connect 35 0 39 0; -#X connect 37 0 39 0; -#X connect 39 0 5 0; -#X connect 39 0 9 0; -#X connect 39 1 6 0; -#X connect 39 1 10 0; -#X connect 39 2 32 0; -#X connect 39 2 33 0; -#X connect 39 3 14 0; -#X connect 39 3 34 0; -#X connect 39 4 7 0; -#X connect 39 4 36 0; -#X connect 40 0 39 0; -#X connect 41 0 39 0; -#X connect 44 0 15 0; -#X connect 44 1 16 0; -#X connect 44 2 45 0; -#X connect 46 0 44 0; -#X restore 171 331 pd selector_mode; -#X obj 78 496 cnv 17 3 17 empty \$0-pddp.cnv.let.0 r 5 9 0 16 -228856 --162280 0; -#X text 98 497 anything; -#X text 80 594 1) float; -#X text 168 594 - [route] can take symbols or floats as arguments. -(Note: the first argument determines which "mode" below.) If floats -are used \, [route] operates in "float mode"-- if symbols are used -\, float operates in "selector mode." See the subpatches above to see -how incoming data is handled in each mode.; -#X obj 4 699 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 100 675 pddp/pddplink ../2.control.examples/18.conditional.pd --text doc/2.control.examples/18.conditional.pd; -#X msg 140 85 Grizabella; -#X text 11 23 route a message according to the selector or first element -; -#N canvas 592 32 426 587 type_mode 0; -#X obj 0 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 1 [route] Message Handling in "Type Mode"; -#X msg 85 305 bang; -#X msg 96 348 symbol pie; -#X msg 99 368 pie; -#X msg 74 265 1 2 3; -#X text 93 224 a float; -#X text 119 264 a list (of floats); -#X text 122 305 a bang; -#X text 175 348 a symbol; -#X text 133 369 none of the above!; -#X text 178 284 a list of symbols; -#X floatatom 109 425 5 0 0 0 - - -, f 5; -#X symbolatom 157 424 10 0 0 0 - - -, f 10; -#X obj 62 445 bng 15 250 50 0 empty empty bang -6 23 1 12 -262144 -1 --1; -#X msg 62 225 89; -#X msg 68 245 float 7; -#X obj 62 401 route bang float symbol list; -#X obj 109 445 bng 15 250 50 0 empty empty float -4 23 1 12 -262144 --1 -1; -#X obj 157 445 bng 15 250 50 0 empty empty symbol -12 23 1 12 -262144 --1 -1; -#X obj 205 445 bng 15 250 50 0 empty empty list -2 23 1 12 -262144 --1 -1; -#X obj 253 445 bng 15 250 50 0 empty empty undefined -18 23 1 12 -262144 --1 -1; -#X msg 80 285 list moon earth; -#X text 123 243 definitely a float!; -#X text 49 482 [trigger]-style shortcuts don't work:; -#X text 162 501 !=; -#X obj 63 502 route b f s l; -#X obj 184 502 route bang float symbol list; -#N canvas 0 22 466 633 routing_data_types 0; -#X obj 334 314 route symbol; -#X obj 336 334 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 413 335 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 331 361 route symbol; -#X obj 333 381 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 410 382 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X msg 318 269 test; -#X msg 357 269 symbol test; -#X obj 58 331 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 135 331 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 55 378 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 132 378 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X msg 89 266 bang; -#X obj 56 311 route bang; -#X obj 53 358 route bang; -#X text 14 5 routing based on reserved words:; -#X obj 188 331 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 265 331 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 185 378 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 262 378 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 186 311 route float; -#X obj 183 358 route float; -#X msg 170 266 1; -#X msg 209 266 float 12; -#X obj 181 542 route list; -#X obj 181 561 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 249 562 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 168 580 route list; -#X obj 168 599 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 236 600 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X msg 184 493 list 1 two 3; -#X msg 167 473 1 two 3; -#X msg 200 513 list one 2 three; -#X msg 365 289 symbol; -#X msg 113 484 list; -#X msg 224 287 float test; -#X text 26 245 These all output the as same atom type that is routed: -; -#X msg 15 266 bang test; -#X obj 71 131 route 1; -#X msg 71 183; -#X obj 71 164 prepend set; -#X msg 71 100 1 2 3 4; -#X msg 218 183; -#X obj 218 164 prepend set; -#X obj 218 131 route this; -#X msg 218 100 this is not a list; -#X text 21 50 [route] has three modes \, first is float \, second is -symbol \, and third is data type. In the first two modes \, the first -element of the set is stripped off by [route].; -#X text 26 206 In the third mode \, [route] outputs the same atom type -(bang->bang \, float->float \, symbol->symbol).; -#X text 26 419 Lists do not behave the same with [route list] even -though it is interpreting incoming lists \, not just routing by keyword -\, as in the second symbol mode.; -#X msg 174 164 set; -#X text 157 164 re; -#X text 164 24 "bang" \, "float" \, "symbol" \, and "list"; -#X connect 0 0 1 0; -#X connect 0 0 3 0; -#X connect 0 1 2 0; -#X connect 3 0 4 0; -#X connect 3 1 5 0; -#X connect 6 0 0 0; -#X connect 7 0 0 0; -#X connect 12 0 13 0; -#X connect 13 0 8 0; -#X connect 13 0 14 0; -#X connect 13 1 9 0; -#X connect 14 0 10 0; -#X connect 14 1 11 0; -#X connect 20 0 16 0; -#X connect 20 0 21 0; -#X connect 20 1 17 0; -#X connect 21 0 18 0; -#X connect 21 1 19 0; -#X connect 22 0 20 0; -#X connect 23 0 20 0; -#X connect 24 0 25 0; -#X connect 24 0 27 0; -#X connect 24 1 26 0; -#X connect 27 0 28 0; -#X connect 27 1 29 0; -#X connect 30 0 24 0; -#X connect 31 0 24 0; -#X connect 32 0 24 0; -#X connect 33 0 0 0; -#X connect 34 0 24 0; -#X connect 35 0 20 0; -#X connect 37 0 13 0; -#X connect 38 0 40 0; -#X connect 40 0 39 0; -#X connect 41 0 38 0; -#X connect 43 0 42 0; -#X connect 44 0 43 0; -#X connect 45 0 44 0; -#X connect 49 0 42 0; -#X connect 49 0 39 0; -#X restore 71 549 pd routing_data_types; -#X text 47 529 More info:; -#X text 20 37 In type mode \, the arguments are zero or one of the -four reserved words: "bang" \, "float" \, "symbol" \, and "list". Instead -of matching the 'value' of a message \, the [route] object will match -'data type': i.e. lists will be sent through the first outlet \, floats -will be sent through the second outlet \, symbols through the third -outlet \, bangs through the fourth outlet. The fifth outlet will then -output anything that does not match one of the previously defined data -types (i.e. the "pie" message below is a text message that hasn't been -defined as a 'symbol' - hence \, Pd cannot determine which data type -it is and it will be output through the right-most outlet).; -#N canvas 0 22 450 300 special_cases_of_lists 0; -#X msg 87 54 list; -#X msg 88 87 list 5; -#X text 65 23 SPECIAL CASES OF LISTS.; -#X floatatom 107 188 5 0 0 0 - - -, f 5; -#X symbolatom 155 187 10 0 0 0 - - -, f 10; -#X obj 60 208 bng 15 250 50 0 empty empty bang -6 23 1 12 -262144 -1 --1; -#X msg 88 124 list not-a-list; -#X obj 60 164 route bang float symbol list; -#X obj 107 208 bng 15 250 50 0 empty empty float -4 23 1 12 -262144 --1 -1; -#X obj 155 208 bng 15 250 50 0 empty empty symbol -12 23 1 12 -262144 --1 -1; -#X obj 203 208 bng 15 250 50 0 empty empty list -2 23 1 12 -262144 --1 -1; -#X obj 251 208 bng 15 250 50 0 empty empty undefined -18 23 1 12 -262144 --1 -1; -#X text 86 40 An empty list is translated into a bang; -#X text 86 73 A list with only one float is translated to a float; -#X text 86 109 A list with only one symbol is translated to a symbol -; -#X connect 0 0 7 0; -#X connect 1 0 7 0; -#X connect 3 0 8 0; -#X connect 4 0 9 0; -#X connect 6 0 7 0; -#X connect 7 0 5 0; -#X connect 7 1 3 0; -#X connect 7 2 4 0; -#X connect 7 3 10 0; -#X connect 7 4 11 0; -#X restore 211 549 pd special_cases_of_lists; -#X obj 91 328 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 -1 --1; -#X text 108 326 also a bang; -#X connect 2 0 17 0; -#X connect 3 0 17 0; -#X connect 4 0 17 0; -#X connect 5 0 17 0; -#X connect 12 0 18 0; -#X connect 13 0 19 0; -#X connect 15 0 17 0; -#X connect 16 0 17 0; -#X connect 17 0 14 0; -#X connect 17 1 12 0; -#X connect 17 2 13 0; -#X connect 17 3 20 0; -#X connect 17 4 21 0; -#X connect 22 0 17 0; -#X connect 32 0 17 0; -#X restore 171 356 pd type_mode; -#X text 277 356 match the type of the message; -#X text 277 331 match first symbol in the message; -#X text 261 306 match first float in the message; -#X text 98 457 anything; -#X text 168 540 An incoming pointer will never match and so will always -be sent to the rejection outlet.; -#X text 168 456 - an outlet is added for each argument. Messages that -match are output from the respective outlet with its first element -stripped off.; -#X text 168 497 - the rightmost outlet of [route] is always the "rejection -outlet." Incoming messages which do not match any of the arguments -are sent to the rightmost outlet unchanged.; -#X text 97 608 symbol; -#X obj 78 387 cnv 17 3 45 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 98 386 float; -#N canvas 79 52 428 344 second_inlet 0; -#X floatatom 68 278 5 0 0 0 - - -, f 5; -#X floatatom 31 232 5 0 0 0 - - -, f 5; -#X floatatom 80 234 5 0 0 0 - - -, f 5; -#X obj 217 301 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X msg 203 206 symbol word; -#X msg 217 228 symbol other; -#X msg 315 240 symbol other; -#X obj 274 301 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X msg 312 216 symbol word; -#X obj 1 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 8 1 [route] The Second Inlet; -#X text 20 38 The right inlet is used to reset the argument's value -as in the patch below. This feature is available only on [route] objects -with only ONE creation argument (or no creation arguments in which -case it takes on the default value of 0). In the other examples with -multiple creation arguments \, you'll notice that this second inlet -is absent.; -#X obj 23 256 route 42; -#X obj 217 276 route word; -#X floatatom 23 278 5 0 0 0 - - -, f 5; -#X msg 23 210 42; -#X obj 217 255 list trim; -#X text 20 128 Also notice in the right example how symbols need to -be truncated of its symbol prefix using [list trim] or using a message. -Otherwise \, route will not recognize the value correctly.; -#X msg 164 206 word; -#X msg 125 182 symbol word; -#X connect 1 0 12 0; -#X connect 2 0 12 1; -#X connect 4 0 16 0; -#X connect 5 0 16 0; -#X connect 6 0 13 1; -#X connect 8 0 13 1; -#X connect 12 0 14 0; -#X connect 12 1 0 0; -#X connect 13 0 3 0; -#X connect 13 1 7 0; -#X connect 15 0 12 0; -#X connect 16 0 13 0; -#X connect 18 0 13 0; -#X connect 19 0 13 0; -#X restore 171 416 pd second_inlet; -#X text 98 400 symbol; -#X text 167 386 - the right inlet is available if there is only one -creation argument. See the subpatch below for details:; -#X obj 258 145 route word; -#X obj 269 110 list trim; -#X obj 315 168 print rejection_outlet; -#X obj 258 192 print left_outlet; -#X symbolatom 355 86 10 0 0 0 - - -, f 10; -#X symbolatom 334 119 10 0 0 0 - - -, f 10; -#X text 398 119 This one doesn't work; -#X msg 269 85 symbol word; -#X msg 258 60 word; -#X connect 11 0 16 0; -#X connect 11 0 20 0; -#X connect 11 1 18 0; -#X connect 11 1 19 0; -#X connect 11 2 15 0; -#X connect 11 2 17 0; -#X connect 12 0 11 0; -#X connect 13 0 11 0; -#X connect 14 0 11 0; -#X connect 21 0 11 0; -#X connect 32 0 11 0; -#X connect 48 0 51 0; -#X connect 48 1 50 0; -#X connect 49 0 48 0; -#X connect 52 0 49 0; -#X connect 53 0 48 0; -#X connect 55 0 49 0; -#X connect 56 0 48 0; diff --git a/doc/pddp/rpole~-help.pd b/doc/pddp/rpole~-help.pd deleted file mode 100644 index e17d2697b..000000000 --- a/doc/pddp/rpole~-help.pd +++ /dev/null @@ -1,141 +0,0 @@ -#N canvas 428 34 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 rpole~ 3 12 0 18 --204280 -1 0; -#X obj 0 338 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 484 286 494 344 META 0; -#X text 12 125 LIBRARY internal; -#X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 145 AUTHOR Miller Puckette; -#X text 12 205 HELP_PATCH_AUTHORS Updated for Pd version-0.38. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 5 KEYWORDS signal filter; -#X text 12 45 DESCRIPTION real one-pole (recursive) filter \, raw; -#X text 12 85 INLET_1 float signal; -#X text 12 65 INLET_0 signal clear set; -#X text 12 105 OUTLET_0 signal; -#X text 12 185 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 454 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 486 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 528 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#X obj 78 347 cnv 17 3 55 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 463 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 413 cnv 17 3 30 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X obj 497 10 rpole~; -#X floatatom 152 194 0 0 0 0 - - -; -#X obj 96 107 osc~ 100; -#X msg 111 139 clear; -#X msg 113 165 set 1; -#X text 163 165 <-- set internal state; -#X text 163 108 <-- signal to filter; -#X text 182 195 <-- filter coefficient (may be a signal); -#X text 182 217 <-- creation argument initializes filter coefficient -; -#X text 163 139 <-- clear internal state to zero; -#X obj 95 217 rpole~ 0.9; -#N canvas 93 273 326 287 test 0; -#X obj 76 78 osc~; -#X floatatom 76 55 5 0 0 0 - - -, f 5; -#X obj 77 219 env~ 16384; -#X floatatom 77 243 5 0 0 0 - - -, f 5; -#X obj 76 168 rpole~; -#X obj 104 107 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0 -1; -#X obj 76 105 *~; -#X msg 97 137 set 1; -#X floatatom 172 157 4 -100 100 0 - - -, f 4; -#X obj 172 182 / 100; -#X obj 214 256 dac~; -#X obj 228 177 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0 -1; -#X obj 214 220 *~; -#X obj 230 197 / 10; -#X text 80 18 Stuff to test it:; -#X connect 0 0 6 0; -#X connect 1 0 0 0; -#X connect 2 0 3 0; -#X connect 4 0 2 0; -#X connect 4 0 12 0; -#X connect 5 0 6 1; -#X connect 6 0 4 0; -#X connect 7 0 4 0; -#X connect 8 0 9 0; -#X connect 9 0 4 1; -#X connect 11 0 13 0; -#X connect 12 0 10 0; -#X connect 12 0 10 1; -#X connect 13 0 12 1; -#X restore 101 537 pd test; -#X text 11 23 real one-pole (recursive) filter \, raw; -#X text 50 58 [rpole~] filters an audio signal (left inlet) via a one-pole -real filter \, whose coefficient is controlled by a creation argument -or by an audio signal (right inlet).; -#X text 98 346 signal; -#X text 168 346 - the incoming signal to filter.; -#X text 98 366 clear; -#X text 168 366 - clear internal state to zero.; -#X text 98 386 set; -#X text 168 386 - set internal state (e.g. \, "set 1").; -#X text 98 412 float; -#X text 98 462 signal; -#X text 168 462 - the outgoing \, filtered signal.; -#X text 108 264 y[n] = y[n-1] + a[n] * x[n]; -#X text 49 316 The transfer function is H(Z) = 1/(1 - aZ^-1).; -#X text 49 284 where y[n] is the output \, x[n] the input \, and a[n] -the filter coefficient. The filter is unstable if/when |a[n]|>1.; -#X text 80 505 1) float; -#N canvas 212 318 428 309 Related_objects 0; -#X obj 74 60 rzero~; -#X obj 25 80 cpole~; -#X obj 25 60 rpole~; -#X obj 123 60 rzero_rev~; -#X obj 74 80 czero~; -#X obj 123 80 czero_rev~; -#X text 201 60 real; -#X text 200 81 complex; -#X text 22 44 1-pole; -#X text 71 44 1-zero; -#X text 121 44 1-zero \, reversed; -#X text 47 29 summary of raw filters:; -#X text 18 184 User-friendly Filters; -#X obj 21 213 lop~; -#X obj 72 212 hip~; -#X obj 124 213 bp~; -#X obj 169 214 vcf~; -#X obj 22 274 biquad~; -#X text 18 250 Other Objects; -#X text 18 113 Pd also provides a suite of user-friendly filters. This -and other raw filters are provided for situations which the user-friendly -ones can't handle. See Chapter 8 of http://crca.ucsd.edu/~msp/techniques -for an introduction to the necessary theory.; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 1 [rpole~] Related Objects; -#X restore 101 597 pd Related_objects; -#X text 98 430 signal; -#X text 167 430 - filter coefficient.; -#X text 167 412 - filter coefficient.; -#X text 167 505 - (optional) initializes filter coefficient.; -#X text 49 242 The action of [rpole~] is:; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 473 58 pddp/dsp; -#X obj 98 557 pddp/pddplink ../3.audio.examples/H11.shelving.pd -text -doc/3.audio.examples/H11.shelving.pd; -#X obj 98 572 pddp/pddplink ../3.audio.examples/H14.all.pass.pd -text -doc/3.audio.examples/H14.all.pass.pd; -#X connect 11 0 20 1; -#X connect 12 0 20 0; -#X connect 13 0 20 0; -#X connect 14 0 20 0; diff --git a/doc/pddp/rsqrt~-help.pd b/doc/pddp/rsqrt~-help.pd deleted file mode 100644 index ccca26b03..000000000 --- a/doc/pddp/rsqrt~-help.pd +++ /dev/null @@ -1,73 +0,0 @@ -#N canvas 427 35 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 rsqrt~ 3 12 0 18 --204280 -1 0; -#X obj 0 468 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 483 290 494 344 META 0; -#X text 12 105 LIBRARY internal; -#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 125 AUTHOR Miller Puckette; -#X text 12 185 HELP_PATCH_AUTHORS Updated for Pd version 0.33. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 45 DESCRIPTION signal reciprocal square root; -#X text 12 5 KEYWORDS signal; -#X text 12 65 INLET_0 signal; -#X text 12 85 OUTLET_0 signal; -#X text 12 165 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 504 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 540 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 567 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#X text 98 544 (none); -#N canvas 213 526 428 105 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 obj 22 43 sqrt~; -#X obj 137 43 q8_sqrt~; -#X obj 67 43 q8_rsqrt~; -#X obj 197 43 sqrt; -#X text 8 2 [rsqrt~] Related Objects; -#X restore 102 597 pd Related_objects; -#X obj 78 476 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 513 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 500 11 rsqrt~; -#X obj 233 261 metro 500; -#X obj 233 236 r metro; -#X floatatom 217 157 0 0 0 0 - - -; -#X floatatom 217 319 0 0 0 0 - - -; -#X obj 217 294 snapshot~; -#X floatatom 217 404 9 0 0 0 - - -, f 9; -#X obj 217 346 t f f; -#X obj 217 375 *; -#X obj 217 183 sig~; -#X obj 217 212 rsqrt~; -#X text 98 475 signal; -#X text 98 512 signal; -#X text 11 23 signal reciprocal square root; -#X text 168 475 - incoming signal.; -#X text 168 512 - reciprocal square root of the incoming signal.; -#X text 74 110 [rsqrt~] takes the approximate reciprocal square root -of the incoming signal \, using a fast \, approximate algorithm which -is probably accurate to about 120 dB (20 bits).; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 478 54 pddp/dsp; -#X connect 12 0 16 0; -#X connect 13 0 12 0; -#X connect 14 0 20 0; -#X connect 15 0 18 0; -#X connect 16 0 15 0; -#X connect 18 0 19 0; -#X connect 18 1 19 1; -#X connect 19 0 17 0; -#X connect 20 0 21 0; -#X connect 21 0 16 0; diff --git a/doc/pddp/rzero_rev~-help.pd b/doc/pddp/rzero_rev~-help.pd deleted file mode 100644 index 7157f50cf..000000000 --- a/doc/pddp/rzero_rev~-help.pd +++ /dev/null @@ -1,136 +0,0 @@ -#N canvas 427 32 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 rzero_rev~ 3 12 -0 18 -204280 -1 0; -#X obj 0 335 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 485 287 494 344 META 0; -#X text 12 135 LIBRARY internal; -#X text 12 175 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 155 AUTHOR Miller Puckette; -#X text 12 215 HELP_PATCH_AUTHORS Updated for Pd version-0.38. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 5 KEYWORDS signal filter; -#X text 12 45 DESCRIPTION real one-zero (non-recursive) "reverse" filter -\, raw; -#X text 12 75 INLET_0 signal clear set; -#X text 12 95 INLET_1 float signal; -#X text 12 115 OUTLET_0 signal; -#X text 12 195 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 465 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 502 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 543 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#X obj 78 344 cnv 17 3 65 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 474 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 419 cnv 17 3 35 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 98 418 float; -#X obj 477 9 rzero_rev~; -#X floatatom 283 190 0 0 0 0 - - -; -#X obj 215 116 osc~ 100; -#X msg 230 148 clear; -#X msg 232 174 set 1; -#X obj 214 216 rzero_rev~ 1; -#X text 11 23 real one-zero (non-recursive) "reverse" filter \, raw -; -#X text 98 343 signal; -#X text 98 363 clear; -#X text 98 393 set; -#X text 168 363 - clear internal state to zero.; -#X text 168 343 - the incoming signal to be filtered.; -#X text 168 393 - set internal state.; -#X text 167 418 - filter coefficient.; -#X text 167 438 - filter coefficient.; -#X text 98 473 signal; -#X text 168 473 - the outgoing \, filtered signal.; -#X text 80 520 1) float; -#X text 167 520 - (optional) initializes the filter coefficient.; -#X text 69 49 [rzero_rev~] filters an audio signal (left inlet) via -a one-zero real filter \, whose coefficient is controlled by a creation -argument or by an audio signal (right inlet). The impulse response -is that of "rzero" reversed in time.; -#N canvas 213 318 428 309 Related_objects 0; -#X obj 74 60 rzero~; -#X obj 25 80 cpole~; -#X obj 25 60 rpole~; -#X obj 123 60 rzero_rev~; -#X obj 74 80 czero~; -#X obj 123 80 czero_rev~; -#X text 201 60 real; -#X text 200 81 complex; -#X text 22 44 1-pole; -#X text 71 44 1-zero; -#X text 121 44 1-zero \, reversed; -#X text 47 29 summary of raw filters:; -#X text 18 184 User-friendly Filters; -#X obj 21 213 lop~; -#X obj 72 212 hip~; -#X obj 124 213 bp~; -#X obj 169 214 vcf~; -#X obj 22 274 biquad~; -#X text 18 250 Other Objects; -#X text 18 113 Pd also provides a suite of user-friendly filters. This -and other raw filters are provided for situations which the user-friendly -ones can't handle. See Chapter 8 of http://crca.ucsd.edu/~msp/techniques -for an introduction to the necessary theory.; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 1 [rzero_rev~] Related Objects; -#X restore 101 597 pd Related_objects; -#N canvas 80 271 326 287 test 0; -#X obj 76 78 osc~; -#X floatatom 76 55 5 0 0 0 - - -, f 5; -#X obj 77 219 env~ 16384; -#X floatatom 77 243 5 0 0 0 - - -, f 5; -#X obj 104 107 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0 -1; -#X obj 76 105 *~; -#X msg 97 137 set 1; -#X floatatom 172 157 4 -100 100 0 - - -, f 4; -#X obj 172 182 / 100; -#X obj 214 256 dac~; -#X obj 228 177 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0 -1; -#X obj 214 220 *~; -#X obj 230 197 / 10; -#X text 80 18 Stuff to test it:; -#X obj 76 168 rzero_rev~; -#X connect 0 0 5 0; -#X connect 1 0 0 0; -#X connect 2 0 3 0; -#X connect 4 0 5 1; -#X connect 5 0 14 0; -#X connect 6 0 14 0; -#X connect 7 0 8 0; -#X connect 8 0 14 1; -#X connect 10 0 12 0; -#X connect 11 0 9 0; -#X connect 11 0 9 1; -#X connect 12 0 11 1; -#X connect 14 0 2 0; -#X connect 14 0 11 0; -#X restore 102 552 pd test; -#X text 70 281 where y[n] is the output \, x[n] the input \, and a[n] -the filter coefficient. The filter is always stable.; -#X text 126 261 y[n] = -a[n] * x[n] + x[n-1]; -#X text 70 312 The transfer function is H(Z) = -a + Z^-1.; -#X text 69 240 The action of [rzero_rev~] is:; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 479 53 pddp/dsp; -#X obj 99 572 pddp/pddplink ../3.audio.examples/H14.all.pass.pd -text -doc/3.audio.examples/H14.all.pass.pd; -#X text 98 438 signal; -#X connect 12 0 16 1; -#X connect 13 0 16 0; -#X connect 14 0 16 0; -#X connect 15 0 16 0; diff --git a/doc/pddp/rzero~-help.pd b/doc/pddp/rzero~-help.pd deleted file mode 100644 index 8707d44bb..000000000 --- a/doc/pddp/rzero~-help.pd +++ /dev/null @@ -1,134 +0,0 @@ -#N canvas 431 35 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 rzero~ 3 12 0 18 --204280 -1 0; -#X obj 0 349 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 490 289 494 344 META 0; -#X text 12 125 LIBRARY internal; -#X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 145 AUTHOR Miller Puckette; -#X text 12 205 HELP_PATCH_AUTHORS Updated for Pd version-0.38. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 5 KEYWORDS signal filter; -#X text 12 45 DESCRIPTION real one-zero (non-recursive) filter \, raw -; -#X text 12 65 INLET_0 signal clear set; -#X text 12 85 INLET_1 float signal; -#X text 12 105 OUTLET_0 signal; -#X text 12 185 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 465 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 502 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 544 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#X obj 78 358 cnv 17 3 55 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 474 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 424 cnv 17 3 30 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 98 423 float; -#X obj 501 10 rzero~; -#X floatatom 241 193 0 0 0 0 - - -; -#X obj 197 108 osc~ 100; -#X msg 212 140 clear; -#X msg 214 166 set 1; -#X obj 196 218 rzero~ 1; -#X text 11 23 real one-zero (non-recursive) filter \, raw; -#X text 98 357 signal; -#X text 168 357 - the incoming signal to filter.; -#X text 74 52 [rzero~] filters an audio signal (left inlet) via a one-zero -real filter \, whose coefficient is controlled by a creation argument -or by an audio signal (right inlet).; -#X text 98 377 clear; -#X text 168 377 - clear internal state to zero.; -#X text 98 397 set; -#X text 168 397 - set internal state (e.g. \, "set 1").; -#X text 167 423 - filter coefficient.; -#X text 167 438 - filter coefficient.; -#X text 98 438 signal; -#X text 80 521 1) float; -#X text 167 521 - (optional) initializes the filter coefficient.; -#X text 98 473 signal; -#X text 168 473 - the outgoing \, filtered signal.; -#N canvas 74 275 326 287 test 0; -#X obj 76 78 osc~; -#X floatatom 76 55 5 0 0 0 - - -, f 5; -#X obj 77 219 env~ 16384; -#X floatatom 77 243 5 0 0 0 - - -, f 5; -#X obj 104 107 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0 -1; -#X obj 76 105 *~; -#X msg 97 137 set 1; -#X floatatom 172 157 4 -100 100 0 - - -, f 4; -#X obj 172 182 / 100; -#X obj 214 256 dac~; -#X obj 228 177 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0 -1; -#X obj 214 220 *~; -#X obj 230 197 / 10; -#X text 80 18 Stuff to test it:; -#X obj 76 168 rzero~; -#X connect 0 0 5 0; -#X connect 1 0 0 0; -#X connect 2 0 3 0; -#X connect 4 0 5 1; -#X connect 5 0 14 0; -#X connect 6 0 14 0; -#X connect 7 0 8 0; -#X connect 8 0 14 1; -#X connect 10 0 12 0; -#X connect 11 0 9 0; -#X connect 11 0 9 1; -#X connect 12 0 11 1; -#X connect 14 0 2 0; -#X connect 14 0 11 0; -#X restore 101 553 pd test; -#N canvas 217 323 428 309 Related_objects 0; -#X obj 74 60 rzero~; -#X obj 25 80 cpole~; -#X obj 25 60 rpole~; -#X obj 123 60 rzero_rev~; -#X obj 74 80 czero~; -#X obj 123 80 czero_rev~; -#X text 201 60 real; -#X text 200 81 complex; -#X text 22 44 1-pole; -#X text 71 44 1-zero; -#X text 121 44 1-zero \, reversed; -#X text 47 29 summary of raw filters:; -#X text 18 184 User-friendly Filters; -#X obj 21 213 lop~; -#X obj 72 212 hip~; -#X obj 124 213 bp~; -#X obj 169 214 vcf~; -#X obj 22 274 biquad~; -#X text 18 250 Other Objects; -#X text 18 113 Pd also provides a suite of user-friendly filters. This -and other raw filters are provided for situations which the user-friendly -ones can't handle. See Chapter 8 of http://crca.ucsd.edu/~msp/techniques -for an introduction to the necessary theory.; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 1 [rzero~] Related Objects; -#X restore 101 597 pd Related_objects; -#X text 74 290 where y[n] is the output \, x[n] the input \, and a[n] -the filter coefficient. The filter is always stable.; -#X text 74 320 The transfer function is H(Z) = 1 - aZ^-1.; -#X text 128 269 y[n] = x[n] - a[n] * x[n-1]; -#X text 74 249 The action of [rzero~] is:; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 482 53 pddp/dsp; -#X obj 98 573 pddp/pddplink ../3.audio.examples/H11.shelving.pd -text -doc/3.audio.examples/H11.shelving.pd; -#X connect 12 0 16 1; -#X connect 13 0 16 0; -#X connect 14 0 16 0; -#X connect 15 0 16 0; diff --git a/doc/pddp/samphold~-help.pd b/doc/pddp/samphold~-help.pd deleted file mode 100644 index 0dc597825..000000000 --- a/doc/pddp/samphold~-help.pd +++ /dev/null @@ -1,107 +0,0 @@ -#N canvas 429 36 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 samphold~ 3 12 0 -18 -204280 -1 0; -#X obj 0 244 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 488 288 494 344 META 0; -#X text 12 125 LIBRARY internal; -#X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 145 AUTHOR Miller Puckette; -#X text 12 205 HELP_PATCH_AUTHORS Updated for version 0.39. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 5 KEYWORDS signal; -#X text 12 45 DESCRIPTION sample and hold unit; -#X text 12 65 INLET_0 signal set reset; -#X text 12 85 INLET_1 signal float; -#X text 12 105 OUTLET signal; -#X text 12 185 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 507 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 544 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 569 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#X text 98 547 (none); -#N canvas 217 520 428 109 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 [samphold~] Related Objects; -#X obj 22 43 phasor~; -#X obj 79 43 threshold~; -#X restore 102 597 pd Related_objects; -#X obj 78 253 cnv 17 3 175 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 516 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 441 cnv 17 3 60 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X obj 482 10 samphold~; -#X obj 180 197 snapshot~; -#X floatatom 180 219 5 0 0 0 - - -, f 5; -#X obj 180 151 samphold~; -#X obj 207 118 sig~; -#X obj 252 140 sig~; -#X floatatom 207 97 3 0 0 0 - - -, f 3; -#X floatatom 252 119 3 0 0 0 - - -, f 3; -#X msg 130 48 set 34; -#X msg 192 71 reset; -#X text 232 96 sample signal; -#X text 277 117 control signal; -#X msg 180 48 reset 10; -#X text 238 77 to force the next sample; -#X text 237 63 reset to default 1e+20; -#X text 98 252 signal; -#X text 98 292 set; -#X text 98 322 reset; -#X text 98 399 float; -#X text 168 252 - incoming signal \, which is sampled whenever the -right input decreases in value (as [phasor~] does each period \, for -example).; -#X text 98 440 signal; -#X text 98 464 float; -#X text 167 464 - floats are accepted (and lists truncated) without -error. They are ignored \, however \, if there is a signal connection -to the same inlet.; -#X text 98 515 signal; -#X text 168 515 - the outgoing signal; -#X text 168 292 - the "set" message sets the output value \, which -continues to be updated as normal afterward (e.g. \, "set 34").; -#X text 167 440 - the right inlet is the "control signal". When it -decreases in value \, the left input is sampled.; -#N canvas 291 150 170 145 metro 0; -#X obj 19 18 loadbang; -#X obj 19 42 metro 100; -#X obj 19 65 outlet; -#X connect 0 0 1 0; -#X connect 1 0 2 0; -#X restore 192 174 pd metro; -#X text 11 23 sample and hold unit; -#X text 168 399 - floats are accepted (and lists truncated) without -error. They are ignored \, however \, if there is a signal connection -to the same inlet.; -#X text 168 322 - the "reset" message causes [samphold~] to act as -if the specified value were the most recent value of the control input -(e.g. \, "reset 10"). Use this \, for example \, if you reset the incoming -phasor but don't want the jump reflected in the output. Plain "reset" -is equivalent to "reset infinity" which forces the next input to be -sampled.; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 478 53 pddp/dsp; -#X obj 98 573 pddp/pddplink ../3.audio.examples/C09.sample.hold.pd --text doc/3.audio.examples/C09.sample.hold.pd; -#X connect 13 0 14 0; -#X connect 15 0 13 0; -#X connect 16 0 15 0; -#X connect 17 0 15 1; -#X connect 18 0 16 0; -#X connect 19 0 17 0; -#X connect 20 0 15 0; -#X connect 21 0 15 0; -#X connect 24 0 15 0; -#X connect 39 0 13 0; diff --git a/doc/pddp/savepanel-help.pd b/doc/pddp/savepanel-help.pd deleted file mode 100644 index 670750f6d..000000000 --- a/doc/pddp/savepanel-help.pd +++ /dev/null @@ -1,69 +0,0 @@ -#N canvas 427 34 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 savepanel 3 12 0 -18 -204280 -1 0; -#X obj 0 334 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 486 285 494 344 META 0; -#X text 12 105 LIBRARY internal; -#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 125 AUTHOR Miller Puckette; -#X text 12 185 HELP_PATCH_AUTHORS Updated for Pd version 0.24. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 5 KEYWORDS control GUI; -#X text 12 45 DESCRIPTION query the user for the name of a file to -create; -#X text 12 85 DATATYPE_OUT symbol; -#X text 12 65 INLET_0 bang symbol; -#X text 12 165 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 459 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 501 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 528 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#X text 98 505 (none); -#N canvas 213 517 428 109 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 obj 22 43 openpanel; -#X text 8 2 [savepanel] Related Objects; -#X restore 102 597 pd Related_objects; -#X obj 78 343 cnv 17 3 105 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 468 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 482 10 savepanel; -#X text 98 342 bang; -#X text 98 467 symbol; -#X text 168 467 - once chosen from the file browser \, the filename -is output as a symbol.; -#X text 99 532 [savepanel] handles filenames with spaces correctly. -However \, if you try to save a filename with spaces in a message box -\, for example \, it will be converted to a list the next time you -open the patch.; -#X msg 205 131 bang; -#X obj 205 225 print; -#X obj 205 200 savepanel; -#X msg 249 131 symbol /tmp; -#X text 98 387 symbol; -#X text 168 387 - you can send a symbol to the inlet of [savepanel] -to specify the initial directory (see above).; -#X text 98 422 list; -#X msg 249 153 symbol C:/; -#X text 11 23 query the user for the name of a file to create; -#X text 168 422 - a list will be truncated to the first element (if -it is a symbol).; -#X text 168 342 - when [savepanel] gets a bang \, a "Save As" file -browser appears on the screen. If you choose a filename \, it appears -on the outlet.; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X connect 16 0 18 0; -#X connect 18 0 17 0; -#X connect 19 0 18 0; -#X connect 23 0 18 0; diff --git a/doc/pddp/select-help.pd b/doc/pddp/select-help.pd deleted file mode 100644 index c7751a3a6..000000000 --- a/doc/pddp/select-help.pd +++ /dev/null @@ -1,318 +0,0 @@ -#N canvas 431 33 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 select 3 12 0 18 --204280 -1 0; -#X obj 0 163 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 484 205 494 420 META 0; -#X text 12 165 LIBRARY internal; -#X text 12 205 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 45 LICENSE SIBSD; -#X text 12 185 AUTHOR Miller Puckette; -#X text 12 245 HELP_PATCH_AUTHORS This help patch was updated for Pd -version 0.35 test 24 by Dave Sabine as part of a project called pddp -proposed by Krzysztof Czaja to build comprehensive documentation for -Pd. Jonathan Wilkes revised the patch to conform to the PDDP template -for Pd version 0.42.; -#X text 12 65 DESCRIPTION compare numbers or symbols; -#X text 12 5 ALIAS sel; -#X text 12 85 INLET_0 float symbol list; -#X text 12 105 INLET_1 float symbol; -#X text 12 125 OUTLET_N bang; -#X text 12 145 OUTLET_R float symbol; -#X text 12 25 KEYWORDS control symbol_op; -#X text 12 225 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 359 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 458 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 540 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 217 373 428 250 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 [select] Related Objects; -#X obj 22 43 route; -#X obj 62 43 spigot; -#X obj 107 43 symbol; -#X obj 155 43 float; -#X text 18 123 These objects are offered in Pd only if you have downloaded -and properly installed the appropriate library. These objects may or -may not exist in a single library.; -#X text 17 165 The best places to find information about Pd's libraries -is:; -#X text 18 185 www.puredata.org and click on "Downloads" then "Software" -; -#X text 18 200 or; -#X text 18 215 iem.kug.ac.at/pdb/; -#X text 19 83 Externals; -#X obj 19 103 pddp/helplink markex/multiselect; -#X restore 102 597 pd Related_objects; -#X obj 78 172 cnv 17 3 115 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 171 float; -#X text 98 210 list; -#X obj 78 368 cnv 17 3 40 empty \$0-pddp.cnv.let.n n 5 9 0 16 -228856 --162280 0; -#X obj 78 306 cnv 17 3 45 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 98 305 float; -#X obj 444 10 select; -#X text 491 10 or; -#X obj 516 10 sel; -#X msg 62 49 6; -#X obj 29 99 select 6; -#X msg 29 49 234; -#X floatatom 29 76 0 0 0 0 - - -; -#X obj 29 127 print match; -#X obj 108 127 print NO_match; -#X text 202 115 Note that when the input to [select] matches one of -its creation arguments \, then a "bang" is sent to the outlet \, NOT -the original message.; -#X text 11 23 compare numbers or symbols; -#N canvas 57 54 428 548 A_Word_About_Conditional_Objects 0; -#X text 20 38 Using the [select] object \, and others listed below -\, Pd users can emulate the "conditional" statements of other programming -environments.; -#X text 20 79 Consider the following: (Visual Basic Script); -#X text 59 97 IF input = 1 THEN; -#X text 58 108 response.write("Hello"); -#X text 58 121 ELSEIF input = 2 THEN; -#X text 58 133 response.write("GoodBye"); -#X text 58 170 ELSE; -#X text 57 194 END IF; -#X text 22 217 Now the Pd equivalent:; -#X msg 60 242 1; -#X msg 92 242 2; -#X floatatom 138 242 5 0 0 0 - - -, f 5; -#X obj 60 280 sel 1 2; -#X msg 60 426 symbol Hello; -#X msg 79 399 symbol GoodBye; -#X symbolatom 181 452 21 0 0 0 - - -, f 21; -#X obj 27 517 ==; -#X obj 55 517 !=; -#X obj 82 517 >; -#X obj 108 517 <; -#X obj 135 517 >=; -#X obj 162 517 <=; -#X text 22 494 OTHER CONDITIONAL/RELATIONAL OBJECTS IN Pd; -#X text 57 181 response.write("No_match_for_me..."& input); -#X text 58 159 response.write("This_is_cool."); -#X obj 99 303 moses 3; -#X msg 136 371 symbol This_is_cool.; -#X obj 136 322 moses 10; -#X obj 181 344 makefilename No_match_for_me...%d; -#X text 58 147 ELSEIF (input < 3 AND input < 10) THEN; -#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 [select] Conditional Statements in Pd; -#X connect 9 0 12 0; -#X connect 10 0 12 0; -#X connect 11 0 12 0; -#X connect 12 0 13 0; -#X connect 12 1 14 0; -#X connect 12 2 25 0; -#X connect 13 0 15 0; -#X connect 14 0 15 0; -#X connect 25 1 27 0; -#X connect 26 0 15 0; -#X connect 27 0 26 0; -#X connect 27 1 28 0; -#X connect 28 0 15 0; -#X restore 102 549 pd A_Word_About_Conditional_Objects; -#N canvas 79 52 428 303 second_inlet 0; -#X obj 23 181 sel 42; -#X msg 23 135 42; -#X obj 23 203 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X floatatom 56 203 5 0 0 0 - - -, f 5; -#X floatatom 31 157 5 0 0 0 - - -, f 5; -#X floatatom 80 159 5 0 0 0 - - -, f 5; -#X obj 197 222 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X msg 183 137 symbol word; -#X msg 197 159 symbol other; -#X msg 295 161 symbol other; -#X obj 197 197 select word; -#X obj 260 222 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X msg 292 137 symbol word; -#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 [select] The Second Inlet; -#X text 20 38 The right inlet is used to reset the argument's value -as in the patch below. This feature is available only on [select] objects -with only ONE creation argument (or no creation arguments in which -case it takes on the default value of 0). In the other examples with -multiple creation arguments \, you'll notice that this second inlet -is absent.; -#X text 20 246 Note: A given [select] object will match floats or symbols -\, but not both. See the subpatch titled "matching_symbols" for more -details.; -#X connect 0 0 2 0; -#X connect 0 1 3 0; -#X connect 1 0 0 0; -#X connect 4 0 0 0; -#X connect 5 0 0 1; -#X connect 7 0 10 0; -#X connect 8 0 10 0; -#X connect 9 0 10 1; -#X connect 10 0 6 0; -#X connect 10 1 11 0; -#X connect 12 0 10 1; -#X restore 171 335 pd second_inlet; -#N canvas 52 20 491 603 matching_symbols 0; -#X obj 151 304 print NO_match; -#X obj 22 304 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 54 304 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 86 304 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 118 304 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X msg 22 102 symbol dog; -#X msg 30 124 symbol cat; -#X msg 38 146 symbol foo; -#X msg 45 168 symbol earth; -#X msg 54 190 symbol 400; -#X obj 22 282 select dog cat foo 400; -#X msg 50 233 400; -#X obj 152 571 print NO_match; -#X obj 23 571 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 55 571 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 87 571 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 119 571 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X msg 23 385 symbol dog; -#X msg 31 407 symbol cat; -#X msg 39 429 symbol foo; -#X msg 46 451 symbol earth; -#X msg 54 473 symbol 400; -#X msg 75 506 400; -#X obj 23 549 select 400 dog cat foo; -#X text 126 182 Notice that "400" here is defined as a symbol data -type and the [select] object can successfully match it to the creation -argment.; -#X text 77 221 Notice that "400" here is a number and the [select] -object cannot successfully match it to the creation argument. That -is because this [select] expects symbols - not numbers.; -#X text 61 264 FIRST CREATION ARGUMENT IS A SYMBOL; -#X text 66 532 FIRST CREATION ARGUMENT IS A NUMBER; -#X text 103 500 Notice that "400" here is a number and the [select] -object can successfully match it to the creation argument.; -#X text 123 467 Notice that "400" here is a symbol and the [select] -object cannot successfully match it to the creation argument.; -#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 [select] Matching Symbols; -#X text 19 329 However \, in the case below \, you'll notice that the -FIRST creation argument is a number. Therefore \, this [select] object -expects numbers and will ignore the "symbol" data type.; -#X text 19 28 [select] can be used to match symbols. It important to -note that the FIRST creation argument indicates to the [select] object -which data type to expect. If your first creation argument is a symbol -\, like "dog" \, then the object will test only symbols \, and numbers -will be ignored!; -#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 connect 10 0 1 0; -#X connect 10 1 2 0; -#X connect 10 2 3 0; -#X connect 10 3 4 0; -#X connect 10 4 0 0; -#X connect 11 0 10 0; -#X connect 17 0 23 0; -#X connect 18 0 23 0; -#X connect 19 0 23 0; -#X connect 20 0 23 0; -#X connect 21 0 23 0; -#X connect 22 0 23 0; -#X connect 23 0 13 0; -#X connect 23 1 14 0; -#X connect 23 2 15 0; -#X connect 23 3 16 0; -#X connect 23 4 12 0; -#X restore 102 571 pd matching_symbols; -#X text 98 265 symbol; -#X text 98 319 symbol; -#X text 98 367 bang; -#X text 168 367 - for each creation argument \, a corresponding outlet -is created. When the value at the left inlet matches a creation argument -\, a bang is sent to the corresponding outlet.; -#X text 168 171 - if an incoming float matches a creation argument -\, a bang is sent to the corresponding outlet. If it does not match -\, the float is sent to the rightmost outlet.; -#X obj 78 421 cnv 17 3 30 empty \$0-pddp.cnv.let.r r 5 9 0 16 -228856 --162280 0; -#X text 98 420 float; -#X text 98 435 symbol; -#X text 168 420 - if there is no match \, the float or symbol is sent -to the rightmost outlet.; -#X text 168 476 - [select] creates an outlet for each creation argument -(plus one outlet at the right). Floats and symbols may not be mixed. -See the subpatch below for more details:; -#N canvas 105 267 428 240 creation_arguments 0; -#X floatatom 23 152 0 0 0 0 - - -; -#X msg 87 110 1; -#X msg 53 110 54; -#X msg 23 110 23; -#X obj 23 182 select 23 54 1; -#X obj 23 209 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 50 209 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 77 209 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X floatatom 104 209 5 0 0 0 - - -, f 5; -#X text 61 139 If you click-n-drag this number box \, you'll notice -how all numbers except "23" \, "54" \, and "1" are simply sent through -to the rightmost outlet.; -#X text 20 38 Several creation arguments can be defined. In effect -you can use [select] to test the input for many different values. You -will see an outlet for each test value and finally an outlet for values -which match none of them (the rightmost outlet).; -#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 [select] Creation Arguments; -#X connect 0 0 4 0; -#X connect 1 0 0 0; -#X connect 2 0 0 0; -#X connect 3 0 0 0; -#X connect 4 0 5 0; -#X connect 4 1 6 0; -#X connect 4 2 7 0; -#X connect 4 3 8 0; -#X restore 171 517 pd creation_arguments; -#X text 97 47 In its simplest form shown here \, [select] checks its -input against the constant "6" (which is defined by the creation argument). -If they match \, the first outlet gives "bang" \; otherwise the input -is simply sent through to the second outlet.; -#X text 168 262 - if an incoming symbol matches a creation argument -\, a bang is sent to the corresponding outlet. If it does not match -\, the symbol is sent to the rightmost outlet.; -#X text 168 210 - if there is only one creation argument (or none) -\, the first and second element of the list will be distributed to -the two inlets of [select]. If there is more than one creation argument -the list will be truncated.; -#X text 167 305 - the right inlet is available if there is only one -creation argument. See the subpatch below for details:; -#X text 80 476 n) float; -#X text 98 491 symbol atom; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 296 572 pddp/pddplink ../2.control.examples/18.conditional.pd --text doc/2.control.examples/18.conditional.pd; -#X connect 17 0 20 0; -#X connect 18 0 21 0; -#X connect 18 1 22 0; -#X connect 19 0 20 0; -#X connect 20 0 18 0; diff --git a/doc/pddp/send-help.pd b/doc/pddp/send-help.pd deleted file mode 100644 index ca6d3aa50..000000000 --- a/doc/pddp/send-help.pd +++ /dev/null @@ -1,185 +0,0 @@ -#N canvas 407 77 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 send 3 12 0 18 -204280 --1 0; -#X obj 0 240 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 462 331 494 344 META 0; -#X text 12 125 LIBRARY internal; -#X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 45 LICENSE SIBSD; -#X text 12 145 AUTHOR Miller Puckette; -#X text 12 205 HELP_PATCH_AUTHORS Dave Sabine \, September 12 \, 2003 -. Jonathan Wilkes revised the patch to conform to the PDDP template -for Pd version 0.42.; -#X text 12 25 KEYWORDS control nonlocal; -#X text 12 65 DESCRIPTION send messages without patch cords; -#X text 12 5 ALIAS s; -#X text 12 85 INLET_0 anything; -#X text 12 105 INLET_1 symbol; -#X text 12 185 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 333 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 375 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 438 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 193 354 428 315 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 [send] Related Objects; -#X obj 23 43 receive~; -#X obj 88 43 send~; -#X obj 194 43 throw~; -#X obj 249 43 catch~; -#X obj 23 74 tabreceive~; -#X obj 111 74 tabsend~; -#X obj 180 74 netsend; -#X obj 247 74 netreceive; -#X obj 304 43 value; -#X obj 134 43 receive; -#X text 20 109 Externals and other object libraries; -#X obj 20 168 pddp/helplink maxlib/remote; -#X obj 20 208 pddp/helplink maxlib/dist; -#X text 106 188 <- which library? (No help patch exists); -#X text 106 227 <- which library?; -#X text 106 247 <- which library?; -#X obj 20 268 pddp/helplink maxlib/netdist; -#X obj 20 128 pddp/helplink ggee/streamout~; -#X obj 20 148 pddp/helplink ext13/send13~; -#X obj 20 188 pddp/helplink sendlocal; -#X obj 20 228 pddp/helplink sendOSC; -#X obj 20 248 pddp/helplink shoutcast~; -#X obj 20 288 pddp/helplink motex/system; -#X restore 102 597 pd Related_objects; -#X obj 78 342 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 465 10 send; -#X text 497 10 or; -#X obj 520 10 s; -#X obj 52 124 s; -#X floatatom 52 100 5 0 0 0 - - -, f 5; -#X floatatom 284 95 5 0 0 0 - - -, f 5; -#X obj 284 66 r; -#X floatatom 339 95 5 0 0 0 - - -, f 5; -#X obj 339 66 r; -#X floatatom 390 95 5 0 0 0 - - -, f 5; -#X obj 390 66 r; -#X floatatom 52 167 5 0 0 0 - - -, f 5; -#X floatatom 277 177 5 0 0 0 - - -, f 5; -#X floatatom 348 177 5 0 0 0 - - -, f 5; -#X floatatom 423 177 5 0 0 0 - - -, f 5; -#X text 51 147 with creation argument; -#X obj 52 191 s dave; -#X obj 277 148 r dave; -#X obj 348 148 r dave; -#X floatatom 152 168 5 0 0 0 - - -, f 5; -#X obj 423 148 r hans; -#X obj 152 192 s hans; -#X obj 78 249 cnv 17 3 35 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 247 anything; -#X obj 78 291 cnv 17 3 35 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 98 289 symbol; -#X text 168 289 - if [send] is created without an argument \, the right -inlet can be used to dynamically change the send/receive name. (See -example above).; -#X obj 112 124 s; -#X floatatom 112 66 5 0 0 0 - - -, f 5; -#X msg 157 66 symbol dave; -#X msg 157 94 symbol hans; -#X text 98 341 (none); -#X text 168 341 - all messages are sent to a corresponding [receive] -object with the same name.; -#X obj 98 442 pddp/pddplink all_about_send_n_receive.pd -text all_about_send_n_receive -; -#N canvas 64 68 428 493 Dynamic_send_vs_messages 0; -#X text 20 42 Consider this:; -#X floatatom 115 43 5 0 0 0 - - -, f 5; -#X floatatom 171 43 5 0 0 0 - - -, f 5; -#X obj 115 69 s dave; -#X obj 171 69 s hans; -#X obj 264 43 r dave; -#X obj 320 43 r hans; -#X floatatom 264 67 5 0 0 0 - - -, f 5; -#X floatatom 320 67 5 0 0 0 - - -, f 5; -#X text 20 112 Now consider this:; -#X floatatom 139 114 5 0 0 0 - - -, f 5; -#X floatatom 208 115 5 0 0 0 - - -, f 5; -#X msg 139 142 \; dave \$1; -#X msg 208 142 \; hans \$1; -#X text 20 232 And to complicate things a little more \, and offer -some interesting functionality \, consider the following:; -#X obj 264 90 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 320 90 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X msg 23 312 \; \$1 42; -#X text 20 184 In this example \, the message box contains a Pd command -which effectively sends the value of the variable (\$1) to either 'dave' -or 'hans'.; -#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 [send] Send using [send] of message? Dynamic [send]?; -#X msg 23 274 symbol dave; -#X msg 107 274 symbol hans; -#X text 66 302 In this example \, I have created a single routine which -acts as a 'dynamic' send object. The variable (\$1) in this message -box is replaced by the incoming symbol. The two patches below do the -same thing but with the [send] object:; -#X msg 162 364 symbol dave; -#X msg 171 386 symbol hans; -#X obj 162 467 send; -#X obj 162 440 42; -#X obj 162 413 t b a; -#X connect 1 0 3 0; -#X connect 2 0 4 0; -#X connect 5 0 7 0; -#X connect 6 0 8 0; -#X connect 7 0 15 0; -#X connect 8 0 16 0; -#X connect 10 0 12 0; -#X connect 11 0 13 0; -#X connect 21 0 17 0; -#X connect 22 0 17 0; -#X connect 24 0 28 0; -#X connect 25 0 28 0; -#X connect 27 0 26 0; -#X connect 28 0 27 0; -#X connect 28 1 26 1; -#X restore 101 567 pd Dynamic_send_vs_messages; -#X text 11 23 send messages without patch cords; -#X text 168 393 - specifies the send/receive name. If no arguments -are provided \, an extra inlet is available to dynamically set the -send/receive name.; -#X text 168 247 - when [send] is created with an argument \, it has -a single inlet which accepts any message as input. The input is sent -to all [receive] objects with the same name (argument).; -#X text 80 393 1) symbol atom; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 98 457 pddp/pddplink all_about_scope_and_locality.pd -text all_about_scope_and_locality -; -#X text 98 493 doc/1.manual/x5.htm; -#X text 98 478 doc/1.manual/x2.htm; -#X obj 97 515 pddp/pddplink ../2.control.examples/09.send_receive.pd --text doc/2.control.examples/09.send_receive.pd; -#X obj 97 530 pddp/pddplink ../2.control.examples/10.more.messages.pd --text doc/2.control.examples/10.more.messages.pd; -#X obj 97 545 pddp/pddplink ../2.control.examples/13.locality.pd -text -doc/2.control.examples/13.locality.pd; -#X connect 13 0 12 0; -#X connect 15 0 14 0; -#X connect 17 0 16 0; -#X connect 19 0 18 0; -#X connect 20 0 25 0; -#X connect 26 0 21 0; -#X connect 27 0 22 0; -#X connect 28 0 30 0; -#X connect 29 0 23 0; -#X connect 37 0 36 0; -#X connect 38 0 36 1; -#X connect 39 0 36 1; diff --git a/doc/pddp/send~-help.pd b/doc/pddp/send~-help.pd deleted file mode 100644 index 8b9b7a198..000000000 --- a/doc/pddp/send~-help.pd +++ /dev/null @@ -1,75 +0,0 @@ -#N canvas 431 35 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 send~ 3 12 0 18 --204280 -1 0; -#X obj 0 332 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 485 303 494 323 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.33. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 25 KEYWORDS signal nonlocal; -#X text 12 65 DESCRIPTION one-to-many nonlocal signal connections; -#X text 12 5 ALIAS s~; -#X text 12 85 INLET_0 signal; -#X text 12 165 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 374 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 467 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 516 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 217 522 428 109 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 obj 22 43 tabreceive~; -#X obj 102 43 throw~; -#X obj 152 43 catch~; -#X text 8 2 [send~] Related Objects; -#X restore 102 597 pd Related_objects; -#X obj 78 341 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 453 9 send~; -#X obj 157 236 send~ signal1; -#X obj 157 213 sig~ 50; -#X floatatom 157 189 4 0 0 0 - - -, f 4; -#X text 98 340 signal; -#X text 98 378 (none); -#X text 168 340 - a [send~] object copies its input to a local buffer -which all receive~ objects of the same name read from.; -#X text 168 378 - the incoming signal is sent to all [receive~] objects -that share the same name as the [send~] object. These objects may be -in different windows or even different patches. Any number of [receive~]'s -may be associated with one [send~] \, but it is an error to have two -[send~] objects of the same name.; -#X obj 284 147 receive~ signal1; -#X obj 284 236 snapshot~; -#X obj 304 176 loadbang; -#X obj 304 199 metro 150; -#X text 11 23 one-to-many nonlocal signal connections; -#X floatatom 284 263 5 0 0 0 - - -, f 5; -#X text 168 485 - [send~] takes a single argument which is the name -associated with this particular [send~] object.; -#X text 80 485 1) symbol atom; -#X text 98 519 [send~]/[receive~] only work for the default block size -(64).; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 481 57 pddp/dsp; -#X obj 96 571 pddp/pddplink ../3.audio.examples/G05.execution.order.pd -; -#X text 99 551 See also:; -#X obj 519 9 s~; -#X text 496 9 or; -#X connect 11 0 10 0; -#X connect 12 0 11 0; -#X connect 17 0 18 0; -#X connect 18 0 22 0; -#X connect 19 0 20 0; -#X connect 20 0 18 0; diff --git a/doc/pddp/set-help.pd b/doc/pddp/set-help.pd deleted file mode 100644 index e92d21127..000000000 --- a/doc/pddp/set-help.pd +++ /dev/null @@ -1,143 +0,0 @@ -#N struct set-help-template float x float y float a symbol b; -#N canvas 425 34 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 set 3 12 0 18 -204280 --1 0; -#X obj 0 230 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 481 285 494 344 META 0; -#X text 12 125 LIBRARY internal; -#X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 145 AUTHOR Miller Puckette; -#X text 12 205 HELP_PATCH_AUTHORS Updated for Pd version 0.33. Revised -by Jonathan Wilkes to conform to the PDDP template for Pd version 0.42. -; -#X text 12 5 KEYWORDS control data_structure; -#X text 12 45 DESCRIPTION set values in a scalar; -#X text 12 65 INLET_0 float list symbol bang; -#X text 12 85 INLET_N float symbol; -#X text 12 105 INLET_R pointer; -#X text 12 185 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 402 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 425 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 505 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 210 520 428 109 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 [set] Related Objects; -#X obj 23 44 get; -#X obj 55 44 append; -#X obj 105 44 getsize; -#X obj 161 44 setsize; -#X obj 221 44 element; -#X obj 23 69 sublist; -#X obj 81 69 struct; -#X obj 133 69 pointer; -#X restore 102 598 pd Related_objects; -#X obj 78 332 cnv 17 3 35 empty \$0-pddp.cnv.let.n n 5 9 0 16 -228856 --162280 0; -#X text 98 237 float; -#X text 98 265 list; -#X obj 78 374 cnv 17 3 17 empty \$0-pddp.cnv.let.r r 5 9 0 16 -228856 --162280 0; -#X obj 518 11 set; -#X text 11 23 set values in a scalar; -#N canvas 381 200 428 296 set-help-template 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 [set] Data Structure Template; -#X obj 23 124 drawcurve 0 1 60 50 70 50 70 60 60 60 60 50; -#X obj 23 244 drawcurve 0 1 25 85 50 a 75 85; -#X obj 23 80 drawcurve 0 1 0 20 100 20 100 120 0 120 0 20; -#X text 298 79 <- Head; -#X obj 23 102 drawcurve 0 1 30 50 40 50 40 60 30 60 30 50; -#X text 298 102 <- Left eye; -#X text 298 124 <- Right eye; -#X text 25 198 The following drawing instruction associates the field -"a" with the midpoint of a curve. Thus you can set the value of a and -change the arc/direction of the curve.; -#X text 217 244 <- Mouth; -#X text 187 152 <- Text; -#X text 187 175 <- Text; -#X obj 23 43 struct set-help-template float x float y float a symbol -b; -#X obj 25 152 drawsymbol b 25 125 0 b=; -#X obj 25 175 drawnumber a 40 a 900 a=; -#X restore 417 153 pd set-help-template; -#X scalar set-help-template 7 42 111 Comedy \;; -#X obj 359 126 pointer; -#X msg 359 73 traverse pd-set-help.pd \, next; -#X floatatom 224 127 5 0 0 0 - - -, f 5; -#X text 366 56 output first scalar in list; -#X scalar set-help-template 116 42 61 Tragedy \;; -#X msg 370 98 next; -#X text 405 97 output next item; -#X text 98 373 pointer; -#X text 168 265 - a list is distributed among the inlets.; -#X text 98 405 (none); -#X obj 78 238 cnv 17 3 85 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 332 float; -#X text 98 283 bang; -#X text 98 346 symbol; -#X text 98 310 symbol; -#X text 168 464 - all subsequent arguments are names of fields. There -is one inlet created per field (plus the rightmost inlet for the pointer). -; -#X text 167 373 - a pointer to a scalar.; -#X text 168 446 - the template of a scalar.; -#X text 168 283 - a bang to the leftmost inlet sets the field(s) of -the scalar with the last stored field value(s).; -#X text 168 237 - a float to the leftmost inlet updates the value(s) -for the field(s) specified in the creation arguments.; -#X text 168 332 - an inlet is added for each additional field specified -by the creation arguments. All fields must be the same type (i.e. \, -floats or symbols \, but not a mixture of the two).; -#X text 98 509 You can't [set] "arrays" or "sublists". Instead \, you -can get pointers into them using [element] and [sublist] (Note: [sublist] -not working yet) and set individual items.; -#X text 168 310 - see the subpatch "Setting_Symbolic_Fields" below. -; -#N canvas 98 376 428 215 Setting_Symbolic_Fields 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 [set] Setting symbolic fields; -#X obj 224 124 pointer; -#X msg 224 71 traverse pd-set-help.pd \, next; -#X msg 235 96 next; -#X msg 23 84 symbol Trauermarsch; -#X msg 48 109 symbol Scherzo; -#X text 20 37 To set symbolic fields of a scalar \, the "-symbol" flag -must be used as follows:; -#X text 20 178 You cannot set symbols and floats using the same [set] -object.; -#X obj 23 151 set -symbol set-help-template b; -#X connect 2 0 9 1; -#X connect 3 0 2 0; -#X connect 4 0 2 0; -#X connect 5 0 9 0; -#X connect 6 0 9 0; -#X restore 101 552 pd Setting_Symbolic_Fields; -#X text 80 446 1) symbol atom; -#X text 80 464 n) symbol atom; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 98 572 pddp/pddplink ../4.data.structures/03.setting.data.pd --text doc/4.data.structures/03.setting.data.pd; -#X obj 353 552 pddp/pddplink scalar-help.pd; -#X obj 224 153 set set-help-template a; -#X obj 224 201 set -symbol set-help-template b; -#X symbolatom 224 180 10 0 0 0 - - -, f 10; -#X text 236 73 Click here first->; -#X connect 16 0 45 1; -#X connect 16 0 46 1; -#X connect 17 0 16 0; -#X connect 18 0 45 0; -#X connect 21 0 16 0; -#X connect 47 0 46 0; diff --git a/doc/pddp/setsize-help.pd b/doc/pddp/setsize-help.pd deleted file mode 100644 index 5c48045d4..000000000 --- a/doc/pddp/setsize-help.pd +++ /dev/null @@ -1,107 +0,0 @@ -#N struct string_of_dolls float x float y array dolls doll symbol label -; -#N struct doll float y; -#N canvas 431 39 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 setsize 3 12 0 18 --204280 -1 0; -#X obj 0 304 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 487 301 494 328 META 0; -#X text 12 105 LIBRARY internal; -#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 125 AUTHOR Miller Puckette; -#X text 12 185 HELP_PATCH_AUTHORS Updated for Pd version 0.33. Revised -by Jonathan Wilkes to conform to the PDDP template for Pd version 0.42. -; -#X text 12 5 KEYWORDS control data_structure array; -#X text 12 45 DESCRIPTION resize an array; -#X text 12 65 INLET_0 float list; -#X text 12 85 INLET_1 pointer; -#X text 12 165 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 397 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 425 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 485 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 222 522 428 109 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 obj 23 44 get; -#X obj 83 44 append; -#X obj 133 44 getsize; -#X obj 189 44 element; -#X obj 23 69 sublist; -#X obj 81 69 struct; -#X obj 133 69 pointer; -#X text 8 2 [setsize] Related Objects; -#X obj 51 44 set; -#X restore 102 598 pd Related_objects; -#X obj 78 313 cnv 17 3 50 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 312 float; -#X text 98 337 list; -#X obj 78 369 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 11 23 resize an array; -#X obj 491 11 setsize; -#X scalar string_of_dolls 32 110 An_array_of_paper_dolls... \; -3 \; -0 \; 0 \; 0 \; 0 \; \;; -#X msg 204 171 traverse pd-setsize-help.pd \, next; -#X obj 204 196 pointer; -#X floatatom 33 237 5 0 0 0 - - -, f 5; -#N canvas 90 353 428 173 doll-template 0; -#X obj 23 43 struct doll float y; -#X obj 23 65 filledcurve 999 0 1 -10 -1 -10 -1 0 -1 0 -1 0 -4 0 -4 --5 -9 3 -14 8 -9 5 -4 5 -4 5 -1 5 -1 15 -1 15 -1 15 3 15 3 5 3 5 3 -15 19 15 19 -10 19 -10 19 0 3 0 3 -10 3 -10 3; -#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 [setsize] Data Structure; -#X text 20 118 These are the drawing instructions for the paper doll. -This template is used as the element of the array "dolls" in the template -"string_of_dolls".; -#X restore 380 241 pd doll-template; -#N canvas 81 360 428 167 string_of_dolls 0; -#X obj 23 78 plot dolls 0 1 0 0 30; -#X obj 23 43 struct string_of_dolls float x float y array dolls doll -symbol label; -#X obj 23 101 drawsymbol label -15 -35 145; -#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 [setsize] Template for string_of_dolls; -#X text 20 124 Here we simply plot the array and give it a label by -using the [drawsymbol] object; -#X restore 380 263 pd string_of_dolls; -#X obj 33 263 setsize string_of_dolls dolls; -#X text 178 337 - a (float \, pointer) pair is distributed to the two -inlets. Lists with more than two elements will be truncated.; -#X text 98 368 pointer; -#X text 98 400 (none); -#X text 178 462 - the name of an array contained within the scalar. -; -#X text 178 312 - sending a float sets the number of elements of the -array specified by the 2nd creation argument.; -#X text 98 489 Sending values smaller than one to [setsize] will resize -the array to one \, which is the smallest possible size of an array. -If the array is resized downward (e.g. \, from 20 to 15 elements) the -extra data are lost. If resized upward \, the new elements are initialized -to default values.; -#X text 177 368 - a pointer to a scalar that contains an array.; -#X text 203 149 1) Click here first...; -#X text 32 211 2) ...then here.; -#X text 178 444 - the struct name of a scalar that contains an array. -; -#X text 80 444 1) symbol atom; -#X text 80 462 n) symbol atom; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 98 557 pddp/pddplink all_about_arrays.pd; -#X obj 98 572 pddp/pddplink scalar-help.pd; -#X connect 15 0 16 0; -#X connect 16 0 20 1; -#X connect 17 0 20 0; diff --git a/doc/pddp/sigbinops-help.pd b/doc/pddp/sigbinops-help.pd deleted file mode 100644 index 201738d4d..000000000 --- a/doc/pddp/sigbinops-help.pd +++ /dev/null @@ -1,123 +0,0 @@ -#N canvas 427 35 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 (sigbinops) 3 12 -0 18 -204280 -1 0; -#X obj -1 385 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 485 289 494 344 META 0; -#X text 12 85 LIBRARY internal; -#X text 12 125 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 45 LICENSE SIBSD; -#X text 12 105 AUTHOR Miller Puckette; -#X text 12 165 HELP_PATCH_AUTHORS Updated for Pd v0.41. Revised by -Jonathan Wilkes to conform to the PDDP template for Pd version 0.42. -; -#X text 12 25 KEYWORDS signal; -#X text 12 65 DESCRIPTION binary operators for signals; -#X text 12 5 NAME +~ -~ *~ /~ max~ min~; -#X text 12 145 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj -1 465 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj -1 502 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj -1 566 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 -12 0 13 -228856 -1 0; -#N canvas 212 525 428 109 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 (sigbinops) Related Objects; -#X obj 22 43 log~; -#X obj 62 43 exp~; -#X obj 103 43 abs~; -#X restore 102 598 pd Related_objects; -#X obj 78 394 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 474 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 417 cnv 17 3 40 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 11 23 binary operators for signals; -#X obj 15 286 +~; -#X obj 103 284 -~; -#X obj 190 284 *~; -#X obj 275 286 /~; -#X obj 15 212 osc~ 440; -#X obj 415 212 osc~ 675; -#X obj 361 284 max~; -#X obj 447 286 min~; -#N canvas 0 0 450 300 (subpatch) 0; -#X array \$0a 100 float 2; -#X coords 0 1 99 -1 150 105 1; -#X restore 15 73 graph; -#X obj 344 11 +~; -#X obj 379 11 -~; -#X obj 412 11 *~; -#X obj 446 11 /~; -#X obj 479 11 max~; -#X obj 513 11 min~; -#X text 177 111 The binary signal operators can be configured to combine -two signals as above \, or \, if you give a numeric argument \, audio -signals are combined with scalars:; -#X obj 329 156 +~ 5; -#X text 177 181 The right inlet takes audio signals or numbers depending -on whether the argument is present or not.; -#X text 98 393 signal; -#X text 167 416 - an incoming signal; -#X text 168 393 - an incoming signal; -#X text 98 416 signal; -#X text 98 473 signal; -#X text 168 473 - the outgoing signal; -#X text 80 521 1) float; -#X text 168 521 - (optional) a float argument initializes the right -inlet to a value \, and allows the right inlet to receive float messages. -; -#X text 98 431 float; -#X text 167 431 - if an argument is provided \, the object's right -inlet will accept floats instead of a signal.; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 481 52 pddp/dsp; -#X obj 15 333 tabwrite~ \$0a; -#X obj 103 333 tabwrite~ \$0a; -#X obj 190 333 tabwrite~ \$0a; -#X obj 275 333 tabwrite~ \$0a; -#X obj 361 333 tabwrite~ \$0a; -#X obj 447 333 tabwrite~ \$0a; -#X obj 21 311 bng 15 250 50 0 empty empty empty 17 7 0 10 -204786 -1 --1; -#X obj 109 311 bng 15 250 50 0 empty empty empty 17 7 0 10 -204786 --1 -1; -#X obj 196 311 bng 15 250 50 0 empty empty empty 17 7 0 10 -204786 --1 -1; -#X obj 281 311 bng 15 250 50 0 empty empty empty 17 7 0 10 -204786 --1 -1; -#X obj 367 311 bng 15 250 50 0 empty empty empty 17 7 0 10 -204786 --1 -1; -#X obj 453 311 bng 15 250 50 0 empty empty empty 17 7 0 10 -204786 --1 -1; -#X connect 12 0 42 0; -#X connect 13 0 43 0; -#X connect 14 0 44 0; -#X connect 15 0 45 0; -#X connect 16 0 12 0; -#X connect 16 0 13 0; -#X connect 16 0 15 0; -#X connect 16 0 14 0; -#X connect 16 0 18 0; -#X connect 16 0 19 0; -#X connect 17 0 15 1; -#X connect 17 0 14 1; -#X connect 17 0 13 1; -#X connect 17 0 12 1; -#X connect 17 0 18 1; -#X connect 17 0 19 1; -#X connect 18 0 46 0; -#X connect 19 0 47 0; -#X connect 48 0 42 0; -#X connect 49 0 43 0; -#X connect 50 0 44 0; -#X connect 51 0 45 0; -#X connect 52 0 46 0; -#X connect 53 0 47 0; diff --git a/doc/pddp/sig~-help.pd b/doc/pddp/sig~-help.pd deleted file mode 100644 index 04dcd716f..000000000 --- a/doc/pddp/sig~-help.pd +++ /dev/null @@ -1,64 +0,0 @@ -#N canvas 428 34 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 sig~ 3 12 0 18 -204280 --1 0; -#X obj 0 437 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 491 282 494 344 META 0; -#X text 12 105 LIBRARY internal; -#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 125 AUTHOR Miller Puckette; -#X text 12 185 HELP_PATCH_AUTHORS Updated for Pd version 0.33. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 5 KEYWORDS signal conversion; -#X text 12 45 DESCRIPTION convert numbers to audio signal; -#X text 12 65 INLET_0 float; -#X text 12 85 OUTLET_0 signal; -#X text 12 165 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 502 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 539 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 567 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#X text 98 543 (none); -#N canvas 213 518 428 109 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 obj 22 43 snapshot~; -#X text 8 2 [sig~] Related Objects; -#X restore 102 597 pd Related_objects; -#X obj 78 446 cnv 17 3 45 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 445 float; -#X text 98 474 list; -#X obj 78 511 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 510 10 sig~; -#X obj 245 228 snapshot~; -#X floatatom 245 253 0 0 0 0 - - -; -#X floatatom 165 106 0 0 0 0 - - -; -#X obj 245 178 loadbang; -#X obj 245 202 metro 200; -#X text 195 105 <- Scroll to set value; -#X text 168 445 - a float to the inlet of [sig~] will be converted -to an audio signal.; -#X text 98 510 signal; -#X obj 165 131 sig~; -#X text 11 23 convert numbers to audio signal; -#X text 168 474 - a list will be truncated to the first element.; -#X text 113 280 In this example \, the [sig~] object converts numbers -to an audio signal \, which the [snapshot~] converts back again.; -#X text 168 510 - the outgoing signal.; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 477 51 pddp/dsp; -#X connect 14 0 15 0; -#X connect 16 0 22 0; -#X connect 17 0 18 0; -#X connect 18 0 14 0; -#X connect 22 0 14 0; diff --git a/doc/pddp/snapshot~-help.pd b/doc/pddp/snapshot~-help.pd deleted file mode 100644 index 01831b856..000000000 --- a/doc/pddp/snapshot~-help.pd +++ /dev/null @@ -1,80 +0,0 @@ -#N canvas 429 34 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 snapshot~ 3 12 0 -18 -204280 -1 0; -#X obj 0 417 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 486 284 494 344 META 0; -#X text 12 105 LIBRARY internal; -#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 125 AUTHOR Miller Puckette; -#X text 12 185 HELP_PATCH_AUTHORS Updated for Pd version 0.37. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 5 KEYWORDS signal conversion; -#X text 12 45 DESCRIPTION convert a signal to a number on demand; -#X text 12 85 OUTLET_0 float; -#X text 12 65 INLET_0 bang signal set; -#X text 12 165 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 500 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 542 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 569 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#X text 98 546 (none); -#N canvas 218 518 428 109 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 [snapshot~] Related Objects; -#X obj 22 43 sig~; -#X obj 63 43 vsnapshot~; -#X restore 102 597 pd Related_objects; -#X obj 78 426 cnv 17 3 65 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 508 float; -#X obj 78 509 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 484 11 snapshot~; -#X obj 91 307 snapshot~; -#X floatatom 91 330 0 0 0 0 - - -; -#X msg 102 255 bang; -#X obj 91 230 osc~ 0.1; -#X text 90 209 0.1 Hz cosine; -#X msg 107 279 set 5; -#X text 98 425 signal; -#X text 11 23 convert a signal to a number on demand; -#X text 98 445 bang; -#X text 98 465 set; -#X text 168 465 - the "set" message \, followed by a value \, sets -[snapshot~] to the specified value (which is reset the next DSP block). -; -#X text 168 508 - upon receiving a bang to its inlet \, [snapshot~] -outputs a value.; -#X text 143 255 <- Click to take a "snapshot" of the signal; -#X text 168 425 - the incoming signal.; -#X text 168 445 - a bang takes one snapshot of the incoming signal. -; -#X text 18 109 In the example below \, a [snapshot~] object prints -out the values of a low frequency cosine wave every time it is sent -a bang message.; -#X text 18 152 A "set" message is provided for the (rare) situations -where you might make a known change to the signal input \, and then -read snapshot's value before any ensuing signal computation.; -#X text 18 57 The [snapshot~] object takes a signal and converts it -to a control value whenever it receives a bang in its left outlet. -This object is particularly useful for monitoring outputs.; -#X text 156 329 This output updates each time bang is clicked above. -; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 481 54 pddp/dsp; -#X obj 99 572 pddp/pddplink ../3.audio.examples/C06.signal.to.control.pd --text doc/3.audio.examples/C06.signal.to.control.pd; -#X connect 13 0 14 0; -#X connect 15 0 13 0; -#X connect 16 0 13 0; -#X connect 18 0 13 0; diff --git a/doc/pddp/soundfiler-help.pd b/doc/pddp/soundfiler-help.pd deleted file mode 100644 index 3fa80f90a..000000000 --- a/doc/pddp/soundfiler-help.pd +++ /dev/null @@ -1,122 +0,0 @@ -#N canvas 429 34 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 soundfiler 3 12 -0 18 -204280 -1 0; -#X obj 0 387 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 490 283 494 344 META 0; -#X text 12 105 LIBRARY internal; -#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 125 AUTHOR Miller Puckette; -#X text 12 185 HELP_PATCH_AUTHORS Updated for Pd version 0.37. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 45 DESCRIPTION read and write soundfiles to arrays; -#X text 12 65 INLET_0 read write; -#X text 12 85 OUTLET_0 float; -#X text 12 5 KEYWORDS control array filesystem; -#X text 12 165 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 487 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 529 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 554 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#X text 98 533 (none); -#N canvas 217 519 428 106 Related_objects 0; -#X obj 0 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 2 [soundfiler] Related Objects; -#X obj 22 43 tabwrite~; -#X obj 22 69 tabread4~; -#X obj 88 43 tabplay~; -#X obj 143 69 writesf~; -#X obj 87 69 readsf~; -#X restore 102 597 pd Related_objects; -#X obj 78 396 cnv 17 3 80 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 495 float; -#X obj 78 496 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 477 10 soundfiler; -#X text 11 23 read and write soundfiles to arrays; -#X text 98 395 read; -#X text 98 412 write; -#X text 168 495 - the output specifies the total number of samples -that have been read or written.; -#X obj 20 293 soundfiler; -#X floatatom 20 317 0 0 0 0 - - -; -#X text 231 137 read a file; -#X text 287 159 ...optionally resize; -#X text 322 224 write a file; -#X text 358 268 write stereo; -#N canvas 0 0 450 300 (subpatch) 0; -#X array sf-array1 77971 float 0; -#X coords 0 1 77971 -1 130 70 1; -#X restore 135 306 graph; -#N canvas 0 0 450 300 (subpatch) 0; -#X array sf-array2 77971 float 0; -#X coords 0 1 77971 -1 130 70 1; -#X restore 288 306 graph; -#N canvas 110 93 428 434 flags 0; -#X obj 0 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 19 37 When reading you can leave soundfiler to figure out which -of the three known soundfile formats the file belongs to or override -all header information using the "-raw" flag.; -#X text 136 79 Flags for reading:; -#X text 45 99 -skip <sample frames to skip in file>; -#X text 45 159 -raw <headersize> <channels> <bytespersample> <endianness> -; -#X text 64 177 This causes all header information to be ignored. Endianness -is "l" ("little") for Intel machines or "b" ("big") for Macintoshes -and SGIs. You can give "n" (natural) to take the byte order your machine -prefers.; -#X text 45 119 -resize; -#X text 45 139 -maxsize <maximum number of samples we can resize to> -; -#X text 19 230 Flags for writing:; -#X text 37 251 -wave \, -nextstep \, -aiff; -#X text 37 271 -big \, -little (nextstep only!); -#X text 37 291 -skip <number of sample frames to skip in array>; -#X text 37 311 -nframes <maximum number to write>; -#X text 37 351 -normalize; -#X text 37 331 -bytes <2 \, 3 \, or 4>; -#X text 17 400 The number of channels is limited to 64; -#X text 37 371 -rate <sample rate>; -#X text 7 1 [soundfiler] Flags; -#X restore 172 459 pd flags; -#X text 168 412 - write a soundfile.; -#X text 169 428 The "read" and "write" messages accept flags. See the -subpatch below for details:; -#X msg 20 138 read ../sound/bell.aiff sf-array2; -#X msg 20 161 read -resize ../sound/bell.aiff sf-array2; -#X msg 20 185 read -raw 128 2 2 b ../sound/bell.aiff sf-array1 sf-array2 -; -#X msg 20 214 write -aiff /tmp/foo1 sf-array2; -#X msg 20 238 write -wave -nframes 10000 /tmp/foo2 sf-array2; -#X msg 20 268 write -nextstep -bytes 4 /tmp/foo3 sf-array1 sf-array2 -; -#X text 399 197 overriding everything; -#X text 398 183 ...or even; -#X text 168 395 - read a soundfile.; -#X text 17 41 The [soundfiler] object reads and writes floating point -arrays to binary soundfiles which may contain 2 or 3 byte fixed point -or 4 byte floating point samples in wave \, aiff \, or next formats -(no floating point aiff \, though.). The number of channels of the -soundfile need not match the number of arrays given (extras are dropped -and unsupplied channels are zeroed out).; -#X text 98 558 Note: The number of channels is limited to 64 .; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 98 575 pddp/pddplink all_about_arrays.pd; -#X connect 17 0 18 0; -#X connect 28 0 17 0; -#X connect 29 0 17 0; -#X connect 30 0 17 0; -#X connect 31 0 17 0; -#X connect 32 0 17 0; -#X connect 33 0 17 0; diff --git a/doc/pddp/spigot-help.pd b/doc/pddp/spigot-help.pd deleted file mode 100644 index a0144ec61..000000000 --- a/doc/pddp/spigot-help.pd +++ /dev/null @@ -1,187 +0,0 @@ -#N canvas 432 36 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 spigot 3 12 0 18 --204280 -1 0; -#X obj 0 295 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 486 265 494 364 META 0; -#X text 12 125 LIBRARY internal; -#X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 145 AUTHOR Miller Puckette; -#X text 12 205 HELP_PATCH_AUTHORS This help patch was updated for Pd -version 0.38-4. It was edited by Dave Sabine and Hans-Christoph Steiner -as part of a project called pddp proposed by Krzysztof Czaja to build -comprehensive documentation for Pd. Revised by Jonathan Wilkes to conform -to the PDDP template for Pd version 0.42.; -#X text 12 5 KEYWORDS control; -#X text 12 45 DESCRIPTION pass or block messages; -#X text 12 65 INLET_0 anything; -#X text 12 85 INLET_1 float; -#X text 12 105 OUTLET_0 anything; -#X text 12 185 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 389 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 443 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 538 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 217 400 428 230 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 [spigot] Related Objects; -#X text 20 38 Externals; -#X text 19 85 These objects are offered in Pd only if you have downloaded -and properly installed the appropriate library. These objects may or -may not exist in a single library.; -#X text 19 126 The best places to find information about Pd's libraries -is:; -#X text 19 146 www.puredata.org and click on "Downloads" then "Software" -; -#X text 19 161 or; -#X text 19 176 iem.kug.ac.at/pdb/; -#X obj 21 58 pddp/helplink cyclone/gate; -#X restore 102 598 pd Related_objects; -#X obj 78 304 cnv 17 3 35 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 398 cnv 17 3 30 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 345 cnv 17 3 35 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 98 344 float; -#X obj 498 10 spigot; -#X text 11 23 pass or block messages; -#X msg 101 111 0.5 1000; -#X floatatom 134 177 1 0 0 0 - - -, f 1; -#X obj 101 197 spigot; -#X obj 101 218 print; -#X msg 120 155 walk the cat; -#X msg 111 133 bang; -#X text 147 177 control: nonzero to pass messages \, zero to stop them -; -#X text 18 52 [spigot] passes messages from its left inlet to its outlet -\, as long as a nonzero number is sent to its right inlet. When its -right inlet gets zero \, incoming messages are "blocked" (i.e. ignored). -; -#X text 18 242 [spigot] works essentially like a doorway. When the -door is open \, messages can pass through. When the door is closed -\, messages are ignored. By default \, the door is always closed!; -#N canvas 96 273 428 291 using_spigot_to_create_a_gate 0; -#X text 20 38 Unlike its closest cousin MAX \, Pd does not have a native -[gate] object. There are other Pd libraries which include gates for -both audio and numerical data \, but similar routines can be built -in Pd using [spigot]. The example below shows a two-way gate using -two [spigots] and the [expr] object.; -#X floatatom 121 188 1 0 0 0 - - -, f 1; -#X text 138 187 controls: open and close the gates.; -#X floatatom 24 262 5 0 0 0 - - -, f 5; -#X floatatom 76 262 5 0 0 0 - - -, f 5; -#X obj 24 129 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0 1 -; -#X obj 24 149 metro 200; -#X obj 24 171 f; -#X obj 51 171 + 1; -#X text 44 127 Click to start sending info through the gates.; -#X obj 24 240 spigot; -#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 [spigot] Using [spigot] to Create a Gate; -#X obj 76 240 spigot 1; -#X obj 121 218 == 0; -#X connect 1 0 10 1; -#X connect 1 0 14 0; -#X connect 5 0 6 0; -#X connect 6 0 7 0; -#X connect 7 0 8 0; -#X connect 7 0 10 0; -#X connect 7 0 13 0; -#X connect 8 0 7 1; -#X connect 10 0 3 0; -#X connect 13 0 4 0; -#X connect 14 0 13 1; -#X restore 102 568 pd using_spigot_to_create_a_gate; -#N canvas 61 206 428 334 spigot_for_audio_signals 0; -#X text 20 38 [spigot] does not work with audio signals. The data types -which are accepted by this object are floats \, symbols \, lists \, -bangs \, anythings and pointers. However \, audio signals require a -completely different treatment.; -#X text 21 100 Pd does not have a [spigot] for audio signals \, but -the same effect can be created using the following structure:; -#X obj 24 147 osc~ 800; -#X obj 24 217 *~; -#X floatatom 39 196 1 0 0 0 - - -, f 1; -#X obj 24 279 env~; -#X floatatom 24 300 5 0 0 0 - - -, f 5; -#X obj 69 299 dac~; -#X obj 69 279 *~ 0.05; -#X text 79 168 Here is the [spigot].; -#X text 80 183 When "0" \, audio signal; -#X text 79 198 is effectively blocked.; -#X text 80 213 When "1" \, audio signal is; -#X text 80 228 not effected in any way.; -#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 [spigot] Is There a [spigot] for Audio Signals?; -#X obj 287 145 pddp/dsp; -#X connect 2 0 3 0; -#X connect 3 0 5 0; -#X connect 3 0 8 0; -#X connect 4 0 3 1; -#X connect 5 0 6 0; -#X connect 8 0 7 0; -#X restore 102 547 pd spigot_for_audio_signals; -#X text 98 303 anything; -#X text 167 344 - "0" blocks all incoming messages to the left inlet. -"1" (or any nonzero number) passes the incoming message to the outlet. -; -#X text 98 397 anything; -#X text 168 397 - if the last value received at the right inlet was -nonzero \, [spigot] passes the message from the first inlet to its -outlet.; -#X text 168 457 - By default \, the left inlet of [spigot] is initially -closed. A one (or any nonzero number) as a creation argument will cause -the spigot to be open initially. See the subpatch below for an example: -; -#X text 168 303 - [spigot] takes the input to the left inlet and either -ignores it or passes it through to the outlet \, depending on the value -at the right inlet.; -#N canvas 74 291 428 213 creation_args 0; -#X obj 146 108 spigot 0; -#X text 21 38 [spigot] only accepts one numerical creation argument: -a one or a zero. At creation time the [spigot] is "closed". With a -one \, its defaults to open.; -#X obj 214 108 spigot 1; -#X obj 146 81 bng 15 250 50 0 empty empty empty 0 -6 0 8 -225271 -1 --1; -#X obj 90 108 spigot; -#X obj 90 135 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 146 135 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 214 135 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#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 [spigot] Creation Arguments; -#X text 20 158 [spigot] used to accept any symbol as a creation argument -\, but all of these are meaningless and have no effect on the operation -of the object. This was removed in Pd 0.38-3; -#X connect 0 0 6 0; -#X connect 2 0 7 0; -#X connect 3 0 0 0; -#X connect 3 0 4 0; -#X connect 3 0 2 0; -#X connect 4 0 5 0; -#X restore 171 510 pd creation_args; -#X text 90 457 1) float; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 296 548 pddp/pddplink ../2.control.examples/18.conditional.pd --text doc/2.control.examples/18.conditional.pd; -#X connect 14 0 16 0; -#X connect 15 0 16 1; -#X connect 16 0 17 0; -#X connect 18 0 16 0; -#X connect 19 0 16 0; diff --git a/doc/pddp/sqrt~-help.pd b/doc/pddp/sqrt~-help.pd deleted file mode 100644 index 2261ee2ac..000000000 --- a/doc/pddp/sqrt~-help.pd +++ /dev/null @@ -1,77 +0,0 @@ -#N canvas 433 34 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 sqrt~ 3 12 0 18 --204280 -1 0; -#X obj 0 437 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 492 283 494 344 META 0; -#X text 12 105 LIBRARY internal; -#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 125 AUTHOR Miller Puckette; -#X text 12 185 HELP_PATCH_AUTHORS Updated for Pd version 0.33. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 5 KEYWORDS signal; -#X text 12 45 DESCRIPTION signal square root; -#X text 12 85 OUTLET_0 signal; -#X text 12 65 INLET_0 signal; -#X text 12 165 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 502 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 539 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 567 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#X text 98 543 (none); -#N canvas 220 517 428 109 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 obj 152 43 rsqrt~; -#X obj 203 43 sqrt; -#X obj 22 43 q8_sqrt~; -#X obj 82 43 q8_rsqrt~; -#X text 8 2 [sqrt~] Related Objects; -#X restore 102 597 pd Related_objects; -#X obj 78 446 cnv 17 3 45 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 511 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 511 7 sqrt~; -#X obj 232 240 metro 500; -#X floatatom 215 137 0 0 0 0 - - -; -#X floatatom 216 297 0 0 0 0 - - -; -#X obj 216 264 snapshot~; -#X floatatom 216 380 9 0 0 0 - - -, f 9; -#X obj 216 324 t f f; -#X obj 216 351 *; -#X obj 215 163 sig~; -#X text 98 445 signal; -#X obj 232 215 loadbang; -#X text 98 465 float; -#X obj 216 191 sqrt~; -#X text 168 465 - a float may be sent to the inlet as long as no signal -connections are made to [sqrt~].; -#X text 98 510 signal; -#X text 168 510 - the square root of the incoming signal is output. -; -#X text 11 23 signal square root; -#X text 168 445 - an incoming signal.; -#X text 20 72 [sqrt~] takes the approximate square root of the incoming -signal \, using a fast \, approximate algorithm which is probably accurate -to about 120 dB (20 bits).; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 481 55 pddp/dsp; -#X connect 12 0 15 0; -#X connect 13 0 19 0; -#X connect 14 0 17 0; -#X connect 15 0 14 0; -#X connect 17 0 18 0; -#X connect 17 1 18 1; -#X connect 18 0 16 0; -#X connect 19 0 23 0; -#X connect 21 0 12 0; -#X connect 23 0 15 0; diff --git a/doc/pddp/stripnote-help.pd b/doc/pddp/stripnote-help.pd deleted file mode 100644 index af9247c6f..000000000 --- a/doc/pddp/stripnote-help.pd +++ /dev/null @@ -1,109 +0,0 @@ -#N canvas 432 34 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 stripnote 3 12 0 -18 -204280 -1 0; -#X obj 0 358 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 487 261 494 366 META 0; -#X text 12 155 LIBRARY internal; -#X text 12 195 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 215 RELEASE_DATE 2009-06-12; -#X text 12 25 LICENSE SIBSD; -#X text 12 175 AUTHOR Miller Puckette; -#X text 12 235 HELP_PATCH_AUTHORS Updated for Pd version 0.28. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 5 KEYWORDS control MIDI; -#X text 12 45 DESCRIPTION send note-on messages and schedule note-off -for later; -#X text 12 75 INLET_0 float list; -#X text 12 115 OUTLET_0 float; -#X text 12 95 INLET_1 float; -#X text 12 135 OUTLET_1 float; -#X restore 500 597 pd META; -#X obj 0 467 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 540 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 567 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#X text 98 544 (none); -#N canvas 220 191 428 433 Related_objects 0; -#X obj 1 2 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 8 3 [stripnote] Related Objects; -#X obj 74 81 ctlin; -#X obj 217 81 pgmin; -#X obj 24 81 bendin; -#X obj 79 108 touchin; -#X obj 261 81 polytouchin; -#X obj 118 81 midiin; -#X obj 23 108 sysexin; -#X obj 179 168 noteout; -#X obj 76 168 ctlout; -#X obj 24 168 bendout; -#X obj 366 168 touchout; -#X obj 280 168 polytouchout; -#X obj 123 168 midiout; -#X obj 231 168 pgmout; -#X obj 24 222 makenote; -#X text 21 199 MIDI note construction:; -#X text 21 141 MIDI output:; -#X text 21 58 MIDI input:; -#X obj 184 222 stripnote; -#X obj 168 81 notein; -#X text 181 199 MIDI note deconstruction:; -#X obj 24 34 makenote; -#X text 22 275 Additional useful objects for MIDI processing (Maxlib -by Olaf Matthes); -#X text 21 354 Also \, from cyclone (alpha) by Krzysztof Czaja:; -#X text 22 256 Externals; -#X obj 22 305 pddp/helplink maxlib/pitch; -#X obj 22 320 pddp/helplink maxlib/score; -#X obj 22 335 pddp/helplink maxlib/chord; -#X obj 22 370 pddp/helplink cyclone/midiformat; -#X obj 22 385 pddp/helplink cyclone/midiparse; -#X obj 22 400 pddp/helplink cyclone/midiflush; -#X restore 102 597 pd Related_objects; -#X obj 78 367 cnv 17 3 65 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 366 float; -#X text 98 406 list; -#X text 98 476 float; -#X obj 78 477 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 439 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 98 438 float; -#X obj 480 10 stripnote; -#X text 130 227 Stripnote takes note-off (zero-velocity) messages out -of a stream of MIDI-style note message and passes the others through -unchanged.; -#X msg 134 127 23 0; -#X obj 134 202 print x1; -#X obj 191 202 print x2; -#X obj 134 166 stripnote; -#X text 168 366 - MIDI pitch value. The value will pass unchanged to -the left outlet if the current value of the right inlet is non-zero. -; -#X msg 174 127 34.5 67.8; -#X text 167 438 - a float to the right inlet is stored for later use. -; -#X text 168 476 - the MIDI pitch value received at the left inlet will -pass unchanged if the value of the right inlet is non-zero.; -#X text 98 506 float; -#X obj 78 507 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 168 506 - the velocity will pass unchanged if the value of -the right inlet is non-zero.; -#X text 11 23 send note-on messages and schedule note-off for later -; -#X text 168 406 - a (pitch \, velocity) pair is distributed to the -two inlets. Lists with more than two elements will be truncated.; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X connect 18 0 21 0; -#X connect 21 0 19 0; -#X connect 21 1 20 0; -#X connect 23 0 21 0; diff --git a/doc/pddp/struct-help.pd b/doc/pddp/struct-help.pd deleted file mode 100644 index 0cc32134e..000000000 --- a/doc/pddp/struct-help.pd +++ /dev/null @@ -1,161 +0,0 @@ -#N struct struct-1 float x float y symbol dog array weasel struct-2 -; -#N struct struct-2 float y; -#N canvas 430 33 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 struct 3 12 0 18 --204280 -1 0; -#X obj 0 189 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 484 285 494 344 META 0; -#X text 12 85 LIBRARY internal; -#X text 12 125 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 105 AUTHOR Miller Puckette; -#X text 12 165 HELP_PATCH_AUTHORS Updated for Pd version 0.35. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 5 KEYWORDS control data_structure; -#X text 12 45 DESCRIPTION declare the fields in a data structure; -#X text 12 65 OUTLET_0 click change select deselect displace; -#X text 12 145 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 214 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 375 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 532 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 217 517 428 109 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 [struct] Related Objects; -#X obj 22 43 filledpolygon; -#X obj 112 43 drawpolygon; -#X obj 193 43 plot; -#X obj 232 43 set; -#X obj 262 43 get; -#X obj 293 43 element; -#X obj 22 73 getsize; -#X obj 82 73 setsize; -#X obj 142 73 pointer; -#X obj 202 73 append; -#X obj 254 73 sublist; -#X restore 102 597 pd Related_objects; -#X obj 78 296 cnv 17 3 72 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 500 10 struct; -#X text 11 23 declare the fields in a data structure; -#X text 98 193 (none); -#X text 98 295 click; -#X text 98 325 select; -#X text 98 310 change; -#X text 98 355 displace; -#X text 98 340 deselect; -#X text 149 461 float; -#X text 149 476 symbol; -#X text 149 491 array; -#N canvas 98 230 428 349 help-template1 0; -#X obj 23 43 struct struct-1 float x float y symbol dog array weasel -struct-2; -#X text 20 182 This just displays a red square to visualize the data -structure.; -#X obj 23 159 filledpolygon 900 0 1 0 0 40 0 40 40 0 40; -#X obj 23 226 plot weasel 0 1 0 0 10; -#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 [struct] Data Stucture Template; -#X text 21 247 Here we plot the array "weasel" \, which gets displayed -on top of the red square; -#X obj 23 78 print; -#X text 20 99 In this example \, the "struct-1" structure is defined -in which "x" and "y" are "floats" \, i.e. \, numbers \, but "dog" is -a symbol and "weasel" is an array of objects of the data structure -"struct-2".; -#X text 21 286 To learn about z-ordering with data structures \, open -the abstraction below:; -#X obj 21 319 pddp/pddplink ./all_about_z_order.pd -text all_about_z_order.pd -; -#X connect 0 0 7 0; -#X restore 101 96 pd help-template1; -#N canvas 99 252 428 125 help-template2 0; -#X obj 23 43 struct struct-2 float y; -#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 [struct] Data Structure Template; -#X text 21 67 Here is a data structure which specifies only the floating -point "y". It's used for the elements of the array shown in the other -template.; -#X restore 101 118 pd help-template2; -#N canvas 83 305 428 348 struct-help-data 0; -#X scalar struct-1 95 43 symbol \; 17 \; 38 \; 2 \; 39 \; 14 \; \; -; -#X scalar struct-1 164 43 symbol \; 17 \; 1 \; 40 \; 2 \; 14 \; \; -; -#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 [struct] Related Objects; -#X scalar struct-1 239 43 symbol \; 17 \; 38 \; 2 \; 39 \; 14 \; \; -; -#X text 19 279 You can also right-click on each square and choose "Properties" -in both runmode and editmode to see the values associated with each -scalar.; -#X text 20 178 In editmode \, you can click on the squares to move -them. Like other objects in Pd \, you can select multiple scalars and -move them together (notice the blue bounding box when you select them). -A [print] object is connected to the outlet of the corresponding [struct] -for these boxes \, so when you move them with the mouse messages will -print to the console.; -#X text 20 103 The three squares above are scalars that are defined -by the template "help-template1". The zigzag lines are arrays \, the -elements of which are defined by the template "help-template2". In -runmode you can click and drag each element to change its value.; -#X restore 101 168 pd struct-help-data; -#X text 98 138 To view instances of these data structures \, click -the patch below:; -#X text 98 41 The [struct] object is typically put one to a subpatch -\, and may be accompanied by drawing instructions that define how the -data will be visualized. Two data structures- "struct-1" and "struct-2"- -are defined below in subpatches:; -#X text 169 393 - the name of the struct; -#N canvas 72 401 429 220 struct_names 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 [struct] Struct Names; -#X text 20 39 You can't use "float" or "_float_array" as struct names -because Pd has hidden data structures named "float" and "_float_array" -\, which are used for [table] and "Put menu arrays".; -#X msg 23 134 \; pd-_float vis 1 \; pd-_float_array vis 1; -#X text 20 99 You can click below to reveal the canvases that contain -them:; -#X restore 102 541 pd struct_names; -#X text 188 461 - "float foo"; -#X text 188 476 - "symbol foo"; -#X text 188 491 - "array foo bar" \, where "bar" is the name of another -data structure to be used as a template for elements of the array. -; -#X text 169 411 - all subsequent arguments are used to declare fields. -Fields may be one of three types-- float \, symbol \, or array. To -create the field "foo" \, use the syntax below for each type:; -#X text 81 393 1) symbol atom; -#X text 81 411 n) symbol atom; -#X obj 99 560 pddp/pddplink scalar-help.pd; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 98 576 pddp/pddplink all_about_arrays.pd; -#X obj 257 561 pddp/pddplink ../4.data.structures/06.file.pd -text -doc/4.data.structures/06.file.pd; -#X obj 257 576 pddp/pddplink ../4.data.structures/08.selection.pd -text -doc/4.data.structures/08.selection.pd; -#X text 99 217 When a scalar is moved or edited with the mouse \, data -is sent to the outlet of the respective [struct] object. This data -consists of: a selector that describes the mouse action that was performed -\, a pointer to the scalar \, and-- optionally-- a number (usually -a y-coordinate). The selectors below correspond to the following mouse -actions:; -#X text 172 295 - (run mode) clicking the object with the mouse.; -#X text 172 310 - (run mode) changing the value of a field.; -#X text 172 325 - (edit mode) selecting the object.; -#X text 172 340 - (edit mode) deselecting an object.; -#X text 172 355 - (edit mode) moving a selected object.; diff --git a/doc/pddp/sublist-help.pd b/doc/pddp/sublist-help.pd deleted file mode 100644 index 03852e96b..000000000 --- a/doc/pddp/sublist-help.pd +++ /dev/null @@ -1,61 +0,0 @@ -#N canvas 429 33 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 sublist 3 12 0 18 --204280 -1 0; -#X obj 0 439 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 488 280 494 344 META 0; -#X text 12 105 LIBRARY internal; -#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 125 AUTHOR Miller Puckette; -#X text 12 185 HELP_PATCH_AUTHORS Updated for Pd version 0.32. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 5 KEYWORDS control data_structure; -#X text 12 45 DESCRIPTION get a list from a field of a scalar; -#X text 12 65 INLET_0 pointer; -#X text 12 85 OUTLET_0 pointer; -#X text 12 165 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 476 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 512 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 569 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 216 513 428 109 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 [sublist] Related Objects; -#X obj 14 38 get; -#X obj 46 38 set; -#X obj 136 38 getsize; -#X obj 193 38 setsize; -#X obj 121 63 element; -#X obj 13 64 sublist; -#X obj 79 38 pointer; -#X obj 69 63 struct; -#X restore 102 597 pd Related_objects; -#X obj 78 448 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 485 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 492 11 sublist; -#X text 96 170 Don't try this yet -- it's untested.; -#X text 103 208 "sublist" will take as creation arguments a template -name and a field name \; its one input takes a pointer. If you send -a pointer (which should agree with the template name) \, "sublist" -will output the field (which should be of type "list".) The output -is in fact a pointer to the head of the sublist.; -#X text 98 447 pointer; -#X text 98 484 pointer; -#X text 11 23 get a list from a field of a scalar; -#X text 168 530 - template name.; -#X text 168 545 - field name.; -#X text 80 530 1) symbol; -#X text 80 545 2) symbol; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 98 573 pddp/pddplink scalar-help.pd; diff --git a/doc/pddp/swap-help.pd b/doc/pddp/swap-help.pd deleted file mode 100644 index 9f24411a1..000000000 --- a/doc/pddp/swap-help.pd +++ /dev/null @@ -1,232 +0,0 @@ -#N canvas 429 36 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 swap 3 12 0 18 -204280 --1 0; -#X obj 0 220 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 489 275 494 357 META 0; -#X text 12 165 LIBRARY internal; -#X text 12 205 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 45 LICENSE SIBSD; -#X text 12 185 AUTHOR Miller Puckette; -#X text 12 245 HELP_PATCH_AUTHORS Dave Sabine \, November 12 \, 2002 -. Jonathan Wilkes revised the patch to conform to the PDDP template -for Pd version 0.42.; -#X text 12 25 KEYWORDS control float list bang; -#X text 12 65 DESCRIPTION swap two numbers \, respecting right-to-left -order; -#X text 12 85 INLET_0 float list bang; -#X text 12 105 INLET_1 float; -#X text 12 125 OUTLET_0 float; -#X text 12 145 OUTLET_1 float; -#X text 12 225 RELEASE_DATE 1997; -#X text 12 5 ALIAS fswap; -#X restore 500 597 pd META; -#X obj 0 425 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 485 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 537 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 217 495 428 136 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 [swap] Related Objects; -#X text 20 69 Externals and other object libraries; -#X obj 23 34 pack; -#X obj 65 34 unpack; -#X obj 20 89 pddp/helplink cyclone/split; -#X restore 102 597 pd Related_objects; -#X obj 78 229 cnv 17 3 145 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 433 float; -#X obj 78 434 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 380 cnv 17 3 35 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 98 379 float; -#X obj 445 10 swap; -#X text 98 278 float; -#X text 168 283 - a float at the left inlet will send the number to -the right outlet and then send the number at the right inlet to the -left outlet.; -#X text 98 229 bang; -#X text 168 229 - a bang at the left inlet will force [swap] to send -its values to the outlets \, in reverse order. The value from the left -inlet will be sent to the right outlet then the value at the right -inlet will be sent out the left outlet.; -#X text 98 324 list; -#X text 168 324 - a list at the left inlet will update the values of -both of [swap]'s inlets and send the numbers to the outlets in reverse -order. Note that lists of 3 or more elements will be truncated.; -#X text 167 379 - a float at the right inlet is stored for later use. -It will be sent to the left outlet when a float or bang is received -in the left inlet.; -#X text 98 456 float; -#X obj 78 457 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X obj 78 152 swap; -#X floatatom 106 79 5 0 0 0 - - -, f 5; -#X floatatom 190 119 5 0 0 0 - - -, f 5; -#X floatatom 118 179 5 0 0 0 - - -, f 5; -#X floatatom 78 179 5 0 0 0 - - -, f 5; -#X msg 149 78 42 7; -#X obj 78 77 bng 15 250 50 0 empty empty empty 0 -6 0 10 -262144 -1 --1; -#X msg 191 78 42 7 3 4; -#X floatatom 333 143 5 0 0 0 - - -, f 5; -#X floatatom 294 142 5 0 0 0 - - -, f 5; -#X msg 294 88 bang; -#X obj 294 112 swap 12; -#X text 188 102 float; -#X text 103 60 float; -#X text 150 60 list; -#X text 286 162 creation argument; -#N canvas 90 38 428 503 More_Info 0; -#X msg 42 82 42 7; -#X obj 42 107 swap; -#X floatatom 42 133 5 0 0 0 - - -, f 5; -#X floatatom 101 133 5 0 0 0 - - -, f 5; -#X obj 42 157 pack f f; -#X obj 42 181 print; -#X floatatom 43 347 5 0 0 0 - - -, f 5; -#X floatatom 93 347 5 0 0 0 - - -, f 5; -#X floatatom 142 347 5 0 0 0 - - -, f 5; -#X floatatom 111 468 5 0 0 0 - - -, f 5; -#X floatatom 158 468 5 0 0 0 - - -, f 5; -#X floatatom 212 468 5 0 0 0 - - -, f 5; -#X msg 42 271 2 2500 9 420; -#X obj 42 317 unpack f f f f; -#X floatatom 192 347 5 0 0 0 - - -, f 5; -#X text 18 38 [swap] is most commonly used to change the order of a -list. This trick is best suited for a PAIR of numbers.; -#X obj 165 373 swap; -#X obj 138 398 swap; -#X obj 111 422 swap; -#X obj 195 406 swap; -#X obj 168 431 swap; -#X obj 227 436 swap; -#X floatatom 263 468 5 0 0 0 - - -, f 5; -#X text 199 373 This could quickly become ridiculous!; -#X msg 140 271 1 2 3 4; -#X msg 219 271 0 200 3333 1111; -#X text 19 213 Lists that are longer than two elements could be sorted -this way \, but the structure quickly becomes unmanageable. It's probably -better to find an alternative method.; -#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 [swap] More Info; -#X connect 0 0 1 0; -#X connect 1 0 2 0; -#X connect 1 1 3 0; -#X connect 2 0 4 0; -#X connect 3 0 4 1; -#X connect 4 0 5 0; -#X connect 6 0 18 0; -#X connect 7 0 17 0; -#X connect 8 0 16 0; -#X connect 12 0 13 0; -#X connect 13 0 6 0; -#X connect 13 1 7 0; -#X connect 13 2 8 0; -#X connect 13 3 14 0; -#X connect 14 0 16 1; -#X connect 16 0 17 1; -#X connect 16 1 19 1; -#X connect 17 0 18 1; -#X connect 17 1 19 0; -#X connect 18 0 9 0; -#X connect 18 1 20 0; -#X connect 19 0 20 1; -#X connect 19 1 21 1; -#X connect 20 0 10 0; -#X connect 20 1 21 0; -#X connect 21 0 11 0; -#X connect 21 1 22 0; -#X connect 24 0 13 0; -#X connect 25 0 13 0; -#X restore 102 546 pd More_Info; -#N canvas 70 19 444 592 Note-off_parser_using_swap 0; -#X obj 0 346 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 -0 14 -204280 -1 0; -#X obj 21 109 notein; -#X text 77 105 [notein] is an object which receives incoming MIDI data -from a MIDI instrument. The three outlets are PITCH \, VELOCITY \, -and MIDI CHANNEL from left to right. It is important to note however -that the data is outputted from right to left. Which means that the -first piece of information to be sent out the object is the MIDI CHANNEL. -; -#X obj 21 183 swap; -#X obj 21 222 pack; -#X obj 21 266 route 0; -#X floatatom 21 294 5 0 0 0 - - -, f 5; -#X text 76 183 Here \, [swap] is used to store the VELOCITY until the -PITCH information comes from [notein]. The next step will pack the -two together...but we have to ensure that [pack] receives the two numbers -in the correct order: PITCH first \, then VELOCITY. This way \, using -[route] we can determine whether or not this incoming MIDI data is -a "note-off" signal (i.e. VELOCITY = 0).; -#X obj 21 316 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 21 386 notein; -#X obj 22 426 pack; -#X obj 22 451 route 0; -#X floatatom 22 476 5 0 0 0 - - -, f 5; -#X obj 22 497 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X text 45 315 This will "bang" only when velocity = 0; -#X text 18 37 In some settings \, the [swap] object is useful as a -timing mechanism to ensure that two numbers arrive at their destination -in a particular order. Miller Puckette has provided an excellent example -of [swap] used to build a 'note-off parser':; -#X obj 0 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 7 346 Why doesn't the alternative work?; -#X text 77 382 The goal of the Miller's example above is to retrieve -"note-off" signals from [notein]. To do that \, we have to test the -incoming data for pitches with a velocity of zero. So we swap the values -\, pack up the incoming VELOCITY and PITCH data \, and send them to -[route]...in effect we achieve the following:; -#X text 78 463 IF velocity = 0 THEN display the pitch and send a bang -; -#X text 77 485 With the [notein] object \, the VELOCITY information -is sent before the PITCH information. (Remember that in Pd data is -sent to the outlets in right-to-left order.) In the example at left -\, the VELOCITY information triggers the output of [pack] BEFORE the -PITCH information is retrieved. This is why [swap] is used-- it solves -the problem by making sure that the VELOCITY and PITCH are both received -before packing them up and sending them to the [route] object.; -#X text 7 1 [swap] Note-off Parser; -#X connect 1 0 3 0; -#X connect 1 1 3 1; -#X connect 3 0 4 0; -#X connect 3 1 4 1; -#X connect 4 0 5 0; -#X connect 5 0 6 0; -#X connect 6 0 8 0; -#X connect 9 0 10 1; -#X connect 9 1 10 0; -#X connect 10 0 11 0; -#X connect 11 0 12 0; -#X connect 12 0 13 0; -#X restore 102 568 pd Note-off_parser_using_swap; -#X text 11 23 swap two numbers \, respecting right-to-left order; -#X text 168 433 - outputs the value from the right inlet.; -#X text 168 456 - outputs the value from the left inlet.; -#X text 80 503 1) float; -#X text 168 503 - initializes the value of the right inlet.; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 505 10 fswap; -#X text 482 10 or; -#X connect 23 0 27 0; -#X connect 23 1 26 0; -#X connect 24 0 23 0; -#X connect 25 0 23 1; -#X connect 28 0 23 0; -#X connect 29 0 23 0; -#X connect 30 0 23 0; -#X connect 33 0 34 0; -#X connect 34 0 32 0; -#X connect 34 1 31 0; diff --git a/doc/pddp/switch~-help.pd b/doc/pddp/switch~-help.pd deleted file mode 100644 index c756719f3..000000000 --- a/doc/pddp/switch~-help.pd +++ /dev/null @@ -1,172 +0,0 @@ -#N canvas 431 36 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 486 287 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 216 520 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 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 - - -, f 5; -#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 - - -, f 1; -#X floatatom 23 159 7 0 0 0 - - -, f 7; -#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.), f -60; -#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; -#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 480 56 pddp/dsp; -#X obj 495 11 switch~; -#X text 459 147; diff --git a/doc/pddp/tabosc4~-help.pd b/doc/pddp/tabosc4~-help.pd deleted file mode 100644 index 341717c69..000000000 --- a/doc/pddp/tabosc4~-help.pd +++ /dev/null @@ -1,192 +0,0 @@ -#N canvas 428 35 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 tabosc4~ 3 12 0 -18 -204280 -1 0; -#X obj 0 262 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 483 286 494 344 META 0; -#X text 12 125 LIBRARY internal; -#X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 145 AUTHOR Miller Puckette; -#X text 12 205 HELP_PATCH_AUTHORS Updated for Pd version 0.33. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 5 KEYWORDS signal array; -#X text 12 45 DESCRIPTION 4-point interpolating oscillator; -#X text 12 65 INLET_0 signal set; -#X text 12 85 INLET_1 float; -#X text 12 105 OUTLET_0 signal; -#X text 12 185 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 419 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 453 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 491 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 215 334 428 298 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 [tabosc4~] Related Objects; -#X text 21 38 Native Pd Objects; -#X obj 24 61 tabread~; -#X obj 98 61 tabread4; -#X obj 173 61 tabwrite; -#X obj 248 61 tabwrite~; -#X obj 24 89 tabsend~; -#X obj 100 89 tabreceive~; -#X obj 200 89 tabplay~; -#X obj 277 89 table; -#X text 21 140 [array]; -#X obj 24 116 soundfiler; -#X text 84 140 and fft objects.; -#X obj 120 116 tabread4~; -#X obj 211 116 getsize; -#X text 22 170 Externals and other object libraries; -#X obj 22 190 pddp/helplink zexy/tabdump; -#X obj 22 210 pddp/helplink linear_path; -#X text 103 210 <-- which library is this in?; -#X text 103 230 <-- which library is this in?; -#X obj 22 230 pddp/helplink score; -#X text 103 250 <-- which library is this in?; -#X obj 22 250 pddp/helplink tabenv; -#X obj 22 270 pddp/helplink arraysize; -#X restore 102 597 pd Related_objects; -#X obj 78 271 cnv 17 3 100 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 428 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 376 cnv 17 3 35 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 98 375 float; -#X obj 485 8 tabosc4~; -#X floatatom 43 203 0 0 0 0 - - -; -#N canvas 159 26 495 270 output 0; -#X obj 414 196 t b; -#X obj 414 134 f; -#X obj 414 73 inlet; -#X text 421 36 mute; -#X obj 414 227 f; -#X msg 521 218 0; -#X msg 414 104 bang; -#X obj 414 166 moses 1; -#X obj 521 187 t b f; -#X obj 486 143 moses 1; -#X obj 102 181 dbtorms; -#X obj 486 113 r master-lvl; -#X obj 102 52 r master-lvl; -#X obj 414 257 s master-lvl; -#X obj 26 222 inlet~; -#X obj 244 50 inlet; -#X text 244 22 level; -#X obj 244 122 s master-lvl; -#X msg 118 80 set \$1; -#X obj 118 109 outlet; -#X msg 262 78 \; pd dsp 1; -#X obj 102 238 line~; -#X obj 26 259 *~; -#X obj 26 295 dac~; -#X obj 102 210 pack 0 50; -#X text 24 195 audio; -#X text 114 135 show level; -#X connect 0 0 4 0; -#X connect 1 0 7 0; -#X connect 2 0 6 0; -#X connect 4 0 13 0; -#X connect 5 0 13 0; -#X connect 6 0 1 0; -#X connect 7 0 0 0; -#X connect 7 1 8 0; -#X connect 8 0 5 0; -#X connect 9 1 4 1; -#X connect 10 0 24 0; -#X connect 11 0 1 1; -#X connect 11 0 9 0; -#X connect 12 0 10 0; -#X connect 12 0 18 0; -#X connect 14 0 22 0; -#X connect 15 0 17 0; -#X connect 15 0 20 0; -#X connect 18 0 19 0; -#X connect 21 0 22 1; -#X connect 22 0 23 0; -#X connect 22 0 23 1; -#X connect 24 0 21 0; -#X restore 18 224 pd output; -#X msg 69 203 MUTE; -#X floatatom 18 51 4 0 0 0 - - -, f 4; -#X obj 18 76 sig~ 100; -#X msg 32 119 set table1; -#X obj 18 158 tabosc4~ table1; -#X msg 116 119 set table2; -#X floatatom 190 121 4 0 0 0 - - -, f 4; -#X text 48 51 signal input for frequency (Hz.); -#X text 33 98 message to switch tables; -#X text 220 121 inlet to reset phase; -#X obj 319 51 table table1; -#X obj 319 73 table table2; -#X text 98 270 signal; -#X text 98 288 float; -#X text 98 327 list; -#X text 168 327 - a list will be truncated to the first item.; -#X text 98 343 set; -#X text 168 343 - the "set" message is used to switch to a different -table (e.g. \, "set table2" in the example above).; -#X text 167 375 - inlet to reset phase (range is 0 to 1).; -#X text 98 395 list; -#X text 167 395 - a list will be truncated to the first item.; -#X text 98 427 signal; -#N canvas 72 194 428 199 init_tables 0; -#X msg 23 99 \; table1 sinesum 512 0.5 0.5 0.5 0.5 \; table2 cosinesum -512 0 1; -#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 [tabosc4~] Subpatch to Initialize [table] objects; -#X obj 23 75 loadbang; -#X text 20 38 This subpatch initializes the [table] objects used by -[tabosc4~].; -#X text 20 147 Note: Don't send new "sinesum" messages to tables while -you're running. Instead \, use "set" messages to switch between tables. -; -#X connect 3 0 0 0; -#X restore 319 95 pd init_tables; -#X text 29 184 volume in dB; -#X text 11 23 4-point interpolating oscillator; -#X text 168 471 - initializes the table or array to use.; -#X text 168 288 - a float can be used to specify the frequency \, as -long as there is not also a signal connection to the left inlet of -[tabosc4~].; -#X text 168 270 - an incoming signal to specify frequency (Hz.).; -#X text 168 427 - the outgoing signal.; -#X text 98 494 For good results use 512 points for up to about 15 partials -\, or 32*npartials (rounded up to a power of 2) for more than 15 . -; -#X text 139 152 [tabosc4~] is a traditional computer music style wavetable -lookup oscillator using 4-point polynomial interpolation. The table -should have a power of two points plus three "guard points" \, one -at the beginning and two at the end \, which should be wraparound copies -of the last point and the first two points \, respectively. The "sinesum" -and "cosinesum" methods for arrays do this automatically for you if -you just want to specify partial strengths.; -#X text 80 471 1) symbol atom; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 475 55 pddp/dsp; -#X obj 98 530 pddp/pddplink all_about_arrays.pd; -#X obj 98 545 pddp/pddplink ../3.audio.examples/B01.wavetables.pd -text -doc/3.audio.examples/B01.wavetables.pd; -#X obj 98 560 pddp/pddplink ../3.audio.examples/B05.tabread.FM.pd -text -doc/3.audio.examples/B05.tabread.FM.pd; -#X obj 98 575 pddp/pddplink ../3.audio.examples/B06.table.switching.pd --text doc/3.audio.examples/B06.table.switching.pd; -#X connect 13 0 14 1; -#X connect 14 0 13 0; -#X connect 15 0 14 2; -#X connect 16 0 17 0; -#X connect 17 0 19 0; -#X connect 18 0 19 0; -#X connect 19 0 14 0; -#X connect 20 0 19 0; -#X connect 21 0 19 1; diff --git a/doc/pddp/tabplay~-help.pd b/doc/pddp/tabplay~-help.pd deleted file mode 100644 index 3e297ea69..000000000 --- a/doc/pddp/tabplay~-help.pd +++ /dev/null @@ -1,162 +0,0 @@ -#N canvas 430 35 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 tabplay~ 3 12 0 -18 -204280 -1 0; -#X obj 0 284 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 487 285 494 344 META 0; -#X text 12 125 LIBRARY internal; -#X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 145 AUTHOR Miller Puckette; -#X text 12 205 HELP_PATCH_AUTHORS Updated for Pd version 0.29. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 5 KEYWORDS signal array; -#X text 12 45 DESCRIPTION play a table as audio (non-transposing); -#X text 12 65 INLET_0 float bang list set; -#X text 12 85 OUTLET_0 signal; -#X text 12 105 OUTLET_1 bang; -#X text 12 185 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 437 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 502 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 565 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 202 329 441 301 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 [tabplay~] Related Objects; -#X text 20 38 Native Pd Objects; -#X obj 23 63 tabread~; -#X obj 97 63 tabread4; -#X obj 276 89 table; -#X text 22 146 [array]; -#X obj 23 116 soundfiler; -#X text 85 146 and fft objects.; -#X obj 119 116 tabread4~; -#X obj 210 116 getsize; -#X obj 281 116 setsize; -#X obj 172 63 tabread; -#X obj 247 63 tabwrite; -#X obj 23 89 tabwrite~; -#X obj 99 89 tabsend~; -#X obj 179 89 tabreceive~; -#X text 20 170 Externals and other object libraries; -#X obj 20 190 pddp/helplink zexy/tabdump; -#X obj 20 210 pddp/helplink linear_path; -#X text 101 210 <-- which library is this in?; -#X text 101 230 <-- which library is this in?; -#X obj 20 230 pddp/helplink score; -#X text 101 250 <-- which library is this in?; -#X obj 20 250 pddp/helplink tabenv; -#X obj 20 270 pddp/helplink arraysize; -#X restore 102 597 pd Related_objects; -#X obj 78 293 cnv 17 3 135 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 446 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 489 10 tabplay~; -#X text 98 292 bang; -#X text 98 310 float; -#X text 98 347 list; -#X text 98 375 set; -#X obj 78 469 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 98 445 signal; -#X text 98 468 bang; -#X text 168 468 - the right inlet sends a bang when [tabplay~] has -finished playing through the table.; -#X text 168 310 - sending a float n will cause [tabplay~] to start -playing from the nth sample. (Sending 0 will play the entire sample.) -; -#X text 168 347 - a two-element list (x \, y) will cause [tabplay~] -to begin at sample number x \, and continue for y samples.; -#X floatatom 13 256 0 0 0 0 - - -; -#X msg 13 52 set array99; -#X obj 13 230 env~ 16384; -#X obj 179 257 dac~ 1; -#X obj 179 213 *~; -#X obj 193 191 line~; -#X msg 193 150 0.1 100; -#X msg 209 171 0 100; -#X text 255 151 on; -#X text 255 171 off; -#X text 231 191 envelope; -#X text 231 202 generator; -#X text 223 259 audio output; -#X obj 179 235 hip~ 5; -#X msg 42 137 0 44100; -#X msg 38 116 44100; -#X msg 28 76 bang; -#X msg 48 157 44100 1000; -#X text 168 520 - the name of the array or table to which [tabwrite~] -will write data. The array or table must exist in an open Pd patch/canvas -or an error message will appear in the console.; -#X text 174 128 amplitude controls:; -#N canvas 0 0 450 300 (subpatch) 0; -#X array \$0-array 155948 float 0; -#X coords 0 1 155948 -1 160 100 1; -#X restore 345 145 graph; -#N canvas 0 0 428 391 init 0; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X obj 23 283 soundfiler; -#X floatatom 23 305 0 0 0 0 - - -; -#X obj 23 204 loadbang; -#X text 20 38 The objects below load a short soundfile into the array -named "tabplay~-help-array."; -#X text 20 68 If you right-click on the array and choose "Properties -\, " you'll see the "save contents" checkbox is unmarked \, so that -the array data is not saved as part of the patch.; -#X text 20 110 You can always check this box to save the contents of -the array in the patch \, but with large amounts of array data- even -a few seconds of audio- this can create rather large Pd files.; -#X text 20 162 Thus it is better just to load the content of the array -when the patch opens \, as follows:; -#X text 20 333 See the [soundfiler] help patch for more information. -; -#X text 8 2 [tabplay~] Initialisation Subpatch; -#X obj 23 231 f \$0; -#X msg 23 258 read -resize ../sound/bell.aiff \$1-array; -#X connect 1 0 2 0; -#X connect 3 0 10 0; -#X connect 10 0 11 0; -#X connect 11 0 1 0; -#X restore 345 250 pd init; -#X text 11 23 play a table as audio (non-transposing); -#X text 95 75 The tabplay~ object plays through a table \, or part -of one \, with no transposition or interpolation. It is cheaper than -tabread4~ and there are none of tabread4~'s interpolation artifacts. -; -#X text 168 292 - play through the whole table.; -#X text 168 375 - the "set" message \, followed by the name of an array -\, permits you to switch between arrays (e.g. \, "set another_array"). -; -#X text 168 445 - the outgoing audio signal.; -#X text 80 520 1) symbol; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 480 56 pddp/dsp; -#X obj 98 570 pddp/pddplink all_about_arrays.pd; -#X obj 13 180 tabplay~ \$0-array; -#X msg 33 96 stop; -#X text 98 417 stop; -#X text 168 417 - stop playback; -#X connect 22 0 52 0; -#X connect 23 0 21 0; -#X connect 25 0 34 0; -#X connect 26 0 25 1; -#X connect 27 0 26 0; -#X connect 28 0 26 0; -#X connect 34 0 24 0; -#X connect 35 0 52 0; -#X connect 36 0 52 0; -#X connect 37 0 52 0; -#X connect 38 0 52 0; -#X connect 52 0 23 0; -#X connect 52 0 25 0; -#X connect 53 0 52 0; diff --git a/doc/pddp/tabread-help.pd b/doc/pddp/tabread-help.pd deleted file mode 100644 index e00ff62ae..000000000 --- a/doc/pddp/tabread-help.pd +++ /dev/null @@ -1,131 +0,0 @@ -#N canvas 430 33 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 tabread 3 12 0 18 --204280 -1 0; -#X obj 0 277 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 483 279 494 344 META 0; -#X text 12 105 LIBRARY internal; -#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 125 AUTHOR Miller Puckette; -#X text 12 185 HELP_PATCH_AUTHORS Dave Sabine \, April 25 \, 2003 . -Jonathan Wilkes revised the patch to conform to the PDDP template for -Pd version 0.42.; -#X text 12 5 KEYWORDS control array; -#X text 12 45 DESCRIPTION read numbers from a table; -#X text 12 65 INLET_0 float set; -#X text 12 85 OUTLET_0 float; -#X text 12 165 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 444 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 482 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 541 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 215 327 428 299 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 [tabread] Related Objects; -#X text 21 38 Native Pd Objects; -#X obj 24 61 tabread~; -#X obj 98 61 tabread4; -#X obj 173 61 tabwrite; -#X obj 248 61 tabwrite~; -#X obj 24 89 tabsend~; -#X obj 100 89 tabreceive~; -#X obj 200 89 tabplay~; -#X obj 277 89 table; -#X text 21 140 [array]; -#X obj 24 116 soundfiler; -#X text 84 140 and fft objects.; -#X obj 120 116 tabread4~; -#X obj 211 116 getsize; -#X obj 282 116 setsize; -#X text 22 164 Externals and other object libraries; -#X obj 22 184 pddp/helplink zexy/tabdump; -#X obj 22 204 pddp/helplink linear_path; -#X text 103 204 <-- which library is this in?; -#X text 103 224 <-- which library is this in?; -#X obj 22 224 pddp/helplink score; -#X text 103 244 <-- which library is this in?; -#X obj 22 244 pddp/helplink tabenv; -#X obj 22 264 pddp/helplink arraysize; -#X restore 102 597 pd Related_objects; -#X obj 78 286 cnv 17 3 145 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 285 float; -#X text 98 452 float; -#X obj 78 453 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 492 11 tabread; -#X text 168 285 - a float at the left inlet will move to the corresponding -index in the table's array. The index ranges from 0 to the size of -the array minus one (numbers outside this range are ignored). By default -\, the size of an array in a table is 100 - or 0 to 99 . The actual -size of the array can be altered using the array's dialog box or the -resize command. More about arrays can be found below.; -#X text 98 402 set; -#X text 168 500 - the argument informs [tabread] which array to read. -The array must exist in an open Pd patch/canvas or an error message -will appear in the terminal window.; -#X text 168 452 - outputs a floating point number which corresponds -to the index you query using the inlet.; -#X floatatom 74 251 0 0 0 0 value - -; -#X floatatom 74 93 0 0 99 0 index - -; -#X text 18 55 Open the tables and use your mouse to draw new values -in the arrays - otherwise [tabread] will always output "0".; -#N canvas 0 0 450 300 (subpatch) 0; -#X array \$0-array1 100 float 3; -#A 0 -0.900001 -0.900001 -0.900001 -0.900001 -0.900001 -0.866667 -0.833334 --0.833334 -0.833334 -0.833334 -0.800001 -0.800001 -0.766667 -0.766667 --0.766667 -0.766667 -0.766667 -0.766667 -0.766667 -0.766667 -0.766667 --0.766667 -0.766667 -0.766667 -0.766667 -0.766667 -0.766667 -0.766667 --0.766667 -0.766667 -0.733334 -0.733334 -0.733334 -0.7 -0.666667 -0.633334 --0.633334 -0.633334 -0.633334 -0.633334 -0.633334 -0.633334 -0.633334 --0.6 -0.6 -0.566667 -0.566667 -0.566667 -0.566667 -0.566667 -0.566667 --0.566667 -0.566667 -0.566667 -0.566667 -0.566667 -0.533334 -0.533334 --0.5 -0.5 -0.466667 -0.466667 -0.433334 -0.4 -0.366667 -0.333333 -0.3 --0.283333 -0.266667 -0.233333 -0.2 -0.133333 -0.133333 -0.133333 -0.0666667 --0.0666667 -0.0666667 1.49012e-08 0.1 0.1 0.233333 0.3 0.333334 0.4 -0.433334 0.566667 0.633334 0.733334 0.733334 0.766667 0.766667 0.800001 -0.800001 0.800001 0.800001 0.800001 0.800001 0.800001 0.800001 0.900001 -; -#X coords 0 1 99 -1 100 60 1; -#X restore 383 83 graph; -#X text 346 217 mouse to draw new values.; -#X text 346 204 Open the table and use your; -#X text 168 402 - the "set" message allows you to read from dynamic -sources (e.g. \, "set tabread-help-array"). You can change the source -at any time using the "set" message.; -#X text 98 380 list; -#X text 168 380 - a list will be truncated to the first item.; -#X text 11 24 read numbers from a table; -#X obj 98 577 pddp/pddplink all_about_arrays.pd -text all_about_arrays -; -#X text 80 500 1) symbol atom; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 107 93 bng 15 250 50 0 empty empty empty 17 7 0 10 -4034 -1 --1; -#X obj 107 113 f \$0; -#X obj 110 162 bng 15 250 50 0 empty empty empty 17 7 0 10 -4034 -1 --1; -#X obj 110 182 f \$0; -#X msg 107 135 set \$1-array1; -#X obj 74 227 tabread \$0-array1; -#X msg 110 204 set \$1-array2; -#X obj 353 184 table \$0-array2; -#X obj 98 547 pddp/pddplink ../2.control.examples/15.arrays.pd; -#X obj 97 562 pddp/pddplink ../2.control.examples/16.more.arrays.pd -; -#X connect 18 0 35 0; -#X connect 30 0 31 0; -#X connect 31 0 34 0; -#X connect 32 0 33 0; -#X connect 33 0 36 0; -#X connect 34 0 35 0; -#X connect 35 0 17 0; -#X connect 36 0 35 0; diff --git a/doc/pddp/tabread4~-help.pd b/doc/pddp/tabread4~-help.pd deleted file mode 100644 index ed3788474..000000000 --- a/doc/pddp/tabread4~-help.pd +++ /dev/null @@ -1,141 +0,0 @@ -#N canvas 429 34 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 tabread4~ 3 12 0 -18 -204280 -1 0; -#X obj 0 305 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 487 283 494 344 META 0; -#X text 12 125 LIBRARY internal; -#X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 145 AUTHOR Miller Puckette; -#X text 12 205 HELP_PATCH_AUTHORS Updated for Pd version 0.29. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 5 KEYWORDS signal array; -#X text 12 45 DESCRIPTION 4-point-interpolating table lookup; -#X text 12 65 INLET_0 signal set; -#X text 12 85 INLET_1 float; -#X text 12 105 OUTLET_0 signal; -#X text 12 185 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 417 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 449 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 510 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 218 331 428 294 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 21 38 Native Pd Objects; -#X obj 24 61 tabread~; -#X obj 98 61 tabread4; -#X obj 173 61 tabwrite; -#X obj 248 61 tabwrite~; -#X obj 24 89 tabsend~; -#X obj 100 89 tabreceive~; -#X obj 200 89 tabplay~; -#X obj 277 89 table; -#X text 21 140 [array]; -#X obj 24 116 soundfiler; -#X text 84 140 and fft objects.; -#X obj 120 116 tabread4~; -#X obj 211 116 getsize; -#X obj 282 116 setsize; -#X text 8 2 [tabread4~] Related Objects; -#X text 21 170 Externals and other object libraries; -#X obj 21 190 pddp/helplink zexy/tabdump; -#X obj 21 210 pddp/helplink linear_path; -#X text 102 210 <-- which library is this in?; -#X text 102 230 <-- which library is this in?; -#X obj 21 230 pddp/helplink score; -#X text 102 250 <-- which library is this in?; -#X obj 21 250 pddp/helplink tabenv; -#X obj 21 270 pddp/helplink arraysize; -#X restore 102 597 pd Related_objects; -#X obj 78 314 cnv 17 3 75 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 426 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 479 12 tabread4~; -#X text 11 23 4-point-interpolating table lookup; -#X text 68 174 signal input x(n); -#X obj 21 261 snapshot~; -#X obj 40 239 metro 200; -#X obj 21 115 sig~; -#X floatatom 21 89 0 0 0 0 - - -; -#X floatatom 21 284 0 0 0 0 - - -; -#X text 98 313 signal; -#X text 168 313 - the incoming signal is the index. Indices should -range from 1 to the size of the array minus two \, so that the 4-point -interpolation is meaningful.; -#X text 53 83 Shift-drag the number box to see the effect of interpolation. -; -#X text 98 353 set; -#N canvas 0 0 450 300 (subpatch) 0; -#X array \$0-array 10 float 0; -#X coords 0 1 9 -1 160 100 1; -#X restore 289 141 graph; -#X text 98 425 signal; -#X obj 40 217 loadbang; -#X obj 100 515 pddp/pddplink all_about_arrays.pd -text all_about_arrays -; -#X text 168 467 - the name of the array or table from which [tabread4~] -will read data. The array or table must exist in an open Pd patch/canvas -or an error message will appear in the console.; -#N canvas 117 345 428 159 init 0; -#X msg 23 103 0 -0.8 -0.6 -0.4 -0.2 0 0.2 0.4 0.6 0.8 1; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X obj 23 81 loadbang; -#X text 8 2 [tabread4~] [table] initialization; -#X text 20 38 This subpatch just initializes a [table] to some values. -(Values in a [table] are not saved in the patch.); -#X obj 23 125 s \$0-array; -#X connect 0 0 5 0; -#X connect 2 0 0 0; -#X restore 288 270 pd init; -#X text 168 353 - the "set" message \, followed by the name of an array -\, permits you to switch between arrays (e.g. \, "set another_array"). -; -#X text 80 467 1) symbol; -#X text 18 44 [tabread4~] is used to build samplers and other table -lookup algorithms. The interpolation scheme is 4-point polynomial. -; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 475 53 pddp/dsp; -#X obj 100 530 pddp/pddplink ../3.audio.examples/B03.tabread4.pd -text -doc/3.audio.examples/B03.tabread4.pd; -#X obj 100 545 pddp/pddplink ../3.audio.examples/B04.tabread4.interpolation.pd --text doc/3.audio.examples/B04.tabread4.interpolation.pd; -#X obj 78 396 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 98 395 float; -#X obj 247 395 pddp/pddplink ../3.audio.examples/B15.tabread4~-onset.pd --text doc/3.audio.examples/B15.tabread4~-onset.pd; -#X text 168 395 - onset. See:; -#X obj 100 560 pddp/pddplink ../3.audio.examples/B06.table.switching.pd --text doc/3.audio.examples/B06.table.switching.pd; -#X obj 100 575 pddp/pddplink ../3.audio.examples/B07.sampler.pd -text -doc/3.audio.examples/B07.sampler.pd; -#X obj 21 194 tabread4~ \$0-array; -#X obj 289 247 table \$0-array2; -#X obj 66 113 bng 15 250 50 0 empty empty empty 17 7 0 10 -4034 -1 --1; -#X obj 66 133 f \$0; -#X msg 66 155 set \$1-array2; -#X obj 170 280 s \$0-array2; -#X msg 170 253 sinesum 256 1; -#X connect 13 0 17 0; -#X connect 14 0 13 0; -#X connect 15 0 41 0; -#X connect 16 0 15 0; -#X connect 24 0 14 0; -#X connect 41 0 13 0; -#X connect 43 0 44 0; -#X connect 44 0 45 0; -#X connect 45 0 41 0; -#X connect 47 0 46 0; diff --git a/doc/pddp/tabreceive~-help.pd b/doc/pddp/tabreceive~-help.pd deleted file mode 100644 index af776a86b..000000000 --- a/doc/pddp/tabreceive~-help.pd +++ /dev/null @@ -1,54 +0,0 @@ -#N canvas 429 35 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 tabreceive~ 3 12 -0 18 -204280 -1 0; -#X obj 0 450 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 483 288 494 344 META 0; -#X text 12 115 LIBRARY internal; -#X text 12 155 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 135 AUTHOR Miller Puckette; -#X text 12 195 HELP_PATCH_AUTHORS Updated for Pd version 0.33. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 45 DESCRIPTION read a block of a signal from an array continuously -; -#X text 12 75 INLET_0; -#X text 12 95 OUTLET_0 signal; -#X text 12 175 RELEASE_DATE 1997; -#X text 12 5 KEYWORDS signal array block_oriented; -#X restore 500 597 pd META; -#X obj 0 487 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 524 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 565 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 214 527 428 109 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 obj 103 43 fft~; -#X obj 23 43 tabsend~; -#X text 8 2 [tabreceive~] Related Objects; -#X restore 102 597 pd Related_objects; -#X obj 78 459 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 496 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 466 10 tabreceive~; -#X text 11 23 read a block of a signal from an array continuously; -#X obj 95 226 tabreceive~; -#X text 90 291 By default a block is 64 samples \; this can be reset -using the block~ object.; -#X text 203 226 - read a block of a signal from an array continuously -; -#X text 168 542 - the name of an array to read from.; -#X text 98 495 signal; -#X text 98 458 unknown; -#X text 80 542 1) symbol atom; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 474 55 pddp/dsp; -#X obj 98 570 pddp/pddplink all_about_arrays.pd; diff --git a/doc/pddp/tabsend~-help.pd b/doc/pddp/tabsend~-help.pd deleted file mode 100644 index 56c9ad5e4..000000000 --- a/doc/pddp/tabsend~-help.pd +++ /dev/null @@ -1,92 +0,0 @@ -#N canvas 429 35 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 tabsend~ 3 12 0 -18 -204280 -1 0; -#X obj 0 464 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 481 287 494 344 META 0; -#X text 12 115 LIBRARY internal; -#X text 12 155 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 135 AUTHOR Miller Puckette; -#X text 12 195 HELP_PATCH_AUTHORS Updated for Pd version 0.33. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 5 KEYWORDS signal array block_oriented; -#X text 12 45 DESCRIPTION write one block of a signal continuously -to an array; -#X text 12 75 DATATYPE_IN signal; -#X text 12 95 DATATYPE_OUT; -#X text 12 175 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 501 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 525 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 566 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 215 522 428 109 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 obj 103 43 fft~; -#X text 8 2 [tabsend~] Related Objects; -#X obj 23 43 tabreceive~; -#X restore 102 597 pd Related_objects; -#X obj 78 473 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 492 9 tabsend~; -#N canvas 0 0 450 300 (subpatch) 0; -#X array \$0-array 64 float 2; -#X coords 0 1 64 -1 100 70 1; -#X restore 291 205 graph; -#X obj 83 169 loadbang; -#X text 98 505 (none); -#X text 98 472 signal; -#N canvas 68 141 428 387 Using_tabsend~_with_block~ 0; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#N canvas 0 0 450 300 (subpatch) 0; -#X array \$0-array2 128 float 0; -#X coords 0 1 127 -1 128 100 1; -#X restore 193 117 graph; -#X msg 24 305 set 128; -#X msg 24 257 set 64; -#X obj 194 117 cnv 15 64 20 empty empty 64_samples 0 10 0 10 -257985 --66577 0; -#X obj 193 197 cnv 15 128 20 empty empty 128_samples 60 10 0 10 -4034 --66577 0; -#X obj 23 117 osc~ 512; -#X text 73 256 default size; -#X text 78 303 double size; -#X obj 24 353 block~; -#X text 8 2 [tabsend~] Using [tabsend~] with [block~]; -#X text 21 230 Try changing the block size:; -#X text 20 38 You can use [block~] to change the blocksize and \, consequently -\, how many samples are send to the specified array by [tabsend~]. -; -#X obj 24 148 tabsend~ \$0-array2; -#X connect 2 0 9 0; -#X connect 3 0 9 0; -#X connect 6 0 13 0; -#X restore 83 368 pd Using_tabsend~_with_block~; -#X text 80 320 By default a block is 64 samples. This can be reset -using the [block~] object \, as in the subpatch below:; -#X obj 83 228 osc~; -#X msg 83 198 512; -#X text 168 472 - the incoming signal to be sent to the table/array. -; -#X text 81 121 The [tabsend~] object writes an audio signal continuously -to an array.; -#X text 11 23 write one block of a signal continuously to an array -; -#X text 168 543 - the name of an array to write to.; -#X text 80 543 1) symbol atom; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 484 54 pddp/dsp; -#X obj 108 570 pddp/pddplink all_about_arrays.pd; -#X obj 83 258 tabsend~ \$0-array; -#X connect 11 0 17 0; -#X connect 16 0 26 0; -#X connect 17 0 16 0; diff --git a/doc/pddp/tabwrite-help.pd b/doc/pddp/tabwrite-help.pd deleted file mode 100644 index 1bbc240cb..000000000 --- a/doc/pddp/tabwrite-help.pd +++ /dev/null @@ -1,132 +0,0 @@ -#N canvas 429 36 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 tabwrite 3 12 0 -18 -204280 -1 0; -#X obj 0 300 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 483 284 494 344 META 0; -#X text 12 105 LIBRARY internal; -#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 125 AUTHOR Miller Puckette; -#X text 12 185 HELP_PATCH_AUTHORS Dave Sabine \, April 29 \, 2003 . -Jonathan Wilkes revised the patch to conform to the PDDP template for -Pd version 0.42.; -#X text 12 5 KEYWORDS control array; -#X text 12 45 DESCRIPTION write numbers to a table; -#X text 12 65 INLET_0 float list; -#X text 12 85 INLET_1 float; -#X text 12 165 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 456 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 481 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 540 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 218 329 428 300 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 [tabwrite] Related Objects; -#X text 20 38 Native Pd Objects; -#X obj 23 63 tabread~; -#X obj 97 63 tabread4; -#X obj 247 63 tabwrite~; -#X obj 23 89 tabsend~; -#X obj 99 89 tabreceive~; -#X obj 199 89 tabplay~; -#X obj 276 89 table; -#X text 22 146 [array]; -#X obj 23 116 soundfiler; -#X text 85 146 and fft objects.; -#X obj 119 116 tabread4~; -#X obj 210 116 getsize; -#X obj 281 116 setsize; -#X obj 172 63 tabread; -#X text 20 170 Externals and other object libraries; -#X obj 20 190 pddp/helplink zexy/tabdump; -#X obj 20 210 pddp/helplink linear_path; -#X text 101 210 <-- which library is this in?; -#X text 101 230 <-- which library is this in?; -#X obj 20 230 pddp/helplink score; -#X text 101 250 <-- which library is this in?; -#X obj 20 250 pddp/helplink tabenv; -#X obj 20 270 pddp/helplink arraysize; -#X restore 102 597 pd Related_objects; -#X obj 78 309 cnv 17 3 115 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 308 float; -#X text 98 348 list; -#X obj 78 435 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 98 434 float; -#X obj 487 10 tabwrite; -#X floatatom 174 251 0 0 99 1 index - -; -#X obj 51 276 tabwrite davids_array; -#X floatatom 51 84 0 0 0 0 value - -; -#X text 168 308 - a float at the left inlet will become the new value -of the chosen index (whichever index is currently selected at the right -inlet).; -#X text 168 348 - the left inlet also accepts pairs of floats (longer -lists will be truncated). A number pair represents "value" and "index" -- corresponding to "left" and "right" inlets.; -#X text 98 388 set; -#N canvas 0 0 450 300 (subpatch) 0; -#X array \$0-davids_array 100 float 1; -#A 0 0 0 0 0 0 0 0 0 0 0 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 -0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 -0 0 0 0 0 0 0 0 0 0 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 -0; -#X coords 0 1 99 -1 100 70 1; -#X restore 278 94 graph; -#N canvas 0 0 450 300 (subpatch) 0; -#X array \$0-another_array 100 float 1; -#A 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 -0 0 0 0 -0.67 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 -0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 -0 0 0; -#X coords 0 1 99 -1 100 70 1; -#X restore 408 94 graph; -#X text 11 23 write numbers to a table; -#X text 167 434 - selects index in which to write the new value.; -#X text 98 460 (none); -#X obj 98 543 pddp/pddplink all_about_arrays.pd -text all_about_arrays -; -#X text 276 181 Click below to view the table:; -#X text 168 498 - the name of the array or table to which [tabwrite] -will write data. The array must exist in an open Pd patch/canvas or -an error message will appear in the console.; -#X text 168 388 - the "set" message \, followed by the name of an array -\, permits you to switch between arrays (e.g. \, "set another_array") -; -#X text 80 498 1) symbol atom; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 90 117 bng 15 250 50 0 empty empty empty 17 7 0 10 -4034 -1 --1; -#X obj 90 137 f \$0; -#X obj 95 186 bng 15 250 50 0 empty empty empty 17 7 0 10 -4034 -1 --1; -#X obj 95 206 f \$0; -#X obj 84 47 bng 15 250 50 0 empty empty empty 17 7 0 10 -4034 -1 -1 -; -#X obj 84 67 f \$0; -#X msg 84 89 set \$1-davids_array; -#X obj 278 202 table \$0-tabwrite_table; -#X msg 90 159 set \$1-another_array; -#X msg 95 228 set \$1-tabwrite_table; -#X obj 96 558 pddp/pddplink ../2.control.examples/15.arrays.pd; -#X obj 95 573 pddp/pddplink ../2.control.examples/16.more.arrays.pd -; -#X connect 14 0 15 1; -#X connect 16 0 15 0; -#X connect 31 0 32 0; -#X connect 32 0 39 0; -#X connect 33 0 34 0; -#X connect 34 0 40 0; -#X connect 35 0 36 0; -#X connect 36 0 37 0; -#X connect 37 0 15 0; -#X connect 39 0 15 0; -#X connect 40 0 15 0; diff --git a/doc/pddp/tabwrite~-help.pd b/doc/pddp/tabwrite~-help.pd deleted file mode 100644 index 751b926f3..000000000 --- a/doc/pddp/tabwrite~-help.pd +++ /dev/null @@ -1,110 +0,0 @@ -#N canvas 429 36 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 tabwrite~ 3 12 0 -18 -204280 -1 0; -#X obj 0 324 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 485 288 494 344 META 0; -#X text 12 85 LIBRARY internal; -#X text 12 125 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 105 AUTHOR Miller Puckette; -#X text 12 165 HELP_PATCH_AUTHORS Updated for Pd version 0.40. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 5 KEYWORDS signal array; -#X text 12 45 DESCRIPTION write a signal in an array; -#X text 12 65 INLET_0 bang signal start stop set; -#X text 12 145 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 475 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 502 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 566 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 214 319 428 313 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 20 38 Native Pd Objects; -#X obj 23 63 tabread~; -#X obj 97 63 tabread4; -#X obj 23 89 tabsend~; -#X obj 99 89 tabreceive~; -#X obj 199 89 tabplay~; -#X obj 276 89 table; -#X text 22 146 [array]; -#X obj 23 116 soundfiler; -#X text 85 146 and fft objects.; -#X obj 119 116 tabread4~; -#X obj 210 116 getsize; -#X obj 281 116 setsize; -#X obj 172 63 tabread; -#X text 8 2 [tabwrite~] Related Objects; -#X obj 247 63 tabwrite; -#X text 20 180 Externals and other object libraries; -#X obj 20 200 pddp/helplink zexy/tabdump; -#X obj 20 220 pddp/helplink linear_path; -#X text 101 220 <-- which library is this in?; -#X text 101 240 <-- which library is this in?; -#X obj 20 240 pddp/helplink score; -#X text 101 260 <-- which library is this in?; -#X obj 20 260 pddp/helplink tabenv; -#X obj 20 280 pddp/helplink arraysize; -#X restore 102 597 pd Related_objects; -#X obj 78 333 cnv 17 3 135 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 484 9 tabwrite~; -#X text 11 23 write a signal in an array; -#X msg 95 194 bang; -#X msg 111 239 stop; -#X obj 78 170 phasor~ 200; -#X text 98 332 bang; -#X text 98 351 start; -#X text 98 390 stop; -#X text 98 410 set; -#X text 98 479 (none); -#N canvas 0 0 450 300 (subpatch) 0; -#X array \$0-array 1000 float 0; -#X coords 0 1 999 -1 160 100 1 0 0; -#X restore 329 183 graph; -#X msg 98 216 start 500; -#X text 168 521 - the name of the array or table to which [tabwrite~] -will write data. The array or table must exist in an open Pd patch/canvas -or an error message will appear in the console.; -#X text 98 451 signal; -#X text 75 55 [tabwrite~] records an audio signal sequentially into -an array. Sending it "bang" writes from beginning to end of the array. -To avoid writing all the way to the end \, you can send a "stop message -at an appropriate later time. The "start" message allows skipping a -number of samples at the nbeginning. (Starting and stopping occur on -block boundaries \, typically multiples of 64 samples \, in the input -signal.); -#X text 80 521 1) symbol atom; -#X text 168 351 - the "start" message will start recording at the specified -element (e.g. \, "start 500" will start recording at the 500th element). -; -#X text 168 332 - start recording.; -#X text 168 390 - stop recording.; -#X text 168 410 - the "set" message \, followed by the name of an array -\, permits you to switch between arrays (e.g. \, "set another_array"). -; -#X text 166 452 - the signal to be written to the array.; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 480 55 pddp/dsp; -#X obj 98 570 pddp/pddplink all_about_arrays.pd; -#X obj 171 219 bng 15 250 50 0 empty empty empty 17 7 0 10 -4034 -1 --1; -#X obj 171 239 f \$0; -#X obj 78 291 tabwrite~ \$0-array; -#X obj 329 293 table \$0-array2; -#X msg 171 261 set \$1-array2; -#X connect 11 0 35 0; -#X connect 12 0 35 0; -#X connect 13 0 35 0; -#X connect 20 0 35 0; -#X connect 33 0 34 0; -#X connect 34 0 37 0; -#X connect 37 0 35 0; diff --git a/doc/pddp/templates/+pager.pd b/doc/pddp/templates/+pager.pd deleted file mode 100644 index 93583d941..000000000 --- a/doc/pddp/templates/+pager.pd +++ /dev/null @@ -1,141 +0,0 @@ -#N canvas 680 22 442 95 10; -#N canvas 48 162 589 578 guts 0; -#X obj 251 124 mapping/tolist; -#X obj 150 289 list; -#X obj 251 175 list-abs/list-len; -#X obj 190 19 loadbang; -#X obj 156 400 makefilename pd-%s; -#X obj 60 10 bng 50 450 50 0 empty empty --> 12 25 1 24 -141952 -1 --1; -#X obj 10 10 bng 50 450 50 0 empty empty <-- 10 25 1 24 -87656 -1 -1 -; -#X text 70 65 next; -#X text 4 65 previous; -#X obj 15 132 trigger bang float; -#X text 94 99 up; -#X obj 150 260 trigger bang float bang bang float; -#X obj 324 286 list; -#X obj 324 393 pack symbol symbol; -#X msg 324 423 \; pd open \$2 \$1; -#X obj 453 393 send \$0-filename; -#X msg 453 372 label \$1; -#X msg 64 98 0; -#X msg 16 97 1; -#X obj 151 236 cyclone/counter; -#X obj 220 300 float 2; -#X obj 220 323 select 0; -#X msg 156 424 \; \$1 menuclose 1; -#X obj 157 356 list-abs/list-idx; -#X obj 324 306 list-abs/list-idx; -#X obj 190 42 trigger bang bang bang; -#X msg 336 497 label \$1; -#X obj 336 517 send \$0-folder_name; -#X msg 18 503 label \$1; -#X obj 18 523 send \$0-current_page; -#X obj 18 457 pack float float; -#X obj 18 483 zexy/makesymbol (%s/%s); -#X obj 63 242 float; -#X obj 324 332 hcs/split_path; -#X obj 157 378 hcs/split_path; -#X obj 271 458 hcs/split_path; -#N canvas 760 129 484 296 generate 0; -#X obj 70 70 ggee/getdir; -#X obj 70 167 hcs/folder_list; -#X obj 68 209 select +pager.pd; -#X obj 70 101 trigger symbol symbol; -#X obj 247 143 makefilename %s/+pager.pd; -#X text 167 209 (filter out this file to prevent endless loops); -#N canvas 121 53 458 308 glob 0; -#X obj 198 6 inlet; -#X obj 167 265 outlet; -#X obj 82 212 makefilename %s/*.pd; -#X obj 213 212 makefilename %s/[0-9]*.pd; -#X obj 25 48 zexy/operating_system; -#X obj 25 72 select windows; -#X obj 25 25 loadbang; -#X obj 106 94 bang; -#X obj 117 160 cyclone/gate 2; -#X msg 25 116 1; -#X msg 106 116 2; -#X text 255 230 glob; -#X text 116 229 windows; -#X connect 0 0 8 1; -#X connect 2 0 1 0; -#X connect 3 0 1 0; -#X connect 4 0 5 0; -#X connect 5 0 9 0; -#X connect 5 1 7 0; -#X connect 6 0 4 0; -#X connect 7 0 10 0; -#X connect 8 0 2 0; -#X connect 8 1 3 0; -#X connect 9 0 8 0; -#X connect 10 0 8 0; -#X restore 70 143 pd glob or windows pattern; -#X obj 161 254 outlet; -#X obj 70 17 inlet; -#X connect 0 0 3 0; -#X connect 1 0 2 0; -#X connect 2 1 7 0; -#X connect 3 0 6 0; -#X connect 3 1 4 0; -#X connect 4 0 2 1; -#X connect 6 0 1 0; -#X connect 8 0 0 0; -#X restore 319 72 pd generate file list; -#X msg 172 139 min 0; -#X obj 18 434 + 1; -#X connect 0 0 1 1; -#X connect 0 0 2 0; -#X connect 0 0 12 1; -#X connect 1 0 23 0; -#X connect 2 0 19 4; -#X connect 2 0 32 0; -#X connect 3 0 25 0; -#X connect 4 0 22 0; -#X connect 5 0 17 0; -#X connect 6 0 18 0; -#X connect 9 0 19 0; -#X connect 9 1 19 1; -#X connect 11 0 1 0; -#X connect 11 1 20 1; -#X connect 11 2 20 0; -#X connect 11 3 12 0; -#X connect 11 4 24 1; -#X connect 12 0 24 0; -#X connect 13 0 14 0; -#X connect 16 0 15 0; -#X connect 17 0 9 0; -#X connect 18 0 9 0; -#X connect 19 0 11 0; -#X connect 19 0 38 0; -#X connect 20 0 21 0; -#X connect 21 1 23 1; -#X connect 23 0 34 0; -#X connect 24 0 33 0; -#X connect 25 0 37 0; -#X connect 25 1 0 1; -#X connect 25 2 36 0; -#X connect 26 0 27 0; -#X connect 28 0 29 0; -#X connect 30 0 31 0; -#X connect 31 0 28 0; -#X connect 32 0 30 1; -#X connect 33 0 13 0; -#X connect 33 0 35 0; -#X connect 33 1 16 0; -#X connect 33 1 13 1; -#X connect 34 1 4 0; -#X connect 35 1 26 0; -#X connect 36 0 0 0; -#X connect 37 0 19 0; -#X connect 38 0 30 0; -#X coords 0 -1 1 1 100 50 1 10 10; -#X restore 6 8 pd guts; -#X obj 167 8 cnv 15 240 25 empty \$0-folder_name intro 5 12 1 14 -262131 --28 0; -#X obj 107 33 cnv 15 300 25 empty \$0-filename 02.basic_elements.pd -5 12 1 14 -262131 -28 0; -#X obj 107 8 cnv 15 60 25 empty \$0-current_page (48/48) 5 12 1 14 --262131 -28 0; -#X coords 0 0 1 1 85 60 0; diff --git a/doc/pddp/templates/example-about.pd b/doc/pddp/templates/example-about.pd deleted file mode 100644 index 498887262..000000000 --- a/doc/pddp/templates/example-about.pd +++ /dev/null @@ -1,144 +0,0 @@ -#N canvas 232 93 772 532 10; -#X text 330 82 The [send] and [receive] objects are useful for linking -objects and subroutines together in a single canvas or throughout multiple -patches. Understanding these objects will help 'clean up' your patches -and allow you to communicate messages between various modules that -you build or between objects where patch cords are not possible.; -#X text 328 167 In the [send] and [receive] help files \, you will -see message sent within a single patch - from a [send] object to a -[receive] object in the same patch. But the functionality of these -objects goes far beyond the scope of a single patch.; -#X obj 20 292 r one_send; -#X obj 23 224 hsl 67 15 0 127 0 0 empty empty empty -2 -6 0 8 -228989 --1 -1 0 0; -#X obj 97 242 s one_send; -#X obj 178 224 hsl 67 15 0 127 0 0 empty empty empty -2 -6 0 8 -228989 --1 -1 0 0; -#X obj 23 313 hsl 67 15 0 127 0 0 empty empty empty -2 -6 0 8 -228989 --1 -1 0 1; -#X obj 97 292 r one_send; -#X obj 178 313 hsl 67 15 0 127 0 0 empty empty empty -2 -6 0 8 -228989 --1 -1 0 1; -#X text 327 300 A [send] object is a little like a radio station...it -broadcasts information throughout Pd \, for all the [receives] to hear! -A [receive] object is a little like your own AM/FM tuner...it will -receive messages from all the [send] objects that it is 'tuned' to. -Hence \, naming your [send] and [receive] objects becomes very important. -A [receive] object named "dave" (as in [receive dave]) will pick up -all messages from [send dave] \, regardless of which patch it is in. -In this manner \, you can get messages across multiple patches \, or -into abstractions or subpatches -- without patch cords.; -#X obj 20 243 s one_send; -#X obj 175 242 send one_send; -#X obj 175 292 receive one_send; -#X msg 38 437 \; one_send \$1; -#X obj 57 414 hsl 67 15 0 127 0 0 empty empty empty -2 -6 0 8 -228989 --1 -1 0 1; -#X msg 151 433 \; aSymbol symbol \$1; -#X msg 151 412 symbol down_below; -#X floatatom 14 414 5 0 0 0 - - -; -#X floatatom 98 314 5 0 0 0 - - -; -#X floatatom 97 224 5 0 0 0 - - -; -#X text 8 381 (look above at previous examples):; -#X text 10 368 You can make message boxes into sends; -#X text 13 272 received by [receive]s of the same name.; -#X text 8 203 Multiple [send]s with the same name; -#X obj 8 6 cnv 15 750 30 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X obj 318 47 cnv 15 440 15 empty empty Getting_Your_Message_Across -3 7 0 13 -261104 -1 0; -#X text 656 18 LINK:Glossary; -#X text 656 6 LINK:Contents; -#X text 12 8 DESCRIPTION: All about communicating without connections -; -#X obj 318 277 cnv 15 440 15 empty empty Broadcasting_With_Sends_And_Receives -3 7 0 13 -261104 -1 0; -#X obj 8 496 cnv 15 750 20 empty empty empty 20 12 0 14 -261104 -66577 -0; -#X text 13 499 PDDP Project 2005; -#X obj 660 499 bng 15 250 50 0 pddpNextPage \$0- < 4 8 0 12 -262144 --1 -1; -#X obj 678 499 bng 15 250 50 0 pddpNextPage \$0- > 4 8 0 12 -262144 --1 -1; -#X text 561 499 Previous/Next; -#N canvas 0 22 466 316 META 0; -#X text 12 5 CATEGORY: about; -#X text 12 15 KEYWORDS: send receive patch cord wireless connection -canvas; -#X restore 160 499 pd META; -#N canvas 696 168 488 368 PAGES 0; -#X text 19 9 Put your pages here: (They must be named [pd PAGE1] [pd -PAGE2]... (PAGE0 is the main patch).; -#X text 9 109 Don't forget to set the number of pages \, including -the main page.; -#N canvas 25 25 775 545 PAGE2 0; -#X obj 8 6 cnv 15 750 30 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X obj 318 47 cnv 15 440 15 empty empty Getting_Your_Message_Across -3 7 0 13 -261104 -1 0; -#X text 656 18 LINK:Glossary; -#X text 656 6 LINK:Contents; -#X text 12 8 DESCRIPTION: All about communicating without connections -; -#X obj 318 277 cnv 15 440 15 empty empty Broadcasting_With_Sends_And_Receives -3 7 0 13 -261104 -1 0; -#X obj 8 496 cnv 15 750 20 empty empty empty 20 12 0 14 -261104 -66577 -0; -#X text 13 499 PDDP Project 2005; -#X obj 660 499 bng 15 250 50 0 pddpNextPage \$0- < 4 8 0 12 -262144 --1 -1; -#X obj 678 499 bng 15 250 50 0 pddpNextPage \$0- > 4 8 0 12 -262144 --1 -1; -#X text 561 499 Previous/Next; -#X obj 701 499 cnv 15 15 15 empty empty 1 0 8 0 12 -261104 -1 0; -#X obj 717 499 cnv 15 15 15 empty empty of 0 8 0 12 -261104 -1 0; -#X obj 733 499 cnv 15 25 15 empty pddpNumPages 3 4 8 0 12 -261104 -1 -0; -#X obj 305 36 cnv 5 5 460 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X text 327 300; -#X text 330 82; -#X text 328 167; -#X restore 14 54 pd PAGE2; -#X text 24 179 BUG: these page-turns need to be local! Add logic for -back button; -#X obj 13 146 pddp_page 2; -#X coords 0 0 1.01598e-05 1.58148e-05 96 15 0; -#X restore 217 499 pd PAGES; -#X obj 701 499 cnv 15 15 15 empty empty 1 0 8 0 12 -261104 -1 0; -#X obj 717 499 cnv 15 15 15 empty empty of 0 8 0 12 -261104 -1 0; -#X obj 733 499 cnv 15 25 15 empty pddpNumPages 2 4 8 0 12 -261104 -1 -0; -#X obj 176 55 cnv 10 86 16 empty empty empty 20 12 0 14 -262126 -66577 -0; -#X floatatom 176 76 5 0 0 0 - - -; -#X obj 176 55 receive aNum; -#X obj 44 155 cnv 10 87 16 empty empty empty 20 12 0 14 -262126 -66577 -0; -#X obj 45 155 send aSymbol; -#X msg 45 107 symbol hello; -#X msg 54 130 symbol world!; -#X obj 179 129 cnv 10 105 16 empty empty empty 20 12 0 14 -262126 -66577 -0; -#X symbolatom 178 157 0 0 0 0 - - -; -#X obj 178 129 receive aSymbol; -#X obj 61 71 cnv 10 65 16 empty empty empty 20 12 0 14 -262126 -66577 -0; -#X floatatom 62 54 5 0 0 0 - - -; -#X obj 62 71 send aNum; -#X obj 305 36 cnv 5 5 460 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X connect 2 0 6 0; -#X connect 3 0 10 0; -#X connect 5 0 11 0; -#X connect 7 0 18 0; -#X connect 12 0 8 0; -#X connect 14 0 13 0; -#X connect 16 0 15 0; -#X connect 17 0 13 0; -#X connect 19 0 4 0; -#X connect 42 0 41 0; -#X connect 45 0 44 0; -#X connect 46 0 44 0; -#X connect 49 0 48 0; -#X connect 51 0 52 0; diff --git a/doc/pddp/templates/example-help.pd b/doc/pddp/templates/example-help.pd deleted file mode 100644 index 2bd9ca003..000000000 --- a/doc/pddp/templates/example-help.pd +++ /dev/null @@ -1,162 +0,0 @@ -#N canvas 51 65 568 623 10; -#X obj 5 574 cnv 15 550 20 empty \$0-pddp.cnv.footer empty 20 12 0 -14 -228856 -66577 0; -#X obj 5 -12 cnv 15 550 40 empty \$0-pddp.cnv.header float 3 12 0 18 --204280 -1 0; -#X obj 4 244 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 15 12 0 13 --228856 -1 0; -#N canvas 407 510 490 340 META 0; -#X text 12 45 LICENSE GPL; -#X text 12 65 TEMPLATE template-help.pd v0.1; -#X text 12 85 PLATFORM windows macosx gnulinux; -#X text 12 105 DATATYPE float list; -#X text 12 125 LIBRARY internal; -#X text 12 165 RELEASE_DATE 2007-08-24; -#X text 12 185 RELEASE_VERSION 0.40-test05; -#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 KEYWORDS control number float storage; -#X restore 505 576 pd META; -#X obj 83 156 cnv 10 50 16 empty empty empty 20 12 0 14 -262126 -66577 -0; -#X obj 346 163 cnv 10 23 16 empty empty empty 20 12 0 14 -262126 -66577 -0; -#X floatatom 384 135 5 0 0 0 - - -, f 5; -#X floatatom 345 187 5 0 0 0 - - -, f 5; -#X obj 364 135 bng 15 250 50 0 empty empty empty 20 7 0 12 -4034 -1 --1; -#X floatatom 85 181 5 0 0 0 - - -, f 5; -#X msg 85 73 bang; -#X msg 325 79 7 3 4; -#X obj 345 162 f; -#X obj 85 156 float 7; -#X obj 4 394 cnv 3 550 3 empty empty outlet 15 12 0 13 -228856 -1 0 -; -#X obj 4 444 cnv 3 550 3 empty empty argument 15 12 0 13 -228856 -1 -0; -#X obj 4 494 cnv 3 550 3 empty empty more_info 15 12 0 13 -228856 -1 -0; -#X obj 73 350 cnv 17 3 40 empty empty 1 5 9 0 16 -228856 -162280 0 -; -#X obj 73 264 cnv 17 3 80 empty empty 0 5 9 0 16 -228856 -162280 0 -; -#X text 103 263 BANG - output the currently stored value; -#X text 103 350 FLOAT - a float received on the right inlet is stored -; -#X obj 465 9 pddp/pddplink http://wiki.puredata.info/en/float -text -pdpedia: float; -#X text 103 283 FLOAT - outputs the incoming number and stores it; -#X text 103 303 LIST - truncates to the first element \, outputs that -element \, and stores it; -#X obj 467 -9 float; -#X obj 527 -9 f; -#X text 506 -8 or; -#X msg 105 126 12; -#X msg 138 126 -0.02; -#X msg 53 102 555; -#X msg 344 102 list one 2 3; -#X text 428 101 does not work!; -#X text 104 412 FLOAT - outputs the stored value as a float message -; -#X obj 105 532 pddp/pddplink http://crca.ucsd.edu/~msp/Pd_documentation/x2.htm#s3.1 --text Pd manual 2.3.1: anatomy of a message; -#N canvas 0 22 458 308 float/list 0; -#X msg 75 133 float 1 2 3; -#X text 34 22 FLOAT CONVERSION; -#X msg 95 187 list 1 2 3; -#X text 92 164 A list with multiple elements remains a list.; -#X text 43 59 A float with one element remains a float.; -#X text 72 106 A float with multiple elements remains a float but is -cut to one element.; -#X text 99 218 A list with one float element is converted to a float. -; -#X obj 58 308 bng 15 250 50 0 empty empty bang 0 20 1 9 -262144 -1 --1; -#X obj 105 308 bng 15 250 50 0 empty empty float 0 21 1 9 -262144 -1 --1; -#X obj 152 308 bng 15 250 50 0 empty empty symbol 0 21 1 9 -262144 --1 -1; -#X obj 200 308 bng 15 250 50 0 empty empty list 0 21 1 9 -262144 -1 --1; -#X obj 248 308 bng 15 250 50 0 empty empty UNDEFINED 0 21 1 9 -262144 --1 -1; -#X obj 57 286 route bang float symbol list; -#X obj 92 349 print FLOAT; -#X msg 50 81 float 3; -#X msg 106 239 list 2; -#X obj 188 349 print LIST; -#X connect 0 0 12 0; -#X connect 2 0 12 0; -#X connect 12 0 7 0; -#X connect 12 1 8 0; -#X connect 12 1 13 0; -#X connect 12 2 9 0; -#X connect 12 3 10 0; -#X connect 12 3 16 0; -#X connect 12 4 11 0; -#X connect 14 0 12 0; -#X connect 15 0 12 0; -#X restore 391 541 pd float/list conversion; -#N canvas 57 22 649 630 More_Info 0; -#X text 43 24 All numbers in Pd are kept in 32-bit floating point and -can represent real numbers between -8 \, 388608 and 8.388.608.00; -#X text 11 78 WHAT IS A FLOATING POINT NUMBER?; -#X text 41 267 The following are examples of floating point numbers: -; -#X text 61 293 3; -#X text 62 334 -111.5; -#X text 61 313 0.5; -#X text 40 387 3e-05 : This example is a computer shorthand for scientific -notation. It means 3*10-5 (or 10 to the negative 5th power multiplied -by 3).; -#X text 41 108 According to Webopedia.com \, "computers are integer -machines and are capable of representing real numbers only by using -complex codes." Hence \, real numbers must be 'approximated' by computers -using the "floating point standard". In such a number \, the decimal -point can "float" meaning that there is no fixed number of digits preceding -or following the decimal. A floating point number is therefore a computer's -approximation of a real number.; -#X text 43 453 Interesting side-note: In the early 1990's \, the Intel -80486 was shipped with a math coprocessor to help accelerate the process -of computing floating point numbers (which previously required a considerable -amount of CPU power.) Math coprocessors have since found there way -into nearly every graphics card and CPU available today.; -#X text 62 358 10000 to 1e-16; -#X restore 390 517 pd More_Info; -#X obj 105 549 pddp/pddplink http://en.wikipedia.org/wiki/Floating_point -; -#X text 120 72 outputs argument; -#X text 91 101 overrides argument; -#X text 103 462 [float] accepts a single number as a creation argument -which sets value that is stored.; -#N canvas 309 454 609 478 guts 0; -#X obj 117 95 textfile; -#X msg 116 24 symbol template-HCS.pd; -#X msg 116 54 read \$1 \, rewind \, bang; -#X obj 117 141 trigger bang anything; -#X obj 58 117 bang; -#X obj 240 162 route #X; -#X obj 240 183 route text; -#X obj 240 250 route DESCRIPTION; -#X obj 239 276 print; -#X obj 140 277 print TEXT; -#X connect 0 0 3 0; -#X connect 1 0 2 0; -#X connect 2 0 0 0; -#X connect 3 0 4 0; -#X connect 3 1 5 0; -#X connect 4 0 0 0; -#X connect 5 0 6 0; -#X connect 7 0 8 0; -#X restore 454 576 pd guts; -#X text 16 8 description: stores a number; -#X text 106 516 all_about_data-types.pd; -#X connect 6 0 12 1; -#X connect 8 0 12 0; -#X connect 10 0 13 0; -#X connect 11 0 12 0; -#X connect 12 0 7 0; -#X connect 13 0 9 0; -#X connect 27 0 13 1; -#X connect 28 0 13 1; -#X connect 29 0 13 0; -#X connect 30 0 12 0; diff --git a/doc/pddp/templates/template-about.pd b/doc/pddp/templates/template-about.pd deleted file mode 100644 index 9b7b81725..000000000 --- a/doc/pddp/templates/template-about.pd +++ /dev/null @@ -1,63 +0,0 @@ -#N canvas 167 112 772 532 10; -#X obj 8 6 cnv 15 750 30 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X obj 318 47 cnv 15 440 15 empty empty Getting_Your_Message_Across -3 7 0 13 -261104 -1 0; -#X text 656 18 LINK:Glossary; -#X text 656 6 LINK:Contents; -#X obj 318 277 cnv 15 440 15 empty empty Broadcasting_With_Sends_And_Receives -3 7 0 13 -261104 -1 0; -#X obj 8 496 cnv 15 750 20 empty empty empty 20 12 0 14 -261104 -66577 -0; -#X text 13 499 PDDP Project 2005; -#X obj 660 499 bng 15 250 50 0 pddpNextPage \$0- < 4 8 0 12 -262144 --1 -1; -#X obj 678 499 bng 15 250 50 0 pddpNextPage \$0- > 4 8 0 12 -262144 --1 -1; -#X text 561 499 Previous/Next; -#N canvas 0 22 470 320 META 0; -#X text 12 5 CATEGORY: about; -#X text 12 15 KEYWORDS:; -#X restore 160 499 pd META; -#N canvas 696 168 488 368 PAGES 0; -#X text 19 9 Put your pages here: (They must be named [pd PAGE1] [pd -PAGE2]... (PAGE0 is the main patch).; -#X text 9 109 Don't forget to set the number of pages \, including -the main page.; -#N canvas 168 111 769 538 PAGE2 0; -#X obj 8 6 cnv 15 750 30 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X obj 318 47 cnv 15 440 15 empty empty Getting_Your_Message_Across -3 7 0 13 -261104 -1 0; -#X text 656 18 LINK:Glossary; -#X text 656 6 LINK:Contents; -#X obj 318 277 cnv 15 440 15 empty empty Broadcasting_With_Sends_And_Receives -3 7 0 13 -261104 -1 0; -#X obj 8 496 cnv 15 750 20 empty empty empty 20 12 0 14 -261104 -66577 -0; -#X text 13 499 PDDP Project 2005; -#X obj 660 499 bng 15 250 50 0 pddpNextPage \$0- < 4 8 0 12 -262144 --1 -1; -#X obj 678 499 bng 15 250 50 0 pddpNextPage \$0- > 4 8 0 12 -262144 --1 -1; -#X text 561 499 Previous/Next; -#X obj 701 499 cnv 15 15 15 empty empty 1 0 8 0 12 -261104 -1 0; -#X obj 717 499 cnv 15 15 15 empty empty of 0 8 0 12 -261104 -1 0; -#X obj 733 499 cnv 15 25 15 empty pddpNumPages 2 4 8 0 12 -261104 -1 -0; -#X obj 305 36 cnv 5 5 460 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X text 12 8 DESCRIPTION:; -#X restore 14 54 pd PAGE2; -#X text 24 179 BUG: these page-turns need to be local! Add logic for -back button; -#X obj 12 143 pddp_page 2; -#X coords 0 0 1.01598e-05 1.58148e-05 96 15 0; -#X restore 217 499 pd PAGES; -#X obj 701 499 cnv 15 15 15 empty empty 1 0 8 0 12 -261104 -1 0; -#X obj 717 499 cnv 15 15 15 empty empty of 0 8 0 12 -261104 -1 0; -#X obj 733 499 cnv 15 25 15 empty pddpNumPages 2 4 8 0 12 -261104 -1 -0; -#X obj 305 36 cnv 5 5 460 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X text 12 8 DESCRIPTION:; diff --git a/doc/pddp/templates/template-help.pd b/doc/pddp/templates/template-help.pd deleted file mode 100644 index e8526d059..000000000 --- a/doc/pddp/templates/template-help.pd +++ /dev/null @@ -1,66 +0,0 @@ -#N canvas 42 47 564 619 10; -#X obj 4 569 cnv 15 550 20 empty \$0-pddp.cnv.footer empty 20 12 0 -14 -228856 -66577 0; -#X obj 4 -17 cnv 15 550 40 empty \$0-pddp.cnv.header myobjectclass -3 12 0 18 -204280 -1 0; -#X obj 3 239 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 15 12 0 13 --228856 -1 0; -#N canvas 779 22 494 344 META 0; -#X text 12 25 KEYWORDS control number float store; -#X text 12 45 LICENSE GPL; -#X text 12 65 TEMPLATE template-help.pd v0.1; -#X text 12 85 PLATFORM windows macosx gnulinux; -#X text 12 105 DATATYPE float list; -#X text 12 125 LIBRARY internal; -#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 165 RELEASE_DATE 2007-08-24; -#X text 12 185 RELEASE_VERSION 0.40-test05; -#X restore 504 571 pd META; -#X obj 3 389 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlet 15 12 0 -13 -228856 -1 0; -#X obj 3 439 cnv 3 550 3 empty \$0-pddp.cnv.argument argument 15 12 -0 13 -228856 -1 0; -#X obj 3 489 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 15 -12 0 13 -228856 -1 0; -#X obj 72 345 cnv 17 3 40 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X obj 72 259 cnv 17 3 80 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 102 457 [float] accepts a single number as a creation argument -which sets value that is stored.; -#N canvas 309 454 609 478 guts 0; -#X obj 117 95 textfile; -#X msg 116 24 symbol template-HCS.pd; -#X msg 116 54 read \$1 \, rewind \, bang; -#X obj 117 141 trigger bang anything; -#X obj 58 117 bang; -#X obj 240 162 route #X; -#X obj 240 183 route text; -#X obj 240 250 route DESCRIPTION; -#X obj 239 276 print; -#X obj 140 277 print TEXT; -#X connect 0 0 3 0; -#X connect 1 0 2 0; -#X connect 2 0 0 0; -#X connect 3 0 4 0; -#X connect 3 1 5 0; -#X connect 4 0 0 0; -#X connect 5 0 6 0; -#X connect 7 0 8 0; -#X restore 453 571 pd guts; -#X obj 470 -14 myobjectclass; -#X obj 419 6 pddp/pddplink http://wiki.puredata.info/en/myobjectclass --text pdpedia: myobjectclass; -#X text 203 118 (put working examples here); -#X text 15 6 description: short desription of what this objectclass -does; -#X text 102 258 BANG - bang means do it!; -#X text 102 278 FLOAT - what does a number do?; -#X text 102 298 LIST - what does a list do?; -#X text 102 345 FLOAT - how about a float on the cold inlet?; -#X text 102 318 POINTER - does this object handle pointers; -#X text 103 407 FLOAT - what kind of output comes out of here?; -#X text 58 524 (put links to other help patches \, about patches \, -links to the HTML manual \, and/or external links); -#X text 146 363 (if you want longer lines \, you can use [cyclone/comment]) -; diff --git a/doc/pddp/templates/template-help_elements.pd b/doc/pddp/templates/template-help_elements.pd deleted file mode 100644 index b78be401d..000000000 --- a/doc/pddp/templates/template-help_elements.pd +++ /dev/null @@ -1,60 +0,0 @@ -#N canvas 299 251 572 554 10; -#X obj 4 202 cnv 3 550 3 empty empty inlets 15 12 0 13 -228856 -1 0 -; -#X obj 4 234 cnv 3 550 3 empty empty outlet 15 12 0 13 -228856 -1 0 -; -#X obj 4 294 cnv 3 550 3 empty empty argument 15 12 0 13 -228856 -1 -0; -#X obj 4 354 cnv 3 550 3 empty empty more_info 15 12 0 13 -228856 -1 -0; -#X obj 420 384 cnv 17 3 40 empty empty 1 5 9 0 16 -228856 -162280 0 -; -#X obj 369 384 cnv 17 3 80 empty empty 0 5 9 0 16 -228856 -162280 0 -; -#X obj 447 384 cnv 17 3 25 empty empty 2 5 9 0 16 -228856 -162280 0 -; -#X text 101 10 This is a collection of graphic elements for the PDDP -template-help.pd. These are meant to be copied-n-pasted into new help -patches.; -#X obj 4 174 cnv 3 550 3 empty empty inlet 15 12 0 13 -228856 -1 0 -; -#X obj 4 264 cnv 3 550 3 empty empty outlets 15 12 0 13 -228856 -1 -0; -#X obj 396 384 cnv 17 3 60 empty empty 0 5 9 0 16 -228856 -162280 0 -; -#X obj 339 384 cnv 17 3 100 empty empty 0 5 9 0 16 -228856 -162280 -0; -#X obj 4 324 cnv 3 550 3 empty empty arguments 15 12 0 13 -228856 -1 -0; -#X obj 140 88 cnv 10 23 16 empty empty empty 20 12 0 14 -262126 -66577 -0; -#X obj 140 114 cnv 10 27 16 empty empty empty 20 12 0 14 -262126 -66577 -0; -#X text 22 66 highlights by character width:; -#X text 57 88 1-3 chars; -#X text 67 114 4 chars; -#X obj 140 139 cnv 10 34 16 empty empty empty 20 12 0 14 -262126 -66577 -0; -#X obj 280 89 cnv 10 38 16 empty empty empty 20 12 0 14 -262126 -66577 -0; -#X obj 280 114 cnv 10 46 16 empty empty empty 20 12 0 14 -262126 -66577 -0; -#X obj 280 139 cnv 10 52 16 empty empty empty 20 12 0 14 -262126 -66577 -0; -#X obj 430 88 cnv 10 57 16 empty empty empty 20 12 0 14 -262126 -66577 -0; -#X obj 430 114 cnv 10 63 16 empty empty empty 20 12 0 14 -262126 -66577 -0; -#X obj 430 139 cnv 10 69 16 empty empty empty 20 12 0 14 -262126 -66577 -0; -#X text 67 139 5 chars; -#X text 207 88 6 chars; -#X text 207 114 7 chars; -#X text 207 139 8 chars; -#X text 358 87 9 chars; -#X text 357 115 10 chars; -#X text 357 139 11 chars; -#X obj 309 384 cnv 17 3 120 empty empty 0 5 9 0 16 -228856 -162280 -0; -#X obj 279 384 cnv 17 3 140 empty empty 0 5 9 0 16 -228856 -162280 -0; diff --git a/doc/pddp/text-help.pd b/doc/pddp/text-help.pd deleted file mode 100644 index e4d941c5d..000000000 --- a/doc/pddp/text-help.pd +++ /dev/null @@ -1,73 +0,0 @@ -#N canvas 430 35 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 text 3 12 0 18 -204280 --1 0; -#X obj 0 458 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 489 286 494 344 META 0; -#X text 12 65 LIBRARY internal; -#X text 12 105 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 85 AUTHOR Miller Puckette; -#X text 12 145 HELP_PATCH_AUTHORS Updated for Pd version 0.26. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 5 KEYWORDS control; -#X text 12 125 RELEASE_DATE 1997; -#X text 12 45 DESCRIPTION box with text for an object or comment; -#X restore 500 597 pd META; -#X obj 0 486 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 514 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 542 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#X text 98 518 (none); -#N canvas 217 509 428 119 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 comment Related Objects; -#X obj 21 28 pddp/pddplink all_about_externals.pd -text _________; -#X obj 21 28 pddp/pddplink all_about_externals.pd -text Externals; -#X obj 21 48 pddp/helplink cyclone/comment; -#X obj 21 68 pddp/helplink pddp/pddplink; -#X obj 21 88 pddp/helplink pddp/helplink; -#X restore 102 597 pd Related_objects; -#X text 104 387 Phone number with hyphens: 555-555-5555; -#X text 104 407 Same phone number without hyphens: 5.55556e+09; -#X text 98 462 (none); -#X text 98 491 (none); -#N canvas 100 383 428 181 Some_Comments_On_Comments 0; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 20 29 semicolons in comments cause the text \; following them -to \; start \; on a \; new \; line; -#X text 19 110 Try adding a period at the end of this sentence \, which -ends with the number 1; -#X text 19 140 If you close this subwindow \, then open it again \, -the period you added will be gone.; -#X text 8 2 comment Commentary: Additional Comments About Comments -; -#X restore 102 551 pd Some_Comments_On_Comments; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 99 571 pddp/pddplink all_about_ascii_art.pd; -#X text 378 11 To create \, click <Control-5>; -#X text 11 23 box with text for an object or comment; -#X text 85 144 Comments don't actually "do" anything \, but you can -use them to annotate your patch \, explain how something works \, add -a copyright notice \, or anything else.; -#X text 85 74 All text in Pure Data is just a series of symbol and/or -float atoms. You create Pd objects by typing text into an object box -\, but you can also write text as a comment for your patch (like this -one).; -#X text 85 224 To create a comment \, use the "Put" menu or click <Control-5>. -; -#X text 55 267 ***; -#X text 85 347 Otherwise your phone number will interpreted as a float -atom and you will lose some rather important precision!; -#X text 85 267 Remember: text inside a comment is just a series of -atoms \, and will be formatted accordingly. For example: if you want -to jot down a large value like a phone number in pd \, use hyphens -or multiple dots so that pd will interpret it as a symbol atom.; diff --git a/doc/pddp/textfile-help.pd b/doc/pddp/textfile-help.pd deleted file mode 100644 index 50c4603e4..000000000 --- a/doc/pddp/textfile-help.pd +++ /dev/null @@ -1,111 +0,0 @@ -#N canvas 431 34 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 textfile 3 12 0 -18 -204280 -1 0; -#X obj 0 429 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 487 285 494 344 META 0; -#X text 12 125 LIBRARY internal; -#X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 145 AUTHOR Miller Puckette; -#X text 12 205 HELP_PATCH_AUTHORS Updated for Pd version 0.33. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 45 DESCRIPTION read and write text files; -#X text 12 65 INLET_0 bang rewind clear add add2 set read write print -; -#X text 12 85 OUTLET_0 list; -#X text 12 105 OUTLET_1 bang; -#X text 12 5 KEYWORDS control storage filesystem list_op anything_op -; -#X text 12 185 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 465 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 531 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 558 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#X text 98 535 (none); -#N canvas 216 519 428 109 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 [textfile] Related Objects; -#X obj 22 43 qlist; -#X restore 102 597 pd Related_objects; -#X obj 78 438 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 474 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 498 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 11 23 read and write text files; -#X obj 485 11 textfile; -#X obj 85 347 print done; -#X text 98 497 bang; -#X text 167 497 - this outlet gets a bang when you hit the end of the -sequence.; -#X text 98 473 list; -#X text 168 473 - this outlet gets the lines in sequence.; -#X text 168 437 (see the example above for messages accepted by [textfile]) -; -#X msg 101 76 rewind; -#X text 214 207 read a file; -#X msg 101 208 read textfile.txt; -#X text 152 75 go to beginning; -#X msg 101 98 bang; -#X text 152 97 output one line as a list; -#X msg 101 230 write /tmp/textfile.txt; -#X msg 101 252 write /tmp/textfile2.txt cr; -#X msg 101 274 read textfile.txt cr; -#X msg 101 120 clear; -#X text 152 119 empty the object; -#X text 208 142 add a message; -#X msg 101 186 set 2 4 6 8; -#X text 208 186 clear and then add one message; -#X msg 101 142 add cis boom bah; -#X msg 101 164 add2 bang; -#X text 208 164 add an unterminated message; -#X msg 101 296 print; -#X text 145 296 debugging printout; -#X text 248 229 write a file; -#X obj 40 322 textfile; -#X text 272 251 write a file \, terminating lines with a; -#X text 273 266 carriage return (omitting semicolons).; -#X text 272 281 You can read files this way \, too \, in; -#X text 273 296 which case carriage returns are mapped; -#N canvas 94 361 428 199 About_textfile 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 [textfile] Related Objects; -#X text 21 38 The textfile object reads and writes text files to and -from memory. You can read a file and output sequential lines as messages -\, or collect lines and write them out. You can use this object to -generate "models" for Gem \, for instance.; -#X text 20 91 To record textual messages and save them to a file \, -first send "clear" to empty the sequence and "add" to add messages -(terminated with semicolons.) The message \, "add2" adds a list of -atoms without finishing with a semicolon in case you want to make variable-length -messages.; -#X text 20 155 You can also use this object simply for storing heterogeneous -sequences of messages.; -#X restore 101 567 pd About_textfile; -#X obj 40 369 print message; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X text 274 311 to semicolons.; -#X connect 20 0 40 0; -#X connect 22 0 40 0; -#X connect 24 0 40 0; -#X connect 26 0 40 0; -#X connect 27 0 40 0; -#X connect 28 0 40 0; -#X connect 29 0 40 0; -#X connect 32 0 40 0; -#X connect 34 0 40 0; -#X connect 35 0 40 0; -#X connect 37 0 40 0; -#X connect 40 0 46 0; -#X connect 40 1 14 0; diff --git a/doc/pddp/threshold~-help.pd b/doc/pddp/threshold~-help.pd deleted file mode 100644 index 66566966f..000000000 --- a/doc/pddp/threshold~-help.pd +++ /dev/null @@ -1,93 +0,0 @@ -#N canvas 430 33 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 threshold~ 3 12 -0 18 -204280 -1 0; -#X obj 0 295 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 486 261 494 365 META 0; -#X text 12 145 LIBRARY internal; -#X text 12 185 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 165 AUTHOR Miller Puckette; -#X text 12 225 HELP_PATCH_AUTHORS Updated for Pd version 0.32. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 5 KEYWORDS signal; -#X text 12 45 DESCRIPTION trigger from audio signal; -#X text 12 65 INLET_0 set signal; -#X text 12 85 INLET_1 float; -#X text 12 105 OUTLET_0 bang; -#X text 12 125 OUTLET_1 bang; -#X text 12 205 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 396 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 468 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 569 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 217 520 428 109 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 [threshold~] Related Objects; -#X obj 22 43 env~; -#X restore 102 597 pd Related_objects; -#X obj 78 304 cnv 17 3 40 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 405 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 352 cnv 17 3 35 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 98 351 float; -#X obj 478 10 threshold~; -#X text 11 23 trigger from audio signal; -#X obj 140 168 sig~; -#X obj 140 226 threshold~ 10 100 0 100; -#X floatatom 140 141 5 0 0 0 - - -, f 5; -#X obj 140 254 print trigger; -#X obj 275 254 print rest; -#X msg 296 196 1; -#X msg 327 196 0; -#X msg 222 146 set 0 2000 1 2000; -#X msg 222 169 set 10 100 0 100; -#X text 98 303 signal; -#X text 98 324 set; -#X text 167 351 - a zero to the right inlet sets the object's state -to "high." A nonzero value sets it to "low." There is no debounce period -after this.; -#X text 98 404 bang; -#X obj 78 435 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 98 434 bang; -#X text 168 404 - a bang is sent to the left outlet when the incoming -signal is greater than or equal to the "trigger" value.; -#X text 168 434 - a bang is sent to the right outlet when the incoming -signal is less than or equal to the "rest" value.; -#X text 168 324 - the "set" message can be used to change the parameters -(i.e. \, the values set by the creation arguments).; -#X text 168 303 - the incoming signal.; -#X text 80 486 1) float; -#X text 79 506 2) float; -#X text 168 486 - (optional) trigger threshold.; -#X text 167 526 - (optional) rest threshold.; -#X text 167 506 - (optional) trigger debounce time (ms).; -#X text 167 546 - (optional) rest debounce time (ms).; -#X text 88 56 [threshold~] monitors its input signal and outputs bangs -when the signal equals or exceeds a specified "trigger" value \, and -also when the signal equals or recedes below a "rest" value. You can -specify debounce times in milliseconds \, for the [threshold~] to wait -after the two event types before triggering again.; -#X text 79 526 3) float; -#X text 79 546 4) float; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 481 57 pddp/dsp; -#X connect 14 0 15 0; -#X connect 15 0 17 0; -#X connect 15 1 18 0; -#X connect 16 0 14 0; -#X connect 19 0 15 1; -#X connect 20 0 15 1; -#X connect 21 0 15 0; -#X connect 22 0 15 0; diff --git a/doc/pddp/throw~-help.pd b/doc/pddp/throw~-help.pd deleted file mode 100644 index 825fd7054..000000000 --- a/doc/pddp/throw~-help.pd +++ /dev/null @@ -1,87 +0,0 @@ -#N canvas 431 35 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 throw~ 3 12 0 18 --204280 -1 0; -#X obj 0 387 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 487 287 494 344 META 0; -#X text 12 85 LIBRARY internal; -#X text 12 125 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 105 AUTHOR Miller Puckette; -#X text 12 165 HELP_PATCH_AUTHORS Updated for Pd version 0.33. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 5 KEYWORDS signal nonlocal; -#X text 12 45 DESCRIPTION summing signal bus and nonlocal connection -; -#X text 12 65 INLET_0 signal; -#X text 12 145 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 477 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 504 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 566 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 216 524 428 109 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 [throw~] Related Objects; -#X obj 22 43 catch~; -#X obj 72 43 send~; -#X obj 119 43 receive~; -#X obj 181 43 inlet~; -#X obj 231 43 outlet~; -#X restore 102 597 pd Related_objects; -#X obj 78 396 cnv 17 3 70 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 451 list; -#X obj 501 9 throw~; -#X obj 73 220 throw~ signal1; -#X floatatom 224 268 0 0 0 0 - - -; -#X obj 73 243 sig~ 50; -#X obj 224 243 snapshot~; -#X obj 73 268 throw~ signal1; -#X obj 73 149 sig~ 25; -#X obj 224 168 catch~ signal1; -#X obj 267 193 loadbang; -#X obj 267 218 metro 200; -#X floatatom 358 268 0 0 0 0 - - -; -#X obj 358 243 snapshot~; -#X obj 358 168 catch~ signal2; -#X msg 89 172 set signal2; -#X msg 90 196 set signal1; -#X text 98 395 signal; -#X text 168 451 - a list will be truncated to the first item.; -#X text 98 423 float; -#X text 98 481 (none); -#X text 168 395 - an incoming signal will be sent to a [catch~] object -that shares the same name as this [throw~] object.; -#X text 11 23 summing signal bus and non-local connection; -#X text 168 423 - a float may be sent if there are no signal connections -made to the inlet of [throw~].; -#X text 67 99 Any number of [throw~] objects can add into one [catch~] -object (but two [catch~] objects cannot share the same name.); -#X text 71 295 You can redirect [throw~] via a "set" message.; -#X text 79 521 1) symbol atom; -#X text 168 521 - [throw~] takes one argument-- a symbol atom-- as -its name. Other [throw~] objects may have the same name \, but there -may only be one [catch~] that shares this name.; -#X text 151 47 For help on [catch~] \, see:; -#X obj 151 62 pddp/pddplink catch~-help.pd -text catch~-help; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 482 57 pddp/dsp; -#X connect 13 0 15 0; -#X connect 14 0 12 0; -#X connect 16 0 11 0; -#X connect 17 0 14 0; -#X connect 18 0 19 0; -#X connect 19 0 14 0; -#X connect 19 0 21 0; -#X connect 21 0 20 0; -#X connect 22 0 21 0; -#X connect 23 0 11 0; -#X connect 24 0 11 0; diff --git a/doc/pddp/timer-help.pd b/doc/pddp/timer-help.pd deleted file mode 100644 index 9d2a392d1..000000000 --- a/doc/pddp/timer-help.pd +++ /dev/null @@ -1,169 +0,0 @@ -#N canvas 209 25 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 timer 3 12 0 18 --204280 -1 0; -#X obj 0 354 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 484 259 494 368 META 0; -#X text 12 125 LIBRARY internal; -#X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 145 AUTHOR Miller Puckette; -#X text 12 205 HELP_PATCH_AUTHORS This help patch was updated for Pd -version 0.35 test 28 by Dave Sabine as part of a project called pddp -proposed by Krzysztof Czaja to build comprehensive documentation for -Pd. Jonathan Wilkes revised the patch to conform to the PDDP template -for Pd version 0.42.; -#X text 12 5 KEYWORDS control time; -#X text 12 45 DESCRIPTION measure logical time; -#X text 12 65 INLET_0 bang; -#X text 12 85 INLET_1 bang; -#X text 12 105 OUTLET_0 float; -#X text 12 185 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 470 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 512 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 539 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#X text 98 516 (none); -#N canvas 220 379 428 246 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 [timer] Related Objects; -#X obj 135 35 metro; -#X obj 72 35 realtime; -#X obj 24 35 timer; -#X obj 183 35 delay; -#X text 22 162 The best places to find information about Pd's libraries -is:; -#X text 22 182 www.puredata.org and click on "Downloads" then "Software" -; -#X text 24 197 or; -#X text 21 212 iem.kug.ac.at/pdb/; -#X text 22 120 This object is only offered in Pd only if you have downloaded -and properly installed the appropriate library. These objects may or -may not exist in a single library.; -#X text 22 70 Externals; -#X obj 24 95 pddp/helplink iemlib/t3_timer; -#X restore 102 597 pd Related_objects; -#X obj 78 363 cnv 17 3 60 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 478 float; -#X obj 78 479 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 434 cnv 17 3 25 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 168 478 - upon sending the "flush" message to the left inlet -\, [bag] will output each value in the order it was received.; -#X obj 503 9 timer; -#X msg 64 220 bang; -#X msg 39 108 bang; -#X obj 39 242 timer; -#X floatatom 39 264 0 0 0 0 - - -; -#X text 74 108 Click here to start or reset; -#X text 34 61 The [timer] object measures elapsed logical time. Logical -time moves forward as if all computation were instantaneous and as -if all [delay] and [metro] objects were exact.; -#X text 102 221 Click here to get elapsed logical time. Click again...and -again...to see periodic measurements from the start or reset time. -; -#X text 37 290 NOTE: Unlike most other objects in Pd \, the right inlet -of [timer] is the hot one (i.e. \, a bang to it triggers the output). -; -#X text 98 362 bang; -#X text 168 362 - an initial "bang" to the left inlet starts the timer. -Subsequent "bangs" reset the timer.; -#X text 98 433 bang; -#X text 167 433 - a bang to the right inlet causes the elapsed time -to be output (in milliseconds).; -#N canvas 94 193 428 419 Time_Objects 0; -#X text 21 38 In a fantasy world \, computers could exist somehow beyond -the restrictions of time and digital computation could be performed -in ZERO time. However \, that is not the case. Instead \, every process -within Pd and within your operating system requires at least a few -nanoseconds of your CPU's time.; -#X text 22 123 The [timer] object is like a clock that is not constrained -to the regular laws of physics and the universal space-time continuum. -It reports "time" measurements as only Pd can see them!; -#X text 23 182 The [cputime] object is like a clock that measures how -much time your CPU actually required to carry out your request. Keep -in mind however that your CPU is busy doing many things simoultaneously -\, so even though a process might take 5 minutes to complete \, your -CPU does not pay full attention to that process for the entire 5 minutes. -Instead \, it simply begins the process \, then refers back to that -process from time to time until the it is complete. In other cases -\, your CPU might require a full 5 minutes while Pd might report that -merely a few milliseconds have passed. This type of discrepancy depends -heavily on your computer's hardware and the type of processing it is -performing.; -#X text 24 341 The [realtime] object is as much like your own wrist -watch as Pd can possibly manage. It measures time according to your -operating system's internal clock.; -#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 [cputime] Why the Discrepencies Between Clocks?; -#X restore 102 548 pd Time_Objects; -#N canvas 73 72 428 495 Time_Measurements 0; -#X text 21 38 [timer] works like essentially like a stop-watch. Once -it starts \, you can continue to "poll" the [timer] to view the elapsed -time.; -#X text 20 135 As stated above \, [timer] measures "logical" time. -This value may be slightly different that CPU time or "real" time. -PD offers two objects which measure CPU time and "real" time. See the -reference documents for those objects for more information.; -#X obj 25 304 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X floatatom 25 448 0 0 0 0 - - -; -#X floatatom 110 448 0 0 0 0 - - -; -#X floatatom 172 448 0 0 0 0 - - -; -#X text 21 211 In the example below \, I've created an abstraction -which will force each of Pd's stop-watches \, [timer] [cputime] and -[realtime] to measure various processes and report the elapsed time. -Click on each [bng] to begin the process and wait for the results. -Notice the discrepancies in the results.; -#X text 23 464 Logical Time; -#X text 170 464 Real Time; -#X text 109 464 CPU Time; -#X obj 40 340 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X text 45 298 1 Measures elapsed time between two "bangs" from a [trigger] -object.; -#X text 60 332 2 Measures the amount of time Pd requires to turn on -DSP and start an oscillator.; -#X obj 84 372 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X text 21 85 The odd aspect about comparing [timer] to a stop-watch -is that a stop-watch can be stopped! [timer] can only be started or -reset. It cannot be stopped.; -#X text 105 364 3 Measures the amount of time Pd requires count to -three...please wait for approximately 3 seconds.; -#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 [timer] Related Objects; -#X obj 25 408 time_measurements; -#X connect 2 0 18 0; -#X connect 10 0 18 1; -#X connect 13 0 18 2; -#X connect 18 0 3 0; -#X connect 18 1 4 0; -#X connect 18 2 5 0; -#X restore 102 572 pd Time_Measurements; -#X text 11 23 measure logical time; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X msg 59 145 tempo 1 sec; -#X msg 67 169 tempo 2 msec; -#X text 111 266 Output defaults to milliseconds; -#X text 98 392 tempo; -#X text 152 145 set tempo in units of seconds; -#X text 152 169 set tempo in units of milliseconds; -#X text 168 392 - set tempo to some number of units (msec for short) -\, seconds (sec) \, minutes (min) or samples (samp).; -#X connect 15 0 17 1; -#X connect 16 0 17 0; -#X connect 17 0 18 0; -#X connect 31 0 17 0; -#X connect 32 0 17 0; diff --git a/doc/pddp/toggle-help.pd b/doc/pddp/toggle-help.pd deleted file mode 100644 index e365e6429..000000000 --- a/doc/pddp/toggle-help.pd +++ /dev/null @@ -1,395 +0,0 @@ -#N canvas 427 35 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 toggle 3 12 0 18 --204280 -1 0; -#X obj 0 308 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 483 286 494 344 META 0; -#X text 12 145 LIBRARY internal; -#X text 12 45 LICENSE SIBSD; -#X text 12 165 AUTHOR Thomas Musil; -#X text 12 185 WEBSITE; -#X text 12 225 HELP_PATCH_AUTHORS Jonathan Wilkes revised the patch -to conform to the PDDP template for Pd version 0.42.; -#X text 12 25 KEYWORDS control GUI nonlocal; -#X text 12 65 DESCRIPTION gui-toggle between zero and a non-zero value -; -#X text 12 5 ALIAS tgl; -#X text 12 85 INLET_0 float bang size nonzero init send receive label -label_pos label_font color pos delta; -#X text 12 125 OUTLET_0 float; -#X text 12 205 RELEASE_DATE 2002; -#X restore 500 597 pd META; -#X obj 0 422 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 459 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 544 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#X obj 78 317 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#N canvas 207 527 428 100 Related_objects 0; -#X obj 20 53 x_all_guis bng tgl vsl hsl hradio vradio vu cnv nbx; -#X text 18 29 All iem-gui objects:; -#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 [tgl] Related Objects; -#X restore 100 597 pd Related_objects; -#X obj 78 431 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 346 167 and receive names. Right-; -#X text 346 182 click and choose; -#X text 345 198 "Properties" to set them \,; -#X text 120 255 Use the UP- \, DOWN- \, LEFT- or RIGHT-key to move -a selected gui-object. Right-click and choose "Properties" to modify -its appearance.; -#X text 346 212 or change them with messages; -#X text 346 226 (see the subpatch below); -#X text 98 361 see the following subpatch for messages that change -the gui-properties of [bng]:; -#N canvas 60 6 428 618 Changing_GUI_Properties 0; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 212 37 no init; -#X text 162 166 label; -#X msg 212 56 init 0; -#X msg 232 109 init 1; -#X msg 162 186 label blabla; -#X msg 172 236 label myToggle; -#X text 303 37 change send name; -#X text 22 166 change receive name; -#X obj 212 133 s tgl_rcv; -#X obj 304 133 s tgl_rcv; -#X obj 22 262 s tgl_rcv; -#X obj 162 262 s tgl_rcv; -#X msg 304 58 send foo6_snd; -#X msg 314 108 send tgl_snd; -#X msg 42 213 receive tgl_rcv; -#X obj 42 237 s tgl2_rcv; -#X msg 22 188 receive tgl2_rcv; -#N canvas 317 326 161 227 init 0; -#X obj 16 11 loadbang; -#X obj 16 42 f \$0; -#X msg 16 73 \; \$1-size 15 \; \$1-nonzero 1 \; \$1-lbl-x 17 \; \$1-lbl-y -7 \; \$1-font-size 10 \; \$1-xpos 336 \; \$1-ypos 500; -#X connect 0 0 1 0; -#X connect 1 0 2 0; -#X restore 311 580 pd init; -#X msg 22 109 size \$1; -#X text 21 37 dimensions; -#X obj 22 58 nbx 3 14 8 200 0 0 empty \$0-size empty 0 -8 0 12 -262144 --1 -1 15 256 0; -#X text 69 55 size; -#X obj 22 133 s tgl_rcv; -#X obj 112 58 nbx 3 14 -1e+37 1e+37 0 0 empty \$0-nonzero empty 0 -8 -0 12 -262144 -1 -1 1 256 0; -#X obj 112 133 s tgl_rcv; -#X text 111 37 nonzero-value; -#X msg 112 109 nonzero \$1; -#X text 224 75 init value; -#X text 226 89 on loadbang; -#X text 306 165 label position; -#X text 20 302 font properties; -#X msg 308 237 label_pos \$1 \$2; -#X msg 22 374 label_font \$1 \$2; -#X text 71 326 1.font(0-2); -#X text 71 347 2.height; -#X text 357 188 1.x-offset; -#X text 357 209 2.y-offset; -#N canvas 366 206 174 259 flash-time 0; -#X obj 68 180 pack; -#X obj 103 149 t b a; -#X obj 68 205 outlet; -#X obj 103 104 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-lbl-x empty -0 -8 0 12 -262144 -1 -1 17 256 0; -#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-lbl-y empty -0 -8 0 12 -262144 -1 -1 7 256 0; -#X connect 0 0 2 0; -#X connect 1 0 0 0; -#X connect 1 1 0 1; -#X connect 3 0 0 0; -#X connect 4 0 1 0; -#X coords 0 -1 1 1 48 42 2 100 100; -#X restore 308 187 pd flash-time; -#N canvas 366 206 174 259 flash-time 0; -#X obj 68 180 pack; -#X obj 103 149 t b a; -#X obj 68 205 outlet; -#X obj 103 104 nbx 3 14 0 2 0 0 \$0-dummy \$0-font empty 0 -8 0 12 --262144 -1 -1 0 256 0; -#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-font-size empty -0 -8 0 12 -262144 -1 -1 10 256 0; -#X connect 0 0 2 0; -#X connect 1 0 0 0; -#X connect 1 1 0 1; -#X connect 3 0 0 0; -#X connect 4 0 1 0; -#X coords 0 -1 1 1 48 42 2 100 100; -#X restore 22 324 pd flash-time; -#X text 162 302 preset-colors; -#X text 301 302 RGB-colors; -#X msg 162 409 color \$1 \$2 \$3; -#N canvas 364 205 306 317 flash-time 0; -#X obj 69 196 t b a; -#X obj 33 262 outlet; -#X obj 33 237 pack 0 0 0; -#X obj 120 197 t b a; -#X obj 103 104 nbx 3 14 0 29 0 0 \$0-dummy \$0-bg empty 0 -8 0 12 -262144 --1 -1 0 256 0; -#X obj 103 124 nbx 3 14 0 29 0 0 \$0-dummy \$0-front empty 0 -8 0 12 --262144 -1 -1 0 256 0; -#X obj 103 144 nbx 3 14 0 29 0 0 \$0-dummy \$0-label empty 0 -8 0 12 --262144 -1 -1 0 256 0; -#X connect 0 0 2 0; -#X connect 0 1 2 1; -#X connect 2 0 1 0; -#X connect 3 0 2 0; -#X connect 3 1 2 2; -#X connect 4 0 2 0; -#X connect 5 0 0 0; -#X connect 6 0 3 0; -#X coords 0 -1 1 1 48 62 2 100 100; -#X restore 162 324 pd flash-time; -#N canvas 0 0 306 317 flash-time 0; -#X obj 96 521 outlet; -#X obj 162 230 t b f; -#X obj 96 268 +; -#X obj 96 293 t b f; -#X obj 96 324 +; -#X obj 19 208 * -65536; -#X obj 96 208 * -256; -#X obj 162 208 * -1; -#X obj 96 355 - 1; -#X obj 96 385 list prepend 0; -#X obj 96 410 route 0 1 2; -#X obj 96 497 pack 0 0 0; -#X obj 115 456 t b a; -#X obj 168 455 t b a; -#X obj 104 124 vradio 15 1 0 3 empty empty empty 0 -8 0 10 -262144 --1 -1 0; -#X text 120 120 1.bg; -#X text 120 137 2.front; -#X text 120 153 3.label; -#X obj 103 105 nbx 3 14 0 255 0 0 \$0-dummy \$0-r empty 0 -8 0 10 -262144 --258113 -1 0 256 0; -#X obj 133 105 nbx 3 14 0 255 0 0 \$0-dummy \$0-g empty 0 -8 0 10 -262144 --13381 -1 0 256 0; -#X obj 163 105 nbx 3 14 0 255 0 0 \$0-dummy \$0-b empty 0 -8 0 10 -262144 --4160 -1 0 256 0; -#X connect 1 0 2 0; -#X connect 1 1 2 1; -#X connect 2 0 3 0; -#X connect 3 0 4 0; -#X connect 3 1 4 1; -#X connect 4 0 8 0; -#X connect 5 0 4 0; -#X connect 6 0 2 0; -#X connect 7 0 1 0; -#X connect 8 0 9 0; -#X connect 9 0 10 0; -#X connect 10 0 11 0; -#X connect 10 1 12 0; -#X connect 10 2 13 0; -#X connect 11 0 0 0; -#X connect 12 0 11 0; -#X connect 12 1 11 1; -#X connect 13 0 11 0; -#X connect 13 1 11 2; -#X connect 14 0 9 1; -#X connect 18 0 5 0; -#X connect 19 0 6 0; -#X connect 20 0 7 0; -#X coords 0 -1 1 1 102 74 2 100 100; -#X restore 302 324 pd flash-time; -#X text 211 326 1.bg; -#X text 211 346 2.front; -#X text 211 367 3.label; -#X text 163 462 delta; -#X text 21 462 position; -#X msg 22 569 pos \$1 \$2; -#X msg 164 569 delta \$1 \$2; -#X obj 164 545 list; -#X obj 164 484 bng 20 250 50 0 empty empty empty 17 7 0 10 -262144 --1 -1; -#X text 70 483 1.x-position; -#X text 70 505 2.y-position; -#X text 243 483 1.x-delta; -#X text 243 505 2.y-delta; -#N canvas 366 206 174 259 flash-time 0; -#X obj 68 180 pack; -#X obj 103 149 t b a; -#X obj 68 205 outlet; -#X obj 103 104 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-xpos empty 0 --8 0 12 -262144 -1 -1 336 256 0; -#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-ypos empty 0 --8 0 12 -262144 -1 -1 500 256 0; -#X connect 0 0 2 0; -#X connect 1 0 0 0; -#X connect 1 1 0 1; -#X connect 3 0 0 0; -#X connect 4 0 1 0; -#X coords 0 -1 1 1 48 42 2 100 100; -#X restore 22 484 pd flash-time; -#N canvas 366 206 174 259 flash-time 0; -#X obj 68 180 pack; -#X obj 103 149 t b a; -#X obj 68 205 outlet; -#X obj 103 104 nbx 3 14 -20 20 0 0 \$0-dummy \$0-xdelta empty 0 -8 -0 12 -262144 -1 -1 0 256 0; -#X obj 103 124 nbx 3 14 -20 20 0 0 \$0-dummy \$0-ydelta empty 0 -8 -0 12 -262144 -1 -1 0 256 0; -#X connect 0 0 2 0; -#X connect 1 0 0 0; -#X connect 1 1 0 1; -#X connect 3 0 0 0; -#X connect 4 0 1 0; -#X coords 0 -1 1 1 48 42 2 100 100; -#X restore 193 484 pd flash-time; -#X obj 311 467 cnv 15 102 102 empty empty empty 20 12 0 14 -1 -66577 -0; -#X obj 312 468 cnv 15 100 100 empty empty empty 20 12 0 14 -261682 --66577 0; -#X obj 308 262 s tgl_rcv; -#X obj 22 399 s tgl_rcv; -#X obj 162 434 s tgl_rcv; -#X obj 22 594 s tgl_rcv; -#X obj 164 594 s tgl_rcv; -#X obj 336 500 tgl 15 0 tgl_snd tgl_rcv myToggle 17 7 0 10 -262144 --1 -1 0 1; -#X obj 337 538 nbx 3 14 -1e+37 1e+37 0 0 empty empty empty 0 -8 0 12 --262144 -1 -1 0 256 0; -#X text 6 2 [tgl] Changing Properties through Messages; -#X connect 3 0 9 0; -#X connect 4 0 9 0; -#X connect 5 0 12 0; -#X connect 6 0 12 0; -#X connect 13 0 10 0; -#X connect 14 0 10 0; -#X connect 15 0 16 0; -#X connect 17 0 11 0; -#X connect 19 0 23 0; -#X connect 21 0 19 0; -#X connect 24 0 27 0; -#X connect 27 0 25 0; -#X connect 32 0 62 0; -#X connect 33 0 63 0; -#X connect 38 0 32 0; -#X connect 39 0 33 0; -#X connect 42 0 64 0; -#X connect 43 0 42 0; -#X connect 44 0 42 0; -#X connect 50 0 65 0; -#X connect 51 0 66 0; -#X connect 52 0 51 0; -#X connect 53 0 52 0; -#X connect 58 0 50 0; -#X connect 59 0 52 1; -#X connect 67 0 68 0; -#X restore 170 394 pd Changing_GUI_Properties; -#X text 168 463 - creating a [bng] without any arguments will set default -values for all gui-properties. See the subpatch below to learn how -to dynamically instantiate a [bng] object with custom properties:; -#X obj 406 11 tgl 15 0 foo6_rcv empty empty 17 7 0 10 -262144 -1 -1 -0 1; -#X text 426 8 abbreviation: [tgl]; -#X obj 302 78 bng 15 250 50 0 empty empty empty 8 -8 0 10 -262144 -1 --1; -#X obj 302 153 bng 15 250 50 0 empty empty empty 8 -8 0 10 -262144 --1 -1; -#X obj 302 103 s foo6_rcv; -#X obj 302 127 r foo6_snd; -#X obj 56 274 bng 15 250 50 0 empty empty empty 8 -8 0 10 -262144 -1 --1; -#X obj 26 124 bng 15 250 50 0 empty empty empty 8 -8 0 10 -262144 -1 --1; -#X msg 29 65 33; -#X obj 56 184 tgl 60 1 foo6_snd foo6_rcv big_toggle 66 27 2 13 -228992 --4033 -34 1 1; -#X msg 72 87 1; -#X msg 79 109 0; -#X floatatom 56 253 4 0 0 0 - - -, f 4; -#X msg 63 65 -0.001; -#X msg 183 123 set 1; -#X msg 188 145 set 0; -#X obj 20 159 tgl 15 0 empty empty empty 8 -8 0 10 -262144 -1 -1 0 -1; -#X obj 95 253 tgl 15 0 empty empty empty 8 -8 0 10 -262144 -1 -1 1 -1; -#X msg 175 101 set -0.23; -#X obj 323 59 tgl 15 0 empty empty empty 8 -8 0 10 -262144 -1 -1 0 -1; -#X obj 322 153 tgl 15 0 empty empty empty 8 -8 0 10 -262144 -1 -1 1 -1; -#X msg 173 79 0 3 4.55; -#X msg 165 57 0.22 0 -5.44; -#X msg 323 79 set \$1; -#X text 345 151 [tgl] has settable send; -#N canvas 47 373 428 173 tgl_without_gui 0; -#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 [tgl] Build a toggle without a gui; -#X obj 58 87 == 0; -#X floatatom 22 138 3 0 0 0 - - -, f 3; -#X obj 22 43 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 -1 --1; -#X text 96 86 toggle; -#X obj 22 87 f 1; -#X text 95 69 This works like; -#X text 97 105 without the gui.; -#X connect 2 0 6 1; -#X connect 4 0 6 0; -#X connect 6 0 2 0; -#X connect 6 0 3 0; -#X restore 100 552 pd tgl_without_gui; -#X text 98 316 bang; -#X text 168 316 - toggle between zero and the non-zero value.; -#X text 98 331 float; -#X text 98 346 list; -#X text 168 346 - a list will be concatenated to the first item.; -#X text 168 331 - output the value.; -#X text 98 431 float; -#N canvas 80 194 428 314 tgl_creation_arguments 0; -#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 [tgl] Creation Arguments and Dynamic Patching; -#X text 19 38 "tgl" can be called with 14 creation arguments. These -are not "optional" - all parameters must be filled or the gui-bng will -not instantiate correctly.; -#X text 21 127 It's unclear what the Unknown value is for- it is necessary -to have it so you can specify the non-zero value.; -#X text 22 164 Click the msg-box to dynamically create a tgl:; -#X text 21 82 tgl creation arguments: Size Init sendName receiveName -Label labelXOff labelYOff Font# fontSize bgColor foregroundColor LblColor -initValue non-zeroValue; -#X obj 23 231 s pd-tgl_creation_arguments; -#X msg 23 186 obj 160 270 tgl 25 0 tgl-snd tgl-rcv Pleione 30 14 0 -20 5 18 13 0 1 \;; -#X connect 7 0 6 0; -#X restore 170 519 pd tgl_creation_arguments; -#X text 11 23 gui-toggle between zero and a non-zero value; -#X text 215 551 (c) musil@iem.kug.ac.at; -#X text 257 564 IEM KUG; -#X text 232 576 graz \, austria 2002; -#X text 98 463 14; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X connect 21 0 23 0; -#X connect 24 0 22 0; -#X connect 24 0 39 0; -#X connect 26 0 28 0; -#X connect 27 0 28 0; -#X connect 28 0 31 0; -#X connect 28 0 36 0; -#X connect 29 0 28 0; -#X connect 30 0 28 0; -#X connect 31 0 25 0; -#X connect 32 0 28 0; -#X connect 33 0 28 0; -#X connect 34 0 28 0; -#X connect 35 0 28 0; -#X connect 37 0 28 0; -#X connect 38 0 42 0; -#X connect 40 0 28 0; -#X connect 41 0 28 0; -#X connect 42 0 23 0; diff --git a/doc/pddp/trigger-help.pd b/doc/pddp/trigger-help.pd deleted file mode 100644 index ddc76cc72..000000000 --- a/doc/pddp/trigger-help.pd +++ /dev/null @@ -1,391 +0,0 @@ -#N canvas 426 34 555 619 10; -#X obj 0 645 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 trigger 3 12 0 18 --204280 -1 0; -#X obj 0 269 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 484 266 494 358 META 0; -#X text 12 135 LIBRARY internal; -#X text 12 175 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 45 LICENSE SIBSD; -#X text 12 155 AUTHOR Miller Puckette; -#X text 12 215 HELP_PATCH_AUTHORS This help patch was updated for Pd -version 0.35 test 26 by Dave Sabine as part of a project called pddp -proposed by Krzysztof Czaja to build comprehensive documentation for -Pd. Jonathan Wilkes revised the patch to conform to the PDDP template -for Pd version 0.42.; -#X text 12 65 DESCRIPTION sequence message in right-to-left order/ -convert data types; -#X text 12 95 INLET_0 anything; -#X text 12 115 OUTLET_N anything; -#X text 12 5 ALIAS t; -#X text 12 25 KEYWORDS control needs_work list_op bang_op; -#X text 12 195 RELEASE_DATE 1997; -#X restore 500 647 pd META; -#X obj 0 306 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 359 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 547 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 215 343 428 283 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 [trigger] Related Objects; -#X obj 103 43 route; -#X obj 23 43 unpack; -#X obj 69 43 pack; -#X obj 144 43 delay; -#X obj 186 43 pipe; -#X obj 221 43 float; -#X obj 261 43 int; -#X obj 290 43 symbol; -#X text 20 77 Externals; -#X text 20 128 These objects are offered in Pd only if you have downloaded -and properly installed the appropriate library. These objects may or -may not exist in a single library.; -#X text 20 187 The best places to find information about Pd's libraries -is:; -#X text 21 208 www.puredata.org and click on "Downloads" then "Software" -; -#X text 21 223 or; -#X text 21 238 iem.kug.ac.at/pdb/; -#X obj 20 104 pddp/helplink unauthorized/exciter; -#X restore 102 647 pd Related_objects; -#X obj 78 278 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 315 cnv 17 3 17 empty \$0-pddp.cnv.let.n n 5 9 0 16 -228856 --162280 0; -#X obj 446 11 trigger; -#X obj 516 11 t; -#X text 496 11 or; -#X obj 339 568 pddp/pddplink all_about_lists_vs_anythings.pd -text -all_about_lists_vs_anythings; -#X text 98 277 anything; -#X text 168 277 - the inlet to [trigger] takes any type of message. -; -#X text 98 314 variable; -#X text 168 378 - for each creation argument \, a new outlet is created. -If no arguments are supplied \, trigger defaults to two outlets that -output bang messages.; -#X text 98 421 The [trigger] object can be abbreviated as "t" and the -creation arguments can be abbreviated as follows:; -#X obj 214 463 trigger float bang symbol list pointer anything; -#X text 315 482 is the same as; -#X obj 318 502 t f b s l p a; -#X text 97 458 "float" = f; -#X text 97 470 "bang" = b; -#X text 96 482 "symbol" = s; -#X text 97 496 "list" = l; -#X text 97 524 "anything" = a; -#X text 97 510 "pointer" = p; -#X floatatom 230 164 5 0 0 0 - - -, f 5; -#X obj 230 210 +; -#X floatatom 230 235 5 0 0 0 - - -, f 5; -#X obj 230 186 t a a; -#X text 11 23 sequence messages in right-to-left order/ convert data -types; -#X text 168 314 - upon receiving a message to its inlet \, [trigger] -outputs messages specified by the creation arguments. (Like nearly -all Pd objects \, messages are sent out from right to left.); -#N canvas 73 80 428 469 trigger_oddities 0; -#X obj 25 325 trigger anything bang float list pointer symbol; -#X obj 25 347 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 87 347 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 144 347 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 210 347 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 248 347 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 316 347 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 216 435 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 273 435 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 114 413 route float; -#X obj 114 435 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 177 435 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 304 435 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 373 435 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 28 435 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 85 435 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 28 413 route bang; -#X obj 304 413 route symbol; -#X obj 216 413 route list; -#X msg 54 201 1 2 3; -#X msg 25 104 1; -#X msg 32 129 float 2; -#X msg 39 153 test; -#X msg 46 178 symbol this; -#X msg 68 247 list 1 two 3; -#X msg 77 294 list one 2 three; -#X obj 221 390 print LIST; -#X obj 136 390 print FLOAT; -#X msg 59 226 1 two 3; -#X msg 72 271 one 2 three; -#X text 20 39 "float" is interpreted; -#X text 21 59 "symbol" is not interpreted; -#X text 22 78 "list" is interpreted \, and outputted; -#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 [trigger] Oddities; -#X connect 0 0 1 0; -#X connect 0 1 2 0; -#X connect 0 1 16 0; -#X connect 0 2 3 0; -#X connect 0 2 9 0; -#X connect 0 2 27 0; -#X connect 0 3 4 0; -#X connect 0 3 18 0; -#X connect 0 3 26 0; -#X connect 0 4 5 0; -#X connect 0 5 6 0; -#X connect 0 5 17 0; -#X connect 9 0 10 0; -#X connect 9 1 11 0; -#X connect 16 0 14 0; -#X connect 16 1 15 0; -#X connect 17 0 12 0; -#X connect 17 1 13 0; -#X connect 18 0 7 0; -#X connect 18 1 8 0; -#X connect 19 0 0 0; -#X connect 20 0 0 0; -#X connect 21 0 0 0; -#X connect 22 0 0 0; -#X connect 23 0 0 0; -#X connect 24 0 0 0; -#X connect 25 0 0 0; -#X connect 28 0 0 0; -#X connect 29 0 0 0; -#X restore 102 622 pd trigger_oddities; -#N canvas 60 35 428 634 Converting_data_types_with_trigger 0; -#X text 21 38 All sophisticated programming environments provide tools -to convert data types. For instance \, Visual Basic has:; -#X text 27 69 - VarType: to check the data type.; -#X text 27 84 - CStr: to convert a variable to a string.; -#X text 27 99 - CDate: to convert a variable to a date.; -#X text 27 114 - isNumeric: to test whether the variable is a number. -; -#X text 27 129 - etc.; -#X msg 23 255 bang; -#X msg 60 255 1; -#X floatatom 94 255 5 0 0 0 - - -, f 5; -#X msg 133 255 symbol cat; -#X msg 207 255 this is anything; -#X obj 23 304 print all_messages_are_converted_to_bangs; -#X text 20 333 Another example showing floats and symbols.; -#X msg 23 357 bang; -#X floatatom 93 357 5 0 0 0 - - -, f 5; -#X msg 135 357 symbol cat; -#X msg 209 357 this is anything; -#X obj 23 385 t f s; -#X msg 60 357 1 0; -#X obj 50 450 print converted_to_symbols; -#X obj 23 473 print converted_to_floats; -#X text 21 495 In the example above \, note that the trigger object -does not split a list among the outlets like [unpack] does. Instead -it sends all list elements through all outlets and converts them as -necessary.; -#X text 22 550 Also note that some messages don't convert as nicely -as others. Hence \, the symbol "cat" converts to a ZERO when [trigger] -converts that symbol into a float. Likewise \, all numbers will convert -to a symbol called "float" when sent through [trigger]'s right-most -outlet.; -#X obj 23 284 t b; -#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 [trigger] Converting data types; -#X text 20 151 [trigger] is one object in Pd which can convert an incoming -atom to a different type of atom. If a simple conversion is not possible -\, then trigger tries to do the next best thing (e.g. if a symbol is -passed into a [t f] \, such a symbol will be converted to a 0).; -#X text 20 222 Click on each of the messages below and watch your terminal -window for the output.; -#X text 65 384 Note that "this is anything" is converted to the most -sensible option \, which is in this case a 0 That is because it is -impossible for pd-l2ork to predict what an anything should look like -when converted into a float.; -#X connect 6 0 23 0; -#X connect 7 0 23 0; -#X connect 8 0 23 0; -#X connect 9 0 23 0; -#X connect 10 0 23 0; -#X connect 13 0 17 0; -#X connect 14 0 17 0; -#X connect 15 0 17 0; -#X connect 16 0 17 0; -#X connect 17 0 20 0; -#X connect 17 1 19 0; -#X connect 18 0 17 0; -#X connect 23 0 11 0; -#X restore 102 578 pd Converting_data_types_with_trigger; -#N canvas 29 67 459 506 Triggering_messages_with_trigger 0; -#X obj 23 269 metro; -#X msg 50 247 1000; -#X obj 23 289 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 23 194 tgl 15 0 empty empty On/Off 0 -6 0 7 -262144 -1 -1 0 -1; -#X obj 23 212 t f b; -#X text 21 151 Click the toggle to set the tempo and start the [metro] -simultaneously.; -#X text 64 203 Triggers are sent from right to left...so our tempo -messages gets sent to [metro] immediately before the numbers from the -toggle to start and stop the [metro].; -#X obj 23 438 t b b; -#X msg 23 416 bang; -#X obj 23 468 timer; -#X floatatom 23 490 5 0 0 0 - - -, f 5; -#X text 57 416 Click here.; -#X text 62 489 Watch here.; -#X obj 325 560 timer; -#X floatatom 325 581 5 0 0 0 - - -, f 5; -#X obj 352 538 delay 2000; -#X text 136 430 any delay between the first bang and the second bang -; -#X text 137 446 from the trigger.; -#X text 20 540 object to force a 2 second delay between the; -#X text 138 416 In this case \, the [timer] object does not perceive -; -#X obj 325 600 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X floatatom 409 518 5 0 0 0 - - -, f 5; -#X text 19 588 at the top-right to clearly see "logical time"; -#X text 19 601 as measured by [timer].; -#X obj 325 493 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X text 20 384 Below is a simple structure which will measure the "logical -time" between "bangs" from the [trigger] object.; -#X text 20 554 first and second "bangs" sent to the [timer].; -#X text 19 574 You can reset the [delay] with the number box; -#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 [trigger] Uses; -#X text 19 623 Click on the other subpatches in the main window to -read about [trigger]'s second great purpose...; -#X obj 325 513 t; -#X text 21 81 Sequence a series of bangs - or triggers for symbols -and/or other messages. In the example below \, you should see it is -essential that [metro] gets a tempo setting before it is started--let's -assume for a moment that you wanted to start the [metro] with only -a single click.; -#X text 21 38 The [trigger] object serves two great purposes which -aren't necessarily related. Below is a description of its first purpose -; -#X text 20 305 The following example is simple \, and may not be very -practical in most situations \, but it clearly shows how [trigger] -can be used to create a simple sequence of events. It is important -to note however that the messages sent from [trigger]'s outlets occur -in ZERO time with no delay between the events...more at the top right -of the page...; -#X text 20 526 In the following exammple \, we've patched a [delay] -; -#X connect 0 0 2 0; -#X connect 1 0 0 1; -#X connect 3 0 4 0; -#X connect 4 0 0 0; -#X connect 4 1 1 0; -#X connect 7 0 9 1; -#X connect 7 1 9 0; -#X connect 8 0 7 0; -#X connect 9 0 10 0; -#X connect 13 0 14 0; -#X connect 14 0 20 0; -#X connect 15 0 13 1; -#X connect 21 0 15 1; -#X connect 24 0 31 0; -#X connect 31 0 13 0; -#X connect 31 1 15 0; -#X restore 102 556 pd Triggering_messages_with_trigger; -#N canvas 73 48 428 573 Converting_data_types_(cont.) 0; -#X msg 23 131 2.5; -#X msg 110 131 bang; -#X msg 60 131 23 64; -#X msg 153 131 symbol dog; -#X obj 23 256 trigger float bang symbol list anything; -#X text 20 38 In the example below \, you can see that this [trigger] -has creation arguments which specify what data type the object should -output through each outlet. Messages which are sent to the first outlet -will be floats \; the second outlet will send bangs \; the third \, -symbols \; etc.; -#X floatatom 23 278 5 0 0 0 - - -, f 5; -#X obj 80 278 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X symbolatom 138 322 10 0 0 0 - - -, f 10; -#X floatatom 192 187 5 0 0 0 - - -, f 5; -#X obj 192 228 pack f s; -#X msg 237 187 symbol earth; -#X msg 250 209 symbol jupiter; -#X obj 196 300 print a_list; -#X floatatom 23 463 5 0 0 0 - - -, f 5; -#X symbolatom 68 463 10 0 0 0 - - -, f 10; -#X obj 113 441 print another_list; -#X text 228 159 Click on all these.; -#X obj 23 398 r anythings; -#X text 20 346 Note how each of the messages sent to this trigger are -converted appropriately for their receiving atoms boxes. Also note -that "anythings" are sent to the example below.; -#X obj 254 278 s anythings; -#X obj 23 418 route float symbol list; -#X msg 233 131 symbol cat; -#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 [trigger] Converting data types (cont.); -#X text 20 487 Here \, we've used the [route] object to show how "anythings" -are converted as they pass through the above [trigger]. Note that all -messages converted to floats are displayed here in the number box \, -all symbols are displayed in the symbol box \, and all lists are printed -to the terminal window.; -#X connect 0 0 4 0; -#X connect 1 0 4 0; -#X connect 2 0 4 0; -#X connect 3 0 4 0; -#X connect 4 0 6 0; -#X connect 4 1 7 0; -#X connect 4 2 8 0; -#X connect 4 3 13 0; -#X connect 4 4 20 0; -#X connect 9 0 10 0; -#X connect 10 0 4 0; -#X connect 11 0 10 1; -#X connect 12 0 10 1; -#X connect 18 0 21 0; -#X connect 21 0 14 0; -#X connect 21 1 15 0; -#X connect 21 2 16 0; -#X connect 22 0 4 0; -#X restore 102 600 pd Converting_data_types_(cont.); -#X text 80 378 1) symbol atom; -#X obj 4 647 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 339 551 pddp/pddplink all_about_messages.pd -text all_about_messages -; -#X obj 291 624 pddp/pddplink ../2.control.examples/03.connections.pd -; -#X text 5 46 The [trigger] object outputs its input from right to left -\, converting to the types indicated by its creation arguments. There -is also a "pointer" argument type (see the [pointer] object). This -is particularly important because pd-l2ork \, like its pd brethren -dispatches commands from the same outlet based on the order connections -were made \, which is impossible to assess by someone who studies the -code after the fact (including its creator who revisits such a code -a month later). This is why an essential coding practice in pd-l2ork -is that whenever a signal flow splits into more than one output \, -its order of execution is strictly timed by the trigger object., f -89; -#X connect 28 0 31 0; -#X connect 29 0 30 0; -#X connect 31 0 29 0; -#X connect 31 1 29 1; diff --git a/doc/pddp/unpack-help.pd b/doc/pddp/unpack-help.pd deleted file mode 100644 index d13b78898..000000000 --- a/doc/pddp/unpack-help.pd +++ /dev/null @@ -1,120 +0,0 @@ -#N canvas 431 34 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 unpack 3 12 0 18 --204280 -1 0; -#X obj 0 191 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 488 264 494 361 META 0; -#X text 12 105 LIBRARY internal; -#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 125 AUTHOR Miller Puckette; -#X text 12 185 HELP_PATCH_AUTHORS This help patch was updated for Pd -version 0.35 test 26 by Dave Sabine as part of a project called pddp -proposed by Krzysztof Czaja to build comprehensive documentation for -Pd. Jonathan Wilkes revised the patch to conform to the PDDP template -for Pd version 0.42.; -#X text 12 45 DESCRIPTION split a message into atoms; -#X text 12 5 KEYWORDS control list_op; -#X text 12 65 INLET_0 anything; -#X text 12 85 OUTLET_N float list symbol pointer bang; -#X text 12 165 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 391 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 444 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 546 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 220 221 428 404 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 obj 22 43 pack; -#X obj 59 43 trigger; -#X text 8 2 [unpack] Related Objects; -#X text 19 266 These objects are offered in Pd only if you have downloaded -and properly installed the appropriate library. These objects may or -may not exist in a single library.; -#X text 19 315 The best places to find information about Pd's libraries -is:; -#X text 19 335 www.puredata.org and click on "Downloads" then "Software" -; -#X text 19 355 or; -#X text 19 375 iem.kug.ac.at/pdb/; -#X text 19 79 Externals; -#X obj 20 103 pddp/helplink zexy/pack~; -#X obj 20 123 pddp/helplink zexy/unpack~; -#X obj 20 143 pddp/helplink zexy/tabdump; -#X obj 20 163 pddp/helplink zexy/niagara; -#X obj 20 183 pddp/helplink zexy/packel; -#X obj 20 203 pddp/helplink zexy/repack; -#X obj 20 223 pddp/helplink zexy/drip; -#X obj 20 243 pddp/helplink zexy/sort; -#X restore 102 597 pd Related_objects; -#X obj 78 200 cnv 17 3 185 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 267 float; -#X obj 78 400 cnv 17 3 37 empty \$0-pddp.cnv.let.n n 5 9 0 16 -228856 --162280 0; -#X obj 500 11 unpack; -#X floatatom 97 162 0 0 0 0 - - -; -#X floatatom 202 162 0 0 0 0 - - -; -#X floatatom 240 162 0 0 0 0 - - -; -#X floatatom 53 162 0 0 0 0 - - -; -#X msg 103 91 1 2; -#X msg 142 91 3 4 shut; -#X msg 221 91 5 6 pick 7 8; -#X symbolatom 129 162 10 0 0 0 - - -, f 10; -#X text 11 23 split a message into atoms; -#X text 98 297 symbol; -#X text 98 199 list; -#X text 98 340 pointer; -#X text 98 368 bang; -#X text 168 399 - if no arguments are provided \, [unpack] defaults -to two outlets. Otherwise \, one outlet is created for each creation -argument specified.; -#X obj 373 128 unpack; -#X msg 373 91 60 127; -#X floatatom 373 162 3 0 0 0 - - -, f 3; -#X floatatom 406 162 3 0 0 0 - - -, f 3; -#X text 168 199 - the elements will be distributed to the outlets. -The type of each element must match the arguments supplied to [unpack] -\, or a "type mismatch" error will result. Lists with more (or fewer) -elements than the total number of outlets are accepted.; -#X text 100 60 [unpack] takes a list and distributes the elements to -its outlets.; -#X text 80 463 1) float; -#X text 98 477 symbol atom; -#X text 97 550 [unpack] only checks the first letter of each symbol -atom in its arguments \, so both "f" and "float" will specify float -type (so will "foo" \, for that matter).; -#X text 168 267 - if no arguments are given \, or if the first argument -is an "f" \, a float will be accepted and sent to the left outlet. -; -#X obj 103 128 unpack 0 0 s f f; -#X text 168 297 - if the first argument to [unpack] is "s" \, a symbol -message will be sent to the left outlet. Symbol atoms are also accepted -and given the "symbol" selector when output.; -#X text 168 340 - if the first argument to [unpack] is "p" \, a pointer -will be accepted and sent to the left outlet; -#X text 168 368 - a bang to the inlet has no apparent effect.; -#X text 168 463 - one outlet is created for each argument specified. -(If no arguments are provided \, [unpack] will accept a list with two -floats.) Each symbolic argument specifies the type of atom expected -in the incoming list. Acceptable arguments are: "f" for float \, "p" -for pointer \, and "s" for symbol. You can also use a float (e.g. \, -"o") to specify float.; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X connect 16 0 36 0; -#X connect 17 0 36 0; -#X connect 18 0 36 0; -#X connect 26 0 28 0; -#X connect 26 1 29 0; -#X connect 27 0 26 0; -#X connect 36 0 15 0; -#X connect 36 1 12 0; -#X connect 36 2 19 0; -#X connect 36 3 13 0; -#X connect 36 4 14 0; diff --git a/doc/pddp/until-help.pd b/doc/pddp/until-help.pd deleted file mode 100644 index 7ee720b82..000000000 --- a/doc/pddp/until-help.pd +++ /dev/null @@ -1,162 +0,0 @@ -#N canvas 428 32 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 until 3 12 0 18 --204280 -1 0; -#X obj 0 346 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 485 256 494 367 META 0; -#X text 12 125 LIBRARY internal; -#X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 145 AUTHOR Miller Puckette; -#X text 12 205 HELP_PATCH_AUTHORS This help patch was updated for Pd -version 0.35 test 26 by Dave Sabine as part of a project called pddp -proposed by Krzysztof Czaja to build comprehensive documentation for -Pd. Jonathan Wilkes revised the patch to conform to the PDDP template -for Pd version 0.42.; -#X text 12 45 DESCRIPTION looping mechanism; -#X text 12 65 INLET_0 float bang; -#X text 12 105 OUTLET_0 bang; -#X text 12 85 INLET_1 bang; -#X text 12 5 KEYWORDS control bang_op; -#X text 12 185 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 435 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 472 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 500 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#X text 98 476 (none); -#N canvas 213 464 428 159 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 [until] Related Objects; -#X text 19 38 External Objects; -#X obj 21 57 pddp/helplink iemlib/for++; -#X obj 21 77 pddp/helplink cyclone/counter; -#X obj 21 97 pddp/helplink gem_counter; -#X text 123 97 <-- Which library?; -#X obj 21 117 pddp/helplink iemlib/modulo_counter; -#X restore 102 597 pd Related_objects; -#X obj 78 355 cnv 17 3 45 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 444 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 407 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X obj 499 11 until; -#X obj 37 195 until; -#X msg 37 172 100; -#X obj 37 246 print i; -#X text 11 23 looping mechanism; -#X text 98 406 bang; -#X text 167 406 - a bang to the right inlet ends the loop.; -#X text 98 354 bang; -#X text 98 374 float; -#X text 168 354 - a bang to the left inlet starts the loop.; -#X text 168 374 - sending a float to the left inlet will cause [until] -to iterate that number of times.; -#X text 98 443 bang; -#X obj 37 221 f; -#X obj 67 221 + 1; -#X text 117 98 If you start [until] with a number \, it iterates that -number of times. The [uzi] object in MAX works the same way.; -#X obj 119 176 until; -#X msg 119 129 100; -#X obj 119 196 print i; -#X msg 149 136 3; -#X msg 179 143 42; -#N canvas 86 234 428 358 Infinite_loops 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 [until] Infinite loops; -#X msg 23 61 bang; -#X obj 23 81 until; -#X obj 23 101 print; -#X text 61 61 DO NOT CLICK. DO NOT CLICK. DO NOT CLICK.; -#X text 20 126 The [until] object's left inlet starts a loop in which -it outputs "bang" until its right inlet gets a "bang" which stops it. -; -#X text 64 81 If you click \, kill Pd or reboot the computer.; -#X msg 72 241 bang; -#X obj 72 262 until; -#X text 103 241 start; -#X obj 72 284 f; -#X obj 101 284 + 1; -#X obj 147 286 sel 0; -#X obj 72 328 print; -#X obj 101 306 mod 10; -#X text 20 189 The example below includes a method to stop the loop -to prevent Pd from looping infinitely.; -#X text 20 37 How to FREEZE Pd; -#X connect 2 0 3 0; -#X connect 3 0 4 0; -#X connect 8 0 9 0; -#X connect 9 0 11 0; -#X connect 11 0 12 0; -#X connect 11 0 14 0; -#X connect 12 0 15 0; -#X connect 13 0 9 1; -#X connect 15 0 11 1; -#X connect 15 0 13 0; -#X restore 102 533 pd Infinite_loops; -#N canvas 106 85 428 440 Loops 0; -#X text 20 38 Every modern programming language will have various "looping" -mechanisms: either in the form of an object \, or as a data structure. -For example in Visual Basic:; -#X text 31 105 DO UNTIL i = 100; -#X text 31 119 i = i + 1; -#X text 32 90 i = 0; -#X text 31 134 LOOP; -#X text 20 245 And now Pd's version of the above programming structures: -; -#X obj 29 322 until; -#X obj 29 382 print i; -#X text 20 160 OR:; -#X text 30 186 FOR i = 0 TO 100; -#X text 29 212 NEXT; -#X text 30 200 ' do something; -#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 [until] More about loops; -#X obj 239 292 until; -#X msg 239 272 100; -#X obj 239 312 print i; -#X text 139 289 OR:; -#X obj 29 352 f; -#X obj 57 352 + 1; -#X msg 29 268 100; -#X obj 29 291 t a b; -#X obj 70 322 0; -#X connect 6 0 18 0; -#X connect 14 0 16 0; -#X connect 15 0 14 0; -#X connect 18 0 19 0; -#X connect 18 0 7 0; -#X connect 19 0 18 1; -#X connect 20 0 21 0; -#X connect 21 0 6 0; -#X connect 21 1 22 0; -#X connect 22 0 18 1; -#X restore 102 509 pd Loops; -#X text 116 216 If you start [until] with a "bang" \, it will begin -an infinite loop! Please plan ahead in this case so that there is a -mechanism in place to stop the loop - otherwise Pd will effectively -freeze. (See the "Loops" subpatch below.); -#X obj 102 555 pddp/pddplink all_about_looping.pd -text all_about_looping -; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 102 572 pddp/pddplink ../2.control.examples/24.loops.pd -text -doc/2.control.examples/24.loops.pd; -#X connect 13 0 24 0; -#X connect 14 0 13 0; -#X connect 24 0 15 0; -#X connect 24 0 25 0; -#X connect 25 0 24 1; -#X connect 27 0 29 0; -#X connect 28 0 27 0; -#X connect 30 0 27 0; -#X connect 31 0 27 0; diff --git a/doc/pddp/value-help.pd b/doc/pddp/value-help.pd deleted file mode 100644 index 313501489..000000000 --- a/doc/pddp/value-help.pd +++ /dev/null @@ -1,142 +0,0 @@ -#N canvas 430 37 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 value 3 12 0 18 --204280 -1 0; -#X obj 0 284 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 488 240 494 391 META 0; -#X text 12 125 LIBRARY internal; -#X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 45 LICENSE SIBSD; -#X text 12 145 AUTHOR Miller Puckette; -#X text 12 205 HELP_PATCH_AUTHORS This help patch was updated for Pd -version 0.35 test 26 by Dave Sabine as part of a project called pddp -proposed by Krzysztof Czaja to build comprehensive documentation for -Pd. Jonathan Wilkes revised the patch to conform to the PDDP template -for Pd version 0.42.; -#X text 12 25 KEYWORDS control storage nonlocal; -#X text 12 65 DESCRIPTION nonlocal shared value (named variable); -#X text 12 5 ALIAS v; -#X text 12 85 INLET_0 float bang; -#X text 12 105 OUTLET_0 float; -#X text 12 185 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 379 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 525 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 218 491 428 139 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 [value] Related Objects; -#X obj 23 43 send; -#X obj 56 43 receive; -#X text 20 76 External Objects; -#X obj 110 43 expr; -#X obj 20 96 pddp/helplink motex/getenv; -#X restore 102 597 pd Related_objects; -#X obj 78 293 cnv 17 3 75 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 322 float; -#X text 98 352 list; -#X text 98 387 float; -#X obj 78 388 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 456 11 value; -#X obj 516 11 v; -#X text 494 11 or; -#X text 11 23 nonlocal shared value (named variable); -#N canvas 57 148 428 418 scope 0; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X text 20 38 Understanding "scope" is important while developing programmatic -applications. In Pd there are three levels of "scope":; -#X text 31 81 1 Local Scope: all objects \, subroutines \, data \, -and variables which exist within a single patch on a single computer -and do not communicate with other active Pd patches.; -#X text 29 137 2 Global Scope: all objects \, subroutines \, data and -variables which exist within single or multiple patches on a single -computer which communicate with other active Pd patches.; -#X text 20 260 As a general rule \, all things are considered "local" -in Pd and if communication between Pd windows is necessary \, then -[send]/[receive] \, or [throw]/[catch] objects are used. Likewise \, -if communication is necessary between many computers running Pd \, -then objects such as [netsend]/[netreceive] are used.; -#X text 20 347 The exception to the above rule is [value]. This object -is a container which makes its data known to all [value] objects of -the same name in all active Pd windows on a single computer: hence -\, GLOBAL scope.; -#X text 30 199 3 Network (Universal) Scope: all objects \, subroutines -\, data and variables which exist within single or multiple patches -on two or more computers which communicate with other active Pd patches -via a network.; -#X text 8 2 [value] Scope in Pd; -#X restore 102 574 pd scope; -#X text 98 47 [value] is a container. It holds a global variable numeric -value and can be "polled" at any time with a "bang" message. In other -words \, [value] is a place where numbers can be stored and then accessed -by all active Pd windows.; -#N canvas 73 60 428 231 global_values 0; -#X obj 173 168 v my_variable; -#X floatatom 173 190 5 0 0 0 - - -, f 5; -#X obj 173 127 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X floatatom 191 145 5 0 0 0 - - -, f 5; -#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 [value] Sub-patch to demonstrate global values; -#X text 20 38 To show how global scope works \, "bang" the [value] -object to retreive the current number. While you're in the sub-patch -\, change the number and then return to the main patch window and click -the "bang". You'll quickly see how this variable can be retreived or -reset in any active Pd window.; -#X connect 0 0 1 0; -#X connect 2 0 0 0; -#X connect 3 0 0 0; -#X restore 101 261 pd global_values; -#X text 16 102 To assign a numeric value to that variable \, a number -box or message can be used \, as follows:; -#X obj 19 179 value my_variable; -#X msg 37 156 42; -#X floatatom 19 203 5 0 0 0 - - -, f 5; -#X floatatom 19 136 5 0 0 0 - - -, f 5; -#X obj 271 188 value my_variable; -#X floatatom 271 212 5 0 0 0 - - -, f 5; -#X obj 271 168 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X text 63 135 play with me; -#X text 62 155 or click me; -#X text 186 133 Notice that the number is not outputted to the outlet -\; it is merely stored. To retreive the number \, send a "bang" \, -like below:; -#X text 168 322 - a float to the inlet sets all [value] objects that -share the same name to the incoming value.; -#X text 168 352 - a list is truncated to the first element.; -#X text 98 292 bang; -#X text 168 292 - sending a bang to a particular [value] object will -cause it to output its current value.; -#X text 168 387 - the current value is output when a bang is received -at the inlet.; -#X text 98 229 All [value] objects with the same name receive the value -(see subpatch below):; -#X text 168 491 If no creation argument is given \, then the object -will communicate with all other [value] objects with no name.; -#X text 99 529 [value] variables may be used within all [expr] family -objects. See the help patches for [expr] \, [expr~] and [fexpr~] for -more information.; -#X text 80 439 1) symbol atom; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X text 168 439 - [value] takes one argument (a symbol) that is the -name of the object. All [value] objects that share this name will have -their values updated when a float is sent to the inlet of any of them. -; -#X obj 193 574 pddp/pddplink all_about_expr_and_value.pd; -#X connect 21 0 23 0; -#X connect 22 0 21 0; -#X connect 24 0 21 0; -#X connect 25 0 26 0; -#X connect 27 0 25 0; diff --git a/doc/pddp/vcf~-help.pd b/doc/pddp/vcf~-help.pd deleted file mode 100644 index 4e4ff549d..000000000 --- a/doc/pddp/vcf~-help.pd +++ /dev/null @@ -1,94 +0,0 @@ -#N canvas 430 37 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 vcf~ 3 12 0 18 -204280 --1 0; -#X obj 0 376 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 485 226 494 409 META 0; -#X text 12 165 LIBRARY internal; -#X text 12 205 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 185 AUTHOR Miller Puckette; -#X text 12 245 HELP_PATCH_AUTHORS Updated for Pd version 0.35. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 5 KEYWORDS signal filter; -#X text 12 45 DESCRIPTION voltage-controlled bandpass filter; -#X text 12 65 INLET_0 signal; -#X text 12 105 INLET_2 float; -#X text 12 85 INLET_1 signal; -#X text 12 125 OUTLET_0 signal; -#X text 12 145 OUTLET_1 signal; -#X text 12 225 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 468 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 525 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 566 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 216 524 428 109 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 obj 22 43 bp~; -#X text 8 2 [vcf~] Related Objects; -#X restore 102 597 pd Related_objects; -#X obj 78 385 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 477 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 413 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X obj 501 9 vcf~; -#X obj 78 440 cnv 17 3 17 empty \$0-pddp.cnv.let.2 2 5 9 0 16 -228856 --162280 0; -#X text 98 439 float; -#X text 98 476 signal; -#X text 98 384 signal; -#X text 98 412 signal; -#X obj 261 141 sig~; -#X text 68 141 test signal; -#X text 125 235 amp in (db); -#X text 116 96 test frequency; -#X text 248 233 amp out (db); -#X text 230 96 center frequency; -#X text 344 140 q; -#X floatatom 146 120 5 0 0 0 - - -, f 5; -#X floatatom 261 120 5 0 0 0 - - -, f 5; -#X obj 146 141 osc~; -#X floatatom 308 141 5 0 0 0 - - -, f 5; -#X obj 146 190 env~ 8192; -#X obj 244 190 env~ 8192; -#X floatatom 146 212 5 0 0 0 - - -, f 5; -#X floatatom 244 212 5 0 0 0 - - -, f 5; -#X obj 244 168 vcf~ 1; -#X text 293 167 optional argument to initialize q; -#X text 11 23 voltage-controlled bandpass filter; -#X text 167 412 - center frequency \, which may change continuously -in time.; -#X text 167 439 - change the "Q \, " or filter sharpness.; -#X text 168 384 - the incoming signal to be filtered; -#X text 168 543 - [vcf~] takes one argument to initialize q.; -#X text 80 543 1) float; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 478 58 pddp/dsp; -#X text 168 476 - the filtered signal (real part).; -#X obj 78 500 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 98 499 signal; -#X text 168 499 - the filtered signal (imaginary part).; -#X text 76 283 [vcf~] is like [bp~] except that it takes an audio signal -to set center frequency \, which may thus change continuously in time. -The "Q" or filter sharpness is still only set by messages. More expensive -than bp~ in CPU time but more powerful too.; -#X connect 17 0 32 1; -#X connect 24 0 26 0; -#X connect 25 0 17 0; -#X connect 26 0 28 0; -#X connect 26 0 32 0; -#X connect 27 0 32 2; -#X connect 28 0 30 0; -#X connect 29 0 31 0; -#X connect 32 0 29 0; diff --git a/doc/pddp/vdial-help.pd b/doc/pddp/vdial-help.pd deleted file mode 100644 index 5990e567c..000000000 --- a/doc/pddp/vdial-help.pd +++ /dev/null @@ -1,283 +0,0 @@ -#N canvas 432 36 558 455 10; -#X obj 1 1 cnv 8 100 60 empty empty vdial=vdl 20 20 1 18 -262144 -1109 -0; -#X text 13 390 (c) musil@iem.kug.ac.at; -#X text 55 403 IEM KUG; -#X text 132 122 click properties to; -#X text 120 133 modify geometry \, colors \, etc.; -#X obj 159 261 bng 15 250 50 0 empty empty empty 8 -8 0 10 -262144 --1 -1; -#X obj 21 54 bng 15 250 50 0 empty empty empty 8 -8 0 10 -262144 -1 --1; -#X msg 41 319 \$1; -#X floatatom 41 341 4 0 0 0 - - -, f 4; -#X obj 41 363 bng 15 250 50 0 empty empty empty 8 -8 0 10 -262144 -1 --1; -#X obj 86 338 tgl 12 0 empty empty empty 8 -8 0 10 -262144 -1 -1 0 -1; -#X obj 86 317 route 0 1 2 3 4 5 6 7 8 9; -#X msg 194 92 set \$1; -#X floatatom 194 71 4 0 9 0 - - -, f 4; -#X floatatom 44 54 4 0 9 0 - - -, f 4; -#X msg 91 41 7 0 -5.44; -#X msg 95 63 3 3 4.55; -#X obj 103 338 tgl 12 0 empty empty empty 8 -8 0 10 -262144 -1 -1 0 -1; -#X obj 120 338 tgl 12 0 empty empty empty 8 -8 0 10 -262144 -1 -1 0 -1; -#X obj 137 338 tgl 12 0 empty empty empty 8 -8 0 10 -262144 -1 -1 0 -1; -#X obj 154 338 tgl 12 0 empty empty empty 8 -8 0 10 -262144 -1 -1 0 -1; -#X obj 171 338 tgl 12 0 empty empty empty 8 -8 0 10 -262144 -1 -1 0 -1; -#X obj 188 338 tgl 12 0 empty empty empty 8 -8 0 10 -262144 -1 -1 0 -1; -#X obj 205 338 tgl 12 0 empty empty empty 8 -8 0 10 -262144 -1 -1 0 -1; -#X obj 222 338 tgl 12 0 empty empty empty 8 -8 0 10 -262144 -1 -1 0 -1; -#X obj 239 338 tgl 12 0 empty empty empty 8 -8 0 10 -262144 -1 -1 0 -1; -#X obj 79 355 print; -#X floatatom 183 287 4 0 0 0 - - -, f 4; -#X msg 183 261 \$1; -#X msg 158 192 set \$1; -#X floatatom 158 171 4 0 9 0 - - -, f 4; -#X text 125 355 UP- \, DOWN- \, LEFT- or RIGHT-key; -#X text 124 366 for moving selected gui-objects; -#N canvas 230 247 699 530 edit 0; -#X obj 42 198 f; -#X msg 20 177 bang; -#X floatatom 58 176 3 63 156 0 - - -, f 3; -#X floatatom 93 198 3 -20 37 0 - - -, f 3; -#X obj 42 221 pack 0 0; -#X text 120 198 y-label; -#X text 86 176 x-label; -#X floatatom 270 187 3 8 50 0 - - -, f 3; -#X text 297 187 size; -#X obj 286 293 f; -#X msg 264 272 bang; -#X floatatom 302 271 3 -10 10 0 - - -, f 3; -#X floatatom 337 293 3 -10 10 0 - - -, f 3; -#X obj 286 316 pack 0 0; -#X obj 300 412 f; -#X msg 278 391 bang; -#X floatatom 316 390 3 20 60 0 - - -, f 3; -#X floatatom 351 412 3 100 200 0 - - -, f 3; -#X obj 300 435 pack 0 0; -#X text 330 271 x-delta; -#X text 364 293 y-delta; -#X text 344 390 x-position; -#X text 378 412 y-position; -#X obj 62 313 f; -#X msg 40 292 bang; -#X floatatom 78 291 3 0 2 0 - - -, f 3; -#X floatatom 113 313 3 4 36 0 - - -, f 3; -#X obj 62 336 pack 0 0; -#X text 106 291 font; -#X text 142 313 height; -#X text 504 293 no init; -#X text 475 348 init value on loadbang; -#X floatatom 482 228 5 2 20 0 - - -, f 5; -#X text 491 417 changing-behavior; -#X text 526 228 number of buttons; -#X obj 47 104 pack 0 0 0; -#X obj 47 76 f; -#X msg 24 28 bang; -#X floatatom 63 26 3 0 29 0 - - -, f 3; -#X floatatom 79 46 3 0 29 0 - - -, f 3; -#X floatatom 112 62 3 0 29 0 - - -, f 3; -#X text 91 26 background; -#X text 106 46 front-color; -#X text 140 63 label-color; -#X msg 285 25 back; -#X msg 285 45 front; -#X msg 285 65 label; -#X msg 247 25 bang; -#N canvas 15 207 606 448 RGB_____________ 0; -#X obj 97 56 inlet; -#X obj 262 53 inlet; -#X obj 339 55 inlet; -#X obj 405 56 inlet; -#X obj 97 270 bang; -#X msg 77 295 0; -#X msg 104 295 1; -#X obj 146 268 bang; -#X msg 132 295 0; -#X msg 160 295 1; -#X obj 196 269 bang; -#X msg 187 295 0; -#X msg 214 295 1; -#X obj 265 313 spigot; -#X obj 312 313 spigot; -#X obj 359 313 spigot; -#X obj 249 385 outlet; -#X text 93 33 select; -#X text 267 28 red; -#X text 337 30 green; -#X text 409 30 blue; -#X obj 405 102 t b f; -#X obj 339 160 +; -#X obj 339 185 t b f; -#X obj 339 216 +; -#X obj 296 385 outlet; -#X obj 343 385 outlet; -#X obj 28 180 loadbang; -#X obj 97 135 route back front label bang; -#X obj 343 362 f; -#X obj 296 361 f; -#X obj 249 361 f; -#X obj 262 79 * -65536; -#X obj 339 80 * -256; -#X obj 405 80 * -1; -#X obj 339 247 - 1; -#X obj 235 168 t b b b b; -#X connect 0 0 28 0; -#X connect 1 0 32 0; -#X connect 2 0 33 0; -#X connect 3 0 34 0; -#X connect 4 0 5 0; -#X connect 4 0 6 0; -#X connect 5 0 14 1; -#X connect 5 0 15 1; -#X connect 6 0 13 1; -#X connect 7 0 8 0; -#X connect 7 0 9 0; -#X connect 8 0 13 1; -#X connect 8 0 15 1; -#X connect 9 0 14 1; -#X connect 10 0 11 0; -#X connect 10 0 12 0; -#X connect 11 0 13 1; -#X connect 11 0 14 1; -#X connect 12 0 15 1; -#X connect 13 0 31 1; -#X connect 14 0 30 1; -#X connect 15 0 29 1; -#X connect 21 0 22 0; -#X connect 21 1 22 1; -#X connect 22 0 23 0; -#X connect 23 0 24 0; -#X connect 23 1 24 1; -#X connect 24 0 35 0; -#X connect 27 0 6 0; -#X connect 28 0 4 0; -#X connect 28 1 7 0; -#X connect 28 2 10 0; -#X connect 28 3 36 0; -#X connect 29 0 26 0; -#X connect 30 0 25 0; -#X connect 31 0 16 0; -#X connect 32 0 24 0; -#X connect 33 0 22 0; -#X connect 34 0 21 0; -#X connect 35 0 15 0; -#X connect 35 0 14 0; -#X connect 35 0 13 0; -#X connect 36 0 31 0; -#X connect 36 1 30 0; -#X connect 36 2 29 0; -#X connect 36 3 35 0; -#X restore 285 86 pd RGB_____________; -#X floatatom 327 55 3 0 255 0 - - -, f 3; -#X floatatom 370 55 3 0 255 0 - - -, f 3; -#X floatatom 413 56 3 0 255 0 - - -, f 3; -#X text 34 0 preset-colors; -#X text 296 -3 RGB-colors; -#X text 327 37 red; -#X text 363 36 green; -#X text 411 36 blue; -#X msg 47 125 \; foo12_rcv color \$1 \$2 \$3; -#X msg 42 246 \; foo12_rcv label_pos \$1 \$2; -#X msg 62 361 \; foo12_rcv label_font \$1 \$2; -#X msg 34 423 \; foo12_rcv label blabla; -#X msg 34 459 \; foo12_rcv label vdial_0_9; -#X msg 300 460 \; foo12_rcv pos \$1 \$2; -#X msg 286 341 \; foo12_rcv delta \$1 \$2; -#X msg 270 216 \; foo12_rcv size \$1; -#X msg 483 50 \; foo12_rcv send foo12a_snd; -#X msg 483 88 \; foo12_rcv send foo12_snd; -#X msg 482 171 \; foo12a_rcv receive foo12_rcv; -#X msg 483 133 \; foo12_rcv receive foo12a_rcv; -#X msg 482 254 \; foo12_rcv number \$1; -#X msg 483 312 \; foo12_rcv init 0; -#X msg 485 366 \; foo12_rcv init 1; -#X msg 490 436 \; foo12_rcv single_change; -#X msg 490 470 \; foo12_rcv double_change; -#X connect 0 0 4 0; -#X connect 1 0 0 0; -#X connect 2 0 0 1; -#X connect 3 0 4 1; -#X connect 4 0 58 0; -#X connect 7 0 64 0; -#X connect 9 0 13 0; -#X connect 10 0 9 0; -#X connect 11 0 9 1; -#X connect 12 0 13 1; -#X connect 13 0 63 0; -#X connect 14 0 18 0; -#X connect 15 0 14 0; -#X connect 16 0 14 1; -#X connect 17 0 18 1; -#X connect 18 0 62 0; -#X connect 23 0 27 0; -#X connect 24 0 23 0; -#X connect 25 0 23 1; -#X connect 26 0 27 1; -#X connect 27 0 59 0; -#X connect 32 0 69 0; -#X connect 35 0 57 0; -#X connect 36 0 35 0; -#X connect 37 0 36 0; -#X connect 38 0 36 1; -#X connect 39 0 35 1; -#X connect 40 0 35 2; -#X connect 44 0 48 0; -#X connect 45 0 48 0; -#X connect 46 0 48 0; -#X connect 47 0 48 0; -#X connect 48 0 35 0; -#X connect 48 1 35 1; -#X connect 48 2 35 2; -#X connect 49 0 48 1; -#X connect 50 0 48 2; -#X connect 51 0 48 3; -#X restore 267 222 pd edit; -#X obj 221 11 x_all_guis aaa bbb ccc ddd eee fff ggg hhh iii; -#X text 30 415 graz \, austria 2002; -#X text 223 401 updated for Pd version 0.35; -#X text 144 11 gui-vdial:; -#X obj 79 110 vdl 25 1 0 8 foo12_snd foo12_rcv vdial_0_9 20 -8 192 -10 -99865 -262144 -260818 0; -#X obj 352 36 vdl 15 1 0 8 iii iii empty 20 8 192 8 -262144 -1 -1 0 -; -#X obj 158 213 s foo12_rcv; -#X obj 159 239 r foo12_snd; -#X text 225 418 KEYWORDS deprecated; -#X connect 6 0 38 0; -#X connect 7 0 8 0; -#X connect 8 0 9 0; -#X connect 11 0 10 0; -#X connect 11 1 17 0; -#X connect 11 2 18 0; -#X connect 11 3 19 0; -#X connect 11 4 20 0; -#X connect 11 5 21 0; -#X connect 11 6 22 0; -#X connect 11 7 23 0; -#X connect 11 8 24 0; -#X connect 11 9 25 0; -#X connect 12 0 38 0; -#X connect 13 0 12 0; -#X connect 14 0 38 0; -#X connect 15 0 38 0; -#X connect 16 0 38 0; -#X connect 28 0 27 0; -#X connect 29 0 40 0; -#X connect 30 0 29 0; -#X connect 38 0 11 0; -#X connect 38 0 26 0; -#X connect 38 0 7 0; -#X connect 41 0 5 0; -#X connect 41 0 28 0; diff --git a/doc/pddp/vd~-help.pd b/doc/pddp/vd~-help.pd deleted file mode 100644 index 705191787..000000000 --- a/doc/pddp/vd~-help.pd +++ /dev/null @@ -1,93 +0,0 @@ -#N canvas 430 33 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 vd~ 3 12 0 18 -204280 --1 0; -#X obj 0 369 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 486 282 494 344 META 0; -#X text 12 115 LIBRARY internal; -#X text 12 155 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 135 AUTHOR Miller Puckette; -#X text 12 195 HELP_PATCH_AUTHORS Updated for Pd version 0.33. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 5 KEYWORDS signal nonlocal time; -#X text 12 45 DESCRIPTION read a signal from a delay line at a variable -delay time; -#X text 12 75 INLET_0 signal; -#X text 12 95 OUTLET_0 signal; -#X text 12 175 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 444 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 497 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 538 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 218 514 428 109 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 obj 22 43 delwrite~; -#X obj 92 43 delread~; -#X text 8 2 [vd~] Related Objects; -#X obj 159 44 delay; -#X restore 102 597 pd Related_objects; -#X obj 78 378 cnv 17 3 55 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 453 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 324 138 sig~; -#X text 98 377 signal; -#X text 98 397 float; -#X text 98 416 list; -#X text 11 23 reads a signal from a delay line at a variable delay -time; -#X text 165 343 NOTE: [vd~] uses 4-point-interpolation; -#X text 98 452 signal; -#X text 168 452 - the signal from the corresponding [delwrite~] object -is interpolated and output after the delay specified by the incoming -signal.; -#X text 168 515 - the name of the corresponding [delwrite~] object -; -#X text 168 416 - a list is truncated to the first element.; -#X text 168 377 - incoming signal (delay time in ms).; -#X text 168 397 - delay time in ms.; -#X text 80 515 1) symbol atom; -#X obj 101 160 delwrite~ vd~help_example 1000; -#X obj 324 160 vd~ vd~help_example; -#X text 98 67 [vd~] implements a 4-point interpolating delay tap from -a corresponding delwrite~ object. The delay in milliseconds of the -tap is specified by the incoming signal.; -#X floatatom 324 115 5 0 0 0 - - -, f 5; -#X obj 324 230 snapshot~; -#X obj 333 204 metro 150; -#X obj 333 182 loadbang; -#X floatatom 324 252 5 0 0 0 - - -, f 5; -#X floatatom 101 139 5 0 0 0 - - -, f 5; -#X msg 369 115 1000; -#X text 98 274 The delay time is always at least one sample and at -most the length of the delay line (specified by [delwrite~]). In addition -\, in case the [delwrite~] runs later in the DSP loop than the [vd~] -\, the delay is constrained below by one vector length (64 samples.) -; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 480 53 pddp/dsp; -#X obj 98 543 pddp/pddplink ../3.audio.examples/G03.delay.variable.pd --text doc/3.audio.examples/G03.delay.variable.pd; -#X obj 98 558 pddp/pddplink ../3.audio.examples/G04.control.blocksize.pd --text doc/3.audio.examples/G04.control.blocksize.pd; -#X obj 98 573 pddp/pddplink ../3.audio.examples/G05.execution.order.pd --text doc/3.audio.examples/G05.execution.order.pd; -#X obj 519 12 vd~; -#X text 484 5; -#X connect 10 0 24 0; -#X connect 24 0 27 0; -#X connect 26 0 10 0; -#X connect 27 0 30 0; -#X connect 28 0 27 0; -#X connect 29 0 28 0; -#X connect 31 0 23 0; -#X connect 32 0 10 0; diff --git a/doc/pddp/vline~-help.pd b/doc/pddp/vline~-help.pd deleted file mode 100644 index e1d355e2b..000000000 --- a/doc/pddp/vline~-help.pd +++ /dev/null @@ -1,100 +0,0 @@ -#N canvas 431 35 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 vline~ 3 12 0 18 --204280 -1 0; -#X obj 0 361 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 484 278 494 344 META 0; -#X text 12 145 LIBRARY internal; -#X text 12 185 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 165 AUTHOR Miller Puckette; -#X text 12 225 HELP_PATCH_AUTHORS Updated for version 0.33. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 5 KEYWORDS signal time conversion; -#X text 12 45 DESCRIPTION high-precision audio ramp generator; -#X text 12 65 INLET_0 float list stop; -#X text 12 85 INLET_1 float; -#X text 12 105 INLET_2 float; -#X text 12 125 OUTLET_0 signal; -#X text 12 205 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 499 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 541 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 568 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#X text 98 545 (none); -#N canvas 223 521 428 109 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 obj 22 43 line~; -#X obj 62 43 line; -#X text 8 2 [vline~] Related Objects; -#X restore 102 597 pd Related_objects; -#X obj 78 370 cnv 17 3 70 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 369 float; -#X text 98 393 list; -#X obj 78 508 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 448 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 98 447 float; -#X obj 495 11 vline~; -#X text 11 23 high-precision audio ramp generator; -#X text 168 393 - a list to the first inlet is distributed among the -inlets of [vline~].; -#X text 98 426 stop; -#X obj 78 471 cnv 17 3 17 empty \$0-pddp.cnv.let.2 2 5 9 0 16 -228856 --162280 0; -#X text 98 470 float; -#X text 98 507 signal; -#X text 168 507 - the output is a linear ramp whose levels and timing -are determined by the messages sent to the inlet(s).; -#X obj 31 271 snapshot~; -#X floatatom 31 294 5 0 0 0 - - -, f 5; -#X obj 41 244 metro 100; -#X msg 31 69 1 1000; -#X msg 59 174 stop; -#X msg 51 113 0; -#X obj 31 200 vline~; -#X text 86 67 ramp up; -#X msg 40 91 0 1000; -#X text 86 90 ramp down; -#X text 60 133 ramp up \, jump down \, ramp up again; -#X msg 54 152 1 1000 \, 0 0 1000 \, 1 1000 1000; -#X text 86 112 jump down; -#X text 147 181 The [vline~] object \, like [line~] \, generates linear -ramps whose levels and timing are determined by messages you send it. -The messages consist of a target value \, a time interval (zero if -not supplied) \, and an initial delay (also zero if not supplied.) -Ramps may start and stop between audio samples \, in which case the -output is interpolated accordingly.; -#X text 147 276 Any number of future ramps may be scheduled and [vline~] -will remember them and execute them in order. They must be specified -in increasing order of initial delay however \, since a segment cancels -all planned segments at any future time.; -#X text 168 369 - target value.; -#X text 168 426 - the "stop" message freezes [vline~] at its current -value.; -#X text 167 447 - time value.; -#X text 167 470 - initial delay.; -#X obj 41 222 loadbang; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 474 57 pddp/dsp; -#X obj 98 572 pddp/pddplink ../3.audio.examples/C04.control.to.signal.pd --text doc/3.audio.examples/C04.control.to.signal.pd; -#X connect 23 0 24 0; -#X connect 25 0 23 0; -#X connect 26 0 29 0; -#X connect 27 0 29 0; -#X connect 28 0 29 0; -#X connect 29 0 23 0; -#X connect 31 0 29 0; -#X connect 34 0 29 0; -#X connect 42 0 25 0; diff --git a/doc/pddp/vslider-help.pd b/doc/pddp/vslider-help.pd deleted file mode 100644 index 8bd6ecff4..000000000 --- a/doc/pddp/vslider-help.pd +++ /dev/null @@ -1,433 +0,0 @@ -#N canvas 430 32 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 vslider 3 12 0 18 --204280 -1 0; -#X obj 0 306 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 485 240 494 387 META 0; -#X text 12 135 LIBRARY internal; -#X text 12 175 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 45 LICENSE SIBSD; -#X text 12 155 AUTHOR Miller Puckette; -#X text 12 215 HELP_PATCH_AUTHORS This help patch was updated for Pd -version 0.35 test 28 by Dave Sabine as part of a project called pddp -proposed by Krzysztof Czaja to build comprehensive documentation for -Pd. Jonathan Wilkes revised the patch to conform to the PDDP template -for Pd version 0.42.; -#X text 12 25 KEYWORDS control storage GUI nonlocal; -#X text 12 65 DESCRIPTION vertical gui-slider; -#X text 12 5 ALIAS vsl; -#X text 12 85 INLET_0 float bang size range log init steady receive -send label label_pos label_font color pos delta; -#X text 12 115 OUTLET_0 float; -#X text 12 195 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 436 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 490 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 574 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#X obj 78 315 cnv 17 3 106 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#N canvas 209 494 428 129 Related_objects 0; -#X obj 20 53 x_all_guis bng tgl vsl hsl hradio vradio vu cnv nbx; -#X text 18 29 All iem-gui objects:; -#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 [vslider] Related Objects; -#X restore 100 597 pd Related_objects; -#X obj 78 445 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 314 float; -#X text 98 445 float; -#X text 54 259 Use the UP- \, DOWN- \, LEFT- or RIGHT-key to move a -selected gui-object. Right-click and choose "Properties" to modify -its appearance.; -#X text 168 445 - when the slider value is changed by clicking \, dragging -\, or sending a float to the inlet \, the new slider value is sent -to the outlet.; -#N canvas 53 19 464 608 Setting_slider_properties_through_messages -0; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X floatatom 12 189 1 0 1 0 - #0-soc -, f 1; -#X text 324 35 no init; -#X text 9 170 steady-on-click; -#X text 11 309 label; -#X msg 11 329 label blabla; -#X msg 324 54 init 0; -#X msg 12 222 steady \$1; -#X msg 235 74 lin; -#X msg 245 106 log; -#X text 231 35 linear/; -#X text 231 50 logarithmical; -#X text 333 74 init value; -#X text 334 89 on loadbang; -#X text 235 170 change send name; -#X text 108 170 change receive name; -#X obj 122 245 s z_rcv; -#X msg 110 192 receive z_rcv; -#X msg 21 381 label mySlider; -#X msg 122 222 receive hsl_rcv; -#X msg 237 193 send hsl1_snd; -#X msg 246 222 send hsl_snd; -#N canvas 234 255 161 292 init 0; -#X obj 16 11 loadbang; -#X obj 16 42 f \$0; -#X msg 16 73 \; \$1-xpos 391 \; \$1-ypos 200 \; \$1-xlabel -2 \; \$1-ylabel --8 \; \$1-soc 1 \; \$1-font-size 10 \; \$1-width 15 \; \$1-height 128 -\; \$1-bottom 0 \; \$1-top 127 \; \$1-bg 0 \; \$1-front 12 \; \$1-label -12; -#X connect 0 0 1 0; -#X connect 1 0 2 0; -#X restore 400 586 pd init; -#X msg 334 110 init 1; -#X msg 12 106 size \$1 \$2; -#X text 61 57 1.width; -#X text 61 78 2.height; -#X text 173 57 1.bottom; -#X text 173 78 2.top; -#X text 121 35 output-range; -#X msg 124 106 range \$1 \$2; -#X text 242 308 font properties; -#X msg 244 380 label_font \$1 \$2; -#X text 293 330 1.font(0-2); -#X text 293 351 2.height; -#X text 120 309 label position; -#X msg 122 380 label_pos \$1 \$2; -#X text 171 330 1.x-offset; -#X text 171 351 2.y-offset; -#X obj 375 184 cnv 15 67 172 empty empty empty 20 12 0 14 -1 -66577 -0; -#X obj 376 185 cnv 15 65 170 empty empty empty 20 12 0 14 -261682 -66577 -0; -#N canvas 366 206 174 259 flash-time 0; -#X obj 68 180 pack; -#X obj 103 149 t b a; -#X obj 68 205 outlet; -#X obj 103 104 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-width empty -0 -8 0 12 -262144 -1 -1 15 256 0; -#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-height empty -0 -8 0 12 -262144 -1 -1 128 256 0; -#X connect 0 0 2 0; -#X connect 1 0 0 0; -#X connect 1 1 0 1; -#X connect 3 0 0 0; -#X connect 4 0 1 0; -#X coords 0 -1 1 1 48 42 2 100 100; -#X restore 12 56 pd flash-time; -#N canvas 366 206 174 259 flash-time 0; -#X obj 68 180 pack; -#X obj 103 149 t b a; -#X obj 68 205 outlet; -#X obj 103 104 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-bottom empty -0 -8 0 12 -262144 -1 -1 0 256 0; -#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-top empty 0 --8 0 12 -262144 -1 -1 127 256 0; -#X connect 0 0 2 0; -#X connect 1 0 0 0; -#X connect 1 1 0 1; -#X connect 3 0 0 0; -#X connect 4 0 1 0; -#X coords 0 -1 1 1 48 42 2 100 100; -#X restore 124 56 pd flash-time; -#N canvas 366 206 174 259 flash-time 0; -#X obj 68 180 pack; -#X obj 103 149 t b a; -#X obj 68 205 outlet; -#X obj 103 104 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-xlabel empty -0 -8 0 12 -262144 -1 -1 -2 256 0; -#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-ylabel empty -0 -8 0 12 -262144 -1 -1 -8 256 0; -#X connect 0 0 2 0; -#X connect 1 0 0 0; -#X connect 1 1 0 1; -#X connect 3 0 0 0; -#X connect 4 0 1 0; -#X coords 0 -1 1 1 48 42 2 100 100; -#X restore 122 329 pd flash-time; -#N canvas 366 206 174 259 flash-time 0; -#X obj 68 180 pack; -#X obj 103 149 t b a; -#X obj 68 205 outlet; -#X obj 103 104 nbx 3 14 0 2 0 0 \$0-dummy \$0-font empty 0 -8 0 12 --262144 -1 -1 0 256 0; -#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-font-size empty -0 -8 0 12 -262144 -1 -1 10 256 0; -#X connect 0 0 2 0; -#X connect 1 0 0 0; -#X connect 1 1 0 1; -#X connect 3 0 0 0; -#X connect 4 0 1 0; -#X coords 0 -1 1 1 48 42 2 100 100; -#X restore 244 329 pd flash-time; -#X text 9 449 preset-colors; -#X text 105 449 RGB-colors; -#X msg 12 555 color \$1 \$2 \$3; -#N canvas 364 205 306 317 flash-time 0; -#X obj 69 196 t b a; -#X obj 33 262 outlet; -#X obj 33 237 pack 0 0 0; -#X obj 120 197 t b a; -#X obj 103 104 nbx 3 14 0 29 0 0 \$0-dummy \$0-bg empty 0 -8 0 12 -262144 --1 -1 0 256 0; -#X obj 103 124 nbx 3 14 0 29 0 0 \$0-dummy \$0-front empty 0 -8 0 12 --262144 -1 -1 12 256 0; -#X obj 103 144 nbx 3 14 0 29 0 0 \$0-dummy \$0-label empty 0 -8 0 12 --262144 -1 -1 12 256 0; -#X connect 0 0 2 0; -#X connect 0 1 2 1; -#X connect 2 0 1 0; -#X connect 3 0 2 0; -#X connect 3 1 2 2; -#X connect 4 0 2 0; -#X connect 5 0 0 0; -#X connect 6 0 3 0; -#X coords 0 -1 1 1 48 62 2 100 100; -#X restore 12 470 pd flash-time; -#N canvas 0 0 306 317 flash-time 0; -#X obj 96 521 outlet; -#X obj 162 230 t b f; -#X obj 96 268 +; -#X obj 96 293 t b f; -#X obj 96 324 +; -#X obj 19 208 * -65536; -#X obj 96 208 * -256; -#X obj 162 208 * -1; -#X obj 96 355 - 1; -#X obj 96 385 list prepend 0; -#X obj 96 410 route 0 1 2; -#X obj 96 497 pack 0 0 0; -#X obj 115 456 t b a; -#X obj 168 455 t b a; -#X obj 104 124 vradio 15 1 0 3 empty empty empty 0 -8 0 10 -262144 --1 -1 0; -#X text 120 120 1.bg; -#X text 120 137 2.front; -#X text 120 153 3.label; -#X obj 103 105 nbx 3 14 0 255 0 0 \$0-dummy \$0-r empty 0 -8 0 10 -262144 --258113 -1 0 256 0; -#X obj 133 105 nbx 3 14 0 255 0 0 \$0-dummy \$0-g empty 0 -8 0 10 -262144 --13381 -1 0 256 0; -#X obj 163 105 nbx 3 14 0 255 0 0 \$0-dummy \$0-b empty 0 -8 0 10 -262144 --4160 -1 0 256 0; -#X connect 1 0 2 0; -#X connect 1 1 2 1; -#X connect 2 0 3 0; -#X connect 3 0 4 0; -#X connect 3 1 4 1; -#X connect 4 0 8 0; -#X connect 5 0 4 0; -#X connect 6 0 2 0; -#X connect 7 0 1 0; -#X connect 8 0 9 0; -#X connect 9 0 10 0; -#X connect 10 0 11 0; -#X connect 10 1 12 0; -#X connect 10 2 13 0; -#X connect 11 0 0 0; -#X connect 12 0 11 0; -#X connect 12 1 11 1; -#X connect 13 0 11 0; -#X connect 13 1 11 2; -#X connect 14 0 9 1; -#X connect 18 0 5 0; -#X connect 19 0 6 0; -#X connect 20 0 7 0; -#X coords 0 -1 1 1 102 74 2 100 100; -#X restore 109 470 pd flash-time; -#X text 61 472 1.bg; -#X text 61 492 2.front; -#X text 61 513 3.label; -#X text 318 449 delta; -#X text 218 449 position; -#X msg 219 541 pos \$1 \$2; -#X msg 319 541 delta \$1 \$2; -#X obj 319 518 list; -#X obj 319 471 bng 20 250 50 0 empty empty empty 17 7 0 10 -262144 --1 -1; -#X text 398 470 1.x-delta; -#X text 398 492 2.y-delta; -#N canvas 366 206 174 259 flash-time 0; -#X obj 68 180 pack; -#X obj 103 149 t b a; -#X obj 68 205 outlet; -#X obj 103 104 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-xpos empty 0 --8 0 12 -262144 -1 -1 391 256 0; -#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-ypos empty 0 --8 0 12 -262144 -1 -1 200 256 0; -#X connect 0 0 2 0; -#X connect 1 0 0 0; -#X connect 1 1 0 1; -#X connect 3 0 0 0; -#X connect 4 0 1 0; -#X coords 0 -1 1 1 48 42 2 100 100; -#X restore 219 471 pd flash-time; -#N canvas 366 206 174 259 flash-time 0; -#X obj 68 180 pack; -#X obj 103 149 t b a; -#X obj 68 205 outlet; -#X obj 103 104 nbx 3 14 -20 20 0 0 \$0-dummy \$0-xdelta empty 0 -8 -0 12 -262144 -1 -1 0 256 0; -#X obj 103 124 nbx 3 14 -20 20 0 0 \$0-dummy \$0-ydelta empty 0 -8 -0 12 -262144 -1 -1 0 256 0; -#X connect 0 0 2 0; -#X connect 1 0 0 0; -#X connect 1 1 0 1; -#X connect 3 0 0 0; -#X connect 4 0 1 0; -#X coords 0 -1 1 1 48 42 2 100 100; -#X restore 348 471 pd flash-time; -#X floatatom 392 337 5 0 0 0 - - -, f 5; -#X text 11 36 dimensions; -#X text 267 470 1.x-pos; -#X text 267 492 2.y-pos; -#X obj 12 135 s vsl_rcv; -#X obj 124 135 s vsl_rcv; -#X obj 235 135 s vsl_rcv; -#X obj 324 135 s vsl_rcv; -#X obj 12 270 s vsl_rcv; -#X obj 110 270 s vsl_rcv; -#X obj 237 270 s vsl_rcv; -#X obj 11 409 s vsl_rcv; -#X obj 122 409 s vsl_rcv; -#X obj 244 405 s vsl_rcv; -#X obj 12 580 s vsl_rcv; -#X obj 219 566 s vsl_rcv; -#X obj 319 566 s vsl_rcv; -#X obj 391 200 vsl 15 128 0 127 0 0 vsl_snd vsl_rcv mySlider -2 -8 -0 10 -262144 -33289 -33289 0 1; -#X text 8 2 [vslider] Set Properties through Messages; -#X connect 1 0 7 0; -#X connect 5 0 74 0; -#X connect 6 0 70 0; -#X connect 7 0 71 0; -#X connect 8 0 69 0; -#X connect 9 0 69 0; -#X connect 17 0 72 0; -#X connect 18 0 74 0; -#X connect 19 0 16 0; -#X connect 20 0 73 0; -#X connect 21 0 73 0; -#X connect 23 0 70 0; -#X connect 24 0 67 0; -#X connect 30 0 68 0; -#X connect 32 0 76 0; -#X connect 36 0 75 0; -#X connect 41 0 24 0; -#X connect 42 0 30 0; -#X connect 43 0 36 0; -#X connect 44 0 32 0; -#X connect 47 0 77 0; -#X connect 48 0 47 0; -#X connect 49 0 47 0; -#X connect 55 0 78 0; -#X connect 56 0 79 0; -#X connect 57 0 56 0; -#X connect 58 0 57 0; -#X connect 61 0 55 0; -#X connect 62 0 57 1; -#X connect 80 0 63 0; -#X restore 101 406 pd Setting_slider_properties_through_messages; -#X obj 57 213 ftom; -#X floatatom 57 237 9 0 0 0 - - -, f 9; -#X floatatom 104 213 9 0 0 0 - - -, f 9; -#X floatatom 57 84 9 0 0 0 - - -, f 9; -#X obj 57 106 mtof; -#X text 97 177 (0.01 pixels); -#X text 99 148 shift-click & drag; -#X text 99 163 for fine-tuning; -#X obj 57 132 vsl 15 73 55 3520 1 1 goo4_snd goo4_rcv log.freq. 20 -6 0 10 -261681 -260818 -90881 2244 1; -#X text 380 170 names. Right-click and; -#X text 380 155 send and receive names.; -#X text 379 186 choose "Properties" to; -#X text 380 200 set them \, or change them; -#X text 380 214 with messages (see below); -#X floatatom 250 216 4 0 0 0 - - -, f 4; -#X msg 309 69 set \$1; -#X floatatom 270 47 4 0 0 0 - - -, f 4; -#X obj 250 240 bng 15 250 50 0 empty empty empty 8 -8 0 10 -262144 --1 -1; -#X obj 250 47 bng 15 250 50 0 empty empty empty 8 -8 0 10 -262144 -1 --1; -#X floatatom 309 48 4 0 0 0 - - -, f 4; -#X floatatom 310 191 4 0 0 0 - - -, f 4; -#X floatatom 309 100 4 0 0 0 - - -, f 4; -#X obj 250 102 vsl 15 101 100 300 0 1 foo3_snd foo3_rcv empty 8 -8 -0 10 -225280 -1109 -1 5350 1; -#X obj 309 143 s foo3_rcv; -#X obj 310 169 r foo3_snd; -#X msg 309 121 set \$1; -#X obj 294 240 print; -#N canvas 276 200 290 224 once 0; -#X obj 38 24 inlet; -#X obj 38 91 outlet; -#X obj 38 69 t a b; -#X obj 38 47 spigot 1; -#X obj 97 47 0; -#X connect 0 0 3 0; -#X connect 2 0 1 0; -#X connect 2 1 4 0; -#X connect 3 0 2 0; -#X connect 4 0 3 1; -#X restore 294 216 pd once; -#X text 98 374 Special messages can be sent to [vslider] to change -its properties:; -#N canvas 65 102 428 434 vsl-creation-arguments 0; -#X text 22 226 For example \, click the msg-box to dynamically create -a hsl:; -#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 [vslider] Creation Arguments and Dynamic Patching; -#X obj 23 290 s pd-vsl-creation-arguments; -#X text 21 38 "vsl" can be called with 18 creation arguments. These -are not "optional" - all parameters must be filled or the gui-bng will -not instantiate correctly.; -#X text 21 85 vsl creation arguments: xSize ySize rangeBtm rangeTop -Logarithmic Init sendName receiveName Label labelXOff labelYOff Font# -fontSize bgColor foregroundColor lblColor sliderPosition steadyOnClick -; -#X text 22 143 note: sliderPosition is not the same as the initialization -value. To dynamically instantiate an hsl that initializes with a desired -value \, save an hsl in a patch and view it in a text editor to get -the right value for sliderPosition. Or \, refer to hslider_set in g_vslider.c -for conversion between sliderPosition and slider value.; -#X msg 23 248 obj 150 335 vsl 75 75 -1 1 0 1 send receive Merope 15 --9 0 12 7 13 21 4400 0; -#X connect 7 0 3 0; -#X restore 170 551 pd vsl-creation-arguments; -#X text 379 139 vslider has settable; -#X text 11 21 vertical gui-slider; -#X text 98 494 18; -#X text 168 494 - creating a [vslider] object without arguments sets -default values for its gui-properties. See the subpatch below to learn -how to dynamically instantiate a [bng] object with custom properties: -; -#X text 168 314 - a float updates the slider value and is sent to the -outlet.; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X text 98 356 list; -#X text 168 356 - a list is truncated to the first element.; -#X text 98 339 bang; -#X text 168 339 - output the current slider value.; -#X text 429 11 [vslider] or [vsl]; -#X connect 15 0 16 0; -#X connect 18 0 19 0; -#X connect 19 0 23 0; -#X connect 23 0 15 0; -#X connect 23 0 17 0; -#X connect 29 0 32 0; -#X connect 30 0 37 0; -#X connect 31 0 37 0; -#X connect 33 0 37 0; -#X connect 34 0 30 0; -#X connect 36 0 40 0; -#X connect 37 0 29 0; -#X connect 37 0 42 0; -#X connect 39 0 35 0; -#X connect 40 0 38 0; -#X connect 42 0 41 0; diff --git a/doc/pddp/vu-help.pd b/doc/pddp/vu-help.pd deleted file mode 100644 index 3f237d3f2..000000000 --- a/doc/pddp/vu-help.pd +++ /dev/null @@ -1,373 +0,0 @@ -#N canvas 429 34 558 622 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 vu 3 12 0 18 -204280 --1 0; -#X obj 0 287 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 488 283 494 344 META 0; -#X text 12 155 LIBRARY internal; -#X text 12 25 LICENSE SIBSD; -#X text 12 175 AUTHOR Thomas Musil; -#X text 12 195 WEBSITE; -#X text 12 5 KEYWORDS control GUI nonlocal; -#X text 12 45 DESCRIPTION gui-vu-meter-display; -#X text 12 65 INLET_0 float list bang size scale receive label label_pos -label_font color pos delta; -#X text 12 95 INLET_1 float; -#X text 12 115 OUTLET_0 float; -#X text 12 135 OUTLET_1 float; -#X text 12 215 RELEASE_DATE 2002; -#X text 12 235 HELP_PATCH_AUTHORS Jonathan Wilkes revised the patch -to conform to the PDDP template for Pd version 0.42.; -#X restore 500 597 pd META; -#X obj 0 435 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 489 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 572 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 207 509 428 126 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 [vu] Related Objects; -#X obj 22 91 x_all_guis bng tgl vsl hsl hradio vradio vu cnv nbx; -#X text 20 67 All iem-gui objects:; -#X obj 23 43 env~; -#X restore 92 597 pd Related_objects; -#X obj 78 296 cnv 17 3 90 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X text 98 295 float; -#X obj 78 444 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 396 cnv 17 3 30 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 98 312 list; -#X text 98 396 float; -#X text 98 412 list; -#X text 168 312 - a 2-item list will be distributed to the two inlets -; -#X text 98 444 float; -#X obj 78 466 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; -#X text 98 466 float; -#N canvas 76 117 428 416 vu-creation-arguments 0; -#X obj 25 237 s pd-vu-creation-arguments; -#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 [vu] Creation Arguments; -#X text 22 163 For example \, click the msg-box to dynamically create -a [vu]:; -#X text 23 98 [vu] creation arguments: xSize ySize receiveName Label -labelXOff labelYOff font# fontSize bgColor labelColor Scale Unknown(0) -; -#X text 22 38 [vu] can be called with 12 creation arguments. These -are not "optional" - all parameters must be filled or the gui-bng will -not instantiate correctly.; -#X msg 25 195 obj 160 280 vu 15 120 fff Elektra -15 -12 0 12 26 12 -0 0; -#X connect 6 0 0 0; -#X restore 170 549 pd vu-creation-arguments; -#N canvas 75 10 429 610 Changing_GUI_Properties 0; -#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; -#X floatatom 130 62 1 0 1 0 - #0-scale -, f 1; -#X text 124 38 display scale; -#X msg 130 116 scale \$1; -#X obj 130 141 s vu_rcv; -#X text 213 38 change receive name; -#X obj 215 141 s vu_rcv; -#X msg 215 62 receive vu12_rcv; -#X obj 231 114 s vu12_rcv; -#X msg 231 89 receive vu_rcv; -#X msg 339 61 label blabla; -#X obj 339 141 s vu_rcv; -#X text 339 38 label; -#N canvas 378 326 151 256 init 0; -#X obj 16 11 loadbang; -#X obj 16 42 f \$0; -#X msg 16 73 \; \$1-xpos 330 \; \$1-ypos 245 \; \$1-scale 1 \; \$1-xlabel --1 \; \$1-ylabel -8 \; \$1-label 12 \; \$1-font-size 10 \; \$1-width -15 \; \$1-height 120 \; \$1-font 0 \; \$1-bg 12 \; \$1-bg 12; -#X connect 0 0 1 0; -#X connect 1 0 2 0; -#X restore 352 404 pd init; -#N canvas 366 206 174 259 flash-time 0; -#X obj 68 180 pack; -#X obj 103 149 t b a; -#X obj 68 205 outlet; -#X obj 103 104 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-width empty -0 -8 0 12 -262144 -1 -1 15 256 0; -#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-height empty -0 -8 0 12 -262144 -1 -1 120 256 0; -#X connect 0 0 2 0; -#X connect 1 0 0 0; -#X connect 1 1 0 1; -#X connect 3 0 0 0; -#X connect 4 0 1 0; -#X coords 0 -1 1 1 48 42 2 100 100; -#X restore 22 59 pd flash-time; -#X text 19 38 dimensions; -#X text 71 61 1.width; -#X text 71 81 2.height; -#X msg 22 116 size \$1 \$2; -#X obj 22 141 s vu_rcv; -#X text 20 175 label position; -#X text 152 175 font properties; -#X msg 22 250 label_pos \$1 \$2; -#X msg 154 250 label_font \$1 \$2; -#X text 203 199 1.font(0-2); -#X text 203 220 2.height; -#X text 71 198 1.x-offset; -#X text 71 219 2.y-offset; -#N canvas 366 206 174 259 flash-time 0; -#X obj 68 180 pack; -#X obj 103 149 t b a; -#X obj 68 205 outlet; -#X obj 103 104 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-xlabel empty -0 -8 0 12 -262144 -1 -1 -1 256 0; -#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-ylabel empty -0 -8 0 12 -262144 -1 -1 -8 256 0; -#X connect 0 0 2 0; -#X connect 1 0 0 0; -#X connect 1 1 0 1; -#X connect 3 0 0 0; -#X connect 4 0 1 0; -#X coords 0 -1 1 1 48 42 2 100 100; -#X restore 22 197 pd flash-time; -#N canvas 366 206 174 259 flash-time 0; -#X obj 68 180 pack; -#X obj 103 149 t b a; -#X obj 68 205 outlet; -#X obj 103 104 nbx 3 14 0 2 0 0 \$0-dummy \$0-font empty 0 -8 0 12 --262144 -1 -1 0 256 0; -#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-font-size empty -0 -8 0 12 -262144 -1 -1 10 256 0; -#X connect 0 0 2 0; -#X connect 1 0 0 0; -#X connect 1 1 0 1; -#X connect 3 0 0 0; -#X connect 4 0 1 0; -#X coords 0 -1 1 1 48 42 2 100 100; -#X restore 154 197 pd flash-time; -#X text 22 310 preset-colors; -#X text 131 310 RGB-colors; -#N canvas 364 205 169 292 flash-time 0; -#X obj 69 196 t b a; -#X obj 33 262 outlet; -#X obj 103 104 nbx 3 14 0 29 0 0 \$0-dummy \$0-bg empty 0 -8 0 12 -262144 --1 -1 12 256 0; -#X obj 103 124 nbx 3 14 0 29 0 0 \$0-dummy \$0-label empty 0 -8 0 12 --262144 -1 -1 12 256 0; -#X obj 33 237 pack 0 0; -#X connect 0 0 4 0; -#X connect 0 1 4 1; -#X connect 2 0 4 0; -#X connect 3 0 0 0; -#X connect 4 0 1 0; -#X coords 0 -1 1 1 48 42 2 100 100; -#X restore 22 332 pd flash-time; -#N canvas 0 0 306 317 flash-time 0; -#X obj 96 521 outlet; -#X obj 162 230 t b f; -#X obj 96 268 +; -#X obj 96 293 t b f; -#X obj 96 324 +; -#X obj 19 208 * -65536; -#X obj 96 208 * -256; -#X obj 162 208 * -1; -#X obj 96 355 - 1; -#X obj 96 385 list prepend 0; -#X obj 115 456 t b a; -#X obj 104 124 vradio 15 1 0 2 empty empty empty 0 -8 0 10 -262144 --1 -1 0; -#X text 120 120 1.bg; -#X obj 103 105 nbx 3 14 0 255 0 0 \$0-dummy \$0-r empty 0 -8 0 10 -262144 --258113 -1 0 256 0; -#X obj 133 105 nbx 3 14 0 255 0 0 \$0-dummy \$0-g empty 0 -8 0 10 -262144 --13381 -1 0 256 0; -#X obj 163 105 nbx 3 14 0 255 0 0 \$0-dummy \$0-b empty 0 -8 0 10 -262144 --4160 -1 0 256 0; -#X text 120 137 2.label; -#X obj 96 410 route 0 1; -#X obj 96 497 pack 0 0; -#X connect 1 0 2 0; -#X connect 1 1 2 1; -#X connect 2 0 3 0; -#X connect 3 0 4 0; -#X connect 3 1 4 1; -#X connect 4 0 8 0; -#X connect 5 0 4 0; -#X connect 6 0 2 0; -#X connect 7 0 1 0; -#X connect 8 0 9 0; -#X connect 9 0 17 0; -#X connect 10 0 18 0; -#X connect 10 1 18 1; -#X connect 11 0 9 1; -#X connect 13 0 5 0; -#X connect 14 0 6 0; -#X connect 15 0 7 0; -#X connect 17 0 18 0; -#X connect 17 1 10 0; -#X connect 18 0 0 0; -#X coords 0 -1 1 1 102 58 2 100 100; -#X restore 132 332 pd flash-time; -#X text 71 334 1.bg; -#X text 71 354 2.label; -#X msg 22 407 color \$1 \$2; -#X text 153 463 delta; -#X text 21 463 position; -#X msg 22 560 pos \$1 \$2; -#X msg 154 560 delta \$1 \$2; -#X obj 154 536 list; -#X obj 154 485 bng 20 250 50 0 empty empty empty 17 7 0 10 -262144 --1 -1; -#X text 70 484 1.x-position; -#X text 70 506 2.y-position; -#X text 233 484 1.x-delta; -#X text 233 506 2.y-delta; -#N canvas 366 206 174 259 flash-time 0; -#X obj 68 180 pack; -#X obj 103 149 t b a; -#X obj 68 205 outlet; -#X obj 103 104 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-xpos empty 0 --8 0 12 -262144 -1 -1 330 256 0; -#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-ypos empty 0 --8 0 12 -262144 -1 -1 245 256 0; -#X connect 0 0 2 0; -#X connect 1 0 0 0; -#X connect 1 1 0 1; -#X connect 3 0 0 0; -#X connect 4 0 1 0; -#X coords 0 -1 1 1 48 42 2 100 100; -#X restore 22 485 pd flash-time; -#N canvas 366 206 174 259 flash-time 0; -#X obj 68 180 pack; -#X obj 103 149 t b a; -#X obj 68 205 outlet; -#X obj 103 104 nbx 3 14 -20 20 0 0 \$0-dummy \$0-xdelta empty 0 -8 -0 12 -262144 -1 -1 0 256 0; -#X obj 103 124 nbx 3 14 -20 20 0 0 \$0-dummy \$0-ydelta empty 0 -8 -0 12 -262144 -1 -1 0 256 0; -#X connect 0 0 2 0; -#X connect 1 0 0 0; -#X connect 1 1 0 1; -#X connect 3 0 0 0; -#X connect 4 0 1 0; -#X coords 0 -1 1 1 48 42 2 100 100; -#X restore 183 485 pd flash-time; -#X obj 296 213 cnv 15 102 177 empty empty empty 20 12 0 14 -1 -66577 -0; -#X obj 297 214 cnv 15 100 175 empty empty empty 20 12 0 14 -261682 --66577 0; -#X obj 22 275 s vu_rcv; -#X obj 154 275 s vu_rcv; -#X obj 22 432 s vu_rcv; -#X obj 154 585 s vu_rcv; -#X obj 22 585 s vu_rcv; -#X text 6 2 [vu] Changing Properties through Messages; -#X msg 349 114 label my-vu; -#X obj 330 245 vu 15 120 vu_rcv my-vu -1 -8 0 10 -33289 -33289 1 0 -; -#X connect 1 0 3 0; -#X connect 3 0 4 0; -#X connect 7 0 6 0; -#X connect 9 0 8 0; -#X connect 10 0 11 0; -#X connect 14 0 18 0; -#X connect 18 0 19 0; -#X connect 22 0 51 0; -#X connect 23 0 52 0; -#X connect 28 0 22 0; -#X connect 29 0 23 0; -#X connect 32 0 36 0; -#X connect 33 0 36 0; -#X connect 36 0 53 0; -#X connect 39 0 55 0; -#X connect 40 0 54 0; -#X connect 41 0 40 0; -#X connect 42 0 41 0; -#X connect 47 0 39 0; -#X connect 48 0 41 1; -#X connect 57 0 11 0; -#X restore 172 375 pd Changing_GUI_Properties; -#X text 97 345 see the following subpatch for messages that change -the gui-properties of [vu]:; -#X text 168 493 - creating a [vu] without any arguments will set default -values for all gui-properties. See the subpatch below to learn how -to dynamically instantiate a [vu] object with custom properties:; -#X text 170 239 Use the UP- \, DOWN- \, LEFT- or RIGHT-key to move -a selected gui-object. Right-click and choose "Properties" to modify -its appearance.; -#X text 341 111 and receive names. Right-; -#X text 341 126 click and choose; -#X text 340 142 "Properties" to set them \,; -#X text 341 156 or change them with messages; -#X text 341 170 (see the subpatch below); -#X floatatom 259 90 7 -110 20 1 dB - -, f 7; -#X obj 42 48 tgl 15 1 empty empty empty 8 -8 0 10 -262144 -1 -1 0 1 -; -#X obj 43 125 vu 15 120 foo7_rcv vu-meter 60 0 0 10 -1 -355 1 0; -#X floatatom 42 259 6 0 0 1 dB - -, f 6; -#X floatatom 104 259 6 0 0 1 dB - -, f 6; -#X text 108 68 <list> of rms \, peak; -#X obj 259 197 s foo7_rcv; -#X obj 259 168 pack 0 0; -#X floatatom 277 113 7 -110 20 1 dB - -, f 7; -#X obj 277 138 t b f; -#X floatatom 52 90 7 -110 20 1 dB - -, f 7; -#X floatatom 120 90 7 -110 20 1 dB - -, f 7; -#N canvas 44 136 290 278 source 0; -#X obj 40 95 random 102; -#X obj 40 171 - 101; -#X obj 40 205 pack 0 0; -#X obj 40 45 metro 300; -#X obj 40 69 t b b; -#X obj 133 95 random 20; -#X obj 40 117 t f f; -#X obj 91 147 +; -#X obj 91 172 - 101; -#X obj 40 21 inlet; -#X obj 40 250 outlet; -#X obj 100 249 s fff; -#X obj 159 249 s vu_rcv; -#X connect 0 0 6 0; -#X connect 1 0 2 0; -#X connect 2 0 10 0; -#X connect 2 0 11 0; -#X connect 2 0 12 0; -#X connect 3 0 4 0; -#X connect 4 0 0 0; -#X connect 4 1 5 0; -#X connect 5 0 7 1; -#X connect 6 0 1 0; -#X connect 6 1 7 0; -#X connect 7 0 8 0; -#X connect 8 0 2 1; -#X connect 9 0 3 0; -#X restore 42 68 pd source; -#X text 340 95 [vu] has settable send; -#X text 11 23 gui-vu-meter-display; -#X text 98 493 12; -#X text 168 295 - rms level.; -#X text 168 396 - peak-level.; -#X text 168 412 - a list will be truncated to the first element.; -#X text 168 444 - rms level.; -#X text 168 466 - peak-level.; -#X text 98 328 bang; -#X text 168 328 - a bang will output the current values of the inlets. -; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X connect 29 0 36 0; -#X connect 30 0 41 0; -#X connect 31 0 32 0; -#X connect 31 1 33 0; -#X connect 36 0 35 0; -#X connect 37 0 38 0; -#X connect 38 0 36 0; -#X connect 38 1 36 1; -#X connect 39 0 31 0; -#X connect 40 0 31 1; -#X connect 41 0 31 0; diff --git a/doc/pddp/wrap~-help.pd b/doc/pddp/wrap~-help.pd deleted file mode 100644 index 2d3dad88d..000000000 --- a/doc/pddp/wrap~-help.pd +++ /dev/null @@ -1,68 +0,0 @@ -#N canvas 427 34 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 wrap~ 3 12 0 18 --204280 -1 0; -#X obj 0 428 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 491 283 494 344 META 0; -#X text 12 105 LIBRARY internal; -#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 125 AUTHOR Miller Puckette; -#X text 12 185 HELP_PATCH_AUTHORS Updated for Pd version 0.33. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 5 KEYWORDS signal; -#X text 12 45 DESCRIPTION remainder modulo 1; -#X text 12 65 INLET_0 signal; -#X text 12 85 OUTLET_0 signal; -#X text 12 165 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 503 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 540 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 568 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#X text 98 544 (none); -#N canvas 214 518 428 109 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 obj 22 43 wrap; -#X text 8 2 [wrap~] Related Objects; -#X restore 102 597 pd Related_objects; -#X obj 78 437 cnv 17 3 55 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 512 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 509 10 wrap~; -#X obj 94 243 metro 500; -#X floatatom 78 144 0 0 0 0 - - -; -#X floatatom 78 290 0 0 0 0 - - -; -#X obj 78 267 snapshot~; -#X obj 78 170 sig~; -#X obj 78 194 wrap~; -#X obj 94 218 loadbang; -#X text 111 144 <- shift-drag here to get non-integers to try; -#X text 98 436 signal; -#X text 98 457 float; -#X text 98 477 list; -#X text 168 477 - a list will be truncated to the first item.; -#X text 98 511 signal; -#X text 11 23 remainder modulo 1; -#X text 168 436 - the incoming signal.; -#X text 168 457 - a float will automatically be converted to a signal. -; -#X text 74 317 [wrap~] gives the difference between the input and the -largest integer not exceeding it (for positive numbers this is the -fractional part).; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 482 55 pddp/dsp; -#X connect 12 0 15 0; -#X connect 13 0 16 0; -#X connect 15 0 14 0; -#X connect 16 0 17 0; -#X connect 17 0 15 0; -#X connect 18 0 12 0; diff --git a/doc/pddp/writesf~-help.pd b/doc/pddp/writesf~-help.pd deleted file mode 100644 index 60439e9bb..000000000 --- a/doc/pddp/writesf~-help.pd +++ /dev/null @@ -1,98 +0,0 @@ -#N canvas 431 36 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 writesf~ 3 12 0 -18 -204280 -1 0; -#X obj 0 267 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; -#N canvas 488 285 494 344 META 0; -#X text 12 105 LIBRARY internal; -#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 12 25 LICENSE SIBSD; -#X text 12 125 AUTHOR Miller Puckette; -#X text 12 185 HELP_PATCH_AUTHORS Updated for Pd version 0.37. Jonathan -Wilkes revised the patch to conform to the PDDP template for Pd version -0.42.; -#X text 12 5 KEYWORDS signal; -#X text 12 45 DESCRIPTION write audio signals to a soundfile; -#X text 12 65 INLET_0 signal open start stop print; -#X text 12 85 INLET_N signal; -#X text 12 165 RELEASE_DATE 1997; -#X restore 500 597 pd META; -#X obj 0 498 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 526 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 567 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#N canvas 216 514 428 109 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 [writesf~] Related Objects; -#X obj 22 43 readsf~; -#X obj 80 43 soundfiler; -#X restore 102 597 pd Related_objects; -#X obj 78 276 cnv 17 3 183 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 465 cnv 17 3 17 empty \$0-pddp.cnv.let.n n 5 9 0 16 -228856 --162280 0; -#X obj 486 10 writesf~; -#X text 98 502 (none); -#X msg 77 179 print; -#X msg 9 103 bang; -#X msg 76 135 start; -#X msg 78 157 stop; -#X obj 9 134 del 1000; -#X obj 67 223 writesf~ 2; -#X msg 67 65 open /tmp/foo.wav; -#X obj 81 201 osc~ 440; -#X msg 67 111 open -bytes 4 /tmp/foo.wav; -#X text 176 64 create a new 16-bit soundfile; -#X text 233 88 create 24-bit soundfile; -#X text 232 111 create 32-bit floating-point soundfile; -#X msg 67 88 open -bytes 3 /tmp/foo.wav; -#X text 11 23 write audio signals to a soundfile; -#X text 98 275 signal; -#X text 98 292 open; -#X text 98 415 start; -#X text 98 430 stop; -#X text 98 445 print; -#X text 98 464 signal; -#X text 167 464 - an additional inlet is created for each channel specified -by the creation argument.; -#X text 202 328 -wave \, -nextstep \, -aiff; -#X text 203 343 -big \, -little (nextstep only!); -#X text 203 358 -bytes <2 \, 3 \, or 4>; -#X text 203 374 -rate <sample rate>; -#X text 167 389 (setting sample rate will affect the soundfile header -but the file will _not_ be resampled.); -#X text 168 292 - the "open" message creates a new soundfile that can -be written to. The "open" message may take flag-style arguments as -follows:; -#X text 168 415 - start streaming audio to disk.; -#X text 168 430 - stop streaming audio to disk.; -#X text 149 206 The soundfile is 2- or 3-byte fixed point ("pcm") or -4-byte floating-point. The soundfile format is determined by the file -extent ("foo.wav" \, "foo.aiff" \, or "foo.snd").; -#X text 149 138 [writesf~] creates a subthread whose task is to write -audio streams to disk. You need not provide any disk access time between -"open" and "start" \, but between "stop" and the next "open" you must -give the object time to flush all the output to disk.; -#X text 168 445 - print debugging information.; -#X text 168 275 - the incoming signal is written to the file.; -#X text 168 544 - the creation argument is the number of channels (1 -to 64).; -#X text 80 544 1) float; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 478 54 pddp/dsp; -#X connect 12 0 17 0; -#X connect 13 0 14 0; -#X connect 13 0 16 0; -#X connect 14 0 17 0; -#X connect 15 0 17 0; -#X connect 16 0 15 0; -#X connect 18 0 17 0; -#X connect 19 0 17 0; -#X connect 20 0 17 0; -#X connect 24 0 17 0; diff --git a/doc/pddp/x_all_guis.pd b/doc/pddp/x_all_guis.pd deleted file mode 100644 index 954f8e5a7..000000000 --- a/doc/pddp/x_all_guis.pd +++ /dev/null @@ -1,19 +0,0 @@ -#N canvas 428 44 290 271 10; -#X obj 23 31 bng 15 250 50 0 \$1 \$1 empty 20 8 0 8 -262144 -1 -1; -#X obj 23 63 tgl 15 1.04858e+06 \$2 \$2 empty 20 8 0 8 -262144 -1 -1 -0 1; -#X obj 22 95 vsl 15 128 0 127 0 1.04858e+06 \$3 \$3 empty 20 8 0 8 --262144 -1 -1 0 1; -#X obj 65 30 hsl 128 15 0 127 0 0 \$4 \$4 empty 20 8 0 8 -262144 -1 --1 0 1; -#X obj 63 63 hdl 15 1 2.6624e+06 8 \$5 \$5 empty 20 8 192 8 -262144 --1 -1 0; -#X obj 62 99 vu 15 120 \$6 empty 35 8 0 8 -66577 -1 1 0; -#X obj 115 99 cnv 15 100 60 \$7 \$7 \$7 20 12 0 14 -233017 -66577 1.04858e+06 -; -#X obj 41 308 inlet; -#X obj 41 334 outlet; -#X obj 227 30 vdl 15 1 4.79232e+06 8 \$9 \$9 empty 20 8 192 8 -262144 --1 -1 0; -#X obj 116 176 nbx 5 14 -1e+37 1e+37 0 0 \$8 \$8 empty 45 7 0 10 -262144 --1 -1 0 256 0; diff --git a/doc/pddp/Nmop~3pIsdn~tno9V~llV.pd b/pd/doc/5.reference/Nmop~3pIsdn~tno9V~llV.pd similarity index 100% rename from doc/pddp/Nmop~3pIsdn~tno9V~llV.pd rename to pd/doc/5.reference/Nmop~3pIsdn~tno9V~llV.pd diff --git a/doc/pddp/abs-help.pd b/pd/doc/5.reference/abs-help.pd similarity index 100% rename from doc/pddp/abs-help.pd rename to pd/doc/5.reference/abs-help.pd diff --git a/pd/doc/5.reference/acoustics-help.pd b/pd/doc/5.reference/acoustics-help.pd index de3e6f22c..fb51d40fa 100644 --- a/pd/doc/5.reference/acoustics-help.pd +++ b/pd/doc/5.reference/acoustics-help.pd @@ -1,47 +1,100 @@ -#N canvas 0 466 571 483 12; -#X obj 32 393 ftom; -#X obj 8 10 mtof; -#X obj 32 341 mtof; -#X floatatom 32 313 0 0 0 0 - - -; -#X floatatom 32 368 0 0 0 0 - - -; -#X obj 64 10 ftom; -#X floatatom 32 417 0 0 0 0 - - -; -#X obj 120 11 dbtorms; -#X obj 196 11 rmstodb; -#X obj 275 11 dbtopow; -#X obj 352 11 powtodb; -#X floatatom 164 309 0 0 0 0 - - -; -#X floatatom 164 364 0 0 0 0 - - -; -#X floatatom 164 413 0 0 0 0 - - -; -#X obj 164 337 dbtorms; -#X obj 164 389 rmstodb; -#X floatatom 278 310 0 0 0 0 - - -; -#X floatatom 278 365 0 0 0 0 - - -; -#X floatatom 278 414 0 0 0 0 - - -; -#X obj 278 338 dbtopow; -#X obj 278 390 powtodb; -#X text 23 245 Finally \, dbtopow and powtodb convert decibels to and -from power units \, equal to the square of the "RMS" amplitude.; -#X text 304 448 updated for pd version 0.40.; -#X text 21 53 The mtof object transposes a midi value into a frequency -in Hertz \, so that "69" goes to "440". You can specify microtonal -pitches as in "69.5" (a quarter tone higher than 69). Ftom does the -reverse. A frequency of zero Hertz is given a MIDI value of -1500 (strictly -speaking \, it is negative infinity.); -#X text 22 149 The dbtorms and rmstodb objects convert from decibels -to linear ("RMS") amplitude \, so that 100 dB corresponds to an "RMS" -of 1 Zero amplitude (strictly speaking \, minus infinity dB) is clipped -to zero dB \, and zero dB \, which should correspond to 1e-04 in "RMS" -\, is instead rounded down to zero.; -#X connect 0 0 6 0; -#X connect 2 0 4 0; -#X connect 3 0 2 0; -#X connect 4 0 0 0; -#X connect 11 0 14 0; -#X connect 12 0 15 0; -#X connect 14 0 12 0; -#X connect 15 0 13 0; -#X connect 16 0 19 0; -#X connect 17 0 20 0; -#X connect 19 0 17 0; -#X connect 20 0 18 0; +#N canvas 171 163 561 481 10; +#X obj 0 451 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 acoustics 3 12 0 +18 -204280 -1 0; +#X obj 0 289 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 317 389 404 227 META 0; +#X text 12 85 LIBRARY internal; +#X text 12 125 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 45 LICENSE SIBSD; +#X text 12 105 AUTHOR Miller Puckette; +#X text 12 165 HELP_PATCH_AUTHORS Updated for pd version 0.40. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 25 KEYWORDS control conversion MIDI; +#X text 12 5 NAME mtof ftom dbtorms rmstodb dbtopow powtodb; +#X text 12 65 DESCRIPTION control objects for conversion; +#X text 12 145 RELEASE_DATE 1997; +#X restore 500 453 pd META; +#X obj 0 359 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 392 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 421 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#X obj 78 298 cnv 17 3 55 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 396 (none); +#N canvas 79 451 428 163 Related_objects 0; +#X text 19 37 Control objects for conversion:; +#X obj 59 66 dbtorms; +#X obj 113 66 rmstodb; +#X obj 167 66 dbtopow; +#X obj 222 66 powtodb; +#X obj 22 125 mtof~; +#X obj 67 125 ftom~; +#X obj 110 125 dbtorms~; +#X obj 175 125 rmstodb~; +#X obj 241 125 dbtopow~; +#X obj 303 125 powtodb~; +#X text 19 102 Signal objects for conversion:; +#X obj 22 66 mtof; +#X obj 0 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 7 1 [ftom] Related Objects; +#X restore 221 453 pd Related_objects; +#X obj 78 368 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 297 float; +#X text 98 324 list; +#X text 98 368 float; +#X text 158 324 - lists will be truncated \, and the first element +will be used as input.; +#X obj 392 203 ftom; +#X obj 392 151 mtof; +#X floatatom 392 123 0 0 0 0 - - -; +#X floatatom 392 178 0 0 0 0 - - -; +#X floatatom 392 227 0 0 0 0 - - -; +#X floatatom 231 123 0 0 0 0 - - -; +#X floatatom 231 178 0 0 0 0 - - -; +#X floatatom 231 227 0 0 0 0 - - -; +#X obj 231 151 dbtorms; +#X obj 231 203 rmstodb; +#X floatatom 58 123 0 0 0 0 - - -; +#X floatatom 58 178 0 0 0 0 - - -; +#X floatatom 58 227 0 0 0 0 - - -; +#X obj 58 151 dbtopow; +#X obj 58 203 powtodb; +#X obj 258 10 mtof; +#X obj 294 10 ftom; +#X obj 330 11 dbtorms; +#X obj 386 11 rmstodb; +#X obj 440 11 dbtopow; +#X obj 497 11 powtodb; +#X text 11 23 control objects for conversion; +#X obj 110 150 pddp/pddplink dbtopow-help.pd -text dbtopow-help; +#X obj 110 204 pddp/pddplink powtodb-help.pd -text powtodb-help; +#X obj 282 150 pddp/pddplink dbtorms-help.pd -text dbtorms-help; +#X obj 282 204 pddp/pddplink rmstodb-help.pd -text rmstodb-help; +#X obj 426 150 pddp/pddplink ftom-help.pd -text ftom-help; +#X obj 426 204 pddp/pddplink mtof-help.pd -text mtof-help; +#X text 158 297 - the incoming value.; +#X obj 98 425 pddp/pddplink all_about_acoustic_conversions.pd; +#X text 87 79 Click on the links next to each object for more help: +; +#X obj 4 453 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X connect 15 0 19 0; +#X connect 16 0 18 0; +#X connect 17 0 16 0; +#X connect 18 0 15 0; +#X connect 20 0 23 0; +#X connect 21 0 24 0; +#X connect 23 0 21 0; +#X connect 24 0 22 0; +#X connect 25 0 28 0; +#X connect 26 0 29 0; +#X connect 28 0 26 0; +#X connect 29 0 27 0; diff --git a/pd/doc/5.reference/acoustics~-help.pd b/pd/doc/5.reference/acoustics~-help.pd index f7515339d..5a1b63429 100644 --- a/pd/doc/5.reference/acoustics~-help.pd +++ b/pd/doc/5.reference/acoustics~-help.pd @@ -1,81 +1,124 @@ -#N canvas 35 42 813 458 12; -#X obj 158 118 mtof~; -#X obj 158 174 snapshot~; -#X obj 698 132 metro 100; -#X floatatom 158 205 0 0 0; -#X obj 49 174 snapshot~; -#X floatatom 49 55 0 0 0; -#X floatatom 49 205 0 0 0; -#X obj 49 118 ftom~; -#X obj 264 174 snapshot~; -#X floatatom 264 205 0 0 0; -#X obj 264 118 dbtorms~; -#X obj 697 58 loadbang; -#X msg 709 88 \; pd dsp 1; -#X obj 49 86 sig~; -#X floatatom 158 55 0 0 0; -#X obj 158 86 sig~; -#X floatatom 264 54 0 0 0; -#X obj 264 86 sig~; -#X obj 492 172 snapshot~; -#X floatatom 492 203 0 0 0; -#X obj 383 172 snapshot~; -#X floatatom 383 53 0 0 0; -#X floatatom 383 203 0 0 0; -#X obj 607 172 snapshot~; -#X floatatom 607 203 0 0 0; -#X obj 383 84 sig~; -#X floatatom 492 53 0 0 0; -#X obj 492 84 sig~; -#X floatatom 607 53 0 0 0; -#X obj 607 84 sig~; -#X obj 383 115 rmstodb~; -#X obj 492 115 dbtopow~; -#X obj 607 115 powtodb~; -#X obj 17 10 mtof~; -#X text 70 11 (etc) - conversions for audio signals; -#X text 60 400 see also:; -#X obj 145 400 mtof; -#X text 192 400 (etc.); -#X text 547 416 updated for Pd version 0.33; -#X text 43 241 These objects convert MIDI pitch to frequency and back -\, and dB to and from RMS and power. THey take audio signals as input -and output (and work sample by sample.) Since they call library math -functions \, they may be much more expensive than other workaday tilde -objects such as *~ and osc~ \, depending on your hardware and math -library.; -#X text 41 343 Boundary conditions are handled "reasonably". 100 db -is assigned an RMS of 1 \, and dbtorms~ and dbtopow~ output true zero -for 0 dB and less.; -#X connect 0 0 1 0; -#X connect 1 0 3 0; -#X connect 2 0 1 0; -#X connect 2 0 8 0; -#X connect 2 0 4 0; -#X connect 2 0 20 0; -#X connect 2 0 18 0; -#X connect 2 0 23 0; -#X connect 4 0 6 0; -#X connect 5 0 13 0; -#X connect 7 0 4 0; -#X connect 8 0 9 0; -#X connect 10 0 8 0; -#X connect 11 0 2 0; -#X connect 11 0 12 0; -#X connect 13 0 7 0; -#X connect 14 0 15 0; -#X connect 15 0 0 0; +#N canvas 426 33 558 622 10; +#X obj 0 595 cnv 15 550 21 empty \$0-pddp.cnv.footer empty 20 12 0 +14 -228856 -66577 0; +#X obj 0 0 cnv 15 550 40 empty \$0-pddp.cnv.header (acoustics~) 3 12 +0 18 -204280 -1 0; +#X obj 0 424 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 569 391 408 239 META 0; +#X text 12 85 LIBRARY internal; +#X text 12 125 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 45 LICENSE SIBSD; +#X text 12 105 AUTHOR Miller Puckette; +#X text 12 165 HELP_PATCH_AUTHORS Updated for pd version 0.40. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 25 KEYWORDS signal conversion MIDI; +#X text 12 65 DESCRIPTION signal objects for conversion; +#X text 12 5 NAME mtof~ ftom~ dbtorms~ rmstodb~ dbtopow~ powtodb~; +#X text 12 145 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 499 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 536 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 565 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#X obj 78 433 cnv 17 3 55 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 540 (none); +#N canvas 339 468 428 163 Related_objects 0; +#X text 19 37 Control objects for conversion:; +#X obj 59 66 dbtorms; +#X obj 113 66 rmstodb; +#X obj 167 66 dbtopow; +#X obj 222 66 powtodb; +#X obj 22 125 mtof~; +#X obj 67 125 ftom~; +#X obj 110 125 dbtorms~; +#X obj 175 125 rmstodb~; +#X obj 241 125 dbtopow~; +#X obj 303 125 powtodb~; +#X text 19 102 Signal objects for conversion:; +#X obj 22 66 mtof; +#X obj 0 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 7 1 (acoustics) Related Objects; +#X restore 223 598 pd Related_objects; +#X obj 78 508 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 11 23 signal objects for conversion; +#X text 98 432 signal; +#X text 98 508 signal; +#X text 158 508 - the outgoing signal.; +#X text 158 432 - the incoming signal.; +#X floatatom 68 136 0 0 0 0 - - -; +#X obj 68 160 dbtopow~; +#X obj 67 217 snapshot~; +#X floatatom 67 246 0 0 0 0 - - -; +#X obj 67 294 powtodb~; +#X obj 67 341 snapshot~; +#X floatatom 67 368 0 0 0 0 - - -; +#X obj 237 11 mtof~; +#X obj 276 11 ftom~; +#X obj 315 11 dbtorms~; +#X obj 372 11 rmstodb~; +#X obj 429 11 dbtopow~; +#X obj 486 11 powtodb~; +#X floatatom 248 136 0 0 0 0 - - -; +#X obj 247 217 snapshot~; +#X floatatom 247 246 0 0 0 0 - - -; +#X obj 247 341 snapshot~; +#X floatatom 247 368 0 0 0 0 - - -; +#X obj 248 160 dbtorms~; +#X obj 247 294 rmstodb~; +#X floatatom 418 136 0 0 0 0 - - -; +#X obj 417 217 snapshot~; +#X floatatom 417 246 0 0 0 0 - - -; +#X obj 417 341 snapshot~; +#X floatatom 417 368 0 0 0 0 - - -; +#X obj 418 160 ftom~; +#X obj 417 294 mtof~; +#X obj 29 190 bang~; +#X obj 209 190 bang~; +#X obj 379 190 bang~; +#X obj 438 180 pddp/pddplink ftom~-help.pd -text ftom~-help; +#X obj 88 314 pddp/pddplink powtodb~-help.pd -text powtodb~-help; +#X obj 268 314 pddp/pddplink rmstodb~-help.pd -text rmstodb~-help; +#X obj 438 314 pddp/pddplink mtof~-help.pd -text mtof~-help; +#X obj 268 180 pddp/pddplink dbtorms~-help.pd -text dbtorms~-help; +#X obj 88 180 pddp/pddplink dbtopow~-help.pd -text dbtopow~-help; +#X text 98 452 float; +#X text 158 452 - an incoming float will be converted to a signal. +; +#X text 98 472 list; +#X text 158 472 - a list will be truncated to the first element.; +#X obj 98 569 pddp/pddplink all_about_acoustic_conversions.pd; +#X text 97 96 Click on the links under each object for more help:; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 455 51 pddp/dsp; #X connect 16 0 17 0; -#X connect 17 0 10 0; +#X connect 17 0 18 0; #X connect 18 0 19 0; -#X connect 20 0 22 0; -#X connect 21 0 25 0; -#X connect 23 0 24 0; -#X connect 25 0 30 0; -#X connect 26 0 27 0; -#X connect 27 0 31 0; -#X connect 28 0 29 0; -#X connect 29 0 32 0; -#X connect 30 0 20 0; -#X connect 31 0 18 0; -#X connect 32 0 23 0; +#X connect 19 0 20 0; +#X connect 20 0 21 0; +#X connect 21 0 22 0; +#X connect 29 0 34 0; +#X connect 30 0 31 0; +#X connect 31 0 35 0; +#X connect 32 0 33 0; +#X connect 34 0 30 0; +#X connect 35 0 32 0; +#X connect 36 0 41 0; +#X connect 37 0 38 0; +#X connect 38 0 42 0; +#X connect 39 0 40 0; +#X connect 41 0 37 0; +#X connect 42 0 39 0; +#X connect 43 0 18 0; +#X connect 43 0 21 0; +#X connect 44 0 30 0; +#X connect 44 0 32 0; +#X connect 45 0 37 0; +#X connect 45 0 39 0; diff --git a/doc/pddp/adc~-help.pd b/pd/doc/5.reference/adc~-help.pd similarity index 100% rename from doc/pddp/adc~-help.pd rename to pd/doc/5.reference/adc~-help.pd diff --git a/pd/doc/5.reference/adc~_dac~-help.pd b/pd/doc/5.reference/adc~_dac~-help.pd index 7538d8ffa..e82c4b4bc 100644 --- a/pd/doc/5.reference/adc~_dac~-help.pd +++ b/pd/doc/5.reference/adc~_dac~-help.pd @@ -1,16 +1,108 @@ -#N canvas 195 155 575 293 12; -#X obj 8 11 adc~; -#X obj 72 11 dac~; -#X obj 63 121 adc~ 5; -#X text 143 121 (input from channel 5 only); -#X obj 61 145 dac~ 1 2 5 23; -#X text 184 145 (output to channels 1 \, 2 \, 5 \, and 23); -#X text 16 173 The actual number of channels Pd inputs and outputs -are set on Pd's command line. You can open patches that want to use -more channels \, and channel numbers out of rance will be dropped (dac~) -or appear as zero (adc~).; -#X text 308 254 updated for Pd version 0.33; -#X text 122 9 - audio I/O; -#X text 8 46 Adc~ and dac~ provide real-time audio input and output -for Pd \, respectively \, whether analog or digital. By default they -are stereo but you can specify channel numbers as in:; +#N canvas 427 35 559 624 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~/dac~) 3 12 +0 18 -204280 -1 0; +#N canvas 568 408 402 224 META 0; +#X text 12 85 LIBRARY internal; +#X text 12 125 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 45 LICENSE SIBSD; +#X text 12 105 AUTHOR Miller Puckette; +#X text 12 165 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 25 KEYWORDS signal conversion; +#X text 12 5 NAME adc~ dac~; +#X text 12 145 RELEASE_DATE 1997; +#X text 12 65 DESCRIPTION audio input/output; +#X restore 501 597 pd META; +#X obj 0 508 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 205 462 428 165 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 19 74 Externals; +#X obj 173 43 throw~; +#X obj 225 43 catch~; +#X obj 277 43 send~; +#X obj 321 43 receive~; +#X obj 19 94 pddp/helplink pdogg/oggcast~; +#X obj 19 114 pddp/helplink unauthorized/mp3cast~; +#X text 18 136 [shoutcast~] (What library is this in?); +#X obj 119 43 block~; +#X text 19 66; +#X text 115 43; +#X restore 102 597 pd Related_objects; +#X obj 469 10 adc~; +#X obj 5 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#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 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 102 542 pd Multi-channel_audio; +#N canvas 84 179 428 341 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 obj 509 10 adc~; +#X text 12 23 audio input/output; +#X obj 101 107 pddp/pddplink adc~-help.pd; +#X text 98 56 [adc~] and [dac~] provide real-time audio input and output +for Pd \, respectively \, whether analog or digital. Click below for +the individual help patches:; +#X obj 101 127 pddp/pddplink dac~-help.pd; diff --git a/doc/pddp/all_about.pd b/pd/doc/5.reference/all_about.pd similarity index 100% rename from doc/pddp/all_about.pd rename to pd/doc/5.reference/all_about.pd diff --git a/doc/pddp/all_about_acoustic_conversions.pd b/pd/doc/5.reference/all_about_acoustic_conversions.pd similarity index 100% rename from doc/pddp/all_about_acoustic_conversions.pd rename to pd/doc/5.reference/all_about_acoustic_conversions.pd diff --git a/doc/pddp/all_about_arrays.pd b/pd/doc/5.reference/all_about_arrays.pd similarity index 100% rename from doc/pddp/all_about_arrays.pd rename to pd/doc/5.reference/all_about_arrays.pd diff --git a/doc/pddp/all_about_ascii_art.pd b/pd/doc/5.reference/all_about_ascii_art.pd similarity index 100% rename from doc/pddp/all_about_ascii_art.pd rename to pd/doc/5.reference/all_about_ascii_art.pd diff --git a/doc/pddp/all_about_atom_conversion.pd b/pd/doc/5.reference/all_about_atom_conversion.pd similarity index 100% rename from doc/pddp/all_about_atom_conversion.pd rename to pd/doc/5.reference/all_about_atom_conversion.pd diff --git a/doc/pddp/all_about_atoms.pd b/pd/doc/5.reference/all_about_atoms.pd similarity index 100% rename from doc/pddp/all_about_atoms.pd rename to pd/doc/5.reference/all_about_atoms.pd diff --git a/doc/pddp/all_about_canvas_properties.pd b/pd/doc/5.reference/all_about_canvas_properties.pd similarity index 100% rename from doc/pddp/all_about_canvas_properties.pd rename to pd/doc/5.reference/all_about_canvas_properties.pd diff --git a/doc/pddp/all_about_data_types.pd b/pd/doc/5.reference/all_about_data_types.pd similarity index 100% rename from doc/pddp/all_about_data_types.pd rename to pd/doc/5.reference/all_about_data_types.pd diff --git a/doc/pddp/all_about_dollarsign_zero.pd b/pd/doc/5.reference/all_about_dollarsign_zero.pd similarity index 100% rename from doc/pddp/all_about_dollarsign_zero.pd rename to pd/doc/5.reference/all_about_dollarsign_zero.pd diff --git a/doc/pddp/all_about_expr_and_value.pd b/pd/doc/5.reference/all_about_expr_and_value.pd similarity index 100% rename from doc/pddp/all_about_expr_and_value.pd rename to pd/doc/5.reference/all_about_expr_and_value.pd diff --git a/doc/pddp/all_about_expr_functions.pd b/pd/doc/5.reference/all_about_expr_functions.pd similarity index 100% rename from doc/pddp/all_about_expr_functions.pd rename to pd/doc/5.reference/all_about_expr_functions.pd diff --git a/doc/pddp/all_about_expr_if.pd b/pd/doc/5.reference/all_about_expr_if.pd similarity index 100% rename from doc/pddp/all_about_expr_if.pd rename to pd/doc/5.reference/all_about_expr_if.pd diff --git a/doc/pddp/all_about_expr_multiline.pd b/pd/doc/5.reference/all_about_expr_multiline.pd similarity index 100% rename from doc/pddp/all_about_expr_multiline.pd rename to pd/doc/5.reference/all_about_expr_multiline.pd diff --git a/doc/pddp/all_about_externals.pd b/pd/doc/5.reference/all_about_externals.pd similarity index 100% rename from doc/pddp/all_about_externals.pd rename to pd/doc/5.reference/all_about_externals.pd diff --git a/doc/pddp/all_about_finding_objects.pd b/pd/doc/5.reference/all_about_finding_objects.pd similarity index 100% rename from doc/pddp/all_about_finding_objects.pd rename to pd/doc/5.reference/all_about_finding_objects.pd diff --git a/doc/pddp/all_about_getting_help.pd b/pd/doc/5.reference/all_about_getting_help.pd similarity index 100% rename from doc/pddp/all_about_getting_help.pd rename to pd/doc/5.reference/all_about_getting_help.pd diff --git a/doc/pddp/all_about_haptics.pd b/pd/doc/5.reference/all_about_haptics.pd similarity index 100% rename from doc/pddp/all_about_haptics.pd rename to pd/doc/5.reference/all_about_haptics.pd diff --git a/doc/pddp/all_about_help_patches.pd b/pd/doc/5.reference/all_about_help_patches.pd similarity index 100% rename from doc/pddp/all_about_help_patches.pd rename to pd/doc/5.reference/all_about_help_patches.pd diff --git a/doc/pddp/all_about_hid.pd b/pd/doc/5.reference/all_about_hid.pd similarity index 100% rename from doc/pddp/all_about_hid.pd rename to pd/doc/5.reference/all_about_hid.pd diff --git a/doc/pddp/all_about_index.pd b/pd/doc/5.reference/all_about_index.pd similarity index 100% rename from doc/pddp/all_about_index.pd rename to pd/doc/5.reference/all_about_index.pd diff --git a/doc/pddp/all_about_libraries.pd b/pd/doc/5.reference/all_about_libraries.pd similarity index 100% rename from doc/pddp/all_about_libraries.pd rename to pd/doc/5.reference/all_about_libraries.pd diff --git a/doc/pddp/all_about_lists_vs_anythings.pd b/pd/doc/5.reference/all_about_lists_vs_anythings.pd similarity index 100% rename from doc/pddp/all_about_lists_vs_anythings.pd rename to pd/doc/5.reference/all_about_lists_vs_anythings.pd diff --git a/doc/pddp/all_about_looping.pd b/pd/doc/5.reference/all_about_looping.pd similarity index 100% rename from doc/pddp/all_about_looping.pd rename to pd/doc/5.reference/all_about_looping.pd diff --git a/doc/pddp/all_about_message_conversion.pd b/pd/doc/5.reference/all_about_message_conversion.pd similarity index 100% rename from doc/pddp/all_about_message_conversion.pd rename to pd/doc/5.reference/all_about_message_conversion.pd diff --git a/doc/pddp/all_about_messages.pd b/pd/doc/5.reference/all_about_messages.pd similarity index 100% rename from doc/pddp/all_about_messages.pd rename to pd/doc/5.reference/all_about_messages.pd diff --git a/doc/pddp/all_about_midi_flags.pd b/pd/doc/5.reference/all_about_midi_flags.pd similarity index 100% rename from doc/pddp/all_about_midi_flags.pd rename to pd/doc/5.reference/all_about_midi_flags.pd diff --git a/doc/pddp/all_about_pd_META.pd b/pd/doc/5.reference/all_about_pd_META.pd similarity index 100% rename from doc/pddp/all_about_pd_META.pd rename to pd/doc/5.reference/all_about_pd_META.pd diff --git a/doc/pddp/all_about_route.pd b/pd/doc/5.reference/all_about_route.pd similarity index 100% rename from doc/pddp/all_about_route.pd rename to pd/doc/5.reference/all_about_route.pd diff --git a/doc/pddp/all_about_scope_and_locality.pd b/pd/doc/5.reference/all_about_scope_and_locality.pd similarity index 100% rename from doc/pddp/all_about_scope_and_locality.pd rename to pd/doc/5.reference/all_about_scope_and_locality.pd diff --git a/doc/pddp/all_about_send_n_receive.pd b/pd/doc/5.reference/all_about_send_n_receive.pd similarity index 100% rename from doc/pddp/all_about_send_n_receive.pd rename to pd/doc/5.reference/all_about_send_n_receive.pd diff --git a/doc/pddp/all_about_submitting_bugs.pd b/pd/doc/5.reference/all_about_submitting_bugs.pd similarity index 100% rename from doc/pddp/all_about_submitting_bugs.pd rename to pd/doc/5.reference/all_about_submitting_bugs.pd diff --git a/doc/pddp/all_about_symbol_construction.pd b/pd/doc/5.reference/all_about_symbol_construction.pd similarity index 100% rename from doc/pddp/all_about_symbol_construction.pd rename to pd/doc/5.reference/all_about_symbol_construction.pd diff --git a/doc/pddp/all_about_writing_help_patches.pd b/pd/doc/5.reference/all_about_writing_help_patches.pd similarity index 100% rename from doc/pddp/all_about_writing_help_patches.pd rename to pd/doc/5.reference/all_about_writing_help_patches.pd diff --git a/doc/pddp/all_about_z_order.pd b/pd/doc/5.reference/all_about_z_order.pd similarity index 100% rename from doc/pddp/all_about_z_order.pd rename to pd/doc/5.reference/all_about_z_order.pd diff --git a/pd/doc/5.reference/append-help.pd b/pd/doc/5.reference/append-help.pd index 88efc0003..944d593ff 100644 --- a/pd/doc/5.reference/append-help.pd +++ b/pd/doc/5.reference/append-help.pd @@ -1,44 +1,114 @@ -#N canvas 330 8 599 454 12; -#X text 15 344 see also:; -#N canvas 164 72 429 150 help-append-template1 0; -#X obj 18 81 filledpolygon z z 0 0 0 20 0 20 30 0 30; -#X obj 60 21 struct help-append-template1 float x float y float z; -#X restore 357 373 pd help-append-template1; -#X obj 16 368 get; -#X obj 48 368 set; -#X obj 148 368 getsize; -#X obj 215 368 setsize; -#X obj 218 393 element; -#X obj 15 394 sublist; -#X obj 83 393 scalar; -#N canvas 0 0 280 167 help-append-data 1; -#X restore 357 351 pd help-append-data; -#X obj 212 255 pointer; -#X obj 21 10 append; -#X text 75 9 -- add item to a list; -#X msg 212 231 traverse pd-help-append-data \, bang; -#X obj 34 295 append help-append-template1 x y z; -#X floatatom 34 246 5 0 0 0 - - -; -#X obj 34 266 t f f; -#X msg 356 311 \; pd-help-append-data clear; -#X text 27 28 "append" maintains a pointer to a scalar \, or else an -empty pointer to the head of a list. You may set the pointer using -the leftmost inlet. The creation arguments specify the template of -a new scalar to append \, and the names of the fields (there should -be at least one) you will wish to initialize. To append an object \, -send a number to the leftmost inlet. "Append"'s pointer is updated -to point to the new scalar \, and the new pointer is also output.; -#X text 28 149 To insert to the beginning of a list \, you can append -to the "head" of the list. You may append objects of different templates -using different "append" objects.; -#X obj 81 368 pointer; -#X text 341 408 updated for Pd version 0.40; -#X text 34 226 click this first->; -#X text 230 210 go to (and output) "head" of the list; -#X obj 141 393 struct; -#X connect 10 0 14 3; -#X connect 13 0 10 0; -#X connect 15 0 16 0; -#X connect 16 0 14 0; -#X connect 16 1 14 1; -#X connect 16 1 14 2; +#N canvas 427 33 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 append 3 12 0 18 +-204280 -1 0; +#X obj 0 226 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 563 355 411 274 META 0; +#X text 12 145 LIBRARY internal; +#X text 12 185 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 165 AUTHOR Miller Puckette; +#X text 12 225 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 5 KEYWORDS control data_structure; +#X text 12 105 INLET_R pointer; +#X text 12 125 OUTLET_0 pointer; +#X text 12 65 INLET_0 float list; +#X text 12 85 INLET_N float; +#X text 12 205 RELEASE_DATE 1997; +#X text 12 45 DESCRIPTION add a scalar to a canvas; +#X restore 500 597 pd META; +#X obj 0 392 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 436 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 527 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#X obj 78 319 cnv 17 3 35 empty \$0-pddp.cnv.let.n n 5 9 0 16 -228856 +-162280 0; +#X obj 78 235 cnv 17 3 78 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 319 float; +#N canvas 214 524 428 101 Related_objects 0; +#X obj 14 38 get; +#X obj 46 38 set; +#X obj 136 38 getsize; +#X obj 193 38 setsize; +#X obj 121 63 element; +#X obj 13 64 sublist; +#X obj 79 38 pointer; +#X obj 69 63 struct; +#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 [append] Related Objects; +#X restore 101 597 pd Related_objects; +#X obj 498 12 append; +#N canvas 116 162 428 109 help-append-template1 0; +#X obj 22 69 filledpolygon z z 0 0 0 20 0 20 30 0 30; +#X obj 22 42 struct help-append-template1 float x float y float z; +#X obj 0 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 7 1 [append] Template for "help-append-template1"; +#X restore 372 196 pd help-append-template1; +#N canvas 554 168 428 207 help-append-data 0; +#X obj 0 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 7 1 [append] Data Window; +#X restore 372 174 pd help-append-data; +#X obj 281 104 pointer; +#X msg 281 80 traverse pd-help-append-data \, bang; +#X obj 80 152 append help-append-template1 x y z; +#X floatatom 80 95 5 26 400 0 - - -, f 5; +#X obj 80 115 t f f; +#X msg 372 138 \; pd-help-append-data clear; +#X text 98 234 float; +#X text 98 264 list; +#X obj 78 401 cnv 17 3 30 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 401 pointer; +#X obj 78 360 cnv 17 3 27 empty \$0-pddp.cnv.let.r r 5 9 0 16 -228856 +-162280 0; +#X text 98 360 pointer; +#X text 98 531 You may append objects of different templates using +different [append] objects.; +#X text 168 360 - the final inlet takes a pointer to a scalar (or to +the head of a list).; +#X text 168 234 - a float to the left inlet initializes the field(s) +of a scalar and appends the scalar to a glist.; +#X text 168 264 - a list to the first inlet is distributed among the +inlets of [append]. In the example above \, you can use the message +box to assign the values "5" \, "6" \, and "7" to fields "x" \, "y" +\, and "z" \, respectively.; +#X text 168 319 - an additional inlet is created for each field specified +by the creation arguments. A float sent to one of these inlets will +be stored for later use.; +#X text 168 401 - after [append] receives a value at its left inlet +\, it outputs a pointer to the new scalar that has been created.; +#X text 15 74 2) ...then here; +#X text 224 174 3) result is in here ->; +#X text 279 56 1) go to (and output) "head" of the list; +#X text 168 482 - all subsequent arguments are names of fields to initialize. +At least one field must be specified in order to append a new scalar. +; +#X text 80 455 1) symbol atom; +#X text 80 482 n) symbol atom; +#X text 168 455 - a [struct] name that specifies the template of a +new scalar to append.; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 98 572 pddp/pddplink ../4.data.structures/04.append.pd -text +doc/4.data.structures/04.append.pd; +#X obj 98 557 pddp/pddplink all_about_z_order.pd; +#X obj 325 557 pddp/pddplink scalar-help.pd; +#X text 11 23 add a scalar to a canvas; +#X msg 18 95 10 75 2; +#X connect 14 0 16 3; +#X connect 15 0 14 0; +#X connect 17 0 18 0; +#X connect 18 0 16 0; +#X connect 18 1 16 1; +#X connect 18 1 16 2; +#X connect 44 0 16 0; diff --git a/doc/pddp/array-help.pd b/pd/doc/5.reference/array-help.pd similarity index 100% rename from doc/pddp/array-help.pd rename to pd/doc/5.reference/array-help.pd diff --git a/doc/pddp/atan-help.pd b/pd/doc/5.reference/atan-help.pd similarity index 100% rename from doc/pddp/atan-help.pd rename to pd/doc/5.reference/atan-help.pd diff --git a/doc/pddp/atan2-help.pd b/pd/doc/5.reference/atan2-help.pd similarity index 100% rename from doc/pddp/atan2-help.pd rename to pd/doc/5.reference/atan2-help.pd diff --git a/pd/doc/5.reference/bag-help.pd b/pd/doc/5.reference/bag-help.pd index cdd5bfff5..9a73fe22d 100644 --- a/pd/doc/5.reference/bag-help.pd +++ b/pd/doc/5.reference/bag-help.pd @@ -1,27 +1,86 @@ -#N canvas 118 56 577 366 12; -#X text 18 337 see also:; -#X obj 148 337 makenote; -#X msg 76 151 60 64; -#X msg 127 151 60 0; -#X msg 171 151 62 64; -#X msg 218 151 62 0; -#X obj 76 278 print; -#X text 121 279 Output is in the printout window.; -#X msg 218 197 clear; -#X obj 66 15 bag; -#X text 101 14 - COLLECTION OF NUMBERS; -#X text 12 42 The bag object takes (value \, flag) pairs. If the flag is true (nonzero) \, the value is added to the collection \; if false \, it's removed. The collection may have many copies of the same value. You can output the collection (and empty it) with a "flush" message \, or just empty it with "clear." You can use this to mimic a sustain pedal \, for example.; -#X msg 217 174 flush; -#X obj 104 337 poly; -#X obj 76 248 bag; -#X text 267 151 <-- add or delete elements; -#X text 271 174 <-- output them; -#X text 273 198 <-- start over; -#X text 328 337 updated for Pd version 0.33; -#X connect 2 0 14 0; -#X connect 3 0 14 0; -#X connect 4 0 14 0; -#X connect 5 0 14 0; -#X connect 8 0 14 0; -#X connect 12 0 14 0; -#X connect 14 0 6 0; +#N canvas 430 33 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 bag 3 12 0 18 -204280 +-1 0; +#X obj 0 288 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 562 360 414 263 META 0; +#X text 12 125 LIBRARY internal; +#X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 145 AUTHOR Miller Puckette; +#X text 12 205 HELP_PATCH_AUTHORS Updated for Pd v0.41. Revised by +Jonathan Wilkes to conform to the PDDP template for Pd version 0.42. +; +#X text 12 45 DESCRIPTION collection of numbers; +#X text 12 85 INLET_1 float; +#X text 12 105 OUTLET_0 float; +#X text 12 65 INLET_0 float list flush clear; +#X text 12 5 KEYWORDS control storage list_op; +#X text 12 185 RELEASE_DATE 2009; +#X restore 500 597 pd META; +#X obj 0 495 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 538 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 566 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#X text 98 542 (none); +#N canvas 225 510 428 109 Related_objects 0; +#X obj 62 43 makenote; +#X obj 22 43 poly; +#X obj 123 43 list; +#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 [bag] Related Objects; +#X restore 102 598 pd Related_objects; +#X obj 79 297 cnv 17 3 130 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 296 float; +#X text 98 353 list; +#X text 98 503 float; +#X obj 79 504 cnv 17 3 30 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 79 440 cnv 17 3 45 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X text 98 439 float; +#X text 98 383 flush; +#X text 98 413 clear; +#X text 168 383 - output all values one by one \, in the order they +were received \, and clear the collection.; +#X text 168 503 - upon sending the "flush" message to the left inlet +\, [bag] will output each value in the order it was received.; +#X text 99 570 You can use [bag] to mimic a sustain pedal \, for example. +; +#X msg 162 88 60 64; +#X msg 213 88 60 0; +#X msg 257 88 62 64; +#X msg 304 88 62 0; +#X obj 162 215 print; +#X text 207 216 Output is in the printout window.; +#X msg 304 134 clear; +#X msg 303 111 flush; +#X obj 162 185 bag; +#X text 168 353 - a (value \, flag) pair is distributed to the two +inlets. Lists with more than two elements will be truncated.; +#X text 11 23 collection of numbers; +#X obj 518 10 bag; +#X text 168 413 - clear the collection.; +#X text 167 439 - a float to the right inlet sets the "flag": if zero +\, values to the left inlet will not be added to the collection. If +nonzero \, values to the right inlet will be added to the collection. +; +#X text 168 296 - a float to the left inlet will be added to the collection +if the last value the right inlet received was nonzero. If the last +value the right inlet received was zero \, the float sent to the right +inlet will be removed from the collection.; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X connect 21 0 29 0; +#X connect 22 0 29 0; +#X connect 23 0 29 0; +#X connect 24 0 29 0; +#X connect 27 0 29 0; +#X connect 28 0 29 0; +#X connect 29 0 25 0; diff --git a/pd/doc/5.reference/bang-help.pd b/pd/doc/5.reference/bang-help.pd index 1f522268f..03d6621b3 100644 --- a/pd/doc/5.reference/bang-help.pd +++ b/pd/doc/5.reference/bang-help.pd @@ -1,13 +1,133 @@ -#N canvas 118 56 581 250 12; -#X obj 49 182 print; -#X text 107 183 Output is in the printout window.; -#X obj 66 15 bang; -#X text 112 14 - SEND "BANG" MSSESSAGE; -#X msg 61 105 walk the cat; -#X msg 49 79 45; -#X obj 49 152 bang; -#X text 336 233 updated for Pd version 0.27; -#X text 23 42 Outputs a "bang" message whatever it receives.; -#X connect 4 0 6 0; -#X connect 5 0 6 0; -#X connect 6 0 0 0; +#N canvas 428 36 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 bang 3 12 0 18 -204280 +-1 0; +#X obj 0 329 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 570 331 408 299 META 0; +#X text 12 125 LIBRARY internal; +#X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 45 LICENSE SIBSD; +#X text 12 145 AUTHOR Miller Puckette; +#X text 12 205 HELP_PATCH_AUTHORS This document was updated for Pd +version 0.35 test 28 by Dave Sabine as part of a project called pddp +proposed by Krzysztof Czaja to build comprehensive documentation for +Pd. Revised by Jonathan Wilkes to conform to the PDDP template for +Pd version 0.42.; +#X text 12 65 DESCRIPTION output a "bang" message whatever the input +; +#X text 12 85 INLET_0 anything; +#X text 12 105 OUTLET_0 bang; +#X text 12 5 ALIAS b; +#X text 12 25 KEYWORDS control bang_op; +#X text 12 185 RELEASE_DATE 2009; +#X restore 500 597 pd META; +#X obj 0 373 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 409 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 437 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#X obj 78 338 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 413 (none); +#N canvas 215 518 428 108 Related_objects 0; +#X obj 21 42 trigger; +#X obj 191 43 loadbang; +#X msg 91 43; +#X obj 262 43 until; +#X obj 144 43 bang; +#X obj 312 43 metro; +#X obj 0 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 7 1 [bang] Related Objects; +#X restore 101 598 pd Related_objects; +#X text 98 381 bang; +#X obj 78 381 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 468 11 bang; +#X obj 139 224 print; +#X msg 152 171 walk the cat; +#X msg 139 145 45; +#X obj 139 199 bang; +#X obj 288 199 print; +#X msg 288 147 walk the cat; +#X obj 288 175 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X text 310 173 <- gui "bng" object; +#X text 98 337 anything; +#N canvas 57 48 428 509 More_bang_objects 0; +#X obj 23 42 bang; +#X obj 66 42 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 43 116 bang; +#X text 20 115 1; +#X text 19 172 2; +#X obj 43 173 bng 15 250 50 0 empty empty empty 18 7 0 8 -262144 -1 +-1; +#X text 178 42 - sending "bang" messages; +#X obj 140 42 t b; +#X msg 92 42 bang; +#X text 19 288 3; +#X msg 45 289 bang; +#X msg 98 342 bang \, bang; +#X obj 98 368 f; +#X obj 131 368 + 1; +#X floatatom 98 393 5 0 0 0 - - -, f 5; +#X msg 46 342 bang; +#X text 19 418 4; +#X obj 43 419 trigger bang; +#X text 151 419 Abbrevation:; +#X obj 253 419 t b; +#X obj 271 471 b; +#X text 43 138 This version uses minimal CPU but serves essentially +the same purpose as the GUI version below.; +#X text 42 309 The word "bang" in a message box (CTRL+2) makes a clickable +bang object. Use commas to send multiple messages:; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 7 1 [bang] Common Objects for Sending bang Messages; +#X text 20 65 The [bang] object is one of the basic building blocks +of PD and is normally used to activate events. The four basic ways +to send a "bang" message are:; +#X text 42 441 When given a single argument of "bang" \, the trigger +object is essentially the same as #1 above \, so in this case it's +preferable (and less typing) to use:; +#X text 67 174 a.k.a. [bng]; +#X text 42 191 This version uses a little more CPU than its cousin +because it lights up when it receives a message or is clicked on and +can be coloured \, resized \, or renamed. It is sometimes 'friendlier' +as well because it can act as its own send and receive object (see +properties...). This object can be put in a Pd patch either by keyboard +shortcut: ALT+SHIFT+B or by creating an object (CTRL+1) and naming +it "bng".; +#X connect 11 0 12 0; +#X connect 12 0 13 0; +#X connect 12 0 14 0; +#X connect 13 0 12 1; +#X connect 15 0 12 0; +#X restore 100 473 pd More_bang_objects; +#X text 98 441 Many objects in Pd output a "bang" message. Click the +subpatch below to read about the most common ones:; +#X obj 100 569 tgl 15 0 empty empty empty 17 7 0 10 -262144 -1 -1 0 +1; +#X text 98 498 It is important to note that "bang" is not boolean. +It's neither a zero or a one \; it's not true or false \; it's just +"bang". For a boolean object \, you should check out [toggle]:; +#X text 11 23 output a "bang" message whatever the input; +#X text 122 567 <- Right click and choose "Help" for [toggle] helpfile. +; +#X text 168 381 - the [bang] object always outputs a bang message. +; +#X text 168 337 - [bang] takes any message supplied to its inlet and +outputs a bang message in response.; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 520 11 b; +#X text 500 11 or; +#X connect 14 0 16 0; +#X connect 15 0 16 0; +#X connect 16 0 13 0; +#X connect 18 0 19 0; +#X connect 19 0 17 0; diff --git a/pd/doc/5.reference/bang~-help.pd b/pd/doc/5.reference/bang~-help.pd index debade2f3..3d9ae5218 100644 --- a/pd/doc/5.reference/bang~-help.pd +++ b/pd/doc/5.reference/bang~-help.pd @@ -1,18 +1,75 @@ -#N canvas 0 0 529 299 12; -#X obj 112 128 bang~; -#X obj 112 159 print; -#X msg 210 223 \; pd dsp 1; -#X msg 297 216 \; pd dsp 0; -#X msg 210 144 bang; -#X obj 19 20 bang~; -#X obj 306 193 loadbang; -#X obj 297 169 delay 100; -#X text 211 122 click to test; -#X text 71 21 - output bang after each DSP cycle; -#X text 5 59 Bang~ outputs a bang after each DSP cycle (at the same logical time as the DSP cycle.) This is primarily useful for sampling the outputs of analysis algorithms.; -#X text 251 266 updated for Pd version 0.33; -#X connect 0 0 1 0; -#X connect 4 0 2 0; -#X connect 4 0 7 0; -#X connect 6 0 3 0; -#X connect 7 0 3 0; +#N canvas 426 35 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 bang~ 3 12 0 18 +-204280 -1 0; +#X obj 0 445 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 585 389 387 241 META 0; +#X text 12 105 LIBRARY internal; +#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 125 AUTHOR Miller Puckette; +#X text 12 185 HELP_PATCH_AUTHORS Updated for Pd version 0.33. Revised +by Jonathan Wilkes to conform to the PDDP template for Pd version 0.42. +; +#X text 12 45 DESCRIPTION output a "bang" message after each DSP cycle +; +#X text 12 65 INLET_0; +#X text 12 85 OUTLET_0 bang; +#X text 12 5 KEYWORDS signal conversion bang_op; +#X text 12 165 RELEASE_DATE 2009; +#X restore 500 597 pd META; +#X obj 0 482 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 537 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 565 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#X obj 78 454 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 541 (none); +#N canvas 214 518 428 114 Related_objects 0; +#X obj 15 34 print~; +#X obj 72 34 bang; +#X obj 0 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 6 1 [bang~] Related Objects; +#X restore 102 597 pd Related_objects; +#X text 98 491 bang; +#X obj 78 491 cnv 17 3 35 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 505 12 bang~; +#X obj 116 213 bang~; +#X obj 116 281 print; +#X text 228 169 click to test; +#X obj 116 249 spigot; +#X msg 190 253 dsp \$1; +#X obj 190 280 s pd; +#X msg 190 171 bang; +#X obj 190 219 1; +#X obj 226 219 0; +#X obj 226 195 delay 10; +#X obj 340 170 loadbang; +#X msg 340 196 dsp 0; +#X obj 340 221 s pd; +#X text 11 23 output a "bang" message after each DSP cycle; +#X text 168 453 - the inlet of [bang~] is not used.; +#X text 168 491 - [bang~] outputs a bang after each DSP cycle (at the +same logical time as the DSP cycle). This is primarily useful for sampling +the outputs of analysis algorithms.; +#X text 98 453 (inactive); +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X connect 13 0 16 0; +#X connect 16 0 14 0; +#X connect 17 0 18 0; +#X connect 19 0 20 0; +#X connect 19 0 22 0; +#X connect 20 0 16 1; +#X connect 20 0 17 0; +#X connect 21 0 16 1; +#X connect 21 0 17 0; +#X connect 22 0 21 0; +#X connect 23 0 24 0; +#X connect 24 0 25 0; diff --git a/doc/pddp/bendin-help.pd b/pd/doc/5.reference/bendin-help.pd similarity index 100% rename from doc/pddp/bendin-help.pd rename to pd/doc/5.reference/bendin-help.pd diff --git a/doc/pddp/bendout-help.pd b/pd/doc/5.reference/bendout-help.pd similarity index 100% rename from doc/pddp/bendout-help.pd rename to pd/doc/5.reference/bendout-help.pd diff --git a/pd/doc/5.reference/biquad~-help.pd b/pd/doc/5.reference/biquad~-help.pd index b7757244b..aba09e5bc 100644 --- a/pd/doc/5.reference/biquad~-help.pd +++ b/pd/doc/5.reference/biquad~-help.pd @@ -1,36 +1,88 @@ -#N canvas 327 119 689 397 12; -#X obj 15 12 biquad~; -#X msg 510 20 \; pd dsp 1; -#X msg 504 66 \; pd dsp 0; -#X obj 84 248 env~; -#X floatatom 84 275 0 0 0 0 - - -; -#X floatatom 15 110 0 0 0 0 - - -; -#X obj 15 246 env~; -#X floatatom 15 274 0 0 0 0 - - -; -#X text 13 297 Compare the value of the straight signal on the left +#N canvas 429 36 555 619 10; +#X obj -1 595 cnv 15 552 21 empty \$0-pddp.cnv.footer empty 20 12 0 +14 -228856 -66577 0; +#X obj -1 0 cnv 15 552 40 empty \$0-pddp.cnv.header biquad~ 3 12 0 +18 -204280 -1 0; +#X obj -1 321 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 659 352 314 272 META 0; +#X text 12 105 LIBRARY internal; +#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 125 AUTHOR Miller Puckette; +#X text 12 185 HELP_PATCH_AUTHORS Updated for Pd version-0.30. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 5 KEYWORDS signal filters; +#X text 12 45 DESCRIPTION 2-pole-2-zero-filter; +#X text 12 85 OUTLET_0 signal; +#X text 12 65 INLET_0 list signal set clear; +#X text 12 165 RELEASE_DATE 2009; +#X restore 500 597 pd META; +#X obj -1 416 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj -1 453 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj -1 565 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 +12 0 13 -228856 -1 0; +#N canvas 211 524 428 102 Related_objects 0; +#X obj 22 42 hip~; +#X obj 62 41 lop~; +#X obj 104 41 bp~; +#X obj 139 41 vcf~; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 7 1 [biquad~] Related Objects; +#X restore 101 597 pd Related_objects; +#X obj 78 330 cnv 17 3 75 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 489 12 biquad~; +#X obj 155 216 env~; +#X floatatom 155 243 0 0 0 0 - - -; +#X floatatom 66 98 0 0 0 0 - - -; +#X obj 66 214 env~; +#X floatatom 66 242 0 0 0 0 - - -; +#X obj 155 183 biquad~ 1.41407 -0.9998 1 -1.41421 1; +#X msg 155 99 1.41407 -0.9998 1 -1.41421 1; +#X text 220 237 (= SR/8 = 5512.5 Hz @44.1k); +#X text 167 77 list sets filter parameters; +#X msg 190 129 set 0 0; +#X msg 191 154 clear; +#X obj 66 138 osc~ 5512.5; +#X text 260 131 set internal state; +#X text 258 153 ... or just clear it; +#X text 98 350 list; +#X text 98 330 signal; +#X text 98 370 set; +#X text 98 390 clear; +#X obj 78 425 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 426 signal; +#X text 169 503 y(n) = ff1 * w(n) + ff2 * w(n-1) + ff3 * w(n-2); +#X text 169 519 w(n) = x(n) + fb1 * w(n-1) + fb2 * w(n-2); +#X text 169 541 Syntax: biquad~ fb1 fb2 ff1 ff2 ff3; +#X text 59 267 Compare the value of the straight signal on the left with the value of the filtered signal on the right.; -#X obj 84 215 biquad~ 1.41407 -0.9998 1 -1.41421 1; -#X msg 101 121 1.41407 -0.9998 1 -1.41421 1; -#X text 76 31 calculates the following difference equation:; -#X text 77 44 y(n) = ff1 * w(n) + ff2 * w(n-1) + ff3 * w(n-2); -#X text 77 60 w(n) = x(n) + fb1 * w(n-1) + fb2 * w(n-2); -#X text 18 76 Syntax: biquad~ fb1 fb2 ff1 ff2 ff3; -#X text 259 239 this biquad~ is a notch filter for fn = Pi/4; -#X text 265 258 (= SR/8 = 5512.5 Hz @44.1k); -#X text 91 14 2-pole-2-zero-filter; -#X text 113 99 list sets filter parameters; -#X msg 119 161 set 0 0; -#X msg 120 186 clear; -#X obj 15 170 osc~ 5512.5; -#X text 422 337 updated for Pd version-0.30; -#X text 189 163 set internal state; -#X text 187 185 ... or just clear it; -#X connect 3 0 4 0; -#X connect 5 0 21 0; -#X connect 6 0 7 0; -#X connect 9 0 3 0; -#X connect 10 0 9 0; -#X connect 19 0 9 0; -#X connect 20 0 9 0; -#X connect 21 0 6 0; -#X connect 21 0 9 0; +#X text 11 23 2-pole-2-zero-filter; +#X text 169 472 - [biquad~] takes five floats as arguments which are +used to calculate the following difference equation:; +#X text 168 370 - set internal state.; +#X text 168 390 - clear the internal state.; +#X text 85 472 5 floats; +#X text 214 218 this [biquad~] is a notch filter for fn = Pi/4; +#X text 168 350 - a list of 5 floats is used to set filter parameters. +; +#X text 168 330 - the incoming signal; +#X text 168 426 - the outgoing signal; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 474 51 pddp/dsp; +#X connect 10 0 11 0; +#X connect 12 0 21 0; +#X connect 13 0 14 0; +#X connect 15 0 10 0; +#X connect 16 0 15 0; +#X connect 19 0 15 0; +#X connect 20 0 15 0; +#X connect 21 0 13 0; +#X connect 21 0 15 0; diff --git a/pd/doc/5.reference/block~-help.pd b/pd/doc/5.reference/block~-help.pd index 4d2bdbdce..5858a5531 100644 --- a/pd/doc/5.reference/block~-help.pd +++ b/pd/doc/5.reference/block~-help.pd @@ -1,88 +1,211 @@ -#N canvas 21 2 607 676 12; -#X obj 48 10 block~; -#X text 112 11 (and switch~) - block size and on/off control for DSP +#N canvas 242 31 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 block~ 3 12 0 18 +-204280 -1 0; +#X obj 0 251 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 479 284 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. Revised +by Jonathan Wilkes to conform to the PDDP template for Pd version 0.42. ; -#X text 44 40 The block~ and switch~ objects 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 45 230 You may have at most one block~/switch~ object in any -window.; -#X text 45 176 A 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 46 531 see also:; -#X obj 134 531 fft~; -#X text 44 567 ... and the control.blocksize and up.downsampling audio -example patches.; -#X text 194 459 <--- example usage in subpatch; -#X text 43 92 Switch~ \, in addition \, 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 12 65 DESCRIPTION block \, overlap \, and resampling control +for DSP; +#X text 12 85 INLET_0 set; +#X text 12 25 KEYWORDS signal block_oriented canvas_op; +#X text 12 165 RELEASE_DATE 2009; +#X text 12 5 ALIAS switch~; +#X restore 500 597 pd META; +#X obj 0 336 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 365 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 435 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 212 523 428 105 Related_objects 0; +#X obj 83 42 fft~; +#X obj 23 42 switch~; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 8 1 [block~] Related Objects; +#X restore 102 597 pd Related_objects; +#X obj 78 260 cnv 17 3 70 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 260 set; +#X text 98 341 (none); +#X floatatom 78 223 0 0 0 0 - - -; +#X text 165 224 <- measured time (msec) between blocks; +#X text 161 49 block size 4096 \, no overlap \, no resampling; +#X text 162 71 bigger block size; +#X text 160 92 double overlap; +#X text 169 116 downsampled by factor of 2; +#X text 160 139 upsampled by factor of 2; +#X msg 78 50 set 4096 1 1; +#X msg 78 72 set 8192 1 1; +#X msg 78 94 set 4096 2 1; +#X msg 78 116 set 4096 1 0.5; +#X msg 78 138 set 4096 1 2; +#N canvas 44 414 428 153 a-simple-block-example 0; +#X obj 22 42 block~ 1024 4; +#X text 19 64 This object specifies that DSP in this subwindow is to +be computed at a block size of 1024 \, and an overlap of 4 \, i.e. +\, every 256 samples. You may not (yet) specify a block size smaller +than your superpatch. This is useful for writing FFT based patches +(see the "fft examples" tutorial series.); +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 7 1 [block~] A Simple Example; +#X restore 242 555 pd a-simple-block-example; +#N canvas 56 284 428 261 block-interactions 0; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 7 1 [block~]/[switch~] Interactions with Other PD Objects; +#X text 20 36 [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 19 103 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 21 184 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 restore 102 555 pd block-interactions; +#X text 257 200 <- toggle display; +#X text 11 23 block \, overlap \, and resampling control for DSP; +#N canvas 22 87 428 396 visualize 0; +#X obj 49 219 f; +#X obj 81 219 + 1; +#X obj 117 170 i; +#X obj 117 243 s \$0-bng-rcv; +#X msg 117 218 flashtime 50 \$1; +#X obj 117 195 max 50; +#X obj 49 139 t b a; +#X obj 258 318 outlet; +#X obj 258 181 t a; +#X obj 201 315 tgl 15 0 \$0-tgl \$0-nothing empty 17 7 0 10 -204786 +-1 -1 0 1; +#X obj 49 187 spigot; +#X obj 110 124 r \$0-tgl; +#X obj 49 319 bng 10 50 50 0 \$0-nowhere \$0-bng-rcv empty 17 7 0 10 +-262144 -1 -1; +#X obj 64 319 bng 10 50 50 0 \$0-nowhere \$0-bng-rcv empty 17 7 0 10 +-262144 -1 -1; +#X obj 79 319 bng 10 50 50 0 \$0-nowhere \$0-bng-rcv empty 17 7 0 10 +-262144 -1 -1; +#X obj 94 319 bng 10 50 50 0 \$0-nowhere \$0-bng-rcv empty 17 7 0 10 +-262144 -1 -1; +#X obj 109 319 bng 10 50 50 0 \$0-nowhere \$0-bng-rcv empty 17 7 0 +10 -262144 -1 -1; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 7 1 [block~] Bang every block; +#X text 10 347 This subpatch just triggers a series of bng objects +to display how different "set" messages change the block size.; +#X obj 260 114 inlet; +#X obj 260 138 block~ 4096 1; +#X obj 49 63 bang~; +#X obj 49 89 t b b; +#X obj 49 115 timer; +#X obj 49 273 sel 0 1 2 3 4 5 6 7 8 9; +#X obj 124 319 bng 10 50 50 0 \$0-nowhere \$0-bng-rcv empty 17 7 0 +10 -262144 -1 -1; +#X obj 139 319 bng 10 50 50 0 \$0-nowhere \$0-bng-rcv empty 17 7 0 +10 -262144 -1 -1; +#X obj 154 319 bng 10 50 50 0 \$0-nowhere \$0-bng-rcv empty 17 7 0 +10 -262144 -1 -1; +#X obj 169 319 bng 10 50 50 0 \$0-nowhere \$0-bng-rcv empty 17 7 0 +10 -262144 -1 -1; +#X obj 184 319 bng 10 50 50 0 \$0-nowhere \$0-bng-rcv empty 17 7 0 +10 -262144 -1 -1; +#X obj 49 246 mod 10; +#X connect 0 0 1 0; +#X connect 0 0 31 0; +#X connect 1 0 0 1; +#X connect 2 0 5 0; +#X connect 4 0 3 0; +#X connect 5 0 4 0; +#X connect 6 0 10 0; +#X connect 6 1 2 0; +#X connect 6 1 8 0; +#X connect 8 0 7 0; +#X connect 10 0 0 0; +#X connect 11 0 10 1; +#X connect 20 0 21 0; +#X connect 22 0 23 0; +#X connect 23 0 24 0; +#X connect 23 1 24 1; +#X connect 24 0 6 0; +#X connect 25 0 12 0; +#X connect 25 1 13 0; +#X connect 25 2 14 0; +#X connect 25 3 15 0; +#X connect 25 4 16 0; +#X connect 25 5 26 0; +#X connect 25 6 27 0; +#X connect 25 7 28 0; +#X connect 25 8 29 0; +#X connect 25 9 30 0; +#X connect 31 0 25 0; +#X coords 0 -1 1 1 175 35 1 45 300; +#X restore 78 185 pd visualize; +#X text 170 384 - blocksize.; +#X text 170 398 - (optional) overlap.; +#X text 170 411 - (optional) resampling factor (relative to super-patch). ; -#N canvas 372 9 695 365 block-example 0; -#X obj 258 238 bang~; -#X obj 258 264 t b b; -#X obj 258 290 timer; -#X floatatom 258 319 5 0 0 0 - - -; -#X obj 54 30 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0 1 +#X text 80 398 2) float; +#X text 80 411 3) float; +#X text 80 384 1) float; +#X text 99 439 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 blocks 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 msg 78 53 set 4096 1 1; -#X msg 78 108 set 4096 2 1; -#X msg 78 79 set 8192 1 1; -#X msg 81 138 set 4096 1 0.5; -#X msg 81 165 set 4096 1 2; -#X obj 52 192 switch~ 4096 1 1; -#X obj 258 347 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X text 94 25 <--- switch this subpatch on and off; -#X text 209 53 <--- block size 4096 \, no overlap \, no resampling +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide ; -#X text 206 81 <--- bigger block size; -#X text 208 109 <--- double overlap; -#X text 219 142 <--- downsampled by factor of 2; -#X text 218 167 <--- upsampled by factor of 2; -#X text 206 194 <--- creation arguments (if any) initialize blocking +#X obj 455 51 pddp/dsp; +#X obj 102 576 pddp/pddplink ../3.audio.examples/J07.oversampling.pd +-text doc/3.audio.examples/J07.oversampling.pd; +#X text 574 554 <-- weird 'bang' feature lets you single-step DSP; +#X text 385 10 [block~] or [switch~]; +#X text 90 161 Note: [block~] is in the subpatch (below) for this example: ; -#X text 317 317 <--- measured time (msec) between blocks; -#X text 245 209 (args are blocksize \, overlap \, up/downsampling) +#X text 168 260 - "set" followed by one to three floats determines +the block size \, overlap \, and resampling for the window (see example +above).; +#X text 98 310 bang; +#X text 168 310 - calculate a single block inside a subpatch (see below) ; -#X connect 0 0 1 0; +#N canvas 0 22 581 315 bang_message 0; +#X text 32 11 You can use the switch~ object to single-step dsp in +a subpatch. This might be useful for block operations that don't want +to be synced to the sample clock: loading a wondiw function in a table +\, or copying one table to another:; +#X obj 136 193 noise~; +#X obj 136 225 tabwrite~ zzzz; +#X obj 33 154 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 -1 +-1; +#N canvas 0 22 450 300 (subpatch) 0; +#X array zzzz 256 float 2 black black; +#X coords 0 1 256 -1 256 140 1; +#X restore 300 116 graph; +#X obj 33 228 switch~ 256; +#X text 25 111 turn DSP on and click to; +#X text 26 127 randomize the table at right:; #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 41 457 pd block-example; -#N canvas 112 205 599 297 block-interations 0; -#X text 32 61 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 33 209 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 wierdness.; -#X text 31 128 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 32 11 INTERACTIONS BETWEEN BLOCK~/SWITCH~ AND OTHER OBJECTS -IN PD; -#X restore 40 482 pd block-interations; -#X text 227 483 INTERACTIONS WITH OTHER OBJECTS; -#X text 44 269 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 text 45 395 Switch~ takes a "bang" message that 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 337 604 updated for Pd version 0.4; +#X connect 3 0 2 0; +#X connect 3 0 5 0; +#X restore 420 554 pd bang_message; +#X connect 18 0 27 0; +#X connect 19 0 27 0; +#X connect 20 0 27 0; +#X connect 21 0 27 0; +#X connect 22 0 27 0; +#X connect 27 0 11 0; diff --git a/pd/doc/5.reference/bng-help.pd b/pd/doc/5.reference/bng-help.pd index d48d560a9..30d61627a 100644 --- a/pd/doc/5.reference/bng-help.pd +++ b/pd/doc/5.reference/bng-help.pd @@ -1,265 +1,443 @@ -#N canvas 11 201 538 357 10; -#X obj 1 1 cnv 8 100 60 empty empty bng 20 20 1 18 -262144 -1109 0 -; -#X text 10 288 (c) musil@iem.kug.ac.at; -#X text 52 301 IEM KUG; -#X text 118 61 click properties to; -#X text 106 72 modify geometry \, colors \, etc.; -#X obj 64 257 print; -#N canvas 598 330 290 225 once 0; -#X msg 38 73 1; -#X obj 38 47 t b b; -#X obj 68 124 sel 0; -#X obj 68 103 f 0; +#N canvas 433 35 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 bng 3 12 0 18 -204280 +-1 0; +#X obj 0 300 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 504 285 494 344 META 0; +#X text 12 115 LIBRARY internal; +#X text 12 25 LICENSE SIBSD; +#X text 12 135 AUTHOR Thomas Musil; +#X text 12 155 WEBSITE; +#X text 12 195 HELP_PATCH_AUTHORS Jonathan Wilkes revised the patch +to conform to the PDDP template for Pd version 0.42.; +#X text 12 45 DESCRIPTION gui-bang; +#X text 12 65 INLET_0 anything size flashtime init send receive label +label_pos label_font color pos delta; +#X text 12 95 OUTLET_0 bang; +#X text 12 5 KEYWORDS control nonlocal GUI bang_op; +#X text 12 175 RELEASE_DATE 2009; +#X restore 500 597 pd META; +#X obj 0 408 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 445 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 547 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#X obj 78 309 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#N canvas 220 497 428 129 Related_objects 0; +#X obj 22 43 bang; +#X obj 69 43 trigger; +#X obj 145 43 until; +#X obj 201 43 bang~; +#X msg 257 43; +#X obj 20 93 x_all_guis bng tgl vsl hsl hradio vradio vu cnv nbx; +#X text 18 69 All iem-gui objects:; +#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 [bng] Related Objects; +#X restore 101 597 pd Related_objects; +#X text 98 417 bang; +#X obj 78 417 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 308 anything; +#X obj 526 13 bng 15 250 50 0 foo5_rcv empty empty 17 7 0 10 -262144 +-1 -1; +#X obj 144 227 print; +#N canvas 598 330 187 198 once 0; +#X msg 38 77 1; +#X obj 38 51 t b b; +#X obj 68 133 sel 0; +#X obj 68 107 f 0; #X obj 38 24 inlet; -#X obj 68 154 outlet; +#X obj 68 163 outlet; #X connect 0 0 3 1; #X connect 1 0 0 0; #X connect 1 1 3 0; #X connect 2 0 5 0; #X connect 3 0 2 0; #X connect 4 0 1 0; -#X restore 64 234 pd once; -#X obj 36 258 bng 15 250 50 0 empty empty empty 8 -8 0 10 -262144 -1 --1; -#X obj 3 130 bng 15 250 50 0 empty empty empty 8 -8 0 10 -262144 -1 +#X restore 144 203 pd once; +#X obj 116 228 bng 15 250 50 0 empty empty empty 8 -8 0 10 -262144 +-1 -1; +#X obj 75 110 bng 15 250 50 0 empty empty empty 8 -8 0 10 -262144 -1 -1; -#X obj 36 173 bng 50 950 50 1 foo5_snd foo5_rcv big-bang 63 2 192 12 +#X obj 116 148 bng 50 950 50 1 foo5_snd foo5_rcv big-bang 57 25 0 12 -262131 -260818 -143491; -#X msg 36 53 33; -#X msg 50 75 -3.14; -#X msg 73 117 11 22 33.33; -#X msg 63 95 open xxx; -#X msg 96 142 funny; -#X text 101 11 gui-bang:; -#X obj 202 135 s foo5_rcv; -#X obj 202 155 r foo5_snd; -#X obj 202 115 bng 15 250 50 0 empty empty empty 8 -8 0 10 -262144 --1 -1; -#X obj 202 175 bng 15 250 50 0 empty empty empty 8 -8 0 10 -262144 +#X msg 116 49 33; +#X msg 157 49 -3.14; +#X msg 180 97 11 22 33.33; +#X msg 170 73 open xxx; +#X msg 187 121 funny; +#X obj 292 72 s foo5_rcv; +#X obj 292 102 r foo5_snd; +#X obj 292 53 bng 15 250 50 0 empty empty empty 8 -8 0 10 -262144 -1 +-1; +#X obj 292 126 bng 15 250 50 0 empty empty empty 8 -8 0 10 -262144 -1 -1; -#X msg 4 53 0; -#X text 125 205 UP- \, DOWN- \, LEFT- or RIGHT-key; -#X text 124 216 for moving selected gui-objects; -#N canvas 425 170 699 530 edit 0; -#X obj 39 197 f; -#X msg 17 176 bang; -#X floatatom 55 175 3 63 88; -#X floatatom 90 197 3 0 37; -#X obj 39 220 pack 0 0; -#X text 117 197 y-label; -#X text 83 175 x-label; -#X floatatom 259 143 3 8 75; -#X text 286 143 size; -#X obj 279 236 f; -#X msg 257 215 bang; -#X floatatom 295 214 3 -10 10; -#X floatatom 330 236 3 -10 10; -#X obj 279 259 pack 0 0; -#X obj 304 348 f; -#X msg 282 327 bang; -#X floatatom 320 326 3 20 90; -#X floatatom 355 348 3 150 200; -#X obj 304 371 pack 0 0; -#X text 323 214 x-delta; -#X text 357 236 y-delta; -#X text 348 326 x-position; -#X text 382 348 y-position; -#X obj 59 312 f; -#X msg 37 291 bang; -#X floatatom 75 290 3 0 2; -#X floatatom 110 312 3 4 36; -#X obj 59 335 pack 0 0; -#X text 103 290 font; -#X text 139 312 height; -#X msg 36 399 \; foo5_rcv label blabla; -#X msg 59 360 \; foo5_rcv label_font \$1 \$2; -#X msg 39 245 \; foo5_rcv label_pos \$1 \$2; -#X msg 47 135 \; foo5_rcv color \$1 \$2 \$3; -#X msg 259 172 \; foo5_rcv size \$1; -#X msg 279 284 \; foo5_rcv delta \$1 \$2; -#X msg 304 396 \; foo5_rcv pos \$1 \$2; -#X msg 483 133 \; foo5_rcv receive foo5a_rcv; -#X msg 482 171 \; foo5a_rcv receive foo5_rcv; -#X msg 483 50 \; foo5_rcv send foo5a_snd; -#X msg 483 88 \; foo5_rcv send foo5_snd; -#X text 526 349 no init; -#X msg 505 368 \; foo5_rcv init 0; -#X msg 512 435 \; foo5_rcv init 1; -#X obj 493 260 f; -#X msg 471 239 bang; -#X floatatom 509 238 4 10 100; -#X floatatom 544 261 5 100 3000; -#X obj 493 283 pack 0 0; -#X msg 493 308 \; foo5_rcv flashtime \$1 \$2; -#X text 548 237 interrupt-time; -#X text 585 262 hold-time; -#X msg 36 435 \; foo5_rcv label big-bang; -#X text 502 417 init bang on loadbang; -#X text 519 221 flash-time:; -#X obj 47 114 pack 0 0 0; -#X obj 47 86 f; -#X msg 24 38 bang; -#X floatatom 63 36 3 0 29; -#X floatatom 79 56 3 0 29; -#X floatatom 112 72 3 0 29; -#X text 91 36 background; -#X text 106 56 front-color; -#X text 140 73 label-color; -#X msg 285 35 back; -#X msg 285 55 front; -#X msg 285 75 label; -#X msg 247 35 bang; -#N canvas 15 207 606 448 RGB_____________ 0; -#X obj 97 56 inlet; -#X obj 262 53 inlet; -#X obj 339 55 inlet; -#X obj 405 56 inlet; -#X obj 97 270 bang; -#X msg 77 295 0; -#X msg 104 295 1; -#X obj 146 268 bang; -#X msg 132 295 0; -#X msg 160 295 1; -#X obj 196 269 bang; -#X msg 187 295 0; -#X msg 214 295 1; -#X obj 265 313 spigot; -#X obj 312 313 spigot; -#X obj 359 313 spigot; -#X obj 249 385 outlet; -#X text 93 33 select; -#X text 267 28 red; -#X text 337 30 green; -#X text 409 30 blue; -#X obj 405 102 t b f; -#X obj 339 160 +; -#X obj 339 185 t b f; -#X obj 339 216 +; -#X obj 296 385 outlet; -#X obj 343 385 outlet; -#X obj 28 180 loadbang; -#X obj 97 135 route back front label bang; -#X obj 343 362 f; -#X obj 296 361 f; -#X obj 249 361 f; -#X obj 262 79 * -65536; -#X obj 339 80 * -256; -#X obj 405 80 * -1; -#X obj 339 247 - 1; -#X obj 235 168 t b b b b; -#X connect 0 0 28 0; -#X connect 1 0 32 0; -#X connect 2 0 33 0; -#X connect 3 0 34 0; -#X connect 4 0 5 0; -#X connect 4 0 6 0; -#X connect 5 0 14 1; -#X connect 5 0 15 1; -#X connect 6 0 13 1; -#X connect 7 0 8 0; -#X connect 7 0 9 0; -#X connect 8 0 13 1; -#X connect 8 0 15 1; -#X connect 9 0 14 1; +#X msg 75 49 0; +#X text 321 142 and receive names. Right-; +#X text 321 157 click and choose; +#N canvas 85 201 428 309 bng_creation_arguments 0; +#X text 12 28 "bng" can be called with 14 creation arguments. These +are not "optional" - all parameters must be filled or the gui-bng will +not instantiate correctly.; +#X text 12 132 For example \, click the msg-box to dynamically create +a bng:; +#X text 12 80 bng creation arguments: Size Hold Interrupt Init sendName +receiveName Label labelXOff labelYOff Font# fontSize bgColor foregroundColor +lblColor; +#X obj 13 196 s pd-bng_creation_arguments; +#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 [bng] Creation Arguments and Dynamic Patching; +#X msg 13 154 obj 180 240 bng 30 500 50 0 send receive Atlas -2 40 +0 12 9 2 18; +#X connect 6 0 3 0; +#X restore 100 519 pd bng_creation_arguments; +#X text 320 173 "Properties" to set them \,; +#X text 320 126 [bng] has settable send; +#X text 110 250 Use the UP- \, DOWN- \, LEFT- or RIGHT-key to move +a selected gui-object. Right-click and choose "Properties" to modify +its appearance.; +#X text 321 187 or change them with messages; +#X text 321 201 (see the subpatch below); +#N canvas 48 5 428 610 Changing_GUI_Properties 0; +#X text 239 33 no init; +#X text 270 159 label position; +#X text 167 451 delta; +#X text 11 294 font properties; +#X text 151 159 label; +#X text 15 451 position; +#X msg 13 103 size \$1; +#X msg 104 104 flashtime \$1 \$2; +#X msg 239 54 init 0; +#X msg 249 104 init 1; +#X msg 321 54 send foo5a_snd; +#X msg 151 180 label new-label; +#X msg 272 231 label_pos \$1 \$2; +#X msg 13 366 label_font \$1 \$2; +#X msg 16 558 pos \$1 \$2; +#X msg 168 558 delta \$1 \$2; +#X text 171 294 preset-colors; +#X text 297 294 RGB-colors; +#X msg 171 401 color \$1 \$2 \$3; +#X msg 329 104 send bng-snd; +#X obj 13 127 s bng_rcv; +#X obj 104 128 s bng_rcv; +#X obj 239 129 s bng_rcv; +#X obj 321 129 s bng_rcv; +#X obj 13 255 s bng_rcv; +#X obj 23 230 s bng1a_rcv; +#X obj 151 256 s bng_rcv; +#X obj 272 256 s bng_rcv; +#X obj 13 391 s bng_rcv; +#X obj 171 426 s bng_rcv; +#X obj 168 583 s bng_rcv; +#X obj 16 583 s bng_rcv; +#X msg 23 206 receive bng_rcv; +#X msg 13 180 receive bng1a_rcv; +#X msg 163 231 label myBang; +#N canvas 375 166 160 287 init 0; +#X obj 16 11 loadbang; +#X obj 16 42 f \$0; +#X msg 16 72 \; \$1-interrupt 50 \; \$1-hold 250 \; \$1-xpos 340 \; +\$1-ypos 500 \; \$1-xlabel 17 \; \$1-ylabel 7 \; \$1-dim 15 \; \$1-font +0 \; \$1-font-size 10 \; \$1-bg 0 \; \$1-front 12 \; \$1-label 12; +#X connect 0 0 1 0; +#X connect 1 0 2 0; +#X restore 320 583 pd init; +#X text 320 33 change send name; +#X text 13 159 change receive name; +#N canvas 366 206 174 259 flash-time 0; +#X obj 68 180 pack; +#X obj 103 149 t b a; +#X obj 68 205 outlet; +#X obj 103 104 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-interrupt empty +0 -8 0 12 -262144 -1 -1 50 256 0; +#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-hold empty 0 +-8 0 12 -262144 -1 -1 250 256 0; +#X connect 0 0 2 0; +#X connect 1 0 0 0; +#X connect 1 1 0 1; +#X connect 3 0 0 0; +#X connect 4 0 1 0; +#X coords 0 -1 1 1 48 42 2 100 100; +#X restore 104 54 pd flash-time; +#X text 101 33 flash-time; +#X text 12 32 dimensions; +#N canvas 364 205 306 317 flash-time 0; +#X obj 69 196 t b a; +#X obj 33 262 outlet; +#X obj 33 237 pack 0 0 0; +#X obj 120 197 t b a; +#X obj 103 104 nbx 3 14 0 29 0 0 \$0-dummy \$0-bg empty 0 -8 0 12 -262144 +-1 -1 0 256 0; +#X obj 103 124 nbx 3 14 0 29 0 0 \$0-dummy \$0-front empty 0 -8 0 12 +-262144 -1 -1 12 256 0; +#X obj 103 144 nbx 3 14 0 29 0 0 \$0-dummy \$0-label empty 0 -8 0 12 +-262144 -1 -1 12 256 0; +#X connect 0 0 2 0; +#X connect 0 1 2 1; +#X connect 2 0 1 0; +#X connect 3 0 2 0; +#X connect 3 1 2 2; +#X connect 4 0 2 0; +#X connect 5 0 0 0; +#X connect 6 0 3 0; +#X coords 0 -1 1 1 48 62 2 100 100; +#X restore 171 316 pd flash-time; +#N canvas 0 0 306 317 flash-time 0; +#X obj 96 521 outlet; +#X obj 162 230 t b f; +#X obj 96 268 +; +#X obj 96 293 t b f; +#X obj 96 324 +; +#X obj 19 208 * -65536; +#X obj 96 208 * -256; +#X obj 162 208 * -1; +#X obj 96 355 - 1; +#X obj 96 385 list prepend 0; +#X obj 96 410 route 0 1 2; +#X obj 96 497 pack 0 0 0; +#X obj 115 456 t b a; +#X obj 168 455 t b a; +#X obj 104 124 vradio 15 1 0 3 empty empty empty 0 -8 0 10 -262144 +-1 -1 0; +#X text 120 120 1.bg; +#X text 120 137 2.front; +#X text 120 153 3.label; +#X obj 103 105 nbx 3 14 0 255 0 0 \$0-dummy \$0-r empty 0 -8 0 10 -262144 +-258113 -1 0 256 0; +#X obj 133 105 nbx 3 14 0 255 0 0 \$0-dummy \$0-g empty 0 -8 0 10 -262144 +-13381 -1 0 256 0; +#X obj 163 105 nbx 3 14 0 255 0 0 \$0-dummy \$0-b empty 0 -8 0 10 -262144 +-4160 -1 0 256 0; +#X connect 1 0 2 0; +#X connect 1 1 2 1; +#X connect 2 0 3 0; +#X connect 3 0 4 0; +#X connect 3 1 4 1; +#X connect 4 0 8 0; +#X connect 5 0 4 0; +#X connect 6 0 2 0; +#X connect 7 0 1 0; +#X connect 8 0 9 0; +#X connect 9 0 10 0; #X connect 10 0 11 0; -#X connect 10 0 12 0; -#X connect 11 0 13 1; -#X connect 11 0 14 1; -#X connect 12 0 15 1; -#X connect 13 0 31 1; -#X connect 14 0 30 1; -#X connect 15 0 29 1; -#X connect 21 0 22 0; -#X connect 21 1 22 1; -#X connect 22 0 23 0; -#X connect 23 0 24 0; -#X connect 23 1 24 1; -#X connect 24 0 35 0; -#X connect 27 0 6 0; -#X connect 28 0 4 0; -#X connect 28 1 7 0; -#X connect 28 2 10 0; -#X connect 28 3 36 0; -#X connect 29 0 26 0; -#X connect 30 0 25 0; -#X connect 31 0 16 0; -#X connect 32 0 24 0; -#X connect 33 0 22 0; -#X connect 34 0 21 0; -#X connect 35 0 15 0; -#X connect 35 0 14 0; -#X connect 35 0 13 0; -#X connect 36 0 31 0; -#X connect 36 1 30 0; -#X connect 36 2 29 0; -#X connect 36 3 35 0; -#X restore 285 96 pd RGB_____________; -#X floatatom 327 65 3 0 255; -#X floatatom 370 65 3 0 255; -#X floatatom 413 66 3 0 255; -#X text 34 10 preset-colors; -#X text 296 7 RGB-colors; -#X text 327 47 red; -#X text 363 46 green; -#X text 411 46 blue; -#X connect 0 0 4 0; +#X connect 10 1 12 0; +#X connect 10 2 13 0; +#X connect 11 0 0 0; +#X connect 12 0 11 0; +#X connect 12 1 11 1; +#X connect 13 0 11 0; +#X connect 13 1 11 2; +#X connect 14 0 9 1; +#X connect 18 0 5 0; +#X connect 19 0 6 0; +#X connect 20 0 7 0; +#X coords 0 -1 1 1 102 74 2 100 100; +#X restore 298 316 pd flash-time; +#X text 248 72 init on; +#X text 248 85 loadbang; +#X obj 168 534 list; +#X obj 168 473 bng 20 250 50 0 empty empty empty 17 7 0 10 -262144 +-1 -1; +#X obj 310 466 cnv 15 102 102 empty empty empty 20 12 0 14 -1 -66577 +0; +#X obj 311 467 cnv 15 100 100 empty empty empty 20 12 0 14 -261682 +-66577 0; +#X obj 340 500 bng 15 250 50 1 bng-snd bng_rcv myBang 17 7 0 10 -262144 +-33289 -33289; +#X text 62 318 1.font(0-2); +#X text 62 339 2.height; +#X text 220 318 1.bg; +#X text 220 338 2.front; +#X text 220 359 3.label; +#X text 64 472 1.x-position; +#X text 64 494 2.y-position; +#X text 247 472 1.x-delta; +#X text 247 494 2.y-delta; +#X obj 13 53 nbx 3 14 8 200 0 0 empty \$0-dim empty 0 -8 0 12 -262144 +-1 -1 15 256 0; +#X text 58 51 size; +#N canvas 366 206 174 259 flash-time 0; +#X obj 68 180 pack; +#X obj 103 149 t b a; +#X obj 68 205 outlet; +#X obj 103 104 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-xlabel empty +0 -8 0 12 -262144 -1 -1 17 256 0; +#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-ylabel empty +0 -8 0 12 -262144 -1 -1 7 256 0; +#X connect 0 0 2 0; #X connect 1 0 0 0; -#X connect 2 0 0 1; -#X connect 3 0 4 1; -#X connect 4 0 32 0; -#X connect 7 0 34 0; -#X connect 9 0 13 0; -#X connect 10 0 9 0; -#X connect 11 0 9 1; -#X connect 12 0 13 1; -#X connect 13 0 35 0; -#X connect 14 0 18 0; -#X connect 15 0 14 0; -#X connect 16 0 14 1; -#X connect 17 0 18 1; -#X connect 18 0 36 0; -#X connect 23 0 27 0; -#X connect 24 0 23 0; -#X connect 25 0 23 1; -#X connect 26 0 27 1; -#X connect 27 0 31 0; -#X connect 44 0 48 0; -#X connect 45 0 44 0; -#X connect 46 0 44 1; -#X connect 47 0 48 1; -#X connect 48 0 49 0; -#X connect 55 0 33 0; -#X connect 56 0 55 0; -#X connect 57 0 56 0; -#X connect 58 0 56 1; -#X connect 59 0 55 1; -#X connect 60 0 55 2; -#X connect 64 0 68 0; -#X connect 65 0 68 0; -#X connect 66 0 68 0; -#X connect 67 0 68 0; -#X connect 68 0 55 0; -#X connect 68 1 55 1; -#X connect 68 2 55 2; -#X connect 69 0 68 1; -#X connect 70 0 68 2; -#X connect 71 0 68 3; -#X restore 297 144 pd edit; -#X obj 248 34 bng 15 250 50 0 aaa aaa empty 20 8 192 8 -262144 -1 -1 +#X connect 1 1 0 1; +#X connect 3 0 0 0; +#X connect 4 0 1 0; +#X coords 0 -1 1 1 48 42 2 100 100; +#X restore 272 181 pd flash-time; +#N canvas 366 206 174 259 flash-time 0; +#X obj 68 180 pack; +#X obj 103 149 t b a; +#X obj 68 205 outlet; +#X obj 103 104 nbx 3 14 0 2 0 0 \$0-dummy \$0-font empty 0 -8 0 12 +-262144 -1 -1 0 256 0; +#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-font-size empty +0 -8 0 12 -262144 -1 -1 10 256 0; +#X connect 0 0 2 0; +#X connect 1 0 0 0; +#X connect 1 1 0 1; +#X connect 3 0 0 0; +#X connect 4 0 1 0; +#X coords 0 -1 1 1 48 42 2 100 100; +#X restore 13 316 pd flash-time; +#N canvas 366 206 174 259 flash-time 0; +#X obj 68 180 pack; +#X obj 103 149 t b a; +#X obj 68 205 outlet; +#X obj 103 104 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-xpos empty 0 +-8 0 12 -262144 -1 -1 340 256 0; +#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-ypos empty 0 +-8 0 12 -262144 -1 -1 500 256 0; +#X connect 0 0 2 0; +#X connect 1 0 0 0; +#X connect 1 1 0 1; +#X connect 3 0 0 0; +#X connect 4 0 1 0; +#X coords 0 -1 1 1 48 42 2 100 100; +#X restore 16 473 pd flash-time; +#N canvas 366 206 174 259 flash-time 0; +#X obj 68 180 pack; +#X obj 103 149 t b a; +#X obj 68 205 outlet; +#X obj 103 104 nbx 3 14 -20 20 0 0 \$0-dummy \$0-xdelta empty 0 -8 +0 12 -262144 -1 -1 0 256 0; +#X obj 103 124 nbx 3 14 -20 20 0 0 \$0-dummy \$0-ydelta empty 0 -8 +0 12 -262144 -1 -1 0 256 0; +#X connect 0 0 2 0; +#X connect 1 0 0 0; +#X connect 1 1 0 1; +#X connect 3 0 0 0; +#X connect 4 0 1 0; +#X coords 0 -1 1 1 48 42 2 100 100; +#X restore 197 473 pd flash-time; +#X text 321 203 2.y-offset; +#X text 321 182 1.x-offset; +#X text 153 56 1.interrupt; +#X text 153 76 2.hold; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 6 2 [bng] Changing Properties through Messages; +#X connect 6 0 20 0; +#X connect 7 0 21 0; +#X connect 8 0 22 0; +#X connect 9 0 22 0; +#X connect 10 0 23 0; +#X connect 11 0 26 0; +#X connect 12 0 27 0; +#X connect 13 0 28 0; +#X connect 14 0 31 0; +#X connect 15 0 30 0; +#X connect 18 0 29 0; +#X connect 19 0 23 0; +#X connect 32 0 25 0; +#X connect 33 0 24 0; +#X connect 34 0 26 0; +#X connect 38 0 7 0; +#X connect 41 0 18 0; +#X connect 42 0 18 0; +#X connect 45 0 15 0; +#X connect 46 0 45 0; +#X connect 59 0 6 0; +#X connect 61 0 12 0; +#X connect 62 0 13 0; +#X connect 63 0 14 0; +#X connect 64 0 45 1; +#X restore 101 380 pd Changing_GUI_Properties; +#X text 168 463 - creating a [bng] without any arguments will set default +values for all gui-properties. See the subpatch below to learn how +to dynamically instantiate a [bng] object with custom properties:; +#X text 11 23 gui-bang; +#N canvas 43 24 428 573 bng_properties 0; +#X text 22 53 1 Size; +#X obj 104 60 bng 8 250 50 0 empty empty 8 10 4 0 8 -262144 -1 -1; +#X obj 129 53 bng 15 250 50 0 empty empty 15 17 9 0 8 -262144 -1 -1 ; -#X text 185 312 updated for Pd version 0.35; -#X text 27 313 graz \, austria 2002; -#X obj 180 11 x_all_guis aaa bbb ccc ddd eee fff ggg hhh iii; -#X connect 6 0 5 0; -#X connect 8 0 9 0; -#X connect 9 0 7 0; -#X connect 9 0 6 0; -#X connect 10 0 9 0; -#X connect 11 0 9 0; -#X connect 12 0 9 0; -#X connect 13 0 9 0; -#X connect 14 0 9 0; -#X connect 17 0 19 0; -#X connect 18 0 16 0; -#X connect 20 0 9 0; +#X obj 164 43 bng 25 250 50 0 empty empty 25 27 20 0 8 -262144 -1 -1 +; +#X text 51 75 Default size is 15 pixels. The minimum size is 8 and +it does not have a maximum size.; +#X text 23 258 3 Hold; +#X obj 93 258 bng 15 50 10 0 empty empty 50 17 8 0 8 -262144 -1 -1 +; +#X obj 128 258 bng 15 750 50 0 empty empty 750 17 8 0 8 -262144 -1 +-1; +#X text 23 341 4 Receive Symbol/Send Symbol; +#X text 49 356 This object can act as its own send or receive object. +; +#X obj 41 391 bng 15 250 50 0 link_this_bang empty This_one_sends_a_bang +17 8 0 10 -262144 -1 -1; +#X obj 41 412 bng 15 250 50 0 empty link_this_bang This_one_receives_it. +17 8 0 10 -262144 -1 -1; +#X text 232 370 Here is the alternative method.; +#X text 26 447 5 GUI Options; +#X text 49 469 The other properties are 'name' \, 'x/y offset' \, 'font +size' \, and colours (for the background \, front \, and labels [name]) +; +#X text 48 275 The default hold is 250 milliseconds. The hold value +controls the length of time that the bng object stays "lit". Note that +bng sends its message immediately regardless of the hold value.; +#X obj 233 436 s linked_bngs; +#X obj 338 389 r linked_bngs; +#X text 22 105 2 Interrupt (milliseconds); +#X text 48 119 If the bng object is "lit" and holding (see "hold" below) +\, then receives another message before the hold time has passed \, +the bng will quickly flash again for the duration you set in this interrupt +property.; +#X obj 24 203 bng 15 1000 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X text 47 187 This bng will hold for 1000 milliseconds \, but interrupt +for 50 milliseconds if it gets a second message during its "hold". +Click it once...wait. Then click it multiple times rather quickly to +see the effect.; +#X obj 233 413 bang; +#X obj 338 413 bang; +#X msg 233 389 send a message; +#X text 18 510 This document was updated for Pd version 0.35 test 24 +by Dave Sabine as part of a project called pddp proposed by Krzysztof +Czaja to build comprehensive documentation for Pd.; +#X obj 338 439 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 +-1 -1; +#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 [bng] Properties; +#X connect 17 0 23 0; +#X connect 22 0 16 0; +#X connect 23 0 26 0; +#X connect 24 0 22 0; +#X restore 101 556 pd bng_properties; +#X text 80 463 14; +#X text 215 551 (c) musil@iem.kug.ac.at; +#X text 257 564 IEM KUG; +#X text 232 576 graz \, austria 2002; +#X text 168 418 - [bng] only outputs a bang message.; +#X text 168 308 - [bng] outputs a bang message in response to any message +that has not been defined to affect gui-properties (see below).; +#X text 98 346 See the following subpatch for messages that change +the gui-properties of [bng]:; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X connect 14 0 13 0; +#X connect 16 0 17 0; +#X connect 17 0 15 0; +#X connect 17 0 14 0; +#X connect 18 0 17 0; +#X connect 19 0 17 0; +#X connect 20 0 17 0; +#X connect 21 0 17 0; +#X connect 22 0 17 0; +#X connect 24 0 26 0; +#X connect 25 0 23 0; +#X connect 27 0 17 0; diff --git a/doc/pddp/bonk~-help.pd b/pd/doc/5.reference/bonk~-help.pd similarity index 100% rename from doc/pddp/bonk~-help.pd rename to pd/doc/5.reference/bonk~-help.pd diff --git a/pd/doc/5.reference/bp~-help.pd b/pd/doc/5.reference/bp~-help.pd index 8bcd86b45..6d44475b8 100644 --- a/pd/doc/5.reference/bp~-help.pd +++ b/pd/doc/5.reference/bp~-help.pd @@ -1,40 +1,88 @@ -#N canvas 533 67 651 393 12; -#X obj 124 11 bp~; -#X text 159 11 - BANDPASS FILTER; -#X obj 70 263 env~; -#X floatatom 70 283 0 0 0; -#X floatatom 104 193 0 0 0; -#X obj 12 261 env~; -#X floatatom 12 282 0 0 0; -#X text 119 264 env~ gives the amplitude of the signal envelop in dB. -; -#X floatatom 12 123 0 0 0; -#X msg 544 67 \; pd dsp 0; -#X obj 12 146 osc~ 100; -#X text 57 121 <-- scroll to change input frequency; -#X msg 72 170 clear; -#X text 122 169 <-- reinitialize internal state; -#X text 398 361 updated for Pd version-0.30; -#X msg 544 28 \; pd dsp 1; -#X text 13 73 The left inlet is the incoming audio signal \, the middle -control input sets center frequency and the rigth input sets "Q".; -#X text 136 194 <-- center frequency; -#X obj 72 241 bp~ 100 10; -#X text 169 242 Arguments initialize center frequency and Q.; -#X text 12 301 Compare the amplitude of the original signal on the +#N canvas 428 36 555 619 10; +#X obj -1 595 cnv 15 552 21 empty \$0-pddp.cnv.footer empty 20 12 0 +14 -228856 -66577 0; +#X obj -1 0 cnv 15 552 40 empty \$0-pddp.cnv.header bp~ 3 12 0 18 -204280 +-1 0; +#X obj -1 364 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 483 262 494 367 META 0; +#X text 12 185 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 165 AUTHOR Miller Puckette; +#X text 12 225 HELP_PATCH_AUTHORS Updated for Pd version-0.30. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 5 KEYWORDS signal filter; +#X text 12 145 LIBRARY internal; +#X text 12 45 DESCRIPTION bandpass filter; +#X text 12 65 INLET_0 signal; +#X text 12 85 INLET_1 float; +#X text 12 105 INLET_2 float; +#X text 12 125 OUTLET_0 signal; +#X text 12 205 RELEASE_DATE 2009; +#X restore 500 597 pd META; +#X obj -1 472 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj -1 509 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj -1 568 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 +12 0 13 -228856 -1 0; +#X obj 78 373 cnv 17 3 35 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#N canvas 213 529 428 102 Related_objects 0; +#X obj 21 42 vcf~; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 7 1 [bp~] Related Objects; +#X restore 101 597 pd Related_objects; +#X obj 78 481 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 502 11 bp~; +#X obj 137 208 env~; +#X floatatom 137 228 0 0 0 0 - - -; +#X floatatom 166 138 0 0 0 0 - - -; +#X obj 78 208 env~; +#X floatatom 78 229 0 0 0 0 - - -; +#X floatatom 78 68 0 0 0 0 - - -; +#X obj 78 91 osc~ 100; +#X msg 138 115 clear; +#X obj 138 186 bp~ 100 10; +#X text 78 258 Compare the amplitude of the original signal on the left with the amplitude of the filtered signal on the right.; -#X floatatom 153 215 0 0 0; -#X text 185 216 <-- Q; -#X text 16 35 bp~ passes a sinusoid at the center frequency at unit +#X floatatom 195 162 0 0 0 0 - - -; +#X text 98 372 signal; +#X obj 78 416 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X text 98 392 clear; +#X text 98 415 float; +#X obj 78 444 cnv 17 3 17 empty \$0-pddp.cnv.let.2 2 5 9 0 16 -228856 +-162280 0; +#X text 98 445 float; +#X text 98 481 signal; +#X text 11 23 bandpass filter; +#X text 168 392 - reinitialize internal state.; +#X text 168 415 - center frequency.; +#X text 168 445 - Q.; +#X text 170 528 - center frequency.; +#X text 170 544 - Q.; +#X text 80 528 1) float; +#X text 80 544 2) float; +#X text 185 209 [env~] gives the amplitude of the signal envelop in +dB.; +#X text 75 297 [bp~] passes a sinusoid at the center frequency at unit gain (approximately). Other frequencies are attenuated.; -#X text 21 357 see also:; -#X obj 110 356 vcf~; -#X connect 2 0 3 0; -#X connect 4 0 18 1; -#X connect 5 0 6 0; -#X connect 8 0 10 0; -#X connect 10 0 5 0; -#X connect 10 0 18 0; -#X connect 12 0 18 0; -#X connect 18 0 2 0; -#X connect 21 0 18 2; +#X text 123 66 <- scroll to change input frequency; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 476 52 pddp/dsp; +#X obj 98 572 pddp/pddplink ../3.audio.examples/H07.measure.spectrum.pd +-text doc/3.audio.examples/H07.measure.spectrum.pd; +#X connect 11 0 12 0; +#X connect 13 0 19 1; +#X connect 14 0 15 0; +#X connect 16 0 17 0; +#X connect 17 0 14 0; +#X connect 17 0 19 0; +#X connect 18 0 19 0; +#X connect 19 0 11 0; +#X connect 21 0 19 2; diff --git a/pd/doc/5.reference/canvas-help.pd b/pd/doc/5.reference/canvas-help.pd index a6e33be52..fbae534b6 100644 --- a/pd/doc/5.reference/canvas-help.pd +++ b/pd/doc/5.reference/canvas-help.pd @@ -1,19 +1,85 @@ -#N canvas 210 82 579 437 12; -#X obj 66 15 table; -#X text 123 16 - Array of numbers; -#X obj 34 199 table help-tab1 25; -#X text 10 43 "Table" builds a subpatch with a graphical array inside. -The creation arguments specify the name and an optional size in points. +#N canvas 429 36 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 (canvas) 3 12 0 +18 -204280 -1 0; +#X obj 0 293 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 482 350 494 280 META 0; +#X text 12 85 LIBRARY internal; +#X text 12 125 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 45 LICENSE SIBSD; +#X text 12 105 AUTHOR Miller Puckette; +#X text 12 165 HELP_PATCH_AUTHORS Updated for Pd v0.41. Revised by +Jonathan Wilkes to conform to the PDDP template for Pd version 0.42. ; -#X msg 70 265 \; help-tab1 read table.txt; -#X msg 70 309 \; help-tab1 write /tmp/table.txt; -#X text 70 243 You can also send messages to the array by name:; -#X text 216 200 <- optional creation args: name \, size; -#X text 17 355 Unfortunately there's no way to set vertical range \, -etc.; -#X text 9 101 Note that the data (and other properties) of the array -aren't saved with the patch. You can resize \, save to and/or read -from an external file as you would with "array" objects. See "arrays" -in the 2.control examples under the "pure documentation" help menu -item.; -#X text 325 391 updated for Pd version 0.35; +#X text 12 25 KEYWORDS signal; +#X text 12 65 DESCRIPTION Pure Data document window; +#X text 12 5 NAME pd table graph; +#X text 12 145 RELEASE_DATE 2009; +#X restore 500 597 pd META; +#X obj 0 508 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 556 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 54 478 428 109 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 1 (canvas) Related Objects; +#N canvas 0 0 450 300 (subpatch) 0; +#X restore 22 42 pd; +#X obj 52 42 table; +#X restore 102 598 pd Related_objects; +#X obj 78 302 cnv 17 3 85 empty \$0-pddp.cnv.let.n n 5 9 0 16 -228856 +-162280 0; +#X text 328 11 (This help patch itself is a canvas); +#X obj 101 560 pddp/pddplink all_about_canvas_properties.pd -text all_about_canvas_properties +; +#X text 72 56 This help patch is associated with several related objects: +; +#X text 73 142 4) root canvas (i.e. \, pd document); +#X text 93 157 Also known simply as a "patch" \, a canvas is a window +that contains a list of pd objects. A canvas can either be a root canvas-- +created from the "File" menu by choosing "new"-- or a subcanvas (like +one of the objects listed above).; +#X text 98 301 anything; +#X obj 377 76 pddp/pddplink pd-help.pd -text See pd-help; +#X text 73 76 1) [pd] - subcanvas \, a.k.a. subpatch or subwindow. +; +#X text 73 98 2) [table] - array of numbers.; +#X obj 257 98 pddp/pddplink table-help.pd -text See table-help; +#X text 73 120 3) graph (available from the "Put" menu).; +#X obj 322 120 pddp/pddplink graph-help.pd -text See graph-help; +#X text 62 122 *; +#X text 62 229 * If you're new to Pd \, it's easy to get graphs mixed +up with garrays (i.e. \, "Array" from the "Put" menu). For help on +garrays \, click below:; +#X obj 170 328 pddp/pddplink inlet-help.pd -text inlet-help; +#X text 98 347 signal; +#X obj 170 374 pddp/pddplink inlet~-help.pd -text inlet~-help; +#X obj 0 398 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 78 407 cnv 17 3 90 empty \$0-pddp.cnv.let.n n 5 9 0 16 -228856 +-162280 0; +#X text 98 406 anything; +#X obj 170 433 pddp/pddplink outlet-help.pd -text outlet-help; +#X text 98 453 signal; +#X obj 170 480 pddp/pddplink outlet~-help.pd -text outlet~-help; +#X text 168 453 - outlets for signals can be created by using [outlet~] +objects on the canvas. See the links below for more details:; +#X text 168 347 - inlets for signals can be created by using [inlet~] +objects on the canvas. See the links below for more details:; +#X text 98 512 (5); +#X text 168 512 - canvas arguments are 5 floats which are not directly +accessible: topLeftX topLeftY canvasWidth canvasHeight fontSize.; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 101 575 pddp/pddplink ../3.audio.examples/G05.execution.order.pd +-text doc/3.audio.examples/G05.execution.order.pd; +#X text 11 23 Pure Data document window; +#X text 168 301 - control inlets can be created by using [inlet] objects +on the canvas. See the links below for more details:; +#X text 168 406 - control outlets can be created by using [outlet] +objects on the canvas. See the links below for more details:; +#X obj 62 270 pddp/pddplink array-help.pd -text Help patch for "Put" +menu array; diff --git a/doc/pddp/catch~-help.pd b/pd/doc/5.reference/catch~-help.pd similarity index 100% rename from doc/pddp/catch~-help.pd rename to pd/doc/5.reference/catch~-help.pd diff --git a/pd/doc/5.reference/change-help.pd b/pd/doc/5.reference/change-help.pd index 74e16f6a4..6e478cda5 100644 --- a/pd/doc/5.reference/change-help.pd +++ b/pd/doc/5.reference/change-help.pd @@ -1,23 +1,102 @@ -#N canvas 376 130 540 355 12; -#X msg 67 124 bang; -#X floatatom 67 266 0 0 0; -#X floatatom 79 154 0 0 0; -#X floatatom 104 182 0 0 0; -#X text 284 309 updated for Pd version 0.27; -#X text 173 239 creation argument initializes first value; -#X obj 66 15 change; -#X text 114 16 - ELIMINATE REDUNDANCY IN A NUMBER STEAM; -#X text 12 42 The change object outputs its input only when it changes. -You can "set" the current value \, or bang to force output.; -#X obj 67 240 change 6.5; -#X msg 105 211 set \$1; -#X text 136 183 set the value; -#X text 112 123 output current value; -#X text 110 154 if different from current value \, output and set; -#X obj 67 293 print; -#X connect 0 0 9 0; -#X connect 1 0 14 0; -#X connect 2 0 9 0; -#X connect 3 0 10 0; -#X connect 9 0 1 0; -#X connect 10 0 9 0; +#N canvas 424 45 555 619 10; +#X obj -1 595 cnv 15 552 21 empty \$0-pddp.cnv.footer empty 20 12 0 +14 -228856 -66577 0; +#X obj -1 0 cnv 15 552 40 empty \$0-pddp.cnv.header change 3 12 0 18 +-204280 -1 0; +#X obj -1 337 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 479 297 494 344 META 0; +#X text 12 105 LIBRARY internal; +#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 125 AUTHOR Miller Puckette; +#X text 12 185 HELP_PATCH_AUTHORS This document was updated for Pd +version 0.35 test 26 by Dave Sabine as part of a project called pddp +proposed by Krzysztof Czaja to build comprehensive documentation for +Pd. Jonathan Wilkes revised the patch to conform to the PDDP template +for Pd version 0.42.; +#X text 12 5 KEYWORDS control filter; +#X text 12 45 DESCRIPTION eliminate redundancy in a number stream; +#X text 12 65 INLET_0 float bang set; +#X text 12 85 OUTLET_0 float; +#X text 12 165 RELEASE_DATE 2009; +#X restore 500 597 pd META; +#X obj -1 481 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj -1 524 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj -1 566 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 +12 0 13 -228856 -1 0; +#X obj 78 346 cnv 17 3 125 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#N canvas 210 534 428 104 Related_objects 0; +#X obj 15 31 spigot; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 7 1 [change] Related Objects; +#X obj 65 31 select; +#X restore 101 597 pd Related_objects; +#X obj 78 490 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 499 11 change; +#X msg 22 108 1; +#X msg 50 108 1; +#X msg 79 108 1; +#X msg 112 107 0; +#X text 20 90 Click from left to right...; +#X obj 22 139 change; +#X obj 22 160 print; +#X text 61 161 watch the console; +#X obj 22 218 change 6.5; +#X obj 22 241 print; +#X msg 22 189 6.5; +#X msg 52 189 5.5; +#X msg 88 190 bang; +#X text 93 218 creation argument; +#X text 98 345 bang; +#X text 98 375 float; +#X text 98 405 list; +#X text 98 444 set; +#X floatatom 210 271 0 0 0 0 - - -; +#X floatatom 210 182 0 0 0 0 - - -; +#X floatatom 248 198 0 0 0 0 - - -; +#X msg 248 220 set \$1; +#X text 293 220 set the value; +#X text 247 179 if different from current value \, output and set; +#X obj 210 292 print; +#X obj 210 249 change; +#X text 206 147 The "set" method can be used to store a number in the +object without outputting that value.; +#X text 98 490 float; +#X text 11 23 eliminate redundancy in a number stream; +#X text 167 543 - (optional) a number to specify the initial value. +; +#X text 168 345 - sending a bang message to the inlet will force [change] +to output its current value.; +#X text 168 375 - a float will be output only if it differs from the +previous value of [change].; +#X text 168 405 - lists will be truncated and the first element will +be output only if it differs from the previous value of [change].; +#X text 168 490 - if the incoming float was different than the previous +value \, it will be sent to the outlet.; +#X text 80 543 1) float; +#X text 168 444 "set" followed by a value (e.g. \, "set 12") will set +the value of [change] without outputting it.; +#X text 18 59 The change object passes its input to the outlet only +when it changes.; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X connect 11 0 16 0; +#X connect 12 0 16 0; +#X connect 13 0 16 0; +#X connect 14 0 16 0; +#X connect 16 0 17 0; +#X connect 19 0 20 0; +#X connect 21 0 19 0; +#X connect 22 0 19 0; +#X connect 23 0 19 0; +#X connect 29 0 35 0; +#X connect 30 0 36 0; +#X connect 31 0 32 0; +#X connect 32 0 36 0; +#X connect 36 0 29 0; diff --git a/doc/pddp/choice-help.pd b/pd/doc/5.reference/choice-help.pd similarity index 100% rename from doc/pddp/choice-help.pd rename to pd/doc/5.reference/choice-help.pd diff --git a/pd/doc/5.reference/clip-help.pd b/pd/doc/5.reference/clip-help.pd index a05e73c52..2058dfe06 100644 --- a/pd/doc/5.reference/clip-help.pd +++ b/pd/doc/5.reference/clip-help.pd @@ -1,11 +1,11 @@ -#N canvas 398 77 555 619 10; +#N canvas 424 40 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 clip 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 563 393 378 279 META 0; +#N canvas 478 290 494 344 META 0; #X text 12 145 LIBRARY internal; #X text 12 185 WEBSITE http://crca.ucsd.edu/~msp/; #X text 12 25 LICENSE SIBSD; @@ -21,7 +21,7 @@ Wilkes revised the patch to conform to the PDDP template for Pd version #X text 12 85 INLET_1 float; #X text 12 105 INLET_2 float; #X text 12 205 RELEASE_DATE 2009; -#X restore 502 598 pd META; +#X restore 500 597 pd META; #X obj 0 415 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 13 -228856 -1 0; #X obj 0 458 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 @@ -30,14 +30,14 @@ Wilkes revised the patch to conform to the PDDP template for Pd version 0 13 -228856 -1 0; #X obj 78 306 cnv 17 3 45 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 -162280 0; -#N canvas 176 569 428 102 Related_objects 0; -#X obj 202 42 int; -#X obj 233 42 f; +#N canvas 207 532 428 102 Related_objects 0; +#X obj 234 43 int; +#X obj 274 42 f; #X obj 22 42 min; -#X obj 53 42 max; -#X obj 84 42 clip~; -#X obj 128 42 min~; -#X obj 165 42 max~; +#X obj 65 42 max; +#X obj 105 42 clip~; +#X obj 149 42 min~; +#X obj 191 42 max~; #X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 14 -204280 -1 0; #X text 7 1 [clip] Related Objects; @@ -50,16 +50,16 @@ Wilkes revised the patch to conform to the PDDP template for Pd version #X obj 78 387 cnv 17 3 17 empty \$0-pddp.cnv.let.2 2 5 9 0 16 -228856 -162280 0; #X text 98 386 float; -#X obj 511 5 clip; +#X obj 504 11 clip; #X obj 306 179 clip -50 50; -#X floatatom 306 205 5 0 0 0 - - -; -#X floatatom 306 141 5 0 0 0 - - -; +#X floatatom 306 205 5 0 0 0 - - -, f 5; +#X floatatom 306 141 5 0 0 0 - - -, f 5; #X text 383 177 creation arguments; #X obj 128 179 clip; -#X floatatom 138 140 5 0 0 0 - - -; -#X floatatom 181 140 5 0 0 0 - - -; -#X floatatom 224 140 5 0 0 0 - - -; -#X floatatom 128 205 5 0 0 0 - - -; +#X floatatom 138 140 5 0 0 0 - - -, f 5; +#X floatatom 181 140 5 0 0 0 - - -, f 5; +#X floatatom 224 140 5 0 0 0 - - -, f 5; +#X floatatom 128 205 5 0 0 0 - - -, f 5; #X text 171 179 no arguments; #X text 205 108 list; #X msg 128 108 42 100 500; @@ -69,13 +69,13 @@ low and high values stored in the object.; #X text 98 424 float; #N canvas 102 355 428 206 clip_vs_min_and_max 0; #X text 10 70 Consider the following:; -#X floatatom 50 96 5 0 0 0 - - -; -#X floatatom 50 177 5 0 0 0 - - -; +#X floatatom 50 96 5 0 0 0 - - -, f 5; +#X floatatom 50 177 5 0 0 0 - - -, f 5; #X obj 50 151 min 50; #X obj 50 125 max -50; #X text 137 136 same as; #X obj 257 148 clip -50 50; -#X floatatom 257 177 5 0 0 0 - - -; +#X floatatom 257 177 5 0 0 0 - - -, f 5; #X text 10 37 [clip] is a tool which combines the functionality of [min] and [max] into a single object.; #X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 @@ -94,12 +94,12 @@ inlet) is the high extreme. However \, strange behaviour should be expected if you mix these arguments up.; #X obj 43 155 clip -50 50; #X obj 169 149 clip 72 -104; -#X floatatom 43 122 5 0 0 0 - - -; -#X floatatom 43 184 5 0 0 0 - - -; -#X floatatom 169 181 5 0 0 0 - - -; +#X floatatom 43 122 5 0 0 0 - - -, f 5; +#X floatatom 43 184 5 0 0 0 - - -, f 5; +#X floatatom 169 181 5 0 0 0 - - -, f 5; #X text 174 104 Numbers below 72 are clipped to 72; #X text 174 124 Numbers above -104 are clipped to -104; -#X floatatom 311 258 5 0 0 0 - - -; +#X floatatom 311 258 5 0 0 0 - - -, f 5; #X obj 311 214 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0 1; #X obj 311 236 clip 1 -1024; diff --git a/pd/doc/5.reference/clip~-help.pd b/pd/doc/5.reference/clip~-help.pd index fe7ee6e1c..12dc750bc 100644 --- a/pd/doc/5.reference/clip~-help.pd +++ b/pd/doc/5.reference/clip~-help.pd @@ -1,86 +1,90 @@ -#N canvas 334 144 554 442 10; -#X obj -1 420 cnv 15 552 21 empty \$0-pddp.cnv.footer empty 20 12 0 -14 -233017 -33289 0; -#X obj -1 258 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +#N canvas 425 36 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 clip~ 3 12 0 18 +-204280 -1 0; +#X obj 0 357 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 -228856 -1 0; -#N canvas 440 331 436 231 META 0; -#X text 56 126 WEBSITE http://crca.ucsd.edu/~msp/; -#X text 56 6 LICENSE SIBSD; -#X text 56 106 AUTHOR Miller Puckette; -#X text 56 146 RELEASE_DATE 1997; -#X text 56 -14 KEYWORDS signal constrain clip pass filter range; -#X text 56 26 DESCRIPTION constrains a signal within a certain range +#N canvas 481 286 494 344 META 0; +#X text 12 145 LIBRARY internal; +#X text 12 185 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 165 AUTHOR Miller Puckette; +#X text 12 225 HELP_PATCH_AUTHORS Updated for Pd version 0.33. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 5 KEYWORDS signal filter; +#X text 12 45 DESCRIPTION restrict a signal to lie between two limits ; -#X text 56 46 INLET_0 signal; -#X text 56 66 OUTLET_0 signal; -#X text 56 166 HELP_PATCH_AUTHORS Alex Cleveland updated this patch -for Pd-l2ork version 2013.05.28; -#X text 56 86 LIBRARY internal; -#X restore 500 422 pd META; -#X obj -1 301 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +#X text 12 125 OUTLET_0 signal; +#X text 12 65 INLET_0 signal; +#X text 12 85 INLET_1 float; +#X text 12 105 INLET_2 float; +#X text 12 205 RELEASE_DATE 2009; +#X restore 500 597 pd META; +#X obj 0 449 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 13 -228856 -1 0; -#X obj -1 343 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +#X obj 0 486 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 566 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 0 13 -228856 -1 0; -#N canvas 228 453 427 109 Related_objects 0; -#X obj 0 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +#X obj 78 366 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#N canvas 208 523 428 108 Related_objects 0; +#X obj 23 36 min~; +#X obj 70 36 max~; +#X obj 118 36 clip; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 14 -204280 -1 0; -#X text 6 1 Related Objects; -#X obj 50 29 clip; -#X obj 8 29 Clip~; -#X restore 209 422 pd Related_objects; -#X obj 77 313 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +#X text 7 1 [clip~] Related Objects; +#X restore 101 597 pd Related_objects; +#X text 98 365 signal; +#X obj 78 458 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 -162280 0; -#X obj -1 0 cnv 15 552 40 empty \$0-pddp.cnv.header clip~ 3 12 0 18 --204280 -1 0; -#X text 86 353 1) float; -#X text 87 374 2) float; -#X text 11 23 Constrains a signal within a certain range; -#X obj 67 223 tabwrite~ \$0-a; -#N canvas 0 0 450 300 (subpatch) 0; -#X array \$0-a 100 float 3; -#A 0 0.169761 0.183715 0.197062 0.209759 0.221755 0.233017 0.243509 -0.253192 0.262032 0.270007 0.277088 0.283244 0.288464 0.292732 0.296021 -0.298331 0.299656 0.299982 0.299313 0.297655 0.295009 0.291381 0.286791 -0.281251 0.274772 0.267385 0.259116 0.24998 0.240017 0.229262 0.217743 -0.205501 0.192581 0.179021 0.164865 0.150165 0.134968 0.11932 0.103277 -0.086894 0.0702202 0.0533143 0.0362322 0.0190294 0.00176354 -0.0155081 --0.0327286 -0.0498398 -0.0667862 -0.0835123 -0.099959 -0.116075 -0.131808 --0.147102 -0.161907 -0.176178 -0.189864 -0.202918 -0.215301 -0.226972 --0.237885 -0.248012 -0.257321 -0.265768 -0.273337 -0.280004 -0.285736 --0.290522 -0.294348 -0.297196 -0.299055 -0.299926 -0.299804 -0.298682 --0.296573 -0.293485 -0.289414 -0.284388 -0.278422 -0.271528 -0.263733 --0.255068 -0.245555 -0.235225 -0.224118 -0.21227 -0.199712 -0.186495 --0.172661 -0.158251 -0.143317 -0.12791 -0.112077 -0.0958714 -0.0793497 --0.0625643 -0.0455707 -0.0284267 -0.0111884 0.00608727; -#X coords 0 1 99 -1 100 75 1; -#X restore 378 114 graph; -#X obj 83 200 metro 150; -#X obj 83 180 tgl 15 1 empty empty empty 17 7 0 10 -262144 -1 -1 1 -1; -#X obj 67 75 osc~ 440; -#X floatatom 136 76 5 0 0 0 - - -; -#X obj 67 130 *~ 0; -#X obj 136 106 / 10; -#X text 105 271 signal; -#X text 179 271 - singal to pass through range filter; -#X text 105 312 signal; -#X text 179 312 - outputs part of signal inside range; -#X text 179 352 - sets minimun number of range \, (default is 0); -#X text 179 374 - sets maximum number of range \, (default is 0); -#X obj 483 49 pddp/dsp; -#X obj 77 271 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +#X text 98 458 signal; +#X obj 502 12 clip~; +#X obj 41 177 clip~ -0.5 0.5; +#X obj 41 117 osc~ 1000; +#X obj 57 226 metro 500; +#X text 209 149 inlets to reset clip range; +#X floatatom 101 149 4 0 0 0 - - -, f 4; +#X floatatom 162 150 4 0 0 0 - - -, f 4; +#X text 176 177 creation arguments initialize clip range; +#X text 183 250 <- graph the output; +#X obj 78 396 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X text 98 395 float; +#X obj 78 421 cnv 17 3 17 empty \$0-pddp.cnv.let.2 2 5 9 0 16 -228856 -162280 0; -#X text 168 67 click and drag tochange signal; -#X text 134 149 Optional arguments set the range. Default is 0 \, -0; -#X obj 7 422 pddp/pddplink all_about_help_patches.pd -text Usage Guide +#X text 98 420 float; +#X obj 57 203 loadbang; +#N canvas 0 0 450 300 (subpatch) 0; +#X array \$0-array 100 float 0; +#X coords 0 1 100 -1 200 100 1 0 0; +#X restore 343 238 graph; +#X text 11 23 restrict a signal to lie between two limits; +#X text 168 365 - an incoming signal at the left inlet will be clipped +to lie between the two limits.; +#X text 168 458 - outputs the clipped signal.; +#X text 168 505 - (optional) initial minimum value beyond which to +clip the signal.; +#X text 168 535 - (optional) initial maximum value beyond which to +clip the signal.; +#X text 80 505 1) float; +#X text 80 535 2) float; +#X text 81 67 The [clip~] object passes its signal input to its output +\, clipping it to lie between two limits.; +#X text 168 395 - minimum value below which the incoming signal is +clipped.; +#X text 168 420 - maximum value above which the incoming signal is +clipped.; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide ; -#X obj 510 5 clip~; -#X obj 67 156 clip~ -1 1; -#X connect 13 0 11 0; +#X obj 476 52 pddp/dsp; +#X obj 41 250 tabwrite~ \$0-array; +#X connect 13 0 39 0; #X connect 14 0 13 0; -#X connect 15 0 17 0; -#X connect 16 0 18 0; -#X connect 17 0 31 0; -#X connect 18 0 17 1; -#X connect 31 0 11 0; +#X connect 15 0 39 0; +#X connect 17 0 13 1; +#X connect 18 0 13 2; +#X connect 25 0 15 0; diff --git a/doc/pddp/closebang-abs.pd b/pd/doc/5.reference/closebang-abs.pd similarity index 100% rename from doc/pddp/closebang-abs.pd rename to pd/doc/5.reference/closebang-abs.pd diff --git a/doc/pddp/closebang-help.pd b/pd/doc/5.reference/closebang-help.pd similarity index 100% rename from doc/pddp/closebang-help.pd rename to pd/doc/5.reference/closebang-help.pd diff --git a/doc/pddp/templates/colour-guide.pd b/pd/doc/5.reference/colour-guide.pd similarity index 78% rename from doc/pddp/templates/colour-guide.pd rename to pd/doc/5.reference/colour-guide.pd index e4004328a..aac135b52 100644 --- a/doc/pddp/templates/colour-guide.pd +++ b/pd/doc/5.reference/colour-guide.pd @@ -1,4 +1,4 @@ -#N canvas 304 179 349 252 10; +#N canvas 1 25 349 252 10; #X text 11 8 PDDP Colour Guide:; #X obj 14 39 cnv 20 20 20 empty empty Reference-Patches 30 9 0 13 -200249 -1 0; @@ -10,5 +10,3 @@ -1 0; #X obj 14 178 cnv 20 20 20 empty empty Stop-Process 30 9 0 13 -239389 -1 0; -#X obj 14 208 cnv 20 20 20 empty empty Highlight-Object/patch? 30 9 -0 13 -262126 -1 0; diff --git a/doc/pddp/complex-mod~-help.pd b/pd/doc/5.reference/complex-mod~-help.pd similarity index 100% rename from doc/pddp/complex-mod~-help.pd rename to pd/doc/5.reference/complex-mod~-help.pd diff --git a/doc/pddp/cos-help.pd b/pd/doc/5.reference/cos-help.pd similarity index 100% rename from doc/pddp/cos-help.pd rename to pd/doc/5.reference/cos-help.pd diff --git a/pd/doc/5.reference/cos~-help.pd b/pd/doc/5.reference/cos~-help.pd index 5e4d67b2a..8abd2e253 100644 --- a/pd/doc/5.reference/cos~-help.pd +++ b/pd/doc/5.reference/cos~-help.pd @@ -1,34 +1,140 @@ -#N canvas 190 40 698 331 12; -#X obj 112 12 cos~; -#X obj 23 200 cos~; -#X obj 23 249 snapshot~; -#X obj 23 152 sig~; -#X floatatom 23 275 7 0 0 0 - - -; -#X obj 23 125 * 0.01; -#X floatatom 23 98 0 0 0 0 - - -; -#X obj 90 215 metro 500; -#X obj 90 189 r metro; -#X msg 469 157 \; metro 0; -#X msg 450 103 \; pd dsp 1 \; metro 1; -#X text 159 13 - COSINE WAVESHAPER; -#X text 86 125 Divide by 100; -#X text 71 153 convert to audio; -#X text 78 100 <-- Scroll to set input value; -#X text 97 275 <-- output of the cos~ object; -#X text 83 305 see also:; -#X obj 171 307 osc~; -#X obj 215 307 tabread4~; -#X text 537 118 <-Click to start; -#X text 538 163 <-Click to stop; -#X text 13 41 The cos~ object outputs the cosine of two pi times its -signal input. So -1 \, 0 \, 1 and 2 give 1 out \, 0.5 gives -1 \, and -so on.; -#X text 411 298 updated for Pd version 0.41; -#X connect 1 0 2 0; -#X connect 2 0 4 0; -#X connect 2 0 4 0; -#X connect 3 0 1 0; -#X connect 5 0 3 0; -#X connect 6 0 5 0; -#X connect 7 0 2 0; -#X connect 8 0 7 0; +#N canvas 425 36 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 cos~ 3 12 0 18 -204280 +-1 0; +#X obj 0 440 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 477 283 494 344 META 0; +#X text 12 105 LIBRARY internal; +#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 125 AUTHOR Miller Puckette; +#X text 12 185 HELP_PATCH_AUTHORS Updated for Pd version 0.41. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 5 KEYWORDS signal trigonometry; +#X text 12 45 DESCRIPTION cosine waveshaper; +#X text 12 65 INLET_0 signal; +#X text 12 85 OUTLET_0 signal; +#X text 12 165 RELEASE_DATE 1997; +#X restore 500 598 pd META; +#X obj 0 477 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 532 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 560 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 211 524 428 103 Related_objects 0; +#X obj 19 33 osc~; +#X obj 68 33 tabread4~; +#X obj 138 33 phasor~; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 7 1 [cos~] Related Objects; +#X restore 102 598 pd Related_objects; +#X obj 78 486 cnv 17 3 35 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 449 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 449 signal; +#X text 98 486 signal; +#X text 158 486 - [cos~] outputs the cosine of two pi times its signal +input. So -1 \, 0 \, 1 and 2 give 1 out \, 0.5 gives -1 \, and so on. +; +#X text 98 536 (none); +#X obj 505 11 cos~; +#X obj 131 240 cos~; +#X obj 131 289 snapshot~; +#X obj 131 192 sig~; +#X floatatom 131 315 7 0 0 0 - - -, f 7; +#X obj 131 165 * 0.01; +#X floatatom 131 138 0 0 0 0 - - -; +#X obj 198 255 metro 500; +#X obj 198 229 r metro; +#X text 194 165 Divide by 100; +#X text 179 193 convert to audio; +#X text 186 140 <-- Scroll to set input value; +#X text 205 315 <-- output of the cos~ object; +#X obj 470 126 loadbang; +#X obj 470 150 s metro; +#N canvas 107 147 428 410 cos~_vs_osc~ 0; +#X obj 63 164 cos~; +#X obj 63 136 phasor~; +#X text 16 146 this:; +#X text 165 139 is the same; +#X text 166 158 as this:; +#X obj 251 140 osc~; +#X text 18 28 ( from audio tutorial E08.phase.mod.pd ); +#X obj 111 206 tgl 20 0 empty empty empty 17 7 0 10 -262144 -1 -1 0 +1; +#X text 136 206 click to visualize; +#N canvas 0 0 450 300 (subpatch) 0; +#X array cos~-array1 100 float 3; +#A 0 -0.753024 -0.792766 -0.829394 -0.862767 -0.892751 -0.919226 -0.94208 +-0.961235 -0.976614 -0.988159 -0.995823 -0.999576 -0.999404 -0.995308 +-0.987303 -0.975405 -0.959676 -0.94018 -0.916991 -0.890202 -0.859916 +-0.826254 -0.789346 -0.749339 -0.70638 -0.660644 -0.612314 -0.561581 +-0.508642 -0.453706 -0.396988 -0.33871 -0.279102 -0.218395 -0.156829 +-0.0946478 -0.0320953 0.0305825 0.0931407 0.155333 0.216916 0.277648 +0.337288 0.3956 0.452358 0.507339 0.560328 0.611116 0.659504 0.705303 +0.748333 0.788423 0.825405 0.859146 0.889513 0.916386 0.939661 0.959246 +0.975064 0.987053 0.995167 0.999358 0.999623 0.995963 0.988392 0.97694 +0.961651 0.942586 0.91982 0.893441 0.863544 0.830252 0.793699 0.75403 +0.7114 0.665977 0.617938 0.567472 0.514777 0.460057 0.403526 0.345411 +0.28594 0.225346 0.163868 0.101745 0.0392234 -0.0234532 -0.0860385 +-0.148284 -0.209948 -0.270786 -0.33056 -0.389036 -0.445985 -0.501182 +-0.554412 -0.605466 -0.654132 -0.700229; +#X coords 0 1 99 -1 100 60 1; +#X restore 64 328 graph; +#X obj 64 278 tabwrite~ cos~-array1; +#X msg 63 70 440; +#N canvas 0 0 450 300 (subpatch) 0; +#X array osc~-array1 100 float 3; +#A 0 0.779374 0.738588 0.694902 0.648488 0.599526 0.548211 0.494742 +0.43933 0.382189 0.323544 0.263629 0.202679 0.140933 0.0786344 0.0160266 +-0.0466445 -0.109133 -0.171193 -0.232579 -0.293051 -0.352371 -0.410307 +-0.466632 -0.521125 -0.573571 -0.623766 -0.671511 -0.71661 -0.758893 +-0.798196 -0.834364 -0.867255 -0.896741 -0.922705 -0.945047 -0.963677 +-0.978512 -0.9895 -0.996602 -0.99979 -0.999052 -0.994391 -0.985825 +-0.973388 -0.957129 -0.937102 -0.913388 -0.886088 -0.855309 -0.82117 +-0.783807 -0.743366 -0.700006 -0.653896 -0.605216 -0.554151 -0.500911 +-0.445704 -0.388748 -0.330265 -0.270485 -0.209642 -0.147975 -0.085727 +-0.0231406 0.0395359 0.102057 0.164176 0.225651 0.28624 0.345705 0.403812 +0.460335 0.515044 0.567729 0.618184 0.66621 0.711621 0.754237 0.793891 +0.830428 0.863704 0.893581 0.919942 0.942691 0.961737 0.977007 0.98844 +0.995992 0.999633 0.999348 0.995134 0.987001 0.974993 0.959156 0.939553 +0.91626 0.889369 0.858986 0.825229; +#X coords 0 1 99 -1 100 60 1; +#X restore 250 328 graph; +#X floatatom 63 101 5 0 0 0 - - -, f 5; +#X obj 250 278 tabwrite~ osc~-array1; +#X obj 111 236 metro 250; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 7 1 [cos~] What's the difference between [cos~] and [osc~]? +; +#X text 18 48 [phasor~] and [cos~] together are equivalent to [osc~] +; +#X connect 0 0 10 0; +#X connect 1 0 0 0; +#X connect 5 0 14 0; +#X connect 7 0 15 0; +#X connect 11 0 13 0; +#X connect 13 0 1 0; +#X connect 13 0 5 0; +#X connect 15 0 10 0; +#X connect 15 0 14 0; +#X restore 102 568 pd cos~_vs_osc~; +#X text 11 23 cosine waveshaper; +#X obj 4 598 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 472 52 pddp/dsp; +#X connect 15 0 16 0; +#X connect 16 0 18 0; +#X connect 17 0 15 0; +#X connect 19 0 17 0; +#X connect 20 0 19 0; +#X connect 21 0 16 0; +#X connect 22 0 21 0; +#X connect 27 0 28 0; diff --git a/pd/doc/5.reference/cpole~-help.pd b/pd/doc/5.reference/cpole~-help.pd index f3ecbaa5f..6b011335e 100644 --- a/pd/doc/5.reference/cpole~-help.pd +++ b/pd/doc/5.reference/cpole~-help.pd @@ -1,41 +1,117 @@ -#N canvas -10 52 610 611 12; -#X obj 54 90 osc~ 100; -#X msg 62 117 clear; -#X text 12 369 The transfer function is H(Z) = 1/(1 - aZ^-1).; -#X text 115 116 <-- clear internal state to zero; -#N canvas 168 90 498 357 test 0; -#X obj 76 78 osc~; -#X floatatom 76 55 5 0 0 0 - - -; -#X obj 18 287 env~ 16384; -#X floatatom 18 311 5 0 0 0 - - -; -#X obj 104 107 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0 -1; -#X obj 76 105 *~; -#X msg 85 132 set 1; -#X floatatom 350 112 4 -1000 1000 0 - - -; -#X obj 215 315 dac~; -#X obj 215 279 *~; -#X text 80 18 Stuff to test it:; -#X obj 241 106 cos~; -#X obj 77 227 cpole~; -#X obj 261 65 phasor~; -#X floatatom 261 44 5 0 0 0 - - -; -#X floatatom 132 55 5 0 0 0 - - -; -#X obj 160 107 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0 +#N canvas 427 30 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 cpole~ 3 12 0 18 +-204280 -1 0; +#X obj 0 287 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 480 218 494 405 META 0; +#X text 12 185 LIBRARY internal; +#X text 12 225 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 205 AUTHOR Miller Puckette; +#X text 12 265 HELP_PATCH_AUTHORS Updated for Pd version-0.38. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 5 KEYWORDS signal filter; +#X text 12 45 DESCRIPTION complex one-pole (recursive) filter \, raw +; +#X text 12 65 INLET_0 signal; +#X text 12 145 OUTLET_0 signal; +#X text 12 85 INLET_1 signal; +#X text 12 105 INLET_2 signal; +#X text 12 125 INLET_3 signal; +#X text 12 165 OUTLET_1 signal; +#X text 12 245 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 424 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 486 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 543 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 212 309 428 309 Related_objects 0; +#X obj 74 60 rzero~; +#X obj 25 80 cpole~; +#X obj 25 60 rpole~; +#X obj 123 60 rzero_rev~; +#X obj 74 80 czero~; +#X obj 123 80 czero_rev~; +#X text 201 60 real; +#X text 200 81 complex; +#X text 22 44 1-pole; +#X text 71 44 1-zero; +#X text 121 44 1-zero \, reversed; +#X text 47 29 summary of raw filters:; +#X text 18 184 User-friendly Filters; +#X obj 21 213 lop~; +#X obj 72 212 hip~; +#X obj 124 213 bp~; +#X obj 169 214 vcf~; +#X obj 22 274 biquad~; +#X text 18 250 Other Objects; +#X text 18 113 Pd also provides a suite of user-friendly filters. This +and other raw filters are provided for situations which the user-friendly +ones can't handle. See Chapter 8 of http://crca.ucsd.edu/~msp/techniques +for an introduction to the necessary theory.; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 7 1 [cpole~] Related Objects; +#X restore 101 597 pd Related_objects; +#X obj 78 433 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 296 cnv 17 3 45 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 296 signal; +#X text 98 433 signal; +#X obj 492 12 cpole~; +#X obj 57 132 osc~ 100; +#X msg 65 155 clear; +#X obj 84 199 sig~; +#X obj 121 200 sig~; +#X obj 158 200 sig~; +#X obj 56 230 cpole~ 0.9 0.4; +#X msg 67 177 set 0.6 0.8; +#X text 203 181 where y[n] is the output \, x[n] the input \, and a[n] +the filter coefficient (all complex numbers). The filter is unstable +if/when |a[n]|>1.; +#X text 203 223 The transfer function is H(Z) = 1/(1 - aZ^-1).; +#N canvas 45 205 428 355 test 0; +#X obj 66 88 osc~; +#X floatatom 66 65 5 0 0 0 - - -, f 5; +#X obj 8 297 env~ 16384; +#X floatatom 8 321 5 0 0 0 - - -, f 5; +#X obj 94 117 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0 1 +; +#X obj 66 115 *~; +#X msg 75 142 set 1; +#X floatatom 340 122 4 -1000 1000 0 - - -, f 4; +#X obj 205 325 dac~; +#X obj 205 289 *~; +#X text 70 28 Stuff to test it:; +#X obj 231 116 cos~; +#X obj 67 237 cpole~; +#X obj 251 75 phasor~; +#X floatatom 251 54 5 0 0 0 - - -, f 5; +#X floatatom 122 65 5 0 0 0 - - -, f 5; +#X obj 150 117 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0 1; -#X obj 132 105 *~; -#X obj 132 78 phasor~; -#X floatatom 324 42 5 0 0 0 - - -; -#X obj 324 65 / 1000; -#X obj 274 107 -~ 0.25; -#X obj 274 129 cos~; -#X obj 350 131 / 1000; -#X obj 240 157 *~; -#X obj 274 157 *~; -#X obj 94 287 env~ 16384; -#X floatatom 94 311 5 0 0 0 - - -; -#X obj 247 275 dbtorms; -#X floatatom 248 255 5 0 0 0 - - -; +#X obj 122 115 *~; +#X obj 122 88 phasor~; +#X floatatom 314 52 5 0 0 0 - - -, f 5; +#X obj 314 75 / 1000; +#X obj 264 117 -~ 0.25; +#X obj 264 139 cos~; +#X obj 340 141 / 1000; +#X obj 230 167 *~; +#X obj 264 167 *~; +#X obj 84 297 env~ 16384; +#X floatatom 84 321 5 0 0 0 - - -, f 5; +#X obj 237 285 dbtorms; +#X floatatom 238 265 5 0 0 0 - - -, f 5; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 7 1 [cpole~] Test; #X connect 0 0 5 0; #X connect 1 0 0 0; #X connect 2 0 3 0; @@ -67,53 +143,46 @@ #X connect 26 0 27 0; #X connect 28 0 9 1; #X connect 29 0 28 0; -#X restore 459 483 pd test; -#X text 10 387 (Pd also provides a suite of user-friendly filters. -This and other raw filters are provided for situations which the user-friendly -ones can't handle. See Chapter 8 of http://crca.ucsd.edu/~msp/techniques -for an introduction to the necessary theory.); -#X obj 52 7 cpole~; -#X text 114 7 complex one-pole (recursive) filter \, raw; -#X text 132 93 <-- signal to filter (real part); -#X text 130 173 <-- signal to filter (imaginary part); -#X obj 84 172 sig~; -#X obj 115 197 sig~; -#X text 162 199 <-- filter coefficient (real part); -#X obj 145 219 sig~; -#X obj 53 244 cpole~ 0.9 0.4; -#X text 159 246 <-- creation arguments initialize filter; -#X text 187 262 coefficient (real and imaginary part); -#X text 14 278 The action of cpole~ is:; -#X text 11 320 where y[n] is the output \, x[n] the input \, and a[n] -the filter coefficient (all complex numbers). The filter is unstable -if/when |a[n]|>1.; -#X text 12 27 Cpole~ filters a complex audio signal (first two inlets) +#X restore 102 552 pd test; +#X text 98 311 clear; +#X text 98 326 set; +#X obj 78 346 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X text 98 346 signal; +#X obj 78 371 cnv 17 3 17 empty \$0-pddp.cnv.let.2 2 5 9 0 16 -228856 +-162280 0; +#X text 98 371 signal; +#X obj 78 396 cnv 17 3 17 empty \$0-pddp.cnv.let.3 3 5 9 0 16 -228856 +-162280 0; +#X obj 78 458 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X text 98 458 signal; +#X text 11 23 complex one-pole (recursive) filter \, raw; +#X text 98 396 signal; +#X text 168 296 - signal to filter (real part).; +#X text 168 311 - clear internal state to zero.; +#X text 168 326 - set internal state (real & imaginary parts).; +#X text 168 346 - signal to filter ( imaginary part ).; +#X text 168 371 - filter coefficient ( real part ).; +#X text 168 396 - filter coefficient ( imaginary part ).; +#X text 169 504 - (optional) coefficient (real).; +#X text 169 519 - (optional) coefficient (imaginary).; +#X text 80 504 1) float; +#X text 80 519 2) float; +#X text 202 134 The action of [cpole~] is:; +#X text 85 68 [cpole~] filters a complex audio signal (first two inlets) via a one-pole filter \, whose coefficients are controlled by creation arguments or by another complex audio signal (remaining two inlets). ; -#X text 171 143 <-- set internal state (real&imaginary parts); -#X msg 64 143 set 0.6 0.8; -#X text 190 221 <-- filter coefficient (imaginary part); -#X text 73 300 y[n] = x[n] + a[n] * y[n-1]; -#X obj 97 566 lop~; -#X text 11 566 see also:; -#X obj 96 497 rzero~; -#X obj 36 519 cpole~; -#X obj 36 497 rpole~; -#X obj 156 497 rzero_rev~; -#X obj 96 519 czero~; -#X obj 156 519 czero_rev~; -#X text 255 497 real; -#X text 254 520 complex; -#X text 33 481 1-pole; -#X text 93 481 1-zero; -#X text 143 481 1-zero \, reversed; -#X text 58 466 summary of raw filters:; -#X text 137 566 etc.: user-friendly filters; -#X text 343 583 updated for Pd version 0.42; -#X connect 0 0 14 0; -#X connect 1 0 14 0; -#X connect 10 0 14 1; -#X connect 11 0 14 2; -#X connect 13 0 14 3; -#X connect 21 0 14 0; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 480 51 pddp/dsp; +#X obj 102 572 pddp/pddplink ../3.audio.examples/H12.peaking.pd -text +doc/3.audio.examples/H12.peaking.pd; +#X text 208 160 y[n] = x[n] + a[n] * y[n-1]; +#X connect 13 0 18 0; +#X connect 14 0 18 0; +#X connect 15 0 18 1; +#X connect 16 0 18 2; +#X connect 17 0 18 3; +#X connect 19 0 18 0; diff --git a/pd/doc/5.reference/cputime-help.pd b/pd/doc/5.reference/cputime-help.pd index c0a0f43a7..204b364f9 100644 --- a/pd/doc/5.reference/cputime-help.pd +++ b/pd/doc/5.reference/cputime-help.pd @@ -1,15 +1,167 @@ -#N canvas 302 232 550 286 12; -#X msg 74 144 bang; -#X msg 30 115 bang; -#X floatatom 30 206 0 0 0; -#X text 71 113 Click here to reset; -#X text 27 232 Output is in milliseconds; -#X obj 30 175 cputime; -#X text 124 144 Click here to get elapsed CPU time; -#X text 6 51 The cputime object measures elapsed CPU time \, as measured by your operating system. This appears to work on NT \, IRIX \, and Linux \, but not on W98.; -#X obj 66 15 cputime; -#X text 123 16 - measure CPU usage; -#X text 297 261 updated for Pd version 0.33; -#X connect 0 0 5 1; -#X connect 1 0 5 0; -#X connect 5 0 2 0; +#N canvas 427 38 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 cputime 3 12 0 18 +-204280 -1 0; +#X obj 0 333 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 483 273 494 360 META 0; +#X text 12 125 LIBRARY internal; +#X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 145 AUTHOR Miller Puckette; +#X text 12 205 HELP_PATCH_AUTHORS This help patch was updated for Pd +version 0.35 test 28 by Dave Sabine as part of a project called pddp +proposed by Krzysztof Czaja to build comprehensive documentation for +Pd. Jonathan Wilkes revised the patch to conform to the PDDP template +for Pd version 0.42.; +#X text 12 5 KEYWORDS control time; +#X text 12 45 DESCRIPTION measure CPU time; +#X text 12 65 INLET_0 bang; +#X text 12 85 INLET_1 bang; +#X text 12 105 OUTLET_0 float; +#X text 12 185 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 407 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 450 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 478 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#X obj 78 342 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 454 (none); +#X text 98 416 float; +#N canvas 214 380 428 252 Related_objects 0; +#X obj 125 35 metro; +#X obj 62 35 realtime; +#X obj 14 36 timer; +#X obj 173 35 delay; +#X text 11 170 The best places to find information about Pd's libraries +is:; +#X text 8 192 www.puredata.org and click on "Downloads" then "Software" +; +#X text 10 207 or; +#X text 10 222 iem.kug.ac.at/pdb/; +#X text 12 121 This object is only offered in Pd only if you have downloaded +and properly installed the appropriate library. These objects may or +may not exist in a single library.; +#X text 11 71 Externals; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 7 1 [cputime] Related Objects; +#X obj 11 91 pddp/helplink iemlib/t3_timer; +#X restore 102 597 pd Related_objects; +#X obj 493 10 cputime; +#X msg 122 156 bang; +#X msg 83 134 bang; +#X floatatom 83 200 0 0 0 0 - - -; +#X text 155 202 Output is in milliseconds; +#X text 118 134 Click here to start or reset; +#X text 78 57 The [cputime] object measures elapsed CPU time. CPU time +is the amount of time your computer's CPU requires to perform a task +-- that's a short definition.; +#X obj 83 178 cputime; +#X text 160 157 Click here to get elapsed CPU time. Click again...and +again...to see periodic measurements from the start or reset time. +Be patient.; +#X obj 78 374 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X text 98 373 bang; +#X text 168 416 - the elapsed time in milliseconds arrives at the outlet +when the right inlet receives a bang.; +#X text 80 264 NOTE: Unlike most other objects in Pd \, the right inlet +of [cputime] is the hot one (i.e. \, a bang to it triggers the output). +; +#N canvas 70 46 428 538 Time_Measurements 0; +#X obj 30 395 time_measurements; +#X obj 30 291 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X floatatom 30 437 0 0 0 0 - - -; +#X floatatom 116 436 0 0 0 0 - - -; +#X floatatom 183 436 0 0 0 0 - - -; +#X text 27 208 In the example below \, I've created an abstraction +which will force each of Pd's stop-watches \, [timer] [cputime] and +[realtime] to measure various processes and report the elapsed time. +Click on each [bng] to begin the process and wait for the results. +Notice the discrepancies in the results.; +#X text 28 455 Logical Time; +#X text 181 455 Real Time; +#X text 115 455 CPU Time; +#X obj 45 327 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X text 50 285 1 Measures elapsed time between two "bangs" from a [trigger] +object.; +#X text 65 319 2 Measures the amount of time Pd requires to turn on +DSP and start an oscillator.; +#X obj 89 359 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X text 27 487 This document was updated for Pd version 0.35 test 28 +by Dave Sabine as part of a project called pddp proposed by Krzysztof +Czaja to build comprehensive documentation for Pd.; +#X text 110 351 3 Measures the amount of time Pd requires count to +three...please wait for approximately 3 seconds.; +#X text 27 35 [cputime] works like essentially like a stop-watch. Once +it starts \, you can continue to "poll" [cputime] to view the elapsed +time.; +#X text 27 82 The odd aspect about comparing [cputime] to a stop-watch +is that a stop-watch can be stopped! [cputime] can only be started +or reset. It cannot be stopped.; +#X text 26 132 As stated above \, [cputime] measures "CPU" time. This +value may be slightly different than "logical" time or "real" time. +PD offers two objects which measure "logical" time and "real" time. +See the reference documents for those objects for more information. +; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 7 1 [cputime] Time Measurements; +#X connect 0 0 2 0; +#X connect 0 1 3 0; +#X connect 0 2 4 0; +#X connect 1 0 0 0; +#X connect 9 0 0 1; +#X connect 12 0 0 2; +#X restore 102 511 pd Time_Measurements; +#N canvas 70 77 428 430 Time_Objects 0; +#X text 21 37 In a fantasy world \, computers could exist somehow beyond +the restrictions of time and digital computation could be performed +in ZERO time. However \, that is not the case. Instead \, every process +within Pd and within your operating system requires at least a few +nanoseconds of your CPU's time.; +#X text 22 122 The [timer] object is like a clock that is not constrained +to the regular laws of physics and the universal space-time continuum. +It reports "time" measurements as only Pd can see them!; +#X text 23 181 The [cputime] object is like a clock that measures how +much time your CPU actually required to carry out your request. Keep +in mind however that your CPU is busy doing many things simoultaneously +\, so even though a process might take 5 minutes to complete \, your +CPU does not pay full attention to that process for the entire 5 minutes. +Instead \, it simply begins the process \, then refers back to that +process from time to time until the it is complete. In other cases +\, your CPU might require a full 5 minutes while Pd might report that +merely a few milliseconds have passed. This type of discrepancy depends +heavily on your computer's hardware and the type of processing it is +performing.; +#X text 24 350 The [realtime] object is as much like your own wrist +watch as Pd can possibly manage. It measures time according to your +operating system's internal clock.; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 7 1 [cputime] Why the Discrepencies Between Clocks?; +#X restore 102 486 pd Time_Objects; +#X obj 78 416 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 11 23 measure CPU time; +#X text 98 341 bang; +#X text 168 341 - an initial bang to the left inlet starts the timer. +Subsequent bangs reset the timer.; +#X text 168 373 - a bang to the right inlet causes the elapsed time +to be output (in milliseconds).; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X text 101 531 For a patch that uses [cputime] see:; +#X obj 98 551 pddp/pddplink ../7.stuff/tools/load-meter.pd; +#X text 101 571 (also accessible from the "Media" menu); +#X connect 12 0 18 1; +#X connect 13 0 18 0; +#X connect 18 0 14 0; diff --git a/doc/pddp/ctlin-help.pd b/pd/doc/5.reference/ctlin-help.pd similarity index 100% rename from doc/pddp/ctlin-help.pd rename to pd/doc/5.reference/ctlin-help.pd diff --git a/doc/pddp/ctlout-help.pd b/pd/doc/5.reference/ctlout-help.pd similarity index 100% rename from doc/pddp/ctlout-help.pd rename to pd/doc/5.reference/ctlout-help.pd diff --git a/pd/doc/5.reference/czero_rev~-help.pd b/pd/doc/5.reference/czero_rev~-help.pd index 77b5cee6a..dd31b1624 100644 --- a/pd/doc/5.reference/czero_rev~-help.pd +++ b/pd/doc/5.reference/czero_rev~-help.pd @@ -1,32 +1,79 @@ -#N canvas 118 9 534 590 12; -#X obj 57 106 osc~ 100; -#X msg 65 133 clear; -#X obj 82 563 lop~; -#X text 13 566 see also:; -#X text 336 565 updated for Pd version-0.38; -#X obj 89 513 rzero~; -#X obj 40 533 cpole~; -#X obj 40 513 rpole~; -#X obj 138 513 rzero_rev~; -#X obj 89 533 czero~; -#X obj 138 533 czero_rev~; -#X text 216 513 real; -#X text 215 534 complex; -#X text 37 497 1-pole; -#X text 86 497 1-zero; -#X text 136 497 1-zero \, reversed; -#X text 62 482 summary of raw filters:; -#X text 109 132 <-- clear internal state to zero; -#N canvas 255 257 585 372 test 0; +#N canvas 427 33 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 czero_rev~ 3 12 +0 18 -204280 -1 0; +#X obj 0 303 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 484 243 494 384 META 0; +#X text 12 195 LIBRARY internal; +#X text 12 235 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 215 AUTHOR Miller Puckette; +#X text 12 275 HELP_PATCH_AUTHORS Updated for Pd version-0.38. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 5 KEYWORDS signal filter; +#X text 12 25 LICENSE SIBSD; +#X text 12 75 INLET_0 signal set clear; +#X text 12 95 INLET_1 signal; +#X text 12 115 INLET_2 signal; +#X text 12 135 INLET_3 signal; +#X text 12 155 OUTLET_0 signal; +#X text 12 175 OUTLET_1 signal; +#X text 12 255 RELEASE_DATE 1997; +#X text 12 45 DESCRIPTION complex one-zero (non-recursive) "reverse" +filter \, raw; +#X restore 500 597 pd META; +#X obj 0 440 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 502 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 559 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 207 322 428 309 Related_objects 0; +#X obj 74 60 rzero~; +#X obj 25 80 cpole~; +#X obj 25 60 rpole~; +#X obj 123 60 rzero_rev~; +#X obj 74 80 czero~; +#X obj 123 80 czero_rev~; +#X text 201 60 real; +#X text 200 81 complex; +#X text 22 44 1-pole; +#X text 71 44 1-zero; +#X text 121 44 1-zero \, reversed; +#X text 47 29 summary of raw filters:; +#X text 19 184 User-friendly Filters; +#X obj 22 213 lop~; +#X obj 73 212 hip~; +#X obj 125 213 bp~; +#X obj 170 214 vcf~; +#X obj 23 274 biquad~; +#X text 19 250 Other Objects; +#X text 19 113 Pd also provides a suite of user-friendly filters. This +and other raw filters are provided for situations which the user-friendly +ones can't handle. See Chapter 8 of http://crca.ucsd.edu/~msp/techniques +for an introduction to the necessary theory.; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 7 1 [czero_rev~] Related Objects; +#X restore 101 597 pd Related_objects; +#X obj 78 449 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 312 cnv 17 3 45 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 312 signal; +#X text 98 449 signal; +#N canvas 3 174 550 380 test 0; #X obj 152 296 env~ 16384; -#X floatatom 152 320 5 0 0 0 - - -; -#X floatatom 499 76 4 -1000 1000 0 - - -; +#X floatatom 152 320 5 0 0 0 - - -, f 5; +#X floatatom 499 76 4 -1000 1000 0 - - -, f 4; #X obj 349 324 dac~; #X obj 349 288 *~; #X obj 390 70 cos~; -#X floatatom 298 8 5 0 0 0 - - -; +#X floatatom 298 8 5 0 0 0 - - -, f 5; #X obj 298 31 phasor~; -#X floatatom 398 14 5 0 0 0 - - -; +#X floatatom 398 14 5 0 0 0 - - -, f 5; #X obj 397 39 / 1000; #X obj 423 71 -~ 0.25; #X obj 423 93 cos~; @@ -34,18 +81,18 @@ #X obj 389 121 *~; #X obj 423 121 *~; #X obj 228 296 env~ 16384; -#X floatatom 228 320 5 0 0 0 - - -; +#X floatatom 228 320 5 0 0 0 - - -, f 5; #X obj 381 284 dbtorms; -#X floatatom 382 264 5 0 0 0 - - -; +#X floatatom 382 264 5 0 0 0 - - -, f 5; #X obj 117 89 phasor~; -#X floatatom 115 60 5 0 0 0 - - -; +#X floatatom 115 60 5 0 0 0 - - -, f 5; #X text 77 13 Stuff to test it:; #X obj 131 149 cpole~; #X obj 241 262 *~ -1; #X obj 21 261 env~ 16384; -#X floatatom 21 285 5 0 0 0 - - -; +#X floatatom 21 285 5 0 0 0 - - -, f 5; #X obj 50 312 env~ 16384; -#X floatatom 50 336 5 0 0 0 - - -; +#X floatatom 50 336 5 0 0 0 - - -, f 5; #X obj 138 181 cpole~; #X obj 146 216 czero_rev~; #X obj 154 264 czero_rev~; @@ -102,41 +149,58 @@ #X connect 33 0 10 0; #X connect 34 0 33 0; #X connect 35 0 3 1; -#X restore 462 499 pd test; -#X text 116 566 etc.: user-friendly filters; -#X text 13 403 (Pd also provides a suite of user-friendly filters. -This and other raw filters are provided for situations which the user-friendly -ones can't handle. See Chapter 8 of http://crca.ucsd.edu/~msp/techniques -for an introduction to the necessary theory.); -#X text 121 107 <-- signal to filter (real part); -#X text 120 189 <-- signal to filter (imaginary part); -#X obj 87 188 sig~; -#X obj 118 213 sig~; -#X text 152 215 <-- filter coefficient (real part); -#X obj 148 235 sig~; -#X text 162 262 <-- creation arguments initialize filter; -#X text 190 278 coefficient (real and imaginary part); -#X text 153 160 <-- set internal state (real&imaginary parts); -#X msg 67 159 set 0.6 0.8; -#X text 182 237 <-- filter coefficient (imaginary part); -#X text 17 295 The action of czero~ is:; -#X text 14 336 where y[n] is the output \, x[n] the input \, and a[n] +#X restore 101 568 pd test; +#X text 98 327 clear; +#X text 98 342 set; +#X obj 78 362 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X text 98 362 signal; +#X obj 78 387 cnv 17 3 17 empty \$0-pddp.cnv.let.2 2 5 9 0 16 -228856 +-162280 0; +#X text 98 387 signal; +#X obj 78 412 cnv 17 3 17 empty \$0-pddp.cnv.let.3 3 5 9 0 16 -228856 +-162280 0; +#X text 98 412 signal; +#X obj 78 474 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X text 98 474 signal; +#X obj 474 10 czero_rev~; +#X text 198 196 where y[n] is the output \, x[n] the input \, and a[n] the filter coefficient (all complex numbers). The filter is always stable.; -#X obj 56 260 czero~ 0.9 0.4; -#X obj 36 7 czero_rev~; -#X text 114 9 complex one-zero (non-recursive) "reverse" filter \, +#X text 261 176 y[n] = - a[n] * x[n] + x[n-1]; +#X text 199 245 The transfer function is H(Z) = -a + Z^-1.; +#X obj 52 127 osc~ 100; +#X msg 60 152 clear; +#X obj 86 203 sig~; +#X obj 120 225 sig~; +#X obj 156 245 sig~; +#X msg 67 178 set 0.6 0.8; +#X obj 51 268 czero_rev~ 0.9 0.4; +#X text 11 23 complex one-zero (non-recursive) "reverse" filter \, raw; -#X text 11 34 Czero_rev~ filters a complex audio signal (first two +#X text 158 312 - signal to filter (real part).; +#X text 158 327 - clear internal state to zero.; +#X text 158 342 - set internal state (real & imaginary parts).; +#X text 158 362 - signal to filter ( imaginary part ).; +#X text 158 387 - filter coefficient ( real part ).; +#X text 158 412 - filter coefficient ( imaginary part ).; +#X text 157 521 - (optional) filter coefficient (real part).; +#X text 157 536 - (optional) filter coefficient (imaginary part).; +#X text 80 521 1) float; +#X text 80 536 2) float; +#X text 93 57 [czero_rev~] filters a complex audio signal (first two inlets) via a one-zero filter \, whose coefficients are controlled by creation arguments or by another complex audio signal (remaining two inlets). The impulse response is that of "rzero" reversed in time. ; -#X text 77 316 y[n] = - a[n] * x[n] + x[n-1]; -#X text 15 385 The transfer function is H(Z) = -a + Z^-1.; -#X connect 0 0 34 0; -#X connect 1 0 34 0; -#X connect 23 0 34 1; -#X connect 24 0 34 2; -#X connect 26 0 34 3; -#X connect 30 0 34 0; +#X text 201 155 The action of [czero_rev~] is:; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 476 56 pddp/dsp; +#X connect 27 0 33 0; +#X connect 28 0 33 0; +#X connect 29 0 33 1; +#X connect 30 0 33 2; +#X connect 31 0 33 3; +#X connect 32 0 33 0; diff --git a/pd/doc/5.reference/czero~-help.pd b/pd/doc/5.reference/czero~-help.pd index 58dab9cc8..e19e8f7be 100644 --- a/pd/doc/5.reference/czero~-help.pd +++ b/pd/doc/5.reference/czero~-help.pd @@ -1,56 +1,103 @@ -#N canvas 79 19 533 567 12; -#X obj 54 90 osc~ 100; -#X msg 62 117 clear; -#X obj 79 547 lop~; -#X text 10 550 see also:; -#X text 333 549 updated for Pd version-0.38; -#X obj 86 497 rzero~; -#X obj 37 517 cpole~; -#X obj 37 497 rpole~; -#X obj 135 497 rzero_rev~; -#X obj 86 517 czero~; -#X obj 135 517 czero_rev~; -#X text 213 497 real; -#X text 212 518 complex; -#X text 34 481 1-pole; -#X text 83 481 1-zero; -#X text 133 481 1-zero \, reversed; -#X text 59 466 summary of raw filters:; -#X text 106 116 <-- clear internal state to zero; -#N canvas 255 257 585 372 test 0; -#X obj 152 296 env~ 16384; -#X floatatom 152 320 5 0 0 0 - - -; -#X floatatom 484 121 4 -1000 1000 0 - - -; -#X obj 349 324 dac~; -#X obj 349 288 *~; -#X obj 375 115 cos~; -#X floatatom 301 60 5 0 0 0 - - -; -#X obj 329 112 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0 -1; -#X obj 301 110 *~; -#X obj 301 83 phasor~; -#X floatatom 382 66 5 0 0 0 - - -; -#X obj 382 89 / 1000; -#X obj 408 116 -~ 0.25; -#X obj 408 138 cos~; -#X obj 484 140 / 1000; -#X obj 374 166 *~; -#X obj 408 166 *~; -#X obj 228 296 env~ 16384; -#X floatatom 228 320 5 0 0 0 - - -; -#X obj 381 284 dbtorms; -#X floatatom 382 264 5 0 0 0 - - -; -#X obj 245 220 czero~; -#X floatatom 201 132 4 -1000 1000 0 - - -; -#X obj 92 126 cos~; -#X obj 112 85 phasor~; -#X floatatom 115 60 5 0 0 0 - - -; -#X obj 125 127 -~ 0.25; -#X obj 125 149 cos~; -#X obj 201 151 / 1000; -#X obj 91 177 *~; -#X obj 125 177 *~; -#X text 214 27 Stuff to test it:; +#N canvas 427 33 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 czero~ 3 12 0 18 +-204280 -1 0; +#X obj 0 288 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 482 237 491 389 META 0; +#X text 12 185 LIBRARY internal; +#X text 12 225 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 205 AUTHOR Miller Puckette; +#X text 12 265 HELP_PATCH_AUTHORS Updated for Pd version-0.38. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 5 KEYWORDS signal filter; +#X text 12 45 DESCRIPTION complex one-zero (non-recursive) filter \, +raw; +#X text 12 65 INLET_0 signal clear set; +#X text 12 85 INLET_1 signal; +#X text 12 105 INLET_2 signal; +#X text 12 125 INLET_3 signal; +#X text 12 145 OUTLET_0 signal; +#X text 12 165 OUTLET_1 signal; +#X text 12 245 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 425 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 487 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 543 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 214 316 428 309 Related_objects 0; +#X obj 75 61 rzero~; +#X obj 26 81 cpole~; +#X obj 26 61 rpole~; +#X obj 124 61 rzero_rev~; +#X obj 75 81 czero~; +#X obj 124 81 czero_rev~; +#X text 202 61 real; +#X text 201 82 complex; +#X text 23 45 1-pole; +#X text 72 45 1-zero; +#X text 122 45 1-zero \, reversed; +#X text 48 30 summary of raw filters:; +#X text 22 185 User-friendly Filters; +#X obj 25 214 lop~; +#X obj 76 213 hip~; +#X obj 128 214 bp~; +#X obj 173 215 vcf~; +#X obj 26 275 biquad~; +#X text 22 251 Other Objects; +#X text 22 114 Pd also provides a suite of user-friendly filters. This +and other raw filters are provided for situations which the user-friendly +ones can't handle. See Chapter 8 of http://crca.ucsd.edu/~msp/techniques +for an introduction to the necessary theory.; +#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 [czero~] Related Objects; +#X restore 102 597 pd Related_objects; +#X obj 78 434 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 297 cnv 17 3 45 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 297 signal; +#X text 98 434 signal; +#N canvas 21 185 498 375 test 0; +#X obj 88 282 env~ 16384; +#X floatatom 88 306 5 0 0 0 - - -, f 5; +#X floatatom 420 107 4 -1000 1000 0 - - -, f 4; +#X obj 285 310 dac~; +#X obj 285 274 *~; +#X obj 311 101 cos~; +#X floatatom 237 46 5 0 0 0 - - -, f 5; +#X obj 265 98 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0 1 +; +#X obj 237 96 *~; +#X obj 237 69 phasor~; +#X floatatom 318 52 5 0 0 0 - - -, f 5; +#X obj 318 75 / 1000; +#X obj 344 102 -~ 0.25; +#X obj 344 124 cos~; +#X obj 420 126 / 1000; +#X obj 310 152 *~; +#X obj 344 152 *~; +#X obj 164 282 env~ 16384; +#X floatatom 164 306 5 0 0 0 - - -, f 5; +#X obj 317 270 dbtorms; +#X floatatom 318 250 5 0 0 0 - - -, f 5; +#X obj 181 206 czero~; +#X floatatom 137 118 4 -1000 1000 0 - - -, f 4; +#X obj 28 112 cos~; +#X obj 48 71 phasor~; +#X floatatom 51 46 5 0 0 0 - - -, f 5; +#X obj 61 113 -~ 0.25; +#X obj 61 135 cos~; +#X obj 137 137 / 1000; +#X obj 27 163 *~; +#X obj 61 163 *~; +#X text 150 13 Stuff to test it:; #X connect 0 0 1 0; #X connect 2 0 14 0; #X connect 4 0 3 0; @@ -86,39 +133,58 @@ #X connect 28 0 29 1; #X connect 29 0 21 0; #X connect 30 0 21 1; -#X restore 459 483 pd test; -#X text 113 550 etc.: user-friendly filters; -#X text 10 387 (Pd also provides a suite of user-friendly filters. -This and other raw filters are provided for situations which the user-friendly -ones can't handle. See Chapter 8 of http://crca.ucsd.edu/~msp/techniques -for an introduction to the necessary theory.); -#X text 118 91 <-- signal to filter (real part); -#X text 117 173 <-- signal to filter (imaginary part); -#X obj 84 172 sig~; -#X obj 115 197 sig~; -#X text 149 199 <-- filter coefficient (real part); -#X obj 145 219 sig~; -#X text 159 246 <-- creation arguments initialize filter; -#X text 187 262 coefficient (real and imaginary part); -#X text 150 144 <-- set internal state (real&imaginary parts); -#X msg 64 143 set 0.6 0.8; -#X obj 52 7 czero~; -#X text 112 7 complex one-zero (non-recursive) filter \, raw; -#X text 8 31 Czero~ filters a complex audio signal (first two inlets) +#X restore 102 552 pd test; +#X text 98 312 clear; +#X text 98 327 set; +#X obj 78 347 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X text 98 347 signal; +#X obj 78 372 cnv 17 3 17 empty \$0-pddp.cnv.let.2 2 5 9 0 16 -228856 +-162280 0; +#X text 98 372 signal; +#X obj 78 397 cnv 17 3 17 empty \$0-pddp.cnv.let.3 3 5 9 0 16 -228856 +-162280 0; +#X text 98 397 signal; +#X obj 78 459 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X text 98 459 signal; +#X obj 42 111 osc~ 100; +#X msg 50 136 clear; +#X obj 69 187 sig~; +#X obj 96 209 sig~; +#X obj 126 229 sig~; +#X msg 57 162 set 0.6 0.8; +#X obj 41 252 czero~ 0.9 0.4; +#X obj 496 12 czero~; +#X text 179 152 The action of czero~ is:; +#X text 238 173 y[n] = x[n] - a[n] * x[n-1]; +#X text 176 193 where y[n] is the output \, x[n] the input \, and a[n] +the filter coefficient (all complex numbers). The filter is always +stable.; +#X text 175 248 The transfer function is H(Z) = 1 - aZ^-1.; +#X text 11 23 complex one-zero (non-recursive) filter \, raw; +#X text 168 297 - signal to filter (real part).; +#X text 168 312 - clear internal state to zero.; +#X text 168 327 - set internal state (real & imaginary parts).; +#X text 168 347 - signal to filter ( imaginary part ).; +#X text 168 372 - filter coefficient ( real part ).; +#X text 168 397 - filter coefficient ( imaginary part ).; +#X text 167 506 - (optional) filter coefficient (real part).; +#X text 167 521 - (optional) filter coefficient (imaginary part).; +#X text 80 506 1) float; +#X text 80 521 2) float; +#X text 84 53 [czero~] filters a complex audio signal (first two inlets) via a one-zero filter \, whose coefficients are controlled by creation arguments or by another complex audio signal (remaining two inlets). ; -#X text 179 221 <-- filter coefficient (imaginary part); -#X text 14 279 The action of czero~ is:; -#X text 73 300 y[n] = x[n] - a[n] * x[n-1]; -#X text 11 320 where y[n] is the output \, x[n] the input \, and a[n] -the filter coefficient (all complex numbers). The filter is always -stable.; -#X text 12 369 The transfer function is H(Z) = 1 - aZ^-1.; -#X obj 53 244 czero~ 0.9 0.4; -#X connect 0 0 39 0; -#X connect 1 0 39 0; -#X connect 23 0 39 1; -#X connect 24 0 39 2; -#X connect 26 0 39 3; -#X connect 30 0 39 0; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 485 50 pddp/dsp; +#X obj 100 572 pddp/pddplink ../3.audio.examples/H12.peaking.pd -text +doc/3.audio.examples/H12.peaking.pd; +#X connect 23 0 29 0; +#X connect 24 0 29 0; +#X connect 25 0 29 1; +#X connect 26 0 29 2; +#X connect 27 0 29 3; +#X connect 28 0 29 0; diff --git a/doc/pddp/dac~-help.pd b/pd/doc/5.reference/dac~-help.pd similarity index 100% rename from doc/pddp/dac~-help.pd rename to pd/doc/5.reference/dac~-help.pd diff --git a/doc/pddp/dbtopow-help.pd b/pd/doc/5.reference/dbtopow-help.pd similarity index 100% rename from doc/pddp/dbtopow-help.pd rename to pd/doc/5.reference/dbtopow-help.pd diff --git a/doc/pddp/dbtopow~-help.pd b/pd/doc/5.reference/dbtopow~-help.pd similarity index 100% rename from doc/pddp/dbtopow~-help.pd rename to pd/doc/5.reference/dbtopow~-help.pd diff --git a/doc/pddp/dbtorms-help.pd b/pd/doc/5.reference/dbtorms-help.pd similarity index 100% rename from doc/pddp/dbtorms-help.pd rename to pd/doc/5.reference/dbtorms-help.pd diff --git a/doc/pddp/dbtorms~-help.pd b/pd/doc/5.reference/dbtorms~-help.pd similarity index 100% rename from doc/pddp/dbtorms~-help.pd rename to pd/doc/5.reference/dbtorms~-help.pd diff --git a/pd/doc/5.reference/declare-help.pd b/pd/doc/5.reference/declare-help.pd index 2e427b521..046719bc0 100644 --- a/pd/doc/5.reference/declare-help.pd +++ b/pd/doc/5.reference/declare-help.pd @@ -1,33 +1,68 @@ -#N canvas 103 177 618 583 12; +#N canvas 426 36 555 619 10; #X declare; -#X obj 48 10 declare; -#X text 120 11 - set environment for loading patch; -#X text 44 40 A declare object adds one or more directories to the -search path \, and/or pre-loads one or more libraries ("extensions") -to Pd in preparation for opening the patch from a file. Usage is "declare -[-flag value] [-flag value] ..." where the flag can be:; -#X text 31 182 -lib; -#X text 31 198 -stdlib; -#X text 31 146 -path; -#X text 31 162 -stdpath; -#X text 129 146 add to search path \, relative to the patch; -#X text 129 182 load a library \, relative to the patch; -#X text 129 199 load a library \, relative to Pd; -#X text 40 231 (for any of these you may use a full pathname such as -"/tmp/dir" or \, in Windows \, "C:/garbage" instead of a relative path). -; -#X text 39 293 For instance \, if you put abstractions and/or other -supporting files in a subdirectory "more" \, you can put an object -\, "declare -path more" to make sure Pd sees them when the patch is -loaded. Or \, if you have zexy installed in the directory extra/zexy -(in the Pd installation") you can get it using "declare -stdpath extra/zexy". -; -#X text 129 163 add to search path \, relative to Pd; -#X text 367 557 updated for Pd version 0.41; -#X text 42 395 WARNING: you might want to avoid putting "declare" statements +#X declare; +#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 declare 3 12 0 18 +-204280 -1 0; +#X obj 0 105 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 483 286 494 344 META 0; +#X text 12 65 LIBRARY internal; +#X text 12 105 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 85 AUTHOR Miller Puckette; +#X text 12 145 HELP_PATCH_AUTHORS Updated for Pd version 0.41. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 45 DESCRIPTION set environment for loading patch; +#X text 12 125 RELEASE_DATE 1997; +#X text 12 5 KEYWORDS control pd_op; +#X restore 500 597 pd META; +#X obj 0 134 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 164 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 386 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 215 523 428 103 Related_objects 0; +#X obj 15 34 import; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 7 1 [declare] Related Objects; +#X restore 101 597 pd Related_objects; +#X obj 494 12 declare; +#X text 98 109 (none); +#X text 98 139 (none); +#X text 164 291 -lib; +#X text 164 307 -stdlib; +#X text 164 255 -path; +#X text 164 271 -stdpath; +#X text 262 255 add to search path \, relative to the patch; +#X text 262 291 load a library \, relative to the patch; +#X text 262 308 load a library \, relative to Pd; +#X text 161 333 (for any of these you may use a full pathname such +as "/tmp/dir" or \, in Windows \, "C:/garbage" instead of a relative +path).; +#X text 262 272 add to search path \, relative to Pd; +#X text 98 482 WARNING: you might want to avoid putting "declare" statements inside abstractions \, as their effects will extend to the calling patch. As of version 0.41 \, "declare path" is ignored inside abstractions \, although \, probably unwisely \, "-stdpath" takes effect (on the calling patch as well as the abstraction.); -#X text 42 494 BUG: The name "-stdpath" is confusing \, as it has a +#X text 98 561 BUG: The name "-stdpath" is confusing \, as it has a quite different effect from "-stdpath" on the pd command line.; +#X text 11 23 set environment for loading patch; +#X text 139 69 NEEDS AN EXAMPLE; +#X text 165 185 - the [declare] object adds one or more directories +to the search path \, and/or pre-loads one or more libraries ("extensions") +to Pd in preparation for opening the patch from a file. Usage is "declare +[-flag value] [-flag value] ..." where the flag can be:; +#X text 97 400 If you put abstractions and/or other supporting files +in a subdirectory "more" \, you can put an object \, "declare -path +more" to make sure Pd sees them when the patch is loaded. Or \, if +you have zexy installed in the directory extra/zexy (in the Pd installation") +you can get it using "declare -stdpath extra/zexy".; +#X text 80 185 n) symbol atom; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; diff --git a/pd/doc/5.reference/delay-help.pd b/pd/doc/5.reference/delay-help.pd index 5f90cd4b0..7425a1dfc 100644 --- a/pd/doc/5.reference/delay-help.pd +++ b/pd/doc/5.reference/delay-help.pd @@ -1,30 +1,185 @@ -#N canvas 3 0 513 348 12; -#X obj 66 15 delay; -#X obj 13 229 50; -#X msg 13 98 bang; -#X floatatom 13 255; -#X floatatom 116 182; -#X obj 51 230 0; -#X text 111 16 - CALLBACK AFTER TIME DELAY; -#X text 130 205 <-- creation argument initializes delay time; -#X text 6 41 The delay object sends a bang to its outlet after a delay in milliseconds specified by its right inlet or its creation argument.; -#X obj 51 204 delay 1000; -#X text 58 86 Click here to test the delay object by initializing the number box below to 50 and then clearing it after the specified delay.; -#X text 94 132 Click here to CANCEL delay's action; -#X msg 51 133 stop; -#X text 43 324 see also:; -#X obj 155 323 timer; -#X obj 111 323 metro; -#X msg 62 155 2000; -#X text 102 154 Number in right inlet sets time and schedules the action.; -#X text 316 320 updated for Pd version 0.3; -#X text 145 183 <-- scroll to change delay time in milliseconds; -#X text 14 280 Note: sending a bang to a delay which is already set will reschedule its output \, cancelling the old one.; -#X connect 1 0 3 0; -#X connect 2 0 1 0; -#X connect 2 0 9 0; -#X connect 4 0 9 1; -#X connect 5 0 3 0; -#X connect 9 0 5 0; -#X connect 12 0 9 0; -#X connect 16 0 9 0; +#N canvas 430 34 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 delay 3 12 0 18 +-204280 -1 0; +#X obj 0 200 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 482 240 494 386 META 1; +#X text 12 145 LIBRARY internal; +#X text 12 185 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 45 LICENSE SIBSD; +#X text 12 165 AUTHOR Miller Puckette; +#X text 12 225 HELP_PATCH_AUTHORS This help patch was updated for Pd +version 0.35 test 28 by Dave Sabine as part of a project called pddp +proposed by Krzysztof Czaja to build comprehensive documentation for +Pd. Jonathan Wilkes revised the patch to conform to the PDDP template +for Pd version 0.42.; +#X text 12 65 DESCRIPTION bang after time delay; +#X text 12 5 ALIAS del; +#X text 12 85 INLET_0 float bang stop; +#X text 12 105 INLET_1 float; +#X text 12 125 OUTLET_0 bang; +#X text 12 25 KEYWORDS control time bang_op; +#X text 12 205 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 393 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 446 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 488 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 219 337 428 291 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 obj 42 37 timer; +#X obj 8 37 pipe; +#X obj 80 37 metro; +#X obj 119 37 makenote; +#X obj 180 87 delwrite~; +#X text 4 208 The best places to find information about Pd's libraries +is:; +#X text 4 230 www.puredata.org and click on "Downloads" then "Software" +; +#X text 4 251 iem.kug.ac.at/pdb/; +#X text 5 112 Externals; +#X text 5 159 Externals are offered in Pd only if you have downloaded +and properly installed the appropriate library. These objects may or +may not exist in a single library.; +#X text 7 62 Audio Objects; +#X obj 10 87 vd~; +#X obj 47 87 delread~; +#X obj 113 89 delwrite~; +#X text 7 1 [delay] Related Objects; +#X obj 12 134 nop~; +#X obj 48 134 z~; +#X obj 78 133 t3_delay; +#X obj 138 133 idelay~; +#X obj 192 133 delay~; +#X restore 101 597 pd Related_objects; +#X obj 78 209 cnv 17 3 145 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 402 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 360 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X text 98 359 float; +#X obj 452 12 delay; +#X text 492 12 or; +#X obj 518 11 del; +#X obj 100 102 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 100 150 delay 2000; +#X obj 100 173 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X text 98 253 bang; +#X text 98 313 stop; +#X text 168 359 - a float to the right inlet sets the delay time (in +milliseconds).; +#X text 98 336 list; +#X text 98 401 bang; +#X msg 168 101 stop; +#X msg 122 101 500; +#X floatatom 157 128 0 0 0 0 - - -; +#X text 188 129 <- scroll to change delay time in milliseconds; +#X text 168 401 - [delay] only outputs a bang. It cannot be used like +an "echo" or to delay messages other than bang. For that purpose \, +you should explore [pipe].; +#N canvas 106 287 428 250 A_delay_based_metronome 0; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 19 55 Let's assume for a moment that Miller had forgotten to +build the [metro] object. (I know that sounds absurd \, but for the +sake of example...); +#X text 19 104 [delay] could be used to create a metronome as follows. +; +#X obj 58 197 bng 15 50 10 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 58 175 delay 1000; +#X msg 22 135 bang; +#X msg 58 135 stop; +#X obj 260 176 metro 1000; +#X obj 260 197 bng 15 50 10 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 260 157 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0 +1; +#X floatatom 317 155 5 0 0 0 - - -, f 5; +#X floatatom 115 154 5 0 0 0 - - -, f 5; +#X text 152 175 is the same as; +#X text 19 36 A makeshift [metro]; +#X text 7 1 [delay] A Metronome Built with [delay]; +#X connect 3 0 5 0; +#X connect 4 0 3 0; +#X connect 5 0 4 0; +#X connect 6 0 4 0; +#X connect 7 0 8 0; +#X connect 9 0 7 0; +#X connect 10 0 7 1; +#X connect 11 0 4 1; +#X restore 101 550 pd A_delay_based_metronome; +#N canvas 103 173 428 389 Random_Impulse_Generator 0; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 21 35 Some users might be familiar with SC (SuperCollider) +by James McCartney. For more info about SC \, visit www.audiosynth.com. +Anyways...SC has a unit generator called "DUST". Dust will produce +random impulses at a specified "density". I believe that Dust was given +its name because it creates a sound that is similar to actual dust +on old vinyl LP's -- you know that old crackling sound like Rice Krispies. +; +#X text 20 143 The idea is quite simple. If you want a "very dusty" +sound \, you make the density quite high...if you want a "slightly +dusty" sound \, you make the density quite low.; +#X obj 22 299 delay; +#X obj 22 321 bng 15 50 10 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 22 235 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0 1 +; +#X text 20 188 Dust.ar(2) in SC will produce 2 dusty impulses randomly +per second. In the example below \, you'll see a version of this process +created using Pd's delay object.; +#X obj 22 278 random 500; +#X obj 22 257 metro 500; +#X floatatom 92 236 5 0 0 0 - - -, f 5; +#X text 20 343 Also note that this example merely approximates the +output of SC's "Dust" object.; +#X text 130 236 low numbers produce a very "dusty" output.; +#X text 130 248 high numbers produce a slightly "dusty" output.; +#X text 7 1 [delay] A Random Impulse Generator using [delay]; +#X connect 3 0 4 0; +#X connect 5 0 8 0; +#X connect 7 0 3 0; +#X connect 8 0 7 0; +#X connect 9 0 8 1; +#X connect 9 0 7 1; +#X restore 101 572 pd Random_Impulse_Generator; +#X text 168 313 - causes [delay] to cancel its scheduled output.; +#X text 168 336 - a list of floats will be truncated to the first element. +; +#X text 80 465 1) float; +#X text 97 54 The [delay] object sends a bang to its outlet after a +delay (in milliseconds) \, specified by its right inlet or its creation +argument.; +#X text 168 253 - a bang to the left inlet will output a bang after +the prescribed time (set either at the right inlet creation argument). +In the above example \, you should notice a delay of 2 seconds \, then +a bang at the outlet.; +#X text 168 208 - if a float is sent to the left inlet \, [delay] will +set the delay time equal to that number (milliseconds) and schedule +the outgoing bang.; +#X text 98 492 [delay] accepts only ONE bang at a time. It cannot process +multiple delays. In other words \, sending a "bang" to a [delay] which +is already set will reschedule its output \, cancelling the old one. +; +#X text 168 465 - (optional) initial delay time (in milliseconds). +; +#X text 98 208 float; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 298 550 pddp/pddplink ../2.control.examples/07.time.pd; +#X text 11 23 bang after time delay; +#X connect 15 0 16 0; +#X connect 16 0 17 0; +#X connect 23 0 16 0; +#X connect 24 0 16 0; +#X connect 25 0 16 1; diff --git a/doc/pddp/delread4~-help.pd b/pd/doc/5.reference/delread4~-help.pd similarity index 100% rename from doc/pddp/delread4~-help.pd rename to pd/doc/5.reference/delread4~-help.pd diff --git a/pd/doc/5.reference/delread~-help.pd b/pd/doc/5.reference/delread~-help.pd index 682f6e98d..f35dfcf14 100644 --- a/pd/doc/5.reference/delread~-help.pd +++ b/pd/doc/5.reference/delread~-help.pd @@ -1,33 +1,87 @@ -#N canvas 24 20 796 472 12; -#X text 351 276 1st argument: name of delay line; -#X floatatom 116 253 0 0 0; -#X text 151 255 float input (delay time in ms); -#X text 127 310 signal output (delayed signal); -#X text 21 52 You can use more than one delread~ objects for the same delay line.; -#X text 20 81 If the specified delay time is longer than the size of the delay line or less than zero it is clipped to the length of the delay line.; -#X obj 383 226 delwrite~ del_example 1000; -#X floatatom 383 177 0 0 0; -#X obj 116 375 snapshot~; -#X floatatom 116 399 0 0 0; -#X obj 24 246 loadbang; -#X obj 24 313 metro 200; -#X msg 32 273 \; pd dsp 1; -#X obj 116 286 delread~ del_example 1000; -#X obj 24 16 delread~; -#X text 424 176 input to delay line; -#X obj 383 201 sig~; -#X text 433 443 updated for Pd version 0.33; -#X text 89 16 - read a signal from a delay line; -#X text 21 133 Note: if the delaywrite~ runs after the delread~ the minimum delay is actually one DSP period \, not zero.; -#X text 351 292 2nd argument: (initial) delay time in ms; -#X obj 126 444 delwrite~; -#X obj 217 444 vd~; -#X text 36 443 see also:; -#X connect 1 0 13 0; -#X connect 7 0 16 0; -#X connect 8 0 9 0; -#X connect 10 0 11 0; -#X connect 10 0 12 0; -#X connect 11 0 8 0; -#X connect 13 0 8 0; -#X connect 16 0 6 0; +#N canvas 428 33 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 delread~ 3 12 0 +18 -204280 -1 0; +#X obj 0 292 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 484 286 494 344 META 0; +#X text 12 105 LIBRARY internal; +#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 165 RELEASE_DATE 2009-06-12; +#X text 12 25 LICENSE SIBSD; +#X text 12 125 AUTHOR Miller Puckette; +#X text 12 185 HELP_PATCH_AUTHORS Updated for Pd version 0.33. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 5 KEYWORDS signal nonlocal time; +#X text 12 45 DESCRIPTION read a signal from a delay line; +#X text 12 85 OUTLET_0 signal; +#X text 12 65 INLET_0 float; +#X restore 500 597 pd META; +#X obj 0 384 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 479 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#X obj 78 301 cnv 17 3 75 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#N canvas 216 491 428 139 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 19 78 Control objects for delays:; +#X obj 22 105 delay; +#X obj 67 105 pipe; +#X obj 22 42 delwrite~ help; +#X obj 127 42 vd~ help; +#X text 7 1 [delread~] Related Objects; +#X restore 101 597 pd Related_objects; +#X obj 78 393 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 393 signal; +#X floatatom 299 169 0 0 0 0 - - -; +#X text 340 168 input to delay line; +#X obj 299 193 sig~; +#X floatatom 112 122 0 0 0 0 - - -; +#X text 139 122 float input (delay time in ms); +#X obj 112 217 snapshot~; +#X floatatom 112 241 0 0 0 0 - - -; +#X obj 123 173 loadbang; +#X obj 123 195 metro 200; +#X text 98 300 float; +#X text 98 320 list; +#X text 98 339 Note: If the specified delay time is longer than the +size of the delay line or less than zero it is clipped to the length +of the delay line.; +#X text 98 483 You can use more than one [delread~] object for the +same delay line.; +#X obj 485 10 delread~; +#X obj 299 218 delwrite~ delread_ex 1000; +#X obj 112 148 delread~ delread_ex 1000; +#X text 11 23 read a signal from a delay line; +#X text 168 300 - a float sets the delay time (in milliseconds).; +#X text 168 320 - lists are truncated to the first element.; +#X text 168 393 - the delayed signal.; +#X text 168 440 - name of delay line.; +#X text 168 455 - (optional) initial delay time (ms).; +#X text 80 455 2) float; +#X text 98 511 Note: if the [delwrite~] runs after the [delread~] the +minimum delay is actually one DSP period \, not zero.; +#X text 80 440 1) symbol atom; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 474 58 pddp/dsp; +#X obj 98 542 pddp/pddplink ../3.audio.examples/G01.delay.pd -text +doc/3.audio.examples/G01.delay.pd; +#X obj 98 557 pddp/pddplink ../3.audio.examples/G02.delay.loop.pd -text +doc/3.audio.examples/G02.delay.loop.pd; +#X obj 98 572 pddp/pddplink ../3.audio.examples/G05.execution.order.pd +-text doc/3.audio.examples/G05.execution.order.pd; +#X connect 11 0 13 0; +#X connect 13 0 25 0; +#X connect 14 0 26 0; +#X connect 16 0 17 0; +#X connect 18 0 19 0; +#X connect 19 0 16 0; +#X connect 26 0 16 0; diff --git a/pd/doc/5.reference/delwrite~-help.pd b/pd/doc/5.reference/delwrite~-help.pd index 50ca3f633..efcfbf265 100644 --- a/pd/doc/5.reference/delwrite~-help.pd +++ b/pd/doc/5.reference/delwrite~-help.pd @@ -1,15 +1,95 @@ -#N canvas 12 24 663 281 12; -#X obj 24 16 delwrite~; -#X obj 24 158 delwrite~ del_line_xxx 500; -#X text 88 123 signal input; -#X text 116 16 writes a signal in a delay line; -#X text 271 156 1st argument: name of delay line; -#X text 411 243 updated for Pd version 0.33; -#X obj 24 124 sig~ 0; -#X text 19 50 Delwrite~ allocates memory for a delay line and writes an audio signal into it. Delread~ objects by hte same name read from the delay line.; -#X text 294 186 (= max. delay time); -#X text 271 172 2nd argument: length of delay line in msec; -#X text 24 203 see also:; -#X obj 112 205 delread~; -#X obj 193 205 vd~; -#X connect 6 0 1 0; +#N canvas 431 33 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 delwrite~ 3 12 0 +18 -204280 -1 0; +#X obj 0 268 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 489 284 494 344 META 0; +#X text 12 85 LIBRARY internal; +#X text 12 125 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 145 RELEASE_DATE 2009-06-12; +#X text 12 25 LICENSE SIBSD; +#X text 12 105 AUTHOR Miller Puckette; +#X text 12 165 HELP_PATCH_AUTHORS Updated for Pd version 0.33. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 5 KEYWORDS signal nonlocal; +#X text 12 45 DESCRIPTION write a signal in a delay line; +#X text 12 65 INLET_0 signal; +#X restore 500 597 pd META; +#X obj 0 321 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 350 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 429 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#X obj 78 277 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#N canvas 219 490 428 139 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 19 79 Control objects for delays:; +#X obj 22 106 delay; +#X obj 67 106 pipe; +#X obj 22 43 delread~ delwrite_ex; +#X obj 157 43 vd~ delwrite_ex; +#X text 7 2 [delwrite~] Related Objects; +#X restore 101 597 pd Related_objects; +#X floatatom 90 97 0 0 0 0 - - -; +#X text 119 96 input to delay line; +#X obj 90 121 sig~; +#X floatatom 282 63 0 0 0 0 - - -; +#X obj 282 168 snapshot~; +#X floatatom 282 192 0 0 0 0 - - -; +#X obj 293 112 loadbang; +#X obj 293 134 metro 200; +#X obj 479 10 delwrite~; +#X obj 90 146 delwrite~ delwrite_ex 1000; +#X obj 282 86 delread~ delwrite_ex 1000; +#X floatatom 356 110 0 0 0 0 - - -; +#X obj 357 168 snapshot~; +#X floatatom 357 192 0 0 0 0 - - -; +#X obj 356 133 delread~ delwrite_ex 500; +#X text 98 326 (none); +#X text 98 276 signal; +#X text 168 276 - the signal is read by all [delread~] and [vd~] objects +with the same delay line name (delwrite_ex in the above example).; +#X text 169 384 - length of the delay line in milliseconds \, which +is the maximum delay time any receiving [delread~] or [vd~] object +may have.; +#X text 98 224 [delwrite~] allocates memory for a delay line and writes +an audio signal into it. [delread~] objects by the same name read from +the delay line.; +#X text 169 369 - name of the delay line.; +#X text 99 433 You can use more than one [delread~] object for the +same delay line. (See example above).; +#X text 80 384 2) float; +#X text 99 461 Note: if the [delwrite~] runs after the [delread~] the +minimum delay is actually one DSP period \, not zero.; +#X text 80 369 1) symbol atom; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 472 58 pddp/dsp; +#X obj 99 492 pddp/pddplink ../3.audio.examples/G01.delay.pd -text +doc/3.audio.examples/G01.delay.pd; +#X obj 99 512 pddp/pddplink ../3.audio.examples/G02.delay.loop.pd -text +doc/3.audio.examples/G02.delay.loop.pd; +#X obj 99 532 pddp/pddplink ../3.audio.examples/G03.delay.variable.pd +-text doc/3.audio.examples/G03.delay.variable.pd; +#X obj 99 552 pddp/pddplink ../3.audio.examples/G04.control.blocksize.pd +-text doc/3.audio.examples/G04.control.blocksize.pd; +#X obj 99 572 pddp/pddplink ../3.audio.examples/G05.execution.order.pd +-text doc/3.audio.examples/G05.execution.order.pd; +#X text 11 23 write a signal in a delay line; +#X connect 9 0 11 0; +#X connect 11 0 18 0; +#X connect 12 0 19 0; +#X connect 13 0 14 0; +#X connect 15 0 16 0; +#X connect 16 0 13 0; +#X connect 16 0 21 0; +#X connect 19 0 13 0; +#X connect 20 0 23 0; +#X connect 21 0 22 0; +#X connect 23 0 21 0; diff --git a/pd/doc/5.reference/drawnumber-help.pd b/pd/doc/5.reference/drawnumber-help.pd index a56b13aac..c5b92fbb7 100644 --- a/pd/doc/5.reference/drawnumber-help.pd +++ b/pd/doc/5.reference/drawnumber-help.pd @@ -1,43 +1,161 @@ -#N struct help-drawnumber-template float x float y float cat float -dog; -#N canvas 51 46 538 189 12; -#X text 15 103 see also:; -#X obj 18 7 drawnumber; -#X obj 187 132 plot; -#X obj 83 131 drawpolygon; -#X text 114 7 -- draw numeric fields from data structures; -#N canvas 14 10 297 129 help-drawnumber-data 1; -#X scalar help-drawnumber-template 50 100 23 43 \;; -#X scalar help-drawnumber-template 150 50 3.14 -1.618 \;; -#X restore 273 71 pd help-drawnumber-data; -#N canvas 528 70 575 505 help-drawnumber-template 1; -#X text 23 438 This object defines the fields for this template. Their -values are initialized in the "works" subwindow. You can see them by -right-clicking on the object in the "data" window and selecting "properties." -; -#X text 42 211 - RGB color (0=black \, 999=white \, 900=red \, 90=green -\, 9=blue \, 555=grey \, etc.); -#X text 19 316 When not in "edit" mode \, you can click and drag vertically +#N struct drawnumber-help-template float x float y float cat float +dog float dog-vis; +#N canvas 429 35 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 drawnumber 3 12 +0 18 -204280 -1 0; +#X obj 0 119 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 487 282 494 344 META 0; +#X text 12 105 LIBRARY internal; +#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 165 RELEASE_DATE 2009-06-12; +#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.39. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 25 KEYWORDS control data_structure; +#X text 12 65 DESCRIPTION display a numberic field of a template; +#X text 12 5 ALIAS drawsymbol; +#X text 12 85 INLET_0 float; +#X restore 500 597 pd META; +#X obj 0 204 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 232 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 460 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 212 459 428 169 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 obj 92 42 struct; +#X obj 142 42 drawpolygon; +#X obj 223 42 plot; +#X obj 17 42 drawsymbol; +#X obj 262 42 drawcurve; +#X text 7 78 Other Data Structure Objects; +#X obj 245 112 element; +#X obj 76 112 get; +#X obj 107 112 set; +#X obj 136 112 getsize; +#X obj 190 112 setsize; +#X obj 22 112 pointer; +#X text 7 1 [drawnumber] Related Objects; +#X restore 101 597 pd Related_objects; +#X obj 78 128 cnv 17 3 65 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 127 float; +#X text 98 177 list; +#X text 168 127 - [drawnumber] has a single inlet to toggle visibility +of the number. A zero makes it invisible. Any nonzero value makes it +visible.; +#X text 98 208 (none); +#N canvas 7 169 428 164 drawnumber-help-data 0; +#X scalar drawnumber-help-template 24 61 49 17 1 \;; +#X scalar drawnumber-help-template 174 61 41 18 1 \;; +#X obj 1 1 cnv 15 425 20 empty empty empty 20 12 2 14 -204280 -195568 +0; +#X text 6 1 [drawnumber] Window to Display Data Structure Instances +; +#X text 21 91 Each dog/cat pair is a scalar. (You can click each in +editmode to get a bounding blue box and move them around.) When not +in editmode you may click and scroll the values up and down for each +field.; +#X restore 28 61 pd drawnumber-help-data; +#N canvas 115 43 428 526 drawnumber-help-template 0; +#X obj 23 121 drawnumber cat 0 0 0 cat=; +#X obj 23 92 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0 1 +; +#X obj 22 454 struct drawnumber-help-template float x float y float +cat float dog float dog-vis; +#X obj 22 314 tgl 15 0 empty empty empty 17 7 0 10 -262144 -1 -1 0 +1; +#X obj 22 353 set drawnumber-help-template dog-vis; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 7 1 [drawnumber] subpatch for data structure template; +#N canvas 115 239 426 147 init 0; +#X obj 14 57 pointer; +#X msg 14 35 traverse pd-drawnumber-help-data \, next; +#X obj 14 12 loadbang; +#X obj 14 80 outlet; +#X text 67 58 This just sends a pointer to the right inlet of the [set] +object; +#X text 257 39 the list); +#X text 255 27 (select the first scalar in; +#X connect 0 0 3 0; +#X connect 1 0 0 0; +#X connect 2 0 1 0; +#X restore 235 331 pd init; +#X text 42 91 "0" makes both "cat" fields invisible; +#X text 40 311 "0" makes a single instance of a "dog" field invisible +; +#X obj 23 210 drawnumber -v dog-vis dog 0 -15 900 dog=; +#X text 20 29 [drawnumber] is used below to display the values of two +fields- "dog" and "cat". These two fields are defined in the template +"drawnumber-help-template" located at the bottom of this subpatch. +; +#X text 20 139 For the [drawnumber] object associated with "cat" above +\, a [toggle] is connected to the inlet. This toggles visibility globally +(i.e. \, for all existing scalars defined by the template "drawnumber-help-template"). +; +#X text 21 229 The [drawnumber] object for "dog" above uses the -v +flag \, which can be used to set visibility for each scalar individually. +The (flag \, value) pair "-v dog-vis" means that the field "dog-vis" +determines whether "dog" will be visible in a given scalar. (If you +use the -v flag you can no longer use the inlet of this [drawsymbol] +object.); +#X text 19 372 With the [set] object \, we can change the value of +"dog-vis" in order to set visibility for the "dog" field. Notice when +you click the [toggle] \, it only affects one scalar-- the one which +the [set] object is currently pointing to (see the "init" subpatch). +; +#X text 19 487 This object defines the fields for this template. (Their +values were initialized when this help patch was created.); +#X connect 1 0 0 0; +#X connect 3 0 4 0; +#X connect 7 0 4 1; +#X restore 28 89 pd drawnumber-help-template; +#X obj 474 12 drawnumber; +#X text 99 464 When not in "edit" mode \, you can click and drag vertically on the numbers to change their values. (In edit mode you can move \, cut \, copy \, and paste the objects.); -#X text 21 365 Keyboard entry isn't supported yet.; -#X obj 25 56 drawnumber cat 0 0 0 cat=; -#X obj 260 57 drawnumber dog 0 -15 900 dog=; -#X text 42 243 - an optional label ("cat=" for instance); -#X text 27 85 drawnumber takes arguments specifying:; -#X text 42 191 - an (x \, y) pair giving relative coordinates \;; -#X text 42 171 - the number to draw; -#X text 44 24 "0" in inlet makes invisible; -#X obj 25 27 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0 1 -; -#X text 46 112 - optional "-n" flag to make invisible initially; -#X text 44 133 - alternatively \, an optional "-v [variable]" flag -to assign a variable to make this visible/invisible.; -#X text 20 273 Any of these (except the two flags) can be numbers or -field names \, like "dog" and "cat" here.; -#X obj 13 397 struct help-drawnumber-template float x float y float -cat float dog; -#X connect 11 0 4 0; -#X restore 273 44 pd help-drawnumber-template; -#X obj 22 130 struct; -#X text 275 159 updated for Pd version 0.39; +#X text 201 89 <- click this subpatch to see how [drawnumber] is used. +; +#X text 179 59 <- subpatch to display the data structures; +#X text 11 23 display a numeric field of a template; +#X text 98 437 Note: you cannot use both the -n and -v flag.; +#X text 168 177 - a list will be truncated to the first element.; +#X text 80 253 0-2 flags; +#X text 168 304 - the field name of the number to draw.; +#X text 168 353 - RGB color (0=black \, 999=white \, 900=red \, 90=green +\, 9=blue \, 555=grey \, etc.).; +#X text 168 381 - (optional) label ("cat=" for instance).; +#X text 168 253 - "-n" flag to make the number invisible initially. +; +#X text 168 270 - a "-v [variable]" flag to assign a variable to make +the number visible/invisible.; +#X text 168 321 - relative x coordinate.; +#X text 168 337 - relative y coordinate.; +#X text 80 321 2) *; +#X text 80 337 3) *; +#X text 80 353 4) *; +#X text 80 304 1) *; +#X text 98 504 Keyboard entry is supported for [drawnumber] (but not +for [drawsymbol]) when not in editmode. Click a number to enter values +\, the click the enter key when you are finished.; +#X text 80 270 (symbol atoms); +#X text 80 381 5) symbol atom; +#X text 98 405 * Any of these can be numbers (float) or field names +(symbol atom).; +#X obj 98 542 pddp/pddplink drawsymbol-help.pd; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 318 542 pddp/pddplink ../4.data.structures/09.scaling.pd -text +doc/4.data.structure/09.scaling.pd; +#X obj 318 557 pddp/pddplink ../4.data.structures/10.onoff.pd -text +doc/4.data.structures/10.onoff.pd; +#X obj 98 572 pddp/pddplink all_about_z_order.pd; +#X obj 98 557 pddp/pddplink scalar-help.pd; diff --git a/pd/doc/5.reference/drawpolygon-help.pd b/pd/doc/5.reference/drawpolygon-help.pd index 7b3dfd246..4e135ab20 100644 --- a/pd/doc/5.reference/drawpolygon-help.pd +++ b/pd/doc/5.reference/drawpolygon-help.pd @@ -1,46 +1,171 @@ -#N struct help-drawpolygon-template float x float y float cat float -dog float weasel; -#N canvas 16 28 537 188 12; -#X text 13 130 see also:; -#X obj 95 149 drawnumber; -#X obj 191 149 plot; -#X obj 21 10 drawpolygon; -#X obj 21 33 drawcurve; -#X obj 126 11 filledpolygon; -#X obj 127 33 filledcurve; -#X text 225 10 -- draw shapes for data structures; -#N canvas 177 100 580 549 help-drawpolygon-template 1; -#X obj 19 24 drawpolygon 0 2 0 0 0 weasel; -#X obj 18 300 filledpolygon 900 dog 3 10 0 20 cat 30 0; -#X text 30 322 filledpolyconn and filledcurve take the same arguments -\, except that a new first argument is added to specify interior color. -Here the interior color is red (900) \, the outline color is controlled -by the "dog" field \, and the three points describe a triangle of altitude -"cat". The fields x and y automatically govern the placement of the -object as a whole.; -#X text 37 164 - RGB color (0=black \, 999=white \, 900=red \, 90=green +#N struct drawpolygon-help-template float x float y float weasel float +dog float cat float vis; +#N canvas 432 31 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 drawpolygon 3 12 +0 18 -204280 -1 0; +#X obj 0 147 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 487 277 494 344 META 0; +#X text 12 85 LIBRARY internal; +#X text 12 125 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 145 RELEASE_DATE 2009-06-12; +#X text 12 25 LICENSE SIBSD; +#X text 12 105 AUTHOR Miller Puckette; +#X text 12 165 HELP_PATCH_AUTHORS This help patch was updated for Pd +version 0.35 test 28 by Dave Sabine as part of a project called pddp +proposed by Krzysztof Czaja to build comprehensive documentation for +Pd. Jonathan Wilkes revised the patch to conform to the PDDP template +for Pd version 0.42.; +#X text 12 5 KEYWORDS control data_structure; +#X text 12 45 DESCRIPTION display a polygon in a data structure instance +; +#X text 12 65 INLET_0 float; +#X restore 500 597 pd META; +#X obj 0 222 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 250 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 516 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 216 468 428 156 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 obj 92 42 struct; +#X obj 142 42 drawpolygon; +#X obj 223 42 plot; +#X obj 17 42 drawsymbol; +#X obj 262 42 drawcurve; +#X text 7 78 Other Data Structure Objects; +#X obj 245 112 element; +#X obj 76 112 get; +#X obj 107 112 set; +#X obj 136 112 getsize; +#X obj 190 112 setsize; +#X obj 22 112 pointer; +#X text 7 1 [drawpolygon] Related Objects; +#X restore 101 597 pd Related_objects; +#X obj 78 156 cnv 17 3 55 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 99 157 float; +#X text 168 154 - [drawnumber] has a single inlet to toggle visibility +of the number. A zero makes it invisible. Any nonzero value makes it +visible.; +#X text 98 226 (none); +#X text 179 80 <- subpatch to display the data structures; +#X obj 473 10 drawpolygon; +#N canvas 23 258 428 340 drawpolygon-help-data 0; +#X scalar drawpolygon-help-template 101 41 0 60 100 1 \;; +#X scalar drawpolygon-help-template 301 44 1 80 100 1 \;; +#X obj 1 1 cnv 15 425 20 empty empty empty 20 12 2 14 -204280 -195568 +0; +#X text 21 156 Three field values are used to draw these polygons. +The field "weasel" is used for the y-value of the top of the triangle +and the y-value of the top two points of the red "v". Fields "dog" +and "cat" are the top left and right x-values for the red "v".; +#X text 6 1 Window to Display Data Structures; +#X text 21 111 Each scalar consists of a set of numbers \, one triangle +\, and one red "v". In editmode you can click on a polygon to get a +blue bounding box around the scalar.; +#X text 21 226 In runmode you can click on each of these regions of +the polygons to alter their appearance. You may also scroll the displayed +values with the mouse to change them.; +#X text 21 276 Additionally \, you can right-click a scalar and select +"Properties" and edit the data in the text window that pops up.; +#X restore 28 82 pd drawpolygon-help-data; +#N canvas 102 75 428 563 drawpolygon-help-template 0; +#X obj 23 115 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0 1 +; +#N canvas 69 268 428 162 init 0; +#X obj 20 75 pointer; +#X obj 20 99 outlet; +#X obj 20 30 loadbang; +#X msg 20 53 traverse pd-drawpolygon-help-data \, next; +#X obj 0 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 6 1 [drawpolygon] Initialization subpatch; +#X text 81 80 This just locates the first scalar in the subpatch "drawpolygon-help-data" +and outputs a pointer to it.; +#X connect 0 0 1 0; +#X connect 2 0 3 0; +#X connect 3 0 0 0; +#X restore 217 316 pd init; +#X obj 22 298 tgl 15 0 empty empty empty 17 7 0 10 -262144 -1 -1 0 +1; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 7 1 [drawpolygon] subpatch; +#X obj 23 141 drawpolygon 0 4 0 40 40 40 20 weasel 0 40; +#X obj 22 27 struct drawpolygon-help-template float x float y float +weasel float dog float cat float vis; +#X text 42 114 "0" in inlet makes all instances of this polygon invisible +; +#X text 40 295 "0" in inlet makes a single instance of this polygon +invisible; +#X obj 22 340 set drawpolygon-help-template vis; +#X obj 23 491 drawnumber weasel -60 0 0 weasel=; +#X obj 23 511 drawnumber dog -60 15 0 dog=; +#X obj 23 532 drawnumber cat -60 30 0 cat=; +#X obj 23 199 drawpolygon -v vis 900 3 dog weasel 80 40 cat weasel +; +#X text 19 218 The next [drawpolygon] object uses the -v flag. This +flag controls visilibility of the polygon for only one instance of +a data structure. "-v vis" means that the value of field "vis" determines +whether the red "v" polygon is visible or not.; +#X text 19 360 Using the [set] object \, we can turn visibility on +and off for an instance of this polygon by changing the value of the +field "vis". Notice when you click the toggle above \, visibility only +changes for the red "v" furthest to the right. Once you use the -v +flag \, however \, you can no longer use the inlet to [drawpolygon] +to set visibility globally.; +#X text 19 447 Finally \, for convenience \, the following [drawnumber] +objects display the values of each field used in the drawing instructions +above:; +#X text 20 159 [drawpolygon] is used above to display a black triangle +and a red "v".; +#X text 19 60 The [struct] object defines the fields for this template. +You can see and edit the values by right-clicking the scalar in the +"data" subpatch and selecting "Properties."; +#X connect 0 0 5 0; +#X connect 1 0 9 1; +#X connect 2 0 9 0; +#X restore 28 109 pd drawpolygon-help-template; +#X text 98 471 Note: you cannot use the -n and -v flag together. When +using the -v flag \, the polygon is initially invisible by default. +; +#X text 99 519 When not in "edit" mode \, you can click on regions +of the polygon defined by template fields to stretch or alter the polygon's +shape.; +#X text 201 109 <- click this subpatch to see how [drawpolygon] is +used.; +#X text 11 23 display a polygon in a data structure instance; +#X text 168 195 - a list will be truncated to the first element.; +#X text 168 363 - RGB color (0=black \, 999=white \, 900=red \, 90=green \, 9=blue \, 555=grey \, etc.); -#X text 36 201 - line width; -#X text 36 222 - two or more (x \, y) pairs giving coordinates.; -#X text 25 485 This object defines the fields for this template. You -can see teh fields' values by right-clicking on the object in the "data" -window and selecting "properties."; -#X obj 13 441 struct help-drawpolygon-template float x float y float -cat float dog float weasel; -#X text 26 44 drawpolygon and drawcurve take these arguments:; -#X text 40 67 - optional "-n" flag to make invisible initially; -#X text 38 88 - alternatively \, an optional "-v [variable]" flag to -assign a variable to make this visible/invisible.; -#X text 27 243 Any of these (except the flags) can be numbers or field -names \, like "weasel" here. The example above draws a vertical black -line of height "weasel".; -#X text 38 127 - optional "-x" flag to inhibit selecting the object -when the shape is clicked on in "edit" mode; -#X restore 240 92 pd help-drawpolygon-template; -#N canvas 11 270 384 178 help-drawpolygon-data 1; -#X scalar help-drawpolygon-template 50 40 30 9 80 \;; -#X scalar help-drawpolygon-template 150 40 -20 90 50 \;; -#X coords 0 178 1 177 0 0 0; -#X restore 240 118 pd help-drawpolygon-data; -#X obj 34 149 struct; -#X text 272 166 updated for Pd version 0.40.; +#X text 168 390 - line width.; +#X text 168 414 - two or more (x \, y) pairs giving coordinates.; +#X text 168 270 - "-n" flag to make the polygon initially invisible. +; +#X text 168 289 - a "-v [variable]" flag to assign a variable to make +the polygon visible/invisible.; +#X text 80 390 2) *; +#X text 80 364 1) *; +#X text 80 414 n) *; +#X text 98 442 * Any of these can be numbers (float) or field names +(symbol atom).; +#X text 98 195 list; +#X text 80 309 (symbol atoms); +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 316 557 pddp/pddplink ../4.data.structures/09.scaling.pd -text +doc/4.data.structure/09.scaling.pd; +#X obj 316 572 pddp/pddplink ../4.data.structures/10.onoff.pd -text +doc/4.data.structures/10.onoff.pd; +#X obj 99 572 pddp/pddplink all_about_z_order.pd; +#X obj 99 557 pddp/pddplink scalar-help.pd; +#X text 80 270 0-3 flags; +#X text 80 290 (optional); +#X text 168 318 - "-x" flag to inhibit selecting the object when the +shape is clicked on in "edit" mode or clicked-and-dragged in "run mode". +; diff --git a/doc/pddp/drawsymbol-help.pd b/pd/doc/5.reference/drawsymbol-help.pd similarity index 100% rename from doc/pddp/drawsymbol-help.pd rename to pd/doc/5.reference/drawsymbol-help.pd diff --git a/doc/pddp/dynamic_sends.pd b/pd/doc/5.reference/dynamic_sends.pd similarity index 100% rename from doc/pddp/dynamic_sends.pd rename to pd/doc/5.reference/dynamic_sends.pd diff --git a/pd/doc/5.reference/element-help.pd b/pd/doc/5.reference/element-help.pd index 4a7de49c0..9346fbb81 100644 --- a/pd/doc/5.reference/element-help.pd +++ b/pd/doc/5.reference/element-help.pd @@ -1,51 +1,135 @@ -#N struct help-element-template float x float y array array1 help-element-array1-template +#N struct element-help-template float x float y array array1 array1-element-help-template ; -#N struct help-element-array1-template float y; -#N canvas 392 102 672 446 12; -#X text 24 373 see also:; -#N canvas 393 10 503 273 help-element-template 0; -#X obj 27 76 plot array1 500 1 10 15 20; -#X obj 27 174 filledpolygon 509 509 0 -10 -10 10 -10 10 10 -10 10; -#X obj 24 15 struct help-element-template float x float y array array1 -help-element-array1-template; -#X restore 414 349 pd help-element-template; -#N canvas 0 0 292 163 help-element-data 1; -#X scalar help-element-template 35 24 \; 0 \; 10 \; 0 \; 10 \; 20 \; -10 \; 20 \; 70 \; 10 \; \;; -#X restore 450 328 pd help-element-data; -#N canvas 196 292 373 142 help-element-array1-template 0; -#X obj 30 71 filledpolygon 0 0 0 -5 0 0 5 5 0 0 -5; -#X obj 32 27 struct help-element-array1-template float y; -#X restore 354 371 pd help-element-array1-template; -#X obj 22 11 element; -#X text 91 10 -- get pointer to an element of an array; -#X obj 98 393 pointer; -#X obj 166 393 getsize; -#X obj 234 393 setsize; -#X text 24 44 "element" takes a pointer at right and a number at left. -It looks up a field from the pointer \, which should be an array \, -and outputs the element of the array specified by the number. There -are no pointers to arrays themselves \, just to individual elements. -The template and field mane are specified as creation arguments.; -#X obj 150 228 pointer; -#X msg 150 204 traverse pd-help-element-data \, next; -#X floatatom 38 230 5 0 0 0 - - -; -#X obj 38 256 element help-element-template array1; -#X obj 38 303 get help-element-array1-template y; -#X floatatom 38 330 5 0 0 0 - - -; -#X text 370 256 arguments: template \, field name; -#X text 247 230 pointer inlet; -#X text 36 209 index; -#X text 43 277 outlet is pointer to single element; -#X text 89 328 here we just get the value of y.; -#X text 24 143 Indices range from 0 to the number of elements minus -one \; indices out of range are quietly replaced by the nearest endpoint. +#N struct array1-element-help-template float y; +#N canvas 428 35 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 element 3 12 0 18 +-204280 -1 0; +#X obj 0 333 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 482 282 494 344 META 0; +#X text 12 125 LIBRARY internal; +#X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 145 AUTHOR Miller Puckette; +#X text 12 205 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 5 KEYWORDS control data_structure array; +#X text 12 65 INLET_0 float list; +#X text 12 85 INLET_1 pointer; +#X text 12 105 INLET_2 pointer; +#X text 12 45 DESCRIPTION get pointer to an element of an array; +#X text 12 185 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 449 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 493 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 553 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 211 492 428 134 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 obj 92 72 struct; +#X obj 142 72 drawpolygon; +#X obj 223 72 plot; +#X obj 17 72 drawsymbol; +#X obj 262 72 drawcurve; +#X obj 71 37 get; +#X obj 102 37 set; +#X obj 131 37 getsize; +#X obj 185 37 setsize; +#X obj 17 37 pointer; +#X obj 240 37 drawnumber; +#X text 7 1 [element] Related Objects; +#X restore 101 597 pd Related_objects; +#X obj 78 342 cnv 17 3 70 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 99 343 float; +#X text 98 398 list; +#X text 228 255 <- subpatch to display the data structures; +#X obj 497 10 element; +#N canvas 80 372 428 228 element-help-data 0; +#X scalar element-help-template 40 40 \; 19 \; 0 \; 11 \; 9 \; 41 \; +14 \; 31 \; 38 \; 33 \; \;; +#X obj 0 0 cnv 15 425 20 empty empty empty 20 12 2 14 -204280 -195568 +0; +#X text 5 0 Window to Display Data Structure Instances; +#X text 20 155 You can also click and drag each element vertically +to change its value. When there is no "x" field specified (as in the +template array1-element-help-template) you can click and drag horizontally +to change multiple elements in one mouse swoop.; +#X text 20 110 Each purple square above represents one element of the +array. Using the [element] object in the parent window you can get +the y-value of each element.; +#X restore 77 257 pd element-help-data; +#N canvas 73 89 428 189 element-help-template 0; +#X obj 0 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 6 1 [element] subpatch; +#X obj 21 76 struct element-help-template float x float y array array1 +array1-element-help-template; +#X obj 21 158 filledpolygon 777 666 1 -10 -10 210 -10 210 65 -10 65 ; -#X text 152 184 click here first; -#X text 407 416 updated for Pd version 0.40; -#X obj 21 393 struct; -#X connect 10 0 13 1; -#X connect 11 0 10 0; -#X connect 12 0 13 0; -#X connect 13 0 14 0; -#X connect 14 0 15 0; +#X obj 21 120 plot -y y(0:41)(41:0) array1 500 1 0 15 25; +#X text 18 37 This [struct] contains an array "array1." The elements +of this array are defined by array1-element-help-template; +#X restore 77 279 pd element-help-template; +#N canvas 80 82 428 218 array1-element-help-template 0; +#X obj 0 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 6 1 [element] subpatch; +#X obj 21 73 struct array1-element-help-template float y; +#X obj 21 131 drawnumber y -5 -20 0; +#X obj 21 102 filledpolygon 509 0 1 -5 0 0 5 5 0 0 -5; +#X text 19 37 This [struct] is used in element-help-template to define +the elements of the array "array1."; +#X text 20 158 When "array1" is plotted \, each element will be represented +by a purple box and a number \, as specified here by the [filledpolygon] +and [drawnumber] objects.; +#X restore 77 301 pd array1-element-help-template; +#X obj 78 421 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X text 98 420 pointer; +#X text 169 343 - [element] takes a float to its left inlet \, which +specifies the element of an array. Indices range from zero to the number +of elements minus one. Indices out of range are quietly replaced by +the nearest endpoint.; +#X obj 78 458 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 459 pointer; +#X text 168 459 - when [element] receives a float to its left inlet +\, it outputs a pointer to the specified element of the array.; +#X obj 297 107 pointer; +#X floatatom 125 209 5 0 0 0 - - -, f 5; +#X text 130 156 outlet is pointer to single element; +#X text 176 207 here we just get the value of y.; +#X msg 297 83 traverse pd-element-help-data \, next; +#X obj 125 135 element element-help-template array1; +#X obj 125 182 get array1-element-help-template y; +#X obj 125 112 hradio 15 1 0 9 empty empty empty 0 -8 0 10 -262144 +-1 -1 0; +#X text 155 93 index (0-8); +#X floatatom 81 135 5 0 0 0 - - -, f 5; +#X text 11 23 get pointer to an element of an array; +#X text 168 527 - field name. The field name must be an array.; +#X text 168 398 - a list will be truncated to the first element.; +#X text 168 512 - name of the template.; +#X text 168 420 - the right inlet of [element] takes a pointer to a +scalar.; +#X text 80 512 1) symbol atom; +#X text 80 527 2) symbol atom; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 98 557 pddp/pddplink all_about_arrays.pd; +#X obj 98 572 pddp/pddplink scalar-help.pd; +#X text 125 75 2 ... then here; +#X text 299 63 1 Click here first...; +#X connect 22 0 27 1; +#X connect 26 0 22 0; +#X connect 27 0 28 0; +#X connect 28 0 23 0; +#X connect 29 0 27 0; +#X connect 29 0 31 0; diff --git a/pd/doc/5.reference/env~-help.pd b/pd/doc/5.reference/env~-help.pd index 212da3105..c63a5a74b 100644 --- a/pd/doc/5.reference/env~-help.pd +++ b/pd/doc/5.reference/env~-help.pd @@ -1,31 +1,75 @@ -#N canvas 134 127 625 411 12; -#X floatatom 11 332 0 0 0 0 - - -; -#X obj 74 14 env~; -#X text 120 16 - envelope follower; -#X obj 11 209 osc~ 400; -#X obj 11 236 *~; -#X floatatom 103 211 3 -99 300 0 - - -; -#X obj 103 235 dbtorms; -#X text 9 46 The env~ object takes a signal and outputs its RMS amplitude -in dB (with 1 normalized to 100 dB.) Output is bounded below by zero. +#N canvas 428 34 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 env~ 3 12 0 18 -204280 +-1 0; +#X obj 0 343 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 486 284 494 344 META 0; +#X text 12 105 LIBRARY internal; +#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 125 AUTHOR Miller Puckette; +#X text 12 185 HELP_PATCH_AUTHORS Updated for Pd version 0.40. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 5 KEYWORDS signal conversion; +#X text 12 65 INLET_0 signal; +#X text 12 85 INLET_1 float; +#X text 12 45 DESCRIPTION envelope follower; +#X text 12 165 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 380 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 434 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 535 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#X obj 78 352 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 389 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 351 signal; +#X obj 513 10 env~; +#X text 98 539 The analysis is "Hanning" (raised cosine) windowed. ; -#X text 141 209 <- set peak-to-peak amplitude here in dB.; -#X text 57 333 <- the output is RMS amplitude which (for a sinusoid) +#X text 98 389 float; +#X floatatom 74 263 0 0 0 0 - - -; +#X obj 74 140 osc~ 400; +#X obj 74 167 *~; +#X floatatom 166 116 3 -99 300 0 - - -, f 3; +#X obj 166 140 dbtorms; +#X text 194 114 <- set peak-to-peak amplitude here in dB.; +#X text 110 264 <- the output is RMS amplitude which (for a sinusoid) is about 3 dB below peak-to-peak amplitude.; -#X text 359 380 updated for Pd version 0.40.; -#X obj 11 269 env~ 16384 8192; -#X text 160 259 creation arguments:; -#X text 158 277 1 window size in samples (1024 default); -#X text 158 296 2 period in samples per analysis (window/2 default) +#X obj 74 200 env~ 16384 8192; +#N canvas 213 524 428 101 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 obj 9 38 threshold~; +#X text 7 1 [env~] Related Objects; +#X restore 101 597 pd Related_objects; +#X text 11 23 envelope follower; +#X text 168 452 - (optional) the analysis window size in samples (the +default is 1024).; +#X text 80 452 1) float; +#X text 80 479 2) float; +#X text 168 479 - (optional) the period (the number of samples per +analysis-- window/2 by default). This should normally be a multiple +of the DSP block size \, although this isn't enforced.; +#X text 168 389 - the [env~] object takes a signal and outputs its +RMS amplitude in dB (with 1 normalized to 100 dB.) Output is bounded +below by zero.; +#X text 168 351 - the incoming signal; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide ; -#X text 9 102 The analysis is "Hanning" (raised cosine) windowed.; -#X text 9 125 The optional creation arguments are the analysis window -size in samples \, and the period (the number of samples between analyses). -The latter should normally be a multiple of the DSP block size \, although -this isn't enforced.; -#X connect 3 0 4 0; -#X connect 4 0 11 0; -#X connect 5 0 6 0; -#X connect 6 0 4 1; -#X connect 11 0 0 0; -#X connect 11 0 0 0; +#X obj 480 56 pddp/dsp; +#X obj 98 557 pddp/pddplink ../3.audio.examples/C07.envelope.follower.pd +-text doc.3.audio.examples/C07.envelope.follower.pd; +#X obj 98 572 pddp/pddplink ../3.audio.examples/H06.envelope.follower.pd +-text doc.3.audio.examples/H06.envelope.follower.pd; +#X connect 14 0 15 0; +#X connect 15 0 20 0; +#X connect 16 0 17 0; +#X connect 17 0 15 1; +#X connect 20 0 13 0; diff --git a/doc/pddp/exp-help.pd b/pd/doc/5.reference/exp-help.pd similarity index 100% rename from doc/pddp/exp-help.pd rename to pd/doc/5.reference/exp-help.pd diff --git a/doc/pddp/expr-help.pd b/pd/doc/5.reference/expr-help.pd similarity index 100% rename from doc/pddp/expr-help.pd rename to pd/doc/5.reference/expr-help.pd diff --git a/doc/pddp/expr~-help.pd b/pd/doc/5.reference/expr~-help.pd similarity index 100% rename from doc/pddp/expr~-help.pd rename to pd/doc/5.reference/expr~-help.pd diff --git a/doc/pddp/fexpr~-help.pd b/pd/doc/5.reference/fexpr~-help.pd similarity index 100% rename from doc/pddp/fexpr~-help.pd rename to pd/doc/5.reference/fexpr~-help.pd diff --git a/pd/doc/5.reference/fft~-help.pd b/pd/doc/5.reference/fft~-help.pd index e22096202..0db35c408 100644 --- a/pd/doc/5.reference/fft~-help.pd +++ b/pd/doc/5.reference/fft~-help.pd @@ -1,64 +1,111 @@ -#N canvas 22 7 886 436 12; -#X text 85 158 frequency; -#X floatatom 16 173 0 0 0 0 - - -; -#X obj 16 120 * 44100; -#X floatatom 16 94 0 0 0 0 - - -; -#X text 88 92 frequency; -#X text 91 111 in bins; -#X text 85 175 in Hz.; -#X obj 16 229 osc~; -#X obj 36 16 fft~; -#X obj 86 17 ifft~; -#X text 146 15 - forward and inverse complex FFT; -#X obj 36 42 rfft~; -#X obj 86 43 rifft~; -#X text 146 41 - forward and inverse real FFT; -#X obj 16 254 rfft~; -#X obj 16 148 / 64; -#X obj 574 21 loadbang; -#X msg 574 47 \; pd dsp 1; -#X text 636 403 updated for Pd version 0.33; -#X obj 16 322 rifft~; -#X obj 102 310 print~ real; -#X obj 115 285 print~ imaginary; -#X obj 16 352 /~ 64; -#X obj 16 407 print~ resynthesized; -#X msg 30 380 bang; -#X msg 101 248 bang; -#X msg 100 199 0.25; -#X msg 152 199 0; -#X text 195 200 <-- bash phase; -#X text 152 249 <-- print analysis; -#X text 79 380 <-- print resynthesis; -#X text 76 352 <-- renormalize; -#X text 347 294 There is no normalization \, so that an FFT followed +#N canvas 428 35 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 fft~ 3 12 0 18 -204280 +-1 0; +#X obj 0 399 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 468 274 507 361 META 0; +#X text 12 150 LIBRARY internal; +#X text 12 190 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 210 RELEASE_DATE 2009-06-12; +#X text 12 30 LICENSE SIBSD; +#X text 12 170 AUTHOR Miller Puckette; +#X text 12 230 HELP_PATCH_AUTHORS Updated for Pd version 0.33. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 70 INLET_0 signal; +#X text 12 90 INLET_1 signal; +#X text 12 110 OUTLET_0 signal; +#X text 12 130 OUTLET_1 signal; +#X text 12 50 DESCRIPTION Fourier analyses; +#X text 12 5 KEYWORDS signal block_oriented analysis; +#X restore 500 597 pd META; +#X obj 0 460 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 523 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 551 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#X text 98 527 (none); +#N canvas 214 524 428 107 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 7 1 [fft~] Related Objects; +#X obj 22 42 ifft~; +#X obj 68 42 rfft~; +#X obj 114 42 rifft~; +#X obj 163 42 block~; +#X obj 210 42 switch~; +#X restore 101 597 pd Related_objects; +#X obj 78 408 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 469 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 433 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X obj 512 10 fft~; +#X floatatom 15 124 0 0 0 0 - - -; +#X obj 15 75 * 44100; +#X floatatom 15 53 0 0 0 0 - - -; +#X obj 15 180 osc~; +#X obj 15 205 rfft~; +#X obj 15 99 / 64; +#X obj 15 261 rifft~; +#X obj 60 261 print~ real; +#X obj 74 236 print~ imaginary; +#X obj 15 298 /~ 64; +#X obj 15 364 print~ resynthesized; +#X msg 25 337 bang; +#X msg 60 192 bang; +#X msg 36 150 0.25; +#X msg 77 150 0; +#X text 42 125 frequency in Hz.; +#X text 43 52 frequency in bins; +#X text 55 298 <- renormalize; +#X text 61 337 <- print resynthesis; +#X text 98 407 signal; +#X text 98 432 signal; +#X obj 78 496 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X text 98 495 signal; +#X text 98 468 signal; +#X text 11 23 Fourier analyses; +#X text 183 313 There is no normalization \, so that an FFT followed by an IFFT has a gain of N.; -#X text 346 343 See the FFT examples to see how to use these in practice. +#X text 182 352 See the FFT examples to see how to use these in practice. ; -#X text 347 205 The real FFT outputs N/2+1 real parts and N/2-1 imaginary +#X text 184 243 The real FFT outputs N/2+1 real parts and N/2-1 imaginary parts. The other outputs are zero. At DC and at the Nyquist there is no imaginary part \, but the second through Nth output is as a real and imaginary pair \, which can be thought of as the cosine and sin component strengths.; -#X text 346 112 The FFT objects do Fourier analyses and resyntheses +#X text 104 151 <- bash phase; +#X text 92 193 <- print analysis; +#X text 184 118 The FFT objects do Fourier analyses and resyntheses of incoming real or complex signals. Complex signals are handled as pairs of signals (real and imaginary part.) The analysis size is one -block (you can use the block~ or switch~ objects to control block size). +block (you can use the [block~] or [switch~] objects to control block +size).; +#X obj 5 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide ; -#X connect 1 0 7 0; -#X connect 2 0 15 0; -#X connect 3 0 2 0; -#X connect 7 0 14 0; -#X connect 14 0 20 0; -#X connect 14 0 19 0; -#X connect 14 1 21 0; -#X connect 14 1 19 1; -#X connect 15 0 1 0; +#X obj 481 55 pddp/dsp; +#X obj 98 555 pddp/pddplink ../3.audio.examples/I01.Fourier.analysis.pd +-text doc/3.audio.examples/I01.Fourier.analysis.pd; +#X text 98 573 also see examples I02-I10 in doc/3.audio.examples; +#X connect 13 0 16 0; +#X connect 14 0 18 0; +#X connect 15 0 14 0; #X connect 16 0 17 0; +#X connect 17 0 20 0; +#X connect 17 0 19 0; +#X connect 17 1 21 0; +#X connect 17 1 19 1; +#X connect 18 0 13 0; #X connect 19 0 22 0; #X connect 22 0 23 0; #X connect 24 0 23 0; #X connect 25 0 20 0; #X connect 25 0 21 0; -#X connect 26 0 7 1; -#X connect 27 0 7 1; +#X connect 26 0 16 1; +#X connect 27 0 16 1; diff --git a/doc/pddp/fiddle~-help.pd b/pd/doc/5.reference/fiddle~-help.pd similarity index 100% rename from doc/pddp/fiddle~-help.pd rename to pd/doc/5.reference/fiddle~-help.pd diff --git a/pd/doc/5.reference/float-help.pd b/pd/doc/5.reference/float-help.pd index efc5235a5..762e1f798 100644 --- a/pd/doc/5.reference/float-help.pd +++ b/pd/doc/5.reference/float-help.pd @@ -1,18 +1,199 @@ -#N canvas 23 20 429 272 12; -#X msg 30 107 bang; -#X obj 30 183 float 6.5; -#X floatatom 30 209; -#X floatatom 42 129; -#X floatatom 88 153; -#X obj 55 12 float; -#X text 97 11 - STORE A (FLOATING POINT) NUMBER; -#X text 12 36 The float object stores a number \, initialized by its creation argument \, which may be reset using its inlet and output by sending it the "bang" message. Sending a number sets a new value and outputs it.; -#X text 77 103 outputs the value; -#X text 74 130 sets and outputs the value; -#X text 123 155 sets the value; -#X text 108 184 creation argument initializes the value; -#X text 223 242 updated for Pd version 0.3; -#X connect 0 0 1 0; -#X connect 1 0 2 0; -#X connect 3 0 1 0; -#X connect 4 0 1 1; +#N canvas 427 33 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 float 3 12 0 18 +-204280 -1 0; +#X obj 0 339 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 494 296 482 332 META 0; +#X text 12 145 LIBRARY internal; +#X text 12 185 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 45 LICENSE SIBSD; +#X text 12 165 AUTHOR Miller Puckette; +#X text 12 225 HELP_PATCH_AUTHORS Jonathan Wilkes revised the patch +to conform to the PDDP template for Pd version 0.42.; +#X text 12 25 KEYWORDS control storage; +#X text 12 5 ALIAS f; +#X text 12 85 INLET_0 float bang; +#X text 12 105 INLET_1 float; +#X text 12 125 OUTLET_0 float; +#X text 12 65 DESCRIPTION store a number; +#X text 12 205 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 78 144 cnv 10 50 16 empty empty empty 20 12 0 14 -262126 -66577 +0; +#X obj 341 145 cnv 10 23 16 empty empty empty 20 12 0 14 -262126 -66577 +0; +#X floatatom 379 117 5 0 0 0 - - -, f 5; +#X floatatom 340 169 5 0 0 0 - - -, f 5; +#X obj 359 117 bng 15 250 50 0 empty empty empty 20 7 0 12 -4034 -1 +-1; +#X floatatom 80 169 5 0 0 0 - - -, f 5; +#X msg 80 61 bang; +#X msg 320 61 7 3 4; +#X obj 340 144 f; +#X obj 80 144 float 7; +#X obj 0 436 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 473 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 523 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#X obj 78 408 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X obj 78 347 cnv 17 3 55 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 462 12 float; +#X obj 522 12 f; +#X text 501 13 or; +#X msg 119 115 12; +#X msg 152 115 -0.02; +#X msg 94 90 555; +#X msg 340 84 list one 2 3; +#X text 424 83 does not work!; +#X obj 100 543 pddp/pddplink http://crca.ucsd.edu/~msp/Pd_documentation/x2.htm#s3.1 +-text Pd manual 2.3.1: anatomy of a message; +#N canvas 106 185 428 374 float/list 0; +#X msg 51 111 float 1 2 3; +#X msg 71 165 list 1 2 3; +#X text 68 142 A list with multiple elements remains a list.; +#X text 19 37 A float with one element remains a float.; +#X text 75 196 A list with one float element is converted to a float. +; +#X obj 27 286 bng 15 250 50 0 empty empty bang 0 20 1 9 -262144 -1 +-1; +#X obj 76 286 bng 15 250 50 0 empty empty float 0 21 1 9 -262144 -1 +-1; +#X obj 118 286 bng 15 250 50 0 empty empty symbol 0 21 1 9 -262144 +-1 -1; +#X obj 166 286 bng 15 250 50 0 empty empty list 0 21 1 9 -262144 -1 +-1; +#X obj 211 286 bng 15 250 50 0 empty empty UNDEFINED 0 21 1 9 -262144 +-1 -1; +#X obj 26 264 route bang float symbol list; +#X obj 67 327 print FLOAT; +#X msg 26 59 float 3; +#X msg 82 217 list 2; +#X obj 149 327 print LIST; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 7 1 [float] Conversion To/From a List; +#X text 48 81 A float with multiple elements remains a float but is +truncated to one element.; +#X connect 0 0 10 0; +#X connect 1 0 10 0; +#X connect 10 0 5 0; +#X connect 10 1 6 0; +#X connect 10 1 11 0; +#X connect 10 2 7 0; +#X connect 10 3 8 0; +#X connect 10 3 14 0; +#X connect 10 4 9 0; +#X connect 12 0 10 0; +#X connect 13 0 10 0; +#X restore 386 556 pd float/list conversion; +#N canvas 111 59 428 526 More_Info 0; +#X text 19 37 All numbers in Pd are kept in 32-bit floating point and +can represent real numbers between -8 \, 388608 and 8.388.608.00; +#X text 19 233 The following are examples of floating point numbers: +; +#X text 49 253 3; +#X text 50 294 -111.5; +#X text 49 273 0.5; +#X text 20 126 According to Webopedia.com \, "computers are integer +machines and are capable of representing real numbers only by using +complex codes." Hence \, real numbers must be 'approximated' by computers +using the "floating point standard". In such a number \, the decimal +point can "float" meaning that there is no fixed number of digits preceding +or following the decimal. A floating point number is therefore a computer's +approximation of a real number.; +#X text 50 318 10000 to 1e-16; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 7 1 [float] More Info; +#X obj 1 91 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 +0 14 -204280 -1 0; +#X text 7 91 What is a floating point number?; +#X obj 1 411 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 +0 14 -204280 -1 0; +#X text 7 411 An Interesting Side-Note; +#X text 19 443 In the early 1990's \, the Intel 80486 was shipped with +a math coprocessor to help accelerate the process of computing floating +point numbers (which previously required a considerable amount of CPU +power). Math coprocessors have since found there way into nearly every +graphics card and CPU available today.; +#X text 49 343 3e-05 : This example is a computer shorthand for scientific +notation. It means 3*10^-5 (or 10 to the negative 5th power multiplied +by 3).; +#X restore 385 532 pd More_Info; +#X text 115 60 outputs argument; +#X text 123 89 overrides argument; +#X text 133 145 stores value; +#X text 98 346 bang; +#X text 98 366 float; +#X text 98 386 list; +#X text 98 408 float; +#N canvas 212 516 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 7 1 [float] Related Objects; +#X obj 22 36 int; +#X obj 54 36 value; +#X obj 101 36 list; +#X floatatom 142 37 5 0 0 0 - - -, f 5; +#X msg 185 36; +#X restore 101 597 pd Related_objects; +#X text 99 445 float; +#X text 11 20 store a number; +#X obj 78 445 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 168 386 - truncates to the first element \, outputs it \, and +stores it.; +#X text 168 408 - a float received on the right inlet is stored.; +#X text 169 445 - outputs the stored value as a float message.; +#X text 81 490 1) float; +#X text 168 346 - outputs the currently stored value.; +#X text 168 366 - outputs the incoming number and stores it.; +#X text 171 490 - [float] accepts a single number as a creation argument +which sets the value that is stored.; +#X obj 80 226 21; +#X obj 80 206 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 -1 +-1; +#X floatatom 80 248 5 0 0 0 - - -, f 5; +#X text 122 204 As an additional shortcut \, you can leave off the +class name "float" altogether and just use a single number in an object +box to create a [float] object (with the value initialized to that +number).; +#X text 20 225 [float]; +#X text 21 239 object; +#X text 21 210 implicit; +#X obj 441 280 1 2 3; +#X obj 441 260 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 +-1 -1; +#X obj 441 302 print; +#X text 483 264 implicit; +#X text 482 293 object; +#X text 482 279 [list]; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 100 575 pddp/pddplink http://en.wikipedia.org/wiki/Floating_point +; +#X obj 99 527 pddp/pddplink all_about_messages.pd; +#X obj 100 560 pddp/pddplink ../2.control.examples/05.counter.pd -text +doc/2.control.examples/05.counter.pd; +#X text 77 277 (If you add additional arguments after this number you +will create an implicit [list] object.); +#X connect 6 0 12 1; +#X connect 8 0 12 0; +#X connect 10 0 13 0; +#X connect 11 0 12 0; +#X connect 12 0 7 0; +#X connect 13 0 9 0; +#X connect 22 0 13 1; +#X connect 23 0 13 1; +#X connect 24 0 13 0; +#X connect 25 0 12 0; +#X connect 48 0 50 0; +#X connect 49 0 48 0; +#X connect 55 0 57 0; +#X connect 56 0 55 0; diff --git a/pd/doc/5.reference/framp~-help.pd b/pd/doc/5.reference/framp~-help.pd index cbf3f0476..a88b0b069 100644 --- a/pd/doc/5.reference/framp~-help.pd +++ b/pd/doc/5.reference/framp~-help.pd @@ -1,40 +1,86 @@ -#N canvas 22 7 857 377 12; -#X text 85 158 frequency; -#X floatatom 16 173 0 0 0; -#X obj 16 120 * 44100; -#X floatatom 16 94 0 0 0; -#X text 88 92 frequency; -#X text 91 111 in bins; -#X text 85 175 in Hz.; -#X obj 17 238 rfft~; -#X obj 16 148 / 64; -#X obj 653 14 loadbang; -#X msg 653 40 \; pd dsp 1; -#X text 599 339 updated for Pd version 0.33; -#X msg 103 260 bang; -#X text 154 261 <-- print analysis; -#X obj 36 16 framp~; -#X text 119 15 - estimate frequency and amplitude of FFT components +#N canvas 431 32 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 framp~ 3 12 0 18 +-204280 -1 0; +#X obj 0 417 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 474 272 507 362 META 0; +#X text 12 155 LIBRARY internal; +#X text 12 195 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 175 AUTHOR Miller Puckette; +#X text 12 235 HELP_PATCH_AUTHORS Updated for Pd version 0.33. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 75 INLET_0 signal; +#X text 12 95 INLET_1 signal; +#X text 12 115 OUTLET_0 signal; +#X text 12 135 OUTLET_1 signal; +#X text 12 45 DESCRIPTION estimate frequency and amplitude of FFT components ; -#X obj 16 270 framp~; -#X obj 103 322 print~ frequency; -#X obj 118 297 print~ amplitude; -#X obj 16 204 osc~; -#X text 324 98 Framp~ takes as input a rectangular-windowed FFT and +#X text 12 215 RELEASE_DATE 1997; +#X text 12 5 KEYWORDS signal block_oriented; +#X restore 500 597 pd META; +#X obj 0 478 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 539 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 567 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#X text 98 543 (none); +#N canvas 222 513 428 109 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 obj 22 43 fft~; +#X text 8 2 [framp~] Related Objects; +#X restore 101 597 pd Related_objects; +#X obj 78 426 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 486 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 451 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X obj 497 10 framp~; +#X text 147 127 frequency; +#X floatatom 78 142 0 0 0 0 - - -; +#X obj 78 92 * 44100; +#X floatatom 78 67 0 0 0 0 - - -; +#X text 150 65 frequency; +#X text 153 83 in bins; +#X text 147 144 in Hz.; +#X obj 79 193 rfft~; +#X obj 78 117 / 64; +#X msg 165 214 bang; +#X obj 78 220 framp~; +#X obj 165 269 print~ frequency; +#X obj 180 244 print~ amplitude; +#X obj 78 168 osc~; +#X text 201 214 <- print analysis; +#X text 98 425 signal; +#X text 98 450 signal; +#X text 98 485 signal; +#X obj 78 511 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X text 98 510 signal; +#X text 11 23 estimate frequency and amplitude of FFT components; +#X text 75 309 [framp~] takes as input a rectangular-windowed FFT and outputs \, for each FFT channel \, the estimated amplitude and frequency of any component feedinf that channel. A sinusoidal component should appear in four components (or three in the special case of a sinusoid exactly tuned to a bin.) Frequency output is in bins \, i.e. \, units of SR/N.; -#X connect 1 0 19 0; -#X connect 2 0 8 0; -#X connect 3 0 2 0; -#X connect 7 0 16 0; -#X connect 7 1 16 1; -#X connect 8 0 1 0; -#X connect 9 0 10 0; -#X connect 12 0 17 0; -#X connect 12 0 18 0; -#X connect 16 0 17 0; -#X connect 16 1 18 0; -#X connect 19 0 7 0; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 478 56 pddp/dsp; +#X connect 14 0 26 0; +#X connect 15 0 21 0; +#X connect 16 0 15 0; +#X connect 20 0 23 0; +#X connect 20 1 23 1; +#X connect 21 0 14 0; +#X connect 22 0 24 0; +#X connect 22 0 25 0; +#X connect 23 0 24 0; +#X connect 23 1 25 0; +#X connect 26 0 20 0; diff --git a/doc/pddp/ftom-help.pd b/pd/doc/5.reference/ftom-help.pd similarity index 100% rename from doc/pddp/ftom-help.pd rename to pd/doc/5.reference/ftom-help.pd diff --git a/doc/pddp/ftom~-help.pd b/pd/doc/5.reference/ftom~-help.pd similarity index 100% rename from doc/pddp/ftom~-help.pd rename to pd/doc/5.reference/ftom~-help.pd diff --git a/pd/doc/5.reference/gatom-help.pd b/pd/doc/5.reference/gatom-help.pd index 7034a3bac..75f1883de 100644 --- a/pd/doc/5.reference/gatom-help.pd +++ b/pd/doc/5.reference/gatom-help.pd @@ -1,11 +1,11 @@ -#N canvas 1 88 555 619 10; +#N canvas 428 36 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 gatom 3 12 0 18 -204280 -1 0; #X obj 0 231 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 -228856 -1 0; -#N canvas 206 417 392 263 META 0; +#N canvas 486 289 494 344 META 0; #X text 12 115 LIBRARY internal; #X text 12 155 WEBSITE http://crca.ucsd.edu/~msp/; #X text 12 35 LICENSE SIBSD; @@ -26,23 +26,23 @@ Wilkes revised the patch to conform to the PDDP template for Pd version #X obj 0 499 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 0 13 -228856 -1 0; #X text 98 474 (none); -#N canvas 153 570 428 109 Related_objects 0; +#N canvas 214 517 428 109 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 47 1 Related Objects; -#X floatatom 9 3 5 0 0 0 - - -; +#X floatatom 9 3 5 0 0 0 - - -, f 5; #X obj 21 42 float; #X obj 61 42 list; #X obj 102 45 nbx 5 14 -1e+37 1e+37 0 0 empty empty empty 0 -8 0 10 -262144 -1 -1 0 256 0; -#X obj 168 42 drawnumber; +#X obj 169 42 drawnumber; #X restore 102 597 pd Related_objects; #X obj 78 240 cnv 17 3 145 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 -162280 0; #X text 98 404 float; #X obj 78 405 cnv 17 3 52 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 -162280 0; -#X floatatom 406 3 5 0 0 0 - - -; +#X floatatom 401 9 5 0 0 0 - - -, f 5; #X floatatom 25 58 0 0 0 0 - - -; #X floatatom 25 96 0 0 0 0 - - -; #X msg 469 76 set 45; @@ -55,8 +55,8 @@ Wilkes revised the patch to conform to the PDDP template for Pd version #N canvas 98 96 430 514 Number_box_properties 0; #X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 14 -204280 -1 0; -#X floatatom 70 102 12 0 0 0 - - -; -#X floatatom 71 223 1 0 0 0 - - -; +#X floatatom 70 102 12 0 0 0 - - -, f 12; +#X floatatom 71 223 1 0 0 0 - - -, f 1; #X text 50 2 Properties for gatom; #X text 20 38 Right click on a number box and choose "Properties" to change the following:; @@ -64,7 +64,7 @@ change the following:; #X text 69 69 - width of the number box (in characters). By default the width is 5 characters.; #X text 148 102 width = 12 characters; -#X floatatom 70 123 2 0 0 0 - - -; +#X floatatom 70 123 2 0 0 0 - - -, f 2; #X text 148 123 width = 2 characters; #X text 69 164 If you select a width of 0 \, the number box will grow as needed to hold the number--BUT BEWARE \, THIS IS EXPENSIVE IN CPU @@ -76,13 +76,13 @@ TIME. In a production patch \, you'll want to set a specific width. ; #X text 88 223 width = 1 character: toggle between 0 and 1; #X text 19 260 limits; -#X floatatom 71 282 5 0 127 0 - - -; +#X floatatom 71 282 5 0 127 0 - - -, f 5; #X text 109 281 numbers between 0 and 127; #X text 69 260 - set lower and upper limits for scrolling the number box; #X text 68 300 This only affects scrolling- you can still send values to the number box that are outside these limits.; -#X floatatom 71 353 5 0 127 1 my_number_box - -; +#X floatatom 71 353 5 0 127 1 my_number_box - -, f 5; #X text 19 331 label; #X text 69 331 - give the number box a visible name; #X text 68 371 Use the radio buttons to reposition the label to the @@ -91,7 +91,7 @@ label will automatically be converted to underscores.; #X text 19 413 messages; #X text 69 413 - nonlocal send and receive; #X floatatom 193 532 5 0 0 2 Number_box_7 gatom-help-rcv gatom-help-snd -; +, f 5; #X obj 276 540 r gatom-help-snd; #X obj 71 516 s gatom-help-rcv; #X msg 71 490 28; @@ -99,24 +99,24 @@ label will automatically be converted to underscores.; and receive names to send messages through the number box. "Number-box-7" below is set to receive messages to "gatom-help-rcv" \, and send messages to "gatom-help-snd"; -#X floatatom 276 563 5 0 0 0 - - -; +#X floatatom 276 563 5 0 0 0 - - -, f 5; #X text 68 583 Notice that you cannot make local connections with wires to "Number_box_7" when using non-local send and receive names. If you want to use both \, see the [nbx] object:; #X obj 71 626 nbx 5 14 -1e+37 1e+37 0 0 empty empty empty 0 -8 0 10 -262144 -1 -1 0 256 0; -#X floatatom 13 3 5 0 0 0 - - -; +#X floatatom 13 3 5 0 0 0 - - -, f 5; #X connect 27 0 31 0; #X connect 29 0 28 0; #X restore 102 571 pd Number_box_properties; #X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide ; -#X symbolatom 25 138 10 0 0 0 - - -; +#X symbolatom 25 138 10 0 0 0 - - -, f 10; #X text 11 23 atom (number box and symbol box); -#X symbolatom 486 3 10 0 0 0 - - -; -#X text 450 3 and; -#X symbolatom 25 174 10 0 0 0 - - -; -#X text 61 48 A number box allows you to display a number or enter +#X symbolatom 481 9 10 0 0 0 - - -, f 10; +#X text 445 9 and; +#X symbolatom 25 174 10 0 0 0 - - -, f 10; +#X text 61 52 A number box allows you to display a number or enter a number using the mouse and keyboard. When a number arrives at the number box's inlet \, it is displayed and sent to the outlet. You can click on a number box and drag upward or downward to change the value @@ -124,11 +124,11 @@ continuously.; #X text 97 134 A symbol box allows you to display a single symbol-atom or enter one using the mouse and keyboard. Unlike a number box you cannot change the value by clicking and dragging.; -#X text 96 172 The symbol box is called "Symbol" in the "Put" menu. +#X text 96 174 The symbol box is called "Symbol" in the "Put" menu. ; #X text 168 239 - sends the current value to the outlet.; #X msg 469 156 set foo; -#X symbolatom 469 180 10 0 0 0 - - -; +#X symbolatom 469 180 10 0 0 0 - - -, f 10; #X text 168 309 - symbol box only: an incoming symbol is displayed and output. (Number box will display and output zero.); #X text 168 259 - number box only: sets the current value and outputs @@ -145,10 +145,10 @@ it receives (except set).; message it receives (except set).; #X text 100 537 Control-clicking (or command-clicking on a mac) toggles the value between 0 and the last nonzero value.; -#X floatatom 59 545 5 0 0 0 - - -; +#X floatatom 59 545 5 0 0 0 - - -, f 5; #X text 100 503 You can shift-click a number box and drag to change the number by hundredths instead of ones.; -#X text 60 113 The number box is called "Number" in the "Put" menu. +#X text 61 118 The number box is called "Number" in the "Put" menu. ; #X text 67 197 To enter data simply click a number box or symbol box and begin typing. Then click "Enter" to finish and output it.; diff --git a/pd/doc/5.reference/get-help.pd b/pd/doc/5.reference/get-help.pd index 3b2f235a8..7a675ecff 100644 --- a/pd/doc/5.reference/get-help.pd +++ b/pd/doc/5.reference/get-help.pd @@ -1,51 +1,122 @@ -#N struct help-get-template1 float x float y symbol s; -#N canvas 489 102 633 413 12; -#X text 22 324 see also:; -#X obj 93 344 set; -#X obj 125 344 append; -#X obj 184 344 getsize; -#X obj 252 344 setsize; -#X obj 320 344 element; -#X obj 25 369 sublist; -#X msg 60 130 next; -#N canvas 292 338 631 204 help-get-template1 0; -#X obj 41 87 filledpolygon 9 0 1 0 0 20 0 20 30 0 30; -#X obj 60 21 struct help-get-template1 float x float y symbol s; -#X restore 376 234 pd help-get-template1; -#N canvas 0 0 276 156 help-get-data 1; -#X scalar help-get-template1 46 23 dog \;; -#X scalar help-get-template1 106 73 cat \;; -#X restore 376 212 pd help-get-data; -#X obj 21 10 get; -#X text 86 10 -- get values from a scalar; -#X msg 45 102 traverse pd-help-get-data \, next; -#X floatatom 45 211 5 0 0 0 - - -; -#X floatatom 168 211 5 0 0 0 - - -; -#X obj 45 157 pointer; -#X text 337 101 output first scalar in list; -#X text 103 129 output next item; -#X text 24 267 If you have data whose template varies (from a heterogeneous -list \, for example) you can use "pointer" to select according to template -before sending to "get".; -#X text 31 37 "Get" \, when sent a pointer to a scalar \, retrieves -fields from it by name. The fields can be float or symbol. In the future -this will also allow access to sublists of scalars.; -#X text 307 167 First argument selects template.; -#X text 308 182 Remaining args are names of fields.; -#X text 41 227 x output; -#X text 166 228 y output; -#X obj 25 344 pointer; -#X obj 93 369 struct; -#X text 377 377 updated for Pd version 0.39; -#X obj 45 185 get help-get-template1 x y s; -#X text 252 229 s output; -#X symbolatom 256 211 6 0 0 0 - - -; -#X obj 118 158 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +#N struct get-help-template float x float y symbol s; +#N canvas 430 33 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 get 3 12 0 18 -204280 +-1 0; +#X obj 0 338 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 482 279 494 344 META 0; +#X text 12 105 LIBRARY internal; +#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 125 AUTHOR Miller Puckette; +#X text 12 185 HELP_PATCH_AUTHORS Updated for Pd version 0.39. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 5 KEYWORDS control data_structure; +#X text 12 45 DESCRIPTION get values from a scalar; +#X text 12 65 INLET_0 pointer; +#X text 12 85 OUTLET_N float symbol; +#X text 12 165 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 375 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 438 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 506 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 216 515 428 109 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 obj 72 34 set; +#X obj 104 34 append; +#X obj 163 34 getsize; +#X obj 14 59 setsize; +#X obj 72 59 element; +#X obj 184 59 sublist; +#X obj 14 34 pointer; +#X obj 132 59 struct; +#X text 7 1 [get] Related Objects; +#X restore 102 597 pd Related_objects; +#X obj 78 347 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 383 float; +#X obj 78 384 cnv 17 3 48 empty \$0-pddp.cnv.let.n n 5 9 0 16 -228856 +-162280 0; +#X obj 518 11 get; +#X msg 121 139 next; +#X floatatom 106 234 5 0 0 0 - - -, f 5; +#X floatatom 185 234 5 0 0 0 - - -, f 5; +#X obj 106 162 pointer; +#X text 302 115 output first scalar in list; +#X text 164 138 output next item; +#X text 102 250 x output; +#X text 183 250 y output; +#X text 261 251 s output; +#X symbolatom 265 234 18 0 0 0 - - -, f 18; +#X obj 145 186 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 -1; -#X connect 7 0 15 0; +#X text 98 346 pointer; +#X text 168 346 - [get] takes a pointer to a scalar.; +#X text 98 398 symbol; +#X text 166 183 bang when there are no more items; +#X text 11 23 get values from a scalar; +#X text 221 283 <- Click here to see the data; +#N canvas 111 75 428 272 get-help-data 0; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 7 1 [get] Data Window; +#X scalar get-help-template 22 43 guten_tag \;; +#X scalar get-help-template 79 87 jo_napot_kivanok \;; +#X text 62 42 Each blue rectangle is a scalar. Their appearance and +data structure are defined by the template "get-help-template".; +#X text 27 187 In addition to using the [get] object \, you can right-click +on a rectangle and choose "Properties" to view the field values of +the scalar. (You can also change them-- once you are finished \, click +"Ok" to update the values.); +#X text 27 124 The "x" and "y" fields in a [struct] are special: they +always specify the screen coordinates for the top left corner of each +rectangle. In editmode you can click and drag each rectangle to change +these values.; +#X restore 106 283 pd get-help-data; +#X msg 106 116 traverse pd-get-help-data \, next; +#X obj 106 208 get get-help-template x y s; +#N canvas 105 219 428 175 get-help-template 0; +#X obj 23 118 filledpolygon 9 0 1 0 0 20 0 20 30 0 30; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 7 1 [get] Template subpatch; +#X text 19 69 This [struct] just defines a simple data structure. The +values for the fields were set when this help patch was created.; +#X obj 21 42 struct get-help-template float x float y symbol s; +#X text 21 137 Draw a blue rectangle with a black border.; +#X restore 106 305 pd get-help-template; +#X text 168 383 - one outlet is created for each field specified in +the creation arguments. When [get] receives a pointer at its inlet +\, the value of each field is output to the corresponding outlet.; +#X text 168 472 - the name of a field or fields in that template. An +outlet is created for each field specified.; +#X text 103 56 [get] \, when sent a pointer to a scalar \, retrieves +fields from it by name. The fields can be a float or symbol. (In the +future this will also allow access to sublists of scalars.); +#X text 168 457 - a struct name to specify the template of a scalar. +; +#X text 97 510 If you have data whose templates vary (from a heterogeneous +list \, for example) you can use [pointer] to select according to template +before sending to [get]. (See pointer-help.pd for more information.) +; +#X text 80 457 1) symbol atom; +#X text 80 472 n) symbol atom; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 97 563 pddp/pddplink ../04.data.structures/02.getting.data.pd +-text doc/04.data.structures/02.getting.data.pd; +#X obj 97 578 pddp/pddplink scalar-help.pd; #X connect 12 0 15 0; -#X connect 15 0 27 0; -#X connect 15 1 30 0; -#X connect 27 0 13 0; -#X connect 27 1 14 0; -#X connect 27 2 29 0; +#X connect 15 0 31 0; +#X connect 15 1 22 0; +#X connect 30 0 15 0; +#X connect 31 0 13 0; +#X connect 31 1 14 0; +#X connect 31 2 21 0; diff --git a/pd/doc/5.reference/getsize-help.pd b/pd/doc/5.reference/getsize-help.pd index 2045c5c55..614bbba2c 100644 --- a/pd/doc/5.reference/getsize-help.pd +++ b/pd/doc/5.reference/getsize-help.pd @@ -1,41 +1,102 @@ #N struct help-getsize-template float x float y array array1 help-getsize-array1-template ; -#N struct help-getsize-array1-template float y; -#N canvas 340 20 659 402 12; -#X text 28 319 see also:; -#N canvas 393 10 495 265 help-getsize-template 0; -#X obj 27 76 plot array1 500 1 10 15 20; -#X obj 27 174 filledpolygon 509 509 0 -10 -10 10 -10 10 10 -10 10; -#X obj 24 16 struct help-getsize-template float x float y array array1 +#N struct help-getsize-array1-template float y float x; +#N canvas 426 32 555 619 10; +#X scalar help-getsize-template 89 279 \; 7 -6 \; 7 35 \; 26 57 \; +45 85 \; 74 90 \; 79 137 \; 48 150 \; \;; +#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 getsize 3 12 0 18 +-204280 -1 0; +#X obj 0 406 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 478 284 494 344 META 0; +#X text 12 105 LIBRARY internal; +#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 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 5 KEYWORDS control data_structure array; +#X text 12 45 DESCRIPTION get the number of elements in an array; +#X text 12 65 INLET_0 pointer; +#X text 12 85 OUTLET_0 float; +#X text 12 165 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 443 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 485 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 553 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 214 518 428 109 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 obj 71 34 pointer; +#X obj 205 34 setsize; +#X obj 138 34 element; +#X obj 14 34 struct; +#X text 7 1 [getsize] Related Objects; +#X obj 14 70 get; +#X obj 51 70 set; +#X obj 84 70 append; +#X obj 138 70 sublist; +#X restore 102 597 pd Related_objects; +#X obj 78 415 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 451 float; +#X obj 78 452 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 492 11 getsize; +#X obj 78 135 pointer; +#X floatatom 78 190 5 0 0 0 - - -, f 5; +#X obj 78 161 getsize help-getsize-template array1; +#N canvas 83 204 428 227 help-getsize-template 0; +#X obj 21 42 struct help-getsize-template float x float y array array1 help-getsize-array1-template; -#X restore 338 311 pd help-getsize-template; -#N canvas 0 0 305 197 help-getsize-data 1; -#X scalar help-getsize-template 43 37 \; 0 \; 10 \; 0 \; 10 \; 20 \; -10 \; 20 \; 70 \; 10 \; \;; -#X restore 337 290 pd help-getsize-data; -#N canvas 196 292 369 138 help-getsize-array1-template 0; -#X obj 30 71 filledpolygon 0 0 0 -5 0 0 5 5 0 0 -5; -#X obj 32 27 struct help-getsize-array1-template float y; -#X restore 337 334 pd help-getsize-array1-template; -#X obj 102 339 pointer; -#X obj 236 338 setsize; -#X obj 25 166 pointer; -#X msg 25 142 traverse pd-help-getsize-data \, next; -#X floatatom 25 242 5 0 0 0 - - -; -#X text 360 214 arguments: template \, field name; -#X text 76 240 here we just get the value of y.; -#X obj 25 213 getsize help-getsize-template array1; -#X text 34 192 inlet for pointer; -#X obj 35 21 getsize; -#X text 98 22 -- get number of elements of an array; -#X text 24 44 When sent a pointer \, "element" looks up a field \, +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 7 1 [getsize] Data Structure; +#X obj 21 138 filledpolygon 11 527 1 -10 0 175 0 175 110 -10 110; +#X obj 21 85 plot array1 770 2 10 15 20; +#X text 18 107 An array plotted with a yellow trace 2 pixels wide. +; +#X text 18 157 A black rectangle for the background.; +#X restore 78 223 pd help-getsize-template; +#N canvas 76 167 428 138 help-getsize-array1-template 0; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 7 1 [getsize] Data Structure; +#X obj 21 42 struct help-getsize-array1-template float y float x; +#X obj 21 69 filledpolygon 999 5 1 -5 0 0 5 5 0 0 -5; +#X text 18 91 This is the template for the elements of the array "array1" +\, which is defined in [pd help-getsize-template].; +#X restore 78 244 pd help-getsize-array1-template; +#X text 98 414 pointer; +#X text 11 23 get the number of elements in an array; +#X text 168 414 - a pointer to a scalar that contains an array.; +#X text 168 451 - the output of [getsize] is the number of elements +in the array. The smallest possible size is one.; +#X text 81 504 1) symbol; +#X text 81 520 2) symbol; +#X text 77 55 When sent a pointer \, [getsize] looks up a field \, which should be an array \, and outputs the number of elements of the -array. The template and field name are specified as creation arguments. +array.; +#X text 168 504 - a struct name to specify the the template of a scalar. +; +#X text 119 190 here we just get the size of the array "array1".; +#X text 168 519 - the name of a field within that template. (The field +must be an array.); +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide ; -#X text 23 110 The smallest possible size is one.; -#X obj 169 339 element; -#X text 397 374 updated for Pd version 0.40; -#X obj 25 339 struct; -#X connect 6 0 11 0; -#X connect 7 0 6 0; -#X connect 11 0 8 0; +#X obj 98 557 pddp/pddplink all_about_arrays.pd; +#X obj 98 572 pddp/pddplink scalar-help.pd; +#X msg 78 109 traverse pd-getsize-help.pd \, next; +#X text 278 303 To the left is a scalar that contains; +#X text 278 333 diamond represents one element. (The; +#X text 278 318 an array of 7 elements. Each white; +#X text 278 348 black background is just a reference.); +#X connect 13 0 15 0; +#X connect 15 0 14 0; +#X connect 31 0 13 0; diff --git a/doc/pddp/glossary.pd b/pd/doc/5.reference/glossary.pd similarity index 100% rename from doc/pddp/glossary.pd rename to pd/doc/5.reference/glossary.pd diff --git a/doc/pddp/glossary.txt b/pd/doc/5.reference/glossary.txt similarity index 100% rename from doc/pddp/glossary.txt rename to pd/doc/5.reference/glossary.txt diff --git a/pd/doc/5.reference/graph-help.pd b/pd/doc/5.reference/graph-help.pd index 1badaee38..05d2f0285 100644 --- a/pd/doc/5.reference/graph-help.pd +++ b/pd/doc/5.reference/graph-help.pd @@ -1,13 +1,59 @@ -#N canvas 28 3 693 300 12; -#X graph graph1 0 -1 99 1 188 290 338 190; -#X array array99 100 float; -#X pop; -#X text 174 19 GRAPHS; -#X text 20 42 A graph in Pd is a rectangular subregion of the window in -which you can store numeric arrays.; -#X text 19 140 You can change the array values by redrawing it in the graph. -See also "11.arrays" and passim in the "control examples".; -#X text 406 266 last updated for release 0.33; -#X text 18 85 If you create a new array Pd will usually make a new graph -to put it in (you can change this using the "array" dialog that pops up.) +#N canvas 430 39 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 (graph) 3 12 0 18 +-204280 -1 0; +#X obj 0 453 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 485 291 494 344 META 0; +#X text 12 65 LIBRARY internal; +#X text 12 105 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 85 AUTHOR Miller Puckette; +#X text 12 145 HELP_PATCH_AUTHORS Updated for Pd v0.41. Revised by +Jonathan Wilkes to conform to the PDDP template for Pd version 0.42. ; +#X text 12 5 KEYWORDS signal GUI; +#X text 12 45 DESCRIPTION container canvas for a garray; +#X text 12 125 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 483 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 513 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 566 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 218 526 428 109 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 obj 23 43 table; +#N canvas 0 0 450 300 (subpatch) 0; +#X restore 70 43 pd; +#X text 8 2 (graph) Related Objects; +#X restore 102 598 pd Related_objects; +#X text 80 532 1) symbol atom; +#X text 98 461 (none); +#X text 98 491 (none); +#N canvas 0 0 450 300 (subpatch) 0; +#X coords 0 1 100 -1 40 20 1; +#X restore 496 9 graph; +#N canvas 0 0 450 300 (subpatch) 0; +#X coords 0 1 100 -1 200 140 1; +#X restore 165 188 graph; +#X text 100 56 A graph in Pd is a rectangular subregion of the window +in which you can store numeric arrays.; +#X text 99 133 You can change the array values by redrawing it in the +graph. See also "11.arrays" and passim in the "control examples".; +#X text 99 88 If you create a new array Pd will usually make a new +graph to put it in (you can change this using the "array" dialog that +pops up.); +#X text 99 345 You can put a garray in the graph above by choosing +"Array" from the "Put" menu. Just choose "in last graph" from the dialog +window. For more help on garrays \, see below under the heading "more_info". +; +#X text 167 532 - (optional) the name of the graph. When using the +"Put" menu \, the name is created automatically.; +#X text 11 23 container canvas for a garray; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 98 572 pddp/pddplink array-help.pd -text array-help; diff --git a/pd/doc/5.reference/hdial-help.pd b/pd/doc/5.reference/hdial-help.pd index 006c0f8bd..37b603ddf 100644 --- a/pd/doc/5.reference/hdial-help.pd +++ b/pd/doc/5.reference/hdial-help.pd @@ -1,4 +1,4 @@ -#N canvas 106 314 612 281 10; +#N canvas 433 45 612 281 10; #X obj 1 1 cnv 8 100 60 empty empty hdial=hdl 20 20 1 18 -262144 -1109 0; #X text 16 213 (c) musil@iem.kug.ac.at; @@ -14,15 +14,15 @@ #X obj 44 100 hdl 25 1 1 10 foo8_snd foo8_rcv hdial_0_9 156 -8 192 10 -99865 -262144 -260818 2; #X msg 44 142 \$1; -#X floatatom 44 164 4 0 0; +#X floatatom 44 164 4 0 0 0 - - -, f 4; #X obj 44 186 bng 15 250 50 0 empty empty empty 8 -8 0 10 -262144 -1 -1; #X obj 89 161 tgl 12 0 empty empty empty 8 -8 0 10 -262144 -1 -1 0 1; #X obj 89 140 route 0 1 2 3 4 5 6 7 8 9; #X msg 176 64 set \$1; -#X floatatom 176 43 4 0 9; -#X floatatom 44 54 4 0 9; +#X floatatom 176 43 4 0 9 0 - - -, f 4; +#X floatatom 44 54 4 0 9 0 - - -, f 4; #X msg 91 41 7 0 -5.44; #X msg 95 63 3 3 4.55; #X obj 106 161 tgl 12 0 empty empty empty 8 -8 0 10 -262144 -1 -1 0 @@ -44,31 +44,31 @@ #X obj 242 161 tgl 12 0 empty empty empty 8 -8 0 10 -262144 -1 -1 0 1; #X obj 82 178 print; -#X floatatom 380 198 4 0 0; +#X floatatom 380 198 4 0 0 0 - - -, f 4; #X msg 380 172 \$1; #X msg 355 103 set \$1; -#X floatatom 355 82 4 0 9; +#X floatatom 355 82 4 0 9 0 - - -, f 4; #X text 128 178 UP- \, DOWN- \, LEFT- or RIGHT-key; #X text 127 189 for moving selected gui-objects; #N canvas 226 227 699 530 edit 0; #X obj 42 198 f; #X msg 20 177 bang; -#X floatatom 58 176 3 63 156; -#X floatatom 93 198 3 -20 37; +#X floatatom 58 176 3 63 156 0 - - -, f 3; +#X floatatom 93 198 3 -20 37 0 - - -, f 3; #X obj 42 221 pack 0 0; #X text 120 198 y-label; #X text 86 176 x-label; -#X floatatom 270 187 3 8 50; +#X floatatom 270 187 3 8 50 0 - - -, f 3; #X text 297 187 size; #X obj 286 293 f; #X msg 264 272 bang; -#X floatatom 302 271 3 -10 10; -#X floatatom 337 293 3 -10 10; +#X floatatom 302 271 3 -10 10 0 - - -, f 3; +#X floatatom 337 293 3 -10 10 0 - - -, f 3; #X obj 286 316 pack 0 0; #X obj 300 412 f; #X msg 278 391 bang; -#X floatatom 316 390 3 20 60; -#X floatatom 351 412 3 100 200; +#X floatatom 316 390 3 20 60 0 - - -, f 3; +#X floatatom 351 412 3 100 200 0 - - -, f 3; #X obj 300 435 pack 0 0; #X text 330 271 x-delta; #X text 364 293 y-delta; @@ -76,14 +76,14 @@ #X text 378 412 y-position; #X obj 62 313 f; #X msg 40 292 bang; -#X floatatom 78 291 3 0 2; -#X floatatom 113 313 3 4 36; +#X floatatom 78 291 3 0 2 0 - - -, f 3; +#X floatatom 113 313 3 4 36 0 - - -, f 3; #X obj 62 336 pack 0 0; #X text 106 291 font; #X text 142 313 height; #X text 504 293 no init; #X text 475 348 init value on loadbang; -#X floatatom 482 228 5 2 20; +#X floatatom 482 228 5 2 20 0 - - -, f 5; #X msg 47 125 \; foo8_rcv color \$1 \$2 \$3; #X msg 42 246 \; foo8_rcv label_pos \$1 \$2; #X msg 62 361 \; foo8_rcv label_font \$1 \$2; @@ -105,9 +105,9 @@ #X obj 47 104 pack 0 0 0; #X obj 47 76 f; #X msg 24 28 bang; -#X floatatom 63 26 3 0 29; -#X floatatom 79 46 3 0 29; -#X floatatom 112 62 3 0 29; +#X floatatom 63 26 3 0 29 0 - - -, f 3; +#X floatatom 79 46 3 0 29 0 - - -, f 3; +#X floatatom 112 62 3 0 29 0 - - -, f 3; #X text 91 26 background; #X text 106 46 front-color; #X text 140 63 label-color; @@ -200,9 +200,9 @@ #X connect 36 2 29 0; #X connect 36 3 35 0; #X restore 285 86 pd RGB_____________; -#X floatatom 327 55 3 0 255; -#X floatatom 370 55 3 0 255; -#X floatatom 413 56 3 0 255; +#X floatatom 327 55 3 0 255 0 - - -, f 3; +#X floatatom 370 55 3 0 255 0 - - -, f 3; +#X floatatom 413 56 3 0 255 0 - - -, f 3; #X text 34 0 preset-colors; #X text 296 -3 RGB-colors; #X text 327 37 red; @@ -254,6 +254,7 @@ #X text 183 11 gui-hdial:; #X text 33 238 graz \, austria 2002; #X text 251 232 updated for Pd version 0.35; +#X text 279 254 KEYWORDS deprecated; #X connect 6 0 9 0; #X connect 8 0 5 0; #X connect 8 0 31 0; diff --git a/doc/pddp/hilbert~-help.pd b/pd/doc/5.reference/hilbert~-help.pd similarity index 100% rename from doc/pddp/hilbert~-help.pd rename to pd/doc/5.reference/hilbert~-help.pd diff --git a/pd/doc/5.reference/hip~-help.pd b/pd/doc/5.reference/hip~-help.pd index ea0923f7d..2fa253786 100644 --- a/pd/doc/5.reference/hip~-help.pd +++ b/pd/doc/5.reference/hip~-help.pd @@ -1,33 +1,95 @@ -#N canvas 21 5 694 319 12; -#X obj 70 233 env~; -#X floatatom 70 256 0 0 0 0 - - -; -#X floatatom 119 178 0 0 0 0 - - -; -#X obj 70 206 hip~ 5; -#X obj 12 233 env~; -#X floatatom 12 255 0 0 0 0 - - -; -#X text 115 235 env~ gives the amplitude of the signal envelop in dB. -; -#X floatatom 12 107 0 0 0 0 - - -; -#X msg 567 51 \; pd dsp 1; -#X msg 565 10 \; pd dsp 0; -#X text 13 68 The left inlet is the incoming audio signal. The right +#N canvas 425 40 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 hip~ 3 12 0 18 -204280 +-1 0; +#X obj 0 381 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 485 284 494 344 META 0; +#X text 12 125 LIBRARY internal; +#X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 145 AUTHOR Miller Puckette; +#X text 12 205 HELP_PATCH_AUTHORS Updated for Pd version 0.37. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 5 KEYWORDS signal filter; +#X text 12 45 DESCRIPTION one-pole high pass filter; +#X text 12 105 OUTLET_0 signal; +#X text 12 65 INLET_0 signal clear; +#X text 12 85 INLET_1 float; +#X text 12 185 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 488 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 525 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 566 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#X obj 78 390 cnv 17 3 37 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#N canvas 219 468 428 166 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 [hip~] Related Objects; +#X obj 22 43 lop~; +#X obj 69 43 bp~; +#X obj 117 43 vcf~; +#X text 22 81 Raw Filters; +#X obj 73 108 rzero~; +#X obj 195 108 cpole~; +#X obj 24 108 rpole~; +#X obj 122 108 rzero_rev~; +#X obj 244 108 czero~; +#X obj 293 108 czero_rev~; +#X restore 101 597 pd Related_objects; +#X text 98 389 signal; +#X obj 78 497 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 497 signal; +#X obj 510 11 hip~; +#X obj 146 270 env~; +#X floatatom 146 293 0 0 0 0 - - -; +#X floatatom 195 215 0 0 0 0 - - -; +#X obj 146 243 hip~ 5; +#X obj 88 270 env~; +#X floatatom 88 292 0 0 0 0 - - -; +#X floatatom 88 144 0 0 0 0 - - -; +#X text 89 105 The left inlet is the incoming audio signal. The right inlet is the cutoff frequency in Hz.; -#X obj 12 130 osc~ 100; -#X text 57 105 <-- scroll to change input frequency; -#X msg 70 154 clear; -#X text 122 153 <-- reinitialize internal state; -#X text 151 179 <-- set cutoff frequency; -#X obj 83 6 hip~; -#X text 128 5 - one-pole high pass filter; -#X text 435 287 updated for Pd version 0.37; -#X text 12 31 hip~ is a one-pole high pass filter with a specified +#X obj 88 167 osc~ 100; +#X text 133 142 <-- scroll to change input frequency; +#X msg 146 191 clear; +#X text 198 190 <-- reinitialize internal state; +#X text 227 216 <-- set cutoff frequency; +#X text 168 389 - incoming audio signal.; +#X obj 78 432 cnv 17 3 45 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X text 98 431 float; +#X text 98 449 list; +#X text 98 409 clear; +#X text 84 312 Compare the strength of the original signal on the left +with that of the filtered signal on the right.; +#X text 11 23 one-pole high pass filter; +#X text 168 543 - initial rolloff frequency.; +#X text 168 409 - reinitialize internal state.; +#X text 168 431 - cutoff frequency in Hz.; +#X text 168 449 - a list to the right inlet is truncated \, and the +first element is used as the cutoff frequency.; +#X text 88 68 [hip~] is a one-pole high pass filter with a specified rolloff frequency.; -#X text 135 208 Creation argument initializes rolloff frequency.; -#X connect 0 0 1 0; -#X connect 2 0 3 1; -#X connect 3 0 0 0; -#X connect 4 0 5 0; -#X connect 7 0 11 0; -#X connect 11 0 4 0; -#X connect 11 0 3 0; -#X connect 13 0 3 0; +#X text 191 272 [env~] gives the amplitude of the signal envelop in +dB.; +#X text 168 497 - the output is the filtered audio signal.; +#X text 80 543 1) float; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 479 52 pddp/dsp; +#X connect 13 0 14 0; +#X connect 15 0 16 1; +#X connect 16 0 13 0; +#X connect 17 0 18 0; +#X connect 19 0 21 0; +#X connect 21 0 17 0; +#X connect 21 0 16 0; +#X connect 23 0 16 0; diff --git a/doc/pddp/hradio-help.pd b/pd/doc/5.reference/hradio-help.pd similarity index 100% rename from doc/pddp/hradio-help.pd rename to pd/doc/5.reference/hradio-help.pd diff --git a/pd/doc/5.reference/hslider-help.pd b/pd/doc/5.reference/hslider-help.pd index 80bd83a58..6b0fa6cf2 100644 --- a/pd/doc/5.reference/hslider-help.pd +++ b/pd/doc/5.reference/hslider-help.pd @@ -1,25 +1,64 @@ -#N canvas 243 228 551 413 10; -#X obj 1 1 cnv 8 100 60 empty empty hslider=hsl 20 20 1 18 -262144 --1109 0; -#X floatatom 38 127 9 0 0; -#X msg 47 84 set \$1; -#X floatatom 38 41 7 0 0; -#X text 13 355 (c) musil@iem.kug.ac.at; -#X text 55 368 IEM KUG; -#X obj 38 149 bng 15 250 50 0 empty empty empty 8 -8 0 10 -262144 -1 +#N canvas 428 39 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 hslider 3 12 0 18 +-204280 -1 0; +#X obj 0 291 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 482 291 494 344 META 0; +#X text 12 135 LIBRARY internal; +#X text 12 45 LICENSE SIBSD; +#X text 12 155 AUTHOR Thomas Musil; +#X text 12 175 WEBSITE; +#X text 12 215 HELP_PATCH_AUTHORS Jonathan Wilkes revised the patch +to conform to the PDDP template for Pd version 0.42.; +#X text 12 25 KEYWORDS control storage GUI nonlocal; +#X text 12 65 DESCRIPTION horizontal gui-slider; +#X text 12 5 ALIAS hsl; +#X text 12 85 INLET_0 float bang size range log init steady receive +send label label_pos label_font color pos delta; +#X text 12 115 OUTLET_0 float; +#X text 12 195 RELEASE_DATE 2002; +#X restore 500 597 pd META; +#X obj 0 410 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 461 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 546 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#X obj 78 300 cnv 17 3 105 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#N canvas 211 518 428 112 Related_objects 0; +#X obj 19 52 x_all_guis bng tgl vsl hsl hradio vradio vu cnv nbx; +#X text 17 28 All iem-gui objects:; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 7 1 [hslider] Related Objects; +#X restore 100 597 pd Related_objects; +#X obj 78 419 cnv 17 3 35 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 291 175 and receive names. Right-; +#X text 291 190 click and choose; +#X text 290 206 "Properties" to set them \,; +#X text 98 299 float; +#X text 98 340 list; +#X text 98 419 float; +#X text 291 220 or change them with messages (see below); +#X obj 414 45 hsl 128 15 0 127 0 0 empty empty empty -2 -8 0 10 -262144 +-1 -1 0 1; +#X floatatom 135 116 4 0 0 0 - - -, f 4; +#X msg 199 69 set \$1; +#X floatatom 155 48 4 0 0 0 - - -, f 4; +#X obj 135 138 bng 15 250 50 0 empty empty empty 8 -8 0 10 -262144 +-1 -1; +#X obj 135 49 bng 15 250 50 0 empty empty empty 8 -8 0 10 -262144 -1 -1; -#X obj 18 41 bng 15 250 50 0 empty empty empty 8 -8 0 10 -262144 -1 --1; -#X obj 41 107 hsl 101 15 25 75 0 1 foo1_snd foo1_rcv empty 8 -8 192 -10 -225280 -1109 -1 6200 1; -#X text 174 11 gui-horicontal-slider:; -#X floatatom 47 62 7 0 0; -#X floatatom 116 150 9 0 0; -#X obj 110 308 r goo2_snd; -#X obj 145 248 s goo2_rcv; -#X floatatom 105 40 7 0 0; -#X floatatom 145 206 7 0 0; -#X obj 60 170 print; +#X obj 138 94 hsl 101 15 25 75 0 1 foo1_snd foo1_rcv empty 8 -8 0 10 +-225280 -1109 -1 3900 1; +#X floatatom 199 48 4 0 0 0 - - -, f 4; +#X floatatom 292 141 4 0 0 0 - - -, f 4; +#X floatatom 292 48 4 0 0 0 - - -, f 4; +#X obj 179 140 print; #N canvas 276 200 290 224 once 0; #X obj 38 47 t b b f; #X msg 56 85 1; @@ -36,268 +75,365 @@ #X connect 3 0 4 0; #X connect 4 0 6 0; #X connect 5 0 0 0; -#X restore 60 147 pd once; -#X obj 40 265 hsl 73 15 55 3520 1 1 goo2_snd goo2_rcv log.freq. 8 -8 -192 10 -42246 -260818 -90133 1600 1; -#X obj 37 308 ftom; -#X floatatom 37 330 9 0 0; -#X floatatom 64 287 9 0 0; -#X floatatom 110 329 9 0 0; -#X text 175 176 click properties to; -#X floatatom 37 203 8 0 0; -#X obj 37 226 mtof; -#X text 12 184 --------------------; -#X text 163 187 modify geometry \, colors \, etc.; -#X obj 105 82 s foo1_rcv; -#X obj 116 130 r foo1_snd; -#X msg 105 61 set \$1; -#X msg 145 227 set \$1; -#X text 197 120 (0.01 pixels); -#X text 183 99 shift-click & drag; -#X text 189 109 for fine-tuning; -#X text 148 270 UP- \, DOWN- \, LEFT- or RIGHT-key; -#X text 147 281 for moving selected gui-objects; -#N canvas 207 113 716 530 edit 0; -#X obj 32 220 f; -#X msg 10 199 bang; -#X floatatom 48 198 3 63 88; -#X floatatom 83 220 3 0 37; -#X obj 32 243 pack 0 0; -#X text 110 220 y-label; -#X text 76 198 x-label; -#X obj 279 246 f; -#X msg 257 225 bang; -#X floatatom 295 224 3 -10 10; -#X floatatom 330 246 3 -10 10; -#X obj 279 269 pack 0 0; -#X obj 292 358 f; -#X msg 270 337 bang; -#X floatatom 308 336 3 20 60; -#X floatatom 343 358 3 150 200; -#X obj 292 381 pack 0 0; -#X text 323 224 x-delta; -#X text 357 246 y-delta; -#X text 336 336 x-position; -#X text 370 358 y-position; -#X obj 52 335 f; -#X msg 30 314 bang; -#X floatatom 68 313 3 0 2; -#X floatatom 103 335 3 4 36; -#X obj 52 358 pack 0 0; -#X text 96 313 font; -#X text 132 335 height; -#X floatatom 476 188 1 0 1; -#X text 523 401 no init; -#X text 493 453 init value on loadbang; -#X msg 47 154 \; goo2_rcv color \$1 \$2 \$3; -#X msg 32 268 \; goo2_rcv label_pos \$1 \$2; -#X msg 52 383 \; goo2_rcv label_font \$1 \$2; -#X msg 34 427 \; goo2_rcv label blabla; -#X msg 292 406 \; goo2_rcv pos \$1 \$2; -#X msg 279 294 \; goo2_rcv delta \$1 \$2; -#X msg 475 21 \; goo2_rcv send goo2a_snd; -#X msg 475 59 \; goo2_rcv send goo2_snd; -#X msg 476 105 \; goo2_rcv receive goo2a_rcv; -#X msg 476 143 \; goo2a_rcv receive goo2_rcv; -#X msg 502 420 \; goo2_rcv init 0; -#X msg 503 471 \; goo2_rcv init 1; -#X text 520 188 steady; -#X obj 486 291 f; -#X msg 464 270 bang; -#X floatatom 502 269 3 55 440; -#X floatatom 537 291 6 440 3520; -#X obj 486 314 pack 0 0; -#X text 530 269 left-range-bound; -#X text 586 291 right-range-bound; -#X msg 486 339 \; goo2_rcv range \$1 \$2; -#X msg 363 465 \; goo2_rcv log; -#X msg 269 466 \; goo2_rcv lin; -#X text 269 448 linear / logarithmical; -#X obj 275 133 f; -#X msg 250 112 bang; -#X floatatom 291 111 3 15 73; -#X floatatom 326 133 3 8 50; -#X obj 275 156 pack 0 0; -#X text 319 111 width; -#X text 357 134 height; -#X msg 275 181 \; goo2_rcv size \$1 \$2; -#X msg 34 463 \; goo2_rcv label log.freq.; -#X msg 476 212 \; goo2_rcv steady \$1; -#X obj 47 100 pack 0 0 0; -#X obj 47 72 f; -#X msg 24 24 bang; -#X floatatom 63 22 3 0 29; -#X floatatom 79 42 3 0 29; -#X floatatom 112 58 3 0 29; -#X text 91 22 background; -#X text 106 42 front-color; -#X text 140 59 label-color; -#X msg 277 22 back; -#X msg 277 42 front; -#X msg 277 62 label; -#X msg 239 22 bang; -#N canvas 15 207 606 448 RGB_____________ 0; -#X obj 97 56 inlet; -#X obj 262 53 inlet; -#X obj 339 55 inlet; -#X obj 405 56 inlet; -#X obj 97 270 bang; -#X msg 77 295 0; -#X msg 104 295 1; -#X obj 146 268 bang; -#X msg 132 295 0; -#X msg 160 295 1; -#X obj 196 269 bang; -#X msg 187 295 0; -#X msg 214 295 1; -#X obj 265 313 spigot; -#X obj 312 313 spigot; -#X obj 359 313 spigot; -#X obj 249 385 outlet; -#X text 93 33 select; -#X text 267 28 red; -#X text 337 30 green; -#X text 409 30 blue; -#X obj 405 102 t b f; -#X obj 339 160 +; -#X obj 339 185 t b f; -#X obj 339 216 +; -#X obj 296 385 outlet; -#X obj 343 385 outlet; -#X obj 28 180 loadbang; -#X obj 97 135 route back front label bang; -#X obj 343 362 f; -#X obj 296 361 f; -#X obj 249 361 f; -#X obj 262 79 * -65536; -#X obj 339 80 * -256; -#X obj 405 80 * -1; -#X obj 339 247 - 1; -#X obj 235 168 t b b b b; -#X connect 0 0 28 0; -#X connect 1 0 32 0; -#X connect 2 0 33 0; -#X connect 3 0 34 0; -#X connect 4 0 5 0; -#X connect 4 0 6 0; -#X connect 5 0 14 1; -#X connect 5 0 15 1; -#X connect 6 0 13 1; -#X connect 7 0 8 0; -#X connect 7 0 9 0; -#X connect 8 0 13 1; -#X connect 8 0 15 1; -#X connect 9 0 14 1; +#X restore 179 116 pd once; +#X obj 59 177 hsl 73 15 55 3520 1 1 goo2_snd goo2_rcv log.freq. 8 7 +0 10 -204800 -260818 -90133 1618 1; +#X obj 56 203 ftom; +#X floatatom 56 227 4 0 0 0 - - -, f 4; +#X floatatom 143 215 9 0 0 0 - - -, f 9; +#X floatatom 56 132 4 0 0 0 - - -, f 4; +#X obj 56 153 mtof; +#X obj 292 92 s foo1_rcv; +#X obj 292 117 r foo1_snd; +#X msg 292 68 set \$1; +#X text 139 193 (0.01 pixels); +#X text 142 163 shift-click & drag; +#X text 142 178 for fine-tuning; +#X text 54 248 Use the UP- \, DOWN- \, LEFT- or RIGHT-key to move a +selected gui-object. Right-click and choose "Properties" to modify +its appearance.; +#X text 290 159 hslider has settable send; +#X text 98 356 Special messages can be sent to [hslider] to change +its properties:; +#X text 168 419 - when the slider value is changed by clicking \, dragging +\, or sending a float to the inlet \, the new slider value is sent +to the outlet.; +#N canvas 94 219 428 370 hsl-creation-arguments 0; +#X obj 22 289 s pd-hsl-creation-arguments; +#X text 20 37 "hsl" can be called with 18 creation arguments. These +are not "optional" - all parameters must be filled or the gui-bng will +not instantiate correctly.; +#X text 21 225 For example \, click the msg-box to dynamically create +a hsl:; +#X text 20 84 hsl creation arguments: xSize ySize rangeBtm rangeTop +Logarithmic Init sendName receiveName Label labelXOff labelYOff Font# +fontSize bgColor foregroundColor lblColor sliderPosition steadyOnClick +; +#X text 21 142 note: sliderPosition is not the same as the initialization +value. To dynamically instantiate an hsl that initializes with a desired +value \, save an hsl in a patch and view it in a text editor to get +the right value for sliderPosition. Or \, refer to hslider_set in g_hslider.c +for conversion between sliderPosition and slider value.; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 7 1 [hslider] Creation Arguments and Dynamic Patching; +#X msg 22 247 obj 150 335 hsl 75 20 -1 1 0 1 send receive Celaeno 12 +-9 0 12 7 13 21 4400 0; +#X connect 7 0 0 0; +#X restore 170 521 pd hsl-creation-arguments; +#N canvas 66 11 463 602 Setting_slider_properties_through_messages +0; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X floatatom 11 188 1 0 1 0 - #0-soc -, f 1; +#X text 323 34 no init; +#X text 8 169 steady-on-click; +#X text 339 169 label; +#X msg 339 191 label blabla; +#X msg 323 53 init 0; +#X msg 11 221 steady \$1; +#X msg 234 73 lin; +#X msg 244 105 log; +#X text 230 34 linear/; +#X text 230 49 logarithmical; +#X text 332 73 init value; +#X text 333 88 on loadbang; +#X text 231 169 change send name; +#X text 106 169 change receive name; +#X obj 120 244 s z_rcv; +#X msg 108 191 receive z_rcv; +#X msg 347 243 label mySlider; +#X obj 234 134 s hsl_rcv; +#X obj 323 134 s hsl_rcv; +#X obj 11 269 s hsl_rcv; +#X obj 233 269 s hsl_rcv; +#X obj 108 269 s hsl_rcv; +#X msg 120 221 receive hsl_rcv; +#X msg 233 192 send hsl1_snd; +#X msg 242 221 send hsl_snd; +#X obj 339 271 s hsl_rcv; +#N canvas 382 136 161 310 init 0; +#X obj 16 11 loadbang; +#X obj 16 42 f \$0; +#X msg 16 73 \; \$1-xpos 300 \; \$1-ypos 350 \; \$1-xlabel -2 \; \$1-ylabel +-8 \; \$1-soc 1 \; \$1-font-size 10 \; \$1-width 128 \; \$1-height +15 \; \$1-bottom 0 \; \$1-top 127 \; \$1-bg 0 \; \$1-front 12 \; \$1-label +12; +#X connect 0 0 1 0; +#X connect 1 0 2 0; +#X restore 384 415 pd init; +#X msg 333 109 init 1; +#X msg 11 105 size \$1 \$2; +#X text 60 56 1.width; +#X text 60 77 2.height; +#X obj 11 134 s hsl_rcv; +#X obj 123 134 s hsl_rcv; +#X text 172 56 1.bottom; +#X text 172 77 2.top; +#X text 120 34 output-range; +#X msg 123 105 range \$1 \$2; +#X text 136 307 font properties; +#X msg 138 379 label_font \$1 \$2; +#X text 187 329 1.font(0-2); +#X text 187 350 2.height; +#X text 9 308 label position; +#X msg 11 380 label_pos \$1 \$2; +#X text 60 330 1.x-offset; +#X text 60 351 2.y-offset; +#X obj 11 405 s hsl_rcv; +#X obj 138 404 s hsl_rcv; +#X obj 273 325 cnv 15 157 82 empty empty empty 20 12 0 14 -1 -66577 +0; +#X obj 274 326 cnv 15 155 80 empty empty empty 20 12 0 14 -261682 -66577 +0; +#N canvas 366 206 174 259 flash-time 0; +#X obj 68 180 pack; +#X obj 103 149 t b a; +#X obj 68 205 outlet; +#X obj 103 104 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-width empty +0 -8 0 12 -262144 -1 -1 128 256 0; +#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-height empty +0 -8 0 12 -262144 -1 -1 15 256 0; +#X connect 0 0 2 0; +#X connect 1 0 0 0; +#X connect 1 1 0 1; +#X connect 3 0 0 0; +#X connect 4 0 1 0; +#X coords 0 -1 1 1 48 42 2 100 100; +#X restore 11 55 pd flash-time; +#N canvas 366 206 174 259 flash-time 0; +#X obj 68 180 pack; +#X obj 103 149 t b a; +#X obj 68 205 outlet; +#X obj 103 104 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-bottom empty +0 -8 0 12 -262144 -1 -1 0 256 0; +#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-top empty 0 +-8 0 12 -262144 -1 -1 127 256 0; +#X connect 0 0 2 0; +#X connect 1 0 0 0; +#X connect 1 1 0 1; +#X connect 3 0 0 0; +#X connect 4 0 1 0; +#X coords 0 -1 1 1 48 42 2 100 100; +#X restore 123 55 pd flash-time; +#N canvas 366 206 174 259 flash-time 0; +#X obj 68 180 pack; +#X obj 103 149 t b a; +#X obj 68 205 outlet; +#X obj 103 104 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-xlabel empty +0 -8 0 12 -262144 -1 -1 -2 256 0; +#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-ylabel empty +0 -8 0 12 -262144 -1 -1 -8 256 0; +#X connect 0 0 2 0; +#X connect 1 0 0 0; +#X connect 1 1 0 1; +#X connect 3 0 0 0; +#X connect 4 0 1 0; +#X coords 0 -1 1 1 48 42 2 100 100; +#X restore 11 329 pd flash-time; +#N canvas 366 206 174 259 flash-time 0; +#X obj 68 180 pack; +#X obj 103 149 t b a; +#X obj 68 205 outlet; +#X obj 103 104 nbx 3 14 0 2 0 0 \$0-dummy \$0-font empty 0 -8 0 12 +-262144 -1 -1 0 256 0; +#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-font-size empty +0 -8 0 12 -262144 -1 -1 10 256 0; +#X connect 0 0 2 0; +#X connect 1 0 0 0; +#X connect 1 1 0 1; +#X connect 3 0 0 0; +#X connect 4 0 1 0; +#X coords 0 -1 1 1 48 42 2 100 100; +#X restore 138 328 pd flash-time; +#X text 8 448 preset-colors; +#X text 104 448 RGB-colors; +#X msg 11 554 color \$1 \$2 \$3; +#N canvas 364 205 306 317 flash-time 0; +#X obj 69 196 t b a; +#X obj 33 262 outlet; +#X obj 33 237 pack 0 0 0; +#X obj 120 197 t b a; +#X obj 103 104 nbx 3 14 0 29 0 0 \$0-dummy \$0-bg empty 0 -8 0 12 -262144 +-1 -1 0 256 0; +#X obj 103 124 nbx 3 14 0 29 0 0 \$0-dummy \$0-front empty 0 -8 0 12 +-262144 -1 -1 12 256 0; +#X obj 103 144 nbx 3 14 0 29 0 0 \$0-dummy \$0-label empty 0 -8 0 12 +-262144 -1 -1 12 256 0; +#X connect 0 0 2 0; +#X connect 0 1 2 1; +#X connect 2 0 1 0; +#X connect 3 0 2 0; +#X connect 3 1 2 2; +#X connect 4 0 2 0; +#X connect 5 0 0 0; +#X connect 6 0 3 0; +#X coords 0 -1 1 1 48 62 2 100 100; +#X restore 11 469 pd flash-time; +#N canvas 0 0 306 317 flash-time 0; +#X obj 96 521 outlet; +#X obj 162 230 t b f; +#X obj 96 268 +; +#X obj 96 293 t b f; +#X obj 96 324 +; +#X obj 19 208 * -65536; +#X obj 96 208 * -256; +#X obj 162 208 * -1; +#X obj 96 355 - 1; +#X obj 96 385 list prepend 0; +#X obj 96 410 route 0 1 2; +#X obj 96 497 pack 0 0 0; +#X obj 115 456 t b a; +#X obj 168 455 t b a; +#X obj 104 124 vradio 15 1 0 3 empty empty empty 0 -8 0 10 -262144 +-1 -1 0; +#X text 120 120 1.bg; +#X text 120 137 2.front; +#X text 120 153 3.label; +#X obj 103 105 nbx 3 14 0 255 0 0 \$0-dummy \$0-r empty 0 -8 0 10 -262144 +-258113 -1 0 256 0; +#X obj 133 105 nbx 3 14 0 255 0 0 \$0-dummy \$0-g empty 0 -8 0 10 -262144 +-13381 -1 0 256 0; +#X obj 163 105 nbx 3 14 0 255 0 0 \$0-dummy \$0-b empty 0 -8 0 10 -262144 +-4160 -1 0 256 0; +#X connect 1 0 2 0; +#X connect 1 1 2 1; +#X connect 2 0 3 0; +#X connect 3 0 4 0; +#X connect 3 1 4 1; +#X connect 4 0 8 0; +#X connect 5 0 4 0; +#X connect 6 0 2 0; +#X connect 7 0 1 0; +#X connect 8 0 9 0; +#X connect 9 0 10 0; #X connect 10 0 11 0; -#X connect 10 0 12 0; -#X connect 11 0 13 1; -#X connect 11 0 14 1; -#X connect 12 0 15 1; -#X connect 13 0 31 1; -#X connect 14 0 30 1; -#X connect 15 0 29 1; -#X connect 21 0 22 0; -#X connect 21 1 22 1; -#X connect 22 0 23 0; -#X connect 23 0 24 0; -#X connect 23 1 24 1; -#X connect 24 0 35 0; -#X connect 27 0 6 0; -#X connect 28 0 4 0; -#X connect 28 1 7 0; -#X connect 28 2 10 0; -#X connect 28 3 36 0; -#X connect 29 0 26 0; -#X connect 30 0 25 0; -#X connect 31 0 16 0; -#X connect 32 0 24 0; -#X connect 33 0 22 0; -#X connect 34 0 21 0; -#X connect 35 0 15 0; -#X connect 35 0 14 0; -#X connect 35 0 13 0; -#X connect 36 0 31 0; -#X connect 36 1 30 0; -#X connect 36 2 29 0; -#X connect 36 3 35 0; -#X restore 277 82 pd RGB_____________; -#X floatatom 319 52 3 0 255; -#X floatatom 362 52 3 0 255; -#X floatatom 405 53 3 0 255; -#X text 34 -1 preset-colors; -#X text 290 1 RGB-colors; -#X text 319 34 red; -#X text 355 33 green; -#X text 403 33 blue; -#X connect 0 0 4 0; +#X connect 10 1 12 0; +#X connect 10 2 13 0; +#X connect 11 0 0 0; +#X connect 12 0 11 0; +#X connect 12 1 11 1; +#X connect 13 0 11 0; +#X connect 13 1 11 2; +#X connect 14 0 9 1; +#X connect 18 0 5 0; +#X connect 19 0 6 0; +#X connect 20 0 7 0; +#X coords 0 -1 1 1 102 74 2 100 100; +#X restore 108 469 pd flash-time; +#X text 60 471 1.bg; +#X text 60 491 2.front; +#X text 60 512 3.label; +#X text 317 448 delta; +#X text 217 448 position; +#X msg 218 540 pos \$1 \$2; +#X msg 318 540 delta \$1 \$2; +#X obj 318 517 list; +#X obj 318 470 bng 20 250 50 0 empty empty empty 17 7 0 10 -262144 +-1 -1; +#X text 397 469 1.x-delta; +#X text 397 491 2.y-delta; +#N canvas 366 206 174 259 flash-time 0; +#X obj 68 180 pack; +#X obj 103 149 t b a; +#X obj 68 205 outlet; +#X obj 103 104 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-xpos empty 0 +-8 0 12 -262144 -1 -1 300 256 0; +#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-ypos empty 0 +-8 0 12 -262144 -1 -1 350 256 0; +#X connect 0 0 2 0; +#X connect 1 0 0 0; +#X connect 1 1 0 1; +#X connect 3 0 0 0; +#X connect 4 0 1 0; +#X coords 0 -1 1 1 48 42 2 100 100; +#X restore 218 470 pd flash-time; +#N canvas 366 206 174 259 flash-time 0; +#X obj 68 180 pack; +#X obj 103 149 t b a; +#X obj 68 205 outlet; +#X obj 103 104 nbx 3 14 -20 20 0 0 \$0-dummy \$0-xdelta empty 0 -8 +0 12 -262144 -1 -1 0 256 0; +#X obj 103 124 nbx 3 14 -20 20 0 0 \$0-dummy \$0-ydelta empty 0 -8 +0 12 -262144 -1 -1 0 256 0; +#X connect 0 0 2 0; #X connect 1 0 0 0; -#X connect 2 0 0 1; -#X connect 3 0 4 1; -#X connect 4 0 32 0; -#X connect 7 0 11 0; -#X connect 8 0 7 0; -#X connect 9 0 7 1; -#X connect 10 0 11 1; -#X connect 11 0 36 0; -#X connect 12 0 16 0; -#X connect 13 0 12 0; -#X connect 14 0 12 1; -#X connect 15 0 16 1; -#X connect 16 0 35 0; -#X connect 21 0 25 0; -#X connect 22 0 21 0; -#X connect 23 0 21 1; -#X connect 24 0 25 1; -#X connect 25 0 33 0; -#X connect 28 0 64 0; -#X connect 44 0 48 0; -#X connect 45 0 44 0; -#X connect 46 0 44 1; -#X connect 47 0 48 1; -#X connect 48 0 51 0; -#X connect 55 0 59 0; -#X connect 56 0 55 0; -#X connect 57 0 55 1; -#X connect 58 0 59 1; -#X connect 59 0 62 0; -#X connect 65 0 31 0; -#X connect 66 0 65 0; +#X connect 1 1 0 1; +#X connect 3 0 0 0; +#X connect 4 0 1 0; +#X coords 0 -1 1 1 48 42 2 100 100; +#X restore 347 470 pd flash-time; +#X floatatom 329 384 5 0 0 0 - - -, f 5; +#X obj 11 579 s hsl_rcv; +#X obj 318 565 s hsl_rcv; +#X obj 218 565 s hsl_rcv; +#X text 10 35 dimensions; +#X text 7 1 [hslider] Set Properties through Messages; +#X text 266 469 1.x-pos; +#X text 266 491 2.y-pos; +#X obj 289 356 hsl 128 15 0 127 0 0 hsl-snd hsl-rcv mySlider -2 -8 +0 10 -262144 -1 -1 0 1; +#X connect 1 0 7 0; +#X connect 5 0 27 0; +#X connect 6 0 20 0; +#X connect 7 0 21 0; +#X connect 8 0 19 0; +#X connect 9 0 19 0; +#X connect 17 0 23 0; +#X connect 18 0 27 0; +#X connect 24 0 16 0; +#X connect 25 0 22 0; +#X connect 26 0 22 0; +#X connect 29 0 20 0; +#X connect 30 0 33 0; +#X connect 38 0 34 0; +#X connect 40 0 48 0; +#X connect 44 0 47 0; +#X connect 51 0 30 0; +#X connect 52 0 38 0; +#X connect 53 0 44 0; +#X connect 54 0 40 0; +#X connect 57 0 74 0; +#X connect 58 0 57 0; +#X connect 59 0 57 0; +#X connect 65 0 76 0; +#X connect 66 0 75 0; #X connect 67 0 66 0; -#X connect 68 0 66 1; -#X connect 69 0 65 1; -#X connect 70 0 65 2; -#X connect 74 0 78 0; -#X connect 75 0 78 0; -#X connect 76 0 78 0; -#X connect 77 0 78 0; -#X connect 78 0 65 0; -#X connect 78 1 65 1; -#X connect 78 2 65 2; -#X connect 79 0 78 1; -#X connect 80 0 78 2; -#X connect 81 0 78 3; -#X restore 314 245 pd edit; -#X obj 221 61 hsl 128 15 0 127 0 0 ddd ddd empty 20 8 192 8 -262144 --1 -1 10600 1; -#X text 187 379 updated for Pd version 0.35; -#X text 30 380 graz \, austria 2002; -#X obj 168 34 x_all_guis aaa bbb ccc ddd eee fff ggg hhh iii; -#X connect 1 0 6 0; -#X connect 2 0 8 0; -#X connect 3 0 8 0; -#X connect 7 0 8 0; -#X connect 8 0 1 0; -#X connect 8 0 17 0; -#X connect 10 0 2 0; -#X connect 12 0 22 0; -#X connect 14 0 30 0; -#X connect 15 0 31 0; -#X connect 17 0 16 0; +#X connect 68 0 67 0; +#X connect 71 0 65 0; +#X connect 72 0 67 1; +#X connect 81 0 73 0; +#X restore 101 388 pd Setting_slider_properties_through_messages; +#X text 11 21 horizontal gui-slider; +#X text 98 466 18; +#X text 168 466 - creating an [hslider] object without arguments sets +default values for its gui-properties. See the subpatch below to learn +how to dynamically instantiate a [bng] object with custom properties: +; +#X text 215 551 (c) musil@iem.kug.ac.at; +#X text 257 564 IEM KUG; +#X text 232 576 graz \, austria 2002; +#X text 168 299 - a float updates the slider value and is sent to the +outlet.; +#X text 168 340 - a list is truncated to the first element.; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X text 98 323 bang; +#X text 168 323 - output the current slider value.; +#X text 436 8 [hslider] or [hsl]; #X connect 18 0 21 0; -#X connect 18 0 19 0; -#X connect 19 0 20 0; -#X connect 24 0 25 0; -#X connect 25 0 18 0; -#X connect 29 0 11 0; -#X connect 30 0 28 0; -#X connect 31 0 13 0; +#X connect 19 0 23 0; +#X connect 20 0 23 0; +#X connect 22 0 23 0; +#X connect 23 0 18 0; +#X connect 23 0 28 0; +#X connect 24 0 19 0; +#X connect 26 0 37 0; +#X connect 28 0 27 0; +#X connect 29 0 32 0; +#X connect 29 0 30 0; +#X connect 30 0 31 0; +#X connect 33 0 34 0; +#X connect 34 0 29 0; +#X connect 36 0 25 0; +#X connect 37 0 35 0; diff --git a/doc/pddp/import-help.pd b/pd/doc/5.reference/import-help.pd similarity index 100% rename from doc/pddp/import-help.pd rename to pd/doc/5.reference/import-help.pd diff --git a/doc/pddp/initbang-help-ex1-loadbang.pd b/pd/doc/5.reference/initbang-help-ex1-loadbang.pd similarity index 100% rename from doc/pddp/initbang-help-ex1-loadbang.pd rename to pd/doc/5.reference/initbang-help-ex1-loadbang.pd diff --git a/doc/pddp/initbang-help-ex2-initbang.pd b/pd/doc/5.reference/initbang-help-ex2-initbang.pd similarity index 100% rename from doc/pddp/initbang-help-ex2-initbang.pd rename to pd/doc/5.reference/initbang-help-ex2-initbang.pd diff --git a/doc/pddp/initbang-help.pd b/pd/doc/5.reference/initbang-help.pd similarity index 100% rename from doc/pddp/initbang-help.pd rename to pd/doc/5.reference/initbang-help.pd diff --git a/doc/pddp/inlet-help.pd b/pd/doc/5.reference/inlet-help.pd similarity index 100% rename from doc/pddp/inlet-help.pd rename to pd/doc/5.reference/inlet-help.pd diff --git a/doc/pddp/inlet~-help.pd b/pd/doc/5.reference/inlet~-help.pd similarity index 100% rename from doc/pddp/inlet~-help.pd rename to pd/doc/5.reference/inlet~-help.pd diff --git a/pd/doc/5.reference/int-help.pd b/pd/doc/5.reference/int-help.pd index 6b6de2f6e..5478e5d4e 100644 --- a/pd/doc/5.reference/int-help.pd +++ b/pd/doc/5.reference/int-help.pd @@ -1,24 +1,137 @@ -#N canvas 4 30 605 319 12; -#X msg 61 101 bang; -#X floatatom 61 248 0 0 0; -#X floatatom 73 125 0 0 0; -#X floatatom 102 198 0 0 0; -#X text 108 97 outputs the value; -#X text 110 126 sets and outputs the value; -#X text 113 220 creation argument initializes the value; -#X obj 61 222 int 6; -#X msg 73 148 9.6; -#X text 106 148 non-integers get truncated; -#X msg 71 173 -9.6; -#X text 113 173 toward zero; -#X text 136 200 set the value but no output; -#X obj 60 11 int; -#X text 108 12 - STORE AN INTEGER; -#X text 37 33 The int object stores a number \, initialized by its creation argument \, which may be reset using its inlet and output by sending it the "bang" message. The output is truncated to an integer ala Max.; -#X text 315 270 updated for Pd version 0.33; -#X connect 0 0 7 0; -#X connect 2 0 7 0; -#X connect 3 0 7 1; -#X connect 7 0 1 0; -#X connect 8 0 7 0; -#X connect 10 0 7 0; +#N canvas 425 35 555 619 10; +#X obj 0 595 cnv 15 550 21 empty empty empty 20 12 0 14 -228856 -66577 +0; +#X obj 0 0 cnv 15 550 40 empty empty int 3 12 0 18 -204280 -1 0; +#X obj 0 234 cnv 3 550 3 empty empty inlets 8 12 0 13 -228856 -1 0 +; +#N canvas 492 233 482 395 META 0; +#X text 12 145 LIBRARY internal; +#X text 12 185 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 45 LICENSE SIBSD; +#X text 12 165 AUTHOR Miller Puckette; +#X text 12 225 HELP_PATCH_AUTHORS This help patch was updated for Pd +version 0.35 test 24 by Dave Sabine as part of a project called pddp +proposed by Krzysztof Czaja to build comprehensive documentation for +Pd. Jonathan Wilkes revised the patch to conform to the PDDP template +for Pd version 0.42.; +#X text 12 25 KEYWORDS control storage; +#X text 12 65 DESCRIPTION store an integer; +#X text 12 5 ALIAS i; +#X text 12 85 INLET_0 bang float; +#X text 12 105 INLET_1 float; +#X text 12 125 OUTLET_0 float; +#X text 12 205 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 375 cnv 3 550 3 empty empty outlets 8 12 0 13 -228856 -1 0 +; +#X obj 0 412 cnv 3 550 3 empty empty arguments 8 12 0 13 -228856 -1 +0; +#X obj 0 475 cnv 3 550 3 empty empty more_info 8 12 0 13 -228856 -1 +0; +#X obj 78 334 cnv 17 3 30 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X obj 78 243 cnv 17 3 82 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 495 12 or; +#X obj 100 524 pddp/pddplink http://crca.ucsd.edu/~msp/Pd_documentation/x2.htm#s3.1 +-text Pd manual 2.3.1: anatomy of a message; +#N canvas 107 165 428 375 More_Info 0; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 19 36 Integers are "whole" numbers - numbers which do not contain +fractions. The following are examples of whole numbers:; +#X text 20 66 1; +#X text 20 81 -544; +#X text 20 110 10024; +#X text 19 95 420; +#X obj 1 161 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 +0 14 -204280 -1 0; +#X text 7 1 [int] What is an integer; +#X text 7 161 [int] Note; +#X text 21 231 -8 \,; +#X text 39 231 388 \,; +#X text 63 231 608; +#X text 22 248 and:; +#X text 33 267 388 \,; +#X text 57 267 608; +#X text 22 267 8 \,; +#X text 21 290 Hence \, the [int] object takes about as much CPU as +the [float] object \; but is useful when numbers need to be truncated +and/or when patches are being designed to be compatible with Pd and +MAX/MSP.; +#X text 21 206 All numbers in Pd are kept in 32-bit floating point +and can represent real numbers between:; +#X restore 102 545 pd More_Info; +#X text 101 508 all_about_data-types.pd; +#X text 98 242 bang; +#X text 98 262 float; +#X text 98 302 list; +#X text 98 334 float; +#N canvas 212 521 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 obj 64 36 value; +#X obj 111 36 list; +#X floatatom 152 37 5 0 0 0 - - -, f 5; +#X msg 195 36; +#X obj 22 36 float; +#X obj 22 66 symbol; +#X obj 71 66 random; +#X text 7 1 [int] Related Objects; +#X restore 101 597 pd Related_objects; +#X text 99 382 float; +#X obj 468 11 int; +#X obj 516 11 i; +#X msg 115 122 bang; +#X floatatom 105 205 0 0 0 0 - - -; +#X floatatom 105 100 0 0 0 0 - - -; +#X floatatom 144 153 0 0 0 0 - - -; +#X text 153 122 You can force the object to output the stored number. +; +#X text 150 100 You can set and output the value simoultaneously.; +#X text 172 153 You can store the number \, without outputting it. +; +#X text 100 52 Tip: Press and hold SHIFT while click-n-dragging these +number boxes to see how the [int] object truncates the number - drops +decimal places.; +#X obj 105 179 int 6.5; +#X text 100 479 Note: [int] does not 'rounded off' floats. It discards +everything to the right of the decimal point.; +#X obj 78 384 cnv 17 3 17 empty empty 0 5 9 0 16 -228856 -162280 0 +; +#N canvas 108 391 428 173 Building_a_counter 0; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 19 37 The [int] object can be used as a basis for building +simple counter mechanisms in Pd. In the example below \, the [int] +object's stored value is incremented by 1 with each "bang".; +#X msg 164 84 bang; +#X obj 164 113 int; +#X obj 192 113 + 1; +#X floatatom 164 139 5 0 0 0 - - -, f 5; +#X text 7 1 [int] Example: Building a Counter; +#X connect 2 0 3 0; +#X connect 3 0 4 0; +#X connect 3 0 5 0; +#X connect 4 0 3 1; +#X restore 102 567 pd Building_a_counter; +#X text 11 20 store an integer; +#X text 169 430 - initializes the object and stores the number until +the value is reset. The creation argument is optional. If no creation +argument is provided \, the object defaults to zero.; +#X text 169 382 - outputs the stored value as a float message.; +#X text 168 242 - output the currently stored integer.; +#X text 168 262 - [int] will convert an incoming float to an integer-- +all numerals to the right of the decimal place are truncated (dropped). +This value is then sent to the outlet.; +#X text 168 302 - a list is truncated to the first element \, which +is then output and stored.; +#X text 168 334 - a float received at the right inlet is converted +to an integer and stored for later use.; +#X text 81 430 1) float; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X connect 21 0 29 0; +#X connect 23 0 29 0; +#X connect 24 0 29 1; +#X connect 29 0 22 0; diff --git a/doc/pddp/intro-help.pd b/pd/doc/5.reference/intro-help.pd similarity index 100% rename from doc/pddp/intro-help.pd rename to pd/doc/5.reference/intro-help.pd diff --git a/pd/doc/5.reference/key-help.pd b/pd/doc/5.reference/key-help.pd index 1ab0337c4..9e71c6d66 100644 --- a/pd/doc/5.reference/key-help.pd +++ b/pd/doc/5.reference/key-help.pd @@ -1,24 +1,142 @@ -#N canvas 146 45 546 288 12; -#X obj 21 10 key; -#X obj 54 9 keyup; -#X obj 105 9 keyname; -#X text 173 8 -- grab keyboard; -#X obj 38 67 key; -#X floatatom 38 95 3 0 0 0 - - -; -#X floatatom 77 93 3 0 0 0 - - -; -#X obj 77 67 keyup; -#X floatatom 128 93 3 0 0 0 - - -; -#X obj 128 67 keyname; -#X symbolatom 172 94 10 0 0 0 - - -; -#X text 280 262 updated for Pd version 0.32.; -#X text 26 133 Key and keyup report the (system dependent) numbers -of "printing" keys of the keyboard. Keyname gives the symbolic name -of the key \, with a 1 or 0 if it's up or down \, and works with non-printing -keys like shift or "F1".; -#X text 18 200 Caveat -- this only works if Pd actually gets the key +#N canvas 424 37 555 619 10; +#X obj 0 635 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 key 3 12 0 18 -204280 +-1 0; +#X obj 0 257 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 487 278 494 344 META 0; +#X text 12 85 LIBRARY internal; +#X text 12 125 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 105 AUTHOR Miller Puckette; +#X text 12 165 HELP_PATCH_AUTHORS Dave Sabine \, July 11 \, 2003 Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 45 DESCRIPTION get input from the keyboard; +#X text 12 65 OUTLET_0 float; +#X text 12 5 KEYWORDS control user_input; +#X text 12 145 RELEASE_DATE 1997; +#X restore 500 637 pd META; +#X obj 0 285 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 445 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 513 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 222 479 428 145 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 obj 21 42 keyup; +#X obj 61 42 keyname; +#X text 19 72 Externals and other object libraries; +#X text 7 1 [key] Related Objects; +#X obj 18 94 pddp/helplink Gem/gemkeyboard; +#X obj 18 114 pddp/helplink Gem/gemkeyname; +#X restore 102 638 pd Related_objects; +#X text 98 293 float; +#X obj 78 294 cnv 17 3 140 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 517 9 key; +#X text 98 261 (none); +#X text 98 411 Also note that key combinations \, such as SHIFT+7 produce +a different result than SHIFT or 7 alone.; +#X text 168 346 Some keys \, such as SHIFT or the F1-F12 series all +produce a zero \, but we can see by the [bng] that the event is not +ignored completely...but the numeric "ID" of the key is not captured +successfully. (This may produce different results on different systems.) +; +#X text 168 293 - the number received at the outlet represents the +numeric "ID" of a key on the computer's keyboard. This event occurs +when the key is pressed down. Only one event is captured at a time. +; +#X obj 46 113 key; +#X obj 26 150 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X floatatom 46 150 5 0 0 0 - - -, f 5; +#X text 75 113 Type something on the keyboard to send input to Pd; +#X text 23 64 [key] reports the (system dependent) numbers of "printing" +keys of the keyboard.; +#X text 99 517 Caveat - this only works if Pd actually gets the key events which can depend on the stacking order of windows and/or the -pointer location \, depending on the system.; -#X connect 4 0 5 0; -#X connect 7 0 6 0; -#X connect 9 0 8 0; -#X connect 9 1 10 0; +pointer location. This is dependent on the system.; +#N canvas 105 161 428 356 reacting_to_user_input 0; +#X text 19 37 Most \, if not all \, programming environments provide +us with tools to capture 'user initiated' events from the operating +system. Keyboard input \, mouse clicks \, and mouse movements are the +most common events in this 'user event' category.; +#X text 19 103 Pd's [key] \, [keyup] \, and [keyname] are complimented +by the externals such as [gemmouse] and [nimouse] to provide us with +a full range of tools to gleen a user's activities at the computer. +; +#X text 33 240 onKeyUp; +#X text 33 221 onKeyDown; +#X text 33 259 onKeyPress; +#X text 20 290 hmmm...wouldn't it be great if Pd also gave us onChange +\, onBlur \, onFocus \, onClick \, onDblClick \, onDragDrop \, onLoad +\, onMouseDown \, onMouseOver \, onMouseOut \, onMouseMove \, onUnload...? +; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 7 1 [key] Reacing to User Input; +#X text 20 169 It's interesting to note that with these tools \, PD +can mimic some of the functions in other languages - Javascript for +example has:; +#X restore 102 564 pd reacting_to_user_input; +#N canvas 105 31 345 511 some_keyboard_fun 0; +#X obj 52 75 loadbang; +#X msg 23 16 bang; +#X obj 33 158 qlist; +#X floatatom 33 185 5 0 0 0 - - -, f 5; +#X obj 228 30 r keyboard_fun; +#X msg 52 105 read keyboard_fun.txt; +#X msg 45 51 rewind; +#X obj 228 112 symbol add2; +#X obj 228 83 t b s; +#X obj 228 138 pack s s; +#X obj 228 164 route list; +#X msg 47 245 set; +#X msg 47 278; +#X obj 228 57 symbol; +#X text 71 17 Click here to start...; +#X msg 62 131 tempo 0.8; +#X obj 47 217 loadbang; +#X connect 0 0 5 0; +#X connect 0 0 15 0; +#X connect 1 0 2 0; +#X connect 2 0 3 0; +#X connect 4 0 13 0; +#X connect 5 0 2 0; +#X connect 6 0 2 0; +#X connect 7 0 9 0; +#X connect 8 0 7 0; +#X connect 8 1 9 1; +#X connect 9 0 10 0; +#X connect 10 0 12 0; +#X connect 11 0 12 0; +#X connect 13 0 8 0; +#X connect 15 0 2 0; +#X connect 16 0 11 0; +#X restore 102 588 pd some_keyboard_fun; +#X obj 245 611 pddp/pddplink all_about_hid.pd -text all_about_hid; +#X text 100 612 for more on HIDs:; +#X text 11 23 get input from the keyboard; +#X text 168 261 - [key] gets input directly from the keyboard.; +#X obj 4 637 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 153 190 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X floatatom 173 190 5 0 0 0 - - -, f 5; +#X obj 173 153 key 1; +#X text 210 153 Legacy version which also includesautorepeat can be +invoked by passingan optional argument 1 at creation.Notice how +this version reports multiplepresses when holding a key down.; +#X text 98 449 1) float; +#X text 168 449 - optional argument to enable legacy autorepeat detection. +0 or no argument will disable autorepeat reporting \, 1 will enable +legacy behavior and repeat press-and-hold as multiple pressess in succession. +; +#X connect 15 0 16 0; +#X connect 15 0 17 0; +#X connect 30 0 28 0; +#X connect 30 0 29 0; diff --git a/doc/pddp/keyboard_fun.txt b/pd/doc/5.reference/keyboard_fun.txt similarity index 100% rename from doc/pddp/keyboard_fun.txt rename to pd/doc/5.reference/keyboard_fun.txt diff --git a/doc/pddp/keyname-help.pd b/pd/doc/5.reference/keyname-help.pd similarity index 100% rename from doc/pddp/keyname-help.pd rename to pd/doc/5.reference/keyname-help.pd diff --git a/doc/pddp/keyup-help.pd b/pd/doc/5.reference/keyup-help.pd similarity index 100% rename from doc/pddp/keyup-help.pd rename to pd/doc/5.reference/keyup-help.pd diff --git a/pd/doc/5.reference/line-help.pd b/pd/doc/5.reference/line-help.pd index f5d5ad38f..c3e03d128 100644 --- a/pd/doc/5.reference/line-help.pd +++ b/pd/doc/5.reference/line-help.pd @@ -1,35 +1,252 @@ -#N canvas 31 15 669 403 12; -#X floatatom 22 339 0 0 0 0 - - -; -#X msg 31 205 0 1000; -#X msg 46 227 39; -#X obj 66 15 line; -#X text 106 14 - ramp generator; -#X msg 22 182 1 1000; -#X text 18 36 The line object takes (target \, time) pairs and slews -to the specified target over the time given \, updating its output -at a "grain rate" given by the creation argument. If you dont' specify -a time \, line jumps immediately to the target. Note that the inlet -does not remember old values (unlike every other inlet in Pd) -- sending -a float causes a jump in the output regardless of whatever time value -was specified in some previous message. If the line object receives -a message specifying some new target before reaching the previous one -\, it takes off from its current value.; -#X text 93 194 send a pair to ramp to a new value; -#X text 105 224 send a single number to jump; -#X text 46 363 see also:; -#X obj 132 361 line~; -#X msg 57 252 stop; -#X text 98 251 "stop" message to stop output; -#X obj 22 313 line 0 100; -#X text 383 369 updated for Pd version 0.37; -#X text 125 310 creation arguments:; -#X text 316 310 1 initial value; -#X text 318 330 2 time grain in milliseconds; -#X msg 51 282 set 5; -#X text 99 282 "set" to change value (and stop) without output; -#X connect 1 0 13 0; -#X connect 2 0 13 0; -#X connect 5 0 13 0; -#X connect 11 0 13 0; -#X connect 13 0 0 0; -#X connect 18 0 13 0; +#N canvas 515 143 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 line 3 12 0 18 -204280 +-1 0; +#X obj 0 267 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 565 371 494 364 META 0; +#X text 12 125 LIBRARY internal; +#X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 145 AUTHOR Miller Puckette; +#X text 12 205 HELP_PATCH_AUTHORS This help patch was updated for Pd +version 0.35 test 28 by Dave Sabine as part of a project called pddp +proposed by Krzysztof Czaja to build comprehensive documentation for +Pd. Jonathan Wilkes revised the patch to conform to the PDDP template +for Pd version 0.42.; +#X text 12 45 DESCRIPTION ramp generator; +#X text 12 65 INLET_0 float list stop; +#X text 12 85 INLET_1 float; +#X text 12 105 OUTLET_0 float; +#X text 12 185 RELEASE_DATE 1997; +#X text 12 5 KEYWORDS control time; +#X restore 500 598 pd META; +#X obj 0 375 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 439 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 498 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 297 500 428 230 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 obj 22 43 line~; +#X obj 62 43 vline~; +#X text 8 2 [line] Related Objects; +#X text 19 102 Externals; +#X obj 19 142 pddp/helplink markex/tripleLine; +#X obj 19 162 pddp/helplink iemlib/t3_line~; +#X obj 19 182 pddp/helplink iemlib/fade~; +#X obj 19 122 pddp/helplink maxlib/step; +#X restore 101 598 pd Related_objects; +#X obj 78 276 cnv 17 3 63 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 275 float; +#X text 98 301 list; +#X text 98 383 float; +#X obj 78 384 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 347 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X text 98 346 float; +#X obj 509 10 line; +#X obj 137 180 line; +#X msg 137 87 1000 1000; +#X floatatom 137 201 5 0 0 0 - - -, f 5; +#X text 203 86 ramp up.; +#X msg 146 110 0 1000; +#X text 193 110 ramp down.; +#X msg 158 154 stop; +#X msg 154 133 42; +#X text 180 134 jumps to this value immediately.; +#X text 195 154 stops the current ramp.; +#N canvas 106 115 428 446 continuous_ramps 0; +#X text 19 98 In other words \, if [line] receives a message specifying +some new target and time before reaching the previous target \, it +takes off from its current value.; +#X obj 26 247 hsl 128 15 0 127 0 0 empty empty empty -2 -6 0 8 -262144 +-1 -1 0 1; +#X msg 56 205 stop; +#X msg 49 185 42; +#X obj 23 226 line; +#X msg 23 144 127 5000; +#X msg 41 165 0 5000; +#X text 16 271 Due to this unique behavior \, a common construct found +in Pd patches includes the [pack] object as follows:; +#X obj 30 392 line; +#X floatatom 30 413 10 0 0 0 - - -, f 10; +#X floatatom 30 306 5 0 0 0 - - -, f 5; +#X obj 30 372 pack f 500; +#X msg 41 325 50; +#X msg 49 346 2000; +#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 [line] Continuous Ramps; +#X text 21 37 [line] does not schedule its incoming messages. What +this means is that if you send [line] a new target value mid-way through +a ramp \, a new ramp is immediately created to the new target value +starting from the "current" value.; +#X connect 2 0 4 0; +#X connect 3 0 4 0; +#X connect 4 0 1 0; +#X connect 5 0 4 0; +#X connect 6 0 4 0; +#X connect 8 0 9 0; +#X connect 10 0 11 0; +#X connect 11 0 8 0; +#X connect 12 0 11 0; +#X connect 13 0 11 0; +#X restore 101 551 pd continuous_ramps; +#N canvas 107 25 428 516 grain_rate_and_creation_arguments 0; +#X text 21 39 The "grain rate" of [line] is the rate at which it will +output its values. The faster the grain is \, the smoother the ramp +will appear. While slower grain rates will produce a more disjunct +ramp. Of course this setting will alter the amount of CPU that the +[line] object will require. Higher rates require more computation. +; +#X text 22 145 This means simply that [line] will output a new value +between its current value and your new value once every 20 milliseconds. +; +#X text 22 126 The default grain rate is 20 milliseconds.; +#X text 19 193 [line]'s optional creation arguments can be used to +reset the grain rate. However \, the grain rate cannot be reset dynamically. +; +#X text 21 248 First creation argument is the initial value: the starting +point of the first ramp.; +#X text 20 287 The second creation argument sets the grain rate. Observe +the following two examples to see how the grain rate effects the output. +; +#X obj 33 403 line 0 5; +#X obj 36 436 hsl 128 15 0 127 0 0 empty empty empty -2 -6 0 8 -262144 +-1 -1 0 1; +#X msg 136 332 127; +#X msg 168 340 0; +#X obj 135 368 pack f 5000; +#X obj 203 436 hsl 128 15 0 127 0 0 empty empty empty -2 -6 0 8 -262144 +-1 -1 0 1; +#X obj 200 403 line 0 500; +#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 [line] Grain Rate; +#X text 31 469 You can check the default grain rate in the subpatch +below:; +#N canvas 398 136 429 326 default_grain_rate 0; +#X obj 22 87 line; +#X obj 22 226 timer; +#X obj 22 111 t b b; +#X obj 49 137 spigot; +#X obj 101 169 0; +#X obj 22 193 spigot; +#X obj 22 64 t a b; +#X obj 65 87 1; +#X obj 71 226 1; +#X obj 22 251 print Pd's_default_grain_rate; +#X msg 22 42 0 200; +#X text 19 274 Here we assume the grain rate is less than 200 ms. For +a more comprehensive test we could start with a time value of 1 ms +and step up until the output ceases to increase.; +#X obj 0 0 cnv 15 552 40 empty \$0-pddp.cnv.header empty 3 12 0 14 +-204280 -1 0; +#X text 7 1 [line] Pd's Default Grain Rate; +#X text 60 42 Click here to output pd's default grain rate to the console +; +#X connect 0 0 2 0; +#X connect 1 0 9 0; +#X connect 2 0 5 0; +#X connect 2 1 3 0; +#X connect 3 0 4 0; +#X connect 3 0 1 1; +#X connect 4 0 3 1; +#X connect 4 0 5 1; +#X connect 5 0 1 0; +#X connect 5 0 8 0; +#X connect 6 0 0 0; +#X connect 6 1 7 0; +#X connect 7 0 5 1; +#X connect 8 0 3 1; +#X connect 10 0 6 0; +#X restore 34 491 pd default_grain_rate; +#X connect 6 0 7 0; +#X connect 8 0 10 0; +#X connect 9 0 10 0; +#X connect 10 0 6 0; +#X connect 10 0 12 0; +#X connect 12 0 11 0; +#X restore 101 529 pd grain_rate_and_creation_arguments; +#X text 11 23 ramp generator; +#X text 98 325 stop; +#X text 168 325 - stop the current ramp.; +#X text 167 346 - time to reach the target value (in milliseconds). +; +#X text 168 275 - target value. This value is stored and used as the +starting value for the next ramp.; +#X text 168 301 - a (target \, time) pair is distributed between the +two inlets.; +#X text 168 474 - grain rate in milliseconds (default: 20 ms).; +#X text 168 383 - [line] outputs a linear ramp \, reaching the target +value within the time value specified by the right inlet and at a grain +rate specified by the second creation argument (default 20 ms).; +#N canvas 106 32 428 493 tips_on_using_line 0; +#X text 20 39 [line]'s left inlet defines the "target" value. The right +inlet defines the "time" value. The "target \, time" pair of numbers +inform [line] to produce a numeric "ramp" from its current value (whatever +that might be at any given moment) to the new value within the alloted +time which is defined at the right inlet.; +#X obj 25 242 line; +#X msg 59 218 1000; +#X msg 25 218 1000; +#X obj 25 175 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 25 195 t b b; +#X floatatom 25 264 5 0 0 0 - - -, f 5; +#X obj 150 260 line; +#X msg 150 236 1000; +#X obj 150 216 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X floatatom 150 282 5 0 0 0 - - -, f 5; +#X text 20 309 If [line] receives a new target value without an accompanying +"time" \, it simply jumps to the new value...as in the example above +on the right. In the example above on the left \, you'll see that [line] +will create a numeric ramp from 0 to 1000 over 1000 milliseconds. You +should also note that if you click that [bng] again a second time \, +nothing happens. This is because [line] is already at 1000 \, so sending +it new instructions to ramp to 1000 is meaningless and has no effect. +; +#X text 20 425 Having said all of that \, let's just reiterate that +it's important to send a "time" value to [line] before sending it a +new "target" value...unless of course you WANT it to jump immediately +to the new target.; +#X text 149 182 While this does NOT work unless; +#X text 149 196 you click "500" first.; +#X msg 184 236 500; +#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 [line] Tips; +#X text 20 118 It is important to realize that [line] stores only the +current value...it does not remember the defined "time" (duration of +the ramp). Hence \, the example to the left works:; +#X connect 1 0 6 0; +#X connect 2 0 1 1; +#X connect 3 0 1 0; +#X connect 4 0 5 0; +#X connect 5 0 3 0; +#X connect 5 1 2 0; +#X connect 7 0 10 0; +#X connect 8 0 7 0; +#X connect 9 0 8 0; +#X connect 15 0 7 1; +#X restore 101 507 pd tips_on_using_line; +#X text 80 459 1) float; +#X text 80 474 2) float; +#X text 168 459 - initial value \, i.e. \, the starting point of the +first ramp.; +#X obj 3 598 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 98 571 pddp/pddplink ../3.audio.examples/C03.zipper.noise.pd +-text doc/3.audio.examples/C03.zipper.noise.pd; +#X connect 16 0 18 0; +#X connect 17 0 16 0; +#X connect 20 0 16 0; +#X connect 22 0 16 0; +#X connect 23 0 16 0; diff --git a/pd/doc/5.reference/line~-help.pd b/pd/doc/5.reference/line~-help.pd index c7be247da..57f528462 100644 --- a/pd/doc/5.reference/line~-help.pd +++ b/pd/doc/5.reference/line~-help.pd @@ -1,37 +1,105 @@ -#N canvas 121 54 813 370 12; -#X obj 33 301 snapshot~; -#X obj 21 8 line~; -#X obj 33 226 line~; -#X floatatom 33 324 0 0 0 0 - - -; -#X obj 43 274 metro 100; -#X obj 43 249 r start; -#X msg 550 21 \; pd dsp 1 \; start bang; -#X msg 34 106 1 1000; -#X text 89 105 a pair of numbers starts a ramp; -#X msg 60 176 2; -#X text 91 150 a single number jumps to value; -#X msg 61 200 stop; -#X text 104 199 "stop" message freezes line~ at its current value; -#X msg 60 153 0; -#X msg 43 128 0 5000; -#X text 10 28 The line~ object generates linear ramps whose levels +#N canvas 426 36 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 line~ 3 12 0 18 +-204280 -1 0; +#X obj 0 271 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 481 284 494 344 META 0; +#X text 12 125 LIBRARY internal; +#X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 145 AUTHOR Miller Puckette; +#X text 12 205 HELP_PATCH_AUTHORS Updated for version 0.33. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 5 KEYWORDS signal time conversion; +#X text 12 45 DESCRIPTION audio ramp generator; +#X text 12 85 INLET_1 list; +#X text 12 105 OUTLET_0 signal; +#X text 12 65 INLET_0 float list stop; +#X text 12 185 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 452 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 489 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 516 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#X text 98 493 (none); +#N canvas 213 398 428 230 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 obj 22 43 vline~; +#X obj 82 43 line; +#X text 8 2 [line~] Related Objects; +#X text 20 100 Externals; +#X obj 20 180 pddp/helplink markex/tripleLine; +#X obj 20 120 pddp/helplink iemlib/t3_line~; +#X obj 20 140 pddp/helplink iemlib/fade~; +#X obj 20 160 pddp/helplink maxlib/step; +#X restore 101 597 pd Related_objects; +#X obj 78 280 cnv 17 3 90 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 279 float; +#X text 98 305 list; +#X obj 78 461 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 381 cnv 17 3 65 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X text 98 380 float; +#X obj 509 9 line~; +#X obj 66 210 snapshot~; +#X obj 66 164 line~; +#X floatatom 66 233 0 0 0 0 - - -; +#X obj 108 187 metro 100; +#X msg 66 66 1 1000; +#X text 121 65 a pair of numbers starts a ramp; +#X msg 126 113 2; +#X text 158 113 a single number jumps to value; +#X msg 124 138 stop; +#X text 167 137 "stop" message freezes line~ at its current value; +#X msg 93 113 0; +#X msg 76 88 0 5000; +#X obj 108 164 loadbang; +#X text 98 359 stop; +#X text 98 460 signal; +#X text 167 380 - stores a duration in milliseconds until the next +target value is sent to the left inlet. Unlike most other objects in +Pd \, the value is only stored until it is used with this target value +to start the ramp-- after that point the right inlet is reset (to zero). +; +#X text 11 23 audio ramp generator; +#X text 168 305 - [line~] takes a two-element list to start a new ramp. +The first element specifies the target value \, and the second one +sets the duration in milliseconds. (Lists with more than two elements +will be truncated.); +#X text 168 279 - a float to the left inlet of [line~] will cause the +output to jump immediately to the target value.; +#X text 168 359 - the stop message freezes [line~] at its current value. +; +#X text 168 460 - the outgoing signal is the linear ramp.; +#X text 179 191 The [line~] object generates linear ramps whose levels and timing are determined by messages you send it. The messages may be a single target value (causing the output to jump to the target) -or a target and a time in milliseconds (to start a new ramp.); -#X text 644 36 Click to start; -#X text 639 94 Click to stop; -#X text 185 300 see also:; -#X obj 271 302 line; -#X msg 550 75 \; pd dsp 0 \; start 0; -#X text 75 7 - audio ramp generator; -#X text 576 335 updated for version 0.33; -#X obj 317 302 vline~; -#X connect 0 0 3 0; -#X connect 2 0 0 0; -#X connect 4 0 0 0; -#X connect 5 0 4 0; -#X connect 7 0 2 0; -#X connect 9 0 2 0; -#X connect 11 0 2 0; -#X connect 13 0 2 0; -#X connect 14 0 2 0; +or a target and a time in milliseconds (to start a new ramp).; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 486 51 pddp/dsp; +#X obj 98 547 pddp/pddplink ../3.audio.examples/A03.line.pd/ -text +doc/3.audio.examples/A03.line.pd; +#X obj 98 562 pddp/pddplink ../3.audio.examples/A04.line2.pd/ -text +doc/3.audio.examples/A04.line2.pd; +#X text 98 521 More information about [line] can be found in the Pure +Documentation folder doc/3.audio.examples:; +#X obj 98 577 pddp/pddplink ../3.audio.examples/C05.sampler.oneshot.pd +-text doc/3.audio.examples/C05.sampler.oneshot.pd; +#X connect 16 0 18 0; +#X connect 17 0 16 0; +#X connect 19 0 16 0; +#X connect 20 0 17 0; +#X connect 22 0 17 0; +#X connect 24 0 17 0; +#X connect 26 0 17 0; +#X connect 27 0 17 0; +#X connect 28 0 19 0; diff --git a/pd/doc/5.reference/list-help.pd b/pd/doc/5.reference/list-help.pd index 8ab27888c..160df0eb1 100644 --- a/pd/doc/5.reference/list-help.pd +++ b/pd/doc/5.reference/list-help.pd @@ -1,18 +1,128 @@ -#N canvas 256 20 629 492 12; -#X obj 29 11 list; -#X text 76 12 - building and using variable-length messages; -#N canvas 92 130 654 658 about-lists 0; -#X obj 50 625 print message; -#X msg 50 438 list x.wav 44100; -#X msg 50 596 read \$1 \$2; -#X msg 50 467 set x.wav 44100; -#X msg 67 567 set \, add2 read \, adddollar 1 \, adddollar 2; -#X msg 50 497 x.wav 44100; -#X obj 67 541 loadbang; -#X text 155 544 reset message as it was; -#X text 207 438 good; -#X text 196 469 bad; -#X text 46 25 Messages in Pd are simewhat artificially divided into +#N canvas 398 77 555 619 10; +#X obj 0 635 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 list 3 12 0 18 -204280 +-1 0; +#X obj 0 144 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 450 328 494 344 META 0; +#X text 12 90 LIBRARY internal; +#X text 12 130 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 50 LICENSE SIBSD; +#X text 12 110 AUTHOR Miller Puckette; +#X text 12 170 HELP_PATCH_AUTHORS Updated for Pd version 0.40. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 70 DESCRIPTION building and using variable-length messages +; +#X text 12 5 NAME list append list prepend list trim list split list +length; +#X text 12 30 KEYWORDS control storage needs_work list_op symbol_op +; +#X text 12 150 RELEASE_DATE 2005; +#X restore 500 638 pd META; +#X obj 0 237 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 288 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 546 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 179 562 428 109 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 7 1 [list] Related Objects; +#X obj 21 42 float; +#X obj 61 42 symbol; +#X obj 112 42 pack; +#X obj 152 42 unpack; +#X restore 102 639 pd Related_objects; +#X obj 78 246 cnv 17 3 17 empty \$0-pddp.cnv.let.n n 5 9 0 16 -228856 +-162280 0; +#X obj 78 153 cnv 17 3 17 empty \$0-pddp.cnv.let.n n 5 9 0 16 -228856 +-162280 0; +#X obj 510 11 list; +#N canvas 1 112 555 502 append 0; +#X obj 0 0 cnv 15 552 40 empty \$0-pddp.cnv.header empty 3 12 0 14 +-204280 -1 0; +#X obj 13 3 list append; +#X text 18 24 append (concatenate) the second list to the first; +#X obj 0 294 cnv 3 520 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#X obj 0 377 cnv 3 520 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 78 386 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 303 cnv 17 3 40 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 353 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X text 98 304 anything; +#X text 98 354 anything; +#X obj 0 421 cnv 3 520 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X text 80 456 n); +#X text 98 471 float; +#X text 80 440 1); +#X text 170 440 - the symbol "append".; +#X text 170 456 - an arbitrary number of additional floats or symbols +may be specified to initialize the list stored at the right inlet. +; +#X obj 158 219 list append 1 2; +#X floatatom 168 165 5 0 0 0 - - -, f 5; +#X msg 158 140 1 2 3; +#X msg 178 190 bang; +#X msg 285 189 bang; +#X obj 158 241 print append; +#X msg 285 163 4 5 6 and 7; +#X msg 285 80 4 5 6; +#X msg 285 139 four 5 6; +#X msg 285 110 list four 5 6; +#X text 178 354 - all input is converted to a list and stored.; +#X text 178 304 - all input is converted to a list. The list stored +at the right inlet is appended to it \, and the resulting list is sent +to the outlet.; +#X text 98 387 list; +#X text 168 387 - the output is always a message with the selector +"list" (see subpatch "list_conversion" for more info).; +#X text 98 440 symbol atom; +#X text 98 456 symbol atom; +#X connect 16 0 21 0; +#X connect 17 0 16 0; +#X connect 18 0 16 0; +#X connect 19 0 16 0; +#X connect 20 0 16 1; +#X connect 22 0 16 1; +#X connect 23 0 16 1; +#X connect 24 0 16 1; +#X connect 25 0 16 1; +#X restore 102 365 pd append; +#N canvas 89 83 428 592 about-lists 0; +#X obj 22 567 print message; +#X msg 22 380 list x.wav 44100; +#X msg 22 538 read \$1 \$2; +#X msg 22 409 set x.wav 44100; +#X msg 39 509 set \, add2 read \, adddollar 1 \, adddollar 2; +#X msg 22 439 x.wav 44100; +#X obj 39 483 loadbang; +#X text 127 486 reset message as it was; +#X text 139 380 good; +#X text 128 411 bad; +#X text 94 439 ugly; +#X msg 223 403 list 44100 x.wav; +#X msg 236 428 44100 x.wav; +#X obj 223 454 print number-first; +#X text 217 375 these two are equivalent:; +#X text 19 266 In the example below \, the top message sets \$1 to +"x.wav" and \$2 to 44100 in the "read" message. The lower message box +outputs the message "read x.wav 44100". The "set" message changes the +content of the message box itself (click on the longer message box +below to repair the damage.) The "ugly" message \, since it is neither +"list" nor "set" \, gets interpreted in an arbitrary (and probably +inappropriate!) way.; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 7 1 [list] About lists in Pd; +#X text 19 37 Messages in Pd are somewhat artificially divided into two classes. First are data-holding messages (bang \, float \, symbol \, list) which are the primary way of communicating between objects. Second is "everything else" (you could call them out-of-band messages @@ -21,238 +131,81 @@ write files \, quit Pd \, etc. These are provided so that complex objects don't need to have 100 separate inlets for every possible functionality. It's not clear whether this was a good design choice \, but it's entrenched. ; -#X text 162 497 ugly; -#X text 48 183 The distinction becomes visible \, and ugly \, when +#X text 19 170 The distinction becomes visible \, and ugly \, when the leading item in a data-holding message is a symbol. In this case \, to disambiguate it from the other sort \, the printed form of the message has a selector \, "list" or "symbol" prepended to it. Underneath -\, there is always a selector in fromt of data messages \, but it is +\, there is always a selector in front of data messages \, but it is implied if the first data item is a number.; -#X msg 411 461 list 44100 x.wav; -#X msg 424 486 44100 x.wav; -#X obj 411 512 print number-first; -#X text 405 433 these two are equivalent:; -#X text 50 294 In the example below \, the top message sets \$1 to -"x.wav" and \$2 to 44100 in the "read" message. The lower message box -outputs the message "read x.wav 44100". The "set" message changes the -content of the message box itself (click on the longer message box -below to repair the damage.) The "ugly" message \, since it is neither -"list" nor "set" \, gets interpreted in an arbitrary (and probably -inappropriate!) way.; #X connect 1 0 2 0; #X connect 2 0 0 0; #X connect 3 0 2 0; #X connect 4 0 2 0; #X connect 5 0 2 0; #X connect 6 0 4 0; -#X connect 13 0 15 0; -#X connect 14 0 15 0; -#X restore 43 324 pd about-lists; -#X text 33 52 There are four list classes:; -#X obj 22 82 list append; -#X obj 22 107 list prepend; -#X obj 22 157 list trim; -#X obj 22 132 list split; -#X text 140 81 - append the second list to the first; -#X text 141 108 - prepend the second list to the first; -#X text 141 133 - split a list in two; -#X text 141 160 - trim the "list" selector off; -#N canvas 186 284 602 409 trim 0; -#X msg 159 239 1 2 3; -#X msg 159 190 list cis boom bah; -#X msg 160 265 bang; -#X msg 159 163 walk the dog; -#X obj 134 341 list trim; -#X obj 134 363 print trim; -#X msg 160 287 1 x y; -#X msg 159 313 x 1 y; -#X text 29 19 trim - convert list to message \, using first item as -selector; -#X msg 159 213 55; -#X text 27 55 The "list trim" object inputs lists (or makes lists out -of incoming non-list messages) and outputs a message whose selector -is the first item of the list \, and whose arguments \, if any \, are -the remainder of the list. If the list has no items \, or if its first -item is numeric \, the selector is "list" (which might print out as -list \, float \, or bang.); -#X connect 0 0 4 0; -#X connect 1 0 4 0; -#X connect 2 0 4 0; -#X connect 3 0 4 0; -#X connect 4 0 5 0; -#X connect 6 0 4 0; -#X connect 7 0 4 0; -#X connect 9 0 4 0; -#X restore 506 160 pd trim; -#X text 501 53 details:; -#X text 499 36 click for; -#N canvas 100 190 608 420 append 0; -#X obj 17 324 list append 1 2; -#X floatatom 17 154 5 0 0 0 - - -; -#X msg 17 129 1 2 3; -#X msg 17 82 list cis boom bah; -#X msg 17 179 bang; -#X msg 176 294 bang; -#X obj 17 353 print append; -#X msg 17 39 walk the dog; -#X msg 176 244 list x y z; -#X msg 175 218 go dog go; -#X msg 174 268 4 5 6 and 7; -#X text 138 37 non-list message converted to list; -#X text 182 77 list starting with symbol; -#X text 181 96 (needs explicit "list" selector); -#X text 69 152 number is one-element list; -#X text 72 129 numeric list; -#X text 67 181 bang is zero-element list; -#X text 270 215 same for right inlet...; -#X text 286 267 (note: only the first item; -#X text 289 286 need be a number to make this; -#X text 289 304 a list.); -#X text 170 325 <- creation args initialize the list to append; -#X text 20 6 Append - append (concatenate) the second list to the first -; -#X connect 0 0 6 0; -#X connect 1 0 0 0; -#X connect 2 0 0 0; -#X connect 3 0 0 0; -#X connect 4 0 0 0; -#X connect 5 0 0 1; -#X connect 7 0 0 0; -#X connect 8 0 0 1; -#X connect 9 0 0 1; -#X connect 10 0 0 1; -#X restore 506 84 pd append; -#N canvas 391 326 667 561 split 0; -#X msg 103 328 1 2 3; -#X msg 79 231 list cis boom bah; -#X msg 99 263 bang; -#X obj 79 421 list split 2; -#X floatatom 182 396 3 0 5 0 - - -; -#X obj 79 469 print split1; -#X obj 198 470 print split2; -#X msg 79 204 walk the dog; -#X msg 102 306 1 2; -#X msg 100 285 1; -#X msg 103 349 1 2 3 4; -#X msg 103 372 1 2 so are you; -#X obj 320 470 print split3; -#X text 76 488 first n; -#X text 195 489 rest of list; -#X text 317 489 shorter than n; -#X text 218 394 new split point; -#X text 49 25 Split - cut a list into smaller ones; -#X text 210 419 <-- creation arg inits split point; -#X text 201 202 non-list message converted to list; -#X text 245 231 list with three symbols; -#X text 139 288 list with one number; -#X text 177 310 ... etc; -#X text 241 370 <- if the first item is a number \, it's a list.; -#X text 142 262 list with no items; -#X text 48 61 The "list split" object takes lists and outputs the first -"n" items (left outlet) and the remaining ones (middle outlet). The -two outputs appear in the usual right-to-left order. In case there -are fewer than "n" items in the list \, it is output (in its entirety) -from the third outlet instead. The creation argument or the inlet sets -the split point.; -#X connect 0 0 3 0; -#X connect 1 0 3 0; -#X connect 2 0 3 0; -#X connect 3 0 5 0; -#X connect 3 1 6 0; -#X connect 3 2 12 0; -#X connect 4 0 3 1; -#X connect 7 0 3 0; -#X connect 8 0 3 0; -#X connect 9 0 3 0; -#X connect 10 0 3 0; -#X connect 11 0 3 0; -#X restore 506 134 pd split; -#N canvas 0 0 640 478 prepend 0; -#X floatatom 17 154 5 0 0 0 - - -; -#X msg 17 129 1 2 3; -#X msg 17 82 list cis boom bah; -#X msg 17 179 bang; -#X msg 176 294 bang; -#X obj 17 353 print append; -#X msg 17 39 walk the dog; -#X msg 176 244 list x y z; -#X msg 175 218 go dog go; -#X msg 174 268 4 5 6 and 7; -#X text 138 37 non-list message converted to list; -#X text 182 77 list starting with symbol; -#X text 181 96 (needs explicit "list" selector); -#X text 69 152 number is one-element list; -#X text 72 129 numeric list; -#X text 67 181 bang is zero-element list; -#X text 270 215 same for right inlet...; -#X text 286 267 (note: only the first item; -#X text 289 286 need be a number to make this; -#X text 289 304 a list.); -#X text 20 6 Prepend - prepend the second list to the first; -#X text 171 326 <- creation args initialize the list to prepend; -#X obj 17 324 list prepend 1 2; -#X connect 0 0 22 0; -#X connect 1 0 22 0; -#X connect 2 0 22 0; -#X connect 3 0 22 0; -#X connect 4 0 22 1; -#X connect 6 0 22 0; -#X connect 7 0 22 1; -#X connect 8 0 22 1; -#X connect 9 0 22 1; -#X connect 22 0 5 0; -#X restore 506 109 pd prepend; -#X text 30 241 In general \, inlets that take lists (two each for append/prepend -\, and one each for split and trim) will convert non-list messages -(such as "set 5") to lists (such as "list set 5" automatically. Here's -more about lists in Pd:; -#X text 31 357 And here are some examples showing how to use these -objects to compose and/or use variable length messages:; -#N canvas 381 50 719 646 example1 0; -#X obj 43 173 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +#X connect 11 0 13 0; +#X connect 12 0 13 0; +#X restore 101 586 pd about-lists; +#X text 11 23 building and using variable-length messages; +#X text 80 307 1); +#X text 80 514 n); +#X text 180 365 append - append the second list to the first; +#X text 180 409 split - split a list in two; +#X text 180 387 prepend - prepend the second list to the first; +#X text 180 453 length - output the number of items in a list; +#X text 180 431 trim - trim the "list" selector off; +#X obj 212 98 list; +#X msg 233 68 rice; +#X msg 212 46 beans; +#X obj 212 120 print groceries; +#X msg 276 68 cornbread; +#X text 98 550 Here are some examples showing how to use these objects +to compose and/or use variable length messages:; +#N canvas 20 53 525 646 simple_sequencer 0; +#X obj 23 173 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 -1; -#X obj 252 176 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +#X obj 232 176 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 -1; -#X text 247 154 clear; -#X text 40 153 send; -#X msg 91 175 250; -#X msg 123 175 500; -#X msg 156 175 750; -#X msg 189 175 1000; -#X obj 43 258 list append; -#X obj 208 220 t l; -#X obj 91 214 list prepend; -#X obj 43 426 t l l; -#X obj 94 426 print start; -#X obj 149 257 print stored; -#X obj 43 451 list split 1; -#X obj 43 575 del; -#X obj 43 607 print bang; -#X obj 75 542 list append; -#X msg 55 403 0 250 250 500; -#X text 118 150 -- add --; -#X text 57 20 example 1: simple rhythmic sequencer; -#X text 49 53 The top part of this patch demonstrates building up a +#X text 227 154 clear; +#X text 20 153 send; +#X msg 71 175 250; +#X msg 103 175 500; +#X msg 136 175 750; +#X msg 169 175 1000; +#X obj 23 258 list append; +#X obj 188 220 t l; +#X obj 71 214 list prepend; +#X obj 23 426 t l l; +#X obj 74 426 print start; +#X obj 129 257 print stored; +#X obj 23 451 list split 1; +#X obj 23 575 del; +#X obj 23 607 print bang; +#X obj 55 542 list append; +#X msg 35 403 0 250 250 500; +#X text 98 150 -- add --; +#X text 37 20 example 1: simple rhythmic sequencer; +#X text 29 53 The top part of this patch demonstrates building up a message from a variable number of elements provided sequentially. The "list prepend" object stores the list and \, each time a number arrives \, prepends the previous list to it.; -#X text 416 237 "list prepend" to its own inlet.; -#X text 253 220 "trigger list" is needed only to connect outlet of +#X text 216 237 "list prepend" to its own inlet.; +#X text 213 220 "trigger list" is needed only to connect outlet of ; -#X text 274 258 printout shows the growing message.; -#X text 67 279 "list append" stores the growing message which is output +#X text 254 258 printout shows the growing message.; +#X text 47 279 "list append" stores the growing message which is output by the "send" button above. "list prepend" would have been equivalent. ; -#X text 185 403 <-- test message; -#X text 59 354 The bottom part of the patch takes numbers off the beginning +#X text 165 403 <-- test message; +#X text 39 354 The bottom part of the patch takes numbers off the beginning of the list \, one by one \, to use as delays.; -#X text 210 426 printout shows the sequence as it starts.; -#X text 189 543 The rest of the list is stored for next time.; -#X obj 161 505 print done; -#X text 170 450 Split off the first item. If there is none \, nothing +#X text 190 426 printout shows the sequence as it starts.; +#X text 169 543 The rest of the list is stored for next time.; +#X obj 141 505 print done; +#X text 150 450 Split off the first item. If there is none \, nothing comes out the first or second outlet \, but instead we get a "bang" from the third one.; -#X text 84 575 After delay \, output a bang and recall the rest of +#X text 64 575 After delay \, output a bang and recall the rest of the list.; #X connect 0 0 8 0; #X connect 1 0 10 1; @@ -274,9 +227,8 @@ the list.; #X connect 15 0 17 0; #X connect 17 0 14 0; #X connect 18 0 11 0; -#X restore 222 410 pd example1; -#X text 65 409 simple sequencer; -#N canvas 126 39 568 569 example2 0; +#X restore 401 586 pd simple_sequencer; +#N canvas 127 68 397 569 another_sequencer 0; #X obj 66 263 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 -1; #X obj 292 266 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 @@ -326,10 +278,8 @@ by taking the "pitch" output before the delay object (previously the #X connect 16 0 15 0; #X connect 16 1 11 1; #X connect 16 2 19 0; -#X restore 222 436 pd example2; -#X text 56 438 another sequencer; -#X text 115 465 serializer; -#N canvas 116 31 673 426 example3 0; +#X restore 401 608 pd another_sequencer; +#N canvas 48 176 447 426 serializer 0; #X obj 19 287 list split 1; #X obj 19 378 print; #X obj 19 204 until; @@ -342,11 +292,11 @@ by taking the "pitch" output before the delay object (previously the all the items of a list.; #X text 178 147 <- click to test; #X text 101 171 First store list \, then start the loop; -#X text 118 199 "until" bangs its output until told to stop by a "bang" +#X text 88 199 "until" bangs its output until told to stop by a "bang" to its right inlet.; -#X text 137 241 Store the remaining list.; -#X text 194 286 third outlet of "split" tells us to stop.; -#X text 67 318 Second outlet of "split" becomes the new list for "list +#X text 107 241 Store the remaining list.; +#X text 184 286 third outlet of "split" tells us to stop.; +#X text 37 318 Second outlet of "split" becomes the new list for "list append" above.; #X text 75 377 First outlet is the output.; #X connect 0 0 1 0; @@ -358,31 +308,369 @@ append" above.; #X connect 4 1 3 1; #X connect 5 0 2 1; #X connect 6 0 4 0; -#X restore 222 463 pd example3; -#X obj 23 207 list; -#X text 71 208 - short for "list append"; -#X text 141 185 - output number of items in list; -#N canvas 188 111 576 365 length 0; -#X msg 126 183 1 2 3; -#X msg 126 134 list cis boom bah; -#X msg 127 209 bang; -#X msg 126 107 walk the dog; -#X msg 127 231 1 x y; -#X msg 126 257 x 1 y; -#X msg 126 157 55; -#X obj 101 285 list length; -#X floatatom 101 311 5 0 0 0 - - -; -#X text 29 18 length - number of items in list; -#X text 27 55 The "list length" object outputs the number of arguments -in a list or other message.; -#X connect 0 0 7 0; -#X connect 1 0 7 0; -#X connect 2 0 7 0; -#X connect 3 0 7 0; -#X connect 4 0 7 0; -#X connect 5 0 7 0; -#X connect 6 0 7 0; -#X connect 7 0 8 0; -#X restore 506 186 pd length; -#X text 353 468 updated for Pd version 0.40.; -#X obj 22 182 list length; +#X restore 241 608 pd serializer; +#N canvas 101 244 428 350 lists_vs_non-lists 0; +#X obj 23 290 list append 1 2; +#X floatatom 23 120 5 0 0 0 - - -, f 5; +#X msg 23 95 1 2 3; +#X msg 23 68 list cis boom bah; +#X msg 23 145 bang; +#X msg 162 260 bang; +#X obj 23 319 print append; +#X msg 23 43 walk the dog; +#X msg 162 210 list x y z; +#X msg 161 184 go dog go; +#X msg 160 234 4 5 6 and 7; +#X text 119 43 non-list message converted to list; +#X text 144 68 list starting with symbol; +#X text 75 118 number is one-element list; +#X text 75 95 numeric list; +#X text 75 145 bang is zero-element list; +#X text 226 184 same for right inlet...; +#X text 235 233 (note: only the first item; +#X text 238 252 need be a number to make this; +#X text 238 270 a list.); +#X text 121 290 <- creation args initialize the list to append; +#X obj 2 2 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 8 2 [list] Lists vs. Non-lists; +#X connect 0 0 6 0; +#X connect 1 0 0 0; +#X connect 2 0 0 0; +#X connect 3 0 0 0; +#X connect 4 0 0 0; +#X connect 5 0 0 1; +#X connect 7 0 0 0; +#X connect 8 0 0 1; +#X connect 9 0 0 1; +#X connect 10 0 0 1; +#X restore 101 608 pd lists_vs_non-lists; +#N canvas 0 82 555 506 prepend 0; +#X obj 0 0 cnv 15 552 40 empty \$0-pddp.cnv.header empty 3 12 0 14 +-204280 -1 0; +#X obj 0 299 cnv 3 520 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#X obj 0 377 cnv 3 520 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 78 386 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 308 cnv 17 3 40 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 354 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X text 98 309 anything; +#X text 98 355 anything; +#X obj 0 421 cnv 3 520 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X text 80 456 n); +#X text 98 471 float; +#X text 80 440 1); +#X text 170 456 - an arbitrary number of additional floats or symbols +may be specified to initialize the list stored at the right inlet. +; +#X floatatom 198 160 5 0 0 0 - - -, f 5; +#X msg 188 135 1 2 3; +#X msg 208 185 bang; +#X msg 315 184 bang; +#X msg 315 158 4 5 6 and 7; +#X msg 315 75 4 5 6; +#X msg 315 134 four 5 6; +#X msg 315 105 list four 5 6; +#X text 178 355 - all input is converted to a list and stored.; +#X text 18 24 prepend the second list to the first; +#X obj 13 3 list prepend; +#X obj 188 214 list prepend 1 2; +#X obj 188 236 print prepend; +#X text 178 309 - all input is converted to a list. The list stored +at the right inlet is prepended to it \, and the resulting list is +sent to the outlet.; +#X text 170 440 - the symbol "prepend".; +#X text 98 387 list; +#X text 168 387 - the output is always a message with the selector +"list" (see subpatch "list_conversion" for more info).; +#X text 98 440 symbol atom; +#X text 98 456 symbol atom; +#X connect 13 0 24 0; +#X connect 14 0 24 0; +#X connect 15 0 24 0; +#X connect 16 0 24 1; +#X connect 17 0 24 1; +#X connect 18 0 24 1; +#X connect 19 0 24 1; +#X connect 20 0 24 1; +#X connect 24 0 25 0; +#X restore 102 387 pd prepend; +#N canvas 1 82 555 530 split 0; +#X obj 0 0 cnv 15 552 40 empty \$0-pddp.cnv.header empty 3 12 0 14 +-204280 -1 0; +#X obj 0 277 cnv 3 520 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#X obj 0 371 cnv 3 520 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 78 380 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 286 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 314 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X text 98 287 anything; +#X obj 0 458 cnv 3 520 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X text 80 477 1); +#X msg 200 145 bang; +#X obj 159 173 list split 2; +#X floatatom 262 148 3 0 5 0 - - -, f 3; +#X msg 159 57 1 2; +#X msg 124 57 1; +#X text 156 228 first n; +#X text 245 228 rest of list; +#X text 337 228 shorter than n; +#X text 18 24 cut a list into smaller ones; +#X obj 13 3 list split; +#X msg 173 79 one 2 3; +#X msg 183 101 list one 2 3; +#X msg 193 123 1 2 three; +#X obj 159 211 print split0; +#X obj 248 211 print split1; +#X obj 340 211 print split2; +#X text 178 287 - all input is converted to a list.; +#X text 98 315 float; +#X text 98 381 list; +#X obj 78 403 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X text 98 404 list; +#X obj 78 425 cnv 17 3 17 empty \$0-pddp.cnv.let.2 2 5 9 0 16 -228856 +-162280 0; +#X text 98 426 list; +#X text 178 315 - split point. A value of n will send the first n elements +to the left outlet \, and the rest of the list to the middle outlet. +Incoming lists shorter than n are sent to the rightmost outlet.; +#X text 168 381 - the first n elements of the incoming list.; +#X text 168 404 - the remaining elements of the incoming list.; +#X text 168 426 - if the incoming list has fewer than n elements \, +it is sent in its entirety to the rightmost outlet.; +#X text 170 477 - the symbol "split".; +#X text 98 493 float; +#X text 80 493 2); +#X text 98 477 symbol atom; +#X text 170 493 - (optional) an integer to initialize the split point. +; +#X connect 9 0 10 0; +#X connect 10 0 22 0; +#X connect 10 1 23 0; +#X connect 10 2 24 0; +#X connect 11 0 10 1; +#X connect 12 0 10 0; +#X connect 13 0 10 0; +#X connect 19 0 10 0; +#X connect 20 0 10 0; +#X connect 21 0 10 0; +#X restore 102 409 pd split; +#N canvas 1 82 555 481 trim 0; +#X obj 0 0 cnv 15 552 40 empty \$0-pddp.cnv.header empty 3 12 0 14 +-204280 -1 0; +#X obj 0 330 cnv 3 520 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#X obj 0 385 cnv 3 520 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 78 394 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 339 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 340 anything; +#X obj 0 429 cnv 3 520 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X text 80 448 1); +#X msg 49 139 1 2 3; +#X msg 49 90 list cis boom bah; +#X msg 49 195 bang; +#X msg 49 63 walk the dog; +#X obj 49 276 list trim; +#X obj 49 298 print trim; +#X msg 49 222 1 x y; +#X msg 49 248 x 1 y; +#X msg 49 113 55; +#X text 98 395 anything; +#X text 170 448 - the symbol "trim".; +#X obj 13 3 list trim; +#X text 18 24 remove the list selector; +#X text 128 230 The [list trim] object inputs lists (or makes lists +out of incoming non-list messages) and outputs a message whose selector +is the first item of the list \, and whose arguments \, if any \, are +the remainder of the list. If the list has no items \, or if its first +item is numeric \, the selector is "list" (which might print out as +list \, float \, or bang.); +#X text 98 448 symbol atom; +#X text 178 340 - all input is converted to a list. A bang message +is converted to an empty list. A symbol message like "symbol blah" +is converted to "list blah".; +#X text 134 63 non-list messages remain non-list messages; +#X text 97 139 implicit list remains a list; +#X msg 49 167 symbol x; +#X text 86 195 becomes message "list" (interpreted by most objects +as bang); +#X text 166 90 "list" selector gets trimmed off; +#X text 79 113 becomes "list 55" (interpreted by most objects as float) +; +#X text 112 167 "symbol" selector gets trimmed off.; +#X text 168 395 - after the incoming message is converted to a list +\, the "list" selector is removed and the message is output.; +#X connect 8 0 12 0; +#X connect 9 0 12 0; +#X connect 10 0 12 0; +#X connect 11 0 12 0; +#X connect 12 0 13 0; +#X connect 14 0 12 0; +#X connect 15 0 12 0; +#X connect 16 0 12 0; +#X connect 26 0 12 0; +#X restore 102 431 pd trim; +#N canvas 2 128 555 490 length 0; +#X obj 0 0 cnv 15 552 40 empty \$0-pddp.cnv.header empty 3 12 0 14 +-204280 -1 0; +#X obj 0 374 cnv 3 520 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#X obj 0 411 cnv 3 520 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 78 420 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 383 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 384 anything; +#X obj 0 448 cnv 3 520 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X text 80 467 1); +#X obj 13 3 list length; +#X msg 226 161 1 2 3; +#X msg 226 112 list cis boom bah; +#X msg 227 187 bang; +#X msg 226 85 walk the dog; +#X msg 227 209 1 x y; +#X msg 226 235 x 1 y; +#X msg 226 135 55; +#X obj 201 263 list length; +#X floatatom 201 289 5 0 0 0 - - -, f 5; +#X text 18 24 number of elements in a list; +#X text 98 421 float; +#X text 170 467 - the symbol "length".; +#X text 98 467 symbol atom; +#X text 168 384 - any message type is accepted and converted to a list. +; +#X text 168 421 - [list length] outputs the number of elements in the +list.; +#X connect 9 0 16 0; +#X connect 10 0 16 0; +#X connect 11 0 16 0; +#X connect 12 0 16 0; +#X connect 13 0 16 0; +#X connect 14 0 16 0; +#X connect 15 0 16 0; +#X connect 16 0 17 0; +#X restore 102 453 pd length; +#X text 98 307 symbol atom; +#X text 98 322 float; +#N canvas 51 146 428 419 list_conversion_in_Pd 0; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 7 1 [list] Conversion; +#X text 19 168 In brief:; +#X text 19 188 "list" -> bang; +#X text 19 208 "list 1" -> "float 1"; +#X text 19 228 "list hello" -> "symbol hello"; +#X text 19 37 Most objects in Pd handle zero- and one-element lists +in the following way:; +#X text 19 67 * an incoming zero-element list (i.e. \, a message consisting +onf the selector "list") is treated as a bang.; +#X text 19 97 * an incoming one-element list that contains a float +is treated as a float.; +#X obj 22 331 route list float; +#X obj 22 304 list; +#X obj 22 358 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 -1 +-1; +#X obj 68 358 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 -1 +-1; +#X msg 22 277 12; +#X text 55 277 implicit float-- same as "float 12"; +#X text 55 304 output as "list 12"; +#X floatatom 68 387 5 0 0 0 - - -, f 5; +#X text 130 331 [route] converts "list 12" to "float 12"; +#X text 19 127 * an incoming one-element list that contains a symbol +atom is treated as a symbol.; +#X connect 9 0 11 0; +#X connect 9 1 12 0; +#X connect 9 1 16 0; +#X connect 10 0 9 0; +#X connect 13 0 10 0; +#X restore 241 586 pd list_conversion_in_Pd; +#X text 170 307 - (optional) if no creation argument is given \, or +if the first creation argument is a number \, [list] will behave like +[list append]. Otherwise \, one of the following symbols may be given +as arguments (see subpatches for more info):; +#X text 98 245 [list] family objects always output a list. See the +"list_conversion_in_Pd" subpatch below for how lists are interpreted +by other objects.; +#X text 98 514 depending on what the first creation argument is \, +other creation arguments may be specified.; +#X text 98 154 See subpatches under the heading "arguments" for more +details. With the exception of the right inlet of [list split] \, All +[list] objects will convert incoming non-list messages to lists (e.g. +\, "set 5" will become "list set 5"). A bang message is converted to +an empty list (i.e. \, "list") \, and "symbol foo" is converted to +"list foo".; +#X obj 4 638 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X text 180 475 cat - build a list by accumulating elements; +#N canvas 1 112 555 488 cat 0; +#X obj 0 0 cnv 15 552 40 empty \$0-pddp.cnv.header empty 3 12 0 14 +-204280 -1 0; +#X obj 0 304 cnv 3 520 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#X obj 0 387 cnv 3 520 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 78 396 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 313 cnv 17 3 40 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 363 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X text 98 314 anything; +#X obj 0 431 cnv 3 520 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X text 80 450 1); +#X floatatom 189 166 5 0 0 0 - - -, f 5; +#X msg 179 143 1 2 3; +#X msg 196 189 bang; +#X msg 170 120 4 5 6 and 7; +#X msg 128 51 4 5 6; +#X msg 158 98 four 5 6; +#X msg 144 74 list four 5 6; +#X text 98 397 list; +#X text 168 397 - the output is always a message with the selector +"list" (see subpatch "list_conversion" for more info).; +#X text 98 450 symbol atom; +#X obj 13 3 list cat; +#X text 18 24 append (concatenate) list to the previously entered list(s) +; +#X msg 203 225 clear; +#X obj 158 271 print cat; +#X obj 158 249 list cat; +#X text 98 364 clear; +#X text 178 364 - empties the stored list.; +#X text 178 314 - all input is converted to a list. The list is appended +to the list(s) previously entered in the left inlet \, and the resulting +list is sent to the outlet.; +#X text 170 450 - the symbol "cat".; +#X connect 9 0 23 0; +#X connect 10 0 23 0; +#X connect 11 0 23 0; +#X connect 12 0 23 0; +#X connect 13 0 23 0; +#X connect 14 0 23 0; +#X connect 15 0 23 0; +#X connect 21 0 23 1; +#X connect 23 0 22 0; +#X restore 102 475 pd cat; +#X connect 21 0 24 0; +#X connect 22 0 21 1; +#X connect 23 0 21 0; +#X connect 25 0 21 1; diff --git a/doc/pddp/loadbang-help.pd b/pd/doc/5.reference/loadbang-help.pd similarity index 100% rename from doc/pddp/loadbang-help.pd rename to pd/doc/5.reference/loadbang-help.pd diff --git a/doc/pddp/log-help.pd b/pd/doc/5.reference/log-help.pd similarity index 100% rename from doc/pddp/log-help.pd rename to pd/doc/5.reference/log-help.pd diff --git a/doc/pddp/loop~-help.pd b/pd/doc/5.reference/loop~-help.pd similarity index 100% rename from doc/pddp/loop~-help.pd rename to pd/doc/5.reference/loop~-help.pd diff --git a/pd/doc/5.reference/lop~-help.pd b/pd/doc/5.reference/lop~-help.pd index 92b5ed22a..789173d9b 100644 --- a/pd/doc/5.reference/lop~-help.pd +++ b/pd/doc/5.reference/lop~-help.pd @@ -1,37 +1,91 @@ -#N canvas 390 359 566 329 12; -#X obj 70 228 env~; -#X floatatom 70 248 0 0 0 0 - - -; -#X floatatom 107 178 0 0 0 0 - - -; -#X obj 12 226 env~; -#X floatatom 12 245 0 0 0 0 - - -; -#X floatatom 12 107 0 0 0 0 - - -; -#X obj 83 6 lop~; -#X text 9 68 The left inlet is the incoming audio signal. The right -inlet is the cutoff frequency in Hz.; -#X obj 12 130 osc~ 100; -#X text 57 105 <-- scroll to change input frequency; -#X text 8 35 lop~ is a one-pole low pass filter with a specified rolloff -frequency.; -#X text 114 7 - one-pole low pass filter; -#X msg 70 154 clear; -#X text 114 153 <-- reinitialize internal state; -#X text 139 179 <-- set cutoff frequency; -#X obj 70 206 lop~ 5; -#X text 121 209 The filter is initialized to cut off frequencies above -5 Hz.; -#X text 12 266 Compare the strength of the original signal on the left +#N canvas 428 38 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 lop~ 3 12 0 18 -204280 +-1 0; +#X obj 0 381 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 487 290 494 344 META 0; +#X text 12 125 LIBRARY internal; +#X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 145 AUTHOR Miller Puckette; +#X text 12 205 HELP_PATCH_AUTHORS Updated for Pd version-0.38. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 5 KEYWORDS signal filter; +#X text 12 45 DESCRIPTION one-pole low pass filter; +#X text 12 65 INLET_0 signal clear; +#X text 12 85 INLET_1 float; +#X text 12 105 OUTLET_0 signal; +#X text 12 185 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 488 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 525 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 567 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#X obj 78 390 cnv 17 3 37 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#N canvas 220 463 428 166 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 obj 69 43 bp~; +#X obj 117 43 vcf~; +#X text 22 81 Raw Filters; +#X obj 73 108 rzero~; +#X obj 195 108 cpole~; +#X obj 24 108 rpole~; +#X obj 122 108 rzero_rev~; +#X obj 244 108 czero~; +#X obj 293 108 czero_rev~; +#X obj 22 43 hip~; +#X text 8 2 [lop~] Related Objects; +#X restore 101 597 pd Related_objects; +#X text 98 389 signal; +#X obj 78 497 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 497 signal; +#X obj 147 240 env~; +#X floatatom 147 263 0 0 0 0 - - -; +#X floatatom 180 185 0 0 0 0 - - -; +#X obj 88 240 env~; +#X floatatom 88 262 0 0 0 0 - - -; +#X floatatom 88 114 0 0 0 0 - - -; +#X obj 88 137 osc~ 100; +#X msg 147 161 clear; +#X text 168 389 - incoming audio signal.; +#X obj 78 432 cnv 17 3 45 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X text 98 431 float; +#X text 98 449 list; +#X text 98 409 clear; +#X obj 514 10 lop~; +#X text 133 112 <- scroll to change input frequency; +#X obj 147 213 lop~ 5; +#X text 84 291 Compare the strength of the original signal on the left with that of the filtered signal on the right.; -#X text 104 228 env~ gives the amplitude of the signal in dB.; -#X text 8 305 see also:; -#X obj 77 304 hip~; -#X obj 112 304 bp~; -#X obj 139 304 vcf~; -#X text 364 306 updated for Pd version-0.38; -#X connect 0 0 1 0; -#X connect 2 0 15 1; -#X connect 3 0 4 0; -#X connect 5 0 8 0; -#X connect 8 0 3 0; -#X connect 8 0 15 0; -#X connect 12 0 15 0; -#X connect 15 0 0 0; +#X text 11 23 one-pole low pass filter; +#X text 168 544 - initial rolloff frequency.; +#X text 168 409 - reinitialize internal state.; +#X text 168 431 - cutoff frequency in Hz.; +#X text 168 449 - a list to the right inlet is truncated \, and the +first element is used as the cutoff frequency.; +#X text 168 497 - output is the filtered audio signal.; +#X text 80 544 1) float; +#X text 191 240 [env~] gives the amplitude of the signal envelop in +dB.; +#X text 88 68 [lop~] is a one-pole low pass filter with a specified +rolloff frequency.; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 479 51 pddp/dsp; +#X connect 12 0 13 0; +#X connect 14 0 27 1; +#X connect 15 0 16 0; +#X connect 17 0 18 0; +#X connect 18 0 15 0; +#X connect 18 0 27 0; +#X connect 19 0 27 0; +#X connect 27 0 12 0; diff --git a/doc/pddp/lrshift~-help.pd b/pd/doc/5.reference/lrshift~-help.pd similarity index 100% rename from doc/pddp/lrshift~-help.pd rename to pd/doc/5.reference/lrshift~-help.pd diff --git a/pd/doc/5.reference/makefilename-help.pd b/pd/doc/5.reference/makefilename-help.pd index c921fe7fa..dc3ca7e28 100644 --- a/pd/doc/5.reference/makefilename-help.pd +++ b/pd/doc/5.reference/makefilename-help.pd @@ -1,49 +1,361 @@ -#N canvas 87 80 611 646 12; -#X floatatom 37 179 0 0 0 0 - - -; -#X obj 37 281 print; -#X obj 37 254 makefilename dog%d.aif; -#X msg 34 326 symbol meat; -#X msg 47 350 symbol hair; -#X obj 34 405 print; -#X obj 34 378 makefilename dog%s.aif; -#X text 26 47 The Makefilename object generates symbols according to -a format string \, for use as a series of filenames \, table names -\, or whatnot. You can plug in a variable number or symbol by putting -"%d" or "%s" in the string. If you put "%s" in the string be sure to -send it a symbol and vice versa... there's no checking.; -#X obj 49 17 makefilename; -#X text 170 18 - format a "name" with a variable field; -#X msg 52 205 set cat%d.wav; -#X msg 52 229 set %d-zebra; -#X text 359 625 updated for Pd version 0.37; -#X text 71 179 <- numbers replace "%d" in string; -#X text 177 207 <- "set" message replaces format; -#X text 243 256 <- creation argument is format; -#X text 138 152 SUBSTITUTING A NUMBER; -#X text 126 301 SUBSTITUTING A SYMBOL; -#X obj 49 619 print; -#X obj 48 517 makefilename dog%%d.%s; -#X msg 48 541 set \$1; -#X obj 48 595 makefilename not-set-yet; -#X floatatom 57 566 0 0 0 0 - - -; -#X msg 48 465 symbol aif; -#X msg 61 489 symbol wav; -#X text 44 441 GANG THEM TO DO DOUBLE (OR N-TUPLE) SUBSTITUTION; -#X text 258 519 "%s" is replaced by the symbol; -#X text 259 502 here \, "%%" becomes "%" and; -#X text 114 544 ... so this becomes "set dog%d.aif" \, for example. +#N canvas 426 37 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 makefilename 3 12 +0 18 -204280 -1 0; +#X obj 0 179 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 483 287 494 344 META 0; +#X text 12 105 LIBRARY internal; +#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 125 AUTHOR Miller Puckette; +#X text 12 185 HELP_PATCH_AUTHORS Dave Sabine \, Hans-Christoph Steiner. +Jonathan Wilkes revised the patch to conform to the PDDP template for +Pd version 0.42.; +#X text 12 45 DESCRIPTION format a string with a variable field; +#X text 12 65 INLET_0 float symbol; +#X text 12 85 OUTLET_0 symbol; +#X text 12 165 RELEASE_DATE 1997; +#X text 12 5 KEYWORDS control conversion symbol_op; +#X restore 500 597 pd META; +#X obj 0 319 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 356 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 479 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 212 443 428 187 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 7 1 [makefilename] Related Objects; +#X obj 21 42 symbol; +#X obj 71 42 int; +#X obj 102 42 float; +#X obj 152 42 openpanel; +#X obj 19 96 pddp/helplink zexy/makesymbol; +#X obj 19 116 pddp/helplink cyclone/sprintf; +#X obj 19 136 pddp/helplink cxc/ascseq; +#X text 19 74 Externals; +#X restore 101 597 pd Related_objects; +#X obj 78 188 cnv 17 3 120 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 187 float; +#X obj 78 328 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 468 11 makefilename; +#X floatatom 49 64 0 0 0 0 - - -; +#X text 81 143 numbered filenames; +#X symbolatom 49 122 0 0 0 0 - - -; +#X obj 49 91 makefilename soundfile%d.aif; +#X obj 304 102 symbol; +#X msg 304 54 dave; +#X msg 343 54 drums; +#X msg 400 54 Pd; +#X msg 437 55 cool; +#X obj 304 126 makefilename %s_PD.aif; +#X symbolatom 304 150 0 0 0 0 - - -; +#X text 168 187 - if a number (integer) is sent to the inlet \, the +argument should be written with a "%c" \, "%d" \, or "%X" which represents +the location of the incoming variable number in the outgoing symbol. +Floats will be converted to integers.; +#X text 98 237 symbol; +#X text 98 278 list; +#X text 98 327 symbol; +#X text 169 374 - this object generates symbols according to a format +string (the argument) \, for use as a series of filenames \, table +names \, etc. Variables for numbers can be specified by using "%s" +\, "%c" \, "%d" \, or "%X" in the string (see subpatch below). For +variable symbols \, use "%s". No checking is done. Each [makefilename] +object can have only one variable.; +#X text 168 237 - if a symbol is sent to the inlet \, the argument +should be written with a "%s" which represents the location of the +incoming variable symbol in the outgoing symbol.; +#N canvas 74 23 428 594 More_Info 0; +#X text 20 33 I believe that this object was developed first to allow +PD to generate sequential file names - perhaps to be used in conjunction +with [soundfiler] or [openpanel]. For example \, an audio loop recorder +might generate a continuous series of sound files to be saved on a +hard drive...like below:; +#X obj 23 127 f; +#X symbolatom 23 168 0 0 0 0 - - -; +#X obj 52 127 + 1; +#X obj 23 147 makefilename file-%d.aif; +#X obj 23 104 bng 18 250 50 0 empty empty start 22 9 1 12 -90049 -1 +-1; +#X symbolatom 61 358 0 0 0 0 - - -; +#X obj 64 309 hsl 150 18 0 122 0 1 empty empty ASCII_range 2 9 1 12 +-262131 -1 -1 6800 0; +#X floatatom 30 360 3 0 0 0 - - -, f 3; +#X text 19 514 - only one printf pattern can be used at once; +#X text 19 476 - This object does not provide advanced formatting and +parsing abilities. For example \, you cannot use spaces or odd characters +in the argument.; +#X text 19 567 - non-printable ASCII characters show up as a little +box.; +#X symbolatom 264 358 0 0 0 0 - - -; +#X obj 267 309 hsl 150 18 0 255 0 1 empty empty 0_to_FF 2 9 1 12 -262131 +-1 -1 5100 0; +#X obj 264 338 makefilename hex=%X; +#X floatatom 233 360 3 0 0 0 - - -, f 3; +#X obj 61 338 makefilename ASCII=%c; +#X text 29 381 Watch out! ASCII characters 123 and 125 (curly braces) +lock up Pd. Also \, reserved characters that Pd uses show up with a +backslash in front of them (comma \, semi-colon \, and backslash). ; -#X text 108 566 ... and then the number fills in "%d".; -#X connect 0 0 2 0; -#X connect 2 0 1 0; -#X connect 3 0 6 0; -#X connect 4 0 6 0; -#X connect 6 0 5 0; -#X connect 10 0 2 0; -#X connect 11 0 2 0; -#X connect 19 0 20 0; +#X text 19 530 - currently \, floats are not supported via the printf +%f pattern. You can only display the integer part of the float using +%d or %X.; +#X text 20 189 This file name could be used when saving the audio to +disk.; +#X text 20 251 The %c pattern allows you to convert ASCII numbers to +the respective character. The %X converts the decimal number to hexadecimal. +Both %c and %X only use integers. For floats \, everything to the right +of the decimal is discarded.; +#X obj 2 2 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 8 2 [makefilename] Common Uses; +#X obj 2 216 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 +0 14 -204280 -1 0; +#X text 8 216 Conversions; +#X obj 2 442 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 +0 14 -204280 -1 0; +#X text 8 442 Limitations; +#X connect 1 0 3 0; +#X connect 1 0 4 0; +#X connect 3 0 1 1; +#X connect 4 0 2 0; +#X connect 5 0 1 0; +#X connect 7 0 16 0; +#X connect 7 0 8 0; +#X connect 13 0 14 0; +#X connect 13 0 15 0; +#X connect 14 0 12 0; +#X connect 16 0 6 0; +#X restore 100 488 pd More_Info; +#N canvas 105 144 428 318 all_possible_patterns 0; +#X text 33 86 %c; +#X text 110 86 character; +#X text 33 106 %d or %i; +#X text 110 106 signed decimal integer; +#X text 33 126 %e; +#X text 110 126 scientific notation using "e" character; +#X text 33 146 %E; +#X text 110 146 scientific notation using "e" character; +#X text 33 166 %f; +#X text 33 186 %o; +#X text 110 186 signed octal; +#X text 33 206 %s; +#X text 110 206 symbol; +#X text 33 226 %u; +#X text 110 226 unsigned integer; +#X text 33 246 %x; +#X text 110 246 unsigned hexadecimal in lowercase; +#X text 33 266 %X; +#X text 110 266 unsigned hexadecimal in CAPS; +#X text 33 286 %p; +#X text 110 286 unsigned hexadecimal in lowercase preceeded by "0x" +; +#X text 20 37 This is a listing of all possible printf patterns used +in Pd's [makefilename]:; +#X text 110 166 decimal floating point (currently broken); +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 7 1 [makefilename] All Possible Patterns; +#X restore 100 456 pd all_possible_patterns; +#N canvas 80 12 428 594 spaces_and_multiple_variables 0; +#X obj 223 71 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 223 90 f; +#X symbolatom 223 135 0 0 0 0 - - -; +#X obj 256 90 + 1; +#X obj 223 112 makefilename I_am_%d_years_old.; +#X text 20 197 With careful planning \, multiple variables can be incorporated +using a stack of [makefilename]s. In the example below \, let's assume +that this tool is used to generate file names for an audio loop recorder +which operates 24 hours per day \, every day.; +#X obj 25 265 loadbang; +#X obj 25 305 metro 200; +#X obj 25 286 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 1 1 +; +#X obj 58 330 + 1; +#X obj 153 369 route 0 1 2 3 4 5 6; +#X obj 25 379 mod 24; +#X floatatom 25 404 5 0 0 0 - - -, f 5; +#X floatatom 25 354 0 0 0 0 - - -; +#X obj 25 330 f; +#X obj 47 430 sel 0; +#X obj 162 289 f; +#X obj 194 289 + 1; +#X obj 162 314 mod 7; +#X obj 162 342 pack f f; +#X obj 168 518 makefilename Monday_%d.wav; +#X symbolatom 29 568 0 0 0 0 - - -; +#X obj 248 394 makefilename Saturday_%d.wav; +#X obj 232 419 makefilename Friday_%d.wav; +#X obj 234 346 t b f; +#X obj 216 444 makefilename Thursday_%d.wav; +#X obj 200 469 makefilename Wednesday_%d.wav; +#X obj 184 494 makefilename Tuesday_%d.wav; +#X obj 153 542 makefilename Sunday_%d.wav; +#X text 65 402 hour of day; +#X text 63 355 total hours; +#X text 153 569 Crude...but effective.; +#X obj 25 480 s dayHour; +#X obj 47 455 s weekDay; +#X obj 162 266 r weekDay; +#X obj 234 320 r dayHour; +#X text 228 291 loop through weekdays; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 7 1 [makefilename] Spaces and Multiple Variables; +#X symbolatom 22 115 0 0 0 0 - - -; +#X obj 22 93 makefilename one%ctwo; +#X msg 22 71 32; +#X text 51 70 ascii character 32 (space); +#X text 19 37 A symbol that includes a space will not be saved. An +underscore will often produce a tolerable compromise.; +#X obj 22 151 route symbol; +#X obj 22 172 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 -1 +-1; +#X text 72 115 this symbol won't load; +#X text 72 130 properly if saved.; +#X text 41 171 but it's a valid symbol; +#X connect 0 0 1 0; +#X connect 1 0 3 0; +#X connect 1 0 4 0; +#X connect 3 0 1 1; +#X connect 4 0 2 0; +#X connect 6 0 8 0; +#X connect 7 0 14 0; +#X connect 8 0 7 0; +#X connect 9 0 14 1; +#X connect 10 0 28 0; +#X connect 10 1 20 0; +#X connect 10 2 27 0; +#X connect 10 3 26 0; +#X connect 10 4 25 0; +#X connect 10 5 23 0; +#X connect 10 6 22 0; +#X connect 11 0 12 0; +#X connect 12 0 15 0; +#X connect 12 0 32 0; +#X connect 13 0 11 0; +#X connect 14 0 9 0; +#X connect 14 0 13 0; +#X connect 15 0 33 0; +#X connect 16 0 17 0; +#X connect 16 0 18 0; +#X connect 17 0 16 1; +#X connect 18 0 19 0; +#X connect 19 0 10 0; #X connect 20 0 21 0; -#X connect 21 0 18 0; #X connect 22 0 21 0; -#X connect 23 0 19 0; +#X connect 23 0 21 0; #X connect 24 0 19 0; +#X connect 24 1 19 1; +#X connect 25 0 21 0; +#X connect 26 0 21 0; +#X connect 27 0 21 0; +#X connect 28 0 21 0; +#X connect 34 0 16 0; +#X connect 35 0 24 0; +#X connect 39 0 44 0; +#X connect 40 0 39 0; +#X connect 41 0 40 0; +#X connect 44 0 45 0; +#X restore 100 511 pd spaces_and_multiple_variables; +#N canvas 58 29 463 530 help_with_interfaces 0; +#X text 21 32 Building user interfaces in Pd is a difficult balance +between usability and performance. Pd is not winning any awards for +usability - let's face it: it's powerful \, it's cool \, and that's +the way we like it. You're not here because you want a colourful \, +bevelled interface...you want the raw power that object oriented languages +provide mixed with a few of the conveniences that a graphic environment +affords.; +#X obj 6 221 cnv 15 450 300 empty empty empty 20 12 0 14 -261681 -66577 +0; +#X obj 34 331 tgl 15 0 s_dsp empty DSP 18 7 0 8 -262144 -1 -1 0 1; +#X obj 34 376 vsl 15 128 0 127 0 0 v_slider empty Volume 18 7 0 8 -262144 +-1 -1 0 1; +#X obj 34 353 bng 15 250 50 0 b_panel empty Open_File 18 7 0 8 -262144 +-1 -1; +#X obj 29 232 cnv 15 400 20 empty d_canvas DSP:OFF 20 12 0 8 -233017 +-66577 0; +#X obj 29 254 cnv 15 400 20 empty f_canvas FILE_OPEN:/Users/hans/cvs/pure-data/doc/pddp/all_about_lists_vs_anythings.pd +20 12 0 8 -233017 -66577 0; +#X obj 29 276 cnv 15 400 20 empty v_canvas VOLUME:42/100 20 12 0 8 +-233017 -66577 0; +#X text 176 313 The grey canvases above could; +#X text 178 335 be used like "status bars" to; +#X text 178 356 write relevant information to; +#X text 175 412 [makefilename] helps to format; +#X text 177 436 the information in a meaningful; +#X text 178 457 way.; +#X text 176 378 the screen.; +#N canvas 57 187 430 328 look_inside 0; +#X obj 199 14 r b_panel; +#X obj 235 166 r v_slider; +#X obj 36 236 s d_canvas; +#X obj 199 114 s f_canvas; +#X obj 235 263 s v_canvas; +#X obj 36 80 sel 0; +#X obj 71 152 symbol ON; +#X obj 36 128 symbol OFF; +#X obj 71 103 bang; +#X msg 36 210 label \$1; +#X obj 36 184 makefilename DSP:%s; +#X obj 36 13 r s_dsp; +#X msg 45 38 \; pd dsp \$1; +#X obj 199 40 openpanel; +#X obj 199 65 makefilename FILE_OPEN:%s; +#X msg 199 90 label \$1; +#X msg 235 240 label \$1; +#X obj 235 192 expr ($f1/128)*100; +#X obj 235 217 makefilename VOLUME:%d/100; +#X connect 0 0 13 0; +#X connect 1 0 17 0; +#X connect 5 0 7 0; +#X connect 5 1 8 0; +#X connect 6 0 10 0; +#X connect 7 0 10 0; +#X connect 8 0 6 0; +#X connect 9 0 2 0; +#X connect 10 0 9 0; +#X connect 11 0 5 0; +#X connect 11 0 12 0; +#X connect 13 0 14 0; +#X connect 14 0 15 0; +#X connect 15 0 3 0; +#X connect 16 0 4 0; +#X connect 17 0 18 0; +#X connect 18 0 16 0; +#X restore 29 302 pd look_inside; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 7 1 [makefilename] Help with Interfaces; +#X text 21 137 However \, there are times when sacrifices must be made +in the area of performance to provide users with on-screen reporting +\, record keeping \, and sometimes even a few 'pleasantries'. Consider +the following examples - but always weigh the pros and cons when incorporating +these types of interfaces. Performance vs. Usability.; +#X restore 100 534 pd help_with_interfaces; +#X text 11 23 format a string with a variable field; +#X text 168 278 - if the first element of the list matches the variable +type used \, then the list will be truncated.; +#X text 168 327 - the output of [makefilename] is always a symbol. +; +#X text 80 374 1) symbol atom; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 98 572 pddp/pddplink all_about_symbol_construction.pd; +#X obj 98 554 pddp/pddplink ../1.manual/x3.htm -text Pd Manual Chapter +3.6 - doc/1.manual/x3.htm; +#X connect 12 0 15 0; +#X connect 15 0 14 0; +#X connect 16 0 21 0; +#X connect 17 0 16 0; +#X connect 18 0 16 0; +#X connect 19 0 16 0; +#X connect 20 0 16 0; +#X connect 21 0 22 0; diff --git a/pd/doc/5.reference/makenote-help.pd b/pd/doc/5.reference/makenote-help.pd index e3d003fc7..4f7239c33 100644 --- a/pd/doc/5.reference/makenote-help.pd +++ b/pd/doc/5.reference/makenote-help.pd @@ -1,26 +1,128 @@ -#N canvas 39 28 663 385 12; -#X floatatom 180 207 0 0 0; -#X floatatom 110 176 0 0 0; -#X msg 48 127 60; -#X obj 41 262 print x1; -#X obj 180 262 print x2; -#X floatatom 41 104 0 0 0; -#X obj 29 14 makenote; -#X text 113 14 - send note-on messages and schedule note-off for later; -#X text 19 41 Makenote makes MIDI-style note-on/note-off pairs \, which you can use for MIDI output or to drive note-like processes within Pd.; -#X msg 48 153 60.5; -#X text 80 105 numbers at left are "pitches" which may be integers or not.; -#X text 146 178 "velocity"; -#X text 215 210 duration in milliseconds; -#X obj 41 235 makenote 3.2 500; -#X text 193 235 creation arguments initialize velocity and duration; -#X text 38 316 see also; -#X obj 117 316 stripnote; -#X text 389 325 updated for Pd version 0.33; -#X connect 0 0 13 2; -#X connect 1 0 13 1; -#X connect 2 0 13 0; -#X connect 5 0 13 0; -#X connect 9 0 13 0; -#X connect 13 0 3 0; -#X connect 13 1 4 0; +#N canvas 428 39 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 makenote 3 12 0 +18 -204280 -1 0; +#X obj 0 281 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 485 265 494 367 META 0; +#X text 12 175 LIBRARY internal; +#X text 12 215 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 235 RELEASE_DATE 2009-06-12; +#X text 12 25 LICENSE SIBSD; +#X text 12 195 AUTHOR Miller Puckette; +#X text 12 255 HELP_PATCH_AUTHORS Updated for Pd version 0.33. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 5 KEYWORDS control MIDI; +#X text 12 75 INLET_0 float list; +#X text 12 95 INLET_1 float; +#X text 12 115 INLET_2 float; +#X text 12 135 OUTLET_0 float; +#X text 12 155 OUTLET_1 float; +#X text 12 45 DESCRIPTION send note-on messages and schedule note-off +for later; +#X restore 500 597 pd META; +#X obj 0 443 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 508 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 567 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 218 222 428 410 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 [makenote] Related Objects; +#X obj 74 80 ctlin; +#X obj 217 80 pgmin; +#X obj 24 80 bendin; +#X obj 79 107 touchin; +#X obj 261 80 polytouchin; +#X obj 118 80 midiin; +#X obj 23 107 sysexin; +#X obj 179 167 noteout; +#X obj 76 167 ctlout; +#X obj 24 167 bendout; +#X obj 366 167 touchout; +#X obj 280 167 polytouchout; +#X obj 123 167 midiout; +#X obj 231 167 pgmout; +#X obj 24 221 makenote; +#X text 21 198 MIDI note construction:; +#X text 21 140 MIDI output:; +#X text 21 57 MIDI input:; +#X obj 184 221 stripnote; +#X obj 168 80 notein; +#X text 181 198 MIDI note deconstruction:; +#X obj 24 33 stripnote; +#X text 21 265 Additional useful objects for MIDI processing (Maxlib +by Olaf Matthes); +#X text 20 344 Also \, from cyclone (alpha) by Krzysztof Czaja:; +#X text 21 246 Externals; +#X obj 21 295 pddp/helplink maxlib/pitch; +#X obj 21 310 pddp/helplink maxlib/score; +#X obj 21 325 pddp/helplink maxlib/chord; +#X obj 21 360 pddp/helplink cyclone/midiformat; +#X obj 21 375 pddp/helplink cyclone/midiparse; +#X obj 21 390 pddp/helplink cyclone/midiflush; +#X restore 101 597 pd Related_objects; +#X obj 78 290 cnv 17 3 95 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 289 float; +#X text 98 329 list; +#X text 98 451 float; +#X obj 78 452 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 391 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X text 98 390 float; +#X obj 486 11 makenote; +#X text 80 59 Makenote makes MIDI-style note-on/note-off pairs \, which +you can use for MIDI output or to drive note-like processes within +Pd.; +#X floatatom 276 163 0 0 0 0 - - -; +#X floatatom 276 142 0 0 0 0 - - -; +#X msg 194 119 60; +#X obj 183 218 print x1; +#X obj 276 218 print x2; +#X floatatom 183 97 0 0 0 0 - - -; +#X msg 234 123 60.5; +#X text 302 142 "velocity"; +#X text 311 166 duration in milliseconds; +#X obj 183 191 makenote 3.2 500; +#X text 168 289 - numbers to the left inlet are "pitches" (MIDI pitch +numbers) which may be integers or floating point numbers (for microtonal +pitches).; +#X msg 130 121 12 2; +#X text 11 23 send note-on messages and schedule note-off for later +; +#X text 168 329 - a list with three elements (pitch \, velocity \, +duration) will be distributed to the three inlets. You can also send +a two-element list to use the last duration supplied to [makenote]. +Lists with more than three elements are truncated.; +#X obj 78 415 cnv 17 3 17 empty \$0-pddp.cnv.let.2 2 5 9 0 16 -228856 +-162280 0; +#X text 98 414 float; +#X text 158 544 - (optional) initial duration.; +#X text 158 529 - (optional) initial velocity.; +#X text 98 474 float; +#X obj 78 475 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X text 168 474 - velocity (in milliseconds). After the specified duration +\, a zero is output.; +#X text 167 390 - velocity.; +#X text 167 414 - duration (in milliseconds).; +#X text 80 529 1) float; +#X text 80 544 2) float; +#X text 168 451 - pitch. (It is output again after the specified duration.) +; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X connect 17 0 26 2; +#X connect 18 0 26 1; +#X connect 19 0 26 0; +#X connect 22 0 26 0; +#X connect 23 0 26 0; +#X connect 26 0 20 0; +#X connect 26 1 21 0; +#X connect 28 0 26 0; diff --git a/pd/doc/5.reference/math-help.pd b/pd/doc/5.reference/math-help.pd index 5464b8aa9..ae00e7fef 100644 --- a/pd/doc/5.reference/math-help.pd +++ b/pd/doc/5.reference/math-help.pd @@ -1,60 +1,132 @@ -#N canvas 0 0 554 555 12; -#X floatatom 283 263 0 0 0; -#X floatatom 226 349 0 0 0; -#X floatatom 226 262 0 0 0; -#X floatatom 281 486 0 0 0; -#X floatatom 281 425 0 0 0; -#X floatatom 185 486 0 0 0; -#X floatatom 185 425 0 0 0; -#X floatatom 117 486 0 0 0; -#X floatatom 117 425 0 0 0; -#X floatatom 117 326 0 0 0; -#X floatatom 117 265 0 0 0; -#X floatatom 30 486 0 0 0; -#X floatatom 30 425 0 0 0; -#X floatatom 218 186 0 0 0; -#X floatatom 135 182 0 0 0; -#X obj 66 146 sin; -#X floatatom 66 53 0 0 0; -#X floatatom 66 180 0 0 0; -#X obj 66 113 * 6.28319; -#X obj 66 83 / 360; -#X obj 135 148 cos; -#X obj 218 152 tan; -#X obj 30 456 sqrt; -#X obj 117 296 atan; -#X obj 117 456 log; -#X obj 185 456 exp; -#X obj 281 456 abs; -#X obj 226 290 float; -#X obj 283 290 t b f; -#X obj 226 319 atan2; -#X text 87 17 Higher math in Pd; -#X text 171 58 trig functions take inputs in radians; -#X text 24 213 The arc tangent takes two forms. The atan2 version takes an (x \, y) pair and gives you an output between -pi and pi.; -#X text 23 380 also \, square root \, natural logarithm and exponential \, and absolute value:; -#X text 292 529 updated for Pd version 0.33; -#X connect 0 0 28 0; -#X connect 2 0 27 0; -#X connect 4 0 26 0; -#X connect 6 0 25 0; -#X connect 8 0 24 0; -#X connect 10 0 23 0; -#X connect 12 0 22 0; -#X connect 15 0 17 0; -#X connect 16 0 19 0; -#X connect 18 0 15 0; -#X connect 18 0 20 0; -#X connect 18 0 21 0; -#X connect 19 0 18 0; -#X connect 20 0 14 0; -#X connect 21 0 13 0; -#X connect 22 0 11 0; -#X connect 23 0 9 0; -#X connect 24 0 7 0; -#X connect 25 0 5 0; -#X connect 26 0 3 0; -#X connect 27 0 29 0; -#X connect 28 0 27 0; -#X connect 28 1 29 1; -#X connect 29 0 1 0; +#N canvas 406 25 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 (math_functions) +3 12 0 18 -204280 -1 0; +#X obj 0 315 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 488 281 494 344 META 0; +#X text 12 85 LIBRARY internal; +#X text 12 125 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 45 LICENSE SIBSD; +#X text 12 105 AUTHOR Miller Puckette; +#X text 12 165 HELP_PATCH_AUTHORS This document was updated for Pd +version 0.35 test 28 by Dave Sabine as part of a project called pddp +proposed by Krzysztof Czaja to build comprehensive documentation for +Pd. Revised by Jonathan Wilkes to conform to the PDDP template.; +#X text 12 65 DESCRIPTION higher math in Pd; +#X text 12 5 NAME sin cos tan atan atan2 exp log abs sqrt pow; +#X text 12 145 RELEASE_DATE 1997; +#X text 12 25 KEYWORDS control trigonometry; +#X restore 500 597 pd META; +#X obj 0 438 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 474 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 522 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 219 515 428 109 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 (math) Related Objects; +#X obj 22 42 osc~; +#X obj 58 42 cos~; +#X obj 96 42 exp~; +#X obj 134 42 log~; +#X obj 172 42 abs~; +#X obj 210 42 sqrt~; +#X obj 254 42 pow~; +#X restore 102 598 pd Related_objects; +#X obj 78 324 cnv 17 3 60 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 323 float; +#X text 98 342 list; +#X text 98 446 float; +#X obj 78 447 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 11 23 higher math in Pd; +#X obj 249 12 sin; +#X obj 275 12 cos; +#X obj 301 12 tan; +#X obj 328 12 atan; +#X obj 361 12 atan2; +#X obj 401 12 exp; +#X obj 429 12 log; +#X obj 456 12 abs; +#X obj 484 12 sqrt; +#X obj 519 12 pow; +#X obj 72 117 sin; +#X floatatom 72 91 5 0 0 0 - - -, f 5; +#X floatatom 72 144 5 0 0 0 - - -, f 5; +#X text 168 323 - the incoming value; +#X text 168 342 - a list will be truncated.; +#X text 168 446 - the outgoing value.; +#X text 98 478 The [pow] object accepts one float argument to initialize +the right inlet. All other math functions listed here take no arguments. +; +#X text 217 541 - binary arithmetic operators; +#X obj 98 541 pddp/pddplink operators-help.pd; +#X text 217 561 - relational and logical operators; +#X obj 98 561 pddp/pddplink otherbinops-help.pd; +#X text 98 359 (The [pow] object takes a bang \, which will output +the previous value.); +#X text 97 393 (Note: The [atan2] and [pow] objects have a right inlet. +See their respective help patches (links above) for more info.); +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X floatatom 142 91 5 0 0 0 - - -, f 5; +#X floatatom 142 144 5 0 0 0 - - -, f 5; +#X floatatom 212 91 5 0 0 0 - - -, f 5; +#X floatatom 212 144 5 0 0 0 - - -, f 5; +#X floatatom 282 91 5 0 0 0 - - -, f 5; +#X floatatom 282 144 5 0 0 0 - - -, f 5; +#X floatatom 352 91 5 0 0 0 - - -, f 5; +#X floatatom 352 144 5 0 0 0 - - -, f 5; +#X floatatom 72 201 5 0 0 0 - - -, f 5; +#X floatatom 72 254 5 0 0 0 - - -, f 5; +#X floatatom 142 201 5 0 0 0 - - -, f 5; +#X floatatom 142 254 5 0 0 0 - - -, f 5; +#X floatatom 212 201 5 0 0 0 - - -, f 5; +#X floatatom 212 254 5 0 0 0 - - -, f 5; +#X floatatom 282 201 5 0 0 0 - - -, f 5; +#X floatatom 282 254 5 0 0 0 - - -, f 5; +#X floatatom 352 201 5 0 0 0 - - -, f 5; +#X floatatom 352 254 5 0 0 0 - - -, f 5; +#X obj 142 117 cos; +#X obj 212 117 tan; +#X obj 282 117 atan; +#X obj 352 117 atan2; +#X obj 72 227 exp; +#X obj 142 227 log; +#X obj 212 227 abs; +#X obj 282 227 sqrt; +#X obj 352 227 pow; +#X floatatom 392 201 5 0 0 0 - - -, f 5; +#X floatatom 392 91 5 0 0 0 - - -, f 5; +#X floatatom 442 201 5 0 0 0 - - -, f 5; +#X floatatom 442 254 5 0 0 0 - - -, f 5; +#X obj 442 227 wrap; +#X connect 24 0 26 0; +#X connect 25 0 24 0; +#X connect 38 0 56 0; +#X connect 40 0 57 0; +#X connect 42 0 58 0; +#X connect 44 0 59 0; +#X connect 46 0 60 0; +#X connect 48 0 61 0; +#X connect 50 0 62 0; +#X connect 52 0 63 0; +#X connect 54 0 64 0; +#X connect 56 0 39 0; +#X connect 57 0 41 0; +#X connect 58 0 43 0; +#X connect 59 0 45 0; +#X connect 60 0 47 0; +#X connect 61 0 49 0; +#X connect 62 0 51 0; +#X connect 63 0 53 0; +#X connect 64 0 55 0; +#X connect 65 0 64 1; +#X connect 66 0 59 1; +#X connect 67 0 69 0; +#X connect 69 0 68 0; diff --git a/doc/pddp/max-help.pd b/pd/doc/5.reference/max-help.pd similarity index 100% rename from doc/pddp/max-help.pd rename to pd/doc/5.reference/max-help.pd diff --git a/pd/doc/5.reference/message-help.pd b/pd/doc/5.reference/message-help.pd index 5823473ce..643d80b7e 100644 --- a/pd/doc/5.reference/message-help.pd +++ b/pd/doc/5.reference/message-help.pd @@ -1,67 +1,289 @@ -#N canvas 70 162 648 546 12; -#X msg 67 10 message boxes; -#X text 34 33 Message boxes hold one or more message. Anytime the message -box receives any message at all \, the messages in the box are all -sent to their destinations.; -#X obj 120 295 print; -#X msg 120 235 60 64; -#X msg 120 265 pitch \$1 \, velocity \$2; -#X msg 49 378 123 \; my-receiver-name 858 \; another-receiver -45; -#X text 34 81 Clicking on a message also sends it \, so you can use -messsage boxes for push buttins. For instance \, click here while watching -the printout window:; -#X msg 122 139 walk the dog; -#X obj 122 168 print; -#X text 239 139 <--- message; -#X text 223 165 <--- object (different border); -#X text 14 197 You can separate multiple messages by commas. Also \, -you can use "$1" \, "$2" \, etc. to make variable messages:; -#X text 14 323 Finally \, if you separate messages by a semicolon instead -of a comma \, the following message(s) are re-routed to named objects -such as "receives":; -#X obj 49 433 print; -#X obj 253 378 receive my-receiver-name; -#X floatatom 253 402 0 0 0 0 - - -; -#X floatatom 252 449 0 0 0 0 - - -; -#X obj 252 425 receive another-receiver; -#X text 396 519 updated for Pd version 0.39; -#X text 19 471 You can send messages to message boxes to change their -content - open the subpatch below for details:; -#N canvas 0 0 718 466 changing-messages 0; -#X msg 55 380 dog bird monkey \; bird; -#X msg 58 69 set dog; -#X msg 75 143 add monkey; -#X msg 77 188 add2 bird; -#X msg 72 117 set; -#X text 92 29 Messages to change contents of messages boxes:; -#X msg 66 92 set 1 2 3 skidoo; -#X text 236 120 "set" with no arguments clears it; -#X text 240 75 "set" to set contents (numbers and/or symbols); -#X text 180 146 "add" to add numbers and/or symbols \, plus a terminating -semicolon; -#X text 168 190 "add2" to add contents without the terminating semicolon +#N canvas 420 26 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 message 3 12 0 18 +-204280 -1 0; +#X obj 0 189 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 485 287 494 344 META 0; +#X text 12 125 LIBRARY internal; +#X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 35 LICENSE SIBSD; +#X text 12 145 AUTHOR Miller Puckette; +#X text 12 205 HELP_PATCH_AUTHORS Updated for Pd version 0.39. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 75 INLET_0 anything set add add2 addcomma addsemi adddollar +adddollsym; +#X text 12 105 OUTLET_0 anything; +#X text 12 55 DESCRIPTION clickable message box; +#X text 12 5 KEYWORDS control GUI nonlocal symbol_op list_op anything_op +bang_op; +#X text 12 185 RELEASE_DATE 1997; +#X restore 500 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 385 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 555 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 219 520 428 109 Related_objects 0; +#X obj 116 43 list; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X msg 12 3; +#X text 40 2 Related Objects; +#X obj 22 43 symbol; +#X obj 72 43 float; +#X restore 102 597 pd Related_objects; +#X obj 78 198 cnv 17 3 127 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 343 cnv 17 3 35 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X msg 514 11; +#X msg 101 141 walk the dog; +#X obj 101 164 print; +#N canvas 75 14 431 608 dollarsign_variables 0; +#X obj 23 156 print; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X msg 12 2; +#X text 40 2 Dollarsign Variables in Message Boxes; +#X msg 23 131 pitch \$3; +#X text 115 106 a list with three numbers; +#X msg 23 106 list 24 48 72; +#X text 83 131 replace "\$3" with the third element; +#X text 84 145 of the incoming message ("72"); +#X msg 23 236 24 48 72; +#X text 83 236 implicit list with three numbers; +#X msg 23 259 pitch \$3; +#X obj 23 281 print; +#X text 83 259 third element is still "72"; +#X text 20 303 It's important to note that you can't access the selector +of the message using the dollarsign variables. (In the patch above +\, "list" is the selector \, "24" is the first element \, and so on.) +Keep this in mind when using custom selectors \, as in the following: +; +#X msg 23 373 melody 67 67 67 63; +#X text 153 374 In this message \, "melody" is the selector \,; +#X text 153 389 and there are four elements (not five).; +#X msg 23 407 pitch \$4; +#X obj 23 490 print; +#X text 85 407 replace "\$4" with the fourth element ("63"); +#X msg 41 459 pitch \$5; +#X msg 41 433 melody 65 65 65 62; +#X text 163 438 this will output an error--; +#X text 163 452 there is no 5th element!; +#X text 20 180 Remember that the selectors "list" and "float" can be +omitted when the first atom in a message is a float. For example \, +the following still works exactly as the patch above:; +#X text 21 514 Multiple dollarsign variables may be used together: ; -#X msg 83 222 addcomma; -#X msg 82 248 addsemi; -#X msg 78 305 adddollsym 4-foo; -#X msg 84 275 adddollar 3; -#X text 174 225 add a comma; -#X text 173 244 add a semicolon; -#X text 199 275 add a dollar-sign argument; -#X text 235 305 add a dollar-sign-plus-symbol argument; -#X connect 1 0 0 0; -#X connect 2 0 0 0; -#X connect 3 0 0 0; +#X obj 25 576 print; +#X msg 25 533 22 8 1791; +#X msg 25 555 \$1-\$2-\$3.wav; +#X text 20 38 You can use "dollarsign variables" to make variable messages. +Just use a dollarsign followed by a number-- "\$1" \, "\$2" \, etc. +The numbers (starting from one) specify which element of the incoming +message should replace the variable in the outgoing message.; #X connect 4 0 0 0; -#X connect 6 0 0 0; -#X connect 11 0 0 0; -#X connect 12 0 0 0; -#X connect 13 0 0 0; -#X connect 14 0 0 0; -#X restore 153 512 pd changing-messages; +#X connect 6 0 4 0; +#X connect 9 0 11 0; +#X connect 11 0 12 0; +#X connect 15 0 18 0; +#X connect 18 0 19 0; +#X connect 21 0 19 0; +#X connect 22 0 21 0; +#X connect 28 0 29 0; +#X connect 29 0 27 0; +#X restore 171 457 pd dollarsign_variables; +#X text 11 23 clickable message box; +#X text 98 197 bang; +#X text 98 211 float; +#X text 98 225 symbol; +#X text 98 239 pointer; +#X text 98 254 anything; +#X text 168 197 - these message types will cause the message box to +send its message as output.; +#N canvas 50 89 428 405 messages_for_changing_the_content_of_a_message_box +0; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X msg 12 3; +#X text 40 2 Changing Messages; +#X msg 23 76 set dog; +#X msg 43 150 add monkey; +#X msg 48 195 add2 bird; +#X msg 37 124 set; +#X msg 31 99 set 1 2 3 skidoo; +#X text 71 124 "set" with no arguments clears it; +#X text 85 77 "set" to set contents (numbers and/or symbols); +#X msg 52 229 addcomma; +#X msg 56 255 addsemi; +#X msg 60 312 adddollsym 4-foo; +#X msg 59 282 adddollar 3; +#X text 118 229 add a comma; +#X text 118 254 add a semicolon; +#X text 137 282 add a dollar-sign argument; +#X text 167 312 add a dollar-sign-plus-symbol argument; +#X text 20 37 The following messages may be used to change contents +of messages boxes:; +#X text 118 165 plus a terminating semicolon; +#X text 117 151 "add" to add numbers and/or symbols \,; +#X text 118 209 the terminating semicolon; +#X text 117 195 "add2" to add contents without; +#X msg 23 357; +#X connect 3 0 23 0; +#X connect 4 0 23 0; +#X connect 5 0 23 0; +#X connect 6 0 23 0; +#X connect 7 0 23 0; +#X connect 10 0 23 0; +#X connect 11 0 23 0; +#X connect 12 0 23 0; +#X connect 13 0 23 0; +#X restore 101 308 pd messages_for_changing_the_content_of_a_message_box +; +#X text 98 342 anything; +#X text 168 342 - a message box will output its message (replacing +any dollar-sign variables with the relevant elements of the incoming +message).; +#X text 100 476 comma; +#X text 100 513 semicolon; +#N canvas 88 49 428 453 Using_Commas_in_Message_Boxes 0; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X msg 12 3; +#X text 40 2 About Commas and Semicolons; +#X obj 23 136 list length; +#X floatatom 23 164 5 0 0 3 No_of_atoms - -, f 5; +#X obj 23 94 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 -1 +-1; +#X obj 23 114 list append one \, 3; +#X text 141 115 This list actually contains three atoms:; +#X text 141 135 1) The symbol "one"; +#X text 141 165 3) The float "3"; +#X text 20 37 Even though they are not be separated by whitespace \, +semicolons and commas are actually atoms in Pd-- just like float- and +symbol-atoms. You can see this clearly in the example below:; +#X text 43 92 <- Click to test; +#X msg 22 281 Because I do not hope to turn again \, Because I do not +hope; +#X obj 22 303 print from_Ash_Wednesday; +#X text 20 210 In message boxes \, commas and semicolons are used to +separate one message from another. For example \, there are two messages +in the message box below. Each is sent separately to the [print] object +(in the order they were written):; +#X msg 23 376 1 \, 2 \, 3; +#X obj 23 398 + 10; +#X obj 23 422 print sum; +#X text 20 329 Notice that the comma itself is not included as part +of the message-- it simply tells Pd where one message ends \, and the +next begins.; +#X text 141 150 2) A comma; #X connect 3 0 4 0; -#X connect 4 0 2 0; -#X connect 5 0 13 0; +#X connect 5 0 6 0; +#X connect 6 0 3 0; +#X connect 12 0 13 0; +#X connect 15 0 16 0; +#X connect 16 0 17 0; +#X restore 172 495 pd Using_Commas_in_Message_Boxes; +#N canvas 82 29 428 495 Using_Semicolons_In_Message_Boxes 0; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X msg 12 3; +#X obj 24 362 print; +#X obj 228 291 receive my-receiver-name; +#X floatatom 228 315 0 0 0 0 - - -; +#X floatatom 227 362 0 0 0 0 - - -; +#X obj 227 338 receive another-receiver; +#X obj 23 191 receive msg2r; +#X obj 23 217 print after_semi; +#X obj 23 159 print before_semi; +#X msg 24 291 \; my-receiver-name 858 \; another-receiver -45; +#X text 40 2 About Semicolons and Nonlocal Sends; +#X msg 23 118 this msg comes out the outlet \; msg2r this msg comes +out of [receive msg2r]; +#X msg 201 441 \; pd dsp 1; +#X msg 25 441 dsp 1; +#X obj 25 468 s dsp; +#X text 85 451 is the same as; +#X text 22 396 For messages to a single named-object \, however \, +it is probably clearer to use a message box and a [send] object \, +but you can judge for yourself:; +#X text 20 37 Like commas \, semicolons may be used to send multiple +messages from a single message box. When using a semicolon \, however +\, the message following the semicolon is re-routed to a named object +\, such as [receive] \, an array \, or a canvas. The named object is +specified by the selector of the message ("msg2r" in this example): +; +#X text 22 246 To send messages to named objects without first sending +a message to the outlet \, put an initial semicolon in the message +box:; +#X connect 3 0 4 0; +#X connect 6 0 5 0; #X connect 7 0 8 0; +#X connect 10 0 2 0; +#X connect 12 0 9 0; #X connect 14 0 15 0; -#X connect 17 0 16 0; +#X restore 172 532 pd Using_Semicolons_In_Message_Boxes; +#X text 168 254 - other messages will cause the message box to send +its message as output \, except for the "special messages" that are +used to change the content of a message box. Click the subpatch below +to view these "special messages":; +#X text 168 476 - a comma may be used to separate multiple messages: +; +#X text 178 513 - a semicolon may be used to send messages nonlocally: +; +#X text 168 402 - message boxes can contain any number of float and/or +symbol arguments. Message boxes may also contain special "dollar-sign +variables" \, used to grab data from an incoming message. Click the +subpatch below for more info:; +#X text 98 97 Clicking on a message also sends it \, so you can use +messsage boxes as push buttons. For instance \, click here while watching +the printout window:; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 100 559 pddp/pddplink all_about_messages.pd -text all_about_messages +; +#X obj 100 574 pddp/pddplink all_about_symbol_construction.pd -text +all_about_symbol_construction; +#X obj 286 559 pddp/pddplink ../2.control.examples/04.messages.pd -text +doc/2.control.examples/04.messages.pd; +#X obj 286 574 pddp/pddplink ../2.control.examples/10.more.messages.pd +-text doc/2.control.examples/10.more.messages.pd; +#X text 331 10 To create \, click <Control-2>; +#X text 98 57 Message boxes hold one or more messages. Anytime the +message box receives any message at all \, the messages in the box +are all sent to their destinations.; +#X text 188 141 <- message box; +#X text 141 164 <- object box (notice the different border); +#X text 81 402 n) symbol atom; +#X text 100 417 float; +#N canvas 423 174 432 262 \$0_variable 0; +#X obj 24 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 +0 14 -204280 -1 0; +#X msg 35 2; +#X text 63 2 \$0 Variable in Message Boxes; +#X msg 40 92 \$0; +#X text 39 38 Special case available in pd-l2ork is the \$0 variable +which resolves into canvas instance number \, just like placing such +a variable inside a regular object.; +#X floatatom 40 114 5 0 0 0 - - -, f 5; +#X text 68 92 <--click on this message; +#X obj 242 92 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 -1 +-1; +#X obj 242 112 \$0; +#X floatatom 242 134 5 0 0 0 - - -, f 5; +#X text 261 92 <--compare to this; +#X floatatom 40 178 5 0 0 0 - - -, f 5; +#X msg 40 199 \$1 \$0; +#X obj 40 221 print; +#X text 80 199 <--works in any order; +#X connect 3 0 5 0; +#X connect 7 0 8 0; +#X connect 8 0 9 0; +#X connect 11 0 12 0; +#X connect 12 0 13 0; +#X restore 318 457 pd \$0_variable; +#X connect 11 0 12 0; diff --git a/doc/pddp/metro-help.pd b/pd/doc/5.reference/metro-help.pd similarity index 100% rename from doc/pddp/metro-help.pd rename to pd/doc/5.reference/metro-help.pd diff --git a/pd/doc/5.reference/midi-help.pd b/pd/doc/5.reference/midi-help.pd index 4b7316884..58edae652 100644 --- a/pd/doc/5.reference/midi-help.pd +++ b/pd/doc/5.reference/midi-help.pd @@ -1,129 +1,100 @@ -#N canvas 68 50 876 553 12; -#X floatatom 318 379 0 0 0; -#X floatatom 282 468 0 0 0; -#X floatatom 200 469 0 0 0; -#X text 96 330 off; -#X floatatom 52 383 0 0 0; -#X floatatom 70 134 0 0 0; -#X obj 34 108 notein; -#X floatatom 34 134 0 0 0; -#X obj 52 488 noteout; -#X obj 52 462 makenote 64 250; -#X obj 52 409 metro 500; -#X msg 52 356 1; -#X msg 84 356 0; -#X text 52 333 on; -#X msg 52 436 60; -#X obj 200 496 pgmout; -#X obj 282 494 bendout; -#X floatatom 416 379 0 0 0; -#X floatatom 197 136 0 0 0; -#X floatatom 145 136 0 0 0; -#X text 41 79 omni; -#X floatatom 106 134 0 0 0; -#X obj 145 109 notein 1; -#X text 145 85 channel 1; -#X text 194 17 MIDI I/O objects; -#X text 85 54 notes; -#X text 334 47 control change; -#X text 264 69 everything; -#X floatatom 309 137 0 0 0; -#X floatatom 271 137 0 0 0; -#X floatatom 347 136 0 0 0; -#X obj 271 110 ctlin; -#X floatatom 440 138 0 0 0; -#X floatatom 396 138 0 0 0; -#X obj 396 111 ctlin 7; -#X text 364 71 specific controller number; -#X text 410 88 omni; -#X text 496 89 channel 1; -#X floatatom 493 140 0 0 0; -#X obj 493 114 ctlin 7 1; -#X obj 61 221 pgmin; -#X floatatom 97 248 0 0 0; -#X floatatom 61 248 0 0 0; -#X floatatom 197 250 0 0 0; -#X floatatom 161 250 0 0 0; -#X floatatom 307 253 0 0 0; -#X floatatom 272 253 0 0 0; -#X floatatom 382 255 0 0 0; -#X floatatom 343 253 0 0 0; -#X floatatom 420 256 0 0 0; -#X obj 161 222 bendin; -#X obj 272 226 touchin; -#X obj 343 227 polytouchin; -#X text 49 167 these can also take an optional channel number as argument but by default are omni:; -#X text 32 197 program change; -#X text 155 198 pitch bend; -#X text 271 203 channel and poly aftertouch; -#X floatatom 191 380 0 0 0; -#X floatatom 224 380 0 0 0; -#X floatatom 260 382 0 0 0; -#X obj 191 407 ctlout; -#X obj 318 406 ctlout 7; -#X text 192 349 control out; -#X text 314 353 control 7; -#X text 409 354 control 7 \, channel 4; -#X obj 416 406 ctlout 7 4; -#X text 101 277 outputs work similarly. They all take an optional channel as creation argument \, and ctlin takes a control number and a channel. You get inlets to change them in any case. IF you specify no channel \, it's channel 1; -#X floatatom 355 467 0 0 0; -#X floatatom 440 466 0 0 0; -#X obj 355 493 touchout; -#X obj 440 492 polytouchout; -#X floatatom 479 467 0 0 0; -#X floatatom 520 467 0 0 0; -#X obj 625 218 midiin; -#X floatatom 625 249 0 0 0; -#X floatatom 656 249 0 0 0; -#X floatatom 695 249 0 0 0; -#X floatatom 726 250 0 0 0; -#X text 590 155 These two are always omni and; -#X text 590 174 output the port number instead; -#X text 594 192 of the channel:; -#X obj 697 218 sysexin; -#X obj 623 472 midiout; -#X text 571 413 use this to output raw MIDI; -#X text 566 433 (the second inlet is the port; -#X text 569 451 number.); -#X text 625 514 updated for Pd release 0.33; -#X connect 0 0 61 0; -#X connect 1 0 16 0; -#X connect 2 0 15 0; -#X connect 4 0 10 0; -#X connect 6 0 7 0; -#X connect 6 1 5 0; -#X connect 6 2 21 0; -#X connect 9 0 8 0; -#X connect 9 1 8 1; -#X connect 10 0 14 0; -#X connect 11 0 4 0; -#X connect 12 0 4 0; -#X connect 14 0 9 0; -#X connect 17 0 65 0; -#X connect 22 0 19 0; -#X connect 22 1 18 0; -#X connect 31 0 29 0; -#X connect 31 1 28 0; -#X connect 31 2 30 0; -#X connect 34 0 33 0; -#X connect 34 1 32 0; -#X connect 39 0 38 0; -#X connect 40 0 42 0; -#X connect 40 1 41 0; -#X connect 50 0 44 0; -#X connect 50 1 43 0; -#X connect 51 0 46 0; -#X connect 51 1 45 0; -#X connect 52 0 48 0; -#X connect 52 1 47 0; -#X connect 52 2 49 0; -#X connect 57 0 60 0; -#X connect 58 0 60 1; -#X connect 59 0 60 2; -#X connect 67 0 69 0; -#X connect 68 0 70 0; -#X connect 71 0 70 1; -#X connect 72 0 70 2; -#X connect 73 0 74 0; -#X connect 73 1 75 0; -#X connect 81 0 76 0; +#N canvas 430 38 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 (MIDI) 3 12 0 18 +-204280 -1 0; +#X obj 0 288 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 489 291 494 344 META 0; +#X text 12 105 LIBRARY internal; +#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 65 LICENSE SIBSD; +#X text 12 125 AUTHOR Miller Puckette; +#X text 12 185 HELP_PATCH_AUTHORS Updated for Pd v0.41. Revised by +Jonathan Wilkes to conform to the PDDP template for Pd version 0.42. +; +#X text 12 45 KEYWORDS control MIDI; +#X text 12 85 DESCRIPTION MIDI input/output objects; +#X text 12 5 NAME bendin ctlin midiin notein pgmin polytouchin sysexin +touchin bendout ctlout midiout noteout pgmout polytouchout touchout +; +#X text 12 165 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 495 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 538 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 566 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#X text 98 542 (none); +#N canvas 217 519 428 109 Related_objects 0; +#X obj 62 43 makenote; +#X obj 22 43 poly; +#X obj 123 43 list; +#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 (MIDI) Related Objects; +#X restore 102 598 pd Related_objects; +#X obj 79 297 cnv 17 3 130 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 296 float; +#X text 98 353 list; +#X text 98 503 float; +#X obj 79 504 cnv 17 3 30 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 79 440 cnv 17 3 45 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X text 98 439 float; +#X text 98 383 flush; +#X text 98 413 clear; +#X text 168 383 - output all values one by one \, in the order they +were received \, and clear the collection.; +#X text 168 503 - upon sending the "flush" message to the left inlet +\, [bag] will output each value in the order it was received.; +#X text 168 353 - a (value \, flag) pair is distributed to the two +inlets. Lists with more than two elements will be truncated.; +#X text 168 413 - clear the collection.; +#X text 167 439 - a float to the right inlet sets the "flag": if zero +\, values to the left inlet will not be added to the collection. If +nonzero \, values to the right inlet will be added to the collection. +; +#X text 168 296 - a float to the left inlet will be added to the collection +if the last value the right inlet received was nonzero. If the last +value the right inlet received was zero \, the float sent to the right +inlet will be removed from the collection.; +#X text 11 23 MIDI input/output objects; +#X obj 86 86 bendin; +#X obj 86 123 bendout; +#X obj 131 86 ctlin; +#X obj 137 123 ctlout; +#X obj 215 86 notein; +#X obj 233 123 noteout; +#X obj 260 86 pgmin; +#X obj 284 123 pgmout; +#X obj 425 86 touchin; +#X obj 299 86 polytouchin; +#X obj 170 86 midiin; +#X obj 374 86 sysexin; +#X obj 182 123 midiout; +#X obj 329 123 polytouchout; +#X obj 410 123 touchout; +#X text 10 86 MIDI input:; +#X text 10 123 MIDI output:; +#X obj 320 185 pddp/pddplink touchin-help.pd; +#X obj 243 185 touchin; +#X obj 243 210 polytouchin; +#X obj 320 210 pddp/pddplink polytouchin-help.pd; +#X obj 243 235 touchout; +#X obj 320 235 pddp/pddplink touchout-help.pd; +#X obj 243 260 polytouchout; +#X obj 320 260 pddp/pddplink polytouchout-help.pd; +#X obj 80 185 midiin; +#X obj 80 235 sysexin; +#X obj 80 210 midiout; +#X obj 135 185 pddp/pddplink midiin-help.pd; +#X obj 135 235 pddp/pddplink sysexin-help.pd; +#X obj 135 210 pddp/pddplink midiout-help.pd; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X text 77 151 Right-click the objects above and choose "Help" \, or +follow the links below for help on these objects:; diff --git a/doc/pddp/midiin-help.pd b/pd/doc/5.reference/midiin-help.pd similarity index 100% rename from doc/pddp/midiin-help.pd rename to pd/doc/5.reference/midiin-help.pd diff --git a/doc/pddp/midiout-help.pd b/pd/doc/5.reference/midiout-help.pd similarity index 100% rename from doc/pddp/midiout-help.pd rename to pd/doc/5.reference/midiout-help.pd diff --git a/doc/pddp/min-help.pd b/pd/doc/5.reference/min-help.pd similarity index 100% rename from doc/pddp/min-help.pd rename to pd/doc/5.reference/min-help.pd diff --git a/pd/doc/5.reference/moses-help.pd b/pd/doc/5.reference/moses-help.pd index c1f23c909..758748bd5 100644 --- a/pd/doc/5.reference/moses-help.pd +++ b/pd/doc/5.reference/moses-help.pd @@ -1,17 +1,120 @@ -#N canvas 0 0 624 300 12; -#X obj 72 196 moses 10; -#X floatatom 72 164 4 0 0; -#X floatatom 139 167 4 0 0; -#X floatatom 72 229 4 0 0; -#X floatatom 139 230 4 0 0; -#X obj 63 24 moses; -#X text 118 23 - part a stream of numbers; -#X text 303 235 updated for Pd version 0.33; -#X text 24 64 Moses takes numbers and outputs them at left if they're +#N canvas 429 36 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 moses 3 12 0 18 +-204280 -1 0; +#X obj 0 302 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 486 245 494 384 META 0; +#X text 12 145 LIBRARY internal; +#X text 12 185 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 205 RELEASE_DATE 2009-06-12; +#X text 12 25 LICENSE SIBSD; +#X text 12 165 AUTHOR Miller Puckette; +#X text 12 225 HELP_PATCH_AUTHORS This help patch was updated for Pd +version 0.35 test 26 by Dave Sabine as part of a project called pddp +proposed by Krzysztof Czaja to build comprehensive documentation for +Pd. Jonathan Wilkes revised the patch to conform to the PDDP template +for Pd version 0.42.; +#X text 12 5 KEYWORDS control filter; +#X text 12 45 DESCRIPTION part a stream of numbers; +#X text 12 65 INLET_0 float list; +#X text 12 85 INLET_1 float; +#X text 12 105 OUTLET_0 float; +#X text 12 125 OUTLET_1 float; +#X restore 500 597 pd META; +#X obj 0 410 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 498 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 539 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 220 367 428 256 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 [moses] Related Objects; +#X text 19 168 The best places to find information about Pd's libraries +is:; +#X text 19 190 www.puredata.org and click on "Downloads" then "Software" +; +#X text 20 206 or; +#X text 19 221 iem.kug.ac.at/pdb/; +#X text 20 119 Externals are offered in Pd only if you have downloaded +and properly installed the appropriate library. These objects may or +may not exist in a single library.; +#X obj 22 42 list split; +#X text 20 80 Externals; +#X obj 20 98 pddp/helplink cyclone/split; +#X restore 102 597 pd Related_objects; +#X obj 78 311 cnv 17 3 65 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 310 float; +#X text 98 350 list; +#X text 98 418 float; +#X obj 78 419 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 382 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X text 98 381 float; +#X obj 506 11 moses; +#X floatatom 68 143 4 0 0 0 - - -, f 4; +#X floatatom 124 142 4 0 0 0 - - -, f 4; +#X floatatom 68 196 4 0 0 0 - - -, f 4; +#X floatatom 121 196 4 0 0 0 - - -, f 4; +#X text 65 66 Moses takes numbers and outputs them at left if they're less than a control value \, and at right if they're greater or equal to it. The creation argument initializes the control value (10 in this example) and the right inlet changes it.; -#X connect 0 0 3 0; -#X connect 0 1 4 0; -#X connect 1 0 0 0; -#X connect 2 0 0 1; +#N canvas 103 360 428 202 More_info 0; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X obj 22 146 moses 0; +#X floatatom 22 170 5 0 0 0 - - -, f 5; +#X floatatom 65 170 5 0 0 0 - - -, f 5; +#X floatatom 22 124 5 0 0 0 - - -, f 5; +#X text 20 38 One way to think of [moses] is as a filter. For the following +example \, imagine that [moses] works as a low pass and high pass filter +simoultaneously -- for non-audio signals. Below you will see that negative +numbers will pass through the left outlet while positive numbers will +pass through the right outlet.; +#X text 8 2 [moses] More Info; +#X connect 1 0 2 0; +#X connect 1 1 3 0; +#X connect 4 0 1 0; +#X restore 102 548 pd More_info; +#X text 167 381 - a float to the right inlet sets the control value. +; +#X text 98 453 float; +#X obj 78 454 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X text 168 453 - incoming values (to the left inlet) will pass at +the right outlet if they are greater than or equal to the control value. +; +#X obj 68 169 moses 10; +#X text 224 179 The control value may be a float or integer. Try shift-scrolling: +; +#X floatatom 327 221 5 0 0 0 - - -, f 5; +#X floatatom 327 267 5 0 0 0 - - -, f 5; +#X obj 327 244 moses 1.5; +#X floatatom 378 267 5 0 0 0 - - -, f 5; +#X text 11 23 part a stream of numbers; +#X text 168 350 - a two element list is distributed to the two inlets. +Lists with more than two elements will be truncated.; +#X text 168 516 - (optional) initializes the control value.; +#X text 168 418 - incoming values (to the left inlet) will pass at +the left outlet if they are less than the control value.; +#X text 81 516 1) float; +#X text 168 310 - if the float the left inlet is less than the control +value \, it passes at the left inlet. If it is greater than or equal +to the control value it passes at the right inlet.; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 100 568 pddp/pddplink ../2.control.examples/18.conditional.pd +-text doc/2.control.examples/18.conditional.pd; +#X connect 16 0 26 0; +#X connect 17 0 26 1; +#X connect 26 0 18 0; +#X connect 26 1 19 0; +#X connect 28 0 30 0; +#X connect 30 0 29 0; +#X connect 30 1 31 0; diff --git a/doc/pddp/mtof-help.pd b/pd/doc/5.reference/mtof-help.pd similarity index 100% rename from doc/pddp/mtof-help.pd rename to pd/doc/5.reference/mtof-help.pd diff --git a/doc/pddp/mtof~-help.pd b/pd/doc/5.reference/mtof~-help.pd similarity index 100% rename from doc/pddp/mtof~-help.pd rename to pd/doc/5.reference/mtof~-help.pd diff --git a/pd/doc/5.reference/my_canvas-help.pd b/pd/doc/5.reference/my_canvas-help.pd index 65f9976fe..0d3bb8686 100644 --- a/pd/doc/5.reference/my_canvas-help.pd +++ b/pd/doc/5.reference/my_canvas-help.pd @@ -1,260 +1,748 @@ -#N canvas 0 22 500 292 10; -#X obj 1 1 cnv 15 300 60 foo10_snd foo10_rcv my_canvas=cnv 63 37 0 -17 -257472 -355 0; -#X text 4 232 (c) musil@iem.kug.ac.at; -#X text 46 245 IEM KUG; -#N canvas 219 100 699 530 edit 0; -#X obj 39 226 f; -#X msg 17 205 bang; -#X floatatom 55 204 3 63 88 0 - - -; -#X floatatom 90 226 3 0 37 0 - - -; -#X obj 39 249 pack 0 0; -#X text 117 226 y-label; -#X text 83 204 x-label; -#X obj 297 281 f; -#X msg 275 260 bang; -#X floatatom 313 259 3 -10 10 0 - - -; -#X floatatom 348 281 3 -10 10 0 - - -; -#X obj 297 304 pack 0 0; -#X obj 309 396 f; -#X msg 287 375 bang; -#X floatatom 325 374 3 20 60 0 - - -; -#X floatatom 360 396 3 150 200 0 - - -; -#X obj 309 419 pack 0 0; -#X text 341 259 x-delta; -#X text 375 281 y-delta; -#X text 353 374 x-position; -#X text 387 396 y-position; -#X obj 59 341 f; -#X msg 37 320 bang; -#X floatatom 75 319 3 0 2 0 - - -; -#X floatatom 110 341 3 4 36 0 - - -; -#X obj 59 364 pack 0 0; -#X text 103 319 font; -#X text 139 341 height; -#X floatatom 275 183 3 2 20 0 - - -; -#X msg 52 137 \; foo10_rcv color \$1 \$2; -#X msg 39 274 \; foo10_rcv label_pos \$1 \$2; -#X msg 59 390 \; foo10_rcv label_font \$1 \$2; -#X msg 36 430 \; foo10_rcv label blabla; -#X msg 36 466 \; foo10_rcv label my_canvas; -#X msg 309 444 \; foo10_rcv pos \$1 \$2; -#X msg 297 329 \; foo10_rcv delta \$1 \$2; -#X obj 505 234 f; -#X msg 483 213 bang; -#X floatatom 521 212 5 100 1000 0 - - -; -#X floatatom 556 234 4 50 500 0 - - -; -#X obj 505 257 pack 0 0; -#X text 566 212 width; -#X text 594 236 height; -#X msg 505 282 \; foo10_rcv vis_size \$1 \$2; -#X msg 275 211 \; foo10_rcv size \$1; -#X text 305 183 selectable size; -#X msg 483 156 \; foo10a_rcv receive foo10_rcv; -#X msg 483 119 \; foo10_rcv receive foo10a_rcv; -#X msg 482 29 \; foo10_rcv send foo10a_snd; -#X msg 482 67 \; foo10_rcv send foo10_snd; -#X msg 509 372 \; foo10_rcv get_pos; -#X obj 510 407 r foo10_snd; -#X obj 510 428 unpack 0 0; -#X floatatom 510 453 4 0 0 0 - - -; -#X floatatom 575 452 4 0 0 0 - - -; -#X text 490 452 x=; -#X text 557 452 y=; -#X obj 52 79 f; -#X msg 29 31 bang; -#X floatatom 68 29 3 0 29 0 - - -; -#X floatatom 103 47 3 0 29 0 - - -; -#X text 96 29 background; -#X text 131 48 label-color; -#X msg 290 25 back; -#X msg 290 49 label; -#X msg 252 25 bang; -#N canvas 15 207 606 448 RGB_____________ 0; -#X obj 97 56 inlet; -#X obj 262 53 inlet; -#X obj 339 55 inlet; -#X obj 405 56 inlet; -#X obj 97 270 bang; -#X msg 77 295 0; -#X msg 104 295 1; -#X obj 146 268 bang; -#X msg 132 295 0; -#X msg 160 295 1; -#X obj 265 313 spigot; -#X obj 312 313 spigot; -#X obj 249 385 outlet; -#X text 93 33 select; -#X text 267 28 red; -#X text 337 30 green; -#X text 409 30 blue; -#X obj 405 102 t b f; -#X obj 339 160 +; -#X obj 339 185 t b f; -#X obj 339 216 +; -#X obj 296 385 outlet; -#X obj 28 180 loadbang; -#X obj 296 361 f; -#X obj 249 361 f; -#X obj 262 79 * -65536; -#X obj 339 80 * -256; -#X obj 405 80 * -1; -#X obj 339 247 - 1; -#X obj 97 135 route back label bang; -#X obj 235 168 t b b b; -#X connect 0 0 29 0; -#X connect 1 0 25 0; -#X connect 2 0 26 0; -#X connect 3 0 27 0; +#N canvas 432 34 555 662 10; +#N canvas 93 78 450 511 let's-play-pong! 0; +#X obj 148 128 cnv 15 100 25 empty \$0-score Score:0 5 12 0 14 -233017 +-66577 0; +#X obj 14 29 cnv 5 5 60 \$0-ps \$0-pr empty 20 12 0 14 -1 -66577 0 +; +#X msg 257 112 delta 0 \$1; +#X msg 257 87 -5; +#X obj 68 48 tgl 16 0 empty empty Go! 19 8 0 10 -4034 -1 -1 0 1; +#X obj 337 158 r \$0-ps; +#X obj 337 180 unpack; +#X obj 370 202 v py; +#X obj 68 117 t b b b; +#X msg 107 164 \; \$1-br get_pos \; \$1-pr get_pos \;; +#X obj 425 6 cnv 5 5 500 empty empty empty 20 12 0 14 -1 -66577 0; +#X obj 257 158 r \$0-bs; +#X obj 290 202 v by; +#X obj 68 447 pack; +#X msg 145 340 1; +#X msg 178 340 -1; +#X obj 68 491 s \$0-br; +#X obj 87 297 sel 0 1 2 3 4 5; +#X msg 101 361 1; +#N canvas 574 158 450 300 drift 0; +#X obj 55 40 inlet; +#X obj 136 40 inlet; +#X obj 205 45 inlet; +#X obj 55 117 f; +#X obj 93 142 mod; +#X obj 55 164 sel 1; +#X obj 55 231 f 1; +#X obj 55 266 outlet; +#X msg 90 231 0; +#X obj 136 61 b; +#X obj 136 88 random 8; +#X obj 136 115 sel 0; +#X msg 130 137 1e+37; +#X obj 205 155 t a; +#X floatatom 13 147 5 0 0 0 - - -, f 5; +#X obj 93 118 + 1; +#X connect 0 0 3 0; +#X connect 1 0 9 0; +#X connect 2 0 13 0; +#X connect 3 0 5 0; +#X connect 3 0 14 0; +#X connect 3 0 15 0; +#X connect 4 0 3 1; +#X connect 5 0 6 0; +#X connect 5 1 8 0; +#X connect 6 0 7 0; +#X connect 8 0 7 0; +#X connect 9 0 10 0; +#X connect 10 0 11 0; +#X connect 11 0 12 0; +#X connect 11 1 4 1; +#X connect 12 0 4 1; +#X connect 13 0 6 1; +#X connect 15 0 4 0; +#X restore 95 427 pd drift; +#X obj 68 405 t a b; +#X obj 68 383 f 1; +#X msg 134 18 10 SLOW; +#X msg 134 35 7 MEDIUM; +#X obj 257 43 spigot; +#X obj 77 71 s \$0-k; +#X obj 310 10 r \$0-k; +#N canvas 0 0 450 300 score 0; +#X obj 84 59 inlet; +#X obj 84 113 f; +#X obj 120 113 + 1; +#X obj 84 86 b; +#X msg 84 152 label Score:\$1; +#X obj 84 179 s \$0-score; +#X obj 165 51 sel 0; +#X obj 165 78 0; +#X obj 210 92 loadbang; +#X msg 210 114 0; +#X obj 165 24 r play; +#X connect 0 0 3 0; +#X connect 1 0 2 0; +#X connect 1 0 4 0; +#X connect 2 0 1 1; +#X connect 3 0 1 0; #X connect 4 0 5 0; -#X connect 4 0 6 0; -#X connect 5 0 11 1; -#X connect 6 0 10 1; -#X connect 7 0 8 0; -#X connect 7 0 9 0; -#X connect 8 0 10 1; -#X connect 9 0 11 1; -#X connect 10 0 24 1; -#X connect 11 0 23 1; -#X connect 17 0 18 0; -#X connect 17 1 18 1; -#X connect 18 0 19 0; -#X connect 19 0 20 0; -#X connect 19 1 20 1; -#X connect 20 0 28 0; -#X connect 22 0 6 0; -#X connect 23 0 21 0; -#X connect 24 0 12 0; -#X connect 25 0 20 0; -#X connect 26 0 18 0; -#X connect 27 0 17 0; -#X connect 28 0 11 0; -#X connect 28 0 10 0; -#X connect 29 0 4 0; -#X connect 29 1 7 0; -#X connect 29 2 30 0; -#X connect 30 0 24 0; -#X connect 30 1 23 0; -#X connect 30 2 28 0; -#X restore 290 86 pd RGB_____________; -#X floatatom 332 55 3 0 255 0 - - -; -#X floatatom 375 55 3 0 255 0 - - -; -#X floatatom 418 56 3 0 255 0 - - -; -#X text 39 3 preset-colors; -#X text 301 0 RGB-colors; -#X text 332 37 red; -#X text 368 36 green; -#X text 416 36 blue; -#X obj 52 104 pack 0 0; +#X connect 6 0 7 0; +#X connect 7 0 1 1; +#X connect 8 0 9 0; +#X connect 9 0 4 0; +#X connect 10 0 6 0; +#X restore 101 386 pd score; +#X obj 68 95 metro 10; +#N canvas 0 0 450 300 once 0; +#X obj 26 21 inlet; +#X obj 26 102 outlet; +#X obj 26 75 t a b; +#X msg 89 48 0; +#X obj 26 48 spigot 1; #X connect 0 0 4 0; -#X connect 1 0 0 0; -#X connect 2 0 0 1; +#X connect 2 0 1 0; +#X connect 2 1 3 0; #X connect 3 0 4 1; -#X connect 4 0 30 0; -#X connect 7 0 11 0; -#X connect 8 0 7 0; -#X connect 9 0 7 1; -#X connect 10 0 11 1; -#X connect 11 0 35 0; -#X connect 12 0 16 0; -#X connect 13 0 12 0; -#X connect 14 0 12 1; -#X connect 15 0 16 1; -#X connect 16 0 34 0; -#X connect 21 0 25 0; -#X connect 22 0 21 0; -#X connect 23 0 21 1; -#X connect 24 0 25 1; -#X connect 25 0 31 0; -#X connect 28 0 44 0; -#X connect 36 0 40 0; -#X connect 37 0 36 0; -#X connect 38 0 36 1; -#X connect 39 0 40 1; -#X connect 40 0 43 0; -#X connect 51 0 52 0; -#X connect 52 0 53 0; -#X connect 52 1 54 0; -#X connect 57 0 75 0; -#X connect 58 0 57 0; -#X connect 59 0 57 1; -#X connect 60 0 75 1; -#X connect 63 0 66 0; -#X connect 64 0 66 0; -#X connect 65 0 66 0; -#X connect 66 0 75 0; -#X connect 66 1 75 1; -#X connect 67 0 66 1; -#X connect 68 0 66 2; -#X connect 69 0 66 3; -#X connect 75 0 29 0; -#X restore 315 20 pd edit; -#X floatatom 110 193 4 0 0 0 - - -; -#X floatatom 147 193 4 0 0 0 - - -; -#X text 121 209 x; -#X text 158 209 y; -#X obj 7 161 metro 100; -#X obj 33 141 tgl 15 1 empty empty empty 20 8 0 10 -262144 -1 -1 1 +#X connect 4 0 2 0; +#X restore 310 32 pd once; +#X obj 257 65 select 97 122 32; +#X msg 336 89 1; +#X obj 87 277 t a; +#X obj 256 442 cnv 15 100 40 empty empty empty 20 12 0 14 -233017 -66577 +0; +#X text 256 439 a = up \; z = down \; <space> = replay; +#X text 216 318 0 - die at left wall \; 1 - richochet off left wall +\; 2 - die at right wall (not yet) \; 3 - richochet off right wall +\; 4 - richochet off top \; 5 - richochet of bottom \;; +#X obj 68 18 r play; +#X obj 336 111 s play; +#X msg 87 319 0; +#X obj 257 202 v bx; +#X obj 337 202 v px; +#X obj 257 180 unpack; +#X obj 257 134 s \$0-pr; +#X msg 294 87 5; +#X msg 134 52 4 FAST; +#X obj 107 139 f \$0; +#X msg 130 361 -1; +#X msg 68 469 delta \$1 \$2; +#X obj 87 341 s play; +#N canvas 528 152 450 386 sfx 0; +#X obj 21 169 noise~; +#X obj 22 201 *~; +#X obj 102 176 vline~; +#X obj 23 249 +~; +#X obj 174 146 delread~ \$0-b; +#X obj 36 278 delwrite~ \$0-b 500; +#X obj 22 302 *~ 0.1; +#X obj 23 330 dac~; +#X obj 135 120 del; +#X msg 102 120 1; +#X msg 135 145 0; +#X obj 174 120 * 10; +#X obj 175 176 *~ 0.8; +#X msg 174 81 2; +#X obj 117 9 inlet; +#X obj 174 54 change; +#X obj 117 31 sel -1 0 2; +#X connect 0 0 1 0; +#X connect 1 0 3 0; +#X connect 2 0 1 1; +#X connect 3 0 5 0; +#X connect 3 0 6 0; +#X connect 4 0 12 0; +#X connect 6 0 7 0; +#X connect 6 0 7 1; +#X connect 8 0 10 0; +#X connect 9 0 2 0; +#X connect 10 0 2 0; +#X connect 11 0 4 0; +#X connect 12 0 3 1; +#X connect 13 0 9 0; +#X connect 13 0 8 0; +#X connect 13 0 11 0; +#X connect 14 0 16 0; +#X connect 15 0 13 0; +#X connect 16 3 15 0; +#X restore 211 294 pd sfx; +#X obj 257 19 key 1; +#X msg 134 69 1.5 ???; +#X obj 87 225 expr if(bx<=20 \, py-10<=by && py+60>=by \, -1) \; if +(bx>=415 \, 3 \, -1) \; if (by<=0 \, 4 \, if (by>=500 \, 5 \, -1)) +; +#X obj 71 51 cnv 10 10 10 \$0-bs \$0-br empty 20 12 0 14 -1 -66577 +0; +#X connect 2 0 42 0; +#X connect 3 0 2 0; +#X connect 4 0 25 0; +#X connect 4 0 28 0; +#X connect 5 0 6 0; +#X connect 6 0 40 0; +#X connect 6 1 7 0; +#X connect 8 0 21 0; +#X connect 8 1 52 0; +#X connect 8 2 45 0; +#X connect 11 0 41 0; +#X connect 13 0 47 0; +#X connect 14 0 19 2; +#X connect 15 0 19 2; +#X connect 17 0 38 0; +#X connect 17 1 18 0; +#X connect 17 2 38 0; +#X connect 17 3 46 0; +#X connect 17 4 14 0; +#X connect 17 5 15 0; +#X connect 18 0 19 1; +#X connect 18 0 21 1; +#X connect 18 0 27 0; +#X connect 19 0 13 1; +#X connect 20 0 13 0; +#X connect 20 1 19 0; +#X connect 21 0 20 0; +#X connect 22 0 28 1; +#X connect 23 0 28 1; +#X connect 24 0 30 0; +#X connect 26 0 29 0; +#X connect 28 0 8 0; +#X connect 29 0 24 1; +#X connect 30 0 3 0; +#X connect 30 1 43 0; +#X connect 30 2 31 0; +#X connect 31 0 37 0; +#X connect 32 0 17 0; +#X connect 32 0 49 0; +#X connect 36 0 4 0; +#X connect 38 0 48 0; +#X connect 41 0 39 0; +#X connect 41 1 12 0; +#X connect 43 0 2 0; +#X connect 44 0 28 1; +#X connect 45 0 9 0; +#X connect 46 0 19 1; +#X connect 46 0 21 1; +#X connect 47 0 16 0; +#X connect 50 0 24 0; +#X connect 51 0 28 1; +#X connect 52 0 32 0; +#X connect 52 1 32 0; +#X connect 52 2 32 0; +#X restore 136 312 pd let's-play-pong!; +#X obj 0 639 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 my_canvas 3 12 0 +18 -204280 -1 0; +#X obj 0 352 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 485 284 494 344 META 0; +#X text 12 85 LIBRARY internal; +#X text 12 45 LICENSE SIBSD; +#X text 12 105 AUTHOR Thomas Musil; +#X text 12 125 WEBSITE; +#X text 12 165 HELP_PATCH_AUTHORS Jonathan Wilkes revised the patch +to conform to the PDDP template for Pd version 0.42.; +#X text 12 65 DESCRIPTION gui-rectangle; +#X text 12 5 ALIAS cnv; +#X text 12 145 RELEASE_DATE 2002; +#X text 12 25 KEYWORDS control GUI nonlocal; +#X restore 500 641 pd META; +#X obj 0 430 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 459 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 546 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 219 521 428 109 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 [cnv] Related Objects; +#X obj 22 43 drawpolygon; +#X obj 112 43 filledpolygon; +#X obj 22 73 x_all_guis bng tgl vsl hsl hradio vradio vu cnv nbx; +#X restore 102 641 pd Related_objects; +#X text 11 23 gui-rectangle; +#X text 420 10 [my_canvas] or [cnv]; +#X text 98 356 (none); +#X text 98 435 (none); +#X text 98 374 See the following subpatch for messages that change +the gui-properties of [cnv]:; +#N canvas 80 25 428 604 Changing_GUI_Properties 0; +#X obj 27 393 unpack 0 0; +#X text 12 301 get position on canvas; +#X msg 13 109 size \$1; +#X obj 13 72 nbx 3 14 8 200 0 0 empty \$0-dim empty 0 -8 0 12 -262144 +-1 -1 15 256 0; +#X obj 13 133 s cnv_rcv; +#N canvas 366 206 174 259 flash-time 0; +#X obj 68 180 pack; +#X obj 103 149 t b a; +#X obj 68 205 outlet; +#X obj 103 104 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-width empty +0 -8 0 12 -262144 -1 -1 100 256 0; +#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-height empty +0 -8 0 12 -262144 -1 -1 60 256 0; +#X connect 0 0 2 0; +#X connect 1 0 0 0; +#X connect 1 1 0 1; +#X connect 3 0 0 0; +#X connect 4 0 1 0; +#X coords 0 -1 1 1 48 42 2 100 100; +#X restore 89 59 pd flash-time; +#X text 86 38 visible size; +#X text 138 61 1.width; +#X text 138 81 2.height; +#X msg 89 109 vis_size \$1 \$2; +#X obj 89 133 s cnv_rcv; +#X text 195 38 change send name; +#X text 310 38 change receive name; +#X obj 196 134 s cnv_rcv; +#X obj 310 134 s cnv_rcv; +#X msg 196 59 send cnv5a_snd; +#X msg 310 59 receive cnv1a_rcv; +#X obj 320 109 s cnv1a_rcv; +#X msg 320 85 receive cnv_rcv; +#X text 132 173 label position; +#X text 274 173 font properties; +#X text 13 173 label; +#X msg 13 194 label new-label; +#X msg 134 245 label_pos \$1 \$2; +#X msg 276 245 label_font \$1 \$2; +#X text 325 197 1.font(0-2); +#X text 325 218 2.height; +#X text 183 196 1.x-offset; +#X text 183 217 2.y-offset; +#N canvas 366 206 174 259 flash-time 0; +#X obj 68 180 pack; +#X obj 103 149 t b a; +#X obj 68 205 outlet; +#X obj 103 104 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-xlabel empty +0 -8 0 12 -262144 -1 -1 20 256 0; +#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-ylabel empty +0 -8 0 12 -262144 -1 -1 12 256 0; +#X connect 0 0 2 0; +#X connect 1 0 0 0; +#X connect 1 1 0 1; +#X connect 3 0 0 0; +#X connect 4 0 1 0; +#X coords 0 -1 1 1 48 42 2 100 100; +#X restore 134 195 pd flash-time; +#N canvas 366 206 174 259 flash-time 0; +#X obj 68 180 pack; +#X obj 103 149 t b a; +#X obj 68 205 outlet; +#X obj 103 104 nbx 3 14 0 2 0 0 \$0-dummy \$0-font empty 0 -8 0 12 +-262144 -1 -1 0 256 0; +#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-font-size empty +0 -8 0 12 -262144 -1 -1 14 256 0; +#X connect 0 0 2 0; +#X connect 1 0 0 0; +#X connect 1 1 0 1; +#X connect 3 0 0 0; +#X connect 4 0 1 0; +#X coords 0 -1 1 1 48 42 2 100 100; +#X restore 276 195 pd flash-time; +#X text 164 461 delta; +#X text 12 461 position; +#X msg 13 558 pos \$1 \$2; +#X msg 165 558 delta \$1 \$2; +#X text 165 301 preset-colors; +#X text 264 301 RGB-colors; +#N canvas 364 205 169 292 flash-time 0; +#X obj 69 196 t b a; +#X obj 33 262 outlet; +#X obj 103 104 nbx 3 14 0 29 0 0 \$0-dummy \$0-bg empty 0 -8 0 12 -262144 +-1 -1 10 256 0; +#X obj 103 124 nbx 3 14 0 29 0 0 \$0-dummy \$0-label empty 0 -8 0 12 +-262144 -1 -1 12 256 0; +#X obj 33 237 pack 0 0; +#X connect 0 0 4 0; +#X connect 0 1 4 1; +#X connect 2 0 4 0; +#X connect 3 0 0 0; +#X connect 4 0 1 0; +#X coords 0 -1 1 1 48 42 2 100 100; +#X restore 165 323 pd flash-time; +#N canvas 0 0 306 317 flash-time 0; +#X obj 96 521 outlet; +#X obj 162 230 t b f; +#X obj 96 268 +; +#X obj 96 293 t b f; +#X obj 96 324 +; +#X obj 19 208 * -65536; +#X obj 96 208 * -256; +#X obj 162 208 * -1; +#X obj 96 355 - 1; +#X obj 96 385 list prepend 0; +#X obj 115 456 t b a; +#X obj 104 124 vradio 15 1 0 2 empty empty empty 0 -8 0 10 -262144 +-1 -1 0; +#X text 120 120 1.bg; +#X obj 103 105 nbx 3 14 0 255 0 0 \$0-dummy \$0-r empty 0 -8 0 10 -262144 +-258113 -1 0 256 0; +#X obj 133 105 nbx 3 14 0 255 0 0 \$0-dummy \$0-g empty 0 -8 0 10 -262144 +-13381 -1 0 256 0; +#X obj 163 105 nbx 3 14 0 255 0 0 \$0-dummy \$0-b empty 0 -8 0 10 -262144 +-4160 -1 0 256 0; +#X text 120 137 2.label; +#X obj 96 410 route 0 1; +#X obj 96 497 pack 0 0; +#X connect 1 0 2 0; +#X connect 1 1 2 1; +#X connect 2 0 3 0; +#X connect 3 0 4 0; +#X connect 3 1 4 1; +#X connect 4 0 8 0; +#X connect 5 0 4 0; +#X connect 6 0 2 0; +#X connect 7 0 1 0; +#X connect 8 0 9 0; +#X connect 9 0 17 0; +#X connect 10 0 18 0; +#X connect 10 1 18 1; +#X connect 11 0 9 1; +#X connect 13 0 5 0; +#X connect 14 0 6 0; +#X connect 15 0 7 0; +#X connect 17 0 18 0; +#X connect 17 1 10 0; +#X connect 18 0 0 0; +#X coords 0 -1 1 1 102 58 2 100 100; +#X restore 265 323 pd flash-time; +#X obj 165 534 list; +#X obj 165 483 bng 20 250 50 0 empty empty empty 17 7 0 10 -262144 +-1 -1; +#X text 214 325 1.bg; +#X text 61 482 1.x-position; +#X text 61 504 2.y-position; +#X text 244 482 1.x-delta; +#X text 244 504 2.y-delta; +#N canvas 366 206 174 259 flash-time 0; +#X obj 68 180 pack; +#X obj 103 149 t b a; +#X obj 68 205 outlet; +#X obj 103 104 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-xpos empty 0 +-8 0 12 -262144 -1 -1 310 256 0; +#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-ypos empty 0 +-8 0 12 -262144 -1 -1 500 256 0; +#X connect 0 0 2 0; +#X connect 1 0 0 0; +#X connect 1 1 0 1; +#X connect 3 0 0 0; +#X connect 4 0 1 0; +#X coords 0 -1 1 1 48 42 2 100 100; +#X restore 13 483 pd flash-time; +#N canvas 366 206 174 259 flash-time 0; +#X obj 68 180 pack; +#X obj 103 149 t b a; +#X obj 68 205 outlet; +#X obj 103 104 nbx 3 14 -20 20 0 0 \$0-dummy \$0-xdelta empty 0 -8 +0 12 -262144 -1 -1 0 256 0; +#X obj 103 124 nbx 3 14 -20 20 0 0 \$0-dummy \$0-ydelta empty 0 -8 +0 12 -262144 -1 -1 0 256 0; +#X connect 0 0 2 0; +#X connect 1 0 0 0; +#X connect 1 1 0 1; +#X connect 3 0 0 0; +#X connect 4 0 1 0; +#X coords 0 -1 1 1 48 42 2 100 100; +#X restore 194 483 pd flash-time; +#X msg 27 322 get_pos; +#X obj 27 347 s cnv_rcv; +#X obj 165 433 s cnv_rcv; +#X obj 13 583 s cnv_rcv; +#X obj 165 583 s cnv_rcv; +#X obj 276 270 s cnv_rcv; +#X obj 134 270 s cnv_rcv; +#X obj 13 270 s cnv_rcv; +#X text 214 345 2.label; +#N canvas 375 166 157 260 init 0; +#X obj 16 11 loadbang; +#X obj 16 42 f \$0; +#X msg 16 72 \; \$1-width 100 \; \$1-height 60 \; \$1-xpos 310 \; \$1-ypos +500 \; \$1-xlabel 20 \; \$1-ylabel 12 \; \$1-dim 15 \; \$1-font 0 \; +\$1-font-size 14 \; \$1-bg 10 \; \$1-label 12; +#X connect 0 0 1 0; +#X connect 1 0 2 0; +#X restore 265 408 pd init; +#X obj 310 500 cnv 15 100 60 cnv_snd cnv_rcv my_canvas 20 12 0 14 -233017 +-33289 0; +#X obj 27 370 r cnv_snd; +#X msg 165 408 color \$1 \$2; +#X obj 27 421 nbx 3 14 -1e+37 1e+37 0 0 empty empty empty 0 -8 0 12 +-262144 -1 -1 0 256 0; +#X obj 90 421 nbx 3 14 -1e+37 1e+37 0 0 empty empty empty 0 -8 0 12 +-262144 -1 -1 0 256 0; +#X msg 25 245 label my_canvas; +#X msg 204 109 send cnv_snd; +#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 [cnv] Changing Properties through Messages; +#X text 12 51 size; +#X text 12 38 selectable; +#X text 14 417 x; +#X text 76 418 y; +#X connect 0 0 61 0; +#X connect 0 1 62 0; +#X connect 2 0 4 0; +#X connect 3 0 2 0; +#X connect 5 0 9 0; +#X connect 9 0 10 0; +#X connect 15 0 13 0; +#X connect 16 0 14 0; +#X connect 18 0 17 0; +#X connect 22 0 55 0; +#X connect 23 0 54 0; +#X connect 24 0 53 0; +#X connect 29 0 23 0; +#X connect 30 0 24 0; +#X connect 33 0 51 0; +#X connect 34 0 52 0; +#X connect 37 0 60 0; +#X connect 38 0 60 0; +#X connect 39 0 34 0; +#X connect 40 0 39 0; +#X connect 46 0 33 0; +#X connect 47 0 39 1; +#X connect 48 0 49 0; +#X connect 59 0 0 0; +#X connect 60 0 50 0; +#X connect 63 0 55 0; +#X connect 64 0 13 0; +#X restore 170 407 pd Changing_GUI_Properties; +#N canvas 103 143 428 369 canvas-creation-arguments 0; +#X msg 23 43 canvas: cnv selectableSize xSize ySize sendName recieveName +Label labelXOff labelYOff Font# fontSize bgColor lblColor 0; +#X text 20 80 Canvas can be called with 13 creation arguments. These +are not "optional" - all parameters must be filled or the canvas will +not instantiate correctly.; +#X text 20 125 The function of the final "0" is unknown to me (it is +found in the textual entry for a canvas object in a .pd file) but can +be safely left off without ill effects.; +#X text 20 167 For example \, click the msg-box to dynamically create +a cnv:; +#X obj 23 237 s pd-canvas-creation-arguments; +#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 [cnv] Creation Arguments and Dynamic Patching; +#X msg 23 195 obj 110 260 cnv 15 200 100 myCanvas myCanvasR Alcyone +75 12 2 14 -261441 12; +#X connect 7 0 4 0; +#X restore 171 518 pd canvas-creation-arguments; +#X text 168 463 - creating a [cnv] without any arguments will set default +values for all gui-properties. See the subpatch below to learn how +to dynamically instantiate a [cnv] object with custom properties:; +#X floatatom 338 318 4 0 0 0 - - -, f 4; +#X floatatom 382 318 4 0 0 0 - - -, f 4; +#X text 349 334 x; +#X text 393 334 y; +#X obj 435 170 metro 100; +#X obj 435 150 tgl 15 1 empty empty empty 20 8 0 10 -262144 -1 -1 1 1; -#X obj 110 145 r from_K1; -#X floatatom 188 194 4 0 0 0 - - -; -#X floatatom 225 194 4 0 0 0 - - -; -#X text 198 210 x; -#X text 236 210 y; -#X obj 188 146 r from_K2; -#X msg 7 185 \; to_K get_pos; -#N canvas 0 296 395 395 room 0; -#X obj 1 1 cnv 1 400 400 empty empty type...ctrl+e 150 140 2 17 -33289 +#X obj 338 270 r from_K1; +#X floatatom 435 318 4 0 0 0 - - -, f 4; +#X floatatom 479 318 4 0 0 0 - - -, f 4; +#X text 445 334 x; +#X text 490 334 y; +#X obj 435 270 r from_K2; +#N canvas 8 328 313 315 room 0; +#X obj 6 7 cnv 15 300 300 empty empty type...ctrl+e 100 140 2 17 -33289 -24198 0; -#X obj 15 16 cnv 1 1 360 empty empty move_K1_and_K2 115 160 2 17 -166441 +#X obj 26 27 cnv 1 1 264 empty empty move_K1_and_K2 65 160 2 17 -166441 -24198 0; -#X obj 374 15 cnv 1 1 360 empty empty empty 20 12 2 20 -99865 -66577 +#X obj 287 30 cnv 1 1 261 empty empty empty 20 12 2 20 -99865 -66577 0; -#X obj 15 15 cnv 1 360 1 empty empty empty 20 12 2 20 -166441 -66577 +#X obj 27 27 cnv 1 260 1 empty empty empty 20 12 2 20 -166441 -66577 0; -#X obj 17 375 cnv 1 358 1 empty empty empty 20 12 2 20 -99865 -66577 +#X obj 28 291 cnv 1 260 1 empty empty empty 20 12 2 20 -99865 -66577 0; -#X obj 23 22 cnv 25 25 25 from_K1 to_K K1 1 13 2 14 -261681 -123526 +#X obj 38 40 cnv 25 25 25 from_K1 to_K K1 1 13 2 14 -261681 -123526 0; -#X obj 342 342 cnv 25 25 25 from_K2 to_K K2 1 13 2 14 -225280 -1109 +#X obj 251 255 cnv 25 25 25 from_K2 to_K K2 1 13 2 14 -225280 -1109 0; -#X restore 307 147 pd room; -#X obj 110 169 unpack; -#X obj 188 170 unpack; -#X text 51 92 to modify geometry \, colors \, etc.; -#X obj 2 115 cnv 1 470 1 empty empty empty 20 12 2 20 -261681 -66577 +#X restore 128 171 pd room; +#X obj 338 294 unpack; +#X obj 435 294 unpack; +#X text 17 147 Click the subwindow below to use a cnv as a control +surface:; +#X obj 20 61 cnv 15 100 60 empty empty label 20 12 0 14 -233017 -66577 0; -#X text 40 78 of the light-blue; -#X text 166 78 my_canvas-object \,; -#X text 5 64 click the properties-dialog on the top-left corner; -#X obj 361 195 r foo10_rcv; -#X obj 403 215 s ggg; -#X text 21 257 graz \, austria 2002; -#X obj 187 236 x_all_guis aaa bbb ccc ddd eee fff ggg hhh iii; -#X text 313 46 For cnv's creation arguments:; -#N canvas 881 440 467 369 canvas-creation-arguments 0; -#X msg 7 12 canvas: cnv selectableSize xSize ySize sendName recieveName -Label labelXOff labelYOff Font# fontSize bgColor lblColor 0; -#X text 9 169 For example \, a canvas called thusly:; -#X obj 9 248 cnv 15 200 100 myCanvas myCanvasR Canvas_Demo 20 12 2 -14 -62784 -195568 0; -#X text 9 226 will result in this:; -#X text 8 59 Canvas can be called with 13 creation arguments. These -are not "optional" - all parameters must be filled or the canvas will -not instantiate correctly.; -#X text 10 114 The function of the final "0" is unknown to me (it is -found in the textual entry for a canvas object in a .pd file) but can -be safely left off without ill effects.; -#X msg 9 191 cnv 15 200 100 myCanvas myCanvasR Canvas_Demo 20 12 2 -14 18 20; -#X restore 314 63 pd canvas-creation-arguments; -#X text 172 257 updated for Pd version 0.35; -#X connect 8 0 16 0; +#X text 128 58 Colored rectangle with a label. Right-click in the top-left +corner of the gray rectangle to the left and click "properties" to +change the object's appearance.; +#X text 127 110 The blue rectangle at the top of each help patch is +a [cnv] \, as are the horizontal dividers below.; +#X text 98 463 13; +#X text 207 564 IEM KUG; +#X text 182 576 graz \, austria 2002; +#X msg 435 192 get_pos; +#X obj 435 214 send to_K; +#X obj 4 641 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#N canvas 405 89 483 507 (subpatch) 0; +#X msg 144 296 bang; +#X msg 144 321 1 30; +#X obj 144 409 line~; +#X obj 202 301 del 30; +#X obj 61 433 *~; +#X obj 62 485 dac~; +#X obj 62 359 osc~ 880; +#X obj 62 403 clip~ -1 1; +#X obj 35 220 list split 1; +#X obj 15 311 list; +#X obj 35 244 t b a; +#X obj 62 334 mtof; +#X obj 62 457 *~ 0.07; +#X obj 207 128 metro 50; +#X obj 207 202 s \$0-cnv; +#X obj 207 106 0; +#X obj 207 84 del 3000; +#X obj 310 170 f; +#X obj 342 170 + 1; +#X obj 35 12 r \$0-bng; +#X obj 106 14 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 -1 +-1; +#X obj 310 197 div 13; +#X msg 310 314 color \$1 0; +#X obj 242 105 tgl 15 0 empty empty empty 17 7 0 10 -262144 -1 -1 0 +1; +#X obj 279 86 sel 0; +#X obj 279 107 -1; +#X obj 279 130 t a; +#X obj 207 155 f -1; +#X msg 207 180 delta 0 \$1; +#X obj 35 44 spigot 1; +#X obj 35 76 t a b; +#X obj 96 55 0; +#X obj 130 55 1; +#X obj 310 220 sel 3 4; +#X msg 371 246 5 \$1; +#X obj 371 268 -; +#X msg 310 246 1; +#X obj 340 245 f 2; +#X obj 383 170 sel 1; +#X msg 377 198 0; +#X msg 411 199 2; +#X obj 62 311 + 68; +#X obj 15 284 del 170; +#X text 167 14 IT'S A SECRET TO EVERYBODY.; +#X obj 56 106 loadbang; +#X obj 35 174 list; +#X obj 114 217 s \$0-randomize; +#X obj 71 149 r \$0-new-secret; +#X msg 56 128 7 1 0 8 12 16; +#X obj 35 197 list prepend 11 10; +#X obj 62 381 *~ 1.4; +#X msg 202 323 0 400; +#X connect 0 0 1 0; +#X connect 0 0 3 0; +#X connect 1 0 2 0; +#X connect 2 0 4 1; +#X connect 3 0 51 0; +#X connect 4 0 12 0; +#X connect 6 0 50 0; +#X connect 7 0 4 0; +#X connect 8 0 10 0; +#X connect 8 1 9 1; #X connect 9 0 8 0; -#X connect 10 0 18 0; -#X connect 15 0 19 0; -#X connect 18 0 4 0; -#X connect 18 1 5 0; -#X connect 19 0 11 0; -#X connect 19 1 12 0; +#X connect 10 0 42 0; +#X connect 10 1 0 0; +#X connect 10 1 41 0; +#X connect 11 0 6 0; +#X connect 12 0 5 0; +#X connect 12 0 5 1; +#X connect 13 0 17 0; +#X connect 13 0 27 0; +#X connect 15 0 13 0; +#X connect 15 0 17 1; +#X connect 16 0 15 0; +#X connect 16 0 23 0; +#X connect 16 0 32 0; +#X connect 17 0 18 0; +#X connect 17 0 21 0; +#X connect 18 0 17 1; +#X connect 19 0 29 0; +#X connect 20 0 29 0; +#X connect 21 0 33 0; +#X connect 22 0 14 0; +#X connect 23 0 24 0; +#X connect 23 0 38 0; +#X connect 24 0 25 0; +#X connect 24 1 26 0; #X connect 25 0 26 0; +#X connect 26 0 27 1; +#X connect 27 0 28 0; +#X connect 28 0 14 0; +#X connect 29 0 30 0; +#X connect 30 0 13 0; +#X connect 30 0 16 0; +#X connect 30 0 45 0; +#X connect 30 1 31 0; +#X connect 31 0 29 1; +#X connect 32 0 29 1; +#X connect 33 0 36 0; +#X connect 33 1 37 0; +#X connect 33 2 34 0; +#X connect 34 0 35 0; +#X connect 35 0 22 0; +#X connect 36 0 22 0; +#X connect 37 0 22 0; +#X connect 38 0 39 0; +#X connect 38 1 40 0; +#X connect 39 0 37 1; +#X connect 40 0 37 1; +#X connect 41 0 11 0; +#X connect 42 0 9 0; +#X connect 44 0 48 0; +#X connect 45 0 46 0; +#X connect 45 0 49 0; +#X connect 47 0 45 1; +#X connect 48 0 45 1; +#X connect 49 0 8 0; +#X connect 50 0 7 0; +#X connect 51 0 2 0; +#X coords 0 -1 1 1 15 15 2 100 100; +#X restore 71 330 pd; +#X obj 169 553 bng 14 250 50 0 \$0-bng empty empty 4 7 0 12 -262144 +-262144 -1; +#X text 66 275 You can also use a white [cnv] to; +#X text 66 290 conceal parts of a patch (use; +#X text 66 305 with care); +#X text 185 551 musil@iem.kug.ac.at; +#X text 171 550 c; +#X obj 63 267 cnv 15 210 70 empty \$0-cnv empty 20 12 0 14 -262144 +-262144 0; +#X obj 69 329 cnv 15 17 17 empty empty empty 20 12 0 14 -262144 -66577 +0; +#X text 244 191 send it a "get_pos" message ->; +#X text 244 176 To get a cnv position \,; +#X text 325 551 Note: [cnv] is not to be confused; +#X text 325 564 with the Pd canvas \, or [pd] \,; +#X text 325 577 [table] \, etc.; +#X text 66 233 enable the edit mode and selectthe area below to see +how you canuse cnv to hide things; +#N canvas 597 433 432 210 using_canvas_to_hide_objects_that_capture_mouse_clicks +0; +#X obj 100 47 tgl 43 0 empty empty empty 17 7 0 10 -262144 -1 -1 0 +1; +#X obj 81 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 +0 14 -204280 -1 0; +#X text 88 2 Using [cnv] to hide objects that capture mouse clicks +; +#X obj 100 47 cnv 15 43 43 empty empty CLICK 6 22 0 10 -247832 -66577 +0; +#X obj 100 109 tgl 21 0 empty empty empty 17 7 0 10 -262144 -1 -1 0 +1; +#X text 167 46 Try clicking on the [cnv] object to the left.Notice +how the [cnv] on the left seemingly exhibitstoggle-like behavior. +In fact \, it is not the [cnv]that is responsible for toggle changing +its state.Rather \, it is another toggle button that is hiddenunder +the [cnv] object that does this. This ispossible bacause unlike any +other iemgui objects \, [cnv] does not capture runtime clicks and +insteadpasses them to objects below it.; +#X connect 0 0 4 0; +#X restore 169 608 pd using_canvas_to_hide_objects_that_capture_mouse_clicks +; +#X connect 21 0 39 0; +#X connect 22 0 21 0; +#X connect 23 0 30 0; +#X connect 28 0 31 0; +#X connect 30 0 17 0; +#X connect 30 1 18 0; +#X connect 31 0 24 0; +#X connect 31 1 25 0; +#X connect 39 0 40 0; diff --git a/pd/doc/5.reference/namecanvas-help.pd b/pd/doc/5.reference/namecanvas-help.pd index 63f1119e8..1f5ee68e8 100644 --- a/pd/doc/5.reference/namecanvas-help.pd +++ b/pd/doc/5.reference/namecanvas-help.pd @@ -1,8 +1,53 @@ -#N canvas 217 14 532 261 12; -#X obj 66 15 namecanvas; -#X text 169 15 - ATTACH THIS CANVAS TO A NAME; -#X obj 204 107 namecanvas bonzo; -#X msg 205 64 \; bonzo msg 50 50 hi there; -#X text 44 153 This is obsolete. Instead \, you can just say:; -#X msg 79 180 \; pd-namecanvas-help.pd msg 50 70 this is better; -#X text 252 224 updated for Pd version 0.40.; +#N canvas 429 35 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 namecanvas 3 12 +0 18 -204280 -1 0; +#X obj 0 450 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 483 286 494 344 META 0; +#X text 12 65 LIBRARY internal; +#X text 12 105 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 85 AUTHOR Miller Puckette; +#X text 12 145 HELP_PATCH_AUTHORS Updated for Pd version 0.40. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 45 DESCRIPTION attach a canvas to a name; +#X text 12 5 KEYWORDS control canvas_op; +#X text 12 125 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 478 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 505 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 568 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 219 517 428 109 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 [namecanvas] Related Objects; +#X obj 19 43 pddp/helplink iemguts/sendcanvas; +#X restore 102 597 pd Related_objects; +#X obj 477 11 namecanvas; +#X obj 120 153 namecanvas \$0-bonzo; +#X obj 120 210 s \$0-bonzo; +#X text 98 454 (none); +#X text 98 482 (none); +#X obj 120 366 s pd-namecanvas-help.pd; +#X text 11 23 attach a canvas to a name; +#X text 168 523 - sets the name to associate with this canvas. Any +messages sent to this name will be forwarded to the canvas containing +this [namecanvas] object.; +#X msg 120 186 msg 50 50 Hi there. This works locally.; +#X msg 120 338 msg 50 70 This works globally.; +#X text 78 523 1) symbol atom; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X text 120 240 If you open another instance of this help patch \, +you'll see that clicking the message box above will create an object +on the canvas where you click.; +#X text 119 294 The following is similar \, but it will create an object +in each "namecanvas-help.pd" patch that you have open:; +#X connect 16 0 10 0; +#X connect 17 0 13 0; diff --git a/pd/doc/5.reference/netreceive-help.pd b/pd/doc/5.reference/netreceive-help.pd index b4bd3f9c6..04df2dc0b 100644 --- a/pd/doc/5.reference/netreceive-help.pd +++ b/pd/doc/5.reference/netreceive-help.pd @@ -1,23 +1,94 @@ -#N canvas 50 24 682 520 12; -#X obj 100 323 netreceive 3000; -#X floatatom 202 353 0 0 0; -#X obj 100 414 netreceive 3001 1; -#X text 33 36 The Netreceive object opens a socket for TCP ("stream") or UDP ("datagram") network reception on a specified port. If using TCP \, an outlet gives you the number of Netsend objects (or other compatible clients) have opened connections here.; -#X text 31 117 Incoming network messages appear on "receive" objects \; it's up to the sender to select which one. Here \, a "receive foo" fields messages sent from the Netsend help window \, q.v.; -#X text 108 270 first argument: portnumber = 3000; -#X text 105 291 second argument: 0 or none for TCP \, nonzero for UDP; -#X text 238 322 <-- TCP \, port 3000; -#X text 262 413 <-- UDP \, port 3001; -#X text 236 354 <--- number of open connections; -#X text 85 12 Netreceive -- listen for incoming messages from network; -#X text 26 383 incoming messages; -#X text 203 488 see also:; -#X obj 289 490 netsend; -#X obj 100 353 print tcp; -#X obj 100 442 print udp; -#X text 425 484 updated for Pd version 0.33; -#X text 30 207 SECURITY ALERT: don't publish the port number of your netreceive unless you wouldn't mind other people being able to send you messages.; -#X text 32 168 There are some possibilities for intercommunication with other programs... see the help for "netsend."; -#X connect 0 0 14 0; -#X connect 0 1 1 0; -#X connect 2 0 15 0; +#N canvas 428 33 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 netreceive 3 12 +0 18 -204280 -1 0; +#X obj 0 311 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 481 282 494 344 META 0; +#X text 12 105 LIBRARY internal; +#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 125 AUTHOR Miller Puckette; +#X text 12 185 HELP_PATCH_AUTHORS Updated for Pd v0.41. Revised by +Jonathan Wilkes to conform to the PDDP template for Pd version 0.42. +; +#X text 12 5 KEYWORDS control network; +#X text 12 45 DESCRIPTION listen for incoming messages from a network +; +#X text 12 65 OUTLET_0 anything; +#X text 12 85 OUTLET_1 float; +#X text 12 165 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 338 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 419 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 558 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 216 518 428 109 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 [netreceive] Related Objects; +#X obj 16 35 netsend; +#X obj 70 35 disis_netsend; +#X obj 160 35 disis_netreceive; +#X restore 102 598 pd Related_objects; +#X obj 78 347 cnv 17 3 25 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 80 439 1) float; +#X obj 476 10 netreceive; +#X floatatom 226 82 0 0 0 0 - - -; +#X obj 139 145 netreceive 3001 1; +#X obj 139 82 print tcp; +#X obj 139 166 print udp; +#N canvas 57 331 428 261 About_netreceive 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 [netreceive] More Info; +#X text 21 38 The [netreceive] object opens a socket for TCP ("stream") +or UDP ("datagram") network reception on a specified port. If using +TCP \, an outlet gives you the number of [netsend] objects (or other +compatible clients) have opened connections here.; +#X text 20 170 There are some possibilities for intercommunication +with other programs... see the help for [netsend].; +#X text 19 104 Incoming network messages appear at the left inlet of +the [netreceive] object. (They used to be received by [receive] objects +\, in which case it was up to the sender to select which one). To test +the object you can send messages from the [netsend] help window.; +#X text 18 208 SECURITY ALERT: the port that netreceive opens has no +access restrictions \, so anyone can connect to it and send messages. +; +#X restore 102 567 pd About_netreceive; +#X text 11 23 listen for incoming messages from a network; +#X text 168 454 - (optional) 0 for TCP \, nonzero for UDP. (Default +is TCP.); +#X text 168 439 - (optional) port number.; +#X text 80 454 2) float; +#X text 168 469 - if you set the third argument to the word "old" \, +everything sent to the specified port is received into the global message +space. This is the original behavior of [netreceive]. This can be VERY +INSECURE since it gives someone full access to your computer \, allowing +them to do anything that Pd can via the network.; +#X text 98 270 Old behavior: [netreceive 4567 0 old] (see argument +3 below); +#X text 80 469 3) symbol atom; +#X text 98 346 anything; +#X obj 78 383 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 382 float; +#X text 264 60 <- TCP \, port 3000; +#X text 261 144 <- UDP \, port 3001; +#X text 98 205 You can send messages from the [netsend] objects in +the help patch for [netsend].; +#X text 168 346 - any message received by this [netreceive] object +will be sent to the left outlet.; +#X text 98 314 (none); +#X obj 139 61 netreceive 3000; +#X text 168 382 - when using TCP \, the [netreceive] object has a right +inlet which shows the number of open connections.; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X connect 12 0 14 0; +#X connect 31 0 13 0; +#X connect 31 1 11 0; diff --git a/pd/doc/5.reference/netsend-help.pd b/pd/doc/5.reference/netsend-help.pd index f2eb9badf..ab06e6038 100644 --- a/pd/doc/5.reference/netsend-help.pd +++ b/pd/doc/5.reference/netsend-help.pd @@ -1,55 +1,113 @@ -#N canvas 84 44 866 530 12; -#X obj 15 425 netsend; -#X msg 15 263 connect localhost 3000; -#X msg 24 403 send foo \$1; -#X floatatom 24 376 0 0 0; -#X msg 15 344 disconnect; -#X msg 285 397 send foo \$1; -#X floatatom 285 370 0 0 0; -#X msg 268 344 disconnect; -#X obj 268 422 netsend 1; -#X msg 268 263 connect localhost 3001; -#X floatatom 15 452 0 0 0; -#X floatatom 268 449 0 0 0; -#X text 359 422 creation argument: 0 or none for TCP \, nonzero for -UDP; -#X text 66 242 TCP; -#X text 343 239 UDP; -#X text 197 9 Netsend -- send Pd messages over a network; -#X text 475 261 Connect to "localhost" port 3000/3001; -#X text 373 345 Close the connection; -#X text 325 372 Send messages to "foo" on remote machine; -#X text 10 473 Outlet is nonzero if connection is open \, zero otherwise. +#N canvas 398 77 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 netsend 3 12 0 18 +-204280 -1 0; +#X obj 0 348 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 46 242 494 344 META 0; +#X text 12 105 LIBRARY internal; +#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 125 AUTHOR Miller Puckette; +#X text 12 185 HELP_PATCH_AUTHORS Updated for Pd v0.41. Revised by +Jonathan Wilkes to conform to the PDDP template for Pd version 0.42. ; -#X text 87 38 The Netsend object connects to another machine over the -network for sending TCP ("stream") or UDP ("datagram") messages. An -outlet reports whether the connection is open or not. A connection +#X text 12 5 KEYWORDS control network; +#X text 12 45 DESCRIPTION send Pd messages over a network; +#X text 12 65 INLET_0 connect disconnect send; +#X text 12 85 OUTLET_0 float; +#X text 12 165 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 478 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 515 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 558 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 54 478 428 109 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 [netsend] Related Objects; +#X obj 11 34 netreceive; +#X obj 83 34 disis_netsend; +#X obj 173 34 disis_netreceive; +#X restore 102 598 pd Related_objects; +#X obj 78 357 cnv 17 3 110 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 486 float; +#X obj 78 487 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 11 23 send Pd messages over a network; +#X obj 445 20 pddp/pddplink http://wiki.puredata.info/en/netsend -text +pdpedia: netsend; +#X obj 473 3 netsend; +#X obj 15 238 netsend; +#X msg 15 79 connect localhost 3000; +#X msg 23 213 send foo \$1; +#X floatatom 23 186 0 0 0 0 - - -; +#X msg 15 160 disconnect; +#X msg 186 213 send foo \$1; +#X floatatom 186 186 0 0 0 0 - - -; +#X msg 178 160 disconnect; +#X obj 178 238 netsend 1; +#X msg 178 79 connect localhost 3001; +#X floatatom 15 265 0 0 0 0 - - -; +#X floatatom 178 265 0 0 0 0 - - -; +#X text 66 58 TCP; +#X text 253 55 UDP; +#X text 325 79 Connect to "localhost" port 3000/3001; +#X text 253 161 Close the connection; +#X text 215 188 Send messages to "foo" on remote machine; +#X text 12 294 Outlet is nonzero if connection is open \, zero otherwise. +; +#X msg 15 106 connect molloy 3000; +#X msg 178 106 connect molloy 3001; +#X msg 15 133 connect bug 3000; +#X msg 178 133 connect bug 3000; +#X text 98 356 connect; +#X text 98 413 disconnect; +#X text 98 443 send; +#X text 168 486 - nonzero if the connection is open \, zero otherwise. +; +#N canvas 55 339 428 233 About_netsend 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 [netsend] More Info; +#X text 20 39 The [netsend] object connects to another machine over +the network for sending TCP ("stream") or UDP ("datagram") messages. +An outlet reports whether the connection is open or not. A connection request should specify the name or IP address of the other host and -the port number. There should be a "Netreceive" on the remote host -with a matching port number.; -#X obj 409 497 netreceive; -#X text 318 497 see also:; -#X text 607 498 updated for Pd version 0.33; -#X text 87 150 Opt@web.fm has made compatible objects for Max so that -Pd and Max can intercommunicate: see ftp://fals.ch/pub/pdnets/.; -#X text 87 186 The Linux version of Pd comes with "pdsend" and "pdreceive" +the port number. There should be a [netreceive] object on the remote +host with a matching port number.; +#X text 20 148 The Linux version of Pd comes with "pdsend" and "pdreceive" standalone programs. These haven't been tested in Windows yet (but -the source is included in the Pd distribution.); -#X msg 15 290 connect molloy 3000; -#X msg 268 290 connect molloy 3001; -#X msg 15 317 connect bug 3000; -#X msg 268 317 connect bug 3000; -#X connect 0 0 10 0; -#X connect 1 0 0 0; -#X connect 2 0 0 0; -#X connect 3 0 2 0; -#X connect 4 0 0 0; -#X connect 5 0 8 0; -#X connect 6 0 5 0; -#X connect 7 0 8 0; -#X connect 8 0 11 0; -#X connect 9 0 8 0; -#X connect 26 0 0 0; -#X connect 27 0 8 0; -#X connect 28 0 0 0; -#X connect 29 0 8 0; +the source is included in the Pd distribution).; +#X restore 102 567 pd About_netsend; +#X text 80 535 1) float; +#X text 168 535 - (optional) 0 for TCP \, nonzero for UDP. (Default +is TCP.); +#X text 168 413 - disconnect from the remote machine. When it is disconnected +\, a "0" is sent to the outlet.; +#X text 168 443 - after successfully connecting \, use the "send" message +to forward data to the remote machine.; +#X text 168 356 - use the "connect" message to connect to the specified +remote machine-- providing its name or IP address-- on the specified +port (e.g. \, "connect localhost 3000"). A "1" is output if the connection +is successful.; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X connect 14 0 24 0; +#X connect 15 0 14 0; +#X connect 16 0 14 0; +#X connect 17 0 16 0; +#X connect 18 0 14 0; +#X connect 19 0 22 0; +#X connect 20 0 19 0; +#X connect 21 0 22 0; +#X connect 22 0 25 0; +#X connect 23 0 22 0; +#X connect 32 0 14 0; +#X connect 33 0 22 0; +#X connect 34 0 14 0; +#X connect 35 0 22 0; diff --git a/pd/doc/5.reference/noise~-help.pd b/pd/doc/5.reference/noise~-help.pd index cafc15c36..6e4c3cb25 100644 --- a/pd/doc/5.reference/noise~-help.pd +++ b/pd/doc/5.reference/noise~-help.pd @@ -1,18 +1,62 @@ -#N canvas 174 90 458 270 12; -#X floatatom 77 178 4 0 0; -#X obj 77 111 noise~; -#X obj 167 149 print~; -#X msg 167 123 bang; -#X obj 282 89 loadbang; -#X msg 282 114 \; pd dsp 1; -#X obj 77 150 env~ 4096; -#X text 67 204 RMS in dB; -#X text 171 242 updated for Pd version 0.33; -#X obj 20 11 noise~; -#X text 84 11 - uniformly distributed white noise; -#X text 38 49 the output range is -1 to 1...; -#X connect 1 0 2 0; -#X connect 1 0 6 0; -#X connect 3 0 2 0; -#X connect 4 0 5 0; -#X connect 6 0 0 0; +#N canvas 429 34 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 noise~ 3 12 0 18 +-204280 -1 0; +#X obj 0 466 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 481 283 494 344 META 0; +#X text 12 105 LIBRARY internal; +#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 125 AUTHOR Miller Puckette; +#X text 12 185 HELP_PATCH_AUTHORS Updated for Pd version 0.33. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 45 DESCRIPTION uniformly distributed white noise; +#X text 12 65 INLET_0; +#X text 12 85 OUTLET_0 signal; +#X text 12 165 RELEASE_DATE 1997; +#X text 12 5 KEYWORDS signal random; +#X restore 500 597 pd META; +#X obj 0 503 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 540 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 567 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#X text 98 544 (none); +#N canvas 216 518 428 109 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 [noise~] Related Objects; +#X obj 22 43 random; +#X restore 102 597 pd Related_objects; +#X obj 78 475 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 512 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 500 10 noise~; +#X floatatom 218 284 4 0 0 0 - - -, f 4; +#X obj 218 217 noise~; +#X obj 284 256 print~; +#X obj 218 256 env~ 4096; +#X text 216 192 the output range is -1 to 1...; +#X obj 152 256 snapshot~; +#X floatatom 152 283 0 0 0 0 - - -; +#X msg 152 229 bang; +#X msg 284 229 bang; +#X text 168 474 - the inlet to [noise~] is not used.; +#X text 98 511 signal; +#X text 11 23 uniformly distributed white noise; +#X text 98 474 (inactive); +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 480 53 pddp/dsp; +#X connect 13 0 14 0; +#X connect 13 0 15 0; +#X connect 13 0 17 0; +#X connect 15 0 12 0; +#X connect 17 0 18 0; +#X connect 19 0 17 0; +#X connect 20 0 14 0; diff --git a/doc/pddp/notein-help.pd b/pd/doc/5.reference/notein-help.pd similarity index 100% rename from doc/pddp/notein-help.pd rename to pd/doc/5.reference/notein-help.pd diff --git a/doc/pddp/noteout-help.pd b/pd/doc/5.reference/noteout-help.pd similarity index 100% rename from doc/pddp/noteout-help.pd rename to pd/doc/5.reference/noteout-help.pd diff --git a/pd/doc/5.reference/numbox2-help.pd b/pd/doc/5.reference/numbox2-help.pd index a26db2507..74e83adb0 100644 --- a/pd/doc/5.reference/numbox2-help.pd +++ b/pd/doc/5.reference/numbox2-help.pd @@ -1,302 +1,424 @@ -#N canvas 290 235 617 416 10; -#X obj 1 1 cnv 8 100 60 empty empty numbox=nbx 20 20 1 18 -262144 -1109 -0; -#X floatatom 38 300 9 0 0; -#X msg 47 84 set \$1; -#X floatatom 38 43 7 0 0; -#X text 25 363 (c) musil@iem.kug.ac.at; -#X text 67 376 IEM KUG; -#X obj 38 324 bng 15 250 50 0 empty empty empty 8 -8 0 10 -262144 -1 +#N canvas 433 38 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 nbx 3 12 0 18 -204280 +-1 0; +#X obj 0 260 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 490 290 494 344 META 0; +#X text 12 155 LIBRARY internal; +#X text 12 65 LICENSE SIBSD; +#X text 12 175 AUTHOR Thomas Musil; +#X text 12 195 WEBSITE; +#X text 12 235 HELP_PATCH_AUTHORS Jonathan Wilkes revised the patch +to conform to the PDDP template for Pd version 0.42.; +#X text 12 45 KEYWORDS control storage GUI nonlocal; +#X text 12 85 DESCRIPTION gui-number box; +#X text 12 5 NAME nbx; +#X text 12 25 ALIAS my_numbox; +#X text 12 135 OUTLET_0 float; +#X text 12 105 INLET_0 float bang set size range log init log_height +send receive label label_pos label_font color pos delta; +#X text 12 215 RELEASE_DATE 2002; +#X restore 500 597 pd META; +#X obj 0 425 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 462 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 547 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 219 507 428 128 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 [nbx] Related Objects; +#X floatatom 22 43 5 0 0 0 - - -, f 5; +#X obj 62 43 float; +#X obj 106 43 int; +#X obj 20 90 x_all_guis bng tgl vsl hsl hradio vradio vu cnv nbx; +#X text 18 66 All iem-gui objects:; +#X restore 102 597 pd Related_objects; +#X obj 78 269 cnv 17 3 140 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 268 float; +#X text 98 338 list; +#X text 98 433 float; +#X obj 78 434 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X floatatom 28 175 6 0 0 0 - - -, f 6; +#X msg 57 94 set \$1; +#X floatatom 48 49 6 0 0 0 - - -, f 6; +#X obj 28 199 bng 15 250 50 0 empty empty empty 8 -8 0 10 -262144 -1 -1; -#X obj 18 47 bng 15 250 50 0 empty empty empty 8 -8 0 10 -262144 -1 +#X obj 28 49 bng 15 250 50 0 empty empty empty 8 -8 0 10 -262144 -1 -1; -#X floatatom 47 63 7 0 0; -#X floatatom 116 324 9 0 0; -#X floatatom 106 42 7 0 0; -#X floatatom 183 113 7 0 0; -#X obj 111 249 ftom; -#X floatatom 111 271 9 0 0; -#X floatatom 147 244 9 0 0; -#X floatatom 221 266 9 0 0; -#X text 217 151 click properties to; -#X floatatom 111 112 9 0 0; -#X obj 111 134 mtof; -#X text 202 65 (0.01 pixels); -#X text 57 99 ------------------------------------------; -#X text 57 286 --------------------------------------------; -#X text 205 162 modify geometry \, colors \, etc.; -#X msg 106 63 set \$1; -#X text 188 44 shift-click & drag; -#X text 194 54 for fine-tuning; -#X text 195 203 UP- \, DOWN- \, LEFT- or RIGHT-key; -#X text 193 214 for moving selected gui-objects; -#N canvas 239 379 699 530 edit 0; -#X obj 37 233 f; -#X msg 15 212 bang; -#X floatatom 53 211 3 6 88; -#X floatatom 88 233 3 -20 37; -#X obj 37 256 pack 0 0; -#X text 115 233 y-label; -#X text 81 211 x-label; -#X obj 287 271 f; -#X msg 265 250 bang; -#X floatatom 303 249 3 -10 10; -#X floatatom 338 271 3 -10 10; -#X obj 287 294 pack 0 0; -#X obj 299 381 f; -#X msg 277 360 bang; -#X floatatom 315 359 3 20 90; -#X floatatom 350 381 3 150 200; -#X obj 299 404 pack 0 0; -#X text 331 249 x-delta; -#X text 365 271 y-delta; -#X text 343 359 x-position; -#X text 377 381 y-position; -#X obj 57 348 f; -#X msg 35 327 bang; -#X floatatom 73 326 3 0 2; -#X floatatom 108 348 3 4 36; -#X obj 57 371 pack 0 0; -#X text 101 326 font; -#X text 137 348 height; -#X floatatom 476 188 1 0 1; -#X text 523 401 no init; -#X text 493 453 init value on loadbang; -#X text 520 188 steady; -#X obj 486 291 f; -#X msg 464 270 bang; -#X floatatom 502 269 4 55 440; -#X floatatom 537 291 6 440 3520; -#X obj 486 314 pack 0 0; -#X text 269 469 linear / logarithmical; -#X msg 47 158 \; goo4_rcv color \$1 \$2 \$3; -#X msg 37 281 \; goo4_rcv label_pos \$1 \$2; -#X msg 57 396 \; goo4_rcv label_font \$1 \$2; -#X msg 40 442 \; goo4_rcv label blabla; -#X msg 269 487 \; goo4_rcv lin; -#X msg 363 486 \; goo4_rcv log; -#X msg 299 429 \; goo4_rcv pos \$1 \$2; -#X msg 287 319 \; goo4_rcv delta \$1 \$2; -#X msg 475 21 \; goo4_rcv send goo4a_snd; -#X msg 475 59 \; goo4_rcv send goo4_snd; -#X msg 476 105 \; goo4_rcv receive goo4a_rcv; -#X msg 476 143 \; goo4a_rcv receive goo4_rcv; -#X msg 486 339 \; goo4_rcv range \$1 \$2; -#X msg 502 420 \; goo4_rcv init 0; -#X msg 503 471 \; goo4_rcv init 1; -#X text 539 270 bottom-range-bound; -#X text 586 292 top-range-bound; -#X obj 286 160 f; -#X msg 264 139 bang; -#X floatatom 302 138 3 4 55; -#X floatatom 337 160 3 15 73; -#X obj 286 183 pack 0 0; -#X msg 286 208 \; goo4_rcv size \$1 \$2; -#X text 330 138 width; -#X text 368 161 height; -#X msg 41 478 \; goo4_rcv label log.freq.; -#X msg 476 212 \; goo4_rcv steady \$1; -#X obj 47 116 pack 0 0 0; -#X obj 47 88 f; -#X msg 24 40 bang; -#X floatatom 63 38 3 0 29; -#X floatatom 79 58 3 0 29; -#X floatatom 112 74 3 0 29; -#X text 91 38 background; -#X text 106 58 front-color; -#X text 140 75 label-color; -#X msg 285 37 back; -#X msg 285 57 front; -#X msg 285 77 label; -#X msg 247 37 bang; -#N canvas 15 207 606 448 RGB_____________ 0; -#X obj 97 56 inlet; -#X obj 262 53 inlet; -#X obj 339 55 inlet; -#X obj 405 56 inlet; -#X obj 97 270 bang; -#X msg 77 295 0; -#X msg 104 295 1; -#X obj 146 268 bang; -#X msg 132 295 0; -#X msg 160 295 1; -#X obj 196 269 bang; -#X msg 187 295 0; -#X msg 214 295 1; -#X obj 265 313 spigot; -#X obj 312 313 spigot; -#X obj 359 313 spigot; -#X obj 249 385 outlet; -#X text 93 33 select; -#X text 267 28 red; -#X text 337 30 green; -#X text 409 30 blue; -#X obj 405 102 t b f; -#X obj 339 160 +; -#X obj 339 185 t b f; -#X obj 339 216 +; -#X obj 296 385 outlet; -#X obj 343 385 outlet; -#X obj 28 180 loadbang; -#X obj 97 135 route back front label bang; -#X obj 343 362 f; -#X obj 296 361 f; -#X obj 249 361 f; -#X obj 262 79 * -65536; -#X obj 339 80 * -256; -#X obj 405 80 * -1; -#X obj 339 247 - 1; -#X obj 235 168 t b b b b; -#X connect 0 0 28 0; -#X connect 1 0 32 0; -#X connect 2 0 33 0; -#X connect 3 0 34 0; -#X connect 4 0 5 0; -#X connect 4 0 6 0; -#X connect 5 0 14 1; -#X connect 5 0 15 1; -#X connect 6 0 13 1; -#X connect 7 0 8 0; -#X connect 7 0 9 0; -#X connect 8 0 13 1; -#X connect 8 0 15 1; -#X connect 9 0 14 1; -#X connect 10 0 11 0; -#X connect 10 0 12 0; -#X connect 11 0 13 1; -#X connect 11 0 14 1; -#X connect 12 0 15 1; -#X connect 13 0 31 1; -#X connect 14 0 30 1; -#X connect 15 0 29 1; -#X connect 21 0 22 0; -#X connect 21 1 22 1; -#X connect 22 0 23 0; -#X connect 23 0 24 0; -#X connect 23 1 24 1; -#X connect 24 0 35 0; -#X connect 27 0 6 0; -#X connect 28 0 4 0; -#X connect 28 1 7 0; -#X connect 28 2 10 0; -#X connect 28 3 36 0; -#X connect 29 0 26 0; -#X connect 30 0 25 0; -#X connect 31 0 16 0; -#X connect 32 0 24 0; -#X connect 33 0 22 0; -#X connect 34 0 21 0; -#X connect 35 0 15 0; -#X connect 35 0 14 0; -#X connect 35 0 13 0; -#X connect 36 0 31 0; -#X connect 36 1 30 0; -#X connect 36 2 29 0; -#X connect 36 3 35 0; -#X restore 285 98 pd RGB_____________; -#X floatatom 327 67 3 0 255; -#X floatatom 370 67 3 0 255; -#X floatatom 413 68 3 0 255; -#X text 34 12 preset-colors; -#X text 296 9 RGB-colors; -#X text 327 49 red; -#X text 363 48 green; -#X text 411 48 blue; -#X connect 0 0 4 0; -#X connect 1 0 0 0; -#X connect 2 0 0 1; -#X connect 3 0 4 1; -#X connect 4 0 39 0; -#X connect 7 0 11 0; -#X connect 8 0 7 0; -#X connect 9 0 7 1; -#X connect 10 0 11 1; -#X connect 11 0 45 0; -#X connect 12 0 16 0; -#X connect 13 0 12 0; -#X connect 14 0 12 1; -#X connect 15 0 16 1; -#X connect 16 0 44 0; -#X connect 21 0 25 0; -#X connect 22 0 21 0; -#X connect 23 0 21 1; -#X connect 24 0 25 1; -#X connect 25 0 40 0; -#X connect 28 0 64 0; -#X connect 32 0 36 0; -#X connect 33 0 32 0; -#X connect 34 0 32 1; -#X connect 35 0 36 1; -#X connect 36 0 50 0; -#X connect 55 0 59 0; -#X connect 56 0 55 0; -#X connect 57 0 55 1; -#X connect 58 0 59 1; -#X connect 59 0 60 0; -#X connect 65 0 38 0; -#X connect 66 0 65 0; -#X connect 67 0 66 0; -#X connect 68 0 66 1; -#X connect 69 0 65 1; -#X connect 70 0 65 2; -#X connect 74 0 78 0; -#X connect 75 0 78 0; -#X connect 76 0 78 0; -#X connect 77 0 78 0; -#X connect 78 0 65 0; -#X connect 78 1 65 1; -#X connect 78 2 65 2; -#X connect 79 0 78 1; -#X connect 80 0 78 2; -#X connect 81 0 78 3; -#X restore 327 48 pd edit; -#X obj 61 345 print; -#N canvas 276 200 290 224 once 0; -#X obj 38 47 t b b f; -#X msg 56 85 1; -#X obj 31 108 f 0; -#X obj 31 131 pack 0 0; -#X obj 31 156 route 0; +#X floatatom 57 71 4 0 0 0 - - -, f 4; +#X floatatom 108 49 6 0 0 0 - - -, f 6; +#X floatatom 366 48 7 0 0 0 - - -, f 7; +#X obj 241 159 ftom; +#X floatatom 241 183 4 0 0 0 - - -, f 4; +#X floatatom 287 159 9 0 0 0 - - -, f 9; +#X floatatom 366 120 9 0 0 0 - - -, f 9; +#X floatatom 241 63 4 0 0 0 - - -, f 4; +#X obj 241 85 mtof; +#X text 104 151 (0.01 pixels); +#X msg 108 71 set \$1; +#X text 106 120 shift-click & drag; +#X text 107 135 for fine-tuning; +#X obj 77 199 print; +#N canvas 133 180 290 126 once 0; #X obj 38 24 inlet; -#X obj 31 180 outlet; +#X obj 38 80 outlet; +#X obj 38 53 spigot 1; +#X msg 102 53 0; +#X connect 0 0 2 0; +#X connect 2 0 3 0; +#X connect 2 0 1 0; +#X connect 3 0 2 1; +#X restore 77 175 pd once; +#X obj 108 93 s foo13_rcv; +#X obj 366 71 s goo14_rcv; +#X obj 366 96 r goo14_snd; +#X obj 28 135 nbx 6 15 -1e+37 1e+37 0 0 foo13_snd foo13_rcv empty 45 +7 0 10 -225280 -1109 -1 0 256 0; +#X obj 241 128 nbx 5 18 55 3520 1 0 goo14_snd goo14_rcv log.freq. 10 +-10 0 14 -261234 -159808 -90881 55 72 0; +#X text 363 157 and receive names. Right-; +#X text 363 172 click and choose; +#X text 362 141 [nbx] has settable send; +#X obj 466 48 nbx 5 14 -1e+37 1e+37 0 0 empty empty empty 0 -8 0 10 +-262144 -1 -1 0 256 0; +#X text 168 268 - a float to the left inlet will be displayed \, stored +\, and sent to the outlet.; +#X text 168 338 - a list will be truncated to the first item.; +#X text 98 311 set; +#X text 168 311 - sending a set message followed by a value (e.g. \, +"set 14") will display and store the value without outputting it.; +#X text 97 360 see the following subpatch for messages that change +the gui-properties of [nbx]:; +#N canvas 49 27 446 599 Changing_GUI_Properties 0; +#X text 17 152 log height; +#X text 340 24 no init; +#X msg 350 94 init 1; +#X msg 340 43 init 0; +#X msg 242 64 lin; +#X msg 252 94 log; +#X text 238 24 linear/; +#X text 238 39 logarithmical; +#X text 349 58 init value; +#X text 350 73 on loadbang; +#X obj 242 119 s nbx_rcv; +#X obj 340 119 s nbx_rcv; +#X msg 17 175 log_height 256; +#X obj 17 245 s nbx_rcv; +#X text 346 152 label; +#X msg 346 172 label blabla; +#X text 115 153 change send name; +#X text 220 152 change receive name; +#X obj 117 245 s nbx_rcv; +#X obj 223 245 s nbx_rcv; +#X obj 346 245 s nbx_rcv; +#X msg 117 175 send nbx1_snd; +#X msg 127 200 send nbx_snd; +#X obj 231 222 s z_rcv; +#X msg 223 174 receive z_rcv; +#X msg 231 199 receive nbx_rcv; +#N canvas 372 228 161 250 init 0; +#X obj 16 11 loadbang; +#X obj 16 42 f \$0; +#X msg 16 73 \; \$1-xpos 320 \; \$1-ypos 330 \; \$1-xlabel 0 \; \$1-ylabel +-8 \; \$1-font-size 10 \; \$1-width 5 \; \$1-height 14 \; \$1-bg 0 +\; \$1-front 12 \; \$1-label 12; #X connect 0 0 1 0; -#X connect 0 1 2 0; -#X connect 0 2 3 1; -#X connect 1 0 2 1; +#X connect 1 0 2 0; +#X restore 360 400 pd init; +#N canvas 366 206 174 259 flash-time 0; +#X obj 68 180 pack; +#X obj 103 149 t b a; +#X obj 68 205 outlet; +#X obj 103 104 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-bottom empty +0 -8 0 12 -262144 -1 -1 0 256 0; +#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-top empty 0 +-8 0 12 -262144 -1 -1 0 256 0; +#X connect 0 0 2 0; +#X connect 1 0 0 0; +#X connect 1 1 0 1; +#X connect 3 0 0 0; +#X connect 4 0 1 0; +#X coords 0 -1 1 1 48 42 2 100 100; +#X restore 124 44 pd flash-time; +#X text 121 23 output-range; +#X text 173 46 1.bottom; +#X text 173 66 2.top; +#X msg 124 94 range \$1 \$2; +#X obj 124 118 s nbx_rcv; +#X text 15 280 label position; +#X text 137 280 font properties; +#X msg 17 387 label_pos \$1 \$2; +#X msg 139 387 label_font \$1 \$2; +#X text 188 304 1.font(0-2); +#X text 188 325 2.height; +#X text 66 303 1.x-offset; +#X text 66 324 2.y-offset; +#N canvas 366 206 174 259 flash-time 0; +#X obj 68 180 pack; +#X obj 103 149 t b a; +#X obj 68 205 outlet; +#X obj 103 104 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-xlabel empty +0 -8 0 12 -262144 -1 -1 0 256 0; +#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-ylabel empty +0 -8 0 12 -262144 -1 -1 -8 256 0; +#X connect 0 0 2 0; +#X connect 1 0 0 0; +#X connect 1 1 0 1; +#X connect 3 0 0 0; +#X connect 4 0 1 0; +#X coords 0 -1 1 1 48 42 2 100 100; +#X restore 17 302 pd flash-time; +#N canvas 366 206 174 259 flash-time 0; +#X obj 68 180 pack; +#X obj 103 149 t b a; +#X obj 68 205 outlet; +#X obj 103 104 nbx 3 14 0 2 0 0 \$0-dummy \$0-font empty 0 -8 0 12 +-262144 -1 -1 0 256 0; +#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-font-size empty +0 -8 0 12 -262144 -1 -1 10 256 0; +#X connect 0 0 2 0; +#X connect 1 0 0 0; +#X connect 1 1 0 1; +#X connect 3 0 0 0; +#X connect 4 0 1 0; +#X coords 0 -1 1 1 48 42 2 100 100; +#X restore 139 302 pd flash-time; +#X text 18 445 preset-colors; +#X text 119 445 RGB-colors; +#X msg 18 552 color \$1 \$2 \$3; +#N canvas 364 205 306 317 flash-time 0; +#X obj 69 196 t b a; +#X obj 33 262 outlet; +#X obj 33 237 pack 0 0 0; +#X obj 120 197 t b a; +#X obj 103 104 nbx 3 14 0 29 0 0 \$0-dummy \$0-bg empty 0 -8 0 12 -262144 +-1 -1 0 256 0; +#X obj 103 124 nbx 3 14 0 29 0 0 \$0-dummy \$0-front empty 0 -8 0 12 +-262144 -1 -1 12 256 0; +#X obj 103 144 nbx 3 14 0 29 0 0 \$0-dummy \$0-label empty 0 -8 0 12 +-262144 -1 -1 12 256 0; +#X connect 0 0 2 0; +#X connect 0 1 2 1; +#X connect 2 0 1 0; +#X connect 3 0 2 0; +#X connect 3 1 2 2; +#X connect 4 0 2 0; +#X connect 5 0 0 0; +#X connect 6 0 3 0; +#X coords 0 -1 1 1 48 62 2 100 100; +#X restore 18 467 pd flash-time; +#N canvas 0 0 306 317 flash-time 0; +#X obj 96 521 outlet; +#X obj 162 230 t b f; +#X obj 96 268 +; +#X obj 96 293 t b f; +#X obj 96 324 +; +#X obj 19 208 * -65536; +#X obj 96 208 * -256; +#X obj 162 208 * -1; +#X obj 96 355 - 1; +#X obj 96 385 list prepend 0; +#X obj 96 410 route 0 1 2; +#X obj 96 497 pack 0 0 0; +#X obj 115 456 t b a; +#X obj 168 455 t b a; +#X obj 104 124 vradio 15 1 0 3 empty empty empty 0 -8 0 10 -262144 +-1 -1 0; +#X text 120 120 1.bg; +#X text 120 137 2.front; +#X text 120 153 3.label; +#X obj 103 105 nbx 3 14 0 255 0 0 \$0-dummy \$0-r empty 0 -8 0 10 -262144 +-258113 -1 0 256 0; +#X obj 133 105 nbx 3 14 0 255 0 0 \$0-dummy \$0-g empty 0 -8 0 10 -262144 +-13381 -1 0 256 0; +#X obj 163 105 nbx 3 14 0 255 0 0 \$0-dummy \$0-b empty 0 -8 0 10 -262144 +-4160 -1 0 256 0; +#X connect 1 0 2 0; +#X connect 1 1 2 1; #X connect 2 0 3 0; #X connect 3 0 4 0; -#X connect 4 0 6 0; -#X connect 5 0 0 0; -#X restore 61 322 pd once; -#X obj 249 87 x_all_guis aaa bbb ccc ddd eee fff ggg hhh iii; -#X text 218 387 updated for Pd version 0.35; -#X text 42 388 graz \, austria 2002; -#X text 192 13 gui-number-box:; -#X obj 106 84 s foo13_rcv; -#X obj 183 133 s goo14_rcv; -#X obj 221 244 r goo14_snd; -#X obj 116 302 r foo13_snd; -#X obj 47 172 nbx 4 15 100 300 0 0 foo13_snd foo13_rcv empty 45 7 192 -10 -225280 -1109 -1 100 256; -#X obj 111 200 nbx 5 18 55 3520 1 0 goo14_snd goo14_rcv log.freq. 45 --10 192 14 -261681 -260818 -90881 55 72; -#X obj 464 114 nbx 5 14 -1e+37 1e+37 0 0 hhh hhh empty 45 7 192 10 --262144 -1 -1 0 256; -#X connect 1 0 6 0; -#X connect 2 0 39 0; -#X connect 3 0 39 0; -#X connect 7 0 39 0; -#X connect 8 0 2 0; -#X connect 10 0 23 0; -#X connect 11 0 36 0; +#X connect 3 1 4 1; +#X connect 4 0 8 0; +#X connect 5 0 4 0; +#X connect 6 0 2 0; +#X connect 7 0 1 0; +#X connect 8 0 9 0; +#X connect 9 0 10 0; +#X connect 10 0 11 0; +#X connect 10 1 12 0; +#X connect 10 2 13 0; +#X connect 11 0 0 0; +#X connect 12 0 11 0; +#X connect 12 1 11 1; +#X connect 13 0 11 0; +#X connect 13 1 11 2; +#X connect 14 0 9 1; +#X connect 18 0 5 0; +#X connect 19 0 6 0; +#X connect 20 0 7 0; +#X coords 0 -1 1 1 102 74 2 100 100; +#X restore 120 467 pd flash-time; +#X text 67 469 1.bg; +#X text 67 489 2.front; +#X text 67 510 3.label; +#X text 348 445 delta; +#X text 236 445 position; +#X msg 237 540 pos \$1 \$2; +#X msg 349 540 delta \$1 \$2; +#X obj 349 516 list; +#X obj 349 467 bng 20 250 50 0 empty empty empty 17 7 0 10 -262144 +-1 -1; +#N canvas 366 206 174 259 flash-time 0; +#X obj 68 180 pack; +#X obj 103 149 t b a; +#X obj 68 205 outlet; +#X obj 103 104 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-xpos empty 0 +-8 0 12 -262144 -1 -1 320 256 0; +#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-ypos empty 0 +-8 0 12 -262144 -1 -1 330 256 0; +#X connect 0 0 2 0; +#X connect 1 0 0 0; +#X connect 1 1 0 1; +#X connect 3 0 0 0; +#X connect 4 0 1 0; +#X coords 0 -1 1 1 48 42 2 100 100; +#X restore 237 467 pd flash-time; +#N canvas 366 206 174 259 flash-time 0; +#X obj 68 180 pack; +#X obj 103 149 t b a; +#X obj 68 205 outlet; +#X obj 103 104 nbx 3 14 -20 20 0 0 \$0-dummy \$0-xdelta empty 0 -8 +0 12 -262144 -1 -1 0 256 0; +#X obj 103 124 nbx 3 14 -20 20 0 0 \$0-dummy \$0-ydelta empty 0 -8 +0 12 -262144 -1 -1 0 256 0; +#X connect 0 0 2 0; +#X connect 1 0 0 0; +#X connect 1 1 0 1; +#X connect 3 0 0 0; +#X connect 4 0 1 0; +#X coords 0 -1 1 1 48 42 2 100 100; +#X restore 378 467 pd flash-time; +#X obj 304 291 cnv 15 92 92 empty empty empty 20 12 0 14 -1 -66577 +0; +#X obj 305 292 cnv 15 90 90 empty empty empty 20 12 0 14 -261682 -66577 +0; +#X obj 320 330 nbx 5 14 -1e+37 1e+37 0 0 nbx_snd nbx_rcv my_nbx 0 -8 +0 10 -262144 -33289 -33289 0 256 0; +#X obj 17 412 s nbx_rcv; +#X obj 139 412 s nbx_rcv; +#X obj 18 577 s nbx_rcv; +#X obj 349 577 s nbx_rcv; +#X obj 237 577 s nbx_rcv; +#N canvas 366 206 174 259 flash-time 0; +#X obj 68 180 pack; +#X obj 103 149 t b a; +#X obj 68 205 outlet; +#X obj 103 104 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-width empty +0 -8 0 12 -262144 -1 -1 5 256 0; +#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-height empty +0 -8 0 12 -262144 -1 -1 14 256 0; +#X connect 0 0 2 0; +#X connect 1 0 0 0; +#X connect 1 1 0 1; +#X connect 3 0 0 0; +#X connect 4 0 1 0; +#X coords 0 -1 1 1 48 42 2 100 100; +#X restore 17 44 pd flash-time; +#X obj 17 118 s nbx_rcv; +#X text 66 46 1.width; +#X text 66 66 2.height; +#X text 14 23 dimensions; +#X msg 17 94 size \$1 \$2; +#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 [nbx] Changing GUI Properties through Messages; +#X msg 356 197 label my_nbx; +#X text 285 466 1.x-pos; +#X text 285 488 2.y-pos; +#X connect 2 0 11 0; +#X connect 3 0 11 0; +#X connect 4 0 10 0; +#X connect 5 0 10 0; #X connect 12 0 13 0; -#X connect 17 0 18 0; -#X connect 18 0 40 0; -#X connect 23 0 35 0; -#X connect 30 0 29 0; -#X connect 37 0 15 0; -#X connect 38 0 9 0; -#X connect 39 0 30 0; -#X connect 39 0 1 0; -#X connect 40 0 12 0; -#X connect 40 0 14 0; +#X connect 15 0 20 0; +#X connect 21 0 18 0; +#X connect 22 0 18 0; +#X connect 24 0 19 0; +#X connect 25 0 23 0; +#X connect 27 0 31 0; +#X connect 31 0 32 0; +#X connect 35 0 62 0; +#X connect 36 0 63 0; +#X connect 41 0 35 0; +#X connect 42 0 36 0; +#X connect 45 0 64 0; +#X connect 46 0 45 0; +#X connect 47 0 45 0; +#X connect 53 0 66 0; +#X connect 54 0 65 0; +#X connect 55 0 54 0; +#X connect 56 0 55 0; +#X connect 57 0 53 0; +#X connect 58 0 55 1; +#X connect 67 0 72 0; +#X connect 72 0 68 0; +#X connect 75 0 20 0; +#X restore 170 394 pd Changing_GUI_Properties; +#N canvas 73 200 428 314 nbx-creation-arguments 0; +#X text 21 37 "nbx" can be called with 18 creation arguments. These +are not "optional" - all parameters must be filled or the gui-bng will +not instantiate correctly.; +#X text 21 171 For example \, click the msg-box to dynamically create +an nbx:; +#X obj 22 235 s pd-nbx-creation-arguments; +#X text 22 97 nbx creation arguments: xSize ySize rangeBtm rangeTop +Logarithmic Init sendName receiveName Label labelXOff labelYOff Font# +fontsize bgColor foregroundColor lblColor initValue logHeight; +#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 [nbx] Creation Arguments; +#X msg 22 193 obj 150 280 nbx 5 14 0 127 0 1 send receive Maia 15 -8 +0 13 14 12 23 63 256; +#X connect 6 0 2 0; +#X restore 170 524 pd nbx-creation-arguments; +#X text 168 465 - if you create an [nbx] object without arguments \, +default values are chosen for the GUI-properties. See the subpatch +below to learn how to dynamically instantiate a [nbx] with custom properties: +; +#X text 115 208 Use the UP- \, DOWN- \, LEFT- or RIGHT-key to move +a selected gui-object. Right-click and choose "Properties" to modify +its appearance.; +#X text 362 188 "Properties" to set them.; +#X text 11 23 gui-number box; +#X text 97 466 18; +#X text 215 551 (c) musil@iem.kug.ac.at; +#X text 257 564 IEM KUG; +#X text 232 576 graz \, austria 2002; +#X text 426 9 [my_numbox] or [nbx]; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X text 98 295 bang; +#X text 168 295 - output the current value; +#X connect 13 0 16 0; +#X connect 14 0 36 0; +#X connect 15 0 36 0; +#X connect 17 0 36 0; +#X connect 18 0 14 0; +#X connect 19 0 28 0; +#X connect 20 0 34 0; +#X connect 21 0 22 0; +#X connect 25 0 26 0; +#X connect 26 0 37 0; +#X connect 28 0 33 0; +#X connect 32 0 31 0; +#X connect 35 0 24 0; +#X connect 36 0 32 0; +#X connect 36 0 13 0; +#X connect 37 0 21 0; +#X connect 37 0 23 0; diff --git a/pd/doc/5.reference/openpanel-help.pd b/pd/doc/5.reference/openpanel-help.pd index b8b7396a4..5b504dfcb 100644 --- a/pd/doc/5.reference/openpanel-help.pd +++ b/pd/doc/5.reference/openpanel-help.pd @@ -1,19 +1,72 @@ -#N canvas 70 117 585 333 12; -#X obj 128 196 openpanel; -#X msg 128 108 bang; -#X obj 128 221 print; -#X text 31 11 openpanel -- query you for a filename; -#X text 48 278 see also:; -#X obj 136 279 savepanel; -#X text 28 44 When Openpanel gets a "bang" an "Open file" browser appears -on the screen. If you select a file \, its name appears on the outlet. +#N canvas 431 36 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 openpanel 3 12 0 +18 -204280 -1 0; +#X obj 0 310 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 485 284 494 344 META 0; +#X text 12 105 LIBRARY internal; +#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 125 AUTHOR Miller Puckette; +#X text 12 185 HELP_PATCH_AUTHORS Updated for Pd version 0.40. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 5 KEYWORDS control GUI; +#X text 12 45 DESCRIPTION query the user for a filename; +#X text 12 65 INLET_0 bang symbol; +#X text 12 85 OUTLET_0 symbol; +#X text 12 165 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 432 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 475 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 503 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#X text 98 479 (none); +#N canvas 216 520 428 109 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 obj 22 43 savepanel; +#X obj 92 43 soundfiler; +#X text 8 2 [openpanel] Related Objects; +#X restore 102 597 pd Related_objects; +#X obj 78 319 cnv 17 3 105 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 441 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 484 11 openpanel; +#X msg 171 104 bang; +#X obj 171 217 print; +#X text 211 104 Starts open panel in current directory; +#X msg 187 130 symbol /tmp; +#X msg 187 159 symbol C:/; +#X text 265 130 Starts in a specified directory; +#X text 98 318 bang; +#X text 98 364 symbol; +#X text 98 398 list; +#X text 168 318 - a "bang" to the inlet causes an "Open file" browser +to appear on the screen. If you select a file \, the filename appears +at the outet.; +#X text 168 364 - sending a symbol will start the "Open file" browser +in the specified directory.; +#X text 98 440 symbol; +#X obj 171 192 openpanel; +#X text 167 440 - the filename of the selected file is output from +the outlet.; +#X text 99 507 Unlike other symbol-handling objects in Pd \, [openpanel] +can output a symbol that contains spaces \, which will get handled +propertly by an object like [soundfiler]. However \, if you set this +filename to a message box and save the patch \, the symbol will be +converted to a list the next time you open the patch.; +#X text 11 23 query the user for a filename; +#X text 168 398 - a list starting with a symbol will be truncated to +the first element.; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide ; -#X text 285 289 updated for Pd version 0.40.; -#X text 178 109 Starts open panel in current directory; -#X msg 144 136 symbol /tmp; -#X msg 146 161 symbol C:/; -#X text 252 137 Starts in a specified directory; -#X connect 0 0 2 0; -#X connect 1 0 0 0; -#X connect 9 0 0 0; -#X connect 10 0 0 0; +#X connect 12 0 24 0; +#X connect 15 0 24 0; +#X connect 16 0 24 0; +#X connect 24 0 13 0; diff --git a/pd/doc/5.reference/operators-help.pd b/pd/doc/5.reference/operators-help.pd index 64b47e4d4..bbfa0bc87 100644 --- a/pd/doc/5.reference/operators-help.pd +++ b/pd/doc/5.reference/operators-help.pd @@ -1,31 +1,105 @@ -#N canvas 52 109 635 355 12; -#X obj 29 172 +; -#X floatatom 41 113 0 0 0; -#X floatatom 29 197 0 0 0; -#X floatatom 51 143 0 0 0; -#X msg 29 82 bang; -#X obj 44 6 +; -#X text 27 307 see also:; -#X obj 186 314 +~; -#X text 79 5 (etc.) -- ARITHMETIC; -#X text 72 88 Bang outputs sum; -#X text 79 112 Numbers in left inlet add and output sum; -#X text 93 142 Numbers in right inlet only change the inlet's value; -#X obj 113 314 trigger; -#X text 348 325 last updated for version 0.33; -#X text 93 189 You can supply a creation argument to initialize the right inlet:; -#X text 29 29 The floating point binary operators are + \, - \, * \, / \, pow \, max \, and min. Note that pow only works for nonnegative mantissas.; -#X floatatom 101 225 0 0 0; -#X floatatom 101 275 0 0 0; -#X obj 101 250 pow -1; -#X floatatom 179 225 0 0 0; -#X floatatom 179 275 0 0 0; -#X obj 179 250 min 20; -#X connect 0 0 2 0; -#X connect 1 0 0 0; -#X connect 3 0 0 1; -#X connect 4 0 0 0; -#X connect 16 0 18 0; -#X connect 18 0 17 0; -#X connect 19 0 21 0; -#X connect 21 0 20 0; +#N canvas 428 38 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 (binops1) 3 12 0 +18 -204280 -1 0; +#X obj 0 324 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 468 268 507 358 META 0; +#X text 12 125 LIBRARY internal; +#X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 45 LICENSE SIBSD; +#X text 12 145 AUTHOR Miller Puckette; +#X text 12 205 HELP_PATCH_AUTHORS This help patch was updated for Pd +version 0.35 test 28 by Dave Sabine as part of a project called pddp +proposed by Krzysztof Czaja to build comprehensive documentation for +Pd. Jonathan Wilkes revised the patch to conform to the PDDP template +for Pd version 0.42.; +#X text 12 85 DATATYPE_IN bang float list; +#X text 12 105 DATATYPE_OUT float; +#X text 12 65 DESCRIPTION binary arithmetic operators; +#X text 12 5 NAME + - * / pow max min; +#X text 12 25 KEYWORDS control trigonometry; +#X text 12 185 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 442 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 479 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 523 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 215 519 428 109 Related_objects 0; +#X obj 0 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X obj 56 75 cos~; +#X obj 88 75 osc~; +#X obj 22 75 expr; +#X obj 22 42 sin; +#X obj 48 42 cos; +#X obj 75 42 tan; +#X obj 108 42 atan; +#X obj 143 42 atan2; +#X obj 181 42 exp; +#X obj 208 42 log; +#X obj 236 42 abs; +#X obj 265 42 sqrt; +#X text 7 1 (arithmetic_operators) Related Objects; +#X restore 102 597 pd Related_objects; +#X obj 78 333 cnv 17 3 70 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 386 list; +#X text 98 450 float; +#X obj 78 451 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 414 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X text 98 413 float; +#X text 78 499 1) float; +#X obj 364 12 +; +#X obj 389 12 -; +#X obj 415 12 *; +#X obj 441 12 /; +#X obj 467 12 pow; +#X obj 492 12 max; +#X obj 518 12 min; +#X obj 128 166 +; +#X msg 94 124 3 4; +#X floatatom 128 124 5 0 0 0 - - -, f 5; +#X floatatom 169 124 5 0 0 0 - - -, f 5; +#X floatatom 128 193 5 0 0 0 - - -, f 5; +#X msg 54 124 bang; +#X text 98 332 bang; +#X text 98 357 float; +#X text 168 413 - a float to the right inlet is stored.; +#X text 168 332 - perform the operation using the last values stored +at the inlets.; +#X text 168 357 - store the incoming value at the left inlet and perform +the operation.; +#X text 168 384 - a pair of floats will be distributed to the two inlets. +; +#X floatatom 259 124 5 0 0 0 - - -, f 5; +#X floatatom 259 193 5 0 0 0 - - -, f 5; +#X obj 259 168 * 2; +#X text 118 239 All of these objects share the same behavior.; +#X obj 364 170 pow 4; +#X floatatom 364 193 0 0 0 0 - - -; +#X floatatom 403 126 5 0 0 0 - - -, f 5; +#X floatatom 364 126 5 0 0 0 - - -, f 5; +#X obj 98 542 pddp/pddplink pow-help.pd; +#X text 168 499 - initializes the value of the right inlet.; +#X text 98 527 Click below for individual help patches:; +#X obj 98 557 pddp/pddplink min-help.pd; +#X obj 98 572 pddp/pddplink max-help.pd; +#X text 11 23 binary arithmetic operators; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X connect 22 0 26 0; +#X connect 23 0 22 0; +#X connect 24 0 22 0; +#X connect 25 0 22 1; +#X connect 27 0 22 0; +#X connect 34 0 36 0; +#X connect 36 0 35 0; +#X connect 38 0 39 0; +#X connect 40 0 38 1; +#X connect 41 0 38 0; diff --git a/pd/doc/5.reference/osc~-help.pd b/pd/doc/5.reference/osc~-help.pd index 2bd5f0df5..d5631ab58 100644 --- a/pd/doc/5.reference/osc~-help.pd +++ b/pd/doc/5.reference/osc~-help.pd @@ -1,58 +1,96 @@ -#N canvas 85 32 811 508 12; -#X obj 252 320 dac~ 1; -#X obj 252 292 *~; -#X floatatom 156 115 0 0 0; -#X obj 276 264 line~; -#X msg 276 208 0.1 100; -#X msg 295 233 0 100; -#X text 347 203 on; -#X text 344 232 off; -#X text 333 261 envelope; -#X text 333 274 generator; -#X text 260 183 amplitude controls:; -#X text 250 344 audio output; -#X text 424 426 see also:; -#X obj 580 428 cos~; -#X obj 629 428 tabread4~; -#X obj 68 14 osc~; -#X text 142 16 - cosine wave oscillator; -#X obj 126 294 metro 500; -#X obj 126 269 r metro; -#X text 88 344 graph the output; -#X obj 510 427 phasor~; -#X msg 571 79 \; metro 0; -#X msg 570 20 \; pd dsp 1 \; metro 1; -#X floatatom 637 245 0 0 0; -#X obj 637 275 sig~; -#X text 522 266 convert to; -#X text 512 282 audio signal; -#X text 518 305 oscillator; -#X text 479 243 frequency control; -#X obj 637 306 osc~; -#X text 3 120 change frequency; -#X text 244 145 <-- creation argument sets initial frequency; -#X text 231 123 v-- inlet resets phase; -#X graph graph1 0 -1 100 1 94 388 294 488; -#X array array99 100 float; -#X pop; -#X text 16 39 The osc~ object outputs a cosine wave. If no argument is supplied \, the input is taken to be an audio signal. With a floating-point argument \, osc~ takes floating-point messages to change frequency.; -#X text 510 336 invoked without argument to; -#X text 512 360 specify audio signal input; -#X text 2 105 incoming numbers; -#X obj 89 322 tabwrite~ array99; -#X obj 156 144 osc~ 1000; -#X text 546 480 updated for Pd version 0.33; -#X text 655 39 <-Click to start; -#X text 648 88 <-Click to stop; -#X connect 1 0 0 0; -#X connect 2 0 39 0; -#X connect 3 0 1 1; -#X connect 4 0 3 0; -#X connect 5 0 3 0; -#X connect 17 0 38 0; +#N canvas 429 35 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 osc~ 3 12 0 18 -204280 +-1 0; +#X obj 0 358 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 487 285 494 344 META 0; +#X text 12 125 LIBRARY internal; +#X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 145 AUTHOR Miller Puckette; +#X text 12 205 HELP_PATCH_AUTHORS Updated for Pd version 0.33. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 5 KEYWORDS signal trigonometry; +#X text 12 45 DESCRIPTION cosine wave oscillator; +#X text 12 65 INLET_0 signal float; +#X text 12 85 INLET_1 float; +#X text 12 105 OUTLET_0 signal; +#X text 12 185 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 456 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 493 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 567 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 214 518 428 109 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 [osc~] Related Objects; +#X obj 83 42 cos~; +#X obj 127 42 tabread4~; +#X obj 23 42 phasor~; +#X restore 102 597 pd Related_objects; +#X obj 78 367 cnv 17 3 35 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 366 float; +#X obj 78 465 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 410 cnv 17 3 35 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X text 98 409 float; +#X obj 511 9 osc~; +#X obj 229 253 dac~ 1; +#X obj 229 223 *~; +#X floatatom 65 126 0 0 0 0 - - -; +#X obj 243 195 line~; +#X msg 243 139 0.1 100; +#X msg 262 164 0 100; +#X text 314 134 on; +#X text 311 163 off; +#X text 280 188 envelope; +#X text 280 201 generator; +#X text 227 114 amplitude controls:; +#X text 226 270 audio output; +#X obj 83 228 metro 500; +#X text 65 270 graph the output; +#X text 89 132 change frequency; +#X text 91 120 incoming numbers; +#X obj 65 155 osc~ 1000; +#N canvas 0 0 450 300 (subpatch) 0; +#X array \$0-array 100 float 0; +#X coords 0 -1 100 1 150 100 1; +#X restore 374 172 graph; +#X text 98 386 signal; +#X text 98 464 signal; +#X obj 83 203 loadbang; +#X text 98 429 list; +#X text 11 23 cosine wave oscillator; +#X text 168 511 - sets the initial frequency. If the argument is supplied +\, [osc~] takes floating-point messages to change frequency. If no +argument is supplied \, the input is taken to be an audio signal.; +#X text 168 366 - an incoming float changes the frequency.; +#X text 168 386 - an incoming signal changes the frequency.; +#X text 167 409 - a float to the right inlet resets the phase.; +#X text 167 429 - a list will be truncated to the first element.; +#X text 80 511 1) float; +#X text 167 464 - the outgoing cosine wave.; +#X text 22 60 The [osc~] object outputs a cosine wave. With a floating-point +argument \, [osc~] takes floating-point messages to change frequency. +; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 481 54 pddp/dsp; +#X obj 66 253 tabwrite~ \$0-array; +#X connect 15 0 14 0; +#X connect 16 0 30 0; +#X connect 17 0 15 1; #X connect 18 0 17 0; -#X connect 18 0 17 0; -#X connect 23 0 24 0; -#X connect 24 0 29 0; -#X connect 39 0 1 0; -#X connect 39 0 38 0; +#X connect 19 0 17 0; +#X connect 26 0 47 0; +#X connect 30 0 15 0; +#X connect 30 0 47 0; +#X connect 34 0 26 0; diff --git a/pd/doc/5.reference/otherbinops-help.pd b/pd/doc/5.reference/otherbinops-help.pd index 3f3108182..c110a89be 100644 --- a/pd/doc/5.reference/otherbinops-help.pd +++ b/pd/doc/5.reference/otherbinops-help.pd @@ -1,90 +1,519 @@ -#N canvas 20 43 698 447 12; -#X floatatom 524 338 0 0 0; -#X floatatom 353 338 0 0 0; -#X floatatom 298 338 0 0 0; -#X floatatom 413 338 0 0 0; -#X floatatom 467 338 0 0 0; -#X obj 524 311 <; -#X obj 298 262 r left; -#X obj 540 267 r right; -#X floatatom 71 335 0 0 0; -#X floatatom 19 334 0 0 0; -#X floatatom 119 335 0 0 0; -#X floatatom 163 334 0 0 0; -#X obj 16 45 &; -#X obj 66 45 |; -#X obj 118 45 &&; -#X obj 169 45 ||; -#X obj 19 307 &; -#X obj 71 308 |; -#X obj 119 308 &&; -#X obj 163 307 ||; -#X text 13 73 The Logical Operators; -#X obj 19 266 r left; -#X obj 218 266 r right; -#X obj 12 118 >; -#X obj 61 118 >=; -#X obj 114 118 ==; -#X obj 215 119 <=; -#X obj 262 119 <; -#X text 11 153 The Relational Operators; -#X obj 298 312 >; -#X obj 353 312 >=; -#X obj 413 312 ==; -#X obj 467 312 <=; -#X text 16 190 relational output is logical- and negative numbers BAD -in bitwise logical operators. These operators as defined by C programming -language. (inputs and outputs are converted to and from floating point). +#N canvas 432 42 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 (binops2-3) 3 12 +0 18 -204280 -1 0; +#X obj 0 178 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 492 291 494 344 META 0; +#X text 12 85 LIBRARY internal; +#X text 12 125 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 45 LICENSE SIBSD; +#X text 12 105 AUTHOR Miller Puckette; +#X text 12 165 HELP_PATCH_AUTHORS This document was updated for Pd +version 0.35 test 29 by Dave Sabine as part of a project called pddp +proposed by Krzysztof Czaja to build comprehensive documentation for +Pd. Revised by Jonathan Wilkes to conform to the PDDP template.; +#X text 12 25 KEYWORDS control; +#X text 12 65 DESCRIPTION relational and logical operators; +#X text 12 5 NAME > >= == != <= < mod div & | << >> && || %; +#X text 12 145 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 301 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 338 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 381 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 221 481 428 156 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 (binops2-3) Related Objects; +#X text 138 57 - binary arithmetic operators; +#X obj 19 57 pddp/pddplink operators-help.pd; +#X obj 19 77 pddp/pddplink math-help.pd; +#X text 138 77 - higher math in Pd; +#X text 19 37 Links to other control operators; +#X text 19 107 Links to signal operators; +#X obj 19 127 pddp/pddplink sigbinops-help.pd; +#X restore 102 598 pd Related_objects; +#X obj 79 187 cnv 17 3 75 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 309 float; +#X obj 79 310 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 79 273 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X text 98 272 float; +#X text 11 23 relational and logical operators; +#X obj 127 4 >; +#X obj 154 4 >=; +#X obj 182 4 ==; +#X obj 236 4 <=; +#X obj 264 4 <; +#X obj 209 4 !=; +#X obj 290 4 mod; +#X obj 317 4 div; +#X obj 366 4 &; +#X obj 394 4 |; +#X obj 474 4 &&; +#X obj 501 4 ||; +#X obj 421 4 <<; +#X obj 448 4 >>; +#X obj 527 4 %; +#X text 341 4 and; +#X floatatom 254 51 5 0 0 0 - - -, f 5; +#X floatatom 296 51 5 0 0 0 - - -, f 5; +#X obj 254 88 >; +#X floatatom 254 125 5 0 0 0 - - -, f 5; +#X msg 219 51 bang; +#X text 98 186 bang; +#X text 168 186 - a bang outputs the last value computed by the object. ; -#X floatatom 410 65 0 0 0; -#X obj 410 92 s left; -#X floatatom 481 66 0 0 0; -#X obj 481 94 t b f; -#X obj 481 122 s left; -#X obj 541 122 s right; -#X obj 166 118 !=; -#X text 377 42 set left and right inputs here; -#X floatatom 202 335 0 0 0; -#X floatatom 246 334 0 0 0; -#X obj 208 46 <<; -#X obj 259 46 >>; -#X obj 202 308 <<; -#X obj 246 307 >>; -#X text 421 383 last updated for version 0.32; +#X text 98 206 list; +#X text 168 206 - a pair of floats is distributed to the two inlets. +Lists with more than two elements will be truncated.; +#X text 98 236 float; +#X text 168 236 - a float will be stored at the left inlet and used +to evaluate and output a value.; +#X text 167 272 - a float to the right inlet will be stored.; +#X text 168 309 - all relational and logical operators output a float +value.; +#X text 80 358 1) float; +#X text 167 358 - (optional) initial value for the right inlet.; +#X text 142 154 All these objects share similar behavior.; +#X msg 183 51 2 1; +#N canvas 49 53 428 611 understanding_MOD_and_DIV 0; +#X text 24 35 [mod] and [div] are helpful objects to determine whether +or not a fraction produces a remainder \, or to determine the value +of the remainder.; +#X floatatom 28 195 0 0 0 0 - - -; +#X floatatom 28 237 0 0 0 0 - - -; +#X floatatom 140 197 0 0 0 0 - - -; +#X text 60 196 divided by; +#X text 175 198 has a remainder of; +#X floatatom 302 198 0 0 0 0 - - -; +#X obj 28 216 mod; +#X text 25 108 [mod] takes a number in its left inlet and will divide +that number by either the creation argument or the number given at +its left inlet and will produce the value of the remainder at its outlet. +If no creation argument is given \, then the default value is 1; +#X obj 80 178 loadbang; +#X msg 140 178 1; +#X text 25 260 [div] takes a number in its left inlet and will divide +that number by either the creation argument or the number given at +its left inlet and will produce the result without a remainder. If +no creation argument is given \, then the default value is 1; +#X floatatom 28 341 0 0 0 0 - - -; +#X floatatom 28 383 0 0 0 0 - - -; +#X floatatom 140 343 0 0 0 0 - - -; +#X text 60 342 divided by; +#X floatatom 256 344 0 0 0 0 - - -; +#X obj 80 324 loadbang; +#X msg 140 324 1; +#X obj 28 362 div; +#X text 176 343 is equal to; +#X text 294 343 with no remainder.; +#X obj 257 371 /; +#X floatatom 257 391 0 0 0 0 - - -; +#X text 227 389 or; +#X text 297 392 with a remainder.; +#X text 25 413 In the following example \, I've built a metronome which +counts bar numbers and beat numbers: default time signature is 4/4 +(Common Time).; +#X obj 28 474 metro 500; +#X obj 28 455 tgl 15 0 empty empty Start-Stop 20 8 0 8 -262144 -1 -1 +0 1; +#X obj 53 495 + 1; +#X floatatom 28 515 0 0 0 0 - - -; +#X text 57 513 Total Beat Count; +#X obj 28 539 div 4; +#X obj 139 540 mod 4; +#X floatatom 224 581 0 0 0 0 - - -; +#X floatatom 113 580 0 0 0 0 - - -; +#X obj 28 495 f 1; +#X msg 112 453 1; +#X obj 28 559 + 1; +#X obj 139 559 + 1; +#X text 136 453 Reset; +#X text 39 579 Bar number; +#X text 152 581 Beat Count; +#X floatatom 344 491 0 0 0 0 - - -; +#X text 181 491 How many beats per bar?; +#X obj 0 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 7 1 (binops2-3) [mod] and [div]; +#X text 25 76 For example \, 3 / 3 = 1 with a remainder of zero (i.e. +no remainder) \, while \, 4 / 3 = 1 with a remainder of one.; +#X connect 1 0 7 0; +#X connect 2 0 6 0; +#X connect 3 0 7 1; +#X connect 7 0 2 0; +#X connect 9 0 10 0; +#X connect 10 0 3 0; +#X connect 12 0 19 0; +#X connect 12 0 22 0; +#X connect 13 0 16 0; +#X connect 14 0 19 1; +#X connect 14 0 22 1; +#X connect 17 0 18 0; +#X connect 18 0 14 0; +#X connect 19 0 13 0; +#X connect 22 0 23 0; +#X connect 27 0 36 0; +#X connect 28 0 27 0; +#X connect 29 0 36 1; +#X connect 30 0 32 0; +#X connect 30 0 33 0; +#X connect 32 0 38 0; +#X connect 33 0 39 0; +#X connect 36 0 29 0; +#X connect 36 0 30 0; +#X connect 37 0 36 1; +#X connect 38 0 35 0; +#X connect 39 0 34 0; +#X connect 43 0 33 1; +#X connect 43 0 32 1; +#X restore 101 430 pd understanding_MOD_and_DIV; +#N canvas 61 337 428 254 understanding_%_modulus 0; +#X floatatom 21 184 0 0 0 0 - - -; +#X text 18 36 - this object has nothing to do with percentage!; +#X text 18 56 - a modulus is a number by which two given numbers can +be divided and produce the same remainder.; +#X text 18 86 - in the example below: 9 / 2 = 4.5 \, and 7 / 2 = 3.5. +Hence if 7 and 9 are divided by 2 \, then the remainder of both equations +is .5. Therefore \, the modulus of 7 and 9 is "2".; +#X msg 21 135 9; +#X obj 21 163 % 7; +#X floatatom 55 135 5 0 0 0 - - -, f 5; +#X text 18 214 Note that the modulus operator is not a "bitwise" operator +\, but a math function.; +#X obj 0 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 7 1 (binops2-3) Modulus [%]; +#X connect 4 0 5 0; #X connect 5 0 0 0; -#X connect 6 0 29 0; -#X connect 6 0 30 0; -#X connect 6 0 31 0; -#X connect 6 0 32 0; #X connect 6 0 5 0; -#X connect 7 0 29 1; -#X connect 7 0 30 1; -#X connect 7 0 31 1; -#X connect 7 0 32 1; -#X connect 7 0 5 1; -#X connect 16 0 9 0; -#X connect 17 0 8 0; -#X connect 18 0 10 0; -#X connect 19 0 11 0; -#X connect 21 0 16 0; -#X connect 21 0 17 0; -#X connect 21 0 18 0; -#X connect 21 0 19 0; -#X connect 21 0 46 0; -#X connect 21 0 47 0; -#X connect 22 0 19 1; -#X connect 22 0 18 1; -#X connect 22 0 17 1; -#X connect 22 0 16 1; -#X connect 22 0 47 1; -#X connect 22 0 46 1; -#X connect 29 0 2 0; -#X connect 30 0 1 0; -#X connect 31 0 3 0; -#X connect 32 0 4 0; -#X connect 34 0 35 0; -#X connect 36 0 37 0; -#X connect 37 0 38 0; -#X connect 37 1 39 0; -#X connect 46 0 42 0; -#X connect 47 0 43 0; +#X restore 281 562 pd understanding_%_modulus; +#N canvas 87 181 428 280 understanding_&_AND 0; +#X obj 174 221 &; +#X floatatom 228 187 5 0 0 0 - - -, f 5; +#X floatatom 270 188 5 0 0 0 - - -, f 5; +#X msg 174 164 13; +#X msg 203 165 9; +#X text 26 119 13 = "1101"; +#X text 32 131 9 = "1001"; +#X text 19 144 Hence:"1001"; +#X obj 174 124 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 174 142 t b b; +#X floatatom 174 243 0 0 0 0 - - -; +#X obj 0 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 18 35 [&] -- This is the bitwise AND operator which returns +a "1" for each bit position where the corresponding bits of both its +operands are "1".; +#X text 19 77 When comparing the binary codes for 13 and 9 (below) +\, we can see that the first and fourth digits of both codes are "1". +Hence the result will be "1001" -- in other words "9".; +#X text 7 1 (binops2-3) The [&] Object; +#X connect 0 0 10 0; +#X connect 1 0 0 0; +#X connect 2 0 0 1; +#X connect 3 0 0 0; +#X connect 4 0 0 1; +#X connect 8 0 9 0; +#X connect 9 0 3 0; +#X connect 9 1 4 0; +#X restore 281 430 pd understanding_&_AND; +#N canvas 92 219 428 293 understanding_|_OR 0; +#X floatatom 137 261 0 0 0 0 - - -; +#X floatatom 191 205 5 0 0 0 - - -, f 5; +#X floatatom 233 206 5 0 0 0 - - -, f 5; +#X msg 137 177 13; +#X msg 166 178 9; +#X text 26 131 13 = "1101"; +#X text 32 143 9 = "1001"; +#X obj 137 137 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 137 155 t b b; +#X text 19 156 Hence:"1101"; +#X obj 137 239 |; +#X obj 0 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 7 1 (binops2-3) Related Objects; +#X text 17 35 [|] -- This is the bitwise OR operator which returns +a "1" for each bit position where one OR both of the corresponding +bits of both its operands is a "1".; +#X text 18 77 When comparing the binary codes for 13 and 9 (below) +\, we can see that the first and fourth digits of both codes are both +1 and the second position of 13 is a one. Hence the result will be +"1101" -- in other words "13".; +#X connect 1 0 10 0; +#X connect 2 0 10 1; +#X connect 3 0 10 0; +#X connect 4 0 10 1; +#X connect 7 0 8 0; +#X connect 8 0 3 0; +#X connect 8 1 4 0; +#X connect 10 0 0 0; +#X restore 281 452 pd understanding_|_OR; +#N canvas 94 256 428 294 understanding_<<_LEFT-SHIFT 0; +#X obj 21 149 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 21 167 t b b; +#X msg 21 188 13; +#X obj 21 229 <<; +#X floatatom 21 251 5 0 0 0 - - -, f 5; +#X msg 49 188 2; +#X floatatom 87 200 5 0 0 0 - - -, f 5; +#X floatatom 135 200 5 0 0 0 - - -, f 5; +#X text 18 35 [<<] -- This is the left shift operator and it works +by shifting the digits of the binary representation of the first operand +(left inlet) to the left by the number of places specified by the second +operand (right inlet). The spaces created to the right are filled by +zeros \, and any digits falling off the left are discarded. The following +code returns 52 as the binary of 13 ("1101") is shifted two places +to the left giving "110100":; +#X obj 0 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 7 1 (binops2-3) Left-shift; +#X connect 0 0 1 0; +#X connect 1 0 2 0; +#X connect 1 1 5 0; +#X connect 2 0 3 0; +#X connect 3 0 4 0; +#X connect 5 0 3 1; +#X connect 6 0 3 0; +#X connect 7 0 3 1; +#X restore 281 474 pd understanding_<<_LEFT-SHIFT; +#N canvas 82 206 428 348 understanding_>>_RIGHT-SHIFT 0; +#X obj 21 162 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 21 180 t b b; +#X floatatom 21 264 5 0 0 0 - - -, f 5; +#X floatatom 87 213 5 0 0 0 - - -, f 5; +#X floatatom 135 213 5 0 0 0 - - -, f 5; +#X msg 21 201 13; +#X obj 21 242 >>; +#X msg 49 201 2; +#X text 18 35 [>>] -- This is the sign-propagating right shift operator +which shifts the digits of the binary representation of the first operand +(left inlet) to the right by the number of places specified by the +second operand (right inlet) \, discarding any shifted off to the right. +The copies of the leftmost bit are added on from the left \, thereby +preserving the sign of the number. This next examples returns 3 ("11") +as the two right-most bits of 13 ("1101") are shifted off to the right +and discarded.; +#X text 13 291 Note that this object preserves negative values for +negative operands. ("sign-propagating").; +#X obj 0 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 7 1 (binops2-3) Right-shift; +#X connect 0 0 1 0; +#X connect 1 0 5 0; +#X connect 1 1 7 0; +#X connect 3 0 6 0; +#X connect 4 0 6 1; +#X connect 5 0 6 0; +#X connect 6 0 2 0; +#X connect 7 0 6 1; +#X restore 281 496 pd understanding_>>_RIGHT-SHIFT; +#N canvas 94 222 428 418 understanding_&&_LOGICAL-AND 0; +#X msg 52 259 5; +#X obj 21 309 &&; +#X floatatom 21 329 5 0 0 0 - - -, f 5; +#X floatatom 190 267 5 0 0 0 - - -, f 5; +#X text 18 36 [&&] - This is the logical AND operator \, which returns +a Boolean true (a one) if both operands are true. Logically it follows +that if the first operand is false \, then the whole expression is +false \, and this is how the objects works: It first evaluates the +left hand operand (left inlet) and if this returns false (zero) then +\, without going any further \, it returns a false (a zero). Otherwise +it returns the value of the second operand (right inlet).; +#X floatatom 233 267 5 0 0 0 - - -, f 5; +#X text 18 354 Note that this is not a bitwise operator. It compares +floats.; +#X obj 21 217 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 21 235 t b b; +#X msg 21 259 17; +#X text 18 145 In other words \, IF the left inlet is zero \, THEN +output zero. ELSEIF the left inlet is non-zero AND the right inlet +is zero \, then output zero. ELSEIF the left inlet is non-zero AND +the right inlet is non-zero \, THEN output non-zero!; +#X obj 87 217 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 87 235 t b b; +#X msg 87 259 17; +#X msg 118 259 0; +#X obj 0 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 7 1 (binops2-3) Logical-and; +#X connect 0 0 1 1; +#X connect 1 0 2 0; +#X connect 3 0 1 0; +#X connect 5 0 1 1; +#X connect 7 0 8 0; +#X connect 8 0 9 0; +#X connect 8 1 0 0; +#X connect 9 0 1 0; +#X connect 11 0 12 0; +#X connect 12 0 13 0; +#X connect 12 1 14 0; +#X connect 13 0 1 0; +#X connect 14 0 1 1; +#X restore 281 518 pd understanding_&&_LOGICAL-AND; +#N canvas 105 196 428 400 understanding_||_LOGICAL-OR 0; +#X msg 52 250 5; +#X floatatom 21 320 5 0 0 0 - - -, f 5; +#X floatatom 192 251 5 0 0 0 - - -, f 5; +#X floatatom 235 251 5 0 0 0 - - -, f 5; +#X text 18 345 Note that this is not a bitwise operator. It compares +floats.; +#X obj 21 208 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 21 226 t b b; +#X msg 21 250 17; +#X text 18 35 [||] -- This is the logical OR operator and it returns +a value of true (non-zero) if one or both of the operands is true. +It works by first evaluating the left-hand operand (left inlet) and +\, if this is true \, diregarding the right-hand operand (right inlet) +and returning a non-zero. If \, however \, the left-hand operand (left +inlet) is false \, then it returns the value of the right-hand operand +(right inlet).; +#X text 18 146 In other words \, IF the left inlet is non-zero \, THEN +output non-zero. ELSEIF the left inlet is zero AND the right inlet +is zero \, then output zero. ELSEIF the left inlet is zero AND the +right inlet is non-zero \, THEN output non-zero!; +#X obj 21 300 ||; +#X obj 92 207 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 92 225 t b b; +#X msg 92 249 0; +#X msg 123 249 0; +#X obj 0 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 7 1 (binops2-3) Logical-or; +#X connect 0 0 10 1; +#X connect 2 0 10 0; +#X connect 3 0 10 1; +#X connect 5 0 6 0; +#X connect 6 0 7 0; +#X connect 6 1 0 0; +#X connect 7 0 10 0; +#X connect 10 0 1 0; +#X connect 11 0 12 0; +#X connect 12 0 13 0; +#X connect 12 1 14 0; +#X connect 13 0 10 0; +#X connect 14 0 10 1; +#X restore 281 540 pd understanding_||_LOGICAL-OR; +#X text 98 385 Relational Operators; +#X text 278 385 Logical Operators; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#N canvas 76 63 428 577 Relational_Operators 0; +#X obj 0 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X floatatom 227 354 0 0 0 0 - - -; +#X floatatom 277 433 0 0 0 0 - - -; +#X obj 227 333 >; +#X obj 277 412 ==; +#X obj 64 130 == 42; +#X floatatom 64 109 5 0 0 0 - - -, f 5; +#X floatatom 38 156 2 0 0 0 - - -, f 2; +#X obj 63 155 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X msg 34 105 42; +#X text 19 87 For example: IF 42 is equal to x \, then "1" (True); +#X text 83 147 Note that the object outputs 1 or 0 with every incoming +message.; +#X text 20 179 All of these objects operate the same way. The right +inlet or creation argument sets the "condition" to which the incoming +messages are compared. The left inlet accepts numbers or a "bang" -- +a number will reset the value and output a true or false (1 or 0) depending +on whether or not the incoming value meets the necessary condition. +A "bang" will force the object to output a true or false (1 or 0) based +on the value that is already stored in the left inlet.; +#X floatatom 35 280 5 0 0 0 - - -, f 5; +#X floatatom 73 280 5 0 0 0 - - -, f 5; +#X text 20 278 a; +#X text 113 279 b; +#X text 98 355 Is a greater than b?; +#X floatatom 252 394 0 0 0 0 - - -; +#X text 52 394 Is a greater than or equal to b?; +#X obj 252 373 >=; +#X text 171 433 Is a equal to b?; +#X obj 305 450 !=; +#X floatatom 305 470 0 0 0 0 - - -; +#X obj 335 283 r a_b; +#X obj 335 302 unpack f f; +#X obj 35 334 pack f f; +#X obj 35 354 s a_b; +#X text 177 471 Is a NOT equal to b?; +#X floatatom 331 508 0 0 0 0 - - -; +#X text 220 508 Is a less than b?; +#X obj 331 488 <; +#X floatatom 356 547 0 0 0 0 - - -; +#X obj 356 527 <; +#X text 173 547 Is a less than or equal to b?; +#X text 18 36 Most relational operators output a boolean value: true +or false (1 or 0) depending on the relation between the input (left +inlet) and the condition (right inlet or creation argument).; +#X obj 73 306 t b a; +#X text 7 1 (binops2-3) Relational Operators; +#X connect 3 0 1 0; +#X connect 4 0 2 0; +#X connect 5 0 7 0; +#X connect 5 0 8 0; +#X connect 6 0 5 0; +#X connect 9 0 5 0; +#X connect 13 0 26 0; +#X connect 14 0 36 0; +#X connect 20 0 18 0; +#X connect 22 0 23 0; +#X connect 24 0 25 0; +#X connect 25 0 3 0; +#X connect 25 0 20 0; +#X connect 25 0 4 0; +#X connect 25 0 22 0; +#X connect 25 0 31 0; +#X connect 25 0 33 0; +#X connect 25 1 3 1; +#X connect 25 1 20 1; +#X connect 25 1 4 1; +#X connect 25 1 22 1; +#X connect 25 1 31 1; +#X connect 25 1 33 1; +#X connect 26 0 27 0; +#X connect 31 0 29 0; +#X connect 33 0 32 0; +#X connect 36 0 26 0; +#X connect 36 1 26 1; +#X restore 101 408 pd Relational_Operators; +#N canvas 79 189 428 247 Logical_Operators 0; +#X obj -1 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 +0 14 -204280 -1 0; +#X text 7 1 (binops2-3) Logical Operators-- a.k.a. "Bit Twiddling" +; +#X text 24 26 These objects are adopted from the mother of all object +oriented languages: C. They are "bitwise" operators which perform logical +and shift operations on 32-bit numbers.; +#X text 17 194 Hence \, performing "bitwise" relational tests means +that Pd can compare "1101" to "1001" instead of operating with the +integers that are represented by those binary codes.; +#X text 17 116 Well \, these objects perform "relational" tests on +the binary forms of 32-bit numbers. For example \, the number 13 is +represented in your computer's operating system in binary code by "1101" +and the number 9 is "1001". Each of those binary digits is an 8-bit +word: 8 bits * 4 digits = 32-bits!; +#X obj -1 80 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 +0 14 -204280 -1 0; +#X text 7 81 What does "bitwise" mean?; +#X restore 281 408 pd Logical_Operators; +#X connect 30 0 32 0; +#X connect 31 0 32 1; +#X connect 32 0 33 0; +#X connect 34 0 32 0; +#X connect 46 0 32 0; diff --git a/doc/pddp/outlet-help.pd b/pd/doc/5.reference/outlet-help.pd similarity index 100% rename from doc/pddp/outlet-help.pd rename to pd/doc/5.reference/outlet-help.pd diff --git a/doc/pddp/outlet~-help.pd b/pd/doc/5.reference/outlet~-help.pd similarity index 100% rename from doc/pddp/outlet~-help.pd rename to pd/doc/5.reference/outlet~-help.pd diff --git a/doc/pddp/output~-help.pd b/pd/doc/5.reference/output~-help.pd similarity index 100% rename from doc/pddp/output~-help.pd rename to pd/doc/5.reference/output~-help.pd diff --git a/pd/doc/5.reference/pack-help.pd b/pd/doc/5.reference/pack-help.pd index c979d4805..87c750ea1 100644 --- a/pd/doc/5.reference/pack-help.pd +++ b/pd/doc/5.reference/pack-help.pd @@ -1,37 +1,208 @@ -#N canvas 14 8 809 354 12; -#X floatatom 19 86 0 0 0; -#X msg 29 115 bang; -#X floatatom 49 138 0 0 0; -#X floatatom 188 138 0 0 0; -#X obj 19 254 print; -#X msg 86 138 symbol cat; -#X obj 82 9 pack; -#X text 28 319 See also; -#X obj 106 321 unpack; -#X text 14 34 The pack object takes a series of inputs and outputs -a concatenated list. The number of creation arguments determines the -number of inlets.; -#X text 60 85 <-- number in first inlet generates output; -#X text 70 114 <-- bang generates output without resetting first value +#N canvas 429 37 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 pack 3 12 0 18 -204280 +-1 0; +#X obj 0 113 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 482 257 494 370 META 0; +#X text 12 125 LIBRARY internal; +#X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 145 AUTHOR Miller Puckette; +#X text 12 205 HELP_PATCH_AUTHORS This help patch was updated for Pd +version 0.35 test 26 by Dave Sabine as part of a project called pddp +proposed by Krzysztof Czaja to build comprehensive documentation for +Pd. Jonathan Wilkes revised the patch to conform to the PDDP template +for Pd version 0.42.; +#X text 12 45 DESCRIPTION combine several atoms into one message; +#X text 12 65 INLET_0 anything; +#X text 12 85 INLET_N float symbol pointer; +#X text 12 105 OUTLET_0 list symbol pointer float; +#X text 12 5 KEYWORDS control needs_work list_op; +#X text 12 185 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 394 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 459 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 565 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 217 333 428 296 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 [pack] Related Objects; +#X text 20 163 These objects are offered in Pd only if you have downloaded +and properly installed the appropriate library. These objects may or +may not exist in a single library.; +#X text 19 212 The best places to find information about Pd's libraries +is:; +#X text 16 234 www.puredata.org and click on "Downloads" then "Software" ; -#X text 226 135 <-- numbers and symbols in the corresponding inlets -change the values without causing output (see "trigger" for a way to -change this behavior.); -#X text 250 187 <-- as with any Pd object \, you can send a list whose -atoms are automatically distributed to the corresponding inlets.; -#X msg 175 190 1 2 dog; -#X obj 167 321 trigger; -#X obj 19 227 pack 100 0 s 0; -#X text 121 9 - combine several atoms into one message; -#X text 155 226 <-- creation arguments specify the number of inlets -and their types: a number make a numeric outlet (and initializes the -value). A symbol argument can start with "s" \, "f" \, or "p" to specify -a "symbol" \, "float" (number) \, or pointer outlet.; -#X text 538 331 updated for Pd version 0.34; -#X connect 0 0 16 0; -#X connect 1 0 16 0; -#X connect 2 0 16 1; -#X connect 3 0 16 3; -#X connect 5 0 16 2; -#X connect 14 0 16 0; -#X connect 16 0 4 0; +#X text 17 250 or; +#X text 18 264 iem.kug.ac.at/pdb/; +#X obj 20 36 pddp/helplink zexy/pack~; +#X obj 20 51 pddp/helplink zexy/unpack~; +#X obj 20 66 pddp/helplink zexy/tabdump; +#X obj 20 81 pddp/helplink zexy/niagara; +#X obj 20 96 pddp/helplink zexy/packel; +#X obj 20 111 pddp/helplink zexy/repack; +#X obj 20 126 pddp/helplink zexy/drip; +#X obj 20 141 pddp/helplink zexy/sort; +#X restore 102 597 pd Related_objects; +#X obj 78 120 cnv 17 3 225 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 266 list; +#X obj 78 401 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 350 cnv 17 3 37 empty \$0-pddp.cnv.let.n n 5 9 0 16 -228856 +-162280 0; +#X obj 511 10 pack; +#X text 98 186 symbol; +#X text 98 119 bang; +#X text 98 147 float; +#X text 98 226 pointer; +#X text 98 400 list; +#N canvas 82 45 428 551 pack_peculiarities 0; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X msg 25 103 bang; +#X obj 25 123 pack 100 0 s 42; +#X text 25 162 In the same example \, this [pack] object will recognize +floats in the first \, second \, and fourth inlet \; it will recognize +symbols in the third inlet. If it receives anything else \, then you'll +see the "no method for ___" error message in the terminal window.; +#X obj 26 282 pack 100 0 s 42; +#X msg 26 238 400 1 cat 38; +#X text 111 238 This works.; +#X msg 38 260 cat dog 42 earth; +#X obj 31 448 pack cat; +#X text 25 333 So \, if [pack] understands that "100" is a float and +can therefore understand all incoming numbers to that inlet...then +you might assume that the word "cat" could be written as a creation +argument and [pack] should understand all incoming symbols. But that's +NOT the case. If you try to define a [pack] symbol with the word "cat" +in a creation argument \, you'll get a "bad type" error.; +#X text 39 430 WRONG; +#X obj 143 452 pack symbol; +#X text 223 442 CORRECT; +#X obj 143 473 print this_package; +#X msg 143 431 cat; +#X text 41 298 Note that the "s" above is an abbreviation for "symbol". +; +#X obj 31 525 pack bang; +#X text 30 492 Same problem with bangs! This [pack] object creates +an error.; +#X obj 25 144 print package_1; +#X obj 26 315 print package_2; +#X text 145 261 This doesn't work - the data types; +#X text 144 278 don't correspond with the arguments.; +#X text 20 32 In the example below \, the creation arguments are "100" +\, "0" \, a "symbol" \, and "42". Hence \, when [pack] receives a bang +\, it will send that information to its outlet as a list - or 'package' +- which will be printed in your terminal window.; +#X text 8 2 [pack] Peculiarities; +#X connect 1 0 2 0; +#X connect 2 0 18 0; +#X connect 4 0 19 0; +#X connect 5 0 4 0; +#X connect 7 0 4 0; +#X connect 11 0 13 0; +#X connect 14 0 11 0; +#X restore 171 545 pd pack_peculiarities; +#X text 168 400 - [pack] will output its package (i.e. \, the list +of values) when it receives a message to its left inlet.; +#N canvas 72 44 466 546 Another_example_using_pack 0; +#X text 181 97 is the same as; +#X obj 23 517 print my_package; +#X msg 46 285 1 2 dog; +#X obj 23 211 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X floatatom 55 390 5 0 0 0 - - -, f 5; +#X floatatom 53 343 5 0 0 0 - - -, f 5; +#X msg 129 450 100 earth me 42; +#X text 19 38 Perhaps the best way to build creation arguments is to +define the data types that [pack] should expect at each inlet: (i.e. +floats \, symbols \, or pointers -- or their abbreviations f \, s \, +or p); +#X obj 22 97 pack float symbol pointer; +#X obj 276 98 pack f s p; +#X msg 36 261 42 24 dog cat 1 2; +#X obj 23 497 pack f f s s f f; +#X text 42 205 Any message to the first inlet will force [pack] to +output its package - its list of values. A bang to the first inlet +will force [pack] to output the current values without resetting any +of them.; +#X text 101 380 This number box will update each of the 'float' values +and will NOT output the package - because the first inlet is not receiving +a message - to change this behavior \, you should explore the [trigger] +object.; +#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 [pack] Another Example; +#X text 20 124 [pack] can be created with any number of creation arguments. +There will be one inlet created for each argument and the values of +each [pack]ed element can be updated at any time using the separate +inlets \; or they can be updated simoultaneously with a list of messages +to its first inlet.; +#X text 151 261 This list contains new values for each item.; +#X text 97 280 This list doesn't contain enough items \; so it resets +only the first three items \, uses the previous values for the other +three items \, and then outputs the entire package.; +#X text 99 340 A new value for the first item will reset the it and +force [pack] to output the entire package of stored values.; +#X text 129 481 this list will cause an error.; +#X text 128 467 Lists can only be sent to the first inlet --; +#X connect 2 0 11 0; +#X connect 3 0 11 0; +#X connect 4 0 11 1; +#X connect 4 0 11 4; +#X connect 4 0 11 5; +#X connect 5 0 11 0; +#X connect 6 0 11 1; +#X connect 10 0 11 0; +#X connect 11 0 1 0; +#X restore 101 573 pd Another_example_using_pack; +#X obj 394 69 pack; +#X obj 394 91 print; +#X msg 432 46 2; +#X floatatom 394 46 5 0 0 0 - - -, f 5; +#X text 98 427 Note: [pack] may output a float \, symbol \, or pointer +if only one argument is specified.; +#X text 11 23 combine several atoms into one message; +#X text 23 46 The [pack] object takes a series of inputs and then outputs +a concatenated list. By default \, [pack] has two inlets \, each of +which will accept a float.; +#X text 168 147 - if the first argument is "float" \, "f" \, or a numeric +value (e.g. \, "12" \, "3.4") the first element in the list will be +set to the incoming value \, and [pack] will output its list.; +#X text 168 266 - a list is distributed to among the inlets of [pack]. +Each element must match the atom-type specified by the creation arguments. +Lists with more items than the total number of inlets will be truncated. +; +#X text 168 226 - if the first argument is "pointer" or "p" \, an incoming +pointer will be set to the first item in the list \, and [pack] will +output its list.; +#X text 98 491 float; +#X text 168 476 - the number of arguments determines the number of +inlets (default is two). The symbols described under the "inlets" heading +specify the atom-type of each inlet. You can also use a float to specify +float-type while also initializing that inlet's value. Some peculiarities +described below:; +#X text 80 476 n) symbol atom; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X text 168 186 - if the first argument is "symbol" or "s" \, an incoming +symbol will be set to the first item in the list \, and [pack] will +output its list.; +#X text 98 319 anything; +#X text 168 119 - a "bang" to the first inlet will force [pack] to +output the current package (i.e. \, the list of values).; +#X text 168 319 - an anything will be converted to a list and distributed +in the same manner as a list.; +#X text 98 348 An inlet is created for each argument given. Each may +store a float \, symbol \, or pointer \, depending on the argument +given. These inlets will not accept lists/anythings.; +#X connect 21 0 22 0; +#X connect 23 0 21 1; +#X connect 24 0 21 0; diff --git a/doc/pddp/parazit-help.pd b/pd/doc/5.reference/parazit-help.pd similarity index 100% rename from doc/pddp/parazit-help.pd rename to pd/doc/5.reference/parazit-help.pd diff --git a/pd/doc/5.reference/pd-help.pd b/pd/doc/5.reference/pd-help.pd index ad7c917de..1f9982c78 100644 --- a/pd/doc/5.reference/pd-help.pd +++ b/pd/doc/5.reference/pd-help.pd @@ -1,141 +1,161 @@ -#N canvas 1 -8 631 456 12; -#N canvas 0 0 600 400 (subpatch) 0; -#X restore 23 13 pd; -#X text 57 14 - subpatch; -#X obj 180 13 inlet; -#X text 238 12 - control inlet; -#X obj 410 12 inlet~; -#X text 480 12 - audio inlet; -#X obj 180 41 outlet; -#X text 238 43 - control outlet; -#X obj 410 40 outlet~; -#X text 480 40 - audio outlet; -#X text 15 77 Type "pd" into an object box to make a subpatch. When -in run mode you can click on the object to open the subpatch. You can -name the subpatch with an argument:; -#N canvas 156 300 518 221 my-subpatch 0; -#X text 49 96 this is a subpatch for the "pd" help window.; -#X restore 111 134 pd my-subpatch; -#X text 19 161 and you can put inlets and outlets by making "inlet" -objects \, etc \, in the subpatch (open the patch below to see them.) +#N canvas 430 32 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 pd 3 12 0 18 -204280 +-1 0; +#X obj 0 175 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 484 282 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 225 RELEASE_DATE 2009-06-12; +#X text 12 65 LICENSE SIBSD; +#X text 12 185 AUTHOR Miller Puckette; +#X text 12 245 HELP_PATCH_AUTHORS Updated for Pd v0.41. Revised by +Jonathan Wilkes to conform to the PDDP template for Pd version 0.42. ; -#X obj 361 329 print~; -#X obj 359 249 sig~ 12; -#X floatatom 50 253 0 0 0 0 - - -; -#X floatatom 50 305 0 0 0 0 - - -; -#X text 388 306 (check that audio is on); -#X text 20 232 messages in and out; -#X text 329 226 audio in and out; -#X text 20 426 see also:; -#X obj 104 426 block~; -#X obj 371 307 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 --1 -1; -#X text 358 427 updated for Pd version 0.40.; -#N canvas 60 123 618 466 up/downsampling 0; -#X obj 29 395 print~; -#X obj 47 369 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 -1 --1; -#X obj 152 397 print~; -#X obj 170 371 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 --1 -1; -#X obj 276 395 print~; -#X obj 294 369 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 --1 -1; +#X text 12 5 NAME pd; +#X text 12 25 ALIAS page; +#X text 12 125 INLET_N anything signal; +#X text 12 145 OUTLET_N anything signal; +#X text 12 85 DESCRIPTION subwindow (subpatch); +#X text 12 45 KEYWORDS signal canvas_op; +#X restore 500 597 pd META; +#X obj 0 302 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 432 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 539 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 220 269 428 356 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 [pd] Related Objects; +#X obj 22 43 inlet; +#X obj 22 73 outlet; +#X obj 68 43 inlet~; +#X obj 68 73 outlet; +#X obj 128 43 table; #N canvas 0 0 450 300 (subpatch) 0; -#X array \$0-tab 64 float 3; -#A 0 0 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 -0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0; -#X coords 0 1 64 -1 200 140 1; -#X restore 285 180 graph; -#X obj 354 360 s \$0-tab; -#X msg 353 333 const 0 \, 0 0 1; -#X obj 176 243 print~; -#X obj 176 218 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 --1 -1; -#X obj 24 191 tabreceive~ \$0-tab; -#N canvas 81 269 585 267 test-subpatch-upsampled 0; -#X obj 40 17 block~ 128 1 2; -#X obj 209 149 inlet~ hold; -#X obj 367 153 inlet~ lin; -#X obj 23 146 inlet~; -#X obj 23 202 print~; -#X obj 41 176 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 -1 --1; -#X obj 209 209 print~; -#X obj 227 183 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 --1 -1; -#X obj 366 213 print~; -#X obj 383 187 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 --1 -1; -#X text 42 49 Upsampling methods:; -#X text 206 114 sample/hold; -#X text 337 111 linear interpolation; -#X text 16 114 interleaved zeros; -#X connect 1 0 6 0; -#X connect 2 0 8 0; -#X connect 3 0 4 0; -#X connect 5 0 4 0; -#X connect 7 0 6 0; -#X connect 9 0 8 0; -#X restore 24 295 pd test-subpatch-upsampled; -#N canvas 46 43 585 267 test-subpatch-downsampled 0; -#X obj 23 146 outlet~; -#X obj 209 149 outlet~ hold; -#X obj 367 153 outlet~ lin; -#X text 206 173 sample/hold; -#X text 364 177 linear interpolation; -#X text 197 19 upsampling methods:; -#X obj 40 17 block~ 32 1 0.5; -#X text 18 169 interleaved zeros; -#X obj 21 83 tabreceive~ \$0-tab; -#X connect 8 0 0 0; -#X connect 8 0 1 0; -#X connect 8 0 2 0; -#X restore 28 339 pd test-subpatch-downsampled; -#X text 50 11 When a subpatch is reblocked to a higher or lower sample -rate \, the inlet~ and outlet~ objects offer a choice of three upsampling -methods. (The inlet~ upsamples when entering a subpatch with a higher -sample rate \; the outlet~ upsamples when leaving a subpatch of _lower_ -sample rate \, as demonstrated below.) There is no corresponding choice -of downsampling method - downsampling is done simply by dropping the -extra samples.; -#X connect 1 0 0 0; -#X connect 3 0 2 0; -#X connect 5 0 4 0; -#X connect 8 0 7 0; -#X connect 10 0 9 0; -#X connect 11 0 12 0; -#X connect 11 0 12 1; -#X connect 11 0 12 2; -#X connect 11 0 9 0; -#X connect 13 0 0 0; -#X connect 13 1 2 0; -#X connect 13 2 4 0; -#X restore 20 370 pd up/downsampling; -#N canvas 105 182 600 392 subpatch-with-inlets-and-outlets 0; -#X obj 64 83 inlet; -#X text 16 53 control inlet for receiving messages; -#X floatatom 64 111 0 0 0 0 - - -; -#X floatatom 67 212 0 0 0 0 - - -; -#X obj 67 244 outlet; -#X text 31 182 control outlet for sending message; -#X obj 399 78 inlet~; -#X obj 399 129 print~; -#X msg 414 103 bang; -#X obj 398 271 outlet~; -#X obj 398 245 sig~ 34; -#X text 392 32 same for; -#X text 393 51 signals.; -#X connect 0 0 2 0; +#X coords 0 1 100 -1 200 140 1 0 0; +#X restore 182 44 graph; +#N canvas 0 0 450 300 (subpatch) 0; +#X array \$0-array 100 float 3; +#A 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 +0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 +0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 +0; +#X coords 0 1 100 -1 200 140 1; +#X restore 23 203 graph; +#X restore 102 598 pd Related_objects; +#X obj 78 184 cnv 17 3 110 empty \$0-pddp.cnv.let.n n 5 9 0 16 -228856 +-162280 0; +#N canvas 0 0 450 300 (subpatch) 0; +#X restore 395 11 pd; +#X text 11 23 subwindow (subpatch); +#X text 98 183 anything; +#X text 98 242 signal; +#X text 80 451 1) symbol atom; +#X obj 78 311 cnv 17 3 110 empty \$0-pddp.cnv.let.n n 5 9 0 16 -228856 +-162280 0; +#X text 98 310 anything; +#X text 98 369 signal; +#X obj 101 543 pddp/pddplink all_about_canvas_properties.pd -text all_about_canvas_properties +; +#X text 97 130 You can also change the graphical properties of the +object so that part of the subwindow is visible on the parent (referred +to as "graph on parent" or "gop").; +#N canvas 0 0 450 300 (subpatch) 0; +#X restore 514 11 page; +#X text 420 11 or (deprecated); +#X floatatom 242 86 5 0 0 0 - - -, f 5; +#X text 309 80 For help on inlets/outlets \, see:; +#X obj 308 95 pddp/pddplink inlet-help.pd -text inlet-help; +#X obj 308 110 pddp/pddplink inlet~-help.pd -text inlet~-help; +#X obj 398 95 pddp/pddplink outlet-help.pd -text outlet-help; +#X obj 398 110 pddp/pddplink outlet~-help.pd -text outlet~-help; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 100 560 pddp/pddplink ../2.control.examples/12.PART2.subpatch.pd +-text doc/2.control.examples/12.PART2.subpatch.pd; +#X obj 100 575 pddp/pddplink ../3.audio.examples/G05.execution.order.pd +-text doc/3.audio.examples/G05.execution.order.pd; +#N canvas 559 53 296 107 window_position 1; +#X text 19 8 If you leave open a [pd] subwindow like; +#X text 19 53 patch.; +#X text 19 38 visible the next time you load the; +#X text 19 23 this one and save the patch \, it will be; +#X restore 382 550 pd window_position; +#X text 97 42 The [pd] object provides a way to nest canvases. You +can click on the object to open the subwindow and see the objects inside. +; +#N canvas 1 53 450 300 click_me 0; +#X obj 26 50 inlet; +#X obj 26 209 outlet; +#X text 47 109 Use the [inlet] and [outlet] objects to add inlets and +outlets to your subpatch.; +#X obj 341 52 inlet; +#X floatatom 341 79 5 0 0 0 - - -, f 5; +#X text 46 147 The horizontal order of the [inlet]/[outlet] objects +corresponds to the placement of the inlets/outlets on the [pd] object +itself. I.e. \, the leftmost inlet -> leftmost [inlet] \, rightmost +inlet -> rightmost [inlet] \, and so on.; +#X obj 342 205 outlet; +#X connect 0 0 1 0; #X connect 3 0 4 0; -#X connect 6 0 7 0; -#X connect 8 0 7 0; -#X connect 10 0 9 0; -#X restore 50 279 pd subpatch-with-inlets-and-outlets; -#X text 193 368 <- here are some ugly details on; -#X text 219 386 up/downsampling for inlet~ and outlet~; -#X connect 14 0 25 1; -#X connect 15 0 25 0; -#X connect 22 0 13 0; -#X connect 25 0 16 0; -#X connect 25 1 13 0; +#X restore 179 107 pd click_me; +#X text 168 242 - you can create a signal inlet by placing an [inlet~] +object inside the subpatch. If there are multiple [inlet~] objects +\, their horizontal order corresponds to the inlets drawn on the [pd] +object.; +#X text 168 183 - for sending control messages \, you can create an +inlet by placing an [inlet] object inside the subpatch. If there are +multiple [inlet] objects \, their horizontal order corresponds to the +inlets drawn on the [pd] object.; +#X text 168 369 - you can create a signal outlet by placing an [outlet~] +object inside the subpatch. If there are multiple [outlet~] objects +\, their horizontal order corresponds to the outlets drawn on the [pd] +object.; +#X text 168 310 - for sending control messages you can create one by +placing an [outlet] object inside the subpatch. If there are multiple +[outlet] objects \, their horizontal order corresponds to the outlets +drawn on the [pd] object.; +#X text 167 451 - (optional) specify a name for the subwindow \, which +you can use with the prefix "pd-" to send messages to the subpatch +itself. Duplicate names are allowed (named messages will be passed +to both subpatches). For ease of use \, Pd allows you to edit and change +this argument without destroying the data inside the subpatch.; +#N canvas 250 475 296 200 nesting 0; +#N canvas 258 420 264 105 (subpatch) 0; +#N canvas 252 328 240 113 (subpatch) 0; +#N canvas 203 263 309 126 (subpatch) 0; +#N canvas 240 228 264 118 thats-enough 0; +#X text 84 38 Ok \, that's it.; +#X text 70 53 For real this time.; +#N canvas 264 187 272 64 Really? 0; +#X text 2 27 Seriously \,; +#N canvas 227 161 266 81 What? 0; +#X text 3 58 You're being obsessive.; +#N canvas 89 146 450 72 Who? 0; +#N canvas 160 252 341 101 I 0; +#X text 16 16 Third base!; +#X restore 5 5 pd I don't know.; +#X text 2 39 Who's on first.; +#X restore 7 4 pd Who?; +#X restore 7 0 pd What?; +#X text 2 41 Stop.; +#X restore 197 98 pd Really?; +#X restore 2 102 pd thats-enough; +#X text 44 24 Ok that's enough. These; +#X text 44 39 windows will all go away when; +#X text 44 53 you close the main patch.; +#X restore 138 46 pd; +#X text 70 46 Or this:; +#X restore 105 60 pd; +#X text 91 33 Or this:; +#X restore 130 97 pd; +#X text 19 23 You can of course nest [pd] objects; +#X text 19 38 inside other [pd] objects \, like this:; +#X restore 382 572 pd nesting; +#X connect 21 0 32 1; diff --git a/doc/pddp/pddp-style-guide.pd b/pd/doc/5.reference/pddp-style-guide.pd similarity index 100% rename from doc/pddp/pddp-style-guide.pd rename to pd/doc/5.reference/pddp-style-guide.pd diff --git a/doc/pddp/pddp_open.pd b/pd/doc/5.reference/pddp_open.pd similarity index 100% rename from doc/pddp/pddp_open.pd rename to pd/doc/5.reference/pddp_open.pd diff --git a/doc/pddp/pgmin-help.pd b/pd/doc/5.reference/pgmin-help.pd similarity index 100% rename from doc/pddp/pgmin-help.pd rename to pd/doc/5.reference/pgmin-help.pd diff --git a/doc/pddp/pgmout-help.pd b/pd/doc/5.reference/pgmout-help.pd similarity index 100% rename from doc/pddp/pgmout-help.pd rename to pd/doc/5.reference/pgmout-help.pd diff --git a/pd/doc/5.reference/phasor~-help.pd b/pd/doc/5.reference/phasor~-help.pd index 2da01cf9a..4a50fc311 100644 --- a/pd/doc/5.reference/phasor~-help.pd +++ b/pd/doc/5.reference/phasor~-help.pd @@ -1,36 +1,84 @@ -#N canvas 5 31 889 373 12; -#X graph graph1 0 1 100 -1 67 250 267 350; -#X array array99 100 float; -#X pop; -#X obj 29 181 metro 500; -#X obj 13 126 phasor~; -#X floatatom 13 76 0 0 0; -#X obj 57 12 phasor~; -#X obj 29 156 r metro; -#X obj 13 100 sig~ 890; -#X text 78 75 <-- specify frequency; -#X text 92 98 <-- convert it to audio signal; -#X msg 409 75 \; metro 0; -#X msg 405 18 \; pd dsp 1 \; metro 1; -#X text 494 32 <-- Click to start; -#X text 479 79 <-- Click to stop; -#X text 129 14 - sawtooth generator; -#X text 170 207 <-- graph the output; -#X text 82 128 <-- right inlet resets phase; -#X obj 425 227 phasor~ 440; -#X floatatom 425 203 0 0 0; -#X text 348 118 The phasor~ object outputs a sawtooth signal \, traditionally used for table lookup via cos~ or tabread4~. If no argument is supplied \, the input is taken to be an audio signal \; with a floating-point argument \, phasor~ takes floating-point messages to change frequency.; -#X text 294 246 Invoked above with argument for non-signal input. Incoming messages override the initial value.; -#X text 311 301 see also:; -#X obj 396 301 osc~; -#X obj 439 301 cos~; -#X obj 481 301 tabread4~; -#X text 627 345 updated for Pd version 0.33; -#X obj 13 205 tabwrite~ array99; -#X connect 1 0 25 0; -#X connect 2 0 25 0; -#X connect 3 0 6 0; -#X connect 5 0 1 0; -#X connect 5 0 1 0; -#X connect 6 0 2 0; -#X connect 17 0 16 0; +#N canvas 428 37 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 phasor~ 3 12 0 18 +-204280 -1 0; +#X obj 0 339 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 480 288 494 344 META 0; +#X text 12 125 LIBRARY internal; +#X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 145 AUTHOR Miller Puckette; +#X text 12 205 HELP_PATCH_AUTHORS Updated for Pd version 0.33. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 5 KEYWORDS signal; +#X text 12 45 DESCRIPTION sawtooth generator; +#X text 12 65 INLET_0 float signal; +#X text 12 85 INLET_1 float; +#X text 12 105 OUTLET_0 signal; +#X text 12 185 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 438 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 474 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 547 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 214 520 428 109 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 obj 22 43 osc~; +#X obj 62 43 cos~; +#X obj 103 43 tabread4~; +#X text 8 2 [phasor~] Related Objects; +#X restore 102 598 pd Related_objects; +#X obj 78 348 cnv 17 3 35 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 447 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 392 cnv 17 3 35 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X text 98 391 float; +#X obj 494 12 phasor~; +#N canvas 0 0 450 300 (subpatch) 0; +#X array \$0-array 100 float 0; +#X coords 0 1 100 -1 200 100 1; +#X restore 279 200 graph; +#X obj 84 197 metro 500; +#X floatatom 68 114 0 0 0 0 - - -; +#X text 86 238 graph the output; +#X text 97 114 <- specify frequency; +#X obj 68 142 phasor~ 440; +#X text 145 136 invoked with argument for non-signal input. Incoming +messages override the initial value.; +#X obj 84 172 loadbang; +#X text 98 347 float; +#X text 98 367 signal; +#X text 98 411 list; +#X text 98 446 signal; +#X text 11 23 sawtooth generator; +#X text 168 347 - a float sets the frequency of the sawtooth.; +#X text 168 367 - incoming signal sets the frequency of the sawtooth. +; +#X text 167 391 - resets the phase (range is 0 to 1).; +#X text 167 411 - a list will be truncated to the first element.; +#X text 80 492 1) float; +#X text 63 66 The [phasor~] object outputs a sawtooth signal \, traditionally +used for table lookup via [cos~] or [tabread4~].; +#X text 168 492 - (optional) with a floating-point argument \, [phasor~] +takes floating-point messages to change frequency. If no argument is +supplied \, the input is taken to be an audio signal.; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 480 51 pddp/dsp; +#X obj 98 551 pddp/pddplink ../3.audio.examples/C02.sawtooth-foldover.pd +-text doc/3.audio.exampmles/C02.sawtooth-foldover.pd; +#X obj 98 566 pddp/pddplink ../3.audio.examples/J09.bandlimited.pd +-text doc/3.audio.exampmles/J09.bandlimited.pd; +#X obj 68 221 tabwrite~ \$0-array; +#X connect 14 0 37 0; +#X connect 15 0 18 0; +#X connect 18 0 37 0; +#X connect 20 0 14 0; diff --git a/pd/doc/5.reference/pipe-help.pd b/pd/doc/5.reference/pipe-help.pd index 272057ed6..636abf1ea 100644 --- a/pd/doc/5.reference/pipe-help.pd +++ b/pd/doc/5.reference/pipe-help.pd @@ -1,41 +1,223 @@ -#N canvas 99 89 737 480 12; -#X floatatom 52 127 0 0 0; -#X floatatom 127 227 0 0 0; -#X floatatom 52 284 0 0 0; -#X floatatom 544 281 0 0 0; -#X floatatom 535 392 0 0 0; -#X obj 534 364 pipe 5 6 7 1000; -#X obj 543 307 t f f f; -#X obj 563 338 + 1; -#X obj 597 337 + 2; -#X floatatom 590 390 0 0 0; -#X floatatom 658 391 0 0 0; -#X text 32 433 see also:; -#X text 129 13 pipe -- message "delay line"; -#X obj 52 253 pipe 2000; -#X text 91 125 numbers to store and output later; -#X text 117 148 output all stored messages immediately; -#X msg 63 152 flush; -#X msg 65 180 clear; -#X text 113 180 forget all stored messages; -#X text 91 286 delayed output; -#X obj 116 435 delay; -#X obj 167 435 timer; -#X text 51 42 The Pipe object stores a sequence of messages and outputs them after a specified delay time in miliseconds. You can change the delay time as you wish. The outputs are sorted automatically.; -#X text 140 254 creation argument initializes delay time; -#X text 163 228 set delay time; -#X text 487 449 updated for Pd version 0.33; -#X text 21 330 You can specify compound messages (lists) by adding arguments which set their type and initial value as in "pack." In this case the delay time comes last and is changed by the last inlet. You can also pack symbols and pointers but this feature is UNTESTED.; -#X connect 0 0 13 0; -#X connect 1 0 13 1; -#X connect 3 0 6 0; -#X connect 5 0 4 0; -#X connect 5 1 9 0; -#X connect 5 2 10 0; -#X connect 6 0 5 0; -#X connect 6 1 7 0; -#X connect 6 2 8 0; -#X connect 7 0 5 1; -#X connect 8 0 5 2; -#X connect 13 0 2 0; -#X connect 16 0 13 0; +#N canvas 429 34 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 pipe 3 12 0 18 -204280 +-1 0; +#X obj 0 148 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 485 247 494 386 META 0; +#X text 12 145 LIBRARY internal; +#X text 12 185 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 165 AUTHOR Miller Puckette; +#X text 12 225 HELP_PATCH_AUTHORS This help patch was updated for Pd +version 0.35 test 28 by Dave Sabine as part of a project called pddp +proposed by Krzysztof Czaja to build comprehensive documentation for +Pd. Jonathan Wilkes revised the patch to conform to the PDDP template +for Pd version 0.42.; +#X text 12 5 KEYWORDS control time; +#X text 12 45 DESCRIPTION delay a message - a message "delay line" +; +#X text 12 65 INLET_0 float list symbol pointer bang flush clear; +#X text 12 105 INLET_R float; +#X text 12 85 INLET_N float list symbol pointer bang; +#X text 12 125 OUTLET_N float symbol pointer; +#X text 12 205 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 401 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 456 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 563 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 215 361 428 267 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 obj 23 43 delay; +#X obj 67 43 timer; +#X text 8 2 [pipe] Related Objects; +#X text 20 181 The best places to find information about Pd's libraries +is:; +#X text 21 203 www.puredata.org and click on "Downloads" then "Software" +; +#X text 22 218 or; +#X text 21 233 iem.kug.ac.at/pdb/; +#X text 20 132 This object is offered in Pd only if you have downloaded +and properly installed the appropriate library. It may or may not exist +in a single library.; +#X obj 17 105 pddp/helplink iemlib/t3_delay; +#X restore 102 597 pd Related_objects; +#X obj 78 157 cnv 17 3 160 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 181 float; +#X obj 78 410 cnv 17 3 40 empty \$0-pddp.cnv.let.n n 5 9 0 16 -228856 +-162280 0; +#X obj 78 374 cnv 17 3 17 empty \$0-pddp.cnv.let.r r 5 9 0 16 -228856 +-162280 0; +#X obj 513 11 pipe; +#X text 98 206 symbol; +#X text 98 232 pointer; +#X text 98 259 list; +#X text 98 156 bang; +#X text 98 286 flush; +#X text 98 304 clear; +#X obj 78 328 cnv 17 3 40 empty \$0-pddp.cnv.let.n n 5 9 0 16 -228856 +-162280 0; +#X text 98 373 float; +#N canvas 78 30 428 522 Creation_arguments 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 [pipe] Related Objects; +#X obj 23 61 pipe 1000; +#X obj 20 189 pipe s 1000; +#X text 93 189 A pipe for symbols.; +#X obj 20 282 pipe f s 1000; +#X text 115 282 A pipe for one float \, and one symbol.; +#X msg 20 159 symbol cat; +#X msg 92 159 symbol dog; +#X symbolatom 20 210 10 0 0 0 - - -, f 10; +#X symbolatom 95 303 10 0 0 0 - - -, f 10; +#X floatatom 20 303 5 0 0 0 - - -, f 5; +#X msg 31 261 100 dog; +#X msg 20 240 42 cat; +#X floatatom 21 386 0 0 0 0 - - -; +#X floatatom 21 494 0 0 0 0 - - -; +#X obj 21 412 t f f f; +#X obj 49 443 + 1; +#X obj 77 443 + 2; +#X floatatom 64 493 0 0 0 0 - - -; +#X floatatom 108 494 0 0 0 0 - - -; +#X obj 21 469 pipe f f f 1000; +#X text 19 329 Miller's original example shows how a list of floats +can be delayed by [pipe]. Note that the [trigger] object is used to +ensure that [pipe] receives the messages from right to left order. +; +#X text 18 25 1) If only one creation argument is used \, it defines +the initial length of delay. [pipe] will then expect a float.; +#X text 17 87 2) If two or more arguments are provided \, then all +except for the last will define the data type to be expected at the +corresponding inlet. The delay time is initialized by the LAST creation +argument \, which can be changed by sending a new delay time to the +rightmost inlet.; +#X text 72 240 Messages can be sent as lists like this example.; +#X connect 3 0 9 0; +#X connect 5 0 11 0; +#X connect 5 1 10 0; +#X connect 7 0 3 0; +#X connect 8 0 3 0; +#X connect 12 0 5 0; +#X connect 13 0 5 0; +#X connect 14 0 16 0; +#X connect 16 0 21 0; +#X connect 16 1 17 0; +#X connect 16 2 18 0; +#X connect 17 0 21 1; +#X connect 18 0 21 2; +#X connect 21 0 15 0; +#X connect 21 1 19 0; +#X connect 21 2 20 0; +#X restore 170 543 pd Creation_arguments; +#X text 168 304 - forces [pipe] to forget all stored messages.; +#X text 168 259 - a list to the left inlet will be distributed among +[pipe]'s inlets.; +#X obj 95 104 pipe 1000; +#X floatatom 126 53 5 0 0 0 - - -, f 5; +#X msg 95 53 1; +#X floatatom 95 126 5 0 0 0 - - -, f 5; +#X floatatom 162 53 5 0 0 0 - - -, f 5; +#N canvas 80 25 428 536 More_info 0; +#X obj 1 451 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 +0 14 -204280 -1 0; +#X text 20 80 Like water running through a pipe \, it goes in one end...runs +the length of the pipe...then comes out the other end.; +#X floatatom 23 127 5 0 0 0 - - -, f 5; +#X obj 23 148 pipe 20; +#X floatatom 23 170 5 0 0 0 - - -, f 5; +#X text 20 38 The left inlet accepts numbers \, symbols \, pointers +\, messages \, and lists. The right inlet adjusts the delay time (the +length of the pipe).; +#X floatatom 69 127 5 0 0 0 - - -, f 5; +#X text 111 126 Adjust the length of the pipe.; +#X floatatom 23 298 0 0 0 0 - - -; +#X obj 23 391 pipe 2000; +#X text 62 296 numbers to store and output later; +#X text 88 319 output all stored messages immediately; +#X msg 34 323 flush; +#X msg 51 369 clear; +#X text 99 369 forget all stored messages; +#X text 19 199 [pipe] accepts two very important methods.; +#X text 20 219 1 "flush": forces [pipe] to output all stored messages +immediately.; +#X text 20 248 2 "clear": forces [pipe] to forget all stored messages. +; +#X obj 23 412 print; +#X msg 44 344 bang; +#X text 80 344 output the most recently stored message; +#X text 20 267 3 "bang": repeat the most recently stored message again. +; +#X text 20 473 [pipe] schedules its output immediately after storing +the incoming messages. This means that the delay time can be changed +at runtime without effecting the messages that have already been scheduled +for output.; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 8 449 Rescheduling; +#X text 8 2 [pipe] More Info; +#X connect 2 0 3 0; +#X connect 3 0 4 0; +#X connect 6 0 3 1; +#X connect 8 0 9 0; +#X connect 9 0 18 0; +#X connect 12 0 9 0; +#X connect 13 0 9 0; +#X connect 19 0 9 0; +#X restore 101 572 pd More_info; +#X text 11 23 delay a message - a message "delay line"; +#X text 169 93 The [pipe] object stores a sequence of messages and +outputs them after a specified delay time in milliseconds. You can +change the delay time as you wish. The outputs are sorted automatically. +; +#X text 80 475 1) float; +#X text 98 490 symbol atom; +#X text 168 156 - a bang will send the most recently stored message +to the outlet after the specified delay time.; +#X text 168 181 - a float to the left inlet will be stored \, then +sent to the outlet after the specified delay.; +#X text 168 232 - if the first argument to [pipe] is "p" \, an incoming +pointer will be output after the specified delay.; +#X text 168 206 - if the first argument to [pipe] is "s" \, an incoming +symbol will be output after the specified delay.; +#X msg 51 53 flush; +#X msg 9 53 clear; +#X text 168 286 - forces [pipe] to immediately output all stored messages. +; +#X text 168 373 - the rightmost inlet takes a float value that specifies +the length of the delay (in milliseconds).; +#X text 168 327 - an additional inlet is created for each argument +provided to [pipe] besides the delay time. This makes it possible to +send lists through [pipe].; +#X text 98 422 symbol; +#X text 98 409 float; +#X text 98 435 pointer; +#X text 168 409 - pipe can output symbols \, floats \, pointers. One +outlet is created for each argument provided (besides the final argument +to specify delay time).; +#X text 167 475 - (optional) creation arguments define the data type +to be expected at each inlet: "f" for float (or a float \, like "41" +\, to initialize the value) \, "s" for symbol \, and "p" for pointer. +The final argument defines the initial length of delay. See the subpatch +below for more about the arguments:; +#X obj 9 79 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 -1 +-1; +#X text 98 327 float; +#X text 98 340 symbol; +#X text 98 353 pointer; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X connect 24 0 27 0; +#X connect 25 0 24 0; +#X connect 26 0 24 0; +#X connect 28 0 24 1; +#X connect 38 0 24 0; +#X connect 39 0 24 0; +#X connect 48 0 24 0; diff --git a/doc/pddp/pique-help.pd b/pd/doc/5.reference/pique-help.pd similarity index 100% rename from doc/pddp/pique-help.pd rename to pd/doc/5.reference/pique-help.pd diff --git a/pd/doc/5.reference/plot-help.pd b/pd/doc/5.reference/plot-help.pd index 0a1e4ef59..4fdd91dd7 100644 --- a/pd/doc/5.reference/plot-help.pd +++ b/pd/doc/5.reference/plot-help.pd @@ -1,70 +1,190 @@ -#N struct help-plot-template float x float y array array1 help-plot-array1-template -array array2 help-plot-array2-template array array3 help-plot-array3-template +#N struct plot-help-template float x float y array array1 plot-help-array1-template +array array2 plot-help-array2-template array array3 plot-help-array3-template ; -#N struct help-plot-array1-template float y; -#N struct help-plot-array2-template float x float y; -#N struct help-plot-array3-template float y float w; -#N canvas 477 38 516 229 12; -#N canvas 145 122 626 710 help-plot-template 0; -#X text 29 34 creation arguments:; -#X text 49 241 - RGB color (0=black \, 999=white \, 900=red \, 90=green -\, 9=blue \, 555=grey \, etc.); -#X text 47 271 - line width; -#X text 47 290 - relative x and y location; -#X text 48 310 - x spacing; -#X obj 40 397 plot curve array2 70 3 100 0; -#X obj 31 488 plot curve array3 9 1 120 50 20; -#X obj 45 12 plot array1 500 1 10 15 20; -#X text 30 327 This first example plots the red trace (500) \, width +#N struct plot-help-array1-template float y; +#N struct plot-help-array2-template float x float y; +#N struct plot-help-array3-template float y float w; +#N canvas 429 31 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 plot 3 12 0 18 -204280 +-1 0; +#X obj 0 121 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 540 283 436 344 META 0; +#X text 12 85 LIBRARY internal; +#X text 12 125 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 105 AUTHOR Miller Puckette; +#X text 12 165 HELP_PATCH_AUTHORS Updated for Pd version 0.35. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 5 KEYWORDS control GUI data_structure array; +#X text 12 45 DESCRIPTION draw array elements of scalars; +#X text 12 65 INLET_0 float; +#X text 12 145 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 205 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 229 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 525 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 215 459 428 163 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 [plot] Related Objects; +#X obj 172 53 struct; +#X obj 222 53 drawpolygon; +#X obj 97 53 drawsymbol; +#X obj 302 53 drawcurve; +#X text 17 89 Other Data Structure Objects; +#X obj 255 123 element; +#X obj 86 123 get; +#X obj 117 123 set; +#X obj 146 123 getsize; +#X obj 200 123 setsize; +#X obj 32 123 pointer; +#X obj 26 53 drawnumber; +#X restore 102 597 pd Related_objects; +#X obj 78 130 cnv 17 3 65 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 129 float; +#X text 98 183 list; +#X obj 513 11 plot; +#N canvas 92 134 428 403 plot-help-data 0; +#X scalar plot-help-template 32 98 \; 2 \; -32 \; 12 \; -54 \; -9 \; +\; 0 0 \; 7 14 \; 27 -10 \; 0 -30 \; -40 0 \; 0 50 \; 60 0 \; \; 11 +7 \; 20 5 \; 22 14 \; -20 5 \; 20 11 \; -11 8 \; -17 16 \; \;; +#X obj 0 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 19 206 Above is a scalar defined by "plot-help-template". It +contains three arrays \, each of which has an associated [plot] object +that determines how they will be displayed.; +#X text 7 1 [plot] Window to Display Data Structures; +#X text 19 256 You can click and drag control points that correspond +to the elements of an array.; +#X text 19 286 If the [struct] that defines the array elements has +a "y" field but no "x" field \, then you can click on one control point +\, then drag horizontally to change multiple elements in one swipe +(as you can with the "Put" menu array).; +#X text 19 345 To see/edit the data itself \, select "properties" for +the scalar by right clicking on the purple square.; +#X restore 371 58 pd plot-help-data; +#N canvas 96 163 428 436 plot-help-template 0; +#X obj 22 42 plot array1 500 1 10 15 20; +#X text 19 67 This first example plots the red trace (500) \, width 1 \, at point (10 \, 15) \, with horizontal spacing 20 The black diamonds come from the template of the array1 element itself.; -#X text 51 508 If a "w" variable is present in the template as for +#X text 19 228 If a "w" variable is present in the template as for array3 \, it is added to the line width.; -#X obj 23 672 filledpolygon 509 509 0 -10 -10 10 -10 10 10 -10 10; -#X text 28 634 To see the data itself \, select "properties" for the -scalar by right clicking on the purple square.; -#X obj 25 567 struct help-plot-template float x float y array array1 -help-plot-array1-template array array2 help-plot-array2-template array -array3 help-plot-array3-template; -#X text 34 546 here's the "struct" for all this:; -#X text 46 220 - field to plot (the array); -#X text 63 419 This is the green spiral (color 70 \, line width 3 \, +#X obj 21 374 filledpolygon 509 509 0 -10 -10 10 -10 10 10 -10 10; +#X obj 22 292 struct plot-help-template float x float y array array1 +plot-help-array1-template array array2 plot-help-array2-template array +array3 plot-help-array3-template; +#X obj 22 127 plot curve array2 70 3 100 0; +#X obj 22 208 plot curve array3 9 1 120 50 20; +#X obj 0 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 7 1 [plot] plot-help-template; +#X text 19 269 Here is the [struct] for all this:; +#X text 19 149 This is the green spiral (color 70 \, line width 3 \, location (100 \, 0). Since the template for array2 contains an "x" variable \, play ignores x spacing requests and takes x from the data itself.; -#X text 48 51 - optional "-n" flag to make invisible initially; -#X text 47 70 - alternatively \, an optional "-v [variable]" flag to -assign a variable to make this visible/invisible.; -#X text 51 101 - Opional "-vs [constant or variable] to set visibility +#X text 18 397 Purple square to mark the left upper corner of the scalar +; +#X restore 371 81 pd plot-help-template; +#N canvas 25 161 428 241 plot-help-array1-template 0; +#X obj 0 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 7 1 [plot] Element of "array1" in "plot-help-template"; +#X obj 24 198 filledpolygon 0 0 0 -5 0 0 5 5 0 0 -5; +#X obj 23 168 struct plot-help-array1-template float y; +#X text 20 38 The following data structure is defined as an element +of "array1" in the data structure "plot-help-template". It defines +one "y" field \, which is a reserved field that controls the y-value +of GUI objects associated with this template. Notice there is no "x" +field defined-- this means that when the array is plotted \, you can +click on one of the elements (i.e. \, the small black squares defined +by [filledpolygon]) and drag horizontally to change the y-value for +other elements as well.; +#X restore 12 51 pd plot-help-array1-template; +#N canvas 18 155 428 183 plot-help-array2-template 0; +#X obj 0 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 7 1 [plot] Element of "array2" in "plot-help-template"; +#X obj 22 134 struct plot-help-array2-template float x float y; +#X text 20 36 This data structure is defined as an element for "array2" +in "plot-help-template". No drawing instructions are associated with +this [struct]. The only graphic visible in the "plot-help-data" subwindow +is the trace itself. The thickness and color of the line are defined +solely using the 2nd [plot] object in the "plot-help-template" subwindow. +; +#X restore 12 73 pd plot-help-array2-template; +#N canvas 19 222 428 285 plot-help-array3-template 0; +#X obj 0 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 7 1 [plot] Element of "array3" in "plot-help-template"; +#X obj 22 223 struct plot-help-array3-template float y float w; +#X text 19 36 This data structure is defined as the element for "array3" +in "plot-help-template". Since the reserved "w" field is defined here +\, you can adjust the width of the line at each element (the mouse +pointer will change to two vertical arrows when you hover over an area +that allows you to change the width). The graphical result is the wavy +blue line in the "plot-help-data" window. For both width and y-value +\, you can click an element and drag horizontally to select and adjust +other elements.; +#X text 19 174 For both width and y-value \, you can click an element +and drag horizontally to select and adjust other elements.; +#X restore 12 94 pd plot-help-array3-template; +#X text 202 82 explanation is in here-->; +#X text 168 129 - sending a zero to the inlet of [plot] will turn off +visibility for the drawing. A nonzero value will turn it back on. By +default the drawing is visible \, unless the -v flag is given as an +argument.; +#X text 98 210 (none); +#X text 11 23 draw array elements of scalars; +#X text 168 183 - a list will be truncated to the first element.; +#X text 80 414 2) float; +#X text 80 442 3) float; +#X text 80 459 4) float; +#X text 80 477 5) float; +#X text 80 493 6) float; +#X text 168 397 - the field to plot.; +#X text 168 414 - RGB color for the trace (0=black \, 999=white \, +900=red \, 90=green \, 9=blue \, 555=grey \, etc.).; +#X text 168 442 - line width of the trace.; +#X text 168 459 - relative x location.; +#X text 168 477 - relative y location.; +#X text 168 493 - x spacing (ignored if the template for the array +contains an "x" variable).; +#X text 80 247 0-6 flags; +#X text 168 248 - "-n" flag to make the drawing invisible initially. +; +#X text 168 264 - "-v [variable]" flag to assign a variable to make +the number visible/invisible.; +#X text 168 292 - "-vs [constant or variable]" flag to set visibility of scalars along the path of the plot.; -#X text 47 199 - optional word "curve" to specify bezier; -#X text 47 132 - optional "-x [variable]" flag to use different x variable +#X text 168 319 - "-x [variable]" flag to use a different x variable. +; +#X text 168 339 - "-y [variable]" flag to use a different y variable. ; -#X text 48 153 - optional "-y [variable]" flag to use different y variable +#X text 168 359 - "-w [variable]" flag to use a different w variable. ; -#X text 48 173 - optional "-w [variable]" flag to use different w variable +#X text 168 376 - word "curve" to specify bezier.; +#X text 80 397 1) symbol atom; +#X text 79 263 (symbols atoms); +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide ; -#X restore 243 78 pd help-plot-template; -#N canvas 196 292 273 120 help-plot-array1-template 0; -#X obj 30 71 filledpolygon 0 0 0 -5 0 0 5 5 0 0 -5; -#X obj 32 27 struct help-plot-array1-template float y; -#X restore 242 101 pd help-plot-array1-template; -#N canvas 161 163 273 120 help-plot-array2-template 0; -#X obj 32 26 struct help-plot-array2-template float x float y; -#X restore 243 123 pd help-plot-array2-template; -#N canvas 0 0 411 207 help-plot-data 1; -#X scalar help-plot-template 39 73 \; 0 \; 20 \; 0 \; 30 \; 0 \; \; -0 0 \; 0 10 \; 20 0 \; 0 -30 \; -40 0 \; 0 50 \; 60 0 \; \; 0 0 \; -10 10 \; 0 10 \; 0 1 \; 20 1 \; 20 10 \; 20 1 \; \;; -#X restore 242 57 pd help-plot-data; -#X text 23 139 see also:; -#X obj 30 184 drawnumber; -#X obj 35 22 plot; -#X text 87 21 -- draw array elements of scalars; -#X obj 29 206 drawpolygon; -#N canvas 161 163 273 120 help-plot-array3-template 0; -#X obj 43 32 struct help-plot-array3-template float y float w; -#X restore 242 144 pd help-plot-array3-template; -#X text 8 79 explanation is in here-->; -#X text 264 203 updated for Pd version 0.35; -#X obj 29 163 struct; +#X obj 98 545 pddp/pddplink all_about_arrays.pd; +#X obj 98 575 pddp/pddplink ../4.data.structures/05.array.pd -text +doc/4.data.structures/05.array.pd; +#X obj 288 530 pddp/pddplink ../4.data.structures/09.scaling.pd -text +doc/4.data.structure/09.scaling.pd; +#X obj 288 545 pddp/pddplink ../4.data.structures/10.onoff.pd -text +doc/4.data.structures/10.onoff.pd; +#X obj 288 560 pddp/pddplink ../4.data.structures/11.array.controls.pd +-text doc/4.data.structures/11.array.controls.pd; +#X obj 98 530 pddp/pddplink all_about_z_order.pd; +#X obj 98 560 pddp/pddplink scalar-help.pd; diff --git a/pd/doc/5.reference/pointer-help.pd b/pd/doc/5.reference/pointer-help.pd index 96a22ff1d..45e45e04c 100644 --- a/pd/doc/5.reference/pointer-help.pd +++ b/pd/doc/5.reference/pointer-help.pd @@ -1,79 +1,185 @@ -#N struct template2 float x float y; -#N struct template1 float x float y float z; -#N canvas 223 0 715 654 12; -#X text 20 572 see also:; -#X obj 21 10 pointer; -#X text 95 10 -- remember the location of a scalar in a list; -#N canvas 164 72 425 146 help-pointer-template1 0; -#X obj 18 81 filledpolygon z 0 1 0 0 20 0 20 30 0 30; -#X obj 60 21 struct template1 float x float y float z; -#X restore 327 386 pd help-pointer-template1; -#N canvas 26 456 510 145 help-pointer-template2 0; -#X obj 52 78 filledcurve 909 0 0 0 0 30 30 60 0 30 -30 0 0; -#X obj 60 21 struct template2 float x float y; -#X restore 327 409 pd help-pointer-template2; -#X obj 23 592 get; -#X obj 56 592 set; -#X obj 91 592 append; -#X obj 152 592 getsize; -#X obj 220 593 setsize; -#X obj 290 593 element; -#X obj 23 617 sublist; -#N canvas 0 0 312 185 help-pointer-data 1; -#X scalar template2 20 97 \;; -#X scalar template1 80 17 90 \;; -#X scalar template1 120 117 9 \;; -#X restore 327 364 pd help-pointer-data; -#X obj 54 360 pointer; -#X msg 54 231 traverse pd-help-pointer-data; -#X msg 67 255 bang; -#X text 109 256 outputs current value; -#X msg 69 281 next; -#X obj 54 385 print out1; -#X obj 167 371 print out2; -#X text 119 274 moves forward one item and outputs pointer \; if we -reach the end \, a "bang" goes to out2.; -#X text 16 426 Optional arguments to pointer allow you to select according -to the class of the scalar being output:; -#X msg 74 487 next; -#X msg 60 464 traverse pd-help-pointer-data; -#X obj 60 515 pointer help-pointer-template1 help-pointer-template2 +#N struct template2 float x float y float z float q float zz; +#N struct template1 float x float y float z float q; +#N canvas 428 33 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 pointer 3 12 0 18 +-204280 -1 0; +#X obj 0 142 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 478 262 496 366 META 0; +#X text 12 165 LIBRARY internal; +#X text 12 205 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 185 AUTHOR Miller Puckette; +#X text 12 245 HELP_PATCH_AUTHORS Updated for Pd version 0.35. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 5 KEYWORDS control data_structure storage nonlocal; +#X text 12 45 DESCRIPTION remember the location of a scalar in a list +; +#X text 12 85 INLET_1 pointer; +#X text 12 105 OUTLET_0 bang pointer; +#X text 12 125 OUTLET_N pointer; +#X text 12 145 OUTLET_R bang; +#X text 12 65 INLET_0 bang pointer traverse next vnext rewind send-window ; -#X obj 60 541 print template1; -#X obj 198 541 print template2; -#X obj 338 541 print other; -#X obj 441 541 print bangout; -#X text 333 232 sets to the "head" of the list; -#X text 29 34 "Pointer" is a storage object like "float" \, except +#X text 12 225 RELEASE_DATE 1997; +#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 491 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 568 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 213 516 428 109 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 [pointer] Related Objects; +#X obj 12 34 get; +#X obj 45 34 set; +#X obj 80 34 append; +#X obj 130 34 getsize; +#X obj 186 34 setsize; +#X obj 246 34 element; +#X obj 12 59 sublist; +#X obj 70 59 struct; +#X restore 102 597 pd Related_objects; +#X obj 78 150 cnv 17 3 175 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 360 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 336 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X obj 494 11 pointer; +#X text 98 149 bang; +#X text 98 176 traverse; +#X text 98 227 next; +#X text 98 252 vnext; +#X text 98 335 pointer; +#X text 98 303 rewind; +#X text 98 163 pointer; +#X obj 78 398 cnv 17 3 17 empty \$0-pddp.cnv.let.n n 5 9 0 16 -228856 +-162280 0; +#X text 98 359 pointer; +#X text 98 473 bang; +#X obj 78 471 cnv 17 3 17 empty \$0-pddp.cnv.let.r r 5 9 0 16 -228856 +-162280 0; +#X text 98 397 pointer; +#X text 168 397 - an additional outlet is created for each argument +(a template name) provided to [pointer]. This makes it possible to +route outgoing pointers to different outlets according to the class +of the scalar being output. Pointers to objects that do not match any +of the specified templates are sent to the second to last outlet.; +#X text 168 303 - reset the pointer to the head of the list.; +#X text 167 335 - stores the value of the pointer without outputting +it.; +#X text 168 163 - an incoming pointer is stored and send to the left +outlet.; +#X text 168 252 - the message "vnext 0" behaves exactly as the "next" +message. "vnext 1" will move to the next selected object. The window +must be visible for the "selection" to make sense (i.e. \, you will +get an error if it is not visible).; +#X text 168 359 - the current value of the pointer. If one or more +arguments are provided \, the first outlet will only output a pointer +to the template specified by the first argument.; +#X obj 78 99 pointer; +#X msg 87 66 bang; +#X msg 126 66 next; +#X obj 78 121 print out1; +#X msg 165 66 vnext 1; +#X msg 224 66 rewind; +#X obj 181 121 print out2:end_of_list; +#N canvas 86 344 428 221 More_on_pointers 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 [pointer] More info; +#X text 20 38 [pointer] is a storage object like [float] \, except that the thing stored is the location of a scalar somewhere. You can -send a pointer a value (perhaps from another "pointer" object). The +send a pointer a value (perhaps from another [pointer] object). The right inlet takes pointers and simply stores them. A bang in the left -outputs the pointer \, and a pointer in the left both sets and outputs -the value.; -#X text 29 132 The value of a pointer can either indicate a real scalar -\, or else the "head" (before the first element) of the list. This -allows you to point to an empty list \, and also \, to "append" a scalar -to the beginning of the list.; -#X text 29 191 Pointers are "safe": if you delete a scalar pointers +outputs the [pointer] \, and a [pointer] in the left both sets and +outputs the value.; +#X text 20 120 The value of a [pointer] can either indicate a real +scalar \, or else the "head" (before the first element) of the list. +This allows you to point to an empty list \, and also \, to "append" +a scalar to the beginning of the list.; +#X text 21 175 Pointers are "safe": if you delete a scalar \, pointers to it are marked invalid.; -#X text 166 391 bang at end; -#X text 167 407 of list; -#X text 53 405 output; -#X text 445 617 updated for Pd version 0.35; -#X obj 92 616 struct; -#X msg 71 307 vnext 1; -#X text 149 308 "vnext" gets the next object (if arg is 0) or the next -selected object (if arg is 1 -- but the window must be visible for -the "selection" to make sense).; -#X connect 13 0 18 0; -#X connect 13 1 19 0; -#X connect 14 0 13 0; -#X connect 15 0 13 0; -#X connect 17 0 13 0; -#X connect 22 0 24 0; -#X connect 23 0 24 0; -#X connect 24 0 25 0; -#X connect 24 1 26 0; -#X connect 24 2 27 0; -#X connect 24 3 28 0; -#X connect 38 0 13 0; +#X restore 101 575 pd More_on_pointers; +#N canvas 103 349 428 192 Arguments_with_pointer 0; +#X text 20 38 Optional arguments to pointer allow you to select according +to the class of the scalar being output:; +#X msg 37 102 next; +#X obj 23 130 pointer help-pointer-template1 help-pointer-template2 +; +#X obj 23 156 print template1; +#X obj 128 156 print template2; +#X obj 233 156 print other; +#X obj 338 156 print bangout; +#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 [pointer] Specifying Creation Arguments; +#X msg 23 79 traverse pd-pointer-help-data; +#X connect 1 0 2 0; +#X connect 2 0 3 0; +#X connect 2 1 4 0; +#X connect 2 2 5 0; +#X connect 2 3 6 0; +#X connect 9 0 2 0; +#X restore 171 549 pd Arguments_with_pointer; +#N canvas 114 187 428 210 pointer-help-data 0; +#X scalar template2 48 120 -32 0 0 \;; +#X scalar template1 163 36 90 0 \;; +#X scalar template1 248 147 9 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 [pointer] Window to Display Scalars; +#X restore 395 81 pd pointer-help-data; +#X msg 78 44 traverse pd-pointer-help-data; +#N canvas 118 187 428 109 pointer-help-template1 0; +#X obj 24 58 filledpolygon z 0 1 0 0 20 0 20 30 0 30; +#X obj 11 32 struct template1 float x float y float z; +#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 [pointer] template1; +#X restore 365 101 pd pointer-help-template1; +#N canvas 107 187 428 106 pointer-help-template2 0; +#X obj 45 65 filledcurve 909 0 0 0 0 30 30 60 0 30 -30 0 0; +#X obj 24 35 struct template2 float x float y; +#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 [pointer] template2; +#X restore 365 121 pd pointer-help-template2; +#X text 11 23 remember the location of a scalar in a list; +#X text 168 227 - move forward one element and output the pointer. +When the end of the list is reached \, a bang goes to the right outlet. +; +#X text 168 176 - "traverse" \, followed by a subwindow name (or patch +filename) sets the value of [pointer] to the "head" of the list. The +"pd-" prefix must be used with the subwindow name \, e.g. \, "traverse +pd-pointer-help-data".; +#X text 98 318 send-window; +#X text 168 473 - a bang at the right outlet signals the end of the +list.; +#X text 168 495 - [pointer] takes (optional) arguments \, each of which +is the name of a template. An additional outlet is created for each +argument \, so that pointers are routed to different outlets based +on the class of scalar being output.; +#X msg 273 65 send-window vis 1; +#X text 168 318 - send a message to the canvas that contains the scalar. +; +#X text 168 149 - outputs the current value of the pointer.; +#X text 98 495 n) float; +#X text 93 510 symbol atom; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 245 575 pddp/pddplink scalar-help.pd; +#X connect 30 0 33 0; +#X connect 30 1 36 0; +#X connect 31 0 30 0; +#X connect 32 0 30 0; +#X connect 34 0 30 0; +#X connect 35 0 30 0; +#X connect 40 0 30 0; +#X connect 49 0 30 0; diff --git a/pd/doc/5.reference/poly-help.pd b/pd/doc/5.reference/poly-help.pd index 0b34f99ec..c3bcf9b3d 100644 --- a/pd/doc/5.reference/poly-help.pd +++ b/pd/doc/5.reference/poly-help.pd @@ -1,30 +1,101 @@ -#N canvas 0 0 600 496 12; -#X text 155 228 <-- scroll to change the value of delay in milliseconds.; -#X text 406 383 updated for Pd version 0.25; -#X text 42 383 see also:; -#X obj 66 15 poly; -#X text 101 14 - MIDI-STYLE POLYPHONIC VOICE ALLOCATOR; -#X text 12 42 The poly object takes a stream of pitch/velocity pairs and outputs triples containing voice number \, pitch and velocity. You can pack the output and use the route object to route messages among a bank of voices depending on the first outlet. Poly can be configured to do voice stealing or not (the default.); -#X obj 110 384 route; -#X obj 154 384 makenote; -#X obj 52 254 poly 4 1; -#X text 134 253 <-- first argument \, number of voices \; second argument selects voice stealing; -#X msg 52 168 60 64; -#X msg 103 168 60 0; -#X msg 147 168 62 64; -#X msg 194 168 62 0; -#X obj 52 280 pack 0 0 0; -#X obj 52 306 print; -#X text 97 305 Output is in the printout window.; -#X msg 254 177 stop; -#X msg 296 177 clear; -#X connect 8 0 14 0; -#X connect 8 1 14 1; -#X connect 8 2 14 2; -#X connect 10 0 8 0; -#X connect 11 0 8 0; -#X connect 12 0 8 0; -#X connect 13 0 8 0; -#X connect 14 0 15 0; -#X connect 17 0 8 0; -#X connect 18 0 8 0; +#N canvas 431 32 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 poly 3 12 0 18 -204280 +-1 0; +#X obj 0 287 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 482 220 494 405 META 0; +#X text 12 165 LIBRARY internal; +#X text 12 205 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 185 AUTHOR Miller Puckette; +#X text 12 245 HELP_PATCH_AUTHORS Updated for Pd version 0.25. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 5 KEYWORDS control MIDI; +#X text 12 45 DESCRIPTION MIDI-style polyphonic voice allocator; +#X text 12 85 INLET_1 float; +#X text 12 125 OUTLET_1 float; +#X text 12 145 OUTLET_2 float; +#X text 12 65 INLET_0 float list stop clear; +#X text 12 105 OUTLET_0 float; +#X text 12 225 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 435 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 512 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 568 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 220 510 428 109 Related_objects 0; +#X obj 62 43 makenote; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X obj 22 43 route; +#X obj 122 43 pack; +#X text 8 2 [poly] Related Objects; +#X restore 102 597 pd Related_objects; +#X obj 78 296 cnv 17 3 100 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 295 float; +#X text 98 323 list; +#X obj 78 444 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 407 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X text 98 406 float; +#X text 98 381 clear; +#X obj 503 11 poly; +#X obj 102 190 poly 4 1; +#X msg 153 144 60 0; +#X msg 197 144 62 64; +#X msg 244 144 62 0; +#X obj 102 216 pack 0 0 0; +#X obj 102 242 print; +#X text 147 241 Output is in the printout window.; +#X msg 304 145 stop; +#X msg 346 145 clear; +#X msg 102 144 60 64; +#X text 98 353 stop; +#X text 168 353 - output all values one by one \, ordered according +to voice number \, and clear the memory of [poly].; +#X text 168 381 - clear all stored values.; +#X text 167 406 - the right inlet stores the velocity.; +#X text 11 23 MIDI-style polyphonic voice allocator; +#X text 168 323 - a (pitch \, velocity) pair is distributed to the +two inlets. Lists with more than two elements will be truncated.; +#X text 168 545 - a "1" sets voice stealing \, which is off by default. +; +#X text 168 530 - the first argument sets the number of voices.; +#X text 80 530 1) float; +#X text 80 545 2) float; +#X text 48 56 The [poly] object takes a stream of pitch/velocity pairs +and outputs triples containing voice number \, pitch and velocity. +You can pack the output and use the route object to route messages +among a bank of voices depending on the first outlet. [poly] can be +configured to do voice stealing or not (the default.); +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 78 467 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X obj 78 490 cnv 17 3 17 empty \$0-pddp.cnv.let.2 2 5 9 0 16 -228856 +-162280 0; +#X text 98 443 float; +#X text 98 466 float; +#X text 98 489 float; +#X text 168 295 - a float to the left inlet sets the pitch and triggers +the output.; +#X text 168 443 - voice number; +#X text 168 466 - pitch; +#X text 168 489 - velocity; +#X connect 16 0 20 0; +#X connect 16 1 20 1; +#X connect 16 2 20 2; +#X connect 17 0 16 0; +#X connect 18 0 16 0; +#X connect 19 0 16 0; +#X connect 20 0 21 0; +#X connect 23 0 16 0; +#X connect 24 0 16 0; +#X connect 25 0 16 0; diff --git a/doc/pddp/polytouch-out.pd b/pd/doc/5.reference/polytouch-out.pd similarity index 100% rename from doc/pddp/polytouch-out.pd rename to pd/doc/5.reference/polytouch-out.pd diff --git a/doc/pddp/polytouchin-help.pd b/pd/doc/5.reference/polytouchin-help.pd similarity index 100% rename from doc/pddp/polytouchin-help.pd rename to pd/doc/5.reference/polytouchin-help.pd diff --git a/doc/pddp/pow-help.pd b/pd/doc/5.reference/pow-help.pd similarity index 100% rename from doc/pddp/pow-help.pd rename to pd/doc/5.reference/pow-help.pd diff --git a/doc/pddp/powtodb-help.pd b/pd/doc/5.reference/powtodb-help.pd similarity index 100% rename from doc/pddp/powtodb-help.pd rename to pd/doc/5.reference/powtodb-help.pd diff --git a/doc/pddp/powtodb~-help.pd b/pd/doc/5.reference/powtodb~-help.pd similarity index 100% rename from doc/pddp/powtodb~-help.pd rename to pd/doc/5.reference/powtodb~-help.pd diff --git a/pd/doc/5.reference/print-help.pd b/pd/doc/5.reference/print-help.pd index 451954b99..c582f1e84 100644 --- a/pd/doc/5.reference/print-help.pd +++ b/pd/doc/5.reference/print-help.pd @@ -1,20 +1,153 @@ -#N canvas 349 65 546 306 12; -#X msg 102 52 walk the dog; -#X msg 29 51 bang; -#X msg 70 51 234; -#X obj 29 96 print x1; -#X obj 21 10 print; -#X text 29 130 Print prints out the messages it receives on the "terminal -window" that Pd is run from.; -#X text 73 10 -- print messages to terminal window; -#X text 27 167 Long symbol arguments are truncated to 78 characters -and marked with "*" (but message selectors are printed in full.); -#X obj 100 267 print -n; -#X text 27 202 With the special "-n" argument the "print:" prefix is -suppressed:; -#X text 333 282 updated for Pd version 0.42; -#X floatatom 101 244 5 0 0 0 - - -; -#X connect 0 0 3 0; -#X connect 1 0 3 0; -#X connect 2 0 3 0; -#X connect 11 0 8 0; +#N canvas 429 33 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 print 3 12 0 18 +-204280 -1 0; +#X obj 0 324 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 484 283 494 344 META 0; +#X text 12 85 LIBRARY internal; +#X text 12 125 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 105 AUTHOR Miller Puckette; +#X text 12 165 HELP_PATCH_AUTHORS This document was updated for Pd +version 0.38.4 by Dave Sabine and Hans-Christoph Steiner as part of +a project called pddp proposed by Krzysztof Czaja to build comprehensive +documentation for Pd. Jonathan Wilkes revised the patch to conform +to the PDDP template for Pd version 0.42.; +#X text 12 5 KEYWORDS control; +#X text 12 45 DESCRIPTION print messages to the terminal window; +#X text 12 65 INLET_0 anything; +#X text 12 145 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 424 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 452 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 535 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 215 517 428 109 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 [print] Related Objects; +#X obj 22 43 print~; +#X restore 102 597 pd Related_objects; +#X obj 78 333 cnv 17 3 80 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 503 11 print; +#X text 98 428 (none); +#N canvas 103 75 428 487 print_oddities 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 [print] Oddities; +#X obj 33 189 print; +#X msg 33 73 1; +#X msg 42 97 float 1; +#X obj 65 161 symbol test; +#X msg 60 120 symbol this; +#X obj 65 142 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X msg 121 310 one 2 three; +#X obj 53 394 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 121 395 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 130 371 print STRAIGHT; +#X msg 105 290 list 1 two 3; +#X msg 88 270 1 two 3; +#X msg 130 331 list one 2 three; +#X obj 56 371 route list; +#X text 20 222 [print] only interprets the "list" selector when the +following body of the message is an implied list \, i.e. a set of atoms +that starts with a float.; +#X text 20 428 This document was updated for Pd version 0.38.4 by Dave +Sabine and Hans-Christoph Steiner as part of a project called pddp +proposed by Krzysztof Czaja to build comprehensive documentation for +Pd.; +#X text 138 114 "symbols" are not interpreted; +#X text 140 129 (i.e. "symbol" is also printed); +#X text 20 38 floats are interpreted (i.e. it doesn't show the word +"float" before the number):; +#X connect 3 0 2 0; +#X connect 4 0 2 0; +#X connect 5 0 2 0; +#X connect 6 0 2 0; +#X connect 7 0 5 0; +#X connect 8 0 11 0; +#X connect 8 0 15 0; +#X connect 12 0 11 0; +#X connect 12 0 15 0; +#X connect 13 0 11 0; +#X connect 13 0 15 0; +#X connect 14 0 11 0; +#X connect 14 0 15 0; +#X connect 15 0 9 0; +#X connect 15 1 10 0; +#X restore 101 569 pd print_oddities; +#X text 98 332 anything; +#X text 168 331 - the [print] object takes any message and prints it +to the console window. When the print object receives a message \, +its output will appear in the console window following the name of +the print object and a colon (:). If the print object does not have +a name (which you can supply as an argument within the print object +itself) then the word "print" appears followed by a colon (:) and your +message.; +#X text 168 428 - [print] routes output directly to the console window. +; +#X msg 159 64 walk the dog; +#X msg 85 64 bang; +#X msg 126 64 234; +#X obj 85 99 print; +#X msg 158 151 walk the dog; +#X msg 85 151 bang; +#X msg 125 151 234; +#X obj 85 188 print myPrintObject; +#X text 209 188 A print object with a name.; +#X text 132 92 A print object without a name. Be sure you can see the +terminal window as you click on these messages.; +#N canvas 105 232 428 300 print_and_lists 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 [print] Lists; +#X text 23 38 When the print object receives a list \, it will output +the entire list as a single message. Like below:; +#X obj 25 98 print print_this_list; +#X msg 25 75 10 20 30 foo; +#X msg 26 180 10 20 30 foo; +#X obj 26 233 unpack f f f s; +#X obj 26 266 print unpack_this_list; +#X text 23 127 To output the list as separate elements \, the list +needs to be unpacked first. Note that [unpack]'s outlets are triggered +from right to left. Like below:; +#X text 37 200 The arguments here are used to tell Pd what type of +atom to expect: (f = float \, s = symbol).; +#X connect 4 0 3 0; +#X connect 5 0 6 0; +#X connect 6 0 7 0; +#X connect 6 1 7 0; +#X connect 6 2 7 0; +#X connect 6 3 7 0; +#X restore 101 544 pd print_and_lists; +#X text 82 219 Use the "-n" flag to suppress "print:" in the output +to the console:; +#X msg 85 253 test; +#X obj 207 286 print; +#X msg 207 254 test; +#X text 159 286 vs.; +#X obj 85 286 print -n; +#X text 168 470 - if you provide a symbol as an argument \, the symbol-- +followed by a colon-- will precede the output when it is sent to the +console. Or you may use the "-n" flag to only print the incoming message +(see example above).; +#X text 78 469 1) symbol atom; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X text 11 23 print messages to the terminal window; +#X connect 15 0 18 0; +#X connect 16 0 18 0; +#X connect 17 0 18 0; +#X connect 19 0 22 0; +#X connect 20 0 22 0; +#X connect 21 0 22 0; +#X connect 27 0 31 0; +#X connect 29 0 28 0; diff --git a/pd/doc/5.reference/print~-help.pd b/pd/doc/5.reference/print~-help.pd index b3a9c4296..85f1a3750 100644 --- a/pd/doc/5.reference/print~-help.pd +++ b/pd/doc/5.reference/print~-help.pd @@ -1,18 +1,63 @@ -#N canvas 118 333 531 212 10; -#X msg 74 143 2; -#X msg 455 77 \; pd dsp 0; -#X msg 454 40 \; pd dsp 1; -#X obj 62 177 print~; -#X msg 74 118 bang; -#X obj 62 92 phasor~ 1000; -#X text 122 119 bang prints one vector; -#X obj 454 18 loadbang; -#X text 109 142 print two or more successive vectors; -#X obj 32 12 print~; -#X text 85 12 - print out raw values of a signal; -#X text 301 171 Updated for Pd version 0.33; -#X text 19 44 The print~ object takes a signal input and prints one or more vectors out when you send it a bang or a number. By default a vector is 64 samples.; -#X connect 0 0 3 0; -#X connect 4 0 3 0; -#X connect 5 0 3 0; -#X connect 7 0 2 0; +#N canvas 428 36 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 print~ 3 12 0 18 +-204280 -1 0; +#X obj 0 427 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 487 287 494 344 META 0; +#X text 12 85 LIBRARY internal; +#X text 12 125 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 105 AUTHOR Miller Puckette; +#X text 12 165 HELP_PATCH_AUTHORS Updated for Pd version 0.33. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 5 KEYWORDS signal; +#X text 12 45 DESCRIPTION print out raw values of a signal; +#X text 12 65 INLET_0 float bang signal; +#X text 12 145 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 512 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 540 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 568 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#X text 98 544 (none); +#N canvas 212 516 428 109 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 obj 22 43 print; +#X obj 62 43 bang~; +#X text 8 2 [print~] Related Objects; +#X restore 102 597 pd Related_objects; +#X obj 78 436 cnv 17 3 65 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 502 8 print~; +#X obj 138 274 print~; +#X msg 150 215 bang; +#X obj 138 189 phasor~ 1000; +#X text 198 216 bang prints one vector; +#X text 190 239 print two or more successive vectors; +#X msg 155 240 2; +#X text 98 435 signal; +#X text 98 456 bang; +#X text 98 476 float; +#X text 168 476 - sending a value of "2" or greater to [print~] will +print the specified number of vectors to the console.; +#X text 98 516 (none); +#X text 11 23 print out raw values of a signal; +#X text 168 435 - an incoming signal.; +#X text 168 456 - outputs one vector to the console.; +#X text 95 141 The [print~] object takes a signal input and prints +one or more vectors out when you send it a bang or a number. By default +a vector is 64 samples.; +#X text 168 516 - [print~] sends its output to the console window. +; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 480 56 pddp/dsp; +#X connect 12 0 11 0; +#X connect 13 0 11 0; +#X connect 16 0 11 0; diff --git a/pd/doc/5.reference/qlist-help.pd b/pd/doc/5.reference/qlist-help.pd index 894c9bb84..8e08ebf92 100644 --- a/pd/doc/5.reference/qlist-help.pd +++ b/pd/doc/5.reference/qlist-help.pd @@ -1,79 +1,144 @@ -#N canvas 7 31 1178 587 12; -#X obj 546 328 qlist; -#X msg 592 110 rewind; -#X msg 591 135 next; -#X floatatom 546 382 0 0 0 0 - - -; -#X msg 593 54 bang; -#X obj 441 515 r this; -#X obj 544 515 r that; -#X obj 441 544 print this; -#X obj 544 544 print that; -#X obj 560 356 print done; -#X msg 593 80 tempo 1; -#X text 18 51 The qlist object reads text files containing time-tagged +#N canvas 426 32 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 qlist 3 12 0 18 +-204280 -1 0; +#X obj 0 351 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 482 258 494 366 META 0; +#X text 12 135 LIBRARY internal; +#X text 12 175 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 155 AUTHOR Miller Puckette; +#X text 12 215 HELP_PATCH_AUTHORS Updated for Pd version 0.35. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 45 DESCRIPTION text-based sequencer; +#X text 12 65 INLET_0 bang print tempo rewind next clear add add2 read +write; +#X text 12 95 OUTLET_0 list; +#X text 12 115 OUTLET_1 bang; +#X text 12 5 KEYWORDS control storage nonlocal filesystem list_op; +#X text 12 195 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 393 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 502 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 529 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#X text 98 506 (none); +#N canvas 216 513 428 109 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 [qlist] Related Objects; +#X obj 22 43 textfile; +#X obj 85 43 receive; +#X restore 102 597 pd Related_objects; +#X obj 78 360 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 403 cnv 17 3 37 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 504 11 qlist; +#N canvas 72 97 428 339 messages_to_qlist 0; +#X msg 23 115 rewind; +#X msg 23 139 next; +#X msg 23 67 bang; +#X msg 23 91 tempo 1; +#X text 76 66 sequence automatically; +#X text 76 91 set relative tempo; +#X text 77 114 go to beginning (and stop); +#X text 78 138 single-step forward; +#X text 120 258 read a file; +#X msg 23 259 read qlist.txt; +#X msg 23 282 write /tmp/qlist.txt; +#X msg 23 187 clear; +#X msg 23 211 add 500 this is another message; +#X msg 23 235 add2 that; +#X text 80 186 empty the qlist; +#X text 96 234 add a message to a qlist but don't terminate it; +#X text 78 161 single-step forward SUPRESSING MESSAGE-SENDING; +#X msg 23 163 next 1; +#X msg 23 43 print; +#X text 77 42 print contents to Pd window; +#X obj 23 312 outlet; +#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 [qlist] Messages Accepted by [qlist]; +#X text 156 281 write a file; +#X text 217 210 add a message to a qlist; +#X connect 0 0 20 0; +#X connect 1 0 20 0; +#X connect 2 0 20 0; +#X connect 3 0 20 0; +#X connect 9 0 20 0; +#X connect 10 0 20 0; +#X connect 11 0 20 0; +#X connect 12 0 20 0; +#X connect 13 0 20 0; +#X connect 17 0 20 0; +#X connect 18 0 20 0; +#X restore 76 89 pd messages_to_qlist; +#X obj 76 115 qlist; +#X floatatom 76 163 0 0 0 0 - - -; +#X obj 103 140 print done; +#X text 112 165 This outlet gets a list of leading numbers for the +next message \, for you to use in designing your own sequencer.; +#X text 210 89 <- Click to see messages to qlist; +#X obj 135 276 r this; +#X obj 238 276 r that; +#X obj 135 305 print this; +#X obj 238 305 print that; +#X text 73 231 These receives are invoked in the file "qlist.txt" in +this directory.; +#N canvas 82 159 428 398 More_Info 0; +#X text 20 38 The qlist object reads text files containing time-tagged Pd messages. You can have them sequenced automatically (by sending a "bang" message \, possibly changing speed via "tempo" messages) or manually via the "rewind" and "next" messages.; -#X text 15 136 To run the qlist automatically \, send it a "read" message -(the filename is relative to the directory the patch is in) and later -a "bang." Messages in the file are separated by semicolons. Optional -leading numbers are delay times in milliseconds. If the tempo is diffrerent -from 1 the messages are sent faster or slower accordingly. Messages -should start with a symbol giving the destination object. In the file -"qlist.q" used here \, the messages go to objects "this" and "that" -which are receives below.; -#X text 17 281 To run it manually \, send "rewind" followed by "next". +#X text 20 228 To run it manually \, send "rewind" followed by "next". All messages not preceeded by numbers are sent. As soon as a message starting with one or more numbers is encountered \, the numbers are output as a list. There are many ways you could design a sequencer around this.; -#X text 668 48 sequence automatically; -#X text 670 79 set relative tempo; -#X text 668 105 go to beginning (and stop); -#X text 668 132 single-step forward; -#X text 713 273 read a file; -#X text 777 300 write one; -#X text 552 404 This outlet gets a list of leading numbers for the -next message \, for you to use in designing your own sequencer.; -#X msg 586 274 read qlist.txt; -#X msg 586 300 write /tmp/qlist.txt; -#X text 21 493 see also:; -#X obj 97 493 textfile; -#X text 22 362 You can also record textual messages and save them to +#X text 20 298 You can also record textual messages and save them to a file. Send "clear" to empty the qlist and "add" to add messages (terminated with semicolons.) The message \, "add2" adds a list of atoms without finishing with a semicolon in case you want to make variable-length messages.; -#X msg 589 190 clear; -#X msg 589 216 add 500 this is another message; -#X msg 590 242 add2 that; -#X text 666 187 empty the qlist; -#X text 882 217 add a message to a qlist; -#X text 683 240 add a message to a qlist but don't terminate it; -#X text 653 341 This outlet gets a bang when you hit the end of the -sequence. In the file "qlist.txt" the end is delayed 1000 milliseconds -after the last message.; -#X text 379 470 These receives are invoked in the file "qlist.txt" -in this directory.; -#X obj 71 13 qlist; -#X text 132 15 - text-based sequencer; -#X text 668 158 single-step forward SUPRESSING MESSAGE-SENDING; -#X msg 591 161 next 1; -#X text 921 558 updated for Pd version 0.35; -#X msg 593 29 print; -#X text 667 28 print contents to Pd window; -#X connect 0 0 3 0; -#X connect 0 1 9 0; -#X connect 1 0 0 0; -#X connect 2 0 0 0; -#X connect 4 0 0 0; -#X connect 5 0 7 0; -#X connect 6 0 8 0; -#X connect 10 0 0 0; -#X connect 21 0 0 0; -#X connect 22 0 0 0; -#X connect 26 0 0 0; -#X connect 27 0 0 0; -#X connect 28 0 0 0; -#X connect 37 0 0 0; -#X connect 39 0 0 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 [qlist] More Info; +#X text 20 108 To run the qlist automatically \, send it a "read" message +(the filename is relative to the directory the patch is in) and later +a "bang." Messages in the file are separated by semicolons. Optional +leading numbers are delay times in milliseconds. If the tempo is different +from 1 the messages are sent faster or slower accordingly. Messages +should start with a symbol giving the destination object. In the file +"qlist.q" used here \, the messages go to objects "this" and "that" +which are receives below.; +#X restore 101 538 pd More_Info; +#X text 98 402 list; +#X obj 78 446 cnv 17 3 47 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X text 98 445 bang; +#X text 168 445 - this outlet gets a bang when you hit the end of the +sequence. In the file "qlist.txt" used in the example above \, the +end is delayed 1000 milliseconds after the last message.; +#X text 11 23 text-based sequencer; +#X text 98 359 See the subpatch "messages_to_qlist" in the example +above for a complete list of messages and their functionalities.; +#X text 168 402 - if you run [qlist] manually (using the "next" message) +\, messages starting with one or more numbers are are output as a list. +; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 98 557 pddp/pddplink ../2.control.examples/23.sequencing.pd +-text doc/2.control.examples/23.sequencing.pd; +#X obj 98 572 pddp/pddplink ../3.audio.examples/D13.additive.qlist.pd +-text doc/3.audio.examples/D13.additive.qlist.pd; +#X connect 12 0 13 0; +#X connect 13 0 14 0; +#X connect 13 1 15 0; +#X connect 18 0 20 0; +#X connect 19 0 21 0; diff --git a/pd/doc/5.reference/random-help.pd b/pd/doc/5.reference/random-help.pd index b792325cd..5845077fa 100644 --- a/pd/doc/5.reference/random-help.pd +++ b/pd/doc/5.reference/random-help.pd @@ -1,19 +1,576 @@ -#N canvas 0 0 630 421 12; -#X msg 40 212 bang; -#X obj 40 287 random 5; -#X floatatom 83 261 0 0 0; -#X floatatom 40 312 0 0 0; -#X msg 50 236 seed 123; -#X text 92 210 bang for output; -#X text 132 236 message to set the seed; -#X text 116 259 inlet to reset the range; -#X text 119 286 argument to initialize the range; -#X text 378 337 updated for Pd version 0.33; -#X text 11 46 Random outputs pseudorandom integers from 0 to N-1 where N is the creation argument (5 in the example below.) You can specify a seed if you wish. Seeds are kept locally so that if two Randoms are seeded the same they will have the same output (or indeed you can seed the same one twice to repeat the output.); -#X text 12 139 On the other hand \, if you don't supply a seed each instance of random gets its own seed. WARNING: nothing is known about the quality of teh pseudorandom number generator. It isn't any standard one!; -#X obj 20 11 random; -#X text 84 11 - pseudorandom integers; +#N canvas 427 34 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 random 3 12 0 18 +-204280 -1 0; +#X obj 0 252 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 480 281 494 344 META 0; +#X text 12 125 LIBRARY internal; +#X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 145 AUTHOR Miller Puckette; +#X text 12 205 HELP_PATCH_AUTHORS This help patch was updated for Pd +version 0.35 test 29 by Dave Sabine as part of a project called pddp +proposed by Krzysztof Czaja to build comprehensive documentation for +Pd. Jonathan Wilkes revised the patch to conform to the PDDP template +for Pd version 0.42.; +#X text 12 45 DESCRIPTION pseudorandom integer generator; +#X text 12 5 KEYWORDS control random; +#X text 12 85 INLET_1 float; +#X text 12 105 OUTLET_0 float; +#X text 12 65 INLET_0 bang seed; +#X text 12 185 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 389 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 426 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 476 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 211 256 428 374 Related_objects 0; +#X text 20 255 These objects are offered in Pd only if you have downloaded +and properly installed the appropriate library. These objects may or +may not exist in a single library.; +#X text 20 297 The best places to find information about Pd's libraries +is:; +#X text 21 314 www.puredata.org and click on "Downloads" then "Software" +; +#X text 23 328 or; +#X text 20 343 iem.kug.ac.at/pdb/; +#X obj 20 95 pddp/helplink markex/randomF; +#X obj 20 115 pddp/helplink markex/tripleRand; +#X obj 20 135 pddp/helplink motex/shuffle; +#X obj 20 155 pddp/helplink cxc/utime; +#X obj 20 175 pddp/helplink mjlib/pin~; +#X obj 20 195 pddp/helplink iemmatrix/mtx_rand; +#X obj 20 215 pddp/helplink iemlib/randomblock~; +#X obj 20 235 pddp/helplink cyclone/drunk; +#X text 20 75 Externals; +#N canvas 404 60 483 507 (subpatch) 0; +#X msg 144 296 bang; +#X msg 144 321 1 30; +#X obj 144 409 line~; +#X obj 202 301 del 30; +#X obj 61 433 *~; +#X obj 62 485 dac~; +#X obj 62 359 osc~ 880; +#X obj 62 403 clip~ -1 1; +#X obj 35 220 list split 1; +#X obj 15 311 list; +#X obj 35 244 t b a; +#X obj 62 334 mtof; +#X obj 62 457 *~ 0.07; +#X obj 207 128 metro 50; +#X obj 207 202 s \$0-cnv; +#X obj 207 106 0; +#X obj 207 84 del 3000; +#X obj 310 170 f; +#X obj 342 170 + 1; +#X obj 35 12 r \$0-bng; +#X obj 106 14 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 -1 +-1; +#X obj 310 197 div 13; +#X msg 310 314 color \$1 0; +#X obj 242 105 tgl 15 0 empty empty empty 17 7 0 10 -262144 -1 -1 0 +1; +#X obj 279 86 sel 0; +#X obj 279 107 -1; +#X obj 279 130 t a; +#X obj 207 155 f -1; +#X msg 207 180 delta 0 \$1; +#X obj 35 44 spigot 1; +#X obj 35 76 t a b; +#X obj 96 55 0; +#X obj 130 55 1; +#X obj 310 220 sel 3 4; +#X msg 371 246 5 \$1; +#X obj 371 268 -; +#X msg 310 246 1; +#X obj 340 245 f 2; +#X obj 383 170 sel 1; +#X msg 377 198 0; +#X msg 411 199 2; +#X obj 62 311 + 68; +#X obj 15 284 del 170; +#X text 167 14 IT'S A SECRET TO EVERYBODY.; +#X obj 100 100 cnv 15 15 15 empty empty empty 20 12 0 14 -262144 -66577 +0; +#X obj 56 106 loadbang; +#X obj 35 174 list; +#X obj 114 217 s \$0-randomize; +#X obj 71 149 r \$0-new-secret; +#X msg 56 128 7 1 0 8 12 16; +#X obj 35 197 list prepend 11 10; +#X obj 62 381 *~ 1.4; +#X msg 202 323 0 400; #X connect 0 0 1 0; -#X connect 1 0 3 0; -#X connect 2 0 1 1; +#X connect 0 0 3 0; +#X connect 1 0 2 0; +#X connect 2 0 4 1; +#X connect 3 0 52 0; +#X connect 4 0 12 0; +#X connect 6 0 51 0; +#X connect 7 0 4 0; +#X connect 8 0 10 0; +#X connect 8 1 9 1; +#X connect 9 0 8 0; +#X connect 10 0 42 0; +#X connect 10 1 0 0; +#X connect 10 1 41 0; +#X connect 11 0 6 0; +#X connect 12 0 5 0; +#X connect 12 0 5 1; +#X connect 13 0 17 0; +#X connect 13 0 27 0; +#X connect 15 0 13 0; +#X connect 15 0 17 1; +#X connect 16 0 15 0; +#X connect 16 0 23 0; +#X connect 16 0 32 0; +#X connect 17 0 18 0; +#X connect 17 0 21 0; +#X connect 18 0 17 1; +#X connect 19 0 29 0; +#X connect 20 0 29 0; +#X connect 21 0 33 0; +#X connect 22 0 14 0; +#X connect 23 0 24 0; +#X connect 23 0 38 0; +#X connect 24 0 25 0; +#X connect 24 1 26 0; +#X connect 25 0 26 0; +#X connect 26 0 27 1; +#X connect 27 0 28 0; +#X connect 28 0 14 0; +#X connect 29 0 30 0; +#X connect 30 0 13 0; +#X connect 30 0 16 0; +#X connect 30 0 46 0; +#X connect 30 1 31 0; +#X connect 31 0 29 1; +#X connect 32 0 29 1; +#X connect 33 0 36 0; +#X connect 33 1 37 0; +#X connect 33 2 34 0; +#X connect 34 0 35 0; +#X connect 35 0 22 0; +#X connect 36 0 22 0; +#X connect 37 0 22 0; +#X connect 38 0 39 0; +#X connect 38 1 40 0; +#X connect 39 0 37 1; +#X connect 40 0 37 1; +#X connect 41 0 11 0; +#X connect 42 0 9 0; +#X connect 45 0 49 0; +#X connect 46 0 47 0; +#X connect 46 0 50 0; +#X connect 48 0 46 1; +#X connect 49 0 46 1; +#X connect 50 0 8 0; +#X connect 51 0 7 0; +#X connect 52 0 2 0; +#X coords 0 -1 1 1 15 15 2 100 100; +#X restore 266 222 pd; +#X obj 8 3 bng 15 250 50 0 \$0-bng empty empty 17 7 0 10 -262144 -1 +-1; +#X obj 23 42 noise~; +#X obj 23 3 bng 15 250 50 0 \$0-bng empty empty 17 7 0 10 -262144 -1 +-1; +#X obj 38 3 bng 15 250 50 0 \$0-bng empty empty 17 7 0 10 -262144 -1 +-1; +#X obj 53 3 bng 15 250 50 0 \$0-bng empty empty 17 7 0 10 -262144 -1 +-1; +#X obj 68 3 bng 15 250 50 0 \$0-bng empty empty 17 7 0 10 -262144 -1 +-1; +#X obj 83 3 bng 15 250 50 0 \$0-bng empty empty 17 7 0 10 -262144 -1 +-1; +#X obj 98 3 bng 15 250 50 0 \$0-bng empty empty 17 7 0 10 -262144 -1 +-1; +#X obj 113 3 bng 15 250 50 0 \$0-bng empty empty 17 7 0 10 -262144 +-1 -1; +#X obj 128 3 bng 15 250 50 0 \$0-bng empty empty 17 7 0 10 -262144 +-1 -1; +#X obj 173 3 bng 15 250 50 0 \$0-bng empty empty 17 7 0 10 -262144 +-1 -1; +#X obj 254 180 cnv 15 40 24 empty empty empty 20 12 0 14 -179689 -66577 +0; +#N canvas 271 87 451 558 (subpatch) 0; +#X obj 27 181 t a b; +#X obj 54 203 f; +#X obj 54 228 + 1; +#X obj 27 282 list prepend; +#X obj 84 203 mod 3; +#X msg 27 255 \$1\$2\$3\$4\$5\$6; +#X obj 179 115 0; +#X obj 27 358 list append; +#X obj 48 331 list append; +#X obj 27 40 t a b; +#X obj 27 304 route 3 2 1; +#X obj 24 119 cnv 15 110 24 empty empty empty 20 12 0 14 -179689 -66577 +0; +#N canvas 222 70 378 565 list-scramble 0; +#X obj 148 213 list; +#X obj 205 294 sel; +#X obj 148 181 t b a; +#X obj 104 372 f; +#X obj 205 267 list split 1; +#X obj 294 267 t a; +#X obj 77 318 spigot; +#X obj 116 291 1; +#X obj 128 318 0; +#X obj 77 98 t b b b; +#X obj 148 240 route bang; +#X msg 152 415 adddollar \$1; +#X msg 152 479 list \$2 \$4 \$1 \$3 \$6 \$5; +#X obj 104 415 s \$0-l; +#X obj 274 153 r \$0-l; +#X obj 77 345 t b b; +#X obj 40 373 f; +#X obj 68 372 + 1; +#X obj 18 442 moses; +#X obj 45 415 r \$0-len; +#X obj 159 -31 inlet; +#X obj 193 60 list length; +#X obj 236 95 s \$0-len; +#X obj 45 468 b; +#X obj 45 495 s \$0-end; +#X obj 77 71 until; +#X obj 120 71 r \$0-end; +#X obj 210 38 s \$0-r; +#X obj 25 318 r \$0-r; +#X obj 223 138 r \$0-r; +#X obj 25 345 0; +#X obj 148 158 + 1; +#X obj 252 395 r \$0-r; +#X obj 159 -4 t a b a b; +#X obj 3 73 s \$0-in; +#X obj 96 450 r \$0-in; +#X obj 152 506 outlet; +#X obj 3 46 list; +#X msg 252 417 set list; +#X obj 274 190 list; +#X obj 274 215 t a; +#X obj 134 131 cnv 15 70 24 empty empty empty 20 12 0 14 -179689 -66577 +0; +#X obj 148 134 random; +#X connect 0 0 10 0; +#X connect 1 0 8 0; +#X connect 2 0 0 0; +#X connect 2 1 1 1; +#X connect 2 1 3 1; +#X connect 3 0 11 0; +#X connect 3 0 13 0; #X connect 4 0 1 0; +#X connect 4 1 5 0; +#X connect 5 0 4 0; +#X connect 6 0 15 0; +#X connect 7 0 6 1; +#X connect 8 0 6 1; +#X connect 9 0 6 0; +#X connect 9 1 42 0; +#X connect 9 2 7 0; +#X connect 10 1 4 0; +#X connect 11 0 12 0; +#X connect 12 0 36 0; +#X connect 14 0 39 0; +#X connect 15 0 16 0; +#X connect 15 1 3 0; +#X connect 16 0 17 0; +#X connect 17 0 16 1; +#X connect 17 0 18 0; +#X connect 18 1 23 0; +#X connect 19 0 18 1; +#X connect 20 0 33 0; +#X connect 21 0 22 0; +#X connect 21 0 42 1; +#X connect 23 0 24 0; +#X connect 25 0 9 0; +#X connect 26 0 25 1; +#X connect 28 0 30 0; +#X connect 29 0 0 1; +#X connect 29 0 39 1; +#X connect 30 0 16 1; +#X connect 31 0 2 0; +#X connect 32 0 38 0; +#X connect 33 0 37 0; +#X connect 33 1 25 0; +#X connect 33 2 21 0; +#X connect 33 3 27 0; +#X connect 35 0 12 0; +#X connect 37 0 34 0; +#X connect 38 0 12 0; +#X connect 39 0 40 0; +#X connect 39 0 0 1; +#X connect 40 0 39 1; +#X connect 42 0 31 0; +#X restore 27 121 pd list-scramble; +#X obj 27 464 t a b; +#X obj 27 539 s pd-\$0-random-header; +#X msg 72 489 clear \, donecanvasdialog 0 0 2 0 -1 1 1 200 18 0 0 \, +obj 0 0 cnv 15 200 18 empty \$0-pddp.cnv.random-subheading empty 3 +12 0 14 -204280 -1 0; +#X obj 112 20 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 -1 +-1; +#X msg 27 67 b j e c t s \, e l a t e d \, r a n d o m; +#X obj 27 17 r \$0-bng; +#X obj 43 409 loadbang; +#X msg 43 436 text 8 0 [random] Related Objects; +#X msg 27 381 text 8 0 [\$1] R\$2 O\$3; +#X text 98 408 <- triggers a dirty flag; +#X obj 56 90 r \$0-randomize; +#N canvas 0 0 450 300 filter-numbers 0; +#X obj 121 55 inlet; +#X obj 121 82 list trim; +#X obj 121 109 route list; +#X obj 178 136 list; +#X obj 178 163 outlet; +#X obj 121 190 s \$0-new-secret; +#X connect 0 0 1 0; +#X connect 1 0 2 0; +#X connect 2 0 5 0; +#X connect 2 1 3 0; +#X connect 3 0 4 0; +#X restore 27 153 pd filter-numbers; +#X connect 0 0 5 0; +#X connect 0 1 1 0; +#X connect 1 0 2 0; +#X connect 2 0 4 0; +#X connect 2 0 3 1; +#X connect 3 0 10 0; +#X connect 4 0 1 1; +#X connect 5 0 3 0; +#X connect 6 0 1 1; +#X connect 7 0 21 0; +#X connect 8 0 7 1; +#X connect 9 0 17 0; +#X connect 9 1 6 0; +#X connect 10 0 7 0; +#X connect 10 1 8 0; +#X connect 10 2 8 1; +#X connect 12 0 24 0; +#X connect 13 0 14 0; +#X connect 13 1 15 0; +#X connect 15 0 14 0; +#X connect 16 0 9 0; +#X connect 17 0 12 0; +#X connect 18 0 9 0; +#X connect 20 0 13 0; +#X connect 21 0 13 0; +#X connect 23 0 12 0; +#X connect 24 0 0 0; +#X restore 263 183 pd; +#X obj 158 3 bng 15 250 50 0 \$0-bng empty empty 17 7 0 10 -262144 +-1 -1; +#X obj 143 3 bng 15 250 50 0 \$0-bng empty empty 17 7 0 10 -262144 +-1 -1; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#N canvas 0 0 450 300 \$0-random-header 0; +#X obj 0 0 cnv 15 200 18 empty 0-pddp.cnv.random-subheading empty 3 +12 0 14 -204280 -1 0; +#X text 8 0 [random] Related Objects; +#X coords 0 -1 1 1 200 18 2 0 0; +#X restore 11 1 pd \$0-random-header; +#X obj 180 171 cnv 3 210 60 empty \$0-cnv empty 20 12 0 14 -262144 +-262144 0; +#X restore 102 597 pd Related_objects; +#X obj 78 261 cnv 17 3 85 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 397 float; +#X obj 78 398 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 356 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X text 98 355 float; +#X obj 499 10 random; +#X text 81 56 [random] outputs pseudorandom integers between 0 and +N-1 where N is the creation argument or the value of the right inlet. +; +#X obj 84 122 random 100; +#X obj 84 102 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X floatatom 84 144 3 0 0 0 - - -, f 3; +#X text 154 122 Generates random numbers between 0 and 99; +#X obj 84 187 random 100; +#X obj 84 167 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X floatatom 84 210 3 0 0 0 - - -, f 3; +#X floatatom 141 162 5 0 0 0 - - -, f 5; +#X text 181 162 Changes the 'range' of random numbers.; +#X text 98 260 bang; +#X text 98 299 seed; +#X text 168 299 - to specify the seed \, use the seed message followed +by a float ( "seed 42" ).; +#N canvas 65 83 428 454 About_seeds 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 [random] About seeds; +#X text 21 158 However \, "seeds" can be inputted into [random] by +sending a message \, like below:; +#X msg 24 221 seed 42; +#X obj 90 227 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 90 245 random 1000; +#X floatatom 90 265 3 0 0 0 - - -, f 3; +#X obj 24 201 loadbang; +#X text 21 294 Seeds are kept locally so that if two [random]s are +seeded the same \, they will have the same output - as demonstrated +below. Furthermore \, you can seed the same one twice to repeat the +output.; +#X msg 180 363 seed 42; +#X obj 106 366 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 106 398 random 1000; +#X floatatom 106 418 3 0 0 0 - - -, f 3; +#X obj 180 343 loadbang; +#X obj 180 398 random 1000; +#X floatatom 180 418 3 0 0 0 - - -, f 3; +#X text 233 363 Click again to repeat output.; +#X text 20 38 Random numbers are generated via a complex equation which +produces a pseudo-predictable sequence of numbers. Each [random] object's +equation is provided with a "seed" which is really just one of the +variables in the equation which produces the sequence. The "seed" is +generated by Pd based on specific parameters in each patch which contains +a [random] object. If more than one [random] object is contained within +a single patch \, each gets a different "seed".; +#X connect 3 0 5 0; +#X connect 4 0 5 0; +#X connect 5 0 6 0; +#X connect 7 0 3 0; +#X connect 9 0 11 0; +#X connect 9 0 14 0; +#X connect 10 0 11 0; +#X connect 10 0 14 0; +#X connect 11 0 12 0; +#X connect 13 0 9 0; +#X connect 14 0 15 0; +#X restore 171 332 pd About_seeds; +#N canvas 91 66 428 441 More_about_seeds 0; +#X text 20 39 While the "default" seed for each [random] is usually +very effective \, it may be necessary to find better - more unpredictable +- more indeterminate ways to seed the object to produce a more pleasing +result.; +#X text 20 96 Here are some ideas that may improve the implementation +of [random]:; +#X floatatom 202 211 0 0 0 0 - - -; +#X obj 44 138 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 202 182 / 100; +#X floatatom 44 208 0 0 0 0 - - -; +#X text 64 137 Both methods here produce random numbers between 0 and +5; +#X obj 202 157 random 501; +#X obj 44 179 random 6; +#X text 269 157 0 - 500; +#X text 41 239 between 0 and 5; +#X text 41 226 Produces whole numbers; +#X text 20 136 1; +#X text 20 283 2; +#X obj 44 284 loadbang; +#X obj 44 317 timer; +#X obj 106 297 bng 15 250 50 0 empty empty Click_to_seed 0 -8 0 10 +-262144 -1 -1; +#X msg 44 343 seed \$1; +#X obj 106 381 bng 15 250 50 0 empty empty Click_for_output 0 -8 0 +10 -262144 -1 -1; +#X floatatom 106 421 5 0 0 0 - - -, f 5; +#X obj 106 400 random 42; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 240 226 between 0 and 5; +#X text 240 212 produces fractional results; +#X text 240 195 within range.; +#X text 240 182 divide by 100 to keep output; +#X text 206 298 "Time is on your side". Using the; +#X text 206 314 [timer] object here (which is; +#X text 206 343 interesting trick.; +#X text 207 329 started via loadbang) is an; +#X text 8 2 [random] More Info on Seeds; +#X connect 3 0 7 0; +#X connect 3 0 8 0; +#X connect 4 0 2 0; +#X connect 7 0 4 0; +#X connect 8 0 5 0; +#X connect 14 0 15 0; +#X connect 15 0 17 0; +#X connect 16 0 15 1; +#X connect 17 0 20 0; +#X connect 18 0 20 0; +#X connect 20 0 19 0; +#X restore 102 485 pd More_about_seeds; +#N canvas 107 145 428 418 weighted_random_numbers 0; +#X msg 23 118 bang; +#X text 20 58 You can generate weighted random numbers from uniformly +distributed ones. If you just want two possible outcomes with a varying +probability for each one \, you can do as shown:; +#X obj 23 144 random 100; +#X obj 23 202 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 89 202 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X floatatom 125 151 3 0 100 0 - - -, f 3; +#X obj 23 177 moses 80; +#X text 20 230 This outputs a number at left 80% of the time \, otherwise +at right \, unless you override the "80" using the number box. You +may extend this to more than two possible outcomes \, for instance +like this:; +#X msg 24 293 bang; +#X obj 24 319 random 100; +#X obj 24 372 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 114 373 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 24 347 moses 10; +#X obj 114 348 moses 30; +#X obj 182 373 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X text 22 388 10%; +#X text 112 389 20%; +#X text 184 388 70%; +#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 [random] Weighted Random Numbers; +#X text 62 117 <- click to test; +#X text 156 150 <- change probablilty; +#X text 64 293 <- click to test; +#X text 20 25 There are many ways that [random] can be incorporated +into other structures that change the qualities of the results.; +#X connect 0 0 2 0; +#X connect 2 0 6 0; +#X connect 5 0 6 1; +#X connect 6 0 3 0; +#X connect 6 1 4 0; +#X connect 8 0 9 0; +#X connect 9 0 12 0; +#X connect 12 0 10 0; +#X connect 12 1 13 0; +#X connect 13 0 11 0; +#X connect 13 1 14 0; +#X restore 102 507 pd weighted_random_numbers; +#X text 11 23 pseudorandom integer generator; +#X text 168 397 - the output is an integer between 0 and N-1.; +#X text 168 442 - sets the initial value of N \, where the output ranges +between 0 and N-1.; +#X text 168 260 - a bang to [random] will output an integer between +0 and N-1 \, where N is the creation argument or the value to the right +inlet.; +#X text 167 355 - a float to the right inlet sets N \, where the output +ranges between 0 and N-1.; +#X text 78 442 1) float; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 102 527 pddp/pddplink ../2.control.examples/19.random.pd -text +doc/2.control.examples/19.random.pd; +#X obj 102 542 pddp/pddplink ../2.control.examples/20.weighted-random.pd +-text doc/2.control.examples/20.weighted-random.pd; +#X obj 102 557 pddp/pddplink ../2.control.examples/21.markov.chain.pd +-text doc/2.control.examples/21.markov.chain.pd; +#X obj 102 572 pddp/pddplink ../2.control.examples/22.random-walk.pd +-text doc/2.control.examples/22.random-walk.pd; +#X connect 15 0 17 0; +#X connect 16 0 15 0; +#X connect 19 0 21 0; +#X connect 20 0 19 0; +#X connect 22 0 19 1; diff --git a/pd/doc/5.reference/readsf~-help.pd b/pd/doc/5.reference/readsf~-help.pd index 29c90988b..cd7f84918 100644 --- a/pd/doc/5.reference/readsf~-help.pd +++ b/pd/doc/5.reference/readsf~-help.pd @@ -1,63 +1,125 @@ -#N canvas 113 157 888 480 12; -#X msg 561 8 \; pd dsp 1; -#X msg 39 240 1; -#X msg 39 261 0; -#X obj 516 359 print didit; -#X obj 139 361 env~ 16384; -#X floatatom 139 380 0 0 0 0 - - -; -#X msg 40 283 print; -#X obj 20 393 dac~; -#X obj 233 360 env~ 16384; -#X floatatom 233 379 0 0 0 0 - - -; -#X obj 30 308 readsf~ 4 1e+06; -#X obj 327 359 env~ 16384; -#X floatatom 327 378 0 0 0 0 - - -; -#X obj 421 359 env~ 16384; -#X floatatom 421 379 0 0 0 0 - - -; -#X msg 26 210 open ../sound/bell.aiff 0 200 4 2 b; -#X obj 80 362 *~ 0.1; -#X obj 21 363 *~ 0.1; -#X text 40 7 READSF~ - read a soundfile; -#X msg 26 189 open ../sound/bell.aiff; -#X text 185 296 optional arguments: number of channels \; buffer size -per channnel in bytes.; -#X text 548 341 when the soundfile is done.; -#X text 547 327 last outlet gives a "bang"; -#X text 359 186 Open takes a filename \, an onset in sample frames -\, and \, as an override \, you may also supply a header size to skip -\, a number of channels \, bytes per channel \, and endianness.; -#X text 36 24 The readsf~ object reads a soundfile into its signal -outputs. You must open the soundfile in advance (a couple of seconds -before you'll need it) using the "open" message. The object immediately -starts reading from the file \, but output will only appear after you -send a "1" to start playback. A "0" stops it.; -#X text 33 121 The wave \, aiff \, and nextstep formats are parsed +#N canvas 430 36 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 readsf~ 3 12 0 18 +-204280 -1 0; +#X obj 0 283 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 485 286 494 344 META 0; +#X text 12 125 LIBRARY internal; +#X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 145 AUTHOR Miller Puckette; +#X text 12 205 HELP_PATCH_AUTHORS Updated for version 0.42-4. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 45 DESCRIPTION read a soundfile; +#X text 12 65 INLET_0 float open start stop print; +#X text 12 85 INLET_N signal; +#X text 12 105 OUTLET_R bang; +#X text 12 185 RELEASE_DATE 1997; +#X text 12 5 KEYWORDS signal soundfile; +#X restore 500 597 pd META; +#X obj 0 428 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 510 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 568 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 217 519 428 109 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 obj 23 44 soundfiler; +#X obj 103 44 writesf~; +#X text 8 2 [readsf~] Related Objects; +#X restore 102 597 pd Related_objects; +#X obj 78 292 cnv 17 3 125 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 437 cnv 17 3 17 empty \$0-pddp.cnv.let.n n 5 9 0 16 -228856 +-162280 0; +#X obj 492 12 readsf~; +#X text 165 149 The wave \, aiff \, and nextstep formats are parsed automatically \, although only 2- 3- and 4- byte samples are accepted (4 bytes implies floating point and is not available in aiff format.) ; -#X text 647 450 Updated for version 0.37; -#X obj 116 452 soundfiler; -#X text 24 452 see also:; -#X obj 216 452 readsf~; -#X text 94 238 1 starts playback; -#X text 97 261 0 stops it; -#X connect 1 0 10 0; -#X connect 2 0 10 0; -#X connect 4 0 5 0; -#X connect 6 0 10 0; -#X connect 8 0 9 0; -#X connect 10 0 4 0; -#X connect 10 0 17 0; -#X connect 10 1 8 0; -#X connect 10 1 16 0; -#X connect 10 2 11 0; -#X connect 10 2 16 0; -#X connect 10 3 13 0; -#X connect 10 3 17 0; -#X connect 10 4 3 0; -#X connect 11 0 12 0; -#X connect 13 0 14 0; -#X connect 15 0 10 0; -#X connect 16 0 7 1; -#X connect 17 0 7 0; -#X connect 19 0 10 0; +#X text 98 318 open; +#X text 168 318 - the open message is followed by a filename \, an +onset in sample frames \, and \, as an override \, you may also supply +a header size to skip \, a number of channels \, bytes per channel +\, and endianness (see example above).; +#X text 98 367 start; +#X text 98 385 stop; +#X text 98 402 print; +#X text 168 402 - send statistics to the console for debugging.; +#X obj 78 477 cnv 17 3 17 empty \$0-pddp.cnv.let.r r 5 9 0 16 -228856 +-162280 0; +#X text 98 476 bang; +#X text 98 436 signal; +#X text 168 436 - [readsf~] defaults to one signal outlet for a single +channel of audio output. An additional inlet is added for each channel +specified by the first creation argument.; +#X text 168 476 - the rightmost inlet sends a bang when the soundfile +is done.; +#X msg 80 124 0; +#X obj 446 231 print didit; +#X obj 120 233 env~ 16384; +#X floatatom 120 252 0 0 0 0 - - -; +#X msg 81 146 print; +#X obj 11 260 dac~; +#X obj 204 232 env~ 16384; +#X floatatom 204 251 0 0 0 0 - - -; +#X obj 11 176 readsf~ 4 1e+06; +#X obj 283 231 env~ 16384; +#X floatatom 283 250 0 0 0 0 - - -; +#X obj 367 231 env~ 16384; +#X floatatom 367 251 0 0 0 0 - - -; +#X msg 11 80 open ../sound/bell.aiff 0 200 4 2 b; +#X obj 71 234 *~ 0.1; +#X obj 12 235 *~ 0.1; +#X msg 11 59 open ../sound/bell.aiff; +#X msg 20 102 start; +#X msg 20 125 stop; +#X text 207 107 The object immediately starts reading from the file +\, but output will only appear after you send a "1" to start playback. +A "0" stops it.; +#X text 109 101 start playback; +#X text 109 123 stop it; +#X text 11 23 read a soundfile; +#X text 168 545 - buffer size per channel in bytes.; +#X text 168 528 - an integer that specifies the number of channels. +; +#X text 79 528 1) float; +#X text 79 545 2) float; +#X msg 80 103 1; +#X text 168 367 - start playback.; +#X text 168 385 - stop playback.; +#X text 98 292 float; +#X text 168 292 - "1" (or any nonzero value) has the same effect as +"start" \, and "0" has the same effect as "stop".; +#X text 195 41 The [readsf~] object reads a soundfile into its signal +outputs. You must open the soundfile in advance (a couple of seconds +before you'll need it) using the "open" message.; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X connect 23 0 31 0; +#X connect 25 0 26 0; +#X connect 27 0 31 0; +#X connect 29 0 30 0; +#X connect 31 0 25 0; +#X connect 31 0 38 0; +#X connect 31 1 29 0; +#X connect 31 1 37 0; +#X connect 31 2 32 0; +#X connect 31 2 37 0; +#X connect 31 3 34 0; +#X connect 31 3 38 0; +#X connect 31 4 24 0; +#X connect 32 0 33 0; +#X connect 34 0 35 0; +#X connect 36 0 31 0; +#X connect 37 0 28 1; +#X connect 38 0 28 0; +#X connect 39 0 31 0; +#X connect 40 0 31 0; +#X connect 41 0 31 0; +#X connect 50 0 31 0; diff --git a/pd/doc/5.reference/realtime-help.pd b/pd/doc/5.reference/realtime-help.pd index 60fcffaad..cd84776e0 100644 --- a/pd/doc/5.reference/realtime-help.pd +++ b/pd/doc/5.reference/realtime-help.pd @@ -1,15 +1,159 @@ -#N canvas 156 202 565 269 12; -#X msg 73 146 bang; -#X msg 30 115 bang; -#X floatatom 30 206 0 0 0; -#X text 71 113 Click here to reset; -#X text 27 232 Output is in milliseconds; -#X text 114 147 Click here to get elapsed CPU time; -#X obj 66 15 realtime; -#X text 12 47 The realtime object measures elapsed real time \, as measured by your operating system.; -#X obj 30 176 realtime; -#X text 134 15 - ask OS for elapsed real time; -#X text 302 244 updated for Pd version 0.33; -#X connect 0 0 8 1; -#X connect 1 0 8 0; -#X connect 8 0 2 0; +#N canvas 428 32 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 realtime 3 12 0 +18 -204280 -1 0; +#X obj 0 376 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 479 256 494 372 META 0; +#X text 12 125 LIBRARY internal; +#X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 185 RELEASE_DATE 2009-06-12; +#X text 12 25 LICENSE SIBSD; +#X text 12 145 AUTHOR Miller Puckette; +#X text 12 205 HELP_PATCH_AUTHORS This help patch was updated for Pd +version 0.35 test 28 by Dave Sabine as part of a project called pddp +proposed by Krzysztof Czaja to build comprehensive documentation for +Pd. Jonathan Wilkes revised the patch to conform to the PDDP template +for Pd version 0.42.; +#X text 12 5 KEYWORDS control time; +#X text 12 45 DESCRIPTION ask operating system for elapsed real time +; +#X text 12 65 INLET_0 bang; +#X text 12 85 INLET_1 bang; +#X text 12 105 OUTLET_0 float; +#X restore 500 597 pd META; +#X obj 0 473 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 510 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 537 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#X text 98 514 (none); +#N canvas 210 352 428 268 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 [realtime] Related Objects; +#X obj 126 43 metro; +#X obj 23 43 cputime; +#X obj 81 43 timer; +#X text 20 134 These objects are offered in Pd only if you have downloaded +and properly installed the appropriate library. These objects may or +may not exist in a single library.; +#X text 19 183 The best places to find information about Pd's libraries +is:; +#X text 20 202 www.puredata.org and click on "Downloads" then "Software" +; +#X text 21 216 or; +#X text 20 231 iem.kug.ac.at/pdb/; +#X text 20 85 Related External Objects; +#X obj 20 110 pddp/helplink iemlib/t3_timer; +#X restore 102 597 pd Related_objects; +#X obj 78 385 cnv 17 3 35 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 481 float; +#X obj 78 482 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 429 cnv 17 3 35 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X obj 486 11 realtime; +#X msg 119 160 bang; +#X msg 94 138 bang; +#X floatatom 94 204 0 0 0 0 - - -; +#X text 166 206 Output is in milliseconds; +#X text 129 138 Click here to start or reset; +#X text 89 91 The [realtime] object measures elapsed "real" time as +measured by your operating system.; +#X obj 94 182 realtime; +#X text 157 161 Click here to get elapsed real time. Click again...and +again...to see periodic measurements from the start or reset time. +; +#X text 90 234 [realtime] works like essentially like a stop-watch. +Once it starts \, you can continue to "poll" [realtime] to view the +elapsed time.; +#X text 90 281 The odd aspect about comparing [realtime] to a stop-watch +is that a stop-watch can be stopped! [realtime] can only be started +or reset. It cannot be stopped.; +#N canvas 108 160 428 429 About_clocks 0; +#X text 20 60 In a fantasy world \, computers could exist somehow beyond +the restrictions of time and digital computation could be performed +in ZERO time. However \, that is not the case. Instead \, every process +within Pd and within your operating system requires at least a few +nanoseconds of your CPU's time.; +#X text 21 145 The [timer] object is like a clock that is not constrained +to the regular laws of physics and the universal space-time continuum. +It reports "time" measurements as only Pd can see them!; +#X text 22 205 The [cputime] object is like a clock that measures how +much time your CPU actually required to carry out your request. Keep +in mind however that your CPU is busy doing many things simoultaneously +\, so even though a process might take 5 minutes to complete \, your +CPU does not pay full attention to that process for the entire 5 minutes. +Instead \, it simply begins the process \, then refers back to that +process from time to time until the it is complete. In other cases +\, your CPU might require a full 5 minutes while Pd might report that +merely a few milliseconds have passed. This type of discrepancy depends +heavily on your computer's hardware and the type of processing it is +performing.; +#X text 21 369 The [realtime] object is as much like your own wrist +watch as Pd can possibly manage. It measures time according to your +operating system's internal clock.; +#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 [realtime] About Clocks; +#X text 21 38 Why the discrepancies between clocks?; +#X restore 102 569 pd About_clocks; +#N canvas 105 140 428 400 Comparing_timers 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 [realtime] Comparing timers in Pd; +#X obj 45 296 time_measurements; +#X obj 45 192 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X floatatom 45 353 0 0 0 0 - - -; +#X floatatom 114 353 0 0 0 0 - - -; +#X floatatom 184 353 0 0 0 0 - - -; +#X text 20 108 In the example below \, I've created an abstraction +which will force each of Pd's stop-watches \, [timer] [cputime] and +[realtime] to measure various processes and report the elapsed time. +Click on each [bng] to begin the process and wait for the results. +Notice the discrepancies in the results.; +#X text 20 371 Logical Time; +#X text 170 371 Real Time; +#X text 104 371 CPU Time; +#X obj 57 228 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X text 65 186 1 Measures elapsed time between two "bangs" from a [trigger] +object.; +#X text 77 220 2 Measures the amount of time Pd requires to turn on +DSP and start an oscillator.; +#X obj 97 260 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X text 118 252 3 Measures the amount of time Pd requires count to +three...please wait for approximately 3 seconds.; +#X text 20 39 As stated above \, [realtime] measures "real" or actual +time. This value may be slightly different that CPU time or "logical" +time. Pd offers two objects which measure CPU time and "logical" time. +See the reference documents for those objects for more information. +; +#X connect 2 0 4 0; +#X connect 2 1 5 0; +#X connect 2 2 6 0; +#X connect 3 0 2 0; +#X connect 11 0 2 1; +#X connect 14 0 2 2; +#X restore 102 547 pd Comparing_timers; +#X text 98 384 bang; +#X text 98 428 bang; +#X text 167 428 - a bang to the right inlet sends the elapsed time +to the outlet. Unlike most other objects in pd \, this is the "hot" +inlet \, i.e. \, it triggers the output.; +#X text 168 384 - a bang to the left inlet resets the timer. Unlike +most other objects in pd \, the left inlet of [realtime] is a "cold" +inlet \, i.e. \, it does not trigger the output.; +#X text 11 23 ask operating system for elapsed real time; +#X text 168 481 - elapsed time in milliseconds.; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X connect 14 0 20 1; +#X connect 15 0 20 0; +#X connect 20 0 16 0; diff --git a/pd/doc/5.reference/receive-help.pd b/pd/doc/5.reference/receive-help.pd index 17bb08cb3..31fe6e5e0 100644 --- a/pd/doc/5.reference/receive-help.pd +++ b/pd/doc/5.reference/receive-help.pd @@ -1,26 +1,185 @@ -#N canvas 257 45 511 351 12; -#X text 278 321 updated for Pd version 0.32; -#X floatatom 36 55 5 0 0; -#X floatatom 152 58 5 0 0; -#X floatatom 272 57 5 0 0; -#X floatatom 38 134 5 0 0; -#X floatatom 171 136 5 0 0; -#X floatatom 305 134 5 0 0; -#X text 62 321 abbreviation:; -#X obj 36 80 send help-rcv1; -#X obj 152 81 send help-rcv1; -#X obj 271 81 send help-rcv2; -#X obj 38 110 receive help-rcv1; -#X obj 171 110 receive help-rcv2; -#X obj 305 110 receive help-rcv2; -#X text 31 161 "Receive" outputs messages sent via "send." Sends and receives are named to tell them whom to connect to. They work across windows too. Also \, you can use message boxes as shown:; -#X msg 84 233 \; help-rcv1 34 \; help-rcv2 67; -#X obj 161 320 r; -#X obj 21 10 receive; -#X text 79 10 -- receive messages without patch cords; -#X connect 1 0 8 0; -#X connect 2 0 9 0; -#X connect 3 0 10 0; -#X connect 11 0 4 0; -#X connect 12 0 5 0; -#X connect 13 0 6 0; +#N canvas 431 34 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 receive 3 12 0 18 +-204280 -1 0; +#X obj 0 271 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 485 282 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 Dave Sabine \, September 9 \, 2003 +. Jonathan Wilkes revised the patch to conform to the PDDP template +for Pd version 0.42.; +#X text 12 25 KEYWORDS control nonlocal; +#X text 12 65 DESCRIPTION receive messages without patch cords; +#X text 12 85 OUTLET_0 anything; +#X text 12 5 ALIAS r; +#X text 12 165 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 331 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 373 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 434 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 219 333 428 292 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 [receive] Related Objects; +#X text 20 109 Externals and other object libraries; +#X obj 115 43 receive~; +#X obj 177 43 send~; +#X obj 23 43 send; +#X obj 278 43 throw~; +#X obj 333 43 catch~; +#X obj 23 73 tabreceive~; +#X obj 121 73 tabsend~; +#X obj 193 73 netsend; +#X obj 259 73 netreceive; +#X obj 225 43 value; +#X obj 70 43 qlist; +#X obj 20 128 pddp/helplink ggee/streamin~; +#X obj 20 148 pddp/helplink ext13/receive13~; +#X obj 20 168 pddp/helplink maxlib/remote; +#X obj 20 188 pddp/helplink receivelocal; +#X obj 20 208 pddp/helplink maxlib/dist; +#X text 106 188 <- which library? (No help patch exists); +#X obj 20 228 pddp/helplink receiveOSC; +#X text 106 227 <- which library?; +#X text 106 247 <- which library?; +#X obj 20 248 pddp/helplink shoutamp~; +#X obj 20 268 pddp/helplink maxlib/netdist; +#X restore 102 597 pd Related_objects; +#X obj 78 340 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 518 12 r; +#X obj 444 12 receive; +#X text 494 12 or; +#X obj 47 107 s; +#X floatatom 47 83 5 0 0 0 - - -, f 5; +#X floatatom 149 112 5 0 0 0 - - -, f 5; +#X obj 149 83 r; +#X floatatom 204 112 5 0 0 0 - - -, f 5; +#X obj 204 83 r; +#X floatatom 255 112 5 0 0 0 - - -, f 5; +#X obj 255 83 r; +#X floatatom 51 166 5 0 0 0 - - -, f 5; +#X floatatom 306 192 5 0 0 0 - - -, f 5; +#X floatatom 377 192 5 0 0 0 - - -, f 5; +#X floatatom 452 192 5 0 0 0 - - -, f 5; +#X text 50 146 with creation argument; +#X obj 51 190 s dave; +#X obj 306 163 r dave; +#X obj 377 163 r dave; +#X floatatom 151 167 5 0 0 0 - - -, f 5; +#X floatatom 383 82 5 0 0 0 - - -, f 5; +#X msg 383 105 \; dave \$1; +#X floatatom 461 80 5 0 0 0 - - -, f 5; +#X msg 461 105 \; hans \$1; +#X obj 452 163 r hans; +#X obj 151 191 s hans; +#X text 98 275 (none); +#X text 98 339 anything; +#X text 168 339 - [receive] outputs the message(s) sent from a corresponding +[send] of the same name.; +#N canvas 100 55 428 469 Messages_and_Data_Types 0; +#X floatatom 23 177 5 0 0 0 - - -, f 5; +#X floatatom 22 288 5 0 0 0 - - -, f 5; +#X obj 23 234 s a_float; +#X obj 22 262 r a_float; +#X obj 33 205 s whatever; +#X obj 170 204 s whatever; +#X obj 158 233 s a_symbol; +#X obj 158 262 r a_symbol; +#X symbolatom 158 176 10 0 0 0 - - -, f 10; +#X text 62 176 click-n-drag; +#X text 228 176 type something; +#X text 318 200 click this; +#X obj 305 307 s whatever; +#X obj 295 277 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 295 336 s a_bang; +#X text 317 275 click this too; +#X obj 295 379 r a_bang; +#X obj 295 407 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 72 313 r whatever; +#X floatatom 72 443 5 0 0 0 - - -, f 5; +#X symbolatom 113 424 10 0 0 0 - - -, f 10; +#X obj 161 381 print; +#X obj 195 363 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X symbolatom 158 291 10 0 0 0 - - -, f 10; +#X obj 154 404 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X msg 295 217 \; whatever 1 2 3 4 \;; +#X obj 72 338 route float symbol list bang; +#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 [receive] More Info; +#X text 20 38 Pd's [send] and [receive] objects can communicate any +message that is supported by Pd: floats \, anythings \, lists \, symbols +\, and bangs. However \, you will need to plan ahead in your patch +to ensure that a symbol doesn't accidently arrive at a [float] object +\, or that a list doesn't arrive at a [symbol] object. Consider the +following: I have been very careful to keep [send] and [receive] groups +isolated to specific data types - and in the last case \, I have incorporated +a [route] object to properly receive the various data types at a single +[receive] object.; +#X connect 0 0 2 0; +#X connect 0 0 4 0; +#X connect 3 0 1 0; +#X connect 7 0 23 0; +#X connect 8 0 6 0; +#X connect 8 0 5 0; +#X connect 13 0 12 0; +#X connect 13 0 14 0; +#X connect 16 0 17 0; +#X connect 18 0 26 0; +#X connect 26 0 19 0; +#X connect 26 1 20 0; +#X connect 26 2 21 0; +#X connect 26 2 24 0; +#X connect 26 3 22 0; +#X restore 101 569 pd Messages_and_Data_Types; +#X text 11 23 receive messages without patch cords; +#X text 168 391 - [receive] accepts a single argument which is a 'name'. +All [receive]s of the same name correspond to a [send] object of that +name.; +#X text 168 275 - data can be inputted to the [receive] object using +the [send] object or by using the nonlocal send functionality of a +message box. The [receive] object accepts any message as input.; +#X text 334 99 Using; +#X text 334 110 message; +#X text 334 122 boxes; +#X text 80 391 1) symbol atom; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 98 439 pddp/pddplink all_about_send_n_receive.pd -text all_about_send_n_receive +; +#X obj 98 454 pddp/pddplink all_about_scope_and_locality.pd -text all_about_scope_and_locality +; +#X obj 97 512 pddp/pddplink ../2.control.examples/09.send_receive.pd +-text doc/2.control.examples/09.send_receive.pd; +#X obj 97 527 pddp/pddplink ../2.control.examples/10.more.messages.pd +-text doc/2.control.examples/10.more.messages.pd; +#X obj 97 542 pddp/pddplink ../2.control.examples/13.locality.pd -text +doc/2.control.examples/13.locality.pd; +#X obj 98 475 pddp/pddplink ../1.manual/x2.htm -text doc/1.manual/x2.htm +; +#X obj 98 490 pddp/pddplink ../1.manual/x5.htm -text doc/1.manual/x5.htm +; +#X connect 13 0 12 0; +#X connect 15 0 14 0; +#X connect 17 0 16 0; +#X connect 19 0 18 0; +#X connect 20 0 25 0; +#X connect 26 0 21 0; +#X connect 27 0 22 0; +#X connect 28 0 34 0; +#X connect 29 0 30 0; +#X connect 31 0 32 0; +#X connect 33 0 23 0; diff --git a/doc/pddp/rev1~-help.pd b/pd/doc/5.reference/rev1~-help.pd similarity index 100% rename from doc/pddp/rev1~-help.pd rename to pd/doc/5.reference/rev1~-help.pd diff --git a/doc/pddp/rev2~-help.pd b/pd/doc/5.reference/rev2~-help.pd similarity index 100% rename from doc/pddp/rev2~-help.pd rename to pd/doc/5.reference/rev2~-help.pd diff --git a/doc/pddp/rev3~-help.pd b/pd/doc/5.reference/rev3~-help.pd similarity index 100% rename from doc/pddp/rev3~-help.pd rename to pd/doc/5.reference/rev3~-help.pd diff --git a/doc/pddp/rmstodb-help.pd b/pd/doc/5.reference/rmstodb-help.pd similarity index 100% rename from doc/pddp/rmstodb-help.pd rename to pd/doc/5.reference/rmstodb-help.pd diff --git a/doc/pddp/rmstodb~-help.pd b/pd/doc/5.reference/rmstodb~-help.pd similarity index 100% rename from doc/pddp/rmstodb~-help.pd rename to pd/doc/5.reference/rmstodb~-help.pd diff --git a/pd/doc/5.reference/route-help.pd b/pd/doc/5.reference/route-help.pd index 2293426d5..f3f8aa152 100644 --- a/pd/doc/5.reference/route-help.pd +++ b/pd/doc/5.reference/route-help.pd @@ -1,11 +1,11 @@ -#N canvas 513 24 555 689 10; +#N canvas 427 31 555 685 10; #X obj 0 697 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 route 3 12 0 18 -204280 -1 0; #X obj 0 240 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 -228856 -1 0; -#N canvas 50 229 494 392 META 0; +#N canvas 482 297 494 392 META 0; #X text 12 85 PLATFORM windows macosx gnulinux; #X text 12 165 LIBRARY internal; #X text 12 205 WEBSITE http://crca.ucsd.edu/~msp/; @@ -31,7 +31,7 @@ or first element; 0 13 -228856 -1 0; #X obj 0 672 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 0 13 -228856 -1 0; -#N canvas 74 482 428 109 Related_objects 0; +#N canvas 211 576 428 109 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 [route] Related Objects; @@ -43,9 +43,7 @@ or first element; -162280 0; #X obj 78 456 cnv 17 3 17 empty \$0-pddp.cnv.let.0 n 5 9 0 16 -228856 -162280 0; -#X obj 512 4 route; -#X obj 459 20 pddp/pddplink http://wiki.puredata.info/en/route -text -pdpedia: route; +#X obj 508 12 route; #X obj 27 113 route 0 1; #X msg 27 61 0 12; #X msg 65 61 1 13; @@ -60,7 +58,7 @@ pdpedia: route; #X obj 27 136 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 -1 -1; #X msg 140 61 7 17; -#N canvas 414 108 517 509 float_mode 0; +#N canvas 414 108 516 509 float_mode 0; #X text 89 271 float; #X text 89 365 list; #X text 89 325 symbol; @@ -84,16 +82,20 @@ to the rightmost outlet.; ; #X msg 141 50 2; #X msg 148 72 1 2 3; -#X obj 129 167 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 +#X obj 141 167 bng 12 250 50 0 empty empty empty 17 7 0 10 -262144 +-1 -1; +#X obj 162 167 bng 12 250 50 0 empty empty empty 17 7 0 10 -262144 -1 -1; #X msg 169 116 something else; #X obj 204 167 print rejection_outlet; -#X obj 141 239 print out0; -#X obj 162 217 print out1; +#X obj 141 233 print out0; +#X obj 162 211 print out1; #X text 50 26 For "float mode" \, the first argument must be a float. ; #X obj 141 142 route 1 2 3; -#X obj 183 195 print out2; +#X obj 183 189 print out2; +#X obj 183 167 bng 12 250 50 0 empty empty empty 17 7 0 10 -262144 +-1 -1; #X msg 158 94 3 dog night; #X text 139 325 - the symbol is compared to the creation arguments \, and a bang is sent to the corresponding outlet if there is a match. @@ -103,21 +105,17 @@ creation argument(s). If there is a match \, the first element is removed from the list \, and the remaining list is sent to the outlet corresponding to the matching creation argument. If there is no match the input is sent to the rightmost outlet.; -#X obj 150 167 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 --1 -1; -#X obj 171 167 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 --1 -1; -#X connect 13 0 21 0; -#X connect 14 0 21 0; -#X connect 16 0 21 0; -#X connect 21 0 18 0; -#X connect 21 0 15 0; -#X connect 21 1 19 0; -#X connect 21 1 26 0; -#X connect 21 2 22 0; -#X connect 21 2 27 0; -#X connect 21 3 17 0; -#X connect 23 0 21 0; +#X connect 13 0 22 0; +#X connect 14 0 22 0; +#X connect 17 0 22 0; +#X connect 22 0 15 0; +#X connect 22 0 19 0; +#X connect 22 1 16 0; +#X connect 22 1 20 0; +#X connect 22 2 23 0; +#X connect 22 2 24 0; +#X connect 22 3 18 0; +#X connect 25 0 22 0; #X restore 171 306 pd float_mode; #X text 98 249 anything; #X text 168 249 - [route] handles its input in 3 different "modes" @@ -133,10 +131,10 @@ below to see how message types are handled under each mode.; -228856 -1 0; #X obj 69 398 cnv 17 3 255 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 -162280 0; -#X obj 56 244 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 -1 --1; -#X obj 89 244 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 -1 +#X obj 68 244 bng 12 250 50 0 empty empty empty 17 7 0 10 -262144 -1 -1; +#X obj 101 244 bng 12 250 50 0 empty empty empty 17 7 0 10 -262144 +-1 -1; #X obj 203 262 print rejection_outlet; #X msg 68 59 der; #X obj 68 349 print out0; @@ -174,12 +172,12 @@ outlet. If there is no match the input is sent to the rightmost outlet. #X text 91 667 Beware! All this can be confusing at times...; #X msg 84 103 das; #X obj 135 305 print out2; -#X obj 123 244 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 +#X obj 135 244 bng 12 250 50 0 empty empty empty 17 7 0 10 -262144 -1 -1; -#X obj 157 244 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 +#X obj 169 244 bng 12 250 50 0 empty empty empty 17 7 0 10 -262144 -1 -1; #X msg 108 182 doh; -#X obj 191 244 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 +#X obj 203 244 bng 12 250 50 0 empty empty empty 17 7 0 10 -262144 -1 -1; #X msg 74 81 die 41; #X text 49 36 In selector mode \, all creation arguments should be @@ -487,6 +485,7 @@ multiple creation arguments \, you'll notice that this second inlet is absent.; #X obj 23 256 route 42; #X obj 217 276 route word; +#X floatatom 23 278 5 0 0 0 - - -, f 5; #X msg 23 210 42; #X obj 217 255 list trim; #X text 20 128 Also notice in the right example how symbols need to @@ -494,22 +493,20 @@ be truncated of its symbol prefix using [list trim] or using a message. Otherwise \, route will not recognize the value correctly.; #X msg 164 206 word; #X msg 125 182 symbol word; -#X obj 23 278 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 -1 --1; #X connect 1 0 12 0; #X connect 2 0 12 1; -#X connect 4 0 15 0; -#X connect 5 0 15 0; +#X connect 4 0 16 0; +#X connect 5 0 16 0; #X connect 6 0 13 1; #X connect 8 0 13 1; -#X connect 12 0 19 0; +#X connect 12 0 14 0; #X connect 12 1 0 0; #X connect 13 0 3 0; #X connect 13 1 7 0; -#X connect 14 0 12 0; -#X connect 15 0 13 0; -#X connect 17 0 13 0; +#X connect 15 0 12 0; +#X connect 16 0 13 0; #X connect 18 0 13 0; +#X connect 19 0 13 0; #X restore 171 416 pd second_inlet; #X text 98 400 symbol; #X text 167 386 - the right inlet is available if there is only one @@ -523,21 +520,21 @@ creation argument. See the subpatch below for details:; #X text 398 119 This one doesn't work; #X msg 269 85 symbol word; #X msg 258 60 word; -#X connect 12 0 17 0; -#X connect 12 0 21 0; -#X connect 12 1 19 0; -#X connect 12 1 20 0; -#X connect 12 2 16 0; -#X connect 12 2 18 0; -#X connect 13 0 12 0; -#X connect 14 0 12 0; -#X connect 15 0 12 0; -#X connect 22 0 12 0; -#X connect 33 0 12 0; -#X connect 49 0 52 0; -#X connect 49 1 51 0; -#X connect 50 0 49 0; -#X connect 53 0 50 0; -#X connect 54 0 49 0; -#X connect 56 0 50 0; -#X connect 57 0 49 0; +#X connect 11 0 16 0; +#X connect 11 0 20 0; +#X connect 11 1 18 0; +#X connect 11 1 19 0; +#X connect 11 2 15 0; +#X connect 11 2 17 0; +#X connect 12 0 11 0; +#X connect 13 0 11 0; +#X connect 14 0 11 0; +#X connect 21 0 11 0; +#X connect 32 0 11 0; +#X connect 48 0 51 0; +#X connect 48 1 50 0; +#X connect 49 0 48 0; +#X connect 52 0 49 0; +#X connect 53 0 48 0; +#X connect 55 0 49 0; +#X connect 56 0 48 0; diff --git a/pd/doc/5.reference/rpole~-help.pd b/pd/doc/5.reference/rpole~-help.pd index 76d976901..e17d2697b 100644 --- a/pd/doc/5.reference/rpole~-help.pd +++ b/pd/doc/5.reference/rpole~-help.pd @@ -1,49 +1,60 @@ -#N canvas 56 7 669 542 12; -#X floatatom 118 172 0 0 0 0 - - -; -#X obj 54 85 osc~ 100; -#X msg 69 117 clear; -#X obj 96 512 lop~; -#X text 10 512 see also:; -#X obj 52 7 rpole~; -#X text 114 7 real one-pole (recursive) filter \, raw; -#X text 8 35 Rpole~ filters an audio signal (left inlet) via a one-pole -real filter \, whose coefficient is controlled by a creation argument -or by an audio signal (right inlet).; -#X obj 95 441 rzero~; -#X obj 35 463 cpole~; -#X obj 35 441 rpole~; -#X obj 154 441 rzero_rev~; -#X obj 95 463 czero~; -#X obj 154 463 czero_rev~; -#X text 253 441 real; -#X text 252 464 complex; -#X text 32 425 1-pole; -#X text 92 425 1-zero; -#X text 142 425 1-zero \, reversed; -#X text 57 410 summary of raw filters:; -#X msg 71 143 set 1; -#X text 119 142 <-- set internal state; -#X text 132 86 <-- signal to filter; -#X text 150 173 <-- filter coefficient (may be a signal); -#X text 150 195 <-- creation argument initializes filter coefficient +#N canvas 428 34 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 rpole~ 3 12 0 18 +-204280 -1 0; +#X obj 0 338 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 484 286 494 344 META 0; +#X text 12 125 LIBRARY internal; +#X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 145 AUTHOR Miller Puckette; +#X text 12 205 HELP_PATCH_AUTHORS Updated for Pd version-0.38. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 5 KEYWORDS signal filter; +#X text 12 45 DESCRIPTION real one-pole (recursive) filter \, raw; +#X text 12 85 INLET_1 float signal; +#X text 12 65 INLET_0 signal clear set; +#X text 12 105 OUTLET_0 signal; +#X text 12 185 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 454 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 486 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 528 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#X obj 78 347 cnv 17 3 55 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 463 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 413 cnv 17 3 30 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X obj 497 10 rpole~; +#X floatatom 152 194 0 0 0 0 - - -; +#X obj 96 107 osc~ 100; +#X msg 111 139 clear; +#X msg 113 165 set 1; +#X text 163 165 <-- set internal state; +#X text 163 108 <-- signal to filter; +#X text 182 195 <-- filter coefficient (may be a signal); +#X text 182 217 <-- creation argument initializes filter coefficient ; -#X text 10 310 The transfer function is H(Z) = 1/(1 - aZ^-1).; -#X text 121 117 <-- clear internal state to zero; -#X text 11 272 where y[n] is the output \, x[n] the input \, and a[n] -the filter coefficient. The filter is unstable if/when |a[n]|>1.; -#X obj 53 195 rpole~ 0.9; -#X text 14 230 The action of rpole~ is:; -#N canvas 393 91 326 287 test 0; +#X text 163 139 <-- clear internal state to zero; +#X obj 95 217 rpole~ 0.9; +#N canvas 93 273 326 287 test 0; #X obj 76 78 osc~; -#X floatatom 76 55 5 0 0 0 - - -; +#X floatatom 76 55 5 0 0 0 - - -, f 5; #X obj 77 219 env~ 16384; -#X floatatom 77 243 5 0 0 0 - - -; +#X floatatom 77 243 5 0 0 0 - - -, f 5; #X obj 76 168 rpole~; #X obj 104 107 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0 1; #X obj 76 105 *~; #X msg 97 137 set 1; -#X floatatom 172 157 4 -100 100 0 - - -; +#X floatatom 172 157 4 -100 100 0 - - -, f 4; #X obj 172 182 / 100; #X obj 214 256 dac~; #X obj 228 177 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0 @@ -65,15 +76,66 @@ the filter coefficient. The filter is unstable if/when |a[n]|>1.; #X connect 12 0 10 0; #X connect 12 0 10 1; #X connect 13 0 12 1; -#X restore 457 427 pd test; -#X text 136 512 etc.: user-friendly filters; -#X text 8 331 (Pd also provides a suite of user-friendly filters. This +#X restore 101 537 pd test; +#X text 11 23 real one-pole (recursive) filter \, raw; +#X text 50 58 [rpole~] filters an audio signal (left inlet) via a one-pole +real filter \, whose coefficient is controlled by a creation argument +or by an audio signal (right inlet).; +#X text 98 346 signal; +#X text 168 346 - the incoming signal to filter.; +#X text 98 366 clear; +#X text 168 366 - clear internal state to zero.; +#X text 98 386 set; +#X text 168 386 - set internal state (e.g. \, "set 1").; +#X text 98 412 float; +#X text 98 462 signal; +#X text 168 462 - the outgoing \, filtered signal.; +#X text 108 264 y[n] = y[n-1] + a[n] * x[n]; +#X text 49 316 The transfer function is H(Z) = 1/(1 - aZ^-1).; +#X text 49 284 where y[n] is the output \, x[n] the input \, and a[n] +the filter coefficient. The filter is unstable if/when |a[n]|>1.; +#X text 80 505 1) float; +#N canvas 212 318 428 309 Related_objects 0; +#X obj 74 60 rzero~; +#X obj 25 80 cpole~; +#X obj 25 60 rpole~; +#X obj 123 60 rzero_rev~; +#X obj 74 80 czero~; +#X obj 123 80 czero_rev~; +#X text 201 60 real; +#X text 200 81 complex; +#X text 22 44 1-pole; +#X text 71 44 1-zero; +#X text 121 44 1-zero \, reversed; +#X text 47 29 summary of raw filters:; +#X text 18 184 User-friendly Filters; +#X obj 21 213 lop~; +#X obj 72 212 hip~; +#X obj 124 213 bp~; +#X obj 169 214 vcf~; +#X obj 22 274 biquad~; +#X text 18 250 Other Objects; +#X text 18 113 Pd also provides a suite of user-friendly filters. This and other raw filters are provided for situations which the user-friendly ones can't handle. See Chapter 8 of http://crca.ucsd.edu/~msp/techniques -for an introduction to the necessary theory.); -#X text 73 252 y[n] = x[n] + a[n] * y[n-1]; -#X text 413 511 updated for Pd version 0.42; -#X connect 0 0 28 1; -#X connect 1 0 28 0; -#X connect 2 0 28 0; -#X connect 20 0 28 0; +for an introduction to the necessary theory.; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 7 1 [rpole~] Related Objects; +#X restore 101 597 pd Related_objects; +#X text 98 430 signal; +#X text 167 430 - filter coefficient.; +#X text 167 412 - filter coefficient.; +#X text 167 505 - (optional) initializes filter coefficient.; +#X text 49 242 The action of [rpole~] is:; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 473 58 pddp/dsp; +#X obj 98 557 pddp/pddplink ../3.audio.examples/H11.shelving.pd -text +doc/3.audio.examples/H11.shelving.pd; +#X obj 98 572 pddp/pddplink ../3.audio.examples/H14.all.pass.pd -text +doc/3.audio.examples/H14.all.pass.pd; +#X connect 11 0 20 1; +#X connect 12 0 20 0; +#X connect 13 0 20 0; +#X connect 14 0 20 0; diff --git a/pd/doc/5.reference/rsqrt~-help.pd b/pd/doc/5.reference/rsqrt~-help.pd index fb0bc3508..ccca26b03 100644 --- a/pd/doc/5.reference/rsqrt~-help.pd +++ b/pd/doc/5.reference/rsqrt~-help.pd @@ -1,32 +1,73 @@ -#N canvas 183 264 685 375 12; -#X obj 68 211 metro 500; -#X obj 68 186 r metro; -#X msg 575 106 \; metro 0; -#X msg 574 48 \; pd dsp 1 \; metro 1; -#X floatatom 52 112 0 0 0; -#X floatatom 52 268 0 0 0; -#X text 419 349 updated for Pd version 0.33; -#X obj 574 21 loadbang; -#X obj 52 235 snapshot~; -#X floatatom 51 351 9 0 0; -#X obj 51 295 t f f; -#X obj 51 322 *; -#X obj 52 138 sig~; -#X obj 36 16 rsqrt~; -#X text 105 14 - signal reciprocal square root; -#X text 18 45 rsqrt~ takes the approximate reciprocal square root of -the incoming signal \, using a fast \, approximate algorithm which +#N canvas 427 35 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 rsqrt~ 3 12 0 18 +-204280 -1 0; +#X obj 0 468 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 483 290 494 344 META 0; +#X text 12 105 LIBRARY internal; +#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 125 AUTHOR Miller Puckette; +#X text 12 185 HELP_PATCH_AUTHORS Updated for Pd version 0.33. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 45 DESCRIPTION signal reciprocal square root; +#X text 12 5 KEYWORDS signal; +#X text 12 65 INLET_0 signal; +#X text 12 85 OUTLET_0 signal; +#X text 12 165 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 504 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 540 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 567 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#X text 98 544 (none); +#N canvas 213 526 428 105 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 obj 22 43 sqrt~; +#X obj 137 43 q8_sqrt~; +#X obj 67 43 q8_rsqrt~; +#X obj 197 43 sqrt; +#X text 8 2 [rsqrt~] Related Objects; +#X restore 102 597 pd Related_objects; +#X obj 78 476 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 513 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 500 11 rsqrt~; +#X obj 233 261 metro 500; +#X obj 233 236 r metro; +#X floatatom 217 157 0 0 0 0 - - -; +#X floatatom 217 319 0 0 0 0 - - -; +#X obj 217 294 snapshot~; +#X floatatom 217 404 9 0 0 0 - - -, f 9; +#X obj 217 346 t f f; +#X obj 217 375 *; +#X obj 217 183 sig~; +#X obj 217 212 rsqrt~; +#X text 98 475 signal; +#X text 98 512 signal; +#X text 11 23 signal reciprocal square root; +#X text 168 475 - incoming signal.; +#X text 168 512 - reciprocal square root of the incoming signal.; +#X text 74 110 [rsqrt~] takes the approximate reciprocal square root +of the incoming signal \, using a fast \, approximate algorithm which is probably accurate to about 120 dB (20 bits).; -#X obj 52 162 rsqrt~; -#X connect 0 0 8 0; -#X connect 1 0 0 0; -#X connect 1 0 0 0; -#X connect 4 0 12 0; -#X connect 5 0 10 0; -#X connect 7 0 3 0; -#X connect 8 0 5 0; -#X connect 10 0 11 0; -#X connect 10 1 11 1; -#X connect 11 0 9 0; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 478 54 pddp/dsp; #X connect 12 0 16 0; -#X connect 16 0 8 0; +#X connect 13 0 12 0; +#X connect 14 0 20 0; +#X connect 15 0 18 0; +#X connect 16 0 15 0; +#X connect 18 0 19 0; +#X connect 18 1 19 1; +#X connect 19 0 17 0; +#X connect 20 0 21 0; +#X connect 21 0 16 0; diff --git a/pd/doc/5.reference/rzero_rev~-help.pd b/pd/doc/5.reference/rzero_rev~-help.pd index ae85dceaa..7157f50cf 100644 --- a/pd/doc/5.reference/rzero_rev~-help.pd +++ b/pd/doc/5.reference/rzero_rev~-help.pd @@ -1,39 +1,101 @@ -#N canvas 717 52 526 510 12; -#X floatatom 127 186 0 0 0 0 - - -; -#X obj 49 98 osc~ 100; -#X msg 64 130 clear; -#X obj 77 483 lop~; -#X text 8 483 see also:; -#X text 331 482 updated for Pd version-0.38; -#X obj 84 430 rzero~; -#X obj 35 450 cpole~; -#X obj 35 430 rpole~; -#X obj 133 430 rzero_rev~; -#X obj 84 450 czero~; -#X obj 133 450 czero_rev~; -#X text 211 430 real; -#X text 210 451 complex; -#X text 32 414 1-pole; -#X text 81 414 1-zero; -#X text 131 414 1-zero \, reversed; -#X text 57 399 summary of raw filters:; -#X msg 66 156 set 1; -#X text 112 156 <-- set internal state; -#X text 113 99 <-- signal to filter; -#X text 155 189 <-- filter coefficient (may be a signal); -#X text 143 210 <-- creation argument initializes filter coefficient +#N canvas 427 32 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 rzero_rev~ 3 12 +0 18 -204280 -1 0; +#X obj 0 335 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 485 287 494 344 META 0; +#X text 12 135 LIBRARY internal; +#X text 12 175 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 155 AUTHOR Miller Puckette; +#X text 12 215 HELP_PATCH_AUTHORS Updated for Pd version-0.38. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 5 KEYWORDS signal filter; +#X text 12 45 DESCRIPTION real one-zero (non-recursive) "reverse" filter +\, raw; +#X text 12 75 INLET_0 signal clear set; +#X text 12 95 INLET_1 float signal; +#X text 12 115 OUTLET_0 signal; +#X text 12 195 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 465 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 502 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 543 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#X obj 78 344 cnv 17 3 65 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 474 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 419 cnv 17 3 35 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X text 98 418 float; +#X obj 477 9 rzero_rev~; +#X floatatom 283 190 0 0 0 0 - - -; +#X obj 215 116 osc~ 100; +#X msg 230 148 clear; +#X msg 232 174 set 1; +#X obj 214 216 rzero_rev~ 1; +#X text 11 23 real one-zero (non-recursive) "reverse" filter \, raw ; -#X text 108 129 <-- clear internal state to zero; -#N canvas 393 91 326 287 test 0; +#X text 98 343 signal; +#X text 98 363 clear; +#X text 98 393 set; +#X text 168 363 - clear internal state to zero.; +#X text 168 343 - the incoming signal to be filtered.; +#X text 168 393 - set internal state.; +#X text 167 418 - filter coefficient.; +#X text 167 438 - filter coefficient.; +#X text 98 473 signal; +#X text 168 473 - the outgoing \, filtered signal.; +#X text 80 520 1) float; +#X text 167 520 - (optional) initializes the filter coefficient.; +#X text 69 49 [rzero_rev~] filters an audio signal (left inlet) via +a one-zero real filter \, whose coefficient is controlled by a creation +argument or by an audio signal (right inlet). The impulse response +is that of "rzero" reversed in time.; +#N canvas 213 318 428 309 Related_objects 0; +#X obj 74 60 rzero~; +#X obj 25 80 cpole~; +#X obj 25 60 rpole~; +#X obj 123 60 rzero_rev~; +#X obj 74 80 czero~; +#X obj 123 80 czero_rev~; +#X text 201 60 real; +#X text 200 81 complex; +#X text 22 44 1-pole; +#X text 71 44 1-zero; +#X text 121 44 1-zero \, reversed; +#X text 47 29 summary of raw filters:; +#X text 18 184 User-friendly Filters; +#X obj 21 213 lop~; +#X obj 72 212 hip~; +#X obj 124 213 bp~; +#X obj 169 214 vcf~; +#X obj 22 274 biquad~; +#X text 18 250 Other Objects; +#X text 18 113 Pd also provides a suite of user-friendly filters. This +and other raw filters are provided for situations which the user-friendly +ones can't handle. See Chapter 8 of http://crca.ucsd.edu/~msp/techniques +for an introduction to the necessary theory.; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 7 1 [rzero_rev~] Related Objects; +#X restore 101 597 pd Related_objects; +#N canvas 80 271 326 287 test 0; #X obj 76 78 osc~; -#X floatatom 76 55 5 0 0 0 - - -; +#X floatatom 76 55 5 0 0 0 - - -, f 5; #X obj 77 219 env~ 16384; -#X floatatom 77 243 5 0 0 0 - - -; +#X floatatom 77 243 5 0 0 0 - - -, f 5; #X obj 104 107 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0 1; #X obj 76 105 *~; #X msg 97 137 set 1; -#X floatatom 172 157 4 -100 100 0 - - -; +#X floatatom 172 157 4 -100 100 0 - - -, f 4; #X obj 172 182 / 100; #X obj 214 256 dac~; #X obj 228 177 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0 @@ -56,26 +118,19 @@ #X connect 12 0 11 1; #X connect 14 0 2 0; #X connect 14 0 11 0; -#X restore 457 416 pd test; -#X text 111 483 etc.: user-friendly filters; -#X text 8 270 where y[n] is the output \, x[n] the input \, and a[n] +#X restore 102 552 pd test; +#X text 70 281 where y[n] is the output \, x[n] the input \, and a[n] the filter coefficient. The filter is always stable.; -#X obj 52 7 rzero_rev~; -#X text 139 7 real one-zero (non-recursive) "reverse" filter \, raw +#X text 126 261 y[n] = -a[n] * x[n] + x[n-1]; +#X text 70 312 The transfer function is H(Z) = -a + Z^-1.; +#X text 69 240 The action of [rzero_rev~] is:; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide ; -#X obj 48 208 rzero_rev~ 1; -#X text 7 35 Rzero_rev~ filters an audio signal (left inlet) via a -one-zero real filter \, whose coefficient is controlled by a creation -argument or by an audio signal (right inlet). The impulse response -is that of "rzero" reversed in time.; -#X text 14 230 The action of rpole_rev~ is:; -#X text 71 251 y[n] = -a[n] * x[n] + x[n-1]; -#X text 6 302 The transfer function is H(Z) = -a + Z^-1.; -#X text 5 321 (Pd also provides a suite of user-friendly filters. This -and other raw filters are provided for situations which the user-friendly -ones can't handle. See Chapter 8 of http://crca.ucsd.edu/~msp/techniques -for an introduction to the necessary theory.); -#X connect 0 0 29 1; -#X connect 1 0 29 0; -#X connect 2 0 29 0; -#X connect 18 0 29 0; +#X obj 479 53 pddp/dsp; +#X obj 99 572 pddp/pddplink ../3.audio.examples/H14.all.pass.pd -text +doc/3.audio.examples/H14.all.pass.pd; +#X text 98 438 signal; +#X connect 12 0 16 1; +#X connect 13 0 16 0; +#X connect 14 0 16 0; +#X connect 15 0 16 0; diff --git a/pd/doc/5.reference/rzero~-help.pd b/pd/doc/5.reference/rzero~-help.pd index ea0f1d0b5..8707d44bb 100644 --- a/pd/doc/5.reference/rzero~-help.pd +++ b/pd/doc/5.reference/rzero~-help.pd @@ -1,39 +1,72 @@ -#N canvas 211 109 664 557 12; -#X floatatom 104 172 0 0 0 0 - - -; -#X obj 54 85 osc~ 100; -#X msg 69 117 clear; -#X obj 92 520 lop~; -#X text 9 520 see also:; -#X text 402 521 updated for Pd version-0.38; -#X obj 100 459 rzero~; -#X obj 35 483 cpole~; -#X obj 35 459 rpole~; -#X obj 164 459 rzero_rev~; -#X obj 100 483 czero~; -#X obj 164 483 czero_rev~; -#X text 262 459 real; -#X text 261 484 complex; -#X text 33 438 1-pole; -#X text 98 439 1-zero; -#X text 162 438 1-zero \, reversed; -#X text 57 420 summary of raw filters:; -#X msg 71 143 set 1; -#X text 125 143 <-- set internal state; -#X text 134 86 <-- signal to filter; -#X text 137 172 <-- filter coefficient (may be a signal); -#X text 132 195 <-- creation argument initializes filter coefficient +#N canvas 431 35 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 rzero~ 3 12 0 18 +-204280 -1 0; +#X obj 0 349 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 490 289 494 344 META 0; +#X text 12 125 LIBRARY internal; +#X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 145 AUTHOR Miller Puckette; +#X text 12 205 HELP_PATCH_AUTHORS Updated for Pd version-0.38. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 5 KEYWORDS signal filter; +#X text 12 45 DESCRIPTION real one-zero (non-recursive) filter \, raw ; -#X text 124 116 <-- clear internal state to zero; -#N canvas 393 91 326 287 test 0; +#X text 12 65 INLET_0 signal clear set; +#X text 12 85 INLET_1 float signal; +#X text 12 105 OUTLET_0 signal; +#X text 12 185 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 465 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 502 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 544 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#X obj 78 358 cnv 17 3 55 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 474 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 424 cnv 17 3 30 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X text 98 423 float; +#X obj 501 10 rzero~; +#X floatatom 241 193 0 0 0 0 - - -; +#X obj 197 108 osc~ 100; +#X msg 212 140 clear; +#X msg 214 166 set 1; +#X obj 196 218 rzero~ 1; +#X text 11 23 real one-zero (non-recursive) filter \, raw; +#X text 98 357 signal; +#X text 168 357 - the incoming signal to filter.; +#X text 74 52 [rzero~] filters an audio signal (left inlet) via a one-zero +real filter \, whose coefficient is controlled by a creation argument +or by an audio signal (right inlet).; +#X text 98 377 clear; +#X text 168 377 - clear internal state to zero.; +#X text 98 397 set; +#X text 168 397 - set internal state (e.g. \, "set 1").; +#X text 167 423 - filter coefficient.; +#X text 167 438 - filter coefficient.; +#X text 98 438 signal; +#X text 80 521 1) float; +#X text 167 521 - (optional) initializes the filter coefficient.; +#X text 98 473 signal; +#X text 168 473 - the outgoing \, filtered signal.; +#N canvas 74 275 326 287 test 0; #X obj 76 78 osc~; -#X floatatom 76 55 5 0 0 0 - - -; +#X floatatom 76 55 5 0 0 0 - - -, f 5; #X obj 77 219 env~ 16384; -#X floatatom 77 243 5 0 0 0 - - -; +#X floatatom 77 243 5 0 0 0 - - -, f 5; #X obj 104 107 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0 1; #X obj 76 105 *~; #X msg 97 137 set 1; -#X floatatom 172 157 4 -100 100 0 - - -; +#X floatatom 172 157 4 -100 100 0 - - -, f 4; #X obj 172 182 / 100; #X obj 214 256 dac~; #X obj 228 177 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0 @@ -56,24 +89,46 @@ #X connect 12 0 11 1; #X connect 14 0 2 0; #X connect 14 0 11 0; -#X restore 457 416 pd test; -#X text 136 520 etc.: user-friendly filters; -#X obj 52 7 rzero~; -#X text 114 7 real one-zero (non-recursive) filter \, raw; -#X text 8 35 Rzero~ filters an audio signal (left inlet) via a one-zero -real filter \, whose coefficient is controlled by a creation argument -or by an audio signal (right inlet).; -#X obj 53 195 rzero~ 1; -#X text 8 271 where y[n] is the output \, x[n] the input \, and a[n] -the filter coefficient. The filter is always stable.; -#X text 9 307 The transfer function is H(Z) = 1 - aZ^-1.; -#X text 68 250 y[n] = x[n] - a[n] * x[n-1]; -#X text 7 330 (Pd also provides a suite of user-friendly filters. This +#X restore 101 553 pd test; +#N canvas 217 323 428 309 Related_objects 0; +#X obj 74 60 rzero~; +#X obj 25 80 cpole~; +#X obj 25 60 rpole~; +#X obj 123 60 rzero_rev~; +#X obj 74 80 czero~; +#X obj 123 80 czero_rev~; +#X text 201 60 real; +#X text 200 81 complex; +#X text 22 44 1-pole; +#X text 71 44 1-zero; +#X text 121 44 1-zero \, reversed; +#X text 47 29 summary of raw filters:; +#X text 18 184 User-friendly Filters; +#X obj 21 213 lop~; +#X obj 72 212 hip~; +#X obj 124 213 bp~; +#X obj 169 214 vcf~; +#X obj 22 274 biquad~; +#X text 18 250 Other Objects; +#X text 18 113 Pd also provides a suite of user-friendly filters. This and other raw filters are provided for situations which the user-friendly ones can't handle. See Chapter 8 of http://crca.ucsd.edu/~msp/techniques -for an introduction to the necessary theory.); -#X text 14 230 The action of rzero~ is:; -#X connect 0 0 29 1; -#X connect 1 0 29 0; -#X connect 2 0 29 0; -#X connect 18 0 29 0; +for an introduction to the necessary theory.; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 7 1 [rzero~] Related Objects; +#X restore 101 597 pd Related_objects; +#X text 74 290 where y[n] is the output \, x[n] the input \, and a[n] +the filter coefficient. The filter is always stable.; +#X text 74 320 The transfer function is H(Z) = 1 - aZ^-1.; +#X text 128 269 y[n] = x[n] - a[n] * x[n-1]; +#X text 74 249 The action of [rzero~] is:; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 482 53 pddp/dsp; +#X obj 98 573 pddp/pddplink ../3.audio.examples/H11.shelving.pd -text +doc/3.audio.examples/H11.shelving.pd; +#X connect 12 0 16 1; +#X connect 13 0 16 0; +#X connect 14 0 16 0; +#X connect 15 0 16 0; diff --git a/pd/doc/5.reference/samphold~-help.pd b/pd/doc/5.reference/samphold~-help.pd index 4ad542cfc..0dc597825 100644 --- a/pd/doc/5.reference/samphold~-help.pd +++ b/pd/doc/5.reference/samphold~-help.pd @@ -1,46 +1,107 @@ -#N canvas 430 114 568 497 12; -#X obj 24 451 snapshot~; -#X floatatom 24 476 5 0 0 0 - - -; -#X obj 33 425 metro 100; -#X obj 19 7 samphold~; -#X text 96 6 - sample and hold unit; -#X obj 24 376 samphold~; -#X text 14 32 The samphold~ object samples its left input whenever -its right input decreases in value (as a phasor~ does each period \, -for example.) Both inputs are audio signals.; -#X obj 59 340 sig~; -#X obj 116 376 sig~; -#X floatatom 59 315 3 0 0 0 - - -; -#X floatatom 116 355 3 0 0 0 - - -; -#X msg 24 212 set 34; -#X msg 37 281 reset; -#X text 89 210 set output to a number; -#X text 97 315 sample signal; -#X text 159 353 control signal; -#X msg 32 244 reset 10; -#X text 111 242 reset previous value; -#X text 100 292 to force the next sample; -#X obj 33 403 loadbang; -#X text 320 472 updated for version 0.39; -#X text 111 256 for control inlet; -#X text 99 278 reset to default 1e+20; -#X text 14 82 The "set" message sets the output value (which continues -to be updated as normal afterward.) The "reset" message causes samphold~ -to act as if the specified value were the most recent value of the -control input. Use this \, for example \, if you reset the incoming +#N canvas 429 36 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 samphold~ 3 12 0 +18 -204280 -1 0; +#X obj 0 244 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 488 288 494 344 META 0; +#X text 12 125 LIBRARY internal; +#X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 145 AUTHOR Miller Puckette; +#X text 12 205 HELP_PATCH_AUTHORS Updated for version 0.39. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 5 KEYWORDS signal; +#X text 12 45 DESCRIPTION sample and hold unit; +#X text 12 65 INLET_0 signal set reset; +#X text 12 85 INLET_1 signal float; +#X text 12 105 OUTLET signal; +#X text 12 185 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 507 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 544 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 569 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#X text 98 547 (none); +#N canvas 217 520 428 109 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 [samphold~] Related Objects; +#X obj 22 43 phasor~; +#X obj 79 43 threshold~; +#X restore 102 597 pd Related_objects; +#X obj 78 253 cnv 17 3 175 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 516 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 441 cnv 17 3 60 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X obj 482 10 samphold~; +#X obj 180 197 snapshot~; +#X floatatom 180 219 5 0 0 0 - - -, f 5; +#X obj 180 151 samphold~; +#X obj 207 118 sig~; +#X obj 252 140 sig~; +#X floatatom 207 97 3 0 0 0 - - -, f 3; +#X floatatom 252 119 3 0 0 0 - - -, f 3; +#X msg 130 48 set 34; +#X msg 192 71 reset; +#X text 232 96 sample signal; +#X text 277 117 control signal; +#X msg 180 48 reset 10; +#X text 238 77 to force the next sample; +#X text 237 63 reset to default 1e+20; +#X text 98 252 signal; +#X text 98 292 set; +#X text 98 322 reset; +#X text 98 399 float; +#X text 168 252 - incoming signal \, which is sampled whenever the +right input decreases in value (as [phasor~] does each period \, for +example).; +#X text 98 440 signal; +#X text 98 464 float; +#X text 167 464 - floats are accepted (and lists truncated) without +error. They are ignored \, however \, if there is a signal connection +to the same inlet.; +#X text 98 515 signal; +#X text 168 515 - the outgoing signal; +#X text 168 292 - the "set" message sets the output value \, which +continues to be updated as normal afterward (e.g. \, "set 34").; +#X text 167 440 - the right inlet is the "control signal". When it +decreases in value \, the left input is sampled.; +#N canvas 291 150 170 145 metro 0; +#X obj 19 18 loadbang; +#X obj 19 42 metro 100; +#X obj 19 65 outlet; +#X connect 0 0 1 0; +#X connect 1 0 2 0; +#X restore 192 174 pd metro; +#X text 11 23 sample and hold unit; +#X text 168 399 - floats are accepted (and lists truncated) without +error. They are ignored \, however \, if there is a signal connection +to the same inlet.; +#X text 168 322 - the "reset" message causes [samphold~] to act as +if the specified value were the most recent value of the control input +(e.g. \, "reset 10"). Use this \, for example \, if you reset the incoming phasor but don't want the jump reflected in the output. Plain "reset" is equivalent to "reset infinity" which forces the next input to be sampled.; -#X msg 122 422 \; pd dsp 1; -#X connect 0 0 1 0; -#X connect 2 0 0 0; -#X connect 5 0 0 0; -#X connect 7 0 5 0; -#X connect 8 0 5 1; -#X connect 9 0 7 0; -#X connect 10 0 8 0; -#X connect 11 0 5 0; -#X connect 12 0 5 0; -#X connect 16 0 5 0; -#X connect 19 0 2 0; -#X connect 19 0 24 0; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 478 53 pddp/dsp; +#X obj 98 573 pddp/pddplink ../3.audio.examples/C09.sample.hold.pd +-text doc/3.audio.examples/C09.sample.hold.pd; +#X connect 13 0 14 0; +#X connect 15 0 13 0; +#X connect 16 0 15 0; +#X connect 17 0 15 1; +#X connect 18 0 16 0; +#X connect 19 0 17 0; +#X connect 20 0 15 0; +#X connect 21 0 15 0; +#X connect 24 0 15 0; +#X connect 39 0 13 0; diff --git a/doc/pddp/samplerate~-help.pd b/pd/doc/5.reference/samplerate~-help.pd similarity index 100% rename from doc/pddp/samplerate~-help.pd rename to pd/doc/5.reference/samplerate~-help.pd diff --git a/pd/doc/5.reference/savepanel-help.pd b/pd/doc/5.reference/savepanel-help.pd index b5d7e7a65..670750f6d 100644 --- a/pd/doc/5.reference/savepanel-help.pd +++ b/pd/doc/5.reference/savepanel-help.pd @@ -1,12 +1,69 @@ -#N canvas 9 118 567 234 12; -#X msg 102 92 bang; -#X obj 102 145 print; -#X text 295 199 updated for Pd version 0.24; -#X text 28 192 see also:; -#X text 16 35 When Savepanel gets a "bang" a "Save As" file browser appears on the screen \, If you choose a filename \, it appears on the outlet.; -#X obj 102 120 savepanel; -#X obj 115 191 openpanel; -#X obj 19 7 savepanel; -#X text 104 6 - query you for the name of a file to create; -#X connect 0 0 5 0; -#X connect 5 0 1 0; +#N canvas 427 34 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 savepanel 3 12 0 +18 -204280 -1 0; +#X obj 0 334 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 486 285 494 344 META 0; +#X text 12 105 LIBRARY internal; +#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 125 AUTHOR Miller Puckette; +#X text 12 185 HELP_PATCH_AUTHORS Updated for Pd version 0.24. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 5 KEYWORDS control GUI; +#X text 12 45 DESCRIPTION query the user for the name of a file to +create; +#X text 12 85 DATATYPE_OUT symbol; +#X text 12 65 INLET_0 bang symbol; +#X text 12 165 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 459 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 501 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 528 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#X text 98 505 (none); +#N canvas 213 517 428 109 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 obj 22 43 openpanel; +#X text 8 2 [savepanel] Related Objects; +#X restore 102 597 pd Related_objects; +#X obj 78 343 cnv 17 3 105 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 468 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 482 10 savepanel; +#X text 98 342 bang; +#X text 98 467 symbol; +#X text 168 467 - once chosen from the file browser \, the filename +is output as a symbol.; +#X text 99 532 [savepanel] handles filenames with spaces correctly. +However \, if you try to save a filename with spaces in a message box +\, for example \, it will be converted to a list the next time you +open the patch.; +#X msg 205 131 bang; +#X obj 205 225 print; +#X obj 205 200 savepanel; +#X msg 249 131 symbol /tmp; +#X text 98 387 symbol; +#X text 168 387 - you can send a symbol to the inlet of [savepanel] +to specify the initial directory (see above).; +#X text 98 422 list; +#X msg 249 153 symbol C:/; +#X text 11 23 query the user for the name of a file to create; +#X text 168 422 - a list will be truncated to the first element (if +it is a symbol).; +#X text 168 342 - when [savepanel] gets a bang \, a "Save As" file +browser appears on the screen. If you choose a filename \, it appears +on the outlet.; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X connect 16 0 18 0; +#X connect 18 0 17 0; +#X connect 19 0 18 0; +#X connect 23 0 18 0; diff --git a/doc/pddp/scalar-help.pd b/pd/doc/5.reference/scalar-help.pd similarity index 100% rename from doc/pddp/scalar-help.pd rename to pd/doc/5.reference/scalar-help.pd diff --git a/pd/doc/5.reference/select-help.pd b/pd/doc/5.reference/select-help.pd index 6bc17ad71..c7751a3a6 100644 --- a/pd/doc/5.reference/select-help.pd +++ b/pd/doc/5.reference/select-help.pd @@ -1,73 +1,318 @@ -#N canvas 47 29 618 662 12; -#X floatatom 22 332 0 0 0; -#X msg 156 120 6; -#X msg 119 120 234; -#X floatatom 119 150 0 0 0; -#X msg 121 301 1; -#X msg 89 301 54; -#X obj 22 392 print x1; -#X obj 100 391 print x2; -#X msg 58 301 23; -#X msg 22 302 234; -#X msg 65 120 6; -#X obj 28 180 select 6; -#X msg 28 120 234; -#X obj 28 210 print x1; -#X obj 107 211 print x2; -#X obj 177 391 print x3; -#X obj 255 392 print x4; -#X floatatom 28 150 0 0 0; -#X obj 22 362 select 23 54 1; -#X text 45 609 abbreviation:; -#X obj 169 610 sel; -#X text 20 37 In its simplest form shown below \, Select checks its input agains the constant "6". If they match \, the first outlet gives "bang" and otherwise the input is copied to the second outlet. If Select is used with a single argument \, a second inlet allows you to change the test value.; -#X text 22 239 You can give several arguments. You get an outlet for each test value and finally an outlet for values which match none of them. In this case you don't get inlets to change the test values:; -#X obj 32 566 print x1; -#X obj 114 567 print x2; -#X msg 34 451 symbol cort; -#X msg 46 476 symbol zack; -#X msg 178 476 symbol cort; -#X msg 184 501 symbol zack; -#X obj 34 539 select cort; -#X msg 308 462 symbol cort; -#X msg 415 462 symbol zack; -#X obj 308 551 print x1; -#X obj 385 551 print x2; -#X obj 308 521 select cort zack; -#X obj 462 551 print x3; -#X msg 413 487 symbol bill; -#X text 24 426 Select can also be used to sort symbols:; -#X text 83 637 see also:; -#X obj 175 639 route; -#X obj 32 10 select; -#X text 92 10 - compare numbers or symbols; -#X text 370 629 updated for Pd version 0.33; -#X connect 0 0 18 0; -#X connect 1 0 3 0; -#X connect 2 0 3 0; -#X connect 3 0 11 1; +#N canvas 431 33 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 select 3 12 0 18 +-204280 -1 0; +#X obj 0 163 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 484 205 494 420 META 0; +#X text 12 165 LIBRARY internal; +#X text 12 205 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 45 LICENSE SIBSD; +#X text 12 185 AUTHOR Miller Puckette; +#X text 12 245 HELP_PATCH_AUTHORS This help patch was updated for Pd +version 0.35 test 24 by Dave Sabine as part of a project called pddp +proposed by Krzysztof Czaja to build comprehensive documentation for +Pd. Jonathan Wilkes revised the patch to conform to the PDDP template +for Pd version 0.42.; +#X text 12 65 DESCRIPTION compare numbers or symbols; +#X text 12 5 ALIAS sel; +#X text 12 85 INLET_0 float symbol list; +#X text 12 105 INLET_1 float symbol; +#X text 12 125 OUTLET_N bang; +#X text 12 145 OUTLET_R float symbol; +#X text 12 25 KEYWORDS control symbol_op; +#X text 12 225 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 359 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 458 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 540 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 217 373 428 250 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 [select] Related Objects; +#X obj 22 43 route; +#X obj 62 43 spigot; +#X obj 107 43 symbol; +#X obj 155 43 float; +#X text 18 123 These objects are offered in Pd only if you have downloaded +and properly installed the appropriate library. These objects may or +may not exist in a single library.; +#X text 17 165 The best places to find information about Pd's libraries +is:; +#X text 18 185 www.puredata.org and click on "Downloads" then "Software" +; +#X text 18 200 or; +#X text 18 215 iem.kug.ac.at/pdb/; +#X text 19 83 Externals; +#X obj 19 103 pddp/helplink markex/multiselect; +#X restore 102 597 pd Related_objects; +#X obj 78 172 cnv 17 3 115 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 171 float; +#X text 98 210 list; +#X obj 78 368 cnv 17 3 40 empty \$0-pddp.cnv.let.n n 5 9 0 16 -228856 +-162280 0; +#X obj 78 306 cnv 17 3 45 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X text 98 305 float; +#X obj 444 10 select; +#X text 491 10 or; +#X obj 516 10 sel; +#X msg 62 49 6; +#X obj 29 99 select 6; +#X msg 29 49 234; +#X floatatom 29 76 0 0 0 0 - - -; +#X obj 29 127 print match; +#X obj 108 127 print NO_match; +#X text 202 115 Note that when the input to [select] matches one of +its creation arguments \, then a "bang" is sent to the outlet \, NOT +the original message.; +#X text 11 23 compare numbers or symbols; +#N canvas 57 54 428 548 A_Word_About_Conditional_Objects 0; +#X text 20 38 Using the [select] object \, and others listed below +\, Pd users can emulate the "conditional" statements of other programming +environments.; +#X text 20 79 Consider the following: (Visual Basic Script); +#X text 59 97 IF input = 1 THEN; +#X text 58 108 response.write("Hello"); +#X text 58 121 ELSEIF input = 2 THEN; +#X text 58 133 response.write("GoodBye"); +#X text 58 170 ELSE; +#X text 57 194 END IF; +#X text 22 217 Now the Pd equivalent:; +#X msg 60 242 1; +#X msg 92 242 2; +#X floatatom 138 242 5 0 0 0 - - -, f 5; +#X obj 60 280 sel 1 2; +#X msg 60 426 symbol Hello; +#X msg 79 399 symbol GoodBye; +#X symbolatom 181 452 21 0 0 0 - - -, f 21; +#X obj 27 517 ==; +#X obj 55 517 !=; +#X obj 82 517 >; +#X obj 108 517 <; +#X obj 135 517 >=; +#X obj 162 517 <=; +#X text 22 494 OTHER CONDITIONAL/RELATIONAL OBJECTS IN Pd; +#X text 57 181 response.write("No_match_for_me..."& input); +#X text 58 159 response.write("This_is_cool."); +#X obj 99 303 moses 3; +#X msg 136 371 symbol This_is_cool.; +#X obj 136 322 moses 10; +#X obj 181 344 makefilename No_match_for_me...%d; +#X text 58 147 ELSEIF (input < 3 AND input < 10) THEN; +#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 [select] Conditional Statements in Pd; +#X connect 9 0 12 0; +#X connect 10 0 12 0; +#X connect 11 0 12 0; +#X connect 12 0 13 0; +#X connect 12 1 14 0; +#X connect 12 2 25 0; +#X connect 13 0 15 0; +#X connect 14 0 15 0; +#X connect 25 1 27 0; +#X connect 26 0 15 0; +#X connect 27 0 26 0; +#X connect 27 1 28 0; +#X connect 28 0 15 0; +#X restore 102 549 pd A_Word_About_Conditional_Objects; +#N canvas 79 52 428 303 second_inlet 0; +#X obj 23 181 sel 42; +#X msg 23 135 42; +#X obj 23 203 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X floatatom 56 203 5 0 0 0 - - -, f 5; +#X floatatom 31 157 5 0 0 0 - - -, f 5; +#X floatatom 80 159 5 0 0 0 - - -, f 5; +#X obj 197 222 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X msg 183 137 symbol word; +#X msg 197 159 symbol other; +#X msg 295 161 symbol other; +#X obj 197 197 select word; +#X obj 260 222 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X msg 292 137 symbol word; +#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 [select] The Second Inlet; +#X text 20 38 The right inlet is used to reset the argument's value +as in the patch below. This feature is available only on [select] objects +with only ONE creation argument (or no creation arguments in which +case it takes on the default value of 0). In the other examples with +multiple creation arguments \, you'll notice that this second inlet +is absent.; +#X text 20 246 Note: A given [select] object will match floats or symbols +\, but not both. See the subpatch titled "matching_symbols" for more +details.; +#X connect 0 0 2 0; +#X connect 0 1 3 0; +#X connect 1 0 0 0; #X connect 4 0 0 0; -#X connect 5 0 0 0; -#X connect 8 0 0 0; -#X connect 9 0 0 0; -#X connect 10 0 17 0; -#X connect 11 0 13 0; -#X connect 11 1 14 0; -#X connect 12 0 17 0; -#X connect 17 0 11 0; -#X connect 18 0 6 0; -#X connect 18 1 7 0; -#X connect 18 2 15 0; -#X connect 18 3 16 0; -#X connect 25 0 29 0; -#X connect 26 0 29 0; -#X connect 27 0 29 1; -#X connect 28 0 29 1; -#X connect 29 0 23 0; -#X connect 29 1 24 0; -#X connect 30 0 34 0; -#X connect 31 0 34 0; -#X connect 34 0 32 0; -#X connect 34 1 33 0; -#X connect 34 2 35 0; -#X connect 36 0 34 0; +#X connect 5 0 0 1; +#X connect 7 0 10 0; +#X connect 8 0 10 0; +#X connect 9 0 10 1; +#X connect 10 0 6 0; +#X connect 10 1 11 0; +#X connect 12 0 10 1; +#X restore 171 335 pd second_inlet; +#N canvas 52 20 491 603 matching_symbols 0; +#X obj 151 304 print NO_match; +#X obj 22 304 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 54 304 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 86 304 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 118 304 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X msg 22 102 symbol dog; +#X msg 30 124 symbol cat; +#X msg 38 146 symbol foo; +#X msg 45 168 symbol earth; +#X msg 54 190 symbol 400; +#X obj 22 282 select dog cat foo 400; +#X msg 50 233 400; +#X obj 152 571 print NO_match; +#X obj 23 571 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 55 571 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 87 571 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 119 571 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X msg 23 385 symbol dog; +#X msg 31 407 symbol cat; +#X msg 39 429 symbol foo; +#X msg 46 451 symbol earth; +#X msg 54 473 symbol 400; +#X msg 75 506 400; +#X obj 23 549 select 400 dog cat foo; +#X text 126 182 Notice that "400" here is defined as a symbol data +type and the [select] object can successfully match it to the creation +argment.; +#X text 77 221 Notice that "400" here is a number and the [select] +object cannot successfully match it to the creation argument. That +is because this [select] expects symbols - not numbers.; +#X text 61 264 FIRST CREATION ARGUMENT IS A SYMBOL; +#X text 66 532 FIRST CREATION ARGUMENT IS A NUMBER; +#X text 103 500 Notice that "400" here is a number and the [select] +object can successfully match it to the creation argument.; +#X text 123 467 Notice that "400" here is a symbol and the [select] +object cannot successfully match it to the creation argument.; +#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 [select] Matching Symbols; +#X text 19 329 However \, in the case below \, you'll notice that the +FIRST creation argument is a number. Therefore \, this [select] object +expects numbers and will ignore the "symbol" data type.; +#X text 19 28 [select] can be used to match symbols. It important to +note that the FIRST creation argument indicates to the [select] object +which data type to expect. If your first creation argument is a symbol +\, like "dog" \, then the object will test only symbols \, and numbers +will be ignored!; +#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 connect 10 0 1 0; +#X connect 10 1 2 0; +#X connect 10 2 3 0; +#X connect 10 3 4 0; +#X connect 10 4 0 0; +#X connect 11 0 10 0; +#X connect 17 0 23 0; +#X connect 18 0 23 0; +#X connect 19 0 23 0; +#X connect 20 0 23 0; +#X connect 21 0 23 0; +#X connect 22 0 23 0; +#X connect 23 0 13 0; +#X connect 23 1 14 0; +#X connect 23 2 15 0; +#X connect 23 3 16 0; +#X connect 23 4 12 0; +#X restore 102 571 pd matching_symbols; +#X text 98 265 symbol; +#X text 98 319 symbol; +#X text 98 367 bang; +#X text 168 367 - for each creation argument \, a corresponding outlet +is created. When the value at the left inlet matches a creation argument +\, a bang is sent to the corresponding outlet.; +#X text 168 171 - if an incoming float matches a creation argument +\, a bang is sent to the corresponding outlet. If it does not match +\, the float is sent to the rightmost outlet.; +#X obj 78 421 cnv 17 3 30 empty \$0-pddp.cnv.let.r r 5 9 0 16 -228856 +-162280 0; +#X text 98 420 float; +#X text 98 435 symbol; +#X text 168 420 - if there is no match \, the float or symbol is sent +to the rightmost outlet.; +#X text 168 476 - [select] creates an outlet for each creation argument +(plus one outlet at the right). Floats and symbols may not be mixed. +See the subpatch below for more details:; +#N canvas 105 267 428 240 creation_arguments 0; +#X floatatom 23 152 0 0 0 0 - - -; +#X msg 87 110 1; +#X msg 53 110 54; +#X msg 23 110 23; +#X obj 23 182 select 23 54 1; +#X obj 23 209 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 50 209 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 77 209 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X floatatom 104 209 5 0 0 0 - - -, f 5; +#X text 61 139 If you click-n-drag this number box \, you'll notice +how all numbers except "23" \, "54" \, and "1" are simply sent through +to the rightmost outlet.; +#X text 20 38 Several creation arguments can be defined. In effect +you can use [select] to test the input for many different values. You +will see an outlet for each test value and finally an outlet for values +which match none of them (the rightmost outlet).; +#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 [select] Creation Arguments; +#X connect 0 0 4 0; +#X connect 1 0 0 0; +#X connect 2 0 0 0; +#X connect 3 0 0 0; +#X connect 4 0 5 0; +#X connect 4 1 6 0; +#X connect 4 2 7 0; +#X connect 4 3 8 0; +#X restore 171 517 pd creation_arguments; +#X text 97 47 In its simplest form shown here \, [select] checks its +input against the constant "6" (which is defined by the creation argument). +If they match \, the first outlet gives "bang" \; otherwise the input +is simply sent through to the second outlet.; +#X text 168 262 - if an incoming symbol matches a creation argument +\, a bang is sent to the corresponding outlet. If it does not match +\, the symbol is sent to the rightmost outlet.; +#X text 168 210 - if there is only one creation argument (or none) +\, the first and second element of the list will be distributed to +the two inlets of [select]. If there is more than one creation argument +the list will be truncated.; +#X text 167 305 - the right inlet is available if there is only one +creation argument. See the subpatch below for details:; +#X text 80 476 n) float; +#X text 98 491 symbol atom; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 296 572 pddp/pddplink ../2.control.examples/18.conditional.pd +-text doc/2.control.examples/18.conditional.pd; +#X connect 17 0 20 0; +#X connect 18 0 21 0; +#X connect 18 1 22 0; +#X connect 19 0 20 0; +#X connect 20 0 18 0; diff --git a/pd/doc/5.reference/send-help.pd b/pd/doc/5.reference/send-help.pd index f8d44a857..ca6d3aa50 100644 --- a/pd/doc/5.reference/send-help.pd +++ b/pd/doc/5.reference/send-help.pd @@ -1,26 +1,185 @@ -#N canvas 257 45 511 351 12; -#X text 278 321 updated for Pd version 0.32; -#X obj 21 10 send; -#X text 60 11 -- send messages without patch cords; -#X obj 36 80 send help-send1; -#X obj 152 81 send help-send1; -#X obj 271 81 send help-send2; -#X obj 38 110 receive help-send1; -#X obj 171 110 receive help-send2; -#X obj 305 110 receive help-send2; -#X floatatom 36 55 5 0 0; -#X floatatom 152 58 5 0 0; -#X floatatom 272 57 5 0 0; -#X floatatom 38 134 5 0 0; -#X floatatom 171 136 5 0 0; -#X floatatom 305 134 5 0 0; -#X obj 161 320 s; -#X text 62 321 abbreviation:; -#X text 31 161 "Send" sends messages to "receive" objects. Sends and receives are named to tell them whom to connect to. They work across windows too. Also \, you can use message boxes as shown:; -#X msg 84 233 \; help-send1 34 \; help-send2 67; -#X connect 6 0 12 0; -#X connect 7 0 13 0; -#X connect 8 0 14 0; -#X connect 9 0 3 0; -#X connect 10 0 4 0; -#X connect 11 0 5 0; +#N canvas 407 77 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 send 3 12 0 18 -204280 +-1 0; +#X obj 0 240 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 462 331 494 344 META 0; +#X text 12 125 LIBRARY internal; +#X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 45 LICENSE SIBSD; +#X text 12 145 AUTHOR Miller Puckette; +#X text 12 205 HELP_PATCH_AUTHORS Dave Sabine \, September 12 \, 2003 +. Jonathan Wilkes revised the patch to conform to the PDDP template +for Pd version 0.42.; +#X text 12 25 KEYWORDS control nonlocal; +#X text 12 65 DESCRIPTION send messages without patch cords; +#X text 12 5 ALIAS s; +#X text 12 85 INLET_0 anything; +#X text 12 105 INLET_1 symbol; +#X text 12 185 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 333 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 375 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 438 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 193 354 428 315 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 [send] Related Objects; +#X obj 23 43 receive~; +#X obj 88 43 send~; +#X obj 194 43 throw~; +#X obj 249 43 catch~; +#X obj 23 74 tabreceive~; +#X obj 111 74 tabsend~; +#X obj 180 74 netsend; +#X obj 247 74 netreceive; +#X obj 304 43 value; +#X obj 134 43 receive; +#X text 20 109 Externals and other object libraries; +#X obj 20 168 pddp/helplink maxlib/remote; +#X obj 20 208 pddp/helplink maxlib/dist; +#X text 106 188 <- which library? (No help patch exists); +#X text 106 227 <- which library?; +#X text 106 247 <- which library?; +#X obj 20 268 pddp/helplink maxlib/netdist; +#X obj 20 128 pddp/helplink ggee/streamout~; +#X obj 20 148 pddp/helplink ext13/send13~; +#X obj 20 188 pddp/helplink sendlocal; +#X obj 20 228 pddp/helplink sendOSC; +#X obj 20 248 pddp/helplink shoutcast~; +#X obj 20 288 pddp/helplink motex/system; +#X restore 102 597 pd Related_objects; +#X obj 78 342 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 465 10 send; +#X text 497 10 or; +#X obj 520 10 s; +#X obj 52 124 s; +#X floatatom 52 100 5 0 0 0 - - -, f 5; +#X floatatom 284 95 5 0 0 0 - - -, f 5; +#X obj 284 66 r; +#X floatatom 339 95 5 0 0 0 - - -, f 5; +#X obj 339 66 r; +#X floatatom 390 95 5 0 0 0 - - -, f 5; +#X obj 390 66 r; +#X floatatom 52 167 5 0 0 0 - - -, f 5; +#X floatatom 277 177 5 0 0 0 - - -, f 5; +#X floatatom 348 177 5 0 0 0 - - -, f 5; +#X floatatom 423 177 5 0 0 0 - - -, f 5; +#X text 51 147 with creation argument; +#X obj 52 191 s dave; +#X obj 277 148 r dave; +#X obj 348 148 r dave; +#X floatatom 152 168 5 0 0 0 - - -, f 5; +#X obj 423 148 r hans; +#X obj 152 192 s hans; +#X obj 78 249 cnv 17 3 35 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 247 anything; +#X obj 78 291 cnv 17 3 35 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X text 98 289 symbol; +#X text 168 289 - if [send] is created without an argument \, the right +inlet can be used to dynamically change the send/receive name. (See +example above).; +#X obj 112 124 s; +#X floatatom 112 66 5 0 0 0 - - -, f 5; +#X msg 157 66 symbol dave; +#X msg 157 94 symbol hans; +#X text 98 341 (none); +#X text 168 341 - all messages are sent to a corresponding [receive] +object with the same name.; +#X obj 98 442 pddp/pddplink all_about_send_n_receive.pd -text all_about_send_n_receive +; +#N canvas 64 68 428 493 Dynamic_send_vs_messages 0; +#X text 20 42 Consider this:; +#X floatatom 115 43 5 0 0 0 - - -, f 5; +#X floatatom 171 43 5 0 0 0 - - -, f 5; +#X obj 115 69 s dave; +#X obj 171 69 s hans; +#X obj 264 43 r dave; +#X obj 320 43 r hans; +#X floatatom 264 67 5 0 0 0 - - -, f 5; +#X floatatom 320 67 5 0 0 0 - - -, f 5; +#X text 20 112 Now consider this:; +#X floatatom 139 114 5 0 0 0 - - -, f 5; +#X floatatom 208 115 5 0 0 0 - - -, f 5; +#X msg 139 142 \; dave \$1; +#X msg 208 142 \; hans \$1; +#X text 20 232 And to complicate things a little more \, and offer +some interesting functionality \, consider the following:; +#X obj 264 90 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 320 90 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X msg 23 312 \; \$1 42; +#X text 20 184 In this example \, the message box contains a Pd command +which effectively sends the value of the variable (\$1) to either 'dave' +or 'hans'.; +#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 [send] Send using [send] of message? Dynamic [send]?; +#X msg 23 274 symbol dave; +#X msg 107 274 symbol hans; +#X text 66 302 In this example \, I have created a single routine which +acts as a 'dynamic' send object. The variable (\$1) in this message +box is replaced by the incoming symbol. The two patches below do the +same thing but with the [send] object:; +#X msg 162 364 symbol dave; +#X msg 171 386 symbol hans; +#X obj 162 467 send; +#X obj 162 440 42; +#X obj 162 413 t b a; +#X connect 1 0 3 0; +#X connect 2 0 4 0; +#X connect 5 0 7 0; +#X connect 6 0 8 0; +#X connect 7 0 15 0; +#X connect 8 0 16 0; +#X connect 10 0 12 0; +#X connect 11 0 13 0; +#X connect 21 0 17 0; +#X connect 22 0 17 0; +#X connect 24 0 28 0; +#X connect 25 0 28 0; +#X connect 27 0 26 0; +#X connect 28 0 27 0; +#X connect 28 1 26 1; +#X restore 101 567 pd Dynamic_send_vs_messages; +#X text 11 23 send messages without patch cords; +#X text 168 393 - specifies the send/receive name. If no arguments +are provided \, an extra inlet is available to dynamically set the +send/receive name.; +#X text 168 247 - when [send] is created with an argument \, it has +a single inlet which accepts any message as input. The input is sent +to all [receive] objects with the same name (argument).; +#X text 80 393 1) symbol atom; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 98 457 pddp/pddplink all_about_scope_and_locality.pd -text all_about_scope_and_locality +; +#X text 98 493 doc/1.manual/x5.htm; +#X text 98 478 doc/1.manual/x2.htm; +#X obj 97 515 pddp/pddplink ../2.control.examples/09.send_receive.pd +-text doc/2.control.examples/09.send_receive.pd; +#X obj 97 530 pddp/pddplink ../2.control.examples/10.more.messages.pd +-text doc/2.control.examples/10.more.messages.pd; +#X obj 97 545 pddp/pddplink ../2.control.examples/13.locality.pd -text +doc/2.control.examples/13.locality.pd; +#X connect 13 0 12 0; +#X connect 15 0 14 0; +#X connect 17 0 16 0; +#X connect 19 0 18 0; +#X connect 20 0 25 0; +#X connect 26 0 21 0; +#X connect 27 0 22 0; +#X connect 28 0 30 0; +#X connect 29 0 23 0; +#X connect 37 0 36 0; +#X connect 38 0 36 1; +#X connect 39 0 36 1; diff --git a/pd/doc/5.reference/send~-help.pd b/pd/doc/5.reference/send~-help.pd index 5c9db395d..8b9b7a198 100644 --- a/pd/doc/5.reference/send~-help.pd +++ b/pd/doc/5.reference/send~-help.pd @@ -1,32 +1,75 @@ -#N canvas 31 28 678 406 12; -#X floatatom 344 238 0 0 0; -#X obj 344 189 receive~ signal1; -#X obj 17 215 send~ signal1; -#X obj 17 192 sig~ 50; -#X obj 344 213 snapshot~; -#X obj 42 22 send~; -#X obj 94 23 receive~; -#X text 178 23 - one-to-many nonlocal signal connections; -#X obj 507 133 loadbang; -#X obj 507 194 metro 200; -#X msg 517 155 \; pd dsp 1; -#X floatatom 18 168 4 0 0; -#X text 48 51 A send~ object copies its input to a local buffer which all receive~ objects of the same name read from. They may be in different windows or even different patches. Any number of receives may be associated with one send~ but it is an error to have two send~s of the same name.; -#X obj 179 344 tabreceive~; -#X text 405 368 updated for Pd version 0.33.; -#X obj 148 187 sig~ 25; -#X obj 148 215 send~ signal2; -#X msg 355 139 set signal2; -#X msg 356 161 set signal1; -#X text 34 287 Send~/Receive~ only work for the default block size (64) \; for FFT applications see also:; -#X text 35 262 Receive~ takes "set" messages to switch between send~s.; -#X connect 1 0 4 0; -#X connect 3 0 2 0; -#X connect 4 0 0 0; -#X connect 8 0 9 0; -#X connect 8 0 10 0; -#X connect 9 0 4 0; -#X connect 11 0 3 0; -#X connect 15 0 16 0; -#X connect 17 0 1 0; -#X connect 18 0 1 0; +#N canvas 431 35 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 send~ 3 12 0 18 +-204280 -1 0; +#X obj 0 332 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 485 303 494 323 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.33. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 25 KEYWORDS signal nonlocal; +#X text 12 65 DESCRIPTION one-to-many nonlocal signal connections; +#X text 12 5 ALIAS s~; +#X text 12 85 INLET_0 signal; +#X text 12 165 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 374 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 467 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 516 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 217 522 428 109 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 obj 22 43 tabreceive~; +#X obj 102 43 throw~; +#X obj 152 43 catch~; +#X text 8 2 [send~] Related Objects; +#X restore 102 597 pd Related_objects; +#X obj 78 341 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 453 9 send~; +#X obj 157 236 send~ signal1; +#X obj 157 213 sig~ 50; +#X floatatom 157 189 4 0 0 0 - - -, f 4; +#X text 98 340 signal; +#X text 98 378 (none); +#X text 168 340 - a [send~] object copies its input to a local buffer +which all receive~ objects of the same name read from.; +#X text 168 378 - the incoming signal is sent to all [receive~] objects +that share the same name as the [send~] object. These objects may be +in different windows or even different patches. Any number of [receive~]'s +may be associated with one [send~] \, but it is an error to have two +[send~] objects of the same name.; +#X obj 284 147 receive~ signal1; +#X obj 284 236 snapshot~; +#X obj 304 176 loadbang; +#X obj 304 199 metro 150; +#X text 11 23 one-to-many nonlocal signal connections; +#X floatatom 284 263 5 0 0 0 - - -, f 5; +#X text 168 485 - [send~] takes a single argument which is the name +associated with this particular [send~] object.; +#X text 80 485 1) symbol atom; +#X text 98 519 [send~]/[receive~] only work for the default block size +(64).; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 481 57 pddp/dsp; +#X obj 96 571 pddp/pddplink ../3.audio.examples/G05.execution.order.pd +; +#X text 99 551 See also:; +#X obj 519 9 s~; +#X text 496 9 or; +#X connect 11 0 10 0; +#X connect 12 0 11 0; +#X connect 17 0 18 0; +#X connect 18 0 22 0; +#X connect 19 0 20 0; +#X connect 20 0 18 0; diff --git a/pd/doc/5.reference/set-help.pd b/pd/doc/5.reference/set-help.pd index d9750558b..e92d21127 100644 --- a/pd/doc/5.reference/set-help.pd +++ b/pd/doc/5.reference/set-help.pd @@ -1,61 +1,143 @@ -#N struct help-set-template1 float x float y symbol s; -#N canvas 355 10 598 568 12; -#X text 34 478 see also:; -#X obj 127 499 append; -#X obj 185 499 getsize; -#X obj 252 499 setsize; -#X obj 153 523 element; -#X obj 26 523 sublist; -#X msg 211 174 next; -#X floatatom 20 192 5 0 0 0 - - -; -#X floatatom 109 200 5 0 0 0 - - -; -#X obj 197 199 pointer; -#X text 274 132 output first scalar in list; -#X text 257 174 output next item; -#X text 263 223 First argument selects template.; -#X text 264 238 Remaining args are names of fields.; -#X obj 26 498 pointer; -#X msg 197 150 traverse pd-help-set-data \, next; -#N canvas 0 0 276 122 help-set-data 1; -#X scalar help-set-template1 39 23 dog \;; -#X scalar help-set-template1 99 73 cat \;; -#X restore 389 461 pd help-set-data; -#N canvas 41 424 514 219 help-set-template1 0; -#X obj 41 87 filledpolygon 9 0 1 0 0 20 0 20 30 0 30; -#X obj 39 34 struct help-set-template1 float x float y symbol s; -#X obj 46 133 drawsymbol s 0 -15 0 s=; -#X restore 389 483 pd help-set-template1; -#X text 86 10 -- set values in a scalar; -#X obj 20 223 set help-set-template1 x y; -#X text 19 174 x value; -#X text 107 181 y value; -#X obj 94 498 get; -#X text 14 34 "Set" takes a pointer to a scalar in its rightmost inlet -\; the remaining inlets set numeric values of fields. Only the leftmost -inlet is "hot". You can't "set" arrays or sublists. Instead \, you -can get pointers into them using "element" and "sublist" (probably +#N struct set-help-template float x float y float a symbol b; +#N canvas 425 34 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 set 3 12 0 18 -204280 +-1 0; +#X obj 0 230 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 481 285 494 344 META 0; +#X text 12 125 LIBRARY internal; +#X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 145 AUTHOR Miller Puckette; +#X text 12 205 HELP_PATCH_AUTHORS Updated for Pd version 0.33. Revised +by Jonathan Wilkes to conform to the PDDP template for Pd version 0.42. +; +#X text 12 5 KEYWORDS control data_structure; +#X text 12 45 DESCRIPTION set values in a scalar; +#X text 12 65 INLET_0 float list symbol bang; +#X text 12 85 INLET_N float symbol; +#X text 12 105 INLET_R pointer; +#X text 12 185 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 402 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 425 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 505 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 210 520 428 109 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 [set] Related Objects; +#X obj 23 44 get; +#X obj 55 44 append; +#X obj 105 44 getsize; +#X obj 161 44 setsize; +#X obj 221 44 element; +#X obj 23 69 sublist; +#X obj 81 69 struct; +#X obj 133 69 pointer; +#X restore 102 598 pd Related_objects; +#X obj 78 332 cnv 17 3 35 empty \$0-pddp.cnv.let.n n 5 9 0 16 -228856 +-162280 0; +#X text 98 237 float; +#X text 98 265 list; +#X obj 78 374 cnv 17 3 17 empty \$0-pddp.cnv.let.r r 5 9 0 16 -228856 +-162280 0; +#X obj 518 11 set; +#X text 11 23 set values in a scalar; +#N canvas 381 200 428 296 set-help-template 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 [set] Data Structure Template; +#X obj 23 124 drawcurve 0 1 60 50 70 50 70 60 60 60 60 50; +#X obj 23 244 drawcurve 0 1 25 85 50 a 75 85; +#X obj 23 80 drawcurve 0 1 0 20 100 20 100 120 0 120 0 20; +#X text 298 79 <- Head; +#X obj 23 102 drawcurve 0 1 30 50 40 50 40 60 30 60 30 50; +#X text 298 102 <- Left eye; +#X text 298 124 <- Right eye; +#X text 25 198 The following drawing instruction associates the field +"a" with the midpoint of a curve. Thus you can set the value of a and +change the arc/direction of the curve.; +#X text 217 244 <- Mouth; +#X text 187 152 <- Text; +#X text 187 175 <- Text; +#X obj 23 43 struct set-help-template float x float y float a symbol +b; +#X obj 25 152 drawsymbol b 25 125 0 b=; +#X obj 25 175 drawnumber a 40 a 900 a=; +#X restore 417 153 pd set-help-template; +#X scalar set-help-template 7 42 111 Comedy \;; +#X obj 359 126 pointer; +#X msg 359 73 traverse pd-set-help.pd \, next; +#X floatatom 224 127 5 0 0 0 - - -, f 5; +#X text 366 56 output first scalar in list; +#X scalar set-help-template 116 42 61 Tragedy \;; +#X msg 370 98 next; +#X text 405 97 output next item; +#X text 98 373 pointer; +#X text 168 265 - a list is distributed among the inlets.; +#X text 98 405 (none); +#X obj 78 238 cnv 17 3 85 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 332 float; +#X text 98 283 bang; +#X text 98 346 symbol; +#X text 98 310 symbol; +#X text 168 464 - all subsequent arguments are names of fields. There +is one inlet created per field (plus the rightmost inlet for the pointer). +; +#X text 167 373 - a pointer to a scalar.; +#X text 168 446 - the template of a scalar.; +#X text 168 283 - a bang to the leftmost inlet sets the field(s) of +the scalar with the last stored field value(s).; +#X text 168 237 - a float to the leftmost inlet updates the value(s) +for the field(s) specified in the creation arguments.; +#X text 168 332 - an inlet is added for each additional field specified +by the creation arguments. All fields must be the same type (i.e. \, +floats or symbols \, but not a mixture of the two).; +#X text 98 509 You can't [set] "arrays" or "sublists". Instead \, you +can get pointers into them using [element] and [sublist] (Note: [sublist] not working yet) and set individual items.; -#X text 333 530 updated for Pd version 0.39; -#X obj 94 523 struct; -#X obj 21 10 set; -#X msg 257 389 next; -#X obj 243 414 pointer; -#X msg 243 365 traverse pd-help-set-data \, next; -#X obj 21 444 set -symbol help-set-template1 s; -#X symbolatom 21 423 10 0 0 0 - - -; -#X msg 21 370 symbol monkey; -#X msg 29 396 symbol fish; -#X text 25 300 To set fields whose values are symbols \, give the set -object the "-symbol" argument. (Unfortunately \, you can't mix symbols -and numbers in the same "set" object.); +#X text 168 310 - see the subpatch "Setting_Symbolic_Fields" below. +; +#N canvas 98 376 428 215 Setting_Symbolic_Fields 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 [set] Setting symbolic fields; +#X obj 224 124 pointer; +#X msg 224 71 traverse pd-set-help.pd \, next; +#X msg 235 96 next; +#X msg 23 84 symbol Trauermarsch; +#X msg 48 109 symbol Scherzo; +#X text 20 37 To set symbolic fields of a scalar \, the "-symbol" flag +must be used as follows:; +#X text 20 178 You cannot set symbols and floats using the same [set] +object.; +#X obj 23 151 set -symbol set-help-template b; +#X connect 2 0 9 1; +#X connect 3 0 2 0; +#X connect 4 0 2 0; +#X connect 5 0 9 0; #X connect 6 0 9 0; -#X connect 7 0 19 0; -#X connect 8 0 19 1; -#X connect 9 0 19 2; -#X connect 15 0 9 0; -#X connect 27 0 28 0; -#X connect 28 0 30 1; -#X connect 29 0 28 0; -#X connect 31 0 30 0; -#X connect 32 0 31 0; -#X connect 33 0 31 0; +#X restore 101 552 pd Setting_Symbolic_Fields; +#X text 80 446 1) symbol atom; +#X text 80 464 n) symbol atom; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 98 572 pddp/pddplink ../4.data.structures/03.setting.data.pd +-text doc/4.data.structures/03.setting.data.pd; +#X obj 353 552 pddp/pddplink scalar-help.pd; +#X obj 224 153 set set-help-template a; +#X obj 224 201 set -symbol set-help-template b; +#X symbolatom 224 180 10 0 0 0 - - -, f 10; +#X text 236 73 Click here first->; +#X connect 16 0 45 1; +#X connect 16 0 46 1; +#X connect 17 0 16 0; +#X connect 18 0 45 0; +#X connect 21 0 16 0; +#X connect 47 0 46 0; diff --git a/pd/doc/5.reference/setsize-help.pd b/pd/doc/5.reference/setsize-help.pd index 79ead7563..5c48045d4 100644 --- a/pd/doc/5.reference/setsize-help.pd +++ b/pd/doc/5.reference/setsize-help.pd @@ -1,54 +1,107 @@ -#N struct help-setsize-template float x float y array array1 help-setsize-array1-template +#N struct string_of_dolls float x float y array dolls doll symbol label ; -#N struct help-setsize-array1-template float y; -#N canvas 331 45 682 463 12; -#X text 31 359 see also:; -#N canvas 393 10 495 265 help-setsize-template 0; -#X obj 27 174 filledpolygon 509 509 0 -10 -10 10 -10 10 10 -10 10; -#X obj 27 76 plot array1 500 1 10 15 10; -#X obj 24 16 struct help-setsize-template float x float y array array1 -help-setsize-array1-template; -#X restore 364 261 pd help-setsize-template; -#N canvas 0 0 299 169 help-setsize-data 1; -#X scalar help-setsize-template 31 23 \; 0 \; 10 \; 0 \; 10 \; 20 \; -10 \; 20 \; 70 \; 10 \; \;; -#X restore 363 240 pd help-setsize-data; -#N canvas 196 292 369 138 help-setsize-array1-template 0; -#X obj 30 71 filledpolygon 0 0 0 -5 0 0 5 5 0 0 -5; -#X obj 32 27 struct help-setsize-array1-template float y; -#X restore 363 284 pd help-setsize-array1-template; -#X obj 107 379 pointer; -#X obj 242 379 setsize; -#X obj 272 186 pointer; -#X msg 272 162 traverse pd-help-setsize-data \, next; -#X floatatom 25 189 5 0 0 0 - - -; -#X text 359 210 arguments: template \, field name; -#X obj 25 213 setsize help-setsize-template array1; -#X text 115 183 inlet for pointer; -#X obj 36 11 setsize; -#X obj 174 379 element; -#X text 31 156 number sets; -#X text 30 170 size; -#X text 99 12 -- resize an array; -#X text 25 34 "setsize" takes a pointer to a scalar at left and a number -at right. Its creation arguments specify the template of the pointer -and the name of an array field. Sending a number then sets the number -of elements of the array.; -#X text 24 93 The smallest possible size is one. If the array is resized -downward the extra data are lost. If resized upward \, the new elements -are initialized to default values.; -#X msg 566 335 bang; -#X text 297 333 click to reload from file -->; -#X text 274 143 click here first; -#N canvas 460 63 439 176 readit 1; -#X msg 66 65 \; pd-help-setsize-data read setsize.txt; -#X obj 107 18 inlet; -#X msg 62 123 \; pd-help-setsize-data write setsize.txt; -#X connect 1 0 0 0; -#X restore 566 361 pd readit; -#X text 416 395 updated for Pd version 0.40; -#X obj 28 379 struct; -#X connect 6 0 10 1; -#X connect 7 0 6 0; -#X connect 8 0 10 0; -#X connect 19 0 22 0; +#N struct doll float y; +#N canvas 431 39 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 setsize 3 12 0 18 +-204280 -1 0; +#X obj 0 304 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 487 301 494 328 META 0; +#X text 12 105 LIBRARY internal; +#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 125 AUTHOR Miller Puckette; +#X text 12 185 HELP_PATCH_AUTHORS Updated for Pd version 0.33. Revised +by Jonathan Wilkes to conform to the PDDP template for Pd version 0.42. +; +#X text 12 5 KEYWORDS control data_structure array; +#X text 12 45 DESCRIPTION resize an array; +#X text 12 65 INLET_0 float list; +#X text 12 85 INLET_1 pointer; +#X text 12 165 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 397 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 425 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 485 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 222 522 428 109 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 obj 23 44 get; +#X obj 83 44 append; +#X obj 133 44 getsize; +#X obj 189 44 element; +#X obj 23 69 sublist; +#X obj 81 69 struct; +#X obj 133 69 pointer; +#X text 8 2 [setsize] Related Objects; +#X obj 51 44 set; +#X restore 102 598 pd Related_objects; +#X obj 78 313 cnv 17 3 50 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 312 float; +#X text 98 337 list; +#X obj 78 369 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X text 11 23 resize an array; +#X obj 491 11 setsize; +#X scalar string_of_dolls 32 110 An_array_of_paper_dolls... \; -3 \; +0 \; 0 \; 0 \; 0 \; \;; +#X msg 204 171 traverse pd-setsize-help.pd \, next; +#X obj 204 196 pointer; +#X floatatom 33 237 5 0 0 0 - - -, f 5; +#N canvas 90 353 428 173 doll-template 0; +#X obj 23 43 struct doll float y; +#X obj 23 65 filledcurve 999 0 1 -10 -1 -10 -1 0 -1 0 -1 0 -4 0 -4 +-5 -9 3 -14 8 -9 5 -4 5 -4 5 -1 5 -1 15 -1 15 -1 15 3 15 3 5 3 5 3 +15 19 15 19 -10 19 -10 19 0 3 0 3 -10 3 -10 3; +#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 [setsize] Data Structure; +#X text 20 118 These are the drawing instructions for the paper doll. +This template is used as the element of the array "dolls" in the template +"string_of_dolls".; +#X restore 380 241 pd doll-template; +#N canvas 81 360 428 167 string_of_dolls 0; +#X obj 23 78 plot dolls 0 1 0 0 30; +#X obj 23 43 struct string_of_dolls float x float y array dolls doll +symbol label; +#X obj 23 101 drawsymbol label -15 -35 145; +#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 [setsize] Template for string_of_dolls; +#X text 20 124 Here we simply plot the array and give it a label by +using the [drawsymbol] object; +#X restore 380 263 pd string_of_dolls; +#X obj 33 263 setsize string_of_dolls dolls; +#X text 178 337 - a (float \, pointer) pair is distributed to the two +inlets. Lists with more than two elements will be truncated.; +#X text 98 368 pointer; +#X text 98 400 (none); +#X text 178 462 - the name of an array contained within the scalar. +; +#X text 178 312 - sending a float sets the number of elements of the +array specified by the 2nd creation argument.; +#X text 98 489 Sending values smaller than one to [setsize] will resize +the array to one \, which is the smallest possible size of an array. +If the array is resized downward (e.g. \, from 20 to 15 elements) the +extra data are lost. If resized upward \, the new elements are initialized +to default values.; +#X text 177 368 - a pointer to a scalar that contains an array.; +#X text 203 149 1) Click here first...; +#X text 32 211 2) ...then here.; +#X text 178 444 - the struct name of a scalar that contains an array. +; +#X text 80 444 1) symbol atom; +#X text 80 462 n) symbol atom; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 98 557 pddp/pddplink all_about_arrays.pd; +#X obj 98 572 pddp/pddplink scalar-help.pd; +#X connect 15 0 16 0; +#X connect 16 0 20 1; +#X connect 17 0 20 0; diff --git a/pd/doc/5.reference/sigbinops-help.pd b/pd/doc/5.reference/sigbinops-help.pd index b461c8468..201738d4d 100644 --- a/pd/doc/5.reference/sigbinops-help.pd +++ b/pd/doc/5.reference/sigbinops-help.pd @@ -1,60 +1,123 @@ -#N canvas 18 67 1086 595 10; -#X obj 8 251 +~; -#X obj 115 249 -~; -#X obj 222 249 *~; -#X obj 327 251 /~; -#X obj 38 17 +~; -#X obj 73 17 -~; -#X obj 106 16 *~; -#X obj 140 16 /~; -#X graph graph1 0 -1 100 1 678 446 1078 146; -#X array array1 100 float; -#X pop; -#X obj 327 293 tabwrite~ array1; -#X obj 8 293 tabwrite~ array1; -#X obj 115 293 tabwrite~ array1; -#X obj 222 293 tabwrite~ array1; -#X text 266 14 -- operators on audio signals; -#X obj 8 160 osc~ 440; -#X obj 480 157 osc~ 675; -#X msg 17 271 bang; -#X obj 173 15 max~; -#X obj 207 15 min~; -#X text 487 458 modified for Pd version 0.27; -#X obj 536 293 tabwrite~ array1; -#X obj 431 293 tabwrite~ array1; -#X obj 431 249 max~; -#X obj 536 251 min~; -#X msg 127 272 bang; -#X msg 233 271 bang; -#X msg 343 272 bang; -#X msg 443 271 bang; -#X msg 553 272 bang; -#X text 52 332 The binary signal operators can be configured to combine two signals as above \, or \, if you give a numeric argument \, audio signals are combined with scalars:; -#X obj 204 377 +~ 5; -#X text 60 406 The right inlet takes audio signals or numbers depending on whether the argument is present or not.; -#X msg 68 71 \; pd dsp 1; -#X connect 0 0 10 0; -#X connect 1 0 11 0; -#X connect 2 0 12 0; -#X connect 3 0 9 0; -#X connect 14 0 0 0; -#X connect 14 0 1 0; -#X connect 14 0 3 0; -#X connect 14 0 2 0; -#X connect 14 0 22 0; -#X connect 14 0 23 0; -#X connect 15 0 3 1; -#X connect 15 0 2 1; -#X connect 15 0 1 1; -#X connect 15 0 0 1; -#X connect 15 0 22 1; -#X connect 15 0 23 1; -#X connect 16 0 10 0; -#X connect 22 0 21 0; -#X connect 23 0 20 0; -#X connect 24 0 11 0; -#X connect 25 0 12 0; -#X connect 26 0 9 0; -#X connect 27 0 21 0; -#X connect 28 0 20 0; +#N canvas 427 35 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 (sigbinops) 3 12 +0 18 -204280 -1 0; +#X obj -1 385 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 485 289 494 344 META 0; +#X text 12 85 LIBRARY internal; +#X text 12 125 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 45 LICENSE SIBSD; +#X text 12 105 AUTHOR Miller Puckette; +#X text 12 165 HELP_PATCH_AUTHORS Updated for Pd v0.41. Revised by +Jonathan Wilkes to conform to the PDDP template for Pd version 0.42. +; +#X text 12 25 KEYWORDS signal; +#X text 12 65 DESCRIPTION binary operators for signals; +#X text 12 5 NAME +~ -~ *~ /~ max~ min~; +#X text 12 145 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj -1 465 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj -1 502 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj -1 566 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 +12 0 13 -228856 -1 0; +#N canvas 212 525 428 109 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 (sigbinops) Related Objects; +#X obj 22 43 log~; +#X obj 62 43 exp~; +#X obj 103 43 abs~; +#X restore 102 598 pd Related_objects; +#X obj 78 394 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 474 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 417 cnv 17 3 40 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X text 11 23 binary operators for signals; +#X obj 15 286 +~; +#X obj 103 284 -~; +#X obj 190 284 *~; +#X obj 275 286 /~; +#X obj 15 212 osc~ 440; +#X obj 415 212 osc~ 675; +#X obj 361 284 max~; +#X obj 447 286 min~; +#N canvas 0 0 450 300 (subpatch) 0; +#X array \$0a 100 float 2; +#X coords 0 1 99 -1 150 105 1; +#X restore 15 73 graph; +#X obj 344 11 +~; +#X obj 379 11 -~; +#X obj 412 11 *~; +#X obj 446 11 /~; +#X obj 479 11 max~; +#X obj 513 11 min~; +#X text 177 111 The binary signal operators can be configured to combine +two signals as above \, or \, if you give a numeric argument \, audio +signals are combined with scalars:; +#X obj 329 156 +~ 5; +#X text 177 181 The right inlet takes audio signals or numbers depending +on whether the argument is present or not.; +#X text 98 393 signal; +#X text 167 416 - an incoming signal; +#X text 168 393 - an incoming signal; +#X text 98 416 signal; +#X text 98 473 signal; +#X text 168 473 - the outgoing signal; +#X text 80 521 1) float; +#X text 168 521 - (optional) a float argument initializes the right +inlet to a value \, and allows the right inlet to receive float messages. +; +#X text 98 431 float; +#X text 167 431 - if an argument is provided \, the object's right +inlet will accept floats instead of a signal.; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 481 52 pddp/dsp; +#X obj 15 333 tabwrite~ \$0a; +#X obj 103 333 tabwrite~ \$0a; +#X obj 190 333 tabwrite~ \$0a; +#X obj 275 333 tabwrite~ \$0a; +#X obj 361 333 tabwrite~ \$0a; +#X obj 447 333 tabwrite~ \$0a; +#X obj 21 311 bng 15 250 50 0 empty empty empty 17 7 0 10 -204786 -1 +-1; +#X obj 109 311 bng 15 250 50 0 empty empty empty 17 7 0 10 -204786 +-1 -1; +#X obj 196 311 bng 15 250 50 0 empty empty empty 17 7 0 10 -204786 +-1 -1; +#X obj 281 311 bng 15 250 50 0 empty empty empty 17 7 0 10 -204786 +-1 -1; +#X obj 367 311 bng 15 250 50 0 empty empty empty 17 7 0 10 -204786 +-1 -1; +#X obj 453 311 bng 15 250 50 0 empty empty empty 17 7 0 10 -204786 +-1 -1; +#X connect 12 0 42 0; +#X connect 13 0 43 0; +#X connect 14 0 44 0; +#X connect 15 0 45 0; +#X connect 16 0 12 0; +#X connect 16 0 13 0; +#X connect 16 0 15 0; +#X connect 16 0 14 0; +#X connect 16 0 18 0; +#X connect 16 0 19 0; +#X connect 17 0 15 1; +#X connect 17 0 14 1; +#X connect 17 0 13 1; +#X connect 17 0 12 1; +#X connect 17 0 18 1; +#X connect 17 0 19 1; +#X connect 18 0 46 0; +#X connect 19 0 47 0; +#X connect 48 0 42 0; +#X connect 49 0 43 0; +#X connect 50 0 44 0; +#X connect 51 0 45 0; +#X connect 52 0 46 0; +#X connect 53 0 47 0; diff --git a/doc/pddp/sigmund~-help.pd b/pd/doc/5.reference/sigmund~-help.pd similarity index 100% rename from doc/pddp/sigmund~-help.pd rename to pd/doc/5.reference/sigmund~-help.pd diff --git a/pd/doc/5.reference/sig~-help.pd b/pd/doc/5.reference/sig~-help.pd index 727814870..04dcd716f 100644 --- a/pd/doc/5.reference/sig~-help.pd +++ b/pd/doc/5.reference/sig~-help.pd @@ -1,20 +1,64 @@ -#N canvas 132 175 547 284 12; -#X obj 109 221 snapshot~; -#X floatatom 110 246 0 0 0; -#X obj 78 12 sig~; -#X obj 24 133 sig~; -#X floatatom 24 108 0 0 0; -#X text 114 14 - convert numbers to audio signal; -#X text 11 53 In this example \, the sig~ object converts numbers to an audio signal \, which the snapshot~ converts back again.; -#X text 64 108 <-- Scroll to set value; -#X obj 109 131 loadbang; -#X msg 118 155 \; pd dsp 1; -#X obj 109 195 metro 200; -#X text 291 249 updated for Pd version 0.33; -#X connect 0 0 1 0; -#X connect 0 0 1 0; -#X connect 3 0 0 0; -#X connect 4 0 3 0; -#X connect 8 0 9 0; -#X connect 8 0 10 0; -#X connect 10 0 0 0; +#N canvas 428 34 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 sig~ 3 12 0 18 -204280 +-1 0; +#X obj 0 437 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 491 282 494 344 META 0; +#X text 12 105 LIBRARY internal; +#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 125 AUTHOR Miller Puckette; +#X text 12 185 HELP_PATCH_AUTHORS Updated for Pd version 0.33. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 5 KEYWORDS signal conversion; +#X text 12 45 DESCRIPTION convert numbers to audio signal; +#X text 12 65 INLET_0 float; +#X text 12 85 OUTLET_0 signal; +#X text 12 165 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 502 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 539 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 567 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#X text 98 543 (none); +#N canvas 213 518 428 109 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 obj 22 43 snapshot~; +#X text 8 2 [sig~] Related Objects; +#X restore 102 597 pd Related_objects; +#X obj 78 446 cnv 17 3 45 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 445 float; +#X text 98 474 list; +#X obj 78 511 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 510 10 sig~; +#X obj 245 228 snapshot~; +#X floatatom 245 253 0 0 0 0 - - -; +#X floatatom 165 106 0 0 0 0 - - -; +#X obj 245 178 loadbang; +#X obj 245 202 metro 200; +#X text 195 105 <- Scroll to set value; +#X text 168 445 - a float to the inlet of [sig~] will be converted +to an audio signal.; +#X text 98 510 signal; +#X obj 165 131 sig~; +#X text 11 23 convert numbers to audio signal; +#X text 168 474 - a list will be truncated to the first element.; +#X text 113 280 In this example \, the [sig~] object converts numbers +to an audio signal \, which the [snapshot~] converts back again.; +#X text 168 510 - the outgoing signal.; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 477 51 pddp/dsp; +#X connect 14 0 15 0; +#X connect 16 0 22 0; +#X connect 17 0 18 0; +#X connect 18 0 14 0; +#X connect 22 0 14 0; diff --git a/doc/pddp/sin-help.pd b/pd/doc/5.reference/sin-help.pd similarity index 100% rename from doc/pddp/sin-help.pd rename to pd/doc/5.reference/sin-help.pd diff --git a/pd/doc/5.reference/snapshot~-help.pd b/pd/doc/5.reference/snapshot~-help.pd index 468eb6783..01831b856 100644 --- a/pd/doc/5.reference/snapshot~-help.pd +++ b/pd/doc/5.reference/snapshot~-help.pd @@ -1,33 +1,80 @@ -#N canvas 85 46 661 400 12; -#X obj 19 316 snapshot~; -#X floatatom 19 339 0 0 0 0 - - -; -#X obj 74 14 snapshot~; -#X msg 30 264 bang; -#X text 112 342 This output updates each time bang is clicked above. +#N canvas 429 34 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 snapshot~ 3 12 0 +18 -204280 -1 0; +#X obj 0 417 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 486 284 494 344 META 0; +#X text 12 105 LIBRARY internal; +#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 125 AUTHOR Miller Puckette; +#X text 12 185 HELP_PATCH_AUTHORS Updated for Pd version 0.37. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 5 KEYWORDS signal conversion; +#X text 12 45 DESCRIPTION convert a signal to a number on demand; +#X text 12 85 OUTLET_0 float; +#X text 12 65 INLET_0 bang signal set; +#X text 12 165 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 500 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 542 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 569 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#X text 98 546 (none); +#N canvas 218 518 428 109 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 [snapshot~] Related Objects; +#X obj 22 43 sig~; +#X obj 63 43 vsnapshot~; +#X restore 102 597 pd Related_objects; +#X obj 78 426 cnv 17 3 65 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 508 float; +#X obj 78 509 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 484 11 snapshot~; +#X obj 91 307 snapshot~; +#X floatatom 91 330 0 0 0 0 - - -; +#X msg 102 255 bang; +#X obj 91 230 osc~ 0.1; +#X text 90 209 0.1 Hz cosine; +#X msg 107 279 set 5; +#X text 98 425 signal; +#X text 11 23 convert a signal to a number on demand; +#X text 98 445 bang; +#X text 98 465 set; +#X text 168 465 - the "set" message \, followed by a value \, sets +[snapshot~] to the specified value (which is reset the next DSP block). ; -#X text 154 14 - convert a signal to a number on demand; -#X text 9 46 The snapshot~ object takes a signal and converts it to -a control value whenever it receives a bang in its left outlet. This -object is particularly useful for monitoring outputs.; -#X msg 565 43 \; pd dsp 1; -#X obj 565 20 loadbang; -#X obj 19 239 osc~ 0.1; -#X text 24 221 0.1 Hz cosine; -#X text 397 373 updated for Pd version 0.37; -#X msg 35 288 set 5; -#X text 102 239 signal in to take snapshots of; -#X text 73 263 bang -- take one snapshot; -#X text 89 288 set -- set value (which is reset next DSP block.); -#X msg 565 85 \; pd dsp 0; -#X text 11 109 In the example below \, a snapshot~ object prints out -the values of a low frequency cosine wave every time it is sent a bang -message.; -#X text 12 161 A 'set' message is provided for the (rare) situations +#X text 168 508 - upon receiving a bang to its inlet \, [snapshot~] +outputs a value.; +#X text 143 255 <- Click to take a "snapshot" of the signal; +#X text 168 425 - the incoming signal.; +#X text 168 445 - a bang takes one snapshot of the incoming signal. +; +#X text 18 109 In the example below \, a [snapshot~] object prints +out the values of a low frequency cosine wave every time it is sent +a bang message.; +#X text 18 152 A "set" message is provided for the (rare) situations where you might make a known change to the signal input \, and then read snapshot's value before any ensuing signal computation.; -#X connect 0 0 1 0; -#X connect 0 0 1 0; -#X connect 3 0 0 0; -#X connect 8 0 7 0; -#X connect 9 0 0 0; -#X connect 12 0 0 0; +#X text 18 57 The [snapshot~] object takes a signal and converts it +to a control value whenever it receives a bang in its left outlet. +This object is particularly useful for monitoring outputs.; +#X text 156 329 This output updates each time bang is clicked above. +; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 481 54 pddp/dsp; +#X obj 99 572 pddp/pddplink ../3.audio.examples/C06.signal.to.control.pd +-text doc/3.audio.examples/C06.signal.to.control.pd; +#X connect 13 0 14 0; +#X connect 15 0 13 0; +#X connect 16 0 13 0; +#X connect 18 0 13 0; diff --git a/pd/doc/5.reference/soundfiler-help.pd b/pd/doc/5.reference/soundfiler-help.pd index c006b521d..3fa80f90a 100644 --- a/pd/doc/5.reference/soundfiler-help.pd +++ b/pd/doc/5.reference/soundfiler-help.pd @@ -1,67 +1,122 @@ -#N canvas 59 252 1102 576 12; +#N canvas 429 34 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 soundfiler 3 12 +0 18 -204280 -1 0; +#X obj 0 387 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 490 283 494 344 META 0; +#X text 12 105 LIBRARY internal; +#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 125 AUTHOR Miller Puckette; +#X text 12 185 HELP_PATCH_AUTHORS Updated for Pd version 0.37. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 45 DESCRIPTION read and write soundfiles to arrays; +#X text 12 65 INLET_0 read write; +#X text 12 85 OUTLET_0 float; +#X text 12 5 KEYWORDS control array filesystem; +#X text 12 165 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 487 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 529 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 554 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#X text 98 533 (none); +#N canvas 217 519 428 106 Related_objects 0; +#X obj 0 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 7 2 [soundfiler] Related Objects; +#X obj 22 43 tabwrite~; +#X obj 22 69 tabread4~; +#X obj 88 43 tabplay~; +#X obj 143 69 writesf~; +#X obj 87 69 readsf~; +#X restore 102 597 pd Related_objects; +#X obj 78 396 cnv 17 3 80 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 495 float; +#X obj 78 496 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 477 10 soundfiler; +#X text 11 23 read and write soundfiles to arrays; +#X text 98 395 read; +#X text 98 412 write; +#X text 168 495 - the output specifies the total number of samples +that have been read or written.; +#X obj 20 293 soundfiler; +#X floatatom 20 317 0 0 0 0 - - -; +#X text 231 137 read a file; +#X text 287 159 ...optionally resize; +#X text 322 224 write a file; +#X text 358 268 write stereo; #N canvas 0 0 450 300 (subpatch) 0; -#X array array1 77971 float 0; -#X coords 0 1 77971 -1 300 100 1; -#X restore 71 353 graph; +#X array sf-array1 77971 float 0; +#X coords 0 1 77971 -1 130 70 1; +#X restore 135 306 graph; #N canvas 0 0 450 300 (subpatch) 0; -#X array array2 77971 float 0; -#X coords 0 1 77971 -1 300 100 1; -#X restore 71 459 graph; -#X obj 11 313 soundfiler; -#X msg 17 241 write -aiff /tmp/foo1 array2; -#X msg 8 152 read ../sound/bell.aiff array2; -#X msg 17 199 read -raw 128 2 2 b ../sound/bell.aiff array1 array2 -; -#X text 26 10 SOUNDFILER - read and write soundfiles to arrays; -#X text 548 3 When reading you can leave soundfiler to figure out which +#X array sf-array2 77971 float 0; +#X coords 0 1 77971 -1 130 70 1; +#X restore 288 306 graph; +#N canvas 110 93 428 434 flags 0; +#X obj 0 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 19 37 When reading you can leave soundfiler to figure out which of the three known soundfile formats the file belongs to or override all header information using the "-raw" flag.; -#X text 665 52 Flags for reading:; -#X text 574 68 -skip <sample frames to skip in file>; -#X floatatom 11 337 0 0 0 0 - - -; -#X msg 15 175 read -resize ../sound/bell.aiff array2; -#X msg 17 288 write -nextstep -bytes 4 /tmp/foo3 array1 array2; -#X msg 16 265 write -wave -nframes 10000 /tmp/foo2 array2; -#X text 287 150 read a file; -#X text 362 173 ...optionally resize; -#X text 225 217 ...or even overriding everything; -#X text 283 240 write a file; -#X text 352 309 write stereo; -#X text 9 31 The soundfiler object reads and writes floating point -arrays to binary soundfiles which may contain 2 or 3 byte fixed point -or 4 byte floating point samples in wave \, aiff \, or next formats -(no floating point aiff \, though.). The number of channels of the -soundfile need not match the number of arrays given (extras are dropped -and unsupplied channels are zeroed out.); -#X text 575 123 -raw <headersize> <channels> <bytespersample> <endianness> +#X text 136 79 Flags for reading:; +#X text 45 99 -skip <sample frames to skip in file>; +#X text 45 159 -raw <headersize> <channels> <bytespersample> <endianness> ; -#X text 594 141 This causes all header information to be ignored. Endianness +#X text 64 177 This causes all header information to be ignored. Endianness is "l" ("little") for Intel machines or "b" ("big") for Macintoshes and SGIs. You can give "n" (natural) to take the byte order your machine prefers.; -#X text 575 86 -resize; -#X text 575 104 -maxsize <maximum number of samples we can resize to> +#X text 45 119 -resize; +#X text 45 139 -maxsize <maximum number of samples we can resize to> +; +#X text 19 230 Flags for writing:; +#X text 37 251 -wave \, -nextstep \, -aiff; +#X text 37 271 -big \, -little (nextstep only!); +#X text 37 291 -skip <number of sample frames to skip in array>; +#X text 37 311 -nframes <maximum number to write>; +#X text 37 351 -normalize; +#X text 37 331 -bytes <2 \, 3 \, or 4>; +#X text 17 400 The number of channels is limited to 64; +#X text 37 371 -rate <sample rate>; +#X text 7 1 [soundfiler] Flags; +#X restore 172 459 pd flags; +#X text 168 412 - write a soundfile.; +#X text 169 428 The "read" and "write" messages accept flags. See the +subpatch below for details:; +#X msg 20 138 read ../sound/bell.aiff sf-array2; +#X msg 20 161 read -resize ../sound/bell.aiff sf-array2; +#X msg 20 185 read -raw 128 2 2 b ../sound/bell.aiff sf-array1 sf-array2 +; +#X msg 20 214 write -aiff /tmp/foo1 sf-array2; +#X msg 20 238 write -wave -nframes 10000 /tmp/foo2 sf-array2; +#X msg 20 268 write -nextstep -bytes 4 /tmp/foo3 sf-array1 sf-array2 +; +#X text 399 197 overriding everything; +#X text 398 183 ...or even; +#X text 168 395 - read a soundfile.; +#X text 17 41 The [soundfiler] object reads and writes floating point +arrays to binary soundfiles which may contain 2 or 3 byte fixed point +or 4 byte floating point samples in wave \, aiff \, or next formats +(no floating point aiff \, though.). The number of channels of the +soundfile need not match the number of arrays given (extras are dropped +and unsupplied channels are zeroed out).; +#X text 98 558 Note: The number of channels is limited to 64 .; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide ; -#X text 560 206 Flags for writing:; -#X text 578 227 -wave \, -nextstep \, -aiff; -#X text 579 246 -big \, -little (nextstep only!); -#X text 578 268 -skip <number of sample frames to skip in array>; -#X text 579 290 -nframes <maximum number to write>; -#X text 580 334 -normalize; -#X text 579 312 -bytes <2 \, 3 \, or 4>; -#X text 557 378 The number of channels is limited to 64; -#X text 612 413 see also:; -#X obj 606 436 tabwrite~; -#X obj 607 460 tabread4~; -#X obj 713 415 tabplay~; -#X obj 711 464 writesf~; -#X obj 712 441 readsf~; -#X text 579 354 -rate <sample rate>; -#X text 751 539 updated for Pd version 0.37; -#X connect 2 0 10 0; -#X connect 3 0 2 0; -#X connect 4 0 2 0; -#X connect 5 0 2 0; -#X connect 11 0 2 0; -#X connect 12 0 2 0; -#X connect 13 0 2 0; +#X obj 98 575 pddp/pddplink all_about_arrays.pd; +#X connect 17 0 18 0; +#X connect 28 0 17 0; +#X connect 29 0 17 0; +#X connect 30 0 17 0; +#X connect 31 0 17 0; +#X connect 32 0 17 0; +#X connect 33 0 17 0; diff --git a/pd/doc/5.reference/spigot-help.pd b/pd/doc/5.reference/spigot-help.pd index 10ff15697..a0144ec61 100644 --- a/pd/doc/5.reference/spigot-help.pd +++ b/pd/doc/5.reference/spigot-help.pd @@ -1,25 +1,187 @@ -#N canvas 59 19 612 342 12; -#X obj 35 11 spigot; -#X text 100 12 - pass or block messages; -#X text 35 63 Spigot passes messages from its left inlet to its outlet -\, as long as a nonzero number is sent to its right inlet. When its -right inlet gets zero \, incoming messages are "blocked \, " i.e. \, -ignored.; -#X msg 25 157 0.5 1000; -#X obj 25 300 print; -#X msg 38 210 walk the cat; -#X msg 31 182 bang; -#X text 128 240 control: nonzero to pass messages \, zero to stop them +#N canvas 432 36 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 spigot 3 12 0 18 +-204280 -1 0; +#X obj 0 295 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 486 265 494 364 META 0; +#X text 12 125 LIBRARY internal; +#X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 145 AUTHOR Miller Puckette; +#X text 12 205 HELP_PATCH_AUTHORS This help patch was updated for Pd +version 0.38-4. It was edited by Dave Sabine and Hans-Christoph Steiner +as part of a project called pddp proposed by Krzysztof Czaja to build +comprehensive documentation for Pd. Revised by Jonathan Wilkes to conform +to the PDDP template for Pd version 0.42.; +#X text 12 5 KEYWORDS control; +#X text 12 45 DESCRIPTION pass or block messages; +#X text 12 65 INLET_0 anything; +#X text 12 85 INLET_1 float; +#X text 12 105 OUTLET_0 anything; +#X text 12 185 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 389 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 443 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 538 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 217 400 428 230 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 [spigot] Related Objects; +#X text 20 38 Externals; +#X text 19 85 These objects are offered in Pd only if you have downloaded +and properly installed the appropriate library. These objects may or +may not exist in a single library.; +#X text 19 126 The best places to find information about Pd's libraries +is:; +#X text 19 146 www.puredata.org and click on "Downloads" then "Software" +; +#X text 19 161 or; +#X text 19 176 iem.kug.ac.at/pdb/; +#X obj 21 58 pddp/helplink cyclone/gate; +#X restore 102 598 pd Related_objects; +#X obj 78 304 cnv 17 3 35 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 398 cnv 17 3 30 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 345 cnv 17 3 35 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X text 98 344 float; +#X obj 498 10 spigot; +#X text 11 23 pass or block messages; +#X msg 101 111 0.5 1000; +#X floatatom 134 177 1 0 0 0 - - -, f 1; +#X obj 101 197 spigot; +#X obj 101 218 print; +#X msg 120 155 walk the cat; +#X msg 111 133 bang; +#X text 147 177 control: nonzero to pass messages \, zero to stop them ; -#X obj 25 267 spigot 0; -#X text 349 310 updated for Pd version 0.38; -#X obj 92 244 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0 1 +#X text 18 52 [spigot] passes messages from its left inlet to its outlet +\, as long as a nonzero number is sent to its right inlet. When its +right inlet gets zero \, incoming messages are "blocked" (i.e. ignored). ; -#X text 450 267; -#X text 125 267 optional arg sets the initial state (0 by default) +#X text 18 242 [spigot] works essentially like a doorway. When the +door is open \, messages can pass through. When the door is closed +\, messages are ignored. By default \, the door is always closed!; +#N canvas 96 273 428 291 using_spigot_to_create_a_gate 0; +#X text 20 38 Unlike its closest cousin MAX \, Pd does not have a native +[gate] object. There are other Pd libraries which include gates for +both audio and numerical data \, but similar routines can be built +in Pd using [spigot]. The example below shows a two-way gate using +two [spigots] and the [expr] object.; +#X floatatom 121 188 1 0 0 0 - - -, f 1; +#X text 138 187 controls: open and close the gates.; +#X floatatom 24 262 5 0 0 0 - - -, f 5; +#X floatatom 76 262 5 0 0 0 - - -, f 5; +#X obj 24 129 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0 1 ; +#X obj 24 149 metro 200; +#X obj 24 171 f; +#X obj 51 171 + 1; +#X text 44 127 Click to start sending info through the gates.; +#X obj 24 240 spigot; +#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 [spigot] Using [spigot] to Create a Gate; +#X obj 76 240 spigot 1; +#X obj 121 218 == 0; +#X connect 1 0 10 1; +#X connect 1 0 14 0; +#X connect 5 0 6 0; +#X connect 6 0 7 0; +#X connect 7 0 8 0; +#X connect 7 0 10 0; +#X connect 7 0 13 0; +#X connect 8 0 7 1; +#X connect 10 0 3 0; +#X connect 13 0 4 0; +#X connect 14 0 13 1; +#X restore 102 568 pd using_spigot_to_create_a_gate; +#N canvas 61 206 428 334 spigot_for_audio_signals 0; +#X text 20 38 [spigot] does not work with audio signals. The data types +which are accepted by this object are floats \, symbols \, lists \, +bangs \, anythings and pointers. However \, audio signals require a +completely different treatment.; +#X text 21 100 Pd does not have a [spigot] for audio signals \, but +the same effect can be created using the following structure:; +#X obj 24 147 osc~ 800; +#X obj 24 217 *~; +#X floatatom 39 196 1 0 0 0 - - -, f 1; +#X obj 24 279 env~; +#X floatatom 24 300 5 0 0 0 - - -, f 5; +#X obj 69 299 dac~; +#X obj 69 279 *~ 0.05; +#X text 79 168 Here is the [spigot].; +#X text 80 183 When "0" \, audio signal; +#X text 79 198 is effectively blocked.; +#X text 80 213 When "1" \, audio signal is; +#X text 80 228 not effected in any way.; +#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 [spigot] Is There a [spigot] for Audio Signals?; +#X obj 287 145 pddp/dsp; +#X connect 2 0 3 0; +#X connect 3 0 5 0; #X connect 3 0 8 0; -#X connect 5 0 8 0; -#X connect 6 0 8 0; -#X connect 8 0 4 0; -#X connect 10 0 8 1; +#X connect 4 0 3 1; +#X connect 5 0 6 0; +#X connect 8 0 7 0; +#X restore 102 547 pd spigot_for_audio_signals; +#X text 98 303 anything; +#X text 167 344 - "0" blocks all incoming messages to the left inlet. +"1" (or any nonzero number) passes the incoming message to the outlet. +; +#X text 98 397 anything; +#X text 168 397 - if the last value received at the right inlet was +nonzero \, [spigot] passes the message from the first inlet to its +outlet.; +#X text 168 457 - By default \, the left inlet of [spigot] is initially +closed. A one (or any nonzero number) as a creation argument will cause +the spigot to be open initially. See the subpatch below for an example: +; +#X text 168 303 - [spigot] takes the input to the left inlet and either +ignores it or passes it through to the outlet \, depending on the value +at the right inlet.; +#N canvas 74 291 428 213 creation_args 0; +#X obj 146 108 spigot 0; +#X text 21 38 [spigot] only accepts one numerical creation argument: +a one or a zero. At creation time the [spigot] is "closed". With a +one \, its defaults to open.; +#X obj 214 108 spigot 1; +#X obj 146 81 bng 15 250 50 0 empty empty empty 0 -6 0 8 -225271 -1 +-1; +#X obj 90 108 spigot; +#X obj 90 135 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 146 135 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 214 135 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#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 [spigot] Creation Arguments; +#X text 20 158 [spigot] used to accept any symbol as a creation argument +\, but all of these are meaningless and have no effect on the operation +of the object. This was removed in Pd 0.38-3; +#X connect 0 0 6 0; +#X connect 2 0 7 0; +#X connect 3 0 0 0; +#X connect 3 0 4 0; +#X connect 3 0 2 0; +#X connect 4 0 5 0; +#X restore 171 510 pd creation_args; +#X text 90 457 1) float; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 296 548 pddp/pddplink ../2.control.examples/18.conditional.pd +-text doc/2.control.examples/18.conditional.pd; +#X connect 14 0 16 0; +#X connect 15 0 16 1; +#X connect 16 0 17 0; +#X connect 18 0 16 0; +#X connect 19 0 16 0; diff --git a/doc/pddp/sqrt-help.pd b/pd/doc/5.reference/sqrt-help.pd similarity index 100% rename from doc/pddp/sqrt-help.pd rename to pd/doc/5.reference/sqrt-help.pd diff --git a/pd/doc/5.reference/sqrt~-help.pd b/pd/doc/5.reference/sqrt~-help.pd index b7b8e1a45..2261ee2ac 100644 --- a/pd/doc/5.reference/sqrt~-help.pd +++ b/pd/doc/5.reference/sqrt~-help.pd @@ -1,32 +1,77 @@ -#N canvas 182 132 778 399 12; -#X obj 71 201 metro 500; -#X obj 71 176 r metro; -#X msg 575 106 \; metro 0; -#X msg 574 48 \; pd dsp 1 \; metro 1; -#X floatatom 55 102 0 0 0; -#X floatatom 55 258 0 0 0; -#X text 470 371 updated for Pd version 0.33; -#X obj 574 21 loadbang; -#X obj 36 16 sqrt~; -#X text 88 18 - signal square root; -#X obj 55 152 sqrt~; -#X obj 55 225 snapshot~; -#X floatatom 54 341 9 0 0; -#X obj 54 285 t f f; -#X obj 54 312 *; -#X obj 55 128 sig~; -#X text 18 45 sqrt~ takes the approximate square root of the incoming +#N canvas 433 34 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 sqrt~ 3 12 0 18 +-204280 -1 0; +#X obj 0 437 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 492 283 494 344 META 0; +#X text 12 105 LIBRARY internal; +#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 125 AUTHOR Miller Puckette; +#X text 12 185 HELP_PATCH_AUTHORS Updated for Pd version 0.33. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 5 KEYWORDS signal; +#X text 12 45 DESCRIPTION signal square root; +#X text 12 85 OUTLET_0 signal; +#X text 12 65 INLET_0 signal; +#X text 12 165 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 502 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 539 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 567 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#X text 98 543 (none); +#N canvas 220 517 428 109 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 obj 152 43 rsqrt~; +#X obj 203 43 sqrt; +#X obj 22 43 q8_sqrt~; +#X obj 82 43 q8_rsqrt~; +#X text 8 2 [sqrt~] Related Objects; +#X restore 102 597 pd Related_objects; +#X obj 78 446 cnv 17 3 45 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 511 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 511 7 sqrt~; +#X obj 232 240 metro 500; +#X floatatom 215 137 0 0 0 0 - - -; +#X floatatom 216 297 0 0 0 0 - - -; +#X obj 216 264 snapshot~; +#X floatatom 216 380 9 0 0 0 - - -, f 9; +#X obj 216 324 t f f; +#X obj 216 351 *; +#X obj 215 163 sig~; +#X text 98 445 signal; +#X obj 232 215 loadbang; +#X text 98 465 float; +#X obj 216 191 sqrt~; +#X text 168 465 - a float may be sent to the inlet as long as no signal +connections are made to [sqrt~].; +#X text 98 510 signal; +#X text 168 510 - the square root of the incoming signal is output. +; +#X text 11 23 signal square root; +#X text 168 445 - an incoming signal.; +#X text 20 72 [sqrt~] takes the approximate square root of the incoming signal \, using a fast \, approximate algorithm which is probably accurate to about 120 dB (20 bits).; -#X connect 0 0 11 0; -#X connect 1 0 0 0; -#X connect 1 0 0 0; -#X connect 4 0 15 0; -#X connect 5 0 13 0; -#X connect 7 0 3 0; -#X connect 10 0 11 0; -#X connect 11 0 5 0; -#X connect 13 0 14 0; -#X connect 13 1 14 1; -#X connect 14 0 12 0; -#X connect 15 0 10 0; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 481 55 pddp/dsp; +#X connect 12 0 15 0; +#X connect 13 0 19 0; +#X connect 14 0 17 0; +#X connect 15 0 14 0; +#X connect 17 0 18 0; +#X connect 17 1 18 1; +#X connect 18 0 16 0; +#X connect 19 0 23 0; +#X connect 21 0 12 0; +#X connect 23 0 15 0; diff --git a/doc/pddp/standard_gui_elements.pd b/pd/doc/5.reference/standard_gui_elements.pd similarity index 100% rename from doc/pddp/standard_gui_elements.pd rename to pd/doc/5.reference/standard_gui_elements.pd diff --git a/pd/doc/5.reference/stripnote-help.pd b/pd/doc/5.reference/stripnote-help.pd index 80a8cecbd..af9247c6f 100644 --- a/pd/doc/5.reference/stripnote-help.pd +++ b/pd/doc/5.reference/stripnote-help.pd @@ -1,16 +1,109 @@ -#N canvas 53 36 458 251 10; -#X msg 39 100 23 0; -#X obj 39 175 print x1; -#X obj 96 175 print x2; -#X obj 39 139 stripnote; -#X msg 79 100 34.5 67.8; -#X obj 65 214 makenote; -#X text 83 12 - send note-on messages and schedule note-off for later; -#X text 283 220 updated for Pd version 0.28; -#X text 10 214 see also; -#X obj 23 10 stripnote; -#X text 17 44 Stripnote takes note-off (zero-velocity) messages out of a stream of MIDI-style note message and passes the others through unchanged.; -#X connect 0 0 3 0; -#X connect 3 0 1 0; -#X connect 3 1 2 0; -#X connect 4 0 3 0; +#N canvas 432 34 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 stripnote 3 12 0 +18 -204280 -1 0; +#X obj 0 358 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 487 261 494 366 META 0; +#X text 12 155 LIBRARY internal; +#X text 12 195 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 215 RELEASE_DATE 2009-06-12; +#X text 12 25 LICENSE SIBSD; +#X text 12 175 AUTHOR Miller Puckette; +#X text 12 235 HELP_PATCH_AUTHORS Updated for Pd version 0.28. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 5 KEYWORDS control MIDI; +#X text 12 45 DESCRIPTION send note-on messages and schedule note-off +for later; +#X text 12 75 INLET_0 float list; +#X text 12 115 OUTLET_0 float; +#X text 12 95 INLET_1 float; +#X text 12 135 OUTLET_1 float; +#X restore 500 597 pd META; +#X obj 0 467 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 540 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 567 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#X text 98 544 (none); +#N canvas 220 191 428 433 Related_objects 0; +#X obj 1 2 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 8 3 [stripnote] Related Objects; +#X obj 74 81 ctlin; +#X obj 217 81 pgmin; +#X obj 24 81 bendin; +#X obj 79 108 touchin; +#X obj 261 81 polytouchin; +#X obj 118 81 midiin; +#X obj 23 108 sysexin; +#X obj 179 168 noteout; +#X obj 76 168 ctlout; +#X obj 24 168 bendout; +#X obj 366 168 touchout; +#X obj 280 168 polytouchout; +#X obj 123 168 midiout; +#X obj 231 168 pgmout; +#X obj 24 222 makenote; +#X text 21 199 MIDI note construction:; +#X text 21 141 MIDI output:; +#X text 21 58 MIDI input:; +#X obj 184 222 stripnote; +#X obj 168 81 notein; +#X text 181 199 MIDI note deconstruction:; +#X obj 24 34 makenote; +#X text 22 275 Additional useful objects for MIDI processing (Maxlib +by Olaf Matthes); +#X text 21 354 Also \, from cyclone (alpha) by Krzysztof Czaja:; +#X text 22 256 Externals; +#X obj 22 305 pddp/helplink maxlib/pitch; +#X obj 22 320 pddp/helplink maxlib/score; +#X obj 22 335 pddp/helplink maxlib/chord; +#X obj 22 370 pddp/helplink cyclone/midiformat; +#X obj 22 385 pddp/helplink cyclone/midiparse; +#X obj 22 400 pddp/helplink cyclone/midiflush; +#X restore 102 597 pd Related_objects; +#X obj 78 367 cnv 17 3 65 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 366 float; +#X text 98 406 list; +#X text 98 476 float; +#X obj 78 477 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 439 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X text 98 438 float; +#X obj 480 10 stripnote; +#X text 130 227 Stripnote takes note-off (zero-velocity) messages out +of a stream of MIDI-style note message and passes the others through +unchanged.; +#X msg 134 127 23 0; +#X obj 134 202 print x1; +#X obj 191 202 print x2; +#X obj 134 166 stripnote; +#X text 168 366 - MIDI pitch value. The value will pass unchanged to +the left outlet if the current value of the right inlet is non-zero. +; +#X msg 174 127 34.5 67.8; +#X text 167 438 - a float to the right inlet is stored for later use. +; +#X text 168 476 - the MIDI pitch value received at the left inlet will +pass unchanged if the value of the right inlet is non-zero.; +#X text 98 506 float; +#X obj 78 507 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X text 168 506 - the velocity will pass unchanged if the value of +the right inlet is non-zero.; +#X text 11 23 send note-on messages and schedule note-off for later +; +#X text 168 406 - a (pitch \, velocity) pair is distributed to the +two inlets. Lists with more than two elements will be truncated.; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X connect 18 0 21 0; +#X connect 21 0 19 0; +#X connect 21 1 20 0; +#X connect 23 0 21 0; diff --git a/pd/doc/5.reference/struct-help.pd b/pd/doc/5.reference/struct-help.pd index a18fa6e99..0cc32134e 100644 --- a/pd/doc/5.reference/struct-help.pd +++ b/pd/doc/5.reference/struct-help.pd @@ -1,26 +1,161 @@ -#N canvas 343 45 557 321 12; -#X text 88 11 -- declare the fields in a data structure.; -#N canvas 345 476 638 171 help-template1 0; -#X obj 60 21 struct struct-1 float x float y symbol dog array weasel +#N struct struct-1 float x float y symbol dog array weasel struct-2 +; +#N struct struct-2 float y; +#N canvas 430 33 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 struct 3 12 0 18 +-204280 -1 0; +#X obj 0 189 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 484 285 494 344 META 0; +#X text 12 85 LIBRARY internal; +#X text 12 125 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 105 AUTHOR Miller Puckette; +#X text 12 165 HELP_PATCH_AUTHORS Updated for Pd version 0.35. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 5 KEYWORDS control data_structure; +#X text 12 45 DESCRIPTION declare the fields in a data structure; +#X text 12 65 OUTLET_0 click change select deselect displace; +#X text 12 145 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 214 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 375 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 532 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 217 517 428 109 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 [struct] Related Objects; +#X obj 22 43 filledpolygon; +#X obj 112 43 drawpolygon; +#X obj 193 43 plot; +#X obj 232 43 set; +#X obj 262 43 get; +#X obj 293 43 element; +#X obj 22 73 getsize; +#X obj 82 73 setsize; +#X obj 142 73 pointer; +#X obj 202 73 append; +#X obj 254 73 sublist; +#X restore 102 597 pd Related_objects; +#X obj 78 296 cnv 17 3 72 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 500 10 struct; +#X text 11 23 declare the fields in a data structure; +#X text 98 193 (none); +#X text 98 295 click; +#X text 98 325 select; +#X text 98 310 change; +#X text 98 355 displace; +#X text 98 340 deselect; +#X text 149 461 float; +#X text 149 476 symbol; +#X text 149 491 array; +#N canvas 98 230 428 349 help-template1 0; +#X obj 23 43 struct struct-1 float x float y symbol dog array weasel struct-2; -#X text 40 76 In this example \, the "struct-1" structure is defined +#X text 20 182 This just displays a red square to visualize the data +structure.; +#X obj 23 159 filledpolygon 900 0 1 0 0 40 0 40 40 0 40; +#X obj 23 226 plot weasel 0 1 0 0 10; +#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 [struct] Data Stucture Template; +#X text 21 247 Here we plot the array "weasel" \, which gets displayed +on top of the red square; +#X obj 23 78 print; +#X text 20 99 In this example \, the "struct-1" structure is defined in which "x" and "y" are "floats" \, i.e. \, numbers \, but "dog" is -a symbol and "weasel" is an array of objects of structure "struct-2". +a symbol and "weasel" is an array of objects of the data structure +"struct-2".; +#X text 21 286 To learn about z-ordering with data structures \, open +the abstraction below:; +#X obj 21 319 pddp/pddplink ./all_about_z_order.pd -text all_about_z_order.pd +; +#X connect 0 0 7 0; +#X restore 101 96 pd help-template1; +#N canvas 99 252 428 125 help-template2 0; +#X obj 23 43 struct struct-2 float y; +#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 [struct] Data Structure Template; +#X text 21 67 Here is a data structure which specifies only the floating +point "y". It's used for the elements of the array shown in the other +template.; +#X restore 101 118 pd help-template2; +#N canvas 83 305 428 348 struct-help-data 0; +#X scalar struct-1 95 43 symbol \; 17 \; 38 \; 2 \; 39 \; 14 \; \; +; +#X scalar struct-1 164 43 symbol \; 17 \; 1 \; 40 \; 2 \; 14 \; \; +; +#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 [struct] Related Objects; +#X scalar struct-1 239 43 symbol \; 17 \; 38 \; 2 \; 39 \; 14 \; \; +; +#X text 19 279 You can also right-click on each square and choose "Properties" +in both runmode and editmode to see the values associated with each +scalar.; +#X text 20 178 In editmode \, you can click on the squares to move +them. Like other objects in Pd \, you can select multiple scalars and +move them together (notice the blue bounding box when you select them). +A [print] object is connected to the outlet of the corresponding [struct] +for these boxes \, so when you move them with the mouse messages will +print to the console.; +#X text 20 103 The three squares above are scalars that are defined +by the template "help-template1". The zigzag lines are arrays \, the +elements of which are defined by the template "help-template2". In +runmode you can click and drag each element to change its value.; +#X restore 101 168 pd struct-help-data; +#X text 98 138 To view instances of these data structures \, click +the patch below:; +#X text 98 41 The [struct] object is typically put one to a subpatch +\, and may be accompanied by drawing instructions that define how the +data will be visualized. Two data structures- "struct-1" and "struct-2"- +are defined below in subpatches:; +#X text 169 393 - the name of the struct; +#N canvas 72 401 429 220 struct_names 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 [struct] Struct Names; +#X text 20 39 You can't use "float" or "_float_array" as struct names +because Pd has hidden data structures named "float" and "_float_array" +\, which are used for [table] and "Put menu arrays".; +#X msg 23 134 \; pd-_float vis 1 \; pd-_float_array vis 1; +#X text 20 99 You can click below to reveal the canvases that contain +them:; +#X restore 102 541 pd struct_names; +#X text 188 461 - "float foo"; +#X text 188 476 - "symbol foo"; +#X text 188 491 - "array foo bar" \, where "bar" is the name of another +data structure to be used as a template for elements of the array. ; -#X restore 324 156 pd help-template1; -#N canvas 10 274 588 157 help-template2 0; -#X text 28 95 Here is one which specifies only the floating point "y" -\; it's used for the elements of the array shown in the other template. +#X text 169 411 - all subsequent arguments are used to declare fields. +Fields may be one of three types-- float \, symbol \, or array. To +create the field "foo" \, use the syntax below for each type:; +#X text 81 393 1) symbol atom; +#X text 81 411 n) symbol atom; +#X obj 99 560 pddp/pddplink scalar-help.pd; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide ; -#X obj 60 21 struct struct-2 float y; -#X restore 324 183 pd help-template2; -#X obj 36 215 drawpolygon; -#X text 36 195 see also:; -#X obj 141 215 drawnumber; -#X obj 236 216 plot; -#X text 281 290 updated for Pd version 0.35; -#X obj 21 10 struct; -#X text 16 49 There should be one "struct" object in each Pd window -you are using as a data structure template. The arguments specify the -types and names of the fields \; and for array fields \, a third argument -specifies the template that the array elements should belong to.; +#X obj 98 576 pddp/pddplink all_about_arrays.pd; +#X obj 257 561 pddp/pddplink ../4.data.structures/06.file.pd -text +doc/4.data.structures/06.file.pd; +#X obj 257 576 pddp/pddplink ../4.data.structures/08.selection.pd -text +doc/4.data.structures/08.selection.pd; +#X text 99 217 When a scalar is moved or edited with the mouse \, data +is sent to the outlet of the respective [struct] object. This data +consists of: a selector that describes the mouse action that was performed +\, a pointer to the scalar \, and-- optionally-- a number (usually +a y-coordinate). The selectors below correspond to the following mouse +actions:; +#X text 172 295 - (run mode) clicking the object with the mouse.; +#X text 172 310 - (run mode) changing the value of a field.; +#X text 172 325 - (edit mode) selecting the object.; +#X text 172 340 - (edit mode) deselecting an object.; +#X text 172 355 - (edit mode) moving a selected object.; diff --git a/pd/doc/5.reference/sublist-help.pd b/pd/doc/5.reference/sublist-help.pd index a3067d5a0..03852e96b 100644 --- a/pd/doc/5.reference/sublist-help.pd +++ b/pd/doc/5.reference/sublist-help.pd @@ -1,10 +1,61 @@ -#N canvas 252 0 559 226 12; -#X text 311 181 updated for Pd version 0.32; -#X obj 21 10 sublist; -#X text 86 10 -- get a list from a field of a scalar; -#X text 31 37 Don't try this yet -- it's untested.; -#X text 36 89 "sublist" will take as creation arguments a template +#N canvas 429 33 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 sublist 3 12 0 18 +-204280 -1 0; +#X obj 0 439 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 488 280 494 344 META 0; +#X text 12 105 LIBRARY internal; +#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 125 AUTHOR Miller Puckette; +#X text 12 185 HELP_PATCH_AUTHORS Updated for Pd version 0.32. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 5 KEYWORDS control data_structure; +#X text 12 45 DESCRIPTION get a list from a field of a scalar; +#X text 12 65 INLET_0 pointer; +#X text 12 85 OUTLET_0 pointer; +#X text 12 165 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 476 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 512 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 569 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 216 513 428 109 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 [sublist] Related Objects; +#X obj 14 38 get; +#X obj 46 38 set; +#X obj 136 38 getsize; +#X obj 193 38 setsize; +#X obj 121 63 element; +#X obj 13 64 sublist; +#X obj 79 38 pointer; +#X obj 69 63 struct; +#X restore 102 597 pd Related_objects; +#X obj 78 448 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 485 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 492 11 sublist; +#X text 96 170 Don't try this yet -- it's untested.; +#X text 103 208 "sublist" will take as creation arguments a template name and a field name \; its one input takes a pointer. If you send a pointer (which should agree with the template name) \, "sublist" will output the field (which should be of type "list".) The output is in fact a pointer to the head of the sublist.; +#X text 98 447 pointer; +#X text 98 484 pointer; +#X text 11 23 get a list from a field of a scalar; +#X text 168 530 - template name.; +#X text 168 545 - field name.; +#X text 80 530 1) symbol; +#X text 80 545 2) symbol; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 98 573 pddp/pddplink scalar-help.pd; diff --git a/pd/doc/5.reference/swap-help.pd b/pd/doc/5.reference/swap-help.pd index 039e5659e..9f24411a1 100644 --- a/pd/doc/5.reference/swap-help.pd +++ b/pd/doc/5.reference/swap-help.pd @@ -1,41 +1,232 @@ -#N canvas 475 187 615 593 12; -#X msg 72 167 bang; -#X floatatom 72 292 0 0 0 0 - - -; -#X floatatom 84 200 0 0 0 0 - - -; -#X floatatom 139 237 0 0 0 0 - - -; -#X obj 33 15 swap; -#X text 81 16 - SWAP TWO NUMBERS \, RESPECTING RIGHT-TO-LEFT ORDER +#N canvas 429 36 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 swap 3 12 0 18 -204280 +-1 0; +#X obj 0 220 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 489 275 494 357 META 0; +#X text 12 165 LIBRARY internal; +#X text 12 205 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 45 LICENSE SIBSD; +#X text 12 185 AUTHOR Miller Puckette; +#X text 12 245 HELP_PATCH_AUTHORS Dave Sabine \, November 12 \, 2002 +. Jonathan Wilkes revised the patch to conform to the PDDP template +for Pd version 0.42.; +#X text 12 25 KEYWORDS control float list bang; +#X text 12 65 DESCRIPTION swap two numbers \, respecting right-to-left +order; +#X text 12 85 INLET_0 float list bang; +#X text 12 105 INLET_1 float; +#X text 12 125 OUTLET_0 float; +#X text 12 145 OUTLET_1 float; +#X text 12 225 RELEASE_DATE 1997; +#X text 12 5 ALIAS fswap; +#X restore 500 597 pd META; +#X obj 0 425 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 485 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 537 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 217 495 428 136 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 [swap] Related Objects; +#X text 20 69 Externals and other object libraries; +#X obj 23 34 pack; +#X obj 65 34 unpack; +#X obj 20 89 pddp/helplink cyclone/split; +#X restore 102 597 pd Related_objects; +#X obj 78 229 cnv 17 3 145 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 433 float; +#X obj 78 434 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 380 cnv 17 3 35 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X text 98 379 float; +#X obj 445 10 swap; +#X text 98 278 float; +#X text 168 283 - a float at the left inlet will send the number to +the right outlet and then send the number at the right inlet to the +left outlet.; +#X text 98 229 bang; +#X text 168 229 - a bang at the left inlet will force [swap] to send +its values to the outlets \, in reverse order. The value from the left +inlet will be sent to the right outlet then the value at the right +inlet will be sent out the left outlet.; +#X text 98 324 list; +#X text 168 324 - a list at the left inlet will update the values of +both of [swap]'s inlets and send the numbers to the outlets in reverse +order. Note that lists of 3 or more elements will be truncated.; +#X text 167 379 - a float at the right inlet is stored for later use. +It will be sent to the left outlet when a float or bang is received +in the left inlet.; +#X text 98 456 float; +#X obj 78 457 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X obj 78 152 swap; +#X floatatom 106 79 5 0 0 0 - - -, f 5; +#X floatatom 190 119 5 0 0 0 - - -, f 5; +#X floatatom 118 179 5 0 0 0 - - -, f 5; +#X floatatom 78 179 5 0 0 0 - - -, f 5; +#X msg 149 78 42 7; +#X obj 78 77 bng 15 250 50 0 empty empty empty 0 -6 0 10 -262144 -1 +-1; +#X msg 191 78 42 7 3 4; +#X floatatom 333 143 5 0 0 0 - - -, f 5; +#X floatatom 294 142 5 0 0 0 - - -, f 5; +#X msg 294 88 bang; +#X obj 294 112 swap 12; +#X text 188 102 float; +#X text 103 60 float; +#X text 150 60 list; +#X text 286 162 creation argument; +#N canvas 90 38 428 503 More_Info 0; +#X msg 42 82 42 7; +#X obj 42 107 swap; +#X floatatom 42 133 5 0 0 0 - - -, f 5; +#X floatatom 101 133 5 0 0 0 - - -, f 5; +#X obj 42 157 pack f f; +#X obj 42 181 print; +#X floatatom 43 347 5 0 0 0 - - -, f 5; +#X floatatom 93 347 5 0 0 0 - - -, f 5; +#X floatatom 142 347 5 0 0 0 - - -, f 5; +#X floatatom 111 468 5 0 0 0 - - -, f 5; +#X floatatom 158 468 5 0 0 0 - - -, f 5; +#X floatatom 212 468 5 0 0 0 - - -, f 5; +#X msg 42 271 2 2500 9 420; +#X obj 42 317 unpack f f f f; +#X floatatom 192 347 5 0 0 0 - - -, f 5; +#X text 18 38 [swap] is most commonly used to change the order of a +list. This trick is best suited for a PAIR of numbers.; +#X obj 165 373 swap; +#X obj 138 398 swap; +#X obj 111 422 swap; +#X obj 195 406 swap; +#X obj 168 431 swap; +#X obj 227 436 swap; +#X floatatom 263 468 5 0 0 0 - - -, f 5; +#X text 199 373 This could quickly become ridiculous!; +#X msg 140 271 1 2 3 4; +#X msg 219 271 0 200 3333 1111; +#X text 19 213 Lists that are longer than two elements could be sorted +this way \, but the structure quickly becomes unmanageable. It's probably +better to find an alternative method.; +#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 [swap] More Info; +#X connect 0 0 1 0; +#X connect 1 0 2 0; +#X connect 1 1 3 0; +#X connect 2 0 4 0; +#X connect 3 0 4 1; +#X connect 4 0 5 0; +#X connect 6 0 18 0; +#X connect 7 0 17 0; +#X connect 8 0 16 0; +#X connect 12 0 13 0; +#X connect 13 0 6 0; +#X connect 13 1 7 0; +#X connect 13 2 8 0; +#X connect 13 3 14 0; +#X connect 14 0 16 1; +#X connect 16 0 17 1; +#X connect 16 1 19 1; +#X connect 17 0 18 1; +#X connect 17 1 19 0; +#X connect 18 0 9 0; +#X connect 18 1 20 0; +#X connect 19 0 20 1; +#X connect 19 1 21 1; +#X connect 20 0 10 0; +#X connect 20 1 21 0; +#X connect 21 0 11 0; +#X connect 21 1 22 0; +#X connect 24 0 13 0; +#X connect 25 0 13 0; +#X restore 102 546 pd More_Info; +#N canvas 70 19 444 592 Note-off_parser_using_swap 0; +#X obj 0 346 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 +0 14 -204280 -1 0; +#X obj 21 109 notein; +#X text 77 105 [notein] is an object which receives incoming MIDI data +from a MIDI instrument. The three outlets are PITCH \, VELOCITY \, +and MIDI CHANNEL from left to right. It is important to note however +that the data is outputted from right to left. Which means that the +first piece of information to be sent out the object is the MIDI CHANNEL. ; -#X text 117 166 outputs 2 stored values; -#X obj 72 266 swap 6.5; -#X text 115 200 sets second value and outputs both; -#X text 171 238 sets first value; -#X text 157 266 creation argument initializes first value; -#X floatatom 139 291 0 0 0 0 - - -; -#X obj 139 331 print right; -#X obj 72 367 print left; -#X text 43 427 A common use of swap is to reverse the operands in arithmetic -objects like this:; -#X obj 72 491 swap; -#X obj 72 519 -; -#X floatatom 72 541 5 0 0 0 - - -; -#X floatatom 103 469 3 0 0 0 - - -; -#X floatatom 72 469 3 0 0 0 - - -; -#X text 291 549 updated for Pd version 0.41; -#X text 32 52 The swap object swaps the positions of two incoming numbers. -The number coming in through the right inlet will be sent to the left -outlet and the number coming in left will come out right. Only the -left inlet is hot and triggers output on both outlets. Output order -is right to left as in [trigger].; -#X connect 0 0 7 0; -#X connect 1 0 13 0; -#X connect 2 0 7 0; -#X connect 3 0 7 1; -#X connect 7 0 1 0; -#X connect 7 1 11 0; +#X obj 21 183 swap; +#X obj 21 222 pack; +#X obj 21 266 route 0; +#X floatatom 21 294 5 0 0 0 - - -, f 5; +#X text 76 183 Here \, [swap] is used to store the VELOCITY until the +PITCH information comes from [notein]. The next step will pack the +two together...but we have to ensure that [pack] receives the two numbers +in the correct order: PITCH first \, then VELOCITY. This way \, using +[route] we can determine whether or not this incoming MIDI data is +a "note-off" signal (i.e. VELOCITY = 0).; +#X obj 21 316 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 21 386 notein; +#X obj 22 426 pack; +#X obj 22 451 route 0; +#X floatatom 22 476 5 0 0 0 - - -, f 5; +#X obj 22 497 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X text 45 315 This will "bang" only when velocity = 0; +#X text 18 37 In some settings \, the [swap] object is useful as a +timing mechanism to ensure that two numbers arrive at their destination +in a particular order. Miller Puckette has provided an excellent example +of [swap] used to build a 'note-off parser':; +#X obj 0 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 7 346 Why doesn't the alternative work?; +#X text 77 382 The goal of the Miller's example above is to retrieve +"note-off" signals from [notein]. To do that \, we have to test the +incoming data for pitches with a velocity of zero. So we swap the values +\, pack up the incoming VELOCITY and PITCH data \, and send them to +[route]...in effect we achieve the following:; +#X text 78 463 IF velocity = 0 THEN display the pitch and send a bang +; +#X text 77 485 With the [notein] object \, the VELOCITY information +is sent before the PITCH information. (Remember that in Pd data is +sent to the outlets in right-to-left order.) In the example at left +\, the VELOCITY information triggers the output of [pack] BEFORE the +PITCH information is retrieved. This is why [swap] is used-- it solves +the problem by making sure that the VELOCITY and PITCH are both received +before packing them up and sending them to the [route] object.; +#X text 7 1 [swap] Note-off Parser; +#X connect 1 0 3 0; +#X connect 1 1 3 1; +#X connect 3 0 4 0; +#X connect 3 1 4 1; +#X connect 4 0 5 0; +#X connect 5 0 6 0; +#X connect 6 0 8 0; +#X connect 9 0 10 1; +#X connect 9 1 10 0; +#X connect 10 0 11 0; #X connect 11 0 12 0; -#X connect 15 0 16 0; -#X connect 15 1 16 1; -#X connect 16 0 17 0; -#X connect 18 0 15 1; -#X connect 19 0 15 0; +#X connect 12 0 13 0; +#X restore 102 568 pd Note-off_parser_using_swap; +#X text 11 23 swap two numbers \, respecting right-to-left order; +#X text 168 433 - outputs the value from the right inlet.; +#X text 168 456 - outputs the value from the left inlet.; +#X text 80 503 1) float; +#X text 168 503 - initializes the value of the right inlet.; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 505 10 fswap; +#X text 482 10 or; +#X connect 23 0 27 0; +#X connect 23 1 26 0; +#X connect 24 0 23 0; +#X connect 25 0 23 1; +#X connect 28 0 23 0; +#X connect 29 0 23 0; +#X connect 30 0 23 0; +#X connect 33 0 34 0; +#X connect 34 0 32 0; +#X connect 34 1 31 0; diff --git a/pd/doc/5.reference/switch~-help.pd b/pd/doc/5.reference/switch~-help.pd index c3ab8797e..c756719f3 100644 --- a/pd/doc/5.reference/switch~-help.pd +++ b/pd/doc/5.reference/switch~-help.pd @@ -1,45 +1,172 @@ -#N canvas 218 166 619 368 12; -#X msg 382 133 \; metro 0; -#X text 462 92 <-Click to start; -#X text 455 137 <-Click to stop; -#X text 47 13 switch and block - turn DSP on and off for subpatches -and control block size; -#N canvas 15 32 598 301 switched 1; -#X obj 265 148 switch~; -#X floatatom 265 121 1 0 0; -#X floatatom 75 168 4 0 0; -#X obj 75 104 noise~; -#X obj 75 136 env~ 512; -#X text 25 26 DSP in this subwindow is turned on and off by the switch~ +#N canvas 431 36 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 486 287 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 216 520 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 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 - - -, f 5; +#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 - - -, f 1; +#X floatatom 23 159 7 0 0 0 - - -, f 7; +#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 text 32 203 switch~ takes optional arguments the same as block~. +#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 text 31 258 Only one switch~ or block~ may appear in any window. +#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.), f +60; +#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; +#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 connect 1 0 0 0; -#X connect 3 0 4 0; -#X connect 4 0 2 0; -#X restore 139 124 pd switched; -#N canvas 13 421 564 200 blocked 1; -#X obj 184 35 block~ 1024 4; -#X text 14 76 This object specified that DSP in this subwindow is to -be computed at a block size of 1024 \, and an overlap of 4 \, i.e. -\, every 256 samples. You may not (yet) specify a block size smaller -than your superpatch. This is useful for writing FFT based patches -(see the "fft examples" tutorial series.); -#X restore 141 158 pd blocked; -#X msg 382 87 \; pd dsp 1; -#X obj 382 61 loadbang; -#X text 38 82 see the subpatches for explanation:; -#X text 362 334 updated for Pd version 0.34; -#X text 34 195 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. Also \, you can't -send~ or receive~ between windows with different block sizes or overlapping. -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.; -#X connect 7 0 6 0; +#X obj 480 56 pddp/dsp; +#X obj 495 11 switch~; +#X text 459 147; diff --git a/doc/pddp/symbol-help.pd b/pd/doc/5.reference/symbol-help.pd similarity index 100% rename from doc/pddp/symbol-help.pd rename to pd/doc/5.reference/symbol-help.pd diff --git a/doc/pddp/sysexin-help.pd b/pd/doc/5.reference/sysexin-help.pd similarity index 100% rename from doc/pddp/sysexin-help.pd rename to pd/doc/5.reference/sysexin-help.pd diff --git a/doc/pddp/table-help.pd b/pd/doc/5.reference/table-help.pd similarity index 100% rename from doc/pddp/table-help.pd rename to pd/doc/5.reference/table-help.pd diff --git a/pd/doc/5.reference/tabosc4~-help.pd b/pd/doc/5.reference/tabosc4~-help.pd index 9caf52913..341717c69 100644 --- a/pd/doc/5.reference/tabosc4~-help.pd +++ b/pd/doc/5.reference/tabosc4~-help.pd @@ -1,5 +1,68 @@ -#N canvas 307 35 742 511 12; -#X floatatom 66 450 0 0 0 0 - - -; +#N canvas 428 35 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 tabosc4~ 3 12 0 +18 -204280 -1 0; +#X obj 0 262 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 483 286 494 344 META 0; +#X text 12 125 LIBRARY internal; +#X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 145 AUTHOR Miller Puckette; +#X text 12 205 HELP_PATCH_AUTHORS Updated for Pd version 0.33. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 5 KEYWORDS signal array; +#X text 12 45 DESCRIPTION 4-point interpolating oscillator; +#X text 12 65 INLET_0 signal set; +#X text 12 85 INLET_1 float; +#X text 12 105 OUTLET_0 signal; +#X text 12 185 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 419 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 453 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 491 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 215 334 428 298 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 [tabosc4~] Related Objects; +#X text 21 38 Native Pd Objects; +#X obj 24 61 tabread~; +#X obj 98 61 tabread4; +#X obj 173 61 tabwrite; +#X obj 248 61 tabwrite~; +#X obj 24 89 tabsend~; +#X obj 100 89 tabreceive~; +#X obj 200 89 tabplay~; +#X obj 277 89 table; +#X text 21 140 [array]; +#X obj 24 116 soundfiler; +#X text 84 140 and fft objects.; +#X obj 120 116 tabread4~; +#X obj 211 116 getsize; +#X text 22 170 Externals and other object libraries; +#X obj 22 190 pddp/helplink zexy/tabdump; +#X obj 22 210 pddp/helplink linear_path; +#X text 103 210 <-- which library is this in?; +#X text 103 230 <-- which library is this in?; +#X obj 22 230 pddp/helplink score; +#X text 103 250 <-- which library is this in?; +#X obj 22 250 pddp/helplink tabenv; +#X obj 22 270 pddp/helplink arraysize; +#X restore 102 597 pd Related_objects; +#X obj 78 271 cnv 17 3 100 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 428 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 376 cnv 17 3 35 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X text 98 375 float; +#X obj 485 8 tabosc4~; +#X floatatom 43 203 0 0 0 0 - - -; #N canvas 159 26 495 270 output 0; #X obj 414 196 t b; #X obj 414 134 f; @@ -51,46 +114,79 @@ #X connect 22 0 23 0; #X connect 22 0 23 1; #X connect 24 0 21 0; -#X restore 32 476 pd output; -#X msg 102 450 MUTE; -#X text 148 449 <--- volume in dB; -#X floatatom 32 296 4 0 0 0 - - -; -#X obj 32 326 sig~ 100; -#X obj 547 52 table table1; -#X obj 547 80 table table2; -#X msg 372 287 \; table1 sinesum 512 0.5 0.5 0.5 0.5 \; table2 cosinesum +#X restore 18 224 pd output; +#X msg 69 203 MUTE; +#X floatatom 18 51 4 0 0 0 - - -, f 4; +#X obj 18 76 sig~ 100; +#X msg 32 119 set table1; +#X obj 18 158 tabosc4~ table1; +#X msg 116 119 set table2; +#X floatatom 190 121 4 0 0 0 - - -, f 4; +#X text 48 51 signal input for frequency (Hz.); +#X text 33 98 message to switch tables; +#X text 220 121 inlet to reset phase; +#X obj 319 51 table table1; +#X obj 319 73 table table2; +#X text 98 270 signal; +#X text 98 288 float; +#X text 98 327 list; +#X text 168 327 - a list will be truncated to the first item.; +#X text 98 343 set; +#X text 168 343 - the "set" message is used to switch to a different +table (e.g. \, "set table2" in the example above).; +#X text 167 375 - inlet to reset phase (range is 0 to 1).; +#X text 98 395 list; +#X text 167 395 - a list will be truncated to the first item.; +#X text 98 427 signal; +#N canvas 72 194 428 199 init_tables 0; +#X msg 23 99 \; table1 sinesum 512 0.5 0.5 0.5 0.5 \; table2 cosinesum 512 0 1; -#X text 433 474 Updated for Pd version 0.33; -#X obj 20 11 tabosc4~; -#X text 110 12 4-point interpolating oscillator; -#X msg 52 372 set table1; -#X obj 32 413 tabosc4~ table1; -#X msg 156 372 set table2; -#X text 372 343 click above \, start DSP \, and turn output; -#X text 372 361 volume up to hear this; -#X text 14 178 For good results use 512 points for up to about 15 partials -\, or 32*npartials (rounded up to a power of 2) for more than 15; -#X floatatom 275 391 4 0 0 0 - - -; -#X text 12 233 Don't send new "sinesum" messages to tables while you're -running -- instead \, use "set" messages to switch between tables. +#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 [tabosc4~] Subpatch to Initialize [table] objects; +#X obj 23 75 loadbang; +#X text 20 38 This subpatch initializes the [table] objects used by +[tabosc4~].; +#X text 20 147 Note: Don't send new "sinesum" messages to tables while +you're running. Instead \, use "set" messages to switch between tables. ; -#X text 80 298 signal input for frequency (Hz.); -#X text 46 349 message to switch tables; -#X text 325 391 inlet to reset phase; -#X text 166 414 creation argument initializes table; -#X text 14 40 tabosc4~ is a traditional computer music style wavetable +#X connect 3 0 0 0; +#X restore 319 95 pd init_tables; +#X text 29 184 volume in dB; +#X text 11 23 4-point interpolating oscillator; +#X text 168 471 - initializes the table or array to use.; +#X text 168 288 - a float can be used to specify the frequency \, as +long as there is not also a signal connection to the left inlet of +[tabosc4~].; +#X text 168 270 - an incoming signal to specify frequency (Hz.).; +#X text 168 427 - the outgoing signal.; +#X text 98 494 For good results use 512 points for up to about 15 partials +\, or 32*npartials (rounded up to a power of 2) for more than 15 . +; +#X text 139 152 [tabosc4~] is a traditional computer music style wavetable lookup oscillator using 4-point polynomial interpolation. The table should have a power of two points plus three "guard points" \, one at the beginning and two at the end \, which should be wraparound copies of the last point and the first two points \, respectively. The "sinesum" and "cosinesum" methods for arrays do this automatically for you if you just want to specify partial strengths.; -#X connect 0 0 1 1; -#X connect 1 0 0 0; -#X connect 2 0 1 2; -#X connect 4 0 5 0; -#X connect 5 0 13 0; -#X connect 12 0 13 0; -#X connect 13 0 1 0; +#X text 80 471 1) symbol atom; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 475 55 pddp/dsp; +#X obj 98 530 pddp/pddplink all_about_arrays.pd; +#X obj 98 545 pddp/pddplink ../3.audio.examples/B01.wavetables.pd -text +doc/3.audio.examples/B01.wavetables.pd; +#X obj 98 560 pddp/pddplink ../3.audio.examples/B05.tabread.FM.pd -text +doc/3.audio.examples/B05.tabread.FM.pd; +#X obj 98 575 pddp/pddplink ../3.audio.examples/B06.table.switching.pd +-text doc/3.audio.examples/B06.table.switching.pd; +#X connect 13 0 14 1; #X connect 14 0 13 0; -#X connect 18 0 13 1; +#X connect 15 0 14 2; +#X connect 16 0 17 0; +#X connect 17 0 19 0; +#X connect 18 0 19 0; +#X connect 19 0 14 0; +#X connect 20 0 19 0; +#X connect 21 0 19 1; diff --git a/pd/doc/5.reference/tabplay~-help.pd b/pd/doc/5.reference/tabplay~-help.pd index 92cdb81e6..3e297ea69 100644 --- a/pd/doc/5.reference/tabplay~-help.pd +++ b/pd/doc/5.reference/tabplay~-help.pd @@ -1,66 +1,162 @@ -#N canvas 28 13 707 471 10; -#X msg 639 93 \; pd dsp 0; -#X graph graph1 0 -1 155948 1 428 369 678 169; -#X array array99 155948 float 0; -#X pop; -#X floatatom 11 342 0 0 0; -#X msg 11 109 set array99; -#X text 93 109 "set" message permits you to switch between arrays; -#X text 128 228 creation argument initializes array name; -#X text 5 392 see also the "array" tutorial in section 2 of the Pd -documentation \, and these objects:; -#X obj 6 438 tabwrite~; -#X obj 140 439 tabread; -#X obj 194 439 tabwrite; -#X obj 254 439 tabsend~; -#X obj 315 439 tabreceive~; -#X obj 41 13 tabplay~; -#X text 108 14 play a table as a sample (non-transposing); -#X obj 11 228 tabplay~ array99; -#X obj 452 82 soundfiler; -#X msg 452 48 read -resize ../sound/bell.aiff array99 \; pd dsp 1 \; +#N canvas 430 35 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 tabplay~ 3 12 0 +18 -204280 -1 0; +#X obj 0 284 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 487 285 494 344 META 0; +#X text 12 125 LIBRARY internal; +#X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 145 AUTHOR Miller Puckette; +#X text 12 205 HELP_PATCH_AUTHORS Updated for Pd version 0.29. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 5 KEYWORDS signal array; +#X text 12 45 DESCRIPTION play a table as audio (non-transposing); +#X text 12 65 INLET_0 float bang list set; +#X text 12 85 OUTLET_0 signal; +#X text 12 105 OUTLET_1 bang; +#X text 12 185 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 437 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 502 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 565 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 202 329 441 301 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 [tabplay~] Related Objects; +#X text 20 38 Native Pd Objects; +#X obj 23 63 tabread~; +#X obj 97 63 tabread4; +#X obj 276 89 table; +#X text 22 146 [array]; +#X obj 23 116 soundfiler; +#X text 85 146 and fft objects.; +#X obj 119 116 tabread4~; +#X obj 210 116 getsize; +#X obj 281 116 setsize; +#X obj 172 63 tabread; +#X obj 247 63 tabwrite; +#X obj 23 89 tabwrite~; +#X obj 99 89 tabsend~; +#X obj 179 89 tabreceive~; +#X text 20 170 Externals and other object libraries; +#X obj 20 190 pddp/helplink zexy/tabdump; +#X obj 20 210 pddp/helplink linear_path; +#X text 101 210 <-- which library is this in?; +#X text 101 230 <-- which library is this in?; +#X obj 20 230 pddp/helplink score; +#X text 101 250 <-- which library is this in?; +#X obj 20 250 pddp/helplink tabenv; +#X obj 20 270 pddp/helplink arraysize; +#X restore 102 597 pd Related_objects; +#X obj 78 293 cnv 17 3 135 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 446 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 489 10 tabplay~; +#X text 98 292 bang; +#X text 98 310 float; +#X text 98 347 list; +#X text 98 375 set; +#X obj 78 469 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X text 98 445 signal; +#X text 98 468 bang; +#X text 168 468 - the right inlet sends a bang when [tabplay~] has +finished playing through the table.; +#X text 168 310 - sending a float n will cause [tabplay~] to start +playing from the nth sample. (Sending 0 will play the entire sample.) ; -#X floatatom 452 104 0 0 0; -#X obj 11 316 env~ 16384; -#X obj 396 439 soundfiler; -#X obj 73 439 tabread4~; -#X obj 87 360 dac~ 1; -#X obj 87 323 *~; -#X obj 100 304 line~; -#X msg 100 263 0.1 100; -#X msg 116 284 0 100; -#X text 162 264 on; -#X text 157 283 off; -#X text 148 301 envelope; -#X text 148 312 generator; -#X text 101 248 amplitude controls:; -#X text 131 362 audio output; -#X obj 87 342 hip~ 5; -#X msg 26 179 0 44100; -#X msg 27 158 44100; -#X msg 26 138 bang; -#X text 475 449 updated for Pd version 0.29; -#X text 29 43 The tabplay~ object plays a sample \, or part of one -\, with no transposition or interpolation. It is cheaper than tabread4~ -and there are none of tabread4~'s interpolation artifacts.; -#X text 509 25 click here to load table; -#X text 80 136 "bang" or 0 plays whole sample; -#X text 82 157 play starting at 44100th sample; -#X text 93 177 play starting at beginning for 44100 samples; -#X msg 25 199 44100 1000; -#X text 103 198 play from 44100 through 45099 (1000 samples); -#X connect 3 0 14 0; -#X connect 14 0 18 0; -#X connect 14 0 22 0; -#X connect 15 0 17 0; -#X connect 16 0 15 0; -#X connect 18 0 2 0; -#X connect 22 0 32 0; -#X connect 23 0 22 1; -#X connect 24 0 23 0; -#X connect 25 0 23 0; -#X connect 32 0 21 0; -#X connect 33 0 14 0; -#X connect 34 0 14 0; -#X connect 35 0 14 0; -#X connect 42 0 14 0; +#X text 168 347 - a two-element list (x \, y) will cause [tabplay~] +to begin at sample number x \, and continue for y samples.; +#X floatatom 13 256 0 0 0 0 - - -; +#X msg 13 52 set array99; +#X obj 13 230 env~ 16384; +#X obj 179 257 dac~ 1; +#X obj 179 213 *~; +#X obj 193 191 line~; +#X msg 193 150 0.1 100; +#X msg 209 171 0 100; +#X text 255 151 on; +#X text 255 171 off; +#X text 231 191 envelope; +#X text 231 202 generator; +#X text 223 259 audio output; +#X obj 179 235 hip~ 5; +#X msg 42 137 0 44100; +#X msg 38 116 44100; +#X msg 28 76 bang; +#X msg 48 157 44100 1000; +#X text 168 520 - the name of the array or table to which [tabwrite~] +will write data. The array or table must exist in an open Pd patch/canvas +or an error message will appear in the console.; +#X text 174 128 amplitude controls:; +#N canvas 0 0 450 300 (subpatch) 0; +#X array \$0-array 155948 float 0; +#X coords 0 1 155948 -1 160 100 1; +#X restore 345 145 graph; +#N canvas 0 0 428 391 init 0; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X obj 23 283 soundfiler; +#X floatatom 23 305 0 0 0 0 - - -; +#X obj 23 204 loadbang; +#X text 20 38 The objects below load a short soundfile into the array +named "tabplay~-help-array."; +#X text 20 68 If you right-click on the array and choose "Properties +\, " you'll see the "save contents" checkbox is unmarked \, so that +the array data is not saved as part of the patch.; +#X text 20 110 You can always check this box to save the contents of +the array in the patch \, but with large amounts of array data- even +a few seconds of audio- this can create rather large Pd files.; +#X text 20 162 Thus it is better just to load the content of the array +when the patch opens \, as follows:; +#X text 20 333 See the [soundfiler] help patch for more information. +; +#X text 8 2 [tabplay~] Initialisation Subpatch; +#X obj 23 231 f \$0; +#X msg 23 258 read -resize ../sound/bell.aiff \$1-array; +#X connect 1 0 2 0; +#X connect 3 0 10 0; +#X connect 10 0 11 0; +#X connect 11 0 1 0; +#X restore 345 250 pd init; +#X text 11 23 play a table as audio (non-transposing); +#X text 95 75 The tabplay~ object plays through a table \, or part +of one \, with no transposition or interpolation. It is cheaper than +tabread4~ and there are none of tabread4~'s interpolation artifacts. +; +#X text 168 292 - play through the whole table.; +#X text 168 375 - the "set" message \, followed by the name of an array +\, permits you to switch between arrays (e.g. \, "set another_array"). +; +#X text 168 445 - the outgoing audio signal.; +#X text 80 520 1) symbol; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 480 56 pddp/dsp; +#X obj 98 570 pddp/pddplink all_about_arrays.pd; +#X obj 13 180 tabplay~ \$0-array; +#X msg 33 96 stop; +#X text 98 417 stop; +#X text 168 417 - stop playback; +#X connect 22 0 52 0; +#X connect 23 0 21 0; +#X connect 25 0 34 0; +#X connect 26 0 25 1; +#X connect 27 0 26 0; +#X connect 28 0 26 0; +#X connect 34 0 24 0; +#X connect 35 0 52 0; +#X connect 36 0 52 0; +#X connect 37 0 52 0; +#X connect 38 0 52 0; +#X connect 52 0 23 0; +#X connect 52 0 25 0; +#X connect 53 0 52 0; diff --git a/pd/doc/5.reference/tabread-help.pd b/pd/doc/5.reference/tabread-help.pd index fa671a21d..e00ff62ae 100644 --- a/pd/doc/5.reference/tabread-help.pd +++ b/pd/doc/5.reference/tabread-help.pd @@ -1,21 +1,131 @@ -#N canvas 44 26 703 454 12; -#X text 52 181 index; -#X obj 36 9 tabread; -#X obj 15 244 tabread array99; -#X floatatom 15 182 0 0 0; -#X floatatom 15 278 0 0 0; -#X graph graph1 0 0 10 10 362 379 612 179; -#X array array99 10 float; -#X pop; -#X msg 31 56 \; readout 1 \; array99 resize 10 \; array99 bounds 0 0 10 10 \; array99 xlabel -0.5 0 1 2 3 4 5 6 7 8 9 10 \; array99 ylabel -1 0 1 2 3 4 5 6 7 8 9 10 \; array99 0 1 4 2 8 5 6 1 4 2 8; -#X text 60 276 output = array99[index]; -#X text 141 33 click here to initialize; -#X text 159 236 creation argument; -#X text 155 254 gives array name; -#X msg 25 204 set array99; -#X text 137 204 change array name; -#X text 422 407 updated for Pd version 0.33; -#X text 110 8 - read numbers from a table; -#X connect 2 0 4 0; -#X connect 3 0 2 0; -#X connect 11 0 2 0; +#N canvas 430 33 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 tabread 3 12 0 18 +-204280 -1 0; +#X obj 0 277 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 483 279 494 344 META 0; +#X text 12 105 LIBRARY internal; +#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 125 AUTHOR Miller Puckette; +#X text 12 185 HELP_PATCH_AUTHORS Dave Sabine \, April 25 \, 2003 . +Jonathan Wilkes revised the patch to conform to the PDDP template for +Pd version 0.42.; +#X text 12 5 KEYWORDS control array; +#X text 12 45 DESCRIPTION read numbers from a table; +#X text 12 65 INLET_0 float set; +#X text 12 85 OUTLET_0 float; +#X text 12 165 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 444 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 482 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 541 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 215 327 428 299 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 [tabread] Related Objects; +#X text 21 38 Native Pd Objects; +#X obj 24 61 tabread~; +#X obj 98 61 tabread4; +#X obj 173 61 tabwrite; +#X obj 248 61 tabwrite~; +#X obj 24 89 tabsend~; +#X obj 100 89 tabreceive~; +#X obj 200 89 tabplay~; +#X obj 277 89 table; +#X text 21 140 [array]; +#X obj 24 116 soundfiler; +#X text 84 140 and fft objects.; +#X obj 120 116 tabread4~; +#X obj 211 116 getsize; +#X obj 282 116 setsize; +#X text 22 164 Externals and other object libraries; +#X obj 22 184 pddp/helplink zexy/tabdump; +#X obj 22 204 pddp/helplink linear_path; +#X text 103 204 <-- which library is this in?; +#X text 103 224 <-- which library is this in?; +#X obj 22 224 pddp/helplink score; +#X text 103 244 <-- which library is this in?; +#X obj 22 244 pddp/helplink tabenv; +#X obj 22 264 pddp/helplink arraysize; +#X restore 102 597 pd Related_objects; +#X obj 78 286 cnv 17 3 145 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 285 float; +#X text 98 452 float; +#X obj 78 453 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 492 11 tabread; +#X text 168 285 - a float at the left inlet will move to the corresponding +index in the table's array. The index ranges from 0 to the size of +the array minus one (numbers outside this range are ignored). By default +\, the size of an array in a table is 100 - or 0 to 99 . The actual +size of the array can be altered using the array's dialog box or the +resize command. More about arrays can be found below.; +#X text 98 402 set; +#X text 168 500 - the argument informs [tabread] which array to read. +The array must exist in an open Pd patch/canvas or an error message +will appear in the terminal window.; +#X text 168 452 - outputs a floating point number which corresponds +to the index you query using the inlet.; +#X floatatom 74 251 0 0 0 0 value - -; +#X floatatom 74 93 0 0 99 0 index - -; +#X text 18 55 Open the tables and use your mouse to draw new values +in the arrays - otherwise [tabread] will always output "0".; +#N canvas 0 0 450 300 (subpatch) 0; +#X array \$0-array1 100 float 3; +#A 0 -0.900001 -0.900001 -0.900001 -0.900001 -0.900001 -0.866667 -0.833334 +-0.833334 -0.833334 -0.833334 -0.800001 -0.800001 -0.766667 -0.766667 +-0.766667 -0.766667 -0.766667 -0.766667 -0.766667 -0.766667 -0.766667 +-0.766667 -0.766667 -0.766667 -0.766667 -0.766667 -0.766667 -0.766667 +-0.766667 -0.766667 -0.733334 -0.733334 -0.733334 -0.7 -0.666667 -0.633334 +-0.633334 -0.633334 -0.633334 -0.633334 -0.633334 -0.633334 -0.633334 +-0.6 -0.6 -0.566667 -0.566667 -0.566667 -0.566667 -0.566667 -0.566667 +-0.566667 -0.566667 -0.566667 -0.566667 -0.566667 -0.533334 -0.533334 +-0.5 -0.5 -0.466667 -0.466667 -0.433334 -0.4 -0.366667 -0.333333 -0.3 +-0.283333 -0.266667 -0.233333 -0.2 -0.133333 -0.133333 -0.133333 -0.0666667 +-0.0666667 -0.0666667 1.49012e-08 0.1 0.1 0.233333 0.3 0.333334 0.4 +0.433334 0.566667 0.633334 0.733334 0.733334 0.766667 0.766667 0.800001 +0.800001 0.800001 0.800001 0.800001 0.800001 0.800001 0.800001 0.900001 +; +#X coords 0 1 99 -1 100 60 1; +#X restore 383 83 graph; +#X text 346 217 mouse to draw new values.; +#X text 346 204 Open the table and use your; +#X text 168 402 - the "set" message allows you to read from dynamic +sources (e.g. \, "set tabread-help-array"). You can change the source +at any time using the "set" message.; +#X text 98 380 list; +#X text 168 380 - a list will be truncated to the first item.; +#X text 11 24 read numbers from a table; +#X obj 98 577 pddp/pddplink all_about_arrays.pd -text all_about_arrays +; +#X text 80 500 1) symbol atom; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 107 93 bng 15 250 50 0 empty empty empty 17 7 0 10 -4034 -1 +-1; +#X obj 107 113 f \$0; +#X obj 110 162 bng 15 250 50 0 empty empty empty 17 7 0 10 -4034 -1 +-1; +#X obj 110 182 f \$0; +#X msg 107 135 set \$1-array1; +#X obj 74 227 tabread \$0-array1; +#X msg 110 204 set \$1-array2; +#X obj 353 184 table \$0-array2; +#X obj 98 547 pddp/pddplink ../2.control.examples/15.arrays.pd; +#X obj 97 562 pddp/pddplink ../2.control.examples/16.more.arrays.pd +; +#X connect 18 0 35 0; +#X connect 30 0 31 0; +#X connect 31 0 34 0; +#X connect 32 0 33 0; +#X connect 33 0 36 0; +#X connect 34 0 35 0; +#X connect 35 0 17 0; +#X connect 36 0 35 0; diff --git a/doc/pddp/tabread4-help.pd b/pd/doc/5.reference/tabread4-help.pd similarity index 100% rename from doc/pddp/tabread4-help.pd rename to pd/doc/5.reference/tabread4-help.pd diff --git a/pd/doc/5.reference/tabread4~-help.pd b/pd/doc/5.reference/tabread4~-help.pd index 59986b38c..ed3788474 100644 --- a/pd/doc/5.reference/tabread4~-help.pd +++ b/pd/doc/5.reference/tabread4~-help.pd @@ -75,8 +75,8 @@ interpolation is meaningful.; ; #X text 98 353 set; #N canvas 0 0 450 300 (subpatch) 0; -#X array \$0-array 10 float 0 black black; -#X coords 0 1 10 -1 160 100 1; +#X array \$0-array 10 float 0; +#X coords 0 1 9 -1 160 100 1; #X restore 289 141 graph; #X text 98 425 signal; #X obj 40 217 loadbang; @@ -96,7 +96,7 @@ or an error message will appear in the console.; #X obj 23 125 s \$0-array; #X connect 0 0 5 0; #X connect 2 0 0 0; -#X restore 289 269 pd init; +#X restore 288 270 pd init; #X text 168 353 - the "set" message \, followed by the name of an array \, permits you to switch between arrays (e.g. \, "set another_array"). ; diff --git a/doc/pddp/tabread~-help.pd b/pd/doc/5.reference/tabread~-help.pd similarity index 100% rename from doc/pddp/tabread~-help.pd rename to pd/doc/5.reference/tabread~-help.pd diff --git a/pd/doc/5.reference/tabreceive~-help.pd b/pd/doc/5.reference/tabreceive~-help.pd index 7de98346f..af776a86b 100644 --- a/pd/doc/5.reference/tabreceive~-help.pd +++ b/pd/doc/5.reference/tabreceive~-help.pd @@ -1,6 +1,54 @@ -#N canvas 109 83 646 239 12; -#X obj 21 18 tabreceive~; -#X text 17 53 creation argument: name of array; -#X text 16 83 By default a block is 64 samples \; this can be reset using the block~ object.; -#X text 380 201 updated for Pd version 0.33; -#X text 129 18 - read a block of a signal from an array continuously; +#N canvas 429 35 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 tabreceive~ 3 12 +0 18 -204280 -1 0; +#X obj 0 450 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 483 288 494 344 META 0; +#X text 12 115 LIBRARY internal; +#X text 12 155 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 135 AUTHOR Miller Puckette; +#X text 12 195 HELP_PATCH_AUTHORS Updated for Pd version 0.33. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 45 DESCRIPTION read a block of a signal from an array continuously +; +#X text 12 75 INLET_0; +#X text 12 95 OUTLET_0 signal; +#X text 12 175 RELEASE_DATE 1997; +#X text 12 5 KEYWORDS signal array block_oriented; +#X restore 500 597 pd META; +#X obj 0 487 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 524 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 565 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 214 527 428 109 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 obj 103 43 fft~; +#X obj 23 43 tabsend~; +#X text 8 2 [tabreceive~] Related Objects; +#X restore 102 597 pd Related_objects; +#X obj 78 459 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 496 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 466 10 tabreceive~; +#X text 11 23 read a block of a signal from an array continuously; +#X obj 95 226 tabreceive~; +#X text 90 291 By default a block is 64 samples \; this can be reset +using the block~ object.; +#X text 203 226 - read a block of a signal from an array continuously +; +#X text 168 542 - the name of an array to read from.; +#X text 98 495 signal; +#X text 98 458 unknown; +#X text 80 542 1) symbol atom; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 474 55 pddp/dsp; +#X obj 98 570 pddp/pddplink all_about_arrays.pd; diff --git a/pd/doc/5.reference/tabsend~-help.pd b/pd/doc/5.reference/tabsend~-help.pd index 85a4183fa..56c9ad5e4 100644 --- a/pd/doc/5.reference/tabsend~-help.pd +++ b/pd/doc/5.reference/tabsend~-help.pd @@ -1,6 +1,92 @@ -#N canvas 151 91 596 222 12; -#X obj 31 27 tabsend~; -#X text 113 26 writes one block of a signal continuously to an array; -#X text 41 60 creation argument: name of array; -#X text 29 96 By default a block is 64 samples \; this can be reset using the block~ object.; -#X text 318 186 updated for Pd version 0.33; +#N canvas 429 35 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 tabsend~ 3 12 0 +18 -204280 -1 0; +#X obj 0 464 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 481 287 494 344 META 0; +#X text 12 115 LIBRARY internal; +#X text 12 155 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 135 AUTHOR Miller Puckette; +#X text 12 195 HELP_PATCH_AUTHORS Updated for Pd version 0.33. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 5 KEYWORDS signal array block_oriented; +#X text 12 45 DESCRIPTION write one block of a signal continuously +to an array; +#X text 12 75 DATATYPE_IN signal; +#X text 12 95 DATATYPE_OUT; +#X text 12 175 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 501 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 525 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 566 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 215 522 428 109 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 obj 103 43 fft~; +#X text 8 2 [tabsend~] Related Objects; +#X obj 23 43 tabreceive~; +#X restore 102 597 pd Related_objects; +#X obj 78 473 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 492 9 tabsend~; +#N canvas 0 0 450 300 (subpatch) 0; +#X array \$0-array 64 float 2; +#X coords 0 1 64 -1 100 70 1; +#X restore 291 205 graph; +#X obj 83 169 loadbang; +#X text 98 505 (none); +#X text 98 472 signal; +#N canvas 68 141 428 387 Using_tabsend~_with_block~ 0; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#N canvas 0 0 450 300 (subpatch) 0; +#X array \$0-array2 128 float 0; +#X coords 0 1 127 -1 128 100 1; +#X restore 193 117 graph; +#X msg 24 305 set 128; +#X msg 24 257 set 64; +#X obj 194 117 cnv 15 64 20 empty empty 64_samples 0 10 0 10 -257985 +-66577 0; +#X obj 193 197 cnv 15 128 20 empty empty 128_samples 60 10 0 10 -4034 +-66577 0; +#X obj 23 117 osc~ 512; +#X text 73 256 default size; +#X text 78 303 double size; +#X obj 24 353 block~; +#X text 8 2 [tabsend~] Using [tabsend~] with [block~]; +#X text 21 230 Try changing the block size:; +#X text 20 38 You can use [block~] to change the blocksize and \, consequently +\, how many samples are send to the specified array by [tabsend~]. +; +#X obj 24 148 tabsend~ \$0-array2; +#X connect 2 0 9 0; +#X connect 3 0 9 0; +#X connect 6 0 13 0; +#X restore 83 368 pd Using_tabsend~_with_block~; +#X text 80 320 By default a block is 64 samples. This can be reset +using the [block~] object \, as in the subpatch below:; +#X obj 83 228 osc~; +#X msg 83 198 512; +#X text 168 472 - the incoming signal to be sent to the table/array. +; +#X text 81 121 The [tabsend~] object writes an audio signal continuously +to an array.; +#X text 11 23 write one block of a signal continuously to an array +; +#X text 168 543 - the name of an array to write to.; +#X text 80 543 1) symbol atom; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 484 54 pddp/dsp; +#X obj 108 570 pddp/pddplink all_about_arrays.pd; +#X obj 83 258 tabsend~ \$0-array; +#X connect 11 0 17 0; +#X connect 16 0 26 0; +#X connect 17 0 16 0; diff --git a/pd/doc/5.reference/tabwrite-help.pd b/pd/doc/5.reference/tabwrite-help.pd index 60b31513c..1bbc240cb 100644 --- a/pd/doc/5.reference/tabwrite-help.pd +++ b/pd/doc/5.reference/tabwrite-help.pd @@ -1,21 +1,132 @@ -#N canvas 44 17 653 456 12; -#X obj 31 27 tabwrite; -#X floatatom 9 176 0 0 0; -#X obj 9 282 tabwrite array99; -#X text 113 28 write numbers to a table; -#X graph graph1 0 0 10 10 355 389 605 189; -#X array array99 10 float; -#X pop; -#X msg 9 53 \; readout 1 \; array99 resize 10 \; array99 bounds 0 0 10 10 \; array99 xlabel -0.5 0 1 2 3 4 5 6 7 8 9 10 \; array99 ylabel -1 0 1 2 3 4 5 6 7 8 9 10 \; array99 0 1 4 2 8 5 6 1 4 2 8; -#X text 406 94 click here to initialize; -#X floatatom 146 257 0 0 0; -#X text 158 279 creation argument; -#X text 160 297 is array name; -#X text 46 174 set y value; -#X text 44 239 right inlet selects x value; -#X msg 25 204 set array99; -#X text 133 203 change array name; -#X text 389 423 updated for Pd version 0.33; -#X connect 1 0 2 0; -#X connect 7 0 2 1; -#X connect 12 0 2 0; +#N canvas 429 36 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 tabwrite 3 12 0 +18 -204280 -1 0; +#X obj 0 300 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 483 284 494 344 META 0; +#X text 12 105 LIBRARY internal; +#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 125 AUTHOR Miller Puckette; +#X text 12 185 HELP_PATCH_AUTHORS Dave Sabine \, April 29 \, 2003 . +Jonathan Wilkes revised the patch to conform to the PDDP template for +Pd version 0.42.; +#X text 12 5 KEYWORDS control array; +#X text 12 45 DESCRIPTION write numbers to a table; +#X text 12 65 INLET_0 float list; +#X text 12 85 INLET_1 float; +#X text 12 165 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 456 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 481 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 540 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 218 329 428 300 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 [tabwrite] Related Objects; +#X text 20 38 Native Pd Objects; +#X obj 23 63 tabread~; +#X obj 97 63 tabread4; +#X obj 247 63 tabwrite~; +#X obj 23 89 tabsend~; +#X obj 99 89 tabreceive~; +#X obj 199 89 tabplay~; +#X obj 276 89 table; +#X text 22 146 [array]; +#X obj 23 116 soundfiler; +#X text 85 146 and fft objects.; +#X obj 119 116 tabread4~; +#X obj 210 116 getsize; +#X obj 281 116 setsize; +#X obj 172 63 tabread; +#X text 20 170 Externals and other object libraries; +#X obj 20 190 pddp/helplink zexy/tabdump; +#X obj 20 210 pddp/helplink linear_path; +#X text 101 210 <-- which library is this in?; +#X text 101 230 <-- which library is this in?; +#X obj 20 230 pddp/helplink score; +#X text 101 250 <-- which library is this in?; +#X obj 20 250 pddp/helplink tabenv; +#X obj 20 270 pddp/helplink arraysize; +#X restore 102 597 pd Related_objects; +#X obj 78 309 cnv 17 3 115 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 308 float; +#X text 98 348 list; +#X obj 78 435 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X text 98 434 float; +#X obj 487 10 tabwrite; +#X floatatom 174 251 0 0 99 1 index - -; +#X obj 51 276 tabwrite davids_array; +#X floatatom 51 84 0 0 0 0 value - -; +#X text 168 308 - a float at the left inlet will become the new value +of the chosen index (whichever index is currently selected at the right +inlet).; +#X text 168 348 - the left inlet also accepts pairs of floats (longer +lists will be truncated). A number pair represents "value" and "index" +- corresponding to "left" and "right" inlets.; +#X text 98 388 set; +#N canvas 0 0 450 300 (subpatch) 0; +#X array \$0-davids_array 100 float 1; +#A 0 0 0 0 0 0 0 0 0 0 0 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 +0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 +0 0 0 0 0 0 0 0 0 0 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 +0; +#X coords 0 1 99 -1 100 70 1; +#X restore 278 94 graph; +#N canvas 0 0 450 300 (subpatch) 0; +#X array \$0-another_array 100 float 1; +#A 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 +0 0 0 0 -0.67 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 +0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 +0 0 0; +#X coords 0 1 99 -1 100 70 1; +#X restore 408 94 graph; +#X text 11 23 write numbers to a table; +#X text 167 434 - selects index in which to write the new value.; +#X text 98 460 (none); +#X obj 98 543 pddp/pddplink all_about_arrays.pd -text all_about_arrays +; +#X text 276 181 Click below to view the table:; +#X text 168 498 - the name of the array or table to which [tabwrite] +will write data. The array must exist in an open Pd patch/canvas or +an error message will appear in the console.; +#X text 168 388 - the "set" message \, followed by the name of an array +\, permits you to switch between arrays (e.g. \, "set another_array") +; +#X text 80 498 1) symbol atom; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 90 117 bng 15 250 50 0 empty empty empty 17 7 0 10 -4034 -1 +-1; +#X obj 90 137 f \$0; +#X obj 95 186 bng 15 250 50 0 empty empty empty 17 7 0 10 -4034 -1 +-1; +#X obj 95 206 f \$0; +#X obj 84 47 bng 15 250 50 0 empty empty empty 17 7 0 10 -4034 -1 -1 +; +#X obj 84 67 f \$0; +#X msg 84 89 set \$1-davids_array; +#X obj 278 202 table \$0-tabwrite_table; +#X msg 90 159 set \$1-another_array; +#X msg 95 228 set \$1-tabwrite_table; +#X obj 96 558 pddp/pddplink ../2.control.examples/15.arrays.pd; +#X obj 95 573 pddp/pddplink ../2.control.examples/16.more.arrays.pd +; +#X connect 14 0 15 1; +#X connect 16 0 15 0; +#X connect 31 0 32 0; +#X connect 32 0 39 0; +#X connect 33 0 34 0; +#X connect 34 0 40 0; +#X connect 35 0 36 0; +#X connect 36 0 37 0; +#X connect 37 0 15 0; +#X connect 39 0 15 0; +#X connect 40 0 15 0; diff --git a/pd/doc/5.reference/tabwrite~-help.pd b/pd/doc/5.reference/tabwrite~-help.pd index 7fb3874b3..751b926f3 100644 --- a/pd/doc/5.reference/tabwrite~-help.pd +++ b/pd/doc/5.reference/tabwrite~-help.pd @@ -1,40 +1,110 @@ -#N canvas 159 22 645 442 12; -#X obj 12 12 tabwrite~; -#X msg 47 210 bang; -#X obj 28 318 tabwrite~ array99; +#N canvas 429 36 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 tabwrite~ 3 12 0 +18 -204280 -1 0; +#X obj 0 324 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 485 288 494 344 META 0; +#X text 12 85 LIBRARY internal; +#X text 12 125 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 105 AUTHOR Miller Puckette; +#X text 12 165 HELP_PATCH_AUTHORS Updated for Pd version 0.40. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 5 KEYWORDS signal array; +#X text 12 45 DESCRIPTION write a signal in an array; +#X text 12 65 INLET_0 bang signal start stop set; +#X text 12 145 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 475 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 502 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 566 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 214 319 428 313 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 20 38 Native Pd Objects; +#X obj 23 63 tabread~; +#X obj 97 63 tabread4; +#X obj 23 89 tabsend~; +#X obj 99 89 tabreceive~; +#X obj 199 89 tabplay~; +#X obj 276 89 table; +#X text 22 146 [array]; +#X obj 23 116 soundfiler; +#X text 85 146 and fft objects.; +#X obj 119 116 tabread4~; +#X obj 210 116 getsize; +#X obj 281 116 setsize; +#X obj 172 63 tabread; +#X text 8 2 [tabwrite~] Related Objects; +#X obj 247 63 tabwrite; +#X text 20 180 Externals and other object libraries; +#X obj 20 200 pddp/helplink zexy/tabdump; +#X obj 20 220 pddp/helplink linear_path; +#X text 101 220 <-- which library is this in?; +#X text 101 240 <-- which library is this in?; +#X obj 20 240 pddp/helplink score; +#X text 101 260 <-- which library is this in?; +#X obj 20 260 pddp/helplink tabenv; +#X obj 20 280 pddp/helplink arraysize; +#X restore 102 597 pd Related_objects; +#X obj 78 333 cnv 17 3 135 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 484 9 tabwrite~; +#X text 11 23 write a signal in an array; +#X msg 95 194 bang; +#X msg 111 239 stop; +#X obj 78 170 phasor~ 200; +#X text 98 332 bang; +#X text 98 351 start; +#X text 98 390 stop; +#X text 98 410 set; +#X text 98 479 (none); #N canvas 0 0 450 300 (subpatch) 0; -#X array array99 1000 float 0; -#X coords 0 1 999 -1 200 100 1; -#X restore 414 207 graph; -#X text 190 318 creation argument initializes array name; -#X msg 45 288 set array99; -#X msg 555 13 \; pd dsp 1; -#X msg 555 51 \; pd dsp 0; -#X text 23 353 see also the "array" tutorial in section 2 of the Pd -documentation \, and these objects:; -#X obj 107 389 tabread; -#X obj 174 389 tabwrite; -#X obj 250 389 tabsend~; -#X obj 327 389 tabreceive~; -#X obj 22 389 tabread4~; -#X msg 48 260 stop; -#X text 153 261 stop recording; -#X msg 47 236 start 500; -#X text 147 236 start in middle of table; -#X text 370 420 updated for Pd version 0.40.; -#X text 104 12 - write a signal in an array; -#X obj 27 187 phasor~ 200; -#X text 148 209 start recording; -#X text 149 286 set destination array; -#X text 16 44 Tabwrite~ records an audio signal sequentially into an -array. Sending it "bang" writes from beginning to end of the array. +#X array \$0-array 1000 float 0; +#X coords 0 1 999 -1 160 100 1 0 0; +#X restore 329 183 graph; +#X msg 98 216 start 500; +#X text 168 521 - the name of the array or table to which [tabwrite~] +will write data. The array or table must exist in an open Pd patch/canvas +or an error message will appear in the console.; +#X text 98 451 signal; +#X text 75 55 [tabwrite~] records an audio signal sequentially into +an array. Sending it "bang" writes from beginning to end of the array. To avoid writing all the way to the end \, you can send a "stop message at an appropriate later time. The "start" message allows skipping a number of samples at the nbeginning. (Starting and stopping occur on block boundaries \, typically multiples of 64 samples \, in the input signal.); -#X connect 1 0 2 0; -#X connect 5 0 2 0; -#X connect 14 0 2 0; -#X connect 16 0 2 0; -#X connect 20 0 2 0; +#X text 80 521 1) symbol atom; +#X text 168 351 - the "start" message will start recording at the specified +element (e.g. \, "start 500" will start recording at the 500th element). +; +#X text 168 332 - start recording.; +#X text 168 390 - stop recording.; +#X text 168 410 - the "set" message \, followed by the name of an array +\, permits you to switch between arrays (e.g. \, "set another_array"). +; +#X text 166 452 - the signal to be written to the array.; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 480 55 pddp/dsp; +#X obj 98 570 pddp/pddplink all_about_arrays.pd; +#X obj 171 219 bng 15 250 50 0 empty empty empty 17 7 0 10 -4034 -1 +-1; +#X obj 171 239 f \$0; +#X obj 78 291 tabwrite~ \$0-array; +#X obj 329 293 table \$0-array2; +#X msg 171 261 set \$1-array2; +#X connect 11 0 35 0; +#X connect 12 0 35 0; +#X connect 13 0 35 0; +#X connect 20 0 35 0; +#X connect 33 0 34 0; +#X connect 34 0 37 0; +#X connect 37 0 35 0; diff --git a/doc/pddp/tan-help.pd b/pd/doc/5.reference/tan-help.pd similarity index 100% rename from doc/pddp/tan-help.pd rename to pd/doc/5.reference/tan-help.pd diff --git a/doc/pddp/test-loop~.pd b/pd/doc/5.reference/test-loop~.pd similarity index 100% rename from doc/pddp/test-loop~.pd rename to pd/doc/5.reference/test-loop~.pd diff --git a/pd/doc/5.reference/text-help.pd b/pd/doc/5.reference/text-help.pd index 96664048f..e4d941c5d 100644 --- a/pd/doc/5.reference/text-help.pd +++ b/pd/doc/5.reference/text-help.pd @@ -1,4 +1,73 @@ -#N canvas 74 127 544 214 12; -#X text 281 174 updated for Pd version 0.26; -#X text 107 13 comments; -#X text 38 73 This is Pd's help window for comments \, which don't do anything.; +#N canvas 430 35 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 text 3 12 0 18 -204280 +-1 0; +#X obj 0 458 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 489 286 494 344 META 0; +#X text 12 65 LIBRARY internal; +#X text 12 105 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 85 AUTHOR Miller Puckette; +#X text 12 145 HELP_PATCH_AUTHORS Updated for Pd version 0.26. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 5 KEYWORDS control; +#X text 12 125 RELEASE_DATE 1997; +#X text 12 45 DESCRIPTION box with text for an object or comment; +#X restore 500 597 pd META; +#X obj 0 486 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 514 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 542 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#X text 98 518 (none); +#N canvas 217 509 428 119 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 comment Related Objects; +#X obj 21 28 pddp/pddplink all_about_externals.pd -text _________; +#X obj 21 28 pddp/pddplink all_about_externals.pd -text Externals; +#X obj 21 48 pddp/helplink cyclone/comment; +#X obj 21 68 pddp/helplink pddp/pddplink; +#X obj 21 88 pddp/helplink pddp/helplink; +#X restore 102 597 pd Related_objects; +#X text 104 387 Phone number with hyphens: 555-555-5555; +#X text 104 407 Same phone number without hyphens: 5.55556e+09; +#X text 98 462 (none); +#X text 98 491 (none); +#N canvas 100 383 428 181 Some_Comments_On_Comments 0; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 20 29 semicolons in comments cause the text \; following them +to \; start \; on a \; new \; line; +#X text 19 110 Try adding a period at the end of this sentence \, which +ends with the number 1; +#X text 19 140 If you close this subwindow \, then open it again \, +the period you added will be gone.; +#X text 8 2 comment Commentary: Additional Comments About Comments +; +#X restore 102 551 pd Some_Comments_On_Comments; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 99 571 pddp/pddplink all_about_ascii_art.pd; +#X text 378 11 To create \, click <Control-5>; +#X text 11 23 box with text for an object or comment; +#X text 85 144 Comments don't actually "do" anything \, but you can +use them to annotate your patch \, explain how something works \, add +a copyright notice \, or anything else.; +#X text 85 74 All text in Pure Data is just a series of symbol and/or +float atoms. You create Pd objects by typing text into an object box +\, but you can also write text as a comment for your patch (like this +one).; +#X text 85 224 To create a comment \, use the "Put" menu or click <Control-5>. +; +#X text 55 267 ***; +#X text 85 347 Otherwise your phone number will interpreted as a float +atom and you will lose some rather important precision!; +#X text 85 267 Remember: text inside a comment is just a series of +atoms \, and will be formatted accordingly. For example: if you want +to jot down a large value like a phone number in pd \, use hyphens +or multiple dots so that pd will interpret it as a symbol atom.; diff --git a/pd/doc/5.reference/textfile-help.pd b/pd/doc/5.reference/textfile-help.pd index 8da1dde69..50c4603e4 100644 --- a/pd/doc/5.reference/textfile-help.pd +++ b/pd/doc/5.reference/textfile-help.pd @@ -1,59 +1,111 @@ -#N canvas 12 43 1181 529 12; -#X msg 582 27 rewind; -#X obj 577 416 print done; -#X text 745 185 read a file; -#X text 801 214 write one; -#X text 97 472 see also:; -#X obj 521 365 textfile; -#X msg 584 188 read textfile.txt; -#X obj 176 473 qlist; -#X obj 145 20 textfile; -#X text 236 20 read and write text files; -#X text 34 92 The textfile object reads and writes text files to and -from memory. You can read a file and output sequential lines as lists +#N canvas 431 34 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 textfile 3 12 0 +18 -204280 -1 0; +#X obj 0 429 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 487 285 494 344 META 0; +#X text 12 125 LIBRARY internal; +#X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 145 AUTHOR Miller Puckette; +#X text 12 205 HELP_PATCH_AUTHORS Updated for Pd version 0.33. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 45 DESCRIPTION read and write text files; +#X text 12 65 INLET_0 bang rewind clear add add2 set read write print +; +#X text 12 85 OUTLET_0 list; +#X text 12 105 OUTLET_1 bang; +#X text 12 5 KEYWORDS control storage filesystem list_op anything_op +; +#X text 12 185 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 465 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 531 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 558 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#X text 98 535 (none); +#N canvas 216 519 428 109 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 [textfile] Related Objects; +#X obj 22 43 qlist; +#X restore 102 597 pd Related_objects; +#X obj 78 438 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 474 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 498 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X text 11 23 read and write text files; +#X obj 485 11 textfile; +#X obj 85 347 print done; +#X text 98 497 bang; +#X text 167 497 - this outlet gets a bang when you hit the end of the +sequence.; +#X text 98 473 list; +#X text 168 473 - this outlet gets the lines in sequence.; +#X text 168 437 (see the example above for messages accepted by [textfile]) +; +#X msg 101 76 rewind; +#X text 214 207 read a file; +#X msg 101 208 read textfile.txt; +#X text 152 75 go to beginning; +#X msg 101 98 bang; +#X text 152 97 output one line as a list; +#X msg 101 230 write /tmp/textfile.txt; +#X msg 101 252 write /tmp/textfile2.txt cr; +#X msg 101 274 read textfile.txt cr; +#X msg 101 120 clear; +#X text 152 119 empty the object; +#X text 208 142 add a message; +#X msg 101 186 set 2 4 6 8; +#X text 208 186 clear and then add one message; +#X msg 101 142 add cis boom bah; +#X msg 101 164 add2 bang; +#X text 208 164 add an unterminated message; +#X msg 101 296 print; +#X text 145 296 debugging printout; +#X text 248 229 write a file; +#X obj 40 322 textfile; +#X text 272 251 write a file \, terminating lines with a; +#X text 273 266 carriage return (omitting semicolons).; +#X text 272 281 You can read files this way \, too \, in; +#X text 273 296 which case carriage returns are mapped; +#N canvas 94 361 428 199 About_textfile 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 [textfile] Related Objects; +#X text 21 38 The textfile object reads and writes text files to and +from memory. You can read a file and output sequential lines as messages \, or collect lines and write them out. You can use this object to generate "models" for Gem \, for instance.; -#X text 665 28 go to beginning; -#X msg 582 54 bang; -#X text 665 53 output one line as a list; -#X msg 584 216 write /tmp/textfile.txt; -#X msg 584 243 write /tmp/textfile2.txt cr; -#X text 593 264 write a file \, terminating lines only with carriage -return (omitting semicolons.) You can read files this way too \, in -which case carriage returns are mapped to semicolons.; -#X obj 521 438 print list; -#X msg 583 312 read textfile.txt cr; -#X msg 582 82 clear; -#X text 737 83 empty the object; -#X text 737 111 add a message; -#X text 521 464 this outlet gets the lines in sequence.; -#X text 35 246 You can also use this object simply for storing heterogeneous -sequences of lists.; -#X text 608 385 This outlet gets a bang when you hit the end of the -sequence.; -#X msg 582 162 set 2 4 6 8; -#X text 740 163 clear and then add one message; -#X msg 582 109 add cis boom bah; -#X msg 582 136 add2 bang; -#X text 734 136 add an unterminated message; -#X text 31 160 To record textual messages and save them to a file \, -first send "clear" to empty the qlist and "add" to add messages (terminated -with semicolons.) The message \, "add2" adds a list of atoms without -finishing with a semicolon in case you want to make variable-length +#X text 20 91 To record textual messages and save them to a file \, +first send "clear" to empty the sequence and "add" to add messages +(terminated with semicolons.) The message \, "add2" adds a list of +atoms without finishing with a semicolon in case you want to make variable-length messages.; -#X msg 582 339 print; -#X text 636 342 debugging printout; -#X text 901 500 updated for Pd version 0.33; -#X connect 0 0 5 0; -#X connect 5 0 17 0; -#X connect 5 1 1 0; -#X connect 6 0 5 0; -#X connect 12 0 5 0; -#X connect 14 0 5 0; -#X connect 15 0 5 0; -#X connect 18 0 5 0; -#X connect 19 0 5 0; -#X connect 25 0 5 0; -#X connect 27 0 5 0; -#X connect 28 0 5 0; -#X connect 31 0 5 0; +#X text 20 155 You can also use this object simply for storing heterogeneous +sequences of messages.; +#X restore 101 567 pd About_textfile; +#X obj 40 369 print message; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X text 274 311 to semicolons.; +#X connect 20 0 40 0; +#X connect 22 0 40 0; +#X connect 24 0 40 0; +#X connect 26 0 40 0; +#X connect 27 0 40 0; +#X connect 28 0 40 0; +#X connect 29 0 40 0; +#X connect 32 0 40 0; +#X connect 34 0 40 0; +#X connect 35 0 40 0; +#X connect 37 0 40 0; +#X connect 40 0 46 0; +#X connect 40 1 14 0; diff --git a/pd/doc/5.reference/threshold~-help.pd b/pd/doc/5.reference/threshold~-help.pd index 5922d15bc..66566966f 100644 --- a/pd/doc/5.reference/threshold~-help.pd +++ b/pd/doc/5.reference/threshold~-help.pd @@ -1,31 +1,93 @@ -#N canvas 114 43 685 360 12; -#X msg 452 58 \; pd dsp 0; -#X msg 452 24 \; pd dsp 1; -#X obj 124 11 threshold~; -#X text 200 12 - TRIGGER FROM AUDIO SIGNAL; -#X obj 49 183 sig~; -#X obj 49 261 threshold~ 10 100 0 100; -#X text 303 255 Arguments:; -#X text 384 255 1 trigger threshold; -#X floatatom 49 156 5 0 0; -#X obj 49 289 print trigger; -#X obj 205 287 print rest; -#X text 385 271 2 trigger debounce time; -#X text 385 288 3 rest threshold; -#X text 384 303 4 rest debounce time; -#X text 486 342 updated for Pd version 0.32; -#X msg 205 209 1; -#X msg 235 210 0; -#X text 12 39 threshold~ monitors its input signal and outputs bangs when the signal exceeds a specified "trigger" value \, and also when the signal recedes below a "rest" value. You can specify debounce times in milliseconds \, for the threshold~ to wait after the two event types before triggering again.; -#X msg 131 151 set 0 2000 1 2000; -#X msg 131 174 set 10 100 0 100; -#X text 262 150 "set" to change the parameters; -#X text 268 210 zero or nonszero in inlet to set the state to "high" or "low". There is no debounce period after this.; -#X connect 4 0 5 0; -#X connect 5 0 9 0; -#X connect 5 1 10 0; -#X connect 8 0 4 0; -#X connect 15 0 5 1; -#X connect 16 0 5 1; -#X connect 18 0 5 0; -#X connect 19 0 5 0; +#N canvas 430 33 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 threshold~ 3 12 +0 18 -204280 -1 0; +#X obj 0 295 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 486 261 494 365 META 0; +#X text 12 145 LIBRARY internal; +#X text 12 185 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 165 AUTHOR Miller Puckette; +#X text 12 225 HELP_PATCH_AUTHORS Updated for Pd version 0.32. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 5 KEYWORDS signal; +#X text 12 45 DESCRIPTION trigger from audio signal; +#X text 12 65 INLET_0 set signal; +#X text 12 85 INLET_1 float; +#X text 12 105 OUTLET_0 bang; +#X text 12 125 OUTLET_1 bang; +#X text 12 205 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 396 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 468 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 569 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 217 520 428 109 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 [threshold~] Related Objects; +#X obj 22 43 env~; +#X restore 102 597 pd Related_objects; +#X obj 78 304 cnv 17 3 40 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 405 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 352 cnv 17 3 35 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X text 98 351 float; +#X obj 478 10 threshold~; +#X text 11 23 trigger from audio signal; +#X obj 140 168 sig~; +#X obj 140 226 threshold~ 10 100 0 100; +#X floatatom 140 141 5 0 0 0 - - -, f 5; +#X obj 140 254 print trigger; +#X obj 275 254 print rest; +#X msg 296 196 1; +#X msg 327 196 0; +#X msg 222 146 set 0 2000 1 2000; +#X msg 222 169 set 10 100 0 100; +#X text 98 303 signal; +#X text 98 324 set; +#X text 167 351 - a zero to the right inlet sets the object's state +to "high." A nonzero value sets it to "low." There is no debounce period +after this.; +#X text 98 404 bang; +#X obj 78 435 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X text 98 434 bang; +#X text 168 404 - a bang is sent to the left outlet when the incoming +signal is greater than or equal to the "trigger" value.; +#X text 168 434 - a bang is sent to the right outlet when the incoming +signal is less than or equal to the "rest" value.; +#X text 168 324 - the "set" message can be used to change the parameters +(i.e. \, the values set by the creation arguments).; +#X text 168 303 - the incoming signal.; +#X text 80 486 1) float; +#X text 79 506 2) float; +#X text 168 486 - (optional) trigger threshold.; +#X text 167 526 - (optional) rest threshold.; +#X text 167 506 - (optional) trigger debounce time (ms).; +#X text 167 546 - (optional) rest debounce time (ms).; +#X text 88 56 [threshold~] monitors its input signal and outputs bangs +when the signal equals or exceeds a specified "trigger" value \, and +also when the signal equals or recedes below a "rest" value. You can +specify debounce times in milliseconds \, for the [threshold~] to wait +after the two event types before triggering again.; +#X text 79 526 3) float; +#X text 79 546 4) float; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 481 57 pddp/dsp; +#X connect 14 0 15 0; +#X connect 15 0 17 0; +#X connect 15 1 18 0; +#X connect 16 0 14 0; +#X connect 19 0 15 1; +#X connect 20 0 15 1; +#X connect 21 0 15 0; +#X connect 22 0 15 0; diff --git a/pd/doc/5.reference/throw~-help.pd b/pd/doc/5.reference/throw~-help.pd index c9a1ce9dc..825fd7054 100644 --- a/pd/doc/5.reference/throw~-help.pd +++ b/pd/doc/5.reference/throw~-help.pd @@ -1,34 +1,87 @@ -#N canvas 80 120 664 313 12; -#X obj 97 159 throw~ signal1; -#X floatatom 268 211 0 0 0; -#X obj 90 193 sig~ 50; -#X obj 268 181 snapshot~; -#X obj 90 221 throw~ signal1; -#X obj 97 88 sig~ 25; -#X obj 268 135 catch~ signal1; -#X obj 35 17 throw~; -#X obj 97 17 catch~; -#X text 163 16 - summing signal bus and non-local connection; -#X obj 551 88 loadbang; -#X msg 561 110 \; pd dsp 1; -#X obj 551 151 metro 200; -#X text 33 48 Any number of throw~ objects can add into one catch~ object (but two catch~ objects cannot share the same name.); -#X floatatom 401 206 0 0 0; -#X obj 402 182 snapshot~; -#X obj 402 134 catch~ signal2; -#X msg 113 111 set signal2; -#X msg 114 135 set signal1; -#X text 75 252 You can redirect throw~ via a "set" message.; -#X text 410 283 updated for Pd version 0.33; -#X connect 2 0 4 0; -#X connect 3 0 1 0; -#X connect 5 0 0 0; -#X connect 6 0 3 0; -#X connect 10 0 11 0; -#X connect 10 0 12 0; -#X connect 12 0 3 0; -#X connect 12 0 15 0; -#X connect 15 0 14 0; -#X connect 16 0 15 0; -#X connect 17 0 0 0; -#X connect 18 0 0 0; +#N canvas 431 35 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 throw~ 3 12 0 18 +-204280 -1 0; +#X obj 0 387 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 487 287 494 344 META 0; +#X text 12 85 LIBRARY internal; +#X text 12 125 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 105 AUTHOR Miller Puckette; +#X text 12 165 HELP_PATCH_AUTHORS Updated for Pd version 0.33. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 5 KEYWORDS signal nonlocal; +#X text 12 45 DESCRIPTION summing signal bus and nonlocal connection +; +#X text 12 65 INLET_0 signal; +#X text 12 145 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 477 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 504 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 566 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 216 524 428 109 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 [throw~] Related Objects; +#X obj 22 43 catch~; +#X obj 72 43 send~; +#X obj 119 43 receive~; +#X obj 181 43 inlet~; +#X obj 231 43 outlet~; +#X restore 102 597 pd Related_objects; +#X obj 78 396 cnv 17 3 70 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 451 list; +#X obj 501 9 throw~; +#X obj 73 220 throw~ signal1; +#X floatatom 224 268 0 0 0 0 - - -; +#X obj 73 243 sig~ 50; +#X obj 224 243 snapshot~; +#X obj 73 268 throw~ signal1; +#X obj 73 149 sig~ 25; +#X obj 224 168 catch~ signal1; +#X obj 267 193 loadbang; +#X obj 267 218 metro 200; +#X floatatom 358 268 0 0 0 0 - - -; +#X obj 358 243 snapshot~; +#X obj 358 168 catch~ signal2; +#X msg 89 172 set signal2; +#X msg 90 196 set signal1; +#X text 98 395 signal; +#X text 168 451 - a list will be truncated to the first item.; +#X text 98 423 float; +#X text 98 481 (none); +#X text 168 395 - an incoming signal will be sent to a [catch~] object +that shares the same name as this [throw~] object.; +#X text 11 23 summing signal bus and non-local connection; +#X text 168 423 - a float may be sent if there are no signal connections +made to the inlet of [throw~].; +#X text 67 99 Any number of [throw~] objects can add into one [catch~] +object (but two [catch~] objects cannot share the same name.); +#X text 71 295 You can redirect [throw~] via a "set" message.; +#X text 79 521 1) symbol atom; +#X text 168 521 - [throw~] takes one argument-- a symbol atom-- as +its name. Other [throw~] objects may have the same name \, but there +may only be one [catch~] that shares this name.; +#X text 151 47 For help on [catch~] \, see:; +#X obj 151 62 pddp/pddplink catch~-help.pd -text catch~-help; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 482 57 pddp/dsp; +#X connect 13 0 15 0; +#X connect 14 0 12 0; +#X connect 16 0 11 0; +#X connect 17 0 14 0; +#X connect 18 0 19 0; +#X connect 19 0 14 0; +#X connect 19 0 21 0; +#X connect 21 0 20 0; +#X connect 22 0 21 0; +#X connect 23 0 11 0; +#X connect 24 0 11 0; diff --git a/doc/pddp/time_measurements.pd b/pd/doc/5.reference/time_measurements.pd similarity index 100% rename from doc/pddp/time_measurements.pd rename to pd/doc/5.reference/time_measurements.pd diff --git a/pd/doc/5.reference/timer-help.pd b/pd/doc/5.reference/timer-help.pd index 0f7b38299..9d2a392d1 100644 --- a/pd/doc/5.reference/timer-help.pd +++ b/pd/doc/5.reference/timer-help.pd @@ -1,15 +1,169 @@ -#N canvas 440 273 514 280 10; -#X msg 60 146 bang; -#X msg 30 115 bang; -#X obj 30 175 timer; -#X obj 66 15 timer; -#X text 111 16 - measure logical time; -#X floatatom 30 206; -#X text 71 113 Click here to reset; -#X text 98 147 Click here to get elapsed logical time; -#X text 27 232 Output is in milliseconds; -#X text 6 51 The timer object measures elapsed logical time. Logical time moves forward as if all computation were instantaneous and as if all "delay" and "metro" objects were exact.; -#X text 319 260 updated for Pd version 0.25; -#X connect 0 0 2 1; -#X connect 1 0 2 0; -#X connect 2 0 5 0; +#N canvas 209 25 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 timer 3 12 0 18 +-204280 -1 0; +#X obj 0 354 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 484 259 494 368 META 0; +#X text 12 125 LIBRARY internal; +#X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 145 AUTHOR Miller Puckette; +#X text 12 205 HELP_PATCH_AUTHORS This help patch was updated for Pd +version 0.35 test 28 by Dave Sabine as part of a project called pddp +proposed by Krzysztof Czaja to build comprehensive documentation for +Pd. Jonathan Wilkes revised the patch to conform to the PDDP template +for Pd version 0.42.; +#X text 12 5 KEYWORDS control time; +#X text 12 45 DESCRIPTION measure logical time; +#X text 12 65 INLET_0 bang; +#X text 12 85 INLET_1 bang; +#X text 12 105 OUTLET_0 float; +#X text 12 185 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 470 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 512 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 539 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#X text 98 516 (none); +#N canvas 220 379 428 246 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 [timer] Related Objects; +#X obj 135 35 metro; +#X obj 72 35 realtime; +#X obj 24 35 timer; +#X obj 183 35 delay; +#X text 22 162 The best places to find information about Pd's libraries +is:; +#X text 22 182 www.puredata.org and click on "Downloads" then "Software" +; +#X text 24 197 or; +#X text 21 212 iem.kug.ac.at/pdb/; +#X text 22 120 This object is only offered in Pd only if you have downloaded +and properly installed the appropriate library. These objects may or +may not exist in a single library.; +#X text 22 70 Externals; +#X obj 24 95 pddp/helplink iemlib/t3_timer; +#X restore 102 597 pd Related_objects; +#X obj 78 363 cnv 17 3 60 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 478 float; +#X obj 78 479 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 434 cnv 17 3 25 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X text 168 478 - upon sending the "flush" message to the left inlet +\, [bag] will output each value in the order it was received.; +#X obj 503 9 timer; +#X msg 64 220 bang; +#X msg 39 108 bang; +#X obj 39 242 timer; +#X floatatom 39 264 0 0 0 0 - - -; +#X text 74 108 Click here to start or reset; +#X text 34 61 The [timer] object measures elapsed logical time. Logical +time moves forward as if all computation were instantaneous and as +if all [delay] and [metro] objects were exact.; +#X text 102 221 Click here to get elapsed logical time. Click again...and +again...to see periodic measurements from the start or reset time. +; +#X text 37 290 NOTE: Unlike most other objects in Pd \, the right inlet +of [timer] is the hot one (i.e. \, a bang to it triggers the output). +; +#X text 98 362 bang; +#X text 168 362 - an initial "bang" to the left inlet starts the timer. +Subsequent "bangs" reset the timer.; +#X text 98 433 bang; +#X text 167 433 - a bang to the right inlet causes the elapsed time +to be output (in milliseconds).; +#N canvas 94 193 428 419 Time_Objects 0; +#X text 21 38 In a fantasy world \, computers could exist somehow beyond +the restrictions of time and digital computation could be performed +in ZERO time. However \, that is not the case. Instead \, every process +within Pd and within your operating system requires at least a few +nanoseconds of your CPU's time.; +#X text 22 123 The [timer] object is like a clock that is not constrained +to the regular laws of physics and the universal space-time continuum. +It reports "time" measurements as only Pd can see them!; +#X text 23 182 The [cputime] object is like a clock that measures how +much time your CPU actually required to carry out your request. Keep +in mind however that your CPU is busy doing many things simoultaneously +\, so even though a process might take 5 minutes to complete \, your +CPU does not pay full attention to that process for the entire 5 minutes. +Instead \, it simply begins the process \, then refers back to that +process from time to time until the it is complete. In other cases +\, your CPU might require a full 5 minutes while Pd might report that +merely a few milliseconds have passed. This type of discrepancy depends +heavily on your computer's hardware and the type of processing it is +performing.; +#X text 24 341 The [realtime] object is as much like your own wrist +watch as Pd can possibly manage. It measures time according to your +operating system's internal clock.; +#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 [cputime] Why the Discrepencies Between Clocks?; +#X restore 102 548 pd Time_Objects; +#N canvas 73 72 428 495 Time_Measurements 0; +#X text 21 38 [timer] works like essentially like a stop-watch. Once +it starts \, you can continue to "poll" the [timer] to view the elapsed +time.; +#X text 20 135 As stated above \, [timer] measures "logical" time. +This value may be slightly different that CPU time or "real" time. +PD offers two objects which measure CPU time and "real" time. See the +reference documents for those objects for more information.; +#X obj 25 304 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X floatatom 25 448 0 0 0 0 - - -; +#X floatatom 110 448 0 0 0 0 - - -; +#X floatatom 172 448 0 0 0 0 - - -; +#X text 21 211 In the example below \, I've created an abstraction +which will force each of Pd's stop-watches \, [timer] [cputime] and +[realtime] to measure various processes and report the elapsed time. +Click on each [bng] to begin the process and wait for the results. +Notice the discrepancies in the results.; +#X text 23 464 Logical Time; +#X text 170 464 Real Time; +#X text 109 464 CPU Time; +#X obj 40 340 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X text 45 298 1 Measures elapsed time between two "bangs" from a [trigger] +object.; +#X text 60 332 2 Measures the amount of time Pd requires to turn on +DSP and start an oscillator.; +#X obj 84 372 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X text 21 85 The odd aspect about comparing [timer] to a stop-watch +is that a stop-watch can be stopped! [timer] can only be started or +reset. It cannot be stopped.; +#X text 105 364 3 Measures the amount of time Pd requires count to +three...please wait for approximately 3 seconds.; +#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 [timer] Related Objects; +#X obj 25 408 time_measurements; +#X connect 2 0 18 0; +#X connect 10 0 18 1; +#X connect 13 0 18 2; +#X connect 18 0 3 0; +#X connect 18 1 4 0; +#X connect 18 2 5 0; +#X restore 102 572 pd Time_Measurements; +#X text 11 23 measure logical time; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X msg 59 145 tempo 1 sec; +#X msg 67 169 tempo 2 msec; +#X text 111 266 Output defaults to milliseconds; +#X text 98 392 tempo; +#X text 152 145 set tempo in units of seconds; +#X text 152 169 set tempo in units of milliseconds; +#X text 168 392 - set tempo to some number of units (msec for short) +\, seconds (sec) \, minutes (min) or samples (samp).; +#X connect 15 0 17 1; +#X connect 16 0 17 0; +#X connect 17 0 18 0; +#X connect 31 0 17 0; +#X connect 32 0 17 0; diff --git a/pd/doc/5.reference/toggle-help.pd b/pd/doc/5.reference/toggle-help.pd index 5cb9ae75d..e365e6429 100644 --- a/pd/doc/5.reference/toggle-help.pd +++ b/pd/doc/5.reference/toggle-help.pd @@ -1,273 +1,395 @@ -#N canvas 205 140 489 376 10; -#X obj 1 1 cnv 8 100 60 empty empty toggle=tgl 20 20 1 18 -262144 -1109 -0; -#X text 21 296 (c) musil@iem.kug.ac.at; -#X text 63 309 IEM KUG; -#X text 115 41 click properties to; -#X text 103 52 modify geometry \, colors \, etc.; -#X obj 168 113 bng 15 250 50 0 empty empty empty 8 -8 0 10 -262144 +#N canvas 427 35 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 toggle 3 12 0 18 +-204280 -1 0; +#X obj 0 308 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 483 286 494 344 META 0; +#X text 12 145 LIBRARY internal; +#X text 12 45 LICENSE SIBSD; +#X text 12 165 AUTHOR Thomas Musil; +#X text 12 185 WEBSITE; +#X text 12 225 HELP_PATCH_AUTHORS Jonathan Wilkes revised the patch +to conform to the PDDP template for Pd version 0.42.; +#X text 12 25 KEYWORDS control GUI nonlocal; +#X text 12 65 DESCRIPTION gui-toggle between zero and a non-zero value +; +#X text 12 5 ALIAS tgl; +#X text 12 85 INLET_0 float bang size nonzero init send receive label +label_pos label_font color pos delta; +#X text 12 125 OUTLET_0 float; +#X text 12 205 RELEASE_DATE 2002; +#X restore 500 597 pd META; +#X obj 0 422 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 459 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 544 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#X obj 78 317 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#N canvas 207 527 428 100 Related_objects 0; +#X obj 20 53 x_all_guis bng tgl vsl hsl hradio vradio vu cnv nbx; +#X text 18 29 All iem-gui objects:; +#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 [tgl] Related Objects; +#X restore 100 597 pd Related_objects; +#X obj 78 431 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 346 167 and receive names. Right-; +#X text 346 182 click and choose; +#X text 345 198 "Properties" to set them \,; +#X text 120 255 Use the UP- \, DOWN- \, LEFT- or RIGHT-key to move +a selected gui-object. Right-click and choose "Properties" to modify +its appearance.; +#X text 346 212 or change them with messages; +#X text 346 226 (see the subpatch below); +#X text 98 361 see the following subpatch for messages that change +the gui-properties of [bng]:; +#N canvas 60 6 428 618 Changing_GUI_Properties 0; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 212 37 no init; +#X text 162 166 label; +#X msg 212 56 init 0; +#X msg 232 109 init 1; +#X msg 162 186 label blabla; +#X msg 172 236 label myToggle; +#X text 303 37 change send name; +#X text 22 166 change receive name; +#X obj 212 133 s tgl_rcv; +#X obj 304 133 s tgl_rcv; +#X obj 22 262 s tgl_rcv; +#X obj 162 262 s tgl_rcv; +#X msg 304 58 send foo6_snd; +#X msg 314 108 send tgl_snd; +#X msg 42 213 receive tgl_rcv; +#X obj 42 237 s tgl2_rcv; +#X msg 22 188 receive tgl2_rcv; +#N canvas 317 326 161 227 init 0; +#X obj 16 11 loadbang; +#X obj 16 42 f \$0; +#X msg 16 73 \; \$1-size 15 \; \$1-nonzero 1 \; \$1-lbl-x 17 \; \$1-lbl-y +7 \; \$1-font-size 10 \; \$1-xpos 336 \; \$1-ypos 500; +#X connect 0 0 1 0; +#X connect 1 0 2 0; +#X restore 311 580 pd init; +#X msg 22 109 size \$1; +#X text 21 37 dimensions; +#X obj 22 58 nbx 3 14 8 200 0 0 empty \$0-size empty 0 -8 0 12 -262144 +-1 -1 15 256 0; +#X text 69 55 size; +#X obj 22 133 s tgl_rcv; +#X obj 112 58 nbx 3 14 -1e+37 1e+37 0 0 empty \$0-nonzero empty 0 -8 +0 12 -262144 -1 -1 1 256 0; +#X obj 112 133 s tgl_rcv; +#X text 111 37 nonzero-value; +#X msg 112 109 nonzero \$1; +#X text 224 75 init value; +#X text 226 89 on loadbang; +#X text 306 165 label position; +#X text 20 302 font properties; +#X msg 308 237 label_pos \$1 \$2; +#X msg 22 374 label_font \$1 \$2; +#X text 71 326 1.font(0-2); +#X text 71 347 2.height; +#X text 357 188 1.x-offset; +#X text 357 209 2.y-offset; +#N canvas 366 206 174 259 flash-time 0; +#X obj 68 180 pack; +#X obj 103 149 t b a; +#X obj 68 205 outlet; +#X obj 103 104 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-lbl-x empty +0 -8 0 12 -262144 -1 -1 17 256 0; +#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-lbl-y empty +0 -8 0 12 -262144 -1 -1 7 256 0; +#X connect 0 0 2 0; +#X connect 1 0 0 0; +#X connect 1 1 0 1; +#X connect 3 0 0 0; +#X connect 4 0 1 0; +#X coords 0 -1 1 1 48 42 2 100 100; +#X restore 308 187 pd flash-time; +#N canvas 366 206 174 259 flash-time 0; +#X obj 68 180 pack; +#X obj 103 149 t b a; +#X obj 68 205 outlet; +#X obj 103 104 nbx 3 14 0 2 0 0 \$0-dummy \$0-font empty 0 -8 0 12 +-262144 -1 -1 0 256 0; +#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-font-size empty +0 -8 0 12 -262144 -1 -1 10 256 0; +#X connect 0 0 2 0; +#X connect 1 0 0 0; +#X connect 1 1 0 1; +#X connect 3 0 0 0; +#X connect 4 0 1 0; +#X coords 0 -1 1 1 48 42 2 100 100; +#X restore 22 324 pd flash-time; +#X text 162 302 preset-colors; +#X text 301 302 RGB-colors; +#X msg 162 409 color \$1 \$2 \$3; +#N canvas 364 205 306 317 flash-time 0; +#X obj 69 196 t b a; +#X obj 33 262 outlet; +#X obj 33 237 pack 0 0 0; +#X obj 120 197 t b a; +#X obj 103 104 nbx 3 14 0 29 0 0 \$0-dummy \$0-bg empty 0 -8 0 12 -262144 +-1 -1 0 256 0; +#X obj 103 124 nbx 3 14 0 29 0 0 \$0-dummy \$0-front empty 0 -8 0 12 +-262144 -1 -1 0 256 0; +#X obj 103 144 nbx 3 14 0 29 0 0 \$0-dummy \$0-label empty 0 -8 0 12 +-262144 -1 -1 0 256 0; +#X connect 0 0 2 0; +#X connect 0 1 2 1; +#X connect 2 0 1 0; +#X connect 3 0 2 0; +#X connect 3 1 2 2; +#X connect 4 0 2 0; +#X connect 5 0 0 0; +#X connect 6 0 3 0; +#X coords 0 -1 1 1 48 62 2 100 100; +#X restore 162 324 pd flash-time; +#N canvas 0 0 306 317 flash-time 0; +#X obj 96 521 outlet; +#X obj 162 230 t b f; +#X obj 96 268 +; +#X obj 96 293 t b f; +#X obj 96 324 +; +#X obj 19 208 * -65536; +#X obj 96 208 * -256; +#X obj 162 208 * -1; +#X obj 96 355 - 1; +#X obj 96 385 list prepend 0; +#X obj 96 410 route 0 1 2; +#X obj 96 497 pack 0 0 0; +#X obj 115 456 t b a; +#X obj 168 455 t b a; +#X obj 104 124 vradio 15 1 0 3 empty empty empty 0 -8 0 10 -262144 +-1 -1 0; +#X text 120 120 1.bg; +#X text 120 137 2.front; +#X text 120 153 3.label; +#X obj 103 105 nbx 3 14 0 255 0 0 \$0-dummy \$0-r empty 0 -8 0 10 -262144 +-258113 -1 0 256 0; +#X obj 133 105 nbx 3 14 0 255 0 0 \$0-dummy \$0-g empty 0 -8 0 10 -262144 +-13381 -1 0 256 0; +#X obj 163 105 nbx 3 14 0 255 0 0 \$0-dummy \$0-b empty 0 -8 0 10 -262144 +-4160 -1 0 256 0; +#X connect 1 0 2 0; +#X connect 1 1 2 1; +#X connect 2 0 3 0; +#X connect 3 0 4 0; +#X connect 3 1 4 1; +#X connect 4 0 8 0; +#X connect 5 0 4 0; +#X connect 6 0 2 0; +#X connect 7 0 1 0; +#X connect 8 0 9 0; +#X connect 9 0 10 0; +#X connect 10 0 11 0; +#X connect 10 1 12 0; +#X connect 10 2 13 0; +#X connect 11 0 0 0; +#X connect 12 0 11 0; +#X connect 12 1 11 1; +#X connect 13 0 11 0; +#X connect 13 1 11 2; +#X connect 14 0 9 1; +#X connect 18 0 5 0; +#X connect 19 0 6 0; +#X connect 20 0 7 0; +#X coords 0 -1 1 1 102 74 2 100 100; +#X restore 302 324 pd flash-time; +#X text 211 326 1.bg; +#X text 211 346 2.front; +#X text 211 367 3.label; +#X text 163 462 delta; +#X text 21 462 position; +#X msg 22 569 pos \$1 \$2; +#X msg 164 569 delta \$1 \$2; +#X obj 164 545 list; +#X obj 164 484 bng 20 250 50 0 empty empty empty 17 7 0 10 -262144 -1 -1; -#X obj 168 179 bng 15 250 50 0 empty empty empty 8 -8 0 10 -262144 +#X text 70 483 1.x-position; +#X text 70 505 2.y-position; +#X text 243 483 1.x-delta; +#X text 243 505 2.y-delta; +#N canvas 366 206 174 259 flash-time 0; +#X obj 68 180 pack; +#X obj 103 149 t b a; +#X obj 68 205 outlet; +#X obj 103 104 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-xpos empty 0 +-8 0 12 -262144 -1 -1 336 256 0; +#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-ypos empty 0 +-8 0 12 -262144 -1 -1 500 256 0; +#X connect 0 0 2 0; +#X connect 1 0 0 0; +#X connect 1 1 0 1; +#X connect 3 0 0 0; +#X connect 4 0 1 0; +#X coords 0 -1 1 1 48 42 2 100 100; +#X restore 22 484 pd flash-time; +#N canvas 366 206 174 259 flash-time 0; +#X obj 68 180 pack; +#X obj 103 149 t b a; +#X obj 68 205 outlet; +#X obj 103 104 nbx 3 14 -20 20 0 0 \$0-dummy \$0-xdelta empty 0 -8 +0 12 -262144 -1 -1 0 256 0; +#X obj 103 124 nbx 3 14 -20 20 0 0 \$0-dummy \$0-ydelta empty 0 -8 +0 12 -262144 -1 -1 0 256 0; +#X connect 0 0 2 0; +#X connect 1 0 0 0; +#X connect 1 1 0 1; +#X connect 3 0 0 0; +#X connect 4 0 1 0; +#X coords 0 -1 1 1 48 42 2 100 100; +#X restore 193 484 pd flash-time; +#X obj 311 467 cnv 15 102 102 empty empty empty 20 12 0 14 -1 -66577 +0; +#X obj 312 468 cnv 15 100 100 empty empty empty 20 12 0 14 -261682 +-66577 0; +#X obj 308 262 s tgl_rcv; +#X obj 22 399 s tgl_rcv; +#X obj 162 434 s tgl_rcv; +#X obj 22 594 s tgl_rcv; +#X obj 164 594 s tgl_rcv; +#X obj 336 500 tgl 15 0 tgl_snd tgl_rcv myToggle 17 7 0 10 -262144 +-1 -1 0 1; +#X obj 337 538 nbx 3 14 -1e+37 1e+37 0 0 empty empty empty 0 -8 0 12 +-262144 -1 -1 0 256 0; +#X text 6 2 [tgl] Changing Properties through Messages; +#X connect 3 0 9 0; +#X connect 4 0 9 0; +#X connect 5 0 12 0; +#X connect 6 0 12 0; +#X connect 13 0 10 0; +#X connect 14 0 10 0; +#X connect 15 0 16 0; +#X connect 17 0 11 0; +#X connect 19 0 23 0; +#X connect 21 0 19 0; +#X connect 24 0 27 0; +#X connect 27 0 25 0; +#X connect 32 0 62 0; +#X connect 33 0 63 0; +#X connect 38 0 32 0; +#X connect 39 0 33 0; +#X connect 42 0 64 0; +#X connect 43 0 42 0; +#X connect 44 0 42 0; +#X connect 50 0 65 0; +#X connect 51 0 66 0; +#X connect 52 0 51 0; +#X connect 53 0 52 0; +#X connect 58 0 50 0; +#X connect 59 0 52 1; +#X connect 67 0 68 0; +#X restore 170 394 pd Changing_GUI_Properties; +#X text 168 463 - creating a [bng] without any arguments will set default +values for all gui-properties. See the subpatch below to learn how +to dynamically instantiate a [bng] object with custom properties:; +#X obj 406 11 tgl 15 0 foo6_rcv empty empty 17 7 0 10 -262144 -1 -1 +0 1; +#X text 426 8 abbreviation: [tgl]; +#X obj 302 78 bng 15 250 50 0 empty empty empty 8 -8 0 10 -262144 -1 +-1; +#X obj 302 153 bng 15 250 50 0 empty empty empty 8 -8 0 10 -262144 -1 -1; -#X obj 168 133 s foo6_rcv; -#X obj 168 159 r foo6_snd; -#X text 153 14 gui-toggle:; -#X obj 26 270 bng 15 250 50 0 empty empty empty 8 -8 0 10 -262144 -1 +#X obj 302 103 s foo6_rcv; +#X obj 302 127 r foo6_snd; +#X obj 56 274 bng 15 250 50 0 empty empty empty 8 -8 0 10 -262144 -1 -1; -#X obj 10 117 bng 15 250 50 0 empty empty empty 8 -8 0 10 -262144 -1 +#X obj 26 124 bng 15 250 50 0 empty empty empty 8 -8 0 10 -262144 -1 -1; -#X msg 26 39 33; -#X obj 26 180 tgl 60 1 foo6_snd foo6_rcv big_toggle 63 20 194 13 -228992 +#X msg 29 65 33; +#X obj 56 184 tgl 60 1 foo6_snd foo6_rcv big_toggle 66 27 2 13 -228992 -4033 -34 1 1; -#X msg 42 79 1; -#X msg 49 99 0; -#X floatatom 26 249 4 0 0; -#X msg 33 59 -0.001; -#X msg 103 135 set 1; -#X msg 108 157 set 0; -#X obj 3 155 tgl 15 0 empty empty empty 8 -8 0 10 -262144 -1 -1 0 1 -; -#X obj 65 249 tgl 15 0 empty empty empty 8 -8 0 10 -262144 -1 -1 1 +#X msg 72 87 1; +#X msg 79 109 0; +#X floatatom 56 253 4 0 0 0 - - -, f 4; +#X msg 63 65 -0.001; +#X msg 183 123 set 1; +#X msg 188 145 set 0; +#X obj 20 159 tgl 15 0 empty empty empty 8 -8 0 10 -262144 -1 -1 0 1; -#X msg 95 114 set -0.23; -#X obj 189 93 tgl 15 0 empty empty empty 8 -8 0 10 -262144 -1 -1 0 +#X obj 95 253 tgl 15 0 empty empty empty 8 -8 0 10 -262144 -1 -1 1 1; -#X obj 188 179 tgl 15 0 empty empty empty 8 -8 0 10 -262144 -1 -1 1 +#X msg 175 101 set -0.23; +#X obj 323 59 tgl 15 0 empty empty empty 8 -8 0 10 -262144 -1 -1 0 1; -#X msg 93 93 0 3 4.55; -#X msg 85 73 0.22 0 -5.44; -#X msg 189 113 set \$1; -#X text 96 222 UP- \, DOWN- \, LEFT- or RIGHT-key; -#X text 95 233 for moving selected gui-objects; -#N canvas 440 175 699 530 edit 0; -#X msg 47 151 \; foo6_rcv color \$1 \$2 \$3; -#X obj 47 126 pack 0 0 0; -#X obj 47 98 f; -#X msg 24 50 bang; -#X floatatom 63 48 3 0 29; -#X floatatom 79 68 3 0 29; -#X floatatom 112 84 3 0 29; -#X text 91 48 background; -#X text 106 68 front-color; -#X text 140 85 label-color; -#X obj 49 223 f; -#X msg 27 202 bang; -#X floatatom 65 201 3 63 88; -#X floatatom 100 223 3 0 37; -#X obj 49 246 pack 0 0; -#X text 127 223 y-label; -#X text 93 201 x-label; -#X msg 49 271 \; foo6_rcv label_pos \$1 \$2; -#X floatatom 505 55 3 8 75; -#X text 532 55 size; -#X msg 505 76 \; foo6_rcv size \$1; -#X obj 282 182 f; -#X msg 260 161 bang; -#X floatatom 298 160 3 -10 10; -#X floatatom 333 182 3 -10 10; -#X obj 282 205 pack 0 0; -#X msg 282 230 \; foo6_rcv delta \$1 \$2; -#X obj 296 301 f; -#X msg 274 280 bang; -#X floatatom 312 279 3 20 60; -#X floatatom 347 301 3 150 200; -#X obj 296 324 pack 0 0; -#X msg 296 349 \; foo6_rcv pos \$1 \$2; -#X text 326 160 x-delta; -#X text 360 182 y-delta; -#X text 340 279 x-position; -#X text 374 301 y-position; -#X obj 305 423 f; -#X msg 283 402 bang; -#X floatatom 321 401 3 -10 10; -#X floatatom 356 423 3 -10 10; -#X obj 305 446 pack 0 0; -#X text 383 423 y-label; -#X text 349 401 x-label; -#X msg 305 471 \; foo6_rcv delta \$1 \$2; -#X msg 499 140 \; foo6_rcv send foo6a_snd; -#X msg 499 178 \; foo6_rcv send foo6_snd; -#X msg 494 216 \; foo6_rcv receive foo6a_rcv; -#X msg 494 254 \; foo6a_rcv receive foo6_rcv; -#X msg 41 448 \; foo6_rcv label blabla; -#X msg 41 484 \; foo6_rcv label big_toggle; -#X obj 69 338 f; -#X msg 47 317 bang; -#X floatatom 85 316 3 0 2; -#X floatatom 120 338 3 4 36; -#X obj 69 361 pack 0 0; -#X msg 69 386 \; foo6_rcv label_font \$1 \$2; -#X text 113 316 font; -#X text 149 338 height; -#X floatatom 498 307 5 -200 200; -#X text 542 307 nonzero-value; -#X msg 498 331 \; foo6_rcv nonzero \$1; -#X msg 503 412 \; foo6_rcv init 0; -#X msg 510 479 \; foo6_rcv init 1; -#X text 524 393 no init; -#X text 500 461 init value on loadbang; -#X msg 285 47 back; -#X msg 285 67 front; -#X msg 285 87 label; -#X msg 247 47 bang; -#N canvas 15 207 606 448 RGB_____________ 0; -#X obj 97 56 inlet; -#X obj 262 53 inlet; -#X obj 339 55 inlet; -#X obj 405 56 inlet; -#X obj 97 270 bang; -#X msg 77 295 0; -#X msg 104 295 1; -#X obj 146 268 bang; -#X msg 132 295 0; -#X msg 160 295 1; -#X obj 196 269 bang; -#X msg 187 295 0; -#X msg 214 295 1; -#X obj 265 313 spigot; -#X obj 312 313 spigot; -#X obj 359 313 spigot; -#X obj 249 385 outlet; -#X text 93 33 select; -#X text 267 28 red; -#X text 337 30 green; -#X text 409 30 blue; -#X obj 405 102 t b f; -#X obj 339 160 +; -#X obj 339 185 t b f; -#X obj 339 216 +; -#X obj 296 385 outlet; -#X obj 343 385 outlet; -#X obj 28 180 loadbang; -#X obj 97 135 route back front label bang; -#X obj 343 362 f; -#X obj 296 361 f; -#X obj 249 361 f; -#X obj 262 79 * -65536; -#X obj 339 80 * -256; -#X obj 405 80 * -1; -#X obj 339 247 - 1; -#X obj 235 168 t b b b b; -#X connect 0 0 28 0; -#X connect 1 0 32 0; -#X connect 2 0 33 0; -#X connect 3 0 34 0; -#X connect 4 0 5 0; +#X obj 322 153 tgl 15 0 empty empty empty 8 -8 0 10 -262144 -1 -1 1 +1; +#X msg 173 79 0 3 4.55; +#X msg 165 57 0.22 0 -5.44; +#X msg 323 79 set \$1; +#X text 345 151 [tgl] has settable send; +#N canvas 47 373 428 173 tgl_without_gui 0; +#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 [tgl] Build a toggle without a gui; +#X obj 58 87 == 0; +#X floatatom 22 138 3 0 0 0 - - -, f 3; +#X obj 22 43 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 -1 +-1; +#X text 96 86 toggle; +#X obj 22 87 f 1; +#X text 95 69 This works like; +#X text 97 105 without the gui.; +#X connect 2 0 6 1; #X connect 4 0 6 0; -#X connect 5 0 14 1; -#X connect 5 0 15 1; -#X connect 6 0 13 1; -#X connect 7 0 8 0; -#X connect 7 0 9 0; -#X connect 8 0 13 1; -#X connect 8 0 15 1; -#X connect 9 0 14 1; -#X connect 10 0 11 0; -#X connect 10 0 12 0; -#X connect 11 0 13 1; -#X connect 11 0 14 1; -#X connect 12 0 15 1; -#X connect 13 0 31 1; -#X connect 14 0 30 1; -#X connect 15 0 29 1; -#X connect 21 0 22 0; -#X connect 21 1 22 1; -#X connect 22 0 23 0; -#X connect 23 0 24 0; -#X connect 23 1 24 1; -#X connect 24 0 35 0; -#X connect 27 0 6 0; -#X connect 28 0 4 0; -#X connect 28 1 7 0; -#X connect 28 2 10 0; -#X connect 28 3 36 0; -#X connect 29 0 26 0; -#X connect 30 0 25 0; -#X connect 31 0 16 0; -#X connect 32 0 24 0; -#X connect 33 0 22 0; -#X connect 34 0 21 0; -#X connect 35 0 15 0; -#X connect 35 0 14 0; -#X connect 35 0 13 0; -#X connect 36 0 31 0; -#X connect 36 1 30 0; -#X connect 36 2 29 0; -#X connect 36 3 35 0; -#X restore 285 108 pd RGB_____________; -#X floatatom 327 77 3 0 255; -#X floatatom 370 77 3 0 255; -#X floatatom 413 78 3 0 255; -#X text 34 22 preset-colors; -#X text 296 19 RGB-colors; -#X text 327 59 red; -#X text 363 58 green; -#X text 411 58 blue; -#X connect 1 0 0 0; -#X connect 2 0 1 0; -#X connect 3 0 2 0; -#X connect 4 0 2 1; -#X connect 5 0 1 1; -#X connect 6 0 1 2; -#X connect 10 0 14 0; -#X connect 11 0 10 0; -#X connect 12 0 10 1; -#X connect 13 0 14 1; -#X connect 14 0 17 0; -#X connect 18 0 20 0; -#X connect 21 0 25 0; -#X connect 22 0 21 0; -#X connect 23 0 21 1; -#X connect 24 0 25 1; -#X connect 25 0 26 0; -#X connect 27 0 31 0; -#X connect 28 0 27 0; -#X connect 29 0 27 1; -#X connect 30 0 31 1; -#X connect 31 0 32 0; -#X connect 37 0 41 0; -#X connect 38 0 37 0; -#X connect 39 0 37 1; -#X connect 40 0 41 1; -#X connect 41 0 44 0; -#X connect 51 0 55 0; -#X connect 52 0 51 0; -#X connect 53 0 51 1; -#X connect 54 0 55 1; -#X connect 55 0 56 0; -#X connect 59 0 61 0; -#X connect 66 0 70 0; -#X connect 67 0 70 0; -#X connect 68 0 70 0; -#X connect 69 0 70 0; -#X connect 70 0 1 0; -#X connect 70 1 1 1; -#X connect 70 2 1 2; -#X connect 71 0 70 1; -#X connect 72 0 70 2; -#X connect 73 0 70 3; -#X restore 278 136 pd edit; -#X obj 222 276 tgl 15 0 bbb bbb empty 20 8 192 8 -262144 -1 -1 1 1 +#X connect 6 0 2 0; +#X connect 6 0 3 0; +#X restore 100 552 pd tgl_without_gui; +#X text 98 316 bang; +#X text 168 316 - toggle between zero and the non-zero value.; +#X text 98 331 float; +#X text 98 346 list; +#X text 168 346 - a list will be concatenated to the first item.; +#X text 168 331 - output the value.; +#X text 98 431 float; +#N canvas 80 194 428 314 tgl_creation_arguments 0; +#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 [tgl] Creation Arguments and Dynamic Patching; +#X text 19 38 "tgl" can be called with 14 creation arguments. These +are not "optional" - all parameters must be filled or the gui-bng will +not instantiate correctly.; +#X text 21 127 It's unclear what the Unknown value is for- it is necessary +to have it so you can specify the non-zero value.; +#X text 22 164 Click the msg-box to dynamically create a tgl:; +#X text 21 82 tgl creation arguments: Size Init sendName receiveName +Label labelXOff labelYOff Font# fontSize bgColor foregroundColor LblColor +initValue non-zeroValue; +#X obj 23 231 s pd-tgl_creation_arguments; +#X msg 23 186 obj 160 270 tgl 25 0 tgl-snd tgl-rcv Pleione 30 14 0 +20 5 18 13 0 1 \;; +#X connect 7 0 6 0; +#X restore 170 519 pd tgl_creation_arguments; +#X text 11 23 gui-toggle between zero and a non-zero value; +#X text 215 551 (c) musil@iem.kug.ac.at; +#X text 257 564 IEM KUG; +#X text 232 576 graz \, austria 2002; +#X text 98 463 14; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide ; -#X text 191 320 updated for Pd version 0.35; -#X text 38 321 graz \, austria 2002; -#X obj 127 255 x_all_guis aaa bbb ccc ddd eee fff ggg hhh iii; -#X connect 5 0 7 0; -#X connect 8 0 6 0; -#X connect 8 0 24 0; -#X connect 11 0 13 0; -#X connect 12 0 13 0; -#X connect 13 0 16 0; -#X connect 13 0 21 0; -#X connect 14 0 13 0; -#X connect 15 0 13 0; -#X connect 16 0 10 0; -#X connect 17 0 13 0; -#X connect 18 0 13 0; -#X connect 19 0 13 0; -#X connect 20 0 13 0; -#X connect 22 0 13 0; -#X connect 23 0 27 0; -#X connect 25 0 13 0; -#X connect 26 0 13 0; -#X connect 27 0 7 0; +#X connect 21 0 23 0; +#X connect 24 0 22 0; +#X connect 24 0 39 0; +#X connect 26 0 28 0; +#X connect 27 0 28 0; +#X connect 28 0 31 0; +#X connect 28 0 36 0; +#X connect 29 0 28 0; +#X connect 30 0 28 0; +#X connect 31 0 25 0; +#X connect 32 0 28 0; +#X connect 33 0 28 0; +#X connect 34 0 28 0; +#X connect 35 0 28 0; +#X connect 37 0 28 0; +#X connect 38 0 42 0; +#X connect 40 0 28 0; +#X connect 41 0 28 0; +#X connect 42 0 23 0; diff --git a/doc/pddp/touchin-help.pd b/pd/doc/5.reference/touchin-help.pd similarity index 100% rename from doc/pddp/touchin-help.pd rename to pd/doc/5.reference/touchin-help.pd diff --git a/doc/pddp/touchout-help.pd b/pd/doc/5.reference/touchout-help.pd similarity index 100% rename from doc/pddp/touchout-help.pd rename to pd/doc/5.reference/touchout-help.pd diff --git a/pd/doc/5.reference/trigger-help.pd b/pd/doc/5.reference/trigger-help.pd index 3fae71128..ddc76cc72 100644 --- a/pd/doc/5.reference/trigger-help.pd +++ b/pd/doc/5.reference/trigger-help.pd @@ -1,37 +1,391 @@ -#N canvas 58 142 685 355 12; -#X msg 28 149 2.5; -#X msg 126 151 bang; -#X msg 68 150 23 64; -#X obj 28 242 print x1; -#X obj 112 242 print x2; -#X obj 196 240 print x3; -#X obj 43 26 trigger; -#X obj 286 241 print x4; -#X text 114 27 - sequence messages in right-to-left order; -#X text 417 331 updated for Pd version 0.33; -#X text 81 290 the above can be abbreviated as:; -#X msg 172 152 symbol dog; -#X text 39 59 The trigger object outputs its input from right to left -\, converting to the types indicated by its creation arguments. There -is also a "pointer" argument type (see the pointer object.); -#X obj 381 293 t f b s l a; -#X msg 466 167 dog my cats; -#X obj 466 199 trigger bang anything; -#X obj 374 242 print x5; -#X obj 466 240 print y1; -#X obj 552 242 print y2; -#X obj 28 202 trigger float bang symbol list anything; -#X text 464 122 "anythings" can only; -#X text 461 142 be converted to bang:; -#X connect 0 0 19 0; -#X connect 1 0 19 0; -#X connect 2 0 19 0; -#X connect 11 0 19 0; -#X connect 14 0 15 0; +#N canvas 426 34 555 619 10; +#X obj 0 645 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 trigger 3 12 0 18 +-204280 -1 0; +#X obj 0 269 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 484 266 494 358 META 0; +#X text 12 135 LIBRARY internal; +#X text 12 175 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 45 LICENSE SIBSD; +#X text 12 155 AUTHOR Miller Puckette; +#X text 12 215 HELP_PATCH_AUTHORS This help patch was updated for Pd +version 0.35 test 26 by Dave Sabine as part of a project called pddp +proposed by Krzysztof Czaja to build comprehensive documentation for +Pd. Jonathan Wilkes revised the patch to conform to the PDDP template +for Pd version 0.42.; +#X text 12 65 DESCRIPTION sequence message in right-to-left order/ +convert data types; +#X text 12 95 INLET_0 anything; +#X text 12 115 OUTLET_N anything; +#X text 12 5 ALIAS t; +#X text 12 25 KEYWORDS control needs_work list_op bang_op; +#X text 12 195 RELEASE_DATE 1997; +#X restore 500 647 pd META; +#X obj 0 306 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 359 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 547 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 215 343 428 283 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 [trigger] Related Objects; +#X obj 103 43 route; +#X obj 23 43 unpack; +#X obj 69 43 pack; +#X obj 144 43 delay; +#X obj 186 43 pipe; +#X obj 221 43 float; +#X obj 261 43 int; +#X obj 290 43 symbol; +#X text 20 77 Externals; +#X text 20 128 These objects are offered in Pd only if you have downloaded +and properly installed the appropriate library. These objects may or +may not exist in a single library.; +#X text 20 187 The best places to find information about Pd's libraries +is:; +#X text 21 208 www.puredata.org and click on "Downloads" then "Software" +; +#X text 21 223 or; +#X text 21 238 iem.kug.ac.at/pdb/; +#X obj 20 104 pddp/helplink unauthorized/exciter; +#X restore 102 647 pd Related_objects; +#X obj 78 278 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 315 cnv 17 3 17 empty \$0-pddp.cnv.let.n n 5 9 0 16 -228856 +-162280 0; +#X obj 446 11 trigger; +#X obj 516 11 t; +#X text 496 11 or; +#X obj 339 568 pddp/pddplink all_about_lists_vs_anythings.pd -text +all_about_lists_vs_anythings; +#X text 98 277 anything; +#X text 168 277 - the inlet to [trigger] takes any type of message. +; +#X text 98 314 variable; +#X text 168 378 - for each creation argument \, a new outlet is created. +If no arguments are supplied \, trigger defaults to two outlets that +output bang messages.; +#X text 98 421 The [trigger] object can be abbreviated as "t" and the +creation arguments can be abbreviated as follows:; +#X obj 214 463 trigger float bang symbol list pointer anything; +#X text 315 482 is the same as; +#X obj 318 502 t f b s l p a; +#X text 97 458 "float" = f; +#X text 97 470 "bang" = b; +#X text 96 482 "symbol" = s; +#X text 97 496 "list" = l; +#X text 97 524 "anything" = a; +#X text 97 510 "pointer" = p; +#X floatatom 230 164 5 0 0 0 - - -, f 5; +#X obj 230 210 +; +#X floatatom 230 235 5 0 0 0 - - -, f 5; +#X obj 230 186 t a a; +#X text 11 23 sequence messages in right-to-left order/ convert data +types; +#X text 168 314 - upon receiving a message to its inlet \, [trigger] +outputs messages specified by the creation arguments. (Like nearly +all Pd objects \, messages are sent out from right to left.); +#N canvas 73 80 428 469 trigger_oddities 0; +#X obj 25 325 trigger anything bang float list pointer symbol; +#X obj 25 347 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 87 347 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 144 347 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 210 347 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 248 347 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 316 347 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 216 435 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 273 435 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 114 413 route float; +#X obj 114 435 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 177 435 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 304 435 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 373 435 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 28 435 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 85 435 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 28 413 route bang; +#X obj 304 413 route symbol; +#X obj 216 413 route list; +#X msg 54 201 1 2 3; +#X msg 25 104 1; +#X msg 32 129 float 2; +#X msg 39 153 test; +#X msg 46 178 symbol this; +#X msg 68 247 list 1 two 3; +#X msg 77 294 list one 2 three; +#X obj 221 390 print LIST; +#X obj 136 390 print FLOAT; +#X msg 59 226 1 two 3; +#X msg 72 271 one 2 three; +#X text 20 39 "float" is interpreted; +#X text 21 59 "symbol" is not interpreted; +#X text 22 78 "list" is interpreted \, and outputted; +#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 [trigger] Oddities; +#X connect 0 0 1 0; +#X connect 0 1 2 0; +#X connect 0 1 16 0; +#X connect 0 2 3 0; +#X connect 0 2 9 0; +#X connect 0 2 27 0; +#X connect 0 3 4 0; +#X connect 0 3 18 0; +#X connect 0 3 26 0; +#X connect 0 4 5 0; +#X connect 0 5 6 0; +#X connect 0 5 17 0; +#X connect 9 0 10 0; +#X connect 9 1 11 0; +#X connect 16 0 14 0; +#X connect 16 1 15 0; +#X connect 17 0 12 0; +#X connect 17 1 13 0; +#X connect 18 0 7 0; +#X connect 18 1 8 0; +#X connect 19 0 0 0; +#X connect 20 0 0 0; +#X connect 21 0 0 0; +#X connect 22 0 0 0; +#X connect 23 0 0 0; +#X connect 24 0 0 0; +#X connect 25 0 0 0; +#X connect 28 0 0 0; +#X connect 29 0 0 0; +#X restore 102 622 pd trigger_oddities; +#N canvas 60 35 428 634 Converting_data_types_with_trigger 0; +#X text 21 38 All sophisticated programming environments provide tools +to convert data types. For instance \, Visual Basic has:; +#X text 27 69 - VarType: to check the data type.; +#X text 27 84 - CStr: to convert a variable to a string.; +#X text 27 99 - CDate: to convert a variable to a date.; +#X text 27 114 - isNumeric: to test whether the variable is a number. +; +#X text 27 129 - etc.; +#X msg 23 255 bang; +#X msg 60 255 1; +#X floatatom 94 255 5 0 0 0 - - -, f 5; +#X msg 133 255 symbol cat; +#X msg 207 255 this is anything; +#X obj 23 304 print all_messages_are_converted_to_bangs; +#X text 20 333 Another example showing floats and symbols.; +#X msg 23 357 bang; +#X floatatom 93 357 5 0 0 0 - - -, f 5; +#X msg 135 357 symbol cat; +#X msg 209 357 this is anything; +#X obj 23 385 t f s; +#X msg 60 357 1 0; +#X obj 50 450 print converted_to_symbols; +#X obj 23 473 print converted_to_floats; +#X text 21 495 In the example above \, note that the trigger object +does not split a list among the outlets like [unpack] does. Instead +it sends all list elements through all outlets and converts them as +necessary.; +#X text 22 550 Also note that some messages don't convert as nicely +as others. Hence \, the symbol "cat" converts to a ZERO when [trigger] +converts that symbol into a float. Likewise \, all numbers will convert +to a symbol called "float" when sent through [trigger]'s right-most +outlet.; +#X obj 23 284 t b; +#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 [trigger] Converting data types; +#X text 20 151 [trigger] is one object in Pd which can convert an incoming +atom to a different type of atom. If a simple conversion is not possible +\, then trigger tries to do the next best thing (e.g. if a symbol is +passed into a [t f] \, such a symbol will be converted to a 0).; +#X text 20 222 Click on each of the messages below and watch your terminal +window for the output.; +#X text 65 384 Note that "this is anything" is converted to the most +sensible option \, which is in this case a 0 That is because it is +impossible for pd-l2ork to predict what an anything should look like +when converted into a float.; +#X connect 6 0 23 0; +#X connect 7 0 23 0; +#X connect 8 0 23 0; +#X connect 9 0 23 0; +#X connect 10 0 23 0; +#X connect 13 0 17 0; +#X connect 14 0 17 0; #X connect 15 0 17 0; -#X connect 15 1 18 0; -#X connect 19 0 3 0; -#X connect 19 1 4 0; -#X connect 19 2 5 0; -#X connect 19 3 7 0; -#X connect 19 4 16 0; +#X connect 16 0 17 0; +#X connect 17 0 20 0; +#X connect 17 1 19 0; +#X connect 18 0 17 0; +#X connect 23 0 11 0; +#X restore 102 578 pd Converting_data_types_with_trigger; +#N canvas 29 67 459 506 Triggering_messages_with_trigger 0; +#X obj 23 269 metro; +#X msg 50 247 1000; +#X obj 23 289 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 23 194 tgl 15 0 empty empty On/Off 0 -6 0 7 -262144 -1 -1 0 +1; +#X obj 23 212 t f b; +#X text 21 151 Click the toggle to set the tempo and start the [metro] +simultaneously.; +#X text 64 203 Triggers are sent from right to left...so our tempo +messages gets sent to [metro] immediately before the numbers from the +toggle to start and stop the [metro].; +#X obj 23 438 t b b; +#X msg 23 416 bang; +#X obj 23 468 timer; +#X floatatom 23 490 5 0 0 0 - - -, f 5; +#X text 57 416 Click here.; +#X text 62 489 Watch here.; +#X obj 325 560 timer; +#X floatatom 325 581 5 0 0 0 - - -, f 5; +#X obj 352 538 delay 2000; +#X text 136 430 any delay between the first bang and the second bang +; +#X text 137 446 from the trigger.; +#X text 20 540 object to force a 2 second delay between the; +#X text 138 416 In this case \, the [timer] object does not perceive +; +#X obj 325 600 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X floatatom 409 518 5 0 0 0 - - -, f 5; +#X text 19 588 at the top-right to clearly see "logical time"; +#X text 19 601 as measured by [timer].; +#X obj 325 493 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X text 20 384 Below is a simple structure which will measure the "logical +time" between "bangs" from the [trigger] object.; +#X text 20 554 first and second "bangs" sent to the [timer].; +#X text 19 574 You can reset the [delay] with the number box; +#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 [trigger] Uses; +#X text 19 623 Click on the other subpatches in the main window to +read about [trigger]'s second great purpose...; +#X obj 325 513 t; +#X text 21 81 Sequence a series of bangs - or triggers for symbols +and/or other messages. In the example below \, you should see it is +essential that [metro] gets a tempo setting before it is started--let's +assume for a moment that you wanted to start the [metro] with only +a single click.; +#X text 21 38 The [trigger] object serves two great purposes which +aren't necessarily related. Below is a description of its first purpose +; +#X text 20 305 The following example is simple \, and may not be very +practical in most situations \, but it clearly shows how [trigger] +can be used to create a simple sequence of events. It is important +to note however that the messages sent from [trigger]'s outlets occur +in ZERO time with no delay between the events...more at the top right +of the page...; +#X text 20 526 In the following exammple \, we've patched a [delay] +; +#X connect 0 0 2 0; +#X connect 1 0 0 1; +#X connect 3 0 4 0; +#X connect 4 0 0 0; +#X connect 4 1 1 0; +#X connect 7 0 9 1; +#X connect 7 1 9 0; +#X connect 8 0 7 0; +#X connect 9 0 10 0; +#X connect 13 0 14 0; +#X connect 14 0 20 0; +#X connect 15 0 13 1; +#X connect 21 0 15 1; +#X connect 24 0 31 0; +#X connect 31 0 13 0; +#X connect 31 1 15 0; +#X restore 102 556 pd Triggering_messages_with_trigger; +#N canvas 73 48 428 573 Converting_data_types_(cont.) 0; +#X msg 23 131 2.5; +#X msg 110 131 bang; +#X msg 60 131 23 64; +#X msg 153 131 symbol dog; +#X obj 23 256 trigger float bang symbol list anything; +#X text 20 38 In the example below \, you can see that this [trigger] +has creation arguments which specify what data type the object should +output through each outlet. Messages which are sent to the first outlet +will be floats \; the second outlet will send bangs \; the third \, +symbols \; etc.; +#X floatatom 23 278 5 0 0 0 - - -, f 5; +#X obj 80 278 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X symbolatom 138 322 10 0 0 0 - - -, f 10; +#X floatatom 192 187 5 0 0 0 - - -, f 5; +#X obj 192 228 pack f s; +#X msg 237 187 symbol earth; +#X msg 250 209 symbol jupiter; +#X obj 196 300 print a_list; +#X floatatom 23 463 5 0 0 0 - - -, f 5; +#X symbolatom 68 463 10 0 0 0 - - -, f 10; +#X obj 113 441 print another_list; +#X text 228 159 Click on all these.; +#X obj 23 398 r anythings; +#X text 20 346 Note how each of the messages sent to this trigger are +converted appropriately for their receiving atoms boxes. Also note +that "anythings" are sent to the example below.; +#X obj 254 278 s anythings; +#X obj 23 418 route float symbol list; +#X msg 233 131 symbol cat; +#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 [trigger] Converting data types (cont.); +#X text 20 487 Here \, we've used the [route] object to show how "anythings" +are converted as they pass through the above [trigger]. Note that all +messages converted to floats are displayed here in the number box \, +all symbols are displayed in the symbol box \, and all lists are printed +to the terminal window.; +#X connect 0 0 4 0; +#X connect 1 0 4 0; +#X connect 2 0 4 0; +#X connect 3 0 4 0; +#X connect 4 0 6 0; +#X connect 4 1 7 0; +#X connect 4 2 8 0; +#X connect 4 3 13 0; +#X connect 4 4 20 0; +#X connect 9 0 10 0; +#X connect 10 0 4 0; +#X connect 11 0 10 1; +#X connect 12 0 10 1; +#X connect 18 0 21 0; +#X connect 21 0 14 0; +#X connect 21 1 15 0; +#X connect 21 2 16 0; +#X connect 22 0 4 0; +#X restore 102 600 pd Converting_data_types_(cont.); +#X text 80 378 1) symbol atom; +#X obj 4 647 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 339 551 pddp/pddplink all_about_messages.pd -text all_about_messages +; +#X obj 291 624 pddp/pddplink ../2.control.examples/03.connections.pd +; +#X text 5 46 The [trigger] object outputs its input from right to left +\, converting to the types indicated by its creation arguments. There +is also a "pointer" argument type (see the [pointer] object). This +is particularly important because pd-l2ork \, like its pd brethren +dispatches commands from the same outlet based on the order connections +were made \, which is impossible to assess by someone who studies the +code after the fact (including its creator who revisits such a code +a month later). This is why an essential coding practice in pd-l2ork +is that whenever a signal flow splits into more than one output \, +its order of execution is strictly timed by the trigger object., f +89; +#X connect 28 0 31 0; +#X connect 29 0 30 0; +#X connect 31 0 29 0; +#X connect 31 1 29 1; diff --git a/pd/doc/5.reference/unpack-help.pd b/pd/doc/5.reference/unpack-help.pd index 5f1a41200..d13b78898 100644 --- a/pd/doc/5.reference/unpack-help.pd +++ b/pd/doc/5.reference/unpack-help.pd @@ -1,28 +1,120 @@ -#N canvas 234 84 730 277 12; -#X floatatom 80 180 0 0 0; -#X floatatom 205 180 0 0 0; -#X floatatom 243 180 0 0 0; -#X floatatom 46 180 0 0 0; -#X obj 117 180 print foo; -#X obj 133 243 pack; -#X text 51 242 See also; -#X obj 101 9 unpack; -#X text 164 8 - split a message to atoms; -#X text 196 139 <-- creation arguments specify the types of atoms expected +#N canvas 431 34 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 unpack 3 12 0 18 +-204280 -1 0; +#X obj 0 191 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 488 264 494 361 META 0; +#X text 12 105 LIBRARY internal; +#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 125 AUTHOR Miller Puckette; +#X text 12 185 HELP_PATCH_AUTHORS This help patch was updated for Pd +version 0.35 test 26 by Dave Sabine as part of a project called pddp +proposed by Krzysztof Czaja to build comprehensive documentation for +Pd. Jonathan Wilkes revised the patch to conform to the PDDP template +for Pd version 0.42.; +#X text 12 45 DESCRIPTION split a message into atoms; +#X text 12 5 KEYWORDS control list_op; +#X text 12 65 INLET_0 anything; +#X text 12 85 OUTLET_N float list symbol pointer bang; +#X text 12 165 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 391 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 444 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 546 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 220 221 428 404 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 obj 22 43 pack; +#X obj 59 43 trigger; +#X text 8 2 [unpack] Related Objects; +#X text 19 266 These objects are offered in Pd only if you have downloaded +and properly installed the appropriate library. These objects may or +may not exist in a single library.; +#X text 19 315 The best places to find information about Pd's libraries +is:; +#X text 19 335 www.puredata.org and click on "Downloads" then "Software" ; -#X msg 46 102 1 2; -#X msg 85 102 3 4 shut; -#X msg 164 102 5 6 pick 7 8; -#X text 368 239 updated for Pd version 0.33; -#X obj 46 139 unpack 0 0 s 0 0; -#X text 25 36 unpack takes lists of atoms and distributes them to its -outlets. The creation arguments specify float (any number or the symbol -'f') \, pointer (symbol 'p') or symbol (symbol 's').; -#X connect 10 0 14 0; -#X connect 11 0 14 0; -#X connect 12 0 14 0; -#X connect 14 0 3 0; -#X connect 14 1 0 0; -#X connect 14 2 4 0; -#X connect 14 3 1 0; -#X connect 14 4 2 0; +#X text 19 355 or; +#X text 19 375 iem.kug.ac.at/pdb/; +#X text 19 79 Externals; +#X obj 20 103 pddp/helplink zexy/pack~; +#X obj 20 123 pddp/helplink zexy/unpack~; +#X obj 20 143 pddp/helplink zexy/tabdump; +#X obj 20 163 pddp/helplink zexy/niagara; +#X obj 20 183 pddp/helplink zexy/packel; +#X obj 20 203 pddp/helplink zexy/repack; +#X obj 20 223 pddp/helplink zexy/drip; +#X obj 20 243 pddp/helplink zexy/sort; +#X restore 102 597 pd Related_objects; +#X obj 78 200 cnv 17 3 185 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 267 float; +#X obj 78 400 cnv 17 3 37 empty \$0-pddp.cnv.let.n n 5 9 0 16 -228856 +-162280 0; +#X obj 500 11 unpack; +#X floatatom 97 162 0 0 0 0 - - -; +#X floatatom 202 162 0 0 0 0 - - -; +#X floatatom 240 162 0 0 0 0 - - -; +#X floatatom 53 162 0 0 0 0 - - -; +#X msg 103 91 1 2; +#X msg 142 91 3 4 shut; +#X msg 221 91 5 6 pick 7 8; +#X symbolatom 129 162 10 0 0 0 - - -, f 10; +#X text 11 23 split a message into atoms; +#X text 98 297 symbol; +#X text 98 199 list; +#X text 98 340 pointer; +#X text 98 368 bang; +#X text 168 399 - if no arguments are provided \, [unpack] defaults +to two outlets. Otherwise \, one outlet is created for each creation +argument specified.; +#X obj 373 128 unpack; +#X msg 373 91 60 127; +#X floatatom 373 162 3 0 0 0 - - -, f 3; +#X floatatom 406 162 3 0 0 0 - - -, f 3; +#X text 168 199 - the elements will be distributed to the outlets. +The type of each element must match the arguments supplied to [unpack] +\, or a "type mismatch" error will result. Lists with more (or fewer) +elements than the total number of outlets are accepted.; +#X text 100 60 [unpack] takes a list and distributes the elements to +its outlets.; +#X text 80 463 1) float; +#X text 98 477 symbol atom; +#X text 97 550 [unpack] only checks the first letter of each symbol +atom in its arguments \, so both "f" and "float" will specify float +type (so will "foo" \, for that matter).; +#X text 168 267 - if no arguments are given \, or if the first argument +is an "f" \, a float will be accepted and sent to the left outlet. +; +#X obj 103 128 unpack 0 0 s f f; +#X text 168 297 - if the first argument to [unpack] is "s" \, a symbol +message will be sent to the left outlet. Symbol atoms are also accepted +and given the "symbol" selector when output.; +#X text 168 340 - if the first argument to [unpack] is "p" \, a pointer +will be accepted and sent to the left outlet; +#X text 168 368 - a bang to the inlet has no apparent effect.; +#X text 168 463 - one outlet is created for each argument specified. +(If no arguments are provided \, [unpack] will accept a list with two +floats.) Each symbolic argument specifies the type of atom expected +in the incoming list. Acceptable arguments are: "f" for float \, "p" +for pointer \, and "s" for symbol. You can also use a float (e.g. \, +"o") to specify float.; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X connect 16 0 36 0; +#X connect 17 0 36 0; +#X connect 18 0 36 0; +#X connect 26 0 28 0; +#X connect 26 1 29 0; +#X connect 27 0 26 0; +#X connect 36 0 15 0; +#X connect 36 1 12 0; +#X connect 36 2 19 0; +#X connect 36 3 13 0; +#X connect 36 4 14 0; diff --git a/pd/doc/5.reference/until-help.pd b/pd/doc/5.reference/until-help.pd index 9da7a9cec..7ee720b82 100644 --- a/pd/doc/5.reference/until-help.pd +++ b/pd/doc/5.reference/until-help.pd @@ -1,25 +1,162 @@ -#N canvas 142 97 410 273 10; -#X msg 65 116 bang; -#X obj 66 15 until; -#X text 114 16 - LOOP; -#X text 24 36 The until object's left inlet starts a loop in which it outputs "bang" until its right inlet gets a bang which stops it. If you start "until" with a number \, it iterates at most that number of times \, as in the Max "uzi" object.; -#X text 24 85 WARNING: if you bang an "until" which doesn't have a stopping mechanism \, Pd goes into an infinite loop!; -#X obj 65 168 until; -#X text 110 115 start; -#X msg 73 137 3; -#X text 109 138 start limited to 3 iterations; -#X obj 65 196 f; -#X obj 96 198 + 1; -#X obj 140 198 sel 0; -#X obj 65 240 print; -#X obj 96 219 mod 10; -#X text 225 247 updated for Pd version 0.28; -#X connect 0 0 5 0; -#X connect 5 0 9 0; -#X connect 7 0 5 0; -#X connect 9 0 10 0; -#X connect 9 0 12 0; -#X connect 10 0 13 0; -#X connect 11 0 5 1; +#N canvas 428 32 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 until 3 12 0 18 +-204280 -1 0; +#X obj 0 346 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 485 256 494 367 META 0; +#X text 12 125 LIBRARY internal; +#X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 145 AUTHOR Miller Puckette; +#X text 12 205 HELP_PATCH_AUTHORS This help patch was updated for Pd +version 0.35 test 26 by Dave Sabine as part of a project called pddp +proposed by Krzysztof Czaja to build comprehensive documentation for +Pd. Jonathan Wilkes revised the patch to conform to the PDDP template +for Pd version 0.42.; +#X text 12 45 DESCRIPTION looping mechanism; +#X text 12 65 INLET_0 float bang; +#X text 12 105 OUTLET_0 bang; +#X text 12 85 INLET_1 bang; +#X text 12 5 KEYWORDS control bang_op; +#X text 12 185 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 435 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 472 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 500 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#X text 98 476 (none); +#N canvas 213 464 428 159 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 [until] Related Objects; +#X text 19 38 External Objects; +#X obj 21 57 pddp/helplink iemlib/for++; +#X obj 21 77 pddp/helplink cyclone/counter; +#X obj 21 97 pddp/helplink gem_counter; +#X text 123 97 <-- Which library?; +#X obj 21 117 pddp/helplink iemlib/modulo_counter; +#X restore 102 597 pd Related_objects; +#X obj 78 355 cnv 17 3 45 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 444 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 407 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X obj 499 11 until; +#X obj 37 195 until; +#X msg 37 172 100; +#X obj 37 246 print i; +#X text 11 23 looping mechanism; +#X text 98 406 bang; +#X text 167 406 - a bang to the right inlet ends the loop.; +#X text 98 354 bang; +#X text 98 374 float; +#X text 168 354 - a bang to the left inlet starts the loop.; +#X text 168 374 - sending a float to the left inlet will cause [until] +to iterate that number of times.; +#X text 98 443 bang; +#X obj 37 221 f; +#X obj 67 221 + 1; +#X text 117 98 If you start [until] with a number \, it iterates that +number of times. The [uzi] object in MAX works the same way.; +#X obj 119 176 until; +#X msg 119 129 100; +#X obj 119 196 print i; +#X msg 149 136 3; +#X msg 179 143 42; +#N canvas 86 234 428 358 Infinite_loops 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 [until] Infinite loops; +#X msg 23 61 bang; +#X obj 23 81 until; +#X obj 23 101 print; +#X text 61 61 DO NOT CLICK. DO NOT CLICK. DO NOT CLICK.; +#X text 20 126 The [until] object's left inlet starts a loop in which +it outputs "bang" until its right inlet gets a "bang" which stops it. +; +#X text 64 81 If you click \, kill Pd or reboot the computer.; +#X msg 72 241 bang; +#X obj 72 262 until; +#X text 103 241 start; +#X obj 72 284 f; +#X obj 101 284 + 1; +#X obj 147 286 sel 0; +#X obj 72 328 print; +#X obj 101 306 mod 10; +#X text 20 189 The example below includes a method to stop the loop +to prevent Pd from looping infinitely.; +#X text 20 37 How to FREEZE Pd; +#X connect 2 0 3 0; +#X connect 3 0 4 0; +#X connect 8 0 9 0; +#X connect 9 0 11 0; +#X connect 11 0 12 0; +#X connect 11 0 14 0; +#X connect 12 0 15 0; #X connect 13 0 9 1; -#X connect 13 0 11 0; +#X connect 15 0 11 1; +#X connect 15 0 13 0; +#X restore 102 533 pd Infinite_loops; +#N canvas 106 85 428 440 Loops 0; +#X text 20 38 Every modern programming language will have various "looping" +mechanisms: either in the form of an object \, or as a data structure. +For example in Visual Basic:; +#X text 31 105 DO UNTIL i = 100; +#X text 31 119 i = i + 1; +#X text 32 90 i = 0; +#X text 31 134 LOOP; +#X text 20 245 And now Pd's version of the above programming structures: +; +#X obj 29 322 until; +#X obj 29 382 print i; +#X text 20 160 OR:; +#X text 30 186 FOR i = 0 TO 100; +#X text 29 212 NEXT; +#X text 30 200 ' do something; +#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 [until] More about loops; +#X obj 239 292 until; +#X msg 239 272 100; +#X obj 239 312 print i; +#X text 139 289 OR:; +#X obj 29 352 f; +#X obj 57 352 + 1; +#X msg 29 268 100; +#X obj 29 291 t a b; +#X obj 70 322 0; +#X connect 6 0 18 0; +#X connect 14 0 16 0; +#X connect 15 0 14 0; +#X connect 18 0 19 0; +#X connect 18 0 7 0; +#X connect 19 0 18 1; +#X connect 20 0 21 0; +#X connect 21 0 6 0; +#X connect 21 1 22 0; +#X connect 22 0 18 1; +#X restore 102 509 pd Loops; +#X text 116 216 If you start [until] with a "bang" \, it will begin +an infinite loop! Please plan ahead in this case so that there is a +mechanism in place to stop the loop - otherwise Pd will effectively +freeze. (See the "Loops" subpatch below.); +#X obj 102 555 pddp/pddplink all_about_looping.pd -text all_about_looping +; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 102 572 pddp/pddplink ../2.control.examples/24.loops.pd -text +doc/2.control.examples/24.loops.pd; +#X connect 13 0 24 0; +#X connect 14 0 13 0; +#X connect 24 0 15 0; +#X connect 24 0 25 0; +#X connect 25 0 24 1; +#X connect 27 0 29 0; +#X connect 28 0 27 0; +#X connect 30 0 27 0; +#X connect 31 0 27 0; diff --git a/pd/doc/5.reference/value-help.pd b/pd/doc/5.reference/value-help.pd index 66c457a33..313501489 100644 --- a/pd/doc/5.reference/value-help.pd +++ b/pd/doc/5.reference/value-help.pd @@ -1,30 +1,142 @@ -#N canvas 257 45 500 281 12; -#X text 290 257 updated for Pd version 0.32; -#X floatatom 36 55 5 0 0; -#X text 50 249 abbreviation:; -#X text 79 10 -- nonlocal shared value (named variable); -#X floatatom 36 130 5 0 0; -#X msg 46 78 bang; -#X obj 21 10 value; -#X obj 36 105 value help-value1; -#X obj 149 248 v; -#X floatatom 163 55 5 0 0; -#X floatatom 163 130 5 0 0; -#X msg 173 78 bang; -#X obj 163 105 value help-value1; -#X floatatom 291 55 5 0 0; -#X floatatom 291 130 5 0 0; -#X msg 301 78 bang; -#X obj 291 105 value help-value2; -#X text 31 171 "Value" stores a numeric value which is shared between all values with the same name (which need not be in the same Pd window.); -#X text 345 54 numbers set the value; -#X text 349 77 bang retrieves it; -#X connect 1 0 7 0; -#X connect 5 0 7 0; -#X connect 7 0 4 0; -#X connect 9 0 12 0; -#X connect 11 0 12 0; -#X connect 12 0 10 0; -#X connect 13 0 16 0; -#X connect 15 0 16 0; -#X connect 16 0 14 0; +#N canvas 430 37 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 value 3 12 0 18 +-204280 -1 0; +#X obj 0 284 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 488 240 494 391 META 0; +#X text 12 125 LIBRARY internal; +#X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 45 LICENSE SIBSD; +#X text 12 145 AUTHOR Miller Puckette; +#X text 12 205 HELP_PATCH_AUTHORS This help patch was updated for Pd +version 0.35 test 26 by Dave Sabine as part of a project called pddp +proposed by Krzysztof Czaja to build comprehensive documentation for +Pd. Jonathan Wilkes revised the patch to conform to the PDDP template +for Pd version 0.42.; +#X text 12 25 KEYWORDS control storage nonlocal; +#X text 12 65 DESCRIPTION nonlocal shared value (named variable); +#X text 12 5 ALIAS v; +#X text 12 85 INLET_0 float bang; +#X text 12 105 OUTLET_0 float; +#X text 12 185 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 379 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 525 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 218 491 428 139 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 [value] Related Objects; +#X obj 23 43 send; +#X obj 56 43 receive; +#X text 20 76 External Objects; +#X obj 110 43 expr; +#X obj 20 96 pddp/helplink motex/getenv; +#X restore 102 597 pd Related_objects; +#X obj 78 293 cnv 17 3 75 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 322 float; +#X text 98 352 list; +#X text 98 387 float; +#X obj 78 388 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 456 11 value; +#X obj 516 11 v; +#X text 494 11 or; +#X text 11 23 nonlocal shared value (named variable); +#N canvas 57 148 428 418 scope 0; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 20 38 Understanding "scope" is important while developing programmatic +applications. In Pd there are three levels of "scope":; +#X text 31 81 1 Local Scope: all objects \, subroutines \, data \, +and variables which exist within a single patch on a single computer +and do not communicate with other active Pd patches.; +#X text 29 137 2 Global Scope: all objects \, subroutines \, data and +variables which exist within single or multiple patches on a single +computer which communicate with other active Pd patches.; +#X text 20 260 As a general rule \, all things are considered "local" +in Pd and if communication between Pd windows is necessary \, then +[send]/[receive] \, or [throw]/[catch] objects are used. Likewise \, +if communication is necessary between many computers running Pd \, +then objects such as [netsend]/[netreceive] are used.; +#X text 20 347 The exception to the above rule is [value]. This object +is a container which makes its data known to all [value] objects of +the same name in all active Pd windows on a single computer: hence +\, GLOBAL scope.; +#X text 30 199 3 Network (Universal) Scope: all objects \, subroutines +\, data and variables which exist within single or multiple patches +on two or more computers which communicate with other active Pd patches +via a network.; +#X text 8 2 [value] Scope in Pd; +#X restore 102 574 pd scope; +#X text 98 47 [value] is a container. It holds a global variable numeric +value and can be "polled" at any time with a "bang" message. In other +words \, [value] is a place where numbers can be stored and then accessed +by all active Pd windows.; +#N canvas 73 60 428 231 global_values 0; +#X obj 173 168 v my_variable; +#X floatatom 173 190 5 0 0 0 - - -, f 5; +#X obj 173 127 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X floatatom 191 145 5 0 0 0 - - -, f 5; +#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 [value] Sub-patch to demonstrate global values; +#X text 20 38 To show how global scope works \, "bang" the [value] +object to retreive the current number. While you're in the sub-patch +\, change the number and then return to the main patch window and click +the "bang". You'll quickly see how this variable can be retreived or +reset in any active Pd window.; +#X connect 0 0 1 0; +#X connect 2 0 0 0; +#X connect 3 0 0 0; +#X restore 101 261 pd global_values; +#X text 16 102 To assign a numeric value to that variable \, a number +box or message can be used \, as follows:; +#X obj 19 179 value my_variable; +#X msg 37 156 42; +#X floatatom 19 203 5 0 0 0 - - -, f 5; +#X floatatom 19 136 5 0 0 0 - - -, f 5; +#X obj 271 188 value my_variable; +#X floatatom 271 212 5 0 0 0 - - -, f 5; +#X obj 271 168 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X text 63 135 play with me; +#X text 62 155 or click me; +#X text 186 133 Notice that the number is not outputted to the outlet +\; it is merely stored. To retreive the number \, send a "bang" \, +like below:; +#X text 168 322 - a float to the inlet sets all [value] objects that +share the same name to the incoming value.; +#X text 168 352 - a list is truncated to the first element.; +#X text 98 292 bang; +#X text 168 292 - sending a bang to a particular [value] object will +cause it to output its current value.; +#X text 168 387 - the current value is output when a bang is received +at the inlet.; +#X text 98 229 All [value] objects with the same name receive the value +(see subpatch below):; +#X text 168 491 If no creation argument is given \, then the object +will communicate with all other [value] objects with no name.; +#X text 99 529 [value] variables may be used within all [expr] family +objects. See the help patches for [expr] \, [expr~] and [fexpr~] for +more information.; +#X text 80 439 1) symbol atom; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X text 168 439 - [value] takes one argument (a symbol) that is the +name of the object. All [value] objects that share this name will have +their values updated when a float is sent to the inlet of any of them. +; +#X obj 193 574 pddp/pddplink all_about_expr_and_value.pd; +#X connect 21 0 23 0; +#X connect 22 0 21 0; +#X connect 24 0 21 0; +#X connect 25 0 26 0; +#X connect 27 0 25 0; diff --git a/pd/doc/5.reference/vcf~-help.pd b/pd/doc/5.reference/vcf~-help.pd index d3a100e75..4e4ff549d 100644 --- a/pd/doc/5.reference/vcf~-help.pd +++ b/pd/doc/5.reference/vcf~-help.pd @@ -1,36 +1,94 @@ -#N canvas 0 0 644 422 12; -#X obj 257 200 sig~; -#X text 14 193 test signal; -#X text 100 341 amp in (db); -#X text 92 144 test frequency; -#X text 224 340 amp out (db); -#X text 246 144 center frequency; -#X text 374 184 q; -#X floatatom 122 168 5 0 0 0 - - -; -#X floatatom 257 171 5 0 0 0 - - -; -#X obj 122 193 osc~; -#X floatatom 353 203 5 0 0 0 - - -; -#X obj 122 291 env~ 8192; -#X obj 220 290 env~ 8192; -#X floatatom 121 318 5 0 0 0 - - -; -#X floatatom 220 319 5 0 0 0 - - -; -#X obj 80 13 vcf~; -#X text 135 13 -- voltage-controlled bandpass filter; -#X text 26 395 see also:; -#X obj 115 394 bp~; -#X text 302 394 updated for Pd version 0.35; -#X text 12 45 vcf~ is like bp~ except that it takes an audio signal +#N canvas 430 37 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 vcf~ 3 12 0 18 -204280 +-1 0; +#X obj 0 376 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 485 226 494 409 META 0; +#X text 12 165 LIBRARY internal; +#X text 12 205 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 185 AUTHOR Miller Puckette; +#X text 12 245 HELP_PATCH_AUTHORS Updated for Pd version 0.35. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 5 KEYWORDS signal filter; +#X text 12 45 DESCRIPTION voltage-controlled bandpass filter; +#X text 12 65 INLET_0 signal; +#X text 12 105 INLET_2 float; +#X text 12 85 INLET_1 signal; +#X text 12 125 OUTLET_0 signal; +#X text 12 145 OUTLET_1 signal; +#X text 12 225 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 468 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 525 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 566 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 216 524 428 109 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 obj 22 43 bp~; +#X text 8 2 [vcf~] Related Objects; +#X restore 102 597 pd Related_objects; +#X obj 78 385 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 477 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 413 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X obj 501 9 vcf~; +#X obj 78 440 cnv 17 3 17 empty \$0-pddp.cnv.let.2 2 5 9 0 16 -228856 +-162280 0; +#X text 98 439 float; +#X text 98 476 signal; +#X text 98 384 signal; +#X text 98 412 signal; +#X obj 261 141 sig~; +#X text 68 141 test signal; +#X text 125 235 amp in (db); +#X text 116 96 test frequency; +#X text 248 233 amp out (db); +#X text 230 96 center frequency; +#X text 344 140 q; +#X floatatom 146 120 5 0 0 0 - - -, f 5; +#X floatatom 261 120 5 0 0 0 - - -, f 5; +#X obj 146 141 osc~; +#X floatatom 308 141 5 0 0 0 - - -, f 5; +#X obj 146 190 env~ 8192; +#X obj 244 190 env~ 8192; +#X floatatom 146 212 5 0 0 0 - - -, f 5; +#X floatatom 244 212 5 0 0 0 - - -, f 5; +#X obj 244 168 vcf~ 1; +#X text 293 167 optional argument to initialize q; +#X text 11 23 voltage-controlled bandpass filter; +#X text 167 412 - center frequency \, which may change continuously +in time.; +#X text 167 439 - change the "Q \, " or filter sharpness.; +#X text 168 384 - the incoming signal to be filtered; +#X text 168 543 - [vcf~] takes one argument to initialize q.; +#X text 80 543 1) float; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 478 58 pddp/dsp; +#X text 168 476 - the filtered signal (real part).; +#X obj 78 500 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X text 98 499 signal; +#X text 168 499 - the filtered signal (imaginary part).; +#X text 76 283 [vcf~] is like [bp~] except that it takes an audio signal to set center frequency \, which may thus change continuously in time. The "Q" or filter sharpness is still only set by messages. More expensive than bp~ in CPU time but more powerful too.; -#X obj 220 264 vcf~ 1; -#X text 286 264 optional argument to initialize q; -#X connect 0 0 21 1; -#X connect 7 0 9 0; -#X connect 8 0 0 0; -#X connect 9 0 11 0; -#X connect 9 0 21 0; -#X connect 10 0 21 2; -#X connect 11 0 13 0; -#X connect 12 0 14 0; -#X connect 21 0 12 0; +#X connect 17 0 32 1; +#X connect 24 0 26 0; +#X connect 25 0 17 0; +#X connect 26 0 28 0; +#X connect 26 0 32 0; +#X connect 27 0 32 2; +#X connect 28 0 30 0; +#X connect 29 0 31 0; +#X connect 32 0 29 0; diff --git a/pd/doc/5.reference/vdial-help.pd b/pd/doc/5.reference/vdial-help.pd index 048c4c2b2..5990e567c 100644 --- a/pd/doc/5.reference/vdial-help.pd +++ b/pd/doc/5.reference/vdial-help.pd @@ -1,4 +1,4 @@ -#N canvas 106 314 558 455 10; +#N canvas 432 36 558 455 10; #X obj 1 1 cnv 8 100 60 empty empty vdial=vdl 20 20 1 18 -262144 -1109 0; #X text 13 390 (c) musil@iem.kug.ac.at; @@ -10,20 +10,20 @@ #X obj 21 54 bng 15 250 50 0 empty empty empty 8 -8 0 10 -262144 -1 -1; #X msg 41 319 \$1; -#X floatatom 41 341 4 0 0; +#X floatatom 41 341 4 0 0 0 - - -, f 4; #X obj 41 363 bng 15 250 50 0 empty empty empty 8 -8 0 10 -262144 -1 -1; #X obj 86 338 tgl 12 0 empty empty empty 8 -8 0 10 -262144 -1 -1 0 1; #X obj 86 317 route 0 1 2 3 4 5 6 7 8 9; #X msg 194 92 set \$1; -#X floatatom 194 71 4 0 9; -#X floatatom 44 54 4 0 9; +#X floatatom 194 71 4 0 9 0 - - -, f 4; +#X floatatom 44 54 4 0 9 0 - - -, f 4; #X msg 91 41 7 0 -5.44; #X msg 95 63 3 3 4.55; #X obj 103 338 tgl 12 0 empty empty empty 8 -8 0 10 -262144 -1 -1 0 1; -#X obj 120 338 tgl 12 0 empty empty empty 8 -8 0 10 -262144 -1 -1 1 +#X obj 120 338 tgl 12 0 empty empty empty 8 -8 0 10 -262144 -1 -1 0 1; #X obj 137 338 tgl 12 0 empty empty empty 8 -8 0 10 -262144 -1 -1 0 1; @@ -40,31 +40,31 @@ #X obj 239 338 tgl 12 0 empty empty empty 8 -8 0 10 -262144 -1 -1 0 1; #X obj 79 355 print; -#X floatatom 183 287 4 0 0; +#X floatatom 183 287 4 0 0 0 - - -, f 4; #X msg 183 261 \$1; #X msg 158 192 set \$1; -#X floatatom 158 171 4 0 9; +#X floatatom 158 171 4 0 9 0 - - -, f 4; #X text 125 355 UP- \, DOWN- \, LEFT- or RIGHT-key; #X text 124 366 for moving selected gui-objects; #N canvas 230 247 699 530 edit 0; #X obj 42 198 f; #X msg 20 177 bang; -#X floatatom 58 176 3 63 156; -#X floatatom 93 198 3 -20 37; +#X floatatom 58 176 3 63 156 0 - - -, f 3; +#X floatatom 93 198 3 -20 37 0 - - -, f 3; #X obj 42 221 pack 0 0; #X text 120 198 y-label; #X text 86 176 x-label; -#X floatatom 270 187 3 8 50; +#X floatatom 270 187 3 8 50 0 - - -, f 3; #X text 297 187 size; #X obj 286 293 f; #X msg 264 272 bang; -#X floatatom 302 271 3 -10 10; -#X floatatom 337 293 3 -10 10; +#X floatatom 302 271 3 -10 10 0 - - -, f 3; +#X floatatom 337 293 3 -10 10 0 - - -, f 3; #X obj 286 316 pack 0 0; #X obj 300 412 f; #X msg 278 391 bang; -#X floatatom 316 390 3 20 60; -#X floatatom 351 412 3 100 200; +#X floatatom 316 390 3 20 60 0 - - -, f 3; +#X floatatom 351 412 3 100 200 0 - - -, f 3; #X obj 300 435 pack 0 0; #X text 330 271 x-delta; #X text 364 293 y-delta; @@ -72,22 +72,22 @@ #X text 378 412 y-position; #X obj 62 313 f; #X msg 40 292 bang; -#X floatatom 78 291 3 0 2; -#X floatatom 113 313 3 4 36; +#X floatatom 78 291 3 0 2 0 - - -, f 3; +#X floatatom 113 313 3 4 36 0 - - -, f 3; #X obj 62 336 pack 0 0; #X text 106 291 font; #X text 142 313 height; #X text 504 293 no init; #X text 475 348 init value on loadbang; -#X floatatom 482 228 5 2 20; +#X floatatom 482 228 5 2 20 0 - - -, f 5; #X text 491 417 changing-behavior; #X text 526 228 number of buttons; #X obj 47 104 pack 0 0 0; #X obj 47 76 f; #X msg 24 28 bang; -#X floatatom 63 26 3 0 29; -#X floatatom 79 46 3 0 29; -#X floatatom 112 62 3 0 29; +#X floatatom 63 26 3 0 29 0 - - -, f 3; +#X floatatom 79 46 3 0 29 0 - - -, f 3; +#X floatatom 112 62 3 0 29 0 - - -, f 3; #X text 91 26 background; #X text 106 46 front-color; #X text 140 63 label-color; @@ -180,9 +180,9 @@ #X connect 36 2 29 0; #X connect 36 3 35 0; #X restore 285 86 pd RGB_____________; -#X floatatom 327 55 3 0 255; -#X floatatom 370 55 3 0 255; -#X floatatom 413 56 3 0 255; +#X floatatom 327 55 3 0 255 0 - - -, f 3; +#X floatatom 370 55 3 0 255 0 - - -, f 3; +#X floatatom 413 56 3 0 255 0 - - -, f 3; #X text 34 0 preset-colors; #X text 296 -3 RGB-colors; #X text 327 37 red; @@ -254,6 +254,7 @@ ; #X obj 158 213 s foo12_rcv; #X obj 159 239 r foo12_snd; +#X text 225 418 KEYWORDS deprecated; #X connect 6 0 38 0; #X connect 7 0 8 0; #X connect 8 0 9 0; diff --git a/pd/doc/5.reference/vd~-help.pd b/pd/doc/5.reference/vd~-help.pd index 5a36ff73b..705191787 100644 --- a/pd/doc/5.reference/vd~-help.pd +++ b/pd/doc/5.reference/vd~-help.pd @@ -1,19 +1,93 @@ -#N canvas 109 10 654 410 12; -#X floatatom 50 194 0 0 0; -#X obj 50 287 outlet~; -#X text 130 286 signal output (delayed signal); -#X obj 24 16 vd~; -#X text 60 9 reads a signal from a delay line at a variable delay time (4-point-interpolation); -#X obj 50 222 sig~; -#X text 99 219 signal input (delay time in ms); -#X obj 50 254 vd~ del_example; -#X text 193 252 creation argument: name of delay line; -#X text 31 51 vd~ implements a 4-point interpolating delay tap from a corresponding delwrite~ object. The delay in milliseconds of the tap is specified by the incoming signal.; -#X text 35 340 see also:; -#X obj 123 343 delwrite~; -#X obj 212 342 delread~; -#X text 354 373 updated for Pd version 0.33; -#X text 28 103 The delay time is always at least one sample and at most the length of the delay line (specified by hte delwrite~). In addition \, in case the delwrite~ runs later in the DSP loop than the vd~ \, the delay is constrained below by one vector length (64 samples.); -#X connect 0 0 5 0; -#X connect 5 0 7 0; -#X connect 7 0 1 0; +#N canvas 430 33 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 vd~ 3 12 0 18 -204280 +-1 0; +#X obj 0 369 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 486 282 494 344 META 0; +#X text 12 115 LIBRARY internal; +#X text 12 155 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 135 AUTHOR Miller Puckette; +#X text 12 195 HELP_PATCH_AUTHORS Updated for Pd version 0.33. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 5 KEYWORDS signal nonlocal time; +#X text 12 45 DESCRIPTION read a signal from a delay line at a variable +delay time; +#X text 12 75 INLET_0 signal; +#X text 12 95 OUTLET_0 signal; +#X text 12 175 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 444 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 497 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 538 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 218 514 428 109 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 obj 22 43 delwrite~; +#X obj 92 43 delread~; +#X text 8 2 [vd~] Related Objects; +#X obj 159 44 delay; +#X restore 102 597 pd Related_objects; +#X obj 78 378 cnv 17 3 55 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 453 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 324 138 sig~; +#X text 98 377 signal; +#X text 98 397 float; +#X text 98 416 list; +#X text 11 23 reads a signal from a delay line at a variable delay +time; +#X text 165 343 NOTE: [vd~] uses 4-point-interpolation; +#X text 98 452 signal; +#X text 168 452 - the signal from the corresponding [delwrite~] object +is interpolated and output after the delay specified by the incoming +signal.; +#X text 168 515 - the name of the corresponding [delwrite~] object +; +#X text 168 416 - a list is truncated to the first element.; +#X text 168 377 - incoming signal (delay time in ms).; +#X text 168 397 - delay time in ms.; +#X text 80 515 1) symbol atom; +#X obj 101 160 delwrite~ vd~help_example 1000; +#X obj 324 160 vd~ vd~help_example; +#X text 98 67 [vd~] implements a 4-point interpolating delay tap from +a corresponding delwrite~ object. The delay in milliseconds of the +tap is specified by the incoming signal.; +#X floatatom 324 115 5 0 0 0 - - -, f 5; +#X obj 324 230 snapshot~; +#X obj 333 204 metro 150; +#X obj 333 182 loadbang; +#X floatatom 324 252 5 0 0 0 - - -, f 5; +#X floatatom 101 139 5 0 0 0 - - -, f 5; +#X msg 369 115 1000; +#X text 98 274 The delay time is always at least one sample and at +most the length of the delay line (specified by [delwrite~]). In addition +\, in case the [delwrite~] runs later in the DSP loop than the [vd~] +\, the delay is constrained below by one vector length (64 samples.) +; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 480 53 pddp/dsp; +#X obj 98 543 pddp/pddplink ../3.audio.examples/G03.delay.variable.pd +-text doc/3.audio.examples/G03.delay.variable.pd; +#X obj 98 558 pddp/pddplink ../3.audio.examples/G04.control.blocksize.pd +-text doc/3.audio.examples/G04.control.blocksize.pd; +#X obj 98 573 pddp/pddplink ../3.audio.examples/G05.execution.order.pd +-text doc/3.audio.examples/G05.execution.order.pd; +#X obj 519 12 vd~; +#X text 484 5; +#X connect 10 0 24 0; +#X connect 24 0 27 0; +#X connect 26 0 10 0; +#X connect 27 0 30 0; +#X connect 28 0 27 0; +#X connect 29 0 28 0; +#X connect 31 0 23 0; +#X connect 32 0 10 0; diff --git a/pd/doc/5.reference/vline~-help.pd b/pd/doc/5.reference/vline~-help.pd index 4e4fc8809..e1d355e2b 100644 --- a/pd/doc/5.reference/vline~-help.pd +++ b/pd/doc/5.reference/vline~-help.pd @@ -1,46 +1,100 @@ -#N canvas 273 80 815 504 12; -#X obj 55 458 snapshot~; -#X floatatom 55 481 5 0 0 0 - - -; -#X obj 65 431 metro 100; -#X obj 65 406 r start; -#X msg 550 21 \; pd dsp 1 \; start bang; -#X msg 55 241 1 1000; -#X msg 83 357 stop; -#X msg 72 288 0; -#X text 644 36 Click to start; -#X text 639 94 Click to stop; -#X text 207 457 see also:; -#X obj 293 459 line; -#X msg 550 75 \; pd dsp 0 \; start 0; -#X text 561 465 updated for version 0.33; -#X obj 339 459 line~; -#X obj 21 7 vline~; -#X text 85 7 - high-precision audio ramp generator; -#X obj 55 383 vline~; -#X text 15 44 The vline~ object \, like line~ \, generates linear ramps -whose levels and timing are determined by messages you send it. The -messages consist of a target value \, a time interval (zero if not -supplied) \, and an initial delay (also zero if not supplied.) Ramps -may start and stop between audio samples \, in which case the output -is interpolated accordingly.; -#X text 15 155 Any number of future ramps may be scheduled and vline~ +#N canvas 431 35 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 vline~ 3 12 0 18 +-204280 -1 0; +#X obj 0 361 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 484 278 494 344 META 0; +#X text 12 145 LIBRARY internal; +#X text 12 185 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 165 AUTHOR Miller Puckette; +#X text 12 225 HELP_PATCH_AUTHORS Updated for version 0.33. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 5 KEYWORDS signal time conversion; +#X text 12 45 DESCRIPTION high-precision audio ramp generator; +#X text 12 65 INLET_0 float list stop; +#X text 12 85 INLET_1 float; +#X text 12 105 INLET_2 float; +#X text 12 125 OUTLET_0 signal; +#X text 12 205 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 499 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 541 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 568 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#X text 98 545 (none); +#N canvas 223 521 428 109 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 obj 22 43 line~; +#X obj 62 43 line; +#X text 8 2 [vline~] Related Objects; +#X restore 102 597 pd Related_objects; +#X obj 78 370 cnv 17 3 70 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 369 float; +#X text 98 393 list; +#X obj 78 508 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 448 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X text 98 447 float; +#X obj 495 11 vline~; +#X text 11 23 high-precision audio ramp generator; +#X text 168 393 - a list to the first inlet is distributed among the +inlets of [vline~].; +#X text 98 426 stop; +#X obj 78 471 cnv 17 3 17 empty \$0-pddp.cnv.let.2 2 5 9 0 16 -228856 +-162280 0; +#X text 98 470 float; +#X text 98 507 signal; +#X text 168 507 - the output is a linear ramp whose levels and timing +are determined by the messages sent to the inlet(s).; +#X obj 31 271 snapshot~; +#X floatatom 31 294 5 0 0 0 - - -, f 5; +#X obj 41 244 metro 100; +#X msg 31 69 1 1000; +#X msg 59 174 stop; +#X msg 51 113 0; +#X obj 31 200 vline~; +#X text 86 67 ramp up; +#X msg 40 91 0 1000; +#X text 86 90 ramp down; +#X text 60 133 ramp up \, jump down \, ramp up again; +#X msg 54 152 1 1000 \, 0 0 1000 \, 1 1000 1000; +#X text 86 112 jump down; +#X text 147 181 The [vline~] object \, like [line~] \, generates linear +ramps whose levels and timing are determined by messages you send it. +The messages consist of a target value \, a time interval (zero if +not supplied) \, and an initial delay (also zero if not supplied.) +Ramps may start and stop between audio samples \, in which case the +output is interpolated accordingly.; +#X text 147 276 Any number of future ramps may be scheduled and [vline~] will remember them and execute them in order. They must be specified in increasing order of initial delay however \, since a segment cancels all planned segments at any future time.; -#X text 120 238 ramp up; -#X msg 64 263 0 1000; -#X text 127 266 ramp down; -#X text 84 308 ramp up \, jump down \, ramp up again; -#X msg 78 329 1 1000 \, 0 0 1000 \, 1 1000 1000; -#X text 110 287 jump down; -#X text 126 356 "stop" message freezes vline~ at its current value +#X text 168 369 - target value.; +#X text 168 426 - the "stop" message freezes [vline~] at its current +value.; +#X text 167 447 - time value.; +#X text 167 470 - initial delay.; +#X obj 41 222 loadbang; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide ; -#X connect 0 0 1 0; -#X connect 2 0 0 0; -#X connect 3 0 2 0; -#X connect 5 0 17 0; -#X connect 6 0 17 0; -#X connect 7 0 17 0; -#X connect 17 0 0 0; -#X connect 21 0 17 0; -#X connect 24 0 17 0; +#X obj 474 57 pddp/dsp; +#X obj 98 572 pddp/pddplink ../3.audio.examples/C04.control.to.signal.pd +-text doc/3.audio.examples/C04.control.to.signal.pd; +#X connect 23 0 24 0; +#X connect 25 0 23 0; +#X connect 26 0 29 0; +#X connect 27 0 29 0; +#X connect 28 0 29 0; +#X connect 29 0 23 0; +#X connect 31 0 29 0; +#X connect 34 0 29 0; +#X connect 42 0 25 0; diff --git a/doc/pddp/vradio-help.pd b/pd/doc/5.reference/vradio-help.pd similarity index 100% rename from doc/pddp/vradio-help.pd rename to pd/doc/5.reference/vradio-help.pd diff --git a/pd/doc/5.reference/vslider-help.pd b/pd/doc/5.reference/vslider-help.pd index 69452ad62..8bd6ecff4 100644 --- a/pd/doc/5.reference/vslider-help.pd +++ b/pd/doc/5.reference/vslider-help.pd @@ -1,302 +1,433 @@ -#N canvas 147 201 617 416 10; -#X obj 1 1 cnv 8 100 60 empty empty vslider=vsl 20 20 1 18 -262144 --1109 0; -#X floatatom 38 300 9 0 0; -#X msg 47 84 set \$1; -#X floatatom 38 43 7 0 0; -#X text 25 363 (c) musil@iem.kug.ac.at; -#X text 67 376 IEM KUG; -#X obj 38 324 bng 15 250 50 0 empty empty empty 8 -8 0 10 -262144 -1 --1; -#X obj 18 47 bng 15 250 50 0 empty empty empty 8 -8 0 10 -262144 -1 --1; -#X floatatom 47 63 7 0 0; -#X floatatom 116 324 9 0 0; -#X floatatom 106 42 7 0 0; -#X floatatom 147 113 7 0 0; -#X obj 75 249 ftom; -#X floatatom 75 271 9 0 0; -#X floatatom 111 244 9 0 0; -#X floatatom 185 266 9 0 0; -#X text 181 151 click properties to; -#X floatatom 75 112 9 0 0; -#X obj 75 134 mtof; -#X text 166 12 gui-vertical-slider:; -#X obj 38 162 vsl 15 101 100 300 0 1 foo3_snd foo3_rcv empty 8 -8 192 -10 -225280 -1109 -1 2500 1; -#X obj 75 168 vsl 15 73 55 3520 1 1 goo4_snd goo4_rcv log.freq. 11 --6 192 10 -261681 -260818 -90881 0 1; -#X obj 185 244 r goo4_snd; -#X obj 147 133 s goo4_rcv; -#X text 202 65 (0.01 pixels); -#X text 57 99 ------------------------------------------; -#X text 57 286 --------------------------------------------; -#X text 169 162 modify geometry \, colors \, etc.; -#X obj 106 84 s foo3_rcv; -#X obj 116 302 r foo3_snd; -#X msg 106 63 set \$1; -#X text 188 44 shift-click & drag; -#X text 194 54 for fine-tuning; -#X text 119 192 UP- \, DOWN- \, LEFT- or RIGHT-key; -#X text 118 203 for moving selected gui-objects; -#N canvas 239 379 699 530 edit 0; -#X obj 37 233 f; -#X msg 15 212 bang; -#X floatatom 53 211 3 6 88; -#X floatatom 88 233 3 -20 37; -#X obj 37 256 pack 0 0; -#X text 115 233 y-label; -#X text 81 211 x-label; -#X obj 287 271 f; -#X msg 265 250 bang; -#X floatatom 303 249 3 -10 10; -#X floatatom 338 271 3 -10 10; -#X obj 287 294 pack 0 0; -#X obj 299 381 f; -#X msg 277 360 bang; -#X floatatom 315 359 3 20 90; -#X floatatom 350 381 3 150 200; -#X obj 299 404 pack 0 0; -#X text 331 249 x-delta; -#X text 365 271 y-delta; -#X text 343 359 x-position; -#X text 377 381 y-position; -#X obj 57 348 f; -#X msg 35 327 bang; -#X floatatom 73 326 3 0 2; -#X floatatom 108 348 3 4 36; -#X obj 57 371 pack 0 0; -#X text 101 326 font; -#X text 137 348 height; -#X floatatom 476 188 1 0 1; -#X text 523 401 no init; -#X text 493 453 init value on loadbang; -#X text 520 188 steady; -#X obj 486 291 f; -#X msg 464 270 bang; -#X floatatom 502 269 4 55 440; -#X floatatom 537 291 6 440 3520; -#X obj 486 314 pack 0 0; -#X text 269 469 linear / logarithmical; -#X msg 47 158 \; goo4_rcv color \$1 \$2 \$3; -#X msg 37 281 \; goo4_rcv label_pos \$1 \$2; -#X msg 57 396 \; goo4_rcv label_font \$1 \$2; -#X msg 40 442 \; goo4_rcv label blabla; -#X msg 269 487 \; goo4_rcv lin; -#X msg 363 486 \; goo4_rcv log; -#X msg 299 429 \; goo4_rcv pos \$1 \$2; -#X msg 287 319 \; goo4_rcv delta \$1 \$2; -#X msg 475 21 \; goo4_rcv send goo4a_snd; -#X msg 475 59 \; goo4_rcv send goo4_snd; -#X msg 476 105 \; goo4_rcv receive goo4a_rcv; -#X msg 476 143 \; goo4a_rcv receive goo4_rcv; -#X msg 486 339 \; goo4_rcv range \$1 \$2; -#X msg 502 420 \; goo4_rcv init 0; -#X msg 503 471 \; goo4_rcv init 1; -#X text 539 270 bottom-range-bound; -#X text 586 292 top-range-bound; -#X obj 286 160 f; -#X msg 264 139 bang; -#X floatatom 302 138 3 4 55; -#X floatatom 337 160 3 15 73; -#X obj 286 183 pack 0 0; -#X msg 286 208 \; goo4_rcv size \$1 \$2; -#X text 330 138 width; -#X text 368 161 height; -#X msg 41 478 \; goo4_rcv label log.freq.; -#X msg 476 212 \; goo4_rcv steady \$1; -#X obj 47 116 pack 0 0 0; -#X obj 47 88 f; -#X msg 24 40 bang; -#X floatatom 63 38 3 0 29; -#X floatatom 79 58 3 0 29; -#X floatatom 112 74 3 0 29; -#X text 91 38 background; -#X text 106 58 front-color; -#X text 140 75 label-color; -#X msg 285 37 back; -#X msg 285 57 front; -#X msg 285 77 label; -#X msg 247 37 bang; -#N canvas 15 207 606 448 RGB_____________ 0; -#X obj 97 56 inlet; -#X obj 262 53 inlet; -#X obj 339 55 inlet; -#X obj 405 56 inlet; -#X obj 97 270 bang; -#X msg 77 295 0; -#X msg 104 295 1; -#X obj 146 268 bang; -#X msg 132 295 0; -#X msg 160 295 1; -#X obj 196 269 bang; -#X msg 187 295 0; -#X msg 214 295 1; -#X obj 265 313 spigot; -#X obj 312 313 spigot; -#X obj 359 313 spigot; -#X obj 249 385 outlet; -#X text 93 33 select; -#X text 267 28 red; -#X text 337 30 green; -#X text 409 30 blue; -#X obj 405 102 t b f; -#X obj 339 160 +; -#X obj 339 185 t b f; -#X obj 339 216 +; -#X obj 296 385 outlet; -#X obj 343 385 outlet; -#X obj 28 180 loadbang; -#X obj 97 135 route back front label bang; -#X obj 343 362 f; -#X obj 296 361 f; -#X obj 249 361 f; -#X obj 262 79 * -65536; -#X obj 339 80 * -256; -#X obj 405 80 * -1; -#X obj 339 247 - 1; -#X obj 235 168 t b b b b; -#X connect 0 0 28 0; -#X connect 1 0 32 0; -#X connect 2 0 33 0; -#X connect 3 0 34 0; -#X connect 4 0 5 0; -#X connect 4 0 6 0; -#X connect 5 0 14 1; -#X connect 5 0 15 1; -#X connect 6 0 13 1; -#X connect 7 0 8 0; -#X connect 7 0 9 0; -#X connect 8 0 13 1; -#X connect 8 0 15 1; -#X connect 9 0 14 1; +#N canvas 430 32 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 vslider 3 12 0 18 +-204280 -1 0; +#X obj 0 306 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 485 240 494 387 META 0; +#X text 12 135 LIBRARY internal; +#X text 12 175 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 45 LICENSE SIBSD; +#X text 12 155 AUTHOR Miller Puckette; +#X text 12 215 HELP_PATCH_AUTHORS This help patch was updated for Pd +version 0.35 test 28 by Dave Sabine as part of a project called pddp +proposed by Krzysztof Czaja to build comprehensive documentation for +Pd. Jonathan Wilkes revised the patch to conform to the PDDP template +for Pd version 0.42.; +#X text 12 25 KEYWORDS control storage GUI nonlocal; +#X text 12 65 DESCRIPTION vertical gui-slider; +#X text 12 5 ALIAS vsl; +#X text 12 85 INLET_0 float bang size range log init steady receive +send label label_pos label_font color pos delta; +#X text 12 115 OUTLET_0 float; +#X text 12 195 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 436 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 490 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 574 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#X obj 78 315 cnv 17 3 106 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#N canvas 209 494 428 129 Related_objects 0; +#X obj 20 53 x_all_guis bng tgl vsl hsl hradio vradio vu cnv nbx; +#X text 18 29 All iem-gui objects:; +#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 [vslider] Related Objects; +#X restore 100 597 pd Related_objects; +#X obj 78 445 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 314 float; +#X text 98 445 float; +#X text 54 259 Use the UP- \, DOWN- \, LEFT- or RIGHT-key to move a +selected gui-object. Right-click and choose "Properties" to modify +its appearance.; +#X text 168 445 - when the slider value is changed by clicking \, dragging +\, or sending a float to the inlet \, the new slider value is sent +to the outlet.; +#N canvas 53 19 464 608 Setting_slider_properties_through_messages +0; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X floatatom 12 189 1 0 1 0 - #0-soc -, f 1; +#X text 324 35 no init; +#X text 9 170 steady-on-click; +#X text 11 309 label; +#X msg 11 329 label blabla; +#X msg 324 54 init 0; +#X msg 12 222 steady \$1; +#X msg 235 74 lin; +#X msg 245 106 log; +#X text 231 35 linear/; +#X text 231 50 logarithmical; +#X text 333 74 init value; +#X text 334 89 on loadbang; +#X text 235 170 change send name; +#X text 108 170 change receive name; +#X obj 122 245 s z_rcv; +#X msg 110 192 receive z_rcv; +#X msg 21 381 label mySlider; +#X msg 122 222 receive hsl_rcv; +#X msg 237 193 send hsl1_snd; +#X msg 246 222 send hsl_snd; +#N canvas 234 255 161 292 init 0; +#X obj 16 11 loadbang; +#X obj 16 42 f \$0; +#X msg 16 73 \; \$1-xpos 391 \; \$1-ypos 200 \; \$1-xlabel -2 \; \$1-ylabel +-8 \; \$1-soc 1 \; \$1-font-size 10 \; \$1-width 15 \; \$1-height 128 +\; \$1-bottom 0 \; \$1-top 127 \; \$1-bg 0 \; \$1-front 12 \; \$1-label +12; +#X connect 0 0 1 0; +#X connect 1 0 2 0; +#X restore 400 586 pd init; +#X msg 334 110 init 1; +#X msg 12 106 size \$1 \$2; +#X text 61 57 1.width; +#X text 61 78 2.height; +#X text 173 57 1.bottom; +#X text 173 78 2.top; +#X text 121 35 output-range; +#X msg 124 106 range \$1 \$2; +#X text 242 308 font properties; +#X msg 244 380 label_font \$1 \$2; +#X text 293 330 1.font(0-2); +#X text 293 351 2.height; +#X text 120 309 label position; +#X msg 122 380 label_pos \$1 \$2; +#X text 171 330 1.x-offset; +#X text 171 351 2.y-offset; +#X obj 375 184 cnv 15 67 172 empty empty empty 20 12 0 14 -1 -66577 +0; +#X obj 376 185 cnv 15 65 170 empty empty empty 20 12 0 14 -261682 -66577 +0; +#N canvas 366 206 174 259 flash-time 0; +#X obj 68 180 pack; +#X obj 103 149 t b a; +#X obj 68 205 outlet; +#X obj 103 104 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-width empty +0 -8 0 12 -262144 -1 -1 15 256 0; +#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-height empty +0 -8 0 12 -262144 -1 -1 128 256 0; +#X connect 0 0 2 0; +#X connect 1 0 0 0; +#X connect 1 1 0 1; +#X connect 3 0 0 0; +#X connect 4 0 1 0; +#X coords 0 -1 1 1 48 42 2 100 100; +#X restore 12 56 pd flash-time; +#N canvas 366 206 174 259 flash-time 0; +#X obj 68 180 pack; +#X obj 103 149 t b a; +#X obj 68 205 outlet; +#X obj 103 104 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-bottom empty +0 -8 0 12 -262144 -1 -1 0 256 0; +#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-top empty 0 +-8 0 12 -262144 -1 -1 127 256 0; +#X connect 0 0 2 0; +#X connect 1 0 0 0; +#X connect 1 1 0 1; +#X connect 3 0 0 0; +#X connect 4 0 1 0; +#X coords 0 -1 1 1 48 42 2 100 100; +#X restore 124 56 pd flash-time; +#N canvas 366 206 174 259 flash-time 0; +#X obj 68 180 pack; +#X obj 103 149 t b a; +#X obj 68 205 outlet; +#X obj 103 104 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-xlabel empty +0 -8 0 12 -262144 -1 -1 -2 256 0; +#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-ylabel empty +0 -8 0 12 -262144 -1 -1 -8 256 0; +#X connect 0 0 2 0; +#X connect 1 0 0 0; +#X connect 1 1 0 1; +#X connect 3 0 0 0; +#X connect 4 0 1 0; +#X coords 0 -1 1 1 48 42 2 100 100; +#X restore 122 329 pd flash-time; +#N canvas 366 206 174 259 flash-time 0; +#X obj 68 180 pack; +#X obj 103 149 t b a; +#X obj 68 205 outlet; +#X obj 103 104 nbx 3 14 0 2 0 0 \$0-dummy \$0-font empty 0 -8 0 12 +-262144 -1 -1 0 256 0; +#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-font-size empty +0 -8 0 12 -262144 -1 -1 10 256 0; +#X connect 0 0 2 0; +#X connect 1 0 0 0; +#X connect 1 1 0 1; +#X connect 3 0 0 0; +#X connect 4 0 1 0; +#X coords 0 -1 1 1 48 42 2 100 100; +#X restore 244 329 pd flash-time; +#X text 9 449 preset-colors; +#X text 105 449 RGB-colors; +#X msg 12 555 color \$1 \$2 \$3; +#N canvas 364 205 306 317 flash-time 0; +#X obj 69 196 t b a; +#X obj 33 262 outlet; +#X obj 33 237 pack 0 0 0; +#X obj 120 197 t b a; +#X obj 103 104 nbx 3 14 0 29 0 0 \$0-dummy \$0-bg empty 0 -8 0 12 -262144 +-1 -1 0 256 0; +#X obj 103 124 nbx 3 14 0 29 0 0 \$0-dummy \$0-front empty 0 -8 0 12 +-262144 -1 -1 12 256 0; +#X obj 103 144 nbx 3 14 0 29 0 0 \$0-dummy \$0-label empty 0 -8 0 12 +-262144 -1 -1 12 256 0; +#X connect 0 0 2 0; +#X connect 0 1 2 1; +#X connect 2 0 1 0; +#X connect 3 0 2 0; +#X connect 3 1 2 2; +#X connect 4 0 2 0; +#X connect 5 0 0 0; +#X connect 6 0 3 0; +#X coords 0 -1 1 1 48 62 2 100 100; +#X restore 12 470 pd flash-time; +#N canvas 0 0 306 317 flash-time 0; +#X obj 96 521 outlet; +#X obj 162 230 t b f; +#X obj 96 268 +; +#X obj 96 293 t b f; +#X obj 96 324 +; +#X obj 19 208 * -65536; +#X obj 96 208 * -256; +#X obj 162 208 * -1; +#X obj 96 355 - 1; +#X obj 96 385 list prepend 0; +#X obj 96 410 route 0 1 2; +#X obj 96 497 pack 0 0 0; +#X obj 115 456 t b a; +#X obj 168 455 t b a; +#X obj 104 124 vradio 15 1 0 3 empty empty empty 0 -8 0 10 -262144 +-1 -1 0; +#X text 120 120 1.bg; +#X text 120 137 2.front; +#X text 120 153 3.label; +#X obj 103 105 nbx 3 14 0 255 0 0 \$0-dummy \$0-r empty 0 -8 0 10 -262144 +-258113 -1 0 256 0; +#X obj 133 105 nbx 3 14 0 255 0 0 \$0-dummy \$0-g empty 0 -8 0 10 -262144 +-13381 -1 0 256 0; +#X obj 163 105 nbx 3 14 0 255 0 0 \$0-dummy \$0-b empty 0 -8 0 10 -262144 +-4160 -1 0 256 0; +#X connect 1 0 2 0; +#X connect 1 1 2 1; +#X connect 2 0 3 0; +#X connect 3 0 4 0; +#X connect 3 1 4 1; +#X connect 4 0 8 0; +#X connect 5 0 4 0; +#X connect 6 0 2 0; +#X connect 7 0 1 0; +#X connect 8 0 9 0; +#X connect 9 0 10 0; #X connect 10 0 11 0; -#X connect 10 0 12 0; -#X connect 11 0 13 1; -#X connect 11 0 14 1; -#X connect 12 0 15 1; -#X connect 13 0 31 1; -#X connect 14 0 30 1; -#X connect 15 0 29 1; -#X connect 21 0 22 0; -#X connect 21 1 22 1; -#X connect 22 0 23 0; -#X connect 23 0 24 0; -#X connect 23 1 24 1; -#X connect 24 0 35 0; -#X connect 27 0 6 0; -#X connect 28 0 4 0; -#X connect 28 1 7 0; -#X connect 28 2 10 0; -#X connect 28 3 36 0; -#X connect 29 0 26 0; -#X connect 30 0 25 0; -#X connect 31 0 16 0; -#X connect 32 0 24 0; -#X connect 33 0 22 0; -#X connect 34 0 21 0; -#X connect 35 0 15 0; -#X connect 35 0 14 0; -#X connect 35 0 13 0; -#X connect 36 0 31 0; -#X connect 36 1 30 0; -#X connect 36 2 29 0; -#X connect 36 3 35 0; -#X restore 285 98 pd RGB_____________; -#X floatatom 327 67 3 0 255; -#X floatatom 370 67 3 0 255; -#X floatatom 413 68 3 0 255; -#X text 34 12 preset-colors; -#X text 296 9 RGB-colors; -#X text 327 49 red; -#X text 363 48 green; -#X text 411 48 blue; -#X connect 0 0 4 0; +#X connect 10 1 12 0; +#X connect 10 2 13 0; +#X connect 11 0 0 0; +#X connect 12 0 11 0; +#X connect 12 1 11 1; +#X connect 13 0 11 0; +#X connect 13 1 11 2; +#X connect 14 0 9 1; +#X connect 18 0 5 0; +#X connect 19 0 6 0; +#X connect 20 0 7 0; +#X coords 0 -1 1 1 102 74 2 100 100; +#X restore 109 470 pd flash-time; +#X text 61 472 1.bg; +#X text 61 492 2.front; +#X text 61 513 3.label; +#X text 318 449 delta; +#X text 218 449 position; +#X msg 219 541 pos \$1 \$2; +#X msg 319 541 delta \$1 \$2; +#X obj 319 518 list; +#X obj 319 471 bng 20 250 50 0 empty empty empty 17 7 0 10 -262144 +-1 -1; +#X text 398 470 1.x-delta; +#X text 398 492 2.y-delta; +#N canvas 366 206 174 259 flash-time 0; +#X obj 68 180 pack; +#X obj 103 149 t b a; +#X obj 68 205 outlet; +#X obj 103 104 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-xpos empty 0 +-8 0 12 -262144 -1 -1 391 256 0; +#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-ypos empty 0 +-8 0 12 -262144 -1 -1 200 256 0; +#X connect 0 0 2 0; #X connect 1 0 0 0; -#X connect 2 0 0 1; -#X connect 3 0 4 1; -#X connect 4 0 39 0; -#X connect 7 0 11 0; -#X connect 8 0 7 0; -#X connect 9 0 7 1; -#X connect 10 0 11 1; -#X connect 11 0 45 0; -#X connect 12 0 16 0; -#X connect 13 0 12 0; -#X connect 14 0 12 1; -#X connect 15 0 16 1; -#X connect 16 0 44 0; -#X connect 21 0 25 0; -#X connect 22 0 21 0; -#X connect 23 0 21 1; -#X connect 24 0 25 1; -#X connect 25 0 40 0; -#X connect 28 0 64 0; -#X connect 32 0 36 0; -#X connect 33 0 32 0; -#X connect 34 0 32 1; -#X connect 35 0 36 1; -#X connect 36 0 50 0; -#X connect 55 0 59 0; -#X connect 56 0 55 0; -#X connect 57 0 55 1; -#X connect 58 0 59 1; -#X connect 59 0 60 0; -#X connect 65 0 38 0; -#X connect 66 0 65 0; -#X connect 67 0 66 0; -#X connect 68 0 66 1; -#X connect 69 0 65 1; -#X connect 70 0 65 2; -#X connect 74 0 78 0; -#X connect 75 0 78 0; -#X connect 76 0 78 0; -#X connect 77 0 78 0; -#X connect 78 0 65 0; -#X connect 78 1 65 1; -#X connect 78 2 65 2; -#X connect 79 0 78 1; -#X connect 80 0 78 2; -#X connect 81 0 78 3; -#X restore 327 48 pd edit; -#X obj 61 345 print; +#X connect 1 1 0 1; +#X connect 3 0 0 0; +#X connect 4 0 1 0; +#X coords 0 -1 1 1 48 42 2 100 100; +#X restore 219 471 pd flash-time; +#N canvas 366 206 174 259 flash-time 0; +#X obj 68 180 pack; +#X obj 103 149 t b a; +#X obj 68 205 outlet; +#X obj 103 104 nbx 3 14 -20 20 0 0 \$0-dummy \$0-xdelta empty 0 -8 +0 12 -262144 -1 -1 0 256 0; +#X obj 103 124 nbx 3 14 -20 20 0 0 \$0-dummy \$0-ydelta empty 0 -8 +0 12 -262144 -1 -1 0 256 0; +#X connect 0 0 2 0; +#X connect 1 0 0 0; +#X connect 1 1 0 1; +#X connect 3 0 0 0; +#X connect 4 0 1 0; +#X coords 0 -1 1 1 48 42 2 100 100; +#X restore 348 471 pd flash-time; +#X floatatom 392 337 5 0 0 0 - - -, f 5; +#X text 11 36 dimensions; +#X text 267 470 1.x-pos; +#X text 267 492 2.y-pos; +#X obj 12 135 s vsl_rcv; +#X obj 124 135 s vsl_rcv; +#X obj 235 135 s vsl_rcv; +#X obj 324 135 s vsl_rcv; +#X obj 12 270 s vsl_rcv; +#X obj 110 270 s vsl_rcv; +#X obj 237 270 s vsl_rcv; +#X obj 11 409 s vsl_rcv; +#X obj 122 409 s vsl_rcv; +#X obj 244 405 s vsl_rcv; +#X obj 12 580 s vsl_rcv; +#X obj 219 566 s vsl_rcv; +#X obj 319 566 s vsl_rcv; +#X obj 391 200 vsl 15 128 0 127 0 0 vsl_snd vsl_rcv mySlider -2 -8 +0 10 -262144 -33289 -33289 0 1; +#X text 8 2 [vslider] Set Properties through Messages; +#X connect 1 0 7 0; +#X connect 5 0 74 0; +#X connect 6 0 70 0; +#X connect 7 0 71 0; +#X connect 8 0 69 0; +#X connect 9 0 69 0; +#X connect 17 0 72 0; +#X connect 18 0 74 0; +#X connect 19 0 16 0; +#X connect 20 0 73 0; +#X connect 21 0 73 0; +#X connect 23 0 70 0; +#X connect 24 0 67 0; +#X connect 30 0 68 0; +#X connect 32 0 76 0; +#X connect 36 0 75 0; +#X connect 41 0 24 0; +#X connect 42 0 30 0; +#X connect 43 0 36 0; +#X connect 44 0 32 0; +#X connect 47 0 77 0; +#X connect 48 0 47 0; +#X connect 49 0 47 0; +#X connect 55 0 78 0; +#X connect 56 0 79 0; +#X connect 57 0 56 0; +#X connect 58 0 57 0; +#X connect 61 0 55 0; +#X connect 62 0 57 1; +#X connect 80 0 63 0; +#X restore 101 406 pd Setting_slider_properties_through_messages; +#X obj 57 213 ftom; +#X floatatom 57 237 9 0 0 0 - - -, f 9; +#X floatatom 104 213 9 0 0 0 - - -, f 9; +#X floatatom 57 84 9 0 0 0 - - -, f 9; +#X obj 57 106 mtof; +#X text 97 177 (0.01 pixels); +#X text 99 148 shift-click & drag; +#X text 99 163 for fine-tuning; +#X obj 57 132 vsl 15 73 55 3520 1 1 goo4_snd goo4_rcv log.freq. 20 +6 0 10 -261681 -260818 -90881 2244 1; +#X text 380 170 names. Right-click and; +#X text 380 155 send and receive names.; +#X text 379 186 choose "Properties" to; +#X text 380 200 set them \, or change them; +#X text 380 214 with messages (see below); +#X floatatom 250 216 4 0 0 0 - - -, f 4; +#X msg 309 69 set \$1; +#X floatatom 270 47 4 0 0 0 - - -, f 4; +#X obj 250 240 bng 15 250 50 0 empty empty empty 8 -8 0 10 -262144 +-1 -1; +#X obj 250 47 bng 15 250 50 0 empty empty empty 8 -8 0 10 -262144 -1 +-1; +#X floatatom 309 48 4 0 0 0 - - -, f 4; +#X floatatom 310 191 4 0 0 0 - - -, f 4; +#X floatatom 309 100 4 0 0 0 - - -, f 4; +#X obj 250 102 vsl 15 101 100 300 0 1 foo3_snd foo3_rcv empty 8 -8 +0 10 -225280 -1109 -1 5350 1; +#X obj 309 143 s foo3_rcv; +#X obj 310 169 r foo3_snd; +#X msg 309 121 set \$1; +#X obj 294 240 print; #N canvas 276 200 290 224 once 0; -#X obj 38 47 t b b f; -#X msg 56 85 1; -#X obj 31 108 f 0; -#X obj 31 131 pack 0 0; -#X obj 31 156 route 0; #X obj 38 24 inlet; -#X obj 31 180 outlet; -#X connect 0 0 1 0; -#X connect 0 1 2 0; -#X connect 0 2 3 1; -#X connect 1 0 2 1; -#X connect 2 0 3 0; -#X connect 3 0 4 0; -#X connect 4 0 6 0; -#X connect 5 0 0 0; -#X restore 61 322 pd once; -#X obj 377 110 vsl 15 128 0 127 0 0 ccc ccc empty 20 8 192 8 -262144 --1 -1 4200 1; -#X obj 249 87 x_all_guis aaa bbb ccc ddd eee fff ggg hhh iii; -#X text 218 387 updated for Pd version 0.35; -#X text 42 388 graz \, austria 2002; -#X connect 1 0 6 0; -#X connect 2 0 20 0; -#X connect 3 0 20 0; -#X connect 7 0 20 0; -#X connect 8 0 2 0; -#X connect 10 0 30 0; -#X connect 11 0 23 0; -#X connect 12 0 13 0; -#X connect 17 0 18 0; -#X connect 18 0 21 0; -#X connect 20 0 1 0; -#X connect 20 0 37 0; -#X connect 21 0 14 0; -#X connect 21 0 12 0; -#X connect 22 0 15 0; -#X connect 29 0 9 0; -#X connect 30 0 28 0; -#X connect 37 0 36 0; +#X obj 38 91 outlet; +#X obj 38 69 t a b; +#X obj 38 47 spigot 1; +#X obj 97 47 0; +#X connect 0 0 3 0; +#X connect 2 0 1 0; +#X connect 2 1 4 0; +#X connect 3 0 2 0; +#X connect 4 0 3 1; +#X restore 294 216 pd once; +#X text 98 374 Special messages can be sent to [vslider] to change +its properties:; +#N canvas 65 102 428 434 vsl-creation-arguments 0; +#X text 22 226 For example \, click the msg-box to dynamically create +a hsl:; +#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 [vslider] Creation Arguments and Dynamic Patching; +#X obj 23 290 s pd-vsl-creation-arguments; +#X text 21 38 "vsl" can be called with 18 creation arguments. These +are not "optional" - all parameters must be filled or the gui-bng will +not instantiate correctly.; +#X text 21 85 vsl creation arguments: xSize ySize rangeBtm rangeTop +Logarithmic Init sendName receiveName Label labelXOff labelYOff Font# +fontSize bgColor foregroundColor lblColor sliderPosition steadyOnClick +; +#X text 22 143 note: sliderPosition is not the same as the initialization +value. To dynamically instantiate an hsl that initializes with a desired +value \, save an hsl in a patch and view it in a text editor to get +the right value for sliderPosition. Or \, refer to hslider_set in g_vslider.c +for conversion between sliderPosition and slider value.; +#X msg 23 248 obj 150 335 vsl 75 75 -1 1 0 1 send receive Merope 15 +-9 0 12 7 13 21 4400 0; +#X connect 7 0 3 0; +#X restore 170 551 pd vsl-creation-arguments; +#X text 379 139 vslider has settable; +#X text 11 21 vertical gui-slider; +#X text 98 494 18; +#X text 168 494 - creating a [vslider] object without arguments sets +default values for its gui-properties. See the subpatch below to learn +how to dynamically instantiate a [bng] object with custom properties: +; +#X text 168 314 - a float updates the slider value and is sent to the +outlet.; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X text 98 356 list; +#X text 168 356 - a list is truncated to the first element.; +#X text 98 339 bang; +#X text 168 339 - output the current slider value.; +#X text 429 11 [vslider] or [vsl]; +#X connect 15 0 16 0; +#X connect 18 0 19 0; +#X connect 19 0 23 0; +#X connect 23 0 15 0; +#X connect 23 0 17 0; +#X connect 29 0 32 0; +#X connect 30 0 37 0; +#X connect 31 0 37 0; +#X connect 33 0 37 0; +#X connect 34 0 30 0; +#X connect 36 0 40 0; +#X connect 37 0 29 0; +#X connect 37 0 42 0; +#X connect 39 0 35 0; +#X connect 40 0 38 0; +#X connect 42 0 41 0; diff --git a/doc/pddp/vsnapshot~-help.pd b/pd/doc/5.reference/vsnapshot~-help.pd similarity index 100% rename from doc/pddp/vsnapshot~-help.pd rename to pd/doc/5.reference/vsnapshot~-help.pd diff --git a/pd/doc/5.reference/vu-help.pd b/pd/doc/5.reference/vu-help.pd index 3c94ba525..3f237d3f2 100644 --- a/pd/doc/5.reference/vu-help.pd +++ b/pd/doc/5.reference/vu-help.pd @@ -1,210 +1,324 @@ -#N canvas 171 210 549 418 10; -#X obj 1 1 cnv 8 100 60 empty empty vu 20 20 1 18 -262144 -1109 0; -#X text 19 363 (c) musil@iem.kug.ac.at; -#X text 61 376 IEM KUG; -#X floatatom 177 129 7 -110 20; -#X text 202 41 click properties to; -#X text 190 52 modify geometry \, colors \, etc.; -#X text 49 13 gui-vu-meter-display:; -#X obj 99 39 tgl 15 1 empty empty empty 8 -8 0 10 -262144 -1 -1 1 1 +#N canvas 429 34 558 622 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 vu 3 12 0 18 -204280 +-1 0; +#X obj 0 287 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 488 283 494 344 META 0; +#X text 12 155 LIBRARY internal; +#X text 12 25 LICENSE SIBSD; +#X text 12 175 AUTHOR Thomas Musil; +#X text 12 195 WEBSITE; +#X text 12 5 KEYWORDS control GUI nonlocal; +#X text 12 45 DESCRIPTION gui-vu-meter-display; +#X text 12 65 INLET_0 float list bang size scale receive label label_pos +label_font color pos delta; +#X text 12 95 INLET_1 float; +#X text 12 115 OUTLET_0 float; +#X text 12 135 OUTLET_1 float; +#X text 12 215 RELEASE_DATE 2002; +#X text 12 235 HELP_PATCH_AUTHORS Jonathan Wilkes revised the patch +to conform to the PDDP template for Pd version 0.42.; +#X restore 500 597 pd META; +#X obj 0 435 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 489 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 572 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 207 509 428 126 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 [vu] Related Objects; +#X obj 22 91 x_all_guis bng tgl vsl hsl hradio vradio vu cnv nbx; +#X text 20 67 All iem-gui objects:; +#X obj 23 43 env~; +#X restore 92 597 pd Related_objects; +#X obj 78 296 cnv 17 3 90 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 295 float; +#X obj 78 444 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 396 cnv 17 3 30 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X text 98 312 list; +#X text 98 396 float; +#X text 98 412 list; +#X text 168 312 - a 2-item list will be distributed to the two inlets ; -#X obj 12 179 vu 16 120 foo7_rcv vu-meter 60 0 64 10 -1 -355 1 0; -#X floatatom 11 332 6 0 0; -#X floatatom 22 310 6 0 0; -#X text 75 309 dB; -#X text 63 333 dB; -#X text 71 128 dB; -#X text 80 148 dB; -#X text 103 146 peak-level; -#X text 101 125 rms-level; -#X text 96 308 peak-level; -#X text 83 332 rms-level; -#X text 108 99 <list> of rms \, peak; -#X obj 177 231 s foo7_rcv; -#X obj 177 211 pack 0 0; -#X floatatom 195 150 7 -110 20; -#X obj 195 191 t b f; -#X text 236 129 dB; -#X text 255 151 dB; -#X text 71 258 UP- \, DOWN- \, LEFT- or RIGHT-key; -#X text 70 269 for moving selected gui-objects; -#X floatatom 11 128 7 -110 20; -#X floatatom 22 149 7 -110 20; -#N canvas 236 62 699 530 edit 0; -#X obj 37 222 f; -#X msg 15 201 bang; -#X floatatom 53 200 3 50 88; -#X floatatom 88 222 3 0 37; -#X obj 37 245 pack 0 0; -#X text 115 222 y-label; -#X text 81 200 x-label; -#X obj 292 313 f; -#X msg 270 292 bang; -#X floatatom 308 291 3 -10 10; -#X floatatom 343 313 3 -10 10; -#X obj 292 336 pack 0 0; -#X obj 304 435 f; -#X msg 282 414 bang; -#X floatatom 320 413 3 20 140; -#X floatatom 355 435 3 150 200; -#X obj 304 458 pack 0 0; -#X text 336 291 x-delta; -#X text 370 313 y-delta; -#X text 348 413 x-position; -#X text 382 435 y-position; -#X obj 57 337 f; -#X msg 35 316 bang; -#X floatatom 73 315 3 0 2; -#X floatatom 108 337 3 8 36; -#X obj 57 360 pack 0 0; -#X text 101 315 font; -#X text 137 337 height; -#X floatatom 471 106 1 0 1; -#X msg 52 131 \; foo7_rcv color \$1 \$2; -#X msg 37 270 \; foo7_rcv label_pos \$1 \$2; -#X msg 57 386 \; foo7_rcv label_font \$1 \$2; -#X msg 37 427 \; foo7_rcv label blabla; -#X msg 292 361 \; foo7_rcv delta \$1 \$2; -#X msg 304 483 \; foo7_rcv pos \$1 \$2; -#X msg 469 23 \; foo7_rcv receive foo7a_rcv; -#X msg 469 60 \; foo7a_rcv receive foo7_rcv; -#X text 492 106 display scale; -#X msg 471 132 \; foo7_rcv scale \$1; -#X obj 279 193 f; -#X msg 257 172 bang; -#X floatatom 295 171 3 8 50; -#X floatatom 330 193 3 110 200; -#X obj 279 216 pack 0 0; -#X text 323 171 width; -#X text 357 193 height; -#X msg 279 241 \; foo7_rcv size \$1 \$2; -#X msg 37 463 \; foo7_rcv label vu-meter; -#X obj 52 79 f; -#X msg 29 31 bang; -#X floatatom 68 29 3 0 29; -#X floatatom 103 47 3 0 29; -#X text 96 29 background; -#X text 131 48 label-color; -#X msg 290 25 back; -#X msg 290 49 label; -#X msg 252 25 bang; -#N canvas 15 207 606 448 RGB_____________ 0; -#X obj 97 56 inlet; -#X obj 262 53 inlet; -#X obj 339 55 inlet; -#X obj 405 56 inlet; -#X obj 97 270 bang; -#X msg 77 295 0; -#X msg 104 295 1; -#X obj 146 268 bang; -#X msg 132 295 0; -#X msg 160 295 1; -#X obj 265 313 spigot; -#X obj 312 313 spigot; -#X obj 249 385 outlet; -#X text 93 33 select; -#X text 267 28 red; -#X text 337 30 green; -#X text 409 30 blue; -#X obj 405 102 t b f; -#X obj 339 160 +; -#X obj 339 185 t b f; -#X obj 339 216 +; -#X obj 296 385 outlet; -#X obj 28 180 loadbang; -#X obj 296 361 f; -#X obj 249 361 f; -#X obj 262 79 * -65536; -#X obj 339 80 * -256; -#X obj 405 80 * -1; -#X obj 339 247 - 1; -#X obj 97 135 route back label bang; -#X obj 235 168 t b b b; -#X connect 0 0 29 0; -#X connect 1 0 25 0; -#X connect 2 0 26 0; -#X connect 3 0 27 0; -#X connect 4 0 5 0; -#X connect 4 0 6 0; -#X connect 5 0 11 1; -#X connect 6 0 10 1; -#X connect 7 0 8 0; -#X connect 7 0 9 0; -#X connect 8 0 10 1; -#X connect 9 0 11 1; -#X connect 10 0 24 1; -#X connect 11 0 23 1; -#X connect 17 0 18 0; -#X connect 17 1 18 1; -#X connect 18 0 19 0; -#X connect 19 0 20 0; -#X connect 19 1 20 1; -#X connect 20 0 28 0; -#X connect 22 0 6 0; -#X connect 23 0 21 0; -#X connect 24 0 12 0; -#X connect 25 0 20 0; -#X connect 26 0 18 0; -#X connect 27 0 17 0; -#X connect 28 0 11 0; -#X connect 28 0 10 0; -#X connect 29 0 4 0; -#X connect 29 1 7 0; -#X connect 29 2 30 0; -#X connect 30 0 24 0; -#X connect 30 1 23 0; -#X connect 30 2 28 0; -#X restore 290 86 pd RGB_____________; -#X floatatom 332 55 3 0 255; -#X floatatom 375 55 3 0 255; -#X floatatom 418 56 3 0 255; -#X text 39 3 preset-colors; -#X text 301 0 RGB-colors; -#X text 332 37 red; -#X text 368 36 green; -#X text 416 36 blue; -#X obj 52 104 pack 0 0; +#X text 98 444 float; +#X obj 78 466 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X text 98 466 float; +#N canvas 76 117 428 416 vu-creation-arguments 0; +#X obj 25 237 s pd-vu-creation-arguments; +#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 [vu] Creation Arguments; +#X text 22 163 For example \, click the msg-box to dynamically create +a [vu]:; +#X text 23 98 [vu] creation arguments: xSize ySize receiveName Label +labelXOff labelYOff font# fontSize bgColor labelColor Scale Unknown(0) +; +#X text 22 38 [vu] can be called with 12 creation arguments. These +are not "optional" - all parameters must be filled or the gui-bng will +not instantiate correctly.; +#X msg 25 195 obj 160 280 vu 15 120 fff Elektra -15 -12 0 12 26 12 +0 0; +#X connect 6 0 0 0; +#X restore 170 549 pd vu-creation-arguments; +#N canvas 75 10 429 610 Changing_GUI_Properties 0; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X floatatom 130 62 1 0 1 0 - #0-scale -, f 1; +#X text 124 38 display scale; +#X msg 130 116 scale \$1; +#X obj 130 141 s vu_rcv; +#X text 213 38 change receive name; +#X obj 215 141 s vu_rcv; +#X msg 215 62 receive vu12_rcv; +#X obj 231 114 s vu12_rcv; +#X msg 231 89 receive vu_rcv; +#X msg 339 61 label blabla; +#X obj 339 141 s vu_rcv; +#X text 339 38 label; +#N canvas 378 326 151 256 init 0; +#X obj 16 11 loadbang; +#X obj 16 42 f \$0; +#X msg 16 73 \; \$1-xpos 330 \; \$1-ypos 245 \; \$1-scale 1 \; \$1-xlabel +-1 \; \$1-ylabel -8 \; \$1-label 12 \; \$1-font-size 10 \; \$1-width +15 \; \$1-height 120 \; \$1-font 0 \; \$1-bg 12 \; \$1-bg 12; +#X connect 0 0 1 0; +#X connect 1 0 2 0; +#X restore 352 404 pd init; +#N canvas 366 206 174 259 flash-time 0; +#X obj 68 180 pack; +#X obj 103 149 t b a; +#X obj 68 205 outlet; +#X obj 103 104 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-width empty +0 -8 0 12 -262144 -1 -1 15 256 0; +#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-height empty +0 -8 0 12 -262144 -1 -1 120 256 0; +#X connect 0 0 2 0; +#X connect 1 0 0 0; +#X connect 1 1 0 1; +#X connect 3 0 0 0; +#X connect 4 0 1 0; +#X coords 0 -1 1 1 48 42 2 100 100; +#X restore 22 59 pd flash-time; +#X text 19 38 dimensions; +#X text 71 61 1.width; +#X text 71 81 2.height; +#X msg 22 116 size \$1 \$2; +#X obj 22 141 s vu_rcv; +#X text 20 175 label position; +#X text 152 175 font properties; +#X msg 22 250 label_pos \$1 \$2; +#X msg 154 250 label_font \$1 \$2; +#X text 203 199 1.font(0-2); +#X text 203 220 2.height; +#X text 71 198 1.x-offset; +#X text 71 219 2.y-offset; +#N canvas 366 206 174 259 flash-time 0; +#X obj 68 180 pack; +#X obj 103 149 t b a; +#X obj 68 205 outlet; +#X obj 103 104 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-xlabel empty +0 -8 0 12 -262144 -1 -1 -1 256 0; +#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-ylabel empty +0 -8 0 12 -262144 -1 -1 -8 256 0; +#X connect 0 0 2 0; +#X connect 1 0 0 0; +#X connect 1 1 0 1; +#X connect 3 0 0 0; +#X connect 4 0 1 0; +#X coords 0 -1 1 1 48 42 2 100 100; +#X restore 22 197 pd flash-time; +#N canvas 366 206 174 259 flash-time 0; +#X obj 68 180 pack; +#X obj 103 149 t b a; +#X obj 68 205 outlet; +#X obj 103 104 nbx 3 14 0 2 0 0 \$0-dummy \$0-font empty 0 -8 0 12 +-262144 -1 -1 0 256 0; +#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-font-size empty +0 -8 0 12 -262144 -1 -1 10 256 0; +#X connect 0 0 2 0; +#X connect 1 0 0 0; +#X connect 1 1 0 1; +#X connect 3 0 0 0; +#X connect 4 0 1 0; +#X coords 0 -1 1 1 48 42 2 100 100; +#X restore 154 197 pd flash-time; +#X text 22 310 preset-colors; +#X text 131 310 RGB-colors; +#N canvas 364 205 169 292 flash-time 0; +#X obj 69 196 t b a; +#X obj 33 262 outlet; +#X obj 103 104 nbx 3 14 0 29 0 0 \$0-dummy \$0-bg empty 0 -8 0 12 -262144 +-1 -1 12 256 0; +#X obj 103 124 nbx 3 14 0 29 0 0 \$0-dummy \$0-label empty 0 -8 0 12 +-262144 -1 -1 12 256 0; +#X obj 33 237 pack 0 0; #X connect 0 0 4 0; +#X connect 0 1 4 1; +#X connect 2 0 4 0; +#X connect 3 0 0 0; +#X connect 4 0 1 0; +#X coords 0 -1 1 1 48 42 2 100 100; +#X restore 22 332 pd flash-time; +#N canvas 0 0 306 317 flash-time 0; +#X obj 96 521 outlet; +#X obj 162 230 t b f; +#X obj 96 268 +; +#X obj 96 293 t b f; +#X obj 96 324 +; +#X obj 19 208 * -65536; +#X obj 96 208 * -256; +#X obj 162 208 * -1; +#X obj 96 355 - 1; +#X obj 96 385 list prepend 0; +#X obj 115 456 t b a; +#X obj 104 124 vradio 15 1 0 2 empty empty empty 0 -8 0 10 -262144 +-1 -1 0; +#X text 120 120 1.bg; +#X obj 103 105 nbx 3 14 0 255 0 0 \$0-dummy \$0-r empty 0 -8 0 10 -262144 +-258113 -1 0 256 0; +#X obj 133 105 nbx 3 14 0 255 0 0 \$0-dummy \$0-g empty 0 -8 0 10 -262144 +-13381 -1 0 256 0; +#X obj 163 105 nbx 3 14 0 255 0 0 \$0-dummy \$0-b empty 0 -8 0 10 -262144 +-4160 -1 0 256 0; +#X text 120 137 2.label; +#X obj 96 410 route 0 1; +#X obj 96 497 pack 0 0; +#X connect 1 0 2 0; +#X connect 1 1 2 1; +#X connect 2 0 3 0; +#X connect 3 0 4 0; +#X connect 3 1 4 1; +#X connect 4 0 8 0; +#X connect 5 0 4 0; +#X connect 6 0 2 0; +#X connect 7 0 1 0; +#X connect 8 0 9 0; +#X connect 9 0 17 0; +#X connect 10 0 18 0; +#X connect 10 1 18 1; +#X connect 11 0 9 1; +#X connect 13 0 5 0; +#X connect 14 0 6 0; +#X connect 15 0 7 0; +#X connect 17 0 18 0; +#X connect 17 1 10 0; +#X connect 18 0 0 0; +#X coords 0 -1 1 1 102 58 2 100 100; +#X restore 132 332 pd flash-time; +#X text 71 334 1.bg; +#X text 71 354 2.label; +#X msg 22 407 color \$1 \$2; +#X text 153 463 delta; +#X text 21 463 position; +#X msg 22 560 pos \$1 \$2; +#X msg 154 560 delta \$1 \$2; +#X obj 154 536 list; +#X obj 154 485 bng 20 250 50 0 empty empty empty 17 7 0 10 -262144 +-1 -1; +#X text 70 484 1.x-position; +#X text 70 506 2.y-position; +#X text 233 484 1.x-delta; +#X text 233 506 2.y-delta; +#N canvas 366 206 174 259 flash-time 0; +#X obj 68 180 pack; +#X obj 103 149 t b a; +#X obj 68 205 outlet; +#X obj 103 104 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-xpos empty 0 +-8 0 12 -262144 -1 -1 330 256 0; +#X obj 103 124 nbx 3 14 -1e+37 1e+37 0 0 \$0-dummy \$0-ypos empty 0 +-8 0 12 -262144 -1 -1 245 256 0; +#X connect 0 0 2 0; +#X connect 1 0 0 0; +#X connect 1 1 0 1; +#X connect 3 0 0 0; +#X connect 4 0 1 0; +#X coords 0 -1 1 1 48 42 2 100 100; +#X restore 22 485 pd flash-time; +#N canvas 366 206 174 259 flash-time 0; +#X obj 68 180 pack; +#X obj 103 149 t b a; +#X obj 68 205 outlet; +#X obj 103 104 nbx 3 14 -20 20 0 0 \$0-dummy \$0-xdelta empty 0 -8 +0 12 -262144 -1 -1 0 256 0; +#X obj 103 124 nbx 3 14 -20 20 0 0 \$0-dummy \$0-ydelta empty 0 -8 +0 12 -262144 -1 -1 0 256 0; +#X connect 0 0 2 0; #X connect 1 0 0 0; -#X connect 2 0 0 1; -#X connect 3 0 4 1; -#X connect 4 0 30 0; -#X connect 7 0 11 0; -#X connect 8 0 7 0; -#X connect 9 0 7 1; -#X connect 10 0 11 1; -#X connect 11 0 33 0; -#X connect 12 0 16 0; -#X connect 13 0 12 0; -#X connect 14 0 12 1; -#X connect 15 0 16 1; -#X connect 16 0 34 0; -#X connect 21 0 25 0; -#X connect 22 0 21 0; -#X connect 23 0 21 1; -#X connect 24 0 25 1; -#X connect 25 0 31 0; -#X connect 28 0 38 0; -#X connect 39 0 43 0; -#X connect 40 0 39 0; -#X connect 41 0 39 1; -#X connect 42 0 43 1; -#X connect 43 0 46 0; -#X connect 48 0 66 0; -#X connect 49 0 48 0; -#X connect 50 0 48 1; -#X connect 51 0 66 1; -#X connect 54 0 57 0; -#X connect 55 0 57 0; -#X connect 56 0 57 0; -#X connect 57 0 66 0; -#X connect 57 1 66 1; -#X connect 58 0 57 1; -#X connect 59 0 57 2; -#X connect 60 0 57 3; -#X connect 66 0 29 0; -#X restore 313 188 pd edit; -#N canvas 147 336 290 278 source 0; +#X connect 1 1 0 1; +#X connect 3 0 0 0; +#X connect 4 0 1 0; +#X coords 0 -1 1 1 48 42 2 100 100; +#X restore 183 485 pd flash-time; +#X obj 296 213 cnv 15 102 177 empty empty empty 20 12 0 14 -1 -66577 +0; +#X obj 297 214 cnv 15 100 175 empty empty empty 20 12 0 14 -261682 +-66577 0; +#X obj 22 275 s vu_rcv; +#X obj 154 275 s vu_rcv; +#X obj 22 432 s vu_rcv; +#X obj 154 585 s vu_rcv; +#X obj 22 585 s vu_rcv; +#X text 6 2 [vu] Changing Properties through Messages; +#X msg 349 114 label my-vu; +#X obj 330 245 vu 15 120 vu_rcv my-vu -1 -8 0 10 -33289 -33289 1 0 +; +#X connect 1 0 3 0; +#X connect 3 0 4 0; +#X connect 7 0 6 0; +#X connect 9 0 8 0; +#X connect 10 0 11 0; +#X connect 14 0 18 0; +#X connect 18 0 19 0; +#X connect 22 0 51 0; +#X connect 23 0 52 0; +#X connect 28 0 22 0; +#X connect 29 0 23 0; +#X connect 32 0 36 0; +#X connect 33 0 36 0; +#X connect 36 0 53 0; +#X connect 39 0 55 0; +#X connect 40 0 54 0; +#X connect 41 0 40 0; +#X connect 42 0 41 0; +#X connect 47 0 39 0; +#X connect 48 0 41 1; +#X connect 57 0 11 0; +#X restore 172 375 pd Changing_GUI_Properties; +#X text 97 345 see the following subpatch for messages that change +the gui-properties of [vu]:; +#X text 168 493 - creating a [vu] without any arguments will set default +values for all gui-properties. See the subpatch below to learn how +to dynamically instantiate a [vu] object with custom properties:; +#X text 170 239 Use the UP- \, DOWN- \, LEFT- or RIGHT-key to move +a selected gui-object. Right-click and choose "Properties" to modify +its appearance.; +#X text 341 111 and receive names. Right-; +#X text 341 126 click and choose; +#X text 340 142 "Properties" to set them \,; +#X text 341 156 or change them with messages; +#X text 341 170 (see the subpatch below); +#X floatatom 259 90 7 -110 20 1 dB - -, f 7; +#X obj 42 48 tgl 15 1 empty empty empty 8 -8 0 10 -262144 -1 -1 0 1 +; +#X obj 43 125 vu 15 120 foo7_rcv vu-meter 60 0 0 10 -1 -355 1 0; +#X floatatom 42 259 6 0 0 1 dB - -, f 6; +#X floatatom 104 259 6 0 0 1 dB - -, f 6; +#X text 108 68 <list> of rms \, peak; +#X obj 259 197 s foo7_rcv; +#X obj 259 168 pack 0 0; +#X floatatom 277 113 7 -110 20 1 dB - -, f 7; +#X obj 277 138 t b f; +#X floatatom 52 90 7 -110 20 1 dB - -, f 7; +#X floatatom 120 90 7 -110 20 1 dB - -, f 7; +#N canvas 44 136 290 278 source 0; #X obj 40 95 random 102; #X obj 40 171 - 101; #X obj 40 205 pack 0 0; @@ -215,10 +329,14 @@ #X obj 91 147 +; #X obj 91 172 - 101; #X obj 40 21 inlet; -#X obj 40 230 outlet; +#X obj 40 250 outlet; +#X obj 100 249 s fff; +#X obj 159 249 s vu_rcv; #X connect 0 0 6 0; #X connect 1 0 2 0; #X connect 2 0 10 0; +#X connect 2 0 11 0; +#X connect 2 0 12 0; #X connect 3 0 4 0; #X connect 4 0 0 0; #X connect 4 1 5 0; @@ -228,20 +346,28 @@ #X connect 7 0 8 0; #X connect 8 0 2 1; #X connect 9 0 3 0; -#X restore 99 62 pd source; -#X obj 263 94 s fff; -#X obj 186 302 x_all_guis aaa bbb ccc ddd eee fff ggg hhh iii; -#X text 210 386 updated for Pd version 0.35; -#X text 36 388 graz \, austria 2002; -#X connect 3 0 21 0; -#X connect 7 0 31 0; -#X connect 8 0 9 0; -#X connect 8 1 10 0; -#X connect 21 0 20 0; -#X connect 22 0 23 0; -#X connect 23 0 21 0; -#X connect 23 1 21 1; -#X connect 28 0 8 0; -#X connect 29 0 8 1; -#X connect 31 0 8 0; +#X restore 42 68 pd source; +#X text 340 95 [vu] has settable send; +#X text 11 23 gui-vu-meter-display; +#X text 98 493 12; +#X text 168 295 - rms level.; +#X text 168 396 - peak-level.; +#X text 168 412 - a list will be truncated to the first element.; +#X text 168 444 - rms level.; +#X text 168 466 - peak-level.; +#X text 98 328 bang; +#X text 168 328 - a bang will output the current values of the inlets. +; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X connect 29 0 36 0; +#X connect 30 0 41 0; #X connect 31 0 32 0; +#X connect 31 1 33 0; +#X connect 36 0 35 0; +#X connect 37 0 38 0; +#X connect 38 0 36 0; +#X connect 38 1 36 1; +#X connect 39 0 31 0; +#X connect 40 0 31 1; +#X connect 41 0 31 0; diff --git a/doc/pddp/wrap-help.pd b/pd/doc/5.reference/wrap-help.pd similarity index 100% rename from doc/pddp/wrap-help.pd rename to pd/doc/5.reference/wrap-help.pd diff --git a/pd/doc/5.reference/wrap~-help.pd b/pd/doc/5.reference/wrap~-help.pd index 81681f30a..2d3dad88d 100644 --- a/pd/doc/5.reference/wrap~-help.pd +++ b/pd/doc/5.reference/wrap~-help.pd @@ -1,26 +1,68 @@ -#N canvas 182 132 703 319 12; -#X obj 58 220 metro 500; -#X obj 58 195 r metro; -#X msg 575 106 \; metro 0; -#X msg 574 48 \; pd dsp 1 \; metro 1; -#X floatatom 42 121 0 0 0; -#X floatatom 42 277 0 0 0; -#X text 443 271 updated for Pd version 0.33; -#X obj 574 21 loadbang; -#X obj 42 244 snapshot~; -#X obj 42 147 sig~; -#X obj 36 16 wrap~; -#X text 93 16 - remainder modulo 1; -#X text 18 45 wrap~ gives the difference between the input and the +#N canvas 427 34 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 wrap~ 3 12 0 18 +-204280 -1 0; +#X obj 0 428 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 491 283 494 344 META 0; +#X text 12 105 LIBRARY internal; +#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 125 AUTHOR Miller Puckette; +#X text 12 185 HELP_PATCH_AUTHORS Updated for Pd version 0.33. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 5 KEYWORDS signal; +#X text 12 45 DESCRIPTION remainder modulo 1; +#X text 12 65 INLET_0 signal; +#X text 12 85 OUTLET_0 signal; +#X text 12 165 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 503 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 540 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 568 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#X text 98 544 (none); +#N canvas 214 518 428 109 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 obj 22 43 wrap; +#X text 8 2 [wrap~] Related Objects; +#X restore 102 597 pd Related_objects; +#X obj 78 437 cnv 17 3 55 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 512 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 509 10 wrap~; +#X obj 94 243 metro 500; +#X floatatom 78 144 0 0 0 0 - - -; +#X floatatom 78 290 0 0 0 0 - - -; +#X obj 78 267 snapshot~; +#X obj 78 170 sig~; +#X obj 78 194 wrap~; +#X obj 94 218 loadbang; +#X text 111 144 <- shift-drag here to get non-integers to try; +#X text 98 436 signal; +#X text 98 457 float; +#X text 98 477 list; +#X text 168 477 - a list will be truncated to the first item.; +#X text 98 511 signal; +#X text 11 23 remainder modulo 1; +#X text 168 436 - the incoming signal.; +#X text 168 457 - a float will automatically be converted to a signal. +; +#X text 74 317 [wrap~] gives the difference between the input and the largest integer not exceeding it (for positive numbers this is the fractional part).; -#X obj 42 171 wrap~; -#X text 127 123 <-- shift-drag here to get non-integers to try; -#X connect 0 0 8 0; -#X connect 1 0 0 0; -#X connect 1 0 0 0; -#X connect 4 0 9 0; -#X connect 7 0 3 0; -#X connect 8 0 5 0; -#X connect 9 0 13 0; -#X connect 13 0 8 0; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 482 55 pddp/dsp; +#X connect 12 0 15 0; +#X connect 13 0 16 0; +#X connect 15 0 14 0; +#X connect 16 0 17 0; +#X connect 17 0 15 0; +#X connect 18 0 12 0; diff --git a/pd/doc/5.reference/writesf~-help.pd b/pd/doc/5.reference/writesf~-help.pd index 03ea0b73b..60439e9bb 100644 --- a/pd/doc/5.reference/writesf~-help.pd +++ b/pd/doc/5.reference/writesf~-help.pd @@ -1,49 +1,98 @@ -#N canvas 146 65 733 567 12; -#X msg 592 11 \; pd dsp 1; -#X msg 141 163 print; -#X msg 53 83 bang; -#X msg 140 115 start; -#X msg 142 141 stop; -#X obj 53 114 del 1000; -#X text 41 9 writesf~ -- write audio signals to a soundfile; -#X text 230 212 creation argument is number of channels; -#X text 259 234 (1 to 64).; -#X text 193 115 start streaming audio; -#X text 188 141 stop streaming audio; -#X obj 131 207 writesf~ 2; -#X msg 131 31 open /tmp/foo.wav; -#X obj 131 538 soundfiler; -#X text 485 540 updated for Pd version 0.37; -#X text 36 539 see also:; -#X obj 145 185 osc~ 440; -#X text 34 257 writesf~ creates a subthread whose task is to write +#N canvas 431 36 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 writesf~ 3 12 0 +18 -204280 -1 0; +#X obj 0 267 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 488 285 494 344 META 0; +#X text 12 105 LIBRARY internal; +#X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 25 LICENSE SIBSD; +#X text 12 125 AUTHOR Miller Puckette; +#X text 12 185 HELP_PATCH_AUTHORS Updated for Pd version 0.37. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 5 KEYWORDS signal; +#X text 12 45 DESCRIPTION write audio signals to a soundfile; +#X text 12 65 INLET_0 signal open start stop print; +#X text 12 85 INLET_N signal; +#X text 12 165 RELEASE_DATE 1997; +#X restore 500 597 pd META; +#X obj 0 498 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 526 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 567 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 216 514 428 109 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 [writesf~] Related Objects; +#X obj 22 43 readsf~; +#X obj 80 43 soundfiler; +#X restore 102 597 pd Related_objects; +#X obj 78 276 cnv 17 3 183 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 465 cnv 17 3 17 empty \$0-pddp.cnv.let.n n 5 9 0 16 -228856 +-162280 0; +#X obj 486 10 writesf~; +#X text 98 502 (none); +#X msg 77 179 print; +#X msg 9 103 bang; +#X msg 76 135 start; +#X msg 78 157 stop; +#X obj 9 134 del 1000; +#X obj 67 223 writesf~ 2; +#X msg 67 65 open /tmp/foo.wav; +#X obj 81 201 osc~ 440; +#X msg 67 111 open -bytes 4 /tmp/foo.wav; +#X text 176 64 create a new 16-bit soundfile; +#X text 233 88 create 24-bit soundfile; +#X text 232 111 create 32-bit floating-point soundfile; +#X msg 67 88 open -bytes 3 /tmp/foo.wav; +#X text 11 23 write audio signals to a soundfile; +#X text 98 275 signal; +#X text 98 292 open; +#X text 98 415 start; +#X text 98 430 stop; +#X text 98 445 print; +#X text 98 464 signal; +#X text 167 464 - an additional inlet is created for each channel specified +by the creation argument.; +#X text 202 328 -wave \, -nextstep \, -aiff; +#X text 203 343 -big \, -little (nextstep only!); +#X text 203 358 -bytes <2 \, 3 \, or 4>; +#X text 203 374 -rate <sample rate>; +#X text 167 389 (setting sample rate will affect the soundfile header +but the file will _not_ be resampled.); +#X text 168 292 - the "open" message creates a new soundfile that can +be written to. The "open" message may take flag-style arguments as +follows:; +#X text 168 415 - start streaming audio to disk.; +#X text 168 430 - stop streaming audio to disk.; +#X text 149 206 The soundfile is 2- or 3-byte fixed point ("pcm") or +4-byte floating-point. The soundfile format is determined by the file +extent ("foo.wav" \, "foo.aiff" \, or "foo.snd").; +#X text 149 138 [writesf~] creates a subthread whose task is to write audio streams to disk. You need not provide any disk access time between "open" and "start" \, but between "stop" and the next "open" you must give the object time to flush all the output to disk.; -#X msg 131 86 open -bytes 4 /tmp/foo.wav; -#X text 300 30 create a new 16-bit soundfile; -#X text 377 59 create 24-bit soundfile; -#X text 376 86 create 32-bit floating-point soundfile; -#X msg 131 59 open -bytes 3 /tmp/foo.wav; -#X text 33 339 The soundfile is 2- or 3-byte fixed point ("pcm") or -4-byte floating-point. The soundfile format is determined by the file -extent ("foo.wav" \, "foo.aiff" \, or "foo.snd").; -#X obj 233 540 readsf~; -#X text 66 413 -wave \, -nextstep \, -aiff; -#X text 67 434 -big \, -little (nextstep only!); -#X text 67 455 -bytes <2 \, 3 \, or 4>; -#X text 67 477 -rate <sample rate>; -#X text 32 395 The "open" message may take flag-style arguments as -follows:; -#X text 27 498 (setting sample rate will affect the soundfile header -but the file will _not_ be resampled.); -#X connect 1 0 11 0; -#X connect 2 0 3 0; -#X connect 2 0 5 0; -#X connect 3 0 11 0; -#X connect 4 0 11 0; -#X connect 5 0 4 0; -#X connect 12 0 11 0; -#X connect 16 0 11 0; -#X connect 18 0 11 0; -#X connect 22 0 11 0; +#X text 168 445 - print debugging information.; +#X text 168 275 - the incoming signal is written to the file.; +#X text 168 544 - the creation argument is the number of channels (1 +to 64).; +#X text 80 544 1) float; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 478 54 pddp/dsp; +#X connect 12 0 17 0; +#X connect 13 0 14 0; +#X connect 13 0 16 0; +#X connect 14 0 17 0; +#X connect 15 0 17 0; +#X connect 16 0 15 0; +#X connect 18 0 17 0; +#X connect 19 0 17 0; +#X connect 20 0 17 0; +#X connect 24 0 17 0; diff --git a/pd/doc/5.reference/x_all_guis.pd b/pd/doc/5.reference/x_all_guis.pd index 3c18031bf..954f8e5a7 100644 --- a/pd/doc/5.reference/x_all_guis.pd +++ b/pd/doc/5.reference/x_all_guis.pd @@ -1,20 +1,19 @@ -#N canvas 209 342 290 271 10; -#X obj 23 31 bng 15 250 50 532480 \$1 \$1 empty 20 8 192 8 -262144 --1 -1; -#X obj 23 63 tgl 15 1.06496e+06 \$2 \$2 empty 20 8 192 8 -262144 -1 +#N canvas 428 44 290 271 10; +#X obj 23 31 bng 15 250 50 0 \$1 \$1 empty 20 8 0 8 -262144 -1 -1; +#X obj 23 63 tgl 15 1.04858e+06 \$2 \$2 empty 20 8 0 8 -262144 -1 -1 +0 1; +#X obj 22 95 vsl 15 128 0 127 0 1.04858e+06 \$3 \$3 empty 20 8 0 8 +-262144 -1 -1 0 1; +#X obj 65 30 hsl 128 15 0 127 0 0 \$4 \$4 empty 20 8 0 8 -262144 -1 -1 0 1; -#X obj 22 95 vsl 15 128 0 127 0 1.59744e+06 \$3 \$3 empty 20 8 192 -8 -262144 -1 -1 0 1; -#X obj 65 30 hsl 128 15 0 127 0 2.12992e+06 \$4 \$4 empty 20 8 192 -8 -262144 -1 -1 0 1; #X obj 63 63 hdl 15 1 2.6624e+06 8 \$5 \$5 empty 20 8 192 8 -262144 -1 -1 0; -#X obj 62 99 vu 15 120 \$6 empty 35 8 64 8 -66577 -1 1 49152; -#X obj 115 99 cnv 15 100 60 \$7 \$7 \$7 20 12 917696 14 -233017 -66577 -3.72736e+06; +#X obj 62 99 vu 15 120 \$6 empty 35 8 0 8 -66577 -1 1 0; +#X obj 115 99 cnv 15 100 60 \$7 \$7 \$7 20 12 0 14 -233017 -66577 1.04858e+06 +; #X obj 41 308 inlet; #X obj 41 334 outlet; #X obj 227 30 vdl 15 1 4.79232e+06 8 \$9 \$9 empty 20 8 192 8 -262144 -1 -1 0; -#X obj 116 176 nbx 5 14 -1e+37 1e+37 0 4.25984e+06 \$8 \$8 empty 45 -7 192 10 -262144 -1 -1 0; +#X obj 116 176 nbx 5 14 -1e+37 1e+37 0 0 \$8 \$8 empty 45 7 0 10 -262144 +-1 -1 0 256 0; diff --git a/doc/pddp/zexy.pd b/pd/doc/5.reference/zexy.pd similarity index 100% rename from doc/pddp/zexy.pd rename to pd/doc/5.reference/zexy.pd -- GitLab