1 files changed, 130 insertions, 0 deletions
diff --git a/doc/pddp/help-clip.pd b/doc/pddp/help-clip.pd
new file mode 100644
index 00000000..04f8ddb5
--- /dev/null
+++ b/doc/pddp/help-clip.pd
@@ -0,0 +1,130 @@
+#N canvas 3 0 630 628 12;
+#X obj 114 560 pddp;
+#X obj 8 3 cnv 15 90 578 empty empty empty 20 12 0 14 -233017 -66577
+0;
+#X text 38 36 INLETS:;
+#X text 38 51 - LEFT:;
+#X text 32 230 - RIGHT:;
+#X text 29 346 OUTLETS:;
+#X text 13 281 ARGUMENTS:;
+#X text 20 412 EXAMPLES:;
+#X text 20 508 SEE ALSO:;
+#N canvas 58 0 411 260 Related_Objects 0;
+#X text 25 11 Native PD Objects;
+#X text 23 92 Externals and other object libraries;
+#X obj 45 54 int;
+#X obj 85 53 f;
+#X obj 123 53 min;
+#X obj 166 53 max;
+#X obj 206 53 clip~;
+#X obj 260 53 min~;
+#X obj 308 53 max~;
+#X text 44 125 - none that I am aware of;
+#X restore 114 508 pd Related_Objects;
+#N canvas 57 0 639 620 More_Info 0;
+#X text 26 174 THE MYSTERIOUS RIGHT OUTLET;
+#X obj 158 252 clip;
+#X obj 82 240 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X floatatom 130 203 5 0 0 0 - - -;
+#X symbolatom 195 204 10 0 0 0 - - -;
+#X msg 209 227 list dave peter john;
+#X msg 49 200 message;
+#X floatatom 199 281 5 0 0 0 - - -;
+#X obj 258 278 print;
+#X obj 174 283 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X text 313 280 no response to any message or atom.;
+#X text 30 347 LOW AND HIGH VALUES;
+#X text 304 34 Consider the following:;
+#X floatatom 101 66 5 0 0 0 - - -;
+#X floatatom 83 147 5 0 0 0 - - -;
+#X obj 83 121 min 50;
+#X obj 83 95 max -50;
+#X text 170 106 same as;
+#X obj 271 104 clip -50 50;
+#X floatatom 271 133 5 0 0 0 - - -;
+#X text 43 18 [clip] is a tool which combines the functionality of
+[min] and [max] into a single object.;
+#X text 46 368 [clip] always assumes that the first argument (second
+inlet) is the low extreme of the range and the second argument (third
+inlet) is the high extreme. However \, strange behaviour should be
+expected if you mix these arguments up.;
+#X obj 54 491 clip -50 50;
+#X obj 180 485 clip 72 -104;
+#X floatatom 54 458 5 0 0 0 - - -;
+#X floatatom 54 520 5 0 0 0 - - -;
+#X floatatom 180 517 5 0 0 0 - - -;
+#X text 50 306 I assume it is there for a reason...but I don't know
+that reason. It might exist for compatiblity with MAX?;
+#X text 185 444 Numbers below 72 are clipped to 72;
+#X text 185 464 Numbers above -104 are clipped to -104;
+#X text 172 565 This could be used effectively to toggle between two
+numbers.;
+#X floatatom 391 543 5 0 0 0 - - -;
+#X obj 360 520 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0
+1;
+#X obj 392 512 clip 1 -1024;
+#X connect 1 1 7 0;
+#X connect 1 1 8 0;
+#X connect 1 1 9 0;
+#X connect 2 0 1 0;
+#X connect 3 0 1 0;
+#X connect 4 0 1 0;
+#X connect 5 0 1 0;
+#X connect 6 0 1 0;
+#X connect 13 0 16 0;
+#X connect 13 0 18 0;
+#X connect 15 0 14 0;
+#X connect 16 0 15 0;
+#X connect 18 0 19 0;
+#X connect 22 0 25 0;
+#X connect 23 0 26 0;
+#X connect 24 0 22 0;
+#X connect 24 0 23 0;
+#X connect 32 0 33 0;
+#X connect 33 0 31 0;
+#X restore 114 534 pd More_Info;
+#X obj 57 11 clip;
+#X text 105 51 Float - A float at the left inlet will be clipped to
+the low and high values stored in the object.;
+#X text 105 82 List - A list at the left inlet will be truncated to
+include only the first three elements. The first element in the list
+is the number which will be clipped. The second element will update
+the value stored at the second inlet. The third element will update
+the value stored at the third inlet.;
+#X text 25 180 - CENTER:;
+#X text 105 180 Float - A float at the second inlet is stored for later
+use. It will be used as either the low or high value at which to clip
+incoming floats at that left inlet.;
+#X text 105 231 Float - A float at the third inlet is stored for later
+use. It will be used as either the low or high value at which to clip
+incoming floats at that left inlet.;
+#X text 104 281 Two - [float] accepts two floats 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 102 346 One - outputs a float which is limited to a range within
+the high and low values of the second and third inlet. (The second
+outlet has no apparent purpose other than cross-compatibility with
+MAX.);
+#X text 108 12 - FORCE A NUMBER INTO A RANGE;
+#X obj 122 448 clip -50 50;
+#X floatatom 122 475 5 0 0 0 - - -;
+#X floatatom 122 424 5 0 0 0 - - -;
+#X text 181 425 creation arguments;
+#X obj 411 486 clip;
+#X floatatom 404 458 5 0 0 0 - - -;
+#X floatatom 460 457 5 0 0 0 - - -;
+#X floatatom 520 457 5 0 0 0 - - -;
+#X floatatom 411 512 5 0 0 0 - - -;
+#X text 464 488 no arguments;
+#X text 494 425 list;
+#X text 158 561 - Dave Sabine \, April 25 \, 2003;
+#X msg 383 425 42 100 500;
+#X connect 20 0 21 0;
+#X connect 22 0 20 0;
+#X connect 24 0 28 0;
+#X connect 25 0 24 0;
+#X connect 26 0 24 1;
+#X connect 27 0 24 2;
+#X connect 32 0 24 0;