From efd34b02877430266edf8db2b543f9babfb08836 Mon Sep 17 00:00:00 2001 From: Jonathan Wilkes Date: Mon, 4 Apr 2011 22:59:36 +0000 Subject: fixed typos and mentioned fswap alias in swap-help.pd svn path=/trunk/; revision=15060 --- doc/pddp/all_about_atom_conversion.pd | 65 +++++++++++---------- doc/pddp/all_about_atoms.pd | 2 +- doc/pddp/all_about_data_types.pd | 104 +++++++++++++++++----------------- doc/pddp/swap-help.pd | 34 ++++++----- 4 files changed, 104 insertions(+), 101 deletions(-) (limited to 'doc') 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; -- cgit v1.2.1