cleaned up a number of patches; renamed all to the standard -help.pd format; added some more ideas to the style guide; finished up lists_vs_anythings

svn path=/trunk/; revision=2841

1 files changed, 143 insertions, 0 deletions

diff --git a/doc/pddp/bang-help.pd b/doc/pddp/bang-help.pd
new file mode 100644
index 00000000..485c9699
--- /dev/null
+++ b/doc/pddp/bang-help.pd
@@ -0,0 +1,143 @@
+#N canvas 12 2 916 656 10;

+#X obj 502 191 print;

+#X obj 22 14 bang;

+#X msg 514 133 walk the cat;

+#X msg 501 112 45;

+#X obj 502 166 bang;

+#X text 110 13 - SEND "BANG" MESSAGE;

+#X obj 76 14 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1

+-1;

+#X text 22 38 The bang object is one of the basic building blocks of

+PD and are normally used to activate events. The bang object can be

+created in two different ways.;

+#X obj 45 83 bang;

+#X text 22 82 1;

+#X text 21 141 2;

+#X obj 45 142 bng 15 250 50 0 empty empty empty 18 7 0 8 -262144 -1

+-1;

+#X text 45 107 This version uses minimal CPU but serves essentially

+the same purpose as the GUI version.;

+#X text 43 286 1 Size;

+#X obj 122 289 bng 8 250 50 0 empty empty 8 10 4 0 8 -262144 -1 -1

+;

+#X obj 147 282 bng 15 250 50 0 empty empty 15 17 9 0 8 -262144 -1 -1

+;

+#X obj 182 272 bng 25 250 50 0 empty empty 25 27 20 0 8 -262144 -1

+-1;

+#X text 69 304 Default size is 15 pixels. The minimum size is 8 and

+it does not have a maximum size.;

+#X text 41 465 3 Hold;

+#X obj 111 465 bng 15 50 10 0 empty empty 50 17 8 0 8 -262144 -1 -1

+;

+#X obj 146 465 bng 15 750 50 0 empty empty 750 17 8 0 8 -262144 -1

+-1;

+#X text 41 538 4 Receive Symbol/Send Symbol;

+#X text 67 553 This object can act as its own send or receive object.

+;

+#X obj 69 575 bng 15 250 50 0 link_this_bang empty This_one_sends_a_bang

+17 8 128 8 -262144 -1 -1;

+#X obj 69 596 bng 15 250 50 0 empty link_this_bang This_one_receives_it.

+17 8 64 8 -262144 -1 -1;

+#X text 280 567 Here is the alternative method.;

+#X text 44 644 5 GUI Options;

+#X obj 506 368 bng 8 250 50 0 empty empty empty 0 -6 0 12 -262144 -1

+-1;

+#X msg 679 359 label Name_that_bang;

+#X msg 692 383 label Rename_that_bang;

+#X msg 719 405 size 8;

+#X text 67 666 The other properties are 'name' \, 'x/y offset' \, 'font

+size' \, and colours (for the background \, front \, and labels [name])

+;

+#X obj 471 19 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1

+-1;

+#X obj 471 659 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1

+-1;

+#X text 495 55 WHAT CAN IT DO?;

+#X text 495 67 The bang object outputs "bang" when it receives something

+in its inlet or its 'internal' receive symbol (GUI version only).;

+#X text 547 190 The output window will print "bang" to demonstrate.

+;

+#X obj 647 162 print;

+#X msg 647 116 walk the cat;

+#X obj 647 141 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1

+-1;

+#X text 502 215 It is important to note that "bang" is not boolean.

+It's neither a zero or a one \; it's not true or false \; it's just

+"bang". For a boolean object \, you should check out the toggle.;

+#X obj 502 487 loadbang;

+#X obj 643 487 tgl 15 0 empty empty Toggle 0 -6 0 8 -262144 -1 -1 0

+1;

+#X obj 557 487 trigger;

+#X obj 606 487 bang~;

+#X text 502 290 OTHER HELPFUL INFO;

+#X msg 735 427 size 25;

+#X text 502 312 The label and size properties of the bng object (from

+IEM library) can be updated dynamically by sending messages to its

+inlet.;

+#X text 512 461 RELATED OBJECTS;

+#X text 44 165 This version uses a little more CPU than its cousin

+because it lights-up when it receives a message or is clicked on and

+can be coloured \, resized \, or renamed. It is sometimes 'friendlier'

+as well because it can act as its own send and receive object (see

+properties...). This object can be put in a Pd patch either by keyboard

+shortcut: ALT+B or by creating and object (CTRL+1) called "bng".;

+#X text 66 482 The default hold is 250 milliseconds. The hold value

+controls the length of time that the bng object stays "lit". Note that

+bng sends its message immediately regardless of the hold value.;

+#X obj 261 621 s linked_bngs;

+#X obj 370 583 r linked_bngs;

+#X text 40 334 2 Interrupt (milliseconds);

+#X text 66 348 If the bng object is "lit" and holding (see "hold" below)

+\, then receives another message before the hold time has passed \,

+the bng will quickly flash again for the duration you set in this interrupt

+property.;

+#X obj 42 421 bng 15 1000 50 0 empty empty empty 0 -6 0 8 -262144 -1

+-1;

+#X text 65 405 This bng will hold for 1000 milliseconds \, but interrupt

+for 50 milliseconds if it gets a second message during its "hold".

+Click it once...wait. Then click it multiple times rather quickly to

+see the effect.;

+#X obj 261 603 bang;

+#X obj 370 602 bang;

+#X msg 261 584 send a message;

+#X obj 370 620 print;

+#X text 69 143 a.k.a. "bng";

+#X text 43 264 PROPERTIES OF BNG;

+#X text 497 548 This document was updated for Pd version 0.35 test

+24 by Dave Sabine as part of a project called pddp proposed by Krzysztof

+Czaja to build comprehensive documentation for Pd.;

+#N canvas 4 24 432 275 related_objects_from_other_libraries 0;

+#X obj 266 48 oneshot;

+#X obj 259 28 toddle;

+#X obj 18 48 render_trigger;

+#X obj 18 28 metroplus;

+#X obj 78 28 exciter;

+#X obj 127 28 bangfilter1+2;

+#X obj 211 28 counter;

+#X obj 108 48 countund;

+#X obj 163 48 kalashnikov;

+#X obj 236 48 init;

+#X text 18 86 These objects are offered in Pd only if you have downloaded

+and properly installed the appropriate library. These objects may or

+may not exist in a single library.;

+#X text 17 135 The best places to find information about Pd's libraries

+is:;

+#X text 14 157 www.puredata.org and click on "Downloads" then "Software"

+;

+#X text 15 173 or;

+#X text 16 187 iem.kug.ac.at/pdb/;

+#X restore 501 513 pd related_objects_from_other_libraries;

+#X connect 2 0 4 0;

+#X connect 3 0 4 0;

+#X connect 4 0 0 0;

+#X connect 28 0 27 0;

+#X connect 29 0 27 0;

+#X connect 30 0 27 0;

+#X connect 32 0 33 0;

+#X connect 38 0 39 0;

+#X connect 39 0 37 0;

+#X connect 46 0 27 0;

+#X connect 52 0 58 0;

+#X connect 57 0 51 0;

+#X connect 58 0 60 0;

+#X connect 59 0 57 0;