From e28046aae21a29b080db42c9197bec9fd1d13511 Mon Sep 17 00:00:00 2001
From: Ivica Ico Bukvic <ico@vt.edu>
Date: Tue, 18 Nov 2014 22:15:04 -0500
Subject: [PATCH] *updated mycanvas docs

---
 doc/pddp/my_canvas-help.pd | 42 ++++++++++++++++++++++++++++++--------
 1 file changed, 33 insertions(+), 9 deletions(-)

diff --git a/doc/pddp/my_canvas-help.pd b/doc/pddp/my_canvas-help.pd
index 5693e66e5..2b57771c1 100644
--- a/doc/pddp/my_canvas-help.pd
+++ b/doc/pddp/my_canvas-help.pd
@@ -1,5 +1,5 @@
-#N canvas 432 34 555 619 10;
-#X obj 0 595 cnv 15 552 21 empty \$0-pddp.cnv.footer empty 20 12 0
+#N canvas 432 34 555 662 10;
+#X obj 0 639 cnv 15 552 21 empty \$0-pddp.cnv.footer empty 20 12 0
 14 -228856 -66577 0;
 #X obj 0 0 cnv 15 552 40 empty \$0-pddp.cnv.header my_canvas 3 12 0
 18 -204280 -1 0;
@@ -16,7 +16,7 @@ to conform to the PDDP template for Pd version 0.42.;
 #X text 12 5 ALIAS cnv;
 #X text 12 145 RELEASE_DATE 2002;
 #X text 12 25 KEYWORDS control GUI nonlocal;
-#X restore 500 597 pd META;
+#X restore 500 641 pd META;
 #X obj 0 430 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0
 13 -228856 -1 0;
 #X obj 0 459 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12
@@ -30,7 +30,7 @@ to conform to the PDDP template for Pd version 0.42.;
 #X obj 22 43 drawpolygon;
 #X obj 112 43 filledpolygon;
 #X obj 22 73 x_all_guis bng tgl vsl hsl hradio vradio vu cnv nbx;
-#X restore 102 597 pd Related_objects;
+#X restore 102 641 pd Related_objects;
 #X text 11 23 gui-rectangle;
 #X text 420 10 [my_canvas] or [cnv];
 #X text 98 356 (none);
@@ -347,7 +347,7 @@ a [cnv] \, as are the horizontal dividers below.;
 #X text 182 576 graz \, austria 2002;
 #X msg 435 192 get_pos;
 #X obj 435 214 send to_K;
-#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide
+#X obj 4 641 pddp/pddplink all_about_help_patches.pd -text Usage Guide
 ;
 #N canvas 405 89 483 507 (subpatch) 0;
 #X msg 144 296 bang;
@@ -481,8 +481,8 @@ a [cnv] \, as are the horizontal dividers below.;
 #N canvas 93 78 450 511 let's-play-pong! 0;
 #X obj 148 128 cnv 15 100 25 empty \$0-score Score:0 5 12 0 14 -233017
 -66577 0;
-#X obj 14 29 cnv 15 5 60 \$0-ps \$0-pr empty 20 12 0 14 -1 -66577 0
-;
+#X obj 14 -131 cnv 5 5 60 \$0-ps \$0-pr empty 20 12 0 14 -1 -66577
+0;
 #X obj 257 19 key;
 #X msg 257 112 delta 0 \$1;
 #X msg 257 87 -5;
@@ -569,7 +569,7 @@ a [cnv] \, as are the horizontal dividers below.;
 #X connect 10 0 6 0;
 #X restore 101 386 pd score;
 #X obj 68 95 metro 10;
-#N canvas 0 0 450 300 once 0;
+#N canvas 433 184 450 300 once 0;
 #X obj 26 21 inlet;
 #X obj 26 102 outlet;
 #X obj 26 75 t a b;
@@ -596,7 +596,7 @@ a [cnv] \, as are the horizontal dividers below.;
 #X obj 68 18 r play;
 #X obj 336 111 s play;
 #X msg 87 319 0;
-#X obj 71 51 cnv 10 10 10 \$0-bs \$0-br empty 20 12 0 14 -1 -66577
+#X obj -82 271 cnv 10 10 10 \$0-bs \$0-br empty 20 12 0 14 -1 -66577
 0;
 #X obj 257 202 v bx;
 #X obj 337 202 v px;
@@ -712,6 +712,30 @@ a [cnv] \, as are the horizontal dividers below.;
 #X text 325 551 Note: [cnv] is not to be confused;
 #X text 325 564 with the Pd canvas \, or [pd] \,;
 #X text 325 577 [table] \, etc.;
+#X text 66 233 enable the edit mode and selectthe area below to see
+how you canuse cnv to hide things;
+#N canvas 597 433 432 210 using_canvas_to_hide_objects_that_capture_mouse_clicks
+0;
+#X obj 100 47 tgl 43 0 empty empty empty 17 7 0 10 -262144 -1 -1 0
+1;
+#X obj 81 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12
+0 14 -204280 -1 0;
+#X text 88 2 Using [cnv] to hide objects that capture mouse clicks
+;
+#X obj 100 47 cnv 15 43 43 empty empty CLICK 5 22 0 10 -247832 -66577
+0;
+#X obj 100 109 tgl 21 0 empty empty empty 17 7 0 10 -262144 -1 -1 0
+1;
+#X text 167 46 Try clicking on the [cnv] object to the left.Notice
+how the [cnv] on the left seemingly exhibitstoggle-like behavior.
+In fact \, it is not the [cnv]that is responsible for toggle changing
+its state.Rather \, it is another toggle button that is hiddenunder
+the [cnv] object that does this. This ispossible bacause unlike any
+other iemgui objects \, [cnv] does not capture runtime clicks and
+insteadpasses them to objects below it.;
+#X connect 0 0 4 0;
+#X restore 169 608 pd using_canvas_to_hide_objects_that_capture_mouse_clicks
+;
 #X connect 20 0 38 0;
 #X connect 21 0 20 0;
 #X connect 22 0 29 0;
-- 
GitLab