diff options
Diffstat (limited to 'externals/gridflow/doc/tutorials')
24 files changed, 0 insertions, 1552 deletions
diff --git a/externals/gridflow/doc/tutorials/gf_sampling_quantization.pd b/externals/gridflow/doc/tutorials/gf_sampling_quantization.pd deleted file mode 100644 index 4f60217d..00000000 --- a/externals/gridflow/doc/tutorials/gf_sampling_quantization.pd +++ /dev/null @@ -1,57 +0,0 @@ -#N canvas 740 0 704 805 10; -#X obj 2 5 cnv 15 650 15 empty empty empty 20 12 0 14 -228992 -66577 -0; -#X obj 2 -30 cnv 15 700 30 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X obj 0 741 cnv 15 700 30 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X text 14 746 GridFlow 0.9.1; -#X text 7 -23 Principles of new media; -#X text 218 152 <-- reduces the size of the image; -#X text 5 3 1.1 sampling; -#X obj 4 314 cnv 15 650 15 empty empty empty 20 12 0 14 -228992 -66577 -0; -#X text 7 313 1.2 quantization; -#X text 330 85 <-- change the resampling factor (1 to 8); -#X obj 55 80 #in; -#X obj 55 32 tgl 15 0 empty empty empty 17 7 0 10 -4034 -1 -1 1 1; -#X obj 75 259 #out window \, title sampling; -#X obj 55 204 #scale_by; -#X obj 202 86 hradio 15 1 0 8 empty empty empty 0 -8 0 10 -257985 -1 --1 0; -#X obj 202 108 + 1; -#X obj 202 130 t a a; -#X text 218 152 <-- reduces the size of the image; -#X msg 123 55 open babbage.jpg; -#X obj 55 419 #out window \, title quantization; -#X text 230 53 <-- open image first; -#X floatatom 124 365 5 0 0 0 - - -; -#X obj 24 449 #downscale_by 32 smoothly; -#X obj 25 518 display; -#X obj 34 470 #out window \, title really_small_window; -#X text 133 385 <-- reduces the number of possible pixel values; -#X text 121 201 <-- increases the image size by the same factor \, -letting us see the loss of information from the original image; -#X obj 55 152 #downscale_by \, smoothly; -#X obj 127 343 hsl 128 15 2 16 0 0 empty empty empty -2 -8 0 10 -257985 --1 -1 3300 1; -#X obj 55 54 metro 100; -#X obj 55 385 #posterize 2; -#X text 262 342 <-- number of tones per channel; -#X connect 10 0 27 0; -#X connect 11 0 29 0; -#X connect 13 0 12 0; -#X connect 13 0 30 0; -#X connect 14 0 15 0; -#X connect 15 0 16 0; -#X connect 16 0 27 1; -#X connect 16 1 13 1; -#X connect 18 0 10 0; -#X connect 21 0 30 1; -#X connect 22 0 23 0; -#X connect 22 0 24 0; -#X connect 27 0 13 0; -#X connect 28 0 21 0; -#X connect 29 0 10 0; -#X connect 30 0 19 0; -#X connect 30 0 22 0; diff --git a/externals/gridflow/doc/tutorials/gf_tutorial_grid_1.pd b/externals/gridflow/doc/tutorials/gf_tutorial_grid_1.pd deleted file mode 100644 index e86ff88f..00000000 --- a/externals/gridflow/doc/tutorials/gf_tutorial_grid_1.pd +++ /dev/null @@ -1,25 +0,0 @@ -#N canvas 363 183 701 242 10; -#X obj 2 5 cnv 15 430 15 empty empty empty 20 12 0 14 -228992 -66577 -0; -#X obj 2 -30 cnv 15 700 30 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X text 5 5 1.1 What is a grid?; -#X text 7 -23 1 Introduction to Grids; -#X obj 0 178 cnv 15 700 30 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X obj 523 56 bng 15 250 50 0 empty empty empty 0 -6 0 8 -24198 -1 --1; -#X obj 537 119 #out window; -#X obj 537 88 #in david.jpg; -#X text 14 183 GridFlow 0.9.0; -#X text 5 28 A grid is composed of rows and columns that contain numeric -data. GridFlow usually interprets images as three-dimensional grids -with rows (height) and columns (width). Each channel is a single colour -\, usually red \, green and blue (RGB). The channels make up the colour -information of an image. Videos are also interpreted as grids since -each frame is a still image.; -#X text 5 125 GridFlow objects that accept or produce grids are identified -by the number sign "#" (a mini grid). From now on \, the term "grid" -is used to identify an image or video.; -#X connect 5 0 7 0; -#X connect 7 0 6 0; diff --git a/externals/gridflow/doc/tutorials/gf_tutorial_grid_2.pd b/externals/gridflow/doc/tutorials/gf_tutorial_grid_2.pd deleted file mode 100644 index 59aecb1a..00000000 --- a/externals/gridflow/doc/tutorials/gf_tutorial_grid_2.pd +++ /dev/null @@ -1,64 +0,0 @@ -#N canvas 376 138 1022 422 10; -#X obj 1 14 cnv 15 460 15 empty empty empty 20 12 0 14 -228992 -66577 -0; -#X text 4 14 1.2 How to create a grid.; -#X obj 1 14 cnv 15 430 15 empty empty empty 20 12 0 14 -228992 -66577 -0; -#X text 5 14 1.2 Creating a grid using the [#import] object.; -#X text 5 40 GridFlow can create a grid from a list of numbers. The -[#import] object permits you to set the desired amount of rows and -columns. A message box must be connected to tell the grid which numbers -to display.; -#X text 6 109 Steps to create a grid:; -#X text 7 134 1 - Create a list of numbers using a message box (the -numbers must be seperated by a space). The list can have as many numbers -as you want but only the amount defined by [#import] will be displayed. -As you click on the message box the numbers will appear in the grid. -Note how the numbers are positioned in the grid from left to right -and from the top to the bottom.; -#X text 7 229 2 - Create the [#import] object and indicate the parameters -you want as grid dimensions. By indicating 3 3 in brackets following -[#import] \, you are creating a grid that has 3 rows and 3 columns. -A 3 by 3 grid will displays 9 numbers.; -#X text 8 291 3 - Connect the objects to a [display] object or a [print] -object to see the resulting grid. You can alter your grid without actually -seeing the image.; -#X obj 1 -30 cnv 15 1020 30 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X obj 1 -30 cnv 15 780 30 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X text 6 -23 1 Introduction to Grids; -#X obj 1 356 cnv 15 1020 30 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X obj 479 285 display; -#X msg 547 154 reset; -#X obj 476 15 cnv 15 545 15 empty empty empty 20 12 0 14 -228992 -66577 -0; -#X obj 476 15 cnv 15 430 15 empty empty empty 20 12 0 14 -228992 -66577 -0; -#X obj 673 50 cnv 15 15 15 empty empty empty 20 12 0 14 -259603 -66577 -0; -#X obj 478 223 cnv 15 92 15 empty empty empty 20 12 0 14 -241291 -66577 -0; -#X obj 478 222 #import (3 3); -#X msg 478 51 1 2 3 4 5 6 7 8 9; -#X msg 535 99 1 2 3 4; -#X text 483 15 1.2 Patch example.; -#X text 610 155 <-- resets the grid to only display the numbers from -the list; -#X obj 652 217 cnv 15 15 15 empty empty empty 20 12 0 14 -259603 -66577 -0; -#X text 610 97 <-- click here three times to see how [#import] only -outputs a grid once it recieves the number of values associated with -its dimensions; -#X text 590 217 <-- step 2: click here to create a grid that has 3 -rows and 3 columns (try changing these numbers to alter the dimensions -of the grid).; -#X text 592 287 <-- the display object outputs results.; -#X text 611 50 <-- step 1: click here to view the numbers from the -list in a grid.; -#X text 9 363 GridFlow 0.9.0; -#X connect 14 0 19 0; -#X connect 19 0 13 0; -#X connect 20 0 19 0; -#X connect 21 0 19 0; diff --git a/externals/gridflow/doc/tutorials/gf_tutorial_grid_3.pd b/externals/gridflow/doc/tutorials/gf_tutorial_grid_3.pd deleted file mode 100644 index 4e5e5778..00000000 --- a/externals/gridflow/doc/tutorials/gf_tutorial_grid_3.pd +++ /dev/null @@ -1,30 +0,0 @@ -#N canvas 106 132 652 402 10; -#X obj 7 11 cnv 15 640 15 empty empty empty 20 12 0 14 -228992 -66577 -0; -#X text 10 11 1.2 How to create a grid.; -#X obj 7 11 cnv 15 430 15 empty empty empty 20 12 0 14 -228992 -66577 -0; -#X text 11 11 1.3 Creating a grid using the [# + 0] object.; -#X obj 7 -29 cnv 15 640 30 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X text 12 -22 1 Introduction to Grids; -#X obj 279 117 cnv 15 15 15 empty empty empty 20 12 0 14 -259603 -66577 -0; -#X text 216 255 <-- the display object outputs results.; -#X text 217 116 <-- step 1: click on either message box to view the -numbers from the list in a grid.; -#X text 9 36 The [# + 0] object works like [#import] but allows you -to put your grid parameters and values into one message box instead -of having to insert them into the object box.; -#X obj 5 337 cnv 15 640 30 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X msg 16 113 3 3 # 6 1 3 6 3 324 6 3 4; -#X msg 37 159 3 3 # 1 0 0 0; -#X obj 17 254 display; -#X obj 16 204 cnv 15 37 15 empty empty empty 20 12 0 14 -241291 -66577 -0; -#X obj 16 203 # + 0; -#X text 14 345 GridFlow 0.8.4; -#X connect 11 0 15 0; -#X connect 12 0 15 0; -#X connect 15 0 13 0; diff --git a/externals/gridflow/doc/tutorials/gf_tutorial_image_1.pd b/externals/gridflow/doc/tutorials/gf_tutorial_image_1.pd deleted file mode 100644 index 1c0fa483..00000000 --- a/externals/gridflow/doc/tutorials/gf_tutorial_image_1.pd +++ /dev/null @@ -1,65 +0,0 @@ -#N canvas 523 65 902 461 10; -#X obj 4 323 cnv 15 900 30 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X obj 5 -67 cnv 15 430 15 empty empty empty 20 12 0 14 -228992 -66577 -0; -#X obj 5 -106 cnv 15 900 30 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X obj 5 -106 cnv 15 780 30 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X text 12 -99 2 Introduction to Images; -#X obj 450 -67 cnv 15 430 15 empty empty empty 20 12 0 14 -228992 -66577 -0; -#X text 453 -67 1.2 How to create a grid.; -#X obj 450 -67 cnv 15 430 15 empty empty empty 20 12 0 14 -228992 -66577 -0; -#X obj 112 167 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 621 48 cnv 15 15 15 empty empty empty 20 12 0 14 -259603 -66577 -0; -#X obj 621 100 cnv 15 15 15 empty empty empty 20 12 0 14 -259603 -66577 -0; -#X text 557 99 <-- step #2 : click here to update the image; -#X text 556 47 <-- step #1 : click here to load the image; -#X text 8 169 step 3: Add a; -#X text 7 136 step 2: Create [#in] object; -#X text 8 202 step 4: Create a [#out window]; -#X text 6 98 step 1:; -#X obj 450 264 cnv 15 25 15 empty empty empty 20 12 0 14 -260818 -66577 -0; -#X text 449 264 Tip:; -#X text 485 263 Remember \, as with the rest of PD \, you can obtain -information regarding specific objects by right-clicking on it. Try -this for [#in].; -#X text 6 250 GridFlow accepts several image formats including .jpg -\, .png \, .tiff.; -#X text 449 213 The [#out window] object must be deleted in order to -close the display window the image is in.; -#X text 8 -46 The following steps outline the items that you need to -open a grid. Whether it be an image or a video you want to open theses -four steps are necessary.; -#X text 8 2 In order for GridFlow to recognize your media files by -file name you have to put them in the "images" folder (located within -the GridFlow directory). Another way to locate an image is to specify -the path to where it is saved on your hard drive in the message box. -; -#X text 452 -46 To view the image you must initialize the patch. Click -on the message box \, and then on the bang (this must be done in the -run mode). The image will appear in a display window \, off to the -side of the patch. Sometimes the display window opens behind the patch -\, try moving the patch if the display seems to be missing.; -#X text 459 -66 2.1 Patch Example; -#X text 8 -68 2.1 Opening an Image; -#X obj 450 140 cnv 15 22 15 empty empty empty 20 12 0 14 -241291 -66577 -0; -#X obj 450 180 #out window; -#X msg 450 48 open b001.jpg; -#X obj 534 99 bng 15 250 50 0 empty empty empty 0 -6 0 8 -24198 -1 --1; -#X obj 450 139 #in; -#X text 62 113 extension you want to open; -#X text 63 99 Create message box [open< with the file name and; -#X text 11 329 GridFlow 0.9.0; -#X connect 29 0 31 0; -#X connect 30 0 31 0; -#X connect 31 0 28 0; diff --git a/externals/gridflow/doc/tutorials/gf_tutorial_image_2.pd b/externals/gridflow/doc/tutorials/gf_tutorial_image_2.pd deleted file mode 100644 index affb33b7..00000000 --- a/externals/gridflow/doc/tutorials/gf_tutorial_image_2.pd +++ /dev/null @@ -1,63 +0,0 @@ -#N canvas 257 0 660 624 10; -#X obj 3 -37 cnv 15 653 15 empty empty empty 20 12 0 14 -228992 -66577 -0; -#X obj 3 -72 cnv 15 653 30 empty empty empty 20 12 0 14 -233017 -355 -0; -#X obj 3 517 cnv 15 653 30 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X obj 268 271 cnv 15 15 15 empty empty empty 20 12 0 14 -259603 -66577 -0; -#X obj 152 134 cnv 15 15 15 empty empty empty 20 12 0 14 -259603 -66577 -0; -#X text 88 133 <-- step #2 : start the metro; -#X obj 203 363 cnv 15 15 15 empty empty empty 20 12 0 14 -259603 -66577 -0; -#X obj 246 465 cnv 15 20 15 empty empty empty 20 12 0 14 -260818 -66577 -0; -#X text 111 159 the metro refreshes the display window so you don't -have to reload the grid every time it's altered.; -#X text 204 271 <-- step #1 : load the image; -#X text 245 464 Tip: try replacing this number box with a slider.; -#X text 139 363 <-- step #3 : change the grid's vertical parameters -; -#X obj 247 405 cnv 15 15 15 empty empty empty 20 12 0 14 -259603 -66577 -0; -#X text 15 -38 2.2 Resizing an image; -#X text 10 82 [# pack] lets you resize grids by altering the vertical -and horizontal parameters.; -#X text 10 34 If you want to make your image four times its size \, -you would have to insert a 4 into the object \; [#scale_by 4].; -#X text 9 -10 [#scale_by] resizes grids by multiplying its parameters -(width and height). To resize an image proportionatly a specific scaling -size must be identified within the object.; -#X text 183 405 <-- step #4 : change the grid's horizontal parameters -; -#X text 17 -67 2 Introduction to Images; -#X obj 16 177 metro 10; -#X obj 16 135 tgl 15 0 empty empty empty 0 -6 0 8 -24198 -1 -1 0 1 -; -#X floatatom 74 368 5 1 4 0 - - -; -#X obj 16 482 #out window; -#X obj 53 295 #in; -#X msg 53 272 load bluemarble.jpg; -#X obj 74 431 #pack 2; -#X obj 16 319 #store; -#X obj 16 319 #store; -#X obj 53 249 loadbang; -#X obj 17 458 cnv 15 63 15 empty empty empty 20 12 0 14 -241291 -66577 -0; -#X obj 16 457 #scale_by; -#X floatatom 118 406 5 0 0 0 - - -; -#X text 11 524 GridFlow 0.8.4; -#X connect 19 0 26 0; -#X connect 19 0 27 0; -#X connect 20 0 19 0; -#X connect 21 0 25 0; -#X connect 23 0 26 1; -#X connect 23 0 27 1; -#X connect 24 0 23 0; -#X connect 25 0 30 1; -#X connect 27 0 30 0; -#X connect 28 0 24 0; -#X connect 30 0 22 0; -#X connect 31 0 25 1; diff --git a/externals/gridflow/doc/tutorials/gf_tutorial_image_3.pd b/externals/gridflow/doc/tutorials/gf_tutorial_image_3.pd deleted file mode 100644 index 03d8c056..00000000 --- a/externals/gridflow/doc/tutorials/gf_tutorial_image_3.pd +++ /dev/null @@ -1,84 +0,0 @@ -#N canvas 0 87 993 482 10; -#X obj 6 38 cnv 15 430 15 empty empty empty 20 12 0 14 -228992 -66577 -0; -#X obj 6 3 cnv 15 1000 30 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X obj 5 149 cnv 15 430 15 empty empty empty 20 12 0 14 -228992 -66577 -0; -#X obj 530 134 bng 15 250 50 0 empty empty empty 0 -6 0 8 -24198 -1 --1; -#X obj 484 163 #in; -#X obj 484 191 cnv 15 42 17 empty empty empty 20 12 0 14 -241291 -66577 -0; -#X text 8 180 In this section we will introduce some very basic functions -of the numeric operator \, one of the most common methods used for -image transformation.; -#X text 7 69 GridFlow performs high level grid processing \; in other -words its main function is the manipulation of images and video. There -are several ways to modify images in GridFlow \, some are very basic -while others are more advanced.; -#X text 9 234 Numeric Operators (numop): transform grids by applying -a mathematical operation to each pixel value.; -#X obj 6 455 cnv 15 1000 30 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X text 18 37 2.3 Image Manipulation; -#X text 17 148 Image Manipulation Using Numeric Operators; -#X text 8 277 To transform a grid the numop must first be given an -argument. That argument will be applied to every pixel in the grid. -The following three examples show some ways to give the numop an argument. -; -#X obj 460 38 cnv 15 430 15 empty empty empty 20 12 0 14 -228992 -66577 -0; -#X text 465 62 Altering a grid by placing an argument directly into -the numop object.; -#X obj 560 343 cnv 15 42 17 empty empty empty 20 12 0 14 -241291 -66577 -0; -#X obj 561 382 display; -#X msg 483 278 1 2 3 4 5 6 7 8 9; -#X obj 483 307 #import (3 3); -#X obj 484 382 display; -#X obj 10 38 cnv 15 430 15 empty empty empty 20 12 0 14 -228992 -66577 -0; -#X text 22 37 2.3 Image Manipulation; -#X obj 10 38 cnv 15 430 15 empty empty empty 20 12 0 14 -228992 -66577 -0; -#X text 22 37 2.3 Image Manipulation; -#X obj 672 103 cnv 15 15 15 empty empty empty 20 12 0 14 -259603 -66577 -0; -#X obj 11 352 cnv 15 20 15 empty empty empty 20 12 0 14 -260818 -66577 -0; -#X text 422 361 --->; -#X text 608 103 <-- step #1 : click here to load the image; -#X obj 672 133 cnv 15 15 15 empty empty empty 20 12 0 14 -259603 -66577 -0; -#X obj 624 189 cnv 15 15 15 empty empty empty 20 12 0 14 -259603 -66577 -0; -#X text 608 133 <-- step #2 : click here to view the image; -#X text 658 201 the value (42); -#X text 560 188 <-- step #3 : try altering the argument by changing -; -#X obj 691 276 cnv 15 15 15 empty empty empty 20 12 0 14 -259603 -66577 -0; -#X obj 691 342 cnv 15 15 15 empty empty empty 20 12 0 14 -259603 -66577 -0; -#X text 627 276 <-- step #1 : click here to load the grid; -#X text 20 8 2 Introduction to Images; -#X text 472 37 2.3 Patch Example 1; -#X text 9 352 Tip: To understand how pixels are affected by the numop -test out this numeric grid patch. Each grid value that is output is -multiplied by 42; -#X obj 484 220 #out window; -#X obj 484 191 # * 42; -#X text 727 360 by changing the value (42); -#X text 628 342 <-- step #2 : try altering the argument; -#X obj 560 343 # * 42; -#X text 14 463 GridFlow 0.8.4; -#X msg 484 106 open working.jpg; -#X connect 3 0 4 0; -#X connect 4 0 40 0; -#X connect 17 0 18 0; -#X connect 18 0 19 0; -#X connect 18 0 43 0; -#X connect 40 0 39 0; -#X connect 43 0 16 0; -#X connect 45 0 4 0; diff --git a/externals/gridflow/doc/tutorials/gf_tutorial_image_4.pd b/externals/gridflow/doc/tutorials/gf_tutorial_image_4.pd deleted file mode 100644 index ca6eae3f..00000000 --- a/externals/gridflow/doc/tutorials/gf_tutorial_image_4.pd +++ /dev/null @@ -1,49 +0,0 @@ -#N canvas 240 75 554 435 10; -#X obj 23 -109 #in; -#X obj 95 -59 cnv 15 25 17 empty empty empty 20 12 0 14 -241291 -66577 -0; -#X obj 95 -84 cnv 15 25 17 empty empty empty 20 12 0 14 -241291 -66577 -0; -#X obj 96 -34 cnv 15 25 17 empty empty empty 20 12 0 14 -241291 -66577 -0; -#X msg 95 -59 67; -#X msg 95 -84 2; -#X msg 96 -34 199; -#X text 146 -153 <--; -#X text 145 -82 <--; -#X text 145 -59 <--; -#X text 145 -37 <--; -#X obj 58 -148 bng 15 250 50 0 empty empty empty 0 -6 0 8 -24198 -1 --1; -#X obj 4 -299 cnv 15 550 15 empty empty empty 20 12 0 14 -228992 -66577 -0; -#X obj 4 -334 cnv 15 550 30 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X obj 5 69 cnv 15 550 30 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X text 18 -329 2 Introduction to Images; -#X text 15 -301 2.3 Patch Example 2; -#X text 12 -269 Altering a grid by sending numop an argument using -a message box. This method allows you to send the numop several different -arguments.; -#X obj 209 -206 cnv 15 15 15 empty empty empty 20 12 0 14 -259603 -66577 -0; -#X obj 210 -152 cnv 15 15 15 empty empty empty 20 12 0 14 -259603 -66577 -0; -#X text 145 -206 <-- step #2 : click here to load the image; -#X text 174 -153 Step #3: click on the bang to see the updated image -; -#X obj 215 -59 cnv 15 15 15 empty empty empty 20 12 0 14 -259603 -66577 -0; -#X text 179 -59 step #1 : click on one of the arguments; -#X text 14 77 GridFlow 0.8.4; -#X obj 23 33 #out window; -#X msg 23 -206 open working.jpg; -#X obj 23 -35 # * 1; -#X connect 0 0 27 0; -#X connect 4 0 27 1; -#X connect 5 0 27 1; -#X connect 6 0 27 1; -#X connect 11 0 0 0; -#X connect 26 0 0 0; -#X connect 27 0 25 0; diff --git a/externals/gridflow/doc/tutorials/gf_tutorial_image_5.pd b/externals/gridflow/doc/tutorials/gf_tutorial_image_5.pd deleted file mode 100644 index a0226c88..00000000 --- a/externals/gridflow/doc/tutorials/gf_tutorial_image_5.pd +++ /dev/null @@ -1,52 +0,0 @@ -#N canvas 559 20 560 533 10; -#X obj 2 37 cnv 15 550 15 empty empty empty 20 12 0 14 -228992 -66577 -0; -#X obj 2 2 cnv 15 550 30 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X obj 2 501 cnv 15 550 30 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X text 16 7 2 Introduction to Images; -#X text 14 36 2.3 Patch Example 3; -#X text 2 58 Altering a grid using numop with slider and metro. This -combination allows you to scroll through values and modify a grid in -real time.; -#X obj 19 338 cnv 15 38 17 empty empty empty 20 12 0 14 -241291 -66577 -0; -#X obj 225 207 cnv 15 15 15 empty empty empty 20 12 0 14 -259603 -66577 -0; -#X obj 280 294 cnv 15 15 15 empty empty empty 20 12 0 14 -259603 -66577 -0; -#X text 314 306 the slider; -#X obj 223 122 cnv 15 15 15 empty empty empty 20 12 0 14 -259603 -66577 -0; -#X obj 224 162 cnv 15 15 15 empty empty empty 20 12 0 14 -259603 -66577 -0; -#X obj 21 252 #in; -#X obj 54 295 hsl 128 15 0 255 0 0 empty empty empty -2 -6 0 8 -260818 --1 -1 0 1; -#X obj 53 228 metro 33.3; -#X obj 53 206 tgl 15 0 empty empty empty 0 -6 0 8 -24198 -1 -1 1 1 -; -#X floatatom 72 326 5 0 0 0 - - -; -#X obj 50 165 bng 15 250 50 0 empty empty empty 0 -6 0 8 -24198 -1 --1; -#X obj 21 398 #out window; -#X msg 21 121 open scissors.jpg; -#X obj 21 338 # + 0; -#X text 159 122 <-- step #1 : click here to load the image; -#X text 161 206 <-- step #2 : start the metro; -#X text 160 162 <-- step #2 : click here to view the image; -#X text 223 184 or; -#X text 216 294 <-- step #3 : try altering the argument by using; -#X text 11 509 GridFlow 0.9.0; -#X text 4 443 These examples use the [# +] numop. There are several -numeric operators \; they can be found in the numeric operator help -patch (right click on the [# + 0] and select help to view them).; -#X connect 12 0 20 0; -#X connect 13 0 16 0; -#X connect 13 0 20 1; -#X connect 14 0 12 0; -#X connect 15 0 14 0; -#X connect 17 0 12 0; -#X connect 19 0 12 0; -#X connect 20 0 18 0; diff --git a/externals/gridflow/doc/tutorials/gf_tutorial_image_6.pd b/externals/gridflow/doc/tutorials/gf_tutorial_image_6.pd deleted file mode 100644 index e595e5b1..00000000 --- a/externals/gridflow/doc/tutorials/gf_tutorial_image_6.pd +++ /dev/null @@ -1,66 +0,0 @@ -#N canvas 130 10 767 676 10; -#X obj 7 -69 cnv 15 760 15 empty empty empty 20 12 0 14 -228992 -66577 -0; -#X obj 2 425 cnv 15 760 30 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X obj 4 -220 cnv 15 760 30 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X text 18 -215 2 Introduction to Images; -#X obj 5 -183 cnv 15 760 15 empty empty empty 20 12 0 14 -228992 -66577 -0; -#X text 12 -155 When an image is represented as a grid every pixel -value will vary between 0 and 255 Colour wrapping occurs when the result -of an operation on the pixel value is higher than 255 Values above -255 are counted from 0 For example: if a pixel has a red value of 240 -and 20 is added to it \, you get 5 instead of displaying 260 (240 + -20 - 255 = 5).; -#X text 17 -184 2.4 Colour Wrapping; -#X text 15 -69 2.4 [#clip]; -#X text 11 -44 The [#clip] object is used with numops in order to set -a lower and upper range to pixel values. This allows you to avoid over -saturating the colours of your grid.; -#X obj 163 83 cnv 15 15 15 empty empty empty 20 12 0 14 -259603 -66577 -0; -#X obj 19 254 cnv 15 38 17 empty empty empty 20 12 0 14 -241291 -66577 -0; -#X obj 53 161 hsl 128 15 0 255 0 0 empty empty empty -2 -6 0 8 -260818 --1 -1 0 1; -#X obj 20 56 tgl 15 0 empty empty empty 0 -6 0 8 -24198 -1 -1 0 1; -#X obj 50 353 #clip; -#X obj 20 78 metro 33.3; -#X obj 75 185 #color; -#X obj 20 385 #out window; -#X obj 20 314 shunt; -#X obj 50 288 tgl 15 0 empty empty empty 0 -6 0 8 -24198 -1 -1 0 1 -; -#X obj 3 107 bng 15 250 50 0 empty empty empty 0 -6 0 8 -24198 -1 -1 -; -#X text 296 211 channel at a time; -#X text 268 196 <-- use colour specific sliders to add values to one -; -#X obj 147 288 cnv 15 15 15 empty empty empty 20 12 0 14 -259603 -66577 -0; -#X text 179 288 click here to redirect the flow of data using the [shunt] -object and see the effect of [#clip]; -#X text 100 83 <-- step #1 : start the metro; -#X text 199 160 <-- use slider to add values to all channels at once -; -#X text 9 432 GridFlow 0.8.4; -#X obj 20 136 #store; -#X obj 66 136 #in sewing.jpg; -#X obj 20 254 # + 0; -#X obj 66 117 loadbang; -#X text 84 288 <-- step #2 :; -#X connect 11 0 29 1; -#X connect 12 0 14 0; -#X connect 13 0 16 0; -#X connect 14 0 27 0; -#X connect 15 0 29 1; -#X connect 17 0 16 0; -#X connect 17 1 13 0; -#X connect 18 0 17 1; -#X connect 19 0 27 0; -#X connect 27 0 29 0; -#X connect 28 0 27 1; -#X connect 29 0 17 0; -#X connect 30 0 28 0; diff --git a/externals/gridflow/doc/tutorials/gf_tutorial_image_7.pd b/externals/gridflow/doc/tutorials/gf_tutorial_image_7.pd deleted file mode 100644 index d7704291..00000000 --- a/externals/gridflow/doc/tutorials/gf_tutorial_image_7.pd +++ /dev/null @@ -1,36 +0,0 @@ -#N canvas 79 206 438 353 10; -#X obj 2 -37 cnv 15 430 15 empty empty empty 20 12 0 14 -228992 -66577 -0; -#X obj 2 -72 cnv 15 430 30 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X obj 3 244 cnv 15 430 30 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X text 4 -15 To convert an image to greyscale use [#rgb_to_greyscale]. -It converts a colour information into a black to white gradient.; -#X obj 12 207 cnv 15 25 15 empty empty empty 20 12 0 14 -260818 -66577 -0; -#X text 11 207 Tip:; -#X text 48 201 If you have trouble opening this image refer back to -previous tutorials.; -#X text 16 -67 2 Introduction to Images; -#X text 16 -37 2.5 Greyscale; -#X obj 14 125 cnv 15 110 16 empty empty empty 20 12 0 14 -241291 -66577 -0; -#X obj 15 71 #in; -#X obj 27 51 bng 15 250 50 0 empty empty empty 0 -6 0 8 -24198 -1 -1 -; -#X msg 15 27 open working.jpg; -#X text 11 252 GridFlow 0.9.0; -#X obj 15 124 #rgb_to_greyscale; -#X obj 15 145 #greyscale_to_rgb; -#X obj 15 172 #out window \, title greyscale; -#X obj 157 91 #out window \, title original; -#X obj 15 94 t a a; -#X text 124 144 [#out window] still only accepts rgb images; -#X connect 10 0 18 0; -#X connect 11 0 10 0; -#X connect 12 0 10 0; -#X connect 14 0 15 0; -#X connect 15 0 16 0; -#X connect 18 0 14 0; -#X connect 18 1 17 0; diff --git a/externals/gridflow/doc/tutorials/gf_tutorial_image_8.pd b/externals/gridflow/doc/tutorials/gf_tutorial_image_8.pd deleted file mode 100644 index 1697e73b..00000000 --- a/externals/gridflow/doc/tutorials/gf_tutorial_image_8.pd +++ /dev/null @@ -1,61 +0,0 @@ -#N canvas 29 52 836 433 10; -#X obj 3 347 cnv 15 830 30 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X obj 4 -18 cnv 15 830 15 empty empty empty 20 12 0 14 -228992 -66577 -0; -#X obj 4 -52 cnv 15 830 30 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X text 11 -46 2 Introduction to Images; -#X text 10 -18 2.6 Remap Image; -#X obj 261 229 cnv 15 25 15 empty empty empty 20 12 0 14 -260818 -66577 -0; -#X text 260 229 Tip:; -#X text 290 228 This is a numeric operator. Right click on it for more -information or go back to the tutorial about the numeric operator. -; -#X obj 272 77 cnv 15 15 15 empty empty empty 20 12 0 14 -259603 -66577 -0; -#X obj 321 188 cnv 15 15 15 empty empty empty 20 12 0 14 -259603 -66577 -0; -#X text 355 200 number box to transform image; -#X obj 21 267 cnv 15 85 15 empty empty empty 20 12 0 14 -241291 -66577 -0; -#X obj 20 77 bng 15 250 50 0 empty empty empty 0 -6 0 8 -24198 -1 -1 -; -#X obj 20 166 #in; -#X obj 20 104 t b b; -#X obj 99 290 #print; -#X obj 191 128 bng 15 250 50 0 empty empty empty 0 -6 0 8 -24198 -1 --1; -#X floatatom 210 189 5 0 0 0 - - -; -#X obj 180 152 #for (0 0) (240 320) (1 1); -#X obj 180 102 metro 100; -#X obj 180 77 tgl 15 0 empty empty empty 0 -6 0 8 -24198 -1 -1 1 1 -; -#X obj 20 266 #remap_image; -#X obj 180 227 # / 1; -#X obj 20 315 #out window; -#X text 231 228 <--; -#X text 11 354 GridFlow 0.8.4; -#X msg 50 135 open working.jpg; -#X obj 110 77 cnv 15 15 15 empty empty empty 20 12 0 14 -259603 -66577 -0; -#X text 12 7 Each numeric operator applies unique effects to a grid. -The standard effect changes when numop is used in combination with -the [#remap_image] object.; -#X text 46 75 <-- step #1; -#X text 207 77 <-- step #2 : start the metro; -#X text 258 188 <-- step #3 : click and drag cursor over; -#X connect 12 0 14 0; -#X connect 13 0 21 0; -#X connect 14 0 13 0; -#X connect 14 1 26 0; -#X connect 16 0 18 0; -#X connect 17 0 22 1; -#X connect 18 0 22 0; -#X connect 19 0 18 0; -#X connect 20 0 19 0; -#X connect 21 0 23 0; -#X connect 21 1 15 0; -#X connect 22 0 21 1; -#X connect 26 0 13 0; diff --git a/externals/gridflow/doc/tutorials/gf_tutorial_image_9.pd b/externals/gridflow/doc/tutorials/gf_tutorial_image_9.pd deleted file mode 100644 index b7684734..00000000 --- a/externals/gridflow/doc/tutorials/gf_tutorial_image_9.pd +++ /dev/null @@ -1,65 +0,0 @@ -#N canvas 157 13 867 556 10; -#X obj -14 522 cnv 15 862 30 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X obj -14 34 cnv 15 865 15 empty empty empty 20 12 0 14 -228992 -66577 -0; -#X obj -14 -1 cnv 15 870 30 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X text -9 5 2 Introduction to Images; -#X text -9 33 2.6 [#convolve]; -#X obj 147 258 #store; -#X obj 147 362 # / 9; -#X msg 297 372 3 3 # 1 1 1 1 1 1 1 1 1; -#X obj -5 353 #out window; -#X obj -5 160 #in; -#X obj 147 177 tgl 15 0 empty empty empty 0 -6 0 8 -24198 -1 -1 0 1 -; -#X obj -5 119 loadbang; -#X obj 147 206 metro 33.3667; -#X obj -5 218 t a; -#X obj 147 335 #convolve \, seed 4; -#X obj 297 339 loadbang; -#X obj 297 445 display; -#X obj 147 411 #clip; -#X obj 529 390 cnv 15 15 15 empty empty empty 20 12 0 14 -259603 -66577 -0; -#X obj 228 141 cnv 15 15 15 empty empty empty 20 12 0 14 -259603 -66577 -0; -#X obj 229 175 cnv 15 15 15 empty empty empty 20 12 0 14 -259603 -66577 -0; -#X text 164 140 <-- step #1 : load image; -#X text 166 175 <-- step #3 : start metro; -#X obj 297 316 cnv 15 110 15 empty empty empty 20 12 0 14 -241291 -66577 -0; -#X text 331 316 Blurs; -#X text 562 389 apply effect by selecting a message box; -#X text 202 253 <-- The [#store] object stores the last grid that [#convolve] -was applied to. Everytime time the metro bangs \, [#convolve] is applied -to the grid retained in this object \, therefore applying effect on -top of effect.; -#X text 465 390 <-- step #2 :; -#X text -8 529 GridFlow 0.9.0; -#X text -18 502 ((Source convolve.pd : Copyright Mathieu Bouchard 2002) -; -#X msg 296 415 3 3 # 4 0 -1 3 1 0 0 0 4; -#X text -9 55 [#convolve] allows you to apply preset effects such as -blur \, edge sharpen and emboss onto a grid. In this example you can -create two different kinds of "blurs" on an image.; -#X msg -5 140 load working.jpg; -#X obj 147 387 # abs-; -#X connect 5 0 14 0; -#X connect 6 0 33 0; -#X connect 7 0 14 1; -#X connect 9 0 13 0; -#X connect 10 0 12 0; -#X connect 11 0 32 0; -#X connect 12 0 5 0; -#X connect 13 0 5 1; -#X connect 13 0 8 0; -#X connect 14 0 6 0; -#X connect 15 0 7 0; -#X connect 17 0 13 0; -#X connect 30 0 14 1; -#X connect 30 0 16 0; -#X connect 32 0 9 0; -#X connect 33 0 17 0; diff --git a/externals/gridflow/doc/tutorials/gf_tutorial_intro.pd b/externals/gridflow/doc/tutorials/gf_tutorial_intro.pd deleted file mode 100644 index 9113ebb0..00000000 --- a/externals/gridflow/doc/tutorials/gf_tutorial_intro.pd +++ /dev/null @@ -1,86 +0,0 @@ -#N canvas 160 16 884 589 10; -#X obj 5 6 cnv 15 870 30 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X obj 5 550 cnv 15 870 30 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X obj 6 46 cnv 15 430 15 empty empty empty 20 12 0 14 -179884 -66577 -0; -#X obj 4 232 cnv 15 430 145 empty empty empty 20 12 0 14 -179884 -66577 -0; -#X obj 25 271 pddp_open pure-data-1; -#X obj 25 294 pddp_open pure-data-2; -#X obj 25 317 pddp_open pure-data-3; -#X obj 25 340 pddp_open pure-data-4; -#X text 200 271 Pure-Data Introduction; -#X text 200 294 GUI Objects for Interaction; -#X text 200 317 Creating your first patch; -#X text 200 340 Control: metro \, random & counter; -#X obj 444 233 cnv 15 430 145 empty empty empty 20 12 0 14 -179884 --66577 0; -#X obj 5 391 cnv 15 430 145 empty empty empty 20 12 0 14 -179884 -66577 -0; -#X obj 25 416 pddp_open pure-data-5; -#X obj 25 439 pddp_open pure-data-6; -#X text 200 439 The powerful message object; -#X obj 25 462 pddp_open pure-data-7; -#X text 200 462 More about lists; -#X text 200 485 Nesting collections of objects; -#X text 200 416 Connectionless communications; -#X obj 25 485 pddp_open pure-data-8; -#X text 200 509 Using GUI's in abstractions; -#X obj 25 509 pddp_open pure-data-9; -#X obj 445 391 cnv 15 430 145 empty empty empty 20 12 0 14 -179884 --66577 0; -#X obj 468 271 pddp_open GridFlow-1; -#X obj 468 294 pddp_open GridFlow-2; -#X obj 468 317 pddp_open GridFlow-3; -#X obj 468 340 pddp_open GridFlow-4; -#X text 642 319 Introduction to video; -#X obj 446 46 cnv 15 430 15 empty empty empty 20 12 0 14 -179884 -66577 -0; -#X text 645 477 Interfacing with sensors; -#X obj 467 426 pddp_open GridFlow-6; -#X obj 467 452 pddp_open GridFlow-7; -#X text 451 236 2 Introduction to GridFlow; -#X obj 448 236 cnv 15 15 15 empty empty empty 20 12 0 14 -262144 -66577 -0; -#X text 451 236 2 Introduction to GridFlow; -#X obj 8 395 cnv 15 15 15 empty empty empty 20 12 0 14 -262144 -66577 -0; -#X obj 449 395 cnv 15 15 15 empty empty empty 20 12 0 14 -262144 -66577 -0; -#X obj 7 235 cnv 15 15 15 empty empty empty 20 12 0 14 -262144 -66577 -0; -#X text 452 395 4 Intermediate GridFlow; -#X text 10 235 1 Introduction to Pure-Data; -#X text 11 395 3 Intermediate Pure-Data; -#X text 582 563 Stephanie Brodeur and Darsha Hewitt 2006; -#X text 451 46 What is GridFlow?; -#X text 500 550 What is GridFlow? and GridFlow tutorials developed -by; -#X text 453 84 GridFlow is a plug-in for PureData that introduces the -grid (#) data type into the PD environment. GridFlow allows you to -work with live video \, still images and video files in a real-time -environment.; -#X text 11 46 What is PureData (aka PD)?; -#X text 14 85 PureData is an open-source patching environment for multi-media -(audio+image). PureData is a programming language where you create -relationships by connecting visual boxes (rather than typing complex -commands).; -#X text 454 144 This section deals with the particular objects related -to GridFlow. GridFlow uses the usual PD "control" objects \, as well -as a set of GridFlow specific objects.; -#X text 15 141 A basic understanding of PureData is useful when using -GridFlow. If you are new to the PureData programming environment it -is recommended that you follow the Introduction to PureData before -you move onto the GridFlow tutorials.; -#X text 10 13 Welcome to PureData; -#X text 13 551 What is PureData? and PureData tutorials copyright Ben -Bogart 2005 \; (See COPYING.TXT for details); -#X text 642 340 Introduction to live video; -#X text 641 273 Introduction to grids; -#X text 639 296 Introduction to images; -#X text 653 480; -#X obj 467 477 pddp_open GridFlow-8; -#X text 646 451 Motion detection; -#X text 646 426 Advanced video effects; diff --git a/externals/gridflow/doc/tutorials/grid-intro.pd b/externals/gridflow/doc/tutorials/grid-intro.pd deleted file mode 100644 index fdbfdbbf..00000000 --- a/externals/gridflow/doc/tutorials/grid-intro.pd +++ /dev/null @@ -1,10 +0,0 @@ -#N canvas 0 0 476 213 10; -#X text 29 30 GridFlow is a plug-in for PureData that introduces the -grid (#) data type into the PD environment. GridFlow allows you to -work with live video \, still images and video files in a rel-time -environment.; -#X text 32 97 This section deals with the particular objects related -to GridFlow. GridFlow uses the usual PD "control" objects \, as well -as a set of GridFlow specific objects. Before we get into the tutorials -we will explain the grid "#" \, the most important concept in GridFlow. -; diff --git a/externals/gridflow/doc/tutorials/pure-data-1.pd b/externals/gridflow/doc/tutorials/pure-data-1.pd deleted file mode 100644 index 7be2a91a..00000000 --- a/externals/gridflow/doc/tutorials/pure-data-1.pd +++ /dev/null @@ -1,71 +0,0 @@ -#N canvas 221 110 894 498 10; -#N canvas 0 22 450 300 this 0; -#X obj 192 128 inlet; -#X obj 192 171 outlet; -#X text 8 7 If you're looking at this you're just going to confuse -yourself!; -#X connect 0 0 1 0; -#X restore 499 380 pd this is an object; -#X text 509 358 <- This is a connection; -#X msg 499 319 10; -#X text 13 348 Objects are like filters \, they change the way messages -flow through them.; -#X text 13 153 You can think of a patch as plumbing. The way water -flows through the plumbing of your house \, messages flow through the -connections in your patch. Objects change the flow of the messages -to allow different things to happen. Messages always go into objects -at the top \, called the inlet \, and always come out at the bottom -\, called the outlet. In PD messages flow from top to bottom.; -#X text 458 236 This is a very simple example of a patch \, the message -"10" can be sent through the "pd this is an object" and can be seen -being passed out the outlet.; -#X floatatom 499 416 5 0 0 0 - - -; -#X text 539 415 <- This number box shows the float message; -#X text 553 334 and watch the output!; -#X obj 8 6 cnv 15 870 30 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X obj 8 46 cnv 15 430 15 empty empty empty 20 12 0 14 -179884 -66577 -0; -#X text 13 252 You can work with PD in two ways \, the first is in -"edit mode". Edit-mode is where you create your patch by adding objects -and the connections between them. "Run mode" is when you're done with -the construction of your patch \, and you wish to send messages through -it. In run-mode your cursor is an arrow (as it is right now since we -are in run-mode) \, in edit-mode your cursor is a pointing hand.; -#X text 458 136 Messages are what allow objects to communicate with -one and other. Messages can change the way an object acts \, and/or -express the work the object is doing. Messages come in different types. -They can contain words \, numbers and groups of these. The main types -of messages we will be dealing with are floats (numbers). You can click -on a message \, when in run-mode \, to send it through your patch. -; -#X obj 448 46 cnv 15 430 15 empty empty empty 20 12 0 14 -179884 -66577 -0; -#X obj 448 290 cnv 15 430 15 empty empty empty 20 12 0 14 -179884 -66577 -0; -#X obj 8 447 cnv 15 870 30 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X text 668 449 Copyright Ben Bogart 2005 \; (See COPYING.TXT for details) -; -#X text 12 20 DESCRIPTION: What is a patch? An object? A message?; -#N canvas 0 22 466 316 META 0; -#X text 12 5 CATEGORY: tutorial; -#X text 12 15 KEYWORDS: metaphor object message GUI introduction; -#X restore 16 453 pd META; -#X text 457 67 GUI objects allow you to interact with your PD patch -as it is running. They allow you to change what your patch is doing -without reconnecting the objects. The simplest GUI object is the "Message" -that simply contains a message you want to send in your patch.; -#X text 453 290 A patch that connects a GUI to an object to a second -GUI.; -#X text 531 320 <- This GUI sends a float message (click on it); -#X text 13 66 When working with PD you are dealing primarily with objects -\, GUI (Graphical User Interface) objects \, connections and messages. -These are the building blocks of PD programming. When you connect objects -\, GUI objects \, and messages you are creating a "patch". Patching -is making something complex out of smaller building blocks.; -#X text 13 46 The "patch" \, "objects" and "connections"; -#X text 453 46 "GUI objects" and "messages"; -#X text 12 8 1 Introduction to Pure-Data & its Metaphors; -#X connect 0 0 6 0; -#X connect 2 0 0 0; diff --git a/externals/gridflow/doc/tutorials/pure-data-2.pd b/externals/gridflow/doc/tutorials/pure-data-2.pd deleted file mode 100644 index 151af26f..00000000 --- a/externals/gridflow/doc/tutorials/pure-data-2.pd +++ /dev/null @@ -1,73 +0,0 @@ -#N canvas 197 100 899 548 10; -#X obj 8 6 cnv 15 870 30 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X obj 8 46 cnv 15 430 15 empty empty empty 20 12 0 14 -179884 -66577 -0; -#X obj 448 46 cnv 15 430 15 empty empty empty 20 12 0 14 -179884 -66577 -0; -#X obj 8 497 cnv 15 870 30 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X text 668 499 Copyright Ben Bogart 2005 \; (See COPYING.TXT for details) -; -#N canvas 0 22 470 320 META 0; -#X text 12 5 CATEGORY: tutorial; -#X text 12 15 KEYWORDS: GUI slider toggle number message introduction -; -#X restore 16 503 pd META; -#X text 12 20 DESCRIPTION: Message \, slider \, toggle \, bang and -number; -#X msg 93 145 hello world; -#X obj 93 168 print; -#X text 181 146 <- Click on this message; -#X text 18 74 Messages control the behavior of objects and it is the -objects that change what a patch does. The first object we're going -to learn is "print". All "print" does is print out the messages you -send it to the terminal:; -#X text 19 197 TIP: If you forget what an object does you can always -double-click (on a mac) or right-click (on a PC) and then choose "help". -; -#X text 19 250 In this tutorial we will use two different types of -objects: "objects" (of which "print" is an example) and GUI objects -\, (of which "message" is an example). GUI objects allow you to interact -with your patch \, control PD and change parameters of objects. We -are going to learn four types of GUI objects (but there are many more): -Slider \, Toggle \, Bang \, and Number.; -#X obj 76 355 hsl 300 30 0 127 0 0 empty empty This_is_a_HSlider_(Horizontal) -10 15 1 10 -262144 -1 -1 0 1; -#X obj 73 393 print; -#X text 21 421 This "hslider" is connected to the print object. This -way we can see what messages the "hslider" sends. Try clicking and -dragging in the Slider. You can change the scale (and other properties) -of some GUI Objects by double-clicking (mac) or right-clicking (pc) -and choosing "properties".; -#X text 13 46 The "message" and "hslider" GUI Objects:; -#X text 453 46 "toggle" \, "bang" \, "number"; -#X obj 519 176 tgl 30 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0 -1; -#X obj 629 176 bng 30 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 629 210 print Bang; -#X obj 519 210 print Toggle; -#X obj 739 210 print Number; -#X floatatom 739 192 5 0 0 0 - - -; -#X text 466 76 "slider" \, "toggle" and "number" all send messages -made up of floats (numbers). "bang" is a special case and it only sends -the message "bang". Below we're using an argument to the print object -that tags each message sent to the terminal. This way when we have -multiple "print" objects in one patch we can differenciate thier output. -; -#X text 465 268 "toggle" sends the message "1" or "0" \, "bang" always -sends "bang" and if you click and drag on the "number" you can see -it acts a lot like a Slider. With "number" you can also click once -\, and then type a number to send.; -#X text 467 335 TIP: You can send floating point numbers by holding -down the SHIFT key as you click and drag on the "number".; -#X text 467 375 There are other types of GUI objects not covered here. -See the guis-about.pd PDDP patch:; -#X text 12 8 2 PD Introduction - Some Useful GUI Objects in Pure-Data -; -#X connect 7 0 8 0; -#X connect 13 0 14 0; -#X connect 18 0 21 0; -#X connect 19 0 20 0; -#X connect 23 0 22 0; diff --git a/externals/gridflow/doc/tutorials/pure-data-3.pd b/externals/gridflow/doc/tutorials/pure-data-3.pd deleted file mode 100644 index 729b2dc7..00000000 --- a/externals/gridflow/doc/tutorials/pure-data-3.pd +++ /dev/null @@ -1,70 +0,0 @@ -#N canvas 261 121 900 544 10; -#X obj 8 6 cnv 15 870 30 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X obj 8 46 cnv 15 430 15 empty empty empty 20 12 0 14 -179884 -66577 -0; -#X obj 448 366 cnv 15 430 15 empty empty empty 20 12 0 14 -179884 -66577 -0; -#X obj 8 497 cnv 15 870 30 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X text 668 499 Copyright Ben Bogart 2005 \; (See COPYING.TXT for details) -; -#N canvas 0 22 474 324 META 0; -#X text 12 5 CATEGORY: tutorial; -#X text 12 15 KEYWORDS: patch first connecting placing place connect -; -#X restore 16 503 pd META; -#X text 12 20 DESCRIPTION: Using PD to create your first patch; -#X text 13 46 Adding Objects:; -#X text 19 75 In order to create a patch you need to first place objects -and GUI objects \, and second make connections between these objects. -To place an object you need to be in "edit-mode". You should now be -in run mode \, so please go to the "Edit" pull-down menu and choose -"Edit mode" at the bottom. You should see your cursor change from an -arrow to a pointing hand.; -#X text 19 175 SHORTCUT: You can press "Control" and "e" simultaneously -in order to toggle (switch) between edit and Run modes.; -#X obj 448 386 cnv 15 430 100 empty empty empty 20 12 0 14 -233017 --66577 0; -#X floatatom 506 406 5 0 0 0 - - -; -#X text 19 355 SHORTCUT: You can press "Control" and "3" simultaneously -in order to place a number. All shortcuts are listed next to the items -in the "Put" menu.; -#X text 453 366 Patch work area:; -#X text 19 215 Once you are in "edit-mode" you are now free to place -objects. To place an object go to the "Put" pull-down menu and choose -"Number". Once you have chosen this menu item you will see that a "number" -gui is attached to your mouse pointer. In order to place the number -into the patch move your pointer to the grey area to the right (in -the "Patch work area" -> Click once to release it from your mouse. -Note that the number is coloured blue. The blue colour shows that an -item in your patch is selected. To unselect any item simply click once -on the blank (white) space between items.; -#X obj 520 440 print; -#X obj 448 156 cnv 15 430 15 empty empty empty 20 12 0 14 -179884 -66577 -0; -#X text 453 156 Connecting Objects:; -#X text 19 411 Next we're going to place the familar "print" object -beneath the "number" GUI. Press "Control" and "1" to place an object -box. Again the object gets attached to your mouse and again click once -to place it in the patch area somewhere under the "number".; -#X text 459 41 While the number box is still selected (coloured blue) -you can see a flashing cursor. Type the word "print" into the object -box. The object will retain a dashed line while you type. In order -to create the object you simply need to unselect \, by clicking somewhere -outside the object. Note that once you have clicked to create the object -the dashed line turns solid and an inlet (small rectangle) gets drawn -around the word "print". The objects have now been created!; -#X text 459 185 All connections between objects in PD are created from -outlet to inlet (top to bottom). To start making a connection move -your hand-pointer over the outlet of the "number" gui. When over the -outlet your pointer will change to a circle. When you see the circle -press and hold the mouse button. As you drag (holding the mouse button -down) the pointer you see a line being drawn from the outlet to your -pointer. To attach this connection to another object drag your mouse -to an inlet of another object. The pointer will again change to a circle -and at this point you can release the mouse button. Once released the -objects are now connected! To play with your patch go back into run-mode -and click and drag on the number-box while watching the terminal.; -#X text 12 8 3 PD Introduction - Creating your first patch; -#X connect 11 0 15 0; diff --git a/externals/gridflow/doc/tutorials/pure-data-4.pd b/externals/gridflow/doc/tutorials/pure-data-4.pd deleted file mode 100644 index 4d38f41d..00000000 --- a/externals/gridflow/doc/tutorials/pure-data-4.pd +++ /dev/null @@ -1,87 +0,0 @@ -#N canvas 183 61 890 531 10; -#X obj 8 6 cnv 15 870 30 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X obj 8 96 cnv 15 430 15 empty empty empty 20 12 0 14 -179884 -66577 -0; -#X obj 8 487 cnv 15 870 30 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X text 668 489 Copyright Ben Bogart 2005 \; (See COPYING.TXT for details) -; -#N canvas 0 22 478 328 META 0; -#X text 12 5 CATEGORY: tutorial; -#X text 12 15 KEYWORDS: metro counter random; -#X restore 16 493 pd META; -#X text 12 20 DESCRIPTION: Learning "metro" \, "counter" & "random" -; -#X text 13 96 Using the "metro" object:; -#X text 21 47 In this section we will learn three new objects \, "metro" -\, "counter" \, and "random". Metro sends a bang at regular intervals -\, just like a metronome.; -#X obj 164 142 metro 250; -#X obj 164 123 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0 -1; -#X obj 164 163 bng 15 100 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X floatatom 222 123 5 0 0 0 - - -; -#X text 21 187 You can turn a Metro on and off by sending it a "1" -or "0" message. Because a toggle sends 0/1 messages \, we can simply -connect it directly. Metro also accepts an argument (words or numbers -wirtten after the object name). This argument is how fast the metro -should send out bangs (in milliseconds). You can always change the -speed of the metro by sending it number messages through the rightmost -inlet.; -#X obj 8 306 cnv 15 430 15 empty empty empty 20 12 0 14 -179884 -66577 -0; -#X text 13 306 Using the "random" object:; -#X text 21 277 For more info see the metro-help.pd patch.; -#X obj 168 385 bng 15 100 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X obj 168 425 print; -#X obj 168 404 random 100; -#X floatatom 233 385 5 0 0 0 - - -; -#X text 20 327 The Random object returns a number between 0 and the -(number) argument when it receives a bang message in the leftmost inlet. -You can also change the upper limit by sending a message to the rightmost -inlet.; -#X obj 448 46 cnv 15 430 15 empty empty empty 20 12 0 14 -179884 -66577 -0; -#X text 453 46 Using the "random" object:; -#X obj 559 154 bng 15 100 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X floatatom 590 154 3 1 3 0 - - -; -#X floatatom 621 174 3 0 0 0 - - -; -#X floatatom 652 194 3 0 0 0 - - -; -#X obj 652 234 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 --1; -#X floatatom 559 234 8 0 0 0 - - -; -#X obj 559 213 counter 0 10 1; -#X text 21 447 For more info see the random-help.pd patch.; -#X text 461 77 "counter" is simply an object that counts. It can count -up \, count down and count up and then down. Where it starts and where -it stops are all definable. This is the counter that in included with -Gem \, it is not compatible with other counter objects.; -#X text 461 274 The first argument for counter is the lower limit (number -to start counting at). The second is the upper limit to count to. The -third argument is the direction in which to count. "1" means forward -\, "2" means backward and "3" means forward and then backward. You -can also use the three rightmost inlets to change the behaviour of -counter. The rightmost inlet is the upper limit \, the second right-most -the lower limit \, and the third right-most as the direction. The rightmost -outlet sends out a bang message when the counter loops.; -#X text 681 193 Rightmost inlet; -#X text 651 173 Second Rightmost inlet; -#X text 621 153 Third Rightmost inlet; -#X text 461 407 For more info see the counter-help.pd patch.; -#X text 12 8 4 Introduction to PD - More objects; -#X connect 8 0 10 0; -#X connect 9 0 8 0; -#X connect 11 0 8 1; -#X connect 16 0 18 0; -#X connect 18 0 17 0; -#X connect 19 0 18 1; -#X connect 23 0 29 0; -#X connect 24 0 29 1; -#X connect 25 0 29 2; -#X connect 26 0 29 3; -#X connect 29 0 28 0; -#X connect 29 1 27 0; diff --git a/externals/gridflow/doc/tutorials/pure-data-5.pd b/externals/gridflow/doc/tutorials/pure-data-5.pd deleted file mode 100644 index dc357bb1..00000000 --- a/externals/gridflow/doc/tutorials/pure-data-5.pd +++ /dev/null @@ -1,108 +0,0 @@ -#N canvas -235 0 891 673 10; -#X obj 8 6 cnv 15 870 30 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X obj 8 46 cnv 15 430 15 empty empty empty 20 12 0 14 -179884 -66577 -0; -#X obj 8 627 cnv 15 870 30 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X text 668 629 Copyright Ben Bogart 2005 \; (See COPYING.TXT for details) -; -#N canvas 0 22 482 332 META 0; -#X text 12 5 CATEGORY: tutorial; -#X text 12 15 KEYWORDS: send receive netsend netreceive cordless communication -network TCP/IP UDP internet; -#X restore 16 633 pd META; -#X obj 448 46 cnv 15 430 15 empty empty empty 20 12 0 14 -179884 -66577 -0; -#X text 12 20 DESCRIPTION: Communicating between objects w/out connections -; -#X text 13 46 "send" & "receive"; -#X obj 86 223 send invisible-link; -#X obj 86 248 receive invisible-link; -#X floatatom 86 273 5 0 0 0 - - -; -#X msg 86 198 10; -#X floatatom 266 273 5 0 0 0 - - -; -#X floatatom 266 203 5 0 0 0 - - -; -#X obj 266 223 s invisible-link2; -#X obj 266 248 r invisible-link2; -#X obj 102 483 r send-from-number; -#X floatatom 102 508 5 0 0 0 - - -; -#X floatatom 102 462 5 0 0 0 - - send-from-number; -#X floatatom 242 462 5 0 0 0 - - -; -#X obj 242 483 s send-to-number2; -#X floatatom 242 508 5 0 0 0 - send-to-number2 -; -#X text 19 385 Note: Many GUI objects have built-in send and receive -objects. The tag names are specified in the GUI properties. Remeber -to get the GUI properties Right-Click or Control-Click on the GUI object -and select "Properties".; -#X text 453 46 "netsend" & "netreceive"; -#X text 19 575 For more info see: send-help.pd \, receive-help.pd \, -netsend-help.pd and netreceive-help.pd; -#X text 459 75 While "send" and "receive" allow you to send messages -without connecting objects with patch-cords "netsend" and "netreceive" -do the same but communicate between objects using TCP/IP the internet -protocol. This means that you can send messages from a patch running -on one machine to a second patch running on a second machine on the -same network \, or even over the internet.; -#X text 19 545 You can also send messages using UDP rather than TCP/IP. -See "more info" below for details.; -#X obj 589 292 netreceive 8001; -#X text 459 185 The first argument of "netreceive" is the port the -netrecive should listen on. "netsend" can connect to this port from -other machines. "netreceive" has two outlets. The first outlet sends -out the messages it receives over network \, and the second argument -send a "1" when netsend is connected and "0" when netsend disconnects. -; -#X obj 589 318 print; -#X obj 689 318 tgl 16 0 empty empty empty 0 -6 0 8 -262144 -1 -1 1 -1; -#X obj 503 563 netsend; -#X text 459 355 "netsend" is controlled using three messages: "connect" -\, "disconnect" and "send". "connect" has two arguments \, the host -or IP and the port number you wish to connect to. There needs to be -a "netreceive" listening on the port you connect to. "disconnect" drops -the current connection. "send" sends any arguments to the "netreceive" -over the network. The single outlet of "netsend" prints "1" when a -connection is made and "0" when the connection is lost.; -#X obj 503 586 tgl 16 0 empty empty empty 0 -6 0 8 -262144 -1 -1 1 -1; -#X msg 503 486 connect localhost 8001; -#X msg 516 511 disconnect; -#X msg 525 537 send hello from the internet; -#X text 602 510 Close connection; -#X text 673 486 Connect to this machine; -#X text 733 536 Send message; -#X text 19 75 In some cases you will want to send messages without -connecting objects. You may be sending one message to many different -places that would make connections too laborious. "send" and "receive" -both have a single argument. This argument is the tag name for the -communication. "send" will always send any messages it gets in it inlet -to any number of "receive" objects in a patch with the same tag name. -"s" and "r" can be used in the place of "send" and "receive".; -#X obj 86 336 s broadcast; -#X floatatom 86 317 5 0 0 0 - - -; -#X obj 176 316 r broadcast; -#X floatatom 176 339 5 0 0 0 - - -; -#X obj 266 316 r broadcast; -#X floatatom 266 339 5 0 0 0 - - -; -#X text 12 8 5 Intermediate Pure-Data - send and receive; -#X msg 585 598 send \$1; -#X floatatom 584 567 5 0 0 0 - - -; -#X text 651 596 send variables to another computer; -#X connect 9 0 10 0; -#X connect 11 0 8 0; -#X connect 13 0 14 0; -#X connect 15 0 12 0; -#X connect 16 0 17 0; -#X connect 19 0 20 0; -#X connect 27 0 29 0; -#X connect 27 1 30 0; -#X connect 31 0 33 0; -#X connect 34 0 31 0; -#X connect 35 0 31 0; -#X connect 36 0 31 0; -#X connect 42 0 41 0; -#X connect 43 0 44 0; -#X connect 45 0 46 0; -#X connect 48 0 31 0; -#X connect 49 0 48 0; diff --git a/externals/gridflow/doc/tutorials/pure-data-6.pd b/externals/gridflow/doc/tutorials/pure-data-6.pd deleted file mode 100644 index 01e6dcd7..00000000 --- a/externals/gridflow/doc/tutorials/pure-data-6.pd +++ /dev/null @@ -1,92 +0,0 @@ -#N canvas 304 98 891 675 10; -#X obj 8 6 cnv 15 870 30 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X obj 8 627 cnv 15 870 30 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X text 668 629 Copyright Ben Bogart 2005 \; (See COPYING.TXT for details) -; -#N canvas 0 22 486 336 META 0; -#X text 12 5 CATEGORY: tutorial; -#X text 12 15 KEYWORDS: message comma semicolon dollersign receive -list; -#X restore 16 633 pd META; -#X text 12 20 DESCRIPTION: Advanced uses for the message object; -#X text 19 45 In Pure-Data there are two distinct concepts with the -name "message". Messages are the data that gets send in PD from object -to object. There is also the Messsage object that contains a message -you want to send. The message object is the first GUI object we covered -in this tutorial. The message is not the only way to send messages -in a patch \, since all GUI objects also send messages. So what makes -the message object different? The message object can sent messages -of any type \, where a number for example can only send float (number) -messages. There are a number of powerful features in the message object. -We are familar with the "usual" way of using the message object:; -#X msg 163 208 hello; -#X msg 212 208 bye; -#X obj 196 238 print messages; -#X text 459 556 Note: It is a very common mistake to confuse the message -object with an object box. The object box is framed in a rectangle. -The message object has a notch removed from the right edge.; -#X obj 106 385 print messages; -#X msg 106 358 hello \, bye; -#X text 19 305 You can send multiple messages in succession from a -single message box by using a comma " \, " between the messages. The -messages get send from left to right.; -#X obj 8 276 cnv 15 430 15 empty empty empty 20 12 0 14 -179884 -66577 -0; -#X obj 8 416 cnv 15 430 15 empty empty empty 20 12 0 14 -179884 -66577 -0; -#X text 13 416 Semicolon in message boxes; -#X text 13 276 Comma in message boxes; -#X text 19 445 Just like you can specify receive tags directly in GUI -objects you can also use a message box to send a message directly to -a particular "receive".; -#X obj 34 536 r myreceive; -#X floatatom 34 560 5 0 0 0 - - -; -#X text 189 360 Click to send both messages; -#X text 136 502 send "10" to receive tag "myreceive"; -#X text 19 585 For more info see: message-help.pd 04.messages.pd 10.more.messages.pd -; -#X msg 34 498 \; myreceive 10; -#X obj 448 46 cnv 15 430 15 empty empty empty 20 12 0 14 -179884 -66577 -0; -#X text 453 46 Dollarsign in message boxes; -#X msg 534 175 \$1 \$1 \$1; -#X msg 534 154 10; -#X text 459 75 In messages there are placeholders that start with "$". -These placeholders are variables that get replaced with messages you -send to the message box. In the example below we have a single message -"10". Each "$1" in the message box gets replaced with the message "10". -; -#X text 601 175 \$1 placeholder gets replaced; -#X text 570 154 message sent to message box; -#X msg 534 304 list 1 2; -#X text 600 304 a list with items "1" and "2"; -#X msg 534 325 \$2 \$1; -#X text 584 325 \$1 becomes "1" and \$2 becomes "2"; -#X obj 534 347 print reverse-list; -#X text 459 235 The "$1" placeholder refers to the first element of -the list the message box gets from its inlet. We can use this to use -a message box to reverse the order of elements (called atoms) in a -list.; -#X text 459 385 In this case the list "1 2" has two elements (called -atoms) when this list gets sent to the inlet of a message box its atoms -are available to the message box through the $ variables. \$1 gets -replaced with the first element \, \$2 the second and so on.; -#X obj 534 197 print repeated-message; -#X obj 480 511 print complex-message; -#X msg 480 468 list Fred Marcus; -#X text 607 468 a list with two symbol atoms; -#X msg 480 489 Hi \$1. \, Ya know \$2?; -#X text 623 489 Becomes: "Hi Fred \, Ya know Marcus?"; -#X text 12 8 6 Intermediate Pure-Data - Using the message object; -#X connect 6 0 8 0; -#X connect 7 0 8 0; -#X connect 11 0 10 0; -#X connect 18 0 19 0; -#X connect 26 0 38 0; -#X connect 27 0 26 0; -#X connect 31 0 33 0; -#X connect 33 0 35 0; -#X connect 40 0 42 0; -#X connect 42 0 39 0; diff --git a/externals/gridflow/doc/tutorials/pure-data-7.pd b/externals/gridflow/doc/tutorials/pure-data-7.pd deleted file mode 100644 index 0d8360ec..00000000 --- a/externals/gridflow/doc/tutorials/pure-data-7.pd +++ /dev/null @@ -1,106 +0,0 @@ -#N canvas 280 89 936 678 10; -#X obj 8 6 cnv 15 870 30 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X obj 8 627 cnv 15 870 30 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X text 668 629 Copyright Ben Bogart 2005 \; (See COPYING.TXT for details) -; -#N canvas 0 22 482 332 META 0; -#X text 12 5 CATEGORY: tutorial; -#X text 12 15 KEYWORDS: send receive netsend netreceive cordless communication -network TCP/IP UDP internet; -#X restore 16 633 pd META; -#X obj 8 266 cnv 15 430 15 empty empty empty 20 12 0 14 -179884 -66577 -0; -#X text 13 266 "pack" object; -#X msg 96 543 2; -#X msg 45 521 1; -#X obj 45 588 print mylist; -#X text 12 20 DESCRIPTION: Using pack \, unpack and route with lists -; -#X text 19 75 In the Pure-Data introduction we discussed the three -different types of data in PD. These are floats (numbers) \, symbols -(words) and lists (groups of floats and words). Floats and symbols -are known as atoms. Atoms are single elements \, they do not contain -spaces or other special characters. Atoms can be grouped into lists. -; -#X obj 8 46 cnv 15 430 15 empty empty empty 20 12 0 14 -179884 -66577 -0; -#X text 13 46 What is a list?; -#X msg 145 216 list one two three; -#X obj 145 239 print this is a list; -#X text 19 155 Lists can be created in a number of ways \, but we are -going to cover the two most common ways of creating lists. The most -simple way to create a list is to type the list into a message box -starting with the word (symbol) "list":; -#X text 19 295 The "pack" object is the second most common way to create -a list. "pack" allows you to take individual atoms and combine them -into a single list. "pack" accepts a number of arguments. Each argument -defines the type of atom in the resulting list. The "f" argument creates -an inlet that accepts float atoms. The "s" argument creates an inlet -accepts symbol atoms. The number of arguments is the same as the number -of elements in the resultant list.; -#X text 19 405 "pack" is the first object we are going to learn that -has a "cold" inlet. Some control objects in PD have "hot" and "cold" -inlets. When you send a message to a "cold" inlet the object does not -generate any output (it does not send any messages). When "hot" inlets -get messages then the object does generate output. The leftmost inlet -is always the "hot" inlet and all other inlets are "cold" or in some -cases all inlets are "hot"; -#X text 75 521 sets the first atom "1" and then sends the list; -#X text 132 543 sets the second atom "2"; -#X obj 45 566 pack f f; -#X text 459 45 Note that if you do not set the second and onwards atoms -via thier "cold" inlets and you generate the list by setting the first -atom via the "hot" inlet then all float atoms will be set to "0" and -all symbol atoms will be set to "symbol" in the resultant list.; -#X obj 448 126 cnv 15 430 15 empty empty empty 20 12 0 14 -179884 -66577 -0; -#X text 453 126 "unpack" object; -#X obj 596 241 unpack f f f; -#X msg 596 219 list 1 2 3; -#X floatatom 596 294 5 0 0 0 - - -; -#X floatatom 635 277 5 0 0 0 - - -; -#X floatatom 675 262 5 0 0 0 - - -; -#X text 639 293 First Atom; -#X text 678 277 Second Atom; -#X text 718 261 Third Atom; -#X text 459 156 The "unpack" object is very similar to the "pack" object -except it works in reverse. "unpack" takes a list and splits it up -into a number of atoms. It uses the same arguments as "pack" but generates -outlets rather than inlets.; -#X obj 448 319 cnv 15 430 15 empty empty empty 20 12 0 14 -179884 -66577 -0; -#X text 453 319 "route" object; -#X text 459 349 The "route" object sorts lists based on the first atom -of the list. It as a number of float or symbol arguments. For each -argument "route" creates one outlet. "route" also creates one additional -rightmost outlet for rejections. For each list route gets it compares -the first atom to all its arguments. If the first atom matches one -of the arguments it the rest of the list \, without the first atom -\, gets send through the outlet corresponding to that argument. If -the first atom of the list does not match any arguments the entire -list \, including the first atom \, gets sent out the rejection outlet. -; -#X msg 688 493 rejection 1; -#X obj 685 553 print rejection; -#X msg 538 493 o1 2; -#X msg 613 493 o2 3; -#X obj 613 531 route o1 o2; -#X obj 613 593 print o1; -#X obj 649 573 print o2; -#X text 12 8 7 Intermediate Pure-Data - Working with lists; -#X connect 6 0 20 1; -#X connect 7 0 20 0; -#X connect 13 0 14 0; -#X connect 20 0 8 0; -#X connect 24 0 26 0; -#X connect 24 1 27 0; -#X connect 24 2 28 0; -#X connect 25 0 24 0; -#X connect 36 0 40 0; -#X connect 38 0 40 0; -#X connect 39 0 40 0; -#X connect 40 0 41 0; -#X connect 40 1 42 0; -#X connect 40 2 37 0; diff --git a/externals/gridflow/doc/tutorials/pure-data-8.pd b/externals/gridflow/doc/tutorials/pure-data-8.pd deleted file mode 100644 index aa95c087..00000000 --- a/externals/gridflow/doc/tutorials/pure-data-8.pd +++ /dev/null @@ -1,89 +0,0 @@ -#N canvas 238 94 891 621 10; -#X obj 8 6 cnv 15 870 30 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X obj 8 577 cnv 15 870 30 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X text 668 579 Copyright Ben Bogart 2005 \; (See COPYING.TXT for details) -; -#N canvas 0 22 482 332 META 0; -#X text 12 5 CATEGORY: tutorial; -#X text 12 15 KEYWORDS: send receive netsend netreceive cordless communication -network TCP/IP UDP internet; -#X restore 16 583 pd META; -#X obj 8 46 cnv 15 430 15 empty empty empty 20 12 0 14 -179884 -66577 -0; -#X text 12 20 DESCRIPTION: nested patches using abstractions & subpatches -; -#X text 13 46 What is an abstraction?; -#X text 23 76 Since objects are very simple in Pure-Data doing complex -tasks often leads to very complex patches. Often it is useful to use -the same bit of patching you do for one project for another. Pure-Data -has a facility to "nest" \, that is to take a number of objects in -a collection and place them into a group that looks like a single object. -This is also handy to make a complex patch look simple and clear by -hiding the nitty-gritty details. There are two types of these collections -\, the subpatch and the abstraction.; -#X obj 8 216 cnv 15 430 15 empty empty empty 20 12 0 14 -179884 -66577 -0; -#X text 13 216 The subpatch; -#X text 23 246 Subpatches are collections of objects that get "hidden" -inside a container that looks like a normal PD object. Subpatches are -created by creating an object box \, and typing the word "pd" followed -by whatever you want to describe the contents of the subpatch. Subpatches -are saved at the same time as the "parent" patch. Here is a subpatch: -; -#N canvas 0 22 460 310 subpatch 0; -#X obj 30 34 inlet; -#X obj 30 77 outlet; -#X text 99 35 This is inside the subpatch.; -#X connect 0 0 1 0; -#X restore 178 359 pd subpatch; -#X floatatom 178 336 5 0 0 0 - - -; -#X floatatom 178 387 5 0 0 0 - - -; -#X text 23 416 To open a subpatch simply click once on the subpatch -in run-mode or control-click (or right-click) and select open in edit-mode. -Both subpatches and abstractions communicate with the parent patch -through special objects called "inlet" and "outlet" for each "inlet" -in a subpatch or abstraction an inlet is created on the subpatch. This -example has one inlet and one outlet.; -#X obj 448 46 cnv 15 430 15 empty empty empty 20 12 0 14 -179884 -66577 -0; -#X text 453 46 The abstraction; -#X text 463 76 Abstractions are very similar to subpatches. They are -collections of objects that are "hidden" inside PD objects \, and they -both use "inlet" and "outlet" objects to communicate with the parent -patch. The difference between subpatches and abstractions is that abstractions -are saved in a separate file from the parent. This means when you save -the parent patch containing abstractions the abstractions are not saved. -The abstractions are saved as separate files so that they can be used -in multiple patches. A second feature that exists in abstractions and -not in subpatches is the ability to use arguments. "send" and "receive" -can be used inside abstractions to send data without connections (patch-cords). -; -#X obj 682 253 r output; -#X obj 682 277 print; -#X obj 564 253 abstraction 1 2; -#X text 463 316 To create an abstraction all you need to do is create -a new PD patch ("File" -> "New"). Create the contents of the abstraction -and then save it in the same directory as the patch you want to use -it in. In this case the abstraction is saved as "abstraction.pd". Once -saved you can easily embed the abstraction simply by typing its name -\, without the .pd extension \, into an object box.; -#X obj 448 416 cnv 15 430 15 empty empty empty 20 12 0 14 -179884 -66577 -0; -#X text 453 416 Dollarsign in object boxes; -#X text 463 446 If you open the above example you will see that the -familiar "pack" object has a number of "$" arguments. The "$" arguments -in a object box differ entirely from the "$" used in message objects. -When you use a "$" in an object box inside an abstraction the values -get replaced with the arguments to that abstraction. In the case above -the "pack" object's first argument "$1" gets replaced with the first -argument of the abstraction "1" "$2" gets replaced with the second -argument "2".; -#X text 23 536 For more info see: 12.PART2.subpatch.pd 14.dollersign.pd -; -#X text 12 8 8 Intermediate Pure-Data - Using abstractions and subpacthes -; -#X connect 11 0 13 0; -#X connect 12 0 11 0; -#X connect 18 0 19 0; diff --git a/externals/gridflow/doc/tutorials/pure-data-9.pd b/externals/gridflow/doc/tutorials/pure-data-9.pd deleted file mode 100644 index e5188ee0..00000000 --- a/externals/gridflow/doc/tutorials/pure-data-9.pd +++ /dev/null @@ -1,43 +0,0 @@ -#N canvas 291 108 450 562 10; -#X obj 8 6 cnv 15 430 30 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X obj 8 517 cnv 15 430 30 empty empty empty 20 12 0 14 -233017 -66577 -0; -#X text 228 519 Copyright Ben Bogart 2005 \; (See COPYING.TXT for details) -; -#N canvas 0 22 486 336 META 0; -#X text 12 5 CATEGORY: tutorial; -#X text 12 15 KEYWORDS: GOP graph parent abstraction nesting ui interface -; -#X restore 16 523 pd META; -#X obj 8 46 cnv 15 430 15 empty empty empty 20 12 0 14 -179884 -66577 -0; -#X text 12 20 DESCRIPTION: Using Graph on Parent abstractions; -#X text 13 46 What is Graph on Parent?; -#X text 13 76 Graph on Parent is a feature of PD that allows you to -show the GUI objects contained in an abstraction on the parent patch. -This means that you can create abstractions that not only include a -collection of objects but can also include a user interface. To use -graph on parent you simply need to create an abstraction the usual -way but before saving it you need should Control-Click (Right-Click) -on the background (white area) in the abstraction and choose "properties". -From the properties menu check the "graph on parent" option. Now when -you save the patch and embed it in a second patch all GUI objects will -be visible.; -#X obj 154 250 gop_abstraction; -#X text 13 331 In this simple example there is only one GUI object -\, a slider. Inside the abstraction the slider is connected to an inlet -and an outlet. If you move the slider you can see the result in the -outlet. If you set a value in the inlet with the number GUI you can -see the position of the slider change.; -#X floatatom 154 231 5 0 0 0 - - -; -#X floatatom 154 297 5 0 0 0 - - -; -#X text 13 421 Note you can change the size of the abstractions bounding -box by Control-Click (Right-Click) on the abstraction and choose "properties". -The size of the bounding-box is specified by the "screen width" and -"screen height".; -#X text 13 487 For more info see:; -#X text 12 8 9 Intermediate Pure-Data - Using GUI's in abstractions -; -#X connect 8 0 11 0; -#X connect 10 0 8 0; |