Help/ServerArchitecture/ServerOptions.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
   2 <html>
   3 <head>
   4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
   5 <meta http-equiv="Content-Style-Type" content="text/css">
   6 <title></title>
   7 <meta name="Generator" content="Cocoa HTML Writer">
   8 <meta name="CocoaVersion" content="949.46">
   9 <style type="text/css">
  10 p.p1 {margin: 0.0px 0.0px 0.0px 0.0px; font: 12.0px Helvetica}
  11 p.p2 {margin: 0.0px 0.0px 0.0px 0.0px; font: 12.0px Helvetica; min-height: 14.0px}
  12 p.p3 {margin: 0.0px 0.0px 0.0px 0.0px; font: 9.0px Monaco; min-height: 12.0px}
  13 p.p4 {margin: 0.0px 0.0px 0.0px 0.0px; font: 12.0px Helvetica; color: #001bec}
  14 p.p5 {margin: 0.0px 0.0px 0.0px 0.0px; font: 14.0px Helvetica}
  15 p.p6 {margin: 0.0px 0.0px 0.0px 57.0px; text-indent: -57.0px; font: 9.0px Monaco; min-height: 12.0px}
  16 p.p7 {margin: 0.0px 0.0px 0.0px 57.0px; text-indent: -57.0px; font: 12.0px Helvetica}
  17 p.p8 {margin: 0.0px 0.0px 0.0px 57.0px; text-indent: -57.0px; font: 12.0px Helvetica; min-height: 14.0px}
  18 p.p9 {margin: 0.0px 0.0px 0.0px 57.0px; text-indent: -57.0px; font: 14.0px Helvetica}
  19 p.p10 {margin: 0.0px 0.0px 0.0px 85.0px; text-indent: -85.0px; font: 12.0px Helvetica}
  20 p.p11 {margin: 0.0px 0.0px 0.0px 0.0px; font: 9.0px Monaco; color: #8b3221}
  21 p.p12 {margin: 0.0px 0.0px 0.0px 0.0px; font: 9.0px Monaco}
  22 p.p13 {margin: 0.0px 0.0px 0.0px 0.0px; font: 9.0px Monaco; color: #0036b2}
  23 span.s1 {font: 18.0px Helvetica}
  24 span.s2 {color: #0049ef}
  25 span.s3 {color: #000000}
  26 span.s4 {text-decoration: underline}
  27 span.s5 {color: #0024fc}
  28 span.s6 {font: 9.0px Monaco}
  29 span.s7 {color: #0036b2}
  30 span.s8 {color: #606060}
  31 span.s9 {color: #4c661c}
  32 span.Apple-tab-span {white-space:pre}
  33 </style>
  34 </head>
  35 <body>
  36 <p class="p1"><span class="s1"><b>ServerOptions<span class="Apple-tab-span">    </span><span class="Apple-tab-span">    </span><span class="Apple-tab-span">    </span></b></span><b>encapsulates commandline and other options for a Server</b></p>
  37 <p class="p2"><br></p>
  38 <p class="p1"><b>Inherits from: </b><a href="../Core/Object.html"><span class="s2"><b>Object</b></span></a></p>
  39 <p class="p3"><br></p>
  40 <p class="p1">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"><span class="s2">Server</span></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.)</p>
  41 <p class="p2"><br></p>
  42 <p class="p1">A Server's instance of ServerOptions is stored in its <b>options</b> instance variable, which can be accessed through corresponding getter and setter methods.</p>
  43 <p class="p2"><br></p>
  44 <p class="p1"><b>N.B.</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"><span class="s2">Server-Architecture</span></a> for more details.</p>
  45 <p class="p2"><br></p>
  46 <p class="p4"><span class="s3"><b>See also:</b> <a href="Server.html"><span class="s4">Server</span></a>, <a href="Server-Architecture.html"><span class="s4">Server-Architecture</span></a>, and <a href="Server-Command-Reference.html"><span class="s4">Server-Command-Reference</span></a>.</span></p>
  47 <p class="p2"><br></p>
  48 <p class="p5"><b>Creation / Class Methods</b></p>
  49 <p class="p6"><br></p>
  50 <p class="p7"><b><span class="Apple-tab-span">  </span>*new</b></p>
  51 <p class="p8"><b><span class="Apple-tab-span">  </span></b></p>
  52 <p class="p7"><b><span class="Apple-tab-span">  </span><span class="Apple-tab-span">    </span></b>Create and return a new instance of ServerOptions.</p>
  53 <p class="p6"><span class="Apple-tab-span">     </span><span class="Apple-tab-span">    </span></p>
  54 <p class="p7"><b><span class="Apple-tab-span">  </span>*devices</b></p>
  55 <p class="p8"><b><span class="Apple-tab-span">  </span></b></p>
  56 <p class="p7"><b><span class="Apple-tab-span">  </span><span class="Apple-tab-span">    </span></b>Return an <a href="../Collections/Array.html"><span class="s5">Array</span></a> of <a href="../Collections/String.html"><span class="s5">Strings</span></a> listing the audio devices currently available on the system.</p>
  57 <p class="p6"><span class="Apple-tab-span">     </span><span class="Apple-tab-span">    </span></p>
  58 <p class="p7"><b><span class="Apple-tab-span">  </span>*inDevices</b></p>
  59 <p class="p8"><b><span class="Apple-tab-span">  </span></b></p>
  60 <p class="p7"><b><span class="Apple-tab-span">  </span><span class="Apple-tab-span">    </span></b>Return an <a href="../Collections/Array.html"><span class="s5">Array</span></a> of <a href="../Collections/String.html"><span class="s5">Strings</span></a> listing the audio devices currently available on the system which have input channels.</p>
  61 <p class="p6"><span class="Apple-tab-span">     </span><span class="Apple-tab-span">    </span></p>
  62 <p class="p7"><b><span class="Apple-tab-span">  </span>*outDevices</b></p>
  63 <p class="p8"><b><span class="Apple-tab-span">  </span></b></p>
  64 <p class="p7"><b><span class="Apple-tab-span">  </span><span class="Apple-tab-span">    </span></b>Return an <a href="../Collections/Array.html"><span class="s5">Array</span></a> of <a href="../Collections/String.html"><span class="s5">Strings</span></a> listing the audio devices currently available on the system which have output channels.</p>
  65 <p class="p6"><span class="Apple-tab-span">     </span><span class="Apple-tab-span">    </span></p>
  66 <p class="p6"><br></p>
  67 <p class="p9"><b>Accessing Instance and Class Variables (The Options)</b></p>
  68 <p class="p8"><span class="Apple-tab-span">     </span><span class="Apple-tab-span">    </span><span class="Apple-tab-span">    </span><span class="Apple-tab-span">    </span></p>
  69 <p class="p7"><b><span class="Apple-tab-span">  </span>blockSize_(arg1)</b></p>
  70 <p class="p7"><b><span class="Apple-tab-span">  </span>blockSize</b></p>
  71 <p class="p8"><b><span class="Apple-tab-span">  </span></b><span class="Apple-tab-span">        </span></p>
  72 <p class="p7"><span class="Apple-tab-span">     </span><span class="Apple-tab-span">    </span>The number of samples in one control period. The default is 64.</p>
  73 <p class="p8"><span class="Apple-tab-span">     </span><span class="Apple-tab-span">    </span></p>
  74 <p class="p7"><b><span class="Apple-tab-span">  </span>device_(arg1)</b></p>
  75 <p class="p7"><b><span class="Apple-tab-span">  </span>device</b></p>
  76 <p class="p8"><b><span class="Apple-tab-span">  </span></b><span class="Apple-tab-span">        </span></p>
  77 <p class="p7"><span class="Apple-tab-span">     </span><span class="Apple-tab-span">    </span>A String that allows you to choose a sound device to use as input and output. The default, nil will use the system's default input and output device(s) (more below in the examples).<span class="Apple-converted-space"> </span></p>
  78 <p class="p8"><br></p>
  79 <p class="p7"><b><span class="Apple-tab-span">  </span>inDevice_(arg1)</b></p>
  80 <p class="p7"><b><span class="Apple-tab-span">  </span>inDevice</b></p>
  81 <p class="p8"><b><span class="Apple-tab-span">  </span></b><span class="Apple-tab-span">        </span></p>
  82 <p class="p7"><span class="Apple-tab-span">     </span><span class="Apple-tab-span">    </span>A String that allows you to choose an input sound device. The default, nil will use the system's default input device (more below in the examples).</p>
  83 <p class="p8"><br></p>
  84 <p class="p7"><b><span class="Apple-tab-span">  </span>outDevice_(arg1)</b></p>
  85 <p class="p7"><b><span class="Apple-tab-span">  </span>outDevice</b></p>
  86 <p class="p8"><b><span class="Apple-tab-span">  </span></b><span class="Apple-tab-span">        </span></p>
  87 <p class="p7"><span class="Apple-tab-span">     </span><span class="Apple-tab-span">    </span>A String that allows you to choose an output sound device. The default, nil will use the system's default output device (more below in the examples).</p>
  88 <p class="p8"><span class="Apple-tab-span">     </span></p>
  89 <p class="p7"><span class="Apple-tab-span">     </span><b>hardwareBufferSize_(arg1)</b></p>
  90 <p class="p7"><b><span class="Apple-tab-span">  </span>hardwareBufferSize</b></p>
  91 <p class="p8"><b><span class="Apple-tab-span">  </span></b><span class="Apple-tab-span">        </span></p>
  92 <p class="p7"><span class="Apple-tab-span">     </span><span class="Apple-tab-span">    </span>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.</p>
  93 <p class="p7"><span class="Apple-tab-span">     </span><span class="Apple-tab-span">    </span>Default value is nil.</p>
  94 <p class="p8"><span class="Apple-tab-span">     </span><span class="Apple-tab-span">    </span><span class="Apple-tab-span">    </span><span class="Apple-tab-span">    </span></p>
  95 <p class="p7"><b><span class="Apple-tab-span">  </span>initialNodeID_(arg1)</b></p>
  96 <p class="p7"><b><span class="Apple-tab-span">  </span>initialNodeID</b></p>
  97 <p class="p8"><b><span class="Apple-tab-span">  </span></b><span class="Apple-tab-span">        </span></p>
  98 <p class="p7"><span class="Apple-tab-span">     </span><span class="Apple-tab-span">    </span>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.</p>
  99 <p class="p8"><span class="Apple-tab-span">     </span><span class="Apple-tab-span">    </span></p>
 100 <p class="p7"><b><span class="Apple-tab-span">  </span>inputStreamsEnabled_(arg1)</b></p>
 101 <p class="p7"><b><span class="Apple-tab-span">  </span>inputStreamsEnabled</b></p>
 102 <p class="p8"><b><span class="Apple-tab-span">  </span></b><span class="Apple-tab-span">        </span></p>
 103 <p class="p7"><span class="Apple-tab-span">     </span><span class="Apple-tab-span">    </span>A <a href="../Collections/String.html"><span class="s2">String</span></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.</p>
 104 <p class="p8"><span class="Apple-tab-span">     </span><span class="Apple-tab-span">    </span></p>
 105 <p class="p7"><b><span class="Apple-tab-span">  </span>loadDefs_(arg1)</b></p>
 106 <p class="p7"><b><span class="Apple-tab-span">  </span>loadDefs</b></p>
 107 <p class="p8"><b><span class="Apple-tab-span">  </span></b><span class="Apple-tab-span">        </span></p>
 108 <p class="p7"><span class="Apple-tab-span">     </span><span class="Apple-tab-span">    </span>A <a href="../Core/Boolean.html"><span class="s2">Boolean</span></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.</p>
 109 <p class="p8"><span class="Apple-tab-span">     </span><span class="Apple-tab-span">    </span><span class="Apple-tab-span">    </span><span class="Apple-tab-span">    </span></p>
 110 <p class="p7"><b><span class="Apple-tab-span">  </span>maxNodes_(arg1)</b></p>
 111 <p class="p7"><b><span class="Apple-tab-span">  </span>maxNodes</b></p>
 112 <p class="p8"><b><span class="Apple-tab-span">  </span></b><span class="Apple-tab-span">        </span></p>
 113 <p class="p7"><span class="Apple-tab-span">     </span><span class="Apple-tab-span">    </span>The maximum number of nodes. The default is 1024.</p>
 114 <p class="p8"><span class="Apple-tab-span">     </span></p>
 115 <p class="p7"><span class="Apple-tab-span">     </span><b>maxSynthDefs_(arg1)</b></p>
 116 <p class="p7"><b><span class="Apple-tab-span">  </span>maxSynthDefs</b></p>
 117 <p class="p8"><b><span class="Apple-tab-span">  </span></b><span class="Apple-tab-span">        </span></p>
 118 <p class="p7"><span class="Apple-tab-span">     </span><span class="Apple-tab-span">    </span>The maximum number of synthdefs. The default is 1024.</p>
 119 <p class="p8"><span class="Apple-tab-span">     </span><span class="Apple-tab-span">    </span></p>
 120 <p class="p7"><b><span class="Apple-tab-span">  </span>memSize_(arg1)</b></p>
 121 <p class="p7"><b><span class="Apple-tab-span">  </span>memSize</b></p>
 122 <p class="p8"><b><span class="Apple-tab-span">  </span></b><span class="Apple-tab-span">        </span></p>
 123 <p class="p7"><span class="Apple-tab-span">     </span><span class="Apple-tab-span">    </span>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"><span class="s2">CombN</span></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.</p>
 124 <p class="p8"><span class="Apple-tab-span">     </span><span class="Apple-tab-span">    </span><span class="Apple-tab-span">    </span><span class="Apple-tab-span">    </span></p>
 125 <p class="p7"><b><span class="Apple-tab-span">  </span>numAudioBusChannels_(arg1)</b></p>
 126 <p class="p7"><b><span class="Apple-tab-span">  </span>numAudioBusChannels</b></p>
 127 <p class="p8"><b><span class="Apple-tab-span">  </span></b><span class="Apple-tab-span">        </span></p>
 128 <p class="p7"><span class="Apple-tab-span">     </span><span class="Apple-tab-span">    </span>The number of audio rate busses, which includes input and output busses. The default is 128.</p>
 129 <p class="p8"><span class="Apple-tab-span">     </span></p>
 130 <p class="p7"><span class="Apple-tab-span">     </span><b>numBuffers_ (argNumBuffers)</b></p>
 131 <p class="p7"><b><span class="Apple-tab-span">  </span>numBuffers</b></p>
 132 <p class="p8"><b><span class="Apple-tab-span">  </span></b></p>
 133 <p class="p7"><b><span class="Apple-tab-span">  </span><span class="Apple-tab-span">    </span></b>The number of global sample buffers available. (See <a href="Buffer.html"><span class="s2">Buffer</span></a>.) The default is 1024.</p>
 134 <p class="p8"><span class="Apple-tab-span">     </span><span class="Apple-tab-span">    </span><span class="Apple-tab-span">    </span><span class="Apple-tab-span">    </span></p>
 135 <p class="p7"><b><span class="Apple-tab-span">  </span>numControlBusChannels_(arg1)</b></p>
 136 <p class="p7"><b><span class="Apple-tab-span">  </span>numControlBusChannels</b></p>
 137 <p class="p8"><b><span class="Apple-tab-span">  </span></b><span class="Apple-tab-span">        </span></p>
 138 <p class="p7"><span class="Apple-tab-span">     </span><span class="Apple-tab-span">    </span>The number of internal control rate busses. The default is 4096.</p>
 139 <p class="p8"><span class="Apple-tab-span">     </span><span class="Apple-tab-span">    </span></p>
 140 <p class="p7"><b><span class="Apple-tab-span">  </span>numInputBusChannels_(arg1)</b></p>
 141 <p class="p7"><b><span class="Apple-tab-span">  </span>numInputBusChannels</b></p>
 142 <p class="p8"><b><span class="Apple-tab-span">  </span></b><span class="Apple-tab-span">        </span></p>
 143 <p class="p7"><span class="Apple-tab-span">     </span><span class="Apple-tab-span">    </span>The number of audio input bus channels. This need not correspond to the number of hardware inputs. The default is 8.</p>
 144 <p class="p8"><span class="Apple-tab-span">     </span></p>
 145 <p class="p7"><span class="Apple-tab-span">     </span><b>numOutputBusChannels_(arg1)</b></p>
 146 <p class="p7"><b><span class="Apple-tab-span">  </span>numOutputBusChannels</b></p>
 147 <p class="p8"><b><span class="Apple-tab-span">  </span></b><span class="Apple-tab-span">        </span></p>
 148 <p class="p7"><span class="Apple-tab-span">     </span><span class="Apple-tab-span">    </span>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.</p>
 149 <p class="p8"><span class="Apple-tab-span">     </span><span class="Apple-tab-span">    </span><span class="Apple-tab-span">    </span><span class="Apple-tab-span">    </span></p>
 150 <p class="p7"><b><span class="Apple-tab-span">  </span>numRGens_(arg1)</b></p>
 151 <p class="p7"><b><span class="Apple-tab-span">  </span>numRGens</b></p>
 152 <p class="p8"><b><span class="Apple-tab-span">  </span></b><span class="Apple-tab-span">        </span></p>
 153 <p class="p7"><span class="Apple-tab-span">     </span><span class="Apple-tab-span">    </span>The number of seedable random number generators. The default is 64.</p>
 154 <p class="p8"><span class="Apple-tab-span">     </span><span class="Apple-tab-span">    </span></p>
 155 <p class="p7"><b><span class="Apple-tab-span">  </span>numWireBufs_(arg1)</b></p>
 156 <p class="p7"><b><span class="Apple-tab-span">  </span>numWireBufs</b></p>
 157 <p class="p8"><b><span class="Apple-tab-span">  </span></b><span class="Apple-tab-span">        </span></p>
 158 <p class="p7"><span class="Apple-tab-span">     </span><span class="Apple-tab-span">    </span>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.</p>
 159 <p class="p8"><span class="Apple-tab-span">     </span></p>
 160 <p class="p7"><span class="Apple-tab-span">     </span><b>outputStreamsEnabled_(arg1)</b></p>
 161 <p class="p7"><b><span class="Apple-tab-span">  </span>outputStreamsEnabled</b></p>
 162 <p class="p8"><b><span class="Apple-tab-span">  </span></b><span class="Apple-tab-span">        </span></p>
 163 <p class="p7"><span class="Apple-tab-span">     </span><span class="Apple-tab-span">    </span>A <a href="../Collections/String.html"><span class="s2">String</span></a> which allows turning off output streams that you are not interested in on the<span class="Apple-converted-space">  </span>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.</p>
 164 <p class="p8"><span class="Apple-tab-span">     </span><span class="Apple-tab-span">    </span><span class="Apple-tab-span">    </span><span class="Apple-tab-span">    </span></p>
 165 <p class="p7"><b><span class="Apple-tab-span">  </span>protocol_(arg1)</b></p>
 166 <p class="p7"><b><span class="Apple-tab-span">  </span>protocol</b></p>
 167 <p class="p8"><b><span class="Apple-tab-span">  </span></b><span class="Apple-tab-span">        </span></p>
 168 <p class="p7"><span class="Apple-tab-span">     </span><span class="Apple-tab-span">    </span>A <a href="../Core/Symbol.html"><span class="s2">Symbol</span></a> representing the communications protocol. Either<span class="Apple-converted-space">  </span>\udp or \tcp. The default is udp.</p>
 169 <p class="p8"><span class="Apple-tab-span">     </span><span class="Apple-tab-span">    </span><span class="Apple-tab-span">    </span><span class="Apple-tab-span">    </span></p>
 170 <p class="p7"><b><span class="Apple-tab-span">  </span>remoteControlVolume_(arg1)</b></p>
 171 <p class="p7"><b><span class="Apple-tab-span">  </span>remoteControlVolume</b></p>
 172 <p class="p8"><b><span class="Apple-tab-span">  </span></b><span class="Apple-tab-span">        </span></p>
 173 <p class="p7"><span class="Apple-tab-span">     </span><span class="Apple-tab-span">    </span>A <a href="../Core/Boolean.html"><span class="s2">Boolean</span></a> indicating whether this server should allow its volume to be set remotely. The default value is false.</p>
 174 <p class="p8"><span class="Apple-tab-span">     </span><span class="Apple-tab-span">    </span><span class="Apple-tab-span">    </span><span class="Apple-tab-span">    </span></p>
 175 <p class="p7"><b><span class="Apple-tab-span">  </span>sampleRate_(arg1)</b></p>
 176 <p class="p7"><b><span class="Apple-tab-span">  </span>sampleRate</b></p>
 177 <p class="p8"><b><span class="Apple-tab-span">  </span></b><span class="Apple-tab-span">        </span></p>
 178 <p class="p7"><span class="Apple-tab-span">     </span><span class="Apple-tab-span">    </span>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.</p>
 179 <p class="p8"><span class="Apple-tab-span">     </span><span class="Apple-tab-span">    </span></p>
 180 <p class="p7"><b><span class="Apple-tab-span">  </span>verbosity_(arg1)</b></p>
 181 <p class="p7"><b><span class="Apple-tab-span">  </span>verbosity</b></p>
 182 <p class="p8"><b><span class="Apple-tab-span">  </span></b><span class="Apple-tab-span">        </span></p>
 183 <p class="p7"><span class="Apple-tab-span">     </span><span class="Apple-tab-span">    </span>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.</p>
 184 <p class="p8"><span class="Apple-tab-span">     </span><span class="Apple-tab-span">    </span><span class="Apple-tab-span">    </span><span class="Apple-tab-span">    </span></p>
 185 <p class="p7"><b><span class="Apple-tab-span">  </span>zeroConf_(arg1)</b></p>
 186 <p class="p7"><b><span class="Apple-tab-span">  </span>zeroConf</b></p>
 187 <p class="p8"><b><span class="Apple-tab-span">  </span></b><span class="Apple-tab-span">        </span></p>
 188 <p class="p7"><span class="Apple-tab-span">     </span><span class="Apple-tab-span">    </span>A <a href="../Core/Boolean.html"><span class="s2">Boolean</span></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.</p>
 189 <p class="p8"><span class="Apple-tab-span">     </span><span class="Apple-tab-span">    </span><span class="Apple-tab-span">    </span><span class="Apple-tab-span">    </span></p>
 190 <p class="p7"><b><span class="Apple-tab-span">  </span>restrictedPaths_(arg1)</b></p>
 191 <p class="p7"><b><span class="Apple-tab-span">  </span>restrictedPaths</b></p>
 192 <p class="p8"><b><span class="Apple-tab-span">  </span></b><span class="Apple-tab-span">        </span></p>
 193 <p class="p7"><span class="Apple-tab-span">     </span><span class="Apple-tab-span">    </span>Allows you to restrict the system paths in which scsynth is allowed to read/write files during running. A nil value (the default) means no restriction. Otherwise, set it as a string representing a single path.</p>
 194 <p class="p8"><span class="Apple-tab-span">     </span><span class="Apple-tab-span">    </span><span class="Apple-tab-span">    </span><span class="Apple-tab-span">    </span></p>
 195 <p class="p8"><span class="Apple-tab-span">     </span><span class="Apple-tab-span">    </span><span class="Apple-tab-span">    </span><span class="Apple-tab-span">    </span></p>
 196 <p class="p9"><b>Instance Methods</b></p>
 197 <p class="p8"><br></p>
 198 <p class="p8"><span class="Apple-tab-span">     </span></p>
 199 <p class="p7"><b><span class="Apple-tab-span">  </span>asOptionsString (port)</b></p>
 200 <p class="p8"><b><span class="Apple-tab-span">  </span></b></p>
 201 <p class="p7"><b><span class="Apple-tab-span">  </span><span class="Apple-tab-span">    </span></b>Returns a <a href="../Collections/String.html"><span class="s2">String</span></a> specifying the options in the format required by the command-line scsynth app.</p>
 202 <p class="p10"><span class="Apple-tab-span">    </span><span class="Apple-tab-span">    </span><b>port </b>- The port number for the resulting server app. Default value is 57110.</p>
 203 <p class="p8"><span class="Apple-tab-span">     </span><span class="Apple-tab-span">    </span></p>
 204 <p class="p7"><span class="s6"><span class="Apple-tab-span">    </span></span><b>firstPrivateBus</b></p>
 205 <p class="p8"><b><span class="Apple-tab-span">  </span></b></p>
 206 <p class="p7"><b><span class="Apple-tab-span">  </span><span class="Apple-tab-span">    </span></b>Returns the index of the first audio bus on this server which is not used by the input and output hardware.</p>
 207 <p class="p6"><br></p>
 208 <p class="p6"><br></p>
 209 <p class="p6"><br></p>
 210 <p class="p6"><br></p>
 211 <p class="p9"><b>Examples</b></p>
 212 <p class="p3"><br></p>
 213 <p class="p11">// Get the local server's options</p>
 214 <p class="p3"><br></p>
 215 <p class="p12">o = <span class="s7">Server</span>.local.options;</p>
 216 <p class="p3"><br></p>
 217 <p class="p11">// Post the number of output channels</p>
 218 <p class="p3"><br></p>
 219 <p class="p12">o.numOutputBusChannels.postln;</p>
 220 <p class="p3"><br></p>
 221 <p class="p11">// Set them to a new number</p>
 222 <p class="p3"><br></p>
 223 <p class="p11"><span class="s3">o.numOutputBusChannels = 6; </span>// The next time it boots, this will take effect</p>
 224 <p class="p3"><br></p>
 225 <p class="p11">// specify a device</p>
 226 <p class="p3"><br></p>
 227 <p class="p11"><span class="s3">o.device =</span><span class="s8">"MOTU Traveler"</span><span class="s3">; <span class="Apple-tab-span">        </span></span>// use a specific soundcard</p>
 228 <p class="p11"><span class="s3">o.device = </span><span class="s7">nil</span><span class="s3">;<span class="Apple-tab-span">    </span><span class="Apple-tab-span">    </span><span class="Apple-tab-span">    </span></span>// use the system default soundcard</p>
 229 <p class="p3"><br></p>
 230 <p class="p11">// Create a new instance of ServerOptions</p>
 231 <p class="p3"><br></p>
 232 <p class="p13"><span class="s3">o = </span>ServerOptions<span class="s3">.new;</span></p>
 233 <p class="p3"><br></p>
 234 <p class="p11">// Set the memory size to twice the default</p>
 235 <p class="p3"><br></p>
 236 <p class="p12">o.memSize = 4096;</p>
 237 <p class="p3"><br></p>
 238 <p class="p11">// Create a new Server on the local machine using o for its options</p>
 239 <p class="p3"><br></p>
 240 <p class="p12">t = <span class="s7">Server</span>(<span class="s9">\Local2</span>, <span class="s7">NetAddr</span>(<span class="s8">"127.0.0.1"</span>, 57111), o);</p>
 241 <p class="p12">t.makeWindow;</p>
 242 <p class="p12">t.boot;</p>
 243 <p class="p12">t.quit;</p>
 244 <p class="p3"><br></p>
 245 </body>
 246 </html>