aboutsummaryrefslogtreecommitdiff
path: root/doc/pddp/bang-help.pd
blob: 485c969966e887924edfcbf7b578982e0304778d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
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;