pic / keyboard help

Help-files/keyboard-help.pd

@@ -1,4 +1,4 @@
-#N canvas 649 24 567 708 10;
+#N canvas 505 23 567 708 10;
 #X obj 5 336 cnv 3 550 3 empty empty inlets 8 12 0 13 -228856 -1 0
 ;
 #X obj 5 534 cnv 3 550 3 empty empty outlets 8 12 0 13 -228856 -1 0
@@ -774,7 +774,7 @@ the there's no normalization and velocity depends where you click.
 #X connect 13 0 12 0;
 #X connect 13 1 12 1;
 #X restore 467 282 pd normalize;
-#N canvas 752 109 519 566 send/receive 0;
+#N canvas 645 30 517 652 send/receive 0;
 #X text 48 22 You can set send/receive names with the -send/-receive
 flags or the 'send'/'receive' messages - make sure to escape "\$0"
 properly with backslashes (as in: "\\\$0"). Setting these to 'empty'
@@ -796,6 +796,11 @@ mode. This is an indicative that the object has a send or receive symbol.
 #X obj 51 193 else/display;
 #X text 172 209 This way you don't need to use both inlets and just
 rely on the built in receive symbol, f 45;
+#X text 50 550 Note that inside the properties window you don't need
+to escape the special characters of "$" and also spaces \, both of
+which are allowed. Also note that other special characters are not
+allowed \, such as braces \, backslashes \, commas and semicolons.
+, f 69;
 #X connect 1 0 10 0;
 #X connect 3 0 2 0;
 #X connect 5 0 2 0;

Help-files/pic-help.pd

@@ -1,4 +1,4 @@
-#N canvas 502 46 561 680 10;
+#N canvas 583 51 561 680 10;
 #X obj 306 4 cnv 15 250 40 empty empty empty 12 13 0 18 -128992 -233080
 0;
 #N canvas 382 141 749 319 (subpatch) 0;
@@ -34,8 +34,6 @@
 0;
 #X text 127 371 open <symbol>;
 #X text 213 371 - open an image file named by the symbol, f 50;
-#X msg 229 144 open tklogo.gif;
-#X msg 252 170 open pdlogo.gif;
 #X obj 229 335 else/display;
 #X obj 98 485 cnv 17 3 42 empty empty 0 5 9 0 16 -228856 -162280 0
 ;
@@ -45,15 +43,15 @@
 #X text 213 445 - sets a send symbol, f 50;
 #X text 109 460 receive <symbol>;
 #X text 213 460 - sets a receive symbol, f 50;
-#N canvas 614 194 494 501 send 0;
+#N canvas 614 194 493 549 send 0;
 #X obj 317 306 else/display;
 #X obj 73 332 else/display;
 #X obj 317 272 r \$0-pic-snd;
-#X text 73 402 Note that when you set a receive or send symbol \, the
+#X text 73 393 Note that when you set a receive or send symbol \, the
 corresponding inlet/outlet does not get drawn when you're in edit mode.
 This is an indicative that the object has a send or receive symbol.
 , f 57;
-#X obj 73 186 else/pic 1 pdlogo.gif \$0-pic-snd \$0-pic-rcv 0;
+#X obj 73 186 else/pic 1 pdlogo.gif \$0-pic-snd \$0-pic-rcv 0 0;
 #X text 47 39 You can set send/receive names with the -send/-receive
 flags or the 'send'/'receive' messages - make sure to escape "\$0"
 properly with backslashes (as in: "\\\$0"). Setting these to 'empty'
@@ -66,13 +64,18 @@ removes the send/receive symbols., f 67;
 #X obj 320 170 tgl 15 0 empty empty empty 17 7 0 10 -262144 -1 -1 0
 1;
 #X msg 90 150 send empty \, receive empty;
+#X text 57 462 Note that inside the properties window you don't need
+to escape the special characters of "$" and also spaces \, both of
+which are allowed. Also note that other special characters are not
+allowed \, such as braces \, backslashes \, commas and semicolons.
+, f 69;
 #X connect 2 0 0 0;
 #X connect 4 0 1 0;
 #X connect 7 0 4 0;
 #X connect 9 0 8 0;
 #X connect 10 0 9 0;
 #X connect 11 0 4 0;
-#X restore 481 255 pd send \; receive;
+#X restore 481 251 pd send \; receive;
 #N canvas 662 128 675 552 examples 0;
 #N canvas 457 127 474 484 (subpatch) 0;
 #X msg 117 275 open green.gif;
