Sound.SC3.Server.Graphdef

Binary 'Graph Definition' as understood by scsynth. There are both encoders and decoders.

Type

type Name = ASCII

Names are ASCII strings.

type Control = (Name, Int)

Controls are a name and a ugen-index.

type Sample = Double

Constants are floating point.

data Input

Inputs are a ugen-index and a port-index. If the ugen-index is -1 it indicates a constant.

Constructors

Input Int Int

Instances

Eq Input

Defined in Sound.SC3.Server.Graphdef

Methods

(==) :: Input -> Input -> Bool

(/=) :: Input -> Input -> Bool

Show Input

Defined in Sound.SC3.Server.Graphdef

Methods

showsPrec :: Int -> Input -> ShowS

show :: Input -> String

showList :: [Input] -> ShowS

input_ugen_ix :: Input -> Maybe Int

Read ugen-index of input, else Nothing.

type Rate = Int

Rates are encoded as integers (IR = 0, KR = 1, AR = 2, DR = 3).

type Output = Rate

Outputs each indicate a Rate.

type Special = Int

Secondary (special) index, used by operator UGens to select operation.

type UGen = (Name, Rate, [Input], [Output], Special)

Unit generator type.

ugen_rate :: UGen -> Rate

UGen Rate.

ugen_inputs :: UGen -> [Input]

UGen Inputs.

ugen_outputs :: UGen -> [Output]

UGen Outputs.

ugen_is_control :: UGen -> Bool

Predicate to examine Ugen name and decide if it is a control.

input_is_control :: Graphdef -> Input -> Bool

Input is a UGen and the UGen is a control.

data Graphdef

Graph definition type.

Constructors

Graphdef

Fields

• graphdef_name :: Name
• graphdef_constants :: [Sample]
• graphdef_controls :: [(Control, Sample)]
• graphdef_ugens :: [UGen]

Instances

Eq Graphdef

Defined in Sound.SC3.Server.Graphdef

Methods

(==) :: Graphdef -> Graphdef -> Bool

(/=) :: Graphdef -> Graphdef -> Bool

Show Graphdef

Defined in Sound.SC3.Server.Graphdef

Methods

showsPrec :: Int -> Graphdef -> ShowS

show :: Graphdef -> String

showList :: [Graphdef] -> ShowS

Audible Graphdef

Defined in Sound.SC3.Server.Transport.FD

Methods

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

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

Audible Graphdef

Defined in Sound.SC3.Server.Transport.Monad

Methods

play_at :: Transport m => Play_Opt -> Graphdef -> m ()

play :: Transport m => Graphdef -> m ()

graphdef_ugen :: Graphdef -> Int -> UGen

Lookup UGen by index.

graphdef_control :: Graphdef -> Int -> (Control, Sample)

Lookup Control and default value by index.

graphdef_constant_nid :: Graphdef -> Int -> Int

nid of constant.

graphdef_control_nid :: Graphdef -> Int -> Int

nid of control.

graphdef_ugen_nid :: Graphdef -> Int -> Int

nid of UGen.

Read (version 0 or 2).

read_sample :: Handle -> IO Sample

Read a Sample.

read_control :: (Handle -> IO Int) -> Handle -> IO Control

Read a Control.

read_input :: (Handle -> IO Int) -> Handle -> IO Input

Read an Input.

read_output :: Handle -> IO Output

Read an output.

read_ugen :: (Handle -> IO Int) -> Handle -> IO UGen

Read a UGen.

read_graphdef :: Handle -> IO Graphdef

Read a Graphdef. Ignores variants.

read_graphdef_file :: FilePath -> IO Graphdef

Read Graphdef from file.

dir = "/home/rohan/sw/rsc3-disassembler/scsyndef/"
pp nm = read_graphdef_file (dir ++ nm) >>= putStrLn . graphdef_stat
pp "simple.scsyndef"
pp "with-ctl.scsyndef"
pp "mce.scsyndef"
pp "mrg.scsyndef"

Encode (version zero)

encode_pstr :: Name -> ByteString

Pascal (length prefixed) encoding of string.

encode_input :: Input -> ByteString

Byte-encode Input.

encode_control :: Control -> ByteString

Byte-encode Control.

encode_ugen :: UGen -> ByteString

Byte-encode UGen.

encode_sample :: Sample -> ByteString

Encode Sample as 32-bit IEEE float.

encode_graphdef :: Graphdef -> ByteString

Encode Graphdef.

Stat

graphdef_stat :: Graphdef -> String

Simple statistics printer for Graphdef.