Sound.SC3.Server.Process

This module includes utilities for spawning an external scsynth process, either for realtime or non-realtime execution.

Documentation

module Sound.SC3.Server.Options

data OutputHandler

Handle output of external scsynth processes.

Constructors

OutputHandler

Fields

onPutString :: String -> IO ()

Handle one line of normal output

onPutError :: String -> IO ()

Handle one line of error output

defaultOutputHandler :: OutputHandler

Default IO handler, writing to stdout and stderr, respectively.

withTransport :: Transport t => (ServerOptions -> RTOptions -> IO t) -> ServerOptions -> RTOptions -> (t -> IO a) -> IO a

withSynth :: Transport t => (ServerOptions -> RTOptions -> IO t) -> ServerOptions -> RTOptions -> OutputHandler -> (t -> IO a) -> IO a

Execute a realtime instance of scsynth with Transport t.

The spawned scsynth is sent a /quit message after the supplied action returns.

NOTE: When compiling executables with GHC, the -threaded option should be passed, otherwise the I/O handlers will not work correctly.

openTCP :: ServerOptions -> RTOptions -> IO TCP

openUDP :: ServerOptions -> RTOptions -> IO UDP

withNRT :: ServerOptions -> NRTOptions -> OutputHandler -> (Handle -> IO a) -> IO a

Execute a non-realtime instance of scsynth and return ExitCode when the process exists.