@@ -83,7 +86,7 @@ removes the send/receive symbols., f 67;
 #X obj 155 65 else/initmess open red.gif;
 #X obj 217 261 delay 250;
 #X text 283 261 <= flash time;
-#X obj 104 104 else/pic 0 red.gif empty empty 0;
+#X obj 104 104 else/pic 0 red.gif empty empty 0 0;
 #X connect 0 0 3 0;
 #X connect 1 0 3 0;
 #X connect 4 0 8 0;
@@ -106,7 +109,7 @@ removes the send/receive symbols., f 67;
 #X msg 124 327 open red.gif;
 #X obj 104 402 outlet;
 #X obj 148 72 else/initmess open red.gif;
-#X obj 104 104 else/pic 0 red.gif empty empty 0;
+#X obj 104 104 else/pic 0 red.gif empty empty 0 0;
 #X connect 0 0 1 0;
 #X connect 0 0 6 0;
 #X connect 1 0 5 0;
@@ -134,7 +137,7 @@ to behave like a bang with a flash time. See below., f 41;
 #X msg 121 283 open red.gif;
 #X obj 104 402 outlet;
 #X obj 133 66 else/initmess open red.gif;
-#X obj 104 104 else/pic 0 red.gif empty empty 0;
+#X obj 104 104 else/pic 0 red.gif empty empty 0 1;
 #X obj 214 315 s \$0-set3;
 #X obj 104 28 r \$0-set3;
 #X obj 121 238 select 0, f 16;
@@ -159,13 +162,13 @@ images for each state., f 36;
 #X connect 0 0 1 0;
 #X connect 3 0 4 0;
 #X connect 10 0 11 0;
-#X restore 463 309 pd examples;
+#X restore 463 307 pd examples;
 #N canvas 616 241 776 349 more 0;
 #X text 67 109 default image =>;
 #X text 23 209 Now please get into and out of edit mode so you can
 see how the [pic] object creates an outline and inlet/outlet when you're
 in edit mode., f 50;
-#X obj 174 99 else/pic 0 empty empty empty 0;
+#X obj 174 99 else/pic 0 empty empty empty 0 0;
 #X text 14 30 When you have an empty filename or an error opening a
 file (via properties window \, flag or message) \, [pic] loads a default
 image of a question mark:, f 51;
@@ -177,7 +180,7 @@ symbol. Using something like "\$1" is also possible and useful if you're
 using the object in an abstraction \, then you can load a value passed
 as an argument into a parameter., f 59;
 #X obj 397 301 else/display;
-#X obj 397 163 else/pic 0 pdlogo.gif \$0-snd empty 0;
+#X obj 397 163 else/pic 0 pdlogo.gif \$0-snd empty 0 0;
 #X obj 567 192 r \$0-snd;
 #X obj 567 217 else/display;
 #X text 20 259 Note that when you set a receive or send symbol \, the
@@ -190,21 +193,21 @@ dollar sign arguments (\$0 \, \$1 \, \$2 \, and so on). Namely \, these
 parameters are: name and send/receive symbols., f 59;
 #X connect 7 0 6 0;
 #X connect 8 0 9 0;
-#X restore 487 201 pd more details;
+#X restore 487 171 pd more details;
 #X f 7;
 #N canvas 835 231 468 365 outline 0;
 #X msg 181 155 outline \$1;
 #X obj 181 118 tgl 15 0 empty empty empty 17 7 0 10 -228856 -1 -1 0
 1;
-#X obj 181 188 else/pic 0 tklogo.gif empty empty 0;
+#X obj 181 188 else/pic 0 tklogo.gif empty empty 0 0;
 #X text 66 33 You can always have an outline of the picture (and not
 only while in edit mode) if you set the outline mode with the 'outline'
 message \, the -outline flag or via properties window \, in which case
 a non zero value sets to outline mode.;
 #X connect 0 0 2 0;
 #X connect 1 0 0 0;
-#X restore 469 233 pd outline;
-#X obj 229 197 else/pic 0 pdlogo.gif empty empty 0;
+#X restore 469 229 pd outline;
+#X obj 229 197 else/pic 0 pd\ logo.gif empty empty 0 0;
 #X obj 4 532 cnv 3 550 3 empty empty arguments 8 12 0 13 -228856 -1
 0;
 #X text 259 539 (none);
@@ -223,25 +226,25 @@ a non zero value sets to outline mode.;
 #X text 213 386 - same as open \, but pd doesn't ask to save changes
 ;
 #X text 181 514 list;
