SF.net SVN: supercollider:[9103] trunk/build/Help/GUI/Cocoa-GUI/ SCCompositeView.html

View: New views

1 Messages — Rating Filter: Alert me

SF.net SVN: supercollider:[9103] trunk/build/Help/GUI/Cocoa-GUI/ SCCompositeView.html

by jmfuo :: Rate this Message:

Reply to Author | View Threaded | Show Only this Message

Revision: 9103
http://supercollider.svn.sourceforge.net/supercollider/?rev=9103&view=rev
Author: jmfuo
Date: 2009-04-22 18:51:15 +0000 (Wed, 22 Apr 2009)

Log Message:
-----------
typo

Modified Paths:
--------------
trunk/build/Help/GUI/Cocoa-GUI/SCCompositeView.html

Modified: trunk/build/Help/GUI/Cocoa-GUI/SCCompositeView.html
===================================================================
--- trunk/build/Help/GUI/Cocoa-GUI/SCCompositeView.html 2009-04-22 18:43:41 UTC (rev 9102)
+++ trunk/build/Help/GUI/Cocoa-GUI/SCCompositeView.html 2009-04-22 18:51:15 UTC (rev 9103)
@@ -9,7 +9,7 @@
<style type="text/css">
p.p1 {margin: 0.0px 0.0px 0.0px 0.0px; font: 12.0px Helvetica}
p.p2 {margin: 0.0px 0.0px 0.0px 0.0px; font: 12.0px Helvetica; min-height: 14.0px}
-p.p3 {margin: 0.0px 0.0px 0.0px 0.0px; font: 12.0px Helvetica; color: #001ee6}
+p.p3 {margin: 0.0px 0.0px 0.0px 0.0px; font: 12.0px Helvetica; color: #0000bf}
p.p4 {margin: 0.0px 0.0px 0.0px 0.0px; font: 9.0px Monaco; min-height: 12.0px}
p.p5 {margin: 0.0px 0.0px 0.0px 0.0px; font: 14.0px Helvetica}
p.p6 {margin: 0.0px 0.0px 0.0px 57.0px; text-indent: -57.0px; font: 9.0px Monaco; min-height: 12.0px}
@@ -20,25 +20,20 @@
p.p11 {margin: 0.0px 0.0px 0.0px 0.0px; font: 9.0px Monaco}
p.p12 {margin: 0.0px 0.0px 0.0px 57.0px; text-indent: -57.0px; font: 14.0px Helvetica}
p.p13 {margin: 0.0px 0.0px 0.0px 57.0px; text-indent: -57.0px; font: 14.0px Helvetica; min-height: 17.0px}
-p.p14 {margin: 0.0px 0.0px 0.0px 0.0px; font: 9.0px Monaco; color: #000000}
-p.p15 {margin: 0.0px 0.0px 0.0px 0.0px; font: 9.0px Monaco; color: #000000; min-height: 12.0px}
-p.p16 {margin: 0.0px 0.0px 0.0px 0.0px; font: 9.0px Monaco; color: #bf0000}
-p.p17 {margin: 0.0px 0.0px 0.0px 57.0px; text-indent: -57.0px; font: 12.0px Helvetica; color: #000000; min-height: 14.0px}
-p.p18 {margin: 0.0px 0.0px 0.0px 0.0px; font: 12.0px Helvetica; color: #000000; min-height: 14.0px}
-p.p19 {margin: 0.0px 0.0px 0.0px 0.0px; font: 9.0px Monaco; color: #606060}
-p.p20 {margin: 0.0px 0.0px 0.0px 0.0px; font: 9.0px Monaco; color: #515367; min-height: 12.0px}
-p.p21 {margin: 0.0px 0.0px 0.0px 57.0px; text-indent: -57.0px; font: 14.0px Helvetica; color: #000000; min-height: 17.0px}
+p.p14 {margin: 0.0px 0.0px 0.0px 0.0px; font: 9.0px Monaco; color: #bf0000}
+p.p15 {margin: 0.0px 0.0px 0.0px 0.0px; font: 9.0px Monaco; color: #606060}
+p.p16 {margin: 0.0px 0.0px 0.0px 0.0px; font: 9.0px Monaco; color: #0000bf; min-height: 12.0px}
span.s1 {font: 18.0px Helvetica}
span.s2 {color: #000000}
-span.s3 {color: #5f689f}
-span.s4 {color: #61699c}
-span.s5 {color: #656b96}
-span.s6 {color: #5d67a2}
-span.s7 {color: #6f7178}
+span.s3 {color: #0000bf}
+span.s4 {color: #0000bf}
+span.s5 {color: #0000bf}
+span.s6 {color: #0000bf}
+span.s7 {color: #0000bf}
span.s8 {font: 9.0px Monaco}
-span.s9 {color: #0018b8}
+span.s9 {color: #0000bf}
span.s10 {color: #0000bf}
-span.s11 {color: #6f7183}
+span.s11 {color: #0000bf}
span.s12 {color: #bf0000}
span.s13 {color: #007300}
span.s14 {color: #606060}
@@ -57,7 +52,7 @@
 
Some Important Issues Regarding SCCompositeView
 
-SCCompositeView is used for grouping widgets in a window. While it accept key actions, it does not accept mouse clicks or drags.
+SCCompositeView is used for grouping widgets in a window. While it accepts key actions, it does not accept mouse clicks or drags.
 
Creation / Class Methods
 
@@ -82,119 +77,119 @@
 
by default, the relativeOrigin flag of containers is set to true, and views are placed relative to the upper left corner of the container.
 
- (
- w = Window.new;
- 
- c = CompositeView(w,Rect(50,0,300,300));
- a = Slider2D(c,Rect(0,0,100,100)); // actually displays at (50, 0)
- b = Slider2D(c,Rect(100,100,100,100));
- 
- c.background = Color.rand;
- 
- w.front;
- )
- 
- c.bounds_(Rect(100,0,300,300)); // contents adust since coords are relative
- c.resize_(6); // contents adust since coords are relative
- 
+ (
+ w = Window.new;
+ 
+ c = CompositeView(w,Rect(50,0,300,300));
+ a = Slider2D(c,Rect(0,0,100,100)); // actually displays at (50, 0)
+ b = Slider2D(c,Rect(100,100,100,100));
+ 
+ c.background = Color.rand;
+ 
+ w.front;
+ )
+ 
+ c.bounds_(Rect(100,0,300,300)); // contents adust since coords are relative
+ c.resize_(6); // contents adust since coords are relative
+ 
You can also set relativeOrigin=false. Then coordinates are relative to (0, 0) in the window. See the discussion of the relativeOrigin flag, immediately following, if you want to position child views relative to the CompositeView's origin.
- 
- (
- w = Window.new;
- 
- c = CompositeView(w,Rect(50,0,300,300)).relativeOrigin_(false); 
- 
- a = Slider2D(c,Rect(50,0,100,100)); // you must specify the absolute coordinates here
- b = Slider2D(c,Rect(150,100,100,100));
- 
- c.background = Color.rand;
- 
- w.front;
- )
- 
- c.bounds_(Rect(100,0,300,300)); // contents will not adust since coords are absolute
- c.resize_(6); // contents will not adust since coords are absolute
- 
+ 
+ (
+ w = Window.new;
+ 
+ c = CompositeView(w,Rect(50,0,300,300)).relativeOrigin_(false); 
+ 
+ a = Slider2D(c,Rect(50,0,100,100)); // you must specify the absolute coordinates here
+ b = Slider2D(c,Rect(150,100,100,100));
+ 
+ c.background = Color.rand;
+ 
+ w.front;
+ )
+ 
+ c.bounds_(Rect(100,0,300,300)); // contents will not adust since coords are absolute
+ c.resize_(6); // contents will not adust since coords are absolute
 
+ 
Note: if you place a CompositeView with absolute coordinates (relativeOrigin = false) inside another CompositeView using relative coordinates (relativeOrigin = true), the child CompositeView's absolute coordinates override the relative position indicated by the parent. This is easily handled if you're specifying the coordinates yourself, but if you're using a decorator (see below), the child will display in the wrong place. When using a decorator on a relative origin CompositeView, you should not place absolute origin CompositeViews inside it.
 
Keydown Bubbling
 
Key actions "bubble up" to the parent view if a view does not define one itself. In the following example, a and b do not have keyDown actions themselves, so the key event is passed to c, the parent, which defines the key down action. d's parent is the SCTopView, which has no key down action. See also <a href="SCView.html">SCView</a>.
 
- ( //Click on the different views and hit keys on the keyboard.
- 
- w = Window.new;
- 
- c = CompositeView(w,Rect(0,0,200,200)).background_(Color.grey.alpha_(0.3));
- 
- a = Slider2D(c,Rect(0,0,100,100)).background_(Color.rand); 
- b = Slider2D(c,Rect(100,100,100,100)).background_(Color.rand);
- 
- w.front;
- 
- c.keyDownAction = {
- "keydown bubbled up to c".postln;
- };
- 
- //d is on window w, not on composite view c
- d = Slider2D(w,Rect(200,200,100,100));
- d.background = Color.black;
- )
+ ( //Click on the different views and hit keys on the keyboard.
+ 
+ w = Window.new;
 
+ c = CompositeView(w,Rect(0,0,200,200)).background_(Color.grey.alpha_(0.3));
+ 
+ a = Slider2D(c,Rect(0,0,100,100)).background_(Color.rand); 
+ b = Slider2D(c,Rect(100,100,100,100)).background_(Color.rand);
+ 
+ w.front;
+ 
+ c.keyDownAction = {
+ "keydown bubbled up to c".postln;
+ };
+ 
+ //d is on window w, not on composite view c
+ d = Slider2D(w,Rect(200,200,100,100));
+ d.background = Color.black;
+ )
+ 
 
Decorators
 
A 'decorator' object can be set to handle layout management. All views added to the CompositeView will now be placed by the decorator. Currently the only one existing is <a href="../GUI-Tools/FlowLayout.html">FlowLayout</a>. You can use the addFlowLayout method as a short cut to assigning FlowLayout to decorator.
 
- (
- a = Window.new;
- 
- b = CompositeView(a,Rect(0,0,500,500)).relativeOrigin_(false);
- b.decorator = FlowLayout(b.bounds);
- // b.addFlowLayout; // you can also write this for convenience
- 
- // adding views to b automatically use the decorator
- // no need to use parent.decorator.place
- c = Slider2D(b,Rect(0,0,100,100)); // size matters
- d = Slider2D(b,Rect(0,0,100,100)); // origin doesn't
- 
- a.front;
- )
- 
+ (
+ a = Window.new;
+ 
+ b = CompositeView(a,Rect(0,0,500,500)).relativeOrigin_(false);
+ b.decorator = FlowLayout(b.bounds);
+ // b.addFlowLayout; // you can also write this for convenience
+ 
+ // adding views to b automatically use the decorator
+ // no need to use parent.decorator.place
+ c = Slider2D(b,Rect(0,0,100,100)); // size matters
+ d = Slider2D(b,Rect(0,0,100,100)); // origin doesn't
+ 
+ a.front;
+ )
+ 
If you set the CompositeView's relativeOrigin to true, the bounds that you give to the <a href="../GUI-Tools/FlowLayout.html">FlowLayout</a> should originate at (0,0). In this case, be careful not to put absolute origin CompositeViews inside a relative origin CompositeView that has a decorator.
 
 (
- a = Window.new;
- 
- b = CompositeView(a,Rect(0,0,500,500)).relativeOrigin_(true);
- b.addFlowLayout;
- 
- c = Slider2D(b,Rect(0,0,100,100)); // size matters
- d = Slider2D(b,Rect(0,0,100,100)); // origin doesn't
- 
- a.front;
- )
+ a = Window.new;
+ 
+ b = CompositeView(a,Rect(0,0,500,500)).relativeOrigin_(true);
+ b.addFlowLayout;
+ 
+ c = Slider2D(b,Rect(0,0,100,100)); // size matters
+ d = Slider2D(b,Rect(0,0,100,100)); // origin doesn't
+ 
+ a.front;
+ )
 
You can also use an empty composite view nicely as a spacer in <a href="SCVLayoutView.html">VLayoutView</a>, <a href="SCHLayoutView.html">HLayoutView</a>, or views that have a <a href="../GUI-Tools/FlowLayout.html">FlowLayout</a> as their decorator.
 
 (
- a = Window.new;
- 
- b = CompositeView(a,Rect(0,0,500,500)).relativeOrigin_(true);
- b.decorator = FlowLayout(Rect(0, 0, 500, 500));
- Slider2D(b,Rect(0,0,100,100)).background_(Color.rand); 
- CompositeView(b,Rect(0,0,70,100)); //just used for spacing
- Slider2D(b,Rect(0,0,100,100)).background_(Color.rand);
- Slider2D(b,Rect(0,0,100,100)).background_(Color.rand);
- b.decorator.nextLine;
- Slider2D(b,Rect(0,0,100,100)).background_(Color.rand);
- Slider2D(b,Rect(0,0,100,100)).background_(Color.rand); 
- CompositeView(b,Rect(0,0,70,100)) ;//just used for spacing
- Slider2D(b,Rect(0,0,100,100)).background_(Color.rand);
- 
- a.front;
- )
+ a = Window.new;
+ 
+ b = CompositeView(a,Rect(0,0,500,500)).relativeOrigin_(true);
+ b.decorator = FlowLayout(Rect(0, 0, 500, 500));
+ Slider2D(b,Rect(0,0,100,100)).background_(Color.rand); 
+ CompositeView(b,Rect(0,0,70,100)); //just used for spacing
+ Slider2D(b,Rect(0,0,100,100)).background_(Color.rand);
+ Slider2D(b,Rect(0,0,100,100)).background_(Color.rand);
+ b.decorator.nextLine;
+ Slider2D(b,Rect(0,0,100,100)).background_(Color.rand);
+ Slider2D(b,Rect(0,0,100,100)).background_(Color.rand); 
+ CompositeView(b,Rect(0,0,70,100)) ;//just used for spacing
+ Slider2D(b,Rect(0,0,100,100)).background_(Color.rand);
+ 
+ a.front;
+ )
 
 
Hiding / Swapping
@@ -202,66 +197,66 @@
You can stack CompositeViews on top of each other and use a button show only one of them
 
 (
- var colors = [Color.blue,Color.red, Color.green];
- a = Window.new;
- q = 3;
- 
- b = Button(a,Rect(0,0,160,20));
- 
- b.states = Array.fill(q,{ arg i;
- [i.asString,Color.white,colors.wrapAt(i)]
- });
- 
- b.action = { arg butt;
- p.visible = false;
- p = c.at(butt.value);
- p.visible = true;
- };
- 
- c = Array.fill(q,{ arg i;
- b = CompositeView(a,Rect(0,25,300,300)).relativeOrigin_(true);
- b.background=colors[i].alpha_(0.2);
- b.visible=false;
- b;
- });
- 
- 5.do{arg i;c[0].add(Slider(c[0],Rect(10,i*30+10,150,25)).value_(1.0.rand))};
- 5.do{arg i;c[1].add(Slider(c[1],Rect(i*30+10,10,25,150)).value_(1.0.rand))};
- c[2].add(Slider2D(c[2],Rect(10,10,155,150)).x_(1.0.rand).y_(1.0.rand));
- 
- p = c.at(0); // previous
- p.visible = true; // show first one
- 
- a.front;
- 
- )
+ var colors = [Color.blue,Color.red, Color.green];
+ a = Window.new;
+ q = 3;
 
+ b = Button(a,Rect(0,0,160,20));
+ 
+ b.states = Array.fill(q,{ arg i;
+ [i.asString,Color.white,colors.wrapAt(i)]
+ });
+ 
+ b.action = { arg butt;
+ p.visible = false;
+ p = c.at(butt.value);
+ p.visible = true;
+ };
+ 
+ c = Array.fill(q,{ arg i;
+ b = CompositeView(a,Rect(0,25,300,300)).relativeOrigin_(true);
+ b.background=colors[i].alpha_(0.2);
+ b.visible=false;
+ b;
+ });
+ 
+ 5.do{arg i;c[0].add(Slider(c[0],Rect(10,i*30+10,150,25)).value_(1.0.rand))};
+ 5.do{arg i;c[1].add(Slider(c[1],Rect(i*30+10,10,25,150)).value_(1.0.rand))};
+ c[2].add(Slider2D(c[2],Rect(10,10,155,150)).x_(1.0.rand).y_(1.0.rand));
+ 
+ p = c.at(0); // previous
+ p.visible = true; // show first one
+ 
+ a.front;
+ 
+ )
+ 
Nested Example
 
In this example, the StaticText accepts mouse clicks, since container views can't:
- 
- (
- w=Window.new.front;
- 
- v=CompositeView.new(w,w.view.bounds.insetBy(10)).background_(Color.rand);
- v.decorator=FlowLayout(v.bounds);
- l="SUPERCOLLIDER".scramble;
- t=Array.fill(9,{arg i; var n,r,q;
- n=CompositeView.new(v,Rect(20,20,121,121)).background_(Color.rand);
- q=StaticText(n, n.bounds.moveTo(0,0).insetBy(25)).string_(l[i]).align_(\center);
- q.enabled=true;
-// q.font=Font("Geneva",10);
- q.font=Font( "Geneva", 10 );
- q.background_(Color.rand);
- q.mouseDownAction={
- n.background_(Color.rand);
- q.font=q.font.size_(5+q.font.size+7%60)
- };
- 
- 
- });
- )
- 
- 
+ 
+ (
+ w=Window.new.front;
+ 
+ v=CompositeView.new(w,w.view.bounds.insetBy(10)).background_(Color.rand);
+ v.decorator=FlowLayout(v.bounds);
+ l="SUPERCOLLIDER".scramble;
+ t=Array.fill(9,{arg i; var n,r,q;
+ n=CompositeView.new(v,Rect(20,20,121,121)).background_(Color.rand);
+ q=StaticText(n, n.bounds.moveTo(0,0).insetBy(25)).string_(l[i]).align_(\center);
+ q.enabled=true;
+// q.font=Font("Geneva",10);
+ q.font=Font( "Geneva", 10 );
+ q.background_(Color.rand);
+ q.mouseDownAction={
+ n.background_(Color.rand);
+ q.font=q.font.size_(5+q.font.size+7%60)
+ };
+ 
+ 
+ });
+ )
+ 
+ 
</body>
</html>

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

_______________________________________________
sc-dev mailing list

info (subscription, etc.): http://www.beast.bham.ac.uk/research/sc_mailing_lists.shtml
archive: http://www.listarc.bham.ac.uk/marchives/sc-dev/
search: http://www.listarc.bham.ac.uk/lists/sc-dev/search/