[Gridflow-cvs] [svn] commit: r4342 - in /trunk/doc: flow_classes/#cast-help.pd flow_classes/#finished-help.pd flow_classes/#for-help.pd flow_classes/#grade-help.pd flow_classes/#inner-help.pd flow_classes/#join-help.pd flow_classes/#ravel-help.pd reference.xml

gridflow-cvs at artengine.ca gridflow-cvs at artengine.ca
Sat Oct 24 14:54:37 EDT 2009


Author: matju
Date: Sat Oct 24 14:54:32 2009
New Revision: 4342

Log:
déexemélisation

Added:
    trunk/doc/flow_classes/#inner-help.pd
Modified:
    trunk/doc/flow_classes/#cast-help.pd
    trunk/doc/flow_classes/#finished-help.pd
    trunk/doc/flow_classes/#for-help.pd
    trunk/doc/flow_classes/#grade-help.pd
    trunk/doc/flow_classes/#join-help.pd
    trunk/doc/flow_classes/#ravel-help.pd
    trunk/doc/reference.xml

Modified: trunk/doc/flow_classes/#cast-help.pd
==============================================================================
--- trunk/doc/flow_classes/#cast-help.pd (original)
+++ trunk/doc/flow_classes/#cast-help.pd Sat Oct 24 14:54:32 2009
@@ -1,11 +1,10 @@
-#N canvas 30 36 558 546 10;
+#N canvas 689 0 558 717 10;
 #X obj 14 219 #print;
 #X obj 14 199 #cast float64;
 #X obj 269 218 #print;
 #X obj 126 218 #print;
 #X obj 269 198 #cast uint8;
 #X obj 126 198 #cast int32;
-#X text 16 385 GRID;
 #X floatatom 14 181 5 0 0 0 - - -;
 #X msg 126 177 9.8764 9 -32 0.3;
 #X obj 269 158 bng 15 250 50 0 empty empty empty 0 -6 0 8 -24198 -1
@@ -19,7 +18,7 @@
 #X obj 306 133 #pack 3 float32;
 #X obj 14 161 bng 15 250 50 0 empty empty empty 0 -6 0 8 -24198 -1
 -1;
-#X text 153 282 Number types are: uint8 \, int16 \, int32 \, int64
+#X text 202 294 Number types are: uint8 \, int16 \, int32 \, int64
 \, float32 \, float64. see doc/architecture.html for more info.;
 #X obj 126 157 bng 15 250 50 0 empty empty empty 0 -6 0 8 -24198 -1
 -1;
@@ -27,12 +26,9 @@
 a grid of the same dimensions containing all the same values after
 type conversion. While casting to a smaller type \, overflowing values
 will be truncated.;
-#X text 75 478 Returns a grid of the same dimensions containing all
-the same values after type conversion.;
 #X obj 406 113 nbx 8 14 -1e+37 1e+37 0 1 empty empty empty 0 -6 0 10
 -262144 -1 -1 45 256;
-#X text 74 385 Any grid;
-#X text 16 479 GRID;
+#X text 200 360 Any grid;
 #X obj 0 0 doc_h;
 #X obj 3 335 doc_i 1;
 #X obj 3 422 doc_o 1;
@@ -40,17 +36,26 @@
 #X obj 14 446 doc_oo 0;
 #X obj 14 359 doc_ii 0;
 #X obj 14 277 doc_cc 0;
+#X obj 100 277 doc_m c0 symbol/numbertype;
+#X obj 100 359 doc_m i0 grid;
+#X obj 100 446 doc_m o0 grid;
+#X text 189 447 Produces a grid of the same dimensions containing all
+the same values after type conversion.;
+#X text 188 474 conversion from float truncates fractional part (rounds
+towards zero);
+#X text 187 506 conversion to an int type may wrap (same as some #
+& or some # %);
 #X connect 1 0 0 0;
 #X connect 4 0 2 0;
 #X connect 5 0 3 0;
-#X connect 7 0 1 0;
-#X connect 8 0 5 0;
+#X connect 6 0 1 0;
+#X connect 7 0 5 0;
+#X connect 8 0 12 0;
 #X connect 9 0 13 0;
