SF.net SVN: supercollider: [7685] trunk/build

View: New views

1 Messages — Rating Filter: Alert me

SF.net SVN: supercollider: [7685] trunk/build

by mullmusik :: Rate this Message:

Reply to Author | View Threaded | Show Only this Message

Revision: 7685
http://supercollider.svn.sourceforge.net/supercollider/?rev=7685&view=rev
Author: mullmusik
Date: 2008-07-14 03:28:35 -0700 (Mon, 14 Jul 2008)

Log Message:
-----------
Deprecated rendezvous in favour of zeroConf, removed blockAllocClass option, new spiffy help file

Modified Paths:
--------------
trunk/build/Help/ServerArchitecture/ServerOptions.html
trunk/build/SCClassLibrary/Common/Control/Server.sc

Modified: trunk/build/Help/ServerArchitecture/ServerOptions.html
===================================================================
--- trunk/build/Help/ServerArchitecture/ServerOptions.html 2008-07-13 20:04:38 UTC (rev 7684)
+++ trunk/build/Help/ServerArchitecture/ServerOptions.html 2008-07-14 10:28:35 UTC (rev 7685)
@@ -5,149 +5,214 @@
<meta http-equiv="Content-Style-Type" content="text/css">
<title></title>
<meta name="Generator" content="Cocoa HTML Writer">
-<meta name="CocoaVersion" content="824.44">
+<meta name="CocoaVersion" content="949.33">
<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: 15.0px Helvetica}
-p.p4 {margin: 0.0px 0.0px 0.0px 0.0px; font: 15.0px Helvetica; min-height: 18.0px}
-p.p5 {margin: 0.0px 0.0px 0.0px 0.0px; font: 9.0px Monaco; color: #6f3420}
-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: 9.0px Monaco}
-p.p8 {margin: 0.0px 0.0px 0.0px 0.0px; font: 9.0px Monaco; color: #9a1d19}
-p.p9 {margin: 0.0px 0.0px 0.0px 0.0px; font: 10.0px Monaco; color: #9a1d19}
-p.p10 {margin: 0.0px 0.0px 0.0px 0.0px; font: 10.0px Monaco; min-height: 14.0px}
-p.p11 {margin: 0.0px 0.0px 0.0px 0.0px; font: 9.0px Monaco; color: #173dac}
+p.p3 {margin: 0.0px 0.0px 0.0px 0.0px; font: 9.0px Monaco; min-height: 12.0px}
+p.p4 {margin: 0.0px 0.0px 0.0px 0.0px; font: 12.0px Helvetica; color: #0000ff}
+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}
+p.p7 {margin: 0.0px 0.0px 0.0px 57.0px; text-indent: -57.0px; font: 12.0px Helvetica}
+p.p8 {margin: 0.0px 0.0px 0.0px 57.0px; text-indent: -57.0px; font: 12.0px Helvetica; min-height: 14.0px}
+p.p9 {margin: 0.0px 0.0px 0.0px 57.0px; text-indent: -57.0px; font: 14.0px Helvetica}
+p.p10 {margin: 0.0px 0.0px 0.0px 85.0px; text-indent: -85.0px; font: 12.0px Helvetica}
+p.p11 {margin: 0.0px 0.0px 0.0px 0.0px; font: 9.0px Monaco; color: #bf0000}
+p.p12 {margin: 0.0px 0.0px 0.0px 0.0px; font: 9.0px Monaco; color: #000000; min-height: 12.0px}
+p.p13 {margin: 0.0px 0.0px 0.0px 0.0px; font: 9.0px Monaco; color: #000000}
+p.p14 {margin: 0.0px 0.0px 0.0px 0.0px; font: 9.0px Monaco; color: #0000bf}
span.s1 {font: 18.0px Helvetica}
-span.s2 {text-decoration: underline}
-span.s3 {font: 9.0px Monaco; color: #596425}
-span.s4 {font: 9.0px Monaco; color: #173dac}
-span.s5 {color: #144beb}
-span.s6 {color: #173dac}
-span.s7 {color: #000000}
-span.s8 {color: #606060}
-span.s9 {color: #0021b7}
-span.s10 {color: #596425}
+span.s2 {color: #0000ff}
+span.s3 {color: #000000}
+span.s4 {font: 9.0px Monaco}
+span.s5 {color: #0000bf}
+span.s6 {color: #606060}
+span.s7 {color: #007300}
span.Apple-tab-span {white-space:pre}
</style>
</head>
<body>
-ServerOptions encapsulates the commandline options for a Server
+ServerOptions encapsulates commandline and other options for a Server
 
-ServerOptions encapsulates the commandline options for a server app within an object. This makes it convienent to launch multiple servers with the same options, or to archive different sets of options, etc. Every Server has an instance of ServerOptions created for it if one is not passed as the options argument when the Server object is created. (This is the case for example with the local and internal Servers which are created at startup.)
+Inherits from: <a href="../Core/Object.html">Object</a>
+ 
+ServerOptions encapsulates various options for a server app within an object. This makes it convenient to launch multiple servers with the same options, or to archive different sets of options, etc. Every <a href="Server.html">Server</a> has an instance of ServerOptions created for it if one is not passed as the options argument when the Server object is created. (This is the case for example with the local and internal Servers which are created at startup.)
 
A Server's instance of ServerOptions is stored in its options instance variable, which can be accessed through corresponding getter and setter methods.
 
-Note: A ServerOptions' instance variables are translated into commandline arguments when a server app is booted. Thus a running Server must be rebooted before changes will take effect. There are also a few commandline options which are not currently encapsulated in ServerOptions. See Server-Architecture for more details.
+N.B. A ServerOptions' instance variables are translated into commandline arguments when a server app is booted. Thus a running Server must be rebooted before changes will take effect. There are also a few commandline options which are not currently encapsulated in ServerOptions. See <a href="Server-Architecture.html">Server-Architecture</a> for more details.
 
-Class Methods
+See also: <a href="Server.html">Server</a>, <a href="Server-Architecture.html">Server-Architecture</a>, and <a href="Server-Command-Reference.html">Server-Command-Reference</a>.
 
-*new
- 
-Create and return a new instance of ServerOptions.
- 
-Instance Variables (The Options)
- 
-The following instance variables can be changed through getter and setter methods. Note that the defaults listed below only apply to newly created instances of ServerOptions. The options for the local and internal Servers may have been changed at startup in Main-startup or in ~/scwork/startup.rtf.
- 
-numAudioBusChannels - The number of internal audio rate busses. The default is 128.
- 
-numControlBusChannels - The number of internal control rate busses. The default is 4096.
- 
- 
-The following two options need not correspond to the available number of hardware inputs and outputs.
- 
-numInputBusChannels - The number of audio input bus channels. The default is 8.
- 
-numOutputBusChannels - The number of audio output bus channels. The default is 8.
- 
- 
-numBuffers - The number of global sample buffers available. (See Buffer.) The default is 1024.
- 
-maxNodes - The maximum number of Nodes. The default is 1024.
- 
-maxSynthDefs - The maximum number of SynthDefs. The default is 1024.
- 
-protocol - A symbol representing the communications protocol. Either \udp or \tcp. The default is udp.
- 
-blockSize - The number of samples in one control period. The default is 64.
- 
-hardwareBufferSize - The preferred hardware buffer size. If non-nil the server app will attempt to set the hardware buffer frame size. Not all sizes are valid. See the documentation of your audio hardware for details.
- 
-memSize - The number of kilobytes of real time memory allocated to the server. This memory is used to allocate synths and any memory that unit generators themselves allocate (for instance in the case of delay ugens which do not use buffers, such as CombN), and is separate from the memory used for buffers. Setting this too low is a common cause of 'exception in real time: alloc failed' errors. The default is 8192.
- 
-numRGens - The number of seedable random number generators. The default is 64.
- 
-numWireBufs - The maximum number of buffers that are allocated to interconnect unit generators. (Not to be confused with the global sample buffers represented by Buffer.) This sets the limit of complexity of SynthDefs that can be loaded at runtime. This value will be automatically increased if a more complex def is loaded at startup, but it cannot be increased thereafter without rebooting. The default is 64.
- 
-sampleRate - The preferred sample rate. If non-nil the server app will attempt to set the sample rate of the hardware. The hardware has to support the sample rate that you choose.
- 
-loadDefs - A Boolean indicating whether or not to load the synth definitions in synthdefs/ (or anywhere set in the environment variable SC_SYNTHDEF_PATH) at startup. The default is true.
- 
-inputStreamsEnabled - A String which allows turning off input streams that you are not interested in on the audio device. If the string is "01100", for example, then only the second and third input streams on the device will be enabled. Turning off streams can reduce CPU load.
- 
-outputStreamsEnabled - A String which allows turning off output streams that you are not interested in on the audio device. If the string is "11000", for example, then only the first two output streams on the device will be enabled. Turning off streams can reduce CPU load.
- 
-device - A String that allows you to chose a sound device. The default, nil will use the system's default device (more below in the examples).
- 
-blockAllocClass - Specifies the class the server will use to allocate index numbers for buffers and audio and control buses. Should be given as a class name, not a symbol. Currently implemented choices are: 
- 
-PowerOfTwoAllocator: The original allocator. Intended for allocating these resources very quickly for relatively stable configurations. Not ideal for situations where buses or buffers will be allocated and deallocated frequently. 
- 
-ContiguousBlockAllocator: Designed for allocations that need to change frequently. Sacrifices a small amount of speed for reliability. See the <a href="../Control/ContiguousBlockAllocator.html">ContiguousBlockAllocator</a> helpfile.
- 
- 
-initialNodeID - By default, the Server object in the client begins allocating node IDs at 1000, reserving 0-999 for "permanent" nodes. You may change this default here.
- 
-rendezvous - Whether or not the server should publish its port to Rendezvous, to facilitate network interaction. This is true by default; if you find unacceptable delays (beachballing) upon server boot, you can try setting this to false.
- 
-verbosity - sets what kind of messages are posted from the server.
- 0 is normal behaviour
- -1 suppresses informational messages
- -2 suppresses informational and many error messages
- 
- 
-Instance Methods
- 
-firstPrivateBus - Returns the index of the first audio bus on this server which is not used by the input and output hardware.
- 
-asOptionsString - Returns a String specifying the options in the format required by the command-line scsynth app.
- 
- 
-For further information see Server, Server-Architecture, and Server-Command-Reference.
- 
-Examples
- 
-// Get the local server's options
+Creation / Class Methods
 
-o = Server.local.options;
+ *new
+ 
+ Create and return a new instance of ServerOptions.
+ 
 
-// Post the number of output channels
+Accessing Instance and Class Variables (The Options)
+ 
+ blockSize_(arg1)
+ blockSize
+ 
+ The number of samples in one control period. The default is 64.
+ 
+ device_(arg1)
+ device
+ 
+ A String that allows you to chose a sound device. The default, nil will use the system's default device (more below in the examples).
+ 
+ hardwareBufferSize_(arg1)
+ hardwareBufferSize
+ 
+ The preferred hardware buffer size. If non-nil the server app will attempt to set the hardware buffer frame size. Not all sizes are valid. See the documentation of your audio hardware for details.
+ Default value is nil.
+ 
+ initialNodeID_(arg1)
+ initialNodeID
+ 
+ By default, the Server object in the client begins allocating node IDs at 1000, reserving 0-999 for "permanent" nodes. You may change this default here.
+ 
+ inputStreamsEnabled_(arg1)
+ inputStreamsEnabled
+ 
+ A <a href="../Collections/String.html">String</a> which allows turning off input streams that you are not interested in on the audio device. If the string is "01100", for example, then only the second and third input streams on the device will be enabled. Turning off streams can reduce CPU load. The default value is nil.
+ 
+ loadDefs_(arg1)
+ loadDefs
+ 
+ A <a href="../Core/Boolean.html">Boolean</a> indicating whether or not to load the synth definitions in synthdefs/ (or anywhere set in the environment variable SC_SYNTHDEF_PATH) at startup. The default is true.
+ 
+ maxNodes_(arg1)
+ maxNodes
+ 
+ The maximum number of nodes. The default is 1024.
+ 
+ maxSynthDefs_(arg1)
+ maxSynthDefs
+ 
+ The maximum number of synthdefs. The default is 1024.
+ 
+ memSize_(arg1)
+ memSize
+ 
+ The number of kilobytes of real time memory allocated to the server. This memory is used to allocate synths and any memory that unit generators themselves allocate (for instance in the case of delay ugens which do not use buffers, such as <a href="../UGens/Delays/CombN.html">CombN</a>), and is separate from the memory used for buffers. Setting this too low is a common cause of 'exception in real time: alloc failed' errors. The default is 8192.
+ 
+ numAudioBusChannels_(arg1)
+ numAudioBusChannels
+ 
+ The number of internal audio rate busses. The default is 128.
+ 
+ numBuffers_ (argNumBuffers)
+ numBuffers
+ 
+ The number of global sample buffers available. (See <a href="Buffer.html">Buffer</a>.) The default is 1024.
+ 
+ numControlBusChannels_(arg1)
+ numControlBusChannels
+ 
+ The number of internal control rate busses. The default is 4096.
+ 
+ numInputBusChannels_(arg1)
+ numInputBusChannels
+ 
+ The number of audio input bus channels. This need not correspond to the number of hardware inputs. The default is 8.
+ 
+ numOutputBusChannels_(arg1)
+ numOutputBusChannels
+ 
+ The number of audio output bus channels. This need not correspond to the number of hardware outputs (this can be useful for instance in the case of recording). The default is 8.
+ 
+ numRGens_(arg1)
+ numRGens
+ 
+ The number of seedable random number generators. The default is 64.
+ 
+ numWireBufs_(arg1)
+ numWireBufs
+ 
+ The maximum number of buffers that are allocated to interconnect unit generators. (Not to be confused with the global sample buffers represented by Buffer.) This sets the limit of complexity of SynthDefs that can be loaded at runtime. This value will be automatically increased if a more complex def is loaded at startup, but it cannot be increased thereafter without rebooting. The default is 64.
+ 
+ outputStreamsEnabled_(arg1)
+ outputStreamsEnabled
+ 
+ A <a href="../Collections/String.html">String</a> which allows turning off output streams that you are not interested in on the audio device. If the string is "11000", for example, then only the first two output streams on the device will be enabled. Turning off streams can reduce CPU load.
+ 
+ protocol_(arg1)
+ protocol
+ 
+ A <a href="../Core/Symbol.html">Symbol</a> representing the communications protocol. Either \udp or \tcp. The default is udp.
+ 
+ remoteControlVolume_(arg1)
+ remoteControlVolume
+ 
+ A <a href="../Core/Boolean.html">Boolean</a> indicating whether this server should allow its volume to be set remotely. The default value is false.
+ 
+ sampleRate_(arg1)
+ sampleRate
+ 
+ The preferred sample rate. If non-nil the server app will attempt to set the sample rate of the hardware. The hardware has to support the sample rate that you choose.
+ 
+ verbosity_(arg1)
+ verbosity
+ 
+ Controls the verbosity of server messages. A value of 0 is normal behaviour, -1 suppresses informational messages, and -2 suppresses informational and many error messages. The default is 0.
+ 
+ zeroConf_(arg1)
+ zeroConf
+ 
+ A <a href="../Core/Boolean.html">Boolean</a> indication whether or not the server should publish its port using zero configuration networking, to facilitate network interaction. This is true by default; if you find unacceptable delays (beachballing) upon server boot, you can try setting this to false.
+ 
+ 
+Instance Methods
+ 
+ 
+ asOptionsString (port)
+ 
+ Returns a <a href="../Collections/String.html">String</a> specifying the options in the format required by the command-line scsynth app.
+ port - The port number for the resulting server app. Default value is 57110.
+ 
+ firstPrivateBus
+ 
+ Returns the index of the first audio bus on this server which is not used by the input and output hardware.
 
-o.numOutputBusChannels.postln;
 
-// Set them to a new number
 
-o.numOutputBusChannels = 6; // The next time it boots, this will take effect
 
-// specify a device
- 
-o.options.device ="MOTU Traveler"; // use a specific soundcard
-o.options.device = nil; // use the system default soundcard
- 
-// Create a new instance of ServerOptions
- 
-o = ServerOptions.new;
- 
-// Set the memory size to twice the default
- 
-o.memSize = 4096;
- 
-// Create a new Server on the local machine using o for its options
- 
-t = Server(\Local2, NetAddr("127.0.0.1", 57111), o);
-t.makeWindow;
-t.boot;
-t.quit;
+Examples
+ 
+// Get the local server's options
+ 
+o = Server.local.options;
+ 
+// Post the number of output channels
+ 
+o.numOutputBusChannels.postln;
+ 
+// Set them to a new number
+ 
+o.numOutputBusChannels = 6; // The next time it boots, this will take effect
+ 
+// specify a device
+ 
+o.device ="MOTU Traveler"; // use a specific soundcard
+o.device = nil; // use the system default soundcard
+ 
+// Create a new instance of ServerOptions
+ 
+o = ServerOptions.new;
+ 
+// Set the memory size to twice the default
+ 
+o.memSize = 4096;
+ 
+// Create a new Server on the local machine using o for its options
+ 
+t = Server(\Local2, NetAddr("127.0.0.1", 57111), o);
+t.makeWindow;
+t.boot;
+t.quit;
+ 
</body>
</html>

Modified: trunk/build/SCClassLibrary/Common/Control/Server.sc
===================================================================
--- trunk/build/SCClassLibrary/Common/Control/Server.sc 2008-07-13 20:04:38 UTC (rev 7684)
+++ trunk/build/SCClassLibrary/Common/Control/Server.sc 2008-07-14 10:28:35 UTC (rev 7685)
@@ -1,7 +1,6 @@

ServerOptions
{
- classvar <>default;

var <>numAudioBusChannels=128;
var <>numControlBusChannels=4096;
@@ -30,23 +29,10 @@
var <>blockAllocClass;

var <>verbosity = 0;
- var <>rendezvous = true; // Whether server publishes port to Rendezvous
+ var <>zeroConf = false; // Whether server publishes port to Bonjour, etc.

var <>initialNodeID = 1000;
var <>remoteControlVolume = false;
-
- *initClass {
- default = this.new.blockAllocClass_(ContiguousBlockAllocator);
- //default = this.new.blockAllocClass_(PowerOfTwoAllocator);
- }
-
- *new {
- default.notNil.if({
- ^default.copy
- }, {
- ^super.new
- });
- }

// max logins
// session-password
@@ -115,7 +101,7 @@
if (verbosity != 0, {
o = o ++ " -v " ++ verbosity;
});
- if (rendezvous.not, {
+ if (zeroConf.not, {
o = o ++ " -R 0";
});
^o
@@ -129,6 +115,16 @@
_BootInProcessServer
^this.primitiveFailed
}
+
+ rendezvous_ {|bool|
+ zeroConf = bool;
+ this.deprecated(thisMethod, ServerOptions.findMethod(\zeroConf_))
+ }
+
+ rendezvous {|bool|
+ this.deprecated(thisMethod, ServerOptions.findMethod(\zeroConf));
+ ^zeroConf;
+ }
}

Server : Model {
@@ -184,10 +180,10 @@
}
newAllocators {
nodeAllocator = NodeIDAllocator(clientID, options.initialNodeID);
- controlBusAllocator = options.blockAllocClass.new(options.numControlBusChannels);
- audioBusAllocator = options.blockAllocClass.new(options.numAudioBusChannels,
+ controlBusAllocator = ContiguousBlockAllocator.new(options.numControlBusChannels);
+ audioBusAllocator = ContiguousBlockAllocator.new(options.numAudioBusChannels,
options.firstPrivateBus);
- bufferAllocator = options.blockAllocClass.new(options.numBuffers);
+ bufferAllocator = ContiguousBlockAllocator.new(options.numBuffers);
NotificationCenter.notify(this,\newAllocators);
}
nextNodeID {

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

_______________________________________________
sc-dev mailing list

info (subscribe and unsubscribe): http://swiki.hfbk-hamburg.de:8888/MusicTechnology/880
archive: http://www.listarc.bham.ac.uk/marchives/sc-dev/
search: http://www.listarc.bham.ac.uk/lists/sc-dev/search/