SF.net SVN: supercollider: [7521] trunk/build/Help/Libraries/crucial/ UncoupledUsefulThings/NotificationCenter.html

View: New views

1 Messages — Rating Filter: Alert me

SF.net SVN: supercollider: [7521] trunk/build/Help/Libraries/crucial/ UncoupledUsefulThings/NotificationCenter.html

by cruxxial :: Rate this Message:

Reply (Restricted by the Administrator) | Reply to Author | View Threaded | Show Only this Message

Revision: 7521
http://svn.sourceforge.net/supercollider/?rev=7521&view=rev
Author: cruxxial
Date: 2008-04-19 16:25:26 -0700 (Sat, 19 Apr 2008)

Log Message:
-----------
updated help

Modified Paths:
--------------
trunk/build/Help/Libraries/crucial/UncoupledUsefulThings/NotificationCenter.html

Modified: trunk/build/Help/Libraries/crucial/UncoupledUsefulThings/NotificationCenter.html
===================================================================
--- trunk/build/Help/Libraries/crucial/UncoupledUsefulThings/NotificationCenter.html 2008-04-19 23:00:43 UTC (rev 7520)
+++ trunk/build/Help/Libraries/crucial/UncoupledUsefulThings/NotificationCenter.html 2008-04-19 23:25:26 UTC (rev 7521)
@@ -5,116 +5,58 @@
<meta http-equiv="Content-Style-Type" content="text/css">
<title></title>
<meta name="Generator" content="Cocoa HTML Writer">
-<meta name="CocoaVersion" content="824.42">
+<meta name="CocoaVersion" content="824.47">
<style type="text/css">
p.p1 {margin: 0.0px 0.0px 0.0px 0.0px; font: 18.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}
-p.p4 {margin: 0.0px 0.0px 0.0px 0.0px; font: 9.0px Monaco}
-p.p5 {margin: 0.0px 0.0px 0.0px 0.0px; font: 9.0px Monaco; color: #0019b7}
+p.p4 {margin: 0.0px 0.0px 0.0px 0.0px; font: 9.0px Monaco; color: #001fb3}
+p.p5 {margin: 0.0px 0.0px 0.0px 0.0px; font: 9.0px Monaco}
p.p6 {margin: 0.0px 0.0px 0.0px 0.0px; font: 9.0px Monaco; min-height: 12.0px}
-p.p7 {margin: 0.0px 0.0px 0.0px 0.0px; font: 12.0px Helvetica; color: #a71e12}
-p.p8 {margin: 0.0px 0.0px 0.0px 0.0px; font: 12.0px Helvetica; color: #0019b7}
-p.p9 {margin: 0.0px 0.0px 0.0px 0.0px; font: 9.0px Monaco; color: #a71e12}
-p.p10 {margin: 0.0px 0.0px 0.0px 0.0px; font: 9.0px Monaco; color: #316c17}
-p.p11 {margin: 0.0px 0.0px 0.0px 0.0px; font: 9.0px Monaco; color: #606060}
-span.s1 {color: #0019b7}
-span.s2 {color: #316c17}
-span.s3 {color: #000000}
-span.s4 {color: #606060}
+p.p7 {margin: 0.0px 0.0px 0.0px 0.0px; font: 12.0px Helvetica; color: #000000; min-height: 14.0px}
+p.p8 {margin: 0.0px 0.0px 0.0px 0.0px; font: 12.0px Helvetica; color: #000000}
+span.s1 {color: #000000}
+span.s2 {color: #42691d}
span.Apple-tab-span {white-space:pre}
</style>
</head>
<body>
NotificationCenter
 
+One common OOP pattern is Model-View-Controller where one object (the controller) is a dependant of the model. Every time the model changes it notifies all of its dependants. In this case the model has a dictionary of dependants and iterates through those.
 
-Objects can send notifications to the NotificationCenter, and all functions that were registered for
-that notification will be excecuted.
+Another common pattern is NotificationCenter wherein an object emits a notification and clients can register functions that will be executed when that notification happens.
 
-implements the Notification pattern.
-This is similar to MVC, except here the model object does not ever
-know anything about who is dependant on it.
-This allows any interested client object to be notified of special events such as the object being
-saved to disk, the object recording a sound file version of itself etc.
+A Server emits a \newAllocators notification when it creates new node and bus allocators which it does when it quits or boots.
 
-For instance when a Sample is saved it emits a \didSave notification:
- NotificationCenter(notify,Sample,\didSave,soundFilePath);
+ NotificationCenter.notify(Server.default,\newAllocators);
 
You can listen for this:
- NotificationCenter.register(Sample,\didSave,\sampleWatcher, { arg path;
- path.postln; 
- });
- 
 
-//in the following examples this is the interpreter
-this.postln 
-an Interpreter
+ NotificationCenter.register(Server.default,\newAllocators,yourself, {
+ // throw away all your node variables
+ // or stop the music
+ });
 
- 
-(
-// nothing is yet registered
-// so notify finds nothing to do
-NotificationCenter.notify(this,\didRecord);
+The Buffer class register a function to clear its info cache whenever a server restarts. The server is emiting changed messages quite often (every 0.4 secs for the status updates), and the Buffer class is only interested in boot/quit events, so this is a more lightweight system for this purpose.
 
-// register a function
-NotificationCenter.register(this,\didRecord,\theRequestingObject, { "hello".postln; });
+ 
+*notify(object,message,args)
+ The object emits a message and may also pass extra args
+ 
+*register(object,message,listener,action)
+ An interested client can register the action function for the object/message notification.
+ A listener may only register one action per object/message notification.
+ 
+*unregister(object,message,listener)
+ Remove the registrations
+ 
+*registerOneShot(object,message,listener,action)
+ After the notification has been emited and handled, automatically unregister.
+ 
+*registrationExists(object,message,listener)
+ Simply confirms if a registration is already in place
 
-// now it has something to do
-NotificationCenter.notify(this,\didRecord);
-hello
- 
-// unregister, thus releasing yourself for GC
-NotificationCenter.unregister(this,\didRecord,\theRequestingObject)
- 
-// theRequestingObject is no longer interested in this notification
-NotificationCenter.notify(this,\didRecord);
- 
- 
-)
- 
- 
-The listener argument is somewhat unimportant as far as you the client is concerned. 
-It is used to identify the notification and to find it later to remove it when needed.
- 
-There can only be one notification per listener, but you may use anything for the listener object, such
-as an arbitrary symbol.
- 
-(// two symbols
-NotificationCenter.register(this,\didRecord,\thingOne, { "this will get overwritten by the next registration".postln; });
-NotificationCenter.register(this,\didRecord,\thingOne, { "do this".postln; });
-NotificationCenter.register(this,\didRecord,\thingTwo, { "do this also".postln; });
- 
-NotificationCenter.notify(this,\didRecord);
- 
-do this
-do this also
-)
- 
- 
-(
-NotificationCenter.register(this,\didRecord,this, { arg path,comments; path.postln; comments.postln; });
- 
-// after the addressing, an array of arguments can be supplied to be passed into the function
-NotificationCenter.notify(this,\didRecord,[":SoundFiles:blurb.aiff",'yo mama']);
-:SoundFiles:blurb.aiff
-yo mama
- 
-)
- 
- 
-You can also remove the Notification registration by getting the layout to remove you
-when the window closes:
- 
-guiBody { arg layout;
- layout.removeOnClose(
- NotificationCenter.register(model,\didRecord,this, {
- // do things
- });
- );
-}
- 
- 
- 
+ 
</body>
</html>

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.
_______________________________________________
sc-dev mailing list
sc-dev@...
http://lists.create.ucsb.edu/mailman/listinfo/sc-dev

LightInTheBox - Buy quality products at wholesale price