aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJonathan Wilkes <jancsika1@users.sourceforge.net>2011-04-04 22:59:36 +0000
committerJonathan Wilkes <jancsika1@users.sourceforge.net>2011-04-04 22:59:36 +0000
commitefd34b02877430266edf8db2b543f9babfb08836 (patch)
tree716c9ebefd288d57b03640fd2a7bd249b5a4e9e0
parent4b116d86b609d7c668e573a691095bd61800b209 (diff)
fixed typos and mentioned fswap alias in swap-help.pd
svn path=/trunk/; revision=15060
-rw-r--r--doc/pddp/all_about_atom_conversion.pd65
-rw-r--r--doc/pddp/all_about_atoms.pd2
-rw-r--r--doc/pddp/all_about_data_types.pd104
-rw-r--r--doc/pddp/swap-help.pd34
4 files changed, 104 insertions, 101 deletions
diff --git a/doc/pddp/all_about_atom_conversion.pd b/doc/pddp/all_about_atom_conversion.pd
index 9e0cb1bd..210e5ca2 100644
--- a/doc/pddp/all_about_atom_conversion.pd
+++ b/doc/pddp/all_about_atom_conversion.pd
@@ -35,7 +35,7 @@ Wilkes revised the patch to conform to the PDDP template for Pd version
#X obj 43 65 pddp/pddplink all_about_atoms.pd;
#X text 42 36 Converting between atom types in Pd can be tricky. Make
sure you have read the following help patches first:;
-#N canvas 9 155 428 140 symbol-atom_to_float 0;
+#N canvas 11 164 428 140 symbol-atom_to_float 0;
#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 20 10
1 18 -261106 -33289 0;
#X text 7 1 From a symbol-atom to a float;
@@ -43,19 +43,13 @@ sure you have read the following help patches first:;
#X obj 20 90 pddp/helplink zexy/symbol2list;
#X text 20 37 There are no internal objects to turn a symbol-atom into
a float. There are two important externals for this \, however:;
-#X restore 43 149 pd symbol-atom_to_float;
-#N canvas 14 48 428 554 float_to_symbol-atom 0;
+#X restore 43 128 pd symbol-atom_to_float;
+#N canvas 15 77 428 554 float_to_symbol-atom 0;
#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 20 10
1 18 -261106 -33289 0;
#X text 7 1 Changing a float to a symbol-atom;
-#X obj 45 163 hsl 128 15 0 127 0 0 empty 123 empty -2 -8 0 10 -262144
--1 -1 7000 1;
-#X text 19 79 For example \, you can enter a number for the "receive-symbol"
-of the so-called IEMGUIS like the slider below. Since receive-names
-need to be symbol-atoms \, the GUI automatically converts "123" to
-a symbol-atom after you click "Ok" or "Apply" in the "Properties" dialogue.
-;
-#X text 181 158 <- hslider with receive-symbol "123";
+#X obj 45 201 hsl 128 15 0 127 0 0 empty 123 empty -2 -8 0 10 -262144
+-1 -1 0 1;
#X msg 42 353 symbol 123;
#X obj 42 375 print empty_symbol;
#X msg 151 457 123;
@@ -66,33 +60,38 @@ a symbol-atom after you click "Ok" or "Apply" in the "Properties" dialogue.
#X text 255 509 symbol-atom;
#X obj 130 503 send;
#X floatatom 93 479 5 0 0 0 - - -;
-#X text 19 395 The [makefilename] object will do the trick \, however.
-It always outputs a symbol message (remember that a symbol message
-must have a symbol-atom as an element) \, and so it can convert an
-incoming float to a symbol-atom:;
#X text 19 494 Also see:;
#X obj 20 514 pddp/helplink zexy/list2symbol;
#X obj 20 529 pddp/helplink cyclone/tosymbol;
-#X text 19 36 Problem: some objects in Pd expect certain atom types
-and will complain with an error if they receive the wrong type. Other
-objects will silently make the conversion for you.;
-#X text 19 183 Note that there's no visible difference between the
-float "123" and the symbol-atom "123"-- the only difference is in how
-these character are understood by Pd. If I want to send a value to
-the slider using [send] \, there is a problem because [send] doesn't
-do any atom conversion-- if you try to create [send 123] you'll get
-an error.;
#X text 19 267 However \, you can send a symbol message to the right
inlet of [send] to specify the send-name. You might think that using
-a symbol message will convert the number to a symbol-atom. Unfortunately
-\, that doesn't work either-- the message box silently ignores the
-float and outputs an empty symbol:;
-#X connect 5 0 6 0;
-#X connect 7 0 9 0;
-#X connect 9 0 13 1;
-#X connect 14 0 13 0;
+a symbol message will convert the float to a symbol-atom. Unfortunately
+\, that doesn't work either-- the message box in Pd silently ignores
+the float and outputs an empty symbol:;
+#X text 19 119 For example \, you can enter a number for the "receive-symbol"
+of the so-called IEMGUIS like the slider below. Since receive-names
+need to be symbol-atoms \, the slider automatically makes "123" a symbol-atom
+after you click "Ok" or "Apply" in the "Properties" dialogue.;
+#X text 181 198 <- [hslider] with receive-symbol "123";
+#X text 19 36 Usually it is easy to distinguish between floats and
+symbol-atoms in Pd. However \, there are times when it can be useful
+to have a symbol-atom that looks like a number. This can quickly get
+confusing because there's no visible difference between the float "123"
+and the symbol-atom "123". The only difference is in how it is understood
+by Pd.;
+#X text 19 225 If I try to send a value to the slider using [send 123]
+\, there will be an error because after I type the argument "123" in
+an object box \, Pd will interpret it as a float.;
+#X text 19 395 Solution: the [makefilename] object. It always outputs
+a symbol message (remember that a symbol message must have a symbol-atom
+as an element) \, and so it will convert an incoming float to a symbol-atom:
+;
+#X connect 3 0 4 0;
+#X connect 5 0 7 0;
+#X connect 7 0 11 1;
+#X connect 12 0 11 0;
#X restore 43 106 pd float_to_symbol-atom;
-#N canvas 22 133 428 426 multiple_atoms_to_one_symbol-atom 0;
+#N canvas 25 220 428 426 multiple_atoms_to_one_symbol-atom 0;
#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 20 10
1 18 -261106 -33289 0;
#X text 7 1 Concatenate multiple atoms;
@@ -119,7 +118,7 @@ that contains spaces in it. Use the %c argument with [makefilename].
#X connect 4 0 5 0;
#X connect 10 0 11 0;
#X connect 12 0 10 0;
-#X restore 43 128 pd multiple_atoms_to_one_symbol-atom;
+#X restore 43 150 pd multiple_atoms_to_one_symbol-atom;
#X text 42 171 See also:;
#X obj 43 187 pddp/pddplink all_about_message_conversion.pd;
#X obj 43 202 pddp/pddplink all_about_symbol_construction.pd;
diff --git a/doc/pddp/all_about_atoms.pd b/doc/pddp/all_about_atoms.pd
index bd775df3..108a6b7d 100644
--- a/doc/pddp/all_about_atoms.pd
+++ b/doc/pddp/all_about_atoms.pd
@@ -3,7 +3,7 @@
-261106 -33289 0;
#X obj 407 2 pddp/pddplink http://puredata.info/dev/pddp -text pddp
;
-#N canvas 14 48 428 202 What_is_an_atom? 0;
+#N canvas 15 77 428 202 What_is_an_atom? 0;
#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 20 10
1 18 -261106 -33289 0;
#X text 7 1 What is an atom in Pd?;
diff --git a/doc/pddp/all_about_data_types.pd b/doc/pddp/all_about_data_types.pd
index 9fa53203..c9de0c72 100644
--- a/doc/pddp/all_about_data_types.pd
+++ b/doc/pddp/all_about_data_types.pd
@@ -1,52 +1,52 @@
-#N canvas 0 0 448 239 10;
-#X obj 1 1 cnv 15 445 20 empty \$0-pddp.cnv.header data_types 20 10
-1 18 -261106 -33289 0;
-#X obj 407 2 pddp/pddplink http://puredata.info/dev/pddp -text pddp
-;
-#X obj 43 66 pddp/pddplink all_about_atoms.pd;
-#X obj 1 217 cnv 15 445 20 empty \$0-pddp.cnv.footer empty 20 12 0
-14 -233017 -33289 0;
-#N canvas 44 246 494 344 META 0;
-#X text 12 105 HELP_PATCH_AUTHORS Dave Sabine \, May 5 \, 2003 . Jonathan
-Wilkes revised the patch to conform to the PDDP template for Pd version
-0.42.;
-#X text 12 85 LIBRARY PDDP;
-#X text 12 5 GENRE all_about_pd;
-#X text 12 25 NAME;
-#X text 12 45 KEYWORDS;
-#X text 12 65 DESCRIPTION list of help patches related to Pd data types
-;
-#X restore 392 219 pd META;
-#X obj 6 219 pddp/pddplink all_about.pd -text All About Pd;
-#N canvas 24 124 428 150 Quick_Quiz! 0;
-#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0
-14 -261106 -33289 0;
-#X text 7 2 Messages- Related Objects;
-#X obj 22 99 bng 15 250 50 0 empty empty list 0 25 0 8 -262144 -1 -1
-;
-#X obj 59 99 bng 15 250 50 0 empty empty bang 0 25 0 8 -262144 -1 -1
-;
-#X obj 97 99 bng 15 250 50 0 empty empty float 0 25 0 8 -262144 -1
--1;
-#X obj 135 99 bng 15 250 50 0 empty empty symbol 0 25 0 8 -262144 -1
--1;
-#X obj 176 99 bng 15 250 50 0 empty empty pop 0 25 0 8 -262144 -1 -1
-;
-#X obj 211 99 bng 15 250 50 0 empty empty none_of_the_above 0 25 0
-8 -262144 -1 -1;
-#X text 276 42 <- Click to find out;
-#X msg 22 43 pop quiz: What type of message is this?;
-#X obj 22 70 route list bang float symbol pop;
-#X connect 9 0 10 0;
-#X connect 10 0 2 0;
-#X connect 10 1 3 0;
-#X connect 10 2 4 0;
-#X connect 10 3 5 0;
-#X connect 10 4 6 0;
-#X connect 10 5 7 0;
-#X restore 103 219 pd Quick_Quiz!;
-#X text 42 36 See:;
-#X obj 43 86 pddp/pddplink all_about_messages.pd;
-#X obj 43 106 pddp/pddplink all_about_message_conversion.pd;
-#X obj 43 126 pddp/pddplink all_about_atom_conversion.pd;
-#X obj 43 146 pddp/pddplink all_about_symbol_construction.pd;
+#N canvas 0 0 448 239 10;
+#X obj 1 1 cnv 15 445 20 empty \$0-pddp.cnv.header data_types 20 10
+1 18 -261106 -33289 0;
+#X obj 407 2 pddp/pddplink http://puredata.info/dev/pddp -text pddp
+;
+#X obj 43 66 pddp/pddplink all_about_atoms.pd;
+#X obj 1 217 cnv 15 445 20 empty \$0-pddp.cnv.footer empty 20 12 0
+14 -233017 -33289 0;
+#N canvas 44 246 494 344 META 0;
+#X text 12 105 HELP_PATCH_AUTHORS Dave Sabine \, May 5 \, 2003 . Jonathan
+Wilkes revised the patch to conform to the PDDP template for Pd version
+0.42.;
+#X text 12 85 LIBRARY PDDP;
+#X text 12 5 GENRE all_about_pd;
+#X text 12 25 NAME;
+#X text 12 45 KEYWORDS;
+#X text 12 65 DESCRIPTION list of help patches related to Pd data types
+;
+#X restore 392 219 pd META;
+#X obj 6 219 pddp/pddplink all_about.pd -text All About Pd;
+#N canvas 25 153 428 150 Quick_Quiz! 0;
+#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0
+14 -261106 -33289 0;
+#X text 7 2 Messages- Related Objects;
+#X obj 22 99 bng 15 500 50 0 empty empty list 0 25 0 8 -262144 -1 -1
+;
+#X obj 69 99 bng 15 500 50 0 empty empty bang 0 25 0 8 -262144 -1 -1
+;
+#X obj 117 99 bng 15 500 50 0 empty empty float 0 25 0 8 -262144 -1
+-1;
+#X obj 165 99 bng 15 500 50 0 empty empty symbol 0 25 0 8 -262144 -1
+-1;
+#X obj 213 99 bng 15 500 50 0 empty empty pop 0 25 0 8 -262144 -1 -1
+;
+#X obj 261 99 bng 15 500 50 0 empty empty none_of_the_above 0 25 0
+8 -262144 -1 -1;
+#X text 276 42 <- Click to find out;
+#X msg 22 43 pop quiz: What type of message is this?;
+#X obj 22 70 route list bang float symbol pop;
+#X connect 9 0 10 0;
+#X connect 10 0 2 0;
+#X connect 10 1 3 0;
+#X connect 10 2 4 0;
+#X connect 10 3 5 0;
+#X connect 10 4 6 0;
+#X connect 10 5 7 0;
+#X restore 103 219 pd Quick_Quiz!;
+#X text 42 36 See:;
+#X obj 43 86 pddp/pddplink all_about_messages.pd;
+#X obj 43 106 pddp/pddplink all_about_message_conversion.pd;
+#X obj 43 126 pddp/pddplink all_about_atom_conversion.pd;
+#X obj 43 146 pddp/pddplink all_about_symbol_construction.pd;
diff --git a/doc/pddp/swap-help.pd b/doc/pddp/swap-help.pd
index 9e4b0133..2ab8c4b9 100644
--- a/doc/pddp/swap-help.pd
+++ b/doc/pddp/swap-help.pd
@@ -5,22 +5,23 @@
-1 0;
#X obj 0 220 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13
-228856 -1 0;
-#N canvas 52 246 494 357 META 0;
-#X text 12 145 LIBRARY internal;
-#X text 12 185 WEBSITE http://crca.ucsd.edu/~msp/;
-#X text 12 25 LICENSE SIBSD;
-#X text 12 165 AUTHOR Miller Puckette;
-#X text 12 225 HELP_PATCH_AUTHORS Dave Sabine \, November 12 \, 2002
+#N canvas 53 275 494 357 META 0;
+#X text 12 165 LIBRARY internal;
+#X text 12 205 WEBSITE http://crca.ucsd.edu/~msp/;
+#X text 12 45 LICENSE SIBSD;
+#X text 12 185 AUTHOR Miller Puckette;
+#X text 12 245 HELP_PATCH_AUTHORS Dave Sabine \, November 12 \, 2002
. Jonathan Wilkes revised the patch to conform to the PDDP template
for Pd version 0.42.;
-#X text 12 5 KEYWORDS control float list bang;
-#X text 12 45 DESCRIPTION swap two numbers \, respecting right-to-left
+#X text 12 25 KEYWORDS control float list bang;
+#X text 12 65 DESCRIPTION swap two numbers \, respecting right-to-left
order;
-#X text 12 65 INLET_0 float list bang;
-#X text 12 85 INLET_1 float;
-#X text 12 105 OUTLET_0 float;
-#X text 12 125 OUTLET_1 float;
-#X text 12 205 RELEASE_DATE 1997;
+#X text 12 85 INLET_0 float list bang;
+#X text 12 105 INLET_1 float;
+#X text 12 125 OUTLET_0 float;
+#X text 12 145 OUTLET_1 float;
+#X text 12 225 RELEASE_DATE 1997;
+#X text 12 5 ALIAS fswap;
#X restore 500 597 pd META;
#X obj 0 425 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0
13 -228856 -1 0;
@@ -45,7 +46,7 @@ order;
#X obj 78 380 cnv 17 3 35 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856
-162280 0;
#X text 98 379 float;
-#X obj 493 3 swap;
+#X obj 443 3 swap;
#X obj 465 20 pddp/pddplink http://wiki.puredata.info/en/swap -text
pdpedia: swap;
#X text 98 278 float;
@@ -217,7 +218,10 @@ before packing them up and sending them to the [route] object.;
#X text 168 456 - outputs the value from the left inlet.;
#X text 80 503 1) float;
#X text 168 503 - initializes the value of the right inlet.;
-#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide;
+#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide
+;
+#X obj 503 3 fswap;
+#X text 480 3 or;
#X connect 24 0 28 0;
#X connect 24 1 27 0;
#X connect 25 0 24 0;