Update of /cvsroot/pure-data/externals/gridflow/doc/flow_classes
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv23619/doc/flow_classes
Added Files:
#+-help.pd #-help.pd #cast-help.pd #clip-help.pd
#contrast-help.pd #dim-help.pd #fade-help.pd #in-help.pd
#numop-help.pd #pack-help.pd #pack_and_#unpack-help.pd
#print-help.pd #print-help2.pd #remap_image-help.pd
#reverse-help.pd #rgb_to_yuv-help.pd
#rgb_to_yuv_and_#yuv_to_rgb-help.pd #unpack-#pack-help.pd
exec-help.pd listelement-help.pd ls-help.pd
plotter_control-help.pd renamefile-help.pd unix_time-help.pd
Log Message:
i'm almost, almost done
--- NEW FILE: #pack_and_#unpack-help.pd ---
#N canvas 109 540 736 659 10;
#X obj 268 124 cnv 15 460 15 empty empty empty 20 12 0 14 -200249 -66577
0;
#X obj 278 148 cnv 15 450 15 empty empty empty 20 12 0 14 -233017 -66577
0;
#X obj 8 641 cnv 15 720 30 empty empty empty 20 12 0 14 -200249 -66577
0;
#X obj 7 5 cnv 15 720 30 empty empty empty 20 12 0 14 -233017 -66577
0;
#X obj 268 43 cnv 15 460 15 empty empty empty 20 12 0 14 -200249 -66577
0;
#X text 271 43 Arguments:;
#X obj 268 267 cnv 15 460 15 empty empty empty 20 12 0 14 -200249 -66577
0;
#X text 271 267 Outlets:;
#X obj 8 43 cnv 15 250 15 empty empty empty 20 12 0 14 -200249 -66577
0;
#X text 11 43 Usage:;
#X obj 8 63 cnv 15 250 30 empty empty empty 20 12 0 14 -233017 -66577
0;
#X obj 8 100 cnv 15 250 200 empty empty empty 20 12 0 14 -233017 -66577
0;
#X text 271 124 Inlets: (Read left to right \, inlet "0" being the
leftmost);
#X obj 80 71 #pack;
#X text 11 5 SUMMARY:;
#X text 76 5 Creates a one dimentional grid (Dim(N) vector) from individual
integers.;
#X obj 30 222 #color;
#X floatatom 30 114 5 0 0 0 - - -;
#X floatatom 52 142 5 0 0 0 - - -;
#X floatatom 74 170 5 0 0 0 - - -;
#X obj 30 196 #pack 3;
#X text 283 63 One - [integer] defines the number of inlets and the
amount of grid dimensions.;
#X text 289 175 Integer - accepts multiple integers as defined by the
argument and creates a vector.;
#X text 283 287 One - outputs values from each individual inlet.;
#X obj 270 483 cnv 15 460 15 empty empty empty 20 12 0 14 -200249 -66577
0;
#X obj 281 503 cnv 15 450 15 empty empty empty 20 12 0 14 -233017 -66577
0;
#X obj 7 335 cnv 15 720 30 empty empty empty 20 12 0 14 -233017 -66577
0;
#X obj 268 373 cnv 15 460 15 empty empty empty 20 12 0 14 -200249 -66577
0;
#X text 271 373 Arguments:;
#X obj 268 595 cnv 15 460 15 empty empty empty 20 12 0 14 -200249 -66577
0;
#X text 271 595 Outlets:;
#X obj 8 373 cnv 15 250 15 empty empty empty 20 12 0 14 -200249 -66577
0;
#X text 11 373 Usage:;
#X obj 8 393 cnv 15 250 30 empty empty empty 20 12 0 14 -233017 -66577
0;
#X obj 8 430 cnv 15 250 200 empty empty empty 20 12 0 14 -233017 -66577
0;
#X text 273 482 Inlets: (Read left to right \, inlet "0" being the
leftmost);
#X text 11 335 SUMMARY:;
#X obj 79 400 #unpack;
#X obj 30 518 #unpack 3;
#X obj 30 451 #color;
#X floatatom 30 601 5 0 0 0 - - -;
#X floatatom 59 574 5 0 0 0 - - -;
#X floatatom 88 549 5 0 0 0 - - -;
#X text 283 393 One - [integer] defines the number of outlets and the
amount of grid dimensions.;
#X text 281 148 All:;
#X text 283 503 All:;
#X text 284 529 Grid - receives grids and outputs integers.;
#X text 289 218 Grid - receives grids and outputs integers.;
#X text 77 335 Outputs individual integers corresponding to the vector
dimensions (number of elements in a grid).;
#X text 284 615 All - outputs the vector dimensions as individual integers.
;
#X text 17 648 GridFlow 0.8.0;
#X connect 17 0 20 0;
#X connect 18 0 20 1;
#X connect 19 0 20 2;
#X connect 20 0 16 0;
#X connect 38 0 40 0;
#X connect 38 1 41 0;
#X connect 38 2 42 0;
#X connect 39 0 38 0;
--- NEW FILE: listelement-help.pd ---
#N canvas 103 143 732 416 10;
#X obj 268 79 cnv 15 460 15 empty empty empty 20 12 0 14 -200249 -66577
0;
#X obj 279 108 cnv 15 450 15 empty empty empty 20 12 0 14 -233017 -66577
0;
#X obj 8 381 cnv 15 720 30 empty empty empty 20 12 0 14 -200249 -66577
0;
#X obj 8 5 cnv 15 720 15 empty empty empty 20 12 0 14 -233017 -66577
0;
#X obj 279 265 cnv 15 450 15 empty empty empty 20 12 0 14 -233017 -66577
0;
#X obj 268 25 cnv 15 460 15 empty empty empty 20 12 0 14 -200249 -66577
0;
#X text 271 25 Arguments:;
#X obj 268 327 cnv 15 460 15 empty empty empty 20 12 0 14 -200249 -66577
0;
#X text 271 327 Outlets:;
#X obj 8 25 cnv 15 250 15 empty empty empty 20 12 0 14 -200249 -66577
0;
#X text 11 25 Usage:;
#X obj 8 46 cnv 15 250 30 empty empty empty 20 12 0 14 -233017 -66577
0;
#X obj 8 83 cnv 15 250 289 empty empty empty 20 12 0 14 -233017 -66577
0;
#X text 271 79 Inlets: (Read left to right \, inlet "0" being the leftmost)
;
#X text 282 108 0: (Leftmost);
#X text 282 265 1: (Rightmost);
#X text 12 5 SUMMERY:;
#X text 73 5 Outputs one element of a list as selected by an integer.
;
#X floatatom 23 320 5 0 0 0 - - -;
#X obj 23 251 listelement 0;
#X floatatom 109 216 5 0 0 0 - - -;
#X obj 100 320 display;
#X obj 159 320 print;
#X msg 61 166 1 3 hello 8 13;
#X obj 23 134 pack 0 0;
#X floatatom 74 103 5 0 0 0 - - -;
#X floatatom 23 103 5 0 0 0 - - -;
#X obj 87 52 listelement;
#X text 286 299 Integer - index (selects the position of an element).
;
#X text 16 387 GridFlow 0.8.0;
#X text 282 50 One - see inlet 0: (rightmost);
#X text 280 139 List - An element in a list is chosen by the index
(an integer that selects the position of an element). This element
is sent to the outlet and can be viewed in the console using the print
object or in a number box if displaying an integer. For example: integer
"0" selects and outputs the first element in a list \, integer "1"
selects and outputs the second element in a list \, integers "-1" selects
and outputs the last element in a list.;
#X text 287 356 One - see inlet 0: (leftmost);
#X connect 19 0 18 0;
#X connect 19 0 21 0;
#X connect 19 0 22 0;
#X connect 20 0 19 1;
#X connect 23 0 19 0;
#X connect 24 0 19 0;
#X connect 25 0 24 1;
#X connect 26 0 24 0;
--- NEW FILE: #clip-help.pd ---
#N canvas 693 131 606 601 10;
#X obj 360 381 #in;
#X obj 360 422 # + 42;
#X floatatom 404 400 5 0 0 0 - - -;
#X obj 360 528 #out window;
#X msg 390 358 open b001.jpg;
#X obj 360 335 t b b;
#X obj -1 0 cnv 15 90 600 empty empty empty 20 12 0 14 -233017 -66577
0;
#X obj 360 302 metro 100;
#X obj 360 281 tgl 15 0 empty empty empty 0 -6 0 8 -24198 -1 -1 0 1
;
#X floatatom 384 452 5 0 0 0 - - -;
#X floatatom 434 452 5 0 0 0 - - -;
#X text 38 36 INLETS:;
#X text 38 51 - LEFT:;
#X text 32 143 - RIGHT:;
#X text 29 253 OUTLETS:;
#X text 15 194 ARGUMENTS:;
#X text 22 283 EXAMPLES:;
#X text 20 565 SEE ALSO:;
#X text 25 93 - CENTER:;
#X obj 47 10 #clip;
#X text 501 558 GridFlow 0.8.0;
#X floatatom 119 397 5 0 0 0 - - -;
#X floatatom 119 286 5 0 0 0 - - -;
#X text 205 339 creation arguments;
#X obj 119 342 #clip 255 0;
#X text 107 191 Two - [int] accepts two integers as creation arguments
which initializes the first values to be stored in the object and duplicate
the functions of the second and third inlet.;
#X obj 118 564 # min;
#X obj 165 564 # max;
#X obj 213 564 clip;
#X text 109 91 Integer - An integer at the second inlet is stored for
later use. It will be used as the high value at which to clip incoming
Grid values at that left inlet.;
#X text 109 142 Integer - An integer at the third inlet is stored for
later use. It will be used as the low value at which to clip incoming
Grid values at that left inlet.;
#X text 108 12 - FORCE THE GRID VALUES INTO A RANGE;
#X text 109 50 Grid - Grid values at the left inlet will be clipped
to the high and low values stored in the object.;
#X obj 360 485 #clip;
#X text 419 483 no arguments (defaults to 255 \, 0);
#X text 452 399 <-- change these;
#X obj 119 312 #import (1);
#X obj 119 370 #export;
#X text 107 191 Two - [int] accepts two integers as creation arguments
which initializes the first values to be stored in the object and duplicate
the functions of the second and third inlet.;
#X text 485 452 <--;
#X connect 0 0 1 0;
#X connect 1 0 33 0;
#X connect 2 0 1 1;
#X connect 4 0 0 0;
#X connect 5 0 0 0;
#X connect 5 1 4 0;
#X connect 7 0 5 0;
#X connect 8 0 7 0;
#X connect 9 0 33 1;
#X connect 10 0 33 2;
#X connect 22 0 36 0;
#X connect 24 0 37 0;
#X connect 33 0 3 0;
#X connect 36 0 24 0;
#X connect 37 0 21 0;
--- NEW FILE: #print-help2.pd ---
#N canvas 186 33 771 654 10;
#X obj 268 45 cnv 15 460 15 empty empty empty 20 12 0 14 -158509 -66577
0;
#X obj 278 65 cnv 15 450 15 empty empty empty 20 12 0 14 -233017 -66577
0;
#X obj 8 483 cnv 15 720 30 empty empty empty 20 12 0 14 -158509 -66577
0;
#X obj 8 513 cnv 15 720 30 empty empty empty 20 12 0 14 -233017 -66577
0;
#X obj 8 5 cnv 15 720 30 empty empty empty 20 12 0 14 -233017 -66577
0;
#X text 12 525 KEYWORDS: control number float store;
#X text 12 515 CATAGORY: control;
#X text 281 65 Left:;
#X obj 268 305 cnv 15 460 15 empty empty empty 20 12 0 14 -158509 -66577
0;
#X text 271 305 Arguments:;
#X text 283 325 One - [float] accepts a single float as a creation
argument which initializes the first value to be sent out the left
outlet.;
#X obj 268 375 cnv 15 460 15 empty empty empty 20 12 0 14 -158509 -66577
0;
#X text 271 375 Outlets:;
#X text 283 395 One - outputs the stored floating point value of the
object.;
#X obj 8 45 cnv 15 250 15 empty empty empty 20 12 0 14 -158509 -66577
0;
#X text 11 45 Usage:;
#X obj 8 65 cnv 15 250 30 empty empty empty 20 12 0 14 -233017 -66577
0;
#X obj 8 103 cnv 15 250 350 empty empty empty 20 12 0 14 -233017 -66577
0;
#X obj 150 73 f;
#X text 126 73 OR;
#X obj 452 489 pddp;
#N canvas 58 22 261 146 Related_Objects 0;
#X obj 3 87 cnv 15 250 15 empty empty empty 20 12 0 14 -158509 -66577
0;
#X obj 5 6 cnv 15 250 15 empty empty empty 20 12 0 14 -158509 -66577
0;
#X obj 3 107 cnv 15 250 30 empty empty empty 20 12 0 14 -233017 -66577
0;
#X obj 69 113 randomF;
#X obj 138 113 lister;
#X text 7 6 Native PD Objects (internals);
#X text 5 87 Externals and libraries;
#X obj 4 27 cnv 15 250 30 empty empty empty 20 12 0 14 -233017 -66577
0;
#X obj 70 34 int;
#X obj 137 34 symbol;
#X restore 15 490 pd Related_Objects;
#N canvas 57 22 517 577 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 154 490 pd More_Info;
#X text 496 490 - Dave Sabine \, November 18 \, 2002;
#X text 10 459 doc/2.control.examples/sendnumber.pd - should be a bang/link
;
#X text 12 7 HELP: #print;
#X text 12 17 DESCRIPTION: Displays values in the console.;
#X obj 80 73 #print;
#X text 271 45 Inlet:;
#X text 301 111 Grid - receives a grid;
#X floatatom 71 221 5 0 0 0 - - -;
#X floatatom 93 242 5 0 0 0 - - -;
#X floatatom 115 262 5 0 0 0 - - -;
#X obj 133 349 until;
#X msg 133 323 27;
#X obj 133 373 random 27;
#X obj 71 281 #pack 3;
#X obj 133 398 #import ( 3 3 3 );
#X obj 14 421 #print;
#X msg 39 139 open r001.jpg;
#X obj 39 167 #in;
#X obj 16 139 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
-1;
#X text 65 420 <-- view result in console;
#X text 12 106 view grid dimensions;
#X text 71 190 view grid info;
#X text 297 141 Integer - jhu;
#X connect 30 0 36 0;
#X connect 31 0 36 1;
#X connect 32 0 36 2;
#X connect 33 0 35 0;
#X connect 34 0 33 0;
#X connect 35 0 37 0;
#X connect 36 0 38 0;
#X connect 37 0 38 0;
#X connect 39 0 40 0;
#X connect 40 0 38 0;
#X connect 41 0 40 0;
--- NEW FILE: #remap_image-help.pd ---
#N canvas 95 151 750 524 10;
#X obj 268 25 cnv 15 460 15 empty empty empty 20 12 0 14 -200249 -66577
0;
#X obj 278 68 cnv 15 450 15 empty empty empty 20 12 0 14 -233017 -66577
0;
#X obj 8 442 cnv 15 720 30 empty empty empty 20 12 0 14 -200249 -66577
0;
#X obj 8 5 cnv 15 720 15 empty empty empty 20 12 0 14 -233017 -66577
0;
#X obj 278 140 cnv 15 450 15 empty empty empty 20 12 0 14 -233017 -66577
0;
#X obj 268 259 cnv 15 460 15 empty empty empty 20 12 0 14 -200249 -66577
0;
#X text 271 259 Outlets:;
#X obj 8 25 cnv 15 250 15 empty empty empty 20 12 0 14 -200249 -66577
0;
#X text 11 25 Usage:;
#X obj 8 45 cnv 15 250 30 empty empty empty 20 12 0 14 -233017 -66577
0;
#X obj 8 81 cnv 15 250 355 empty empty empty 20 12 0 14 -233017 -66577
0;
#X text 271 25 Inlets: (Read left to right \, inlet "0" being the leftmost)
;
#X text 281 68 0: (Leftmost);
#X text 281 140 1: (Rightmost);
#X text 12 5 SUMMARY: Transforms a grid by displacing pixels.;
#X obj 84 51 #remap_image;
#X text 292 88 Grid - Receives a grid that is to be transformed by
the object connected to the rightmost inlet.;
#X text 291 159 Numop - Receives a numereic operator \, pixel positions
are displaced according to the mathematic operation. Click here for
more transformation options.;
#X msg 48 143 open b001.jpg;
#X obj 18 86 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
-1;
#X obj 18 174 #in;
#X obj 18 112 t b b;
#X obj 18 411 #out window;
#X obj 97 383 #print;
#X obj 57 213 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
-1;
#X floatatom 101 285 5 0 0 0 - - -;
#X obj 68 244 #for (0 0) (240 320) (1 1);
#X obj 82 212 metro 100;
#X obj 82 187 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0 1
;
#X obj 97 317 # /;
#X obj 18 352 #remap_image;
#X text 16 449 GridFlow 0.8.0;
#X text 281 295 comment;
#X text 285 294 comment;
#X obj 282 299 cnv 15 450 15 empty empty empty 20 12 0 14 -233017 -66577
0;
#X obj 281 355 cnv 15 450 15 empty empty empty 20 12 0 14 -233017 -66577
0;
#X text 285 299 0: (Leftmost);
#X text 284 355 1: (Rightmost);
#X text 296 323 Grid - Outputs the transformend image.;
#X text 288 375 Numop - Displays the displaced values.;
#X text 145 284 <-- Modify the value to see transformations.;
#X connect 18 0 20 0;
#X connect 19 0 21 0;
#X connect 20 0 30 0;
#X connect 21 0 20 0;
#X connect 21 1 18 0;
#X connect 24 0 26 0;
#X connect 25 0 29 1;
#X connect 26 0 29 0;
#X connect 27 0 26 0;
#X connect 28 0 27 0;
#X connect 29 0 30 1;
#X connect 30 0 22 0;
#X connect 30 1 23 0;
--- NEW FILE: renamefile-help.pd ---
#N canvas 383 288 441 244 10;
#X obj 50 120 renamefile;
#X msg 50 76 list current_name new_name;
#X obj 128 206 ls;
#X text 42 208 also see :;
#X text 313 21 GridFlow 0.8.0;
#X text 45 157 * The path should correspond to the location of the
file from where pd is started;
#X connect 1 0 0 0;
--- NEW FILE: #contrast-help.pd ---
#N canvas 120 14 814 532 10;
#X obj 96 131 bng 15 250 50 0 empty empty empty 0 -6 0 8 -233017 -1
-1;
#X obj 22 151 metro 100;
#X obj 22 130 tgl 15 0 empty empty empty 0 -6 0 8 -233017 -1 -1 0 1
;
#X obj 123 269 hsl 128 15 0 256 0 0 empty empty empty -2 -6 0 8 -262144
-1 -1 0 1;
#X obj 124 332 hsl 128 15 0 256 0 0 empty empty empty -2 -6 0 8 -262144
-1 -1 0 1;
#X text 15 57 adjusts the intensity in an image. resulting values outside
0-255 are automatically clipped.;
#X text 262 334 master contrast;
#X text 258 273 secondary contrast;
#X floatatom 51 343 5 0 0 0 - - -;
#X floatatom 80 375 5 0 0 0 - - -;
#X text 401 273 makes the incoming black correspond to a certain fraction
between output black and the master contrast value. no effect is 256
this is also the default.;
#X text 402 334 makes the incoming white correspond to a certain fraction
between output black and output white. no effect is 256 this is also
the default.;
#X text 18 497 see also:;
#X msg 119 220 open bluemarble.jpg;
#X obj 96 151 fork;
#X obj 88 499 #convolve;
#X obj 158 499 #posterize;
#X obj 235 499 #solarize;
#X obj 305 499 #layer;
#X obj 22 423 #out window;
#X obj 22 397 #contrast;
#X obj 22 237 #in;
#X text 13 15 [#contrast];
#X text 700 15 GridFlow 0.8.0;
#X connect 0 0 14 0;
#X connect 1 0 21 0;
#X connect 2 0 1 0;
#X connect 3 0 8 0;
#X connect 4 0 9 0;
#X connect 8 0 20 1;
#X connect 9 0 20 2;
#X connect 13 0 21 0;
#X connect 14 0 21 0;
#X connect 14 1 13 0;
#X connect 20 0 19 0;
#X connect 21 0 20 0;
--- NEW FILE: #rgb_to_yuv-help.pd ---
#N canvas 560 468 450 300 10;
#X msg 112 64 open lena.jpg;
#X obj 116 169 #out window;
#X obj 88 19 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
-1;
#X obj 52 84 #in;
#X obj 60 132 #yuv_to_rgb;
#X connect 0 0 3 0;
#X connect 2 0 3 0;
#X connect 3 0 4 0;
#X connect 4 0 1 0;
--- NEW FILE: #reverse-help.pd ---
#N canvas 599 113 566 552 10;
#X text 428 11 GridFlow 0.8.0;
#X obj 258 207 #color;
#X obj 288 391 #color;
#X obj 259 476 display;
#X text 15 27 [#reverse];
#X obj 258 359 t a a;
#X text 15 57 Swaps the values of incoming grids while preserving the
number of Dimensions between incoming and outgoing grids.;
#X obj 22 287 #in;
#X obj 22 206 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
-1;
#X msg 52 256 open b001.jpg;
#X obj 22 401 #out window;
#X obj 87 289 hradio 15 1 0 6 empty empty empty 0 -6 0 8 -260818 -1
-1 5;
#X obj 87 307 - 3;
#X floatatom 87 327 5 0 0 0 - - -;
#X text 16 107 0 vertical;
#X text 16 122 1 horizontal;
#X text 16 135 2 rgb <-> bgr;
#X text 16 150 -1 \, -2 \, -3 \, swaps the specicied dimensions;
#X text 16 92 An int argument changes the behavior in this way :;
#X obj 22 228 t b b;
#X obj 22 344 #reverse 0;
#X obj 258 330 #reverse 0;
#X obj 323 275 hradio 15 1 0 6 empty empty empty 0 -6 0 8 -260818 -1
-1 0;
#X obj 323 293 - 3;
#X floatatom 323 313 5 0 0 0 - - -;
#X connect 1 0 21 0;
#X connect 5 0 3 0;
#X connect 5 1 2 0;
#X connect 7 0 20 0;
#X connect 8 0 19 0;
#X connect 9 0 7 0;
#X connect 11 0 12 0;
#X connect 12 0 13 0;
#X connect 13 0 20 1;
#X connect 19 0 7 0;
#X connect 19 1 9 0;
#X connect 20 0 10 0;
#X connect 21 0 5 0;
#X connect 22 0 23 0;
#X connect 23 0 24 0;
#X connect 24 0 21 1;
--- NEW FILE: #fade-help.pd ---
#N canvas 48 74 732 441 10;
#X obj 268 95 cnv 15 460 15 empty empty empty 20 12 0 14 -200249 -66577
0;
#X obj 278 115 cnv 15 450 15 empty empty empty 20 12 0 14 -233017 -66577
0;
#X obj 8 406 cnv 15 720 30 empty empty empty 20 12 0 14 -200249 -66577
0;
#X obj 8 3 cnv 15 720 15 empty empty empty 20 12 0 14 -233017 -66577
0;
#X obj 278 174 cnv 15 450 15 empty empty empty 20 12 0 14 -233017 -66577
0;
#X obj 268 25 cnv 15 460 15 empty empty empty 20 12 0 14 -200249 -66577
0;
#X text 271 25 Arguments:;
#X obj 268 281 cnv 15 460 15 empty empty empty 20 12 0 14 -200249 -66577
0;
#X text 271 281 Outlets:;
#X obj 8 25 cnv 15 250 15 empty empty empty 20 12 0 14 -200249 -66577
0;
#X text 11 25 Usage:;
#X obj 8 45 cnv 15 250 30 empty empty empty 20 12 0 14 -233017 -66577
0;
#X obj 8 81 cnv 15 250 320 empty empty empty 20 12 0 14 -233017 -66577
0;
#X obj 268 343 cnv 15 460 15 empty empty empty 20 12 0 14 -200249 -66577
0;
#X text 271 343 More Info:;
#X text 271 95 Inlets: (Read left to right \, inlet "0" being the leftmost)
;
#X text 281 115 0: (Leftmost);
#X text 281 174 1: (Rightmost);
#X obj 104 53 #fade;
#X obj 91 324 #fade;
#X obj 91 350 #out window;
#X msg 31 224 open b001.jpg;
#X obj 22 166 bng 15 250 50 0 empty empty empty 0 -6 0 8 -225271 -1
-1;
#X obj 22 252 #in;
#X obj 22 199 t b b;
#X obj 50 303 bng 15 250 50 0 empty empty empty 0 -6 0 8 -24198 -1
-1;
#X floatatom 134 305 5 0 0 0 - - -;
#X obj 22 139 metro 500;
#X obj 22 113 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0 1
;
#X obj 144 165 bng 15 250 50 0 empty empty empty 0 -6 0 8 -225271 -1
-1;
#X obj 144 251 #in;
#X obj 144 198 t b b;
#X msg 153 223 open r001.jpg;
#X obj 144 136 metro 500;
#X obj 144 111 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0
1;
#X text 16 413 GridFlow 0.8.0;
#X text 71 3 Fades a grids according to the argument you provide.;
#X text 10 4 SUMMARY:;
#X text 284 45 One - See inlet 0: (rightmost);
#X text 292 135 Grid - Accepts s grid and multiplies it with a fraction
of the previously outputted grid.;
#X text 292 195 Integer - accepts an integer that determines the amount
one grid is blended with another. For example: integer 5 takes 20%
of the first image and blends it with 80% of the following image.;
#X text 283 301 One - Outputs the fading images.;
#X connect 19 0 20 0;
#X connect 21 0 23 0;
#X connect 22 0 24 0;
#X connect 23 0 19 0;
#X connect 24 0 23 0;
#X connect 24 1 21 0;
#X connect 25 0 19 0;
#X connect 26 0 19 1;
#X connect 27 0 22 0;
#X connect 28 0 27 0;
#X connect 29 0 31 0;
#X connect 30 0 19 0;
#X connect 31 0 30 0;
#X connect 31 1 32 0;
#X connect 32 0 30 0;
#X connect 33 0 29 0;
#X connect 34 0 33 0;
--- NEW FILE: unix_time-help.pd ---
#N canvas 696 154 450 446 10;
#X obj 137 107 unix_time;
#X obj 136 68 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
-1;
#X obj 78 146 #export_list;
#X obj 167 171 display;
#X obj 43 18 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0 1
;
#X obj 283 243 nbx 9 14 -1e+37 1e+37 0 0 empty empty empty 0 -6 0 10
-262144 -1 -1 0 256;
#X obj 11 290 display;
#X text 381 243 <-- 1/100000 th of a second \, useful for generating
filenames;
#X text 213 170 <-- Unix timestamp;
#X obj 86 30 metro 500;
#X text 274 19 GridFlow 0.8.0;
#X text 225 88 Outputs;
#X text 62 287 <-- Ascii format for the date;
#X connect 0 0 2 0;
#X connect 0 1 3 0;
#X connect 0 2 5 0;
#X connect 1 0 0 0;
#X connect 2 0 6 0;
#X connect 4 0 9 0;
#X connect 9 0 1 0;
--- NEW FILE: exec-help.pd ---
#N canvas 0 0 450 267 10;
#X text 259 22 GridFlow 0.8.0;
#X text 50 221 see also:;
#X obj 126 221 renamefile;
#X obj 241 221 unix_time;
#X obj 61 130 exec;
#X msg 35 78 shell xlogo &;
#X msg 144 78 shell ftp ac(a)artengine.ca &;
#X obj 209 221 ls;
#X text 141 121 Executes a program or script. It is not return a result
\, see the PureData shell after using the ftp command.;
#X connect 5 0 4 0;
#X connect 6 0 4 0;
--- NEW FILE: ls-help.pd ---
#N canvas 293 272 624 295 10;
#X text 259 22 GridFlow 0.8.0;
#X text 30 266 see also:;
#X obj 106 267 renamefile;
#X obj 189 267 unix_time;
#X obj 67 130 ls;
#X obj 67 48 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
-1;
#X obj 25 186 listlength;
#X floatatom 25 220 5 0 0 0 - - -;
#X obj 107 187 display;
#X obj 265 267 exec;
#X msg 67 81 symbol /home;
#X text 157 118 Similar to the Unix command 'ls'. Returns the filenames
in a directory. May be used with [listlength] to determine the number
of files in a directory.;
#X connect 4 0 6 0;
#X connect 4 0 8 0;
#X connect 5 0 10 0;
#X connect 6 0 7 0;
#X connect 10 0 4 0;
--- NEW FILE: #+-help.pd ---
#N canvas 165 32 693 623 10;
#X obj 8 3 cnv 15 90 578 empty empty empty 20 12 0 14 -233017 -66577
0;
#X text 36 326 INLETS:;
#X text 36 344 - LEFT:;
#X text 30 386 - RIGHT:;
#X text 29 469 OUTLETS:;
#X text 28 53 EXAMPLES:;
#X text 16 553 SEE ALSO:;
#N canvas 52 15 871 640 More_Info 0;
#X text 76 366 A + B;
#X text 77 510 A * B;
#X text 73 571 rounded towards zero;
#X text 14 73 angles are in hundredth of degrees \, so a full circle
(two pi radians) is 36000 you can convert from radians to our angles
by multiplying by 18000/pi.;
#X text 13 44 for all of these \, A refers to the left inlet and B
to the value on the right.;
#X text 15 27 Consult doc/architecture.html to see all the 40 of them.
;
#X text 902 31 GridFlow 0.8.0;
#X obj 479 70 #color;
#X obj 684 72 #color;
#X msg 15 366 op +;
#X msg 15 507 op *;
#X obj 15 385 s op;
#X obj 423 155 r op;
#X obj 15 526 s op;
#X obj 15 436 s op;
#X text 77 421 A - B;
#X msg 15 417 op -;
#X obj 15 761 s op;
#X msg 15 742 op %;
#X text 69 743 A % B;
#X obj 15 575 s op;
#X msg 15 556 op /;
#X text 79 557 A / B;
#X obj 14 809 s op;
#X text 83 790 B % A;
#X text 15 14 Numeric Operators: *whoa \, there's a lot of them;
#X obj 16 482 s op;
#X msg 16 463 op inv+;
#X text 79 464 B -A;
#X obj 15 623 s op;
#X text 79 605 A / B;
#X msg 15 604 op div;
#X text 75 621 rounded downwards;
#X obj 15 668 s op;
#X msg 15 649 op inv*;
#X text 80 650 B / A;
#X text 77 665 rounded towards 0;
#X obj 15 712 s op;
#X text 76 714 rounded downwards;
#X text 101 695 B / A;
#X text 68 760 modulo (goes with div);
#X text 65 809 modulo (goes with div);
#X msg 14 790 op swap%;
#X obj 15 286 s op;
#X obj 15 334 s op;
#X msg 15 267 op ignore;
#X text 90 268 A;
#X msg 15 315 op put;
#X text 76 315 B;
#X msg 15 693 op swapdiv;
#X obj 237 286 s op;
#X msg 237 267 op rem;
#X text 315 263 A % B;
#X obj 236 338 s op;
#X text 330 319 B % A;
#X text 314 278 remainder;
#X text 314 293 (goes with /);
#X msg 236 319 op swaprem;
#X text 327 333 remainder;
#X text 326 348 (goes with /);
#X obj 236 388 s op;
#X obj 236 435 s op;
#X msg 236 369 op gcd;
#X msg 236 416 op lcm;
#X text 298 373 greatest common divisor;
#X text 298 420 least common multiple;
#X obj 235 481 s op;
#X text 299 464 A or B \, bitwise;
#X msg 235 462 op;
#X obj 235 525 s op;
#X text 299 508 A xor B \, bitwise;
#X msg 235 506 op ^;
#X obj 235 578 s op;
#X msg 235 559 op &;
#X text 300 561 A and B \, bitwise;
#X obj 235 623 s op;
#X msg 235 604 op <<;
#X text 300 606 A * (2**(B % 32);
#X text 299 621 left-shifthing;
#X obj 235 669 s op;
#X msg 235 649 op >>;
#X text 299 666 right-shifthing;
#X text 300 652 A / (2**(B % 32);
#X obj 218 463 bng 15 250 50 0 empty empty empty 0 -6 0 8 -258699 -1
-1;
#X obj 235 714 s op;
#X msg 235 695 op;
#X obj 218 695 bng 15 250 50 0 empty empty empty 0 -6 0 8 -258699 -1
-1;
#X text 299 697 if A is zero then;
#X text 300 711 B else A;
#X obj 235 758 s op;
#X text 299 741 if A is zero then;
#X text 15 110 comment;
#X msg 235 739 op &&;
#X text 300 755 zero else B;
#X obj 236 807 s op;
#X msg 236 788 op min;
#X text 300 789 the lowest value;
#X text 301 804 in A \, B;
#X obj 500 287 s op;
#X msg 500 267 op max;
#X text 556 284 in A \, B;
#X text 557 268 the highest value;
#X obj 500 333 s op;
#X msg 500 313 op cmp;
#X text 551 310 -1 when A<B;
#X text 558 338 1 when A>B;
#X text 558 324 0 when A=B;
#X obj 500 386 s op;
#X msg 500 366 op ==;
#X text 557 367 is A equal to B ?;
#X text 556 385 1 = true \, 0 = false;
#X obj 500 433 s op;
#X msg 500 413 op !=;
#X text 557 414 is A not equal to B ?;
#X obj 500 477 s op;
#X msg 500 456 op >;
#X text 557 457 is A greater than B ?;
#X obj 500 523 s op;
#X msg 500 502 op <=;
#X text 557 503 is A not greater than B ?;
#X obj 500 572 s op;
#X msg 500 551 op <;
#X text 557 552 is A less than B ?;
#X obj 500 618 s op;
#X msg 500 597 op >=;
#X text 557 598 is A not less than B ?;
#X obj 500 666 s op;
#X msg 500 645 op sin*;
#X text 559 646 B * sin(A);
#X obj 500 713 s op;
#X msg 500 691 op cos*;
#X text 560 693 B * cos(A);
#X obj 500 758 s op;
#X msg 500 736 op atan;
#X text 560 737 arctan(A/B);
#X obj 499 805 s op;
#X msg 499 783 op tan*;
#X text 559 784 tanh(A);
#X obj 738 288 s op;
#X msg 738 268 op log*;
#X text 795 269 B*log(A);
#X text 794 286 in base e;
#X obj 738 334 s op;
#X msg 738 314 op gamma;
#X text 809 314 floor(pow(a/256.0 \, 256.0/b)*256.0);
#X obj 737 385 s op;
#X msg 737 366 op **;
#X text 799 368 A**B;
#X text 799 385 A raised to power B;
#X obj 737 431 s op;
#X msg 737 412 op abs-;
#X text 799 412 absolute value of (A-B);
#X obj 737 478 s op;
#X msg 737 459 op rand;
#X text 800 473 number below A;
#X text 799 458 randomly produces a non-negative;
#X obj 737 524 s op;
#X msg 737 505 op sqrt;
#X text 799 504 square root of A;
#X text 800 519 rounded downwards;
#X obj 737 566 s op;
#X msg 737 547 op sq-;
#X text 800 546 (A-B) times (A-B);
#X obj 740 614 s op;
#X obj 723 595 bng 15 250 50 0 empty empty empty 0 -6 0 8 -258699 -1
-1;
#X msg 740 595 op clip+;
#X text 808 595 A+B but output is clipped;
#X obj 740 660 s op;
#X obj 723 641 bng 15 250 50 0 empty empty empty 0 -6 0 8 -258699 -1
-1;
#X msg 740 641 op clip-;
#X text 808 641 A-B but output is clipped;
#X obj 740 706 s op;
#X obj 740 750 s op;
#X text 808 687 (A+B)/2;
#X msg 740 687 op avg;
#X msg 740 731 op hypot;
#X text 808 731 square root of (A*A+B*B);
#X obj 740 792 s op;
#X obj 723 773 bng 15 250 50 0 empty empty empty 0 -6 0 8 -258699 -1
-1;
#X msg 740 773 op erf;
#X text 807 773 integral of e^(-x*x)dx;
#N canvas 8 30 615 351 all_operators 0;
#X obj 174 99 # -;
#X obj 522 97 # swap%;
#X obj 186 177 # abs-;
#X obj 238 177 # rand;
#X obj 342 177 # sq-;
#X obj 290 177 # sqrt;
#X obj 144 99 # +;
#X obj 492 97 # %;
#X obj 260 99 # *;
#X obj 289 99 # /;
#X obj 206 99 # inv+;
#X obj 321 99 # div;
#X obj 367 98 # inv*;
#X obj 420 98 # swapdiv;
#X obj 35 99 # ignore;
#X obj 100 100 # put;
#X obj 35 125 # rem;
#X obj 78 125 # swaprem;
#X obj 149 125 # gcd;
#X obj 191 125 # lcm;
#X obj 234 125 # |;
#X obj 234 125 # |;
#X obj 263 125 # ^;
#X obj 293 125 # &;
#X obj 322 125 # <<;
#X obj 358 125 # >>;
#X obj 394 125 # ||;
#X obj 431 125 # &&;
#X obj 467 125 # min;
#X obj 35 151 # max;
#X obj 79 151 # cmp;
#X obj 124 151 # ==;
#X obj 162 151 # !=;
#X obj 199 151 # >;
#X obj 234 151 # <=;
#X obj 274 151 # <;
#X obj 304 152 # >=;
#X obj 341 152 # sin*;
#X obj 391 152 # cos*;
#X obj 442 152 # atan;
#X obj 493 152 # tanh*;
#X obj 35 177 # log*;
#X obj 87 177 # gamma;
#X obj 148 177 # **;
#X obj 388 177 # avg;
#X obj 433 177 # hypot;
#X restore 15 174 pd all_operators;
#X text 585 31 select values below;
#X text 14 233 select an operator below;
#X text 478 51 A;
#X text 683 53 B;
#X obj 479 182 # +;
#X obj 257 196 #color;
#X obj 297 162 #reverse;
#X obj 443 215 display;
#X obj 656 197 #unpack 3;
#X floatatom 605 244 5 0 0 0 - - -;
#X obj 642 150 t a a;
#X obj 597 191 display;
#X connect 7 0 186 0;
#X connect 7 0 188 0;
#X connect 7 0 192 0;
#X connect 8 0 186 1;
#X connect 9 0 11 0;
#X connect 10 0 13 0;
#X connect 12 0 186 0;
#X connect 16 0 14 0;
#X connect 18 0 17 0;
#X connect 21 0 20 0;
#X connect 27 0 26 0;
#X connect 31 0 29 0;
#X connect 34 0 33 0;
#X connect 42 0 23 0;
#X connect 45 0 43 0;
#X connect 47 0 44 0;
#X connect 49 0 37 0;
#X connect 51 0 50 0;
#X connect 57 0 53 0;
#X connect 62 0 60 0;
#X connect 63 0 61 0;
#X connect 68 0 66 0;
#X connect 71 0 69 0;
#X connect 73 0 72 0;
#X connect 76 0 75 0;
#X connect 80 0 79 0;
#X connect 85 0 84 0;
#X connect 92 0 89 0;
#X connect 95 0 94 0;
#X connect 99 0 98 0;
#X connect 103 0 102 0;
#X connect 108 0 107 0;
#X connect 112 0 111 0;
#X connect 115 0 114 0;
#X connect 118 0 117 0;
#X connect 121 0 120 0;
#X connect 124 0 123 0;
#X connect 127 0 126 0;
#X connect 130 0 129 0;
#X connect 133 0 132 0;
#X connect 136 0 135 0;
#X connect 139 0 138 0;
#X connect 143 0 142 0;
#X connect 146 0 145 0;
#X connect 150 0 149 0;
#X connect 153 0 152 0;
#X connect 157 0 156 0;
#X connect 161 0 160 0;
#X connect 165 0 163 0;
#X connect 169 0 167 0;
#X connect 174 0 171 0;
#X connect 175 0 172 0;
#X connect 179 0 177 0;
#X connect 188 0 187 0;
#X connect 188 0 189 0;
#X connect 190 0 191 0;
#X connect 192 0 193 0;
#X connect 192 1 190 0;
#X restore 115 574 pd More_Info;
#X text 36 492 - LEFT:;
#X text 412 575 updated for GridFlow version 0.8.0;
#X floatatom 151 163 5 0 0 0 - - -;
#X text 113 554 list of other operators;
#X obj 71 9 # +;
#X text 108 12 - OPERATORS ([# +] in this case) APPLY OPERATIONS ONTO
GRIDS;
#X text 109 345 Grid - accepts a grid that will be modified by the
operator according to the right inlet value. (list of operators in
[pd more_info]) ([# +] in this example.);
#X text 108 395 Grid - accepts grids that will modify the incoming
grid \, from the left inlet \, (preferably of the same dimensions.)
;
#X text 105 439 Integer - accepts integers that will modify the incoming
grid.;
#X text 107 492 Grid - outputs the modified data as a grid.;
#X obj 142 211 display;
#X obj 114 93 #color;
#X msg 114 60 255 0 0;
#X obj 114 253 #color;
#X obj 511 179 #in;
#X obj 511 249 #out window;
#X msg 541 156 open b001.jpg;
#X obj 511 113 t b b;
#X obj 511 58 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0 1
;
#X obj 511 79 metro 100;
#X obj 511 202 # +;
#X obj 511 226 #clip;
#X text 204 164 <-- change this value.;
#X obj 114 181 # + 42;
#X text 293 109 <-- modify color;
#X connect 10 0 31 1;
#X connect 19 0 31 0;
#X connect 20 0 19 0;
#X connect 22 0 28 0;
#X connect 24 0 22 0;
#X connect 25 0 22 0;
#X connect 25 1 24 0;
#X connect 26 0 27 0;
#X connect 27 0 25 0;
#X connect 28 0 29 0;
#X connect 29 0 23 0;
#X connect 31 0 18 0;
#X connect 31 0 21 0;
--- NEW FILE: plotter_control-help.pd ---
#N canvas 423 134 724 349 10;
#X text 557 11 GridFlow 0.8.0;
#X obj 92 99 r foo;
#X msg 557 173 print_from_ascii $*;
#X msg 557 52 print hello_world;
#X msg 284 54 pu;
#X msg 284 102 pd;
#X msg 285 205 sp 0;
#X msg 284 154 pa 120 160;
#X obj 557 124 unix_time;
#X obj 557 148 @export_list;
#X obj 557 104 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
-1;
#X obj 74 255 comport 0 9600;
#X obj 76 129 plotter_control;
#X obj 93 158 print hpgl_commands;
#X obj 557 196 s foo;
#X text 324 54 pen up;
#X text 324 102 pen down;
#X obj 557 74 s foo;
#X text 368 154 move to absolute position;
#N canvas 0 0 450 300 draw_a_rectangle 0;
#X obj 120 196 @export_list;
#X obj 128 159 @ * ( 110 320 );
#X msg 31 156 pu \, sp 0;
#X obj 28 97 fork;
#X msg 114 222 pd \, pa \$2 \$1;
#X msg 129 100 sp 5 \, pu \, pa 0 0 \, other si 320 320;
#X obj 115 252 s foo;
#X obj 33 71 fork;
#X obj 30 126 fork;
#X msg 128 134 0 0 \, 0 1 \, 1 1 \, 1 0 \, 0 0;
#X obj 31 35 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
-1;
#X connect 0 0 4 0;
#X connect 1 0 0 0;
#X connect 2 0 6 0;
#X connect 3 0 8 0;
#X connect 3 1 9 0;
#X connect 4 0 6 0;
#X connect 7 0 3 0;
#X connect 7 1 5 0;
#X connect 8 0 2 0;
#X connect 9 0 1 0;
#X connect 10 0 7 0;
#X restore 557 228 pd draw_a_rectangle;
#X text 76 9 plotter_control;
#X text 74 280 use the comport object to interface to the plotter;
#X obj 285 227 s foo;
#X obj 284 176 s foo;
#X obj 284 124 s foo;
#X obj 284 76 s foo;
#X text 328 207 (0...6) remove/change the pen;
#X connect 1 0 12 0;
#X connect 2 0 14 0;
#X connect 3 0 17 0;
#X connect 4 0 25 0;
#X connect 5 0 24 0;
#X connect 6 0 22 0;
#X connect 7 0 23 0;
#X connect 8 0 9 0;
#X connect 9 0 2 0;
#X connect 10 0 8 0;
#X connect 12 0 13 0;
--- NEW FILE: #print-help.pd ---
#N canvas 38 0 738 404 10;
#X obj 269 196 cnv 15 460 15 empty empty empty 20 12 0 14 -200249 -66577
0;
#X obj 279 217 cnv 15 450 15 empty empty empty 20 12 0 14 -233017 -66577
0;
#X obj 7 369 cnv 15 720 30 empty empty empty 20 12 0 14 -200249 -66577
0;
#X obj 8 6 cnv 15 720 40 empty empty empty 20 12 0 14 -233017 -66577
0;
#X obj 268 53 cnv 15 460 15 empty empty empty 20 12 0 14 -200249 -66577
0;
#X text 271 53 Arguments:;
#X obj 8 53 cnv 15 250 15 empty empty empty 20 12 0 14 -200249 -66577
0;
#X text 11 53 Usage:;
#X obj 8 73 cnv 15 250 30 empty empty empty 20 12 0 14 -233017 -66577
0;
#X obj 271 305 cnv 15 460 15 empty empty empty 20 12 0 14 -200249 -66577
0;
#X text 272 196 Inlets: (Read left to right \, inlet "0" being the
leftmost);
#X text 282 217 0: (Leftmost);
#X obj 8 110 cnv 15 250 250 empty empty empty 20 12 0 14 -233017 -66577
0;
#X obj 105 79 #print;
#X text 12 6 SUMMARY:;
#X floatatom 167 212 5 0 0 0 - - -;
#X floatatom 189 233 5 0 0 0 - - -;
#X floatatom 211 253 5 0 0 0 - - -;
#X obj 34 202 until;
#X msg 34 176 27;
#X obj 34 226 random 27;
#X obj 167 272 #pack 3;
#X obj 34 251 #import ( 3 3 3 );
#X msg 35 118 open r001.jpg;
#X obj 15 150 #in;
#X obj 12 118 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
-1;
#X text 155 189 view grid info;
#X text 101 344 view result in console;
#X text 274 305 Related objects:;
#X obj 460 336 rubyprint;
#X obj 530 329 printargs;
#X obj 279 336 #dim;
#X obj 314 336 #export;
#X obj 369 336 #export_list;
#X obj 600 329 print;
#X text 15 376 GridFLow 0.8.0;
#X text 73 6 Displays the dimensions of a grid in the console. If the
grid has less than two dimensions it will display all grid data.;
#X text 284 123 Symbol - Adds a symbol (text) as a prefix before the
printed element in the console.;
#X text 283 87 Integer - Adds a number as a prefix before the element
printed in the console. See here;
#X text 282 246 Grid - Receives and outputs the dimensions of a grid.
;
#X obj 15 319 #print paprika;
#X connect 15 0 21 0;
#X connect 16 0 21 1;
#X connect 17 0 21 2;
#X connect 18 0 20 0;
#X connect 19 0 18 0;
#X connect 20 0 22 0;
#X connect 21 0 40 0;
#X connect 22 0 40 0;
#X connect 23 0 24 0;
#X connect 24 0 40 0;
#X connect 25 0 24 0;
--- NEW FILE: #dim-help.pd ---
#N canvas 449 187 546 331 10;
#X obj 26 83 bng 15 250 50 0 empty empty empty 0 -6 0 8 -233017 -1
-1;
#X obj 137 217 print dimension;
#X obj 18 241 print number_of_dimensions;
#X text 18 282 see also:;
#X obj 136 283 rubyprint;
#X obj 206 283 printargs;
#X msg 18 63 open bluemarble.jpg;
#X text 438 10 GridFlow 0.8.0;
#X obj 87 283 #print;
#X obj 276 283 #export;
#X obj 332 283 #export_list;
#X obj 137 196 #export;
#X obj 18 197 #dim;
#X obj 18 217 #export;
#X obj 18 127 #dim;
#X obj 18 103 #in;
#X text 14 15 [#dim];
#X text 137 100 dim receives a grid \, doesn't look at the data within
but only the list of dimensions and turns it into a one dimension grid.
given a grid sized like dim(240 \, 320 \, 4) #dim will return a grid
like dim(3) whose values are 240 \, 320 \, 4;
#X connect 0 0 15 0;
#X connect 6 0 0 0;
#X connect 6 0 15 0;
#X connect 11 0 1 0;
#X connect 12 0 13 0;
#X connect 13 0 2 0;
#X connect 14 0 11 0;
#X connect 14 0 12 0;
#X connect 15 0 14 0;
--- NEW FILE: #-help.pd ---
#N canvas 291 30 1089 795 10;
#X text 76 366 A + B;
#X text 77 510 A * B;
#X text 73 571 rounded towards zero;
#X text 14 73 angles are in hundredth of degrees \, so a full circle
(two pi radians) is 36000 you can convert from radians to our angles
by multiplying by 18000/pi.;
#X text 13 44 for all of these \, A refers to the left inlet and B
to the value on the right.;
#X text 15 27 Consult doc/architecture.html to see all the 40 of them.
;
#X text 902 31 GridFlow 0.8.0;
#X obj 479 70 #color;
#X obj 684 72 #color;
#X msg 15 366 op +;
#X msg 15 507 op *;
#X obj 15 385 s op;
#X obj 423 155 r op;
#X obj 15 526 s op;
#X obj 15 436 s op;
#X text 77 421 A - B;
#X msg 15 417 op -;
#X obj 15 761 s op;
#X msg 15 742 op %;
#X text 69 743 A % B;
#X obj 15 575 s op;
#X msg 15 556 op /;
#X text 79 557 A / B;
#X obj 14 809 s op;
#X text 83 790 B % A;
#X text 15 14 Numeric Operators: *whoa \, there's a lot of them;
#X obj 16 482 s op;
#X msg 16 463 op inv+;
#X text 79 464 B -A;
#X obj 15 623 s op;
#X text 79 605 A / B;
#X msg 15 604 op div;
#X text 75 621 rounded downwards;
#X obj 15 668 s op;
#X msg 15 649 op inv*;
#X text 80 650 B / A;
#X text 77 665 rounded towards 0;
#X obj 15 712 s op;
#X text 76 714 rounded downwards;
#X text 101 695 B / A;
#X text 68 760 modulo (goes with div);
#X text 65 809 modulo (goes with div);
#X msg 14 790 op swap%;
#X obj 15 286 s op;
#X obj 15 334 s op;
#X msg 15 267 op ignore;
#X text 90 268 A;
#X msg 15 315 op put;
#X text 76 315 B;
#X msg 15 693 op swapdiv;
#X obj 237 286 s op;
#X msg 237 267 op rem;
#X text 315 263 A % B;
#X obj 236 338 s op;
#X text 330 319 B % A;
#X text 314 278 remainder;
#X text 314 293 (goes with /);
#X msg 236 319 op swaprem;
#X text 327 333 remainder;
#X text 326 348 (goes with /);
#X obj 236 388 s op;
#X obj 236 435 s op;
#X msg 236 369 op gcd;
#X msg 236 416 op lcm;
#X text 298 373 greatest common divisor;
#X text 298 420 least common multiple;
#X obj 235 481 s op;
#X text 299 464 A or B \, bitwise;
#X msg 235 462 op;
#X obj 235 525 s op;
#X text 299 508 A xor B \, bitwise;
#X msg 235 506 op ^;
#X obj 235 578 s op;
#X msg 235 559 op &;
#X text 300 561 A and B \, bitwise;
#X obj 235 623 s op;
#X msg 235 604 op <<;
#X text 300 606 A * (2**(B % 32);
#X text 299 621 left-shifthing;
#X obj 235 669 s op;
#X msg 235 649 op >>;
#X text 299 666 right-shifthing;
#X text 300 652 A / (2**(B % 32);
#X obj 218 463 bng 15 250 50 0 empty empty empty 0 -6 0 8 -258699 -1
-1;
#X obj 235 714 s op;
#X msg 235 695 op;
#X obj 218 695 bng 15 250 50 0 empty empty empty 0 -6 0 8 -258699 -1
-1;
#X text 299 697 if A is zero then;
#X text 300 711 B else A;
#X obj 235 758 s op;
#X text 299 741 if A is zero then;
#X text 15 110 comment;
#X msg 235 739 op &&;
#X text 300 755 zero else B;
#X obj 236 807 s op;
#X msg 236 788 op min;
#X text 300 789 the lowest value;
#X text 301 804 in A \, B;
#X obj 500 287 s op;
#X msg 500 267 op max;
#X text 556 284 in A \, B;
#X text 557 268 the highest value;
#X obj 500 333 s op;
#X msg 500 313 op cmp;
#X text 551 310 -1 when A<B;
#X text 558 338 1 when A>B;
#X text 558 324 0 when A=B;
#X obj 500 386 s op;
#X msg 500 366 op ==;
#X text 557 367 is A equal to B ?;
#X text 556 385 1 = true \, 0 = false;
#X obj 500 433 s op;
#X msg 500 413 op !=;
#X text 557 414 is A not equal to B ?;
#X obj 500 477 s op;
#X msg 500 456 op >;
#X text 557 457 is A greater than B ?;
#X obj 500 523 s op;
#X msg 500 502 op <=;
#X text 557 503 is A not greater than B ?;
#X obj 500 572 s op;
#X msg 500 551 op <;
#X text 557 552 is A less than B ?;
#X obj 500 618 s op;
#X msg 500 597 op >=;
#X text 557 598 is A not less than B ?;
#X obj 500 666 s op;
#X msg 500 645 op sin*;
#X text 559 646 B * sin(A);
#X obj 500 713 s op;
#X msg 500 691 op cos*;
#X text 560 693 B * cos(A);
#X obj 500 758 s op;
#X msg 500 736 op atan;
#X text 560 737 arctan(A/B);
#X obj 499 805 s op;
#X msg 499 783 op tan*;
#X text 559 784 tanh(A);
#X obj 738 288 s op;
#X msg 738 268 op log*;
#X text 795 269 B*log(A);
#X text 794 286 in base e;
#X obj 738 334 s op;
#X msg 738 314 op gamma;
#X text 809 314 floor(pow(a/256.0 \, 256.0/b)*256.0);
#X obj 737 385 s op;
#X msg 737 366 op **;
#X text 799 368 A**B;
#X text 799 385 A raised to power B;
#X obj 737 431 s op;
#X msg 737 412 op abs-;
#X text 799 412 absolute value of (A-B);
#X obj 737 478 s op;
#X msg 737 459 op rand;
#X text 800 473 number below A;
#X text 799 458 randomly produces a non-negative;
#X obj 737 524 s op;
#X msg 737 505 op sqrt;
#X text 799 504 square root of A;
#X text 800 519 rounded downwards;
#X obj 737 566 s op;
#X msg 737 547 op sq-;
#X text 800 546 (A-B) times (A-B);
#X obj 740 614 s op;
#X obj 723 595 bng 15 250 50 0 empty empty empty 0 -6 0 8 -258699 -1
-1;
#X msg 740 595 op clip+;
#X text 808 595 A+B but output is clipped;
#X obj 740 660 s op;
#X obj 723 641 bng 15 250 50 0 empty empty empty 0 -6 0 8 -258699 -1
-1;
#X msg 740 641 op clip-;
#X text 808 641 A-B but output is clipped;
#X obj 740 706 s op;
#X obj 740 750 s op;
#X text 808 687 (A+B)/2;
#X msg 740 687 op avg;
#X msg 740 731 op hypot;
#X text 808 731 square root of (A*A+B*B);
#X obj 740 792 s op;
#X obj 723 773 bng 15 250 50 0 empty empty empty 0 -6 0 8 -258699 -1
-1;
#X msg 740 773 op erf;
#X text 807 773 integral of e^(-x*x)dx;
#N canvas 8 30 615 351 all_operators 0;
#X obj 174 99 # -;
#X obj 522 97 # swap%;
#X obj 186 177 # abs-;
#X obj 238 177 # rand;
#X obj 342 177 # sq-;
#X obj 290 177 # sqrt;
#X obj 144 99 # +;
#X obj 492 97 # %;
#X obj 260 99 # *;
#X obj 289 99 # /;
#X obj 206 99 # inv+;
#X obj 321 99 # div;
#X obj 367 98 # inv*;
#X obj 420 98 # swapdiv;
#X obj 35 99 # ignore;
#X obj 100 100 # put;
#X obj 35 125 # rem;
#X obj 78 125 # swaprem;
#X obj 149 125 # gcd;
#X obj 191 125 # lcm;
#X obj 234 125 # |;
#X obj 234 125 # |;
#X obj 263 125 # ^;
#X obj 293 125 # &;
#X obj 322 125 # <<;
#X obj 358 125 # >>;
#X obj 394 125 # ||;
#X obj 431 125 # &&;
#X obj 467 125 # min;
#X obj 35 151 # max;
#X obj 79 151 # cmp;
#X obj 124 151 # ==;
#X obj 162 151 # !=;
#X obj 199 151 # >;
#X obj 234 151 # <=;
#X obj 274 151 # <;
#X obj 304 152 # >=;
#X obj 341 152 # sin*;
#X obj 391 152 # cos*;
#X obj 442 152 # atan;
#X obj 493 152 # tanh*;
#X obj 35 177 # log*;
#X obj 87 177 # gamma;
#X obj 148 177 # **;
#X obj 388 177 # avg;
#X obj 433 177 # hypot;
#X restore 15 174 pd all_operators;
#X text 585 31 select values below;
#X text 14 233 select an operator below;
#X text 478 51 A;
#X text 683 53 B;
#X obj 479 182 # +;
#X obj 257 196 #color;
#X obj 297 162 #reverse;
#X obj 443 215 display;
#X obj 656 197 #unpack 3;
#X floatatom 605 244 5 0 0 0 - - -;
#X obj 642 150 t a a;
#X obj 597 191 display;
#X connect 7 0 186 0;
#X connect 7 0 188 0;
#X connect 7 0 192 0;
#X connect 8 0 186 1;
#X connect 9 0 11 0;
#X connect 10 0 13 0;
#X connect 12 0 186 0;
#X connect 16 0 14 0;
#X connect 18 0 17 0;
#X connect 21 0 20 0;
#X connect 27 0 26 0;
#X connect 31 0 29 0;
#X connect 34 0 33 0;
#X connect 42 0 23 0;
#X connect 45 0 43 0;
#X connect 47 0 44 0;
#X connect 49 0 37 0;
#X connect 51 0 50 0;
#X connect 57 0 53 0;
#X connect 62 0 60 0;
#X connect 63 0 61 0;
#X connect 68 0 66 0;
#X connect 71 0 69 0;
#X connect 73 0 72 0;
#X connect 76 0 75 0;
#X connect 80 0 79 0;
#X connect 85 0 84 0;
#X connect 92 0 89 0;
#X connect 95 0 94 0;
#X connect 99 0 98 0;
#X connect 103 0 102 0;
#X connect 108 0 107 0;
#X connect 112 0 111 0;
#X connect 115 0 114 0;
#X connect 118 0 117 0;
#X connect 121 0 120 0;
#X connect 124 0 123 0;
#X connect 127 0 126 0;
#X connect 130 0 129 0;
#X connect 133 0 132 0;
#X connect 136 0 135 0;
#X connect 139 0 138 0;
#X connect 143 0 142 0;
#X connect 146 0 145 0;
#X connect 150 0 149 0;
#X connect 153 0 152 0;
#X connect 157 0 156 0;
#X connect 161 0 160 0;
#X connect 165 0 163 0;
#X connect 169 0 167 0;
#X connect 174 0 171 0;
#X connect 175 0 172 0;
#X connect 179 0 177 0;
#X connect 188 0 187 0;
#X connect 188 0 189 0;
#X connect 190 0 191 0;
#X connect 192 0 193 0;
#X connect 192 1 190 0;
--- NEW FILE: #cast-help.pd ---
#N canvas 435 101 684 379 10;
#X text 108 14 returns a grid of the same dimensions containing all
the same values after type conversion. note that while casting to a
smaller type \, overflowing values will be truncated.;
#X text 109 53 numbertypes are: uint8 \, int16 \, int32 \, int64 \,
float32 \, float64. see doc/architecture.html for more info.;
#X obj 115 90 nbx 8 14 -1e+37 1e+37 0 1 empty empty empty 0 -6 0 10
-262144 -1 -1 3.1416 256;
#X obj 78 136 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
-1;
#X text 14 136 print it:;
#X obj 78 210 t a a a a;
#X obj 216 90 nbx 8 14 -1e+37 1e+37 0 1 empty empty empty 0 -6 0 10
-262144 -1 -1 42 256;
#X obj 126 110 nbx 8 14 -1e+37 1e+37 0 1 empty empty empty 0 -6 0 10
-262144 -1 -1 2005 256;
#X obj 215 110 nbx 8 14 -1e+37 1e+37 0 1 empty empty empty 0 -6 0 10
-262144 -1 -1 1e+10 256;
#X obj 115 136 #pack 4 float32;
#X obj 115 158 #redim ( 2 2 );
#X obj 78 185 #store;
#X obj 136 234 #print;
#X obj 116 254 #cast uint8;
#X obj 116 274 #print;
#X obj 97 294 #cast int32;
#X obj 97 314 #print;
#X obj 78 334 #cast float64;
#X obj 78 354 #print;
#X text 14 14 [#cast];
#X text 575 10 GridFlow 0.8.0;
#X connect 2 0 9 0;
#X connect 3 0 11 0;
#X connect 5 0 17 0;
#X connect 5 1 15 0;
#X connect 5 2 13 0;
#X connect 5 3 12 0;
#X connect 6 0 9 1;
#X connect 7 0 9 2;
#X connect 8 0 9 3;
#X connect 9 0 10 0;
#X connect 10 0 11 1;
#X connect 11 0 5 0;
#X connect 13 0 14 0;
#X connect 15 0 16 0;
#X connect 17 0 18 0;
--- NEW FILE: #in-help.pd ---
#N canvas 373 24 613 584 10;
#X obj 123 779 #out window;
#X obj 123 711 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
-1;
#X obj 5 -9 cnv 15 90 1100 empty empty empty 20 12 0 14 -233017 -66577
0;
#X obj 57 -1 #in;
#X text 35 37 INLETS:;
#X text 42 68 -LEFT:;
#X text 102 -1 -IMPORTS GRIDS (IMAGES OR MOVIES);
#X text 110 268 Message "close" closes the video input device. Only
necessary if you are using a live capture device.;
#X text 109 68 Bang sends a grid (static image or one frame of video)
to [#out]. Successive bangs advance through the grid (frames of video).
;
#X text 110 119 Message "open" follwed by the filename \, ex: "open
someimage.jpg" gives a grid (most often an image) to an [#out].;
#X text 108 226 Interger will display the frame number of the frame
just sent. Applies to formats that have frame numbers.;
#X text 109 173 Message "set" \, followed by a number \, will select
the video frame corresponding to the number. A bang must be sent in
order to display the frame.;
#X text 8 444 ARGUMENTS:;
#X text 107 444 filename \, [#in someimage.jpg] eliminates the need
for message "open someimage.jpg" but limits that image.;
#X text 23 500 OUTLETS:;
#X text 37 531 -LEFT:;
#X text 110 530 Displays the resulting grid when connected to [#out]
;
#X text 29 574 -RIGHT:;
#X text 109 574 Integer \, a numbner box will identify the frame number
corresponding to the frame currently displayed.Applies only to formats
that have frame numbers.;
#X text 16 676 EXAMPLES:;
#X text 112 313 Message "rewind" will rewind a video file to its beginning.
;
#X text 111 341 Message "loop 1" restarts a video each time it reaches
the end. The loop option is on by default.;
#X text 110 381 Message "loop 0" turns off the loop option. The video
stops once it reaches the end.;
#X text 110 624 Bang signals when a frame could not be read and signals
the end of a file.;
#X obj 123 755 #in;
#X floatatom 402 752 5 0 0 0 - - -;
#X msg 343 752 set 2;
#X msg 131 733 open b001.jpg;
#X text 137 685 for images:;
#X obj 320 880 #out window;
#X obj 320 711 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
-1;
#X obj 320 833 #in;
#X msg 326 730 open movie.mpeg;
#X msg 404 802 loop 0;
#X msg 466 804 loop 1;
#X floatatom 336 859 5 0 0 0 - - -;
#X msg 404 777 rewind;
#X text 323 686 for video files:;
#X obj 382 850 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
-1;
#X text 16 949 SEE ALSO:;
#X text 367 1067 updated for GridFlow version 0.8.0;
#N canvas 135 17 680 586 More_Info 0;
#X msg 52 283 option timelog \$1;
#X obj 52 263 tgl 15 0 empty empty empty 0 -6 0 8 -233017 -1 -1 0 1
;
#X text 274 307 upload a grid;
#X text 261 80 upload a grid;
#X text 194 108 open default display for screenshot;
#X msg 73 134 open videodev /dev/video0;
#X text 260 136 open a video device;
#X msg 75 332 open x11 here;
#X msg 87 356 open x11 local 10;
#X text 182 285 show/hide timing statistics;
#X text 178 334 connect to default display;
#X text 218 358 connect to display #10 on this machine;
#X msg 100 380 open x11 remote.host.bla.net 0;
#X text 324 382 connect to remote machine on display #0;
#X text 290 161 open mpeg video stream;
#X text 272 155 *;
#X text 36 558 * path is where you started pd from. usually $home.
;
#X text 308 188 open an image file;
#X msg 114 450 close;
#X msg 90 161 open lsd.mpeg;
#X msg 55 107 open x11 here;
#X msg 35 80 open host.bla.net 7777;
#X msg 113 404 open img/bla.jpg;
#X text 300 405 open single file in jpg format;
#X msg 108 186 open ./img/bla.jpg;
#X text 35 481 incoming file is sent through the opened device/socket/file.
in single file formats subsequent pictures overwrite the preceeding
one. there are many more options. for more information see the reference
manual in the "formats" and "objects for input/output" sections.;
#X msg 65 307 open x.test.at 7777;
#X msg 125 426 open window;
#X text 228 426 opens a window x11 \, quartz or sdl;
#X text 577 15 comment;
#X obj 35 213 #in;
#X obj 35 441 #out;
#X text 14 15 #in \, #out communicating grids (pictures) to/from devices
\, sockets \, files;
#X connect 0 0 31 0;
#X connect 1 0 0 0;
#X connect 5 0 30 0;
#X connect 7 0 31 0;
#X connect 8 0 31 0;
#X connect 12 0 31 0;
#X connect 18 0 31 0;
#X connect 19 0 30 0;
#X connect 20 0 30 0;
#X connect 21 0 30 0;
#X connect 22 0 31 0;
#X connect 24 0 30 0;
#X connect 26 0 31 0;
#X connect 27 0 31 0;
#X connect 30 0 31 0;
#X restore 105 951 pd More_Info;
#X obj 105 990 #import ( 1 );
#X obj 202 990 #export;
#X obj 257 990 #export_list;
#X obj 347 990 #export_symbol;
#X obj 453 989 #pack;
#X connect 1 0 24 0;
#X connect 24 0 0 0;
#X connect 25 0 31 0;
#X connect 26 0 31 0;
#X connect 27 0 24 0;
#X connect 30 0 31 0;
#X connect 31 0 29 0;
#X connect 31 1 35 0;
#X connect 31 1 38 0;
#X connect 32 0 31 0;
#X connect 33 0 31 0;
#X connect 34 0 31 0;
#X connect 36 0 31 0;
--- NEW FILE: #unpack-#pack-help.pd ---
#N canvas 245 108 834 542 10;
#X text 485 23 GridFlow 0.8.0;
#X obj 523 257 #unpack 3;
#X floatatom 513 305 5 0 0 0 - - -;
#X obj 416 190 t a a;
#X obj 333 301 display;
#X floatatom 552 305 5 0 0 0 - - -;
#X floatatom 591 305 5 0 0 0 - - -;
#X text -48 51 [#unpack];
#X obj 530 352 #pack 3;
#X text -49 122 It takes an integer as an argument to specify the number
of Dimensions the incoming grid has.;
#X obj 416 76 #color;
#X obj 516 411 #color;
#X text -48 84 Accepts grids in its inlet and produces integers via
its outlet.;
#X text -39 349 [#pack];
#X text -39 382 Accepts integers in its inlets and produces a corresponding
grid via its outlet.;
#X text -40 421 It takes an integer as an argument to specify the number
of incoming integers and the corresponding number of Dimensions the
outgoing grid will have.;
#X obj 483 332 - 127;
#X obj -31 190 trigger bang bang;
#X obj 166 178 metro 100;
#X obj 89 345 display;
#X obj 174 272 print blah;
#X obj 145 316 print blah2;
#X obj 122 155 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0
1;
#X connect 1 0 2 0;
#X connect 1 1 5 0;
#X connect 1 2 6 0;
#X connect 2 0 16 0;
#X connect 3 0 4 0;
#X connect 3 1 1 0;
#X connect 5 0 8 1;
#X connect 6 0 8 2;
#X connect 8 0 11 0;
#X connect 10 0 3 0;
#X connect 16 0 8 0;
#X connect 18 0 19 0;
#X connect 18 0 20 0;
#X connect 18 0 21 0;
#X connect 22 0 18 0;
--- NEW FILE: #rgb_to_yuv_and_#yuv_to_rgb-help.pd ---
#N canvas 98 384 737 338 10;
#X obj 267 25 cnv 15 460 15 empty empty empty 20 12 0 14 -200249 -66577
0;
#X obj 279 77 cnv 15 450 15 empty empty empty 20 12 0 14 -233017 -66577
0;
#X obj 8 306 cnv 15 720 30 empty empty empty 20 12 0 14 -200249 -66577
0;
#X obj 8 5 cnv 15 720 15 empty empty empty 20 12 0 14 -233017 -66577
0;
#X obj 266 192 cnv 15 460 15 empty empty empty 20 12 0 14 -200249 -66577
0;
#X text 269 191 Outlets:;
#X obj 8 25 cnv 15 250 15 empty empty empty 20 12 0 14 -200249 -66577
0;
#X text 11 25 Usage:;
#X obj 8 45 cnv 15 250 30 empty empty empty 20 12 0 14 -233017 -66577
0;
#X obj 8 81 cnv 15 250 220 empty empty empty 20 12 0 14 -233017 -66577
0;
#X text 270 25 Inlets: (Read left to right \, inlet "0" being the leftmost)
;
#X text 282 77 0: (Leftmost);
#X text 12 5 SUMMARY:;
#X obj 42 51 #rgb_to_yuv;
#X obj 15 117 #for (0 0) (256 256) (1 1);
#X obj 15 90 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
-1;
#X obj 15 220 #clip;
#X obj 15 143 #inner (2 3 # 0 1 0 0 0 1);
#X obj 15 194 #yuv_to_rgb;
#X obj 15 168 # + (200 0 0);
#X obj 16 261 #peephole;
#X text 289 99 Grid - Receives a grid in RGB or YUV format.;
#X text 16 313 GridFlow 0.8.0;
#X obj 135 51 #yuv_to_rgb;
#X text 72 5 converts RGB colourspace to YUV colourspace or YUV to
RGB.;
#X text 291 224 One - outputs the converted grid.;
#X connect 14 0 17 0;
#X connect 15 0 14 0;
#X connect 16 0 20 0;
#X connect 17 0 19 0;
#X connect 18 0 16 0;
#X connect 19 0 18 0;
--- NEW FILE: #numop-help.pd ---
#N canvas 106 82 735 448 10;
#X obj 278 136 cnv 15 450 15 empty empty empty 20 12 0 14 -233017 -66577
0;
#X obj 8 410 cnv 15 720 30 empty empty empty 20 12 0 14 -200249 -66577
0;
#X obj 8 8 cnv 15 720 30 empty empty empty 20 12 0 14 -233017 -66577
0;
#X obj 278 222 cnv 15 450 15 empty empty empty 20 12 0 14 -233017 -66577
0;
#X obj 267 46 cnv 15 460 15 empty empty empty 20 12 0 14 -200249 -66577
0;
#X text 270 45 Arguments:;
#X obj 268 292 cnv 15 460 15 empty empty empty 20 12 0 14 -200249 -66577
0;
#X text 271 292 Outlets:;
#X obj 8 46 cnv 15 250 15 empty empty empty 20 12 0 14 -200249 -66577
0;
#X text 11 46 Usage:;
#X obj 8 67 cnv 15 250 30 empty empty empty 20 12 0 14 -233017 -66577
0;
#X obj 8 104 cnv 15 250 300 empty empty empty 20 12 0 14 -233017 -66577
0;
#X obj 266 355 cnv 15 460 15 empty empty empty 20 12 0 14 -200249 -66577
0;
#X text 269 355 More Info:;
#X text 281 136 0: (Leftmost);
#X text 281 222 1: (Rightmost);
#X text 12 8 SUMMARY:;
#X text 73 8 Transforms a grid by applying mathematical operations
in order to generate effects on a pixel by pixel basis.;
#X obj 109 76 # +;
#X floatatom 31 234 5 0 0 0 - - -;
#X obj 42 288 display;
#X obj 15 149 #color;
#X msg 15 116 255 0 0;
#X obj 15 331 #color;
#X text 281 74 One - see: inlet 1: (Rightmost);
#X obj 267 101 cnv 15 460 15 empty empty empty 20 12 0 14 -200249 -66577
0;
#X text 270 101 Inlets: (Read left to right \, inlet "0" being the
leftmost);
#X text 283 313 One - outputs the transformed grid.;
#X text 16 417 GridFlow 0.8.0;
#X obj 15 258 # +;
#X text 292 242 Integer - Accepts integers that modify the incoming
grid.;
#N canvas 15 0 912 644 numop 0;
#X text 76 366 A + B;
#X text 77 510 A * B;
#X text 73 571 rounded towards zero;
#X text 14 73 angles are in hundredth of degrees \, so a full circle
(two pi radians) is 36000 you can convert from radians to our angles
by multiplying by 18000/pi.;
#X text 13 44 for all of these \, A refers to the left inlet and B
to the value on the right.;
#X text 15 27 Consult doc/architecture.html to see all the 40 of them.
;
#X text 902 31 GridFlow 0.8.0;
#X obj 479 70 #color;
#X obj 684 72 #color;
#X msg 15 366 op +;
#X msg 15 507 op *;
#X obj 15 385 s op;
#X obj 423 155 r op;
#X obj 15 526 s op;
#X obj 15 436 s op;
#X text 77 421 A - B;
#X msg 15 417 op -;
#X obj 15 761 s op;
#X msg 15 742 op %;
#X text 69 743 A % B;
#X obj 15 575 s op;
#X msg 15 556 op /;
#X text 79 557 A / B;
#X obj 14 809 s op;
#X text 83 790 B % A;
#X text 15 14 Numeric Operators: *whoa \, there's a lot of them;
#X obj 16 482 s op;
#X msg 16 463 op inv+;
#X text 79 464 B -A;
#X obj 15 623 s op;
#X text 79 605 A / B;
#X msg 15 604 op div;
#X text 75 621 rounded downwards;
#X obj 15 668 s op;
#X msg 15 649 op inv*;
#X text 80 650 B / A;
#X text 77 665 rounded towards 0;
#X obj 15 712 s op;
#X text 76 714 rounded downwards;
#X text 101 695 B / A;
#X text 68 760 modulo (goes with div);
#X text 65 809 modulo (goes with div);
#X msg 14 790 op swap%;
#X obj 15 286 s op;
#X obj 15 334 s op;
#X msg 15 267 op ignore;
#X text 90 268 A;
#X msg 15 315 op put;
#X text 76 315 B;
#X msg 15 693 op swapdiv;
#X obj 237 286 s op;
#X msg 237 267 op rem;
#X text 315 263 A % B;
#X obj 236 338 s op;
#X text 330 319 B % A;
#X text 314 278 remainder;
#X text 314 293 (goes with /);
#X msg 236 319 op swaprem;
#X text 327 333 remainder;
#X text 326 348 (goes with /);
#X obj 236 388 s op;
#X obj 236 435 s op;
#X msg 236 369 op gcd;
#X msg 236 416 op lcm;
#X text 298 373 greatest common divisor;
#X text 298 420 least common multiple;
#X obj 235 481 s op;
#X text 299 464 A or B \, bitwise;
#X msg 235 462 op;
#X obj 235 525 s op;
#X text 299 508 A xor B \, bitwise;
#X msg 235 506 op ^;
#X obj 235 578 s op;
#X msg 235 559 op &;
#X text 300 561 A and B \, bitwise;
#X obj 235 623 s op;
#X msg 235 604 op <<;
#X text 300 606 A * (2**(B % 32);
#X text 299 621 left-shifthing;
#X obj 235 669 s op;
#X msg 235 649 op >>;
#X text 299 666 right-shifthing;
#X text 300 652 A / (2**(B % 32);
#X obj 218 463 bng 15 250 50 0 empty empty empty 0 -6 0 8 -258699 -1
-1;
#X obj 235 714 s op;
#X msg 235 695 op;
#X obj 218 695 bng 15 250 50 0 empty empty empty 0 -6 0 8 -258699 -1
-1;
#X text 299 697 if A is zero then;
#X text 300 711 B else A;
#X obj 235 758 s op;
#X text 299 741 if A is zero then;
#X text 15 110 comment;
#X msg 235 739 op &&;
#X text 300 755 zero else B;
#X obj 236 807 s op;
#X msg 236 788 op min;
#X text 300 789 the lowest value;
#X text 301 804 in A \, B;
#X obj 500 287 s op;
#X msg 500 267 op max;
#X text 556 284 in A \, B;
#X text 557 268 the highest value;
#X obj 500 333 s op;
#X msg 500 313 op cmp;
#X text 551 310 -1 when A<B;
#X text 558 338 1 when A>B;
#X text 558 324 0 when A=B;
#X obj 500 386 s op;
#X msg 500 366 op ==;
#X text 557 367 is A equal to B ?;
#X text 556 385 1 = true \, 0 = false;
#X obj 500 433 s op;
#X msg 500 413 op !=;
#X text 557 414 is A not equal to B ?;
#X obj 500 477 s op;
#X msg 500 456 op >;
#X text 557 457 is A greater than B ?;
#X obj 500 523 s op;
#X msg 500 502 op <=;
#X text 557 503 is A not greater than B ?;
#X obj 500 572 s op;
#X msg 500 551 op <;
#X text 557 552 is A less than B ?;
#X obj 500 618 s op;
#X msg 500 597 op >=;
#X text 557 598 is A not less than B ?;
#X obj 500 666 s op;
#X msg 500 645 op sin*;
#X text 559 646 B * sin(A);
#X obj 500 713 s op;
#X msg 500 691 op cos*;
#X text 560 693 B * cos(A);
#X obj 500 758 s op;
#X msg 500 736 op atan;
#X text 560 737 arctan(A/B);
#X obj 499 805 s op;
#X msg 499 783 op tan*;
#X text 559 784 tanh(A);
#X obj 738 288 s op;
#X msg 738 268 op log*;
#X text 795 269 B*log(A);
#X text 794 286 in base e;
#X obj 738 334 s op;
#X msg 738 314 op gamma;
#X text 809 314 floor(pow(a/256.0 \, 256.0/b)*256.0);
#X obj 737 385 s op;
#X msg 737 366 op **;
#X text 799 368 A**B;
#X text 799 385 A raised to power B;
#X obj 737 431 s op;
#X msg 737 412 op abs-;
#X text 799 412 absolute value of (A-B);
#X obj 737 478 s op;
#X msg 737 459 op rand;
#X text 800 473 number below A;
#X text 799 458 randomly produces a non-negative;
#X obj 737 524 s op;
#X msg 737 505 op sqrt;
#X text 799 504 square root of A;
#X text 800 519 rounded downwards;
#X obj 737 566 s op;
#X msg 737 547 op sq-;
#X text 800 546 (A-B) times (A-B);
#X obj 740 614 s op;
#X obj 723 595 bng 15 250 50 0 empty empty empty 0 -6 0 8 -258699 -1
-1;
#X msg 740 595 op clip+;
#X text 808 595 A+B but output is clipped;
#X obj 740 660 s op;
#X obj 723 641 bng 15 250 50 0 empty empty empty 0 -6 0 8 -258699 -1
-1;
#X msg 740 641 op clip-;
#X text 808 641 A-B but output is clipped;
#X obj 740 706 s op;
#X obj 740 750 s op;
#X text 808 687 (A+B)/2;
#X msg 740 687 op avg;
#X msg 740 731 op hypot;
#X text 808 731 square root of (A*A+B*B);
#X obj 740 792 s op;
#X obj 723 773 bng 15 250 50 0 empty empty empty 0 -6 0 8 -258699 -1
-1;
#X msg 740 773 op erf;
#X text 807 773 integral of e^(-x*x)dx;
#N canvas 8 30 615 351 all_operators 0;
#X obj 174 99 # -;
#X obj 522 97 # swap%;
#X obj 186 177 # abs-;
#X obj 238 177 # rand;
#X obj 342 177 # sq-;
#X obj 290 177 # sqrt;
#X obj 144 99 # +;
#X obj 492 97 # %;
#X obj 260 99 # *;
#X obj 289 99 # /;
#X obj 206 99 # inv+;
#X obj 321 99 # div;
#X obj 367 98 # inv*;
#X obj 420 98 # swapdiv;
#X obj 35 99 # ignore;
#X obj 100 100 # put;
#X obj 35 125 # rem;
#X obj 78 125 # swaprem;
#X obj 149 125 # gcd;
#X obj 191 125 # lcm;
#X obj 234 125 # |;
#X obj 234 125 # |;
#X obj 263 125 # ^;
#X obj 293 125 # &;
#X obj 322 125 # <<;
#X obj 358 125 # >>;
#X obj 394 125 # ||;
#X obj 431 125 # &&;
#X obj 467 125 # min;
#X obj 35 151 # max;
#X obj 79 151 # cmp;
#X obj 124 151 # ==;
#X obj 162 151 # !=;
#X obj 199 151 # >;
#X obj 234 151 # <=;
#X obj 274 151 # <;
#X obj 304 152 # >=;
#X obj 341 152 # sin*;
#X obj 391 152 # cos*;
#X obj 442 152 # atan;
#X obj 493 152 # tanh*;
#X obj 35 177 # log*;
#X obj 87 177 # gamma;
#X obj 148 177 # **;
#X obj 388 177 # avg;
#X obj 433 177 # hypot;
#X restore 15 174 pd all_operators;
#X text 585 31 select values below;
#X text 14 233 select an operator below;
#X text 478 51 A;
#X text 683 53 B;
#X obj 479 182 # +;
#X obj 257 196 #color;
#X obj 297 162 #reverse;
#X obj 443 215 display;
#X obj 656 197 #unpack 3;
#X floatatom 605 244 5 0 0 0 - - -;
#X obj 642 150 t a a;
#X obj 597 191 display;
#X connect 7 0 186 0;
#X connect 7 0 188 0;
#X connect 7 0 192 0;
#X connect 8 0 186 1;
#X connect 9 0 11 0;
#X connect 10 0 13 0;
#X connect 12 0 186 0;
#X connect 16 0 14 0;
#X connect 18 0 17 0;
#X connect 21 0 20 0;
#X connect 27 0 26 0;
#X connect 31 0 29 0;
#X connect 34 0 33 0;
#X connect 42 0 23 0;
#X connect 45 0 43 0;
#X connect 47 0 44 0;
#X connect 49 0 37 0;
#X connect 51 0 50 0;
#X connect 57 0 53 0;
#X connect 62 0 60 0;
#X connect 63 0 61 0;
#X connect 68 0 66 0;
#X connect 71 0 69 0;
#X connect 73 0 72 0;
#X connect 76 0 75 0;
#X connect 80 0 79 0;
#X connect 85 0 84 0;
#X connect 92 0 89 0;
#X connect 95 0 94 0;
#X connect 99 0 98 0;
#X connect 103 0 102 0;
#X connect 108 0 107 0;
#X connect 112 0 111 0;
#X connect 115 0 114 0;
#X connect 118 0 117 0;
#X connect 121 0 120 0;
#X connect 124 0 123 0;
#X connect 127 0 126 0;
#X connect 130 0 129 0;
#X connect 133 0 132 0;
#X connect 136 0 135 0;
#X connect 139 0 138 0;
#X connect 143 0 142 0;
#X connect 146 0 145 0;
#X connect 150 0 149 0;
#X connect 153 0 152 0;
#X connect 157 0 156 0;
#X connect 161 0 160 0;
#X connect 165 0 163 0;
#X connect 169 0 167 0;
#X connect 174 0 171 0;
#X connect 175 0 172 0;
#X connect 179 0 177 0;
#X connect 188 0 187 0;
#X connect 188 0 189 0;
#X connect 190 0 191 0;
#X connect 192 0 193 0;
#X connect 192 1 190 0;
#X restore 265 380 pd numop;
#X text 290 157 Grid - Accepts a grid to be modified by an operator
consistent with the right inlet value (list of operators in [pd numop]).
In this example [# +] is used.;
#X text 72 234 <-- change this value to modify the operation.;
#X text 193 154 <--modify color with sliders.;
#X connect 19 0 29 1;
#X connect 21 0 29 0;
#X connect 22 0 21 0;
#X connect 29 0 20 0;
#X connect 29 0 23 0;
--- NEW FILE: #pack-help.pd ---
#N canvas 29 63 693 623 10;
#X obj 8 3 cnv 15 90 578 empty empty empty 20 12 0 14 -233017 -66577
0;
#X text 45 273 INLETS:;
#X text 42 304 - LEFT:;
#X text 33 410 OUTLETS:;
#X text 28 53 EXAMPLES:;
#X text 24 506 SEE ALSO:;
#N canvas 247 137 487 505 More_Info 0;
#X text 485 23 GridFlow 0.8.0;
#X obj 523 257 #unpack 3;
#X floatatom 513 305 5 0 0 0 - - -;
#X obj 416 190 t a a;
#X obj 333 301 display;
#X floatatom 552 305 5 0 0 0 - - -;
#X floatatom 591 305 5 0 0 0 - - -;
#X text -48 51 [#unpack];
#X obj 530 352 #pack 3;
#X text -49 122 It takes an integer as an argument to specify the number
of Dimensions the incoming grid has.;
#X obj 416 76 #color;
#X obj 516 411 #color;
#X text -48 84 Accepts grids in its inlet and produces integers via
its outlet.;
#X text -39 349 [#pack];
#X text -39 382 Accepts integers in its inlets and produces a corresponding
grid via its outlet.;
#X text -40 421 It takes an integer as an argument to specify the number
of incoming integers and the corresponding number of Dimensions the
outgoing grid will have.;
#X obj 483 332 - 127;
#X obj -31 190 trigger bang bang;
#X obj 166 178 metro 100;
#X obj 89 345 display;
#X obj 174 272 print blah;
#X obj 145 316 print blah2;
#X obj 122 155 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0
1;
#X connect 1 0 2 0;
#X connect 1 1 5 0;
#X connect 1 2 6 0;
#X connect 2 0 16 0;
#X connect 3 0 4 0;
#X connect 3 1 1 0;
#X connect 5 0 8 1;
#X connect 6 0 8 2;
#X connect 8 0 11 0;
#X connect 10 0 3 0;
#X connect 16 0 8 0;
#X connect 18 0 19 0;
#X connect 18 0 20 0;
#X connect 18 0 21 0;
#X connect 22 0 18 0;
#X restore 119 550 pd More_Info;
#X text 36 435 - LEFT:;
#X text 412 575 updated for GridFlow version 0.8.0;
#X obj 47 13 #pack;
#X text 183 183 comment;
#X obj 120 173 #color;
#X floatatom 120 65 5 0 0 0 - - -;
#X floatatom 142 93 5 0 0 0 - - -;
#X floatatom 164 121 5 0 0 0 - - -;
#X obj 120 147 #pack 3;
#X text 25 346 ARGUMENT:;
#X text 120 304 Grid - combination of inputs.;
#X text 104 436 Grid - combination of inputs given by inlets.;
#X text 114 344 Interger - defines the number of inlets and the amount
of outcoming grid dimensions.;
#X obj 121 511 #unpack 3;
#X text 114 13 Creates a vector (a list of numbers) from individual
integers.;
#X connect 12 0 15 0;
#X connect 13 0 15 1;
#X connect 14 0 15 2;
#X connect 15 0 11 0;
1
0
[PD-cvs] externals/gridflow/devices4ruby ChangeLog, NONE, 1.1 README, NONE, 1.1
by Mathieu Bouchard 04 Oct '05
by Mathieu Bouchard 04 Oct '05
04 Oct '05
Update of /cvsroot/pure-data/externals/gridflow/devices4ruby
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv23360/devices4ruby
Added Files:
ChangeLog README
Log Message:
added the remainder of the files (or almost) from GF 0.8.0
--- NEW FILE: README ---
devices/linux
AUTHOR
Mathieu Bouchard <matju(a)sympatico.ca>
irc: irc.openprojects.net / #ruby-lang / matju
(note: I can't read Japanese; write in French or English please)
OVERVIEW
This is a collection of simple modules that you extend IO objects with, to
give them support for specific devices. For example:
require "linux/SoundMixer"
f = File.open "/dev/mixer"
f.extend Linux::SoundMixer
# f now has special accessors for driver variables, e.g:
f.treble = left_speaker_percent + 256 * right_speaker_percent
The modules are made of automatically generated methods, much like Ruby's
accessors. those generators are called ioctl_reader, ioctl_writer,
ioctl_accessor. Writing expects an integer in -2**31...2**31; reading will
return the same. You may browse the source to find out which accessors are
available, and it's easy to add support for more features.
--- NEW FILE: ChangeLog ---
/* $Id: ChangeLog,v 1.1 2005/10/04 02:12:44 matju Exp $ */
version 0.1.1 (2002.07.29):
* module Linux::SoundDSP renamed to Linux::SoundPCM (with alias)
* added installer (ruby extconf.rb && make install)
version 0.1 (2001.06.28):
* added module IoctlClass, Ioctl
* added module Linux::SoundDSP (4 accessors)
* added module Linux::SoundMixer (25 accessors)
* added module Linux::ParallelPort (2 readers, 2 writers)
1
0
04 Oct '05
Update of /cvsroot/pure-data/externals/gridflow/doc
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv23360/doc
Added Files:
Makefile gridflow.css
Log Message:
added the remainder of the files (or almost) from GF 0.8.0
--- NEW FILE: Makefile ---
all::
ruby moulinette.rb
--- NEW FILE: gridflow.css ---
P {color:#000000; font-family: Arial, Helvetica, sans-serif; font-size:12px;}
B {color:#336699;}
A {color:#003366; font-family: Arial, Helvetica, sans-serif;}
A:link {color:#003366;}
A:active {color:#336699;}
A:visited {color:#336699;}
BODY {background-color:#FFFFFF;}
H1 {color:#336699; font-family: Arial, Helvetica, sans-serif;}
H2 {color:#336699; font-family: Arial, Helvetica, sans-serif;}
H3 {color:#336699; font-family: Arial, Helvetica, sans-serif;}
H4 {color:#004060; font-family: Arial, Helvetica, sans-serif;; font-size: 16px}
H5 {color:#004060; font-family: Arial, Helvetica, sans-serif;; font-size: 16px}
LI {font-family: Arial, Helvetica, sans-serif;}
.text {font-family: Arial, Helvetica, sans-serif; font-size:10px;; background-color: #FFFFFF}h5 { color:#336699; font-family: Arial, Helvetica, sans-serif; ; font-size: 14px}
dt { font-weight: bold; color: #006699}
1
0
Update of /cvsroot/pure-data/externals/gridflow/bundled/pd
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv23360/bundled/pd
Added Files:
g_canvas.h
Log Message:
added the remainder of the files (or almost) from GF 0.8.0
--- NEW FILE: g_canvas.h ---
/* Copyright (c) 1997-1999 Miller Puckette.
* For information on usage and redistribution, and for a DISCLAIMER OF ALL
* WARRANTIES, see the file, "LICENSE.txt," in this distribution. */
/* this file defines the structure for "glists" and related structures and
functions. "Glists" and "canvases" and "graphs" used to be different
structures until being unified in version 0.35.
A glist occupies its own window if the "gl_havewindow" flag is set. Its
appearance on its "parent" or "owner" (if it has one) is as a graph if
"gl_isgraph" is set, and otherwise as a text box.
A glist is "root" if it has no owner, i.e., a document window. In this
case "gl_havewindow" is always set.
We maintain a list of root windows, so that we can traverse the whole
collection of everything in a Pd process.
If a glist has a window it may still not be "mapped." Miniaturized
windows aren't mapped, for example, but a window is also not mapped
immediately upon creation. In either case gl_havewindow is true but
gl_mapped is false.
Closing a non-root window makes it invisible; closing a root destroys it.
A glist that's just a text object on its parent is always "toplevel." An
embedded glist can switch back and forth to appear as a toplevel by double-
clicking on it. Single-clicking a text box makes the toplevel become visible
and raises the window it's in.
If a glist shows up as a graph on its parent, the graph is blanked while the
glist has its own window, even if miniaturized.
*/
/* NOTE: this file describes Pd implementation details which may change
in future releases. The public (stable) API is in m_pd.h. */
#if defined(_LANGUAGE_C_PLUS_PLUS) || defined(__cplusplus)
extern "C" {
#endif
/* --------------------- geometry ---------------------------- */
#define IOWIDTH 7 /* width of an inlet/outlet in pixels */
#define IOMIDDLE ((IOWIDTH-1)/2)
#define GLIST_DEFGRAPHWIDTH 200
#define GLIST_DEFGRAPHHEIGHT 140
/* ----------------------- data ------------------------------- */
typedef struct _updateheader
{
struct _updateheader *upd_next;
unsigned int upd_array:1; /* true if array, false if glist */
unsigned int upd_queued:1; /* true if we're queued */
} t_updateheader;
/* types to support glists grabbing mouse motion or keys from parent */
typedef void (*t_glistmotionfn)(void *z, t_floatarg dx, t_floatarg dy);
typedef void (*t_glistkeyfn)(void *z, t_floatarg key);
EXTERN_STRUCT _rtext;
#define t_rtext struct _rtext
EXTERN_STRUCT _gtemplate;
#define t_gtemplate struct _gtemplate
EXTERN_STRUCT _guiconnect;
#define t_guiconnect struct _guiconnect
EXTERN_STRUCT _tscalar;
#define t_tscalar struct _tscalar
EXTERN_STRUCT _canvasenvironment;
#define t_canvasenvironment struct _canvasenvironment
typedef struct _selection
{
t_gobj *sel_what;
struct _selection *sel_next;
} t_selection;
/* this structure is instantiated whenever a glist becomes visible. */
typedef struct _editor
{
t_updateheader e_upd; /* update header structure */
t_selection *e_updlist; /* list of objects to update */
t_rtext *e_rtext; /* text responder linked list */
t_selection *e_selection; /* head of the selection list */
t_rtext *e_textedfor; /* the rtext if any that we are editing */
t_gobj *e_grab; /* object being "dragged" */
t_glistmotionfn e_motionfn; /* ... motion callback */
t_glistkeyfn e_keyfn; /* ... keypress callback */
t_binbuf *e_connectbuf; /* connections to deleted objects */
t_binbuf *e_deleted; /* last stuff we deleted */
t_guiconnect *e_guiconnect; /* GUI connection for filtering messages */
struct _glist *e_glist; /* glist which owns this */
int e_xwas; /* xpos on last mousedown or motion event */
int e_ywas; /* ypos, similarly */
int e_selectline_index1; /* indices for the selected line if any */
int e_selectline_outno; /* (only valid if e_selectedline is set) */
int e_selectline_index2;
int e_selectline_inno;
t_outconnect *e_selectline_tag;
unsigned int e_onmotion: 3; /* action to take on motion */
unsigned int e_lastmoved: 1; /* one if mouse has moved since click */
unsigned int e_textdirty: 1; /* one if e_textedfor has changed */
unsigned int e_selectedline: 1; /* one if a line is selected */
} t_editor;
#define MA_NONE 0 /* e_onmotion: do nothing on mouse motion */
#define MA_MOVE 1 /* drag the selection around */
#define MA_CONNECT 2 /* make a connection */
#define MA_REGION 3 /* selection region */
#define MA_PASSOUT 4 /* send on to e_grab */
#define MA_DRAGTEXT 5 /* drag in text editor to alter selection */
/* editor structure for "garrays". We don't bother to delete and regenerate
this structure when the "garray" becomes invisible or visible, although we
could do so if the structure gets big (like the "editor" above.) */
typedef struct _arrayvis
{
t_updateheader av_upd; /* update header structure */
t_garray *av_garray; /* owning structure */
} t_arrayvis;
/* the t_tick structure describes where to draw x and y "ticks" for a glist */
typedef struct _tick /* where to put ticks on x or y axes */
{
float k_point; /* one point to draw a big tick at */
float k_inc; /* x or y increment per little tick */
int k_lperb; /* little ticks per big; 0 if no ticks to draw */
} t_tick;
/* the t_glist structure, which describes a list of elements that live on an
area of a window.
*/
struct _glist
{
t_object gl_obj; /* header in case we're a glist */
t_gobj *gl_list; /* the actual data */
struct _gstub *gl_stub; /* safe pointer handler */
int gl_valid; /* incremented when pointers might be stale */
struct _glist *gl_owner; /* parent glist, supercanvas, or 0 if none */
int gl_pixwidth; /* width in pixels (on parent, if a graph) */
int gl_pixheight;
float gl_x1; /* bounding rectangle in our own coordinates */
float gl_y1;
float gl_x2;
float gl_y2;
int gl_screenx1; /* screen coordinates when toplevel */
int gl_screeny1;
int gl_screenx2;
int gl_screeny2;
t_tick gl_xtick; /* ticks marking X values */
int gl_nxlabels; /* number of X coordinate labels */
t_symbol **gl_xlabel; /* ... an array to hold them */
float gl_xlabely; /* ... and their Y coordinates */
t_tick gl_ytick; /* same as above for Y ticks and labels */
int gl_nylabels;
t_symbol **gl_ylabel;
float gl_ylabelx;
t_editor *gl_editor; /* editor structure when visible */
t_symbol *gl_name; /* symbol bound here */
int gl_font; /* nominal font size in points, e.g., 10 */
struct _glist *gl_next; /* link in list of toplevels */
t_canvasenvironment *gl_env; /* root canvases and abstractions only */
unsigned int gl_havewindow:1; /* true if we own a window */
unsigned int gl_mapped:1; /* true if, moreover, it's "mapped" */
unsigned int gl_dirty:1; /* (root canvas only:) patch has changed */
unsigned int gl_loading:1; /* am now loading from file */
unsigned int gl_willvis:1; /* make me visible after loading */
unsigned int gl_edit:1; /* edit mode */
unsigned int gl_isdeleting:1; /* we're inside glist_delete -- hack! */
unsigned int gl_stretch:1; /* stretch contents on resize */
unsigned int gl_isgraph:1; /* show as graph on parent */
};
#define gl_gobj gl_obj.te_g
#define gl_pd gl_gobj.g_pd
/* a data structure to describe a field in a pure datum */
#define DT_FLOAT 0
#define DT_SYMBOL 1
#define DT_LIST 2
#define DT_ARRAY 3
typedef struct _dataslot
{
int ds_type;
t_symbol *ds_name;
t_symbol *ds_arraytemplate; /* filled in for arrays only */
} t_dataslot;
/* T.Grill - changed t_pd member to t_pdobj to avoid name clashed */
typedef struct _template
{
t_pd t_pdobj; /* header */
struct _gtemplate *t_list; /* list of "struct"/gtemplate objects */
t_symbol *t_sym; /* name */
int t_n; /* number of dataslots (fields) */
t_dataslot *t_vec; /* array of dataslots */
} t_template;
struct _array
{
int a_n; /* number of elements */
int a_elemsize; /* size in bytes; LATER get this from template */
char *a_vec; /* array of elements */
t_symbol *a_templatesym; /* template for elements */
int a_valid; /* protection against stale pointers into array */
t_gpointer a_gp; /* pointer to scalar or array element we're in */
t_gstub *a_stub;
};
/* structure for traversing all the connections in a glist */
typedef struct _linetraverser
{
t_canvas *tr_x;
t_object *tr_ob;
int tr_nout;
int tr_outno;
t_object *tr_ob2;
t_outlet *tr_outlet;
t_inlet *tr_inlet;
int tr_nin;
int tr_inno;
int tr_x11, tr_y11, tr_x12, tr_y12;
int tr_x21, tr_y21, tr_x22, tr_y22;
int tr_lx1, tr_ly1, tr_lx2, tr_ly2;
t_outconnect *tr_nextoc;
int tr_nextoutno;
} t_linetraverser;
/* function types used to define graphical behavior for gobjs, a bit like X
widgets. We don't use Pd methods because Pd's typechecking can't specify the
types of pointer arguments. Also it's more convenient this way, since
every "patchable" object can just get the "text" behaviors. */
/* Call this to get a gobj's bounding rectangle in pixels */
typedef void (*t_getrectfn)(t_gobj *x, struct _glist *glist,
int *x1, int *y1, int *x2, int *y2);
/* and this to displace a gobj: */
typedef void (*t_displacefn)(t_gobj *x, struct _glist *glist, int dx, int dy);
/* change color to show selection: */
typedef void (*t_selectfn)(t_gobj *x, struct _glist *glist, int state);
/* change appearance to show activation/deactivation: */
typedef void (*t_activatefn)(t_gobj *x, struct _glist *glist, int state);
/* warn a gobj it's about to be deleted */
typedef void (*t_deletefn)(t_gobj *x, struct _glist *glist);
/* making visible or invisible */
typedef void (*t_visfn)(t_gobj *x, struct _glist *glist, int flag);
/* field a mouse click (when not in "edit" mode) */
typedef int (*t_clickfn)(t_gobj *x, struct _glist *glist,
int xpix, int ypix, int shift, int alt, int dbl, int doit);
/* ... and later, resizing; getting/setting font or color... */
struct _widgetbehavior
{
t_getrectfn w_getrectfn;
t_displacefn w_displacefn;
t_selectfn w_selectfn;
t_activatefn w_activatefn;
t_deletefn w_deletefn;
t_visfn w_visfn;
t_clickfn w_clickfn;
};
/* -------- behaviors for scalars defined by objects in template --------- */
/* these are set by "drawing commands" in g_template.c which add appearance to
scalars, which live in some other window. If the scalar is just included
in a canvas the "parent" is a misnomer. There is also a text scalar object
which really does draw the scalar on the parent window; see g_scalar.c. */
/* note how the click function wants the whole scalar, not the "data", so
doesn't work on array elements... LATER reconsider this */
/* bounding rectangle: */
typedef void (*t_parentgetrectfn)(t_gobj *x, struct _glist *glist,
t_word *data, t_template *tmpl, float basex, float basey,
int *x1, int *y1, int *x2, int *y2);
/* displace it */
typedef void (*t_parentdisplacefn)(t_gobj *x, struct _glist *glist,
t_word *data, t_template *tmpl, float basex, float basey,
int dx, int dy);
/* change color to show selection */
typedef void (*t_parentselectfn)(t_gobj *x, struct _glist *glist,
t_word *data, t_template *tmpl, float basex, float basey,
int state);
/* change appearance to show activation/deactivation: */
typedef void (*t_parentactivatefn)(t_gobj *x, struct _glist *glist,
t_word *data, t_template *tmpl, float basex, float basey,
int state);
/* making visible or invisible */
typedef void (*t_parentvisfn)(t_gobj *x, struct _glist *glist,
t_word *data, t_template *tmpl, float basex, float basey,
int flag);
/* field a mouse click */
typedef int (*t_parentclickfn)(t_gobj *x, struct _glist *glist,
t_scalar *sc, t_template *tmpl, float basex, float basey,
int xpix, int ypix, int shift, int alt, int dbl, int doit);
struct _parentwidgetbehavior
{
t_parentgetrectfn w_parentgetrectfn;
t_parentdisplacefn w_parentdisplacefn;
t_parentselectfn w_parentselectfn;
t_parentactivatefn w_parentactivatefn;
t_parentvisfn w_parentvisfn;
t_parentclickfn w_parentclickfn;
};
/* cursor definitions; used as return value for t_parentclickfn */
#define CURSOR_RUNMODE_NOTHING 0
#define CURSOR_RUNMODE_CLICKME 1
#define CURSOR_RUNMODE_THICKEN 2
#define CURSOR_RUNMODE_ADDPOINT 3
#define CURSOR_EDITMODE_NOTHING 4
#define CURSOR_EDITMODE_CONNECT 5
#define CURSOR_EDITMODE_DISCONNECT 6
EXTERN void canvas_setcursor(t_glist *x, unsigned int cursornum);
extern t_canvas *canvas_editing; /* last canvas to start text edting */
extern t_canvas *canvas_whichfind; /* last canvas we did a find in */
extern t_canvas *canvas_list; /* list of all root canvases */
extern t_class *vinlet_class, *voutlet_class;
extern int glist_valid; /* incremented when pointers might be stale */
/* ------------------- functions on any gobj ----------------------------- */
EXTERN void gobj_getrect(t_gobj *x, t_glist *owner, int *x1, int *y1,
int *x2, int *y2);
EXTERN void gobj_displace(t_gobj *x, t_glist *owner, int dx, int dy);
EXTERN void gobj_select(t_gobj *x, t_glist *owner, int state);
EXTERN void gobj_activate(t_gobj *x, t_glist *owner, int state);
EXTERN void gobj_delete(t_gobj *x, t_glist *owner);
EXTERN void gobj_vis(t_gobj *x, t_glist *glist, int flag);
EXTERN int gobj_click(t_gobj *x, struct _glist *glist,
int xpix, int ypix, int shift, int alt, int dbl, int doit);
EXTERN void gobj_save(t_gobj *x, t_binbuf *b);
EXTERN void gobj_properties(t_gobj *x, struct _glist *glist);
EXTERN void gobj_save(t_gobj *x, t_binbuf *b);
/* -------------------- functions on glists --------------------- */
EXTERN t_glist *glist_new( void);
EXTERN void glist_init(t_glist *x);
EXTERN void glist_add(t_glist *x, t_gobj *g);
EXTERN void glist_cleanup(t_glist *x);
EXTERN void glist_free(t_glist *x);
EXTERN void glist_clear(t_glist *x);
EXTERN t_canvas *glist_getcanvas(t_glist *x);
EXTERN int glist_isselected(t_glist *x, t_gobj *y);
EXTERN void glist_select(t_glist *x, t_gobj *y);
EXTERN void glist_deselect(t_glist *x, t_gobj *y);
EXTERN void glist_noselect(t_glist *x);
EXTERN void glist_selectall(t_glist *x);
EXTERN void glist_delete(t_glist *x, t_gobj *y);
EXTERN void glist_retext(t_glist *x, t_text *y);
EXTERN void glist_grab(t_glist *x, t_gobj *y, t_glistmotionfn motionfn,
t_glistkeyfn keyfn, int xpos, int ypos);
EXTERN int glist_isvisible(t_glist *x);
EXTERN int glist_istoplevel(t_glist *x);
EXTERN t_glist *glist_findgraph(t_glist *x);
EXTERN int glist_getfont(t_glist *x);
EXTERN void glist_sort(t_glist *canvas);
EXTERN void glist_read(t_glist *x, t_symbol *filename, t_symbol *format);
EXTERN void glist_mergefile(t_glist *x, t_symbol *filename, t_symbol *format);
EXTERN float glist_pixelstox(t_glist *x, float xpix);
EXTERN float glist_pixelstoy(t_glist *x, float ypix);
EXTERN float glist_xtopixels(t_glist *x, float xval);
EXTERN float glist_ytopixels(t_glist *x, float yval);
EXTERN float glist_dpixtodx(t_glist *x, float dxpix);
EXTERN float glist_dpixtody(t_glist *x, float dypix);
EXTERN void glist_redrawitem(t_glist *owner, t_gobj *gobj);
EXTERN void glist_getnextxy(t_glist *gl, int *xval, int *yval);
EXTERN void glist_glist(t_glist *g, t_symbol *s, int argc, t_atom *argv);
EXTERN t_glist *glist_addglist(t_glist *g, t_symbol *sym,
float x1, float y1, float x2, float y2,
float px1, float py1, float px2, float py2);
EXTERN void glist_arraydialog(t_glist *parent, t_symbol *name,
t_floatarg size, t_floatarg saveit, t_floatarg newgraph);
EXTERN t_binbuf *glist_writetobinbuf(t_glist *x, int wholething);
EXTERN int glist_isgraph(t_glist *x);
EXTERN void glist_redraw(t_glist *x);
EXTERN void glist_drawiofor(t_glist *glist, t_object *ob, int firsttime,
char *tag, int x1, int y1, int x2, int y2);
EXTERN void glist_eraseiofor(t_glist *glist, t_object *ob, char *tag);
EXTERN void canvas_create_editor(t_glist *x, int createit);
void canvas_deletelinesforio(t_canvas *x, t_text *text,
t_inlet *inp, t_outlet *outp);
/* -------------------- functions on texts ------------------------- */
EXTERN void text_setto(t_text *x, t_glist *glist, char *buf, int bufsize);
EXTERN void text_drawborder(t_text *x, t_glist *glist, char *tag,
int width, int height, int firsttime);
EXTERN void text_eraseborder(t_text *x, t_glist *glist, char *tag);
EXTERN int text_xcoord(t_text *x, t_glist *glist);
EXTERN int text_ycoord(t_text *x, t_glist *glist);
EXTERN int text_xpix(t_text *x, t_glist *glist);
EXTERN int text_ypix(t_text *x, t_glist *glist);
EXTERN int text_shouldvis(t_text *x, t_glist *glist);
/* -------------------- functions on rtexts ------------------------- */
#define RTEXT_DOWN 1
#define RTEXT_DRAG 2
#define RTEXT_DBL 3
#define RTEXT_SHIFT 4
EXTERN t_rtext *rtext_new(t_glist *glist, t_text *who);
EXTERN t_rtext *glist_findrtext(t_glist *gl, t_text *who);
EXTERN void rtext_draw(t_rtext *x);
EXTERN void rtext_erase(t_rtext *x);
EXTERN t_rtext *rtext_remove(t_rtext *first, t_rtext *x);
EXTERN int rtext_height(t_rtext *x);
EXTERN void rtext_displace(t_rtext *x, int dx, int dy);
EXTERN void rtext_select(t_rtext *x, int state);
EXTERN void rtext_activate(t_rtext *x, int state);
EXTERN void rtext_free(t_rtext *x);
EXTERN void rtext_key(t_rtext *x, int n, t_symbol *s);
EXTERN void rtext_mouse(t_rtext *x, int xval, int yval, int flag);
EXTERN void rtext_retext(t_rtext *x);
EXTERN int rtext_width(t_rtext *x);
EXTERN int rtext_height(t_rtext *x);
EXTERN char *rtext_gettag(t_rtext *x);
EXTERN void rtext_gettext(t_rtext *x, char **buf, int *bufsize);
/* -------------------- functions on canvases ------------------------ */
EXTERN t_class *canvas_class;
EXTERN t_canvas *canvas_new(void *dummy, t_symbol *sel, int argc, t_atom *argv);
EXTERN t_symbol *canvas_makebindsym(t_symbol *s);
EXTERN void canvas_vistext(t_canvas *x, t_text *y);
EXTERN void canvas_fixlinesfor(t_canvas *x, t_text *text);
EXTERN void canvas_deletelinesfor(t_canvas *x, t_text *text);
EXTERN void canvas_stowconnections(t_canvas *x);
EXTERN void canvas_restoreconnections(t_canvas *x);
EXTERN void canvas_redraw(t_canvas *x);
EXTERN t_inlet *canvas_addinlet(t_canvas *x, t_pd *who, t_symbol *sym,t_symbol* s);
EXTERN void canvas_rminlet(t_canvas *x, t_inlet *ip);
EXTERN t_outlet *canvas_addoutlet(t_canvas *x, t_pd *who, t_symbol *sym);
EXTERN void canvas_rmoutlet(t_canvas *x, t_outlet *op);
EXTERN void canvas_redrawallfortemplate(t_canvas *tmpl);
EXTERN void canvas_zapallfortemplate(t_canvas *tmpl);
EXTERN void canvas_setusedastemplate(t_canvas *x);
EXTERN t_canvas *canvas_getcurrent(void);
EXTERN void canvas_setcurrent(t_canvas *x);
EXTERN void canvas_unsetcurrent(t_canvas *x);
EXTERN t_symbol *canvas_realizedollar(t_canvas *x, t_symbol *s);
EXTERN t_canvas *canvas_getrootfor(t_canvas *x);
EXTERN void canvas_dirty(t_canvas *x, t_int n);
EXTERN int canvas_getfont(t_canvas *x);
typedef int (*t_canvasapply)(t_canvas *x, t_int x1, t_int x2, t_int x3);
EXTERN t_int *canvas_recurapply(t_canvas *x, t_canvasapply *fn,
t_int x1, t_int x2, t_int x3);
EXTERN void canvas_resortinlets(t_canvas *x);
EXTERN void canvas_resortoutlets(t_canvas *x);
EXTERN void canvas_free(t_canvas *x);
EXTERN void canvas_updatewindowlist( void);
EXTERN void canvas_editmode(t_canvas *x, t_floatarg yesplease);
EXTERN int canvas_isabstraction(t_canvas *x);
EXTERN int canvas_istable(t_canvas *x);
EXTERN int canvas_showtext(t_canvas *x);
EXTERN void canvas_vis(t_canvas *x, t_floatarg f);
EXTERN t_canvasenvironment *canvas_getenv(t_canvas *x);
EXTERN void canvas_rename(t_canvas *x, t_symbol *s, t_symbol *dir);
EXTERN void canvas_loadbang(t_canvas *x);
EXTERN int canvas_hitbox(t_canvas *x, t_gobj *y, int xpos, int ypos,
int *x1p, int *y1p, int *x2p, int *y2p);
EXTERN int canvas_setdeleting(t_canvas *x, int flag);
typedef void (*t_undofn)(t_canvas *canvas, void *buf,
int action); /* a function that does UNDO/REDO */
#define UNDO_FREE 0 /* free current undo/redo buffer */
#define UNDO_UNDO 1 /* undo */
#define UNDO_REDO 2 /* redo */
EXTERN void canvas_setundo(t_canvas *x, t_undofn undofn, void *buf,
const char *name);
EXTERN void canvas_noundo(t_canvas *x);
EXTERN int canvas_getindex(t_canvas *x, t_gobj *y);
/* T.Grill - made public for dynamic object creation */
/* in g_editor.c */
EXTERN void canvas_connect(t_canvas *x,
t_floatarg fwhoout, t_floatarg foutno,t_floatarg fwhoin, t_floatarg finno);
EXTERN void canvas_disconnect(t_canvas *x,
float index1, float outno, float index2, float inno);
EXTERN int canvas_isconnected (t_canvas *x,
t_text *ob1, int n1, t_text *ob2, int n2);
EXTERN void canvas_selectinrect(t_canvas *x, int lox, int loy, int hix, int hiy);
/* ---- functions on canvasses as objects --------------------- */
EXTERN void canvas_fattenforscalars(t_canvas *x,
int *x1, int *y1, int *x2, int *y2);
EXTERN void canvas_visforscalars(t_canvas *x, t_glist *glist, int vis);
EXTERN int canvas_clicksub(t_canvas *x, int xpix, int ypix, int shift,
int alt, int dbl, int doit);
EXTERN t_glist *canvas_getglistonsuper(void);
EXTERN void linetraverser_start(t_linetraverser *t, t_canvas *x);
EXTERN t_outconnect *linetraverser_next(t_linetraverser *t);
EXTERN void linetraverser_skipobject(t_linetraverser *t);
/* --------------------- functions on tscalars --------------------- */
EXTERN void tscalar_getrect(t_tscalar *x, t_glist *owner,
int *xp1, int *yp1, int *xp2, int *yp2);
EXTERN void tscalar_vis(t_tscalar *x, t_glist *owner, int flag);
EXTERN int tscalar_click(t_tscalar *x, int xpix, int ypix, int shift,
int alt, int dbl, int doit);
/* --------- functions on garrays (graphical arrays) -------------------- */
EXTERN t_template *garray_template(t_garray *x);
/* -------------------- arrays --------------------- */
EXTERN t_garray *graph_array(t_glist *gl, t_symbol *s, t_symbol *tmpl,
t_floatarg f, t_floatarg saveit);
EXTERN t_array *array_new(t_symbol *templatesym, t_gpointer *parent);
EXTERN void array_resize(t_array *x, t_template *tmpl, int n);
EXTERN void array_free(t_array *x);
/* --------------------- gpointers and stubs ---------------- */
EXTERN t_gstub *gstub_new(t_glist *gl, t_array *a);
EXTERN void gstub_cutoff(t_gstub *gs);
EXTERN void gpointer_setglist(t_gpointer *gp, t_glist *glist, t_scalar *x);
/* --------------------- scalars ------------------------- */
EXTERN void word_init(t_word *wp, t_template *tmpl, t_gpointer *gp);
EXTERN void word_restore(t_word *wp, t_template *tmpl,
int argc, t_atom *argv);
EXTERN t_scalar *scalar_new(t_glist *owner,
t_symbol *templatesym);
EXTERN void scalar_getbasexy(t_scalar *x, float *basex, float *basey);
/* ------helper routines for "garrays" and "plots" -------------- */
EXTERN int array_doclick(t_array *array, t_glist *glist, t_gobj *gobj,
t_symbol *elemtemplatesym,
float linewidth, float xloc, float xinc, float yloc,
int xpix, int ypix, int shift, int alt, int dbl, int doit);
EXTERN void array_getcoordinate(t_glist *glist,
char *elem, int xonset, int yonset, int wonset, int indx,
float basex, float basey, float xinc,
float *xp, float *yp, float *wp);
EXTERN int array_getfields(t_symbol *elemtemplatesym,
t_canvas **elemtemplatecanvasp,
t_template **elemtemplatep, int *elemsizep,
int *xonsetp, int *yonsetp, int *wonsetp);
/* --------------------- templates ------------------------- */
EXTERN t_template *template_new(t_symbol *sym, int argc, t_atom *argv);
EXTERN void template_free(t_template *x);
EXTERN int template_match(t_template *x1, t_template *x2);
EXTERN int template_find_field(t_template *x, t_symbol *name, int *p_onset,
int *p_type, t_symbol **p_arraytype);
EXTERN t_float template_getfloat(t_template *x, t_symbol *fieldname, t_word *wp,
int loud);
EXTERN void template_setfloat(t_template *x, t_symbol *fieldname, t_word *wp,
t_float f, int loud);
EXTERN t_symbol *template_getsymbol(t_template *x, t_symbol *fieldname,
t_word *wp, int loud);
EXTERN void template_setsymbol(t_template *x, t_symbol *fieldname,
t_word *wp, t_symbol *s, int loud);
EXTERN t_template *gtemplate_get(t_gtemplate *x);
EXTERN t_template *template_findbyname(t_symbol *s);
EXTERN t_canvas *template_findcanvas(t_template *tmpl);
EXTERN t_float template_getfloat(t_template *x, t_symbol *fieldname,
t_word *wp, int loud);
EXTERN void template_setfloat(t_template *x, t_symbol *fieldname,
t_word *wp, t_float f, int loud);
EXTERN t_symbol *template_getsymbol(t_template *x, t_symbol *fieldname,
t_word *wp, int loud);
EXTERN void template_setsymbol(t_template *x, t_symbol *fieldname,
t_word *wp, t_symbol *s, int loud);
/* ----------------------- guiconnects, g_guiconnect.c --------- */
EXTERN t_guiconnect *guiconnect_new(t_pd *who, t_symbol *sym);
EXTERN void guiconnect_notarget(t_guiconnect *x, double timedelay);
/* ------------- IEMGUI routines used in other g_ files ---------------- */
EXTERN t_symbol *iemgui_raute2dollar(t_symbol *s);
EXTERN t_symbol *iemgui_dollar2raute(t_symbol *s);
#if defined(_LANGUAGE_C_PLUS_PLUS) || defined(__cplusplus)
}
#endif
1
0
externals/gridflow/images README, NONE, 1.1 lucida-typewriter-12.grid.gz, NONE, 1.1 test.mpeg, NONE, 1.1 tux.tga.gz, NONE, 1.1
by Mathieu Bouchard 04 Oct '05
by Mathieu Bouchard 04 Oct '05
04 Oct '05
Update of /cvsroot/pure-data/externals/gridflow/images
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv23360/images
Added Files:
README lucida-typewriter-12.grid.gz test.mpeg tux.tga.gz
Log Message:
added the remainder of the files (or almost) from GF 0.8.0
--- NEW FILE: README ---
Here's the file to list the authors of the pictures, as
far as I (matju) know:
b001.jpg, r001.jpg:
Eyewire Catalogue, 1999 or before. It should be checked
whether there still exists a copyright on this, because
the original provider has disappeared (bankruptcy??)
several years ago.
g001.jpg:
by Alexandre Castonguay, 1999 (?).
bluemarble.jpg:
NASA (?)
lada.jpg:
hungarian newspaper ad.
lena.jpg:
Lena Sjööblom Soderberg, centerfold of Playboy 1972.11.
Researchers in infographics have extensively used that
picture without necessarily asking for copyright, and
apparently Playboy doesn't mind.
lucida-typewriter-12.grid.gz:
a grid(256,13,7) containing the Lucida Typewriter 12
medium font.
opensource.png:
modification of a World War Two poster. Both authors
(original's and spoof's) are unknown to me. Should check.
rose.jpg:
unknown origin.
ruby0216.jpg:
photo from a conference about the Ruby programming language,
held somewhere in Japan in 2003 or so. (?)
teapot.png:
Researchers in infographics have also extensively used
that picture (actually the wireframe model). This is
(afaik) the original model, produced in the 1970's (?)
by one such researcher, and then was rendered in the
1990's using the Povray raytracer, and then bundled as
teapot.ppm in Tcl/Tk, and finally in 2001 I grabbed
that picture
test.mpeg:
unknown origin. Too small to be copyrightable.
tux.tga.gz:
unknown origin.
--- NEW FILE: test.mpeg ---
(This appears to be a binary file; contents omitted.)
--- NEW FILE: lucida-typewriter-12.grid.gz ---
(This appears to be a binary file; contents omitted.)
--- NEW FILE: tux.tga.gz ---
(This appears to be a binary file; contents omitted.)
1
0
[PD-cvs] externals/gridflow/bin backtrace, NONE, 1.1 demangle, NONE, 1.1 jmax2pd, NONE, 1.1 plusminus, NONE, 1.1
by Mathieu Bouchard 04 Oct '05
by Mathieu Bouchard 04 Oct '05
04 Oct '05
Update of /cvsroot/pure-data/externals/gridflow/bin
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv23360/bin
Added Files:
backtrace demangle jmax2pd plusminus
Log Message:
added the remainder of the files (or almost) from GF 0.8.0
--- NEW FILE: backtrace ---
#!/usr/bin/env ruby
if ARGV.length != 1
puts "usage: core.rb <corefile>"
exit 1
end
qfile=ARGV[0].gsub /'/, "\\\\'"
x=`gdb --batch -c '#{qfile}'`.split"\n"
m=/`([^']+)/.match x[0]
f=File.open("/tmp/backtrace_#{$$}.gdb","w")
f.puts"bt"
f.puts"quit"
f.close
cmd="gdb #{m[1]} #{qfile} --command=/tmp/backtrace_#{$$}.gdb"
x=`#{cmd}`.split("\n")
i=nil
x.each_with_index {|line,i| break if /^#0/ =~ line }
x[0..i]=[]
puts x
--- NEW FILE: plusminus ---
#!/usr/bin/env ruby
# NOTE: this works with diff -u only!!!
puts "-"*64
$plustot=0
$minustot=0
def show
printf "%20s %+5d %+5d (net %+5d)\n", $file, $plus, -$minus, $plus-$minus
end
loop{
line = gets
break if not line
if /^diff/.match line then
x = line.split(/\s+/)
$plustot+=$plus if $plus
$minustot+=$minus if $minus
show if $file
$file = x[-1]
$on=false
$plus=0
$minus=0
elsif /^\@\@/ =~ line then $on=true
elsif $on and /^\+/ =~ line then $plus+=1
elsif $on and /^\-/ =~ line then $minus+=1
end
}
$plustot+=$plus if $plus
$minustot+=$minus if $minus
show if $file
$file="total"
$plus=$plustot
$minus=$minustot
puts "-"*64
show
--- NEW FILE: demangle ---
#!/usr/bin/env ruby
f = File.popen "gdb", "r+"
f.puts "maintenance demangle #{ARGV[0]}", "quit"
puts f.read.split("\n")[-2].sub(/^\(gdb\) /,"")
--- NEW FILE: jmax2pd ---
#!/usr/bin/env ruby
require "gridflow"
require "gridflow/extra/jmax_format.rb"
require "gridflow/extra/puredata_format.rb"
include GridFlow
#GridFlow.verbose = true
iname,oname = ARGV
if not iname
raise "usage: jmax2pd <input.jmax> [<output.pd>]"
end
if not oname
oname = iname.sub(/\.jmax$/,".pd")
end
keep=["broken","jpatcher","button","slider","messbox"]
GridFlow.instance_eval{(a)fclasses_set.delete_if {|k,v|
not keep.include? k
}}
#p GridFlow.instance_eval{(a)fclasses_set.keys.sort}
jfr = JMaxFileReader.new(File.open(iname),FObject)
FObject.broken_ok = true
FObject.do_loadbangs = false
my_patcher = jfr.parse
pfw = PureDataFileWriter.new(oname)
pfw.write_patcher my_patcher
pfw.close
1
0
externals/gridflow COPYING, NONE, 1.1 ChangeLog, NONE, 1.1 Makefile.gf, NONE, 1.1 README, NONE, 1.1 TODO, NONE, 1.1 configure, NONE, 1.1
by Mathieu Bouchard 04 Oct '05
by Mathieu Bouchard 04 Oct '05
04 Oct '05
Update of /cvsroot/pure-data/externals/gridflow
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv23360
Added Files:
COPYING ChangeLog Makefile.gf README TODO configure
Log Message:
added the remainder of the files (or almost) from GF 0.8.0
--- NEW FILE: configure ---
#!/usr/bin/env ruby
# $Id: configure,v 1.1 2005/10/04 02:12:43 matju Exp $
=begin
GridFlow
Copyright (c) 2001,2002,2003,2004 by Mathieu Bouchard
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.
See file ./COPYING for further informations on licensing terms.
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
[...1097 lines suppressed...]
Dir.chdir "devices4ruby"
system "/usr/bin/env", "ruby", "extconf.rb", *a
Dir.chdir ".."
puts "(back)"
#--------------------------------#
puts "",
"\e[1mSee ./config.log if you want the details of the configuration tests.\e[0m",
"\e[1mIf you are satisfied with that configuration, you may go on,\e[0m",
"\e[1m and do \"make\" and then \"make install\".\e[0m",
"\e[1mIf you get stuck, you could contact the author about it,\e[0m",
"\e[1m but first make sure you read \"doc/install.html\". \e[0m",
""
#--------------------------------#
END {
system "/bin/rm -f tmp/#{$$} tmp/#{$$}.c tmp/#{$$}.o tmp/#{$$}.asm"
}
--- NEW FILE: ChangeLog ---
/* $Id: ChangeLog,v 1.1 2005/10/04 02:12:43 matju Exp $ */
version 0.8.0 (2005.06.06):
* removed support for jMax 2.5 and jMax 4.1
* added GCC 3.4 support
* added AMD64 support
* added support for puredata "datastructure" pointers (aka gpointer)
* changing the @-prefix for a #-prefix, where the old prefix still works
(the old syntax is backwards-compatible,
the new syntax is forwards-compatible)
* 13 object-classes rewritten from Ruby to Pd abstractions
* merged [@],[@!] -> [#] and added message "op"
* removed all one-input ops (see next...)
* new two-input ops: abs- sq- avg hypot sqrt rand (soon erf* clip+ clip-)
* [#fold],[#scan]: removed seed arg and right outlet; added msgs "op" and "seed"
* [#inner],[#convolve] : added msgs "op" and "seed"
* [#inner],[#convolve] : removed three first args (usually * + 0)
* [#inner] : removed middle inlet
* major changes to the bridge API (Ruby<->PureData)
* project "Linux Devices For Ruby" got merged in, as devices4ruby/
* source code cleanup
* internals: split Grid into Grid+GridPtr
* internals: GridObject no longer manages GridOutlet
* internals: added classes P,PtrGrid,...
* internals: beginning to use C++'s Standard Template Library (sometimes)
* [gridflow] now has "formats" msg (to list available formats)
* [#store] added msg "op"
* [#out x11] removed flag "verbose"
* some spaces may now be omitted in gf-lists. e.g.:
( ( 2 1 ) ( ) ) ( 3 4 ( 5 ) ) can be shortened to: ((2 1) ()) (3 4 (5))
* new object classes:
[display], [#reverse], [#unpack], [#centroid2], [ls], [renamefile], [unix_time],
[exec], [plotter_control], [#text_to_image], [#hueshift], [rubyarray]
* in pd_examples added Alx's epicycloid.pd, scratch_video.pd, threshold.pd
and Matju's goop.pd
version 0.7.7 (2004.08.24):
* GridFlow runs on MacOS 10.2 with PureData 0.37
* updated drag_rectangle.pd, nervous_video.pd, fire.pd, color_correction.pd
* updated feedback_fractal.pd (added morphing)
* added pd_examples/waves.pd, pd_examples/sand.pd
* added pd_examples/color_detect.pd (supersedes chroma_key.pd)
* added pd_examples/spectrogram.pd, pd_examples/photo_pianoroll.pd
* removed [rtmetro] (obsolete)
* [@store]: added methods: put_at, reassign
* [pingpong]: added $1
* [demux] renamed to [shunt] and extra optional arg added (for initial value)
* new object classes:
[range], [#mouse], [#pack], [#color], [bindpatcher],
[#camera], [#fade_lin], [#peephole]
* videodev: added method "get"
* [@out quartz] now works properly
* [@downscale_by] accepts any number of channels
* [@inner2] removed; instead use [@transpose] with [@inner]
* videodev: "transfer" message allows to change the queue's length
* quicktime(hw): added messages "parameter", "framerate", "size"
* quicktime(hw): fixed encoding bug
* png: fixed memory leak
* ./configure --lite disables float32 float64 int64
* ./configure --verbose prints useless details
* doc: rewrote installation instructions
* x11: fixed memory leak in resizing window
* on MacOS 10 [@out window] now defaults to [@out quartz]
* doc: added credits section
version 0.7.6 (2004.03.22):
* GridFlow runs on MacOS 10.2 (only with jMax 2.5)
* [@out quartz] makes a native MacOS (Cocoa+Quartz) window (warning: very buggy)
* support for Apple QuickTime movie decoding (format/quicktimeapple.c)
* file suffix detector is now extensible
* added: Ruby interface for libUSB (base/usb.c)
* x11: now emits "keypress" and "keyrelease" messages
* [@downscale_by] now supports 4 channels (therefore [peephole] does too)
* fixed bugs in: x11, @draw_image, @import, @export, ...
* "open x11" now allows any DISPLAY spec
* now includes the pictures used in the examples
(not a separate download anymore)
* [@out x11 here override_redirect] (override window manager; be careful with this)
* [pd_netsocket] does like [netsend]/[netreceive] but two-way
(warning: not complete yet)
* support for nested lists in incoming messages
* new object classes:
[delcom_usb]: support for Delcom USB I/O controller
[joystick_port]: support for linux joystick drivers
[foreach], [rubysprintf], [listflatten]
[messageprepend], [messageappend], [@transpose]
[@fade], [@centroid]
jMax emulation: [listmake], [listlength], [listelement], [listsublist]
jMax emulation: [listprepend], [listappend], [listreverse], [oneshot]
jMax emulation: [inv+], [inv*]
* Pd main window: adding GridFlow menu, Ruby/Tcl evaluators (with command-history)
* added bin/jmax2pd (converts .jmax files to .pd files)
* ported all .jmax examples to .pd (using jmax2pd) (20 out of 20)
* support for variable number of inlets/outlets (only with PureData)
version 0.7.5 (2003.09.28):
* type aliases: int32,i32,i; int16,i16,s; uint8,u8,b; float32,f32,f
* added support for float64 (alias f64, d)
* added support for int64 (alias i64, l)
* doc: added number type table
* @convolve: supports even-sized grids
* fixed bug: puredata gf clock ran way too fast
* rewrote the profiler subsystem (and removed bugs)
* @scale_by: now works with any number of channels
* renamed samples/ to jmax_examples/
* Algebraic Properties Descriptions (internal, used for accelerations)
* @convolve,@outer,@for,@inner,@draw_polygon: much faster
* quicktime: support for pluggable codecs (eg: dv, divx, rpza, ...)
* quicktime: fixed more bugs
* quicktime: major speed increase
* quicktime: added "colorspace" option
* videodev: fixed bugs
* videodev: removed obsolete option "noinit"
* videodev: added option "colormodel" (especially because of new camera drivers)
* sdl: added automatic resizing of window
* png: read support
* jMax bridge: more stable than ever
* PureData bridge: *much* more stable than ever
* Operator1, Operator2 renamed to Numop1, Numop2
* x11: now also called "window", so you can write "@out window", "open window"
* new object classes:
@draw_image: picture-in-picture, with alpha blending, etc
jmax4_udpsend: send to a jMax 4.0.x system via UDP
jmax4_udpreceive: receive from a jMax 4.0.x system via UDP
pd_netsend: send to a pd system via UDP
pd_netreceive: receive from a pd system via UDP
@eight: (like @four, but with eight of them ;-)
peephole: like [@out x11] but as inset of a patcher (jMax 2.5 only)
* support for upcoming jMax 4.1
* "open file" autodetects how to handle a file, by filename suffix
version 0.7.2 (2003.04.24):
* fixed bugs in: make install, jpeg reading
* added support for float32
* added direct .jmax decoding
* added direct .pd encoding
* pd examples moved to separate directory
* ported some .jmax examples to .pd (automated) (8 out of 20)
* added motion_detect.pd
* new classes: demux, and more jmax emulations
* @in,@out: keyword "option" may be omitted
* configure: added --ruby-prefix
* adding custom C++ pre-preprocessor
* better type checking of message arguments (better error reporting too)
* @print supports 3 dimensions, and msg "base" with arg 2,8,10,16
* can now write loadbang-messages into an object box using the comma
* major cleanup of the source code
* added operator *>>8 (multiplication by value then division by 256)
* new classes: @rgb_to_yuv, @yuv_to_rgb
* @rotate now works with multiple axis (can work on 3D points, etc)
version 0.7.1 (2003.03.24):
* fixed important bugs (crashes and such)
* @store,@ can now receive in inlet 1 while sending from outlet 0.
* @, when inlet 1 grid size is small but not 1, is now much faster.
* added memcpy() usage logging (see profiler_dump)
* added examples: drag_rectangle.jmax, plot.jmax, eclipse.jmax
* added example: cellular_1d.pd
* added classes: fork, jmax_udpsend, jmax_udpreceive
* added classes: @rotate, @remap_image, @type
* added operators: gcd,lcm (common divisors/multiples)
* quicktime: added encoding, added seek, fixed bugs
* @in inlet 1 tells frame number (int), end-of-file (bang)
* @in: added: set, option loop (controlling auto-rewind)
* updated cross_fade.jmax (much faster)
* @two,@three,@four allow inlet 0 bang trigger
* configure: simpler config for jMax 2.5
* PD help patches (by Uli Berthold)
* PD: "make install" takes care of help patches and library
* CVS web interface on artengine.ca (thanks to Alex)
version 0.7.0 (2003.02.01):
* new classes: @cast, @join, @ravel, @grade, @perspective
* new grid protocol supports several number types (added uint8,int16)
* added number type support in most classes
* added "option cast" for @in in some formats
* can now specify number types in grid literals
* added some MMX support (accelerates by 0%..40%)
* @import: added optional 2nd arg specifying type.
* @import: can convert symbols to grids of their ascii codes.
* new [@import per_message] yields one grid per incoming message
* [fps]: added options "user" "system" "cpu" for selecting clock
* aalib: added options autodraw, draw, dump
* aalib: added raw input (two channels: characters, attributes)
* x11: added support for 256-color mode using a private colormap.
* x11: added "use_stripes" for alternate 256-color rendering.
* fixed problems with earlier versions of Ruby (like 1.6.2)
* new samples: polygon.jmax
* videodev_effects.jmax: added sort-effects, centre-of-gravity-tracking
* the time profiler is back to working !!!
* @scale_by, @downscale_by: added right inlet, for configuration
* @store is a bit faster
* ppm: accelerated by large amount
* @outer,@inner,@inner2,@fold accelerated by obscene amount
version 0.6.5 (2003.01.10):
* can now encode Targa-24, Targa-32, JPEG-24
* can now output through aalib (ascii art library)
* fixed problems with libruby.a
* tested with the new version of Ruby (1.8)
* new classes:
fps, @rgb_to_greyscale, @greyscale_to_rgb, @solarize,
@complex_sq, @export_symbol, @draw_polygon,
@apply_colormap_channelwise
* new class FPatcher, a ruby patcher/abstraction system
* @scale_to,@contrast,@spread,@posterize now available in
PureData & Ruby; they also now accept arguments.
* [@scale_to]: back to working; inlets "height" and "width" merged
* [route grid_begin] replaced by [route grid]
* [route grid_end] replaced by [@finished]
* Most everything is 10-50% faster
* changes in the internal transmission of grids
* new two-input operators: div, swapdiv, put, ignore
* compilable on MacOS 10
version 0.6.4 (2002.12.23):
* can now decode JPEG (using libjpeg.so)
* many bugs fixed (especially in file formats)
* operators: log* added; tanh renamed to tanh*
* @two,@three,@four are no longer specific to the jMax side
* format grid: option headerless for reading any kind of file
* format grid: option headerful (revert to actual .grid format mode)
* fixed problems with GNU C++ version 3
* format ppm: accelerated writing
* format modifier gzfile: gzip support also works with [@out]
* format x11: the "here" specifier is now optional
* added @checkers
* [@scale_by {y x}] for different y,x scale factors
* [@in blah blah] means "open blah blah" -> [@in] (and same with @out)
* added @downscale_by with or without smoothing
* format targa: can now decode 32 bit RGBA
* @layer: combines RGBA foreground with RGB background, yielding RGB.
* format grid options: endian big, endian little, endian same
* formats ppm,grid: use 'option rewind' to overwrite same file
(by default, rewind is no longer done after each frame)
('option rewind' also rewinds on reading)
version 0.6.3 (2002.12.06):
* removing the custom leak detector ("Valgrind" program used instead)
* removed all (?) memory leaks
* videodev: new options: frequency, transfer [read|mmap], noinit
* profiler summary code rewritten
* profiler wrapper code removed
* x11: option setcursor <0-63>, option hidecursor
* x11: outlet 0 tells cursor position / button state
* more C++ification of the code
* many bugs fixed (especially crashes)
version 0.6.2 (2002.09.17):
* jMax objects written in (or using) Ruby now can work in PureData too.
* new format: SDL (portable output to window)
* can now compile bridges without libruby.so
* changed grid-protocol: added direct object-to-object streaming.
* bug: gridflow's clock tick back to a decent value (sorry)
* all inlets supporting grids also convert int/float as 0-D grids
* @fold and @scan now accept grids in right inlet and constructor
* @convolve is 2-3 times faster
* %,swap% are now called rem,swaprem; new %,swap% is the true modulo.
* @for now allows vectorial from/to/step values
* @identity_transform removed, change to eg: [@for{0 0}{240 320}{1 1}]
* PD users: grid literals are written like:
[@for ( 0 0 ) ( 240 320 ) ( 1 1 )] with all those spaces
* @inner,@inner2,@convolve can take right inlet grid as 4th argument
* re-enabled and improved the memory leak detector (use --debug)
* fixed many bugs and leaks
* fixed bugs in @store
* added sample: zoom.pd
version 0.6.1 (2002.08.29):
* now compiling GridFlow as C++ (replacing C)
* now you can use Ruby 1.7, which is faster
note: if you do so, make sure your version is dated 2002
* new objects: rubyprint, printargs, @print, @scan, @inner
* new format: apple quicktime (using libquicktime.so)
* @in gzip support (example: "open ppm gzfile teapot.ppm.gz")
also works with targa and grid
* BitPacking now supports 1 to 4 channels instead of just 3
* using mkmf.rb makefile generation; some MSWindows support thru Cygwin
* added geiger counter simulator in [rtmetro]
* libruby.so is only needed when using GridFlow through jMax
* now can do grid literals in @ and @outer, like [@ + {0 1}]
* syntax of @redim,@import changed from [@redim 2 3] to [@redim {2 3}]
* "3 3 # 1 0 0 1" into inlet does automatic @redim, for all objects
* grid literals accept {2 3 # 1 4 5} as an implicit [@redim {2 3}]
* objects rewritten in Ruby language: @in, @out
* updated samples, templates, documentation.
* fixed bugs
version 0.6.0 (2002.07.31):
* THIS IS AN EXPERIMENTAL BRANCH (VERY BUGGY)
REAL PROJECTS SHOULD USE VERSION 0.5.0 INSTEAD
* GridFlow rewritten as a plugin for Ruby instead of jMax.
* GridFlow now includes a Ruby-for-jMax bridge.
* you need Ruby 1.6.6 (including libruby.so) or compatible
* you don't need GNU Bash anymore (configurator is now a Ruby program)
* format handlers for .ppm, .tga, .grid rewritten in Ruby
* merged all Makefiles together, etc.
* sources are in base/ and format/ instead of c/src/
* many bugs removed, many bugs added.
* will read ~/.gridflow_startup if it exists
version 0.5.0 (2002.06.08):
* big changes to the internals (especially use of macros)
* can compile without X11; added --no-x11 in ./configure
* removed support for jMax 2.4
* auto-detects jMax 2.5 and jMax 3.0
* @inner renamed to @inner2 (new, proper @inner coming soon)
* faster unary operators
* added unary operator: sq (faster squaring)
* further separation of GridFlow from jMax
* major format API changes (added Stream class)
* format "grid" now supports 8 bits per value
* support for HeroineWarrior's LibMPEG3 (reading + seeking)
* libmpeg.so (Greg Ward's) now also looked up as "libwardsmpeg.so"
* added objects: rtmetro, pingpong
* Moved CVS repository from Hostname.2y.net to Artengine.ca
* updated samples
version 0.4.1 (2002.01.02):
* cvs repository now has public access
* now can run configure without jmax/fts being present
* standalone version now works on Silicon Graphics and Corel Netwinder.
* MPEG format readonly (single file at a time; mpeg video layer only)
* grid TCP: non-blocking read
* fixed all known memory leaks
* X11 Shared Memory now disables itself properly on remote display
* updated help files
* updated help screenshots in the manual
* fixed profiler bugs
* fts emulation moved to c/src/ and tests moved to tests/
version 0.4.0 (2001.11.28):
* package name changed from "video4jmax" to "gridflow"
* documentation *rewritten*, more precise, more structured
* documentation format is now XML (includes HTMLized version)
* can now compile without jmax/fts (if you need quicker testing...)
* added format "grid" for storing any kind of grid to disk.
* added TCP client/server socket support (with format "grid" only)
* added (timewise) profiler
* @convolve now takes up to three arguments
* Format API changes again
* "connect" merged into "open"
* "size" merged into "option"
* @video_out merged into @out
* format videodev can now do full framerate (instead of just half)
* added X11 Shared Memory support (faster image transfer locally)
* added @scale_by for quick scaling by integer factors.
* @identity_transform, @scale_to are much faster.
* many other accelerations
version 0.3.0 (2001.11.04):
* reworked File Format API
* grid objects now all accept lists of integers (auto-convert to 1D grid)
* many accelerations (incl large speedup on chains of binary operations)
* transformed @video_out (X11) into a "File Format" (really) and:
* allows multiple displays
* auto-resizing window
* can set output as wallpaper
* can read from the screen (screenshot)
* @video_out now a backward-compatibility wrapper
* format videodev now uses double buffer mmap (somewhat faster)
* @video_in_file, @video_out_file renamed to @in, @out (with aliases)
* new objects:
@convolve, @inner, @for
* more samples: Fire, Ripple, Game of Life, Chroma Key, Convolve, Saturation
* much improved samples: Color Correction, Linear Transform.
* use [@store uint8] for low-ram storage of values 0-255.
* videodev: added option norm 0=pal 1=ntsc 2=secam 3=auto
version 0.2.2 (2001.08.15):
* @video_out auto-updates on X11 ExposeEvent
* updated documentation and help
* fixed installation/config of help and summary
* split BitPacking module from @video_out
* added support for BTTV input (that is, using mmap() command)
* new videodev options: channel,tuner,contrast,hue,etc.
* now with 30 binary operators, and 3 unary operators
* added many new samples
* new objects:
@!, @fold, @outer, @dim, @redim,
@posterize, @contrast, @two, @three,
@identity_transform, @scale_to, @spread
version 0.2.1 (2001.08.01):
* added private CVS repository on hostname.2y.net
* added configuration script (detects video4linux 1.x)
* added documentation in HTML format
* added File Format API
* format "ppm": PPM P6 RGB24 support read-write
* format "targa": Targa RGB24 support read-only
* format "videodev": Video4linux read (using read() command only)
* @store no longer slowing down its downstream
* many other accelerations
* Tuple changed to Dim; Index removed
* Grid element type is typedef Number
* @ supports grids in right inlet
* now there are 20 binary operators
version 0.2.0 (2001.05.05):
* package name changed from "video" to "video4jmax"
* new kind of post() cancels repetitive log entries
* major modifications to existing objects
* new "grid transmission system"
(Tuple,Index,GridInlet,GridOutlet,GridObject)
* vout -> @video_out
* vin_file -> @video_in_file
* vout_file -> @video_out_file
* added @import, @export
* added @, @store
version 0.1.1 (2001.04.03):
* removed vout's grab
* vout width and height parameters swapped
* vout_file class is mostly like vout but writes to a file in PPM format.
version 0.1.0 (2001.03.14):
* fixed the bits_per_pixel bug
* merged in some other variations on the main sample
* included Christian's makefiles for jmax 2.5
version 0.0.7 (2001.03.08):
* vout should support most types of RGB visuals now
* autodraw now works: 0=none; 1=page; 2=line; 3=pixel
* less global variables
* putting all of this under the GPL
version 0.0.5 (2001.03.05):
* vout class, two params: width, height; 24-bit BGR only; refresh by
finishing scanline or sending bang; "grab" (hack); "reset" for resetting
the pixel pointer.
--- NEW FILE: Makefile.gf ---
# $Id: Makefile.gf,v 1.1 2005/10/04 02:12:43 matju Exp $
# This is an annex that covers what is not covered by the generated Makefile
SYSTEM = $(shell uname -s | sed -e 's/^MINGW.*/NT/')
INSTALL_DATA = install -m 644
INSTALL_LIB = $(INSTALL_DATA)
INSTALL_DIR = mkdir -p
all2:: gridflow-for-puredata # doc-all
# suffixes (not properly used)
ifeq (1,1) # Linux, MSWindows with Cygnus, etc
OSUF = .o
LSUF = .so
ESUF =
else # MSWindows without Cygnus (not supported yet)
OSUF = .OBJ
LSUF = .DLL
ESUF = .EXE
endif
#----------------------------------------------------------------#
CFLAGS += -Wall # for cleanliness
# but it's normal to have unused parameters
#ifeq ($(HAVE_GCC3),yes)
#CFLAGS += -Wno-unused-parameter
#else
CFLAGS += -Wno-unused
#endif
ifeq ($(HAVE_DEBUG),yes)
CFLAGS += -O0 # debuggability
else
CFLAGS += -O3 -funroll-loops # speed
endif
CFLAGS += -fno-omit-frame-pointer
CFLAGS += -g # gdb info
CFLAGS += -fPIC # some OSes/machines need that for .so files
#----------------------------------------------------------------#
cpu/mmx.asm cpu/mmx_loader.c: cpu/mmx.rb
$(RUBY_INSTALL_NAME) cpu/mmx.rb cpu/mmx.asm cpu/mmx_loader.c
cpu/mmx.o: cpu/mmx.asm
nasm -f elf cpu/mmx.asm -o cpu/mmx.o
clean2::
rm -f $(OBJS) base/*.fcs format/*.fcs cpu/*.fcs
install2:: ruby-install puredata-install
(cd devices4ruby; make install)
uninstall:: ruby-uninstall
# add uninstallation of other files here.
unskew::
find . -mtime -0 -ls -exec touch '{}' ';'
kloc::
wc base/*.[ch] format/*.[cm] bridge/*.c optional/*.c 2>/dev/null
wc base/*.rb format/*.rb bridge/*.rb devices4ruby/*.rb \
optional/*.rb configure extra/*.rb 2>/dev/null
edit::
(nedit base/grid.[ch] base/number.c base/flow_objects.c \
base/flow_objects.rb base/main.c \
*/main.rb base/test.rb &)
CONF = config.make config.h Makefile
BACKTRACE = ([ -f core ] && gdb `which ruby` core)
TEST = base/test.rb math
test::
rm -f core
($(RUBY_INSTALL_NAME) -w $(TEST)) || $(BACKTRACE)
VALG = NO_MMX=1 valgrind --suppressions=extra/gf.valgrind2 -v
VALG += --num-callers=8
VALG += --show-reachable=yes
# VALG += --gdb-attach=yes
vtest::
rm -f core
($(VALG) $(RUBY_INSTALL_NAME) -w $(TEST) &> gf-valgrind) || $(BACKTRACE)
less gf-valgrind
vvtest::
rm -f core
($(VALG) --leak-check=yes $(RUBY_INSTALL_NAME) -w $(TEST) &> gf-valgrind) || $(BACKTRACE)
less gf-valgrind
test16:: test
(ruby-1.6.7 -w $(TEST)) || $(BACKTRACE)
testpd::
rm -f gridflow.pd_linux && make && \
rm -f /opt/lib/ruby/site_ruby/1.7/i586-linux/gridflow.so && \
make && make install && \
(pd -path . -lib gridflow test.pd || gdb `which pd` core)
munchies::
$(RUBY_INSTALL_NAME) base/test.rb munchies
foo::
@echo "LDSOFLAGS = $(LDSOFLAGS)"
#----------------------------------------------------------------#
ifeq ($(HAVE_PUREDATA),yes)
# pd_linux pd_nt pd_irix5 pd_irix6
ifeq (${SYSTEM},Darwin)
OS = DARWIN
PDSUF = .pd_darwin
PDBUNDLEFLAGS = -bundle -undefined suppress
else
ifeq (${SYSTEM},NT)
OS = NT
PDSUF = .dll
PDBUNDLEFLAGS = -shared -I$(PUREDATA_PATH)/src
PDLIB = -L/usr/local/lib $(LIBRUBYARG_SHARED) $(PUREDATA_PATH)/bin/pd.dll
else
OS = LINUX
PDSUF = .pd_linux
endif
endif
PD_LIB = gridflow$(PDSUF)
$(PD_LIB): bridge/puredata.c.fcs base/grid.h $(CONF)
$(CXX) -Ibundled/pd $(LDSOFLAGS) $(BRIDGE_LDFLAGS) $(CFLAGS) $(PDBUNDLEFLAGS) \
$< -xnone -o $@
gridflow-for-puredata:: $(PD_LIB)
DOK = $(PUREDATA_PATH)/doc/5.reference/gridflow
puredata-install::
mkdir -p $(DOK)/flow_classes
cp pd_help/*.pd $(DOK)
cp doc/*.html $(DOK)
cp doc/flow_classes/*.p* $(DOK)/flow_classes
cp -r images/ $(PUREDATA_PATH)/extra/gridflow
cp $(PD_LIB) pd_abstractions/*.pd $(PUREDATA_PATH)/extra
for z in camera_control motion_detection color mouse centroid centre_of_gravity fade \
apply_colormap_channelwise checkers contrast posterize ravel remap_image solarize spread \
rgb_to_greyscale greyscale_to_rgb rgb_to_yuv yuv_to_rgb; do \
cp pd_abstractions/\#$$z.pd $(PUREDATA_PATH)/extra/\(a)$$z.pd; done
mkdir -p $(PUREDATA_PATH)/extra/gridflow/icons
$(INSTALL_DATA) java/peephole.gif $(PUREDATA_PATH)/extra/gridflow/icons/peephole.gif
else
gridflow-for-puredata::
@#nothing
puredata-install::
@#nothing
endif # HAVE_PUREDATA
beep::
@for z in 1 2 3 4 5; do echo -ne '\a'; sleep 1; done
--- NEW FILE: COPYING ---
GNU GENERAL PUBLIC LICENSE
Version 2, June 1991
Copyright (C) 1989, 1991 Free Software Foundation, Inc.
59 Temple Place, Suite 330, Boston, MA 02111-1307 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 COPYING, 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
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., 59 Temple Place, Suite 330, Boston, MA 02111-1307 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.
--- NEW FILE: README ---
,-o----o----o----o-.
| GridFlow 0.8.0 |
`-o--------------o-'
|
.----------------------------------------------------------------
| Directory layout
./base ............. object classes written in C++ and Ruby
./bin .............. programs startable as applications
./bridge ........... connectors between Ruby and PureData/etc
./bundled .......... files from other packages, bundled here for convenience
./cpu .............. cpu-specific code
./CVSROOT .......... project information for version control
(not in official releases)
./format ........... format handlers written in C++ and Ruby (optional)
./devices4ruby ..... misc Ruby plugins for hardware interfaces
./doc .............. complete documentation in HTML, with XML source
./doc/images ....... images that go with the HTML doc
./extra ............ useful small programs (mostly in Ruby)
./images ........... sample images shared by ./samples, ./help, ./doc
./optional ......... optional classes but not format handlers
./pd_abstractions .. Pd object classes written in Pd
./pd_help .......... Pd-style help (old; the new goes in ./doc)
./pd_examples ...... more complex Pd programs showing off more practical uses.
Legalese
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.
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.
See file COPYING for further informations on licensing terms.
CVS
$Id: README,v 1.1 2005/10/04 02:12:43 matju Exp $
--- NEW FILE: TODO ---
/* $Id: TODO,v 1.1 2005/10/04 02:12:43 matju Exp $ */
matju cvs update -dP :
P format/quicktimeapple.c
cvs update: warning: pd_examples/binary_operations.pd was lost
C pd_examples/color_correction.pd
C pd_examples/convolve.pd
C pd_examples/drag_rectangle.pd
C pd_examples/eclipse.pd
C pd_examples/linear_transform.pd
C pd_examples/waves.pd
Checking in README;
/home/cvs/gridflow/README,v <-- README
new revision: 1.22; previous revision: 1.21
done
$helo_domain: web.artengine.ca
$from_address: matju(a)web.artengine.ca (matju)
loginfo.rb is writing changelog...done
loginfo.rb is parsing log message...done
loginfo.rb is testing modules...log info for `/home/cvs/gridflow/README' is not ready
done
loginfo.rb is composing a mail...done
loginfo.rb is posting email to gridflow ...ERROR: cannot send email using MTA on ns
450 <gridflow>: Recipient address rejected: User unknown in local recipient table
done
loginfo.rb is deleting tmp files...done
AMD64 :
char 1 1
short 2 2
int 4 4
long 4 8
long long 8 8
float 4 4
double 8 8
void * 4 8
<ClaudiusMaximus> hmm, sending a [reassign( message to the right inlet of a [#store] segfaults Pd
<ClaudiusMaximus> hmmm, i get a segfault with a simple patch sending "reassign, put_at ( 0 0 ), reassign" to the right inlet of [#store ( 3 3 # 0 )]
<alx1> matju: for the ./configure, I often get an error from aalib since common installs do not put the headers
<alx1> matju: would it be possible to make it a user defined choice like --with-aalib and turn it off by default?
<alx1> matju: not noticing that configure returns an error leads to an error when compiling
<alx1> back to the [display] object, it lingers for a moment after deletion
<alx1> and returns a 'pd_activate' error after I move it
<alx1> matju: once I delete it, unlike the other gui objects, it takes about one second before it dissapears, maybe a difference in tcl versions?
for 0.8.0:
drag_rectangle.pd is fucked (x11 error)
FObject#send_out2 : bself is NULL, rself=4097cbe8
[gf] ruby: ObjectSpace._id2ref(0x4097cbe8/2)
[gf] returns: #<GridFlow::FormatX11 [FormatX11 out]>
test with waves.pd, 24 by 32.
==1673== 809108 bytes in 187 blocks are still reachable in loss record 64 of 64
==1673== at 0x40026DAA: __builtin_vec_new (vg_replace_malloc.c:203)
==1673== by 0x40026E01: operator new[](unsigned) (vg_replace_malloc.c:216)
==1673== by 0x41FE269F: Grid::init(P<Dim>, NumberTypeE) (base/grid.h.fcs:910)
==1673== by 0x41FCBE27: Grid::init_from_ruby_list(int, unsigned long*, NumberTypeE) (base/grid.c.fcs:100)
==1673== by 0x41FCC679: Grid::init_from_ruby(unsigned long) (base/grid.c.fcs:117)
==1673== by 0x41FE223F: Grid::Grid(unsigned long) (base/grid.h.fcs:888)
==1673== by 0x42093152: convert(unsigned long, Grid**) (base/grid.h.fcs:921)
==1673== by 0x4208F72B: GridOuter::initialize_wrap(int, unsigned long*, unsigned long) (base/flow_objects.c.fcs:862)
[ ] try removing or modifying -falign on PPC/OSX
[ ] c++ typecasting is nuts (see class Pt<T>)
[ ] make c++ refcount and ruby gc to cooperate.
[ ] encoding of quicktime RGBA only works with [#cast b].
[ ] add classmethod support to source filter
[ ] document the source filter
[ ] make example on separable convkernels
[ ] add concepts of hot inlet and conf inlet at the code level
[ ] [display] should use clocks to update tk less often
[ ] [display] leaks in server ?
[ ] optional args don't work in source_filter.rb
[ ] deprecation warnings
[ ] Add a video latency patch (in examples)
[ ] can't have FPatcher and GridObject behaviour at once ??
[ ] Numop: warn on misalignment
[ ] wrap Dim (?)
[ ] wrap GridInlet (?)
[ ] wrap GridOutlet (?)
[ ] wrap Grid (?)
[ ] wrap Numop
[ ] remove GridInlet* ?
[ ] configure chokes if GCC3 doesn't have the C++ plugin
[ ] [#change]
[ ] [#import~]
[ ] [#export~]
[ ] [#expr]
[ ] 8-align STACK_ARRAY and ARRAY_NEW ?
[ ] #: option swap
[ ] consider including [mysql] [renamefile] [ls] [shell]
[ ] re-enable int64,float64
[ ] <alx_> #define RUBY_STACK_END "0xbfffd5c0" (!?!?!?)
[ ] remember who i am supposed to credit for making pd_help back in march 2003... alx knows
[ ] added #matrix_solve, #slice
[ ] Copy-on-Write (COW)
[ ] < 10 bugs in buglist
[ ] Fully hyperlinked manual
[ ] internals documentation
[ ] internal grid protocol redesigned
[ ] raise limit of in/outlets from 10 to 100 or unlimited.
[ ] unbork make test and plain ruby mode.
[ ] add support for "anything" methods (def _0_(sel,*a))
[ ] look into -ftree-vectorize
for 0.8.1:
* wrap Pd API completely.
* test.rb should become much more serious. (the @pack bug really sucked)
Bugs (High Priority) (!!! Fix all of these before 0.8.0 !!!)
pick a number: [147]
[147] [#store] blows up in nervous_video (reassign)
[146] [#peephole] resize problem
[145] "list -1"->[@import] only tells error message once every other time
[144] small leak remaining in x11. may have to do with non-use of XDestroyImage.
[141] shouldn't be able to call Pd from a non-main Ruby thread.
[140] is [@convolve] actually cross-convolution?
that is, convolves with a mirror image of the convolution matrix.
[139] [#peephole]
<mis> matju: BUG-ALERT - peephole does not delete until a screen refresh
<mis> matju: I was just about to do that
<mis> matju: it works... almost
<mis> matju: if you try to move the GOPed abstraction the peepholes don't move along
<mis> he :) better yet, the abstraction's bounding box's lower right corner will not move up or to the left of the low right corner of the peephole it contains. Instead it will resize itself as you move it around.
[138] [#peephole] crash
[137] [gf] peeperr: problem with set_geometry, wrong size.
[136] fix C_INCLUDE_PATH vs CPLUS_INCLUDE_PATH
[134] #import with zero size crashes?
[133] numop ** can freeze GF
[129] jmax2pd: [display] should not be translated
[128] jmax2pd(?): loadbang-messages (comma) don't get translated to .pd ??
[119] osx: SDL doesn't work here
[118] error messages can be unclear (eg. file not open... is it #in's, or #out's?)
[117] osx: [#store] crash instead of raising
[112] Pt<T>: some casts aren't done properly
[107] MMX computations may be done misaligned, which may be bad.
[105] when file not found, mpeg error messages are wrong, they say the filename is "".
[102] osx: error: shmget failed (cannot allocate memory) in X11, for regular pictures
[100] osx: libgridflow.so installs in wrong directory (of course)
[090] doesn't check whether ruby/version.h matches .so / .a
[027] tcp test is broken
[089] is LINK TO="..." not properly handled? see part of install.xml that uses it.
[088] FIX MOULINETTE.RB ! <attr name type default>
[078] "unsupported codec" bogus errors.
[097] bin/backtrace does not detect scripts
[005] can't open "": Success; loading a nonquicktime file using quicktime
[006] #in#open problem with String argument.
[010] separate bridge makefiles from other makefiles!!!
[011] research bugs in nonblock IO with Ruby. (eg. serial port)
[025] format_grid: write test for other bpv's
[026] latency is not that good. (GC ?)
[030] FormatGrid: not properly tested (crashes sometimes)
[031] stdout should be redirected if bridge is present
[032] error handling sometimes leads to crash
[033] error handling shows inanely useless messages (sometimes)
[034] format/mpeg3.c,quicktime.c might cause lockup on exit
[038] some seeds aren't typechecked
[039] jpeg file cat crashes on second file (jpeglib buffering?)
[040] GRID_FINISH triggered while backstore ???
Bugs (Low Priority)
[079] can trap segfaults in codecs of libquicktime.
[090] http://poynton.com/notes/colour_and_gamma/ColorFAQ.html#RTFToC30
[076] EINTR not handled properly in a lot of code?
[041] what would be a way to make GF work well with Pd's idea of a list?
[043] TCP server socket busy even after kill
[045] write unit tests about required functionality
[046] write unit tests about error checking
[047] make system to ensure everything is working before a release.
[048] potential issues between fork() and X11 ?
[050] BitPacking has trouble with masks that extend beyond int25be
[051] remove the crap given by -w of ruby
[054] it's possible to crash by sending data in two inlets of a same object at once
[059] mess with options in format grid
[060] look for "!@#$" in source
[029] #join on small chunks is way too slow
[009] T_DATA #dup #clone ???
--- make the development process more test-driven:
* file every feature request and bug report into base/test.rb so
that gridflow fails those tests;
* THEN make gridflow pass those tests.
===================
Community
[ ] put new examples on website
Distribution
[ ] should now plan which features are pre-1.0 and which are post-1.0
[ ] review all documentation
[ ] review all examples
[ ] make CDs
Installation
[ ] make the installer help the user more:
* .h was found
* compiled with .h correctly
* .so|.a was found
* linked with .so|.a correctly
[ ] installable doc
[ ] installable includes ?
[ ] produce linux binaries ("static")
[ ] produce cygwin32 or mingw32 binaries
[ ] produce macosx binaries
[ ] produce linux rpm/deb
[ ] less compile-time checks and more run-time checks
[ ] should GridFlow be bundled with some of its own dependencies?
[ ] reintroduce --puredata-dist-dir ?
[ ] --prefix (pour ruby)
[ ] install vs site-install mess
[ ] bridge should check that the gridflow.so file matches.
[ ] make uninstall
[ ] have option for gprof
[ ] cross-compile:
http://www.libsdl.org/extras/win32/cross/
http://rooster.stanford.edu/~ben/linux/cross.php
Documentation
[ ] make a short feature list as a promo
[ ] add credits
[ ] indiquer comment faire un rapport à propos d'une carte v4l ou d'un mode x11 non-supporté
[ ] project_policy.xml
[ ] specify policy for <help>, <icon>, etc.
[ ] things you type verbatim are all in KBD blocks
[ ] placeholders for your own values are all in I blocks
[ ] document our own release procedures, how our CVS works
[ ] document how to report bugs, basic troubleshooting
[ ] document our distribution of the archives
[ ] ascii conventions: [foo] vs "foo", etc.
[ ] document internals
[ ] describe indexmap in doc
[ ] document backward compatibility issues
[ ] typical uses: <typical></typical>
[ ] architecture: class->type/shape->use->role
[ ] it should be indicated whether an object is supported by pd/ruby/c++
[ ] heavily hyperlink documentation
[ ] automate more parts of the documentation
[ ] benchmarks (especially: simple video i/o)
[ ] mimic [pdp_help_input] [pdp_help_output]: they are convenient
--- remember to keep doc/help/screenshots/examples up to date
[ ] <jtm_> the suggestion would be to add a link at the end of each section leading to the next section
Source Filter
[ ] add \ruby \end blocks (multiline inlined rubyscripts)
[ ] \attr
Architecture
[0.8] <pat> aussi les erreurs que donne gf c'est beaucoup de ligne pour juste un file not found ;)
[0.8] reentrancy of objects (to allow true recursion)
[0.8] inlet-variables (variables associated to inlets)
[ ] eliminate the Dim class, replacing by Grid itself (?).
[ ] pull mode (functional-style)
[ ] bidirectional messages (constraint/relational-style)
[ ] send-reply messages (imperative-style)
[ ] add reflection (#global:classes, #global:methods, ...)
[ ] use MétaRuby typing to make things friendlier.
[ ] transmitting grids by diffs?
[0.8] dispatch on _n_-prefixed methods (one selector any inlet)
and _#{i}_-named methods (any selector one inlet)
[0.8] generalize the backstore
[ ] Outlet#buffer should harmonise with the lcm of its corresponding Inlet#factor's.
[ ] lazy grids: Grid#operator Pt<T> makes sure all the grid is received
and Grid#range(int start, int n, T bogus) makes sure the
specified part of the grid is received.
[0.8] accounting: grids messages packets numbers bytes copybytes
[0.8] memory profiling
[0.8] compare Ruby API with both flext/pyext
[ ] add a "query" class for debugging other objects?
(would be able to extract extra info from each object/class)
[ ] add a GridFlow::LaterException or something
(which tells to retry later with the same packet because another
grid reception is not completed yet.)
[ ] interpret nested lists as n-dimensional.
[0.8] MMX memcpy() ?
[0.8] MMX _runtime_ autodetection
Operators
[ ] User-defined operators; compound operators... e.g. [# {{* 7} + {>> 3}}]
[ ] n-ary operators... make [#] variable-inlet
[ ] binary ops to replace unaries : rand -> ???, sqrt -> ???
[ ] trinary ops? eg. */ *>> *+ ?: minmax &<< >>&
[ ] numop2: rol, ror
[ ] numop1: weight (in bits)
Bridge
[ ] UnknownAtom class
[ ] Pd bridge should support list-literals inside messages
[ ] GFBridge object visible from Ruby
Computation Objects
[ ] #counter (similar to #for)
[ ] #inner inlet 2 -> 1, and other incompatibilities i wanted to introduce
[ ] #for "step" argument should have default {1...}
[ ] zero option in #convolve (?)
[ ] #convolve2 (simpler)
[ ] #convolve rewritten as combination of #convolve2+#border ?
[ ] #convolve(2): should allow n-D convolution
[ ] #complex_sq is backwards
[ ] #store: option zero (?)
[ ] #import~, #export~
[ ] #fold, #scan: option reverse (right-to-left)
[ ] #join: option swap
[ ] #matrix_inverse, #matrix_solve
[ ] #reverse (on given dimension number)
[ ] #timeline (or rtmetro): sequencing of events from grid
[ ] #replace_if, #random_select, #markov_chain, #unpack, #sort, #slice, #splice
[ ] #polygon_perimeter, #polygon_area, #draw_polygon smoothly
[ ] fuzzy #store (interpolate)
[ ] write a complete benchmark script
[ ] spatial biquads (ask Tom)
[ ] string operations to compensate for the feebleness of PD in that area.
this includes [#sprintf].
[ ] #pack should become type-conscious (cast option, like #import)
--- see also APL/J/NArray/PDL/Aplus/Yorick/IPOW reference
Effects
[ ] #mosaic
[ ] #gaussian_blur, #sobel, #pixelize, #despeckle (median)
[ ] #dither, #draw_lines, #draw_points, #fire, #border, #queue
[ ] #chroma_key: i0=RGBpicture i1=RGBcolor i2=tolerance o0=RGBApicture
with fuzzy flag; (don't call it #chroma_key though)
maybe #mask...
[ ] turtle (logo style)
[ ] effectv
[ ] create abstractions for usage patterns (eg: like @remap_image)
[ ] see gimp for ideas
[ ] kaleidoscopes
[ ] FFTW
[ ] bilinear interpolation a+(b-a)*x+(c-a)*y+(a-b-c+d)*x*y (#scale_by smoothly?)
[ ] #scale_by/#downscale_by fractional values
[ ] bicubic interpolation
[ ] multilinear interpolation (n-dimensional?)
[ ] #daltonism
[ ] #perlin ?
Input/Output
[ ] replace "open <driver> <source> <filename>" by "open <driver> <mrl>"
[ ] videodev: is it possible to reach 60 fps ?
[ ] a #store that is persistent (saved in .pd) ?
[ ] Grid: support storage in all six types
[ ] Grid: bpv 1,2,4 uint
[ ] Grid: text version of the format
[ ] Gimp, GStreamer, ffmpeg, xine, mplayer, GEM, PDP, OSC
[ ] RubyX11 0.6
[ ] support for output inside of a GUI app (Tk/Gtk/Qt/...)
[ ] get subtitling of tv channels
[ ] add messages "load", "save" as open,bang,close combos. (?)
[ ] use 1.8.0's IO#read(Integer,String)->String
[ ] SDL: should support multiple windows
[ ] x11,sdl,aalib: use buffering to synchronise frames at a constant rate.
[ ] x11: sync with the actual vsync of the monitor
[ ] x11: maybe vram-to-vram copy using X11's Pixmap remote-objects
[ ] shell object?
[ ] #import, 'grid tcp': option: sudden vs gradual transmission through gridflow.
[ ] HPGL, [unixtime]
[ ] [parallel_port], [serial_port], [usb_mouse]
Format
[ ] remaining number type support in formats
[ ] all: possibly get rid of the "format" notion ?
[ ] PNM: P1,P2,P3,P4,P5 support
[ ] XBM, XPM, GIF support
[ ] fork: pseudoformat for launching format handler as separate process
[ ] put_at/reassign in x11/sdl/quartz
[ ] /dev/dsp, /dev/mixer
[ ] Generic SHM/MMAP Drivers
[ ] "open grid pipe" and such.
[ ] TCP: non-blocking write
[ ] TCP: buffer n grids
[ ] multi: multi-file (by glob pattern, e.g.: foo*.ppm)
[ ] AVI
[ ] format grid: "headerless until 10" (text files)
User Interface
[ ] color picker
[ ] gridbox (akin to intbox) or grid edition dialog, etc.
[ ] peephole:
[ ] works without x11 (for osx...)
[ ] does it really work with something other than 3 channels ?
[ ] add a popup menu that makes sense
[ ] make ruby/tcl evaluator boxes retractable
[ ] vector slider (n parallel sliders in one, Dim(n))
[ ] 2d slider
[ ] radial slider (angle chooser)
[ ] drag-and-drop palette of object construction
[ ] object construction menu specialized for each class
(generated from class reflection/metadata)
Extra/Examples/Etc
[ ] make demo app(s) in Ruby/Tk: bin/playmovie
[ ] .pd: read; write better
[ ] examples/generique.pd
[ ] add examples from the workshop, etc
how about creating aliases like "open window" = "open x11 here" (or arbitrary
user-defined sequence of messages settable in ~/.gridflow_startup) and "open
videodev" -> "open videodev /dev/video0, option channel 1, option size 240 320"
maybe there should be a separate ~/.gridflow_config that would be saveable from
gridflow, and ~/.gridflow_startup would be edited only by the user but
~/.gridflow_config would still be a text file. i say that
because the startup is a ruby script so gridflow couldn't just do
search-and-replace in there, because the option could be inside a "if"
expression and such... at most, gridflow could _append_ text to
.gridflow_startup, to be non-intrusive...
Feature Requests
From: Dave Bergevin <dabergevin(a)eisa.com>
[ ] synchronized audio with the video when using mpeg1 & 2
[ ] full screen mode (without the menu bars or frames)
From: Alexandre Castonguay <acastonguay(a)artengine.ca>
[ ] server side pd to handle multiple incoming commands, audio + video streams
[ ] support for audio in the mpeg streams
<matju> alx:
le tab completion ne donnerait pas seulement les noms possibles pour le
prochain argument dans le objectbox; il donnerait aussi une description de
l'argument (surtout dans le cas où l'argument a beaucoup de valeurs
possibles)
je pense que le help de Pd est une bonne idée (le concept hands-on)
mais ça pourrait aller plus loin.
j'ai pensé intégrer le manuel de référence de gridflow directement dans
le programme, disponible au runtime, dans l'éventualité d'un GUI qui
saurait en tirer avantage. sinon on pourrait faire des hacks cool genre un
message "help" au inlet 0 enverrait une description de la classe dans le log.
(sauf que dans ce cas: [rubyprint] est tenu d'afficher directement tout
ce qu'il reçoit. alors doit-il écrire "help" ou écrire le help ?
alx1->matju: détection de plusieurs personnes; détection avec deux caméras
(?); détecter les formes; détecter les couleurs; support mpeg4; hotspots
> http://redshift.sourceforge.net/debugging-GC/ [ruby-talk:53835]
> You might also want to search the web for "malloc debugger".
... I am Jack's Overwritten Stack Pointer...
<ircbridge> <GPS> Tcl_GetObjResult Tcl_GetErrorInfo ...
<ircbridge> <GPS> Tcl_GetStringResult may also be helpful. (note I can't
seem to find Tcl_GetErrorInfo (maybe I dreamed it up))
<ircbridge> <GPS> matju: BTW CatchObjCmd might help too
<ircbridge> <GPS> I see that the new Tcl_Dict commands have taken over the HEAD's CatchObjCmd
ClaudiusMaximus reports that allocating a 197M grid causes a crash (turns out C++
throws exception, can't allocate, signal ABRT)
ClaudiusMaximus says: I want to be able to send output from Pd+Gridflow to a video4linux
loopback device so that other v4l programs can access the stream.
I found the video loopback device here: http://motion.sourceforge.net/vloopback/
<alx2> matju: iSight on linux :
http://episteme.arstechnica.com/6/ubb.x?a=tpc&s=50009562&f=8300945231&m=401…
<alx2> matju: apparently it needs something called 'coriander'...I'm checking into it
<alx2> matju: the person who got it working mentions libdc1394
<alx2> matju: ah coriander is a GUI for firewire
<alx2> matju: on this page :
http://www.tele.ucl.ac.be/PEOPLE/DOUXCHAMPS/ieee1394/cameras/index.html
<alx2> matju: I learn that the iSight is compliant with version 1.30 of IIDC
<alx2> matju: the docs for coriander mention that the author needed to create a major and minor device for the camera.
<alx2> matju: retyping (damn pdf's) -> there are two devices to create: raw1394 and video1394
<alx2> matju: raw1394 has major 171 and minor 0 while video1394 had major 171 and minor 16
<matju> thanks
<alx2> matju: any useful info?
<matju> i'll see, doing something else at the moment
<alx2> matju: having a camera like the iSight supported could be fantastic for video capture/detection on a laptop. Not to mention that the bttv cards are getting harder to locate
-mfpmath=sse2
<MiS> <matju> alx2: btw you cannot set helpfiles explicitly on _abstractions_...
<MiS> yes you can
<MiS> and specify -helppath to add a path to help. So selecting 'Help'
in the pop-up on an abstraction will open a help fiel for that abstraction
"Bangs in a geiger counter have a l*dt probability of occuring
in a dt time interval. Therefore the time till the next event
follows a Exp(l) law, for which:
f(t) = l*exp(-l*t)
F(t) = integral of l*exp(-l*t)*dt = 1-exp(-l*t)
F^-1(p) = -log(1-p)/l
//return (uint64)(1000LL*ms*-log(1-drand()));"
matju 2002
remember to check for volatile VALUEs if GC problems ever occur
ruby -ve '[30,31,62,63].each {|x| printf "%d bits: %s\n",x,(1<<(x-1)).class }'
linx:
http://cast.rubyforge.org (parsing C code)
http://ruby-contract.rubyforge.org/doc/
sand.pd differential mode, 0.8:
fps min med max avg stdev
17.57 54.82 55.81 78.00 56.89 3.93 : before
after ...
1
0
Update of /cvsroot/pure-data/externals/gridflow/bundled/pd
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv23183/pd
Log Message:
Directory /cvsroot/pure-data/externals/gridflow/bundled/pd added to the repository
1
0
Update of /cvsroot/pure-data/externals/gridflow/doc
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv22912/doc
Added Files:
architecture.html architecture.xml format.html format.xml
index.html install.html install.xml internals.html
internals.xml introduction.html license.html profiling.html
project_policy.html project_policy.xml reference.html
reference.xml
Log Message:
adding documentation in xml and html
--- NEW FILE: internals.html ---
<html><head>
<!-- $Id: internals.html,v 1.1 2005/10/04 02:09:42 matju Exp $ -->
<title>GridFlow 0.8.0 - C++/Ruby Internals</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<link rel="stylesheet" href="gridflow.css" type="text/css">
</head>
<body bgcolor="#FFFFFF"
leftmargin="0" topmargin="0"
marginwidth="0" marginheight="0">
<table width="100%" bgcolor="white" border="0" cellspacing="2">
<tr><td colspan="4" bgcolor="#082069">
<img src="images/titre_gridflow.png" width="253" height="23">
</td></tr><tr><td> </td></tr>
<tr><td colspan="4" bgcolor="black">
<img src="images/black.png" width="1" height="2"></td></tr>
<tr><td colspan="4" height="16">
<h4>GridFlow 0.8.0 - C++/Ruby Internals</h4>
</td></tr>
<tr>
<td width="5%" rowspan="2"> </td>
<td width="15%" height="23"> </td>
<td width="80%" height="23"> </td>
<td width="5%" height="23"> </td>
</tr>
<tr><td colspan="2"><div cols="1"><h4><a href="#notes">notes</a></h4><ul>
</ul>
<h4><a href="#Objects_for_Scripting">Objects for Scripting</a></h4><ul>
<li><a href="#ruby class FObject extending Data"><img src="flow_classes/ruby class FObject extending Data-icon.png" alt="[ruby class FObject extending Data]" border="0"></a></li>
<li><a href="#ruby class GridObject extending FObject"><img src="flow_classes/ruby class GridObject extending FObject-icon.png" alt="[ruby class GridObject extending FObject]" border="0"></a></li>
<li><a href="#ruby class BitPacking"><img src="flow_classes/ruby class BitPacking-icon.png" alt="[ruby class BitPacking]" border="0"></a></li>
<li><a href="#ruby FPatcher extending FObject"><img src="flow_classes/ruby FPatcher extending FObject-icon.png" alt="[ruby FPatcher extending FObject]" border="0"></a></li>
<li><a href="#ruby GridFlow::USB"><img src="flow_classes/ruby GridFlow::USB-icon.png" alt="[ruby GridFlow::USB]" border="0"></a></li>
<li><a href="#ruby GridFlow::USB::Device"><img src="flow_classes/ruby GridFlow::USB::Device-icon.png" alt="[ruby GridFlow::USB::Device]" border="0"></a></li>
<li><a href="#ruby GridFlow::USB::Config"><img src="flow_classes/ruby GridFlow::USB::Config-icon.png" alt="[ruby GridFlow::USB::Config]" border="0"></a></li>
<li><a href="#ruby GridFlow::USB::Interface"><img src="flow_classes/ruby GridFlow::USB::Interface-icon.png" alt="[ruby GridFlow::USB::Interface]" border="0"></a></li>
<li><a href="#ruby GridFlow::USB::Endpoint"><img src="flow_classes/ruby GridFlow::USB::Endpoint-icon.png" alt="[ruby GridFlow::USB::Endpoint]" border="0"></a></li>
</ul>
<h4><a href="#Objects_for_Internals">Objects for Internals</a></h4><ul>
<li><a href="#C++ class GridInlet"><img src="flow_classes/C++ class GridInlet-icon.png" alt="[C++ class GridInlet]" border="0"></a></li>
<li><a href="#C++ class GridOutlet"><img src="flow_classes/C++ class GridOutlet-icon.png" alt="[C++ class GridOutlet]" border="0"></a></li>
<li><a href="#C++ class Dim"><img src="flow_classes/C++ class Dim-icon.png" alt="[C++ class Dim]" border="0"></a></li>
<li><a href="#C++ class Grid"><img src="flow_classes/C++ class Grid-icon.png" alt="[C++ class Grid]" border="0"></a></li>
<li><a href="#C++ class Numop1"><img src="flow_classes/C++ class Numop1-icon.png" alt="[C++ class Numop1]" border="0"></a></li>
<li><a href="#C++ class Numop2"><img src="flow_classes/C++ class Numop2-icon.png" alt="[C++ class Numop2]" border="0"></a></li>
<li><a href="#C++ class GridClass"><img src="flow_classes/C++ class GridClass-icon.png" alt="[C++ class GridClass]" border="0"></a></li>
<li><a href="#C++ class GFBridge"><img src="flow_classes/C++ class GFBridge-icon.png" alt="[C++ class GFBridge]" border="0"></a></li>
</ul>
<br><br>
</div></td></tr> <tr><td colspan="4" bgcolor="black">
<img src="images/black.png" width="1" height="2"></td></tr>
<tr><td colspan="4"><a name="notes"></a><h4>notes</h4></td></tr><tr><td></td><td></td><td> </td></tr>
<tr><td></td><td></td><td><p>In Ruby, GridFlow defines a namespace (module) called GridFlow. Most of the
constants it defines are part of that namespace.</p></td></tr>
<tr><td></td><td></td><td> </td></tr>
<tr><td></td><td></td><td><p>Ruby does not have the same concept of object as PD. In GridFlow, object classes may
inherit features from other object classes, and also there is no concept of inlet nor outlet, which are instead
provided by <kbd><font color="#007777">GridFlow::FObject</font></kbd>, which also has the purpose of exporting functionality to
PD.</p></td></tr>
<tr><td></td><td></td><td> </td></tr>
<tr><td></td><td></td><td><p>In this document (and in many others) the phrase "a Potato" will be a shorthand for "an object of the class
called Potato", which is often used in modern software design and is a nice convention borrowed from
biology.</p></td></tr>
<tr><td></td><td></td><td> </td></tr>
<tr><td></td><td></td><td><p>
A FObject is normally in two or three parts: a (Ruby) GridFlow::FObject
that is the central part; a (C++) FObject; a (C++) BFObject.
The GridFlow::FObject is created as a RData kind of box (T_DATA)
using Ruby-C's Data_Make_Struct on a GridObject. This is
how most Ruby-C programs inherit from Ruby classes. Note that
Ruby's boxed objects have a maximum of five fields, and they're usually
taken, so additional fields have to be outside of it. This is why RData exists. </p></td></tr>
<tr><td></td><td></td><td> </td></tr>
<tr><td></td><td></td><td><p>
So basically you have a C++ FObject that is "part of" a GridFlow::FObject
and they point to each other using "peer pointers".
The BFObject links back to the RData box through a pointer called peer. </p></td></tr>
<tr><td></td><td></td><td> </td></tr>
<tr><td> </td></tr>
<tr><td colspan="4" bgcolor="black">
<img src="images/black.png" width="1" height="2"></td></tr>
<tr><td colspan="4"><a name="Objects_for_Scripting"></a><h4>Objects for Scripting</h4></td></tr><tr><td></td><td></td><td> </td></tr>
<tr><td colspan="4" bgcolor="#ffb080"><b> class </b><a name="ruby class FObject extending Data">ruby class FObject extending Data</a></td></tr><tr><td></td><td valign="top"><br>
<br clear="left"><br><br><br clear="left"><br></td><td><br>
Provides inlets and outlets to Ruby Objects. <br><b>method</b> init <b>(</b><b>)</b> <br>
<br><b>method</b> send_in <b>(</b><i>int</i> inlet<b>, </b>message...<b>)</b> <br>
<br><b>method</b> send_out <b>(</b><i>int</i> outlet<b>, </b>message...<b>)</b> <br>
<br></td></tr><tr><td></td><td></td><td> </td></tr>
<tr><td colspan="4" bgcolor="#ffb080"><b> class </b><a name="ruby class GridObject extending FObject">ruby class GridObject extending FObject</a></td></tr><tr><td></td><td valign="top"><br>
<br clear="left"><br><br><br clear="left"><br></td><td><br>
Provides grid support to FObjects. <br><b>method</b> inlet_dim <b>(</b><i>Integer</i> inlet<b>)</b>
gives an array of Integers (dimension list) <br>
<br><b>method</b> inlet_nt <b>(</b><i>Integer</i> inlet<b>)</b>
gives a Symbol (number type) <br>
<br><b>method</b> inlet_set_factor <b>(</b><i>Integer</i> inlet<b>, </b><i>Integer</i> factor<b>)</b>
ensures received packets have a size that is
a whole multiple of this size.
must be called from rgrid_begin. <br>
<br><b>method</b> send_out_grid_begin <b>(</b><i>Integer</i> outlet<b>, </b><i>Array of Integer</i> dimensions<b>, </b><i>number type</i> nt<b>)</b>
establishes grid streams between an outlet and all inlets
connected to it. <br>
<br><b>method</b> send_out_grid_flow <b>(</b><i>Integer</i> outlet<b>, </b><i>String</i> data<b>)</b>
for sending a grid data packet through that outlet. <br>
<br><b>method</b> send_out_grid_end <b>(</b><i>Integer</i> outlet<b>)</b>
(isn't this one obsolete?) <br>
<br><b>inlet 0 </b><b>method</b> rgrid_begin <b>(</b><b>)</b> <br>
<br><b>inlet 0 </b><b>method</b> rgrid_flow <b>(</b><i>String</i> data<b>)</b> <br>
<br><b>inlet 0 </b><b>method</b> rgrid_end <b>(</b><b>)</b> <br>
<br></td></tr><tr><td></td><td></td><td> </td></tr>
<tr><td colspan="4" bgcolor="#ffb080"><b> class </b><a name="ruby class BitPacking">ruby class BitPacking</a></td></tr><tr><td></td><td valign="top"><br>
<br clear="left"><br><br><br clear="left"><br></td><td><br>
A BitPacking is a simple two-way converter between different
numeric layouts. <br></td></tr><tr><td></td><td></td><td> </td></tr>
<tr><td colspan="4" bgcolor="#ffb080"><b> class </b><a name="ruby FPatcher extending FObject">ruby FPatcher extending FObject</a></td></tr><tr><td></td><td valign="top"><br>
<br clear="left"><br><br><br clear="left"><br></td><td><br>
<p>This class is much like PureData's abstractions.</p> <p>This is a container for objects. Its proper objects are numbered
starting with zero. The wire list is given in terms of those numbers:
(sourceobject,sourceinlet,destobject,destinlet). There is a
pseudo-object numbered #-1 which map to the container's own inlets
and outlets.</p> <br></td></tr><tr><td></td><td></td><td> </td></tr>
<tr><td colspan="4" bgcolor="#ffb080"><b> class </b><a name="ruby GridFlow::USB">ruby GridFlow::USB</a></td></tr><tr><td></td><td valign="top"><br>
<br clear="left"><br><br><br clear="left"><br></td><td><br>
<p>wrapper for struct usb_dev_handle</p> <br><b>attr</b> .busses <b>(</b><b>.busses</b><b>)</b> <br></td></tr><tr><td></td><td></td><td> </td></tr>
<tr><td colspan="4" bgcolor="#ffb080"><b> class </b><a name="ruby GridFlow::USB::Device">ruby GridFlow::USB::Device</a></td></tr><tr><td></td><td valign="top"><br>
<br clear="left"><br><br><br clear="left"><br></td><td><br>
<p>wrapper for struct usb_device and struct usb_device_descriptor</p> <br></td></tr><tr><td></td><td></td><td> </td></tr>
<tr><td colspan="4" bgcolor="#ffb080"><b> class </b><a name="ruby GridFlow::USB::Config">ruby GridFlow::USB::Config</a></td></tr><tr><td></td><td valign="top"><br>
<br clear="left"><br><br><br clear="left"><br></td><td><br>
<p>wrapper for struct usb_config_descriptor, struct usb_interface</p> <br></td></tr><tr><td></td><td></td><td> </td></tr>
<tr><td colspan="4" bgcolor="#ffb080"><b> class </b><a name="ruby GridFlow::USB::Interface">ruby GridFlow::USB::Interface</a></td></tr><tr><td></td><td valign="top"><br>
<br clear="left"><br><br><br clear="left"><br></td><td><br>
<p>wrapper for struct usb_interface_descriptor</p> <br></td></tr><tr><td></td><td></td><td> </td></tr>
<tr><td colspan="4" bgcolor="#ffb080"><b> class </b><a name="ruby GridFlow::USB::Endpoint">ruby GridFlow::USB::Endpoint</a></td></tr><tr><td></td><td valign="top"><br>
<br clear="left"><br><br><br clear="left"><br></td><td><br>
<p>wrapper for struct usb_endpoint_descriptor</p> <br></td></tr><tr><td></td><td></td><td> </td></tr>
<tr><td> </td></tr>
<tr><td colspan="4" bgcolor="black">
<img src="images/black.png" width="1" height="2"></td></tr>
<tr><td colspan="4"><a name="Objects_for_Internals"></a><h4>Objects for Internals</h4></td></tr><tr><td></td><td></td><td> </td></tr>
<tr><td colspan="4" bgcolor="#ffb080"><b> class </b><a name="C++ class GridInlet">C++ class GridInlet</a></td></tr><tr><td></td><td valign="top"><br>
<br clear="left"><br><br><br clear="left"><br></td><td><br>
GridInlets represent inlets that accept grids. <br></td></tr><tr><td></td><td></td><td> </td></tr>
<tr><td colspan="4" bgcolor="#ffb080"><b> class </b><a name="C++ class GridOutlet">C++ class GridOutlet</a></td></tr><tr><td></td><td valign="top"><br>
<br clear="left"><br><br><br clear="left"><br></td><td><br>
GridOutlets represent outlets that send grids. <br></td></tr><tr><td></td><td></td><td> </td></tr>
<tr><td colspan="4" bgcolor="#ffb080"><b> class </b><a name="C++ class Dim">C++ class Dim</a></td></tr><tr><td></td><td valign="top"><br>
<br clear="left"><br><br><br clear="left"><br></td><td><br>
Dim represents a list of dimensions. <br></td></tr><tr><td></td><td></td><td> </td></tr>
<tr><td colspan="4" bgcolor="#ffb080"><b> class </b><a name="C++ class Grid">C++ class Grid</a></td></tr><tr><td></td><td valign="top"><br>
<br clear="left"><br><br><br clear="left"><br></td><td><br>
Grid represents a grid that is fully stored in memory. <br></td></tr><tr><td></td><td></td><td> </td></tr>
<tr><td colspan="4" bgcolor="#ffb080"><b> class </b><a name="C++ class Numop1">C++ class Numop1</a></td></tr><tr><td></td><td valign="top"><br>
<br clear="left"><br><br><br clear="left"><br></td><td><br>
This represents a one-input operator.
Such an object contains a map() function that applies the operator
over a memory segment. <br></td></tr><tr><td></td><td></td><td> </td></tr>
<tr><td colspan="4" bgcolor="#ffb080"><b> class </b><a name="C++ class Numop2">C++ class Numop2</a></td></tr><tr><td></td><td valign="top"><br>
<br clear="left"><br><br><br clear="left"><br></td><td><br>
This represents a two-input operator.
Such an object contains four functions for each T, where
T is one of the types uint8, int16, int32, float32. <br><b>method</b> map <b>(</b><i>integer</i> n<b>, </b><i>Pt<T></i> as<b>, </b><i>T</i> b<b>)</b>
for i in 0...n,
as[i] := f(as[i],b);
This is like <kbd><font color="#007777">[#]</font></kbd> with a scalar righthand <br>
<br><b>method</b> zip <b>(</b><i>integer</i> n<b>, </b><i>Pt<T></i> as<b>, </b><i>Pt<T></i> bs<b>)</b>
for i in 0...n,
as[i] := f(as[i],bs[i]);
bs is not modified.
(This is like <kbd><font color="#007777">[#]</font></kbd> with a nonscalar righthand) <br>
<br><b>method</b> fold <b>(</b><i>integer</i> an<b>, </b><i>integer</i> n<b>, </b><i>Pt<T></i> as<b>, </b><i>Pt<T></i> bs<b>)</b> <p>
for i in 0...n,
for j in 0...an,
as[j] := f(as[j],bs[i*an+j]); </p>
(this is like <kbd><font color="#007777">[#fold]</font></kbd>) <br>
<br><b>method</b> scan <b>(</b><i>integer</i> an<b>, </b><i>integer</i> n<b>, </b><i>Pt<T></i> as<b>, </b><i>Pt<T></i> bs<b>)</b> <p> for j in 0...an: bs[j] := f(as[j],bs[j]); </p> <p> for i in 1...n: for j in 0...an:
bs[j] := f(bs[(i-1)*an+j],bs[i*an+j]); </p>
(this is like <kbd><font color="#007777">[#scan]</font></kbd>) <br>
<br></td></tr><tr><td></td><td></td><td> </td></tr>
<tr><td colspan="4" bgcolor="#ffb080"><b> class </b><a name="C++ class GridClass">C++ class GridClass</a></td></tr><tr><td></td><td valign="top"><br>
<br clear="left"><br><br><br clear="left"><br></td><td><br>
This represents a class of GridObjects. <br></td></tr><tr><td></td><td></td><td> </td></tr>
<tr><td colspan="4" bgcolor="#ffb080"><b> class </b><a name="C++ class GFBridge">C++ class GFBridge</a></td></tr><tr><td></td><td valign="top"><br>
<br clear="left"><br><br><br clear="left"><br></td><td><br>
This holds linkage information about PureData. <br></td></tr><tr><td></td><td></td><td> </td></tr>
<tr><td> </td></tr>
<td colspan="4" bgcolor="black">
<img src="images/black.png" width="1" height="2"></td></tr>
<tr><td colspan="4">
<p><font size="-1">
GridFlow 0.8.0 Documentation<br>
Copyright © 2001,2002,2003,2004,2005 by Mathieu Bouchard
<a href="mailto:matju@sympatico.ca">matju(a)artengine.ca</a>
</font></p>
</td></tr></table></body></html>
--- NEW FILE: install.html ---
<html><head>
<!-- $Id: install.html,v 1.1 2005/10/04 02:09:42 matju Exp $ -->
<title>GridFlow 0.8.0 - Installation</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<link rel="stylesheet" href="gridflow.css" type="text/css">
</head>
<body bgcolor="#FFFFFF"
leftmargin="0" topmargin="0"
marginwidth="0" marginheight="0">
<table width="100%" bgcolor="white" border="0" cellspacing="2">
<tr><td colspan="4" bgcolor="#082069">
<img src="images/titre_gridflow.png" width="253" height="23">
</td></tr><tr><td> </td></tr>
<tr><td colspan="4" bgcolor="black">
<img src="images/black.png" width="1" height="2"></td></tr>
<tr><td colspan="4" height="16">
<h4>GridFlow 0.8.0 - Installation</h4>
</td></tr>
<tr>
<td width="5%" rowspan="2"> </td>
<td width="15%" height="23"> </td>
<td width="80%" height="23"> </td>
<td width="5%" height="23"> </td>
</tr>
<tr><td colspan="2"><div cols="1"><h4><a href="#Hardware_and_Software_you_Probably_Need">Hardware and Software you Probably Need</a></h4><ul>
</ul>
<h4><a href="#Downloading_from_CVS">Downloading from CVS</a></h4><ul>
</ul>
<h4><a href="#Installation_instructions_(incl._compilation)">Installation instructions (incl. compilation)</a></h4><ul>
</ul>
<h4><a href="#Other_Tips">Other Tips</a></h4><ul>
</ul>
<br><br>
</div></td></tr> <tr><td colspan="4" bgcolor="black">
<img src="images/black.png" width="1" height="2"></td></tr>
<tr><td colspan="4"><a name="Hardware_and_Software_you_Probably_Need"></a><h4>Hardware and Software you Probably Need</h4></td></tr><tr><td></td><td></td><td> </td></tr>
<tr><td></td><td></td><td><p>Required Computer/Processor (one of...):<ul> <li><b>1</b> : PC : AMD K6/K7/K8 or Intel P2/P3/P4 (absolute minimum is 386)</li> <li><b>2</b> : Macintosh : G3/G4/G5</li> <li><b>3</b> : Corel NetWinder : StrongARM V4L</li> <li><b>4</b> : HP iPaq : some processor that works like the NetWinder</li> <li><b>5</b> : could work on SiliconGraphics and SPARCstation with a little nurture.</li> </ul></p></td></tr>
<tr><td></td><td></td><td> </td></tr>
<tr><td></td><td></td><td><p>Required OS (one of...):<ul> <li><b>1</b> : Linux (most any variant) (recommended)</li> <li><b>2</b> : MacOS 10.2 or later (experimental)</li> <li><b>3</b> : Windows with MinGW (very experimental)</li> </ul></p></td></tr>
<tr><td></td><td></td><td> </td></tr>
<tr><td></td><td></td><td><p>Required Software:<ul> <li><b>1</b> : Ruby 1.6.6 or more recent (1.8.0 recommended) (make sure you have the *.so and *.h files)
(on MacOS you may have to remove or hide the existing one and install a more complete package)</li> </ul></p></td></tr>
<tr><td></td><td></td><td> </td></tr>
<tr><td></td><td></td><td><p>Dataflow Software :<ul> <li><b>1</b> : PureData 0.36 or later (recommended)</li> </ul></p></td></tr>
<tr><td></td><td></td><td> </td></tr>
<tr><td></td><td></td><td><p>Multimedia Components (optional):<ul> <li><b>1</b> : libSDL (Simple Directmedia Layer)</li> <li><b>2</b> : libjpeg</li> <li><b>3</b> : libpng</li> <li><b>4</b> : libmpeg3 (.mpg reader, HeroineWarrior's)</li> <li><b>5</b> : libquicktime (.mov reader/writer, Burkhard Plaum's or HeroineWarrior's) </li> <li><b>6</b> : libmpeg (.mpg reader, Greg Ward's, old)</li> <li><b>7</b> : Apple QuickTime (.mov reader/writer)</li> <li><b>8</b> : Ascii Art Library (aalib)</li> <li><b>9</b> : PCI video digitizer card (and Video4linux 1 driver)</li> <li><b>10</b> : USB camera (and Video4linux 1 driver)</li> </ul></p></td></tr>
<tr><td></td><td></td><td> </td></tr>
<tr><td></td><td></td><td><p>Developer Tools (roll-your-own):<ul> <li><b>1</b> : GNU C++ Compiler (gcc/g++) version 3.x or maybe 2.95</li> <li><b>2</b> : GNU Make (gmake)</li> <li><b>3</b> : CVS (for upgrading/collaboration)</li> <li><b>4</b> : Ruby library "xmlparser" (optional, for editing documentation)</li> <li><b>5</b> : Developer Tools CD dec 2002 (if MacOS 10.2)</li> <li><b>6</b> : XCODE (if MacOS 10.3)</li> <li><b>7</b> : FINK (if MacOS 10)</li> </ul></p></td></tr>
<tr><td></td><td></td><td> </td></tr>
<tr><td></td><td></td><td><p>NOTE: Apparently GCC 2.x has problems dealing with *.a components; if that
affects you, use *.so files instead.</p></td></tr>
<tr><td></td><td></td><td> </td></tr>
<tr><td> </td></tr>
<tr><td colspan="4" bgcolor="black">
<img src="images/black.png" width="1" height="2"></td></tr>
<tr><td colspan="4"><a name="Downloading_from_CVS"></a><h4>Downloading from CVS</h4></td></tr><tr><td></td><td></td><td> </td></tr>
<tr><td></td><td></td><td><p>The CVS has the absolute latest version of GridFlow, but it's not guaranteed to be working, whereas
the actual releases are more tested.</p></td></tr>
<tr><td></td><td></td><td> </td></tr>
<tr><td></td><td></td><td><p>However you may have various reasons to use the CVS edition, so here's how:</p></td></tr>
<tr><td></td><td></td><td> </td></tr>
<tr><td></td><td></td><td><p>Make sure you have the <kbd><font color="#007777">cvs</font></kbd> program installed.</p></td></tr>
<tr><td></td><td></td><td> </td></tr>
<tr><td></td><td></td><td><p><kbd><font color="#007777">mkdir -p ~/src/gridflow</font></kbd> (make a directory; it could be called otherwise if you like)</p></td></tr>
<tr><td></td><td></td><td> </td></tr>
<tr><td></td><td></td><td><p><kbd><font color="#007777">cd ~/src/gridflow</font></kbd> (go in that directory)</p></td></tr>
<tr><td></td><td></td><td> </td></tr>
<tr><td></td><td></td><td><p><kbd><font color="#007777">cvs -d :pserver:anonymous@cvs.gridflow.ca:/home/cvs/gridflow login</font></kbd> (the password is blank)</p></td></tr>
<tr><td></td><td></td><td> </td></tr>
<tr><td></td><td></td><td><p><kbd><font color="#007777">cvs -d :pserver:anonymous@cvs.gridflow.ca:/home/cvs/gridflow checkout .</font></kbd> (download the first time)</p></td></tr>
<tr><td></td><td></td><td> </td></tr>
<tr><td></td><td></td><td><p>And the subsequent times, you only do this:</p></td></tr>
<tr><td></td><td></td><td> </td></tr>
<tr><td></td><td></td><td><p><kbd><font color="#007777">cd ~/src/gridflow</font></kbd></p></td></tr>
<tr><td></td><td></td><td> </td></tr>
<tr><td></td><td></td><td><p><kbd><font color="#007777">cvs update -dP</font></kbd></p></td></tr>
<tr><td></td><td></td><td> </td></tr>
<tr><td> </td></tr>
<tr><td colspan="4" bgcolor="black">
<img src="images/black.png" width="1" height="2"></td></tr>
<tr><td colspan="4"><a name="Installation_instructions_(incl._compilation)"></a><h4>Installation instructions (incl. compilation)</h4></td></tr><tr><td></td><td></td><td> </td></tr>
<tr><td></td><td></td><td><ul> <li><b>1</b> : Install Ruby. Make sure it contains <kbd><font color="#007777">ruby.h</font></kbd> and <kbd><font color="#007777">intern.h</font></kbd> and related files. It's also
recommended to have <kbd><font color="#007777">libruby.so</font></kbd>. Those extra files may be in a package called <kbd><font color="#007777">ruby-dev</font></kbd>
if you are using RPM or DEB/FINK. If you are building Ruby yourself, it's better to configure ruby with <kbd><font color="#007777">--enable-shared</font></kbd>. If you install into a system directory, you may have to run <kbd><font color="#007777">ldconfig</font></kbd>
after installing Ruby.</li> <li><b>2</b> : Download GridFlow from the website and uncompress it, or get it from the CVS server.</li> <li><b>3</b> : Run <kbd><font color="#007777">./configure</font></kbd> from the <kbd><font color="#007777">gridflow</font></kbd> directory. Make sure it detects all the components
you want to use with GridFlow. In MacOS you would normally use FINK to install: <kbd><font color="#007777">libjpeg libjpeg-shlibs libpng-shlibs libpng3 libpng3-shlibs libmpeg libmpeg-shlibs</font></kbd> </li> <li><b>4</b> : Note: you may have to set <kbd><font color="#007777">CPLUS_INCLUDE_PATH</font></kbd> to indicate where to find *.h files, and you
may have to set both <kbd><font color="#007777">LIBRARY_PATH</font></kbd> and <kbd><font color="#007777">LD_LIBRARY_PATH</font></kbd> to indicate where to find
*.so or *.aor *.dylib or *.bundle or *.dll or *.lib files.</li> <li><b>5</b> : Note: you can do <kbd><font color="#007777">./configure --help</font></kbd> to get a list of supported
options. You can use them to ignore the presence of troublesome libraries
and select debugging level. With <kbd><font color="#007777">--use-compiler</font></kbd> you should use a version of <kbd><font color="#007777">g++</font></kbd>, not
directly a version of <kbd><font color="#007777">gcc</font></kbd>, else you get <kbd><font color="#007777">undefined symbol</font></kbd> problems. Some versions of gcc/g++
are troublesome.</li> <li><b>6</b> : Run <kbd><font color="#007777">make</font></kbd> to produce the executables <kbd><font color="#007777">gridflow.so</font></kbd> and <kbd><font color="#007777">gridflow.pd_linux</font></kbd> or similar</li> <li><b>7</b> : Run <kbd><font color="#007777">make install</font></kbd> to copy those executables and related files to their final locations.</li> <li><b>8</b> : Run <kbd><font color="#007777">make test</font></kbd> just to verify that GridFlow isn't working too bad.</li> <li><b>9</b> : With a text editor, create <kbd><font color="#007777">~/.gridflow_startup</font></kbd> and write something like <kbd><font color="#007777">GridFlow.data_path << "/home/myself/gridflow/images"</font></kbd> to tell GridFlow where to find the
images used in the examples. You may add more lines like that one if you have folders containing images
or movies you want to use with GridFlow.</li> <li><b>10</b> : Loading GridFlow:<ul> <li><b>1</b> : PureData : With a text editor, modify or create <kbd><font color="#007777">~/.pdrc</font></kbd> and write <kbd><font color="#007777">-lib gridflow</font></kbd>. </li> <li><b>2</b> : ImpureData : In the ".pdrc editor", add <kbd><font color="#007777">gridflow</font></kbd> to the list of libraries.</li> <li><b>3</b> : plain Ruby : the command <kbd><font color="#007777">require "gridflow"</font></kbd> will load gridflow.so.</li> </ul>
Note that on MacOS the dot-files are invisible in the Finder but you do <kbd><font color="#007777">cd ~/Desktop; ln -s ../.pdrc "PureData Configuration"</font></kbd> to make an alias on the Desktop.
Note also that on Windows the dot-files are even more trouble.</li> </ul></td></tr>
<tr><td></td><td></td><td> </td></tr>
<tr><td> </td></tr>
<tr><td colspan="4" bgcolor="black">
<img src="images/black.png" width="1" height="2"></td></tr>
<tr><td colspan="4"><a name="Other_Tips"></a><h4>Other Tips</h4></td></tr><tr><td></td><td></td><td> </td></tr>
<tr><td></td><td></td><td><ul> <li><b>1</b> : you just did a CVS update and now the program does not compile, or
crashes, or changes didn't go through. <ul> <li><b>1</b> : Did you forget the "make install" step?</li> <li><b>2</b> : If a new directory is created, you need to do <kbd><font color="#007777">cvs update -d</font></kbd>.
Many people just add that option to their configuration of the CVS software.</li> <li><b>3</b> : When some kinds of changes have happened, you may have to rerun the <kbd><font color="#007777">configure</font></kbd>
program before redoing <kbd><font color="#007777">make</font></kbd>. If you had previously reconfigured with specific options,
don't forget to use them again in this case.</li> <li><b>4</b> : Maybe matju forgot to upload part of an important change. Tell him.</li> </ul></li> <li><b>2</b> : PureData Crashing: <ul> <li><b>1</b> : you can start the debugger like <kbd><font color="#007777">gdb `which pd` core.24255</font></kbd> where the latter part
is the name of a RAM dump file. You can enable those dumps using the shell command <kbd><font color="#007777">ulimit -c unlimited</font></kbd>. To avoid dumping, you can also start Pd from within the debugger
using <kbd><font color="#007777">gdb `which pd`</font></kbd> then <kbd><font color="#007777">run</font></kbd> then cause the crash.</li> <li><b>2</b> : In GDB, after a crash, you can use the <kbd><font color="#007777">where</font></kbd> to find out what Pd was doing at the moment
of the crash. If instead Pd is frozen, you can force it to crash using Ctrl+C in the terminal. </li> <li><b>3</b> : To quit GDB use the <kbd><font color="#007777">quit</font></kbd> command. (really.)</li> </ul></li> </ul></td></tr>
<tr><td></td><td></td><td> </td></tr>
<tr><td> </td></tr>
<td colspan="4" bgcolor="black">
<img src="images/black.png" width="1" height="2"></td></tr>
<tr><td colspan="4">
<p><font size="-1">
GridFlow 0.8.0 Documentation<br>
Copyright © 2001,2002,2003,2004,2005 by Mathieu Bouchard
<a href="mailto:matju@sympatico.ca">matju(a)artengine.ca</a>
</font></p>
</td></tr></table></body></html>
--- NEW FILE: index.html ---
<html>
<head>
<title>GridFlow 0.8.0</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<link rel="stylesheet" href="gridflow.css" type="text/css">
</head>
<body bgcolor="#FFFFFF" leftmargin="0" topmargin="0" marginwidth="0" marginheight="0">
<br>
<table width="100%" border="0" cellspacing="5">
<tr><td colspan="4" bgcolor="#082069">
<img src="images/titre_gridflow.png" width="253" height="23"></td></tr>
<tr>
<td rowspan="2" width="14%"> </td>
<td colspan="2" width="100%"> </td>
<td rowspan="10" width="12%"> </td>
</tr>
<tr>
<td colspan="2">
<p>
a multi-dimensional dataflow processing library
for PureData and Ruby, specialized in image and video<br>
</p>
</td>
</tr>
<tr><td> </td></tr>
<tr><td colspan="4" bgcolor="black"><img src="images/black.png" width="1" height="2"></td></tr>
<tr><td colspan="3" height="16">
<h4>GridFlow 0.8.0 - documentation index</h4>
</td></tr>
<tr>
<td width="14%" rowspan=2> </td>
<td colspan="2"><ul>
<li><a href="license.html">License</a></li>
<li><a href="introduction.html">Introduction</a></li>
<li><a href="install.html">Installation</a></li>
<li><a href="architecture.html">Reference Manual: Architecture and Concepts</a></li>
<li><a href="reference.html">Reference Manual: Flow Classes</a></li>
<li><a href="format.html">Reference Manual: Format Handlers</a></li>
<li><a href="internals.html">Reference Manual: C++/Ruby Internals</a></li>
<li><a href="profiling.html">Profiling</a></li>
<!-- <p> <a href="project_policy.html">Project Policy</a></p> -->
</ul></td></tr>
<tr><td> </td></tr>
<tr><td colspan="4" bgcolor="black"><img src="images/black.png" width="1" height="2"></td></tr>
<tr><td colspan="4"><h4>GridFlow On The Net</h4></td></tr>
<tr><td rowspan=2> </td><td><ul>
<li><a href="http://gridflow.ca/latest">
Browse GridFlow documentation and source code on the web
</a></li>
<li><a href="http://www.artengine.ca/gridflow/download">
Download GridFlow and related files
</a></li>
<li>Or checkout using the CVS protocol (no password):
<kbd>cvs -d :pserver:anonymous@artengine.ca:/home/cvs/gridflow checkout .</kbd>
</li>
<li><a href="http://www.artengine.ca/viewcvs/gridflow/">
Browse GridFlow CVS on the Web
</a></li>
<li><a href="http://artengine.ca/~tiki/tiki-view_faq.php?faqId=1">
GridFlow Frequently Asked Questions (on wiki)
</a></li>
<li>Mailing Lists (Subscription and Archives): <ul>
<li><a href="http://ns.artengine.ca/mailman/listinfo/gridflow-dev">
<kbd>gridflow-dev</kbd>: GridFlow Contributors
</a></li>
<li><a href="http://ns.artengine.ca/mailman/listinfo/gridflow-cvs">
<kbd>gridflow-cvs</kbd>: GridFlow CVS Reports
</a></li>
<li><a href="http://ns.artengine.ca/mailman/listinfo/pdmtl">
<kbd>pdmtl</kbd>: PureData Montréal Users Group
</a></li>
</ul>
<li><a href="http://www.puredata.org">PureData Community Site</a></li>
<li><a href="http://www.ruby-lang.org/">Ruby Home Page</a></li>
<li>
Join us on IRC at
<table bgcolor="black" border="0"><tr><td>
<table bgcolor="white" border="0" cellpadding="4" cellspacing="1">
<tr><td width=1><b>host</b></td><td width=1><kbd>irc.freenode.net</kbd></td></tr>
<tr><td><b>port</b></td><td><kbd>6667</kbd></td></tr>
<tr><td><b>channel</b></td><td><kbd>#dataflow</kbd></td></tr>
</table>
</table>
</li>
<li>See also :
<ul>
<li>Danks/Geiger/Zmölnig's <a href="http://GEM.iem.at/GEM">GEM (video plugin for PureData)</a>
</li>
<li>Tom Schouten's <a href="http://zwizwa.fartit.com/pd/">PDP (video plugin for PureData)</a></li>
<li><a href="http://www.opendragon.ca/">OpenDragon (externals collection for Max)</a></li>
<li>NATO (QuickTime library wrapper for Max)</li>
<li>David Rokeby's SoftVNS (for Max)</li>
<li>JKClayton/Cycling74's
<a href="http://www.cycling74.com/products/jitter.html">Jitter (for Max)</a></li>
<li>APL (Array Programming Language)</li>
<li>J (modern APL)</li>
<li><a href="http://pdl.perl.org/">PDL (APL for Perl)</a></li>
<li>Ruby NArray:
<a href="http://www.ir.isas.ac.jp/~masa/ruby/index.html">japanese page</a>;
<a href="http://www.ir.isas.ac.jp/~masa/ruby/index-e.html">english page</a></li>
<li><a href="http://www.gstreamer.net/">gstreamer (video for Gnome/Kde)</a></li>
<li><a href="http://www.arts-project.org/">aRts (audio for Kde)</a></li>
<li><a href="http://www.dai.ed.ac.uk/HIPR2/wksheets.htm">
Image Processing Operator Worksheets</a></li>
<li><a href="http://freej.dyne.org/">FreeJ</a></li>
</ul>
</ul></li>
<tr><td> </td></tr>
<tr><td colspan="4" bgcolor="black"><img src="images/black.png" width="1" height="2"></td></tr>
<tr><td colspan="4"><h4>Credits</h4></td></tr>
<tr><td rowspan=2> </td><td>
C++/Ruby Programming : Mathieu Bouchard<br>
Pd Examples : Mathieu Bouchard, Alexandre Castonguay<br>
MacOS 10 version : Mathieu Bouchard, James Tittle, Adam Lindsay<br>
Windows version (upcoming) : Carmen Rocco<br>
<tr><td> </td></tr>
<tr><td colspan="4" bgcolor="black"><img src="images/black.png" width="1" height="2"></td></tr>
<tr><td colspan="4"><h4>Sponsors</h4></td></tr>
<tr><td rowspan=2> </td><td>
<p>GridFlow is sponsored by
<a href="http://www.artengine.org">Artengine</a></p>
<p>Development of GridFlow 0.3.0 - 0.5.0 was made possible in part by a grant from the
<a href="http://www.hrdc-drhc.gc.ca/">HRDC</a> to <a href="http://www.artengine.org">Artengine</a></p>
<tr><td> </td></tr>
<tr><td colspan="4" bgcolor="black"><img src="images/black.png" width="1" height="2"></td></tr>
<tr><td colspan="4">
<p><font size="-1">GridFlow 0.8.0 Documentation<br>
by Mathieu Bouchard <a href="mailto:matju@sympatico.ca">matju(a)sympatico.ca</a>
and<br>
Alexandre Castonguay <a href="mailto:acastonguay@artengine.ca">acastonguay(a)artengine.ca</a></font></p>
</td>
</tr>
</table>
</body>
</html>
--- NEW FILE: architecture.xml ---
<?xml version="1.0" standalone="no" ?>
<!DOCTYPE documentation SYSTEM 'jmax.dtd'>
<documentation title="Reference Manual: Architecture">
<!-- $Id: architecture.xml,v 1.1 2005/10/04 02:09:42 matju Exp $ -->
<!--
GridFlow Reference Manual: Architecture
Copyright (c) 2001,2002,2003,2004 by Mathieu Bouchard
-->
<!--
<section name="Conventions of this Manual">
(In this section, usage of Bold, Italic, Courier, etc. would be explained.
eventually I'd like those to have precise meanings consistent throughout
the whole documentation)
</section>
-->
<!--write-me
<section name="Naming Conventions">
</section>
-->
<!--write-me
<section name="User-level Overview">
<p>(this section is for all users)</p>
</section>
-->
<section name="Numbers">
<p>High-performance computation requires precise and quite peculiar
definitions of numbers and their representation.</p>
<p>Inside most programs, numbers are written down as strings of
bits. A bit is either zero or one. Just like the decimal system
uses units, tens, hundreds, the binary system uses units, twos,
fours, eights, sixteens, and so on, doubling every time.</p>
<p>One notation, called integer allows for only integer values to be
written (no fractions). when it is unsigned, no negative values may
be written. when it is signed, one bit indicates whether the number
is positive or negative. Integer storage is usually fixed-size, so you have
bounds on the size of numbers, and if a result is too big it "wraps around", truncating the biggest
bits.</p>
<p>Another notation, called floating point (or float) stores numbers using
a fixed number of significant digits, and a scale factor that allows for huge numbers
and tiny fractions at once. Note that 1/3 has periodic digits, but even 0.1 has periodic digits,
in binary coding; so expect some slight roundings; the precision offered should be
sufficient for most purposes. Make sure the errors of rounding don't accumulate, though.</p>
<p>This little program of mine prints 1/3 in base 2 (only digits after the period):
<k>ruby -e 'x=1/3.0;for i in 0..52 do x*=2;y=x.floor;print y;x-=y end;puts'</k></p>
<p>In GridFlow, there are six kinds of numbers:</p>
<table>
<column id="name">name</column>
<column id="aliases">aliases</column>
<column id="range">range</column>
<column id="size">size (bytes)</column>
<column id="precision">precision</column>
<column id="">description</column>
<row name="uint8" aliases="u8 b" size="1"
range="0..255" precision="1">
unsigned 8-bit integer.
this is the usual size of numbers taken from files and cameras, and
written to files and to windows. (however this gets converted to <k>int32</k>
unless otherwise specified.)
</row>
<row name="int16" aliases="i16 s" size="2"
range="±2<sup>15</sup> = -32768..32767" precision="1"
>...</row>
<row name="int32" aliases="i32 i" size="4"
range="±2<sup>31</sup> = -2147483648..2147483647" precision="1">
signed 32-bit integer.
this is used for most computations.
</row>
<row name="int64" aliases="i64 l" size="8"
range="±2<sup>63</sup>" precision="1"
>...</row>
<row name="float32" aliases="f32 f" size="4"
range="±10<sup>±38</sup>"
precision="23 bits = 0.000012% (about 7 digits)"
>...</row>
<row name="float64" aliases="f64 d" size="8"
range="±10<sup>±308</sup>"
precision="52 bits (about 15 digits)"
>...</row>
</table>
</section>
<section name="Grid Literals">
<p>
In every grid-accepting inlet, a list may be sent instead; if
it consists only of integers, it will be converted to a
one-dimensional grid. Else it may contain a single "#" sign and
integers on both sides of it, where the ones to the left of it are
fed as arguments to an imaginary <k>[#redim]</k> object and the one to the
right of it are fed through that <k>[#redim]</k>.
</p>
<p>
In every grid-accepting inlet, an integer or float may also be sent;
it will be converted to a zero-dimensional grid (a <b>scalar</b>).
</p>
</section>
<section name="Grid Protocol">
<p>
a grid has an associated number type that defines what are the possible values for its elements
(and how much space it takes). the default is <b>int32</b>.
</p>
<p>
a single-dimensional grid of 3 elements (a triplet) is called dim(3). a
three-dimensional grid of 240 rows of 320 columns of triplets is called
dim(240,320,3).
</p>
<p>
There is a sequence in which elements of a Grid are stored and
transmitted. Dimension 0 is called "first" and dimension N-1 is
called "last". They are called so because if you select a
position in the first dimension of a grid, the selected part is of the same
shape minus the first dimension; so in dim(240,320,3) if you select
row 51 (or whichever valid row number), you get a dim(320,3). if you select
a subpart two more times you get to a single number.
</p>
<p>
At each such level, elements are sent/stored in their numeric order,
and are numbered using natural numbers starting at 0. This ordering usually
does not matter, but sometimes it does. Most notably, <k>[#import]</k>,
<k>[#export]</k> and <k>[#redim]</k> care about it.
</p>
<p>
On the other hand, order of dimensions usually does matter; this is
what distinguishes rows from columns and channels, for example.
Most objects care about the distinction.
</p>
<p>
A grid with only 1 element in a given dimension is different from one
lacking that dimension; it won't have the same meaning. You can use this
property to your advantage sometimes.
</p>
<p>
Zero-dimensional grids exist. They are called dim(). They can only contain
a single number.
</p>
</section>
<section name="Picture Protocol">
<p><i>This section is useful if you want to know what a picture is
in terms of a grid.
</i></p>
<p>A picture is a three-dimensional Grid:
<list start="0">
<li>rows</li>
<li>columns</li>
<li>channels</li>
</list>
</p>
<p>Channels for the RGB color model are:
<list start="0">
<li>red</li>
<li>green</li>
<li>blue</li>
</list>
</p>
<p>
Because Grids are made of 32-bit integers, a three-channel picture uses
96 bpp (bits per pixel), and have to be downscaled to 24 bpp (or 16 bpp)
for display. That huge amount of slack is there because when you create
your own effects you often have intermediate results that need to be of
higher precision than a normal picture. Especially, results of multiplications
are big and should not overflow before you divide them back to normal;
and similarly, you can have negative values all over, as long as you take
care of them before they get to the display.
</p>
<p>
In the final conversion, high bits are just ignored. This means: black is
0, maximum is 255, and values wrap like with <k>% 256</k>. If you want to
clip them, you may use <k>[# max 0]</k> and <k>[# min 255]</k> objects.
</p>
</section>
<section name="Numeric Operators">
<p>In the following table, A is the value entered to the
left, and B is the value entered to the right.</p>
<p>Angles are in hundredths of degrees. This means a full circle
(two pi radians) is 36000. You convert from degrees to our angles
by multiplying by 100. You convert from radians to our angles by
multiplying by 18000/pi.</p>
<p>Hyperbolic functions (tanh) work with our angles too, so the
same conversions apply.</p>
<table>
<column id="name" type="icon">name</column>
<column id="">description</column>
<column id="color">meaning in pixel context (pictures, palettes)</column>
<column id="space">meaning in spatial context (indexmaps, polygons)</column>
<!-- category: bogus -->
<row name="ignore" cname="ignore"
color="no effect"
space="no effect"
> A </row>
<row name="put" cname="put"
color="replace by"
space="replace by"
> B </row>
<!-- category: additive -->
<row name="+" cname="add"
color="brightness, crossfade"
space="move, morph"
> A + B </row>
<row name="-" cname="sub"
color="brightness, motion detection"
space="move, motion detection"
> A - B </row>
<row name="inv+" cname="bus"
color="negate then contrast"
space="180 degree rotate then move"
> B - A </row>
<!-- category: multiplicative -->
<row name="*" cname="mul"
color="contrast"
space="zoom out"
> A * B </row>
<row name="/" cname="div"
color="contrast"
space="zoom in"
> A / B, rounded towards zero </row>
<row name="div" cname="div2"
color="contrast"
space="zoom in"
> A / B, rounded downwards </row>
<row name="inv*" cname="vid"
> B / A, rounded towards zero </row>
<row name="swapdiv" cname="vid2"
> B / A, rounded downwards </row>
<row name="%" cname="mod"
space="tile"
> A % B, modulo (goes with div) </row>
<row name="swap%" cname="dom"
> B % A, modulo (goes with div) </row>
<row name="rem" cname="rem"
> A % B, remainder (goes with /) </row>
<row name="swaprem" cname="mer"
> B % A, remainder (goes with /) </row>
<row name="gcd" cname="gcd">
greatest common divisor</row>
<row name="lcm" cname="lcm">
least common multiple</row>
<!-- bits -->
<row name="|" cname="or"
color="bright munchies"
space="bottomright munchies"
> A or B, bitwise </row>
<row name="^" cname="xor"
color="symmetric munchies (fractal checkers)"
space="symmetric munchies (fractal checkers)"
> A xor B, bitwise </row>
<row name="&" cname="and"
color="dark munchies"
space="topleft munchies"
> A and B, bitwise </row>
<row name="<<" cname="shl"
color="like *"
space="like *"
> A * (2**(B % 32)), which is left-shifting </row>
<row name=">>" cname="shr"
color="like /,div"
space="like /,div"
> A / (2**(B % 32)), which is right-shifting </row>
<!-- decision -->
<row name="||" cname="sc_or"
> if A is zero then B else A </row>
<row name="&&" cname="sc_and"
> if A is zero then zero else B</row>
<row name="min" cname="min"
color="clipping"
space="clipping (of individual points)"
> the lowest value in A,B </row>
<row name="max" cname="max"
color="clipping"
space="clipping (of individual points)"
> the highest value in A,B </row>
<!-- comparison -->
<row name="cmp" cname="cmp"
> -1 when A<B; 0 when A=B; 1 when A>B. </row>
<row name="==" cname="eq"
> is A equal to B ? 1=true, 0=false </row>
<row name="!=" cname="ne"
> is A not equal to B ? </row>
<row name=">" cname="gt"
> is A greater than B ? </row>
<row name="<=" cname="le"
> is A not greater than B ? </row>
<row name="<" cname="lt"
> is A less than B ? </row>
<row name=">=" cname="ge"
>is A not less than B ? </row>
<!-- trigonometrics and exponentiation -->
<row name="sin*" cname="sin"
space="waves, rotations"
> B * sin(A) </row>
<row name="cos*" cname="cos"
space="waves, rotations"
> B * cos(A) </row>
<row name="atan" cname="atan"
space="find angle to origin (part of polar transform)"
> arctan(A/B) </row>
<row name="tanh*" cname="tanh"
color="smooth clipping"
space="smooth clipping (of individual points), neural sigmoid, fuzzy logic"
> B * tanh(A) </row>
<row name="log*" cname="log"
> B * log(A) (in base e) </row>
<row name="gamma" cname="gamma"
color="gamma correction"
> floor(pow(a/256.0,256.0/b)*256.0) </row>
<row name="**" cname="pow"
color="gamma correction"
> A**B, that is, A raised to power B </row>
<!-- former one-input operators -->
<row name="abs-" cname="abs"
> absolute value of (A-B) </row>
<row name="rand" cname="rand"
> randomly produces a non-negative number below A </row>
<row name="sqrt" cname="sqrt"
> square root of A, rounded downwards </row>
<row name="sq-" cname="sq"
> (A-B) times (A-B) </row>
<!-- 0.8.0 -->
<row name="clip+" cname="clip+"
> like A+B but overflow causes clipping instead of wrapping around (coming soon) </row>
<row name="clip-" cname="clip-"
> like A-B but overflow causes clipping instead of wrapping around (coming soon) </row>
<row name="avg" cname="avg"
> (A+B)/2 </row>
<row name="hypot" cname="hypot"
> square root of (A*A+B*B) </row>
<row name="erf*" cname="erf"
> integral of e^(-x*x) dx ... (coming soon; what ought to be the scaling factor?) </row>
</table>
</section>
<!--write-me
<section name="Programmer-level Overview">
<p>(this section is for people who want to mess with the internals or at least
understand them a bit)</p>
(move this section down?)
</section>
-->
<section name="Synchronisation">
<p>In GridFlow you cannot send two grids in different inlets at the
same time. You have to use <k>[#finished]</k> together with (possibly) <k>[fork]</k> and <k>[#store]</k>,
which can be cumbersome. If you don't do this, the result is undefined
behaviour (or crash!).</p>
<p>In GridFlow 0.7.1 this is beginning to change. <k>[#store]</k> and # now allow
right-inlet grids to be buffered if an operation is occuring on left inlet. This
should make many circuits simpler.
</p>
<p>(more to come)</p>
</section>
<section name="Bridges">
<p>Starting with version 0.6, GridFlow is Ruby-centric instead of jMax-centric.
jMax support has been added back as a <b>Bridge</b>.</p>
<p>Bridges, for the most part, plug into the FObject class, which is the common
root of most of GridFlow's classes. Under the current design, the bridge is
compiled separately, and is directly loaded by the host software; then the
bridge starts Ruby and makes it load the main GridFlow; then the bridge hooks
with the main part.
</p>
</section>
</documentation>
--- NEW FILE: internals.xml ---
<?xml version="1.0" standalone="no" ?>
<!DOCTYPE documentation SYSTEM 'jmax.dtd'>
<documentation title="C++/Ruby Internals">
<!-- $Id: internals.xml,v 1.1 2005/10/04 02:09:42 matju Exp $ -->
<!--
GridFlow Reference Manual: Internals
Copyright (c) 2001,2002,2003,2004,2005 by Mathieu Bouchard
-->
<section name="notes">
<p>In Ruby, GridFlow defines a namespace (module) called GridFlow. Most of the
constants it defines are part of that namespace.</p>
<p>Ruby does not have the same concept of object as PD. In GridFlow, object classes may
inherit features from other object classes, and also there is no concept of inlet nor outlet, which are instead
provided by <k>GridFlow::FObject</k>, which also has the purpose of exporting functionality to
PD.</p>
<p>In this document (and in many others) the phrase "a Potato" will be a shorthand for "an object of the class
called Potato", which is often used in modern software design and is a nice convention borrowed from
biology.</p>
<p>
A FObject is normally in two or three parts: a (Ruby) GridFlow::FObject
that is the central part; a (C++) FObject; a (C++) BFObject.
The GridFlow::FObject is created as a RData kind of box (T_DATA)
using Ruby-C's Data_Make_Struct on a GridObject. This is
how most Ruby-C programs inherit from Ruby classes. Note that
Ruby's boxed objects have a maximum of five fields, and they're usually
taken, so additional fields have to be outside of it. This is why RData exists.
</p>
<p>
So basically you have a C++ FObject that is "part of" a GridFlow::FObject
and they point to each other using "peer pointers".
The BFObject links back to the RData box through a pointer called peer.
</p>
</section>
<section name="Objects for Scripting">
<class name="ruby class FObject extending Data">
Provides inlets and outlets to Ruby Objects.
<method name="init">
</method>
<method name="send_in">
<arg name="inlet" type="int"/>
<rest name="message"/>
</method>
<method name="send_out">
<arg name="outlet" type="int"/>
<rest name="message"/>
</method>
</class>
<class name="ruby class GridObject extending FObject">
Provides grid support to FObjects.
<method name="inlet_dim">
<arg name="inlet" type="Integer"/>
gives an array of Integers (dimension list)
</method>
<method name="inlet_nt">
<arg name="inlet" type="Integer"/>
gives a Symbol (number type)
</method>
<method name="inlet_set_factor">
<arg name="inlet" type="Integer"/>
<arg name="factor" type="Integer"/>
ensures received packets have a size that is
a whole multiple of this size.
must be called from rgrid_begin.
</method>
<method name="send_out_grid_begin">
<arg name="outlet" type="Integer"/>
<arg name="dimensions" type="Array of Integer"/>
<arg name="nt" type="number type" default="int32"/>
establishes grid streams between an outlet and all inlets
connected to it.
</method>
<method name="send_out_grid_flow">
<arg name="outlet" type="Integer"/>
<arg name="data" type="String"/>
for sending a grid data packet through that outlet.
</method>
<method name="send_out_grid_end">
<arg name="outlet" type="Integer"/>
(isn't this one obsolete?)
</method>
<inlet id="0">
<method name="rgrid_begin"/>
<method name="rgrid_flow">
<arg name="data" type="String"/>
</method>
<method name="rgrid_end"/>
</inlet>
</class>
<class name="ruby class BitPacking">
A BitPacking is a simple two-way converter between different
numeric layouts.
</class>
<class name="ruby FPatcher extending FObject">
<p>This class is much like PureData's abstractions.</p>
<p>This is a container for objects. Its proper objects are numbered
starting with zero. The wire list is given in terms of those numbers:
(sourceobject,sourceinlet,destobject,destinlet). There is a
pseudo-object numbered #-1 which map to the container's own inlets
and outlets.</p>
</class>
<class name="ruby GridFlow::USB"><p>wrapper for struct usb_dev_handle</p>
<attr name=".busses">wrapper for struct usb_bus and usb_get_busses()</attr>
</class>
<class name="ruby GridFlow::USB::Device">
<p>wrapper for struct usb_device and struct usb_device_descriptor</p>
</class>
<class name="ruby GridFlow::USB::Config">
<p>wrapper for struct usb_config_descriptor, struct usb_interface</p>
</class>
<class name="ruby GridFlow::USB::Interface">
<p>wrapper for struct usb_interface_descriptor</p>
</class>
<class name="ruby GridFlow::USB::Endpoint">
<p>wrapper for struct usb_endpoint_descriptor</p>
</class>
</section>
<section name="Objects for Internals">
<class name="C++ class GridInlet">
GridInlets represent inlets that accept grids.
</class>
<class name="C++ class GridOutlet">
GridOutlets represent outlets that send grids.
</class>
<class name="C++ class Dim">
Dim represents a list of dimensions.
</class>
<class name="C++ class Grid">
Grid represents a grid that is fully stored in memory.
</class>
<class name="C++ class Numop1">
This represents a one-input operator.
Such an object contains a map() function that applies the operator
over a memory segment.
</class>
<class name="C++ class Numop2">
This represents a two-input operator.
Such an object contains four functions for each T, where
T is one of the types uint8, int16, int32, float32.
<method name="map">
<arg name="n" type="integer"/>
<arg name="as" type="Pt<T>"/>
<arg name="b" type="T"/>
for i in 0...n,
as[i] := f(as[i],b);
This is like <k>[#]</k> with a scalar righthand
</method>
<method name="zip">
<arg name="n" type="integer"/>
<arg name="as" type="Pt<T>"/>
<arg name="bs" type="Pt<T>"/>
for i in 0...n,
as[i] := f(as[i],bs[i]);
bs is not modified.
(This is like <k>[#]</k> with a nonscalar righthand)
</method>
<method name="fold">
<arg name="an" type="integer"/>
<arg name="n" type="integer"/>
<arg name="as" type="Pt<T>"/>
<arg name="bs" type="Pt<T>"/>
<p>
for i in 0...n,
for j in 0...an,
as[j] := f(as[j],bs[i*an+j]);
</p>
(this is like <k>[#fold]</k>)
</method>
<method name="scan">
<arg name="an" type="integer"/>
<arg name="n" type="integer"/>
<arg name="as" type="Pt<T>"/>
<arg name="bs" type="Pt<T>"/>
<p> for j in 0...an: bs[j] := f(as[j],bs[j]); </p>
<p> for i in 1...n: for j in 0...an:
bs[j] := f(bs[(i-1)*an+j],bs[i*an+j]); </p>
(this is like <k>[#scan]</k>)
</method>
</class>
<class name="C++ class GridClass">
This represents a class of GridObjects.
</class>
<class name="C++ class GFBridge">
This holds linkage information about PureData.
</class>
</section>
</documentation>
--- NEW FILE: install.xml ---
<?xml version="1.0" standalone="no" ?>
<!DOCTYPE documentation SYSTEM 'jmax.dtd'>
<documentation title="Installation">
<!-- $Id: install.xml,v 1.1 2005/10/04 02:09:42 matju Exp $ -->
<!--
GridFlow Installation
Copyright (c) 2001,2002,2003,2004,2005 by Mathieu Bouchard
-->
<section name="Hardware and Software you Probably Need">
<p>Required Computer/Processor (one of...):<list>
<li>PC : AMD K6/K7/K8 or Intel P2/P3/P4 (absolute minimum is 386)</li>
<li>Macintosh : G3/G4/G5</li>
<li>Corel NetWinder : StrongARM V4L</li>
<li>HP iPaq : some processor that works like the NetWinder</li>
<li>could work on SiliconGraphics and SPARCstation with a little nurture.</li>
</list></p>
<p>Required OS (one of...):<list>
<li>Linux (most any variant) (recommended)</li>
<li>MacOS 10.2 or later (experimental)</li>
<li>Windows with MinGW (very experimental)</li>
</list></p>
<p>Required Software:<list>
<li>Ruby 1.6.6 or more recent (1.8.0 recommended) (make sure you have the *.so and *.h files)
(on MacOS you may have to remove or hide the existing one and install a more complete package)</li>
</list></p>
<p>Dataflow Software :<list>
<li>PureData 0.36 or later (recommended)</li>
</list></p>
<p>Multimedia Components (optional):<list>
<li>libSDL (Simple Directmedia Layer)</li>
<li>libjpeg</li>
<li>libpng</li>
<li>libmpeg3 (.mpg reader, HeroineWarrior's)</li>
<li>libquicktime (.mov reader/writer, Burkhard Plaum's or HeroineWarrior's) </li>
<li>libmpeg (.mpg reader, Greg Ward's, old)</li>
<li>Apple QuickTime (.mov reader/writer)</li>
<li>Ascii Art Library (aalib)</li>
<li>PCI video digitizer card (and Video4linux 1 driver)</li>
<li>USB camera (and Video4linux 1 driver)</li>
</list></p>
<p>Developer Tools (roll-your-own):<list>
<li>GNU C++ Compiler (gcc/g++) version 3.x or maybe 2.95</li>
<li>GNU Make (gmake)</li>
<li>CVS (for upgrading/collaboration)</li>
<li>Ruby library "xmlparser" (optional, for editing documentation)</li>
<li>Developer Tools CD dec 2002 (if MacOS 10.2)</li>
<li>XCODE (if MacOS 10.3)</li>
<li>FINK (if MacOS 10)</li>
</list></p>
<p>NOTE: Apparently GCC 2.x has problems dealing with *.a components; if that
affects you, use *.so files instead.</p>
</section>
<section name="Downloading from CVS">
<p>The CVS has the absolute latest version of GridFlow, but it's not guaranteed to be working, whereas
the actual releases are more tested.</p>
<p>However you may have various reasons to use the CVS edition, so here's how:</p>
<p>Make sure you have the <k>cvs</k> program installed.</p>
<p><k>mkdir -p ~/src/gridflow</k> (make a directory; it could be called otherwise if you like)</p>
<p><k>cd ~/src/gridflow</k> (go in that directory)</p>
<p><k>cvs -d :pserver:anonymous@cvs.gridflow.ca:/home/cvs/gridflow login</k> (the password is blank)</p>
<p><k>cvs -d :pserver:anonymous@cvs.gridflow.ca:/home/cvs/gridflow checkout .</k> (download the first time)</p>
<p>And the subsequent times, you only do this:</p>
<p><k>cd ~/src/gridflow</k></p>
<p><k>cvs update -dP</k></p>
</section>
<section name="Installation instructions (incl. compilation)">
<list>
<li>Install Ruby. Make sure it contains <k>ruby.h</k> and <k>intern.h</k> and related files. It's also
recommended to have <k>libruby.so</k>. Those extra files may be in a package called <k>ruby-dev</k>
if you are using RPM or DEB/FINK. If you are building Ruby yourself, it's better to configure ruby with
<k>--enable-shared</k>. If you install into a system directory, you may have to run <k>ldconfig</k>
after installing Ruby.</li>
<li>Download GridFlow from the website and uncompress it, or get it from the CVS server.</li>
<li>Run <k>./configure</k> from the <k>gridflow</k> directory. Make sure it detects all the components
you want to use with GridFlow. In MacOS you would normally use FINK to install:
<k>libjpeg libjpeg-shlibs libpng-shlibs libpng3 libpng3-shlibs libmpeg libmpeg-shlibs</k>
</li>
<li>Note: you may have to set <k>CPLUS_INCLUDE_PATH</k> to indicate where to find *.h files, and you
may have to set both <k>LIBRARY_PATH</k> and <k>LD_LIBRARY_PATH</k> to indicate where to find
*.so or *.aor *.dylib or *.bundle or *.dll or *.lib files.</li>
<li>Note: you can do <k>./configure --help</k> to get a list of supported
options. You can use them to ignore the presence of troublesome libraries
and select debugging level. With <k>--use-compiler</k> you should use a version of <k>g++</k>, not
directly a version of <k>gcc</k>, else you get <k>undefined symbol</k> problems. Some versions of gcc/g++
are troublesome.</li>
<li>Run <k>make</k> to produce the executables <k>gridflow.so</k> and <k>gridflow.pd_linux</k> or similar</li>
<li>Run <k>make install</k> to copy those executables and related files to their final locations.</li>
<li>Run <k>make test</k> just to verify that GridFlow isn't working too bad.</li>
<li>With a text editor, create <k>~/.gridflow_startup</k> and write something like
<k>GridFlow.data_path << "/home/myself/gridflow/images"</k> to tell GridFlow where to find the
images used in the examples. You may add more lines like that one if you have folders containing images
or movies you want to use with GridFlow.</li>
<li>Loading GridFlow:<list>
<li>PureData : With a text editor, modify or create <k>~/.pdrc</k> and write <k>-lib gridflow</k>. </li>
<li>ImpureData : In the ".pdrc editor", add <k>gridflow</k> to the list of libraries.</li>
<li>plain Ruby : the command <k>require "gridflow"</k> will load gridflow.so.</li>
</list>
Note that on MacOS the dot-files are invisible in the Finder but you do
<k>cd ~/Desktop; ln -s ../.pdrc "PureData Configuration"</k> to make an alias on the Desktop.
Note also that on Windows the dot-files are even more trouble.</li>
</list>
</section>
<section name="Other Tips">
<list>
<li>you just did a CVS update and now the program does not compile, or
crashes, or changes didn't go through.
<list>
<li>Did you forget the "make install" step?</li>
<li>If a new directory is created, you need to do <k>cvs update -d</k>.
Many people just add that option to their configuration of the CVS software.</li>
<li>When some kinds of changes have happened, you may have to rerun the <k>configure</k>
program before redoing <k>make</k>. If you had previously reconfigured with specific options,
don't forget to use them again in this case.</li>
<li>Maybe matju forgot to upload part of an important change. Tell him.</li>
</list></li>
<li>PureData Crashing:
<list>
<li>you can start the debugger like <k>gdb `which pd` core.24255</k> where the latter part
is the name of a RAM dump file. You can enable those dumps using the shell command
<k>ulimit -c unlimited</k>. To avoid dumping, you can also start Pd from within the debugger
using <k>gdb `which pd`</k> then <k>run</k> then cause the crash.</li>
<li>In GDB, after a crash, you can use the <k>where</k> to find out what Pd was doing at the moment
of the crash. If instead Pd is frozen, you can force it to crash using Ctrl+C in the terminal.
</li>
<li>To quit GDB use the <k>quit</k> command. (really.)</li>
</list></li>
</list>
</section>
</documentation>
--- NEW FILE: profiling.html ---
<html>
<head>
<!-- $Id: profiling.html,v 1.1 2005/10/04 02:09:43 matju Exp $ -->
<!--
GridFlow Reference Manual: Architecture
Copyright (c) 2001,2002,2003,2004 by Mathieu Bouchard
-->
<title>GridFlow 0.7.7 - Profiling Execution Speed</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<link rel="stylesheet" href="gridflow.css" type="text/css">
</head>
<body bgcolor="#FFFFFF" leftmargin="0" topmargin="0" marginwidth="0" marginheight="0">
<br>
<table width="100%" border="0" cellspacing="5">
<tr><td colspan="4" bgcolor="#082069">
<img src="images/titre_gridflow.png" width="253" height="23"></td></tr>
<tr><td> </td></tr>
<tr><td colspan="4" bgcolor="black"><img src="images/black.png" width="1" height="2"></td></tr>
<tr><td colspan="3" height="16">
<h4>GridFlow 0.7.7 - Profiling Execution Speed</h4>
</td></tr>
<tr>
<td width="12%" height="4"> </td>
<td width="80%" height="4"> </td>
<td width="12%" height="4"> </td>
</tr>
<tr>
<td width="13%"> </td>
<td width="82%">
<h4>What is profiling?</h4>
<p>
It is about getting empiric metrics about the execution of a program.
For example, find out which parts of a program consume the most time
and/or memory. Usually it's about the time, and this is what GridFlow
allows you to measure.
</p>
<h4>How to get those stats from GridFlow ?</h4>
<ul>
<li>create a "@global" object and connect two
messageboxes to it, "profiler_reset" and "profiler_dump". The first
one resets all counters to zero. The second one gives a top of
the busiest objects, with percentages.</li>
<li>note that those results are global to a process. That is, if you load
several patches in the same process (program instance), then all those patches
will be monitored at once. But if you open jMax (or PD) several times at once, then
the profiler will not see everything happening on that machine.
</li>
<h4>How do i interpret those stats?</h4>
<li>Note that some operations may not be monitored, and some of the
monitoring may be buggy. I think it's not buggy as it is now, but I may be wrong.
</li>
<li>
The current profiler uses a thing called RDTSC (Pentium only). This is a very high
precision clock that is very fast to use. However, *major* imprecisions
may come from the fact that an ordinary multitasking OS will run other
tasks without stopping/resuming the clock. This may happen randomly;
however, it has a much bigger chance of happening in [@in] or [@out], because that's
where all the communication with other stuff is (files, sockets, windows, etc).
</li>
<li>
If you make sure that only the bare minimum is actively running on your
computer, then [@out] (using x11) would still include the time spent in the x11
server, except in some conditions. This applies to every kind of window output too,
because however the data trickles through libraries (sdl, aalib), it has to reach the x11 server
and the display driver.
</li>
<li>
The profiler has an impact on the results of the profiler. The profiler
includes half of its own influence in its own results, and disregards the
other half (or so). Profiling shouldn't add more than 100-300 ticks per
message (of which half is counted).
</li>
<li>
Message-passing time is not counted at all. Only time actually spent
inside GridFlow objects is counted. This may skew results.
Transmission of a grid requires one message, thus we may speak of "grid messages".
However, when the message is received, one or several packets may get transmitted, which
is done outside of the message system. Each packet contains at most 2048 numbers
(adjustable limit), and normally a packet should be at least one quarter of that size unless it is the last one.
On RGB grids of widths 640,320,160, the packet size will usually be 1920.
</li>
</ul>
</p>
<h4>Getting a frames-per-second measure</h4>
<p>This section formerly was describing what can now be obtained using the [fps] object class.</p>
<h4>acceleration tricks</h4>
<ul>
<li>try the profiler and see what it says.</li>
<li>i mean really.</li>
<li>you can lose a lot of your time accelerating something
that isn't really taking execution time.</li>
<li>it's faster to work on big grids than on small grids,
for the amount of number-crunching you can do.
</li>
<li>about numbertypes: uint8 is the fastest, followed by int16, int32, float32.
(and the first two are faster when MMX is enabled). However it
may be difficult to make some effects use int16
or smaller without overflow happening.</li>
<li>[@ <<] is a very fast multiplication by powers of two (1, 2, 4, 8, 16, ...).
[@ >>] is a very fast division by powers of two.
<p>
from my little experience, normal integer multiplication and division are
rather slow, especially on Intel brand. The gap between *,/ and
<<,>> is smaller on Cyrix/AMD brand CPUs, but still, try it
yourself. (my experience has been on specific models and may not reflect currently common models)
</p>
</li>
<li>[@ & 255] is a very fast [@ % 256], and likewise for other
powers of two.</li>
<li>for do-nothing operations, "ignore" and "put" are faster than
"+ 0" and such...</li>
<li>remember that an image twice smaller in height <u>and</u> twice
smaller in height will be processed <u>four</u> times as fast (for
most effects) so you can get four times more frames per second.
It's the "rows*columns*channels" value that makes the biggest
difference (usually).</li>
<li>If all fails you may recode a jMax/PD/Ruby abstraction into
plain Ruby code or C++ code. If your new class is of generic
usefulness then maybe it should be added to the releases of
GridFlow. Contact me if you need help extending GridFlow.</li>
<li>Put often-used files on fast drives. This means don't use NFS
(networked file system) for that. The file-to-ram cache can compensate for
that up to a certain amount, but the larger the file is, and the most used
the file is, the more important it is to put it on a local drive. </li>
</ul>
</td>
<tr><td> </td></tr>
<tr><td colspan="4" bgcolor="black"><img src="images/black.png" width="1" height="2"></td></tr>
<tr><td colspan="4">
<p><font size="-1">GridFlow 0.7.7 Documentation<br>
by Mathieu Bouchard <a href="mailto:matju@sympatico.ca">matju(a)sympatico.ca</a>
</font></p>
</td>
</tr>
</table>
</body>
</html>
--- NEW FILE: project_policy.html ---
<html><head>
<!-- $Id: project_policy.html,v 1.1 2005/10/04 02:09:43 matju Exp $ -->
<title>GridFlow 0.8.0 - </title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<link rel="stylesheet" href="gridflow.css" type="text/css">
</head>
<body bgcolor="#FFFFFF"
leftmargin="0" topmargin="0"
marginwidth="0" marginheight="0">
<table width="100%" bgcolor="white" border="0" cellspacing="2">
<tr><td colspan="4" bgcolor="#082069">
<img src="images/titre_gridflow.png" width="253" height="23">
</td></tr><tr><td> </td></tr>
<tr><td colspan="4" bgcolor="black">
<img src="images/black.png" width="1" height="2"></td></tr>
<tr><td colspan="4" height="16">
<h4>GridFlow 0.8.0 - </h4>
</td></tr>
<tr>
<td width="5%" rowspan="2"> </td>
<td width="15%" height="23"> </td>
<td width="80%" height="23"> </td>
<td width="5%" height="23"> </td>
</tr>
<tr><td colspan="2"><div cols="1"><h4><a href="#Note">Note</a></h4><ul>
</ul>
<h4><a href="#Release">Release</a></h4><ul>
</ul>
<h4><a href="#Documentation">Documentation</a></h4><ul>
</ul>
<h4><a href="#CVS">CVS</a></h4><ul>
</ul>
<br><br>
</div></td></tr> <tr><td colspan="4" bgcolor="black">
<img src="images/black.png" width="1" height="2"></td></tr>
<tr><td colspan="4"><a name="Note"></a><h4>Note</h4></td></tr><tr><td></td><td></td><td>
first consult the file ../README for a vague idea on the meaning of
subdirectories. </td></tr>
<tr><td> </td></tr>
<tr><td colspan="4" bgcolor="black">
<img src="images/black.png" width="1" height="2"></td></tr>
<tr><td colspan="4"><a name="Release"></a><h4>Release</h4></td></tr><tr><td></td><td></td><td>
Compatibility: </td></tr>
<tr><td></td><td></td><td><ul><li><b>1</b> :
Should work with Ruby 1.6.6 and PureData 0.36, 0.37, 0.38 </li></ul></td></tr>
<tr><td></td><td></td><td>
Release steps (</td></tr>
<tr><td></td><td></td><td><b>OPERATE WITH CAUTION</b></td></tr>
<tr><td></td><td></td><td>): </td></tr>
<tr><td></td><td></td><td><ul> <li><b>1</b> : make vvtest # leak detection </li><li><b>2</b> : ruby base/test.rb formats </li><li><b>3</b> : cvs tag gridflow_0_7_7 . </li><li><b>4</b> : mkdir gridflow </li><li><b>5</b> : cvs -d :pserver:anonymous@cvs.gridflow.ca:/home/cvs/gridflow
export -r gridflow_0_7_7 -d gridflow . </li><li><b>6</b> : cd gridflow </li><li><b>7</b> : rm -rf CVS CVSROOT </li><li><b>8</b> : chmod -R go=u-w . </li><li><b>9</b> : cd .. </li><li><b>10</b> : tar cfzvv gridflow-0.7.7.tar.gz gridflow </li><li><b>11</b> : rm -rf gridflow # caution!!! </li><li><b>12</b> : scp gridflow*gz gridflow@artengine.ca:download </li><li><b>13</b> : mv gridflow*gz /home/matju/net/GridFlow </li><li><b>14</b> : ssh gridflow(a)artengine.ca : expand tarball into public_html/latest </li><li><b>15</b> : download somewhere else and try to compile </li><li><b>16</b> : update main page </li><li><b>17</b> : jmax/pd/ruby-talk mlists : post release (note: prefix subject with [ANN] !!!!) </li><li><b>18</b> : freshmeat.net : post release </li><li><b>19</b> : RAA : post release </li> </ul></td></tr>
<tr><td></td><td></td><td> </td></tr>
<tr><td> </td></tr>
<tr><td colspan="4" bgcolor="black">
<img src="images/black.png" width="1" height="2"></td></tr>
<tr><td colspan="4"><a name="Documentation"></a><h4>Documentation</h4></td></tr><tr><td></td><td></td><td> </td></tr>
<tr><td></td><td></td><td><ul> <li><b>1</b> :
Pictures identified as "<help>" should be screenshots of the
help files. They shouldn't be screenshots of the template. </li> <li><b>2</b> :
A Help file is a visual summary of what an object does. It should be
interactive and allow the user to understand what the object does.
Sample inputs are provided and sample results can be seen. </li> <li><b>3</b> :
All modifications to the documentation must be done in the XML. The
HTML must be kept up-to-date by rerunning "make" in the "doc/" directory. </li> <li><b>4</b> :
Help-wise, Formats are considered objects.
Operators are to be documented as part of [@] and [@!]. </li> <li><b>5</b> :
Images grabbed directly from a jMax window should be encoded in PNG.
This includes "icons" (object boxes, message boxes, etc). If they are
in JPEG, only change to PNG when the image has to change anyway.
Distinguish "icons" from "thumbnails", the latter of which are <b>scaled-down</b> grabs, which should be encoded in JPEG. </li> <li><b>6</b> :
There are not help-thumbnails anymore in the reference manual
because they were not helpful. </li> <li><b>7</b> :
Large images should be kept out of the release. The release itself must
be small enough not to discourage us from doing releases and keeping
them all. It also should be downloadable on a bad modem. =)
Let's keep it under 500k please. </li> </ul></td></tr>
<tr><td></td><td></td><td>
in doc do:
for z in images/*.* images/*/*.*; do fgrep -q $z *.html || echo "$z"; done </td></tr>
<tr><td> </td></tr>
<tr><td colspan="4" bgcolor="black">
<img src="images/black.png" width="1" height="2"></td></tr>
<tr><td colspan="4"><a name="CVS"></a><h4>CVS</h4></td></tr><tr><td></td><td></td><td>
environment variables
CVSEDITOR=pico
CVS_RSH=ssh2 </td></tr>
<tr><td> </td></tr>
<td colspan="4" bgcolor="black">
<img src="images/black.png" width="1" height="2"></td></tr>
<tr><td colspan="4">
<p><font size="-1">
GridFlow 0.8.0 Documentation<br>
Copyright © 2001,2002,2003,2004,2005 by Mathieu Bouchard
<a href="mailto:matju@sympatico.ca">matju(a)artengine.ca</a>
</font></p>
</td></tr></table></body></html>
--- NEW FILE: project_policy.xml ---
<?xml version="1.0" standalone="no" ?>
<!DOCTYPE documentation SYSTEM 'jmax.dtd'>
<documentation>
<!-- $Id: project_policy.xml,v 1.1 2005/10/04 02:09:43 matju Exp $ -->
<!--
GridFlow Reference Manual: Project Policy
Copyright (c) 2001,2002,2003,2004 by Mathieu Bouchard and Alexandre Castonguay
-->
<section name="Note">
first consult the file ../README for a vague idea on the meaning of
subdirectories.
</section>
<section name="Release">
Compatibility:
<list><li>
Should work with Ruby 1.6.6 and PureData 0.36, 0.37, 0.38
</li></list>
Release steps (<b>OPERATE WITH CAUTION</b>):
<list>
<li>make vvtest # leak detection
</li><li>ruby base/test.rb formats
</li><li>cvs tag gridflow_0_7_7 .
</li><li>mkdir gridflow
</li><li>cvs -d :pserver:anonymous@cvs.gridflow.ca:/home/cvs/gridflow
export -r gridflow_0_7_7 -d gridflow .
</li><li>cd gridflow
</li><li>rm -rf CVS CVSROOT
</li><li>chmod -R go=u-w .
</li><li>cd ..
</li><li>tar cfzvv gridflow-0.7.7.tar.gz gridflow
</li><li>rm -rf gridflow # caution!!!
</li><li>scp gridflow*gz gridflow@artengine.ca:download
</li><li>mv gridflow*gz /home/matju/net/GridFlow
</li><li>ssh gridflow(a)artengine.ca : expand tarball into public_html/latest
</li><li>download somewhere else and try to compile
</li><li>update main page
</li><li>jmax/pd/ruby-talk mlists : post release (note: prefix subject with [ANN] !!!!)
</li><li>freshmeat.net : post release
</li><li>RAA : post release
</li>
</list>
</section>
<section name="Documentation">
<list>
<li>
Pictures identified as "<help>" should be screenshots of the
help files. They shouldn't be screenshots of the template.
</li>
<li>
A Help file is a visual summary of what an object does. It should be
interactive and allow the user to understand what the object does.
Sample inputs are provided and sample results can be seen.
</li>
<li>
All modifications to the documentation must be done in the XML. The
HTML must be kept up-to-date by rerunning "make" in the "doc/" directory.
</li>
<li>
Help-wise, Formats are considered objects.
Operators are to be documented as part of [@] and [@!].
</li>
<li>
Images grabbed directly from a jMax window should be encoded in PNG.
This includes "icons" (object boxes, message boxes, etc). If they are
in JPEG, only change to PNG when the image has to change anyway.
Distinguish "icons" from "thumbnails", the latter of which are
<b>scaled-down</b> grabs, which should be encoded in JPEG.
</li>
<li>
There are not help-thumbnails anymore in the reference manual
because they were not helpful.
</li>
<li>
Large images should be kept out of the release. The release itself must
be small enough not to discourage us from doing releases and keeping
them all. It also should be downloadable on a bad modem. =)
Let's keep it under 500k please.
</li>
</list>
in doc do:
for z in images/*.* images/*/*.*; do fgrep -q $z *.html || echo "$z"; done
</section>
<section name="CVS">
environment variables
CVSEDITOR=pico
CVS_RSH=ssh2
</section>
</documentation>
--- NEW FILE: license.html ---
<html>
<head>
<!-- $Id: license.html,v 1.1 2005/10/04 02:09:43 matju Exp $ -->
<!--
GridFlow Reference Manual: Architecture
Copyright (c) 2001,2002,2003,2004 by Mathieu Bouchard
-->
<title>GridFlow 0.7.7 - License</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<link rel="stylesheet" href="gridflow.css" type="text/css">
</head>
<body bgcolor="#FFFFFF" leftmargin="0" topmargin="0" marginwidth="0" marginheight="0">
<br>
<table width="100%" border="0" cellspacing="5">
<tr><td colspan="4" bgcolor="#082069">
<img src="images/titre_gridflow.png" width="253" height="23"></td></tr>
<tr><td> </td></tr>
<tr><td colspan="4" bgcolor="black"><img src="images/black.png" width="1" height="2"></td></tr>
<tr><td colspan="3" height="16">
<h4>GridFlow 0.7.7 - License</h4>
</td></tr>
<tr>
<td rowspan="2" width="12%"> </td>
<td colspan="2" width="80%"> </td>
<td rowspan="10" width="12%"> </td>
</tr>
<tr><td colspan="2">
<table cellspacing="1" cellpadding="0"><tr><td bgcolor="black">
<table cellspacing="1" cellpadding="20"><tr><td bgcolor="white">
<p>
Copyright (c) 2001,2002,2003,2004 by Mathieu Bouchard
<p>
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.
<p>
See file LICENSE for further informations on licensing terms.
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.
<p>
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., 59 Temple Place - Suite 330, Boston,
MA 02111-1307, USA.
</td></tr></table>
</td></tr></table>
</td>
</tr>
<tr><td> </td></tr>
<tr><td colspan="4" bgcolor="black"><img src="images/black.png" width="1" height="2"></td></tr>
<tr><td colspan="4">
<p><font size="-1">GridFlow 0.7.7 Documentation<br>
by Mathieu Bouchard <a href="mailto:matju@sympatico.ca">matju(a)sympatico.ca</a>
and<br>
Alexandre Castonguay <a href="mailto:acastonguay@artengine.ca">acastonguay(a)artengine.ca</a></font></p>
</td>
</tr>
</table>
</body>
</html>
--- NEW FILE: format.html ---
<html><head>
<!-- $Id: format.html,v 1.1 2005/10/04 02:09:42 matju Exp $ -->
<title>GridFlow 0.8.0 - Reference Manual: Format Classes</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<link rel="stylesheet" href="gridflow.css" type="text/css">
</head>
<body bgcolor="#FFFFFF"
leftmargin="0" topmargin="0"
marginwidth="0" marginheight="0">
<table width="100%" bgcolor="white" border="0" cellspacing="2">
<tr><td colspan="4" bgcolor="#082069">
<img src="images/titre_gridflow.png" width="253" height="23">
</td></tr><tr><td> </td></tr>
<tr><td colspan="4" bgcolor="black">
<img src="images/black.png" width="1" height="2"></td></tr>
<tr><td colspan="4" height="16">
<h4>GridFlow 0.8.0 - Reference Manual: Format Classes</h4>
</td></tr>
<tr>
<td width="5%" rowspan="2"> </td>
<td width="15%" height="23"> </td>
<td width="80%" height="23"> </td>
<td width="5%" height="23"> </td>
</tr>
<tr><td colspan="2"><div cols="1"><h4><a href="#Objects_for_Input/Output">Objects for Input/Output</a></h4><ul>
<li><a href="##in"><img src="flow_classes/%23in-icon.png" alt="[#in]" border="0"></a></li>
<li><a href="##out"><img src="flow_classes/%23out-icon.png" alt="[#out]" border="0"></a></li>
<li><a href="##peephole"><img src="flow_classes/%23peephole-icon.png" alt="[#peephole]" border="0"></a></li>
<li><a href="##mouse"><img src="flow_classes/%23mouse-icon.png" alt="[#mouse]" border="0"></a></li>
<li><a href="##camera"><img src="flow_classes/%23camera-icon.png" alt="[#camera]" border="0"></a></li>
</ul>
<h4><a href="#Picture/Movie_Formats">Picture/Movie Formats</a></h4><ul>
<li><a href="#format ppm #in/#out"><img src="flow_classes/format ppm %23in/%23out-icon.png" alt="[format ppm #in/#out]" border="0"></a></li>
<li><a href="#format targa #in/#out"><img src="flow_classes/format targa %23in/%23out-icon.png" alt="[format targa #in/#out]" border="0"></a></li>
<li><a href="#format jpeg #in/#out"><img src="flow_classes/format jpeg %23in/%23out-icon.png" alt="[format jpeg #in/#out]" border="0"></a></li>
<li><a href="#format png #in"><img src="flow_classes/format png %23in-icon.png" alt="[format png #in]" border="0"></a></li>
<li><a href="#format quicktime #in/#out"><img src="flow_classes/format quicktime %23in/%23out-icon.png" alt="[format quicktime #in/#out]" border="0"></a></li>
<li><a href="#format mpeg #in"><img src="flow_classes/format mpeg %23in-icon.png" alt="[format mpeg #in]" border="0"></a></li>
<li><a href="#format grid #in/#out"><img src="flow_classes/format grid %23in/%23out-icon.png" alt="[format grid #in/#out]" border="0"></a></li>
</ul>
<h4><a href="#Acquisition_Devices">Acquisition Devices</a></h4><ul>
<li><a href="#format videodev #in"><img src="flow_classes/format videodev %23in-icon.png" alt="[format videodev #in]" border="0"></a></li>
</ul>
<h4><a href="#Window_Output">Window Output</a></h4><ul>
<li><a href="#format x11 #in/#out"><img src="flow_classes/format x11 %23in/%23out-icon.png" alt="[format x11 #in/#out]" border="0"></a></li>
<li><a href="#format quartz #out"><img src="flow_classes/format quartz %23out-icon.png" alt="[format quartz #out]" border="0"></a></li>
<li><a href="#format sdl #out"><img src="flow_classes/format sdl %23out-icon.png" alt="[format sdl #out]" border="0"></a></li>
<li><a href="#format aalib #out"><img src="flow_classes/format aalib %23out-icon.png" alt="[format aalib #out]" border="0"></a></li>
<li><a href="#format window #out"><img src="flow_classes/format window %23out-icon.png" alt="[format window #out]" border="0"></a></li>
</ul>
<br><br>
</div></td></tr> <tr><td colspan="4" bgcolor="black">
<img src="images/black.png" width="1" height="2"></td></tr>
<tr><td colspan="4"><a name="Objects_for_Input/Output"></a><h4>Objects for Input/Output</h4></td></tr><tr><td></td><td></td><td> </td></tr>
<tr><td colspan="4" bgcolor="#ffb080"><b> class </b><a name="#in">#in</a></td></tr><tr><td></td><td valign="top"><br>
<img src="flow_classes/%23in-icon.png" alt="[#in]" border="0"><br clear="left"><br><br><a href="#inout"><img src="images/see_screenshot.png" border="0"></a><br clear="left"><br></td><td><br>
<br><b>method</b> init <b>(</b>format<b>, </b>format_specific_part...<b>)</b>
If no arguments given, creates an input object for an unspecified
format. You then need to use the <kbd><font color="#007777">"open"</font></kbd> command to link
a format handler to it.
If arguments given, the <kbd><font color="#007777">"open"</font></kbd> command is immediately called
with those arguments.
Remember that most formats produce Dim[rows,columns,3] grids with
0-255 values. (Most.) <br>
<br><b>inlet 0 </b><b>method</b> open <b>(</b>format<b>, </b>format_specific_part...<b>)</b>
This is the command that gives a particular resource
to a <kbd><font color="#007777">[#out]</font></kbd> object. This is done through a "format"
(there is a list of formats in this manual). The other
arguments depend on the chosen format. The format may
be a file format or a protocol or a hardware device, etc.
The format called "file" is a special shortcut that autodetects the
type of file (by name suffix) and picks up the appropriate handler. <br>
<br><b>inlet 0 </b><b>method</b> open <b>(</b>filename<b>)</b>
This is a shortcut for <kbd><font color="#007777">"open file"</font></kbd> followed by a filename.
The filename must contain a dot, else it will be seen as a handler name. <br>
<br><b>inlet 0 </b><b>method</b> close <b>(</b><b>)</b>
close may be necessary if you operate on <kbd><font color="#007777">"/dev/video"</font></kbd>,
which can only be read by one at a time. otherwise it's
usually not necessary. <br>
<br><b>inlet 0 </b><b>method</b> int <b>(</b>frame_number<b>)</b>
selects one picture from a multi-picture format
and then does the same as a bang. <br>
<br><b>inlet 0 </b><b>method</b> set <b>(</b>frame_number<b>)</b>
selects one picture from a multi-picture format,
to be displayed by the next bang. <br>
<br><b>inlet 0 </b><b>method</b> bang <b>(</b><b>)</b>
sends a grid through the outlet. the grid may be the
result of reading from a file, acquiring from a device,
capturing from the screen etc.
this is format-specific. most formats
produce grid(rows columns {red green blue}).
In formats that read from a file, reading another picture
will continue if there are several pictures in the
same file, but if the end of file is reached instead,
it will rewind and send the first picture again.
see section "External Picture Formats". <br>
<br><b>inlet 0 </b><b>method</b> option <b>(</b><i>symbol</i> selector<b>, </b>stuff...<b>)</b>
Obsolete. the word "option" is optional now. <br>
<br><b>inlet 0 </b><b>method</b> rewind <b>(</b><b>)</b>
rewinds to beginning of file if applicable. <br>
<br><b>inlet 0 </b><b>method</b> loop <b>(</b><i>bool</i> flag<b>)</b>
controls the automatic looping of movies. <br>
<br><b>outlet 1 </b><b>method</b> int <b>(</b><b>)</b>
frame number of frame just sent,
for formats that have frame numbers. <br>
<br><b>outlet 1 </b><b>method</b> bang <b>(</b><b>)</b>
tried to read a frame that does not exist
(signals end of file) <br>
<br></td></tr><tr><td></td><td></td><td> </td></tr>
<tr><td colspan="4" bgcolor="#ffb080"><b> class </b><a name="#out">#out</a></td></tr><tr><td></td><td valign="top"><br>
<img src="flow_classes/%23out-icon.png" alt="[#out]" border="0"><br clear="left"><br><br><a href="#inout"><img src="images/see_screenshot.png" border="0"></a><br clear="left"><br></td><td><br>
<br><b>method</b> init <b>(</b>format<b>, </b>format_specific_part...<b>)</b>
If no arguments given, creates an output object for an unspecified
format. You then need to use the <kbd><font color="#007777">"open"</font></kbd> command to link
a format handler to it.
If arguments given, the <kbd><font color="#007777">"open"</font></kbd> command is immediately called
with those arguments.
Remember that most formats expect dim(rows,columns,3) grids with
0-255 values. (Most.) <br>
<br><b>method</b> init <b>(</b><i>integer</i> rows<b>, </b><i>integer</i> columns<b>)</b>
This alternate way to create an <kbd><font color="#007777">[#out]</font></kbd> automatically calls <kbd><font color="#007777">"open window"</font></kbd> and <kbd><font color="#007777">"out_size <i>rows columns</i>"</font></kbd>. <br>
<br><b>inlet 0 </b><b>method</b> open <b>(</b>format<b>, </b>format_specific_part...<b>)</b>
This is the command that gives a particular resource
to a <kbd><font color="#007777">[#out]</font></kbd> object. This is done through a "format"
(there is a list of formats in this manual). The other
arguments depend on the chosen format. The format may
be a file format or a protocol or a hardware device, etc. <br>
<br><b>inlet 0 </b><b>method</b> open file <b>(</b><b>)</b>
The format called "file" is a special shortcut that autodetects the
type of file (by name suffix) and picks up the appropriate handler. <br>
<br><b>inlet 0 </b><b>method</b> open <b>(</b>filename<b>)</b>
This is a shortcut for "open file" followed by a filename.
The filename must contain a dot, else it will be seen as a handler name. <br>
<br><b>inlet 0 </b><b>method</b> grid <b>(</b><i>grid</i> grid<b>)</b>
this is format-specific. most formats
expect grid(rows columns {red green blue}).
In formats that write to a file, sending a 2nd picture
overwrites the first.
see section "External Picture Formats". <br>
<br><b>inlet 0 </b><b>method</b> close <b>(</b><b>)</b>
closes the file. usually not necessary. <br>
<br><b>inlet 0 </b><b>method</b> option <b>(</b><i>symbol</i> selector<b>, </b>stuff...<b>)</b>
Obsolete. Omit the word "option" now. <br>
<br><b>inlet 0 </b><b>method</b> timelog <b>(</b><i>0,1</i> status<b>)</b>
when status=1, current time (unix clock) and time since last
frame-end are printed in the console. when status=0, it is off.
default is 0. <br>
<br><b>inlet 0 </b><b>method</b> rewind <b>(</b><b>)</b>
rewinds to beginning of file if applicable.
will overwrite the previous data. <br>
<br><b>outlet 0 </b><b>method</b> bang <b>(</b><b>)</b>
sent when a complete grid has been received. <br>
<br></td></tr><tr><td></td><td></td><td> </td></tr>
<tr><td colspan="4" bgcolor="#ffb080"><b> class </b><a name="#peephole">#peephole</a></td></tr><tr><td></td><td valign="top"><br>
<img src="flow_classes/%23peephole-icon.png" alt="[#peephole]" border="0"><br clear="left"><br><br><br clear="left"><br></td><td><br>
<p>
This object class only works with a X11-based version of Pd.
(e.g. on Linux, BSD, but not MacOS X). </p> <p>Similar to <kbd><font color="#007777">[#out window]</font></kbd>, except it creates an inset in the patch you put it
in, and a scaled version of the picture appears in the inset. It also emits the same messages
as <kbd><font color="#007777">[#out window]</font></kbd> and automatically scales cursor position according to the current scale factor.
The scale factor is decided automatically. </p> <br><b>method</b> init <b>(</b><i>int</i> height<b>, </b><i>int</i> width<b>)</b> <br>
<p>All other methods are as in <kbd><font color="#007777">[#out window]</font></kbd>.</p> <br></td></tr><tr><td></td><td></td><td> </td></tr>
<tr><td colspan="4" bgcolor="#ffb080"><b> class </b><a name="#mouse">#mouse</a></td></tr><tr><td></td><td valign="top"><br>
<img src="flow_classes/%23mouse-icon.png" alt="[#mouse]" border="0"><br clear="left"><br><br><br clear="left"><br></td><td><br>
This will process the "position" messages emitted by <kbd><font color="#007777">[#out]</font></kbd> or <kbd><font color="#007777">[#peephole]</font></kbd> in
useful ways. <br><b>outlet 0 </b><b>method</b> list <b>(</b><b>)</b>
y,x coords of a click <br>
<br><b>outlet 1 </b><b>method</b> list <b>(</b><b>)</b>
y,x coords of a drag (any button is kept pressed) <br>
<br><b>outlet 2 </b><b>method</b> list <b>(</b><b>)</b>
y,x coords of an unclick <br>
<br><b>outlet 3 </b><b>method</b> list <b>(</b><b>)</b>
y,x coords of a move (no button is pressed) <br>
<br><b>outlet 4 </b><b>method</b> float <b>(</b><b>)</b> button 1 status<br>
<br><b>outlet 5 </b><b>method</b> float <b>(</b><b>)</b> button 2 status<br>
<br><b>outlet 6 </b><b>method</b> float <b>(</b><b>)</b> button 3 status<br>
<br><b>outlet 7 </b><b>method</b> float <b>(</b><b>)</b>
wheel difference: -1 = roll up; 1 = roll down. <br>
<br></td></tr><tr><td></td><td></td><td> </td></tr>
<tr><td colspan="4" bgcolor="#ffb080"><b> class </b><a name="#camera">#camera</a></td></tr><tr><td></td><td valign="top"><br>
<img src="flow_classes/%23camera-icon.png" alt="[#camera]" border="0"><br clear="left"><br><br><br clear="left"><br></td><td><br>
Works about like <kbd><font color="#007777">[#in videodev]</font></kbd> except you can right-click-open it to access all of the
camera settings visually. <br></td></tr><tr><td></td><td></td><td> </td></tr>
<tr><td> </td></tr>
<tr><td colspan="4" bgcolor="black">
<img src="images/black.png" width="1" height="2"></td></tr>
<tr><td colspan="4"><a name="Picture/Movie_Formats"></a><h4>Picture/Movie Formats</h4></td></tr><tr><td></td><td></td><td> </td></tr>
<tr><td colspan="4" bgcolor="#ffb080"><b> class </b><a name="format ppm #in/#out">format ppm #in/#out</a></td></tr><tr><td></td><td valign="top"><br>
<img src="flow_classes/format ppm %23in/%23out-icon.png" alt="[format ppm #in/#out]" border="0"><br clear="left"><br><br><br clear="left"><br></td><td><br>
<p>Subformat P6 only.
Max-number can only be 255 (24-bit RGB). </p> <br><b>method</b> open ppm file <b>(</b><i>symbol</i> filename<b>)</b>
opens the specified file, taken from the current
directory. <br>
<br><b>method</b> open ppm gzfile <b>(</b><i>symbol</i> filename<b>)</b>
same but for .ppm.gz files <br>
<br><b>method</b> grid <b>(</b><i>grid(rows columns {r g b})</i> grid<b>)</b>
values 0-255 <br>
<br></td></tr><tr><td></td><td></td><td> </td></tr>
<tr><td colspan="4" bgcolor="#ffb080"><b> class </b><a name="format targa #in/#out">format targa #in/#out</a></td></tr><tr><td></td><td valign="top"><br>
<img src="flow_classes/format targa %23in/%23out-icon.png" alt="[format targa #in/#out]" border="0"><br clear="left"><br><br><br clear="left"><br></td><td><br>
<p>Support for RGB-24 (3 channels) and RGBA-32 (4 channels)</p> <br><b>method</b> open targa file <b>(</b><i>symbol</i> filename<b>)</b>
opens the specified file, taken from the current
directory. <br>
<br><b>method</b> open targa gzfile <b>(</b><i>symbol</i> filename<b>)</b>
same but for .tga.gz files <br>
<br><b>method</b> grid <b>(</b><i>grid(rows columns 3)</i> grid<b>)</b> RGB-24<br>
<br><b>method</b> grid <b>(</b><i>grid(rows columns 4)</i> grid<b>)</b> RGBA-32<br>
<br></td></tr><tr><td></td><td></td><td> </td></tr>
<tr><td colspan="4" bgcolor="#ffb080"><b> class </b><a name="format jpeg #in/#out">format jpeg #in/#out</a></td></tr><tr><td></td><td valign="top"><br>
<img src="flow_classes/format jpeg %23in/%23out-icon.png" alt="[format jpeg #in/#out]" border="0"><br clear="left"><br><br><br clear="left"><br></td><td><br>
<p>Support for RGB non-progressive</p> <br><b>method</b> open jpeg file <b>(</b><i>symbol</i> filename<b>)</b>
opens the specified file, taken from the current
directory. <br>
<br><b>method</b> grid <b>(</b><i>grid(rows columns 3)</i> grid<b>)</b> RGB-24 <br>
<br></td></tr><tr><td></td><td></td><td> </td></tr>
<tr><td colspan="4" bgcolor="#ffb080"><b> class </b><a name="format png #in">format png #in</a></td></tr><tr><td></td><td valign="top"><br>
<img src="flow_classes/format png %23in-icon.png" alt="[format png #in]" border="0"><br clear="left"><br><br><br clear="left"><br></td><td><br>
<p>Support for RGB non-progressive</p> <br><b>method</b> open png file <b>(</b><i>symbol</i> filename<b>)</b>
opens the specified file, taken from the current
directory. <br>
<br><b>method</b> grid <b>(</b><i>grid(rows columns 1)</i> grid<b>)</b> Y-8 (greyscale)<br>
<br><b>method</b> grid <b>(</b><i>grid(rows columns 2)</i> grid<b>)</b> YA-16 (greyscale and transparency)<br>
<br><b>method</b> grid <b>(</b><i>grid(rows columns 3)</i> grid<b>)</b> RGB-24 (colour)<br>
<br><b>method</b> grid <b>(</b><i>grid(rows columns 4)</i> grid<b>)</b> RGBA-32 (colour and transparency)<br>
<br></td></tr><tr><td></td><td></td><td> </td></tr>
<tr><td colspan="4" bgcolor="#ffb080"><b> class </b><a name="format quicktime #in/#out">format quicktime #in/#out</a></td></tr><tr><td></td><td valign="top"><br>
<img src="flow_classes/format quicktime %23in/%23out-icon.png" alt="[format quicktime #in/#out]" border="0"><br clear="left"><br><br><br clear="left"><br></td><td><br>
<p>Support for .mov files.</p> <p>This format supports frame-seek and frame-tell.</p> <p>Uses the HW-QuickTime library aka QuickTime4Linux
(libquicktime.so). There is also a variant on the same library and that project
is just called LibQuickTime.</p> <p>Some versions of those libraries may include support for different codecs,
and some also may support entirely different wrapper formats such as AVI.</p> <p>On Macintosh, Apple QuickTime is used instead, but several of the following
messages may not be available.</p> <br><b>method</b> open quicktime file <b>(</b><i>symbol</i> filename<b>)</b> <br>
<br><b>method</b> codec <b>(</b><i>symbol</i> codec<b>)</b>
Allowed values are at least: raw, jpeg, png, mjpa, yuv2, yuv4.
Some other values may allowed, depending on the version of the library
and which codec plugins are installed.
Must be set before the first frame is written.
only applies to <kbd><font color="#007777">[#out]</font></kbd>. Choosing a codec is important
because codecs influence greatly the speed of
encoding, the speed of decoding,
the size of the written file, and its fidelity to the
original content. Note that there exist other Apple-QuickTime
codecs that are not supported by HW-QuickTime. <br>
<br><b>method</b> parameter <b>(</b><i>symbol</i> key<b>, </b><i>int</i> value<b>)</b>
Sets special codec-specific settings.
For example: <kbd><font color="#007777">"parameter jpeg_quality 75"</font></kbd> <br>
<br><b>method</b> framerate <b>(</b><i>int</i> fps<b>)</b>
Sets the framerate of the file.
This is not used by GridFlow when reading a file, but other
programs usually care. <br>
<br><b>method</b> colorspace <b>(</b><i>symbol</i> colorspace<b>)</b>
Allowed values are rgb, rgba, bgr, bgra, yuv, yuva.
Normally you don't need this. <br>
<br><b>method</b> size <b>(</b><i>int</i> height<b>, </b><i>int</i> width<b>)</b>
Forces a window size when writing. Usually this has to be used <u>after</u>
setting the framerate and codec and <u>before</u> setting the codec-parameters.
(Strange. Sorry.) <br>
<br><b>method</b> force_size <b>(</b><i>int</i> height<b>, </b><i>int</i> width<b>)</b>
forces a window size when reading.
this is a workaround for a problem in HW-QuickTime. <br>
<br></td></tr><tr><td></td><td></td><td> </td></tr>
<tr><td colspan="4" bgcolor="#ffb080"><b> class </b><a name="format mpeg #in">format mpeg #in</a></td></tr><tr><td></td><td valign="top"><br>
<img src="flow_classes/format mpeg %23in-icon.png" alt="[format mpeg #in]" border="0"><br clear="left"><br><br><br clear="left"><br></td><td><br>
<p>support for .mpeg files</p> <p>this format supports frame-seek and frame-tell.</p> <p>Two different libraries are available for dealing with
MPEG files. Those have different details, capabilities and quirks.</p> <p>In any case, GridFlow does not support importing audio from
those files.</p> <p>If you use the HeroineWarrior library, you may open several
mpeg files at once, but not with the GregWard library.</p> <p>Libraries may scream error messages in a rude way.</p> <p>By opposition to PPM and TARGA, this format driver only
allows a single MPEG stream per file (you cannot "cat"
several MPEG files together). </p> <p>Supports Rewind and Frame Select.</p> <br><b>method</b> open mpeg file <b>(</b><i>symbol</i> filename<b>)</b>
opens the specified file, taken from the current
directory. <br>
<br></td></tr><tr><td></td><td></td><td> </td></tr>
<tr><td colspan="4" bgcolor="#ffb080"><b> class </b><a name="format grid #in/#out">format grid #in/#out</a></td></tr><tr><td></td><td valign="top"><br>
<img src="flow_classes/format grid %23in/%23out-icon.png" alt="[format grid #in/#out]" border="0"><br clear="left"><br><br><br clear="left"><br></td><td><br>
<p>
This is GridFlow's special file format. This is the only I/O
format that can hold anything that the <kbd><font color="#007777">[#store]</font></kbd> object can. </p> <p>
This is the picture format that would support TCP connections
if that feature actually worked. More on this later. </p> <br><b>method</b> open grid file <b>(</b><i>symbol</i> filename<b>)</b>
opens the specified file, taken from the current
directory. <br>
<br><b>method</b> open grid gzfile <b>(</b><i>symbol</i> filename<b>)</b>
same but for .grid.gz files <br>
<br><b>method</b> open grid tcp <b>(</b><i>symbol</i> hostname<b>, </b><i>integer</i> port<b>)</b>
dials an specified hostname/port on the InterNet or
compatible network. the TCP protocol is used. <br>
<br><b>method</b> open grid tcpserver <b>(</b><i>integer</i> port<b>)</b>
waits for a call (and answers) for this port on the
local machine via InterNet or compatible network.
Answers the call. <br>
<br><b>method</b> type int32 <b>(</b><b>)</b>
output will be as 32 bit signed integers. <br>
<br><b>method</b> type uint8 <b>(</b><b>)</b>
output will be as 8 bit unsigned integers. <br>
<br><b>method</b> headerful <b>(</b><b>)</b>
cancels "headerless" (and back to reading .grid) <br>
<br><b>method</b> headerless <b>(</b>dimensions...<b>)</b>
instead of reading .grid files with header, will read raw data,
faking a .grid header to itself. It will use the hereby specified
dimension list, as well as two other settings: <kbd><font color="#007777">type</font></kbd> and <kbd><font color="#007777">endian</font></kbd>. <br>
<p>When writing "raw" data, a file may be considered a long string of
base 256 digits (called bytes), but different computers have different
conventions for dealing with them: <br><b>method</b> endian <b>(</b><b>)</b> <ul><li><b>1</b> : big:
A number will be written starting with the biggest digit.
This is the natural way on the Macintosh, Sun, Amiga, and so on. </li> <li><b>2</b> : little:
A number will be written starting with the smallest digit.
This is the natural way on the Intel 386/Pentium. </li> <li><b>3</b> : same:
A number will be written in whichever way is more natural
on this computer. The natural way is slightly faster to handle.
This is the default setting. </li> </ul> <br>
</p> <br></td></tr><tr><td></td><td></td><td> </td></tr>
<tr><td> </td></tr>
<tr><td colspan="4" bgcolor="black">
<img src="images/black.png" width="1" height="2"></td></tr>
<tr><td colspan="4"><a name="Acquisition_Devices"></a><h4>Acquisition Devices</h4></td></tr><tr><td></td><td></td><td> </td></tr>
<tr><td colspan="4" bgcolor="#ffb080"><b> class </b><a name="format videodev #in">format videodev #in</a></td></tr><tr><td></td><td valign="top"><br>
<img src="flow_classes/format videodev %23in-icon.png" alt="[format videodev #in]" border="0"><br clear="left"><br><br><br clear="left"><br></td><td><br>
<br><b>method</b> open <b>(</b>device<b>)</b> <br>
<p>Video4Linux-1 devices, RGB-24 only. Variable picture size.</p> <p>We have been testing it using cards of the BT-848 family,
such as Miro DC10plus and Hauppauge WinTV, using the <kbd><font color="#007777">bttv.o</font></kbd> linux driver.
Also we have been testing using Logitech QuickCam (and similar Labtec hardware),
but don't use the <kbd><font color="#007777">qce-ga</font></kbd> driver, which is buggy and obsolete: the <kbd><font color="#007777">qc-usb</font></kbd>
works better.</p> <p>Some hardware doesn't support RGB, so you may have to select a YUV colorspace
(see below) and then use <kbd><font color="#007777">[#yuv_to_rgb]</font></kbd>. Don't forget to also do <kbd><font color="#007777">[# min 255]</font></kbd> and <kbd><font color="#007777">[# max 0]</font></kbd>. </p> <p>If for some reason there's a bug that causes a driver to produce BGR instead of RGB,
so that red and blue are swapped, you can swap them back by filtering through a RGB-BGR
converter, such as <kbd><font color="#007777">[#inner * + 0 {3 3 # 0 0 1 0 1 0 1 0 0}]</font></kbd>.</p> <p>color adjustments: <br><b>method</b> brightness <b>(</b><i>0-65535</i> level<b>)</b> <br>
<br><b>method</b> hue <b>(</b><i>0-65535</i> level<b>)</b> <br>
<br><b>method</b> colour <b>(</b><i>0-65535</i> level<b>)</b> <br>
<br><b>method</b> contrast <b>(</b><i>0-65535</i> level<b>)</b> <br>
<br><b>method</b> whiteness <b>(</b><i>0-65535</i> level<b>)</b> <br>
</p> <br><b>method</b> get <b>(</b><i>symbol</i> attr<b>)</b>
gets a specific attribute. a message is sent through right outlet.
valid attributes are: brightness, hue, colour, contrast, whiteness. <br>
<br><b>method</b> get <b>(</b><b>)</b>
gets all attributes. <br>
<p>other options: <br><b>method</b> channel <b>(</b><i>integer</i> <b>)</b> <br>
<br><b>method</b> tuner <b>(</b><i>integer</i> <b>)</b> <br>
<br><b>method</b> norm <b>(</b><i>integer</i> <b>)</b> <br>
<br><b>method</b> frequency <b>(</b><i>integer</i> <b>)</b> <br>
<br><b>method</b> transfer <b>(</b><i>symbol(read|mmap)</i> <b>, </b><i>integer</i> <b>)</b> <ul> <li><b>1</b> : mmap:
This is the normal (and fast) way of transferring pictures
from the camera. </li> <li><b>2</b> : read:
Some cameras/drivers only support this instead of mmap. </li></ul>
In case of mmap, the extra numeric argument sets the
queue length in number of frames, so you can select an
appropriate tradeoff between efficiency and latency. <br>
<br><b>method</b> colorspace <b>(</b><i>symbol</i> colorspace<b>)</b>
Allowed values are: RGB24, YUV420P.
Use this if your driver doesn't support RGB24. <br>
<br><b>method</b> size <b>(</b>height<b>, </b>width<b>)</b>
sets the input size, especially when using a video digitalizer
device. <br>
</p> <br></td></tr><tr><td></td><td></td><td> </td></tr>
<tr><td> </td></tr>
<tr><td colspan="4" bgcolor="black">
<img src="images/black.png" width="1" height="2"></td></tr>
<tr><td colspan="4"><a name="Window_Output"></a><h4>Window Output</h4></td></tr><tr><td></td><td></td><td> </td></tr>
<tr><td colspan="4" bgcolor="#ffb080"><b> class </b><a name="format x11 #in/#out">format x11 #in/#out</a></td></tr><tr><td></td><td valign="top"><br>
<img src="flow_classes/format x11 %23in/%23out-icon.png" alt="[format x11 #in/#out]" border="0"><br clear="left"><br><br><br clear="left"><br></td><td><br>
<p>supports 15,16,24,32-bit truecolor displays</p> <p>now also support 8-bit indexed displays, using a private colormap
configured as 3:3:2 RGB. When using 8-bit you can specify the
"use_stripes" option to use a completely different color scheme
involving R,G,B diagonal stripes, a kind of 6:6:6 RGB spread over three
pixels.</p> <p>If you are using Windows or MacOS 10: you will have to install
a X11 server. This will emulate Unix display on your OS. (note:
Unix systems also need a X11 server, but it's built-in and handles
the video driver directly). In the case of MacOS 10 and QNX that both
use non-X11 display technology on top of a basically Unix OS, the
OS comes with a X11 server, but it may be on a "bundled software"
CD.</p> <br><b>method</b> open x11 <b>(</b><b>)</b>
synonym of "open x11 here". <br>
<br><b>method</b> open x11 here <b>(</b><b>)</b>
connects to the default X11 server,
according to your environment variable "DISPLAY". <br>
<br><b>method</b> open x11 local <b>(</b><i>integer</i> display_number<b>)</b>
connects to a display server on this machine. <br>
<br><b>method</b> open x11 remote <b>(</b><i>symbol</i> host_name<b>, </b><i>integer</i> display_number<b>)</b>
connects to a remote X11 display server using TCP.
Sorry, IP addresses are not supported.
Port number will be 6000 plus the display number, because
of the X11 standard. <br>
<br><b>method</b> grid <b>(</b><i>grid(rows columns {red green blue})</i> grid<b>)</b>
resizes the window to the size of the grid;
encodes that grid in the display's pixel format;
also displays it if autodraw > 0
the values must be in range 0-255,
or else they will be "wrapped". <br>
<p>
Destroying the object (or sending "close") should close the window. </p> <p>because of the design of Xlib, or if any of the connections
involved crashes, then the whole program has to be terminated.
(don't you love xlib). Something similar happens if you close any
of the windows yourself, but IIRC this could be fixed.</p> <p>only one window may be used per connection (to simplify matters;
this doesn't reduce flexibility).</p> <p>there is an additional argument that may be added to every <kbd><font color="#007777">"open"</font></kbd> message; if you don't put it, a new toplevel window is created.
if you put "root" then the screen's wallpaper will be used instead
(it may fail to work with some popular window managers). You can also
put a window number, e.g. <kbd><font color="#007777">0x28003ff</font></kbd>, you may connect to
an existing window; you can find out the number of a window by using
a tool like <kbd><font color="#007777">xwininfo</font></kbd>, part of X11 standard tools.</p> <br><b>method</b> out_size <b>(</b><i>integer</i> height<b>, </b><i>integer</i> width<b>)</b>
changes the window's size, just like sending a grid
dim(height,width,3) would.
this affects the size of screen captures too. <br>
<br><b>method</b> draw <b>(</b><b>)</b>
forces a redraw of the window's contents. <br>
<br><b>method</b> autodraw <b>(</b><i>0,1,2</i> level<b>)</b> <ul> <li><b>0</b> : draw() is never automatically invoked</li> <li><b>1</b> : draw() is invoked after each grid is finished</li> <li><b>2</b> : draw() is invoked incrementally after each row is
received. (but buffering may cause lines to come in groups
anyway)</li> </ul> <br>
<br><b>method</b> setcursor <b>(</b><i>0..63</i> cursor<b>)</b>
Selects one of the 64 predefined cursors of X11. (Note that if
your cursor table has them numbered from 0 to 126 using only even
numbers, then those cursor numbers are all doubled compared to
the ones GridFlow uses.) <br>
<br><b>method</b> hidecursor <b>(</b><b>)</b>
This makes the cursor invisible. <br>
<br><b>outlet 0 </b><b>method</b> position <b>(</b><i>integer</i> y<b>, </b><i>integer</i> x<b>, </b><i>integer</i> buttons<b>)</b> <p>This is emitted every time the cursor moves inside
the window connected to this format handler. This is also
emitted when the cursor is dragging from inside to outside
the window. This is also emitted when a mouse button is pressed.</p> <p>The y and x coordinates are relative to the upper
right corner of the window. Specific button states may be
extracted from the button value by applying [>>
buttonnumber] and then checking whether the result is odd.
Button numbers normally are: <ul> <li><b>0</b> : Shift</li> <li><b>1</b> : CapsLock</li> <li><b>2</b> : Control</li> <li><b>3</b> : Alternate</li> <li><b>4</b> : NumLock</li> <li><b>5</b> : ???</li> <li><b>6</b> : Meta</li> <li><b>7</b> : ScrollLock</li> <li><b>8</b> : Left Button</li> <li><b>9</b> : Middle Button</li> <li><b>10</b> : Right Button</li> <li><b>11</b> : Wheel Up</li> <li><b>12</b> : Wheel Down</li> </ul></p> <p>NOTE: This message form may become longer in the future, but the already defined parts will stay the same.</p> <br>
<br><b>outlet 0 </b><b>method</b> keypress <b>(</b><i>integer</i> y<b>, </b><i>integer</i> x<b>, </b><i>integer</i> buttons<b>, </b><i>symbol</i> keyname<b>)</b> <p>Similar to <kbd><font color="#007777">position</font></kbd> above, but this is emitted when a
keyboard key is pressed while this format handler's window
is active. Keynames follow the X11 standard, similarly to PureData's [keyname] object.
The only exception is that keynames that are digits get prefixed by a capital D so that
they don't get mistaken for actual numbers.</p> <p>NOTE: This message form may become longer in the future, but the already defined parts will stay the same.</p> <br>
<br><b>outlet 0 </b><b>method</b> keyrelease <b>(</b><i>integer</i> y<b>, </b><i>integer</i> x<b>, </b><i>integer</i> buttons<b>, </b><i>symbol</i> keyname<b>)</b>
Same as keypress but when a key gets released instead. <p>NOTE: This message form may become longer in the future, but the already defined parts will stay the same.</p> <br>
<br></td></tr><tr><td></td><td></td><td> </td></tr>
<tr><td colspan="4" bgcolor="#ffb080"><b> class </b><a name="format quartz #out">format quartz #out</a></td></tr><tr><td></td><td valign="top"><br>
<img src="flow_classes/format quartz %23out-icon.png" alt="[format quartz #out]" border="0"><br clear="left"><br><br><br clear="left"><br></td><td><br>
The equivalent of format x11 on MacOS 10.x, but with less features (sorry). <br><b>method</b> open <b>(</b><b>)</b>
opens a dim(240,320,3) rgb window (default). <br>
<br><b>method</b> grid <b>(</b><i>grid(rows columns {red green blue})</i> grid<b>)</b>
Sends image to screen. Window will be resized to fit the image exactly. <br>
<br></td></tr><tr><td></td><td></td><td> </td></tr>
<tr><td colspan="4" bgcolor="#ffb080"><b> class </b><a name="format sdl #out">format sdl #out</a></td></tr><tr><td></td><td valign="top"><br>
<img src="flow_classes/format sdl %23out-icon.png" alt="[format sdl #out]" border="0"><br clear="left"><br><br><br clear="left"><br></td><td><br>
<br><b>method</b> open <b>(</b><b>)</b>
Opens a dim(240,320,3) rgb window (default). <br>
<br><b>method</b> grid <b>(</b><i>grid(rows columns {red green blue})</i> grid<b>)</b>
Sends image to screen. Window will be resized to fit the image exactly. <br>
<br></td></tr><tr><td></td><td></td><td> </td></tr>
<tr><td colspan="4" bgcolor="#ffb080"><b> class </b><a name="format aalib #out">format aalib #out</a></td></tr><tr><td></td><td valign="top"><br>
<img src="flow_classes/format aalib %23out-icon.png" alt="[format aalib #out]" border="0"><br clear="left"><br><br><br clear="left"><br></td><td><br>
<br><b>method</b> open aalib <b>(</b>driver<b>, </b>args...<b>)</b> <br>
<br><b>method</b> grid <b>(</b><i>grid(rows columns {white})</i> grid<b>)</b>
converts a greyscale image to an ascii image and possibly
displays it. note that the image is typically downscaled by
a factor of 2 by aalib itself. <br>
<br><b>method</b> grid <b>(</b><i>grid(rows columns {ascii attr})</i> grid<b>)</b>
the inverse of "dump". Both together in a loop allow to
post-process aalib's buffer before displaying. Goes well
with "draw", "autodraw". <br>
<br><b>method</b> print <b>(</b><i>int</i> y<b>, </b><i>int</i> x<b>, </b><i>int</i> attr<b>, </b><i>symbol</i> text<b>)</b> <br>
<br><b>method</b> autodraw <b>(</b><b>)</b>
like X11's autodraw. <br>
<br><b>method</b> draw <b>(</b><b>)</b>
like X11's draw. <br>
<br><b>method</b> dump <b>(</b><b>)</b>
produces a Dim[y,x,2] grid whose two channels are
ascii character codes and character attributes. <br>
<br></td></tr><tr><td></td><td></td><td> </td></tr>
<tr><td colspan="4" bgcolor="#ffb080"><b> class </b><a name="format window #out">format window #out</a></td></tr><tr><td></td><td valign="top"><br>
<img src="flow_classes/format window %23out-icon.png" alt="[format window #out]" border="0"><br clear="left"><br><br><br clear="left"><br></td><td><br>
<br><b>method</b> open window <b>(</b><b>)</b>
Equivalent to "open x11", but this can be set by putting a line like
this in the config file: <kbd><font color="#007777">GridFlow.formats[:window] = GridFlow.formats[:x11]</font></kbd>
(and similarly other aliases can be created too) <br>
<br></td></tr><tr><td></td><td></td><td> </td></tr>
<tr><td> </td></tr>
<td colspan="4" bgcolor="black">
<img src="images/black.png" width="1" height="2"></td></tr>
<tr><td colspan="4">
<p><font size="-1">
GridFlow 0.8.0 Documentation<br>
Copyright © 2001,2002,2003,2004,2005 by Mathieu Bouchard
<a href="mailto:matju@sympatico.ca">matju(a)artengine.ca</a>
</font></p>
</td></tr></table></body></html>
--- NEW FILE: format.xml ---
<?xml version="1.0" standalone="no" ?>
<!DOCTYPE documentation SYSTEM 'jmax.dtd'>
<documentation title="Reference Manual: Format Classes">
<!-- $Id: format.xml,v 1.1 2005/10/04 02:09:42 matju Exp $ -->
<!--
GridFlow Reference Manual: Format Handler Reference
Copyright (c) 2001,2002,2003,2004,2005 by Mathieu Bouchard
-->
<section name="Objects for Input/Output">
<class name="#in">
<icon text="[#in]"/>
<help text="[#in]" image="#inout"/>
<method name="init" min="0">
<arg name="format"/>
<rest name="format_specific_part"/>
If no arguments given, creates an input object for an unspecified
format. You then need to use the <k>"open"</k> command to link
a format handler to it.
If arguments given, the <k>"open"</k> command is immediately called
with those arguments.
Remember that most formats produce Dim[rows,columns,3] grids with
0-255 values. (Most.)
</method>
<inlet id="0">
<method name="open" min="1">
<arg name="format"/>
<rest name="format_specific_part"/>
This is the command that gives a particular resource
to a <k>[#out]</k> object. This is done through a "format"
(there is a list of formats in this manual). The other
arguments depend on the chosen format. The format may
be a file format or a protocol or a hardware device, etc.
The format called "file" is a special shortcut that autodetects the
type of file (by name suffix) and picks up the appropriate handler.
</method>
<method name="open">
<arg name="filename"/>
This is a shortcut for <k>"open file"</k> followed by a filename.
The filename must contain a dot, else it will be seen as a handler name.
</method>
<method name="close">
close may be necessary if you operate on <k>"/dev/video"</k>,
which can only be read by one at a time. otherwise it's
usually not necessary.
</method>
<method name="int">
<arg name="frame_number"/>
selects one picture from a multi-picture format
and then does the same as a bang.
</method>
<method name="set">
<arg name="frame_number"/>
selects one picture from a multi-picture format,
to be displayed by the next bang.
</method>
<method name="bang">
sends a grid through the outlet. the grid may be the
result of reading from a file, acquiring from a device,
capturing from the screen etc.
this is format-specific. most formats
produce grid(rows columns {red green blue}).
In formats that read from a file, reading another picture
will continue if there are several pictures in the
same file, but if the end of file is reached instead,
it will rewind and send the first picture again.
see section "External Picture Formats".
</method>
<method name="option">
<arg name="selector" type="symbol"/>
<rest name="stuff"/>
Obsolete. the word "option" is optional now.
</method>
<method name="rewind">
rewinds to beginning of file if applicable.
</method>
<method name="loop">
<arg name="flag" type="bool"/>
controls the automatic looping of movies.
</method>
</inlet>
<outlet id="1">
<method name="int">
frame number of frame just sent,
for formats that have frame numbers.
</method>
<method name="bang">
tried to read a frame that does not exist
(signals end of file)
</method>
</outlet>
</class>
<class name="#out">
<icon text="[#out]"/>
<help text="[#out]" image="#inout"/>
<method name="init" min="0">
<arg name="format"/>
<rest name="format_specific_part"/>
If no arguments given, creates an output object for an unspecified
format. You then need to use the <k>"open"</k> command to link
a format handler to it.
If arguments given, the <k>"open"</k> command is immediately called
with those arguments.
Remember that most formats expect dim(rows,columns,3) grids with
0-255 values. (Most.)
</method>
<method name="init">
<arg name="rows" type="integer"/>
<arg name="columns" type="integer"/>
This alternate way to create an <k>[#out]</k> automatically calls
<k>"open window"</k> and <k>"out_size <i>rows columns</i>"</k>.
</method>
<inlet id="0">
<method name="open" min="1">
<arg name="format"/>
<rest name="format_specific_part"/>
This is the command that gives a particular resource
to a <k>[#out]</k> object. This is done through a "format"
(there is a list of formats in this manual). The other
arguments depend on the chosen format. The format may
be a file format or a protocol or a hardware device, etc.
</method>
<method name="open file">
The format called "file" is a special shortcut that autodetects the
type of file (by name suffix) and picks up the appropriate handler.
</method>
<method name="open">
<arg name="filename"/>
This is a shortcut for "open file" followed by a filename.
The filename must contain a dot, else it will be seen as a handler name.
</method>
<method name="grid"><arg name="grid" type="grid"/>
this is format-specific. most formats
expect grid(rows columns {red green blue}).
In formats that write to a file, sending a 2nd picture
overwrites the first.
see section "External Picture Formats".
</method>
<method name="close">
closes the file. usually not necessary.
</method>
<method name="option">
<arg name="selector" type="symbol"/>
<rest name="stuff"/>
Obsolete. Omit the word "option" now.
</method>
<method name="timelog">
<arg name="status" type="0,1"/>
when status=1, current time (unix clock) and time since last
frame-end are printed in the console. when status=0, it is off.
default is 0.
</method>
<method name="rewind">
rewinds to beginning of file if applicable.
will overwrite the previous data.
</method>
</inlet>
<outlet id="0">
<method name="bang">
sent when a complete grid has been received.
</method>
</outlet>
</class>
<class name="#peephole">
<p>
This object class only works with a X11-based version of Pd.
(e.g. on Linux, BSD, but not MacOS X).
</p>
<p>Similar to <k>[#out window]</k>, except it creates an inset in the patch you put it
in, and a scaled version of the picture appears in the inset. It also emits the same messages
as <k>[#out window]</k> and automatically scales cursor position according to the current scale factor.
The scale factor is decided automatically.
</p>
<method name="init">
<arg name="height" type="int"/>
<arg name="width" type="int"/>
</method>
<p>All other methods are as in <k>[#out window]</k>.</p>
</class>
<class name="#mouse">
This will process the "position" messages emitted by <k>[#out]</k> or <k>[#peephole]</k> in
useful ways.
<outlet id="0"><method name="list">
y,x coords of a click
</method></outlet>
<outlet id="1"><method name="list">
y,x coords of a drag (any button is kept pressed)
</method></outlet>
<outlet id="2"><method name="list">
y,x coords of an unclick
</method></outlet>
<outlet id="3"><method name="list">
y,x coords of a move (no button is pressed)
</method></outlet>
<outlet id="4"><method name="float" type="0,1">button 1 status</method></outlet>
<outlet id="5"><method name="float" type="0,1">button 2 status</method></outlet>
<outlet id="6"><method name="float" type="0,1">button 3 status</method></outlet>
<outlet id="7"><method name="float" type="-1,1">
wheel difference: -1 = roll up; 1 = roll down.
</method></outlet>
</class>
<class name="#camera">
Works about like <k>[#in videodev]</k> except you can right-click-open it to access all of the
camera settings visually.
</class>
</section>
<section name="Picture/Movie Formats">
<class name="format ppm #in/#out">
<icon image="format_ppm" text="[open filename.ppm]"/>
<p>Subformat P6 only.
Max-number can only be 255 (24-bit RGB).
</p>
<method name="open ppm file">
<arg name="filename" type="symbol"/>
opens the specified file, taken from the current
directory.
</method>
<method name="open ppm gzfile">
<arg name="filename" type="symbol"/>
same but for .ppm.gz files
</method>
<method name="grid">
<arg name="grid" type="grid(rows columns {r g b})"/>
values 0-255
</method>
</class>
<class name="format targa #in/#out">
<icon image="format_targa" text="[open filename.tga]"/>
<p>Support for RGB-24 (3 channels) and RGBA-32 (4 channels)</p>
<method name="open targa file">
<arg name="filename" type="symbol"/>
opens the specified file, taken from the current
directory.
</method>
<method name="open targa gzfile">
<arg name="filename" type="symbol"/>
same but for .tga.gz files
</method>
<method name="grid"><arg name="grid" type="grid(rows columns 3)"/>RGB-24</method>
<method name="grid"><arg name="grid" type="grid(rows columns 4)"/>RGBA-32</method>
</class>
<class name="format jpeg #in/#out">
<!--<icon image="format_jpeg" text="[open foo.jpg]"/>-->
<p>Support for RGB non-progressive</p>
<method name="open jpeg file">
<arg name="filename" type="symbol"/>
opens the specified file, taken from the current
directory.
</method>
<method name="grid">
<arg name="grid" type="grid(rows columns 3)"/>RGB-24
</method>
</class>
<class name="format png #in">
<!--<icon image="format_jpeg" text="[open foo.jpg]"/>-->
<p>Support for RGB non-progressive</p>
<method name="open png file">
<arg name="filename" type="symbol"/>
opens the specified file, taken from the current
directory.
</method>
<method name="grid"><arg name="grid" type="grid(rows columns 1)"/>Y-8 (greyscale)</method>
<method name="grid"><arg name="grid" type="grid(rows columns 2)"/>YA-16 (greyscale and transparency)</method>
<method name="grid"><arg name="grid" type="grid(rows columns 3)"/>RGB-24 (colour)</method>
<method name="grid"><arg name="grid" type="grid(rows columns 4)"/>RGBA-32 (colour and transparency)</method>
</class>
<class name="format quicktime #in/#out">
<p>Support for .mov files.</p>
<p>This format supports frame-seek and frame-tell.</p>
<p>Uses the HW-QuickTime library aka QuickTime4Linux
(libquicktime.so). There is also a variant on the same library and that project
is just called LibQuickTime.</p>
<p>Some versions of those libraries may include support for different codecs,
and some also may support entirely different wrapper formats such as AVI.</p>
<p>On Macintosh, Apple QuickTime is used instead, but several of the following
messages may not be available.</p>
<method name="open quicktime file">
<arg name="filename" type="symbol" />
</method>
<method name="codec">
<arg name="codec" type="symbol"/>
Allowed values are at least: raw, jpeg, png, mjpa, yuv2, yuv4.
Some other values may allowed, depending on the version of the library
and which codec plugins are installed.
Must be set before the first frame is written.
only applies to <k>[#out]</k>. Choosing a codec is important
because codecs influence greatly the speed of
encoding, the speed of decoding,
the size of the written file, and its fidelity to the
original content. Note that there exist other Apple-QuickTime
codecs that are not supported by HW-QuickTime.
</method>
<method name="parameter">
<arg name="key" type="symbol"/>
<arg name="value" type="int"/>
Sets special codec-specific settings.
For example: <k>"parameter jpeg_quality 75"</k>
</method>
<method name="framerate">
<arg name="fps" type="int"/>
Sets the framerate of the file.
This is not used by GridFlow when reading a file, but other
programs usually care.
</method>
<method name="colorspace">
<arg name="colorspace" type="symbol"/>
Allowed values are rgb, rgba, bgr, bgra, yuv, yuva.
Normally you don't need this.
</method>
<method name="size">
<arg name="height" type="int"/>
<arg name="width" type="int"/>
Forces a window size when writing. Usually this has to be used <u>after</u>
setting the framerate and codec and <u>before</u> setting the codec-parameters.
(Strange. Sorry.)
</method>
<method name="force_size">
<arg name="height" type="int"/>
<arg name="width" type="int"/>
forces a window size when reading.
this is a workaround for a problem in HW-QuickTime.
</method>
</class>
<class name="format mpeg #in">
<icon image="format_mpeg" text="[open mpeg file filename.mpeg]"/>
<p>support for .mpeg files</p>
<p>this format supports frame-seek and frame-tell.</p>
<p>Two different libraries are available for dealing with
MPEG files. Those have different details, capabilities and quirks.</p>
<p>In any case, GridFlow does not support importing audio from
those files.</p>
<p>If you use the HeroineWarrior library, you may open several
mpeg files at once, but not with the GregWard library.</p>
<p>Libraries may scream error messages in a rude way.</p>
<p>By opposition to PPM and TARGA, this format driver only
allows a single MPEG stream per file (you cannot "cat"
several MPEG files together).
</p>
<p>Supports Rewind and Frame Select.</p>
<method name="open mpeg file">
<arg name="filename" type="symbol"/>
opens the specified file, taken from the current
directory.
</method>
</class>
<class name="format grid #in/#out">
<icon image="format_grid" text="[open grid file filename.grid]"/>
<icon image="format_grid_tcp" text="[open grid tcp artengine.ca 4242]"/>
<icon image="format_grid_tcpserver" text="[open grid tcpserver 4242]"/>
<p>
This is GridFlow's special file format. This is the only I/O
format that can hold anything that the <k>[#store]</k> object can.
</p>
<p>
This is the picture format that would support TCP connections
if that feature actually worked. More on this later.
</p>
<method name="open grid file">
<arg name="filename" type="symbol"/>
opens the specified file, taken from the current
directory.
</method>
<method name="open grid gzfile">
<arg name="filename" type="symbol"/>
same but for .grid.gz files
</method>
<method name="open grid tcp">
<arg name="hostname" type="symbol"/>
<arg name="port" type="integer"/>
dials an specified hostname/port on the InterNet or
compatible network. the TCP protocol is used.
</method>
<method name="open grid tcpserver">
<arg name="port" type="integer"/>
waits for a call (and answers) for this port on the
local machine via InterNet or compatible network.
Answers the call.
</method>
<method name="type int32">
output will be as 32 bit signed integers.
</method>
<method name="type uint8">
output will be as 8 bit unsigned integers.
</method>
<method name="headerful">
cancels "headerless" (and back to reading .grid)
</method>
<method name="headerless">
<rest name="dimensions" type="integer"/>
instead of reading .grid files with header, will read raw data,
faking a .grid header to itself. It will use the hereby specified
dimension list, as well as two other settings:
<k>type</k> and <k>endian</k>.
</method>
<p>When writing "raw" data, a file may be considered a long string of
base 256 digits (called bytes), but different computers have different
conventions for dealing with them:
<method name="endian" type="symbol(big|endian|same)">
<list><li>big:
A number will be written starting with the biggest digit.
This is the natural way on the Macintosh, Sun, Amiga, and so on.
</li>
<li>little:
A number will be written starting with the smallest digit.
This is the natural way on the Intel 386/Pentium.
</li>
<li>same:
A number will be written in whichever way is more natural
on this computer. The natural way is slightly faster to handle.
This is the default setting.
</li>
</list>
</method>
</p>
</class>
</section>
<section name="Acquisition Devices">
<class name="format videodev #in">
<icon image="format_videodev" text="[open /dev/video0]"/>
<method name="open">
<arg name="device"/>
</method>
<p>Video4Linux-1 devices, RGB-24 only. Variable picture size.</p>
<p>We have been testing it using cards of the BT-848 family,
such as Miro DC10plus and Hauppauge WinTV, using the <k>bttv.o</k> linux driver.
Also we have been testing using Logitech QuickCam (and similar Labtec hardware),
but don't use the <k>qce-ga</k> driver, which is buggy and obsolete: the <k>qc-usb</k>
works better.</p>
<p>Some hardware doesn't support RGB, so you may have to select a YUV colorspace
(see below) and then use <k>[#yuv_to_rgb]</k>. Don't forget to also do
<k>[# min 255]</k> and <k>[# max 0]</k>.
</p>
<p>If for some reason there's a bug that causes a driver to produce BGR instead of RGB,
so that red and blue are swapped, you can swap them back by filtering through a RGB-BGR
converter, such as <k>[#inner * + 0 {3 3 # 0 0 1 0 1 0 1 0 0}]</k>.</p>
<p>color adjustments:
<method name="brightness"><arg name="level" type="0-65535"/></method>
<method name="hue" ><arg name="level" type="0-65535"/></method>
<method name="colour" ><arg name="level" type="0-65535"/></method>
<method name="contrast" ><arg name="level" type="0-65535"/></method>
<method name="whiteness" ><arg name="level" type="0-65535"/></method>
</p>
<method name="get">
<arg name="attr" type="symbol"/>
gets a specific attribute. a message is sent through right outlet.
valid attributes are: brightness, hue, colour, contrast, whiteness.
</method>
<method name="get">
gets all attributes.
</method>
<p>other options:
<method name="channel" ><arg type="integer"/></method>
<method name="tuner" ><arg type="integer"/></method>
<method name="norm" ><arg type="integer"/></method>
<method name="frequency" ><arg type="integer"/></method>
<method name="transfer" >
<arg type="symbol(read|mmap)"/>
<arg type="integer" default="2"/>
<list>
<li>mmap:
This is the normal (and fast) way of transferring pictures
from the camera.
</li>
<li>read:
Some cameras/drivers only support this instead of mmap.
</li></list>
In case of mmap, the extra numeric argument sets the
queue length in number of frames, so you can select an
appropriate tradeoff between efficiency and latency.
</method>
<method name="colorspace">
<arg name="colorspace" type="symbol"/>
Allowed values are: RGB24, YUV420P.
Use this if your driver doesn't support RGB24.
</method>
<method name="size">
<arg name="height"/>
<arg name="width"/>
sets the input size, especially when using a video digitalizer
device.
</method>
</p>
</class>
</section>
<section name="Window Output">
<class name="format x11 #in/#out">
<icon image="format_x11" text="[open window]"/>
<icon image="format_x11_remote" text="[open x11 remote artengine.ca 10]"/>
<p>supports 15,16,24,32-bit truecolor displays</p>
<p>now also support 8-bit indexed displays, using a private colormap
configured as 3:3:2 RGB. When using 8-bit you can specify the
"use_stripes" option to use a completely different color scheme
involving R,G,B diagonal stripes, a kind of 6:6:6 RGB spread over three
pixels.</p>
<p>If you are using Windows or MacOS 10: you will have to install
a X11 server. This will emulate Unix display on your OS. (note:
Unix systems also need a X11 server, but it's built-in and handles
the video driver directly). In the case of MacOS 10 and QNX that both
use non-X11 display technology on top of a basically Unix OS, the
OS comes with a X11 server, but it may be on a "bundled software"
CD.</p>
<method name="open x11">
synonym of "open x11 here".
</method>
<method name="open x11 here">
connects to the default X11 server,
according to your environment variable "DISPLAY".
</method>
<method name="open x11 local">
<arg name="display_number" type="integer"/>
connects to a display server on this machine.
</method>
<method name="open x11 remote">
<arg name="host_name" type="symbol"/>
<arg name="display_number" type="integer"/>
connects to a remote X11 display server using TCP.
Sorry, IP addresses are not supported.
Port number will be 6000 plus the display number, because
of the X11 standard.
</method>
<method name="grid">
<arg name="grid" type="grid(rows columns {red green blue})"/>
resizes the window to the size of the grid;
encodes that grid in the display's pixel format;
also displays it if autodraw > 0
the values must be in range 0-255,
or else they will be "wrapped".
</method>
<p>
Destroying the object (or sending "close") should close the window.
</p>
<p>because of the design of Xlib, or if any of the connections
involved crashes, then the whole program has to be terminated.
(don't you love xlib). Something similar happens if you close any
of the windows yourself, but IIRC this could be fixed.</p>
<p>only one window may be used per connection (to simplify matters;
this doesn't reduce flexibility).</p>
<p>there is an additional argument that may be added to every
<k>"open"</k> message; if you don't put it, a new toplevel window is created.
if you put "root" then the screen's wallpaper will be used instead
(it may fail to work with some popular window managers). You can also
put a window number, e.g. <k>0x28003ff</k>, you may connect to
an existing window; you can find out the number of a window by using
a tool like <k>xwininfo</k>, part of X11 standard tools.</p>
<method name="out_size">
<arg name="height" type="integer"/>
<arg name="width" type="integer"/>
changes the window's size, just like sending a grid
dim(height,width,3) would.
this affects the size of screen captures too.
</method>
<method name="draw">
forces a redraw of the window's contents.
</method>
<method name="autodraw">
<arg name="level" type="0,1,2"/>
<list start="0">
<li>draw() is never automatically invoked</li>
<li>draw() is invoked after each grid is finished</li>
<li>draw() is invoked incrementally after each row is
received. (but buffering may cause lines to come in groups
anyway)</li>
</list>
</method>
<method name="setcursor">
<arg name="cursor" type="0..63"/>
Selects one of the 64 predefined cursors of X11. (Note that if
your cursor table has them numbered from 0 to 126 using only even
numbers, then those cursor numbers are all doubled compared to
the ones GridFlow uses.)
</method>
<method name="hidecursor">
This makes the cursor invisible.
</method>
<outlet id="0">
<method name="position">
<arg name="y" type="integer"/>
<arg name="x" type="integer"/>
<arg name="buttons" type="integer"/>
<p>This is emitted every time the cursor moves inside
the window connected to this format handler. This is also
emitted when the cursor is dragging from inside to outside
the window. This is also emitted when a mouse button is pressed.</p>
<p>The y and x coordinates are relative to the upper
right corner of the window. Specific button states may be
extracted from the button value by applying [>>
buttonnumber] and then checking whether the result is odd.
Button numbers normally are:
<list start="0">
<li>Shift</li>
<li>CapsLock</li>
<li>Control</li>
<li>Alternate</li>
<li>NumLock</li>
<li>???</li>
<li>Meta</li>
<li>ScrollLock</li>
<li>Left Button</li>
<li>Middle Button</li>
<li>Right Button</li>
<li>Wheel Up</li>
<li>Wheel Down</li>
</list></p>
<p>NOTE: This message form may become longer in the future, but the already defined parts will stay the same.</p>
</method>
<method name="keypress">
<arg name="y" type="integer"/>
<arg name="x" type="integer"/>
<arg name="buttons" type="integer"/>
<arg name="keyname" type="symbol"/>
<p>Similar to <k>position</k> above, but this is emitted when a
keyboard key is pressed while this format handler's window
is active. Keynames follow the X11 standard, similarly to PureData's [keyname] object.
The only exception is that keynames that are digits get prefixed by a capital D so that
they don't get mistaken for actual numbers.</p>
<p>NOTE: This message form may become longer in the future, but the already defined parts will stay the same.</p>
</method>
<method name="keyrelease">
<arg name="y" type="integer"/>
<arg name="x" type="integer"/>
<arg name="buttons" type="integer"/>
<arg name="keyname" type="symbol"/>
Same as keypress but when a key gets released instead.
<p>NOTE: This message form may become longer in the future, but the already defined parts will stay the same.</p>
</method>
</outlet>
</class>
<class name="format quartz #out">
The equivalent of format x11 on MacOS 10.x, but with less features (sorry).
<method name="open">
opens a dim(240,320,3) rgb window (default).
</method>
<method name="grid">
<arg name="grid" type="grid(rows columns {red green blue})"/>
Sends image to screen. Window will be resized to fit the image exactly.
</method>
</class>
<class name="format sdl #out">
<method name="open">
Opens a dim(240,320,3) rgb window (default).
</method>
<method name="grid">
<arg name="grid" type="grid(rows columns {red green blue})"/>
Sends image to screen. Window will be resized to fit the image exactly.
</method>
</class>
<class name="format aalib #out">
<method name="open aalib">
<arg name="driver">
Normally "X11" with uppercase X; else consult
the AALib manual.
</arg>
<rest name="args">
You can pass "commandline options" of AALib here.
</rest>
</method>
<method name="grid">
<arg name="grid" type="grid(rows columns {white})"/>
converts a greyscale image to an ascii image and possibly
displays it. note that the image is typically downscaled by
a factor of 2 by aalib itself.
</method>
<method name="grid">
<arg name="grid" type="grid(rows columns {ascii attr})"/>
the inverse of "dump". Both together in a loop allow to
post-process aalib's buffer before displaying. Goes well
with "draw", "autodraw".
</method>
<method name="print">
<arg name="y" type="int"/>
<arg name="x" type="int"/>
<arg name="attr" type="int"/>
<arg name="text" type="symbol"/>
</method>
<method name="autodraw">
like X11's autodraw.
</method>
<method name="draw">
like X11's draw.
</method>
<method name="dump">
produces a Dim[y,x,2] grid whose two channels are
ascii character codes and character attributes.
</method>
</class>
<class name="format window #out">
<method name="open window">
Equivalent to "open x11", but this can be set by putting a line like
this in the config file: <k>GridFlow.formats[:window] = GridFlow.formats[:x11]</k>
(and similarly other aliases can be created too)
</method>
</class>
</section>
</documentation>
--- NEW FILE: architecture.html ---
<html><head>
<!-- $Id: architecture.html,v 1.1 2005/10/04 02:09:42 matju Exp $ -->
<title>GridFlow 0.8.0 - Reference Manual: Architecture</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<link rel="stylesheet" href="gridflow.css" type="text/css">
</head>
<body bgcolor="#FFFFFF"
leftmargin="0" topmargin="0"
marginwidth="0" marginheight="0">
<table width="100%" bgcolor="white" border="0" cellspacing="2">
<tr><td colspan="4" bgcolor="#082069">
<img src="images/titre_gridflow.png" width="253" height="23">
</td></tr><tr><td> </td></tr>
<tr><td colspan="4" bgcolor="black">
<img src="images/black.png" width="1" height="2"></td></tr>
<tr><td colspan="4" height="16">
<h4>GridFlow 0.8.0 - Reference Manual: Architecture</h4>
</td></tr>
<tr>
<td width="5%" rowspan="2"> </td>
<td width="15%" height="23"> </td>
<td width="80%" height="23"> </td>
<td width="5%" height="23"> </td>
</tr>
<tr><td colspan="2"><div cols="1"><h4><a href="#Numbers">Numbers</a></h4><ul>
</ul>
<h4><a href="#Grid_Literals">Grid Literals</a></h4><ul>
</ul>
<h4><a href="#Grid_Protocol">Grid Protocol</a></h4><ul>
</ul>
<h4><a href="#Picture_Protocol">Picture Protocol</a></h4><ul>
</ul>
<h4><a href="#Numeric_Operators">Numeric Operators</a></h4><ul>
</ul>
<h4><a href="#Synchronisation">Synchronisation</a></h4><ul>
</ul>
<h4><a href="#Bridges">Bridges</a></h4><ul>
</ul>
<br><br>
</div></td></tr> <tr><td colspan="4" bgcolor="black">
<img src="images/black.png" width="1" height="2"></td></tr>
<tr><td colspan="4"><a name="Numbers"></a><h4>Numbers</h4></td></tr><tr><td></td><td></td><td> </td></tr>
<tr><td></td><td></td><td><p>High-performance computation requires precise and quite peculiar
definitions of numbers and their representation.</p></td></tr>
<tr><td></td><td></td><td> </td></tr>
<tr><td></td><td></td><td><p>Inside most programs, numbers are written down as strings of
bits. A bit is either zero or one. Just like the decimal system
uses units, tens, hundreds, the binary system uses units, twos,
fours, eights, sixteens, and so on, doubling every time.</p></td></tr>
<tr><td></td><td></td><td> </td></tr>
<tr><td></td><td></td><td><p>One notation, called integer allows for only integer values to be
written (no fractions). when it is unsigned, no negative values may
be written. when it is signed, one bit indicates whether the number
is positive or negative. Integer storage is usually fixed-size, so you have
bounds on the size of numbers, and if a result is too big it "wraps around", truncating the biggest
bits.</p></td></tr>
<tr><td></td><td></td><td> </td></tr>
<tr><td></td><td></td><td><p>Another notation, called floating point (or float) stores numbers using
a fixed number of significant digits, and a scale factor that allows for huge numbers
and tiny fractions at once. Note that 1/3 has periodic digits, but even 0.1 has periodic digits,
in binary coding; so expect some slight roundings; the precision offered should be
sufficient for most purposes. Make sure the errors of rounding don't accumulate, though.</p></td></tr>
<tr><td></td><td></td><td> </td></tr>
<tr><td></td><td></td><td><p>This little program of mine prints 1/3 in base 2 (only digits after the period): <kbd><font color="#007777">ruby -e 'x=1/3.0;for i in 0..52 do x*=2;y=x.floor;print y;x-=y end;puts'</font></kbd></p></td></tr>
<tr><td></td><td></td><td> </td></tr>
<tr><td></td><td></td><td><p>In GridFlow, there are six kinds of numbers:</p></td></tr>
<tr><td></td><td></td><td> </td></tr>
<tr><td></td><td></td><td><tr><td></td><td></td><td><table border="0" bgcolor="black" cellspacing="1"><tr><td valign="top" align="left"><table bgcolor="white" border="0" cellpadding="4" cellspacing="1"><tr><td bgcolor="#808080"><font color="#ffffff"><b>name</b></font></td><td bgcolor="#808080"><font color="#ffffff"><b>aliases</b></font></td><td bgcolor="#808080"><font color="#ffffff"><b>range</b></font></td><td bgcolor="#808080"><font color="#ffffff"><b>size (bytes)</b></font></td><td bgcolor="#808080"><font color="#ffffff"><b>precision</b></font></td><td bgcolor="#808080"><font color="#ffffff"><b>description</b></font></td></tr> <tr><td bgcolor="#ffffff">uint8</td><td bgcolor="#ffffff">u8 b</td><td bgcolor="#ffffff">0..255</td><td bgcolor="#ffffff">1</td><td bgcolor="#ffffff">1</td><td bgcolor="#ffffff">
unsigned 8-bit integer.
this is the usual size of numbers taken from files and cameras, and
written to files and to windows. (however this gets converted to <kbd><font color="#007777">int32</font></kbd>
unless otherwise specified.) </td></tr> <tr><td bgcolor="#f0f8ff">int16</td><td bgcolor="#f0f8ff">i16 s</td><td bgcolor="#f0f8ff">±2<sup>15</sup> = -32768..32767</td><td bgcolor="#f0f8ff">2</td><td bgcolor="#f0f8ff">1</td><td bgcolor="#f0f8ff">...</td></tr> <tr><td bgcolor="#ffffff">int32</td><td bgcolor="#ffffff">i32 i</td><td bgcolor="#ffffff">±2<sup>31</sup> = -2147483648..2147483647</td><td bgcolor="#ffffff">4</td><td bgcolor="#ffffff">1</td><td bgcolor="#ffffff">
signed 32-bit integer.
this is used for most computations. </td></tr> <tr><td bgcolor="#f0f8ff">int64</td><td bgcolor="#f0f8ff">i64 l</td><td bgcolor="#f0f8ff">±2<sup>63</sup></td><td bgcolor="#f0f8ff">8</td><td bgcolor="#f0f8ff">1</td><td bgcolor="#f0f8ff">...</td></tr> <tr><td bgcolor="#ffffff">float32</td><td bgcolor="#ffffff">f32 f</td><td bgcolor="#ffffff">±10<sup>±38</sup></td><td bgcolor="#ffffff">4</td><td bgcolor="#ffffff">23 bits = 0.000012% (about 7 digits)</td><td bgcolor="#ffffff">...</td></tr> <tr><td bgcolor="#f0f8ff">float64</td><td bgcolor="#f0f8ff">f64 d</td><td bgcolor="#f0f8ff">±10<sup>±308</sup></td><td bgcolor="#f0f8ff">8</td><td bgcolor="#f0f8ff">52 bits (about 15 digits)</td><td bgcolor="#f0f8ff">...</td></tr> </table></td></tr></table></td></tr></td></tr>
<tr><td></td><td></td><td> </td></tr>
<tr><td> </td></tr>
<tr><td colspan="4" bgcolor="black">
<img src="images/black.png" width="1" height="2"></td></tr>
<tr><td colspan="4"><a name="Grid_Literals"></a><h4>Grid Literals</h4></td></tr><tr><td></td><td></td><td> </td></tr>
<tr><td></td><td></td><td><p>
In every grid-accepting inlet, a list may be sent instead; if
it consists only of integers, it will be converted to a
one-dimensional grid. Else it may contain a single "#" sign and
integers on both sides of it, where the ones to the left of it are
fed as arguments to an imaginary <kbd><font color="#007777">[#redim]</font></kbd> object and the one to the
right of it are fed through that <kbd><font color="#007777">[#redim]</font></kbd>. </p></td></tr>
<tr><td></td><td></td><td> </td></tr>
<tr><td></td><td></td><td><p>
In every grid-accepting inlet, an integer or float may also be sent;
it will be converted to a zero-dimensional grid (a <b>scalar</b>). </p></td></tr>
<tr><td></td><td></td><td> </td></tr>
<tr><td> </td></tr>
<tr><td colspan="4" bgcolor="black">
<img src="images/black.png" width="1" height="2"></td></tr>
<tr><td colspan="4"><a name="Grid_Protocol"></a><h4>Grid Protocol</h4></td></tr><tr><td></td><td></td><td> </td></tr>
<tr><td></td><td></td><td><p>
a grid has an associated number type that defines what are the possible values for its elements
(and how much space it takes). the default is <b>int32</b>. </p></td></tr>
<tr><td></td><td></td><td> </td></tr>
<tr><td></td><td></td><td><p>
a single-dimensional grid of 3 elements (a triplet) is called dim(3). a
three-dimensional grid of 240 rows of 320 columns of triplets is called
dim(240,320,3). </p></td></tr>
<tr><td></td><td></td><td> </td></tr>
<tr><td></td><td></td><td><p>
There is a sequence in which elements of a Grid are stored and
transmitted. Dimension 0 is called "first" and dimension N-1 is
called "last". They are called so because if you select a
position in the first dimension of a grid, the selected part is of the same
shape minus the first dimension; so in dim(240,320,3) if you select
row 51 (or whichever valid row number), you get a dim(320,3). if you select
a subpart two more times you get to a single number. </p></td></tr>
<tr><td></td><td></td><td> </td></tr>
<tr><td></td><td></td><td><p>
At each such level, elements are sent/stored in their numeric order,
and are numbered using natural numbers starting at 0. This ordering usually
does not matter, but sometimes it does. Most notably, <kbd><font color="#007777">[#import]</font></kbd>, <kbd><font color="#007777">[#export]</font></kbd> and <kbd><font color="#007777">[#redim]</font></kbd> care about it. </p></td></tr>
<tr><td></td><td></td><td> </td></tr>
<tr><td></td><td></td><td><p>
On the other hand, order of dimensions usually does matter; this is
what distinguishes rows from columns and channels, for example.
Most objects care about the distinction. </p></td></tr>
<tr><td></td><td></td><td> </td></tr>
<tr><td></td><td></td><td><p>
A grid with only 1 element in a given dimension is different from one
lacking that dimension; it won't have the same meaning. You can use this
property to your advantage sometimes. </p></td></tr>
<tr><td></td><td></td><td> </td></tr>
<tr><td></td><td></td><td><p>
Zero-dimensional grids exist. They are called dim(). They can only contain
a single number. </p></td></tr>
<tr><td></td><td></td><td> </td></tr>
<tr><td> </td></tr>
<tr><td colspan="4" bgcolor="black">
<img src="images/black.png" width="1" height="2"></td></tr>
<tr><td colspan="4"><a name="Picture_Protocol"></a><h4>Picture Protocol</h4></td></tr><tr><td></td><td></td><td> </td></tr>
<tr><td></td><td></td><td><p><i>This section is useful if you want to know what a picture is
in terms of a grid. </i></p></td></tr>
<tr><td></td><td></td><td> </td></tr>
<tr><td></td><td></td><td><p>A picture is a three-dimensional Grid: <ul> <li><b>0</b> : rows</li> <li><b>1</b> : columns</li> <li><b>2</b> : channels</li> </ul> </p></td></tr>
<tr><td></td><td></td><td> </td></tr>
<tr><td></td><td></td><td><p>Channels for the RGB color model are: <ul> <li><b>0</b> : red</li> <li><b>1</b> : green</li> <li><b>2</b> : blue</li> </ul> </p></td></tr>
<tr><td></td><td></td><td> </td></tr>
<tr><td></td><td></td><td><p>
Because Grids are made of 32-bit integers, a three-channel picture uses
96 bpp (bits per pixel), and have to be downscaled to 24 bpp (or 16 bpp)
for display. That huge amount of slack is there because when you create
your own effects you often have intermediate results that need to be of
higher precision than a normal picture. Especially, results of multiplications
are big and should not overflow before you divide them back to normal;
and similarly, you can have negative values all over, as long as you take
care of them before they get to the display. </p></td></tr>
<tr><td></td><td></td><td> </td></tr>
<tr><td></td><td></td><td><p>
In the final conversion, high bits are just ignored. This means: black is
0, maximum is 255, and values wrap like with <kbd><font color="#007777">% 256</font></kbd>. If you want to
clip them, you may use <kbd><font color="#007777">[# max 0]</font></kbd> and <kbd><font color="#007777">[# min 255]</font></kbd> objects. </p></td></tr>
<tr><td></td><td></td><td> </td></tr>
<tr><td> </td></tr>
<tr><td colspan="4" bgcolor="black">
<img src="images/black.png" width="1" height="2"></td></tr>
<tr><td colspan="4"><a name="Numeric_Operators"></a><h4>Numeric Operators</h4></td></tr><tr><td></td><td></td><td> </td></tr>
<tr><td></td><td></td><td><p>In the following table, A is the value entered to the
left, and B is the value entered to the right.</p></td></tr>
<tr><td></td><td></td><td> </td></tr>
<tr><td></td><td></td><td><p>Angles are in hundredths of degrees. This means a full circle
(two pi radians) is 36000. You convert from degrees to our angles
by multiplying by 100. You convert from radians to our angles by
multiplying by 18000/pi.</p></td></tr>
<tr><td></td><td></td><td> </td></tr>
<tr><td></td><td></td><td><p>Hyperbolic functions (tanh) work with our angles too, so the
same conversions apply.</p></td></tr>
<tr><td></td><td></td><td> </td></tr>
<tr><td></td><td></td><td><tr><td></td><td></td><td><table border="0" bgcolor="black" cellspacing="1"><tr><td valign="top" align="left"><table bgcolor="white" border="0" cellpadding="4" cellspacing="1"><tr><td bgcolor="#808080"><font color="#ffffff"><b>name</b></font></td><td bgcolor="#808080"><font color="#ffffff"><b>description</b></font></td><td bgcolor="#808080"><font color="#ffffff"><b>meaning in pixel context (pictures, palettes)</b></font></td><td bgcolor="#808080"><font color="#ffffff"><b>meaning in spatial context (indexmaps, polygons)</b></font></td></tr> <tr><td bgcolor="#ffffff"><img src="op/ignore-icon.png" border="0" alt="ignore"></td><td bgcolor="#ffffff"> A </td><td bgcolor="#ffffff">no effect</td><td bgcolor="#ffffff">no effect</td></tr> <tr><td bgcolor="#f0f8ff"><img src="op/put-icon.png" border="0" alt="put"></td><td bgcolor="#f0f8ff"> B </td><td bgcolor="#f0f8ff">replace by</td><td bgcolor="#f0f8ff">replace by</td></tr> <tr><td bgcolor="#ffffff"><img src="op/add-icon.png" border="0" alt="+"></td><td bgcolor="#ffffff"> A + B </td><td bgcolor="#ffffff">brightness, crossfade</td><td bgcolor="#ffffff">move, morph</td></tr> <tr><td bgcolor="#f0f8ff"><img src="op/sub-icon.png" border="0" alt="-"></td><td bgcolor="#f0f8ff"> A - B </td><td bgcolor="#f0f8ff">brightness, motion detection</td><td bgcolor="#f0f8ff">move, motion detection</td></tr> <tr><td bgcolor="#ffffff"><img src="op/bus-icon.png" border="0" alt="inv+"></td><td bgcolor="#ffffff"> B - A </td><td bgcolor="#ffffff">negate then contrast</td><td bgcolor="#ffffff">180 degree rotate then move</td></tr> <tr><td bgcolor="#f0f8ff"><img src="op/mul-icon.png" border="0" alt="*"></td><td bgcolor="#f0f8ff"> A * B </td><td bgcolor="#f0f8ff">contrast</td><td bgcolor="#f0f8ff">zoom out</td></tr> <tr><td bgcolor="#ffffff"><img src="op/div-icon.png" border="0" alt="/"></td><td bgcolor="#ffffff"> A / B, rounded towards zero </td><td bgcolor="#ffffff">contrast</td><td bgcolor="#ffffff">zoom in</td></tr> <tr><td bgcolor="#f0f8ff"><img src="op/div2-icon.png" border="0" alt="div"></td><td bgcolor="#f0f8ff"> A / B, rounded downwards </td><td bgcolor="#f0f8ff">contrast</td><td bgcolor="#f0f8ff">zoom in</td></tr> <tr><td bgcolor="#ffffff"><img src="op/vid-icon.png" border="0" alt="inv*"></td><td bgcolor="#ffffff"> B / A, rounded towards zero </td><td bgcolor="#ffffff">--</td><td bgcolor="#ffffff">--</td></tr> <tr><td bgcolor="#f0f8ff"><img src="op/vid2-icon.png" border="0" alt="swapdiv"></td><td bgcolor="#f0f8ff"> B / A, rounded downwards </td><td bgcolor="#f0f8ff">--</td><td bgcolor="#f0f8ff">--</td></tr> <tr><td bgcolor="#ffffff"><img src="op/mod-icon.png" border="0" alt="%"></td><td bgcolor="#ffffff"> A % B, modulo (goes with div) </td><td bgcolor="#ffffff">--</td><td bgcolor="#ffffff">tile</td></tr> <tr><td bgcolor="#f0f8ff"><img src="op/dom-icon.png" border="0" alt="swap%"></td><td bgcolor="#f0f8ff"> B % A, modulo (goes with div) </td><td bgcolor="#f0f8ff">--</td><td bgcolor="#f0f8ff">--</td></tr> <tr><td bgcolor="#ffffff"><img src="op/rem-icon.png" border="0" alt="rem"></td><td bgcolor="#ffffff"> A % B, remainder (goes with /) </td><td bgcolor="#ffffff">--</td><td bgcolor="#ffffff">--</td></tr> <tr><td bgcolor="#f0f8ff"><img src="op/mer-icon.png" border="0" alt="swaprem"></td><td bgcolor="#f0f8ff"> B % A, remainder (goes with /) </td><td bgcolor="#f0f8ff">--</td><td bgcolor="#f0f8ff">--</td></tr> <tr><td bgcolor="#ffffff"><img src="op/gcd-icon.png" border="0" alt="gcd"></td><td bgcolor="#ffffff">
greatest common divisor</td><td bgcolor="#ffffff">--</td><td bgcolor="#ffffff">--</td></tr> <tr><td bgcolor="#f0f8ff"><img src="op/lcm-icon.png" border="0" alt="lcm"></td><td bgcolor="#f0f8ff">
least common multiple</td><td bgcolor="#f0f8ff">--</td><td bgcolor="#f0f8ff">--</td></tr> <tr><td bgcolor="#ffffff"><img src="op/or-icon.png" border="0" alt="|"></td><td bgcolor="#ffffff"> A or B, bitwise </td><td bgcolor="#ffffff">bright munchies</td><td bgcolor="#ffffff">bottomright munchies</td></tr> <tr><td bgcolor="#f0f8ff"><img src="op/xor-icon.png" border="0" alt="^"></td><td bgcolor="#f0f8ff"> A xor B, bitwise </td><td bgcolor="#f0f8ff">symmetric munchies (fractal checkers)</td><td bgcolor="#f0f8ff">symmetric munchies (fractal checkers)</td></tr> <tr><td bgcolor="#ffffff"><img src="op/and-icon.png" border="0" alt="&"></td><td bgcolor="#ffffff"> A and B, bitwise </td><td bgcolor="#ffffff">dark munchies</td><td bgcolor="#ffffff">topleft munchies</td></tr> <tr><td bgcolor="#f0f8ff"><img src="op/shl-icon.png" border="0" alt="<<"></td><td bgcolor="#f0f8ff"> A * (2**(B % 32)), which is left-shifting </td><td bgcolor="#f0f8ff">like *</td><td bgcolor="#f0f8ff">like *</td></tr> <tr><td bgcolor="#ffffff"><img src="op/shr-icon.png" border="0" alt=">>"></td><td bgcolor="#ffffff"> A / (2**(B % 32)), which is right-shifting </td><td bgcolor="#ffffff">like /,div</td><td bgcolor="#ffffff">like /,div</td></tr> <tr><td bgcolor="#f0f8ff"><img src="op/sc_or-icon.png" border="0" alt="||"></td><td bgcolor="#f0f8ff"> if A is zero then B else A </td><td bgcolor="#f0f8ff">--</td><td bgcolor="#f0f8ff">--</td></tr> <tr><td bgcolor="#ffffff"><img src="op/sc_and-icon.png" border="0" alt="&&"></td><td bgcolor="#ffffff"> if A is zero then zero else B</td><td bgcolor="#ffffff">--</td><td bgcolor="#ffffff">--</td></tr> <tr><td bgcolor="#f0f8ff"><img src="op/min-icon.png" border="0" alt="min"></td><td bgcolor="#f0f8ff"> the lowest value in A,B </td><td bgcolor="#f0f8ff">clipping</td><td bgcolor="#f0f8ff">clipping (of individual points)</td></tr> <tr><td bgcolor="#ffffff"><img src="op/max-icon.png" border="0" alt="max"></td><td bgcolor="#ffffff"> the highest value in A,B </td><td bgcolor="#ffffff">clipping</td><td bgcolor="#ffffff">clipping (of individual points)</td></tr> <tr><td bgcolor="#f0f8ff"><img src="op/cmp-icon.png" border="0" alt="cmp"></td><td bgcolor="#f0f8ff"> -1 when A<B; 0 when A=B; 1 when A>B. </td><td bgcolor="#f0f8ff">--</td><td bgcolor="#f0f8ff">--</td></tr> <tr><td bgcolor="#ffffff"><img src="op/eq-icon.png" border="0" alt="=="></td><td bgcolor="#ffffff"> is A equal to B ? 1=true, 0=false </td><td bgcolor="#ffffff">--</td><td bgcolor="#ffffff">--</td></tr> <tr><td bgcolor="#f0f8ff"><img src="op/ne-icon.png" border="0" alt="!="></td><td bgcolor="#f0f8ff"> is A not equal to B ? </td><td bgcolor="#f0f8ff">--</td><td bgcolor="#f0f8ff">--</td></tr> <tr><td bgcolor="#ffffff"><img src="op/gt-icon.png" border="0" alt=">"></td><td bgcolor="#ffffff"> is A greater than B ? </td><td bgcolor="#ffffff">--</td><td bgcolor="#ffffff">--</td></tr> <tr><td bgcolor="#f0f8ff"><img src="op/le-icon.png" border="0" alt="<="></td><td bgcolor="#f0f8ff"> is A not greater than B ? </td><td bgcolor="#f0f8ff">--</td><td bgcolor="#f0f8ff">--</td></tr> <tr><td bgcolor="#ffffff"><img src="op/lt-icon.png" border="0" alt="<"></td><td bgcolor="#ffffff"> is A less than B ? </td><td bgcolor="#ffffff">--</td><td bgcolor="#ffffff">--</td></tr> <tr><td bgcolor="#f0f8ff"><img src="op/ge-icon.png" border="0" alt=">="></td><td bgcolor="#f0f8ff">is A not less than B ? </td><td bgcolor="#f0f8ff">--</td><td bgcolor="#f0f8ff">--</td></tr> <tr><td bgcolor="#ffffff"><img src="op/sin-icon.png" border="0" alt="sin*"></td><td bgcolor="#ffffff"> B * sin(A) </td><td bgcolor="#ffffff">--</td><td bgcolor="#ffffff">waves, rotations</td></tr> <tr><td bgcolor="#f0f8ff"><img src="op/cos-icon.png" border="0" alt="cos*"></td><td bgcolor="#f0f8ff"> B * cos(A) </td><td bgcolor="#f0f8ff">--</td><td bgcolor="#f0f8ff">waves, rotations</td></tr> <tr><td bgcolor="#ffffff"><img src="op/atan-icon.png" border="0" alt="atan"></td><td bgcolor="#ffffff"> arctan(A/B) </td><td bgcolor="#ffffff">--</td><td bgcolor="#ffffff">find angle to origin (part of polar transform)</td></tr> <tr><td bgcolor="#f0f8ff"><img src="op/tanh-icon.png" border="0" alt="tanh*"></td><td bgcolor="#f0f8ff"> B * tanh(A) </td><td bgcolor="#f0f8ff">smooth clipping</td><td bgcolor="#f0f8ff">smooth clipping (of individual points), neural sigmoid, fuzzy logic</td></tr> <tr><td bgcolor="#ffffff"><img src="op/log-icon.png" border="0" alt="log*"></td><td bgcolor="#ffffff"> B * log(A) (in base e) </td><td bgcolor="#ffffff">--</td><td bgcolor="#ffffff">--</td></tr> <tr><td bgcolor="#f0f8ff"><img src="op/gamma-icon.png" border="0" alt="gamma"></td><td bgcolor="#f0f8ff"> floor(pow(a/256.0,256.0/b)*256.0) </td><td bgcolor="#f0f8ff">gamma correction</td><td bgcolor="#f0f8ff">--</td></tr> <tr><td bgcolor="#ffffff"><img src="op/pow-icon.png" border="0" alt="**"></td><td bgcolor="#ffffff"> A**B, that is, A raised to power B </td><td bgcolor="#ffffff">gamma correction</td><td bgcolor="#ffffff">--</td></tr> <tr><td bgcolor="#f0f8ff"><img src="op/abs-icon.png" border="0" alt="abs-"></td><td bgcolor="#f0f8ff"> absolute value of (A-B) </td><td bgcolor="#f0f8ff">--</td><td bgcolor="#f0f8ff">--</td></tr> <tr><td bgcolor="#ffffff"><img src="op/rand-icon.png" border="0" alt="rand"></td><td bgcolor="#ffffff"> randomly produces a non-negative number below A </td><td bgcolor="#ffffff">--</td><td bgcolor="#ffffff">--</td></tr> <tr><td bgcolor="#f0f8ff"><img src="op/sqrt-icon.png" border="0" alt="sqrt"></td><td bgcolor="#f0f8ff"> square root of A, rounded downwards </td><td bgcolor="#f0f8ff">--</td><td bgcolor="#f0f8ff">--</td></tr> <tr><td bgcolor="#ffffff"><img src="op/sq-icon.png" border="0" alt="sq-"></td><td bgcolor="#ffffff"> (A-B) times (A-B) </td><td bgcolor="#ffffff">--</td><td bgcolor="#ffffff">--</td></tr> <tr><td bgcolor="#f0f8ff"><img src="op/clip+-icon.png" border="0" alt="clip+"></td><td bgcolor="#f0f8ff"> like A+B but overflow causes clipping instead of wrapping around (coming soon) </td><td bgcolor="#f0f8ff">--</td><td bgcolor="#f0f8ff">--</td></tr> <tr><td bgcolor="#ffffff"><img src="op/clip--icon.png" border="0" alt="clip-"></td><td bgcolor="#ffffff"> like A-B but overflow causes clipping instead of wrapping around (coming soon) </td><td bgcolor="#ffffff">--</td><td bgcolor="#ffffff">--</td></tr> <tr><td bgcolor="#f0f8ff"><img src="op/avg-icon.png" border="0" alt="avg"></td><td bgcolor="#f0f8ff"> (A+B)/2 </td><td bgcolor="#f0f8ff">--</td><td bgcolor="#f0f8ff">--</td></tr> <tr><td bgcolor="#ffffff"><img src="op/hypot-icon.png" border="0" alt="hypot"></td><td bgcolor="#ffffff"> square root of (A*A+B*B) </td><td bgcolor="#ffffff">--</td><td bgcolor="#ffffff">--</td></tr> <tr><td bgcolor="#f0f8ff"><img src="op/erf-icon.png" border="0" alt="erf*"></td><td bgcolor="#f0f8ff"> integral of e^(-x*x) dx ... (coming soon; what ought to be the scaling factor?) </td><td bgcolor="#f0f8ff">--</td><td bgcolor="#f0f8ff">--</td></tr> </table></td></tr></table></td></tr></td></tr>
<tr><td></td><td></td><td> </td></tr>
<tr><td> </td></tr>
<tr><td colspan="4" bgcolor="black">
<img src="images/black.png" width="1" height="2"></td></tr>
<tr><td colspan="4"><a name="Synchronisation"></a><h4>Synchronisation</h4></td></tr><tr><td></td><td></td><td> </td></tr>
<tr><td></td><td></td><td><p>In GridFlow you cannot send two grids in different inlets at the
same time. You have to use <kbd><font color="#007777">[#finished]</font></kbd> together with (possibly) <kbd><font color="#007777">[fork]</font></kbd> and <kbd><font color="#007777">[#store]</font></kbd>,
which can be cumbersome. If you don't do this, the result is undefined
behaviour (or crash!).</p></td></tr>
<tr><td></td><td></td><td> </td></tr>
<tr><td></td><td></td><td><p>In GridFlow 0.7.1 this is beginning to change. <kbd><font color="#007777">[#store]</font></kbd> and # now allow
right-inlet grids to be buffered if an operation is occuring on left inlet. This
should make many circuits simpler. </p></td></tr>
<tr><td></td><td></td><td> </td></tr>
<tr><td></td><td></td><td><p>(more to come)</p></td></tr>
<tr><td></td><td></td><td> </td></tr>
<tr><td> </td></tr>
<tr><td colspan="4" bgcolor="black">
<img src="images/black.png" width="1" height="2"></td></tr>
<tr><td colspan="4"><a name="Bridges"></a><h4>Bridges</h4></td></tr><tr><td></td><td></td><td> </td></tr>
<tr><td></td><td></td><td><p>Starting with version 0.6, GridFlow is Ruby-centric instead of jMax-centric.
jMax support has been added back as a <b>Bridge</b>.</p></td></tr>
<tr><td></td><td></td><td> </td></tr>
<tr><td></td><td></td><td><p>Bridges, for the most part, plug into the FObject class, which is the common
root of most of GridFlow's classes. Under the current design, the bridge is
compiled separately, and is directly loaded by the host software; then the
bridge starts Ruby and makes it load the main GridFlow; then the bridge hooks
with the main part. </p></td></tr>
<tr><td></td><td></td><td> </td></tr>
<tr><td> </td></tr>
<td colspan="4" bgcolor="black">
<img src="images/black.png" width="1" height="2"></td></tr>
<tr><td colspan="4">
<p><font size="-1">
GridFlow 0.8.0 Documentation<br>
Copyright © 2001,2002,2003,2004,2005 by Mathieu Bouchard
<a href="mailto:matju@sympatico.ca">matju(a)artengine.ca</a>
</font></p>
</td></tr></table></body></html>
--- NEW FILE: introduction.html ---
<html>
<head>
<title>GridFlow 0.7.7 - Introduction</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<link rel="stylesheet" href="gridflow.css" type="text/css">
</head>
<body bgcolor="#FFFFFF" leftmargin="0" topmargin="0" marginwidth="0" marginheight="0">
<br>
<table width="100%" border="0" cellspacing="5">
<tr><td colspan="4" bgcolor="#082069">
<img src="images/titre_gridflow.png" width="253" height="23"></td></tr>
<tr><td> </td></tr>
<tr><td colspan="4" bgcolor="black"><img src="images/black.png" width="1" height="2"></td></tr>
<tr><td colspan="3" height="16">
<h4>GridFlow 0.7.7 - introduction</h4>
</td></tr>
<tr>
<td width="12%" height="4"> </td>
<td width="80%" height="4"> </td>
<td width="12%" height="4"> </td>
</tr>
<tr>
<td width="13%"> </td>
<td width="82%">
<p> The philosophy that guides PureData is a simple but powerful one:
the software must first provide the user with generic tools
rather than imposing pre-cooked effects. In other words the user
should have total freedom.
<p> GridFlow follows that philosophy: it first defines elementary
mathematical operations. Those can in turn be used as simple
visual effects or be combined to produce more complex effects.
<p> The strategy followed by most video plugins for PureData, jMax, and MAX/MSP, is
to provide the user first with constructs for manipulating video
streams at a fairly high level. The strategy put forward by GridFlow
is different.
<p> It can be said that in all those video plugins there are three layers:
the first, the low level, is not accessible to non-programmers (and fairly
difficult of access even to programmers); the second, mathematical, where
one needs not to be a C++ programmer, but still requires a good
understanding of how numbers and pixels and colours and geometry work; and
a third level that looks more like the software an artist would like to
use.
<p> In other video plugins there is a fairly low emphasis on the second
layer. In GridFlow that layer is very strong and opens many possibilities.
Even though the third layer in GridFlow is not as developed as it could,
the second layer may be used to produce third-layer object classes much
more quickly.
<p> GridFlow provides a unifying view of multimedia information. Several
kinds of data -- raster graphics in any number of channels, coordinate
transforms, matrices, vectors -- may all be represented by <b>Grids</b>
(also known as multi-dimensional arrays). Grids exist in several ways: they
are usually streamed from object to object, but they can also be stored in
memory, stored into a file, sent through the network.
<p> The new GridFlow (0.6) also provides scripting, which inserts itself
between the first and second layer to provide additional functionality. The
language that has been chosen is Ruby, designed by Yukihiro Matsumoto
during the 90's. This new layer is used for portability between host
software (PureData vs jMax), for portability between platforms (Windows/Mac
versions do not exist but would be farther ahead if it wasn't for Ruby),
for independency from host software (GridFlow can be tested and used
independently of PureData/jMax), for quick extensibility (you can create
PureData/jMax object classes directly in GridFlow's configuration file),
and so on.
<p> In short, GridFlow is a whole new world of possibilities for
the multimedia artist and programmer.
<p>- matju</p>
</td></tr>
<tr><td> </td></tr>
<tr><td colspan="4" bgcolor="black"><img src="images/black.png" width="1" height="2"></td></tr>
<tr>
<td width="13%"> </td>
<td width="82%">
<p> Here is an example of how things work in GridFlow. (if you want more
information, consult the rest of this manual)
<p> A picture is a three-dimensional Grid:<br>
<b>0</b> : rows <br>
<b>1</b> : columns <br>
<b>2</b> : channels <br>
<p>
Pictures come in all sorts of heights and widths. The channels, however,
are more limited in number. Usually it's three: Red, Green, Blue.
<p> A coordinate transform, when specified pixel by pixel, may be a
three-dimensional Grid in which the two "channels" are Y and X,
representing row-and-column positions in a separate picture.
<p> Other shapes of grids could be designed to represent various things;
for example, configuration for blur effects. Grids could be useful for
things not directly related to raster pictures (e.g. sound recordings).
Those are all kinds of things you could actually develop <i>within</i> the
PureData / GridFlow framework. You don't need to wait for me.
</td>
<tr><td> </td></tr>
<tr><td colspan="4" bgcolor="black"><img src="images/black.png" width="1" height="2"></td></tr>
<tr><td colspan="4">
<p><font size="-1">GridFlow 0.7.7 Documentation<br>
by Mathieu Bouchard <a href="mailto:matju@sympatico.ca">matju(a)sympatico.ca</a>
and<br>
Alexandre Castonguay <a href="mailto:acastonguay@artengine.ca">acastonguay(a)artengine.ca</a></font></p>
</td>
</tr>
</table>
</body>
</html>
--- NEW FILE: reference.html ---
<html><head>
<!-- $Id: reference.html,v 1.1 2005/10/04 02:09:43 matju Exp $ -->
<title>GridFlow 0.8.0 - Reference Manual: Flow Classes</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<link rel="stylesheet" href="gridflow.css" type="text/css">
</head>
<body bgcolor="#FFFFFF"
leftmargin="0" topmargin="0"
marginwidth="0" marginheight="0">
<table width="100%" bgcolor="white" border="0" cellspacing="2">
<tr><td colspan="4" bgcolor="#082069">
<img src="images/titre_gridflow.png" width="253" height="23">
</td></tr><tr><td> </td></tr>
<tr><td colspan="4" bgcolor="black">
<img src="images/black.png" width="1" height="2"></td></tr>
<tr><td colspan="4" height="16">
<h4>GridFlow 0.8.0 - Reference Manual: Flow Classes</h4>
</td></tr>
<tr>
[...1031 lines suppressed...]
<tr><td colspan="4" bgcolor="#ffb080"><b> class </b><a name="pd_netsend">pd_netsend</a></td></tr><tr><td></td><td valign="top"><br>
<img src="flow_classes/pd_netsend-icon.png" alt="[pd_netsend]" border="0"><br clear="left"><br><br><br clear="left"><br></td><td><br>
same as jmax_udpsend but for PureData UDP connections. <br></td></tr><tr><td></td><td></td><td> </td></tr>
<tr><td colspan="4" bgcolor="#ffb080"><b> class </b><a name="pd_netreceive">pd_netreceive</a></td></tr><tr><td></td><td valign="top"><br>
<img src="flow_classes/pd_netreceive-icon.png" alt="[pd_netreceive]" border="0"><br clear="left"><br><br><br clear="left"><br></td><td><br>
same as jmax_udpreceive but for PureData UDP connections. <br></td></tr><tr><td></td><td></td><td> </td></tr>
<tr><td> </td></tr>
<td colspan="4" bgcolor="black">
<img src="images/black.png" width="1" height="2"></td></tr>
<tr><td colspan="4">
<p><font size="-1">
GridFlow 0.8.0 Documentation<br>
Copyright © 2001,2002,2003,2004,2005 by Mathieu Bouchard
<a href="mailto:matju@sympatico.ca">matju(a)artengine.ca</a>
</font></p>
</td></tr></table></body></html>
--- NEW FILE: reference.xml ---
<?xml version="1.0" standalone="no" ?>
<!DOCTYPE documentation SYSTEM 'gridflow.dtd'>
<documentation title="Reference Manual: Flow Classes" indexcols="3">
<!-- $Id: reference.xml,v 1.1 2005/10/04 02:09:43 matju Exp $ -->
<!--
GridFlow Reference Manual: Class Reference
Copyright (c) 2001,2002,2003,2004 by Mathieu Bouchard and Alexandre Castonguay
-->
<section name="Objects for making grids and breaking them down">
<class name="#import">
<icon text="[#import {240 320 3}]"/>
<help text="[#import {240 320 3}]" image="#importexport" />
<p>This object allows you to produce grids from non-grid data, such as
integers and lists of integers. This object also reframes/resyncs
grids so that multiple grids may be joined together, or
single grids may be split. That kind of operation is already done implicitly in many
cases (e.g. sending an integer or list to a grid-receiving inlet),
but using this object you have greater flexibility on the conversion.</p>
[...1552 lines suppressed...]
smaller than the first argument; else the second outlet is for values smaller
than the second argument; and so on; and the last outlet is for values greater
or equal to the last argument.
</method></inlet>
<inlet id="1..n"><method name="float">
sets the corresponding separator in the separator list.
</method></inlet>
</class>
</section>
<section name="PureData emulation">
<class name="pd_netsend">
same as jmax_udpsend but for PureData UDP connections.
</class>
<class name="pd_netreceive">
same as jmax_udpreceive but for PureData UDP connections.
</class>
</section>
</documentation>
1
0
Update of /cvsroot/pure-data/externals/gridflow/doc/op
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv22300/op
Added Files:
abs-icon.png add-icon.png and-icon.png atan-icon.png
avg-icon.png bus-icon.png clip+-icon.png clip--icon.png
cmp-icon.png cos-icon.png div-icon.png div2-icon.png
dom-icon.png eq-icon.png gamma-icon.png gcd-icon.png
ge-icon.png gt-icon.png hypot-icon.png ignore-icon.png
lcm-icon.png le-icon.png log-icon.png lt-icon.png max-icon.png
mer-icon.png min-icon.png mod-icon.png mul-icon.png
ne-icon.png or-icon.png pow-icon.png put-icon.png
rand-icon.png rem-icon.png sc_and-icon.png sc_or-icon.png
shl-icon.png shr-icon.png sin-icon.png sq-icon.png
sqrt-icon.png sub-icon.png tanh-icon.png vid-icon.png
vid2-icon.png xor-icon.png
Log Message:
icons for the doc
--- NEW FILE: and-icon.png ---
(This appears to be a binary file; contents omitted.)
--- NEW FILE: mod-icon.png ---
(This appears to be a binary file; contents omitted.)
--- NEW FILE: sq-icon.png ---
(This appears to be a binary file; contents omitted.)
--- NEW FILE: pow-icon.png ---
(This appears to be a binary file; contents omitted.)
--- NEW FILE: add-icon.png ---
(This appears to be a binary file; contents omitted.)
--- NEW FILE: dom-icon.png ---
(This appears to be a binary file; contents omitted.)
--- NEW FILE: clip--icon.png ---
(This appears to be a binary file; contents omitted.)
--- NEW FILE: clip+-icon.png ---
(This appears to be a binary file; contents omitted.)
--- NEW FILE: le-icon.png ---
(This appears to be a binary file; contents omitted.)
--- NEW FILE: sub-icon.png ---
(This appears to be a binary file; contents omitted.)
--- NEW FILE: atan-icon.png ---
(This appears to be a binary file; contents omitted.)
--- NEW FILE: ignore-icon.png ---
(This appears to be a binary file; contents omitted.)
--- NEW FILE: cmp-icon.png ---
(This appears to be a binary file; contents omitted.)
--- NEW FILE: sqrt-icon.png ---
(This appears to be a binary file; contents omitted.)
--- NEW FILE: gt-icon.png ---
(This appears to be a binary file; contents omitted.)
--- NEW FILE: bus-icon.png ---
(This appears to be a binary file; contents omitted.)
--- NEW FILE: eq-icon.png ---
(This appears to be a binary file; contents omitted.)
--- NEW FILE: sc_or-icon.png ---
(This appears to be a binary file; contents omitted.)
--- NEW FILE: gcd-icon.png ---
(This appears to be a binary file; contents omitted.)
--- NEW FILE: put-icon.png ---
(This appears to be a binary file; contents omitted.)
--- NEW FILE: hypot-icon.png ---
(This appears to be a binary file; contents omitted.)
--- NEW FILE: max-icon.png ---
(This appears to be a binary file; contents omitted.)
--- NEW FILE: sin-icon.png ---
(This appears to be a binary file; contents omitted.)
--- NEW FILE: min-icon.png ---
(This appears to be a binary file; contents omitted.)
--- NEW FILE: ge-icon.png ---
(This appears to be a binary file; contents omitted.)
--- NEW FILE: div-icon.png ---
(This appears to be a binary file; contents omitted.)
--- NEW FILE: shr-icon.png ---
(This appears to be a binary file; contents omitted.)
--- NEW FILE: ne-icon.png ---
(This appears to be a binary file; contents omitted.)
--- NEW FILE: cos-icon.png ---
(This appears to be a binary file; contents omitted.)
--- NEW FILE: rem-icon.png ---
(This appears to be a binary file; contents omitted.)
--- NEW FILE: gamma-icon.png ---
(This appears to be a binary file; contents omitted.)
--- NEW FILE: shl-icon.png ---
(This appears to be a binary file; contents omitted.)
--- NEW FILE: vid2-icon.png ---
(This appears to be a binary file; contents omitted.)
--- NEW FILE: tanh-icon.png ---
(This appears to be a binary file; contents omitted.)
--- NEW FILE: or-icon.png ---
(This appears to be a binary file; contents omitted.)
--- NEW FILE: xor-icon.png ---
(This appears to be a binary file; contents omitted.)
--- NEW FILE: abs-icon.png ---
(This appears to be a binary file; contents omitted.)
--- NEW FILE: vid-icon.png ---
(This appears to be a binary file; contents omitted.)
--- NEW FILE: rand-icon.png ---
(This appears to be a binary file; contents omitted.)
--- NEW FILE: avg-icon.png ---
(This appears to be a binary file; contents omitted.)
--- NEW FILE: lt-icon.png ---
(This appears to be a binary file; contents omitted.)
--- NEW FILE: div2-icon.png ---
(This appears to be a binary file; contents omitted.)
--- NEW FILE: lcm-icon.png ---
(This appears to be a binary file; contents omitted.)
--- NEW FILE: log-icon.png ---
(This appears to be a binary file; contents omitted.)
--- NEW FILE: sc_and-icon.png ---
(This appears to be a binary file; contents omitted.)
--- NEW FILE: mul-icon.png ---
(This appears to be a binary file; contents omitted.)
--- NEW FILE: mer-icon.png ---
(This appears to be a binary file; contents omitted.)
1
0