-#N canvas 663 122 711 748 zoom 0;
+#N canvas 640 92 711 748 zoom 0;
 #X obj 33 81 else/canvas.zoom;
 #X text 17 12 When in zoom mode \, [pic] cannot zoom into the loaded
 image. A possible workaround is to use [canvas.zoom] and load an image
 twice as big when the patch window gets zoomed in., f 52;
-#X obj 33 195 else/pic 0 pdlogo.gif empty empty 0;
-#X msg 33 147 open pdlogo.gif;
-#X msg 139 148 open pdlogo-big.gif;
+#X obj 33 195 else/pic 0 pd\ logo.gif empty empty 0 0;
 #X obj 33 102 tgl 15 0 empty empty empty 17 7 0 10 -228856 -1 -1 0
 1;
-#X obj 33 124 select 0 1, f 36;
+#X obj 33 124 select 0 1, f 40;
 #X obj 33 334 else/display;
-#X connect 0 0 5 0;
-#X connect 2 0 7 0;
-#X connect 3 0 2 0;
-#X connect 4 0 2 0;
-#X connect 5 0 6 0;
-#X connect 6 0 3 0;
-#X connect 6 1 4 0;
+#X msg 151 152 set pd\ logo-big.gif;
+#X msg 33 152 set pd\ logo.gif;
+#X connect 0 0 3 0;
+#X connect 2 0 5 0;
+#X connect 3 0 4 0;
+#X connect 4 0 7 0;
+#X connect 4 1 6 0;
+#X connect 6 0 2 0;
+#X connect 7 0 2 0;
 #X restore 487 330 pd zoom;
 #X text 124 621 -size: sets to "report size" mode (default no report)
 , f 57;
@@ -250,7 +253,7 @@ twice as big when the patch window gets zoomed in., f 52;
 #N canvas 651 230 503 428 size 0;
 #X msg 215 133 open tklogo.gif;
 #X msg 238 159 open pdlogo.gif;
-#X obj 215 197 else/pic 0 pdlogo.gif empty empty 1;
+#X obj 215 197 else/pic 0 pdlogo.gif empty empty 1 0;
 #X obj 151 131 tgl 15 0 empty empty empty 17 7 0 10 -228856 -1 -1 0
 1;
 #X msg 151 158 size \$1;
@@ -263,7 +266,7 @@ list of width and height.;
 #X connect 2 0 5 0;
 #X connect 3 0 4 0;
 #X connect 4 0 2 0;
-#X restore 487 288 pd size;
+#X restore 487 284 pd size;
 #X text 127 400 latch <float>;
 #X text 43 89 [pic] loads image pictures that you can interact with.
 It only works with file types: .gif \, .ppm & .pgm. you click on the
@@ -279,8 +282,30 @@ releasing (when in latch mode)., f 68;
 #X text 213 514 - pic width/height when in report size mode;
 #X text 124 636 -latch: sets to "latch" mode (default "bang" mode)
 , f 57;
-#X connect 19 0 33 0;
-#X connect 20 0 33 0;
-#X connect 33 0 21 0;
-#X connect 54 0 33 0;
-#X connect 55 0 54 0;
+#X msg 229 144 open tk\ logo.gif;
+#X msg 252 170 open pd\ logo.gif;
+#N canvas 835 231 478 475 open/set 0;
+#X obj 153 397 else/display;
+#X obj 153 259 else/pic 0 tk\ logo.gif empty empty 0 0;
+#X msg 153 206 open tk\ logo.gif;
+#X msg 176 232 set pd\ logo.gif;
+#X text 62 32 The open and set messages are basically the same \, but
+opening a file will make pd ask you if you want to save changes when
+you close the patch. Since this can be an undesired annoyance \, you
+can use the 'set' message instead.;
+#X text 62 84 Note you can use backslash to escape spaces in a message.
+You can also open an image by typing a new file name into the properties
+window., f 59;
+#X text 62 124 Nonetheless \, inside the properties window you don't
+need to escape spaces with backslashes. Also note that other special
+characters are not allowed in the properties window \, such as braces
+\, backslashes \, commas and semicolons., f 59;
+#X connect 1 0 0 0;
+#X connect 2 0 1 0;
+#X connect 3 0 1 0;
+#X restore 463 206 pd open/set;
+#X connect 31 0 19 0;
+#X connect 52 0 31 0;
+#X connect 53 0 52 0;
+#X connect 59 0 31 0;
+#X connect 60 0 31 0;