Sound.SC3.Server.NRT

Non-realtime score generation.

Documentation

oscWithSize :: Bundle -> ByteString

Encode and prefix with encoded length.

data NRT

An NRT score is a sequence of Bundles.

Constructors

NRT

Fields

nrt_bundles :: [Bundle]

Instances

Show NRT

Audible NRT

Audible NRT

encodeNRT :: NRT -> ByteString

Encode an NRT score.

writeNRT :: FilePath -> NRT -> IO ()

Write an NRT score.

putNRT :: Handle -> NRT -> IO ()

Write an NRT score to a file handle.

decode_nrt_bundles :: ByteString -> [Bundle]

Decode an NRT ByteString to a list of Bundles.

decodeNRT :: ByteString -> NRT

Decode an NRT ByteString.

readNRT :: FilePath -> IO NRT

decodeNRT of readFile.

data NRT_File_Format

File formats scsynth renders to.

Constructors

AIFF

FLAC

NeXT

WAVE

Instances

Eq NRT_File_Format

Show NRT_File_Format

data NRT_Sample_Format

Sample formats scsynth renders to.

Constructors

I16

I24

I32

F32

F64

Instances

Eq NRT_Sample_Format

Show NRT_Sample_Format

data NRT_Render

Data required to render an NRT score using scsynth. The input file is optional.

Constructors

NRT_Render

Fields

nrt_score :: FilePath

nrt_input_file :: Maybe FilePath

nrt_output_file :: FilePath

nrt_channels :: Int

nrt_sample_rate :: Double

nrt_file_format :: NRT_File_Format

nrt_sample_format :: NRT_Sample_Format

nrt_sf_pp :: NRT_Sample_Format -> String

Format NRT_Sample_Format for scsynth.

renderNRT_opt :: NRT_Render -> [String]

Format NRT_Render as list of arguments to scsynth.

 let {r = NRT_Render "x.osc" Nothing "x.aif" 2 44100 AIFF I16
     ;a = ["-o","2","-N","x.osc","_","x.aif","44100","AIFF","int16"]}
 in renderNRT_opt r == a

renderNRT_cmd :: [String] -> NRT_Render -> String

renderNRT command as String, with shell protected arguments.

 renderNRT_cmd [] (NRT_Render "s.osc" Nothing "s.flac" 2 44100 FLAC I24)

renderNRT :: [String] -> NRT_Render -> IO ExitCode

Run scsynth to render NRT_Render with given scsynth options.