Sound.SC3.Server.Transport.FD

FD variant of interaction with the scsynth server.

This duplicates functions at Monad and at some point at least part of the duplication will be removed.

hosc variants

async :: Transport t => t -> Message -> IO Message

Send a Message and waitReply for a /done reply.

maybe_async :: Transport t => t -> Message -> IO ()

If isAsync then void async else sendMessage.

maybe_async_at :: Transport t => t -> Time -> Message -> IO ()

Variant that timestamps synchronous messages.

withSC3 :: (UDP -> IO a) -> IO a

Bracket SC3 communication.

Server control

stop :: Transport t => t -> IO ()

Free all nodes (g_freeAll) at group 1.

reset :: Transport t => t -> IO ()

Free all nodes (g_freeAll) at and re-create groups 1 and 2.

playGraphdef :: Transport t => Int -> t -> Graphdef -> IO ()

Send d_recv and s_new messages to scsynth.

playSynthdef :: Transport t => Int -> t -> Synthdef -> IO ()

playGraphdef of synthdef_to_graphdef.

playUGen :: Transport t => Int -> t -> UGen -> IO ()

Send an anonymous instrument definition using playSynthdef.

Non-real time

run_bundle :: Transport t => t -> Time -> Bundle -> IO ()

Wait (pauseThreadUntil) until bundle is due to be sent relative to initial Time, then send each message, asynchronously if required.

nrt_play :: Transport t => t -> NRT -> IO ()

Perform an NRT score (as would be rendered by writeNRT). In particular note that all timestamps must be in NTPr form.

nrt_audition :: NRT -> IO ()

Audible

class Audible e where

Class for values that can be encoded and sent to scsynth for audition.

Minimal complete definition

play_id

Methods

play_id :: Transport t => Int -> t -> e -> IO ()

play :: Transport t => t -> e -> IO ()

Instances

Audible Graphdef

Methods

play_id :: Transport t => Int -> t -> Graphdef -> IO ()

play :: Transport t => t -> Graphdef -> IO ()

Audible UGen

Methods

play_id :: Transport t => Int -> t -> UGen -> IO ()

play :: Transport t => t -> UGen -> IO ()

Audible Synthdef

Methods

play_id :: Transport t => Int -> t -> Synthdef -> IO ()

play :: Transport t => t -> Synthdef -> IO ()

audition_id :: Audible e => Int -> e -> IO ()

audition :: Audible e => e -> IO ()

Notifications

withNotifications :: Transport t => t -> (t -> IO a) -> IO a

Turn on notifications, run f, turn off notifications, return result.

Buffer

b_getn1_data :: Transport t => t -> Int -> (Int, Int) -> IO [Double]

Variant of b_getn1 that waits for return message and unpacks it.

withSC3 (\fd -> b_getn1_data fd 0 (0,5))

b_getn1_data_segment :: Transport t => t -> Int -> Int -> (Int, Int) -> IO [Double]

Variant of b_getn1_data that segments individual b_getn messages to n elements.

withSC3 (\fd -> b_getn1_data_segment fd 1 0 (0,5))

b_fetch :: Transport t => t -> Int -> Int -> IO [[Double]]

Variant of b_getn1_data_segment that gets the entire buffer.

b_fetch1 :: Transport t => t -> Int -> Int -> IO [Double]

Status

serverStatus :: Transport t => t -> IO [String]

Collect server status information.

serverSampleRateNominal :: Transport t => t -> IO Double

Read nominal sample rate of server.

serverSampleRateActual :: Transport t => t -> IO Double

Read actual sample rate of server.

serverStatusData :: Transport t => t -> IO [Datum]

Retrieve status data from server.