-#X connect 10 0 14 0;
-#X connect 11 0 14 1;
-#X connect 12 0 13 1;
-#X connect 13 0 4 0;
-#X connect 14 0 12 0;
-#X connect 15 0 7 0;
-#X connect 17 0 8 0;
-#X connect 20 0 14 2;
+#X connect 10 0 13 1;
+#X connect 11 0 12 1;
+#X connect 12 0 4 0;
+#X connect 13 0 11 0;
+#X connect 14 0 6 0;
+#X connect 16 0 7 0;
+#X connect 18 0 13 2;

Modified: trunk/doc/flow_classes/#finished-help.pd
==============================================================================
--- trunk/doc/flow_classes/#finished-help.pd (original)
+++ trunk/doc/flow_classes/#finished-help.pd Sat Oct 24 14:54:32 2009
@@ -1,4 +1,4 @@
-#N canvas 551 311 569 347 10;
+#N canvas 665 0 569 347 10;
 #X text 22 53 a bang is emitted every time a grid transmission ends
 ;
 #X obj 24 175 bng 15 250 50 0 empty empty empty 0 -6 0 8 -233017 -1
@@ -13,6 +13,10 @@
 #X obj 3 201 doc_c 0;
 #X obj 14 308 doc_oo 0;
 #X obj 14 250 doc_ii 0;
+#X obj 100 250 doc_m i0 grid;
+#X obj 100 308 doc_m o0 bang;
+#X text 193 250 a bang is emitted every time a grid transmission ends.
+;
 #X connect 2 0 5 0;
 #X connect 3 0 5 1;
 #X connect 4 0 1 0;

Modified: trunk/doc/flow_classes/#for-help.pd
==============================================================================
--- trunk/doc/flow_classes/#for-help.pd (original)
+++ trunk/doc/flow_classes/#for-help.pd Sat Oct 24 14:54:32 2009
@@ -1,73 +1,72 @@
-#N canvas 645 0 555 717 10;
-#X floatatom 13 227 5 0 0 0 - - -;
-#X floatatom 45 249 5 0 0 0 - - -;
-#X floatatom 78 270 5 0 0 0 - - -;
-#X obj 13 365 #print;
-#X obj 10 720 cnv 15 60 18 empty empty empty 20 12 0 14 -228992 -66577
-0;
-#X text 15 744 GRID;
-#X obj 33 332 display;
-#X text 119 270 <-- step value;
-#X text 90 247 <-- upper bound;
-#X text 60 224 <-- lower bound;
-#X obj 13 297 #for 0 8 1;
-#X obj 264 364 #print;
-#X obj 284 334 display;
-#X msg 264 228 0 0;
-#X msg 329 276 1 1;
-#X obj 264 303 #for 0 8 1;
-#X msg 296 253 4 4;
-#X text 114 426 INTEGER;
-#X text 114 460 INTEGER;
-#X text 114 488 INTEGER;
-#X text 14 721 Outlet 0;
-#X text 188 460 Upper bound;
-#X text 189 488 Step value;
-#X text 189 427 Lower bound. As with the other arguments \, they are
+#N canvas 679 0 555 717 10;
+#X floatatom 13 197 5 0 0 0 - - -;
+#X floatatom 45 219 5 0 0 0 - - -;
+#X floatatom 78 238 5 0 0 0 - - -;
+#X obj 13 329 #print;
+#X obj 33 296 display;
+#X text 119 238 <-- step value;
+#X text 90 217 <-- upper bound;
+#X text 60 194 <-- lower bound;
+#X obj 13 261 #for 0 8 1;
+#X obj 264 328 #print;
+#X obj 314 288 display;
+#X msg 264 198 0 0;
+#X msg 369 244 1 1;
+#X msg 326 223 4 4;
+#X text 208 490 Upper bound;
+#X text 209 518 Step value;
+#X text 208 453 Lower bound. As with the other arguments \, they are
 overwritten when another value is given.;
