From 061e4be1f20ac78e3b52bc6429322d5fadcf5831 Mon Sep 17 00:00:00 2001 From: Hans-Christoph Steiner Date: Thu, 28 Apr 2005 00:25:05 +0000 Subject: 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 --- doc/pddp/bang-help.pd | 143 ++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 143 insertions(+) create mode 100644 doc/pddp/bang-help.pd (limited to 'doc/pddp/bang-help.pd') 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; -- cgit v1.2.1