diff options
Diffstat (limited to 'doc/pddp/tabread4-help.pd')
-rw-r--r-- | doc/pddp/tabread4-help.pd | 273 |
1 files changed, 125 insertions, 148 deletions
diff --git a/doc/pddp/tabread4-help.pd b/doc/pddp/tabread4-help.pd index 33923d72..36478c85 100644 --- a/doc/pddp/tabread4-help.pd +++ b/doc/pddp/tabread4-help.pd @@ -1,148 +1,125 @@ -#N canvas 2 1 658 618 12;
-#X obj 114 560 pddp/pddplink http://puredata.info/dev/pddp -text pddp;
-#X obj 8 3 cnv 15 90 578 empty empty empty 20 12 0 14 -233017 -66577
-0;
-#X text 14 213 ARGUMENTS:;
-#X text 19 323 EXAMPLES:;
-#X text 22 471 SEE ALSO:;
-#N canvas 58 0 407 256 Related_Objects 0;
-#X text 25 11 Native Pd Objects;
-#X text 16 166 Externals and other object libraries;
-#X obj 16 41 tabread~;
-#X obj 165 41 tabwrite;
-#X obj 240 41 tabwrite~;
-#X obj 16 67 tabsend~;
-#X obj 92 67 tabreceive~;
-#X obj 192 67 tabplay~;
-#X obj 269 67 table;
-#X text 15 124 [array];
-#X obj 16 94 soundfiler;
-#X text 78 124 and fft objects.;
-#X text 21 187 [tabdump];
-#X obj 112 94 tabread4~;
-#X text 20 207 [tabenv];
-#X obj 203 94 getsize;
-#X obj 274 94 setsize;
-#X text 238 207 [arraysize];
-#X text 238 186 [score];
-#X text 114 186 [linear_path];
-#X text 114 207 [plot];
-#X obj 90 41 tabread;
-#X restore 114 508 pd Related_Objects;
-#N canvas 80 0 659 614 More_Info 0;
-#X text 46 564 Also See:;
-#X obj 125 564 pddp/pddplink all_about_arrays.pd -text all_about_arrays;
-#X text 21 8 WHAT IS INTERPOLATION?;
-#X text 38 34 "Interpolation" is a word which described a sophisticated
-way to "connect-the-dots". (This is over simplified \, but effective
-for the time being.);
-#X text 17 85 Let's say for example that we have an array whose values
-are: 0 \, 6 \, 5;
-#X text 36 120 There are 3 elements in this array \, right? Well \,
-using [tabread] we could successfully read only 3 numbers. But interpolation
-allows us to fill in the gaps between those values in a meaningful
-way. For example \, we can assume that between 0 and 6 \, we might
-find 4.5! We can also assume that the slope from 0 to 6 will be sharper
-than the slope from 6 to 5 In this way \, using [tabread4] will allow
-us to create much smoother lines and curves between our "dots".;
-#X text 35 254 However \, this process is much more complicated than
-mere "smoothing". 4-point interpolation incorporates a sophisticated
-formula to intelligently create meaningful increments between values
-in an array. For example: we could draw a few points on a baseball
-diamond between the pitcher's mound and home plate. Those points could
-represent the path a ball travels after a pitch. Using 4-point interpolation
-\, we might be able to assume the positions of the ball between our
-"known" points and determine whether the pitch was a fastball or a
-curve ball.;
-#X text 35 419 There are different formulas used to interpolate arrays.
-Each method has a sort of niche where it is most comfortable and most
-effective. Pd \, like most contemporary audio software \, uses 4-point
-interpolation which is also known as "Hermite" interpolation. It is
-the most "intelligent" 2-dimensional method of interpolation.;
-#N canvas 167 0 570 613 What_does_it_really_do? 0;
-#X text 20 10 Let's see [tabread4] at work...;
-#N canvas 0 0 450 300 graph36 0;
-#X array original_array 10 float 1;
-#A 0 -0.324999 -0.274999 -0.0749997 0.174999 -0.624998 0.649998 0.599998
-0.524998 -0.749997 -0.774996;
-#X coords 0 1 9 -1 200 140 1;
-#X restore 292 9 graph;
-#X text 37 158 The array above has only 10 elements. You can draw new
-shapes with your mouse.;
-#X obj 14 202 bng 15 250 50 0 empty empty Bang_me 18 7 0 8 -24198 -1
--1;
-#X obj 88 246 until;
-#N canvas 0 0 450 300 graph37 0;
-#X array interpolation 1000 float 0;
-#X coords 0 1 999 -1 200 140 1;
-#X restore 304 445 graph;
-#X obj 84 341 tabread4 original_array;
-#X obj 88 270 f;
-#X obj 118 270 + 1;
-#X obj 84 368 tabwrite interpolation;
-#X obj 87 295 t f f;
-#X obj 14 222 t b b;
-#X msg 48 250 0;
-#X obj 86 318 / 100;
-#X msg 88 222 1000;
-#X text 36 395 The array below has 1000 elements. At this resolution
-\, you will see the overall effect of 4-point interpolation.;
-#X connect 3 0 11 0;
-#X connect 4 0 7 0;
-#X connect 6 0 9 0;
-#X connect 7 0 8 0;
-#X connect 7 0 10 0;
-#X connect 8 0 7 1;
-#X connect 10 0 13 0;
-#X connect 10 1 9 1;
-#X connect 11 0 14 0;
-#X connect 11 1 12 0;
-#X connect 12 0 7 1;
-#X connect 13 0 6 0;
-#X connect 14 0 4 0;
-#X restore 36 526 pd What_does_it_really_do?;
-#X restore 114 534 pd More_Info;
-#X floatatom 161 443 0 0 0 3 - - -;
-#X floatatom 116 364 0 0 1000 1 location - -;
-#X msg 286 389 set another_table;
-#X text 106 162 Set - the "set <arrayname>" message allows you to read
-from dynamic sources. You can change the source at any time using the
-"set" message.;
-#X text 29 266 OUTLETS:;
-#X obj 486 442 table another_table;
-#X text 106 323 Open the tables and use your mouse to draw new values
-in the arrays - otherwise [tabread] will always output "0".;
-#X text 39 34 INLETS:;
-#X text 112 470 doc/2.control.examples/15.arrays.pd;
-#X text 113 489 doc/2.control.examples/16.more.arrays.pd;
-#X obj 21 10 tabread4;
-#X text 111 10 - READ NUMBERS FROM A TABLE WITH 4-POINT INTERPOLATION
-;
-#X text 105 213 One - the argument informs [tabread4] 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 104 265 One - outputs a floating point number representing
-an interpolation of the array value corresponding to the location described
-at the inlet.;
-#X text 107 34 Float - A float at the left inlet will move to the corresponding
-location in the table's array. The lowest valid number is "0" which
-represents the first element of the array. The highest valid number
-is a fraction below the actual length of the array. Each fractional
-increment between the lower and upper bounds of the array will produce
-an interpolation of the actual array values at the outlet.;
-#X msg 248 364 set davids_array;
-#N canvas 0 0 450 300 graph27 0;
-#X array davids_array 10 float 1;
-#A 0 0 0.749989 0 -0.849987 0 -0.349995 0.949986 0 -0.699989 -0.399994
-;
-#X coords 0 1 9 -1 100 40 1;
-#X restore 526 380 graph;
-#X text 249 444 interpolation;
-#X obj 121 390 / 100;
-#X obj 161 416 tabread4 davids_array;
-#X text 158 561 - Dave Sabine \, May 2 \, 2003;
-#X connect 8 0 25 0;
-#X connect 9 0 26 0;
-#X connect 22 0 26 0;
-#X connect 25 0 26 0;
-#X connect 26 0 7 0;
+#N canvas 0 0 555 619 10; +#X obj 0 595 cnv 15 552 21 empty \$0-pddp.cnv.footer empty 20 12 0 +14 -228856 -66577 0; +#X obj 0 0 cnv 15 552 40 empty \$0-pddp.cnv.header tabread4 3 12 0 +18 -204280 -1 0; +#X obj 0 247 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 53 247 494 344 META 0; +#X text 12 115 PLATFORM windows macosx gnulinux; +#X text 12 175 LIBRARY internal; +#X text 12 215 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 65 LICENSE SIBSD; +#X text 12 195 AUTHOR Miller Puckette; +#X text 12 275 HELP_PATCH_AUTHORS Dave Sabine \, May 2 \, 2003 Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 5 GENRE help; +#X text 12 45 KEYWORDS control array; +#X text 12 85 DESCRIPTION read numbers from a table with 4-point interpolation +; +#X text 12 25 NAME tabread4; +#X text 12 155 OUTLET_0 float; +#X text 12 135 INLET_0 float set; +#X text 12 235 RELEASE_DATE 1997; +#X text 12 255 RELEASE_VERSION; +#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 475 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 74 320 428 293 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 [tabread4] 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 211 116 getsize; +#X obj 120 116 tabosc4~; +#X text 22 165 Externals and other object libraries; +#X obj 22 185 pddp/helplink zexy/tabdump; +#X obj 22 205 pddp/helplink linear_path; +#X text 103 205 <-- which library is this in?; +#X text 103 225 <-- which library is this in?; +#X obj 22 225 pddp/helplink score; +#X text 103 245 <-- which library is this in?; +#X obj 22 245 pddp/helplink tabenv; +#X obj 22 265 pddp/helplink flatspace/arraysize; +#X restore 102 597 pd Related_objects; +#X obj 78 256 cnv 17 3 160 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 255 float; +#X text 98 362 list; +#X text 98 430 float; +#X obj 78 431 cnv 17 3 40 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 466 3 tabread4; +#X obj 435 20 pddp/pddplink http://wiki.puredata.info/en/tabread4 -text +pdpedia: tabread4; +#X floatatom 101 216 0 0 0 0 interpolation - -; +#X floatatom 101 107 0 0 1000 0 location - -; +#N canvas 0 0 450 300 (subpatch) 0; +#X array \$0-array 10 float 1; +#A 0 0 0.749989 0 -0.849987 0 -0.349995 0.949986 0 -0.699989 -0.399994 +; +#X coords 0 1 9 -1 100 40 1; +#X restore 316 73 graph; +#X text 168 362 - a list will be truncated to the first item.; +#X text 98 377 set; +#X text 168 255 - a float at the left inlet will move to the corresponding +location in the table's array. The lowest valid number is "0" which +represents the first element of the array. The highest valid number +is a fraction below the actual length of the array (values out of range +are ignored). Each fractional increment between the lower and upper +bounds of the array will produce an interpolation of the actual array +values at the outlet.; +#X text 168 377 - 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 558 doc/2.control.examples/15.arrays.pd; +#X text 98 573 doc/2.control.examples/16.more.arrays.pd; +#X text 168 430 - outputs a floating point number representing an interpolation +of the array value corresponding to the location described at the inlet. +; +#X text 11 23 read numbers from a table with 4-point interpolation +; +#X obj 98 543 pddp/pddplink all_about_arrays.pd -text all_about_arrays +; +#X obj 101 132 / 100; +#X text 323 163 Draw values in the table below:; +#X text 168 493 - the name of the array or table to read. The array +or table must exist in an open Pd patch/canvas or an error message +will appear in the console.; +#X text 80 493 1) symbol atom; +#X obj 4 597 pddp/pddplink pddp/help.pd -text help; +#X obj 101 189 tabread4 \$0-array; +#X obj 172 125 bng 15 250 50 0 empty empty empty 17 7 0 10 -4034 -1 +-1; +#X obj 172 145 f \$0; +#X msg 172 166 set \$1-another_table; +#X obj 374 182 table \$0-another_table 10; +#X obj 182 47 bng 15 250 50 0 empty empty empty 17 7 0 10 -4034 -1 +-1; +#X obj 182 67 f \$0; +#X msg 182 89 set \$1-array; +#X connect 16 0 27 0; +#X connect 27 0 32 0; +#X connect 32 0 15 0; +#X connect 33 0 34 0; +#X connect 34 0 35 0; +#X connect 35 0 32 0; +#X connect 37 0 38 0; +#X connect 38 0 39 0; +#X connect 39 0 32 0; |