-#X text 374 276 <-- step value (1);
-#X text 343 252 <-- upper bound (2);
-#X text 309 227 <-- lower bound (3);
+#X text 414 244 <-- step value (1);
+#X text 373 222 <-- upper bound (2);
+#X text 309 197 <-- lower bound (3);
 #X text 26 38 When given scalar bounds \, works like a regular [for]
 object plugged to a [#import] tuned for a Dim(size) where size is the
 number of values produced by a bang to that [for].;
+#X text 196 661 Sets the upper bound;
+#X text 195 685 Sets the step value;
+#X text 192 739 The result of the operation is a single dimension grid
+in the case of scalar values and variable dimensions for vectors.;
+#X obj 0 0 doc_h;
+#X obj 3 551 doc_i 3;
+#X obj 3 430 doc_c 3;
+#X text 194 620 activate object (send output);
+#X text 194 586 Sets the lower bound and activate;
+#X text 193 636 Sets the lower bound without activating;
+#X obj 264 267 #for (0 0) (8 3) (1 1);
 #X text 26 84 When given vector bounds \, will work like any number
 of [for] objects producing all possible combinations of their values
-in the proper order.;
-#X text 35 193 scalar bounds;
-#X text 303 196 vector bounds;
-#X text 92 557 INTEGER;
-#X text 93 632 INTEGER;
-#X text 158 633 Sets the upper bound;
-#X text 92 656 INTEGER;
-#X text 157 657 Sets the step value;
-#X text 76 747 The result of the operation is a single dimension grid
-in the case of scalar values and variable dimensions for vectors.;
-#X text 27 137 Syntax: #for <from> <to> <step> outlet: grid dim(size)
-where size = floor(to-from+1)/step.;
-#X obj 0 0 doc_h;
-#X obj 3 521 doc_i 3;
-#X obj 3 691 doc_o 1;
-#X obj 3 400 doc_c 3;
-#X text 93 577 LIST the three arguments at once;
-#X text 92 593 BANG;
-#X text 156 592 activate object (send output);
-#X text 156 558 Sets the lower bound and activate;
-#X text 94 610 SET;
-#X text 155 608 Sets the lower bound without activating;
-#X obj 14 557 doc_ii 0;
-#X obj 14 634 doc_ii 1;
-#X obj 14 658 doc_ii 2;
-#X obj 14 424 doc_cc 0;
-#X obj 14 458 doc_cc 1;
-#X obj 14 490 doc_cc 2;
-#X connect 0 0 10 0;
-#X connect 1 0 10 1;
-#X connect 2 0 10 2;
-#X connect 10 0 6 0;
-#X connect 10 0 3 0;
-#X connect 13 0 15 0;
-#X connect 14 0 15 2;
-#X connect 15 0 12 0;
-#X connect 15 0 11 0;
-#X connect 16 0 15 1;
+in the proper order. (try it below);
+#X text 27 132 the formula for knowing the size of the output will
+be is floor((to-from)/step).;
+#X obj 14 745 doc_oo 0;
+#X obj 14 520 doc_cc 2;
+#X text 191 606 the three arguments at once;
+#X obj 14 460 doc_cc 0;
+#X obj 14 488 doc_cc 1;
+#X obj 14 587 doc_ii 0;
+#X obj 3 719 doc_o 1;
+#X obj 14 664 doc_ii 1;
+#X obj 14 688 doc_ii 2;
+#X text 11 177 With scalar bounds:;
+#X text 262 178 With vector bounds:;
+#X obj 100 606 doc_m i0 list;
+#X obj 100 626 doc_m i0 bang;
+#X obj 100 646 doc_m i0 set;
+#X obj 100 745 doc_m i0 grid;
+#X obj 100 459 doc_m c0 grid;
+#X obj 100 487 doc_m c1 grid;
+#X obj 100 520 doc_m c2 grid;
+#X obj 100 586 doc_m i0 grid;
+#X obj 100 666 doc_m i1 grid;
+#X obj 100 686 doc_m i2 grid;
+#X connect 0 0 8 0;
+#X connect 1 0 8 1;
+#X connect 2 0 8 2;
+#X connect 8 0 4 0;
+#X connect 8 0 3 0;
+#X connect 11 0 30 0;
+#X connect 12 0 30 2;
+#X connect 13 0 30 1;
+#X connect 30 0 10 0;
+#X connect 30 0 9 0;

Modified: trunk/doc/flow_classes/#grade-help.pd
==============================================================================
--- trunk/doc/flow_classes/#grade-help.pd (original)
+++ trunk/doc/flow_classes/#grade-help.pd Sat Oct 24 14:54:32 2009
@@ -1,4 +1,4 @@
-#N canvas 375 101 557 390 10;
+#N canvas 690 0 557 717 10;
 #X text 143 55 splits a dim[a... \, b] grid into dim[b] vectors that
 each contain numbers from 0 to b-1 indicating the ordering of the values.
 the result is a dim[a... \, b] grid.;
@@ -12,9 +12,27 @@
 #X obj 0 0 doc_h;
 #X obj 3 250 doc_c 0;
 #X obj 3 273 doc_i 1;
-#X obj 3 334 doc_o 1;
-#X obj 14 358 doc_oo 0;
+#X obj 3 364 doc_o 1;
+#X obj 14 388 doc_oo 0;
 #X obj 14 297 doc_ii 0;
+#X obj 100 297 doc_m i0 grid;
+#X obj 100 388 doc_m o0 grid;
+#X text 189 390 splits a Dim[A... \, B] grid into Dim[B] vectors \,
+producing new Dim[B] vectors that each contain numbers from 0 to B-1
+indicating the ordering of the values. The result is a Dim[A... \,
+B] grid.;
+#X text 188 447 for example \, connecting a [#grade] to a [#outer ignore
+0] to a [#store] object \, storing a single vector into [#store] \,
+and sending the same vector to [#grade] \, will sort the values of
+the vector. however for higher-dimensional grids \, what should go
+between [#store] and [#grade] to achieve the same result would be more
+complex.;
+#X text 187 549 you may achieve different kinds of sorting by applying
+various filters before [#grade]. the possibilities are unlimited. if
+you plug [#grade] directly into another [#grade] \, you will get the
+inverse arrangement \, which allows to take the sorted values and make
+them unsorted in the original way. note that this is really not the
+same as just listing the values backwards.;
 #X connect 1 0 5 0;
 #X connect 2 0 5 1;
 #X connect 3 0 5 2;

Modified: trunk/doc/flow_classes/#join-help.pd
==============================================================================
--- trunk/doc/flow_classes/#join-help.pd (original)
+++ trunk/doc/flow_classes/#join-help.pd Sat Oct 24 14:54:32 2009
@@ -1,4 +1,4 @@
-#N canvas 675 72 559 537 10;
+#N canvas 675 0 559 537 10;
 #X obj 18 32 bng 15 250 50 0 empty empty empty 0 -6 0 8 -233017 -1
 -1;
 #X obj 211 30 bng 15 250 50 0 empty empty empty 0 -6 0 8 -233017 -1
@@ -13,8 +13,8 @@
 #X text 244 29 1 <--;
 #X text 45 31 2 <--;
 #X obj 18 242 #clip;
-#X obj 106 571 #fold +;
-#X obj 162 571 #scan +;
+#X obj 109 748 #fold +;
+#X obj 161 749 #scan +;
 #X obj 18 269 #out window;
 #X obj 18 96 #in;
 #X obj 237 96 #rgb_to_greyscale;
@@ -25,16 +25,35 @@
 are numbered from 0 to n-1. in addition \, negative numbers from -n
 to -1 may be used \, to which n will be added.;
 #X obj 0 0 doc_h;
-#X obj 3 572 doc_also;
+#X obj 3 752 doc_also;
 #X obj 3 330 doc_c 0..2;
-#X obj 3 423 doc_i 2;
-#X obj 3 495 doc_o 1;
+#X obj 3 453 doc_i 2;
+#X obj 3 675 doc_o 1;
 #X obj 18 161 #join 2;
 #X obj 14 354 doc_cc 0;
-#X obj 14 383 doc_cc 1;
-#X obj 14 447 doc_ii 0;
-#X obj 14 471 doc_ii 1;
-#X obj 14 519 doc_oo 0;
+#X obj 14 423 doc_cc 1;
+#X obj 14 477 doc_ii 0;
+#X obj 14 651 doc_ii 1;
+#X obj 14 699 doc_oo 0;
+#X obj 100 354 doc_m c0 float;
+#X obj 100 423 doc_m c1 grid;
+#X obj 100 477 doc_m i0;
+#X text 201 353 Which_dim is the number of the dimension by which the
+join will occur. For N-dimensional grids \, the dimensions are numbered
+from 0 to N-1. In addition \, negative numbers from -N to -1 may be
+used \, to which N will be added.;
+#X text 196 471 The left grid and right grid must have the same number
+of elements in all dimensions except the one specified. The result
+will have the same number of elements in all dimensions except the
+one specified \, which will be the sum of the two corresponding one.
+;
+#X text 197 548 For example \, joining a RGB picture Dim[y \, x \,
+3] and a greyscale picture Dim[y \, x \, 1] on dimension 2 (or -1)
+could make a RGBA picture Dim[y \, x \, 4] in which the greyscale image
+becomes the opacity channel.;
+#X text 201 650 same as arg 1;
+#X obj 100 651 doc_m i1 grid;
+#X obj 100 700 doc_m o0 grid;
 #X connect 0 0 5 0;
 #X connect 1 0 6 0;
 #X connect 3 0 13 0;

Modified: trunk/doc/flow_classes/#ravel-help.pd
==============================================================================
--- trunk/doc/flow_classes/#ravel-help.pd (original)
+++ trunk/doc/flow_classes/#ravel-help.pd Sat Oct 24 14:54:32 2009
@@ -1,4 +1,4 @@
-#N canvas 364 101 556 545 10;
+#N canvas 691 0 556 545 10;
 #X text 143 55 like @redim but always produces a 1-D grid with the
 same total number of elements.;
 #X obj 20 80 bng 15 250 50 0 empty empty empty 0 -6 0 8 -233017 -1
@@ -10,18 +10,22 @@
 #X obj 20 142 #in;
 #X obj 20 208 #dim;
 #X obj 20 230 #export_list;
-#X obj 105 481 #redim (1);
-#X obj 195 481 #perspective;
+#X obj 105 511 #redim (1);
+#X obj 195 511 #perspective;
 #X obj 259 232 #export_list;
 #X obj 259 210 #dim;
 #X obj 140 169 #ravel;
 #X obj 0 0 doc_h;
 #X obj 3 288 doc_c 0;
 #X obj 3 317 doc_i 1;
-#X obj 3 482 doc_also;
+#X obj 3 512 doc_also;
 #X obj 3 391 doc_o 1;
-#X obj 15 415 doc_oo 0;
+#X obj 14 415 doc_oo 0;
 #X obj 14 341 doc_ii 0;
+#X obj 100 341 doc_m i0 grid;
+#X obj 100 415 doc_m o0 grid;
+#X text 199 339 like [#redim] but always produce a 1-D grid with the
+same total number of elements.;
 #X connect 1 0 5 0;
 #X connect 4 0 6 0;
 #X connect 5 0 6 0;

Modified: trunk/doc/reference.xml
==============================================================================
--- trunk/doc/reference.xml (original)
+++ trunk/doc/reference.xml Sat Oct 24 14:54:32 2009
@@ -1,137 +1,3 @@
-	<class name="#inner">
-		think of this one as a special combination of [#outer], [#] and
-		[#fold]. this is one of the most complex operations. It is very useful
-		for performing linear transforms like rotations, scalings, shearings,
-		and some kinds of color remappings. A linear transform is done by
-		something called matrix multiplication, which happens to be [#inner * +
-		0]. [#inner] also does dot product and other funny operations.
-
-		<method name="init">
-			<arg name="right_hand" type="grid"/>
-		</method>
-		<inlet id="0">
-			<method name="grid"><arg name="grid" type="grid(anyA..., lastA)"/>
-
-				Splits the Dim(anyA...,lastA) left-hand grid into Dim(anyA...)
-				pieces of Dim(lastA) size.
-
-				Splits the Dim(firstB,anyB...) right-hand grid into
-				Dim(anyB...) pieces of Dim(firstB) size.
-
-				On every piece pair, does [#] using the specified
-				op_para operation, followed by a [#fold] using
-				the specified op_fold operator and base value.
-			
-				creates a Dim(anyA...,anyB...) grid by assembling all
-				the results together.
-
-				(note: lastA must be equal to firstB.)
-			</method>
-			<method name="op"><arg name="op" type="numop"/>
-				the operation that combines the values from the two grids together.
-				this defaults to "*" (as in the matrix product)
-			</method>
-			<method name="fold"><arg name="op" type="numop"/>
-				the operation that combines the result of the "op" operations together.
-				this defaults to "+" (as in the matrix product)
-			</method>
-		</inlet>
-		<inlet id="1">
-			<method name="int">
-				changes the base value to that.
-			</method>
-		</inlet>
-		<inlet id="2">
-			<method name="grid"><arg name="grid" type="grid(anyB..., lastB)"/>
-				changes the right-hand side grid to that.
-			</method>
-		</inlet>
-		<outlet id="0">
-		</outlet>
-	</class>
-
-	<class name="#join">
-		<method name="init">
-			<arg name="which_dim"/>
-			Which_dim is the number of the dimension by which the join will
-			occur. For N-dimensional grids, the dimensions are numbered from 0
-			to N-1. In addition, negative numbers from -N to -1 may be used, to
-			which N will be added.
-		</method>
-		<inlet id="0">
-			<method name="grid"><arg name="grid" type="grid"/>
-				The left grid and right grid must have the same number
-				of elements in all dimensions except the one specified.
-				The result will have the same number of elements in all
-				dimensions except the one specified, which will be the
-				sum of the two corresponding one.
-				
-				For example, joining a RGB picture Dim[y,x,3] and a
-				greyscale picture Dim[y,x,1] on dimension 2 (or -1) could
-				make a RGBA picture Dim[y,x,4] in which the greyscale image
-				becomes the opacity channel.
-				
-			</method>
-		</inlet>
-		<inlet id="1"><method name="grid"><arg name="grid" type="grid"/></method></inlet>
-		<outlet id="0">
-		</outlet>
-	</class>
-
-	<class name="#finished">
-		<inlet id="0">
-			<method name="grid"><arg name="grid" type="grid"/>any grid</method>
-		</inlet>
-		<outlet id="0">
-			a bang is emitted every time a grid transmission ends.
-		</outlet>
-	</class>
-
-	<class name="#cast">
-		<method name="init">
-			<arg name="numbertype" type="numbertype"/>
-		</method>
-		<inlet id="0">
-			<method name="grid"><arg name="grid" type="grid"/>any grid</method>
-		</inlet>
-		<outlet id="0">
-			<method name="grid"><arg name="grid" type="grid"/>a grid of the same shape containing all the same
-			values after type conversion. note that while casting to
-			a smaller type, values that are overflowing will be truncated.
-			</method>
-		</outlet>
-	</class>
-
-	<class name="#ravel">
-		<inlet id="0"><method name="grid"><arg name="grid" type="grid"/>any grid</method></inlet>
-		<outlet id="0"><method name="grid"><arg name="grid" type="grid"/>
-			like [#redim] but always produce a 1-D grid
-			with the same total number of elements.
-		</method></outlet>
-	</class>
-
-	<class name="#grade">
-		<inlet id="0"><method name="grid"><arg name="grid" type="grid"/>any grid</method></inlet>
-		<outlet id="0"><method name="grid"><arg name="grid" type="grid"/>
-			splits a Dim[A...,B] grid into Dim[B] vectors,
-			producing new Dim[B] vectors that each contain numbers from
-			0 to B-1 indicating the ordering of the values. The result is
-			a Dim[A...,B] grid.
-			for example, connecting a [#grade] to a [#outer ignore {0}]
-			to a [#store] object, storing a single vector into [#store], and
-			sending the same vector to [#grade], will sort the values of the
-			vector. however for higher-dimensional grids, what should go
-			between [#store] and [#grade] to achieve the same result would
-			be more complex.
-			you may achieve different kinds of sorting by applying various
-			filters before [#grade]. the possibilities are unlimited.
-			if you plug [#grade] directly into another [#grade], you will
-			get the inverse arrangement, which allows to take the sorted values
-			and make them unsorted in the original way. note that this is really
-			not the same as just listing the values backwards.
-		</method></outlet>
-	</class>
-
 	<class name="#perspective">
 		<method name="init">
 			<arg name="depth" type="integer"/>



More information about the Gridflow-cvs mailing list