trait ConfigLike extends AnyRef
The base trait for Config
and ConfigBuilder
describes the settings used to boot scsynth in
realtime or non-realtime mode, as well as its server address and port.
You obtain a ConfigBuilder
by calling Server.Config()
. This builder can then be mutated and
will be implicitly converted to an immutable Config
when required.
See ConfigBuilder
for its default values.
- Alphabetic
- By Inheritance
- ConfigLike
- AnyRef
- Any
- Hide All
- Show All
- Public
- Protected
Abstract Value Members
- abstract def audioBuffers: Int
The maximum number of audio buffers (for the
Buffer
class). - abstract def audioBusChannels: Int
The maximum number of audio bus channels.
The maximum number of audio bus channels. This includes the channels connected to hardware (
outputBusChannels
) as well as all channels for internal routing. - abstract def blockSize: Int
The calculation block size.
The calculation block size. That is, the number of audio samples calculated en-bloc. This corresponds with the control rate, such that
controlRate := audioRate / blockSize
. It should be a power of two. - abstract def controlBusChannels: Int
The maximum number of control bus channels.
- abstract def deviceName: Option[String]
(Realtime) An option denoting the name of the sound card to use.
(Realtime) An option denoting the name of the sound card to use. On systems which distinguish input and output devices (OS X), this implies that both are the same. Otherwise, you can use the
deviceNames
method instead.- See also
deviceNames
- abstract def deviceNames: Option[(String, String)]
(Realtime) An option denoting the name of the input and output sound device to use.
(Realtime) An option denoting the name of the input and output sound device to use. This is for systems which distinguish input and output devices (OS X). If you use a single device both for input and output (applies to most professional audio interfaces), you can simply use the single string method
deviceName
.- See also
deviceName
- abstract def hardwareBlockSize: Int
(Realtime) A value to adjust the sound card's hardware block size.
(Realtime) A value to adjust the sound card's hardware block size. Typically you will leave this to
0
which means that the current block size is used. The block sizes supported depend on the particular sound card. Lower values decrease latency but may increase CPU load. - abstract def host: String
(Realtime) Host address of scsynth, when trying to
connect
to an already running server on the net. - abstract def inputBusChannels: Int
(Realtime) The number of connected audio hardware input channels.
(Realtime) The number of connected audio hardware input channels. This does not need to correspond to the actual number of channels your sound card provides, but can be lower or higher, although a higher value doesn't have any effect as channel indices above the number of channels of the sound card will be treated as internal channels.
- abstract def inputStreamsEnabled: Option[String]
(Realtime) An option to enable particular input 'streams' or 'bundles' of a sound card.
(Realtime) An option to enable particular input 'streams' or 'bundles' of a sound card. This is a 'binary' String made of
'0'
and'1'
characters. If the string is"01100"
, for example, then only the second and third input streams on the device will be enabled. - abstract def loadSynthDefs: Boolean
Whether scsynth should load synth definitions stored on the hard-disk when booted.
- abstract def machPortName: Option[(String, String)]
?
- abstract def maxLogins: Int
(Realtime) The maximum number of client connections when using TCP transport.
- abstract def maxNodes: Int
The maximum number of concurrent nodes (synths and groups).
- abstract def maxSynthDefs: Int
The maximum number of synth defs.
- abstract def memorySize: Int
The maximum number of pre-allocated realtime memory in bytes.
The maximum number of pre-allocated realtime memory in bytes. This memory is used for many UGens such as
Limiter
,DelayN
etc. It does not affect dynamically allocated memory such as audio buffers. - abstract def nrtCommandPath: String
(Non-Realtime) Path to the binary OSC file.
- abstract def nrtHeaderFormat: AudioFileType
(Non-Realtime) Audio file format for writing the output.
- abstract def nrtInputPath: Option[String]
(Non-Realtime) Path to the audio input file used as audio input bus supplement.
- abstract def nrtOutputPath: String
(Non-Realtime) Path to the audio output file used as audio output bus supplement.
- abstract def nrtSampleFormat: SampleFormat
(Non-Realtime) Audio sample format for writing the output.
- abstract def outputBusChannels: Int
The number of connected audio hardware output channels.
The number of connected audio hardware output channels. This does not need to correspond to the actual number of channels your sound card provides, but can be lower or higher, although a higher value doesn't have any effect as channel indices above the number of channels of the sound card will be treated as internal channels.
- abstract def outputStreamsEnabled: Option[String]
(Realtime) An option to enable particular output 'streams' or 'bundles' of a sound card.
(Realtime) An option to enable particular output 'streams' or 'bundles' of a sound card. This is a 'binary' String made of
'0'
and'1'
characters. If the string is"01100"
, for example, then only the second and third output streams on the device will be enabled. - abstract def plugInsPaths: List[String]
An explicit list of paths where DSP plugins are found.
An explicit list of paths where DSP plugins are found. Usually this is not specified, and scsynth looks for plugins in their default location.
- abstract def port: Int
(Realtime) UDP or TCP port used by scsynth.
- abstract def program: String
The path to
scsynth
, used when booting a server.The path to
scsynth
, used when booting a server. This can be either a relative path (relating to the JVM's working directory), or an absolute path. - abstract def randomSeeds: Int
The number of individual random number generators allocated.
- abstract def restrictedPath: Option[String]
An option to restrict access to files (e.g.
An option to restrict access to files (e.g. for loading and saving buffers) to a particular directory. This is a security measure, preventing malicious clients from accessing parts of the hard-disk which they shouldn't.
- abstract def sampleRate: Int
The audio hardware sampling rate to use.
The audio hardware sampling rate to use. A value of
0
indicates that scsynth should use the current sampling rate of the audio hardware. An explicit setting will make scsynth try to switch the sound card's sample rate if necessary. - abstract def sessionPassword: Option[String]
(Realtime) A requires session password when using TCP transport.
(Realtime) A requires session password when using TCP transport. When using TCP and the password option is set, each client must send the correct password as the first command to the server, otherwise it is rejected.
- abstract def transport: Transport
(Realtime) Open Sound Control transport used by scsynth.
(Realtime) Open Sound Control transport used by scsynth. (Either of
UDP
andTCP
). - abstract def verbosity: Int
The verbosity level of scsynth.
The verbosity level of scsynth. The standard value is
0
, while-1
suppresses informational messages,-2
also suppresses many error messages. - abstract def wireBuffers: Int
The maximum number of concurrent connections between UGens in a single synth.
The maximum number of concurrent connections between UGens in a single synth. ScalaCollider performs a depth-first topological sorting of the synth defs, so you should not worry too much about this value. It can become important in very heavy channel expansions and mix-down.
This value will be automatically increased if a more complex def is loaded at startup, but it cannot be increased thereafter without rebooting.
- abstract def zeroConf: Boolean
(Realtime) Whether to announce scsynth's OSC service via zero conf.
(Realtime) Whether to announce scsynth's OSC service via zero conf. See Wikipedia for more details.
Concrete Value Members
- final def !=(arg0: Any): Boolean
- Definition Classes
- AnyRef → Any
- final def ##: Int
- Definition Classes
- AnyRef → Any
- final def ==(arg0: Any): Boolean
- Definition Classes
- AnyRef → Any
- final def asInstanceOf[T0]: T0
- Definition Classes
- Any
- def clone(): AnyRef
- Attributes
- protected[lang]
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.CloneNotSupportedException]) @native() @HotSpotIntrinsicCandidate()
- final def eq(arg0: AnyRef): Boolean
- Definition Classes
- AnyRef
- def equals(arg0: AnyRef): Boolean
- Definition Classes
- AnyRef → Any
- final def getClass(): Class[_ <: AnyRef]
- Definition Classes
- AnyRef → Any
- Annotations
- @native() @HotSpotIntrinsicCandidate()
- def hashCode(): Int
- Definition Classes
- AnyRef → Any
- Annotations
- @native() @HotSpotIntrinsicCandidate()
- final def internalBusIndex: Int
A utility method providing the audio bus offset for the start of the internal channels.
A utility method providing the audio bus offset for the start of the internal channels. (simply the sum of
outputBusChannels
andinputBusChannels
). - final def isInstanceOf[T0]: Boolean
- Definition Classes
- Any
- final def ne(arg0: AnyRef): Boolean
- Definition Classes
- AnyRef
- final def notify(): Unit
- Definition Classes
- AnyRef
- Annotations
- @native() @HotSpotIntrinsicCandidate()
- final def notifyAll(): Unit
- Definition Classes
- AnyRef
- Annotations
- @native() @HotSpotIntrinsicCandidate()
- final def synchronized[T0](arg0: => T0): T0
- Definition Classes
- AnyRef
- final def toNonRealtimeArgs: List[String]
Produces a command line for booting scsynth in non-realtime mode.
- final def toRealtimeArgs: List[String]
Produces a command line for booting scsynth in realtime mode.
- def toString(): String
- Definition Classes
- AnyRef → Any
- final def wait(arg0: Long, arg1: Int): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.InterruptedException])
- final def wait(arg0: Long): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.InterruptedException]) @native()
- final def wait(): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.InterruptedException])
Deprecated Value Members
- def finalize(): Unit
- Attributes
- protected[lang]
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.Throwable]) @Deprecated
- Deprecated